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

2.1 KiB

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)

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

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)

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