specatlas 0.1.39 → 0.1.40

package/dist/bin.js

@@ -36916,6 +36916,64 @@ function seccion(tema, titulo, detalle) {
   const cabeza = pinta(tema, ["negrita"], titulo);
   return detalle ? `${cabeza} ${pinta(tema, "gris", detalle)}` : cabeza;
 }
+var MARCA = [
+  [20, 184, 166],
+  [37, 99, 235],
+  [124, 58, 237]
+];
+function soportaDegradado(env = process.env) {
+  const colorterm = env["COLORTERM"] ?? "";
+  return colorterm.includes("truecolor") || colorterm.includes("24bit") || env["TERM_PROGRAM"] === "vscode" || Boolean(env["WT_SESSION"]);
+}
+function pintaRGB(tema, [r, g, b], texto) {
+  if (!tema.color || texto === "") return texto;
+  return `\x1B[38;2;${r};${g};${b}m${texto}\x1B[39m`;
+}
+function mezcla(a, b, t) {
+  return [Math.round(a[0] + (b[0] - a[0]) * t), Math.round(a[1] + (b[1] - a[1]) * t), Math.round(a[2] + (b[2] - a[2]) * t)];
+}
+function degradado(tema, texto, paradas = MARCA, env = process.env) {
+  if (!tema.color) return texto;
+  if (!soportaDegradado(env)) return pinta(tema, "cian", texto);
+  const visibles = [...texto];
+  const ultimo = Math.max(1, visibles.length - 1);
+  return visibles.map((caracter, indice) => {
+    if (caracter.trim() === "") return caracter;
+    const posicion = indice / ultimo * (paradas.length - 1);
+    const tramo = Math.min(paradas.length - 2, Math.floor(posicion));
+    return pintaRGB(tema, mezcla(paradas[tramo], paradas[tramo + 1], posicion - tramo), caracter);
+  }).join("");
+}
+var LETRAS = {
+  S: ["\u2588\u2588\u2588\u2588\u2588", "\u2588    ", "\u2588\u2588\u2588\u2588\u2588", "    \u2588", "\u2588\u2588\u2588\u2588\u2588"],
+  P: ["\u2588\u2588\u2588\u2588\u2588", "\u2588   \u2588", "\u2588\u2588\u2588\u2588\u2588", "\u2588    ", "\u2588    "],
+  E: ["\u2588\u2588\u2588\u2588\u2588", "\u2588    ", "\u2588\u2588\u2588\u2588 ", "\u2588    ", "\u2588\u2588\u2588\u2588\u2588"],
+  C: ["\u2588\u2588\u2588\u2588\u2588", "\u2588    ", "\u2588    ", "\u2588    ", "\u2588\u2588\u2588\u2588\u2588"],
+  A: ["\u2588\u2588\u2588\u2588\u2588", "\u2588   \u2588", "\u2588\u2588\u2588\u2588\u2588", "\u2588   \u2588", "\u2588   \u2588"],
+  T: ["\u2588\u2588\u2588\u2588\u2588", "  \u2588  ", "  \u2588  ", "  \u2588  ", "  \u2588  "],
+  L: ["\u2588    ", "\u2588    ", "\u2588    ", "\u2588    ", "\u2588\u2588\u2588\u2588\u2588"]
+};
+var ALTO_LETRERO = 5;
+var NOMBRE = "SPECATLAS";
+var ANCHO_LETRERO = NOMBRE.length * 6 - 1;
+function letrero(tema) {
+  if (!tema.unicode || tema.ancho < ANCHO_LETRERO + 4) return void 0;
+  const letras = [...NOMBRE].map((letra) => LETRAS[letra]);
+  if (letras.some((letra) => letra === void 0)) return void 0;
+  return Array.from({ length: ALTO_LETRERO }, (_, fila) => letras.map((letra) => letra[fila]).join(" "));
+}
+function banner(tema, version, lema = "el proceso se verifica, no se conf\xEDa") {
+  const pie = pinta(tema, "gris", `${version}  ${simbolos(tema).separador}  ${lema}`);
+  const letras = letrero(tema);
+  if (!letras) return ["", `  ${degradado(tema, "SpecAtlas")}`, `  ${pie}`, ""];
+  return ["", ...letras.map((fila) => `  ${degradado(tema, fila)}`), `  ${pie}`, ""];
+}
+function truncar(texto, maximo) {
+  if (maximo <= 1 || anchoVisible(texto) <= maximo) return texto;
+  const corte = texto.slice(0, maximo - 1);
+  const espacio = corte.lastIndexOf(" ");
+  return `${(espacio > maximo * 0.6 ? corte.slice(0, espacio) : corte).trimEnd()}\u2026`;
+}
 
 // src/version.ts
 import { readFileSync } from "fs";
@@ -38278,27 +38336,72 @@ async function runHash(ctx) {
 }
 
 // src/commands/help.ts
+var GRUPOS = [
+  { titulo: "Empezar", detalle: "poner el flujo en marcha", comandos: ["init", "adopt", "new"] },
+  { titulo: "El ciclo", detalle: "de lo acordado a la evidencia", comandos: ["approve", "amend", "verify", "review", "archive", "pause", "resume"] },
+  { titulo: "Saber d\xF3nde est\xE1s", detalle: "qu\xE9 toca y c\xF3mo va", comandos: ["status", "next", "watch", "metrics", "impact", "explain"] },
+  { titulo: "Comprobar", detalle: "que encaja y que funciona", comandos: ["validate", "trace", "waves", "analyze", "ci", "doctor", "drift", "packs", "contracts", "clarify"] },
+  { titulo: "Compartir", detalle: "lo que otros van a leer", comandos: ["present", "docs", "mockup", "issue"] },
+  { titulo: "El proyecto", detalle: "configuraci\xF3n y herramientas", comandos: ["adapters", "profile", "link", "upgrade", "self-update", "hash", "run", "mcp", "version", "help"] }
+];
+var TONOS = ["verde", "cian", "azul", "amarillo", "morado", "gris"];
+function detalleDeComando(tema, nombre) {
+  const spec = CATALOG.find((item) => item.name === nombre);
+  if (!spec) return [];
+  const s = simbolos(tema);
+  return [
+    "",
+    `  ${pinta(tema, ["negrita"], `satlas ${spec.name}`)}  ${pinta(tema, "gris", spec.description)}`,
+    "",
+    `    ${pinta(tema, "cian", s.flecha)} ${pinta(tema, "cian", spec.usage ?? `satlas ${spec.name}`)}`,
+    ...spec.flags.length > 0 ? ["", `    ${pinta(tema, "gris", "opciones:")} ${spec.flags.map((flag3) => pinta(tema, "gris", `--${flag3}`)).join(pinta(tema, "gris", " \xB7 "))}`] : [],
+    ""
+  ];
+}
 async function runHelp(ctx, commandName) {
   const language = ctx.language;
-  const lines = [];
-  lines.push(`${msg("cli.title", language)} ${cliVersion()} \u2014 kernel determinista de Spec-Driven Development`);
-  lines.push("");
+  const tema = detectarTema();
+  const s = simbolos(tema);
   if (commandName) {
-    const spec = CATALOG.find((c) => c.name === commandName);
+    const spec = CATALOG.find((item) => item.name === commandName);
     if (!spec) {
-      return { exitCode: 2, diagnostics: [{ code: "ATLAS-CLI-001", severity: "error", message: `${msg("cli.unknownCommand", language)}: ${commandName}` }], text: lines };
+      return {
+        exitCode: 2,
+        diagnostics: [{ code: "ATLAS-CLI-001", severity: "error", message: `${msg("cli.unknownCommand", language)}: ${commandName}`, suggestion: "Ejecuta `satlas help` para ver los comandos por grupo" }]
+      };
     }
-    lines.push(`satlas ${spec.name} \u2014 ${spec.description}`);
-    lines.push(`  ${spec.usage ?? `satlas ${spec.name}`}`);
-    return { exitCode: 0, diagnostics: [], text: lines };
+    return { exitCode: 0, diagnostics: [], text: detalleDeComando(tema, commandName) };
   }
-  lines.push(msg("cli.usage", language));
+  const lines = banner(tema, cliVersion());
+  lines.push(filaAlineada([{ texto: `  ${pinta(tema, "gris", "uso")}`, ancho: 8 }, { texto: pinta(tema, "negrita", "satlas <comando> [opciones]") }]));
+  lines.push(filaAlineada([{ texto: `  ${pinta(tema, "gris", "ayuda")}`, ancho: 8 }, { texto: pinta(tema, "gris", "satlas help <comando>   \xB7   todos aceptan --json") }]));
   lines.push("");
-  for (const spec of CATALOG) {
-    lines.push(`  ${spec.name.padEnd(9)} ${spec.description}`);
+  lines.push(`  ${pinta(tema, "cian", s.flecha)} ${pinta(tema, ["cian", "negrita"], "satlas next")}   ${pinta(tema, "gris", "qu\xE9 toca hacer ahora mismo en este proyecto")}`);
+  lines.push("");
+  const ancho = Math.max(...CATALOG.map((spec) => spec.name.length)) + 2;
+  const anchoDescripcion = Math.max(24, tema.ancho - ancho - 8);
+  GRUPOS.forEach((grupo, indice) => {
+    const disponibles = grupo.comandos.filter((nombre) => CATALOG.some((spec) => spec.name === nombre));
+    if (disponibles.length === 0) return;
+    lines.push(`  ${pinta(tema, [TONOS[indice % TONOS.length], "negrita"], grupo.titulo.toUpperCase())}  ${pinta(tema, "gris", grupo.detalle)}`);
+    for (const nombre of disponibles) {
+      const spec = CATALOG.find((item) => item.name === nombre);
+      lines.push(filaAlineada([{ texto: `    ${pinta(tema, "negrita", spec.name)}`, ancho: ancho + 4 }, { texto: pinta(tema, "gris", truncar(spec.description, anchoDescripcion)) }]));
+    }
+    lines.push("");
+  });
+  const agrupados = new Set(GRUPOS.flatMap((grupo) => grupo.comandos));
+  const sueltos = CATALOG.filter((spec) => !agrupados.has(spec.name));
+  if (sueltos.length > 0) {
+    lines.push(`  ${pinta(tema, ["gris", "negrita"], "OTROS")}`);
+    for (const spec of sueltos) {
+      lines.push(filaAlineada([{ texto: `    ${pinta(tema, "negrita", spec.name)}`, ancho: ancho + 4 }, { texto: pinta(tema, "gris", truncar(spec.description, anchoDescripcion)) }]));
+    }
+    lines.push("");
   }
+  lines.push(`  ${pinta(tema, "gris", `salida: 0 ${s.separador} 1 hallazgos ${s.separador} 2 uso ${s.separador} 3 E/S`)}`);
+  lines.push(`  ${pinta(tema, "gris", "documentaci\xF3n: ")}${degradado(tema, "github.com/AlonsoAM/specatlas")}`);
   lines.push("");
-  lines.push("Documentaci\xF3n: ARQUITECTURA.md y PROPUESTA.md en el repositorio.");
   return { exitCode: 0, diagnostics: [], text: lines };
 }
 
@@ -40256,7 +40359,7 @@ var HANDLERS2 = {
   archive: runArchive,
   "self-update": runSelfUpdate,
   version: async () => ({ exitCode: 0, data: { version: cliVersion() }, diagnostics: [], text: [`specatlas ${cliVersion()}`] }),
-  help: (ctx) => runHelp(ctx)
+  help: (ctx) => runHelp(ctx, ctx.positionals[0])
 };
 var COMMANDS = Object.fromEntries(
   CATALOG.map((spec) => [spec.name, { description: spec.description, flags: spec.flags, handler: HANDLERS2[spec.name] }])

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specatlas",
-  "version": "0.1.39",
+  "version": "0.1.40",
   "description": "SpecAtlas: kernel determinista de Spec-Driven Development (CLI)",
   "license": "MIT",
   "type": "module",