Distillation

Date: Sep 16, 2026

• 🔴 (15:34) User requires session recovery to “never resume an older assistant projection”; a newer turn supersedes stale incomplete rows.
• 🟡 (15:34) packages/core/src/session/message-updater.ts uses assistant-message ownership checks via updateOwnedAssistant(event.data.assistantMessageID, ...), preventing events from mutating a superseded assistant projection.
• 🟡 (15:34) In packages/core/src/session/message-updater.ts, "session.next.tool.failed" only transitions a matching tool from "pending" or "running" to "error"; it preserves provider execution state, provider metadata, structured/content data for running tools, records event.data.result, and sets completion time to event.data.timestamp.
• 🟡 (15:34) packages/core/src/session/context-epoch.ts makes context-epoch writes ownership-sensitive by passing SessionExecutionClaim.Claim through initialize(), prepare(), insert(), replace(), and advance() and wrapping mutations in SessionExecutionClaim.transaction(...).
• 🟡 (15:34) SessionContextEpoch.prepare() concurrently loads current SystemContext, the stored context epoch, and SessionHistory.latestCompaction; it initializes when no epoch exists, uses SystemContext.replace when a newer compaction sequence supersedes stored.baseline_seq, otherwise uses SystemContext.reconcile, and publishes SessionEvent.ContextUpdated with a claim-guarded advance(...) commit when reconciliation produces an update.
• 🟡 (15:35) packages/core/src/session/compaction.ts compaction defaults are DEFAULT_BUFFER = 20_000, DEFAULT_KEEP_TOKENS = 8_000, TOOL_OUTPUT_MAX_CHARS = 2_000, and SUMMARY_OUTPUT_TOKENS = 4_096.
• 🟡 (15:35) Compaction summaries must preserve the exact ordered Markdown sections ## Objective, ## Important Details, ## Work State with ### Completed, ### Active, and ### Blocked, then ## Next Move, and ## Relevant Files; rules require every section, terse bullets, exact paths/symbols/commands/errors/URLs/identifiers, and no mention of compaction or the summary process.
• 🟡 (15:35) Incremental compaction instructions require combining <prior-summary> with newer <conversation>, carrying forward active objectives, constraints, directives, decisions, and parallel workstreams; newer conversation wins conflicts, completed work moves from Active to Completed, resolved blockers are updated, and Objective/Next Move reflect current state.
• 🟡 (15:35) SessionCompaction.compactIfNeeded triggers only when automatic compaction is enabled and estimated system/messages/tools tokens exceed context - Math.max(output, config.buffer); compactAfterOverflow preserves the configured recent-token tail, limits summary generation to at most 4_096 tokens, publishes SessionEvent.Compaction.Started, rejects failed/provider-error/blank summaries, and publishes SessionEvent.Compaction.Ended with both generated summary text and selected.recent.
• 🟡 (15:35) packages/server/src/routes.ts builds application services with Database.node, EventV2.node, httpClient, ToolOutputStore.cleanupNode, SessionV2.node, SessionRecovery.node, PermissionSaved.node, PtyTicket.node, Credential.node, PtyEnvironment.node, and LocationServiceMap.node; AppNodeBuilder.build(applicationServices, [[SessionExecution.node, SessionExecutionLocal.node]]) supplies execution services to routes.
• 🟡 (15:35) Server route construction exposes OpenAPI at /openapi.json; createRoutes(password?) uses username "opencode" with an optional password, while createEmbeddedRoutes() uses username "opencode" with Option.none().