ostacky 0.7.0 → 0.7.2

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) {
@@ -243,6 +246,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 +295,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 +477,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 +546,31 @@ var init_fs = __esm(() => {
 var manifest_default;
 var init_manifest = __esm(() => {
   manifest_default = {
-    version: "0.7.0",
+    version: "0.7.2",
     repo: "JaimeHoracio/Ostacky",
-    tag: "v0.7.0",
+    tag: "v0.7.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.7.0: prune de skills obsoletas, lastHandoff, getAvailableTransitions, consecutiveFailures real, mem_session_summary automático al cierre.",
-        version: "0.7.0",
-        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.2: prune de skills obsoletas, lastHandoff, getAvailableTransitions, consecutiveFailures real, mem_session_summary automático al cierre.",
+        version: "0.7.2",
+        sha256: "1b6a5cbb49f1c6e977241f8ab86d1a045fdb8a04111bbc75633429a131c71acd"
       }
     ],
     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.0: Paso 1.5 controller expandido con verificación post-instalación y troubleshooting.",
-        version: "0.7.0",
-        sha256: "c957627dfafabfdb9da2717546b996d1d8856f08a6e4c48caf72c562363b566b"
+        description: "Instala el stack tecnológico del proyecto (CodeGraph, skills, OpenSpec, Engram, Context7, controller MCP con SDK oficial). v0.7.2: Paso 1.5 controller expandido con verificación post-instalación y troubleshooting.",
+        version: "0.7.2",
+        sha256: "7277d333bfe65e674b9696fa5f887854e35824eb5b88420dd0f5bbde3bca7add"
       },
       {
         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.0",
+        version: "0.7.2",
         sha256: "fe0158478f2ca63b315037a85fc1632b77868532e319af6c7384285441767d64"
       }
     ],
@@ -552,15 +578,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.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.7.0",
-        sha256: "0ec6fa0fc2900c78b884258168309653dea4b77ded3596bb56866f689ec2404c"
+        description: "Máquina de estados persistida con @modelcontextprotocol/server SDK. v0.7.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.7.2",
+        sha256: "34048819b8905dff24c731e02d813deb4fb7fbbb65e8b8df66e5c8db201492a0"
       },
       {
         name: "openspec",
         file: "assets/mcp/openspec/",
         description: "MCP server local para OpenSpec - proposal, apply, archive, sync de cambios",
-        version: "0.7.0",
+        version: "0.7.2",
         sha256: "fa4be28bfc1e75db8f1a037e2580f04a60066c80e8e5934e90e1041020d04609"
       }
     ],
@@ -569,106 +595,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.0",
+        version: "0.7.2",
         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.0",
+        version: "0.7.2",
         sha256: "edf6fca0af52cce83f8fd08e7db9b3d79cc130b53fca505e90d3fbaf4909338b"
       },
       {
         name: "tdd",
         file: "assets/skills/tdd/SKILL.md",
         description: "Skill de test-driven development (Superpowers)",
-        version: "0.7.0",
+        version: "0.7.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.7.0",
+        version: "0.7.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.7.0",
+        version: "0.7.2",
         sha256: "3c8a66d51ae2e719e877d02c3dac32bd804722c3bb9227c258ecae78252a20ab"
       },
       {
         name: "review",
         file: "assets/skills/review/SKILL.md",
         description: "Skill de revisión de código (Superpowers)",
-        version: "0.7.0",
+        version: "0.7.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.7.0",
+        version: "0.7.2",
         sha256: "d761e884e71d8d3476ac734d287cae403a4024506a7d12e7361a448217c0a831"
       },
       {
         name: "openspec-propose",
         file: "assets/skills/openspec-propose/SKILL.md",
         description: "Skill de generación de proposal (OpenSpec)",
-        version: "0.7.0",
+        version: "0.7.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.7.0",
+        version: "0.7.2",
         sha256: "dfc823bf89fc7505e91ab6dee9c1f004be38a410bd3d88fb67b211b1b6cbb1d0"
       },
       {
         name: "openspec-archive-change",
         file: "assets/skills/openspec-archive-change/SKILL.md",
         description: "Skill de archivo de change (OpenSpec)",
-        version: "0.7.0",
+        version: "0.7.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.7.0",
+        version: "0.7.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.7.0",
+        version: "0.7.2",
         sha256: "11afa9123828fc5caa22137aff907cd99c751e99027fbd4c020751110a949281"
       },
       {
         name: "using-superpowers",
         file: "assets/skills/using-superpowers/SKILL.md",
         description: "Skill de orquestación de Superpowers skills",
-        version: "0.7.0",
+        version: "0.7.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.7.0",
+        version: "0.7.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.7.0",
-        sha256: "e5090e475729f21871bb25bce738000f3616955ed3edb3ba926dd740d3298948"
+        version: "0.7.2",
+        sha256: "376dc90fa27ab7e5947747f20ccf2cc76f9326c77b567fda388252a60d25c431"
       }
     ]
   };
@@ -1045,7 +1071,8 @@ __export(exports_stack, {
   installEngram: () => installEngram,
   installCodeGraph: () => installCodeGraph,
   buildLocalMcpCommand: () => buildLocalMcpCommand,
-  buildEngramDownloadUrl: () => buildEngramDownloadUrl
+  buildEngramDownloadUrl: () => buildEngramDownloadUrl,
+  OPENSPEC_NPM_PACKAGE: () => OPENSPEC_NPM_PACKAGE
 });
 import { chmodSync, copyFileSync as copyFileSync3, existsSync as existsSync6, mkdirSync as mkdirSync4, rmSync as rmSync4, unlinkSync as unlinkSync3 } from "fs";
 import { basename as basename2, dirname as dirname5, join as join7, resolve as resolve2 } from "path";
@@ -1185,20 +1212,56 @@ async function installCodeGraph(toolsDir) {
 }
 function setupOpenSpec(projectRoot = findProjectRoot()) {
   const useBun = isCommandAvailable("bun");
-  try {
-    const invocation = getCommandInvocation(useBun ? "bunx" : "npx", useBun ? ["openspec", "init", "--tools", "opencode", "--force"] : ["--yes", "openspec", "init", "--tools", "opencode", "--force"]);
-    execFileSync3(invocation.command, invocation.args, {
-      stdio: "pipe",
-      timeout: 120000,
-      cwd: projectRoot
-    });
+  const fail = (msg) => ({ success: false, message: msg });
+  const tryDirect = () => {
+    try {
+      const invocation = getCommandInvocation(useBun ? "bunx" : "npx", useBun ? [OPENSPEC_NPM_PACKAGE, "init", "--tools", "opencode", "--force"] : ["--yes", OPENSPEC_NPM_PACKAGE, "init", "--tools", "opencode", "--force"]);
+      execFileSync3(invocation.command, invocation.args, {
+        stdio: "pipe",
+        timeout: 120000,
+        cwd: projectRoot
+      });
+      return true;
+    } catch {
+      return false;
+    }
+  };
+  const tryInstallGlobal = () => {
+    if (!useBun && !isCommandAvailable("npm")) {
+      return { ok: false, error: "Ni bun ni npm están disponibles para instalar OpenSpec globalmente" };
+    }
+    const pkgManager = useBun ? "bun" : "npm";
+    const installArgs = useBun ? ["add", "-g", OPENSPEC_NPM_PACKAGE] : ["install", "-g", OPENSPEC_NPM_PACKAGE];
+    try {
+      const invocation = getCommandInvocation(pkgManager, installArgs);
+      execFileSync3(invocation.command, invocation.args, { stdio: "pipe", timeout: 120000 });
+    } catch (installErr) {
+      return { ok: false, error: `Instalación global falló: ${installErr.message}` };
+    }
+    try {
+      const retryInvocation = getCommandInvocation("openspec", ["init", "--tools", "opencode", "--force"]);
+      execFileSync3(retryInvocation.command, retryInvocation.args, {
+        stdio: "pipe",
+        timeout: 120000,
+        cwd: projectRoot
+      });
+      return { ok: true };
+    } catch (retryErr) {
+      return { ok: false, error: `Reintento con binario global falló: ${retryErr.message}` };
+    }
+  };
+  if (tryDirect()) {
     return { success: true, message: "OpenSpec configurado para OpenCode" };
-  } catch (e2) {
+  }
+  const fallback = tryInstallGlobal();
+  if (fallback.ok) {
     return {
-      success: false,
-      message: `Error configurando OpenSpec: ${e2.message}`
+      success: true,
+      message: `OpenSpec configurado para OpenCode (binario instalado globalmente con ${useBun ? "bun" : "npm"})`
     };
   }
+  const manualCmd = useBun ? `bun add -g ${OPENSPEC_NPM_PACKAGE}` : `npm install -g ${OPENSPEC_NPM_PACKAGE}`;
+  return fail(`Error configurando OpenSpec: ni bunx/npx ni la instalación global resolvieron el binario. ` + `Solución manual: ejecuta \`${manualCmd}\` y luego corré /install-stack de nuevo. ` + `Detalle: ${fallback.error}`);
 }
 async function installEngram(toolsDir) {
   const location = resolveToolInstallLocation(toolsDir);
@@ -1422,6 +1485,7 @@ function verifyMcpServers(projectRoot) {
   }
   return result;
 }
+var OPENSPEC_NPM_PACKAGE = "@fission-ai/openspec";
 var init_stack = __esm(() => {
   init_fs();
   init_config();
@@ -1430,7 +1494,7 @@ var init_stack = __esm(() => {
 // package.json
 var package_default = {
   name: "ostacky",
-  version: "0.7.0",
+  version: "0.7.2",
   description: "Instalador interactivo de agentes y comandos para OpenCode",
   type: "module",
   bin: {
@@ -2430,6 +2494,7 @@ import { dirname as dirname7 } from "path";
 init_github();
 init_fs();
 init_lockfile();
+import { homedir as homedir2 } from "os";
 
 // src/installer.ts
 init_github();
@@ -2486,7 +2551,13 @@ function validateMcpModule(nodeExecutable, serverPath, cwd) {
     throw new Error(`El MCP no pasó la validación de carga: ${error.message}`);
   }
 }
-async function probeMcpServer(nodeExecutable, serverPath, cwd, statePath) {
+var DEFAULT_PROBE_OPTIONS = {
+  requiredTools: ["ping", "start_request"],
+  exerciseWrite: true
+};
+async function probeMcpServer(nodeExecutable, serverPath, cwd, statePath, options = {}) {
+  const requiredTools = options.requiredTools ?? DEFAULT_PROBE_OPTIONS.requiredTools;
+  const exerciseWrite = options.exerciseWrite ?? requiredTools.includes("start_request");
   try {
     await new Promise((resolve2, reject) => {
       const child = spawn(nodeExecutable, [serverPath], {
@@ -2502,6 +2573,7 @@ async function probeMcpServer(nodeExecutable, serverPath, cwd, statePath) {
       let stderr = "";
       let stdoutBuffer = "";
       const requestTimeout = 1e4;
+      let exitTimeout;
       const finish = (error) => {
         if (settled)
           return;
@@ -2510,9 +2582,18 @@ async function probeMcpServer(nodeExecutable, serverPath, cwd, statePath) {
         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) => {
@@ -2555,17 +2636,22 @@ async function probeMcpServer(nodeExecutable, serverPath, cwd, statePath) {
           }
           if (message.id === 2) {
             const tools = message.result?.tools ?? [];
-            if (!tools.some((tool) => tool.name === "ping") || !tools.some((tool) => tool.name === "start_request")) {
-              fail("El MCP inició pero no expuso las tools requeridas");
+            const missing = requiredTools.filter((name) => !tools.some((tool) => tool.name === name));
+            if (missing.length > 0) {
+              fail(`El MCP inició pero no expuso las tools requeridas: ${missing.join(", ")}`);
               return;
             }
-            send({
-              jsonrpc: "2.0",
-              id: 3,
-              method: "tools/call",
-              params: { name: "start_request", arguments: { requestId: "installer-probe" } }
-            });
-            continue;
+            if (exerciseWrite) {
+              send({
+                jsonrpc: "2.0",
+                id: 3,
+                method: "tools/call",
+                params: { name: "start_request", arguments: { requestId: "installer-probe" } }
+              });
+              continue;
+            }
+            finish();
+            return;
           }
           if (message.id === 3) {
             const result = message.result;
@@ -2584,15 +2670,35 @@ async function probeMcpServer(nodeExecutable, serverPath, cwd, statePath) {
         params: {
           protocolVersion: "2025-03-26",
           capabilities: {},
-          clientInfo: { name: "ostacky-installer", version: "0.7.0" }
+          clientInfo: { name: "ostacky-installer", version: "0.7.2" }
         }
       });
     });
   } 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) {
@@ -2674,8 +2780,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)) {
@@ -2715,8 +2821,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);
@@ -2754,7 +2860,9 @@ async function installMcpServer(item, manifest, paths) {
       throw new Error(`El MCP ${item.name} no contiene index.js después de instalarse.`);
     }
     validateMcpModule(nodeExecutable, stagedServerPath, staging);
-    await probeMcpServer(nodeExecutable, stagedServerPath, staging, item.name === "ostacky-controller" ? join6(staging, ".probe-state.json") : undefined);
+    const isController = item.name === "ostacky-controller";
+    const probeOptions = isController ? { requiredTools: ["ping", "start_request"], exerciseWrite: true } : { requiredTools: [], exerciseWrite: false };
+    await probeMcpServer(nodeExecutable, stagedServerPath, staging, isController ? join6(staging, ".probe-state.json") : undefined, probeOptions);
     const configPath = findOpenCodeConfig(projectRoot) ?? join6(projectRoot, "opencode.json");
     const configSnapshot = takeFileSnapshot(configPath);
     const lockfileSnapshot = takeFileSnapshot(getLockfilePath(paths.root));
@@ -2918,25 +3026,63 @@ 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);
+    try {
+      const paths = ensureOpenCodePaths(dir2);
+      if (scope === "global")
+        ye(dir2, "Instalación global");
+      else if (scope === "auto")
+        ye(dir2, `Scope auto → ${dir2.includes(homedir2()) && dir2.includes(".config") ? "global" : "local"}`);
+      else
+        ye(dir2, "Instalación local");
+      return paths;
+    } catch (e2) {
+      const msg = e2.message ?? "";
+      if (scope === "global" && (msg.includes("EACCES") || msg.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) {
+  return paths.root === getGlobalOpenCodeDir() || paths.root.startsWith(getGlobalOpenCodeDir() + "/");
 }
 function getOrphanedItems(manifest, paths) {
   const lockfile = readLockfile(paths.root);
@@ -3054,7 +3200,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 = paths.root === getGlobalOpenCodeDir() || paths.root.startsWith(getGlobalOpenCodeDir() + "/");
+  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 {
@@ -3099,17 +3251,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.");
@@ -3624,10 +3781,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;
@@ -3675,6 +3832,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)
@@ -3697,10 +3860,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;
@@ -3710,10 +3873,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;
@@ -3722,10 +3885,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;
@@ -3734,10 +3897,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;
@@ -3746,10 +3909,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;
@@ -3758,9 +3921,15 @@ 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;
@@ -3771,9 +3940,9 @@ async function runInstallStackCommand() {
     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;
@@ -3795,10 +3964,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;
@@ -3806,9 +3975,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;
@@ -3816,9 +3985,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;
@@ -3851,9 +4020,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;
@@ -3886,9 +4055,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;
@@ -3921,9 +4090,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;
@@ -3962,67 +4131,110 @@ 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 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 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);
@@ -4041,7 +4253,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) => {