ostacky 0.7.4 → 0.8.1

package/dist/cli.js

@@ -293,6 +293,36 @@ var init_security = __esm(() => {
 });
 
 // src/fs.ts
+var exports_fs = {};
+__export(exports_fs, {
+  USER_AGENT: () => USER_AGENT,
+  checkBunAvailability: () => checkBunAvailability,
+  computeTreeHash: () => computeTreeHash,
+  copyDirRecursive: () => copyDirRecursive,
+  createOpenCodeDir: () => createOpenCodeDir,
+  detectPlatformTarget: () => detectPlatformTarget,
+  downloadAndExtract: () => downloadAndExtract,
+  downloadAndExtractWithRetry: () => downloadAndExtractWithRetry,
+  downloadToFile: () => downloadToFile,
+  downloadWithRetry: () => downloadWithRetry,
+  ensureOpenCodePaths: () => ensureOpenCodePaths,
+  ensureToolDirs: () => ensureToolDirs,
+  findBinaryInDir: () => findBinaryInDir,
+  findExecutablePath: () => findExecutablePath,
+  findOpenCodeDir: () => findOpenCodeDir,
+  findProjectRoot: () => findProjectRoot,
+  getBunInstallCommand: () => getBunInstallCommand,
+  getCommandInvocation: () => getCommandInvocation,
+  getEngramReleaseTarget: () => getEngramReleaseTarget,
+  getExecutableName: () => getExecutableName,
+  getExecutableNames: () => getExecutableNames,
+  getGlobalOpenCodeDir: () => getGlobalOpenCodeDir,
+  getOpenCodeDirForScope: () => getOpenCodeDirForScope,
+  isCommandAvailable: () => isCommandAvailable,
+  parseScopeArg: () => parseScopeArg,
+  promoteStagedDirectory: () => promoteStagedDirectory,
+  shouldRetryDownload: () => shouldRetryDownload
+});
 import {
   existsSync,
   mkdirSync,
@@ -366,6 +396,22 @@ function getOpenCodeDirForScope(scope, cwd = process.cwd()) {
   }
   return getGlobalOpenCodeDir();
 }
+function parseScopeArg(argv = process.argv) {
+  for (let i = 0;i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "--scope" && i + 1 < argv.length) {
+      const v3 = argv[i + 1];
+      if (v3 === "local" || v3 === "global" || v3 === "auto")
+        return v3;
+    }
+    if (arg.startsWith("--scope=")) {
+      const v3 = arg.split("=")[1];
+      if (v3 === "local" || v3 === "global" || v3 === "auto")
+        return v3;
+    }
+  }
+  return null;
+}
 function ensureOpenCodePaths(opencodeDir) {
   const paths = {
     root: opencodeDir,
@@ -389,6 +435,9 @@ function ensureToolDirs(toolsDir, toolNames) {
       mkdirSync(dir, { recursive: true });
   }
 }
+function createOpenCodeDir(baseDir) {
+  return ensureOpenCodePaths(join(baseDir, ".opencode"));
+}
 function copyDirRecursive(src, dest, skipGenerated = false) {
   if (!existsSync(dest))
     mkdirSync(dest, { recursive: true });
@@ -449,6 +498,44 @@ function findExecutablePath(cmd) {
     return null;
   }
 }
+function getBunInstallCommand() {
+  const platform = process.platform;
+  if (platform === "darwin" || platform === "linux") {
+    return {
+      command: "curl -fsSL https://bun.com/install | bash",
+      note: platform === "linux" ? "Requires 'unzip' package (sudo apt install unzip)" : undefined
+    };
+  }
+  if (platform === "win32") {
+    return {
+      command: 'powershell -c "irm bun.sh/install.ps1|iex"',
+      note: "Requires Windows 10 v1809 or later"
+    };
+  }
+  return {
+    command: "npm install -g bun",
+    note: "Cross-platform fallback"
+  };
+}
+function checkBunAvailability() {
+  const bunPath = findExecutablePath("bun");
+  if (bunPath) {
+    let version;
+    try {
+      version = execFileSync(bunPath, ["--version"], {
+        encoding: "utf-8",
+        stdio: ["pipe", "pipe", "pipe"]
+      }).trim();
+    } catch {}
+    return { available: true, path: bunPath, version };
+  }
+  const { command, note } = getBunInstallCommand();
+  return {
+    available: false,
+    installCommand: command,
+    installNote: note
+  };
+}
 function detectPlatformTarget(platform = process.platform, arch = process.arch) {
   let os;
   let cpu;
@@ -570,6 +657,23 @@ function downloadToFile(url, dest, timeoutMs = 180000) {
     });
   });
 }
+async function downloadWithRetry(url, dest, maxRetries = 2, timeoutMs = 180000) {
+  let lastError = null;
+  for (let attempt = 0;attempt <= maxRetries; attempt++) {
+    try {
+      await downloadToFile(url, dest, timeoutMs);
+      return;
+    } catch (err) {
+      lastError = err;
+      if (attempt < maxRetries && shouldRetryDownload(lastError)) {
+        const delay = 1000 * Math.pow(2, attempt);
+        console.error(`[download] Intento ${attempt + 1} falló: ${lastError.message}. Reintentando en ${delay}ms...`);
+        await new Promise((r2) => setTimeout(r2, delay));
+      }
+    }
+  }
+  throw lastError;
+}
 async function downloadAndExtract(url, destDir, stripComponents = 1, timeoutMs = 180000) {
   const tmp = join(dirname(destDir), `.${basename(destDir)}.download-${Date.now()}-${process.pid}`);
   if (!existsSync(tmp))
@@ -640,31 +744,31 @@ var init_fs = __esm(() => {
 var manifest_default;
 var init_manifest = __esm(() => {
   manifest_default = {
-    version: "0.7.4",
+    version: "0.8.1",
     repo: "JaimeHoracio/Ostacky",
-    tag: "v0.7.4",
+    tag: "v0.8.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.7.4: prune de skills obsoletas, lastHandoff, getAvailableTransitions, consecutiveFailures real, mem_session_summary automático al cierre.",
-        version: "0.7.4",
-        sha256: "ffda231d1a9df1693f32460bdb6811077f7f53ba7902b2616d82231a3d6d43bb"
+        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.8.1: prune de skills obsoletas, lastHandoff, getAvailableTransitions, consecutiveFailures real, mem_session_summary automático al cierre.",
+        version: "0.8.1",
+        sha256: "1dea56ffe3866e830c5138b44ff3e7531324ddd2784b1d34a8956614a53c5ec9"
       }
     ],
     commands: [
       {
         name: "install-stack",
         file: "assets/commands/install-stack.md",
-        description: "Instala el stack tecnológico del proyecto (CodeGraph, skills, OpenSpec, Engram, Context7, controller MCP con SDK oficial). v0.7.4: Paso 1.5 controller expandido con verificación post-instalación y troubleshooting.",
-        version: "0.7.4",
-        sha256: "6887499074a82c3b4538e38ca501290cacd3afad676bd127662fed77e268f299"
+        description: "Instala el stack tecnológico del proyecto (CodeGraph, skills, OpenSpec, Engram, controller plugin). v0.8.1: controller plugin como alma hard-gate, Context7 removido del stack.",
+        version: "0.8.1",
+        sha256: "43ad96a63ceab8730cf0459838e7fad2953333307cfc664a849ca39f7ba7d532"
       },
       {
         name: "opsx-sync",
         file: "assets/commands/opsx-sync.md",
         description: "Sincroniza delta specs del change activo sin inicializar CodeGraph si ya existe índice",
-        version: "0.7.4",
+        version: "0.8.1",
         sha256: "fe0158478f2ca63b315037a85fc1632b77868532e319af6c7384285441767d64"
       }
     ],
@@ -672,15 +776,15 @@ var init_manifest = __esm(() => {
       {
         name: "ostacky-controller",
         file: "assets/mcp/ostacky-controller/",
-        description: "Máquina de estados persistida con @modelcontextprotocol/server SDK. v0.7.4: 22 tools (incluye set_handoff, get_handoff, clear_handoff, get_available_transitions funcional). Bugfixes: consecutiveFailures real, lastHandoff state, defaultChoice persistido. Robustez: degraded mode automático tras 3 fallos, persistence condicional para Nivel 0, prune de skills obsoletas.",
-        version: "0.7.4",
-        sha256: "4f86b6829293024caeb3d09c83b61aee158c383a7bb053a49e5a33c7c55862d1"
+        description: "Máquina de estados persistida con @modelcontextprotocol/server SDK. v0.8.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.8.1",
+        sha256: "ec554bc97f9d9b1e64c0b42813547dedc923e86e326c43ae87afab88ba249b90"
       },
       {
         name: "openspec",
         file: "assets/mcp/openspec/",
         description: "MCP server local para OpenSpec - proposal, apply, archive, sync de cambios",
-        version: "0.7.4",
+        version: "0.8.1",
         sha256: "fa4be28bfc1e75db8f1a037e2580f04a60066c80e8e5934e90e1041020d04609"
       }
     ],
@@ -689,105 +793,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.7.4",
-        sha256: "7b0020f31f346d8f2070219930cfb9341135d40941195f0ea50c3bd7f4a42990"
+        version: "0.8.1",
+        sha256: "87f8d6ed28205f9272792d3865d8cd3232ab5e511a604d6d63d41e3a02a5f422"
       },
       {
         name: "execution-mode-evaluation",
         file: "assets/skills/execution-mode-evaluation/SKILL.md",
         description: "Skill de análisis de modo de ejecución — output reconciliado con controller snapshot contract (recommendation field)",
-        version: "0.7.4",
-        sha256: "e17f1e0309572841dc1fa537b1f32c7468eb70b3acf453b9ff5cc4fa8d94fd39"
+        version: "0.8.1",
+        sha256: "7b89dda29927c88f1eb13ffcea541a12423384c172f66c4f3d9b61efe0c7a163"
       },
       {
         name: "tdd",
         file: "assets/skills/tdd/SKILL.md",
         description: "Skill de test-driven development (Superpowers)",
-        version: "0.7.4",
+        version: "0.8.1",
         sha256: "aa412298980b7826165c211145c1b8e9135f68f36247bb3cb96d0a0eae274486"
       },
       {
         name: "subagent-driven-development",
         file: "assets/skills/subagent-driven-development/SKILL.md",
         description: "Skill de ejecución con subagentes (Superpowers) — ejecuta solo después de confirmación del coordinador Ostacky",
-        version: "0.7.4",
+        version: "0.8.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.7.4",
+        version: "0.8.1",
         sha256: "3c8a66d51ae2e719e877d02c3dac32bd804722c3bb9227c258ecae78252a20ab"
       },
       {
         name: "review",
         file: "assets/skills/review/SKILL.md",
         description: "Skill de revisión de código (Superpowers)",
-        version: "0.7.4",
+        version: "0.8.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.7.4",
+        version: "0.8.1",
         sha256: "d761e884e71d8d3476ac734d287cae403a4024506a7d12e7361a448217c0a831"
       },
       {
         name: "openspec-propose",
         file: "assets/skills/openspec-propose/SKILL.md",
         description: "Skill de generación de proposal (OpenSpec)",
-        version: "0.7.4",
+        version: "0.8.1",
         sha256: "bb59100b9fd3c9f9a1ec6509fa975ec55bf7fc737df4fe73bb3e9bbc217b83f7"
       },
       {
         name: "openspec-apply-change",
         file: "assets/skills/openspec-apply-change/SKILL.md",
         description: "Skill de aplicación de change (OpenSpec)",
-        version: "0.7.4",
+        version: "0.8.1",
         sha256: "dfc823bf89fc7505e91ab6dee9c1f004be38a410bd3d88fb67b211b1b6cbb1d0"
       },
       {
         name: "openspec-archive-change",
         file: "assets/skills/openspec-archive-change/SKILL.md",
         description: "Skill de archivo de change (OpenSpec)",
-        version: "0.7.4",
+        version: "0.8.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.7.4",
+        version: "0.8.1",
         sha256: "37ae4aaf17ea71a395bab6dc4d9d61b9a49d7910f6692535ae8553244c46880b"
       },
       {
         name: "using-git-worktrees",
         file: "assets/skills/using-git-worktrees/SKILL.md",
         description: "Skill de uso de git worktrees para aislamiento de trabajo",
-        version: "0.7.4",
+        version: "0.8.1",
         sha256: "93341bc1b7c053618a8b6dc07e3615b77990d7b549a0201f5835d95fef67ce13"
       },
       {
         name: "using-superpowers",
         file: "assets/skills/using-superpowers/SKILL.md",
         description: "Skill de orquestación de Superpowers skills",
-        version: "0.7.4",
+        version: "0.8.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.7.4",
+        version: "0.8.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.7.4",
+        version: "0.8.1",
         sha256: "40f929e8032b70d51b3548bddcc383b931d6044fd9d4acce8a5b9f7acd014f59"
       }
     ]
@@ -829,6 +933,19 @@ var init_cache = __esm(() => {
 });
 
 // src/github.ts
+var exports_github = {};
+__export(exports_github, {
+  BUNDLED_MCP_DIR: () => BUNDLED_MCP_DIR,
+  BUNDLED_SKILLS_DIR: () => BUNDLED_SKILLS_DIR,
+  PACKAGE_ROOT: () => PACKAGE_ROOT,
+  downloadFile: () => downloadFile,
+  fetchLatestManifest: () => fetchLatestManifest,
+  fetchLatestReleaseTag: () => fetchLatestReleaseTag,
+  fetchManifest: () => fetchManifest,
+  getBundledMcpPath: () => getBundledMcpPath,
+  getBundledSkillPath: () => getBundledSkillPath,
+  getRawUrl: () => getRawUrl
+});
 import { fileURLToPath } from "url";
 import { dirname as dirname3, join as join3 } from "path";
 function getBundledSkillPath(name) {
@@ -1143,6 +1260,12 @@ function patchOpenCodeConfig(projectRoot = findProjectRoot()) {
     delete config.plugin;
     changed = true;
   }
+  if (config.mcp && typeof config.mcp === "object" && "context7" in config.mcp) {
+    delete config.mcp.context7;
+    if (Object.keys(config.mcp).length === 0)
+      delete config.mcp;
+    changed = true;
+  }
   if (changed) {
     writeOpenCodeConfig(configPath, config);
     return { success: true, message: "Config actualizada (plugin legacy eliminado)" };
@@ -1162,7 +1285,6 @@ __export(exports_stack, {
   installCodeGraph: () => installCodeGraph,
   installEngram: () => installEngram,
   installStack: () => installStack,
-  setupContext7: () => setupContext7,
   setupOpenSpec: () => setupOpenSpec,
   uninstallEngramConfig: () => uninstallEngramConfig,
   uninstallStackConfig: () => uninstallStackConfig,
@@ -1216,6 +1338,15 @@ function copyEngramPlugin(projectRoot) {
   mkdirSync4(pluginsDir, { recursive: true });
   copyFileSync3(pluginSource, join7(pluginsDir, "engram.ts"));
 }
+function copyOstackyControllerPlugin(projectRoot) {
+  const pluginSource = join7(PACKAGE_ROOT, "assets", "plugins", "ostacky-plugin.ts");
+  const pluginsDir = join7(projectRoot, ".opencode", "plugins");
+  if (!existsSync6(pluginSource)) {
+    throw new Error(`Plugin bundleado de OstackyController no encontrado: ${pluginSource}`);
+  }
+  mkdirSync4(pluginsDir, { recursive: true });
+  copyFileSync3(pluginSource, join7(pluginsDir, "ostacky-plugin.ts"));
+}
 function buildEngramDownloadUrl(tag, platform = process.platform, arch = process.arch) {
   const target = getEngramReleaseTarget(platform, arch);
   if (!target)
@@ -1439,6 +1570,7 @@ async function installEngram(toolsDir) {
   try {
     runTool(localBin, ["--version"], projectRoot, 1e4);
     copyEngramPlugin(projectRoot);
+    copyOstackyControllerPlugin(projectRoot);
     configureLocalTool(projectRoot, "engram", buildLocalMcpCommand(localBin, ["mcp"]));
   } catch (error) {
     return failAfterExtraction(`Engram fue instalado pero no se pudo verificar o configurar: ${error.message}`);
@@ -1446,44 +1578,15 @@ async function installEngram(toolsDir) {
   archivePromotion?.commit();
   return { success: true, message: "Engram instalado localmente y configurado para OpenCode (MCP + plugin)" };
 }
-function setupContext7(toolsDir) {
-  const location = resolveToolInstallLocation(toolsDir);
-  const { projectRoot } = location;
-  const ctx7ToolDir = join7(location.toolsDir, "context7");
-  if (!existsSync6(ctx7ToolDir))
-    mkdirSync4(ctx7ToolDir, { recursive: true });
-  try {
-    ensureMcpEntryAtProjectRoot(projectRoot, "context7", {
-      type: "remote",
-      url: "https://mcp.context7.com/mcp",
-      enabled: true
-    });
-  } catch (error) {
-    return { success: false, message: `No se pudo registrar Context7: ${error.message}` };
-  }
-  const useBun = isCommandAvailable("bun");
-  try {
-    const invocation = getCommandInvocation(useBun ? "bunx" : "npx", useBun ? ["ctx7", "setup", "--opencode"] : ["--yes", "ctx7", "setup", "--opencode"]);
-    execFileSync3(invocation.command, invocation.args, {
-      stdio: "pipe",
-      timeout: 60000,
-      cwd: projectRoot
-    });
-    return { success: true, message: "Context7 configurado (MCP + skill instalado)" };
-  } catch {
-    return {
-      success: true,
-      message: "Context7 MCP registrado (skill opcional no instalada — corrí `npx ctx7 setup --opencode` manualmente si la querés)"
-    };
-  }
-}
 async function installStack(toolsDir) {
   const { projectRoot } = resolveToolInstallLocation(toolsDir);
+  try {
+    copyOstackyControllerPlugin(projectRoot);
+  } catch {}
   return {
     codegraph: await installCodeGraph(toolsDir),
     openspec: setupOpenSpec(projectRoot),
     engram: await installEngram(toolsDir),
-    context7: setupContext7(toolsDir),
     config: patchOpenCodeConfig(projectRoot)
   };
 }
@@ -1518,7 +1621,7 @@ function uninstallStackConfig(paths) {
       const mcp = config.mcp;
       let changed = false;
       if (mcp) {
-        for (const name of ["codegraph", "context7", "engram"]) {
+        for (const name of ["codegraph", "engram", "context7"]) {
           if (name in mcp) {
             delete mcp[name];
             removed.push(`mcp.${name}`);
@@ -1588,7 +1691,7 @@ var init_stack = __esm(() => {
 // package.json
 var package_default = {
   name: "ostacky",
-  version: "0.7.4",
+  version: "0.8.1",
   description: "Instalador interactivo de agentes y comandos para OpenCode",
   type: "module",
   bin: {
@@ -2763,7 +2866,7 @@ async function probeMcpServer(nodeExecutable, serverPath, cwd, statePath, option
         params: {
           protocolVersion: "2025-03-26",
           capabilities: {},
-          clientInfo: { name: "ostacky-installer", version: "0.7.4" }
+          clientInfo: { name: "ostacky-installer", version: "0.8.1" }
         }
       });
     });
@@ -3072,12 +3175,13 @@ function uninstallAll(paths) {
   for (const name of Object.keys(lockfile.mcpServers ?? {})) {
     uninstallMcpServer(name, paths);
   }
-  if (existsSync5(paths.mcp)) {
-    for (const entry of readdirSync2(paths.mcp)) {
-      const dirPath = join6(paths.mcp, entry);
-      if (statSync2(dirPath).isDirectory()) {
-        uninstallMcpServer(entry, paths);
-      }
+  const ostackyPlugins = ["ostacky-plugin.ts", "engram.ts", "ostacky-guard.ts", "ostacky-controller.ts"];
+  for (const file of ostackyPlugins) {
+    const fp = join6(paths.plugins, file);
+    if (existsSync5(fp)) {
+      try {
+        unlinkSync2(fp);
+      } catch {}
     }
   }
   clearLockfile(paths.root);
@@ -3277,11 +3381,6 @@ async function doInstallStack(toolsDir, projectRoot) {
   spin.stop(eng.success ? `✓ ${eng.message}` : `✗ ${eng.message}`);
   if (!eng.success)
     allOk = false;
-  spin.start("Configurando Context7...");
-  const ctx = setupContext7(toolsDir);
-  spin.stop(ctx.success ? `✓ ${ctx.message}` : `✗ ${ctx.message}`);
-  if (!ctx.success)
-    allOk = false;
   spin.start("Verificando configuración...");
   const { patchOpenCodeConfig: patchOpenCodeConfig2 } = await Promise.resolve().then(() => (init_config(), exports_config));
   const cfg = patchOpenCodeConfig2(resolvedProjectRoot);
@@ -3298,9 +3397,9 @@ async function doInstallAll(manifest, paths) {
   let errors = 0;
   const isGlobal = isGlobalScope(paths);
   if (!isGlobal) {
-    ensureToolDirs(paths.tools, ["codegraph", "engram", "context7"]);
+    ensureToolDirs(paths.tools, ["codegraph", "engram"]);
   } else {
-    v2.info("Scope global detectado: el stack (CodeGraph/Engram) permanece siempre en <proyecto>/.opencode/tools — se omite instalación de stack global.");
+    v2.info("Scope global detectado: el stack (CodeGraph/Engram) y plugins (ostacky-controller, engram) permanecen siempre en <proyecto>/.opencode — se omite instalación de stack global.");
     v2.info("Para instalar el stack, ejecutá 'npx ostacky install-stack --scope local' dentro de cada proyecto.");
   }
   for (const agent of manifest.agents) {
@@ -3347,6 +3446,49 @@ async function doInstallAll(manifest, paths) {
       errors++;
     }
   }
+  try {
+    const { copyFileSync: copyFileSync4, mkdirSync: mkdirSync5, existsSync: existsSync8, rmSync: rmSync5 } = await import("fs");
+    const { join: join9 } = await import("path");
+    const { PACKAGE_ROOT: PACKAGE_ROOT2 } = await Promise.resolve().then(() => (init_github(), exports_github));
+    const { findProjectRoot: findProjectRoot3 } = await Promise.resolve().then(() => (init_fs(), exports_fs));
+    const src = join9(PACKAGE_ROOT2, "assets", "plugins", "ostacky-plugin.ts");
+    const dest = join9(paths.plugins, "ostacky-plugin.ts");
+    if (existsSync8(src)) {
+      mkdirSync5(paths.plugins, { recursive: true });
+      copyFileSync4(src, dest);
+    }
+    for (const legacy of ["ostacky-guard.ts", "ostacky-controller.ts"]) {
+      const lp = join9(paths.plugins, legacy);
+      if (existsSync8(lp))
+        try {
+          rmSync5(lp, { force: true });
+        } catch {}
+    }
+    const srcEng = join9(PACKAGE_ROOT2, "assets", "plugins", "engram.ts");
+    const destEng = join9(paths.plugins, "engram.ts");
+    if (existsSync8(srcEng)) {
+      mkdirSync5(paths.plugins, { recursive: true });
+      copyFileSync4(srcEng, destEng);
+    }
+    if (isGlobal) {
+      try {
+        const projRoot = findProjectRoot3();
+        const localPlugins = join9(projRoot, ".opencode", "plugins");
+        mkdirSync5(localPlugins, { recursive: true });
+        if (existsSync8(src))
+          copyFileSync4(src, join9(localPlugins, "ostacky-plugin.ts"));
+        if (existsSync8(srcEng))
+          copyFileSync4(srcEng, join9(localPlugins, "engram.ts"));
+        for (const legacy of ["ostacky-guard.ts", "ostacky-controller.ts"]) {
+          const lp = join9(localPlugins, legacy);
+          if (existsSync8(lp))
+            try {
+              rmSync5(lp, { force: true });
+            } catch {}
+        }
+      } catch {}
+    }
+  } catch {}
   let stackOk = true;
   let missingTools = [];
   if (isGlobal) {
@@ -3584,10 +3726,10 @@ async function doUninstallTotal(paths) {
   for (const name of Object.keys(lockfile.mcpServers ?? {})) {
     pathsToDelete.push(join9(paths.mcp, name));
   }
-  ye(pathsToDelete.join(`
-`), `Se eliminarán ${pathsToDelete.length} archivo(s) / directorio(s)`);
+  ye([`Scope: ${paths.root}`, ...pathsToDelete].join(`
+`), `Se eliminarán ${pathsToDelete.length} item(s) trackeados en lockfile (safe-delete)`);
   const confirm = await me({
-    message: `¿Confirmar desinstalación de ${pathsToDelete.length} item(s)?`
+    message: `¿Confirmar desinstalación de ${pathsToDelete.length} item(s) en ${paths.root}?`
   });
   onCancel(confirm);
   if (!confirm) {
@@ -3595,7 +3737,7 @@ async function doUninstallTotal(paths) {
     return;
   }
   uninstallAll(paths);
-  v2.success(`${pathsToDelete.length} item(s) eliminado(s).`);
+  v2.success(`${pathsToDelete.length} item(s) eliminado(s) + plugins Ostacky-owned limpiados.`);
   const cleanEngram = await me({
     message: "¿Deseas remover la configuración de Engram del proyecto (mcp.engram)?"
   });
@@ -3876,9 +4018,122 @@ async function doUninstallMcpByName(name, paths) {
   }
 }
 
+// src/opencode.ts
+init_fs();
+import { execSync, execFileSync as execFileSync4 } from "node:child_process";
+function isOpencodeInstalled() {
+  if (isCommandAvailable("opencode"))
+    return true;
+  try {
+    execFileSync4("opencode", ["--version"], { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function getOpencodeInstallCommand(platform = process.platform, _arch = process.arch) {
+  if (platform === "win32") {
+    return {
+      display: "npm install -g opencode-ai",
+      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."
+    };
+  }
+  if (platform === "darwin") {
+    return {
+      display: "curl -fsSL https://opencode.ai/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)"
+    };
+  }
+  return {
+    display: "curl -fsSL https://opencode.ai/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)"
+  };
+}
+async function ensureOpencodeInstalled() {
+  if (isOpencodeInstalled())
+    return;
+  const platform = process.platform;
+  const info = getOpencodeInstallCommand(platform);
+  v2.warn("OpenCode no detectado en este sistema.");
+  ye(`${info.display}
+Docs: https://opencode.ai/download${info.note ? `
+${info.note}` : ""}`, `Instalación requerida (${platform})`);
+  const shouldInstall = await me({
+    message: "Ostacky no funciona sin OpenCode. ¿Querés instalar OpenCode ahora?",
+    initialValue: true
+  });
+  if (BD(shouldInstall) || !shouldInstall) {
+    fe("Instalación cancelada. Instalá OpenCode manualmente y volvé a ejecutar: https://opencode.ai/download");
+    process.exit(1);
+  }
+  const spin = L2();
+  spin.start(`Instalando OpenCode (${info.display})...`);
+  try {
+    if (platform === "win32") {
+      execSync("npm install -g opencode-ai", { 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" });
+      } else {
+        execSync("curl -fsSL https://opencode.ai/install | bash", { stdio: "inherit", shell: "/bin/bash" });
+      }
+    }
+    spin.stop("Instalación ejecutada, verificando...");
+  } catch (e2) {
+    spin.stop("Fallo la instalación automática.");
+    const msg = e2.message ?? String(e2);
+    v2.error(`No se pudo instalar OpenCode automáticamente: ${msg}`);
+    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",
+        "Luego verificá: opencode --version",
+        "Docs: https://opencode.ai/download"
+      ].join(`
+`), "Acción manual requerida");
+    } else {
+      ye([
+        "Intentá manualmente:",
+        `  ${info.display}`,
+        "  npm install -g opencode-ai  (si no tenés curl)",
+        "  brew install anomalyco/tap/opencode  (macOS/Linux con brew)",
+        "Luego verificá: opencode --version",
+        "Docs: https://opencode.ai/download"
+      ].join(`
+`), "Acción manual requerida");
+    }
+    process.exit(1);
+  }
+  if (!isOpencodeInstalled()) {
+    v2.error("OpenCode aún no está disponible en el PATH después de la instalación.");
+    ye([
+      "Probá cerrar y reabrir la terminal y ejecutar:",
+      "  opencode --version",
+      "Si persiste, instalá manualmente:",
+      `  ${info.display}`,
+      "Docs: https://opencode.ai/download"
+    ].join(`
+`), "Verificación falló");
+    process.exit(1);
+  }
+  v2.success("OpenCode instalado correctamente ✓");
+}
+
 // src/prompts/index.ts
 async function runInteractiveMenu(scope) {
   we(" OpenCode Installer ");
+  await ensureOpencodeInstalled();
   const manifest = await loadManifest();
   const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
@@ -3893,7 +4148,7 @@ async function runInteractiveMenu(scope) {
       { value: "command", label: "Instalar command" },
       { value: "skill", label: "Instalar skill" },
       { value: "mcp", label: "Instalar MCP server" },
-      { value: "stack", label: "Instalar stack de herramientas (CodeGraph, Engram, Context7)" },
+      { value: "stack", label: "Instalar stack de herramientas (CodeGraph, Engram)" },
       { value: "update", label: "Actualizar instalación" },
       { value: "uninstall", label: "Desinstalar" },
       { value: "exit", label: "Salir" }
@@ -3934,7 +4189,7 @@ async function runInteractiveMenu(scope) {
         fe("Cancelado.");
         break;
       }
-      ensureToolDirs(paths.tools, ["codegraph", "engram", "context7"]);
+      ensureToolDirs(paths.tools, ["codegraph", "engram"]);
       const stackOk = await doInstallStack(paths.tools, dirname7(paths.root));
       if (!stackOk)
         process.exitCode = 1;
@@ -3958,6 +4213,7 @@ async function runInteractiveMenu(scope) {
 }
 async function runInstallCommand(scope) {
   we(" OpenCode Installer ");
+  await ensureOpencodeInstalled();
   const manifest = await loadManifest();
   const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
@@ -3971,6 +4227,7 @@ async function runInstallCommand(scope) {
 }
 async function runAddAgentCommand(scope) {
   we(" OpenCode Installer ");
+  await ensureOpencodeInstalled();
   const manifest = await loadManifest();
   const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
@@ -3983,6 +4240,7 @@ async function runAddAgentCommand(scope) {
 }
 async function runAddCommandCommand(scope) {
   we(" OpenCode Installer ");
+  await ensureOpencodeInstalled();
   const manifest = await loadManifest();
   const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
@@ -3995,6 +4253,7 @@ async function runAddCommandCommand(scope) {
 }
 async function runAddSkillCommand(scope) {
   we(" OpenCode Installer ");
+  await ensureOpencodeInstalled();
   const manifest = await loadManifest();
   const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
@@ -4007,6 +4266,7 @@ async function runAddSkillCommand(scope) {
 }
 async function runAddMcpCommand(scope) {
   we(" OpenCode Installer ");
+  await ensureOpencodeInstalled();
   const manifest = await loadManifest();
   const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
@@ -4018,6 +4278,7 @@ async function runAddMcpCommand(scope) {
   fe("Listo.");
 }
 async function runInstallStackCommand(scope) {
+  await ensureOpencodeInstalled();
   if (scope === "global") {
     v2.error("install-stack requiere scope local; el stack vive en <proyecto>/.opencode/tools");
     fe("Usá: npx ostacky install-stack --scope local");
@@ -4037,7 +4298,7 @@ async function runInstallStackCommand(scope) {
     process.exitCode = 1;
     return;
   }
-  ensureToolDirs(paths.tools, ["codegraph", "engram", "context7"]);
+  ensureToolDirs(paths.tools, ["codegraph", "engram"]);
   const stackOk = await doInstallStack(paths.tools, dirname7(paths.root));
   if (!stackOk)
     process.exitCode = 1;
@@ -4051,7 +4312,7 @@ async function runUninstallStackCommand(scope) {
     return;
   }
   const confirm = await me({
-    message: "¿Remover la configuración del stack (CodeGraph, Engram, Context7) del proyecto? Los binarios globales no se tocan."
+    message: "¿Remover la configuración del stack (CodeGraph, Engram) del proyecto? Los binarios globales no se tocan."
   });
   onCancel(confirm);
   if (!confirm) {
@@ -4069,6 +4330,7 @@ async function runUninstallStackCommand(scope) {
 }
 async function runUpdateCommand(scope) {
   we(" OpenCode Installer ");
+  await ensureOpencodeInstalled();
   const manifest = await loadLatestManifest();
   const paths = await resolveOpenCodePaths(scope ?? null);
   if (!paths) {
@@ -4232,18 +4494,18 @@ async function runUninstallMcpCommand(name, scope) {
 // src/cli.ts
 init_fs();
 import { existsSync as existsSync8, statSync as statSync3, readFileSync as readFileSync6, readdirSync as readdirSync3 } from "node:fs";
-import { join as join11, dirname as dirname8 } from "node:path";
+import { join as join10, dirname as dirname8 } from "node:path";
 var HELP = `
 ostacky — Instalador de agentes, comandos, skills y MCPs para OpenCode
 
 Uso:
   npx ostacky [--scope local|global|auto]                    Menú interactivo (instalación completa, pregunta local vs global, default local)
-  npx ostacky install [--scope local|global|auto]            Instalar TODO (agente + skills + MCPs + CodeGraph + OpenSpec + Engram + Context7)
+  npx ostacky install [--scope local|global|auto]            Instalar TODO (agente + skills + MCPs + CodeGraph + OpenSpec + Engram)
   npx ostacky add agent [--scope local|global|auto]          Agregar agente(s)
   npx ostacky add command [--scope ...]        Agregar command(s)
   npx ostacky add skill [--scope ...]          Agregar skill(s)
   npx ostacky add mcp [--scope ...]            Agregar MCP server(s)
-  npx ostacky install-stack [--scope local|auto]      Instalar solo el stack de herramientas (CodeGraph, OpenSpec, Engram, Context7) — global bloquea con error
+  npx ostacky install-stack [--scope local|auto]      Instalar solo el stack de herramientas (CodeGraph, OpenSpec, Engram) — global bloquea con error
   npx ostacky uninstall-stack [--scope local|global|auto]    Remover la configuración del stack del proyecto
   npx ostacky doctor                           Diagnostica locks, tools, state health
   npx ostacky status [--json]                  Muestra estado del controller sin MCP
@@ -4262,7 +4524,7 @@ Scope:
   --scope auto    Elige local si existe .opencode o .git, si no global
   Sin flag        Pregunta interactiva local (default) vs global
 `.trim();
-function parseScopeArg(argv = process.argv) {
+function parseScopeArg2(argv = process.argv) {
   for (let i = 0;i < argv.length; i++) {
     const arg = argv[i];
     if (arg === "--scope" && i + 1 < argv.length) {
@@ -4292,13 +4554,13 @@ function withoutScopeArgs(argv) {
   }
   return out;
 }
-var scope = parseScopeArg();
+var scope = parseScopeArg2();
 var argvNoScope = withoutScopeArgs(process.argv);
 var [, , cmd, subcmd] = argvNoScope;
 async function runDoctorCommand() {
   const cwd = process.cwd();
-  const opencodeDir = findOpenCodeDir(cwd) || join11(cwd, ".opencode");
-  const statePath = join11(opencodeDir, "ostacky-state.json");
+  const opencodeDir = findOpenCodeDir(cwd) || join10(cwd, ".opencode");
+  const statePath = join10(opencodeDir, "ostacky-state.json");
   let hasError = false;
   let hasWarn = false;
   const check = (label, ok, warn = false) => {
@@ -4312,14 +4574,30 @@ async function runDoctorCommand() {
       hasError = true;
     }
   };
+  const pluginPaths = [
+    join10(cwd, "assets", "plugins", "ostacky-plugin.ts"),
+    join10(opencodeDir, "plugins", "ostacky-plugin.ts"),
+    join10(cwd, ".opencode", "plugins", "ostacky-plugin.ts"),
+    join10(cwd, "assets", "plugins", "ostacky-controller.ts"),
+    join10(opencodeDir, "plugins", "ostacky-controller.ts"),
+    join10(cwd, ".opencode", "plugins", "ostacky-controller.ts")
+  ];
+  const pluginActive = pluginPaths.some((p2) => existsSync8(p2));
   try {
     if (!existsSync8(statePath)) {
-      check("controller: state file missing", false, true);
+      if (pluginActive)
+        console.log(`✅ controller: plugin active (no state yet)`);
+      else
+        check("controller: state file missing", false, true);
     } else {
       const stat = statSync3(statePath);
       const raw = readFileSync6(statePath, "utf-8");
       const parsed = JSON.parse(raw);
-      check(`controller: OK (rev ${parsed.revision || 0} state ${parsed.state || "unknown"})`, true);
+      if (pluginActive) {
+        console.log(`✅ controller: plugin active (rev ${parsed.revision || 0} state ${parsed.state || "unknown"})`);
+      } else {
+        check(`controller: OK (rev ${parsed.revision || 0} state ${parsed.state || "unknown"})`, true);
+      }
       if (parsed.degraded) {
         console.log("⚠️ degraded: true (persistido)");
         hasWarn = true;
@@ -4375,8 +4653,8 @@ async function runDoctorCommand() {
     check(`controller: ${e2.message}`, false);
   }
   try {
-    const lockPid = join11(opencodeDir, "ostacky-state.json.lock.pid");
-    const lockTs = join11(opencodeDir, "ostacky-state.json.lock.timestamp");
+    const lockPid = join10(opencodeDir, "ostacky-state.json.lock.pid");
+    const lockTs = join10(opencodeDir, "ostacky-state.json.lock.timestamp");
     if (existsSync8(lockPid) || existsSync8(lockTs)) {
       let ageStr = "";
       try {
@@ -4401,15 +4679,15 @@ async function runDoctorCommand() {
   }
   const tools = ["codegraph", "engram"];
   for (const t of tools) {
-    const p2 = join11(opencodeDir, "tools", t, "bin", t);
+    const p2 = join10(opencodeDir, "tools", t, "bin", t);
     const pExe = p2 + ".exe";
     check(`tool ${t}: ${existsSync8(p2) || existsSync8(pExe) ? "found" : "missing"}`, existsSync8(p2) || existsSync8(pExe), true);
   }
   try {
-    const manifest = JSON.parse(readFileSync6(join11(cwd, "manifest.json"), "utf-8"));
+    const manifest = JSON.parse(readFileSync6(join10(cwd, "manifest.json"), "utf-8"));
     const expected = manifest.mcpServers?.find((x2) => x2.name === "ostacky-controller")?.sha256;
     if (expected) {
-      const actual = computeTreeHash(join11(cwd, "assets", "mcp", "ostacky-controller"));
+      const actual = computeTreeHash(join10(cwd, "assets", "mcp", "ostacky-controller"));
       check(`manifest hash: ${expected.slice(0, 8)} vs actual ${actual.slice(0, 8)}`, expected === actual);
       if (expected !== actual)
         console.log("  Run: bun run hash:update");
@@ -4424,7 +4702,7 @@ async function runDoctorCommand() {
     } catch {}
   }
   try {
-    const cacheDir = join11(opencodeDir, "cache", "codegraph");
+    const cacheDir = join10(opencodeDir, "cache", "codegraph");
     if (!existsSync8(cacheDir)) {
       console.log("ℹ️ cache: no cache dir yet (ok)");
     } else {
@@ -4432,7 +4710,7 @@ async function runDoctorCommand() {
       let total = 0;
       for (const f2 of files) {
         try {
-          total += statSync3(join11(cacheDir, f2)).size;
+          total += statSync3(join10(cacheDir, f2)).size;
         } catch {}
       }
       const totalMB = (total / 1048576).toFixed(2);
@@ -4453,7 +4731,7 @@ async function runDoctorCommand() {
     console.log(`⚠️ cache: check failed ${e2.message}`);
   }
   try {
-    const secPath = join11(cwd, "src", "security.ts");
+    const secPath = join10(cwd, "src", "security.ts");
     if (!existsSync8(secPath)) {
       console.log("⚠️ src/security.ts: missing (source-of-truth)");
       hasWarn = true;
@@ -4485,8 +4763,8 @@ async function runDoctorCommand() {
 async function runStatusCommand(args) {
   const isJson = args.includes("--json");
   const cwd = process.cwd();
-  const opencodeDir = findOpenCodeDir(cwd) || join11(cwd, ".opencode");
-  const statePath = join11(opencodeDir, "ostacky-state.json");
+  const opencodeDir = findOpenCodeDir(cwd) || join10(cwd, ".opencode");
+  const statePath = join10(opencodeDir, "ostacky-state.json");
   if (!existsSync8(statePath)) {
     console.log(isJson ? JSON.stringify({ error: "no state" }) : "No state file");
     return;
@@ -4509,6 +4787,10 @@ async function runStatusCommand(args) {
   }
 }
 async function main() {
+  const needsOpencode = !cmd || cmd === "install" || cmd === "install-stack" || cmd === "update" || cmd === "add" && ["agent", "command", "skill", "mcp"].includes(subcmd ?? "");
+  if (needsOpencode) {
+    await ensureOpencodeInstalled();
+  }
   switch (cmd) {
     case "install":
       await runInstallCommand(scope);