ostacky 0.9.5 → 0.9.7

package/README.md

@@ -109,16 +109,35 @@ npx ostacky
 
 Detecta automáticamente el directorio `.opencode/` del proyecto (o lo crea) y muestra un menú para elegir qué hacer.
 
-### Instalar todo
+### Instalar todo (local, default)
 
 ```bash
-npx ostacky install                 # siempre local en <proyecto>/.opencode
-npx ostacky install --scope local   # <proyecto>/.opencode (único scope soportado)
+npx ostacky install                 # local en <proyecto>/.opencode (default)
+npx ostacky install --scope local   # <proyecto>/.opencode (explícito)
 ```
 
 Descarga todos los agentes y commands definidos en el manifest y los escribe en `<proyecto>/.opencode`. Además copia los plugins **Ostacky-owned** `ostacky-plugin.ts` + `engram.ts` en `.opencode/plugins/` (el legacy `ostacky-guard.ts` fue fusionado en `ostacky-plugin.ts` y ya no se instala; `ostacky-controller.ts` legacy se limpia automáticamente si quedó de una instalación previa) y asegura `.gitignore` con ` .opencode/tools/, .codegraph/, .opencode/cache/, ostacky-state.json*`.
 
-> **Instalación siempre local:** Ostacky vive por proyecto/worktree (CodeGraph index `.codegraph/` y `ostacky-state.json` aislados). Si ves `C:\Users\...\ .opencode\tools\codegraph` y esperabas `D:\mi-proyecto\.opencode`, es porque corriste `npx ostacky` desde tu home sin estar dentro del proyecto (sin `.git`). Hacé `cd` al proyecto y re-ejecutá; el log muestra `projectRoot` y `toolsDir` explícitos.
+> **Instalación local (default):** Ostacky vive por proyecto/worktree (CodeGraph index `.codegraph/` y `ostacky-state.json` aislados). Si ves `C:\Users\...\ .opencode\tools\codegraph` y esperabas `D:\mi-proyecto\.opencode`, es porque corriste `npx ostacky` desde tu home sin estar dentro del proyecto (sin `.git`). Hacé `cd` al proyecto y re-ejecutá; el log muestra `projectRoot` y `toolsDir` explícitos.
+
+### Instalación global (opt-in)
+
+```bash
+npx ostacky --scope global           # menú interactivo global
+npx ostacky install --scope global   # núcleo global (agente + commands + skills + MCPs + plugins)
+```
+
+Escribe el núcleo en el config dir global de OpenCode sin tocar ningún proyecto:
+
+| SO | Dir global |
+|---|---|
+| Linux / macOS | `~/.config/opencode` (respeta `XDG_CONFIG_HOME`) |
+| Windows | config dir global de OpenCode según SO |
+| WSL | como Linux |
+
+El stack de binarios (CodeGraph, Engram) es **siempre local por proyecto**: con `--scope global` se omite y se indica instalarlo por proyecto (`npx ostacky install-stack` dentro del proyecto). La config global acepta `opencode.json` o `opencode.jsonc`; si el proyecto define el mismo MCP, su objeto reemplaza al global (comportamiento v2), y en skills con mismo ID gana la del proyecto.
+
+> **Migración v1 → v2:** `npx ostacky` (sin subcomando) busca la última versión publicada y, si detecta v1 instalada, ofrece desinstalar v1 e instalar v2 (siempre con confirmación; sin red o no-interactivo sigue al menú sin preguntar).
 
 ### Agregar agentes o commands individualmente
 
@@ -152,8 +171,9 @@ Solo descarga los items que cambiaron de versión.
 ### Desinstalar
 
 ```bash
-npx ostacky uninstall                          # qué borrar en <proyecto>/.opencode
+npx ostacky uninstall                          # qué borrar en <proyecto>/.opencode (default local)
 npx ostacky uninstall --scope local            # fuerza scope local
+npx ostacky uninstall --scope global           # qué borrar en el dir global
 ```
 
 **Safe-delete:** solo borra lo trackeado en `.opencode/ostacky-lock.json` (agentes, commands, skills, MCPs) — nunca toca componentes previos del usuario que no estén en el lockfile. Antes de borrar muestra preview con `Scope: <ruta>` + lista de paths y pide confirmación. Los plugins Ostacky-owned (`ostacky-plugin.ts`, `engram.ts` + legacy `ostacky-guard.ts`/`ostacky-controller.ts` si quedaron) se limpian automáticamente via allowlist, nunca se borran plugins custom.
@@ -250,37 +270,37 @@ Tras instalar (`--scope local`), el proyecto queda así:
 
 ```json
 {
-    "version": "0.9.5",
+    "version": "0.9.7",
     "lockedAt": "2025-01-01T00:00:00.000Z",
     "repo": "JaimeHoracio/Ostacky",
-    "tag": "v0.9.5",
+    "tag": "v0.9.7",
     "agents": {
         "ostacky": {
-            "version": "0.9.5",
+            "version": "0.9.7",
             "installedAt": "2025-01-01T00:00:00.000Z",
             "sha256": "abc123..."
         }
     },
     "commands": {
         "install-stack": {
-            "version": "0.9.5",
+            "version": "0.9.7",
             "installedAt": "2025-01-01T00:00:00.000Z",
             "sha256": "def456..."
         },
         "opsx-sync": {
-            "version": "0.9.5",
+            "version": "0.9.7",
             "installedAt": "2025-01-01T00:00:00.000Z",
             "sha256": "ghi789..."
         }
     },
     "skills": {
-        "brainstorming": { "version": "0.9.5", ... },
-        "execution-mode-evaluation": { "version": "0.9.5", ... },
-        "openspec-propose": { "version": "0.9.5", ... }
+        "brainstorming": { "version": "0.9.7", ... },
+        "execution-mode-evaluation": { "version": "0.9.7", ... },
+        "openspec-propose": { "version": "0.9.7", ... }
     },
     "mcpServers": {
-        "ostacky-controller": { "version": "0.9.5", ... },
-        "openspec": { "version": "0.9.5", ... }
+        "ostacky-controller": { "version": "0.9.7", ... },
+        "openspec": { "version": "0.9.7", ... }
     }
 }
 ```
@@ -312,7 +332,7 @@ Es opcional y solo necesario si algo falló durante la instalación o si querés
 ## Seguridad
 
 - `opencode.jsonc` se versiona en el repo para compartir permisos y MCP de forma reproducible.
-- Las URLs de descarga usan **tags de GitHub** (ej. `v0.9.5`), nunca `main` — instalaciones reproducibles
+- Las URLs de descarga usan **tags de GitHub** (ej. `v0.9.7`), nunca `main` — instalaciones reproducibles
 - Cada path de archivo descargado es validado para prevenir **path traversal**
 - Los archivos incluyen **checksum SHA-256** opcional; si el manifest lo define, el contenido se verifica antes de escribir
 - El cache local (`.opencode/cache/`) también valida integridad al servir archivos cacheados
@@ -369,7 +389,7 @@ CodeGraph está instalado en `.opencode/tools/codegraph/bin/codegraph` y se conf
 | `.opencode/tools/codegraph/bin/codegraph status`                                           | Muestra estado del index y archivos pendientes              |
 | `.opencode/tools/codegraph/bin/codegraph install --target opencode --location local --yes` | Configura CodeGraph para OpenCode y genera AGENTS.md        |
 
-> **Windows:** si ves `Command failed: cmd.exe /d /c call ... codegraph.cmd init -i` durante `npx ostacky install`, es un _warning_ no fatal — el binario se instaló pero el índice no se pudo crear. Reintentá con `npx ostacky install-stack --scope local` o ejecutá manualmente `.opencode\tools\codegraph\bin\codegraph.exe init -i` (o `codegraph.cmd` si no hay `.exe`) dentro del proyecto. Desde v0.9.5 el instalador usa el patrón resiliente de Engram (strip 0 + búsqueda recursiva) y loguea `projectRoot|toolsDir` para diagnosticar scope.
+> **Windows:** si ves `Command failed: cmd.exe /d /c call ... codegraph.cmd init -i` durante `npx ostacky install`, es un _warning_ no fatal — el binario se instaló pero el índice no se pudo crear. Reintentá con `npx ostacky install-stack --scope local` o ejecutá manualmente `.opencode\tools\codegraph\bin\codegraph.exe init -i` (o `codegraph.cmd` si no hay `.exe`) dentro del proyecto. Desde v0.9.7 el instalador usa el patrón resiliente de Engram (strip 0 + búsqueda recursiva) y loguea `projectRoot|toolsDir` para diagnosticar scope.
 
 ## Licencia
 

package/assets/agents/ostacky.md

@@ -1,12 +1,12 @@
 ---
 description: Orquestador principal — rutea por nivel, orquesta CodeGraph + OpenSpec + Superpowers.
 mode: primary
-version: 0.9.5
+version: 0.9.7
 ---
 
-Sos **Ostacky v0.9.5**, orquestás, no implementás. Interpretás, clasificás (0/0+1/1+), ruteás y coordinás.
+Sos **Ostacky v0.9.7**, orquestás, no implementás. Interpretás, clasificás (0/0+1/1+), ruteás y coordinás.
 
-> **Versión:** `0.9.5` (sincronizada desde `package.json` vía `scripts/sync-version.ts`). Cuando te pregunten qué versión tenés, qué versión sos, o `¿qué versión tenés?` / `version` / `¿en qué versión estás?`, respondé exactamente: **"Ostacky v0.9.5"** (o `v0.9.5` si te piden solo el número). No inventes otra versión.
+> **Versión:** `0.9.7` (sincronizada desde `package.json` vía `scripts/sync-version.ts`). Cuando te pregunten qué versión tenés, qué versión sos, o `¿qué versión tenés?` / `version` / `¿en qué versión estás?`, respondé exactamente: **"Ostacky v0.9.7"** (o `v0.9.7` si te piden solo el número). No inventes otra versión.
 
 ## Reglas innegociables
 
@@ -71,7 +71,7 @@ Si vago → preguntar. Si claro → `start_request`.
 
 `record_discovery({level,snapshot})` → `ROUTE_DECISION_PENDING` (`SPEC` si 1+, `DIRECT` si 0/0+1). `proceed_to_route` deprecated no-op.
 
-Preguntar nivel y `consume_route_decision`.
+**Nivel 0 → DIRECT automático (sin pregunta de ruteo):** anunciar `Nivel 0 + archivos + qué se va a hacer` y proceder con `consume_route_decision(DIRECT)`; el veto del usuario vale (si objeta, se frena). Niveles `0+1`/`1+` → preguntar nivel y `consume_route_decision` (una pregunta por turno).
 
 ### 3. Specification (solo SPEC)
 

package/assets/commands/install-stack.md

@@ -1,31 +1,31 @@
 ---
 description: Instala CodeGraph, skills curadas, OpenSpec y Engram localmente para OpenCode únicamente
 agent: build
+subagent: false
 ---
 
 Instala el stack tecnológico de desarrollo para OpenCode. **IMPORTANTE:** las herramientas se instalan por separado (cada una con su propio CLI/comando). `npx ostacky install` solo instala el agente y commands de Ostacky en `.opencode/`. Este comando (`/install-stack`) es la guía de referencia para la instalación manual completa paso a paso.
 
-**Nota:** A partir de v0.9.5, `npx ostacky install` ya instala automáticamente el stack completo (CodeGraph, OpenSpec, Engram, MCPs bundleados) además del agente y skills. Este comando es útil para instalación manual, verificación, o cuando algo falló y necesita reinstalarse.
+**Nota:** A partir de v0.9.7, `npx ostacky install` ya instala automáticamente el stack completo (CodeGraph, OpenSpec, Engram, MCPs bundleados) además del agente y skills. Este comando es útil para instalación manual, verificación, o cuando algo falló y necesita reinstalarse.
 
 **RESTRICCIÓN ABSOLUTA:** instalar ÚNICAMENTE para OpenCode. Está terminantemente prohibido crear o modificar archivos en `.claude/`, `.kiro/`, `.cursor/`, `.gemini/`, `.codex/`, `.antigravity/`, `.windsurf/` o cualquier otro directorio de plataformas externas.
 
 **Origen del set curado:** el set de 15 skills referenciado en `assets/agents/ostacky.md` está bundleado en `assets/skills/` dentro del paquete npm. La definición del set y su trazabilidad viven en `manifest.json` y `.opencode/ostacky-lock.json`.
 
-## Scope de instalación — local vs global (desde v0.9.5)
+## Scope de instalación — local (default) vs global (opt-in)
 
-`npx ostacky install` soporta `--scope local|global|auto` (también `--scope=...`):
+`npx ostacky install` soporta `--scope local|global` (también `--scope=...`):
 
-- `local` (recomendado): escribe en `<proyecto>/.opencode` (`opencode.json` local)
-- `global`: escribe en `~/.config/opencode` (Unix/WSL) o `%APPDATA%\opencode` (Windows); respeta `XDG_CONFIG_HOME`
-- `auto`: elige local si existe `.opencode` o `.git` (`.opencode` tiene prioridad), si no global
-- Sin flag: pregunta interactivamente (default local)
+- `local` (default): escribe en `<proyecto>/.opencode` (`opencode.json` local). Sin flag asume local.
+- `global`: escribe el núcleo (agente, commands, skills, MCPs, plugins) en el config dir global de OpenCode (`~/.config/opencode`, respeta `XDG_CONFIG_HOME`; en Windows el config dir global según SO). No toca `<proyecto>/.opencode`.
+- `--scope auto` y `-g` son error educativo: usá `--scope local` o `--scope global` explícito.
 
-Herramientas (`tools/`) permanecen siempre en `<proyecto>/.opencode/tools` por reproducibilidad. `npx ostacky install-stack --scope global` bloquea con error claro — el stack debe instalarse por proyecto:
+Herramientas (`tools/` CodeGraph/Engram) permanecen siempre en `<proyecto>/.opencode/tools` por reproducibilidad, también con `--scope global`. `npx ostacky install-stack --scope global` avisa y usa local — el stack se instala por proyecto:
 
 ```bash
-npx ostacky install --scope local
-npx ostacky install --scope global
-npx ostacky install-stack --scope auto   # stack / proyecto
+npx ostacky install                  # local (default)
+npx ostacky install --scope global   # núcleo global (sin stack)
+npx ostacky install-stack            # stack local por proyecto
 ```
 
 > **Windows con espacios** (ej. `C:\Users\Jaime Horacio\Desktop\Mi Proyecto`): la instalación es segura via invocación por arrays (libuv escapa cada argumento); no se aplica pre-quoting. `opencode.json` guarda `command` como array JSON.

package/assets/commands/opsx-sync.md

@@ -1,6 +1,7 @@
 ---
 description: Sincroniza el grafo de CodeGraph y luego los delta specs del change activo con la implementación
 agent: build
+subagent: false
 ---
 
 Sincroniza primero el grafo y luego los delta specs (`proposal.md` / `design.md` / `tasks.md`) del change activo en `openspec/changes/<name>/` con el estado actual de la implementación.

package/assets/mcp/ostacky-controller/index.js

@@ -2996,7 +2996,7 @@ function safeHandler(fn, options = {}) {
 
 const server = new McpServer({
     name: 'ostacky-controller',
-    version: '0.9.5',
+    version: '0.9.7',
 });
 
 server.registerTool(
@@ -3598,7 +3598,7 @@ function setupGracefulShutdown(ctrl) {
 }
 
 async function main() {
-    log('Starting ostacky-controller MCP v0.9.5...');
+    log('Starting ostacky-controller MCP v0.9.7...');
     log('State path:', { path: statePath });
     // Clean up stale tmp/lock files from previous runs
     cleanupTmpFiles(statePath);

package/assets/mcp/ostacky-controller/package.json

@@ -1,6 +1,6 @@
 {
     "name": "ostacky-controller",
-    "version": "0.9.5",
+    "version": "0.9.6",
     "private": true,
     "type": "module",
     "dependencies": {

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()) {
@@ -244,16 +245,7 @@ function findProjectRoot(startDir = process.cwd()) {
     if (out && existsSync(out))
       return resolve(out);
   } catch {}
-  let current = resolve(startDir);
-  while (true) {
-    if (existsSync(join(current, ".opencode")) || existsSync(join(current, ".git"))) {
-      return current;
-    }
-    const parent = dirname(current);
-    if (parent === current)
-      return resolve(startDir);
-    current = parent;
-  }
+  return resolve(startDir);
 }
 function isGitRepo(dir = process.cwd()) {
   try {
@@ -267,10 +259,26 @@ function isGitRepo(dir = process.cwd()) {
     return false;
   }
 }
+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()) {
-  const existing = findOpenCodeDir(cwd);
-  if (existing)
-    return existing;
+  if (scope === "global")
+    return getGlobalOpenCodeDir();
   return join(findProjectRoot(cwd), ".opencode");
 }
 function ensureOpenCodePaths(opencodeDir) {
@@ -633,48 +641,48 @@ var init_fs = __esm(() => {
 var manifest_default;
 var init_manifest = __esm(() => {
   manifest_default = {
-    version: "0.9.5",
+    version: "0.9.7",
     repo: "JaimeHoracio/Ostacky",
-    tag: "v0.9.5",
+    tag: "v0.9.7",
     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.5: prune de skills obsoletas, lastHandoff, getAvailableTransitions, consecutiveFailures real, mem_session_summary automático al cierre.",
-        version: "0.9.5",
-        sha256: "986c41356dcdea8d74fea6a17127a45e78e16a5cda43152efb5c7ffd11593b8c"
+        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"
       }
     ],
     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.5: controller plugin como alma hard-gate, Context7 removido del stack.",
-        version: "0.9.5",
-        sha256: "e218ec7db404fc8bd5fa1d92312eef5ea517bb0940af054f8665048ec2e9da5f"
+        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"
       },
       {
         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.5",
-        sha256: "fe0158478f2ca63b315037a85fc1632b77868532e319af6c7384285441767d64"
+        version: "0.9.7",
+        sha256: "f883f9ad96f7d75778631d5cc13d8a1a9c3e6ec41396bbce8ce13cff2e66fca2"
       }
     ],
     mcpServers: [
       {
         name: "ostacky-controller",
         file: "assets/mcp/ostacky-controller/",
-        description: "Máquina de estados persistida con @modelcontextprotocol/server SDK. v0.9.5: 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.5",
-        sha256: "775f4b8b28a315e97f9192d71a9433fa28235fe84c29401451ace628829c7076"
+        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"
       },
       {
         name: "openspec",
         file: "assets/mcp/openspec/",
         description: "MCP server local para OpenSpec - proposal, apply, archive, sync de cambios",
-        version: "0.9.5",
-        sha256: "fa4be28bfc1e75db8f1a037e2580f04a60066c80e8e5934e90e1041020d04609"
+        version: "0.9.7",
+        sha256: "bdb283fe8ec2dfcba2ec4f38191f4039e58cd7ae12e44e66310783b42c827638"
       }
     ],
     skills: [
@@ -682,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.5",
+        version: "0.9.7",
         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.5",
+        version: "0.9.7",
         sha256: "2158a6864c0912e868a9d720db7fd79441e6cc298e3320833d2527c9727c852e"
       },
       {
         name: "tdd",
         file: "assets/skills/tdd/SKILL.md",
         description: "Skill de test-driven development (Superpowers)",
-        version: "0.9.5",
+        version: "0.9.7",
         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.5",
+        version: "0.9.7",
         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.5",
+        version: "0.9.7",
         sha256: "7e7b712ef742d5631e302e6a71583e2bbbd33094da9281abfb84b43505fc3ef1"
       },
       {
         name: "review",
         file: "assets/skills/review/SKILL.md",
         description: "Skill de revisión de código (Superpowers)",
-        version: "0.9.5",
+        version: "0.9.7",
         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.5",
+        version: "0.9.7",
         sha256: "d761e884e71d8d3476ac734d287cae403a4024506a7d12e7361a448217c0a831"
       },
       {
         name: "openspec-propose",
         file: "assets/skills/openspec-propose/SKILL.md",
         description: "Skill de generación de proposal (OpenSpec)",
-        version: "0.9.5",
+        version: "0.9.7",
         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.5",
+        version: "0.9.7",
         sha256: "dfc823bf89fc7505e91ab6dee9c1f004be38a410bd3d88fb67b211b1b6cbb1d0"
       },
       {
         name: "openspec-archive-change",
         file: "assets/skills/openspec-archive-change/SKILL.md",
         description: "Skill de archivo de change (OpenSpec)",
-        version: "0.9.5",
+        version: "0.9.7",
         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.5",
+        version: "0.9.7",
         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.5",
+        version: "0.9.7",
         sha256: "93341bc1b7c053618a8b6dc07e3615b77990d7b549a0201f5835d95fef67ce13"
       },
       {
         name: "using-superpowers",
         file: "assets/skills/using-superpowers/SKILL.md",
         description: "Skill de orquestación de Superpowers skills",
-        version: "0.9.5",
+        version: "0.9.7",
         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.5",
+        version: "0.9.7",
         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.5",
+        version: "0.9.7",
         sha256: "363449bd9e6f800a0a3168667cf78f767fb105d86e4a4adadcc649d418139303"
       }
     ]
@@ -1130,10 +1138,10 @@ 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 resolve2 } from "path";
+import { basename as basename2, dirname as dirname5, join as join7, resolve as resolve3 } from "path";
 import { execFileSync as execFileSync3 } from "child_process";
 function resolveToolInstallLocation(toolsDir) {
-  const resolvedToolsDir = resolve2(toolsDir ?? join7(findProjectRoot(), ".opencode", "tools"));
+  const resolvedToolsDir = resolve3(toolsDir ?? join7(findProjectRoot(), ".opencode", "tools"));
   const possibleOpenCodeDir = dirname5(resolvedToolsDir);
   return {
     projectRoot: basename2(possibleOpenCodeDir) === ".opencode" ? dirname5(possibleOpenCodeDir) : findProjectRoot(),
@@ -1575,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`);
@@ -1656,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;
@@ -1690,7 +1727,7 @@ var init_doctor_v2 = __esm(() => {
 // package.json
 var package_default = {
   name: "ostacky",
-  version: "0.9.5",
+  version: "0.9.7",
   description: "Instalador interactivo de agentes y comandos para OpenCode",
   type: "module",
   bin: {
@@ -1701,7 +1738,8 @@ var package_default = {
     dev: "bun run src/cli.ts",
     build: "bun build src/cli.ts --target=node --format=esm --outfile dist/cli.js && bun scripts/add-shebang.ts",
     start: "node dist/cli.js",
-    test: "bun test",
+    test: "bun test --isolate",
+    "test:safe": "bun run scripts/run-tests-isolated.ts",
     "check:skills": "bun run scripts/check-skill-sync.ts",
     "hash:check": "bun run scripts/update-manifest-hashes.ts --check",
     "hash:update": "bun run scripts/update-manifest-hashes.ts",
@@ -2690,6 +2728,7 @@ import { dirname as dirname7 } from "path";
 init_github();
 init_fs();
 init_lockfile();
+import { resolve as resolve2 } from "path";
 
 // src/installer.ts
 init_github();
@@ -2867,7 +2906,7 @@ async function probeMcpServer(nodeExecutable, serverPath, cwd, statePath, option
         params: {
           protocolVersion: "2025-03-26",
           capabilities: {},
-          clientInfo: { name: "ostacky-installer", version: "0.9.5" }
+          clientInfo: { name: "ostacky-installer", version: "0.9.7" }
         }
       });
     });
@@ -3028,7 +3067,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;
@@ -3224,6 +3264,28 @@ function onCancel(value) {
     process.exit(0);
   }
 }
+async function runGitPreflight(cwd = process.cwd(), opts) {
+  if (isGitRepo(cwd))
+    return { projectRoot: findProjectRoot(cwd), gitReady: true };
+  const interactive = opts?.interactive ?? process.stdin.isTTY === true;
+  if (interactive) {
+    const ask = opts?.confirm ?? (() => me({ message: `No hay repo Git en ${cwd}. ¿Inicializar uno? (recomendado para aislamiento por worktree)` }));
+    let answer = false;
+    try {
+      answer = await ask();
+    } catch {
+      answer = false;
+    }
+    if (answer === true) {
+      try {
+        initGitRepo(cwd);
+        return { projectRoot: findProjectRoot(cwd), gitReady: true };
+      } catch {}
+    }
+  }
+  v2.warn("Sin repo Git: aislamiento por worktree no disponible; se instala en el directorio actual.");
+  return { projectRoot: resolve2(cwd), gitReady: false };
+}
 async function loadManifest() {
   const spin = L2();
   spin.start("Obteniendo recursos disponibles...");
@@ -3253,11 +3315,24 @@ function printPostInstallSteps() {
   ].join(`
 `), "Próximos pasos");
 }
-async function resolveOpenCodePaths(scope) {
+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 dir = scope === "local" || !scope ? getOpenCodeDirForScope("local", cwd) : getOpenCodeDirForScope("local", cwd);
-  if (scope && scope !== "local") {
-    v2.warn(`Scope ${scope} removido; usando local en ${dir}`);
+  const base = opts?.gitPreflight ? (await runGitPreflight(cwd)).projectRoot : cwd;
+  const dir = getOpenCodeDirForScope("local", base);
+  if (scope && scope !== "local" && scope !== "global") {
+    v2.warn(`Scope ${scope} no soportado; usando local en ${dir}`);
   }
   try {
     const paths = ensureOpenCodePaths(dir);
@@ -3395,8 +3470,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) {
@@ -3474,7 +3552,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...");
@@ -3484,7 +3564,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"))
@@ -3507,12 +3587,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;
 }
@@ -4161,7 +4243,7 @@ async function runInteractiveMenu(scope) {
   we(" OpenCode Installer ");
   await ensureOpencodeInstalled();
   const manifest = await loadManifest();
-  const paths = await resolveOpenCodePaths(scope ?? null);
+  const paths = await resolveOpenCodePaths(scope ?? null, { gitPreflight: scope !== "global" });
   if (!paths) {
     fe("Instalación cancelada.");
     return;
@@ -4235,12 +4317,12 @@ async function runInstallCommand(scope, opts) {
   we(" OpenCode Installer ");
   await ensureOpencodeInstalled();
   const manifest = await loadManifest();
-  const paths = await resolveOpenCodePaths(scope ?? null);
+  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.");
@@ -4300,7 +4382,7 @@ async function runAddMcpCommand(scope) {
 async function runInstallStackCommand(scope) {
   await ensureOpencodeInstalled();
   we(" OpenCode Installer — Stack ");
-  const paths = await resolveOpenCodePaths(scope ?? null);
+  const paths = await resolveOpenCodePaths(scope ?? null, { gitPreflight: true });
   if (!paths) {
     fe("Cancelado.");
     return;
@@ -4499,59 +4581,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);
     }
   }
@@ -4912,10 +5077,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") {
@@ -4973,6 +5144,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);
   }
 }

package/manifest.json

@@ -1,46 +1,46 @@
 {
-  "version": "0.9.5",
+  "version": "0.9.7",
   "repo": "JaimeHoracio/Ostacky",
-  "tag": "v0.9.5",
+  "tag": "v0.9.7",
   "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.5: prune de skills obsoletas, lastHandoff, getAvailableTransitions, consecutiveFailures real, mem_session_summary automático al cierre.",
-      "version": "0.9.5",
-      "sha256": "986c41356dcdea8d74fea6a17127a45e78e16a5cda43152efb5c7ffd11593b8c"
+      "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"
     }
   ],
   "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.5: controller plugin como alma hard-gate, Context7 removido del stack.",
-      "version": "0.9.5",
-      "sha256": "e218ec7db404fc8bd5fa1d92312eef5ea517bb0940af054f8665048ec2e9da5f"
+      "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"
     },
     {
       "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.5",
-      "sha256": "fe0158478f2ca63b315037a85fc1632b77868532e319af6c7384285441767d64"
+      "version": "0.9.7",
+      "sha256": "f883f9ad96f7d75778631d5cc13d8a1a9c3e6ec41396bbce8ce13cff2e66fca2"
     }
   ],
   "mcpServers": [
     {
       "name": "ostacky-controller",
       "file": "assets/mcp/ostacky-controller/",
-      "description": "Máquina de estados persistida con @modelcontextprotocol/server SDK. v0.9.5: 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.5",
-      "sha256": "775f4b8b28a315e97f9192d71a9433fa28235fe84c29401451ace628829c7076"
+      "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"
     },
     {
       "name": "openspec",
       "file": "assets/mcp/openspec/",
       "description": "MCP server local para OpenSpec - proposal, apply, archive, sync de cambios",
-      "version": "0.9.5",
-      "sha256": "fa4be28bfc1e75db8f1a037e2580f04a60066c80e8e5934e90e1041020d04609"
+      "version": "0.9.7",
+      "sha256": "bdb283fe8ec2dfcba2ec4f38191f4039e58cd7ae12e44e66310783b42c827638"
     }
   ],
   "skills": [
@@ -48,105 +48,105 @@
       "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.5",
+      "version": "0.9.7",
       "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.5",
+      "version": "0.9.7",
       "sha256": "2158a6864c0912e868a9d720db7fd79441e6cc298e3320833d2527c9727c852e"
     },
     {
       "name": "tdd",
       "file": "assets/skills/tdd/SKILL.md",
       "description": "Skill de test-driven development (Superpowers)",
-      "version": "0.9.5",
+      "version": "0.9.7",
       "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.5",
+      "version": "0.9.7",
       "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.5",
+      "version": "0.9.7",
       "sha256": "7e7b712ef742d5631e302e6a71583e2bbbd33094da9281abfb84b43505fc3ef1"
     },
     {
       "name": "review",
       "file": "assets/skills/review/SKILL.md",
       "description": "Skill de revisión de código (Superpowers)",
-      "version": "0.9.5",
+      "version": "0.9.7",
       "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.5",
+      "version": "0.9.7",
       "sha256": "d761e884e71d8d3476ac734d287cae403a4024506a7d12e7361a448217c0a831"
     },
     {
       "name": "openspec-propose",
       "file": "assets/skills/openspec-propose/SKILL.md",
       "description": "Skill de generación de proposal (OpenSpec)",
-      "version": "0.9.5",
+      "version": "0.9.7",
       "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.5",
+      "version": "0.9.7",
       "sha256": "dfc823bf89fc7505e91ab6dee9c1f004be38a410bd3d88fb67b211b1b6cbb1d0"
     },
     {
       "name": "openspec-archive-change",
       "file": "assets/skills/openspec-archive-change/SKILL.md",
       "description": "Skill de archivo de change (OpenSpec)",
-      "version": "0.9.5",
+      "version": "0.9.7",
       "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.5",
+      "version": "0.9.7",
       "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.5",
+      "version": "0.9.7",
       "sha256": "93341bc1b7c053618a8b6dc07e3615b77990d7b549a0201f5835d95fef67ce13"
     },
     {
       "name": "using-superpowers",
       "file": "assets/skills/using-superpowers/SKILL.md",
       "description": "Skill de orquestación de Superpowers skills",
-      "version": "0.9.5",
+      "version": "0.9.7",
       "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.5",
+      "version": "0.9.7",
       "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.5",
+      "version": "0.9.7",
       "sha256": "363449bd9e6f800a0a3168667cf78f767fb105d86e4a4adadcc649d418139303"
     }
   ]

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "ostacky",
-    "version": "0.9.5",
+    "version": "0.9.7",
     "description": "Instalador interactivo de agentes y comandos para OpenCode",
     "type": "module",
     "bin": {
@@ -11,7 +11,8 @@
         "dev": "bun run src/cli.ts",
         "build": "bun build src/cli.ts --target=node --format=esm --outfile dist/cli.js && bun scripts/add-shebang.ts",
         "start": "node dist/cli.js",
-        "test": "bun test",
+        "test": "bun test --isolate",
+        "test:safe": "bun run scripts/run-tests-isolated.ts",
         "check:skills": "bun run scripts/check-skill-sync.ts",
         "hash:check": "bun run scripts/update-manifest-hashes.ts --check",
         "hash:update": "bun run scripts/update-manifest-hashes.ts",

package/assets/mcp/openspec/bun.lock

@@ -1,20 +0,0 @@
-{
-  "lockfileVersion": 1,
-  "configVersion": 1,
-  "workspaces": {
-    "": {
-      "name": "openspec-mcp",
-      "dependencies": {
-        "@modelcontextprotocol/server": "^2.0.0-beta.5",
-        "zod": "^4.0.0",
-      },
-    },
-  },
-  "packages": {
-    "@modelcontextprotocol/core": ["@modelcontextprotocol/core@2.0.0-beta.5", "", { "dependencies": { "zod": "^4.2.0" } }, "sha512-HKbY9XTbsDy1Y6r2I55TGE3JEapM0vg96e1MUmBIF9LGjos5gjhcIrTz1yvBPLg2aFKHjwhUAQfRdrCEnPxNew=="],
-
-    "@modelcontextprotocol/server": ["@modelcontextprotocol/server@2.0.0-beta.5", "", { "dependencies": { "@modelcontextprotocol/core": "2.0.0-beta.5", "zod": "^4.2.0" } }, "sha512-i1E5l75rQKsgY/AKAIspgMBH1vEL7dqiK7tHr0L+raYcb0SWOziqNGJXGIG6NY4AlXDWIKGJQGB7Nqfs3oUi5g=="],
-
-    "zod": ["zod@4.4.3", "", {}, "sha512-ytENFjIJFl2UwYglde2jchW2Hwm4GJFLDiSXWdTrJQBIN9Fcyp7n4DhxJEiWNAJMV1/BqWfW/kkg71UDcHJyTQ=="],
-  }
-}

package/assets/mcp/ostacky-controller/bun.lock

@@ -1,20 +0,0 @@
-{
-  "lockfileVersion": 2,
-  "configVersion": 0,
-  "workspaces": {
-    "": {
-      "name": "ostacky-controller",
-      "dependencies": {
-        "@modelcontextprotocol/server": "^2.0.0",
-        "zod": "^4.0.0",
-      },
-    },
-  },
-  "packages": {
-    "@modelcontextprotocol/core": ["@modelcontextprotocol/core@2.1.0", "", { "dependencies": { "zod": "^4.2.0" } }, "sha512-YdFj5gMRHr0gYNAhTbQDgjLHiEJdIAUYxomhKseUNye7ZGlISQmUoLh2sveFFCiQ7j2YMffT1kgSND0FSfIFjQ=="],
-
-    "@modelcontextprotocol/server": ["@modelcontextprotocol/server@2.1.0", "", { "dependencies": { "@modelcontextprotocol/core": "2.1.0", "zod": "^4.2.0" } }, "sha512-FdvwZU5N03O77Suh35JqjAqq5R1ZTEPFtwu6N4BgBq28qrQtrCnpbLL5U2pwYCuE194jAw0xnlOVmIqhfoYuUQ=="],
-
-    "zod": ["zod@4.4.3", "", {}, "sha512-ytENFjIJFl2UwYglde2jchW2Hwm4GJFLDiSXWdTrJQBIN9Fcyp7n4DhxJEiWNAJMV1/BqWfW/kkg71UDcHJyTQ=="],
-  }
-}