amduat-api/docs/index-backend-repro.md
2026-02-08 06:09:49 +01:00

66 lines
2.1 KiB
Markdown

# Index Backend Verification (Isolated)
## Summary
The previously reported isolated index-backend write failure is not reproducing on
current builds.
Verified on **2026-02-08** with a fresh store root:
- `POST /v2/graph/nodes` (node 1): HTTP 200
- `POST /v2/graph/nodes` (node 2): HTTP 200
- `POST /v2/graph/edges` (edge doc->topic): HTTP 200
- Control run on `--store-backend fs`: same sequence HTTP 200
- `./scripts/smoke_v2.sh` on index: PASS
- `./tests/integration_v2.sh` on index: PASS
## Re-Verification Procedure
### 1) Start index backend (isolated root + socket)
```bash
STORE_BACKEND=index INDEX_BACKEND_PROBE=0 \
STORE_ROOT=/tmp/amduat-asl-index-iso \
SOCK=/tmp/amduatd-index-iso.sock SPACE=app1 \
./scripts/dev_start_daemon.sh
```
### 2) Execute direct API calls
```bash
curl --globoff --silent --show-error --unix-socket /tmp/amduatd-index-iso.sock \
-H 'Content-Type: application/json' -H 'X-Amduat-Space: app1' \
-X POST --data-binary '{"name":"doca1"}' \
http://localhost/v2/graph/nodes
curl --globoff --silent --show-error --unix-socket /tmp/amduatd-index-iso.sock \
-H 'Content-Type: application/json' -H 'X-Amduat-Space: app1' \
-X POST --data-binary '{"name":"topica1"}' \
http://localhost/v2/graph/nodes
curl --globoff --silent --show-error --unix-socket /tmp/amduatd-index-iso.sock \
-H 'Content-Type: application/json' -H 'X-Amduat-Space: app1' \
-X POST --data-binary '{"subject":"doca1","predicate":"ms.within_domain","object":"topica1","provenance":{"source_uri":"urn:t","extractor":"x","observed_at":1,"ingested_at":2,"trace_id":"t1"}}' \
http://localhost/v2/graph/edges
```
Expected: all three requests return HTTP 200.
### 3) Control check (fs backend)
```bash
STORE_BACKEND=fs STORE_ROOT=/tmp/amduat-asl-fs-iso \
SOCK=/tmp/amduatd-fs-iso.sock SPACE=app1 \
./scripts/dev_start_daemon.sh
```
Run the same three API calls. Expected: HTTP 200 for all calls.
## Regression Gate Recommendation
Use these as quick confidence checks when updating `vendor/amduat-api`:
- isolated 3-call index write sequence above
- `./scripts/smoke_v2.sh` on index backend
- `./tests/integration_v2.sh` on index backend