@arcadialdev/arcality 4.0.2 → 4.1.1

package/src/services/executionEvidenceService.mjs

@@ -0,0 +1,124 @@
+function normalizeStatus(value) {
+    const normalized = String(value || '').trim().toLowerCase();
+    if (normalized === 'passed' || normalized === 'pass' || normalized === 'success') return 'passed';
+    if (normalized === 'failed' || normalized === 'fail' || normalized === 'error') return 'failed';
+    return 'unknown';
+}
+
+function classifyLogs(logs = []) {
+    const entries = Array.isArray(logs) ? logs.map(entry => String(entry || '').trim()).filter(Boolean) : [];
+    const errors = entries.filter(entry => entry.includes('[ERROR]') || entry.includes('[NETWORK_ERROR]'));
+    const warnings = entries.filter(entry => entry.includes('[WARNING]'));
+    return {
+        total: entries.length,
+        error_count: errors.length,
+        warning_count: warnings.length,
+        recent: entries.slice(-10)
+    };
+}
+
+function summarizeAttachments(attachments = []) {
+    const normalized = Array.isArray(attachments)
+        ? attachments.map(att => ({
+            name: String(att?.name || '').trim(),
+            contentType: String(att?.contentType || '').trim(),
+            path: att?.path ? String(att.path) : undefined
+        })).filter(att => att.name || att.contentType || att.path)
+        : [];
+
+    return {
+        total: normalized.length,
+        images: normalized.filter(att => att.contentType.startsWith('image/')).length,
+        videos: normalized.filter(att => att.contentType.startsWith('video/')).length,
+        json: normalized.filter(att => att.contentType === 'application/json').length,
+        names: normalized.map(att => att.name || att.path || 'attachment').slice(0, 12)
+    };
+}
+
+function deriveDatabaseStatus(input) {
+    const explicit = normalizeStatus(input?.database_status);
+    if (explicit !== 'unknown') return explicit;
+    if (typeof input?.database_report?.passed === 'boolean') {
+        return input.database_report.passed ? 'passed' : 'failed';
+    }
+    return 'unknown';
+}
+
+function buildContradictions(uiStatus, dbStatus) {
+    const contradictions = [];
+    if (uiStatus === 'passed' && dbStatus === 'failed') contradictions.push('ui_passed_but_db_failed');
+    if (uiStatus === 'failed' && dbStatus === 'passed') contradictions.push('ui_failed_but_db_passed');
+    return contradictions;
+}
+
+function buildRemediationHints(finalStatus, contradictions, consoleSummary) {
+    const hints = [];
+    if (contradictions.includes('ui_passed_but_db_failed')) {
+        hints.push('Revisar la persistencia backend o la confirmacion visual de guardado.');
+    }
+    if (contradictions.includes('ui_failed_but_db_passed')) {
+        hints.push('Revisar si la UI muestra un error falso o si el flujo se completo parcialmente.');
+    }
+    if (consoleSummary.error_count > 0) {
+        hints.push('Inspeccionar errores de consola o red asociados al momento de la falla.');
+    }
+    if (finalStatus === 'unknown') {
+        hints.push('Completar evidencia faltante antes de cerrar la conclusion.');
+    }
+    return hints;
+}
+
+export function summarizeExecutionEvidence(input = {}, context = {}) {
+    const uiStatus = normalizeStatus(input.ui_status);
+    const dbStatus = deriveDatabaseStatus(input);
+    const consoleSummary = classifyLogs(context.logs || input.console_logs);
+    const attachmentSummary = summarizeAttachments(context.attachments || input.attachments);
+    const contradictions = buildContradictions(uiStatus, dbStatus);
+
+    let finalStatus = 'unknown';
+    if (contradictions.length > 0) {
+        finalStatus = 'contradiction';
+    } else if (uiStatus === 'failed' || dbStatus === 'failed') {
+        finalStatus = 'failed';
+    } else if (uiStatus === 'passed' || dbStatus === 'passed') {
+        finalStatus = 'passed';
+    }
+
+    const remediationHints = buildRemediationHints(finalStatus, contradictions, consoleSummary);
+    const missionName = String(input.mission_name || input.name || 'execution_evidence').trim();
+    const expectedOutcome = String(input.expected_business_outcome || '').trim();
+    const uiSummary = String(input.ui_summary || '').trim();
+    const validationName = String(input.database_validation_name || input.database_report?.name || '').trim();
+    const queryId = String(input.query_id || input.database_report?.query_id || '').trim();
+
+    const summary = finalStatus === 'contradiction'
+        ? 'La evidencia es contradictoria entre UI y base de datos.'
+        : finalStatus === 'failed'
+            ? 'La ejecucion contiene evidencia suficiente para marcar falla.'
+            : finalStatus === 'passed'
+                ? 'La evidencia disponible respalda un resultado exitoso.'
+                : 'La ejecucion requiere mas evidencia para una conclusion firme.';
+
+    return {
+        type: 'execution_evidence_summary',
+        mission_name: missionName,
+        final_status: finalStatus,
+        summary,
+        expected_business_outcome: expectedOutcome || undefined,
+        current_url: context.current_url || input.current_url || undefined,
+        ui: {
+            status: uiStatus,
+            summary: uiSummary || undefined
+        },
+        database: {
+            status: dbStatus,
+            validation_name: validationName || undefined,
+            query_id: queryId || undefined
+        },
+        console: consoleSummary,
+        attachments: attachmentSummary,
+        contradictions,
+        remediation_hints: remediationHints,
+        generated_at: new Date().toISOString()
+    };
+}

package/src/services/generatedMissionSchema.mjs

@@ -1,76 +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(' ')}`);
-    }
-}
+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(' ')}`);
+    }
+}

package/src/services/generatedMissionStore.mjs

@@ -1,117 +1,117 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { dump, load as loadYaml } from 'js-yaml';
-import { buildMissionIdentity } from './missionGenerator.mjs';
-import { assertGeneratedMissionSchema } from './generatedMissionSchema.mjs';
-
-const YAML_RE = /\.(yaml|yml)$/i;
-
-function toPosix(value) {
-    return String(value || '').split(path.sep).join('/');
-}
-
-function walk(dir, out = []) {
-    if (!fs.existsSync(dir)) return out;
-    const entries = fs.readdirSync(dir, { withFileTypes: true });
-    for (const entry of entries) {
-        const full = path.join(dir, entry.name);
-        if (entry.isDirectory()) {
-            if (entry.name === '_templates') continue;
-            walk(full, out);
-        } else {
-            out.push(full);
-        }
-    }
-    return out;
-}
-
-function sanitizeName(value) {
-    return String(value || 'generated_mission')
-        .trim()
-        .replace(/[^\w.-]+/g, '_')
-        .replace(/_+/g, '_')
-        .replace(/^_+|_+$/g, '') || 'generated_mission';
-}
-
-function ensureDir(dir) {
-    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-}
-
-function loadExistingMissionIdentities(targetDir) {
-    const identities = new Set();
-    if (!fs.existsSync(targetDir)) return identities;
-
-    const files = walk(targetDir).filter(file => YAML_RE.test(file)).filter(file => !/[\\/]_collection\.(yaml|yml)$/i.test(file));
-    for (const file of files) {
-        try {
-            const parsed = loadYaml(fs.readFileSync(file, 'utf8'));
-            if (!parsed || typeof parsed !== 'object') continue;
-            const identity = buildMissionIdentity(parsed);
-            if (identity) identities.add(identity);
-        } catch {
-            // Silencioso: si un YAML existente no se puede leer, no bloqueamos la generación.
-        }
-    }
-
-    return identities;
-}
-
-function writeCache(projectRoot, payload) {
-    const cacheDir = path.join(projectRoot, '.arcality', 'cache');
-    ensureDir(cacheDir);
-    fs.writeFileSync(path.join(cacheDir, 'generate-state.json'), JSON.stringify(payload, null, 2), 'utf8');
-}
-
-export function saveGeneratedMissions({ projectRoot, targetDir, missions, dryRun = false }) {
-    const existingIdentities = loadExistingMissionIdentities(targetDir);
-    const created = [];
-    const skipped = [];
-
-    if (!dryRun) ensureDir(targetDir);
-
-    for (const mission of missions) {
-        assertGeneratedMissionSchema(mission);
-        const identity = buildMissionIdentity(mission);
-        if (!identity || existingIdentities.has(identity)) {
-            skipped.push({
-                name: mission.name,
-                page_path: mission.page_path,
-                reason: 'duplicate'
-            });
-            continue;
-        }
-
-        const collectionRel = String(mission.collection || 'generated/general').replace(/^\/+/, '');
-        const targetCollectionDir = path.join(targetDir, collectionRel);
-        const fileName = `${sanitizeName(mission.name)}.yaml`;
-        const filePath = path.join(targetCollectionDir, fileName);
-
-        if (!dryRun) {
-            ensureDir(targetCollectionDir);
-            fs.writeFileSync(filePath, dump(mission, { lineWidth: 120, noRefs: true }), 'utf8');
-        }
-
-        existingIdentities.add(identity);
-        created.push({
-            name: mission.name,
-            page_path: mission.page_path,
-            filePath: toPosix(path.relative(projectRoot, filePath))
-        });
-    }
-
-    const summary = {
-        generated_at: new Date().toISOString(),
-        target_dir: toPosix(path.relative(projectRoot, targetDir) || '.'),
-        total_requested: missions.length,
-        created_count: created.length,
-        skipped_count: skipped.length,
-        created,
-        skipped
-    };
-
-    if (!dryRun) {
-        writeCache(projectRoot, summary);
-    }
-
-    return summary;
-}
+import fs from 'node:fs';
+import path from 'node:path';
+import { dump, load as loadYaml } from 'js-yaml';
+import { buildMissionIdentity } from './missionGenerator.mjs';
+import { assertGeneratedMissionSchema } from './generatedMissionSchema.mjs';
+
+const YAML_RE = /\.(yaml|yml)$/i;
+
+function toPosix(value) {
+    return String(value || '').split(path.sep).join('/');
+}
+
+function walk(dir, out = []) {
+    if (!fs.existsSync(dir)) return out;
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (entry.name === '_templates') continue;
+            walk(full, out);
+        } else {
+            out.push(full);
+        }
+    }
+    return out;
+}
+
+function sanitizeName(value) {
+    return String(value || 'generated_mission')
+        .trim()
+        .replace(/[^\w.-]+/g, '_')
+        .replace(/_+/g, '_')
+        .replace(/^_+|_+$/g, '') || 'generated_mission';
+}
+
+function ensureDir(dir) {
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+}
+
+function loadExistingMissionIdentities(targetDir) {
+    const identities = new Set();
+    if (!fs.existsSync(targetDir)) return identities;
+
+    const files = walk(targetDir).filter(file => YAML_RE.test(file)).filter(file => !/[\\/]_collection\.(yaml|yml)$/i.test(file));
+    for (const file of files) {
+        try {
+            const parsed = loadYaml(fs.readFileSync(file, 'utf8'));
+            if (!parsed || typeof parsed !== 'object') continue;
+            const identity = buildMissionIdentity(parsed);
+            if (identity) identities.add(identity);
+        } catch {
+            // Silencioso: si un YAML existente no se puede leer, no bloqueamos la generación.
+        }
+    }
+
+    return identities;
+}
+
+function writeCache(projectRoot, payload) {
+    const cacheDir = path.join(projectRoot, '.arcality', 'cache');
+    ensureDir(cacheDir);
+    fs.writeFileSync(path.join(cacheDir, 'generate-state.json'), JSON.stringify(payload, null, 2), 'utf8');
+}
+
+export function saveGeneratedMissions({ projectRoot, targetDir, missions, dryRun = false }) {
+    const existingIdentities = loadExistingMissionIdentities(targetDir);
+    const created = [];
+    const skipped = [];
+
+    if (!dryRun) ensureDir(targetDir);
+
+    for (const mission of missions) {
+        assertGeneratedMissionSchema(mission);
+        const identity = buildMissionIdentity(mission);
+        if (!identity || existingIdentities.has(identity)) {
+            skipped.push({
+                name: mission.name,
+                page_path: mission.page_path,
+                reason: 'duplicate'
+            });
+            continue;
+        }
+
+        const collectionRel = String(mission.collection || 'generated/general').replace(/^\/+/, '');
+        const targetCollectionDir = path.join(targetDir, collectionRel);
+        const fileName = `${sanitizeName(mission.name)}.yaml`;
+        const filePath = path.join(targetCollectionDir, fileName);
+
+        if (!dryRun) {
+            ensureDir(targetCollectionDir);
+            fs.writeFileSync(filePath, dump(mission, { lineWidth: 120, noRefs: true }), 'utf8');
+        }
+
+        existingIdentities.add(identity);
+        created.push({
+            name: mission.name,
+            page_path: mission.page_path,
+            filePath: toPosix(path.relative(projectRoot, filePath))
+        });
+    }
+
+    const summary = {
+        generated_at: new Date().toISOString(),
+        target_dir: toPosix(path.relative(projectRoot, targetDir) || '.'),
+        total_requested: missions.length,
+        created_count: created.length,
+        skipped_count: skipped.length,
+        created,
+        skipped
+    };
+
+    if (!dryRun) {
+        writeCache(projectRoot, summary);
+    }
+
+    return summary;
+}