ozali 0.4.0 → 0.5.0

package/README.md

@@ -2,6 +2,8 @@
 
 # ozali
 
+[![npm version](https://img.shields.io/npm/v/ozali.svg)](https://www.npmjs.com/package/ozali)
+
 **Bootstrap de IA por equipo — calibra tus proyectos, genera una skill de ejecución con TDD/SDD, y mantiene memoria de equipo (Engram) con histórico aislado.**
 
 </div>
@@ -59,7 +61,7 @@ git clone <repo> && node ozali/cli/bin/ozali.mjs init
 ```bash
 ozali init      # detecta agente, instala la skill, aísla el histórico, instala+configura Engram
 ozali doctor    # health-check read-only (fuente de verdad, Engram, Cloud, Strict TDD, runner…)
-ozali update    # actualiza la skill instalada a la versión del paquete
+ozali update    # actualiza la instalación (skill ozali + ozali-jarvis + permisos) al paquete
 ozali sync      # lleva el histórico (docs + Engram) al repo de conocimiento de equipo
 ozali audit     # navega/audita la memoria de Engram del proyecto (o general)
 ```
@@ -69,6 +71,18 @@ ozali audit     # navega/audita la memoria de Engram del proyecto (o general)
 `--tui` para el navegador interactivo, `--search "<texto>"` para buscar y `--general` para forzar el
 alcance. Sin Engram, audita el histórico local de `.ozali/docs/`.
 
+### Actualizar a una versión nueva
+
+```bash
+pnpm add -g ozali@<versión>   # actualiza el CLI global (pinea la versión por el cooldown de pnpm)
+ozali update                  # en cada repo: refresca skill ozali + ozali-jarvis + permisos
+```
+
+`ozali update` también **crea ozali-jarvis** en repos inicializados con versiones anteriores. La skill
+`cdk` la **regenera tu agente** (no el CLI): tras `ozali update`, abre el agente y vuelve a correr la
+skill `ozali` para regenerar `cdk` con el contrato nuevo — tus docs por hito y el plan congelado se
+conservan.
+
 `init` también escribe un **perfil base de permisos** (`.claude/settings.json` para Claude Code,
 `opencode.json` para opencode) para reducir confirmaciones: deja libres comandos seguros y bloquea
 los destructivos. Es un template — tus reglas se conservan al re-correr `init`. Como Claude Code
@@ -76,8 +90,10 @@ los destructivos. Es un template — tus reglas se conservan al re-correr `init`
 confiable (`hasTrustDialogAccepted` en `~/.claude.json`); usa `--no-trust` para omitirlo.
 
 `init` también **instala Engram** y registra su MCP con `engram setup <agente>`: en modo
-interactivo te pregunta (default sí), y con `--yes` lo instala automáticamente. Usa brew en
-macOS/Linux, `go install` en Windows, con binario precompilado como fallback. Si prefieres no
+interactivo te pregunta (default sí), y con `--yes` lo instala automáticamente. En **Linux**
+descarga el **binario precompilado** correcto según tu arquitectura (amd64/arm64) a `~/.local/bin`
+(sin sudo); en **macOS** usa brew → `go install` con el binario como fallback; en **Windows**
+usa `go install`. Si algún paso falla, imprime instrucciones específicas de tu SO. Si prefieres no
 instalarlo, pasa `--no-engram` (arranca en modo `docs`). Opcionalmente habilita **Engram Cloud**
 (réplica de equipo opt-in) además del git-sync.
 
@@ -105,6 +121,8 @@ Claude Code y opencode (perfiles de permisos para ambos en
 | Uso previsto (modelo mental) | [docs/intended-usage.md](docs/intended-usage.md) |
 | Seguridad del instalador (npx/pnpm) | [docs/security.md](docs/security.md) |
 | Histórico aislado y memoria de equipo | [docs/team-history.md](docs/team-history.md) |
+| Desplegar Engram Cloud (VPS) | [docs/deploy-cloud-vps.md](docs/deploy-cloud-vps.md) |
+| Desplegar Engram Cloud (Google Cloud) | [docs/deploy-cloud-gcloud.md](docs/deploy-cloud-gcloud.md) |
 | Skill bootstrap | [skill/SKILL.md](skill/SKILL.md) |
 | Calibración de testing + TDD | [skill/references/calibration-blueprint.md](skill/references/calibration-blueprint.md) |
 | Blueprint de agentes | [skill/references/agents-blueprint.md](skill/references/agents-blueprint.md) |

package/cli/bin/ozali.mjs

@@ -3,7 +3,7 @@
 // Seguridad: sin dependencias ni scripts de instalación. Ejecuta seguro con
 // `pnpm dlx ozali` o `npx --ignore-scripts ozali`. Ver docs/security.md.
 import { c, err, pkgVersion } from "../lib/util.mjs";
-import { init, doctor, update, sync, audit } from "../lib/commands.mjs";
+import { init, doctor, update, sync, audit, cloud } from "../lib/commands.mjs";
 
 const HELP = `
 ${c.bold("ozali")} ${c.dim("v" + pkgVersion())} — bootstrap de IA por equipo (TDD/SDD + memoria Engram)
@@ -15,9 +15,10 @@ ${c.bold("Comandos:")}
   init      Detecta el agente (Claude Code/opencode), instala la skill ozali,
             aísla el histórico, configura Engram y el repo de conocimiento.
   doctor    Health-check read-only del proyecto (fuente de verdad, Engram, TDD…).
-  update    Actualiza la skill ozali instalada a la versión de este paquete.
+  update    Actualiza la instalación (skill ozali + ozali-jarvis + permisos) al paquete.
   sync      Sincroniza el histórico (docs + Engram) con el repo de conocimiento.
   audit     Navega/audita la memoria de Engram del proyecto (o general).
+  cloud     Gestiona Engram Cloud: status, upgrade, repair, dashboard, config.
 
 ${c.bold("Opciones comunes:")}
   --yes, -y            No interactivo: usa defaults.
@@ -27,13 +28,17 @@ ${c.bold("Opciones comunes:")}
   --knowledge-repo <p> (init) Ruta del repo de conocimiento.
   --no-engram          (init) No usar Engram; arranca en modo docs.
   --no-trust           (init) No marcar el workspace como confiable en Claude Code.
-  --no-jarvis          (init) No crear el orquestador ozali-jarvis.
+  --no-jarvis          (init/update) No crear/refrescar el orquestador ozali-jarvis.
   --import             (sync) Importa del repo de conocimiento a local.
   --push               (sync) Hace push al remoto del repo de conocimiento.
   --cloud              (sync) Replica también a Engram Cloud (si está habilitado).
   --general            (audit) Auditoría general (todos los proyectos en Engram).
   --tui                (audit) Abre el navegador interactivo de Engram.
   --search <q>         (audit) Busca <q> en la memoria.
+  --dashboard          (audit) Abre el dashboard de Engram Cloud en el navegador.
+  --conflicts          (audit) Lista conflictos de memoria pendientes.
+  --judged             (audit --conflicts) Muestra conflictos ya juzgados.
+  --stats              (audit --conflicts) Estadísticas de conflictos.
   -h, --help           Esta ayuda.    -v, --version   Versión.
 
 ${c.bold("Instalación segura:")}
@@ -57,6 +62,10 @@ function parseArgs(argv) {
     else if (a === "--general") opts.general = true;
     else if (a === "--tui") opts.tui = true;
     else if (a === "--search") opts.search = argv[++i];
+    else if (a === "--dashboard") opts.dashboard = true;
+    else if (a === "--conflicts") opts.conflicts = true;
+    else if (a === "--judged") opts.judged = true;
+    else if (a === "--stats") opts.stats = true;
     else if (a === "--agent") opts.agent = argv[++i];
     else if (a === "--scope") opts.scope = argv[++i];
     else if (a === "--knowledge-repo") opts.knowledgeRepo = argv[++i];
@@ -75,12 +84,15 @@ async function main() {
   if (!cmd || opts.help || cmd === "help") { console.log(HELP); return 0; }
 
   const cwd = process.cwd();
+  // Banner de versión: confirma qué versión de ozali está corriendo en cada comando.
+  console.log(`${c.bold("ozali")} ${c.dim("v" + pkgVersion())}`);
   switch (cmd) {
     case "init": return await init(cwd, opts);
     case "doctor": return doctor(cwd);
-    case "update": return update(cwd);
+    case "update": return update(cwd, opts);
     case "sync": return sync(cwd, opts);
     case "audit": return await audit(cwd, opts);
+    case "cloud": return await cloud(cwd, opts);
     default:
       err(`comando desconocido "${cmd}". Usa ${c.bold("ozali --help")}.`);
       return 1;