agentic-kdd 2.1.12 → 3.0.1

package/bin/akdd.js

@@ -1,113 +1,253 @@
 #!/usr/bin/env node
 'use strict';
 
-const { init } = require('../src/init');
-const { update } = require('../src/update');
-const { graph } = require('../src/graph');
+const { init }      = require('../src/init');
+const { update }    = require('../src/update');
+const { graph }     = require('../src/graph');
 const { dashboard } = require('../src/dashboard');
-const { analyze } = require('../src/analyze');
-const pkg = require('../package.json');
+const { analyze }   = require('../src/analyze');
+const pkg  = require('../package.json');
 const path = require('path');
+const fs   = require('fs');
 const { execSync } = require('child_process');
 
-const args = process.argv.slice(2);
+const args    = process.argv.slice(2);
 const command = args[0];
-const arg1 = args[1];
+const arg1    = args[1];
+const arg2    = args[2];
 
 const HELP = `
   Agentic KDD v${pkg.version}
-  Autonomous development pipeline with Knowledge-Driven Development
-
-  Usage:
-    akdd init          Install Agentic KDD in the current project
-    akdd update        Update agents (memory stays intact)
-    akdd analyze       Analyze project code and auto-build knowledge graph
-    akdd graph         Sync memory + show graph stats
-    akdd sync          Sync memory files to SQLite graph
-    akdd stats         Show graph stats and HIGH rules
-    akdd coala         Show CoALA memory stats (procedural + episodic + semantic)
-    akdd metricas      Show agent KPIs (Goal Attainment, Autonomy, etc.)
-    akdd buscar        Hybrid search across all 3 memory layers
-    akdd impacto       Show impact of touching a module/file
-    akdd semantico     Semantic search (needs API key)
-    akdd decay         Apply temporal decay to stale patterns
-    akdd dashboard     Open visual dashboard in browser
-    akdd --version     Show version
-    akdd --help        Show this help
-
-  After init, open the project in Cursor or Claude Code and type:
-    aa: [your task]
+  Autonomous development pipeline — one developer, full-department output.
+
+  Setup:
+    akdd init              Install Agentic KDD in the current project
+    akdd update            Update agents + engine (memory stays intact)
+    akdd health            System health check — what's configured, what's missing
+    akdd health --fix      Auto-fix common issues
+
+  Memory & Knowledge:
+    akdd sync              Sync memory files to SQLite graph
+    akdd graph             Sync + show graph stats
+    akdd stats             Show graph stats and HIGH rules
+    akdd coala             Show CoALA memory stats (4 layers)
+    akdd buscar            Hybrid search across all memory layers
+    akdd impacto           Semantic impact of a module/entity
+    akdd decay             Apply temporal decay to stale patterns
+    akdd audit             Memory audit — stale entries, contradictions, proposals
+    akdd forget <id>       Forget a memory entry with documented reason
+
+  AST & Impact Analysis:
+    akdd ast               Index project AST (symbols, imports, call graph, PageRank)
+    akdd ast stats         Show AST index stats
+    akdd ast symbols <f>   Show symbols in a file
+    akdd ast-impact <f>    Full impact analysis of a file/module
+    akdd why <entity>      Explain why something exists (causal chain)
+
+  Specs & Autonomy:
+    akdd spec list         List all module specs
+    akdd spec <module>     Show spec status + next wave
+    akdd spec create <m>   Create feature spec for a module
+    akdd spec create <m> --bugfix  Create bugfix spec
+
+  Knowledge Base:
+    akdd adr               Ingest ADRs from docs/adr/
+    akdd knowledge         Ingest gotchas/conventions from docs/
+
+  Metrics & Observability:
+    akdd metrics           Project KPIs — success rate, rework, autonomy score
+    akdd metrics trend     Show trend of last 10 cycles
+    akdd trail             Recent decision trails (what changed and why)
+    akdd trail <ciclo_id>  Full trail of a specific cycle
+    akdd trail why <f>     Why does this file/entity exist?
+
+  Intelligence v2.2:
+    akdd git-context       Analyze git diff + risk assessment
+    akdd predict           Predictive risk patterns from episodic memory
+    akdd embed-status      Local embeddings status
+    akdd embed-install     Install local embeddings (~23MB, offline)
+    akdd jina-install      Install jina-v2-code embeddings (~500MB, code-optimized)
+    akdd ci-install        Install GitHub Actions CI/CD workflow
+    akdd ci-status         Show last CI/CD reports
+
+  Dashboard:
+    akdd dashboard         Open visual dashboard in browser
+
+  MCP Server (Cursor / Claude Code):
+    node .agentic/grafo/mcp-server.cjs
+    See: github.com/Adrianlpz211/Agentic-KDD-MCP
+
+  akdd --version / akdd --help
 `;
 
+function findGrafo() {
+  const p = path.join(process.cwd(), '.agentic', 'grafo', 'grafo.cjs');
+  if (!fs.existsSync(p)) { console.log('\n  grafo.cjs not found. Run: akdd update\n'); process.exit(1); }
+  return p;
+}
+
 function runGrafo(cmd, extra) {
-  const grafo = path.join(process.cwd(), '.agentic', 'grafo', 'grafo.cjs');
-  const fs = require('fs');
-  if (!fs.existsSync(grafo)) {
-    console.log('\n  grafo.cjs not found. Run akdd update first.\n');
-    process.exit(1);
-  }
-  try {
-    const out = execSync(`node "${grafo}" ${cmd}${extra?' '+extra:''}`, {
-      stdio: 'inherit', cwd: process.cwd()
-    });
-  } catch(e) {
-    process.exit(1);
-  }
+  const grafo = findGrafo();
+  const fullCmd = extra ? `node "${grafo}" ${cmd} ${extra}` : `node "${grafo}" ${cmd}`;
+  try { execSync(fullCmd, { stdio: 'inherit', cwd: process.cwd() }); }
+  catch(e) { process.exit(e.status || 1); }
+}
+
+function runModule(name, cmd, extra) {
+  const p = path.join(process.cwd(), '.agentic', 'grafo', name);
+  if (!fs.existsSync(p)) { console.log(`\n  ${name} not found. Run: akdd update\n`); process.exit(1); }
+  const fullCmd = [
+    `node "${p}"`,
+    cmd || '',
+    extra || ''
+  ].join(' ').trim().replace(/\s+/g,' ');
+  try { execSync(fullCmd, { stdio: 'inherit', cwd: process.cwd() }); }
+  catch(e) { process.exit(e.status || 1); }
 }
 
 switch (command) {
-  case 'init':
-    init();
+
+  case 'init':    init(); break;
+  case 'update':  update(); break;
+  case 'analyze': analyze(); break;
+
+  // ── v3.0: Health ────────────────────────────────────────────────────────
+  case 'health': {
+    const fixFlag = args.includes('--fix') ? '--fix' : '';
+    runModule('health-check.cjs', fixFlag);
     break;
-  case 'update':
-    update();
+  }
+
+  // ── Core memory ────────────────────────────────────────────────────────
+  case 'sync':    runGrafo('sync'); break;
+  case 'graph':   graph(); break;
+  case 'stats':   runGrafo('stats'); break;
+  case 'coala':   runGrafo('coala'); break;
+  case 'metricas': runGrafo('metricas'); break;
+  case 'decay':   runGrafo('decay'); break;
+
+  case 'buscar':
+    if (!arg1) { console.log('\n  Uso: akdd buscar "query" [area]\n'); break; }
+    runGrafo('buscar', `"${arg1}"${arg2 ? ' ' + arg2 : ''}`);
     break;
-  case 'analyze':
-  case 'analizar':
-    analyze();
+
+  case 'impacto':
+    if (!arg1) { console.log('\n  Uso: akdd impacto "NombreModulo"\n'); break; }
+    runGrafo('impacto', `"${arg1}"`);
     break;
-  case 'graph':
-    graph();
+
+  // ── v3.0: Memory Audit ─────────────────────────────────────────────────
+  case 'audit': runModule('memory-audit.cjs', 'report'); break;
+
+  case 'forget': {
+    if (!arg1) { console.log('\n  Uso: akdd forget <id> "<razón>"\n'); break; }
+    const reason = args.slice(2).join(' ');
+    if (!reason) { console.log('\n  Uso: akdd forget <id> "<razón>"\n'); break; }
+    runModule('memory-audit.cjs', 'forget', `${arg1} "${reason}"`);
     break;
-  case 'sync':
-    runGrafo('sync');
+  }
+
+  // ── v3.0: AST ──────────────────────────────────────────────────────────
+  case 'ast': {
+    const sub = arg1 || 'index';
+    const tgt = arg2 || '';
+    if (sub === 'stats')   runModule('ast-indexer.cjs', 'stats');
+    else if (sub === 'symbols') {
+      if (!tgt) { console.log('\n  Uso: akdd ast symbols <archivo>\n'); break; }
+      runModule('ast-indexer.cjs', 'symbols', `"${tgt}"`);
+    } else {
+      runModule('ast-indexer.cjs', 'index', tgt);
+    }
     break;
-  case 'stats':
-    runGrafo('stats');
+  }
+
+  case 'ast-impact':
+    if (!arg1) { console.log('\n  Uso: akdd ast-impact <archivo_o_módulo>\n'); break; }
+    runModule('impact-analyzer.cjs', 'analyze', `"${arg1}"`);
     break;
-  case 'coala':
-    runGrafo('coala');
+
+  case 'why':
+    if (!arg1) { console.log('\n  Uso: akdd why <archivo_o_entidad>\n'); break; }
+    runModule('decision-trail.cjs', 'why', `"${arg1}"`);
     break;
-  case 'metricas':
-    runGrafo('metricas');
+
+  // ── v3.0: Specs ────────────────────────────────────────────────────────
+  case 'spec': {
+    const sub = arg1;
+    const mod = arg2;
+    if (!sub || sub === 'list')       runModule('spec-manager.cjs', 'list');
+    else if (sub === 'create') {
+      if (!mod) { console.log('\n  Uso: akdd spec create <módulo> [--bugfix]\n'); break; }
+      runModule('spec-manager.cjs', 'create', `"${mod}"${args.includes('--bugfix') ? ' --bugfix' : ''}`);
+    }
+    else if (sub === 'waves')     { if (!mod) { console.log('\n  Uso: akdd spec waves <módulo>\n'); break; } runModule('spec-manager.cjs', 'waves', `"${mod}"`); }
+    else if (sub === 'validate')  { if (!mod) { console.log('\n  Uso: akdd spec validate <módulo>\n'); break; } runModule('spec-manager.cjs', 'validate', `"${mod}"`); }
+    else runModule('spec-manager.cjs', 'status', `"${sub}"`);
     break;
-  case 'semantico':
-    if (!arg1) { console.log('\n  Uso: akdd semantico "tu query"\n'); break; }
-    runGrafo('semantico', `"${arg1}"`);
+  }
+
+  case 'spec-create':
+    if (!arg1) { console.log('\n  Uso: akdd spec-create <módulo> [--bugfix]\n'); break; }
+    runModule('spec-manager.cjs', 'create', `"${arg1}"${args.includes('--bugfix') ? ' --bugfix' : ''}`);
     break;
-  case 'buscar':
-    if (!arg1) { console.log('\n  Uso: akdd buscar "query" [area]\n'); break; }
-    runGrafo('buscar', `"${arg1}"${arg2 ? ' ' + arg2 : ''}`);
+
+  // ── v3.0: Knowledge ────────────────────────────────────────────────────
+  case 'adr':
+    runModule('adr-ingestor.cjs', 'ingest', arg1 || 'docs/adr');
     break;
-  case 'impacto':
-    if (!arg1) { console.log('\n  Uso: akdd impacto "NombreModulo"\n'); break; }
-    runGrafo('impacto', `"${arg1}"`);
+
+  case 'knowledge':
+    runModule('knowledge-ingestor.cjs', 'ingest', arg1 || '');
     break;
-  case 'decay':
-    runGrafo('decay');
+
+  // ── v3.0: Metrics ──────────────────────────────────────────────────────
+  case 'metrics':
+    runModule('metrics.cjs', arg1 || 'summary');
     break;
-  case 'dashboard':
-    dashboard();
+
+  // ── v3.0: Decision Trail ───────────────────────────────────────────────
+  case 'trail': {
+    if (!arg1)                   runModule('decision-trail.cjs', 'recent', '5');
+    else if (arg1 === 'why')     { if (!arg2) { console.log('\n  Uso: akdd trail why <entidad>\n'); break; } runModule('decision-trail.cjs', 'why', `"${arg2}"`); }
+    else if (arg1 === 'timeline'){ if (!arg2) { console.log('\n  Uso: akdd trail timeline <módulo>\n'); break; } runModule('decision-trail.cjs', 'timeline', `"${arg2}"`); }
+    else                         runModule('decision-trail.cjs', 'ciclo', `"${arg1}"`);
     break;
-  case '--version':
-  case '-v':
-    console.log(pkg.version);
+  }
+
+  // ── Dashboard ──────────────────────────────────────────────────────────
+  case 'dashboard': dashboard(); break;
+
+  // ── v2.2: Intelligence ─────────────────────────────────────────────────
+  case 'git-context': runGrafo('git-context', args.includes('--install-hook') ? '--install-hook' : ''); break;
+  case 'predict':     runGrafo('predict'); break;
+  case 'embed-status': runGrafo('embed-status'); break;
+  case 'embed-install': runGrafo('embed-install'); break;
+
+  case 'jina-install':
+    runModule('embeddings.cjs', 'install-jina');
     break;
-  case '--help':
-  case '-h':
-  case undefined:
-    console.log(HELP);
+
+  case 'ci-install': runGrafo('ci-install'); break;
+  case 'ci-status':  runGrafo('ci-status'); break;
+
+  case 'ci-report': {
+    const grafo = path.join(process.cwd(), '.agentic', 'grafo', 'grafo.cjs');
+    if (!fs.existsSync(grafo)) { process.exit(0); }
+    const esExito = args.includes('--success');
+    const outIdx  = args.indexOf('--output');
+    const outFile = outIdx >= 0 ? args[outIdx + 1] : null;
+    const flags   = [esExito ? '--success' : '', outFile ? `--output "${outFile}"` : ''].filter(Boolean).join(' ');
+    try { execSync(`node "${grafo}" ci-report ${flags}`, { stdio: 'inherit', cwd: process.cwd(), timeout: 60000 }); }
+    catch(e) { process.exit(0); }
     break;
+  }
+
+  case '--version': case '-v':
+    console.log(pkg.version); break;
+
+  case '--help': case '-h': case undefined:
+    console.log(HELP); break;
+
   default:
     console.log(`\n  Unknown command: ${command}`);
     console.log('  Run akdd --help for usage\n');

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agentic-kdd",
-  "version": "2.1.12",
-  "description": "Autonomous development pipeline with KDD — aa: · ag: · audit: · Visual Dashboard. Works with Cursor and Claude Code.",
+  "version": "3.0.1",
+  "description": "Autonomous development pipeline — aa: · ag: · audit: · AST graph · Harness · Specs · Impact analysis · Decision trail · Metrics · MCP server. Works with Cursor and Claude Code.",
   "main": "src/index.js",
   "bin": {
     "akdd": "bin/akdd.js"
@@ -21,7 +21,12 @@
     "knowledge-driven",
     "agentic",
     "sqlite",
-    "dashboard"
+    "dashboard",
+    "mcp",
+    "ast",
+    "harness",
+    "specs",
+    "memory"
   ],
   "author": "Adrianlpz211",
   "license": "MIT",