opencodekit 0.15.4 → 0.15.6

package/dist/template/.opencode/skill/web-design-guidelines/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: web-design-guidelines
+description: Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".
+metadata:
+  author: vercel
+  version: "1.0.0"
+  argument-hint: <file-or-pattern>
+---
+
+# Web Interface Guidelines
+
+Review files for compliance with Web Interface Guidelines.
+
+## How It Works
+
+1. Fetch the latest guidelines from the source URL below
+2. Read the specified files (or prompt user for files/pattern)
+3. Check against all rules in the fetched guidelines
+4. Output findings in the terse `file:line` format
+
+## Guidelines Source
+
+Fetch fresh guidelines before each review:
+
+```
+https://raw.githubusercontent.com/vercel-labs/web-interface-guidelines/main/command.md
+```
+
+Use WebFetch to retrieve the latest rules. The fetched content contains all the rules and output format instructions.
+
+## Usage
+
+When a user provides a file or pattern argument:
+1. Fetch guidelines from the source URL above
+2. Read the specified files
+3. Apply all rules from the fetched guidelines
+4. Output findings using the format specified in the guidelines
+
+If no files specified, ask the user which files to review.

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

@@ -3,52 +3,72 @@ import path from "node:path";
 import { tool } from "@opencode-ai/plugin";
 
 export default tool({
-  description:
-    "Read memory files for persistent cross-session context. Returns current project state, learnings, and active tasks. Supports subdirectories (e.g., 'research/opencode-sessions').",
-  args: {
-    file: tool.schema
-      .string()
-      .optional()
-      .describe(
-        "Memory file to read: handoffs/YYYY-MM-DD-phase, research/YYYY-MM-DD-topic, _templates/task-prd, _templates/task-spec, _templates/task-review, _templates/research, _templates/handoff",
-      ),
-  },
-  execute: async (args: { file?: string }) => {
-    const fileName = args.file || "memory";
+	description: `Read memory files for persistent cross-session context.
+	
+	Purpose:
+	- Retrieve project state, learnings, and active tasks
+	- Checks locations in priority order: project → global → legacy
+	- Supports subdirectories: handoffs/, research/, observations/, _templates/
+	
+	Example:
+	memory-read({ file: "handoffs/2024-01-20-phase-1" })
+	memory-read({ file: "_templates/task-prd" })`,
+	args: {
+		file: tool.schema
+			.string()
+			.optional()
+			.describe(
+				"Memory file to read: handoffs/YYYY-MM-DD-phase, research/YYYY-MM-DD-topic, _templates/task-prd, _templates/task-spec, _templates/task-review, _templates/research, _templates/handoff",
+			),
+	},
+	execute: async (args: { file?: string }) => {
+		const fileName = args.file || "memory";
 
-    // Normalize: strip .md extension if present
-    const normalizedFile = fileName.replace(/\.md$/i, "");
+		// Normalize: strip .md extension if present
+		const normalizedFile = fileName.replace(/\.md$/i, "");
 
-    // Location priority: project > global > legacy
-    const locations = [
-      path.join(process.cwd(), ".opencode/memory", `${normalizedFile}.md`),
-      path.join(process.env.HOME || "", ".config/opencode/memory", `${normalizedFile}.md`),
-      path.join(process.cwd(), ".config/opencode/memory", `${normalizedFile}.md`),
-    ];
+		// Location priority: project > global > legacy
+		const locations = [
+			path.join(process.cwd(), ".opencode/memory", `${normalizedFile}.md`),
+			path.join(
+				process.env.HOME || "",
+				".config/opencode/memory",
+				`${normalizedFile}.md`,
+			),
+			path.join(
+				process.cwd(),
+				".config/opencode/memory",
+				`${normalizedFile}.md`,
+			),
+		];
 
-    // Try each location in order
-    for (const filePath of locations) {
-      try {
-        const content = await fs.readFile(filePath, "utf-8");
-        const locationLabel = filePath.includes(".opencode/memory")
-          ? "project"
-          : filePath.includes(process.env.HOME || "")
-            ? "global"
-            : "legacy";
-        return `[Read from ${locationLabel}: ${filePath}]\n\n${content}`;
-      } catch (error) {
-        // Continue to next location if file not found
-        if (error instanceof Error && "code" in error && error.code === "ENOENT") {
-          continue;
-        }
-        // Other errors should be reported
-        if (error instanceof Error) {
-          return `Error reading memory from ${filePath}: ${error.message}`;
-        }
-      }
-    }
+		// Try each location in order
+		for (const filePath of locations) {
+			try {
+				const content = await fs.readFile(filePath, "utf-8");
+				const locationLabel = filePath.includes(".opencode/memory")
+					? "project"
+					: filePath.includes(process.env.HOME || "")
+						? "global"
+						: "legacy";
+				return `[Read from ${locationLabel}: ${filePath}]\n\n${content}`;
+			} catch (error) {
+				// Continue to next location if file not found
+				if (
+					error instanceof Error &&
+					"code" in error &&
+					error.code === "ENOENT"
+				) {
+					continue;
+				}
+				// Other errors should be reported
+				if (error instanceof Error) {
+					return `Error reading memory from ${filePath}: ${error.message}`;
+				}
+			}
+		}
 
-    // No file found in any location
-    return `Memory file '${normalizedFile}.md' not found in any location.\nSearched:\n- ${locations.join("\n- ")}\n\nStructure:\n- handoffs/YYYY-MM-DD-phase (phase transitions)\n- research/YYYY-MM-DD-topic (research findings)\n- _templates/ (prd, spec, review, research, handoff)`;
-  },
+		// No file found in any location
+		return `Memory file '${normalizedFile}.md' not found in any location.\nSearched:\n- ${locations.join("\n- ")}\n\nStructure:\n- handoffs/YYYY-MM-DD-phase (phase transitions)\n- research/YYYY-MM-DD-topic (research findings)\n- _templates/ (prd, spec, review, research, handoff)`;
+	},
 });

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

@@ -127,8 +127,15 @@ function formatKeywordResults(
 }
 
 export default tool({
-	description:
-		"Search across all memory files using keywords. Returns matching files with context. Useful for finding past decisions, research, or handoffs.",
+	description: `Search across all memory files using keywords.
+	
+	Purpose:
+	- Find past decisions, research, or handoffs
+	- Searches: project memory, beads artifacts, and global memory
+	- Returns file paths with matched lines and context
+	
+	Example:
+	memory-search({ query: "authentication", type: "all", limit: 10 })`,
 	args: {
 		query: tool.schema
 			.string()

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

@@ -3,54 +3,66 @@ 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.
+	
+	Purpose:
+	- Write or append to project memory in .opencode/memory/
+	- Supports subdirectories (e.g., 'research/2024-01-topic')
+	- Two modes: 'replace' (overwrite) or 'append' (add to end)
+	
+	Example:
+	memory-update({ file: "research/session-findings", content: "..." })
+	memory-update({ file: "handoffs/phase-2", content: "...", mode: "append" })`,
+	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

@@ -73,8 +73,22 @@ function extractFileReferences(content: string): FileReference[] {
 }
 
 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/.",
+	description: `Create a structured observation for future reference.
+	
+	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
+	
+	Example:
+	observation({
+	  type: "decision",
+	  title: "Use JWT for auth",
+	  content: "Decided to use JWT tokens because...",
+	  concepts: "authentication, jwt, security",
+	  confidence: "high"
+	})`,
 	args: {
 		type: tool.schema
 			.string()

package/package.json

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