ostacky 0.7.1 → 0.7.3

package/dist/cli.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { createRequire } from "node:module";
 var __create = Object.create;
 var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
@@ -44,6 +45,7 @@ var __export = (target, all) => {
     });
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // node_modules/sisteransi/src/index.js
 var require_src = __commonJS((exports, module) => {
@@ -215,8 +217,9 @@ import {
   renameSync
 } from "fs";
 import { createHash as createHash2 } from "crypto";
-import { join, resolve, dirname, relative, basename } from "path";
+import { join, resolve, dirname, relative, basename, win32 } from "path";
 import { execFileSync } from "child_process";
+import { homedir } from "os";
 function findOpenCodeDir(startDir = process.cwd()) {
   let current = resolve(startDir);
   while (true) {
@@ -232,6 +235,11 @@ function findOpenCodeDir(startDir = process.cwd()) {
   }
 }
 function findProjectRoot(startDir = process.cwd()) {
+  try {
+    const out = execFileSync("git", ["rev-parse", "--show-toplevel"], { encoding: "utf-8", cwd: startDir, stdio: ["pipe", "pipe", "pipe"] }).trim();
+    if (out && existsSync(out))
+      return resolve(out);
+  } catch {}
   let current = resolve(startDir);
   while (true) {
     if (existsSync(join(current, ".opencode")) || existsSync(join(current, ".git"))) {
@@ -243,6 +251,32 @@ function findProjectRoot(startDir = process.cwd()) {
     current = parent;
   }
 }
+function getGlobalOpenCodeDir(platform = process.platform, home = homedir()) {
+  if (platform === "win32") {
+    const appData = process.env.APPDATA ?? win32.join(home, "AppData", "Roaming");
+    return win32.join(appData, "opencode");
+  }
+  const xdg = process.env.XDG_CONFIG_HOME ?? join(home, ".config");
+  return join(xdg, "opencode");
+}
+function getOpenCodeDirForScope(scope, cwd = process.cwd()) {
+  if (scope === "global")
+    return getGlobalOpenCodeDir();
+  if (scope === "local") {
+    const existing2 = findOpenCodeDir(cwd);
+    if (existing2)
+      return existing2;
+    return join(findProjectRoot(cwd), ".opencode");
+  }
+  const existing = findOpenCodeDir(cwd);
+  if (existing)
+    return existing;
+  const root = findProjectRoot(cwd);
+  if (existsSync(join(root, ".opencode")) || existsSync(join(root, ".git"))) {
+    return join(root, ".opencode");
+  }
+  return getGlobalOpenCodeDir();
+}
 function ensureOpenCodePaths(opencodeDir) {
   const paths = {
     root: opencodeDir,
@@ -266,9 +300,6 @@ function ensureToolDirs(toolsDir, toolNames) {
       mkdirSync(dir, { recursive: true });
   }
 }
-function createOpenCodeDir(baseDir) {
-  return ensureOpenCodePaths(join(baseDir, ".opencode"));
-}
 function copyDirRecursive(src, dest, skipGenerated = false) {
   if (!existsSync(dest))
     mkdirSync(dest, { recursive: true });
@@ -451,7 +482,7 @@ function downloadToFile(url, dest, timeoutMs = 180000) {
   });
 }
 async function downloadAndExtract(url, destDir, stripComponents = 1, timeoutMs = 180000) {
-  const tmp = join(dirname(destDir), `.${basename(destDir)}.download-${Date.now()}`);
+  const tmp = join(dirname(destDir), `.${basename(destDir)}.download-${Date.now()}-${process.pid}`);
   if (!existsSync(tmp))
     mkdirSync(tmp, { recursive: true });
   const archivePath = join(tmp, url.endsWith(".zip") ? "archive.zip" : "archive.tar.gz");
@@ -520,31 +551,31 @@ var init_fs = __esm(() => {
 var manifest_default;
 var init_manifest = __esm(() => {
   manifest_default = {
-    version: "0.7.1",
+    version: "0.7.3",
     repo: "JaimeHoracio/Ostacky",
-    tag: "v0.7.1",
+    tag: "v0.7.3",
     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.7.1: prune de skills obsoletas, lastHandoff, getAvailableTransitions, consecutiveFailures real, mem_session_summary automático al cierre.",
-        version: "0.7.1",
-        sha256: "f833e69b6eaa3dfe24de9addf6455b3da55f829b51cba3c7c90c65c69cda34c2"
+        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.7.3: prune de skills obsoletas, lastHandoff, getAvailableTransitions, consecutiveFailures real, mem_session_summary automático al cierre.",
+        version: "0.7.3",
+        sha256: "b6dc55a9571f9626e7912ac493cc3bfe6b0798a597f706904b2106a4a9acfcd5"
       }
     ],
     commands: [
       {
         name: "install-stack",
         file: "assets/commands/install-stack.md",
-        description: "Instala el stack tecnológico del proyecto (CodeGraph, skills, OpenSpec, Engram, Context7, controller MCP con SDK oficial). v0.7.1: Paso 1.5 controller expandido con verificación post-instalación y troubleshooting.",
-        version: "0.7.1",
-        sha256: "ef4244855cf733dfe50a2a8e7c436c5741f92574cc50f0fca49faed60480e013"
+        description: "Instala el stack tecnológico del proyecto (CodeGraph, skills, OpenSpec, Engram, Context7, controller MCP con SDK oficial). v0.7.3: Paso 1.5 controller expandido con verificación post-instalación y troubleshooting.",
+        version: "0.7.3",
+        sha256: "0d4bc0938110c40633b041847148d8212e34a5b5876752825cfd6e186c328b8b"
       },
       {
         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.7.1",
+        version: "0.7.3",
         sha256: "fe0158478f2ca63b315037a85fc1632b77868532e319af6c7384285441767d64"
       }
     ],
@@ -552,15 +583,15 @@ var init_manifest = __esm(() => {
       {
         name: "ostacky-controller",
         file: "assets/mcp/ostacky-controller/",
-        description: "Máquina de estados persistida con @modelcontextprotocol/server SDK. v0.7.1: 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.7.1",
-        sha256: "0e639fb1d5bedf8b93b4e259782b9b7de68cd4bb89875e2c546279d17131b7b7"
+        description: "Máquina de estados persistida con @modelcontextprotocol/server SDK. v0.7.3: 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.7.3",
+        sha256: "d723afc107c8a36721e7f04dc1c16694a617cd562492e1ece362482c9023b945"
       },
       {
         name: "openspec",
         file: "assets/mcp/openspec/",
         description: "MCP server local para OpenSpec - proposal, apply, archive, sync de cambios",
-        version: "0.7.1",
+        version: "0.7.3",
         sha256: "fa4be28bfc1e75db8f1a037e2580f04a60066c80e8e5934e90e1041020d04609"
       }
     ],
@@ -569,106 +600,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.7.1",
+        version: "0.7.3",
         sha256: "333810ca63450e8ab795e8c5a58e645101e788d79210ca8ac36e10d11be39585"
       },
       {
         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.7.1",
-        sha256: "edf6fca0af52cce83f8fd08e7db9b3d79cc130b53fca505e90d3fbaf4909338b"
+        version: "0.7.3",
+        sha256: "e17f1e0309572841dc1fa537b1f32c7468eb70b3acf453b9ff5cc4fa8d94fd39"
       },
       {
         name: "tdd",
         file: "assets/skills/tdd/SKILL.md",
         description: "Skill de test-driven development (Superpowers)",
-        version: "0.7.1",
+        version: "0.7.3",
         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.7.1",
+        version: "0.7.3",
         sha256: "1a42d714a9a13faf05f0bf7b580e8d837c2e77a5633839542ccce603023419e8"
       },
       {
         name: "dispatching-parallel-agents",
         file: "assets/skills/dispatching-parallel-agents/SKILL.md",
         description: "Skill de dispatch paralelo de agentes (Superpowers)",
-        version: "0.7.1",
+        version: "0.7.3",
         sha256: "3c8a66d51ae2e719e877d02c3dac32bd804722c3bb9227c258ecae78252a20ab"
       },
       {
         name: "review",
         file: "assets/skills/review/SKILL.md",
         description: "Skill de revisión de código (Superpowers)",
-        version: "0.7.1",
+        version: "0.7.3",
         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.7.1",
+        version: "0.7.3",
         sha256: "d761e884e71d8d3476ac734d287cae403a4024506a7d12e7361a448217c0a831"
       },
       {
         name: "openspec-propose",
         file: "assets/skills/openspec-propose/SKILL.md",
         description: "Skill de generación de proposal (OpenSpec)",
-        version: "0.7.1",
+        version: "0.7.3",
         sha256: "bb59100b9fd3c9f9a1ec6509fa975ec55bf7fc737df4fe73bb3e9bbc217b83f7"
       },
       {
         name: "openspec-apply-change",
         file: "assets/skills/openspec-apply-change/SKILL.md",
         description: "Skill de aplicación de change (OpenSpec)",
-        version: "0.7.1",
+        version: "0.7.3",
         sha256: "dfc823bf89fc7505e91ab6dee9c1f004be38a410bd3d88fb67b211b1b6cbb1d0"
       },
       {
         name: "openspec-archive-change",
         file: "assets/skills/openspec-archive-change/SKILL.md",
         description: "Skill de archivo de change (OpenSpec)",
-        version: "0.7.1",
+        version: "0.7.3",
         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.7.1",
+        version: "0.7.3",
         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.7.1",
-        sha256: "11afa9123828fc5caa22137aff907cd99c751e99027fbd4c020751110a949281"
+        version: "0.7.3",
+        sha256: "93341bc1b7c053618a8b6dc07e3615b77990d7b549a0201f5835d95fef67ce13"
       },
       {
         name: "using-superpowers",
         file: "assets/skills/using-superpowers/SKILL.md",
         description: "Skill de orquestación de Superpowers skills",
-        version: "0.7.1",
+        version: "0.7.3",
         sha256: "7e54536f96d2a379185a10bfc1e970850caa2561b6d8aca7080f0defea0381a4"
       },
       {
         name: "writing-skills",
         file: "assets/skills/writing-skills/SKILL.md",
         description: "Skill de creación y edición de skills",
-        version: "0.7.1",
+        version: "0.7.3",
         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.7.1",
-        sha256: "e5090e475729f21871bb25bce738000f3616955ed3edb3ba926dd740d3298948"
+        version: "0.7.3",
+        sha256: "630b87c16d78212c865696ca5df6abb0834606095ffe0e80cff8e04350f01054"
       }
     ]
   };
@@ -1468,7 +1499,7 @@ var init_stack = __esm(() => {
 // package.json
 var package_default = {
   name: "ostacky",
-  version: "0.7.1",
+  version: "0.7.3",
   description: "Instalador interactivo de agentes y comandos para OpenCode",
   type: "module",
   bin: {
@@ -2546,6 +2577,7 @@ async function probeMcpServer(nodeExecutable, serverPath, cwd, statePath, option
       let stderr = "";
       let stdoutBuffer = "";
       const requestTimeout = 1e4;
+      let exitTimeout;
       const finish = (error) => {
         if (settled)
           return;
@@ -2554,9 +2586,18 @@ async function probeMcpServer(nodeExecutable, serverPath, cwd, statePath, option
         try {
           child.stdin?.end();
         } catch {}
-        if (child.exitCode === null)
+        if (child.exitCode === null) {
+          const onExit = () => {
+            if (exitTimeout)
+              clearTimeout(exitTimeout);
+            error ? reject(error) : resolve2();
+          };
+          child.once("exit", onExit);
           child.kill();
-        error ? reject(error) : resolve2();
+          exitTimeout = setTimeout(onExit, 500);
+        } else {
+          error ? reject(error) : resolve2();
+        }
       };
       const fail = (message) => finish(new Error(`${message}${stderr ? `: ${stderr.trim()}` : ""}`));
       const send = (message) => {
@@ -2633,15 +2674,35 @@ async function probeMcpServer(nodeExecutable, serverPath, cwd, statePath, option
         params: {
           protocolVersion: "2025-03-26",
           capabilities: {},
-          clientInfo: { name: "ostacky-installer", version: "0.7.1" }
+          clientInfo: { name: "ostacky-installer", version: "0.7.3" }
         }
       });
     });
   } finally {
-    if (statePath && existsSync5(statePath))
-      rmSync3(statePath, { force: true });
-    if (statePath && existsSync5(statePath + ".backup"))
-      rmSync3(statePath + ".backup", { force: true });
+    await new Promise((r2) => setTimeout(r2, 200));
+    if (statePath) {
+      for (const p2 of [
+        statePath,
+        statePath + ".backup",
+        statePath + ".lock.pid",
+        statePath + ".lock.timestamp",
+        statePath + ".tmp." + process.pid
+      ]) {
+        try {
+          if (existsSync5(p2))
+            rmSync3(p2, { force: true });
+        } catch {}
+      }
+      try {
+        const { dirname: dirname5, join: join7 } = await import("path");
+        const handoff = join7(dirname5(statePath), ".ostacky-handoff-compaction.json");
+        if (existsSync5(handoff)) {
+          try {
+            rmSync3(handoff, { force: true });
+          } catch {}
+        }
+      } catch {}
+    }
   }
 }
 function takeFileSnapshot(path) {
@@ -2723,8 +2784,8 @@ async function installSkill(item, manifest, paths) {
   const treeHash = computeTreeHash(src);
   if (item.sha256 && treeHash !== item.sha256) {
     throw new Error(`Tree hash inválido para skill "${item.name}"
-` + `  esperado: ${item.sha256}
-` + `  recibido: ${treeHash}`);
+  esperado: ${item.sha256}
+  recibido: ${treeHash}`);
   }
   const dest = join6(paths.skills, item.name);
   if (existsSync5(dest)) {
@@ -2764,8 +2825,8 @@ async function installMcpServer(item, manifest, paths) {
   const treeHash = computeTreeHash(src);
   if (item.sha256 && treeHash !== item.sha256) {
     throw new Error(`Tree hash inválido para MCP server "${item.name}"
-` + `  esperado: ${item.sha256}
-` + `  recibido: ${treeHash}`);
+  esperado: ${item.sha256}
+  recibido: ${treeHash}`);
   }
   const nodeExecutable = getVerifiedNodeExecutable();
   const projectRoot = dirname4(paths.root);
@@ -2969,25 +3030,66 @@ function printPostInstallSteps() {
   ].join(`
 `), "Próximos pasos");
 }
-async function resolveOpenCodePaths() {
-  const existing = findOpenCodeDir();
-  if (existing) {
-    const paths2 = ensureOpenCodePaths(existing);
-    ye(existing, "Directorio .opencode encontrado");
-    return paths2;
+async function resolveOpenCodePaths(scope) {
+  if (scope === "local" || scope === "global" || scope === "auto") {
+    const dir2 = getOpenCodeDirForScope(scope);
+    const isGlobalDir = dir2.replace(/\\/g, "/") === getGlobalOpenCodeDir().replace(/\\/g, "/");
+    try {
+      const paths = ensureOpenCodePaths(dir2);
+      if (scope === "global")
+        ye(dir2, "Instalación global");
+      else if (scope === "auto")
+        ye(dir2, `Scope auto → ${isGlobalDir ? "global" : "local"}`);
+      else
+        ye(dir2, "Instalación local");
+      return paths;
+    } catch (e2) {
+      const msg = e2.message ?? "";
+      if ((scope === "global" || scope === "auto" && isGlobalDir) && (msg.includes("EACCES") || msg.toLowerCase().includes("permission"))) {
+        v2.warn(`No se pudo escribir en global (${dir2}): ${msg}. ¿Instalar local?`);
+        const retry = await me({ message: "¿Reintentar como instalación local?" });
+        onCancel(retry);
+        if (retry) {
+          const localDir2 = getOpenCodeDirForScope("local");
+          return ensureOpenCodePaths(localDir2);
+        }
+      }
+      throw e2;
+    }
   }
-  const projectRoot = findProjectRoot();
-  ye(`No se encontró .opencode
-Raíz detectada: ${projectRoot}`, "Aviso");
-  const create = await me({
-    message: "¿Deseas crear la estructura .opencode aquí?"
+  const cwd = process.cwd();
+  const localDir = getOpenCodeDirForScope("local", cwd);
+  const globalDir = getGlobalOpenCodeDir();
+  const hasLocal = !!findOpenCodeDir(cwd);
+  const scopeChoice = await de({
+    message: `¿Instalar en proyecto local (${localDir}) o global (${globalDir})?`,
+    options: [
+      { value: "local", label: "Local", hint: `${localDir} (recomendado)` },
+      { value: "global", label: "Global", hint: globalDir }
+    ],
+    initialValue: "local"
   });
-  onCancel(create);
-  if (!create)
-    return null;
-  const paths = createOpenCodeDir(projectRoot);
-  v2.success(`Estructura creada en ${paths.root}`);
-  return paths;
+  onCancel(scopeChoice);
+  const chosen = scopeChoice;
+  const dir = getOpenCodeDirForScope(chosen, cwd);
+  try {
+    return ensureOpenCodePaths(dir);
+  } catch (e2) {
+    const msg = e2.message ?? "";
+    if (chosen === "global" && (msg.includes("EACCES") || msg.includes("permission"))) {
+      v2.warn(`No se pudo escribir en global (${dir}): ${msg}.`);
+      const retry = await me({ message: "¿Instalar local en su lugar?" });
+      onCancel(retry);
+      if (retry)
+        return ensureOpenCodePaths(getOpenCodeDirForScope("local", cwd));
+    }
+    throw e2;
+  }
+}
+function isGlobalScope(paths) {
+  const globalDir = getGlobalOpenCodeDir().replace(/\\/g, "/");
+  const root = paths.root.replace(/\\/g, "/");
+  return root === globalDir || root.startsWith(globalDir + "/");
 }
 function getOrphanedItems(manifest, paths) {
   const lockfile = readLockfile(paths.root);
@@ -3105,7 +3207,13 @@ async function doInstallStack(toolsDir, projectRoot) {
 async function doInstallAll(manifest, paths) {
   const spin = L2();
   let errors = 0;
-  ensureToolDirs(paths.tools, ["codegraph", "engram", "context7"]);
+  const isGlobal = isGlobalScope(paths);
+  if (!isGlobal) {
+    ensureToolDirs(paths.tools, ["codegraph", "engram", "context7"]);
+  } else {
+    v2.info("Scope global detectado: el stack (CodeGraph/Engram) permanece siempre en <proyecto>/.opencode/tools — se omite instalación de stack global.");
+    v2.info("Para instalar el stack, ejecutá 'npx ostacky install-stack --scope local' dentro de cada proyecto.");
+  }
   for (const agent of manifest.agents) {
     spin.start(`Descargando agente: ${agent.name}  (${agent.version})`);
     try {
@@ -3150,17 +3258,22 @@ async function doInstallAll(manifest, paths) {
       errors++;
     }
   }
-  v2.info("Instalando stack de herramientas...");
-  const stackOk = await doInstallStack(paths.tools, dirname6(paths.root));
-  if (!stackOk)
-    errors++;
-  const missingTools = [];
-  const codegraphDir = join8(paths.tools, "codegraph");
-  const engramDir = join8(paths.tools, "engram");
-  if (!existsSync7(codegraphDir) || !findBinaryInDir(codegraphDir, "codegraph"))
-    missingTools.push("CodeGraph");
-  if (!existsSync7(engramDir) || !findBinaryInDir(engramDir, "engram"))
-    missingTools.push("Engram");
+  let stackOk = true;
+  let missingTools = [];
+  if (isGlobal) {
+    stackOk = true;
+  } else {
+    v2.info("Instalando stack de herramientas...");
+    stackOk = await doInstallStack(paths.tools, dirname6(paths.root));
+    if (!stackOk)
+      errors++;
+    const codegraphDir = join8(paths.tools, "codegraph");
+    const engramDir = join8(paths.tools, "engram");
+    if (!existsSync7(codegraphDir) || !findBinaryInDir(codegraphDir, "codegraph"))
+      missingTools.push("CodeGraph");
+    if (!existsSync7(engramDir) || !findBinaryInDir(engramDir, "engram"))
+      missingTools.push("Engram");
+  }
   if (missingTools.length > 0) {
     v2.warn(`Faltan herramientas del stack: ${missingTools.join(", ")}.
 ` + "Ejecutá `/install-stack` desde el agente para instalarlas manualmente.");
@@ -3675,10 +3788,10 @@ async function doUninstallMcpByName(name, paths) {
 }
 
 // src/prompts/index.ts
-async function runInteractiveMenu() {
+async function runInteractiveMenu(scope) {
   we(" OpenCode Installer ");
   const manifest = await loadManifest();
-  const paths = await resolveOpenCodePaths();
+  const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
     fe("Instalación cancelada.");
     return;
@@ -3726,6 +3839,12 @@ async function runInteractiveMenu() {
       fe("Listo.");
       break;
     case "stack": {
+      if (isGlobalScope(paths)) {
+        v2.error("install-stack requiere scope local; el stack vive en <proyecto>/.opencode/tools");
+        v2.info(`Elegiste global (${paths.root}) — el stack debe instalarse por proyecto local.`);
+        fe("Cancelado.");
+        break;
+      }
       ensureToolDirs(paths.tools, ["codegraph", "engram", "context7"]);
       const stackOk = await doInstallStack(paths.tools, dirname7(paths.root));
       if (!stackOk)
@@ -3748,10 +3867,10 @@ async function runInteractiveMenu() {
       break;
   }
 }
-async function runInstallCommand() {
+async function runInstallCommand(scope) {
   we(" OpenCode Installer ");
   const manifest = await loadManifest();
-  const paths = await resolveOpenCodePaths();
+  const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
     fe("Cancelado.");
     return;
@@ -3761,10 +3880,10 @@ async function runInstallCommand() {
   printPostInstallSteps();
   fe(process.exitCode ? "Instalación parcial." : "Instalación completada.");
 }
-async function runAddAgentCommand() {
+async function runAddAgentCommand(scope) {
   we(" OpenCode Installer ");
   const manifest = await loadManifest();
-  const paths = await resolveOpenCodePaths();
+  const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
     fe("Cancelado.");
     return;
@@ -3773,10 +3892,10 @@ async function runAddAgentCommand() {
   printPostInstallSteps();
   fe("Listo.");
 }
-async function runAddCommandCommand() {
+async function runAddCommandCommand(scope) {
   we(" OpenCode Installer ");
   const manifest = await loadManifest();
-  const paths = await resolveOpenCodePaths();
+  const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
     fe("Cancelado.");
     return;
@@ -3785,10 +3904,10 @@ async function runAddCommandCommand() {
   printPostInstallSteps();
   fe("Listo.");
 }
-async function runAddSkillCommand() {
+async function runAddSkillCommand(scope) {
   we(" OpenCode Installer ");
   const manifest = await loadManifest();
-  const paths = await resolveOpenCodePaths();
+  const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
     fe("Cancelado.");
     return;
@@ -3797,10 +3916,10 @@ async function runAddSkillCommand() {
   printPostInstallSteps();
   fe("Listo.");
 }
-async function runAddMcpCommand() {
+async function runAddMcpCommand(scope) {
   we(" OpenCode Installer ");
   const manifest = await loadManifest();
-  const paths = await resolveOpenCodePaths();
+  const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
     fe("Cancelado.");
     return;
@@ -3809,22 +3928,35 @@ async function runAddMcpCommand() {
   printPostInstallSteps();
   fe("Listo.");
 }
-async function runInstallStackCommand() {
+async function runInstallStackCommand(scope) {
+  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");
+    process.exitCode = 1;
+    return;
+  }
   we(" OpenCode Installer — Stack ");
-  const paths = await resolveOpenCodePaths();
+  const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
     fe("Cancelado.");
     return;
   }
+  if (isGlobalScope(paths)) {
+    v2.error("install-stack requiere scope local; el stack vive en <proyecto>/.opencode/tools");
+    v2.info(`Scope resuelto a global (${paths.root}) — el stack debe instalarse por proyecto local.`);
+    fe("Cancelado.");
+    process.exitCode = 1;
+    return;
+  }
   ensureToolDirs(paths.tools, ["codegraph", "engram", "context7"]);
   const stackOk = await doInstallStack(paths.tools, dirname7(paths.root));
   if (!stackOk)
     process.exitCode = 1;
   fe(stackOk ? "Stack instalado." : "Stack instalado parcialmente.");
 }
-async function runUninstallStackCommand() {
+async function runUninstallStackCommand(scope) {
   we(" OpenCode Installer — Stack ");
-  const paths = await resolveOpenCodePaths();
+  const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
     fe("Cancelado.");
     return;
@@ -3846,10 +3978,10 @@ async function runUninstallStackCommand() {
   }
   fe("Stack desinstalado.");
 }
-async function runUpdateCommand() {
+async function runUpdateCommand(scope) {
   we(" OpenCode Installer ");
   const manifest = await loadLatestManifest();
-  const paths = await resolveOpenCodePaths();
+  const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
     fe("Cancelado.");
     return;
@@ -3857,9 +3989,9 @@ async function runUpdateCommand() {
   await doUpdate(manifest, paths);
   fe("Actualización completada.");
 }
-async function runUninstallCommand() {
+async function runUninstallCommand(scope) {
   we(" OpenCode Installer ");
-  const paths = await resolveOpenCodePaths();
+  const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
     fe("Cancelado.");
     return;
@@ -3867,9 +3999,9 @@ async function runUninstallCommand() {
   await doUninstall(paths);
   fe("Desinstalación completada.");
 }
-async function runUninstallAgentCommand(name) {
+async function runUninstallAgentCommand(name, scope) {
   we(" OpenCode Installer ");
-  const paths = await resolveOpenCodePaths();
+  const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
     fe("Cancelado.");
     return;
@@ -3902,9 +4034,9 @@ async function runUninstallAgentCommand(name) {
   }
   fe("Listo.");
 }
-async function runUninstallCommandCommand(name) {
+async function runUninstallCommandCommand(name, scope) {
   we(" OpenCode Installer ");
-  const paths = await resolveOpenCodePaths();
+  const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
     fe("Cancelado.");
     return;
@@ -3937,9 +4069,9 @@ async function runUninstallCommandCommand(name) {
   }
   fe("Listo.");
 }
-async function runUninstallSkillCommand(name) {
+async function runUninstallSkillCommand(name, scope) {
   we(" OpenCode Installer ");
-  const paths = await resolveOpenCodePaths();
+  const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
     fe("Cancelado.");
     return;
@@ -3972,9 +4104,9 @@ async function runUninstallSkillCommand(name) {
   }
   fe("Listo.");
 }
-async function runUninstallMcpCommand(name) {
+async function runUninstallMcpCommand(name, scope) {
   we(" OpenCode Installer ");
-  const paths = await resolveOpenCodePaths();
+  const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
     fe("Cancelado.");
     return;
@@ -4009,76 +4141,285 @@ async function runUninstallMcpCommand(name) {
 }
 
 // src/cli.ts
+init_fs();
+import { existsSync as existsSync8, statSync as statSync3, readFileSync as readFileSync6 } from "node:fs";
+import { join as join11, dirname as dirname8 } from "node:path";
 var HELP = `
 ostacky — Instalador de agentes, comandos, skills y MCPs para OpenCode
 
 Uso:
-  npx ostacky                    Menú interactivo (instalación completa)
-  npx ostacky install            Instalar TODO (agente + skills + MCPs + CodeGraph + OpenSpec + Engram + Context7)
-  npx ostacky add agent          Agregar agente(s)
-  npx ostacky add command        Agregar command(s)
-  npx ostacky add skill          Agregar skill(s)
-  npx ostacky add mcp            Agregar MCP server(s)
-  npx ostacky install-stack      Instalar solo el stack de herramientas (CodeGraph, OpenSpec, Engram, Context7)
-  npx ostacky uninstall-stack    Remover la configuración del stack del proyecto
-  npx ostacky update             Actualizar instalación
-  npx ostacky uninstall          Desinstalar todo
-  npx ostacky uninstall agent    Desinstalar agente(s)
-  npx ostacky uninstall command  Desinstalar command(s)
-  npx ostacky uninstall skill    Desinstalar skill(s)
-  npx ostacky uninstall mcp      Desinstalar MCP server(s)
+  npx ostacky [--scope local|global|auto]                    Menú interactivo (instalación completa, pregunta local vs global, default local)
+  npx ostacky install [--scope local|global|auto]            Instalar TODO (agente + skills + MCPs + CodeGraph + OpenSpec + Engram + Context7)
+  npx ostacky add agent [--scope local|global|auto]          Agregar agente(s)
+  npx ostacky add command [--scope ...]        Agregar command(s)
+  npx ostacky add skill [--scope ...]          Agregar skill(s)
+  npx ostacky add mcp [--scope ...]            Agregar MCP server(s)
+  npx ostacky install-stack [--scope local|auto]      Instalar solo el stack de herramientas (CodeGraph, OpenSpec, Engram, Context7) — global bloquea con error
+  npx ostacky uninstall-stack [--scope local|global|auto]    Remover la configuración del stack del proyecto
+  npx ostacky doctor                           Diagnostica locks, tools, state health
+  npx ostacky status [--json]                  Muestra estado del controller sin MCP
+  npx ostacky update [--scope ...]             Actualizar instalación
+  npx ostacky uninstall [--scope ...]          Desinstalar todo
+  npx ostacky uninstall agent [--scope ...]    Desinstalar agente(s)
+  npx ostacky uninstall command [--scope ...]  Desinstalar command(s)
+  npx ostacky uninstall skill [--scope ...]    Desinstalar skill(s)
+  npx ostacky uninstall mcp [--scope ...]      Desinstalar MCP server(s)
   npx ostacky --help             Mostrar esta ayuda
   npx ostacky --version          Mostrar versión
+
+Scope:
+  --scope local   Escribe en <proyecto>/.opencode (recomendado, default al preguntar)
+  --scope global  Escribe en ~/.config/opencode (o %APPDATA%\\opencode en Windows)
+  --scope auto    Elige local si existe .opencode o .git, si no global
+  Sin flag        Pregunta interactiva local (default) vs global
 `.trim();
-var [, , cmd, subcmd] = process.argv;
+function parseScopeArg(argv = process.argv) {
+  for (let i = 0;i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "--scope" && i + 1 < argv.length) {
+      const v3 = argv[i + 1];
+      if (v3 === "local" || v3 === "global" || v3 === "auto")
+        return v3;
+    }
+    if (arg.startsWith("--scope=")) {
+      const v3 = arg.split("=")[1];
+      if (v3 === "local" || v3 === "global" || v3 === "auto")
+        return v3;
+    }
+  }
+  return null;
+}
+function withoutScopeArgs(argv) {
+  const out = [];
+  for (let i = 0;i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "--scope" && i + 1 < argv.length) {
+      i++;
+      continue;
+    }
+    if (arg.startsWith("--scope="))
+      continue;
+    out.push(arg);
+  }
+  return out;
+}
+var scope = parseScopeArg();
+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");
+  let hasError = false;
+  let hasWarn = false;
+  const check = (label, ok, warn = false) => {
+    if (ok)
+      console.log(`✅ ${label}: OK`);
+    else if (warn) {
+      console.log(`⚠️ ${label}`);
+      hasWarn = true;
+    } else {
+      console.log(`❌ ${label}`);
+      hasError = true;
+    }
+  };
+  try {
+    if (!existsSync8(statePath)) {
+      check("controller: state file missing", false, true);
+    } else {
+      const stat = statSync3(statePath);
+      const raw = readFileSync6(statePath, "utf-8");
+      const parsed = JSON.parse(raw);
+      check(`controller: OK (rev ${parsed.revision || 0} state ${parsed.state || "unknown"})`, true);
+      if (parsed.degraded) {
+        console.log("⚠️ degraded: true (persistido)");
+        hasWarn = true;
+      }
+      if (parsed.degradedEditsCount > 0)
+        console.log(`⚠️ degraded: confirmation not audited in controller (degradedEditsCount=${parsed.degradedEditsCount})`);
+      if (parsed.codegraphBypassCount > 0)
+        console.log(`⚠️ codegraphBypassCount=${parsed.codegraphBypassCount} (inefficient: codegraph bypass)`);
+      if (parsed.stateOversizedCount > 0)
+        console.log(`⚠️ stateOversizedCount=${parsed.stateOversizedCount} snapshots perdidos`);
+      if (parsed.sensitiveAccess)
+        console.log(`ℹ️ sensitiveAccess: allowed=${parsed.sensitiveAccess.allowed || 0} denied=${parsed.sensitiveAccess.denied || 0} blocked=${parsed.sensitiveAccess.blockedAttempts || 0}`);
+      if (parsed.deniedFiles && Object.keys(parsed.deniedFiles).length) {
+        console.log(`ℹ️ denied files: ${Object.keys(parsed.deniedFiles).join(", ")} (denied by user)`);
+      }
+      if (parsed.staleContentAttempts > 0)
+        console.log(`⚠️ staleContentAttempts=${parsed.staleContentAttempts}`);
+      if (parsed.completeWithoutValidateCount > 0)
+        console.log(`⚠️ completeWithoutValidateCount=${parsed.completeWithoutValidateCount}`);
+      if (stat.size > 2 * 1024 * 1024) {
+        console.log("⚠️ state file >2MB (oversized)");
+        hasWarn = true;
+      }
+      const auditSize = (parsed.audit || []).length;
+      if (auditSize > 500)
+        console.log(`⚠️ audit large: ${auditSize}`);
+      try {
+        const { statfsSync } = await import("node:fs");
+        if (typeof statfsSync === "function") {
+          const s = statfsSync(dirname8(statePath));
+          const freeMB = Math.floor(s.bfree * s.bsize / 1048576);
+          if (freeMB < 100) {
+            console.log(`⚠️ Disco casi lleno: ${freeMB}MB libres`);
+            hasWarn = true;
+          } else
+            console.log(`ℹ️ diskFreeMB: ${freeMB}`);
+        }
+      } catch {}
+      if ((parsed.state === "EXECUTING_INLINE" || parsed.state === "EXECUTING_SUBAGENTS") && parsed.expectedTasks) {
+        const pending = parsed.expectedTasks.filter((id) => !parsed.tasks?.[id] || parsed.tasks[id].status !== "COMPLETED").length;
+        const lastHandoffAge = parsed.lastHandoff ? Date.now() - parsed.lastHandoff.ts : Infinity;
+        if (pending === 0 && lastHandoffAge > 60000) {
+          console.log("⚠️ EXECUTING_* con pending==0 y lastHandoff >60s sin progreso — sugerir implementation_complete manual");
+          hasWarn = true;
+        }
+      }
+    }
+  } catch (e2) {
+    check(`controller: ${e2.message}`, false);
+  }
+  try {
+    const lockPid = join11(opencodeDir, "ostacky-state.json.lock.pid");
+    const lockTs = join11(opencodeDir, "ostacky-state.json.lock.timestamp");
+    if (existsSync8(lockPid) || existsSync8(lockTs)) {
+      let ageStr = "";
+      try {
+        const ts = parseInt(readFileSync6(lockTs, "utf-8"), 10);
+        const age = Date.now() - ts;
+        ageStr = `${Math.floor(age / 1000)}s`;
+        const pid = readFileSync6(lockPid, "utf-8").trim();
+        let alive = false;
+        try {
+          process.kill(parseInt(pid, 10), 0);
+          alive = true;
+        } catch {}
+        check(`lock: PID ${pid} age ${ageStr} alive=${alive}`, !alive || age > 15000, true);
+      } catch {
+        check("lock: exists (no timestamp)", false, true);
+      }
+    } else {
+      check("lock: no active lock", true);
+    }
+  } catch {
+    check("lock: check failed", false, true);
+  }
+  const tools = ["codegraph", "engram"];
+  for (const t of tools) {
+    const p2 = join11(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 expected = manifest.mcpServers?.find((x2) => x2.name === "ostacky-controller")?.sha256;
+    if (expected) {
+      const actual = computeTreeHash(join11(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");
+    }
+  } catch {
+    check("manifest: not found", false, true);
+  }
+  if (existsSync8(statePath)) {
+    try {
+      const s = JSON.parse(readFileSync6(statePath, "utf-8"));
+      if (s.allowedFiles || s.deniedFiles) {}
+    } catch {}
+  }
+  if (hasError)
+    process.exit(1);
+  if (hasWarn)
+    process.exit(0);
+}
+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");
+  if (!existsSync8(statePath)) {
+    console.log(isJson ? JSON.stringify({ error: "no state" }) : "No state file");
+    return;
+  }
+  try {
+    const parsed = JSON.parse(readFileSync6(statePath, "utf-8"));
+    const completed = Object.values(parsed.tasks || {}).filter((t) => t.status === "COMPLETED").length;
+    const expected = parsed.expectedTaskCount ?? parsed.expectedTasks?.length ?? Object.keys(parsed.tasks || {}).length;
+    const degraded = parsed.degraded ? " degraded" : "";
+    const lastHandoff = parsed.lastHandoff ? ` lastHandoff: ${parsed.lastHandoff.summary?.slice(0, 60)}` : "";
+    if (isJson) {
+      console.log(JSON.stringify({ state: parsed.state, revision: parsed.revision, degraded: !!parsed.degraded, tasks: `${completed}/${expected}`, lastHandoff: parsed.lastHandoff }, null, 2));
+    } else {
+      console.log(`${parsed.state} rev ${parsed.revision}${degraded} tasks ${completed}/${expected}${lastHandoff}`);
+      if (parsed.lastProposal)
+        console.log(`lastProposal: ${parsed.lastProposal.summary} shownToUser=${parsed.lastProposal.shownToUser}`);
+    }
+  } catch (e2) {
+    console.log(`Error reading state: ${e2.message}`);
+  }
+}
 async function main() {
   switch (cmd) {
     case "install":
-      await runInstallCommand();
+      await runInstallCommand(scope);
       break;
     case "install-stack":
-      await runInstallStackCommand();
+      if (scope === "global") {
+        console.error("Error: install-stack requiere scope local; el stack vive en <proyecto>/.opencode/tools");
+        console.error("Sugerencia: ejecutá 'npx ostacky install-stack --scope local' dentro de cada proyecto.");
+        process.exit(1);
+      }
+      await runInstallStackCommand(scope);
       break;
     case "uninstall-stack":
-      await runUninstallStackCommand();
+      await runUninstallStackCommand(scope);
       break;
     case "add":
       if (subcmd === "agent") {
-        await runAddAgentCommand();
+        await runAddAgentCommand(scope);
       } else if (subcmd === "command") {
-        await runAddCommandCommand();
+        await runAddCommandCommand(scope);
       } else if (subcmd === "skill") {
-        await runAddSkillCommand();
+        await runAddSkillCommand(scope);
       } else if (subcmd === "mcp") {
-        await runAddMcpCommand();
+        await runAddMcpCommand(scope);
       } else {
         console.error(`Tipo desconocido: "${subcmd}". Usa 'agent', 'command', 'skill' o 'mcp'.`);
         process.exit(1);
       }
       break;
     case "update":
-      await runUpdateCommand();
+      await runUpdateCommand(scope);
       break;
     case "uninstall":
       if (subcmd === "agent") {
-        const name = process.argv[4];
-        await runUninstallAgentCommand(name);
+        const name = argvNoScope[4];
+        await runUninstallAgentCommand(name, scope);
       } else if (subcmd === "command") {
-        const name = process.argv[4];
-        await runUninstallCommandCommand(name);
+        const name = argvNoScope[4];
+        await runUninstallCommandCommand(name, scope);
       } else if (subcmd === "skill") {
-        const name = process.argv[4];
-        await runUninstallSkillCommand(name);
+        const name = argvNoScope[4];
+        await runUninstallSkillCommand(name, scope);
       } else if (subcmd === "mcp") {
-        const name = process.argv[4];
-        await runUninstallMcpCommand(name);
+        const name = argvNoScope[4];
+        await runUninstallMcpCommand(name, scope);
       } else if (subcmd === undefined) {
-        await runUninstallCommand();
+        await runUninstallCommand(scope);
       } else {
         console.error(`Subcomando desconocido: "${subcmd}". Usa 'agent', 'command', 'skill', 'mcp' o nada.`);
         process.exit(1);
       }
       break;
+    case "doctor":
+      await runDoctorCommand();
+      break;
+    case "status":
+      await runStatusCommand(argvNoScope.slice(3));
+      break;
     case "--help":
     case "-h":
       console.log(HELP);
@@ -4092,7 +4433,7 @@ async function main() {
         console.error(`Comando desconocido: "${cmd}". Usá --help para ver los comandos disponibles.`);
         process.exit(1);
       }
-      await runInteractiveMenu();
+      await runInteractiveMenu(scope);
   }
 }
 main().catch((e2) => {