diff --git a/.agent-loop/CURRENT_STATE.md b/.agent-loop/CURRENT_STATE.md new file mode 100644 index 000000000..1f22e1117 --- /dev/null +++ b/.agent-loop/CURRENT_STATE.md @@ -0,0 +1,65 @@ +# Current Engineering State + +This page is the entry point for current engineering work. It separates durable +merged state from transient branch and pull-request activity so historical +plans and reviews cannot be mistaken for work that is still active. + +## Sources Of Truth + +Use these sources in order: + +1. [`docs/roadmap_status.md`](../docs/roadmap_status.md) states the capabilities + implemented on `main` and the remaining v0.1 milestones. +2. [Open pull requests](https://github.com/Flow-Research/workstream/pulls) + show work currently under review. An open PR is not implemented behavior. +3. The initiative table below records durable disposition and the next usable + planning boundary. +4. An initiative's `CHUNK_MAP.md` and chunk contracts explain dependencies and + scope. They must be checked against current `main` before implementation. +5. Review logs and files under `reviews/` are historical evidence for the exact + change they reviewed. They never describe current repository state by + themselves. + +Git history is authoritative when a static record conflicts with a merged +commit. GitHub permissions and branch protection govern contribution +authority; these records do not grant or withhold it. + +## Initiative Ledger + +| Initiative | Durable state on `main` | Remaining boundary | +|---|---|---| +| [WS-ART-001](initiatives/WS-ART-001-immutable-artifact-storage/STATUS.md) | Active delivery initiative; admission foundations are merged through `04C1` | Continue dependency-ordered artifact custody and v0.1 conformance; use open PRs for transient ownership | +| [WS-AUTH-001](initiatives/WS-AUTH-001-workstream-authorization-service/STATUS.md) | Active delivery initiative; foundations and project-policy authority are merged through `12F3` | Remaining activation chunks depend on exact merged POL, ART, and REV behavior; refresh each executable contract on current `main` | +| [WS-CON-001](initiatives/WS-CON-001-contribution-compensation-boundary/STATUS.md) | Active delivery initiative; policy persistence and shared lifecycle audit are merged | Complete hidden services, contribution records, conditional awards, fulfillment, and reconciliation after named AUTH and REV gates | +| [WS-POL-003](initiatives/WS-POL-003-unified-project-guide-compilation/STATUS.md) | Active delivery initiative; contract catalogue and unified guide adapter are merged through `02` | Continue hidden compilation persistence and later approval integration in dependency order | +| [WS-REV-001](initiatives/WS-REV-001-review-revision-lifecycle/STATUS.md) | Active delivery initiative; queue admission and reviewer-lease persistence are merged through `03A2` | Continue packet, review, decision, revision, recovery, and release chunks after named ART, AUTH, and CON gates | +| [WS-QUAL-002](initiatives/WS-QUAL-002-behavior-ownership-catalogue/STATUS.md) | Active quality initiative; catalogue foundation `01` is merged | Add context evidence, then populate subsystem ownership before considering a changed-line-aware mutation gate | +| [WS-XINT-002](initiatives/WS-XINT-002-art-auth-end-to-end/STATUS.md) | Guide and pre-submit materialization activation is merged | Continue only remaining ART and AUTH activation edges required by the artifact delivery path | +| [WS-XINT-003](initiatives/WS-XINT-003-rev-auth-end-to-end/STATUS.md) | REV authorization readiness through `02D` is merged | Later activation waves resume only against exact merged REV behavior | +| [WS-POL-002](initiatives/WS-POL-002-post-submit-checker-foundation/STATUS.md) | Earlier post-submit foundations are merged; future guide inference is superseded by WS-POL-003 | Reframe remaining executor work against WS-POL-003; do not revive the old inference path | +| [WS-POL-001](initiatives/WS-POL-001-submission-artifact-policy-foundation/STATUS.md) | Foundation initiative complete | Follow-up behavior belongs to current ART, POL, REV, or CON initiatives | +| [WS-QUAL-001](initiatives/WS-QUAL-001-backend-coverage-floor/STATUS.md) | Coverage closure complete; blocking mutation rollout retired | Preserve global 78 percent and protected-subsystem 90 percent floors; mutation needs a fresh changed-line-aware plan | +| [WS-CI-001](initiatives/WS-CI-001-backend-ci-acceleration/STATUS.md) | Semantic distributed backend lanes complete | Treat further CI optimization as a fresh measured bounded change | +| [WS-DOCS-001](initiatives/WS-DOCS-001-current-v01-documentation/STATUS.md) | Current v0.1 entry documentation complete | Keep current pages synchronized with merged capability changes | +| [WS-DOCS-002](initiatives/WS-DOCS-002-workstream-definition/STATUS.md) | Canonical Workstream definition complete | Preserve terminology across current documentation and generated artifacts | +| [WS-XINT-001](initiatives/WS-XINT-001-lifecycle-boundary-reconciliation/STATUS.md) | Planning reconciliation complete and closed | Owner initiatives implement the resulting boundaries | +| [WS-AUTH-002](initiatives/WS-AUTH-002-authorization-docstring-lint-correction/STATUS.md) | Bounded correction complete | Future lint work is a new bounded change | +| [FN-ART-002](initiatives/FN-ART-002-deferred-flow-node-artifact-store/STATUS.md) | Deferred and outside the Workstream v0.1 delivery path | Reconsider only through a new explicit initiative | +| [WS-ENG-001 through WS-ENG-008](initiatives/README.md#historical-eng-initiatives) | Historical and closed or superseded | Do not use signed-start, loop-memory, recovery, or archive proposals as current instructions | + +## How To Start Contributing + +1. Pull current `main` and read `CONTRIBUTING.md`, the capability ledger, and + the relevant canonical specification. +2. Check [open pull requests](https://github.com/Flow-Research/workstream/pulls) + for overlapping work. Coordinate ownership if paths or behavior overlap. +3. Select a remaining boundary above or propose another bounded improvement. +4. State intent, scope, non-goals, acceptance criteria, verification commands, + risk, and reviewers. A small change may do this in its PR; non-trivial work + uses the smallest applicable initiative or chunk artifact. +5. Implement on a branch or fork, test, review, reconcile with current `main`, + and open a pull request. Human maintainers decide whether it merges. + +Distinct initiatives may proceed concurrently. A merge in another initiative +requires integration review only where it changes the current branch's base, +contracts, paths, or evidence—not ceremonial repetition of unaffected work. diff --git a/.agent-loop/README.md b/.agent-loop/README.md index 0c511bee4..a24bbab1c 100644 --- a/.agent-loop/README.md +++ b/.agent-loop/README.md @@ -19,3 +19,9 @@ initiative plan and chunk contract. Different initiatives may run concurrently. GitHub permissions govern who may contribute. CI validates quality. Human maintainers decide merges. See [CONTRIBUTING.md](../CONTRIBUTING.md). + +Start with [CURRENT_STATE.md](CURRENT_STATE.md) to see durable initiative +dispositions, remaining boundaries, and the live GitHub view of work under +review. `REVIEW_LOG.md` and initiative `reviews/` directories are archives for +exact historical changes; never use them to decide that a chunk is currently +active, blocked, approved, or complete. diff --git a/.agent-loop/REVIEW_LOG.md b/.agent-loop/REVIEW_LOG.md index 4f605c510..3a24e7c9b 100644 --- a/.agent-loop/REVIEW_LOG.md +++ b/.agent-loop/REVIEW_LOG.md @@ -1,11 +1,12 @@ # Review Log -> Historical record: entries below preserve the review context that existed +> **ARCHIVE — NOT CURRENT STATE.** Entries below preserve the review context that existed > when each change was evaluated. References to signed starts, loop memory, > recovery certificates, machine scope, pending PRs, or future successors are -> not current status. PR #207 retired that repository-control runtime. Use -> `CONTRIBUTING.md` for the current engineering loop and the initiative -> `STATUS.md` files for final ENG dispositions. +> not current status. PR #207 retired that repository-control runtime. Do not +> derive active, blocked, approved, incomplete, or next work from this file. +> Use `.agent-loop/CURRENT_STATE.md`, `docs/roadmap_status.md`, current `main`, +> and open GitHub pull requests instead. ## 2026-07-21 - WS-AUTH-001-10B Internal Plan Review diff --git a/.agent-loop/initiatives/README.md b/.agent-loop/initiatives/README.md index de5504efd..5c08e2d56 100644 --- a/.agent-loop/initiatives/README.md +++ b/.agent-loop/initiatives/README.md @@ -8,6 +8,11 @@ recovery scripts. Those references describe the process used at that time; do not execute them as current commands. Current contribution guidance lives in [`CONTRIBUTING.md`](../../CONTRIBUTING.md). +Current initiative disposition and remaining boundaries live in +[`CURRENT_STATE.md`](../CURRENT_STATE.md). Use GitHub's open pull requests for +transient work. Do not infer current work from a review file, branch name, old +`Active` field, or chronological log entry. + ## Historical ENG Initiatives ENG-001 through ENG-008 record the repository-control work that preceded the diff --git a/.agent-loop/initiatives/WS-ART-001-immutable-artifact-storage/CHUNK_MAP.md b/.agent-loop/initiatives/WS-ART-001-immutable-artifact-storage/CHUNK_MAP.md index f9bdc87e6..f555f9cab 100644 --- a/.agent-loop/initiatives/WS-ART-001-immutable-artifact-storage/CHUNK_MAP.md +++ b/.agent-loop/initiatives/WS-ART-001-immutable-artifact-storage/CHUNK_MAP.md @@ -33,7 +33,7 @@ they cross multiple L1 boundaries. | `WS-ART-001-04B1` | Add the single versioned checker catalogue and compile one effective execution plan from platform defaults plus locked project policy. | L1 | Merged PR #276 | | `WS-ART-001-04B2` | Materialize the sealed manifest tree once and execute the mandatory platform/default catalogue phases. | L1 | Merged PR #282 | | `WS-ART-001-04B3` | Execute locked project-policy rules through the same plan and persist one bounded immutable evidence set. | L1 | Merged PR #291 as `8f516e6d` | -| `WS-ART-001-04C1` | Reauthorize and atomically persist the evidence-linked submission intent, capacity, and generic put attempt, then write the checked ZIP once. | L1 | Ready after merged XINT-06A | +| `WS-ART-001-04C1` | Reauthorize and atomically persist the evidence-linked submission intent, capacity, and generic put attempt, then write the checked ZIP once. | L1 | Merged PR #296 | | `WS-ART-001-04C2` | Reuse verification/recovery to publish one capacity-charged ready admission and compose the hidden continuous endpoint. | L1 | Proposed after 04C1 | | `WS-ART-001-05A` | Atomically consume ready admission into one immutable Submission and binding under fresh human/service authority. | L1 | Proposed after XINT-05A | | `WS-ART-001-05B` | Atomically cut the live Submission API/dispatch to verified admission and remove the complete legacy standalone/internal precheck and caller-owned package contract. | L1 | Proposed after XINT-05B | diff --git a/.agent-loop/initiatives/WS-ART-001-immutable-artifact-storage/REVIEW_LOG.md b/.agent-loop/initiatives/WS-ART-001-immutable-artifact-storage/REVIEW_LOG.md index 2cc401342..fe4d75db7 100644 --- a/.agent-loop/initiatives/WS-ART-001-immutable-artifact-storage/REVIEW_LOG.md +++ b/.agent-loop/initiatives/WS-ART-001-immutable-artifact-storage/REVIEW_LOG.md @@ -1,5 +1,9 @@ # Review Log: WS-ART-001 Immutable Artifact Storage +> Archive only. Use `../../CURRENT_STATE.md`, current `main`, and open pull +> requests for current state. Entries below apply only to the exact reviewed +> changes and do not activate, block, or complete later work. + ## WS-ART-001-03A - Reconciled on 2026-07-28 with trusted `main` `033654ac`, after merged diff --git a/.agent-loop/initiatives/WS-ART-001-immutable-artifact-storage/STATUS.md b/.agent-loop/initiatives/WS-ART-001-immutable-artifact-storage/STATUS.md index ec15ff0cf..48400f264 100644 --- a/.agent-loop/initiatives/WS-ART-001-immutable-artifact-storage/STATUS.md +++ b/.agent-loop/initiatives/WS-ART-001-immutable-artifact-storage/STATUS.md @@ -106,13 +106,11 @@ adds bounded PPTX slide/notes extraction. 03B3B3D merged through PR #238 and adds bounded XLSX cell extraction. 03B3B4 merged through PR #239 and adds only bounded PNG/JPEG/WebP structural metadata. 03B4 merged through PR #240 and adds the hidden same-generation sufficiency continuation. ART-03C and ART-04A1 are -merged. ART-04A1 merged through PR #264. ART-04A2 is implemented on its -bounded branch with internal L1 reviews passed; hosted PR gates and human merge -remain pending. +merged. ART-04A1 merged through PR #264, and ART-04A2 merged through PR #266. AUTH `WS-XINT-002-04B` activated only fixed-service binding and guide read. ART-03C removed the legacy identity/excerpt path and made the verified pipeline -authoritative. ART-04A2 merged through PR #266. ART-04A3 merged through PR #268 +authoritative. ART-04A3 merged through PR #268 and provides canonical server-derived semantic manifests, executable normalization, and fail-closed unchanged-work comparison. @@ -134,9 +132,10 @@ exposure, provider I/O, or AUTH activation. `WS-ART-001-04B3` merged through PR #291 as `8f516e6d`. It executes the project-policy continuation through that same plan and sealed tree and persists one immutable platform-plus-project evidence set. AUTH `WS-XINT-002-06A` merged through PR #293 as `1ddb941e` and -activated only the mandatory fixed pre-submit materializer. ART-04C1 is now -unblocked; its preimplementation review requires the durable intent correction -recorded in the current 04C1 contract before runtime implementation. +activated only the mandatory fixed pre-submit materializer. ART-04C1 then +merged through PR #296 and persists the evidence-linked durable put intent. +The dependency-ordered successor is 04C2; open pull requests determine whether +it is currently under review. ## Gate diff --git a/.agent-loop/initiatives/WS-AUTH-001-workstream-authorization-service/CHUNK_MAP.md b/.agent-loop/initiatives/WS-AUTH-001-workstream-authorization-service/CHUNK_MAP.md index e4940563b..92c13c3d7 100644 --- a/.agent-loop/initiatives/WS-AUTH-001-workstream-authorization-service/CHUNK_MAP.md +++ b/.agent-loop/initiatives/WS-AUTH-001-workstream-authorization-service/CHUNK_MAP.md @@ -49,13 +49,13 @@ stopped. | `WS-AUTH-001-ART-CUSTODY` | ART Activation Custody Transfer | L1 | Merged through PR #158 as `be2a79a2`; historical 25-row transfer later reconciled by WS-XINT-002-01 to 22 planned ART actions | | `WS-AUTH-001-REV-CUSTODY` | REV Activation Custody Transfer | L1 | Merged through PR #160 as `fe0e4492`; all 19 REV actions remain planned | | `WS-AUTH-001-PREP` | Prepared Mutation Authorization Protocol | L1 | Merged through PR #162 as `c559d556`; no feature consumer or activation | -| `WS-AUTH-001-10` | Project Qualification And Contributor Role Grants | L1 | Active planning-only parent; split approved after failed L1 combined review | -| `WS-AUTH-001-10A` | Project Role Grant Data And Evidence Foundation | L1 | Proposed successor; migration `0031`, no active surface | -| `WS-AUTH-001-10B` | Project Role Grant Read Planning Parent | L1 | Active start split before runtime implementation | -| `WS-AUTH-001-10B1` | Durable Authorization Read Rate Control | L1 | Proposed successor after 10B planning merge/memory | -| `WS-AUTH-001-10B2` | Privacy-Safe Project Role Grant Reads | L1 | Proposed after 10B1 | -| `WS-AUTH-001-10C` | Project Role Grant Mutations | L1 | Proposed after 10B2 | -| `WS-AUTH-001-11` | Project Read Cutover Planning Parent | L1 | Signed start run `30167274426`; planning split authored, no runtime implementation | +| `WS-AUTH-001-10` | Project Qualification And Contributor Role Grants | L1 | Planning split merged PR #168 | +| `WS-AUTH-001-10A` | Project Role Grant Data And Evidence Foundation | L1 | Merged PR #170; migration `0031` | +| `WS-AUTH-001-10B` | Project Role Grant Read Planning Parent | L1 | Planning split merged PR #173 | +| `WS-AUTH-001-10B1` | Durable Authorization Read Rate Control | L1 | Merged PR #175 | +| `WS-AUTH-001-10B2` | Privacy-Safe Project Role Grant Reads | L1 | Merged PR #178 | +| `WS-AUTH-001-10C` | Project Role Grant Mutations | L1 | Merged PR #194 | +| `WS-AUTH-001-11` | Project Read Cutover Planning Parent | L1 | Planning split merged PR #201 | | `WS-AUTH-001-11A` | Project Read Catalogue And Projection Foundation | L1 | Merged in PR #208; migration `0035`, no active surface | | `WS-AUTH-001-11B` | Project Identity And Actor Context Cutover | L1 | Merged in PR #214 as `033654ac` | | `WS-AUTH-001-11C1` | Project Setup Diagnostic Read Cutover | L1 | Merged in PR #216 as `2965a9f9` | diff --git a/.agent-loop/initiatives/WS-AUTH-001-workstream-authorization-service/STATUS.md b/.agent-loop/initiatives/WS-AUTH-001-workstream-authorization-service/STATUS.md index 56bbf3c33..5b9485ea8 100644 --- a/.agent-loop/initiatives/WS-AUTH-001-workstream-authorization-service/STATUS.md +++ b/.agent-loop/initiatives/WS-AUTH-001-workstream-authorization-service/STATUS.md @@ -113,27 +113,27 @@ complete, and exact code SHA `4d1fc507` passed all nine internal tracks. PR #153 merged the contributor foundation as `8d5eb15` on 2026-07-19. No service caller or consumer feature action is active. -## Active planning chunk +## Current planning boundary -`WS-AUTH-001-12`; the user started it on 2026-07-29. Required L1 -preimplementation review rejected the inherited combined runtime contract -before application-code edits. The repaired planning parent now splits runtime -work into 12A through 12H plus 12B2 and 12D2. All nine exact-plan reviewer -tracks passed after action-custody, canonical-lineage reuse, and fixed-service -setup-run binding findings were repaired. +`WS-AUTH-001-12` planning is merged. Required L1 preimplementation review +rejected the inherited combined runtime contract before application-code edits. +The repaired planning parent records 12A through 12H, 12B2, and the later 12I +unified compilation gate. The former 12D2 path is superseded by merged +WS-XINT-003-02A/02B. All nine exact-plan reviewer tracks passed after +action-custody, canonical-lineage reuse, and fixed-service setup-run binding +findings were repaired. -## Active implementation chunk +## Current implementation state -None. Planning reconciliation is active after merged PR #295. No runtime chunk -may start until the unified `WS-POL-003` dependency graph and remaining AUTH, -ART, XINT, REV, and downstream contracts are reviewed and merged. +No AUTH implementation chunk is declared active in durable memory. PR #298 +merged the unified `WS-POL-003` dependency reconciliation, and PR #299 merged +its first contract chunk. Remaining AUTH runtime chunks follow their exact +merged POL, ART, XINT, REV, and downstream dependencies. The concise new 12I/12B2/12F4/12G/12H records are dependency skeletons, not implementation authority; each requires a then-current executable contract with explicit path scope, commands, and named reviewers before human start. -## Current review branch - -`codex/ws-pol-003-auth-plan-reconciliation`. +Open pull requests, not this file, are the transient review view. ## Chunk status @@ -168,13 +168,13 @@ with explicit path scope, commands, and named reviewers before human start. | `WS-AUTH-001-ART-CUSTODY` | Merged | `codex/ws-auth-001-art-custody` | #158 | Merged as `be2a79a2` on 2026-07-20; all 25 ART actions remain planned. | | `WS-AUTH-001-REV-CUSTODY` | Merged | `codex/ws-auth-001-rev-custody` | #160 | Merged as `fe0e4492` on 2026-07-20; all 19 REV actions remain planned. | | `WS-AUTH-001-PREP` | Merged | `codex/ws-auth-001-prep` | #162 | Merged as `c559d556` on 2026-07-21; adds no feature consumer or activation. | -| `WS-AUTH-001-10` | Proposed | - | - | Project contributor grants. | -| `WS-AUTH-001-11` | Planning split authored | `codex/ws-auth-001-11-project-read-cutover` | - | Exact hard-cutover inventory split into 11A, 11B, 11C1, and 11C2; signed automation remains the live-state authority. | +| `WS-AUTH-001-10` | Completed through children | `codex/ws-auth-001-10-project-role-grants` | #168 | Planning split merged; 10A, 10B1, 10B2, and 10C later merged through PRs #170, #175, #178, and #194. | +| `WS-AUTH-001-11` | Planning split merged | `codex/ws-auth-001-11-project-read-cutover` | #201 | Exact hard-cutover inventory split into 11A, 11B, 11C1, and 11C2. | | `WS-AUTH-001-11A` | Merged | `codex/ws-auth-001-11a-project-read-catalogue` | #208 | Registered the project-read catalogue and migration `0035`; no activation. | | `WS-AUTH-001-11B` | Merged | `codex/ws-auth-001-11b-project-identity-context` | #214 | Project identity and self authorization-context hard cutover; merged as `033654ac`. | | `WS-AUTH-001-11C1` | Merged | `codex/ws-auth-001-11c1-setup-diagnostic-reads` | #216 | Setup-diagnostic read hard cutover merged as `2965a9f9` on 2026-07-28. | | `WS-AUTH-001-11C2` | Merged | `codex/ws-auth-001-11c2-effective-policy-active-guide-reads` | #221 | Effective-policy and active-guide read cutover merged as `3fc323d7` on 2026-07-29. | -| `WS-AUTH-001-12` | Planning repair | `codex/ws-auth-001-12-project-mutation-cutover` | - | Combined runtime contract rejected; planning parent split into 12A-12H plus 12B2/12D2 before code. | +| `WS-AUTH-001-12` | Planning split merged | `codex/ws-auth-001-12-project-mutation-cutover` | #224 | Combined runtime contract rejected; planning parent split into 12A-12H plus 12B2/12D2 before code. | | `WS-AUTH-001-12A` | Merged | `codex/ws-auth-001-12a-project-mutation-catalogue` | #226 | Exact 18-action planned catalogue, typed resource/PREP scope, and migration `0041`; merged as `64dd9c98` with zero activation. | | `WS-AUTH-001-12B` | Merged | `codex/ws-auth-001-12b-project-setup-service` | #227 | Fixed project-setup service identity and planned matrix only; zero activation and no actor/link seed. | | `WS-AUTH-001-12B2` | Proposed | - | - | Setup-ledger activation after hidden POL-04A; POL-04B owns the live setup-service cutover. | @@ -182,7 +182,7 @@ with explicit path scope, commands, and named reviewers before human start. | `WS-AUTH-001-12D` | Merged | `codex/ws-auth-001-12d-guide-draft-source` | #232 | Draft guide and source metadata mutation cutover merged as `99dc0b34`. | | `WS-AUTH-001-12D2` | Superseded | - | #248 | XINT-003-02A/02B own immutable review/revision policy lineage and the sole authorized mutation path; 02B merged as `25fc27c4`. | | `WS-AUTH-001-12E` | Merged; transitional | `codex/ws-auth-001-12e-guide-sufficiency` | #263 | Merged as `b510bc4f`; projection custody remains reusable, but the standalone inference entry point becomes unreachable at POL-04B and is deleted at POL-08. | -| `WS-AUTH-001-12F` | Planning split | `codex/ws-auth-001-12f-submission-artifact-policy` | - | Combined contract failed required L1 pre-start review; parent now activates nothing and delegates to 12F1-12F4. | +| `WS-AUTH-001-12F` | Planning split merged | `codex/ws-auth-001-12f-submission-artifact-policy` | #283 | Combined contract failed required L1 preimplementation review; parent activates nothing and delegates to 12F1-12F4. | | `WS-AUTH-001-12F1` | Merged | `codex/ws-auth-001-12f1-submission-policy-foundation` | #286 | Submission-policy PREP, replay, provenance, and audit custody foundation merged as `5a4186cc`; zero activation. | | `WS-AUTH-001-12F2` | Merged | `codex/ws-auth-001-12f2-manual-submission-policy` | #292 | Governed Project Manager append-only manual-draft create/update cutover merged as `81f281bd`. | | `WS-AUTH-001-12F3` | Merged; transitional | `codex/ws-auth-001-12f3-service-derivation` | #295 | Merged as `99c0aaf0`; authority/provenance is reused, while its separate inference entry point is removed at POL-04B. | diff --git a/.agent-loop/initiatives/WS-AUTH-002-authorization-docstring-lint-correction/CHUNK_MAP.md b/.agent-loop/initiatives/WS-AUTH-002-authorization-docstring-lint-correction/CHUNK_MAP.md index f9687c1dc..9320b4da0 100644 --- a/.agent-loop/initiatives/WS-AUTH-002-authorization-docstring-lint-correction/CHUNK_MAP.md +++ b/.agent-loop/initiatives/WS-AUTH-002-authorization-docstring-lint-correction/CHUNK_MAP.md @@ -2,7 +2,7 @@ | Chunk | Purpose | Dependency | State | |---|---|---|---| -| `WS-AUTH-002-PLAN` | Establish the reviewed corrective boundary | none | proposed | -| `WS-AUTH-002-01` | Add the four AUTH-owned public docstrings | PLAN merged and explicit signed start | inactive | +| `WS-AUTH-002-PLAN` | Establish the reviewed corrective boundary | none | Merged PR #199 | +| `WS-AUTH-002-01` | Add the four AUTH-owned public docstrings | PLAN merged | Merged PR #200 | No later chunk is declared. PR #198 integration remains owned by `WS-CI-001`. diff --git a/.agent-loop/initiatives/WS-AUTH-002-authorization-docstring-lint-correction/STATUS.md b/.agent-loop/initiatives/WS-AUTH-002-authorization-docstring-lint-correction/STATUS.md index fb2b7d86b..a8b6ed5a1 100644 --- a/.agent-loop/initiatives/WS-AUTH-002-authorization-docstring-lint-correction/STATUS.md +++ b/.agent-loop/initiatives/WS-AUTH-002-authorization-docstring-lint-correction/STATUS.md @@ -1,7 +1,6 @@ # Status: WS-AUTH-002 — Authorization Docstring Lint Correction -- Phase: implementation -- Active planning chunk: none -- Active implementation chunk: `WS-AUTH-002-01` -- Completed planning chunk: `WS-AUTH-002-PLAN` -- Gate: implementation review and hosted evidence +- Phase: complete +- `WS-AUTH-002-PLAN` merged through PR #199. +- `WS-AUTH-002-01` merged through PR #200. +- No remaining chunk is declared. diff --git a/.agent-loop/initiatives/WS-CI-001-backend-ci-acceleration/CHUNK_MAP.md b/.agent-loop/initiatives/WS-CI-001-backend-ci-acceleration/CHUNK_MAP.md index 03c7c9170..c6470ba81 100644 --- a/.agent-loop/initiatives/WS-CI-001-backend-ci-acceleration/CHUNK_MAP.md +++ b/.agent-loop/initiatives/WS-CI-001-backend-ci-acceleration/CHUNK_MAP.md @@ -7,7 +7,7 @@ | `WS-CI-001-02` | Safe Routing, Cache, and Timing Refinement | L1 | Completed | | `WS-CI-001-02A` | Safe Migrate-Once Database Reset | L1/P0 | Completed and merged | | `WS-CI-001-02B` | Exact-Custody Semantic Test Lanes | L1/P0 | Completed and merged in PR #198 | -| `WS-CI-001-03` | Distributed Semantic Test Lanes | L1 | In implementation | +| `WS-CI-001-03` | Distributed Semantic Test Lanes | L1 | Completed and merged in PR #252 | Each chunk maps to one PR. Chunk 01 preserves the full suite and every coverage gate. Chunk 01R1 repaired timeout cleanup. Chunk 02 converts measured evidence diff --git a/.agent-loop/initiatives/WS-CI-001-backend-ci-acceleration/STATUS.md b/.agent-loop/initiatives/WS-CI-001-backend-ci-acceleration/STATUS.md index eeb96c522..99e7bd6bb 100644 --- a/.agent-loop/initiatives/WS-CI-001-backend-ci-acceleration/STATUS.md +++ b/.agent-loop/initiatives/WS-CI-001-backend-ci-acceleration/STATUS.md @@ -1,13 +1,10 @@ # STATUS: WS-CI-001 - Backend CI Acceleration -- Phase: implementation -- Current chunk: `WS-CI-001-03` -- Goal: restore distributed semantic lanes and eliminate unchanged-head review reruns -- Current measured regression: successful run `30782031524` took 17m20s; - semantic-lane execution consumed 15m31s on one hosted runner. -- Implemented correction: five hosted matrix runners, including two exact-node +- Phase: complete +- Completed chunk: `WS-CI-001-03`, merged through PR #252 +- Outcome: restored distributed semantic lanes and eliminated unchanged-head + review reruns using five hosted matrix runners, including two exact-node Alembic partitions, fail-closed evidence and coverage fan-in, lightweight review-state approval refresh, and superseded-run cancellation. -- Remaining gate: repaired internal review, exact checked-out-tree GitHub CI, - external review, and human merge decision. +- Further CI optimization requires a fresh measured bounded change. diff --git a/.agent-loop/initiatives/WS-CON-001-contribution-compensation-boundary/CHUNK_MAP.md b/.agent-loop/initiatives/WS-CON-001-contribution-compensation-boundary/CHUNK_MAP.md index 58e2a4b52..16f83a270 100644 --- a/.agent-loop/initiatives/WS-CON-001-contribution-compensation-boundary/CHUNK_MAP.md +++ b/.agent-loop/initiatives/WS-CON-001-contribution-compensation-boundary/CHUNK_MAP.md @@ -27,7 +27,7 @@ signed-loop records do not make behavior live. | Chunk | Goal | Entry gate | Status | |---|---|---|---| | `03B` | Contribution-policy persistence | 03A | Merged PR #274; REV-03A2 FK is unblocked | -| `02C` | Shared lifecycle-audit participant | PLAN4; current AuditEvent contract | Implementation, deterministic proof, and required internal review complete; PR/external review pending; independent of dispatcher; required before REV-04B | +| `02C` | Shared lifecycle-audit participant | PLAN4; current AuditEvent contract | Merged PR #277; independent of dispatcher; required before REV-04B | | `04A` | Hidden adapter-binding service | 03A + exact AUTH registration/PREP contract | Blocked on AUTH registration | | `04B` | Hidden contribution-policy service | 03B + 04A + exact AUTH registration/PREP contract | Blocked on AUTH registration | | `05A` | Legacy semantic cutover + initial TaskAssignment policy freeze and guarded human-revision rebase support | 04B + task/assignment/revision authority contract + row-classification decision | Proposed | @@ -81,7 +81,7 @@ distributed-lane changes. ## Stop -CON-02C stops at its PR checkpoint. Do not begin another CON chunk -automatically. Binding creation/lifecycle behavior remains deferred and +CON-02C is merged. Do not infer that another CON chunk is active from this +sequence. Binding creation and lifecycle behavior remain deferred and existing ART/REV identities do not substitute for the future AUTH-approved compensation adapter contract. diff --git a/.agent-loop/initiatives/WS-CON-001-contribution-compensation-boundary/STATUS.md b/.agent-loop/initiatives/WS-CON-001-contribution-compensation-boundary/STATUS.md index 7a2c2ac31..3f42c54eb 100644 --- a/.agent-loop/initiatives/WS-CON-001-contribution-compensation-boundary/STATUS.md +++ b/.agent-loop/initiatives/WS-CON-001-contribution-compensation-boundary/STATUS.md @@ -8,9 +8,8 @@ - PLAN5 is merged in PR #270 and preserves the human-confirmed complete-context `needs_revision` rebase rule. - Runtime on main contains shared outbox persistence, the schema-only - compensation binding foundation, and contribution-policy persistence. 02C - implementation, deterministic proof, internal review, and external checks - are complete; human approval and merge remain pending. Contribution-record, + compensation binding foundation, contribution-policy persistence, and the + 02C shared lifecycle-audit participant merged through PR #277. Contribution-record, dispatcher, fulfillment, operations, and CON API behavior remain absent. - The pre-existing local deletion of the archival reference PDF is user-owned and excluded from this runtime change. @@ -72,9 +71,7 @@ schema work. Current dependency analysis yields: ## Immediate next action -Move CON-02C through external review and human approval now that implementation, -deterministic proof, and required internal review are complete. REV-03A2 may -proceed against the merged contribution-policy version FK, and REV-04B may -proceed in parallel against the 02C contract but must merge after 02C. -Binding creation remains deferred to 04A after AUTH approves the exact adapter -identity/capability contract. +CON-02C merged through PR #277. REV-04B may consume its shared lifecycle-audit +participant after REV's earlier gates merge. Binding creation remains deferred +to CON-04A after AUTH approves the exact adapter identity and capability +contract. Open pull requests determine transient CON work. diff --git a/.agent-loop/initiatives/WS-DOCS-001-current-v01-documentation/CHUNK_MAP.md b/.agent-loop/initiatives/WS-DOCS-001-current-v01-documentation/CHUNK_MAP.md index c7e2e276a..ab94e9417 100644 --- a/.agent-loop/initiatives/WS-DOCS-001-current-v01-documentation/CHUNK_MAP.md +++ b/.agent-loop/initiatives/WS-DOCS-001-current-v01-documentation/CHUNK_MAP.md @@ -3,8 +3,9 @@ | Chunk | Purpose | State | | --- | --- | --- | | `WS-DOCS-001-01` | Modernize the current v0.1 documentation entry path and archive expired calendar framing | Merged through PR #246 | -| `WS-DOCS-001-02` | Reconcile remaining current-facing timeline wording, historical classification, and documentation initiative state | In progress | +| `WS-DOCS-001-02` | Reconcile remaining current-facing timeline wording, historical classification, and documentation initiative state | Merged through PR #250 | +| `WS-DOCS-001-03` | Establish one current engineering-state ledger and reconcile stale initiative and review-log navigation | Candidate; GitHub is authoritative for review and merge state | -Both chunks are documentation-only. The second chunk preserves historical -records verbatim where their old wording is itself evidence; it changes only -current-facing claims, classification, and navigation. +All three chunks are documentation-only. Chunk 02 preserved historical records +where old wording is itself evidence; chunk 03 makes that archive/current-state +boundary explicit and repairs current-facing initiative navigation. diff --git a/.agent-loop/initiatives/WS-DOCS-001-current-v01-documentation/STATUS.md b/.agent-loop/initiatives/WS-DOCS-001-current-v01-documentation/STATUS.md index 8f858ee2c..b15c6dc2f 100644 --- a/.agent-loop/initiatives/WS-DOCS-001-current-v01-documentation/STATUS.md +++ b/.agent-loop/initiatives/WS-DOCS-001-current-v01-documentation/STATUS.md @@ -4,8 +4,12 @@ capability-based v0.1 README, contribution path, agent guidance, current-status ledger, and historical-planning index. -`WS-DOCS-001-02` is the bounded current-state reconciliation. It removes the -remaining calendar language from current-facing material, classifies preserved -early planning and review documents as history, and refreshes this initiative's -own merged state. It changes no product behavior, architecture contract, -workflow, CI policy, or implementation initiative. +`WS-DOCS-001-02` merged through PR #250. It removed the remaining calendar +language from current-facing material, classified preserved early planning and +review documents as history, and refreshed this initiative's own merged state. +Ongoing documentation maintenance follows the ordinary bounded-change loop. + +`WS-DOCS-001-03` reconciles engineering-memory navigation and known stale +initiative dispositions. Its durable outcome is the repository-wide +`.agent-loop/CURRENT_STATE.md`; GitHub remains authoritative for the chunk's +transient review and merge state. diff --git a/.agent-loop/initiatives/WS-DOCS-001-current-v01-documentation/chunks/WS-DOCS-001-03-engineering-state-reconciliation.md b/.agent-loop/initiatives/WS-DOCS-001-current-v01-documentation/chunks/WS-DOCS-001-03-engineering-state-reconciliation.md new file mode 100644 index 000000000..f2a164ba1 --- /dev/null +++ b/.agent-loop/initiatives/WS-DOCS-001-current-v01-documentation/chunks/WS-DOCS-001-03-engineering-state-reconciliation.md @@ -0,0 +1,51 @@ +# Chunk Contract: WS-DOCS-001-03 Engineering State Reconciliation + +## Intent + +Make current engineering state discoverable without treating historical review +evidence or transient branch prose as repository truth. + +## Allowed Files + +- `AGENTS.md` +- `CONTRIBUTING.md` +- `docs/roadmap_status.md` +- `.agent-loop/README.md` +- `.agent-loop/CURRENT_STATE.md` +- `.agent-loop/REVIEW_LOG.md` +- `.agent-loop/initiatives/README.md` +- initiative `STATUS.md`, `CHUNK_MAP.md`, and `REVIEW_LOG.md` files whose + current-facing state contradicts merged GitHub history +- this chunk contract and its review evidence + +## Not Allowed + +- Product or runtime code +- CI workflows, tests, coverage floors, dependencies, or package commands +- Canonical product architecture or lifecycle semantics +- Deletion or rewriting of historical review evidence +- Static claims that a transient branch or pull request is active + +## Acceptance Criteria + +1. One current-state entry page distinguishes merged capability truth, + initiative disposition, transient pull requests, and historical reviews. +2. Contributor and agent entry paths link to that page and explain how to claim + work without planning artifacts becoming authorization gates. +3. Every `REVIEW_LOG.md` is visibly archive-only. +4. Known stale initiative states are reconciled to merged PR history. +5. Markdown links, stale-wording checks, and diff integrity pass. + +## Risk And Review + +- Risk: L1 documentation and engineering-process navigation +- Required review: docs, senior engineering, and reuse/deduplication +- Add QA review because incorrect initiative disposition can misroute work + +## Verification + +```bash +python3 scripts/check_markdown_links.py +python3 scripts/check_stale_workstream_wording.py +git diff --check +``` diff --git a/.agent-loop/initiatives/WS-DOCS-001-current-v01-documentation/reviews/WS-DOCS-001-03-external-review-response.md b/.agent-loop/initiatives/WS-DOCS-001-current-v01-documentation/reviews/WS-DOCS-001-03-external-review-response.md new file mode 100644 index 000000000..0e5aa9833 --- /dev/null +++ b/.agent-loop/initiatives/WS-DOCS-001-current-v01-documentation/reviews/WS-DOCS-001-03-external-review-response.md @@ -0,0 +1,32 @@ +# WS-DOCS-001-03 External Review Response + +## Comments Addressed + +1. CodeRabbit identified that the current AUTH-12 planning prose named + superseded `12D2` and omitted the canonical `12I` unified compilation gate. + The prose now records 12I and explicitly classifies 12D2 as superseded by + merged WS-XINT-003-02A/02B. +2. CodeRabbit identified that `docs/roadmap_status.md` changed without being + named in the chunk's allowed files. The exact path is now included. + +## Comments Deferred + +None. + +## Human Decisions Needed + +None. Both comments reconcile documentation with already merged repository +truth and the actual bounded diff. + +## Commands Rerun + +```text +python3 scripts/check_markdown_links.py +python3 scripts/check_stale_workstream_wording.py +git diff --check +``` + +## Remaining Risks + +None identified. Product behavior, runtime code, CI, dependencies, tests, and +coverage policy are unchanged by these repairs. diff --git a/.agent-loop/initiatives/WS-DOCS-001-current-v01-documentation/reviews/WS-DOCS-001-03-internal-review.md b/.agent-loop/initiatives/WS-DOCS-001-current-v01-documentation/reviews/WS-DOCS-001-03-internal-review.md new file mode 100644 index 000000000..4269671ad --- /dev/null +++ b/.agent-loop/initiatives/WS-DOCS-001-current-v01-documentation/reviews/WS-DOCS-001-03-internal-review.md @@ -0,0 +1,38 @@ +# WS-DOCS-001-03 Internal Review + +## Scope + +Current engineering-state navigation, stale initiative disposition repair, +review-log archival framing, contributor entry guidance, and the related v0.1 +capability-ledger correction. + +## Findings And Repairs + +- Senior engineering and documentation review found contradictory merged and + pending claims in ART, AUTH, CON, and XINT records. The current-facing status + and chunk-map entries now agree with merged GitHub history. +- Documentation review found stale DOCS chunk-count prose and an outdated + pre-submit capability claim. Both were reconciled. +- QA verified the cited merged PRs, contributor flow, archive markers, and + remaining capability boundaries. +- Reuse/deduplication confirmed that `CURRENT_STATE.md` is a navigation ledger, + not a competing implementation or capability source of truth. + +## Final Result + +- Documentation: PASS +- Senior engineering: PASS +- QA: PASS +- Reuse/deduplication: PASS +- Open findings: none + +External review is recorded separately in +`WS-DOCS-001-03-external-review-response.md`. + +## Deterministic Evidence + +```text +python3 scripts/check_markdown_links.py PASS +python3 scripts/check_stale_workstream_wording.py PASS +git diff --check PASS +``` diff --git a/.agent-loop/initiatives/WS-DOCS-002-workstream-definition/CHUNK_MAP.md b/.agent-loop/initiatives/WS-DOCS-002-workstream-definition/CHUNK_MAP.md index 8ddb8b0cc..ee7f3a4bf 100644 --- a/.agent-loop/initiatives/WS-DOCS-002-workstream-definition/CHUNK_MAP.md +++ b/.agent-loop/initiatives/WS-DOCS-002-workstream-definition/CHUNK_MAP.md @@ -2,7 +2,7 @@ | Chunk | Purpose | State | | --- | --- | --- | -| `WS-DOCS-002-01` | Align the canonical Workstream definition, lifecycle, trust model, and system boundary across current documentation | Locally complete | +| `WS-DOCS-002-01` | Align the canonical Workstream definition, lifecycle, trust model, and system boundary across current documentation | Merged through PR #253 | One documentation-only chunk prevents contradictory product definitions from existing between merges. diff --git a/.agent-loop/initiatives/WS-DOCS-002-workstream-definition/STATUS.md b/.agent-loop/initiatives/WS-DOCS-002-workstream-definition/STATUS.md index 0776eca3d..1a6933ed1 100644 --- a/.agent-loop/initiatives/WS-DOCS-002-workstream-definition/STATUS.md +++ b/.agent-loop/initiatives/WS-DOCS-002-workstream-definition/STATUS.md @@ -1,6 +1,5 @@ # Status -`WS-DOCS-002-01` is locally complete. Canonical entry, glossary, product, +`WS-DOCS-002-01` merged through PR #253. Canonical entry, glossary, product, architecture, status, principle, ADR, and context-diagram sources are aligned; -generated SVG, PNG, and PDF artifacts are current; deterministic checks and all -required internal reviews pass. PR publication remains. +generated SVG, PNG, and PDF artifacts were aligned to the current definition. diff --git a/.agent-loop/initiatives/WS-ENG-002-single-checkpoint-loop-start/REVIEW_LOG.md b/.agent-loop/initiatives/WS-ENG-002-single-checkpoint-loop-start/REVIEW_LOG.md index 9e34b6649..e19e9659a 100644 --- a/.agent-loop/initiatives/WS-ENG-002-single-checkpoint-loop-start/REVIEW_LOG.md +++ b/.agent-loop/initiatives/WS-ENG-002-single-checkpoint-loop-start/REVIEW_LOG.md @@ -1,5 +1,8 @@ # REVIEW LOG: WS-ENG-002 +> Archive only. This initiative is historical and closed. Do not use this log +> as current engineering instructions. + ## WS-ENG-002-01 - Preimplementation plan review: PASS after narrowing cancellation and defining dual-era authority evidence. diff --git a/.agent-loop/initiatives/WS-ENG-003-loop-memory-recovery/REVIEW_LOG.md b/.agent-loop/initiatives/WS-ENG-003-loop-memory-recovery/REVIEW_LOG.md index b7a28b501..274469b08 100644 --- a/.agent-loop/initiatives/WS-ENG-003-loop-memory-recovery/REVIEW_LOG.md +++ b/.agent-loop/initiatives/WS-ENG-003-loop-memory-recovery/REVIEW_LOG.md @@ -1,5 +1,8 @@ # REVIEW LOG: WS-ENG-003 +> Archive only. This initiative is historical and closed. Do not use this log +> as current engineering instructions. + ## WS-ENG-003-01 - Preimplementation plan review: PASS after moving recovery preparation before sequential reduction and binding the exact resolved target. diff --git a/.agent-loop/initiatives/WS-ENG-004-writer-directed-start/REVIEW_LOG.md b/.agent-loop/initiatives/WS-ENG-004-writer-directed-start/REVIEW_LOG.md index 07bfc37ba..60f2f5a21 100644 --- a/.agent-loop/initiatives/WS-ENG-004-writer-directed-start/REVIEW_LOG.md +++ b/.agent-loop/initiatives/WS-ENG-004-writer-directed-start/REVIEW_LOG.md @@ -1,5 +1,8 @@ # Review Log: Writer-Directed Workstream Start +> Archive only. This initiative is historical and closed. Do not use this log +> as current engineering instructions. + - 2026-07-21: Post-merge Loop Memory run `29835344158` failed closed because rebuild authentication invoked the new renderer before authenticating prior signed projections. The bounded 01R1 repair separates structural/signature diff --git a/.agent-loop/initiatives/WS-ENG-005-parallel-initiative-execution/REVIEW_LOG.md b/.agent-loop/initiatives/WS-ENG-005-parallel-initiative-execution/REVIEW_LOG.md index 00a161289..72271530f 100644 --- a/.agent-loop/initiatives/WS-ENG-005-parallel-initiative-execution/REVIEW_LOG.md +++ b/.agent-loop/initiatives/WS-ENG-005-parallel-initiative-execution/REVIEW_LOG.md @@ -1,5 +1,8 @@ # Review Log: Parallel Initiative Execution +> Archive only. This initiative is historical and closed. Current concurrency +> guidance lives in `CONTRIBUTING.md` and `../../CURRENT_STATE.md`. + - 2026-07-21: User approved replacing repository-global serialization with one active chunk per initiative and maximum safe cross-initiative concurrency. - 2026-07-21: L1 plan review passed after requiring forward-compatible rollback, diff --git a/.agent-loop/initiatives/WS-POL-003-unified-project-guide-compilation/CHUNK_MAP.md b/.agent-loop/initiatives/WS-POL-003-unified-project-guide-compilation/CHUNK_MAP.md index fec899641..a550525bc 100644 --- a/.agent-loop/initiatives/WS-POL-003-unified-project-guide-compilation/CHUNK_MAP.md +++ b/.agent-loop/initiatives/WS-POL-003-unified-project-guide-compilation/CHUNK_MAP.md @@ -1,14 +1,13 @@ # Chunk Map: WS-POL-003 - Unified Project Guide Compilation -All chunks are L1 and one PR each. POL-01 is merged, POL-02 is active after its -explicit human start, and later chunks remain proposed and inactive. Product -behavior is built hidden before AUTH activation; only a later live-cutover -chunk exposes it. No chunk starts automatically. +All chunks are L1 and one PR each. Product behavior is built hidden before AUTH +activation; only a later live-cutover chunk exposes it. Open pull requests show +transient work, and no chunk starts automatically. | Chunk | Purpose | Hard dependency | |---|---|---| -| `WS-POL-003-01` | Strict unified contracts and read-only pre/post capability projections. | Merged ART-04B1 and canonical CHECKER/POL post-submit registry | -| `WS-POL-003-02` | One `compile_project_guide` adapter method and fake-runtime proof. | 01 | +| `WS-POL-003-01` | Strict unified contracts and read-only pre/post capability projections. Merged PR #299. | Merged ART-04B1 and canonical CHECKER/POL post-submit registry | +| `WS-POL-003-02` | One `compile_project_guide` adapter method and fake-runtime proof. Merged PR #301. | 01 | | `WS-POL-003-03A` | Hidden immutable attempt/compilation schema, validator, repository, crash fence, and deny-by-default authorization seams. | 02 | | `WS-AUTH-001-12I` | Register and activate exact PM compilation request/recovery plus fixed-service compilation execute authority. | 03A exact resource/action manifest | | `WS-POL-003-03B` | Consume 12I to make immutable compilation parent/result persistence usable; no policy projection or setup-service cutover. | 03A + AUTH-12I | @@ -32,7 +31,7 @@ The ART admission sequence remains independent and may proceed concurrently: ```text merged ART-04B3 -> merged XINT-06A --> ART-04C1 -> ART-04C2 +-> merged ART-04C1 -> ART-04C2 -> XINT-05A -> ART-05A -> XINT-05B -> ART-05B ``` diff --git a/.agent-loop/initiatives/WS-POL-003-unified-project-guide-compilation/STATUS.md b/.agent-loop/initiatives/WS-POL-003-unified-project-guide-compilation/STATUS.md index a29ead458..1becba118 100644 --- a/.agent-loop/initiatives/WS-POL-003-unified-project-guide-compilation/STATUS.md +++ b/.agent-loop/initiatives/WS-POL-003-unified-project-guide-compilation/STATUS.md @@ -1,10 +1,10 @@ # Status: WS-POL-003 - Unified Project Guide Compilation -Status: `WS-POL-003-02` implementation and internal review complete; awaiting -external review and human merge. - -Baseline: `origin/main` `fb90237de499ec6d46ad7dfe1eee649f31857fd1` -after merged `WS-POL-003-01` PR #299. +Planning reconciliation merged through PR #298. `WS-POL-003-01` merged through +PR #299 and established the strict unified contract catalogue. +`WS-POL-003-02` merged through PR #301 and added the single unified guide agent +adapter with fake-runtime proof. Open pull requests, not this static file, +determine transient implementation ownership. ## Current delivery truth @@ -15,8 +15,8 @@ after merged `WS-POL-003-01` PR #299. - AUTH-12E and AUTH-12F3 are merged transitional separate-call implementations. Their action-specific projection custody is reusable; their independent inference paths must not survive POL-04B. -- ART-04B1, 04B2, 04B3, and XINT-06A are merged. ART-04C1 is ready to proceed - independently through the admission sequence. +- ART-04B1, 04B2, 04B3, XINT-06A, and ART-04C1 are merged. ART admission may + continue independently through its dependency sequence. - Remaining AUTH-12F4, 12G, 12B2, and 12H contracts require reconciliation as narrow activation gates around hidden POL behavior. They are not authority for another inference pipeline. @@ -27,7 +27,8 @@ after merged `WS-POL-003-01` PR #299. |---|---|---| | ART-04B1 complete pre-submit catalogue/effective plan | POL-01 | Merged PR #276 | | Canonical CHECKER/POL post-submit registry | POL-01 | Present; remaining POL-002 work must be reframed as executor ownership, not inference | -| POL-01/02 strict manifest and adapter | POL-03A | POL-01 merged; POL-02 awaiting external review and human merge | +| POL-01 strict manifest | POL-02 | Merged PR #299 | +| POL-02 adapter | POL-03A | Merged PR #301 | | Hidden POL-03A compilation manifest | AUTH-12I compilation request/execute activation | Proposed | | AUTH-12I | POL-03B authorized persistence | Not yet implemented | | Hidden POL-04A unified setup-service manifest | AUTH-12B2 setup-ledger activation | Not yet implemented | @@ -38,11 +39,12 @@ after merged `WS-POL-003-01` PR #299. ## Chunk state -POL-01 is merged and POL-02 is active. The newly split +POL-01 and POL-02 are merged. The newly split 03A-06B and corresponding AUTH gates are reviewed planning skeletons only: before any is started, its contract must be expanded on then-current main with explicit allowed/not-allowed paths, runnable verification commands, and named reviewer tracks. They cannot authorize implementation in their current form. -All later WS-POL-003 chunks and corresponding AUTH gates remain proposed and -inactive. No later chunk starts automatically. +The next dependency-ordered boundary is `WS-POL-003-03A`. It and later chunks +and corresponding AUTH gates remain planned and inactive until +their exact dependencies and executable contracts are current. diff --git a/.agent-loop/initiatives/WS-QUAL-002-behavior-ownership-catalogue/CHUNK_MAP.md b/.agent-loop/initiatives/WS-QUAL-002-behavior-ownership-catalogue/CHUNK_MAP.md index 5e7c784b9..bdd23ac30 100644 --- a/.agent-loop/initiatives/WS-QUAL-002-behavior-ownership-catalogue/CHUNK_MAP.md +++ b/.agent-loop/initiatives/WS-QUAL-002-behavior-ownership-catalogue/CHUNK_MAP.md @@ -2,7 +2,7 @@ | Chunk | Purpose | Dependency | Risk | State | |---|---|---|---|---| -| `WS-QUAL-002-01` | Catalogue schema, inventory, generator, validation foundation | none | L1 | proposed | +| `WS-QUAL-002-01` | Catalogue schema, inventory, generator, validation foundation | none | L1 | merged PR #297 | | `WS-QUAL-002-02` | Coverage-context candidate evidence and runtime calibration | 01 | L1 | pending | | `WS-QUAL-002-03A` | AUTH, actors, API controls, audit ownership | 01, 02 | L1 | pending | | `WS-QUAL-002-03B` | Artifacts, storage, extraction, external adapters ownership | 01, 02 | L1 | pending | diff --git a/.agent-loop/initiatives/WS-QUAL-002-behavior-ownership-catalogue/STATUS.md b/.agent-loop/initiatives/WS-QUAL-002-behavior-ownership-catalogue/STATUS.md index 0e16b7f11..3dd025804 100644 --- a/.agent-loop/initiatives/WS-QUAL-002-behavior-ownership-catalogue/STATUS.md +++ b/.agent-loop/initiatives/WS-QUAL-002-behavior-ownership-catalogue/STATUS.md @@ -4,11 +4,15 @@ Planning is complete and internally reviewed. PR #289 retired the 05M hosted mutation workflow; Backend lanes and coverage remain authoritative. PR #290 merged the catalogue plan. -`WS-QUAL-002-01` is in implementation. The current branch adds the schema, -canonical exact target partition, deterministic inventory/candidate generator, -fail-closed validator, examples, focused tests, and contributor documentation. -It does not reactivate mutation or change any workflow, product behavior, -coverage floor, lane, skip, or deselection. +`WS-QUAL-002-01` merged through PR #297. It adds the schema, canonical exact +target partition, deterministic inventory/candidate generator, fail-closed +validator, examples, focused tests, and contributor documentation. It does not +reactivate mutation or change any workflow, product behavior, coverage floor, +lane, skip, or deselection. + +The next dependency-ordered boundary is `WS-QUAL-002-02` context evidence. +Open pull requests, not this static file, determine whether that or any other +chunk is currently under review. Current focused evidence: diff --git a/.agent-loop/initiatives/WS-REV-001-review-revision-lifecycle/CHUNK_MAP.md b/.agent-loop/initiatives/WS-REV-001-review-revision-lifecycle/CHUNK_MAP.md index b3d50fd1b..6f74da561 100644 --- a/.agent-loop/initiatives/WS-REV-001-review-revision-lifecycle/CHUNK_MAP.md +++ b/.agent-loop/initiatives/WS-REV-001-review-revision-lifecycle/CHUNK_MAP.md @@ -11,9 +11,9 @@ PLAN4 is the current-main end-to-end refresh after merged AUTH 02D. | Chunk | Purpose | Gate | Status | |---|---|---|---| -| `WS-REV-001-PLAN4` | Current-main full lifecycle replan | AUTH 02D merged PR #257 | Proposed planning PR | +| `WS-REV-001-PLAN4` | Current-main full lifecycle replan | AUTH 02D merged PR #257 | Merged PR #258 | | `WS-REV-001-03A1` | Queue and admission-idempotency persistence | PLAN4 approved | Merged PR #262 | -| `WS-REV-001-03A2` | REV-owned lease and preference persistence | Merged 03A1 + CON-03B PR #274 policy-version FK target | Active exact contract | +| `WS-REV-001-03A2` | REV-owned lease and preference persistence | Merged 03A1 + CON-03B PR #274 policy-version FK target | Merged PR #280 | | `WS-REV-001-03B` | Normalized packet-manifest persistence | 03A2 + ART-owned contract-only packet membership port published before ART-07A runtime | Skeleton | | `WS-REV-001-04A` | Immutable Review/finding/resolution/decision-request persistence | 03B | Skeleton | | `WS-REV-001-04B` | FinalAcceptance and shared audit/outbox linkage persistence | 04A + CON-02A outbox persistence + CON-02C audit participant | Skeleton; enables CON-03C schema work | diff --git a/.agent-loop/initiatives/WS-REV-001-review-revision-lifecycle/REVIEW_LOG.md b/.agent-loop/initiatives/WS-REV-001-review-revision-lifecycle/REVIEW_LOG.md index 5ff5873c4..5dbb419d0 100644 --- a/.agent-loop/initiatives/WS-REV-001-review-revision-lifecycle/REVIEW_LOG.md +++ b/.agent-loop/initiatives/WS-REV-001-review-revision-lifecycle/REVIEW_LOG.md @@ -1,5 +1,9 @@ # Internal Plan Review Log: WS-REV-001 +> Archive only. Use `../../CURRENT_STATE.md`, current `main`, and open pull +> requests for current state. Entries below apply only to exact reviewed +> changes. + ## WS-REV-001-PLAN4 Current-Main End-To-End Refresh - 2026-08-03 Architecture passed the full revised sequence and confirmed that 03A1 is a diff --git a/.agent-loop/initiatives/WS-REV-001-review-revision-lifecycle/STATUS.md b/.agent-loop/initiatives/WS-REV-001-review-revision-lifecycle/STATUS.md index 859676044..6738d67e8 100644 --- a/.agent-loop/initiatives/WS-REV-001-review-revision-lifecycle/STATUS.md +++ b/.agent-loop/initiatives/WS-REV-001-review-revision-lifecycle/STATUS.md @@ -2,13 +2,12 @@ ## Current status -`WS-REV-001-03A2` is the active bounded child from current main `e2057d0f`. -Merged CON-03B PR #274 supplies the canonical +`WS-REV-001-03A2` merged through PR #280. Merged CON-03B PR #274 supplies the canonical `contribution_policy_versions(id, project_id)` foreign-key target. 03A2 owns only ReviewLease and preference persistence integrity; it adds no claim, transition, policy-selection, route, or external-owner behavior. -WS-CON-001-PLAN5 is the active cross-specification input for revision behavior: +WS-CON-001-PLAN5 is the merged cross-specification input for revision behavior: a human `needs_revision` atomically keeps/rebases/blocks the complete applicable next-attempt guide and policy context, including the submitter ContributionPolicyVersion. Existing Submissions, Reviews, leases, @@ -55,7 +54,7 @@ REV does not own Project/Task/Submission/Checker/AUTH/ART/CON internals. ## Next step -Implement and review only `WS-REV-001-03A2` from its refreshed exact contract. -Run focused PostgreSQL and coverage proof locally; GitHub Actions provides the -full-suite and repository-coverage proof. Stop after its PR and do not begin -packet persistence or claim behavior automatically. +The next dependency-ordered boundary is `WS-REV-001-03B`, normalized packet +manifest persistence, after the required ART-owned packet-membership contract +is published. Its skeleton must be expanded and reviewed against current +`main` before implementation. Open pull requests determine transient work. diff --git a/.agent-loop/initiatives/WS-XINT-001-lifecycle-boundary-reconciliation/CHUNK_MAP.md b/.agent-loop/initiatives/WS-XINT-001-lifecycle-boundary-reconciliation/CHUNK_MAP.md index 7cbf5fe12..08ec6e58b 100644 --- a/.agent-loop/initiatives/WS-XINT-001-lifecycle-boundary-reconciliation/CHUNK_MAP.md +++ b/.agent-loop/initiatives/WS-XINT-001-lifecycle-boundary-reconciliation/CHUNK_MAP.md @@ -1,12 +1,11 @@ # Chunk Map: WS-XINT-001 Lifecycle Boundary Reconciliation This initiative contains one planning PR. Runtime work remains in the four -owning initiatives and requires separate chunk contracts, review, and explicit -human starts. +owning initiatives and requires separate bounded changes and review. | Chunk | Purpose | Risk | Status | |---|---|---:|---| -| `WS-XINT-001-PLAN` | Reconcile AUTH, ART, REV, and CON ownership, activation, transactions, and handoffs | L1 | Active after explicit user start | +| `WS-XINT-001-PLAN` | Reconcile AUTH, ART, REV, and CON ownership, activation, transactions, and handoffs | L1 | Merged PR #139; initiative closed | ## Downstream owner handoffs diff --git a/.agent-loop/initiatives/WS-XINT-001-lifecycle-boundary-reconciliation/STATUS.md b/.agent-loop/initiatives/WS-XINT-001-lifecycle-boundary-reconciliation/STATUS.md index 03239bb3c..8cdc8b875 100644 --- a/.agent-loop/initiatives/WS-XINT-001-lifecycle-boundary-reconciliation/STATUS.md +++ b/.agent-loop/initiatives/WS-XINT-001-lifecycle-boundary-reconciliation/STATUS.md @@ -2,19 +2,15 @@ ## Current state -The planning reconciliation and bounded final contract cleanup are implemented -and internally reviewed at exact code SHA -`423f99d13472850da7f1b2686aa62fc7c4145683`. All nine required reviewer tracks -passed with zero findings, all sessions are closed, and no runtime code changed. +The planning reconciliation and bounded final contract cleanup merged through +PR #139. No runtime code changed. AUTH, ART, REV, and CON runtime branches remain independently owned; this initiative neither starts nor edits them. ## Current gate -Push the exact-SHA evidence and CI repair to PR #139, rerun GitHub checks, and -wait for explicit human review. CodeRabbit skipped this one-time 127-file -planning reconciliation because it exceeds the service's 100-file limit. Do -not merge this PR without the user's approval. +None. Owner initiatives implement the reconciled boundaries through their own +bounded changes. ## Stop condition diff --git a/.agent-loop/initiatives/WS-XINT-002-art-auth-end-to-end/REVIEW_LOG.md b/.agent-loop/initiatives/WS-XINT-002-art-auth-end-to-end/REVIEW_LOG.md index f2083cf9d..ae866be5c 100644 --- a/.agent-loop/initiatives/WS-XINT-002-art-auth-end-to-end/REVIEW_LOG.md +++ b/.agent-loop/initiatives/WS-XINT-002-art-auth-end-to-end/REVIEW_LOG.md @@ -1,5 +1,9 @@ # Review Log: WS-XINT-002 +> Archive only. Use `../../CURRENT_STATE.md`, current `main`, and open pull +> requests for current state. Entries below apply only to exact reviewed +> changes. + ## Planning review Architecture, security/auth, QA/test, product/ops, senior engineering, and CI diff --git a/.agent-loop/initiatives/WS-XINT-003-rev-auth-end-to-end/REVIEW_LOG.md b/.agent-loop/initiatives/WS-XINT-003-rev-auth-end-to-end/REVIEW_LOG.md index 26fff55dd..d58a5946a 100644 --- a/.agent-loop/initiatives/WS-XINT-003-rev-auth-end-to-end/REVIEW_LOG.md +++ b/.agent-loop/initiatives/WS-XINT-003-rev-auth-end-to-end/REVIEW_LOG.md @@ -1,5 +1,9 @@ # Review Log: WS-XINT-003 REV-AUTH End-to-End Contract +> Archive only. Use `../../CURRENT_STATE.md`, current `main`, and open pull +> requests for current state. Entries below apply only to exact reviewed +> changes. + ## AUTH-readiness sequencing amendment — 2026-08-03 Post-02B review found a circular delivery dependency absent from the corrected diff --git a/.agent-loop/initiatives/WS-XINT-003-rev-auth-end-to-end/STATUS.md b/.agent-loop/initiatives/WS-XINT-003-rev-auth-end-to-end/STATUS.md index 4d177e5fe..0235ece9b 100644 --- a/.agent-loop/initiatives/WS-XINT-003-rev-auth-end-to-end/STATUS.md +++ b/.agent-loop/initiatives/WS-XINT-003-rev-auth-end-to-end/STATUS.md @@ -2,9 +2,9 @@ ## Current status -WS-XINT-003-01, WS-XINT-003-02A, WS-XINT-003-02B, and WS-XINT-003-02C are -merged. PR #255 merged 02C as `745d9c3f` on 2026-08-03 after Backend, Agent -Gates, and CodeRabbit passed on the final PR head. Exactly +WS-XINT-003-01, WS-XINT-003-02A, WS-XINT-003-02B, WS-XINT-003-02C, and +WS-XINT-003-02D are merged. PR #257 merged 02D and published the complete +fail-closed PREP and read contract handoff for REV. Exactly `project.review_policy.update` and `project.revision_policy.update` are active; review/revision lifecycle actions remain planned or unavailable. @@ -51,10 +51,8 @@ REV-owned semantics with AUTH-owned mutation authorization. ## Next step -WS-XINT-003-02D implements the complete typed, fail-closed PREP/read contract -handoff on top of merged 02C. Its merge permits REV to begin hidden lifecycle -implementation against that stable surface. AUTH then returns to its independent -agenda; later XINT activation waves reconnect only to exact merged REV behavior. -Do not infer review lifecycle -activation from readiness: later action activation still requires exact merged -REV behavior and integrated proof. +REV may implement its hidden lifecycle against the merged 02D surface. Later +XINT activation waves reconnect only to exact merged REV behavior. Do not infer +review lifecycle activation from readiness: later action activation still +requires exact merged REV behavior and integrated proof. Open pull requests +determine transient XINT work. diff --git a/AGENTS.md b/AGENTS.md index 7dd85fc90..45dd10cc6 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -23,6 +23,10 @@ definition or ownership boundary of Workstream. - Codex-discoverable repository skills live under `.agents/skills/`. - Codex custom reviewer agents live under `.codex/agents/`. - Durable engineering memory, initiative plans, chunk contracts, policies, evidence, and review logs live under `.agent-loop/`. +- `.agent-loop/CURRENT_STATE.md` is the current initiative entry point. GitHub + open pull requests are the transient-work view. Review logs and review + bundles are historical exact-change evidence, never an active-work queue or + authorization source. - `CONTRIBUTING.md` is the canonical human and agent entry path. GitHub permissions and branch protection govern contribution authority. Planning artifacts explain work; they do not authorize or block it. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 5578aca4f..45e40b570 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -28,7 +28,10 @@ Before implementation, update from current `main` and read: 1. [README.md](README.md) for the product boundary and current v0.1 summary. 2. [Current v0.1 Status](docs/roadmap_status.md) for implemented, in-progress, and remaining capabilities. -3. [Architecture Lockdown](docs/architecture_lockdown.md), accepted ADRs, and +3. [Current Engineering State](.agent-loop/CURRENT_STATE.md) for durable + initiative dispositions, remaining boundaries, and the live pull-request + view of transient work. +4. [Architecture Lockdown](docs/architecture_lockdown.md), accepted ADRs, and the canonical specification for the subsystem being changed. Code, migrations, tests, accepted ADRs, and canonical repository specifications @@ -46,6 +49,13 @@ Contributors with GitHub write access may create a branch, implement a bounded change, and open a pull request. Contributors without write access may use a fork and open a normal pull request. +Before claiming a remaining boundary, inspect +[open pull requests](https://github.com/Flow-Research/workstream/pulls) and +coordinate any overlapping path or behavior ownership. Static status files do +not attempt to mirror transient branches because that information becomes +stale at merge. Review logs are evidence for earlier exact changes, never an +active queue or approval gate. + ## Before Opening A Pull Request - Explain the goal, scope, non-goals, and important design decisions. diff --git a/docs/roadmap_status.md b/docs/roadmap_status.md index 5d5a8ed8a..ce031b6e3 100644 --- a/docs/roadmap_status.md +++ b/docs/roadmap_status.md @@ -94,11 +94,12 @@ remain outside v0.1. The following areas have merged planning, contracts, or partial foundations, but are not all complete as one production path: -- Hidden contributor-ZIP default pre-submit execution: fixed-service authority - precedes byte access, one manifest-verified callback-scoped scratch tree runs - only platform/default catalogue phases, and cleanup precedes bounded - non-durable results. Project-policy execution, durable evidence, contributor - preparation, admission, and Submission remain unavailable. +- Hidden contributor-ZIP pre-submit execution: fixed-service authority precedes + byte access; one manifest-verified callback-scoped scratch tree runs the + platform/default and project-policy phases; cleanup precedes one immutable + combined evidence set. The evidence-linked durable put intent is merged. + Ready-admission publication, contributor preparation, and Submission + consumption are not yet part of the complete production path. - integration of the merged review/revision policy and authorization readiness contracts into hidden REV lifecycle behavior;