@zswarm/core 0.8.2 → 0.8.3

package/dist/schema.js

@@ -650,20 +650,31 @@ export const MCP_TOOL_DESCRIPTION = `zSwarm Zellij pane coordination (op=${OP_NA
     "Same host as Zellij, or ZSWARM_SSH / ZSWARM_SERVE for a remote crew.";
 const FLAG_INDEX = new Map(PARAMS.flatMap((p) => p.flags.map((flag) => [flag, p])));
 export function cliUsage() {
-    const lines = [
+    return [
         `usage: zswarm <${OP_NAMES.join("|")}> [options]`,
         "",
         "  positional: first bare argument is --to, second is --body for send",
         "",
-    ];
-    for (const param of PARAMS) {
-        if (param.flags.length === 0)
-            continue;
-        const value = param.type === "boolean" ? "" : param.type === "number" ? " N" : " VALUE";
-        lines.push(`  ${param.flags.join(", ").padEnd(28)}${value.trim().padEnd(6)}${param.description}`);
-    }
-    lines.push("", "Guards: writes refuse zswarm's own pane (--allow-self) and exited panes (--force). --expect requires the screen to contain a substring first.", "Bus: `zswarm bus --install` once per Zellij session. `--force` closes orphan bus panes and reloads; do not use it as a retry.", "Remote: ZSWARM_SSH (+ ZSWARM_TMP=auto or ZSWARM_SSH_MODE=interactive on Windows). Or run `zswarm serve --listen` next to Zellij and set ZSWARM_SERVE / --serve (host:port, tcp://, or ssh://user@host?servePort=9419) plus ZSWARM_SERVE_TOKEN. Serve defaults to loopback and always requires a token; an explicit local Tailscale IP is allowed only after host verification. Private raw TCP Tailscale Serve keeps the backend on 127.0.0.1 behind `tailscale serve --tcp=…` (docs/tailscale.md). ssh:// does not start remote serve. Windows default recipe: `zswarm serve --install` (verified readiness).", "Hosts (CLI only, see docs/hosts.md): `zswarm slot`, `zswarm crew`, `zswarm relay`, `zswarm host`, `zswarm gate`; `zswarm <command> --help` for each.", "Gate (docs/gate.md): a send-only ssh key. Receiver: `zswarm gate allow ID --key-file K --session S --pane P`. Sender: `zswarm send --gate DEST --session S --to P --body …`.", "Doctor: `zswarm doctor --session crew` inspects local, --ssh, and --serve routes without installs, pane changes, or plugin launch. See docs/doctor.md and docs/tailscale.md.", "Env: ZSWARM_BIN, ZSWARM_PATH, ZSWARM_SESSION, ZSWARM_SELF_PANE, ZSWARM_FROM, ZSWARM_HOST, ZELLIJ_PANE_ID, ZELLIJ_SESSION_NAME, ZSWARM_BUS, ZSWARM_BUS_PLUGIN, ZSWARM_SSH, ZSWARM_SSH_BIN, ZSWARM_SSH_OPTS, ZSWARM_TMP, ZSWARM_SSH_MODE, ZSWARM_GATE_CONFIG, ZSWARM_SERVE, ZSWARM_SERVE_TOKEN, ZSWARM_TAILSCALE_BIN, ZSWARM_CACHE_TTL_MS", "");
-    return lines.join("\n");
+        "  --session, -s VALUE     Zellij session (or ZSWARM_SESSION / ZELLIJ_SESSION_NAME)",
+        "  --to, -t, --pane VALUE  target pane: id, terminal_3, or a unique title; broadcast takes a comma list",
+        "  --fresh                 bypass the short-lived session/pane/tab listing cache",
+        "  --local                 route this call to the local machine only",
+        "  --ssh VALUE             route this call over SSH to user@host or an alias",
+        "  --serve VALUE           existing serve endpoint: host:port, tcp://, or ssh://user@host",
+        "  --help, -h              this list; `zswarm <op> --help` shows that op's flags",
+        "",
+        "  examples:",
+        "  zswarm list",
+        "  zswarm send --session crew --to worker --body \"text\"",
+        "  zswarm wait --session crew --to worker --match \"RESULT\" --timeout-ms 900000",
+        "",
+        "Remote: ZSWARM_SSH (+ ZSWARM_TMP=auto or ZSWARM_SSH_MODE=interactive on Windows), or run `zswarm serve --listen` next to Zellij and set ZSWARM_SERVE / --serve plus ZSWARM_SERVE_TOKEN. Serve defaults to loopback and always requires a token; an explicit local Tailscale IP is allowed only after host verification. See docs/tailscale.md.",
+        "Guards: writes refuse zswarm's own pane (--allow-self) and exited panes (--force). --expect requires the screen to contain a substring first.",
+        "Bus: `zswarm bus --install` once per Zellij session; `--force` closes orphan bus panes and reloads, not a retry.",
+        "Hosts (CLI only, see docs/hosts.md): `zswarm slot`, `zswarm crew`, `zswarm relay`, `zswarm host`, `zswarm gate`; `zswarm <command> --help` for each. Gate: docs/gate.md. Doctor: docs/doctor.md.",
+        "Env: ZSWARM_SESSION, ZSWARM_SELF_PANE, ZSWARM_FROM, ZSWARM_HOST, ZSWARM_BUS, ZSWARM_SSH, ZSWARM_SSH_MODE, ZSWARM_SERVE, ZSWARM_SERVE_TOKEN, ZSWARM_CACHE_TTL_MS (full list in docs/hosts.md).",
+        "",
+    ].join("\n");
 }
 /**
  * True when argv asks for help: `--help` or `-h` as a flag of its own, not the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zswarm/core",
-  "version": "0.8.2",
+  "version": "0.8.3",
   "type": "module",
   "description": "zSwarm Zellij client and shared ops dispatch",
   "exports": {