aicodeman 1.43.0 → 1.45.0

package/dist/tmux-prefix-table.js

@@ -0,0 +1,172 @@
+/**
+ * @fileoverview Keep tmux's prefix table on Codeman's socket down to `send-prefix`.
+ *
+ * Codeman drives tmux through commands, never through key bindings, but every
+ * keystroke typed into a browser terminal reaches the `tmux attach-session`
+ * client behind it. With tmux's stock prefix table that client obeys the whole
+ * menu: Ctrl+B then `(`, `)`, `L`, `s` or `w` runs `switch-client` /
+ * `choose-tree` and re-attaches the tab's client to a DIFFERENT session, so the
+ * tab shows, and types into, another session's agent while Codeman still labels
+ * it as the original. Ctrl+B `d` detaches the client, `$` renames the session
+ * under Codeman's feet, `:` opens tmux's command prompt. Ctrl+B is not a rare
+ * key in a terminal (readline backward-char, Claude Code's background chord),
+ * and whatever is typed next lands in that menu.
+ *
+ * The prefix itself stays: Claude Code running inside tmux asks for
+ * "ctrl+b ctrl+b" to background a command, which only works through
+ * `send-prefix`. So the table keeps exactly that one binding, on whatever key
+ * the socket's prefix is (the socket reads the user's `~/.tmux.conf`).
+ *
+ * `codeman tui` shares the socket (src/tui/tui-app.ts, beginAttachHandoff). For
+ * the length of an attach it claims a held-Ctrl detach alias (`C-d`) in the
+ * prefix table, and its one-key way out (F1) and Alt+1..9 in the `root` table.
+ * `root` is never touched here, and a `C-<letter> detach-client` binding is left
+ * alone (and put back when a reset clears the rest of the table around it), so
+ * creating a session while a TUI attach is open does not take the attach's way
+ * out away. The reset only runs while the table holds anything else, i.e. once
+ * per tmux server in practice.
+ *
+ * That tolerance is server-wide like every key table: while such an alias is
+ * bound, a browser tab's client can detach itself with it too. F1 in `root`
+ * is the same kind of way out. Alt+1..9 are not: `codeman tui` binds those
+ * through `if-shell -F` so `switch-client` runs only for the TUI's own client
+ * (see `bindSwitchKey` in src/tui/tui-client.ts). This file still does not
+ * touch `root`.
+ *
+ * Docker cases and owned remote sessions run a second tmux (`-L codeman-docker`,
+ * `-L codeman-remote`) with `prefix C-q`. That server is not this socket, so
+ * the reset above never sees it, and its stock prefix table still switches
+ * the inner client. `nestedPrefixTableResetCommands` is the same reduction,
+ * appended to those create chains. A non-owned remote attach joins another
+ * Codeman's `-L codeman` and must not run it.
+ *
+ * @module tmux-prefix-table
+ */
+import { execSync } from 'node:child_process';
+import { EXEC_TIMEOUT_MS } from './config/exec-timeout.js';
+import { shellescape } from './remote-hosts.js';
+/** tmux's stock prefix, used when `show-options` cannot be read. */
+const DEFAULT_PREFIX = 'C-b';
+/**
+ * Prefix on the dedicated tmux inside a Docker case and an owned remote
+ * session. Codeman's own socket keeps the user's prefix; these nested servers
+ * always use C-q so it does not collide with the outer prefix.
+ */
+export const NESTED_TMUX_PREFIX = 'C-q';
+/**
+ * Commands that reduce a nested tmux's prefix table to `C-q send-prefix`.
+ *
+ * Joined with `\;` onto the `new-session` that creates the server
+ * (`buildRemoteLaunchCommand`, `buildDockerLaunchCommand`). No `tmux` binary
+ * and no `-g`: the table is server-global, which is what we want on these
+ * dedicated sockets and nowhere else.
+ *
+ * Those servers load the user's tmux config (no `-f /dev/null`). A config that
+ * leaves the prefix table empty makes `unbind-key -a -T prefix` fail with
+ * "table prefix doesn't exist", and tmux then drops every later command in the
+ * `\;` chain, including the bind and `remain-on-exit failed` (#210). The same
+ * empty table is what #669 handled on the local socket. Binding `send-prefix`
+ * first creates the table so the unbind can run; the unbind clears stock
+ * bindings (and that first bind); the second bind puts `send-prefix` back.
+ * Put them BEFORE `remain-on-exit failed` so a remote tmux that rejects
+ * `failed` does not drop the reduction.
+ */
+export function nestedPrefixTableResetCommands() {
+    const sendPrefix = `bind-key -T prefix ${NESTED_TMUX_PREFIX} send-prefix`;
+    return [sendPrefix, 'unbind-key -a -T prefix', sendPrefix];
+}
+/** One `list-keys -T prefix` line: key and command. */
+const PREFIX_LINE = /^bind-key\s+(?:-\S+\s+)*?-T\s+prefix\s+(\S+)\s+(.+)$/;
+/** The held-Ctrl detach alias `codeman tui` claims during an attach (heldCtrlAlias). */
+const TUI_DETACH_ALIAS = /^C-[a-z]$/;
+/**
+ * A key as `list-keys` prints it, without tmux's backslash escaping: `show-options`
+ * prints the prefix `C-\` as is, while the listing shows `C-\\` (and `\#`, `\$`, `\"`).
+ */
+function unescapeListedKey(key) {
+    return key.replace(/\\(.)/g, '$1');
+}
+/**
+ * Whether the prefix table (as printed by `tmux list-keys -T prefix`) still holds
+ * a binding other than `<prefix> send-prefix` or a TUI detach alias, or lacks
+ * `<prefix> send-prefix`. Unparseable output counts as "needs a reset":
+ * resetting is idempotent, skipping one leaves `switch-client` reachable from
+ * the browser. A prefix of `None` expects no `send-prefix` binding at all.
+ */
+export function prefixTableNeedsReset(listKeysOutput, prefix = DEFAULT_PREFIX) {
+    let hasSendPrefix = false;
+    for (const raw of listKeysOutput.split('\n')) {
+        const line = raw.trim();
+        if (!line)
+            continue;
+        const match = PREFIX_LINE.exec(line);
+        if (!match)
+            return true;
+        const key = unescapeListedKey(match[1]);
+        const command = match[2].trim();
+        if (command === 'send-prefix' && key === prefix) {
+            hasSendPrefix = true;
+            continue;
+        }
+        if (command === 'detach-client' && TUI_DETACH_ALIAS.test(key) && key !== prefix)
+            continue;
+        return true;
+    }
+    return prefix === 'None' ? false : !hasSendPrefix;
+}
+/** The `C-<letter> detach-client` bindings in a `list-keys -T prefix` listing (see prefixTableNeedsReset). */
+function tuiDetachAliases(listKeysOutput, prefix) {
+    const keys = [];
+    for (const raw of listKeysOutput.split('\n')) {
+        const match = PREFIX_LINE.exec(raw.trim());
+        if (!match)
+            continue;
+        const key = unescapeListedKey(match[1]);
+        if (match[2].trim() === 'detach-client' && TUI_DETACH_ALIAS.test(key) && key !== prefix)
+            keys.push(key);
+    }
+    return keys;
+}
+const defaultRunner = (command) => execSync(command, { encoding: 'utf8', timeout: EXEC_TIMEOUT_MS, stdio: ['ignore', 'pipe', 'ignore'] });
+/**
+ * Reduce the prefix table of the tmux server behind `tmux` (e.g. `tmux -L 'codeman'`)
+ * to `<prefix> send-prefix`, when it holds anything more. Never throws: a failure
+ * only leaves tmux's stock bindings in place. Returns whether a reset ran.
+ */
+export function restrictTmuxPrefixTable(tmux, run = defaultRunner) {
+    let prefix = DEFAULT_PREFIX;
+    try {
+        prefix = run(`${tmux} show-options -gv prefix`).trim() || DEFAULT_PREFIX;
+    }
+    catch {
+        /* keep tmux's stock prefix */
+    }
+    let listing;
+    try {
+        listing = run(`${tmux} list-keys -T prefix`);
+    }
+    catch {
+        listing = null; // an empty table makes list-keys fail on some tmux builds
+    }
+    if (listing !== null && !prefixTableNeedsReset(listing, prefix))
+        return false;
+    try {
+        run(`${tmux} unbind-key -a -T prefix`);
+    }
+    catch {
+        /* an empty table makes unbind-key -a fail too ("table prefix doesn't exist"); nothing to clear */
+    }
+    try {
+        if (prefix !== 'None')
+            run(`${tmux} bind-key -T prefix ${shellescape(prefix)} send-prefix`);
+        // `unbind-key -a` also took a running TUI attach's held-Ctrl way out; give it back.
+        for (const key of tuiDetachAliases(listing ?? '', prefix)) {
+            run(`${tmux} bind-key -T prefix ${shellescape(key)} detach-client`);
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=tmux-prefix-table.js.map

package/dist/tmux-prefix-table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmux-prefix-table.js","sourceRoot":"","sources":["../src/tmux-prefix-table.ts"],"names":[],"mappings":"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"}

package/dist/tui/tui-app.d.ts

@@ -135,6 +135,14 @@ export declare function heldCtrlAlias(key: string): string | null;
  * through `formatPrefixKey`, which uppercases.
  */
 export declare function detachChord(prefix?: string, key?: string): string;
+/**
+ * The chord an attach advertises when it could not claim the one-key way out.
+ *
+ * With no key bound to `detach-client` in the prefix table there is no stock
+ * `d` to name: Codeman keeps only `send-prefix` there (src/tmux-prefix-table.ts),
+ * so the held-Ctrl alias the attach claimed is the chord that works.
+ */
+export declare function fallbackDetachChord(prefix?: string, detachKey?: string, heldAlias?: string): string;
 /**
  * The status line an attached session wears, as tmux option → value.
  *
@@ -231,7 +239,14 @@ export interface TuiAttachHandoff {
  * `window-size manual` with no status bar (what Codeman creates) is exactly
  * that again after the detach.
  */
-export declare function beginAttachHandoff(client: TuiClient, muxName: string, label: string, tabs?: readonly TuiAttachTab[], cols?: number, rows?: number): Promise<TuiAttachHandoff>;
+export declare function beginAttachHandoff(client: TuiClient, muxName: string, label: string, tabs?: readonly TuiAttachTab[], cols?: number, rows?: number, 
+/**
+ * Tty the attach client will inherit. Omit to read this process's terminal.
+ * `null` means there is no usable tty: switch keys are not bound (an unscoped
+ * `switch-client` would move every client on the socket, including a browser
+ * tab). Tests pass a tty so they do not depend on stdin.
+ */
+clientTty?: string | null): Promise<TuiAttachHandoff>;
 /**
  * Is this the session the TUI itself runs in? Codeman exports
  * `CODEMAN_SESSION_ID` into every managed pane, and killing that one would take
@@ -273,7 +288,7 @@ export interface TuiKeymapContext {
     /** False in degraded mode, where the only verb that works is attach. */
     server: boolean;
     approval?: TuiApprovalKeys;
-    /** tmux's detach chord as this socket reports it. Defaults to the stock `Ctrl+B D`. */
+    /** How the last attach said to leave it. Defaults to F1, the key an attach claims. */
     detach?: string;
     /** A dead-row card is offering `r` to resume, so the footer has to say so. */
     resumeOffer?: boolean;

package/dist/tui/tui-app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tui-app.d.ts","sourceRoot":"","sources":["../../src/tui/tui-app.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tui-app.d.ts","sourceRoot":"","sources":["../../src/tui/tui-app.ts"],"names":[],"mappings":"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"}

package/dist/tui/tui-app.js

@@ -53,7 +53,7 @@ import { dropSeveredEscape, foldPreviewGlyphs, toDisplayLines } from './tui-ansi
 import { approvalAnswerForKey, newApprovalIds } from './tui-approvals.js';
 import { composerScroll, composerStep, composerText, createComposer } from './tui-composer.js';
 import { formatAwayDigest } from './tui-digest.js';
-import { ATTACH_BANNER_MARKER, TuiClient, } from './tui-client.js';
+import { ATTACH_BANNER_MARKER, isTuiClientTty, readControllingTty, TuiClient, } from './tui-client.js';
 import { createKeyParser } from './tui-keys.js';
 import { computeLayout, needsBanner } from './tui-layout.js';
 import { buildSearchEntries, createTuiModel, firstSearchIndex, moveSearchIndex, } from './tui-model.js';
@@ -249,6 +249,18 @@ export function heldCtrlAlias(key) {
 export function detachChord(prefix, key) {
     return `${formatPrefixKey(prefix)} then ${key || DEFAULT_DETACH_KEY}`;
 }
+/**
+ * The chord an attach advertises when it could not claim the one-key way out.
+ *
+ * With no key bound to `detach-client` in the prefix table there is no stock
+ * `d` to name: Codeman keeps only `send-prefix` there (src/tmux-prefix-table.ts),
+ * so the held-Ctrl alias the attach claimed is the chord that works.
+ */
+export function fallbackDetachChord(prefix, detachKey, heldAlias) {
+    if (!detachKey && heldAlias)
+        return detachChord(prefix, formatPrefixKey(heldAlias));
+    return detachChord(prefix, detachKey);
+}
 /** `#` opens `#[…]`/`#{…}` in a tmux format, so a name carrying one must double it. */
 function escapeTmuxFormat(value) {
     return value.replace(/#/g, '##');
@@ -272,10 +284,10 @@ function escapeTmuxFormat(value) {
  * and the chord alone carries emphasis.
  */
 export function buildAttachBanner(options) {
-    const chord = escapeTmuxFormat(detachChord(options.prefix, options.detachKey));
+    const chord = escapeTmuxFormat(fallbackDetachChord(options.prefix, options.detachKey, options.heldAlias));
     // Named on the bar because it is what people actually type: keeping Ctrl held
     // is the common way to press this, and the bar has to say that it works.
-    const held = options.heldAlias ? escapeTmuxFormat(formatPrefixKey(options.heldAlias)) : '';
+    const held = options.heldAlias && options.detachKey ? escapeTmuxFormat(formatPrefixKey(options.heldAlias)) : '';
     const alias = held ? ` (or ${held})` : '';
     const label = escapeTmuxFormat(truncateLabel((options.label ?? '').trim(), ATTACH_BANNER_LABEL_MAX));
     // ONE option, not `status-left`/`status-right`/`status-style`: `status-format[0]`
@@ -411,7 +423,14 @@ export function planResume(session) {
  * `window-size manual` with no status bar (what Codeman creates) is exactly
  * that again after the detach.
  */
-export async function beginAttachHandoff(client, muxName, label, tabs = [], cols, rows) {
+export async function beginAttachHandoff(client, muxName, label, tabs = [], cols, rows, 
+/**
+ * Tty the attach client will inherit. Omit to read this process's terminal.
+ * `null` means there is no usable tty: switch keys are not bound (an unscoped
+ * `switch-client` would move every client on the socket, including a browser
+ * tab). Tests pass a tty so they do not depend on stdin.
+ */
+clientTty) {
     const prefix = (await client.readPrefixKey(muxName)) ?? undefined;
     // Read, not assumed: see detachChord() for the `d` vs `D` mix-up this closes.
     const detachKey = (await client.readDetachKey()) ?? undefined;
@@ -443,16 +462,34 @@ export async function beginAttachHandoff(client, muxName, label, tabs = [], cols
     // usable rather than decorative. Only the first nine, only sessions that
     // really have a pane, and only keys tmux reports as free — the same rule the
     // way-out key follows, so a binding of the user's own is never shadowed.
+    //
+    // The key table is server-global. The command is guarded to this terminal's
+    // client (see bindSwitchKey): without a tty we bind nothing, and a leaked
+    // unscoped `switch-client` from an older TUI is removed so it cannot keep
+    // moving browser tabs. When we do claim the keys, drop whatever previous
+    // attach left on M-1..M-9 first — including keys this strip will not reuse.
     const switchKeys = [];
-    for (const tab of tabs.slice(0, 9)) {
-        if (!tab.muxName)
-            continue;
-        const key = `M-${tab.index}`;
-        const bound = await client.readPrefixBinding(key, 'root');
-        if (bound !== null && !bound.startsWith('switch-client'))
-            continue;
-        if (await client.bindSwitchKey(key, tab.muxName))
-            switchKeys.push(key);
+    const tty = clientTty === undefined ? readControllingTty() : clientTty || null;
+    const switchTabs = tabs.slice(0, 9).filter((tab) => tab.index >= 1 && tab.index <= 9 && tab.muxName);
+    const guarded = Boolean(tty && isTuiClientTty(tty));
+    // The keys are bound here but stay inert until the attach hook records this
+    // client's pid, and that hook is armed at the very end (see below).
+    if (guarded && switchTabs.length > 0) {
+        for (let index = 1; index <= 9; index++)
+            await client.unbindSwitchKey(`M-${index}`);
+        for (const tab of switchTabs) {
+            const key = `M-${tab.index}`;
+            const bound = await client.readPrefixBinding(key, 'root');
+            // Takeover just cleared ours. Anything still here belongs to the user.
+            if (bound !== null)
+                continue;
+            if (await client.bindSwitchKey(key, tab.muxName, tty))
+                switchKeys.push(key);
+        }
+    }
+    else {
+        for (let index = 1; index <= 9; index++)
+            await client.unbindSwitchKey(`M-${index}`, '');
     }
     const bannerFor = (activeMux, ownLabel) => buildAttachBanner({
         ...(prefix ? { prefix } : {}),
@@ -500,11 +537,23 @@ export async function beginAttachHandoff(client, muxName, label, tabs = [], cols
         if (target === muxName)
             await client.followAttachingClient(target);
     }
+    // ⚠️ Armed LAST, as the final tmux call before the caller's `spawnSync`. The
+    // hook is one-shot for this tty, so a TUI killed between arming and attaching
+    // leaves it armed, and Linux hands the lowest free pty to the next opener: a
+    // browser tab's attach client could land on this tty and have its pid
+    // recorded, which would make these keys move that tab. Arming after the
+    // dressing loop above shrinks that window to the attach's own startup. A
+    // failed arm leaves the keys inert (the closed direction), and `restore()`
+    // still unbinds them.
+    if (switchKeys.length > 0)
+        await client.armTuiSwitchGuard(tty);
     return {
-        chord: oneKey ? ONE_KEY_DETACH : detachChord(prefix, detachKey),
+        chord: oneKey ? ONE_KEY_DETACH : fallbackDetachChord(prefix, detachKey, claimed && alias ? alias : undefined),
         async restore() {
             for (const key of switchKeys)
-                await client.unbindSwitchKey(key);
+                await client.unbindSwitchKey(key, tty ?? '');
+            if (tty && isTuiClientTty(tty))
+                await client.disarmTuiSwitchGuard(tty);
             if (oneKey)
                 await client.unbindDetachKey(ONE_KEY_DETACH, 'root');
             if (claimed && alias)
@@ -616,7 +665,7 @@ export function helpKeysFor(glyphs, context) {
         ['tab', 'next session'],
         // The one key that is not the TUI's: an attach hands the terminal to tmux,
         // and leaving it is the question every first attach asks.
-        [context.detach ?? detachChord(), 'detach from an attached session, back to here'],
+        [context.detach ?? ONE_KEY_DETACH, 'detach from an attached session, back to here'],
     ];
     if (context.server) {
         keys.push(['y / n', 'approve or deny the selected dialog'], ['1-9', 'answer with that option, when a dialog is on screen'], ['p', 'send one line to the selected session'], ['/', 'search sessions, events and files'], ['g', 'away digest'], ['n', 'new session'], ['x', 'kill (y to confirm)']);
@@ -858,11 +907,12 @@ class TuiApp {
     glyphs;
     socket = resolveTmuxSocketName();
     /**
-     * How to leave an attach, in the local tmux's own prefix. Read per attach
-     * (a session can override the prefix) and remembered so the help overlay
-     * names the real chord even before the first attach.
+     * How to leave an attach. Read per attach (F1 may be the user's, a session
+     * can override the prefix) and remembered for the help overlay; until the
+     * first attach it names F1, what an attach claims unless the user's config
+     * already holds it.
      */
-    detachChordLabel = detachChord();
+    detachChordLabel = ONE_KEY_DETACH;
     /** True for the length of one resume. The only thing standing between a resume and a loop. */
     resuming = false;
     stream = null;