agentic-kdd 3.2.1 → 3.2.2

package/bin/akdd.js

@@ -66,6 +66,10 @@ const HELP = `
     akdd creative apply <id>   Apply a suggestion
     akdd creative wins         View applied creative improvements
 
+  Session continuity:
+    akdd historial         Resume context in a new chat — paste output at start
+    akdd checkpoint        Save checkpoint now (auto-runs every 5 cycles)
+
   Memory Governance (v3.2):
     akdd cure              Run MemCurator — TTL, dedup, conflicts, scores
     akdd cure report       Preview what curation would do (no changes)
@@ -263,6 +267,14 @@ switch (command) {
     break;
   }
 
+  // ── v3.3: Session Guard ────────────────────────────────────────────────────
+  case 'historial':
+    runModule('session-guard.cjs', 'historial');
+    break;
+  case 'checkpoint':
+    runModule('session-guard.cjs', 'checkpoint');
+    break;
+
   // ── v3.2: MemCurator ───────────────────────────────────────────────────────
   case 'cure': {
     const sub = arg1 || 'run';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-kdd",
-  "version": "3.2.1",
+  "version": "3.2.2",
   "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": {

package/session-guard.cjs

@@ -0,0 +1,265 @@
+/**
+ * Agentic KDD — Session Guard v1.0
+ *
+ * Problema que resuelve:
+ *   - Cursor se cierra y pierdes el hilo
+ *   - Cambias de PC y empiezas chat nuevo
+ *   - No recuerdas en qué ibas exactamente
+ *
+ * Solución:
+ *   - Cada 5 ciclos aa: guarda un checkpoint en .agentic/checkpoint.md
+ *   - akdd historial muestra el checkpoint listo para pegar en el chat nuevo
+ *   - El chat nuevo recupera el contexto exacto de donde se quedó
+ *
+ * Uso:
+ *   node session-guard.cjs checkpoint   — genera checkpoint ahora
+ *   node session-guard.cjs historial    — muestra el último checkpoint
+ *   node session-guard.cjs status       — cuántos ciclos hasta el próximo checkpoint
+ */
+
+'use strict';
+
+const path = require('path');
+const fs   = require('fs');
+
+const CHECKPOINT_EVERY = 5;
+const CHECKPOINT_PATH  = '.agentic/checkpoint.md';
+const COUNTER_KEY      = 'session_guard_cycle_count';
+
+// ─── DB ───────────────────────────────────────────────────────────────────────
+
+function openDB(projectRoot) {
+  const dbPath = path.join(projectRoot, '.agentic/memoria.db');
+  try { return new (require('better-sqlite3'))(dbPath); } catch {}
+  try { const { DatabaseSync } = require('node:sqlite'); return new DatabaseSync(dbPath); } catch {}
+  return null;
+}
+
+// ─── LEER CICLOS RECIENTES ────────────────────────────────────────────────────
+
+function getRecentCycles(db, limit = 5) {
+  try {
+    return db.prepare(`
+      SELECT ciclo_id, descripcion, tipo, estado, fecha_inicio, fecha_fin,
+             tests_corridos, patrones_aplicados, errores_encontrados, fases_completadas
+      FROM ciclos
+      ORDER BY fecha_inicio DESC
+      LIMIT ?
+    `).all(limit);
+  } catch { return []; }
+}
+
+function getProjectStats(db) {
+  try {
+    const nodes    = db.prepare("SELECT COUNT(*) as n FROM nodos WHERE estado='ACTIVO'").get()?.n || 0;
+    const high     = db.prepare("SELECT COUNT(*) as n FROM nodos WHERE confianza='ALTA' AND estado='ACTIVO'").get()?.n || 0;
+    const cycles   = db.prepare("SELECT COUNT(*) as n FROM ciclos").get()?.n || 0;
+    const stops    = db.prepare("SELECT COUNT(*) as n FROM ciclos WHERE estado='STOP'").get()?.n || 0;
+    const errors   = db.prepare("SELECT COUNT(*) as n FROM nodos WHERE tipo='error' AND estado='ACTIVO'").get()?.n || 0;
+    return { nodes, high, cycles, stops, errors };
+  } catch { return { nodes: 0, high: 0, cycles: 0, stops: 0, errors: 0 }; }
+}
+
+function getLastModifiedFiles(db, cicloId) {
+  try {
+    const trail = db.prepare(`
+      SELECT descripcion FROM decisiones
+      WHERE ciclo_id = ?
+        AND (descripcion LIKE '%.ts%' OR descripcion LIKE '%.js%'
+             OR descripcion LIKE '%.tsx%' OR descripcion LIKE '%.jsx%'
+             OR descripcion LIKE '%.py%')
+      LIMIT 5
+    `).all(cicloId);
+    return trail.map(t => t.descripcion?.substring(0, 60)).filter(Boolean);
+  } catch { return []; }
+}
+
+// ─── GENERAR CHECKPOINT ───────────────────────────────────────────────────────
+
+function generateCheckpoint(projectRoot) {
+  projectRoot = projectRoot || process.cwd();
+  const db = openDB(projectRoot);
+  if (!db) return null;
+
+  const cycles  = getRecentCycles(db, 5);
+  const stats   = getProjectStats(db);
+  const now     = new Date();
+  const dateStr = now.toLocaleDateString('es-ES', { day:'2-digit', month:'2-digit', year:'numeric' });
+  const timeStr = now.toTimeString().substring(0, 5);
+
+  if (cycles.length === 0) {
+    db.close();
+    return null;
+  }
+
+  const latest  = cycles[0];
+  const prev    = cycles.slice(1);
+
+  // Parsear fases completadas del último ciclo
+  let fasesInfo = '';
+  try {
+    const fases = JSON.parse(latest.fases_completadas || '[]');
+    if (fases.length > 0) fasesInfo = ` — ${fases.length} fases completadas`;
+  } catch {}
+
+  // Parsear patrones del último ciclo
+  let patronesInfo = '';
+  try {
+    const pats = JSON.parse(latest.patrones_aplicados || '[]');
+    if (pats.length > 0) patronesInfo = `, ${pats.length} patrones aplicados`;
+  } catch {}
+
+  // Archivos del último ciclo
+  const files = getLastModifiedFiles(db, latest.ciclo_id);
+  const filesStr = files.length > 0 ? `\nArchivos: ${files.join(', ')}` : '';
+
+  // Construir checkpoint
+  const lines = [
+    `# Checkpoint Agentic KDD — ${dateStr} ${timeStr}`,
+    '',
+    `> Proyecto: ${path.basename(projectRoot)}`,
+    `> Ciclos totales: ${stats.cycles}`,
+    '',
+    '---',
+    '',
+    `## Última tarea (ciclo ${stats.cycles})`,
+    `**${latest.descripcion || 'Sin descripción'}**`,
+    `Estado: ${latest.estado || 'completado'}${fasesInfo}${patronesInfo}${filesStr}`,
+    '',
+  ];
+
+  if (prev.length > 0) {
+    lines.push('## Las anteriores');
+    prev.forEach((c, i) => {
+      const fecha = c.fecha_inicio ? new Date(c.fecha_inicio).toLocaleDateString('es-ES', {day:'2-digit', month:'2-digit'}) : '';
+      lines.push(`${i + 1}. ${fecha ? `[${fecha}] ` : ''}${c.descripcion?.substring(0, 80) || 'Sin descripción'}`);
+    });
+    lines.push('');
+  }
+
+  lines.push('## Estado del proyecto');
+  lines.push(`- ${stats.nodes} nodos en memoria · ${stats.high} reglas HIGH`);
+  lines.push(`- ${stats.cycles} ciclos completados · ${stats.stops} stops`);
+  lines.push(`- ${stats.errors} errores documentados`);
+  lines.push('');
+  lines.push('## Para retomar en un chat nuevo');
+  lines.push('```');
+  lines.push('akdd historial');
+  lines.push('```');
+  lines.push('Pega el output al inicio del nuevo chat y escribe:');
+  lines.push('```');
+  lines.push(`aa: continúa — ${latest.descripcion?.substring(0, 60) || 'la última tarea'}`);
+  lines.push('```');
+  lines.push('');
+  lines.push(`---`);
+  lines.push(`*Generado automáticamente por Session Guard · ${dateStr} ${timeStr}*`);
+
+  const checkpointContent = lines.join('\n');
+  const checkpointPath = path.join(projectRoot, CHECKPOINT_PATH);
+
+  try {
+    fs.writeFileSync(checkpointPath, checkpointContent);
+  } catch {}
+
+  db.close();
+  return checkpointContent;
+}
+
+// ─── MOSTRAR HISTORIAL (para pegar en chat nuevo) ─────────────────────────────
+
+function showHistorial(projectRoot) {
+  projectRoot = projectRoot || process.cwd();
+  const checkpointPath = path.join(projectRoot, CHECKPOINT_PATH);
+
+  if (!fs.existsSync(checkpointPath)) {
+    // Generar uno ahora si no existe
+    const generated = generateCheckpoint(projectRoot);
+    if (!generated) {
+      console.log('\n[SESSION] Sin historial todavía — corre ciclos aa: primero.\n');
+      return null;
+    }
+    return generated;
+  }
+
+  const content = fs.readFileSync(checkpointPath, 'utf8');
+
+  console.log('\n' + '═'.repeat(60));
+  console.log('  📋 HISTORIAL — Pegar al inicio del chat nuevo');
+  console.log('═'.repeat(60));
+  console.log('\n' + content);
+  console.log('═'.repeat(60));
+  console.log('\n  Copia todo lo de arriba y pégalo en el nuevo chat.\n');
+
+  return content;
+}
+
+// ─── CHECK Y AUTO-CHECKPOINT ──────────────────────────────────────────────────
+
+/**
+ * Llamar al final de cada ciclo desde grafo.cjs.
+ * Genera checkpoint cada CHECKPOINT_EVERY ciclos.
+ */
+function maybeCheckpoint(projectRoot, currentCycleCount) {
+  if (currentCycleCount % CHECKPOINT_EVERY === 0) {
+    generateCheckpoint(projectRoot);
+    return true;
+  }
+  return false;
+}
+
+// ─── STATUS ───────────────────────────────────────────────────────────────────
+
+function getStatus(projectRoot) {
+  projectRoot = projectRoot || process.cwd();
+  const db = openDB(projectRoot);
+  if (!db) return { cycles: 0, next_checkpoint: CHECKPOINT_EVERY };
+
+  const cycles = db.prepare("SELECT COUNT(*) as n FROM ciclos").get()?.n || 0;
+  db.close();
+
+  const remaining = CHECKPOINT_EVERY - (cycles % CHECKPOINT_EVERY);
+  const checkpointExists = fs.existsSync(path.join(projectRoot, CHECKPOINT_PATH));
+
+  return {
+    cycles,
+    checkpoint_every: CHECKPOINT_EVERY,
+    cycles_until_next: remaining === CHECKPOINT_EVERY ? 0 : remaining,
+    last_checkpoint: checkpointExists
+      ? fs.statSync(path.join(projectRoot, CHECKPOINT_PATH)).mtime.toLocaleDateString('es-ES')
+      : 'nunca',
+  };
+}
+
+// ─── CLI ──────────────────────────────────────────────────────────────────────
+
+if (require.main === module) {
+  const [,, cmd] = process.argv;
+  const projectRoot = process.cwd();
+
+  switch (cmd) {
+    case 'checkpoint':
+      const c = generateCheckpoint(projectRoot);
+      if (c) console.log(`\n✅ Checkpoint guardado en ${CHECKPOINT_PATH}\n`);
+      else   console.log('\n❌ Sin ciclos para guardar todavía.\n');
+      break;
+
+    case 'historial':
+      showHistorial(projectRoot);
+      break;
+
+    case 'status': {
+      const s = getStatus(projectRoot);
+      console.log(`\nSession Guard Status:`);
+      console.log(`  Ciclos totales:       ${s.cycles}`);
+      console.log(`  Checkpoint cada:      ${s.checkpoint_every} ciclos`);
+      console.log(`  Ciclos hasta próximo: ${s.cycles_until_next || CHECKPOINT_EVERY}`);
+      console.log(`  Último checkpoint:    ${s.last_checkpoint}\n`);
+      break;
+    }
+
+    default:
+      console.log('Uso: node session-guard.cjs [checkpoint | historial | status]');
+  }
+}
+
+module.exports = { generateCheckpoint, showHistorial, maybeCheckpoint, getStatus };

package/src/dashboard-template.cjs

@@ -9,13 +9,26 @@ const { execSync } = require('child_process');
 const PORT = 3847;
 const projectPath = process.cwd();
 const dbPath = path.join(projectPath, '.agentic', 'memoria.db');
-const grafoPath = path.join(projectPath, '.agentic', 'grafo', 'grafo.js');
+const grafoPath = fs.existsSync(path.join(projectPath, '.agentic', 'grafo', 'grafo.cjs'))
+  ? path.join(projectPath, '.agentic', 'grafo', 'grafo.cjs')
+  : path.join(projectPath, '.agentic', 'grafo', 'grafo.js');
 const configPath = path.join(projectPath, '.agentic', 'config.md');
 const memoriaPath = path.join(projectPath, '.agentic', 'memoria');
 
 if (!fs.existsSync(configPath)) { console.log('\n  Agentic KDD not installed.\n'); process.exit(1); }
 if (fs.existsSync(grafoPath)) { try { process.stdout.write('  Syncing... '); execSync(`node "${grafoPath}" sync`, { stdio: 'pipe', cwd: projectPath }); console.log('✓'); } catch {} }
 
+function escHtml(str) {
+  if (!str) return '';
+  return String(str)
+    .replace(/&/g, '&')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/`/g, '&#96;')
+    .replace(/\$/g, '&#36;');
+}
+
 function readConfig() {
   try {
     const c = fs.readFileSync(configPath, 'utf8');
@@ -274,6 +287,69 @@ function getGraphData() {
   } catch { return { nodes: [], edges: [], ciclos: [], fases: [] }; }
 }
 
+
+// ─── v3.3: CONTRACT GUARD DATA ────────────────────────────────────────────────
+function getContractData() {
+  try {
+    if (!fs.existsSync(dbPath)) return { total:0, protected:0, verified:0, candidate:0, violations:0, recent:[] };
+    const BS3 = require('better-sqlite3');
+    const _db = new BS3(dbPath, { readonly: true });
+    let result = { total:0, protected:0, verified:0, candidate:0, invalidated:0, violations:0, recent:[] };
+    try {
+      result.total     = _db.prepare("SELECT COUNT(*) as n FROM verified_contracts").get()?.n || 0;
+      result.protected = _db.prepare("SELECT COUNT(*) as n FROM verified_contracts WHERE status='protected'").get()?.n || 0;
+      result.verified  = _db.prepare("SELECT COUNT(*) as n FROM verified_contracts WHERE status='verified'").get()?.n || 0;
+      result.candidate = _db.prepare("SELECT COUNT(*) as n FROM verified_contracts WHERE status='candidate'").get()?.n || 0;
+      result.invalidated= _db.prepare("SELECT COUNT(*) as n FROM verified_contracts WHERE status='invalidated'").get()?.n || 0;
+      result.violations= _db.prepare("SELECT COUNT(*) as n FROM contract_violations WHERE recovered=0").get()?.n || 0;
+      result.recent    = _db.prepare("SELECT id, module, name, status, verification_count, failure_count FROM verified_contracts ORDER BY updated_at DESC LIMIT 8").all();
+    } catch {}
+    _db.close();
+    return result;
+  } catch { return { total:0, protected:0, verified:0, candidate:0, violations:0, recent:[] }; }
+}
+
+// ─── v3.3: CREATIVE ENGINE DATA ───────────────────────────────────────────────
+function getCreativeData() {
+  try {
+    if (!fs.existsSync(dbPath)) return { level:1, suggestions:0, wins:0, auto_applicable:0, recent_suggestions:[] };
+    const BS3 = require('better-sqlite3');
+    const _db = new BS3(dbPath, { readonly: true });
+    let result = { level:1, suggestions:0, wins:0, auto_applicable:0, recent_suggestions:[] };
+    try {
+      result.suggestions     = _db.prepare("SELECT COUNT(*) as n FROM creative_suggestions WHERE applied=0 AND dismissed=0").get()?.n || 0;
+      result.wins            = _db.prepare("SELECT COUNT(*) as n FROM creative_wins").get()?.n || 0;
+      result.auto_applicable = _db.prepare("SELECT COUNT(*) as n FROM creative_suggestions WHERE auto_applicable=1 AND applied=0 AND dismissed=0").get()?.n || 0;
+      // Determine level from protected contracts
+      const protected_count = _db.prepare("SELECT COUNT(*) as n FROM verified_contracts WHERE status IN ('protected','verified')").get()?.n || 0;
+      result.level = protected_count >= 10 ? 2 : 1;
+      result.protected_for_level2 = protected_count;
+      result.recent_suggestions = _db.prepare("SELECT id, type, title, risk_level, module, auto_applicable FROM creative_suggestions WHERE applied=0 AND dismissed=0 ORDER BY created_at DESC LIMIT 5").all();
+    } catch {}
+    _db.close();
+    return result;
+  } catch { return { level:1, suggestions:0, wins:0, auto_applicable:0, recent_suggestions:[] }; }
+}
+
+// ─── v3.3: MEM CURATOR DATA ───────────────────────────────────────────────────
+function getCuratorData() {
+  try {
+    const logPath = path.join(projectPath, '.agentic', 'curator.log');
+    let lastRun = 'nunca', actions = 0;
+    if (fs.existsSync(logPath)) {
+      const lines = fs.readFileSync(logPath, 'utf8').trim().split('\n').filter(Boolean);
+      if (lines.length > 0) {
+        const last = lines[lines.length-1];
+        const match = last.match(/\[([^\]]+)\]/);
+        if (match) lastRun = match[1].split('T')[0];
+        actions = lines.filter(l => l.includes('mergeados') || l.includes('comprimidos') || l.includes('resueltos')).length;
+      }
+    }
+    return { lastRun, actions };
+  } catch { return { lastRun: 'nunca', actions: 0 }; }
+}
+
+
 const { nodes, edges, ciclos: ciclosDB, fases: fasesDB } = getGraphData();
 
 // Calcular grado de conexiones por nodo (como Graphify — nodos divinos)
@@ -324,6 +400,9 @@ function parseModulos(text) {
   return results;
 }
 
+const contractData   = getContractData();
+const creativeData   = getCreativeData();
+const curatorData    = getCuratorData();
 const modulosImpl = parseModulos(config.implementados);
 const specsData = readSpecs();
 const logsData = readLogs();
@@ -526,7 +605,12 @@ body{background:var(--bg);color:var(--text);font-family:-apple-system,BlinkMacSy
 .graph-legend{position:absolute;top:10px;left:10px;background:rgba(17,21,32,.9);border:1px solid var(--border);border-radius:8px;padding:8px 12px;display:flex;gap:10px;backdrop-filter:blur(4px)}
 .lg-item{display:flex;align-items:center;gap:5px;font-size:10px;color:var(--text2)}
 .lg-dot{width:8px;height:8px;border-radius:50%;flex-shrink:0}
-.graph-controls{position:absolute;bottom:12px;left:12px;display:flex;gap:6px}
+.graph-controls{position:absolute;bottom:12px;left:12px;display:flex;gap:6px;flex-wrap:wrap;align-items:center;max-width:480px}
+.gc-slider-wrap{display:flex;align-items:center;gap:4px;background:rgba(17,21,32,.9);border:1px solid var(--border);border-radius:6px;padding:3px 8px}
+.gc-slider-label{font-size:13px;color:var(--text2)}
+.gc-slider{-webkit-appearance:none;width:80px;height:3px;border-radius:2px;background:var(--border);outline:none;cursor:pointer}
+.gc-slider::-webkit-slider-thumb{-webkit-appearance:none;width:12px;height:12px;border-radius:50%;background:#8b5cf6;cursor:pointer}
+.node-pinned{stroke:#ffffff !important;stroke-width:2px !important;stroke-dasharray:3,2}
 .gc-btn{background:rgba(17,21,32,.9);border:1px solid var(--border);color:var(--text2);border-radius:6px;padding:5px 9px;font-size:10px;cursor:pointer;backdrop-filter:blur(4px)}
 .gc-btn:hover{border-color:var(--purple);color:var(--pl)}
 
@@ -551,7 +635,7 @@ body{background:var(--bg);color:var(--text);font-family:-apple-system,BlinkMacSy
 
 /* ════════ PROJECT DOCS MODE ════════ */
 #mode-docs{flex:1;display:none;overflow:hidden}
-.docs-layout{display:flex;height:100%;overflow:hidden}
+.docs-layout{display:flex;height:100%;width:100%;overflow:hidden;flex:1;min-width:0}
 .docs-nav{width:210px;flex-shrink:0;background:var(--bg2);border-right:1px solid var(--border);overflow-y:auto;padding:12px}
 .docs-nav::-webkit-scrollbar{width:3px}
 .docs-nav::-webkit-scrollbar-thumb{background:var(--border)}
@@ -561,7 +645,7 @@ body{background:var(--bg);color:var(--text);font-family:-apple-system,BlinkMacSy
 .nav-item:hover{background:var(--bg3);color:var(--text)}
 .nav-item.active{background:rgba(139,92,246,.12);color:var(--pl);border-left:2px solid var(--purple);padding-left:6px}
 .nav-count{font-size:10px;color:var(--text3);margin-left:auto;background:var(--bg3);border-radius:10px;padding:1px 5px}
-.docs-main{flex:1;overflow-y:auto;padding:24px 28px}
+.docs-main{flex:1;min-width:0;overflow-y:auto;padding:24px 28px}
 .docs-main::-webkit-scrollbar{width:4px}
 .docs-main::-webkit-scrollbar-thumb{background:var(--border);border-radius:2px}
 .docs-section{display:none}.docs-section.active{display:block}#doc-modules.active{display:flex}
@@ -766,6 +850,13 @@ body{background:var(--bg);color:var(--text);font-family:-apple-system,BlinkMacSy
       <button class="gc-btn" onclick="resetGraph()" data-i="btn_reset">⟳ Reset</button>
       <button class="gc-btn" onclick="centerGraph()" data-i="btn_center">⊙ Center</button>
       <button class="gc-btn" onclick="toggleLabels()" id="label-btn" data-i="btn_labels">Labels OFF</button>
+      <button class="gc-btn" onclick="spreadGraph()" title="Spread nodes apart">⊹ Spread</button>
+      <button class="gc-btn" onclick="releaseAll()" title="Release all pinned nodes">⊠ Unpin all</button>
+      <div class="gc-slider-wrap" title="Node repulsion">
+        <span class="gc-slider-label">⊷</span>
+        <input type="range" class="gc-slider" id="repulsion-slider" min="50" max="800" value="320"
+          oninput="setRepulsion(this.value)" title="Repulsion force">
+      </div>
     </div>
     <div class="detail-panel" id="detail-panel">
       <div class="dp-header">
@@ -925,13 +1016,13 @@ body{background:var(--bg);color:var(--text);font-family:-apple-system,BlinkMacSy
       <div class="docs-section" id="doc-patterns">
         <div class="docs-h1">Patterns</div>
         <div class="docs-sub">Rules the system learned from this project. HIGH = permanent rule applied automatically.</div>
-        ${patrones.length ? patrones.sort((a,b) => {const w={ALTA:3,MEDIA:2,BAJA:1}; return (w[b.confianza]||0)-(w[a.confianza]||0);}).map(p => {
+        ${patrones.length ? patrones.filter(p => p.titulo && p.titulo !== 'Nombre del patrón' && p.titulo.length > 5).sort((a,b) => {const w={ALTA:3,MEDIA:2,BAJA:1}; return (w[b.confianza]||0)-(w[a.confianza]||0);}).map(p => {
           const maxUse = Math.max(...patrones.map(x => x.aplicado), 1);
           return `<div class="pattern-card ${p.confianza==='ALTA'?'high':''}">
             <div class="pc-top">
-              <div class="pc-title">${p.titulo}</div>
-              <span class="mb c${p.confianza}">${p.confianza}</span>
-              <span class="ab">${p.area}</span>
+              <div class="pc-title">${escHtml(p.titulo)}</div>
+              <span class="mb c${p.confianza}">${escHtml(p.confianza)}</span>
+              <span class="ab">${escHtml(p.area)}</span>
             </div>
             ${p.aplicado > 0 ? `<div style="font-size:10px;color:var(--text3);margin-bottom:4px">Applied ${p.aplicado} times · ${p.util} useful</div><div class="usage-bar"><div class="usage-fill" style="width:${Math.round(p.aplicado/maxUse*100)}%"></div></div>` : ''}
           </div>`;
@@ -949,8 +1040,8 @@ body{background:var(--bg);color:var(--text);font-family:-apple-system,BlinkMacSy
       <div class="docs-section" id="doc-errors">
         <div class="docs-h1">Known Error Patterns</div>
         <div class="docs-sub">Errors the system has already learned to avoid automatically.</div>
-        ${errores.length ? errores.sort((a,b)=>b.aplicado-a.aplicado).map(e => `<div class="pattern-card" style="border-left:3px solid var(--red)">
-          <div class="pc-top"><div class="pc-title">${e.titulo}</div><span class="mb c${e.confianza}">${e.confianza}</span><span class="ab">${e.area}</span></div>
+        ${errores.length ? errores.filter(e => e.titulo && e.titulo !== 'Nombre del patrón' && e.titulo.length > 5).sort((a,b)=>b.aplicado-a.aplicado).map(e => `<div class="pattern-card" style="border-left:3px solid var(--red)">
+          <div class="pc-top"><div class="pc-title">${escHtml(e.titulo)}</div><span class="mb c${e.confianza}">${e.confianza}</span><span class="ab">${escHtml(e.area)}</span></div>
           ${e.aplicado > 0 ? `<div style="font-size:10px;color:var(--text3)">Resolved ${e.aplicado} times</div>` : ''}
         </div>`).join('') : '<div class="empty-state">No errors recorded yet</div>'}
       </div>
@@ -1172,19 +1263,6 @@ body{background:var(--bg);color:var(--text);font-family:-apple-system,BlinkMacSy
 </div>
 
 <script>
-console.log('=== Agentic KDD Dashboard Debug ===');
-console.log('M_NODES:', ${JSON.stringify(mNodes)}.length, 'nodes');
-console.log('metricsData:', ${JSON.stringify(metricsData)});
-console.log('onboardingData pct:', ${JSON.stringify(onboardingData.pct)});
-console.log('specsData:', ${JSON.stringify(specsData)}.length, 'specs');
-console.log('logsData:', ${JSON.stringify(logsData)}.length, 'logs');
-document.addEventListener('DOMContentLoaded', function(){
-  console.log('Nav items:', document.querySelectorAll('.nav-item').length);
-  console.log('Doc sections:', document.querySelectorAll('.docs-section').length);
-  console.log('doc-metrics exists:', !!document.getElementById('doc-metrics'));
-  console.log('doc-timeline exists:', !!document.getElementById('doc-timeline'));
-  console.log('doc-onboarding exists:', !!document.getElementById('doc-onboarding'));
-});
 const NODES = ${JSON.stringify(nodes)};
 const EDGES = ${JSON.stringify(edges)};
 const M_NODES = ${JSON.stringify(mNodes)};
@@ -1438,6 +1516,43 @@ function centerGraph(){
   simulation.force('center',d3.forceCenter(c.clientWidth/2,c.clientHeight/2)).alpha(0.3).restart();
 }
 
+// ─── Graph interaction helpers ────────────────────────────────
+function updatePinIndicator(el, pinned){
+  if(!el)return;
+  d3.select(el).classed('node-pinned', pinned);
+}
+
+function unpinNode(d, el){
+  d.fx=null; d.fy=null;
+  if(el) d3.select(el).classed('node-pinned', false);
+  simulation.alpha(0.2).restart();
+}
+
+function releaseAll(){
+  if(!nodeSel)return;
+  NODES.forEach(n=>{n.fx=null;n.fy=null;});
+  nodeSel.classed('node-pinned', false);
+  simulation.alpha(0.5).restart();
+}
+
+function spreadGraph(){
+  if(!simulation)return;
+  simulation.force('charge',d3.forceManyBody().strength(d=>(DEGREE_MAP[d.id]||0)>=GOD_THRESHOLD?-1200:-700));
+  simulation.alpha(0.8).restart();
+  setTimeout(()=>{
+    const repVal = parseInt(document.getElementById('repulsion-slider')?.value||320);
+    simulation.force('charge',d3.forceManyBody().strength(d=>(DEGREE_MAP[d.id]||0)>=GOD_THRESHOLD?-(repVal*2):-(repVal)));
+    simulation.alpha(0.1).restart();
+  }, 1800);
+}
+
+function setRepulsion(val){
+  val = parseInt(val);
+  if(!simulation)return;
+  simulation.force('charge',d3.forceManyBody().strength(d=>(DEGREE_MAP[d.id]||0)>=GOD_THRESHOLD?-(val*2):-(val)));
+  simulation.alpha(0.3).restart();
+}
+
 // ─── D3 Knowledge Graph ───────────────────────────────────────
 function renderGraph(){
   if(!NODES.length)return;
@@ -1466,7 +1581,7 @@ function renderGraph(){
       const sd=DEGREE_MAP[d.source.id]||0, td=DEGREE_MAP[d.target.id]||0;
       return sd>=GOD_THRESHOLD||td>=GOD_THRESHOLD?120:90;
     }))
-    .force('charge',d3.forceManyBody().strength(d=>(DEGREE_MAP[d.id]||0)>=GOD_THRESHOLD?-300:-150))
+    .force('charge',d3.forceManyBody().strength(d=>(DEGREE_MAP[d.id]||0)>=GOD_THRESHOLD?-600:-320))
     .force('center',d3.forceCenter(W/2,H/2))
     .force('collision',d3.forceCollide(d=>getNodeRadius(d)+4));
 
@@ -1488,8 +1603,9 @@ function renderGraph(){
     .style('cursor','pointer')
     .call(d3.drag()
       .on('start',(ev,d)=>{if(!ev.active)simulation.alphaTarget(0.3).restart();d.fx=d.x;d.fy=d.y;})
-      .on('drag',(ev,d)=>{d.fx=ev.x;d.fy=ev.y;})
-      .on('end',(ev,d)=>{if(!ev.active)simulation.alphaTarget(0);d.fx=null;d.fy=null;}))
+      .on('drag',(ev,d)=>{d.fx=ev.x;d.fy=ev.y;updatePinIndicator(ev.currentTarget,true);})
+      .on('end',(ev,d)=>{if(!ev.active)simulation.alphaTarget(0);/* node stays PINNED — dblclick to release */}))
+    .on('dblclick',(ev,d)=>{ev.stopPropagation();unpinNode(d,ev.currentTarget);})
     .on('click',(ev,d)=>{ev.stopPropagation();selectNode(d.id);})
     .on('mouseover',(ev,d)=>{
       const tt=document.getElementById('gtt');
@@ -1706,7 +1822,156 @@ function copyMarkdown(){
 renderNodeList();
 renderGraph();
 </script>
-</body>
+
+    <!-- ───────────────────────────────────────────────────────────────────
+         v3.3 PANELS: CONTRACT GUARD + CREATIVE ENGINE + CURATOR
+    ─────────────────────────────────────────────────────────────────────── -->
+
+    <style>
+    .v33-section { margin: 0 auto 32px; max-width: 1100px; padding: 0 24px; }
+    .v33-title { font-size: 11px; font-weight: 700; letter-spacing: .14em; text-transform: uppercase; color: #8d99ae; margin: 0 0 14px; }
+    .v33-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(280px, 1fr)); gap: 16px; }
+    .v33-card { background: #1e2535; border: 1px solid #2e3550; border-radius: 12px; padding: 18px 20px; }
+    .v33-card-header { display: flex; align-items: center; gap: 10px; margin-bottom: 14px; }
+    .v33-card-icon { width: 32px; height: 32px; border-radius: 8px; display: flex; align-items: center; justify-content: center; font-size: 16px; flex-shrink: 0; }
+    .icon-purple { background: rgba(127,119,221,0.15); }
+    .icon-green  { background: rgba(29,158,117,0.15); }
+    .icon-amber  { background: rgba(239,159,39,0.15); }
+    .v33-card-title { font-size: 14px; font-weight: 700; color: #e2e8f0; }
+    .v33-card-sub   { font-size: 11px; color: #64748b; margin-top: 1px; }
+    .v33-stat-row { display: grid; grid-template-columns: repeat(2, 1fr); gap: 8px; margin-bottom: 14px; }
+    .v33-stat { background: rgba(255,255,255,0.03); border-radius: 8px; padding: 10px 12px; text-align: center; }
+    .v33-stat-val { font-size: 22px; font-weight: 800; line-height: 1.1; }
+    .v33-stat-label { font-size: 10px; color: #64748b; margin-top: 2px; }
+    .val-purple { color: #9f99e8; }
+    .val-green  { color: #34d399; }
+    .val-amber  { color: #fbbf24; }
+    .val-red    { color: #f87171; }
+    .val-gray   { color: #94a3b8; }
+    .contract-list { display: flex; flex-direction: column; gap: 6px; }
+    .contract-row { display: flex; align-items: center; gap: 8px; padding: 7px 10px; background: rgba(255,255,255,0.03); border-radius: 7px; font-size: 12px; }
+    .contract-badge { font-size: 9px; font-weight: 700; padding: 2px 6px; border-radius: 10px; white-space: nowrap; flex-shrink: 0; }
+    .badge-protected { background: rgba(127,119,221,0.2); color: #9f99e8; }
+    .badge-verified  { background: rgba(29,158,117,0.2);  color: #34d399; }
+    .badge-candidate { background: rgba(239,159,39,0.2);  color: #fbbf24; }
+    .badge-invalid   { background: rgba(248,113,113,0.2); color: #f87171; }
+    .contract-name { flex: 1; color: #cbd5e1; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+    .contract-module { font-size: 10px; color: #475569; }
+    .suggestion-row { display: flex; align-items: flex-start; gap: 8px; padding: 7px 10px; background: rgba(255,255,255,0.03); border-radius: 7px; font-size: 12px; margin-bottom: 5px; }
+    .sug-type { font-size: 9px; font-weight: 700; padding: 2px 6px; border-radius: 10px; white-space: nowrap; flex-shrink: 0; background: rgba(239,159,39,0.15); color: #fbbf24; }
+    .sug-auto { background: rgba(29,158,117,0.15); color: #34d399; }
+    .sug-text { color: #94a3b8; flex: 1; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+    .level-bar { display: flex; align-items: center; gap: 10px; margin-bottom: 12px; }
+    .level-indicator { height: 6px; flex: 1; background: rgba(255,255,255,0.06); border-radius: 3px; overflow: hidden; }
+    .level-fill { height: 100%; border-radius: 3px; transition: width .6s; }
+    .curator-row { display: flex; justify-content: space-between; align-items: center; padding: 6px 0; border-bottom: 1px solid rgba(255,255,255,0.05); font-size: 12px; }
+    .curator-row:last-child { border-bottom: none; }
+    .curator-key { color: #64748b; }
+    .curator-val { color: #94a3b8; font-weight: 600; }
+    .obsidian-panel { background: #1e2535; border: 1px solid #3730a3; border-radius: 12px; padding: 16px 20px; }
+    .obsidian-header { display: flex; align-items: center; gap: 10px; margin-bottom: 10px; }
+    .obsidian-badge { font-size: 10px; padding: 2px 8px; border-radius: 10px; background: rgba(99,91,255,0.15); color: #818cf8; font-weight: 600; }
+    .obsidian-text { font-size: 13px; color: #94a3b8; line-height: 1.5; }
+    .obsidian-cmd { font-family: monospace; font-size: 11px; background: rgba(255,255,255,0.05); color: #a5b4fc; padding: 6px 10px; border-radius: 6px; margin-top: 8px; display: block; }
+    @media(max-width:600px){ .v33-stat-row { grid-template-columns: repeat(2,1fr); } }
+    </style>
+
+    <div class="v33-section">
+      <div class="v33-title">Preservation Intelligence Layer — v3.3</div>
+      <div class="v33-grid">
+
+        <!-- CONTRACT GUARD -->
+        <div class="v33-card">
+          <div class="v33-card-header">
+            <div class="v33-card-icon icon-purple">🛡️</div>
+            <div><div class="v33-card-title">Contract Guard</div><div class="v33-card-sub">Lo que no se puede romper</div></div>
+          </div>
+          <div class="v33-stat-row">
+            <div class="v33-stat"><div class="v33-stat-val val-purple">${contractData.protected}</div><div class="v33-stat-label">Protected</div></div>
+            <div class="v33-stat"><div class="v33-stat-val val-green">${contractData.verified}</div><div class="v33-stat-label">Verified</div></div>
+            <div class="v33-stat"><div class="v33-stat-val val-amber">${contractData.candidate}</div><div class="v33-stat-label">Candidate</div></div>
+            <div class="v33-stat"><div class="v33-stat-val ${contractData.violations > 0 ? 'val-red' : 'val-gray'}">${contractData.violations}</div><div class="v33-stat-label">Violations</div></div>
+          </div>
+          ${contractData.recent && contractData.recent.length > 0 ? `
+          <div class="contract-list">
+            ${contractData.recent.map(c => `
+              <div class="contract-row">
+                <span class="contract-badge badge-${c.status}">${c.status.toUpperCase()}</span>
+                <span class="contract-name" title="${escHtml(c.name)}">${escHtml(c.name.substring(0,35))}</span>
+                <span class="contract-module">${escHtml(c.module)}</span>
+              </div>
+            `).join('')}
+          </div>` : `<div style="font-size:12px;color:#475569;text-align:center;padding:12px 0">Sin contratos todavía — corre más ciclos aa: para generarlos automáticamente</div>`}
+        </div>
+
+        <!-- CREATIVE ENGINE -->
+        <div class="v33-card">
+          <div class="v33-card-header">
+            <div class="v33-card-icon icon-amber">✨</div>
+            <div><div class="v33-card-title">Creative Engine</div><div class="v33-card-sub">Autonomía creativa dirigida</div></div>
+          </div>
+          <div class="level-bar">
+            <span style="font-size:11px;color:#64748b;white-space:nowrap">Nivel ${creativeData.level}</span>
+            <div class="level-indicator"><div class="level-fill" style="width:${(creativeData.level / 3 * 100).toFixed(0)}%;background:${creativeData.level >= 2 ? '#34d399' : '#fbbf24'}"></div></div>
+            <span style="font-size:11px;color:${creativeData.level >= 2 ? '#34d399' : '#fbbf24'};white-space:nowrap">${creativeData.level >= 2 ? 'CREATIVO' : 'ASISTIDO'}</span>
+          </div>
+          ${creativeData.level < 2 ? `<div style="font-size:11px;color:#475569;margin-bottom:10px">Faltan ${10 - (creativeData.protected_for_level2 || 0)} contratos verificados para Nivel 2</div>` : ''}
+          <div class="v33-stat-row">
+            <div class="v33-stat"><div class="v33-stat-val val-amber">${creativeData.suggestions}</div><div class="v33-stat-label">Pendientes</div></div>
+            <div class="v33-stat"><div class="v33-stat-val val-green">${creativeData.wins}</div><div class="v33-stat-label">Aplicadas</div></div>
+          </div>
+          ${creativeData.recent_suggestions && creativeData.recent_suggestions.length > 0 ? `
+          <div>
+            ${creativeData.recent_suggestions.map(s => `
+              <div class="suggestion-row">
+                <span class="sug-type ${s.auto_applicable ? 'sug-auto' : ''}">${s.type}</span>
+                <span class="sug-text" title="${escHtml(s.title)}">${escHtml(s.title.substring(0,50))}</span>
+              </div>
+            `).join('')}
+          </div>` : `<div style="font-size:12px;color:#475569;text-align:center;padding:8px 0">Sin sugerencias — se generan automáticamente cada ciclo</div>`}
+        </div>
+
+        <!-- MEM CURATOR -->
+        <div class="v33-card">
+          <div class="v33-card-icon icon-green" style="margin-bottom:14px;width:auto;height:auto;padding:0;display:flex;gap:10px;align-items:center;background:none">
+            <div style="width:32px;height:32px;border-radius:8px;background:rgba(29,158,117,0.15);display:flex;align-items:center;justify-content:center;font-size:16px">🔬</div>
+            <div><div class="v33-card-title">MemCurator</div><div class="v33-card-sub">Gobernanza autónoma de memoria</div></div>
+          </div>
+          <div class="curator-row"><span class="curator-key">Última curation</span><span class="curator-val">${curatorData.lastRun}</span></div>
+          <div class="curator-row"><span class="curator-key">Ciclos para auto-run</span><span class="curator-val">cada 10</span></div>
+          <div class="curator-row"><span class="curator-key">TTL episódico</span><span class="curator-val">30 días</span></div>
+          <div class="curator-row"><span class="curator-key">Límite nodos activos</span><span class="curator-val">1,000</span></div>
+          <div class="curator-row"><span class="curator-key">Dedup threshold</span><span class="curator-val">92% Jaccard</span></div>
+          <div style="margin-top:12px;padding:10px;background:rgba(255,255,255,0.03);border-radius:8px;font-size:11px;color:#64748b">
+            <code style="color:#a5b4fc">akdd cure</code> — curation manual<br>
+            <code style="color:#a5b4fc">akdd cure report</code> — preview sin cambios
+          </div>
+        </div>
+
+      </div>
+    </div>
+
+    <!-- OBSIDIAN MCP OPTIONAL CONNECTOR -->
+    <div class="v33-section">
+      <div class="v33-title">Conector opcional — Obsidian MCP</div>
+      <div class="obsidian-panel">
+        <div class="obsidian-header">
+          <span style="font-size:20px">🗂️</span>
+          <div style="flex:1">
+            <span style="font-size:14px;font-weight:700;color:#e2e8f0">Obsidian como fuente humana</span>
+            <span class="obsidian-badge" style="margin-left:8px">OPCIONAL</span>
+          </div>
+        </div>
+        <div class="obsidian-text">
+          Si usas Obsidian, el plugin MCP conecta tu vault directamente con Agentic KDD.<br>
+          Tus notas personales, decisiones y gotchas fluyen al grafo automáticamente — sin hacer <code style="color:#a5b4fc">akdd knowledge</code> manual.
+        </div>
+        <code class="obsidian-cmd">1. Instalar plugin "Obsidian MCP Server" en Obsidian<br>2. En Claude Code/Cursor: agrega el servidor MCP del plugin<br>3. La herramienta obsidian_read_notes queda disponible en el chat</code>
+        <div style="font-size:11px;color:#475569;margin-top:8px">Sin Obsidian instalado: usa <code style="color:#a5b4fc">akdd knowledge</code> normalmente — mismo resultado.</div>
+      </div>
+    </div>
+
+  </body>
 </html>`;
 
 const server = http.createServer((req, res) => {