opencodekit 0.12.3 → 0.12.5

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

@@ -11,12 +11,10 @@
 	"author": "",
 	"license": "ISC",
 	"dependencies": {
-		"@opencode-ai/plugin": "1.1.2"
+		"@opencode-ai/plugin": "1.1.3"
 	},
 	"devDependencies": {
 		"@types/node": "^25.0.3",
-		"fs": "^0.0.1-security",
-		"path": "^0.12.7",
 		"typescript": "^5.9.3"
 	}
 }

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

@@ -1,94 +1,39 @@
-import * as fs from "fs";
-import * as path from "path";
-import type { Plugin } from "@opencode-ai/plugin";
-
 /**
  * Memory & Compaction Plugin
  *
- * Combines memory auto-loading with session compaction customization:
- * 1. Auto-load memory on session start (session.start hook)
- * 2. Inject memory + beads context into compaction
- * 3. Custom compaction prompt for context 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
  */
 
-// Memory paths
-const getGlobalUserMemoryPath = () =>
-	path.join(process.env.HOME || "~", ".config/opencode/memory/user.md");
-
-const getProjectMemoryPath = (directory: string) =>
-	path.join(directory, ".opencode/memory");
-
-// Load memory files for injection
-const loadMemoryContext = async (directory: string): Promise<string[]> => {
-	const context: string[] = [];
-
-	// 1. Global user memory (cross-project preferences)
-	const globalUserPath = getGlobalUserMemoryPath();
-	if (fs.existsSync(globalUserPath)) {
-		try {
-			const content = fs.readFileSync(globalUserPath, "utf-8");
-			if (content.trim() && !content.includes("<!-- ")) {
-				context.push(`## User Profile (Global)\n${content}`);
-			}
-		} catch {}
-	}
-
-	// 2. Project memory files
-	const projectMemoryPath = getProjectMemoryPath(directory);
-	if (fs.existsSync(projectMemoryPath)) {
-		const files = [
-			"project/commands.md",
-			"project/conventions.md",
-			"project/gotchas.md",
-			"project/architecture.md",
-		];
-		for (const file of files) {
-			const filePath = path.join(projectMemoryPath, file);
-			if (fs.existsSync(filePath)) {
-				try {
-					const content = fs.readFileSync(filePath, "utf-8");
-					// Only include if has actual content (not just template)
-					if (content.trim() && !content.includes("<!-- ")) {
-						const name = path.basename(file, ".md");
-						context.push(`## Project ${name}\n${content}`);
-					}
-				} catch {}
-			}
-		}
-	}
-
-	return context;
-};
+import type { Plugin } from "@opencode-ai/plugin";
 
-export const CompactionPlugin: Plugin = async (ctx) => {
-	const { $, directory } = ctx;
+export const CompactionPlugin: Plugin = async ({ $, directory }) => {
+	const MEMORY_DIR = `${directory}/.opencode/memory`;
 
 	return {
-		// 1. Auto-load memory context on session start
-		"session.start": async (
-			_input: unknown,
-			output: { additionalContext?: string },
-		) => {
-			const memoryContext = await loadMemoryContext(directory);
-
-			if (memoryContext.length > 0) {
-				output.additionalContext = `
-# Memory Context (Auto-loaded)
-
-${memoryContext.join("\n\n")}
-`;
-				console.log(
-					`[compaction] Injected ${memoryContext.length} memory contexts into session`,
-				);
-			}
-		},
-
-		// 2. Inject context into compaction
 		"experimental.session.compacting": async (input, output) => {
-			// Load memory context for compaction
-			const memoryContext = await loadMemoryContext(directory);
+			// Load memory context
+			let memoryContext = "";
+			try {
+				const memoryFiles =
+					await $`find ${MEMORY_DIR}/project -name '*.md' -type f 2>/dev/null | head -10`.quiet();
+				if (memoryFiles.stdout) {
+					const files = memoryFiles.stdout.toString().trim().split("\n");
+					for (const file of files) {
+						const content = await $`cat ${file}`.text();
+						if (content.trim() && !content.includes("<!-- ")) {
+							const name = file.split("/").pop()?.replace(".md", "");
+							memoryContext += `\n## Project ${name}\n${content}`;
+						}
+					}
+				}
+			} catch {
+				// Memory dir doesn't exist or other error
+			}
 
-			// Inject beads state if available
+			// Inject beads in-progress state
 			let beadsContext = "";
 			try {
 				const result =
@@ -96,68 +41,45 @@ ${memoryContext.join("\n\n")}
 				if (result.stdout) {
 					const inProgress = JSON.parse(result.stdout.toString());
 					if (inProgress.length > 0) {
-						beadsContext = `\n## Active Beads\n${inProgress.map((b: { id: string; title: string }) => `- ${b.id}: ${b.title}`).join("\n")}`;
+						beadsContext = `\n## Active Beads (In Progress)\n${inProgress.map((b: { id: string; title: string }) => `- ${b.id}: ${b.title}`).join("\n")}`;
 					}
 				}
 			} catch {
 				// Beads not available, skip
 			}
 
-			// Inject custom context with memory
-			const memorySection =
-				memoryContext.length > 0
-					? `\n## Persistent Memory\n${memoryContext.join("\n\n")}\n`
-					: "";
-
-			output.context.push(`## Session Context
+			// Inject memory and beads context into compaction context
+			if (memoryContext || beadsContext) {
+				output.context.push(`## Session Context
 ${beadsContext}
-${memorySection}
-## Memory Files to Check
-- .opencode/memory/project/gotchas.md - Non-obvious behaviors discovered
-- .opencode/memory/project/commands.md - Build/test commands learned
-- .opencode/memory/project/conventions.md - Code patterns observed
-
-## Persistence Rules
-- PRESERVE: Bead IDs, todo items, file paths, line numbers, user constraints
-- DROP: Failed attempts, superseded info, verbose tool outputs, exploration dead-ends
-- Include enough context that a new session can continue seamlessly`);
-
-			// Replace the entire compaction prompt for more control
-			output.prompt = `You are summarizing a coding session for context continuity.
-
-## Output Structure
-
-Use these sections:
-
-### COMPLETED
-- What was done (with file paths)
-- Bead IDs closed and why
+${memoryContext}
+`);
+			}
 
-### IN PROGRESS
-- Current task and bead ID (if any)
-- Files being modified (exact paths)
-- Current todo state (preserve TodoWrite items)
+			// Append workflow-specific rules to OpenCode's default prompt
+			output.prompt = `${output.prompt}
 
-### NEXT
-- What needs to be done next
-- Blockers or pending decisions
+## Additional Rules for This Workflow
 
-### CONSTRAINTS
-- User preferences that must persist
-- Rules or requirements stated by user
-- Technical decisions and rationale
+### Beads Workflow
+- PRESERVE: Bead IDs (bd-xxx format), bead states, in-progress task IDs
+- DROP: Closed/completed beads (already tracked in git)
 
-### PERSIST TO MEMORY
-- Gotchas discovered → suggest for project/gotchas.md
-- Commands learned → suggest for project/commands.md
-- Patterns observed → suggest for project/conventions.md
+### TodoWrite Items
+- PRESERVE: Todo items with exact IDs, statuses (pending/in_progress/completed), priorities
+- DROP: Cancelled todos
 
-## Rules
+### 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
 
-- PRESERVE: Bead IDs, todo items, file paths, line numbers, user constraints
+### Preservation Priorities
+- PRESERVE: File paths with exact locations (file:line_number), user constraints, technical decisions
 - DROP: Failed attempts, superseded info, verbose tool outputs, exploration dead-ends
-- Be concise but complete - this summary replaces the full conversation
-- Include enough context that a new session can continue seamlessly`;
+`;
 		},
 	};
 };

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

@@ -1,182 +1,37 @@
 /**
  * OpenCode Handoff Plugin
- * Injects handoff context into session compaction for seamless session transitions
+ * Injects the most recent handoff file into session compaction
  *
  * Workflow:
- * 1. User runs /handoff command → creates handoff markdown file
- * 2. User presses Ctrl+K to compact session
- * 3. This plugin injects the handoff context into the compaction prompt
- * 4. New session starts with full context from previous session
+ * 1. User creates handoff markdown file in .opencode/memory/handoffs/
+ * 2. Session compaction (Ctrl+K) includes handoff context
+ * 3. New session resumes from previous state
  */
 
-import { existsSync, readFileSync, readdirSync } from "fs";
-import { join } from "path";
 import type { Plugin } from "@opencode-ai/plugin";
 
-const HANDOFF_DIRS = [
-	".opencode/memory/handoffs",
-	".beads/artifacts", // Check for bead-specific handoffs
-] as const;
-
-interface HandoffFile {
-	path: string;
-	mtime: number;
-	content: string;
-}
-
-function findLatestHandoff(baseDir: string): HandoffFile | null {
-	const handoffs: HandoffFile[] = [];
-
-	for (const dir of HANDOFF_DIRS) {
-		const fullPath = join(baseDir, dir);
-		if (!existsSync(fullPath)) continue;
-
-		try {
-			const files = findMarkdownFiles(fullPath);
-			for (const file of files) {
-				try {
-					const stat = require("fs").statSync(file);
-					const content = readFileSync(file, "utf-8");
-
-					// Only include files that look like handoffs
-					if (
-						content.includes("## Resume Instructions") ||
-						content.includes("## Progress") ||
-						content.includes("# Handoff:")
-					) {
-						handoffs.push({
-							path: file,
-							mtime: stat.mtimeMs,
-							content,
-						});
-					}
-				} catch {
-					// Skip unreadable files
-				}
-			}
-		} catch {
-			// Skip inaccessible directories
-		}
-	}
-
-	if (handoffs.length === 0) return null;
-
-	// Return most recent
-	return handoffs.sort((a, b) => b.mtime - a.mtime)[0];
-}
-
-function findMarkdownFiles(dir: string, depth = 3): string[] {
-	if (depth <= 0) return [];
-
-	const results: string[] = [];
-
-	try {
-		const entries = readdirSync(dir, { withFileTypes: true });
-
-		for (const entry of entries) {
-			const fullPath = join(dir, entry.name);
-
-			if (entry.isDirectory() && !entry.name.startsWith(".")) {
-				results.push(...findMarkdownFiles(fullPath, depth - 1));
-			} else if (entry.isFile() && entry.name.endsWith(".md")) {
-				results.push(fullPath);
-			}
-		}
-	} catch {
-		// Skip inaccessible directories
-	}
-
-	return results;
-}
-
-function formatHandoffForCompaction(handoff: HandoffFile): string {
-	// Extract key sections from handoff
-	const content = handoff.content;
-
-	return `## Previous Session Handoff
-
-<handoff-context>
-${content}
-</handoff-context>
-
-**IMPORTANT**: Resume work from where the previous session left off. Check the "Resume Instructions" section above for specific next steps.`;
-}
-
-export const HandoffPlugin: Plugin = async ({ client, directory }) => {
-	client.app
-		.log({
-			body: {
-				service: "handoff-plugin",
-				level: "info",
-				message: "🔄 Handoff Plugin loaded - session continuity enabled",
-			},
-		})
-		.catch(() => {});
+export const HandoffPlugin: Plugin = async ({ $, directory }) => {
+	const HANDOFF_DIR = `${directory}/.opencode/memory/handoffs`;
 
 	return {
-		// Inject handoff context when session is being compacted
 		"experimental.session.compacting": async (_input, output) => {
-			const handoff = findLatestHandoff(directory);
+			// Find most recent handoff file
+			const result =
+				await $`ls -t ${HANDOFF_DIR}/*.md 2>/dev/null | head -1`.quiet();
 
-			if (!handoff) {
-				client.app
-					.log({
-						body: {
-							service: "handoff-plugin",
-							level: "debug",
-							message: "No handoff found - compacting without handoff context",
-						},
-					})
-					.catch(() => {});
-				return;
-			}
+			if (!result.stdout) return;
 
-			// Check if handoff is recent (within last hour)
-			const oneHourAgo = Date.now() - 60 * 60 * 1000;
-			const isRecent = handoff.mtime > oneHourAgo;
+			const handoffPath = result.stdout.toString().trim();
+			const handoffContent = await $`cat ${handoffPath}`.text();
 
-			if (!isRecent) {
-				client.app
-					.log({
-						body: {
-							service: "handoff-plugin",
-							level: "debug",
-							message: `Handoff found but stale (${new Date(handoff.mtime).toISOString()}) - skipping injection`,
-						},
-					})
-					.catch(() => {});
-				return;
-			}
+			// Inject into compaction context
+			output.context.push(`
+## Previous Session Handoff
 
-			// Inject handoff context
-			const formattedHandoff = formatHandoffForCompaction(handoff);
-			output.context.push(formattedHandoff);
-
-			client.app
-				.log({
-					body: {
-						service: "handoff-plugin",
-						level: "info",
-						message: `📋 Injected handoff context from: ${handoff.path}`,
-					},
-				})
-				.catch(() => {});
-		},
+${handoffContent}
 
-		// Log when compaction completes
-		event: async ({ event }) => {
-			if (event.type === "session.compacted") {
-				client.app
-					.log({
-						body: {
-							service: "handoff-plugin",
-							level: "info",
-							message:
-								"✅ Session compacted with handoff context - ready to continue",
-						},
-					})
-					.catch(() => {});
-			}
+**IMPORTANT**: Resume work from where previous session left off.
+`);
 		},
 	};
 };

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

@@ -4,7 +4,7 @@
  */
 
 import type { Plugin } from "@opencode-ai/plugin";
-import { notify } from "./lib/notify";
+import { notify } from "./lib/notify.js";
 
 export const NotificationPlugin: Plugin = async ({ client, $ }) => {
 	const notifiedSessions = new Set<string>();

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

@@ -0,0 +1,7 @@
+{
+	"name": "opencode-plugins",
+	"type": "module",
+	"dependencies": {
+		"@opencode-ai/plugin": "^1.1.2"
+	}
+}