opencodekit 0.12.3 → 0.12.5

package/dist/template/.opencode/command/skill-optimize.md

@@ -20,16 +20,9 @@ skill({ name: "writing-skills" });
 
 ### Find Skill Location
 
-```bash
-# Check local skills first
-ls -la .opencode/skill/$ARGUMENTS/ 2>/dev/null
-
-# Check superpowers (shared skills)
-ls -la .opencode/superpowers/skills/$ARGUMENTS/ 2>/dev/null
-
-# Check installed skills
-ls -la ~/.opencode/skills/$ARGUMENTS/ 2>/dev/null
-```
+!`ls -la .opencode/skill/$ARGUMENTS/ 2>/dev/null`
+!`ls -la .opencode/superpowers/skills/$ARGUMENTS/ 2>/dev/null`
+!`ls -la ~/.opencode/skills/$ARGUMENTS/ 2>/dev/null`
 
 ### Load Current Content
 

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

@@ -18,27 +18,29 @@ Generate a comprehensive project status report covering tasks, sessions, git sta
 
 Run all status checks simultaneously:
 
+```
+# Beads CLI commands
+!`bd status`
+!`bd list --status in_progress --limit 10`
+!`bd list --status ready --limit 10`
+
+# Git state
+!`git status --porcelain`
+!`git branch --show-current`
+!`git log --oneline -5`
+```
+
 ```typescript
-// Beads state
-bd_status({ include_agents: true });
-bd_ls({ status: "in_progress", limit: 10, offset: 0 });
-bd_ls({ status: "ready", limit: 10, offset: 0 });
-bd_inbox({ n: 5, unread: true, global: true });
-bd_doctor({ reason: "Health check" });
-bd_reservations();
-
-// Sessions
-list_sessions({ project: "current", since: "today", limit: 5, _: true });
-
-// Search for recent activity on current work (if bead in progress)
-search_session({ query: "<current-bead-id>", limit: 5 });
-
-// Git state
-bash("git status --porcelain");
-bash("git branch --show-current");
-bash("git log --oneline -5");
+// Custom tools (message inbox, locks)
+bd-inbox({ n: 5, unread: true, to: "all" });
+bd-release(); // Lists active locks when called with no args
+
+// Built-in tools
+list_sessions({ project: "current", since: "today", limit: 5 });
 ```
 
+````
+
 ## Phase 2: Health Score Calculation
 
 Calculate overall project health (0-100):
@@ -215,7 +217,7 @@ REQUIRED ACTIONS
 ━━━━━━━━━━━━━━━━
 Priority │ Action                              │ Command
 ─────────┼─────────────────────────────────────┼────────────────────
-HIGH     │ Reply to build-1 question          │ bd_msg(...)
+HIGH     │ Reply to build-1 question          │ bd-msg --to "build-1" --subj "Re:" --body "..."
 HIGH     │ Add plan for bd-ghi56               │ /plan bd-ghi56
 MEDIUM   │ Review 2 stale tasks                │ /triage --stale
 LOW      │ Push 2 local commits                │ git push
@@ -286,13 +288,13 @@ if (incompleteSessions.length > 0) {
 
 ## Phase 6: CI/CD Status (if available)
 
-```bash
+```
 # GitHub Actions
-gh run list --limit 3 --json status,conclusion,name,createdAt
+!`gh run list --limit 3 --json status,conclusion,name,createdAt`
 
 # Or check for common CI files
-ls .github/workflows/ 2>/dev/null
-cat .github/workflows/*.yml | grep -A5 "name:"
+!`ls .github/workflows/ 2>/dev/null`
+!`cat .github/workflows/*.yml | grep -A5 "name:"`
 ```
 
 **Output:**
@@ -332,7 +334,7 @@ RECOMMENDED NEXT STEPS
 Based on current status:
 
 1. High Priority Messages:
-   → Reply to build-1: bd_msg({ to: "build-1", subj: "Re: API spec", body: "..." })
+   → Reply to build-1: bd-msg --to "build-1" --subj "Re: API spec" --body "..."
 
 2. Continue In-Progress Work:
    → /implement bd-abc12  (P0, 2h old)
@@ -364,7 +366,7 @@ Handle gracefully:
 ```
 [If beads unavailable:]
 ⚠️ Beads database not initialized
-   Run: bd_init() to connect
+   Run: bd status to check connection
 
 [If git not available:]
 ⚠️ Not a git repository
@@ -374,3 +376,4 @@ Handle gracefully:
 ⚠️ CI status unavailable
    Check: GitHub Actions permissions
 ```
+````

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

@@ -16,19 +16,19 @@ Analyze open tasks and optimize prioritization using dependency graph analysis,
 
 ## Phase 1: Initialize Beads Connection
 
-```typescript
-bd_init({ team: "project", role: "build" });
-```
+!`bd status`
 
 ## Phase 2: Gather Workspace State
 
 Run in parallel:
 
+!`bd status`
+!`bd list --status open --limit 50`
+
 ```typescript
-bd_status({ include_agents: true });
-bd_ls({ status: "open", limit: 50, offset: 0 });
-bd_reservations();
-bd_inbox({ n: 10, unread: true, global: true });
+// Custom tools (not shell commands)
+bd-release(); // Lists active locks when called with no args
+bd-inbox({ n: 10, unread: true, to: "all" });
 
 // Search for past discussions on recurring issues
 search_session({ query: "blocked OR regression OR urgent", limit: 10 });
@@ -47,10 +47,7 @@ Capture:
 
 Use `bd dep tree` to understand blocking relationships:
 
-```typescript
-// For each high-priority open task, check its dependency tree
-bd_dep({ action: "tree", child: "<task-id>", type: "blocks" });
-```
+!`bd dep tree <task-id>`
 
 This provides:
 
@@ -244,7 +241,8 @@ function selectAgent(role: string, agents: Agent[]): Agent {
 // For each unassigned high-priority ready task
 for (const task of readyTasks.filter((t) => !t.assignee && t.priority <= 2)) {
   const role = detectRole(task);
-  bd_assign({ id: task.id, role, notify: true });
+  // Use bd CLI to update assignment
+  // bd update <task.id> --assignee <role>
 }
 ```
 
@@ -267,13 +265,10 @@ Skipped:
 
 ### Bulk Priority Update
 
-```typescript
-// Escalate all breached SLA tasks
-for (const task of breachedTasks) {
-  if (task.priority > 1) {
-    bd_update({ id: task.id, priority: task.priority - 1 });
-  }
-}
+```bash
+# Escalate all breached SLA tasks
+for each breached task:
+  bd update <task-id> --priority <new-priority>
 ```
 
 ### Stale Task Cleanup
@@ -298,18 +293,11 @@ console.log("3. Review individually");
 ```
 
 ```typescript
-bd_sync({ reason: "Sync triage changes" });
-
-// Broadcast triage summary if significant changes
-if (assignmentsMade > 0 || priorityChanges > 0) {
-  bd_msg({
-    subj: "Triage Complete",
-    body: `Assigned ${assignmentsMade} tasks, updated ${priorityChanges} priorities`,
-    to: "all",
-    global: true,
-    importance: "normal",
-  });
-}
+bd sync
+
+# Broadcast triage summary if significant changes
+if assignments or priority changes:
+  bd-msg --subj "Triage Complete" --body "Assigned X tasks, updated Y priorities" --to "all" --importance normal
 ```
 
 ## Alternative: Manual Triage

package/dist/template/.opencode/command/ui-review.md

@@ -266,19 +266,12 @@ Info (Nice to Have):
 
 If `--bead=<id>` provided:
 
-```typescript
-// Create issues for critical findings
-bd_add({
-  title: "[UI] Fix invisible focus states",
-  desc: "Focus states not visible on primary buttons.\n\nFix: Add focus-visible ring classes",
-  type: "bug",
-  pri: 1,
-  parent: "<bead-id>",
-  tags: ["accessibility", "ui"],
-});
-
-// Update review.md
-write(".beads/artifacts/<bead-id>/review.md", reviewContent);
+```bash
+# Create issues for critical findings
+bd create "[UI] Fix invisible focus states" -t bug -p 1
+
+# Then link to parent bead
+bd dep add <task-id> <bead-id>
 ```
 
 ---

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

@@ -0,0 +1,465 @@
+---
+description: Analyze project health, status, and ready work with metrics
+argument-hint: "[--quick|--deep|--health|--security]"
+agent: planner
+---
+
+# Analyze Project
+
+## Load Beads Skill
+
+```typescript
+skill({ name: "beads" });
+```
+
+## Phase 1: Quick Status Dashboard
+
+Run these checks in parallel for speed:
+
+```bash
+# Git status
+git status --short
+git branch --show-current
+git log --oneline -3
+
+# Beads status
+bd status
+bd list --status open --limit 5
+bd list --status ready --limit 5
+
+# CI/CD status (GitHub Actions)
+gh run list --limit 5
+
+# Last commit info
+git log -1 --format="%h %s (%cr by %an)"
+```
+
+### Status Dashboard Output
+
+```markdown
+## Project Status Dashboard
+
+| Category         | Status                | Details                        |
+| ---------------- | --------------------- | ------------------------------ |
+| **Branch**       | `main`                | 3 commits ahead of origin      |
+| **Working Tree** | Clean / Dirty         | X files modified               |
+| **Last Commit**  | `abc123`              | "feat: add auth" (2 hours ago) |
+| **CI Status**    | Pass / Fail / Running | Last run: 2h ago               |
+| **Open Tasks**   | X beads               | Y ready, Z blocked             |
+| **Dependencies** | X outdated            | Y security issues              |
+```
+
+---
+
+## Phase 2: Tech Stack Detection
+
+Detect project technology:
+
+```bash
+# Package manager & framework
+ls package.json pyproject.toml Cargo.toml go.mod pom.xml build.gradle
+
+# Read main config
+read package.json  # or equivalent
+```
+
+### Tech Stack Analysis
+
+| Aspect                | Detection Method          | Example Output                   |
+| --------------------- | ------------------------- | -------------------------------- |
+| **Language**          | File extensions, config   | TypeScript, Python, Rust         |
+| **Framework**         | package.json dependencies | Next.js 14, FastAPI, Axum        |
+| **Package Manager**   | Lock file presence        | npm, pnpm, yarn, bun             |
+| **Testing**           | Test framework in deps    | Jest, Vitest, pytest, cargo test |
+| **Linting**           | Config files              | ESLint, Biome, Ruff              |
+| **Formatting**        | Config files              | Prettier, Biome, Black           |
+| **CI/CD**             | Workflow files            | GitHub Actions, GitLab CI        |
+| **Database**          | Dependencies, .env        | PostgreSQL, SQLite, MongoDB      |
+| **UI Framework**      | Dependencies              | React, Vue, Svelte               |
+| **Component Library** | components.json, deps     | shadcn/ui, MUI, Chakra           |
+
+```markdown
+## Tech Stack
+
+| Category        | Technology | Version |
+| --------------- | ---------- | ------- |
+| Language        | TypeScript | 5.3.x   |
+| Runtime         | Node.js    | 20.x    |
+| Framework       | Next.js    | 14.2    |
+| Package Manager | pnpm       | 8.x     |
+| Testing         | Vitest     | 1.x     |
+| Linting         | Biome      | 1.x     |
+| UI              | shadcn/ui  | latest  |
+| Database        | PostgreSQL | 16      |
+```
+
+---
+
+## Phase 3: Health Metrics
+
+### 3.1 Dependency Health
+
+```bash
+# Node.js
+npm outdated --json || pnpm outdated --json
+npm audit --json
+
+# Python
+pip list --outdated
+pip-audit
+
+# Rust
+cargo outdated
+cargo audit
+```
+
+**Dependency Dashboard:**
+
+| Metric                   | Value | Status  | Threshold |
+| ------------------------ | ----- | ------- | --------- |
+| Total dependencies       | 45    | -       | -         |
+| Outdated (major)         | 3     | Warning | < 5       |
+| Outdated (minor)         | 8     | OK      | < 20      |
+| Security vulnerabilities | 0     | OK      | 0         |
+| High/Critical vulns      | 0     | OK      | 0         |
+
+### 3.2 Test Coverage
+
+```bash
+# Node.js
+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"
+```
+
+**Coverage Dashboard:**
+
+| Metric          | Value | Status  | Threshold |
+| --------------- | ----- | ------- | --------- |
+| Line coverage   | 78%   | Warning | > 80%     |
+| Branch coverage | 65%   | Warning | > 70%     |
+| Uncovered files | 12    | -       | -         |
+| Test count      | 156   | -       | -         |
+| Test pass rate  | 100%  | OK      | 100%      |
+
+### 3.3 Code Quality
+
+```bash
+# TypeScript type errors
+npx tsc --noEmit 2>&1 | wc -l
+
+# Linting issues
+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
+```
+
+**Quality Dashboard:**
+
+| Metric                 | Value | Status  | Threshold |
+| ---------------------- | ----- | ------- | --------- |
+| Type errors            | 0     | OK      | 0         |
+| Lint errors            | 5     | Warning | 0         |
+| Lint warnings          | 23    | OK      | < 50      |
+| TODO/FIXME             | 15    | Info    | < 30      |
+| Console.log statements | 3     | Warning | 0         |
+
+### 3.4 Documentation Status
+
+```bash
+# Check for docs
+ls README.md CHANGELOG.md CONTRIBUTING.md docs/ 2>/dev/null
+
+# README freshness
+git log -1 --format="%cr" -- README.md
+
+# API docs
+ls docs/api/ openapi.yaml swagger.json 2>/dev/null
+```
+
+**Documentation Dashboard:**
+
+| Document        | Status  | Last Updated |
+| --------------- | ------- | ------------ |
+| README.md       | Present | 5 days ago   |
+| CHANGELOG.md    | Present | 2 days ago   |
+| CONTRIBUTING.md | Missing | -            |
+| API docs        | Present | 1 week ago   |
+| AGENTS.md       | Present | 3 days ago   |
+
+---
+
+## Phase 4: Detailed Analysis (--deep)
+
+**For large codebases (>100KB of source):**
+
+skill({ name: "gemini-large-context" })
+
+### 4.1 Architecture Analysis
+
+```bash
+gemini -p "@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"
+```
+
+### 4.2 Test Gap Analysis
+
+```bash
+gemini -p "@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"
+```
+
+### 4.3 Code Smell Detection
+
+```bash
+gemini -p "@src/
+Identify code smells:
+- Duplicated code
+- Long functions (>50 lines)
+- Deep nesting (>4 levels)
+- God objects/files
+- Dead code
+- Inconsistent patterns"
+```
+
+### 4.4 Security Analysis (--security)
+
+```bash
+# Automated scans
+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
+
+# Deep analysis with Gemini
+gemini -p "@src/ @api/
+Security review:
+- Input validation practices
+- Authentication/authorization patterns
+- SQL injection protections
+- XSS prevention measures
+- Secrets in code
+- CORS configuration"
+```
+
+**Security Dashboard:**
+
+| Check             | Status  | Issues                    |
+| ----------------- | ------- | ------------------------- |
+| npm audit         | Pass    | 0 vulnerabilities         |
+| Hardcoded secrets | Warning | 2 potential matches       |
+| Auth patterns     | OK      | Using established library |
+| Input validation  | Warning | 5 unvalidated endpoints   |
+| CORS              | OK      | Properly configured       |
+
+---
+
+## Phase 5: Ready Work
+
+Find actionable tasks with no blockers:
+
+```bash
+bd list --status ready --limit 10
+```
+
+### Ready Work Table
+
+| ID     | Title         | Type    | Priority | Tags        |
+| ------ | ------------- | ------- | -------- | ----------- |
+| bd-123 | Add user auth | feature | P1       | backend     |
+| bd-124 | Fix login bug | bug     | P0       | urgent      |
+| bd-125 | Update deps   | task    | P2       | maintenance |
+
+**Blocked Work:**
+
+```bash
+bd list --status blocked --limit 5
+```
+
+| ID     | Title          | Blocked By | Action Needed       |
+| ------ | -------------- | ---------- | ------------------- |
+| bd-130 | Deploy to prod | bd-124     | Fix login bug first |
+
+---
+
+## Phase 6: Health Score
+
+Calculate overall project health:
+
+```
+Health Score = 100 - (penalties)
+
+Penalties:
+- Each high/critical vulnerability: -10 (max -30)
+- Each major outdated dependency: -2 (max -10)
+- Type errors present: -15
+- Test coverage < 80%: -10
+- Test coverage < 60%: -20
+- CI failing: -20
+- No README: -5
+- No CHANGELOG: -3
+- Lint errors > 0: -5
+- TODO count > 50: -5
+
+Score interpretation:
+90-100: Excellent - Ship with confidence
+75-89: Good - Minor issues to address
+60-74: Fair - Technical debt accumulating
+< 60: Poor - Significant attention needed
+```
+
+### Health Score Output
+
+```markdown
+## Project Health Score: 82/100 (Good)
+
+### Score Breakdown
+
+| Category      | Score | Notes                    |
+| ------------- | ----- | ------------------------ |
+| Security      | 20/20 | No vulnerabilities       |
+| Dependencies  | 18/20 | 2 major outdated         |
+| Tests         | 15/20 | 78% coverage (below 80%) |
+| Code Quality  | 15/20 | 5 lint errors            |
+| CI/CD         | 10/10 | Passing                  |
+| Documentation | 4/10  | Missing CONTRIBUTING.md  |
+
+### Priority Actions
+
+1. **Fix 5 lint errors** → `npm run lint -- --fix`
+2. **Increase test coverage** → Focus on uncovered files
+3. **Update 2 major deps** → `npm update`
+4. **Add CONTRIBUTING.md** → Document contribution process
+```
+
+---
+
+## Phase 7: Recommendations & Actions
+
+Based on analysis, generate actionable recommendations:
+
+### Immediate Actions
+
+| Priority | Issue            | Command                 | Bead Created |
+| -------- | ---------------- | ----------------------- | ------------ |
+| P0       | CI failing       | Check `gh run view`     | -            |
+| P1       | 2 security vulns | `npm audit fix`         | bd-xxx       |
+| P2       | 5 lint errors    | `npm run lint -- --fix` | -            |
+
+### Create Beads for Issues
+
+For significant findings, create tracking issues:
+
+```bash
+# For security vulnerabilities
+bd create "[Security] Fix npm audit vulnerabilities" -t bug -p 1
+
+# For test coverage
+bd create "[Quality] Increase test coverage to 80%" -t task -p 2
+```
+
+### Suggested Follow-up Commands
+
+Based on findings:
+
+| Finding               | Suggested Command                     |
+| --------------------- | ------------------------------------- |
+| Ready tasks available | `/implement <bead-id>`                |
+| Test coverage low     | `/research test coverage strategies`  |
+| Security issues       | `/fix security`                       |
+| Outdated deps         | `npm update` or `/research migration` |
+| Architecture unclear  | `/research architecture`              |
+| Design system issues  | `/design-audit codebase`              |
+
+---
+
+## Output Modes
+
+### --quick (Default)
+
+- Status dashboard only
+- Ready work list
+- ~30 seconds
+
+### --health
+
+- Quick status + health metrics
+- Dependency/security scan
+- Health score
+- ~2-3 minutes
+
+### --deep
+
+- Full analysis including Gemini-powered insights
+- Architecture, test gaps, code smells
+- ~10-15 minutes
+
+### --security
+
+- Security-focused analysis
+- npm audit, secret detection, pattern analysis
+- Gemini security review
+- ~5-10 minutes
+
+---
+
+## Examples
+
+```bash
+# Quick status check
+/analyze-project
+
+# Full health assessment
+/analyze-project --health
+
+# Deep analysis for large codebase
+/analyze-project --deep
+
+# Security audit
+/analyze-project --security
+```
+
+---
+
+## Storage
+
+Save analysis to `.opencode/memory/project/analysis-[YYYY-MM-DD].md` for trend tracking.
+
+Compare with previous analysis:
+
+```bash
+read .opencode/memory/project/analysis-*.md
+```
+
+---
+
+## Related Commands
+
+| Need                | Command                               |
+| ------------------- | ------------------------------------- |
+| Start ready work    | `/implement <bead-id>`                |
+| Review codebase     | `/review-codebase`                    |
+| Check design system | `/design-audit`                       |
+| Security deep dive  | `/research security best practices`   |
+| Dependency update   | `/research migration to [package] vX` |