shilo-cli 0.6.0 → 0.8.0

package/bin/shilo.js

@@ -1,165 +1,197 @@
-#!/usr/bin/env node
-'use strict';
-
-const { parseArgs } = require('../src/args');
-const ui = require('../src/ui');
-
-const VERSION = require('../package.json').version;
-
-const HELP = `
-${ui.c.bold('shilo')} — sube carpetas locales a repositorios de Shilo.
-
-${ui.c.bold('Uso:')}
-  shilo <comando> [opciones]
-
-${ui.c.bold('Comandos:')}
-  login              Inicia sesión y guarda credenciales cifradas (~/.shilo/config.json).
-  whoami             Muestra la sesión activa.
-  logout             Cierra sesión (borra credenciales locales).
-  init [carpeta]     Ata una carpeta a un repo de Shilo (--project <uuid>).
-  status [carpeta]   Compara local vs remoto sin bajar nada (¿estoy desactualizado?).
-  push [carpeta]     Sube una carpeta al repo de Shilo (crea/actualiza + commit).
-  pull [carpeta]     Baja un repo de Shilo a una carpeta local (deja .shilo.json).
-  log [archivo]      Historial de commits del proyecto o de un archivo.
-  diff [archivo]     Diferencias entre tu copia local y la remota.
-  help               Muestra esta ayuda.
-
-${ui.c.bold('Opciones de login:')}
-  --email <e>        Email (si se omite, se pregunta).
-  --password <p>     Contraseña (si se omite, se pregunta oculta).
-  --token <pat>      Token de acceso personal (en vez de email + contraseña).
-  --token -          Lee el token de stdin (no queda en el historial del shell).
-  --base-url <url>   Servidor Shilo (default: https://www.shilo.city).
-  ${ui.c.dim('También se lee de la variable de entorno SHILO_TOKEN.')}
-
-${ui.c.bold('Opciones de init:')}
-  --project <uuid>   Id del proyecto de Shilo (requerido).
-  --token <pat>      Token de acceso personal (evita el "login" previo; o SHILO_TOKEN).
-  --push             Sube la carpeta apenas queda atada (pregunta, salvo --yes).
-  --pull             Baja la carpeta apenas queda atada (pregunta, salvo --yes).
-  --base-url <url>   Servidor Shilo.
-  --force            No verifica acceso ni pregunta antes de sobrescribir.
-
-${ui.c.bold('Opciones de status:')}
-  --project <uuid>   Proyecto a comparar (pisa el .shilo.json de la carpeta).
-  --short            Sólo las rutas, sin autor ni fecha.
-  --json             Salida JSON (para scripts).
-  --base-url <url>   Servidor Shilo.
-  ${ui.c.dim('Exit code 2 = el remoto tiene cambios que no tenés.')}
-
-${ui.c.bold('Opciones de push:')}
-  --project <uuid>   Proyecto destino (pisa el .shilo.json de la carpeta).
-  -m, --message <m>  Mensaje del commit.
-  --card <id>        Id de tarjeta/tablero; se agrega al mensaje como [card: id].
-  --dry-run          Muestra qué haría (y quién tocó cada archivo), sin subir nada.
-  --yes              No pide confirmación.
-  --allow-secrets    Sube igual los archivos donde se detectaron posibles secretos.
-  --concurrency <n>  Requests en paralelo (1-32, default 8; o SHILO_CONCURRENCY).
-  --no-index         Ignora el índice local (.shilo/index.json) y recompara todo.
-  --verbose          Lista archivo por archivo en vez de resumir.
-  --base-url <url>   Servidor Shilo.
-  ${ui.c.dim('Respeta .gitignore y .shiloignore, incluidos los de subcarpetas.')}
-
-${ui.c.bold('Opciones de pull:')}
-  --project <uuid>   Proyecto origen (pisa el .shilo.json de la carpeta).
-  --dry-run          Muestra qué cambiaría localmente, sin bajar nada.
-  --yes              No pide confirmación.
-  --force            Sobrescribe también los archivos locales que difieren.
-  --base-url <url>   Servidor Shilo.
-
-${ui.c.bold('Opciones de log:')}
-  -n <N>             Cuántos commits mirar (1-100, default 20).
-  --files            Lista los archivos de cada commit.
-  --json             Salida JSON.
-  --project <uuid>   Proyecto (pisa el .shilo.json de la carpeta).
-
-${ui.c.bold('Opciones de diff:')}
-  --context <n>      Líneas de contexto (0-20, default 3).
-  --stat             Sólo el resumen de líneas agregadas/quitadas.
-  --project <uuid>   Proyecto (pisa el .shilo.json de la carpeta).
-  ${ui.c.dim('Sin archivo, resume todo lo que difiere. Exit code 1 = hay diferencias.')}
-
-${ui.c.bold('Globales:')}
-  -v, --version      Versión del CLI.
-  -h, --help         Ayuda.
-`;
-
-const COMMANDS = {
-  login: () => require('../src/commands/login'),
-  whoami: () => require('../src/commands/whoami'),
-  logout: () => require('../src/commands/logout'),
-  init: () => require('../src/commands/init'),
-  push: () => require('../src/commands/push'),
-  pull: () => require('../src/commands/pull'),
-  status: () => require('../src/commands/status'),
-  log: () => require('../src/commands/log'),
-  diff: () => require('../src/commands/diff'),
-};
-
-async function main() {
-  const argv = process.argv.slice(2);
-  const parsed = parseArgs(argv, {
-    // 'push' tiene que estar acá: la lista de booleanos es global, y sin
-    // registrarlo `shilo init --project X --push .` se comería el `.` como
-    // valor de --push, perdiendo el positional de la carpeta.
-    booleans: [
-      'help', 'version', 'h', 'v', 'dry-run', 'yes', 'force', 'push', 'pull',
-      'json', 'short', 'stat', 'files', 'allow-secrets', 'no-index', 'verbose',
-    ],
-    aliases: { h: 'help', v: 'version', m: 'message' },
-  });
-
-  const cmd = parsed._[0];
-
-  if (parsed.version && !cmd) {
-    console.log(VERSION);
-    return 0;
-  }
-  if (!cmd || cmd === 'help' || (parsed.help && !cmd)) {
-    console.log(HELP);
-    return 0;
-  }
-
-  const loader = COMMANDS[cmd];
-  if (!loader) {
-    ui.error(`Comando desconocido: "${cmd}".`);
-    console.log(HELP);
-    return 1;
-  }
-
-  if (parsed.help) {
-    console.log(HELP);
-    return 0;
-  }
-
-  // Los positionals del comando (sin el nombre del comando).
-  const commandArgs = { ...parsed, _: parsed._.slice(1) };
-  const handler = loader();
-  return handler(commandArgs);
-}
-
-/**
- * Termina con `code` sin llamar a `process.exit()` de inmediato.
- *
- * Llamarlo justo después de un `fetch` aborta el proceso en Windows con
- * `Assertion failed: !(handle->flags & UV_HANDLE_CLOSING)`: libuv cierra dos
- * veces el handle del pool de conexiones de undici. El comando ya imprimió todo
- * y hasta guardó en disco, pero el shell recibe 127 en vez de 0 — o sea que
- * cualquier script o CI que chequee el resultado de `shilo push` lee basura.
- *
- * Dejar que el loop se vacíe solo evita el crash y no cuesta nada: las conexiones
- * de undici no tienen ref, así que el proceso sale igual de rápido. El timer es
- * el paracaídas por si algo queda colgado; sin ref, no mantiene vivo al proceso
- * por sí mismo, sólo actúa si ya lo estaba.
- */
-function finish(code) {
-  process.exitCode = code;
-  setTimeout(() => process.exit(code), 5000).unref();
-}
-
-main()
-  .then((code) => finish(typeof code === 'number' ? code : 0))
-  .catch((err) => {
-    ui.error(err && err.message ? err.message : String(err));
-    finish(1);
-  });
+#!/usr/bin/env node
+'use strict';
+
+const { parseArgs } = require('../src/args');
+const ui = require('../src/ui');
+
+const VERSION = require('../package.json').version;
+
+const HELP = `
+${ui.c.bold('shilo')} — sube carpetas locales a repositorios de Shilo.
+
+${ui.c.bold('Uso:')}
+  shilo <comando> [opciones]
+
+${ui.c.bold('Comandos:')}
+  login              Inicia sesión y guarda credenciales cifradas (~/.shilo/config.json).
+  whoami             Muestra la sesión activa.
+  logout             Cierra sesión (borra credenciales locales).
+  init [carpeta]     Ata una carpeta a un repo de Shilo (--project <uuid>).
+  status [carpeta]   Compara local vs remoto sin bajar nada (¿estoy desactualizado?).
+  push [carpeta]     Sube una carpeta al repo de Shilo (crea/actualiza + commit).
+  pull [carpeta]     Baja un repo de Shilo a una carpeta local (deja .shilo.json).
+  log [archivo]      Historial de commits del proyecto o de un archivo.
+  diff [archivo]     Diferencias entre tu copia local y la remota.
+  review [versión]   Quién revisó una versión, o dejar tu revisión.
+  export <carpeta>   Escribe la historia del proyecto como un repositorio Git.
+  help               Muestra esta ayuda.
+
+${ui.c.bold('Opciones de login:')}
+  --email <e>        Email (si se omite, se pregunta).
+  --password <p>     Contraseña (si se omite, se pregunta oculta).
+  --token <pat>      Token de acceso personal (en vez de email + contraseña).
+  --token -          Lee el token de stdin (no queda en el historial del shell).
+  --base-url <url>   Servidor Shilo (default: https://www.shilo.city).
+  ${ui.c.dim('También se lee de la variable de entorno SHILO_TOKEN.')}
+
+${ui.c.bold('Opciones de init:')}
+  --project <uuid>   Id del proyecto de Shilo (requerido).
+  --token <pat>      Token de acceso personal (evita el "login" previo; o SHILO_TOKEN).
+  --push             Sube la carpeta apenas queda atada (pregunta, salvo --yes).
+  --pull             Baja la carpeta apenas queda atada (pregunta, salvo --yes).
+  --base-url <url>   Servidor Shilo.
+  --force            No verifica acceso ni pregunta antes de sobrescribir.
+
+${ui.c.bold('Opciones de status:')}
+  --project <uuid>   Proyecto a comparar (pisa el .shilo.json de la carpeta).
+  --short            Sólo las rutas, sin autor ni fecha.
+  --show-ignored     Lista los archivos del remoto ignorados localmente.
+  --json             Salida JSON (para scripts).
+  --base-url <url>   Servidor Shilo.
+  ${ui.c.dim('Exit code 2 = el remoto tiene cambios que no tenés.')}
+
+${ui.c.bold('Opciones de push:')}
+  --project <uuid>   Proyecto destino (pisa el .shilo.json de la carpeta).
+  -m, --message <m>  Mensaje del commit.
+  --only <ruta>      Sube sólo esa ruta (archivo o carpeta). Repetible.
+  --card <id>        Id de tarjeta/tablero; se agrega al mensaje como [card: id].
+  --agent <nombre>   Declara que lo escribió un agente (ej: claude-code).
+  --model <modelo>   Qué modelo, junto con --agent.
+  --session <id>     Id de la conversación, para agrupar guardados.
+  --prompt <texto>   El pedido que originó el cambio; se guarda con el cambio.
+  --prompt-file <f>  Igual, leyendo el pedido de un archivo (máx. 64 KB).
+  --dry-run          Muestra qué haría (y quién tocó cada archivo), sin subir nada.
+  --yes              No pide confirmación.
+  --allow-secrets    Sube igual los archivos donde se detectaron posibles secretos.
+  --concurrency <n>  Requests en paralelo (1-32, default 8; o SHILO_CONCURRENCY).
+  --no-index         Ignora el índice local (.shilo/index.json) y recompara todo.
+  --verbose          Lista archivo por archivo en vez de resumir.
+  --base-url <url>   Servidor Shilo.
+  ${ui.c.dim('Respeta .gitignore y .shiloignore, incluidos los de subcarpetas.')}
+
+${ui.c.bold('Opciones de pull:')}
+  --project <uuid>   Proyecto origen (pisa el .shilo.json de la carpeta).
+  --dry-run          Muestra qué cambiaría localmente, sin bajar nada.
+  --yes              No pide confirmación.
+  --force            Sobrescribe también los archivos locales que difieren.
+  --include-ignored  Baja también lo que está ignorado localmente.
+  --base-url <url>   Servidor Shilo.
+  ${ui.c.dim('Con --force, la versión local pisada queda en .shilo/respaldo/<fecha>/.')}
+
+${ui.c.bold('Opciones de log:')}
+  -n <N>             Cuántos commits mirar (1-100, default 20).
+  --files            Lista los archivos de cada commit.
+  --json             Salida JSON.
+  --project <uuid>   Proyecto (pisa el .shilo.json de la carpeta).
+
+${ui.c.bold('Opciones de diff:')}
+  --context <n>      Líneas de contexto (0-20, default 3).
+  --stat             Sólo el resumen de líneas agregadas/quitadas.
+  --project <uuid>   Proyecto (pisa el .shilo.json de la carpeta).
+  ${ui.c.dim('Sin archivo, resume todo lo que difiere. Exit code 1 = hay diferencias.')}
+
+${ui.c.bold('Opciones de review:')}
+  --aprobado         Deja constancia de que la miraste y está bien.
+  --reparos          Está bien con reparos (requiere -m).
+  --rechazado        No debería quedar así (requiere -m).
+  -m, --message <m>  La nota de la revisión.
+  --json             Salida JSON.
+  --project <uuid>   Proyecto (pisa el .shilo.json de la carpeta).
+  ${ui.c.dim('Sin versión es la actual; si no, lo que imprime "shilo log" (7+ caracteres).')}
+
+${ui.c.bold('Opciones de export:')}
+  --project <uuid>   Proyecto (si no, el de la exportación anterior o el .shilo.json).
+  --json             Informe en JSON.
+  --base-url <url>   Servidor Shilo.
+  ${ui.c.dim('La primera vez, a una carpeta vacía; después sólo trae lo nuevo. Público sin sesión.')}
+
+${ui.c.bold('Globales:')}
+  -v, --version      Versión del CLI.
+  -h, --help         Ayuda.
+`;
+
+const COMMANDS = {
+  login: () => require('../src/commands/login'),
+  whoami: () => require('../src/commands/whoami'),
+  logout: () => require('../src/commands/logout'),
+  init: () => require('../src/commands/init'),
+  push: () => require('../src/commands/push'),
+  pull: () => require('../src/commands/pull'),
+  status: () => require('../src/commands/status'),
+  log: () => require('../src/commands/log'),
+  diff: () => require('../src/commands/diff'),
+  review: () => require('../src/commands/review'),
+  export: () => require('../src/commands/export'),
+};
+
+async function main() {
+  const argv = process.argv.slice(2);
+  const parsed = parseArgs(argv, {
+    // 'push' tiene que estar acá: la lista de booleanos es global, y sin
+    // registrarlo `shilo init --project X --push .` se comería el `.` como
+    // valor de --push, perdiendo el positional de la carpeta.
+    booleans: [
+      'help', 'version', 'h', 'v', 'dry-run', 'yes', 'force', 'push', 'pull',
+      'json', 'short', 'stat', 'files', 'allow-secrets', 'no-index', 'verbose',
+      'show-ignored', 'include-ignored', 'aprobado', 'reparos', 'rechazado',
+    ],
+    aliases: { h: 'help', v: 'version', m: 'message' },
+    // `--only` se repite (un selector por ruta): sin esto la última aparición
+    // pisaría a las anteriores y un push de dos archivos subiría uno solo.
+    multiple: ['only'],
+  });
+
+  const cmd = parsed._[0];
+
+  if (parsed.version && !cmd) {
+    console.log(VERSION);
+    return 0;
+  }
+  if (!cmd || cmd === 'help' || (parsed.help && !cmd)) {
+    console.log(HELP);
+    return 0;
+  }
+
+  const loader = COMMANDS[cmd];
+  if (!loader) {
+    ui.error(`Comando desconocido: "${cmd}".`);
+    console.log(HELP);
+    return 1;
+  }
+
+  if (parsed.help) {
+    console.log(HELP);
+    return 0;
+  }
+
+  // Los positionals del comando (sin el nombre del comando).
+  const commandArgs = { ...parsed, _: parsed._.slice(1) };
+  const handler = loader();
+  return handler(commandArgs);
+}
+
+/**
+ * Termina con `code` sin llamar a `process.exit()` de inmediato.
+ *
+ * Llamarlo justo después de un `fetch` aborta el proceso en Windows con
+ * `Assertion failed: !(handle->flags & UV_HANDLE_CLOSING)`: libuv cierra dos
+ * veces el handle del pool de conexiones de undici. El comando ya imprimió todo
+ * y hasta guardó en disco, pero el shell recibe 127 en vez de 0 — o sea que
+ * cualquier script o CI que chequee el resultado de `shilo push` lee basura.
+ *
+ * Dejar que el loop se vacíe solo evita el crash y no cuesta nada: las conexiones
+ * de undici no tienen ref, así que el proceso sale igual de rápido. El timer es
+ * el paracaídas por si algo queda colgado; sin ref, no mantiene vivo al proceso
+ * por sí mismo, sólo actúa si ya lo estaba.
+ */
+function finish(code) {
+  process.exitCode = code;
+  setTimeout(() => process.exit(code), 5000).unref();
+}
+
+main()
+  .then((code) => finish(typeof code === 'number' ? code : 0))
+  .catch((err) => {
+    ui.error(err && err.message ? err.message : String(err));
+    finish(1);
+  });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shilo-cli",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "CLI para sincronizar carpetas locales con repositorios de Shilo: push, pull, status, log y diff.",
   "keywords": [
     "shilo",