specrails-desktop 2.64.2 → 2.65.0

package/server/dist/modules/recovery/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeDiagnosis = exports.rankRemedies = exports.presentFailureDiagnosis = exports.parseStoredDiagnosis = exports.parseCoreFailure = exports.parseBlocker = exports.oneSentence = exports.isDiagnosableOutcome = exports.deriveFailureDiagnosis = exports.REMEDY_IDS = exports.FAILURE_KINDS = void 0;
+// Public API of failure recovery: the diagnosis vocabulary and rules (pure).
+var domain_1 = require("./domain");
+Object.defineProperty(exports, "FAILURE_KINDS", { enumerable: true, get: function () { return domain_1.FAILURE_KINDS; } });
+Object.defineProperty(exports, "REMEDY_IDS", { enumerable: true, get: function () { return domain_1.REMEDY_IDS; } });
+Object.defineProperty(exports, "deriveFailureDiagnosis", { enumerable: true, get: function () { return domain_1.deriveFailureDiagnosis; } });
+Object.defineProperty(exports, "isDiagnosableOutcome", { enumerable: true, get: function () { return domain_1.isDiagnosableOutcome; } });
+Object.defineProperty(exports, "oneSentence", { enumerable: true, get: function () { return domain_1.oneSentence; } });
+Object.defineProperty(exports, "parseBlocker", { enumerable: true, get: function () { return domain_1.parseBlocker; } });
+Object.defineProperty(exports, "parseCoreFailure", { enumerable: true, get: function () { return domain_1.parseCoreFailure; } });
+Object.defineProperty(exports, "parseStoredDiagnosis", { enumerable: true, get: function () { return domain_1.parseStoredDiagnosis; } });
+Object.defineProperty(exports, "presentFailureDiagnosis", { enumerable: true, get: function () { return domain_1.presentFailureDiagnosis; } });
+Object.defineProperty(exports, "rankRemedies", { enumerable: true, get: function () { return domain_1.rankRemedies; } });
+Object.defineProperty(exports, "serializeDiagnosis", { enumerable: true, get: function () { return domain_1.serializeDiagnosis; } });

package/server/dist/modules/specs/adapters/timeline-http.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDiffReader = createDiffReader;
+exports.registerSpecTimelineRoutes = registerSpecTimelineRoutes;
+const feature_flags_1 = require("../../../feature-flags");
+const delivery_changes_1 = require("../../delivery/runtime/delivery-changes");
+const rail_pr_store_1 = require("../../delivery/runtime/rail-pr-store");
+const timeline_1 = require("../domain/timeline");
+const spec_history_1 = require("../runtime/spec-history");
+const spec_handoff_1 = require("../runtime/spec-handoff");
+const ticket_store_1 = require("../runtime/ticket-store");
+const TOP_FILES = 8;
+/** Diff stats come from the repository itself (the review packet's Changes read model), never from the ledger. */
+function createDiffReader(scope) {
+    return async (delivery) => {
+        if (!(0, feature_flags_1.isReviewPacketEnabled)())
+            return null;
+        const row = (0, rail_pr_store_1.getPrDelivery)(scope.db, delivery.id);
+        if (!row)
+            return null;
+        const changes = await (0, delivery_changes_1.composeDeliveryChanges)({ row, repoDir: scope.project.path, sourceId: null, repositoryId: null });
+        if (!changes.available)
+            return null;
+        const top = [...changes.files]
+            .sort((a, b) => ((b.additions ?? 0) + (b.deletions ?? 0)) - ((a.additions ?? 0) + (a.deletions ?? 0)))
+            .slice(0, TOP_FILES)
+            .map((f) => ({ path: f.path, status: f.status, additions: f.additions, deletions: f.deletions }));
+        return { files: changes.totals.files, additions: changes.totals.additions, deletions: changes.totals.deletions, top };
+    };
+}
+/**
+ * Spec lifecycle routes (a projection, no store of its own):
+ *  - `GET /:projectId/tickets/:ticketId/timeline` — merged, paged timeline.
+ *  - `GET /:projectId/tickets/:ticketId/handoff` — Markdown / HTML / PR-description export.
+ * Both read this project's own database and ticket file only.
+ */
+function registerSpecTimelineRoutes(router, deps) {
+    const loadTicket = (req, res) => {
+        const raw = String(req.params.ticketId);
+        if (!/^\d+$/.test(raw)) {
+            res.status(400).json({ error: 'Invalid ticket ID' });
+            return null;
+        }
+        const ticket = (0, ticket_store_1.readStore)(deps.ticketPath(req)).tickets[raw];
+        if (!ticket) {
+            res.status(404).json({ error: 'Ticket not found' });
+            return null;
+        }
+        return ticket;
+    };
+    router.get('/:projectId/tickets/:ticketId/timeline', (req, res) => {
+        const kinds = (0, timeline_1.parseKinds)(req.query.kinds);
+        if (kinds === null) {
+            res.status(400).json({ error: 'Invalid kinds' });
+            return;
+        }
+        const limit = (0, timeline_1.parseLimit)(req.query.limit);
+        if (limit === null) {
+            res.status(400).json({ error: 'Invalid limit' });
+            return;
+        }
+        const cursor = req.query.cursor === undefined || req.query.cursor === '' ? null : (0, timeline_1.decodeCursor)(req.query.cursor);
+        if (req.query.cursor !== undefined && req.query.cursor !== '' && !cursor) {
+            res.status(400).json({ error: 'Invalid cursor' });
+            return;
+        }
+        try {
+            const ticket = loadTicket(req, res);
+            if (!ticket)
+                return;
+            const history = (0, spec_history_1.collectSpecHistory)(deps.ctx(req).db, ticket);
+            res.json({ ticketId: ticket.id, ...(0, timeline_1.pageTimeline)(history.entries, { kinds, limit, cursor }) });
+        }
+        catch (err) {
+            console.error('[spec-timeline] projection failed:', err);
+            res.status(500).json({ error: 'Failed to build the timeline' });
+        }
+    });
+    router.get('/:projectId/tickets/:ticketId/handoff', async (req, res) => {
+        const format = (0, spec_handoff_1.parseHandoffFormat)(req.query.format);
+        if (!format) {
+            res.status(400).json({ error: 'Invalid format. Must be md, html or pr' });
+            return;
+        }
+        try {
+            const ticket = loadTicket(req, res);
+            if (!ticket)
+                return;
+            const scope = deps.ctx(req);
+            const history = (0, spec_history_1.collectSpecHistory)(scope.db, ticket);
+            const model = await (0, spec_handoff_1.buildHandoffModel)({
+                ticket, history, planProviders: (0, spec_handoff_1.parsePlanProviders)(req.query.planProviders), diffFor: createDiffReader(scope), now: new Date(),
+            });
+            res.json((0, spec_handoff_1.renderHandoff)(model, format, req.query.locale));
+        }
+        catch (err) {
+            console.error('[spec-timeline] handoff failed:', err);
+            res.status(500).json({ error: 'Failed to build the hand-off' });
+        }
+    });
+}

package/server/dist/modules/specs/domain/handoff-labels.js

@@ -0,0 +1,371 @@
+"use strict";
+/**
+ * Headings and fixed phrases of the exported hand-off document, per UI locale.
+ * The export is a document people paste into PRs and send to teammates, so its
+ * headings follow the language of the app that produced it. Source text (the
+ * spec, addenda, findings) is never translated.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HANDOFF_LOCALES = void 0;
+exports.isHandoffLocale = isHandoffLocale;
+exports.resolveHandoffLocale = resolveHandoffLocale;
+exports.handoffLabels = handoffLabels;
+exports.HANDOFF_LOCALES = ['en', 'es', 'fr', 'de', 'pt', 'it', 'zh', 'ja'];
+const en = {
+    document: 'Hand-off',
+    summary: 'Summary',
+    status: 'Status',
+    priority: 'Priority',
+    labels: 'Labels',
+    request: 'What was asked',
+    outOfScope: 'Out of scope',
+    decisions: 'Decisions',
+    noDecisions: 'No decisions recorded.',
+    decisionAddendum: 'Change request',
+    decisionClarification: 'Clarification',
+    decisionConstraint: 'Constraint',
+    decisionReview: 'Review feedback',
+    decisionVerdict: 'Reviewer verdict',
+    changes: 'Changes',
+    noChanges: 'No delivery has produced changes yet.',
+    diffUnavailable: 'The diff is no longer available.',
+    files: 'files',
+    deliveries: 'Deliveries',
+    cost: 'Cost',
+    billed: 'Billed (provider-reported)',
+    estimated: 'Estimated (pricing table)',
+    turns: 'turns',
+    runs: 'runs',
+    planNote: 'Plan-billed provider: turns are shown, not dollars.',
+    unpricedNote: 'runs reported no cost',
+    noCost: 'No AI usage is attributed to this spec.',
+    followUps: 'Open follow-ups',
+    noFollowUps: 'Nothing is left open.',
+    openAddenda: 'Open addenda',
+    unresolvedFindings: 'Unresolved review findings',
+    verification: 'Verification',
+    verdictApproved: 'Approved',
+    verdictChangesRequested: 'Changes requested',
+    verdictFailed: 'Verification failed',
+    verdictRecorded: 'Recorded',
+    noReview: 'No reviewer verdict recorded.',
+    generated: 'Generated',
+    pr: 'PR',
+    branch: 'Branch',
+    attribution: 'Generated by Specrails Desktop',
+};
+const es = {
+    document: 'Traspaso',
+    summary: 'Resumen',
+    status: 'Estado',
+    priority: 'Prioridad',
+    labels: 'Etiquetas',
+    request: 'Qué se pidió',
+    outOfScope: 'Fuera de alcance',
+    decisions: 'Decisiones',
+    noDecisions: 'No hay decisiones registradas.',
+    decisionAddendum: 'Petición de cambio',
+    decisionClarification: 'Aclaración',
+    decisionConstraint: 'Restricción',
+    decisionReview: 'Comentarios de revisión',
+    decisionVerdict: 'Veredicto del revisor',
+    changes: 'Cambios',
+    noChanges: 'Ninguna entrega ha producido cambios todavía.',
+    diffUnavailable: 'El diff ya no está disponible.',
+    files: 'archivos',
+    deliveries: 'Entregas',
+    cost: 'Coste',
+    billed: 'Facturado (informado por el proveedor)',
+    estimated: 'Estimado (tabla de precios)',
+    turns: 'turnos',
+    runs: 'ejecuciones',
+    planNote: 'Proveedor con plan: se muestran turnos, no dólares.',
+    unpricedNote: 'ejecuciones sin coste informado',
+    noCost: 'No hay uso de IA atribuido a esta spec.',
+    followUps: 'Pendientes abiertos',
+    noFollowUps: 'No queda nada abierto.',
+    openAddenda: 'Adendas abiertas',
+    unresolvedFindings: 'Hallazgos de revisión sin resolver',
+    verification: 'Verificación',
+    verdictApproved: 'Aprobado',
+    verdictChangesRequested: 'Cambios solicitados',
+    verdictFailed: 'La verificación falló',
+    verdictRecorded: 'Registrado',
+    noReview: 'No hay veredicto del revisor.',
+    generated: 'Generado',
+    pr: 'PR',
+    branch: 'Rama',
+    attribution: 'Generado por Specrails Desktop',
+};
+const fr = {
+    document: 'Passation',
+    summary: 'Résumé',
+    status: 'Statut',
+    priority: 'Priorité',
+    labels: 'Étiquettes',
+    request: 'Ce qui a été demandé',
+    outOfScope: 'Hors périmètre',
+    decisions: 'Décisions',
+    noDecisions: 'Aucune décision enregistrée.',
+    decisionAddendum: 'Demande de changement',
+    decisionClarification: 'Clarification',
+    decisionConstraint: 'Contrainte',
+    decisionReview: 'Retours de relecture',
+    decisionVerdict: 'Verdict du relecteur',
+    changes: 'Modifications',
+    noChanges: 'Aucune livraison n’a encore produit de modifications.',
+    diffUnavailable: 'Le diff n’est plus disponible.',
+    files: 'fichiers',
+    deliveries: 'Livraisons',
+    cost: 'Coût',
+    billed: 'Facturé (communiqué par le fournisseur)',
+    estimated: 'Estimé (grille tarifaire)',
+    turns: 'tours',
+    runs: 'exécutions',
+    planNote: 'Fournisseur sous forfait : les tours sont affichés, pas les dollars.',
+    unpricedNote: 'exécutions sans coût communiqué',
+    noCost: 'Aucune utilisation d’IA n’est attribuée à cette spec.',
+    followUps: 'Suivis ouverts',
+    noFollowUps: 'Rien n’est resté ouvert.',
+    openAddenda: 'Addenda ouverts',
+    unresolvedFindings: 'Constats de relecture non résolus',
+    verification: 'Vérification',
+    verdictApproved: 'Approuvé',
+    verdictChangesRequested: 'Modifications demandées',
+    verdictFailed: 'La vérification a échoué',
+    verdictRecorded: 'Enregistré',
+    noReview: 'Aucun verdict du relecteur enregistré.',
+    generated: 'Généré',
+    pr: 'PR',
+    branch: 'Branche',
+    attribution: 'Généré par Specrails Desktop',
+};
+const de = {
+    document: 'Übergabe',
+    summary: 'Zusammenfassung',
+    status: 'Status',
+    priority: 'Priorität',
+    labels: 'Labels',
+    request: 'Was verlangt wurde',
+    outOfScope: 'Nicht im Umfang',
+    decisions: 'Entscheidungen',
+    noDecisions: 'Keine Entscheidungen erfasst.',
+    decisionAddendum: 'Änderungswunsch',
+    decisionClarification: 'Klärung',
+    decisionConstraint: 'Einschränkung',
+    decisionReview: 'Review-Feedback',
+    decisionVerdict: 'Urteil des Reviewers',
+    changes: 'Änderungen',
+    noChanges: 'Noch keine Lieferung hat Änderungen erzeugt.',
+    diffUnavailable: 'Der Diff ist nicht mehr verfügbar.',
+    files: 'Dateien',
+    deliveries: 'Lieferungen',
+    cost: 'Kosten',
+    billed: 'Abgerechnet (vom Anbieter gemeldet)',
+    estimated: 'Geschätzt (Preistabelle)',
+    turns: 'Turns',
+    runs: 'Läufe',
+    planNote: 'Anbieter mit Abo: Es werden Turns gezeigt, keine Dollar.',
+    unpricedNote: 'Läufe ohne gemeldete Kosten',
+    noCost: 'Dieser Spec ist keine KI-Nutzung zugeordnet.',
+    followUps: 'Offene Folgeaufgaben',
+    noFollowUps: 'Nichts ist offen.',
+    openAddenda: 'Offene Nachträge',
+    unresolvedFindings: 'Ungelöste Review-Befunde',
+    verification: 'Verifikation',
+    verdictApproved: 'Freigegeben',
+    verdictChangesRequested: 'Änderungen angefordert',
+    verdictFailed: 'Verifikation fehlgeschlagen',
+    verdictRecorded: 'Erfasst',
+    noReview: 'Kein Urteil des Reviewers erfasst.',
+    generated: 'Erstellt',
+    pr: 'PR',
+    branch: 'Branch',
+    attribution: 'Erstellt von Specrails Desktop',
+};
+const pt = {
+    document: 'Passagem',
+    summary: 'Resumo',
+    status: 'Estado',
+    priority: 'Prioridade',
+    labels: 'Etiquetas',
+    request: 'O que foi pedido',
+    outOfScope: 'Fora do âmbito',
+    decisions: 'Decisões',
+    noDecisions: 'Nenhuma decisão registada.',
+    decisionAddendum: 'Pedido de alteração',
+    decisionClarification: 'Esclarecimento',
+    decisionConstraint: 'Restrição',
+    decisionReview: 'Comentários da revisão',
+    decisionVerdict: 'Veredito do revisor',
+    changes: 'Alterações',
+    noChanges: 'Nenhuma entrega produziu alterações ainda.',
+    diffUnavailable: 'O diff já não está disponível.',
+    files: 'ficheiros',
+    deliveries: 'Entregas',
+    cost: 'Custo',
+    billed: 'Faturado (reportado pelo fornecedor)',
+    estimated: 'Estimado (tabela de preços)',
+    turns: 'turnos',
+    runs: 'execuções',
+    planNote: 'Fornecedor com plano: mostram-se turnos, não dólares.',
+    unpricedNote: 'execuções sem custo reportado',
+    noCost: 'Não há uso de IA atribuído a esta spec.',
+    followUps: 'Pendências em aberto',
+    noFollowUps: 'Nada ficou em aberto.',
+    openAddenda: 'Adendas abertas',
+    unresolvedFindings: 'Achados de revisão por resolver',
+    verification: 'Verificação',
+    verdictApproved: 'Aprovado',
+    verdictChangesRequested: 'Alterações pedidas',
+    verdictFailed: 'A verificação falhou',
+    verdictRecorded: 'Registado',
+    noReview: 'Nenhum veredito do revisor registado.',
+    generated: 'Gerado',
+    pr: 'PR',
+    branch: 'Ramo',
+    attribution: 'Gerado pelo Specrails Desktop',
+};
+const it = {
+    document: 'Passaggio di consegne',
+    summary: 'Riepilogo',
+    status: 'Stato',
+    priority: 'Priorità',
+    labels: 'Etichette',
+    request: 'Cosa è stato chiesto',
+    outOfScope: 'Fuori ambito',
+    decisions: 'Decisioni',
+    noDecisions: 'Nessuna decisione registrata.',
+    decisionAddendum: 'Richiesta di modifica',
+    decisionClarification: 'Chiarimento',
+    decisionConstraint: 'Vincolo',
+    decisionReview: 'Feedback della revisione',
+    decisionVerdict: 'Verdetto del revisore',
+    changes: 'Modifiche',
+    noChanges: 'Nessuna consegna ha ancora prodotto modifiche.',
+    diffUnavailable: 'Il diff non è più disponibile.',
+    files: 'file',
+    deliveries: 'Consegne',
+    cost: 'Costo',
+    billed: 'Fatturato (riportato dal provider)',
+    estimated: 'Stimato (tabella prezzi)',
+    turns: 'turni',
+    runs: 'esecuzioni',
+    planNote: 'Provider con abbonamento: si mostrano i turni, non i dollari.',
+    unpricedNote: 'esecuzioni senza costo riportato',
+    noCost: 'Nessun uso di IA è attribuito a questa spec.',
+    followUps: 'Follow-up aperti',
+    noFollowUps: 'Non resta nulla di aperto.',
+    openAddenda: 'Addenda aperti',
+    unresolvedFindings: 'Rilievi di revisione non risolti',
+    verification: 'Verifica',
+    verdictApproved: 'Approvato',
+    verdictChangesRequested: 'Modifiche richieste',
+    verdictFailed: 'Verifica non riuscita',
+    verdictRecorded: 'Registrato',
+    noReview: 'Nessun verdetto del revisore registrato.',
+    generated: 'Generato',
+    pr: 'PR',
+    branch: 'Branch',
+    attribution: 'Generato da Specrails Desktop',
+};
+const zh = {
+    document: '交接',
+    summary: '摘要',
+    status: '状态',
+    priority: '优先级',
+    labels: '标签',
+    request: '需求内容',
+    outOfScope: '不在范围内',
+    decisions: '决策',
+    noDecisions: '没有记录的决策。',
+    decisionAddendum: '变更请求',
+    decisionClarification: '澄清',
+    decisionConstraint: '约束',
+    decisionReview: '评审反馈',
+    decisionVerdict: '评审结论',
+    changes: '变更',
+    noChanges: '尚无交付产生变更。',
+    diffUnavailable: '差异已不可用。',
+    files: '个文件',
+    deliveries: '交付',
+    cost: '成本',
+    billed: '已计费（提供方报告）',
+    estimated: '估算（价格表）',
+    turns: '轮',
+    runs: '次运行',
+    planNote: '订阅制提供方：显示轮数，不显示美元。',
+    unpricedNote: '次运行未报告成本',
+    noCost: '此规格没有归属的 AI 用量。',
+    followUps: '未完成的后续事项',
+    noFollowUps: '没有遗留事项。',
+    openAddenda: '未处理的补充',
+    unresolvedFindings: '未解决的评审发现',
+    verification: '验证',
+    verdictApproved: '已批准',
+    verdictChangesRequested: '要求修改',
+    verdictFailed: '验证失败',
+    verdictRecorded: '已记录',
+    noReview: '没有记录的评审结论。',
+    generated: '生成于',
+    pr: 'PR',
+    branch: '分支',
+    attribution: '由 Specrails Desktop 生成',
+};
+const ja = {
+    document: '引き継ぎ',
+    summary: '概要',
+    status: 'ステータス',
+    priority: '優先度',
+    labels: 'ラベル',
+    request: '依頼内容',
+    outOfScope: '対象外',
+    decisions: '決定事項',
+    noDecisions: '記録された決定事項はありません。',
+    decisionAddendum: '変更依頼',
+    decisionClarification: '確認事項',
+    decisionConstraint: '制約',
+    decisionReview: 'レビューのフィードバック',
+    decisionVerdict: 'レビュアーの判定',
+    changes: '変更内容',
+    noChanges: '変更を生成したデリバリーはまだありません。',
+    diffUnavailable: '差分は利用できなくなりました。',
+    files: 'ファイル',
+    deliveries: 'デリバリー',
+    cost: 'コスト',
+    billed: '請求済み（プロバイダー報告）',
+    estimated: '推定（料金表）',
+    turns: 'ターン',
+    runs: '回の実行',
+    planNote: 'プラン課金のプロバイダー: ドルではなくターン数を表示しています。',
+    unpricedNote: '回の実行はコストが報告されていません',
+    noCost: 'このスペックに紐づく AI 利用はありません。',
+    followUps: '未対応のフォローアップ',
+    noFollowUps: '未対応の項目はありません。',
+    openAddenda: '未処理の補足',
+    unresolvedFindings: '未解決のレビュー指摘',
+    verification: '検証',
+    verdictApproved: '承認',
+    verdictChangesRequested: '変更依頼',
+    verdictFailed: '検証失敗',
+    verdictRecorded: '記録済み',
+    noReview: 'レビュアーの判定は記録されていません。',
+    generated: '生成日時',
+    pr: 'PR',
+    branch: 'ブランチ',
+    attribution: 'Specrails Desktop により生成',
+};
+const BY_LOCALE = { en, es, fr, de, pt, it, zh, ja };
+function isHandoffLocale(value) {
+    return typeof value === 'string' && exports.HANDOFF_LOCALES.includes(value);
+}
+/** `es-ES` -> `es`; anything unknown falls back to English. */
+function resolveHandoffLocale(value) {
+    if (typeof value !== 'string')
+        return 'en';
+    const base = value.toLowerCase().split(/[-_]/)[0];
+    return isHandoffLocale(base) ? base : 'en';
+}
+function handoffLabels(locale) {
+    return BY_LOCALE[locale];
+}