muuuuse 2.3.2 → 2.3.4

package/README.md

@@ -15,13 +15,16 @@ It does one job:
 The whole surface is:
 
 ```bash
+muuuuse
 muuuuse 1
 muuuuse 1 flow on
 muuuuse 1 flow off
 muuuuse 1 flow off continue 5
+muuuuse 1 flow on continue 3 5 6
 muuuuse 2
 muuuuse 2 flow off
 muuuuse 2 flow on continue 3
+muuuuse 2 flow on continue 3 5 6
 muuuuse 3
 muuuuse 3 flow on
 muuuuse 4
@@ -48,7 +51,7 @@ Now both shells are armed. `muuuuse 1` generates the session key, `muuuuse 2` si
 
 `flow on` means that seat relays commentary and final answers. `flow off` means that seat relays and accepts final answers only. Mixed calibration is allowed per seat.
 
-`continue <seat>` forwards that seat's relayed output into another armed seat without changing the signed odd/even pair law. This lets you build local loops like `1 -> 2 -> 3 -> 4 -> 1` while every adjacent pair still keeps its own session keypair.
+`continue <seat> [<seat> ...]` forwards that seat's relayed output into one or more additional armed seats without changing the signed odd/even pair law. This lets you build local loops like `1 -> 2 -> 3 -> 4 -> 1`, split chains like `2 -> 3` and `2 -> 5`, or wider local meshes while every adjacent pair still keeps its own session keypair.
 
 If you want Codex in one and Gemini in the other, start them inside the armed shells:
 
@@ -78,7 +81,7 @@ muuuuse stop
 
 - state lives under `~/.muuuuse`
 - only the signed armed pair can exchange relay events
-- `continue <seat>` is a separate local forwarding lane and can target any armed seat number
+- `continue <seat> [<seat> ...]` is a separate local forwarding lane and can target any armed seat numbers
 - supported relay detection is built for Codex, Claude, and Gemini
 
 ## Install

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "muuuuse",
-  "version": "2.3.2",
+  "version": "2.3.4",
   "description": "🔌Muuuuse arms regular terminals in isolated pairs and can continue relay output into any other armed seat.",
   "type": "commonjs",
   "bin": {

package/src/cli.js

@@ -56,9 +56,10 @@ async function main(argv = process.argv.slice(2)) {
 
   const seatId = normalizeSeatId(command);
   if (seatId) {
-    const { flowMode, continueSeatId } = parseSeatOptions(command, argv.slice(1));
+    const { flowMode, continueSeatId, continueSeatIds } = parseSeatOptions(command, argv.slice(1));
     const seat = new ArmedSeat({
       cwd: process.cwd(),
+      continueSeatIds,
       continueSeatId,
       flowMode,
       seatId,
@@ -83,8 +84,11 @@ function renderSeatStatus(seat) {
   if (seat.partnerLive) {
     bits.push("peer live");
   }
-  if (seat.continueSeatId) {
-    bits.push(`continue ${seat.continueSeatId}`);
+  const continueSeatIds = Array.isArray(seat.continueSeatIds)
+    ? seat.continueSeatIds
+    : (seat.continueSeatId ? [seat.continueSeatId] : []);
+  if (continueSeatIds.length > 0) {
+    bits.push(`continue ${continueSeatIds.join(",")}`);
   }
   if (seat.trust) {
     bits.push(`trust ${seat.trust}`);
@@ -105,12 +109,14 @@ function renderSeatStatus(seat) {
 
 function parseSeatOptions(command, args) {
   let flowMode = "off";
-  let continueSeatId = null;
+  const continueSeatIds = [];
+  let sawContinue = false;
+  let index = 0;
 
-  for (let index = 0; index < args.length;) {
+  while (index < args.length) {
     const token = String(args[index] || "").trim().toLowerCase();
 
-    if (token === "flow") {
+    if (token === "flow" && !sawContinue) {
       const flowToken = String(args[index + 1] || "").trim().toLowerCase();
       if (flowToken === "on" || flowToken === "off") {
         flowMode = flowToken;
@@ -121,10 +127,22 @@ function parseSeatOptions(command, args) {
     }
 
     if (token === "continue") {
-      const targetSeatId = normalizeSeatId(args[index + 1]);
-      if (targetSeatId) {
-        continueSeatId = targetSeatId;
-        index += 2;
+      sawContinue = true;
+      let consumedTargets = 0;
+      index += 1;
+
+      while (index < args.length) {
+        const targetSeatId = normalizeSeatId(args[index]);
+        if (!targetSeatId) {
+          break;
+        }
+
+        continueSeatIds.push(targetSeatId);
+        consumedTargets += 1;
+        index += 1;
+      }
+
+      if (consumedTargets > 0) {
         continue;
       }
       break;
@@ -133,27 +151,19 @@ function parseSeatOptions(command, args) {
     break;
   }
 
-  if (args.length === 0 || (flowMode || continueSeatId !== null) && consumedAllArgs(args, flowMode, continueSeatId)) {
-    return { flowMode, continueSeatId };
+  if (index === args.length) {
+    return {
+      flowMode,
+      continueSeatId: continueSeatIds[0] || null,
+      continueSeatIds,
+    };
   }
 
   throw new Error(
-    `\`muuuuse ${command}\` accepts no extra arguments, \`flow on\` / \`flow off\`, optional \`continue <seat>\`, or both in sequence. Run it directly in the terminal you want to arm.`
+    `\`muuuuse ${command}\` accepts no extra arguments, \`flow on\` / \`flow off\`, optional \`continue <seat> [<seat> ...]\`, or both in sequence. Run it directly in the terminal you want to arm.`
   );
 }
 
-function consumedAllArgs(args, flowMode, continueSeatId) {
-  const expected = [];
-  if (flowMode !== "off" || args.includes("flow")) {
-    expected.push("flow", flowMode);
-  }
-  if (continueSeatId !== null || args.includes("continue")) {
-    expected.push("continue", String(continueSeatId));
-  }
-  return expected.length === args.length &&
-    expected.every((value, index) => String(args[index]).trim().toLowerCase() === String(value).trim().toLowerCase());
-}
-
 module.exports = {
   main,
 };

package/src/runtime.js

@@ -56,6 +56,32 @@ const CHILD_ENV_DROP_KEYS = [
   "CODEX_THREAD_ID",
 ];
 
+function bestEffortEnableChildEcho(child) {
+  const ptsName = String(child?.ptsName || "").trim();
+  if (!ptsName || process.platform === "win32") {
+    return;
+  }
+
+  try {
+    execFileSync("stty", [
+      "-F",
+      ptsName,
+      "echo",
+      "icanon",
+      "isig",
+      "iexten",
+      "echoe",
+      "echok",
+      "echoke",
+      "echoctl",
+    ], {
+      stdio: "ignore",
+    });
+  } catch {
+    // Best effort only. The shell or child app may later change its own tty mode.
+  }
+}
+
 function normalizeFlowMode(flowMode) {
   return String(flowMode || "").trim().toLowerCase() === "on" ? "on" : "off";
 }
@@ -65,6 +91,36 @@ function normalizeContinueSeatId(value) {
   return seatId || null;
 }
 
+function normalizeContinueSeatIds(value) {
+  const values = Array.isArray(value) ? value : [value];
+  const seen = new Set();
+  const seatIds = [];
+
+  for (const entry of values) {
+    const seatId = normalizeContinueSeatId(entry);
+    if (!seatId || seen.has(seatId)) {
+      continue;
+    }
+
+    seen.add(seatId);
+    seatIds.push(seatId);
+  }
+
+  return seatIds;
+}
+
+function resolveContinueSeatConfig(continueSeatIds, continueSeatId) {
+  if (Array.isArray(continueSeatIds) && continueSeatIds.length > 0) {
+    return continueSeatIds;
+  }
+
+  if (continueSeatIds !== undefined && continueSeatIds !== null && !Array.isArray(continueSeatIds)) {
+    return continueSeatIds;
+  }
+
+  return continueSeatId;
+}
+
 function resolveShell() {
   const shell = String(process.env.SHELL || "").trim();
   return shell || "/bin/bash";
@@ -587,9 +643,12 @@ class ArmedSeat {
     this.partnerSeatId = getPartnerSeatId(options.seatId);
     this.anchorSeatId = isAnchorSeat(options.seatId) ? options.seatId : this.partnerSeatId;
     this.flowMode = normalizeFlowMode(options.flowMode);
-    this.continueSeatId = normalizeContinueSeatId(options.continueSeatId);
+    this.continueSeatIds = normalizeContinueSeatIds(
+      resolveContinueSeatConfig(options.continueSeatIds, options.continueSeatId)
+    );
+    this.continueSeatId = this.continueSeatIds[0] || null;
     this.cwd = normalizeWorkingPath(options.cwd);
-    if (this.continueSeatId === this.seatId) {
+    if (this.continueSeatIds.includes(this.seatId)) {
       throw new Error(`\`muuuuse ${this.seatId}\` cannot continue to itself.`);
     }
     this.sessionName = resolveSessionName(this.cwd, this.seatId);
@@ -665,6 +724,7 @@ class ArmedSeat {
       partnerSeatId: this.partnerSeatId,
       sessionName: this.sessionName,
       flowMode: this.flowMode,
+      continueSeatIds: this.continueSeatIds,
       continueSeatId: this.continueSeatId,
       cwd: this.cwd,
       pid: process.pid,
@@ -681,6 +741,7 @@ class ArmedSeat {
       partnerSeatId: this.partnerSeatId,
       sessionName: this.sessionName,
       flowMode: this.flowMode,
+      continueSeatIds: this.continueSeatIds,
       continueSeatId: this.continueSeatId,
       cwd: this.cwd,
       pid: process.pid,
@@ -874,6 +935,7 @@ class ArmedSeat {
       env: childEnv,
       name: childEnv.TERM,
     });
+    bestEffortEnableChildEcho(this.child);
 
     this.childPid = this.child.pid;
     this.writeMeta();
@@ -1026,18 +1088,19 @@ class ArmedSeat {
     return Number.isFinite(requestedAtMs) && requestedAtMs > this.startedAtMs;
   }
 
-  findContinuationTarget() {
-    if (!this.continueSeatId) {
+  findContinuationTarget(targetSeatId) {
+    const normalizedTargetSeatId = normalizeContinueSeatId(targetSeatId);
+    if (!normalizedTargetSeatId) {
       return null;
     }
 
     const candidates = listSessionNames()
       .map((sessionName) => {
-        if (!getSeatDirIfExists(sessionName, this.continueSeatId)) {
+        if (!getSeatDirIfExists(sessionName, normalizedTargetSeatId)) {
           return null;
         }
 
-        const seat = buildSeatReport(sessionName, this.continueSeatId);
+        const seat = buildSeatReport(sessionName, normalizedTargetSeatId);
         if (!seat || !matchesWorkingPath(seat.cwd, this.cwd)) {
           return null;
         }
@@ -1457,19 +1520,21 @@ class ArmedSeat {
   }
 
   forwardContinuation(signedEntry) {
-    if (!this.continueSeatId) {
+    if (this.continueSeatIds.length === 0) {
       return;
     }
 
-    const target = this.findContinuationTarget();
-    if (!target) {
-      this.log(`[${this.seatId}] continue ${this.continueSeatId} unavailable`);
-      return;
-    }
+    for (const continueSeatId of this.continueSeatIds) {
+      const target = this.findContinuationTarget(continueSeatId);
+      if (!target) {
+        this.log(`[${this.seatId}] continue ${continueSeatId} unavailable`);
+        continue;
+      }
 
-    const continuationEntry = buildContinuationEntry(this.sessionName, target.seatId, signedEntry);
-    appendJsonl(target.paths.continuePath, continuationEntry);
-    this.log(`[${this.seatId} => ${target.seatId}] ${previewText(continuationEntry.text)}`);
+      const continuationEntry = buildContinuationEntry(this.sessionName, target.seatId, signedEntry);
+      appendJsonl(target.paths.continuePath, continuationEntry);
+      this.log(`[${this.seatId} => ${target.seatId}] ${previewText(continuationEntry.text)}`);
+    }
   }
 
   async tick() {
@@ -1518,8 +1583,9 @@ class ArmedSeat {
     this.log(`${BRAND} seat ${this.seatId} armed for ${this.sessionName}.`);
     this.log("Use this shell normally. Codex, Claude, and Gemini relay automatically from their local session logs.");
     this.log(`Seat ${this.seatId} relay mode is flow ${this.flowMode}.`);
-    if (this.continueSeatId) {
-      this.log(`Seat ${this.seatId} continues to seat ${this.continueSeatId}.`);
+    if (this.continueSeatIds.length > 0) {
+      const targetLabel = this.continueSeatIds.length === 1 ? "seat" : "seats";
+      this.log(`Seat ${this.seatId} continues to ${targetLabel} ${this.continueSeatIds.join(", ")}.`);
     }
     if (isAnchorSeat(this.seatId)) {
       this.log(`Seat ${this.seatId} generated the session key and is waiting for seat ${this.partnerSeatId} to sign it.`);
@@ -1618,11 +1684,19 @@ function buildSeatReport(sessionName, seatId) {
     return null;
   }
 
+  const continueSeatIds = normalizeContinueSeatIds(
+    resolveContinueSeatConfig(
+      status?.continueSeatIds ?? meta?.continueSeatIds,
+      status?.continueSeatId ?? meta?.continueSeatId
+    )
+  );
+
   return {
     seatId,
     state: wrapperLive ? status?.state || "running" : "orphaned_child",
     flowMode: status?.flowMode || meta?.flowMode || "off",
-    continueSeatId: status?.continueSeatId || meta?.continueSeatId || null,
+    continueSeatId: continueSeatIds[0] || null,
+    continueSeatIds,
     wrapperPid,
     childPid,
     wrapperLive,

package/src/util.js

@@ -284,20 +284,27 @@ function usage() {
   return [
     `${BRAND} arms regular terminals in isolated odd/even pairs and relays assistant output between each pair.`,
     "",
-    "Usage:",
-    "  muuuuse 1",
-    "  muuuuse 1 flow on",
-    "  muuuuse 1 flow off",
-    "  muuuuse 1 flow on continue 3",
-    "  muuuuse 2",
-    "  muuuuse 2 flow on",
-    "  muuuuse 2 flow off",
-    "  muuuuse 2 flow on continue 3",
-    "  muuuuse 3",
-    "  muuuuse 4",
-    "  muuuuse 4 flow on continue 1",
-    "  muuuuse stop",
+    "Command List:",
+    "  muuuuse",
+    "    Show this command list.",
+    "",
+    "  muuuuse <seat>",
+    "    Arm a seat and keep its normal odd/even partner relay behavior.",
+    "",
+    "  muuuuse <seat> flow on",
+    "    Relay commentary and final answers into that armed shell.",
+    "",
+    "  muuuuse <seat> flow off",
+    "    Relay final answers only into that armed shell.",
+    "",
+    "  muuuuse <seat> flow on continue <seat> [<seat> ...]",
+    "    Fan that seat's relayed output into one or more additional armed seats.",
+    "",
     "  muuuuse status",
+    "    Show all armed seats, flow mode, pair trust, and continuation targets.",
+    "",
+    "  muuuuse stop",
+    "    Stop every armed seat in the current cwd.",
     "",
     "Flow:",
     "  1. Run `muuuuse 1` in terminal one.",
@@ -305,7 +312,7 @@ function usage() {
     "  3. The odd seat generates the session key and the matching even seat signs it automatically.",
     "  4. Additional pairs work the same way: `3/4`, `5/6`, `7/8`...",
     "  5. Optional: arm each seat with `flow on` or `flow off`.",
-    "  6. Optional: add `continue <seat>` to forward that seat's relayed output into another armed seat.",
+    "  6. Optional: add `continue <seat> [<seat> ...]` to forward that seat's relayed output into more armed seats.",
     "  7. Use those armed shells normally.",
     "  8. `flow off` sends final answers only. `flow on` keeps assistant commentary bouncing.",
     "  9. Run `muuuuse status` or `muuuuse stop` from any shell.",