@backendkit-labs/agent-core 0.14.0

package/dist/orchestration/domain-detector.js

@@ -0,0 +1,157 @@
+"use strict";
+/**
+ * @description Domain Detector — Detecta los bounded contexts/dominios
+ * a partir del input del usuario.
+ *
+ * Usa keywords + bigramas para identificar dominios técnicos.
+ * Soporta detección de servicios objetivo y patrones relacionados.
+ *
+ * @see capability-matrix.yaml en ~/.deepseek-code/ para la lista completa
+ * de dominios por agente.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectDomains = detectDomains;
+exports.enrichTaskWithDomains = enrichTaskWithDomains;
+const keyword_match_1 = require("./keyword-match");
+/**
+ * Mapa de dominios con sus keywords.
+ * Este mapa base se puede extender desde ~/.deepseek-code/capability-matrix.yaml
+ */
+const DOMAIN_KEYWORDS = {
+    security: [
+        { words: ['jwt', 'token', 'autenticación', 'autenticacion', 'auth'], pattern: 'jwt-auth' },
+        { words: ['autorización', 'autorizacion', 'abac', 'rbac', 'permisos'], pattern: 'abac' },
+        { words: ['api key', 'apikey', 'api-key'], pattern: 'api-key' },
+        { words: ['oauth', 'oauth2', 'openid', 'oidc'], pattern: 'oauth2' },
+        { words: ['cifrado', 'encriptación', 'hash', 'bcrypt', 'argon2'] },
+        { words: ['xss', 'csrf', 'inyección', 'inyeccion', 'sql injection', 'owasp'] },
+        { words: ['vulnerabilidad', 'vulnerabilidad', 'cve', 'pentest'] },
+        { words: ['secrets', 'secretos', 'vault', 'hashicorp'] },
+        { words: ['certificado', 'tls', 'ssl', 'https', 'mtls'] },
+    ],
+    resilience: [
+        { words: ['circuit breaker', 'circuitbreaker', 'breaker'], pattern: 'circuit-breaker' },
+        { words: ['retry', 'reintento', 'backoff', 'exponential backoff'], pattern: 'retry-backoff' },
+        { words: ['bulkhead', 'aislamiento'], pattern: 'bulkhead' },
+        { words: ['timeout', 'time-out', 'latency', 'latencia'] },
+        { words: ['fallover', 'failover', 'alta disponibilidad', 'high availability'] },
+        { words: ['resiliencia', 'resilience', 'tolerancia a fallos'] },
+    ],
+    messaging: [
+        { words: ['rabbitmq', 'amqp', 'broker', 'cola', 'queue'], pattern: 'broker-tcp' },
+        { words: ['kafka', 'evento', 'event streaming', 'topic'] },
+        { words: ['sns', 'sqs', 'mensajería', 'mensajeria'] },
+        { words: ['dlq', 'dead letter', 'reintento fallido'] },
+        { words: ['pub/sub', 'publish', 'subscribe', 'suscripción'] },
+    ],
+    database: [
+        { words: ['base de datos', 'bd', 'database', 'db'] },
+        { words: ['mysql', 'postgresql', 'postgres', 'sql server', 'oracle'] },
+        { words: ['mongodb', 'nosql', 'documento', 'colección'] },
+        { words: ['redis', 'caché', 'cache', 'memcached'] },
+        { words: ['elasticsearch', 'búsqueda', 'search', 'índice', 'indice'] },
+        { words: ['migración', 'migracion', 'schema', 'esquema'] },
+        { words: ['query', 'consulta', 'sql', 'join', 'índice', 'indice'] },
+        { words: ['orm', 'prisma', 'typeorm', 'sequelize', 'drizzle'] },
+    ],
+    backend: [
+        { words: ['backend', 'servidor', 'server-side'] },
+        { words: ['api', 'rest', 'graphql', 'grpc', 'endpoint'] },
+        { words: ['nestjs', 'nest', 'express', 'fastify', 'fastapi'] },
+        { words: ['controlador', 'controller', 'servicio', 'service', 'repositorio'] },
+        { words: ['middleware', 'interceptor', 'guard', 'pipe', 'filter'] },
+        { words: ['dto', 'validator', 'validación', 'validacion', 'zod', 'class-validator'] },
+        { words: ['inyección de dependencias', 'dependency injection', 'di'] },
+    ],
+    frontend: [
+        { words: ['react', 'vue', 'angular', 'svelte', 'solid'] },
+        { words: ['componente', 'component', 'hook', 'useEffect', 'useState'] },
+        { words: ['ui', 'interfaz', 'usuario', 'pantalla', 'vista'] },
+        { words: ['css', 'tailwind', 'estilo', 'style', 'animación'] },
+        { words: ['next.js', 'nextjs', 'nuxt', 'gatsby', 'astro'] },
+        { words: ['formulario', 'form', 'input', 'botón', 'boton'] },
+    ],
+    architecture: [
+        { words: ['arquitectura', 'arquitectónico', 'arquitectonico'] },
+        { words: ['ddd', 'domain driven', 'bounded context', 'agregado', 'aggregate'] },
+        { words: ['microservicio', 'microservicios', 'monolito', 'modular'] },
+        { words: ['event sourcing', 'cqrs', 'saga', 'outbox', 'inbox'] },
+        { words: ['patrón', 'patron', 'design pattern', 'patrón de diseño'] },
+        { words: ['c4', 'diagrama', 'adr', 'trade-off'] },
+    ],
+    testing: [
+        { words: ['test', 'tests', 'testing', 'prueba', 'pruebas'] },
+        { words: ['unitario', 'unit test', 'integración', 'integration', 'e2e'] },
+        { words: ['jest', 'vitest', 'playwright', 'cypress', 'mocha'] },
+        { words: ['tdd', 'bdd', 'cobertura', 'coverage', 'mock'] },
+        { words: ['contrato', 'contract', 'pact', 'mutation'] },
+    ],
+    devops: [
+        { words: ['docker', 'dockerfile', 'contenedor', 'container', 'imagen'] },
+        { words: ['kubernetes', 'k8s', 'helm', 'pod', 'deployment', 'service'] },
+        { words: ['ci/cd', 'pipeline', 'github actions', 'gitlab ci', 'jenkins'] },
+        { words: ['terraform', 'pulumi', 'iac', 'infraestructura'] },
+        { words: ['cloud', 'aws', 'gcp', 'azure', 'nube'] },
+        { words: ['monitoreo', 'monitoring', 'prometheus', 'grafana', 'alertas'] },
+    ],
+};
+/**
+ * @description Detecta dominios a partir del input del usuario.
+ *
+ * Analiza el texto en busca de keywords técnicas y construye
+ * un mapa de dominios con sus puntuaciones.
+ *
+ * @param input - Texto del usuario
+ * @returns Dominios detectados con scores
+ */
+function detectDomains(input) {
+    const lower = input.toLowerCase();
+    const scores = {};
+    const targetServices = new Set();
+    const relatedPatterns = new Set();
+    for (const [domain, keywords] of Object.entries(DOMAIN_KEYWORDS)) {
+        let total = 0;
+        for (const kw of keywords) {
+            for (const word of kw.words) {
+                if ((0, keyword_match_1.matchesKeyword)(lower, word)) {
+                    total += 1;
+                    if (kw.service)
+                        targetServices.add(kw.service);
+                    if (kw.pattern)
+                        relatedPatterns.add(kw.pattern);
+                }
+            }
+        }
+        if (total > 0) {
+            scores[domain] = total;
+        }
+    }
+    // Ordenar por score descendente
+    const sorted = Object.entries(scores)
+        .sort(([, a], [, b]) => b - a)
+        .map(([domain]) => domain);
+    return {
+        domains: sorted,
+        targetServices: [...targetServices],
+        relatedPatterns: [...relatedPatterns],
+        scores,
+    };
+}
+/**
+ * @description Enriquce un TaskContext con los dominios detectados.
+ */
+function enrichTaskWithDomains(task) {
+    const result = detectDomains(task.rawPrompt);
+    return {
+        ...task,
+        domains: result.domains,
+        targetServices: [
+            ...new Set([...task.targetServices, ...result.targetServices]),
+        ],
+        relatedPatterns: [
+            ...new Set([...task.relatedPatterns, ...result.relatedPatterns]),
+        ],
+        updatedAt: new Date(),
+    };
+}
+//# sourceMappingURL=domain-detector.js.map

package/dist/orchestration/domain-detector.js.map

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

package/dist/orchestration/fsm.d.ts

@@ -0,0 +1,86 @@
+/**
+ * @description FSM — Finite State Machine para el ciclo de vida de tareas.
+ *
+ * Define los estados válidos y las transiciones permitidas para un TaskContext.
+ * Cada tarea comienza en 'new' y progresa a través de gates (architecture,
+ * security, QA) hasta llegar a 'commit_allowed' o 'rejected'.
+ *
+ * El FSM se integra con el Orchestrator para validar que las transiciones
+ * sean legales según las políticas aplicadas.
+ *
+ * @example
+ * ```ts
+ * const fsm = new TaskFSM();
+ * const task = createTaskContext('Implementar auth');
+ *
+ * // Transición válida
+ * const result = fsm.transition(task, 'classified');
+ * // result.allowed === true
+ * // result.task.status === 'classified'
+ *
+ * // Transición inválida
+ * const result2 = fsm.transition(task, 'commit_allowed');
+ * // result.allowed === false
+ * // result.error === 'Transición no permitida: new → commit_allowed'
+ * ```
+ */
+import { TaskContext, TaskStatus } from './task-context';
+export interface FSMTransitionResult {
+    /** Si la transición fue permitida */
+    allowed: boolean;
+    /** TaskContext actualizado (solo si allowed === true) */
+    task?: TaskContext;
+    /** Mensaje de error si no fue permitida */
+    error?: string;
+    /** Próximos estados válidos desde el estado actual */
+    availableTransitions: TaskStatus[];
+}
+export declare class TaskFSM {
+    /**
+     * @description Intenta transicionar una tarea a un nuevo estado.
+     * Valida que la transición esté en el mapa de transiciones permitidas
+     * y que pase todos los guards.
+     *
+     * @param task - Tarea actual
+     * @param to - Estado destino
+     * @returns Resultado con la tarea actualizada o error
+     */
+    transition(task: TaskContext, to: TaskStatus): FSMTransitionResult;
+    /**
+     * @description Obtiene los estados destino válidos desde un estado dado.
+     */
+    getAvailableTransitions(from: TaskStatus): TaskStatus[];
+    /**
+     * @description Determina si un estado es terminal (no tiene salidas).
+     */
+    isTerminal(status: TaskStatus): boolean;
+    /**
+     * @description Calcula la ruta crítica desde el estado actual hasta commit_allowed.
+     * Útil para mostrar al usuario qué gates faltan.
+     */
+    getCriticalPath(task: TaskContext): TaskStatus[];
+    /**
+     * Verifica si la tarea definitivamente ha pasado por un gate específico.
+     *
+     * La verificacion es deliberadamente conservadora: prefiere falsos negativos
+     * (mostrar un gate como pendiente cuando ya paso) antes que falsos positivos
+     * (ocultarlo cuando no paso). getCriticalPath es una funcion de display, no
+     * de enforcement — el FSM ya se encarga de bloquear transiciones invalidas.
+     *
+     * Razon del cambio: el enfoque anterior con indice lineal daba falsos positivos.
+     * Ejemplo: classified → implementation con requiresArchitectureReview=true
+     * reportaba design_review como "ya pasado" porque implementation(idx=3) > design_review(idx=2),
+     * cuando en realidad el FSM permite saltarse design_review desde classified.
+     *
+     * Logica basada en guardas reales del FSM:
+     * - "approved" y estados posteriores garantizan que los gates requeridos se
+     *   cumplieron (las guardas del FSM bloquean esos saltos).
+     * - security_review: si requiresSecurityReview=true y el task esta en qa_review
+     *   o posterior, el FSM garantiza que security_review fue visitado.
+     * - design_review: no hay guarda que lo garantice en todos los caminos
+     *   (classified → implementation esta permitido aunque requiresArchitectureReview=true),
+     *   asi que solo retorna true si el task esta exactamente en ese estado.
+     */
+    private hasPassedGate;
+}
+//# sourceMappingURL=fsm.d.ts.map

package/dist/orchestration/fsm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsm.d.ts","sourceRoot":"","sources":["../../src/orchestration/fsm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAkB,MAAM,gBAAgB,CAAC;AAyEzE,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,oBAAoB,EAAE,UAAU,EAAE,CAAC;CACpC;AAID,qBAAa,OAAO;IAClB;;;;;;;;OAQG;IACH,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,UAAU,GAAG,mBAAmB;IAgClE;;OAEG;IACH,uBAAuB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,EAAE;IAIvD;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO;IAIvC;;;OAGG;IACH,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,EAAE;IAsChD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,OAAO,CAAC,aAAa;CA0BtB"}

package/dist/orchestration/fsm.js

@@ -0,0 +1,223 @@
+"use strict";
+/**
+ * @description FSM — Finite State Machine para el ciclo de vida de tareas.
+ *
+ * Define los estados válidos y las transiciones permitidas para un TaskContext.
+ * Cada tarea comienza en 'new' y progresa a través de gates (architecture,
+ * security, QA) hasta llegar a 'commit_allowed' o 'rejected'.
+ *
+ * El FSM se integra con el Orchestrator para validar que las transiciones
+ * sean legales según las políticas aplicadas.
+ *
+ * @example
+ * ```ts
+ * const fsm = new TaskFSM();
+ * const task = createTaskContext('Implementar auth');
+ *
+ * // Transición válida
+ * const result = fsm.transition(task, 'classified');
+ * // result.allowed === true
+ * // result.task.status === 'classified'
+ *
+ * // Transición inválida
+ * const result2 = fsm.transition(task, 'commit_allowed');
+ * // result.allowed === false
+ * // result.error === 'Transición no permitida: new → commit_allowed'
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskFSM = void 0;
+const task_context_1 = require("./task-context");
+// ── Definición de transiciones ───────────────────────────────────────────────
+/**
+ * Mapa de transiciones permitidas.
+ * Cada estado tiene un conjunto de estados destino válidos.
+ */
+const TRANSITIONS = {
+    'new': ['classified', 'commit_planning'], // ← commit_planning para @commit sin orquestación
+    'classified': ['design_review', 'implementation', 'security_review', 'qa_review', 'rejected'],
+    'design_review': ['implementation', 'security_review', 'qa_review', 'rework_required', 'rejected'],
+    'implementation': ['security_review', 'qa_review', 'design_review', 'rework_required', 'rejected'],
+    'security_review': ['qa_review', 'design_review', 'implementation', 'rework_required', 'rejected'],
+    'qa_review': ['approved', 'rework_required', 'rejected'],
+    'rework_required': ['design_review', 'implementation', 'security_review', 'qa_review', 'rejected'],
+    'approved': ['commit_allowed', 'commit_planning', 'implementation', 'rejected'],
+    'commit_allowed': ['commit_planning'], // Puede re-planificar desde commit_allowed
+    'rejected': [], // Estado terminal
+    // Nuevos estados del commit workflow
+    'commit_planning': ['commit_reviewing', 'commit_failed', 'commit_skipped'],
+    'commit_reviewing': ['commit_validated', 'commit_rejected', 'commit_failed'],
+    'commit_validated': ['commit_allowed'], // Plan validado, listo para ejecutar commit
+    'commit_rejected': ['commit_planning', 'rejected'], // Rechazado, puede replanificar
+    'commit_failed': ['commit_planning', 'rejected'], // Falló, puede reintentar
+    'commit_skipped': ['commit_allowed'], // Saltado, vuelve a commit_allowed
+};
+const GUARDS = [
+    // No se puede saltar a commit_allowed sin pasar por approved o commit_validated
+    (task, to) => {
+        if (to === 'commit_allowed' && task.status !== 'approved' && task.status !== 'commit_validated') {
+            return 'Debe estar en estado "approved" o "commit_validated" antes de permitir commit';
+        }
+        return null;
+    },
+    // Si requiere architecture review, debe pasar por design_review
+    (task, to) => {
+        if (task.requiresArchitectureReview && to === 'implementation' && task.status !== 'design_review' && task.status !== 'classified') {
+            return 'Requiere revisión de arquitectura (design_review) antes de implementar';
+        }
+        return null;
+    },
+    // Si requiere security review, debe pasar por security_review
+    (task, to) => {
+        if (task.requiresSecurityReview && to === 'qa_review' && task.status !== 'security_review') {
+            return 'Requiere revisión de seguridad (security_review) antes de QA';
+        }
+        return null;
+    },
+    // Si requiere QA approval, debe pasar por qa_review
+    (task, to) => {
+        if (task.requiresQaApproval && to === 'approved' && task.status !== 'qa_review') {
+            return 'Requiere aprobación de QA (qa_review) antes de approved';
+        }
+        return null;
+    },
+];
+// ── TaskFSM ──────────────────────────────────────────────────────────────────
+class TaskFSM {
+    /**
+     * @description Intenta transicionar una tarea a un nuevo estado.
+     * Valida que la transición esté en el mapa de transiciones permitidas
+     * y que pase todos los guards.
+     *
+     * @param task - Tarea actual
+     * @param to - Estado destino
+     * @returns Resultado con la tarea actualizada o error
+     */
+    transition(task, to) {
+        const available = this.getAvailableTransitions(task.status);
+        // Verificar que la transición esté permitida
+        if (!available.includes(to)) {
+            return {
+                allowed: false,
+                error: `Transición no permitida: ${task.status} → ${to}. Estados válidos: ${available.join(', ')}`,
+                availableTransitions: available,
+            };
+        }
+        // Ejecutar guards
+        for (const guard of GUARDS) {
+            const error = guard(task, to);
+            if (error) {
+                return {
+                    allowed: false,
+                    error,
+                    availableTransitions: available,
+                };
+            }
+        }
+        // Transición válida
+        return {
+            allowed: true,
+            task: (0, task_context_1.transitionTask)(task, to),
+            availableTransitions: this.getAvailableTransitions(to),
+        };
+    }
+    /**
+     * @description Obtiene los estados destino válidos desde un estado dado.
+     */
+    getAvailableTransitions(from) {
+        return TRANSITIONS[from] ?? [];
+    }
+    /**
+     * @description Determina si un estado es terminal (no tiene salidas).
+     */
+    isTerminal(status) {
+        return TRANSITIONS[status]?.length === 0;
+    }
+    /**
+     * @description Calcula la ruta crítica desde el estado actual hasta commit_allowed.
+     * Útil para mostrar al usuario qué gates faltan.
+     */
+    getCriticalPath(task) {
+        const path = [task.status];
+        const current = task.status;
+        if (current === 'commit_allowed' || current === 'rejected')
+            return path;
+        // Si está en new, debe clasificarse
+        if (current === 'new') {
+            path.push('classified');
+        }
+        // Si requiere architecture review y no ha pasado
+        if (task.requiresArchitectureReview && !this.hasPassedGate(task, 'design_review')) {
+            if (!path.includes('design_review'))
+                path.push('design_review');
+        }
+        // Si no ha llegado a implementation
+        if (current !== 'implementation' && current !== 'design_review') {
+            if (!path.includes('implementation'))
+                path.push('implementation');
+        }
+        // Si requiere security review
+        if (task.requiresSecurityReview && !this.hasPassedGate(task, 'security_review')) {
+            if (!path.includes('security_review'))
+                path.push('security_review');
+        }
+        // Si requiere QA approval
+        if (task.requiresQaApproval && !this.hasPassedGate(task, 'qa_review')) {
+            if (!path.includes('qa_review'))
+                path.push('qa_review');
+        }
+        // Approved → commit_allowed
+        if (!path.includes('approved'))
+            path.push('approved');
+        if (!path.includes('commit_allowed'))
+            path.push('commit_allowed');
+        return path;
+    }
+    /**
+     * Verifica si la tarea definitivamente ha pasado por un gate específico.
+     *
+     * La verificacion es deliberadamente conservadora: prefiere falsos negativos
+     * (mostrar un gate como pendiente cuando ya paso) antes que falsos positivos
+     * (ocultarlo cuando no paso). getCriticalPath es una funcion de display, no
+     * de enforcement — el FSM ya se encarga de bloquear transiciones invalidas.
+     *
+     * Razon del cambio: el enfoque anterior con indice lineal daba falsos positivos.
+     * Ejemplo: classified → implementation con requiresArchitectureReview=true
+     * reportaba design_review como "ya pasado" porque implementation(idx=3) > design_review(idx=2),
+     * cuando en realidad el FSM permite saltarse design_review desde classified.
+     *
+     * Logica basada en guardas reales del FSM:
+     * - "approved" y estados posteriores garantizan que los gates requeridos se
+     *   cumplieron (las guardas del FSM bloquean esos saltos).
+     * - security_review: si requiresSecurityReview=true y el task esta en qa_review
+     *   o posterior, el FSM garantiza que security_review fue visitado.
+     * - design_review: no hay guarda que lo garantice en todos los caminos
+     *   (classified → implementation esta permitido aunque requiresArchitectureReview=true),
+     *   asi que solo retorna true si el task esta exactamente en ese estado.
+     */
+    hasPassedGate(task, gate) {
+        const s = task.status;
+        if (s === gate)
+            return true;
+        // Desde approved en adelante el FSM garantiza que todos los gates requeridos
+        // fueron satisfechos (las guardas son transitivas por la cadena de transiciones).
+        const postApproval = new Set([
+            'approved', 'commit_allowed', 'commit_planning', 'commit_reviewing',
+            'commit_validated', 'commit_skipped',
+        ]);
+        if (postApproval.has(s))
+            return true;
+        // security_review: la guarda del FSM bloquea qa_review si requiresSecurityReview
+        // y el task no esta en security_review — por lo tanto qa_review garantiza que
+        // security_review fue visitado cuando el flag esta activo.
+        if (gate === 'security_review' && task.requiresSecurityReview) {
+            return s === 'qa_review' || postApproval.has(s);
+        }
+        // design_review: no hay guarda que fuerce su visita antes de implementation
+        // desde classified, asi que no podemos asumir que fue visitado.
+        // Solo retorna true si el task esta en ese estado (cubierto arriba).
+        return false;
+    }
+}
+exports.TaskFSM = TaskFSM;
+//# sourceMappingURL=fsm.js.map

package/dist/orchestration/fsm.js.map

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

package/dist/orchestration/gate-resolver.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @description GateResolver — Única fuente de verdad para la resolución de gates.
+ *
+ * Consolida la lógica que estaba dispersa en:
+ * - buildPipeline() de orchestrator/index.ts
+ * - isCommitAllowed() de orchestrator/index.ts
+ * - policy-engine.ts (requiredGates)
+ * - risk-scorer.ts (riskLevel → gates)
+ *
+ * Usar esta función como punto de entrada canónico para determinar:
+ * qué agentes se activan en cada fase, y si el commit está permitido.
+ */
+import { TaskContext } from './task-context';
+import { PolicyEngineResult } from './policy-engine';
+import { AgentPipelinePhase } from './types';
+import { OrchestratorConfig } from './types';
+export interface GateResolution {
+    /** Pipeline de fases de agentes a ejecutar */
+    pipeline: AgentPipelinePhase[];
+    /** Si el commit está permitido en el estado actual */
+    commitAllowed: boolean;
+    /** Reviews obligatorias detectadas (para trazabilidad) */
+    requiredReviews: Array<'security' | 'architecture' | 'qa'>;
+}
+/**
+ * @description Determina el pipeline de gates y si el commit está permitido.
+ *
+ * @param task - Contexto de la tarea orquestada
+ * @param policyResult - Resultado del PolicyEngine con gates requeridos
+ * @param config - Configuración del orquestador
+ * @param selectedAgents - Agentes ya seleccionados por el router
+ */
+export declare function resolveGates(task: TaskContext, policyResult: PolicyEngineResult, config: OrchestratorConfig, selectedAgents: Array<{
+    agentId: string;
+    score: number;
+    reason: string;
+}>): GateResolution;
+/**
+ * @description Determina si el commit está permitido según el estado del task y las políticas.
+ */
+export declare function resolveCommitAllowed(task: TaskContext, policyResult: PolicyEngineResult, config: OrchestratorConfig): boolean;
+//# sourceMappingURL=gate-resolver.d.ts.map

package/dist/orchestration/gate-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-resolver.d.ts","sourceRoot":"","sources":["../../src/orchestration/gate-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,sDAAsD;IACtD,aAAa,EAAE,OAAO,CAAC;IACvB,0DAA0D;IAC1D,eAAe,EAAE,KAAK,CAAC,UAAU,GAAG,cAAc,GAAG,IAAI,CAAC,CAAC;CAC5D;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,WAAW,EACjB,YAAY,EAAE,kBAAkB,EAChC,MAAM,EAAE,kBAAkB,EAC1B,cAAc,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GACxE,cAAc,CAyDhB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,WAAW,EACjB,YAAY,EAAE,kBAAkB,EAChC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAaT"}

package/dist/orchestration/gate-resolver.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * @description GateResolver — Única fuente de verdad para la resolución de gates.
+ *
+ * Consolida la lógica que estaba dispersa en:
+ * - buildPipeline() de orchestrator/index.ts
+ * - isCommitAllowed() de orchestrator/index.ts
+ * - policy-engine.ts (requiredGates)
+ * - risk-scorer.ts (riskLevel → gates)
+ *
+ * Usar esta función como punto de entrada canónico para determinar:
+ * qué agentes se activan en cada fase, y si el commit está permitido.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveGates = resolveGates;
+exports.resolveCommitAllowed = resolveCommitAllowed;
+/**
+ * @description Determina el pipeline de gates y si el commit está permitido.
+ *
+ * @param task - Contexto de la tarea orquestada
+ * @param policyResult - Resultado del PolicyEngine con gates requeridos
+ * @param config - Configuración del orquestador
+ * @param selectedAgents - Agentes ya seleccionados por el router
+ */
+function resolveGates(task, policyResult, config, selectedAgents) {
+    const pipeline = [];
+    const requiredReviews = [];
+    const isHighRisk = task.riskLevel === 'high' || task.riskLevel === 'critical';
+    const hasSecurityDomain = task.domains.includes('security');
+    const hasArchitectureDomain = task.domains.includes('architecture') || task.domains.includes('resilience');
+    // Review de seguridad
+    if (task.requiresSecurityReview || (isHighRisk && hasSecurityDomain)) {
+        pipeline.push({
+            phase: 'review',
+            agentId: 'security',
+            purpose: 'Review security implications',
+            optional: false,
+        });
+        requiredReviews.push('security');
+    }
+    // Review de arquitectura
+    if (task.requiresArchitectureReview || (isHighRisk && hasArchitectureDomain)) {
+        pipeline.push({
+            phase: 'review',
+            agentId: 'architecture',
+            purpose: 'Review architecture for high-risk change',
+            optional: false,
+        });
+        requiredReviews.push('architecture');
+    }
+    // Fase de implementación: mejor agente seleccionado
+    const topAgent = selectedAgents[0];
+    if (topAgent && topAgent.agentId !== 'general') {
+        pipeline.push({
+            phase: 'implement',
+            agentId: topAgent.agentId,
+            purpose: topAgent.reason,
+            optional: false,
+        });
+    }
+    // Fase de verificación QA
+    const hasImplementPhase = pipeline.some(p => p.phase === 'implement');
+    if (hasImplementPhase && task.requiresQaApproval) {
+        pipeline.push({
+            phase: 'verify',
+            agentId: 'qa-engineer',
+            purpose: 'Verify implementation quality and best practices',
+            optional: false,
+        });
+        requiredReviews.push('qa');
+    }
+    const commitAllowed = resolveCommitAllowed(task, policyResult, config);
+    return { pipeline, commitAllowed, requiredReviews };
+}
+/**
+ * @description Determina si el commit está permitido según el estado del task y las políticas.
+ */
+function resolveCommitAllowed(task, policyResult, config) {
+    if (!config.features.commitGate)
+        return true;
+    if (task.status === 'commit_allowed')
+        return true;
+    if (task.requiresQaApproval && task.status !== 'approved' && task.status !== 'qa_review')
+        return false;
+    if (task.requiresSecurityReview && task.status !== 'approved' && task.status !== 'security_review')
+        return false;
+    if (task.requiresArchitectureReview && task.status !== 'approved' && task.status !== 'design_review')
+        return false;
+    if (!task.requiresQaApproval && !task.requiresSecurityReview && !task.requiresArchitectureReview) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=gate-resolver.js.map

package/dist/orchestration/gate-resolver.js.map

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