@umbral/cli 0.0.3 → 0.0.4

package/dist/index.js

@@ -853,8 +853,156 @@ function getTemplate(detection) {
   return TEMPLATES.find((t) => t.slugs.includes(detection.slug)) ?? null;
 }
 
+// src/claude-generate.ts
+import { 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 generateWithClaude(detections) {
+  if (detections.length === 0) return null;
+  const prompt = buildPrompt(detections);
+  try {
+    const result = spawnSync("claude", ["--print"], {
+      input: prompt,
+      encoding: "utf-8",
+      timeout: 12e4,
+      shell: true,
+      maxBuffer: 5 * 1024 * 1024
+    });
+    if (result.status !== 0 || !result.stdout) return null;
+    const jsonStr = extractJson(result.stdout);
+    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;
+  }
+}
+
 // src/generate.ts
-function generateProposals(detections) {
+function generateFromTemplates(detections) {
   const proposals = [];
   let counter = 1;
   for (const detection of detections) {
@@ -906,6 +1054,17 @@ function generateProposals(detections) {
   }
   return proposals;
 }
+function generateProposals(detections, onStatus) {
+  if (isClaudeAvailable()) {
+    onStatus?.("Generando EDEs con Claude Code...");
+    const claudeEdes = generateWithClaude(detections);
+    if (claudeEdes && claudeEdes.length > 0) {
+      return { proposals: claudeEdes, source: "claude" };
+    }
+    onStatus?.("Claude no pudo generar EDEs, usando templates...");
+  }
+  return { proposals: generateFromTemplates(detections), source: "templates" };
+}
 
 // src/ui.ts
 import { createInterface } from "readline/promises";
@@ -1340,7 +1499,19 @@ async function initCommand(options) {
 `);
     }
   }
-  const proposals = generateProposals(analysis.detections);
+  w("\n");
+  const { proposals, source } = generateProposals(
+    analysis.detections,
+    (msg) => w(`  ${msg}
+`)
+  );
+  if (source === "claude") {
+    w(`  \u2713 ${proposals.length} EDEs generadas con Claude Code (IA)
+`);
+  } else {
+    w(`  \u21B3 EDEs generadas desde templates locales
+`);
+  }
   if (proposals.length === 0) {
     w("\n  No hay propuestas de EDEs para generar.\n");
     w("  Configurando infraestructura base...\n\n");
@@ -1636,7 +1807,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.4");
 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.4",
   "private": false,
   "type": "module",
   "bin": {