ostacky 0.9.6 → 0.10.0

package/dist/cli.js

@@ -222,6 +222,7 @@ import {
   renameSync
 } from "fs";
 import { createHash as createHash2 } from "crypto";
+import { homedir } from "os";
 import { join, resolve, dirname, relative, basename } from "path";
 import { execFileSync } from "child_process";
 function findOpenCodeDir(startDir = process.cwd()) {
@@ -261,7 +262,23 @@ function isGitRepo(dir = process.cwd()) {
 function initGitRepo(dir) {
   execFileSync("git", ["init"], { cwd: dir, stdio: "pipe" });
 }
+function getGlobalOpenCodeDir(opts) {
+  const platform = opts?.platform ?? process.platform;
+  const env = opts?.env ?? process.env;
+  const home = opts?.home ?? homedir();
+  const xdg = env.XDG_CONFIG_HOME?.trim();
+  if (xdg)
+    return join(xdg, "opencode");
+  if (platform === "win32") {
+    const appdata = env.APPDATA?.trim();
+    if (appdata)
+      return join(appdata, "opencode");
+  }
+  return join(home, ".config", "opencode");
+}
 function getOpenCodeDirForScope(scope, cwd = process.cwd()) {
+  if (scope === "global")
+    return getGlobalOpenCodeDir();
   return join(findProjectRoot(cwd), ".opencode");
 }
 function ensureOpenCodePaths(opencodeDir) {
@@ -624,47 +641,47 @@ var init_fs = __esm(() => {
 var manifest_default;
 var init_manifest = __esm(() => {
   manifest_default = {
-    version: "0.9.6",
+    version: "0.10.0",
     repo: "JaimeHoracio/Ostacky",
-    tag: "v0.9.6",
+    tag: "v0.10.0",
     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.9.6: prune de skills obsoletas, lastHandoff, getAvailableTransitions, consecutiveFailures real, mem_session_summary automático al cierre.",
-        version: "0.9.6",
-        sha256: "29e435104f6915905a85e15ca768a339c3e5b0898fc923ae147afb7c4f20a716"
+        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.10.0: prune de skills obsoletas, lastHandoff, getAvailableTransitions, consecutiveFailures real, mem_session_summary automático al cierre.",
+        version: "0.10.0",
+        sha256: "d092ac75eb83f56354e5accf479ae6f0309253077b7071b2cd93bcc959f9dc63"
       }
     ],
     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.9.6: controller plugin como alma hard-gate, Context7 removido del stack.",
-        version: "0.9.6",
-        sha256: "88da074ab02bef60bcaebd1fed9592ea13f95d245850ec9f2467cf69a7f2fc4c"
+        description: "Instala el stack tecnológico del proyecto (CodeGraph, skills, OpenSpec, Engram, controller plugin). v0.10.0: controller plugin como alma hard-gate, Context7 removido del stack.",
+        version: "0.10.0",
+        sha256: "2ed68d2451bfad3c142c943ca8cb4dba86616e6be8ef89f9af3849bcdc5d41c3"
       },
       {
         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.9.6",
-        sha256: "fe0158478f2ca63b315037a85fc1632b77868532e319af6c7384285441767d64"
+        version: "0.10.0",
+        sha256: "f883f9ad96f7d75778631d5cc13d8a1a9c3e6ec41396bbce8ce13cff2e66fca2"
       }
     ],
     mcpServers: [
       {
         name: "ostacky-controller",
         file: "assets/mcp/ostacky-controller/",
-        description: "Máquina de estados persistida con @modelcontextprotocol/server SDK. v0.9.6: 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.9.6",
-        sha256: "6669c464c47a285a21f3eea6456487c92b725a40e7938ade5ecfff97e2537427"
+        description: "Máquina de estados persistida con @modelcontextprotocol/server SDK. v0.10.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.10.0",
+        sha256: "9e6647f1540c21063d32bc3e163a7c0a379bbc1859416c3e7f55af39f2dd8e4e"
       },
       {
         name: "openspec",
         file: "assets/mcp/openspec/",
         description: "MCP server local para OpenSpec - proposal, apply, archive, sync de cambios",
-        version: "0.9.6",
+        version: "0.10.0",
         sha256: "bdb283fe8ec2dfcba2ec4f38191f4039e58cd7ae12e44e66310783b42c827638"
       }
     ],
@@ -673,105 +690,105 @@ 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.9.6",
+        version: "0.10.0",
         sha256: "f1013a86a8f27914d85a716e23c7fd32db1786d93615e8b0834b13d184308549"
       },
       {
         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.9.6",
+        version: "0.10.0",
         sha256: "2158a6864c0912e868a9d720db7fd79441e6cc298e3320833d2527c9727c852e"
       },
       {
         name: "tdd",
         file: "assets/skills/tdd/SKILL.md",
         description: "Skill de test-driven development (Superpowers)",
-        version: "0.9.6",
+        version: "0.10.0",
         sha256: "f0ebfbbc43a8868d31a3fd2df37ae7f60fe8add09c6475862395a68269e5ff7f"
       },
       {
         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.9.6",
+        version: "0.10.0",
         sha256: "1a42d714a9a13faf05f0bf7b580e8d837c2e77a5633839542ccce603023419e8"
       },
       {
         name: "dispatching-parallel-agents",
         file: "assets/skills/dispatching-parallel-agents/SKILL.md",
         description: "Skill de dispatch paralelo de agentes (Superpowers)",
-        version: "0.9.6",
+        version: "0.10.0",
         sha256: "7e7b712ef742d5631e302e6a71583e2bbbd33094da9281abfb84b43505fc3ef1"
       },
       {
         name: "review",
         file: "assets/skills/review/SKILL.md",
         description: "Skill de revisión de código (Superpowers)",
-        version: "0.9.6",
+        version: "0.10.0",
         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.9.6",
+        version: "0.10.0",
         sha256: "d761e884e71d8d3476ac734d287cae403a4024506a7d12e7361a448217c0a831"
       },
       {
         name: "openspec-propose",
         file: "assets/skills/openspec-propose/SKILL.md",
         description: "Skill de generación de proposal (OpenSpec)",
-        version: "0.9.6",
+        version: "0.10.0",
         sha256: "6a517f750f24c008208156a2d653e97ed30b1e53878aeac5ce394e573db0678f"
       },
       {
         name: "openspec-apply-change",
         file: "assets/skills/openspec-apply-change/SKILL.md",
         description: "Skill de aplicación de change (OpenSpec)",
-        version: "0.9.6",
+        version: "0.10.0",
         sha256: "dfc823bf89fc7505e91ab6dee9c1f004be38a410bd3d88fb67b211b1b6cbb1d0"
       },
       {
         name: "openspec-archive-change",
         file: "assets/skills/openspec-archive-change/SKILL.md",
         description: "Skill de archivo de change (OpenSpec)",
-        version: "0.9.6",
+        version: "0.10.0",
         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.9.6",
+        version: "0.10.0",
         sha256: "9eafc3a8c693b8d9916867ef764d49e5222da717fde501c957bb3f6c312d2415"
       },
       {
         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.9.6",
+        version: "0.10.0",
         sha256: "93341bc1b7c053618a8b6dc07e3615b77990d7b549a0201f5835d95fef67ce13"
       },
       {
         name: "using-superpowers",
         file: "assets/skills/using-superpowers/SKILL.md",
         description: "Skill de orquestación de Superpowers skills",
-        version: "0.9.6",
+        version: "0.10.0",
         sha256: "7e54536f96d2a379185a10bfc1e970850caa2561b6d8aca7080f0defea0381a4"
       },
       {
         name: "writing-skills",
         file: "assets/skills/writing-skills/SKILL.md",
         description: "Skill de creación y edición de skills",
-        version: "0.9.6",
+        version: "0.10.0",
         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.9.6",
+        version: "0.10.0",
         sha256: "363449bd9e6f800a0a3168667cf78f767fb105d86e4a4adadcc649d418139303"
       }
     ]
@@ -1121,13 +1138,13 @@ var init_config = __esm(() => {
 
 // src/stack.ts
 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 resolve3 } from "path";
+import { basename as basename3, dirname as dirname5, join as join7, resolve as resolve3 } from "path";
 import { execFileSync as execFileSync3 } from "child_process";
 function resolveToolInstallLocation(toolsDir) {
   const resolvedToolsDir = resolve3(toolsDir ?? join7(findProjectRoot(), ".opencode", "tools"));
   const possibleOpenCodeDir = dirname5(resolvedToolsDir);
   return {
-    projectRoot: basename2(possibleOpenCodeDir) === ".opencode" ? dirname5(possibleOpenCodeDir) : findProjectRoot(),
+    projectRoot: basename3(possibleOpenCodeDir) === ".opencode" ? dirname5(possibleOpenCodeDir) : findProjectRoot(),
     toolsDir: resolvedToolsDir
   };
 }
@@ -1566,8 +1583,9 @@ function checkDoctorV2(projectRoot) {
   if (found) {
     try {
       const src = readFileSync6(found, "utf-8");
-      const isV2 = src.includes("Plugin.define") && src.includes("@opencode/plugin") && !src.includes("@opencode-ai/plugin");
-      if (isV2)
+      const hasDefault = /export\s+default/.test(src);
+      const hasLegacyPkg = src.includes("@opencode-ai/");
+      if (hasDefault && !hasLegacyPkg)
         lines.push(`✅ controller: plugin V2 (${found})`);
       else
         lines.push(`⚠️ controller: plugin legacy V1 en ${found} — no corre en V2, reinstalá con ostacky`);
@@ -1647,12 +1665,40 @@ function checkDoctorV2(projectRoot) {
   for (const [name, entry] of Object.entries(servers)) {
     if (!entry || typeof entry !== "object")
       continue;
-    const cmd = entry.command;
-    if (entry.type === "local" && Array.isArray(cmd) && typeof cmd[0] === "string") {
-      const bin = cmd[0];
-      const ok = isAbsolute(bin) ? existsSync8(bin) : lookupOnPath(bin) !== null;
-      if (!ok)
-        lines.push(`⚠️ mcp.servers.${name} command no existe (${bin}) — ¿proyecto movido? re-corré install`);
+    const e = entry;
+    if (e.type !== "local" && e.type !== "remote") {
+      lines.push(`⚠️ mcp.servers.${name} sin type local|remote — V2 lo requiere (ver mcp-servers)`);
+      continue;
+    }
+    if ("enabled" in e) {
+      lines.push(`⚠️ mcp.servers.${name} usa enabled (forma V1) — V2 usa disabled invertido`);
+    }
+    if (typeof e.timeout === "number") {
+      lines.push(`⚠️ mcp.servers.${name} timeout numérico (forma V1) — V2 usa timeout: { catalog, execution }`);
+    }
+    if (e.type === "local") {
+      const cmd = e.command;
+      if (!Array.isArray(cmd) || typeof cmd[0] !== "string") {
+        lines.push(`⚠️ mcp.servers.${name} local sin command array — V2 requiere command: [bin, ...args]`);
+      } else {
+        const bin = cmd[0];
+        const ok = isAbsolute(bin) ? existsSync8(bin) : lookupOnPath(bin) !== null;
+        if (!ok)
+          lines.push(`⚠️ mcp.servers.${name} command no existe (${bin}) — ¿proyecto movido? re-corré install`);
+      }
+    } else {
+      if (typeof e.url !== "string" || !/^https?:\/\//.test(e.url)) {
+        lines.push(`⚠️ mcp.servers.${name} remote sin url absoluta — V2 requiere url https://...`);
+      }
+      const oauth = e.oauth;
+      if (oauth && typeof oauth === "object") {
+        for (const k of ["clientId", "clientSecret", "callbackPort", "redirectUri"]) {
+          if (k in oauth) {
+            lines.push(`⚠️ mcp.servers.${name} oauth.${k} camelCase (forma V1) — V2 usa snake_case`);
+            break;
+          }
+        }
+      }
     }
   }
   return lines;
@@ -1681,7 +1727,7 @@ var init_doctor_v2 = __esm(() => {
 // package.json
 var package_default = {
   name: "ostacky",
-  version: "0.9.6",
+  version: "0.10.0",
   description: "Instalador interactivo de agentes y comandos para OpenCode",
   type: "module",
   bin: {
@@ -2702,7 +2748,7 @@ import {
   rmSync as rmSync3
 } from "fs";
 import { execFileSync as execFileSync2, spawn } from "child_process";
-import { dirname as dirname4, join as join6 } from "path";
+import { dirname as dirname4, join as join6, basename as basename2 } from "path";
 import { pathToFileURL } from "url";
 function createMcpConfigEntry(name, nodeExecutable, serverPath, statePath) {
   const entry = {
@@ -2860,20 +2906,25 @@ async function probeMcpServer(nodeExecutable, serverPath, cwd, statePath, option
         params: {
           protocolVersion: "2025-03-26",
           capabilities: {},
-          clientInfo: { name: "ostacky-installer", version: "0.9.6" }
+          clientInfo: { name: "ostacky-installer", version: "0.10.0" }
         }
       });
     });
   } finally {
     await new Promise((r) => setTimeout(r, 200));
     if (statePath) {
-      for (const p of [
+      const probeDir = dirname4(statePath);
+      const probeBase = basename2(statePath);
+      const probePrefix = probeBase + ".";
+      for (const p of readdirSync2(probeDir).filter((entry) => entry === probeBase || entry.startsWith(probePrefix)).map((entry) => join6(probeDir, entry)).concat([
         statePath,
         statePath + ".backup",
+        statePath + ".backup.1",
+        statePath + ".backup.2",
         statePath + ".lock.pid",
         statePath + ".lock.timestamp",
         statePath + ".tmp." + process.pid
-      ]) {
+      ])) {
         try {
           if (existsSync5(p))
             rmSync3(p, { force: true });
@@ -3021,7 +3072,8 @@ async function installMcpServer(item, manifest, paths) {
   const treeHash = computeTreeHash(src);
   assertBundledTreeHash("mcpServers", item.name, treeHash);
   const nodeExecutable = getVerifiedNodeExecutable();
-  const projectRoot = dirname4(paths.root);
+  await Promise.resolve().then(() => init_fs());
+  const projectRoot = paths.root === getGlobalOpenCodeDir() ? paths.root : dirname4(paths.root);
   const dest = join6(paths.mcp, item.name);
   const staging = `${dest}.staging-${process.pid}-${Date.now()}`;
   const statePath = item.name === "ostacky-controller" ? join6(paths.root, "ostacky-state.json") : undefined;
@@ -3269,11 +3321,23 @@ function printPostInstallSteps() {
 `), "Próximos pasos");
 }
 async function resolveOpenCodePaths(scope, opts) {
+  const effective = scope ?? "local";
+  if (effective === "global") {
+    await Promise.resolve().then(() => init_fs());
+    const dir = getGlobalOpenCodeDir();
+    try {
+      const paths = ensureOpenCodePaths(dir);
+      ye(dir, "Instalación global");
+      return paths;
+    } catch (e) {
+      throw e;
+    }
+  }
   const cwd = process.cwd();
   const base = opts?.gitPreflight ? (await runGitPreflight(cwd)).projectRoot : cwd;
   const dir = getOpenCodeDirForScope("local", base);
-  if (scope && scope !== "local") {
-    v2.warn(`Scope ${scope} removido; usando local en ${dir}`);
+  if (scope && scope !== "local" && scope !== "global") {
+    v2.warn(`Scope ${scope} no soportado; usando local en ${dir}`);
   }
   try {
     const paths = ensureOpenCodePaths(dir);
@@ -3366,6 +3430,15 @@ async function doInstallStack(toolsDir, projectRoot) {
   let allOk = true;
   const resolvedProjectRoot = projectRoot ?? dirname6(dirname6(toolsDir ?? join8(process.cwd(), ".opencode", "tools")));
   const resolvedToolsDir = toolsDir ?? join8(resolvedProjectRoot, ".opencode", "tools");
+  try {
+    await Promise.resolve().then(() => init_fs());
+    const globalDir = getGlobalOpenCodeDir().replace(/\\/g, "/").toLowerCase();
+    const toolsNorm = resolvedToolsDir.replace(/\\/g, "/").toLowerCase();
+    if (toolsNorm === globalDir || toolsNorm.startsWith(globalDir + "/")) {
+      v2.warn("Scope global: el stack (CodeGraph/Engram) es siempre local por proyecto — omitido aquí. Instalalo por proyecto con `npx ostacky install-stack --scope local`.");
+      return true;
+    }
+  } catch {}
   v2.info(`Stack → projectRoot: ${resolvedProjectRoot} | toolsDir: ${resolvedToolsDir}`);
   try {
     const { homedir } = await import("os");
@@ -3411,8 +3484,11 @@ async function doInstallStack(toolsDir, projectRoot) {
 async function doInstallAll(manifest, paths, opts) {
   const spin = L2();
   let errors = 0;
-  v2.info(`Scope → local | opencodeDir: ${paths.root} | tools: ${paths.tools}`);
-  if (!opts?.noStack) {
+  const isGlobal = opts?.scope === "global";
+  v2.info(`Scope → ${isGlobal ? "global" : "local"} | opencodeDir: ${paths.root} | tools: ${paths.tools}`);
+  if (isGlobal) {
+    v2.info("Scope global: núcleo (agente/commands/skills/MCPs/plugins) en dir global; el stack (CodeGraph/Engram) es siempre local por proyecto — omitido aquí. Instalalo por proyecto con `npx ostacky install-stack --scope local`.");
+  } else if (!opts?.noStack) {
     ensureToolDirs(paths.tools, ["codegraph", "engram"]);
   }
   for (const agent of manifest.agents) {
@@ -3490,7 +3566,9 @@ async function doInstallAll(manifest, paths, opts) {
   } catch {}
   let stackOk = true;
   let missingTools = [];
-  if (opts?.noStack) {
+  if (isGlobal) {
+    v2.info("Scope global: stack omitido (siempre local por proyecto).");
+  } else if (opts?.noStack) {
     v2.info("Stack omitido (--no-stack): solo núcleo (agente/commands/skills/MCPs/plugins).");
   } else {
     v2.info("Instalando stack de herramientas...");
@@ -3500,7 +3578,7 @@ async function doInstallAll(manifest, paths, opts) {
   }
   const codegraphDir = join8(paths.tools, "codegraph");
   const engramDir = join8(paths.tools, "engram");
-  if (!opts?.noStack) {
+  if (!isGlobal && !opts?.noStack) {
     if (!existsSync7(codegraphDir) || !findBinaryInDir(codegraphDir, "codegraph"))
       missingTools.push("CodeGraph");
     if (!existsSync7(engramDir) || !findBinaryInDir(engramDir, "engram"))
@@ -3523,12 +3601,14 @@ async function doInstallAll(manifest, paths, opts) {
       v2.warn("Además el stack quedó parcial: reintentá con `npx ostacky install-stack --scope local`.");
   }
   try {
-    const projectRoot = dirname6(paths.root);
-    const gi = ensureGitignore(projectRoot);
-    if (gi.created)
-      v2.info(`.gitignore creado con patrones Ostacky`);
-    else if (gi.updated)
-      v2.info(`.gitignore actualizado: ${gi.patternsAdded.join(", ")}`);
+    if (!isGlobal) {
+      const projectRoot = dirname6(paths.root);
+      const gi = ensureGitignore(projectRoot);
+      if (gi.created)
+        v2.info(`.gitignore creado con patrones Ostacky`);
+      else if (gi.updated)
+        v2.info(`.gitignore actualizado: ${gi.patternsAdded.join(", ")}`);
+    }
   } catch {}
   return coreOk && !stackPartial;
 }
@@ -4177,7 +4257,7 @@ async function runInteractiveMenu(scope) {
   we(" OpenCode Installer ");
   await ensureOpencodeInstalled();
   const manifest = await loadManifest();
-  const paths = await resolveOpenCodePaths(scope ?? null, { gitPreflight: true });
+  const paths = await resolveOpenCodePaths(scope ?? null, { gitPreflight: scope !== "global" });
   if (!paths) {
     fe("Instalación cancelada.");
     return;
@@ -4199,7 +4279,7 @@ async function runInteractiveMenu(scope) {
   onCancel(action);
   switch (action) {
     case "all":
-      if (!await doInstallAll(manifest, paths))
+      if (!await doInstallAll(manifest, paths, { scope: scope ?? "local" }))
         process.exitCode = 1;
       printPostInstallSteps();
       fe(process.exitCode ? "Instalación parcial." : "Listo.");
@@ -4225,6 +4305,11 @@ async function runInteractiveMenu(scope) {
       fe("Listo.");
       break;
     case "stack": {
+      if ((scope ?? "local") === "global") {
+        v2.warn("El stack (CodeGraph/Engram) es siempre local por proyecto. En scope global se omite; usá `npx ostacky install-stack --scope local` dentro del proyecto.");
+        fe("Listo.");
+        break;
+      }
       ensureToolDirs(paths.tools, ["codegraph", "engram"]);
       const stackOk = await doInstallStack(paths.tools, dirname7(paths.root));
       if (!stackOk)
@@ -4251,12 +4336,12 @@ async function runInstallCommand(scope, opts) {
   we(" OpenCode Installer ");
   await ensureOpencodeInstalled();
   const manifest = await loadManifest();
-  const paths = await resolveOpenCodePaths(scope ?? null, { gitPreflight: true });
+  const paths = await resolveOpenCodePaths(scope ?? null, { gitPreflight: scope !== "global" });
   if (!paths) {
     fe("Cancelado.");
     return;
   }
-  if (!await doInstallAll(manifest, paths, opts))
+  if (!await doInstallAll(manifest, paths, { ...opts, scope: scope ?? "local" }))
     process.exitCode = 1;
   printPostInstallSteps();
   fe(process.exitCode ? "Instalación parcial." : "Instalación completada.");
@@ -4515,59 +4600,142 @@ async function runUninstallMcpCommand(name, scope) {
 }
 
 // src/cli.ts
-init_fs();
 import { existsSync as existsSync9, statSync as statSync3, readFileSync as readFileSync7, readdirSync as readdirSync4 } from "node:fs";
 import { join as join11, dirname as dirname8 } from "node:path";
+import { spawnSync } from "node:child_process";
+init_fs();
+
+// src/version-check.ts
+function parseMajor(version) {
+  if (!version)
+    return null;
+  const m = /v?(\d+)\.\d+\.\d+/.exec(version.trim());
+  if (!m)
+    return null;
+  const major = parseInt(m[1], 10);
+  return Number.isNaN(major) ? null : major;
+}
+function compareVersions(a, b) {
+  const pa = a.replace(/^v/, "").split(".").map((n) => parseInt(n, 10) || 0);
+  const pb = b.replace(/^v/, "").split(".").map((n) => parseInt(n, 10) || 0);
+  for (let i = 0;i < 3; i++) {
+    if ((pa[i] ?? 0) < (pb[i] ?? 0))
+      return -1;
+    if ((pa[i] ?? 0) > (pb[i] ?? 0))
+      return 1;
+  }
+  return 0;
+}
+async function fetchLatestNpmVersion(pkg = "ostacky", timeoutMs = 5000) {
+  try {
+    const res = await fetch(`https://registry.npmjs.org/${pkg}/latest`, {
+      signal: AbortSignal.timeout(timeoutMs),
+      headers: { "User-Agent": "ostacky-installer" }
+    });
+    if (!res.ok)
+      return null;
+    const data = await res.json();
+    return typeof data.version === "string" ? data.version : null;
+  } catch {
+    return null;
+  }
+}
+function decideOffer(installed, latest) {
+  if (!latest || compareVersions(installed, latest) >= 0) {
+    return { kind: "none", installed, latest };
+  }
+  if (parseMajor(installed) === 1) {
+    return { kind: "migrate-v1", installed, latest };
+  }
+  return { kind: "update-available", installed, latest };
+}
+function canPrompt(argv = process.argv, isTTY = process.stdin.isTTY === true) {
+  if (!isTTY)
+    return false;
+  return !argv.includes("--yes") && !argv.includes("--no-interactive") && !argv.includes("--non-interactive");
+}
+
+// src/cli.ts
+async function maybeOfferUpdateOrMigrate(installed, scope) {
+  const latest = await fetchLatestNpmVersion();
+  const offer = decideOffer(installed, latest);
+  if (offer.kind === "none" || !offer.latest)
+    return;
+  if (!canPrompt()) {
+    console.error(`Hay una versión más nueva de ostacky: ${offer.latest} (instalada: ${installed}). Re-ejecutá con npx ostacky@latest.`);
+    return;
+  }
+  if (offer.kind === "migrate-v1") {
+    const confirm = await me({
+      message: `Tenés Ostacky v1 instalada (${installed}) y la última es ${offer.latest} (v2). ¿Desinstalar v1 e instalar v2? (los artefactos legacy se limpian automáticamente)${scope === "global" ? " (scope global)" : ""}`,
+      initialValue: true
+    });
+    if (BD(confirm) || !confirm)
+      return;
+  } else {
+    const confirm = await me({
+      message: `Hay una versión más nueva de ostacky: ${offer.latest} (instalada: ${installed}). ¿Actualizar y re-ejecutar con @latest?`,
+      initialValue: true
+    });
+    if (BD(confirm) || !confirm)
+      return;
+  }
+  const userArgs = process.argv.slice(2);
+  const invocation = getCommandInvocation("npx", ["ostacky@latest", ...userArgs]);
+  const res = spawnSync(invocation.command, invocation.args, { stdio: "inherit" });
+  process.exit(res.status ?? 0);
+}
 var HELP = `
 ostacky — Instalador de agentes, comandos, skills y MCPs para OpenCode
 
 Uso:
-  npx ostacky [--scope local]                    Menú interactivo (instalación completa, siempre local)
-  npx ostacky install [--scope local] [--no-stack]  Instalar TODO (agente + skills + MCPs + CodeGraph + OpenSpec + Engram; --no-stack omite el stack)
-  npx ostacky add agent [--scope local]          Agregar agente(s)
-  npx ostacky add command [--scope local]        Agregar command(s)
-  npx ostacky add skill [--scope local]          Agregar skill(s)
-  npx ostacky add mcp [--scope local]            Agregar MCP server(s)
-  npx ostacky install-stack [--scope local]      Instalar solo el stack de herramientas (CodeGraph, OpenSpec, Engram)
+  npx ostacky [--scope local|global]             Menú interactivo (default: local en <proyecto>/.opencode)
+  npx ostacky install [--scope local|global] [--no-stack]  Instalar TODO (agente + skills + MCPs + CodeGraph + OpenSpec + Engram; --no-stack omite el stack)
+  npx ostacky add agent [--scope local|global]   Agregar agente(s)
+  npx ostacky add command [--scope local|global] Agregar command(s)
+  npx ostacky add skill [--scope local|global]   Agregar skill(s)
+  npx ostacky add mcp [--scope local|global]     Agregar MCP server(s)
+  npx ostacky install-stack [--scope local]      Instalar solo el stack de herramientas (CodeGraph, OpenSpec, Engram — siempre local por proyecto)
   npx ostacky uninstall-stack [--scope local]    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 local]             Actualizar instalación
-  npx ostacky uninstall [--scope local]          Desinstalar todo
-  npx ostacky uninstall agent [--scope local]    Desinstalar agente(s)
-  npx ostacky uninstall command [--scope local]  Desinstalar command(s)
-  npx ostacky uninstall skill [--scope local]    Desinstalar skill(s)
-  npx ostacky uninstall mcp [--scope local]      Desinstalar MCP server(s)
+  npx ostacky update [--scope local|global]      Actualizar instalación
+  npx ostacky uninstall [--scope local|global]   Desinstalar todo
+  npx ostacky uninstall agent [--scope local|global]    Desinstalar agente(s)
+  npx ostacky uninstall command [--scope local|global]  Desinstalar command(s)
+  npx ostacky uninstall skill [--scope local|global]    Desinstalar skill(s)
+  npx ostacky uninstall mcp [--scope local|global]      Desinstalar MCP server(s)
   npx ostacky --help             Mostrar esta ayuda
   npx ostacky --version          Mostrar versión
 
 Scope:
-  --scope local   Escribe en <proyecto>/.opencode (siempre local, instalador único)
-  Sin flag        Asume local implícito (no pregunta global)
+  --scope local    Escribe en <proyecto>/.opencode (default; no pregunta global)
+  --scope global   Escribe en el config dir global de OpenCode (~/.config/opencode, respeta XDG_CONFIG_HOME)
+  Sin flag         Asume local implícito
 `.trim();
 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 v = argv[i + 1];
-      if (v === "local")
+      if (v === "local" || v === "global")
         return v;
-      if (v === "global" || v === "auto") {
-        console.error(`Error: --scope ${v} removido; Ostacky instala siempre local en <proyecto>/.opencode. Hacé cd al proyecto y re-ejecutá con --scope local.`);
+      if (v === "auto") {
+        console.error(`Error: --scope auto removido; usá --scope local o --scope global explícito.`);
         process.exit(1);
       }
     }
     if (arg.startsWith("--scope=")) {
       const v = arg.split("=")[1];
-      if (v === "local")
+      if (v === "local" || v === "global")
         return v;
-      if (v === "global" || v === "auto") {
-        console.error(`Error: --scope ${v} removido; Ostacky instala siempre local en <proyecto>/.opencode. Hacé cd al proyecto y re-ejecutá con --scope local.`);
+      if (v === "auto") {
+        console.error(`Error: --scope auto removido; usá --scope local o --scope global explícito.`);
         process.exit(1);
       }
     }
     if (arg === "-g") {
-      console.error(`Error: -g/global removido; Ostacky instala siempre local en <proyecto>/.opencode. Hacé cd al proyecto y re-ejecutá sin -g.`);
+      console.error(`Error: -g removido; usá --scope global (instalación global) o --scope local (default por proyecto).`);
       process.exit(1);
     }
   }
@@ -4928,10 +5096,16 @@ async function main() {
       await runInstallCommand(scope, { noStack });
       break;
     case "install-stack":
-      await runInstallStackCommand(scope);
+      if (scope === "global") {
+        console.error(`Aviso: el stack (CodeGraph/Engram) se instala siempre local por proyecto. Ignorando --scope global y usando local.`);
+      }
+      await runInstallStackCommand(null);
       break;
     case "uninstall-stack":
-      await runUninstallStackCommand(scope);
+      if (scope === "global") {
+        console.error(`Aviso: el stack es siempre local por proyecto. Ignorando --scope global y usando local.`);
+      }
+      await runUninstallStackCommand(null);
       break;
     case "add":
       if (subcmd === "agent") {
@@ -4989,6 +5163,7 @@ async function main() {
         console.error(`Comando desconocido: "${cmd}". Usá --help para ver los comandos disponibles.`);
         process.exit(1);
       }
+      await maybeOfferUpdateOrMigrate(package_default.version, scope);
       await runInteractiveMenu(scope);
   }
 }