@xerktech/claude-hud 0.1.31 → 0.1.33

package/dist/_broker/terminal.js

@@ -1,185 +0,0 @@
-import { spawn as defaultSpawn } from 'node:child_process';
-import { mkdtempSync, writeFileSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-/**
- * Cross-platform detached-terminal launcher. Dispatches on `process.platform`:
- *
- * - **Windows** (`win32`): tries `wt new-tab` first, falls back to a
- *   `Start-Process powershell` shell-out on ENOENT or any spawn failure.
- * - **macOS** (`darwin`): drives Terminal.app via `osascript`. Fails loudly
- *   if osascript spawn throws — the glasses launching screen surfaces the
- *   error and the user can tap-to-retry.
- * - **Linux** (`linux`): silent detached spawn of `claude-hud`. No GUI
- *   probing — headless servers, WSL, and minimal desktops are the common
- *   case in this product. The wrapper still attaches to the broker over
- *   HTTP/WS so the session is reachable from the glasses; the user just
- *   lacks a PC-side terminal window.
- *
- * Every path throws `terminal-launch-failed: <detail>` on failure so the
- * routes layer can return HTTP 500 with a uniform error shape.
- *
- * The spawned process inherits `opts.env` — the wrapper inside reads
- * `CLAUDE_HUD_PENDING_ID` to correlate its attached-registration POST with
- * the pending spawn record the broker is holding.
- */
-export async function launchTerminal(opts) {
-    switch (process.platform) {
-        case 'win32':
-            return launchWindows(opts);
-        case 'darwin':
-            return launchDarwin(opts);
-        case 'linux':
-            return launchLinux(opts);
-        default:
-            throw new Error(`terminal-launch-failed: unsupported platform ${process.platform}`);
-    }
-}
-function resolveSpawnImpl(opts) {
-    return (opts.spawnImpl ??
-        ((cmd, args, options) => {
-            const child = defaultSpawn(cmd, args, options);
-            return { pid: child.pid, unref: () => child.unref() };
-        }));
-}
-async function launchWindows(opts) {
-    const spawnImpl = resolveSpawnImpl(opts);
-    const env = { ...process.env, ...opts.env };
-    const extra = opts.extraArgs ?? [];
-    // wt new-tab is a layered-parsing nightmare for command bodies that contain
-    // `;` or `$env:` assignments:
-    //   - wt's CLI parser treats `;` as a subcommand separator (escape with \;).
-    //   - wt does NOT inherit env vars from the wt CLI invocation; the new tab
-    //     uses the wt server process's env (captured at first wt launch).
-    //   - Node child_process.spawn quotes argv on Windows in a way that often
-    //     mangles backslashes inside the -Command body.
-    // Instead of fighting all three, write a small .ps1 script to a temp file
-    // that (a) sets the spawn-correlation env vars and (b) invokes claude-hud,
-    // then have powershell run that file via -File. -File takes a single path
-    // and doesn't have the -Command quoting issues.
-    const scriptPath = writePsLaunchScript(opts);
-    // Attempt 1: Windows Terminal.
-    try {
-        const child = spawnImpl('wt', [
-            'new-tab',
-            '--startingDirectory',
-            opts.cwd,
-            '--title',
-            opts.label,
-            'powershell',
-            '-NoExit',
-            '-ExecutionPolicy',
-            'Bypass',
-            '-File',
-            scriptPath,
-        ], { detached: true, stdio: 'ignore', env });
-        child.unref();
-        return;
-    }
-    catch (err) {
-        const code = err.code;
-        if (code !== 'ENOENT' && !/not found|not recognized/i.test(err.message)) {
-            console.warn(`[terminal] wt launch failed: ${err.message}`);
-        }
-    }
-    // Attempt 2: PowerShell Start-Process fallback. Uses the same temp script.
-    const psTokens = [
-        "'-NoExit'",
-        "'-ExecutionPolicy'",
-        "'Bypass'",
-        "'-File'",
-        `'${scriptPath.replace(/'/g, "''")}'`,
-    ].join(',');
-    try {
-        const child = spawnImpl('powershell', [
-            '-NoProfile',
-            '-Command',
-            `Start-Process powershell -ArgumentList ${psTokens} -WorkingDirectory ${quoteShellArg(opts.cwd)}`,
-        ], { detached: true, stdio: 'ignore', env });
-        child.unref();
-        return;
-    }
-    catch (err) {
-        throw new Error(`terminal-launch-failed: ${err.message}`);
-    }
-    // Note: extraArgs is still referenced in writePsLaunchScript below; this
-    // void-ref keeps the linter happy on the rare path where neither attempt
-    // runs (both throws are propagated above).
-    void extra;
-}
-/**
- * Write a small .ps1 to %TEMP% that sets the spawn-correlation env vars and
- * then runs `claude-hud <extraArgs>`. PowerShell `-File` invokes it cleanly
- * without any of the `-Command` quoting / wt `;`-splitting hazards.
- */
-function writePsLaunchScript(opts) {
-    const lines = [];
-    for (const [k, v] of Object.entries(opts.env ?? {})) {
-        // PowerShell single-quoted strings: `'` is escaped by doubling.
-        lines.push(`$env:${k} = '${String(v).replace(/'/g, "''")}'`);
-    }
-    const cmdParts = ['claude-hud', ...(opts.extraArgs ?? [])];
-    lines.push(cmdParts.join(' '));
-    const body = lines.join('\r\n') + '\r\n';
-    const dir = mkdtempSync(join(tmpdir(), 'claude-hud-launch-'));
-    const scriptPath = join(dir, 'launch.ps1');
-    writeFileSync(scriptPath, body, 'utf8');
-    return scriptPath;
-}
-async function launchDarwin(opts) {
-    const spawnImpl = resolveSpawnImpl(opts);
-    const env = { ...process.env, ...opts.env };
-    // `do script` body is run in the new Terminal tab's shell. Quote every
-    // token so paths/args with spaces survive. Embedded single quotes in the
-    // cwd are escaped via the standard close-escape-quote-open trick inside
-    // quoteShellArg().
-    const cmd = ['claude-hud', ...(opts.extraArgs ?? [])].map(quoteShellArg).join(' ');
-    const script = `tell application "Terminal"
-  activate
-  do script "cd ${quoteShellArg(opts.cwd)} && ${cmd}"
-end tell`;
-    try {
-        const child = spawnImpl('osascript', ['-e', script], {
-            detached: true,
-            stdio: 'ignore',
-            env,
-        });
-        child.unref();
-        return;
-    }
-    catch (err) {
-        throw new Error(`terminal-launch-failed: ${err.message}`);
-    }
-}
-async function launchLinux(opts) {
-    const spawnImpl = resolveSpawnImpl(opts);
-    const env = { ...process.env, ...opts.env };
-    try {
-        const child = spawnImpl('claude-hud', opts.extraArgs ?? [], {
-            detached: true,
-            stdio: 'ignore',
-            cwd: opts.cwd,
-            env,
-        });
-        child.unref();
-        return;
-    }
-    catch (err) {
-        const code = err.code;
-        if (code === 'ENOENT') {
-            throw new Error('terminal-launch-failed: claude-hud not found on PATH');
-        }
-        throw new Error(`terminal-launch-failed: ${err.message}`);
-    }
-}
-/**
- * POSIX-shell single-quote escape: wrap `s` in single quotes and escape any
- * embedded single quote via the standard close-escape-quote-open sequence
- * (`'\''`). Safe for use inside both an osascript `do script` body (where
- * the inner shell parses the quotes) and a PowerShell `-WorkingDirectory`
- * argument (which uses POSIX-style single-quote rules on Windows too).
- */
-function quoteShellArg(s) {
-    return `'${s.replace(/'/g, "'\\''")}'`;
-}
-//# sourceMappingURL=terminal.js.map

package/dist/_broker/terminal.js.map

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