gsd-pi 2.33.1 → 2.34.0-dev.bbb5216

package/dist/resources/extensions/bg-shell/process-manager.js

@@ -0,0 +1,413 @@
+/**
+ * Process lifecycle management: start, stop, restart, signal, state tracking,
+ * process registry, and persistence.
+ */
+import { spawn, spawnSync } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { writeFileSync, readFileSync, existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { getShellConfig, sanitizeCommand } from "@gsd/pi-coding-agent";
+import { MAX_BUFFER_LINES, MAX_EVENTS, DEAD_PROCESS_TTL, } from "./types.js";
+import { restoreWindowsVTInput, formatUptime } from "./utilities.js";
+import { analyzeLine } from "./output-formatter.js";
+import { startPortProbing, transitionToReady } from "./readiness-detector.js";
+// ── Process Registry ───────────────────────────────────────────────────────
+export const processes = new Map();
+/** Pending alerts to inject into the next agent context */
+export let pendingAlerts = [];
+/** Replace the pendingAlerts array (used by the extension entry point) */
+export function setPendingAlerts(alerts) {
+    pendingAlerts = alerts;
+}
+export function addOutputLine(bg, stream, line) {
+    bg.output.push({ stream, line, ts: Date.now() });
+    if (stream === "stdout")
+        bg.stdoutLineCount++;
+    else
+        bg.stderrLineCount++;
+    if (bg.output.length > MAX_BUFFER_LINES) {
+        const excess = bg.output.length - MAX_BUFFER_LINES;
+        bg.output.splice(0, excess);
+        // Adjust the read cursor so incremental delivery stays correct
+        bg.lastReadIndex = Math.max(0, bg.lastReadIndex - excess);
+    }
+}
+export function addEvent(bg, event) {
+    const ev = { ...event, timestamp: Date.now() };
+    bg.events.push(ev);
+    if (bg.events.length > MAX_EVENTS) {
+        bg.events.splice(0, bg.events.length - MAX_EVENTS);
+    }
+}
+export function pushAlert(bg, message) {
+    pendingAlerts.push(`[bg:${bg.id} ${bg.label}] ${message}`);
+}
+export function getInfo(p) {
+    return {
+        id: p.id,
+        label: p.label,
+        command: p.command,
+        cwd: p.cwd,
+        ownerSessionFile: p.ownerSessionFile,
+        persistAcrossSessions: p.persistAcrossSessions,
+        startedAt: p.startedAt,
+        alive: p.alive,
+        exitCode: p.exitCode,
+        signal: p.signal,
+        outputLines: p.output.length,
+        stdoutLines: p.stdoutLineCount,
+        stderrLines: p.stderrLineCount,
+        status: p.status,
+        processType: p.processType,
+        ports: p.ports,
+        urls: p.urls,
+        group: p.group,
+        restartCount: p.restartCount,
+        uptime: formatUptime(Date.now() - p.startedAt),
+        recentErrorCount: p.recentErrors.length,
+        recentWarningCount: p.recentWarnings.length,
+        eventCount: p.events.length,
+    };
+}
+// ── Process Type Detection ─────────────────────────────────────────────────
+export function detectProcessType(command) {
+    const cmd = command.toLowerCase();
+    // Server patterns
+    if (/\b(serve|server|dev|start)\b/.test(cmd) &&
+        /\b(npm|yarn|pnpm|bun|node|next|vite|nuxt|astro|remix|gatsby|uvicorn|flask|django|rails|cargo)\b/.test(cmd))
+        return "server";
+    if (/\b(uvicorn|gunicorn|flask\s+run|manage\.py\s+runserver|rails\s+s)\b/.test(cmd))
+        return "server";
+    if (/\b(http-server|live-server|serve)\b/.test(cmd))
+        return "server";
+    // Build patterns
+    if (/\b(build|compile|make|tsc|webpack|rollup|esbuild|swc)\b/.test(cmd)) {
+        if (/\b(watch|--watch|-w)\b/.test(cmd))
+            return "watcher";
+        return "build";
+    }
+    // Test patterns
+    if (/\b(test|jest|vitest|mocha|pytest|cargo\s+test|go\s+test|rspec)\b/.test(cmd))
+        return "test";
+    // Watcher patterns
+    if (/\b(watch|nodemon|chokidar|fswatch|inotifywait)\b/.test(cmd))
+        return "watcher";
+    return "generic";
+}
+// ── Process Start ──────────────────────────────────────────────────────────
+export function startProcess(opts) {
+    const id = randomUUID().slice(0, 8);
+    const processType = opts.type || detectProcessType(opts.command);
+    const env = { ...process.env, ...(opts.env || {}) };
+    const { shell, args: shellArgs } = getShellConfig();
+    // Shell sessions default to the user's shell if no command specified
+    const command = processType === "shell" && !opts.command ? shell : opts.command;
+    const proc = spawn(shell, [...shellArgs, sanitizeCommand(command)], {
+        cwd: opts.cwd,
+        stdio: ["pipe", "pipe", "pipe"],
+        env,
+        detached: process.platform !== "win32",
+    });
+    const bg = {
+        id,
+        label: opts.label || command.slice(0, 60),
+        command,
+        cwd: opts.cwd,
+        ownerSessionFile: opts.ownerSessionFile ?? null,
+        persistAcrossSessions: opts.persistAcrossSessions ?? false,
+        startedAt: Date.now(),
+        proc,
+        output: [],
+        exitCode: null,
+        signal: null,
+        alive: true,
+        lastReadIndex: 0,
+        processType,
+        status: "starting",
+        ports: [],
+        urls: [],
+        recentErrors: [],
+        recentWarnings: [],
+        events: [],
+        readyPattern: opts.readyPattern || null,
+        readyPort: opts.readyPort || null,
+        wasReady: false,
+        group: opts.group || null,
+        lastErrorCount: 0,
+        lastWarningCount: 0,
+        commandHistory: [],
+        lineDedup: new Map(),
+        totalRawLines: 0,
+        stdoutLineCount: 0,
+        stderrLineCount: 0,
+        envKeys: Object.keys(opts.env || {}),
+        restartCount: 0,
+        startConfig: {
+            command,
+            cwd: opts.cwd,
+            label: opts.label || command.slice(0, 60),
+            processType,
+            ownerSessionFile: opts.ownerSessionFile ?? null,
+            persistAcrossSessions: opts.persistAcrossSessions ?? false,
+            readyPattern: opts.readyPattern || null,
+            readyPort: opts.readyPort || null,
+            group: opts.group || null,
+        },
+    };
+    addEvent(bg, { type: "started", detail: `Process started: ${command.slice(0, 100)}` });
+    proc.stdout?.on("data", (chunk) => {
+        const lines = chunk.toString().split("\n");
+        for (const line of lines) {
+            if (line.length > 0) {
+                addOutputLine(bg, "stdout", line);
+                analyzeLine(bg, line, "stdout");
+            }
+        }
+    });
+    proc.stderr?.on("data", (chunk) => {
+        const lines = chunk.toString().split("\n");
+        for (const line of lines) {
+            if (line.length > 0) {
+                addOutputLine(bg, "stderr", line);
+                analyzeLine(bg, line, "stderr");
+            }
+        }
+    });
+    proc.on("exit", (code, sig) => {
+        restoreWindowsVTInput();
+        bg.alive = false;
+        bg.exitCode = code;
+        bg.signal = sig ?? null;
+        if (code === 0) {
+            bg.status = "exited";
+            addEvent(bg, { type: "exited", detail: `Exited cleanly (code 0)` });
+        }
+        else {
+            bg.status = "crashed";
+            const lastErrors = bg.recentErrors.slice(-3).join("; ");
+            const detail = `Crashed with code ${code}${sig ? ` (signal ${sig})` : ""}${lastErrors ? ` — ${lastErrors}` : ""}`;
+            addEvent(bg, {
+                type: "crashed",
+                detail,
+                data: { exitCode: code, signal: sig, lastErrors: bg.recentErrors.slice(-5) },
+            });
+            pushAlert(bg, `CRASHED (code ${code})${lastErrors ? `: ${lastErrors.slice(0, 120)}` : ""}`);
+        }
+    });
+    proc.on("error", (err) => {
+        bg.alive = false;
+        bg.status = "crashed";
+        addOutputLine(bg, "stderr", `[spawn error] ${err.message}`);
+        addEvent(bg, { type: "crashed", detail: `Spawn error: ${err.message}` });
+        pushAlert(bg, `spawn error: ${err.message}`);
+    });
+    // Port probing for server-type processes
+    if (bg.readyPort) {
+        startPortProbing(bg, bg.readyPort, opts.readyTimeout);
+    }
+    // Shell sessions are ready immediately after spawn
+    if (bg.processType === "shell") {
+        setTimeout(() => {
+            if (bg.alive && bg.status === "starting") {
+                transitionToReady(bg, "Shell session initialized");
+            }
+        }, 200);
+    }
+    processes.set(id, bg);
+    return bg;
+}
+// ── Process Kill ───────────────────────────────────────────────────────────
+export function killProcess(id, sig = "SIGTERM") {
+    const bg = processes.get(id);
+    if (!bg)
+        return false;
+    if (!bg.alive)
+        return true;
+    try {
+        if (process.platform === "win32") {
+            // Windows: use taskkill /F /T to force-kill the entire process tree.
+            // process.kill(-pid) (Unix process groups) does not work on Windows.
+            if (bg.proc.pid) {
+                const result = spawnSync("taskkill", ["/F", "/T", "/PID", String(bg.proc.pid)], {
+                    timeout: 5000,
+                    encoding: "utf-8",
+                });
+                if (result.status !== 0 && result.status !== 128) {
+                    // taskkill failed — try the direct kill as fallback
+                    bg.proc.kill(sig);
+                }
+            }
+            else {
+                bg.proc.kill(sig);
+            }
+        }
+        else {
+            // Unix/macOS: kill the process group via negative PID
+            if (bg.proc.pid) {
+                try {
+                    process.kill(-bg.proc.pid, sig);
+                }
+                catch {
+                    bg.proc.kill(sig);
+                }
+            }
+            else {
+                bg.proc.kill(sig);
+            }
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ── Process Restart ────────────────────────────────────────────────────────
+export async function restartProcess(id) {
+    const old = processes.get(id);
+    if (!old)
+        return null;
+    const config = old.startConfig;
+    const restartCount = old.restartCount + 1;
+    // Kill old process
+    if (old.alive) {
+        killProcess(id, "SIGTERM");
+        await new Promise(r => setTimeout(r, 300));
+        if (old.alive) {
+            killProcess(id, "SIGKILL");
+            await new Promise(r => setTimeout(r, 200));
+        }
+    }
+    processes.delete(id);
+    // Start new one
+    const newBg = startProcess({
+        command: config.command,
+        cwd: config.cwd,
+        label: config.label,
+        type: config.processType,
+        ownerSessionFile: config.ownerSessionFile,
+        persistAcrossSessions: config.persistAcrossSessions,
+        readyPattern: config.readyPattern || undefined,
+        readyPort: config.readyPort || undefined,
+        group: config.group || undefined,
+    });
+    newBg.restartCount = restartCount;
+    return newBg;
+}
+// ── Group Operations ───────────────────────────────────────────────────────
+export function getGroupProcesses(group) {
+    return Array.from(processes.values()).filter(p => p.group === group);
+}
+export function getGroupStatus(group) {
+    const procs = getGroupProcesses(group);
+    const healthy = procs.length > 0 && procs.every(p => p.alive && (p.status === "ready" || p.status === "starting"));
+    return {
+        group,
+        healthy,
+        processes: procs.map(p => ({
+            id: p.id,
+            label: p.label,
+            status: p.status,
+            alive: p.alive,
+        })),
+    };
+}
+// ── Cleanup ────────────────────────────────────────────────────────────────
+export function pruneDeadProcesses() {
+    const now = Date.now();
+    for (const [id, bg] of processes) {
+        if (!bg.alive) {
+            const ttl = bg.processType === "shell" ? DEAD_PROCESS_TTL * 6 : DEAD_PROCESS_TTL;
+            if (now - bg.startedAt > ttl) {
+                processes.delete(id);
+            }
+        }
+    }
+}
+export function cleanupAll() {
+    for (const [id, bg] of processes) {
+        if (bg.alive)
+            killProcess(id, "SIGKILL");
+    }
+    processes.clear();
+}
+/**
+ * Kill all alive, non-persistent bg processes.
+ * Called between auto-mode units to prevent orphaned servers from
+ * keeping ports bound across task boundaries (#1209).
+ */
+export function killSessionProcesses() {
+    for (const [id, bg] of processes) {
+        if (bg.alive && !bg.persistAcrossSessions) {
+            killProcess(id, "SIGTERM");
+        }
+    }
+}
+async function waitForProcessExit(bg, timeoutMs) {
+    if (!bg.alive)
+        return true;
+    await new Promise((resolve) => {
+        const done = () => resolve();
+        const timer = setTimeout(done, timeoutMs);
+        bg.proc.once("exit", () => {
+            clearTimeout(timer);
+            resolve();
+        });
+    });
+    return !bg.alive;
+}
+export async function cleanupSessionProcesses(sessionFile, options) {
+    const graceMs = Math.max(0, options?.graceMs ?? 300);
+    const matches = Array.from(processes.values()).filter((bg) => bg.alive && !bg.persistAcrossSessions && bg.ownerSessionFile === sessionFile);
+    if (matches.length === 0)
+        return [];
+    for (const bg of matches) {
+        killProcess(bg.id, "SIGTERM");
+    }
+    if (graceMs > 0) {
+        await Promise.all(matches.map((bg) => waitForProcessExit(bg, graceMs)));
+    }
+    for (const bg of matches) {
+        if (bg.alive)
+            killProcess(bg.id, "SIGKILL");
+    }
+    return matches.map((bg) => bg.id);
+}
+// ── Persistence ────────────────────────────────────────────────────────────
+export function getManifestPath(cwd) {
+    const dir = join(cwd, ".bg-shell");
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    return join(dir, "manifest.json");
+}
+export function persistManifest(cwd) {
+    try {
+        const manifest = Array.from(processes.values())
+            .filter(p => p.alive)
+            .map(p => ({
+            id: p.id,
+            label: p.label,
+            command: p.command,
+            cwd: p.cwd,
+            ownerSessionFile: p.ownerSessionFile,
+            persistAcrossSessions: p.persistAcrossSessions,
+            startedAt: p.startedAt,
+            processType: p.processType,
+            group: p.group,
+            readyPattern: p.readyPattern,
+            readyPort: p.readyPort,
+            pid: p.proc.pid,
+        }));
+        writeFileSync(getManifestPath(cwd), JSON.stringify(manifest, null, 2));
+    }
+    catch { /* best effort */ }
+}
+export function loadManifest(cwd) {
+    try {
+        const path = getManifestPath(cwd);
+        if (existsSync(path)) {
+            return JSON.parse(readFileSync(path, "utf-8"));
+        }
+    }
+    catch { /* best effort */ }
+    return [];
+}

package/dist/resources/extensions/bg-shell/readiness-detector.js

@@ -0,0 +1,109 @@
+/**
+ * Readiness detection: port probing, pattern matching, wait-for-ready.
+ */
+import { createConnection } from "node:net";
+import { PORT_PROBE_TIMEOUT, READY_POLL_INTERVAL, DEFAULT_READY_TIMEOUT, } from "./types.js";
+import { addEvent, pushAlert } from "./process-manager.js";
+// ── Readiness Transition ───────────────────────────────────────────────────
+export function transitionToReady(bg, detail) {
+    bg.status = "ready";
+    bg.wasReady = true;
+    addEvent(bg, { type: "ready", detail });
+}
+// ── Port Probing ───────────────────────────────────────────────────────────
+export function probePort(port, host = "127.0.0.1") {
+    return new Promise((resolve) => {
+        const socket = createConnection({ port, host, timeout: PORT_PROBE_TIMEOUT }, () => {
+            socket.destroy();
+            resolve(true);
+        });
+        socket.on("error", () => {
+            socket.destroy();
+            resolve(false);
+        });
+        socket.on("timeout", () => {
+            socket.destroy();
+            resolve(false);
+        });
+    });
+}
+// ── Port Probing Loop ──────────────────────────────────────────────────────
+export function startPortProbing(bg, port, customTimeout) {
+    const timeout = customTimeout || DEFAULT_READY_TIMEOUT;
+    const interval = setInterval(async () => {
+        if (!bg.alive) {
+            clearInterval(interval);
+            const stderrLines = bg.output.filter(l => l.stream === "stderr").slice(-10).map(l => l.line);
+            const detail = `Process exited (code ${bg.exitCode}) before port ${port} opened${stderrLines.length > 0 ? ` — ${stderrLines.join("; ").slice(0, 200)}` : ""}`;
+            addEvent(bg, { type: "port_timeout", detail, data: { port, exitCode: bg.exitCode } });
+            return;
+        }
+        if (bg.status !== "starting") {
+            clearInterval(interval);
+            return;
+        }
+        const open = await probePort(port);
+        if (open) {
+            clearInterval(interval);
+            if (!bg.ports.includes(port))
+                bg.ports.push(port);
+            transitionToReady(bg, `Port ${port} is open`);
+            addEvent(bg, { type: "port_open", detail: `Port ${port} is open`, data: { port } });
+        }
+    }, READY_POLL_INTERVAL);
+    // Stop probing after timeout — transition to error state so the process
+    // doesn't stay in "starting" forever (fixes #428)
+    setTimeout(() => {
+        clearInterval(interval);
+        if (bg.alive && bg.status === "starting") {
+            const stderrLines = bg.output.filter(l => l.stream === "stderr").slice(-10).map(l => l.line);
+            const detail = `Port ${port} not open after ${timeout}ms${stderrLines.length > 0 ? ` — ${stderrLines.join("; ").slice(0, 200)}` : ""}`;
+            bg.status = "error";
+            addEvent(bg, { type: "port_timeout", detail, data: { port, timeout } });
+            pushAlert(bg, `Port ${port} readiness timeout after ${timeout / 1000}s`);
+        }
+    }, timeout);
+}
+// ── Wait for Ready ─────────────────────────────────────────────────────────
+export async function waitForReady(bg, timeout, signal) {
+    const start = Date.now();
+    while (Date.now() - start < timeout) {
+        if (signal?.aborted) {
+            return { ready: false, detail: "Cancelled" };
+        }
+        if (!bg.alive) {
+            const stderrLines = bg.output.filter(l => l.stream === "stderr").slice(-5).map(l => l.line);
+            const stderrContext = stderrLines.length > 0 ? `\nstderr:\n${stderrLines.join("\n").slice(0, 500)}` : "";
+            return {
+                ready: false,
+                detail: `Process exited before becoming ready (code ${bg.exitCode})${bg.recentErrors.length > 0 ? ` — ${bg.recentErrors.slice(-1)[0]}` : ""}${stderrContext}`,
+            };
+        }
+        if (bg.status === "error") {
+            const stderrLines = bg.output.filter(l => l.stream === "stderr").slice(-5).map(l => l.line);
+            const stderrContext = stderrLines.length > 0 ? `\nstderr:\n${stderrLines.join("\n").slice(0, 500)}` : "";
+            return {
+                ready: false,
+                detail: `Process entered error state${bg.readyPort ? ` (port ${bg.readyPort} never opened)` : ""}${stderrContext}`,
+            };
+        }
+        if (bg.status === "ready") {
+            return {
+                ready: true,
+                detail: bg.events.find(e => e.type === "ready")?.detail || "Process is ready",
+            };
+        }
+        await new Promise(r => setTimeout(r, READY_POLL_INTERVAL));
+    }
+    // Timeout — try port probe as last resort
+    if (bg.readyPort) {
+        const open = await probePort(bg.readyPort);
+        if (open) {
+            transitionToReady(bg, `Port ${bg.readyPort} is open (detected at timeout)`);
+            return { ready: true, detail: `Port ${bg.readyPort} is open` };
+        }
+    }
+    const stderrLines = bg.output.filter(l => l.stream === "stderr").slice(-5).map(l => l.line);
+    const stderrContext = stderrLines.length > 0 ? `\nstderr:\n${stderrLines.join("\n").slice(0, 500)}` : "";
+    return { ready: false, detail: `Timed out after ${timeout}ms waiting for ready signal${stderrContext}` };
+}

package/dist/resources/extensions/bg-shell/types.js

@@ -0,0 +1,96 @@
+/**
+ * Shared types, constants, and pattern databases for the bg-shell extension.
+ */
+// ── Constants ──────────────────────────────────────────────────────────────
+export const MAX_BUFFER_LINES = 5000;
+export const MAX_EVENTS = 200;
+export const DEAD_PROCESS_TTL = 10 * 60 * 1000;
+/** Maximum unique entries in the per-process lineDedup Map before LRU eviction. */
+export const LINE_DEDUP_MAX = 500;
+export const PORT_PROBE_TIMEOUT = 500;
+export const READY_POLL_INTERVAL = 250;
+export const DEFAULT_READY_TIMEOUT = 30000;
+// ── Pattern Databases ──────────────────────────────────────────────────────
+/** Patterns that indicate a process is ready/listening */
+export const READINESS_PATTERNS = [
+    // Node/JS servers
+    /listening\s+on\s+(?:port\s+)?(\d+)/i,
+    /server\s+(?:is\s+)?(?:running|started|listening)\s+(?:at|on)\s+/i,
+    /ready\s+(?:in|on|at)\s+/i,
+    /started\s+(?:server\s+)?on\s+/i,
+    // Next.js / Vite / etc
+    /Local:\s*https?:\/\//i,
+    /➜\s+Local:\s*/i,
+    /compiled\s+(?:successfully|client\s+and\s+server)/i,
+    // Python
+    /running\s+on\s+https?:\/\//i,
+    /Uvicorn\s+running/i,
+    /Development\s+server\s+is\s+running/i,
+    // Generic
+    /press\s+ctrl[\-+]c\s+to\s+(?:quit|stop)/i,
+    /watching\s+for\s+(?:file\s+)?changes/i,
+    /build\s+(?:completed|succeeded|finished)/i,
+];
+/** Patterns that indicate errors */
+export const ERROR_PATTERNS = [
+    /\berror\b[\s:[\](]/i,
+    /\bERROR\b/,
+    /\bfailed\b/i,
+    /\bFAILED\b/,
+    /\bfatal\b/i,
+    /\bFATAL\b/,
+    /\bexception\b/i,
+    /\bpanic\b/i,
+    /\bsegmentation\s+fault\b/i,
+    /\bsyntax\s*error\b/i,
+    /\btype\s*error\b/i,
+    /\breference\s*error\b/i,
+    /Cannot\s+find\s+module/i,
+    /Module\s+not\s+found/i,
+    /ENOENT/,
+    /EACCES/,
+    /EADDRINUSE/,
+    /TS\d{4,5}:/, // TypeScript errors
+    /E\d{4,5}:/, // Rust errors
+    /\[ERROR\]/,
+    /✖|✗|❌/, // Common error symbols
+];
+/** Patterns that indicate warnings */
+export const WARNING_PATTERNS = [
+    /\bwarning\b[\s:[\](]/i,
+    /\bWARN(?:ING)?\b/,
+    /\bdeprecated\b/i,
+    /\bDEPRECATED\b/,
+    /⚠️?/,
+    /\[WARN\]/,
+];
+/** Patterns to extract URLs */
+export const URL_PATTERN = /https?:\/\/[^\s"'<>)\]]+/gi;
+/** Patterns to extract port numbers from "listening" messages */
+export const PORT_PATTERN = /(?:port|listening\s+on|:)\s*(\d{2,5})\b/gi;
+/** Patterns indicating test results */
+export const TEST_RESULT_PATTERNS = [
+    /(\d+)\s+(?:tests?\s+)?passed/i,
+    /(\d+)\s+(?:tests?\s+)?failed/i,
+    /Tests?:\s+(\d+)\s+passed/i,
+    /(\d+)\s+passing/i,
+    /(\d+)\s+failing/i,
+    /PASS|FAIL/,
+];
+/** Patterns indicating build completion */
+export const BUILD_COMPLETE_PATTERNS = [
+    /build\s+(?:completed|succeeded|finished|done)/i,
+    /compiled\s+(?:successfully|with\s+\d+\s+(?:error|warning))/i,
+    /✓\s+Built/i,
+    /webpack\s+\d+\.\d+/i,
+    /bundle\s+(?:is\s+)?ready/i,
+];
+// ── Compiled union regexes (single-pass alternatives to .some(p => p.test(line))) ──
+// Built once at module load — eliminates per-line RegExp construction overhead.
+export const ERROR_PATTERN_UNION = new RegExp(ERROR_PATTERNS.map(p => p.source).join("|"), "i");
+export const WARNING_PATTERN_UNION = new RegExp(WARNING_PATTERNS.map(p => p.source).join("|"), "i");
+export const READINESS_PATTERN_UNION = new RegExp(READINESS_PATTERNS.map(p => p.source).join("|"), "i");
+export const BUILD_COMPLETE_PATTERN_UNION = new RegExp(BUILD_COMPLETE_PATTERNS.map(p => p.source).join("|"), "i");
+export const TEST_RESULT_PATTERN_UNION = new RegExp(TEST_RESULT_PATTERNS.map(p => p.source).join("|"), "i");
+/** PORT_PATTERN compiled once for reuse in analyzeLine (needs exec, so must be re-created per call with /g) */
+export const PORT_PATTERN_SOURCE = PORT_PATTERN.source;

package/dist/resources/extensions/bg-shell/utilities.js

@@ -0,0 +1,50 @@
+/**
+ * Utility functions for the bg-shell extension.
+ */
+import { createRequire } from "node:module";
+import { existsSync } from "node:fs";
+// ── Windows VT Input Restoration ────────────────────────────────────────────
+// Child processes (esp. Git Bash / MSYS2) can strip the ENABLE_VIRTUAL_TERMINAL_INPUT
+// flag from the shared stdin console handle. Re-enable it after each child exits.
+let _vtHandles = null;
+export function restoreWindowsVTInput() {
+    if (process.platform !== "win32")
+        return;
+    try {
+        if (!_vtHandles) {
+            const cjsRequire = createRequire(import.meta.url);
+            const koffi = cjsRequire("koffi");
+            const k32 = koffi.load("kernel32.dll");
+            const GetStdHandle = k32.func("void* __stdcall GetStdHandle(int)");
+            const GetConsoleMode = k32.func("bool __stdcall GetConsoleMode(void*, _Out_ uint32_t*)");
+            const SetConsoleMode = k32.func("bool __stdcall SetConsoleMode(void*, uint32_t)");
+            const handle = GetStdHandle(-10);
+            _vtHandles = { GetConsoleMode, SetConsoleMode, handle };
+        }
+        const ENABLE_VIRTUAL_TERMINAL_INPUT = 0x0200;
+        const mode = new Uint32Array(1);
+        _vtHandles.GetConsoleMode(_vtHandles.handle, mode);
+        if (!(mode[0] & ENABLE_VIRTUAL_TERMINAL_INPUT)) {
+            _vtHandles.SetConsoleMode(_vtHandles.handle, mode[0] | ENABLE_VIRTUAL_TERMINAL_INPUT);
+        }
+    }
+    catch { /* koffi not available on non-Windows */ }
+}
+// ── Time Formatting ────────────────────────────────────────────────────────
+import { formatDuration } from "../shared/mod.js";
+export const formatUptime = formatDuration;
+export function formatTimeAgo(timestamp) {
+    return formatDuration(Date.now() - timestamp) + " ago";
+}
+export function resolveBgShellPersistenceCwd(cachedCwd, liveCwd = process.cwd(), pathExists = existsSync) {
+    const cachedIsAutoWorktree = /(?:^|[\\/])\.gsd[\\/]worktrees[\\/]/.test(cachedCwd);
+    if (!cachedIsAutoWorktree)
+        return cachedCwd;
+    if (cachedCwd === liveCwd && pathExists(cachedCwd))
+        return cachedCwd;
+    if (!pathExists(cachedCwd))
+        return liveCwd;
+    if (liveCwd !== cachedCwd)
+        return liveCwd;
+    return cachedCwd;
+}