@backendkit-labs/agent-core 0.14.0

package/dist/reflection/historical-loader.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @description HistoricalLoader — Carga archivos historicos de auditoria (NO-GO)
+ * y los convierte en FailureRecord para alimentar el Reflection Engine.
+ *
+ * Escanea ~/.deepseek-code/projects/{hash}/audits/ en busca de archivos .md
+ * con veredicto NO-GO o NO-GO condicional, extrae los hallazgos de la tabla
+ * Markdown y los persiste en failures.json, luego dispara reflect() para
+ * que PatternDetector detecte patrones y PolicyPromoter genere policyRules.
+ *
+ * @example
+ * ```ts
+ * const loader = new HistoricalLoader({ engine });
+ * const result = await loader.loadAll();
+ * console.log(`Cargados ${result.loaded} registros, ${result.patterns} patrones detectados`);
+ * ```
+ */
+import { ReflectionEngine } from './reflection-engine';
+export interface HistoricalLoadResult {
+    /** Total de archivos escaneados */
+    scannedFiles: number;
+    /** Archivos con veredicto NO-GO/NO-GO condicional */
+    noGoFiles: number;
+    /** Registros de fallo cargados al catalogo */
+    loaded: number;
+    /** Registros omitidos por duplicado */
+    skipped: number;
+    /** Patrones detectados tras la carga */
+    patterns: number;
+    /** Reglas promovidas tras la carga */
+    promotedRules: number;
+    /** Errores encontrados durante el proceso */
+    errors: string[];
+    /** Proyectos donde se encontro y proceso */
+    projectsProcessed: string[];
+}
+export declare class HistoricalLoader {
+    private engine;
+    private projectRoot;
+    private appName;
+    constructor(options: {
+        engine: ReflectionEngine;
+        projectRoot?: string;
+        appName?: string;
+    });
+    /**
+     * @description Escanea y carga todos los proyectos con directorios audits/.
+     * Si no se especifica projectRoot, escanea todos los proyectos en
+     * ~/.deepseek-code/projects/.
+     */
+    loadAll(options?: {
+        /** Escanear solo el proyecto actual (default: true) */
+        onlyCurrentProject?: boolean;
+        /** Forzar recarga aunque los registros ya existan */
+        force?: boolean;
+    }): Promise<HistoricalLoadResult>;
+    /**
+     * @description Carga un proyecto especifico por su directorio de auditorias.
+     */
+    loadProject(auditsDir: string, force?: boolean): Promise<HistoricalLoadResult>;
+    /**
+     * @description Parsea un archivo de gate Markdown y extrae metadatos + hallazgos.
+     */
+    private parseGateFile;
+    /**
+     * @description Parsea la tabla de hallazgos en formato Markdown.
+     * Formato esperado:
+     * | ID | Dimension | Hallazgo | Severidad | Evidencia | Recomendacion | Agente responsable |
+     */
+    private parseFindingsTable;
+    /**
+     * @description Parsea una fila de la tabla Markdown.
+     * Maneja el encoding corrupto (caracteres corruptos) limpiando el texto.
+     */
+    private parseTableRow;
+    /**
+     * @description Limpia caracteres corruptos del encoding.
+     */
+    private cleanText;
+    /**
+     * @description Mapea texto de severidad a enum.
+     */
+    private mapSeverity;
+    /**
+     * @description Determina si un archivo es GO sin hallazgos (para saltarlo).
+     */
+    private isGoWithoutFindings;
+    /**
+     * @description Infiere el dominio Reflection a partir del gate y contexto.
+     */
+    private inferDomain;
+    /**
+     * @description Infiere el failureType a partir del hallazgo y dominio.
+     * Usa palabras clave en el texto del hallazgo.
+     */
+    private inferFailureType;
+    /**
+     * @description Resuelve el directorio de auditorias para un proyecto.
+     */
+    private resolveProjectAuditsDir;
+    /**
+     * @description Encuentra todos los directorios audits/ en projects/.
+     */
+    private findAllProjectAuditsDirs;
+}
+//# sourceMappingURL=historical-loader.d.ts.map

package/dist/reflection/historical-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"historical-loader.d.ts","sourceRoot":"","sources":["../../src/reflection/historical-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAmBvD,MAAM,WAAW,oBAAoB;IACnC,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,4CAA4C;IAC5C,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAyBD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE;QAAE,MAAM,EAAE,gBAAgB,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAMzF;;;;OAIG;IACG,OAAO,CAAC,OAAO,CAAC,EAAE;QACtB,uDAAuD;QACvD,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,qDAAqD;QACrD,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAuCjC;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAoHpF;;OAEG;IACH,OAAO,CAAC,aAAa;IA8BrB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAqC1B;;;OAGG;IACH,OAAO,CAAC,aAAa;IA8BrB;;OAEG;IACH,OAAO,CAAC,SAAS;IAQjB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAcnB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAiDxB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAM/B;;OAEG;YACW,wBAAwB;CAyBvC"}

package/dist/reflection/historical-loader.js

@@ -0,0 +1,462 @@
+"use strict";
+/**
+ * @description HistoricalLoader — Carga archivos historicos de auditoria (NO-GO)
+ * y los convierte en FailureRecord para alimentar el Reflection Engine.
+ *
+ * Escanea ~/.deepseek-code/projects/{hash}/audits/ en busca de archivos .md
+ * con veredicto NO-GO o NO-GO condicional, extrae los hallazgos de la tabla
+ * Markdown y los persiste en failures.json, luego dispara reflect() para
+ * que PatternDetector detecte patrones y PolicyPromoter genere policyRules.
+ *
+ * @example
+ * ```ts
+ * const loader = new HistoricalLoader({ engine });
+ * const result = await loader.loadAll();
+ * console.log(`Cargados ${result.loaded} registros, ${result.patterns} patrones detectados`);
+ * ```
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HistoricalLoader = void 0;
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const fs = __importStar(require("fs/promises"));
+const types_1 = require("./types");
+const project_key_1 = require("../shared/utils/project-key");
+// ── Constantes ───────────────────────────────────────────────────────────────
+const TABLE_ROW_PATTERN = /^\|\s*([\w-]+)\s*\|\s*(.+?)\s*\|\s*(.+?)\s*\|\s*\*\*(.+?)\*\*\s*\|\s*(.*?)\s*\|\s*(.+?)\s*\|\s*(.+?)\s*\|$/;
+const SEVERITY_MAP = {
+    'critical': 'critical', 'critica': 'critical', 'Critica': 'critical', 'Crítica': 'critical',
+    'high': 'high', 'alta': 'high', 'Alta': 'high',
+    'medium': 'medium', 'media': 'medium', 'Media': 'medium',
+    'low': 'low', 'baja': 'low', 'Baja': 'low',
+};
+const SEVERITY_TO_RECORD = SEVERITY_MAP;
+// ── HistoricalLoader ─────────────────────────────────────────────────────────
+class HistoricalLoader {
+    engine;
+    projectRoot;
+    appName;
+    constructor(options) {
+        this.engine = options.engine;
+        this.projectRoot = options.projectRoot ?? process.cwd();
+        this.appName = options.appName ?? 'bk-agent';
+    }
+    /**
+     * @description Escanea y carga todos los proyectos con directorios audits/.
+     * Si no se especifica projectRoot, escanea todos los proyectos en
+     * ~/.deepseek-code/projects/.
+     */
+    async loadAll(options) {
+        const result = {
+            scannedFiles: 0,
+            noGoFiles: 0,
+            loaded: 0,
+            skipped: 0,
+            patterns: 0,
+            promotedRules: 0,
+            errors: [],
+            projectsProcessed: [],
+        };
+        const projects = options?.onlyCurrentProject !== false
+            ? [this.resolveProjectAuditsDir(this.projectRoot)]
+            : await this.findAllProjectAuditsDirs();
+        for (const auditsDir of projects) {
+            if (!auditsDir)
+                continue;
+            const projectKey = path.basename(path.dirname(auditsDir));
+            result.projectsProcessed.push(projectKey);
+            try {
+                const projectResult = await this.loadProject(auditsDir, options?.force);
+                result.scannedFiles += projectResult.scannedFiles;
+                result.noGoFiles += projectResult.noGoFiles;
+                result.loaded += projectResult.loaded;
+                result.skipped += projectResult.skipped;
+                result.patterns += projectResult.patterns;
+                result.promotedRules += projectResult.promotedRules;
+                result.errors.push(...projectResult.errors);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                result.errors.push(`[${projectKey}] Error: ${msg}`);
+            }
+        }
+        return result;
+    }
+    /**
+     * @description Carga un proyecto especifico por su directorio de auditorias.
+     */
+    async loadProject(auditsDir, force) {
+        const result = {
+            scannedFiles: 0,
+            noGoFiles: 0,
+            loaded: 0,
+            skipped: 0,
+            patterns: 0,
+            promotedRules: 0,
+            errors: [],
+            projectsProcessed: [],
+        };
+        // Verificar que el directorio existe
+        try {
+            await fs.access(auditsDir);
+        }
+        catch {
+            result.errors.push(`Directorio no encontrado: ${auditsDir}`);
+            return result;
+        }
+        // Listar archivos .md (excluir auto-gates, pending-issues, lecciones)
+        const files = await fs.readdir(auditsDir);
+        const mdFiles = files.filter(f => f.endsWith('.md') &&
+            !f.startsWith('auto-gates') &&
+            !f.startsWith('pending-issues') &&
+            f !== 'lecciones-aprendidas.md');
+        result.scannedFiles = mdFiles.length;
+        // Cargar registros existentes para evitar duplicados
+        const catalog = this.engine.getCatalog();
+        await catalog.ensureLoaded();
+        const existingRecords = await catalog.getAllRecords();
+        const existingFingerprints = new Set(existingRecords.map(r => `${r.domain}:${r.failureType}:${r.hallazgo.slice(0, 80)}`));
+        // Procesar cada archivo
+        const newRecords = [];
+        for (const file of mdFiles) {
+            const filePath = path.join(auditsDir, file);
+            try {
+                const content = await fs.readFile(filePath, 'utf-8');
+                // Saltar archivos GO sin hallazgos
+                if (this.isGoWithoutFindings(content))
+                    continue;
+                result.noGoFiles++;
+                const parsed = this.parseGateFile(content, file);
+                if (!parsed)
+                    continue;
+                // Extraer dominio del contexto de la tarea o del gate
+                const domain = this.inferDomain(parsed);
+                for (const finding of parsed.hallazgos) {
+                    // Inferir failureType del hallazgo
+                    const failureType = this.inferFailureType(finding, domain);
+                    // Crear fingerprint para evitar duplicados
+                    const fingerprint = `${domain}:${failureType}:${finding.hallazgo.slice(0, 80)}`;
+                    if (!force && existingFingerprints.has(fingerprint)) {
+                        result.skipped++;
+                        continue;
+                    }
+                    const record = {
+                        id: (0, types_1.generateFailureId)(),
+                        domain,
+                        failureType,
+                        severity: (SEVERITY_TO_RECORD[finding.severidad] ?? 'medium'),
+                        dimension: finding.dimension,
+                        gate: parsed.gate,
+                        agenteResponsable: finding.agenteResponsable,
+                        hallazgo: finding.hallazgo,
+                        recomendacion: finding.recomendacion,
+                        archivos: [],
+                        fecha: parsed.fecha,
+                    };
+                    newRecords.push(record);
+                    existingFingerprints.add(fingerprint);
+                }
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                result.errors.push(`Error procesando ${file}: ${msg}`);
+            }
+        }
+        // Persistir registros nuevos
+        if (newRecords.length > 0) {
+            await catalog.addRecords(newRecords);
+            result.loaded = newRecords.length;
+        }
+        // Disparar reflexion para detectar patrones y promover reglas
+        if (newRecords.length > 0) {
+            try {
+                const reflectResult = await this.engine.reflect({ autoPromote: true });
+                result.patterns = reflectResult.patterns.length;
+                result.promotedRules = reflectResult.promotedRules.length;
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                result.errors.push(`Error en reflexion: ${msg}`);
+            }
+        }
+        return result;
+    }
+    // ── Parseo de archivos ─────────────────────────────────────────────────────
+    /**
+     * @description Parsea un archivo de gate Markdown y extrae metadatos + hallazgos.
+     */
+    parseGateFile(content, filename) {
+        // Extraer veredicto del frontmatter YAML
+        const veredictoMatch = content.match(/veredicto:\s*"(.+?)"/);
+        const veredicto = veredictoMatch?.[1] ?? '';
+        // Solo procesar NO-GO y NO-GO condicional
+        if (veredicto !== 'NO-GO' && veredicto !== 'NO-GO condicional')
+            return null;
+        // Extraer gate del frontmatter
+        const gateMatch = content.match(/title:\s*"Informe de Gate:\s*(.+?)"/);
+        const gate = gateMatch?.[1]?.toLowerCase() ?? 'unknown';
+        // Extraer agente del frontmatter
+        const agenteMatch = content.match(/auditor:\s*"(.+?)"/);
+        const agente = agenteMatch?.[1] ?? 'unknown';
+        // Extraer fecha del frontmatter
+        const fechaMatch = content.match(/fecha:\s*"(.+?)"/);
+        const fecha = fechaMatch?.[1] ?? new Date().toISOString();
+        // Extraer dominio del contexto de la tarea
+        const dominioMatch = content.match(/Domino\(s\):\s*(.+?)(?:\n|$)/);
+        const dominio = dominioMatch?.[1]?.trim() ?? '';
+        // Extraer hallazgos de la tabla Markdown
+        const hallazgos = this.parseFindingsTable(content);
+        return { gate, agente, veredicto, fecha, hallazgos, dominio };
+    }
+    /**
+     * @description Parsea la tabla de hallazgos en formato Markdown.
+     * Formato esperado:
+     * | ID | Dimension | Hallazgo | Severidad | Evidencia | Recomendacion | Agente responsable |
+     */
+    parseFindingsTable(content) {
+        const findings = [];
+        const lines = content.split('\n');
+        let inTable = false;
+        let headerPassed = false;
+        for (const line of lines) {
+            const trimmed = line.trim();
+            // Detectar inicio de tabla
+            if (trimmed.startsWith('| ID |')) {
+                inTable = true;
+                continue;
+            }
+            // Saltar separador |---|----|
+            if (inTable && trimmed.startsWith('|---')) {
+                headerPassed = true;
+                continue;
+            }
+            // Salir de la tabla al encontrar linea no-tabla
+            if (inTable && headerPassed && (!trimmed.startsWith('|') || trimmed.startsWith('| ---'))) {
+                break;
+            }
+            if (inTable && headerPassed && trimmed.startsWith('|')) {
+                const finding = this.parseTableRow(trimmed);
+                if (finding) {
+                    findings.push(finding);
+                }
+            }
+        }
+        return findings;
+    }
+    /**
+     * @description Parsea una fila de la tabla Markdown.
+     * Maneja el encoding corrupto (caracteres corruptos) limpiando el texto.
+     */
+    parseTableRow(row) {
+        // Dividir por | respetando pipes escapados
+        const parts = row.split('|').map(p => p.trim()).filter(p => p.length > 0);
+        if (parts.length < 7)
+            return null;
+        const id = this.cleanText(parts[0]);
+        const dimension = this.cleanText(parts[1]);
+        const hallazgo = this.cleanText(parts[2]);
+        const severidadRaw = this.cleanText(parts[3]).replace(/\*\*/g, '');
+        const evidencia = this.cleanText(parts[4]);
+        const recomendacion = this.cleanText(parts[5]);
+        const agenteResponsable = this.cleanText(parts[6]);
+        // Mapear severidad
+        const severidad = this.mapSeverity(severidadRaw);
+        return {
+            id,
+            dimension,
+            hallazgo,
+            severidad,
+            evidencia,
+            recomendacion,
+            agenteResponsable,
+        };
+    }
+    // ── Helpers ────────────────────────────────────────────────────────────────
+    /**
+     * @description Limpia caracteres corruptos del encoding.
+     */
+    cleanText(text) {
+        return text
+            .replace(/\uFFFD/g, '') // Quitar caracter de reemplazo Unicode
+            .replace(/[^\x20-\x7E\s]/g, '') // Quitar no-ASCII imprimible
+            .replace(/\s+/g, ' ') // Normalizar espacios
+            .trim();
+    }
+    /**
+     * @description Mapea texto de severidad a enum.
+     */
+    mapSeverity(raw) {
+        return SEVERITY_MAP[raw] ?? SEVERITY_MAP[raw.toLowerCase()] ?? 'medium';
+    }
+    /**
+     * @description Determina si un archivo es GO sin hallazgos (para saltarlo).
+     */
+    isGoWithoutFindings(content) {
+        const hasNoGo = content.includes('NO-GO');
+        const hasFindings = content.includes('| ID |');
+        return !hasNoGo && !hasFindings;
+    }
+    /**
+     * @description Infiere el dominio Reflection a partir del gate y contexto.
+     */
+    inferDomain(parsed) {
+        const gate = parsed.gate.toLowerCase();
+        const dominio = parsed.dominio.toLowerCase();
+        if (gate.includes('qa') || gate.includes('test'))
+            return 'test';
+        if (gate.includes('security'))
+            return 'audit';
+        if (gate.includes('architecture'))
+            return 'audit';
+        if (gate.includes('orquest'))
+            return 'agent';
+        if (dominio.includes('bootstrap') || dominio.includes('config'))
+            return 'bootstrap';
+        if (dominio.includes('commit'))
+            return 'commit';
+        return 'audit';
+    }
+    /**
+     * @description Infiere el failureType a partir del hallazgo y dominio.
+     * Usa palabras clave en el texto del hallazgo.
+     */
+    inferFailureType(finding, domain) {
+        const text = `${finding.hallazgo} ${finding.dimension} ${finding.evidencia}`.toLowerCase();
+        // Patrones por dominio
+        if (domain === 'audit') {
+            if (text.includes('security') || text.includes('vulnerabilidad') || text.includes('owasp'))
+                return 'security_vulnerability';
+            if (text.includes('test') || text.includes('cobertura') || text.includes('coverage'))
+                return 'missing_test_coverage';
+            if (text.includes('error') || text.includes('exception') || text.includes('catch'))
+                return 'incomplete_error_handling';
+            if (text.includes('documentacion') || text.includes('documentation') || text.includes('doc'))
+                return 'missing_documentation';
+            if (text.includes('arquitectura') || text.includes('architecture') || text.includes('diseno'))
+                return 'architecture_violation';
+            if (text.includes('log') || text.includes('logging'))
+                return 'missing_logging';
+            if (text.includes('validacion') || text.includes('validation') || text.includes('input'))
+                return 'unvalidated_input';
+            if (text.includes('secret') || text.includes('password') || text.includes('api_key'))
+                return 'hardcoded_secret';
+            if (text.includes('rollback') || text.includes('migracion'))
+                return 'missing_rollback';
+            if (text.includes('conexion') || text.includes('connection') || text.includes('pool'))
+                return 'connection_leak';
+        }
+        if (domain === 'test') {
+            if (text.includes('timeout') || text.includes('tiempo'))
+                return 'jest_timeout';
+            if (text.includes('cobertura') || text.includes('coverage') || text.includes('threshold'))
+                return 'coverage_below_threshold';
+            if (text.includes('flaky') || text.includes('intermitente'))
+                return 'flaky_test';
+            if (text.includes('assert') || text.includes('assertion'))
+                return 'test_without_assertion';
+            if (text.includes('integration') || text.includes('integracion'))
+                return 'integration_test_without_container';
+            if (text.includes('type') || text.includes('tsc') || text.includes('tipado'))
+                return 'tsc_noEmit_type_error';
+        }
+        if (domain === 'agent') {
+            if (text.includes('seleccion') || text.includes('wrong') || text.includes('incorrecto'))
+                return 'wrong_agent_selected';
+            if (text.includes('timeout') || text.includes('tiempo'))
+                return 'agent_timeout';
+            if (text.includes('alucinacion') || text.includes('hallucination'))
+                return 'agent_hallucination';
+            if (text.includes('delegacion') || text.includes('delegation'))
+                return 'delegation_failed';
+            if (text.includes('rechaz') || text.includes('rejected') || text.includes('evaluator'))
+                return 'response_rejected_by_evaluator';
+        }
+        if (domain === 'bootstrap') {
+            if (text.includes('config') || text.includes('yaml') || text.includes('manifest'))
+                return 'manifest_corrupt';
+            if (text.includes('memoria') || text.includes('memory') || text.includes('load'))
+                return 'memory_load_failure';
+            if (text.includes('seed') || text.includes('configuracion'))
+                return 'seed_config_failed';
+        }
+        if (domain === 'commit') {
+            if (text.includes('type') || text.includes('tipo'))
+                return 'missing_type';
+            if (text.includes('scope') || text.includes('ambito'))
+                return 'wrong_scope';
+            if (text.includes('branch') || text.includes('rama'))
+                return 'branch_naming_invalid';
+        }
+        return 'unknown_failure';
+    }
+    /**
+     * @description Resuelve el directorio de auditorias para un proyecto.
+     */
+    resolveProjectAuditsDir(projectRoot) {
+        const home = process.env.USERPROFILE ?? process.env.HOME ?? os.homedir();
+        const projectKey = (0, project_key_1.cwdToProjectKey)(projectRoot);
+        return path.join(home, `.${this.appName}`, 'projects', projectKey, 'audits');
+    }
+    /**
+     * @description Encuentra todos los directorios audits/ en projects/.
+     */
+    async findAllProjectAuditsDirs() {
+        const home = process.env.USERPROFILE ?? process.env.HOME ?? os.homedir();
+        const projectsDir = path.join(home, `.${this.appName}`, 'projects');
+        try {
+            const entries = await fs.readdir(projectsDir, { withFileTypes: true });
+            const dirs = [];
+            for (const entry of entries) {
+                if (entry.isDirectory()) {
+                    const auditsDir = path.join(projectsDir, entry.name, 'audits');
+                    try {
+                        await fs.access(auditsDir);
+                        dirs.push(auditsDir);
+                    }
+                    catch {
+                        // No tiene audits/
+                    }
+                }
+            }
+            return dirs;
+        }
+        catch {
+            return [];
+        }
+    }
+}
+exports.HistoricalLoader = HistoricalLoader;
+//# sourceMappingURL=historical-loader.js.map

package/dist/reflection/historical-loader.js.map

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

package/dist/reflection/hooks/agent-hook.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @description AgentHook — Puente entre el evaluator de agentes y el ReflectionEngine.
+ *
+ * Captura incidentes de comportamiento de agentes (selección incorrecta,
+ * alucinaciones, timeouts, herramientas fallidas) y los reporta
+ * al ReflectionEngine para detección de patrones.
+ *
+ * Se integra en el ResponseEvaluator (evaluator.ts) y en el Agent Loop (loop.ts).
+ *
+ * @example
+ * ```ts
+ * const hook = new AgentHook(engine);
+ * await hook.reportAgentFailure('wrong_agent_selected', 'Se seleccionó agente general para tarea de seguridad');
+ * ```
+ */
+import { ReflectionEngine } from '../reflection-engine';
+import { FailureRecord, ReflectionDomain, FailureType } from '../types';
+export declare class AgentHook {
+    private engine;
+    constructor(engine: ReflectionEngine);
+    /**
+     * @description Reporta un incidente de comportamiento de agente.
+     *
+     * @param failureType - Tipo de fallo (opcional, se auto-detecta)
+     * @param hallazgo - Descripción del incidente
+     * @param agenteResponsable - Nombre del agente involucrado
+     * @param archivos - Archivos relacionados
+     * @param domain - Dominio del Reflection Engine (default: "agent")
+     * @returns El FailureRecord creado y los patrones detectados
+     */
+    reportAgentFailure(hallazgo: string, agenteResponsable: string, archivos?: string[], failureType?: FailureType, domain?: ReflectionDomain): Promise<{
+        record: FailureRecord;
+        patterns: import('../types').DetectedPattern[];
+    }>;
+    /**
+     * @description Reporta una alucinación detectada por el evaluator.
+     */
+    reportHallucination(agente: string, respuestaOriginal: string, detalle: string): Promise<{
+        record: FailureRecord;
+        patterns: import('../types').DetectedPattern[];
+    }>;
+    /**
+     * @description Reporta un timeout de agente.
+     */
+    reportTimeout(agente: string, taskDescription: string): Promise<{
+        record: FailureRecord;
+        patterns: import('../types').DetectedPattern[];
+    }>;
+    /**
+     * @description Reporta una selección incorrecta de agente.
+     */
+    reportWrongAgentSelection(agenteSeleccionado: string, dominioRequerido: string): Promise<{
+        record: FailureRecord;
+        patterns: import('../types').DetectedPattern[];
+    }>;
+    /**
+     * @description Ejecuta una reflexión completa del dominio agent.
+     */
+    reflectAgentDomain(): Promise<{
+        patterns: import('../types').DetectedPattern[];
+        promotedRules: import('../types').ManifestPolicyRule[];
+    }>;
+    /**
+     * @description Obtiene estadísticas de incidentes del dominio agent.
+     */
+    getAgentStats(): Promise<{
+        totalIncidents: number;
+        unresolvedCount: number;
+        patternsByFailureType: Record<string, number>;
+    }>;
+}
+//# sourceMappingURL=agent-hook.d.ts.map