@arcadialdev/arcality 3.0.3 → 4.0.0

package/scripts/rebrand-report.mjs

@@ -1,4 +1,5 @@
 import fs from 'fs';
+import os from 'os';
 import path from 'path';
 import { fileURLToPath } from 'url';
 
@@ -9,11 +10,11 @@ const ARCALITY_ROOT = process.env.ARCALITY_ROOT || path.resolve(__dirname, '..')
 
 async function rebrandReport() {
     // Definir directorios objetivo: El reporte personalizado, el nativo anidado y el reporte interno
-    const reportDir = process.env.REPORTS_DIR || 'tests-report';
+    const reportDir = process.env.REPORTS_DIR || path.join(os.tmpdir(), 'arcality', 'reports');
     const targetDirs = [
         reportDir,
         path.join(reportDir, 'native'),
-        'playwright-internal-report'
+        path.join(os.tmpdir(), 'arcality', 'playwright-internal-report')
     ];
 
     const logoPngPath = path.join(ARCALITY_ROOT, 'public', 'logo.png');
@@ -52,22 +53,22 @@ function processDirectory(reportDir, logoBase64) {
             html = html.replace(/at\s+.*?node_modules.*?(\n|\r)/g, '');
             html = html.replace(/at\s+.*?agentic-runner\.spec\.ts:\d+/g, '');
 
-            // 3. Preserve custom Arcality reports before native Playwright styling.
-            // The custom Arcality report owns its visual system. Keep the
-            // aggressive Playwright rebrand injection for native reports only.
-            const isArcalityMissionConsole = html.includes('class="mission-brief"') || html.includes('Arcality QA Engine');
-            if (isArcalityMissionConsole) {
-                if (logoBase64) {
-                    html = html.replace(/rel="shortcut icon" href=".*?"/g, `rel="shortcut icon" href="${logoBase64}"`);
-                    html = html.replace(/rel="icon" href=".*?"/g, `rel="icon" href="${logoBase64}"`);
-                }
-                fs.writeFileSync(indexPath, html, 'utf8');
-                processTraceViewer(reportDir, logoBase64);
-                return;
-            }
-
-            // 4. Inyección de Estilos y Scripts (MODO AGRESIVO)
-            const customStyles = `
+            // 3. Preserve custom Arcality reports before native Playwright styling.
+            // The custom Arcality report owns its visual system. Keep the
+            // aggressive Playwright rebrand injection for native reports only.
+            const isArcalityMissionConsole = html.includes('class="mission-brief"') || html.includes('Arcality QA Engine');
+            if (isArcalityMissionConsole) {
+                if (logoBase64) {
+                    html = html.replace(/rel="shortcut icon" href=".*?"/g, `rel="shortcut icon" href="${logoBase64}"`);
+                    html = html.replace(/rel="icon" href=".*?"/g, `rel="icon" href="${logoBase64}"`);
+                }
+                fs.writeFileSync(indexPath, html, 'utf8');
+                processTraceViewer(reportDir, logoBase64);
+                return;
+            }
+
+            // 4. Inyección de Estilos y Scripts (MODO AGRESIVO)
+            const customStyles = `
                 <script id="arcality-branding-script">
                     /* ARCALITY_BRANDING_SCRIPT */
                     // 1. Limpieza de Caché y Service Worker

package/src/KnowledgeService.ts

@@ -30,22 +30,22 @@ export interface PortalContextResponse {
     fields: Array<{ field_identifier: string; field_type: string; is_required: boolean }>;
 }
 
-export interface ProjectDto {
-    id: string;
-    name: string;
-    base_url?: string;
-}
-
-function isRealProjectId(projectId?: string | null): boolean {
-    const id = String(projectId || '').trim();
-    if (!id) return false;
-    if (id === 'undefined' || id === 'null') return false;
-    if (/^(local|mock)_/i.test(id)) return false;
-    if (/^0{8}-0{4}-0{4}-0{4}-0{12}$/i.test(id)) return false;
-    return true;
-}
-
-export class KnowledgeService {
+export interface ProjectDto {
+    id: string;
+    name: string;
+    base_url?: string;
+}
+
+function isRealProjectId(projectId?: string | null): boolean {
+    const id = String(projectId || '').trim();
+    if (!id) return false;
+    if (id === 'undefined' || id === 'null') return false;
+    if (/^(local|mock)_/i.test(id)) return false;
+    if (/^0{8}-0{4}-0{4}-0{4}-0{12}$/i.test(id)) return false;
+    return true;
+}
+
+export class KnowledgeService {
     private static instance: KnowledgeService;
     private apiBase: string;
     private apiKey: string;
@@ -89,10 +89,10 @@ export class KnowledgeService {
     }
 
     public getProjectId(): string | null {
-        if (!isRealProjectId(this.projectId)) {
-            this.projectId = process.env.ARCALITY_PROJECT_ID || null;
-        }
-        return isRealProjectId(this.projectId) ? this.projectId : null;
+        if (!isRealProjectId(this.projectId)) {
+            this.projectId = process.env.ARCALITY_PROJECT_ID || null;
+        }
+        return isRealProjectId(this.projectId) ? this.projectId : null;
     }
 
     /**
@@ -107,7 +107,7 @@ export class KnowledgeService {
             const data = await res.json();
             return data.projects || [];
         } catch (e: any) {
-            if (process.env.DEBUG) console.warn(chalk.yellow(`[KnowledgeService] Error al obtener proyectos: ${e.message}`));
+            if (process.env.DEBUG) console.warn(chalk.yellow(`[KnowledgeService] Error al obtener proyectos: ${e.message}`));
             return [];
         }
     }
@@ -125,7 +125,7 @@ export class KnowledgeService {
             if (!res.ok) return null;
             return await res.json();
         } catch (e: any) {
-            if (process.env.DEBUG) console.error(chalk.red(`[KnowledgeService] Falló creación de proyecto: ${e.message}`));
+            if (process.env.DEBUG) console.error(chalk.red(`[KnowledgeService] Falló creación de proyecto: ${e.message}`));
             return null;
         }
     }
@@ -134,8 +134,8 @@ export class KnowledgeService {
      * 2. Ingesta (Post-Percept)
      */
     public async ingest(payload: PortalIngestRequest): Promise<void> {
-        if (!isRealProjectId(payload.project_id)) {
-            if (process.env.DEBUG) console.warn(chalk.yellow(`[Knowledge] Ingesta cancelada: project_id es inválido.`));
+        if (!isRealProjectId(payload.project_id)) {
+            if (process.env.DEBUG) console.warn(chalk.yellow(`[Knowledge] Ingesta cancelada: project_id es inválido.`));
             return;
         }
 
@@ -157,7 +157,7 @@ export class KnowledgeService {
                 }
             }
         } catch (e: any) {
-            if (process.env.DEBUG) console.warn(chalk.yellow(`[Knowledge] Error en ingesta: ${e.message}`));
+            if (process.env.DEBUG) console.warn(chalk.yellow(`[Knowledge] Error en ingesta: ${e.message}`));
         }
     }
 
@@ -179,7 +179,7 @@ export class KnowledgeService {
             if (!res.ok) return null;
             return await res.json();
         } catch (e: any) {
-            if (process.env.DEBUG) console.warn(chalk.yellow(`[Knowledge] Error al obtener contexto: ${e.message}`));
+            if (process.env.DEBUG) console.warn(chalk.yellow(`[Knowledge] Error al obtener contexto: ${e.message}`));
             return null;
         }
     }
@@ -207,7 +207,7 @@ export class KnowledgeService {
                     severity
                 })
             });
-            if (process.env.DEBUG) console.log(chalk.green(`[Knowledge] Nueva regla registrada: ${title}`));
+            if (process.env.DEBUG) console.log(chalk.green(`[Knowledge] Nueva regla registrada: ${title}`));
         } catch (e) { }
     }
 
@@ -233,7 +233,7 @@ export class KnowledgeService {
                     source: "agent_auto"
                 })
             });
-            if (process.env.DEBUG) console.log(chalk.green(`[Knowledge] Nuevo campo catalogado: ${identifier}`));
+            if (process.env.DEBUG) console.log(chalk.green(`[Knowledge] Nuevo campo catalogado: ${identifier}`));
         } catch (e) { }
     }
 
@@ -259,7 +259,7 @@ export class KnowledgeService {
                     source: "agent_auto"
                 })
             });
-            if (process.env.DEBUG) console.log(chalk.green(`[Knowledge] Nuevo conocimiento guardado: ${title}`));
+            if (process.env.DEBUG) console.log(chalk.green(`[Knowledge] Nuevo conocimiento guardado: ${title}`));
         } catch (e) { }
     }
 

package/src/arcalityClient.mjs

@@ -306,10 +306,16 @@ function simpleHash(str) {
         hash = ((hash << 5) - hash) + char;
         hash |= 0;
     }
-    return 'ph_' + Math.abs(hash).toString(36);
-}
-
-/**
+    return 'ph_' + Math.abs(hash).toString(36);
+}
+
+function normalizeBugClassification(value) {
+    const text = String(value || '').trim();
+    const allowed = ['[Backend Bug]', '[Frontend Bug]', '[UI Regression]', '[Flaky/Stale Selector]'];
+    return allowed.find(category => text.includes(category)) || '';
+}
+
+/**
  * Crea una Task en Azure DevOps cuando se detecta un bug en el portal.
  * Si la organización no tiene la integración configurada (HTTP 400) se registra
  * sólo en modo DEBUG y NO interrumpe el flujo del test runner.
@@ -318,7 +324,7 @@ function simpleHash(str) {
  * @param {string} description - Descripción detallada del bug detectado
  * @returns {Promise<{success: boolean, taskUrl?: string, error?: string}>}
  */
-export async function createAdoTask(title, description) {
+export async function createAdoTask(title, description, metadata = {}) {
     const apiBase = getEffectiveApiBase();
     if (!apiBase) {
         if (process.env.DEBUG) console.log(`[ADO] No hay ARCALITY_API_URL configurado. Omitiendo creación de Task en Azure DevOps.`);
@@ -337,19 +343,26 @@ export async function createAdoTask(title, description) {
         return { success: false, error: 'no_api_key' };
     }
 
-    try {
-        const controller = new AbortController();
-        const timeout = setTimeout(() => controller.abort(), 15000);
-
-        const res = await fetch(`${apiBase}/api/v1/integrations/azuredevops/task`, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                'x-api-key': key
-            },
-            body: JSON.stringify({ project_id: projectId, title, description }),
-            signal: controller.signal
-        });
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 15000);
+        const bugClassification = normalizeBugClassification(metadata?.classification);
+        const taskTitle = bugClassification && !String(title).includes(bugClassification)
+            ? `${bugClassification} ${title}`
+            : title;
+        const taskDescription = bugClassification && !String(description).includes('Clasificacion')
+            ? `**Clasificacion:** ${bugClassification}\n\n${description}`
+            : description;
+
+        const res = await fetch(`${apiBase}/api/v1/integrations/azuredevops/task`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-api-key': key
+            },
+            body: JSON.stringify({ project_id: projectId, title: taskTitle, description: taskDescription }),
+            signal: controller.signal
+        });
         clearTimeout(timeout);
 
         if (res.status === 400) {

package/src/configLoader.mjs

@@ -1,10 +1,10 @@
 // src/configLoader.mjs
 // Configuration loader — supports arcality.config (primary) and .env / global config (fallback)
-import fs from 'node:fs';
-import path from 'node:path';
-import os from 'node:os';
-import dotenv from 'dotenv';
-import { isRealProjectId } from './configManager.mjs';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import dotenv from 'dotenv';
+import { isRealProjectId } from './configManager.mjs';
 
 dotenv.config();
 
@@ -59,22 +59,22 @@ export function loadConfig() {
         ARCALITY_PROJECT_ID: localConfig?.projectId || process.env.ARCALITY_PROJECT_ID,
     };
 
-    if (!config.ARCALITY_API_KEY) {
-        throw new Error('ARCALITY_API_KEY is not defined. Run `arcality init` or set it in your .env file.');
-    }
-
-    if (!isRealProjectId(config.ARCALITY_PROJECT_ID)) {
-        throw new Error('ARCALITY_PROJECT_ID is not connected to a real Arcality project. Run `arcality init`.');
-    }
-
-    return config;
-}
+    if (!config.ARCALITY_API_KEY) {
+        throw new Error('ARCALITY_API_KEY is not defined. Run `arcality init` or set it in your .env file.');
+    }
+
+    if (!isRealProjectId(config.ARCALITY_PROJECT_ID)) {
+        throw new Error('ARCALITY_PROJECT_ID is not connected to a real Arcality project. Run `arcality init`.');
+    }
 
-export function loadProjectId() {
-    const localConfig = loadLocalArcalityConfig();
-    const projectId = localConfig?.projectId || process.env.ARCALITY_PROJECT_ID;
-    return isRealProjectId(projectId) ? projectId : null;
-}
+    return config;
+}
+
+export function loadProjectId() {
+    const localConfig = loadLocalArcalityConfig();
+    const projectId = localConfig?.projectId || process.env.ARCALITY_PROJECT_ID;
+    return isRealProjectId(projectId) ? projectId : null;
+}
 
 
 /**
@@ -133,25 +133,25 @@ export function getApiKey() {
     return { key: null, source: 'none' };
 }
 
-/**
- * Loads supported Arcality runtime values into process.env.
- */
-export function setupProcessEnv() {
-    const config = loadGlobalConfig();
-    if (!config) return;
-
-    // Load Arcality API Key
-    getApiKey();
-
-    // Also inject arcality.config values into process.env for backward compat
-    const localConfig = loadLocalArcalityConfig();
+/**
+ * Loads supported Arcality runtime values into process.env.
+ */
+export function setupProcessEnv() {
+    const config = loadGlobalConfig();
+    if (!config) return;
+
+    // Load Arcality API Key
+    getApiKey();
+
+    // Also inject arcality.config values into process.env for backward compat
+    const localConfig = loadLocalArcalityConfig();
     if (localConfig) {
         if (localConfig.apiKey && !process.env.ARCALITY_API_KEY) {
             process.env.ARCALITY_API_KEY = localConfig.apiKey;
         }
-        if (isRealProjectId(localConfig.projectId) && !process.env.ARCALITY_PROJECT_ID) {
-            process.env.ARCALITY_PROJECT_ID = localConfig.projectId;
-        }
+        if (isRealProjectId(localConfig.projectId) && !process.env.ARCALITY_PROJECT_ID) {
+            process.env.ARCALITY_PROJECT_ID = localConfig.projectId;
+        }
         if (localConfig.project?.baseUrl && !process.env.BASE_URL) {
             process.env.BASE_URL = localConfig.project.baseUrl;
         }

package/src/configManager.mjs

@@ -6,15 +6,17 @@ import fs from 'node:fs';
 import path from 'node:path';
 
 const CONFIG_FILENAME = 'arcality.config';
-
-export function isRealProjectId(projectId) {
-    const id = String(projectId || '').trim();
-    if (!id) return false;
-    if (id === 'undefined' || id === 'null') return false;
-    if (/^(local|mock)_/i.test(id)) return false;
-    if (/^0{8}-0{4}-0{4}-0{4}-0{12}$/i.test(id)) return false;
-    return true;
-}
+const LEGACY_OUTPUT_DIRS = new Set(['arcality', './arcality', '.\\arcality']);
+const DEFAULT_YAML_OUTPUT_DIR = './.arcality';
+
+export function isRealProjectId(projectId) {
+    const id = String(projectId || '').trim();
+    if (!id) return false;
+    if (id === 'undefined' || id === 'null') return false;
+    if (/^(local|mock)_/i.test(id)) return false;
+    if (/^0{8}-0{4}-0{4}-0{4}-0{12}$/i.test(id)) return false;
+    return true;
+}
 
 /**
  * Resolves the path to arcality.config in the project root.
@@ -68,55 +70,55 @@ export function saveProjectConfig(config, projectRoot) {
  * @param {ArcalityConfig} config
  * @returns {{ valid: boolean, missing: string[] }}
  */
-export function validateConfig(config) {
-    const missing = [];
+export function validateConfig(config) {
+    const missing = [];
 
     if (!config) {
         return { valid: false, missing: ['arcality.config file'] };
     }
 
-    if (!config.apiKey) missing.push('apiKey');
-    if (!isRealProjectId(config.projectId)) missing.push('projectId');
-    if (!config.project?.baseUrl) missing.push('project.baseUrl');
-    if (!config.auth?.username) missing.push('auth.username');
-    if (!config.auth?.password) missing.push('auth.password');
-
-    return { valid: missing.length === 0, missing };
-}
+    if (!config.apiKey) missing.push('apiKey');
+    if (!isRealProjectId(config.projectId)) missing.push('projectId');
+    if (!config.project?.baseUrl) missing.push('project.baseUrl');
+    if (!config.auth?.username) missing.push('auth.username');
+    if (!config.auth?.password) missing.push('auth.password');
+
+    return { valid: missing.length === 0, missing };
+}
 
 /**
  * Creates a fresh arcality.config structure.
  * @param {object} params
  * @returns {ArcalityConfig}
  */
-export function createConfig({
+export function createConfig({
     apiKey,
     organizationId,
     projectId,
-    projectName,
-    baseUrl,
-    frameworkDetected,
-    username,
-    password,
-    arcalityVersion,
-    yamlOutputDir = './arcality',
+    projectName,
+    baseUrl,
+    frameworkDetected,
+    username,
+    password,
+    arcalityVersion,
+    yamlOutputDir = DEFAULT_YAML_OUTPUT_DIR,
 }) {
-    return {
+    return {
         version: '1',
         apiKey,
         organizationId: organizationId || null,
         projectId,
         project: {
             name: projectName,
-            baseUrl,
-            frameworkDetected: frameworkDetected || null,
-        },
-        auth: {
-            username,
-            password,
-        },
-        runtime: {
-            yamlOutputDir,
+            baseUrl,
+            frameworkDetected: frameworkDetected || null,
+        },
+        auth: {
+            username,
+            password,
+        },
+        runtime: {
+            yamlOutputDir,
             reuseSuccessfulYamls: true,
             singleConfigurationMode: true,
         },
@@ -131,17 +133,18 @@ export function createConfig({
  * with existing modules that read from process.env.
  * @param {ArcalityConfig} config
  */
-export function injectConfigToEnv(config) {
-    if (!config) return;
+export function injectConfigToEnv(config) {
+    if (!config) return;
 
     if (config.apiKey) process.env.ARCALITY_API_KEY = config.apiKey;
-    if (isRealProjectId(config.projectId)) process.env.ARCALITY_PROJECT_ID = config.projectId;
-    if (config.project?.baseUrl && !process.env.BASE_URL) {
-        process.env.BASE_URL = config.project.baseUrl;
-    }
-    if (config.auth?.username) process.env.LOGIN_USER = config.auth.username;
-    if (config.auth?.password) process.env.LOGIN_PASSWORD = config.auth.password;
-}
+    if (config.organizationId) process.env.ARCALITY_ORG_ID = config.organizationId;
+    if (isRealProjectId(config.projectId)) process.env.ARCALITY_PROJECT_ID = config.projectId;
+    if (config.project?.baseUrl && !process.env.BASE_URL) {
+        process.env.BASE_URL = config.project.baseUrl;
+    }
+    if (config.auth?.username) process.env.LOGIN_USER = config.auth.username;
+    if (config.auth?.password) process.env.LOGIN_PASSWORD = config.auth.password;
+}
 
 /**
  * Gets the YAML output directory from config, falling back to default.
@@ -149,10 +152,13 @@ export function injectConfigToEnv(config) {
  * @param {string} [projectRoot]
  * @returns {string} absolute path
  */
-export function getYamlOutputDir(config, projectRoot) {
-    const dir = config?.runtime?.yamlOutputDir || './arcality';
-    return path.resolve(projectRoot || process.cwd(), dir);
-}
+export function getYamlOutputDir(config, projectRoot) {
+    const configuredDir = String(config?.runtime?.yamlOutputDir || '').trim();
+    const dir = LEGACY_OUTPUT_DIRS.has(configuredDir) || !configuredDir
+        ? DEFAULT_YAML_OUTPUT_DIR
+        : configuredDir;
+    return path.resolve(projectRoot || process.cwd(), dir);
+}
 
 /**
  * Ensures the YAML output directory exists.
@@ -175,7 +181,7 @@ export function ensureYamlOutputDir(config, projectRoot) {
  * @property {string|null} organizationId
  * @property {string} projectId
  * @property {{ name: string, baseUrl: string, frameworkDetected: string|null }} project
- * @property {{ username: string, password: string }} auth
+ * @property {{ username: string, password: string }} auth
  * @property {{ yamlOutputDir: string, reuseSuccessfulYamls: boolean, singleConfigurationMode: boolean }} runtime
  * @property {{ arcalityVersion: string }} meta
  */

package/src/services/codebaseAnalyzer.mjs

@@ -0,0 +1,59 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { discoverProjectRoutes } from './routeDiscovery.mjs';
+
+function readJson(filePath) {
+    const raw = fs.readFileSync(filePath, 'utf8');
+    return JSON.parse(raw);
+}
+
+function detectFramework(pkg) {
+    const deps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
+    if (deps.next) return 'next';
+    if (deps.vite) return 'vite';
+    if (deps['react-scripts']) return 'cra';
+    return 'unknown';
+}
+
+export function analyzeCodebase(projectRoot = process.cwd(), options = {}) {
+    const pkgPath = path.join(projectRoot, 'package.json');
+    const result = {
+        projectRoot,
+        packageJsonPath: pkgPath,
+        projectName: path.basename(projectRoot),
+        framework: 'unknown',
+        scripts: [],
+        dependencies: [],
+        routeCount: 0,
+        routes: [],
+        warnings: []
+    };
+
+    if (!fs.existsSync(pkgPath)) {
+        result.warnings.push('No se encontro package.json en el proyecto destino.');
+        return result;
+    }
+
+    try {
+        const pkg = readJson(pkgPath);
+        result.projectName = pkg.name || result.projectName;
+        result.framework = detectFramework(pkg);
+        result.scripts = Object.keys(pkg.scripts || {});
+        result.dependencies = Object.keys({ ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) });
+        result.routes = discoverProjectRoutes(projectRoot, result.framework, {
+            baseUrl: options.baseUrl || ''
+        });
+        result.routeCount = result.routes.length;
+
+        if (result.routeCount === 0) {
+            result.warnings.push(`No se detectaron rutas automaticamente para el framework "${result.framework}".`);
+        }
+        if (result.framework === 'unknown') {
+            result.warnings.push('Framework no reconocido automaticamente. Se usaron heuristicas de fallback.');
+        }
+    } catch (error) {
+        result.warnings.push(`No se pudo analizar el proyecto: ${error.message}`);
+    }
+
+    return result;
+}

package/src/services/generatedMissionSchema.mjs

@@ -0,0 +1,76 @@
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+
+function isPriority(value) {
+    return value === 'high' || value === 'normal' || value === 'low';
+}
+
+export function validateGeneratedMissionSchema(mission) {
+    const issues = [];
+
+    if (!mission || typeof mission !== 'object' || Array.isArray(mission)) {
+        return {
+            valid: false,
+            issues: ['Mission must be a plain object.']
+        };
+    }
+
+    if (!isNonEmptyString(mission.name)) issues.push('name is required.');
+    if (!isNonEmptyString(mission.prompt)) issues.push('prompt is required.');
+    if (!isNonEmptyString(mission.page)) issues.push('page is required.');
+    if (!isNonEmptyString(mission.page_path)) issues.push('page_path is required.');
+    if (!isNonEmptyString(mission.expected_result)) issues.push('expected_result is required.');
+    if (!Array.isArray(mission.tags) || mission.tags.length === 0) issues.push('tags must be a non-empty array.');
+    if (!isPriority(mission.priority)) issues.push('priority must be one of: high, normal, low.');
+    if (!isNonEmptyString(mission.collection)) issues.push('collection is required.');
+    if (!isNonEmptyString(mission.created_at) || Number.isNaN(Date.parse(mission.created_at))) {
+        issues.push('created_at must be a valid ISO date string.');
+    }
+
+    if (!mission.generation || typeof mission.generation !== 'object' || Array.isArray(mission.generation)) {
+        issues.push('generation metadata is required.');
+    } else {
+        if (!isNonEmptyString(mission.generation.source)) issues.push('generation.source is required.');
+        if (!isNonEmptyString(mission.generation.framework)) issues.push('generation.framework is required.');
+        if (!isNonEmptyString(mission.generation.router_kind)) issues.push('generation.router_kind is required.');
+        if (!isNonEmptyString(mission.generation.variant)) issues.push('generation.variant is required.');
+        if (!isNonEmptyString(mission.generation.route_hash)) issues.push('generation.route_hash is required.');
+        if (!isNonEmptyString(mission.generation.prompt_hash)) issues.push('generation.prompt_hash is required.');
+        if (!isNonEmptyString(mission.generation.route_example_path)) {
+            issues.push('generation.route_example_path is required.');
+        }
+        if (!Array.isArray(mission.generation.route_params)) {
+            issues.push('generation.route_params must be an array.');
+        }
+
+        const status = mission.generation.context_status;
+        if (!status || typeof status !== 'object' || Array.isArray(status)) {
+            issues.push('generation.context_status is required.');
+        } else {
+            if (!isNonEmptyString(status.qaContext)) issues.push('generation.context_status.qaContext is required.');
+            if (!isNonEmptyString(status.feasibility)) issues.push('generation.context_status.feasibility is required.');
+        }
+    }
+
+    if (Array.isArray(mission.tags)) {
+        for (const tag of mission.tags) {
+            if (!isNonEmptyString(tag)) {
+                issues.push('tags must contain only non-empty strings.');
+                break;
+            }
+        }
+    }
+
+    return {
+        valid: issues.length === 0,
+        issues
+    };
+}
+
+export function assertGeneratedMissionSchema(mission) {
+    const result = validateGeneratedMissionSchema(mission);
+    if (!result.valid) {
+        throw new Error(`Generated mission schema validation failed: ${result.issues.join(' ')}`);
+    }
+}