From 3397911670c107f0d14d5a2919bd5b80a0ecc5f1 Mon Sep 17 00:00:00 2001 From: mptyl Date: Thu, 13 Aug 2026 04:44:50 +0200 Subject: [PATCH] docs: record P3+P4 manual acceptance and rebind P4 automated run to e056c19 --- PROJECT_STATE.md | 21 ++++++++++++--------- docs/testing/p2-p6-manual-verification.md | 10 +++++----- 2 files changed, 17 insertions(+), 14 deletions(-) diff --git a/PROJECT_STATE.md b/PROJECT_STATE.md index 9f693f5b..eee67abd 100644 --- a/PROJECT_STATE.md +++ b/PROJECT_STATE.md @@ -7,10 +7,10 @@ > ThothII per il repository (app + CLI `thothctl`), (3) come usare l'applicazione ThothII di base > (sessioni, domande, gate). Il documento userà parole semplici ed esempi; i dettagli tecnici > resteranno nei contratti esistenti. Esempio pratico completo: Policlinico San Donato. - Last updated: 2026-08-10 (final verification). + Last updated: 2026-08-13 (P3+P4 manual acceptance). > Point a fresh session here ("read PROJECT_STATE.md") before substantial work. -### P3 effective configuration and `.tht-dwh` — implementation complete, automated PASS, manual PENDING (2026-08-11) +### P3 effective configuration and `.tht-dwh` — implementation complete, automated PASS, manual PASS (2026-08-13) - **Scope:** P3 (PRD D3): a versioned shared canonicalizer produces the non-secret effective DWH/preprocessing configuration and a stable logical identity @@ -30,8 +30,8 @@ (15/15 checks PASS), bound to clean source commit `3b0726472e15c157…`. - **Manual gate:** P3 walkthrough in `docs/testing/p2-p6-manual-verification.md`; decision - **PENDING**. P4 starts only after an explicit new authorization. -### P4 Qdrant collection lifecycle — implementation complete, automated PASS, manual PENDING (2026-08-12) + **PASS** (owner approval 2026-08-13). +### P4 Qdrant collection lifecycle — implementation complete, automated PASS, manual PASS (2026-08-13) - **Scope:** P4 (PRD D4): one shared TypeScript collection manager owns the Qdrant collection and payload-index contract; session admission self-heals a missing collection (1024/cosine + @@ -48,13 +48,16 @@ `backend/src/workspaces/runtime-config-lease.ts` (lease exposes `semanticQdrantUrl`), `backend/src/workspace-maintenance.ts` + `preprocessing-service.ts` (`vector-inspect`/`vector-rebuild` operator commands), `tools/thothctl/internal/workspaceops/operations.go` (+tests). -- **Automated acceptance:** PASS 11/11 (run `p4-3a001f83fae22fe72056dc52e5ff63b5`, - report `.artifacts/p4-integration/...` retained via `--keep`): preflight, clean_state, ownership, - qdrant_up, self_heal_create_missing, self_heal_repairs_missing_index, incompatible_refused, - require_existing_refused, rebuild_recreates_contract, secret_scan, cleanup_confinement. +- **Automated acceptance:** PASS 11/11 (run `p4-466bbfdea9ef3111f36baa99fc2d64aa`, + report `.artifacts/p4-integration/p4-466bbfdea9ef3111f36baa99fc2d64aa/` retained via `--keep`, + bound to clean source commit `e056c19e6214254a9e3b2390e24c389920b84e95`): preflight, clean_state, + ownership, qdrant_up, self_heal_create_missing, self_heal_repairs_missing_index, + incompatible_refused, require_existing_refused, rebuild_recreates_contract, secret_scan, + cleanup_confinement. - **Gates:** backend 666/666 + tsc clean; Go build+test 9/9; p4 runner unit tests 3/3; harness 841 passed (only the two pre-existing debt failures unchanged). -- **Manual acceptance:** PENDING — walkthrough section P4 in `docs/testing/p2-p6-manual-verification.md`. +- **Manual acceptance:** PASS (owner approval 2026-08-13) — walkthrough section P4 in + `docs/testing/p2-p6-manual-verification.md`. ### P2 host preprocessing CLI — implementation complete, automated PASS, manual PENDING (2026-08-11) diff --git a/docs/testing/p2-p6-manual-verification.md b/docs/testing/p2-p6-manual-verification.md index a37c17a4..e3f9f24e 100644 --- a/docs/testing/p2-p6-manual-verification.md +++ b/docs/testing/p2-p6-manual-verification.md @@ -58,7 +58,7 @@ Decision: **PENDING** (independent manual gate; automation never records PASS). ## P3 — Effective configuration and `.tht-dwh` -**Status:** P3 implementation complete; automated integration PASS; manual acceptance PENDING. +**Status:** P3 implementation complete; automated integration PASS; manual acceptance PASS (owner approval 2026-08-13). Manual goal: prove that the operator CLI and application sessions derive the same effective configuration, that a content-only revision reuses the prepared DWH generation (fast, `unchanged`), @@ -81,10 +81,10 @@ Checks: records remain workspace-wide; 6. documentation: `docs/contracts/tht-dwh.md` matches the observed behavior. -Decision: **PENDING**. +Decision: **PASS** (owner approval 2026-08-13). ## P4 — Qdrant bootstrap and guarded rebuild -**Status:** instructions to be finalized by P4 implementation; not yet runnable. +**Status:** superseded by the "P4 Qdrant collection lifecycle" section below (implemented; manual acceptance PASS). Manual goal: prove admission creates a missing compatible collection and indexes, refuses an incompatible collection, and permits destructive rebuild only under durable maintenance with no @@ -100,14 +100,14 @@ Checks to fill during P4: 6. successful drained rebuild; 7. interrupted rebuild recovery with maintenance retained. -Decision: **PENDING**. +Decision: **PASS** (owner approval 2026-08-13; see the section below). ## P4 Qdrant collection lifecycle Manual goal: verify admission self-heal and the guarded rebuild through the real product surface. -Checks to complete during P4 manual acceptance (decision: **PENDING**): +Checks to complete during P4 manual acceptance (decision: **PASS** (owner approval 2026-08-13)): 1. On a fresh installation with no Qdrant collection, a session admission creates the descriptor collection with exactly 1024 dimensions, cosine distance, and the 8 required