@ra3orblade/swarm 0.4.0 → 0.5.0

package/dist/swarm.js

@@ -151,6 +151,45 @@ var WRITE_TOOLS = new Set(["Write", "Edit", "MultiEdit", "NotebookEdit"]);
 var MARK = "swarm-hook";
 var isOurs = (h) => h.command.includes(MARK) || h.command.includes("/packages/hook/src/bin.ts");
 var settingsPath = () => process.env.CLAUDE_SETTINGS ?? join2(homedir2(), ".claude", "settings.json");
+var claudeJsonPath = () => process.env.CLAUDE_JSON ?? join2(homedir2(), ".claude.json");
+function loadClaudeJson() {
+  const p = claudeJsonPath();
+  if (!existsSync3(p))
+    return {};
+  try {
+    return JSON.parse(readFileSync2(p, "utf8"));
+  } catch {
+    return {};
+  }
+}
+function saveClaudeJson(c) {
+  writeFileSync2(claudeJsonPath(), `${JSON.stringify(c, null, 2)}
+`);
+}
+function registerMcp() {
+  const c = loadClaudeJson();
+  const mcp = c.mcpServers ?? {};
+  mcp.swarm = { type: "stdio", ...mcpServerConfig() };
+  c.mcpServers = mcp;
+  saveClaudeJson(c);
+}
+function unregisterMcp() {
+  const c = loadClaudeJson();
+  const mcp = c.mcpServers ?? {};
+  if (!mcp.swarm)
+    return false;
+  delete mcp.swarm;
+  if (Object.keys(mcp).length)
+    c.mcpServers = mcp;
+  else
+    delete c.mcpServers;
+  saveClaudeJson(c);
+  return true;
+}
+function mcpRegistered() {
+  const c = loadClaudeJson();
+  return Boolean(c.mcpServers?.swarm);
+}
 var hookCommand = (event) => `${binCommand("swarm-hook")} ${event}`;
 var shimPath = () => resolveBin("swarm-hook").at(-1);
 function mcpServerConfig() {
@@ -179,10 +218,16 @@ function install() {
     added.push(ev);
   }
   s.hooks = hooks2;
-  const mcp = s.mcpServers ?? {};
-  mcp.swarm = { type: "stdio", ...mcpServerConfig() };
-  s.mcpServers = mcp;
+  const stale = s.mcpServers ?? {};
+  if (stale.swarm) {
+    delete stale.swarm;
+    if (Object.keys(stale).length)
+      s.mcpServers = stale;
+    else
+      delete s.mcpServers;
+  }
   save(s);
+  registerMcp();
   return added;
 }
 function uninstall() {
@@ -211,23 +256,22 @@ function uninstall() {
   else
     delete s.hooks;
   const mcp = s.mcpServers ?? {};
-  if (mcp.swarm) {
+  if (mcp.swarm)
     delete mcp.swarm;
-    removed++;
-  }
   if (Object.keys(mcp).length)
     s.mcpServers = mcp;
   else
     delete s.mcpServers;
   save(s);
+  if (unregisterMcp())
+    removed++;
   return removed;
 }
 function status() {
   const s = load();
   const hooks2 = s.hooks ?? {};
   const installed = Object.values(hooks2).some((l) => l.some((g) => g.hooks.some(isOurs)));
-  const mcp = Boolean(s.mcpServers?.swarm);
-  return { installed, mcp, path: settingsPath(), shim: shimPath() };
+  return { installed, mcp: mcpRegistered(), path: settingsPath(), shim: shimPath() };
 }
 
 // packages/cli/src/procs.ts
@@ -348,6 +392,13 @@ var help = `swarm \u2014 control plane for AI-agent development
   renew <task>            extend the lease;  release <task> [--force]   release + remove worktree
   claims                  list claims;  reap   release abandoned claims (keeps ones holding work)
   tasks [--ready] [--json] the repo's task source (.swarm.toml [tasks] source); --ready = claimable now
+  gate record <task> <gate> pass|fail --rubric "\u2026" [--evidence "\u2026"]   record a verification run (rubric required)
+  gate ls [task]          latest verdict per gate (and the run history for one task)
+  run --task <id> (--prompt "\u2026" | --prompt-file f) [--model m] [--permission-mode m] [--allowed-tools a,b] [--max-turns n]
+                          claim the task and spawn claude -p in its worktree; the session shows in Fleet
+  run ls | send <task|id> "text" | stop <task|id>   steer (stdin) or stop a spawned run, by pid never pattern
+  handoff <task> --done "\u2026" --remaining "\u2026" [--files a,b] [--verify "\u2026"]   leave notes for the next holder
+  resume <task>           print the latest handoff (the next session gets it automatically on start)
   res ls | acquire <name> [--owner n] [--pid n] [--port n] | release <name> [--force]
                           named singletons (ports, processes); fail-closed
   serve start [--name web] [--from-port 3400 | --port n] -- <cmd>
@@ -546,6 +597,226 @@ url: ${resolveBaseUrl()}`);
           console.log(`${c.state.padEnd(9)} ${c.task.padEnd(16)} ${(c.owner || "").padEnd(12)} ${c.worktree}`);
       break;
     }
+    case "run": {
+      await ensureDaemon({ quiet: true });
+      const proj = await api("/v1/projects", {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ path: resolve3(".") })
+      });
+      const base = new SwarmClient().baseUrl;
+      const valueFlags = new Set([
+        "--task",
+        "--prompt",
+        "--prompt-file",
+        "--model",
+        "--permission-mode",
+        "--allowed-tools",
+        "--max-turns",
+        "--owner"
+      ]);
+      const positionals = [];
+      for (let i = 0;i < rest.length; i++) {
+        const a = rest[i];
+        if (valueFlags.has(a))
+          i++;
+        else if (!a.startsWith("--"))
+          positionals.push(a);
+      }
+      const flag = (n) => {
+        const i = rest.indexOf(n);
+        return i >= 0 ? rest[i + 1] : undefined;
+      };
+      const sub = positionals[0];
+      if (sub === "ls") {
+        const runs = await api(`/v1/runs?project=${proj.id}`);
+        if (json)
+          console.log(JSON.stringify(runs));
+        else if (!runs.length)
+          console.log("no live runs here");
+        else
+          for (const r2 of runs)
+            console.log(`${r2.id}  ${r2.task.padEnd(12)} pid ${String(r2.pid).padEnd(7)} ${r2.owner.padEnd(10)} ${r2.result ? `$${r2.result.costUsd.toFixed(2)} \xB7 ${r2.result.turns} turns${r2.result.isError ? " \xB7 error" : ""}` : "starting\u2026"}`);
+        break;
+      }
+      if (sub === "send" || sub === "stop") {
+        const target = positionals[1];
+        if (!target)
+          throw new Error(`usage: swarm run ${sub} <task|id>${sub === "send" ? ' "text"' : ""}`);
+        const r2 = sub === "send" ? await fetch(`${base}/v1/runs/${encodeURIComponent(target)}/send`, {
+          method: "POST",
+          headers: { "content-type": "application/json" },
+          body: JSON.stringify({ text: positionals.slice(2).join(" ") })
+        }) : await fetch(`${base}/v1/runs/${encodeURIComponent(target)}`, { method: "DELETE" });
+        const j = await r2.json();
+        if (json)
+          console.log(JSON.stringify(j));
+        else if (j.ok)
+          console.log(sub === "send" ? `sent to ${target}` : `stopped ${target}`);
+        else {
+          console.error(`REFUSED: ${j.error}`);
+          process.exit(1);
+        }
+        break;
+      }
+      const task = flag("--task") ?? sub;
+      let prompt = flag("--prompt");
+      const pf = flag("--prompt-file");
+      if (!prompt && pf)
+        prompt = await Bun.file(resolve3(pf)).text();
+      if (!task || !prompt)
+        throw new Error('usage: swarm run --task <id> --prompt "\u2026" | --prompt-file f  [--model] [--permission-mode] [--allowed-tools a,b] [--max-turns n]');
+      const r = await fetch(`${base}/v1/runs`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({
+          projectId: proj.id,
+          task,
+          prompt,
+          owner: flag("--owner") ?? process.env.USER ?? "me",
+          model: flag("--model"),
+          permissionMode: flag("--permission-mode"),
+          allowedTools: flag("--allowed-tools")?.split(",").map((t) => t.trim()).filter(Boolean),
+          maxTurns: flag("--max-turns") ? Number(flag("--max-turns")) : undefined
+        })
+      }).then((x) => x.json());
+      if (json)
+        console.log(JSON.stringify(r));
+      else if (r.ok && r.run)
+        console.log(`run ${r.run.id} on ${task} (pid ${r.run.pid})
+  worktree: ${r.run.worktree}
+  session:  ${r.run.sessionId}
+  log:      ${r.run.log}
+  steer:    swarm run send ${task} "\u2026"   stop: swarm run stop ${task}   watch: swarm tail --session ${r.run.sessionId}`);
+      else {
+        console.error(`REFUSED: ${r.error}`);
+        process.exit(1);
+      }
+      break;
+    }
+    case "handoff":
+    case "resume": {
+      await ensureDaemon({ quiet: true });
+      const task = arg();
+      if (!task)
+        throw new Error(`usage: swarm ${cmd} <task> \u2026`);
+      const proj = await api("/v1/projects", {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ path: resolve3(".") })
+      });
+      if (cmd === "resume") {
+        const r2 = await fetch(`${new SwarmClient().baseUrl}/v1/handoffs?project=${proj.id}&task=${encodeURIComponent(task)}`);
+        const j = await r2.json();
+        if (json)
+          console.log(JSON.stringify(j.handoff));
+        else
+          console.log(j.text ?? `no handoff on ${task}`);
+        break;
+      }
+      const flag = (n) => {
+        const i = rest.indexOf(n);
+        return i >= 0 ? rest[i + 1] : undefined;
+      };
+      const r = await fetch(`${new SwarmClient().baseUrl}/v1/handoffs`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({
+          projectId: proj.id,
+          task,
+          done: flag("--done"),
+          remaining: flag("--remaining"),
+          files: (flag("--files") ?? "").split(",").map((f) => f.trim()).filter(Boolean),
+          verify: flag("--verify") ?? null,
+          by: flag("--by") ?? process.env.USER ?? null,
+          sessionId: process.env.CLAUDE_SESSION_ID ?? null
+        })
+      }).then((x) => x.json());
+      if (json)
+        console.log(JSON.stringify(r));
+      else if (r.ok)
+        console.log(`handoff recorded on ${task} \u2014 the next session in its worktree sees it on start`);
+      else {
+        console.error(`REFUSED: ${r.error}`);
+        process.exit(1);
+      }
+      break;
+    }
+    case "gate": {
+      await ensureDaemon({ quiet: true });
+      const proj = await api("/v1/projects", {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ path: resolve3(".") })
+      });
+      const valueFlags = new Set(["--rubric", "--evidence"]);
+      const positionals = [];
+      for (let i = 0;i < rest.length; i++) {
+        const a = rest[i];
+        if (valueFlags.has(a))
+          i++;
+        else if (!a.startsWith("--"))
+          positionals.push(a);
+      }
+      const flag = (n) => {
+        const i = rest.indexOf(n);
+        return i >= 0 ? rest[i + 1] : undefined;
+      };
+      const sub = positionals[0] ?? "ls";
+      if (sub === "record") {
+        const [, task, gate, verdict] = positionals;
+        if (!task || !gate || !verdict)
+          throw new Error('usage: swarm gate record <task> <gate> pass|fail --rubric "what was checked" [--evidence "\u2026"]');
+        const r = await fetch(`${new SwarmClient().baseUrl}/v1/gates`, {
+          method: "POST",
+          headers: { "content-type": "application/json" },
+          body: JSON.stringify({
+            projectId: proj.id,
+            task,
+            gate,
+            verdict,
+            rubric: flag("--rubric"),
+            evidence: flag("--evidence"),
+            sessionId: process.env.CLAUDE_SESSION_ID ?? null
+          })
+        }).then((x) => x.json());
+        if (json)
+          console.log(JSON.stringify(r));
+        else if (r.ok)
+          console.log(`recorded ${gate} ${verdict} on ${task}`);
+        else {
+          console.error(`REFUSED: ${r.error}`);
+          process.exit(1);
+        }
+        break;
+      }
+      if (sub === "ls") {
+        const task = positionals[1];
+        const q = new URLSearchParams({ project: proj.id });
+        if (task)
+          q.set("task", task);
+        const g = await api(`/v1/gates?${q}`);
+        if (json)
+          console.log(JSON.stringify(g));
+        else if (task) {
+          if (!g.status?.length)
+            console.log(`no gates on ${task}${g.required.length ? ` (required: ${g.required.join(", ")})` : ""}`);
+          for (const st of g.status ?? [])
+            console.log(`${(st.verdict ?? "\u2014").padEnd(5)} ${st.gate.padEnd(12)} ${st.runs} run${st.runs === 1 ? "" : "s"}, ${st.fails} fail${st.fails === 1 ? "" : "s"}`);
+          for (const r of g.runs)
+            console.log(`  ${r.createdAt.slice(0, 16)} ${r.gate.padEnd(12)} ${r.verdict.padEnd(5)} ${r.rubric.slice(0, 70)}`);
+        } else {
+          if (g.required.length)
+            console.log(`required: ${g.required.join(", ")}`);
+          if (!g.runs.length)
+            console.log("no gate runs yet");
+          for (const r of g.runs.slice(0, 50))
+            console.log(`${r.createdAt.slice(0, 16)} ${r.task.padEnd(10)} ${r.gate.padEnd(12)} ${r.verdict.padEnd(5)} ${r.rubric.slice(0, 60)}`);
+        }
+        break;
+      }
+      throw new Error("usage: swarm gate record|ls");
+    }
     case "tasks": {
       await ensureDaemon({ quiet: true });
       const proj = await api("/v1/projects", {