opencode-beads 0.1.1 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-beads",
-  "version": "0.1.1",
+  "version": "0.2.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

@@ -10,7 +10,7 @@
  */
 
 import type { Plugin, PluginInput } from "@opencode-ai/plugin";
-import { CLI_GUIDANCE, loadAgent, loadCommands } from "./vendor";
+import { BEADS_GUIDANCE, loadAgent, loadCommands } from "./vendor";
 
 type OpencodeClient = PluginInput["client"];
 
@@ -70,7 +70,7 @@ async function injectBeadsContext(
 ${primeOutput.trim()}
 </beads-context>
 
-${CLI_GUIDANCE}`;
+${BEADS_GUIDANCE}`;
 
     // Inject content via noReply + synthetic
     // Must pass model and agent to prevent mode/model switching
@@ -101,16 +101,25 @@ export const BeadsPlugin: Plugin = async ({ client, $ }) => {
       // Skip if already injected this session
       if (injectedSessions.has(sessionID)) return;
 
-      // Check if session already has messages (handles plugin reload/reconnection)
+      // Check if beads-context was already injected (handles plugin reload/reconnection)
       try {
         const existing = await client.session.messages({
           path: { id: sessionID },
-          query: { limit: 1 },
         });
 
-        if (existing.data && existing.data.length > 0) {
-          injectedSessions.add(sessionID);
-          return;
+        if (existing.data) {
+          const hasBeadsContext = existing.data.some(msg => {
+            const parts = (msg as any).parts || (msg.info as any).parts;
+            if (!parts) return false;
+            return parts.some((part: any) =>
+              part.type === 'text' && part.text?.includes('<beads-context>')
+            );
+          });
+
+          if (hasBeadsContext) {
+            injectedSessions.add(sessionID);
+            return;
+          }
         }
       } catch {
         // On error, proceed with injection

package/src/vendor.ts

@@ -84,26 +84,40 @@ async function listVendorFiles(relativePath: string): Promise<string[]> {
   }
 }
 
-export const CLI_GUIDANCE = `<beads-cli-guidance>
-Beads MCP tools are not available. Use the \`bd\` CLI via bash instead:
-
-- \`init\` → \`bd init [prefix]\`
-- \`ready\` → \`bd ready --json\`
-- \`show\` → \`bd show <id> --json\`
-- \`create\` → \`bd create "title" -t bug|feature|task -p 0-4 --json\`
-- \`update\` → \`bd update <id> --status in_progress --json\`
-- \`close\` → \`bd close <id> --reason "message" --json\`
-- \`reopen\` → \`bd reopen <id> --json\`
-- \`dep\` → \`bd dep add <from> <to> --type blocks|discovered-from --json\`
-- \`list\` → \`bd list --status open --json\`
-- \`blocked\` → \`bd blocked --json\`
-- \`stats\` → \`bd stats --json\`
-- \`sync\` → \`bd sync\`
-
-MCP tools map directly to bd CLI commands. If a tool is not listed above, try \`bd <tool> --help\`.
+export const BEADS_GUIDANCE = `<beads-guidance>
+## CLI Usage
+
+**Note:** Beads MCP tools are not available in this environment. Use the \`bd\` CLI via bash instead. MCP tool names map directly to \`bd\` commands.
+
+Use the \`bd\` CLI via bash for beads operations:
+
+- \`bd init [prefix]\` - Initialize beads
+- \`bd ready --json\` - List ready tasks
+- \`bd show <id> --json\` - Show task details
+- \`bd create "title" -t bug|feature|task -p 0-4 --json\` - Create issue
+- \`bd update <id> --status in_progress --json\` - Update status
+- \`bd close <id> --reason "message" --json\` - Close issue
+- \`bd reopen <id> --json\` - Reopen issue
+- \`bd dep add <from> <to> --type blocks|discovered-from --json\` - Add dependency
+- \`bd list --status open --json\` - List issues
+- \`bd blocked --json\` - Show blocked issues
+- \`bd stats --json\` - Show statistics
+- \`bd sync\` - Sync with git
+
+If a tool is not listed above, try \`bd <tool> --help\`.
 
 Always use \`--json\` flag for structured output.
-</beads-cli-guidance>`;
+
+## Agent Delegation
+
+For multi-step beads work, use the \`task\` tool with \`subagent_type: "beads-task-agent"\`:
+- Finding and completing ready work autonomously
+- Working through multiple issues in sequence
+- Tasks involving claiming, executing, and closing issues
+- When asked to "work on beads issues", "complete tasks", or similar
+
+For single, specific operations (check status, create one issue, query info), use \`bd\` CLI directly.
+</beads-guidance>`;
 
 export async function loadAgent(): Promise<Config["agent"]> {
   const content = await readVendorFile("agents/task-agent.md");
@@ -118,7 +132,7 @@ export async function loadAgent(): Promise<Config["agent"]> {
   return {
     "beads-task-agent": {
       description,
-      prompt: CLI_GUIDANCE + "\n" + parsed.body,
+      prompt: BEADS_GUIDANCE + "\n" + parsed.body,
       mode: "subagent",
     },
   };