@ra3orblade/swarm 0.5.0 → 0.6.0

package/dist/swarm-mcp.js

@@ -19765,6 +19765,29 @@ function buildServer() {
       resources
     });
   });
+  server.registerTool("swarm_search", {
+    title: "Search Swarm's memory",
+    description: "Full-text search over what Swarm remembers about this repo: handoffs (what was done / what's left), incidents (commands the rules stopped, and why), gate runs (rubric + evidence) and what previous sessions last said. Not the codebase \u2014 grep that. Words are AND-ed, the last one is a prefix; quote a phrase; `kind:incident` / `task:M1.2` filter. Use it before redoing work someone may have done, or when a rule blocks you and you want to know how it was handled before.",
+    inputSchema: {
+      query: exports_external.string(),
+      kind: exports_external.enum(["handoff", "incident", "gate", "session"]).optional(),
+      all_projects: exports_external.boolean().optional().describe("search every project, not just this repo"),
+      limit: exports_external.number().int().min(1).max(100).optional()
+    }
+  }, async ({ query, kind, all_projects, limit }) => {
+    const q = new URLSearchParams({ q: query, limit: String(limit ?? 20) });
+    if (!all_projects)
+      q.set("project", await projectId());
+    if (kind)
+      q.set("kind", kind);
+    const r = await api2(`/v1/memory?${q}`);
+    if (!r.hits.length)
+      return ok(`nothing in memory matches "${query}"`, { hits: [] });
+    return ok(r.hits.map((h) => `[${h.kind}] ${h.title}${h.task ? ` (${h.task})` : ""} \u2014 ${h.ts.slice(0, 16)}
+${h.text}`).join(`
+
+`), r.hits);
+  });
   server.registerTool("swarm_next_task", {
     title: "Next claimable task",
     description: "The first unclaimed task in this repo's task source whose dependencies are done \u2014 what to pick up next. Needs `[tasks] source` in .swarm.toml. Pass all=true to list every ready task.",
@@ -19815,7 +19838,7 @@ function buildServer() {
   });
   server.registerTool("swarm_resume", {
     title: "Read the latest handoff",
-    description: "The latest handoff on a task: done, remaining, files, verify. Read it before continuing someone else's work.",
+    description: "The latest handoff on a task: done, remaining, files, verify. Read it before continuing someone else's work. Handoffs marked `auto:` were derived by Swarm from what the previous session did (files edited, last verify command) when it stopped without leaving one.",
     inputSchema: { task: exports_external.string() }
   }, async ({ task }) => {
     const pid = await projectId();

package/dist/swarm.js

@@ -147,6 +147,8 @@ var HOOK_EVENTS = [
 // packages/core/src/rules.ts
 var LIVE_WINDOW_MS = 10 * 60000;
 var WRITE_TOOLS = new Set(["Write", "Edit", "MultiEdit", "NotebookEdit"]);
+// packages/core/src/ledger.ts
+var EDIT_TOOLS = new Set(["Edit", "Write", "MultiEdit", "NotebookEdit"]);
 // packages/cli/src/install.ts
 var MARK = "swarm-hook";
 var isOurs = (h) => h.command.includes(MARK) || h.command.includes("/packages/hook/src/bin.ts");
@@ -397,6 +399,7 @@ var help = `swarm \u2014 control plane for AI-agent development
   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
+  run resume <session-id> [--model m] [--permission-mode m]   spawn a run that picks up where a dead session stopped (its handoff + tail)
   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]
@@ -406,6 +409,8 @@ var help = `swarm \u2014 control plane for AI-agent development
   serve ls | stop [name]  list / stop servers this project started (by pid, never by pattern)
   proc start [--name n] -- <cmd> | ls | stop <name|pid>   same, for workers without a port
   stats [-p] [--json]     all-time totals, streak, records (the dashboard's Stats view)
+  search <query\u2026> [-p] [--kind handoff|incident|gate|session] [--json]   memory over Swarm's own data (handoffs, incidents, gates, what sessions said)
+  rules dryrun [--set rule=mode,\u2026] [--limit n] [--json]   replay this repo's history under rule modes; shows what would fire + flaky signals
 
   install | uninstall     add/remove Swarm hooks in ~/.claude/settings.json
 
@@ -659,21 +664,24 @@ url: ${resolveBaseUrl()}`);
         }
         break;
       }
-      const task = flag("--task") ?? sub;
-      let prompt = flag("--prompt");
+      const resumeFrom = sub === "resume" ? positionals[1] : undefined;
+      if (sub === "resume" && !resumeFrom)
+        throw new Error("usage: swarm run resume <session-id>");
+      const task = resumeFrom ? "(resumed)" : flag("--task") ?? sub;
+      let prompt = resumeFrom ? "(from handoff)" : 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`, {
+      const r = await fetch(resumeFrom ? `${base}/v1/sessions/${encodeURIComponent(resumeFrom)}/resume` : `${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",
+          owner: flag("--owner") ?? (resumeFrom ? undefined : process.env.USER ?? "me"),
           model: flag("--model"),
           permissionMode: flag("--permission-mode"),
           allowedTools: flag("--allowed-tools")?.split(",").map((t) => t.trim()).filter(Boolean),
@@ -683,11 +691,11 @@ url: ${resolveBaseUrl()}`);
       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})
+        console.log(`run ${r.run.id} on ${r.run.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}`);
+  steer:    swarm run send ${r.run.task} "\u2026"   stop: swarm run stop ${r.run.task}   watch: swarm tail --session ${r.run.sessionId}`);
       else {
         console.error(`REFUSED: ${r.error}`);
         process.exit(1);
@@ -817,6 +825,82 @@ url: ${resolveBaseUrl()}`);
       }
       throw new Error("usage: swarm gate record|ls");
     }
+    case "search": {
+      await ensureDaemon({ quiet: true });
+      const q = new URLSearchParams({ limit: "30" });
+      const words = [];
+      for (let i = 0;i < rest.length; i++) {
+        const a = rest[i];
+        if (a === "--kind")
+          q.set("kind", rest[++i] ?? "");
+        else if (a === "-p") {
+          const proj = await api("/v1/projects", {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({ path: resolve3(".") })
+          });
+          q.set("project", proj.id);
+        } else if (!a.startsWith("--"))
+          words.push(a);
+      }
+      if (!words.length)
+        throw new Error("usage: swarm search <query\u2026> [-p] [--kind k]");
+      q.set("q", words.join(" "));
+      const r = await api(`/v1/memory?${q}`);
+      if (json)
+        console.log(JSON.stringify(r.hits));
+      else if (!r.hits.length)
+        console.log("nothing in memory matches");
+      else
+        for (const h of r.hits)
+          console.log(`${h.kind.padEnd(8)} ${h.ts.slice(0, 16).replace("T", " ")}  ${h.title}${h.task ? `  [${h.task}]` : ""}
+         ${h.snippet.split("\x01").join("").split("\x02").join("").replace(/\s+/g, " ")}${h.sessionId ? `
+         session ${h.sessionId}` : ""}`);
+      break;
+    }
+    case "rules": {
+      if (rest[0] !== "dryrun")
+        throw new Error("usage: swarm rules dryrun [--set rule=mode,\u2026] [--limit n]");
+      await ensureDaemon({ quiet: true });
+      const proj = await api("/v1/projects", {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ path: resolve3(".") })
+      });
+      const q = new URLSearchParams({ project: proj.id });
+      const si = rest.indexOf("--set");
+      if (si >= 0)
+        for (const kv of (rest[si + 1] ?? "").split(",")) {
+          const [k, v] = kv.split("=");
+          if (k && v)
+            q.set(k.trim(), v.trim());
+        }
+      const li = rest.indexOf("--limit");
+      if (li >= 0)
+        q.set("limit", rest[li + 1] ?? "");
+      const r = await api(`/v1/rules/dryrun?${q}`);
+      if (json) {
+        console.log(JSON.stringify(r));
+        break;
+      }
+      console.log(`dry-run over ${r.evaluated} of ${r.calls} recorded calls (nothing recorded)`);
+      for (const [rule, n] of Object.entries(r.byRule))
+        console.log(`  ${rule.padEnd(26)} ${String(r.modes[rule]).padEnd(5)} ask ${String(n.ask).padStart(4)}  deny ${String(n.deny).padStart(4)}`);
+      if (r.flaky.length) {
+        console.log(`
+flaky signals:`);
+        for (const f of r.flaky)
+          console.log(`  ${f.display}
+    ${f.suggestion}`);
+      }
+      if (r.hits.length) {
+        console.log(`
+would have fired (newest last):`);
+        for (const h of r.hits.slice(-20))
+          console.log(`  ${h.ts.slice(11, 19)} ${h.action.padEnd(4)} ${h.rule.padEnd(20)} ${h.display}${h.completed ? "  (ran)" : ""}`);
+      }
+      break;
+    }
     case "tasks": {
       await ensureDaemon({ quiet: true });
       const proj = await api("/v1/projects", {
@@ -830,7 +914,9 @@ url: ${resolveBaseUrl()}`);
       if (json)
         console.log(JSON.stringify(rows));
       else if (!t.source)
-        console.log('no task source \u2014 add `[tasks] source = "path/to/plan.md"` to .swarm.toml');
+        console.log('no task source \u2014 add `[tasks] source = "path/to/plan.md"` (or "github" / "linear") to .swarm.toml');
+      else if (t.error && !t.tasks.length)
+        console.log(`${t.source}: ${t.error}`);
       else if (!rows.length)
         console.log(ready ? "nothing ready to claim" : `no tasks in ${t.source}`);
       else