diff --git a/specs/epics/FIX-2056/DECISIONS.md b/specs/epics/FIX-2056/DECISIONS.md index e2c036b102..2275b19982 100644 --- a/specs/epics/FIX-2056/DECISIONS.md +++ b/specs/epics/FIX-2056/DECISIONS.md @@ -60,7 +60,7 @@ It comes down to the cycle: a child blocked by FIX-2058 would keep this epic fro |---|---| | **Instead of** | Extending the durable keys' accepted cost (no second spelling read) to the task rows this epic retires | | **Because** | BP-030. The rows are a user's open work in a persistent store; dropping them loses work a person filed. The durable keys are replay detail the owner accepted losing | -| **Locks in** | One map in the collection layer, built and tested by FIX-2080 for all four shapes: a post to a routed task, blocked to held, a parked split to running, a reopened row to pending. FIX-2077, FIX-2083 and FIX-2086 each turn their shape's entry on in the PR that stops writing it, and build no read of their own. The map is removed no earlier than FIX-2071 | +| **Locks in** | One map in the collection layer, built and tested by FIX-2080 for all six shapes: a post to a routed task, blocked to held, the recorded-not-started mark to held, a parked split to running, a reopened row to pending, a row parked for a turn to pending. FIX-2077, FIX-2083 and FIX-2086 each turn their shape's entry on in the PR that stops writing it, and build no read of their own. The map is removed no earlier than FIX-2071 | **What would change my mind:** no persistent store outside tests and local dev databases holds these rows. Then the map is dead code, and the durable keys' rule covers rows too. @@ -89,11 +89,11 @@ FIX-2081's own scope. | Seam | Owner, then who else touches it | |---|---| -| The task tool list (`orchestration/src/skills/task-tools-capability.ts`) | FIX-2081 owns the list and field rules. FIX-2080's settings, FIX-2082's wait and FIX-2086's `message` land after it | +| The task tool list (`orchestration/src/skills/task-tools-capability.ts`) | FIX-2080 lands first: it removes `blockTask`, adds `status` (held or pending) to `updateTask`'s patch, turns the busy-session refusal into a wait and adds `held` to the status filter. Then FIX-2081 owns the list and field rules, and FIX-2082's wait and FIX-2086's `message` land after it | | Who a filing can reach (`workforce/src/conversation-board/board.ts`, `reach()`) | FIX-2081 replaces a task session's roster arm with the self-step grant, after FIX-2076's plan rows land, so a worker files its own steps with or without delegates | | The claim gate (`task-board/task-entry.ts`, `blocks/record-result.ts`) and the request's end | FIX-2077 owns the predicate and where it runs: after the engine's last drain on every terminal path, which follows `onFinished` (`engine/src/execution/runAction.ts:2447`→`:2630`→`:2641`, `:2773`→`:2918`→`:2936`), through an engine seam for framework packages, not an author hook. FIX-2082's waits wake on its ending; FIX-2078 calls it when a filed task ends | | The wait (`tasks/helpers/wait-for-response.ts`) and its limits | FIX-2082 owns it and its limits: 5 waits deep; a tree 5 deep, 100 under its top task. FIX-2076 only sets which boards wait. A board's dispatch rides the row's wait. A bare `dispatcher({ wait: true })` has no row, and the engine awaits acceptance only (`core/src/blocks/dispatcher.ts:169-171`, `engine/src/context/dispatch-operation.ts:273-280`): FIX-2082 adds an engine wait that returns the result | -| The sweeper (`engine/src/durability/durability-sweeper.ts:40-50`), re-armed only from wait gates | FIX-2078 adds a due-time source the re-arm reads and a step that pays board debts | +| The sweeper (`engine/src/durability/durability-sweeper.ts:40-50`), re-armed only from wait gates | FIX-2078 adds a due-time source the re-arm reads and a step that pays board debts, FIX-2080's cascade debt among them | | `afterRun`, the notice and `runTaskBoard` (`workforce/src/conversation-board/board.ts`) | FIX-2078 moves the notice, replaces resends with due times, removes the `reportOwed` marker and keeps Shift Manager's error route on the ending path ([f](#f)); FIX-2077 removes the split settle; FIX-2084 renames the entry `dispatch` | | The collection read (`tasks/collection/`) | FIX-2080 owns the map; the retiring children turn entries on | | Queued messages | FIX-2077 runs them through today's message entry; FIX-2070 makes it `receive` | diff --git a/specs/epics/FIX-2056/SPEC.md b/specs/epics/FIX-2056/SPEC.md index fcd308ac1b..9648ad2aca 100644 --- a/specs/epics/FIX-2056/SPEC.md +++ b/specs/epics/FIX-2056/SPEC.md @@ -70,7 +70,7 @@ The reviewed snapshot; live state, and each issue's gap rows, are in Linear. |---|---|---| | [FIX-2076](https://linear.app/fixpoint-labs/issue/FIX-2076) · board modes | Plan and delegation boards; wrong boards refused | — | | [FIX-2077](https://linear.app/fixpoint-labs/issue/FIX-2077) · when a task is done | Rule 6 at the claim gate, after background work; a wait leaves a task running | FIX-2078, FIX-2080, FIX-2081 | -| [FIX-2078](https://linear.app/fixpoint-labs/issue/FIX-2078) · endings and debts | Every ending to its filer once; due times and the sweeper | — | +| [FIX-2078](https://linear.app/fixpoint-labs/issue/FIX-2078) · endings and debts | Every ending to its filer once; due times and the sweeper | FIX-2080 | | [FIX-2080](https://linear.app/fixpoint-labs/issue/FIX-2080) · filing settings | Start, session, result, attempts; cascades; the one read for retired rows ([D3](DECISIONS.md#d3)) | — | | [FIX-2081](https://linear.app/fixpoint-labs/issue/FIX-2081) · five tools | Five task tools, one rule per field; delegates as authority | FIX-2076, FIX-2080 | | [FIX-2082](https://linear.app/fixpoint-labs/issue/FIX-2082) · waits | `getTask` and the waited dispatch as one wait; 5 deep, 100 under a top task | FIX-2076, FIX-2077, FIX-2081 | @@ -100,14 +100,15 @@ flowchart LR T -->|"updateTask"| S T -->|"createTask, delegates"| R["FIX-2083 · routed tasks"] L -->|"session, result, attempts"| R - E["FIX-2078 · endings and debts"] -->|"the sweeper recovers a lost wait"| B + L -->|"dependents cancelled, with their cause"| E["FIX-2078 · endings and debts"] + E -->|"the sweeper recovers a lost wait"| B E -->|"result to the conversation"| R R -->|"no post entry"| K["FIX-2084 · worker contract"] E -->|"onTaskSettled, dispatch"| K H["FIX-2085 · schedules"] ``` -An edge is what one issue hands the next. FIX-2076, FIX-2078, FIX-2080 and FIX-2085 start at once; +An edge is what one issue hands the next. FIX-2076, FIX-2080 and FIX-2085 start at once; every child blocks the closure, left off. The longest chain is four. ## What stays as it is diff --git a/specs/epics/FIX-2056/figures/d3-read-old-rows.svg b/specs/epics/FIX-2056/figures/d3-read-old-rows.svg index 7bf458dc8e..209996abbe 100644 --- a/specs/epics/FIX-2056/figures/d3-read-old-rows.svg +++ b/specs/epics/FIX-2056/figures/d3-read-old-rows.svg @@ -1,4 +1,4 @@ -