mptyl/ThothII
1
0
Fork 0
Code Issues 25 Pull Requests Actions Packages Projects Releases 1 Wiki Activity

docs: record P3+P4 manual acceptance and rebind P4 automated run to e056c19

Browse Source
This commit is contained in:
marcopan
2026-08-13 04:44:50 +02:00
parent e056c19e62
commit 3397911670
2 changed files with 17 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files
PROJECT_STATE.md
+12 -9
View File
@@ -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)
docs/testing/p2-p6-manual-verification.md
+5 -5
View File
@@ -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