docs(plans): Flow Debugger implementation plan — 24 tasks, TDD, additive contracts first, rig step H last

Claude-Session: https://claude.ai/code/session_01NcMG6xXdsJbmD2wYAgkK29
2026-09-05 23:22:55 -04:00
parent 7fa916e2c7
commit 2e3eb94d38
2 changed files with 1023 additions and 0 deletions
@@ -0,0 +1,211 @@
+{
+  "planPath": "docs/plans/2026-09-05-flow-debugger.md",
+  "tasks": [
+    {
+      "id": 0,
+      "subject": "Task 0: Amend the design doc with the four planning corrections",
+      "status": "pending"
+    },
+    {
+      "id": 1,
+      "subject": "Task 1: Audit enums \u2014 ScriptTrace channel and four kinds",
+      "status": "pending",
+      "blockedBy": [
+        0
+      ]
+    },
+    {
+      "id": 2,
+      "subject": "Task 2: Additive Trace / trace-payload fields on the message records",
+      "status": "pending",
+      "blockedBy": [
+        0
+      ]
+    },
+    {
+      "id": 3,
+      "subject": "Task 3: ApiMethod.TraceAllCalls \u2014 entity, EF migration, management command, CLI flag",
+      "status": "pending",
+      "blockedBy": [
+        0
+      ]
+    },
+    {
+      "id": 4,
+      "subject": "Task 4: FlowStep projection + FlowGraph model + FlowGraphBuilder (pure)",
+      "status": "pending",
+      "blockedBy": [
+        1,
+        2
+      ]
+    },
+    {
+      "id": 5,
+      "subject": "Task 5: FlowTraceCollector (site, per run)",
+      "status": "pending",
+      "blockedBy": [
+        0
+      ]
+    },
+    {
+      "id": 6,
+      "subject": "Task 6: ScriptRuntimeContext \u2014 traced flag, trace emission for writes and waits, flag inheritance",
+      "status": "pending",
+      "blockedBy": [
+        4,
+        5
+      ]
+    },
+    {
+      "id": 7,
+      "subject": "Task 7: ScriptRunLauncher + ScriptActor \u2014 ScriptRun rows, ExecutionId + events, value-change inheritance",
+      "status": "pending",
+      "blockedBy": [
+        6
+      ]
+    },
+    {
+      "id": 8,
+      "subject": "Task 8: InstanceActor \u2014 trace arm for data-sourced writes; Trace on published changes",
+      "status": "pending",
+      "blockedBy": [
+        2
+      ]
+    },
+    {
+      "id": 9,
+      "subject": "Task 9: DeploymentManagerActor routing \u2014 pass Trace, return child id + events",
+      "status": "pending",
+      "blockedBy": [
+        7,
+        8
+      ]
+    },
+    {
+      "id": 10,
+      "subject": "Task 10: Wire \u2014 site_command.proto trace fields, mapper, golden samples",
+      "status": "pending",
+      "blockedBy": [
+        2,
+        11
+      ]
+    },
+    {
+      "id": 11,
+      "subject": "Task 11: Wire \u2014 sitestream.proto source_execution_id/trace + PullTraceEvents RPC; site SQLite read by execution ids",
+      "status": "pending",
+      "blockedBy": [
+        2
+      ]
+    },
+    {
+      "id": 12,
+      "subject": "Task 12: RouteHelper \u2014 always-on RouteCall audit row, WithTrace, inline trace sink",
+      "status": "pending",
+      "blockedBy": [
+        1,
+        2,
+        4
+      ]
+    },
+    {
+      "id": 13,
+      "subject": "Task 13: InboundScriptExecutor.ExecuteAsync(trace) + endpoint honours TraceAllCalls",
+      "status": "pending",
+      "blockedBy": [
+        12
+      ]
+    },
+    {
+      "id": 14,
+      "subject": "Task 14: IAuditLogRepository.GetTraceEventsAsync(rootExecutionId)",
+      "status": "pending",
+      "blockedBy": [
+        1
+      ]
+    },
+    {
+      "id": 15,
+      "subject": "Task 15: Management commands \u2014 FlowDebugRunMethod / RunValueChange / Replay",
+      "status": "pending",
+      "blockedBy": [
+        9,
+        10,
+        11,
+        12,
+        13,
+        14
+      ]
+    },
+    {
+      "id": 16,
+      "subject": "Task 16: CLI flow-debug command group",
+      "status": "pending",
+      "blockedBy": [
+        15
+      ]
+    },
+    {
+      "id": 17,
+      "subject": "Task 17: FlowShapePredictor (Script Analysis)",
+      "status": "pending",
+      "blockedBy": [
+        4
+      ]
+    },
+    {
+      "id": 18,
+      "subject": "Task 18: Central UI service \u2014 IFlowDebugService / FlowDebugService",
+      "status": "pending",
+      "blockedBy": [
+        15,
+        17
+      ]
+    },
+    {
+      "id": 19,
+      "subject": "Task 19: FlowGraphView \u2014 custom SVG swimlane renderer",
+      "status": "pending",
+      "blockedBy": [
+        4
+      ]
+    },
+    {
+      "id": 20,
+      "subject": "Task 20: Flow Debugger page \u2014 toolbar, inputs, predicted graph, run, detail panel",
+      "status": "pending",
+      "blockedBy": [
+        18,
+        19
+      ]
+    },
+    {
+      "id": 21,
+      "subject": "Task 21: Drill-ins and the TraceAllCalls checkbox",
+      "status": "pending",
+      "blockedBy": [
+        3,
+        20
+      ]
+    },
+    {
+      "id": 22,
+      "subject": "Task 22: Rig \u2014 retention override, redeploy, verification step H",
+      "status": "pending",
+      "blockedBy": [
+        16,
+        20,
+        21
+      ]
+    },
+    {
+      "id": 23,
+      "subject": "Task 23: Documentation sweep",
+      "status": "pending",
+      "blockedBy": [
+        22
+      ]
+    }
+  ],
+  "lastUpdated": "2026-09-06T03:22:55.422160+00:00"
+}