@umbral/cli 0.0.3 → 0.0.5

package/dist/index.js

@@ -853,8 +853,218 @@ function getTemplate(detection) {
   return TEMPLATES.find((t) => t.slugs.includes(detection.slug)) ?? null;
 }
 
+// src/claude-generate.ts
+import { spawn, spawnSync } from "child_process";
+function isClaudeAvailable() {
+  try {
+    const r = spawnSync("claude", ["--version"], {
+      timeout: 5e3,
+      shell: true,
+      stdio: ["ignore", "pipe", "ignore"]
+    });
+    return r.status === 0;
+  } catch {
+    return false;
+  }
+}
+function buildPrompt(detections) {
+  const detectionsJson = JSON.stringify(
+    detections.map((d) => ({
+      name: d.name,
+      slug: d.slug,
+      category: d.category,
+      confidence: d.confidence,
+      evidence: d.evidence,
+      metadata: d.metadata,
+      subdir: d.subdir
+    })),
+    null,
+    2
+  );
+  return `Eres Umbral, un framework de gobernanza para proyectos de software. Bas\xE1ndote en las tecnolog\xEDas detectadas abajo, genera Estructuras de Decisi\xF3n Expl\xEDcitas (EDEs) \u2014 decisiones arquitect\xF3nicas formalizadas y espec\xEDficas para ESTE proyecto.
+
+## Tecnolog\xEDas Detectadas
+${detectionsJson}
+
+## Esquema JSON de una EDE
+Cada EDE debe seguir EXACTAMENTE esta estructura:
+{
+  "id": "EDE-001-slug",
+  "title": "string",
+  "version": 1,
+  "status": "proposed",
+  "cognitiveLevel": "explorer" | "navigator" | "anchor",
+  "complexityTier": 1 | 2 | 3,
+  "whatAndHow": { "decision": "string", "mechanism": "string" },
+  "why": {
+    "rationale": "string",
+    "alternativesConsidered": [{ "option": "string", "rejectedBecause": "string" }],
+    "references": []
+  },
+  "whatNotToDo": { "antiPatterns": ["string"] },
+  "whatsNext": { "continuations": [], "openQuestions": [] },
+  "contracts": { "layerContracts": [], "verifiedBy": [] },
+  "tests": { "unitTests": [], "sadPaths": [], "coverageTarget": 0.8 },
+  "provenance": { "phase": "onboarding", "slice": null, "createdBy": "claude", "createdAt": null, "lastUpdated": null }
+}
+
+## Instrucciones
+- Genera una EDE por cada decisi\xF3n arquitect\xF3nica significativa
+- S\xE9 ESPEC\xCDFICO para este proyecto: usa la evidencia detectada para personalizar cada decisi\xF3n
+- Incluye anti-patrones relevantes a la COMBINACI\xD3N de tecnolog\xEDas (no gen\xE9ricos)
+- IDs: EDE-001-slug, EDE-002-slug, etc.
+- cognitiveLevel: "explorer" para simples, "navigator" para intermedias, "anchor" para invariantes
+- complexityTier: 1 simple, 2 medio, 3 complejo
+- Todo el contenido en espa\xF1ol
+- Genera entre 3 y 10 EDEs seg\xFAn la complejidad del proyecto
+
+Retorna \xDANICAMENTE un array JSON v\xE1lido. Sin markdown, sin backticks, sin texto adicional.`;
+}
+function extractJson(text) {
+  const codeBlock = text.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+  if (codeBlock) return codeBlock[1].trim();
+  const arrayMatch = text.match(/\[[\s\S]*\]/);
+  if (arrayMatch) return arrayMatch[0];
+  return text.trim();
+}
+function normalizeEde(raw, index) {
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  return {
+    id: raw.id ?? `EDE-${String(index + 1).padStart(3, "0")}-generated`,
+    title: raw.title ?? "EDE generada por Claude",
+    version: 1,
+    status: "proposed",
+    cognitiveLevel: raw.cognitiveLevel ?? "explorer",
+    complexityTier: raw.complexityTier ?? 1,
+    whatAndHow: {
+      decision: raw.whatAndHow?.decision ?? "",
+      mechanism: raw.whatAndHow?.mechanism ?? ""
+    },
+    why: {
+      rationale: raw.why?.rationale ?? "",
+      alternativesConsidered: Array.isArray(raw.why?.alternativesConsidered) ? raw.why.alternativesConsidered : [],
+      references: []
+    },
+    whatNotToDo: {
+      antiPatterns: Array.isArray(raw.whatNotToDo?.antiPatterns) ? raw.whatNotToDo.antiPatterns : []
+    },
+    whatsNext: {
+      continuations: [],
+      openQuestions: Array.isArray(raw.whatsNext?.openQuestions) ? raw.whatsNext.openQuestions : []
+    },
+    contracts: {
+      layerContracts: Array.isArray(raw.contracts?.layerContracts) ? raw.contracts.layerContracts : [],
+      verifiedBy: []
+    },
+    tests: {
+      unitTests: [],
+      sadPaths: [],
+      coverageTarget: raw.tests?.coverageTarget ?? 0.8
+    },
+    provenance: {
+      phase: "onboarding",
+      slice: null,
+      createdBy: "claude",
+      createdAt: now,
+      lastUpdated: now
+    }
+  };
+}
+function parseEdes(stdout2) {
+  try {
+    const jsonStr = extractJson(stdout2);
+    const parsed = JSON.parse(jsonStr);
+    if (!Array.isArray(parsed) || parsed.length === 0) return null;
+    const edes = [];
+    for (let i = 0; i < parsed.length; i++) {
+      try {
+        const ede = normalizeEde(parsed[i], i);
+        if (ede.whatAndHow.decision && ede.why.rationale) {
+          edes.push(ede);
+        }
+      } catch {
+      }
+    }
+    return edes.length > 0 ? edes : null;
+  } catch {
+    return null;
+  }
+}
+function generateWithClaude(detections) {
+  if (detections.length === 0) return Promise.resolve(null);
+  const prompt = buildPrompt(detections);
+  return new Promise((resolve) => {
+    const child = spawn("claude", ["--print"], {
+      shell: true,
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    let stdout2 = "";
+    let stderr = "";
+    let timedOut = false;
+    const timeout = setTimeout(() => {
+      timedOut = true;
+      child.kill();
+    }, 12e4);
+    child.stdout.on("data", (chunk) => {
+      stdout2 += chunk.toString();
+    });
+    child.stderr.on("data", (chunk) => {
+      stderr += chunk.toString();
+    });
+    child.on("close", (code) => {
+      clearTimeout(timeout);
+      if (timedOut || code !== 0 || !stdout2) {
+        resolve(null);
+        return;
+      }
+      resolve(parseEdes(stdout2));
+    });
+    child.on("error", () => {
+      clearTimeout(timeout);
+      resolve(null);
+    });
+    child.stdin.write(prompt);
+    child.stdin.end();
+  });
+}
+
+// src/spinner.ts
+var FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+function createSpinner(text) {
+  let i = 0;
+  const start = Date.now();
+  const w = process.stdout;
+  function elapsed() {
+    const s = Math.floor((Date.now() - start) / 1e3);
+    return s < 60 ? `${s}s` : `${Math.floor(s / 60)}m ${s % 60}s`;
+  }
+  function render() {
+    w.write(`\r  ${FRAMES[i % FRAMES.length]} ${text} (${elapsed()})`);
+    i++;
+  }
+  render();
+  const interval = setInterval(render, 80);
+  function clear(symbol, msg) {
+    clearInterval(interval);
+    const line = `  ${symbol} ${msg}`;
+    w.write(`\r${line}${"".padEnd(40)}
+`);
+  }
+  return {
+    update(newText) {
+      text = newText;
+    },
+    succeed(msg) {
+      clear("\u2713", msg);
+    },
+    fail(msg) {
+      clear("\u2717", msg);
+    }
+  };
+}
+
 // src/generate.ts
-function generateProposals(detections) {
+function generateFromTemplates(detections) {
   const proposals = [];
   let counter = 1;
   for (const detection of detections) {
@@ -906,6 +1116,24 @@ function generateProposals(detections) {
   }
   return proposals;
 }
+async function generateProposals(detections) {
+  if (isClaudeAvailable()) {
+    const spinner = createSpinner("Generando EDEs con Claude Code...");
+    const claudeEdes = await generateWithClaude(detections);
+    if (claudeEdes && claudeEdes.length > 0) {
+      spinner.succeed(
+        `${claudeEdes.length} EDEs generadas con Claude Code (IA)`
+      );
+      return { proposals: claudeEdes, source: "claude" };
+    }
+    spinner.fail("Claude no pudo generar EDEs \u2014 usando templates");
+  } else {
+    process.stdout.write(
+      "  \u21B3 Claude Code no disponible \u2014 usando templates locales\n"
+    );
+  }
+  return { proposals: generateFromTemplates(detections), source: "templates" };
+}
 
 // src/ui.ts
 import { createInterface } from "readline/promises";
@@ -1340,7 +1568,8 @@ async function initCommand(options) {
 `);
     }
   }
-  const proposals = generateProposals(analysis.detections);
+  w("\n");
+  const { proposals, source } = await generateProposals(analysis.detections);
   if (proposals.length === 0) {
     w("\n  No hay propuestas de EDEs para generar.\n");
     w("  Configurando infraestructura base...\n\n");
@@ -1473,7 +1702,7 @@ async function mcpCommand() {
 }
 
 // src/commands/start.ts
-import { execSync, spawn } from "child_process";
+import { execSync, spawn as spawn2 } from "child_process";
 import { writeFileSync as writeFileSync3, mkdirSync as mkdirSync4 } from "fs";
 import { join as join15 } from "path";
 import { homedir as homedir3 } from "os";
@@ -1583,7 +1812,7 @@ async function startCommand(options) {
         stdio: "inherit"
       });
     } else {
-      const child = spawn("docker", ["compose", "-f", COMPOSE_PATH, "up"], {
+      const child = spawn2("docker", ["compose", "-f", COMPOSE_PATH, "up"], {
         stdio: "inherit"
       });
       child.on("close", (code) => process.exit(code ?? 0));
@@ -1636,7 +1865,7 @@ function stopCommand() {
 
 // src/index.ts
 var program = new Command();
-program.name("umbral").description("Umbral \u2014 Framework de gobernanza para proyectos con Claude Code").version("0.0.3");
+program.name("umbral").description("Umbral \u2014 Framework de gobernanza para proyectos con Claude Code").version("0.0.5");
 program.command("init").description("Inicializar Umbral en el proyecto actual").option("--yes", "Aceptar todas las propuestas sin preguntar").option("--path <path>", "Ruta al proyecto (default: directorio actual)").action(initCommand);
 program.command("start").description("Levantar la plataforma Umbral (Neo4j + Dashboard web)").option("--port <port>", "Puerto para el dashboard (default: auto)").option("--no-detach", "Correr en primer plano (sin -d)").action(startCommand);
 program.command("stop").description("Detener la plataforma Umbral").action(stopCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umbral/cli",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "private": false,
   "type": "module",
   "bin": {