opencodekit 0.15.21 → 0.16.0

package/dist/template/.opencode/command/edit-image.md

@@ -1,242 +0,0 @@
----
-description: Edit image with natural language instructions
-argument-hint: "<image-path> <edit-instruction> [--hd] [--preserve-size] [--compare]"
-agent: painter
----
-
-# Edit Image: $ARGUMENTS
-
-Edit an existing image using natural language instructions.
-
-## Parse Arguments
-
-Extract from `$ARGUMENTS`:
-
-| Argument          | Required | Description                    |
-| ----------------- | -------- | ------------------------------ |
-| Image path        | Yes      | Path to source image           |
-| Edit instruction  | Yes      | Natural language edit request  |
-| `--hd`            | No       | Higher quality output (slower) |
-| `--preserve-size` | No       | Maintain original dimensions   |
-| `--compare`       | No       | Output before/after comparison |
-
----
-
-## Edit Types & What Works
-
-### Works Well
-
-| Edit Type                  | Example                                   | Success Rate |
-| -------------------------- | ----------------------------------------- | ------------ |
-| **Background removal**     | "remove the background"                   | High         |
-| **Background replacement** | "replace background with beach sunset"    | High         |
-| **Color changes**          | "change the shirt to blue"                | High         |
-| **Style transfer**         | "make it look like a watercolor painting" | High         |
-| **Add elements**           | "add a hat to the person"                 | Medium-High  |
-| **Remove objects**         | "remove the car from the image"           | Medium-High  |
-| **Lighting adjustments**   | "make it look like golden hour"           | High         |
-| **Extend canvas**          | "extend the image to the right"           | Medium       |
-
-### Works Poorly (Set Expectations)
-
-| Edit Type                       | Why It's Hard                  | Alternative             |
-| ------------------------------- | ------------------------------ | ----------------------- |
-| **Text changes**                | AI struggles with precise text | Use image editor        |
-| **Face/hand details**           | Often distorts                 | Mask specific region    |
-| **Precise positioning**         | "Move object 50px left"        | Use coordinates in mask |
-| **Multiple simultaneous edits** | Conflicts                      | Do one edit at a time   |
-| **Preserving fine details**     | May blur/change                | Use `--preserve-size`   |
-
----
-
-## Process
-
-1. **Load** the source image from path
-2. **Analyze** the original (note key features to preserve)
-3. **Interpret** the edit instruction
-4. **Apply** the edit, preserving unaffected areas
-5. **Save** with versioning to track iterations
-6. **Compare** if `--compare` flag set
-
----
-
-## Common Edit Patterns
-
-### Background Operations
-
-```bash
-# Remove background (transparent)
-/edit-image photo.jpg remove the background
-
-# Replace background
-/edit-image photo.jpg replace background with a modern office
-
-# Extend/outpaint
-/edit-image landscape.jpg extend the sky upward
-```
-
-### Color & Style
-
-```bash
-# Color change
-/edit-image product.jpg change the product color to red
-
-# Style transfer
-/edit-image photo.jpg convert to anime style
-
-# Mood change
-/edit-image scene.jpg make it look like nighttime with city lights
-```
-
-### Object Manipulation
-
-```bash
-# Add object
-/edit-image room.jpg add a plant in the corner
-
-# Remove object
-/edit-image street.jpg remove the person on the left
-
-# Replace object
-/edit-image desk.jpg replace the laptop with a typewriter
-```
-
-### Enhancement
-
-```bash
-# Lighting
-/edit-image portrait.jpg add dramatic studio lighting
-
-# Quality
-/edit-image old-photo.jpg enhance and sharpen, remove grain --hd
-
-# Composition
-/edit-image product.jpg add subtle shadow underneath
-```
-
----
-
-## Output
-
-### Standard Output
-
-```markdown
-## Edit Complete
-
-**Source:** `path/to/original.jpg`
-**Edit:** "remove the background"
-**Output:** `.opencode/memory/design/edited/original-v1-bg-removed.png`
-
-### Original Analysis
-
-- Dimensions: 1920x1080
-- Key elements: Person in center, office background
-- Preserved: Person, clothing, pose
-
-### Edit Applied
-
-- Background detected and removed
-- Edges refined with feathering
-- Output format: PNG (transparent)
-
-### Refinements Available
-
-- "Soften the edges more"
-- "Keep the shadow underneath"
-- "Make background white instead of transparent"
-```
-
-### Comparison Output (--compare)
-
-```markdown
-## Before/After Comparison
-
-| Aspect     | Before       | After       |
-| ---------- | ------------ | ----------- |
-| Background | Office scene | Transparent |
-| Subject    | Unchanged    | Unchanged   |
-| Dimensions | 1920x1080    | 1920x1080   |
-| File size  | 450KB        | 380KB       |
-
-**Visual diff:** Key changes highlighted in output
-```
-
----
-
-## Version History
-
-Edits are saved with version tracking:
-
-```
-.opencode/memory/design/edited/
-├── photo-v1-bg-removed.png      # First edit
-├── photo-v2-color-change.png    # Second edit
-├── photo-v3-add-shadow.png      # Third edit
-└── photo-history.json           # Edit history
-```
-
-**History file:**
-
-```json
-{
-  "source": "photo.jpg",
-  "edits": [
-    { "v": 1, "instruction": "remove background", "timestamp": "..." },
-    { "v": 2, "instruction": "change shirt to blue", "timestamp": "..." }
-  ]
-}
-```
-
-To revert: Reference previous version as source.
-
----
-
-## Tips for Better Results
-
-1. **Be specific**: "Add a red baseball cap" > "add a hat"
-2. **One edit at a time**: Chain simple edits for complex changes
-3. **Describe what to keep**: "Change background but keep the shadow"
-4. **Use style references**: "Make it look like a Pixar movie"
-5. **Specify format needs**: "Remove background, keep as PNG with transparency"
-
----
-
-## Limitations
-
-- **Text editing**: AI cannot reliably modify or add text
-- **Precise geometry**: Exact pixel-level positioning not supported
-- **Faces**: May alter facial features unintentionally
-- **Hands**: Often produces artifacts
-- **Multiple subjects**: May struggle to isolate specific elements
-- **Brand logos**: May distort or refuse (safety filters)
-
-For precise edits, consider: Photoshop, GIMP, or Figma.
-
----
-
-## Examples
-
-```bash
-# Basic edit
-/edit-image screenshot.png remove the background
-
-# High quality with comparison
-/edit-image product.jpg enhance lighting and add reflection --hd --compare
-
-# Preserve dimensions
-/edit-image banner.png change the color scheme to dark mode --preserve-size
-
-# Style transfer
-/edit-image photo.jpg convert to oil painting style --hd
-```
-
----
-
-## Related Commands
-
-| Need               | Command           |
-| ------------------ | ----------------- |
-| Generate new image | `/generate-image` |
-| Analyze image      | `/analyze-mockup` |
-| Restore old photo  | `/restore-image`  |
-| Create icon        | `/generate-icon`  |

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

@@ -1,255 +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" });
-skill({ name: "beads-bridge" }); // For todo sync
-```
-
-## 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]"
-```
-
-## Cleanup Swarm State (If Any)
-
-Clear any swarm data associated with this task:
-
-```typescript
-const teamName = "$ARGUMENTS-swarm";
-
-// Clear swarm state
-await swarm_monitor({
-  operation: "clear",
-  team_name: teamName,
-});
-
-// Sync completed todos back to beads
-beads_sync({ operation: "pull" });
-```
-
-## 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/command/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/command/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 ✓
-```