opencodekit 0.15.20 → 0.16.0

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

@@ -1,237 +0,0 @@
----
-description: Finish a bead - verify, commit, close
-argument-hint: "<bead-id>"
-agent: build
----
-
-# Finish: $ARGUMENTS
-
-You're closing out a task. This is the quality gate. No shortcuts.
-
-## Load Skills
-
-```typescript
-skill({ name: "beads" });
-skill({ name: "verification-before-completion" });
-```
-
-## Verify The Task Exists
-
-```
-!`bd show $ARGUMENTS`
-```
-
-If not found, stop. Check `bd list --status=all` for the correct ID.
-
-## Run All Gates
-
-Detect your project type and run everything:
-
-```
-!`ls package.json Cargo.toml pyproject.toml go.mod Makefile 2>/dev/null`
-```
-
-**Node/TypeScript:**
-
-```bash
-npm run build 2>/dev/null || true
-npm test
-npm run lint 2>/dev/null || true
-npm run type-check 2>/dev/null || true
-```
-
-**Rust:**
-
-```bash
-cargo build
-cargo test
-cargo clippy -- -D warnings
-```
-
-**Python:**
-
-```bash
-pytest
-ruff check .
-mypy . 2>/dev/null || true
-```
-
-**Go:**
-
-```bash
-go build ./...
-go test ./...
-golangci-lint run
-```
-
-If ANY gate fails, stop. Fix it first. Don't close broken work.
-
-## Verify Success Criteria
-
-Read the spec and check each criterion:
-
-```
-!`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.
-
-## If PRD Tasks Exist
-
-If `.beads/artifacts/$ARGUMENTS/prd.json` exists:
-
-- Ensure every task has `passes: true`
-- If tasks remain incomplete, do NOT close the bead yet
-- Continue with: `/complete-next-task $ARGUMENTS`
-
-## Review Changes (Ask Before Commit)
-
-Show what would be committed:
-
-```bash
-git add -A
-git status
-git diff --cached --stat
-```
-
-**Present the changes to the user:**
-
-```
-Ready to Commit
-━━━━━━━━━━━━━━
-
-Files changed:
-[list from git status]
-
-Summary: $ARGUMENTS - [what was done]
-
-Would you like me to:
-1. Commit these changes
-2. Show full diff first
-3. Skip commit (I'll review manually)
-```
-
-**Wait for user confirmation before proceeding.**
-
-If user confirms commit:
-
-```bash
-git commit -m "$ARGUMENTS: [what was done]
-
-- [change 1]
-- [change 2]
-
-Closes: $ARGUMENTS"
-```
-
-## Close The Task (Use Question Tool)
-
-```typescript
-question({
-  questions: [
-    {
-      header: "Close",
-      question: "Should I close bead $ARGUMENTS?",
-      options: [
-        {
-          label: "Yes, close it (Recommended)",
-          description: "All gates passed, task complete",
-        },
-        { label: "No, keep open", description: "Need more work or review" },
-      ],
-    },
-  ],
-});
-```
-
-If user confirms close:
-
-```bash
-bd close $ARGUMENTS --reason "Completed: [1-line summary]"
-```
-
-## Create Review (Optional But Recommended)
-
-If this was non-trivial work, document what happened:
-
-```bash
-mkdir -p .beads/artifacts/$ARGUMENTS
-```
-
-Write `.beads/artifacts/$ARGUMENTS/review.md`:
-
-```markdown
-# Review: $ARGUMENTS
-
-**Completed:** [date]
-
-## What Changed
-
-- [file]: [what and why]
-
-## What Worked
-
-- [thing that went smoothly]
-
-## What Was Hard
-
-- [challenge and how you solved it]
-
-## Lessons
-
-- [anything worth remembering]
-```
-
-## Record Learnings
-
-If you discovered patterns, gotchas, or decisions worth remembering:
-
-```typescript
-observation({
-  type: "learning", // or "pattern", "bugfix", "decision", "warning"
-  title: "[concise, searchable title]",
-  content: "[what you learned - be specific and actionable]",
-  bead_id: "$ARGUMENTS",
-  files: "[affected files, comma-separated]",
-  concepts: "[keywords for semantic search]",
-});
-```
-
-**This auto-embeds into the vector store** for future semantic search. Future `/start` and `/implement` commands will find this learning.
-
-**When to create observations:**
-
-- Discovered a non-obvious gotcha
-- Made a significant architectural decision
-- Found a pattern worth reusing
-- Hit a bug that others might hit
-
-**Skip observations for:**
-
-- Routine implementations
-- Well-documented patterns
-- Trivial fixes
-
-## Output
-
-```
-Closed: $ARGUMENTS
-
-Gates: All passed
-Commit: [hash]
-Branch: [branch]
-
-Next:
-- /pr $ARGUMENTS  # Create pull request
-- Or merge directly: git checkout main && git merge $ARGUMENTS
-```
-
-## If Work Is Incomplete
-
-Don't close incomplete work. Instead:
-
-```
-/handoff $ARGUMENTS "Stopped at [step]. Remaining: [what's left]"
-```
-
-Then start fresh session and `/resume $ARGUMENTS` later.

package/dist/template/.opencode/commands/fix-ci.md

@@ -1,109 +0,0 @@
----
-description: Fix CI failures
-argument-hint: "<run-id or url>"
-agent: build
----
-
-# Fix CI: $ARGUMENTS
-
-CI failures are P0 bugs. Fix fast.
-
-## Get The Logs
-
-!`gh run view $ARGUMENTS --log-failed`
-
-List recent failures:
-
-!`gh run list --status=failure --limit=5`
-
-## Extract The Error
-
-!`gh run view $ARGUMENTS --json jobs --jq '.jobs[] | select(.conclusion=="failure")'`
-
-!`gh run view $ARGUMENTS --log > /tmp/ci-log.txt && grep -i "error\|failed" /tmp/ci-log.txt | head -30`
-
-Identify:
-
-- **Job** that failed
-- **Step** in that job
-- **Error message** exact text
-
-## Common Patterns
-
-| Pattern        | Symptoms                | Fix                                |
-| -------------- | ----------------------- | ---------------------------------- |
-| Dependency     | "module not found"      | `rm -rf node_modules && npm ci`    |
-| Environment    | Works locally, fails CI | Check Node version, env vars       |
-| Type error     | "tsc" failed            | `npm run type-check` locally first |
-| Lint error     | ESLint failed           | `npm run lint -- --fix`            |
-| Test flaky     | Intermittent            | Add retries, fix race condition    |
-| Secret missing | "secret not found"      | Check repo settings                |
-
-## Reproduce Locally
-
-```bash
-npm ci
-npm run build
-npm test
-npm run lint
-```
-
-If passes locally but fails in CI, check environment differences.
-
-## Fix And Verify
-
-Make the fix. Verify locally:
-
-```bash
-npm run build && npm test && npm run lint && npm run type-check
-```
-
-## Push And Watch
-
-!`gh run watch`
-
-## If Still Failing
-
-Iterate:
-
-1. Fetch new logs
-2. Identify remaining error
-3. Fix and push again
-4. Max 3 iterations, then escalate
-
-If fix makes things worse:
-
-```bash
-git revert HEAD
-git push
-```
-
-## Document
-
-If it's a recurring issue:
-
-```typescript
-observation({
-  type: "bugfix",
-  title: "CI: [issue]",
-  content: "Root cause: [what]\nFix: [how]\nPrevention: [future]",
-});
-```
-
-## Sync
-
-```bash
-bd sync
-```
-
-## Output
-
-```
-CI Fixed: $ARGUMENTS
-
-Root cause: [brief]
-Changes: [files]
-
-New run: [url]
-Status: Passed ✓
-```

package/dist/template/.opencode/commands/fix-types.md

@@ -1,104 +0,0 @@
----
-description: Fix TypeScript type errors
-argument-hint: "[bead-id] [--strict]"
-agent: build
----
-
-# Fix Type Errors
-
-Resolve TypeScript errors without adding `any` everywhere.
-
-## Get Current State
-
-!`npx tsc --noEmit 2>&1 | head -50`
-!`npx tsc --noEmit 2>&1 | grep -c "error TS"`
-
-## Use LSP For Context
-
-```typescript
-lsp_lsp_diagnostics({ filePath: "<file>", severity: "error" });
-lsp_lsp_hover({ filePath: "<file>", line: N, character: N });
-```
-
-## Common Fixes
-
-**Missing type:**
-
-```typescript
-// Before
-function process(data) { ... }
-// After
-function process(data: InputType): OutputType { ... }
-```
-
-**Null handling:**
-
-```typescript
-// Before
-const name = user.name.toUpperCase();
-// After
-const name = user?.name?.toUpperCase() ?? "Unknown";
-```
-
-**Property doesn't exist:**
-
-```typescript
-// Add to interface
-interface User {
-  name: string;
-  email?: string; // Add missing property
-}
-```
-
-## Rules
-
-- ❌ Never use `any` just to pass type check
-- ❌ Never use `// @ts-ignore` without justification
-- ❌ Never use `as unknown as T`
-- ✅ Prefer proper typing over assertions
-- ✅ Prefer narrowing with type guards
-- ✅ Prefer `unknown` over `any` when truly unknown
-
-## Iterate Until Clean
-
-```bash
-npx tsc --noEmit
-```
-
-Repeat until 0 errors. Max 5 passes.
-
-## Verify
-
-```bash
-npx tsc --noEmit  # Types
-npm test          # Tests still pass
-npm run lint      # Lint still passes
-```
-
-## Commit
-
-```bash
-git add <files>
-git commit -m "fix(types): resolve type errors
-
-- Fixed [N] errors
-- No 'any' types added"
-
-bd sync
-```
-
-## Output
-
-```
-Type Errors Fixed
-
-Before: [N] errors
-After: 0 errors
-
-Verification:
-- Types: ✓
-- Tests: ✓
-- Lint: ✓
-
-'any' added: 0 ✓
-```

package/dist/template/.opencode/commands/fix-ui.md

@@ -1,117 +0,0 @@
----
-description: Fix UI issues with visual verification
-argument-hint: "<issue or bead-id> [--a11y]"
-agent: build
----
-
-# Fix UI: $ARGUMENTS
-
-Fix visual issues. Capture before/after, verify responsiveness.
-
-## Load Context
-
-!`bd show $ARGUMENTS`
-!`cat .beads/artifacts/$ARGUMENTS/spec.md 2>/dev/null`
-
-## Capture Before State
-
-Take screenshot before changes. Save to `.beads/artifacts/$ARGUMENTS/before.png`.
-
-```typescript
-skill({ name: "playwright" });
-skill_mcp({
-  skill_name: "playwright",
-  tool_name: "browser_screenshot",
-  arguments: '{"name": "before-fix"}',
-});
-```
-
-## Analyze
-
-Delegate to @vision:
-
-```typescript
-task({
-  subagent_type: "vision",
-  description: "Analyze UI issue",
-  prompt:
-    "Analyze UI issue: $ARGUMENTS\n\nIdentify:\n- The visual problem\n- Affected components\n- Suggested fix approach",
-});
-```
-
-## Check Design System
-
-!`grep -r "var(--" src/styles/ | head -10`
-!`grep -r "theme\." src/components/ | head -10`
-
-Use existing tokens, not hardcoded values:
-
-- ✅ Existing color tokens
-- ✅ Existing spacing scale
-- ✅ Existing typography scale
-- ❌ Hardcoded colors/px values
-
-## Avoid AI Slop
-
-| Avoid                      | Use Instead             |
-| -------------------------- | ----------------------- |
-| Inter/system-ui everywhere | Distinctive fonts       |
-| Purple/blue gradients      | Project color palette   |
-| Flat backgrounds           | Subtle depth/texture    |
-| Generic rounded corners    | Consistent radius scale |
-
-## Implement Fix
-
-1. Identify affected files
-2. Make minimal CSS/component changes
-3. Use design tokens
-4. Test in browser
-
-## Capture After State
-
-Save to `.beads/artifacts/$ARGUMENTS/after.png`.
-
-## Verify
-
-**Visual:** Compare before/after screenshots
-
-**Responsive:** Test at 375px, 768px, 1280px
-
-**A11y (if --a11y):**
-
-- Color contrast (4.5:1 for text)
-- Keyboard navigation
-- Focus states visible
-
-**Tests:**
-
-```bash
-npm test -- --grep "component-name"
-```
-
-## Commit
-
-```bash
-git add <files>
-git commit -m "fix(ui): [description]"
-
-bd sync
-```
-
-## Output
-
-```
-UI Fixed: $ARGUMENTS
-
-Before: .beads/artifacts/$ARGUMENTS/before.png
-After: .beads/artifacts/$ARGUMENTS/after.png
-
-Verification:
-- Visual: ✓
-- Responsive: ✓
-- A11y: [✓/⚠️]
-- Tests: ✓
-
-Design tokens: Used ✓
-AI slop: None ✓
-```

package/dist/template/.opencode/commands/fix.md

@@ -1,168 +0,0 @@
----
-description: Debug and fix an issue
-argument-hint: "<issue or bead-id> [--quick]"
-agent: build
----
-
-# Fix: $ARGUMENTS
-
-You're debugging and fixing an issue. Understand before you fix.
-
-## Load Context
-
-If `$ARGUMENTS` is a bead ID:
-
-!`bd show $ARGUMENTS`
-!`cat .beads/artifacts/$ARGUMENTS/spec.md 2>/dev/null`
-
-## Parse The Error
-
-Extract from the issue:
-
-- **Error message** - exact text
-- **Stack trace** - file:line references
-- **Reproduction** - steps to trigger
-- **Expected vs Actual** - what should happen vs what happens
-
-## Estimate Complexity
-
-- **S** (~10 calls): Error points to exact line, obvious fix
-- **M** (~30 calls): Clear reproduction, known area
-- **L** (~100 calls): Intermittent, multiple files, needs investigation
-- **XL**: Should be decomposed or researched first
-
-If `--quick` flag: Skip deep analysis, fix directly.
-
-## Quick Fix (S or --quick)
-
-1. Go to error location
-2. Identify obvious cause
-3. Make minimal fix
-4. Run targeted test
-5. Commit
-
-## Systematic Debug (M/L)
-
-Load the debugging skill:
-
-```typescript
-skill({ name: "systematic-debugging" });
-```
-
-**Phase 1: Root Cause (NO fixes yet)**
-
-Read error location. Trace data flow backward. Check recent changes:
-
-!`git log -p --since="1 week ago" -- <file>`
-
-Form a hypothesis. Write it down before fixing anything.
-
-**Phase 2: Reproduce**
-
-Write a failing test that reproduces the bug:
-
-```bash
-npm test -- --grep "<bug-related>"
-```
-
-Verify it fails for the right reason.
-
-**Phase 3: Fix**
-
-Make the fix. Verify test passes. Run full suite:
-
-```bash
-npm test
-npm run type-check
-```
-
-## Rollback Strategy
-
-Before making changes:
-
-```bash
-git stash  # or note current commit
-```
-
-If fix makes things worse:
-
-```bash
-git checkout -- <file>
-```
-
-## Document Root Cause
-
-Create observation:
-
-```typescript
-observation({
-  type: "bugfix",
-  title: "[brief description]",
-  content: "Root cause: [what]\nFix: [how]\nPrevention: [future]",
-  bead_id: "$ARGUMENTS",
-});
-```
-
-If it's a gotcha worth remembering, update `project/gotchas.md`.
-
-## Complete
-
-If all verifications pass:
-
-```bash
-git add <files>
-git status
-git diff --cached --stat
-```
-
-**Use question tool to get commit decision:**
-
-```typescript
-question({
-  questions: [
-    {
-      header: "Commit",
-      question: "Fix Complete: $ARGUMENTS. What should I do next?",
-      options: [
-        {
-          label: "Commit changes (Recommended)",
-          description: "Git commit and bd sync",
-        },
-        {
-          label: "Show diff first",
-          description: "Review changes before committing",
-        },
-        {
-          label: "Skip commit",
-          description: "I'll review and commit manually",
-        },
-      ],
-    },
-  ],
-});
-```
-
-If user confirms:
-
-```bash
-git commit -m "fix: [description]
-
-Root cause: [brief]
-$ARGUMENTS"
-
-bd sync
-```
-
-## Output
-
-```
-Fixed: $ARGUMENTS
-
-Root cause: [brief]
-Changes: [files]
-Tests: Pass
-
-Next:
-- /finish $ARGUMENTS  # Close the bead
-- /pr $ARGUMENTS      # Create PR
-```