From e22a615953e5b19ab81985dd518b4df42f9fa96a Mon Sep 17 00:00:00 2001 From: xeonvs <11463419+xeonvs@users.noreply.github.com> Date: Thu, 3 Sep 2026 11:01:51 +0200 Subject: [PATCH 1/3] plan: reconcile post-release document truth --- PLANS.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/PLANS.md b/PLANS.md index 116f44f..05d522c 100644 --- a/PLANS.md +++ b/PLANS.md @@ -5,3 +5,27 @@ before handoff or commit. Completed stable plans are indexed in [the execution-history archive](docs/engineering/execution_history/README.md). ## Active Work + +### Reconcile post-release context-document truth + +Status: active +Owner: Codex +Last Updated: 2026-09-03 +Release classification: `no-release` +Published stable version: `0.9.0` +Branch: `codex/reconcile-v0.9.0-document-truth` + +#### Goal + +Remove the stale claim that the implemented current context/evidence contracts remain on an +active release branch after v0.9.0 publication and branch cleanup. Keep the correction bounded +to repository documentation and its existing documentation contract; do not modify runtime, +package versions, OCR compatibility, release objects, or external artifacts. + +#### Work + +1. [x] Confirm from live repository state that v0.9.0 is published, externally reconciled, and + its feature/release/closure branches are absent. +2. [ ] Replace the stale branch-local wording with current-main and archived-release ownership. +3. [ ] Run the focused documentation contract and `git diff --check`, self-review, reset this plan, + pass protected checks, merge, delete the branch, and synchronize `main`. From 472620ad66f0cc85eeeb2c4b1dc104faa9621d22 Mon Sep 17 00:00:00 2001 From: xeonvs <11463419+xeonvs@users.noreply.github.com> Date: Thu, 3 Sep 2026 11:02:49 +0200 Subject: [PATCH 2/3] docs: remove stale release-branch context --- PLANS.md | 3 ++- docs/engineering/m5_context_contracts.md | 2 +- tests/test_operations_docs.py | 6 ++++++ 3 files changed, 9 insertions(+), 2 deletions(-) diff --git a/PLANS.md b/PLANS.md index 05d522c..8fb74b6 100644 --- a/PLANS.md +++ b/PLANS.md @@ -26,6 +26,7 @@ package versions, OCR compatibility, release objects, or external artifacts. 1. [x] Confirm from live repository state that v0.9.0 is published, externally reconciled, and its feature/release/closure branches are absent. -2. [ ] Replace the stale branch-local wording with current-main and archived-release ownership. +2. [x] Replace the stale branch-local wording with current-main, test-matrix, and archived-release + ownership, enforced by the existing documentation ownership contract. 3. [ ] Run the focused documentation contract and `git diff --check`, self-review, reset this plan, pass protected checks, merge, delete the branch, and synchronize `main`. diff --git a/docs/engineering/m5_context_contracts.md b/docs/engineering/m5_context_contracts.md index 2f743a4..f09da6d 100644 --- a/docs/engineering/m5_context_contracts.md +++ b/docs/engineering/m5_context_contracts.md @@ -1,6 +1,6 @@ # M5 Bounded Review-Context Contracts -This checkpoint fixed the v0.7.0 production contracts before implementation and remains the engineering-level boundary record. The implementation now exists on the active release branch; production-owner evidence and remaining real-OCR/stable-release limits are recorded in the active plan and test-evidence matrix. Public operator behavior is owned by [Bounded review context](../review-context.md). +This checkpoint fixed the v0.7.0 production contracts before implementation and remains the engineering-level boundary record. The implementation and current contracts live on `main`; production-owner evidence and explicit residual limits are recorded in the test-evidence matrix, while completed release evidence is archived in the execution history. Public operator behavior is owned by [Bounded review context](../review-context.md). ## Ownership and dependency direction diff --git a/tests/test_operations_docs.py b/tests/test_operations_docs.py index fab25da..79fca8b 100644 --- a/tests/test_operations_docs.py +++ b/tests/test_operations_docs.py @@ -90,6 +90,9 @@ def test_documentation_indexes_route_to_canonical_owners() -> None: engineering_index = (PROJECT_ROOT / "docs" / "engineering" / "README.md").read_text( encoding="utf-8" ) + context_contracts = ( + PROJECT_ROOT / "docs" / "engineering" / "m5_context_contracts.md" + ).read_text(encoding="utf-8") readme = README.read_text(encoding="utf-8") for index in (docs_index, codex_index, engineering_index): @@ -125,6 +128,9 @@ def test_documentation_indexes_route_to_canonical_owners() -> None: assert "not a second source" in codex_index assert "without duplicating their rules" in engineering_index assert "docs/README.md" in readme + assert "current contracts live on `main`" in context_contracts + assert "active release branch" not in context_contracts + assert "active plan" not in context_contracts def test_release_archive_reconciles_current_external_delivery_truth() -> None: From b5f4ed0f448ddbbbebd7b1ef29432ccca5ff1454 Mon Sep 17 00:00:00 2001 From: xeonvs <11463419+xeonvs@users.noreply.github.com> Date: Thu, 3 Sep 2026 11:03:23 +0200 Subject: [PATCH 3/3] plan: complete context-document reconciliation --- PLANS.md | 25 ------------------------- 1 file changed, 25 deletions(-) diff --git a/PLANS.md b/PLANS.md index 8fb74b6..116f44f 100644 --- a/PLANS.md +++ b/PLANS.md @@ -5,28 +5,3 @@ before handoff or commit. Completed stable plans are indexed in [the execution-history archive](docs/engineering/execution_history/README.md). ## Active Work - -### Reconcile post-release context-document truth - -Status: active -Owner: Codex -Last Updated: 2026-09-03 -Release classification: `no-release` -Published stable version: `0.9.0` -Branch: `codex/reconcile-v0.9.0-document-truth` - -#### Goal - -Remove the stale claim that the implemented current context/evidence contracts remain on an -active release branch after v0.9.0 publication and branch cleanup. Keep the correction bounded -to repository documentation and its existing documentation contract; do not modify runtime, -package versions, OCR compatibility, release objects, or external artifacts. - -#### Work - -1. [x] Confirm from live repository state that v0.9.0 is published, externally reconciled, and - its feature/release/closure branches are absent. -2. [x] Replace the stale branch-local wording with current-main, test-matrix, and archived-release - ownership, enforced by the existing documentation ownership contract. -3. [ ] Run the focused documentation contract and `git diff --check`, self-review, reset this plan, - pass protected checks, merge, delete the branch, and synchronize `main`.