Task flow engine implementation

workplans/CUST-WP-0037-task-flow-reference-docs-cleanup.md

@@ -0,0 +1,102 @@
+---
+id: CUST-WP-0037
+type: workplan
+title: "Task-Flow Reference Documentation Cleanup"
+domain: custodian
+repo: the-custodian
+status: todo
+owner: custodian
+topic_slug: custodian
+created: "2026-05-01"
+updated: "2026-05-01"
+state_hub_workstream_id: "599d3c40-9f99-466f-b30d-f9d64317345c"
+---
+
+# CUST-WP-0037 — Task-Flow Reference Documentation Cleanup
+
+## Goal
+
+Update Custodian reference materials after the task-flow-engine terminology has
+landed in State Hub. Retire wording that assumes fixed lifecycle enums and
+replace it with the new model of information objects, workstations, and
+requisite assertions.
+
+This work is intentionally separate from CUST-WP-0035 so the engine can
+stabilize before broad documentation churn.
+
+## T01: Dashboard lifecycle documentation
+
+```task
+id: CUST-WP-0037-T01
+status: todo
+priority: medium
+state_hub_task_id: "919d21cb-1cdc-448e-a722-38f1b6374ffb"
+```
+
+Review `state-hub/dashboard/src/docs/` and update any page that describes
+workstream or task lifecycle, status values, contribution flows, or capability
+request transitions.
+
+Acceptance: dashboard docs describe workstations and derived blocked state
+without implying that lifecycle movement is controlled by fixed enum tables.
+
+## T02: Repo DOI policy wording
+
+```task
+id: CUST-WP-0037-T02
+status: todo
+priority: medium
+state_hub_task_id: "d6485f6c-815f-4f50-a35e-3fd42046691f"
+```
+
+Review `state-hub/policies/repo-doi.md` for task/workstream status checks that
+assume specific enum values. Update wording to distinguish stored workstation
+labels from engine-derived health and blocking assertions.
+
+Acceptance: policy language remains operationally precise while matching the
+task-flow-engine model.
+
+## T03: Agent guidance refresh
+
+```task
+id: CUST-WP-0037-T03
+status: todo
+priority: medium
+state_hub_task_id: "79251442-12a0-4a00-9e3a-fc484933259d"
+```
+
+Review `agents/agent-scope-analyst.md` and other active kaizen/custodian agent
+instructions for status-transition assumptions.
+
+Acceptance: agents prefer `get_flow_state()` and `advance_workstation()` where
+flow-aware lifecycle movement is relevant.
+
+## T04: Session protocol references
+
+```task
+id: CUST-WP-0037-T04
+status: todo
+priority: medium
+state_hub_task_id: "e2a9d096-b66a-43f2-af87-ec802ba9e795"
+```
+
+Review project/global `CLAUDE.md` references that instruct agents to call
+`update_workstream_status()` or `update_task_status()` for lifecycle movement.
+
+Acceptance: references point to the flow-aware pattern where appropriate while
+keeping direct status tools documented for bootstrap or compatibility cases.
+
+## T05: Memory/data-model references
+
+```task
+id: CUST-WP-0037-T05
+status: todo
+priority: low
+state_hub_task_id: "2320cd6b-8dc6-4160-9623-4e6425b637e5"
+```
+
+Review `memory/MEMORY.md` and nearby state-hub data-model notes for stale enum
+language.
+
+Acceptance: memory/reference notes explain the status-to-workstation shift and
+link back to CUST-WP-0035 or the task-flow-engine spec.

workplans/archived/260501-CUST-WP-0028-e2e-sandbox-framework.md

@@ -4,7 +4,7 @@ type: workplan
 title: "Cross-Repo E2E Sandbox Framework"
 domain: railiance
 repo: the-custodian
-status: active
+status: completed
 owner: custodian
 topic_slug: railiance
 created: "2026-03-27"

workplans/archived/260501-CUST-WP-0035-task-flow-engine.md

@@ -4,7 +4,7 @@ type: workplan
 title: "Task-Flow-Engine — Declarative Workstation and Requisite Model"
 domain: custodian
 repo: the-custodian
-status: active
+status: completed
 owner: custodian
 topic_slug: custodian
 created: "2026-04-30"
@@ -184,7 +184,7 @@ status labels.
 
 ```task
 id: CUST-WP-0035-T04
-status: todo
+status: done
 priority: high
 state_hub_task_id: "db320d4e-cbcd-4787-a42c-e7cb109737a3"
 ```
@@ -224,7 +224,7 @@ with all tasks done automatically surfaces as ready to move to `completed`.
 
 ```task
 id: CUST-WP-0035-T05
-status: todo
+status: done
 priority: medium
 state_hub_task_id: "8ea7e49f-f1ad-4290-84f4-c1ee75c79786"
 ```
@@ -253,7 +253,7 @@ assertions are unmet and accepts correctly when they are met.
 
 ```task
 id: CUST-WP-0035-T06
-status: todo
+status: done
 priority: low
 state_hub_task_id: "b9242cb4-5fb4-4e9e-9f16-9a1866cedc6a"
 ```