@swarmdo/cli 1.50.0 → 1.58.1

package/README.md

@@ -2,7 +2,7 @@
 
 [![swarmdo](swarmdo/assets/brand/logo-full.svg)](https://swarmdo.com)
 
-[![npm version (swarmdo)](https://img.shields.io/badge/npx%20swarmdo-v1.50.0-cb3837?style=for-the-badge&logo=npm&logoColor=white)](https://github.com/SwarmDo/swarmdo/releases)
+[![npm version (swarmdo)](https://img.shields.io/badge/npx%20swarmdo-v1.58.1-cb3837?style=for-the-badge&logo=npm&logoColor=white)](https://github.com/SwarmDo/swarmdo/releases)
 [![MIT License](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](https://github.com/SwarmDo/swarmdo/blob/main/LICENSE)
 [![Website](https://img.shields.io/badge/swarmdo.com-e2a33c?style=for-the-badge&logoColor=black)](https://swarmdo.com)
 [![Star on GitHub](https://img.shields.io/github/stars/SwarmDo/swarmdo?style=for-the-badge&logo=github&color=gold)](https://github.com/SwarmDo/swarmdo)
@@ -271,7 +271,7 @@ The recent release train added a full day-to-day operations layer around the swa
 
 | Command | What it does |
 |---------|-------------|
-| `swarmdo usage` (alias `cost`) | Claude Code **spend analytics** from your local transcripts — `daily`, `weekly`, `monthly` (with a month-end spend projection), `models`, `projects`, `sessions`, live 5-hour `blocks` burn, `errors` (tool-failure analytics), `cache` (prompt-cache efficiency + $ saved), `diff` (period-over-period comparison with per-model movers), `reflect` (a wrapped-style retrospective — busiest day, streak, top models/projects, peak hour, delegation ratio — with a shareable `--html` dashboard), and `limits` (an official-quota **exhaustion forecaster** over Claude Code's `rate_limits`); the standard views take `--csv` for spreadsheet export |
+| `swarmdo usage` (alias `cost`) | Claude Code **spend analytics** from your local transcripts — `daily`, `weekly`, `monthly` (with a month-end spend projection), `models`, `projects`, `sessions`, live 5-hour `blocks` burn, `errors` (tool-failure analytics), `friction` (how often you interrupt Claude + which tool was running + dominant error categories), `cache` (prompt-cache efficiency + $ saved), `diff` (period-over-period comparison with per-model movers), `reflect` (a wrapped-style retrospective — busiest day, streak, top models/projects, peak hour, delegation ratio — with a shareable `--html` dashboard), and `limits` (an official-quota **exhaustion forecaster** over Claude Code's `rate_limits`); the standard views take `--csv` for spreadsheet export |
 | `swarmdo usage guard` | **Budget policy** — limits for the active 5h block / today / month via flags or `SWARMDO_GUARD_*` env → ok / warn / over; `--strict` exits 1, safe for CI gates and Stop hooks |
 | `swarmdo hud` | **One-screen ops HUD** — 5h block burn, task readiness, daemon workers, memory snapshots (`--watch`, `--json`) |
 | `swarmdo repair` (alias `tdd-repair`) | **Test-Driven Repair** — a bounded, budget-capped headless `claude` loop that fixes source until a failing test passes; dry-run unless `--confirm` |
@@ -292,6 +292,9 @@ The recent release train added a full day-to-day operations layer around the swa
 | `swarmdo coupling` | **Files that change together** — the empirical complement to `affected`'s static import graph: mine git history for file pairs that keep landing in the same commit (a schema and its type, a serializer split across modules) so you catch the co-edit you'd otherwise forget. `--file <path>` answers "what changes with X?", `--since`, `--min-shared`, `--csv`. Modeled on code-maat / CodeScene. Also an MCP tool (`coupling`). Deterministic |
 | `swarmdo ownership` | **Who owns each file, and what breaks if they leave** — a per-file knowledge map + bus factor from git history: the dominant author, ownership concentration, and the fewest authors whose churn clears 50% (a lone owner is flagged ⚠ key-person), plus a repo-wide truck factor. `--since`, `--min-churn`, `--top`, `--csv`, `--format json`. code-maat main-dev / CodeScene "Knowledge Map"; also an MCP tool (`ownership`). Deterministic |
 | `swarmdo hidden-coupling` | **Co-change with no import edge** — join the two graphs swarmdo already owns (temporal `coupling` from git + `codegraph`'s import graph) and emit the set difference: file pairs that keep changing together yet nothing in the code links them ("logical minus structural coupling" — a config and its consumers, a schema and its mirror type). The co-edit `affected` can't see. `--since`, `--min-shared`, `--csv`, `--format json`. Grounded in Gall et al. (ICSM 1998). Deterministic |
+| `swarmdo standup` (alias `mine`) | **What did I do?** — your commits since your last working day, grouped by day with a diffstat. **Weekend-aware** (git-standup parity): on Monday it reaches back to Friday, on Sunday to Friday, otherwise to yesterday — one-command recall for a standup or for re-orienting at the start of a session. Defaults to the current git user; `--author <name>`/`--all` for teammates, `--days N` or `--since 2w` to override the window, `--format json`. Pure engine (weekend math + per-day fold) → fixture-tested. Deterministic |
+| `swarmdo commands` (alias `slash`) | **Hot/cold/orphan usage report** for your authored `.claude/` surface — which custom slash-commands (`.claude/commands/**`) and subagents (`.claude/agents/**`) you actually invoke (**hot**, with counts), which are **cold** (defined but never used → prune candidates), and which are **orphan** (invoked but undefined → a typo or a builtin). `config lint` says "are these valid?"; this says "are these used?" — joining the defined files against invocation counts mined from local transcripts (`<command-name>` markers + `subagent_type` fields). `--unused` prints just the prune list, `--unused --strict` is a CI gate (exit 1 if anything's dead), `--all` counts across every project, `--json`. Pure parsers + join → fixture-tested |
+| `swarmdo agent bridge` | **Link Claude Code agents ⇄ Swarmdo** — the fix for "Swarmdo is installed but never actually used." Swarmdo can't call Claude Code's `Agent` tool (only the main loop can), so `agent bridge register -n <name>` binds a real Claude Code agent into Swarmdo's registry (`swarmdo agent list` stops being empty) and **auto-spins-up a swarm from your config, enrolling the agent** — the next bind joins the same swarm. `bridge list` (bound vs native), `bridge sync --live a,b` (reconcile drift), `bridge advise "<prompt>"` (should this warrant a swarm? which roles?). Also MCP tools `agent_bridge_register`/`agent_bridge_list`. Pure engine → 16 tests |
 | `swarmdo testreport` | **JUnit/TAP → failure digest** — turn raw test-result files into the exact failing test names + `file:line` + assertion messages, instead of scanning hundreds of log lines. The front-half of the test→fix loop: feed the failures straight into `repair`. Reads a file, a directory, or stdin; `--ci` exits 1 on any failure, `--format json`. Also an MCP tool (`testreport`). Deterministic |
 | `swarmdo integrations` (alias `integrate`) | **Use swarmdo from Codex CLI, GitHub Copilot CLI, and pi** — one command wires AGENTS.md + each CLI's MCP config (idempotent, dry-run first, never touches your Claude Code setup) |
 | OpenRouter model pool | **Let swarms pick from any models you configure** — declare tier-mapped OpenRouter models in `swarmdo.config.json`; the router Thompson-samples among them per task and the execution layer dispatches the winner |
@@ -299,7 +302,7 @@ The recent release train added a full day-to-day operations layer around the swa
 | `swarmdo mcp doctor` | **MCP config diagnosis** — missing binaries, bad URLs, malformed entries across `.mcp.json` + `~/.claude.json` |
 | `swarmdo config lint` | **Static config validation** — the pure shape layer for `swarmdo.config.json`, the `.claude/settings*.json` hooks block, `.mcp.json`, **`.claude/agents/*.md` subagents** (missing `name`/`description`, a `name` duplicated across files — CC silently loads only one — a bad `model`, malformed frontmatter), and **custom slash commands + skills** (malformed YAML that makes CC load empty metadata, a bad `effort`, an inline `` !`cmd` `` bash-injection that's inert or not covered by `allowed-tools`). `--strict` gates CI |
 | `swarmdo permissions` (alias `perms`) | **Audit your Claude Code permission rules** — static analysis of `permissions.allow`/`deny`/`ask` in `.claude/settings*.json`: flags allow↔deny conflicts (dead rules), over-broad `Bash(*)` grants, shadowed/redundant rules, duplicates, and malformed entries. `--strict` gates CI. Read-only; the static-safety sibling of `config lint` / `mcp doctor` |
-| `swarmdo comms` (alias `mailbox`) | **Cross-session agent mailbox** — one Claude Code session messages another by name (`send -t <session>`, `-t all` broadcasts, `inbox`, `read`, `watch`); sessions on the same repo share `.swarmdo/comms/`. `inbox --hook` surfaces new mail as prompt context without polling. Also MCP tools (`comms_send`/`comms_inbox`) |
+| `swarmdo comms` (alias `mailbox`) | **Cross-session, cross-tool agent mailbox** — one agent session (Claude Code, Codex, Copilot, or pi) messages another by name (`send -t <session>`, `-t all` broadcasts, `inbox`, `read`, `watch`); sessions on the same repo share `.swarmdo/comms/`. Non-Claude agents set `$SWARMDO_AGENT` for a stable identity. `inbox --hook` surfaces new mail as prompt context without polling. Also MCP tools (`comms_send`/`comms_inbox`) |
 | `swarmdo hooks memory-inject` | **Prompt-time semantic memory injection** — embeds each prompt, vector-searches your stored memories, and injects the most relevant under a token budget (recall at the moment of need); wire it with `hooks recipe memory-inject` |
 | `swarmdo hooks notify -d` | **Desktop notifications** — OS-native toast (macOS `osascript`, Linux `notify-send`) |
 | `swarmdo hooks recipe` | **One-command Claude Code hooks** — install `notify-done`/`notify-input` (desktop pings), `memory-inject` (relevant memories each prompt), `comms-inbox` (new mail as context), or `command-guard` (a PreToolUse deny hook that blocks dangerous bash — `rm -rf /`, pipe-to-shell, force-push to main — the net swarmdo needs when running headless); dry-run by default, idempotent merge that never clobbers your settings |

package/dist/src/agent-bridge/bridge.d.ts

@@ -0,0 +1,104 @@
+/**
+ * agent-bridge/bridge.ts — link Claude Code Agent-tool agents to Swarmdo's
+ * agent registry so the two systems share ONE view.
+ *
+ * The problem this solves: Swarmdo (MCP server + CLI + hooks) runs
+ * out-of-process and CANNOT invoke Claude Code's `Agent` tool — only the main
+ * Claude Code loop can spawn real LLM workers. So today a session can run four
+ * Claude Code agents while `swarmdo agent list` stays empty: installed but
+ * inert. The honest integration is a BINDING — when a real Claude Code agent is
+ * spawned, register a bound record in Swarmdo's canonical store
+ * (`.swarmdo/agents/store.json`, via the existing `agent_spawn`/registerAgent
+ * path — NO parallel store) so `swarmdo agent list` / `swarm_status` reflect
+ * reality, and reconcile the two sides on demand.
+ *
+ * Pure + deterministic: these functions build the registration input, classify
+ * whether a prompt warrants a swarm, and diff the two rosters. All fs / MCP /
+ * spawning lives in the command + hook layers, so this module is
+ * fully fixture-testable.
+ */
+/** A real Claude Code agent, as the main loop sees it (name@session-…). */
+export interface ClaudeAgentDescriptor {
+    /** the Agent-tool name, e.g. "research-ccgap" */
+    name: string;
+    /** the Claude Code session id, e.g. "cec69c3c" (from `name@session-cec69c3c`) */
+    sessionId?: string;
+    /** the subagent_type, e.g. "general-purpose" / "coder" */
+    agentType: string;
+    /** one-line task/prompt summary */
+    task?: string;
+    /** last-known lifecycle state */
+    status?: 'idle' | 'busy' | 'terminated';
+}
+/** The Swarmdo-side binding, stored inside an AgentRecord's `config.binding`. */
+export interface AgentBinding {
+    origin: 'claude-code';
+    claudeName: string;
+    sessionId?: string;
+    task?: string;
+    /** ISO timestamp the binding was created/refreshed */
+    boundAt: string;
+}
+/** Minimal shape of a Swarmdo AgentRecord needed for reconciliation. */
+export interface SwarmdoAgentLike {
+    agentId: string;
+    agentType: string;
+    status?: string;
+    config?: Record<string, unknown> & {
+        binding?: AgentBinding;
+    };
+}
+/**
+ * Deterministic Swarmdo agentId for a Claude Code agent — stable across
+ * re-registration so binding the same agent twice UPDATES the record rather
+ * than spawning a duplicate (registerAgent honors an explicit `agentId`). Pure.
+ */
+export declare function bridgeAgentId(d: ClaudeAgentDescriptor): string;
+/**
+ * Build the `agent_spawn` input that registers a bound Swarmdo record for a
+ * Claude Code agent. Pure — returns the input object; the caller persists it via
+ * the real registerAgent / `agent_spawn` path (so the swarm-join + graph-node +
+ * store all happen exactly as for a native Swarmdo agent). `nowIso` is injected
+ * for testability.
+ */
+export declare function buildSpawnInput(d: ClaudeAgentDescriptor, nowIso: string): Record<string, unknown>;
+/** Is a Swarmdo record a Claude-Code binding (vs a native Swarmdo agent)? Pure. */
+export declare function isBound(a: SwarmdoAgentLike): boolean;
+export interface Reconciliation {
+    /** claudeName present in BOTH the live roster and the Swarmdo store */
+    mirrored: string[];
+    /** live Claude Code agents with NO bound Swarmdo record (need registering) */
+    unmirrored: string[];
+    /** bound Swarmdo records whose Claude Code agent is gone (stale — reap) */
+    orphaned: string[];
+}
+/**
+ * Diff the live Claude Code roster against the Swarmdo store. Pure. Only
+ * Claude-Code-bound records participate (native Swarmdo agents are ignored).
+ * Returns sorted, de-duplicated name lists so output is deterministic.
+ */
+export declare function reconcile(swarmdoAgents: SwarmdoAgentLike[], liveClaudeNames: string[]): Reconciliation;
+/**
+ * agentIds of Claude-Code-bound records whose bound agent is NOT in the live
+ * roster — the orphans to reap so stale bindings don't accumulate across
+ * sessions. Native (unbound) Swarmdo agents are never selected. Pure; sorted
+ * for deterministic pruning. Complements `reconcile` (which reports orphan
+ * NAMES) by giving the store keys the prune path deletes.
+ */
+export declare function orphanedAgentIds(swarmdoAgents: SwarmdoAgentLike[], liveClaudeNames: string[]): string[];
+export interface SwarmIntent {
+    /** true when the prompt is substantial enough to warrant bound agents */
+    requiresAgents: boolean;
+    /** short human reason (which signal fired) */
+    reason: string;
+    /** suggested agent roles, most-important first (empty when !requiresAgents) */
+    suggestedRoles: string[];
+}
+/**
+ * Decide whether a prompt warrants a bound-agent swarm, and which roles. Pure.
+ * requiresAgents is true when an agentic verb fires AND the prompt is long
+ * enough that it isn't a one-line question — a trivial/conversational signal
+ * alone (with no agentic verb) suppresses it. Deterministic; no LLM.
+ */
+export declare function classifyPrompt(prompt: string): SwarmIntent;
+//# sourceMappingURL=bridge.d.ts.map

package/dist/src/agent-bridge/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../../src/agent-bridge/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,2EAA2E;AAC3E,MAAM,WAAW,qBAAqB;IACpC,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC;CACzC;AAED,iFAAiF;AACjF,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAAE,OAAO,CAAC,EAAE,YAAY,CAAA;KAAE,CAAC;CAC/D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAI9D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAejG;AAED,mFAAmF;AACnF,wBAAgB,OAAO,CAAC,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAEpD;AAED,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,aAAa,EAAE,gBAAgB,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,cAAc,CActG;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,gBAAgB,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAMvG;AAQD,MAAM,WAAW,WAAW;IAC1B,yEAAyE;IACzE,cAAc,EAAE,OAAO,CAAC;IACxB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAiBD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAe1D"}

package/dist/src/agent-bridge/bridge.js

@@ -0,0 +1,133 @@
+/**
+ * agent-bridge/bridge.ts — link Claude Code Agent-tool agents to Swarmdo's
+ * agent registry so the two systems share ONE view.
+ *
+ * The problem this solves: Swarmdo (MCP server + CLI + hooks) runs
+ * out-of-process and CANNOT invoke Claude Code's `Agent` tool — only the main
+ * Claude Code loop can spawn real LLM workers. So today a session can run four
+ * Claude Code agents while `swarmdo agent list` stays empty: installed but
+ * inert. The honest integration is a BINDING — when a real Claude Code agent is
+ * spawned, register a bound record in Swarmdo's canonical store
+ * (`.swarmdo/agents/store.json`, via the existing `agent_spawn`/registerAgent
+ * path — NO parallel store) so `swarmdo agent list` / `swarm_status` reflect
+ * reality, and reconcile the two sides on demand.
+ *
+ * Pure + deterministic: these functions build the registration input, classify
+ * whether a prompt warrants a swarm, and diff the two rosters. All fs / MCP /
+ * spawning lives in the command + hook layers, so this module is
+ * fully fixture-testable.
+ */
+/**
+ * Deterministic Swarmdo agentId for a Claude Code agent — stable across
+ * re-registration so binding the same agent twice UPDATES the record rather
+ * than spawning a duplicate (registerAgent honors an explicit `agentId`). Pure.
+ */
+export function bridgeAgentId(d) {
+    const sess = d.sessionId ? d.sessionId.replace(/[^A-Za-z0-9]/g, '').slice(0, 8) || 'nosess' : 'nosess';
+    const safe = d.name.replace(/[^A-Za-z0-9_-]+/g, '-').replace(/^-+|-+$/g, '') || 'agent';
+    return `cc-${sess}-${safe}`;
+}
+/**
+ * Build the `agent_spawn` input that registers a bound Swarmdo record for a
+ * Claude Code agent. Pure — returns the input object; the caller persists it via
+ * the real registerAgent / `agent_spawn` path (so the swarm-join + graph-node +
+ * store all happen exactly as for a native Swarmdo agent). `nowIso` is injected
+ * for testability.
+ */
+export function buildSpawnInput(d, nowIso) {
+    const binding = {
+        origin: 'claude-code',
+        claudeName: d.name,
+        ...(d.sessionId ? { sessionId: d.sessionId } : {}),
+        ...(d.task ? { task: d.task } : {}),
+        boundAt: nowIso,
+    };
+    return {
+        agentId: bridgeAgentId(d),
+        agentType: d.agentType,
+        domain: 'claude-code-bridge',
+        ...(d.task ? { task: d.task } : {}),
+        config: { binding },
+    };
+}
+/** Is a Swarmdo record a Claude-Code binding (vs a native Swarmdo agent)? Pure. */
+export function isBound(a) {
+    return a.config?.binding?.origin === 'claude-code';
+}
+/**
+ * Diff the live Claude Code roster against the Swarmdo store. Pure. Only
+ * Claude-Code-bound records participate (native Swarmdo agents are ignored).
+ * Returns sorted, de-duplicated name lists so output is deterministic.
+ */
+export function reconcile(swarmdoAgents, liveClaudeNames) {
+    const live = new Set(liveClaudeNames);
+    const bound = swarmdoAgents.filter(isBound);
+    const boundNames = new Set(bound.map((a) => a.config.binding.claudeName));
+    const mirrored = [];
+    const orphaned = [];
+    for (const a of bound) {
+        const nm = a.config.binding.claudeName;
+        if (live.has(nm))
+            mirrored.push(nm);
+        else
+            orphaned.push(nm);
+    }
+    const unmirrored = liveClaudeNames.filter((nm) => !boundNames.has(nm));
+    const uniqSort = (xs) => [...new Set(xs)].sort();
+    return { mirrored: uniqSort(mirrored), unmirrored: uniqSort(unmirrored), orphaned: uniqSort(orphaned) };
+}
+/**
+ * agentIds of Claude-Code-bound records whose bound agent is NOT in the live
+ * roster — the orphans to reap so stale bindings don't accumulate across
+ * sessions. Native (unbound) Swarmdo agents are never selected. Pure; sorted
+ * for deterministic pruning. Complements `reconcile` (which reports orphan
+ * NAMES) by giving the store keys the prune path deletes.
+ */
+export function orphanedAgentIds(swarmdoAgents, liveClaudeNames) {
+    const live = new Set(liveClaudeNames);
+    return swarmdoAgents
+        .filter((a) => isBound(a) && !live.has(a.config.binding.claudeName))
+        .map((a) => a.agentId)
+        .sort();
+}
+// Work that benefits from a swarm — verbs that imply multi-step build/change.
+const AGENTIC_RE = /\b(implement|build|create|add(?:ing)?|develop|refactor\w*|migrat\w*|redesign|re-?architect\w*|architect\w*|feature|integrat\w*|overhaul|rewrite|port|scaffold|end-to-end|multi-file|test suite|coverage|audit|harden\w*|vulnerab\w*|cve|fix\w*|debug\w*|optimi[sz]e|performance)\b/i;
+// Signals the task is trivial / conversational — a single edit or a question.
+const TRIVIAL_RE = /\b(what|why|how|explain|describe|show|list|find|search|where|which|typo|readme|comment|one-?liner|quick question|rename|bump (?:the )?version|status|help)\b/i;
+// Role-selecting signals (checked in priority order).
+const ROLE_SIGNALS = [
+    { re: /\b(security|vulnerab\w*|cve|auth\w*|inject\w*|xss|ssrf)\b/i, roles: ['security-auditor', 'coder', 'reviewer'] },
+    { re: /\b(refactor\w*|migrat\w*|redesign|re-?architect\w*|overhaul|rewrite)\b/i, roles: ['system-architect', 'coder', 'reviewer'] },
+    { re: /\b(perf\w*|optimi[sz]e|benchmark|latency|throughput)\b/i, roles: ['perf-analyzer', 'coder', 'tester'] },
+    { re: /\b(test|coverage|tdd|spec)\b/i, roles: ['tester', 'coder', 'reviewer'] },
+    { re: /\b(feature|implement|build|integrat\w*|end-to-end|api)\b/i, roles: ['researcher', 'system-architect', 'coder', 'tester', 'reviewer'] },
+];
+/**
+ * Decide whether a prompt warrants a bound-agent swarm, and which roles. Pure.
+ * requiresAgents is true when an agentic verb fires AND the prompt is long
+ * enough that it isn't a one-line question — a trivial/conversational signal
+ * alone (with no agentic verb) suppresses it. Deterministic; no LLM.
+ */
+export function classifyPrompt(prompt) {
+    const p = (prompt || '').trim();
+    if (!p)
+        return { requiresAgents: false, reason: 'empty prompt', suggestedRoles: [] };
+    const agentic = AGENTIC_RE.test(p);
+    const trivial = TRIVIAL_RE.test(p);
+    // A short prompt (< 24 chars) with no agentic verb is almost always a question.
+    if (!agentic)
+        return { requiresAgents: false, reason: trivial ? 'conversational / single-step' : 'no agentic intent detected', suggestedRoles: [] };
+    // Agentic verb present but the prompt is a bare one-liner AND reads trivial →
+    // treat as a quick edit, not a swarm (e.g. "add a comment", "rename the flag").
+    if (trivial && p.length < 40)
+        return { requiresAgents: false, reason: 'agentic verb but reads as a quick single edit', suggestedRoles: [] };
+    let roles = ['coder'];
+    for (const sig of ROLE_SIGNALS) {
+        if (sig.re.test(p)) {
+            roles = sig.roles;
+            break;
+        }
+    }
+    return { requiresAgents: true, reason: 'agentic task — swarm recommended', suggestedRoles: roles };
+}
+//# sourceMappingURL=bridge.js.map

package/dist/src/agent-bridge/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../../src/agent-bridge/bridge.ts"],"names":[],"mappings":"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"}

package/dist/src/command-usage/usage.d.ts

@@ -0,0 +1,74 @@
+/**
+ * command-usage/usage.ts — a hot/cold/orphan USAGE report for a project's
+ * authored `.claude/` surface. `config lint` validates these files; this answers
+ * the orthogonal "are they actually used?" by joining the DEFINED set
+ * (`.claude/commands/**​/*.md` + `.claude/agents/**​/*.md`) against INVOCATION
+ * counts mined from the local transcripts (`<command-name>` markers +
+ * `"subagent_type"` fields). Three buckets: hot (defined & invoked), cold
+ * (defined, never invoked → prune candidates), orphan (invoked, not defined →
+ * typo / removed / builtin). #101.
+ *
+ * The parsers + join are pure and unit-tested; only collectCommandUsage touches
+ * the filesystem. Reuses defaultClaudeProjectDirs/findTranscriptFiles.
+ */
+export interface UsageItem {
+    name: string;
+    count: number;
+}
+export interface UsageBuckets {
+    /** defined AND invoked (count > 0), desc by count */
+    hot: UsageItem[];
+    /** defined but never invoked — prune candidates, sorted */
+    cold: string[];
+    /** invoked but not defined (typo / removed / builtin), sorted */
+    orphan: string[];
+}
+export interface CommandUsageReport {
+    commands: UsageBuckets;
+    agents: UsageBuckets;
+    filesScanned: number;
+    definedCommands: number;
+    definedAgents: number;
+    scope: 'project' | 'all';
+}
+/**
+ * Count custom slash-command invocations from raw transcript lines. Scoped to
+ * user-role lines (the `<command-name>` marker is injected on the user turn) so
+ * an assistant merely quoting the marker never inflates a count. The captured
+ * name is de-slashed (`/goal` → `goal`) to match the discovered-file key space.
+ * Pure.
+ */
+export declare function parseCommandInvocations(lines: string[]): Map<string, number>;
+/**
+ * Count subagent (Task tool) invocations by `subagent_type` from raw transcript
+ * lines. Not user-scoped — the field lives in an assistant `tool_use` block. Pure.
+ */
+export declare function parseSubagentInvocations(lines: string[]): Map<string, number>;
+/** Merge src counts into dest (dest mutated). */
+export declare function mergeCounts(dest: Map<string, number>, src: Map<string, number>): void;
+/**
+ * Join a DEFINED name list against INVOCATION counts into hot/cold/orphan. Both
+ * sides are compared de-slashed, so a defined `/build` matches a `build` count
+ * (agents carry no slash, so they're unaffected). Pure & deterministic. */
+export declare function joinUsage(defined: string[], counts: Map<string, number> | Record<string, number>): UsageBuckets;
+/**
+ * Discover the authored `.claude/` surface for a project. Command names use
+ * Claude Code's subdir namespacing (`.claude/commands/sDo/x.md` → `sDo:x`, top
+ * level → `x`) to match the `<command-name>` marker; agent names are the file
+ * basename (subagent_type is never namespaced). Pure w.r.t. inputs (reads fs).
+ */
+export declare function discoverAuthored(cwd: string): {
+    commands: string[];
+    agents: string[];
+};
+export interface CollectOptions {
+    cwd?: string;
+    /** scan every project's transcripts (default: only the current project) */
+    all?: boolean;
+}
+/** The encoded transcript-dir name Claude Code uses for a project path. */
+export declare function encodeProjectDir(cwd: string): string;
+/** Build the full report: discover authored files, mine invocation counts from
+ * the (project-scoped, or --all) transcripts, and join. fs-touching wrapper. */
+export declare function collectCommandUsage(opts?: CollectOptions): CommandUsageReport;
+//# sourceMappingURL=usage.d.ts.map

package/dist/src/command-usage/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../src/command-usage/usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,MAAM,WAAW,SAAS;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;CAAE;AAC3D,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,GAAG,EAAE,SAAS,EAAE,CAAC;IACjB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,iEAAiE;IACjE,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AACD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,SAAS,GAAG,KAAK,CAAC;CAC1B;AAID;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAW5E;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAS7E;AAED,iDAAiD;AACjD,wBAAgB,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAErF;AAED;;;2EAG2E;AAC3E,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,CAmB/G;AAqBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAQtF;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;gFACgF;AAChF,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,cAAmB,GAAG,kBAAkB,CA6BjF"}

package/dist/src/command-usage/usage.js

@@ -0,0 +1,161 @@
+/**
+ * command-usage/usage.ts — a hot/cold/orphan USAGE report for a project's
+ * authored `.claude/` surface. `config lint` validates these files; this answers
+ * the orthogonal "are they actually used?" by joining the DEFINED set
+ * (`.claude/commands/**​/*.md` + `.claude/agents/**​/*.md`) against INVOCATION
+ * counts mined from the local transcripts (`<command-name>` markers +
+ * `"subagent_type"` fields). Three buckets: hot (defined & invoked), cold
+ * (defined, never invoked → prune candidates), orphan (invoked, not defined →
+ * typo / removed / builtin). #101.
+ *
+ * The parsers + join are pure and unit-tested; only collectCommandUsage touches
+ * the filesystem. Reuses defaultClaudeProjectDirs/findTranscriptFiles.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { defaultClaudeProjectDirs, findTranscriptFiles } from '../usage/transcript-usage.js';
+const uniqSort = (xs) => [...new Set(xs)].sort((a, b) => a.localeCompare(b));
+/**
+ * Count custom slash-command invocations from raw transcript lines. Scoped to
+ * user-role lines (the `<command-name>` marker is injected on the user turn) so
+ * an assistant merely quoting the marker never inflates a count. The captured
+ * name is de-slashed (`/goal` → `goal`) to match the discovered-file key space.
+ * Pure.
+ */
+export function parseCommandInvocations(lines) {
+    const counts = new Map();
+    for (const line of lines) {
+        if (!/"(?:type|role)"\s*:\s*"user"/.test(line))
+            continue;
+        for (const m of line.matchAll(/<command-name>([^<]+)<\/command-name>/g)) {
+            const name = m[1].trim().replace(/^\/+/, '');
+            if (!name || name === '…')
+                continue;
+            counts.set(name, (counts.get(name) ?? 0) + 1);
+        }
+    }
+    return counts;
+}
+/**
+ * Count subagent (Task tool) invocations by `subagent_type` from raw transcript
+ * lines. Not user-scoped — the field lives in an assistant `tool_use` block. Pure.
+ */
+export function parseSubagentInvocations(lines) {
+    const counts = new Map();
+    for (const line of lines) {
+        for (const m of line.matchAll(/"subagent_type"\s*:\s*"([^"]+)"/g)) {
+            const name = m[1].trim();
+            if (name)
+                counts.set(name, (counts.get(name) ?? 0) + 1);
+        }
+    }
+    return counts;
+}
+/** Merge src counts into dest (dest mutated). */
+export function mergeCounts(dest, src) {
+    for (const [k, v] of src)
+        dest.set(k, (dest.get(k) ?? 0) + v);
+}
+/**
+ * Join a DEFINED name list against INVOCATION counts into hot/cold/orphan. Both
+ * sides are compared de-slashed, so a defined `/build` matches a `build` count
+ * (agents carry no slash, so they're unaffected). Pure & deterministic. */
+export function joinUsage(defined, counts) {
+    const asMap = counts instanceof Map ? counts : new Map(Object.entries(counts));
+    const norm = (n) => n.replace(/^\/+/, '');
+    const get = (n) => asMap.get(norm(n)) ?? 0;
+    const definedNorm = new Set(defined.map(norm));
+    const hot = [];
+    const cold = [];
+    for (const d of defined) {
+        const c = get(d);
+        if (c > 0)
+            hot.push({ name: d, count: c });
+        else
+            cold.push(d);
+    }
+    const orphan = [];
+    for (const [k, v] of asMap) {
+        if (v > 0 && !definedNorm.has(norm(k)))
+            orphan.push(k);
+    }
+    hot.sort((a, b) => b.count - a.count || a.name.localeCompare(b.name));
+    return { hot, cold: uniqSort(cold), orphan: uniqSort(orphan) };
+}
+/** All `.md` files under `root`, as paths RELATIVE to root (recursive; skips
+ * dotfiles). Mirrors config.ts's walkMd so `config lint` and this command agree
+ * on what counts as "defined". */
+function walkMdRel(root) {
+    const out = [];
+    const rec = (dir, prefix) => {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (e.name.startsWith('.'))
+                continue;
+            const rel = prefix ? `${prefix}/${e.name}` : e.name;
+            if (e.isDirectory())
+                rec(path.join(dir, e.name), rel);
+            else if (e.isFile() && e.name.endsWith('.md'))
+                out.push(rel);
+        }
+    };
+    rec(root, '');
+    return out;
+}
+/**
+ * Discover the authored `.claude/` surface for a project. Command names use
+ * Claude Code's subdir namespacing (`.claude/commands/sDo/x.md` → `sDo:x`, top
+ * level → `x`) to match the `<command-name>` marker; agent names are the file
+ * basename (subagent_type is never namespaced). Pure w.r.t. inputs (reads fs).
+ */
+export function discoverAuthored(cwd) {
+    const commands = walkMdRel(path.join(cwd, '.claude', 'commands')).map((rel) => rel.replace(/\.md$/, '').split('/').join(':'));
+    const agents = walkMdRel(path.join(cwd, '.claude', 'agents')).map((rel) => path.basename(rel).replace(/\.md$/, ''));
+    return { commands: uniqSort(commands), agents: uniqSort(agents) };
+}
+/** The encoded transcript-dir name Claude Code uses for a project path. */
+export function encodeProjectDir(cwd) {
+    return cwd.replace(/\//g, '-');
+}
+/** Build the full report: discover authored files, mine invocation counts from
+ * the (project-scoped, or --all) transcripts, and join. fs-touching wrapper. */
+export function collectCommandUsage(opts = {}) {
+    const cwd = opts.cwd ?? process.cwd();
+    const { commands: definedCommands, agents: definedAgents } = discoverAuthored(cwd);
+    const encoded = encodeProjectDir(cwd);
+    const cmdCounts = new Map();
+    const agentCounts = new Map();
+    let filesScanned = 0;
+    for (const dir of defaultClaudeProjectDirs()) {
+        for (const t of findTranscriptFiles(dir)) {
+            if (!opts.all && t.project !== encoded)
+                continue;
+            filesScanned++;
+            let content;
+            try {
+                content = fs.readFileSync(t.file, 'utf8');
+            }
+            catch {
+                continue;
+            }
+            const fileLines = content.split('\n');
+            mergeCounts(cmdCounts, parseCommandInvocations(fileLines));
+            mergeCounts(agentCounts, parseSubagentInvocations(fileLines));
+        }
+    }
+    return {
+        commands: joinUsage(definedCommands, cmdCounts),
+        agents: joinUsage(definedAgents, agentCounts),
+        filesScanned,
+        definedCommands: definedCommands.length,
+        definedAgents: definedAgents.length,
+        scope: opts.all ? 'all' : 'project',
+    };
+}
+//# sourceMappingURL=usage.js.map

package/dist/src/command-usage/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../../src/command-usage/usage.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/commands/agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAiC,MAAM,aAAa,CAAC;AA69B1E,eAAO,MAAM,YAAY,EAAE,OAqC1B,CAAC;AAoCF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/commands/agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAiC,MAAM,aAAa,CAAC;AAolC1E,eAAO,MAAM,YAAY,EAAE,OAqC1B,CAAC;AAoCF,eAAe,YAAY,CAAC"}