opencodekit 0.12.7 → 0.13.1

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

@@ -1,10 +1,19 @@
 /**
- * Memory & Compaction Plugin
+ * Memory & Compaction Plugin (Codex-Inspired Continuity)
  *
- * Injects memory context and beads state into session compaction:
- * 1. Load memory files for context
- * 2. Inject beads in-progress state
- * 3. Append workflow-specific compaction rules
+ * 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
+ * 4. Append workflow-specific compaction rules
+ *
+ * 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
  */
 
 import type { Plugin } from "@opencode-ai/plugin";
@@ -14,7 +23,19 @@ export const CompactionPlugin: Plugin = async ({ $, directory }) => {
 
 	return {
 		"experimental.session.compacting": async (input, output) => {
-			// Load memory context
+			// 1. Load session context (CONTINUITY.md pattern) - HIGHEST PRIORITY
+			let sessionContext = "";
+			try {
+				const sessionFile = `${MEMORY_DIR}/session-context.md`;
+				const content = await $`cat ${sessionFile} 2>/dev/null`.text();
+				if (content.trim()) {
+					sessionContext = `\n## Session Continuity (Compaction-Safe)\n${content}`;
+				}
+			} catch {
+				// No session context yet
+			}
+
+			// 2. Load project memory files
 			let memoryContext = "";
 			try {
 				const memoryFiles =
@@ -33,7 +54,7 @@ export const CompactionPlugin: Plugin = async ({ $, directory }) => {
 				// Memory dir doesn't exist or other error
 			}
 
-			// Inject beads in-progress state
+			// 3. Inject beads in-progress state
 			let beadsContext = "";
 			try {
 				const result =
@@ -48,12 +69,13 @@ export const CompactionPlugin: Plugin = async ({ $, directory }) => {
 				// Beads not available, skip
 			}
 
-			// Inject memory and beads context into compaction context
-			if (memoryContext || beadsContext) {
-				output.context.push(`## Session Context
-${beadsContext}
-${memoryContext}
-`);
+			// Inject all context - session context FIRST (most important)
+			const allContext = [sessionContext, beadsContext, memoryContext]
+				.filter(Boolean)
+				.join("\n");
+
+			if (allContext) {
+				output.context.push(`## Session Context\n${allContext}\n`);
 			}
 
 			// Append workflow-specific rules to OpenCode's default prompt
@@ -61,6 +83,28 @@ ${memoryContext}
 
 ## Additional Rules for This Workflow
 
+### 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]
+State:
+  Done: [Completed]
+  Now: [Current focus - ONE thing]
+  Next: [Queued]
+Open Questions: [Uncertainties - mark UNCONFIRMED]
+Working Set: [Files, bead ID, branch]
+\`\`\`
+
+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 (bd-xxx format), bead states, in-progress task IDs
 - DROP: Closed/completed beads (already tracked in git)
@@ -71,13 +115,13 @@ ${memoryContext}
 
 ### Memory System
 If you discover:
-- Gotchas/edge cases → Mention they should be saved to .opencode/memory/project/gotchas.md
-- Build/test commands → Mention they should be saved to .opencode/memory/project/commands.md
-- Code patterns/conventions → Mention they should be saved to .opencode/memory/project/conventions.md
-- Architecture insights → Mention they should be saved to .opencode/memory/project/architecture.md
+- 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 with exact locations (file:line_number), user constraints, technical decisions
+- PRESERVE: File paths (file:line_number), user constraints, decisions, UNCONFIRMED items
 - DROP: Failed attempts, superseded info, verbose tool outputs, exploration dead-ends
 `;
 		},

package/dist/template/.opencode/plugin/lib/notify.ts

@@ -12,7 +12,7 @@ let _isWSL: boolean | null = null;
 export function isWSL(): boolean {
 	if (_isWSL !== null) return _isWSL;
 	try {
-		const fs = require("fs");
+		const fs = require("node:fs");
 		const release = fs.readFileSync("/proc/version", "utf8").toLowerCase();
 		_isWSL = release.includes("microsoft") || release.includes("wsl");
 	} catch {
@@ -28,7 +28,6 @@ export function isWSL(): boolean {
  * @param message - Notification body
  */
 export async function notify(
-	// eslint-disable-next-line @typescript-eslint/no-explicit-any
 	$: any,
 	title: string,
 	message: string,
@@ -39,7 +38,7 @@ export async function notify(
 
 	try {
 		if (platform === "darwin") {
-			await $`osascript -e ${'display notification "' + safeMessage + '" with title "' + safeTitle + '"'}`;
+			await $`osascript -e ${`display notification "${safeMessage}" with title "${safeTitle}"`}`;
 		} else if (platform === "linux") {
 			if (isWSL()) {
 				// WSL: try notify-send, fail silently

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

@@ -116,7 +116,7 @@ export const SessionsPlugin: Plugin = async ({ client }) => {
 						const userMessages = messageData.filter(
 							(m) => m.info?.role === "user",
 						);
-						summary += `## Recent User Messages\n\n`;
+						summary += "## Recent User Messages\n\n";
 						for (let i = 0; i < Math.min(userMessages.length, 5); i++) {
 							const m = userMessages[i];
 							const content = extractContent(m.info);

package/dist/template/.opencode/plugin/skill-mcp.ts

@@ -1,7 +1,7 @@
-import { type ChildProcess, spawn } from "child_process";
-import { existsSync, readFileSync } from "fs";
-import { homedir } from "os";
-import { join } from "path";
+import { type ChildProcess, spawn } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
 import type { Plugin } from "@opencode-ai/plugin";
 import { tool } from "@opencode-ai/plugin/tool";
 
@@ -155,7 +155,7 @@ export const SkillMcpPlugin: Plugin = async ({ directory }) => {
 				},
 			});
 
-			client.process.stdin?.write(JSON.stringify(request) + "\n");
+			client.process.stdin?.write(`${JSON.stringify(request)}\n`);
 		});
 	}
 
@@ -232,10 +232,10 @@ export const SkillMcpPlugin: Plugin = async ({ directory }) => {
 
 			// Send initialized notification
 			proc.stdin?.write(
-				JSON.stringify({
+				`${JSON.stringify({
 					jsonrpc: "2.0",
 					method: "notifications/initialized",
-				}) + "\n",
+				})}\n`,
 			);
 
 			// Discover capabilities
@@ -430,7 +430,7 @@ The skill must be loaded first via the skill() tool to register its MCP config.`
 					if (args.skill_name) {
 						const toDisconnect: string[] = [];
 						for (const key of state.clients.keys()) {
-							if (key.startsWith(args.skill_name + ":")) {
+							if (key.startsWith(`${args.skill_name}:`)) {
 								toDisconnect.push(key);
 							}
 						}
@@ -440,11 +440,10 @@ The skill must be loaded first via the skill() tool to register its MCP config.`
 							state.clients.delete(key);
 						}
 						return JSON.stringify({ disconnected: toDisconnect });
-					} else {
-						const count = state.clients.size;
-						disconnectAll();
-						return JSON.stringify({ disconnected: "all", count });
 					}
+					const count = state.clients.size;
+					disconnectAll();
+					return JSON.stringify({ disconnected: "all", count });
 				},
 			}),
 		},

package/dist/template/.opencode/skill/beads/SKILL.md

@@ -506,6 +506,50 @@ bd_claim(); // Gets frontend task that was waiting on API
 5. **Use `bd_msg(to="all")`** - For team-wide announcements
 6. **Sync regularly** - `bd_sync()` at session end
 
+## Best Practices (from Steve Yegge)
+
+### Daily/Weekly Maintenance
+
+| Task         | Frequency      | Command               | Why                                            |
+| ------------ | -------------- | --------------------- | ---------------------------------------------- |
+| Health check | Weekly         | `bd doctor`           | Repairs database issues, detects orphaned work |
+| Cleanup      | Every few days | `bd cleanup --days 7` | Keep DB under 200-500 issues for performance   |
+| Upgrade      | Weekly         | `bd upgrade`          | Get latest features and fixes                  |
+| Git hooks    | Once per repo  | `bd hooks install`    | Auto-sync on commit/merge/checkout             |
+
+### Key Principles
+
+1. **Plan outside Beads first** - Use planning tools, then import tasks to beads
+2. **One task per session, then restart** - Fresh context prevents confusion
+3. **File lots of issues** - Any work >2 minutes should be tracked
+4. **Use short prefixes** - `bd-`, `vc-`, `wy-` etc.
+5. **"Land the plane" = PUSH** - `bd sync` means git push, not "ready when you are"
+6. **Include issue ID in commits** - `git commit -m "Fix bug (bd-abc)"`
+
+### Database Health
+
+```bash
+# Check database size
+bd list --status=all --json | wc -l
+
+# Target: under 200-500 issues
+# If over, run cleanup more aggressively:
+bd cleanup --days 3
+```
+
+### Git Hooks (Essential)
+
+```bash
+bd hooks install
+```
+
+Installs hooks for:
+
+- **pre-commit**: Sync before commit
+- **post-merge**: Import changes after merge
+- **pre-push**: Ensure sync before push
+- **post-checkout**: Refresh after branch switch
+
 ## Quick Reference
 
 ```