Distillation

Date: Sep 17, 2026

• 🔴 (09:08) User established the recovery invariant: “never resume an older assistant projection”; a newer turn supersedes stale incomplete rows.
• 🟡 (09:08) Session context persistence was changed to require a SessionExecutionClaim.Claim: insert(db, sessionID, generation, claim), replace(db, sessionID, baselineSeq, result.generation, claim), and advance(db, sessionID, result.snapshot, claim). initializeOnce() now also accepts claim and passes it to insert().
• 🟡 (09:08) The in-memory session adapter’s stale-projection protection uses latestAssistantIndex(), implemented as state.messages.findLastIndex((message) => message.type === "assistant"), so ownership updates target the latest assistant rather than an older incomplete assistant row.
• 🟡 (09:08) Recovery projection logic marks interrupted tool execution with status: "error" and preserves prior content only when the tool state was "running"; interruption messages include "Tool execution interrupted", "Session execution interrupted by server restart", and "Provider Step outcome unknown after server restart".
• 🟡 (09:08) /tmp/opencode/session-recovery-v21-review/packages/core/src/session/runner/index.ts defines SessionRunner.Interface.run() as one local continuation from already-recorded session history. Its input is { sessionID: SessionSchema.ID, force: boolean, executionID: string, ownerID: string, recoveryInputID?: SessionMessage.ID }; durable eligible work is drained, while explicit runs make one provider attempt even if no work is eligible.
• 🟡 (09:08) /tmp/opencode/session-recovery-v21-review/packages/core/src/session/runner/index.ts defines RunError as the union of LLMError, SessionRunnerModel.Error, MessageDecodeError, ContextSnapshotDecodeError, SystemContext.InitializationBlocked, and ToolOutputStore.Error; the service identifier is @opencode/v2/SessionRunner.