agentic-kdd 3.2.3 → 3.5.1

package/bin/akdd.js

@@ -66,6 +66,21 @@ const HELP = `
     akdd creative apply <id>   Apply a suggestion
     akdd creative wins         View applied creative improvements
 
+  Memory (ranked retrieval):
+    akdd recall "query"    Ranked BM25+vector search — replaces full file reads
+    akdd memory stats      Memory retrieval stats (indexed, coverage, mode)
+    akdd memory index      Re-index all .agentic/memoria/*.md files
+    akdd validate scan     Scan all memory for stale/obsolete/poisoned entries
+    akdd validate report   Health report of knowledge base
+    akdd telemetry         Telemetry summary (spans, STOPs, recalls)
+    akdd telemetry view    View last cycle trace (L4 audit trail)
+
+  Autonomous decisions (L4):
+    akdd decide <file>     Analyze a change — STOP/WARN/IMPLEMENT/DEFER decision
+    akdd deferred          View deferred queue (end-of-cycle suggestions)
+    akdd deferred flush    Show and clear deferred queue
+    akdd sprint-plan "obj" Generate sprint plan from business objective
+
   Effectiveness:
     akdd report            Real data — before vs after comparison across all cycles
 
@@ -270,6 +285,47 @@ switch (command) {
     break;
   }
 
+  // ── v3.4: KDD Memory, Knowledge Validator, Telemetry ─────────────────────
+  case 'recall':
+    runModule('kdd-memory.cjs', 'recall', args.slice(1).join(' '));
+    break;
+  case 'memory':
+    const sub = arg1 || 'stats';
+    if (sub === 'index')  runModule('kdd-memory.cjs', 'index');
+    else if (sub === 'sync') runModule('kdd-memory.cjs', 'sync');
+    else runModule('kdd-memory.cjs', 'stats');
+    break;
+  case 'validate':
+    const vsub = arg1 || 'report';
+    if (vsub === 'scan')       runModule('knowledge-validator.cjs', 'scan');
+    else if (vsub === 'report') runModule('knowledge-validator.cjs', 'report');
+    else runModule('knowledge-validator.cjs', 'validate', arg1);
+    break;
+  case 'telemetry':
+    const tsub = arg1 || 'summary';
+    if (tsub === 'view')    runModule('telemetry.cjs', 'view', arg2 || '');
+    else runModule('telemetry.cjs', 'summary');
+    break;
+
+  // ── v3.3: Autonomous Decision Engine ──────────────────────────────────────
+  case 'decide': {
+    const files = args.slice(1);
+    if (!files.length) { console.log('\n  Uso: akdd decide <archivo> [archivos...]\n'); break; }
+    runModule('autonomous-decision.cjs', 'analyze', files.map(f => `"${f}"`).join(' '));
+    break;
+  }
+  case 'deferred': {
+    const sub = arg1 || 'queue';
+    runModule('autonomous-decision.cjs', sub === 'flush' ? 'flush' : 'queue');
+    break;
+  }
+  case 'sprint-plan': {
+    const objective = args.slice(1).join(' ');
+    if (!objective) { console.log('\n  Uso: akdd sprint-plan "objetivo del sprint"\n'); break; }
+    runModule('autonomous-decision.cjs', 'sprint', `--objective "${objective}"`);
+    break;
+  }
+
   // ── v3.3: Effectiveness Report ──────────────────────────────────────────────
   case 'report':
     runModule('effectiveness-report.cjs');

package/collab-manager.cjs

@@ -26,13 +26,42 @@ const PROVISIONER_URL = 'https://agentic-collab.adrianlpz-game.workers.dev';
 
 const COLLAB_CONFIG_PATH = '.agentic/collab.json';
 
+// ─── SYNC TABLES — TODO lo que hace a Agentic L4 ──────────────────────────────
+// Regla: si está aquí, cualquier miembro del equipo que haga collab pull
+// recibe el cerebro completo del proyecto — no solo fragmentos.
+//
+// NO sincronizar:
+//   regression_snapshots  → snapshots de sesión individual, no conocimiento del equipo
+//   working_memory        → buffer de sesión activa, se resetea por diseño
+//   creative_suggestions  → sugerencias personales del dev, no del equipo
+//   git_context_log       → log local de diffs, cada dev tiene su propio git
+//   deferred_queue        → archivo JSON por dev, no tabla compartida
+//
 const SYNC_TABLES = [
-  'nodos',
-  'relaciones_semanticas',
-  'episodios',
-  'knowledge_docs',
-  'ast_symbols',
-  'ast_edges',
+
+  // ── CORE MEMORY (CoALA 4 layers) ───────────────────────────────────────────
+  'nodos',              // Patrones, errores, decisiones con confianza — EL núcleo
+  'episodios',          // Historia cruda de cada ciclo
+  'entidades',          // Módulos, archivos, APIs detectados en el proyecto
+  'relaciones_semanticas', // Causal edges: caused_failure, was_fixed_by, verifies, protects
+
+  // ── CICLOS Y TRAZABILIDAD ──────────────────────────────────────────────────
+  'ciclos',             // Qué se hizo, cuándo, con qué resultado — historial ejecutivo
+  'fases',              // Fases dentro de cada ciclo — granularidad total
+  'knowledge_docs',     // ADRs, gotchas, convenciones — por qué las cosas son como son
+
+  // ── AST GRAPH ─────────────────────────────────────────────────────────────
+  'ast_symbols',        // Símbolos del codebase — estructura completa
+  'ast_edges',          // Relaciones AST — dependencias, imports, call graph
+
+  // ── PRESERVATION INTELLIGENCE ─────────────────────────────────────────────
+  'verified_contracts', // Contratos protegidos — lo que no se puede romper
+  'creative_wins',      // Mejoras aplicadas — el equipo aprende de lo que funcionó
+  'contract_violations',// Violaciones pasadas — el equipo sabe qué rompió qué
+
+  // ── PREDICCIÓN Y CI/CD ────────────────────────────────────────────────────
+  'prediction_log',     // Patrones de riesgo predictivo detectados
+  'cicd_reports',       // Reportes de CI/CD — qué falló en producción
 ];
 
 // ─── DB LOCAL ──────────────────────────────────────────────────────────────────
@@ -346,9 +375,14 @@ async function syncDown(projectRoot) {
         const placeholders = keys.map(() => '?').join(', ');
 
         // Estrategia por tabla:
-        // episodios → INSERT OR IGNORE (son aditivos, no sobrescribir locales)
-        // resto     → INSERT OR REPLACE (toma la versión más reciente)
-        const strategy = table === 'episodios' ? 'OR IGNORE' : 'OR REPLACE';
+        // OR IGNORE: tablas aditivas — no sobrescribir versión local
+        //   episodios, ciclos, fases, prediction_log, cicd_reports
+        //   (cada dev tiene su propia historia de ejecución)
+        // OR REPLACE: tablas de conocimiento compartido — toma la más reciente
+        //   nodos, entidades, relaciones_semanticas, knowledge_docs,
+        //   ast_symbols, ast_edges, verified_contracts, creative_wins, contract_violations
+        const ADDITIVE_TABLES = new Set(['episodios','ciclos','fases','prediction_log','cicd_reports']);
+        const strategy = ADDITIVE_TABLES.has(table) ? 'OR IGNORE' : 'OR REPLACE';
 
         try {
           localDB.prepare(
@@ -420,12 +454,25 @@ async function status(projectRoot) {
 
 function getDateField(table) {
   const fields = {
-    nodos: 'fecha_update',
-    episodios: 'fecha',
-    relaciones_semanticas: 'valid_at',
-    knowledge_docs: 'last_indexed',
-    ast_symbols: 'last_indexed',
-    ast_edges: 'last_indexed',
+    // Core memory
+    nodos:                  'fecha_update',
+    episodios:              'fecha',
+    entidades:              'fecha_update',
+    relaciones_semanticas:  'valid_at',
+    // Ciclos y trazabilidad
+    ciclos:                 'fecha_inicio',
+    fases:                  'fecha',
+    knowledge_docs:         'last_indexed',
+    // AST
+    ast_symbols:            'last_indexed',
+    ast_edges:              'last_indexed',
+    // Preservation Intelligence
+    verified_contracts:     'updated_at',
+    creative_wins:          'created_at',
+    contract_violations:    'created_at',
+    // Predicción y CI/CD
+    prediction_log:         'fecha',
+    cicd_reports:           'fecha',
   };
   return fields[table] || 'rowid';
 }