Task flow engine implementation

tests/test_routers_core.py

@@ -274,3 +274,53 @@ class TestStateSummary:
         r = await client.get("/state/summary")
         body = r.json()
         assert len(body["blocked_tasks"]) >= 1
+
+    async def test_summary_derives_blocked_workstream_from_flow_engine(self, client):
+        await _create_domain(client)
+        topic = await _create_topic(client)
+        blocked_ws = await _create_workstream(client, topic["id"], slug="blocked-ws")
+        dependency_ws = await _create_workstream(client, topic["id"], slug="dependency-ws")
+
+        r = await client.post(
+            f"/workstreams/{blocked_ws['id']}/dependencies/",
+            json={
+                "to_workstream_id": dependency_ws["id"],
+                "description": "Blocked until dependency completes",
+            },
+        )
+        assert r.status_code == 201
+
+        r = await client.get("/state/summary")
+        assert r.status_code == 200
+        body = r.json()
+        summaries = {item["id"]: item for item in body["open_workstreams"]}
+
+        assert summaries[blocked_ws["id"]]["status"] == "blocked"
+        assert summaries[blocked_ws["id"]]["blocked_reasons"][0]["id"] == "dependencies.all_complete"
+        assert body["totals"]["workstreams"]["blocked"] == 1
+
+
+class TestFlowEndpoints:
+    async def test_list_flow_definitions(self, client):
+        r = await client.get("/flows/definitions")
+        assert r.status_code == 200
+        entity_types = {item["entity_type"] for item in r.json()}
+        assert {"workstream", "task", "contribution", "capability_request"} <= entity_types
+
+    async def test_get_flow_state_and_advance_workstream(self, client):
+        await _create_domain(client)
+        topic = await _create_topic(client)
+        ws = await _create_workstream(client, topic["id"])
+        task = await _create_task(client, ws["id"])
+        await client.patch(f"/tasks/{task['id']}", json={"status": "done"})
+
+        r = await client.get(f"/flows/workstream/{ws['id']}")
+        assert r.status_code == 200
+        assert "completed" in r.json()["reachable"]
+
+        r = await client.post(f"/flows/workstream/{ws['id']}/advance/completed")
+        assert r.status_code == 200
+        assert r.json()["current_workstation"] == "completed"
+
+        r = await client.get(f"/workstreams/{ws['id']}")
+        assert r.json()["status"] == "completed"