opencodekit 0.12.4 → 0.12.6

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.6",
   description: "CLI tool for bootstrapping and managing OpenCodeKit projects",
   type: "module",
   repository: {
@@ -764,7 +764,10 @@ var package_default = {
   bin: {
     ock: "dist/index.js"
   },
-  files: ["dist", "README.md"],
+  files: [
+    "dist",
+    "README.md"
+  ],
   scripts: {
     dev: "bun run src/index.ts",
     build: "bun build src/index.ts --outdir dist --target node && 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/",
@@ -776,7 +779,14 @@ var package_default = {
     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: {
@@ -784,7 +794,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",
@@ -799,7 +809,9 @@ var package_default = {
     "@types/node": "^22.10.1",
     typescript: "^5.7.2"
   },
-  trustedDependencies: ["@beads/bd"]
+  trustedDependencies: [
+    "@beads/bd"
+  ]
 };
 
 // src/commands/agent.ts

package/dist/template/.opencode/agent/build.md

@@ -174,12 +174,20 @@ Build is a **leader agent** - owns the session and coordinates with beads.
 
 ### Session Workflow
 
+```bash
+bd status                        # Check workspace status
+bd ready                         # Find next ready task
+bd update <id> --status in_progress  # Claim task
 ```
-bd_init({ role: "build" })     # Join workspace
-bd_claim()                      # Get next ready task
-bd_reserve([files])             # Lock files before editing
+
+```typescript
+bd-reserve({ paths: ["src/file.ts"], ttl: 600 })  # Lock files before editing
+```
+
+```bash
 [... do work, delegate to subagents ...]
-bd_done(id, "reason")           # Complete and release locks
+bd close <id> --reason "Completed: description"  # Complete task
+bd sync                          # Sync changes
 → RESTART SESSION
 ```
 
@@ -189,10 +197,10 @@ When claiming an **epic**:
 
 1. Delegate to @planner for breakdown
 2. Create sub-tasks in beads with appropriate tags:
-   ```
-   bd_add({ title: "Research X", tags: ["scout"], parent: epicId })
-   bd_add({ title: "Design Y", tags: ["planner"], parent: epicId })
-   bd_add({ title: "Implement Z", tags: ["build"], parent: epicId })
+   ```bash
+   bd create "Research X" -t task -p 2 --parent <epicId>
+   bd create "Design Y" -t task -p 2 --parent <epicId>
+   bd create "Implement Z" -t task -p 2 --parent <epicId>
    ```
 3. Execute sub-tasks yourself OR delegate via Task tool
 4. Close epic when all sub-tasks done
@@ -215,8 +223,14 @@ Results return to you (leader). You update beads accordingly.
 
 ### File Locking
 
-Only leader agents use `bd_reserve`:
+Only leader agents use `bd-reserve` tool:
+
+```typescript
+bd-reserve({ paths: ["src/file.ts"], ttl: 600 }); // Lock files
+bd-release({ paths: ["src/file.ts"] }); // Release specific
+bd-release(); // List active locks
+```
 
 - Reserve before editing shared files
-- Auto-released on `bd_done()`
-- Check `bd_reservations()` if conflicts
+- Release after completing edits
+- Check `bd-release()` (no args) to list active locks if conflicts

package/dist/template/.opencode/agent/rush.md

@@ -129,11 +129,13 @@ Rush should **skip beads** when:
 
 ### Minimal Workflow
 
-```
-bd_init({ role: "rush" })       # Join workspace
-bd_claim()                       # Get next ready task (or skip if user gave direct task)
+```bash
+bd status                        # Check workspace status
+bd ready                         # Find ready tasks (or skip if user gave direct task)
+bd update <id> --status in_progress  # Claim task
 [... quick work ...]
-bd_done(id, "reason")            # Complete
+bd close <id> --reason "Done"    # Complete
+bd sync                          # Sync changes
 → RESTART SESSION
 ```
 

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
 ```
 
 ---