opencodekit 0.12.7 → 0.13.0

package/dist/template/.opencode/package.json

@@ -11,7 +11,7 @@
 	"author": "",
 	"license": "ISC",
 	"dependencies": {
-		"@opencode-ai/plugin": "1.1.4"
+		"@opencode-ai/plugin": "1.1.6"
 	},
 	"devDependencies": {
 		"@types/node": "^25.0.3",

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
 
 ```

package/dist/template/.opencode/tool/ast-grep.ts

@@ -6,8 +6,8 @@
  * Requires: npm install -g @ast-grep/cli (or brew install ast-grep)
  */
 
-import { exec } from "child_process";
-import { promisify } from "util";
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
 import { tool } from "@opencode-ai/plugin";
 
 const execAsync = promisify(exec);
@@ -224,7 +224,7 @@ Install via:
 						preview += `... and ${count - 10} more matches\n`;
 					}
 
-					preview += `\n**To apply:** Run again with dryRun: false`;
+					preview += "\n**To apply:** Run again with dryRun: false";
 					return preview;
 				} catch {
 					return `Dry run preview:\n${stdout}`;

package/dist/template/.opencode/tool/bd-inbox.ts

@@ -1,6 +1,6 @@
-import path from "path";
+import fs from "node:fs/promises";
+import path from "node:path";
 import { tool } from "@opencode-ai/plugin";
-import fs from "fs/promises";
 
 const RESERVATIONS_DIR = ".reservations";
 const MESSAGES_FILE = "messages.jsonl";
@@ -84,7 +84,7 @@ export default tool({
 				}
 				await fs.writeFile(
 					messagesPath,
-					allMsgs.map((m) => JSON.stringify(m)).join("\n") + "\n",
+					`${allMsgs.map((m) => JSON.stringify(m)).join("\n")}\n`,
 					"utf-8",
 				);
 			}
@@ -99,11 +99,12 @@ export default tool({
 			messages = messages.slice(-limit).reverse();
 
 			return JSON.stringify({ msgs: messages, count: messages.length });
-		} catch (e: any) {
-			if (e.code === "ENOENT") {
+		} catch (e) {
+			const err = e as NodeJS.ErrnoException;
+			if (err.code === "ENOENT") {
 				return JSON.stringify({ msgs: [], count: 0 });
 			}
-			return JSON.stringify({ error: e.message });
+			return JSON.stringify({ error: (e as Error).message });
 		}
 	},
 });

package/dist/template/.opencode/tool/bd-msg.ts

@@ -1,6 +1,6 @@
-import path from "path";
+import fs from "node:fs/promises";
+import path from "node:path";
 import { tool } from "@opencode-ai/plugin";
-import fs from "fs/promises";
 
 const RESERVATIONS_DIR = ".reservations";
 const MESSAGES_FILE = "messages.jsonl";
@@ -56,7 +56,7 @@ export default tool({
 			read: false,
 		};
 
-		await fs.appendFile(messagesPath, JSON.stringify(msg) + "\n", "utf-8");
+		await fs.appendFile(messagesPath, `${JSON.stringify(msg)}\n`, "utf-8");
 		return JSON.stringify({ ok: 1, id: msg.id });
 	},
 });

package/dist/template/.opencode/tool/bd-release.ts

@@ -1,6 +1,6 @@
-import path from "path";
+import fs from "node:fs/promises";
+import path from "node:path";
 import { tool } from "@opencode-ai/plugin";
-import fs from "fs/promises";
 
 const RESERVATIONS_DIR = ".reservations";
 

package/dist/template/.opencode/tool/bd-reserve.ts

@@ -1,6 +1,6 @@
-import path from "path";
+import fs from "node:fs/promises";
+import path from "node:path";
 import { tool } from "@opencode-ai/plugin";
-import fs from "fs/promises";
 
 const RESERVATIONS_DIR = ".reservations";
 
@@ -69,8 +69,9 @@ export default tool({
 				};
 				await fs.writeFile(metaPath, JSON.stringify(lockData), "utf-8");
 				granted.push(filePath);
-			} catch (e: any) {
-				if (e.code === "EEXIST") {
+			} catch (e) {
+				const err = e as NodeJS.ErrnoException;
+				if (err.code === "EEXIST") {
 					// Lock exists - check if expired or ours
 					try {
 						const content = await fs.readFile(metaPath, "utf-8");

package/dist/template/.opencode/tool/memory-read.ts

@@ -1,6 +1,6 @@
-import path from "path";
+import fs from "node:fs/promises";
+import path from "node:path";
 import { tool } from "@opencode-ai/plugin";
-import fs from "fs/promises";
 
 export default tool({
 	description:

package/dist/template/.opencode/tool/memory-search.ts

@@ -1,6 +1,6 @@
-import path from "path";
+import fs from "node:fs/promises";
+import path from "node:path";
 import { tool } from "@opencode-ai/plugin";
-import fs from "fs/promises";
 
 interface SearchResult {
 	file: string;

package/dist/template/.opencode/tool/memory-update.ts

@@ -1,6 +1,6 @@
-import path from "path";
+import fs from "node:fs/promises";
+import path from "node:path";
 import { tool } from "@opencode-ai/plugin";
-import fs from "fs/promises";
 
 export default tool({
 	description:
@@ -41,21 +41,20 @@ export default tool({
 				const appendContent = `\n\n---\n**Updated:** ${timestamp}\n\n${args.content}`;
 				await fs.appendFile(filePath, appendContent, "utf-8");
 				return `Successfully appended to ${normalizedFile}.md\n[Written to: ${filePath}]`;
-			} else {
-				// Replace mode - update timestamp
-				const timestamp = new Date().toISOString();
-				const updatedContent = args.content.replace(
-					/\*\*Last Updated:\*\* \[Timestamp\]/,
-					`**Last Updated:** ${timestamp}`,
-				);
-				await fs.writeFile(filePath, updatedContent, "utf-8");
-				return `Successfully updated ${normalizedFile}.md\n[Written to: ${filePath}]`;
 			}
+			// Replace mode - update timestamp
+			const timestamp = new Date().toISOString();
+			const updatedContent = args.content.replace(
+				/\*\*Last Updated:\*\* \[Timestamp\]/,
+				`**Last Updated:** ${timestamp}`,
+			);
+			await fs.writeFile(filePath, updatedContent, "utf-8");
+			return `Successfully updated ${normalizedFile}.md\n[Written to: ${filePath}]`;
 		} catch (error) {
 			if (error instanceof Error) {
 				return `Error updating memory: ${error.message}`;
 			}
-			return `Unknown error updating memory file`;
+			return "Unknown error updating memory file";
 		}
 	},
 });

package/dist/template/.opencode/tool/observation.ts

@@ -1,6 +1,6 @@
-import path from "path";
+import fs from "node:fs/promises";
+import path from "node:path";
 import { tool } from "@opencode-ai/plugin";
-import fs from "fs/promises";
 
 // Observation types following claude-mem patterns
 type ObservationType =
@@ -112,9 +112,9 @@ export default tool({
 			observation += `**Files:** ${files.map((f) => `\`${f}\``).join(", ")}\n`;
 		}
 
-		observation += `\n---\n\n`;
+		observation += "\n---\n\n";
 		observation += args.content;
-		observation += `\n`;
+		observation += "\n";
 
 		try {
 			// Ensure directory exists
@@ -128,7 +128,7 @@ export default tool({
 			// Update bead notes if bead_id provided
 			if (args.bead_id) {
 				try {
-					const { execSync } = await import("child_process");
+					const { execSync } = await import("node:child_process");
 					const noteContent = `${icon} ${obsType}: ${args.title}`;
 					execSync(
 						`bd edit ${args.bead_id} --note "${noteContent.replace(/"/g, '\\"')}"`,
@@ -149,7 +149,7 @@ export default tool({
 			if (error instanceof Error) {
 				return `Error saving observation: ${error.message}`;
 			}
-			return `Unknown error saving observation`;
+			return "Unknown error saving observation";
 		}
 	},
 });

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencodekit",
-	"version": "0.12.7",
+	"version": "0.13.0",
 	"description": "CLI tool for bootstrapping and managing OpenCodeKit projects",
 	"type": "module",
 	"repository": {
@@ -17,7 +17,7 @@
 	"files": ["dist", "README.md"],
 	"scripts": {
 		"dev": "bun run src/index.ts",
-		"build": "bun build src/index.ts --outdir dist --target node && mkdir -p dist/template && rsync -av --exclude=node_modules --exclude=dist --exclude=.git --exclude=coverage --exclude=.next --exclude=.turbo --exclude=logs --exclude=package-lock.json .opencode/ dist/template/.opencode/",
+		"build": "bun run build.ts && mkdir -p dist/template && rsync -av --exclude=node_modules --exclude=dist --exclude=.git --exclude=coverage --exclude=.next --exclude=.turbo --exclude=logs --exclude=package-lock.json .opencode/ dist/template/.opencode/",
 		"compile": "bun build src/index.ts --compile --outfile ock",
 		"compile:binary": "bun build src/index.ts --compile --outfile bin/ock",
 		"typecheck": "tsc --noEmit",
@@ -35,11 +35,14 @@
 	"dependencies": {
 		"@clack/prompts": "^0.7.0",
 		"@opencode-ai/plugin": "^1.1.2",
+		"@opentui/core": "^0.1.69",
+		"@opentui/solid": "^0.1.69",
 		"beads-village": "^1.3.3",
 		"cac": "^6.7.14",
 		"cli-table3": "^0.6.5",
 		"ora": "^9.0.0",
 		"picocolors": "^1.1.1",
+		"solid-js": "^1.9.10",
 		"zod": "^3.23.8"
 	},
 	"devDependencies": {