opencode-beads 0.5.5 → 0.6.0

package/README.md

@@ -33,7 +33,7 @@ Optionally, pin to a specific version for stability:
 
 ```json
 {
-  "plugin": ["opencode-beads@0.5.5"]
+  "plugin": ["opencode-beads@0.6.0"]
 }
 ```
 

package/package.json

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

package/src/plugin.ts

@@ -14,6 +14,9 @@ import { BEADS_GUIDANCE, loadAgent, loadCommands } from "./vendor";
 
 type OpencodeClient = PluginInput["client"];
 
+/** Name of the plugin's own task agent. Always receives beads context. */
+const BEADS_TASK_AGENT = "beads-task-agent";
+
 /**
  * Get the current model/agent context for a session by querying messages.
  *
@@ -94,6 +97,34 @@ export const BeadsPlugin: Plugin = async ({ client, $ }) => {
 
   const injectedSessions = new Set<string>();
 
+  /**
+   * Check if an agent should receive beads context injection.
+   *
+   * Queries the agent list from OpenCode and checks whether the agent is a
+   * subagent. Subagents (like `explore` and `general`) are invoked for
+   * specific tasks and shouldn't be polluted with beads context — it wastes
+   * tokens and can cause them to attempt pointless bd/git operations.
+   *
+   * Primary agents (`build`, `plan`) are user-facing and benefit from issue
+   * awareness. The plugin's own `beads-task-agent` is an explicit exception.
+   *
+   * Queries fresh each time rather than caching, since agents can change
+   * mid-session (config edits, other plugins). This only runs once per
+   * session (gated by injectedSessions), so the overhead is negligible.
+   */
+  async function shouldInject(agentName: string | undefined): Promise<boolean> {
+    if (!agentName || agentName === BEADS_TASK_AGENT) return true;
+
+    const response = await client.app.agents().catch(() => undefined);
+    const agent = response?.data?.find((a) => a.name === agentName);
+    if (agent) {
+      return agent.mode === "primary" || agent.mode === "all";
+    }
+
+    // Query failed or agent not in the list — inject as safe fallback
+    return true;
+  }
+
   return {
     "chat.message": async (_input, output) => {
       const sessionID = output.message.sessionID;
@@ -101,6 +132,13 @@ export const BeadsPlugin: Plugin = async ({ client, $ }) => {
       // Skip if already injected this session
       if (injectedSessions.has(sessionID)) return;
 
+      // Skip subagents — they're invoked for specific tasks and shouldn't
+      // waste tokens on beads context (except our own beads-task-agent)
+      if (!(await shouldInject(output.message.agent))) {
+        injectedSessions.add(sessionID);
+        return;
+      }
+
       // Check if beads-context was already injected (handles plugin reload/reconnection)
       try {
         const existing = await client.session.messages({
@@ -140,6 +178,10 @@ export const BeadsPlugin: Plugin = async ({ client, $ }) => {
       if (event.type === "session.compacted") {
         const sessionID = event.properties.sessionID;
         const context = await getSessionContext(client, sessionID);
+
+        // Skip re-injection for subagents
+        if (!(await shouldInject(context?.agent))) return;
+
         await injectBeadsContext(client, $, sessionID, context);
       }
     },

package/vendor/commands/audit.md

@@ -23,6 +23,6 @@ Each line is one event. Labeling is done by appending a new `"label"` event refe
 ## Notes
 
 - Audit entries are **append-only** (no in-place edits).
-- `bd sync` includes `.beads/interactions.jsonl` in the commit allowlist.
+- `bd dolt push` includes `.beads/interactions.jsonl` in the commit allowlist.
 
 

package/vendor/commands/import.md

@@ -1,36 +1,18 @@
 ---
-description: Import issues from JSONL format
-argument-hint: [-i input-file]
+description: Import issues from JSONL format (removed)
+argument-hint: (removed)
 ---
 
-Import issues from JSON Lines format (one JSON object per line).
+`bd import` has been **removed**.
 
-## Usage
+## Migration
 
-- **From stdin**: `bd import` (reads from stdin)
-- **From file**: `bd import -i issues.jsonl`
-- **Preview**: `bd import -i issues.jsonl --dry-run`
-
-## Behavior
-
-- **Existing issues** (same ID): Updated with new data
-- **New issues**: Created
-- **Same-ID scenarios**: With hash-based IDs (v0.20.1+), same ID = same issue being updated (not a collision)
-
-## Preview Changes
-
-Use `--dry-run` to see what will change before importing:
+If you need to import issues from a JSONL file, use `bd init` with the `--from-jsonl` flag:
 
 ```bash
-bd import -i issues.jsonl --dry-run
-# Shows: new issues, updates, exact matches
+bd init <prefix> --from-jsonl issues.jsonl
 ```
 
-## When to Use
-
-Dolt is the primary storage backend, so manual import is rarely needed. Use `bd import` when you need to load data from an external JSONL file or migrate from a legacy JSONL-based setup.
-
-## Options
+## Note
 
-- **--skip-existing**: Skip updates to existing issues
-- **--strict**: Fail on dependency errors instead of warnings
+Dolt is the primary storage backend. Manual JSONL import is no longer supported as a standalone command.

package/vendor/commands/workflow.md

@@ -39,7 +39,7 @@ After closing, check if other work became ready:
 - **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 sync`
+- **Auto-sync**: Changes are stored in Dolt and synced via `bd dolt push` / `bd dolt pull`
 
 ## Available Commands
 - `/beads:ready` - Find unblocked work