Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
65 changes: 65 additions & 0 deletions .agent-loop/CURRENT_STATE.md
Original file line number Diff line number Diff line change
@@ -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.
6 changes: 6 additions & 0 deletions .agent-loop/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
9 changes: 5 additions & 4 deletions .agent-loop/REVIEW_LOG.md
Original file line number Diff line number Diff line change
@@ -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

Expand Down
5 changes: 5 additions & 0 deletions .agent-loop/initiatives/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
Expand Down
Original file line number Diff line number Diff line change
@@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand All @@ -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

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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` |
Expand Down
Loading
Loading