Skip to content
Prev Previous commit
Next Next commit
Keep a failed OMP resume owed across retries in the pi-harness epic spec
The shipped harness manager reads only the previous attempt's confirmed
session; a resumed attempt that throws confirms none, so the retry is handed
null and starts a fresh conversation, undoing ER-3/ER-20's fail-closed resume
one attempt later. Bring that one manager change into LAB-163's scope: for a
row continuing a parked session, the resume obligation survives retries until
a harness confirms it or the row settles failed. Other harnesses' ordinary-
retry self-heal is unchanged (ER-12).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0125zR5sy7YdPsbrrtzQ1dKf
  • Loading branch information
claude committed Oct 10, 2026
commit 2f7b832ef858b8d0740cc13540fb33c4be07dee2
4 changes: 2 additions & 2 deletions spec/_epics/pi-harness/BUSINESS-RULES.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ who owns it and where it's checked. ER-1 to ER-7 are the rows of the ownership m
|---|---|---|---|
| ER-1 | A dispatched OMP run executes in the selected checkout, produces observable output, and settles through the existing manager | LAB-163 | LAB-163's tests · the full-path proof |
| ER-2 | Cancellation stops work and throws. A prompt acknowledgement, an intermediate event or a process exit is never read as completion, and a runtime stop is never relabelled as successful parking | LAB-163 ([D4](DECISIONS.md#d4)) | LAB-163's tests · the proof's negative cases |
| ER-3 | A later attempt reopens the same saved session and remembers a fact the run generated before the question, absent from the new prompt. Missing, corrupt or mismatched resume material fails rather than starting a fresh conversation | LAB-163 ([D6](DECISIONS.md#d6)) | LAB-163's tests · the full-path proof |
| ER-3 | A later attempt reopens the same saved session and remembers a fact the run generated before the question, absent from the new prompt. Missing, corrupt or mismatched resume material fails rather than starting a fresh conversation — on that attempt **and every retry after it**: for a row continuing a parked session, the manager keeps the session it owes until a harness confirms it or the row settles failed, never handing a retry `null` | LAB-163 ([D6](DECISIONS.md#d6)) | LAB-163's tests · the full-path proof |
| ER-4 | A captured question reaches the manager's intake through one trusted, attempt-correlated path | LAB-164 decides · LAB-163 co-specifies ([D3](DECISIONS.md#d3)) | The joint feasibility check · both spec reviews |
| ER-5 | The attempt and the worker request end at the park. No runtime process and no worker request is retained during human wait | LAB-164 ([D2](DECISIONS.md#d2)) | The full-path proof |
| ER-6 | Only a real question enters the parked-question path. Tool-permission prompts and extension UI dialogs do not; they follow the host's configured allow/deny policy | LAB-164 ([D2](DECISIONS.md#d2)) | LAB-164's tests · the proof |
Expand Down Expand Up @@ -45,7 +45,7 @@ who owns it and where it's checked. ER-1 to ER-7 are the rows of the ownership m
| # | The epic is done when | Proved by |
|---|---|---|
| ER-19 | A real OMP run reaches a real question; the operator sees it through the existing surface after durable parking; the runtime is stopped; an answer continues the exact saved session, with a pre-question generated fact intact and absent from the answer prompt; the task settles | LAB-164's full-path evidence, reproducible, against a pinned OMP version |
| ER-20 | User cancellation stays cancellation; late, duplicate and cross-attempt answers cannot affect another run; missing or corrupt resume material and runtime failure fail safely, without a silent fresh session | LAB-164's negative cases, run separately from the happy path |
| ER-20 | User cancellation stays cancellation; late, duplicate and cross-attempt answers cannot affect another run; missing or corrupt resume material and runtime failure fail safely, without a silent fresh session on that attempt or on any retry | LAB-164's negative cases, run separately from the happy path |
| ER-21 | If safe capture, stop, persistence or same-session continuation cannot be shown, the epic returns to the objective gate | The kill line. No live wait, fresh-session replay or adapter-only delivery is substituted and called complete |

**Restarting a process is an adversarial condition here, not the proof.** The same session identity
Expand Down
5 changes: 5 additions & 0 deletions spec/_epics/pi-harness/DECISIONS.md
Original file line number Diff line number Diff line change
Expand Up @@ -107,6 +107,11 @@ that reads *consumes* is a place that child must not re-decide.
- **The negative persistence claim needed an evidence field** (note). Post-stop `ENOENT` checks
were added; `rpc-ui --tools ask` is the local check, and source inspection the basis for the
mode distinction.
- **A failed resume must not be retried fresh** (must fix). The shipped manager reads only the
previous attempt's confirmed session, and a resume that throws confirms none, so the retry is
handed `null` and quietly starts a new conversation — D6's fail-closed lookup undone one attempt
later. LAB-163 owns keeping the obligation across retries for a parked session (ER-3); the
ordinary-retry self-heal stays for other harnesses (ER-12).
- **Runtime audience: OMP first, pi deferred.** Reopen for an immediate pi audience, not because
the protocol names look alike.

Expand Down
6 changes: 3 additions & 3 deletions spec/_epics/pi-harness/PLAN.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ document adds time to it.

| Issue | Route | Consumes | Delivers | Releases | Size |
|---|---|---|---|---|---|
| **LAB-163** OMP harness | spec → impl PR | The shipped harness contract and the manager's slot and policy · LAB-154's manager-side session association · [D4](DECISIONS.md#d4), [D5](DECISIONS.md#d5), [D6](DECISIONS.md#d6) | An OMP harness taking prompt input and trusted run configuration; observable events; session identity through `onSession` during the run; resume of that exact saved conversation; terminal success, runtime failure and cancellation told apart; honest startup/model/auth failures; the tested OMP version recorded | LAB-164's delivery | Medium |
| **LAB-163** OMP harness | spec → impl PR | The shipped harness contract and the manager's slot and policy · LAB-154's manager-side session association · [D4](DECISIONS.md#d4), [D5](DECISIONS.md#d5), [D6](DECISIONS.md#d6) | An OMP harness taking prompt input and trusted run configuration; observable events; session identity through `onSession` during the run; resume of that exact saved conversation, with the manager keeping that resume owed across a failed attempt's retries (ER-3); terminal success, runtime failure and cancellation told apart; honest startup/model/auth failures; the tested OMP version recorded | LAB-164's delivery | Medium |
| **LAB-164** questions park and resume | spec → impl PR → the proof | LAB-163's adapter, resume and `onSession` · the existing manager intake, inbox, answer action and operator surface · [D2](DECISIONS.md#d2), [D3](DECISIONS.md#d3), [D6](DECISIONS.md#d6) | The trusted attempt-correlated handoff, co-specified with LAB-163; a captured question as durable evidence; the park where the attempt and the request end; the answer carried into a later attempt of the same session; real questions told apart from permission and extension dialogs; the negative cases; reproducible full-path evidence | The epic's wrap | Large |

**The feasibility check is LAB-164's, and it is not a third issue.** It is the first thing LAB-164
Expand Down Expand Up @@ -55,7 +55,7 @@ ER-13 consumes it without re-parenting it.
| Seam | Between | Rule |
|---|---|---|
| The attempt-correlated question destination | LAB-163 and LAB-164 | ER-4. LAB-164 decides it, LAB-163 co-specifies it, and both do so before either interface is final. A second route is exactly the failure the seam exists to prevent |
| `resume` and `onSession` | LAB-163 and LAB-154 (shipped) | LAB-154 owns manager-side association; LAB-163 supplies OMP's side. Neither redoes the other's half |
| `resume` and `onSession` | LAB-163 and LAB-154 (shipped) | LAB-154 owns manager-side association; LAB-163 supplies OMP's side, plus the one addition ER-3 needs: a resume owed to a parked session survives a failed attempt instead of falling back to `null`. Neither redoes the other's half |
| The completed-handle park arm of the manager's intake | LAB-164 and the shipped manager | Preserve the single marker intake first (D3). Any change to the intake returns to this epic (ER-7) |
| The pinned OMP version | Both issues | ER-17. One pinned version across the set's evidence; two versions makes the proof unreadable |

Expand All @@ -64,7 +64,7 @@ ER-13 consumes it without re-parenting it.
| Issue | What it owns | Why it isn't in the set |
|---|---|---|
| [FIX-1246](https://linear.app/fixpoint-labs/issue/FIX-1246) | The broader substrate same-session POC | This epic adds OMP-specific capture and stop evidence and reuses its continuity standard. It does not close or supersede it (ER-13) |
| [LAB-154](https://linear.app/fixpoint-labs/issue/LAB-154) | Manager-side session association · **done** | Consumed. LAB-163 supplies OMP's side only |
| [LAB-154](https://linear.app/fixpoint-labs/issue/LAB-154) | Manager-side session association · **done** | Consumed. LAB-163 supplies OMP's side, and adds only the sticky resume obligation ER-3 needs |
| [LAB-140](https://linear.app/fixpoint-labs/issue/LAB-140) | The harness manager program · in progress | The set adds a slot to it; it does not rewrite it |
| [LAB-151](https://linear.app/fixpoint-labs/issue/LAB-151) | The operator board · in review | The surface this epic reuses. Building a second one is what D1 cut |
| [FIX-1241 / D-1](https://linear.app/fixpoint-labs/issue/FIX-1241) | The one-human-wait model | A standing decision D2 preserves. No child reopens it locally |
Expand Down
8 changes: 6 additions & 2 deletions spec/_epics/pi-harness/SPEC.md
Original file line number Diff line number Diff line change
Expand Up @@ -96,10 +96,14 @@ neither is a placeholder.
## What stays as it is

- **The harness manager, the inbox, the answer action and the operator surface.** Reused, not
extended. [LAB-140](https://linear.app/fixpoint-labs/issue/LAB-140) owns the manager program,
extended, with one exception below. [LAB-140](https://linear.app/fixpoint-labs/issue/LAB-140) owns the manager program,
[LAB-151](https://linear.app/fixpoint-labs/issue/LAB-151) the operator board.
- **Manager-side session association** — [LAB-154](https://linear.app/fixpoint-labs/issue/LAB-154),
done. LAB-163 supplies OMP's side of `resume`/`onSession` and does not redo that work.
done. LAB-163 supplies OMP's side of `resume`/`onSession` and does not redo that work. **The one
manager change in scope:** today a resumed attempt that throws loses the session it was owed —
the retry is handed `null` and starts fresh. LAB-163 makes that resume obligation stick across
retries for a row continuing a parked session (ER-3), leaving the ordinary-retry self-heal of
other harnesses as it is (ER-12).
- **Tool permissions**, which stay the host's configured allow/deny policy.
- **Upstream pi.** Deferred, not refused forever — reopened for a real pi audience, not because
the protocol names look alike.
Expand Down
Loading