specrails-desktop 2.2.0 → 2.3.0

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

@@ -0,0 +1,312 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSettingsRoutes = registerSettingsRoutes;
+// Domain routes extracted from project-router.ts (settings).
+// Registered on the shared router by createProjectRouter — behaviour-preserving.
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const db_1 = require("./db");
+const telemetry_export_1 = require("./telemetry-export");
+const context_budget_1 = require("./context-budget");
+const context_scope_1 = require("./context-scope");
+const terminal_settings_1 = require("./terminal-settings");
+const terminal_marks_store_1 = require("./terminal-marks-store");
+const project_router_helpers_1 = require("./project-router-helpers");
+function registerSettingsRoutes(deps) {
+    const { router, registry, ctx, ticketPath } = deps;
+    // ─── Project settings (pipeline telemetry) ───────────────────────────────────
+    router.get('/:projectId/settings', (req, res) => {
+        const settings = (0, db_1.getProjectSettings)(ctx(req).db);
+        res.json(settings);
+    });
+    // ─── Per-project Quick mode Contract Refine last-used value ─────────────────
+    router.get('/:projectId/add-spec-quick-contract-refine-last', (req, res) => {
+        res.json({
+            enabled: (0, db_1.getQuickContractRefineLast)(ctx(req).db),
+            configured: (0, db_1.hasQuickContractRefineLast)(ctx(req).db),
+        });
+    });
+    router.patch('/:projectId/add-spec-quick-contract-refine-last', (req, res) => {
+        const enabled = req.body?.enabled;
+        if (typeof enabled !== 'boolean') {
+            res.status(400).json({ error: 'enabled must be a boolean' });
+            return;
+        }
+        (0, db_1.setQuickContractRefineLast)(ctx(req).db, enabled);
+        res.json({ enabled: (0, db_1.getQuickContractRefineLast)(ctx(req).db) });
+    });
+    // ─── Add Spec context scope ────────────────────────────────────────────────
+    router.get('/:projectId/context-budget', (req, res) => {
+        const { project } = ctx(req);
+        try {
+            const budget = (0, context_budget_1.getContextBudget)(project.id, project.path);
+            res.json(budget);
+        }
+        catch (err) {
+            console.error('[project-router] context-budget failed:', err);
+            res.status(500).json({ error: 'failed to compute context budget' });
+        }
+    });
+    router.get('/:projectId/context-scope-last', (req, res) => {
+        const scope = (0, context_scope_1.getLastContextScope)(ctx(req).db, 'explore');
+        res.json({ scope });
+    });
+    router.patch('/:projectId/context-scope-last', (req, res) => {
+        const body = req.body;
+        if (!body || typeof body !== 'object') {
+            res.status(400).json({ error: 'body must be an object' });
+            return;
+        }
+        // Validate booleans-only for any provided key.
+        for (const key of ['specrails', 'openspec', 'full', 'mcp', 'contractRefine', 'userMcp']) {
+            if (body[key] !== undefined && typeof body[key] !== 'boolean') {
+                res.status(400).json({ error: `${key} must be a boolean` });
+                return;
+            }
+        }
+        const current = (0, context_scope_1.getLastContextScope)(ctx(req).db, 'explore');
+        const merged = (0, context_scope_1.normalizeContextScope)({ ...current, ...body }, current);
+        (0, context_scope_1.setLastContextScope)(ctx(req).db, merged);
+        res.json({ scope: merged });
+    });
+    router.patch('/:projectId/settings', (req, res) => {
+        const { pipelineTelemetryEnabled, orchestratorModel, prePrompt, ultraPrePrompt } = req.body ?? {};
+        const patch = {};
+        if (pipelineTelemetryEnabled !== undefined) {
+            patch.pipelineTelemetryEnabled = Boolean(pipelineTelemetryEnabled);
+        }
+        const VALID_MODELS = ['sonnet', 'opus', 'haiku'];
+        if (orchestratorModel !== undefined) {
+            if (typeof orchestratorModel !== 'string' || !VALID_MODELS.includes(orchestratorModel)) {
+                res.status(400).json({ error: `orchestratorModel must be one of: ${VALID_MODELS.join(', ')}` });
+                return;
+            }
+            patch.orchestratorModel = orchestratorModel;
+        }
+        if (prePrompt !== undefined) {
+            if (typeof prePrompt !== 'string') {
+                res.status(400).json({ error: 'prePrompt must be a string' });
+                return;
+            }
+            patch.prePrompt = prePrompt;
+        }
+        if (ultraPrePrompt !== undefined) {
+            if (typeof ultraPrePrompt !== 'string') {
+                res.status(400).json({ error: 'ultraPrePrompt must be a string' });
+                return;
+            }
+            patch.ultraPrePrompt = ultraPrePrompt;
+        }
+        try {
+            (0, db_1.updateProjectSettings)(ctx(req).db, patch);
+            res.json({ ok: true, settings: (0, db_1.getProjectSettings)(ctx(req).db) });
+        }
+        catch (err) {
+            console.error('[project-router] settings patch error:', err);
+            res.status(500).json({ error: 'Failed to update settings' });
+        }
+    });
+    // ─── Agent models ────────────────────────────────────────────────────────────
+    router.get('/:projectId/agent-models', (req, res) => {
+        const { project } = ctx(req);
+        const agents = (0, project_router_helpers_1.readAgentModels)(project.path);
+        res.json({ agents });
+    });
+    router.patch('/:projectId/agent-models', (req, res) => {
+        const { project } = ctx(req);
+        const { defaultModel, overrides } = req.body ?? {};
+        // Validate defaultModel if provided
+        if (defaultModel !== undefined) {
+            if (typeof defaultModel !== 'string' || !project_router_helpers_1.VALID_MODEL_ALIASES.includes(defaultModel)) {
+                res.status(400).json({ error: `Invalid model alias. Must be one of: ${project_router_helpers_1.VALID_MODEL_ALIASES.join(', ')}` });
+                return;
+            }
+        }
+        // Validate overrides map if provided
+        if (overrides !== undefined) {
+            if (typeof overrides !== 'object' || Array.isArray(overrides) || overrides === null) {
+                res.status(400).json({ error: 'overrides must be an object' });
+                return;
+            }
+            for (const [agentName, modelValue] of Object.entries(overrides)) {
+                if (typeof modelValue !== 'string' || !project_router_helpers_1.VALID_MODEL_ALIASES.includes(modelValue)) {
+                    res.status(400).json({ error: `Invalid model alias for agent "${agentName}". Must be one of: ${project_router_helpers_1.VALID_MODEL_ALIASES.join(', ')}` });
+                    return;
+                }
+            }
+        }
+        const configDir = path_1.default.join(project.path, '.specrails');
+        const configPath = path_1.default.join(configDir, 'install-config.yaml');
+        // Read existing config or build default shape
+        let existingConfig = {
+            version: 1,
+            provider: 'claude',
+            tier: 'quick',
+            agents: { selected: [], excluded: [] },
+            models: { preset: 'balanced', defaults: { model: 'sonnet' }, overrides: {} },
+            agent_teams: false,
+        };
+        if (fs_1.default.existsSync(configPath)) {
+            try {
+                const text = fs_1.default.readFileSync(configPath, 'utf-8');
+                // Parse fields we care about from the existing config text
+                const versionMatch = text.match(/^version:\s*(\d+)/m);
+                const providerMatch = text.match(/^provider:\s*(\S+)/m);
+                const tierMatch = text.match(/^tier:\s*(\S+)/m);
+                const presetMatch = text.match(/preset:\s*(\S+)/);
+                const agentTeamsMatch = text.match(/^agent_teams:\s*(\S+)/m);
+                // Parse selected agents list
+                const selectedMatch = text.match(/selected:\s*\[([^\]]*)\]/);
+                const excludedMatch = text.match(/excluded:\s*\[([^\]]*)\]/);
+                const parsedSelected = selectedMatch
+                    ? selectedMatch[1].split(',').map(s => s.trim()).filter(Boolean)
+                    : [];
+                const parsedExcluded = excludedMatch
+                    ? excludedMatch[1].split(',').map(s => s.trim()).filter(Boolean)
+                    : [];
+                // Parse existing overrides to merge
+                const existingOverrides = {};
+                const overridesBlockMatch = text.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)
+                            existingOverrides[m[1]] = m[2];
+                    }
+                }
+                existingConfig = {
+                    version: versionMatch ? parseInt(versionMatch[1], 10) : 1,
+                    provider: providerMatch ? providerMatch[1] : 'claude',
+                    tier: tierMatch ? tierMatch[1] : 'quick',
+                    agents: { selected: parsedSelected, excluded: parsedExcluded },
+                    models: {
+                        preset: presetMatch ? presetMatch[1] : 'balanced',
+                        defaults: { model: 'sonnet' },
+                        overrides: existingOverrides,
+                    },
+                    agent_teams: agentTeamsMatch ? agentTeamsMatch[1] === 'true' : false,
+                };
+            }
+            catch {
+                // use defaults
+            }
+        }
+        // Merge new values into config
+        const mergedModels = existingConfig.models;
+        if (defaultModel !== undefined) {
+            mergedModels.defaults = { model: defaultModel };
+        }
+        if (overrides !== undefined) {
+            mergedModels.overrides = overrides;
+        }
+        existingConfig.models = mergedModels;
+        try {
+            fs_1.default.mkdirSync(configDir, { recursive: true });
+            const yaml = (0, project_router_helpers_1.serializeInstallConfigYaml)(existingConfig);
+            fs_1.default.writeFileSync(configPath, yaml, 'utf-8');
+            (0, project_router_helpers_1.applyModelConfig)(project.path);
+            const agents = (0, project_router_helpers_1.readAgentModels)(project.path);
+            res.json({ agents });
+        }
+        catch (err) {
+            console.error('[project-router] agent-models patch error:', err);
+            res.status(500).json({ error: `Failed to apply model config: ${err}` });
+        }
+    });
+    // ─── Diagnostic export ───────────────────────────────────────────────────────
+    router.get('/:projectId/jobs/:jobId/diagnostic', async (req, res) => {
+        const { db } = ctx(req);
+        const jobId = req.params.jobId;
+        const blob = (0, db_1.getTelemetryBlob)(db, jobId);
+        if (!blob) {
+            res.status(404).json({ error: 'No telemetry data for this job' });
+            return;
+        }
+        if (blob.state === 'expired') {
+            res.status(410).json({ error: 'Telemetry data has been expired and is no longer available' });
+            return;
+        }
+        const job = (0, db_1.getJob)(db, jobId);
+        if (!job) {
+            res.status(404).json({ error: 'Job not found' });
+            return;
+        }
+        const summaries = (0, db_1.getTelemetrySummaries)(db, jobId);
+        const events = (0, db_1.getJobEvents)(db, jobId);
+        try {
+            const dateStr = new Date().toISOString().slice(0, 10);
+            const filename = `specrails-diagnostic-${jobId}-${dateStr}.zip`;
+            res.setHeader('Content-Type', 'application/zip');
+            res.setHeader('Content-Disposition', `attachment; filename="${filename}"`);
+            const profileRow = db
+                .prepare(`SELECT profile_name, profile_json FROM job_profiles WHERE job_id = ?`)
+                .get(jobId);
+            const { homeJobSnapshotPath } = require('./plugins/paths');
+            const pluginSnap = homeJobSnapshotPath(req.projectCtx.project.slug, jobId);
+            await (0, telemetry_export_1.createDiagnosticZip)(res, {
+                job,
+                blob,
+                summaries,
+                events,
+                profile: profileRow ? { name: profileRow.profile_name, json: profileRow.profile_json } : null,
+                pluginSnapshotPath: pluginSnap,
+            });
+        }
+        catch (err) {
+            if (!res.headersSent) {
+                console.error('[project-router] diagnostic export error:', err);
+                res.status(500).json({ error: 'Failed to create diagnostic export' });
+            }
+        }
+    });
+    // ─── Terminal command marks ────────────────────────────────────────────────
+    // GET /api/projects/:projectId/terminals/:id/marks?limit=&before=
+    router.get('/:projectId/terminals/:id/marks', (req, res) => {
+        const projectCtx = ctx(req);
+        const sessionId = req.params.id;
+        const limit = parseInt(req.query.limit ?? '100', 10);
+        const before = req.query.before ? parseInt(req.query.before, 10) : undefined;
+        const marks = (0, terminal_marks_store_1.listMarks)(projectCtx.db, sessionId, {
+            limit: Number.isFinite(limit) ? limit : 100,
+            before: typeof before === 'number' && Number.isFinite(before) ? before : undefined,
+        });
+        res.json({ marks });
+    });
+    // ─── Terminal settings (per-project override layer) ────────────────────────
+    // GET /api/projects/:projectId/terminal-settings — returns { resolved, override, desktopDefaults }
+    router.get('/:projectId/terminal-settings', (req, res) => {
+        const projectCtx = ctx(req);
+        const desktopDefaults = (0, terminal_settings_1.getDesktopTerminalSettings)(registry.desktopDb);
+        const override = (0, terminal_settings_1.getProjectOverride)(projectCtx.db);
+        const resolved = (0, terminal_settings_1.resolveTerminalSettings)(registry.desktopDb, projectCtx.db);
+        res.json({ resolved, override, desktopDefaults });
+    });
+    // PATCH /api/projects/:projectId/terminal-settings — partial update of override
+    // (null value for a field clears that override)
+    router.patch('/:projectId/terminal-settings', (req, res) => {
+        const projectCtx = ctx(req);
+        if (!req.body || typeof req.body !== 'object' || Array.isArray(req.body)) {
+            res.status(400).json({ error: 'invalid body' });
+            return;
+        }
+        try {
+            (0, terminal_settings_1.patchProjectOverride)(projectCtx.db, req.body);
+            const desktopDefaults = (0, terminal_settings_1.getDesktopTerminalSettings)(registry.desktopDb);
+            const override = (0, terminal_settings_1.getProjectOverride)(projectCtx.db);
+            const resolved = (0, terminal_settings_1.resolveTerminalSettings)(registry.desktopDb, projectCtx.db);
+            res.json({ resolved, override, desktopDefaults });
+        }
+        catch (err) {
+            if (err instanceof terminal_settings_1.TerminalSettingsValidationError) {
+                res.status(400).json({ error: 'validation_failed', field: err.field, message: err.message });
+                return;
+            }
+            throw err;
+        }
+    });
+}