specrails-desktop 2.2.1 → 2.4.0

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

@@ -0,0 +1,275 @@
+"use strict";
+// Shared helpers and the deps contract for the project-router domain modules.
+// Extracted verbatim from project-router.ts when that monolith was split into
+// per-domain register functions. Behaviour-preserving — same exports, same code.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VALID_MODEL_ALIASES = exports.TERMINAL_PANEL_ENABLED = void 0;
+exports.stripSpecMetadataSections = stripSpecMetadataSections;
+exports.extractShortSummary = extractShortSummary;
+exports.deriveFallbackShortSummary = deriveFallbackShortSummary;
+exports.lightlyStructurePrompt = lightlyStructurePrompt;
+exports.formatDescriptionWithCriteria = formatDescriptionWithCriteria;
+exports.resolveDefaultSpecModel = resolveDefaultSpecModel;
+exports.readAgentModels = readAgentModels;
+exports.applyModelConfig = applyModelConfig;
+exports.serializeInstallConfigYaml = serializeInstallConfigYaml;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const core_package_1 = require("./core-package");
+const spec_models_1 = require("./spec-models");
+const ticket_store_1 = require("./ticket-store");
+const TERMINAL_PANEL_ENABLED = process.env.SPECRAILS_TERMINAL_PANEL !== 'false';
+exports.TERMINAL_PANEL_ENABLED = TERMINAL_PANEL_ENABLED;
+// ─── YAML helpers ─────────────────────────────────────────────────────────────
+/**
+ * Serialize install config to YAML matching specrails-core's tui-installer format exactly.
+ */
+function serializeInstallConfigYaml(config) {
+    const c = config;
+    const overrides = c.models?.overrides ?? {};
+    const overridesEntries = Object.entries(overrides);
+    const overridesYaml = overridesEntries.length > 0
+        ? '\n' + overridesEntries.map(([k, v]) => `    ${k}: ${v}`).join('\n')
+        : ' {}';
+    const lines = [
+        '# specrails install config — generated by Specrails',
+        `# Re-run: npx ${core_package_1.CORE_PACKAGE_SPEC} init  to regenerate`,
+        `version: ${c.version ?? 1}`,
+        `provider: ${c.provider ?? 'claude'}`,
+        `tier: ${c.tier ?? 'quick'}`,
+        `agents:`,
+        `  selected: [${(c.agents?.selected ?? []).join(', ')}]`,
+        `  excluded: [${(c.agents?.excluded ?? []).join(', ')}]`,
+        `models:`,
+        `  preset: ${c.models?.preset ?? 'balanced'}`,
+        `  defaults: { model: ${c.models?.defaults?.model ?? 'sonnet'} }`,
+        `  overrides:${overridesYaml}`,
+        `agent_teams: ${c.agent_teams ?? false}`,
+        '',
+    ];
+    return lines.join('\n');
+}
+// ─── Agent model helpers ──────────────────────────────────────────────────────
+const VALID_MODEL_ALIASES = ['sonnet', 'opus', 'haiku'];
+exports.VALID_MODEL_ALIASES = VALID_MODEL_ALIASES;
+/**
+ * Read installed agents from `.claude/agents/*.md` (top-level only, no subdirs).
+ * Extracts the `model:` field from YAML frontmatter.
+ */
+function readAgentModels(projectPath) {
+    const agentsDir = path_1.default.join(projectPath, '.claude', 'agents');
+    if (!fs_1.default.existsSync(agentsDir))
+        return [];
+    let entries;
+    try {
+        entries = fs_1.default.readdirSync(agentsDir);
+    }
+    catch {
+        return [];
+    }
+    const agents = [];
+    for (const entry of entries) {
+        // Top-level .md files only — skip subdirs
+        if (!entry.endsWith('.md'))
+            continue;
+        const filePath = path_1.default.join(agentsDir, entry);
+        try {
+            const stat = fs_1.default.statSync(filePath);
+            if (!stat.isFile())
+                continue;
+            const content = fs_1.default.readFileSync(filePath, 'utf-8');
+            // Extract model from YAML frontmatter between --- markers
+            const frontmatterMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+            if (!frontmatterMatch)
+                continue;
+            const frontmatter = frontmatterMatch[1];
+            const modelMatch = frontmatter.match(/^model:\s*(.+)$/m);
+            const model = modelMatch ? modelMatch[1].trim() : 'sonnet';
+            agents.push({ name: entry.slice(0, -3), model });
+        }
+        catch {
+            // skip unreadable files
+        }
+    }
+    return agents;
+}
+/**
+ * Read `.specrails/install-config.yaml` and patch the `model:` line in each
+ * `.claude/agents/*.md` frontmatter to match the config's defaults/overrides.
+ * No-op if the config file does not exist.
+ */
+function applyModelConfig(projectPath) {
+    const configPath = path_1.default.join(projectPath, '.specrails', 'install-config.yaml');
+    if (!fs_1.default.existsSync(configPath))
+        return;
+    let configText;
+    try {
+        configText = fs_1.default.readFileSync(configPath, 'utf-8');
+    }
+    catch {
+        return;
+    }
+    // Parse defaults.model
+    const defaultsMatch = configText.match(/defaults:\s*\{\s*model:\s*(\S+)\s*\}/);
+    const defaultModel = defaultsMatch ? defaultsMatch[1] : 'sonnet';
+    // Parse overrides block — lines like `    agentname: alias`
+    const overrides = {};
+    const overridesBlockMatch = configText.match(/overrides:([\s\S]*?)(?:\n\S|$)/);
+    if (overridesBlockMatch) {
+        const block = overridesBlockMatch[1];
+        const overrideLines = block.match(/^ {2,}(\S+):\s*(\S+)/gm) ?? [];
+        for (const line of overrideLines) {
+            const m = line.match(/^\s+(\S+):\s*(\S+)/);
+            if (m)
+                overrides[m[1]] = m[2];
+        }
+    }
+    const agentsDir = path_1.default.join(projectPath, '.claude', 'agents');
+    if (!fs_1.default.existsSync(agentsDir))
+        return;
+    let entries;
+    try {
+        entries = fs_1.default.readdirSync(agentsDir);
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (!entry.endsWith('.md'))
+            continue;
+        const filePath = path_1.default.join(agentsDir, entry);
+        try {
+            const stat = fs_1.default.statSync(filePath);
+            if (!stat.isFile())
+                continue;
+            const agentName = entry.slice(0, -3);
+            const targetModel = overrides[agentName] ?? defaultModel;
+            const content = fs_1.default.readFileSync(filePath, 'utf-8');
+            const patched = content.replace(/^model: .+$/m, `model: ${targetModel}`);
+            if (patched !== content) {
+                fs_1.default.writeFileSync(filePath, patched, 'utf-8');
+            }
+        }
+        catch {
+            // skip unwritable files
+        }
+    }
+}
+/**
+ * Strip the metadata sections (Spec Title, Labels, Estimated Complexity,
+ * Short Summary) from a generate-spec LLM response so they don't end up
+ * duplicated inside the ticket's description — they're already parsed into
+ * dedicated fields and re-rendered by the UI.
+ */
+function stripSpecMetadataSections(buffer) {
+    return buffer
+        .replace(/##\s*Spec Title\s*\n+[^\n]*\n*/i, '')
+        .replace(/##\s*Labels\s*\n+(?:[^\n]+(?:\n(?!##)[^\n]+)*)\n*/i, '')
+        .replace(/##\s*Estimated Complexity\s*\n+(?:[^\n]+(?:\n(?!##)[^\n]+)*)\n*/i, '')
+        .replace(/##\s*Short Summary\s*\n+(?:[^\n]+(?:\n(?!##)[^\n]+)*)\n*/i, '')
+        .trim();
+}
+/**
+ * Extract the `## Short Summary` section body from a generate-spec response.
+ * Returns the raw multi-line string (the ticket-store `clampShortSummary`
+ * helper applies trim, control-strip, and the 240-char hard cap before
+ * persistence). Returns `null` when the section is missing or empty.
+ */
+function extractShortSummary(buffer) {
+    const m = buffer.match(/##\s*Short Summary\s*\n+((?:(?!##)[^\n]+(?:\n(?!##)[^\n]+)*))/i);
+    if (!m)
+        return null;
+    const body = m[1].trim();
+    return body.length > 0 ? body : null;
+}
+function deriveFallbackShortSummary(title, description) {
+    const plain = description
+        .replace(/```[\s\S]*?```/g, ' ')
+        .replace(/^#{1,6}\s+.*$/gm, ' ')
+        .replace(/^\s*[-*]\s+/gm, '')
+        .replace(/\[[^\]]+\]\([^)]+\)/g, (m) => m.match(/\[([^\]]+)\]/)?.[1] ?? '')
+        .replace(/[`*_>]/g, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+    const source = plain || title.trim();
+    if (!source)
+        return null;
+    const sentence = source.match(/^(.{24,}?[.!?])(?:\s|$)/)?.[1] ?? source;
+    const capped = sentence.length > 160 ? `${sentence.slice(0, 157).trimEnd()}...` : sentence;
+    return (0, ticket_store_1.clampShortSummary)(capped);
+}
+/**
+ * Lightly structure a raw free-form prompt (the "Raw" Add-Spec mode) when the
+ * user opts in. We deliberately do NOT fabricate spec sections — a raw prompt
+ * stays the user's own words. The only transform: when the body has no leading
+ * markdown heading, prefix a single neutral `## Overview` heading so the spec
+ * renders with a section title downstream. Returns the (trimmed) input
+ * unchanged when it already starts with a heading or is empty.
+ */
+function lightlyStructurePrompt(text) {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return trimmed;
+    if (/^#{1,6}\s+/.test(trimmed))
+        return trimmed;
+    return `## Overview\n\n${trimmed}`;
+}
+/**
+ * Fold an `acceptanceCriteria` array into a ticket description body, writing
+ * (or replacing) a `## Acceptance Criteria` section.
+ *
+ * - `criteria.length > 0` → append/replace the section with one `- bullet` per item
+ * - `criteria.length === 0` → strip any existing `## Acceptance Criteria` section
+ *
+ * The match is case-insensitive on the heading text but requires `##` exactly
+ * to avoid matching other heading levels.
+ *
+ * Shared by `POST /tickets/from-draft` and `PATCH /tickets/:id`. See
+ * openspec/changes/replace-ai-edit-with-continue-editing/design.md D3+D4.
+ */
+function formatDescriptionWithCriteria(body, criteria) {
+    const sectionRegex = /\n*##\s*Acceptance Criteria\s*\n[\s\S]*?(?=\n##\s|\n*$)/i;
+    const withoutExisting = body.replace(sectionRegex, '').replace(/\s+$/, '');
+    if (criteria.length === 0)
+        return withoutExisting;
+    const section = `## Acceptance Criteria\n\n${criteria.map((c) => `- ${c}`).join('\n')}`;
+    if (withoutExisting === '')
+        return section;
+    return `${withoutExisting}\n\n${section}`;
+}
+/**
+ * Resolve the default model used by Add Spec for a project.
+ *
+ * Order:
+ *   1. `models.defaults.model` from `<project>/.specrails/install-config.yaml`,
+ *      if it parses AND is in the provider allow-list.
+ *   2. Provider default from `PROVIDER_DEFAULT_MODEL` (`sonnet` / `gpt-5.5`).
+ *
+ * Logs a warning when the configured value exists but is not valid for the
+ * project's provider.
+ */
+function resolveDefaultSpecModel(args) {
+    const { projectPath, provider } = args;
+    const configPath = path_1.default.join(projectPath, '.specrails', 'install-config.yaml');
+    if (!fs_1.default.existsSync(configPath))
+        return (0, spec_models_1.getProviderDefault)(provider);
+    let configText;
+    try {
+        configText = fs_1.default.readFileSync(configPath, 'utf-8');
+    }
+    catch {
+        return (0, spec_models_1.getProviderDefault)(provider);
+    }
+    const defaultsMatch = configText.match(/defaults:\s*\{\s*model:\s*(\S+?)\s*\}/);
+    const configured = defaultsMatch ? defaultsMatch[1] : null;
+    if (!configured)
+        return (0, spec_models_1.getProviderDefault)(provider);
+    if (!(0, spec_models_1.isValidModelForProvider)(configured, provider)) {
+        console.warn(`[project-router] resolveDefaultSpecModel: configured model "${configured}" is not valid for provider "${provider}" — falling back to provider default`);
+        return (0, spec_models_1.getProviderDefault)(provider);
+    }
+    return configured;
+}

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

@@ -0,0 +1,389 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerJobsRoutes = registerJobsRoutes;
+const db_1 = require("./db");
+const queue_manager_1 = require("./queue-manager");
+const types_1 = require("./types");
+const hooks_1 = require("./hooks");
+const explore_smash_1 = require("./explore-smash");
+const spec_models_1 = require("./spec-models");
+const provider_selection_1 = require("./provider-selection");
+const metrics_1 = require("./metrics");
+const ticket_store_1 = require("./ticket-store");
+const project_router_helpers_1 = require("./project-router-helpers");
+function registerJobsRoutes(deps) {
+    const { router, registry, ctx, ticketPath } = deps;
+    // ─── Queue / Spawn routes ────────────────────────────────────────────────────
+    router.post('/:projectId/spawn', (req, res) => {
+        const { command, priority, dependsOnJobId, pipelineId, profileName, aiEngine } = req.body ?? {};
+        if (!command || typeof command !== 'string' || !command.trim()) {
+            res.status(400).json({ error: 'command is required' });
+            return;
+        }
+        if (priority !== undefined && !types_1.VALID_PRIORITIES.has(priority)) {
+            res.status(400).json({ error: 'priority must be one of: low, normal, high, critical' });
+            return;
+        }
+        // profileName accepts: undefined (default resolution), null (force legacy), string (explicit)
+        const normalizedProfileName = profileName === null ? null
+            : typeof profileName === 'string' && profileName.trim() ? profileName.trim()
+                : undefined;
+        // aiEngine: optional per-job provider override; must be installed on the
+        // project. Omitting it runs on the project's primary provider.
+        const engineCheck = (0, provider_selection_1.validateRequestedProvider)(ctx(req).project, aiEngine);
+        if (!engineCheck.ok) {
+            res.status(400).json({ error: engineCheck.error });
+            return;
+        }
+        try {
+            const job = ctx(req).queueManager.enqueue(command, priority ?? 'normal', {
+                dependsOnJobId: dependsOnJobId || undefined,
+                pipelineId: pipelineId || undefined,
+                profileName: normalizedProfileName,
+                provider: aiEngine ? engineCheck.provider : undefined,
+            });
+            const position = job.queuePosition ?? 0;
+            res.status(202).json({ jobId: job.id, position });
+        }
+        catch (err) {
+            if (err instanceof queue_manager_1.ClaudeNotFoundError) {
+                res.status(400).json({ error: err.message });
+            }
+            else {
+                console.error('[project-router] spawn error:', err);
+                res.status(500).json({ error: 'Internal server error' });
+            }
+        }
+    });
+    // ─── Pipeline routes ──────────────────────────────────────────────────────────
+    // NOTE: Ad-hoc pipeline creation removed — use rails (templates) instead.
+    // The GET route remains for viewing existing pipeline status.
+    router.get('/:projectId/pipelines/:pipelineId', (req, res) => {
+        const { db } = ctx(req);
+        const pipelineId = req.params.pipelineId;
+        const jobs = (0, db_1.getPipelineJobs)(db, pipelineId);
+        if (jobs.length === 0) {
+            res.status(404).json({ error: 'Pipeline not found' });
+            return;
+        }
+        const allCompleted = jobs.every(j => j.status === 'completed');
+        const anyFailed = jobs.some(j => ['failed', 'skipped', 'canceled', 'zombie_terminated'].includes(j.status));
+        const status = allCompleted ? 'completed' : anyFailed ? 'failed' : 'running';
+        res.json({ pipelineId, status, jobs });
+    });
+    router.get('/:projectId/state', (req, res) => {
+        const { queueManager, project } = ctx(req);
+        res.json({
+            projectName: project.name,
+            projectId: project.id,
+            phases: (0, hooks_1.getPhaseStates)(),
+            busy: queueManager.getActiveJobId() !== null,
+            currentJobId: queueManager.getActiveJobId(),
+            featureFlags: {
+                smash: !(0, explore_smash_1.isSpecsSmashKillSwitchActive)(),
+            },
+        });
+    });
+    // Returns the resolved default model for Add Spec + the full provider
+    // allow-list so the modal can render its picker without maintaining its
+    // own copy of the model lists. Source of truth is `server/spec-models.ts`.
+    router.get('/:projectId/default-spec-model', (req, res) => {
+        const { project } = ctx(req);
+        // Multi-provider: an optional ?provider= query selects which engine's models
+        // to return. It must be one the project actually has installed; an invalid
+        // or omitted value falls back to the project's primary provider. The
+        // response also lists every installed provider so the Add Spec modal can
+        // render its AI Engine selector without a second round-trip.
+        const provider = (0, provider_selection_1.resolveProvider)(project, typeof req.query.provider === 'string' ? req.query.provider : undefined);
+        const model = (0, project_router_helpers_1.resolveDefaultSpecModel)({ projectPath: project.path, provider });
+        const allowed = (0, spec_models_1.getModelsForProvider)(provider);
+        res.json({ model, provider, allowed, providers: project.providers });
+    });
+    router.delete('/:projectId/jobs/:id', (req, res) => {
+        try {
+            const result = ctx(req).queueManager.cancel(req.params.id);
+            res.json({ ok: true, status: result });
+        }
+        catch (err) {
+            if (err instanceof queue_manager_1.JobNotFoundError) {
+                res.status(404).json({ error: 'Job not found' });
+            }
+            else if (err instanceof queue_manager_1.JobAlreadyTerminalError) {
+                // Job already finished — delete it from the DB
+                (0, db_1.deleteJob)(ctx(req).db, req.params.id);
+                res.json({ ok: true, status: 'deleted' });
+            }
+            else {
+                res.status(500).json({ error: 'Internal server error' });
+            }
+        }
+    });
+    router.patch('/:projectId/jobs/:id/priority', (req, res) => {
+        const { priority } = req.body ?? {};
+        if (!priority || !types_1.VALID_PRIORITIES.has(priority)) {
+            res.status(400).json({ error: 'priority must be one of: low, normal, high, critical' });
+            return;
+        }
+        try {
+            ctx(req).queueManager.updatePriority(req.params.id, priority);
+            res.json({ ok: true });
+        }
+        catch (err) {
+            if (err instanceof queue_manager_1.JobNotFoundError) {
+                res.status(404).json({ error: 'Job not found' });
+            }
+            else {
+                res.status(400).json({ error: err.message });
+            }
+        }
+    });
+    router.post('/:projectId/queue/pause', (req, res) => {
+        ctx(req).queueManager.pause();
+        res.json({ ok: true, paused: true });
+    });
+    router.post('/:projectId/queue/resume', (req, res) => {
+        ctx(req).queueManager.resume();
+        res.json({ ok: true, paused: false });
+    });
+    router.put('/:projectId/queue/reorder', (req, res) => {
+        const { jobIds } = req.body ?? {};
+        if (!Array.isArray(jobIds)) {
+            res.status(400).json({ error: 'jobIds must be an array' });
+            return;
+        }
+        try {
+            ctx(req).queueManager.reorder(jobIds);
+            res.json({ ok: true, queue: jobIds });
+        }
+        catch (err) {
+            res.status(400).json({ error: err.message });
+        }
+    });
+    router.get('/:projectId/queue', (req, res) => {
+        const { queueManager } = ctx(req);
+        res.json({
+            jobs: queueManager.getJobs(),
+            paused: queueManager.isPaused(),
+            activeJobId: queueManager.getActiveJobId(),
+        });
+    });
+    router.get('/:projectId/jobs', (req, res) => {
+        // Clamp to [1, 200] (H-11): a negative limit is LIMIT -1 in SQLite, which
+        // means UNLIMITED — without the lower bound `?limit=-1` dumps the whole table.
+        const limit = Math.max(1, Math.min(parseInt(String(req.query.limit ?? '50'), 10) || 50, 200));
+        const offset = parseInt(String(req.query.offset ?? '0'), 10) || 0;
+        const status = req.query.status;
+        const from = req.query.from;
+        const to = req.query.to;
+        const { db } = ctx(req);
+        const result = (0, db_1.listJobs)(db, { limit, offset, status, from, to });
+        // Merge in-memory queued jobs that haven't been persisted to DB yet
+        const { queueManager } = ctx(req);
+        const dbIds = new Set(result.jobs.map((j) => j.id));
+        const queuedRows = queueManager
+            .getJobs()
+            .filter((j) => j.status === 'queued' && !dbIds.has(j.id))
+            .filter((j) => !status || j.status === status)
+            .map((j) => ({
+            id: j.id,
+            command: j.command,
+            started_at: j.startedAt ?? new Date().toISOString(),
+            finished_at: j.finishedAt,
+            status: j.status,
+            exit_code: j.exitCode,
+            queue_position: j.queuePosition,
+            priority: j.priority,
+            tokens_in: null,
+            tokens_out: null,
+            tokens_cache_read: null,
+            tokens_cache_create: null,
+            total_cost_usd: null,
+            num_turns: null,
+            model: null,
+            duration_ms: null,
+            duration_api_ms: null,
+            session_id: null,
+            depends_on_job_id: j.dependsOnJobId,
+            pipeline_id: j.pipelineId,
+            skip_reason: j.skipReason,
+        }));
+        if (queuedRows.length > 0) {
+            result.jobs = [...queuedRows, ...result.jobs];
+            result.total += queuedRows.length;
+        }
+        // Annotate each job with hasTelemetry so the client can show the
+        // Export diagnostic button without an extra round trip.
+        const jobsWithTelemetry = (0, db_1.getJobsWithTelemetry)(db);
+        const annotatedJobs = result.jobs.map((j) => ({
+            ...j,
+            hasTelemetry: jobsWithTelemetry.has(j.id),
+        }));
+        res.json({ jobs: annotatedJobs, total: result.total });
+    });
+    // ─── CSV helper ──────────────────────────────────────────────────────────────
+    const toCsv = (headers, rows) => {
+        const escape = (v) => {
+            const s = v == null ? '' : String(v);
+            return s.includes(',') || s.includes('"') || s.includes('\n') ? `"${s.replace(/"/g, '""')}"` : s;
+        };
+        const lines = [headers.join(',')];
+        for (const row of rows) {
+            lines.push(headers.map(h => escape(row[h])).join(','));
+        }
+        return lines.join('\n');
+    };
+    // ─── Jobs export (must be before /:projectId/jobs/:id) ─────────────────────
+    router.get('/:projectId/jobs/export', (req, res) => {
+        const format = req.query.format || 'json';
+        if (format !== 'json' && format !== 'csv') {
+            res.status(400).json({ error: 'Invalid format. Must be json or csv' });
+            return;
+        }
+        const from = req.query.from;
+        const to = req.query.to;
+        const { db } = ctx(req);
+        const conditions = [];
+        const params = [];
+        if (from) {
+            conditions.push('started_at >= ?');
+            params.push(from);
+        }
+        if (to) {
+            conditions.push('started_at <= ?');
+            params.push(to);
+        }
+        const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+        const jobs = db
+            .prepare(`SELECT * FROM jobs ${where} ORDER BY started_at DESC LIMIT 10000`)
+            .all(...params);
+        if (format === 'csv') {
+            const headers = ['id', 'command', 'status', 'started_at', 'finished_at', 'duration_ms', 'tokens_in', 'tokens_out', 'tokens_cache_read', 'total_cost_usd', 'model'];
+            const csv = toCsv(headers, jobs);
+            res.setHeader('Content-Type', 'text/csv');
+            res.setHeader('Content-Disposition', 'attachment; filename="jobs-export.csv"');
+            res.send(csv);
+        }
+        else {
+            res.json({ jobs });
+        }
+    });
+    // Must be registered BEFORE /:projectId/jobs/:id, otherwise Express matches
+    // the parameterized route first with id='compare' and this never runs (the
+    // Job Comparison feature would always 404).
+    router.get('/:projectId/jobs/compare', (req, res) => {
+        const raw = req.query.jobIds;
+        if (!raw) {
+            res.status(400).json({ error: 'jobIds query param required (comma-separated, exactly 2)' });
+            return;
+        }
+        const ids = raw.split(',').map((s) => s.trim()).filter(Boolean);
+        if (ids.length !== 2) {
+            res.status(400).json({ error: 'Exactly 2 jobIds are required' });
+            return;
+        }
+        const { db } = ctx(req);
+        const rows = ids.map((id) => {
+            const job = db.prepare('SELECT * FROM jobs WHERE id = ?').get(id);
+            if (!job)
+                return null;
+            const phases = db.prepare("SELECT phase FROM job_phases WHERE job_id = ? AND state = 'done' ORDER BY updated_at ASC").all(id);
+            return {
+                id: job.id,
+                command: job.command,
+                status: job.status,
+                startedAt: job.started_at,
+                finishedAt: job.finished_at,
+                durationMs: job.duration_ms,
+                tokensIn: job.tokens_in,
+                tokensOut: job.tokens_out,
+                tokensCacheRead: job.tokens_cache_read,
+                totalCostUsd: job.total_cost_usd,
+                model: job.model,
+                phasesCompleted: phases.map((p) => p.phase),
+            };
+        });
+        const missing = ids.filter((_, i) => rows[i] === null);
+        if (missing.length > 0) {
+            res.status(404).json({ error: `Jobs not found: ${missing.join(', ')}` });
+            return;
+        }
+        res.json({ jobs: rows });
+    });
+    router.get('/:projectId/jobs/:id', (req, res) => {
+        const { db, queueManager, project } = ctx(req);
+        const jobId = req.params.id;
+        const job = (0, db_1.getJob)(db, jobId);
+        if (!job) {
+            // Queued jobs live only in memory until spawn time (createJob runs on spawn,
+            // not enqueue). Fall back to the in-memory queue so /jobs/:id returns a
+            // usable payload instead of 404 — the detail page then renders a "queued"
+            // state and flips to live logs via WS once the job starts.
+            const inMemory = queueManager.getJobs().find((j) => j.id === jobId);
+            if (!inMemory) {
+                res.status(404).json({ error: 'Job not found' });
+                return;
+            }
+            const synthetic = {
+                id: inMemory.id,
+                command: inMemory.command,
+                started_at: inMemory.startedAt ?? '',
+                finished_at: inMemory.finishedAt,
+                status: inMemory.status,
+                exit_code: inMemory.exitCode,
+                queue_position: inMemory.queuePosition,
+                priority: inMemory.priority,
+                tokens_in: null,
+                tokens_out: null,
+                tokens_cache_read: null,
+                tokens_cache_create: null,
+                total_cost_usd: null,
+                num_turns: null,
+                model: null,
+                duration_ms: null,
+                duration_api_ms: null,
+                session_id: null,
+                depends_on_job_id: inMemory.dependsOnJobId,
+                pipeline_id: inMemory.pipelineId,
+                skip_reason: inMemory.skipReason,
+            };
+            const phaseDefinitions = queueManager.phasesForCommand(synthetic.command);
+            const tickets = (0, ticket_store_1.resolveTicketsFromCommand)(project.path, synthetic.command);
+            res.json({ job: { ...synthetic, hasTelemetry: false, tickets }, events: [], phaseDefinitions });
+            return;
+        }
+        const events = (0, db_1.getJobEvents)(db, jobId);
+        const phaseDefinitions = queueManager.phasesForCommand(job.command);
+        const tickets = (0, ticket_store_1.resolveTicketsFromCommand)(project.path, job.command);
+        const annotated = { ...job, hasTelemetry: (0, db_1.hasJobTelemetry)(db, jobId), tickets };
+        res.json({ job: annotated, events, phaseDefinitions });
+    });
+    router.delete('/:projectId/jobs', (req, res) => {
+        try {
+            const { from, to } = req.body ?? {};
+            const deleted = (0, db_1.purgeJobs)(ctx(req).db, { from, to });
+            res.json({ ok: true, deleted });
+        }
+        catch (err) {
+            console.error('[project-router] purge error:', err);
+            res.status(500).json({ error: 'Failed to purge jobs' });
+        }
+    });
+    router.get('/:projectId/activity', (req, res) => {
+        const limit = Math.min(Math.max(1, parseInt(String(req.query.limit ?? '50'), 10) || 50), 100);
+        const before = req.query.before;
+        res.json((0, db_1.getProjectActivity)(ctx(req).db, { limit, before }));
+    });
+    router.get('/:projectId/stats', (req, res) => {
+        res.json((0, db_1.getStats)(ctx(req).db));
+    });
+    router.get('/:projectId/metrics', (req, res) => {
+        const { project, db } = ctx(req);
+        try {
+            res.json((0, metrics_1.getProjectMetrics)(project.path, db));
+        }
+        catch (err) {
+            console.error('[project-router] metrics error:', err);
+            res.status(500).json({ error: 'Failed to compute metrics' });
+        }
+    });
+}