opencode-swarm 4.3.2 → 4.4.0

package/dist/cli/index.js

@@ -96,6 +96,66 @@ Next steps:`);
   console.log("   what expertise is needed and requests it dynamically.");
   return 0;
 }
+async function uninstall() {
+  try {
+    console.log(`\uD83D\uDC1D Uninstalling OpenCode Swarm...
+`);
+    const opencodeConfig = loadJson(OPENCODE_CONFIG_PATH);
+    if (!opencodeConfig) {
+      if (fs.existsSync(OPENCODE_CONFIG_PATH)) {
+        console.log(`\u2717 Could not parse opencode config at: ${OPENCODE_CONFIG_PATH}`);
+        return 1;
+      } else {
+        console.log(`\u26A0 No opencode config found at: ${OPENCODE_CONFIG_PATH}`);
+        console.log("Nothing to uninstall.");
+        return 0;
+      }
+    }
+    if (!opencodeConfig.plugin || opencodeConfig.plugin.length === 0) {
+      console.log("\u26A0 opencode-swarm is not installed (no plugins configured).");
+      return 0;
+    }
+    const pluginName = "opencode-swarm";
+    const filteredPlugins = opencodeConfig.plugin.filter((p) => p !== pluginName && !p.startsWith(`${pluginName}@`));
+    if (filteredPlugins.length === opencodeConfig.plugin.length) {
+      console.log("\u26A0 opencode-swarm is not installed.");
+      return 0;
+    }
+    opencodeConfig.plugin = filteredPlugins;
+    if (opencodeConfig.agent) {
+      delete opencodeConfig.agent.explore;
+      delete opencodeConfig.agent.general;
+      if (Object.keys(opencodeConfig.agent).length === 0) {
+        delete opencodeConfig.agent;
+      }
+    }
+    saveJson(OPENCODE_CONFIG_PATH, opencodeConfig);
+    console.log("\u2713 Removed opencode-swarm from OpenCode plugins");
+    console.log("\u2713 Re-enabled default OpenCode agents (explore, general)");
+    if (process.argv.includes("--clean")) {
+      let cleaned = false;
+      if (fs.existsSync(PLUGIN_CONFIG_PATH)) {
+        fs.unlinkSync(PLUGIN_CONFIG_PATH);
+        console.log(`\u2713 Removed plugin config: ${PLUGIN_CONFIG_PATH}`);
+        cleaned = true;
+      }
+      if (fs.existsSync(PROMPTS_DIR)) {
+        fs.rmSync(PROMPTS_DIR, { recursive: true });
+        console.log(`\u2713 Removed custom prompts: ${PROMPTS_DIR}`);
+        cleaned = true;
+      }
+      if (!cleaned) {
+        console.log("\u2713 No config files to clean up");
+      }
+    }
+    console.log(`
+\u2705 Uninstall complete!`);
+    return 0;
+  } catch (error) {
+    console.log("\u2717 Uninstall failed: " + (error instanceof Error ? error.message : String(error)));
+    return 1;
+  }
+}
 function printHelp() {
   console.log(`
 opencode-swarm - Architect-centric agentic swarm plugin for OpenCode
@@ -104,8 +164,10 @@ Usage: bunx opencode-swarm [command] [OPTIONS]
 
 Commands:
   install     Install and configure the plugin (default)
+  uninstall   Remove the plugin from OpenCode config
 
 Options:
+  --clean     Also remove config files and custom prompts (with uninstall)
   -h, --help  Show this help message
 
 Configuration:
@@ -122,6 +184,8 @@ Custom Prompts:
 
 Examples:
   bunx opencode-swarm install
+  bunx opencode-swarm uninstall
+  bunx opencode-swarm uninstall --clean
   bunx opencode-swarm --help
 `);
 }
@@ -135,6 +199,9 @@ async function main() {
   if (command === "install") {
     const exitCode = await install();
     process.exit(exitCode);
+  } else if (command === "uninstall") {
+    const exitCode = await uninstall();
+    process.exit(exitCode);
   } else {
     console.error(`Unknown command: ${command}`);
     console.error("Run with --help for usage information");

package/dist/commands/config.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Handles the /swarm config command.
+ * Loads and displays the current resolved plugin configuration.
+ */
+export declare function handleConfigCommand(directory: string, _args: string[]): Promise<string>;

package/dist/commands/history.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Handles the /swarm history command.
+ * Reads plan.md and displays a summary of all phases and their status.
+ */
+export declare function handleHistoryCommand(directory: string, _args: string[]): Promise<string>;

package/dist/commands/index.d.ts

@@ -1,5 +1,7 @@
 import type { AgentDefinition } from '../agents';
 export { handleAgentsCommand } from './agents';
+export { handleConfigCommand } from './config';
+export { handleHistoryCommand } from './history';
 export { handlePlanCommand } from './plan';
 export { handleStatusCommand } from './status';
 /**

package/dist/index.js

@@ -14410,9 +14410,46 @@ function handleAgentsCommand(agents) {
 `);
 }
 
-// src/hooks/utils.ts
+// src/commands/config.ts
+import * as os2 from "os";
 import * as path2 from "path";
+function getUserConfigDir2() {
+  return process.env.XDG_CONFIG_HOME || path2.join(os2.homedir(), ".config");
+}
+async function handleConfigCommand(directory, _args) {
+  const config2 = loadPluginConfig(directory);
+  const userConfigPath = path2.join(getUserConfigDir2(), "opencode", "opencode-swarm.json");
+  const projectConfigPath = path2.join(directory, ".opencode", "opencode-swarm.json");
+  const lines = [
+    "## Swarm Configuration",
+    "",
+    "### Config Files",
+    `- User: \`${userConfigPath}\``,
+    `- Project: \`${projectConfigPath}\``,
+    "",
+    "### Resolved Config",
+    "```json",
+    JSON.stringify(config2, null, 2),
+    "```"
+  ];
+  return lines.join(`
+`);
+}
 
+// src/hooks/utils.ts
+import * as path3 from "path";
+
+// src/utils/errors.ts
+class SwarmError extends Error {
+  code;
+  guidance;
+  constructor(message, code, guidance) {
+    super(message);
+    this.name = "SwarmError";
+    this.code = code;
+    this.guidance = guidance;
+  }
+}
 // src/utils/logger.ts
 var DEBUG = process.env.OPENCODE_SWARM_DEBUG === "1";
 function log(message, data) {
@@ -14440,7 +14477,12 @@ function safeHook(fn) {
       await fn(input, output);
     } catch (_error) {
       const functionName = fn.name || "unknown";
-      warn(`Hook function '${functionName}' failed:`, _error);
+      if (_error instanceof SwarmError) {
+        warn(`Hook '${functionName}' failed: ${_error.message}
+  \u2192 ${_error.guidance}`);
+      } else {
+        warn(`Hook function '${functionName}' failed:`, _error);
+      }
     }
   };
 }
@@ -14462,14 +14504,14 @@ function validateSwarmPath(directory, filename) {
   if (/\.\.[/\\]/.test(filename)) {
     throw new Error("Invalid filename: path traversal detected");
   }
-  const baseDir = path2.normalize(path2.resolve(directory, ".swarm"));
-  const resolved = path2.normalize(path2.resolve(baseDir, filename));
+  const baseDir = path3.normalize(path3.resolve(directory, ".swarm"));
+  const resolved = path3.normalize(path3.resolve(baseDir, filename));
   if (process.platform === "win32") {
-    if (!resolved.toLowerCase().startsWith((baseDir + path2.sep).toLowerCase())) {
+    if (!resolved.toLowerCase().startsWith((baseDir + path3.sep).toLowerCase())) {
       throw new Error("Invalid filename: path escapes .swarm directory");
     }
   } else {
-    if (!resolved.startsWith(baseDir + path2.sep)) {
+    if (!resolved.startsWith(baseDir + path3.sep)) {
       throw new Error("Invalid filename: path escapes .swarm directory");
     }
   }
@@ -14492,6 +14534,57 @@ function estimateTokens(text) {
   return Math.ceil(text.length * 0.33);
 }
 
+// src/commands/history.ts
+async function handleHistoryCommand(directory, _args) {
+  const planContent = await readSwarmFileAsync(directory, "plan.md");
+  if (!planContent) {
+    return "No history available.";
+  }
+  const phaseRegex = /^## Phase (\d+):?\s*(.+?)(?:\s*\[(COMPLETE|IN PROGRESS|PENDING)\])?\s*$/gm;
+  const phases = [];
+  const lines = planContent.split(`
+`);
+  for (let match = phaseRegex.exec(planContent);match !== null; match = phaseRegex.exec(planContent)) {
+    const num = parseInt(match[1], 10);
+    const name = match[2].trim();
+    const status = match[3] || "PENDING";
+    const headerLineIndex = lines.indexOf(match[0]);
+    let completed = 0;
+    let total = 0;
+    if (headerLineIndex !== -1) {
+      for (let i = headerLineIndex + 1;i < lines.length; i++) {
+        const line = lines[i];
+        if (/^## Phase \d+/.test(line) || line.trim() === "---" && total > 0) {
+          break;
+        }
+        if (/^- \[x\]/.test(line)) {
+          completed++;
+          total++;
+        } else if (/^- \[ \]/.test(line)) {
+          total++;
+        }
+      }
+    }
+    phases.push({ num, name, status, completed, total });
+  }
+  if (phases.length === 0) {
+    return "No history available.";
+  }
+  const tableLines = [
+    "## Swarm History",
+    "",
+    "| Phase | Name | Status | Tasks |",
+    "|-------|------|--------|-------|"
+  ];
+  for (const phase of phases) {
+    const statusIcon = phase.status === "COMPLETE" ? "\u2705" : phase.status === "IN PROGRESS" ? "\uD83D\uDD04" : "\u23F3";
+    const tasks = phase.total > 0 ? `${phase.completed}/${phase.total}` : "-";
+    tableLines.push(`| ${phase.num} | ${phase.name} | ${statusIcon} ${phase.status} | ${tasks} |`);
+  }
+  return tableLines.join(`
+`);
+}
+
 // src/commands/plan.ts
 async function handlePlanCommand(directory, args) {
   const planContent = await readSwarmFileAsync(directory, "plan.md");
@@ -14709,7 +14802,9 @@ var HELP_TEXT = [
   "",
   "- `/swarm status` \u2014 Show current swarm state",
   "- `/swarm plan [phase]` \u2014 Show plan (optionally filter by phase number)",
-  "- `/swarm agents` \u2014 List registered agents"
+  "- `/swarm agents` \u2014 List registered agents",
+  "- `/swarm history` \u2014 Show completed phases summary",
+  "- `/swarm config` \u2014 Show current resolved configuration"
 ].join(`
 `);
 function createSwarmCommandHandler(directory, agents) {
@@ -14730,6 +14825,12 @@ function createSwarmCommandHandler(directory, agents) {
       case "agents":
         text = handleAgentsCommand(agents);
         break;
+      case "history":
+        text = await handleHistoryCommand(directory, args);
+        break;
+      case "config":
+        text = await handleConfigCommand(directory, args);
+        break;
       default:
         text = HELP_TEXT;
         break;
@@ -14817,8 +14918,8 @@ async function doFlush(directory) {
     const activitySection = renderActivitySection();
     const updated = replaceOrAppendSection(existing, "## Agent Activity", activitySection);
     const flushedCount = swarmState.pendingEvents;
-    const path3 = `${directory}/.swarm/context.md`;
-    await Bun.write(path3, updated);
+    const path4 = `${directory}/.swarm/context.md`;
+    await Bun.write(path4, updated);
     swarmState.pendingEvents = Math.max(0, swarmState.pendingEvents - flushedCount);
   } catch (error49) {
     warn("Agent activity flush failed:", error49);
@@ -15837,10 +15938,10 @@ function mergeDefs2(...defs) {
 function cloneDef2(schema) {
   return mergeDefs2(schema._zod.def);
 }
-function getElementAtPath2(obj, path3) {
-  if (!path3)
+function getElementAtPath2(obj, path4) {
+  if (!path4)
     return obj;
-  return path3.reduce((acc, key) => acc?.[key], obj);
+  return path4.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject2(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -16199,11 +16300,11 @@ function aborted2(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues2(path3, issues) {
+function prefixIssues2(path4, issues) {
   return issues.map((iss) => {
     var _a2;
     (_a2 = iss).path ?? (_a2.path = []);
-    iss.path.unshift(path3);
+    iss.path.unshift(path4);
     return iss;
   });
 }
@@ -16371,7 +16472,7 @@ function treeifyError2(error49, _mapper) {
     return issue3.message;
   };
   const result = { errors: [] };
-  const processError = (error50, path3 = []) => {
+  const processError = (error50, path4 = []) => {
     var _a2, _b;
     for (const issue3 of error50.issues) {
       if (issue3.code === "invalid_union" && issue3.errors.length) {
@@ -16381,7 +16482,7 @@ function treeifyError2(error49, _mapper) {
       } else if (issue3.code === "invalid_element") {
         processError({ issues: issue3.issues }, issue3.path);
       } else {
-        const fullpath = [...path3, ...issue3.path];
+        const fullpath = [...path4, ...issue3.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue3));
           continue;
@@ -16413,8 +16514,8 @@ function treeifyError2(error49, _mapper) {
 }
 function toDotPath2(_path) {
   const segs = [];
-  const path3 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path3) {
+  const path4 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path4) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -27610,7 +27711,7 @@ Use these as DOMAIN values when delegating to @sme.`;
 });
 // src/tools/file-extractor.ts
 import * as fs2 from "fs";
-import * as path3 from "path";
+import * as path4 from "path";
 var EXT_MAP = {
   python: ".py",
   py: ".py",
@@ -27688,12 +27789,12 @@ var extract_code_blocks = tool({
       if (prefix) {
         filename = `${prefix}_${filename}`;
       }
-      let filepath = path3.join(targetDir, filename);
-      const base = path3.basename(filepath, path3.extname(filepath));
-      const ext = path3.extname(filepath);
+      let filepath = path4.join(targetDir, filename);
+      const base = path4.basename(filepath, path4.extname(filepath));
+      const ext = path4.extname(filepath);
       let counter = 1;
       while (fs2.existsSync(filepath)) {
-        filepath = path3.join(targetDir, `${base}_${counter}${ext}`);
+        filepath = path4.join(targetDir, `${base}_${counter}${ext}`);
         counter++;
       }
       try {

package/dist/utils/errors.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Base error class for all swarm errors.
+ * Includes a machine-readable `code` and a user-facing `guidance` string.
+ */
+export declare class SwarmError extends Error {
+    readonly code: string;
+    readonly guidance: string;
+    constructor(message: string, code: string, guidance: string);
+}
+/**
+ * Error thrown when configuration loading or validation fails.
+ */
+export declare class ConfigError extends SwarmError {
+    constructor(message: string, guidance: string);
+}
+/**
+ * Error thrown when a hook execution fails.
+ */
+export declare class HookError extends SwarmError {
+    constructor(message: string, guidance: string);
+}
+/**
+ * Error thrown when a tool execution fails.
+ */
+export declare class ToolError extends SwarmError {
+    constructor(message: string, guidance: string);
+}
+/**
+ * Error thrown when CLI operations fail.
+ */
+export declare class CLIError extends SwarmError {
+    constructor(message: string, guidance: string);
+}

package/dist/utils/index.d.ts

@@ -1 +1,2 @@
-export { log, warn, error } from './logger';
+export { CLIError, ConfigError, HookError, SwarmError, ToolError, } from './errors';
+export { error, log, warn } from './logger';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "4.3.2",
+	"version": "4.4.0",
 	"description": "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -35,12 +35,12 @@
 		"prepublishOnly": "bun run build"
 	},
 	"dependencies": {
-		"@opencode-ai/plugin": "^1.1.19",
-		"@opencode-ai/sdk": "^1.1.19",
+		"@opencode-ai/plugin": "^1.1.53",
+		"@opencode-ai/sdk": "^1.1.53",
 		"zod": "^4.1.8"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "2.3.11",
+		"@biomejs/biome": "2.3.14",
 		"bun-types": "latest",
 		"typescript": "^5.7.3"
 	}