oficina-opencode 3.0.5 → 3.1.1

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"
-}
+}

package/docs/superpowers/specs/2026-10-29-factory-skill-creator-and-remove-budget.md

@@ -0,0 +1,182 @@
+# Plan: Factory Auto-Crea Skills Persistentes + Eliminación Total del Sistema de Coste/Límites
+
+## Objetivo
+1. **Factory → Skill Creator automático**: Cuando el despacho no encuentra match (cobertura < 30%), en vez de fabricar un rol efímero de corrida, **invoca la lógica de `agency-agent-creator` para generar un archivo de agente persistente** en `<projectRoot>/.opencode/agents/<slug>.md` con la plantilla de 10 secciones Agency-Agents, que queda disponible para futuras corridas y para invocación directa (`@oficina-...`).
+2. **Catálogo vivo**: El catálogo de matching (`catalog.ts`) debe descubrir dinámicamente los agentes creados en `.opencode/agents/` e incluirlos en futuros despachos.
+3. **Eliminar todo el sistema de coste/tokens/límites**: Borrar `cost.ts`, `oficina_cost`, `Budget`, `Limits` (maxCards, maxAgentCalls, maxSpawnsTotal, etc.), enforcement en `state.ts`, `dispatch.ts`, `office.ts`, `retry.ts`, `mesa.ts`, `docsync.ts`, `systemPrompt.ts`, `cli.ts`, `router.ts`, y tests asociados.
+
+---
+
+## Archivos a modificar
+
+### Fase 1: Eliminar sistema de coste/límites (breaking change)
+
+| Archivo | Cambios |
+|---|---|
+| `src/core/types.ts` | Eliminar `Budget` interface, campos `maxCards`, `maxAgentCalls`, `maxSpawnsTotal` de `Limits`, campos `budget` de `OfficeState`, `Card` |
+| `src/core/state.ts` | Eliminar validaciones de presupuesto en `validateState`, simplificar `migrateState` |
+| `src/core/dispatch.ts` | Eliminar `maxAgents` de `DispatchOptions`, eliminar tracking de `budget`, eliminar checks de presupuesto |
+| `src/core/office.ts` | Eliminar `Limits` import, eliminar checks de `maxCards`, simplificar constructor |
+| `src/core/retry.ts` | Eliminar `hasBudget` o simplificar a siempre `ok: true` |
+| `src/core/mesa.ts` | Eliminar display de presupuesto |
+| `src/core/docsync.ts` | Eliminar `maxCards` de `CatalogFacts`, eliminar display de límites |
+| `src/core/systemPrompt.ts` | Eliminar presupuesto del prompt |
+| `src/core/router.ts` | Eliminar `delegateBudget` defaults |
+| `src/core/factory.ts` | Eliminar `delegateBudget` de `FactoryInput` |
+| `src/cli.ts` | Eliminar display de presupuesto en `status`, eliminar flags de presupuesto en comandos |
+| `src/tools/index.ts` | Eliminar tool `oficina_cost`, eliminar imports de `cost.ts` |
+| `src/core/cost.ts` | **ELIMINAR ARCHIVO COMPLETO** |
+
+### Fase 2: Factory crea agentes persistentes (skill creator automático)
+
+| Archivo | Cambios |
+|---|---|
+| `src/core/factory.ts` | Nueva función `createPersistentAgentSkill()` que genera el archivo `.md` en `.opencode/agents/` usando la plantilla 10-secciones de agency-agent-creator |
+| `src/core/dispatch.ts` | En `instantiateFactory`: en vez de crear `Ficha` runtime, llamar a `createPersistentAgentSkill()`, guardar archivo, y registrar en catálogo dinámico |
+| `src/core/catalog.ts` | Nueva función `loadDynamicAgents()` que escanea `.opencode/agents/` y parsea capabilities del frontmatter/cuerpo |
+| `src/core/catalog.ts` | `buildPanel` y `resolveRole` deben incluir agentes dinámicos en el catálogo |
+| `src/core/office.ts` | Cargar catálogo dinámico al inicializar |
+
+### Fase 3: Tests y limpieza
+
+| Archivo | Cambios |
+|---|---|
+| `tests/*.test.ts` | Actualizar tests que dependen de budget/cost/factory vieja |
+| `tests/dispatch.test.ts` | Tests nuevos para factory persistente + catálogo vivo |
+| `tests/catalog.test.ts` | Tests para matching con agentes dinámicos |
+
+---
+
+## Detalle técnico: Factory persistente
+
+### Plantilla del agente (basada en agency-agent-creator)
+
+El archivo generado en `.opencode/agents/<slug>.md`:
+
+```markdown
+---
+name: {{display_name}}
+description: {{one_line_description}}
+vibe: {{curated_vibe_mindset}}
+mode: subagent
+permission:
+  edit: allow
+  shell: allow
+  task: allow
+---
+
+# {{display_name}} Agent Personality
+
+You are **{{display_name}}**, a specialist in {{capabilities_list}} focused on {{mission_phrase}}.
+
+## Your Identity & Memory
+- **Role**: Specialist in {{primary_domain}} with deep expertise in {{key_technologies}}.
+- **Personality**: Direct, pragmatic, and detail-oriented.
+- **Memory**: Durable disk artifacts and communication logs; never hidden session memory.
+- **Experience**: Edge cases, error recovery, and security boundaries.
+
+## Your Core Mission
+### {{Mission_1_Title}}
+{{Mission_1_Description}}
+
+## Critical Rules You Must Follow
+1. Scope is a hard boundary, not a suggestion. Touch only authorized files.
+2. No evidence, no work. Claims without command output (evidence.md) are hypotheses.
+3. Never review or approve your own work.
+4. Ask before guessing via the office bus (oficina_bus).
+5. Acknowledge omissions and gaps explicitly in handoff.md.
+
+## Your Technical Deliverables
+- Clean code within assigned scope.
+- handoff.md: Technical summary and decisions.
+- evidence.md: Verbatim terminal output with exit codes.
+
+## Your Workflow Process
+### Step 1: Understand the Terrain
+### Step 2: Decide the Approach
+### Step 3: Execute Within Scope
+### Step 4: Verify and Hand Off
+
+## Your Communication Style
+Direct, structured triage of incoming bus requests, zero ambiguity.
+
+## Learning & Memory
+Avoid domain-specific failure modes: {{failure_modes_list}}.
+
+## Your Success Metrics
+1. All acceptance criteria satisfied with verifiable evidence.
+2. Gates (build, typecheck, test, security) exit 0.
+3. Zero out-of-scope files touched.
+
+## Advanced Capabilities
+{{capability_tokens_space_separated}}
+```
+
+### Extracción de capabilities para matching
+
+El catálogo necesita leer `capabilities` del agente. Opciones:
+- **Frontmatter**: agregar `capabilities: [token1, token2, ...]` al YAML
+- **Parsing del cuerpo**: extraer de "Advanced Capabilities" o "Your Core Mission"
+- **Archivo sidecar**: `<slug>.capabilities.json` (más robusto)
+
+**Decisión**: Agregar `capabilities` al frontmatter YAML como array. El parser del catálogo lo lee directamente.
+
+### Catálogo dinámico
+
+```typescript
+// En catalog.ts
+export interface DynamicAgent {
+  slug: string
+  displayName: string
+  description: string
+  capabilities: string[]
+  division: string // inferida del slug o "factory"
+  path: string // ruta al archivo .md
+  source: "dynamic"
+}
+
+export async function loadDynamicAgents(projectRoot: string): Promise<DynamicAgent[]> {
+  const agentsDir = path.join(projectRoot, ".opencode", "agents")
+  // leer todos los .md, parsear frontmatter, extraer capabilities
+}
+```
+
+`buildPanel` recibe `catalog: CatalogAgent[]` + `dynamicAgents: DynamicAgent[]` y los mezcla para matching.
+
+---
+
+## Orden de ejecución
+
+1. **Eliminar cost.ts** y tool `oficina_cost` (aislado, bajo riesgo)
+2. **Eliminar Budget/Limits** de types.ts y state.ts (core, alto riesgo - tests fallen)
+3. **Eliminar budget checks** de dispatch.ts, office.ts, retry.ts, mesa.ts, docsync.ts, systemPrompt.ts, router.ts, factory.ts, cli.ts
+4. **Tests**: arreglar tests rotos por eliminación de budget
+5. **Factory persistente**: nueva función en factory.ts + modificar instantiateFactory en dispatch.ts
+6. **Catálogo dinámico**: loadDynamicAgents en catalog.ts + integración en buildPanel/resolveRole
+7. **Tests nuevos** para factory persistente + catálogo vivo
+8. **Verificación**: `npm run typecheck && npm test` → todo verde
+
+---
+
+## Criterios de aceptación
+
+- [ ] `npm run typecheck` exit 0
+- [ ] `npm test` 100% passed (tests existentes adaptados + nuevos)
+- [ ] `oficina_cost` ya no existe (tool removida)
+- [ ] No hay referencias a `maxCards`, `maxAgentCalls`, `maxSpawnsTotal`, `Budget` en el código (excepto migración v1→v2)
+- [ ] Dispatch sin match (<30%) crea archivo en `.opencode/agents/<slug>.md` con plantilla completa
+- [ ] El agente creado aparece en futuros `oficina_dispatch` como candidato de matching
+- [ ] El agente creado es invocable directamente como `@oficina-<slug>`
+- [ ] `.opencode/agents/` está en `.gitignore` (ya está) pero los archivos generados son parte del repo para persistencia
+
+---
+
+## Riesgos y mitigaciones
+
+| Riesgo | Mitigación |
+|---|---|
+| Tests rotos masivamente por eliminación de Budget | Ejecutar tests tras cada archivo modificado; fixes incrementales |
+| Catálogo dinámico no detecta cambios en caliente | `loadDynamicAgents` se llama en cada `dispatchOffice` (no cacheado agresivamente) |
+| Parsing de frontmatter frágil | Usar regex simple o librería `gray-matter` si ya está en deps; sino regex robusto |
+| Agentes dinámicos sin `capabilities` en frontmatter | Validar en `createPersistentAgentSkill` que el frontmatter incluya `capabilities` |
+| Migración de state v1→v2 rompe | `migrateState` ya maneja defaults; solo quitar campos de budget |

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "oficina-opencode",
-  "version": "3.0.5",
+  "version": "3.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",
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "main": "./dist/v2.js",
   "types": "./dist/v2.d.ts",
@@ -31,6 +31,7 @@
     "skills",
     "agents",
     "commands",
+    "dashboard",
     "docs",
     "examples",
     "DESIGN.md",
@@ -52,7 +53,7 @@
     "cli",
     "ai"
   ],
-  "author": "Marcos <casselsmarcos1@gmail.com>",
+  "author": "SOCRAMbt <noreply@github.com>",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/SOCRAMbt/AI-OFFICE.git"
@@ -73,6 +74,7 @@
     "test:watch": "vitest",
     "coverage": "npm run build && vitest run --coverage",
     "prepublishOnly": "npm run typecheck && npm run test && npm run build && npm run docs:check",
+    "dashboard": "node dashboard/server.mjs",
     "docs:sync": "tsx scripts/sync-docs.ts",
     "docs:check": "tsx scripts/sync-docs.ts --check",
     "bench:selection": "tsx benchmarks/selection/run.ts",
@@ -80,7 +82,7 @@
   },
   "dependencies": {
     "@opencode/plugin": "^2.1.2",
-    "zod": "4.1.8"
+    "zod": "^4.6.7"
   },
   "peerDependencies": {
     "@opencode-ai/plugin": "^1.15.11"
@@ -91,12 +93,18 @@
     }
   },
   "devDependencies": {
+    "@opencode-ai/plugin": "^1.19.5",
     "@opencode/client": "^2.1.2",
     "@opencode/plugin": "^2.1.2",
     "@types/node": "^24.12.2",
-    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/coverage-v8": "^5.0.5",
+    "playwright": "^1.64.1",
     "tsx": "^4.20.3",
     "typescript": "^5.8.2",
-    "vitest": "^3.2.4"
+    "vitest": "^5.0.5"
+  },
+  "overrides": {
+    "toml": "^5.0.1",
+    "effect": "^4.0.0-rc.118"
   }
 }