opencodekit 0.13.2 → 0.14.1

package/dist/template/.opencode/skill/finishing-a-development-branch/SKILL.md

@@ -25,6 +25,7 @@ npm test / cargo test / pytest / go test ./...
 ```
 
 **If tests fail:**
+
 ```
 Tests failing (<N> failures). Must fix before completing:
 
@@ -48,17 +49,29 @@ Or ask: "This branch split from main - is that correct?"
 
 ### Step 3: Present Options
 
-Present exactly these 4 options:
-
-```
-Implementation complete. What would you like to do?
-
-1. Merge back to <base-branch> locally
-2. Push and create a Pull Request
-3. Keep the branch as-is (I'll handle it later)
-4. Discard this work
-
-Which option?
+Use question tool to present completion options:
+
+```typescript
+question({
+  questions: [
+    {
+      header: "Complete",
+      question: "Implementation complete. What would you like to do?",
+      options: [
+        {
+          label: "Merge locally (Recommended)",
+          description: "Merge to base branch",
+        },
+        {
+          label: "Push & create PR",
+          description: "Create pull request for review",
+        },
+        { label: "Keep branch", description: "I'll handle it later" },
+        { label: "Discard work", description: "Delete this branch" },
+      ],
+    },
+  ],
+});
 ```
 
 **Don't add explanation** - keep options concise.
@@ -114,6 +127,7 @@ Report: "Keeping branch <name>. Worktree preserved at <path>."
 #### Option 4: Discard
 
 **Confirm first:**
+
 ```
 This will permanently delete:
 - Branch <name>
@@ -126,6 +140,7 @@ Type 'discard' to confirm.
 Wait for exact confirmation.
 
 If confirmed:
+
 ```bash
 git checkout <base-branch>
 git branch -D <feature-branch>
@@ -138,11 +153,13 @@ Then: Cleanup worktree (Step 5)
 **For Options 1, 2, 4:**
 
 Check if in worktree:
+
 ```bash
 git worktree list | grep $(git branch --show-current)
 ```
 
 If yes:
+
 ```bash
 git worktree remove <worktree-path>
 ```
@@ -151,40 +168,46 @@ git worktree remove <worktree-path>
 
 ## Quick Reference
 
-| Option | Merge | Push | Keep Worktree | Cleanup Branch |
-|--------|-------|------|---------------|----------------|
-| 1. Merge locally | ✓ | - | - | ✓ |
-| 2. Create PR | - | ✓ | ✓ | - |
-| 3. Keep as-is | - | - | ✓ | - |
-| 4. Discard | - | - | - | ✓ (force) |
+| Option           | Merge | Push | Keep Worktree | Cleanup Branch |
+| ---------------- | ----- | ---- | ------------- | -------------- |
+| 1. Merge locally | ✓     | -    | -             | ✓              |
+| 2. Create PR     | -     | ✓    | ✓             | -              |
+| 3. Keep as-is    | -     | -    | ✓             | -              |
+| 4. Discard       | -     | -    | -             | ✓ (force)      |
 
 ## Common Mistakes
 
 **Skipping test verification**
+
 - **Problem:** Merge broken code, create failing PR
 - **Fix:** Always verify tests before offering options
 
 **Open-ended questions**
+
 - **Problem:** "What should I do next?" → ambiguous
 - **Fix:** Present exactly 4 structured options
 
 **Automatic worktree cleanup**
+
 - **Problem:** Remove worktree when might need it (Option 2, 3)
 - **Fix:** Only cleanup for Options 1 and 4
 
 **No confirmation for discard**
+
 - **Problem:** Accidentally delete work
 - **Fix:** Require typed "discard" confirmation
 
 ## Red Flags
 
 **Never:**
+
 - Proceed with failing tests
 - Merge without verifying tests on result
 - Delete work without confirmation
 - Force-push without explicit request
 
 **Always:**
+
 - Verify tests before offering options
 - Present exactly 4 options
 - Get typed confirmation for Option 4
@@ -193,8 +216,10 @@ git worktree remove <worktree-path>
 ## Integration
 
 **Called by:**
+
 - **subagent-driven-development** (Step 7) - After all tasks complete
 - **executing-plans** (Step 5) - After all batches complete
 
 **Pairs with:**
+
 - **using-git-worktrees** - Cleans up worktree created by that skill

package/dist/template/.opencode/skill/playwright/SKILL.md

@@ -1,173 +1,106 @@
 ---
 name: playwright
 description: Browser automation with Playwright MCP. Test pages, fill forms, take screenshots, check responsive design, validate UX, test login flows. Use when user wants to test websites or automate browser interactions.
-mcp:
-  playwright:
-    command: npx
-    args: ["@playwright/mcp@latest"]
 ---
 
 # Playwright Browser Automation (MCP)
 
-Browser automation via Playwright MCP server. When this skill is loaded, the `playwright` MCP server auto-starts and exposes browser tools.
-
-## Quick Start
-
-After loading this skill, use `skill_mcp` to invoke browser tools:
-
-```
-skill_mcp(mcp_name="playwright", tool_name="browser_navigate", arguments='{"url": "https://example.com"}')
-```
+Browser automation via Playwright MCP server for testing and automation.
 
 ## Available Tools
 
-### Navigation & Page
-
-| Tool                 | Description            | Arguments                           |
-| -------------------- | ---------------------- | ----------------------------------- |
-| `browser_navigate`   | Navigate to URL        | `{"url": "https://..."}`            |
-| `browser_go_back`    | Go back                | `{}`                                |
-| `browser_go_forward` | Go forward             | `{}`                                |
-| `browser_wait_for`   | Wait for text/selector | `{"text": "...", "timeout": 10000}` |
-
-### Interaction
-
-| Tool                    | Description               | Arguments                                                                          |
-| ----------------------- | ------------------------- | ---------------------------------------------------------------------------------- |
-| `browser_click`         | Click element             | `{"element": "Submit button", "ref": "e123"}`                                      |
-| `browser_type`          | Type text                 | `{"element": "Search input", "ref": "e456", "text": "query"}`                      |
-| `browser_fill`          | Fill input (clears first) | `{"element": "Email field", "ref": "e789", "text": "test@example.com"}`            |
-| `browser_select_option` | Select dropdown option    | `{"element": "Country", "ref": "e012", "values": ["US"]}`                          |
-| `browser_hover`         | Hover over element        | `{"element": "Menu", "ref": "e345"}`                                               |
-| `browser_drag`          | Drag and drop             | `{"startElement": "...", "startRef": "...", "endElement": "...", "endRef": "..."}` |
-
-### Screenshots & Content
-
-| Tool                      | Description                     | Arguments                              |
-| ------------------------- | ------------------------------- | -------------------------------------- |
-| `browser_take_screenshot` | Capture screenshot              | `{"filename": "screenshot.png"}`       |
-| `browser_snapshot`        | Get page accessibility snapshot | `{}`                                   |
-| `browser_evaluate`        | Run JavaScript                  | `{"function": "() => document.title"}` |
-| `browser_pdf_save`        | Save page as PDF                | `{"filename": "page.pdf"}`             |
-
-### Viewport & Device
-
-| Tool             | Description     | Arguments                                                    |
-| ---------------- | --------------- | ------------------------------------------------------------ |
-| `browser_resize` | Resize viewport | `{"width": 375, "height": 667}` or `{"device": "iPhone 13"}` |
-
-### Tabs
-
-| Tool                 | Description    | Arguments                |
-| -------------------- | -------------- | ------------------------ |
-| `browser_tab_list`   | List open tabs | `{}`                     |
-| `browser_tab_new`    | Open new tab   | `{"url": "https://..."}` |
-| `browser_tab_select` | Switch to tab  | `{"index": 0}`           |
-| `browser_tab_close`  | Close tab      | `{"index": 0}`           |
+- `browser_navigate` - Navigate to URL
+- `browser_snapshot` - Get page accessibility snapshot with element refs
+- `browser_take_screenshot` - Capture screenshot
+- `browser_click` - Click element by ref
+- `browser_type` - Type text (appends to existing)
+- `browser_fill` - Fill input (clears first, then types)
+- `browser_wait_for` - Wait for text or selector
+- `browser_resize` - Resize viewport or emulate device
 
 ## Workflow
 
-1. **Navigate** to the target URL
-2. **Snapshot** to see page structure and element refs
-3. **Interact** using element refs from snapshot
-4. **Screenshot** to capture results
-
-## Examples
+1. **Navigate** to the target URL using `browser_navigate`
+2. **Snapshot** to see page structure and element refs using `browser_snapshot`
+3. **Interact** using element refs from snapshot (`browser_click`, `browser_fill`)
+4. **Screenshot** to capture results using `browser_take_screenshot`
 
-### Test a Page
+## Quick Start
 
 ```
-# Navigate
-skill_mcp(mcp_name="playwright", tool_name="browser_navigate", arguments='{"url": "http://localhost:3000"}')
+# Navigate to page
+skill_mcp(skill_name="playwright", tool_name="browser_navigate", arguments='{"url": "https://example.com"}')
 
-# Get page snapshot (shows elements with refs)
-skill_mcp(mcp_name="playwright", tool_name="browser_snapshot")
+# Get page structure with element refs
+skill_mcp(skill_name="playwright", tool_name="browser_snapshot")
 
-# Take screenshot
-skill_mcp(mcp_name="playwright", tool_name="browser_take_screenshot", arguments='{"filename": "/tmp/homepage.png"}')
-```
+# Click element (use ref from snapshot)
+skill_mcp(skill_name="playwright", tool_name="browser_click", arguments='{"element": "Submit button", "ref": "e123"}')
 
-### Fill a Form
+# Fill input field
+skill_mcp(skill_name="playwright", tool_name="browser_fill", arguments='{"element": "Email", "ref": "e456", "text": "test@example.com"}')
 
+# Take screenshot
+skill_mcp(skill_name="playwright", tool_name="browser_take_screenshot", arguments='{"filename": "/tmp/result.png"}')
 ```
-# Navigate to form
-skill_mcp(mcp_name="playwright", tool_name="browser_navigate", arguments='{"url": "http://localhost:3000/contact"}')
-
-# Get snapshot to find element refs
-skill_mcp(mcp_name="playwright", tool_name="browser_snapshot")
-
-# Fill fields (use refs from snapshot)
-skill_mcp(mcp_name="playwright", tool_name="browser_fill", arguments='{"element": "Name input", "ref": "e12", "text": "John Doe"}')
-skill_mcp(mcp_name="playwright", tool_name="browser_fill", arguments='{"element": "Email input", "ref": "e34", "text": "john@example.com"}')
 
-# Submit
-skill_mcp(mcp_name="playwright", tool_name="browser_click", arguments='{"element": "Submit button", "ref": "e56"}')
-```
+## Examples
 
 ### Test Responsive Design
 
 ```
 # Navigate
-skill_mcp(mcp_name="playwright", tool_name="browser_navigate", arguments='{"url": "http://localhost:3000"}')
+skill_mcp(skill_name="playwright", tool_name="browser_navigate", arguments='{"url": "http://localhost:3000"}')
 
 # Desktop
-skill_mcp(mcp_name="playwright", tool_name="browser_resize", arguments='{"width": 1920, "height": 1080}')
-skill_mcp(mcp_name="playwright", tool_name="browser_take_screenshot", arguments='{"filename": "/tmp/desktop.png"}')
-
-# Tablet
-skill_mcp(mcp_name="playwright", tool_name="browser_resize", arguments='{"device": "iPad Pro 11"}')
-skill_mcp(mcp_name="playwright", tool_name="browser_take_screenshot", arguments='{"filename": "/tmp/tablet.png"}')
+skill_mcp(skill_name="playwright", tool_name="browser_resize", arguments='{"width": 1920, "height": 1080}')
+skill_mcp(skill_name="playwright", tool_name="browser_take_screenshot", arguments='{"filename": "/tmp/desktop.png"}')
 
 # Mobile
-skill_mcp(mcp_name="playwright", tool_name="browser_resize", arguments='{"device": "iPhone 13"}')
-skill_mcp(mcp_name="playwright", tool_name="browser_take_screenshot", arguments='{"filename": "/tmp/mobile.png"}')
+skill_mcp(skill_name="playwright", tool_name="browser_resize", arguments='{"device": "iPhone 13"}')
+skill_mcp(skill_name="playwright", tool_name="browser_take_screenshot", arguments='{"filename": "/tmp/mobile.png"}')
 ```
 
-### Test Login Flow
+### Fill a Form
 
 ```
-# Navigate to login
-skill_mcp(mcp_name="playwright", tool_name="browser_navigate", arguments='{"url": "http://localhost:3000/login"}')
-
-# Snapshot to get refs
-skill_mcp(mcp_name="playwright", tool_name="browser_snapshot")
-
-# Fill credentials
-skill_mcp(mcp_name="playwright", tool_name="browser_fill", arguments='{"element": "Email", "ref": "e10", "text": "test@example.com"}')
-skill_mcp(mcp_name="playwright", tool_name="browser_fill", arguments='{"element": "Password", "ref": "e20", "text": "password123"}')
-
-# Click login
-skill_mcp(mcp_name="playwright", tool_name="browser_click", arguments='{"element": "Login button", "ref": "e30"}')
+# Navigate to form
+skill_mcp(skill_name="playwright", tool_name="browser_navigate", arguments='{"url": "http://localhost:3000/contact"}')
 
-# Wait for redirect
-skill_mcp(mcp_name="playwright", tool_name="browser_wait_for", arguments='{"text": "Dashboard", "timeout": 10000}')
+# Get element refs
+skill_mcp(skill_name="playwright", tool_name="browser_snapshot")
 
-# Screenshot success
-skill_mcp(mcp_name="playwright", tool_name="browser_take_screenshot", arguments='{"filename": "/tmp/logged-in.png"}')
-```
+# Fill fields (use refs from snapshot)
+skill_mcp(skill_name="playwright", tool_name="browser_fill", arguments='{"element": "Name", "ref": "e12", "text": "John Doe"}')
+skill_mcp(skill_name="playwright", tool_name="browser_fill", arguments='{"element": "Email", "ref": "e34", "text": "john@example.com"}')
 
-### Run JavaScript
+# Submit
+skill_mcp(skill_name="playwright", tool_name="browser_click", arguments='{"element": "Submit", "ref": "e56"}')
 
+# Wait for confirmation
+skill_mcp(skill_name="playwright", tool_name="browser_wait_for", arguments='{"text": "Thank you", "timeout": 5000}')
 ```
-# Get page title
-skill_mcp(mcp_name="playwright", tool_name="browser_evaluate", arguments='{"function": "() => document.title"}')
 
-# Get all links
-skill_mcp(mcp_name="playwright", tool_name="browser_evaluate", arguments='{"function": "() => Array.from(document.querySelectorAll(\"a\")).map(a => a.href)"}')
+## Tips
 
-# Scroll to bottom
-skill_mcp(mcp_name="playwright", tool_name="browser_evaluate", arguments='{"function": "() => window.scrollTo(0, document.body.scrollHeight)"}')
-```
+- **Always snapshot first** to get element refs before interacting
+- **Use descriptive element names** in click/fill for clarity
+- **Save screenshots to /tmp** for easy access
+- **Use device presets** for accurate mobile emulation
+- **Chain wait_for** after navigation for dynamic pages
 
 ## Server Options
 
-For advanced usage, modify the MCP args in frontmatter:
+For advanced usage, modify `mcp.json`:
 
-```yaml
-mcp:
-  playwright:
-    command: npx
-    args: ["@playwright/mcp@latest", "--headless", "--browser=firefox"]
+```json
+{
+  "playwright": {
+    "command": "npx",
+    "args": ["@playwright/mcp@latest", "--headless", "--browser=firefox"],
+    "includeTools": ["browser_navigate", "browser_snapshot", "..."]
+  }
+}
 ```
 
 Common options:
@@ -175,13 +108,5 @@ Common options:
 - `--headless` - Run without visible browser
 - `--browser=chrome|firefox|webkit` - Choose browser
 - `--device="iPhone 13"` - Emulate device
-- `--viewport-size=1280x720` - Set viewport
-- `--user-data-dir=/path` - Persist browser data
 
-## Tips
-
-- **Always snapshot first** to get element refs before interacting
-- **Use descriptive element names** in click/fill for clarity
-- **Save screenshots to /tmp** for easy access
-- **Use device presets** for accurate mobile emulation
-- **Chain wait_for** after navigation for dynamic pages
+> **Note**: This skill loads 8 essential tools. For full 17+ tools (tabs, PDF, evaluate, drag), modify `mcp.json` to add more tools to `includeTools`.

package/dist/template/.opencode/skill/playwright/mcp.json

@@ -0,0 +1,16 @@
+{
+	"playwright": {
+		"command": "npx",
+		"args": ["@playwright/mcp@latest"],
+		"includeTools": [
+			"browser_navigate",
+			"browser_snapshot",
+			"browser_take_screenshot",
+			"browser_click",
+			"browser_type",
+			"browser_fill",
+			"browser_wait_for",
+			"browser_resize"
+		]
+	}
+}

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

@@ -0,0 +1,183 @@
+import { tool } from "@opencode-ai/plugin";
+
+// Configuration - Qwen3-Embedding-0.6B
+// Better for code, multilingual (100+ langs), instruction-aware
+// See: https://ollama.com/library/qwen3-embedding
+const OLLAMA_MODEL = "qwen3-embedding:0.6b";
+const OLLAMA_DIMENSIONS = 1024;
+const OLLAMA_BASE_URL = process.env.OLLAMA_HOST || "http://127.0.0.1:11434";
+
+interface EmbeddingResult {
+	text: string;
+	embedding: number[];
+	model: string;
+	dimensions: number;
+}
+
+interface BatchEmbeddingResult {
+	results: EmbeddingResult[];
+	failed: { text: string; error: string }[];
+	model: string;
+}
+
+async function checkOllamaRunning(): Promise<boolean> {
+	try {
+		const response = await fetch(`${OLLAMA_BASE_URL}/api/version`, {
+			method: "GET",
+			signal: AbortSignal.timeout(3000),
+		});
+		return response.ok;
+	} catch {
+		return false;
+	}
+}
+
+async function ensureModelAvailable(): Promise<{
+	ok: boolean;
+	error?: string;
+}> {
+	try {
+		const listResponse = await fetch(`${OLLAMA_BASE_URL}/api/tags`, {
+			method: "GET",
+			signal: AbortSignal.timeout(5000),
+		});
+
+		if (!listResponse.ok) {
+			return { ok: false, error: "Failed to list models" };
+		}
+
+		const data = (await listResponse.json()) as {
+			models?: { name: string }[];
+		};
+		const models = data.models || [];
+		const modelExists = models.some(
+			(m) => m.name === OLLAMA_MODEL || m.name === `${OLLAMA_MODEL}:latest`,
+		);
+
+		if (modelExists) {
+			return { ok: true };
+		}
+
+		return {
+			ok: false,
+			error: `Model '${OLLAMA_MODEL}' not found. Run: ollama pull ${OLLAMA_MODEL}`,
+		};
+	} catch (err) {
+		const message = err instanceof Error ? err.message : String(err);
+		return { ok: false, error: `Failed to check models: ${message}` };
+	}
+}
+
+async function embedWithOllama(
+	texts: string[],
+): Promise<{ embeddings: number[][]; error?: string }> {
+	try {
+		const embeddings: number[][] = [];
+
+		for (const text of texts) {
+			const response = await fetch(`${OLLAMA_BASE_URL}/api/embeddings`, {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify({
+					model: OLLAMA_MODEL,
+					prompt: text,
+				}),
+				signal: AbortSignal.timeout(30000),
+			});
+
+			if (!response.ok) {
+				const errorText = await response.text();
+				return {
+					embeddings: [],
+					error: `Ollama API error (${response.status}): ${errorText}`,
+				};
+			}
+
+			const data = (await response.json()) as { embedding?: number[] };
+			if (!data.embedding) {
+				return { embeddings: [], error: "No embedding in response" };
+			}
+
+			embeddings.push(data.embedding);
+		}
+
+		return { embeddings };
+	} catch (err) {
+		const message = err instanceof Error ? err.message : String(err);
+
+		if (message.includes("ECONNREFUSED") || message.includes("fetch failed")) {
+			return {
+				embeddings: [],
+				error: "Cannot connect to Ollama. See .opencode/README.md for setup.",
+			};
+		}
+
+		return { embeddings: [], error: `Ollama error: ${message}` };
+	}
+}
+
+export default tool({
+	description: `Generate embeddings using Ollama (${OLLAMA_MODEL}). Requires Ollama running locally.`,
+	args: {
+		text: tool.schema
+			.union([tool.schema.string(), tool.schema.array(tool.schema.string())])
+			.describe("Text or array of texts to embed"),
+	},
+	execute: async (args: { text: string | string[] }) => {
+		const texts = Array.isArray(args.text) ? args.text : [args.text];
+
+		if (texts.length === 0) {
+			return "Error: No text provided";
+		}
+
+		const maxChars = 32000;
+		const longTexts = texts.filter((t) => t.length > maxChars);
+		if (longTexts.length > 0) {
+			return `Error: ${longTexts.length} text(s) exceed ${maxChars} char limit`;
+		}
+
+		const ollamaRunning = await checkOllamaRunning();
+		if (!ollamaRunning) {
+			return "Error: Ollama not running. See .opencode/README.md for setup.";
+		}
+
+		const modelCheck = await ensureModelAvailable();
+		if (!modelCheck.ok) {
+			return `Error: ${modelCheck.error}. See .opencode/README.md for setup.`;
+		}
+
+		const result = await embedWithOllama(texts);
+
+		if (result.error) {
+			return `Error: ${result.error}`;
+		}
+
+		const response: BatchEmbeddingResult = {
+			results: texts.map((text, i) => ({
+				text: text.substring(0, 100) + (text.length > 100 ? "..." : ""),
+				embedding: result.embeddings[i],
+				model: OLLAMA_MODEL,
+				dimensions: OLLAMA_DIMENSIONS,
+			})),
+			failed: [],
+			model: OLLAMA_MODEL,
+		};
+
+		return JSON.stringify(response, null, 2);
+	},
+});
+
+// Export for other tools (memory-index, observation)
+export async function generateEmbedding(
+	text: string,
+): Promise<{ embedding: number[]; model: string } | null> {
+	const ollamaRunning = await checkOllamaRunning();
+	if (!ollamaRunning) return null;
+
+	const result = await embedWithOllama([text]);
+	if (result.error || result.embeddings.length === 0) return null;
+
+	return { embedding: result.embeddings[0], model: OLLAMA_MODEL };
+}
+
+export const EMBEDDING_DIMENSIONS = OLLAMA_DIMENSIONS;