pumuki 6.3.44 → 6.3.46

package/docs/RELEASE_NOTES.md

@@ -5,6 +5,37 @@ Detailed commit history remains available through Git history (`git log` / `git
 
 ## 2026-03 (enterprise hardening updates)
 
+### 2026-03-05 (v6.3.46)
+
+- Paridad hook/watch en auto-remediación de skills coverage:
+  - `pre-commit` y `pre-push` ahora ejecutan `policy reconcile --strict --apply` y reintentan una única vez cuando el bloqueo es de coverage de skills.
+  - elimina recurrencia de bootstrap/reconcile manual entre iteraciones de consumer.
+- Contrato `watch --json` enriquecido para drift de versión:
+  - nuevo bloque `version` con `effective/runtime/consumerInstalled/source`,
+  - incluye `driftFromRuntime` y `driftWarning` cuando el binario del consumer no está alineado con runtime/latest.
+- Evidencia de validación:
+  - `npx --yes tsx@4.21.0 --test integrations/git/__tests__/stageRunners.test.ts` (`30 pass / 0 fail`)
+  - `npx --yes tsx@4.21.0 --test integrations/lifecycle/__tests__/watch.test.ts integrations/lifecycle/__tests__/cli.test.ts` (`48 pass / 0 fail`)
+  - `npm run -s typecheck` (`PASS`)
+
+### 2026-03-05 (v6.3.45)
+
+- SDD sync canónico ampliado por defecto en consumer:
+  - `pumuki sdd sync-docs` ahora sincroniza, cuando existen, los 3 documentos base:
+    - `docs/strategy/ruralgo-tracking-hub.md`
+    - `docs/technical/08-validation/refactor/operational-summary.md`
+    - `docs/validation/refactor/last-run.json`
+- Auto-sync OpenSpec integral por cambio:
+  - `pumuki sdd auto-sync` incluye por defecto:
+    - `openspec/changes/<change>/tasks.md`
+    - `openspec/changes/<change>/design.md`
+    - `openspec/changes/<change>/retrospective.md`
+- Consumo automático universal de aprendizaje:
+  - `ai_gate_check`, `pre_flight_check` y `auto_execute_ai_start` exponen `learning_context` cuando existe `openspec/changes/<change>/learning.json`.
+- Evidencia de validación:
+  - `npx --yes tsx@4.21.0 --test integrations/mcp/__tests__/aiGateCheck.test.ts integrations/mcp/__tests__/preFlightCheck.test.ts integrations/mcp/__tests__/autoExecuteAiStart.test.ts integrations/sdd/__tests__/syncDocs.test.ts integrations/lifecycle/__tests__/cli.test.ts` (`78 pass / 0 fail`)
+  - `npm run -s typecheck` (`PASS`)
+
 ### 2026-03-05 (v6.3.43)
 
 - `pumuki sdd evidence` alinea su salida con el contrato TDD/BDD del gate:

package/docs/USAGE.md

@@ -334,6 +334,8 @@ Watch runtime behavior:
 Backlog tooling behavior (`watch` + `reconcile` scripts):
 - mapping precedence is deterministic: inline `#issue` -> `--id-issue-map-from` -> `--id-issue-map` -> `--resolve-missing-via-gh`.
 - `watch-consumer-backlog` is non-destructive and reports action-required drift.
+- `watch-consumer-backlog-fleet` agrega varios backlogs en una sola ejecución y devuelve resumen consolidado por target.
+- `watch-consumer-backlog-fleet-tick` ejecuta un ciclo canónico SAAS+RuralGo+Flux con overrides opcionales (`--saas/--ruralgo/--flux`).
 - `watch-consumer-backlog` reports heading drift (`heading_drift`) when section headers `### ✅/🚧/⏳/⛔ <ID>` diverge from effective table status.
 - `watch-consumer-backlog --json` exposes `heading_drift_count` for low-friction alerting parsers.
 - `watch-consumer-backlog --json` exposes `classification_counts` (`needs_issue`, `drift_closed_issue`, `active_issue`, `heading_drift`).
@@ -405,6 +407,9 @@ Backlog tooling quick reference:
 |---|---|
 | `npm run -s test:backlog-tooling` | Ejecutar suite focal de regresión del tooling de backlog. |
 | `scripts/watch-consumer-backlog.ts --json` | Detectar drift accionable sin mutar archivos. |
+| `scripts/watch-consumer-backlog-fleet.ts --json` | Vigilar varios backlogs consumidores y consolidar estado global en una sola salida. |
+| `npm run -s validation:backlog-watch:tick` | Ejecutar tick canónico único (SAAS+RuralGo+Flux) para decisión rápida `fix now` vs `no-action`. |
+| `npm run -s validation:backlog-watch:gate` | Gate previo a release: falla con exit code `1` si hay señal neta accionable en cualquier consumer. |
 | `scripts/reconcile-consumer-backlog-issues.ts --json` | Simular reconciliación (dry-run) y revisar cambios planeados. |
 | `scripts/reconcile-consumer-backlog-issues.ts --apply` | Aplicar reconciliación sobre el backlog consumidor. |
 
@@ -429,6 +434,20 @@ npx --yes tsx@4.21.0 scripts/watch-consumer-backlog.ts \
   --resolve-missing-via-gh \
   --json
 
+# watch fleet: varios consumers en una sola pasada (sin mutar, sin fallar pipeline)
+npx --yes tsx@4.21.0 scripts/watch-consumer-backlog-fleet.ts \
+  --target=/abs/path/consumer1/PUMUKI_BUGS_MEJORAS.md::SwiftEnProfundidad/ast-intelligence-hooks \
+  --target=/abs/path/consumer2/pumuki-integration-feedback.md::SwiftEnProfundidad/ast-intelligence-hooks \
+  --target=/abs/path/consumer3/BUGS_Y_MEJORAS_PUMUKI.md \
+  --json \
+  --no-fail
+
+# watch tick canónico (usa rutas por defecto y devuelve JSON consolidado)
+npm run -s validation:backlog-watch:tick
+
+# gate de release (misma señal, pero bloquea con exit code 1 si hay acción requerida)
+npm run -s validation:backlog-watch:gate
+
 # reconcile dry-run: same source chain
 npx --yes tsx@4.21.0 scripts/reconcile-consumer-backlog-issues.ts \
   --file=/abs/path/consumer/PUMUKI_BUGS_MEJORAS.md \

package/docs/seguimiento-activo-pumuki-saas-supermercados.md

@@ -2099,12 +2099,294 @@
     - `npx --yes tsx@4.21.0 --test integrations/lifecycle/__tests__/watch.test.ts integrations/lifecycle/__tests__/cli.test.ts integrations/lifecycle/__tests__/policyReconcile.test.ts` -> `53 pass / 0 fail`.
     - `npm run -s typecheck` -> `PASS`.
 
-- 🚧 PUMUKI-162: Ejecutar siguiente pendiente activo de Flux (`PUM-011`) para cerrar paridad consumer de `watch --once --json` con `lastTick.changedFiles[]` y `lastTick.evaluatedFiles[]`.
+- ✅ PUMUKI-162: Ejecutar siguiente pendiente activo de Flux (`PUM-011`) para cerrar paridad consumer de `watch --once --json` con `lastTick.changedFiles[]` y `lastTick.evaluatedFiles[]`.
   - Alcance:
     - verificar contrato JSON final en paquete publicado vs consumer runtime,
     - eliminar drift de payload entre core y distribución npm,
     - cerrar con validación reproducible en consumer (sin tocar código funcional del consumer).
-  - Avance actual (2026-03-05):
-    - verificado en core local (`bin/pumuki.js`): `lastTick.changedFiles[]` y `lastTick.evaluatedFiles[]` sí aparecen.
-    - verificado en paquete publicado (`pumuki@latest`): esos campos aún no aparecen en JSON de `watch`.
-    - conclusión: bug activo de rollout/distribución (no de lógica local), pendiente de corte/release para cerrar `PUM-011`.
+  - Resultado (2026-03-05):
+    - release publicado: `pumuki@6.3.44`.
+    - verificación `@latest` en repo temporal:
+      - `lastTick.changedFiles[]` presente.
+      - `lastTick.evaluatedFiles[]` presente.
+    - leyenda Flux actualizada:
+      - `PUM-011` -> `✅ Cerrado`.
+
+- ✅ PUMUKI-163: Ejecutar siguiente pendiente activo de Flux (`PUM-012`) para garantizar contrato JSON estricto (`stdout` solo JSON) cuando se usa `--json`.
+  - Resultado (2026-03-05):
+    - `integrations/git/runPlatformGate.ts` añade `silent?: boolean` para suprimir salida humana en `stdout` al ejecutar en flujos machine-readable.
+    - `integrations/lifecycle/watch.ts` invoca `runPlatformGate(..., { silent: true })` en `watch --json` para mantener contrato estricto de parseo.
+    - cobertura de regresión añadida en `integrations/git/__tests__/runPlatformGate.test.ts`:
+      - `runPlatformGate silent evita salida humana en stdout para contratos JSON`.
+    - validación funcional de contrato:
+      - `node bin/pumuki.js watch --once --stage=PRE_COMMIT --scope=workingTree --json | jq -e '.status'` -> `JSON_PIPE_OK`.
+    - leyenda Flux actualizada:
+      - `PUM-012` -> `✅ Cerrado`.
+      - backlog Flux externo queda en `✅ 100% cerrado`.
+  - Evidencia:
+    - `npx --yes tsx@4.21.0 --test integrations/git/__tests__/runPlatformGate.test.ts integrations/lifecycle/__tests__/watch.test.ts integrations/lifecycle/__tests__/cli.test.ts` -> `81 pass / 0 fail`.
+    - `npm run -s typecheck` -> `PASS`.
+
+- ✅ PUMUKI-164: Priorizar cierre SDD pendiente de RuralGo para `sync-docs` completo (3 docs canónicos por defecto + aprendizaje operativo) y dejar contrato enterprise sin ambigüedad.
+  - Resultado (2026-03-05):
+    - `integrations/sdd/syncDocs.ts` amplía targets por defecto de `sync-docs`:
+      - `docs/strategy/ruralgo-tracking-hub.md` (sección managed auto-creable),
+      - `docs/technical/08-validation/refactor/operational-summary.md` (sección managed auto-creable),
+      - `docs/validation/refactor/last-run.json` (merge JSON determinista con `pumuki_sdd_status`),
+      - manteniendo compatibilidad con target previo (`pumuki-integration-feedback.md`) y sin romper repos que no tengan esos archivos (targets opcionales por existencia).
+    - `applyManagedSection` ahora soporta `createIfMissing` (solo cuando faltan ambos markers) para evitar conflicto falso en docs canónicos nuevos.
+    - test de regresión añadido:
+      - `integrations/sdd/__tests__/syncDocs.test.ts` -> `runSddSyncDocs por defecto sincroniza 3 docs canónicos SDD cuando existen en el repo consumer`.
+    - estado RuralGo actualizado:
+      - `/Users/juancarlosmerlosalbarracin/Developer/Projects/R_GO/docs/technical/08-validation/refactor/pumuki-integration-feedback.md`
+      - bloque “Actualizar 3 docs canónicos del consumer por defecto” -> `✅ Implementado`.
+  - Evidencia:
+    - `npx --yes tsx@4.21.0 --test integrations/sdd/__tests__/syncDocs.test.ts integrations/lifecycle/__tests__/cli.test.ts` -> `59 pass / 0 fail`.
+    - `npm run -s typecheck` -> `PASS`.
+
+- ✅ PUMUKI-165: Priorizar siguiente SDD pendiente de RuralGo para auto-sync integral de artefactos OpenSpec (`tasks.md/design.md/retrospective.md`) por contrato default.
+  - Resultado (2026-03-05):
+    - `integrations/sdd/syncDocs.ts` amplía `runSddAutoSync` para incluir por defecto targets OpenSpec por cambio:
+      - `openspec/changes/<change>/tasks.md`
+      - `openspec/changes/<change>/design.md`
+      - `openspec/changes/<change>/retrospective.md`
+    - comportamiento idempotente y compatible:
+      - crea archivo si no existe (`bootstrapIfMissing`),
+      - inserta/actualiza bloque managed `AUTO_SYNC_STATUS`,
+      - no rompe consumers existentes (targets opcionales/canónicos previos se mantienen).
+    - cobertura actualizada:
+      - `runSddAutoSync dry-run orquesta sync-docs + learning sin modificar archivos` ahora valida 4 archivos sincronizados (canónico + 3 OpenSpec),
+      - `runSddAutoSync aplica sync-docs y persiste learning en modo escritura` valida creación real de `tasks/design/retrospective` con markers.
+    - estado RuralGo actualizado:
+      - `/Users/juancarlosmerlosalbarracin/Developer/Projects/R_GO/docs/technical/08-validation/refactor/pumuki-integration-feedback.md`
+      - bloque “Auto-sync integral de tasks.md/design.md/retrospective.md por defecto” -> `✅ Implementado`.
+  - Evidencia:
+    - `npx --yes tsx@4.21.0 --test integrations/sdd/__tests__/syncDocs.test.ts integrations/lifecycle/__tests__/cli.test.ts` -> `59 pass / 0 fail`.
+    - `npm run -s typecheck` -> `PASS`.
+
+- ✅ PUMUKI-166: Priorizar último pendiente SDD de RuralGo para consumo automático universal de `learning.json` por agente/orquestador.
+  - Resultado (2026-03-05):
+    - nuevo helper `integrations/sdd/learningInsights.ts` para lectura robusta de `openspec/changes/<change>/learning.json` (cambio activo) y derivación de recomendaciones accionables.
+    - integración automática en herramientas MCP:
+      - `integrations/mcp/aiGateCheck.ts`
+      - `integrations/mcp/preFlightCheck.ts`
+      - `integrations/mcp/autoExecuteAiStart.ts`
+    - salida extendida sin romper contrato:
+      - campo `learning_context` en cada tool,
+      - hints/auto_fixes/instruction enriquecidos con recomendaciones de learning cuando existen.
+    - cobertura añadida:
+      - `integrations/mcp/__tests__/aiGateCheck.test.ts` (ingesta + auto_fix learning),
+      - `integrations/mcp/__tests__/preFlightCheck.test.ts` (learning_context en preflight),
+      - `integrations/mcp/__tests__/autoExecuteAiStart.test.ts` (mensaje/instrucción con learning).
+    - estado RuralGo actualizado:
+      - `/Users/juancarlosmerlosalbarracin/Developer/Projects/R_GO/docs/technical/08-validation/refactor/pumuki-integration-feedback.md`
+      - bloque “Consumo automático universal de learning.json por cualquier agente” -> `✅ Implementado`.
+  - Evidencia:
+    - `npx --yes tsx@4.21.0 --test integrations/mcp/__tests__/aiGateCheck.test.ts integrations/mcp/__tests__/preFlightCheck.test.ts integrations/mcp/__tests__/autoExecuteAiStart.test.ts integrations/sdd/__tests__/syncDocs.test.ts integrations/lifecycle/__tests__/cli.test.ts` -> `78 pass / 0 fail`.
+    - `npm run -s typecheck` -> `PASS`.
+
+- ✅ PUMUKI-167: Preparar release + rollout consumidor tras cierre de backlog SDD/Flux/RuralGo.
+  - Resultado (2026-03-05):
+    - versión publicada: `pumuki@6.3.45`.
+    - changelog/release notes actualizados para bloque SDD:
+      - `sync-docs` default 3 docs canónicos,
+      - `auto-sync` default `tasks/design/retrospective`,
+      - `learning_context` automático en tools MCP.
+    - rollout consumidor completado:
+      - `R_GO`: `install + status --json + doctor --json` en verde (`lifecycleState.version=6.3.45`, `issues=[]`).
+      - `SAAS:APP_SUPERMERCADOS`: `install + status --json + doctor --json` en verde (`lifecycleState.version=6.3.45`, `issues=[]`).
+      - `Flux_training`: `install + status --json + doctor --json` en verde (`lifecycleState.version=6.3.45`, `issues=[]`).
+  - Evidencia:
+    - `npx --yes tsx@4.21.0 --test integrations/mcp/__tests__/aiGateCheck.test.ts integrations/mcp/__tests__/preFlightCheck.test.ts integrations/mcp/__tests__/autoExecuteAiStart.test.ts integrations/sdd/__tests__/syncDocs.test.ts integrations/lifecycle/__tests__/cli.test.ts` -> `78 pass / 0 fail`.
+    - `npm run -s typecheck` -> `PASS`.
+    - `npm publish --access public` -> `+ pumuki@6.3.45`.
+    - `npm view pumuki@6.3.45 version` -> `6.3.45`.
+
+- ✅ PUMUKI-168: Monitorización post-release 6.3.45 en consumidores reales y captura de hallazgos netos nuevos (sin reabrir cerrados).
+  - Resultado (2026-03-05):
+    - pasada completa de `backlog-watch` en consumidores:
+      - `SAAS`: `entriesScanned=25`, `nonClosedEntries=0`, `hasActionRequired=false`.
+      - `RuralGo`: `entriesScanned=100`, `nonClosedEntries=0`, `hasActionRequired=false`.
+      - `Flux`: se detectó gap de parser (`entriesScanned=0`) con IDs `PUM-*`.
+    - fix inmediato aplicado en core backlog tooling para compatibilidad con IDs Flux:
+      - regex de IDs ampliado a `PUM-*` en:
+        - `scripts/watch-consumer-backlog-lib.ts`
+        - `scripts/reconcile-consumer-backlog-issues-lib.ts`
+        - `scripts/backlog-id-issue-map-lib.ts`
+      - tests de regresión añadidos:
+        - `scripts/__tests__/watch-consumer-backlog.test.ts`
+        - `scripts/__tests__/reconcile-consumer-backlog-issues.test.ts`
+        - `scripts/__tests__/backlog-id-issue-map-lib.test.ts`
+    - revalidación post-fix:
+      - `Flux` pasa a `entriesScanned=12`, `nonClosedEntries=0`, `hasActionRequired=false`.
+  - Evidencia:
+    - `npm run -s test:backlog-tooling` -> `51 pass / 0 fail`.
+    - `npm run -s typecheck` -> `PASS`.
+    - `npm run -s validation:backlog-watch -- --file=\"/Users/juancarlosmerlosalbarracin/Developer/Projects/SAAS:APP_SUPERMERCADOS/docs/pumuki/PUMUKI_BUGS_MEJORAS.md\" --repo=SwiftEnProfundidad/ast-intelligence-hooks --json --no-fail` -> `hasActionRequired=false`.
+    - `npm run -s validation:backlog-watch -- --file=\"/Users/juancarlosmerlosalbarracin/Developer/Projects/R_GO/docs/technical/08-validation/refactor/pumuki-integration-feedback.md\" --repo=SwiftEnProfundidad/ast-intelligence-hooks --json --no-fail` -> `hasActionRequired=false`.
+    - `npm run -s validation:backlog-watch -- --file=\"/Users/juancarlosmerlosalbarracin/Developer/Projects/Flux_training/docs/BUGS_Y_MEJORAS_PUMUKI.md\" --repo=SwiftEnProfundidad/ast-intelligence-hooks --json --no-fail` -> `entriesScanned=12`, `hasActionRequired=false`.
+
+- ✅ PUMUKI-169: Vigilancia continua post-6.3.45 + preparación de siguiente corte solo ante incidencia neta reproducible.
+  - Resultado (2026-03-05):
+    - monitorización ejecutada en los 3 consumers con `backlog-watch`:
+      - `SAAS`: `entriesScanned=25`, `nonClosedEntries=0`, `hasActionRequired=false`.
+      - `RuralGo`: `entriesScanned=100`, `nonClosedEntries=0`, `hasActionRequired=false`.
+      - `Flux`: se detectó bug de parser interno (IDs `PUM-*` no contabilizados, `entriesScanned=0`).
+    - fix aplicado en core backlog-tooling:
+      - soporte de IDs `PUM-*` añadido en:
+        - `scripts/watch-consumer-backlog-lib.ts`
+        - `scripts/reconcile-consumer-backlog-issues-lib.ts`
+        - `scripts/backlog-id-issue-map-lib.ts`
+      - regresión cubierta en tests:
+        - `scripts/__tests__/watch-consumer-backlog.test.ts`
+        - `scripts/__tests__/reconcile-consumer-backlog-issues.test.ts`
+        - `scripts/__tests__/backlog-id-issue-map-lib.test.ts`
+    - revalidación post-fix:
+      - `Flux` pasa a `entriesScanned=12`, `nonClosedEntries=0`, `hasActionRequired=false`.
+  - Evidencia:
+    - `npm run -s test:backlog-tooling` -> `51 pass / 0 fail`.
+    - `npm run -s typecheck` -> `PASS`.
+    - `npm run -s validation:backlog-watch -- --file=\"/Users/juancarlosmerlosalbarracin/Developer/Projects/Flux_training/docs/BUGS_Y_MEJORAS_PUMUKI.md\" --repo=SwiftEnProfundidad/ast-intelligence-hooks --json --no-fail` -> `entriesScanned=12`, `hasActionRequired=false`.
+
+- ✅ PUMUKI-170: Consolidar vigilancia multi-consumer en un solo comando fleet para reducir fricción operativa y mantener la señal neta en una ejecución única.
+  - Resultado (2026-03-05):
+    - nuevo comando fleet:
+      - `scripts/watch-consumer-backlog-fleet.ts`
+      - permite múltiples `--target=<path>[::repo]`, resumen agregado y salida JSON consolidada.
+    - cobertura añadida:
+      - `scripts/__tests__/watch-consumer-backlog-fleet.test.ts` (help, agregación JSON multi-target, exit code determinista con/ sin `--no-fail`).
+    - wiring operativo:
+      - `package.json`: nuevo script `validation:backlog-watch:fleet`.
+      - `docs/USAGE.md`: comportamiento, referencia rápida y ejemplo de uso multi-consumer.
+  - Evidencia:
+    - `npm run -s test:backlog-tooling` -> `54 pass / 0 fail`.
+    - `npm run -s typecheck` -> `PASS`.
+    - `npm run -s validation:backlog-watch:fleet -- --target=\"/Users/juancarlosmerlosalbarracin/Developer/Projects/SAAS:APP_SUPERMERCADOS/docs/pumuki/PUMUKI_BUGS_MEJORAS.md::SwiftEnProfundidad/ast-intelligence-hooks\" --target=\"/Users/juancarlosmerlosalbarracin/Developer/Projects/R_GO/docs/technical/08-validation/refactor/pumuki-integration-feedback.md::SwiftEnProfundidad/ast-intelligence-hooks\" --target=\"/Users/juancarlosmerlosalbarracin/Developer/Projects/Flux_training/docs/BUGS_Y_MEJORAS_PUMUKI.md\" --json --no-fail` -> `targets=3`, `has_action_required=false`.
+
+- ✅ PUMUKI-171: Mantener vigilancia continua con el nuevo comando fleet y abrir fix incremental solo ante incidencia neta reproducible.
+  - Resultado (2026-03-05):
+    - ciclo de vigilancia ejecutado con `validation:backlog-watch:fleet` en `SAAS`, `RuralGo`, `Flux`.
+    - salida consolidada limpia:
+      - `targets=3`
+      - `entries_scanned_total=137`
+      - `non_closed_total=0`
+      - `action_required_targets=0`
+      - `has_action_required=false`
+    - no se abrió frente técnico nuevo porque no hubo señal neta reproducible.
+  - Evidencia:
+    - `npm run -s validation:backlog-watch:fleet -- --target=\"/Users/juancarlosmerlosalbarracin/Developer/Projects/SAAS:APP_SUPERMERCADOS/docs/pumuki/PUMUKI_BUGS_MEJORAS.md::SwiftEnProfundidad/ast-intelligence-hooks\" --target=\"/Users/juancarlosmerlosalbarracin/Developer/Projects/R_GO/docs/technical/08-validation/refactor/pumuki-integration-feedback.md::SwiftEnProfundidad/ast-intelligence-hooks\" --target=\"/Users/juancarlosmerlosalbarracin/Developer/Projects/Flux_training/docs/BUGS_Y_MEJORAS_PUMUKI.md\" --json --no-fail` -> `has_action_required=false`.
+
+- ✅ PUMUKI-172: Automatizar vigilancia cíclica sin fricción (tick único) y dejar evidencia compacta para decisión de release/fix.
+  - Resultado (2026-03-05):
+    - nuevo comando operativo de tick:
+      - `scripts/watch-consumer-backlog-fleet-tick.ts`
+      - defaults canónicos para `SAAS`, `RuralGo` y `Flux` con overrides por flag (`--saas/--ruralgo/--flux`) y repo configurable (`--repo`).
+    - wiring operativo:
+      - `package.json`: nuevo script `validation:backlog-watch:tick`.
+      - `docs/USAGE.md`: comportamiento + referencia rápida + ejemplo de uso.
+    - cobertura añadida:
+      - `scripts/__tests__/watch-consumer-backlog-fleet-tick.test.ts` (`--help`, JSON limpio, exit code 1 con findings sin `--no-fail`).
+    - ejecución real del tick canónico completada en verde (`has_action_required=false`).
+  - Evidencia:
+    - `npm run -s test:backlog-tooling` -> `57 pass / 0 fail`.
+    - `npm run -s typecheck` -> `PASS`.
+    - `npm run -s validation:backlog-watch:tick` -> `targets=3`, `entries_scanned_total=137`, `has_action_required=false`.
+
+- ✅ PUMUKI-173: Cerrar ciclo de release incremental con criterio “no-action” documentado y checklist de publicación solo cuando haya señal neta.
+  - Resultado (2026-03-05):
+    - criterio operativo formalizado en comandos:
+      - `validation:backlog-watch:tick` (observabilidad, no bloquea pipeline).
+      - `validation:backlog-watch:gate` (gate de release, bloquea con exit code `1` cuando hay señal neta).
+    - documentación actualizada en `docs/USAGE.md` con quick reference y ejemplo explícito para ambos comandos.
+    - verificación real:
+      - `tick` y `gate` devuelven `has_action_required=false` en el estado actual de `SAAS`, `RuralGo`, `Flux`.
+  - Evidencia:
+    - `npm run -s validation:backlog-watch:tick` -> `targets=3`, `has_action_required=false`.
+    - `npm run -s validation:backlog-watch:gate` -> `targets=3`, `has_action_required=false`.
+    - `npm run -s typecheck` -> `PASS`.
+
+- ✅ PUMUKI-174: Ejecutar ciclo de vigilancia continua y preparar fix inmediato solo al primer `has_action_required=true` en consumers.
+  - Resultado (2026-03-05):
+    - ciclo de vigilancia ejecutado con ambos modos:
+      - `validation:backlog-watch:tick` (observabilidad),
+      - `validation:backlog-watch:gate` (bloqueante para release).
+    - salida consolidada del ciclo:
+      - `targets=3`
+      - `entries_scanned_total=137`
+      - `non_closed_total=0`
+      - `has_action_required=false`
+    - no se abrió issue/fix nuevo porque no hubo señal neta reproducible.
+  - Evidencia:
+    - `npm run -s validation:backlog-watch:tick` -> `has_action_required=false`.
+    - `npm run -s validation:backlog-watch:gate` -> `has_action_required=false`.
+
+- ✅ PUMUKI-175: Mantener operación continua de vigilancia y disparar fix/release incremental únicamente con señal neta (`has_action_required=true`).
+  - Resultado (2026-03-05):
+    - ciclo de vigilancia periódico ejecutado en modo observabilidad (`tick`) y modo gate (`gate`).
+    - señal consolidada estable:
+      - `targets=3`
+      - `entries_scanned_total=137`
+      - `non_closed_total=0`
+      - `action_required_targets=0`
+      - `has_action_required=false`
+    - no se abrió issue/fix nuevo al no existir incidencia neta reproducible.
+  - Evidencia:
+    - `npm run -s validation:backlog-watch:tick` -> `has_action_required=false`.
+    - `npm run -s validation:backlog-watch:gate` -> `has_action_required=false`.
+
+- ✅ PUMUKI-176: Continuar vigilancia operativa y abrir ejecución técnica inmediata al primer hallazgo neto en SAAS/RuralGo/Flux.
+  - Resultado (2026-03-05):
+    - ciclo ejecutado con `tick` y `gate` en los tres consumers.
+    - resumen consolidado:
+      - `targets=3`
+      - `entries_scanned_total=137`
+      - `non_closed_total=0`
+      - `action_required_targets=0`
+      - `has_action_required=false`
+    - sin señal neta reproducible, por lo que no se abrió fix nuevo.
+  - Evidencia:
+    - `npm run -s validation:backlog-watch:tick` -> `has_action_required=false`.
+    - `npm run -s validation:backlog-watch:gate` -> `has_action_required=false`.
+
+- ✅ PUMUKI-177: Mantener vigilancia continua y disparar fix inmediato al primer `has_action_required=true` con actualización simultánea de leyendas externas e internas.
+  - Resultado (2026-03-05):
+    - se detectó señal neta en `Flux` (`has_action_required=true`) por `needs_issue` en `PUM-009/010/011`.
+    - normalización ejecutada sin tocar código funcional del consumer:
+      - `PUM-009` validado como corregido con `pumuki@latest` (`artifact.version="1"` + `artifact.slices[]`) y marcado `✅ Cerrado`.
+      - `PUM-011` validado como corregido con `pumuki@latest` (`lastTick.changedFiles[]` + `lastTick.evaluatedFiles[]`) y marcado `✅ Cerrado`.
+      - `PUM-010` mantenido activo y enlazado a issue upstream `#719` para trazabilidad (`🚧 En construccion`).
+    - tras normalización de leyenda/refs en MD externo, el ciclo vuelve a estado saludable (`has_action_required=false`).
+  - Evidencia:
+    - `gh issue create ...` -> `https://github.com/SwiftEnProfundidad/ast-intelligence-hooks/issues/719`.
+    - `npx --yes --package pumuki@latest pumuki sdd evidence --scenario-id=docs/validation/features/p3_t1_web_shell_dashboard --test-command="pnpm test" --test-status=passed --json` (en Flux) -> contrato válido.
+    - `npx --yes --package pumuki@latest pumuki watch --once --stage=PRE_COMMIT --scope=staged --json` (en Flux) -> `lastTick.changedFiles[]` y `lastTick.evaluatedFiles[]` presentes.
+    - `npm run -s validation:backlog-watch:tick` + `npm run -s validation:backlog-watch:gate` -> `has_action_required=false`.
+
+- ✅ PUMUKI-178: Ejecutar implementación técnica del issue `#719` para persistencia estable de skills coverage entre iteraciones en consumer.
+  - Resultado (2026-03-05):
+    - `stageRunners` ahora replica el patrón de auto-reconcile de `watch` para bloqueos de skills coverage en hooks (`PRE_COMMIT`/`PRE_PUSH`):
+      - detecta códigos de bloqueo de cobertura de skills,
+      - ejecuta `policy reconcile --strict --apply`,
+      - reintenta una única vez el gate de hook con política re-resuelta.
+    - cobertura de regresión añadida:
+      - retry exitoso con reconcile automático en `PRE_COMMIT`,
+      - no-retry cuando `PUMUKI_HOOK_POLICY_AUTO_RECONCILE=0`.
+  - Evidencia:
+    - `npx --yes tsx@4.21.0 --test integrations/git/__tests__/stageRunners.test.ts` -> `30 pass / 0 fail`.
+    - `npm run -s typecheck` -> `PASS`.
+
+- ✅ PUMUKI-179: Ejecutar siguiente foco activo de Flux (`PUM-012`) para eliminar drift entre binario local del consumer y `pumuki@latest` en contrato `watch --json` (`changedFiles/evaluatedFiles` + versión efectiva).
+  - Resultado (2026-03-05):
+    - `watch --json` ahora expone bloque `version` con:
+      - `effective`, `runtime`, `consumerInstalled`, `source`,
+      - `driftFromRuntime`,
+      - `driftWarning` humano/accionable cuando existe desalineación.
+    - cobertura técnica añadida:
+      - `integrations/lifecycle/__tests__/watch.test.ts` (metadata + warning de drift),
+      - ajuste de contrato en `integrations/lifecycle/__tests__/cli.test.ts`.
+  - Evidencia:
+    - `npx --yes tsx@4.21.0 --test integrations/lifecycle/__tests__/watch.test.ts integrations/lifecycle/__tests__/cli.test.ts` -> `48 pass / 0 fail`.
+    - `npm run -s typecheck` -> `PASS`.
+    - smoke consumer Flux (binario local core): `watch --once --json` -> `version.driftFromRuntime=true` + `driftWarning` presente.
+
+- 🚧 PUMUKI-180: Cerrar rollout consumidor de `PUM-012` (release + update en Flux) y mover leyenda externa de `🚧` a `✅` con evidencia en `pnpm exec pumuki watch --json`.

package/integrations/git/runPlatformGate.ts

@@ -769,6 +769,7 @@ export async function runPlatformGate(params: {
   auditMode?: 'gate' | 'engine';
   policyTrace?: ResolvedStagePolicy['trace'];
   scope: GateScope;
+  silent?: boolean;
   sddShortCircuit?: boolean;
   services?: Partial<GateServices>;
   dependencies?: Partial<GateDependencies>;
@@ -797,7 +798,9 @@ export async function runPlatformGate(params: {
       repoRoot
     );
     if (!sddDecision.allowed) {
-      process.stdout.write(`[pumuki][sdd] ${sddDecision.code}: ${sddDecision.message}\n`);
+      if (params.silent !== true) {
+        process.stdout.write(`[pumuki][sdd] ${sddDecision.code}: ${sddDecision.message}\n`);
+      }
       sddBlockingFinding = toSddBlockingFinding(sddDecision);
       if (shouldShortCircuitSdd) {
         const emptyDetectedPlatforms: DetectedPlatforms = {};
@@ -972,16 +975,18 @@ export async function runPlatformGate(params: {
   const astIntelligenceDualFinding = astIntelligenceDualValidation?.finding;
   if (astIntelligenceDualValidation && astIntelligenceDualValidation.mode !== 'off') {
     const summary = astIntelligenceDualValidation.summary;
-    process.stdout.write(
-      `[pumuki][ast-intelligence] mode=${astIntelligenceDualValidation.mode}` +
-      ` mapped_rules=${summary.mapped_rules}` +
-      ` compared_rules=${summary.compared_rules}` +
-      ` divergences=${summary.divergences}` +
-      ` false_positives=${summary.false_positives}` +
-      ` false_negatives=${summary.false_negatives}` +
-      ` latency_ms=${summary.latency_ms}` +
-      ` languages=[${summary.languages.join(',') || 'none'}]\n`
-    );
+    if (params.silent !== true) {
+      process.stdout.write(
+        `[pumuki][ast-intelligence] mode=${astIntelligenceDualValidation.mode}` +
+        ` mapped_rules=${summary.mapped_rules}` +
+        ` compared_rules=${summary.compared_rules}` +
+        ` divergences=${summary.divergences}` +
+        ` false_positives=${summary.false_positives}` +
+        ` false_negatives=${summary.false_negatives}` +
+        ` latency_ms=${summary.latency_ms}` +
+        ` languages=[${summary.languages.join(',') || 'none'}]\n`
+      );
+    }
   }
   const degradedModeBlocks = params.policyTrace?.degraded?.action === 'block';
   const rulesCoverage = coverage
@@ -1170,9 +1175,11 @@ export async function runPlatformGate(params: {
     } catch (error) {
       const rawReason = error instanceof Error ? error.message : String(error);
       const reason = rawReason.trim().replace(/\s+/g, ' ');
-      process.stdout.write(
-        `[pumuki][memory-shadow] unavailable reason=${reason.length > 0 ? reason : 'unknown_error'}\n`
-      );
+      if (params.silent !== true) {
+        process.stdout.write(
+          `[pumuki][memory-shadow] unavailable reason=${reason.length > 0 ? reason : 'unknown_error'}\n`
+        );
+      }
     }
   }
   const memoryShadow:
@@ -1196,11 +1203,13 @@ export async function runPlatformGate(params: {
       : undefined;
 
   if (memoryShadowRecommendation) {
-    process.stdout.write(
-      `[pumuki][memory-shadow] recommended=${memoryShadowRecommendation.recommendedOutcome}` +
-      ` confidence=${memoryShadowRecommendation.confidence.toFixed(2)}` +
-      ` reasons=${memoryShadowRecommendation.reasonCodes.join(',')}\n`
-    );
+    if (params.silent !== true) {
+      process.stdout.write(
+        `[pumuki][memory-shadow] recommended=${memoryShadowRecommendation.recommendedOutcome}` +
+        ` confidence=${memoryShadowRecommendation.confidence.toFixed(2)}` +
+        ` reasons=${memoryShadowRecommendation.reasonCodes.join(',')}\n`
+      );
+    }
   }
 
   dependencies.emitPlatformGateEvidence({
@@ -1224,7 +1233,9 @@ export async function runPlatformGate(params: {
   });
 
   if (gateOutcome === 'BLOCK') {
+    if (params.silent !== true) {
     dependencies.printGateFindings(findingsWithWaiver);
+    }
     return 1;
   }