specrails-desktop 2.2.1 → 2.3.0

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

@@ -0,0 +1,218 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerChatRoutes = registerChatRoutes;
+const ids_1 = require("./ids");
+const db_1 = require("./db");
+const context_scope_1 = require("./context-scope");
+const spec_models_1 = require("./spec-models");
+const provider_selection_1 = require("./provider-selection");
+const ticket_store_1 = require("./ticket-store");
+const project_router_helpers_1 = require("./project-router-helpers");
+function registerChatRoutes(deps) {
+    const { router, registry, ctx, ticketPath } = deps;
+    // ─── Chat routes ─────────────────────────────────────────────────────────────
+    router.get('/:projectId/chat/conversations', (req, res) => {
+        const conversations = (0, db_1.listConversations)(ctx(req).db);
+        res.json({ conversations });
+    });
+    router.post('/:projectId/chat/conversations', (req, res) => {
+        const { db, project } = ctx(req);
+        // Multi-provider: an optional aiEngine (alias: provider) picks which engine
+        // this conversation runs on. It must be installed on the project; omitting
+        // it uses the project's primary provider. The chosen provider drives model
+        // validation and is persisted on the conversation so resume turns and
+        // ai_invocations attribute to the right engine.
+        const requestedEngine = req.body?.aiEngine ?? req.body?.provider;
+        const engineCheck = (0, provider_selection_1.validateRequestedProvider)(project, requestedEngine);
+        if (!engineCheck.ok) {
+            res.status(400).json({ error: engineCheck.error });
+            return;
+        }
+        const provider = engineCheck.provider;
+        const rawModel = req.body?.model;
+        let model;
+        if (rawModel === undefined || rawModel === null || rawModel === '') {
+            model = (0, project_router_helpers_1.resolveDefaultSpecModel)({ projectPath: project.path, provider });
+        }
+        else if ((0, spec_models_1.isValidModelForProvider)(rawModel, provider)) {
+            model = rawModel;
+        }
+        else {
+            res.status(400).json({
+                error: `Invalid model "${String(rawModel)}" for provider "${provider}"`,
+                allowed: (0, spec_models_1.getModelsForProvider)(provider).map((m) => m.value),
+            });
+            return;
+        }
+        const rawKind = req.body?.kind;
+        const kind = rawKind === 'explore' ? 'explore' : 'sidebar';
+        const id = (0, ids_1.newId)();
+        const rawScope = req.body?.contextScope;
+        if (rawScope !== undefined && kind !== 'explore') {
+            res.status(400).json({ error: 'contextScope is only allowed for kind=explore' });
+            return;
+        }
+        let scope;
+        if (kind === 'explore') {
+            const fallback = (0, context_scope_1.getLastContextScope)(db, 'explore');
+            // Defence-in-depth: SMASH / Contract Layer is Claude-only. Strip
+            // contractRefine from the scope when the conversation's resolved provider
+            // is non-Claude so no downstream code (Contract Refine Runner, SMASH
+            // eligibility) ever sees a mismatched flag.
+            const safeRawScope = provider !== 'claude' && rawScope != null
+                ? { ...rawScope, contractRefine: false }
+                : rawScope;
+            scope = (0, context_scope_1.normalizeContextScope)(safeRawScope ?? fallback, fallback);
+            (0, context_scope_1.setLastContextScope)(db, scope);
+            console.log(`[project-router] new explore conv ${id} provider=${provider} scope=${JSON.stringify(scope)} rawScope=${JSON.stringify(rawScope)}`);
+        }
+        // Only persist provider when the project is multi-provider; single-provider
+        // projects leave it NULL so behaviour is byte-identical to before.
+        const persistProvider = (0, provider_selection_1.isMultiProvider)(project) ? provider : null;
+        (0, db_1.createConversation)(db, { id, model, kind, contextScope: scope, provider: persistProvider });
+        const conversation = (0, db_1.getConversation)(db, id);
+        res.status(201).json({ conversation });
+    });
+    router.get('/:projectId/chat/conversations/:id', (req, res) => {
+        const { db } = ctx(req);
+        const conversation = (0, db_1.getConversation)(db, req.params.id);
+        if (!conversation) {
+            res.status(404).json({ error: 'Conversation not found' });
+            return;
+        }
+        const messages = (0, db_1.getMessages)(db, req.params.id);
+        res.json({ conversation, messages });
+    });
+    router.delete('/:projectId/chat/conversations/:id', (req, res) => {
+        const { db, chatManager, broadcast, project, ticketWatcher } = ctx(req);
+        const convId = req.params.id;
+        const conversation = (0, db_1.getConversation)(db, convId);
+        if (!conversation) {
+            res.status(404).json({ error: 'Conversation not found' });
+            return;
+        }
+        (0, db_1.deleteConversation)(db, convId);
+        chatManager?.forgetSpecDraft(convId);
+        chatManager?.forgetExploreLifecycle(convId);
+        // Cascade-clear origin_conversation_id on any ticket that referenced this
+        // conversation (application-level "ON DELETE SET NULL").
+        try {
+            const filePath = ticketPath(req);
+            const store = (0, ticket_store_1.mutateStore)(filePath, (s) => {
+                for (const id of Object.keys(s.tickets)) {
+                    if (s.tickets[id].origin_conversation_id === convId) {
+                        s.tickets[id].origin_conversation_id = null;
+                        s.tickets[id].updated_at = new Date().toISOString();
+                    }
+                }
+            });
+            ticketWatcher.notifyDesktopWrite(store.revision);
+            // No per-ticket broadcast: the cleared field is metadata-only and the
+            // board card visual treatment doesn't depend on it.
+        }
+        catch (err) {
+            console.error('[project-router] conversation-cascade ticket update error:', err);
+        }
+        res.json({ ok: true });
+    });
+    router.patch('/:projectId/chat/conversations/:id', (req, res) => {
+        const { db } = ctx(req);
+        const conversation = (0, db_1.getConversation)(db, req.params.id);
+        if (!conversation) {
+            res.status(404).json({ error: 'Conversation not found' });
+            return;
+        }
+        const { title, model } = req.body ?? {};
+        const patch = {};
+        if (title !== undefined)
+            patch.title = title;
+        if (model !== undefined)
+            patch.model = model;
+        (0, db_1.updateConversation)(db, req.params.id, patch);
+        const updated = (0, db_1.getConversation)(db, req.params.id);
+        res.json({ ok: true, conversation: updated });
+    });
+    router.get('/:projectId/chat/conversations/:id/messages', (req, res) => {
+        const { db } = ctx(req);
+        const conversation = (0, db_1.getConversation)(db, req.params.id);
+        if (!conversation) {
+            res.status(404).json({ error: 'Conversation not found' });
+            return;
+        }
+        const messages = (0, db_1.getMessages)(db, req.params.id);
+        res.json({ messages });
+    });
+    // Returns the in-memory spec-draft state Claude has accumulated for this
+    // conversation. Used by useSpecDraftStream on mount to rehydrate updates
+    // that were broadcast while the client wasn't subscribed (refresh /
+    // minimize-and-restore). Returns 200 with `null` draft when no state yet.
+    router.get('/:projectId/chat/conversations/:id/spec-draft', (req, res) => {
+        const { db, chatManager } = ctx(req);
+        const conversation = (0, db_1.getConversation)(db, req.params.id);
+        if (!conversation) {
+            res.status(404).json({ error: 'Conversation not found' });
+            return;
+        }
+        const state = chatManager.getSpecDraftState(req.params.id);
+        if (!state) {
+            res.json({ draft: null, ready: false, chips: [] });
+            return;
+        }
+        res.json({
+            draft: state.draft,
+            ready: state.ready,
+            chips: state.chips,
+        });
+    });
+    router.post('/:projectId/chat/conversations/:id/messages', async (req, res) => {
+        const { db, chatManager, project } = ctx(req);
+        const conversation = (0, db_1.getConversation)(db, req.params.id);
+        if (!conversation) {
+            res.status(404).json({ error: 'Conversation not found' });
+            return;
+        }
+        const text = req.body?.text;
+        if (!text || !text.trim()) {
+            res.status(400).json({ error: 'text is required' });
+            return;
+        }
+        if (chatManager.isActive(req.params.id)) {
+            res.status(409).json({ error: 'CONVERSATION_BUSY' });
+            return;
+        }
+        const lightweight = req.body?.lightweight === true;
+        const maxTurns = typeof req.body?.maxTurns === 'number' ? req.body.maxTurns : undefined;
+        let attachments;
+        const rawAtt = req.body?.attachments;
+        if (rawAtt && typeof rawAtt === 'object' && typeof rawAtt.ticketKey === 'string'
+            && Array.isArray(rawAtt.ids)) {
+            const ids = rawAtt.ids.filter((x) => typeof x === 'string');
+            if (ids.length > 0) {
+                attachments = { slug: project.slug, ticketKey: rawAtt.ticketKey, ids };
+            }
+        }
+        res.status(202).json({ ok: true });
+        chatManager.sendMessage(req.params.id, text.trim(), { lightweight, maxTurns, attachments }).catch((err) => {
+            console.error('[project-router] chat sendMessage error:', err);
+        });
+    });
+    router.delete('/:projectId/chat/conversations/:id/messages/stream', (req, res) => {
+        const { chatManager } = ctx(req);
+        if (!chatManager.isActive(req.params.id)) {
+            res.status(404).json({ error: 'No active stream for this conversation' });
+            return;
+        }
+        chatManager.abort(req.params.id);
+        res.json({ ok: true });
+    });
+    // Explore Spec lifecycle: minimize-to-toast hint and restore-from-toast hint.
+    // Idempotent; does not mutate persistent state. See design.md D7.
+    router.post('/:projectId/chat/conversations/:id/minimize', (req, res) => {
+        ctx(req).chatManager.notifyMinimized(req.params.id);
+        res.json({ ok: true });
+    });
+    router.post('/:projectId/chat/conversations/:id/restore', (req, res) => {
+        ctx(req).chatManager.notifyRestored(req.params.id);
+        res.json({ ok: true });
+    });
+}

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;
+}