opencodekit 0.15.21 → 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.15.21",
+	"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/command/accessibility-check.md

@@ -1,331 +0,0 @@
----
-description: WCAG accessibility audit
-argument-hint: "<image-or-component-path> [level: A|AA|AAA]"
-agent: vision
-model: proxypal/gemini-3-flash-preview
-subtask: true
----
-
-# Accessibility Check: $ARGUMENTS
-
-## Phase 1: Load Context
-
-**Load skills:**
-
-````typescript
-skill({ name: "beads" });            // Session protocol
-skill({ name: "accessibility-audit" });
-
-```typescript
-skill({ name: "accessibility-audit" });
-````
-
-**Check for bead context:**
-
-!`bd show $ARGUMENTS` # If bead ID provided
-
-Parse path and WCAG level from `$ARGUMENTS` (default: AA).
-
-## Phase 2: Estimate Complexity
-
-| Signals                        | Estimate | Approach        |
-| ------------------------------ | -------- | --------------- |
-| Single component, few elements | S (~10)  | Quick audit     |
-| Page with multiple components  | M (~30)  | Full audit      |
-| Complex app, multiple pages    | L (~100) | Comprehensive   |
-| Design system audit            | XL       | Systematic scan |
-
-## Phase 3: Determine Input Type
-
-- **Image/screenshot**: Visual accessibility analysis (Phase 4)
-- **Component path**: Code accessibility patterns (Phase 5)
-- **URL**: Run automated + visual analysis (Phase 4 + 5)
-
-## Phase 4: Visual Analysis
-
-### Color & Contrast
-
-| Check                    | WCAG Ref    | Requirement                  |
-| ------------------------ | ----------- | ---------------------------- |
-| Text contrast            | 1.4.3 (AA)  | 4.5:1 normal, 3:1 large text |
-| UI component contrast    | 1.4.11 (AA) | 3:1 against adjacent colors  |
-| Focus indicator contrast | 1.4.11 (AA) | 3:1 contrast                 |
-| Color-only information   | 1.4.1 (A)   | Don't rely on color alone    |
-
-### Touch & Interaction
-
-| Check             | WCAG Ref    | Requirement                |
-| ----------------- | ----------- | -------------------------- |
-| Touch target size | 2.5.5 (AAA) | ≥44x44px (≥24x24 for AA)   |
-| Target spacing    | 2.5.8 (AA)  | Adequate spacing between   |
-| Pointer gestures  | 2.5.1 (A)   | Single pointer alternative |
-
-### Visual Structure
-
-| Check             | WCAG Ref    | Requirement                   |
-| ----------------- | ----------- | ----------------------------- |
-| Heading hierarchy | 1.3.1 (A)   | Logical heading order         |
-| Reading order     | 1.3.2 (A)   | Meaningful sequence           |
-| Text spacing      | 1.4.12 (AA) | Adjustable without loss       |
-| Reflow            | 1.4.10 (AA) | No horizontal scroll at 320px |
-
-### Motion & Animation
-
-| Check                   | WCAG Ref    | Requirement                     |
-| ----------------------- | ----------- | ------------------------------- |
-| Motion from interaction | 2.3.3 (AAA) | Can be disabled                 |
-| Reduced motion          | 2.3.3       | Respects prefers-reduced-motion |
-| Auto-playing media      | 1.4.2 (A)   | Pause/stop/hide controls        |
-| Flashing content        | 2.3.1 (A)   | No more than 3 flashes/second   |
-
-## Phase 5: Code Analysis
-
-### Automated Testing
-
-Run axe-core or Lighthouse:
-
-```bash
-# Using Lighthouse
-npx lighthouse <url> --only-categories=accessibility --output=json
-
-# Using axe-core in tests
-npm install -D @axe-core/playwright  # or jest-axe
-```
-
-```typescript
-// Playwright + axe example
-import { injectAxe, checkA11y } from "@axe-core/playwright";
-
-await injectAxe(page);
-await checkA11y(page);
-```
-
-### Semantic HTML Checks
-
-```typescript
-// Find images without alt text
-ast - grep({ pattern: "<img $$$>" }); // Check for alt attribute
-
-// Find click handlers on non-interactive elements
-ast - grep({ pattern: "<div onClick={$$$}>" });
-ast - grep({ pattern: "<span onClick={$$$}>" });
-
-// Find form inputs without labels
-ast - grep({ pattern: "<input $$$>" }); // Check for id + matching label
-```
-
-### ARIA Pattern Checks
-
-!`grep -r "role=" --include="*.tsx" --include="*.jsx" | head -20`
-
-| Pattern         | Required ARIA                              |
-| --------------- | ------------------------------------------ |
-| Modal dialog    | role="dialog", aria-modal, aria-labelledby |
-| Dropdown menu   | role="menu", aria-expanded, aria-haspopup  |
-| Tab panel       | role="tablist/tab/tabpanel", aria-selected |
-| Accordion       | aria-expanded, aria-controls               |
-| Alert           | role="alert", aria-live="assertive"        |
-| Toast           | role="status", aria-live="polite"          |
-| Loading spinner | aria-busy, aria-live                       |
-
-### Focus Management
-
-| Check               | Requirement                         |
-| ------------------- | ----------------------------------- |
-| Focus visible       | All interactive elements show focus |
-| Focus order         | Logical tab sequence                |
-| Focus trap (modals) | Focus contained within modal        |
-| Focus restoration   | Focus returns after modal closes    |
-| Skip links          | Skip to main content available      |
-
-!`grep -r ":focus" --include="*.css" | head -10`
-!`grep -r "focus:" --include="*.tsx" | head -10` // Tailwind
-
-## Phase 6: Keyboard Navigation Testing
-
-Test manually or with Playwright:
-
-```typescript
-skill({ name: "playwright" });
-skill_mcp({
-  skill_name: "playwright",
-  tool_name: "browser_press_key",
-  arguments: '{"key": "Tab"}',
-});
-```
-
-| Action     | Expected Behavior                        |
-| ---------- | ---------------------------------------- |
-| Tab        | Moves to next interactive element        |
-| Shift+Tab  | Moves to previous element                |
-| Enter      | Activates buttons, links                 |
-| Space      | Toggles checkboxes, activates buttons    |
-| Arrow keys | Navigate within components (tabs, menus) |
-| Escape     | Closes modals, dropdowns                 |
-
-```
-Keyboard Navigation:
-━━━━━━━━━━━━━━━━━━━━
-
-- Tab order: [logical/broken at X]
-- Focus visible: [all/missing on X]
-- Enter/Space: [working/broken on X]
-- Escape: [working/not implemented]
-- Skip link: [present/missing]
-```
-
-## Phase 7: Screen Reader Guidance
-
-For manual testing, suggest:
-
-| Platform | Screen Reader | Command to Start         |
-| -------- | ------------- | ------------------------ |
-| macOS    | VoiceOver     | Cmd + F5                 |
-| Windows  | NVDA          | Ctrl + Alt + N           |
-| Windows  | Narrator      | Win + Ctrl + Enter       |
-| iOS      | VoiceOver     | Settings > Accessibility |
-| Android  | TalkBack      | Settings > Accessibility |
-
-**Key things to verify:**
-
-- [ ] All content is announced
-- [ ] Images have meaningful alt text
-- [ ] Form fields announce labels
-- [ ] Error messages are announced
-- [ ] Dynamic content updates are announced (aria-live)
-
-## Phase 8: Generate Report
-
-````markdown
-## Accessibility Audit: [Component/Page]
-
-**WCAG Level:** [A/AA/AAA]
-**Automated Score:** [Lighthouse score if available]
-
-### Summary
-
-| Category       | Critical | Major | Minor | Passed |
-| -------------- | -------- | ----- | ----- | ------ |
-| Perceivable    | [N]      | [N]   | [N]   | [N]    |
-| Operable       | [N]      | [N]   | [N]   | [N]    |
-| Understandable | [N]      | [N]   | [N]   | [N]    |
-| Robust         | [N]      | [N]   | [N]   | [N]    |
-
-### Critical Issues (Must Fix)
-
-#### [Issue Title]
-
-- **WCAG:** [criterion number and name]
-- **Location:** [file:line or element description]
-- **Problem:** [description]
-- **Fix:**
-
-```[language]
-[code fix]
-```
-````
-
-### Major Issues
-
-[Same format]
-
-### Minor Issues
-
-[Same format]
-
-### Passed Checks
-
-- Color contrast: [ratio] meets [level]
-- Touch targets: [size] meets requirement
-- Heading structure: Logical hierarchy
-- Keyboard navigation: All elements reachable
-- Focus indicators: Visible on all elements
-
-````
-
-## Phase 9: Create Observation
-
-If patterns discovered:
-
-```typescript
-observation({
-  type: "pattern",
-  title: "A11y pattern: [name]",
-  content: `
-## Pattern
-[Description of accessibility pattern]
-
-## Implementation
-\`\`\`tsx
-[Accessible code example]
-\`\`\`
-
-## Common Mistakes
-- [What to avoid]
-  `,
-  concepts: "accessibility, wcag, [specific area]",
-  bead_id: "<bead-id>",
-});
-````
-
-## Phase 10: Verify Fixes
-
-After fixes applied, re-run checks:
-
-```bash
-npx lighthouse <url> --only-categories=accessibility
-```
-
-```
-Verification:
-━━━━━━━━━━━━━
-
-Before: [N] issues
-After: [N] issues
-Resolved: [N]
-
-Remaining:
-- [Any outstanding issues]
-```
-
-## Phase 11: Sync
-
-```bash
-bd sync
-```
-
-## Output
-
-```
-Accessibility Audit Complete: $ARGUMENTS
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-WCAG Level: [AA]
-Estimate: [S/M/L]
-
-Results:
-- Critical: [N]
-- Major: [N]
-- Minor: [N]
-- Passed: [N]
-
-Automated Score: [N]/100 (Lighthouse)
-
-Key Fixes Needed:
-1. [Most critical issue]
-2. [Second issue]
-3. [Third issue]
-
-Report: .beads/artifacts/<bead-id>/a11y-audit.md (if bead)
-```
-
-**Next steps:**
-
-```
-Fix issues:
-  /fix-ui <bead-id>   # Fix visual issues
-  /fix <bead-id>      # Fix code issues
-
-After fixing:
-  /accessibility-check <path>   # Re-run audit
-```