opencodekit 0.16.10 → 0.16.13

package/dist/template/.opencode/plugin/compaction.ts

@@ -1,20 +1,21 @@
 /**
- * Memory & Compaction Plugin (Codex-Inspired Continuity)
+ * Session Continuity Plugin (Compaction-Time Context Injection)
  *
- * Injects continuity context into session compaction:
- * 1. Load session-context.md (CONTINUITY.md pattern)
- * 2. Load project memory files
- * 3. Inject beads in-progress state
+ * Complements DCP plugin (which handles context management rules via
+ * experimental.chat.system.transform). This plugin fires ONLY during
+ * compaction events (experimental.session.compacting) and handles:
+ *
+ * 1. Load session-context.md (CONTINUITY.md pattern) — highest priority
+ * 2. Load project memory files (user prefs, tech stack, gotchas)
+ * 3. Inject beads in-progress state (active task IDs)
  * 4. Load most recent handoff file for session resumption
- * 5. Append workflow-specific compaction rules
+ * 5. Append post-compaction recovery protocol
  *
- * Session context format (agent-maintained via memory-update):
- * - Goal: What we're trying to achieve + success criteria
- * - Constraints: User-specified limits, discovered guardrails
- * - Decisions: Key choices made this session
- * - State: Done/Now/Next
- * - Open Questions: Uncertainties marked UNCONFIRMED
- * - Working Set: Files, bead IDs, branch
+ * Division of responsibility:
+ * - DCP plugin: context budget zones, distill/compress/prune rules,
+ *   prunable-tools list, nudge system (always-on via system.transform)
+ * - This plugin: session state preservation, post-compaction recovery,
+ *   memory persistence reminders (compaction-time only)
  */
 
 import type { Plugin } from "@opencode-ai/plugin";
@@ -101,51 +102,51 @@ export const CompactionPlugin: Plugin = async ({ $, directory }) => {
 				output.context.push(`## Session Context\n${allContext}\n`);
 			}
 
-			// Append workflow-specific rules to OpenCode's default prompt
+			// Append post-compaction recovery protocol
+			// NOTE: Context management rules (distill/compress/prune, tool guidance)
+			// are handled by DCP plugin via experimental.chat.system.transform (always present).
+			// This plugin ONLY handles session continuity and post-compaction recovery.
 			output.prompt = `${output.prompt}
 
-## Additional Rules for This Workflow
+## Post-Compaction Recovery Protocol
+
+### IMMEDIATE: Restore Session State (Do This First)
+1. Read session-context.md via \`memory-read({ file: "session-context" })\`
+2. If missing or stale, reconstruct from the compaction summary above
+3. Resume work from the "Now" item — do NOT restart from scratch
+4. Ask 1-3 targeted questions ONLY if critical gaps remain (don't interrogate)
+
+### Session Continuity Document
+Maintain session-context.md via memory-update tool. This is your lifeline after compaction.
 
-### Session Continuity
-Maintain session-context.md via memory-update tool. Format:
 \`\`\`
-Goal: [What + success criteria]
-Constraints: [Limits, mark UNCONFIRMED if inferred]
-Decisions: [Key choices this session]
+Goal: [What + measurable success criteria]
+Constraints: [Hard limits. Mark UNCONFIRMED if inferred, never assume]
+Decisions: [Key choices made this session + WHY]
 State:
-  Done: [Completed]
-  Now: [Current focus - ONE thing]
-  Next: [Queued]
-Open Questions: [Uncertainties - mark UNCONFIRMED]
-Working Set: [Files, bead ID, branch]
+  Done: [Completed items with verification status]
+  Now: [Current focus - ONE thing only]
+  Next: [Queued items in priority order]
+Open Questions: [Uncertainties - mark UNCONFIRMED, note what would resolve each]
+Working Set: [Exact file paths, bead IDs, branch name, worktree path if applicable]
 \`\`\`
 
-Update session-context.md when:
-- Goal changes or clarifies
-- Key decision made
-- State shifts (Done/Now/Next)
-- Uncertainty discovered
-
-After compaction: Check session-context.md, ask 1-3 targeted questions if gaps exist.
-
-### Beads Workflow
-- PRESERVE: Bead IDs (br-xxx format), bead states, in-progress task IDs
-- DROP: Closed/completed beads (already tracked in git)
-
-### TodoWrite Items
-- PRESERVE: Todo items with exact IDs, statuses (pending/in_progress/completed), priorities
-- DROP: Cancelled todos
-
-### Memory System
-If you discover:
-- Gotchas/edge cases → Save to .opencode/memory/project/gotchas.md
-- Build/test commands → Save to .opencode/memory/project/commands.md
-- Code patterns/conventions → Save to .opencode/memory/project/conventions.md
-- Architecture insights → Save to .opencode/memory/project/architecture.md
-
-### Preservation Priorities
-- PRESERVE: File paths (file:line_number), user constraints, decisions, UNCONFIRMED items
-- DROP: Failed attempts, superseded info, verbose tool outputs, exploration dead-ends
+Update session-context.md when: goal changes, key decision made, state shifts, or uncertainty discovered.
+
+### Preservation Priorities (Compaction-Specific)
+These items MUST survive compaction — if they appeared in conversation, include in summary:
+- **Bead state**: IDs (br-xxx), status, in-progress tasks, dependencies
+- **Todo items**: Exact IDs, statuses, priorities, content
+- **File paths**: Exact paths with line numbers where relevant
+- **User constraints**: Verbatim. Never paraphrase.
+- **Decisions + rationale**: Both WHAT and WHY
+- **UNCONFIRMED items**: Keep uncertainty markers intact
+
+### Memory Persistence (Before Compaction Loses It)
+Save discoveries to persistent memory so they survive:
+- Gotchas/edge cases → observation({ type: "warning", ... })
+- Architecture insights → observation({ type: "pattern", ... })
+- Key decisions → observation({ type: "decision", ... })
 `;
 		},
 	};