oficina-opencode 3.0.4 → 3.1.0

package/docs/PRUEBA-E2E.md

@@ -0,0 +1,479 @@
+# Prueba end-to-end de AI-OFFICE
+
+Runbook ejecutable. Cada nivel dice **qué hacer**, **qué escribir**, **qué esperás** y
+**cómo lo verificás**.
+
+Podés parar en cualquier nivel: cada uno es independiente. El veredicto final sale del
+Nivel 7, que corre un solo comando.
+
+**Tiempo total estimado:** 45-70 minutos (la mayor parte es la corrida real, Nivel 3).
+
+---
+
+## Antes de empezar
+
+### La regla que más importa
+
+> **Abrí OpenCode en `C:\prueba-oficina`.**
+
+No en la **carpeta personal del usuario** (p. ej. `%USERPROFILE%`). El motivo es concreto y no es obvio:
+
+La carpeta personal **no** es un proyecto (no tiene `package.json` ni `.git`), pero tiene
+**14 subdirectorios que sí lo son**. `resolveProjectRoot` busca en los subdirectorios y,
+como hay varios candidatos, elige por peso de fuentes. El resultado es aleatorio: podés
+terminar escribiendo la corrida en un checkout cualquiera del plugin.
+
+Verificá dónde estás antes de abrir OpenCode:
+
+```powershell
+cd C:\prueba-oficina
+```
+
+### Variables para las sesiones de PowerShell
+
+Copiá esto en la terminal y dejalo abierto:
+
+```powershell
+$OFICINA = "$env:USERPROFILE\.config\opencode\node_modules\.bin\oficina.cmd"
+$REPO    = "<checkout local del plugin AI-OFFICE>"
+$PROY    = "C:\prueba-oficina"
+```
+
+> `oficina` **no está en el PATH**. Por eso la variable `$OFICINA`. Si lo querés en el
+> PATH: `setx PATH "$env:PATH;$env:USERPROFILE\.config\opencode\node_modules\.bin"`.
+
+### Reinstalar el plugin
+
+```powershell
+$cfg = "$env:USERPROFILE\.config\opencode"
+Set-Location $cfg
+npm install oficina-opencode@3.0.4 --no-audit --no-fund --prefer-online
+node ".\node_modules\oficina-opencode\dist\cli.js" install --target $cfg --json
+```
+
+**Cerrá OpenCode y volvé a abrirlo.** El plugin se carga al arrancar la sesión: si lo
+reinstalás con OpenCode abierto, la sesión actual sigue con la versión vieja.
+
+### El proyecto de prueba ya está armado
+
+`C:\prueba-oficina` contiene:
+
+```
+package.json      →  "test": "node test/run.js"
+src/              →  vacío
+test/run.js       →  runner que falla si no corrió ningún test
+```
+
+**Por qué el runner y no `node --test` directo:** `node --test` sale con **exit 0**
+aunque no encuentre un solo archivo de test:
+
+```
+$ node --test "test/**/*.test.js"
+# tests 0
+exit code: 0
+```
+
+Un gate así está **verde antes de que exista el trabajo**. `test/run.js` corrige eso:
+
+| Escenario | Exit |
+|---|---|
+| sin ningún test | **1** (gate rojo) |
+| test que pasa | 0 |
+| test que falla | 1 |
+
+---
+
+## Nivel 0 — Salud del repo (3 min, no necesita OpenCode)
+
+```powershell
+Set-Location $REPO
+npm run typecheck
+npm test
+npm run build
+npm run docs:check
+npm run bench:selection
+npm pack --dry-run
+```
+
+| Comando | Esperado |
+|---|---|
+| `typecheck` | 0 errores |
+| `test` | `Test Files 26 passed (26)` · `Tests 419 passed (419)` |
+| `build` | sin errores |
+| `docs:check` | `README.md: al dia` · `docs/QUE-ES.md: al dia` |
+| `bench:selection` | `completo 71%` y le gana a `keywords 48%` y `solo-nombre 52%` |
+| `pack --dry-run` | 173 archivos, ~328 KB |
+
+> **El `docs:check` es una trampa real.** Si bumpeás la versión y no corrés
+> `npm run docs:sync`, falla. Es el mecanismo de doc autogenerada funcionando.
+
+---
+
+## Nivel 1 — ¿Cargó el plugin? (2 min)
+
+Abrí OpenCode **en `C:\prueba-oficina`** y escribí:
+
+```
+Usá la tool `oficina_board` y mostrame el tablero de la oficina.
+```
+
+| Respuesta | Significado |
+|---|---|
+| Devuelve un tablero | ✅ el plugin cargó |
+| "No tengo la tool `oficina_board`" | ❌ el plugin no cargó |
+
+Verificación en el log:
+
+```powershell
+Get-Content "$env:USERPROFILE\.local\share\opencode\log\opencode.log" -Tail 400 |
+  Select-String "oficina" | Select-Object -Last 5
+```
+
+Buscá esta línea:
+
+```
+INFO oficina:v2: plugin inicializado {"directory":"C:\\prueba-oficina",...,"tools":16}
+```
+
+Si aparece `failed to load plugin target=oficina`, el problema es la versión: OpenCode
+v2 necesita `@opencode/plugin`, no `@opencode-ai/plugin`.
+
+---
+
+## Nivel 2 — El CLI (3 min, en un directorio aparte)
+
+```powershell
+$scratch = "C:\scratch-oficina"
+Remove-Item $scratch -Recurse -Force -ErrorAction SilentlyContinue
+mkdir $scratch -Force
+Set-Content "$scratch\package.json" '{ "name": "scratch" }'
+
+& $OFICINA init "Prueba del CLI" --directory $scratch
+& $OFICINA status --directory $scratch
+& $OFICINA board  --directory $scratch
+& $OFICINA bus    --directory $scratch
+& $OFICINA catalog --agency-root "$env:USERPROFILE\agency-agents" | Select-Object -First 10
+& $OFICINA audit T-99 --directory $scratch
+& $OFICINA verify --directory $scratch
+& $OFICINA reset --directory $scratch
+& $OFICINA reset --directory $scratch --force
+```
+
+| Comando | Esperado |
+|---|---|
+| `init` | JSON con `"ok": true`, `officeDir`, `projectRoot`, `runId` |
+| `status` | `Estado: planning` · `Presupuesto: 0/20 cards` |
+| `board` | tabla vacía, sin error |
+| `bus` | 4 canales en 0 mensajes |
+| `catalog` | lista los agentes. **Necesita `--agency-root`** (si no, "Falta --agency-root.") |
+| `audit T-99` | sale con error: `No existe la card T-99.` (exit 1) |
+| `verify` | sección de gates vacía, sin error |
+| `reset` | **pide confirmación**: "Re-ejecutá con --force para confirmar." |
+| `reset --force` | borra |
+
+---
+
+## Nivel 3 — La corrida real (el evento principal)
+
+### 3.1 Abrí la sesión
+
+```powershell
+cd C:\prueba-oficina
+```
+
+Abrí OpenCode **ahí**. En una segunda terminal dejá `$OFICINA` y `$PROY` definidos, para
+poder mirar la mesa mientras corre.
+
+### 3.2 El objetivo — copiá esto tal cual
+
+```
+/oficina Crear un modulo de utilidades de texto en src/texto.js con dos funciones: slugify(texto), que convierte un titulo en un slug (minusculas, sin acentos, con guiones), y contarPalabras(texto), que cuenta las palabras separadas por espacios. Los tests van en test/texto.test.js y la documentacion de la API en docs/API.md.
+```
+
+### 3.3 Qué mirar en los primeros 60 segundos
+
+**a) El plan.** Tiene que ser un desglose de **3 cards**: implementación, tests,
+documentación. Cada una con criteria de aceptación verificables, scope y gate. Si el
+plan sale con una sola card gigante, no es un error — pero anotá que el plan fue de 1.
+
+**b) El rol que eligió el dispatch.** Este es **el chequeo clave**.
+
+Mirá la salida del dispatch. El rol tiene que ser coherente con las capabilities de la
+card. Un rol de otro dominio es exactamente el bug que arreglé en 3.0.3 (a una card de
+"utilidades de texto" le tocaba un *ServiceNow Developer Mentor*).
+
+Si ves un rol absurdo:
+
+```
+/oficina-stop
+```
+
+o pedí que frene: `oficina_stop` con `action="halt"`.
+
+Un rol **fabricado** (que no viene del catálogo) también es válido — siempre que el
+despacho lo diga explícitamente. Un rol del catálogo con cobertura baja **también**,
+mientras lo diga.
+
+### 3.4 Mientras corre — mirá la mesa
+
+```powershell
+& $OFICINA board  --directory $PROY
+& $OFICINA status --directory $PROY
+```
+
+Los estados de card posibles: `todo`, `in_progress`, `review`, `done`, `blocked`,
+`escalated`.
+
+### 3.5 Cuando termine — el checklist
+
+La corrida dejó esto:
+
+```
+C:\prueba-oficina\.oficina\
+  state.json
+  roster.json
+  cost.json
+  artifacts\T-00\handoff.md
+  artifacts\T-00\gates.md
+  artifacts\T-00\evidence.md
+  evidence\T-00.json
+```
+
+Y los entregables:
+
+```
+C:\prueba-oficina\src\texto.js
+C:\prueba-oficina\test\texto.test.js
+C:\prueba-oficina\docs\API.md
+```
+
+**Los 5 criterios que tiene que cumplir:**
+
+| # | Criterio | Cómo lo verificás |
+|---|---|---|
+| 1 | `src/texto.js` existe y exporta las dos funciones | `node -e "console.log(Object.keys(require('C:/prueba-oficina/src/texto.js')))"` |
+| 2 | `slugify` saca acentos, pasa a minúsculas y une con guiones | `node -e "const {slugify}=require('C:/prueba-oficina/src/texto.js'); console.log(slugify('Hola Mundo Ávil'))"` → `hola-mundo-avil` |
+| 3 | `contarPalabras` cuenta palabras separadas por espacios | `node -e "const {contarPalabras}=require('C:/prueba-oficina/src/texto.js'); console.log(contarPalabras('uno dos  tres'))"` → `3` |
+| 4 | `npm test` corre la suite y sale con exit 0 | `cd C:\prueba-oficina; npm test; echo $LASTEXITCODE` → `0` |
+| 5 | La evidencia incluye la **verificación negativa** | abrir `.oficina\artifacts\T-00\evidence.md` |
+
+El punto 5 es el que más dice: la oficina tiene que **romper el código a propósito** y
+comprobar que el test lo detecta. Si la evidencia solo dice "npm test pasó", la card
+cerró sin probar que el test sirva.
+
+### 3.6 El veredicto automático
+
+```powershell
+Set-Location $REPO
+npx tsx scripts\diagnose-run.ts C:\prueba-oficina
+```
+
+Esperado: **0 fallas**. Si hay fallas, son invariantes rotos (mirá abajo).
+
+---
+
+## Nivel 4 — Adversarial (10 min, mismo proyecto)
+
+Cada prueba es un mensaje para OpenCode. Todas tienen una respuesta **correcta** clara.
+
+### 4.1 El scope se respeta de verdad
+
+En la misma sesión (o una nueva abierta en `C:\prueba-oficina`), escribí:
+
+```
+Toma la card T-00 con oficina_assign y despues intentá escribir un archivo nuevo README.md en la raiz del proyecto, que esta fuera del scope de la card. Decime exactamente que responde el motor.
+```
+
+| Correcto | Incorrecto |
+|---|---|
+| La escritura se **rechaza** con un error de scope | El archivo `README.md` aparece en el proyecto |
+
+Verificalo en disco:
+
+```powershell
+Test-Path C:\prueba-oficina\README.md   # tiene que dar False
+```
+
+### 4.2 Nadie se auto-aprueba
+
+```
+Intentá registrar el review de la card T-00 con tu propio agentId, o sea revisarte a vos mismo. Decime que responde el motor.
+```
+
+| Correcto | Incorrecto |
+|---|---|
+| El motor **rechaza**: el owner no puede ser su propio reviewer | El review queda registrado con owner == reviewer |
+
+### 4.3 El gate es real (rompé el código)
+
+```
+Rompe src/texto.js a proposito, de modo que slugify devuelva siempre la cadena vacia, y corré el gate de esa card. Decime que paso.
+```
+
+| Correcto | Incorrecto |
+|---|---|
+| El gate **falla** y la card vuelve a trabajo | El gate pasa en verde |
+
+**Restaurá el código después** (o volvé a correr `/oficina` para que la oficina lo arregle).
+
+### 4.4 El freno de emergencia
+
+```
+Frená la corrida con oficina_stop, y despues reanudala con action resume.
+```
+
+| Correcto | Incorrecto |
+|---|---|
+| `state.json` muestra `halt` con motivo, y después queda en `null` | El freno no hace nada |
+
+### 4.5 El costo se lleva
+
+```
+Mostrame el costo de la corrida con oficina_cost.
+```
+
+Esperado: el total en USD, las llamadas y los tokens. Con tu modelo (MiniMax M3.1 Flash
+Free) el USD va a ser **$0.0000** — eso es correcto, no un bug. Lo que tiene que estar
+bien es el conteo de llamadas y tokens.
+
+---
+
+## Nivel 5 — Recuperación (5 min, proyecto aparte)
+
+Esta es la prueba de **durabilidad**: que la oficina sobreviva a una muerte.
+
+### 5.1 Preparar y arrancar
+
+```powershell
+$adv = "C:\prueba-oficina-adv"
+Remove-Item $adv -Recurse -Force -ErrorAction SilentlyContinue
+mkdir "$adv\src" -Force
+mkdir "$adv\test" -Force
+Copy-Item "C:\prueba-oficina\package.json" $adv
+Copy-Item "C:\prueba-oficina\test\run.js" "$adv\test\run.js" -Force
+cd $adv
+```
+
+Abrí OpenCode en `C:\prueba-oficina-adv` y:
+
+```
+/oficina Crear un archivo src/saludo.js que exporte una funcion saludo(nombre) que devuelva "Hola, <nombre>!". Con su test en test/saludo.test.js.
+```
+
+### 5.2 Matarla en caliente
+
+Cuando veas que empezó a trabajar (**mientras la card está `in_progress`**), cerrá la
+ventana de OpenCode de golpe. No dejes que termine.
+
+### 5.3 Reanimarla
+
+Abrí OpenCode de nuevo **en el mismo directorio** y escribí:
+
+```
+Revisá el estado de la oficina y decime si la corrida quedó consistente o hay algo roto.
+```
+
+| Correcto | Incorrecto |
+|---|---|
+| La oficina detecta la inconsistencia y la reporta | Dice "todo bien" con una card colgada |
+
+Y desde la terminal:
+
+```powershell
+& $OFICINA board --directory $adv
+& $OFICINA status --directory $adv
+Set-Location $REPO
+npx tsx scripts\diagnose-run.ts C:\prueba-oficina-adv
+```
+
+Lo que tiene que aparecer: la card con su estado real, y el diagnóstico reportando
+inconsistencias (por ejemplo, el owner fantasma) en vez de un "todo bien" falso.
+
+---
+
+## Nivel 6 — Cerrar y limpiar
+
+```powershell
+& $OFICINA reset --directory $PROY --force
+& $OFICINA reset --directory $adv  --force
+Remove-Item C:\scratch-oficina -Recurse -Force -ErrorAction SilentlyContinue
+```
+
+Los artefactos de la corrida se borran con `reset`. Si querés conservarlos para
+analizarlos, **no corras `reset` todavía**: el Nivel 7 los necesita.
+
+---
+
+## Nivel 7 — Veredicto final (1 min)
+
+```powershell
+Set-Location $REPO
+npx tsx scripts\diagnose-run.ts C:\prueba-oficina
+```
+
+Salida con exit code **0** = todos los invariantes se sostienen. Exit 1 = hay al menos
+uno roto.
+
+Los 7 invariantes que verifica:
+
+| # | Invariante | Cómo se viola |
+|---|---|---|
+| 1 | Ninguna card cerrada sin gates en PASS | El gate estaba en FAIL pero la card se cerró |
+| 2 | Ninguna card cerrada sin evidencia para **cada** criterio | Falta evidencia para un criterio de aceptación |
+| 3 | Nadie se auto-aprueba | `owner == reviewer` |
+| 4 | Ninguna card sin owner | Cardcolgada sin nadie que la tome |
+| 5 | Todo owner existe en el roster | El agente murió o el roster se perdió |
+| 6 | Presupuesto respetado | Más cards / llamadas / spawns que los permitidos |
+| 7 | Todo gate `NA` explica por qué | Una fase que nadie corrió, sin motivo |
+
+Las secciones del diagnóstico:
+
+```
+1. ESTADO         objetivo, run, presupuesto, freno
+2. CARDS          cada card con su scope, gate, acceptance, owner, reviewer
+3. EL EQUIPO      qué rol se eligió y si es coherente con la card
+4. ARTEFACTOS     gates, handoff, evidencia por card
+5. EL BUS         mensajes entre agentes
+6. COSTO          USD, llamadas, tokens
+7. RECONCILIACIÓN  estado vs artefactos vs filesystem
+8. INVARIANTES    ← el veredicto
+9. VEREDICTO
+```
+
+---
+
+## Tarjeta de resultados
+
+| Nivel | Qué verificaba | Resultado |
+|---|---|---|
+| 0 | Repo sano | ☐ |
+| 1 | El plugin carga | ☐ |
+| 2 | El CLI responde | ☐ |
+| 3 | La corrida real completa | ☐ |
+| 3.5 | Los 5 criterios del entregable | ☐ |
+| 4.1 | El scope bloquea | ☐ |
+| 4.2 | Nadie se auto-aprueba | ☐ |
+| 4.3 | El gate falla si el código está roto | ☐ |
+| 4.4 | El freno funciona | ☐ |
+| 4.5 | El costo se lleva | ☐ |
+| 5 | La oficina sobrevive a una muerte | ☐ |
+| 7 | 0 fallas en los invariantes | ☐ |
+
+**Si algo falla**, el lugar exacto para mirar es
+`C:\prueba-oficina\.oficina\artifacts\<card>\gates.md` (la salida real de cada comando)
+y `C:\prueba-oficina\.oficina\evidence\<card>.json` (el grafo de evidencia).
+
+---
+
+## Lo que NO se testea acá
+
+- **La suite automatizada** (419 tests) ya cubre: sandbox, guard de scope, herencia de
+  scope en subagentes, concurrencia, atomicidad, evidencia, gates, costo, recovery,
+  matcher, dispatch, router, state machine, CLI, docsync.
+  Corré `npm test` para eso.
+- **El catálogo de 258 agentes**: `oficina catalog --agency-root ...` los lista, y el
+  benchmark mide la calidad del matching (71% hit@1).
+- **La carga bajo OpenCode v1**: el entry `./v1` existe y tiene sus tests, pero tu
+  OpenCode es v2. No es una prioridad.
+- **Multi-proyecto / concurrencia real entre corridas**: el motor lo soporta
+  (`withLock`, leases), pero probarlo requiere dos sesiones simultáneas.

package/docs/QUE-ES.md

@@ -3,15 +3,14 @@
 <!-- BEGIN GENERATED: facts -->
 | | |
 |---|---|
-| **Paquete** | `oficina-opencode` v3.0.4 |
-| **Tools** | 16 |
+| **Paquete** | `oficina-opencode` v3.1.0 |
+| **Tools** | 15 |
 | **Hooks** | 7 |
 | **API de plugin** | `@opencode/plugin@2.1.2` |
-| **Node** | >=20 |
+| **Node** | >=22 |
 | **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% |
+<!-- Catalog source: agency-agents @ 4e3ac3c -->
 <!-- END GENERATED: facts -->
 
 

package/docs/SEGURIDAD-REPO.md

@@ -0,0 +1,83 @@
+# Hardening del repo y de npm — cierre a maldades
+
+Checklist operativa para que **nadie que no sea el mantenedor** pueda pushear,
+publicar o borrar nada. Divide las medidas en lo que ya vive en el repo
+(aplicado en archivos) y lo que se activa una vez en la web de GitHub y de npm.
+
+---
+
+## Parte A — Ya aplicado en el repo
+
+| Medida | Archivo | Qué cierra |
+|---|---|---|
+| Revisión del owner obligatoria en todo el árbol | `.github/CODEOWNERS` | PRs que tocan código sin el visto bueno del owner |
+| Superficie CI/seguridad/empaquetado con protección explícita | `.github/CODEOWNERS` | Manipulación de workflows, policy de seguridad o manifest |
+| Dependabot semanal (npm + Actions) | `.github/dependabot.yml` | Dependencias y actions que quedan viejas; majors manuales a propósito |
+| Publicación OIDC con provenance, environment protegido, sin token de larga vida | `.github/workflows/publish.yml` | Spoofing de publicación, robo de token, publicar algo que no pasó el suite |
+| Corredor de verificación previa en el publish | `prepublishOnly` + workflow | Publicar typecheck/test/docs en rojo |
+| Política de seguridad sin datos de contacto inventados | `SECURITY.md` | Reportes por canales no verificados |
+
+---
+
+## Parte B — Activar una vez en GitHub (UI del repositorio)
+
+Settings → Saltar al punto → clícalo y listo:
+
+1. **Branch protection de `main`** (Settings → Branches → Add branch ruleset):
+   - ✅ *Require a pull request before merging* (1 revisión mínima).
+   - ✅ *Require review from Code Owners* — activa la CODEOWNERS de arriba.
+   - ✅ *Require status checks to pass before merging* con estos jobs:
+     `verify (ubuntu-latest, 24) · verify (ubuntu-latest, 22) · verify (windows-latest, 24) · verify (windows-latest, 22) · docs · smoke · install-verify`.
+   - ✅ *Require branches to be up to date before merging*.
+   - ✅ *Do not allow bypassing the above settings* (ni apps ni admins).
+   - ❌ **Nunca**: *Allow force pushes* · *Allow deletions*.
+
+2. **Ruleset de tags** (Settings → Rules → Rulesets → New → Tag ruleset):
+   - Protege `v*`: solo el owner crea tags. Evita que un tag spurio dispare
+     publicidad falsa de versiones.
+
+3. **Permisos de Actions** (Settings → Actions → General):
+   - ⛔ *Read and write permissions* → cambiar a **Read repository contents** por defecto.
+   - ✅ Requiere aprobación de colaboradores para workflows de PRs de primera vez.
+   - ✅ Alta del *GitHub Actions* no admite escalación: el token ahora no puede
+     pushear ni publicar aunque un agente se piratee.
+
+4. **Secretos** (Settings → Secrets and variables):
+   - No necesitas `NPM_TOKEN` si configuras *Trusted Publishing* (punto C.3).
+   - Si igual la almacenas: granular (`oficina-opencode` únicamente), con 2FA
+     obligatoria y vencido corto mejor que eterno.
+
+5. **Dependabot alerts + security notifications** (Settings → Security):
+   - ✅ Dependabot alerts · Code scanning (si se suma CodeQL luego) · Secret scanning.
+
+---
+
+## Parte C — Activar una vez en npm (npmjs.com)
+
+1. **2FA en la cuenta** (Account settings → Security): siempre, obligatoria.
+2. **Package settings de `oficina-opencode`**:
+   - ✅ *Require two-factor authentication to publish or change settings* (ON — es el default ahora).
+   - Mantenedores: **solo el owner**. Cualquier colaboración va por PR, no por copropiedad del paquete.
+3. **Trusted Publishing** (Package settings → Publishing access):
+   - Vincula el repo `SOCRAMbt/AI-OFFICE` con el workflow `.github/workflows/publish.yml`.
+   - Con esto la publicación usa OIDC: **no existe token que filtrar** y npm
+     firma la provenance (SLSA 3) del artefacto.
+4. **Publicar siempre con provenance**:
+   ```bash
+   npm publish --provenance
+   ```
+   El workflow ya lo hace. Instaladores verosificables con
+   `npm view oficina-opencode dist.attestations`.
+
+---
+
+## Verificación rápida del cierre
+
+```bash
+# ¿Quién puede tocar main? → nadie sin PR del owner (Parte B.1)
+# ¿Quién puede publicar? → solo el workflow OIDC del repo (Parte C.3)
+# ¿Un PR de un extraño tocará CODEOWNERS? → GitHub lo exige en aprobación automática
+```
+
+Si algo de la Parte B/C no está activado, el cierre técnico queda a medias:
+los archivos del repo son la mitad grosera; los toggles de la web son la otra.

package/docs/assets/banner.svg

@@ -0,0 +1,42 @@
+<svg width="1000" height="240" viewBox="0 0 1000 240" fill="none" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="AI-OFFICE — una oficina de agentes para OpenCode">
+  <defs>
+    <linearGradient id="accent" x1="0" y1="0" x2="1000" y2="0" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#7c3aed"/>
+      <stop offset="0.55" stop-color="#22a06b"/>
+      <stop offset="1" stop-color="#f59e0b"/>
+    </linearGradient>
+    <linearGradient id="heroText" x1="120" y1="60" x2="880" y2="160" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#f8fafc"/>
+      <stop offset="1" stop-color="#cbd5f5"/>
+    </linearGradient>
+    <pattern id="grid" width="40" height="40" patternUnits="userSpaceOnUse">
+      <path d="M 40 0 L 0 0 0 40" stroke="#1c2333" stroke-width="1"/>
+    </pattern>
+  </defs>
+
+  <rect width="1000" height="240" rx="18" fill="#0b0f19"/>
+  <rect width="1000" height="240" rx="18" fill="url(#grid)" opacity="0.55"/>
+  <rect x="0.5" y="0.5" width="999" height="239" rx="17.5" stroke="#232b3e"/>
+
+  <!-- desk motif: a minimal "office" abstract -->
+  <g opacity="0.9">
+    <rect x="856" y="150" width="7" height="62" rx="3" fill="#22a06b"/>
+    <rect x="869" y="132" width="7" height="80" rx="3" fill="#7c3aed"/>
+    <rect x="882" y="164" width="7" height="48" rx="3" fill="#f59e0b"/>
+    <rect x="808" y="204" width="170" height="8" rx="4" fill="#1c2333"/>
+    <circle cx="823" cy="132" r="9" stroke="#3b4664" stroke-width="2"/>
+    <rect x="808" y="146" width="30" height="4" rx="2" fill="#2a3350"/>
+  </g>
+
+  <g opacity="0.65">
+    <circle cx="92" cy="196" r="3" fill="#7c3aed"/>
+    <circle cx="110" cy="196" r="3" fill="#22a06b"/>
+    <circle cx="128" cy="196" r="3" fill="#f59e0b"/>
+  </g>
+
+  <text x="72" y="104" font-family="'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="76" font-weight="800" letter-spacing="4" fill="url(#heroText)">AI-OFFICE</text>
+  <rect x="74" y="126" width="212" height="4" rx="2" fill="url(#accent)"/>
+
+  <text x="74" y="168" font-family="'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="23" fill="#9aa4b2">Una oficina de agentes para OpenCode donde el trabajo</text>
+  <text x="74" y="198" font-family="'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="23" fill="#9aa4b2">no se detiene cuando el modelo dice «terminé».</text>
+</svg>

package/docs/catalog-facts.json

@@ -21,7 +21,7 @@
     "support",
     "testing"
   ],
-  "source": "C:\\Users\\Marcos\\agency-agents",
-  "generatedAt": "2026-10-22T02:57:59.378Z",
+  "source": "agency-agents",
+  "generatedAt": "2026-10-28T21:18:00.000Z",
   "sourceCommit": "4e3ac3c"
-}
+}