@volter/supercode-teams 0.3.107 → 0.3.108

package/machine.mjs

@@ -498,6 +498,10 @@ export class TeamsMachine extends MachineCore {
     // Set by a service-run connector: how `machine.restart` ends this daemon so its service manager starts it again.
     this.restartHandler = null;
     this.launches = new Launches(this.p.launches);
+    // the panes' stable porthole hook and the machine's stable supercode brought up to this release's at start, under
+    // every pane already running
+    this.#portholeHook();
+    this.#stableSupercode();
     // Windows has no tmux: its panes live in the machine's pane server, a process of their own that outlives this
     // daemon (a restart or an upgrade never ends a pane), as tmux panes live in tmux's server.
     if (process.platform === 'win32' && !terminal.PaneServerHost) throw new Error('panes on Windows need a newer @volter/supercode-terminal (one with PaneServerHost)');
@@ -1774,6 +1778,49 @@ export class TeamsMachine extends MachineCore {
     }
   }
 
+  /**
+   * The porthole hook as a pane names it: one stable path in the machine's home, never this package's own. A pane keeps
+   * the NODE_OPTIONS it was launched with for as long as it runs, and `--require` of a missing file kills every node
+   * program in it; a path inside a Teams package goes missing when the daemon moves to another package and the old one
+   * is removed (yuerans, 2026-10-06: the daemon moved from ~/.local to /opt/homebrew, ~/.local's packages were
+   * removed, and every node program in the older panes, supercode itself among them, died with MODULE_NOT_FOUND). The
+   * package's hook is copied there whenever it differs (replaced whole, by rename), so every pane, old or new, runs
+   * the daemon's current hook; a home that cannot hold it falls back to the package's path.
+   */
+  /**
+   * The machine's stable supercode (`<SUPERCODE_HOME>/bin/supercode`, claude_relay.rs `stable_program_path`), pointed at
+   * this daemon's native once per daemon (`__stable-program`), for a command a pane records; this daemon's own
+   * supercode when its native has no such verb or the shim cannot be written.
+   */
+  #stableSupercode() {
+    if (this.stableSupercodePath !== undefined) return this.stableSupercodePath ?? this.supercodeBin;
+    this.stableSupercodePath = null;
+    try {
+      const answer = spawnSync(this.supercodeBin, ['__stable-program'], { env: this.env, encoding: 'utf8', timeout: 5000, stdio: ['ignore', 'pipe', 'ignore'] });
+      const path = answer.status === 0 ? answer.stdout.trim() : '';
+      if (path && isAbsolute(path) && existsSync(path)) this.stableSupercodePath = path;
+    } catch { /* this daemon's own supercode */ }
+    return this.stableSupercodePath ?? this.supercodeBin;
+  }
+
+  #portholeHook() {
+    if (this.portholeHookPath) return this.portholeHookPath;
+    const stable = join(supercodeHome(this.env), 'porthole-hook.cjs');
+    try {
+      const hook = readFileSync(PORTHOLE_HOOK);
+      let current = null;
+      try { current = readFileSync(stable); } catch { /* not there yet */ }
+      if (!current?.equals(hook)) {
+        mkdirSync(dirname(stable), { recursive: true });
+        const staged = `${stable}.${process.pid}.tmp`;
+        writeFileSync(staged, hook, { mode: 0o644 });
+        renameSync(staged, stable);
+      }
+      this.portholeHookPath = stable;
+    } catch { this.portholeHookPath = PORTHOLE_HOOK; }
+    return this.portholeHookPath;
+  }
+
   /**
    * The environment every launched pane carries: the porthole hook preloaded into
    * each node process the pane runs, the announce directory it writes into, and the pane's
@@ -1786,9 +1833,10 @@ export class TeamsMachine extends MachineCore {
     env.PATH ??= this.env.PATH;
     // Its CLI reads this machine's contexts and sockets, not whatever home that server started with.
     if (this.env.SUPERCODE_HOME) env.SUPERCODE_HOME ??= this.env.SUPERCODE_HOME;
-    const inherited = env.NODE_OPTIONS ?? this.env.NODE_OPTIONS ?? '';
+    // an inherited porthole preload (a daemon started from a pane, or an older daemon's path) is replaced, never stacked
+    const inherited = String(env.NODE_OPTIONS ?? this.env.NODE_OPTIONS ?? '').replace(/\s*--require[= ]("[^"]*porthole-hook\.cjs"|\S*porthole-hook\.cjs)/g, '');
     // Quoted: NODE_OPTIONS splits on spaces, and a home path may hold one (Windows user folders often do).
-    env.NODE_OPTIONS = `${inherited} --require ${JSON.stringify(PORTHOLE_HOOK)}`.trim();
+    env.NODE_OPTIONS = `${inherited} --require ${JSON.stringify(this.#portholeHook())}`.trim();
     env.SUPERCODE_TEAMS_PORTS_DIR = this.portsDir;
     env.SUPERCODE_TEAMS_PANE = contextKey;
     return env;
@@ -1841,7 +1889,8 @@ export class TeamsMachine extends MachineCore {
     if (initialInput) nativeInput({ binding, kind: params.kind, text: initialInput, startedAt: Date.now() });
     const claudeCommand = (next) => launchCommand(params.program, initialInput ? [...next, '--', initialInput] : next);
     const quote = (value) => `'${String(value).replaceAll("'", "'\\''")}'`;
-    const command = `env SUPERCODE_HOME=${quote(mailHome)} ${quote(this.supercodeBin)} message native-question-hook ${quote(binding)}`;
+    // the machine's stable supercode: the session outlives this daemon's install path (an upgrade or a move)
+    const command = `env SUPERCODE_HOME=${quote(mailHome)} ${quote(this.#stableSupercode())} message native-question-hook ${quote(binding)}`;
     const handler = { type: 'command', command, timeout: 3600 };
     if (params.kind === 'claude-code') {
       const hooks = { SessionStart: [{ hooks: [handler] }], PreToolUse: [{ matcher: 'AskUserQuestion', hooks: [handler] }], PostToolUse: [{ matcher: 'AskUserQuestion', hooks: [handler] }] };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/supercode-teams",
-  "version": "0.3.107",
+  "version": "0.3.108",
   "type": "module",
   "description": "A machine daemon serving this machine's doors, and a local or remote Teams server for shared session discovery, OpenTelemetry ingestion and access to enrolled machines.",
   "license": "MIT",