Distillation

Date: Sep 16, 2026

• 🔴 (14:47) User directed: “never resume an older assistant projection”; a newer turn supersedes stale incomplete rows. This rule appears in both the database projection and in-memory projection logic.
• 🔴 (14:47) In /tmp/opencode/session-recovery-v7-check/packages/core/src/session/context-epoch.ts, SessionContextEpoch.initialize() and SessionContextEpoch.prepare() require a SessionExecutionClaim.Claim, and epoch writes are fenced through SessionExecutionClaim.transaction(...).
• 🔴 (14:47) SessionContextEpoch.prepareOnce() concurrently loads the current SystemContext, stored epoch, and SessionHistory.latestCompaction(...); without a stored epoch it initializes context and inserts a baseline, while an existing epoch is decoded with SystemContext.Snapshot and decode failures become ContextSnapshotDecodeError.
• 🔴 (14:47) Context-epoch reconciliation uses a compaction sequence newer than stored.baseline_seq as replacementSeq: it calls SystemContext.replace(...) when such a sequence exists and SystemContext.reconcile(...) otherwise. Unchanged and ReplacementBlocked preserve the stored baseline; ReplacementReady replaces the baseline and snapshot; an incremental update publishes SessionEvent.ContextUpdated and advances the snapshot in its commit callback.
• 🔴 (14:47) /tmp/opencode/session-recovery-v7-check/packages/core/src/session/context-epoch.ts stores baseline, snapshot, and baseline_seq in SessionContextEpochTable; insert() derives baselineSeq from EventV2.latestSequence(...), while replace() and advance() die with Context Epoch not found if no row is updated.
• 🔴 (14:48) /tmp/opencode/session-recovery-v7-check/packages/core/src/session/compaction.ts defines compaction defaults DEFAULT_BUFFER = 20_000, DEFAULT_KEEP_TOKENS = 8_000, TOOL_OUTPUT_MAX_CHARS = 2_000, and SUMMARY_OUTPUT_TOKENS = 4_096; document configuration can override auto, buffer, and keep.tokens, with later configured values reducing over earlier ones.
• 🔴 (14:48) The compaction summary format requires ordered Markdown sections: ## Objective, ## Important Details, ## Work State with ### Completed, ### Active, and ### Blocked, then ## Next Move with exactly two numbered placeholders, and ## Relevant Files. Rules require every section, terse bullets, preservation of exact paths/symbols/commands/errors/URLs/identifiers, and no mention of compaction or the summary process.
• 🔴 (14:48) SUMMARY_UPDATE_INSTRUCTIONS requires combining <prior-summary> with newer <conversation> content, carrying forward objectives, constraints, directives, decisions, and parallel workstreams unless finished and no longer needed; newer conversation wins conflicts, completed work moves from Active to Completed, resolved blockers are updated, and Objective/Next Move reflect current state.
• 🔴 (14:48) Compaction serialization labels content as [User], [Assistant], [Assistant reasoning], [Assistant tool call], [Tool result], [Tool error], [System update], [Synthetic context], or [Shell]; attached content is represented by MIME type and optional name, and oversized tool or shell output is cut to exactly 2_000 characters followed by \n[truncated].
• 🔴 (14:48) Compaction selection excludes messages of type compaction, walks backward to retain up to the configured recent-token budget, and divides serialized history into head for summarization and recent for direct retention.
• 🔴 (14:48) SessionCompaction.compactIfNeeded() only auto-compacts when enabled and estimated { system, messages, tools } exceeds context - Math.max(output, config.buffer); SessionCompaction.compactAfterOverflow() refuses compaction for missing/nonpositive context limits, absent summarizable history, or a summary prompt larger than context - summaryOutput.
• 🔴 (14:48) SessionCompaction.compactAfterOverflow() publishes SessionEvent.Compaction.Started with reason: "auto", optionally runs beforeStream, invokes the LLM with no tools and maxTokens capped at 4_096, collects textDelta chunks, treats provider errors, LLM.Error, or blank output as failure, and on success publishes SessionEvent.Compaction.Ended with the generated text, retained recent history, and optional commit callback.