@zswarm/core 0.1.0 → 0.1.1

package/dist/ops/bus.d.ts

@@ -23,6 +23,7 @@ export declare function planBus(client: ZellijClient, state: StateStore, env?: N
  * message and replies with nothing, so each attempt rotates to a new key. And a
  * freshly launched instance replies before Zellij has pushed it a manifest, so
  * a not-ready answer is retried once rather than reported as an empty session.
+ * If it is still cold after that, one same-title rename nudges Zellij to push.
  */
 export declare function busSnapshot(client: ZellijClient, state: StateStore, session: string, clock: Clock, env?: NodeJS.ProcessEnv, payload?: string): Promise<{
     snapshot: BusSnapshot;

package/dist/ops/bus.js

@@ -53,7 +53,7 @@ export function planBus(client, state, env = process.env) {
     if (!plugin) {
         return {
             ...base,
-            reason: "no plugin wasm found; build plugin/zswarm-events or set ZSWARM_BUS_PLUGIN",
+            reason: "no plugin wasm found; run pnpm build:plugin or set ZSWARM_BUS_PLUGIN",
         };
     }
     if (processDisabled)
@@ -69,6 +69,19 @@ async function askOnce(client, session, url, configKey, payload) {
     const result = await client.pipePlugin({ session, url, configKey, payload });
     return parseBusReply(result.stdout);
 }
+/**
+ * Zellij pushes a pane manifest on change, never on subscribe — there is no
+ * get_pane_manifest(). A quiet session leaves a freshly launched instance
+ * blind (ready:false, paneUpdates:0) until something moves. Renaming a pane
+ * to the title it already has is an invisible change that forces the push.
+ */
+async function nudgeManifest(client, session) {
+    const panes = await client.listPanes(session);
+    const pane = panes.find((p) => !p.isPlugin && !p.exited && p.title.trim());
+    if (!pane)
+        return;
+    await client.renamePane({ session, paneId: pane.id, name: pane.title });
+}
 /**
  * One pipe, one answer — or null, and the caller polls instead.
  *
@@ -76,6 +89,7 @@ async function askOnce(client, session, url, configKey, payload) {
  * message and replies with nothing, so each attempt rotates to a new key. And a
  * freshly launched instance replies before Zellij has pushed it a manifest, so
  * a not-ready answer is retried once rather than reported as an empty session.
+ * If it is still cold after that, one same-title rename nudges Zellij to push.
  */
 export async function busSnapshot(client, state, session, clock, env = process.env, payload = "status") {
     const plan = planBus(client, state, env);
@@ -83,6 +97,7 @@ export async function busSnapshot(client, state, session, clock, env = process.e
     if (!plan.enabled || !plan.url || !pluginPath)
         return null;
     let configKey = answeredWith.get(session) ?? plan.configKey;
+    let nudged = false;
     for (let attempt = 0; attempt < MAX_KEY_ATTEMPTS; attempt++) {
         let snapshot = await askOnce(client, session, plan.url, configKey, payload);
         if (snapshot && !snapshot.ready) {
@@ -91,6 +106,18 @@ export async function busSnapshot(client, state, session, clock, env = process.e
                 (await askOnce(client, session, plan.url, configKey, payload)) ??
                     snapshot;
         }
+        if (snapshot && !snapshot.ready && !nudged) {
+            nudged = true;
+            try {
+                await nudgeManifest(client, session);
+                snapshot =
+                    (await askOnce(client, session, plan.url, configKey, payload)) ??
+                        snapshot;
+            }
+            catch {
+                // A failed nudge must not fail the op — the caller polls instead.
+            }
+        }
         if (snapshot) {
             answeredWith.set(session, configKey);
             if (plan.installed && configKey !== plan.configKey) {
@@ -205,7 +232,7 @@ export async function busOp(client, state, args, clock, env = process.env, polic
         }
         const plugin = resolveBusPlugin(env);
         if (!plugin) {
-            throw new ZellijError("bus_missing", "no plugin wasm found; build plugin/zswarm-events or set ZSWARM_BUS_PLUGIN");
+            throw new ZellijError("bus_missing", "no plugin wasm found; run pnpm build:plugin or set ZSWARM_BUS_PLUGIN");
         }
         const previous = state.readBus();
         const force = isTrue(args.force);

package/dist/schema.d.ts

@@ -22,5 +22,4 @@ export declare const PARAMS: readonly ParamSpec[];
 export declare function mcpInputSchema(): Record<string, unknown>;
 export declare const MCP_TOOL_DESCRIPTION: string;
 export declare function cliUsage(): string;
-/** Turn argv (without the op) into dispatch args, driven by PARAMS. */
 export declare function parseCliArgv(argv: string[]): Record<string, unknown>;

package/dist/schema.js

@@ -443,8 +443,27 @@ export function cliUsage() {
     return lines.join("\n");
 }
 /** Turn argv (without the op) into dispatch args, driven by PARAMS. */
+/**
+ * Pull the op out of argv, tolerating flags before it.
+ *
+ * The op normally comes first. When it does not — `zswarm --session crew list`
+ * — the first token is a flag, and taking argv[0] blindly reported the flag as
+ * an unknown op. Only positions that already errored are affected: if argv[0]
+ * is a real op it wins, so `send reviewer list` still sends the word "list".
+ */
+function extractOp(argv) {
+    const first = argv[0];
+    if (first && !first.startsWith("-")) {
+        return { op: first, rest: argv.slice(1) };
+    }
+    const names = OP_NAMES;
+    const at = argv.findIndex((token) => names.includes(token));
+    if (at === -1)
+        return { op: first ?? "", rest: argv.slice(1) };
+    return { op: argv[at], rest: [...argv.slice(0, at), ...argv.slice(at + 1)] };
+}
 export function parseCliArgv(argv) {
-    const [op, ...rest] = argv;
+    const { op, rest } = extractOp(argv);
     if (!op)
         throw new ZellijError("usage", "no op given");
     const out = { op };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zswarm/core",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "description": "zSwarm Zellij client and shared ops dispatch",
   "exports": {
@@ -29,6 +29,6 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "test": "pnpm run build && node --test tests/*.test.mjs"
+    "test": "pnpm run build && node --test"
   }
 }