chorus-codes 0.7.0 → 0.7.1

package/dist/cli/commands/status.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerStatusCommand = registerStatusCommand;
+const shared_js_1 = require("../shared.js");
+const ui_js_1 = require("../ui.js");
+function registerStatusCommand(program) {
+    program
+        .command('status')
+        .description('Check daemon health')
+        .action(async () => {
+        try {
+            const response = await fetch(`${shared_js_1.DAEMON_URL}/api/v1/health`);
+            if (!response.ok) {
+                console.log('');
+                console.log((0, ui_js_1.header)(ui_js_1.sym.err, 'Daemon is not running', 'start with `chorus start`'));
+                console.log('');
+                process.exit(1);
+            }
+            const envelope = (await response.json());
+            const data = envelope.data;
+            if (envelope.ok && data) {
+                const uptime = Math.floor(data.uptime / 1000);
+                const human = uptime < 60
+                    ? `${uptime}s`
+                    : uptime < 3600
+                        ? `${Math.floor(uptime / 60)}m`
+                        : `${Math.floor(uptime / 3600)}h ${Math.floor((uptime % 3600) / 60)}m`;
+                console.log('');
+                console.log((0, ui_js_1.header)(ui_js_1.sym.ok, 'Chorus is running'));
+                console.log('');
+                console.log((0, ui_js_1.kv)([
+                    ['Version', ui_js_1.c.cyan(data.version)],
+                    ['Uptime', ui_js_1.c.dim(human)],
+                    ['Cockpit', ui_js_1.c.cyan(shared_js_1.COCKPIT_URL)],
+                    ['Daemon', ui_js_1.c.dim(shared_js_1.DAEMON_URL)],
+                ]));
+                console.log('');
+            }
+            else {
+                console.log('');
+                console.log((0, ui_js_1.header)(ui_js_1.sym.err, 'Daemon is not responding correctly'));
+                console.log('');
+                process.exit(1);
+            }
+        }
+        catch {
+            console.log('');
+            console.log((0, ui_js_1.header)(ui_js_1.sym.err, 'Daemon is not running', 'start with `chorus start`'));
+            console.log('');
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/cli/commands/status.js.map

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

package/dist/cli/commands/stop.js

@@ -0,0 +1,97 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerStopCommand = registerStopCommand;
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const port_utils_js_1 = require("../port-utils.js");
+const ui_js_1 = require("../ui.js");
+/**
+ * Two-stage shutdown per managed process: SIGTERM, wait up to 1.5s,
+ * escalate to SIGKILL if still alive. Don't unlink the pidfile until
+ * the process is confirmed dead — otherwise an orphan that ignores
+ * SIGTERM keeps running while we forget about it (the bug behind the
+ * "stale next-server serving 500s" incident on 2026-05-03).
+ *
+ * Belt-and-braces: after pidfile-based shutdown, also sweep ports
+ * :7707 (daemon) and :5050 (cockpit). Catches the case where the
+ * pidfile was lost or pointed at a recycled PID but a real chorus
+ * process still owns the port.
+ */
+function registerStopCommand(program) {
+    program
+        .command('stop')
+        .description('Stop the Chorus daemon and cockpit')
+        .action(async () => {
+        try {
+            const chorusDir = path_1.default.join(os_1.default.homedir(), '.chorus');
+            const daemonPidFile = path_1.default.join(chorusDir, 'daemon.pid');
+            const webPidFile = path_1.default.join(chorusDir, 'web.pid');
+            const daemonPidfileExists = fs_1.default.existsSync(daemonPidFile);
+            const webPidfileExists = fs_1.default.existsSync(webPidFile);
+            const daemonPortInUse = await (0, port_utils_js_1.isPortInUse)(7707);
+            const cockpitPortInUse = await (0, port_utils_js_1.isPortInUse)(5050);
+            if (!daemonPidfileExists &&
+                !webPidfileExists &&
+                !daemonPortInUse &&
+                !cockpitPortInUse) {
+                console.log('');
+                console.log((0, ui_js_1.header)(ui_js_1.sym.info, 'Chorus is not running', 'nothing to stop'));
+                console.log('');
+                return;
+            }
+            console.log('');
+            console.log((0, ui_js_1.header)(ui_js_1.sym.pointer, 'Stopping Chorus...'));
+            console.log('');
+            await stopProcess('Daemon', daemonPidFile);
+            await stopProcess('Cockpit', webPidFile);
+            // Port-based sweep — kills any chorus-owned listener that
+            // escaped the pidfile path. Errs on the side of cleanup;
+            // running a non-chorus service on these ports while invoking
+            // `chorus stop` is unsupported.
+            await sweepPort(7707, 'Daemon');
+            await sweepPort(5050, 'Cockpit');
+            console.log('');
+        }
+        catch (error) {
+            console.error(`${ui_js_1.sym.err} ${ui_js_1.c.red('Error stopping chorus:')}`, error);
+            process.exit(1);
+        }
+    });
+}
+async function stopProcess(label, pidFile) {
+    if (!fs_1.default.existsSync(pidFile))
+        return;
+    const pid = parseInt(fs_1.default.readFileSync(pidFile, 'utf-8'), 10);
+    if (!Number.isFinite(pid) || pid <= 0) {
+        fs_1.default.unlinkSync(pidFile);
+        return;
+    }
+    const dead = await (0, port_utils_js_1.killAndVerify)(pid, label);
+    if (dead) {
+        console.log(`  ${ui_js_1.sym.ok} ${label.padEnd(7)} ${ui_js_1.c.dim(`(PID ${pid})`)}`);
+        // Only unlink once we've confirmed the process is gone. Earlier
+        // code unconditionally unlinked, which orphaned any process that
+        // ignored SIGTERM — its successor `chorus start` couldn't see
+        // the ghost owner of the port.
+        try {
+            fs_1.default.unlinkSync(pidFile);
+        }
+        catch {
+            /* already gone */
+        }
+    }
+}
+async function sweepPort(port, label) {
+    const pids = (0, port_utils_js_1.findPidsOnPort)(port);
+    for (const pid of pids) {
+        const dead = await (0, port_utils_js_1.killAndVerify)(pid, `${label} orphan`);
+        if (dead) {
+            console.log(`  ${ui_js_1.sym.ok} ${label.padEnd(7)} ${ui_js_1.c.dim(`(orphan PID ${pid} on :${port})`)}`);
+        }
+    }
+}
+//# sourceMappingURL=stop.js.map

package/dist/cli/commands/stop.js.map

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

package/dist/cli/connect.js

@@ -0,0 +1,108 @@
+"use strict";
+/**
+ * `chorus connect [orchestrator]` — wire Chorus into a CLI's MCP config so
+ * the user can call chorus.* tools from inside it. Removes the per-tool
+ * "Yes, allow for this project?" friction (Claude) or registers the MCP
+ * server (Codex/Gemini/OpenCode) which they don't have until we add it.
+ *
+ * Idempotent. Same logic exposed at daemon `POST /orchestrators/:name/connect`
+ * so the cockpit's /connect page can run it with one click.
+ *
+ * Usage:
+ *   chorus connect              # all detected CLIs
+ *   chorus connect claude       # just Claude Code
+ *   chorus connect codex,gemini # comma-separated subset
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runConnect = runConnect;
+const node_path_1 = __importDefault(require("node:path"));
+const index_js_1 = require("../daemon/orchestrators/index.js");
+const CHORUS_BIN_PATH = node_path_1.default.resolve(__dirname, '..', '..', 'bin', 'chorus.mjs');
+const ALL_NAMES = ['claude', 'codex', 'gemini', 'opencode', 'kimi', 'cursor', 'windsurf'];
+function parseTargets(arg) {
+    if (!arg)
+        return null; // null = "all detected"
+    const wanted = arg.split(',').map((s) => s.trim().toLowerCase());
+    const valid = [];
+    for (const w of wanted) {
+        if (ALL_NAMES.includes(w)) {
+            valid.push(w);
+        }
+        else {
+            console.error(`Unknown orchestrator: '${w}'. Valid: ${ALL_NAMES.join(', ')}`);
+            process.exit(1);
+        }
+    }
+    return valid;
+}
+async function runConnect(orchestrator) {
+    const only = parseTargets(orchestrator);
+    const binPath = CHORUS_BIN_PATH;
+    console.log(`Connecting Chorus${only ? ` to: ${only.join(', ')}` : ''}...`);
+    console.log('');
+    try {
+        const result = await (0, index_js_1.autoConnectAll)({
+            binPath,
+            ...(only && only.length > 0 ? { only } : {}),
+        });
+        const statuses = (0, index_js_1.listOrchestrators)();
+        const promptsOnce = [];
+        const inheritsGlobal = [];
+        for (const step of result.steps) {
+            if (!step.detected) {
+                console.log(`  ✗ ${step.label}: not detected on this machine`);
+                continue;
+            }
+            if (step.error) {
+                console.log(`  ! ${step.label}: ${step.error}`);
+                continue;
+            }
+            const parts = [];
+            if (step.registered)
+                parts.push('MCP server registered');
+            else
+                parts.push('MCP already registered');
+            if (step.toolsAdded > 0)
+                parts.push(`${step.toolsAdded} tool(s) approved`);
+            else if (step.name === 'claude')
+                parts.push(`all ${index_js_1.CHORUS_TOOLS.length} tools already approved`);
+            if (step.slashCommand === 'installed')
+                parts.push('/chorus command installed');
+            else if (step.slashCommand === 'updated')
+                parts.push('/chorus command updated');
+            console.log(`  ✓ ${step.label}: ${parts.join(' · ')}`);
+            const status = statuses.find((s) => s.name === step.name);
+            if (status?.firstCallBehavior === 'prompts_once')
+                promptsOnce.push(step.label);
+            if (status?.firstCallBehavior === 'inherits_global')
+                inheritsGlobal.push(step.label);
+        }
+        if (!result.anyConnected) {
+            console.log('');
+            console.log('No supported CLIs detected. Install Claude Code, Codex, Gemini, OpenCode, Kimi, Cursor, or Windsurf then retry.');
+            return;
+        }
+        console.log('');
+        console.log('Restart any CLI you just connected so it picks up the new MCP server.');
+        console.log('Inside the CLI: try `/chorus bug-diagnose <paste a snippet>` (Claude) or');
+        console.log('say `chorus, run bug-diagnose on <snippet>` (any other CLI).');
+        if (promptsOnce.length > 0) {
+            console.log('');
+            console.log(`Heads up: ${promptsOnce.join(', ')} will show a one-time permission prompt`);
+            console.log('on your first chorus.* tool call. Click "Always allow" to make it stick.');
+        }
+        if (inheritsGlobal.length > 0) {
+            console.log('');
+            console.log(`${inheritsGlobal.join(', ')} use a global approval policy — whether tool calls`);
+            console.log('prompt depends on your existing config (we don\'t override it).');
+        }
+    }
+    catch (err) {
+        console.error(`\nFailed: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=connect.js.map

package/dist/cli/connect.js.map

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

package/dist/cli/index.js

@@ -0,0 +1,99 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const fs_1 = __importDefault(require("fs"));
+const open_1 = __importDefault(require("open"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const doctor_js_1 = require("./commands/doctor.js");
+const init_js_1 = require("./commands/init.js");
+const start_js_1 = require("./commands/start.js");
+const status_js_1 = require("./commands/status.js");
+const stop_js_1 = require("./commands/stop.js");
+const runtime_env_js_1 = require("./runtime-env.js");
+const shared_js_1 = require("./shared.js");
+const ui_js_1 = require("./ui.js");
+const program = new commander_1.Command();
+program
+    .name('chorus')
+    .description('Driver-agnostic multi-LLM peer review for code decisions')
+    .version(shared_js_1.pkg.version);
+// Show a quick-start banner before the standard help so first-time
+// users see the setup sequence even when npm's global install hides
+// postinstall stdout. State-aware: chorus.db is the marker — dir alone
+// is not enough, an empty ~/.chorus can exist from a prior aborted
+// install.
+program.addHelpText('beforeAll', () => {
+    const chorusDir = path_1.default.join(os_1.default.homedir(), '.chorus');
+    const dbFile = path_1.default.join(chorusDir, 'chorus.db');
+    const daemonPid = path_1.default.join(chorusDir, 'daemon.pid');
+    const initialised = fs_1.default.existsSync(dbFile);
+    const running = fs_1.default.existsSync(daemonPid);
+    if (!initialised) {
+        return [
+            '',
+            `  ${ui_js_1.sym.rocket} ${ui_js_1.c.bold('Welcome to Chorus')} ${ui_js_1.c.dim('— two commands to get going:')}`,
+            '',
+            `    ${ui_js_1.c.cyan('1.')} ${ui_js_1.c.bold('chorus init')}     ${ui_js_1.c.dim('register MCP with your editors + seed templates + detect CLIs')}`,
+            `    ${ui_js_1.c.cyan('2.')} ${ui_js_1.c.bold('chorus start')}    ${ui_js_1.c.dim('bring up the daemon + cockpit at')} ${ui_js_1.c.cyan('http://127.0.0.1:5050')}`,
+            '',
+        ].join('\n');
+    }
+    if (!running) {
+        return [
+            '',
+            `  ${ui_js_1.sym.pointer} ${ui_js_1.c.bold('Daemon is stopped.')} ${ui_js_1.c.dim('Bring it back up:')}`,
+            '',
+            `    ${ui_js_1.c.bold('chorus start')}`,
+            '',
+        ].join('\n');
+    }
+    return '';
+});
+(0, init_js_1.registerInitCommand)(program);
+(0, start_js_1.registerStartCommand)(program);
+(0, stop_js_1.registerStopCommand)(program);
+(0, status_js_1.registerStatusCommand)(program);
+(0, doctor_js_1.registerDoctorCommand)(program);
+program
+    .command('ui')
+    .description('Open the Chorus web UI in default browser')
+    .action(async () => {
+    try {
+        const env = (0, runtime_env_js_1.detectRuntimeEnv)();
+        (0, shared_js_1.printCockpitAccessHint)();
+        if ((0, runtime_env_js_1.shouldAutoOpenBrowser)(env)) {
+            await (0, open_1.default)(shared_js_1.COCKPIT_URL);
+            console.log(`\nOpening ${shared_js_1.COCKPIT_URL}...`);
+        }
+    }
+    catch (error) {
+        console.error('Failed to open browser:', error);
+        process.exit(1);
+    }
+});
+program
+    .command('connect [orchestrator]')
+    .description('Pre-approve all Chorus MCP tools in your orchestrator (default: claude)')
+    .action(async (orchestrator) => {
+    const { runConnect } = await import('./connect.js');
+    runConnect(orchestrator);
+});
+program
+    .command('mcp')
+    .description('Run the MCP server on stdio (for orchestrators)')
+    .action(async () => {
+    // Hand off stdio to the MCP server. This call never returns under
+    // normal operation — the orchestrator (Claude Code, Codex, Cursor)
+    // holds the pipe open and pumps JSON-RPC messages until it shuts
+    // the child down.
+    await import('../mcp/index.js');
+});
+program.parse(process.argv);
+if (!process.argv.slice(2).length) {
+    program.outputHelp();
+}
+//# sourceMappingURL=index.js.map

package/dist/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/dist/cli/port-utils.js

@@ -0,0 +1,260 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPortInUse = isPortInUse;
+exports.findPidsOnPort = findPidsOnPort;
+exports.pidLooksLikeChorus = pidLooksLikeChorus;
+exports.killAndVerify = killAndVerify;
+const child_process_1 = require("child_process");
+const fs_1 = __importDefault(require("fs"));
+const net_1 = __importDefault(require("net"));
+const ui_js_1 = require("./ui.js");
+/**
+ * Probe whether anything is listening on a TCP port on 127.0.0.1.
+ *
+ * Used by the start-path orphan reaper: if a previous next-server from
+ * an earlier `chorus start` survived a `chorus stop` (because the
+ * pidfile was lost or the SIGTERM was ignored), the next start would
+ * silently race against it on :5050 and leave the user stuck on stale
+ * chunks after a rebuild.
+ */
+function isPortInUse(port, host = '127.0.0.1', timeoutMs = 500) {
+    return new Promise((resolve) => {
+        const sock = new net_1.default.Socket();
+        let settled = false;
+        const finish = (inUse) => {
+            if (settled)
+                return;
+            settled = true;
+            try {
+                sock.destroy();
+            }
+            catch {
+                /* ignore */
+            }
+            resolve(inUse);
+        };
+        sock.setTimeout(timeoutMs);
+        sock.once('connect', () => finish(true));
+        sock.once('timeout', () => finish(false));
+        sock.once('error', () => finish(false));
+        sock.connect(port, host);
+    });
+}
+/**
+ * Find any process holding a TCP listener on `port` on 127.0.0.1.
+ * Returns the PIDs found via `ss`/`lsof`. Best-effort — returns [] on
+ * platforms where neither tool is available.
+ *
+ * Why: pidfile-based tracking is fragile (file deleted on a partial
+ * stop, PID reused by an unrelated process). Port-based reaping is the
+ * source of truth — if something's bound to :5050, we want it gone
+ * before we spawn our own.
+ */
+function findPidsOnPort(port) {
+    const candidates = [
+        {
+            cmd: `ss -ltnp 'sport = :${port}' 2>/dev/null`,
+            parse: (out) => {
+                const pids = [];
+                for (const m of out.matchAll(/pid=(\d+)/g)) {
+                    const pid = parseInt(m[1], 10);
+                    if (Number.isFinite(pid) && pid > 0)
+                        pids.push(pid);
+                }
+                return pids;
+            },
+        },
+        {
+            cmd: `lsof -nP -iTCP:${port} -sTCP:LISTEN -t 2>/dev/null`,
+            parse: (out) => out
+                .split(/\s+/)
+                .map((s) => parseInt(s, 10))
+                .filter((n) => Number.isFinite(n) && n > 0),
+        },
+    ];
+    for (const { cmd, parse } of candidates) {
+        try {
+            const out = (0, child_process_1.execSync)(cmd, {
+                encoding: 'utf-8',
+                stdio: ['ignore', 'pipe', 'ignore'],
+            });
+            const pids = parse(out);
+            if (pids.length > 0)
+                return Array.from(new Set(pids));
+        }
+        catch {
+            /* tool not present or no match — try next */
+        }
+    }
+    return [];
+}
+/**
+ * Read the process's command line so we can decide whether it looks
+ * like a chorus orphan (safe to reap) vs a foreign process the user
+ * owns (refuse to kill — Grafana/another dev server happens to be on
+ * 5050 or 7707). Linux exposes /proc/<pid>/cmdline; macOS doesn't, so
+ * we fall back to `ps -p <pid> -o command=`.
+ */
+function readCmdline(pid) {
+    try {
+        const procPath = `/proc/${pid}/cmdline`;
+        if (fs_1.default.existsSync(procPath)) {
+            // /proc/<pid>/cmdline is NUL-separated argv. Replace with spaces
+            // so we can substring-match against the joined invocation.
+            return fs_1.default.readFileSync(procPath, 'utf-8').replace(/ /g, ' ').trim();
+        }
+    }
+    catch {
+        /* race with process exit, fall through to ps */
+    }
+    try {
+        // execFileSync over execSync so a future loosening of `pid`'s
+        // numeric type can't slip into a shell command-injection. argv
+        // goes straight to ps without an intermediate sh -c.
+        const out = (0, child_process_1.execFileSync)('ps', ['-p', String(pid), '-o', 'command='], {
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        const trimmed = out.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Path-segment match for the chorus / chorus-codes directory names.
+ * Splitting on `/` so we accept `/dev/chorus/...` but not
+ * `/dev/chorus-experiments/...`. Used by the next-launcher fallback
+ * for both cmdline and cwd checks.
+ */
+function pathHasChorusSegment(somePath) {
+    const segs = somePath.split('/');
+    return segs.includes('chorus') || segs.includes('chorus-codes');
+}
+function cmdlineHasChorusSegment(cmdline) {
+    for (const tok of cmdline.split(/\s+/)) {
+        if (pathHasChorusSegment(tok))
+            return true;
+    }
+    return false;
+}
+/**
+ * Does this process look like a chorus daemon or cockpit?
+ *
+ * The reap loop in `chorus start` kills whatever's bound to 5050/7707
+ * before respawning. Pre-fix, that loop would happily SIGKILL
+ * `grafana-server` or another user's `next dev` if either happened to
+ * be on the same port — silently murdering work and surprising the user.
+ *
+ * Accept anything whose argv mentions one of these markers, all of
+ * which are uniquely chorus-shaped:
+ *   - `chorus/dist/daemon/index.js` — compiled daemon entrypoint
+ *   - `src/daemon/index.ts`         — dev (tsx) entrypoint
+ *   - `chorus/bin/chorus.mjs`       — CLI wrapper
+ *   - `next-server` / `next start` running in a path that contains chorus
+ *
+ * Anything else returns false; the caller should refuse to reap and
+ * surface a clear "port is taken by <cmd>" error.
+ */
+function pidLooksLikeChorus(pid) {
+    const cmdline = readCmdline(pid);
+    if (!cmdline) {
+        // Couldn't read cmdline (race / permission). Fail-closed: treat as
+        // foreign, force the user to investigate.
+        return { match: false, cmdline: null };
+    }
+    // Path markers covering both dev (repo) and installed (node_modules)
+    // layouts. The unscoped npm name `chorus-codes` lands the package at
+    // node_modules/chorus-codes/* on global installs.
+    //
+    // Each marker is prefixed with `/` so substring search anchors on a
+    // path-segment boundary. Without the leading slash,
+    // `cmdline.includes('chorus/dist/...')` would match
+    // `/x/notchorus/dist/...` or `/x/mychorus-fork/dist/...`.
+    const markers = [
+        '/chorus/dist/daemon/index.js',
+        '/chorus/src/daemon/index.ts',
+        '/chorus/bin/chorus.mjs',
+        '/chorus/dist/cli/index.js',
+        '/chorus-codes/dist/daemon/index.js',
+        '/chorus-codes/src/daemon/index.ts',
+        '/chorus-codes/bin/chorus.mjs',
+        '/chorus-codes/dist/cli/index.js',
+    ];
+    if (markers.some((m) => cmdline.includes(m)))
+        return { match: true, cmdline };
+    // next-server is the cockpit. The launcher may show up as either the
+    // literal `next-server (vXX.YY.ZZ)` worker title (Next overwrites
+    // process.title once running, wiping the original argv — chorus
+    // disappears from cmdline at that point) OR as the original `node
+    // node_modules/next/dist/bin/next start` argv. To stay safe in both
+    // states, accept either form when the cmdline carries a chorus path
+    // segment OR the process's cwd has one — chorus start always spawns
+    // Next with cwd: packageRoot. Path-segment matching (split + includes)
+    // so /home/user/chorus-experiments/marketing-site doesn't mistakenly
+    // match.
+    const nextLauncher = cmdline.includes('next-server') ||
+        /node_modules\/next\/dist\/bin\/next (start|dev)/.test(cmdline);
+    if (nextLauncher) {
+        if (cmdlineHasChorusSegment(cmdline))
+            return { match: true, cmdline };
+        let cwd = null;
+        try {
+            cwd = fs_1.default.readlinkSync(`/proc/${pid}/cwd`);
+        }
+        catch {
+            /* not Linux or process gone — fall through */
+        }
+        if (cwd && pathHasChorusSegment(cwd))
+            return { match: true, cmdline };
+    }
+    return { match: false, cmdline };
+}
+/**
+ * Send SIGTERM to a PID and wait up to `gracefulMs` for it to die. If
+ * still alive, escalate to SIGKILL. Returns true if the process is
+ * gone by the time we return (or never existed in the first place),
+ * false if SIGKILL also failed.
+ */
+async function killAndVerify(pid, label, gracefulMs = 1500) {
+    const isAlive = () => {
+        try {
+            process.kill(pid, 0);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    if (!isAlive())
+        return true;
+    try {
+        process.kill(pid, 'SIGTERM');
+    }
+    catch {
+        /* gone already */
+    }
+    const deadline = Date.now() + gracefulMs;
+    while (Date.now() < deadline) {
+        if (!isAlive())
+            return true;
+        await new Promise((r) => setTimeout(r, 100));
+    }
+    // Stubborn — escalate.
+    try {
+        process.kill(pid, 'SIGKILL');
+    }
+    catch {
+        /* may already be dead */
+    }
+    await new Promise((r) => setTimeout(r, 200));
+    if (!isAlive())
+        return true;
+    console.warn(`  ${ui_js_1.sym.err} ${label} PID ${pid} survived SIGKILL — manual cleanup needed`);
+    return false;
+}
+//# sourceMappingURL=port-utils.js.map

package/dist/cli/port-utils.js.map

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