opencode-swarm-plugin 0.57.0 → 0.57.2

package/claude-plugin/agents/coordinator.md

@@ -22,6 +22,7 @@ Orchestrates swarm work: decomposes tasks, spawns workers, monitors progress, an
 - **Never reserve files** as the coordinator. Workers reserve their own files.
 - **Decompose with intent** using `swarm_plan_prompt` + `swarm_validate_decomposition`.
 - **Review every worker completion** via `swarm_review` + `swarm_review_feedback`.
+- **After every `swarm_spawn_subtask`, immediately call `Task(subagent_type="swarm-worker", prompt="<prompt returned by swarm_spawn_subtask>")`.**
 - **Record outcomes** with `swarm_complete` for learning signals.
 
 ## Tool Access

package/claude-plugin/bin/swarm-mcp-server.ts

@@ -21,20 +21,26 @@ type ToolDefinition = {
 /**
  * Resolve the tool registry entrypoint for the MCP server.
  */
-export function resolveToolRegistryPath(): string {
-  const currentDir = dirname(fileURLToPath(import.meta.url));
+export function resolveToolRegistryPath({
+  currentDir = dirname(fileURLToPath(import.meta.url)),
+}: {
+  currentDir?: string;
+} = {}): string {
   const pluginDistPath = resolve(currentDir, "../dist/index.js");
-  const packageDistPath = resolve(currentDir, "../../dist/index.js");
 
   if (existsSync(pluginDistPath)) {
     return pluginDistPath;
   }
 
-  if (existsSync(packageDistPath)) {
-    return packageDistPath;
+  const sourcePath = resolve(currentDir, "../../src/index.ts");
+  if (existsSync(sourcePath)) {
+    return sourcePath;
   }
 
-  return resolve(currentDir, "../../src/index.ts");
+  throw new Error(
+    `[swarm-mcp] Missing Claude plugin runtime bundle. Expected ${pluginDistPath}. ` +
+      "Rebuild the package so claude-plugin/dist is populated.",
+  );
 }
 
 /**

package/claude-plugin/dist/bin/swarm.js

@@ -53267,7 +53267,7 @@ ${prefix}}`;
     return path22;
   }
   return sp2.join(cwd, path22);
-}, EMPTY_SET, STAT_METHOD_F = "stat", STAT_METHOD_L = "lstat", FSWatcher, chokidar_default, FileWatcher, NormalizedMessageSchema, OpenCodeSwarmEventSchema, SWARM_MAIL_VERSION = "0.1.0";
+}, EMPTY_SET, STAT_METHOD_F = "stat", STAT_METHOD_L = "lstat", FSWatcher, chokidar_default, FileWatcher, NormalizedMessageSchema, OpenCodeSwarmEventSchema, SWARM_MAIL_VERSION = "1.10.0";
 var init_dist = __esm(() => {
   __create2 = Object.create;
   __getProtoOf2 = Object.getPrototypeOf;
@@ -169788,7 +169788,7 @@ ${prefix}}`;
     return path24;
   }
   return sp22.join(cwd, path24);
-}, EMPTY_SET2, STAT_METHOD_F2 = "stat", STAT_METHOD_L2 = "lstat", FSWatcher2, chokidar_default2, FileWatcher2, NormalizedMessageSchema2, OpenCodeSwarmEventSchema2, SWARM_MAIL_VERSION2 = "0.1.0";
+}, EMPTY_SET2, STAT_METHOD_F2 = "stat", STAT_METHOD_L2 = "lstat", FSWatcher2, chokidar_default2, FileWatcher2, NormalizedMessageSchema2, OpenCodeSwarmEventSchema2, SWARM_MAIL_VERSION2 = "1.10.0";
 var init_dist9 = __esm(() => {
   __create4 = Object.create;
   __getProtoOf4 = Object.getPrototypeOf;
@@ -278091,6 +278091,7 @@ var init_skills2 = __esm(() => {
     coordinator: `### Coordinator Enforcement
 - Coordinator role: orchestrate, decompose, spawn workers
 - **Never** edit files or reserve locks directly
+- **After every \`swarm_spawn_subtask\`, immediately call \`Task(subagent_type="swarm-worker", prompt="<prompt returned by swarm_spawn_subtask>")\`**
 - Coordinator override: use \`swarmmail_release_all\` only for stale/orphaned reservations (announce in Swarm Mail)
 - Review work with \`swarm_review\` before accepting`,
     worker: `### Worker Enforcement
@@ -324048,6 +324049,7 @@ var init_skills = __esm4(() => {
     coordinator: `### Coordinator Enforcement
 - Coordinator role: orchestrate, decompose, spawn workers
 - **Never** edit files or reserve locks directly
+- **After every \`swarm_spawn_subtask\`, immediately call \`Task(subagent_type="swarm-worker", prompt="<prompt returned by swarm_spawn_subtask>")\`**
 - Coordinator override: use \`swarmmail_release_all\` only for stale/orphaned reservations (announce in Swarm Mail)
 - Review work with \`swarm_review\` before accepting`,
     worker: `### Worker Enforcement
@@ -352003,7 +352005,7 @@ Your role is **ONLY** to:
 ║   - Clarify task scope (ask questions, understand requirements)          ║
 ║   - Read package.json/tsconfig.json for structure (metadata only)        ║
 ║   - Decompose into subtasks (swarm_plan_prompt, validate_decomposition)  ║
-║   - Spawn workers (swarm_spawn_subtask, Task(subagent_type="worker"))    ║
+║   - Spawn workers (swarm_spawn_subtask → Task(subagent_type="swarm-worker", prompt=<from swarm_spawn_subtask>)) ║
 ║   - Monitor progress (swarmmail_inbox, swarm_status)                     ║
 ║   - Review completed work (swarm_review, swarm_review_feedback)          ║
 ║   - Verify final state (check all workers completed, hive_sync)          ║
@@ -352047,7 +352049,7 @@ swarm_spawn_subtask(
   files=["src/auth/login.ts", "src/auth/login.test.ts"],
   shared_context="Bug: login fails when username is null"
 )
-Task(subagent_type="swarm-worker", prompt="<from above>")
+Task(subagent_type="swarm-worker", prompt="<prompt returned by swarm_spawn_subtask>")
 \`\`\`
 
 ### Coordinator Override: Release Stale Reservations
@@ -352130,6 +352132,21 @@ Check for flags in the task:
 - Offer concrete options - not open-ended
 - Lead with recommendation - save cognitive load
 - Wait for answer - don't assume
+- Ask only about **requirements and scope**, never repo file paths or implementation details
+
+### Path Discovery (DO NOT ASK USER FOR PATHS)
+If you don't know the correct file paths (or a worker reports missing files), **do NOT ask the user**. Instead, spawn a short-lived **path discovery** worker to locate the real paths via glob/grep/read, then respawn the main workers with correct files.
+
+**Trigger conditions:**
+- File list is guessed or inferred
+- Worker reports missing files or incorrect paths
+- Repo structure is unknown or new to you
+
+**Requirements:**
+- **Always** spawn a worker for path discovery
+- **Never** ask the user to locate files or paths
+- Use explicit wording: "path discovery" in the worker subtask title
+- Replace bad file lists before spawning main workers
 
 ### Phase 1: Initialize
 \`swarmmail_init(project_path="{project_path}", task_description="Swarm: {task}")\`
@@ -352204,24 +352221,26 @@ swarm_validate_decomposition(response="<CellTree JSON>")
 > - Parallel tasks: Spawn ALL in a single message
 > - Sequential tasks: Spawn one, wait for completion, spawn next
 
+**After every swarm_spawn_subtask, immediately call Task(subagent_type="swarm-worker", prompt="<prompt returned by swarm_spawn_subtask>")**
+
 **For parallel work:**
 \`\`\`
 // Single message with multiple Task calls
 swarm_spawn_subtask(bead_id_1, epic_id, title_1, files_1, shared_context, project_path="{project_path}")
-Task(subagent_type="swarm-worker", prompt="<from above>")
+Task(subagent_type="swarm-worker", prompt="<prompt returned by swarm_spawn_subtask>")
 swarm_spawn_subtask(bead_id_2, epic_id, title_2, files_2, shared_context, project_path="{project_path}")
-Task(subagent_type="swarm-worker", prompt="<from above>")
+Task(subagent_type="swarm-worker", prompt="<prompt returned by swarm_spawn_subtask>")
 \`\`\`
 
 **For sequential work:**
 \`\`\`
 // Spawn worker 1, wait for completion
 swarm_spawn_subtask(bead_id_1, ...)
-const result1 = await Task(subagent_type="swarm-worker", prompt="<from above>")
+const result1 = await Task(subagent_type="swarm-worker", prompt="<prompt returned by swarm_spawn_subtask>")
 
 // THEN spawn worker 2 with context from worker 1
 swarm_spawn_subtask(bead_id_2, ..., shared_context="Worker 1 completed: " + result1)
-const result2 = await Task(subagent_type="swarm-worker", prompt="<from above>")
+const result2 = await Task(subagent_type="swarm-worker", prompt="<prompt returned by swarm_spawn_subtask>")
 \`\`\`
 
 **NEVER do the work yourself.** Even if it seems faster, spawn a worker.

package/claude-plugin/dist/build/mcp-bundle.d.ts

@@ -0,0 +1,16 @@
+export declare const MCP_ENTRY_RELATIVE_PATH: string;
+export declare const MCP_BUNDLE_RELATIVE_PATH: string;
+export type McpBundlePaths = {
+    pluginRoot: string;
+    entryPath: string;
+    bundlePath: string;
+    bundleDir: string;
+};
+/**
+ * Resolve the entry + output paths for the bundled MCP server.
+ */
+export declare function resolveMcpBundlePaths({ packageRoot, pluginRoot, }?: {
+    packageRoot?: string;
+    pluginRoot?: string;
+}): McpBundlePaths;
+//# sourceMappingURL=mcp-bundle.d.ts.map

package/claude-plugin/dist/build/mcp-bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-bundle.d.ts","sourceRoot":"","sources":["../../src/build/mcp-bundle.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,uBAAuB,QAAqC,CAAC;AAC1E,eAAO,MAAM,wBAAwB,QAIpC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,WAA2B,EAC3B,UAA+C,GAChD,GAAE;IACD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,cAAc,CAUtB"}

package/claude-plugin/dist/cache/claude-plugin-cache.d.ts

@@ -0,0 +1,41 @@
+export type McpServerConfig = {
+    command: string;
+    args: string[];
+    cwd?: string;
+    description?: string;
+};
+export type McpConfig = {
+    mcpServers: Record<string, McpServerConfig>;
+};
+export type ClaudePluginCachePaths = {
+    cacheRoot: string;
+    mcpServerPath: string;
+    mcpConfigPath: string;
+};
+export declare const CLAUDE_PLUGIN_ROOT_TOKEN = "${CLAUDE_PLUGIN_ROOT}";
+export declare const SWARM_MCP_SERVER_NAME = "swarm-tools";
+/**
+ * Resolve where cached Claude plugin assets should live.
+ */
+export declare function resolveClaudePluginCachePaths({ cacheRoot, }?: {
+    cacheRoot?: string;
+}): ClaudePluginCachePaths;
+/**
+ * Create the MCP config for a cached Claude plugin bundle.
+ */
+export declare function createClaudePluginCacheMcpConfig({ pluginRootToken, command, description, }?: {
+    pluginRootToken?: string;
+    command?: string;
+    description?: string;
+}): McpConfig;
+/**
+ * Describe the cached Claude plugin entrypoints for bundling.
+ */
+export declare function resolveClaudePluginCacheBundleSpec({ cacheRoot, pluginRoot, }?: {
+    cacheRoot?: string;
+    pluginRoot?: string;
+}): {
+    entryPath: string;
+    bundlePath: string;
+};
+//# sourceMappingURL=claude-plugin-cache.d.ts.map

package/claude-plugin/dist/cache/claude-plugin-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-plugin-cache.d.ts","sourceRoot":"","sources":["../../src/cache/claude-plugin-cache.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,wBAAwB,0BAA0B,CAAC;AAChE,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AAEnD;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,EAC5C,SAAgD,GACjD,GAAE;IACD,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,sBAAsB,CAS9B;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,EAC/C,eAA0C,EAC1C,OAAgB,EAChB,WAAoD,GACrD,GAAE;IACD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,SAAS,CAgBjB;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAAC,EACjD,SAAgD,EAChD,UAAsB,GACvB,GAAE;IACD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAOjD"}

package/claude-plugin/dist/claude-plugin/claude-plugin-assets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-plugin-assets.d.ts","sourceRoot":"","sources":["../../src/claude-plugin/claude-plugin-assets.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,4BAA4B,GAAG;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,EAC5C,WAAW,EACX,QAAoC,EACpC,UAA+C,GAChD,EAAE,4BAA4B,GAAG,IAAI,CAgBrC"}
+{"version":3,"file":"claude-plugin-assets.d.ts","sourceRoot":"","sources":["../../src/claude-plugin/claude-plugin-assets.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,4BAA4B,GAAG;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,EAC5C,WAAW,EACX,QAAoC,EACpC,UAA+C,GAChD,EAAE,4BAA4B,GAAG,IAAI,CAqBrC"}

package/claude-plugin/dist/index.js

@@ -27412,6 +27412,7 @@ var init_skills = __esm(() => {
     coordinator: `### Coordinator Enforcement
 - Coordinator role: orchestrate, decompose, spawn workers
 - **Never** edit files or reserve locks directly
+- **After every \`swarm_spawn_subtask\`, immediately call \`Task(subagent_type="swarm-worker", prompt="<prompt returned by swarm_spawn_subtask>")\`**
 - Coordinator override: use \`swarmmail_release_all\` only for stale/orphaned reservations (announce in Swarm Mail)
 - Review work with \`swarm_review\` before accepting`,
     worker: `### Worker Enforcement