opencodekit 0.14.0 → 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-search.ts

@@ -246,7 +246,7 @@ function formatKeywordResults(
 		) {
 			const lineNum = result.matches[0]?.line;
 			if (lineNum) {
-				output += `\n🔍 **LSP Nudge:**\n`;
+				output += "\n🔍 **LSP Nudge:**\n";
 				output += `  \`lsp_lsp_goto_definition({ filePath: "${result.file}", line: ${lineNum}, character: 1 })\`\n`;
 			}
 		}
@@ -297,7 +297,7 @@ function formatSemanticResults(
 			result.file.endsWith(".go") ||
 			result.file.endsWith(".rs")
 		) {
-			output += `\n🔍 **LSP Nudge:**\n`;
+			output += "\n🔍 **LSP Nudge:**\n";
 			output += `  Get symbols: \`lsp_lsp_document_symbols({ filePath: "${result.file}" })\`\n`;
 			output += `  Find references: \`lsp_lsp_find_references({ filePath: "${result.file}", line: 1, character: 1 })\`\n`;
 		}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencodekit",
-	"version": "0.14.0",
+	"version": "0.14.1",
 	"description": "CLI tool for bootstrapping and managing OpenCodeKit projects",
 	"type": "module",
 	"repository": {
@@ -14,10 +14,7 @@
 	"bin": {
 		"ock": "dist/index.js"
 	},
-	"files": [
-		"dist",
-		"README.md"
-	],
+	"files": ["dist", "README.md"],
 	"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/",
@@ -29,14 +26,7 @@
 		"lint": "biome check .",
 		"lint:fix": "biome check --fix ."
 	},
-	"keywords": [
-		"cli",
-		"opencodekit",
-		"template",
-		"agents",
-		"mcp",
-		"opencode"
-	],
+	"keywords": ["cli", "opencodekit", "template", "agents", "mcp", "opencode"],
 	"author": "OpenCodeKit",
 	"license": "MIT",
 	"engines": {
@@ -62,7 +52,5 @@
 		"@types/node": "^22.10.1",
 		"typescript": "^5.7.2"
 	},
-	"trustedDependencies": [
-		"@beads/bd"
-	]
+	"trustedDependencies": ["@beads/bd"]
 }