@backendkit-labs/agent-core 0.14.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-hook.d.ts","sourceRoot":"","sources":["../../../src/reflection/hooks/agent-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAKxE,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAmB;gBAErB,MAAM,EAAE,gBAAgB;IAIpC;;;;;;;;;OASG;IACG,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,EACzB,QAAQ,GAAE,MAAM,EAAO,EACvB,WAAW,CAAC,EAAE,WAAW,EACzB,MAAM,GAAE,gBAA0B,GACjC,OAAO,CAAC;QACT,MAAM,EAAE,aAAa,CAAC;QACtB,QAAQ,EAAE,OAAO,UAAU,EAAE,eAAe,EAAE,CAAC;KAChD,CAAC;IAqBF;;OAEG;IACG,mBAAmB,CACvB,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,EACzB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QACT,MAAM,EAAE,aAAa,CAAC;QACtB,QAAQ,EAAE,OAAO,UAAU,EAAE,eAAe,EAAE,CAAC;KAChD,CAAC;IASF;;OAEG;IACG,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC;QACT,MAAM,EAAE,aAAa,CAAC;QACtB,QAAQ,EAAE,OAAO,UAAU,EAAE,eAAe,EAAE,CAAC;KAChD,CAAC;IASF;;OAEG;IACG,yBAAyB,CAC7B,kBAAkB,EAAE,MAAM,EAC1B,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC;QACT,MAAM,EAAE,aAAa,CAAC;QACtB,QAAQ,EAAE,OAAO,UAAU,EAAE,eAAe,EAAE,CAAC;KAChD,CAAC;IASF;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC;QAClC,QAAQ,EAAE,OAAO,UAAU,EAAE,eAAe,EAAE,CAAC;QAC/C,aAAa,EAAE,OAAO,UAAU,EAAE,kBAAkB,EAAE,CAAC;KACxD,CAAC;IAIF;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC;QAC7B,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC/C,CAAC;CAiBH"}

package/dist/reflection/hooks/agent-hook.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * @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');
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentHook = void 0;
+const agent_domain_1 = require("../domains/agent-domain");
+// ── AgentHook ────────────────────────────────────────────────────────────────
+class AgentHook {
+    engine;
+    constructor(engine) {
+        this.engine = engine;
+    }
+    /**
+     * @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
+     */
+    async reportAgentFailure(hallazgo, agenteResponsable, archivos = [], failureType, domain = 'agent') {
+        const detectedType = failureType ?? (0, agent_domain_1.detectAgentFailureType)(hallazgo);
+        const meta = (0, agent_domain_1.getAgentFailureTypeMeta)(detectedType);
+        const record = {
+            domain,
+            failureType: detectedType,
+            severity: meta?.severity ?? 'medium',
+            dimension: meta?.dimension ?? 'confiabilidad',
+            gate: 'agent-loop',
+            agenteResponsable,
+            hallazgo,
+            recomendacion: meta?.genericRecommendation ?? 'Revisar el comportamiento del agente y ajustar el contexto o perfil',
+            archivos,
+            fecha: new Date().toISOString(),
+        };
+        const result = await this.engine.reportIncident(record);
+        return result;
+    }
+    /**
+     * @description Reporta una alucinación detectada por el evaluator.
+     */
+    async reportHallucination(agente, respuestaOriginal, detalle) {
+        return this.reportAgentFailure(`agent_hallucination (${agente}): ${detalle} — Respuesta: "${respuestaOriginal.substring(0, 200)}..."`, agente, [], 'agent_hallucination');
+    }
+    /**
+     * @description Reporta un timeout de agente.
+     */
+    async reportTimeout(agente, taskDescription) {
+        return this.reportAgentFailure(`agent_timeout: "${agente}" excedió el tiempo límite procesando: "${taskDescription}"`, agente, [], 'agent_timeout');
+    }
+    /**
+     * @description Reporta una selección incorrecta de agente.
+     */
+    async reportWrongAgentSelection(agenteSeleccionado, dominioRequerido) {
+        return this.reportAgentFailure(`wrong_agent_selected: Se seleccionó "${agenteSeleccionado}" para dominio "${dominioRequerido}"`, agenteSeleccionado, [], 'wrong_agent_selected');
+    }
+    /**
+     * @description Ejecuta una reflexión completa del dominio agent.
+     */
+    async reflectAgentDomain() {
+        return this.engine.reflect({ domain: 'agent', autoPromote: true });
+    }
+    /**
+     * @description Obtiene estadísticas de incidentes del dominio agent.
+     */
+    async getAgentStats() {
+        const stats = await this.engine.getStats();
+        const catalog = this.engine.getCatalog();
+        const agentRecords = await catalog.findByDomain('agent');
+        const unresolved = await catalog.findUnresolved();
+        const patternsByFailureType = {};
+        for (const record of agentRecords) {
+            patternsByFailureType[record.failureType] = (patternsByFailureType[record.failureType] ?? 0) + 1;
+        }
+        return {
+            totalIncidents: stats.totalIncidents,
+            unresolvedCount: unresolved.length,
+            patternsByFailureType,
+        };
+    }
+}
+exports.AgentHook = AgentHook;
+//# sourceMappingURL=agent-hook.js.map

package/dist/reflection/hooks/agent-hook.js.map

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

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

@@ -0,0 +1,72 @@
+/**
+ * @description AuditHook — Puente entre AuditReporter y ReflectionEngine.
+ *
+ * Este hook se encarga de transformar los hallazgos de auditoría (AuditFinding)
+ * en FailureRecord y reportarlos al ReflectionEngine para su análisis.
+ *
+ * Se integra en el método completeSprint() del AuditReporter, donde se
+ * dispara la reflexión automática al finalizar cada sprint de auditoría.
+ *
+ * @example
+ * ```ts
+ * const hook = new AuditHook(engine);
+ * await hook.reportFinding(finding, gateName, agente);
+ * ```
+ */
+import { ReflectionEngine } from '../reflection-engine';
+import type { AuditFinding } from '../types';
+import { FailureRecord, ReflectionDomain } from '../types';
+export declare class AuditHook {
+    private engine;
+    private onHighSeverityFinding?;
+    constructor(engine: ReflectionEngine, options?: {
+        onHighSeverityFinding?: (projectDir: string, issue: string) => Promise<void>;
+    });
+    /**
+     * @description Reporta un hallazgo de auditoría al Reflection Engine.
+     * Convierte un AuditFinding en FailureRecord, detecta el failureType
+     * automáticamente según el contenido del hallazgo, y lo registra
+     * en el catálogo de fallos. Si se detecta un patrón (≥3 ocurrencias),
+     * se promueve automáticamente a policyRule.
+     *
+     * @param finding - Hallazgo de auditoría (AuditFinding)
+     * @param gateName - Nombre del gate que generó el hallazgo (ej: "security", "qa")
+     * @param domain - Dominio del Reflection Engine (default: "audit")
+     * @returns El FailureRecord creado y los patrones detectados
+     */
+    reportFinding(finding: AuditFinding, gateName: string, domain?: ReflectionDomain): Promise<{
+        record: FailureRecord;
+        patterns: import('../types').DetectedPattern[];
+    }>;
+    /**
+     * @description Reporta múltiples hallazgos de auditoría en lote.
+     * Útil cuando un gate produce varios hallazgos en una misma ejecución.
+     *
+     * @param findings - Lista de hallazgos de auditoría
+     * @param gateName - Nombre del gate que generó los hallazgos
+     * @param domain - Dominio del Reflection Engine (default: "audit")
+     * @returns Lista de resultados (FailureRecord + patrones detectados)
+     */
+    reportFindings(findings: AuditFinding[], gateName: string, domain?: ReflectionDomain): Promise<Array<{
+        record: FailureRecord;
+        patterns: import('../types').DetectedPattern[];
+    }>>;
+    /**
+     * @description Ejecuta una reflexión completa del dominio audit.
+     * Escanea todos los hallazgos registrados y promueve patrones.
+     * Útil para llamar al finalizar un ciclo de auditoría.
+     */
+    reflectAuditDomain(): Promise<{
+        patterns: import('../types').DetectedPattern[];
+        promotedRules: import('../types').ManifestPolicyRule[];
+    }>;
+    /**
+     * @description Obtiene estadísticas de incidentes del dominio audit.
+     */
+    getAuditStats(): Promise<{
+        totalIncidents: number;
+        unresolvedCount: number;
+        patternsByFailureType: Record<string, number>;
+    }>;
+}
+//# sourceMappingURL=audit-hook.d.ts.map

package/dist/reflection/hooks/audit-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-hook.d.ts","sourceRoot":"","sources":["../../../src/reflection/hooks/audit-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAM3D,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,qBAAqB,CAAC,CAAuD;gBAGnF,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE;QACR,qBAAqB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAC9E;IAMH;;;;;;;;;;;OAWG;IACG,aAAa,CACjB,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,gBAA0B,GACjC,OAAO,CAAC;QACT,MAAM,EAAE,aAAa,CAAC;QACtB,QAAQ,EAAE,OAAO,UAAU,EAAE,eAAe,EAAE,CAAC;KAChD,CAAC;IA+BF;;;;;;;;OAQG;IACG,cAAc,CAClB,QAAQ,EAAE,YAAY,EAAE,EACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,gBAA0B,GACjC,OAAO,CAAC,KAAK,CAAC;QACf,MAAM,EAAE,aAAa,CAAC;QACtB,QAAQ,EAAE,OAAO,UAAU,EAAE,eAAe,EAAE,CAAC;KAChD,CAAC,CAAC;IAcH;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC;QAClC,QAAQ,EAAE,OAAO,UAAU,EAAE,eAAe,EAAE,CAAC;QAC/C,aAAa,EAAE,OAAO,UAAU,EAAE,kBAAkB,EAAE,CAAC;KACxD,CAAC;IAIF;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC;QAC7B,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC/C,CAAC;CAkBH"}

package/dist/reflection/hooks/audit-hook.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * @description AuditHook — Puente entre AuditReporter y ReflectionEngine.
+ *
+ * Este hook se encarga de transformar los hallazgos de auditoría (AuditFinding)
+ * en FailureRecord y reportarlos al ReflectionEngine para su análisis.
+ *
+ * Se integra en el método completeSprint() del AuditReporter, donde se
+ * dispara la reflexión automática al finalizar cada sprint de auditoría.
+ *
+ * @example
+ * ```ts
+ * const hook = new AuditHook(engine);
+ * await hook.reportFinding(finding, gateName, agente);
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditHook = void 0;
+const audit_domain_1 = require("../domains/audit-domain");
+// ── AuditHook ────────────────────────────────────────────────────────────────
+class AuditHook {
+    engine;
+    onHighSeverityFinding;
+    constructor(engine, options) {
+        this.engine = engine;
+        this.onHighSeverityFinding = options?.onHighSeverityFinding;
+    }
+    /**
+     * @description Reporta un hallazgo de auditoría al Reflection Engine.
+     * Convierte un AuditFinding en FailureRecord, detecta el failureType
+     * automáticamente según el contenido del hallazgo, y lo registra
+     * en el catálogo de fallos. Si se detecta un patrón (≥3 ocurrencias),
+     * se promueve automáticamente a policyRule.
+     *
+     * @param finding - Hallazgo de auditoría (AuditFinding)
+     * @param gateName - Nombre del gate que generó el hallazgo (ej: "security", "qa")
+     * @param domain - Dominio del Reflection Engine (default: "audit")
+     * @returns El FailureRecord creado y los patrones detectados
+     */
+    async reportFinding(finding, gateName, domain = 'audit') {
+        // Detectar failureType automáticamente desde el texto del hallazgo
+        const failureType = (0, audit_domain_1.detectAuditFailureType)(finding.hallazgo);
+        const meta = (0, audit_domain_1.getAuditFailureTypeMeta)(failureType);
+        // Construir el FailureRecord a partir del AuditFinding
+        const record = {
+            domain,
+            failureType,
+            severity: finding.severidad,
+            dimension: finding.dimension,
+            gate: gateName,
+            agenteResponsable: finding.agenteResponsable,
+            hallazgo: finding.hallazgo,
+            recomendacion: finding.recomendacion ?? meta?.genericRecommendation ?? '',
+            archivos: finding.evidencia ? [finding.evidencia] : [],
+            fecha: finding.resolvedAt ?? new Date().toISOString(),
+        };
+        // Reportar al Reflection Engine (esto detecta patrones automáticamente)
+        const result = await this.engine.reportIncident(record);
+        const projectDir = this.engine.getProjectDir();
+        if (projectDir && (finding.severidad === 'high' || finding.severidad === 'critical') && this.onHighSeverityFinding) {
+            await this.onHighSeverityFinding(projectDir, `[${finding.severidad}] ${finding.hallazgo} (gate: ${gateName})`)
+                .catch(() => { });
+        }
+        return result;
+    }
+    /**
+     * @description Reporta múltiples hallazgos de auditoría en lote.
+     * Útil cuando un gate produce varios hallazgos en una misma ejecución.
+     *
+     * @param findings - Lista de hallazgos de auditoría
+     * @param gateName - Nombre del gate que generó los hallazgos
+     * @param domain - Dominio del Reflection Engine (default: "audit")
+     * @returns Lista de resultados (FailureRecord + patrones detectados)
+     */
+    async reportFindings(findings, gateName, domain = 'audit') {
+        const results = [];
+        for (const finding of findings) {
+            const result = await this.reportFinding(finding, gateName, domain);
+            results.push(result);
+        }
+        return results;
+    }
+    /**
+     * @description Ejecuta una reflexión completa del dominio audit.
+     * Escanea todos los hallazgos registrados y promueve patrones.
+     * Útil para llamar al finalizar un ciclo de auditoría.
+     */
+    async reflectAuditDomain() {
+        return this.engine.reflect({ domain: 'audit', autoPromote: true });
+    }
+    /**
+     * @description Obtiene estadísticas de incidentes del dominio audit.
+     */
+    async getAuditStats() {
+        const stats = await this.engine.getStats();
+        const catalog = this.engine.getCatalog();
+        const unresolved = await catalog.findUnresolved();
+        // Contar por failureType
+        const auditRecords = await catalog.findByDomain('audit');
+        const patternsByFailureType = {};
+        for (const record of auditRecords) {
+            patternsByFailureType[record.failureType] = (patternsByFailureType[record.failureType] ?? 0) + 1;
+        }
+        return {
+            totalIncidents: stats.totalIncidents,
+            unresolvedCount: unresolved.length,
+            patternsByFailureType,
+        };
+    }
+}
+exports.AuditHook = AuditHook;
+//# sourceMappingURL=audit-hook.js.map

package/dist/reflection/hooks/audit-hook.js.map

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

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

@@ -0,0 +1,71 @@
+/**
+ * @description BootstrapHook — Puente entre el proceso de inicialización (bootstrap) y el ReflectionEngine.
+ *
+ * Captura incidentes durante el arranque del sistema (configuración faltante,
+ * manifest corrupto, fallos de carga de memoria) y los reporta al
+ * ReflectionEngine para análisis y promoción a políticas.
+ *
+ * Se integra en bootstrap/index.ts (detector.ts, config-loader.ts, memory-loader.ts).
+ *
+ * @example
+ * ```ts
+ * const hook = new BootstrapHook(engine);
+ * await hook.reportBootstrapFailure('missing_config_yaml', 'No se encontró config.yaml');
+ * ```
+ */
+import { ReflectionEngine } from '../reflection-engine';
+import { FailureRecord, ReflectionDomain, FailureType } from '../types';
+export declare class BootstrapHook {
+    private engine;
+    constructor(engine: ReflectionEngine);
+    /**
+     * @description Reporta un incidente de bootstrap al Reflection Engine.
+     *
+     * @param failureType - Tipo de fallo (opcional, se auto-detecta)
+     * @param hallazgo - Descripción del incidente
+     * @param archivos - Archivos relacionados
+     * @param domain - Dominio del Reflection Engine (default: "bootstrap")
+     * @returns El FailureRecord creado y los patrones detectados
+     */
+    reportBootstrapFailure(hallazgo: string, archivos?: string[], failureType?: FailureType, domain?: ReflectionDomain): Promise<{
+        record: FailureRecord;
+        patterns: import('../types').DetectedPattern[];
+    }>;
+    /**
+     * @description Reporta un manifest.yaml corrupto.
+     */
+    reportManifestCorrupt(parseError: string, manifestPath: string): Promise<{
+        record: FailureRecord;
+        patterns: import('../types').DetectedPattern[];
+    }>;
+    /**
+     * @description Reporta un fallo de carga de archivo de configuración.
+     */
+    reportMissingConfig(configPath: string): Promise<{
+        record: FailureRecord;
+        patterns: import('../types').DetectedPattern[];
+    }>;
+    /**
+     * @description Reporta un fallo de carga de archivo de memoria.
+     */
+    reportMemoryLoadFailure(memoryPath: string, errorDetail: string): Promise<{
+        record: FailureRecord;
+        patterns: import('../types').DetectedPattern[];
+    }>;
+    /**
+     * @description Ejecuta una reflexión completa del dominio bootstrap.
+     */
+    reflectBootstrapDomain(): Promise<{
+        patterns: import('../types').DetectedPattern[];
+        promotedRules: import('../types').ManifestPolicyRule[];
+    }>;
+    /**
+     * @description Obtiene estadísticas de incidentes del dominio bootstrap.
+     */
+    getBootstrapStats(): Promise<{
+        totalIncidents: number;
+        unresolvedCount: number;
+        patternsByFailureType: Record<string, number>;
+    }>;
+}
+//# sourceMappingURL=bootstrap-hook.d.ts.map

package/dist/reflection/hooks/bootstrap-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-hook.d.ts","sourceRoot":"","sources":["../../../src/reflection/hooks/bootstrap-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAKxE,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAmB;gBAErB,MAAM,EAAE,gBAAgB;IAIpC;;;;;;;;OAQG;IACG,sBAAsB,CAC1B,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,MAAM,EAAO,EACvB,WAAW,CAAC,EAAE,WAAW,EACzB,MAAM,GAAE,gBAA8B,GACrC,OAAO,CAAC;QACT,MAAM,EAAE,aAAa,CAAC;QACtB,QAAQ,EAAE,OAAO,UAAU,EAAE,eAAe,EAAE,CAAC;KAChD,CAAC;IAqBF;;OAEG;IACG,qBAAqB,CACzB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;QACT,MAAM,EAAE,aAAa,CAAC;QACtB,QAAQ,EAAE,OAAO,UAAU,EAAE,eAAe,EAAE,CAAC;KAChD,CAAC;IAQF;;OAEG;IACG,mBAAmB,CACvB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;QACT,MAAM,EAAE,aAAa,CAAC;QACtB,QAAQ,EAAE,OAAO,UAAU,EAAE,eAAe,EAAE,CAAC;KAChD,CAAC;IAQF;;OAEG;IACG,uBAAuB,CAC3B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QACT,MAAM,EAAE,aAAa,CAAC;QACtB,QAAQ,EAAE,OAAO,UAAU,EAAE,eAAe,EAAE,CAAC;KAChD,CAAC;IAQF;;OAEG;IACG,sBAAsB,IAAI,OAAO,CAAC;QACtC,QAAQ,EAAE,OAAO,UAAU,EAAE,eAAe,EAAE,CAAC;QAC/C,aAAa,EAAE,OAAO,UAAU,EAAE,kBAAkB,EAAE,CAAC;KACxD,CAAC;IAIF;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC;QACjC,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC/C,CAAC;CAiBH"}

package/dist/reflection/hooks/bootstrap-hook.js

@@ -0,0 +1,97 @@
+"use strict";
+/**
+ * @description BootstrapHook — Puente entre el proceso de inicialización (bootstrap) y el ReflectionEngine.
+ *
+ * Captura incidentes durante el arranque del sistema (configuración faltante,
+ * manifest corrupto, fallos de carga de memoria) y los reporta al
+ * ReflectionEngine para análisis y promoción a políticas.
+ *
+ * Se integra en bootstrap/index.ts (detector.ts, config-loader.ts, memory-loader.ts).
+ *
+ * @example
+ * ```ts
+ * const hook = new BootstrapHook(engine);
+ * await hook.reportBootstrapFailure('missing_config_yaml', 'No se encontró config.yaml');
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BootstrapHook = void 0;
+const bootstrap_domain_1 = require("../domains/bootstrap-domain");
+// ── BootstrapHook ────────────────────────────────────────────────────────────
+class BootstrapHook {
+    engine;
+    constructor(engine) {
+        this.engine = engine;
+    }
+    /**
+     * @description Reporta un incidente de bootstrap al Reflection Engine.
+     *
+     * @param failureType - Tipo de fallo (opcional, se auto-detecta)
+     * @param hallazgo - Descripción del incidente
+     * @param archivos - Archivos relacionados
+     * @param domain - Dominio del Reflection Engine (default: "bootstrap")
+     * @returns El FailureRecord creado y los patrones detectados
+     */
+    async reportBootstrapFailure(hallazgo, archivos = [], failureType, domain = 'bootstrap') {
+        const detectedType = failureType ?? (0, bootstrap_domain_1.detectBootstrapFailureType)(hallazgo);
+        const meta = (0, bootstrap_domain_1.getBootstrapFailureTypeMeta)(detectedType);
+        const record = {
+            domain,
+            failureType: detectedType,
+            severity: meta?.severity ?? 'high',
+            dimension: meta?.dimension ?? 'configuración',
+            gate: 'bootstrap',
+            agenteResponsable: 'system',
+            hallazgo,
+            recomendacion: meta?.genericRecommendation ?? 'Revisar la configuración de bootstrap y corregir el error antes de continuar',
+            archivos,
+            fecha: new Date().toISOString(),
+        };
+        const result = await this.engine.reportIncident(record);
+        return result;
+    }
+    /**
+     * @description Reporta un manifest.yaml corrupto.
+     */
+    async reportManifestCorrupt(parseError, manifestPath) {
+        return this.reportBootstrapFailure(`manifest_corrupt: Error al parsear ${manifestPath}: ${parseError}`, [manifestPath], 'manifest_corrupt');
+    }
+    /**
+     * @description Reporta un fallo de carga de archivo de configuración.
+     */
+    async reportMissingConfig(configPath) {
+        return this.reportBootstrapFailure(`missing_config_yaml: No se encontró ${configPath}`, [configPath], 'missing_config_yaml');
+    }
+    /**
+     * @description Reporta un fallo de carga de archivo de memoria.
+     */
+    async reportMemoryLoadFailure(memoryPath, errorDetail) {
+        return this.reportBootstrapFailure(`memory_load_failure: Error cargando ${memoryPath}: ${errorDetail}`, [memoryPath], 'memory_load_failure');
+    }
+    /**
+     * @description Ejecuta una reflexión completa del dominio bootstrap.
+     */
+    async reflectBootstrapDomain() {
+        return this.engine.reflect({ domain: 'bootstrap', autoPromote: true });
+    }
+    /**
+     * @description Obtiene estadísticas de incidentes del dominio bootstrap.
+     */
+    async getBootstrapStats() {
+        const stats = await this.engine.getStats();
+        const catalog = this.engine.getCatalog();
+        const bootstrapRecords = await catalog.findByDomain('bootstrap');
+        const unresolved = await catalog.findUnresolved();
+        const patternsByFailureType = {};
+        for (const record of bootstrapRecords) {
+            patternsByFailureType[record.failureType] = (patternsByFailureType[record.failureType] ?? 0) + 1;
+        }
+        return {
+            totalIncidents: stats.totalIncidents,
+            unresolvedCount: unresolved.length,
+            patternsByFailureType,
+        };
+    }
+}
+exports.BootstrapHook = BootstrapHook;
+//# sourceMappingURL=bootstrap-hook.js.map

package/dist/reflection/hooks/bootstrap-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-hook.js","sourceRoot":"","sources":["../../../src/reflection/hooks/bootstrap-hook.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAIH,kEAAsG;AAEtG,gFAAgF;AAEhF,MAAa,aAAa;IAChB,MAAM,CAAmB;IAEjC,YAAY,MAAwB;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,sBAAsB,CAC1B,QAAgB,EAChB,WAAqB,EAAE,EACvB,WAAyB,EACzB,SAA2B,WAAW;QAKtC,MAAM,YAAY,GAAG,WAAW,IAAI,IAAA,6CAA0B,EAAC,QAAQ,CAAC,CAAC;QACzE,MAAM,IAAI,GAAG,IAAA,8CAA2B,EAAC,YAAY,CAAC,CAAC;QAEvD,MAAM,MAAM,GAA8B;YACxC,MAAM;YACN,WAAW,EAAE,YAAY;YACzB,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,MAAM;YAClC,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,eAAe;YAC7C,IAAI,EAAE,WAAW;YACjB,iBAAiB,EAAE,QAAQ;YAC3B,QAAQ;YACR,aAAa,EAAE,IAAI,EAAE,qBAAqB,IAAI,8EAA8E;YAC5H,QAAQ;YACR,KAAK,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SAChC,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QACxD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CACzB,UAAkB,EAClB,YAAoB;QAKpB,OAAO,IAAI,CAAC,sBAAsB,CAChC,sCAAsC,YAAY,KAAK,UAAU,EAAE,EACnE,CAAC,YAAY,CAAC,EACd,kBAAkB,CACnB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,mBAAmB,CACvB,UAAkB;QAKlB,OAAO,IAAI,CAAC,sBAAsB,CAChC,uCAAuC,UAAU,EAAE,EACnD,CAAC,UAAU,CAAC,EACZ,qBAAqB,CACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,uBAAuB,CAC3B,UAAkB,EAClB,WAAmB;QAKnB,OAAO,IAAI,CAAC,sBAAsB,CAChC,uCAAuC,UAAU,KAAK,WAAW,EAAE,EACnE,CAAC,UAAU,CAAC,EACZ,qBAAqB,CACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,sBAAsB;QAI1B,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB;QAKrB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACzC,MAAM,gBAAgB,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;QACjE,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC;QAElD,MAAM,qBAAqB,GAA2B,EAAE,CAAC;QACzD,KAAK,MAAM,MAAM,IAAI,gBAAgB,EAAE,CAAC;YACtC,qBAAqB,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,qBAAqB,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACnG,CAAC;QAED,OAAO;YACL,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,eAAe,EAAE,UAAU,CAAC,MAAM;YAClC,qBAAqB;SACtB,CAAC;IACJ,CAAC;CACF;AAjID,sCAiIC"}

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

@@ -0,0 +1,63 @@
+/**
+ * @description CommitHook — Puente entre el commit-workflow.ps1 y el ReflectionEngine.
+ *
+ * Captura incidentes durante el proceso de commit (validaciones de formato,
+ * typecheck, tests) y los reporta al ReflectionEngine para análisis.
+ *
+ * Se integra en el Test Validation Gate del commit-workflow.
+ *
+ * @example
+ * ```ts
+ * const hook = new CommitHook(engine);
+ * await hook.reportCommitFailure('missing_type', 'Mensaje sin tipo Conventional Commits');
+ * ```
+ */
+import { ReflectionEngine } from '../reflection-engine';
+import { FailureRecord, ReflectionDomain, FailureType } from '../types';
+export declare class CommitHook {
+    private engine;
+    constructor(engine: ReflectionEngine);
+    /**
+     * @description Reporta un fallo de validación de commit.
+     *
+     * @param failureType - Tipo de fallo (opcional, se auto-detecta)
+     * @param hallazgo - Descripción del fallo
+     * @param archivos - Archivos involucrados en el commit
+     * @param domain - Dominio del Reflection Engine (default: "commit")
+     * @returns El FailureRecord creado y los patrones detectados
+     */
+    reportCommitFailure(hallazgo: string, archivos: string[], failureType?: FailureType, domain?: ReflectionDomain): Promise<{
+        record: FailureRecord;
+        patterns: import('../types').DetectedPattern[];
+    }>;
+    /**
+     * @description Reporta un error de typecheck durante el commit.
+     */
+    reportTypecheckFailure(errorMessage: string, archivos: string[]): Promise<{
+        record: FailureRecord;
+        patterns: import('../types').DetectedPattern[];
+    }>;
+    /**
+     * @description Reporta tests fallidos durante el commit.
+     */
+    reportTestFailure(errorMessage: string, archivos: string[]): Promise<{
+        record: FailureRecord;
+        patterns: import('../types').DetectedPattern[];
+    }>;
+    /**
+     * @description Ejecuta una reflexión completa del dominio commit.
+     */
+    reflectCommitDomain(): Promise<{
+        patterns: import('../types').DetectedPattern[];
+        promotedRules: import('../types').ManifestPolicyRule[];
+    }>;
+    /**
+     * @description Obtiene estadísticas de incidentes del dominio commit.
+     */
+    getCommitStats(): Promise<{
+        totalIncidents: number;
+        unresolvedCount: number;
+        patternsByFailureType: Record<string, number>;
+    }>;
+}
+//# sourceMappingURL=commit-hook.d.ts.map

package/dist/reflection/hooks/commit-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-hook.d.ts","sourceRoot":"","sources":["../../../src/reflection/hooks/commit-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAKxE,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAmB;gBAErB,MAAM,EAAE,gBAAgB;IAIpC;;;;;;;;OAQG;IACG,mBAAmB,CACvB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,WAAW,CAAC,EAAE,WAAW,EACzB,MAAM,GAAE,gBAA2B,GAClC,OAAO,CAAC;QACT,MAAM,EAAE,aAAa,CAAC;QACtB,QAAQ,EAAE,OAAO,UAAU,EAAE,eAAe,EAAE,CAAC;KAChD,CAAC;IAqBF;;OAEG;IACG,sBAAsB,CAC1B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC;QACT,MAAM,EAAE,aAAa,CAAC;QACtB,QAAQ,EAAE,OAAO,UAAU,EAAE,eAAe,EAAE,CAAC;KAChD,CAAC;IAQF;;OAEG;IACG,iBAAiB,CACrB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC;QACT,MAAM,EAAE,aAAa,CAAC;QACtB,QAAQ,EAAE,OAAO,UAAU,EAAE,eAAe,EAAE,CAAC;KAChD,CAAC;IAQF;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC;QACnC,QAAQ,EAAE,OAAO,UAAU,EAAE,eAAe,EAAE,CAAC;QAC/C,aAAa,EAAE,OAAO,UAAU,EAAE,kBAAkB,EAAE,CAAC;KACxD,CAAC;IAIF;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC;QAC9B,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC/C,CAAC;CAiBH"}

package/dist/reflection/hooks/commit-hook.js

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * @description CommitHook — Puente entre el commit-workflow.ps1 y el ReflectionEngine.
+ *
+ * Captura incidentes durante el proceso de commit (validaciones de formato,
+ * typecheck, tests) y los reporta al ReflectionEngine para análisis.
+ *
+ * Se integra en el Test Validation Gate del commit-workflow.
+ *
+ * @example
+ * ```ts
+ * const hook = new CommitHook(engine);
+ * await hook.reportCommitFailure('missing_type', 'Mensaje sin tipo Conventional Commits');
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommitHook = void 0;
+const commit_domain_1 = require("../domains/commit-domain");
+// ── CommitHook ───────────────────────────────────────────────────────────────
+class CommitHook {
+    engine;
+    constructor(engine) {
+        this.engine = engine;
+    }
+    /**
+     * @description Reporta un fallo de validación de commit.
+     *
+     * @param failureType - Tipo de fallo (opcional, se auto-detecta)
+     * @param hallazgo - Descripción del fallo
+     * @param archivos - Archivos involucrados en el commit
+     * @param domain - Dominio del Reflection Engine (default: "commit")
+     * @returns El FailureRecord creado y los patrones detectados
+     */
+    async reportCommitFailure(hallazgo, archivos, failureType, domain = 'commit') {
+        const detectedType = failureType ?? (0, commit_domain_1.detectCommitFailureType)(hallazgo);
+        const meta = (0, commit_domain_1.getCommitFailureTypeMeta)(detectedType);
+        const record = {
+            domain,
+            failureType: detectedType,
+            severity: meta?.severity ?? 'medium',
+            dimension: meta?.dimension ?? 'convenciones',
+            gate: 'commit-workflow',
+            agenteResponsable: 'system',
+            hallazgo,
+            recomendacion: meta?.genericRecommendation ?? 'Revisar las reglas de validación de commit y corregir',
+            archivos,
+            fecha: new Date().toISOString(),
+        };
+        const result = await this.engine.reportIncident(record);
+        return result;
+    }
+    /**
+     * @description Reporta un error de typecheck durante el commit.
+     */
+    async reportTypecheckFailure(errorMessage, archivos) {
+        return this.reportCommitFailure(`typecheck_failed_before_commit: ${errorMessage}`, archivos, 'typecheck_failed_before_commit');
+    }
+    /**
+     * @description Reporta tests fallidos durante el commit.
+     */
+    async reportTestFailure(errorMessage, archivos) {
+        return this.reportCommitFailure(`test_failed_before_commit: ${errorMessage}`, archivos, 'test_failed_before_commit');
+    }
+    /**
+     * @description Ejecuta una reflexión completa del dominio commit.
+     */
+    async reflectCommitDomain() {
+        return this.engine.reflect({ domain: 'commit', autoPromote: true });
+    }
+    /**
+     * @description Obtiene estadísticas de incidentes del dominio commit.
+     */
+    async getCommitStats() {
+        const stats = await this.engine.getStats();
+        const catalog = this.engine.getCatalog();
+        const commitRecords = await catalog.findByDomain('commit');
+        const unresolved = await catalog.findUnresolved();
+        const patternsByFailureType = {};
+        for (const record of commitRecords) {
+            patternsByFailureType[record.failureType] = (patternsByFailureType[record.failureType] ?? 0) + 1;
+        }
+        return {
+            totalIncidents: stats.totalIncidents,
+            unresolvedCount: unresolved.length,
+            patternsByFailureType,
+        };
+    }
+}
+exports.CommitHook = CommitHook;
+//# sourceMappingURL=commit-hook.js.map

package/dist/reflection/hooks/commit-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-hook.js","sourceRoot":"","sources":["../../../src/reflection/hooks/commit-hook.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAIH,4DAA6F;AAE7F,gFAAgF;AAEhF,MAAa,UAAU;IACb,MAAM,CAAmB;IAEjC,YAAY,MAAwB;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,mBAAmB,CACvB,QAAgB,EAChB,QAAkB,EAClB,WAAyB,EACzB,SAA2B,QAAQ;QAKnC,MAAM,YAAY,GAAG,WAAW,IAAI,IAAA,uCAAuB,EAAC,QAAQ,CAAC,CAAC;QACtE,MAAM,IAAI,GAAG,IAAA,wCAAwB,EAAC,YAAY,CAAC,CAAC;QAEpD,MAAM,MAAM,GAA8B;YACxC,MAAM;YACN,WAAW,EAAE,YAAY;YACzB,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,QAAQ;YACpC,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,cAAc;YAC5C,IAAI,EAAE,iBAAiB;YACvB,iBAAiB,EAAE,QAAQ;YAC3B,QAAQ;YACR,aAAa,EAAE,IAAI,EAAE,qBAAqB,IAAI,uDAAuD;YACrG,QAAQ;YACR,KAAK,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SAChC,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QACxD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,sBAAsB,CAC1B,YAAoB,EACpB,QAAkB;QAKlB,OAAO,IAAI,CAAC,mBAAmB,CAC7B,mCAAmC,YAAY,EAAE,EACjD,QAAQ,EACR,gCAAgC,CACjC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CACrB,YAAoB,EACpB,QAAkB;QAKlB,OAAO,IAAI,CAAC,mBAAmB,CAC7B,8BAA8B,YAAY,EAAE,EAC5C,QAAQ,EACR,2BAA2B,CAC5B,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,mBAAmB;QAIvB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc;QAKlB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACzC,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC3D,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC;QAElD,MAAM,qBAAqB,GAA2B,EAAE,CAAC;QACzD,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;YACnC,qBAAqB,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,qBAAqB,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACnG,CAAC;QAED,OAAO;YACL,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,eAAe,EAAE,UAAU,CAAC,MAAM;YAClC,qBAAqB;SACtB,CAAC;IACJ,CAAC;CACF;AAjHD,gCAiHC"}