specrails-desktop 2.27.0 → 2.28.0

package/server/dist/headroom-routing.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setHeadroomRoutingState = setHeadroomRoutingState;
+exports.getHeadroomRoutingState = getHeadroomRoutingState;
+exports.providerForBinary = providerForBinary;
+exports.applyHeadroomEnvForBinary = applyHeadroomEnvForBinary;
+exports.withHeadroomSpawnEnv = withHeadroomSpawnEnv;
+const DEFAULT_PORT = 8787;
+let routingState = {
+    port: DEFAULT_PORT,
+    activeProviders: {},
+};
+function setHeadroomRoutingState(next) {
+    routingState = {
+        port: Number.isInteger(next.port) ? next.port : DEFAULT_PORT,
+        activeProviders: { ...next.activeProviders },
+    };
+}
+function getHeadroomRoutingState() {
+    return {
+        port: routingState.port,
+        activeProviders: { ...routingState.activeProviders },
+    };
+}
+function providerForBinary(binary) {
+    const name = binary.toLowerCase().replace(/\.cmd$|\.exe$/, '');
+    if (name === 'codex')
+        return 'codex';
+    if (name === 'claude')
+        return 'claude';
+    return null;
+}
+function applyHeadroomEnvForBinary(binary, env) {
+    const provider = providerForBinary(binary);
+    if (!provider || !routingState.activeProviders[provider])
+        return env ?? process.env;
+    const base = `http://127.0.0.1:${routingState.port}`;
+    const merged = { ...(env ?? process.env) };
+    if (provider === 'codex') {
+        merged.OPENAI_BASE_URL = `${base}/v1`;
+    }
+    else if (provider === 'claude') {
+        merged.ANTHROPIC_BASE_URL = base;
+    }
+    merged.HEADROOM_PORT = String(routingState.port);
+    return merged;
+}
+function withHeadroomSpawnEnv(binary, options = {}) {
+    return {
+        ...options,
+        env: applyHeadroomEnvForBinary(binary, options.env),
+    };
+}

package/server/dist/index.js

@@ -29,6 +29,8 @@ const agent_chat_router_1 = require("./agent-chat-router");
 const agent_chat_registry_1 = require("./agent-chat-registry");
 const browser_playwright_1 = require("./browser-playwright");
 const telemetry_receiver_1 = require("./telemetry-receiver");
+const headroom_manager_1 = require("./headroom-manager");
+const global_plugins_router_1 = require("./global-plugins-router");
 const telemetry_compactor_1 = require("./telemetry-compactor");
 const framework_manager_1 = require("./framework-manager");
 const artifact_registry_1 = require("./artifact-registry");
@@ -537,6 +539,11 @@ function applyPtyWsRateLimiting(ws) {
         mcpManager.start().catch((err) => console.error('[mcp] boot start failed:', err));
     }
     // ─── App-global agent chat (drives the app via its own MCP) ────────────────
+    const headroomManager = new headroom_manager_1.HeadroomManager(registry.desktopDb, broadcast, () => registry.installedProvidersUnion().filter((provider) => provider === 'codex' || provider === 'claude'));
+    app.use('/api/global-plugins', (0, global_plugins_router_1.createGlobalPluginsRouter)(headroomManager));
+    headroomManager.startActiveProxyOnBoot().catch((err) => {
+        console.error('[headroom] boot start failed:', err);
+    });
     const agentChatManager = new agent_chat_manager_1.AgentChatManager(broadcast, registry.desktopDb, port, registry);
     _agentChatManager = agentChatManager;
     // Publish the instance to the process-wide registry so the rails layer can

package/server/dist/mcp/guide.js

@@ -149,6 +149,9 @@ heading inside the description); \`labels\`; \`priority\`. Spec content is Engli
 - \`specrails_jobs(spawn, command)\` bypasses rails and enqueues an arbitrary
   slash-command job (e.g. \`/specrails:implement #5 --yes\`); \`queue\`, \`pause\`,
   \`resume\`, \`reorder\`, \`priority\` manage the queue.
+- Long-running shell commands launched with \`specrails_jobs(background_start)\`
+  create chat chips; use \`specrails_jobs(background_logs, pid)\` to read bounded
+  stdout/stderr tail when a chip exits or fails.
 
 ## Async results (IMPORTANT)
 

package/server/dist/mcp/tools/jobs.js

@@ -8,6 +8,7 @@ const zod_1 = require("zod");
 const types_1 = require("./types");
 const path_1 = __importDefault(require("path"));
 const transient_children_1 = require("../../transient-children");
+const loop_runs_store_1 = require("../../loop-runs-store");
 function resolveBackgroundCwd(projectRoot, cwd) {
     const resolved = path_1.default.resolve(projectRoot, cwd && cwd.trim() ? cwd : '.');
     const root = path_1.default.resolve(projectRoot);
@@ -24,11 +25,6 @@ function backgroundHooks(broadcast) {
             projectId: process.projectId,
             timestamp: new Date().toISOString(),
         }),
-        onOutput: (event) => broadcast({
-            type: 'background_process.output',
-            ...event,
-            timestamp: new Date().toISOString(),
-        }),
         onExited: (process) => broadcast({
             type: 'background_process.exited',
             process,
@@ -37,6 +33,20 @@ function backgroundHooks(broadcast) {
         }),
     };
 }
+function backgroundStartBusyReason(projectCtx) {
+    const activeJobId = typeof projectCtx.queueManager?.getActiveJobId === 'function' ? projectCtx.queueManager.getActiveJobId() : null;
+    if (activeJobId)
+        return `job ${activeJobId} is still running`;
+    try {
+        const runningLoops = (0, loop_runs_store_1.listRunningLoopRuns)(projectCtx.db, projectCtx.project.id);
+        if (runningLoops.length > 0)
+            return `loop run ${runningLoops[0].id} is still running`;
+    }
+    catch {
+        // Some unit harnesses stub the DB narrowly; absence of loop metadata is not a blocker.
+    }
+    return null;
+}
 /**
  * Jobs domain facade. Maps every in-scope jobs/queue action to its REST
  * endpoint on the loopback API (server/project-router-jobs.ts, plus the
@@ -54,7 +64,7 @@ function jobsTools() {
             title: 'Jobs & Queue',
             description: 'Manage a project\'s AI-pipeline job queue and individual jobs. ' +
                 'Actions: list, get, queue, spawn (ai-spawn — enqueues an arbitrary slash-command job, returns {jobId,position}, async; from the in-app agent chat the engine defaults to your conversation\'s provider — pass aiEngine to override), ' +
-                'background_start (operate-level shell command tied to the current agent chat; requires explicit user confirmation before use), background_kill, ' +
+                'background_start (operate-level shell command tied to the current agent chat; requires confirmed:true after explicit user confirmation before use), background_logs, background_kill, ' +
                 'cancel (destructive — cancels a running/queued job or deletes a terminal one), ' +
                 'purge (destructive — bulk-delete persisted job rows in a date range), ' +
                 'pause / resume (queue), reorder (queued-job order), priority (change a queued job\'s priority), ' +
@@ -100,6 +110,7 @@ function jobsTools() {
                     'interactive_turn',
                     'finalize',
                     'background_start',
+                    'background_logs',
                     'background_kill',
                 ])
                     .describe('Operation to perform'),
@@ -110,7 +121,7 @@ function jobsTools() {
                     .optional()
                     .describe('Job id (for get / cancel / priority / diagnostic / interactive_turn / finalize)'),
                 // ── list / export pagination + filters ──
-                limit: zod_1.z.number().optional().describe('Page size for list (1-200, default 50) / activity (1-100, default 50)'),
+                limit: zod_1.z.number().optional().describe('Page size for list (1-200, default 50) / activity (1-100, default 50); background_logs returns the last N buffered log lines'),
                 offset: zod_1.z.number().optional().describe('Page offset for list'),
                 status: zod_1.z.string().optional().describe('Filter by job status (list)'),
                 from: zod_1.z.string().optional().describe('ISO date lower bound (list / export / purge)'),
@@ -136,9 +147,11 @@ function jobsTools() {
                     .describe('reorder: exact set of currently-queued job ids in the desired order; compare: exactly 2 job ids'),
                 // ── interactive_turn ──
                 text: zod_1.z.string().optional().describe('Prompt text for interactive_turn'),
-                chatId: zod_1.z.string().optional().describe('Agent chat conversation id for background_start/background_kill ownership; defaults to the in-app agent conversation that called the tool'),
+                chatId: zod_1.z.string().optional().describe('Agent chat conversation id for background_start/background_logs/background_kill ownership; defaults to the in-app agent conversation that called the tool'),
                 cwd: zod_1.z.string().optional().describe('Optional cwd for background_start; resolved inside the selected project root'),
-                pid: zod_1.z.number().optional().describe('Background process pid for background_kill'),
+                pid: zod_1.z.number().optional().describe('Background process pid for background_logs/background_kill'),
+                confirmed: zod_1.z.boolean().optional().describe('background_start only: must be true after explicit user confirmation for this exact command'),
+                allowWhileBusy: zod_1.z.boolean().optional().describe('background_start only: override active job/loop guard after explicit user confirmation'),
                 // ── export ──
                 format: zod_1.z.enum(['json', 'csv']).optional().describe('Export format (default json)'),
                 // ── default_spec_model ──
@@ -314,10 +327,16 @@ function jobsTools() {
                         const command = args.command;
                         if (!command || !command.trim())
                             throw new Error('background_start requires a "command".');
+                        if (args.confirmed !== true)
+                            throw new Error('background_start requires confirmed:true after explicit user confirmation for this exact command.');
                         const chatId = args.chatId ?? ctx.originConversationId ?? undefined;
                         if (!chatId || !chatId.trim())
                             throw new Error('background_start requires a "chatId".');
                         const projectCtx = (0, types_1.requireProject)(ctx, args.projectId);
+                        const busyReason = backgroundStartBusyReason(projectCtx);
+                        if (busyReason && args.allowWhileBusy !== true) {
+                            throw new Error(`background_start refused because ${busyReason}. Wait for it to finish, or pass allowWhileBusy:true only after explicit user confirmation.`);
+                        }
                         const cwd = resolveBackgroundCwd(projectCtx.project.path, args.cwd);
                         const process = (0, transient_children_1.startBackgroundProcess)(command.trim(), cwd, chatId.trim(), projectCtx.project.id, backgroundHooks(ctx.broadcast));
                         return { ok: true, process };
@@ -335,6 +354,30 @@ function jobsTools() {
                             throw new Error('background_kill requires a registered pid in the same project/chat.');
                         return { ok: true, pid, status: 'killing' };
                     }
+                    case 'background_logs': {
+                        const pid = args.pid;
+                        if (typeof pid !== 'number' || !Number.isFinite(pid))
+                            throw new Error('background_logs requires a numeric "pid".');
+                        const chatId = args.chatId ?? ctx.originConversationId ?? undefined;
+                        if (!chatId || !chatId.trim())
+                            throw new Error('background_logs requires a "chatId".');
+                        const projectCtx = (0, types_1.requireProject)(ctx, args.projectId);
+                        const limit = typeof args.limit === 'number' && Number.isFinite(args.limit) ? args.limit : undefined;
+                        const logs = (0, transient_children_1.getBackgroundProcessLogs)(pid, {
+                            projectId: projectCtx.project.id,
+                            chatId: chatId.trim(),
+                            ...(limit !== undefined ? { limit } : {}),
+                        });
+                        if (!logs)
+                            throw new Error('background_logs requires a registered pid in the same project/chat; logs may have expired.');
+                        return {
+                            ok: true,
+                            ...logs,
+                            hint: logs.lines.length > 0
+                                ? 'Inspect stdout/stderr to explain why the background process exited or failed.'
+                                : 'No stdout/stderr lines have been captured yet; the process may not have emitted newline-terminated output.',
+                        };
+                    }
                     default:
                         throw new Error(`Unknown action "${action}".`);
                 }

package/server/dist/path-resolver.js

@@ -105,7 +105,14 @@ function resolveBundledBinDirs(runtimesPath) {
     else if (fileExists(path_1.default.join(runtimesPath, 'git', 'bin', 'git'))) {
         gitBinDir = path_1.default.join(runtimesPath, 'git', 'bin');
     }
-    return { nodeBinDir, gitBinDir };
+    const uvBinDir = isWin
+        ? (fileExists(path_1.default.join(runtimesPath, 'uv', 'uv.exe')) ? path_1.default.join(runtimesPath, 'uv')
+            : fileExists(path_1.default.join(runtimesPath, 'uv', 'bin', 'uv.exe')) ? path_1.default.join(runtimesPath, 'uv', 'bin')
+                : null)
+        : (fileExists(path_1.default.join(runtimesPath, 'uv', 'bin', 'uv')) ? path_1.default.join(runtimesPath, 'uv', 'bin')
+            : fileExists(path_1.default.join(runtimesPath, 'uv', 'uv')) ? path_1.default.join(runtimesPath, 'uv')
+                : null);
+    return { nodeBinDir, gitBinDir, uvBinDir };
 }
 /**
  * Bin dir of the bundled GitHub CLI (`runtimes/gh/bin/gh[.exe]`), or null.
@@ -266,7 +273,7 @@ function resolveStartupPathBase() {
     if (process.env.SPECRAILS_IS_DESKTOP === '1') {
         const runtimesPath = process.env.SPECRAILS_BUNDLED_RUNTIMES_PATH;
         if (runtimesPath) {
-            const { nodeBinDir, gitBinDir } = resolveBundledBinDirs(runtimesPath);
+            const { nodeBinDir, gitBinDir, uvBinDir } = resolveBundledBinDirs(runtimesPath);
             // Activate the bundle only when BOTH node and git are present. A partial
             // bundle (one tool present, the other missing — a botched extraction) is
             // treated as NOT active so the full system fallback (fast-path + login-shell)
@@ -275,7 +282,7 @@ function resolveStartupPathBase() {
             if (nodeBinDir && gitBinDir) {
                 const inherited = splitPath(process.env.PATH);
                 const inheritedSet = new Set(inherited);
-                const bundledDirs = [nodeBinDir, gitBinDir].filter((d) => !inheritedSet.has(d));
+                const bundledDirs = [nodeBinDir, gitBinDir, uvBinDir].filter((d) => !!d && !inheritedSet.has(d));
                 bundledDirs.forEach((d) => inheritedSet.add(d));
                 // Provider CLIs (claude/codex/gemini) are NEVER bundled — they always
                 // come from the system. On Windows their `.cmd` shims live in

package/server/dist/project-router-jobs.js

@@ -18,6 +18,20 @@ const metrics_1 = require("./metrics");
 const ticket_store_1 = require("./ticket-store");
 const transient_children_1 = require("./transient-children");
 const project_router_helpers_1 = require("./project-router-helpers");
+function backgroundStartBusyReason(c) {
+    const activeJobId = typeof c.queueManager?.getActiveJobId === 'function' ? c.queueManager.getActiveJobId() : null;
+    if (activeJobId)
+        return `job ${activeJobId} is still running`;
+    try {
+        const runningLoops = (0, loop_runs_store_1.listRunningLoopRuns)(c.db, c.project.id);
+        if (runningLoops.length > 0)
+            return `loop run ${runningLoops[0].id} is still running`;
+    }
+    catch {
+        // If the loop table is unavailable in a test harness, do not block startup.
+    }
+    return null;
+}
 function registerJobsRoutes(deps) {
     const { router, registry, ctx, ticketPath } = deps;
     // ─── Queue / Spawn routes ────────────────────────────────────────────────────
@@ -101,8 +115,36 @@ function registerJobsRoutes(deps) {
             }),
         });
     });
+    router.get('/:projectId/background-processes/:pid/logs', (req, res) => {
+        const c = ctx(req);
+        const pid = Number(req.params.pid);
+        const chatId = typeof req.query.chatId === 'string' ? req.query.chatId : '';
+        const limit = typeof req.query.limit === 'string' ? Number(req.query.limit) : undefined;
+        if (!Number.isFinite(pid)) {
+            res.status(400).json({ error: 'pid must be numeric' });
+            return;
+        }
+        if (!chatId.trim()) {
+            res.status(400).json({ error: 'chatId is required' });
+            return;
+        }
+        if (limit !== undefined && (!Number.isFinite(limit) || limit <= 0)) {
+            res.status(400).json({ error: 'limit must be a positive number' });
+            return;
+        }
+        const logs = (0, transient_children_1.getBackgroundProcessLogs)(pid, {
+            projectId: c.project.id,
+            chatId: chatId.trim(),
+            ...(limit !== undefined ? { limit } : {}),
+        });
+        if (!logs) {
+            res.status(404).json({ error: 'background process logs not found for project/chat' });
+            return;
+        }
+        res.json(logs);
+    });
     router.post('/:projectId/background-processes', (req, res) => {
-        const { command, cwd, chatId } = req.body ?? {};
+        const { command, cwd, chatId, confirmed, allowWhileBusy } = req.body ?? {};
         const c = ctx(req);
         if (!command || typeof command !== 'string' || !command.trim()) {
             res.status(400).json({ error: 'command is required' });
@@ -112,6 +154,19 @@ function registerJobsRoutes(deps) {
             res.status(400).json({ error: 'chatId is required' });
             return;
         }
+        if (confirmed !== true) {
+            res.status(400).json({ error: 'confirmed must be true after explicit user confirmation' });
+            return;
+        }
+        const busyReason = backgroundStartBusyReason(c);
+        if (busyReason && allowWhileBusy !== true) {
+            res.status(409).json({
+                error: 'project is busy',
+                reason: busyReason,
+                hint: 'Wait for the running job/loop to finish, or pass allowWhileBusy:true only after explicit user confirmation.',
+            });
+            return;
+        }
         const resolvedCwd = path_1.default.resolve(c.project.path, typeof cwd === 'string' && cwd.trim() ? cwd : '.');
         const root = path_1.default.resolve(c.project.path);
         if (resolvedCwd !== root && !resolvedCwd.startsWith(root + path_1.default.sep)) {
@@ -126,11 +181,6 @@ function registerJobsRoutes(deps) {
                     projectId: process.projectId,
                     timestamp: new Date().toISOString(),
                 }),
-                onOutput: (event) => c.broadcast({
-                    type: 'background_process.output',
-                    ...event,
-                    timestamp: new Date().toISOString(),
-                }),
                 onExited: (process) => c.broadcast({
                     type: 'background_process.exited',
                     process,

package/server/dist/setup-manager.js

@@ -275,12 +275,12 @@ function deployTemplates(projectPath, selectedAgents) {
 // Full install: 7-phase enrichment flow (claude /specrails:enrich)
 exports.CHECKPOINTS = [
     { key: 'base_install', name: 'Base installation' },
-    { key: 'repo_analysis', name: 'Repository analysis' },
-    { key: 'stack_conventions', name: 'Stack & conventions' },
-    { key: 'product_discovery', name: 'Product discovery' },
+    { key: 'agent_selection', name: 'Agent selection' },
+    { key: 'codebase_analysis', name: 'Codebase analysis' },
+    { key: 'vpc_discovery', name: 'VPC discovery' },
     { key: 'agent_generation', name: 'Agent generation' },
-    { key: 'command_config', name: 'Command configuration' },
-    { key: 'final_verification', name: 'Final verification' },
+    { key: 'persona_synthesis', name: 'Persona synthesis' },
+    { key: 'command_generation', name: 'Command generation' },
 ];
 // Quick install: 3-phase non-interactive flow (npx init --from-config)
 exports.QUICK_CHECKPOINTS = [
@@ -303,19 +303,20 @@ function checkFilesystem(projectPath) {
     const hasCommands = (((0, fs_1.existsSync)((0, path_1.join)(projectPath, dir, 'commands', 'sr')) && hasFiles((0, path_1.join)(projectPath, dir, 'commands', 'sr'), /\.md$/)) ||
         ((0, fs_1.existsSync)((0, path_1.join)(projectPath, dir, 'commands', 'specrails')) && hasFiles((0, path_1.join)(projectPath, dir, 'commands', 'specrails'), /\.md$/)));
     const hasCLAUDE = (0, fs_1.existsSync)((0, path_1.join)(projectPath, 'CLAUDE.md'));
+    const hasInstallConfig = (0, fs_1.existsSync)((0, path_1.join)(projectPath, '.specrails', 'install-config.yaml')) ||
+        (0, fs_1.existsSync)((0, path_1.join)(projectPath, dir, 'install-config.yaml'));
+    const hasAgentConfig = (0, fs_1.existsSync)((0, path_1.join)(projectPath, dir, 'agents.yaml'));
+    const hasBacklogConfig = (0, fs_1.existsSync)((0, path_1.join)(projectPath, dir, 'backlog-config.json'));
     return {
         base_install: hasBaseInstall,
-        // repo_analysis: detected when setup templates exist and CLAUDE.md is written
-        // (Claude writes CLAUDE.md after analyzing the repo)
-        repo_analysis: hasBaseInstall && (hasCLAUDE || hasSetupTemplates),
-        // stack_conventions: detected when rules files are generated
-        stack_conventions: hasRules,
-        product_discovery: hasPersonas,
+        // Back-compat filesystem signals from older cores are translated to the
+        // current integration-contract checkpoint keys.
+        agent_selection: hasInstallConfig || hasAgentConfig || hasBacklogConfig || hasAgents || hasCommands,
+        codebase_analysis: hasBaseInstall && (hasCLAUDE || hasSetupTemplates),
+        vpc_discovery: hasPersonas,
+        persona_synthesis: hasPersonas,
         agent_generation: hasAgents,
-        command_config: hasCommands,
-        // Final verification: agents + commands must exist (manifest from install.sh is unreliable —
-        // it's created during scaffolding before /setup generates the actual artifacts)
-        final_verification: hasAgents && hasCommands,
+        command_generation: hasCommands || (hasAgents && hasRules),
     };
 }
 function hasFiles(dir, pattern) {
@@ -357,21 +358,23 @@ function readEnrichMdContent(projectPath) {
 // ─── Stream-based checkpoint detection ───────────────────────────────────────
 function detectCheckpointFromText(text) {
     const hits = [];
-    // Match phase headers from Claude's /specrails:enrich output (and legacy /setup)
+    // Match phase headers from Claude's /specrails:enrich output (and legacy /setup).
+    // Older specrails-core prompts used different checkpoint names; keep accepting
+    // those phrases but emit only the current integration-contract keys.
     if (/phase\s*1|codebase\s*analysis|repository\s*analysis/i.test(text)) {
-        hits.push({ key: 'repo_analysis', detail: 'Analyzing codebase...' });
+        hits.push({ key: 'codebase_analysis', detail: 'Analyzing codebase...' });
     }
-    if (/phase\s*2|user\s*personas|product\s*discovery/i.test(text)) {
-        hits.push({ key: 'product_discovery', detail: 'Generating personas...' });
+    if (/phase\s*2|user\s*personas|product\s*discovery|vpc\s*discovery/i.test(text)) {
+        hits.push({ key: 'vpc_discovery', detail: 'Discovering personas...' });
     }
     if (/phase\s*3|configuration|agent\s*selection|backlog\s*provider/i.test(text)) {
-        hits.push({ key: 'stack_conventions', detail: 'Configuring stack...' });
+        hits.push({ key: 'agent_selection', detail: 'Configuring agents...' });
     }
     if (/generating\s*all\s*files|writing.*agent|sr-architect|sr-developer|sr-reviewer/i.test(text)) {
         hits.push({ key: 'agent_generation', detail: 'Generating agents...' });
     }
     if (/command\s*selection|installing.*commands|\.claude\/commands\/(sr|specrails)/i.test(text)) {
-        hits.push({ key: 'command_config', detail: 'Configuring commands...' });
+        hits.push({ key: 'command_generation', detail: 'Configuring commands...' });
     }
     // TUI output patterns from specrails-core init --from-config.
     // Covers both the retired bash installer (✓ config loaded, reading
@@ -385,7 +388,7 @@ function detectCheckpointFromText(text) {
         hits.push({ key: 'agent_generation', detail: 'Installing specrails artefacts...' });
     }
     if (/writing\s*manifest|wrote\s+.*specrails-manifest/i.test(text)) {
-        hits.push({ key: 'final_verification' });
+        hits.push({ key: 'command_generation' });
     }
     if (/✓\s*installed|installation\s*complete|init\s*complete|update\s*complete/i.test(text)) {
         hits.push({ key: 'quick_complete' });
@@ -394,7 +397,7 @@ function detectCheckpointFromText(text) {
     if (text.includes('.specrails-version') || text.includes('specrails/specrails-version'))
         hits.push({ key: 'base_install' });
     if (text.includes('/agents/personas/') && text.includes('.md')) {
-        hits.push({ key: 'product_discovery', detail: 'Writing personas...' });
+        hits.push({ key: 'persona_synthesis', detail: 'Writing personas...' });
     }
     // Claude path: .claude/agents/sr-<name>.md
     if (/\/agents\/sr-[^/]+\.md/.test(text)) {
@@ -407,24 +410,24 @@ function detectCheckpointFromText(text) {
         hits.push({ key: 'agent_generation', detail: 'Writing agent skills...' });
     }
     if ((text.includes('/commands/sr/') || text.includes('/commands/specrails/')) && text.includes('.md')) {
-        hits.push({ key: 'command_config', detail: 'Writing commands...' });
+        hits.push({ key: 'command_generation', detail: 'Writing commands...' });
     }
     // Codex enrich/doctor skills (the non-rail commands) also indicate
-    // command_config progress.
+    // command_generation progress.
     if (/\.codex\/skills\/(enrich|doctor)\/SKILL\.md/.test(text)) {
-        hits.push({ key: 'command_config', detail: 'Writing codex command skills...' });
+        hits.push({ key: 'command_generation', detail: 'Writing codex command skills...' });
     }
     if (text.includes('/rules/') && text.includes('.md')) {
-        hits.push({ key: 'stack_conventions', detail: 'Writing conventions...' });
+        hits.push({ key: 'command_generation', detail: 'Writing conventions...' });
     }
     // Codex sandbox / approval policy lives inside .codex/config.toml
     // (top-level `sandbox_mode` + `approval_policy` keys, per codex
     // 0.128.0+). There is no separate Starlark rules file.
     if (/\.codex\/config\.toml/.test(text)) {
-        hits.push({ key: 'stack_conventions', detail: 'Writing codex sandbox config...' });
+        hits.push({ key: 'agent_selection', detail: 'Writing codex sandbox config...' });
     }
     if (text.includes('.specrails-manifest.json') || text.includes('specrails/specrails-manifest.json')) {
-        hits.push({ key: 'final_verification' });
+        hits.push({ key: 'command_generation' });
     }
     return hits;
 }

package/server/dist/setup-prerequisites.js

@@ -122,7 +122,7 @@ function brokenSymlinkHint(label, command, resolvedPath) {
     const where = resolvedPath ? ` at ${resolvedPath}` : '';
     return `${label} found${where} but failed to execute — possibly a broken symlink or a stale install. Reinstall ${command} or remove the stale link${resolvedPath ? ` at ${resolvedPath}` : ''}.`;
 }
-const BUNDLED_TOOL_KEYS = new Set(['node', 'npm', 'npx', 'git']);
+const BUNDLED_TOOL_KEYS = new Set(['node', 'npm', 'npx', 'git', 'uv']);
 function isBundledTool(key) {
     return BUNDLED_TOOL_KEYS.has(key);
 }
@@ -138,6 +138,7 @@ function getBundledToolCandidates(runtimesBase, tool) {
             npx: [path_1.default.join(runtimesBase, 'node', 'npx.cmd')],
             git: [path_1.default.join(runtimesBase, 'git', 'cmd', 'git.exe'), path_1.default.join(runtimesBase, 'git', 'bin', 'git.exe')],
             gh: [path_1.default.join(runtimesBase, 'gh', 'bin', 'gh.exe')],
+            uv: [path_1.default.join(runtimesBase, 'uv', 'uv.exe'), path_1.default.join(runtimesBase, 'uv', 'bin', 'uv.exe')],
         };
         return map[tool];
     }
@@ -147,6 +148,7 @@ function getBundledToolCandidates(runtimesBase, tool) {
         npx: [path_1.default.join(runtimesBase, 'node', 'bin', 'npx')],
         git: [path_1.default.join(runtimesBase, 'git', 'bin', 'git')],
         gh: [path_1.default.join(runtimesBase, 'gh', 'bin', 'gh')],
+        uv: [path_1.default.join(runtimesBase, 'uv', 'bin', 'uv'), path_1.default.join(runtimesBase, 'uv', 'uv')],
     };
     return map[tool];
 }