opencode-beads 0.3.0 → 0.3.2

package/README.md

@@ -12,14 +12,18 @@ curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/insta
 
 See the [beads installation guide](https://github.com/steveyegge/beads/blob/main/docs/INSTALLING.md) for alternative methods (Homebrew, Windows, AUR, etc.).
 
-Add to your `opencode.json`:
+Add to your OpenCode config (`~/.config/opencode/opencode.json`):
 
 ```json
 {
-  "plugin": ["opencode-beads"]
+  "plugin": ["opencode-beads@0.3.2"]
 }
 ```
 
+Restart OpenCode and you're ready to go.
+
+Pin to a specific version to ensure updates work correctly - OpenCode's lockfile won't re-resolve unpinned versions. To upgrade, change the version and restart.
+
 ## Features
 
 - **Context injection** - Automatically runs `bd prime` on session start and after compaction, keeping your agent aware of current issues

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-beads",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "type": "module",
   "description": "A plugin for OpenCode that provides integration with the beads issue tracker.",
   "author": "Josh Thomas <josh@joshthomas.dev>",

package/vendor/commands/comments.md

@@ -5,6 +5,8 @@ argument-hint: [issue-id]
 
 View or add comments to a beads issue.
 
+Comments are separate from issue properties (title, description, etc.) because they serve a different purpose: they're a **discussion thread** rather than **singular editable fields**. Use `bd comments` for threaded conversations and `bd edit` for core issue metadata.
+
 ## View Comments
 
 To view all comments on an issue:

package/vendor/commands/compact.md

@@ -12,11 +12,11 @@ Reduce database size by summarizing closed issues no longer actively referenced.
 
 ## Usage
 
-- **Preview candidates**: `bd compact --dry-run`
-- **Compact all eligible**: `bd compact --all`
-- **Compact specific issue**: `bd compact --id bd-42`
-- **Force compact**: `bd compact --id bd-42 --force` (bypass age checks)
-- **View statistics**: `bd compact --stats`
+- **Preview candidates**: `bd admin compact --dry-run`
+- **Compact all eligible**: `bd admin compact --all`
+- **Compact specific issue**: `bd admin compact --id bd-42`
+- **Force compact**: `bd admin compact --id bd-42 --force` (bypass age checks)
+- **View statistics**: `bd admin compact --stats`
 
 ## Options
 

package/vendor/commands/quickstart.md

@@ -1,17 +1,13 @@
 ---
-description: Quick start guide for bd workflows
+description: Quick start guide for bd workflows (deprecated)
 argument-hint: []
 ---
 
-Display a quick start guide showing common bd workflows and patterns.
+**Note:** The `bd quickstart` command is deprecated. See [docs/QUICKSTART.md](../docs/QUICKSTART.md) instead.
 
-Use `bd quickstart` to see:
+The quickstart documentation covers:
 - Getting started with bd
 - Common workflow patterns
 - Basic commands
 - Dependency management
 - Git integration
-
-This is an interactive tutorial that walks through the essential bd commands and concepts for new users.
-
-No arguments needed - just run `bd quickstart` to see the full guide.

package/vendor/commands/update.md

@@ -16,6 +16,8 @@ If arguments are missing, ask the user for:
 
 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: Update status to `in_progress`
 - Mark blocked: Update status to `blocked`