opencodekit 0.16.0 → 0.16.1

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

@@ -1,18 +1,10 @@
-import fs from "node:fs/promises";
-import path from "node:path";
 import { tool } from "@opencode-ai/plugin";
-
-// Observation types following claude-mem patterns
-type ObservationType =
-	| "decision"
-	| "bugfix"
-	| "feature"
-	| "pattern"
-	| "discovery"
-	| "learning"
-	| "warning";
-
-type ConfidenceLevel = "high" | "medium" | "low";
+import {
+	type ConfidenceLevel,
+	type ObservationInput,
+	type ObservationType,
+	storeObservation,
+} from "../plugin/lib/memory-db.js";
 
 const TYPE_ICONS: Record<ObservationType, string> = {
 	decision: "🎯",
@@ -78,14 +70,15 @@ export default tool({
 	Purpose:
 	- Capture decisions, bugs, features, patterns, discoveries, learnings, or warnings
 	- Auto-detects file references from content (file:line, \`path\`, src/, .opencode/)
-	- Stores in .opencode/memory/observations/ with YAML frontmatter
-	- Optionally updates bead notes and handles observation supersession
+	- Stores in SQLite with FTS5 index for fast search
+	- Supports enhanced schema: facts, subtitle, files_read/files_modified
 	
 	Example:
 	observation({
 	  type: "decision",
 	  title: "Use JWT for auth",
-	  content: "Decided to use JWT tokens because...",
+	  narrative: "Decided to use JWT tokens because...",
+	  facts: "stateless, scalable, industry standard",
 	  concepts: "authentication, jwt, security",
 	  confidence: "high"
 	})`,
@@ -96,20 +89,43 @@ export default tool({
 				"Observation type: decision, bugfix, feature, pattern, discovery, learning, warning",
 			),
 		title: tool.schema.string().describe("Brief title for the observation"),
-		content: tool.schema
+		subtitle: tool.schema
+			.string()
+			.optional()
+			.describe("Optional subtitle or tagline"),
+		facts: tool.schema
 			.string()
+			.optional()
+			.describe("Comma-separated key facts (e.g., 'stateless, scalable')"),
+		narrative: tool.schema
+			.string()
+			.optional()
 			.describe("Detailed observation content with context"),
+		content: tool.schema
+			.string()
+			.optional()
+			.describe(
+				"DEPRECATED: Use 'narrative' instead. Alias for backward compat.",
+			),
 		concepts: tool.schema
 			.string()
 			.optional()
 			.describe(
 				"Comma-separated concept tags (e.g., 'authentication, oauth, security')",
 			),
+		files_read: tool.schema
+			.string()
+			.optional()
+			.describe("Comma-separated files that were read (e.g., 'src/auth.ts')"),
+		files_modified: tool.schema
+			.string()
+			.optional()
+			.describe("Comma-separated files that were modified"),
 		files: tool.schema
 			.string()
 			.optional()
 			.describe(
-				"Comma-separated related files (e.g., 'src/auth.ts, src/login.ts')",
+				"DEPRECATED: Use 'files_modified' instead. Alias for backward compat.",
 			),
 		bead_id: tool.schema
 			.string()
@@ -125,21 +141,24 @@ export default tool({
 			.string()
 			.optional()
 			.describe(
-				"Filename of observation this supersedes (for contradiction handling)",
+				"ID or filename of observation this supersedes (for contradiction handling)",
 			),
 	},
 	execute: async (args: {
 		type: string;
 		title: string;
-		content: string;
+		subtitle?: string;
+		facts?: string;
+		narrative?: string;
+		content?: string;
 		concepts?: string;
+		files_read?: string;
+		files_modified?: string;
 		files?: string;
 		bead_id?: string;
 		confidence?: string;
 		supersedes?: string;
 	}) => {
-		const obsDir = path.join(process.cwd(), ".opencode/memory/observations");
-
 		// Validate type
 		const validTypes: ObservationType[] = [
 			"decision",
@@ -163,96 +182,77 @@ export default tool({
 			return `Error: Invalid confidence level '${args.confidence}'.\nValid levels: ${validConfidence.join(", ")}`;
 		}
 
-		// Generate filename: YYYY-MM-DD-type-slug.md
-		const now = new Date();
-		const dateStr = now.toISOString().split("T")[0];
-		const slug = args.title
-			.toLowerCase()
-			.replace(/[^a-z0-9]+/g, "-")
-			.replace(/^-|-$/g, "")
-			.substring(0, 40);
-		const filename = `${dateStr}-${obsType}-${slug}.md`;
-		const filePath = path.join(obsDir, filename);
+		// Handle deprecated fields (backward compat)
+		const narrative = args.narrative || args.content || "";
+		const filesModifiedRaw = args.files_modified || args.files || "";
 
-		// Parse concepts and files
+		// Parse arrays from comma-separated strings
+		const facts = args.facts
+			? args.facts
+					.split(",")
+					.map((f) => f.trim())
+					.filter(Boolean)
+			: [];
 		const concepts = args.concepts
-			? args.concepts.split(",").map((c) => c.trim())
+			? args.concepts
+					.split(",")
+					.map((c) => c.trim())
+					.filter(Boolean)
+			: [];
+		let filesRead = args.files_read
+			? args.files_read
+					.split(",")
+					.map((f) => f.trim())
+					.filter(Boolean)
+			: [];
+		const filesModified = filesModifiedRaw
+			? filesModifiedRaw
+					.split(",")
+					.map((f) => f.trim())
+					.filter(Boolean)
 			: [];
-		let files = args.files ? args.files.split(",").map((f) => f.trim()) : [];
 
-		// Auto-detect file references from content
-		const detectedRefs = extractFileReferences(args.content);
+		// Auto-detect file references from narrative
+		const detectedRefs = extractFileReferences(narrative);
 		const detectedFiles = detectedRefs.map((r) => r.file);
 
 		// Merge detected files with explicitly provided files
-		const allFiles = [...new Set([...files, ...detectedFiles])];
-		files = allFiles;
-
-		// Build observation content with YAML frontmatter
-		const icon = TYPE_ICONS[obsType];
-		const confidenceIcon = CONFIDENCE_ICONS[confidence];
+		filesRead = [...new Set([...filesRead, ...detectedFiles])];
 
-		// 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";
-		observation += "superseded_by: null\n";
+		// Parse supersedes (could be numeric ID or filename)
+		let supersedesId: number | undefined;
 		if (args.supersedes) {
-			observation += `supersedes: ${args.supersedes}\n`;
-		}
-		if (args.bead_id) {
-			observation += `bead_id: ${args.bead_id}\n`;
-		}
-		if (concepts.length > 0) {
-			observation += `concepts: [${concepts.map((c) => `"${c}"`).join(", ")}]\n`;
-		}
-		if (files.length > 0) {
-			observation += `files: [${files.map((f) => `"${f}"`).join(", ")}]\n`;
+			const parsed = Number.parseInt(args.supersedes, 10);
+			if (!Number.isNaN(parsed)) {
+				supersedesId = parsed;
+			}
 		}
-		observation += "---\n\n";
 
-		// Content
-		observation += `# ${icon} ${args.title}\n\n`;
-		observation += `${confidenceIcon} **Confidence:** ${confidence}\n\n`;
-		observation += args.content;
-		observation += "\n";
+		// Prepare observation input
+		const input: ObservationInput = {
+			type: obsType,
+			title: args.title,
+			subtitle: args.subtitle,
+			facts: facts.length > 0 ? facts : undefined,
+			narrative: narrative || undefined,
+			concepts: concepts.length > 0 ? concepts : undefined,
+			files_read: filesRead.length > 0 ? filesRead : undefined,
+			files_modified: filesModified.length > 0 ? filesModified : undefined,
+			confidence,
+			bead_id: args.bead_id,
+			supersedes: supersedesId,
+		};
 
 		try {
-			// Ensure directory exists
-			await fs.mkdir(obsDir, { recursive: true });
-
-			// Write observation
-			await fs.writeFile(filePath, observation, "utf-8");
-
-			// Handle supersedes - update old observation's superseded_by field
-			let supersedesStatus = "";
-			if (args.supersedes) {
-				try {
-					const oldPath = path.join(obsDir, args.supersedes);
-					const oldContent = await fs.readFile(oldPath, "utf-8");
-					// Update superseded_by in frontmatter
-					const updatedContent = oldContent.replace(
-						/superseded_by: null/,
-						`superseded_by: "${filename}"`,
-					);
-					if (updatedContent !== oldContent) {
-						await fs.writeFile(oldPath, updatedContent, "utf-8");
-						supersedesStatus = `\nSupersedes: ✓ Marked ${args.supersedes} as superseded`;
-					}
-				} catch {
-					supersedesStatus = `\nSupersedes: ⚠ Could not update ${args.supersedes}`;
-				}
-			}
-
-			let beadUpdate = "";
+			// Store in SQLite (single source of truth)
+			const sqliteId = storeObservation(input);
 
 			// Update bead notes if bead_id provided
+			let beadUpdate = "";
 			if (args.bead_id) {
 				try {
 					const { execSync } = await import("node:child_process");
-					const noteContent = `${icon} ${obsType}: ${args.title}`;
+					const noteContent = `${TYPE_ICONS[obsType]} ${obsType}: ${args.title}`;
 					execSync(
 						`bd edit ${args.bead_id} --note "${noteContent.replace(/"/g, '\\"')}"`,
 						{
@@ -267,13 +267,25 @@ export default tool({
 				}
 			}
 
-			// Build auto-detected files info
-			let autoDetectedInfo = "";
-			if (detectedFiles.length > 0) {
-				autoDetectedInfo = `\nAuto-detected: ${detectedFiles.length} file reference(s)`;
+			// Build output
+			const icon = TYPE_ICONS[obsType];
+			const confIcon = CONFIDENCE_ICONS[confidence];
+
+			let output = `✓ Observation #${sqliteId} saved\n\n`;
+			output += `**Type**: ${icon} ${obsType}\n`;
+			output += `**Title**: ${args.title}\n`;
+			output += `**Confidence**: ${confIcon} ${confidence}\n`;
+
+			if (concepts.length > 0) {
+				output += `**Concepts**: ${concepts.join(", ")}\n`;
 			}
+			if (facts.length > 0) {
+				output += `**Facts**: ${facts.length} extracted\n`;
+			}
+
+			output += beadUpdate;
 
-			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}`;
+			return output;
 		} 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", "bun-types"]
+	},
+	"include": ["plugin/**/*.ts", "tool/**/*.ts", "agent/**/*.ts", "*.ts"],
+	"exclude": ["node_modules", "dist", "**/*.js", "**/*.test.ts"]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencodekit",
-	"version": "0.16.0",
+	"version": "0.16.1",
 	"description": "CLI tool for bootstrapping and managing OpenCodeKit projects",
 	"keywords": ["agents", "cli", "mcp", "opencode", "opencodekit", "template"],
 	"license": "MIT",

package/dist/template/.opencode/memory/_templates/README.md

@@ -1,73 +0,0 @@
----
-purpose: Index of available memory templates
-updated: 2026-02-01
----
-
-# Memory Templates
-
-Templates for structured artifacts. Copy to `.beads/artifacts/<bead-id>/` when working on a bead.
-
-## Artifact Templates (OpenSpec-aligned)
-
-These follow the OpenSpec artifact flow: proposal → spec → design → tasks.
-
-| Template      | Purpose                            | When to Use                                   |
-| ------------- | ---------------------------------- | --------------------------------------------- |
-| `proposal.md` | Capture WHY a change is needed     | Starting a new feature or significant change  |
-| `spec.md`     | Define WHAT with WHEN/THEN format  | After proposal, before design                 |
-| `tasks.md`    | Implementation checklist           | After design, before coding                   |
-| `prd.md`      | Combined PRD (proposal+spec+tasks) | Quick features that don't need full breakdown |
-| `design.md`   | Architecture decisions             | Complex features needing design exploration   |
-
-## Context Injection
-
-The file `.opencode/memory/project/tech-stack.md` is auto-injected into all AI prompts via `opencode.json` instructions[].
-
-| File            | Purpose                             |
-| --------------- | ----------------------------------- |
-| `tech-stack.md` | Framework, DB, styling, constraints |
-
-**Additional context is captured organically:**
-
-- AI discovers commands by reading package.json and running them
-- AI captures conventions via `observation` tool as it works
-- AI captures gotchas via `observation` tool when encountering issues
-- Architecture learnings are saved to `.opencode/memory/observations/`
-
-## Usage
-
-### For Beads Work
-
-```bash
-# Copy artifact templates to bead folder
-cp .opencode/memory/_templates/proposal.md .beads/artifacts/<bead-id>/
-cp .opencode/memory/_templates/spec.md .beads/artifacts/<bead-id>/
-```
-
-### For Project Documentation
-
-```bash
-# Fill in tech-stack.md when starting a new project
-# Other project knowledge is captured via observation tool
-```
-
-## Template Philosophy
-
-**Minimal scaffolds, not rigid forms.**
-
-- Templates are starting points, not constraints
-- Fill in what's relevant, delete what's not
-- WHEN/THEN format in specs enables testable requirements
-- Numbered tasks in `tasks.md` are machine-parseable
-- Let AI learn organically rather than pre-filling empty templates
-
-## OpenSpec Alignment
-
-Our templates are inspired by [OpenSpec](https://github.com/Fission-AI/OpenSpec) patterns:
-
-- **Proposal** → Captures motivation and impact
-- **Spec** → Behavioral requirements with scenarios
-- **Tasks** → Numbered, checkboxed implementation steps
-- **Context injection** → Project info in all prompts
-
-Key difference: We're AI-native (no CLI), so templates are simpler and commands provide the detailed guidance that OpenSpec puts in `schema.yaml` instructions.

package/dist/template/.opencode/memory/_templates/observation.md

@@ -1,39 +0,0 @@
-# Observation Template
-
-**Type:** [decision | bugfix | feature | pattern | discovery | learning | warning]
-**Created:** [timestamp]
-**Bead:** [optional bead-id]
-**Concepts:** `tag1`, `tag2`, `tag3`
-**Files:** `path/to/file1.ts`, `path/to/file2.ts`
-
----
-
-## Context
-
-[What situation prompted this observation? What were you working on?]
-
-## Observation
-
-[The core insight, decision, or learning. Be specific and actionable.]
-
-## Rationale
-
-[Why is this important? What alternatives were considered?]
-
-## Future Reference
-
-[How should this inform future decisions? Any follow-up actions?]
-
----
-
-## Type Definitions
-
-| Type      | Icon | Use For                              |
-| --------- | ---- | ------------------------------------ |
-| decision  | 🎯   | Architectural or design choices made |
-| bugfix    | 🐛   | Bug root causes and solutions        |
-| feature   | ✨   | Feature implementation notes         |
-| pattern   | 🔄   | Recurring patterns or conventions    |
-| discovery | 💡   | Unexpected findings or insights      |
-| learning  | 📚   | Lessons learned from experience      |
-| warning   | ⚠️   | Pitfalls to avoid, gotchas           |