ostacky 0.0.4 → 0.0.6

package/README.md

@@ -1,6 +1,6 @@
 # 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. 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. 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.
 
 ## ¿Qué es?
 
@@ -12,6 +12,7 @@ Ostacky es el agente de [OpenCode](https://opencode.ai) que instalás en tu proy
 - Mantener un registro de qué versión está instalada (`ostacky-lock.json`)
 - Detectar y aplicar actualizaciones mostrando el diff de versiones antes de confirmar
 - Evitar descargas repetidas gracias al cache local en `~/.opencode/cache/`
+- Resolver tareas chicas sin overhead extra de coordinación.
 
 ## Requisitos
 
@@ -134,20 +135,20 @@ Tras instalar, el proyecto queda así:
 
 ```json
 {
-    "version": "0.0.4",
+    "version": "0.0.6",
     "lockedAt": "2025-01-01T00:00:00.000Z",
     "repo": "JaimeHoracio/Ostacky",
-    "tag": "v0.0.4",
+    "tag": "v0.0.6",
     "agents": {
         "ostacky": {
-            "version": "0.0.4",
+            "version": "0.0.6",
             "installedAt": "2025-01-01T00:00:00.000Z",
             "sha256": "abc123..."
         }
     },
     "commands": {
         "install-stack": {
-            "version": "0.0.4",
+            "version": "0.0.6",
             "installedAt": "2025-01-01T00:00:00.000Z",
             "sha256": "def456..."
         }
@@ -159,39 +160,36 @@ Se recomienda agregar `ostacky-lock.json` al control de versiones para que el eq
 
 ## Después de la instalación
 
-Al terminar la instalación, el CLI imprime en la terminal un panel con los próximos pasos. Resumidos:
+Al terminar la instalación, el flujo normal es:
 
 1. **Recargar OpenCode** para que detecte los nuevos archivos en `.opencode/`.
-2. Ejecutar el command:
-    ```
-    /install-stack
-    ```
-    Si el command `/install-stack` no aparece en la terminal, recargá OpenCode (paso 1) y volvé a tipearlo. Es un command de OpenCode — el CLI lo instala pero OpenCode necesita recargarlo para registrarlo.
-3. **Recargar OpenCode nuevamente** después de que `/install-stack` haya corrido.
-4. Ya puedes usar el agente:
+2. Ya puedes usar el agente:
     ```
     @Ostacky
     ```
     o seleccionarlo desde la interfaz de OpenCode según la configuración del proyecto. `@Ostacky` invoca al agente que el CLI instaló en `.opencode/agents/ostacky.md`.
 
+Si por alguna razon querés ejecutar el bootstrap manualmente o regenerar el stack local, también está disponible el command:
+
+```bash
+/install-stack
+```
+
+Ese paso es opcional. Si no aparece en la terminal, recargá OpenCode y volvé a tipearlo.
+
 ## Seguridad
 
-- Las URLs de descarga usan **tags de GitHub** (ej. `v0.0.4`), nunca `main` — instalaciones reproducibles
+- `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
 - 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
 
 #### Restricciones de acceso a credenciales
 
-- La configuración local de OpenCode (`opencode.jsonc`, por ahora no versionado) bloquea lectura y escritura de `*.env` y `.secret/**` con `deny`.
-- El plugin versionado en `.opencode/plugins/deny-credentials.ts` registra el intento y deja una advertencia con la ruta exacta.
-- Cuando se bloquea un acceso, el mensaje puede empezar así:
-
-```text
->>>> Control: No se puede leer o modificar las credenciales: "/ruta/al/proyecto/.env"
-```
-
+- La configuración local de OpenCode (`opencode.jsonc`) bloquea lectura y escritura de `*.env` y `.secret/**` con `deny`.
 - La sesión sigue ejecutándose después del bloqueo porque `experimental.continue_loop_on_deny` está activado.
+- Para worktrees, el repo prefiere `.worktrees/`; `~/.config/superpowers/worktrees` solo se usa con confirmación explícita.
 
 ## Cache
 

package/assets/agents/ostacky.md

@@ -1,5 +1,5 @@
 ---
-description: Agente que orquesta OpenSpec + Superpowers + CodeGraph como un flujo unico, sin scans globales ni recursion de delegacion.
+description: Agente unico que orquesta OpenSpec + Superpowers + CodeGraph con ruteo inline-first por nivel de impacto y subagentes solo para trabajo realmente independiente.
 mode: primary
 tools:
   write: false
@@ -14,6 +14,14 @@ tools:
 
 Eres **Ostacky**, el orquestador de desarrollo del proyecto.
 
+## Division de responsabilidades
+
+- **Interfaz publica:** un solo agente, `@Ostacky`.
+- **Ruteo interno:** decide si el cambio es Nivel 0, Nivel 0+1 o Nivel 1+.
+- **OpenSpec:** define requisitos y contratos cuando el cambio lo requiere.
+- **Superpowers:** ejecuta, prueba, revisa y delega.
+- **Subagentes:** workers de ejecucion para slices realmente independientes; no se usan en tareas livianas porque duplican contexto y tokens.
+
 ## Principios
 
 - **OpenSpec** define **WHAT** y **WHY**.
@@ -44,6 +52,12 @@ Eres **Ostacky**, el orquestador de desarrollo del proyecto.
 5. Si el usuario elige `directo`, saltar Specification y Planning, y ejecutar inline con Superpowers usando solo los archivos que CodeGraph justifico.
 6. Si el usuario no responde, detenerse y esperar. No asumir un camino.
 
+### 1.6. Nivel 1+
+
+1. Un cambio es **Nivel 1+** cuando no entra en la definicion de Nivel 0+1.
+2. Nivel 1+ requiere OpenSpec antes de ejecutar.
+3. Si el cambio toca APIs publicas, agrega archivos nuevos, nuevas dependencias o refactors amplios, tratarlo como Nivel 1+ sin discusion.
+
 ### 2. Specification
 
 1. Si el usuario eligio `spec` y faltan artefactos OpenSpec, generarlos con `/opsx:propose <idea>`.
@@ -60,11 +74,12 @@ Eres **Ostacky**, el orquestador de desarrollo del proyecto.
 ### 4. Execution
 
 1. Elegir el modo antes de ejecutar:
-   - **Inline** para cambios simples, tareas locales, flujos cortos o la ruta `directo` de Nivel 0+1.
-   - **Subagent-driven** solo si hay mas de 2 modulos, mas de 10 archivos o backend + frontend + tests con logica independiente.
+   - **Inline** para Nivel 0, la ruta `directo` de Nivel 0+1 y cambios contenidos de Nivel 1+.
+   - **Subagent-driven** solo si la tarea se puede partir en slices autonomos con briefs mucho mas chicos que el contexto del coordinador y sin estado compartido.
 2. **Superpowers** es el unico orquestador de ejecucion, TDD, review y delegacion.
 3. Los subagentes son **execution-only**.
-4. Los subagentes no crean proposals, no planifican, no inician nueva delegacion y no repiten retrieval ya resuelto por el coordinador.
+4. Los subagentes no se usan para "hacerlo mas rapido" por defecto: se usan para aislar complejidad cuando eso reduce contexto total.
+5. Los subagentes no crean proposals, no planifican, no inician nueva delegacion y no repiten retrieval ya resuelto por el coordinador.
 
 ### 5. Sync y cierre
 
@@ -80,6 +95,7 @@ Eres **Ostacky**, el orquestador de desarrollo del proyecto.
 
 - Si una decision ya esta en OpenSpec o en CodeGraph, no volver a resolverla.
 - Si hay conflicto entre intuicion y CodeGraph, gana CodeGraph.
+- Si una tarea cabe en un brief corto y un solo contexto, no lanzar subagentes.
 - No usar glob/grep para descubrir el repositorio entero.
 - No navegar el proyecto siguiendo imports uno por uno para descubrir alcance.
 - No repetir la misma consulta si ya fue suficiente para resolver el scope.

package/assets/skills/brainstorming/SKILL.md

@@ -22,7 +22,7 @@ Every project goes through this process. A todo list, a single-function utility,
 You MUST create a task for each of these items and complete them in order:
 
 1. **Explore project context** — check files, docs, recent commits
-2. **Offer visual companion** (if topic will involve visual questions) — this is its own message, not combined with a clarifying question. See the Visual Companion section below.
+2. **Use visual companion only when the user explicitly asks for browser/visual help** — read the Visual Companion section below before doing so.
 3. **Ask clarifying questions** — one at a time, understand purpose/constraints/success criteria
 4. **Propose 2-3 approaches** — with trade-offs and your recommendation
 5. **Present design** — in sections scaled to their complexity, get user approval after each section
@@ -36,8 +36,8 @@ You MUST create a task for each of these items and complete them in order:
 ```dot
 digraph brainstorming {
     "Explore project context" [shape=box];
-    "Visual questions ahead?" [shape=diamond];
-    "Offer Visual Companion\n(own message, no other content)" [shape=box];
+    "User explicitly asks for browser/visual help?" [shape=diamond];
+    "Read Visual Companion guide" [shape=box];
     "Ask clarifying questions" [shape=box];
     "Propose 2-3 approaches" [shape=box];
     "Present design sections" [shape=box];
@@ -47,10 +47,10 @@ digraph brainstorming {
     "User reviews spec?" [shape=diamond];
     "Invoke writing-plans skill" [shape=doublecircle];
 
-    "Explore project context" -> "Visual questions ahead?";
-    "Visual questions ahead?" -> "Offer Visual Companion\n(own message, no other content)" [label="yes"];
-    "Visual questions ahead?" -> "Ask clarifying questions" [label="no"];
-    "Offer Visual Companion\n(own message, no other content)" -> "Ask clarifying questions";
+    "Explore project context" -> "User explicitly asks for browser/visual help?";
+    "User explicitly asks for browser/visual help?" -> "Read Visual Companion guide" [label="yes"];
+    "User explicitly asks for browser/visual help?" -> "Ask clarifying questions" [label="no"];
+    "Read Visual Companion guide" -> "Ask clarifying questions";
     "Ask clarifying questions" -> "Propose 2-3 approaches";
     "Propose 2-3 approaches" -> "Present design sections";
     "Present design sections" -> "User approves design?";
@@ -146,19 +146,8 @@ Wait for the user's response. If they request changes, make them and re-run the
 
 ## Visual Companion
 
-A browser-based companion for showing mockups, diagrams, and visual options during brainstorming. Available as a tool — not a mode. Accepting the companion means it's available for questions that benefit from visual treatment; it does NOT mean every question goes through the browser.
+Browser use is text-only by default.
 
-**Offering the companion:** When you anticipate that upcoming questions will involve visual content (mockups, layouts, diagrams), offer it once for consent:
-> "Some of what we're working on might be easier to explain if I can show it to you in a web browser. I can put together mockups, diagrams, comparisons, and other visuals as we go. This feature is still new and can be token-intensive. Want to try it? (Requires opening a local URL)"
-
-**This offer MUST be its own message.** Do not combine it with clarifying questions, context summaries, or any other content. The message should contain ONLY the offer above and nothing else. Wait for the user's response before continuing. If they decline, proceed with text-only brainstorming.
-
-**Per-question decision:** Even after the user accepts, decide FOR EACH QUESTION whether to use the browser or the terminal. The test: **would the user understand this better by seeing it than reading it?**
-
-- **Use the browser** for content that IS visual — mockups, wireframes, layout comparisons, architecture diagrams, side-by-side visual designs
-- **Use the terminal** for content that is text — requirements questions, conceptual choices, tradeoff lists, A/B/C/D text options, scope decisions
-
-A question about a UI topic is not automatically a visual question. "What does personality mean in this context?" is a conceptual question — use the terminal. "Which wizard layout works better?" is a visual question — use the browser.
-
-If they agree to the companion, read the detailed guide before proceeding:
-`skills/brainstorming/visual-companion.md`
+- Only use the browser when the user explicitly asks for browser/visual help.
+- Do not suggest the browser just because it might explain something more clearly.
+- If the user asks for browser/visual help, read `skills/brainstorming/visual-companion.md` before proceeding.

package/dist/cli.js

@@ -161,7 +161,7 @@ var require_picocolors = __commonJS((exports, module) => {
 // package.json
 var package_default = {
   name: "ostacky",
-  version: "0.0.4",
+  version: "0.0.6",
   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.4",
+  version: "0.0.6",
   repo: "JaimeHoracio/Ostacky",
-  tag: "v0.0.4",
+  tag: "v0.0.6",
   agents: [
     {
       name: "ostacky",
       file: "assets/agents/ostacky.md",
-      description: "Agente principal de desarrollo con OpenCode",
-      version: "0.0.4",
+      description: "Agente principal de desarrollo con ejecución inline-first y local-first",
+      version: "0.0.6",
       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.4",
+      version: "0.0.6",
       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.4",
+      version: "0.0.6",
       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.4",
+      version: "0.0.6",
       sha256: "22be76380b086c4ac6d38b8b124f6f7df47c32a67237a6ceaf8c7fd19aa524b0"
     },
     {
       name: "writing-plans",
       file: "assets/skills/writing-plans/SKILL.md",
       description: "Skill de planificación de implementación (Superpowers)",
-      version: "0.0.4",
+      version: "0.0.6",
       sha256: "4d56ce833af79c628e72cd95b06d13597131a09f9d98aae0a42c6a98a8ee1b95"
     },
     {
       name: "tdd",
       file: "assets/skills/tdd/SKILL.md",
       description: "Skill de test-driven development (Superpowers)",
-      version: "0.0.4",
+      version: "0.0.6",
       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.4",
+      version: "0.0.6",
       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.4",
+      version: "0.0.6",
       sha256: "b7e99d62c5d2ade21a3b6cdc94a7f90772e23fe3294ca600386f192f6181f6b2"
     },
     {
       name: "review",
       file: "assets/skills/review/SKILL.md",
       description: "Skill de revisión de código (Superpowers)",
-      version: "0.0.4",
+      version: "0.0.6",
       sha256: "af8fd392835967111e865f170d90d3dd9b8266b517ffb7d551dffda704500a90"
     },
     {
       name: "openspec-explore",
       file: "assets/skills/openspec-explore/SKILL.md",
       description: "Skill de exploración pre-spec (OpenSpec)",
-      version: "0.0.4",
+      version: "0.0.6",
       sha256: "c3eaff7d64b7e5e757b120dd231d2e6b56e9f440055dc9ab5431b466d6244bd7"
     },
     {
       name: "openspec-propose",
       file: "assets/skills/openspec-propose/SKILL.md",
       description: "Skill de generación de proposal (OpenSpec)",
-      version: "0.0.4",
+      version: "0.0.6",
       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.4",
+      version: "0.0.6",
       sha256: "8fa8182e40fd92cefbbcc1e303d9aa9c02e2b7f3f2c0625cb61fb916e4fc5760"
     },
     {
       name: "openspec-archive-change",
       file: "assets/skills/openspec-archive-change/SKILL.md",
       description: "Skill de archivo de change (OpenSpec)",
-      version: "0.0.4",
+      version: "0.0.6",
       sha256: "564b8dca28084c75ca192137113e9186c4fb31d2de0e26c081fd67c37f7d4a56"
     }
   ]
@@ -1159,7 +1159,7 @@ function clearLockfile(opencodeRoot) {
   const lockfile = readLockfile(opencodeRoot);
   if (!lockfile) {
     writeLockfile(opencodeRoot, {
-      version: "0.0.4",
+      version: "0.0.6",
       lockedAt: new Date().toISOString(),
       repo: "",
       tag: "",

package/manifest.json

@@ -1,13 +1,13 @@
 {
-    "version": "0.0.4",
+    "version": "0.0.6",
     "repo": "JaimeHoracio/Ostacky",
-    "tag": "v0.0.4",
+    "tag": "v0.0.6",
     "agents": [
         {
             "name": "ostacky",
             "file": "assets/agents/ostacky.md",
-            "description": "Agente principal de desarrollo con OpenCode",
-            "version": "0.0.4",
+            "description": "Agente principal de desarrollo con ejecución inline-first y local-first",
+            "version": "0.0.6",
             "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.4",
+            "version": "0.0.6",
             "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.4",
+            "version": "0.0.6",
             "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.4",
+            "version": "0.0.6",
             "sha256": "22be76380b086c4ac6d38b8b124f6f7df47c32a67237a6ceaf8c7fd19aa524b0"
         },
         {
             "name": "writing-plans",
             "file": "assets/skills/writing-plans/SKILL.md",
             "description": "Skill de planificación de implementación (Superpowers)",
-            "version": "0.0.4",
+            "version": "0.0.6",
             "sha256": "4d56ce833af79c628e72cd95b06d13597131a09f9d98aae0a42c6a98a8ee1b95"
         },
         {
             "name": "tdd",
             "file": "assets/skills/tdd/SKILL.md",
             "description": "Skill de test-driven development (Superpowers)",
-            "version": "0.0.4",
+            "version": "0.0.6",
             "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.4",
+            "version": "0.0.6",
             "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.4",
+            "version": "0.0.6",
             "sha256": "b7e99d62c5d2ade21a3b6cdc94a7f90772e23fe3294ca600386f192f6181f6b2"
         },
         {
             "name": "review",
             "file": "assets/skills/review/SKILL.md",
             "description": "Skill de revisión de código (Superpowers)",
-            "version": "0.0.4",
+            "version": "0.0.6",
             "sha256": "af8fd392835967111e865f170d90d3dd9b8266b517ffb7d551dffda704500a90"
         },
         {
             "name": "openspec-explore",
             "file": "assets/skills/openspec-explore/SKILL.md",
             "description": "Skill de exploración pre-spec (OpenSpec)",
-            "version": "0.0.4",
+            "version": "0.0.6",
             "sha256": "c3eaff7d64b7e5e757b120dd231d2e6b56e9f440055dc9ab5431b466d6244bd7"
         },
         {
             "name": "openspec-propose",
             "file": "assets/skills/openspec-propose/SKILL.md",
             "description": "Skill de generación de proposal (OpenSpec)",
-            "version": "0.0.4",
+            "version": "0.0.6",
             "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.4",
+            "version": "0.0.6",
             "sha256": "8fa8182e40fd92cefbbcc1e303d9aa9c02e2b7f3f2c0625cb61fb916e4fc5760"
         },
         {
             "name": "openspec-archive-change",
             "file": "assets/skills/openspec-archive-change/SKILL.md",
             "description": "Skill de archivo de change (OpenSpec)",
-            "version": "0.0.4",
+            "version": "0.0.6",
             "sha256": "564b8dca28084c75ca192137113e9186c4fb31d2de0e26c081fd67c37f7d4a56"
         }
     ]

package/package.json

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