opencodekit 0.14.5 → 0.15.0

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

@@ -3,58 +3,54 @@ import path from "node:path";
 import { tool } from "@opencode-ai/plugin";
 
 export default tool({
-	description:
-		"Update memory files with new learnings, progress, or context. Appends or replaces content based on mode. Supports subdirectories for organization (e.g., 'research/opencode-sessions' creates .opencode/memory/research/opencode-sessions.md).",
-	args: {
-		file: tool.schema
-			.string()
-			.describe(
-				"Memory file to update: handoffs/YYYY-MM-DD-phase, research/YYYY-MM-DD-topic. Use _templates/ for reference only.",
-			),
-		content: tool.schema
-			.string()
-			.describe("Content to write or append to the memory file"),
-		mode: tool.schema
-			.string()
-			.optional()
-			.default("replace")
-			.describe(
-				"Update mode: 'replace' (overwrite file) or 'append' (add to end).",
-			),
-	},
-	execute: async (args: { file: string; content: string; mode?: string }) => {
-		// Always write to project memory (.opencode/memory/)
-		const memoryDir = path.join(process.cwd(), ".opencode/memory");
+  description:
+    "Update memory files with new learnings, progress, or context. Appends or replaces content based on mode. Supports subdirectories for organization (e.g., 'research/opencode-sessions' creates .opencode/memory/research/opencode-sessions.md).",
+  args: {
+    file: tool.schema
+      .string()
+      .describe(
+        "Memory file to update: handoffs/YYYY-MM-DD-phase, research/YYYY-MM-DD-topic. Use _templates/ for reference only.",
+      ),
+    content: tool.schema.string().describe("Content to write or append to the memory file"),
+    mode: tool.schema
+      .string()
+      .optional()
+      .default("replace")
+      .describe("Update mode: 'replace' (overwrite file) or 'append' (add to end)."),
+  },
+  execute: async (args: { file: string; content: string; mode?: string }) => {
+    // Always write to project memory (.opencode/memory/)
+    const memoryDir = path.join(process.cwd(), ".opencode/memory");
 
-		// Normalize file path: strip existing .md extension, handle subdirectories
-		const normalizedFile = args.file.replace(/\.md$/i, ""); // Remove .md if present
-		const filePath = path.join(memoryDir, `${normalizedFile}.md`);
-		const mode = args.mode || "replace";
+    // Normalize file path: strip existing .md extension, handle subdirectories
+    const normalizedFile = args.file.replace(/\.md$/i, ""); // Remove .md if present
+    const filePath = path.join(memoryDir, `${normalizedFile}.md`);
+    const mode = args.mode || "replace";
 
-		try {
-			// Ensure parent directory exists (handles subdirectories)
-			const fileDir = path.dirname(filePath);
-			await fs.mkdir(fileDir, { recursive: true });
+    try {
+      // Ensure parent directory exists (handles subdirectories)
+      const fileDir = path.dirname(filePath);
+      await fs.mkdir(fileDir, { recursive: true });
 
-			if (mode === "append") {
-				const timestamp = new Date().toISOString();
-				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}]`;
-			}
-			// 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";
-		}
-	},
+      if (mode === "append") {
+        const timestamp = new Date().toISOString();
+        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}]`;
+      }
+      // 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";
+    }
+  },
 });

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

@@ -1,9 +1,6 @@
 import fs from "node:fs/promises";
 import path from "node:path";
-import * as lancedb from "@lancedb/lancedb";
 import { tool } from "@opencode-ai/plugin";
-import { generateEmbedding } from "./memory-embed";
-import { searchVectorStore } from "./memory-index";
 
 // Observation types following claude-mem patterns
 type ObservationType =
@@ -49,13 +46,6 @@ interface FileReference {
 	line?: number;
 }
 
-interface CodeLink {
-	name: string;
-	type: string;
-	file: string;
-	line: number;
-}
-
 // Extract file references from observation content
 function extractFileReferences(content: string): FileReference[] {
 	const refs: FileReference[] = [];
@@ -82,118 +72,6 @@ function extractFileReferences(content: string): FileReference[] {
 	return refs;
 }
 
-// Find related code definitions for an observation
-async function findRelatedCode(
-	title: string,
-	content: string,
-	fileRefs: FileReference[],
-): Promise<CodeLink[]> {
-	const links: CodeLink[] = [];
-
-	try {
-		// Search for code definitions related to the observation
-		const searchQuery = `${title} ${fileRefs.map((r) => r.file).join(" ")}`;
-		const results = await searchVectorStore(searchQuery, 5, "code");
-
-		for (const result of results) {
-			// Check if this code is in one of the referenced files
-			const isDirectRef = fileRefs.some(
-				(ref) =>
-					result.file_path.includes(ref.file) ||
-					ref.file.includes(result.file_path),
-			);
-
-			if (isDirectRef) {
-				links.push({
-					name: result.title.replace(/^(function|class|type|interface): /, ""),
-					type: result.title.split(":")[0] || "code",
-					file: result.file_path,
-					line: 0, // Would need to parse from result
-				});
-			}
-		}
-	} catch {
-		// Vector store might not have code indexed yet
-	}
-
-	return links.slice(0, 5); // Limit to 5 links
-}
-
-// Vector store configuration
-const VECTOR_DB_PATH = ".opencode/memory/vector_db";
-const TABLE_NAME = "memories";
-
-async function addToVectorStore(
-	filePath: string,
-	title: string,
-	content: string,
-	fileType: string,
-): Promise<{ success: boolean; error?: string }> {
-	try {
-		const embeddingResult = await generateEmbedding(content.substring(0, 8000));
-		if (!embeddingResult) {
-			return { success: false, error: "Failed to generate embedding" };
-		}
-
-		const dbPath = path.join(process.cwd(), VECTOR_DB_PATH);
-		await fs.mkdir(dbPath, { recursive: true });
-
-		const db = await lancedb.connect(dbPath);
-		const relativePath = path.relative(process.cwd(), filePath);
-
-		const document: Record<string, unknown> = {
-			id: relativePath.replace(/[\/\\]/g, "_"),
-			file_path: relativePath,
-			title,
-			content,
-			content_preview: content.substring(0, 500),
-			embedding: embeddingResult.embedding,
-			indexed_at: new Date().toISOString(),
-			file_type: fileType,
-		};
-
-		let table: lancedb.Table;
-		try {
-			table = await db.openTable(TABLE_NAME);
-			// Add to existing table
-			await table.add([document]);
-		} catch {
-			// Table doesn't exist, create it
-			await db.createTable(TABLE_NAME, [document]);
-		}
-
-		return { success: true };
-	} catch (err) {
-		const msg = err instanceof Error ? err.message : String(err);
-		return { success: false, error: msg };
-	}
-}
-
-// Check for potentially contradicting observations
-async function findSimilarObservations(
-	title: string,
-	content: string,
-	concepts: string[],
-): Promise<{ file: string; title: string; similarity: string }[]> {
-	try {
-		// Search for similar observations using semantic search
-		const searchQuery = `${title} ${concepts.join(" ")}`;
-		const similar = await searchVectorStore(searchQuery, 5, "observation");
-
-		// Filter to only observations with high similarity
-		return similar
-			.filter((doc) => doc.title !== title) // Exclude self
-			.slice(0, 3)
-			.map((doc) => ({
-				file: path.basename(doc.file_path),
-				title: doc.title,
-				similarity: "high",
-			}));
-	} catch {
-		return [];
-	}
-}
-
 export default tool({
 	description:
 		"Create a structured observation for future reference. Observations are categorized by type (decision, bugfix, feature, pattern, discovery, learning, warning) and stored in .opencode/memory/observations/.",
@@ -288,7 +166,7 @@ export default tool({
 			: [];
 		let files = args.files ? args.files.split(",").map((f) => f.trim()) : [];
 
-		// Auto-detect file references from content (Phase 2: Link to code)
+		// Auto-detect file references from content
 		const detectedRefs = extractFileReferences(args.content);
 		const detectedFiles = detectedRefs.map((r) => r.file);
 
@@ -296,24 +174,17 @@ export default tool({
 		const allFiles = [...new Set([...files, ...detectedFiles])];
 		files = allFiles;
 
-		// Find related code definitions
-		const codeLinks = await findRelatedCode(
-			args.title,
-			args.content,
-			detectedRefs,
-		);
-
-		// Build observation content with YAML frontmatter for temporal tracking
+		// Build observation content with YAML frontmatter
 		const icon = TYPE_ICONS[obsType];
 		const confidenceIcon = CONFIDENCE_ICONS[confidence];
 
-		// YAML frontmatter for temporal validity (Graphiti-inspired)
+		// YAML frontmatter for temporal validity
 		let observation = "---\n";
 		observation += `type: ${obsType}\n`;
 		observation += `created: ${now.toISOString()}\n`;
 		observation += `confidence: ${confidence}\n`;
-		observation += "valid_until: null\n"; // null = still valid
-		observation += "superseded_by: null\n"; // null = not superseded
+		observation += "valid_until: null\n";
+		observation += "superseded_by: null\n";
 		if (args.supersedes) {
 			observation += `supersedes: ${args.supersedes}\n`;
 		}
@@ -326,14 +197,6 @@ export default tool({
 		if (files.length > 0) {
 			observation += `files: [${files.map((f) => `"${f}"`).join(", ")}]\n`;
 		}
-		if (codeLinks.length > 0) {
-			observation += "code_links:\n";
-			for (const link of codeLinks) {
-				observation += `  - name: "${link.name}"\n`;
-				observation += `    type: "${link.type}"\n`;
-				observation += `    file: "${link.file}"\n`;
-			}
-		}
 		observation += "---\n\n";
 
 		// Content
@@ -349,20 +212,6 @@ export default tool({
 			// Write observation
 			await fs.writeFile(filePath, observation, "utf-8");
 
-			// Generate embedding and add to vector store
-			let embeddingStatus = "";
-			const vectorResult = await addToVectorStore(
-				filePath,
-				args.title,
-				observation,
-				"observation",
-			);
-			if (vectorResult.success) {
-				embeddingStatus = "\nEmbedding: ✓ Added to vector store";
-			} else {
-				embeddingStatus = `\nEmbedding: ⚠ ${vectorResult.error || "Failed"}`;
-			}
-
 			// Handle supersedes - update old observation's superseded_by field
 			let supersedesStatus = "";
 			if (args.supersedes) {
@@ -385,23 +234,6 @@ export default tool({
 
 			let beadUpdate = "";
 
-			// Check for similar/potentially contradicting observations
-			let contradictionWarning = "";
-			const similarObs = await findSimilarObservations(
-				args.title,
-				args.content,
-				concepts,
-			);
-			if (similarObs.length > 0) {
-				contradictionWarning =
-					"\n\n⚠️ **Similar observations found** (potential contradictions):";
-				for (const obs of similarObs) {
-					contradictionWarning += `\n- ${obs.title} (\`${obs.file}\`)`;
-				}
-				contradictionWarning +=
-					"\n\nIf this supersedes an older observation, use `supersedes` arg to mark it.";
-			}
-
 			// Update bead notes if bead_id provided
 			if (args.bead_id) {
 				try {
@@ -421,19 +253,13 @@ export default tool({
 				}
 			}
 
-			// Build code links info
-			let codeLinksInfo = "";
-			if (codeLinks.length > 0) {
-				codeLinksInfo = `\nCode Links: ${codeLinks.map((l) => `${l.type}:${l.name}`).join(", ")}`;
-			}
-
 			// Build auto-detected files info
 			let autoDetectedInfo = "";
 			if (detectedFiles.length > 0) {
 				autoDetectedInfo = `\nAuto-detected: ${detectedFiles.length} file reference(s)`;
 			}
 
-			return `✓ Observation saved: ${filename}\n\nType: ${icon} ${obsType}\nTitle: ${args.title}\nConfidence: ${confidenceIcon} ${confidence}\nConcepts: ${concepts.join(", ") || "none"}\nFiles: ${files.join(", ") || "none"}${codeLinksInfo}${autoDetectedInfo}${embeddingStatus}${supersedesStatus}${beadUpdate}${contradictionWarning}\n\nPath: ${filePath}`;
+			return `✓ Observation saved: ${filename}\n\nType: ${icon} ${obsType}\nTitle: ${args.title}\nConfidence: ${confidenceIcon} ${confidence}\nConcepts: ${concepts.join(", ") || "none"}\nFiles: ${files.join(", ") || "none"}${autoDetectedInfo}${supersedesStatus}${beadUpdate}\n\nPath: ${filePath}`;
 		} catch (error) {
 			if (error instanceof Error) {
 				return `Error saving observation: ${error.message}`;

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

@@ -1,21 +1,21 @@
 {
-	"compilerOptions": {
-		"target": "ES2022",
-		"module": "ESNext",
-		"moduleResolution": "bundler",
-		"allowSyntheticDefaultImports": true,
-		"esModuleInterop": true,
-		"allowJs": true,
-		"strict": false,
-		"noEmit": true,
-		"declaration": true,
-		"outDir": "./dist",
-		"rootDir": "./",
-		"skipLibCheck": true,
-		"forceConsistentCasingInFileNames": true,
-		"resolveJsonModule": true,
-		"types": ["node"]
-	},
-	"include": ["plugin/**/*.ts", "tool/**/*.ts", "agent/**/*.ts", "*.ts"],
-	"exclude": ["node_modules", "dist", "**/*.js", "**/*.test.ts"]
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "allowJs": true,
+    "strict": false,
+    "noEmit": true,
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": "./",
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "types": ["node"]
+  },
+  "include": ["plugin/**/*.ts", "tool/**/*.ts", "agent/**/*.ts", "*.ts"],
+  "exclude": ["node_modules", "dist", "**/*.js", "**/*.test.ts"]
 }

package/package.json

@@ -1,20 +1,23 @@
 {
 	"name": "opencodekit",
-	"version": "0.14.5",
+	"version": "0.15.0",
 	"description": "CLI tool for bootstrapping and managing OpenCodeKit projects",
-	"type": "module",
+	"keywords": ["agents", "cli", "mcp", "opencode", "opencodekit", "template"],
+	"license": "MIT",
+	"author": "OpenCodeKit",
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/opencodekit/opencodekit-template.git"
 	},
-	"publishConfig": {
-		"access": "public",
-		"registry": "https://registry.npmjs.org"
-	},
 	"bin": {
 		"ock": "dist/index.js"
 	},
 	"files": ["dist", "README.md"],
+	"type": "module",
+	"publishConfig": {
+		"access": "public",
+		"registry": "https://registry.npmjs.org"
+	},
 	"scripts": {
 		"dev": "bun run src/index.ts",
 		"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/",
@@ -23,14 +26,10 @@
 		"typecheck": "tsc --noEmit",
 		"test": "bun test",
 		"test:watch": "bun test --watch",
-		"lint": "biome check .",
-		"lint:fix": "biome check --fix ."
-	},
-	"keywords": ["cli", "opencodekit", "template", "agents", "mcp", "opencode"],
-	"author": "OpenCodeKit",
-	"license": "MIT",
-	"engines": {
-		"bun": ">=1.3.2"
+		"lint": "oxlint .",
+		"lint:fix": "oxlint --fix .",
+		"format": "oxfmt",
+		"format:check": "oxfmt --check"
 	},
 	"dependencies": {
 		"@clack/prompts": "^0.7.0",
@@ -42,7 +41,7 @@
 		"cli-table3": "^0.6.5",
 		"ora": "^9.0.0",
 		"picocolors": "^1.1.1",
-		"solid-js": "^1.9.10",
+		"solid-js": "1.9.9",
 		"zod": "^3.25.76"
 	},
 	"devDependencies": {
@@ -50,7 +49,12 @@
 		"@biomejs/biome": "^1.9.4",
 		"@types/bun": "latest",
 		"@types/node": "^22.19.5",
+		"oxfmt": "^0.23.0",
+		"oxlint": "^1.38.0",
 		"typescript": "^5.9.3"
 	},
+	"engines": {
+		"bun": ">=1.3.2"
+	},
 	"trustedDependencies": ["@beads/bd"]
 }

package/dist/template/.opencode/.background-tasks.json

@@ -1,114 +0,0 @@
-{
-	"tasks": {
-		"bg_1767973877335_d2ihzd": {
-			"taskId": "bg_1767973877335_d2ihzd",
-			"sessionId": "ses_45c8b89a4ffeuq5BxBRQv4wrwd",
-			"agent": "explore",
-			"prompt": "Find all agent definitions in this project. List the file paths and agent names.",
-			"started": 1767973890766,
-			"status": "cancelled"
-		},
-		"bg_1767973898236_s7kyjm": {
-			"taskId": "bg_1767973898236_s7kyjm",
-			"sessionId": "ses_45c8b37ffffeIMMtZrHruaRN7A",
-			"agent": "scout",
-			"prompt": "What is the latest version of @opencode-ai/sdk and what are its main features?",
-			"started": 1767973936815,
-			"status": "completed"
-		},
-		"bg_1767974743680_ppd6p1": {
-			"taskId": "bg_1767974743680_ppd6p1",
-			"sessionId": "ses_45c7e517bffeagStJem1UDrHNf",
-			"agent": "explore",
-			"prompt": "Find all TypeScript files in the .opencode/tool directory and list them.",
-			"started": 1767974756797,
-			"status": "completed",
-			"beadId": "opencodekit-template-ag8",
-			"autoCloseBead": true
-		},
-		"bg_1767974825480_mlpk5z": {
-			"taskId": "bg_1767974825480_mlpk5z",
-			"sessionId": "ses_45c7d11efffe9LnnUp1W2C7GiI",
-			"agent": "explore",
-			"prompt": "List all files in .opencode/agent directory",
-			"started": 1767974843970,
-			"status": "completed",
-			"beadId": "opencodekit-template-3k0",
-			"autoCloseBead": true
-		},
-		"bg_1767975003390_y1pliv": {
-			"taskId": "bg_1767975003390_y1pliv",
-			"sessionId": "ses_45c7a5afffferx20SjJEy782Ap",
-			"agent": "explore",
-			"prompt": "Count the number of markdown files in .opencode/command directory",
-			"started": 1767975020306,
-			"status": "completed",
-			"beadId": "opencodekit-template-0ch",
-			"autoCloseBead": true
-		},
-		"bg_1767975064912_8nvlh7": {
-			"taskId": "bg_1767975064912_8nvlh7",
-			"sessionId": "ses_45c796aa9ffeYEhEzxybXEuOfO",
-			"agent": "explore",
-			"prompt": "List files in .opencode/agent directory",
-			"started": 1767975078449,
-			"status": "completed",
-			"beadId": "opencodekit-template-ryg",
-			"autoCloseBead": true
-		},
-		"bg_1767982850780_sdkoc4": {
-			"taskId": "bg_1767982850780_sdkoc4",
-			"sessionId": "ses_45c029d22ffe7cWSSebxdvxIgL",
-			"agent": "explore",
-			"prompt": "Find all TypeScript files in the src/commands directory and list what each command does. This is a test of agent delegation.",
-			"started": 1767982870771,
-			"status": "completed"
-		},
-		"bg_1767984165033_jyv9bd": {
-			"taskId": "bg_1767984165033_jyv9bd",
-			"sessionId": "ses_45bee8f51ffeJ6B5L7AMik624S",
-			"parentSessionId": "ses_45c0ae526ffeQlmBlscyZMZALt",
-			"agent": "explore",
-			"prompt": "List all TypeScript files in .opencode/tool/ directory and briefly describe what each tool does. This is a test of sub-session linking.",
-			"started": 1767984193526,
-			"status": "completed"
-		},
-		"bg_1767984696916_qi0xa9": {
-			"taskId": "bg_1767984696916_qi0xa9",
-			"sessionId": "ses_45be671a7ffeXRL43PHImPBtCh",
-			"parentSessionId": "ses_45c0ae526ffeQlmBlscyZMZALt",
-			"agent": "explore",
-			"prompt": "Find all files in src/commands/ and list their exports. This is a test of the updated background tool.",
-			"started": 1767984719380,
-			"status": "completed",
-			"beadId": "bd-test-123"
-		},
-		"bg_1767985457040_uo3le4": {
-			"taskId": "bg_1767985457040_uo3le4",
-			"sessionId": "ses_45bdad86bffeZNUcXDi1wrSwxb",
-			"parentSessionId": "ses_45c0ae526ffeQlmBlscyZMZALt",
-			"agent": "explore",
-			"prompt": "List files in src/ directory. Quick test.",
-			"started": 1767985471066,
-			"status": "failed"
-		},
-		"bg_1768055221950_w4qq7h": {
-			"taskId": "bg_1768055221950_w4qq7h",
-			"pid": 63439,
-			"outputFile": ".opencode/.background-output/bg_1768055221950_w4qq7h.txt",
-			"agent": "scout",
-			"prompt": "Research best practices for Bun CLI tools. Return a brief 3-5 bullet point summary.",
-			"started": 1768055221953,
-			"status": "running"
-		},
-		"bg_1768055221957_ahsl80": {
-			"taskId": "bg_1768055221957_ahsl80",
-			"pid": 63440,
-			"outputFile": ".opencode/.background-output/bg_1768055221957_ahsl80.txt",
-			"agent": "explore",
-			"prompt": "Find all TypeScript files in src/commands/ and list their main exported functions. Return a brief summary.",
-			"started": 1768055221958,
-			"status": "running"
-		}
-	}
-}

package/dist/template/.opencode/.ralph-state.json

@@ -1,12 +0,0 @@
-{
-	"active": false,
-	"sessionID": null,
-	"iteration": 0,
-	"maxIterations": 50,
-	"completionPromise": "<promise>COMPLETE</promise>",
-	"task": "",
-	"prdFile": null,
-	"progressFile": "progress.txt",
-	"startedAt": null,
-	"mode": "hitl"
-}