seatmesh 1.2.5 → 1.3.0

package/dist/commands/todo-give.test.js

@@ -1,7 +1,10 @@
-import { describe, expect, it } from "vitest";
+import fs from "node:fs";
+import os from "node:os";
+import { afterEach, describe, expect, it } from "vitest";
 import { spawnSync } from "node:child_process";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
+import { runInit } from "../setup/init.js";
 const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../../..");
 const bin = path.join(repoRoot, "packages/cli/bin/seatmesh");
 describe("todo give help surface", () => {
@@ -11,10 +14,23 @@ describe("todo give help surface", () => {
         expect(r.stdout).toMatch(/todo give/);
         expect(r.stdout).toMatch(/shorthand/i);
     });
-    it("todo without args prints give-first usage", () => {
-        const r = spawnSync(bin, ["todo"], { encoding: "utf8", cwd: repoRoot });
-        expect(r.status).toBe(2);
-        expect(r.stderr).toMatch(/todo give/);
+    describe("inside a mesh workspace", () => {
+        // `todo` (unlike `help`) requires a real .sm/ workspace (the shim gates
+        // non-allowlisted commands on `in_mesh_context`) — use an isolated tmp
+        // workspace rather than the repo's own dogfooded .sm/, so this passes in
+        // a clean checkout (e.g. the docker test runner) too.
+        let tmp = "";
+        afterEach(() => {
+            if (tmp)
+                fs.rmSync(tmp, { recursive: true, force: true });
+        });
+        it("todo without args prints give-first usage", () => {
+            tmp = fs.mkdtempSync(path.join(os.tmpdir(), "sm-todo-"));
+            runInit({ workspace: tmp, name: "todo-test" });
+            const r = spawnSync(bin, ["todo"], { encoding: "utf8", cwd: tmp });
+            expect(r.status).toBe(2);
+            expect(r.stderr).toMatch(/todo give/);
+        });
     });
 });
 //# sourceMappingURL=todo-give.test.js.map

package/dist/commands/todo-give.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"todo-give.test.js","sourceRoot":"","sources":["../../src/commands/todo-give.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;AAC3F,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,2BAA2B,CAAC,CAAC;AAE7D,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;QAChF,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACtC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;QACxE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"todo-give.test.js","sourceRoot":"","sources":["../../src/commands/todo-give.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;AAC3F,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,2BAA2B,CAAC,CAAC;AAE7D,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;QAChF,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACtC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,wEAAwE;QACxE,uEAAuE;QACvE,yEAAyE;QACzE,sDAAsD;QACtD,IAAI,GAAG,GAAG,EAAE,CAAC;QAEb,SAAS,CAAC,GAAG,EAAE;YACb,IAAI,GAAG;gBAAE,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC;YACzD,OAAO,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;YAC/C,MAAM,CAAC,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;YACnE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACzB,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/main.js

@@ -1,23 +1,17 @@
 #!/usr/bin/env node
 import { spawnSync } from "node:child_process";
 import { findDotSmConfig } from "@seat-mesh/core";
-import { loadProfile, profilePaths, loadRoleIndex, renderRoleIndex, validateRoleIndex, runStackPassthrough, roleAllows, isCoordKind, isManagerKind, managerColumnIds, addBaseColumn, removeBaseColumn, listBaseColumns, chatRoomConfigForLoaded, clearAckEndedSync, resolveAckRedirectDefaults, } from "@seat-mesh/core";
+import { loadProfile, profilePaths, loadRoleIndex, renderRoleIndex, validateRoleIndex, runStackPassthrough, roleAllows, isCoordKind, isManagerKind, managerColumnIds, addBaseColumn, removeBaseColumn, listBaseColumns, chatRoomConfigForLoaded, clearAckEndedSync, resolveAckRedirectDefaults, expandTargetSpec, targetRangeOptsFromProfile, } from "@seat-mesh/core";
 import { snapshotConnectivity, formatStatus } from "@seat-mesh/connectivity";
-import { createRegistryForProfile } from "@seat-mesh/providers";
-import { printWhoami, whoamiJson, whoamiJsonWithValidate, validateWhoamiRoleIndex, printAgentCard, printAgentContext, printAgentContextAllRoles, runWhoami, roleKindFromWhoami, requireCoordRole, requireInboxLifecycleRole, assertAgentDispatch, printAgentUnauthorized, stripAgentFromArgv, AGENT_META, capturePaneSnapshot, listSessionPanes, sessionAttach, sessionUp, sessionDown, sessionStatus, sessionSync, tmuxHasSession, relayoutMeshSession, realignAllLayouts, reloadMesh, ensureMeshInbox, startMeshInbox, stopMeshInbox, restartMeshInbox, meshInboxEverConfigured, meshInboxPort, printMeshInboxStatus, waitForMeshInbox, printInboxMeta, tailInboxLog, listInboxInstances, parseInboxStatusFlags, inboxStatusArgv, listInbox, resolveInbox, secretaryLaunch, secretaryDispatch, secretaryCollect, secretaryMeshWatch, secretarySupervise, secretaryStatus, printMiniList, miniSpawn, miniPrompt, miniDone, miniSpawnAll, runMeshSmoke, printSmokeResults, launchSession, printLaunchResults, defaultHarnessTypeForSeat, enqueuePrompt, injectPromptDirect, printPeerVerify, runPeerVerify, runRemind, printRemindResults, runNight, runContinue, printContinueResults, runSlotAdvice, verifyMeshSession, printVerify, labelMeshSession, liveMeshSession, ensureBaseLayout, realignBaseLayout, applyMeshSessionBorders, runFlush, printFlushResults, runSwitch, runPaneResume, runSeatSwap, runSet, runTag, setPaneTitle, setPaneStatus, printSeatContexts, runAgentHub, runPeek, runPaneKind, runPaneMeta, runPpa, runToSlot, runToMini, runPeer, parseRemotePeerTarget, runRemotePeer, applyMeshState, saveMeshSession, saveMeshSessionDetailed, assertSaveAllowed, formatSaveSummary, submitPaneOp, clearPaneOpsQueue, printPaneOpsList, printRelayoutPlan, assertRelayoutSafe, buildFullColdStartBrief, enqueueColdStart, runSeatInit, applyAgentContractBundle, balanceLeadCommand, } from "@seat-mesh/tmux";
-import { parseAgentApplyArgs } from "@seat-mesh/core";
-import { buildChatCommands } from "./commands/chat-cli.js";
+import { createRegistryForProfile, loadDropInProviders } from "@seat-mesh/providers";
+import { printWhoami, whoamiJson, whoamiJsonWithValidate, validateWhoamiRoleIndex, printAgentCard, printAgentContext, printAgentContextAllRoles, runWhoami, roleKindFromWhoami, requireCoordRole, requireInboxLifecycleRole, assertAgentDispatch, printAgentUnauthorized, stripAgentFromArgv, AGENT_META, capturePaneSnapshot, listSessionPanes, sessionAttach, sessionUp, sessionDown, sessionStatus, sessionSync, tmuxHasSession, relayoutMeshSession, realignAllLayouts, scaleLayout, layoutReload, reloadMesh, ensureMeshInbox, startMeshInbox, stopMeshInbox, restartMeshInbox, meshInboxEverConfigured, meshInboxPort, printMeshInboxStatus, waitForMeshInbox, printInboxMeta, tailInboxLog, listInboxInstances, parseInboxStatusFlags, inboxStatusArgv, listInbox, resolveInbox, secretaryLaunch, secretaryDispatch, secretaryCollect, secretaryMeshWatch, secretarySupervise, secretaryStatus, printMiniList, miniSpawn, miniPrompt, miniDone, miniSpawnAll, runMeshSmoke, printSmokeResults, launchSession, printLaunchResults, defaultHarnessTypeForSeat, enqueuePrompt, injectPromptDirect, printPeerVerify, runPeerVerify, runRemind, printRemindResults, runNight, runContinue, printContinueResults, runSlotAdvice, verifyMeshSession, printVerify, labelMeshSession, liveMeshSession, ensureBaseLayout, realignBaseLayout, applyMeshSessionBorders, runFlush, printFlushResults, runSwitch, runSwitchFast, runPaneResume, runSeatSwap, runSet, runTag, setPaneTitle, setPaneStatus, printSeatContexts, runAgentHub, runPeek, runPaneKind, runPaneMeta, runPaneCapture, runPpa, runToSlot, runToMini, runPeer, parseRemotePeerTarget, runRemotePeer, applyMeshState, saveMeshSession, saveMeshSessionDetailed, assertSaveAllowed, formatSaveSummary, submitPaneOp, clearPaneOpsQueue, printPaneOpsList, printRelayoutPlan, assertRelayoutSafe, buildFullColdStartBrief, enqueueColdStart, runSeatInit, applyAgentContractBundle, balanceLeadCommand, kindsForLoaded, } from "@seat-mesh/tmux";
+import { parseAgentApplyArgs, lookupResolvedKind } from "@seat-mesh/core";
 import { buildCheckbackCommands } from "./commands/checkback-cli.js";
 import { buildTargetCommands } from "./commands/target-cli.js";
 import { buildAckCommands } from "./commands/ack-cli.js";
 import { resolvePeerEndedAckId, shouldAutoAckReply, } from "./commands/ack-reply.js";
 import { buildLimitCommands } from "./commands/limit-cli.js";
 import { buildRolesCommands } from "./commands/roles-cli.js";
-import { buildNotifyCommand } from "./commands/notify-cli.js";
-import { buildPreviewCommand } from "./commands/preview-cli.js";
-import { runMdsCommand } from "./commands/mds-cli.js";
-import { buildContractLockCommands } from "./commands/contract-lock-cli.js";
-import { buildRoomCommands } from "./commands/room-cli.js";
 import { runInit } from "./setup/init.js";
 import { runAgentContextInit } from "./setup/agent-context-init.js";
 import { printSessionCheck, printSessionRepair, runSessionCheck, runSessionRepair, } from "./setup/session-health.js";
@@ -62,8 +56,10 @@ Setup
 
 Put an agent on a pane
   help human          ← cheat sheet (aliases: put-agent | panes)
-  switch <target> <opencode|opencode-cpe|claude|agent|kiro|empty>
-  launch <target|all>
+  spawn <target> <opencode|opencode-cpe|claude|agent|kiro>   empty → CLI
+  switch <target> <…|empty>   replace live agent (or → shell)
+  kill|empty <target>         pane → plain terminal (+ save empty)
+  launch <target|all>         resume configured CLI
   kind <target>
 
 Work / status
@@ -73,7 +69,9 @@ Work / status
   report | verify | test | save|auto | inbox […] | labels
 
 Session shape
-  reload [--layout] | layout […] | realign | ops list|clear
+  rebuild|reload [--layout]   npm build + labels (not config→pane)
+  layout reload               re-grid + resume from mesh-agents.json
+  layout […] | realign | ops list|clear
 
 Agent panes use the gateway (not listed here by default):
   seatmesh agent …          · seatmesh agent help
@@ -104,6 +102,7 @@ Setup (run once per project, by a human)
   config check | config upgrade         validate yaml · how to bump CLI (npm i -g)
   web up|down|restart|status|open|url   operator hub :3190 (npx seatmesh web up)
   roles status|migrate [--to VER]|steps   locked role-pack up/down (1.1.x)
+  host up|down|status   opt-in single host-supervisor for all registered meshes (Phase 1)
   version [--json] [--check-registry]   CLI vs npm latest vs profile .seatmesh-version
 
 Put an agent on a pane (human — most common)
@@ -284,6 +283,13 @@ async function main() {
         console.log(`  bin dir: ${r.binDir} (ensure it is on PATH)`);
         return;
     }
+    if (cmd === "host") {
+        const { runHostCommand } = await import("./commands/host-cli.js");
+        const code = runHostCommand([sub, ...tail].filter((a) => a != null));
+        if (code !== 0)
+            process.exit(code);
+        return;
+    }
     if (cmd === "update") {
         const { runUpdate } = await import("./setup/update.js");
         const { formatInstallStatusLine, isNpxEphemeralInstall, readInstalledCliVersion, resolveLatestRegistryVersion, semverLess, } = await import("./ui/version-nudge.js");
@@ -645,13 +651,13 @@ async function main() {
         const inboxOk = printMeshInboxStatus(loaded);
         process.exit(layoutOk && inboxOk ? 0 : 1);
     }
-    if (cmd === "reload") {
+    if (cmd === "reload" || cmd === "rebuild") {
         const loaded = meshLoaded(profileArg);
         const layout = rest.includes("--layout");
         reloadMesh(loaded, { layout });
         console.log(layout
-            ? `OK: reload + relayout session ${loaded.sessionName}`
-            : `OK: reload (build + labels) session ${loaded.sessionName}`);
+            ? `OK: rebuild + relayout session ${loaded.sessionName}`
+            : `OK: rebuild (npm build + labels) session ${loaded.sessionName} — not config→pane`);
         printMeshInboxStatus(loaded);
         return;
     }
@@ -668,6 +674,87 @@ async function main() {
         }
         return;
     }
+    if (cmd === "layout" && sub === "scale") {
+        const loaded = meshLoaded(profileArg);
+        const kindRaw = (tail[0] ?? "").toLowerCase();
+        const kind = kindRaw === "workers" || kindRaw === "worker" || kindRaw === "w"
+            ? "workers"
+            : kindRaw === "minis" || kindRaw === "mini" || kindRaw === "m"
+                ? "minis"
+                : null;
+        const action = (tail[1] ?? "").toLowerCase();
+        const force = rest.includes("--yes");
+        const dryRun = rest.includes("--dry-run");
+        if (!kind || !action) {
+            console.error("usage: layout scale workers|minis up|down|<N> [--yes] [--dry-run]");
+            process.exit(2);
+        }
+        requireCoordRole(loaded, "layout scale");
+        if (action !== "up" && action !== "down") {
+            const n = Number(action);
+            if (!Number.isInteger(n) || n < 1) {
+                console.error("usage: layout scale workers|minis up|down|<N> [--yes] [--dry-run]");
+                process.exit(2);
+            }
+        }
+        try {
+            const r = action === "up" || action === "down"
+                ? scaleLayout(loaded, {
+                    kind,
+                    dir: action,
+                    force,
+                    dryRun,
+                })
+                : scaleLayout(loaded, {
+                    kind,
+                    to: Number(action),
+                    force,
+                    dryRun,
+                });
+            if (r.dryRun) {
+                console.log(`dry-run: scale ${r.kind} ${r.from} → ${r.to} (${r.grid})`);
+                return;
+            }
+            if (r.from === r.to) {
+                console.log(`OK: scale ${r.kind} already ${r.to} (${r.grid})`);
+                return;
+            }
+            console.log(`OK: scale ${r.kind} ${r.from} → ${r.to} (${r.grid})${r.saved ? ` saved ${r.saved}` : ""}`);
+        }
+        catch (e) {
+            console.error(e.message);
+            process.exit(1);
+        }
+        return;
+    }
+    if (cmd === "layout" && sub === "reload") {
+        const loaded = meshLoaded(profileArg);
+        const force = rest.includes("--yes");
+        const skipLeads = rest.includes("--no-leads");
+        const noResume = rest.includes("--no-resume");
+        requireCoordRole(loaded, "layout reload");
+        try {
+            const r = layoutReload(loaded, {
+                force,
+                skipMinisLeads: skipLeads,
+                noResume,
+            });
+            const launched = r.repaired.filter((x) => x.status === "launched");
+            const failed = r.repaired.filter((x) => x.status === "failed");
+            console.log(`OK: layout reload ${loaded.sessionName} repaired=${launched.length}${r.saved ? ` saved ${r.saved}` : ""}`);
+            for (const x of launched) {
+                console.log(`  resume ${x.label} ${x.paneId}`);
+            }
+            for (const x of failed) {
+                console.warn(`  fail ${x.label}: ${x.reason ?? x.status}`);
+            }
+        }
+        catch (e) {
+            console.error(e.message);
+            process.exit(1);
+        }
+        return;
+    }
     if (cmd === "layout" && sub === "column") {
         const loaded = meshLoaded(profileArg);
         const action = tail[0];
@@ -739,7 +826,7 @@ async function main() {
             const leadNote = skipLeads || !m
                 ? ""
                 : ` leads=[${Array.isArray(m.leads) ? m.leads.join(",") : "1,2"}]`;
-            console.log(`OK: relayout ${loaded.sessionName} (workers 3x2, minis ${grid}${leadNote})`);
+            console.log(`OK: relayout ${loaded.sessionName} (workers ${loaded.profile.layout?.workers.grid ?? "?"}, minis ${grid}${leadNote})`);
             console.log(`OK: layout saved ${saved}`);
         });
         return;
@@ -962,15 +1049,52 @@ async function main() {
             printPeerVerify(r);
             process.exit(r.pass ? 0 : 1);
         }
-        const [target, ...textParts] = args;
+        const [targetRaw, ...textParts] = args;
         const rawMsg = textParts.join(" ").trim();
-        if (!target || !rawMsg) {
+        if (!targetRaw || !rawMsg) {
             console.error("usage: peer verify [target] | peer [--direct] [--ended|--ack [ack-id]] [--redirect-from <seat>] <target> <msg...>\n" +
+                "  target: seat | 1..4 | slot-1..3 | mini-1..2 | 1,3,5  (Ruby-style fanout)\n" +
                 "  --ack / --ended [id]  close open ask (id optional = auto-match from target)\n" +
                 "  ack-class msg (ACK/FYI/PASS) auto-closes matching open ask\n" +
                 "  or: agent ack reply <id> [msg]  (peer back + close in one shot)");
             process.exit(2);
         }
+        const peerTargets = expandTargetSpec(targetRaw, targetRangeOptsFromProfile(loaded.profile));
+        if (peerTargets.length > 1 && endedId) {
+            console.error("WARN: --ack/--ended ignored on range fanout (send-only)");
+            endedId = undefined;
+        }
+        const target = peerTargets[0];
+        if (peerTargets.length > 1) {
+            for (const t of peerTargets) {
+                try {
+                    runPeer(loaded, t, rawMsg);
+                }
+                catch (e) {
+                    if (e.message !== "__peer_coord__") {
+                        console.error(`FAIL peer ${t}: ${e.message}`);
+                        continue;
+                    }
+                    requireCoordRole(loaded, "peer");
+                    if (direct) {
+                        const reg = createRegistryForProfile(loaded.profile);
+                        injectPromptDirect(loaded, reg, t, rawMsg, { manager: true, force: true });
+                        console.log(`SENT: peer --direct -> ${t}`);
+                    }
+                    else {
+                        const { paneId, targetLabel, token, via } = enqueuePrompt(loaded, t, rawMsg, {
+                            manager: true,
+                            armCheckback: false,
+                        });
+                        console.log(via === "queued"
+                            ? `QUEUED: peer -> ${targetLabel} pane=${paneId} token=${token ?? "-"}`
+                            : `SENT: peer -> ${targetLabel} pane=${paneId}`);
+                    }
+                }
+            }
+            console.log(`ok fanout peer → ${peerTargets.join(",")} (${peerTargets.length})`);
+            return;
+        }
         if (shouldAutoAckReply(rawMsg, endedId)) {
             endedId = "__auto__";
         }
@@ -1180,6 +1304,13 @@ async function main() {
             secretaryLaunch(loaded);
             return;
         }
+        if (sub === "stop") {
+            const reg = createRegistryForProfile(loaded.profile);
+            runSwitch(loaded, reg, "secretary", "empty", { reason: "stop" });
+            saveMeshSession(loaded, reg);
+            console.log("OK: secretary stopped (pane -> empty shell)");
+            return;
+        }
         if (sub === "restart" || sub === "switch") {
             const reg = createRegistryForProfile(loaded.profile);
             const keepResume = rest.includes("--keep-resume") ||
@@ -1302,6 +1433,37 @@ async function main() {
         }
         return;
     }
+    if (cmd === "kind" && (sub === "list" || sub === "show")) {
+        const loaded = meshLoaded(profileArg);
+        const kinds = kindsForLoaded(loaded);
+        if (sub === "list") {
+            for (const id of Object.keys(kinds).sort()) {
+                const k = kinds[id];
+                const launch = k.launch === undefined
+                    ? "default"
+                    : k.launch === null
+                        ? "empty"
+                        : "builtin" in k.launch
+                            ? `builtin:${k.launch.builtin}`
+                            : `script:${k.launch.command}`;
+                const aliases = k.aliases?.length ? ` aliases=${k.aliases.join(",")}` : "";
+                console.log(`${id}\tprovider=${k.provider}\tlaunch=${launch}${aliases}`);
+            }
+            return;
+        }
+        const id = tail[0];
+        if (!id) {
+            console.error("usage: kind show <id>");
+            process.exit(2);
+        }
+        const found = lookupResolvedKind(kinds, id);
+        if (!found) {
+            console.error(`kind show: unknown kind "${id}" (see: seatmesh kind list)`);
+            process.exit(1);
+        }
+        console.log(JSON.stringify(found, null, 2));
+        return;
+    }
     if (cmd === "kind" || cmd === "what" || cmd === "typeof") {
         const loaded = meshLoaded(profileArg);
         const reg = createRegistryForProfile(loaded.profile);
@@ -1328,6 +1490,17 @@ async function main() {
         }
         return;
     }
+    if (cmd === "capture") {
+        const loaded = meshLoaded(profileArg);
+        try {
+            runPaneCapture(loaded, [sub, ...tail].filter((a) => Boolean(a)));
+        }
+        catch (e) {
+            console.error(e.message);
+            process.exit(1);
+        }
+        return;
+    }
     if (cmd === "pane") {
         const loaded = meshLoaded(profileArg);
         const reg = createRegistryForProfile(loaded.profile);
@@ -1476,12 +1649,16 @@ async function main() {
         const loaded = meshLoaded(profileArg);
         requireCoordRole(loaded, "launch");
         const rawArgs = [sub, ...tail].filter((a) => Boolean(a) && a !== "--");
-        const launchNow = rawArgs.includes("--now");
-        const targets = rawArgs.filter((a) => a !== "--now");
-        const label = targets.length ? targets.join(",") : "all";
+        const launchNow = rawArgs.includes("--now") || rawArgs.includes("--fast");
+        const targetsRaw = rawArgs.filter((a) => a !== "--now" && a !== "--fast");
+        const rangeOpts = targetRangeOptsFromProfile(loaded.profile);
+        const targets = targetsRaw.length
+            ? targetsRaw.flatMap((t) => expandTargetSpec(t, rangeOpts))
+            : undefined;
+        const label = targets?.length ? targets.join(",") : "all";
         const runLaunch = () => {
             const results = launchSession(loaded, {
-                targets: targets.length ? targets : undefined,
+                targets,
             });
             printLaunchResults(results);
             if (results.some((r) => r.status === "failed"))
@@ -1491,7 +1668,7 @@ async function main() {
             runLaunch();
             return;
         }
-        submitPaneOp(loaded, "launch", { targets: targets.length ? targets : undefined }, `launch ${label}`, runLaunch);
+        submitPaneOp(loaded, "launch", { targets }, `launch ${label}`, runLaunch);
         return;
     }
     if (cmd === "prompt") {
@@ -1615,17 +1792,43 @@ async function main() {
         printFlushResults(results);
         return;
     }
-    if (cmd === "switch" || cmd === "handoff") {
+    if (cmd === "kill" || cmd === "empty") {
         const loaded = meshLoaded(profileArg);
-        requireCoordRole(loaded, cmd);
-        const reg = createRegistryForProfile(loaded.profile);
+        requireCoordRole(loaded, "switch");
+        const targetRaw = sub;
+        if (!targetRaw) {
+            console.error(`usage: ${cmd} <target|1..4|slot-N|mini-N|here>`);
+            console.error("  → plain terminal (respawn-pane -k) + save empty in mesh-agents.json");
+            process.exit(2);
+        }
+        const targets = expandTargetSpec(targetRaw, targetRangeOptsFromProfile(loaded.profile));
+        for (const t of targets) {
+            runSwitchFast(loaded, t, "empty", {
+                fresh: true,
+                persistEmpty: true,
+                reason: cmd === "kill" ? "kill" : "empty",
+            });
+        }
+        if (targets.length > 1) {
+            console.log(`ok fanout ${cmd} → ${targets.join(",")} (${targets.length})`);
+        }
+        return;
+    }
+    if (cmd === "switch" || cmd === "handoff" || cmd === "spawn") {
+        const loaded = meshLoaded(profileArg);
+        requireCoordRole(loaded, cmd === "spawn" ? "switch" : cmd);
         const args = [sub, ...tail].filter(Boolean);
+        const vocal = cmd === "spawn" ? "spawn" : "switch";
+        // spawn defaults fast (paste like typing opencode); switch defaults thorough
+        let fast = cmd === "spawn";
         if (args.length < 2) {
-            console.error("usage: switch <target> <agent|cursor|claude|cc|kiro|oc|opencode|empty> [--keep-resume] [--resume ID] [--queue] [reason...]");
-            console.error("  targets: secretary|sec, manager|mgr, slot-N, mini-N, here|self (this pane's role)");
+            console.error(cmd === "spawn"
+                ? "usage: spawn <target|1..4> <agent|cursor|claude|oc|opencode> [--fast|--slow] [--keep-resume] [--resume ID]"
+                : "usage: switch <target|1..4> <agent|…|empty> [--fast|--slow] [--keep-resume] [--resume ID] [reason...]");
+            console.error("  empty→CLI: spawn (fast by default) · replace live: switch · --fast = skip verify waits");
             process.exit(2);
         }
-        const target = args[0];
+        const targetRaw = args[0];
         const newType = args[1];
         let fresh;
         let queue = false;
@@ -1637,6 +1840,10 @@ async function main() {
                 fresh = true;
             else if (a === "--keep-resume" || a === "--no-fresh")
                 fresh = false;
+            else if (a === "--fast")
+                fast = true;
+            else if (a === "--slow" || a === "--verify")
+                fast = false;
             else if (a === "--queue")
                 queue = true;
             else if (a === "--resume" && args[i + 1])
@@ -1647,17 +1854,29 @@ async function main() {
                 reasonParts.push(a);
         }
         const reason = reasonParts.join(" ") || undefined;
-        const run = () => runSwitch(loaded, reg, target, newType, {
+        const targets = expandTargetSpec(targetRaw, targetRangeOptsFromProfile(loaded.profile));
+        // Fast path skips provider registry build (expensive).
+        const reg = fast ? null : createRegistryForProfile(loaded.profile);
+        const runOne = (target) => runSwitch(loaded, reg, target, newType, {
             fresh,
             resumeId,
             reason,
+            fast,
         });
+        const run = () => {
+            for (const t of targets)
+                runOne(t);
+            if (targets.length > 1) {
+                console.log(`ok fanout ${vocal} → ${targets.join(",")} (${targets.length})`);
+            }
+        };
         if (queue) {
-            submitPaneOp(loaded, "switch", { target, newType, fresh, resumeId, reason }, `switch ${target} -> ${newType}`, run);
+            submitPaneOp(loaded, "switch", { target: targetRaw, newType, fresh, resumeId, reason, fast }, `${vocal} ${targetRaw} -> ${newType}${fast ? " [fast]" : ""}`, run);
         }
         else {
             run();
-            saveMeshSession(loaded, reg);
+            if (!fast && reg)
+                saveMeshSession(loaded, reg);
         }
         return;
     }
@@ -1777,7 +1996,8 @@ async function main() {
         }
         if (sub && AGENT_META.has(sub)) {
             if (sub === "forum" || sub === "golf") {
-                console.log("agent forum/golf — see docs/cli/forum.md (not bundled in this build)");
+                const { printAgentForum } = await import("./commands/agent-forum.js");
+                printAgentForum();
                 return;
             }
             if (sub === "apply") {
@@ -1983,6 +2203,10 @@ async function main() {
     if (cmd === "providers") {
         const loaded = meshLoaded(profileArg);
         const reg = createRegistryForProfile(loaded.profile);
+        const path = await import("node:path");
+        const dropIn = await loadDropInProviders(path.join(loaded.profileDir, "providers"), (line) => console.error(line));
+        for (const p of dropIn.providers)
+            reg.register(p);
         if (sub === "list") {
             for (const p of reg.all())
                 console.log(p.id);
@@ -2047,10 +2271,10 @@ async function main() {
         const loaded = meshLoaded(profileArg);
         const getLoaded = () => loaded;
         const branch = cmd === "room"
-            ? buildRoomCommands(getLoaded)
+            ? (await import("./commands/room-cli.js")).buildRoomCommands(getLoaded)
             : cmd === "contract"
-                ? buildContractLockCommands(getLoaded)
-                : buildChatCommands(getLoaded);
+                ? (await import("./commands/contract-lock-cli.js")).buildContractLockCommands(getLoaded)
+                : (await import("./commands/chat-cli.js")).buildChatCommands(getLoaded);
         // contract with no sub → status (simple agent path)
         if (!sub && cmd === "contract") {
             try {
@@ -2174,7 +2398,7 @@ async function main() {
     if (cmd === "notify") {
         const loaded = meshLoaded(profileArg);
         const getLoaded = () => loaded;
-        const branch = buildNotifyCommand(getLoaded);
+        const branch = (await import("./commands/notify-cli.js")).buildNotifyCommand(getLoaded);
         try {
             await branch.parseAsync(rest.slice(1), { from: "user" });
         }
@@ -2188,12 +2412,66 @@ async function main() {
     }
     if (cmd === "mds") {
         const loaded = meshLoaded(profileArg);
+        const { runMdsCommand } = await import("./commands/mds-cli.js");
         process.exit(await runMdsCommand(loaded, rest.slice(1)));
     }
     if (cmd === "preview") {
         const loaded = meshLoaded(profileArg);
         const getLoaded = () => loaded;
-        const branch = buildPreviewCommand(getLoaded);
+        const branch = (await import("./commands/preview-cli.js")).buildPreviewCommand(getLoaded);
+        try {
+            await branch.parseAsync(rest.slice(1), { from: "user" });
+        }
+        catch (e) {
+            const err = e;
+            if (err.code === "commander.helpDisplayed" || err.code === "commander.version")
+                return;
+            throw e;
+        }
+        return;
+    }
+    if (cmd === "nav") {
+        const loaded = meshLoaded(profileArg);
+        const getLoaded = () => loaded;
+        const branch = (await import("./commands/nav-cli.js")).buildNavCommands(getLoaded);
+        if (!sub) {
+            branch.outputHelp();
+            return;
+        }
+        try {
+            await branch.parseAsync([sub, ...tail], { from: "user" });
+        }
+        catch (e) {
+            const err = e;
+            if (err.code === "commander.helpDisplayed" || err.code === "commander.version")
+                return;
+            throw e;
+        }
+        return;
+    }
+    if (cmd === "campaign") {
+        const loaded = meshLoaded(profileArg);
+        const getLoaded = () => loaded;
+        const branch = (await import("./commands/campaign-cli.js")).buildCampaignCommands(getLoaded);
+        if (!sub) {
+            branch.outputHelp();
+            return;
+        }
+        try {
+            await branch.parseAsync([sub, ...tail], { from: "user" });
+        }
+        catch (e) {
+            const err = e;
+            if (err.code === "commander.helpDisplayed" || err.code === "commander.version")
+                return;
+            throw e;
+        }
+        return;
+    }
+    if (cmd === "schedule") {
+        const loaded = meshLoaded(profileArg);
+        const getLoaded = () => loaded;
+        const branch = (await import("./commands/schedule-cli.js")).buildScheduleCommand(getLoaded);
         try {
             await branch.parseAsync(rest.slice(1), { from: "user" });
         }