specrails-desktop 2.2.1 → 2.4.0

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

@@ -0,0 +1,456 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSetupRoutes = registerSetupRoutes;
+// Domain routes extracted from project-router.ts (setup).
+// Registered on the shared router by createProjectRouter — behaviour-preserving.
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const ids_1 = require("./ids");
+const db_1 = require("./db");
+const desktop_db_1 = require("./desktop-db");
+const queue_manager_1 = require("./queue-manager");
+const command_resolver_1 = require("./command-resolver");
+const changes_reader_1 = require("./changes-reader");
+const project_router_helpers_1 = require("./project-router-helpers");
+function registerSetupRoutes(deps) {
+    const { router, registry, ctx, ticketPath } = deps;
+    // ─── Install-config route ─────────────────────────────────────────────────────
+    router.post('/:projectId/setup/install-config', (req, res) => {
+        const { project } = ctx(req);
+        const config = req.body ?? {};
+        if (typeof config !== 'object' || Array.isArray(config)) {
+            res.status(400).json({ error: 'Request body must be a config object' });
+            return;
+        }
+        const configDir = path_1.default.join(project.path, '.specrails');
+        const configPath = path_1.default.join(configDir, 'install-config.yaml');
+        try {
+            fs_1.default.mkdirSync(configDir, { recursive: true });
+            const yaml = (0, project_router_helpers_1.serializeInstallConfigYaml)(config);
+            fs_1.default.writeFileSync(configPath, yaml, 'utf-8');
+            res.json({ ok: true, path: configPath });
+        }
+        catch (err) {
+            res.status(500).json({ error: `Failed to write install-config.yaml: ${err}` });
+        }
+    });
+    // ─── Enrich routes (v3) + Setup aliases (v1/v2 backward compat) ──────────────
+    router.post('/:projectId/setup/install', (req, res) => {
+        const { project, setupManager } = ctx(req);
+        if (setupManager.isInstalling(project.id)) {
+            res.status(409).json({ error: 'Install already in progress' });
+            return;
+        }
+        res.status(202).json({ ok: true });
+        setupManager.startInstall(project.id, project.path);
+    });
+    router.post('/:projectId/enrich/start', (req, res) => {
+        const { project, setupManager } = ctx(req);
+        if (setupManager.isEnriching(project.id)) {
+            res.status(409).json({ error: 'Enrich already in progress' });
+            return;
+        }
+        res.status(202).json({ ok: true });
+        setupManager.startEnrich(project.id, project.path, project.provider);
+    });
+    // Legacy alias: /setup/start → /enrich/start
+    router.post('/:projectId/setup/start', (req, res) => {
+        const { project, setupManager } = ctx(req);
+        if (setupManager.isEnriching(project.id)) {
+            res.status(409).json({ error: 'Setup already in progress' });
+            return;
+        }
+        res.status(202).json({ ok: true });
+        setupManager.startEnrich(project.id, project.path, project.provider);
+    });
+    router.post('/:projectId/enrich/message', (req, res) => {
+        const { project, setupManager } = ctx(req);
+        const { sessionId, message } = req.body ?? {};
+        if (!sessionId || typeof sessionId !== 'string') {
+            res.status(400).json({ error: 'sessionId is required' });
+            return;
+        }
+        if (!message || typeof message !== 'string' || !message.trim()) {
+            res.status(400).json({ error: 'message is required' });
+            return;
+        }
+        if (setupManager.isEnriching(project.id)) {
+            res.status(409).json({ error: 'Enrich already in progress' });
+            return;
+        }
+        res.status(202).json({ ok: true });
+        setupManager.resumeEnrich(project.id, project.path, sessionId, message.trim(), project.provider);
+    });
+    // Legacy alias: /setup/message → /enrich/message
+    router.post('/:projectId/setup/message', (req, res) => {
+        const { project, setupManager } = ctx(req);
+        const { sessionId, message } = req.body ?? {};
+        if (!sessionId || typeof sessionId !== 'string') {
+            res.status(400).json({ error: 'sessionId is required' });
+            return;
+        }
+        if (!message || typeof message !== 'string' || !message.trim()) {
+            res.status(400).json({ error: 'message is required' });
+            return;
+        }
+        if (setupManager.isEnriching(project.id)) {
+            res.status(409).json({ error: 'Setup already in progress' });
+            return;
+        }
+        res.status(202).json({ ok: true });
+        setupManager.resumeEnrich(project.id, project.path, sessionId, message.trim(), project.provider);
+    });
+    router.get('/:projectId/setup/checkpoints', (req, res) => {
+        const { project, setupManager } = ctx(req);
+        const checkpoints = setupManager.getCheckpointStatus(project.id, project.path);
+        const savedSessionId = (0, desktop_db_1.getProjectSetupSession)(registry.desktopDb, project.id);
+        res.json({
+            checkpoints,
+            isInstalling: setupManager.isInstalling(project.id),
+            isSettingUp: setupManager.isEnriching(project.id),
+            isEnriching: setupManager.isEnriching(project.id),
+            tier: setupManager.getInstallTier(project.id) ?? null,
+            savedSessionId: savedSessionId ?? null,
+            logLines: setupManager.getInstallLog(project.id),
+            summary: setupManager.getSummary(project.path),
+        });
+    });
+    router.post('/:projectId/setup/abort', (req, res) => {
+        const { project, setupManager } = ctx(req);
+        setupManager.abort(project.id);
+        res.json({ ok: true });
+    });
+    // ─── Proposal routes ──────────────────────────────────────────────────────
+    router.get('/:projectId/propose', (req, res) => {
+        const limit = Math.min(parseInt(String(req.query.limit ?? '20'), 10) || 20, 100);
+        const offset = parseInt(String(req.query.offset ?? '0'), 10) || 0;
+        const result = (0, db_1.listProposals)(ctx(req).db, { limit, offset });
+        res.json(result);
+    });
+    router.post('/:projectId/propose', async (req, res) => {
+        const { idea } = req.body ?? {};
+        if (!idea || typeof idea !== 'string' || !idea.trim()) {
+            res.status(400).json({ error: 'idea is required' });
+            return;
+        }
+        // Pre-check: does the propose-feature command exist in this project?
+        const testCmd = `/specrails:propose-feature test`;
+        const resolved = (0, command_resolver_1.resolveCommand)(testCmd, ctx(req).project.path);
+        if (resolved === testCmd) {
+            res.status(400).json({ error: 'This project does not have the /specrails:propose-feature command installed. Run "npx specrails-core@latest" to update.' });
+            return;
+        }
+        const id = (0, ids_1.newId)();
+        (0, db_1.createProposal)(ctx(req).db, { id, idea: idea.trim() });
+        res.status(202).json({ proposalId: id });
+        ctx(req).proposalManager.startExploration(id, idea.trim()).catch((err) => {
+            console.error('[project-router] proposal startExploration error:', err);
+        });
+    });
+    router.get('/:projectId/propose/:id', (req, res) => {
+        const proposal = (0, db_1.getProposal)(ctx(req).db, req.params.id);
+        if (!proposal) {
+            res.status(404).json({ error: 'Proposal not found' });
+            return;
+        }
+        res.json({ proposal });
+    });
+    router.post('/:projectId/propose/:id/refine', async (req, res) => {
+        const proposal = (0, db_1.getProposal)(ctx(req).db, req.params.id);
+        if (!proposal) {
+            res.status(404).json({ error: 'Proposal not found' });
+            return;
+        }
+        const { feedback } = req.body ?? {};
+        if (!feedback || typeof feedback !== 'string' || !feedback.trim()) {
+            res.status(400).json({ error: 'feedback is required' });
+            return;
+        }
+        if (ctx(req).proposalManager.isActive(req.params.id)) {
+            res.status(409).json({ error: 'PROPOSAL_BUSY' });
+            return;
+        }
+        if (proposal.status !== 'review') {
+            res.status(409).json({ error: 'Proposal is not in review state' });
+            return;
+        }
+        res.status(202).json({ ok: true });
+        ctx(req).proposalManager.sendRefinement(req.params.id, feedback.trim()).catch((err) => {
+            console.error('[project-router] proposal sendRefinement error:', err);
+        });
+    });
+    router.post('/:projectId/propose/:id/create-issue', async (req, res) => {
+        const proposal = (0, db_1.getProposal)(ctx(req).db, req.params.id);
+        if (!proposal) {
+            res.status(404).json({ error: 'Proposal not found' });
+            return;
+        }
+        if (ctx(req).proposalManager.isActive(req.params.id)) {
+            res.status(409).json({ error: 'PROPOSAL_BUSY' });
+            return;
+        }
+        if (proposal.status !== 'review') {
+            res.status(409).json({ error: 'Proposal is not in review state' });
+            return;
+        }
+        res.status(202).json({ ok: true });
+        ctx(req).proposalManager.createIssue(req.params.id).catch((err) => {
+            console.error('[project-router] proposal createIssue error:', err);
+        });
+    });
+    router.delete('/:projectId/propose/:id', (req, res) => {
+        const proposal = (0, db_1.getProposal)(ctx(req).db, req.params.id);
+        if (!proposal) {
+            res.status(404).json({ error: 'Proposal not found' });
+            return;
+        }
+        ctx(req).proposalManager.cancel(req.params.id);
+        res.json({ ok: true });
+    });
+    // ─── Feature Funnel ─────────────────────────────────────────────────────────
+    router.get('/:projectId/changes', (req, res) => {
+        const { project, queueManager } = ctx(req);
+        const activeCommands = queueManager.getJobs()
+            .filter((j) => j.status === 'running' || j.status === 'queued')
+            .map((j) => j.command);
+        const changes = (0, changes_reader_1.readChanges)(project.path, activeCommands);
+        res.json({ changes });
+    });
+    // ─── Change Artifact Browser ─────────────────────────────────────────────────
+    const ALLOWED_ARTIFACTS = new Set(['proposal.md', 'design.md', 'tasks.md', 'delta-spec.md', 'context-bundle.md']);
+    router.get('/:projectId/changes/:changeId/artifacts/:artifact', (req, res) => {
+        const changeId = req.params.changeId;
+        const artifact = req.params.artifact;
+        if (!ALLOWED_ARTIFACTS.has(artifact)) {
+            res.status(400).json({ error: 'Invalid artifact name' });
+            return;
+        }
+        // Sanitize changeId to prevent path traversal
+        if (!/^[\w-]+$/.test(changeId)) {
+            res.status(400).json({ error: 'Invalid change ID' });
+            return;
+        }
+        const { project } = ctx(req);
+        const changesRoot = path_1.default.join(project.path, 'openspec', 'changes');
+        // Check active dir first, then archive
+        let filePath = path_1.default.join(changesRoot, changeId, artifact);
+        if (!fs_1.default.existsSync(filePath)) {
+            filePath = path_1.default.join(changesRoot, 'archive', changeId, artifact);
+        }
+        if (!fs_1.default.existsSync(filePath)) {
+            res.status(404).json({ error: 'Artifact not found' });
+            return;
+        }
+        try {
+            const content = fs_1.default.readFileSync(filePath, 'utf-8');
+            res.json({ content, artifact, changeId });
+        }
+        catch {
+            res.status(500).json({ error: 'Failed to read artifact' });
+        }
+    });
+    // ─── Spec Launcher ───────────────────────────────────────────────────────────
+    router.post('/:projectId/spec-launcher/start', (req, res) => {
+        const { description } = req.body ?? {};
+        if (!description || typeof description !== 'string' || !description.trim()) {
+            res.status(400).json({ error: 'description is required' });
+            return;
+        }
+        const launchId = (0, ids_1.newId)();
+        res.status(202).json({ launchId });
+        ctx(req).specLauncherManager.launch(launchId, description.trim()).catch((err) => {
+            console.error('[project-router] spec-launcher error:', err);
+        });
+    });
+    router.delete('/:projectId/spec-launcher/:launchId', (req, res) => {
+        const { specLauncherManager } = ctx(req);
+        if (!specLauncherManager.isActive(req.params.launchId)) {
+            res.status(404).json({ error: 'No active launch with that ID' });
+            return;
+        }
+        specLauncherManager.cancel(req.params.launchId);
+        res.json({ ok: true });
+    });
+    // ─── Job Templates ────────────────────────────────────────────────────────
+    function templateToPublic(row) {
+        if (!row)
+            return null;
+        return {
+            id: row.id,
+            name: row.name,
+            description: row.description,
+            commands: JSON.parse(row.commands),
+            created_at: row.created_at,
+            updated_at: row.updated_at,
+        };
+    }
+    router.get('/:projectId/templates', (req, res) => {
+        const rows = (0, db_1.listTemplates)(ctx(req).db);
+        const templates = rows.map((r) => templateToPublic(r));
+        res.json({ templates });
+    });
+    router.post('/:projectId/templates', (req, res) => {
+        const { name, description, commands } = req.body ?? {};
+        if (!name || typeof name !== 'string' || !name.trim()) {
+            res.status(400).json({ error: 'name is required' });
+            return;
+        }
+        if (!Array.isArray(commands) || commands.length === 0) {
+            res.status(400).json({ error: 'commands must be a non-empty array' });
+            return;
+        }
+        if (commands.some((c) => typeof c !== 'string' || !String(c).trim())) {
+            res.status(400).json({ error: 'each command must be a non-empty string' });
+            return;
+        }
+        const id = (0, ids_1.newId)();
+        try {
+            (0, db_1.createTemplate)(ctx(req).db, {
+                id,
+                name: name.trim(),
+                description: description && typeof description === 'string' ? description.trim() : undefined,
+                commands: commands.map((c) => c.trim()),
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : '';
+            if (msg.includes('UNIQUE constraint failed')) {
+                res.status(409).json({ error: 'A template with that name already exists' });
+                return;
+            }
+            console.error('[project-router] create template error:', err);
+            res.status(500).json({ error: 'Internal server error' });
+            return;
+        }
+        const created = templateToPublic((0, db_1.getTemplate)(ctx(req).db, id));
+        res.status(201).json({ template: created });
+    });
+    router.get('/:projectId/templates/:templateId', (req, res) => {
+        const row = (0, db_1.getTemplate)(ctx(req).db, req.params.templateId);
+        if (!row) {
+            res.status(404).json({ error: 'Template not found' });
+            return;
+        }
+        res.json({ template: templateToPublic(row) });
+    });
+    router.patch('/:projectId/templates/:templateId', (req, res) => {
+        const { db } = ctx(req);
+        const templateId = req.params.templateId;
+        const row = (0, db_1.getTemplate)(db, templateId);
+        if (!row) {
+            res.status(404).json({ error: 'Template not found' });
+            return;
+        }
+        const { name, description, commands } = req.body ?? {};
+        const patch = {};
+        if (name !== undefined) {
+            if (typeof name !== 'string' || !name.trim()) {
+                res.status(400).json({ error: 'name must be a non-empty string' });
+                return;
+            }
+            patch.name = name.trim();
+        }
+        if (description !== undefined) {
+            patch.description = description === null ? null : String(description).trim() || null;
+        }
+        if (commands !== undefined) {
+            if (!Array.isArray(commands) || commands.length === 0) {
+                res.status(400).json({ error: 'commands must be a non-empty array' });
+                return;
+            }
+            if (commands.some((c) => typeof c !== 'string' || !String(c).trim())) {
+                res.status(400).json({ error: 'each command must be a non-empty string' });
+                return;
+            }
+            patch.commands = commands.map((c) => c.trim());
+        }
+        try {
+            (0, db_1.updateTemplate)(db, templateId, patch);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : '';
+            if (msg.includes('UNIQUE constraint failed')) {
+                res.status(409).json({ error: 'A template with that name already exists' });
+                return;
+            }
+            console.error('[project-router] update template error:', err);
+            res.status(500).json({ error: 'Internal server error' });
+            return;
+        }
+        const updated = templateToPublic((0, db_1.getTemplate)(db, templateId));
+        res.json({ ok: true, template: updated });
+    });
+    router.delete('/:projectId/templates/:templateId', (req, res) => {
+        const { db } = ctx(req);
+        const row = (0, db_1.getTemplate)(db, req.params.templateId);
+        if (!row) {
+            res.status(404).json({ error: 'Template not found' });
+            return;
+        }
+        (0, db_1.deleteTemplate)(db, req.params.templateId);
+        res.json({ ok: true });
+    });
+    router.post('/:projectId/templates/:templateId/run', (req, res) => {
+        const { db, queueManager } = ctx(req);
+        const row = (0, db_1.getTemplate)(db, req.params.templateId);
+        if (!row) {
+            res.status(404).json({ error: 'Template not found' });
+            return;
+        }
+        const commands = JSON.parse(row.commands);
+        const chain = req.body?.chain !== false; // default: chain jobs as pipeline
+        const jobIds = [];
+        try {
+            const pipelineId = chain && commands.length > 1 ? (0, ids_1.newId)() : undefined;
+            let prevJobId = null;
+            for (const command of commands) {
+                const job = queueManager.enqueue(command, 'normal', {
+                    dependsOnJobId: chain ? (prevJobId ?? undefined) : undefined,
+                    pipelineId,
+                });
+                jobIds.push(job.id);
+                prevJobId = job.id;
+            }
+        }
+        catch (err) {
+            if (err instanceof queue_manager_1.ClaudeNotFoundError) {
+                res.status(400).json({ error: err.message });
+                return;
+            }
+            console.error('[project-router] template run error:', err);
+            res.status(500).json({ error: 'Internal server error' });
+            return;
+        }
+        res.status(202).json({ ok: true, jobIds, templateId: row.id, templateName: row.name });
+    });
+    // ─── Integration contract ──────────────────────────────────────────────────
+    const DEFAULT_TICKET_CAPABILITIES = ['crud', 'labels', 'status', 'priorities', 'dependencies'];
+    const DEFAULT_TICKET_STORAGE_PATH = '.specrails/local-tickets.json';
+    // GET /:projectId/integration-contract — Return the project's integration contract with ticketProvider
+    router.get('/:projectId/integration-contract', (req, res) => {
+        const projectPath = ctx(req).project.path;
+        const contractFile = path_1.default.join(projectPath, '.claude', 'integration-contract.json');
+        let rawContract = {};
+        let source = 'default';
+        if (fs_1.default.existsSync(contractFile)) {
+            try {
+                rawContract = JSON.parse(fs_1.default.readFileSync(contractFile, 'utf-8'));
+                source = 'contract';
+            }
+            catch {
+                // malformed contract — fall back to defaults
+            }
+        }
+        const rawProvider = rawContract.ticketProvider;
+        const storagePath = rawProvider?.storagePath ?? DEFAULT_TICKET_STORAGE_PATH;
+        const ticketProvider = {
+            type: rawProvider?.type ?? 'local',
+            storagePath: path_1.default.resolve(projectPath, storagePath),
+            capabilities: rawProvider?.capabilities ?? DEFAULT_TICKET_CAPABILITIES,
+        };
+        res.json({ ticketProvider, source });
+    });
+}