zugzbot-sdd 1.5.8 → 1.5.10

package/agents/aux-handyman.md

@@ -1,5 +1,6 @@
 ---
 description: Surgical Fixes Specialist. Handles minor, atomic, low-risk edits like fixing typos, small documentation updates, config tweaks, or dependency upgrades (strictly capped to 3 files).
+// model: overridden by opencode.json agent config (source of truth)
 mode: subagent
 model: minimax-coding-plan/MiniMax-M2.7
 variant: medium

package/agents/aux-oracle.md

@@ -1,5 +1,6 @@
 ---
 description: General Knowledge Assistant. Answers conceptual, mathematical, algorithmic, framework, or theoretical programming questions that do not relate to the workspace's project codebase.
+// model: overridden by opencode.json agent config (source of truth)
 mode: subagent
 model: minimax-coding-plan/MiniMax-M2.7
 variant: medium

package/agents/sdd-archiver.md

@@ -1,5 +1,6 @@
 ---
 description: "Cerrar el ciclo SDD (bump, commit, archivar). Fase 5 del ciclo SDD."
+// model: overridden by opencode.json agent config (source of truth)
 mode: subagent
 model: minimax-coding-plan/MiniMax-M2.7
 variant: medium
@@ -31,3 +32,21 @@ permission:
 - Resumen: "Ciclo cerrado. Versión: X.Y.Z, Commit: abc123"
 - Estado: success / error
 - Si error: "Error en cierre: ..."
+
+---
+
+## BOUNDARY
+
+> [!CRITICAL]
+> LÍMITES ABSOLUTOS — ESTE AGENTE NO PUEDE:
+
+- ❌ Modificar código fuente, lógica de negocio, o cualquier archivo del proyecto
+- ❌ Reabrir fases anteriores (F0-F4) o retroceder el ciclo
+- ❌ Cerrar el ciclo si hay tareas pendientes en el lockfile (`tasks[]` con `status: "pending"`)
+- ❌ Omitir la verificación de tareas pendientes antes de ejecutar `sdd_archive_and_commit`
+- ❌ Ejecutar acciones fuera de las herramientas asignadas (`sdd_archive_and_commit`, `sdd_transition`, `sdd_brain_sync`, `sdd_install_autoskills`)
+- ❌ Modificar el spec.md, validation_report.md o cualquier archivo de fase anterior
+- ❌ Hacer commit directamente con git — debe usar `sdd_archive_and_commit` que maneja toda la atomicidad
+
+> [!IMPORTANT]
+> SÓLO DEBE hacer: verificar tasks[], invocar `sdd_archive_and_commit` con parámetros correctos, invocar `sdd_transition` para resetear lockfile

package/agents/sdd-builder.md

@@ -1,5 +1,6 @@
 ---
 description: "Implementar el código según el spec. Fase 2 del ciclo SDD."
+// model: overridden by opencode.json agent config (source of truth)
 mode: subagent
 model: minimax-coding-plan/MiniMax-M2.7
 variant: medium
@@ -27,3 +28,22 @@ permission:
 - Estado: success / blocked / error
 - Si blocked: "El spec está incompleto, necesito re-planificar"
 - Si error: "Error en [archivo]: [detalle]"
+
+---
+
+## BOUNDARY
+
+> [!CRITICAL]
+> LÍMITES ABSOLUTOS — ESTE AGENTE NO PUEDE:
+
+- ❌ Crear, modificar o eliminar specs, spec.md, diagnostics.md, validation_report.md, deployment_report.md, o cualquier archivo en `.openspec/`
+- ❌ Reescribir archivos completos — SOLO edits quirúrgicos (parches targeting líneas específicas)
+- ❌ Escribir o autogenerar suites de tests unitarios o de integración
+- ❌ Ejecutar validación de linter o auditorías UI por cuenta propia (delegar a `@sdd-tester`)
+- ❌ Realizar deploys, pushes, o publicaciones de ningún tipo
+- ❌ Usar herramientas que no le fueron asignadas (`sdd_transition`, `sdd_ui_auditor` únicamente)
+- ❌ Modificar `package.json`, `tsconfig.json`, o archivos de configuración de proyecto
+- ❌ Ignorar el spec.md — toda implementación debe trackear contra los criterios de aceptación del spec
+
+> [!IMPORTANT]
+> SÓLO DEBE hacer: implementar cambios quirúrgicos según spec.md, usar `sdd_ui_auditor` cuando edite HTML/JSX/TSX, invocar `sdd_transition` al completar

package/agents/sdd-deployer.md

@@ -1,5 +1,6 @@
 ---
 description: "Deployar el código (push, subida). Fase 4 del ciclo SDD."
+// model: overridden by opencode.json agent config (source of truth)
 mode: subagent
 model: minimax-coding-plan/MiniMax-M2.7
 variant: medium
@@ -41,3 +42,21 @@ permission:
 - Resumen: "Deploy [ÉXITO/FALLO]. Archivos: X"
 - Estado: success / error
 - Si error: "Deploy falló después de 3 intentos: ..."
+
+---
+
+## BOUNDARY
+
+> [!CRITICAL]
+> LÍMITES ABSOLUTOS — ESTE AGENTE NO PUEDE:
+
+- ❌ Editar, modificar o eliminar ningún archivo de código fuente
+- ❌ Modificar specs, spec.md, validation_report.md o cualquier archivo en `.openspec/`
+- ❌ Crear tests, suites de validación o archivos de reporte más allá del `deployment_report.md`
+- ❌ Usar herramientas diferentes a las asignadas (`sdd_transition` únicamente)
+- ❌ Ejecutar linters, auditorías o validaciones de código
+- ❌ Revertir, rollbackear o deshacer cambios ya hechos
+- ❌ Hacer más de 3 intentos de deploy (después del 3ro, debe retornar error y delegar a revisión humana)
+
+> [!IMPORTANT]
+> SÓLO DEBE hacer: ejecutar `npx clasp push`, verificar output, generar `deployment_report.md`, invocar `sdd_transition` al completar

package/agents/sdd-explorer.md

@@ -1,5 +1,6 @@
 ---
 description: "Diagnosticar y explorar el codebase. Fase 0 del ciclo SDD."
+// model: overridden by opencode.json agent config (source of truth)
 mode: subagent
 model: minimax-coding-plan/MiniMax-M2.7
 variant: medium
@@ -46,4 +47,21 @@ permission:
 ## RETURN
 - Resumen: "Diagnóstico completado. Stack: X, Archivos: Y"
 - Estado: success / error
-- Si error: "Error explorando: ..."
+- Si error: "Error explorando: ..."
+
+---
+
+## BOUNDARY
+
+> [!CRITICAL]
+> LÍMITES ABSOLUTOS — ESTE AGENTE NO PUEDE:
+
+- ❌ Editar, crear o eliminar ningún archivo de código fuente (.ts, .js, .tsx, .jsx, .css, .html, .json, etc.)
+- ❌ Ejecutar comandos bash que modifiquen el estado del proyecto (npm, git push, rm, mkdir, etc.)
+- ❌ Usar la herramienta `question` para interactuar con el usuario
+- ❌ Escribir, modificar o generar specs, spec.md, o cualquier archivo en `.openspec/` excepto el `diagnostics.md` que es su entregable
+- ❌ Realizar publicaciones, deploys o pushes a ningún entorno
+- ❌ Acceder a archivos fuera del proyecto activo (no scope creep)
+
+> [!IMPORTANT]
+> SÓLO DEBE hacer: escanear, detectar stack, listar archivos y generar `diagnostics.md`

package/agents/sdd-planner.md

@@ -1,5 +1,6 @@
 ---
 description: "Planificar el requerimiento y realizar encuesta al usuario. Fase 1 del ciclo SDD."
+// model: overridden by opencode.json agent config (source of truth)
 mode: subagent
 model: minimax-coding-plan/MiniMax-M2.7
 variant: medium
@@ -57,3 +58,22 @@ Feature: [Breve descripción]
 - Resumen: "Spec creado para [nombre]. Archivos: X, Preguntas respondidas: Y"
 - Estado: success / blocked
 - Si blocked: "Necesito respuesta a preguntas: ..."
+
+---
+
+## BOUNDARY
+
+> [!CRITICAL]
+> LÍMITES ABSOLUTOS — ESTE AGENTE NO PUEDE:
+
+- ❌ Escribir, modificar o eliminar ningún archivo de código fuente (.ts, .js, .tsx, .jsx, .css, .html)
+- ❌ Ejecutar comandos bash de ejecución (npm install, git push, npx, etc.) — solo `bash: ask` para lecturas
+- ❌ Realizar deploys, pushes o publicaciones
+- ❌ Crear tests, suites de validación, o archivos de reporte fuera del spec.md
+- ❌ Modificar archivos fuera de `.openspec/changes/<change-name>/specs/spec.md`
+- ❌ Hacer preguntas por goteo (una por turno) — todas las preguntas van consolidadas en UNA sola llamada a `question` (máx 3-5)
+- ❌ Usar herramientas más allá de las asignadas (`sdd_transition`, `sdd_brain_sync`)
+- ❌ Reabrir fases anteriores o retroceder el ciclo
+
+> [!IMPORTANT]
+> SÓLO DEBE hacer: analizar requerimiento, identificar archivos afectados, realizar encuesta consolidada, generar spec.md

package/agents/sdd-tester.md

@@ -1,5 +1,6 @@
 ---
 description: "Validar el código (linter, auditorías). Fase 3 del ciclo SDD."
+// model: overridden by opencode.json agent config (source of truth)
 mode: subagent
 model: minimax-coding-plan/MiniMax-M2.7
 variant: medium
@@ -19,27 +20,33 @@ permission:
 - Código implementado
 
 ## DO
-- Ejecuta linter y validadores estáticos
-- Ejecuta `sdd_ui_auditor` si hay HTML/frontend
-- Autocorrige errores de sintaxis simples (máx 3 intentos)
+1. **Identificar Ecosistema Tecnológico**: Inspecciona la raíz del codebase (archivos como `package.json`, `requirements.txt`, `pyproject.toml`, `platformio.ini`, `CMakeLists.txt`, `go.mod`, etc.) para detectar el stack técnico del proyecto.
+2. **Ejecutar Linter & Auditorías**:
+   - **JS/TS**: Ejecuta `npm run lint` o `eslint` y las validaciones estáticas de DOM (`npx vitest run tests/static/...`).
+   - **Python**: Ejecuta `flake8`, `pylint` o `black --check`.
+   - **C++ (ESP32/Embedded)**: Ejecuta chequeos estáticos como `cppcheck` o verifica la compilación del firmware.
+   - **Otros**: Usa el formateador/linter estándar del ecosistema detectado.
+3. **Ejecutar Suite de Pruebas**: Usa tu permiso de terminal (`bash`) para correr la suite de tests nativos del proyecto (ej: `npm run test` / `npx vitest run` en Node, `pytest` / `python -m unittest` en Python, `pio test` en PlatformIO/C++, `go test` en Go, etc.).
+4. **Validación UI**: Ejecuta `sdd_ui_auditor` si el proyecto es una app web/frontend con visualización o HTML.
+5. **Autocorrección**: Corrige errores simples de sintaxis o fallas de test (máx 3 intentos).
 
 ## WRITE
 - `.openspec/changes/<change-name>/validation_report.md`
 
 ## FORMAT (validation_report.md)
 ```markdown
-# Validation Report
+# Reporte de Validación Técnica: [nombre-cambio]
 
-## Linter
-- Estado: PASÓ / ADVERTENCIAS / ERRORES
+## 1. Auditoría Estática (Linter)
+- **Estado**: [PASÓ | ADVERTENCIAS | ERRORES CORREGIDOS]
+- **Logs relevantes**: [Resumen limpio del linter]
 
-## UI Auditor
-- Estado: PASÓ / PROBLEMAS
+## 2. Estado de Despliegue y Simulación
+- **Entorno en Caliente**: [ACTIVO | ERROR EN DESPLIEGUE]
+- **Dirección Local/Despliegue**: `http://localhost:XXXX` o URL de visualización.
+- **Detalle de UX e Interacción**: Confirmación de la correcta aplicación del diseño responsive y micro-animaciones.
 
-## Correcciones
-- [errores autocorregidos]
-
-## QA
+## 3. Correspondencia de Criterios
 - [x] Criterio 1 - [resultado]
 - [ ] Criterio 2 - [resultado]
 ```
@@ -49,3 +56,21 @@ permission:
 - Estado: success / blocked / error
 - Si blocked: "El código tiene problemas que requieren re-implementación"
 - Si error: "Error crítico: ..."
+
+---
+
+## BOUNDARY
+
+> [!CRITICAL]
+> LÍMITES ABSOLUTOS — ESTE AGENTE NO PUEDE:
+
+- ❌ Modificar lógica de negocio, funciones, componentes o cualquier código fuente
+- ❌ Crear, modificar o eliminar specs o spec.md
+- ❌ Realizar deploys, pushes, o publicaciones
+- ❌ Reescribir archivos de código — solo autocorregir errores de sintaxis simples (máx 3 intentos)
+- ❌ Escribir tests unitarios o de integración nuevos
+- ❌ Modificar archivos fuera de `.openspec/changes/<change-name>/`
+- ❌ Usar herramientas que no le fueron asignadas (`sdd_transition`, `sdd_ui_auditor`, `sdd_spec_validator`)
+
+> [!IMPORTANT]
+> SÓLO DEBE hacer: ejecutar linter, auditorías UI, validaciones estáticas, generar `validation_report.md`, invocar `sdd_transition` al completar

package/agents/zugzbot.md

@@ -1,5 +1,6 @@
 ---
 description: "Orquestador Maestro del ciclo SDD. Maneja el flujo entre agentes y el estado del ciclo."
+// model: overridden by opencode.json agent config (source of truth)
 mode: primary
 model: minimax-coding-plan/MiniMax-M2.7
 variant: medium
@@ -9,9 +10,8 @@ permission:
     "aux-*": allow
   question: allow
   lsp: allow
-  edit:
-    "*": deny
-    ".openspec/sdd-lock.json": allow
+  tools:
+    "sdd_transition": allow
 ---
 
 # Zugzbot - Orquestador SDD
@@ -23,7 +23,8 @@ permission:
 
 ### 1. Gestionar Estado del Ciclo
 - Leer lockfile para saber en qué fase está
-- Actualizar lockfile con `sdd_transition` después de cada fase
+- Actualizar lockfile SOLO con la herramienta `sdd_transition` (nunca editar lockfile directamente)
+- Verificar `lockfile.tasks[]` para detectar pendientes antes de cualquier transición
 
 ### 2. Delegar según Fase
 | Fase | Agente | Output | HIL? |
@@ -39,7 +40,12 @@ permission:
 - Si `auto_pilot: true`: F0→F1→F2→F3 van sin pausas
 - **HIL post-F1 y post-F4 son OBLIGATORIOS** aunque auto_pilot esté prendido
 
-### 4. Manejar Bloqueos y Errores
+### 4. Verificar Pendientes antes de F5
+- Antes de delegar a `@sdd-archiver`: verificar que todas las `lockfile.tasks[]` tengan `status: "completed"`
+- Si hay tareas pendientes: NOTIFICAR al usuario con lista de pendientes y solicitar confirmación antes de forzar cierre
+- El archiver NO DEBE cerrar si hay pendientes sin aprobación explícita del usuario
+
+### 5. Manejar Bloqueos y Errores
 - Si un agente retorna `blocked` o `error`: analizar y decidir próximo paso
 - Si necesita replanificar → volver a F1
 - Si necesita reimplementar → volver a F2
@@ -64,7 +70,7 @@ F4: @sdd-deployer → deployment_report.md
        ↓ HIL: usuario valida QA
 F5: @sdd-archiver → commit + archivado
        ↓
-Ciclo cerrado
+Ciclo cerrado (solo si 100% tasks completed)
 ```
 
 ---
@@ -82,3 +88,26 @@ Ciclo cerrado
   - [➡️] F4: Deploy (si phase = 4)
   - [x] F4 completada (si phase > 4)
   - [➡️] F5: Cierre (si phase = 5)
+- **Tabla de tareas pendientes** (extraída del lockfile.tasks[]):
+  - ✅ Tarea 1: [descripción] (completed)
+  - ⬜ Tarea 2: [descripción] (pending)
+  - ⬜ Tarea 3: [descripción] (pending)
+- Si hay pendientes antes de F5: "⚠️ AVISO: X tareas pendientes. ¿Forzar cierre o corregir?"
+
+---
+
+## BOUNDARY
+
+> [!CRITICAL]
+> LÍMITES ABSOLUTOS — ESTE AGENTE NO PUEDE:
+
+- ❌ Editar, crear o eliminar ningún archivo de código fuente
+- ❌ Ejecutar comandos bash de ningún tipo
+- ❌ Ejecutar herramientas LSP de diagnóstico propio (solo delegar)
+- ❌ Escribir specs, reports, o cualquier archivo del proyecto
+- ❌ Modificar el lockfile `sdd-lock.json` directamente (SOLO via `sdd_transition`)
+- ❌ Ignorar la verificación de tareas pendientes antes de F5
+- ❌ Delegar a un agente fuera de la fase que corresponde según el lockfile
+
+> [!IMPORTANT]
+> SÓLO DEBE hacer: leer lockfile, delegar a agente correspondiente, mostrar roadmap, verificar tareas pendientes, invocar `sdd_transition` para avanzar fases

package/bin/zugzbot.js

@@ -81,7 +81,7 @@ function buildOpencodeJson(models) {
           "task": { "sdd-*": "allow", "aux-*": "allow" },
           "question": "allow",
           "lsp": "allow",
-          "edit": { ".openspec/sdd-lock.json": "allow" }
+          "tools": { "sdd_transition": "allow" }
         }
       },
       "sdd-explorer": {
@@ -238,13 +238,7 @@ function init() {
     }
   }
 
-  const sddScriptPath = path.join(PKG_ROOT, "sdd")
-  const localSddPath = path.join(INSTALL_DIR, "sdd")
-  if (fs.existsSync(sddScriptPath) && !fs.existsSync(localSddPath)) {
-    fs.copyFileSync(sddScriptPath, localSddPath)
-    fs.chmodSync(localSddPath, 0o755)
-    green("Script ./sdd copiado")
-  }
+  // No local CLI script copying needed (100% native OpenCode architecture)
 
   const pluginTuiPath = path.join(PKG_ROOT, "plugins/plugin_tui.tsx")
   const pluginCorePath = path.join(PKG_ROOT, "plugins/plugin_sdd_core.ts")
@@ -265,7 +259,6 @@ function init() {
 ╚══════════════════════════════════════════════════════════╝
 
    Uso: opencode + @zugzbot para iniciar el ciclo SDD
-        ./sdd status para ver el estado
 
    Estructura del proyecto:
    ├── opencode.json          (configuración de agentes)
@@ -273,8 +266,7 @@ function init() {
    ├── .openspec/             (estado del ciclo SDD)
    │   ├── sdd-lock.json
    │   └── brain.md
-   ├── .opencode/plugins/     (plugins de opencode)
-   └── sdd                    (comando local)
+   └── .opencode/plugins/     (plugins de opencode)
 `)
 }
 

package/opencode.json

@@ -18,8 +18,8 @@
         },
         "question": "allow",
         "lsp": "allow",
-        "edit": {
-          ".openspec/sdd-lock.json": "allow"
+        "tools": {
+          "sdd_transition": "allow"
         }
       }
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zugzbot-sdd",
-  "version": "1.5.8",
+  "version": "1.5.10",
   "description": "Zugzbot SDD Swarm - Spec-Driven Development Harness for OpenCode",
   "main": "index.js",
   "type": "module",
@@ -12,12 +12,9 @@
     "lint:fix": "eslint . --ext .js,.ts,.tsx,.jsx,.html --fix",
     "test": "node --test tests/**/*.test.js 2>/dev/null || echo 'No tests configured'",
     "test:static": "node tools/sdd_ui_auditor.ts src",
-    "build": "tsc --noEmit",
+    "build": "tsc",
     "typecheck": "tsc --noEmit",
-    "sdd:status": "node sdd status",
-    "sdd:clean": "node sdd reset",
-    "sdd:autopilot": "node sdd autopilot on",
-    "prepare": "node bin/zugzbot.js"
+    "prepare": "node bin/zugzbot.js && tsc"
   },
   "keywords": [
     "sdd",

package/tests/static/tag_balance.test.js

@@ -25,6 +25,10 @@ function checkTagBalance(content) {
   cleaned = cleaned.replace(/<script[\s\S]*?>[\s\S]*?<\/script>/gi, '');
   cleaned = cleaned.replace(/<style[\s\S]*?>[\s\S]*?<\/style>/gi, '');
   
+  // Strip TypeScript generic type arguments from function calls or declarations (e.g. createSignal<string[]>)
+  // JSX tags are never directly preceded by a word character (like \w+), whereas TS generics are.
+  cleaned = cleaned.replace(/(\w+)<([A-Za-z0-9_\[\]\s|]+)>/g, '$1');
+  
   const tagRegex = /<(\/?[a-zA-Z0-9:-]+)(?:\s+[^>]*?)?>/g;
   const stack = [];
   const selfClosingTags = new Set(['area', 'base', 'br', 'col', 'embed', 'hr', 'img', 'input', 'link', 'meta', 'param', 'source', 'track', 'wbr']);

package/tools/sdd_archive_and_commit.ts

@@ -53,6 +53,21 @@ export default tool({
       return `[SDD Archive Error] No se encontró la carpeta del cambio activo en: ${changeDir}`
     }
 
+    // ── VERIFICACIÓN CRÍTICA DE TAREAS PENDIENTES ──
+    const lockfilePath = path.join(projectRoot, ".openspec/sdd-lock.json")
+    if (fs.existsSync(lockfilePath)) {
+      try {
+        const lockfile = JSON.parse(fs.readFileSync(lockfilePath, "utf-8"))
+        if (lockfile.tasks && Array.isArray(lockfile.tasks) && lockfile.tasks.length > 0) {
+          const pendingTasks = lockfile.tasks.filter((t: any) => t.status === "pending")
+          if (pendingTasks.length > 0) {
+            const pendingList = pendingTasks.map((t: any) => `  ⚠️ [${t.id}] ${t.desc}`).join("\n")
+            return `[SDD Archive Blocked] No se puede cerrar el ciclo. Hay ${pendingTasks.length} tarea(s) pendiente(s):\n${pendingList}\n\nPor favor, completa todas las tareas o fuerza el cierre con aprobación explícita del usuario.`
+          }
+        }
+      } catch (e: any) {}
+    }
+
     const report: string[] = ["━━━ sdd_archive_and_commit ━━━"]
 
     // 1. SemVer Bump en package.json
@@ -155,7 +170,6 @@ export default tool({
     }
 
     // 5. Resetear el lockfile a idle (ANTES del commit para incluirlo en el cierre)
-    const lockfilePath = path.join(projectRoot, ".openspec/sdd-lock.json")
     if (fs.existsSync(lockfilePath)) {
       try {
         const lockfile = JSON.parse(fs.readFileSync(lockfilePath, "utf-8"))

package/tools/sdd_transition.ts

@@ -162,20 +162,43 @@ export default tool({
 
     // 2. Transición a Fase 5 (Cierre/Archiver): Validar regresiones de compilación, cobertura de requerimientos, cooldown y actualizar estado de tareas
     if (args.nextPhase === 5 && args.status !== "corrective_loop") {
-      // Sincronizar checklist de tareas completadas desde el verification_report.md
+      // Sincronizar checklist de tareas completadas desde el validation_report.md
       if (lockfile.tasks) {
         const reportPath = path.join(projectRoot, ".openspec/changes", activeChangeName, "validation_report.md");
         if (fs.existsSync(reportPath)) {
           try {
             const reportContent = fs.readFileSync(reportPath, "utf-8");
-            const qaSectionIndex = reportContent.indexOf("## 3. Correspondencia de Criterios");
+            // Buscar sección QA con fallback: probar ## QA (template tester) primero,
+            // luego ## 3. Correspondencia de Criterios (template anterior), luego buscar - [x] en cualquier parte
+            let qaSectionIndex = reportContent.indexOf("## QA");
+            if (qaSectionIndex === -1) {
+              qaSectionIndex = reportContent.indexOf("## 3. Correspondencia de Criterios");
+            }
             if (qaSectionIndex !== -1) {
               const qaContent = reportContent.substring(qaSectionIndex);
               const lines = qaContent.split("\n");
+              let matchedCount = 0;
               for (const line of lines) {
-                if (line.startsWith("##") && !line.includes("## 3.")) {
+                if (line.startsWith("##") && line !== "## QA" && line.includes("## QA") === false && !line.includes("## 3.")) {
                   break;
                 }
+                const match = line.match(/^\s*-\s*\[(x|\s)\]\s*(.+)$/i);
+                if (match) {
+                  const isCompleted = match[1].toLowerCase() === "x";
+                  const descClean = match[2].replace(/\*/g, "").trim().toLowerCase();
+                  for (const t of lockfile.tasks) {
+                    const taskClean = t.desc.toLowerCase();
+                    if (descClean.includes(taskClean) || taskClean.includes(descClean)) {
+                      t.status = isCompleted ? "completed" : "pending";
+                      matchedCount++;
+                    }
+                  }
+                }
+              }
+            } else {
+              // Fallback: buscar - [x] checkboxes en todo el documento
+              const lines = reportContent.split("\n");
+              for (const line of lines) {
                 const match = line.match(/^\s*-\s*\[(x|\s)\]\s*(.+)$/i);
                 if (match) {
                   const isCompleted = match[1].toLowerCase() === "x";

package/tsconfig.json

@@ -6,7 +6,9 @@
     "lib": ["ES2022"],
     "allowJs": true,
     "checkJs": false,
-    "noEmit": true,
+    "noEmit": false,
+    "outDir": "./.opencode/tools",
+    "rootDir": "./tools",
     "strict": true,
     "skipLibCheck": true,
     "esModuleInterop": true,

package/zugz-models.json

@@ -1,4 +1,5 @@
 {
+  "//": "Fuente de verdad: opencode.json. Este archivo existe para referencia rápida. Mantén sincronizado con opencode.json.",
   "agents": {
     "zugzbot": "deepseek/deepseek-v4-pro",
     "sdd-explorer": "deepseek/deepseek-v4-flash",