@straiffi/archon 1.2.34 → 1.3.1

package/dist/server/lib/specArtifact.js

@@ -0,0 +1,353 @@
+const SPEC_ARTIFACT_TAG = 'archon-spec-artifact';
+const SPEC_GRILL_QUESTION_TAG = 'archon-grill-question';
+const normalizeRequiredString = (value) => {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed ? trimmed : null;
+};
+const normalizeStringArray = (value) => {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value
+        .filter((item) => typeof item === 'string')
+        .map(item => item.trim())
+        .filter(Boolean);
+};
+const normalizeLikelyFiles = (value) => {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value
+        .filter((item) => typeof item === 'object' &&
+        item !== null &&
+        typeof item.path === 'string' &&
+        typeof item.reason === 'string')
+        .map(item => ({
+        path: item.path.trim(),
+        reason: item.reason.trim(),
+    }))
+        .filter(item => item.path && item.reason);
+};
+const normalizeSnapshotTickets = (value) => {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value
+        .filter((item) => typeof item === 'object' &&
+        item !== null &&
+        typeof item.key === 'string' &&
+        typeof item.title === 'string' &&
+        typeof item.description === 'string')
+        .map(item => ({
+        key: item.key.trim(),
+        title: item.title.trim(),
+        description: item.description.trim(),
+    }))
+        .filter(item => item.key && item.title && item.description);
+};
+const normalizeSnapshotDependencies = (value) => {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value
+        .filter((item) => typeof item === 'object' &&
+        item !== null &&
+        typeof item.blocker_key === 'string' &&
+        typeof item.dependent_key === 'string')
+        .map(item => ({
+        blocker_key: item.blocker_key.trim(),
+        dependent_key: item.dependent_key.trim(),
+    }))
+        .filter(item => item.blocker_key && item.dependent_key && item.blocker_key !== item.dependent_key);
+};
+const stripSpecArtifactBlock = (output) => {
+    return output
+        .replace(new RegExp(`<\\s*${SPEC_ARTIFACT_TAG}\\s*>[\\s\\S]*?<\\s*/\\s*${SPEC_ARTIFACT_TAG}\\s*>`, 'g'), '')
+        .trim();
+};
+/**
+ * Escape literal control characters (newlines, tabs, carriage returns) that appear
+ * inside JSON string values. LLMs frequently emit literal newlines inside multi-line
+ * string fields (e.g. mermaid diagrams, ticket descriptions), which causes JSON.parse
+ * to throw. This sanitizer walks the raw text tracking whether we're inside a string
+ * value and escapes only the control characters found there, leaving structural
+ * whitespace untouched.
+ */
+const sanitizeJsonControlChars = (raw) => {
+    let result = '';
+    let insideString = false;
+    let escaped = false;
+    for (let i = 0; i < raw.length; i++) {
+        const char = raw[i];
+        if (insideString) {
+            if (escaped) {
+                result += char;
+                escaped = false;
+                continue;
+            }
+            if (char === '\\') {
+                result += char;
+                escaped = true;
+                continue;
+            }
+            if (char === '"') {
+                result += char;
+                insideString = false;
+                continue;
+            }
+            if (char === '\n') {
+                result += '\\n';
+                continue;
+            }
+            if (char === '\r') {
+                result += '\\r';
+                continue;
+            }
+            if (char === '\t') {
+                result += '\\t';
+                continue;
+            }
+            result += char;
+        }
+        else {
+            if (char === '"') {
+                insideString = true;
+            }
+            result += char;
+        }
+    }
+    return result;
+};
+export const extractSpecArtifactFromOutput = (output) => {
+    const match = output.match(new RegExp(`<\\s*${SPEC_ARTIFACT_TAG}\\s*>([\\s\\S]*?)<\\s*/\\s*${SPEC_ARTIFACT_TAG}\\s*>`));
+    if (!match) {
+        return {
+            cleanedOutput: output.trim(),
+            artifact: null,
+            presence: null,
+            error: 'No spec artifact block found in planner response',
+        };
+    }
+    let parsed;
+    try {
+        const sanitized = sanitizeJsonControlChars(match[1].trim());
+        parsed = JSON.parse(sanitized);
+    }
+    catch {
+        return {
+            cleanedOutput: stripSpecArtifactBlock(output),
+            artifact: null,
+            presence: null,
+            error: 'Spec artifact block contains invalid JSON',
+        };
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        return {
+            cleanedOutput: stripSpecArtifactBlock(output),
+            artifact: null,
+            presence: null,
+            error: 'Spec artifact block does not contain a valid JSON object',
+        };
+    }
+    const summary = normalizeRequiredString(parsed.summary);
+    if (!summary) {
+        return {
+            cleanedOutput: stripSpecArtifactBlock(output),
+            artifact: null,
+            presence: null,
+            error: 'Spec artifact is missing required "summary" field',
+        };
+    }
+    const tickets = normalizeSnapshotTickets(parsed.tickets);
+    if (!tickets.length) {
+        return {
+            cleanedOutput: stripSpecArtifactBlock(output),
+            artifact: null,
+            presence: null,
+            error: 'Spec artifact is missing required "tickets" field',
+        };
+    }
+    // Presence is derived from the raw parsed value, before normalization, so the
+    // resolver can tell "LLM omitted this field" (carry forward) apart from "LLM
+    // emitted an empty array" (deliberate clear). Only well-formed arrays count as
+    // present; malformed values fall back to carry-forward to protect information.
+    const presence = {
+        assumptions: Array.isArray(parsed.assumptions),
+        openQuestions: Array.isArray(parsed.open_questions),
+        likelyFiles: Array.isArray(parsed.likely_files),
+        dependencies: Array.isArray(parsed.dependencies),
+    };
+    const artifact = {
+        summary,
+        assumptions: normalizeStringArray(parsed.assumptions),
+        openQuestions: normalizeStringArray(parsed.open_questions),
+        likelyFiles: normalizeLikelyFiles(parsed.likely_files),
+        tickets,
+        dependencies: normalizeSnapshotDependencies(parsed.dependencies),
+    };
+    return {
+        cleanedOutput: stripSpecArtifactBlock(output),
+        artifact,
+        presence,
+        error: null,
+    };
+};
+export const extractLastMermaidBlock = (output) => {
+    const matches = [...output.matchAll(/```mermaid\s*\n([\s\S]*?)```/g)];
+    if (matches.length === 0) {
+        return null;
+    }
+    const lastMatch = matches[matches.length - 1];
+    return lastMatch[1] ? lastMatch[1].trim() : null;
+};
+export const stripMermaidBlocks = (output) => {
+    return output
+        .replace(/```mermaid\s*\n[\s\S]*?```/g, '')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+};
+export const extractLastMockupBlock = (output) => {
+    const matches = [...output.matchAll(/```archon-mockup\s*\n([\s\S]*?)```/g)];
+    if (matches.length === 0) {
+        return null;
+    }
+    const lastMatch = matches[matches.length - 1];
+    const content = lastMatch[1] ? lastMatch[1].trim() : '';
+    return content ? content : null;
+};
+export const stripMockupBlocks = (output) => {
+    return output
+        .replace(/```archon-mockup\s*\n[\s\S]*?```/g, '')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+};
+/**
+ * Resolve the mermaid/mockup values to persist for a turn. A block emitted in the
+ * current response overrides the previous snapshot's value; an omitted block is
+ * carried forward so established side-channel artifacts don't disappear when a
+ * follow-up turn produces a new snapshot without re-emitting them.
+ */
+export const resolveCarriedForwardArtifacts = ({ rawResponse, previousMermaid, previousMockup, }) => {
+    return {
+        mermaid: extractLastMermaidBlock(rawResponse) ?? previousMermaid ?? null,
+        mockup: extractLastMockupBlock(rawResponse) ?? previousMockup ?? null,
+    };
+};
+/**
+ * Resolve the optional structured array fields to persist for a turn. A field
+ * the LLM explicitly emitted (presence true) overrides the previous snapshot's
+ * value — including an explicit empty array, which means "clear this field". A
+ * field the LLM omitted (presence false) is carried forward unchanged so
+ * follow-up turns never silently drop information that is still part of the
+ * spec. Summary and tickets are not handled here: summary is always taken from
+ * the current artifact, and tickets are required on every artifact so they can
+ * never be omitted.
+ */
+export const resolveCarriedForwardStructuredFields = ({ artifact, presence, previous, }) => {
+    return {
+        assumptions: presence.assumptions ? artifact.assumptions : (previous?.assumptions ?? []),
+        openQuestions: presence.openQuestions ? artifact.openQuestions : (previous?.openQuestions ?? []),
+        likelyFiles: presence.likelyFiles ? artifact.likelyFiles : (previous?.likelyFiles ?? []),
+        dependencies: presence.dependencies ? artifact.dependencies : (previous?.dependencies ?? []),
+    };
+};
+const stripGrillQuestionBlock = (output) => {
+    return output
+        .replace(new RegExp(`<\\s*${SPEC_GRILL_QUESTION_TAG}\\s*>[\\s\\S]*?<\\s*/\\s*${SPEC_GRILL_QUESTION_TAG}\\s*>`, 'g'), '')
+        .trim();
+};
+const normalizeGrillSuggestion = (value, fallbackId) => {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return null;
+    }
+    const raw = value;
+    const label = typeof raw.label === 'string' ? raw.label.trim() : '';
+    const stringValue = typeof raw.value === 'string' ? raw.value.trim() : '';
+    if (!label && !stringValue) {
+        return null;
+    }
+    const id = typeof raw.id === 'string' && raw.id.trim()
+        ? raw.id.trim()
+        : fallbackId;
+    return {
+        id,
+        label: label || stringValue,
+        value: stringValue || label,
+        ...(raw.recommended === true ? { recommended: true } : {}),
+    };
+};
+const normalizeGrillSuggestions = (value) => {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    const suggestions = [];
+    value.forEach((item, index) => {
+        const normalized = normalizeGrillSuggestion(item, `suggestion-${index + 1}`);
+        if (normalized) {
+            suggestions.push(normalized);
+        }
+    });
+    return suggestions;
+};
+export const extractGrillQuestionFromOutput = (output) => {
+    if (!output) {
+        return {
+            cleanedOutput: '',
+            grillQuestion: null,
+            error: 'Empty grill output',
+        };
+    }
+    const match = output.match(new RegExp(`<\\s*${SPEC_GRILL_QUESTION_TAG}\\s*>([\\s\\S]*?)<\\s*/\\s*${SPEC_GRILL_QUESTION_TAG}\\s*>`));
+    if (!match) {
+        return {
+            cleanedOutput: output.trim(),
+            grillQuestion: null,
+            error: 'No grill question block found in planner response',
+        };
+    }
+    let parsed;
+    try {
+        const sanitized = sanitizeJsonControlChars(match[1].trim());
+        parsed = JSON.parse(sanitized);
+    }
+    catch {
+        return {
+            cleanedOutput: stripGrillQuestionBlock(output),
+            grillQuestion: null,
+            error: 'Grill question block contains invalid JSON',
+        };
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        return {
+            cleanedOutput: stripGrillQuestionBlock(output),
+            grillQuestion: null,
+            error: 'Grill question block does not contain a valid JSON object',
+        };
+    }
+    const question = normalizeRequiredString(parsed.question);
+    if (!question) {
+        return {
+            cleanedOutput: stripGrillQuestionBlock(output),
+            grillQuestion: null,
+            error: 'Grill question is missing required "question" field',
+        };
+    }
+    const suggestions = normalizeGrillSuggestions(parsed.suggestions);
+    const rationale = typeof parsed.rationale === 'string' && parsed.rationale.trim()
+        ? parsed.rationale.trim()
+        : undefined;
+    const grillQuestion = {
+        question,
+        ...(rationale ? { rationale } : {}),
+        suggestions,
+    };
+    return {
+        cleanedOutput: stripGrillQuestionBlock(output),
+        grillQuestion,
+        error: null,
+    };
+};
+//# sourceMappingURL=specArtifact.js.map

package/dist/server/lib/specArtifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specArtifact.js","sourceRoot":"","sources":["../../../server/lib/specArtifact.ts"],"names":[],"mappings":"AAEA,MAAM,iBAAiB,GAAG,sBAAsB,CAAA;AAChD,MAAM,uBAAuB,GAAG,uBAAuB,CAAA;AA2CvD,MAAM,uBAAuB,GAAG,CAAC,KAAc,EAAiB,EAAE;IAChE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC5B,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAA;AACjC,CAAC,CAAA;AAED,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAY,EAAE;IACxD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAA;IACX,CAAC;IAED,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC;SAC1D,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SACxB,MAAM,CAAC,OAAO,CAAC,CAAA;AACpB,CAAC,CAAA;AAED,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAA4B,EAAE;IACxE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAA;IACX,CAAC;IAED,OAAO,KAAK;SACT,MAAM,CACL,CAAC,IAAI,EAAkC,EAAE,CACvC,OAAO,IAAI,KAAK,QAAQ;QACxB,IAAI,KAAK,IAAI;QACb,OAAQ,IAA+B,CAAC,IAAI,KAAK,QAAQ;QACzD,OAAQ,IAA+B,CAAC,MAAM,KAAK,QAAQ,CAC9D;SACA,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACZ,IAAI,EAAG,IAA+B,CAAC,IAAI,CAAC,IAAI,EAAE;QAClD,MAAM,EAAG,IAA+B,CAAC,MAAM,CAAC,IAAI,EAAE;KACvD,CAAC,CAAC;SACF,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,CAAA;AAC7C,CAAC,CAAA;AAED,MAAM,wBAAwB,GAAG,CAAC,KAAc,EAAwB,EAAE;IACxE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAA;IACX,CAAC;IAED,OAAO,KAAK;SACT,MAAM,CACL,CAAC,IAAI,EAA8B,EAAE,CACnC,OAAO,IAAI,KAAK,QAAQ;QACxB,IAAI,KAAK,IAAI;QACb,OAAQ,IAA2B,CAAC,GAAG,KAAK,QAAQ;QACpD,OAAQ,IAA2B,CAAC,KAAK,KAAK,QAAQ;QACtD,OAAQ,IAA2B,CAAC,WAAW,KAAK,QAAQ,CAC/D;SACA,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACZ,GAAG,EAAG,IAA2B,CAAC,GAAG,CAAC,IAAI,EAAE;QAC5C,KAAK,EAAG,IAA2B,CAAC,KAAK,CAAC,IAAI,EAAE;QAChD,WAAW,EAAG,IAA2B,CAAC,WAAW,CAAC,IAAI,EAAE;KAC7D,CAAC,CAAC;SACF,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,CAAA;AAC/D,CAAC,CAAA;AAED,MAAM,6BAA6B,GAAG,CAAC,KAAc,EAA4B,EAAE;IACjF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAA;IACX,CAAC;IAED,OAAO,KAAK;SACT,MAAM,CACL,CAAC,IAAI,EAAkC,EAAE,CACvC,OAAO,IAAI,KAAK,QAAQ;QACxB,IAAI,KAAK,IAAI;QACb,OAAQ,IAA+B,CAAC,WAAW,KAAK,QAAQ;QAChE,OAAQ,IAA+B,CAAC,aAAa,KAAK,QAAQ,CACrE;SACA,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACZ,WAAW,EAAG,IAA+B,CAAC,WAAW,CAAC,IAAI,EAAE;QAChE,aAAa,EAAG,IAA+B,CAAC,aAAa,CAAC,IAAI,EAAE;KACrE,CAAC,CAAC;SACF,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC,aAAa,CAAC,CAAA;AACtG,CAAC,CAAA;AAED,MAAM,sBAAsB,GAAG,CAAC,MAAc,EAAU,EAAE;IACxD,OAAO,MAAM;SACV,OAAO,CAAC,IAAI,MAAM,CAAC,QAAQ,iBAAiB,4BAA4B,iBAAiB,OAAO,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;SAC3G,IAAI,EAAE,CAAA;AACX,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,wBAAwB,GAAG,CAAC,GAAW,EAAU,EAAE;IACvD,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,IAAI,YAAY,GAAG,KAAK,CAAA;IACxB,IAAI,OAAO,GAAG,KAAK,CAAA;IAEnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAA;QAEnB,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,IAAI,IAAI,CAAA;gBACd,OAAO,GAAG,KAAK,CAAA;gBACf,SAAQ;YACV,CAAC;YAED,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAClB,MAAM,IAAI,IAAI,CAAA;gBACd,OAAO,GAAG,IAAI,CAAA;gBACd,SAAQ;YACV,CAAC;YAED,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjB,MAAM,IAAI,IAAI,CAAA;gBACd,YAAY,GAAG,KAAK,CAAA;gBACpB,SAAQ;YACV,CAAC;YAED,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CAAA;gBACf,SAAQ;YACV,CAAC;YAED,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CAAA;gBACf,SAAQ;YACV,CAAC;YAED,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CAAA;gBACf,SAAQ;YACV,CAAC;YAED,MAAM,IAAI,IAAI,CAAA;QAChB,CAAC;aAAM,CAAC;YACN,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjB,YAAY,GAAG,IAAI,CAAA;YACrB,CAAC;YAED,MAAM,IAAI,IAAI,CAAA;QAChB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,MAAc,EAAgC,EAAE;IAC5F,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,iBAAiB,8BAA8B,iBAAiB,OAAO,CAAC,CAAC,CAAA;IAEvH,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,aAAa,EAAE,MAAM,CAAC,IAAI,EAAE;YAC5B,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,kDAAkD;SAC1D,CAAA;IACH,CAAC;IAED,IAAI,MAA+B,CAAA;IAEnC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;QAC3D,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAA4B,CAAA;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,aAAa,EAAE,sBAAsB,CAAC,MAAM,CAAC;YAC7C,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,2CAA2C;SACnD,CAAA;IACH,CAAC;IAED,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,OAAO;YACL,aAAa,EAAE,sBAAsB,CAAC,MAAM,CAAC;YAC7C,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,0DAA0D;SAClE,CAAA;IACH,CAAC;IAED,MAAM,OAAO,GAAG,uBAAuB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAEvD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,aAAa,EAAE,sBAAsB,CAAC,MAAM,CAAC;YAC7C,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,mDAAmD;SAC3D,CAAA;IACH,CAAC;IAED,MAAM,OAAO,GAAG,wBAAwB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAExD,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,OAAO;YACL,aAAa,EAAE,sBAAsB,CAAC,MAAM,CAAC;YAC7C,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,mDAAmD;SAC3D,CAAA;IACH,CAAC;IAED,8EAA8E;IAC9E,6EAA6E;IAC7E,+EAA+E;IAC/E,+EAA+E;IAC/E,MAAM,QAAQ,GAA8B;QAC1C,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC;QAC9C,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC;QACnD,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC;QAC/C,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC;KACjD,CAAA;IAED,MAAM,QAAQ,GAAsB;QAClC,OAAO;QACP,WAAW,EAAE,oBAAoB,CAAC,MAAM,CAAC,WAAW,CAAC;QACrD,aAAa,EAAE,oBAAoB,CAAC,MAAM,CAAC,cAAc,CAAC;QAC1D,WAAW,EAAE,oBAAoB,CAAC,MAAM,CAAC,YAAY,CAAC;QACtD,OAAO;QACP,YAAY,EAAE,6BAA6B,CAAC,MAAM,CAAC,YAAY,CAAC;KACjE,CAAA;IAED,OAAO;QACL,aAAa,EAAE,sBAAsB,CAAC,MAAM,CAAC;QAC7C,QAAQ;QACR,QAAQ;QACR,KAAK,EAAE,IAAI;KACZ,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,MAAc,EAAiB,EAAE;IACvE,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,+BAA+B,CAAC,CAAC,CAAA;IAErE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAE7C,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AAClD,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAc,EAAU,EAAE;IAC3D,OAAO,MAAM;SACV,OAAO,CAAC,6BAA6B,EAAE,EAAE,CAAC;SAC1C,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC;SAC1B,IAAI,EAAE,CAAA;AACX,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,MAAc,EAAiB,EAAE;IACtE,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,qCAAqC,CAAC,CAAC,CAAA;IAE3E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC7C,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAEvD,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAA;AACjC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAc,EAAU,EAAE;IAC1D,OAAO,MAAM;SACV,OAAO,CAAC,mCAAmC,EAAE,EAAE,CAAC;SAChD,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC;SAC1B,IAAI,EAAE,CAAA;AACX,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,EAC7C,WAAW,EACX,eAAe,EACf,cAAc,GAKf,EAAqD,EAAE;IACtD,OAAO;QACL,OAAO,EAAE,uBAAuB,CAAC,WAAW,CAAC,IAAI,eAAe,IAAI,IAAI;QACxE,MAAM,EAAE,sBAAsB,CAAC,WAAW,CAAC,IAAI,cAAc,IAAI,IAAI;KACtE,CAAA;AACH,CAAC,CAAA;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,EACpD,QAAQ,EACR,QAAQ,EACR,QAAQ,GAKT,EAA6F,EAAE;IAC9F,OAAO;QACL,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,WAAW,IAAI,EAAE,CAAC;QACxF,aAAa,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,aAAa,IAAI,EAAE,CAAC;QAChG,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,WAAW,IAAI,EAAE,CAAC;QACxF,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,YAAY,IAAI,EAAE,CAAC;KAC7F,CAAA;AACH,CAAC,CAAA;AAQD,MAAM,uBAAuB,GAAG,CAAC,MAAc,EAAU,EAAE;IACzD,OAAO,MAAM;SACV,OAAO,CAAC,IAAI,MAAM,CAAC,QAAQ,uBAAuB,4BAA4B,uBAAuB,OAAO,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;SACvH,IAAI,EAAE,CAAA;AACX,CAAC,CAAA;AAED,MAAM,wBAAwB,GAAG,CAAC,KAAc,EAAE,UAAkB,EAA0B,EAAE;IAC9F,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,GAAG,GAAG,KAAgC,CAAA;IAC5C,MAAM,KAAK,GAAG,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACnE,MAAM,WAAW,GAAG,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAEzE,IAAI,CAAC,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,EAAE,GAAG,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,IAAI,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE;QACpD,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE;QACf,CAAC,CAAC,UAAU,CAAA;IAEd,OAAO;QACL,EAAE;QACF,KAAK,EAAE,KAAK,IAAI,WAAW;QAC3B,KAAK,EAAE,WAAW,IAAI,KAAK;QAC3B,GAAG,CAAC,GAAG,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3D,CAAA;AACH,CAAC,CAAA;AAED,MAAM,yBAAyB,GAAG,CAAC,KAAc,EAAqB,EAAE;IACtE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,WAAW,GAAsB,EAAE,CAAA;IACzC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC5B,MAAM,UAAU,GAAG,wBAAwB,CAAC,IAAI,EAAE,cAAc,KAAK,GAAG,CAAC,EAAE,CAAC,CAAA;QAC5E,IAAI,UAAU,EAAE,CAAC;YACf,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAC9B,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,WAAW,CAAA;AACpB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,MAAc,EAAiC,EAAE;IAC9F,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,aAAa,EAAE,EAAE;YACjB,aAAa,EAAE,IAAI;YACnB,KAAK,EAAE,oBAAoB;SAC5B,CAAA;IACH,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,uBAAuB,8BAA8B,uBAAuB,OAAO,CAAC,CAAC,CAAA;IAEnI,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,aAAa,EAAE,MAAM,CAAC,IAAI,EAAE;YAC5B,aAAa,EAAE,IAAI;YACnB,KAAK,EAAE,mDAAmD;SAC3D,CAAA;IACH,CAAC;IAED,IAAI,MAA+B,CAAA;IAEnC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;QAC3D,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAA4B,CAAA;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,aAAa,EAAE,uBAAuB,CAAC,MAAM,CAAC;YAC9C,aAAa,EAAE,IAAI;YACnB,KAAK,EAAE,4CAA4C;SACpD,CAAA;IACH,CAAC;IAED,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,OAAO;YACL,aAAa,EAAE,uBAAuB,CAAC,MAAM,CAAC;YAC9C,aAAa,EAAE,IAAI;YACnB,KAAK,EAAE,2DAA2D;SACnE,CAAA;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,uBAAuB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAEzD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,aAAa,EAAE,uBAAuB,CAAC,MAAM,CAAC;YAC9C,aAAa,EAAE,IAAI;YACnB,KAAK,EAAE,qDAAqD;SAC7D,CAAA;IACH,CAAC;IAED,MAAM,WAAW,GAAG,yBAAyB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;IAEjE,MAAM,SAAS,GAAG,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE;QAC/E,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE;QACzB,CAAC,CAAC,SAAS,CAAA;IAEb,MAAM,aAAa,GAAkB;QACnC,QAAQ;QACR,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,WAAW;KACZ,CAAA;IAED,OAAO;QACL,aAAa,EAAE,uBAAuB,CAAC,MAAM,CAAC;QAC9C,aAAa;QACb,KAAK,EAAE,IAAI;KACZ,CAAA;AACH,CAAC,CAAA"}

package/dist/server/lib/specDraft.js

@@ -0,0 +1,33 @@
+import { formatSpecSections } from './specSections.js';
+/**
+ * Build a deterministic, editable draft prompt that seeds a build-mode chat session
+ * created from a spec snapshot. Returned to the client which writes it into the
+ * composer's localStorage draft slot without auto-submitting.
+ *
+ * The draft targets the build-mode chat agent. It intentionally omits the spec's
+ * `plan_text` (planning context): that field is process narrative for the spec
+ * session and does not help the build agent act. Verification guidance is not
+ * emitted at the wrapper level either — it lives inside each work item's
+ * description, mirroring how the plan worker folds `test_scope` into each ticket.
+ */
+const DRAFT_SECTION_ORDER = [
+    'likelyFiles',
+    'assumptions',
+    'openQuestions',
+    'workBreakdown',
+    'dependencies',
+    'visualization',
+    'uiMockup',
+];
+export const buildSpecImplementationDraft = ({ snapshot, specSession, }) => {
+    const sections = [];
+    sections.push(`Implement the spec below in this repository, using the work breakdown provided here. Treat each work item's Acceptance Criteria as the done-gate for that item.`);
+    sections.push(`**Why:** ${snapshot.summary || '_No summary provided._'}`);
+    const renderedSections = formatSpecSections(snapshot, DRAFT_SECTION_ORDER);
+    for (const section of renderedSections) {
+        sections.push(`## ${section.heading}\n\n${section.body}`);
+    }
+    sections.push(`_Originates from spec session: ${specSession.title}_`);
+    return sections.join('\n\n');
+};
+//# sourceMappingURL=specDraft.js.map

package/dist/server/lib/specDraft.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specDraft.js","sourceRoot":"","sources":["../../../server/lib/specDraft.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAuB,MAAM,mBAAmB,CAAA;AAG3E;;;;;;;;;;GAUG;AACH,MAAM,mBAAmB,GAAkC;IACzD,aAAa;IACb,aAAa;IACb,eAAe;IACf,eAAe;IACf,cAAc;IACd,eAAe;IACf,UAAU;CACX,CAAA;AAED,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,EAC3C,QAAQ,EACR,WAAW,GAIZ,EAAU,EAAE;IACX,MAAM,QAAQ,GAAa,EAAE,CAAA;IAE7B,QAAQ,CAAC,IAAI,CAAC,iKAAiK,CAAC,CAAA;IAEhL,QAAQ,CAAC,IAAI,CAAC,YAAY,QAAQ,CAAC,OAAO,IAAI,wBAAwB,EAAE,CAAC,CAAA;IAEzE,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAA;IAC1E,KAAK,MAAM,OAAO,IAAI,gBAAgB,EAAE,CAAC;QACvC,QAAQ,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,OAAO,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;IAC3D,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,kCAAkC,WAAW,CAAC,KAAK,GAAG,CAAC,CAAA;IAErE,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;AAC9B,CAAC,CAAA"}

package/dist/server/lib/specExport.js

@@ -0,0 +1,70 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { formatSpecSections } from './specSections.js';
+/**
+ * Build a human-readable markdown export of a spec snapshot for the project's
+ * `docs/plans` directory. The audience is a person reading the file in a
+ * markdown viewer, so Goal, Visualization, and UI Mockup are retained for
+ * orientation. `plan_text` (planning context) is omitted: it is process
+ * narrative about the spec session, not content a doc reader needs.
+ *
+ * Verification guidance is not surfaced at the wrapper level — each work item's
+ * description carries its own per-project testing guidance.
+ */
+const EXPORT_SECTION_ORDER = [
+    'workBreakdown',
+    'likelyFiles',
+    'assumptions',
+    'openQuestions',
+    'dependencies',
+    'visualization',
+    'uiMockup',
+];
+const buildSpecExportMarkdown = ({ snapshot, specSession, }) => {
+    const sections = [];
+    sections.push(`# ${specSession.title}`);
+    sections.push('');
+    sections.push(`## Goal`);
+    sections.push('');
+    sections.push(snapshot.summary || '_No summary provided._');
+    sections.push('');
+    const renderedSections = formatSpecSections(snapshot, EXPORT_SECTION_ORDER);
+    for (const section of renderedSections) {
+        sections.push(`## ${section.heading}`);
+        sections.push('');
+        sections.push(section.body);
+        sections.push('');
+    }
+    sections.push('---');
+    sections.push('');
+    sections.push(`_Exported from spec session "${specSession.title}" on ${new Date().toISOString().split('T')[0]}_`);
+    return sections.join('\n') + '\n';
+};
+const slugify = (text) => {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '_')
+        .replace(/^_+|_+$/g, '')
+        .slice(0, 80);
+};
+export const exportSpecToDocs = ({ snapshot, specSession, repoPath, }) => {
+    const docsDir = path.join(repoPath, 'docs', 'plans');
+    const slug = slugify(specSession.title) || 'spec';
+    const filename = `${slug}_SPEC.md`;
+    const filePath = path.join(docsDir, filename);
+    fs.mkdirSync(docsDir, { recursive: true });
+    const content = buildSpecExportMarkdown({ snapshot, specSession });
+    fs.writeFileSync(filePath, content, 'utf-8');
+    return { content, filePath };
+};
+export const checkSpecExportCollision = ({ specSession, repoPath, }) => {
+    const docsDir = path.join(repoPath, 'docs', 'plans');
+    const slug = slugify(specSession.title) || 'spec';
+    const filename = `${slug}_SPEC.md`;
+    const filePath = path.join(docsDir, filename);
+    if (fs.existsSync(filePath)) {
+        return filePath;
+    }
+    return null;
+};
+//# sourceMappingURL=specExport.js.map

package/dist/server/lib/specExport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specExport.js","sourceRoot":"","sources":["../../../server/lib/specExport.ts"],"names":[],"mappings":"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"}

package/dist/server/lib/specFormatting.js

@@ -0,0 +1,26 @@
+const NO_CONTENT = '_None_';
+export const formatBulletList = (items) => {
+    if (items.length === 0) {
+        return NO_CONTENT;
+    }
+    return items.map(item => `- ${item}`).join('\n');
+};
+export const formatLikelyFiles = (files) => {
+    if (files.length === 0) {
+        return NO_CONTENT;
+    }
+    return files.map(file => `- \`${file.path}\` — ${file.reason || 'no reason provided'}`).join('\n');
+};
+export const formatWorkItems = (tickets) => {
+    if (tickets.length === 0) {
+        return NO_CONTENT;
+    }
+    return tickets.map(ticket => `### ${ticket.key} — ${ticket.title}\n\n${ticket.description}`).join('\n\n');
+};
+export const formatDependencies = (dependencies) => {
+    if (dependencies.length === 0) {
+        return NO_CONTENT;
+    }
+    return dependencies.map(dep => `- \`${dep.blocker_key}\` blocks \`${dep.dependent_key}\``).join('\n');
+};
+//# sourceMappingURL=specFormatting.js.map

package/dist/server/lib/specFormatting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specFormatting.js","sourceRoot":"","sources":["../../../server/lib/specFormatting.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAG,QAAQ,CAAA;AAE3B,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAA4B,EAAU,EAAE;IACvE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,UAAU,CAAA;IACnB,CAAC;IAED,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAClD,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAmC,EAAU,EAAE;IAC/E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,UAAU,CAAA;IACnB,CAAC;IAED,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,IAAI,CAAC,IAAI,QAAQ,IAAI,CAAC,MAAM,IAAI,oBAAoB,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACpG,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAgC,EAAU,EAAE;IAC1E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,UAAU,CAAA;IACnB,CAAC;IAED,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,KAAK,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;AAC3G,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,YAA0C,EAAU,EAAE;IACvF,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,UAAU,CAAA;IACnB,CAAC;IAED,OAAO,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,GAAG,CAAC,WAAW,eAAe,GAAG,CAAC,aAAa,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACvG,CAAC,CAAA"}

package/dist/server/lib/specMessages.js

@@ -0,0 +1,79 @@
+import { randomUUID } from 'crypto';
+import db from '../db.js';
+import { listSpecMessageAttachments } from './attachments.js';
+const parseSpecMessageMetadata = (value) => {
+    if (!value) {
+        return undefined;
+    }
+    try {
+        const parsed = JSON.parse(value);
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            return undefined;
+        }
+        return parsed;
+    }
+    catch {
+        return undefined;
+    }
+};
+const listSpecMessagesStatement = db.prepare(`
+  SELECT id, spec_session_id, role, kind, content, metadata_json, created_at
+  FROM spec_messages
+  WHERE spec_session_id = ?
+  ORDER BY created_at ASC, rowid ASC
+`);
+const insertSpecMessageStatement = db.prepare(`
+  INSERT INTO spec_messages (id, spec_session_id, role, kind, content, metadata_json)
+  VALUES (?, ?, ?, ?, ?, ?)
+`);
+const getSpecMessageStatement = db.prepare(`
+  SELECT id, spec_session_id, role, kind, content, metadata_json, created_at
+  FROM spec_messages
+  WHERE id = ?
+`);
+const touchSpecSessionStatement = db.prepare(`
+  UPDATE spec_sessions
+  SET updated_at = CURRENT_TIMESTAMP
+  WHERE id = ?
+`);
+export const listSpecMessages = (specSessionId, projectId) => {
+    const attachmentsByMessageId = listSpecMessageAttachments(specSessionId, projectId);
+    return listSpecMessagesStatement.all(specSessionId).map(row => {
+        const metadata = parseSpecMessageMetadata(row.metadata_json);
+        return {
+            id: row.id,
+            spec_session_id: row.spec_session_id,
+            role: row.role,
+            kind: row.kind,
+            content: row.content,
+            ...(metadata ? { metadata } : {}),
+            attachments: attachmentsByMessageId.get(row.id) ?? [],
+            created_at: row.created_at,
+        };
+    });
+};
+export const getSpecMessage = (specMessageId) => {
+    const row = getSpecMessageStatement.get(specMessageId);
+    if (!row) {
+        return null;
+    }
+    const metadata = parseSpecMessageMetadata(row.metadata_json);
+    return {
+        id: row.id,
+        spec_session_id: row.spec_session_id,
+        role: row.role,
+        kind: row.kind,
+        content: row.content,
+        ...(metadata ? { metadata } : {}),
+        attachments: [],
+        created_at: row.created_at,
+    };
+};
+export const createSpecMessage = ({ specSessionId, role, kind, content, metadata, }) => {
+    const id = randomUUID();
+    const metadataJson = metadata ? JSON.stringify(metadata) : null;
+    insertSpecMessageStatement.run(id, specSessionId, role, kind, content, metadataJson);
+    touchSpecSessionStatement.run(specSessionId);
+    return id;
+};
+//# sourceMappingURL=specMessages.js.map

package/dist/server/lib/specMessages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specMessages.js","sourceRoot":"","sources":["../../../server/lib/specMessages.ts"],"names":[],"mappings":"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"}