ostacky 0.0.6 → 0.1.0

package/README.md

@@ -1,11 +1,31 @@
 # Ostacky
 
-Ostacky es el agente de [OpenCode](https://opencode.ai) que instalás en tu proyecto. Usa skills para ser más eficiente con tokens y evitar recorrer todo el proyecto cuando no hace falta. En cambios de bajo impacto prioriza ejecución inline; los subagentes quedan para slices realmente independientes. Los cambios se registran normalmente en specs con los skills de OpenSpec; si el cambio es de bajo impacto, podés saltearte esa generación.
+Ostacky es el agente de [OpenCode](https://opencode.ai) que instalás en tu proyecto. Orquesta **4 herramientas** para que trabajen en sinergia: [CodeGraph](https://github.com/colbymchenry/codegraph) entiende el código existente, [OpenSpec](https://github.com/Fission-AI/OpenSpec/) define requisitos y contratos, [Superpowers](https://github.com/obra/superpowers) ejecuta con TDD y review, y [Engram](https://github.com/Gentleman-Programming/engram) da memoria persistente entre sesiones. Ostacky las rutea según el nivel de impacto del cambio para ser eficiente con tokens y evitar recorrer todo el proyecto cuando no hace falta.
 
 ## ¿Qué es?
 
 `Ostacky` es el agente (`.opencode/agents/`) que se instala directamente desde GitHub Releases. Cada instalación queda registrada en un lockfile con versión y checksum, lo que permite actualizaciones controladas y reproducibles.
 
+## Stack
+
+Ostacky no es solo un agente — es un **orquestador** que integra cuatro herramientas especializadas para que trabajen en conjunto sin pisarse:
+
+| Herramienta                                                   | Rol                 | Define                                           |
+| ------------------------------------------------------------- | ------------------- | ------------------------------------------------ |
+| **[CodeGraph](https://github.com/colbymchenry/codegraph)**    | Grafo de código     | DÓNDE está el código y a quién impacta un cambio |
+| **[OpenSpec](https://github.com/Fission-AI/OpenSpec/)**       | Especificaciones    | QUÉ hay que construir y POR QUÉ                  |
+| **[Superpowers](https://github.com/obra/superpowers)**        | Ejecución           | CÓMO se implementa, prueba y revisa              |
+| **[Engram](https://github.com/Gentleman-Programming/engram)** | Memoria persistente | QUÉ aprendimos en sesiones anteriores            |
+
+### Cómo trabajan en sinergia
+
+1. **CodeGraph** descubre el alcance del cambio sin escanear el repo entero (consulta `codegraph_context`, `codegraph_impact`).
+2. **OpenSpec** documenta requisitos, contratos y escenarios de aceptación (proposal → design → spec → tasks).
+3. **Superpowers** ejecuta con TDD, testing automatizado y review (brainstorming → plans → tdd → review).
+4. **Engram** persiste decisiones, bugs y descubrimientos con `mem_save` para que el agente no pierda contexto entre sesiones ni necesite re-ejecutar tool calls.
+
+Ostacky decide **cuándo y cómo** usar cada herramienta según el nivel de impacto del cambio (Nivel 0, Nivel 0+1, Nivel 1+), priorizando siempre eficiencia de tokens.
+
 ## ¿Para qué sirve?
 
 - Instalar el agente `Ostacky` en cualquier proyecto con un solo comando.
@@ -19,6 +39,7 @@ Ostacky es el agente de [OpenCode](https://opencode.ai) que instalás en tu proy
 - [Node.js](https://nodejs.org/) >= 18 (para usar con `npx`)
 - o [Bun](https://bun.sh/) >= 1.x (para usar con `bunx` o desarrollo)
 - [OpenCode](https://opencode.ai) instalado en tu máquina
+- **WSL:** Si usás Windows con WSL, seguí las instrucciones para **Linux** — WSL corre un kernel Linux real. No uses los comandos de PowerShell aunque estés en Windows.
 
 ## Uso rápido (para usuarios)
 
@@ -135,20 +156,20 @@ Tras instalar, el proyecto queda así:
 
 ```json
 {
-    "version": "0.0.6",
+    "version": "0.1.0",
     "lockedAt": "2025-01-01T00:00:00.000Z",
     "repo": "JaimeHoracio/Ostacky",
-    "tag": "v0.0.6",
+    "tag": "v0.1.0",
     "agents": {
         "ostacky": {
-            "version": "0.0.6",
+            "version": "0.1.0",
             "installedAt": "2025-01-01T00:00:00.000Z",
             "sha256": "abc123..."
         }
     },
     "commands": {
         "install-stack": {
-            "version": "0.0.6",
+            "version": "0.1.0",
             "installedAt": "2025-01-01T00:00:00.000Z",
             "sha256": "def456..."
         }
@@ -180,7 +201,7 @@ Ese paso es opcional. Si no aparece en la terminal, recargá OpenCode y volvé a
 ## 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.0.6`), nunca `main` — instalaciones reproducibles
+- Las URLs de descarga usan **tags de GitHub** (ej. `v0.1.0`), 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

package/assets/agents/ostacky.md

@@ -103,6 +103,17 @@ Eres **Ostacky**, el orquestador de desarrollo del proyecto.
 - El set curado de skills vive en `assets/skills/` y `.opencode/skills/`. No depender del plugin upstream `superpowers@git+...` en runtime.
 - `opsx-sync` sincroniza OpenSpec. `codegraph sync` sincroniza el grafo. Son complementarios, no redundantes.
 - Este proyecto NO usa CLAUDE.md. Si un skill referencia CLAUDE.md, usar el override local en `assets/skills/<skill>/` que reemplaza esas referencias por AGENTS.md y `.opencode/`.
+- Browser/local URL use is never suggested proactively; it is only allowed when the user explicitly asks for browser/visual help, and the default is text-only to conserve tokens.
+
+## Memoria persistente (Engram)
+
+Engram es el sistema de memoria persistente del stack. Su uso es **obligatorio y proactivo** — no esperes a que te lo pidan:
+
+1. **`mem_save` después de cada paso significativo** — arquitectura, decisiones, bugs, patrones, descubrimientos. Guardalos inmediatamente después de completar el paso.
+
+2. **`mem_search` proactivo al inicio de cada tarea** — si el usuario menciona algo que ya se trabajó antes, o si vas a trabajar en un área con trabajo previo, buscá en Engram primero. No asumas que no hay contexto.
+
+3. **Razonamiento para reducir tokens:** "Engram saves después de cada paso significativo — `mem_save` persiste 'ya hice X con estos resultados' y si vuelvo a preguntar 'qué hice?', tengo la respuesta sin re-ejecutar." Esto evita tool calls redundantes para recuperar contexto propio, reduciendo drásticamente el consumo de tokens en sesiones largas.
 
 ## Skills y comandos de referencia
 

package/assets/commands/install-stack.md

@@ -108,14 +108,107 @@ openspec update
 
 ---
 
+## Paso 5 — Engram
+
+[Engram](https://github.com/Gentleman-Programming/engram) es el sistema de memoria persistente para agentes de IA. Se instala como un único binario Go con SQLite + FTS5, sin Node.js, Python ni Docker.
+
+**RESTRICCIÓN:** configurar ÚNICAMENTE para OpenCode. No crear archivos en `.claude/`, `.cursor/` ni otros directorios de otras plataformas.
+
+### Verificar instalación actual
+
+Chequeá si Engram ya está disponible:
+
+```bash
+engram --version 2>/dev/null || echo "no-instalado"
+```
+
+#### Si ya está instalado
+
+Si el comando devuelve una versión, Engram ya está en el sistema. Verificá si es la más reciente comparando con la [última release en GitHub](https://github.com/Gentleman-Programming/engram/releases).
+
+Si está desactualizado, actualizá según cómo lo instalaste originalmente:
+
+- **go install:** `go install github.com/Gentleman-Programming/engram/cmd/engram@latest`
+- **Homebrew:** `brew update && brew upgrade engram`
+- **Binario propio:** descargá la nueva versión desde [releases](https://github.com/Gentleman-Programming/engram/releases) y reemplazá el binario
+
+Luego de actualizar, saltá directo a [Configurar para OpenCode](#configurar-para-opencode) — no necesitás reinstalar.
+
+#### Si no está instalado
+
+Preferí métodos de instalación local antes que global:
+
+**Opción recomendada — `go install` (local por usuario, sin sudo):**
+
+```bash
+go install github.com/Gentleman-Programming/engram/cmd/engram@latest
+```
+
+El binario se instala en `$GOPATH/bin/engram` (usualmente `~/go/bin/engram`).
+
+**Alternativa — Homebrew (macOS/Linux):**
+
+```bash
+brew install gentleman-programming/tap/engram
+```
+
+**Alternativa — binario en el proyecto (máxima localidad):**
+
+```bash
+mkdir -p .opencode/bin
+# Descargar el binario desde https://github.com/Gentleman-Programming/engram/releases
+# y colocarlo en .opencode/bin/engram, luego:
+chmod +x .opencode/bin/engram
+```
+
+### Configurar para OpenCode
+
+Una vez que Engram está instalado (ya sea porque ya lo tenías, lo actualizaste o lo instalaste ahora), ejecutá el setup que lo registra exclusivamente para OpenCode:
+
+```bash
+engram setup opencode
+```
+
+Este comando:
+- Agrega el MCP server de Engram en `opencode.json` (tipo `local`, comando `engram mcp`)
+- Instala el plugin de Engram para OpenCode
+- **NO** toca `.claude/`, `.cursor/`, `.gemini/` ni ninguna otra plataforma
+
+Verificá que `opencode.json` contenga la entrada MCP de Engram:
+
+```json
+{
+  "mcp": {
+    "engram": {
+      "type": "local",
+      "command": ["engram", "mcp"],
+      "enabled": true
+    }
+  }
+}
+```
+
+### Session tracking
+
+El plugin de Engram para OpenCode usa `engram serve` para session tracking y recuperación ante compaction. El plugin intenta auto-iniciar el servidor, pero si tu entorno bloquea procesos en background, iniciálo manualmente:
+
+```bash
+engram serve
+```
+
+Corre en el puerto 7437 por defecto. Los datos se almacenan en `~/.engram/engram.db` (SQLite local).
+
+---
+
 ## Verificación final
 
 Confirmá que:
 
 1. `.opencode/skills/` contiene las 10 skills curadas (cada una con su `SKILL.md`; algunas traen `scripts/` y `references/`)
 2. `.opencode/commands/` contiene los 5 opsx-* commands (`opsx-apply`, `opsx-archive`, `opsx-explore`, `opsx-propose`, `opsx-sync`)
-3. `opencode.json` (o `.jsonc`) tiene **solamente** el bloque `mcp.codegraph` — sin campo `plugin`
+3. `opencode.json` (o `.jsonc`) tiene los bloques `mcp.codegraph` y `mcp.engram` — sin campo `plugin`
 4. `.codegraph/` existe en la raíz del proyecto (índice local de CodeGraph)
-5. **NO existen** archivos generados en `.claude/`, `.kiro/`, `.cursor/`, `.gemini/`, `.codex/` ni ningún directorio de otra plataforma
+5. `engram --version` funciona y `engram setup opencode` ya fue ejecutado
+6. **NO existen** archivos generados en `.claude/`, `.kiro/`, `.cursor/`, `.gemini/`, `.codex/` ni ningún directorio de otra plataforma
 
 Reportá el estado de cada componente con ✓ o ✗.

package/dist/cli.js

@@ -161,7 +161,7 @@ var require_picocolors = __commonJS((exports, module) => {
 // package.json
 var package_default = {
   name: "ostacky",
-  version: "0.0.6",
+  version: "0.1.0",
   description: "Instalador interactivo de agentes y comandos para OpenCode",
   type: "module",
   bin: {
@@ -877,15 +877,15 @@ var L2 = () => {
 import { join as join5 } from "path";
 // manifest.json
 var manifest_default = {
-  version: "0.0.6",
+  version: "0.1.0",
   repo: "JaimeHoracio/Ostacky",
-  tag: "v0.0.6",
+  tag: "v0.1.0",
   agents: [
     {
       name: "ostacky",
       file: "assets/agents/ostacky.md",
       description: "Agente principal de desarrollo con ejecución inline-first y local-first",
-      version: "0.0.6",
+      version: "0.1.0",
       sha256: null
     }
   ],
@@ -894,14 +894,14 @@ var manifest_default = {
       name: "install-stack",
       file: "assets/commands/install-stack.md",
       description: "Instala el stack tecnológico del proyecto",
-      version: "0.0.6",
+      version: "0.1.0",
       sha256: null
     },
     {
       name: "opsx-sync",
       file: "assets/commands/opsx-sync.md",
       description: "Sincroniza delta specs del change activo (wrapper de openspec update)",
-      version: "0.0.6",
+      version: "0.1.0",
       sha256: null
     }
   ],
@@ -910,70 +910,70 @@ var manifest_default = {
       name: "brainstorming",
       file: "assets/skills/brainstorming/SKILL.md",
       description: "Skill de descubrimiento y exploración (Superpowers)",
-      version: "0.0.6",
+      version: "0.1.0",
       sha256: "22be76380b086c4ac6d38b8b124f6f7df47c32a67237a6ceaf8c7fd19aa524b0"
     },
     {
       name: "writing-plans",
       file: "assets/skills/writing-plans/SKILL.md",
       description: "Skill de planificación de implementación (Superpowers)",
-      version: "0.0.6",
+      version: "0.1.0",
       sha256: "4d56ce833af79c628e72cd95b06d13597131a09f9d98aae0a42c6a98a8ee1b95"
     },
     {
       name: "tdd",
       file: "assets/skills/tdd/SKILL.md",
       description: "Skill de test-driven development (Superpowers)",
-      version: "0.0.6",
+      version: "0.1.0",
       sha256: "b5cd98b3c122162b5a5eac3c78858a64ba165bf4e8c251d8a804a593c0c72312"
     },
     {
       name: "subagent-driven-development",
       file: "assets/skills/subagent-driven-development/SKILL.md",
       description: "Skill de ejecución con subagentes (Superpowers)",
-      version: "0.0.6",
+      version: "0.1.0",
       sha256: "7534b60788e05644831347194b1f99bcb41e2eda130994cfddafee3146ba63bd"
     },
     {
       name: "dispatching-parallel-agents",
       file: "assets/skills/dispatching-parallel-agents/SKILL.md",
       description: "Skill de dispatch paralelo de agentes (Superpowers)",
-      version: "0.0.6",
+      version: "0.1.0",
       sha256: "b7e99d62c5d2ade21a3b6cdc94a7f90772e23fe3294ca600386f192f6181f6b2"
     },
     {
       name: "review",
       file: "assets/skills/review/SKILL.md",
       description: "Skill de revisión de código (Superpowers)",
-      version: "0.0.6",
+      version: "0.1.0",
       sha256: "af8fd392835967111e865f170d90d3dd9b8266b517ffb7d551dffda704500a90"
     },
     {
       name: "openspec-explore",
       file: "assets/skills/openspec-explore/SKILL.md",
       description: "Skill de exploración pre-spec (OpenSpec)",
-      version: "0.0.6",
+      version: "0.1.0",
       sha256: "c3eaff7d64b7e5e757b120dd231d2e6b56e9f440055dc9ab5431b466d6244bd7"
     },
     {
       name: "openspec-propose",
       file: "assets/skills/openspec-propose/SKILL.md",
       description: "Skill de generación de proposal (OpenSpec)",
-      version: "0.0.6",
+      version: "0.1.0",
       sha256: "28c59bdce6e9af0ab07102b2e6d0b47a0f0dc2f1bfb8321576d47f6c240e778b"
     },
     {
       name: "openspec-apply-change",
       file: "assets/skills/openspec-apply-change/SKILL.md",
       description: "Skill de aplicación de change (OpenSpec)",
-      version: "0.0.6",
+      version: "0.1.0",
       sha256: "8fa8182e40fd92cefbbcc1e303d9aa9c02e2b7f3f2c0625cb61fb916e4fc5760"
     },
     {
       name: "openspec-archive-change",
       file: "assets/skills/openspec-archive-change/SKILL.md",
       description: "Skill de archivo de change (OpenSpec)",
-      version: "0.0.6",
+      version: "0.1.0",
       sha256: "564b8dca28084c75ca192137113e9186c4fb31d2de0e26c081fd67c37f7d4a56"
     }
   ]
@@ -1159,7 +1159,7 @@ function clearLockfile(opencodeRoot) {
   const lockfile = readLockfile(opencodeRoot);
   if (!lockfile) {
     writeLockfile(opencodeRoot, {
-      version: "0.0.6",
+      version: "0.1.0",
       lockedAt: new Date().toISOString(),
       repo: "",
       tag: "",

package/manifest.json

@@ -1,13 +1,13 @@
 {
-    "version": "0.0.6",
+    "version": "0.1.0",
     "repo": "JaimeHoracio/Ostacky",
-    "tag": "v0.0.6",
+    "tag": "v0.1.0",
     "agents": [
         {
             "name": "ostacky",
             "file": "assets/agents/ostacky.md",
             "description": "Agente principal de desarrollo con ejecución inline-first y local-first",
-            "version": "0.0.6",
+            "version": "0.1.0",
             "sha256": null
         }
     ],
@@ -16,14 +16,14 @@
             "name": "install-stack",
             "file": "assets/commands/install-stack.md",
             "description": "Instala el stack tecnológico del proyecto",
-            "version": "0.0.6",
+            "version": "0.1.0",
             "sha256": null
         },
         {
             "name": "opsx-sync",
             "file": "assets/commands/opsx-sync.md",
             "description": "Sincroniza delta specs del change activo (wrapper de openspec update)",
-            "version": "0.0.6",
+            "version": "0.1.0",
             "sha256": null
         }
     ],
@@ -32,70 +32,70 @@
             "name": "brainstorming",
             "file": "assets/skills/brainstorming/SKILL.md",
             "description": "Skill de descubrimiento y exploración (Superpowers)",
-            "version": "0.0.6",
+            "version": "0.1.0",
             "sha256": "22be76380b086c4ac6d38b8b124f6f7df47c32a67237a6ceaf8c7fd19aa524b0"
         },
         {
             "name": "writing-plans",
             "file": "assets/skills/writing-plans/SKILL.md",
             "description": "Skill de planificación de implementación (Superpowers)",
-            "version": "0.0.6",
+            "version": "0.1.0",
             "sha256": "4d56ce833af79c628e72cd95b06d13597131a09f9d98aae0a42c6a98a8ee1b95"
         },
         {
             "name": "tdd",
             "file": "assets/skills/tdd/SKILL.md",
             "description": "Skill de test-driven development (Superpowers)",
-            "version": "0.0.6",
+            "version": "0.1.0",
             "sha256": "b5cd98b3c122162b5a5eac3c78858a64ba165bf4e8c251d8a804a593c0c72312"
         },
         {
             "name": "subagent-driven-development",
             "file": "assets/skills/subagent-driven-development/SKILL.md",
             "description": "Skill de ejecución con subagentes (Superpowers)",
-            "version": "0.0.6",
+            "version": "0.1.0",
             "sha256": "7534b60788e05644831347194b1f99bcb41e2eda130994cfddafee3146ba63bd"
         },
         {
             "name": "dispatching-parallel-agents",
             "file": "assets/skills/dispatching-parallel-agents/SKILL.md",
             "description": "Skill de dispatch paralelo de agentes (Superpowers)",
-            "version": "0.0.6",
+            "version": "0.1.0",
             "sha256": "b7e99d62c5d2ade21a3b6cdc94a7f90772e23fe3294ca600386f192f6181f6b2"
         },
         {
             "name": "review",
             "file": "assets/skills/review/SKILL.md",
             "description": "Skill de revisión de código (Superpowers)",
-            "version": "0.0.6",
+            "version": "0.1.0",
             "sha256": "af8fd392835967111e865f170d90d3dd9b8266b517ffb7d551dffda704500a90"
         },
         {
             "name": "openspec-explore",
             "file": "assets/skills/openspec-explore/SKILL.md",
             "description": "Skill de exploración pre-spec (OpenSpec)",
-            "version": "0.0.6",
+            "version": "0.1.0",
             "sha256": "c3eaff7d64b7e5e757b120dd231d2e6b56e9f440055dc9ab5431b466d6244bd7"
         },
         {
             "name": "openspec-propose",
             "file": "assets/skills/openspec-propose/SKILL.md",
             "description": "Skill de generación de proposal (OpenSpec)",
-            "version": "0.0.6",
+            "version": "0.1.0",
             "sha256": "28c59bdce6e9af0ab07102b2e6d0b47a0f0dc2f1bfb8321576d47f6c240e778b"
         },
         {
             "name": "openspec-apply-change",
             "file": "assets/skills/openspec-apply-change/SKILL.md",
             "description": "Skill de aplicación de change (OpenSpec)",
-            "version": "0.0.6",
+            "version": "0.1.0",
             "sha256": "8fa8182e40fd92cefbbcc1e303d9aa9c02e2b7f3f2c0625cb61fb916e4fc5760"
         },
         {
             "name": "openspec-archive-change",
             "file": "assets/skills/openspec-archive-change/SKILL.md",
             "description": "Skill de archivo de change (OpenSpec)",
-            "version": "0.0.6",
+            "version": "0.1.0",
             "sha256": "564b8dca28084c75ca192137113e9186c4fb31d2de0e26c081fd67c37f7d4a56"
         }
     ]

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "ostacky",
-    "version": "0.0.6",
+    "version": "0.1.0",
     "description": "Instalador interactivo de agentes y comandos para OpenCode",
     "type": "module",
     "bin": {