ostacky 0.8.0 → 0.8.2

package/dist/cli.js

@@ -744,31 +744,31 @@ var init_fs = __esm(() => {
 var manifest_default;
 var init_manifest = __esm(() => {
   manifest_default = {
-    version: "0.8.0",
+    version: "0.8.2",
     repo: "JaimeHoracio/Ostacky",
-    tag: "v0.8.0",
+    tag: "v0.8.2",
     agents: [
       {
         name: "ostacky",
         file: "assets/agents/ostacky.md",
-        description: "Orquestador con recuperación automática (nunca se congela), ruteo por nivel de impacto, controller MCP con SDK oficial, edición segura con fallback inline, y delegación en OpenSpec + Superpowers. v0.8.0: prune de skills obsoletas, lastHandoff, getAvailableTransitions, consecutiveFailures real, mem_session_summary automático al cierre.",
-        version: "0.8.0",
-        sha256: "d9f94bb05a33a98d6ff0ea0b56c8eb6c3c8d456d1de1ccaac3f76ee2150b3c7b"
+        description: "Orquestador con recuperación automática (nunca se congela), ruteo por nivel de impacto, controller MCP con SDK oficial, edición segura con fallback inline, y delegación en OpenSpec + Superpowers. v0.8.2: prune de skills obsoletas, lastHandoff, getAvailableTransitions, consecutiveFailures real, mem_session_summary automático al cierre.",
+        version: "0.8.2",
+        sha256: "7b2be94d05cd371fab5be5844ef7d82e542e84c2869d8171ccd63dc14e922dc3"
       }
     ],
     commands: [
       {
         name: "install-stack",
         file: "assets/commands/install-stack.md",
-        description: "Instala el stack tecnológico del proyecto (CodeGraph, skills, OpenSpec, Engram, controller plugin). v0.8.0: controller plugin como alma hard-gate, Context7 removido del stack.",
-        version: "0.8.0",
-        sha256: "1a8acef8dd59d80aa54fa0febb4bd86a31ed615dea5257ea7fa8ed4fd51836a5"
+        description: "Instala el stack tecnológico del proyecto (CodeGraph, skills, OpenSpec, Engram, controller plugin). v0.8.2: controller plugin como alma hard-gate, Context7 removido del stack.",
+        version: "0.8.2",
+        sha256: "24802dc29675a584dacf4d0ac8a944dd935ee0f96a4e804a9b1c5bdb3709438c"
       },
       {
         name: "opsx-sync",
         file: "assets/commands/opsx-sync.md",
         description: "Sincroniza delta specs del change activo sin inicializar CodeGraph si ya existe índice",
-        version: "0.8.0",
+        version: "0.8.2",
         sha256: "fe0158478f2ca63b315037a85fc1632b77868532e319af6c7384285441767d64"
       }
     ],
@@ -776,15 +776,15 @@ var init_manifest = __esm(() => {
       {
         name: "ostacky-controller",
         file: "assets/mcp/ostacky-controller/",
-        description: "Máquina de estados persistida con @modelcontextprotocol/server SDK. v0.8.0: 22 tools (incluye set_handoff, get_handoff, clear_handoff, get_available_transitions funcional). Bugfixes: consecutiveFailures real, lastHandoff state, defaultChoice persistido. Robustez: degraded mode automático tras 3 fallos, persistence condicional para Nivel 0, prune de skills obsoletas.",
-        version: "0.8.0",
-        sha256: "5c4787001143ad517714e9c44f85b20fac00ba4146631d68486a90b93aa58dcd"
+        description: "Máquina de estados persistida con @modelcontextprotocol/server SDK. v0.8.2: 22 tools (incluye set_handoff, get_handoff, clear_handoff, get_available_transitions funcional). Bugfixes: consecutiveFailures real, lastHandoff state, defaultChoice persistido. Robustez: degraded mode automático tras 3 fallos, persistence condicional para Nivel 0, prune de skills obsoletas.",
+        version: "0.8.2",
+        sha256: "a9d45b027a88e8037a4e29704b84f78a1d03d41654ba7445a3091a0c6767d094"
       },
       {
         name: "openspec",
         file: "assets/mcp/openspec/",
         description: "MCP server local para OpenSpec - proposal, apply, archive, sync de cambios",
-        version: "0.8.0",
+        version: "0.8.2",
         sha256: "fa4be28bfc1e75db8f1a037e2580f04a60066c80e8e5934e90e1041020d04609"
       }
     ],
@@ -793,106 +793,106 @@ var init_manifest = __esm(() => {
         name: "brainstorming",
         file: "assets/skills/brainstorming/SKILL.md",
         description: "Skill unificado de pensamiento con dos modos: creative-design (producción de diseño → transición a implementación directa o openspec-propose) y open-exploration (exploración libre)",
-        version: "0.8.0",
-        sha256: "87f8d6ed28205f9272792d3865d8cd3232ab5e511a604d6d63d41e3a02a5f422"
+        version: "0.8.2",
+        sha256: "4c54604d4680bc695b7049c70cf8680296d8d2602e5790ddfc1cce7ba7c6f1fc"
       },
       {
         name: "execution-mode-evaluation",
         file: "assets/skills/execution-mode-evaluation/SKILL.md",
         description: "Skill de análisis de modo de ejecución — output reconciliado con controller snapshot contract (recommendation field)",
-        version: "0.8.0",
+        version: "0.8.2",
         sha256: "7b89dda29927c88f1eb13ffcea541a12423384c172f66c4f3d9b61efe0c7a163"
       },
       {
         name: "tdd",
         file: "assets/skills/tdd/SKILL.md",
         description: "Skill de test-driven development (Superpowers)",
-        version: "0.8.0",
+        version: "0.8.2",
         sha256: "aa412298980b7826165c211145c1b8e9135f68f36247bb3cb96d0a0eae274486"
       },
       {
         name: "subagent-driven-development",
         file: "assets/skills/subagent-driven-development/SKILL.md",
         description: "Skill de ejecución con subagentes (Superpowers) — ejecuta solo después de confirmación del coordinador Ostacky",
-        version: "0.8.0",
+        version: "0.8.2",
         sha256: "1a42d714a9a13faf05f0bf7b580e8d837c2e77a5633839542ccce603023419e8"
       },
       {
         name: "dispatching-parallel-agents",
         file: "assets/skills/dispatching-parallel-agents/SKILL.md",
         description: "Skill de dispatch paralelo de agentes (Superpowers)",
-        version: "0.8.0",
+        version: "0.8.2",
         sha256: "3c8a66d51ae2e719e877d02c3dac32bd804722c3bb9227c258ecae78252a20ab"
       },
       {
         name: "review",
         file: "assets/skills/review/SKILL.md",
         description: "Skill de revisión de código (Superpowers)",
-        version: "0.8.0",
+        version: "0.8.2",
         sha256: "b19650ed4d1d4d9857a4dd5b7e08e91328a1a1fc9c45bcc2fb600fa9d0213279"
       },
       {
         name: "receiving-code-review",
         file: "assets/skills/receiving-code-review/SKILL.md",
         description: "Skill de recibir y procesar feedback de code review",
-        version: "0.8.0",
+        version: "0.8.2",
         sha256: "d761e884e71d8d3476ac734d287cae403a4024506a7d12e7361a448217c0a831"
       },
       {
         name: "openspec-propose",
         file: "assets/skills/openspec-propose/SKILL.md",
         description: "Skill de generación de proposal (OpenSpec)",
-        version: "0.8.0",
+        version: "0.8.2",
         sha256: "bb59100b9fd3c9f9a1ec6509fa975ec55bf7fc737df4fe73bb3e9bbc217b83f7"
       },
       {
         name: "openspec-apply-change",
         file: "assets/skills/openspec-apply-change/SKILL.md",
         description: "Skill de aplicación de change (OpenSpec)",
-        version: "0.8.0",
+        version: "0.8.2",
         sha256: "dfc823bf89fc7505e91ab6dee9c1f004be38a410bd3d88fb67b211b1b6cbb1d0"
       },
       {
         name: "openspec-archive-change",
         file: "assets/skills/openspec-archive-change/SKILL.md",
         description: "Skill de archivo de change (OpenSpec)",
-        version: "0.8.0",
+        version: "0.8.2",
         sha256: "16e4b561de7747283663fed602e506abf502452c49a8d4b86d7a5539c40f0195"
       },
       {
         name: "openspec-explore",
         file: "assets/skills/openspec-explore/SKILL.md",
         description: "Modo explore para OpenSpec — thinking partner para explorar ideas, investigar problemas y clarificar requisitos antes/durante un cambio",
-        version: "0.8.0",
+        version: "0.8.2",
         sha256: "37ae4aaf17ea71a395bab6dc4d9d61b9a49d7910f6692535ae8553244c46880b"
       },
       {
         name: "using-git-worktrees",
         file: "assets/skills/using-git-worktrees/SKILL.md",
         description: "Skill de uso de git worktrees para aislamiento de trabajo",
-        version: "0.8.0",
+        version: "0.8.2",
         sha256: "93341bc1b7c053618a8b6dc07e3615b77990d7b549a0201f5835d95fef67ce13"
       },
       {
         name: "using-superpowers",
         file: "assets/skills/using-superpowers/SKILL.md",
         description: "Skill de orquestación de Superpowers skills",
-        version: "0.8.0",
+        version: "0.8.2",
         sha256: "7e54536f96d2a379185a10bfc1e970850caa2561b6d8aca7080f0defea0381a4"
       },
       {
         name: "writing-skills",
         file: "assets/skills/writing-skills/SKILL.md",
         description: "Skill de creación y edición de skills",
-        version: "0.8.0",
+        version: "0.8.2",
         sha256: "3d76b906cee518a2b809febb70db95697a35b9f368986bb504b4120c3bfb437a"
       },
       {
         name: "graceful-degradation",
         file: "assets/skills/graceful-degradation/SKILL.md",
         description: "Skill de degradación graceful cuando múltiples tools están indisponibles",
-        version: "0.8.0",
-        sha256: "40f929e8032b70d51b3548bddcc383b931d6044fd9d4acce8a5b9f7acd014f59"
+        version: "0.8.2",
+        sha256: "79d0eeb2116382cb5db5b753277a333b7ca5682f4a541170b4a6158125c2cb50"
       }
     ]
   };
@@ -1260,12 +1260,6 @@ function patchOpenCodeConfig(projectRoot = findProjectRoot()) {
     delete config.plugin;
     changed = true;
   }
-  if (config.mcp && typeof config.mcp === "object" && "context7" in config.mcp) {
-    delete config.mcp.context7;
-    if (Object.keys(config.mcp).length === 0)
-      delete config.mcp;
-    changed = true;
-  }
   if (changed) {
     writeOpenCodeConfig(configPath, config);
     return { success: true, message: "Config actualizada (plugin legacy eliminado)" };
@@ -1303,11 +1297,21 @@ function resolveToolInstallLocation(toolsDir) {
 }
 function runTool(binary, args, cwd, timeout = 30000) {
   const invocation = getCommandInvocation(binary, args);
-  execFileSync3(invocation.command, invocation.args, {
-    cwd,
-    stdio: "pipe",
-    timeout
-  });
+  try {
+    execFileSync3(invocation.command, invocation.args, {
+      cwd,
+      stdio: "pipe",
+      timeout
+    });
+  } catch (error) {
+    const err = error;
+    const stdout = err.stdout ? Buffer.from(err.stdout).toString().trim() : "";
+    const stderr = err.stderr ? Buffer.from(err.stderr).toString().trim() : "";
+    const detail = [stderr, stdout].filter(Boolean).join(`
+`) || err.message;
+    const invocationStr = `${invocation.command} ${invocation.args.join(" ")}`;
+    throw new Error(`${detail} (invocación: ${invocationStr}, cwd: ${cwd ?? process.cwd()})`);
+  }
 }
 function findToolBinary(toolDir, name) {
   const binDir = join7(toolDir, "bin");
@@ -1396,18 +1400,36 @@ async function installCodeGraph(toolsDir) {
     const ext = process.platform === "win32" ? "zip" : "tar.gz";
     const url = `https://github.com/colbymchenry/codegraph/releases/download/${tag}/codegraph-${target}.${ext}`;
     try {
-      archivePromotion = await downloadAndExtractWithRetry(url, cgToolDir, 1, 180000, 2);
+      archivePromotion = await downloadAndExtractWithRetry(url, cgToolDir, 0, 180000, 2);
     } catch (e2) {
       return {
         success: false,
         message: `Error descargando CodeGraph ${tag}: ${e2.message}`
       };
     }
-    localBin = findToolBinary(cgToolDir, "codegraph");
-    if (!localBin) {
+    const expectedBin = join7(cgToolDir, "bin", getExecutableName("codegraph"));
+    let found = findToolBinary(cgToolDir, "codegraph");
+    if (!found)
+      found = findBinaryInDir(cgToolDir, "codegraph");
+    if (!found) {
       return failAfterExtraction(`Descarga de CodeGraph ${tag} completada pero no se encontró el binario en ${join7(cgToolDir, "bin")}.`);
     }
-    if (process.platform !== "win32") {
+    try {
+      if (found !== expectedBin) {
+        mkdirSync4(join7(cgToolDir, "bin"), { recursive: true });
+        if (found.toLowerCase().endsWith(".cmd") && expectedBin.toLowerCase().endsWith(".exe")) {
+          localBin = found;
+        } else {
+          copyFileSync3(found, expectedBin);
+          localBin = expectedBin;
+        }
+      } else {
+        localBin = found;
+      }
+    } catch (error) {
+      return failAfterExtraction(`CodeGraph fue descargado pero no se pudo materializar el binario local: ${error.message}`);
+    }
+    if (process.platform !== "win32" && localBin) {
       try {
         chmodSync(localBin, 493);
       } catch {}
@@ -1422,7 +1444,8 @@ async function installCodeGraph(toolsDir) {
   try {
     runTool(localBin, ["init", "-i"], projectRoot, 120000);
   } catch (error) {
-    indexWarning = `El índice no se pudo inicializar todavía: ${error.message}`;
+    const msg = error.message;
+    indexWarning = `El índice no se pudo inicializar todavía: ${msg}. Sugerencia: ejecutá manualmente \`${localBin} init -i\` en ${projectRoot} o \`npx ostacky install-stack --scope local\` para reintentar. Si el path del binario (${localBin}) apunta a ${cgToolDir} y esperabas otro proyecto, verificá que corriste el comando dentro del proyecto correcto (con .git) y con --scope local.`;
   }
   try {
     configureLocalTool(projectRoot, "codegraph", buildLocalMcpCommand(localBin, ["serve", "--mcp"]));
@@ -1621,7 +1644,7 @@ function uninstallStackConfig(paths) {
       const mcp = config.mcp;
       let changed = false;
       if (mcp) {
-        for (const name of ["codegraph", "engram", "context7"]) {
+        for (const name of ["codegraph", "engram"]) {
           if (name in mcp) {
             delete mcp[name];
             removed.push(`mcp.${name}`);
@@ -1691,7 +1714,7 @@ var init_stack = __esm(() => {
 // package.json
 var package_default = {
   name: "ostacky",
-  version: "0.8.0",
+  version: "0.8.2",
   description: "Instalador interactivo de agentes y comandos para OpenCode",
   type: "module",
   bin: {
@@ -2866,7 +2889,7 @@ async function probeMcpServer(nodeExecutable, serverPath, cwd, statePath, option
         params: {
           protocolVersion: "2025-03-26",
           capabilities: {},
-          clientInfo: { name: "ostacky-installer", version: "0.8.0" }
+          clientInfo: { name: "ostacky-installer", version: "0.8.2" }
         }
       });
     });
@@ -3175,12 +3198,13 @@ function uninstallAll(paths) {
   for (const name of Object.keys(lockfile.mcpServers ?? {})) {
     uninstallMcpServer(name, paths);
   }
-  if (existsSync5(paths.mcp)) {
-    for (const entry of readdirSync2(paths.mcp)) {
-      const dirPath = join6(paths.mcp, entry);
-      if (statSync2(dirPath).isDirectory()) {
-        uninstallMcpServer(entry, paths);
-      }
+  const ostackyPlugins = ["ostacky-plugin.ts", "engram.ts", "ostacky-guard.ts", "ostacky-controller.ts"];
+  for (const file of ostackyPlugins) {
+    const fp = join6(paths.plugins, file);
+    if (existsSync5(fp)) {
+      try {
+        unlinkSync2(fp);
+      } catch {}
     }
   }
   clearLockfile(paths.root);
@@ -3365,6 +3389,16 @@ async function doInstallStack(toolsDir, projectRoot) {
   const spin = L2();
   let allOk = true;
   const resolvedProjectRoot = projectRoot ?? dirname6(dirname6(toolsDir ?? join8(process.cwd(), ".opencode", "tools")));
+  const resolvedToolsDir = toolsDir ?? join8(resolvedProjectRoot, ".opencode", "tools");
+  v2.info(`Stack → projectRoot: ${resolvedProjectRoot} | toolsDir: ${resolvedToolsDir}`);
+  try {
+    const { homedir: homedir2 } = await import("os");
+    const home = homedir2();
+    const inHome = resolvedProjectRoot.replace(/\\/g, "/") === home.replace(/\\/g, "/");
+    if (inHome && !existsSync7(join8(home, ".git"))) {
+      v2.warn(`Estás instalando el stack en tu home (${home}). Si esperabas instalar en un proyecto, hacé cd al proyecto y usá --scope local.`);
+    }
+  } catch {}
   spin.start("Instalando CodeGraph...");
   const cg = await installCodeGraph(toolsDir);
   spin.stop(cg.success ? `✓ ${cg.message}` : `✗ ${cg.message}`);
@@ -3395,6 +3429,7 @@ async function doInstallAll(manifest, paths) {
   const spin = L2();
   let errors = 0;
   const isGlobal = isGlobalScope(paths);
+  v2.info(`Scope → ${isGlobal ? "global" : "local"} | opencodeDir: ${paths.root} | tools: ${paths.tools}`);
   if (!isGlobal) {
     ensureToolDirs(paths.tools, ["codegraph", "engram"]);
   } else {
@@ -3446,7 +3481,7 @@ async function doInstallAll(manifest, paths) {
     }
   }
   try {
-    const { copyFileSync: copyFileSync4, mkdirSync: mkdirSync5, existsSync: existsSync8 } = await import("fs");
+    const { copyFileSync: copyFileSync4, mkdirSync: mkdirSync5, existsSync: existsSync8, rmSync: rmSync5 } = await import("fs");
     const { join: join9 } = await import("path");
     const { PACKAGE_ROOT: PACKAGE_ROOT2 } = await Promise.resolve().then(() => (init_github(), exports_github));
     const { findProjectRoot: findProjectRoot3 } = await Promise.resolve().then(() => (init_fs(), exports_fs));
@@ -3456,10 +3491,12 @@ async function doInstallAll(manifest, paths) {
       mkdirSync5(paths.plugins, { recursive: true });
       copyFileSync4(src, dest);
     }
-    const legacySrc = join9(PACKAGE_ROOT2, "assets", "plugins", "ostacky-controller.ts");
-    if (!existsSync8(src) && existsSync8(legacySrc)) {
-      mkdirSync5(paths.plugins, { recursive: true });
-      copyFileSync4(legacySrc, join9(paths.plugins, "ostacky-controller.ts"));
+    for (const legacy of ["ostacky-guard.ts", "ostacky-controller.ts"]) {
+      const lp = join9(paths.plugins, legacy);
+      if (existsSync8(lp))
+        try {
+          rmSync5(lp, { force: true });
+        } catch {}
     }
     const srcEng = join9(PACKAGE_ROOT2, "assets", "plugins", "engram.ts");
     const destEng = join9(paths.plugins, "engram.ts");
@@ -3474,10 +3511,15 @@ async function doInstallAll(manifest, paths) {
         mkdirSync5(localPlugins, { recursive: true });
         if (existsSync8(src))
           copyFileSync4(src, join9(localPlugins, "ostacky-plugin.ts"));
-        else if (existsSync8(legacySrc))
-          copyFileSync4(legacySrc, join9(localPlugins, "ostacky-controller.ts"));
         if (existsSync8(srcEng))
           copyFileSync4(srcEng, join9(localPlugins, "engram.ts"));
+        for (const legacy of ["ostacky-guard.ts", "ostacky-controller.ts"]) {
+          const lp = join9(localPlugins, legacy);
+          if (existsSync8(lp))
+            try {
+              rmSync5(lp, { force: true });
+            } catch {}
+        }
       } catch {}
     }
   } catch {}
@@ -3718,10 +3760,10 @@ async function doUninstallTotal(paths) {
   for (const name of Object.keys(lockfile.mcpServers ?? {})) {
     pathsToDelete.push(join9(paths.mcp, name));
   }
-  ye(pathsToDelete.join(`
-`), `Se eliminarán ${pathsToDelete.length} archivo(s) / directorio(s)`);
+  ye([`Scope: ${paths.root}`, ...pathsToDelete].join(`
+`), `Se eliminarán ${pathsToDelete.length} item(s) trackeados en lockfile (safe-delete)`);
   const confirm = await me({
-    message: `¿Confirmar desinstalación de ${pathsToDelete.length} item(s)?`
+    message: `¿Confirmar desinstalación de ${pathsToDelete.length} item(s) en ${paths.root}?`
   });
   onCancel(confirm);
   if (!confirm) {
@@ -3729,7 +3771,7 @@ async function doUninstallTotal(paths) {
     return;
   }
   uninstallAll(paths);
-  v2.success(`${pathsToDelete.length} item(s) eliminado(s).`);
+  v2.success(`${pathsToDelete.length} item(s) eliminado(s) + plugins Ostacky-owned limpiados.`);
   const cleanEngram = await me({
     message: "¿Deseas remover la configuración de Engram del proyecto (mcp.engram)?"
   });
@@ -4010,9 +4052,122 @@ async function doUninstallMcpByName(name, paths) {
   }
 }
 
+// src/opencode.ts
+init_fs();
+import { execSync, execFileSync as execFileSync4 } from "node:child_process";
+function isOpencodeInstalled() {
+  if (isCommandAvailable("opencode"))
+    return true;
+  try {
+    execFileSync4("opencode", ["--version"], { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function getOpencodeInstallCommand(platform = process.platform, _arch = process.arch) {
+  if (platform === "win32") {
+    return {
+      display: "npm install -g opencode-ai",
+      command: "npm",
+      args: ["install", "-g", "opencode-ai"],
+      note: "Alternativas Windows: choco install opencode | scoop install opencode | mise use -g github:anomalyco/opencode (ver https://opencode.ai/download). WSL recomendado."
+    };
+  }
+  if (platform === "darwin") {
+    return {
+      display: "curl -fsSL https://opencode.ai/install | bash",
+      command: "bash",
+      args: ["-c", "curl -fsSL https://opencode.ai/install | bash"],
+      note: "Alternativa macOS: brew install anomalyco/tap/opencode (tap oficial, más actualizado que brew install opencode)"
+    };
+  }
+  return {
+    display: "curl -fsSL https://opencode.ai/install | bash",
+    command: "bash",
+    args: ["-c", "curl -fsSL https://opencode.ai/install | bash"],
+    note: "Alternativas Linux: npm install -g opencode-ai | bun add -g opencode-ai | brew install anomalyco/tap/opencode | paru -S opencode (Arch)"
+  };
+}
+async function ensureOpencodeInstalled() {
+  if (isOpencodeInstalled())
+    return;
+  const platform = process.platform;
+  const info = getOpencodeInstallCommand(platform);
+  v2.warn("OpenCode no detectado en este sistema.");
+  ye(`${info.display}
+Docs: https://opencode.ai/download${info.note ? `
+${info.note}` : ""}`, `Instalación requerida (${platform})`);
+  const shouldInstall = await me({
+    message: "Ostacky no funciona sin OpenCode. ¿Querés instalar OpenCode ahora?",
+    initialValue: true
+  });
+  if (BD(shouldInstall) || !shouldInstall) {
+    fe("Instalación cancelada. Instalá OpenCode manualmente y volvé a ejecutar: https://opencode.ai/download");
+    process.exit(1);
+  }
+  const spin = L2();
+  spin.start(`Instalando OpenCode (${info.display})...`);
+  try {
+    if (platform === "win32") {
+      execSync("npm install -g opencode-ai", { stdio: "inherit", shell: "cmd.exe" });
+    } else {
+      if (!isCommandAvailable("curl")) {
+        spin.stop("curl no disponible");
+        v2.warn("curl no está instalado — se intentará con npm como fallback.");
+        execSync("npm install -g opencode-ai", { stdio: "inherit", shell: "/bin/bash" });
+      } else {
+        execSync("curl -fsSL https://opencode.ai/install | bash", { stdio: "inherit", shell: "/bin/bash" });
+      }
+    }
+    spin.stop("Instalación ejecutada, verificando...");
+  } catch (e2) {
+    spin.stop("Fallo la instalación automática.");
+    const msg = e2.message ?? String(e2);
+    v2.error(`No se pudo instalar OpenCode automáticamente: ${msg}`);
+    if (platform === "win32") {
+      ye([
+        "Intentá manualmente una de estas opciones:",
+        "  npm install -g opencode-ai",
+        "  choco install opencode",
+        "  scoop install opencode",
+        "  (WSL) curl -fsSL https://opencode.ai/install | bash",
+        "Luego verificá: opencode --version",
+        "Docs: https://opencode.ai/download"
+      ].join(`
+`), "Acción manual requerida");
+    } else {
+      ye([
+        "Intentá manualmente:",
+        `  ${info.display}`,
+        "  npm install -g opencode-ai  (si no tenés curl)",
+        "  brew install anomalyco/tap/opencode  (macOS/Linux con brew)",
+        "Luego verificá: opencode --version",
+        "Docs: https://opencode.ai/download"
+      ].join(`
+`), "Acción manual requerida");
+    }
+    process.exit(1);
+  }
+  if (!isOpencodeInstalled()) {
+    v2.error("OpenCode aún no está disponible en el PATH después de la instalación.");
+    ye([
+      "Probá cerrar y reabrir la terminal y ejecutar:",
+      "  opencode --version",
+      "Si persiste, instalá manualmente:",
+      `  ${info.display}`,
+      "Docs: https://opencode.ai/download"
+    ].join(`
+`), "Verificación falló");
+    process.exit(1);
+  }
+  v2.success("OpenCode instalado correctamente ✓");
+}
+
 // src/prompts/index.ts
 async function runInteractiveMenu(scope) {
   we(" OpenCode Installer ");
+  await ensureOpencodeInstalled();
   const manifest = await loadManifest();
   const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
@@ -4092,6 +4247,7 @@ async function runInteractiveMenu(scope) {
 }
 async function runInstallCommand(scope) {
   we(" OpenCode Installer ");
+  await ensureOpencodeInstalled();
   const manifest = await loadManifest();
   const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
@@ -4105,6 +4261,7 @@ async function runInstallCommand(scope) {
 }
 async function runAddAgentCommand(scope) {
   we(" OpenCode Installer ");
+  await ensureOpencodeInstalled();
   const manifest = await loadManifest();
   const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
@@ -4117,6 +4274,7 @@ async function runAddAgentCommand(scope) {
 }
 async function runAddCommandCommand(scope) {
   we(" OpenCode Installer ");
+  await ensureOpencodeInstalled();
   const manifest = await loadManifest();
   const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
@@ -4129,6 +4287,7 @@ async function runAddCommandCommand(scope) {
 }
 async function runAddSkillCommand(scope) {
   we(" OpenCode Installer ");
+  await ensureOpencodeInstalled();
   const manifest = await loadManifest();
   const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
@@ -4141,6 +4300,7 @@ async function runAddSkillCommand(scope) {
 }
 async function runAddMcpCommand(scope) {
   we(" OpenCode Installer ");
+  await ensureOpencodeInstalled();
   const manifest = await loadManifest();
   const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
@@ -4152,6 +4312,7 @@ async function runAddMcpCommand(scope) {
   fe("Listo.");
 }
 async function runInstallStackCommand(scope) {
+  await ensureOpencodeInstalled();
   if (scope === "global") {
     v2.error("install-stack requiere scope local; el stack vive en <proyecto>/.opencode/tools");
     fe("Usá: npx ostacky install-stack --scope local");
@@ -4203,6 +4364,7 @@ async function runUninstallStackCommand(scope) {
 }
 async function runUpdateCommand(scope) {
   we(" OpenCode Installer ");
+  await ensureOpencodeInstalled();
   const manifest = await loadLatestManifest();
   const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
@@ -4366,7 +4528,7 @@ async function runUninstallMcpCommand(name, scope) {
 // src/cli.ts
 init_fs();
 import { existsSync as existsSync8, statSync as statSync3, readFileSync as readFileSync6, readdirSync as readdirSync3 } from "node:fs";
-import { join as join11, dirname as dirname8 } from "node:path";
+import { join as join10, dirname as dirname8 } from "node:path";
 var HELP = `
 ostacky — Instalador de agentes, comandos, skills y MCPs para OpenCode
 
@@ -4431,8 +4593,8 @@ var argvNoScope = withoutScopeArgs(process.argv);
 var [, , cmd, subcmd] = argvNoScope;
 async function runDoctorCommand() {
   const cwd = process.cwd();
-  const opencodeDir = findOpenCodeDir(cwd) || join11(cwd, ".opencode");
-  const statePath = join11(opencodeDir, "ostacky-state.json");
+  const opencodeDir = findOpenCodeDir(cwd) || join10(cwd, ".opencode");
+  const statePath = join10(opencodeDir, "ostacky-state.json");
   let hasError = false;
   let hasWarn = false;
   const check = (label, ok, warn = false) => {
@@ -4447,12 +4609,12 @@ async function runDoctorCommand() {
     }
   };
   const pluginPaths = [
-    join11(cwd, "assets", "plugins", "ostacky-plugin.ts"),
-    join11(opencodeDir, "plugins", "ostacky-plugin.ts"),
-    join11(cwd, ".opencode", "plugins", "ostacky-plugin.ts"),
-    join11(cwd, "assets", "plugins", "ostacky-controller.ts"),
-    join11(opencodeDir, "plugins", "ostacky-controller.ts"),
-    join11(cwd, ".opencode", "plugins", "ostacky-controller.ts")
+    join10(cwd, "assets", "plugins", "ostacky-plugin.ts"),
+    join10(opencodeDir, "plugins", "ostacky-plugin.ts"),
+    join10(cwd, ".opencode", "plugins", "ostacky-plugin.ts"),
+    join10(cwd, "assets", "plugins", "ostacky-controller.ts"),
+    join10(opencodeDir, "plugins", "ostacky-controller.ts"),
+    join10(cwd, ".opencode", "plugins", "ostacky-controller.ts")
   ];
   const pluginActive = pluginPaths.some((p2) => existsSync8(p2));
   try {
@@ -4525,8 +4687,8 @@ async function runDoctorCommand() {
     check(`controller: ${e2.message}`, false);
   }
   try {
-    const lockPid = join11(opencodeDir, "ostacky-state.json.lock.pid");
-    const lockTs = join11(opencodeDir, "ostacky-state.json.lock.timestamp");
+    const lockPid = join10(opencodeDir, "ostacky-state.json.lock.pid");
+    const lockTs = join10(opencodeDir, "ostacky-state.json.lock.timestamp");
     if (existsSync8(lockPid) || existsSync8(lockTs)) {
       let ageStr = "";
       try {
@@ -4551,15 +4713,15 @@ async function runDoctorCommand() {
   }
   const tools = ["codegraph", "engram"];
   for (const t of tools) {
-    const p2 = join11(opencodeDir, "tools", t, "bin", t);
+    const p2 = join10(opencodeDir, "tools", t, "bin", t);
     const pExe = p2 + ".exe";
     check(`tool ${t}: ${existsSync8(p2) || existsSync8(pExe) ? "found" : "missing"}`, existsSync8(p2) || existsSync8(pExe), true);
   }
   try {
-    const manifest = JSON.parse(readFileSync6(join11(cwd, "manifest.json"), "utf-8"));
+    const manifest = JSON.parse(readFileSync6(join10(cwd, "manifest.json"), "utf-8"));
     const expected = manifest.mcpServers?.find((x2) => x2.name === "ostacky-controller")?.sha256;
     if (expected) {
-      const actual = computeTreeHash(join11(cwd, "assets", "mcp", "ostacky-controller"));
+      const actual = computeTreeHash(join10(cwd, "assets", "mcp", "ostacky-controller"));
       check(`manifest hash: ${expected.slice(0, 8)} vs actual ${actual.slice(0, 8)}`, expected === actual);
       if (expected !== actual)
         console.log("  Run: bun run hash:update");
@@ -4574,7 +4736,7 @@ async function runDoctorCommand() {
     } catch {}
   }
   try {
-    const cacheDir = join11(opencodeDir, "cache", "codegraph");
+    const cacheDir = join10(opencodeDir, "cache", "codegraph");
     if (!existsSync8(cacheDir)) {
       console.log("ℹ️ cache: no cache dir yet (ok)");
     } else {
@@ -4582,7 +4744,7 @@ async function runDoctorCommand() {
       let total = 0;
       for (const f2 of files) {
         try {
-          total += statSync3(join11(cacheDir, f2)).size;
+          total += statSync3(join10(cacheDir, f2)).size;
         } catch {}
       }
       const totalMB = (total / 1048576).toFixed(2);
@@ -4603,7 +4765,7 @@ async function runDoctorCommand() {
     console.log(`⚠️ cache: check failed ${e2.message}`);
   }
   try {
-    const secPath = join11(cwd, "src", "security.ts");
+    const secPath = join10(cwd, "src", "security.ts");
     if (!existsSync8(secPath)) {
       console.log("⚠️ src/security.ts: missing (source-of-truth)");
       hasWarn = true;
@@ -4635,8 +4797,8 @@ async function runDoctorCommand() {
 async function runStatusCommand(args) {
   const isJson = args.includes("--json");
   const cwd = process.cwd();
-  const opencodeDir = findOpenCodeDir(cwd) || join11(cwd, ".opencode");
-  const statePath = join11(opencodeDir, "ostacky-state.json");
+  const opencodeDir = findOpenCodeDir(cwd) || join10(cwd, ".opencode");
+  const statePath = join10(opencodeDir, "ostacky-state.json");
   if (!existsSync8(statePath)) {
     console.log(isJson ? JSON.stringify({ error: "no state" }) : "No state file");
     return;
@@ -4659,6 +4821,10 @@ async function runStatusCommand(args) {
   }
 }
 async function main() {
+  const needsOpencode = !cmd || cmd === "install" || cmd === "install-stack" || cmd === "update" || cmd === "add" && ["agent", "command", "skill", "mcp"].includes(subcmd ?? "");
+  if (needsOpencode) {
+    await ensureOpencodeInstalled();
+  }
   switch (cmd) {
     case "install":
       await runInstallCommand(scope);