opencodekit 0.12.4 → 0.12.5

package/dist/index.js

@@ -750,7 +750,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "opencodekit",
-  version: "0.12.4",
+  version: "0.12.5",
   description: "CLI tool for bootstrapping and managing OpenCodeKit projects",
   type: "module",
   repository: {
@@ -784,7 +784,7 @@ var package_default = {
   },
   dependencies: {
     "@clack/prompts": "^0.7.0",
-    "@opencode-ai/plugin": "^1.0.141",
+    "@opencode-ai/plugin": "^1.1.2",
     "beads-village": "^1.3.3",
     cac: "^6.7.14",
     "cli-table3": "^0.6.5",

package/dist/template/.opencode/command/accessibility-check.md

@@ -21,9 +21,7 @@ skill({ name: "accessibility-audit" });
 
 **Check for bead context:**
 
-```typescript
-bd_show({ id: "$ARGUMENTS" }); // If bead ID provided
-```
+!`bd show $ARGUMENTS` # If bead ID provided
 
 Parse path and WCAG level from `$ARGUMENTS` (default: AA).
 
@@ -117,6 +115,8 @@ 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 |
@@ -137,11 +137,8 @@ ast - grep({ pattern: "<input $$$>" }); // Check for id + matching label
 | Focus restoration   | Focus returns after modal closes    |
 | Skip links          | Skip to main content available      |
 
-```typescript
-// Check for focus styles
-grep({ pattern: ":focus", include: "*.css" });
-grep({ pattern: "focus:", include: "*.tsx" }); // Tailwind
-```
+!`grep -r ":focus" --include="*.css" | head -10`
+!`grep -r "focus:" --include="*.tsx" | head -10` // Tailwind
 
 ## Phase 6: Keyboard Navigation Testing
 
@@ -292,8 +289,8 @@ Remaining:
 
 ## Phase 11: Sync
 
-```typescript
-bd_sync({ reason: "Sync accessibility audit" });
+```bash
+bd sync
 ```
 
 ## Output

package/dist/template/.opencode/command/analyze-mockup.md

@@ -360,22 +360,9 @@ skill({ name: "mockup-to-code" })
 
 **Create Implementation Tasks:**
 
-```
-bd_add({
-  title: "Implement design tokens from mockup",
-  desc: "Extract CSS variables for colors, typography, spacing from [mockup]",
-  type: "task",
-  pri: 1,
-  tags: ["frontend", "design-system"]
-})
-
-bd_add({
-  title: "Implement [ComponentName] component",
-  desc: "Build component matching mockup spec. Variants: [...], States: [...]",
-  type: "task",
-  pri: 2,
-  tags: ["frontend", "component"]
-})
+```bash
+bd create "Implement design tokens from mockup" -t task -p 1
+bd create "Implement [ComponentName] component" -t task -p 2
 ```
 
 **Suggested Follow-up Commands:**

package/dist/template/.opencode/command/analyze-project.md

@@ -16,22 +16,22 @@ skill({ name: "beads" });
 
 Run these checks in parallel for speed:
 
-```bash
+```
 # Git status
-git status --short
-git branch --show-current
-git log --oneline -3
+!`git status --short`
+!`git branch --show-current`
+!`git log --oneline -3`
 
 # Beads status
-bd_status({ include_agents: false })
-bd_ls({ status: "open", limit: 5, offset: 0 })
-bd_ls({ status: "ready", limit: 5, offset: 0 })
+!`bd status`
+!`bd list --status open --limit 5`
+!`bd list --status ready --limit 5`
 
 # CI/CD status (GitHub Actions)
-gh run list --limit 5
+!`gh run list --limit 5`
 
 # Last commit info
-git log -1 --format="%h %s (%cr by %an)"
+!`git log -1 --format="%h %s (%cr by %an)"`
 ```
 
 ### Status Dashboard Output
@@ -55,12 +55,12 @@ git log -1 --format="%h %s (%cr by %an)"
 
 Detect project technology:
 
-```bash
+```
 # Package manager & framework
-ls package.json pyproject.toml Cargo.toml go.mod pom.xml build.gradle
+!`ls package.json pyproject.toml Cargo.toml go.mod pom.xml build.gradle`
 
-# Read main config
-read package.json  # or equivalent
+# Read main config (instructional - agent must read this file)
+# Read package.json  # or equivalent
 ```
 
 ### Tech Stack Analysis
@@ -101,15 +101,15 @@ read package.json  # or equivalent
 
 ```bash
 # Node.js
-npm outdated --json || pnpm outdated --json
-npm audit --json
+!`npm outdated --json || pnpm outdated --json`
+!`npm audit --json`
 
 # Python
-pip list --outdated
-pip-audit
+!`pip list --outdated`
+!`pip-audit`
 
 # Rust
-cargo outdated
+!`cargo outdated`
 cargo audit
 ```
 
@@ -132,11 +132,11 @@ npm test -- --coverage --json
 # Python
 pytest --cov --cov-report=json
 
-# Check for coverage config
-glob pattern="**/jest.config.*"
-glob pattern="**/vitest.config.*"
-glob pattern="**/pytest.ini"
-glob pattern="**/pyproject.toml"
+# Check for coverage config (instructional - agent uses glob tool)
+glob({ pattern: "**/jest.config.*" })
+glob({ pattern: "**/vitest.config.*" })
+glob({ pattern: "**/pytest.ini" })
+glob({ pattern: "**/pyproject.toml" })
 ```
 
 **Coverage Dashboard:**
@@ -153,13 +153,13 @@ glob pattern="**/pyproject.toml"
 
 ```bash
 # TypeScript type errors
-npx tsc --noEmit 2>&1 | wc -l
+!`npx tsc --noEmit 2>&1 | wc -l`
 
 # Linting issues
-npm run lint -- --format json 2>/dev/null || npx biome check --reporter=json
+!`npm run lint -- --format json 2>/dev/null || npx biome check --reporter=json`
 
 # TODO/FIXME count
-grep -r "TODO\|FIXME\|HACK\|XXX" src/ --include="*.ts" --include="*.tsx" | wc -l
+!`grep -r "TODO\|FIXME\|HACK\|XXX" src/ --include="*.ts" --include="*.tsx" | wc -l`
 ```
 
 **Quality Dashboard:**
@@ -174,15 +174,15 @@ grep -r "TODO\|FIXME\|HACK\|XXX" src/ --include="*.ts" --include="*.tsx" | wc -l
 
 ### 3.4 Documentation Status
 
-```bash
+```
 # Check for docs
-ls README.md CHANGELOG.md CONTRIBUTING.md docs/ 2>/dev/null
+!`ls README.md CHANGELOG.md CONTRIBUTING.md docs/ 2>/dev/null`
 
 # README freshness
-git log -1 --format="%cr" -- README.md
+!`git log -1 --format="%cr" -- README.md`
 
 # API docs
-ls docs/api/ openapi.yaml swagger.json 2>/dev/null
+!`ls docs/api/ openapi.yaml swagger.json 2>/dev/null`
 ```
 
 **Documentation Dashboard:**
@@ -205,52 +205,51 @@ skill({ name: "gemini-large-context" })
 
 ### 4.1 Architecture Analysis
 
-```bash
-gemini -p "@src/
+```typescript
+gemini({ prompt: "@src/
 Describe:
 1. Overall architecture pattern (MVC, Clean, Hexagonal, etc.)
 2. Key modules and their responsibilities
 3. Data flow between components
 4. External dependencies and integrations
-5. Areas of high complexity"
+5. Areas of high complexity" });
 ```
 
 ### 4.2 Test Gap Analysis
 
-```bash
-gemini -p "@src/ @tests/
+```typescript
+gemini({ prompt: "@src/ @tests/
 Assess test coverage:
 - Which modules have tests?
 - Which are missing tests?
 - Test quality (unit vs integration)
 - Edge cases covered
-- Critical paths without tests"
+- Critical paths without tests" });
 ```
 
 ### 4.3 Code Smell Detection
 
-```bash
-gemini -p "@src/
+```typescript
+gemini({ prompt: "@src/
 Identify code smells:
 - Duplicated code
 - Long functions (>50 lines)
 - Deep nesting (>4 levels)
 - God objects/files
-- Dead code
-- Inconsistent patterns"
+- Overly complex conditions" });
 ```
 
 ### 4.4 Security Analysis (--security)
 
 ```bash
 # Automated scans
-npm audit
-npx snyk test 2>/dev/null || true
+!`npm audit`
+!`npx snyk test 2>/dev/null || true`
 
 # Pattern-based detection
-grep -r "password\s*=" src/ --include="*.ts" || true
-grep -r "api_key\s*=" src/ --include="*.ts" || true
-grep -r "secret" src/ --include="*.ts" || true
+!`grep -r "password\s*=" src/ --include="*.ts" || true`
+!`grep -r "api_key\s*=" src/ --include="*.ts" || true`
+!`grep -r "secret" src/ --include="*.ts" || true`
 
 # Deep analysis with Gemini
 gemini -p "@src/ @api/
@@ -279,8 +278,8 @@ Security review:
 
 Find actionable tasks with no blockers:
 
-```typescript
-bd_ls({ status: "ready", limit: 10, offset: 0 });
+```
+!`bd list --status ready --limit 10`
 ```
 
 ### Ready Work Table
@@ -293,8 +292,8 @@ bd_ls({ status: "ready", limit: 10, offset: 0 });
 
 **Blocked Work:**
 
-```typescript
-bd_ls({ status: "blocked", limit: 5, offset: 0 });
+```
+!`bd list --status blocked --limit 5`
 ```
 
 | ID     | Title          | Blocked By | Action Needed       |
@@ -371,24 +370,12 @@ Based on analysis, generate actionable recommendations:
 
 For significant findings, create tracking issues:
 
-```typescript
-// For security vulnerabilities
-bd_add({
-  title: "[Security] Fix npm audit vulnerabilities",
-  desc: "npm audit found 2 high severity vulnerabilities:\n- lodash: prototype pollution\n- axios: SSRF\n\nRun: npm audit fix --force",
-  type: "bug",
-  pri: 1,
-  tags: ["security", "dependencies"],
-});
-
-// For test coverage
-bd_add({
-  title: "[Quality] Increase test coverage to 80%",
-  desc: "Current coverage: 78%\nTarget: 80%\n\nUncovered files:\n- src/auth/login.ts\n- src/api/users.ts",
-  type: "task",
-  pri: 2,
-  tags: ["testing", "quality"],
-});
+```bash
+# For security vulnerabilities
+bd create "[Security] Fix npm audit vulnerabilities" -t bug -p 1  # Keep as instructional
+
+# For test coverage
+bd create "[Quality] Increase test coverage to 80%" -t task -p 2  # Keep as instructional
 ```
 
 ### Suggested Follow-up Commands
@@ -460,8 +447,9 @@ Save analysis to `.opencode/memory/project/analysis-[YYYY-MM-DD].md` for trend t
 
 Compare with previous analysis:
 
-```bash
-read .opencode/memory/project/analysis-*.md
+```typescript
+glob({ pattern: ".opencode/memory/project/analysis-*.md" });
+// Then read each matched file
 ```
 
 ---

package/dist/template/.opencode/command/brainstorm.md

@@ -28,9 +28,7 @@ skill({ name: "brainstorming" });
 
 If `$ARGUMENTS` is a bead ID:
 
-```typescript
-bd_show({ id: "$ARGUMENTS" });
-```
+!`bd show $ARGUMENTS`
 
 Load constraints from `.beads/artifacts/<bead-id>/spec.md` if it exists.
 
@@ -247,14 +245,8 @@ observation({
 
 For promising ideas that need more work:
 
-```typescript
-bd_add({
-  title: "[Idea name]",
-  type: "task",
-  pri: 2,
-  desc: "From brainstorm: [topic]. Needs research/prototyping.",
-  tags: ["brainstorm"],
-});
+```bash
+bd create "[Idea name]" -t task -p 2
 ```
 
 ## Output

package/dist/template/.opencode/command/commit.md

@@ -19,11 +19,9 @@ skill({ name: "verification-before-completion" });
 
 ## Phase 1: Check Git State
 
-```bash
-git status --porcelain
-git diff --stat
-git diff --cached --stat
-```
+!`git status --porcelain`
+!`git diff --stat`
+!`git diff --cached --stat`
 
 Report:
 
@@ -48,9 +46,7 @@ If nothing staged: "No changes staged. Run `git add <files>` first."
 
 Detect project type and run gates:
 
-```bash
-ls package.json Cargo.toml pyproject.toml go.mod Makefile 2>/dev/null
-```
+!`ls package.json Cargo.toml pyproject.toml go.mod Makefile 2>/dev/null`
 
 | Project | Test Command    | Lint Command                         |
 | ------- | --------------- | ------------------------------------ |
@@ -78,10 +74,8 @@ Fix errors or use `git commit --no-verify` (not recommended).
 
 ## Phase 3: Analyze Changes for Message
 
-```bash
-git diff --cached --stat
-git diff --cached
-```
+!`git diff --cached --stat`
+!`git diff --cached`
 
 Determine:
 
@@ -186,8 +180,8 @@ Options:
 
 If bead ID was provided:
 
-```typescript
-bd_sync({ reason: "Sync after commit" });
+```bash
+bd sync
 ```
 
 ## Output
@@ -221,10 +215,8 @@ Create PR:
 
 **Safety checks before amend:**
 
-```bash
-git log -1 --format='%H %s'  # What we're amending
-git status                    # Check if pushed
-```
+!`git log -1 --format='%H %s'` # What we're amending
+!`git status` # Check if pushed
 
 ```
 Amend Safety Check:

package/dist/template/.opencode/command/create.md

@@ -10,9 +10,7 @@ You're creating a new tracked task. Keep it simple unless complexity demands oth
 
 ## Check For Duplicates First
 
-```bash
-bd list --status=all | grep -i "[keywords]"
-```
+!`bd list --status=all | grep -i "[keywords]"`
 
 If similar work exists, link to it or extend it instead of creating duplicate.
 
@@ -104,14 +102,12 @@ bd dep add bd-[second] bd-[first] --type blocks
 
 Visualize:
 
-```bash
-bd dep tree bd-[epic]
-```
+!`bd dep tree bd-[epic]`
 
 ## Sync
 
-```typescript
-bd_sync({ reason: "Sync new bead" });
+```bash
+bd sync
 ```
 
 ## Output

package/dist/template/.opencode/command/design-audit.md

@@ -40,17 +40,15 @@ Parse `$ARGUMENTS`:
 
 Search for design-related files:
 
-```bash
-# Token/config files
-glob pattern="**/tailwind.config.{js,ts,mjs}"
-glob pattern="**/globals.css"
-glob pattern="**/variables.css"
-glob pattern="**/tokens.{json,js,ts}"
-glob pattern="**/theme.{js,ts}"
-glob pattern="**/*.css.ts"  # vanilla-extract, etc.
-
-# Component files for pattern analysis
-glob pattern="**/components/**/*.{tsx,jsx,vue}"
+```typescript
+glob({ pattern: "**/tailwind.config.{js,ts,mjs}" });
+glob({ pattern: "**/globals.css" });
+glob({ pattern: "**/variables.css" });
+glob({ pattern: "**/tokens.{json,js,ts}" });
+glob({ pattern: "**/theme.{js,ts}" });
+glob({ pattern: "**/*.css.ts" }); // vanilla-extract, etc.
+
+glob({ pattern: "**/components/**/*.{tsx,jsx,vue}" });
 ```
 
 **Detect design system in use:**
@@ -110,32 +108,20 @@ Analyze all images and extract:
 
 Search for hardcoded values using ast-grep and grep:
 
-```bash
-# Hardcoded colors
-ast-grep pattern='color: "#$HEX"'
-ast-grep pattern='background: "#$HEX"'
-grep '#[0-9a-fA-F]{3,8}' --include="*.{css,scss,tsx,jsx}"
-grep 'rgb\(' --include="*.{css,scss,tsx,jsx}"
-grep 'hsl\(' --include="*.{css,scss,tsx,jsx}"
-
-# Hardcoded spacing
-grep '[0-9]+px' --include="*.{css,scss,tsx,jsx}"
-grep '[0-9]+rem' --include="*.{css,scss,tsx,jsx}"
-
-# Hardcoded typography
-grep 'font-size:' --include="*.css"
-grep 'fontSize:' --include="*.{tsx,jsx}"
-
-# Magic numbers in Tailwind classes
-ast-grep pattern='className="$$$"'  # then analyze for arbitrary values like [16px]
-```
+```typescript
+ast - grep({ pattern: 'color: "#$HEX"' });
+ast - grep({ pattern: 'background: "#$HEX"' });
+grep({ pattern: "#[0-9a-fA-F]{3,8}", include: "*.{css,scss,tsx,jsx}" });
+grep({ pattern: "rgb\\(", include: "*.{css,scss,tsx,jsx}" });
+grep({ pattern: "hsl\\(", include: "*.{css,scss,tsx,jsx}" });
 
-**Read and analyze token files:**
+grep({ pattern: "[0-9]+px", include: "*.{css,scss,tsx,jsx}" });
+grep({ pattern: "[0-9]+rem", include: "*.{css,scss,tsx,jsx}" });
 
-```
-read tailwind.config.js → extract theme.extend
-read globals.css → extract :root CSS variables
-read tokens.json → parse token structure
+grep({ pattern: "font-size:", include: "*.css" });
+grep({ pattern: "fontSize:", include: "*.{tsx,jsx}" });
+
+ast - grep({ pattern: 'className="$$$"' }); // then analyze for arbitrary values like [16px]
 ```
 
 ---
@@ -438,22 +424,9 @@ Score interpretation:
 
 For high-priority findings:
 
-```
-bd_add({
-  title: "[Design] Consolidate duplicate blue colors",
-  desc: "8 similar blue values found. Consolidate to --primary scale.\nLocations: Button.tsx, Link.tsx, Card.tsx",
-  type: "task",
-  pri: 1,
-  tags: ["design-system", "cleanup"]
-})
-
-bd_add({
-  title: "[Design] Add missing dark mode tokens",
-  desc: "5 tokens missing dark mode values: --muted, --accent, --warning, --card, --popover",
-  type: "task",
-  pri: 1,
-  tags: ["design-system", "dark-mode"]
-})
+```bash
+bd create "[Design] Consolidate duplicate blue colors" -t task -p 1
+bd create "[Design] Add missing dark mode tokens" -t task -p 1
 ```
 
 ---

package/dist/template/.opencode/command/design.md

@@ -30,15 +30,14 @@ Parse `$ARGUMENTS` to determine design task:
 
 ### Detect Existing Design System
 
-```bash
-# Check for design system in use
-glob pattern="**/tailwind.config.{js,ts,mjs}"
-glob pattern="**/globals.css"
-glob pattern="**/components.json"  # shadcn
-
-# Read existing styles
-read tailwind.config.js
-read src/styles/globals.css
+```typescript
+glob({ pattern: "**/tailwind.config.{js,ts,mjs}" });
+glob({ pattern: "**/globals.css" });
+glob({ pattern: "**/components.json" }); // shadcn
+
+// Read existing styles
+read({ filePath: "tailwind.config.js" });
+read({ filePath: "src/styles/globals.css" });
 ```
 
 **Identify component library:**
@@ -578,14 +577,8 @@ Before finalizing, verify design does NOT have ALL of these together:
 
 For component/page designs:
 
-```
-bd_add({
-  title: "Implement [component/page] design",
-  desc: "Build [name] per design spec at .opencode/memory/design/specs/[file].md",
-  type: "task",
-  pri: 2,
-  tags: ["frontend", "design"]
-})
+```bash
+bd create "Implement [component/page] design" -t task -p 2
 ```
 
 ### Bead Integration

package/dist/template/.opencode/command/finish.md

@@ -17,8 +17,8 @@ skill({ name: "verification-before-completion" });
 
 ## Verify The Task Exists
 
-```bash
-bd show $ARGUMENTS
+```
+!`bd show $ARGUMENTS`
 ```
 
 If not found, stop. Check `bd list --status=all` for the correct ID.
@@ -27,8 +27,8 @@ If not found, stop. Check `bd list --status=all` for the correct ID.
 
 Detect your project type and run everything:
 
-```bash
-ls package.json Cargo.toml pyproject.toml go.mod Makefile 2>/dev/null
+```
+!`ls package.json Cargo.toml pyproject.toml go.mod Makefile 2>/dev/null`
 ```
 
 **Node/TypeScript:**
@@ -70,8 +70,8 @@ If ANY gate fails, stop. Fix it first. Don't close broken work.
 
 Read the spec and check each criterion:
 
-```bash
-cat .beads/artifacts/$ARGUMENTS/spec.md
+```
+!`cat .beads/artifacts/$ARGUMENTS/spec.md`
 ```
 
 For each success criterion listed, run its verification. All must pass. If something's missing, go back and implement it.
@@ -91,11 +91,11 @@ Closes: $ARGUMENTS"
 
 ## Close The Task
 
-```typescript
-bd_done({ id: "$ARGUMENTS", msg: "Completed: [1-line summary]" });
+```bash
+bd close $ARGUMENTS --reason "Completed: [1-line summary]"
 ```
 
-This closes the task, releases any file locks, and syncs with git. Task is done.
+This closes the task. Sync separately if needed.
 
 ## Create Review (Optional But Recommended)