aimeat 1.2.0

package/dist/src/services/generator-validate.js

@@ -0,0 +1,790 @@
+/**
+ * @file src/services/generator-validate.ts
+ * @description Server-side component validators for the AIMEAT service generator.
+ *   TypeScript port of public/js/services/generator-validate.js.
+ *   Each component type (csm, msm, extension, app, memory, translation, cortex) has a
+ *   validator that checks structure and extracts usable content from AI output.
+ *   Includes validateInterviewSpec for structured interview JSON, validateBlueprint for
+ *   blueprint JSON validation/sanitization, and validateAntiPatterns for crash-prevention checks.
+ * @structure
+ *   - extractCodeBlock(text, lang): pulls content from markdown code fences
+ *   - validateAntiPatterns(type, code): universal crash-prevention checks
+ *   - validateComponent(type, content): dispatches to per-type validator
+ *   - validateInterviewSpec(result): validates interview spec JSON from AI interviews
+ *   - validateBlueprint(result): validates + sanitizes blueprint JSON (strips extra fields)
+ * @usage import { validateBlueprint, validateComponent, validateInterviewSpec, validateAntiPatterns } from '../services/generator-validate.js';
+ * @version-history
+ *   v1.0.0 — 2026-03-18 — Initial port from public/js/services/generator-validate.js (v4.5.0)
+ *   v1.1.0 — 2026-03-21 — Add externalServices/userSettings to InterviewSpec; settings/testScenarios/architecture/role to Blueprint
+ */
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+/* ── Helpers ─────────────────────────────────────────── */
+function extractCodeBlock(text, lang) {
+    const regex = new RegExp('```' + (lang || '') + '\\s*\\n([\\s\\S]*?)```', 'i');
+    const match = text.match(regex);
+    return match ? match[1].trim() : text.trim();
+}
+/**
+ * Sanitize JSON string from common AI/markdown artifacts before parsing.
+ */
+function sanitizeJson(text) {
+    let s = text;
+    // Strip markdown backslash escaping: \[ \] \{ \} \( \) \* \_ \` \| \~ \#
+    s = s.replace(/\\([[\]{}()*_`|~#])/g, '$1');
+    s = s.replace(/,\s*([}\]])/g, '$1');
+    s = s.replace(/\u200B|\u200C|\u200D|\uFEFF/g, '');
+    return s;
+}
+/**
+ * Minimal text-level cleanup applied BEFORE YAML parsing.
+ * Only fixes characters that prevent the parser from running at all.
+ */
+function preCleanYaml(text) {
+    if (typeof text !== 'string')
+        return text;
+    let s = text;
+    // Remove markdown-escaped chars that aren't valid YAML
+    s = s.replace(/\\_/g, '_');
+    s = s.replace(/\\\[/g, '[').replace(/\\\]/g, ']');
+    s = s.replace(/\\\{/g, '{').replace(/\\\}/g, '}');
+    // Remove zero-width unicode
+    s = s.replace(/\u200B|\u200C|\u200D|\uFEFF/g, '');
+    return s;
+}
+/**
+ * Parse YAML using the real yaml library with multiple fallback strategies.
+ * 1. Try parsing as-is (after minimal pre-clean)
+ * 2. If that fails, try with bullet-list fix
+ * 3. Return { parsed, errors, cleaned } where cleaned is the canonical YAML
+ *    re-serialized by the yaml library (no regex hacks)
+ */
+function tryParseYaml(text) {
+    const errors = [];
+    if (!text || typeof text !== 'string') {
+        errors.push('Result is empty');
+        return { errors, parsed: null, cleaned: text };
+    }
+    const preCleaned = preCleanYaml(text);
+    // Attempt 1: strict parse
+    try {
+        const parsed = parseYaml(preCleaned);
+        // Re-serialize through the real yaml library → guaranteed clean output
+        const cleaned = stringifyYaml(parsed, { lineWidth: 0 });
+        return { errors, parsed, cleaned };
+    }
+    catch (e1) {
+        // Attempt 2: try stripping markdown bullets `* ` → `- ` and retry
+        const firstError = e1 instanceof Error ? e1 : new Error(String(e1));
+        let fixed = preCleaned;
+        fixed = fixed.replace(/^(\s*)\*\s{2,}/gm, '$1- ');
+        fixed = fixed.replace(/^(\s*)\*\s+(?=\S)/gm, '$1- ');
+        try {
+            const parsed = parseYaml(fixed);
+            const cleaned = stringifyYaml(parsed, { lineWidth: 0 });
+            return { errors, parsed, cleaned };
+        }
+        catch {
+            // Both attempts failed — report the original error
+            errors.push(`YAML parse error: ${firstError.message}`);
+            return { errors, parsed: null, cleaned: preCleaned };
+        }
+    }
+}
+/* ── Anti-Pattern Validation ─────────────────────────── */
+/**
+ * Scan generated code for universal anti-patterns that always indicate bugs.
+ * Returns { warnings: string[], errors: string[] }
+ * - errors: patterns that will definitely crash (block install)
+ * - warnings: patterns that are suspicious (show warning, allow install)
+ */
+export function validateAntiPatterns(type, code) {
+    const errors = [];
+    const warnings = [];
+    if (!code || typeof code !== 'string')
+        return { errors, warnings };
+    // === Extension-specific anti-patterns ===
+    if (type === 'extension') {
+        // JSON.parse on memory.get — always crashes with "undefined is not valid JSON"
+        if (/JSON\.parse\s*\(\s*(await\s+)?ctx\.memory\.get/i.test(code)) {
+            errors.push('CRASH: JSON.parse(ctx.memory.get(...)) — memory.get() already returns parsed values. Remove JSON.parse().');
+        }
+        // JSON.parse wrapping a variable that came from memory.get
+        if (/=\s*(await\s+)?ctx\.memory\.get\s*\([^)]+\)\s*;[\s\S]{0,100}JSON\.parse\s*\(\s*\w+\s*\)/m.test(code)) {
+            warnings.push('Suspicious: variable from ctx.memory.get() passed to JSON.parse() — memory values are already parsed.');
+        }
+        // require() — not available in sandbox
+        if (/\brequire\s*\(/m.test(code)) {
+            errors.push('CRASH: require() is not available in the sandbox. All code must be self-contained.');
+        }
+        // import ... from (but allow export default)
+        if (/\bimport\s+.+\s+from\s+/m.test(code)) {
+            errors.push('CRASH: import...from is not available in the sandbox. Only "export default" is allowed.');
+        }
+        // global fetch() without ctx prefix
+        if (/(?<!ctx\.)fetch\s*\(/m.test(code) && !/function\s+fetch/m.test(code)) {
+            warnings.push('Suspicious: fetch() called without ctx prefix — use ctx.fetch() in the sandbox. Global fetch is not available.');
+        }
+        // console.log — not available
+        if (/\bconsole\.(log|warn|error|info)\s*\(/m.test(code)) {
+            warnings.push('console.log is not available in the sandbox. Use ctx.log.info/warn/error() instead.');
+        }
+        // setTimeout/setInterval — not available
+        if (/\b(setTimeout|setInterval|setImmediate)\s*\(/m.test(code)) {
+            errors.push('CRASH: setTimeout/setInterval/setImmediate are not available in the sandbox.');
+        }
+    }
+    // === HTML entity corruption (any type) ===
+    // These appear when AI retries render HTML entities in code
+    if (/&gt;|&lt;|&amp;(?!amp;)|&quot;/.test(code)) {
+        const codeLines = code.split('\n');
+        const entityLines = codeLines.filter(line => {
+            // Skip lines that are clearly HTML text content
+            if (/^\s*<[^>]+>[^<]*&/.test(line))
+                return false;
+            // Skip lines where entities appear only inside string literals (e.g., .replace(/&amp;/g, "&"))
+            // Strip quoted strings and regex literals before checking for entities
+            const stripped = line
+                .replace(/"(?:[^"\\]|\\.)*"/g, '""') // remove double-quoted strings
+                .replace(/'(?:[^'\\]|\\.)*'/g, "''") // remove single-quoted strings
+                .replace(/`(?:[^`\\]|\\.)*`/g, '``') // remove template literals
+                .replace(/\/(?:[^/\\]|\\.)+\/[gimsuy]*/g, '//'); // remove regex literals
+            if (!/&gt;|&lt;|&amp;[a-z]|&quot;/.test(stripped))
+                return false;
+            // Flag lines with entities in code context
+            return /[=(){}[\];]/.test(line);
+        });
+        if (entityLines.length > 0) {
+            errors.push(`HTML entities found in code (${entityLines.length} lines) — use => not =&gt;, && not &amp;&amp;, etc. This crashes the sandbox.`);
+        }
+    }
+    // === Translation anti-patterns ===
+    if (type === 'translation') {
+        try {
+            const parsed = JSON.parse(code);
+            if (parsed.en && !parsed.fi && Object.values(parsed.en).some(v => /[äöåÄÖÅ]/.test(String(v)))) {
+                warnings.push('Suspicious: "en" locale contains Finnish characters (ä, ö, å) — check if root key should be "fi".');
+            }
+            if (parsed.fi && Object.values(parsed.fi).every(v => !/[äöåÄÖÅ]/.test(String(v)))) {
+                warnings.push('Suspicious: "fi" locale has no Finnish characters (ä, ö, å) — may contain English text under wrong locale key.');
+            }
+        }
+        catch { /* not valid JSON, other validators will catch this */ }
+    }
+    return { errors, warnings };
+}
+/* ── Validators ──────────────────────────────────────── */
+function validateCsm(result) {
+    const errors = [];
+    const raw = extractCodeBlock(result, 'yaml');
+    const { parsed, errors: parseErrors, cleaned } = tryParseYaml(raw);
+    errors.push(...parseErrors);
+    if (parsed && typeof parsed === 'object') {
+        const p = parsed;
+        if (!p.service?.name)
+            errors.push('Missing: service.name');
+        if (!p.service?.description)
+            errors.push('Missing: service.description');
+        const dataSchema = p.data_schema;
+        if (!dataSchema?.required || Object.keys(dataSchema.required).length === 0) {
+            errors.push('data_schema.required must have at least one field');
+        }
+        if (!p.consent_requirements)
+            errors.push('Missing section: consent_requirements');
+    }
+    return { valid: errors.length === 0, errors, extracted: cleaned };
+}
+function validateMsm(result) {
+    const errors = [];
+    const raw = extractCodeBlock(result, 'yaml');
+    const { parsed, errors: parseErrors, cleaned } = tryParseYaml(raw);
+    errors.push(...parseErrors);
+    if (parsed && typeof parsed === 'object') {
+        const p = parsed;
+        const service = p.service;
+        const auth = p.auth;
+        const actions = p.actions;
+        if (!service?.name)
+            errors.push('Missing: service.name');
+        if (!service?.description)
+            errors.push('Missing: service.description');
+        if (!service?.category)
+            errors.push('Missing: service.category');
+        if (!auth?.type)
+            errors.push('Missing: auth.type');
+        if (!Array.isArray(actions) || actions.length === 0) {
+            errors.push('actions must be a non-empty array');
+        }
+        else {
+            for (const action of actions) {
+                const pfx = `action "${action?.id || '?'}"`;
+                if (!action?.id)
+                    errors.push(`${pfx}: missing id`);
+                if (!action?.display_name)
+                    errors.push(`${pfx}: missing display_name`);
+                const endpoint = action?.endpoint;
+                if (!endpoint?.method)
+                    errors.push(`${pfx}: missing endpoint.method`);
+                if (!endpoint?.url)
+                    errors.push(`${pfx}: missing endpoint.url`);
+                const output = action?.output;
+                if (!output || Object.keys(output).length === 0) {
+                    errors.push(`${pfx}: must have at least one output field`);
+                }
+            }
+        }
+    }
+    return { valid: errors.length === 0, errors, extracted: cleaned };
+}
+function validateExtension(result) {
+    const errors = [];
+    // ── Extract YAML manifest — supports three formats ──
+    // Format 1 (preferred): Single untagged code block with YAML first, then // actions/*.js separator
+    // Format 2: Fenced ```yaml block
+    // Format 3: Raw text (no fences) — cut at first // actions/ comment
+    let raw = null;
+    // Format 1: single untagged code block — split at first // actions/ separator
+    const untaggedMatch = result.match(/```\s*\n([\s\S]*?)```/);
+    if (untaggedMatch) {
+        const content = untaggedMatch[1];
+        const actionSep = content.match(/^\/\/\s*actions\/\S+\.js\s*$/m);
+        if (actionSep) {
+            const sepIndex = content.indexOf(actionSep[0]);
+            raw = content.slice(0, sepIndex).trim();
+        }
+    }
+    // Format 2: fenced ```yaml block
+    if (!raw) {
+        const fenced = extractCodeBlock(result, 'yaml');
+        if (fenced !== result.trim()) {
+            raw = fenced;
+        }
+    }
+    // Format 3: no fences — cut at first // actions/ comment in raw text
+    if (!raw) {
+        const jsStart = result.search(/^\/\/\s*actions\//m);
+        raw = jsStart > 0 ? result.slice(0, jsStart).trim() : result.trim();
+    }
+    const { parsed, errors: parseErrors } = tryParseYaml(raw);
+    errors.push(...parseErrors);
+    if (parsed && typeof parsed === 'object') {
+        const p = parsed;
+        const metadata = p.metadata;
+        const actions = p.actions;
+        if (!metadata?.name)
+            errors.push('Missing: metadata.name');
+        else if (/\./.test(metadata.name))
+            errors.push('metadata.name must not contain dots (.) — dots cause namespace collisions in memory owner keys');
+        else if (!/^[a-z][a-z0-9-]*$/.test(metadata.name))
+            errors.push('metadata.name must be lowercase kebab-case (e.g., "my-collector")');
+        if (!metadata?.version)
+            errors.push('Missing: metadata.version');
+        if (!metadata?.description)
+            errors.push('Missing: metadata.description');
+        if (!metadata?.author)
+            errors.push('Missing: metadata.author');
+        if (!Array.isArray(actions) || actions.length === 0) {
+            errors.push('actions array is required and must not be empty');
+        }
+        else {
+            for (const action of actions) {
+                const pfx = `action "${action?.id || '?'}"`;
+                if (!action?.id)
+                    errors.push(`${pfx}: missing id`);
+                if (!action?.method)
+                    errors.push(`${pfx}: missing method`);
+                if (!action?.path)
+                    errors.push(`${pfx}: missing path`);
+                if (!action?.script)
+                    errors.push(`${pfx}: missing script`);
+            }
+        }
+    }
+    // Check for action scripts — look for fenced JS blocks OR unfenced // actions/file.js comments
+    const fencedJs = result.match(/```javascript[\s\S]*?```/gi) || [];
+    const unfencedJs = result.match(/^\/\/\s*actions\/[\w-]+\.js\s*$/gm) || [];
+    const jsBlockCount = Math.max(fencedJs.length, unfencedJs.length);
+    const actionCount = Array.isArray(parsed?.actions) ? parsed.actions.length : 0;
+    if (actionCount > 0 && jsBlockCount === 0) {
+        errors.push(`Extension defines ${actionCount} action(s) but no JavaScript code blocks found`);
+    }
+    // Anti-pattern scan
+    const ap = validateAntiPatterns('extension', result);
+    errors.push(...ap.errors);
+    return { valid: errors.length === 0, errors, extracted: result };
+}
+function validateApp(result) {
+    const errors = [];
+    const html = extractCodeBlock(result, 'html') || result;
+    if (!html.includes('<!DOCTYPE html') && !html.includes('<html')) {
+        errors.push('Not a valid HTML document — missing <!DOCTYPE html> or <html> tag');
+    }
+    if (!html.includes('<head'))
+        errors.push('Missing <head> section');
+    if (!html.includes('<body'))
+        errors.push('Missing <body> section');
+    if (!html.includes('AIMEAT App Manifest') && !html.match(/name:\s*.+/)) {
+        errors.push('Missing AIMEAT App Manifest comment');
+    }
+    // Anti-pattern scan
+    const ap = validateAntiPatterns('app', html);
+    errors.push(...ap.errors);
+    return { valid: errors.length === 0, errors, extracted: html };
+}
+function validateMemorySchema(result) {
+    const errors = [];
+    const json = sanitizeJson(extractCodeBlock(result, 'json'));
+    try {
+        const parsed = JSON.parse(json);
+        if (typeof parsed !== 'object' || Array.isArray(parsed)) {
+            errors.push('Memory structure must be a JSON object with key-value pairs');
+        }
+        else if (Object.keys(parsed).length === 0) {
+            errors.push('Memory structure is empty');
+        }
+        return { valid: errors.length === 0, errors, extracted: json };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        errors.push(`Invalid JSON: ${msg}`);
+        return { valid: false, errors, extracted: json };
+    }
+}
+function validateTranslation(result) {
+    const errors = [];
+    const warnings = [];
+    const json = sanitizeJson(extractCodeBlock(result, 'json'));
+    try {
+        const parsed = JSON.parse(json);
+        // Each translation component produces ONE locale (e.g., { "fi": { ... } } or { "en": { ... } })
+        const locales = Object.keys(parsed).filter(k => typeof parsed[k] === 'object' && parsed[k] !== null);
+        if (locales.length === 0) {
+            errors.push('No locale object found — expected e.g. { "fi": { ... } } or { "en": { ... } }');
+        }
+        else if (locales.length > 1) {
+            errors.push(`Multiple locales found (${locales.join(', ')}) — each translation component should contain only ONE locale`);
+        }
+        else {
+            // Validate the single locale has content
+            const locale = locales[0];
+            const keys = Object.keys(parsed[locale]);
+            if (keys.length === 0) {
+                errors.push(`Locale "${locale}" is empty — no translation keys found`);
+            }
+        }
+        // Anti-pattern scan (warnings only, don't block validation)
+        const ap = validateAntiPatterns('translation', json);
+        warnings.push(...ap.warnings);
+        return { valid: errors.length === 0, errors, warnings, extracted: json };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        errors.push(`Invalid JSON: ${msg}`);
+        return { valid: false, errors, extracted: json };
+    }
+}
+function validateCortex(result, blueprint) {
+    const errors = [];
+    // ── Extract YAML and JS — supports two formats ──
+    // Format 1 (preferred): Single untagged code block with YAML first, then // lib/*.js separator
+    // Format 2 (legacy): Separate ```yaml and ```javascript blocks
+    let yamlBlock = null;
+    const jsBlocks = [];
+    // Try Format 1: single block with // lib/ separator
+    const untaggedMatch = result.match(/```\s*\n([\s\S]*?)```/);
+    if (untaggedMatch) {
+        const content = untaggedMatch[1];
+        const libSeparator = content.match(/^\/\/\s*lib\/\S+\.js\s*$/m);
+        if (libSeparator) {
+            const sepIndex = content.indexOf(libSeparator[0]);
+            yamlBlock = content.slice(0, sepIndex).trim();
+            jsBlocks.push(content.slice(sepIndex).trim());
+        }
+    }
+    // Try Format 2: separate ```yaml and ```javascript blocks
+    if (!yamlBlock) {
+        const extracted = extractCodeBlock(result, 'yaml');
+        if (extracted && extracted !== result.trim()) {
+            yamlBlock = extracted;
+        }
+        if (yamlBlock) {
+            const jsRegex = /```(?:javascript|js)\s*\n([\s\S]*?)```/gi;
+            let match;
+            const afterYaml = result.indexOf('```yaml') > -1
+                ? result.slice(result.indexOf('```', result.indexOf('```yaml') + 7) + 3)
+                : result;
+            while ((match = jsRegex.exec(afterYaml)) !== null) {
+                jsBlocks.push(match[1].trim());
+            }
+        }
+    }
+    if (!yamlBlock) {
+        errors.push('No YAML manifest found — cortex must include a manifest (either in a single code block with // lib/ separator, or in a ```yaml block)');
+        return { valid: false, errors, extracted: null };
+    }
+    const { parsed, errors: yamlErrors } = tryParseYaml(yamlBlock);
+    if (yamlErrors.length > 0)
+        return { valid: false, errors: yamlErrors, extracted: null };
+    if (!parsed)
+        return { valid: false, errors: ['Failed to parse YAML manifest'], extracted: null };
+    const p = parsed;
+    if (p.apiVersion !== 'cortex.aimeat.org/v1') {
+        errors.push('apiVersion must be "cortex.aimeat.org/v1"');
+    }
+    if (p.kind !== 'Extension')
+        errors.push('kind must be "Extension"');
+    const metadata = p.metadata;
+    if (!metadata?.name)
+        errors.push('metadata.name is required');
+    else if (/\./.test(metadata.name))
+        errors.push('metadata.name must not contain dots (.)');
+    else if (!/^[a-z][a-z0-9-]*$/.test(metadata.name))
+        errors.push('metadata.name must be lowercase kebab-case (e.g., "my-domain-lib")');
+    const spec = p.spec;
+    if (!spec?.components || !Array.isArray(spec.components)) {
+        errors.push('spec.components array is required');
+    }
+    const libComponents = (spec?.components || []).filter(c => c.type === 'lib');
+    if (libComponents.length > 0 && jsBlocks.length === 0) {
+        errors.push(`Manifest declares ${libComponents.length} lib component(s) but no JavaScript code blocks found`);
+    }
+    // ── Cross-check: YAML metadata.name ↔ JS LIB_NAME consistency ──
+    if (metadata?.name && jsBlocks.length > 0) {
+        const yamlName = metadata.name; // kebab-case e.g. "halytyskartta-cortex"
+        const expectedCamel = yamlName.replace(/-([a-z0-9])/g, (_, c) => c.toUpperCase()); // → "halytyskarttaCortex"
+        const jsCode = jsBlocks.join('\n');
+        // Check LIB_NAME matches expected camelCase
+        const libNameMatch = jsCode.match(/(?:const|let|var)\s+LIB_NAME\s*=\s*['"]([^'"]+)['"]/);
+        if (libNameMatch) {
+            const actualLibName = libNameMatch[1];
+            if (actualLibName !== expectedCamel) {
+                errors.push(`LIB_NAME mismatch: JS has "${actualLibName}" but YAML name "${yamlName}" expects "${expectedCamel}"`);
+            }
+        }
+        else {
+            errors.push('No LIB_NAME constant found in JS code — cortex must declare const LIB_NAME = \'...\';');
+        }
+        // Check AIMEAT.register uses correct name
+        const registerMatch = jsCode.match(/AIMEAT\.register\s*\(\s*LIB_NAME/);
+        if (!registerMatch) {
+            const hardcodedRegister = jsCode.match(/AIMEAT\.register\s*\(\s*['"]([^'"]+)['"]/);
+            if (hardcodedRegister && hardcodedRegister[1] !== expectedCamel) {
+                errors.push(`AIMEAT.register uses "${hardcodedRegister[1]}" but expected "${expectedCamel}"`);
+            }
+        }
+        // Check IIFE pattern exists
+        if (!/\(function\s*\(\s*AIMEAT\s*\)/.test(jsCode)) {
+            errors.push('Cortex JS must use IIFE pattern: (function (AIMEAT) { ... })(window.AIMEAT || ...)');
+        }
+        // Check exports object includes all required methods from blueprint
+        const exportsMatch = jsCode.match(/(?:const|let|var)\s+\w*[Ee]xport\w*\s*=\s*\{([\s\S]*?)\}/);
+        if (exportsMatch) {
+            const exportedMethods = exportsMatch[1].split(',').map(m => m.trim().split(':')[0].trim()).filter(Boolean);
+            // Cross-check with blueprint produces API methods if available
+            if (blueprint?.components) {
+                const cortexComp = blueprint.components.find(c => c.type === 'cortex');
+                if (cortexComp?.produces) {
+                    const requiredMethods = cortexComp.produces
+                        .filter(prod => prod.startsWith('api:'))
+                        .map(prod => prod.replace('api:', ''));
+                    for (const method of requiredMethods) {
+                        if (!exportedMethods.includes(method)) {
+                            errors.push(`Blueprint requires method "${method}" but it's not in the exports object. Found: ${exportedMethods.join(', ')}`);
+                        }
+                    }
+                }
+            }
+        }
+        else {
+            errors.push('No exports object found — cortex must have: const exports = { method1, method2, ... };');
+        }
+    }
+    if (errors.length > 0)
+        return { valid: false, errors, extracted: null };
+    const extracted = {
+        manifest: stringifyYaml(parsed),
+        libs: libComponents.map((lib, i) => ({
+            filename: lib.filename || `${lib.name || 'lib'}.js`,
+            code: jsBlocks[i] || '',
+        })),
+    };
+    return { valid: true, errors: [], extracted };
+}
+/* ── Main Validate Function ──────────────────────────── */
+export function validateComponent(type, content, blueprint = null) {
+    switch (type) {
+        case 'csm': return validateCsm(content);
+        case 'msm': return validateMsm(content);
+        case 'extension': return validateExtension(content);
+        case 'app': return validateApp(content);
+        case 'memory': return validateMemorySchema(content);
+        case 'translation': return validateTranslation(content);
+        case 'cortex': return validateCortex(content, blueprint);
+        default: {
+            const exhaustive = type;
+            return { valid: false, errors: [`Unknown component type: ${exhaustive}`], extracted: content };
+        }
+    }
+}
+/* ── Interview Spec Validator ────────────────────────── */
+/**
+ * Validate and extract an interview specification JSON from AI output.
+ * Expects a JSON code block with required fields.
+ */
+export function validateInterviewSpec(result) {
+    const errors = [];
+    const warnings = [];
+    try {
+        const raw = extractCodeBlock(result, 'json');
+        const cleaned = sanitizeJson(raw);
+        const spec = JSON.parse(cleaned);
+        if (!spec.version)
+            errors.push('Missing "version" field');
+        if (!spec.projectName)
+            errors.push('Missing "projectName" field');
+        if (!spec.description)
+            errors.push('Missing "description" field');
+        if (!Array.isArray(spec.useCases) || spec.useCases.length === 0) {
+            errors.push('Missing or empty "useCases" array');
+        }
+        if (!Array.isArray(spec.dataSources))
+            errors.push('Missing "dataSources" array');
+        if (!spec.dataModel)
+            errors.push('Missing "dataModel" object');
+        if (!Array.isArray(spec.views) || spec.views.length === 0) {
+            errors.push('Missing or empty "views" array');
+        }
+        if (Array.isArray(spec.useCases)) {
+            spec.useCases.forEach((uc, i) => {
+                if (!uc.id)
+                    errors.push(`useCases[${i}] missing "id"`);
+                if (!uc.title)
+                    errors.push(`useCases[${i}] missing "title"`);
+            });
+        }
+        if (Array.isArray(spec.dataSources)) {
+            spec.dataSources.forEach((ds, i) => {
+                if (!ds.name)
+                    errors.push(`dataSources[${i}] missing "name"`);
+                if (!ds.type)
+                    errors.push(`dataSources[${i}] missing "type"`);
+                if (ds.url && !ds.verified) {
+                    warnings.push(`dataSources[${i}] "${ds.name}" URL not verified — may need manual validation`);
+                }
+            });
+        }
+        if (Array.isArray(spec.views)) {
+            spec.views.forEach((v, i) => {
+                if (!v.type)
+                    errors.push(`views[${i}] missing "type"`);
+                if (!v.title)
+                    errors.push(`views[${i}] missing "title"`);
+            });
+        }
+        // Validate optional externalServices
+        if (spec.externalServices !== undefined) {
+            if (!Array.isArray(spec.externalServices)) {
+                errors.push('externalServices must be an array');
+            }
+            else {
+                for (const svc of spec.externalServices) {
+                    if (!svc.name || typeof svc.name !== 'string')
+                        errors.push('externalServices[].name required');
+                    if (!Array.isArray(svc.requiredSettings))
+                        errors.push(`externalServices[${svc.name}].requiredSettings must be array`);
+                    if (!['shared', 'per-user'].includes(svc.sharingModel))
+                        errors.push(`externalServices[${svc.name}].sharingModel invalid`);
+                }
+            }
+        }
+        // Validate optional userSettings
+        if (spec.userSettings !== undefined) {
+            if (!Array.isArray(spec.userSettings)) {
+                errors.push('userSettings must be an array');
+            }
+        }
+        if (errors.length > 0)
+            return { valid: false, errors, warnings };
+        return { valid: true, errors: [], warnings, parsed: spec };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return { valid: false, errors: [`Failed to parse interview spec: ${msg}`], warnings: [] };
+    }
+}
+export function validateBlueprint(result) {
+    const errors = [];
+    const warnings = [];
+    const raw = extractCodeBlock(result, 'json') || result;
+    const json = sanitizeJson(raw);
+    try {
+        const parsed = JSON.parse(json);
+        // service_slug is REQUIRED — it namespaces all memory keys, translations, and cortex naming
+        if (!parsed.service_slug || typeof parsed.service_slug !== 'string') {
+            errors.push('Missing "service_slug" field — required for memory key namespacing. Must be a kebab-case string (e.g., "company-registry").');
+        }
+        else if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(parsed.service_slug)) {
+            errors.push(`Invalid "service_slug": "${parsed.service_slug}" — must be kebab-case (lowercase letters, numbers, hyphens only)`);
+        }
+        if (!Array.isArray(parsed.components)) {
+            errors.push('Missing "components" array');
+        }
+        else {
+            const allowedComponentKeys = new Set(['id', 'type', 'label', 'produces', 'consumes', 'schedules', 'uses', 'role']);
+            parsed.components = parsed.components.map((c) => {
+                if (!c.id)
+                    errors.push(`Component missing "id" field`);
+                if (!c.type)
+                    errors.push(`Component "${c.id || '?'}" missing "type" field`);
+                if (!c.label)
+                    errors.push(`Component "${c.id || '?'}" missing "label" field`);
+                // Auto-fix common AI shorthand: "ext" → "extension"
+                if (c.type === 'ext') {
+                    c.type = 'extension';
+                    warnings.push(`Component "${c.id}": auto-corrected type "ext" → "extension"`);
+                }
+                if (c.type && !['csm', 'msm', 'extension', 'app', 'memory', 'translation', 'cortex'].includes(c.type)) {
+                    errors.push(`Component "${c.id}" has unknown type "${c.type}"`);
+                }
+                // Validate produces/consumes are arrays of strings (if present)
+                if (c.produces && !Array.isArray(c.produces)) {
+                    warnings.push(`Component "${c.id || '?'}": "produces" should be an array`);
+                }
+                if (c.consumes && !Array.isArray(c.consumes)) {
+                    warnings.push(`Component "${c.id || '?'}": "consumes" should be an array`);
+                }
+                // Strip extra fields (manifest, code, files, etc.) — blueprint is lightweight
+                const extraKeys = Object.keys(c).filter(k => !allowedComponentKeys.has(k));
+                if (extraKeys.length > 0) {
+                    warnings.push(`Component "${c.id || '?'}" had extra fields stripped: ${extraKeys.join(', ')}`);
+                }
+                const clean = { id: c.id, type: c.type, label: c.label };
+                if (typeof c.role === 'string')
+                    clean.role = c.role;
+                if (Array.isArray(c.produces))
+                    clean.produces = c.produces;
+                if (Array.isArray(c.consumes))
+                    clean.consumes = c.consumes;
+                if (Array.isArray(c.schedules) && c.type === 'extension') {
+                    // Validate and auto-fix each schedule entry
+                    for (const s of c.schedules) {
+                        if (!s.action)
+                            errors.push(`Component "${c.id}": schedule missing "action" field`);
+                        if (!s.cron)
+                            errors.push(`Component "${c.id}": schedule missing "cron" field`);
+                        else if (s.cron !== '@activate') {
+                            // Auto-fix: strip markdown backslash escaping (\* → *)
+                            let cron = String(s.cron).trim().replace(/\\\*/g, '*');
+                            if (cron !== String(s.cron).trim()) {
+                                warnings.push(`Component "${c.id}": stripped backslash escaping from cron`);
+                                s.cron = cron;
+                            }
+                            // Auto-fix: "/15" → "*/15" (AI commonly drops leading asterisk)
+                            if (/^\/\d/.test(cron)) {
+                                const fixed = '*' + cron;
+                                warnings.push(`Component "${c.id}": auto-corrected cron "${cron}" → "${fixed}"`);
+                                cron = fixed;
+                                s.cron = fixed;
+                            }
+                            // Auto-fix: pad to 5 fields with * if fields are missing
+                            const fields = cron.split(/\s+/);
+                            if (fields.length < 5 && fields.length >= 3) {
+                                while (fields.length < 5)
+                                    fields.push('*');
+                                const fixed = fields.join(' ');
+                                warnings.push(`Component "${c.id}": auto-padded cron to 5 fields: "${fixed}"`);
+                                s.cron = fixed;
+                            }
+                            else if (fields.length !== 5) {
+                                errors.push(`Component "${c.id}": cron "${s.cron}" must have exactly 5 fields (got ${fields.length}). Example: "*/15 * * * *"`);
+                            }
+                        }
+                    }
+                    clean.schedules = c.schedules;
+                }
+                if (Array.isArray(c.uses) && c.type === 'cortex')
+                    clean.uses = c.uses;
+                return clean;
+            });
+        }
+        // Cross-validate produces/consumes: warn if a consumed key has no producer
+        if (parsed.components) {
+            const components = parsed.components;
+            const allProduced = new Set(components.flatMap(c => c.produces || []));
+            for (const c of components) {
+                for (const consumed of (c.consumes || [])) {
+                    if (!allProduced.has(consumed)) {
+                        warnings.push(`Component "${c.id}" consumes "${consumed}" but no component produces it`);
+                    }
+                }
+            }
+        }
+        if (!Array.isArray(parsed.phases)) {
+            errors.push('Missing "phases" array');
+        }
+        else {
+            parsed.phases = parsed.phases.map(p => {
+                if (!p.id)
+                    errors.push(`Phase missing "id"`);
+                if (!p.label)
+                    errors.push(`Phase "${p.id || '?'}" missing "label"`);
+                if (!Array.isArray(p.componentIds))
+                    errors.push(`Phase "${p.id || '?'}" missing "componentIds" array`);
+                return { id: p.id, label: p.label, componentIds: p.componentIds };
+            });
+        }
+        // Validate dataModel if present
+        if (parsed.dataModel && typeof parsed.dataModel === 'object') {
+            const componentIds = new Set((parsed.components || []).map(c => c.id).filter(Boolean));
+            for (const [key, schema] of Object.entries(parsed.dataModel)) {
+                if (!schema.type)
+                    warnings.push(`dataModel "${key}" missing "type"`);
+                if (!schema.source)
+                    warnings.push(`dataModel "${key}" missing "source"`);
+                if (!schema.producedBy) {
+                    errors.push(`dataModel "${key}" missing "producedBy"`);
+                }
+                else if (!componentIds.has(schema.producedBy)) {
+                    errors.push(`dataModel "${key}" producedBy "${schema.producedBy}" does not match any component`);
+                }
+                if (!Array.isArray(schema.consumedBy) || schema.consumedBy.length === 0) {
+                    warnings.push(`dataModel "${key}" has no consumers`);
+                }
+                else {
+                    for (const cid of schema.consumedBy) {
+                        if (!componentIds.has(cid)) {
+                            errors.push(`dataModel "${key}" consumedBy "${cid}" does not match any component`);
+                        }
+                    }
+                }
+            }
+        }
+        else {
+            warnings.push('Missing "dataModel" — downstream components will not have schema guidance');
+        }
+        // Validate optional settings
+        if (parsed.settings) {
+            const s = parsed.settings;
+            if (s.service && !Array.isArray(s.service))
+                errors.push('settings.service must be an array');
+            if (s.user && !Array.isArray(s.user))
+                errors.push('settings.user must be an array');
+            if (Array.isArray(s.service)) {
+                for (const entry of s.service) {
+                    if (!entry.key || !entry.type || !entry.label) {
+                        errors.push('settings.service entry missing key/type/label');
+                    }
+                    if (entry.type && !['secret', 'url', 'string', 'number', 'boolean'].includes(entry.type)) {
+                        warnings.push(`settings.service[${entry.key}] has unknown type: ${entry.type}`);
+                    }
+                }
+            }
+        }
+        return { valid: errors.length === 0, errors, warnings, parsed, extracted: json };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        errors.push(`Invalid JSON: ${msg}`);
+        return { valid: false, errors, warnings, parsed: null, extracted: json };
+    }
+}
+//# sourceMappingURL=generator-validate.js.map