oficina-opencode 2.0.1 → 2.1.1

package/docs/COMPATIBILITY.md

@@ -0,0 +1,98 @@
+# Compatibilidad
+
+Qué versiones de OpenCode y del API de plugin soporta AI-OFFICE, y **qué se
+verificó de cada una**.
+
+La regla de este proyecto: lo que no está probado, no está soportado. Un
+número de versión escrito a mano sin prueba de por medio es una promesa que
+nadie verificó.
+
+---
+
+## Versiones
+
+| Componente | Versión | Cómo se verificó |
+|---|---|---|
+| `@opencode-ai/plugin` | `1.15.11` | Compilación con `strict` + `noUncheckedIndexedAccess` contra los tipos reales del paquete. Un hook que no exista en el tipo **no compila**. |
+| Node.js | `>=20` | CI corre la matriz `[20, 22]` en `ubuntu-latest` y `windows-latest`. |
+| TypeScript | `>=5.6` | `tsc --noEmit` en modo `strict`. |
+
+La API de plugin es la que manda: el plugin importa sus tipos, así que
+**la compatibilidad se verifica en tiempo de compilación**, no por
+inspección visual.
+
+## Hooks que usa el plugin
+
+| Hook | Para qué | Si el host no lo soporta |
+|---|---|---|
+| `event` (`session.idle`) | Auto-reanudación de la corrida | La corrida sigue, pero no se reanuda sola. |
+| `event` (`message.updated`) | Contabilidad de costo | No hay registro de costo. La oficina sigue funcionando. |
+| `tool.execute.before` | Guard de scope | **Sin protección**: el scope pasa a ser una instrucción, no una restricción. |
+| `tool.execute.after` | Tripwire | No hay detección de escrituras coladas. |
+| `permission.ask` | Segunda capa de enforcement | Queda solo la primera capa. |
+| `experimental.chat.system.transform` | El estado viaja con cada llamada | El agente tiene que preguntar el estado. |
+| `experimental.session.compacting` | El estado sobrevive a la compactación | La compactación pierde el contexto de la oficina. |
+| `experimental.compaction.autocontinue` | Freno de emergencia | El freno frena el trabajo, pero la auto-continuación post-compactación sigue. |
+
+## Mínimo verificable
+
+La parte del plugin que **no degrada bien** es el guard de scope. Por eso
+el proyecto declara un mínimo:
+
+- **`@opencode-ai/plugin` >= 1.15.11**: a partir de esta versión existen
+  `tool.execute.before`, `tool.execute.after` y `permission.ask` con las
+  firmas que usa el plugin.
+
+Si se instala con una versión anterior, el typecheck falla en la
+instalación del consumidor y eso es intencional: es mejor un error de
+compilación que una instalación que parece protegida y no lo está.
+
+## Pruebas de integración por versión
+
+El CI corre la matriz completa:
+
+```
+os:   [ubuntu-latest, windows-latest]
+node: [20, 22]
+```
+
+En cada combinación se corre:
+
+1. `npm run typecheck` — la API de plugin compila.
+2. `npm run test` — la suite completa (los tests del plugin usan un host
+   simulado con la misma forma que el real).
+3. `npm run build` — el `dist/` se genera.
+4. `npm pack --dry-run` — el paquete se puede armar.
+
+Y en un job aparte, el smoke del CLI sobre el `dist/` real.
+
+## OpenCode
+
+| Versión de OpenCode | Soporte |
+|---|---|
+| La que trae el host actual | Sí. Es la que se prueba en desarrollo. |
+| Versiones anteriores | No declaradas. El plugin usa `session.prompt` con partes `subtask`, `session.promptAsync`, `session.get` y `client.app.log`. |
+
+El plugin **no fija** una versión de OpenCode: se instala como plugin y usa
+el API que el host expone. Lo que sí fija es la versión del **API de
+plugin**, que es lo que usa directamente.
+
+## Requisitos del usuario, no del plugin
+
+| Requisito | Por qué |
+|---|---|
+| Node >= 20 | `fs.promises`, `structuredClone`, ESM estable. |
+| Un repo de `agency-agents` (opcional) | Sin él, la fábrica de roles funciona igual, pero los agentes salen de la plantilla genérica en vez del catálogo curado. |
+| npm CLI >= 11.15 (opcional) | Solo para `npm stage publish`, el flujo de publicación por etapas de npm. La oficina no lo usa: publica directo. |
+
+---
+
+## Cómo se mantiene esta tabla
+
+Las cifras de versiones salen del `package.json` real y se verifican en el
+CI. El bloque de hechos de `README.md` y `docs/QUE-ES.md` se genera con
+`npm run docs:sync` y el CI **falla** si se desincroniza:
+
+```bash
+npm run docs:check   # sale con 1 si la doc no coincide con el código
+```

package/docs/GARANTIAS.md

@@ -0,0 +1,190 @@
+# Garantías
+
+Qué promete AI-OFFICE, **qué mecanismo lo hace cumplir** y **dónde termina
+la garantía**.
+
+La regla de este documento: si algo no se puede verificar con un test o con
+un mecanismo de código, no se promete. Un README que vende más de lo que el
+código hace es peor que un README modesto: hace que el usuario confíe en
+una protección que no existe.
+
+---
+
+## 1. El scope es una restricción
+
+### Qué se garantiza
+
+| Vector de escape | Cómo se frena | Test |
+|---|---|---|
+| `..` en la ruta | Se resuelve a absoluta y se verifica la contención | `sandbox.test.ts` |
+| Path absoluto fuera del proyecto | Ídem | `sandbox.test.ts` |
+| Symlink que apunta afuera | Se resuelve el symlink y **se revalida** la contención | `sandbox.test.ts` |
+| Symlink roto | Se deniega (no se sabe a dónde apunta) | `sandbox.test.ts` |
+| `mayTouch: ["**"]` como comodín | `**` significa "el proyecto", nunca "el filesystem" | `sandbox.test.ts` |
+| Path sensível (`.env`, `.npmrc`, `.git/**`, claves) | Nunca escribible, pase lo que pase el scope | `sandbox.test.ts` |
+| Diff multi-archivo | Se chequean **todos** los archivos del diff | `scopeGuard.test.ts` |
+| Tool de shell escribiendo afuera | El comando se analiza antes de ejecutarse | `sandbox.test.ts` |
+| Subagente delegado | Hereda el scope por la cadena de padres de sesión | `scopeGuard.test.ts` |
+| Path con byte NUL | Se rechaza | `sandbox.test.ts` |
+
+### Las tres capas
+
+1. **`tool.execute.before`** — el guard propio. Cubre toda tool que el motor
+   reporte, incluidas las de shell.
+2. **`permission.ask`** — el framework. Deniega a nivel del motor.
+3. **`tool.execute.after`** — el tripwire. Detecta lo que se coló.
+
+### Lo que NO se garantiza
+
+- **Un shell con interpreter embebido puede escribir fuera.** `python -c`,
+  `node -e`, heredocs y `eval` esconden paths que ningún análisis previo
+  puede extraer con certeza. Cuando el comando no se puede interpretar, se
+  deja pasar y **el tripwire lo detecta después**.
+- **El tripwire no revierte.** Detecta y reporta; no deshace. Y vigila el
+  proyecto, no el filesystem entero.
+- **Una escritura fuera del proyecto ya formada no se revierte.** El
+  contención previene; no limpia.
+
+---
+
+## 2. Las invariantes se evalúan donde corresponde
+
+Ocho invariantes duros, en código, no en el prompt:
+
+| Invariante | Dónde se evalúa |
+|---|---|
+| `reviewer-neq-owner` | Toda revisión |
+| `gate-required-before-done` | Al cerrar la card |
+| `evidence-required-before-done` | Al cerrar la card |
+| `max-review-rejections` | Al revisar |
+| `max-help-chain-hops` | Al enrutar ayuda |
+| `max-cards` | Al planear |
+| `max-agent-calls` | Al reclamar |
+| `max-spawns-total` | Al arrancar un subagente |
+
+> **Bug corregido en esta versión**: `closeCard` evaluaba los invariantes
+> con la card en `review`, no en `done`. Como los dos invariantes de cierre
+> solo tienen sentido en `done`, **nunca disparaban**. Ahora se validan
+> contra el estado al que la card llegaría.
+
+El `evidence-required-before-done` es **fail-closed**: si la evidencia no se
+evaluó, la card no se cierra. "No lo sé" no es "sí".
+
+---
+
+## 3. El cierre exige evidencia, no solo checks verdes
+
+Pirámide de verificación:
+
+| Nivel | Qué es | Cómo se comprueba |
+|---|---|---|
+| 1 — Estático | Tipos, lint, secretos, dependencias | Los gates técnicos |
+| 2 — Comportamiento | Unitarias, integración, regresión | El gate `test` + evidencia de artefacto |
+| 3 — Requisitos | Cada criterio de aceptación con su evidencia | El grafo de evidencia |
+| 4 — Auditoría | Revisión independiente, riesgos | Evidencia de auditoría (revisor ≠ owner) |
+
+Una card se cierra solo si **los gates pasan Y cada requisito obligatorio
+tiene evidencia suficiente**.
+
+### El grafo requisito → evidencia
+
+Cada criterio de aceptación es un requisito. Cada evidencia (artefacto,
+test, gate, inspección, auditoría) se vincula a un requisito con un nivel.
+El grafo responde: *¿qué falta para poder cerrar?*
+
+```
+T-00 · Implementar login
+  [✓] endpoint de login                          nivel 2  artefacto
+  [ ] sin errores de validación                  nivel 0  — FALTA
+  [!] cubierto por revisión independiente        nivel 4  auditoría
+```
+
+**Niveles y tope por tipo**: un artefacto llega a nivel 2; un test, a 2; un
+gate, a 1 (o 2 si es la fase `test`); una inspección, a 3; una auditoría
+(revisor ≠ owner), a 4. `evidenceFromAudit` **lanza** si owner y reviewer
+son el mismo: una auto-revisión con cara de auditoría es peor que no tener
+auditoría.
+
+---
+
+## 4. La concurrencia se sostiene
+
+| Garantía | Mecanismo | Test |
+|---|---|---|
+| Un lease por task | Ciclo leer-evaluar-escribir bajo un lock de directorio | `concurrency.test.ts` |
+| Seq único por canal | Asignación y escritura bajo el lock del canal | `concurrency.test.ts` |
+| Idempotencia real | Check y escritura bajo el mismo lock | `concurrency.test.ts` |
+| Un id nunca escapa del directorio | `safeId` + `safeJoin` | `ids`, `concurrency.test.ts` |
+| Un JSON a medio escribir no se lee | `writeAtomic` (tmp + rename) | — |
+| Un JSON vacío no se pone en cuarentena | `readJson` distingue "en curso" de "corrupto" | — |
+
+### El bug de Windows
+
+`fs.mkdir` sobre un directorio que otro proceso está borrando da **EPERM**,
+no `EEXIST`. Sin manejar ese caso, dos emisores concurrentes se rompían en
+Windows. Está cubierto y hay un test de carrera de 40 rondas.
+
+---
+
+## 5. Una caída no destruye la corrida
+
+`reconcile()` compara **estado vs artefactos vs filesystem** y reporta:
+
+| Situación | Qué hace |
+|---|---|
+| Card en `review` sin `handoff.md` | El agente murió entregando. Se avisa. |
+| Card en `done` sin `gates.md` | Se cerró sin gate. **Crítico.** |
+| Card en progreso sin owner | Nadie la va a terminar. **Crítico.** |
+| Lease de una card que no existe | Se libera. |
+| Lease de una card terminada | Se libera. |
+| Agente `working` sobre una card `done` | Se libera el agente. |
+| Artefacto de una card inexistente | Se reporta. |
+| Card bloqueada por dependencia irresoluble | Se reporta. |
+
+**Lo que no hace**: completar cards, inventar evidencia ni "arreglar" el
+estado. Un sistema que se auto-repara inventando evidencia es peor que uno
+que dice "esto está roto".
+
+---
+
+## 6. El costo se controla
+
+- El costo real viene del motor (`AssistantMessage.cost`), no se estima.
+- Se contabiliza por card, por agente y por fase (implementación, review,
+  reparación).
+- Presupuestos por corrida, por card y por fase.
+- Estimación previa a una corrida grande.
+- Detección de trabajo redundante (releer el mismo contexto, repetir el
+  mismo comando).
+- Freno de emergencia: `oficina_stop` detiene la corrida; el
+  auto-continuación y el despacho se negan mientras esté detenida.
+
+---
+
+## 7. Lo que NO se promete
+
+- **No es un sandbox.** Un plugin de OpenCode no puede contener el
+  filesystem entero. El guard es una política de aplicación, y su límite
+  está en la sección 1.
+- **No garantiza que el objetivo del usuario se cumpla.** Garantiza que
+  **cada criterio de aceptación declarado** tenga evidencia. Si el criterio
+  estaba mal escrito, la evidencia lo va a reflejar.
+- **No mide la calidad de la evidencia.** Un `handoff.md` que dice "listo"
+  es evidencia de nivel 2. Que sea verdad o no depende de la revisión.
+- **No reemplaza al reviewer.** El invariante `reviewer-neq-owner` impide
+  que el owner se apruebe a sí mismo, pero no evalúa el juicio de quien
+  revisa.
+- **El benchmark mide selección, no resultado.** Dice que el sistema elige
+  bien al rol. No dice que el agente haga bien el trabajo.
+
+---
+
+## Cómo se verifica todo esto
+
+```bash
+npm test              # 385 tests: adversariales, de carrera y de recuperación
+npm run typecheck     # strict + noUncheckedIndexedAccess
+npm run coverage      # cobertura por línea
+npm run docs:check    # la documentación coincide con el código
+npm run bench:selection  # el matcher le gana a las alternativas simples
+```

package/docs/PLAN-V2.1.md

@@ -0,0 +1,144 @@
+# Plan de cierre — AI-OFFICE v2.1
+
+Fecha: 2026-10-22 · Base: `oficina-opencode@2.0.1` · Commit base: `5232fe3`
+
+## Contexto
+
+El review externoidentified 5 prioridades. Contra el snapshot viejo (decía 201 tests,
+pesos 40/35/20/5, 4 commits) algunas cosas **ya están resueltas**:
+
+| Punto del review | Estado real |
+|---|---|
+| Pesos 40/35/20/5 | YA RESUELTO — ahora 35/28/18/10/5 + recall/focus de misión |
+| "201 tests" | YA RESUELTO — 213 tests, 14 archivos |
+| "4 commits" | YA RESUELTO — 6 commits |
+| README clone con URL vieja | YA RESUELTO — 13 referencias corregidas, 2.0.1 publicado |
+
+El resto **es real y verificado contra el código**:
+
+| # | Hallazgo verificado | Dónde |
+|---|---|---|
+| 1 | `path.relative` sin realpath → **escape por symlink** | `scopeGuard.ts:95-98` |
+| 2 | `mayTouch: ["**"]` autoriza **cualquier** path, incluso `../../etc/passwd` | `scopeGuard.ts:53` |
+| 3 | Solo cubre `edit/write/patch/multiedit/apply_patch` — **no** `bash` ni `task` | `scopeGuard.ts:23` |
+| 4 | `extractPath` de `patch` solo lee el **primer** archivo del diff | `scopeGuard.ts:67-74` |
+| 5 | Sin protección de archivos sensibles (`.npmrc`, `.git/**`, `*.pem`) | — |
+| 6 | Subagente delegado **no hereda scope**: sin binding de sesión, el guard sale temprano | `scopeGuard.ts:88-90` |
+| 7 | `LeaseStore.acquire` es **TOCTOU**: read → check → write. Doble claim posible | `leases.ts:42-57` |
+| 8 | `Bus.nextSeq` es TOCTOU → **seq duplicados** entre emisores concurrentes | `bus.ts:88-99` |
+| 9 | Idempotencia del bus es check-then-write → **mensajes duplicados** | `bus.ts:108-111` |
+| 10 | `cardId`/`agentId`/`messageId` sin sanitizar → **path traversal** al escribir | `paths.ts:153-165`, `bus.ts:211` |
+| 11 | `spawnsUsed` nunca se incrementa → invariante `max-spawns-total` **nunca dispara** | `retry.ts:83` sin callers |
+| 12 | `transitionRun` importado y **nunca llamado**; el status se muta directo | `office.ts:28` |
+| 13 | `state.pendingGates` nunca se puebla; `state.iteration` nunca se incrementa | `types.ts:352` |
+| 14 | `savePlan` no valida `maxCards` → se pueden planear 50 cards con límite 20 | `office.ts:467` |
+| 15 | `LeaseStore.heartbeat` existe y **nadie lo llama** → los leases expiran duro | `leases.ts:62` |
+| 16 | No hay grafo de requisitos→evidencia | — |
+| 17 | No hay control de costo, tokens, tiempo ni parada de emergencia | — |
+| 18 | No hay benchmark de selección de agentes | — |
+| 19 | Cifras de la documentación hardcodeadas, sin fuente única | `README.md` |
+| 20 | Sin matriz de compatibilidad de versiones | — |
+
+## Hallazgo nuevo (no estaba en el review)
+
+La API del plugin tiene **3 hooks sin usar** que resuelven partes del problema mejor
+de lo que había planeado:
+
+- `permission.ask` → **denegar a nivel framework**, no solo en nuestro hook.
+- `tool.execute.after` → **tripwire**: detectar escrituras que pasaron el hook.
+- `chat.message` / `chat.params` → **nombre del agente y modelo por sesión**
+  (clave para P5 y para resolver el scope de subagentes).
+- `event` con `message.updated` → `AssistantMessage.cost` + `tokens{input,output,reasoning,cache}`
+  + `modelID` + `providerID` + latencia. **El costo ya viene del motor.**
+- `experimental.compaction.autocontinue` → **freno de emergencia** (desactivar el auto-continuar).
+
+## Diseño
+
+### P1 — Scope guard real (3 capas)
+
+| Capa | Mecanismo | Cubre |
+|---|---|---|
+| 1. Framework | `permission.ask` → `deny` | todas las tools, **incluidas las de subagentes** |
+| 2. Propio | `tool.execute.before` → `sandbox.check` | resolución real, symlinks, sensibles, shell |
+| 3. Detección | `tool.execute.after` → tripwire | lo que se coló (writes por shell) |
+
+`src/core/sandbox.ts` (nuevo):
+- `resolveTarget(projectRoot, raw)` → verifica NUL, normaliza con `path.resolve`,
+  **camina cada componente** con `lstat` para detectar symlinks, resuelve con
+  `realpath` el ancestro existente más profundo, y **re-valida la contención**.
+- `SENSITIVE_PATTERNS` → `.env*`, `.npmrc`, `.netrc`, `.git/**`, `*.pem|key|p12`,
+  `id_rsa*`, `.ssh/**`, `.aws/**`, `.gnupg/**`, `credentials.json`, `service-account*.json`.
+- `analyzeShellCommand(cmd)` → extrae paths de escritura (`>`, `>>`, `tee`, `cp`,
+  `mv`, `rm`, `sed -i`, `dd`, `install`, `truncate`, `touch`, `python -c`, `node -e`).
+- `checkScope(...)` → veredicto único con motivo legible.
+
+Resolución de scope de subagentes: mapa `sessionID → agent` construido con
+`chat.message` + `message.updated`, y `agent → card` desde el roster. El scope
+**hereda por el árbol de padres** de la sesión.
+
+### P2 — Requirement-to-Evidence Graph
+
+`src/core/evidence.ts` (nuevo):
+- Cada `acceptance[]` de una card es un **requisito** (nivel 1 = obligatorio).
+- Cada requisito se enlaza a: artefactos, tests citados, gates, y veredicto manual.
+- Niveles: 1 estático, 2 comportamiento, 3 validación de requisitos, 4 auditoría.
+- Invariante nuevo: `evidence-required-before-done` — sin evidencia de todos los
+  requisitos obligatorios, la card **no** pasa a `done`.
+- Gate nuevo: fase `verify`.
+
+### P3 — Documentación generada
+
+- `src/core/docsync.ts` → única fuente de verdad: escanea el catálogo real y
+  emite `{ agents, divisions, divisionsList, tools, hooks, tests }`.
+- `scripts/sync-docs.ts` → regenera las cifras en README y docs; **falla** si hay drift.
+- CI: paso que corre el script y falla si el diff no está vacío.
+- `docs/COMPATIBILITY.md` → matriz OpenCode × `@opencode-ai/plugin` generada.
+
+### P4 — Concurrencia y recuperación
+
+`src/core/atomic.ts` (nuevo):
+- `putOnce(path, content)` → `open(path, "wx")`: winner único, losers leen el existente.
+- `allocateSeq(channelDir)` → asignacion atomica con `wx` + reintento incremental.
+- `withLock(lockPath, fn)` → mutex por directorio (`mkdir` atómico).
+
+Aplicado a: lease acquire (O_EXCL + takeover de expirado), seq del bus,
+idempotencia del bus, y `safeId()` para todos los ids que se usan como nombre de archivo.
+
+`src/core/recovery.ts` (nuevo): reconciliación al arrancar — estado vs artefactos
+vs filesystem. Detecta: card en `review` sin artefactos, lease huérfano, artefacto
+sin card, `done` sin gate.
+
+### P5 — Costo y control
+
+`src/core/cost.ts` (nuevo): ledger por corrida/card/agente/fase.
+- Entrada: evento `message.updated` → `AssistantMessage.cost` + `tokens` + modelo.
+- Presupuestos: por corrida (tokens/USD), por card, y separados por fase
+  (implementación / review / reparación).
+- Estimación previa a una corrida grande.
+- Métricas: costo por requisito completado y verificado, tokens por card,
+  lecturas repetidas del mismo path (trabajo redundante).
+- Freno: `oficina_stop` + `experimental.compaction.autocontinue` desactivado +
+  el hook de idle respeta el flag.
+
+## Orden de ejecución
+
+1. `types.ts` — contratos nuevos (todo lo demás depende de esto).
+2. `sandbox.ts` + `scopeGuard.ts` + tests adversariales. **(P1)**
+3. `atomic.ts` + `leases.ts` + `bus.ts` + `paths.ts` + tests de concurrencia. **(P4)**
+4. `evidence.ts` + gate `verify` + invariante. **(P2)**
+5. `cost.ts` + tools + hook de costo. **(P5)**
+6. `recovery.ts` + hook de arranque. **(P4)**
+7. `docsync.ts` + `scripts/sync-docs.ts` + CI + `COMPATIBILITY.md`. **(P3)**
+8. Benchmark de selección.
+9. Verificación total: typecheck, tests, cobertura, build, e2e, npm pack, publish.
+
+## Criterio de terminado
+
+- [ ] typecheck strict limpio
+- [ ] todos los tests pasan (base: 213)
+- [ ] cobertura ≥ 87% stmts
+- [ ] build limpio
+- [ ] e2e verde contra el paquete instalado
+- [ ] `npm pack` sin warnings
+- [ ] documentación generada coincide con el código (CI lo verifica)
+- [ ] publicado en npm

package/docs/QUE-ES.md

@@ -1,5 +1,20 @@
 # ¿Qué es AI-OFFICE?
 
+<!-- BEGIN GENERATED: facts -->
+| | |
+|---|---|
+| **Paquete** | `oficina-opencode` v2.1.1 |
+| **Tools** | 16 |
+| **Hooks** | 7 |
+| **API de plugin** | `@opencode-ai/plugin@1.15.11` |
+| **Node** | >=20 |
+| **Catálogo** | 258 agentes resolubles en 18 divisiones |
+| **Divisiones** | academic, design, engineering, finance, game-development, gis, healthcare, marketing, paid-media, product, project-management, research, sales, spatial-computing, specialized, strategy, support, testing |
+| **Límites** | 20 cards · 40 llamadas · 20 spawns · 10 agentes |
+| **Cobertura mínima** | 60% |
+<!-- END GENERATED: facts -->
+
+
 > Una oficina de agentes de IA para OpenCode. Le das un objetivo, y el equipo lo trabaja, lo revisa, lo verifica y no para hasta terminarlo.
 
 Este documento explica el sistema sin jerga. Si querés saber **cómo está construido por dentro**, está [`docs/ARCHITECTURE.md`](ARCHITECTURE.md). Si querés **usarlo**, está el [README](../README.md).

package/docs/catalog-facts.json

@@ -0,0 +1,27 @@
+{
+  "agents": 258,
+  "divisions": 18,
+  "divisionList": [
+    "academic",
+    "design",
+    "engineering",
+    "finance",
+    "game-development",
+    "gis",
+    "healthcare",
+    "marketing",
+    "paid-media",
+    "product",
+    "project-management",
+    "research",
+    "sales",
+    "spatial-computing",
+    "specialized",
+    "strategy",
+    "support",
+    "testing"
+  ],
+  "source": "C:\\Users\\Marcos\\agency-agents",
+  "generatedAt": "2026-10-22T02:57:59.378Z",
+  "sourceCommit": "4e3ac3c"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oficina-opencode",
-  "version": "2.0.1",
+  "version": "2.1.1",
   "description": "Oficina de Agents — malla de coordinadores + peer mesh para OpenCode. Orquestación durable de subagentes con bus de mensajes en disco, roster de roles, leases, gates de calidad y escalamiento por invariantes.",
   "license": "MIT",
   "type": "module",
@@ -68,7 +68,10 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "coverage": "npm run build && vitest run --coverage",
-    "prepublishOnly": "npm run typecheck && npm run test && npm run build"
+    "prepublishOnly": "npm run typecheck && npm run test && npm run build && npm run docs:check",
+    "docs:sync": "tsx scripts/sync-docs.ts",
+    "docs:check": "tsx scripts/sync-docs.ts --check",
+    "bench:selection": "tsx benchmarks/selection/run.ts"
   },
   "dependencies": {
     "@opencode-ai/plugin": "^1.15.11",
@@ -76,6 +79,7 @@
   },
   "devDependencies": {
     "@types/node": "^24.12.2",
+    "tsx": "^4.20.3",
     "typescript": "^5.8.2",
     "vitest": "^3.2.4",
     "@vitest/coverage-v8": "^3.2.4"