agentic-kdd 2.2.13 → 3.0.1

package/bin/akdd.js

@@ -1,14 +1,14 @@
 #!/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 fs   = require('fs');
 const { execSync } = require('child_process');
 
 const args    = process.argv.slice(2);
@@ -18,92 +18,113 @@ const arg2    = args[2];
 
 const HELP = `
   Agentic KDD v${pkg.version}
-  Autonomous development pipeline with Knowledge-Driven Development
+  Autonomous development pipeline — one developer, full-department output.
 
-  Usage:
+  Setup:
     akdd init              Install Agentic KDD in the current project
     akdd update            Update agents + engine (memory stays intact)
-    akdd analyze           Analyze project code and auto-build knowledge graph
+    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 memory + show graph stats
+    akdd graph             Sync + show graph stats
     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 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 dashboard         Open visual dashboard in browser
+    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 from episodic memory
-    akdd predict           Show predictive patterns detected from episodic memory
-    akdd embed-status      Check local embeddings status (all-MiniLM-L6-v2)
-    akdd embed-install     Install local embeddings (~23MB, 100% offline)
-    akdd ci-install        Install GitHub Actions workflow for auto CI/CD memory
-    akdd ci-status         Show last CI/CD reports stored in memory
-    akdd ci-report         Report CI result to memory (called by CI workflow)
-
-  akdd --version           Show version
-  akdd --help              Show this help
-
-  After init, open the project in Cursor or Claude Code and type:
-    aa: [your task]
+    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);
-  }
+  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 = findGrafo();
-  try {
-    execSync(`node "${grafo}" ${cmd}${extra ? ' ' + extra : ''}`, {
-      stdio: 'inherit', cwd: process.cwd()
-    });
-  } catch(e) { process.exit(1); }
+  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 runGrafoPipe(cmd, extra) {
-  const grafo = findGrafo();
-  try {
-    return execSync(`node "${grafo}" ${cmd}${extra ? ' ' + extra : ''}`, {
-      stdio: 'pipe', cwd: process.cwd()
-    }).toString();
-  } catch(e) { return ''; }
+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) {
 
-  // ── Comandos existentes ─────────────────────────────────────────────────────
-  case 'init':
-    init(); break;
-
-  case 'update':
-    update(); break;
-
-  case 'analyze':
-  case 'analizar':
-    analyze(); break;
+  case 'init':    init(); break;
+  case 'update':  update(); break;
+  case 'analyze': analyze(); break;
 
-  case 'graph':
-    graph(); break;
-
-  case 'sync':
-    runGrafo('sync'); break;
-
-  case 'stats':
-    runGrafo('stats'); break;
-
-  case 'coala':
-    runGrafo('coala'); break;
+  // ── v3.0: Health ────────────────────────────────────────────────────────
+  case 'health': {
+    const fixFlag = args.includes('--fix') ? '--fix' : '';
+    runModule('health-check.cjs', fixFlag);
+    break;
+  }
 
-  case 'metricas':
-    runGrafo('metricas'); break;
+  // ── 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; }
@@ -115,81 +136,117 @@ switch (command) {
     runGrafo('impacto', `"${arg1}"`);
     break;
 
-  case 'decay':
-    runGrafo('decay'); break;
+  // ── v3.0: Memory Audit ─────────────────────────────────────────────────
+  case 'audit': runModule('memory-audit.cjs', 'report'); break;
 
-  case 'dashboard':
-    dashboard(); break;
-
-  // ── v2.2: Intelligence features ────────────────────────────────────────────
-
-  case 'git-context': {
-    if (args.includes('--install-hook')) {
-      runGrafo('git-context', '--install-hook');
-      break;
-    }
-    runGrafo('git-context');
+  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 'predict': {
-    runGrafo('predict');
+  // ── 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 'embed-status': {
-    runGrafo('embed-status');
+  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 'embed-install': {
-    runGrafo('embed-install');
+  case 'why':
+    if (!arg1) { console.log('\n  Uso: akdd why <archivo_o_entidad>\n'); break; }
+    runModule('decision-trail.cjs', 'why', `"${arg1}"`);
     break;
-  }
 
-  case 'ci-install': {
-    runGrafo('ci-install');
+  // ── 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 'ci-status': {
-    runGrafo('ci-status');
+  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 'ci-report': {
-    // Llamado por GitHub Actions — no interrumpir el CI si falla
-    const grafo = path.join(process.cwd(), '.agentic', 'grafo', 'grafo.cjs');
-    if (!fs.existsSync(grafo)) { process.exit(0); }
+  // ── v3.0: Knowledge ────────────────────────────────────────────────────
+  case 'adr':
+    runModule('adr-ingestor.cjs', 'ingest', arg1 || 'docs/adr');
+    break;
 
-    const esExito    = args.includes('--success');
-    const outputIdx  = args.indexOf('--output');
-    const outputFile = outputIdx >= 0 ? args[outputIdx + 1] : null;
+  case 'knowledge':
+    runModule('knowledge-ingestor.cjs', 'ingest', arg1 || '');
+    break;
 
-    const flags = [
-      esExito    ? '--success'          : '',
-      outputFile ? `--output "${outputFile}"` : ''
-    ].filter(Boolean).join(' ');
+  // ── v3.0: Metrics ──────────────────────────────────────────────────────
+  case 'metrics':
+    runModule('metrics.cjs', arg1 || 'summary');
+    break;
 
-    try {
-      execSync(`node "${grafo}" ci-report ${flags}`, {
-        stdio: 'inherit', cwd: process.cwd(), timeout: 60000
-      });
-    } catch(e) { process.exit(0); } // no fallar el CI
+  // ── 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;
   }
 
-  // ── Meta ────────────────────────────────────────────────────────────────────
-  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}`);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agentic-kdd",
-  "version": "2.2.13",
-  "description": "Autonomous development pipeline with KDD — aa: · ag: · audit: · Git Context · Prediction · Local Embeddings · CI/CD. 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",