@backendkit-labs/agent-core 0.14.0

package/dist/orchestration/policy-engine.js

@@ -0,0 +1,262 @@
+"use strict";
+/**
+ * @description Policy Engine — Motor de reglas para el orquestador.
+ *
+ * Evalúa reglas contra un TaskContext y determina:
+ * - Qué agentes deben participar obligatoriamente
+ * - Qué gates son obligatorios
+ * - Qué skills deben ejecutarse
+ *
+ * Las reglas se cargan desde ~/.deepseek-code/policy-rules.yaml
+ * y se complementan con reglas built-in por defecto.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluatePolicies = evaluatePolicies;
+exports.applyPolicies = applyPolicies;
+// ── Reglas built-in por defecto ──────────────────────────────────────────────
+const DEFAULT_RULES = [
+    // Si es diseño → architecture-agent obligatorio
+    {
+        if: { actionType: 'design' },
+        then: {
+            mustInclude: ['architecture'],
+            requireArchitectureReview: true,
+        },
+    },
+    // Si es security_audit → security-agent obligatorio
+    {
+        if: { actionType: 'security_audit' },
+        then: {
+            mustInclude: ['security'],
+            requireSecurityReview: true,
+        },
+    },
+    // Si riskLevel es high o critical → QA obligatorio
+    {
+        if: { riskLevel: ['high', 'critical'] },
+        then: {
+            mustInclude: ['qa-engineer'],
+            requireQaApproval: true,
+        },
+    },
+    // Si riskLevel es critical → architecture review obligatorio
+    {
+        if: { riskLevel: 'critical' },
+        then: {
+            mustInclude: ['architecture'],
+            requireArchitectureReview: true,
+        },
+    },
+    // Si el dominio es security → security-agent obligatorio
+    {
+        if: { domain: 'security' },
+        then: {
+            mustInclude: ['security'],
+            requireSecurityReview: true,
+        },
+    },
+    // Si hay breaking change → architecture review obligatorio
+    {
+        if: { riskFactor: { breaking_change: true } },
+        then: {
+            mustInclude: ['architecture'],
+            requireArchitectureReview: true,
+        },
+    },
+    // Si es security_sensitive → security-agent obligatorio
+    {
+        if: { riskFactor: { security_sensitive: true } },
+        then: {
+            mustInclude: ['security'],
+            requireSecurityReview: true,
+        },
+    },
+    // Si es cross_service_impact → architecture review
+    {
+        if: { riskFactor: { cross_service_impact: true } },
+        then: {
+            mustInclude: ['architecture'],
+            requireArchitectureReview: true,
+        },
+    },
+    // Si es db_transactional → QA review
+    {
+        if: { riskFactor: { db_transactional: true } },
+        then: {
+            requireQaApproval: true,
+        },
+    },
+    // Si es test → QA como agente principal
+    {
+        if: { actionType: 'test' },
+        then: {
+            mustInclude: ['qa-engineer'],
+        },
+    },
+    // Si es refactor → QA review
+    {
+        if: { actionType: 'refactor' },
+        then: {
+            requireQaApproval: true,
+        },
+    },
+];
+/**
+ * @description Evalúa todas las reglas contra un TaskContext.
+ *
+ * Las reglas personalizadas (de ~/.deepseek-code/policy-rules.yaml)
+ * tienen prioridad sobre las built-in. Si una regla personalizada
+ * coincide, se aplica en lugar de la built-in equivalente.
+ *
+ * @param task - TaskContext enriquecido con actionType, domains, riskLevel
+ * @param customRules - Reglas personalizadas (opcional, desde config)
+ * @returns Políticas aplicadas: agentes, gates y skills obligatorios
+ */
+function evaluatePolicies(task, customRules, userInput = '') {
+    const rules = [...DEFAULT_RULES, ...(customRules ?? [])];
+    const mustInclude = new Set();
+    const requiredGates = new Set();
+    const mustExecute = new Set();
+    const appliedRules = [];
+    for (const rule of rules) {
+        if (matchesCondition(task, rule.if, userInput)) {
+            // Aplicar acción
+            if (rule.then.mustInclude) {
+                for (const agent of rule.then.mustInclude) {
+                    mustInclude.add(agent);
+                }
+            }
+            if (rule.then.mustPass) {
+                for (const gate of rule.then.mustPass) {
+                    if (gate === 'qa')
+                        requiredGates.add('qa');
+                    if (gate === 'security')
+                        requiredGates.add('security');
+                    if (gate === 'architecture')
+                        requiredGates.add('architecture');
+                }
+            }
+            if (rule.then.mustExecute) {
+                for (const skill of rule.then.mustExecute) {
+                    mustExecute.add(skill);
+                }
+            }
+            if (rule.then.requireArchitectureReview) {
+                requiredGates.add('architecture');
+            }
+            if (rule.then.requireSecurityReview) {
+                requiredGates.add('security');
+            }
+            if (rule.then.requireQaApproval) {
+                requiredGates.add('qa');
+            }
+            // Registrar regla aplicada
+            const reason = buildRuleReason(rule.if);
+            appliedRules.push({ rule: reason, reason });
+        }
+    }
+    return {
+        mustInclude: [...mustInclude],
+        requiredGates: [...requiredGates],
+        mustExecute: [...mustExecute],
+        appliedRules,
+    };
+}
+/**
+ * Verifica si un TaskContext cumple con una condición.
+ * userInput es el texto original del usuario — necesario para keywords matching.
+ */
+function matchesCondition(task, condition, userInput = '') {
+    // Verificar actionType
+    if (condition.actionType) {
+        const types = Array.isArray(condition.actionType)
+            ? condition.actionType
+            : [condition.actionType];
+        if (!types.includes(task.actionType))
+            return false;
+    }
+    // Verificar riskLevel
+    if (condition.riskLevel) {
+        const levels = Array.isArray(condition.riskLevel)
+            ? condition.riskLevel
+            : [condition.riskLevel];
+        if (!levels.includes(task.riskLevel))
+            return false;
+    }
+    // Verificar domain
+    if (condition.domain) {
+        const domains = Array.isArray(condition.domain)
+            ? condition.domain
+            : [condition.domain];
+        const hasDomain = domains.some(d => task.domains.includes(d));
+        if (!hasDomain)
+            return false;
+    }
+    // Verificar riskFactor
+    if (condition.riskFactor) {
+        for (const [factor, value] of Object.entries(condition.riskFactor)) {
+            const taskValue = task.riskFactors[factor];
+            if (taskValue !== value)
+                return false;
+        }
+    }
+    // Verificar keywords en el mensaje original del usuario (OR logic, case-insensitive)
+    if (condition.keywords?.length) {
+        const msg = userInput.toLowerCase();
+        const matches = condition.keywords.some(kw => msg.includes(kw.toLowerCase()));
+        if (!matches)
+            return false;
+    }
+    return true;
+}
+/**
+ * Construye una descripción legible de la regla aplicada.
+ */
+function buildRuleReason(condition) {
+    const parts = [];
+    if (condition.actionType) {
+        const types = Array.isArray(condition.actionType)
+            ? condition.actionType.join(' | ')
+            : condition.actionType;
+        parts.push(`actionType=${types}`);
+    }
+    if (condition.riskLevel) {
+        const levels = Array.isArray(condition.riskLevel)
+            ? condition.riskLevel.join(' | ')
+            : condition.riskLevel;
+        parts.push(`riskLevel=${levels}`);
+    }
+    if (condition.domain) {
+        const domains = Array.isArray(condition.domain)
+            ? condition.domain.join(' | ')
+            : condition.domain;
+        parts.push(`domain=${domains}`);
+    }
+    if (condition.riskFactor) {
+        for (const [k, v] of Object.entries(condition.riskFactor)) {
+            parts.push(`${k}=${v}`);
+        }
+    }
+    if (condition.keywords?.length) {
+        parts.push(`keywords=[${condition.keywords.join(', ')}]`);
+    }
+    return parts.length > 0 ? parts.join(', ') : 'regla generica';
+}
+/**
+ * @description Aplica políticas a un TaskContext y produce un resultado completo.
+ * Es el entry point principal para el orquestador.
+ */
+function applyPolicies(task, customRules, userInput = '') {
+    const result = evaluatePolicies(task, customRules, userInput);
+    // Enriquecer task con los resultados
+    const enrichedTask = {
+        ...task,
+        assignedAgents: [...new Set([...task.assignedAgents, ...result.mustInclude])],
+        requiresArchitectureReview: task.requiresArchitectureReview || result.requiredGates.includes('architecture'),
+        requiresSecurityReview: task.requiresSecurityReview || result.requiredGates.includes('security'),
+        requiresQaApproval: task.requiresQaApproval || result.requiredGates.includes('qa'),
+        updatedAt: new Date(),
+    };
+    return { task: enrichedTask, result };
+}
+//# sourceMappingURL=policy-engine.js.map

package/dist/orchestration/policy-engine.js.map

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

package/dist/orchestration/risk-scorer.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @description Risk Scorer — Calcula el nivel de riesgo técnico de una tarea.
+ *
+ * Evalúa múltiples factores (breaking change, seguridad, impacto entre
+ * servicios, transaccionalidad, criticidad en producción) y produce
+ * un score numérico [0-100] que determina el riskLevel.
+ *
+ * El score se usa en el Policy Engine para decidir qué gates son
+ * obligatorios y qué agentes deben participar.
+ */
+import { RiskFactors, RiskLevel, TaskContext } from './task-context';
+import { OrchestratorConfig } from './types';
+export interface RiskScoreResult {
+    riskLevel: RiskLevel;
+    riskFactors: RiskFactors;
+    totalScore: number;
+    breakdown: Array<{
+        factor: string;
+        score: number;
+        weight: number;
+    }>;
+}
+/**
+ * @description Calcula el nivel de riesgo de una tarea basado en el input.
+ *
+ * Analiza el texto del usuario para detectar factores de riesgo y
+ * calcula un score ponderado usando los pesos de la configuración.
+ *
+ * @param input - Texto del usuario
+ * @param config - Configuración del orquestador (opcional)
+ * @returns RiskScoreResult con nivel, factores y desglose
+ */
+export declare function calculateRisk(input: string, config?: OrchestratorConfig): RiskScoreResult;
+/**
+ * @description Enriquce un TaskContext con el riesgo calculado.
+ */
+export declare function enrichTaskWithRisk(task: TaskContext, config?: OrchestratorConfig): TaskContext;
+//# sourceMappingURL=risk-scorer.d.ts.map

package/dist/orchestration/risk-scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk-scorer.d.ts","sourceRoot":"","sources":["../../src/orchestration/risk-scorer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAA6B,MAAM,SAAS,CAAC;AA2DxE,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrE;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,kBAAkB,GAC1B,eAAe,CA4DjB;AAYD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,WAAW,EACjB,MAAM,CAAC,EAAE,kBAAkB,GAC1B,WAAW,CAWb"}

package/dist/orchestration/risk-scorer.js

@@ -0,0 +1,145 @@
+"use strict";
+/**
+ * @description Risk Scorer — Calcula el nivel de riesgo técnico de una tarea.
+ *
+ * Evalúa múltiples factores (breaking change, seguridad, impacto entre
+ * servicios, transaccionalidad, criticidad en producción) y produce
+ * un score numérico [0-100] que determina el riskLevel.
+ *
+ * El score se usa en el Policy Engine para decidir qué gates son
+ * obligatorios y qué agentes deben participar.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateRisk = calculateRisk;
+exports.enrichTaskWithRisk = enrichTaskWithRisk;
+const types_1 = require("./types");
+const keyword_match_1 = require("./keyword-match");
+const RISK_KEYWORDS = [
+    // breaking_change
+    { words: ['breaking change', 'breaking', 'rompe', 'incompatible'], factor: 'breaking_change', increment: 1 },
+    { words: ['migrar', 'migración', 'migracion', 'cambiar api'], factor: 'breaking_change', increment: 1 },
+    { words: ['deprecar', 'deprecated', 'obsoleto'], factor: 'breaking_change', increment: 1 },
+    { words: ['renombrar', 'rename', 'cambiar nombre'], factor: 'breaking_change', increment: 1 },
+    // security_sensitive
+    { words: ['token', 'jwt', 'contraseña', 'password', 'secreto'], factor: 'security_sensitive', increment: 1 },
+    { words: ['autenticación', 'autenticacion', 'login', 'register'], factor: 'security_sensitive', increment: 1 },
+    { words: ['autorización', 'autorizacion', 'permiso', 'rol'], factor: 'security_sensitive', increment: 1 },
+    { words: ['datos sensibles', 'pii', 'privacidad', 'gdpr'], factor: 'security_sensitive', increment: 1 },
+    { words: ['cifrado', 'encriptar', 'hash', 'bcrypt'], factor: 'security_sensitive', increment: 1 },
+    { words: ['api key', 'apikey', 'secret'], factor: 'security_sensitive', increment: 1 },
+    // cross_service_impact
+    { words: ['microservicio', 'servicio externo', 'otro servicio'], factor: 'cross_service_impact', increment: 1 },
+    { words: ['api externa', 'integración', 'integracion', 'tercero'], factor: 'cross_service_impact', increment: 1 },
+    { words: ['webhook', 'callback', 'evento', 'event'], factor: 'cross_service_impact', increment: 1 },
+    { words: ['saga', 'orquestación', 'coreografía'], factor: 'cross_service_impact', increment: 1 },
+    // db_transactional
+    { words: ['base de datos', 'bd', 'database', 'db'], factor: 'db_transactional', increment: 1 },
+    { words: ['migración', 'migracion', 'schema', 'esquema', 'tabla'], factor: 'db_transactional', increment: 1 },
+    { words: ['transacción', 'transaccion', 'transaction', 'rollback'], factor: 'db_transactional', increment: 1 },
+    { words: ['consulta', 'query', 'join', 'índice', 'indice'], factor: 'db_transactional', increment: 1 },
+    { words: ['modelo de datos', 'entidad', 'entity', 'relación'], factor: 'db_transactional', increment: 1 },
+    // production_critical
+    { words: ['producción', 'produccion', 'production', 'prod'], factor: 'production_critical', increment: 1 },
+    { words: ['deploy', 'despliegue', 'release', 'lanzar'], factor: 'production_critical', increment: 1 },
+    { words: ['crítico', 'critico', 'urgente', 'emergencia'], factor: 'production_critical', increment: 1 },
+    { words: ['rollback', 'hotfix', 'parche'], factor: 'production_critical', increment: 1 },
+];
+// ── Complexity keywords ──────────────────────────────────────────────────────
+const COMPLEXITY_KEYWORDS = [
+    { words: ['simple', 'sencillo', 'fácil', 'trivial', 'pequeño'], level: 1 },
+    { words: ['medio', 'moderado', 'normal', 'estándar'], level: 4 },
+    { words: ['complejo', 'complicado', 'difícil', 'elaborado'], level: 7 },
+    { words: ['muy complejo', 'altamente', 'sofisticado', 'crítico'], level: 10 },
+];
+/**
+ * @description Calcula el nivel de riesgo de una tarea basado en el input.
+ *
+ * Analiza el texto del usuario para detectar factores de riesgo y
+ * calcula un score ponderado usando los pesos de la configuración.
+ *
+ * @param input - Texto del usuario
+ * @param config - Configuración del orquestador (opcional)
+ * @returns RiskScoreResult con nivel, factores y desglose
+ */
+function calculateRisk(input, config) {
+    const cfg = config ?? (0, types_1.defaultOrchestratorConfig)();
+    const lower = input.toLowerCase();
+    // 1. Detectar factores de riesgo por keywords
+    const factors = {
+        breaking_change: false,
+        security_sensitive: false,
+        cross_service_impact: false,
+        db_transactional: false,
+        production_critical: false,
+        complexity: 1,
+    };
+    const usedTerms = new Set();
+    for (const rk of RISK_KEYWORDS) {
+        for (const word of rk.words) {
+            if (!usedTerms.has(word) && (0, keyword_match_1.matchesKeyword)(lower, word)) {
+                usedTerms.add(word);
+                if (rk.factor === 'complexity') {
+                    factors.complexity = Math.min(10, factors.complexity + rk.increment);
+                }
+                else {
+                    factors[rk.factor] = true;
+                }
+                break;
+            }
+        }
+    }
+    // 2. Detectar nivel de complejidad
+    for (const ck of COMPLEXITY_KEYWORDS) {
+        for (const word of ck.words) {
+            if ((0, keyword_match_1.matchesKeyword)(lower, word)) {
+                factors.complexity = Math.max(factors.complexity, ck.level);
+                break;
+            }
+        }
+    }
+    // 3. Calcular score ponderado
+    const breakdown = [];
+    let totalScore = 0;
+    for (const [factor, value] of Object.entries(factors)) {
+        const weight = cfg.riskWeights[factor] ?? 0;
+        const score = typeof value === 'boolean' ? (value ? weight : 0) : value * (cfg.riskWeights.complexity ?? 1);
+        totalScore += score;
+        breakdown.push({ factor, score, weight });
+    }
+    // 4. Determinar nivel de riesgo
+    const riskLevel = getRiskLevel(totalScore, cfg);
+    return {
+        riskLevel,
+        riskFactors: factors,
+        totalScore,
+        breakdown,
+    };
+}
+/**
+ * Determina el nivel de riesgo basado en el score total.
+ */
+function getRiskLevel(score, config) {
+    if (score >= config.riskThresholds.critical)
+        return 'critical';
+    if (score >= config.riskThresholds.high)
+        return 'high';
+    if (score >= config.riskThresholds.medium)
+        return 'medium';
+    return 'low';
+}
+/**
+ * @description Enriquce un TaskContext con el riesgo calculado.
+ */
+function enrichTaskWithRisk(task, config) {
+    const result = calculateRisk(task.rawPrompt, config);
+    return {
+        ...task,
+        riskLevel: result.riskLevel,
+        riskFactors: result.riskFactors,
+        requiresArchitectureReview: result.riskLevel === 'critical' || result.riskLevel === 'high',
+        requiresSecurityReview: result.riskFactors.security_sensitive,
+        requiresQaApproval: result.riskLevel === 'high' || result.riskLevel === 'critical',
+        updatedAt: new Date(),
+    };
+}
+//# sourceMappingURL=risk-scorer.js.map

package/dist/orchestration/risk-scorer.js.map

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

package/dist/orchestration/task-context.d.ts

@@ -0,0 +1,195 @@
+/**
+ * @description TaskContext — Esquema formal de tarea para el orquestador.
+ *
+ * Transforma texto libre del usuario en una estructura tipada que el sistema
+ * puede procesar con políticas, scoring y routing deterministas.
+ *
+ * Cada tarea pasa por: Intent Detection → Domain Detection → Risk Scoring
+ * → Policy Engine → Agent Routing → FSM.
+ *
+ * @see {@link https://agentskills.io/specification} para el estándar de skills
+ */
+/**
+ * Tipos de acción que el sistema puede clasificar.
+ * Cada acción define qué tipo de procesamiento se necesita.
+ */
+export type ActionType = 'design' | 'implementation' | 'review' | 'security_audit' | 'documentation' | 'refactor' | 'bugfix' | 'test' | 'research' | 'optimize' | 'deploy' | 'unknown';
+export type RiskLevel = 'low' | 'medium' | 'high' | 'critical';
+export type TaskStatus = 'new' | 'classified' | 'design_review' | 'implementation' | 'security_review' | 'qa_review' | 'rework_required' | 'approved' | 'commit_allowed' | 'rejected' | 'commit_planning' | 'commit_reviewing' | 'commit_validated' | 'commit_rejected' | 'commit_failed' | 'commit_skipped';
+export type ConventionalCommitType = 'feat' | 'fix' | 'refactor' | 'test' | 'docs' | 'chore' | 'style' | 'perf' | 'ci' | 'build' | 'revert';
+export interface CommitPlan {
+    /** Tipo de commit convencional */
+    type: ConventionalCommitType;
+    /** Scope basado en el módulo afectado (ej: 'orchestrator', 'cli', 'fsm') */
+    scope: string;
+    /** Descripción corta en imperativo (< 72 chars) */
+    description: string;
+    /** Cuerpo opcional con detalles */
+    body?: string;
+    /** Si es breaking change */
+    breaking: boolean;
+}
+export interface RiskFactors {
+    /** Cambia APIs públicas o contratos existentes */
+    breaking_change: boolean;
+    /** Afecta autenticación, autorización, datos sensibles */
+    security_sensitive: boolean;
+    /** Impacta múltiples servicios */
+    cross_service_impact: boolean;
+    /** Modifica esquemas de base de datos o consultas transaccionales */
+    db_transactional: boolean;
+    /** Afecta código en producción */
+    production_critical: boolean;
+    /** Complejidad estimada (1-10) */
+    complexity: number;
+}
+/**
+ * @description Representación formal de una tarea del usuario.
+ *
+ * El orquestador convierte el input del usuario en un TaskContext
+ * que luego es procesado por el Policy Engine, Capability Matrix
+ * y FSM para determinar qué agentes participan y qué gates aplicar.
+ *
+ * @example
+ * ```ts
+ * const task: TaskContext = {
+ *   taskId: 'task_abc123',
+ *   rawPrompt: 'Agregar circuit breaker para ServiceNow',
+ *   actionType: 'implementation',
+ *   domains: ['resilience', 'backend', 'integration'],
+ *   riskLevel: 'high',
+ *   riskFactors: {
+ *     breaking_change: false,
+ *     security_sensitive: false,
+ *     cross_service_impact: true,
+ *     db_transactional: false,
+ *     production_critical: true,
+ *     complexity: 7,
+ *   },
+ *   requiresArchitectureReview: true,
+ *   requiresSecurityReview: false,
+ *   requiresQaApproval: true,
+ *   targetServices: ['api-gateway', 'snowq-service'],
+ *   relatedPatterns: ['circuit-breaker', 'retry-backoff'],
+ *   status: 'new',
+ *   assignedAgents: [],
+ * };
+ * ```
+ */
+export interface TaskContext {
+    /** ID único de la tarea */
+    taskId: string;
+    /** Prompt original del usuario */
+    rawPrompt: string;
+    /** Tipo de acción clasificada */
+    actionType: ActionType;
+    /** Dominios detectados (bounded contexts) */
+    domains: string[];
+    /** Nivel de riesgo calculado */
+    riskLevel: RiskLevel;
+    /** Factores de riesgo detallados */
+    riskFactors: RiskFactors;
+    /** Indica si requiere revisión de arquitectura */
+    requiresArchitectureReview: boolean;
+    /** Indica si requiere revisión de seguridad */
+    requiresSecurityReview: boolean;
+    /** Indica si requiere aprobación de QA */
+    requiresQaApproval: boolean;
+    /** Servicios objetivo (si se detectan) */
+    targetServices: string[];
+    /** Patrones relacionados del vault */
+    relatedPatterns: string[];
+    /** Estado actual en la FSM */
+    status: TaskStatus;
+    /** Agentes asignados a la tarea */
+    assignedAgents: string[];
+    /** Archivos relevantes detectados para la tarea */
+    relevantFiles?: string[];
+    /** Plan de commit generado por Architecture agent */
+    commitPlan?: CommitPlan;
+    /** Timestamp de creación */
+    createdAt: Date;
+    /** Timestamp de última actualización */
+    updatedAt: Date;
+}
+/**
+ * @description Solicitud de delegación estructurada entre agentes.
+ * Reemplaza el mecanismo plano de ask_agent con un handoff formal
+ * que incluye contexto, entregables esperados y timeout.
+ */
+export interface DelegationRequest {
+    /** ID único de la solicitud de delegación */
+    requestId: string;
+    /** ID del agente que delega (origen) */
+    fromAgentId: string;
+    /** ID del agente especialista (destino) */
+    toAgentId: string;
+    /** Contexto compartido con el especialista */
+    context: {
+        taskId: string;
+        question: string;
+        relevantFiles: string[];
+        previousDelegations?: DelegationResult[];
+    };
+    /** Momento en que se crea la solicitud */
+    timestamp: Date;
+    /** Timeout en ms para considerar fallo (default: 30000) */
+    timeoutMs: number;
+    /** Profundidad de delegación (0 = primera delegación). Máximo permitido: 3 */
+    hopCount?: number;
+}
+/**
+ * @description Resultado de una delegación ejecutada por un agente especialista.
+ * Incluye el contenido de la respuesta y un sello de completitud
+ * que garantiza que el especialista terminó su análisis.
+ */
+export interface DelegationResult {
+    /** Mismo requestId que la solicitud */
+    requestId: string;
+    /** ID del agente que ejecutó (destino) */
+    agentId: string;
+    /** Resultado textual del especialista */
+    result: string;
+    /** Sello de completitud */
+    completionStamp: {
+        status: 'completed' | 'partial' | 'failed';
+        summary: string;
+        suggestedFollowUp?: string;
+        filesTouched: string[];
+    };
+    /** Momento en que se completó */
+    completedAt: Date;
+    /** Si hubo error, descripción */
+    error?: string;
+}
+/**
+ * @description Detecta el scope del commit a partir de los archivos staged.
+ * Analiza las rutas de los archivos y determina el módulo afectado.
+ *
+ * @param stagedFiles - Lista de rutas de archivos staged
+ * @returns Scope detectado (ej: 'cli', 'orchestrator', 'api', etc.)
+ *
+ * @example
+ * ```ts
+ * detectScopeFromFiles(['bin/cli.ts', 'src/ui/formatters.ts']);
+ * // → 'cli'
+ *
+ * detectScopeFromFiles(['src/orchestrator/fsm.ts', 'src/types/task-context.ts']);
+ * // → 'core'
+ * ```
+ */
+export declare function detectScopeFromFiles(stagedFiles: string[]): string;
+/**
+ * Crea un TaskContext con valores por defecto.
+ * Útil para tests y para inicializar desde el detector de intents.
+ */
+export declare function createTaskContext(rawPrompt: string): TaskContext;
+/**
+ * Actualiza el timestamp de una tarea.
+ */
+export declare function touchTask(task: TaskContext): TaskContext;
+/**
+ * Cambia el estado de una tarea y actualiza timestamp.
+ */
+export declare function transitionTask(task: TaskContext, newStatus: TaskStatus): TaskContext;
+//# sourceMappingURL=task-context.d.ts.map