ostacky 0.10.1 → 0.10.2

package/README.md

@@ -129,9 +129,9 @@ Local (`<proyecto>/.opencode`) o global (mismo árbol bajo el dir global, sin st
 
 ```json
 {
-    "version": "0.10.1",
-    "tag": "v0.10.1",
-    "agents": { "ostacky": { "version": "0.10.1", "sha256": "…" } },
+    "version": "0.10.2",
+    "tag": "v0.10.2",
+    "agents": { "ostacky": { "version": "0.10.2", "sha256": "…" } },
     "commands": { "install-stack": { … }, "opsx-sync": { … } },
     "skills": { "brainstorming": { … }, "…" : {} },
     "mcpServers": { "ostacky-controller": { … }, "openspec": { … } }

package/assets/agents/ostacky.md

@@ -1,17 +1,17 @@
 ---
 description: Orquestador principal — rutea por nivel, orquesta CodeGraph + OpenSpec + Superpowers.
 mode: primary
-version: 0.10.1
+version: 0.10.2
 ---
 
-Sos **Ostacky v0.10.1**, orquestás, no implementás. Interpretás, clasificás (0/0+1/1+), ruteás y coordinás.
+Sos **Ostacky v0.10.2**, orquestás, no implementás. Interpretás, clasificás (0/0+1/1+), ruteás y coordinás.
 
-> **Versión:** `0.10.1` (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.10.1"** (o `v0.10.1` si te piden solo el número). No inventes otra versión.
+> **Versión:** `0.10.2` (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.10.2"** (o `v0.10.2` si te piden solo el número). No inventes otra versión.
 
 ## Reglas innegociables
 
 1. **NUNCA te congeles.** Plan B antes de tool, no reintentes fallida.
-2. **CodeGraph primero.** Nunca `rg/grep` para código. `Grep` solo literales.
+2. **CodeGraph primero ante query de símbolo/flujo/impacto** (¿quién llama a X?, blast radius, dónde vive un símbolo). Grep/glob directo es legítimo ante query de literal (string exacto, TODO, config, `.md`/`.json`) — pero el gate SIEMPRE exige un `codegraph_codegraph_explore` completado antes de leer código (`shouldBlockCodeRead`). Para leer código no-indexable a conciencia, el explore previo es calibración, no sobrehead: barato, local y confirma que el índice está vivo.
 3. **El plugin hace cumplir PENDING.** Hard gate en `ctx.tool.hook("execute.before")`; no llames `check_*` manual.
 4. **No edites sin Read fresco.** Nunca cache de turno anterior.
 5. **Una pregunta por turno.** Natural, sin tool, STOP y esperar. Respuesta vinculante.
@@ -97,6 +97,7 @@ Router `brainstorming`↔`OpenSpec` por `level`/`estLines`/`fileCount`/`hasAPI`
 ## Guardrails
 
 - Decisión en OpenSpec/CodeGraph/controller → no re-resolver
+- **Multi-sesión (un state file por proyecto):** si `start_request` devuelve `conflict:true` o un tool devuelve `BLOCKED: … pertenece a otra sesión`, NO re-presentes el resumen de ejecución ni consumas/bloquees esa decisión. Preguntá una sola cosa: takeover explícito (`start_request({force:true})`, auditado) o continuar en la otra sesión. Si `get_state` muestra `callerSessionId:null` con `ownerSessionId` no nulo, tratá la request como ajena (no hay identidad que pruebe lo contrario).
 - Una pregunta por turno, sin deadlock
 - Fase gate: en EXECUTING/SYNC no volver a DISCOVERY
 - Audit: log antes de gate + `mem_save` solo en gates

package/assets/commands/install-stack.md

@@ -6,7 +6,7 @@ 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.10.1, `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.10.2, `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.
 

package/assets/docs/ostacky-reference.md

@@ -114,3 +114,11 @@ Principio: **eficacia > recorte** — si recorte rompiera caché y saliera más
 ## Propose Flow (1+)
 
 `openspec-propose` SHALL Paso 0: `codegraph_codegraph_explore` + `engram_mem_search` sobre el área (si no se hicieron ya en el request) **antes** de `openspec new`. Citá símbolos existentes en `proposal/design`; sin esto dispara `WARN:codegraphBypass` y `design.md` alucina API. Ver `assets/skills/openspec-propose/SKILL.md: Paso 0` y `brainstorming` (router por nivel: `brainstorming` decide 0/0+1/1+, `openspec-explore` es stance sin nivel).
+
+## CI — openspec validate (remediación)
+
+El job `test` de `.github/workflows/ci.yml` corre `bunx openspec validate --all --strict` (dep pinneada en `package.json`). Si falla en `main`: un delta/spec inválido entró — NO archivearlo roto ni hacer workaround. Protocolo:
+1. El output lista el item roto (`✗ change/<id>` / `✗ spec/<name>`) + `Details: openspec validate <id> --type change|spec` — ese comando da la causa exacta y los next steps (el CLI es autoexplicativo: headers `## ADDED/MODIFIED/REMOVED/RENAMED Requirements`, cada requirement con al menos un `#### Scenario:`).
+2. Debug de deltas parseados: `openspec show <id> --json --deltas-only`.
+3. Change WIP incompleto en `main` → completarlo o removerlo del repo; specs de `openspec/specs/` rotos → fixear el formato in-place.
+4. Si tocás `assets/` regenerá hashes (`bun run scripts/update-manifest-hashes.ts`) y usá `bun run test:safe` (nunca `bun test` full: se cuelga).

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

@@ -1169,6 +1169,28 @@ class OstackyController {
         };
     }
 
+    /**
+     * multisession-ownership-guard: la request activa es de UNA sesión.
+     * Si el caller es conocido y difiere del dueño, la mutación se rechaza
+     * (consumir/cancelar/refrescar la decisión de otro invalidaba su resumen
+     * y forzaba a re-presentarlo). Sin identidad (clientes legacy sin `_meta`)
+     * o sin dueño, no aplica: comportamiento previo intacto.
+     */
+    async #foreignOwnerError(via) {
+        const owner = this.#state?.ownerSessionId ?? null;
+        const caller = this.#callerSessionId ?? null;
+        if (!owner || !caller || owner === caller) return null;
+        await this.#audit(
+            'WARN',
+            'cross_session_denied',
+            `${via}: caller=${caller} owner=${owner} state=${this.#state?.state}`
+        );
+        return this.#makeError(
+            `BLOCKED: la request activa pertenece a otra sesión (owner=${owner}). No consumas, refresques ni canceles su decisión; usá start_request({force:true}) para takeover explícito o esperá a que termine.`,
+            via
+        );
+    }
+
     #suggestRecovery(state, transition) {
         const suggestions = {
             INTERPRETATION_PENDING: 'Call start_request or proceed_to_discovery first.',
@@ -1558,6 +1580,8 @@ class OstackyController {
 
     async abandon({ reason } = {}) {
         this.#load();
+        const denied = await this.#foreignOwnerError('abandon');
+        if (denied) return denied;
         const to = this.#isAllowedTransition(this.#state.state, 'abandon');
         if (!to) return this.#makeError(`Cannot abandon from state ${this.#state.state}`, 'abandon');
         await this.#transition(to, { error: reason || 'Abandoned' });
@@ -1567,6 +1591,8 @@ class OstackyController {
 
     async consumeRouteDecision({ decisionId, choice } = {}) {
         this.#load();
+        const denied = await this.#foreignOwnerError('consume_route_decision');
+        if (denied) return denied;
         if (choice && !['SPEC', 'DIRECT'].includes(choice)) {
             return { error: `invalid choice: ${choice}`, available: ['SPEC', 'DIRECT'] };
         }
@@ -1906,6 +1932,8 @@ class OstackyController {
 
     async consumeExecutionDecision({ decisionId, mode } = {}) {
         this.#load();
+        const denied = await this.#foreignOwnerError('consume_execution_decision');
+        if (denied) return denied;
         if (mode && !['INLINE', 'SUBAGENT_DRIVEN'].includes(mode)) {
             return { error: `invalid mode: ${mode}`, available: ['INLINE', 'SUBAGENT_DRIVEN'] };
         }
@@ -1944,6 +1972,8 @@ class OstackyController {
      */
     async refreshDecision() {
         this.#load();
+        const denied = await this.#foreignOwnerError('refresh_decision');
+        if (denied) return denied;
         const s = this.#state.state;
         const prevFails = this.#state.consumeFailedCount || 0;
         if (s === 'ROUTE_DECISION_PENDING') {
@@ -2150,6 +2180,8 @@ class OstackyController {
 
     async block({ reason } = {}) {
         this.#load();
+        const denied = await this.#foreignOwnerError('block');
+        if (denied) return denied;
         const from = this.#state.state;
         const to = this.#isAllowedTransition(this.#state.state, 'block');
         if (!to) return this.#makeError(`Cannot block from state ${this.#state.state}`, 'block');
@@ -2855,6 +2887,8 @@ class OstackyController {
      */
     async completeTask({ taskId, filePath, fileHash } = {}) {
         this.#load();
+        const denied = await this.#foreignOwnerError('complete_task');
+        if (denied) return denied;
         if (this.#state.state !== 'EXECUTING_INLINE' && this.#state.state !== 'EXECUTING_SUBAGENTS') {
             return this.#makeError(`Cannot complete task from state ${this.#state.state}`, 'complete_task');
         }
@@ -3332,7 +3366,7 @@ function safeHandler(fn, options = {}) {
 
 const server = new McpServer({
     name: 'ostacky-controller',
-    version: '0.10.1',
+    version: '0.10.2',
 });
 
 server.registerTool(
@@ -3934,7 +3968,7 @@ function setupGracefulShutdown(ctrl) {
 }
 
 async function main() {
-    log('Starting ostacky-controller MCP v0.10.1...');
+    log('Starting ostacky-controller MCP v0.10.2...');
     log('State path:', { path: statePath });
     // Clean up stale tmp/lock files from previous runs
     cleanupTmpFiles(statePath);

package/assets/plugins/ostacky-controller/index.ts

@@ -152,6 +152,34 @@ export function mergePluginOwnedState(fresh: any, state: any, ownedKeys: string[
   return payload
 }
 
+/**
+ * multisession-ownership-guard: hay UN state file por proyecto, así que el PENDING
+ * puede ser de otra sesión. El gate no debe congelar sesiones ajenas a esa request
+ * (antes, cualquier sesión quedaba bloqueada por la confirmación pendiente de otra).
+ *
+ * No aplica cuando no hay dueño (estado legacy), cuando el caller es el dueño, ni
+ * cuando el caller es desconocido (`event.sessionID` ausente → "default"): sin
+ * identidad no se puede probar ajeneidad.
+ */
+export function isForeignPendingOwner(state: any, sessionId: string | null | undefined): boolean {
+  const owner = state?.ownerSessionId
+  if (!owner || !sessionId || sessionId === "default") return false
+  return owner !== sessionId
+}
+
+/**
+ * Cache del gate PENDING. El cache es por `revision`, NO por dueño: si el paso de
+ * una sesión ajena dejara un ALLOW, la dueña lo reutilizaría y se saltearía su
+ * propia confirmación. Por eso un PENDING ajeno no cachea nada.
+ */
+export function nextPendingGateCache(
+  revision: number,
+  foreignPendingOwner: boolean
+): { revision: number; result: string } | null {
+  if (foreignPendingOwner) return null
+  return { revision, result: "ALLOW" }
+}
+
 /**
  * Persiste estado SIN poder pisar al MCP.
  *
@@ -297,6 +325,20 @@ export function marksDiscovery(toolName: string): boolean {
   )
 }
 
+/**
+ * Predicado puro del horizonte del gate de discovery: ¿este prompt invalida el
+ * hit estructural de la sesión?
+ *
+ * El contrato de reuso es POR REQUEST ("reuso del output ya obtenido en el request",
+ * remove-discovery-cache-phantom archivado 2026-10-19), no por sesión: la instrucción
+ * §1 del agente y record_discovery son por request; el gate era el único desalineado.
+ * Los prompts TRIVIALES no invalidan: el plugin les inyecta "No hagas Discovery"
+ * (hint :555) — limpiar el hit ahí crearía instrucción y gate contradictorias.
+ */
+export function shouldInvalidateDiscoveryHit(trivial: boolean): boolean {
+  return !trivial
+}
+
 /**
  * Mismo criterio de "archivo de código" que el gate de read (index.ts:552),
  * sin la cláusula de `pattern` que es específica de glob. Docs/JSON quedan fuera:
@@ -550,6 +592,10 @@ export default {
       const currentState = state?.state ?? "DONE"
       const trivial = isTrivial(text, currentState)
       trivialBySession.set(sessionId, trivial)
+      // Horizonte por request: prompts NO-triviales invalidan el discovery hit —
+      // la siguiente lectura de código exige un explore fresco (contrato
+      // remove-discovery-cache-phantom + instrucción §1 del agente).
+      if (shouldInvalidateDiscoveryHit(trivial)) discoveryHitByRequest.delete(sessionId)
       if (trivial) {
         // Preserve system FULL cacheable, add suffix hint to user prompt text
         const hint = "\n\n[PLUGIN HINT: Saludo trivial — responde breve sin tools. No hagas Discovery.]"
@@ -606,7 +652,9 @@ export default {
       checkCount++
       const freshState = readState(directory)
       const pendingStates = ["ROUTE_DECISION_PENDING", "EXECUTION_DECISION_PENDING", "CLARIFICATION_PENDING"]
-      if (freshState && pendingStates.includes(freshState.state)) {
+      // multisession-ownership-guard: el PENDING de OTRA sesión no congela esta sesión.
+      const foreignPendingOwner = !!freshState && isForeignPendingOwner(freshState, sessionId)
+      if (freshState && pendingStates.includes(freshState.state) && !foreignPendingOwner) {
         // cache ALLOW per revision, BLOCKED never cached
         if (lastCheck && freshState.revision === lastCheck.revision && checkCount % 5 !== 0 && lastCheck.result === "ALLOW") {
           // reuse cached ALLOW
@@ -628,7 +676,7 @@ export default {
           }
         }
       } else if (freshState) {
-        lastCheck = { revision: freshState.revision, result: "ALLOW" }
+        lastCheck = nextPendingGateCache(freshState.revision, foreignPendingOwner)
       }
 
       // ── 1.6) Engram soft gate (auditable, no BLOCK) — refuerza SHALL 1 de ostacky.md ──
@@ -728,12 +776,22 @@ export default {
         const gated = isCodeReadGated({ isCodeFile, isLiteralGrep, isSpecTasksPath, isDocsPath, isTaskTracked })
         const codegraphOk = gated ? isCodegraphAvailable(directory) : false
         // Sin fallback a disco: la única evidencia válida es un codegraph_explore
-        // COMPLETADO en esta sesión (discoveryHitByRequest). El memo se limpia con
-        // session.deleted, así "esta sesión" es literal.
+        // COMPLETADO en este request (discoveryHitByRequest; el hook "prompt"
+        // invalida el hit en cada prompt no-trivial). session.deleted también lo limpia.
         const hasDiscoveryHit = codegraphOk ? discoveryHitByRequest.get(sessionId) === true : false
         if (shouldBlockCodeRead({
           isCodeFile, isLiteralGrep, isSpecTasksPath, isDocsPath, isTaskTracked, codegraphOk, hasDiscoveryHit,
         })) {
+          // Métrica de evasión real (misma convención que engramBypassCount:648):
+          // cuántas lecturas de código saltaron el gate sin explore completado.
+          try {
+            const st = readState(directory)
+            if (st) {
+              st.codeReadBlockedCount = (st.codeReadBlockedCount || 0) + 1
+              persistState(directory, st, ["codeReadBlockedCount"])
+            }
+          } catch {}
+          try { console.warn(`[ostacky] code_read_blocked: sin codegraph_explore completado en sesión (${targetPath || "query"})`) } catch {}
           throw new Error(
             `BLOCKED: sin discovery estructural en esta sesión — llamá codegraph_codegraph_explore("${targetPath || "query"}") antes de Read/Grep/Glob de código`
           )
@@ -952,9 +1010,10 @@ export default {
       // Track discovery hit to allow subsequent Reads
       const tool: string = event.tool as string
       const sessionId: string = (event.sessionID ?? "default") as string
-      // (fix-codegraph-gate) Evidencia REAL de discovery: un `codegraph_explore` completado en ESTA
-      // sesión abre el gate de lecturas de código. Se marca aunque el resultado venga vacío, a
-      // propósito: "CodeGraph no tiene este archivo en su índice" es justamente el caso donde el
+      // (fix-codegraph-gate) Evidencia REAL de discovery: un `codegraph_explore` completado en ESTE
+      // request abre el gate de lecturas de código (el hook "prompt" invalida el hit en cada
+      // prompt no-trivial). Se marca aunque el resultado venga vacío, a propósito:
+      // "CodeGraph no tiene este archivo en su índice" es justamente el caso donde el
       // Read TIENE que poder pasar si hubo `codegraph_explore`.
       if (marksDiscovery(tool)) {
         try {

package/dist/cli.js

@@ -641,31 +641,31 @@ var init_fs = __esm(() => {
 var manifest_default;
 var init_manifest = __esm(() => {
   manifest_default = {
-    version: "0.10.1",
+    version: "0.10.2",
     repo: "JaimeHoracio/Ostacky",
-    tag: "v0.10.1",
+    tag: "v0.10.2",
     agents: [
       {
         name: "ostacky",
         file: "assets/agents/ostacky.md",
-        description: "Orquestador con recuperación automática (nunca se congela), ruteo por nivel de impacto, controller MCP con SDK oficial, edición segura con fallback inline, y delegación en OpenSpec + Superpowers. v0.10.1: prune de skills obsoletas, lastHandoff, getAvailableTransitions, consecutiveFailures real, mem_session_summary automático al cierre.",
-        version: "0.10.1",
-        sha256: "f82687e38d1ad2e88cce1e962299c9bd8b9265d53fe3c7997114efddb39898b3"
+        description: "Orquestador con recuperación automática (nunca se congela), ruteo por nivel de impacto, controller MCP con SDK oficial, edición segura con fallback inline, y delegación en OpenSpec + Superpowers. v0.10.2: prune de skills obsoletas, lastHandoff, getAvailableTransitions, consecutiveFailures real, mem_session_summary automático al cierre.",
+        version: "0.10.2",
+        sha256: "b3db2a27d7b8249b4552d4f63353d893ec1b8c2abda44f375de65cd1d4364419"
       }
     ],
     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.10.1: controller plugin como alma hard-gate, Context7 removido del stack.",
-        version: "0.10.1",
-        sha256: "07e70cbaec57e27b5984e4a693486e34a8f52585b1183da7dd88c5dd69c7c8d5"
+        description: "Instala el stack tecnológico del proyecto (CodeGraph, skills, OpenSpec, Engram, controller plugin). v0.10.2: controller plugin como alma hard-gate, Context7 removido del stack.",
+        version: "0.10.2",
+        sha256: "b4845d7b6306b1a8c4914a4cf5a4390a4d3e79f1226de72b0ef2e95157c1f58e"
       },
       {
         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.10.1",
+        version: "0.10.2",
         sha256: "f883f9ad96f7d75778631d5cc13d8a1a9c3e6ec41396bbce8ce13cff2e66fca2"
       }
     ],
@@ -673,15 +673,15 @@ var init_manifest = __esm(() => {
       {
         name: "ostacky-controller",
         file: "assets/mcp/ostacky-controller/",
-        description: "Máquina de estados persistida con @modelcontextprotocol/server SDK. v0.10.1: 22 tools (incluye set_handoff, get_handoff, clear_handoff, get_available_transitions funcional). Bugfixes: consecutiveFailures real, lastHandoff state, defaultChoice persistido. Robustez: degraded mode automático tras 3 fallos, persistence condicional para Nivel 0, prune de skills obsoletas.",
-        version: "0.10.1",
-        sha256: "d10efacd03f72f5fa1cca0abb22046a9862de7e98f635308f6898c5cbd67407e"
+        description: "Máquina de estados persistida con @modelcontextprotocol/server SDK. v0.10.2: 22 tools (incluye set_handoff, get_handoff, clear_handoff, get_available_transitions funcional). Bugfixes: consecutiveFailures real, lastHandoff state, defaultChoice persistido. Robustez: degraded mode automático tras 3 fallos, persistence condicional para Nivel 0, prune de skills obsoletas.",
+        version: "0.10.2",
+        sha256: "c78d2a8f7ce87d373cbac9135235ef1c90f45380fafc4135fe22c2b55c4423b6"
       },
       {
         name: "openspec",
         file: "assets/mcp/openspec/",
         description: "MCP server local para OpenSpec - proposal, apply, archive, sync de cambios",
-        version: "0.10.1",
+        version: "0.10.2",
         sha256: "bdb283fe8ec2dfcba2ec4f38191f4039e58cd7ae12e44e66310783b42c827638"
       }
     ],
@@ -690,105 +690,105 @@ var init_manifest = __esm(() => {
         name: "brainstorming",
         file: "assets/skills/brainstorming/SKILL.md",
         description: "Skill unificado de pensamiento con dos modos: creative-design (producción de diseño → transición a implementación directa o openspec-propose) y open-exploration (exploración libre)",
-        version: "0.10.1",
+        version: "0.10.2",
         sha256: "ba76eff6fb5bea08d3b26622089ea4739b7b542b3677a46071b2576f3f2001c7"
       },
       {
         name: "execution-mode-evaluation",
         file: "assets/skills/execution-mode-evaluation/SKILL.md",
         description: "Skill de análisis de modo de ejecución — output reconciliado con controller snapshot contract (recommendation field)",
-        version: "0.10.1",
+        version: "0.10.2",
         sha256: "9090132ccfe31dcf34b6d5f399c1135dcb1044c504d4beb026e0c7d9e09e7c0d"
       },
       {
         name: "tdd",
         file: "assets/skills/tdd/SKILL.md",
         description: "Skill de test-driven development (Superpowers)",
-        version: "0.10.1",
+        version: "0.10.2",
         sha256: "cce54e81cce46ba973066f9b43e74994a7dbf21aa756146c27689241cf62704d"
       },
       {
         name: "subagent-driven-development",
         file: "assets/skills/subagent-driven-development/SKILL.md",
         description: "Skill de ejecución con subagentes (Superpowers) — ejecuta solo después de confirmación del coordinador Ostacky",
-        version: "0.10.1",
+        version: "0.10.2",
         sha256: "1a42d714a9a13faf05f0bf7b580e8d837c2e77a5633839542ccce603023419e8"
       },
       {
         name: "dispatching-parallel-agents",
         file: "assets/skills/dispatching-parallel-agents/SKILL.md",
         description: "Skill de dispatch paralelo de agentes (Superpowers)",
-        version: "0.10.1",
+        version: "0.10.2",
         sha256: "7e7b712ef742d5631e302e6a71583e2bbbd33094da9281abfb84b43505fc3ef1"
       },
       {
         name: "review",
         file: "assets/skills/review/SKILL.md",
         description: "Skill de revisión de código (Superpowers)",
-        version: "0.10.1",
+        version: "0.10.2",
         sha256: "b19650ed4d1d4d9857a4dd5b7e08e91328a1a1fc9c45bcc2fb600fa9d0213279"
       },
       {
         name: "receiving-code-review",
         file: "assets/skills/receiving-code-review/SKILL.md",
         description: "Skill de recibir y procesar feedback de code review",
-        version: "0.10.1",
+        version: "0.10.2",
         sha256: "d761e884e71d8d3476ac734d287cae403a4024506a7d12e7361a448217c0a831"
       },
       {
         name: "openspec-propose",
         file: "assets/skills/openspec-propose/SKILL.md",
         description: "Skill de generación de proposal (OpenSpec)",
-        version: "0.10.1",
+        version: "0.10.2",
         sha256: "9049b944cea88a5428fd5d77b411a0ed32d169ad68acda911b68365fac08f38f"
       },
       {
         name: "openspec-apply-change",
         file: "assets/skills/openspec-apply-change/SKILL.md",
         description: "Skill de aplicación de change (OpenSpec)",
-        version: "0.10.1",
+        version: "0.10.2",
         sha256: "dfc823bf89fc7505e91ab6dee9c1f004be38a410bd3d88fb67b211b1b6cbb1d0"
       },
       {
         name: "openspec-archive-change",
         file: "assets/skills/openspec-archive-change/SKILL.md",
         description: "Skill de archivo de change (OpenSpec)",
-        version: "0.10.1",
+        version: "0.10.2",
         sha256: "16e4b561de7747283663fed602e506abf502452c49a8d4b86d7a5539c40f0195"
       },
       {
         name: "openspec-explore",
         file: "assets/skills/openspec-explore/SKILL.md",
         description: "Modo explore para OpenSpec — thinking partner para explorar ideas, investigar problemas y clarificar requisitos antes/durante un cambio",
-        version: "0.10.1",
+        version: "0.10.2",
         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.10.1",
+        version: "0.10.2",
         sha256: "93341bc1b7c053618a8b6dc07e3615b77990d7b549a0201f5835d95fef67ce13"
       },
       {
         name: "using-superpowers",
         file: "assets/skills/using-superpowers/SKILL.md",
         description: "Skill de orquestación de Superpowers skills",
-        version: "0.10.1",
+        version: "0.10.2",
         sha256: "7e54536f96d2a379185a10bfc1e970850caa2561b6d8aca7080f0defea0381a4"
       },
       {
         name: "writing-skills",
         file: "assets/skills/writing-skills/SKILL.md",
         description: "Skill de creación y edición de skills",
-        version: "0.10.1",
+        version: "0.10.2",
         sha256: "3d76b906cee518a2b809febb70db95697a35b9f368986bb504b4120c3bfb437a"
       },
       {
         name: "graceful-degradation",
         file: "assets/skills/graceful-degradation/SKILL.md",
         description: "Skill de degradación graceful cuando múltiples tools están indisponibles",
-        version: "0.10.1",
+        version: "0.10.2",
         sha256: "363449bd9e6f800a0a3168667cf78f767fb105d86e4a4adadcc649d418139303"
       }
     ]
@@ -1337,13 +1337,16 @@ async function installCodeGraph(toolsDir) {
     message: indexWarning ? `CodeGraph instalado y configurado para OpenCode. ${indexWarning}` : "CodeGraph instalado localmente y configurado para OpenCode"
   };
 }
-function setupOpenSpec(projectRoot = findProjectRoot()) {
-  const useBun = isCommandAvailable("bun");
+function setupOpenSpec(projectRoot = findProjectRoot(), deps = {}) {
+  const execFile = deps.execFileSync ?? execFileSync3;
+  const isAvailable = deps.isCommandAvailable ?? isCommandAvailable;
+  const invocationFor = deps.getCommandInvocation ?? getCommandInvocation;
+  const useBun = isAvailable("bun");
   const fail = (msg) => ({ success: false, message: msg });
   const tryDirect = () => {
     try {
-      const invocation = getCommandInvocation(useBun ? "bunx" : "npx", useBun ? [OPENSPEC_NPM_PACKAGE, "init", "--tools", "opencode", "--force"] : ["--yes", OPENSPEC_NPM_PACKAGE, "init", "--tools", "opencode", "--force"]);
-      execFileSync3(invocation.command, invocation.args, {
+      const invocation = invocationFor(useBun ? "bunx" : "npx", useBun ? [OPENSPEC_NPM_PACKAGE, "init", "--tools", "opencode", "--force"] : ["--yes", OPENSPEC_NPM_PACKAGE, "init", "--tools", "opencode", "--force"]);
+      execFile(invocation.command, invocation.args, {
         stdio: "pipe",
         timeout: 120000,
         cwd: projectRoot
@@ -1354,20 +1357,20 @@ function setupOpenSpec(projectRoot = findProjectRoot()) {
     }
   };
   const tryInstallGlobal = () => {
-    if (!useBun && !isCommandAvailable("npm")) {
+    if (!useBun && !isAvailable("npm")) {
       return { ok: false, error: "Ni bun ni npm están disponibles para instalar OpenSpec globalmente" };
     }
     const pkgManager = useBun ? "bun" : "npm";
     const installArgs = useBun ? ["add", "-g", OPENSPEC_NPM_PACKAGE] : ["install", "-g", OPENSPEC_NPM_PACKAGE];
     try {
-      const invocation = getCommandInvocation(pkgManager, installArgs);
-      execFileSync3(invocation.command, invocation.args, { stdio: "pipe", timeout: 120000 });
+      const invocation = invocationFor(pkgManager, installArgs);
+      execFile(invocation.command, invocation.args, { stdio: "pipe", timeout: 120000 });
     } catch (installErr) {
       return { ok: false, error: `Instalación global falló: ${installErr.message}` };
     }
     try {
-      const retryInvocation = getCommandInvocation("openspec", ["init", "--tools", "opencode", "--force"]);
-      execFileSync3(retryInvocation.command, retryInvocation.args, {
+      const retryInvocation = invocationFor("openspec", ["init", "--tools", "opencode", "--force"]);
+      execFile(retryInvocation.command, retryInvocation.args, {
         stdio: "pipe",
         timeout: 120000,
         cwd: projectRoot
@@ -1735,7 +1738,7 @@ var init_doctor_v2 = __esm(() => {
 // package.json
 var package_default = {
   name: "ostacky",
-  version: "0.10.1",
+  version: "0.10.2",
   description: "Instalador interactivo de agentes y comandos para OpenCode",
   type: "module",
   bin: {
@@ -1772,6 +1775,7 @@ var package_default = {
   },
   devDependencies: {
     "@types/bun": "latest",
+    openspec: "^0.0.0",
     typescript: "^5.0.0"
   },
   publishConfig: {
@@ -2914,7 +2918,7 @@ async function probeMcpServer(nodeExecutable, serverPath, cwd, statePath, option
         params: {
           protocolVersion: "2025-03-26",
           capabilities: {},
-          clientInfo: { name: "ostacky-installer", version: "0.10.1" }
+          clientInfo: { name: "ostacky-installer", version: "0.10.2" }
         }
       });
     });

package/manifest.json

@@ -1,29 +1,29 @@
 {
-  "version": "0.10.1",
+  "version": "0.10.2",
   "repo": "JaimeHoracio/Ostacky",
-  "tag": "v0.10.1",
+  "tag": "v0.10.2",
   "agents": [
     {
       "name": "ostacky",
       "file": "assets/agents/ostacky.md",
-      "description": "Orquestador con recuperación automática (nunca se congela), ruteo por nivel de impacto, controller MCP con SDK oficial, edición segura con fallback inline, y delegación en OpenSpec + Superpowers. v0.10.1: prune de skills obsoletas, lastHandoff, getAvailableTransitions, consecutiveFailures real, mem_session_summary automático al cierre.",
-      "version": "0.10.1",
-      "sha256": "f82687e38d1ad2e88cce1e962299c9bd8b9265d53fe3c7997114efddb39898b3"
+      "description": "Orquestador con recuperación automática (nunca se congela), ruteo por nivel de impacto, controller MCP con SDK oficial, edición segura con fallback inline, y delegación en OpenSpec + Superpowers. v0.10.2: prune de skills obsoletas, lastHandoff, getAvailableTransitions, consecutiveFailures real, mem_session_summary automático al cierre.",
+      "version": "0.10.2",
+      "sha256": "b3db2a27d7b8249b4552d4f63353d893ec1b8c2abda44f375de65cd1d4364419"
     }
   ],
   "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.10.1: controller plugin como alma hard-gate, Context7 removido del stack.",
-      "version": "0.10.1",
-      "sha256": "07e70cbaec57e27b5984e4a693486e34a8f52585b1183da7dd88c5dd69c7c8d5"
+      "description": "Instala el stack tecnológico del proyecto (CodeGraph, skills, OpenSpec, Engram, controller plugin). v0.10.2: controller plugin como alma hard-gate, Context7 removido del stack.",
+      "version": "0.10.2",
+      "sha256": "b4845d7b6306b1a8c4914a4cf5a4390a4d3e79f1226de72b0ef2e95157c1f58e"
     },
     {
       "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.10.1",
+      "version": "0.10.2",
       "sha256": "f883f9ad96f7d75778631d5cc13d8a1a9c3e6ec41396bbce8ce13cff2e66fca2"
     }
   ],
@@ -31,15 +31,15 @@
     {
       "name": "ostacky-controller",
       "file": "assets/mcp/ostacky-controller/",
-      "description": "Máquina de estados persistida con @modelcontextprotocol/server SDK. v0.10.1: 22 tools (incluye set_handoff, get_handoff, clear_handoff, get_available_transitions funcional). Bugfixes: consecutiveFailures real, lastHandoff state, defaultChoice persistido. Robustez: degraded mode automático tras 3 fallos, persistence condicional para Nivel 0, prune de skills obsoletas.",
-      "version": "0.10.1",
-      "sha256": "d10efacd03f72f5fa1cca0abb22046a9862de7e98f635308f6898c5cbd67407e"
+      "description": "Máquina de estados persistida con @modelcontextprotocol/server SDK. v0.10.2: 22 tools (incluye set_handoff, get_handoff, clear_handoff, get_available_transitions funcional). Bugfixes: consecutiveFailures real, lastHandoff state, defaultChoice persistido. Robustez: degraded mode automático tras 3 fallos, persistence condicional para Nivel 0, prune de skills obsoletas.",
+      "version": "0.10.2",
+      "sha256": "c78d2a8f7ce87d373cbac9135235ef1c90f45380fafc4135fe22c2b55c4423b6"
     },
     {
       "name": "openspec",
       "file": "assets/mcp/openspec/",
       "description": "MCP server local para OpenSpec - proposal, apply, archive, sync de cambios",
-      "version": "0.10.1",
+      "version": "0.10.2",
       "sha256": "bdb283fe8ec2dfcba2ec4f38191f4039e58cd7ae12e44e66310783b42c827638"
     }
   ],
@@ -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.10.1",
+      "version": "0.10.2",
       "sha256": "ba76eff6fb5bea08d3b26622089ea4739b7b542b3677a46071b2576f3f2001c7"
     },
     {
       "name": "execution-mode-evaluation",
       "file": "assets/skills/execution-mode-evaluation/SKILL.md",
       "description": "Skill de análisis de modo de ejecución — output reconciliado con controller snapshot contract (recommendation field)",
-      "version": "0.10.1",
+      "version": "0.10.2",
       "sha256": "9090132ccfe31dcf34b6d5f399c1135dcb1044c504d4beb026e0c7d9e09e7c0d"
     },
     {
       "name": "tdd",
       "file": "assets/skills/tdd/SKILL.md",
       "description": "Skill de test-driven development (Superpowers)",
-      "version": "0.10.1",
+      "version": "0.10.2",
       "sha256": "cce54e81cce46ba973066f9b43e74994a7dbf21aa756146c27689241cf62704d"
     },
     {
       "name": "subagent-driven-development",
       "file": "assets/skills/subagent-driven-development/SKILL.md",
       "description": "Skill de ejecución con subagentes (Superpowers) — ejecuta solo después de confirmación del coordinador Ostacky",
-      "version": "0.10.1",
+      "version": "0.10.2",
       "sha256": "1a42d714a9a13faf05f0bf7b580e8d837c2e77a5633839542ccce603023419e8"
     },
     {
       "name": "dispatching-parallel-agents",
       "file": "assets/skills/dispatching-parallel-agents/SKILL.md",
       "description": "Skill de dispatch paralelo de agentes (Superpowers)",
-      "version": "0.10.1",
+      "version": "0.10.2",
       "sha256": "7e7b712ef742d5631e302e6a71583e2bbbd33094da9281abfb84b43505fc3ef1"
     },
     {
       "name": "review",
       "file": "assets/skills/review/SKILL.md",
       "description": "Skill de revisión de código (Superpowers)",
-      "version": "0.10.1",
+      "version": "0.10.2",
       "sha256": "b19650ed4d1d4d9857a4dd5b7e08e91328a1a1fc9c45bcc2fb600fa9d0213279"
     },
     {
       "name": "receiving-code-review",
       "file": "assets/skills/receiving-code-review/SKILL.md",
       "description": "Skill de recibir y procesar feedback de code review",
-      "version": "0.10.1",
+      "version": "0.10.2",
       "sha256": "d761e884e71d8d3476ac734d287cae403a4024506a7d12e7361a448217c0a831"
     },
     {
       "name": "openspec-propose",
       "file": "assets/skills/openspec-propose/SKILL.md",
       "description": "Skill de generación de proposal (OpenSpec)",
-      "version": "0.10.1",
+      "version": "0.10.2",
       "sha256": "9049b944cea88a5428fd5d77b411a0ed32d169ad68acda911b68365fac08f38f"
     },
     {
       "name": "openspec-apply-change",
       "file": "assets/skills/openspec-apply-change/SKILL.md",
       "description": "Skill de aplicación de change (OpenSpec)",
-      "version": "0.10.1",
+      "version": "0.10.2",
       "sha256": "dfc823bf89fc7505e91ab6dee9c1f004be38a410bd3d88fb67b211b1b6cbb1d0"
     },
     {
       "name": "openspec-archive-change",
       "file": "assets/skills/openspec-archive-change/SKILL.md",
       "description": "Skill de archivo de change (OpenSpec)",
-      "version": "0.10.1",
+      "version": "0.10.2",
       "sha256": "16e4b561de7747283663fed602e506abf502452c49a8d4b86d7a5539c40f0195"
     },
     {
       "name": "openspec-explore",
       "file": "assets/skills/openspec-explore/SKILL.md",
       "description": "Modo explore para OpenSpec — thinking partner para explorar ideas, investigar problemas y clarificar requisitos antes/durante un cambio",
-      "version": "0.10.1",
+      "version": "0.10.2",
       "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.10.1",
+      "version": "0.10.2",
       "sha256": "93341bc1b7c053618a8b6dc07e3615b77990d7b549a0201f5835d95fef67ce13"
     },
     {
       "name": "using-superpowers",
       "file": "assets/skills/using-superpowers/SKILL.md",
       "description": "Skill de orquestación de Superpowers skills",
-      "version": "0.10.1",
+      "version": "0.10.2",
       "sha256": "7e54536f96d2a379185a10bfc1e970850caa2561b6d8aca7080f0defea0381a4"
     },
     {
       "name": "writing-skills",
       "file": "assets/skills/writing-skills/SKILL.md",
       "description": "Skill de creación y edición de skills",
-      "version": "0.10.1",
+      "version": "0.10.2",
       "sha256": "3d76b906cee518a2b809febb70db95697a35b9f368986bb504b4120c3bfb437a"
     },
     {
       "name": "graceful-degradation",
       "file": "assets/skills/graceful-degradation/SKILL.md",
       "description": "Skill de degradación graceful cuando múltiples tools están indisponibles",
-      "version": "0.10.1",
+      "version": "0.10.2",
       "sha256": "363449bd9e6f800a0a3168667cf78f767fb105d86e4a4adadcc649d418139303"
     }
   ]

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "ostacky",
-    "version": "0.10.1",
+    "version": "0.10.2",
     "description": "Instalador interactivo de agentes y comandos para OpenCode",
     "type": "module",
     "bin": {
@@ -37,6 +37,7 @@
     },
     "devDependencies": {
         "@types/bun": "latest",
+        "openspec": "^0.0.0",
         "typescript": "^5.0.0"
     },
     "publishConfig": {