opencode-swarm-plugin 0.12.26 → 0.12.28

package/.github/workflows/opencode.yml

@@ -0,0 +1,31 @@
+name: opencode
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+
+jobs:
+  opencode:
+    if: |
+      contains(github.event.comment.body, ' /oc') ||
+      startsWith(github.event.comment.body, '/oc') ||
+      contains(github.event.comment.body, ' /opencode') ||
+      startsWith(github.event.comment.body, '/opencode')
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+      pull-requests: read
+      issues: read
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Run opencode
+        uses: sst/opencode/github@latest
+        env:
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+        with:
+          model: anthropic/claude-sonnet-4-5

package/README.md

@@ -197,20 +197,13 @@ skills_use(name="swarm-coordination")   # Load swarm workflow
 
 ### Bundled Skills
 
-| Skill                        | Tags                 | Description                                                                          |
-| ---------------------------- | -------------------- | ------------------------------------------------------------------------------------ |
-| `agent-patterns`             | ai, agents, patterns | AI agent design patterns - capability whiteboards, architecture evolution, evals     |
-| `cli-builder`                | cli, typescript, bun | Building TypeScript CLIs with Bun - argument parsing, subcommands, output formatting |
-| `code-review`                | review, quality      | Code review patterns - systematic checklists, feedback patterns                      |
-| `debugging`                  | debugging, errors    | Systematic debugging - root cause analysis, error resolution                         |
-| `learning-systems`           | learning, feedback   | Implicit feedback scoring, confidence decay, anti-pattern detection                  |
-| `mcp-tool-authoring`         | mcp, tools           | Building MCP tools - schema definition, context passing, error handling              |
-| `resilience-patterns`        | errors, recovery     | Error recovery, retry strategies, graceful degradation                               |
-| `skill-creator`              | meta, skills         | Guide for creating effective skills                                                  |
-| `swarm-coordination`         | swarm, multi-agent   | Multi-agent coordination patterns for swarm workflows                                |
-| `tacit-knowledge-extraction` | knowledge, patterns  | Extracting tacit knowledge into pattern languages                                    |
-| `testing-strategies`         | testing, vitest      | Testing async/swarm operations, mocking patterns                                     |
-| `zod-validation`             | zod, typescript      | Schema validation patterns with Zod                                                  |
+| Skill                | Tags                 | Description                                                                          |
+| -------------------- | -------------------- | ------------------------------------------------------------------------------------ |
+| `cli-builder`        | cli, typescript, bun | Building TypeScript CLIs with Bun - argument parsing, subcommands, output formatting |
+| `learning-systems`   | learning, feedback   | Implicit feedback scoring, confidence decay, anti-pattern detection                  |
+| `mcp-tool-authoring` | mcp, tools           | Building MCP tools - schema definition, context passing, error handling              |
+| `skill-creator`      | meta, skills         | Guide for creating effective skills                                                  |
+| `swarm-coordination` | swarm, multi-agent   | Multi-agent coordination patterns for swarm workflows                                |
 
 ### Skill Locations
 

package/bin/swarm.ts

@@ -1072,6 +1072,127 @@ async function setup() {
     }
   }
 
+  // Offer to update AGENTS.md with skill awareness
+  const agentsPath = join(configDir, "AGENTS.md");
+  if (existsSync(agentsPath)) {
+    const updateAgents = await p.confirm({
+      message: "Update AGENTS.md with skill awareness?",
+      initialValue: true,
+    });
+
+    if (!p.isCancel(updateAgents) && updateAgents) {
+      const s = p.spinner();
+      s.start("Updating AGENTS.md...");
+
+      const agentsPrompt = `You are updating the user's AGENTS.md file to add swarm plugin awareness.
+
+## Task
+Read ${agentsPath} and add sections for Skills, CASS, and Semantic Memory if they don't exist. Update existing sections if present.
+
+## What to Add
+
+1. **Tool Preferences** - If there's a tool_preferences section, add these tools:
+   - skills_list, skills_use, skills_read - knowledge injection
+   - cass_search, cass_view, cass_expand - search past agent sessions
+   - semantic-memory_find, semantic-memory_store - persistent learning
+
+2. **Skills Section** - Add this (adapt style to match the file):
+
+### Skills (Knowledge Injection)
+
+Skills are reusable knowledge packages. Load them on-demand for specialized tasks.
+
+**When to Use:**
+- Before unfamiliar work - check if a skill exists
+- When you need domain-specific patterns
+- For complex workflows that benefit from guidance
+
+**Usage:**
+\`\`\`
+skills_list()                              # See available skills
+skills_use(name="swarm-coordination")      # Load a skill
+skills_use(name="cli-builder", context="building a new CLI") # With context
+\`\`\`
+
+**Bundled Skills:** cli-builder, learning-systems, mcp-tool-authoring, skill-creator, swarm-coordination
+
+3. **CASS Section** - Add this:
+
+### CASS (Cross-Agent Session Search)
+
+Search across ALL your AI coding agent histories before solving problems from scratch.
+
+**When to Use:**
+- BEFORE implementing anything - check if any agent solved it before
+- When debugging - "what did I try last time this error happened?"
+- When learning patterns - "how did Cursor handle this API?"
+
+**Usage:**
+\`\`\`
+cass_search(query="authentication token refresh", limit=5)  # Search all agents
+cass_search(query="useEffect cleanup", agent="claude", days=7)  # Filter by agent/time
+cass_view(path="/path/from/search", line=42)  # View specific result
+cass_expand(path="/path", line=42, context=10)  # Expand context around match
+\`\`\`
+
+**Pro tip:** Query CASS at the START of complex tasks. Past solutions save time.
+
+4. **Semantic Memory Section** - Add this:
+
+### Semantic Memory (Persistent Learning)
+
+Store and retrieve learnings across sessions. Memories persist and are searchable.
+
+**When to Use:**
+- After solving a tricky problem - store the solution
+- After making architectural decisions - store the reasoning
+- Before starting work - search for relevant past learnings
+- When you discover project-specific patterns
+
+**Usage:**
+\`\`\`
+# Store a learning
+semantic-memory_store(information="OAuth refresh tokens need 5min buffer before expiry", metadata="auth, tokens")
+
+# Search for relevant memories
+semantic-memory_find(query="token refresh", limit=5)
+
+# Validate a memory is still accurate (resets decay timer)
+semantic-memory_validate(id="mem_123")
+\`\`\`
+
+**Pro tip:** Store the WHY, not just the WHAT. Future you needs context.
+
+## Rules
+- Preserve existing content and style
+- Don't duplicate - update existing sections if present
+- Keep tone consistent with the rest of the file
+- Place sections in logical order (Skills, CASS, Semantic Memory)
+- If there's a tool_preferences section, add the tools there too
+
+Edit the file now.`;
+
+      try {
+        const result = Bun.spawnSync(["opencode", "run", agentsPrompt], {
+          stdout: "pipe",
+          stderr: "pipe",
+          timeout: 120000,
+        });
+
+        if (result.exitCode === 0) {
+          s.stop("AGENTS.md updated");
+          p.log.success("Added skill awareness to AGENTS.md");
+        } else {
+          s.stop("Could not update AGENTS.md");
+          p.log.warn("You can manually add skills section later");
+        }
+      } catch {
+        s.stop("Could not update AGENTS.md");
+        p.log.warn("You can manually add skills section later");
+      }
+    }
+  }
+
   p.note(
     'cd your-project\nbd init\nopencode\n/swarm "your task"\n\nSkills: Use skills_list to see available skills',
     "Next steps",
@@ -1351,6 +1472,7 @@ ${cyan("Commands:")}
   swarm doctor    Health check - shows status of all dependencies
   swarm init      Initialize beads in current project
   swarm config    Show paths to generated config files
+  swarm agents    Update AGENTS.md with skill awareness
   swarm update    Update to latest version
   swarm version   Show version and banner
   swarm tool      Execute a tool (for plugin wrapper)
@@ -1525,6 +1647,133 @@ async function listTools() {
   );
 }
 
+// ============================================================================
+// Agents Command - Update AGENTS.md with skill awareness
+// ============================================================================
+
+async function agents() {
+  const home = process.env.HOME || process.env.USERPROFILE || "~";
+  const agentsPath = join(home, ".config", "opencode", "AGENTS.md");
+
+  p.intro(yellow(BANNER));
+
+  // Check if AGENTS.md exists
+  if (!existsSync(agentsPath)) {
+    p.log.warn("No AGENTS.md found at " + agentsPath);
+    p.log.message(
+      dim("Create one first, then run this command to add skill awareness"),
+    );
+    p.outro("Aborted");
+    return;
+  }
+
+  // Check if opencode is available
+  const opencode = await checkCommand("opencode", ["--version"]);
+  if (!opencode.available) {
+    p.log.error("OpenCode not found");
+    p.log.message(dim("Install: npm install -g opencode"));
+    p.outro("Aborted");
+    return;
+  }
+
+  const confirm = await p.confirm({
+    message: "Update AGENTS.md with skill awareness?",
+    initialValue: true,
+  });
+
+  if (p.isCancel(confirm) || !confirm) {
+    p.outro("Aborted");
+    return;
+  }
+
+  const s = p.spinner();
+  s.start("Updating AGENTS.md with skill awareness...");
+
+  const prompt = `You are updating the user's AGENTS.md file to add swarm plugin awareness.
+
+## Task
+Read ~/.config/opencode/AGENTS.md and add sections for Skills, CASS, and Semantic Memory if they don't exist.
+
+## What to Add
+
+1. **Tool Preferences** - Add these tools to any tool_preferences section:
+   - skills_list, skills_use, skills_read - knowledge injection
+   - cass_search, cass_view, cass_expand - search past agent sessions
+   - semantic-memory_find, semantic-memory_store - persistent learning
+
+2. **Skills Section**:
+
+### Skills (Knowledge Injection)
+
+Skills are reusable knowledge packages. Load on-demand for specialized tasks.
+
+**When to Use:** Before unfamiliar work, when you need domain patterns, for complex workflows.
+
+\`\`\`
+skills_list()                              # See available skills
+skills_use(name="swarm-coordination")      # Load a skill
+\`\`\`
+
+**Bundled:** cli-builder, learning-systems, mcp-tool-authoring, skill-creator, swarm-coordination
+
+3. **CASS Section**:
+
+### CASS (Cross-Agent Session Search)
+
+Search ALL your AI coding agent histories before solving from scratch.
+
+**When to Use:** BEFORE implementing - check if solved before. When debugging - what worked last time?
+
+\`\`\`
+cass_search(query="auth token refresh", limit=5)  # Search all agents
+cass_view(path="/path/from/search", line=42)      # View result
+\`\`\`
+
+4. **Semantic Memory Section**:
+
+### Semantic Memory (Persistent Learning)
+
+Store and retrieve learnings across sessions.
+
+**When to Use:** After solving tricky problems, after architectural decisions, before starting work.
+
+\`\`\`
+semantic-memory_store(information="OAuth needs 5min buffer", metadata="auth")
+semantic-memory_find(query="token refresh", limit=5)
+\`\`\`
+
+## Rules
+- Preserve existing content and style
+- Don't duplicate - update if sections exist
+- Keep tone consistent
+
+Edit the file now.`;
+
+  try {
+    const result = Bun.spawnSync(["opencode", "run", prompt], {
+      stdio: ["inherit", "pipe", "pipe"],
+      timeout: 120000, // 2 minute timeout
+    });
+
+    if (result.exitCode === 0) {
+      s.stop("AGENTS.md updated with skill awareness");
+      p.log.success("Skills section added to " + agentsPath);
+      p.log.message(
+        dim("Skills available: skills_list, skills_use, skills_read"),
+      );
+    } else {
+      const stderr = result.stderr?.toString() || "";
+      s.stop("Failed to update AGENTS.md");
+      p.log.error(stderr || "Unknown error");
+    }
+  } catch (error) {
+    s.stop("Failed to update AGENTS.md");
+    p.log.error(String(error));
+  }
+
+  p.outro("Done");
+}
+
 // ============================================================================
 // Main
 // ============================================================================
@@ -1560,6 +1809,9 @@ switch (command) {
     }
     break;
   }
+  case "agents":
+    await agents();
+    break;
   case "version":
   case "--version":
   case "-v":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-swarm-plugin",
-  "version": "0.12.26",
+  "version": "0.12.28",
   "description": "Multi-agent swarm coordination for OpenCode with learning capabilities, beads integration, and Agent Mail",
   "type": "module",
   "main": "dist/index.js",