@trycore/spec-build-harness 0.4.0 → 0.6.0

package/templates/CLAUDE.md.template

@@ -7,7 +7,7 @@ Este proyecto usa el arnés `@trycore/spec-build-harness` para **construir** sob
 (compañero de `@trycore/spec-product-flow`: Discovery → Construcción). Modelo de **dos loops**:
 
 ```
-Inner loop (por épica EP-XXX):  DoR → OpenSpec change → TDD → journey-smoke → api/data → DoD → PR + archive
+Inner loop (por épica EP-XXX):  DoR → OpenSpec change → TDD → journey-smoke → api/data → verificación adversarial → DoD → PR + archive
 Outer loop (por release):       Release Gate (seguridad · diseño · UX · coherencia triple · arquitectura · integración)
 ```
 
@@ -30,12 +30,16 @@ Outer loop (por release):       Release Gate (seguridad · diseño · UX · cohe
 2. El enlace change↔épica va en el bloque `## Trazabilidad` del `proposal.md`, **nunca** en frontmatter YAML (rompe `openspec validate`).
 3. Las dependencias se vigilan contra `.claude/config/stack-allowlist.json` (hook `stack-guard.sh`), derivado de la sección de requisitos técnicos del PRD.
 4. Las revisiones pesadas (seguridad/diseño/UX/coherencia triple/arquitectura/integración) corren **una vez por release** (outer loop), no por épica.
-5. Si una regla del arnés contradice la metodología Trycore (`METODOLOGIA.md`), **gana la metodología**.
+5. **Producto completo, no MVP.** El alcance acordado se construye **entero**. **Recortar o diferir es bloqueante explícito** que requiere acuerdo del equipo — **nunca** una decisión del modelo. No se "deja para después" ni se deriva en lo complejo. La verificación es **ejecutada, no por inspección** (correr la suite, cargar la página, leer la consola).
+6. **Cierre verificado, no declarado.** `dod` exige el gate `wiring_verified`: un subagente **adversarial independiente** (`wiring-adversarial-verifier`, contexto virgen) intenta refutar el slice (stubs, rutas sin cablear, AC sin test) antes de cerrar. El estado del cableado vive en disco (`wiring_checklist[]` + `progress_log[]`) para que una sesión fresca retome sin "creer que ya está".
+7. **Fidelidad por verificación visual real.** Para slices con UI, el gate `fidelity` solo cierra observando la salida real vía MCP de devtools de navegador (screenshot app vs prototipo); sin verificación visual queda `false` (no "INCONCLUSO pasa").
+8. **Cimiento antes que negocio y unidades pequeñas.** Las épicas de cimiento (auth, datos, arquitectura base, design-system) se construyen antes que las de negocio; una épica grande (>3 HU ó ≥3 capas) se descompone en sub-slices construidos de a uno.
+9. Si una regla del arnés contradice la metodología Trycore (`METODOLOGIA.md`), **gana la metodología**.
 
 ### Bloque de dominio (lo resuelve `/build:onboard`)
 
 Estos puntos de extensión los leen los agentes `security-reviewer`, `stack-guardian`,
-`data-consistency-checker`, `ux-krug-reviewer` y `simple-design-reviewer`:
+`data-consistency-checker`, `ux-krug-reviewer`, `simple-design-reviewer` y `ux-fidelity-reviewer`:
 
 - **PRD técnico (fuente del stack)**: {{PRD_TECH_PATH}}
 - **Capa de servicios externos / IA (frontera)**: {{EXTERNAL_SERVICE_LAYER}}
@@ -43,6 +47,7 @@ Estos puntos de extensión los leen los agentes `security-reviewer`, `stack-guar
 - **Categorías de datos sensibles / PII reguladas**: {{SENSITIVE_DATA_CATEGORIES}}
 - **Secretos server-side**: {{SERVER_SIDE_SECRETS}}
 - **Decisiones de alto impacto que exigen explicabilidad UX**: {{HIGH_STAKES_DECISIONS}}
+- **Fuente de diseño / referencia visual**: {{DESIGN_SOURCE}}
 
 (Si aparecen como `{{...}}`, ejecuta `/build:onboard` para parametrizarlos.)
 

package/templates/integration-check.sh.template

@@ -0,0 +1,65 @@
+#!/usr/bin/env bash
+# integration-check.sh — runner determinista FUERA DE CHAT para cerrar `journey_smoke` (inner loop).
+#
+# Qué es: un gate determinista que ejecuta build + suite completa + un journey-smoke end-to-end y
+# emite un REPORTE de integración a disco, con salida 0 (verde) / ≠0 (rojo). Está pensado para correr
+# en una **sesión/contexto virgen** distinta de la que escribió el código (el agente que cableó no es
+# juez de su propio cableado), y para el **fix-loop** (lo corres, lees el reporte, arreglas, repites).
+#
+# Por qué un script y no un agente: el cableado end-to-end no se acredita "por inspección" sino
+# EJECUTANDO. Mantenerlo fuera del chat lo hace reproducible y barato en contexto.
+#
+# AGNÓSTICO: este es un TEMPLATE. El arnés no asume tu stack. Ajusta los comandos marcados con
+# «# ADAPTA» a tu proyecto (lenguaje, package manager, comando de e2e). Cópialo a tu repo
+# (p.ej. tools/loop/integration-check.sh) y hazlo ejecutable.
+#
+# NO crea ningún gate nuevo en build-state.json: alimenta el gate EXISTENTE `journey_smoke` del slice.
+# El gate `integration` con dependencias reales sigue siendo del Release Gate (outer loop), no de aquí.
+set -uo pipefail
+
+ROOT="$(git rev-parse --show-toplevel 2>/dev/null || echo "${CLAUDE_PROJECT_DIR:-$(pwd)}")"
+REPORT_DIR="$ROOT/.claude/state"
+REPORT="$REPORT_DIR/integration-report.txt"
+mkdir -p "$REPORT_DIR"
+
+# Detecta el package manager si hay package.json (Node). ADAPTA para otros stacks.
+PM="npm"
+if [ -f "$ROOT/pnpm-lock.yaml" ]; then PM="pnpm";
+elif [ -f "$ROOT/yarn.lock" ]; then PM="yarn"; fi
+
+fail=0
+log() { printf '%s\n' "$*" | tee -a "$REPORT"; }
+
+: > "$REPORT"
+log "== integration-check =="
+log "root: $ROOT"
+log "pm:   $PM"
+log "ts:   (sin timestamp determinista; lo estampa quien invoca)"
+log ""
+
+run() { # run <etiqueta> <comando...>
+  local label="$1"; shift
+  log "▶ $label: $*"
+  if "$@" >>"$REPORT" 2>&1; then
+    log "  ✓ $label OK"
+  else
+    log "  ✗ $label FALLÓ"
+    fail=1
+  fi
+  log ""
+}
+
+# --- Fases del runner (ADAPTA los comandos a tu stack) ---
+# 1) Build: el proyecto compila/construye sin error.
+run "build"  $PM run build          # ADAPTA (p.ej. cargo build, ./gradlew build, make)
+# 2) Suite completa: todos los tests, no un subconjunto.
+run "tests"  $PM test               # ADAPTA (p.ej. pytest, go test ./..., cargo test)
+# 3) Journey-smoke end-to-end: recorre el backbone-hasta-aquí. ADAPTA al e2e de tu proyecto.
+#    Si tu e2e necesita la app levantada, levántala aquí (y bájala al salir).
+# run "e2e"  $PM run test:e2e        # ADAPTA / descomenta
+
+log "== resultado: $([ "$fail" -eq 0 ] && echo VERDE || echo ROJO) =="
+log "Reporte: $REPORT"
+
+# Salida determinista: 0 verde, 1 rojo. El gate journey_smoke solo se marca true con salida 0.
+exit "$fail"

package/templates/settings-hooks.template.json

@@ -13,7 +13,7 @@
     ],
     "PreToolUse": [
       { "matcher": "Bash", "hooks": [ { "type": "command", "command": "\"${CLAUDE_PLUGIN_ROOT:-$CLAUDE_PROJECT_DIR/.claude}/hooks/build/gitflow-guard.sh\"" } ] },
-      { "matcher": "Write|Edit|MultiEdit", "hooks": [ { "type": "command", "command": "\"${CLAUDE_PLUGIN_ROOT:-$CLAUDE_PROJECT_DIR/.claude}/hooks/build/stack-guard.sh\"" }, { "type": "command", "command": "\"${CLAUDE_PLUGIN_ROOT:-$CLAUDE_PROJECT_DIR/.claude}/hooks/build/scaffold-guard.sh\"" } ] }
+      { "matcher": "Write|Edit|MultiEdit", "hooks": [ { "type": "command", "command": "\"${CLAUDE_PLUGIN_ROOT:-$CLAUDE_PROJECT_DIR/.claude}/hooks/build/stack-guard.sh\"" }, { "type": "command", "command": "\"${CLAUDE_PLUGIN_ROOT:-$CLAUDE_PROJECT_DIR/.claude}/hooks/build/scaffold-guard.sh\"" }, { "type": "command", "command": "\"${CLAUDE_PLUGIN_ROOT:-$CLAUDE_PROJECT_DIR/.claude}/hooks/build/design-source-guard.sh\"" } ] }
     ],
     "PostToolUse": [
       { "matcher": "Write|Edit|MultiEdit", "hooks": [ { "type": "command", "command": "\"${CLAUDE_PLUGIN_ROOT:-$CLAUDE_PROJECT_DIR/.claude}/hooks/build/lint-typecheck.sh\"" }, { "type": "command", "command": "\"${CLAUDE_PLUGIN_ROOT:-$CLAUDE_PROJECT_DIR/.claude}/hooks/build/coherence-flag.sh\"" } ] }