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
4 changes: 4 additions & 0 deletions spec/_projects/orchestration-primitives/DECISIONS.md
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,10 @@ It comes down to a post that is tracked work: a ledger-backed message needs a se
| Who tells a filer that its task now waits on a person? | **FIX-2070.** FIX-2058 records the question on the row as a hold; telling the filer is a message and moved to messages | Owner, Oct 23 ([FIX-2058](https://github.com/fixpoint-labs/flow-state-dev/blob/main/specs/epics/FIX-2058/DECISIONS.md#decided-in-review-recorded-so-no-child-reopens-them)) |
| Does a send or a call to a session waiting on a person run? | **Not yet: it queues** (the coordination concept's rule 10), and a FIX-2129 test pins that so a change is seen. Whether giving the key back lets one run is FIX-2070's call | FIX-2058 D2 ([D2](https://github.com/fixpoint-labs/flow-state-dev/blob/main/specs/epics/FIX-2058/DECISIONS.md#d2)) |
| Does FIX-2058 rename what it built? | **No.** The word stays *hold* and `updateTask`'s field stays `question`; FIX-2071 renames them, and also owns a block throwing at its deadline where a tool returns | FIX-2058 ER-8; [wrap analysis](https://linear.app/fixpoint-labs/issue/FIX-2058/epic-one-waiting-on-a-person-always-in-inbox#comment-df99e412), Oct 27 |
| When a name is renamed, does the old one keep working? | **No.** A renamed name is refused loudly, never kept as an alias, a re-export or a second spelling read. A line that names it on purpose carries `retired-name-refusal`. The no-deprecation-release row above, applied to renames | FIX-2071 D1 ([D1](https://github.com/fixpoint-labs/flow-state-dev/blob/main/specs/epics/FIX-2071/DECISIONS.md#d1)), Oct 28 |
| How does a rename land? | **From a committed codemod** under `scripts/codemod/`, in the PR that renames. A PR that conflicts is regenerated by re-running it on fresh `main`, never merged by hand | FIX-2071 ER-2 ([who owns what](https://github.com/fixpoint-labs/flow-state-dev/blob/main/specs/epics/FIX-2071/DECISIONS.md#who-owns-what)) |
Comment thread
jhoffner marked this conversation as resolved.
Resolved
| Can a retired name leave the vocabulary sweep's list? | **No.** The `RETIRED` rows in `goals/vocabulary/one-word-per-thing` only ever grow. A hit kept on purpose goes in `KEEP` with its reason | FIX-2071 ER-3 ([who owns what](https://github.com/fixpoint-labs/flow-state-dev/blob/main/specs/epics/FIX-2071/DECISIONS.md#who-owns-what)) |
| Where is a coordination name decided? | **In the rename table**, [`specs/epics/FIX-2071/renames.md`](https://github.com/fixpoint-labs/flow-state-dev/blob/main/specs/epics/FIX-2071/renames.md): the vocabulary contract. A later epic that finds a name wrong amends the table; it does not pick a new name in a PR | FIX-2071 D2, owner, merged with [#3985](https://github.com/fixpoint-labs/flow-state-dev/pull/3985) Oct 28 |

<a name="open"></a>
## Open
Expand Down
16 changes: 12 additions & 4 deletions spec/_projects/orchestration-primitives/PLAN.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,9 +25,10 @@ is today.
| FIX-2058 · one Inbox | FIX-2056's claim gate and steer, durable execution by default (FIX-2063) | One Inbox item per stop for a person; the answer by steer; `answerTask` and the parks retired ([*decided once*](DECISIONS.md)) |
| FIX-2070 · messages | FIX-2056's task and its sessions | Send and call, delivery and budget; `receive` in place of today's message entry |
| FIX-2092 · phased workflows | FIX-2056's delegation board and `onTaskSettled`, FIX-2058's holds for an approval between phases | Phases as a view over task rows; a template that files a phased task graph. A design to prove by POC before its spec |
| FIX-2071 · coordination renames | FIX-2058, FIX-2070 | One term per thing, *hold* and `updateTask`'s `question` field included; FIX-2056's read for retired rows removed no earlier than here |
| FIX-2071 · coordination renames | FIX-2058, FIX-2070's builds | One term per thing, *hold* and `updateTask`'s `question` field included; FIX-2056's read for retired rows removed no earlier than here |

FIX-2058 wrapped Oct 27, so FIX-2070 and FIX-2092 are free to start, and FIX-2071 waits on FIX-2070 alone.
FIX-2071 built once FIX-2070's builds had landed and wrapped Oct 30, ahead of FIX-2070's closure
Comment thread
jhoffner marked this conversation as resolved.
Resolved
(FIX-2242).

FIX-2056's wrap recommended fixing FIX-2182 (a dispatcher's `wait` restates the board's `mode`)
and FIX-2183 ("hold" names four things) before FIX-2058 built on them. Neither was done, and
Expand Down Expand Up @@ -73,6 +74,13 @@ FIX-2215, a review's *request changes* carrying the reviewer's words, went to Wo
Manager. Lessons are [#3953](https://github.com/fixpoint-labs/flow-state-dev/pull/3953) and the
docs polish [#3954](https://github.com/fixpoint-labs/flow-state-dev/pull/3954).

## What FIX-2071 left open

The closure, FIX-2249, merged Oct 30
([#4244](https://github.com/fixpoint-labs/flow-state-dev/pull/4244)). Lessons are draft
[#4245](https://github.com/fixpoint-labs/flow-state-dev/pull/4245): two owner asks (give the
second-look review its own identity; one BP-030 sentence) and fold candidates F1–F7 to file.

## Milestones

The Linear project keeps three milestones; v3 (True Plan Mode shipped) and v5 (docs and pattern
Expand Down Expand Up @@ -100,5 +108,5 @@ next regression gate is FIX-2070's closure.
- **Waiting on several tasks at once, and a row-less question tool for workers.** FIX-1870 ruled
both out and FIX-2056's five task tools add neither; neither has an epic.
- **Spend caps on delegated work (FIX-933).** Filed under FIX-930, never started.
- **Anything after the renames.** No epic is filed after FIX-2071. The project's remaining life
is FIX-2070 and FIX-2092, then FIX-2071.
- **Anything after the renames.** FIX-2071 wrapped Oct 30 and no epic is filed after it. The
project's remaining life is FIX-2070's closure and FIX-2092.
20 changes: 10 additions & 10 deletions spec/_projects/orchestration-primitives/SPEC.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,15 +13,15 @@ outside it.
|---|---|
| **Winning when** | Every pattern that runs on the task board stores its work as Task rows, and work one worker gives another is answered once, whichever path delivers it. A task that stops for a person waits in one place, one Inbox item answered once: landed Oct 27 with FIX-2058. One task primitive (FIX-2056) landed Oct 24: `createTask` files, `getTask({ id, wait })` waits, and `dispatchTask` is gone |
| **The read** | Parallel ways to give work. Today: **1**, done since Oct 24. A coordinator's post is a routed task (FIX-2083), `dispatchTask` is gone, and every task tool files through `createTask`; the claim ticket is the only answer-once fence ([PD-3](DECISIONS.md)). FIX-2087's closure ran the coordinator and hand-off goals on that one primitive on `main`. `roundRobin` and `debate` run off the board and are outside, by the owner's call ([*decided once*](DECISIONS.md)). Ways to answer a stop for a person outside the Inbox: today **0**, done since Oct 27. `answerTask`, the `parkOnQuestion` and `awaitReview` parks and the harness inbox's `answerQuestion()` are gone; a stop is a `waitForUser` suspension or a hold on its task row, answered through one of two routes ([PR-3](BUSINESS-RULES.md)). FIX-2134's closure sweep ([#3951](https://github.com/fixpoint-labs/flow-state-dev/pull/3951)) found none of the removed names live on `main` |
| **Now** | 8 epics done (the Plan/Task series counted as one) · 0 in flight · 3 filed, not started |
| **Kill line** | Passed Oct 24: FIX-2056's closure (FIX-2087, round 5 [#3847](https://github.com/fixpoint-labs/flow-state-dev/pull/3847)) showed no coordinator or hand-off goal regressing once posts became tasks, so one primitive holds. Passed Oct 27 for the Inbox half: FIX-2058's closure (FIX-2134, [#3951](https://github.com/fixpoint-labs/flow-state-dev/pull/3951)) walked six kinds of stop with a real model, each one Inbox item answered once, and its sweep found no stop answered outside the Inbox. Both halves of answered-once are met; what remains is FIX-2070 and FIX-2071 |
| **Now** | 9 epics done (the Plan/Task series counted as one) · 2 in flight · 0 filed, not started |
| **Kill line** | Passed Oct 24: FIX-2056's closure (FIX-2087, round 5 [#3847](https://github.com/fixpoint-labs/flow-state-dev/pull/3847)) showed no coordinator or hand-off goal regressing once posts became tasks, so one primitive holds. Passed Oct 27 for the Inbox half: FIX-2058's closure (FIX-2134, [#3951](https://github.com/fixpoint-labs/flow-state-dev/pull/3951)) walked six kinds of stop with a real model, each one Inbox item answered once, and its sweep found no stop answered outside the Inbox. Both halves of answered-once are met. FIX-2071's renames wrapped Oct 30; what remains is FIX-2070's closure and FIX-2092 |

![The territory](figures/territory.svg)

Above the fence is the work unit and how it moves between workers. Below it is substrate this
project assembles but other projects own, and the bottom band is what no epic here builds.

## The epics — derived live 2026-10-27
## The epics — derived live 2026-10-30

| Epic | What it owns | State | Surface |
|---|---|---|---|
Expand All @@ -33,11 +33,11 @@ project assembles but other projects own, and the bottom band is what no epic he
| [FIX-1312](https://linear.app/fixpoint-labs/issue/FIX-1312) · **dispatch protocol** | Reply to whoever dispatched me | **done** · Oct 12 | [PR #1587](https://github.com/fixpoint-labs/flow-state-dev/pull/1587) |
| [FIX-2056](https://linear.app/fixpoint-labs/issue/FIX-2056) · **one task primitive** | Two board modes, one completion rule, five task tools, delegates as authority | **done** · wrapped Oct 24 | [PR #3588](https://github.com/fixpoint-labs/flow-state-dev/pull/3588) · `specs/epics/FIX-2056/` · [wrap analysis](https://linear.app/fixpoint-labs/issue/FIX-2056/epic-one-task-primitive-boards-settling-task-tools-and-authority#comment-5093310b) |
| [FIX-2058](https://linear.app/fixpoint-labs/issue/FIX-2058) · **one Inbox** | One "waiting on a person", in Inbox | **done** · wrapped Oct 27 | [PR #3732](https://github.com/fixpoint-labs/flow-state-dev/pull/3732) · `specs/epics/FIX-2058/` · closure [#3951](https://github.com/fixpoint-labs/flow-state-dev/pull/3951) · [wrap analysis](https://linear.app/fixpoint-labs/issue/FIX-2058/epic-one-waiting-on-a-person-always-in-inbox#comment-df99e412) |
| [FIX-2070](https://linear.app/fixpoint-labs/issue/FIX-2070) · **messages** | Send and call, task sessions, delivery and budget | *filed, not started* · free to start | — |
| [FIX-2071](https://linear.app/fixpoint-labs/issue/FIX-2071) · **coordination renames** | One term, one thing | *filed, not started* · waits on FIX-2070 | — |
| [FIX-2092](https://linear.app/fixpoint-labs/issue/FIX-2092) · **phased workflows** | A worker runs a feature's lifecycle as phases of tasks: a view over task rows plus a template that files them | *filed, not started* · free to start; a POC comes before its spec | — |
| [FIX-2070](https://linear.app/fixpoint-labs/issue/FIX-2070) · **messages** | Send and call, task sessions, delivery and budget | *in flight* · builds landed; closure FIX-2242 running | [PR #3983](https://github.com/fixpoint-labs/flow-state-dev/pull/3983) · `specs/epics/FIX-2070/` |
| [FIX-2071](https://linear.app/fixpoint-labs/issue/FIX-2071) · **coordination renames** | One term, one thing | **done** · wrapped Oct 30 | [PR #3985](https://github.com/fixpoint-labs/flow-state-dev/pull/3985) · `specs/epics/FIX-2071/` · closure [#4244](https://github.com/fixpoint-labs/flow-state-dev/pull/4244) · lessons draft [#4245](https://github.com/fixpoint-labs/flow-state-dev/pull/4245) |
| [FIX-2092](https://linear.app/fixpoint-labs/issue/FIX-2092) · **phased workflows** | A worker runs a feature's lifecycle as phases of tasks: a view over task rows plus a template that files them | *in flight* · epic spec in review | [PR #3970](https://github.com/fixpoint-labs/flow-state-dev/pull/3970) |

8 done · 0 in flight · 3 filed, not started. FIX-2058 wrapped with every child Done; what it left open is follow-up, not a change of shape ([Plan](PLAN.md)). Canceled, kept because the cancel is the decision:
9 done · 2 in flight · 0 filed, not started. FIX-2071 wrapped Oct 30 with its seven children merged and its closure ([#4244](https://github.com/fixpoint-labs/flow-state-dev/pull/4244)) green; what it left open is follow-up, not a change of shape ([Plan](PLAN.md)). Canceled, kept because the cancel is the decision:
Comment thread
jhoffner marked this conversation as resolved.
Resolved
[FIX-1197](https://linear.app/fixpoint-labs/issue/FIX-1197) Relay and
[FIX-1169](https://linear.app/fixpoint-labs/issue/FIX-1169) Strands ([*decided once*](DECISIONS.md)),
and [FIX-1870](https://linear.app/fixpoint-labs/issue/FIX-1870) dispatchTask, canceled Oct 21 after
Expand All @@ -60,12 +60,12 @@ flowchart LR
D2058 -->|"an approval gate as a hold"| D2092
classDef done stroke-width:2px
classDef canceled stroke-dasharray:1 3,color:#7A828B
class PT,D930,D939,D980,D1320,D1312,D2056,D2058 done
class PT,D930,D939,D980,D1320,D1312,D2056,D2058,D2071 done
class D1870 canceled
```

Both lines landed and met in dispatchTask, which FIX-2056 replaced. The Inbox has landed on it;
messages and phased workflows are free to start, and the renames come last.
Both lines landed and met in dispatchTask, which FIX-2056 replaced. The Inbox and the renames have
landed on it; messages is closing and phased workflows is in spec review.

## What this project is not

Expand Down
23 changes: 13 additions & 10 deletions spec/_projects/orchestration-primitives/figures/arc.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading