@snarkipus/opencode-beads 0.8.0

package/vendor/commands/template.md

@@ -0,0 +1,337 @@
+# bd template
+
+Manage issue templates for streamlined issue creation.
+
+## Synopsis
+
+Templates provide pre-filled structures for common issue types, making it faster to create well-formed issues with consistent formatting.
+
+```bash
+bd template list
+bd template show <template-name>
+bd template create <template-name>
+```
+
+## Description
+
+Templates can be:
+- **Built-in**: Provided by bd (epic, bug, feature)
+- **Custom**: Stored in `.beads/templates/` directory
+
+Each template defines default values for:
+- Description structure with placeholders
+- Issue type (bug, feature, task, epic, chore)
+- Priority (0-4)
+- Labels
+- Design notes structure
+- Acceptance criteria structure
+
+## Commands
+
+### list
+
+List all available templates (built-in and custom).
+
+```bash
+bd template list
+bd template list --json
+```
+
+**Examples:**
+
+```bash
+$ bd template list
+Built-in Templates:
+  epic
+    Type: epic, Priority: P1
+    Labels: epic
+  bug
+    Type: bug, Priority: P1
+    Labels: bug
+  feature
+    Type: feature, Priority: P2
+    Labels: feature
+```
+
+### show
+
+Show detailed structure of a specific template.
+
+```bash
+bd template show <template-name>
+bd template show <template-name> --json
+```
+
+**Examples:**
+
+```bash
+$ bd template show bug
+Template: bug
+Type: bug
+Priority: P1
+Labels: bug
+
+Description:
+## Summary
+
+[Brief description of the bug]
+
+## Steps to Reproduce
+...
+```
+
+### create
+
+Create a custom template in `.beads/templates/` directory.
+
+```bash
+bd template create <template-name>
+```
+
+This creates a YAML file with default structure that you can edit to customize.
+
+**Examples:**
+
+```bash
+$ bd template create performance
+✓ Created template: .beads/templates/performance.yaml
+Edit the file to customize your template.
+
+$ cat .beads/templates/performance.yaml
+name: performance
+description: |-
+    [Describe the issue]
+    
+    ## Additional Context
+    
+    [Add relevant details]
+type: task
+priority: 2
+labels: []
+design: '[Design notes]'
+acceptance_criteria: |-
+    - [ ] Acceptance criterion 1
+    - [ ] Acceptance criterion 2
+
+# Edit the template to customize it
+$ vim .beads/templates/performance.yaml
+```
+
+## Using Templates with `bd create`
+
+Use the `--from-template` flag to create issues from templates:
+
+```bash
+bd create --from-template <template-name> "Issue title"
+```
+
+Template values can be overridden with explicit flags:
+
+```bash
+# Use bug template but override priority
+bd create --from-template bug "Login crashes on special chars" -p 0
+
+# Use epic template but add extra labels
+bd create --from-template epic "Q4 Infrastructure" -l infrastructure,ops
+```
+
+**Examples:**
+
+```bash
+# Create epic from template
+$ bd create --from-template epic "Phase 3 Features"
+✓ Created issue: bd-a3f8e9
+  Title: Phase 3 Features
+  Priority: P1
+  Status: open
+
+# Create bug report from template
+$ bd create --from-template bug "Auth token validation fails"
+✓ Created issue: bd-42bc7a
+  Title: Auth token validation fails
+  Priority: P1
+  Status: open
+
+# Use custom template
+$ bd template create security-audit
+$ bd create --from-template security-audit "Review authentication flow"
+```
+
+## Template File Format
+
+Templates are YAML files with the following structure:
+
+```yaml
+name: template-name
+description: |
+  Multi-line description with placeholders
+  
+  ## Section heading
+  
+  [Placeholder text]
+
+type: bug|feature|task|epic|chore
+priority: 0-4
+labels:
+  - label1
+  - label2
+
+design: |
+  Design notes structure
+
+acceptance_criteria: |
+  - [ ] Acceptance criterion 1
+  - [ ] Acceptance criterion 2
+```
+
+## Built-in Templates
+
+### epic
+
+For large features composed of multiple issues.
+
+**Structure:**
+- Overview and scope
+- Success criteria checklist
+- Background and motivation
+- In-scope / out-of-scope sections
+- Architecture design notes
+- Component breakdown
+
+**Defaults:**
+- Type: epic
+- Priority: P1
+- Labels: epic
+
+### bug
+
+For bug reports with consistent structure.
+
+**Structure:**
+- Summary
+- Steps to reproduce
+- Expected vs actual behavior
+- Environment details
+- Root cause analysis (design)
+- Proposed fix
+- Impact assessment
+
+**Defaults:**
+- Type: bug
+- Priority: P1
+- Labels: bug
+
+### feature
+
+For feature requests and enhancements.
+
+**Structure:**
+- Feature description
+- Motivation and use cases
+- Proposed solution
+- Alternatives considered
+- Technical design
+- API changes
+- Testing strategy
+
+**Defaults:**
+- Type: feature
+- Priority: P2
+- Labels: feature
+
+## Custom Templates
+
+Custom templates override built-in templates with the same name. This allows you to customize built-in templates for your project.
+
+**Priority:**
+1. Custom templates in `.beads/templates/`
+2. Built-in templates
+
+**Example - Override bug template:**
+
+```bash
+# Create custom bug template
+$ bd template create bug
+
+# Edit to add project-specific fields
+$ cat > .beads/templates/bug.yaml << 'EOF'
+name: bug
+description: |
+  ## Bug Report
+  
+  **Severity:** [critical|high|medium|low]
+  **Component:** [auth|api|frontend|backend]
+  
+  ## Description
+  [Describe the bug]
+  
+  ## Reproduction
+  1. Step 1
+  2. Step 2
+  
+  ## Impact
+  [Who is affected? How many users?]
+
+type: bug
+priority: 0
+labels:
+  - bug
+  - needs-triage
+
+design: |
+  ## Investigation Notes
+  [Technical details]
+
+acceptance_criteria: |
+  - [ ] Bug fixed and verified
+  - [ ] Tests added
+  - [ ] Monitoring added
+EOF
+
+# Now 'bd create --from-template bug' uses your custom template
+```
+
+## JSON Output
+
+All template commands support `--json` flag for programmatic use:
+
+```bash
+$ bd template list --json
+[
+  {
+    "name": "epic",
+    "description": "## Overview...",
+    "type": "epic",
+    "priority": 1,
+    "labels": ["epic"],
+    "design": "## Architecture...",
+    "acceptance_criteria": "- [ ] All child issues..."
+  }
+]
+
+$ bd template show bug --json
+{
+  "name": "bug",
+  "description": "## Summary...",
+  "type": "bug",
+  "priority": 1,
+  "labels": ["bug"],
+  "design": "## Root Cause...",
+  "acceptance_criteria": "- [ ] Bug no longer..."
+}
+```
+
+## Best Practices
+
+1. **Use templates for consistency**: Establish team conventions for common issue types
+2. **Customize built-ins**: Override built-in templates to match your workflow
+3. **Version control templates**: Commit `.beads/templates/` to share across team
+4. **Keep templates focused**: Create specific templates (e.g., `performance`, `security-audit`) rather than generic ones
+5. **Use placeholders**: Mark sections requiring input with `[brackets]` or `TODO`
+6. **Include checklists**: Use `- [ ]` for actionable items in description and acceptance criteria
+
+## See Also
+
+- [bd create](create.md) - Create issues
+- [bd list](list.md) - List issues
+- [README](../README.md) - Main documentation

package/vendor/commands/update.md

@@ -0,0 +1,24 @@
+---
+description: Update an issue's status, priority, or other fields
+argument-hint: [issue-id] [status]
+---
+
+Update a beads issue.
+
+If arguments are provided:
+- $1: Issue ID
+- $2: New status (open, in_progress, blocked, closed)
+
+If arguments are missing, ask the user for:
+1. Issue ID
+2. What to update (status, priority, assignee, title, description)
+3. New value
+
+Use the beads MCP `update` tool to apply the changes. Show the updated issue to confirm the change.
+
+**Note:** Comments are managed separately with `bd comments add`. The `update` command is for singular, versioned properties (title, status, priority, etc.), while comments form a discussion thread that's appended to, not updated.
+
+Common workflows:
+- Start work: `bd update <id> --claim` (atomic claim + `in_progress`)
+- Mark blocked: Update status to `blocked`
+- Reprioritize: Update priority (0-4)

package/vendor/commands/version.md

@@ -0,0 +1,26 @@
+---
+description: Check beads and plugin versions
+---
+
+Check the installed versions of beads components and verify compatibility.
+
+**Note:** The MCP server automatically checks bd CLI version >= 0.9.0 on startup. This command provides detailed version info and update instructions.
+
+Use the beads MCP tools to:
+1. Run `bd version` via bash to get the CLI version
+2. Check the plugin version (0.9.2)
+3. Compare versions and report any mismatches
+
+Display:
+- bd CLI version (from `bd version`)
+- Plugin version (0.9.2)
+- MCP server version (0.9.2)
+- MCP server status (from `stats` tool or connection test)
+- Compatibility status (✓ compatible or ⚠️ update needed)
+
+If versions are mismatched, provide instructions:
+- Update bd CLI: `curl -fsSL https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh | bash`
+- Update plugin: `/plugin update beads`
+- Restart Claude Code after updating
+
+Suggest checking for updates if the user is on an older version.

package/vendor/commands/workflow.md

@@ -0,0 +1,58 @@
+---
+description: Show the AI-supervised issue workflow guide
+---
+
+Display the beads workflow for AI agents and developers.
+
+# Beads Workflow
+
+Beads is an issue tracker designed for AI-supervised coding workflows. Here's how to use it effectively:
+
+## 1. Find Ready Work
+Use `/beads:ready` or the `ready` MCP tool to see tasks with no blockers.
+
+## 2. Claim Your Task
+Claim the issue atomically (assignee + `in_progress` in one step):
+- Via command: `/beads:update <id> --claim`
+- Via MCP tool: `claim` with `issue_id: "<id>"`
+
+## 3. Work on It
+Implement, test, and document the feature or fix.
+
+## 4. Discover New Work
+As you work, you'll often find bugs, TODOs, or related work:
+- Create issues: `/beads:create` or `create` MCP tool
+- Link them: Use `dep` MCP tool with `type: "discovered-from"`
+- This maintains context and work history
+
+## 5. Complete the Task
+Close the issue when done:
+- Via command: `/beads:close <id> "Completed: <summary>"`
+- Via MCP tool: `close` with reason
+
+## 6. Check What's Unblocked
+After closing, check if other work became ready:
+- Use `/beads:ready` to see newly unblocked tasks
+- Start the cycle again
+
+## Tips
+- **Priority levels**: 0=critical, 1=high, 2=medium, 3=low, 4=backlog
+- **Issue types**: bug, feature, task, epic, chore
+- **Dependencies**: Use `blocks` for hard dependencies, `related` for soft links
+- **Auto-sync**: Changes are stored in Dolt and synced via `bd dolt push` / `bd dolt pull`
+
+## Available Commands
+- `/beads:ready` - Find unblocked work
+- `/beads:create` - Create new issue
+- `/beads:show` - Show issue details
+- `/beads:update` - Update issue
+- `/beads:close` - Close issue
+- `/beads:workflow` - Show this guide (you are here!)
+
+## MCP Tools Available
+Use these via the beads MCP server:
+- `ready`, `list`, `show`, `create`, `claim`, `update`, `close`
+- `dep` (manage dependencies), `blocked`, `stats`
+- `init` (initialize bd in a project)
+
+For more details, see the beads README at: https://github.com/gastownhall/beads

package/vendor/manifest.json

@@ -0,0 +1,168 @@
+{
+  "schemaVersion": 1,
+  "repository": "https://github.com/gastownhall/beads.git",
+  "tag": "v1.1.0",
+  "commit": "8e4e59d39f3459a43cf21a3236a13eca4dd874f7",
+  "sources": [
+    {
+      "source": "plugins/beads/agents/task-agent.md",
+      "target": "agents/task-agent.md"
+    },
+    {
+      "source": "plugins/beads/skills/beads/commands",
+      "target": "commands"
+    }
+  ],
+  "files": [
+    {
+      "path": "agents/task-agent.md",
+      "bytes": 1971,
+      "sha256": "d5dd212e4f6324cf9f979eb8ed96ee094174c3e0cda8e217e55643244a7f4a79"
+    },
+    {
+      "path": "commands/audit.md",
+      "bytes": 955,
+      "sha256": "8a7f942b3b94576f8503cba282c9144953991ab2a76926323ab6ee895d33b9c5"
+    },
+    {
+      "path": "commands/blocked.md",
+      "bytes": 561,
+      "sha256": "14822b644bb93d9f038107aaccf1eb5112e3e0b1cb0b9c013cb6dffbfe570335"
+    },
+    {
+      "path": "commands/close.md",
+      "bytes": 583,
+      "sha256": "413946f6210b743398e1510a9806ac1c51c6d6e994d020e7e122062cc69ffd97"
+    },
+    {
+      "path": "commands/comments.md",
+      "bytes": 965,
+      "sha256": "9680911b297bdf24cb943c5dd7f71812cd60e0f9ef52a57bf1832110e02d5efc"
+    },
+    {
+      "path": "commands/compact.md",
+      "bytes": 1081,
+      "sha256": "0fc6810f4e4da2d521d747c50c73e3a388bf16a94dc47ddf241a52826071d766"
+    },
+    {
+      "path": "commands/create.md",
+      "bytes": 649,
+      "sha256": "f70104bd3792e5f005d0d7f2901c2b56da7f0136bf279f6d36e36d89b553bb93"
+    },
+    {
+      "path": "commands/decision.md",
+      "bytes": 2662,
+      "sha256": "d62efc7e0d0bcd3a080e825b315acbf42c024d937382d8b8cf83b47016d4f908"
+    },
+    {
+      "path": "commands/delete.md",
+      "bytes": 959,
+      "sha256": "90424c81aac3d2b12379820aa0b6f5e37a60a0da33474d28c66e0422b8361532"
+    },
+    {
+      "path": "commands/dep.md",
+      "bytes": 3408,
+      "sha256": "2679ab80bfade1f6d4769ecef2575b196592c919cc36912e9fa8f29ab2a7d9f5"
+    },
+    {
+      "path": "commands/epic.md",
+      "bytes": 858,
+      "sha256": "b31ffcfc2a423684f153042a0cb67b2d0472b63da594691b3c2656ed00cf2d6c"
+    },
+    {
+      "path": "commands/export.md",
+      "bytes": 789,
+      "sha256": "dc021e36c11c3ad2724f3097c6f461221d77e5bd26296e6db65b8bd5f5190be0"
+    },
+    {
+      "path": "commands/import.md",
+      "bytes": 401,
+      "sha256": "4f2b270a3f55d5b48f615864c07408bec3b339cd9ccab581e1e3c7c6ecd27e0e"
+    },
+    {
+      "path": "commands/init.md",
+      "bytes": 751,
+      "sha256": "68413502bcb73f25cbf7505e3951967bffb8e125f6647e98018588558171abae"
+    },
+    {
+      "path": "commands/label.md",
+      "bytes": 896,
+      "sha256": "82b702f10b31caf1c538119a5ae70603c88a7534de33bec2662b67a039a45572"
+    },
+    {
+      "path": "commands/list.md",
+      "bytes": 2626,
+      "sha256": "a986fdc0400c5e637f9e2103775f6b0c0297e48f96b0d2d1f8ecd15f14b7c524"
+    },
+    {
+      "path": "commands/prime.md",
+      "bytes": 363,
+      "sha256": "4b0559e792c2ea8ead359954896eca8518cd311303637b2e1c542e65b9d960b8"
+    },
+    {
+      "path": "commands/quickstart.md",
+      "bytes": 469,
+      "sha256": "ee1d55aad65e7f5d293a394517964719b1bff1e4d7c92ccf55e2125608473bee"
+    },
+    {
+      "path": "commands/ready.md",
+      "bytes": 568,
+      "sha256": "48a42cab07b8580b0436bbddf5dd409333ff3b402bb4fee7af39b3aa3b078856"
+    },
+    {
+      "path": "commands/rename-prefix.md",
+      "bytes": 599,
+      "sha256": "0315a4e4c8ddfd3ec6006f30f80de69c25d1cf3cab43d6bfa3d657b551437b60"
+    },
+    {
+      "path": "commands/reopen.md",
+      "bytes": 593,
+      "sha256": "db2927072ffbc3dbde644a123f877e4cb9a46df87c1252ab1256f8fa1f75a41e"
+    },
+    {
+      "path": "commands/restore.md",
+      "bytes": 712,
+      "sha256": "8cda7ebcaa572572cf55e4f1a2b15e028a01f7c373842c941c7f6fabbcecb4d2"
+    },
+    {
+      "path": "commands/search.md",
+      "bytes": 3188,
+      "sha256": "5d07fd4bd26bd90a31f2d0c58b8e1245234f3a897c2d2fe326b5f372ea2a9ecd"
+    },
+    {
+      "path": "commands/show.md",
+      "bytes": 561,
+      "sha256": "e170d3d532954aeea5c20eb2b1ea96625f17069d2cd6f9ff81317c05c13dda80"
+    },
+    {
+      "path": "commands/stats.md",
+      "bytes": 617,
+      "sha256": "f4da8a61fb7922ece1da727f7cfe2e020def6deed7cb2ce807cc6ab6c6d02aca"
+    },
+    {
+      "path": "commands/sync.md",
+      "bytes": 493,
+      "sha256": "7ac9938d0e5ec0514edefc240971b4a0aade61cffca75efefac4011117d53ebb"
+    },
+    {
+      "path": "commands/template.md",
+      "bytes": 6641,
+      "sha256": "dd8865a9556ac67c49e83b7db9ad085e3e1ebf2e187fd6c407a0e116dbfb712b"
+    },
+    {
+      "path": "commands/update.md",
+      "bytes": 868,
+      "sha256": "ff12a4ac6a686a11e2a029aac7070829051662027a868794717b1d3fee255d66"
+    },
+    {
+      "path": "commands/version.md",
+      "bytes": 975,
+      "sha256": "f994ab7afb0aef464fe0e77e7aad522d5f2d1558415d4ba63aede43a7411a075"
+    },
+    {
+      "path": "commands/workflow.md",
+      "bytes": 1987,
+      "sha256": "23ce9fbfe8acf49df1b4ddba8f908f4a3ef724c6d9203358c180d019e683978c"
+    }
+  ]
+}