specrails-desktop 2.28.0 → 2.28.1

package/cli/dist/specrails-desktop.js

@@ -38,6 +38,7 @@ const fs_1 = __importDefault(require("fs"));
 // ---------------------------------------------------------------------------
 const DEFAULT_PORT = 4200;
 const DETECTION_TIMEOUT_MS = 500;
+const HTTP_REQUEST_TIMEOUT_MS = 15_000;
 exports.KNOWN_VERBS = new Set([
     'implement',
     'batch-implement',
@@ -242,7 +243,10 @@ function loadDesktopToken() {
     }
     return null;
 }
-function httpGet(url) {
+function requestTimeoutError(url, timeoutMs) {
+    return new Error(`Request to ${url} timed out after ${timeoutMs}ms`);
+}
+function httpGet(url, timeoutMs = HTTP_REQUEST_TIMEOUT_MS) {
     return new Promise((resolve, reject) => {
         const token = loadDesktopToken();
         const parsed = new URL(url);
@@ -260,10 +264,13 @@ function httpGet(url) {
             res.on('data', (chunk) => { body += chunk; });
             res.on('end', () => resolve({ status: res.statusCode ?? 0, body }));
         });
+        req.setTimeout(timeoutMs, () => {
+            req.destroy(requestTimeoutError(url, timeoutMs));
+        });
         req.on('error', reject);
     });
 }
-function httpPost(url, payload) {
+function httpPost(url, payload, timeoutMs = HTTP_REQUEST_TIMEOUT_MS) {
     return new Promise((resolve, reject) => {
         const data = JSON.stringify(payload);
         const urlObj = new URL(url);
@@ -286,6 +293,9 @@ function httpPost(url, payload) {
             res.on('data', (chunk) => { body += chunk; });
             res.on('end', () => resolve({ status: res.statusCode ?? 0, body }));
         });
+        req.setTimeout(timeoutMs, () => {
+            req.destroy(requestTimeoutError(url, timeoutMs));
+        });
         req.on('error', reject);
         req.write(data);
         req.end();
@@ -1138,5 +1148,5 @@ exports._internal = {
     httpGet, httpPost, formatJobDuration, formatJobStarted, printVersion, printHelp,
     handleStatus, handleJobs, handleDesktop, desktopStart, desktopStop, desktopStatus, desktopAdd, desktopRemove, desktopList, desktopServerPath,
     resolveProjectFromCwd, runViaWebManager, runDirect, isPortInUse, readPid, isProcessRunning, main,
-    isTTY, DESKTOP_PID_FILE, DESKTOP_LOG_FILE, EXIT_PATTERN, DEFAULT_PORT, DETECTION_TIMEOUT_MS,
+    isTTY, DESKTOP_PID_FILE, DESKTOP_LOG_FILE, EXIT_PATTERN, DEFAULT_PORT, DETECTION_TIMEOUT_MS, HTTP_REQUEST_TIMEOUT_MS,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specrails-desktop",
-  "version": "2.28.0",
+  "version": "2.28.1",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -37,7 +37,7 @@
     "check-core-compat": "tsx scripts/check-core-compat.ts",
     "test": "vitest run && tsx scripts/check-core-compat.ts",
     "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
+    "test:coverage": "vitest run --coverage --maxWorkers=1 --reporter=dot --bail=1",
     "test:client": "cd client && npx vitest run",
     "test:all": "vitest run && cd client && npx vitest run",
     "ci": "npm run typecheck && npm run check-core-compat && npm run test:coverage && cd client && npm run test:coverage"

package/server/dist/contract-refine-runner.js

@@ -163,17 +163,35 @@ function readRefineChildOutput(child, timeoutMs, kill = tree_kill_1.default) {
             resolve({ fullText, resultEvent, code: -1, timedOut: false });
             return;
         }
+        const stdout = child.stdout;
         let stderrBuf = '';
-        if (child.stderr) {
-            child.stderr.on('data', (chunk) => {
-                const s = typeof chunk === 'string' ? chunk : chunk.toString('utf-8');
-                stderrBuf += s;
-                if (stderrBuf.length > 8192)
-                    stderrBuf = stderrBuf.slice(-8192);
-            });
-        }
+        const onStderrData = (chunk) => {
+            const s = typeof chunk === 'string' ? chunk : chunk.toString('utf-8');
+            stderrBuf += s;
+            if (stderrBuf.length > 8192)
+                stderrBuf = stderrBuf.slice(-8192);
+        };
+        if (child.stderr)
+            child.stderr.on('data', onStderrData);
         let killEscalation = null;
-        const reader = (0, node_readline_1.createInterface)({ input: child.stdout, crlfDelay: Infinity });
+        const reader = (0, node_readline_1.createInterface)({ input: stdout, crlfDelay: Infinity });
+        let outputClosed = false;
+        const closeOutputReaders = () => {
+            if (outputClosed)
+                return;
+            outputClosed = true;
+            reader.removeAllListeners('line');
+            try {
+                reader.close();
+            }
+            catch { /* already closed */ }
+            if (child.stderr)
+                child.stderr.off('data', onStderrData);
+            if (!stdout.destroyed)
+                stdout.destroy();
+            if (child.stderr && !child.stderr.destroyed)
+                child.stderr.destroy();
+        };
         reader.on('line', (line) => {
             let parsed = null;
             try {
@@ -202,6 +220,7 @@ function readRefineChildOutput(child, timeoutMs, kill = tree_kill_1.default) {
             // BUG-PARSER-01: treeKill the whole subtree (SIGTERM) and SIGKILL-escalate
             // after a grace window so a signal-swallowing CLI tree is force-killed.
             killEscalation = escalateKill(child.pid, kill);
+            closeOutputReaders();
             if (!settled) {
                 settled = true;
                 resolve({ fullText, resultEvent, code: null, timedOut: true });
@@ -215,6 +234,7 @@ function readRefineChildOutput(child, timeoutMs, kill = tree_kill_1.default) {
                 clearTimeout(killEscalation);
                 killEscalation = null;
             }
+            closeOutputReaders();
             if (settled)
                 return;
             settled = true;
@@ -229,6 +249,7 @@ function readRefineChildOutput(child, timeoutMs, kill = tree_kill_1.default) {
                 clearTimeout(killEscalation);
                 killEscalation = null;
             }
+            closeOutputReaders();
             console.log(`[contract-refine-runner] child error: ${err.message}; stderr=${JSON.stringify(stderrBuf.slice(-2000))}`);
             if (settled)
                 return;

package/server/dist/explore-cwd-manager.js

@@ -20,7 +20,7 @@ const providers_1 = require("./providers");
  * provider behaviour (instructions file is adapter-driven: CLAUDE.md for
  * claude, AGENTS.md for codex).
  *
- * Layout under `~/.specrails/projects/<slug>/explore-cwd/`:
+ * Layout under `<specrails-home>/.specrails/projects/<slug>/explore-cwd/`:
  *   ├── <adapter.instructionsFilename>  — embedded mini-prompt, app-owned
  *   ├── project                          — symlink/junction → <project.path>
  *   └── project-path.txt                 — fallback when symlink creation fails
@@ -87,12 +87,15 @@ function renderExploreInstructions(projectName) {
 function renderExploreClaudeMd(projectName) {
     return renderExploreInstructions(projectName);
 }
+function homeDir() {
+    return process.env.SPECRAILS_REGISTRY_HOME || os_1.default.homedir();
+}
 /**
  * Compute the explore-cwd path for a project without touching the filesystem.
  * Used by the legacy-cwd env-var short-circuit and by tests.
  */
 function exploreCwdPathFor(slug, baseDir) {
-    const base = baseDir ?? path_1.default.join(os_1.default.homedir(), '.specrails', 'projects');
+    const base = baseDir ?? path_1.default.join(homeDir(), '.specrails', 'projects');
     return path_1.default.join(base, slug, 'explore-cwd');
 }
 /**
@@ -102,7 +105,7 @@ function exploreCwdPathFor(slug, baseDir) {
  * When SPECRAILS_EXPLORE_LEGACY_CWD=1 is set, returns `projectPath` directly
  * and performs no filesystem IO — used as the rollback escape hatch.
  *
- * Pass `baseDir` for tests to redirect away from the user's home directory.
+ * Pass `baseDir` for tests that need a specific projects directory.
  */
 function ensureExploreCwd(input, baseDir) {
     if (process.env.SPECRAILS_EXPLORE_LEGACY_CWD === '1') {

package/server/dist/headroom-manager.js

@@ -3,7 +3,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HeadroomManager = void 0;
+exports.HeadroomManager = exports.HEADROOM_MANAGED_PYTHON_VERSION = void 0;
+exports.getHeadroomManagedInstallPlan = getHeadroomManagedInstallPlan;
 const child_process_1 = require("child_process");
 const fs_1 = __importDefault(require("fs"));
 const os_1 = __importDefault(require("os"));
@@ -12,11 +13,15 @@ const desktop_db_1 = require("./desktop-db");
 const headroom_routing_1 = require("./headroom-routing");
 const STATE_KEY = 'plugins.headroom.state';
 const DEFAULT_PORT = 8787;
+exports.HEADROOM_MANAGED_PYTHON_VERSION = '3.12';
 function nowIso() {
     return new Date().toISOString();
 }
+function specrailsHome() {
+    return process.env.SPECRAILS_REGISTRY_HOME || os_1.default.homedir();
+}
 function toolRoot() {
-    return path_1.default.join(os_1.default.homedir(), '.specrails', 'tools');
+    return path_1.default.join(specrailsHome(), '.specrails', 'tools');
 }
 function uvToolDir() {
     return path_1.default.join(toolRoot(), 'uv', 'tools');
@@ -24,6 +29,15 @@ function uvToolDir() {
 function uvCacheDir() {
     return path_1.default.join(toolRoot(), 'uv', 'cache');
 }
+function uvPythonInstallDir() {
+    return path_1.default.join(toolRoot(), 'uv', 'python');
+}
+function uvPythonCacheDir() {
+    return path_1.default.join(toolRoot(), 'uv', 'python-cache');
+}
+function uvPythonBinDir() {
+    return path_1.default.join(toolRoot(), 'uv', 'python-bin');
+}
 function uvBinDir() {
     return path_1.default.join(toolRoot(), 'bin');
 }
@@ -152,6 +166,41 @@ function classifyInstallFailure(output, command) {
     }
     return issue('unknown', output, command);
 }
+function getHeadroomManagedInstallPlan() {
+    return {
+        pythonVersion: exports.HEADROOM_MANAGED_PYTHON_VERSION,
+        pythonInstallArgs: [
+            'python',
+            'install',
+            exports.HEADROOM_MANAGED_PYTHON_VERSION,
+            '--managed-python',
+        ],
+        toolInstallArgs: [
+            'tool',
+            'install',
+            '--python',
+            exports.HEADROOM_MANAGED_PYTHON_VERSION,
+            '--managed-python',
+            '--force',
+            'headroom-ai[all]',
+        ],
+        env: {
+            UV_TOOL_DIR: uvToolDir(),
+            UV_TOOL_BIN_DIR: uvBinDir(),
+            UV_CACHE_DIR: uvCacheDir(),
+            UV_PYTHON: exports.HEADROOM_MANAGED_PYTHON_VERSION,
+            UV_MANAGED_PYTHON: 'true',
+            UV_PYTHON_DOWNLOADS: 'automatic',
+            UV_PYTHON_PREFERENCE: 'only-managed',
+            UV_PYTHON_INSTALL_DIR: uvPythonInstallDir(),
+            UV_PYTHON_CACHE_DIR: uvPythonCacheDir(),
+            UV_PYTHON_BIN_DIR: uvPythonBinDir(),
+            UV_PYTHON_NO_REGISTRY: 'true',
+            UV_PYTHON_INSTALL_REGISTRY: 'false',
+            UV_NO_PROGRESS: '1',
+        },
+    };
+}
 function classifyProxyFailure(output, command) {
     const lower = output.toLowerCase();
     if (lower.includes('address already in use') ||
@@ -334,18 +383,32 @@ class HeadroomManager {
         fs_1.default.mkdirSync(uvToolDir(), { recursive: true });
         fs_1.default.mkdirSync(uvCacheDir(), { recursive: true });
         fs_1.default.mkdirSync(uvBinDir(), { recursive: true });
-        const args = ['tool', 'install', 'headroom-ai[all]', '--force'];
-        const command = `${uv} ${args.join(' ')}`;
-        const logs = [`Running ${command}`];
+        fs_1.default.mkdirSync(uvPythonInstallDir(), { recursive: true });
+        fs_1.default.mkdirSync(uvPythonCacheDir(), { recursive: true });
+        fs_1.default.mkdirSync(uvPythonBinDir(), { recursive: true });
+        const plan = getHeadroomManagedInstallPlan();
+        const pythonCommand = `${uv} ${plan.pythonInstallArgs.join(' ')}`;
+        const installCommand = `${uv} ${plan.toolInstallArgs.join(' ')}`;
+        const logs = [
+            `Ensuring Headroom Python runtime (CPython ${plan.pythonVersion})`,
+            `Running ${pythonCommand}`,
+        ];
         this.emit('installing', logs[0]);
-        const result = await this.runCommand(uv, args, {
-            UV_TOOL_DIR: uvToolDir(),
-            UV_TOOL_BIN_DIR: uvBinDir(),
-            UV_CACHE_DIR: uvCacheDir(),
-            UV_NO_PROGRESS: '1',
-        }, logs);
+        this.emit('installing', logs[1]);
+        const pythonResult = await this.runCommand(uv, plan.pythonInstallArgs, plan.env, logs);
+        if (pythonResult.code !== 0) {
+            const failure = classifyInstallFailure(logs.join('\n'), pythonCommand);
+            this.updatePersisted({ lastIssue: failure });
+            this.emit('failed', failure.title);
+            return { ok: false, state: this.getState(), issue: failure, logs };
+        }
+        logs.push(`Installing Headroom with managed CPython ${plan.pythonVersion}`);
+        logs.push(`Running ${installCommand}`);
+        this.emit('installing', logs[logs.length - 2]);
+        this.emit('installing', logs[logs.length - 1]);
+        const result = await this.runCommand(uv, plan.toolInstallArgs, plan.env, logs);
         if (result.code !== 0) {
-            const failure = classifyInstallFailure(logs.join('\n'), command);
+            const failure = classifyInstallFailure(logs.join('\n'), installCommand);
             this.updatePersisted({ lastIssue: failure });
             this.emit('failed', failure.title);
             return { ok: false, state: this.getState(), issue: failure, logs };
@@ -353,7 +416,7 @@ class HeadroomManager {
         const exe = this.resolveHeadroomInstall(null, false)?.path ?? null;
         const version = exe ? this.readHeadroomVersion(exe) : null;
         if (!exe || !version) {
-            const failure = issue('headroom_not_found_after_install', logs.join('\n'), command);
+            const failure = issue('headroom_not_found_after_install', logs.join('\n'), installCommand);
             this.updatePersisted({ lastIssue: failure });
             this.emit('failed', failure.title);
             return { ok: false, state: this.getState(), issue: failure, logs };
@@ -494,6 +557,9 @@ class HeadroomManager {
             toolDir: uvToolDir(),
             binDir: uvBinDir(),
             cacheDir: uvCacheDir(),
+            pythonInstallDir: uvPythonInstallDir(),
+            pythonBinDir: uvPythonBinDir(),
+            pythonCacheDir: uvPythonCacheDir(),
             proxyTail: this.proxyTail.slice(-4000),
             installSource: state.installSource,
             detectedRoutes: state.detectedRoutes,

package/server/dist/terminal-shell-integration.js

@@ -62,8 +62,11 @@ function warnShimMissingOnce(name) {
     _warnedShims.add(name);
     console.warn(`[terminal-shell-integration] bundled shim not found: ${name} — shell integration disabled for this shell`);
 }
+function specrailsHome() {
+    return process.env.SPECRAILS_REGISTRY_HOME || os_1.default.homedir();
+}
 function projectsRoot() {
-    return path_1.default.join(os_1.default.homedir(), '.specrails', 'projects');
+    return path_1.default.join(specrailsHome(), '.specrails', 'projects');
 }
 function shimDirFor(projectSlug, sessionId) {
     return path_1.default.join(projectsRoot(), projectSlug, 'terminals', sessionId);