KB-4565

GPT Review — Uploaded Legacy Vector v3.1 + IU-0 OUTLINE-E.1

3 min read Revision 1
gpt-reviewlegacy-vectoriu-0outline-e1next-directiveoutbox

GPT Review — Uploaded Legacy Vector v3.1 + IU-0 OUTLINE-E.1

Date: 2026-05-02 Reviewed documents:

  • knowledge/dev/laws/dieu38-trien-khai/reports/legacy-vector-stabilization-outline-v3.md rev 1
  • knowledge/dev/laws/dieu44-trien-khai/design/07-iu0-information-unit-minimum-standard-outline.md rev 1 Verdict: Upload verified. Both outlines are acceptable as design/runbook baselines. Next work should proceed in two controlled tracks.

Verification

Both documents exist in KB with revision 1.

Legacy Vector Stabilization v3.1 contains:

  • PG CRUD Hot Path Contract.
  • Durable outbox queue as default.
  • No-execute boundary.
  • Defaults locked: worker poll 30s, max retry 3, dead-letter manual review + alert.

IU-0 OUTLINE-E.1 contains:

  • Correct header/status OUTLINE-E.1.
  • VRC rev 1 PASS dependency.
  • IU-PG CRUD Performance Contract.
  • IU-VP-6 async delayed outbox contract.
  • Vector freshness states.
  • Duplicate behavior matrix.

Decision

PASS for outline baseline.

Do not ask Opus to reopen the same outline polish loop. Move forward.

Next directives

Track A — Legacy Vector Stabilization Implementation Prompt

Ask Opus to prepare an Agent execution prompt/runbook, not execute it. The prompt must instruct Agent to implement the stabilization in phases, with approval gates and no hidden mutations:

  1. Phase A0: read-only preflight and backup verification.
  2. Phase A1: Qdrant backup schedule verification/addition.
  3. Phase A2: durable outbox design confirmation in codebase.
  4. Phase A3: implement outbox enqueue-only path for all writes.
  5. Phase A4: worker implementation with 120s quiet window, poll 30s, retry 3x, dead-letter.
  6. Phase A5: restore PG trigger only after outbox is verified.
  7. Phase A6: fix vector audit URL/report-only mode.
  8. Phase A7: cleanup orphan/ghost only after fresh backup + dry-run + approval.
  9. Phase A8: health recheck and report.

Prompt must require: diff preview, rollback plan, tests, and no execution without explicit User approval.

Track B — IU-0 Full Draft

Ask Opus to start IU-0 full draft, but keep it design-only. It may expand sections 1-5 and 7-10. Section 6 vector must stay aligned with OUTLINE-E.1 and must not introduce implementation details beyond the outbox and separate IU collection principles already accepted.

Do not open P44-6. Do not write DDL/code. Do not mutate Agent Data/vector.

Guardrails

  • No Agent execution until Track A prompt is reviewed and approved.
  • No Qdrant cleanup/reindex until backup and dry-run are confirmed.
  • No trigger restore until durable outbox worker passes tests.
  • No immediate embedding in any CRUD path.
  • Legacy production_documents collection remains untouched except through existing stabilized legacy pipeline.
  • IU vector remains separate collection in future phase; do not mutate legacy payload to add IU fields.
Back to Knowledge Hub knowledge/dev/laws/dieu44-trien-khai/reviews/gpt-review-uploaded-legacy-vector-v31-iu0-e1-2026-05-02.md