ostacky 0.9.7 → 0.10.1

package/assets/skills/execution-mode-evaluation/SKILL.md

@@ -25,14 +25,13 @@ Determinar el modo de ejecución óptimo entre **inline** y **subagent-driven**
 
 ## Procedimiento
 
-### Paso 0: Verificar discovery-cache primero (ÚNICO entrypoint)
-
-**SHALL** llamar `src/discovery-cache.ts` `getDiscoverySnapshot(query)` y `getEngramDedup(query, requestId)` antes de cualquier `codegraph_codegraph_explore` o `engram_mem_search`. Si hit válido (TTL+gitDiffHash) → **reusar** `codegraph+engramHits` para construir `sharedFiles/fileClusters`; solo `codegraph_impact` para símbolos no cubiertos. Si miss o área difiere >30% → fetch fresco y `putDiscoverySnapshot`. Segunda llamada misma query en mismo `requestId` SHALL ser dedup (no `redundantCallCount`).
-
-### Paso 0.1: Consultar Engram por decisiones previas (solo si no hay dedup hit)
-
-Si `getEngramDedup` fue miss, `engram_mem_search` con keywords del cambio. Si existe decisión previa, usar como referencia no vinculante.
-
+### Paso 0: Reusar el discovery ya obtenido en este request
+
+Si en este mismo request ya llamaste `codegraph_codegraph_explore` para el área, **reusá ese output** (sigue en tu contexto) para construir `sharedFiles/fileClusters`; solo `codegraph_impact` para símbolos no cubiertos. Si el área difiere materialmente (overlap <30%) o todavía no hiciste discovery → `codegraph_codegraph_explore` fresco. No hay cache de archivo: no repitas la misma query sin motivo.
+
+### Paso 0.1: Consultar Engram por decisiones previas
+
+`engram_mem_search` con keywords del cambio, salvo que ya lo hayas hecho para el mismo tema en este request. Si existe decisión previa, usarla como referencia no vinculante.
 ### Paso 0.5: Early exit para cambios pequeños
 
 Si el change tiene **≤2 tasks** Y **no comparten archivos entre sí** → devolver directamente:
@@ -48,10 +47,10 @@ Si el change tiene **≤2 tasks** Y **no comparten archivos entre sí** → devo
 }
 ```
 
-### Paso 1: Obtener datos de CodeGraph (solo si discovery-cache miss)
-
-Si Paso 0 fue hit → **SKIP este paso**, derivar `fileClusters/sharedFiles` del snapshot (`state.snapshots.codegraph` + `tasks.md`). Snapshot resultante SHALL usar `codegraphUsed:["discovery-cache"]` (válido, no genera `WARN:execution_without_codegraph` si `snapshots.codegraph` existe) y `reuseDiscovery:true`.
-Si miss:
+### Paso 1: Obtener datos de CodeGraph (solo si no hiciste discovery en este request)
+
+Si ya hay discovery en contexto → **SKIP este paso**; derivar `fileClusters/sharedFiles` del output (`state.snapshots.codegraph` + `tasks.md`) con `codegraphUsed:["codegraph_explore"]` y `reuseDiscovery:true`.
+Si no:
 ```
 codegraph_codegraph_explore con query: "<área del cambio>"
 ```

package/assets/skills/openspec-propose/SKILL.md

@@ -26,9 +26,9 @@ When ready to implement, run /opsx-apply
 
 **Steps**
 
-0. **Ground with CodeGraph + Engram (SHALL — Ostacky)** — Antes de `openspec new`, verifica `getDiscoverySnapshot(query)` + `getEngramDedup`. Si miss → `codegraph_codegraph_explore` + `engram_mem_search` + `putDiscoverySnapshot`. Cita símbolos existentes en `proposal/design`; sin esto el `design.md` puede alucinar API inexistente y dispara `WARN:codegraphBypass` en `doctor`.
+0. **Ground with CodeGraph + Engram (SHALL — Ostacky)** — Antes de `openspec new`, usá `codegraph_codegraph_explore` + `engram_mem_search` sobre el área (si no los hiciste ya en este request). Citá símbolos existentes en `proposal/design`; sin esto el `design.md` puede alucinar API inexistente y dispara `WARN:codegraphBypass` en `doctor`.
 
-1. **Check Engram for similar changes** — `engram_mem_search` con keywords del *paso 0* (reusar si ya fue hit; no duplicar `mem_search` mismo `requestId`). Si hay change similar previo, surfacealo. Pueden extender trabajo existente en vez de empezar de cero.
+1. **Check Engram for similar changes** — `engram_mem_search` con keywords del *paso 0* (no repetir la misma query en el mismo request). Si hay change similar previo, surfacealo. Pueden extender trabajo existente en vez de empezar de cero.
 
 2. **If no clear input provided, ask what they want to build**
 

package/assets/skills/tdd/SKILL.md

@@ -28,7 +28,7 @@ Write the test first. Watch it fail. Write minimal code to pass.
 
 Thinking "skip TDD just this once"? Stop. That's rationalization.
 
-> **Ostacky ground (SHALL):** Antes de RED, verifica `getDiscoverySnapshot(query)` + `getEngramDedup`. Si hit → reusar símbolos/decisiones; si miss → `codegraph_codegraph_explore` + `engram_mem_search` + `putDiscoverySnapshot`. Evita testear API inexistente y respeta `discovery-cache (único)` de `ostacky.md §1`. Ver `execution-mode-evaluation` para cache TTL.
+> **Ostacky ground (SHALL):** Antes de RED, verificá el área con `codegraph_codegraph_explore` + `engram_mem_search` (si no los hiciste ya en este request). Citá símbolos existentes para no testear API inexistente. Ver `execution-mode-evaluation`.
 
 ## The Iron Law
 

package/dist/cli.js

@@ -641,31 +641,31 @@ var init_fs = __esm(() => {
 var manifest_default;
 var init_manifest = __esm(() => {
   manifest_default = {
-    version: "0.9.7",
+    version: "0.10.1",
     repo: "JaimeHoracio/Ostacky",
-    tag: "v0.9.7",
+    tag: "v0.10.1",
     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.7: prune de skills obsoletas, lastHandoff, getAvailableTransitions, consecutiveFailures real, mem_session_summary automático al cierre.",
-        version: "0.9.7",
-        sha256: "4481017881dadef3cabf516053d13930b5c948f879f8996fcb03ca5133073199"
+        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.1: prune de skills obsoletas, lastHandoff, getAvailableTransitions, consecutiveFailures real, mem_session_summary automático al cierre.",
+        version: "0.10.1",
+        sha256: "f82687e38d1ad2e88cce1e962299c9bd8b9265d53fe3c7997114efddb39898b3"
       }
     ],
     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.7: controller plugin como alma hard-gate, Context7 removido del stack.",
-        version: "0.9.7",
-        sha256: "0e1f52a236843fffbf166c1b381c52907abe19887e2472f667642ecbcb0f43a8"
+        description: "Instala el stack tecnológico del proyecto (CodeGraph, skills, OpenSpec, Engram, controller plugin). v0.10.1: controller plugin como alma hard-gate, Context7 removido del stack.",
+        version: "0.10.1",
+        sha256: "07e70cbaec57e27b5984e4a693486e34a8f52585b1183da7dd88c5dd69c7c8d5"
       },
       {
         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.7",
+        version: "0.10.1",
         sha256: "f883f9ad96f7d75778631d5cc13d8a1a9c3e6ec41396bbce8ce13cff2e66fca2"
       }
     ],
@@ -673,15 +673,15 @@ var init_manifest = __esm(() => {
       {
         name: "ostacky-controller",
         file: "assets/mcp/ostacky-controller/",
-        description: "Máquina de estados persistida con @modelcontextprotocol/server SDK. v0.9.7: 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.7",
-        sha256: "41bfad0ddf21fac992c72e2a4e590445d075a5f8e8cb30a165728dff23a5d41a"
+        description: "Máquina de estados persistida con @modelcontextprotocol/server SDK. v0.10.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.10.1",
+        sha256: "d10efacd03f72f5fa1cca0abb22046a9862de7e98f635308f6898c5cbd67407e"
       },
       {
         name: "openspec",
         file: "assets/mcp/openspec/",
         description: "MCP server local para OpenSpec - proposal, apply, archive, sync de cambios",
-        version: "0.9.7",
+        version: "0.10.1",
         sha256: "bdb283fe8ec2dfcba2ec4f38191f4039e58cd7ae12e44e66310783b42c827638"
       }
     ],
@@ -690,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.7",
-        sha256: "f1013a86a8f27914d85a716e23c7fd32db1786d93615e8b0834b13d184308549"
+        version: "0.10.1",
+        sha256: "ba76eff6fb5bea08d3b26622089ea4739b7b542b3677a46071b2576f3f2001c7"
       },
       {
         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.7",
-        sha256: "2158a6864c0912e868a9d720db7fd79441e6cc298e3320833d2527c9727c852e"
+        version: "0.10.1",
+        sha256: "9090132ccfe31dcf34b6d5f399c1135dcb1044c504d4beb026e0c7d9e09e7c0d"
       },
       {
         name: "tdd",
         file: "assets/skills/tdd/SKILL.md",
         description: "Skill de test-driven development (Superpowers)",
-        version: "0.9.7",
-        sha256: "f0ebfbbc43a8868d31a3fd2df37ae7f60fe8add09c6475862395a68269e5ff7f"
+        version: "0.10.1",
+        sha256: "cce54e81cce46ba973066f9b43e74994a7dbf21aa756146c27689241cf62704d"
       },
       {
         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.7",
+        version: "0.10.1",
         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.7",
+        version: "0.10.1",
         sha256: "7e7b712ef742d5631e302e6a71583e2bbbd33094da9281abfb84b43505fc3ef1"
       },
       {
         name: "review",
         file: "assets/skills/review/SKILL.md",
         description: "Skill de revisión de código (Superpowers)",
-        version: "0.9.7",
+        version: "0.10.1",
         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.7",
+        version: "0.10.1",
         sha256: "d761e884e71d8d3476ac734d287cae403a4024506a7d12e7361a448217c0a831"
       },
       {
         name: "openspec-propose",
         file: "assets/skills/openspec-propose/SKILL.md",
         description: "Skill de generación de proposal (OpenSpec)",
-        version: "0.9.7",
-        sha256: "6a517f750f24c008208156a2d653e97ed30b1e53878aeac5ce394e573db0678f"
+        version: "0.10.1",
+        sha256: "9049b944cea88a5428fd5d77b411a0ed32d169ad68acda911b68365fac08f38f"
       },
       {
         name: "openspec-apply-change",
         file: "assets/skills/openspec-apply-change/SKILL.md",
         description: "Skill de aplicación de change (OpenSpec)",
-        version: "0.9.7",
+        version: "0.10.1",
         sha256: "dfc823bf89fc7505e91ab6dee9c1f004be38a410bd3d88fb67b211b1b6cbb1d0"
       },
       {
         name: "openspec-archive-change",
         file: "assets/skills/openspec-archive-change/SKILL.md",
         description: "Skill de archivo de change (OpenSpec)",
-        version: "0.9.7",
+        version: "0.10.1",
         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.7",
+        version: "0.10.1",
         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.7",
+        version: "0.10.1",
         sha256: "93341bc1b7c053618a8b6dc07e3615b77990d7b549a0201f5835d95fef67ce13"
       },
       {
         name: "using-superpowers",
         file: "assets/skills/using-superpowers/SKILL.md",
         description: "Skill de orquestación de Superpowers skills",
-        version: "0.9.7",
+        version: "0.10.1",
         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.7",
+        version: "0.10.1",
         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.7",
+        version: "0.10.1",
         sha256: "363449bd9e6f800a0a3168667cf78f767fb105d86e4a4adadcc649d418139303"
       }
     ]
@@ -1046,11 +1046,19 @@ function readOpenCodeConfig(configPath) {
     return null;
   }
 }
-function writeOpenCodeConfig(configPath, config) {
+function writeOpenCodeConfig(configPath, config, options = {}) {
+  const next = JSON.stringify(config, null, 2) + `
+`;
+  try {
+    if (options.backup !== false && existsSync4(configPath)) {
+      const prev = readFileSync4(configPath, "utf-8");
+      if (prev !== next)
+        writeFileSync4(`${configPath}.bak`, prev, "utf-8");
+    }
+  } catch {}
   const tmpPath = `${configPath}.tmp.${process.pid}.${Date.now()}`;
   try {
-    writeFileSync4(tmpPath, JSON.stringify(config, null, 2) + `
-`, "utf-8");
+    writeFileSync4(tmpPath, next, "utf-8");
     renameSync2(tmpPath, configPath);
   } finally {
     if (existsSync4(tmpPath))
@@ -1060,13 +1068,13 @@ function writeOpenCodeConfig(configPath, config) {
 function ensureOpenCodeConfig(projectRoot) {
   const existing = findOpenCodeConfig(projectRoot);
   if (existing)
-    return existing;
+    return { path: existing, created: false };
   const configPath = join5(projectRoot, "opencode.json");
   writeOpenCodeConfig(configPath, {
     $schema: "https://opencode.ai/config.json",
     mcp: {}
-  });
-  return configPath;
+  }, { backup: false });
+  return { path: configPath, created: true };
 }
 function findOpenCodeConfig(projectRoot) {
   const candidates = ["opencode.json", "opencode.jsonc"];
@@ -1078,7 +1086,7 @@ function findOpenCodeConfig(projectRoot) {
   return null;
 }
 function setMcpEntryAtProjectRoot(projectRoot, name, entry) {
-  const configPath = ensureOpenCodeConfig(projectRoot);
+  const { path: configPath, created } = ensureOpenCodeConfig(projectRoot);
   const config = readOpenCodeConfig(configPath);
   if (!config)
     throw new Error(`Error parseando ${configPath}`);
@@ -1090,7 +1098,7 @@ function setMcpEntryAtProjectRoot(projectRoot, name, entry) {
   mcp.servers[name] = entry;
   if (name in mcp && name !== "servers")
     delete mcp[name];
-  writeOpenCodeConfig(configPath, config);
+  writeOpenCodeConfig(configPath, config, { backup: !created });
 }
 function patchOpenCodeConfig(projectRoot = findProjectRoot()) {
   const configPath = findOpenCodeConfig(projectRoot);
@@ -1138,13 +1146,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
   };
 }
@@ -1727,7 +1735,7 @@ var init_doctor_v2 = __esm(() => {
 // package.json
 var package_default = {
   name: "ostacky",
-  version: "0.9.7",
+  version: "0.10.1",
   description: "Instalador interactivo de agentes y comandos para OpenCode",
   type: "module",
   bin: {
@@ -2748,7 +2756,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 = {
@@ -2906,20 +2914,25 @@ async function probeMcpServer(nodeExecutable, serverPath, cwd, statePath, option
         params: {
           protocolVersion: "2025-03-26",
           capabilities: {},
-          clientInfo: { name: "ostacky-installer", version: "0.9.7" }
+          clientInfo: { name: "ostacky-installer", version: "0.10.1" }
         }
       });
     });
   } 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 });
@@ -3425,6 +3438,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");
@@ -4133,25 +4155,25 @@ function getOpencodeVersion() {
 function getOpencodeInstallCommand(platform = process.platform, _arch = process.arch) {
   if (platform === "win32") {
     return {
-      display: "npm install -g opencode-ai",
+      display: "npm install -g @opencode/cli",
       command: "npm",
-      args: ["install", "-g", "opencode-ai"],
-      note: "Alternativas Windows: choco install opencode | scoop install opencode | mise use -g github:anomalyco/opencode (ver https://opencode.ai/download). WSL recomendado."
+      args: ["install", "-g", "@opencode/cli"],
+      note: "Alternativas Windows: binario suelto desde https://opencode.ai/download | WSL recomendado (OpenCode no soporta package managers de Windows)."
     };
   }
   if (platform === "darwin") {
     return {
-      display: "curl -fsSL https://opencode.ai/install | bash",
+      display: "curl -fsSL https://opencode.ai/v2/install | bash",
       command: "bash",
-      args: ["-c", "curl -fsSL https://opencode.ai/install | bash"],
-      note: "Alternativa macOS: brew install anomalyco/tap/opencode (tap oficial, más actualizado que brew install opencode)"
+      args: ["-c", "curl -fsSL https://opencode.ai/v2/install | bash"],
+      note: "Alternativa macOS: brew install anomalyco/tap/opencode-v2 (tap oficial) | npm install -g @opencode/cli"
     };
   }
   return {
-    display: "curl -fsSL https://opencode.ai/install | bash",
+    display: "curl -fsSL https://opencode.ai/v2/install | bash",
     command: "bash",
-    args: ["-c", "curl -fsSL https://opencode.ai/install | bash"],
-    note: "Alternativas Linux: npm install -g opencode-ai | bun add -g opencode-ai | brew install anomalyco/tap/opencode | paru -S opencode (Arch)"
+    args: ["-c", "curl -fsSL https://opencode.ai/v2/install | bash"],
+    note: "Alternativas Linux: npm install -g @opencode/cli | bun install -g --trust @opencode/cli | brew install anomalyco/tap/opencode-v2 | paru -S opencode-beta (Arch)"
   };
 }
 async function ensureOpencodeInstalled() {
@@ -4184,14 +4206,14 @@ ${info.note}` : ""}`, `Instalación requerida (${platform})`);
   spin.start(`Instalando OpenCode (${info.display})...`);
   try {
     if (platform === "win32") {
-      execSync("npm install -g opencode-ai", { stdio: "inherit", shell: "cmd.exe" });
+      execSync("npm install -g @opencode/cli", { stdio: "inherit", shell: "cmd.exe" });
     } else {
       if (!isCommandAvailable("curl")) {
         spin.stop("curl no disponible");
         v2.warn("curl no está instalado — se intentará con npm como fallback.");
-        execSync("npm install -g opencode-ai", { stdio: "inherit", shell: "/bin/bash" });
+        execSync("npm install -g @opencode/cli", { stdio: "inherit", shell: "/bin/bash" });
       } else {
-        execSync("curl -fsSL https://opencode.ai/install | bash", { stdio: "inherit", shell: "/bin/bash" });
+        execSync("curl -fsSL https://opencode.ai/v2/install | bash", { stdio: "inherit", shell: "/bin/bash" });
       }
     }
     spin.stop("Instalación ejecutada, verificando...");
@@ -4202,10 +4224,10 @@ ${info.note}` : ""}`, `Instalación requerida (${platform})`);
     if (platform === "win32") {
       ye([
         "Intentá manualmente una de estas opciones:",
-        "  npm install -g opencode-ai",
-        "  choco install opencode",
-        "  scoop install opencode",
-        "  (WSL) curl -fsSL https://opencode.ai/install | bash",
+        "  npm install -g @opencode/cli",
+        "  bun install -g --trust @opencode/cli",
+        "  binario suelto: https://opencode.ai/download",
+        "  (WSL) curl -fsSL https://opencode.ai/v2/install | bash",
         "Luego verificá: opencode --version",
         "Docs: https://opencode.ai/download"
       ].join(`
@@ -4214,8 +4236,8 @@ ${info.note}` : ""}`, `Instalación requerida (${platform})`);
       ye([
         "Intentá manualmente:",
         `  ${info.display}`,
-        "  npm install -g opencode-ai  (si no tenés curl)",
-        "  brew install anomalyco/tap/opencode  (macOS/Linux con brew)",
+        "  npm install -g @opencode/cli  (si no tenés curl)",
+        "  brew install anomalyco/tap/opencode-v2  (macOS/Linux con brew)",
         "Luego verificá: opencode --version",
         "Docs: https://opencode.ai/download"
       ].join(`
@@ -4265,7 +4287,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.");
@@ -4291,6 +4313,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)
@@ -4971,9 +4998,8 @@ async function runDoctorCommand() {
     const pluginPath = join11(cwd, "assets", "plugins", "ostacky-controller", "index.ts");
     if (existsSync9(pluginPath)) {
       const plugin = readFileSync7(pluginPath, "utf-8");
-      const hasSpecGuard = plugin.includes("getDiscoverySnapshot") && plugin.includes("specSnapshot");
-      const hasNoOverwrite = plugin.includes("No edites sin Read fresco") || plugin.includes("specSnapshot");
-      check("spec: no-overwrite guard", hasNoOverwrite, true);
+      const hasNoOverwrite = plugin.includes("shouldBlockCodeRead") && plugin.includes("isCodeReadGated") && plugin.includes("isTaskTracked") && plugin.includes("isShellPathExempt");
+      check("spec/tracked read-guard (shouldBlockCodeRead + exemptions)", hasNoOverwrite, true);
     }
     const hasSyncProactive = ostackyMd.includes("Noté que lo que acordamos");
     check("sync: proactive WARN", hasSyncProactive, true);