Skip to content

feat(ci): close GT-145 — truthful provider-neutral RAG vector sync#58

Merged
beyondnetPeru merged 3 commits into
mainfrom
fix/gt-145-rag-sync
Jun 21, 2026
Merged

feat(ci): close GT-145 — truthful provider-neutral RAG vector sync#58
beyondnetPeru merged 3 commits into
mainfrom
fix/gt-145-rag-sync

Conversation

@beyondnetPeru

Copy link
Copy Markdown
Contributor

Cierra GT-145 (P1). Reemplaza el sync RAG mentiroso (upsert = TODO comentado) por sync real basado en port:

  • rag-port.mjs: puerto neutral embeddings/vector-store + adapter memory veraz no-durable, fail-closed.
  • rag-sync.mjs: chunking determinista + embed/upsert por lotes + poda sin huérfanos + recibo machine-readable.
  • 14-rag-index-sync.mjs: changed+deleted, fail-closed si live sin adapter durable.
  • Runbook EN+ES (creds least-privilege, batch/retry, telemetría). 9 node:test verde. Board 150/153 done.

🤖 Generated with Claude Code

beyondnetPeru and others added 3 commits June 20, 2026 19:31
Replace the fake 'upserted' logging (commented-TODO vector calls) with a real,
port-based delta sync:

- rag-port.mjs: provider-neutral embedding/vector-store port; built-in truthful
  non-durable `memory` adapter (dry-run + test fixture); fail-closed on unknown
  or incomplete adapters; registerRagAdapter for real vendors.
- rag-sync.mjs: deterministic H2 chunking, syncIndex that batches embed+upsert,
  prunes stale chunks on re-index and removes deleted files (no orphans), and
  returns a machine-readable receipt with cost/token telemetry.
- 14-rag-index-sync.mjs: detect changed AND deleted files, run the real port
  sync, emit the receipt, and fail closed if a live run lacks a durable adapter
  (never pretends).
- rag-sync.test.mjs: 9 node:test cases (port fail-closed, deterministic chunks,
  upsert/prune/delete lifecycle, receipt, embedding-mismatch fail-closed).

Addresses done-when criteria 1-3. Remaining: operations guidance doc (4).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Add a RAG Vector Synchronization Operations section (EN+ES) to the agentic
CI/RAG runbook: provider selection, least-privilege credentials, bounded
batch/retry, and cost/token telemetry via the machine-readable receipt.
Correct the stale "do not claim documents are indexed" note now that the
sync is truthful.

Addresses done-when criterion 4. GT-145 implementation complete.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Mark GT-145 DONE with closure evidence (commit d41bc3a): provider-neutral
embedding/vector-store port, deterministic chunking + batched upsert/prune
sync with machine-readable receipt, fail-closed live contract, 9 node:test
cases, and EN+ES operations runbook guidance.

Board progress 150/153 done, 3 pending.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@beyondnetPeru beyondnetPeru merged commit 444c12c into main Jun 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant