devharness 0.9.7 → 0.9.9

package/build/cli/index.js

@@ -0,0 +1,290 @@
+/**
+ * `devharness <command>` - run a tool inside the session the shell belongs to.
+ *
+ * The MCP process's stdin belongs to its client, so a request arrives instead
+ * over that session's socket (src/session-endpoint.ts). Which session is
+ * decided by process ancestry, not by a flag, so `! devharness screenshot`
+ * inside a session reaches that session's browser.
+ *
+ * Guards that the MCP request handler applies - a dead dev server port, a
+ * paused breakpoint, a pending bug - are not applied here, the same as
+ * `devharness run`.
+ */
+import { connect } from 'net';
+import { readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { initializePaths } from '../helpers/paths.js';
+import { listSessionRecords } from '../session-endpoint.js';
+import { readParentMap } from './process-tree.js';
+import { matchByAncestry, findSessionByName, filterToListedProcesses } from './session-match.js';
+const DEFAULT_TIMEOUT_MS = 120000;
+/** Commands that are shorthand for one action of the `message` tool. */
+const MESSAGE_VERBS = new Set(['sessions', 'send', 'read', 'reply']);
+export const CLI_COMMANDS = ['call', 'which', ...MESSAGE_VERBS];
+export function isCliCommand(word) {
+    return word !== undefined && CLI_COMMANDS.includes(word);
+}
+export function isVersionFlag(word) {
+    return word === '--version' || word === '-v';
+}
+/**
+ * The installed version, printed by `devharness --version`.
+ *
+ * The plugin's SessionStart hook compares this against the version its
+ * `.mcp.json` pins, so a global install that has drifted from the plugin is
+ * reported at the start of a session rather than discovered through behaviour
+ * that does not match the docs.
+ */
+export function readPackageVersion() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    try {
+        return JSON.parse(readFileSync(join(here, '..', '..', 'package.json'), 'utf-8')).version ?? 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+/** Slack over the server's own wait, so the socket outlives the work it asked
+ *  for. A socket that gives up first aborts a reply the server has already
+ *  received and marked read. */
+const WAIT_SOCKET_MARGIN_MS = 15000;
+function parseArgs(argv) {
+    const positional = [];
+    let session;
+    let json = false;
+    let explicitTimeoutMs;
+    let waitMs;
+    // Everything after `--` is text, not flags: message bodies contain `--json`
+    // and the like, and stripping them silently rewrote what was sent.
+    let flagsEnded = false;
+    for (const arg of argv.slice(1)) {
+        if (!flagsEnded) {
+            if (arg === '--') {
+                flagsEnded = true;
+                continue;
+            }
+            if (arg === '--json') {
+                json = true;
+                continue;
+            }
+            if (arg.startsWith('--session=')) {
+                session = arg.slice('--session='.length);
+                continue;
+            }
+            if (arg.startsWith('--timeout=')) {
+                explicitTimeoutMs = Number(arg.slice('--timeout='.length)) || undefined;
+                continue;
+            }
+            if (arg.startsWith('--wait=')) {
+                waitMs = Number(arg.slice('--wait='.length)) || undefined;
+                continue;
+            }
+        }
+        positional.push(arg);
+    }
+    const timeoutMs = explicitTimeoutMs
+        ?? (waitMs ? waitMs + WAIT_SOCKET_MARGIN_MS : DEFAULT_TIMEOUT_MS);
+    return { command: argv[0], positional, session, json, timeoutMs, waitMs };
+}
+/** The tool call a command stands for. */
+function buildCall(parsed) {
+    const [first, ...rest] = parsed.positional;
+    switch (parsed.command) {
+        case 'call': {
+            if (!first)
+                return 'Usage: devharness call <tool> [jsonArgs]';
+            let args = {};
+            if (rest.length > 0) {
+                try {
+                    args = JSON.parse(rest.join(' '));
+                }
+                catch (error) {
+                    return `Arguments must be one JSON object: ${error?.message || error}`;
+                }
+            }
+            return { tool: first, args };
+        }
+        case 'sessions':
+            return { tool: 'message', args: { action: 'sessions' } };
+        case 'read':
+            return { tool: 'message', args: { action: 'read' } };
+        case 'send': {
+            if (!first || rest.length === 0)
+                return 'Usage: devharness send <sessionId> <text> [--wait=<ms>]';
+            return {
+                tool: 'message',
+                args: {
+                    action: 'send',
+                    to: first,
+                    text: rest.join(' '),
+                    ...(parsed.waitMs ? { waitForReplyMs: parsed.waitMs } : {}),
+                },
+            };
+        }
+        case 'reply': {
+            if (!first || rest.length === 0)
+                return 'Usage: devharness reply <messageId> <text> [--wait=<ms>]';
+            return {
+                tool: 'message',
+                args: {
+                    action: 'reply',
+                    replyTo: first,
+                    text: rest.join(' '),
+                    ...(parsed.waitMs ? { waitForReplyMs: parsed.waitMs } : {}),
+                },
+            };
+        }
+        default:
+            return `Unknown command "${parsed.command}". Commands: ${CLI_COMMANDS.join(', ')}`;
+    }
+}
+/** Send one request over a session's socket and return its reply. */
+function callSession(record, tool, args, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        let buffer = '';
+        let settled = false;
+        const socket = connect(record.address);
+        socket.setEncoding('utf-8');
+        const timer = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            socket.destroy();
+            reject(new Error(`Session ${record.shortId ?? record.pid} did not answer within ${timeoutMs}ms`));
+        }, timeoutMs);
+        const finish = (fn) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            socket.destroy();
+            fn();
+        };
+        socket.on('connect', () => {
+            socket.write(JSON.stringify({ tool, args }) + '\n');
+        });
+        socket.on('data', (chunk) => {
+            buffer += chunk;
+            const newline = buffer.indexOf('\n');
+            if (newline === -1)
+                return;
+            const line = buffer.slice(0, newline);
+            finish(() => {
+                try {
+                    resolve(JSON.parse(line));
+                }
+                catch (error) {
+                    reject(new Error(`Session replied with something that is not JSON: ${error?.message || error}`));
+                }
+            });
+        });
+        socket.on('error', (error) => {
+            finish(() => reject(new Error(error.code === 'ECONNREFUSED' || error.code === 'ENOENT'
+                ? `Session ${record.shortId ?? record.pid} is not listening on ${record.address}. It is suspended or shutting down.`
+                : `Could not reach session ${record.shortId ?? record.pid}: ${error.message}`)));
+        });
+        socket.on('close', () => {
+            finish(() => reject(new Error(`Session ${record.shortId ?? record.pid} closed the connection without replying`)));
+        });
+    });
+}
+function describeRecord(record) {
+    return `${record.shortId ?? `pid-${record.pid}`} (pid ${record.pid}) - ${record.cwd}`;
+}
+/** Rendered text of a tool response, the way an MCP client would show it. */
+function renderResponse(response) {
+    const items = Array.isArray(response?.content) ? response.content : [];
+    return items
+        .map((item) => (typeof item?.text === 'string' ? item.text : ''))
+        .filter(Boolean)
+        .join('\n');
+}
+export async function runCli(argv) {
+    initializePaths();
+    const parsed = parseArgs(argv);
+    const records = listSessionRecords();
+    if (records.length === 0) {
+        console.error('No devharness session is listening on this machine.');
+        return 1;
+    }
+    let target;
+    if (parsed.session) {
+        target = findSessionByName(records, parsed.session);
+        if (!target) {
+            console.error(`No session matches "${parsed.session}". Listening sessions:`);
+            for (const record of records)
+                console.error(`  ${describeRecord(record)}`);
+            return 1;
+        }
+    }
+    else {
+        const parents = readParentMap();
+        const listed = filterToListedProcesses(records, parents);
+        if (listed.length === 0) {
+            console.error('Every session on record has already exited - the server is restarting. Try again in a moment.');
+            return 1;
+        }
+        const result = matchByAncestry(listed, process.pid, parents);
+        if (result.ambiguous.length > 1) {
+            // Several servers can serve one session - a dev build beside the
+            // plugin's. The mailbox and its cursor are per session, not per server,
+            // so any of them answers a message verb identically. `call` reaches a
+            // particular server's browser and dev servers, so there the tie is real.
+            const ids = new Set(result.ambiguous.map(m => m.record.shortId ?? `pid-${m.record.pid}`));
+            if (ids.size === 1 && MESSAGE_VERBS.has(parsed.command)) {
+                target = result.ambiguous[0].record;
+            }
+            else {
+                // A short id resolves to the first record, so with two servers under
+                // one id `--session=<shortId>` picks one silently. Only the pid names
+                // a single server, and the listing has to say which to use.
+                const distinct = new Set(result.ambiguous.map(m => m.record.shortId ?? `pid-${m.record.pid}`)).size > 1;
+                console.error(distinct
+                    ? 'Two sessions are the same distance up the process tree. Name one with --session=<id>:'
+                    : 'One session is served by two devharness servers, and this command reaches a particular one. Name it by pid with --session=<pid>:');
+                for (const match of result.ambiguous)
+                    console.error(`  ${describeRecord(match.record)}`);
+                return 1;
+            }
+        }
+        else if (!result.matched) {
+            console.error('This shell does not descend from any devharness session. Name one with --session=<id>:');
+            for (const record of records)
+                console.error(`  ${describeRecord(record)}`);
+            return 1;
+        }
+        else {
+            target = result.matched;
+        }
+    }
+    if (parsed.command === 'which') {
+        console.log(describeRecord(target));
+        return 0;
+    }
+    const call = buildCall(parsed);
+    if (typeof call === 'string') {
+        console.error(call);
+        return 1;
+    }
+    let reply;
+    try {
+        reply = await callSession(target, call.tool, call.args, parsed.timeoutMs);
+    }
+    catch (error) {
+        console.error(error?.message || String(error));
+        return 1;
+    }
+    if (!reply.ok) {
+        console.error(reply.error || 'The session refused the call');
+        return 1;
+    }
+    if (parsed.json) {
+        console.log(JSON.stringify(reply.response, null, 2));
+    }
+    else {
+        console.log(renderResponse(reply.response));
+    }
+    return reply.response?.isError ? 1 : 0;
+}
+//# sourceMappingURL=index.js.map

package/build/cli/index.js.map

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

package/build/cli/process-tree.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Parent lookup over the process tree.
+ *
+ * A CLI invoked from a session's shell and that session's MCP process share an
+ * ancestor: both descend from the Claude Code process that owns the session.
+ * That shared ancestor is what identifies which session the command was typed
+ * in, so the whole pid -> ppid map is read once and walked in memory rather
+ * than spawning `ps` per hop.
+ */
+/** Every pid on the machine mapped to its parent. An empty map means the
+ *  process listing failed, which leaves matching with nothing to go on. */
+export declare function readParentMap(): Map<number, number>;
+/**
+ * Ancestors of `pid`, nearest parent first, excluding `pid` itself and the
+ * init process. The walk stops on a repeat so a cycle in a malformed listing
+ * cannot spin.
+ */
+export declare function collectAncestors(pid: number, parents: Map<number, number>): number[];
+/** `pid` and everything above it, for testing membership of a session's chain. */
+export declare function collectChain(pid: number, parents: Map<number, number>): Set<number>;
+//# sourceMappingURL=process-tree.d.ts.map

package/build/cli/process-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-tree.d.ts","sourceRoot":"","sources":["../../src/cli/process-tree.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;2EAC2E;AAC3E,wBAAgB,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAsBnD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CAYpF;AAED,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAEnF"}

package/build/cli/process-tree.js

@@ -0,0 +1,51 @@
+/**
+ * Parent lookup over the process tree.
+ *
+ * A CLI invoked from a session's shell and that session's MCP process share an
+ * ancestor: both descend from the Claude Code process that owns the session.
+ * That shared ancestor is what identifies which session the command was typed
+ * in, so the whole pid -> ppid map is read once and walked in memory rather
+ * than spawning `ps` per hop.
+ */
+import { execFileSync } from 'child_process';
+/** Every pid on the machine mapped to its parent. An empty map means the
+ *  process listing failed, which leaves matching with nothing to go on. */
+export function readParentMap() {
+    const parents = new Map();
+    try {
+        const output = process.platform === 'win32'
+            ? execFileSync('powershell', ['-NoProfile', '-Command', 'Get-CimInstance Win32_Process | ForEach-Object { "$($_.ProcessId) $($_.ParentProcessId)" }'], { encoding: 'utf-8', timeout: 5000 })
+            : execFileSync('ps', ['-eo', 'pid=,ppid='], { encoding: 'utf-8', timeout: 5000 });
+        for (const line of output.split('\n')) {
+            const match = line.trim().match(/^(\d+)\s+(\d+)$/);
+            if (!match)
+                continue;
+            parents.set(Number(match[1]), Number(match[2]));
+        }
+    }
+    catch {
+        return parents;
+    }
+    return parents;
+}
+/**
+ * Ancestors of `pid`, nearest parent first, excluding `pid` itself and the
+ * init process. The walk stops on a repeat so a cycle in a malformed listing
+ * cannot spin.
+ */
+export function collectAncestors(pid, parents) {
+    const ancestors = [];
+    const seen = new Set([pid]);
+    let current = parents.get(pid);
+    while (current !== undefined && current > 1 && !seen.has(current)) {
+        ancestors.push(current);
+        seen.add(current);
+        current = parents.get(current);
+    }
+    return ancestors;
+}
+/** `pid` and everything above it, for testing membership of a session's chain. */
+export function collectChain(pid, parents) {
+    return new Set([pid, ...collectAncestors(pid, parents)]);
+}
+//# sourceMappingURL=process-tree.js.map

package/build/cli/process-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-tree.js","sourceRoot":"","sources":["../../src/cli/process-tree.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C;2EAC2E;AAC3E,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE1C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO;YACzC,CAAC,CAAC,YAAY,CACV,YAAY,EACZ,CAAC,YAAY,EAAE,UAAU,EAAE,4FAA4F,CAAC,EACxH,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CACrC;YACH,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpF,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;YACnD,IAAI,CAAC,KAAK;gBAAE,SAAS;YACrB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,OAA4B;IACxE,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAG,IAAI,GAAG,CAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAEpC,IAAI,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,OAAO,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAClE,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClB,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,OAA4B;IACpE,OAAO,IAAI,GAAG,CAAS,CAAC,GAAG,EAAE,GAAG,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AACnE,CAAC"}

package/build/cli/session-match.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Which session a CLI command was typed in.
+ *
+ * The caller and the session's MCP process meet somewhere up the process tree.
+ * Every session under the same terminal or editor shares the outer ancestors,
+ * so the meeting point alone is not enough: the session whose shared ancestor
+ * is NEAREST the caller is the one whose shell ran the command. Distance is
+ * measured in hops from the caller, and the nearest wins.
+ */
+import type { SessionRecord } from '../session-endpoint.js';
+export interface SessionMatch {
+    record: SessionRecord;
+    /** Hops from the caller to the ancestor it shares with this session. */
+    distance: number;
+}
+export interface MatchResult {
+    /** Every session sharing an ancestor, nearest first. */
+    candidates: SessionMatch[];
+    /** The single nearest session, or null when none matched or two tie. */
+    matched: SessionRecord | null;
+    /** Set when two sessions are the same distance away. */
+    ambiguous: SessionMatch[];
+}
+export declare function matchByAncestry(records: SessionRecord[], callerPid: number, parents: Map<number, number>): MatchResult;
+/**
+ * Records whose process is in the listing.
+ *
+ * A record survives its process by the moment it takes the supervisor to
+ * replace a child, and one absent from the process listing has no chain to
+ * walk - it would report as "no shared ancestor", which reads as the caller
+ * being in the wrong shell rather than the session being mid-restart. An
+ * empty listing means the walk failed entirely, so nothing is filtered.
+ */
+export declare function filterToListedProcesses(records: SessionRecord[], parents: Map<number, number>): SessionRecord[];
+/** The session a caller named explicitly: short id, session id, or pid. */
+export declare function findSessionByName(records: SessionRecord[], name: string): SessionRecord | null;
+//# sourceMappingURL=session-match.d.ts.map

package/build/cli/session-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-match.d.ts","sourceRoot":"","sources":["../../src/cli/session-match.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAG5D,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,aAAa,CAAC;IACtB,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,wEAAwE;IACxE,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9B,wDAAwD;IACxD,SAAS,EAAE,YAAY,EAAE,CAAC;CAC3B;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,aAAa,EAAE,EACxB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,WAAW,CAwBb;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,aAAa,EAAE,EACxB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,aAAa,EAAE,CAGjB;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAS9F"}

package/build/cli/session-match.js

@@ -0,0 +1,55 @@
+/**
+ * Which session a CLI command was typed in.
+ *
+ * The caller and the session's MCP process meet somewhere up the process tree.
+ * Every session under the same terminal or editor shares the outer ancestors,
+ * so the meeting point alone is not enough: the session whose shared ancestor
+ * is NEAREST the caller is the one whose shell ran the command. Distance is
+ * measured in hops from the caller, and the nearest wins.
+ */
+import { collectAncestors, collectChain } from './process-tree.js';
+export function matchByAncestry(records, callerPid, parents) {
+    const callerAncestors = collectAncestors(callerPid, parents);
+    const candidates = [];
+    for (const record of records) {
+        const chain = collectChain(record.pid, parents);
+        const distance = callerAncestors.findIndex(pid => chain.has(pid));
+        if (distance === -1)
+            continue;
+        candidates.push({ record, distance });
+    }
+    candidates.sort((a, b) => a.distance - b.distance);
+    if (candidates.length === 0) {
+        return { candidates, matched: null, ambiguous: [] };
+    }
+    const nearest = candidates[0].distance;
+    const tied = candidates.filter(c => c.distance === nearest);
+    if (tied.length > 1) {
+        return { candidates, matched: null, ambiguous: tied };
+    }
+    return { candidates, matched: candidates[0].record, ambiguous: [] };
+}
+/**
+ * Records whose process is in the listing.
+ *
+ * A record survives its process by the moment it takes the supervisor to
+ * replace a child, and one absent from the process listing has no chain to
+ * walk - it would report as "no shared ancestor", which reads as the caller
+ * being in the wrong shell rather than the session being mid-restart. An
+ * empty listing means the walk failed entirely, so nothing is filtered.
+ */
+export function filterToListedProcesses(records, parents) {
+    if (parents.size === 0)
+        return records;
+    return records.filter(record => parents.has(record.pid));
+}
+/** The session a caller named explicitly: short id, session id, or pid. */
+export function findSessionByName(records, name) {
+    const asPid = Number(name);
+    return (records.find(r => r.shortId === name) ??
+        records.find(r => r.sessionId === name) ??
+        (Number.isInteger(asPid) ? records.find(r => r.pid === asPid) : undefined) ??
+        records.find(r => r.sessionId?.startsWith(name)) ??
+        null);
+}
+//# sourceMappingURL=session-match.js.map

package/build/cli/session-match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-match.js","sourceRoot":"","sources":["../../src/cli/session-match.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAiBnE,MAAM,UAAU,eAAe,CAC7B,OAAwB,EACxB,SAAiB,EACjB,OAA4B;IAE5B,MAAM,eAAe,GAAG,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAE7D,MAAM,UAAU,GAAmB,EAAE,CAAC;IACtC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,IAAI,QAAQ,KAAK,CAAC,CAAC;YAAE,SAAS;QAC9B,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAEnD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IACtD,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACvC,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IAC5D,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACxD,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;AACtE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAwB,EACxB,OAA4B;IAE5B,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACvC,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,iBAAiB,CAAC,OAAwB,EAAE,IAAY;IACtE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3B,OAAO,CACL,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC;QACvC,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CACL,CAAC;AACJ,CAAC"}

package/build/cli/session-match.test.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Tests for identifying the session a CLI command was typed in.
+ *
+ * The tree below is the shape this has to get right: one editor, two Claude
+ * sessions under it, each with a supervisor and an MCP child, and a shell
+ * under one of them. Every session shares the editor, so a rule that stops at
+ * "shares an ancestor" picks both.
+ *
+ *   900 editor
+ *   +-- 800 claude A          +-- 700 claude B
+ *       +-- 810 supervisor A      +-- 710 supervisor B
+ *       |   +-- 811 mcp A         |   +-- 711 mcp B
+ *       +-- 820 shell A           +-- 720 shell B
+ *           +-- 821 devharness        +-- 721 devharness
+ */
+export {};
+//# sourceMappingURL=session-match.test.d.ts.map

package/build/cli/session-match.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-match.test.d.ts","sourceRoot":"","sources":["../../src/cli/session-match.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/build/cli/session-match.test.js

@@ -0,0 +1,125 @@
+/**
+ * Tests for identifying the session a CLI command was typed in.
+ *
+ * The tree below is the shape this has to get right: one editor, two Claude
+ * sessions under it, each with a supervisor and an MCP child, and a shell
+ * under one of them. Every session shares the editor, so a rule that stops at
+ * "shares an ancestor" picks both.
+ *
+ *   900 editor
+ *   +-- 800 claude A          +-- 700 claude B
+ *       +-- 810 supervisor A      +-- 710 supervisor B
+ *       |   +-- 811 mcp A         |   +-- 711 mcp B
+ *       +-- 820 shell A           +-- 720 shell B
+ *           +-- 821 devharness        +-- 721 devharness
+ */
+import { describe, it, expect } from 'vitest';
+import { collectAncestors, collectChain } from './process-tree.js';
+import { matchByAncestry, findSessionByName, filterToListedProcesses } from './session-match.js';
+const PARENTS = new Map([
+    [900, 1],
+    [800, 900], [810, 800], [811, 810], [820, 800], [821, 820],
+    [700, 900], [710, 700], [711, 710], [720, 700], [721, 720],
+]);
+function record(pid, shortId) {
+    return {
+        pid,
+        ppid: PARENTS.get(pid) ?? 1,
+        cwd: `/repo/${shortId}`,
+        shortId,
+        sessionId: `${shortId}-0000-0000`,
+        address: `/tmp/${pid}.sock`,
+        startedAt: 1000 + pid,
+    };
+}
+const SESSION_A = record(811, 'aaaaaaaa');
+const SESSION_B = record(711, 'bbbbbbbb');
+describe('collectAncestors', () => {
+    it('walks to the top, nearest first, excluding the process itself and init', () => {
+        expect(collectAncestors(821, PARENTS)).toEqual([820, 800, 900]);
+    });
+    it('returns nothing for a pid with no recorded parent', () => {
+        expect(collectAncestors(4242, PARENTS)).toEqual([]);
+    });
+    it('stops on a cycle instead of spinning', () => {
+        const cyclic = new Map([[10, 20], [20, 10]]);
+        expect(collectAncestors(10, cyclic)).toEqual([20]);
+    });
+    it('includes the process itself in a chain', () => {
+        expect(collectChain(811, PARENTS)).toEqual(new Set([811, 810, 800, 900]));
+    });
+});
+describe('matchByAncestry', () => {
+    it('picks the session whose shared ancestor is nearest the caller', () => {
+        const result = matchByAncestry([SESSION_A, SESSION_B], 821, PARENTS);
+        expect(result.matched?.shortId).toBe('aaaaaaaa');
+        expect(result.ambiguous).toEqual([]);
+    });
+    it('picks the other session from the other shell', () => {
+        const result = matchByAncestry([SESSION_A, SESSION_B], 721, PARENTS);
+        expect(result.matched?.shortId).toBe('bbbbbbbb');
+    });
+    it('still lists the far session as a candidate, just further away', () => {
+        const result = matchByAncestry([SESSION_A, SESSION_B], 821, PARENTS);
+        expect(result.candidates.map(c => [c.record.shortId, c.distance])).toEqual([
+            ['aaaaaaaa', 1], // claude A, one hop up from the shell
+            ['bbbbbbbb', 2], // the editor, two hops up
+        ]);
+    });
+    it('reports ambiguity rather than guessing when two are equally near', () => {
+        const twin = { ...record(812, 'cccccccc'), ppid: 810 };
+        const parents = new Map(PARENTS).set(812, 810);
+        const result = matchByAncestry([SESSION_A, twin], 821, parents);
+        expect(result.matched).toBeNull();
+        expect(result.ambiguous.map(m => m.record.shortId).sort()).toEqual(['aaaaaaaa', 'cccccccc']);
+    });
+    it('matches nothing for a caller outside every session tree', () => {
+        const parents = new Map(PARENTS).set(50, 1);
+        const result = matchByAncestry([SESSION_A, SESSION_B], 50, parents);
+        expect(result.matched).toBeNull();
+        expect(result.candidates).toEqual([]);
+    });
+    it('matches nothing when the process listing is empty', () => {
+        const result = matchByAncestry([SESSION_A, SESSION_B], 821, new Map());
+        expect(result.matched).toBeNull();
+    });
+});
+describe('filterToListedProcesses', () => {
+    it('drops a record whose process is no longer in the listing', () => {
+        const gone = record(811, 'aaaaaaaa');
+        const parents = new Map(PARENTS);
+        parents.delete(811);
+        expect(filterToListedProcesses([gone, SESSION_B], parents)).toEqual([SESSION_B]);
+    });
+    it('keeps every record when the process listing failed', () => {
+        expect(filterToListedProcesses([SESSION_A, SESSION_B], new Map())).toEqual([SESSION_A, SESSION_B]);
+    });
+});
+describe('findSessionByName', () => {
+    const records = [SESSION_A, SESSION_B];
+    it('finds by short id', () => {
+        expect(findSessionByName(records, 'bbbbbbbb')?.pid).toBe(711);
+    });
+    it('finds by full session id and by prefix', () => {
+        expect(findSessionByName(records, 'aaaaaaaa-0000-0000')?.pid).toBe(811);
+        expect(findSessionByName(records, 'aaaaaaaa-0000')?.pid).toBe(811);
+    });
+    it('finds by pid', () => {
+        expect(findSessionByName(records, '711')?.shortId).toBe('bbbbbbbb');
+    });
+    it('returns null for a name that matches nothing', () => {
+        expect(findSessionByName(records, 'zzzz')).toBeNull();
+    });
+});
+describe('ordering when two servers start together', () => {
+    it('is decided by pid, not by whatever order the directory listed', () => {
+        // A rebuild restarts every child at once, so equal startedAt is the norm.
+        const a = { ...record(811, 'aaaaaaaa'), startedAt: 500 };
+        const b = { ...record(711, 'bbbbbbbb'), startedAt: 500 };
+        const sorted = [a, b].sort((x, y) => y.startedAt - x.startedAt || x.pid - y.pid);
+        const reversed = [b, a].sort((x, y) => y.startedAt - x.startedAt || x.pid - y.pid);
+        expect(sorted.map(r => r.pid)).toEqual([711, 811]);
+        expect(reversed.map(r => r.pid)).toEqual([711, 811]);
+    });
+});
+//# sourceMappingURL=session-match.test.js.map