ostacky 0.8.0 → 0.8.2

package/README.md

@@ -116,7 +116,10 @@ npx ostacky install --scope global  # ~/.config/opencode (XDG/APPDATA en Windows
 npx ostacky install --scope auto    # local si existe .opencode/.git, si no global
 ```
 
-Descarga todos los agentes y commands definidos en el manifest y los escribe en `.opencode/` (scope `local`) o en `~/.config/opencode` (`global`). Herramientas (`tools/`) siempre quedan en `<proyecto>/.opencode/tools`.
+Descarga todos los agentes y commands definidos en el manifest y los escribe en `.opencode/` (scope `local`) o en `~/.config/opencode` (`global`). 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).
+
+> **Coherencia local/global:** aunque elijas `global`, los plugins y herramientas (`tools/` con CodeGraph/Engram) permanecen siempre en `<proyecto>/.opencode` local para el hard-gate por worktree. En global solo se escribe el scope global + un espejo local de plugins. Para stack completo por proyecto ejecutá `npx ostacky install --scope local` dentro de cada repo.
+> **Windows — dónde se instala realmente:** `global` es `%APPDATA%\opencode` (`C:\Users\<vos>\AppData\Roaming\opencode`), **no** `C:\Users\<vos>\.opencode`. 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á con `--scope local`; el log ahora muestra `projectRoot` y `toolsDir` explícitos para evitar confusión.
 
 ### Agregar agentes o commands individualmente
 
@@ -148,15 +151,21 @@ Solo descarga los items que cambiaron de versión.
 ### Desinstalar
 
 ```bash
-npx ostacky uninstall
+npx ostacky uninstall                          # pregunta local vs global, luego qué borrar
+npx ostacky uninstall --scope local            # fuerza scope local
+npx ostacky uninstall --scope global           # fuerza scope global
+npx ostacky uninstall --scope auto             # auto
 ```
 
-Borra todos los archivos instalados (los listados en `.opencode/ostacky-lock.json`). Antes de borrar, muestra un preview con los paths a eliminar y pide confirmación.
+**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.
+
+> Si el lockfile no existe o está vacío → `No hay nada instalado.` y no borra nada.
 
 #### Desinstalar un agente puntual
 
 ```bash
-npx ostacky uninstall agent <nombre>
+npx ostacky uninstall agent <nombre>           # también admite --scope local|global|auto
+npx ostacky uninstall agent                    # sin nombre → selector de instalados
 ```
 
 Por ejemplo:
@@ -168,7 +177,8 @@ npx ostacky uninstall agent ostacky
 #### Desinstalar un command puntual
 
 ```bash
-npx ostacky uninstall command <nombre>
+npx ostacky uninstall command <nombre>         # también admite --scope
+npx ostacky uninstall command                  # sin nombre → selector
 ```
 
 Por ejemplo:
@@ -179,6 +189,15 @@ npx ostacky uninstall command install-stack
 
 Si no especificás el nombre, el CLI te muestra un selector con los items instalados para que elijas cuáles desinstalar (puede ser uno o varios).
 
+#### Desinstalar todo el stack (tools + config)
+
+```bash
+npx ostacky uninstall-stack                    # pregunta scope, limpia mcp.codegraph/engram de opencode.json + .codegraph/ + .opencode/tools/
+npx ostacky uninstall-stack --scope local
+```
+
+No toca binarios globales ni datos de Engram, solo la configuración del proyecto.
+
 ### Otros
 
 ```bash
@@ -188,7 +207,7 @@ npx ostacky --help      # muestra la ayuda
 
 ## Estructura generada
 
-Tras instalar, el proyecto queda así:
+Tras instalar (`--scope local`), el proyecto queda así:
 
 ```
 .opencode/
@@ -212,44 +231,63 @@ Tras instalar, el proyecto queda así:
 │   ├── using-superpowers/
 │   ├── writing-skills/
 │   └── graceful-degradation/
-└── ostacky-lock.json          ← versiones instaladas (agentes, commands y skills)
+├── plugins/
+│   ├── ostacky-plugin.ts      ← controller hard-gate (fusiona guard legacy)
+│   └── engram.ts              ← plugin Engram
+├── mcp/
+│   ├── ostacky-controller/    ← MCP thin (observabilidad)
+│   └── openspec/
+├── tools/
+│   ├── codegraph/bin/codegraph
+│   └── engram/bin/engram
+├── cache/codegraph/           ← cache local CodeGraph/Discovery
+├── ostacky-state.json         ← estado por worktree (aislado)
+└── ostacky-lock.json          ← versiones instaladas (agentes, commands, skills, mcpServers)
 ```
 
+> `assets/plugins/ostacky-guard.ts` fue **fusionado en `ostacky-plugin.ts` y eliminado** (re-export legacy). Fresh install solo escribe `ostacky-plugin.ts` + `engram.ts`; si venís de una versión previa con `ostacky-guard.ts` o `ostacky-controller.ts` legacy, el installer los elimina automáticamente.
+
 ### ostacky-lock.json
 
 ```json
 {
-    "version": "0.8.0",
+    "version": "0.8.2",
     "lockedAt": "2025-01-01T00:00:00.000Z",
     "repo": "JaimeHoracio/Ostacky",
-    "tag": "v0.8.0",
+    "tag": "v0.8.2",
     "agents": {
         "ostacky": {
-            "version": "0.8.0",
+            "version": "0.8.2",
             "installedAt": "2025-01-01T00:00:00.000Z",
             "sha256": "abc123..."
         }
     },
     "commands": {
         "install-stack": {
-            "version": "0.8.0",
+            "version": "0.8.2",
             "installedAt": "2025-01-01T00:00:00.000Z",
             "sha256": "def456..."
         },
         "opsx-sync": {
-            "version": "0.8.0",
+            "version": "0.8.2",
             "installedAt": "2025-01-01T00:00:00.000Z",
             "sha256": "ghi789..."
         }
     },
     "skills": {
-        "brainstorming": { "version": "0.8.0", ... },
-        "execution-mode-evaluation": { "version": "0.8.0", ... },
-        "openspec-propose": { "version": "0.8.0", ... }
+        "brainstorming": { "version": "0.8.2", ... },
+        "execution-mode-evaluation": { "version": "0.8.2", ... },
+        "openspec-propose": { "version": "0.8.2", ... }
+    },
+    "mcpServers": {
+        "ostacky-controller": { "version": "0.8.2", ... },
+        "openspec": { "version": "0.8.2", ... }
     }
 }
 ```
 
+`plugins/` (`ostacky-plugin.ts`, `engram.ts`) y `tools/` **no** se trackean en el lockfile — son allowlist Ostacky-owned y se gestionan via `uninstall` (allowlist) y `uninstall-stack`.
+
 Se recomienda agregar `ostacky-lock.json` al control de versiones para que el equipo instale exactamente las mismas versiones.
 
 ## Después de la instalación
@@ -275,7 +313,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.8.0`), nunca `main` — instalaciones reproducibles
+- Las URLs de descarga usan **tags de GitHub** (ej. `v0.8.2`), 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
@@ -291,7 +329,7 @@ Es opcional y solo necesario si algo falló durante la instalación o si querés
 - Variable `OSTACKY_SENSITIVE_PATTERNS` overridea los patrones por defecto (`**/.env*`, `**/.secrets/**`, `**/*.pem`, `**/*.key`, `**/.aws/**`, `**/.ssh/**`, `**/credentials.json`, `**/.npmrc`).
 - Ejemplo: `OSTACKY_SENSITIVE_PATTERNS="**/.env*,**/.secrets/**" bunx ostacky doctor` — `doctor` imprime el patrón efectivo.
 - Allowlist: `.env.example`, `.env.template`, `.env.sample` nunca se bloquean.
-- Fuente única: `src/security.ts` (`SENSITIVE_DEFAULT`, `isSensitive`, `BASH_SENSITIVE_RE`) — guard y controller usan la misma lógica (ver `doctor` para verificar).
+- Fuente única: `src/security.ts` (`SENSITIVE_DEFAULT`, `isSensitive`, `BASH_SENSITIVE_RE`) — `ostacky-plugin.ts` importa de ahí (legacy `ostacky-guard.ts` eliminado, fusionado en el plugin). Ver `doctor` para verificar.
 
 #### Aislamiento de worktrees (harness-prod-hardening)
 
@@ -332,6 +370,8 @@ 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.8.2 el instalador usa el patrón resiliente de Engram (strip 0 + búsqueda recursiva) y loguea `projectRoot|toolsDir` para diagnosticar scope.
+
 ## Licencia
 
 MIT

package/assets/agents/ostacky.md

@@ -1,12 +1,12 @@
 ---
 description: Orquestador principal — rutea por nivel, orquesta CodeGraph + OpenSpec + Superpowers.
 mode: primary
-version: 0.8.0
+version: 0.8.2
 ---
 
-Sos **Ostacky v0.8.0**, orquestás, no implementás. Interpretás, clasificás (0/0+1/1+), ruteás y coordinás.
+Sos **Ostacky v0.8.2**, orquestás, no implementás. Interpretás, clasificás (0/0+1/1+), ruteás y coordinás.
 
-> **Versión:** `0.8.0` (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.8.0"** (o `v0.8.0` si te piden solo el número). No inventes otra versión.
+> **Versión:** `0.8.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.8.2"** (o `v0.8.2` si te piden solo el número). No inventes otra versión.
 
 ## Reglas innegociables
 

package/assets/commands/install-stack.md

@@ -1,17 +1,17 @@
 ---
-description: Instala CodeGraph, skills curadas, OpenSpec, Engram y Context7 localmente para OpenCode únicamente
+description: Instala CodeGraph, skills curadas, OpenSpec y Engram localmente para OpenCode únicamente
 agent: build
 ---
 
 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.8.0, `npx ostacky install` ya instala automáticamente el stack completo (CodeGraph, OpenSpec, Engram, Context7, 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.8.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.
 
-**Origen del set curado:** el set de 15 skills referenciado en `assets/agents/ostacky.md` está bundleado en `assets/skills/` dentro del paquete npm. Context7 agrega su propio skill vía `npx ctx7 setup --opencode`. La definición del set y su trazabilidad viven en `manifest.json` y `.opencode/ostacky-lock.json`.
+**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.8.0)
+## Scope de instalación — local vs global (desde v0.8.2)
 
 `npx ostacky install` soporta `--scope local|global|auto` (también `--scope=...`):
 
@@ -164,7 +164,7 @@ Ostacky automáticamente detecta la ausencia del controller y opera en modo degr
 
 ## Paso 2 — Skills curadas (bundleadas)
 
-Las **15 skills curadas** están bundleadas dentro del paquete Ostacky en `assets/skills/`. No se descargan ni clonan; ya vienen en el paquete npm. Context7 agrega su propia skill aparte (Paso 6).
+Las **15 skills curadas** están bundleadas dentro del paquete Ostacky en `assets/skills/`. No se descargan ni clonan; ya vienen en el paquete npm.
 
 Copiá cada skill bundleada a `.opencode/skills/<nombre>/` preservando la estructura interna (incluyendo `SKILL.md` y cualquier subdirectorio como `scripts/` o `references/`):
 
@@ -215,11 +215,6 @@ Leé `opencode.json` (o `opencode.jsonc`) en la raíz del proyecto.
             "command": [".opencode/tools/engram/bin/engram", "mcp"],
             "enabled": true
         },
-        "context7": {
-            "type": "remote",
-            "url": "https://mcp.context7.com/mcp",
-            "enabled": true
-        },
         "ostacky-controller": {
             "type": "local",
             "command": ["node", ".opencode/mcp/ostacky-controller/index.js"],
@@ -353,99 +348,6 @@ rm -rf ~/.engram/
 
 ---
 
-## Paso 6 — Context7
-
-[Context7](https://context7.com) provee documentación actualizada de librerías y APIs directamente en el contexto del agente. Se instala como un CLI vía `npx`, sin dependencias globales ni MCP server necesario (aunque también soporta MCP).
-
-**RESTRICCIÓN:** configurar ÚNICAMENTE para OpenCode. Está terminantemente prohibido crear archivos en `.claude/`, `.kiro/`, `.cursor/`, `.gemini/`, `.codex/`, `.antigravity/`, `.windsurf/` o cualquier otro directorio de plataformas externas.
-
-### Verificar instalación actual
-
-Chequeá si Context7 ya está configurado para OpenCode:
-
-```bash
-ls -la .opencode/skills/context7/ 2>/dev/null || echo "no-instalado"
-```
-
-También podés verificar si el MCP server de Context7 está en `opencode.json`:
-
-```bash
-grep -c "context7" opencode.json 2>/dev/null || echo "no-configurado"
-```
-
-### Instalar
-
-**Opción recomendada — setup automático (CLI + skills):**
-
-```bash
-npx ctx7 setup --opencode
-```
-
-Este comando:
-
-- Autentica vía OAuth y genera una API key
-- Instala un skill en `.opencode/skills/context7/` que el agente Ostacky usa automáticamente
-- Pregunta si preferís modo CLI + Skills o MCP
-- **NO** toca `.claude/`, `.cursor/`, `.gemini/` ni ninguna otra plataforma
-
-**Alternativa — solo MCP (si preferís el server remoto):**
-
-Agregá manualmente la entrada MCP en `opencode.json`:
-
-```json
-{
-    "mcp": {
-        "context7": {
-            "type": "remote",
-            "url": "https://mcp.context7.com/mcp"
-        }
-    }
-}
-```
-
-Si tenés una API key de Context7 (recomendado para mejores rate limits):
-
-```json
-{
-    "mcp": {
-        "context7": {
-            "type": "remote",
-            "url": "https://mcp.context7.com/mcp",
-            "headers": {
-                "CONTEXT7_API_KEY": "{env:CONTEXT7_API_KEY}"
-            }
-        }
-    }
-}
-```
-
-### Desinstalar
-
-Para remover la configuración generada por `npx ctx7 setup`:
-
-```bash
-npx ctx7 remove
-```
-
-Esto elimina el skill y la configuración de Context7. Si instalaste el CLI globalmente con `npm install -g ctx7`, también necesitás:
-
-```bash
-npm uninstall -g ctx7
-```
-
-Para remover la entrada MCP manual, editá `opencode.json` y eliminá el bloque `mcp.context7`.
-
-### Cómo lo usa Ostacky
-
-El skill de Context7 instalado le indica al agente Ostacky que use Context7 automáticamente cuando necesite documentación de librerías, APIs o frameworks. También se puede invocar explícitamente:
-
-```
-usá context7 para mostrarme la API de autenticación de Supabase
-use context7 to find Next.js 15 app router examples
-```
-
----
-
 ## Estructura de herramientas
 
 Cada herramienta se instala en su propia carpeta dentro de `.opencode/` para mantener una instalación limpia y aislada. El installer crea automáticamente `.opencode/tools/<nombre>/` para cada herramienta externa:
@@ -481,10 +383,9 @@ Cada herramienta se instala en su propia carpeta dentro de `.opencode/` para man
 │   ├── using-superpowers/
 │   ├── writing-skills/
 │   └── graceful-degradation/
-├── tools/           # Config y archivos de herramientas externas
-│   ├── codegraph/   # Config de CodeGraph (AGENTS.md si codegraph lo crea)
-│   ├── engram/      # Config project-local de Engram
-│   └── context7/    # Config de Context7
+├── tools/           # Binarios locales de herramientas externas
+│   ├── codegraph/   # Binario local de CodeGraph
+│   └── engram/      # Binario local de Engram
 └── plugins/         # Plugins de OpenCode
 ```
 
@@ -493,24 +394,23 @@ Cada herramienta se instala en su propia carpeta dentro de `.opencode/` para man
 - `.codegraph/` (índice de CodeGraph) vive en la raíz del proyecto — CodeGraph lo espera ahí.
 - El binario de CodeGraph es **local al proyecto** en `.opencode/tools/codegraph/bin/`; en Windows puede ser `codegraph.cmd`. No se instala globalmente.
 - El binario de Engram es **local al proyecto** en `.opencode/tools/engram/bin/engram` (o `engram.exe` en Windows). No se instala globalmente.
-- Context7 se registra como MCP remoto en `opencode.jsonc`. Su skill opcional se instala via `npx ctx7 setup --opencode` en `.opencode/skills/context7/`.
+- El binary de CodeGraph y Engram vive siempre en `<proyecto>/.opencode/tools/` por reproducibilidad, nunca global.
 - El controller publicado se bundlea como un único `index.js`; durante desarrollo el installer instala sus dependencias en staging y valida el servidor antes de activarlo.
 
 ## Verificación final
 
 Confirmá que:
 
-1. `.opencode/skills/` contiene las 15 skills curadas y opcionalmente `context7/` si se instaló con `npx ctx7 setup --opencode`
+1. `.opencode/skills/` contiene las 15 skills curadas
 2. `.opencode/commands/` contiene los commands bundleados por Ostacky (`install-stack`, `opsx-sync`) y los 4 commands generados por OpenSpec (`opsx-apply`, `opsx-archive`, `opsx-explore`, `opsx-propose`) si OpenSpec fue inicializado
-3. `opencode.json` (o `.jsonc`) tiene los bloques MCP: `codegraph`, `engram`, `context7`, `ostacky-controller` — sin campo `plugin`
+3. `opencode.json` (o `.jsonc`) tiene los bloques MCP: `codegraph`, `engram`, `ostacky-controller` — sin campo `plugin`
 4. `.codegraph/` existe en la raíz del proyecto (índice local de CodeGraph)
 5. El launcher local de CodeGraph funciona (`codegraph.cmd --version` en Windows o `codegraph --version` en Unix)
 6. El binario local de Engram funciona (`engram.exe --version` en Windows o `engram --version` en Unix)
-7. Context7 configurado: `mcp.context7` presente en `opencode.jsonc` y/o `.opencode/skills/context7/SKILL.md` existe
-8. OpenSpec generó sus commands/skills para OpenCode mediante `openspec init --tools opencode`
-9. `.opencode/tools/` contiene subdirectorios para `codegraph/`, `engram/` y `context7/`
-10. **NO existen** archivos generados en `.claude/`, `.kiro/`, `.cursor/`, `.gemini/`, `.codex/` ni ningún directorio de otra plataforma
-11. Un `AGENTS.md` preexistente en la raíz del proyecto se preserva sin cambios
+7. OpenSpec generó sus commands/skills para OpenCode mediante `openspec init --tools opencode` (si se usó)
+8. `.opencode/tools/` contiene subdirectorios para `codegraph/` y `engram/`
+9. **NO existen** archivos generados en `.claude/`, `.kiro/`, `.cursor/`, `.gemini/`, `.codex/` ni ningún directorio de otra plataforma
+10. Un `AGENTS.md` preexistente en la raíz del proyecto se preserva sin cambios
 
 Reportá el estado de cada componente con ✓ o ✗.
 

package/assets/docs/ostacky-reference.md

@@ -26,7 +26,6 @@ BLOCKED: replan→INTERPRETATION_PENDING, abandon→DONE
 | codegraph_* | 10s | 1 | Engram → Read+Glob |
 | controller_* | 5s | 1 | degraded |
 | engram_* | 5s | 1 | sin memoria |
-| context7_* | 10s | 1 | sin docs |
 
 ## Cache
 
@@ -75,5 +74,4 @@ Principio: **eficacia > recorte** — si recorte rompiera caché y saliera más
 
 - `ostacky.md` 109→72 líneas (diet estable cacheable). Tiered vía suffix, no reemplazo `system[0]`.
 - `controller` descriptions <150 chars
-- `context7` lazy: `enabled:false` default, trigger `docs|api|lib|Context7` habilita
 - `MEMORY_INSTRUCTIONS` lazy: siempre pointer (~1 línea) en `system.transform`; full vive en `assets/docs/engram-protocol.md` on-demand via `Read` (ahorro ~1.2k en FULL, trivial ya era pointer)

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

@@ -2371,7 +2371,7 @@ function safeHandler(fn, options = {}) {
 
 const server = new McpServer({
     name: 'ostacky-controller',
-    version: '0.8.0',
+    version: '0.8.2',
 });
 
 server.registerTool(
@@ -2971,7 +2971,7 @@ function setupGracefulShutdown(ctrl) {
 }
 
 async function main() {
-    log('Starting ostacky-controller MCP v0.8.0...');
+    log('Starting ostacky-controller MCP v0.8.2...');
     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.8.0",
+    "version": "0.8.2",
     "private": true,
     "type": "module",
     "dependencies": {

package/assets/plugins/ostacky-plugin.ts

@@ -20,6 +20,10 @@ import { isTrivial } from "../../src/tiered.ts"
 // ─── Constants ───────────────────────────────────────────────────────────────
 
 const MAX_STATE_FILE_SIZE = 2 * 1024 * 1024
+const PING_INTERVAL_MS = 60_000
+const IDLE_THRESHOLD_MS = 45_000
+const PURPLE_TENUE = "\x1b[38;5;183m"
+const PURPLE_RESET = "\x1b[0m"
 
 const STATES = Object.freeze({
   INTERPRETATION_PENDING: "INTERPRETATION_PENDING",
@@ -254,6 +258,9 @@ function isCodegraphAvailable(directory: string): boolean {
 const trivialBySession = new Map<string, boolean>()
 // Track discovery hit per requestId to avoid blocking after hit
 const discoveryHitByRequest = new Map<string, boolean>()
+// ─── Heartbeat ping — evita sensación de trancado en tareas largas ──
+let lastPingTs = 0
+let pingInterval: ReturnType<typeof setInterval> | null = null
 
 // ─── Plugin ──────────────────────────────────────────────────────────────────
 
@@ -267,6 +274,30 @@ export const OstackyController: Plugin = async (ctx) => {
   let lastCheck: { revision: number; result: string } | null = null
   let checkCount = 0
 
+  // Heartbeat ping — purple tenue, evita sensación de trancado en tareas largas
+  if (!pingInterval) {
+    pingInterval = setInterval(async () => {
+      try {
+        const s = readState(ctx.directory)
+        if (!s || !["EXECUTING_INLINE", "EXECUTING_SUBAGENTS", "SYNC"].includes(s.state)) return
+        const now = Date.now()
+        const lastHeartbeat = s.lastHeartbeat || s.ts || now
+        const idle = now - lastHeartbeat
+        if (idle < IDLE_THRESHOLD_MS) return
+        if (now - lastPingTs < PING_INTERVAL_MS) return
+        lastPingTs = now
+        const completed = Object.values(s.tasks || {}).filter((t: any) => t.status === "COMPLETED").length
+        const total = s.expectedTaskCount ?? s.expectedTasks?.length ?? "?"
+        const pending = Array.isArray(s.expectedTasks) ? s.expectedTasks.filter((id: string) => !s.tasks?.[id] || s.tasks[id].status !== "COMPLETED").length : "?"
+        const msg = `🟣 ${PURPLE_TENUE}[OSTACKY]${PURPLE_RESET} ⏳ Sigo trabajando — ${s.state} • ${completed}/${total} (${pending} pendientes) • hace ${Math.round(idle/1000)}s sin output`
+        try { await (ctx as any).client?.tui?.showToast?.({ body: { message: msg, variant: "info" } } as any) } catch {}
+        try { await (ctx as any).client?.app?.log?.({ body: { service: "ostacky-ping", level: "info", message: msg } } as any) } catch {}
+        try { const st = readState(ctx.directory); if (st) { (st as any).lastPingTs = now; persistState(ctx.directory, st) } } catch {}
+      } catch {}
+    }, 30_000)
+    if (pingInterval && typeof (pingInterval as any).unref === 'function') (pingInterval as any).unref()
+  }
+
   return {
     // ── Tiered: suffix hint on user message (cache-friendly, no system replace) ──
     "chat.message": async (input: any, output: any) => {
@@ -527,6 +558,18 @@ export const OstackyController: Plugin = async (ctx) => {
           const s = readState((input as any).ctx?.directory ?? "")
         } catch {}
       }
+      // Heartbeat + color purple tenue: Ostacky vs modelo (fácil)
+      try {
+        const dir = ctx.directory
+        const s = readState(dir)
+        if (s) {
+          s.lastHeartbeat = Date.now()
+          try { persistState(dir, s) } catch {}
+          if (["EXECUTING_INLINE", "EXECUTING_SUBAGENTS", "SYNC"].includes(s.state) && output && typeof output.title === "string" && output.title && !output.title.includes("🟣")) {
+            output.title = `🟣 ${PURPLE_TENUE}[OSTACKY]${PURPLE_RESET} ${output.title}`
+          }
+        }
+      } catch {}
     },
 
     // ── Observable tools (MCP thin replacement) ──
@@ -622,6 +665,11 @@ export const OstackyController: Plugin = async (ctx) => {
       }
     },
 
+    dispose: async () => {
+      try { if (pingInterval) clearInterval(pingInterval) } catch {}
+      pingInterval = null
+    },
+
     "experimental.session.compacting": async (input: any, output: any) => {
       try {
         const statePath = getStatePath(ctx.directory)

package/assets/skills/brainstorming/SKILL.md

@@ -38,7 +38,7 @@ Do NOT invoke any implementation skill, write any code, or scaffold any project
 
 1. **Check discovery-cache first** — `src/discovery-cache.ts` `getDiscoverySnapshot(query)` + `getEngramDedup(query, requestId)`. Si hit válido (TTL+gitDiffHash), **reusar** sin llamar tools. Solo si miss → `engram_mem_search` + `codegraph_codegraph_explore` y **SHALL `putDiscoverySnapshot`** antes de avanzar. No re-llamar si área difiere <30% del snapshot.
 2. **Ask clarifying questions** — one at a time, understand purpose/constraints/success criteria
-4. **Propose 2-3 approaches (hardening-v2 — SHALL)** — con tabla trade-offs (coste|riesgo|complejidad) + evidencia CodeGraph+Engram (+Context7 si librería) sin alucinar, YAGNI, y recomendación con razón; cada approach cita symbols existentes y mem_search hits verificables
+4. **Propose 2-3 approaches (hardening-v2 — SHALL)** — con tabla trade-offs (coste|riesgo|complejidad) + evidencia CodeGraph+Engram sin alucinar, YAGNI, y recomendación con razón; cada approach cita symbols existentes y mem_search hits verificables
 5. **Present design** — in sections scaled to complexity, get user approval after each section. **Gate post-brainstorming (hardening-v2):** tras presentar diseño, preguntar "¿Procedo con este diseño o querés ajustar algo?" y esperar confirmación explícita antes de `record_discovery`, `openspec-propose` o implementación directa
 6. **Write design doc (output path condicional — router exclusivo):**
    - Si trigger + `level 1+` no-downgradeable (`estLines>30` o `fileCount>2` o API pública) y change activo → escribir `openspec/changes/<id>/design.md` sección `## Alternatives Considered` con 2-3 approaches (tabla coste|riesgo|complejidad + evidencia CodeGraph+Engram), no `docs/`. No invocar `openspec-propose` separado — este es el diseño.

package/assets/skills/graceful-degradation/SKILL.md

@@ -20,7 +20,6 @@ When critical tools are unavailable, this skill provides a systematic approach t
 | CodeGraph | MCP server | Engram → Read + Glob | No structural analysis, manual exploration |
 | Engram | MCP server | Continue without memory | No persistence across sessions |
 | Controller | MCP server | Inline validation + manual state | No state machine, no edit validation |
-| Context7 | MCP server (remote) | Skip documentation | No external API docs |
 
 ## Detection
 
@@ -108,12 +107,6 @@ Incluso en degraded, el guard de credenciales sigue activo (hard gate incluso en
 - No state persistence across crashes
 - No pending state enforcement (check_pending_state unavailable)
 
-### Without Context7
-
-**Impact:** Minimal — only affects external API documentation lookups.
-
-**Workflow:** Proceed normally. Use existing knowledge.
-
 ## Communication Protocol
 
 ### Status Report Format
@@ -141,7 +134,6 @@ Herramientas disponibles:
 ✅ Controller — ping OK
 ❌ CodeGraph — timeout 10s
 ✅ Engram — disponible
-✅ Context7 — disponible
 
 ¿Continuar con lectura manual de archivos?
 ```
@@ -154,7 +146,6 @@ Herramientas disponibles:
 ❌ Controller — no responde
 ❌ CodeGraph — no instalado
 ❌ Engram — timeout 5s
-✅ Context7 — disponible (pero sin docs relevantes)
 
 Modo básico: sin validación de edits, sin memoria persistente, sin análisis estructural.
 ¿Continuar o cancelar?