ozali 0.9.0 → 0.10.0

package/README.md

@@ -137,7 +137,8 @@ interactivo te pregunta (default sí), y con `--yes` lo instala automáticamente
 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**
+instalarlo, pasa `--no-engram` (arranca en modo `docs`). Más tarde puedes instalarlo con
+`ozali install-engram` bajo demanda. Opcionalmente habilita **Engram Cloud**
 (réplica de equipo opt-in) además del git-sync.
 
 `init` también crea **ozali-jarvis**, un **orquestador always-on**: persona en `CLAUDE.md`/`AGENTS.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, cloud, workspace } from "../lib/commands.mjs";
+import { init, doctor, update, sync, audit, cloud, workspace, installEngramCmd } from "../lib/commands.mjs";
 
 const HELP = `
 ${c.bold("ozali")} ${c.dim("v" + pkgVersion())} — bootstrap de IA por equipo (TDD/SDD + memoria Engram)
@@ -14,6 +14,9 @@ ${c.bold("Uso:")}
 ${c.bold("Comandos:")}
   init      Detecta el agente (Claude Code/opencode), instala las skills ozali y
             ozali-commit, aísla el histórico, configura Engram y el repo de conocimiento.
+  install-engram
+            Instala (o reinstala) Engram bajo demanda, registra su MCP en el agente
+            y activa modo hybrid. Úsalo cuando saltaste la instalación en init.
   workspace Multi-repo: escanea los repos de la carpeta raíz, remedia los que no tienen
             ozali init, guía la calibración y escribe la config para trabajar en conjunto.
             Con --doctor / --update opera sobre TODOS los repos miembros desde la raíz.
@@ -64,6 +67,7 @@ function parseArgs(argv) {
     else if (a === "--push") opts.push = true;
     else if (a === "--cloud") opts.cloud = true;
     else if (a === "--obsidian") opts.obsidian = true;
+    else if (a === "--force") opts.force = true;
     else if (a === "--no-engram") opts.noEngram = true;
     else if (a === "--no-trust") opts.noTrust = true;
     else if (a === "--no-jarvis") opts.noJarvis = true;
@@ -105,6 +109,7 @@ async function main() {
     case "sync": return await sync(cwd, opts);
     case "audit": return await audit(cwd, opts);
     case "cloud": return await cloud(cwd, opts);
+    case "install-engram": return await installEngramCmd(cwd, opts);
     default:
       err(`comando desconocido "${cmd}". Usa ${c.bold("ozali --help")}.`);
       return 1;

package/cli/lib/commands.mjs

@@ -1395,6 +1395,83 @@ function cdkCanonicalVersion() {
   }
 }
 
+// =========================================================== install-engram ===
+export async function installEngramCmd(cwd, opts) {
+  step("ozali install-engram — instalar o reparar Engram bajo demanda");
+  const env = detectAll(cwd);
+  const cfg = readJSON(CONFIG_PATH(cwd));
+  let needsInstall = !env.engram.available;
+
+  if (env.engram.available) {
+    const online = tryExec("engram", ["doctor"], { cwd }) !== null;
+    if (online && !opts.force) {
+      ok(`Engram ya está instalado y responde (${env.engram.bin}).`);
+      info("Usa --force si quieres forzar una reinstalación.");
+    } else if (online && opts.force) {
+      warn("Forzando reinstalación de Engram (--force)…");
+      needsInstall = true;
+    } else {
+      warn("Engram está en PATH pero no responde (engram doctor falló). Reinstalando…");
+      needsInstall = true;
+    }
+  }
+
+  if (needsInstall) {
+    if (opts.dryRun) {
+      info("(dry-run) Aquí instalaría Engram.");
+      return 0;
+    }
+    const installed = installEngram();
+    if (!installed) {
+      warn("No se pudo instalar Engram automáticamente.");
+      printEngramManualInstructions(cfg?.agent || "both");
+      return 1;
+    }
+  }
+
+  // Configurar agente MCP
+  let agent = opts.agent || (cfg && cfg.agent);
+  if (!agent && !opts.yes) {
+    agent = await select("¿Para qué agente configuro Engram?", [
+      { value: "claude-code", label: "Claude Code" },
+      { value: "opencode", label: "opencode" },
+      { value: "both", label: "Ambos" },
+    ], 2);
+  } else if (!agent) {
+    agent = "both";
+  }
+
+  if (agent === "claude-code" || agent === "both") {
+    info("Registrando MCP en Claude Code…");
+    spawnCmd("engram", ["setup", "claude-code"]);
+  }
+  if (agent === "opencode" || agent === "both") {
+    info("Registrando MCP en opencode…");
+    spawnCmd("engram", ["setup", "opencode"]);
+  }
+
+  // Actualizar config de ozali si existe
+  if (cfg) {
+    let wrote = false;
+    if (cfg.memoryMode === "docs") {
+      cfg.memoryMode = "hybrid";
+      wrote = true;
+      ok("Modo de memoria actualizado a " + c.bold("hybrid") + " en .ozali/config.json.");
+    }
+    if (!cfg.agent) {
+      cfg.agent = agent;
+      wrote = true;
+    }
+    if (wrote) writeJSON(CONFIG_PATH(cwd), cfg);
+  } else {
+    warn("No hay configuración de ozali en esta ruta (corre " + c.bold("ozali init") + " para completar el setup).");
+    info("Engram quedó instalado; solo falta el config de ozali para integrarlo al flujo.");
+  }
+
+  ok("Engram listo. Reinicia tu agente para que cargue el servidor MCP de Engram.");
+  return 0;
+}
+
 // ============================================================= sync ===========
 export async function sync(cwd, opts) {
   step(`ozali sync${opts.import ? " --import" : ""}${opts.cloud ? " --cloud" : ""} — histórico ↔ repo de conocimiento`);

package/docs/guia-de-uso.md

@@ -81,11 +81,11 @@ Lleva el histórico y la memoria al repo de conocimiento del equipo. Tus compañ
 | Comando | Qué hace |
 |---|---|
 | `ozali init` | Prepara el proyecto (lo corres una vez por repo). |
+| `ozali install-engram` | Instala (o reinstala) Engram y registra su MCP cuando saltaste la instalación en `init`. |
 | `ozali workspace` | Configura varios repos de una carpeta para trabajar en conjunto (lo corres en la carpeta raíz). |
 | `ozali doctor` | Revisa que todo esté bien. Es solo lectura, no cambia nada. |
 | `ozali update` | Actualiza skill ozali + ozali-jarvis + permisos (y guía cómo regenerar cdk). |
 | `ozali sync` | Sube el histórico/memoria al repo de equipo. |
-| `ozali sync --import` | Baja lo que el equipo ya guardó. |
 | `ozali audit` | Navega/audita la memoria de Engram (qué se ha hecho). |
 
 ¿Algo no funciona? Corre **`ozali doctor`** primero: te dice qué falta y cómo arreglarlo.
@@ -146,8 +146,8 @@ no puede, te deja las instrucciones. Con Engram, tu agente **recuerda** decision
 convenciones — y los recupera en futuras sesiones.
 
 ¿No quieres Engram ahora? Pasa `--no-engram` y ozali arranca en modo `docs` (la memoria se queda en
-documentos legibles). Cuando quieras activarlo, instálalo y corre `ozali doctor`: el modo sube a
-`hybrid` solo.
+documentos legibles). Cuando quieras activarlo, corre `ozali install-engram` — lo instala, configura
+el MCP en tu agente y sube el modo a `hybrid` de una vez.
 
 Dos detalles si lo usas en equipo:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ozali",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Bootstrap interactivo de IA por equipo: calibra el proyecto, genera la skill de ejecución (cdk) con TDD/SDD, y mantiene memoria de equipo (Engram) con histórico aislado.",
   "type": "module",
   "bin": {