create-quiver 0.15.4 → 0.16.0

package/docs/specs/01-spec/07-slice/07-slice.md

@@ -0,0 +1,105 @@
+# 07-slice - Docs, tests y evidencia
+
+## 1. Nombre del slice
+
+Docs, tests y evidencia.
+
+## 2. Objetivo del slice
+
+Planificar como validar y documentar cambios futuros para que CLI, docs y tests no diverjan.
+
+## 3. Problema puntual que resuelve
+
+Evita que tests nuevos den falsa seguridad o que docs generadas no coincidan con la CLI real.
+
+## 4. Valor observable que entrega
+
+Contrato de evidencia para futuras implementaciones: pruebas minimas, docs afectadas y criterios de cierre.
+
+## 5. Alcance especifico
+
+Plan documental de validacion, no ejecucion de tests ni cambios de docs.
+
+## 6. Que incluye
+
+- Mapa de cobertura existente.
+- Reglas para no reemplazar cobertura sin equivalencia.
+- Gate CLI/docs.
+- Evidencia minima por tipo de cambio.
+- Registro de validaciones pendientes.
+
+## 7. Que no incluye
+
+- Ejecutar tests.
+- Modificar tests.
+- Regenerar docs.
+- Cambiar codigo.
+
+## 8. Actores involucrados
+
+Reviewer, implementador futuro, maintainer y usuarios CLI.
+
+## 9. Precondiciones
+
+Contrato de no regresion aprobado y planes de extraccion definidos.
+
+## 10. Entradas necesarias
+
+Baseline, matriz de comandos, tests existentes y docs actuales.
+
+## 11. Flujo operativo paso a paso
+
+1. Mapear tests actuales por comportamiento.
+2. Identificar docs que describen comandos.
+3. Definir evidencia minima por cambio.
+4. Definir gate CLI/docs.
+5. Definir criterios para cobertura reemplazada.
+6. Definir reporte de cierre.
+
+## 12. Salidas esperadas
+
+Checklist de validacion y evidencia para implementaciones futuras.
+
+## 13. Reglas de negocio aplicables
+
+- No se elimina cobertura sin reemplazo equivalente.
+- Docs deben reflejar CLI real.
+- Evidencia no ejecutada se marca pendiente, no aprobada.
+- Cambios de JSON/exit code requieren pruebas especificas.
+
+## 14. Validaciones
+
+- Cada tipo de cambio tiene evidencia minima.
+- Hay criterio para docs generadas.
+- Hay criterio para tests reemplazados.
+- Hay formato de riesgos residuales.
+
+## 15. Manejo de errores o edge cases
+
+- Si una validacion no puede ejecutarse, registrar motivo y riesgo.
+- Si docs se generan automaticamente, validar fuente y output.
+- Si test viejo se borra, exigir mapeo de cobertura.
+
+## 16. Criterios de aceptacion
+
+- Existe checklist de evidencia por tipo de cambio.
+- Existe gate CLI/docs.
+- Existe regla de cobertura equivalente.
+- Validaciones pendientes no se confunden con exitos.
+- Cierre requiere riesgos residuales explicitos.
+
+## 17. Dependencias tecnicas, funcionales o externas
+
+Baseline, contrato y planes de extraccion.
+
+## 18. Depende de slices
+
+`03-slice`, `05-slice` y `06-slice` como insumos para tipos de cambio.
+
+## 19. Riesgos / decisiones abiertas
+
+Puede haber docs generadas cuyo proceso no este documentado.
+
+## 20. Pendientes / preguntas abiertas
+
+Definir si evidencia minima sera manual, automatizada o ambas.

package/docs/specs/01-spec/07-slice/CLOSURE_BRIEF.md

@@ -0,0 +1,71 @@
+# CLOSURE_BRIEF - 07-slice
+
+## Resultado
+
+Completado como contrato de docs, tests y evidencia, consolidado con el gate real usado durante `06-slice`.
+
+## Evidencia
+
+Checklist de evidencia por tipo de cambio futuro:
+
+| Tipo de cambio | Evidencia minima |
+|---|---|
+| Parser/dispatch | `node --check` de entrypoints afectados; help global; comando desconocido; version human/json; matriz de comandos afectados |
+| Comando existente | Antes/despues; flags; aliases; stdout/stderr; JSON si aplica; exit codes; side effects; rollback |
+| Comando nuevo | No colisiona con namespace existente; registry actualizado; help actualizado; tests o evidencia manual; rollback |
+| Docs de comandos | `npm run docs:commands:write` cuando cambie help o registry; `npm run docs:commands:check` como gate obligatorio |
+| Tests reemplazados | Mapeo explicito de cobertura anterior -> nueva cobertura equivalente antes de borrar o debilitar tests |
+| JSON contract | Ejemplo JSON parseable; campos estables; `schema_version` cuando exista contrato de versionado |
+| Write-capable command | `--dry-run` o sandbox; rutas generadas; side effects esperados; rollback; evidencia de no tocar rutas fuera de alcance |
+
+Gate CLI/docs:
+
+- Docs de comandos no pueden cerrarse si contradicen `--help`.
+- Docs generadas deben indicar fuente y comando/generador usado.
+- Validaciones pendientes se registran como pendientes, no como exitos.
+- Todo cambio que altere el command surface debe actualizar `docs/reference/commands.md` con `npm run docs:commands:write`.
+- Todo PR que altere comandos debe pasar `npm run docs:commands:check`.
+- Todo PR que altere `CHANGELOG.md` o comandos relacionados con changelog debe pasar `npm run changelog:check`.
+
+Gate minimo por PR de CLI:
+
+| Gate | Cuando aplica | Evidencia esperada |
+|---|---|---|
+| Sintaxis | Siempre que cambie JS ejecutable o tests JS | `node --check <archivos afectados>` |
+| Contrato CLI | Parser, registry, dispatch, help, comandos publicos | `node --test tests/commands/parser-contract.test.js tests/commands/cli-contract.test.js` o suite equivalente justificada |
+| Docs generadas | Cambios en help, registry o comandos documentados | `npm run docs:commands:check` |
+| Changelog | Cambios en changelog o wrapper de changelog | `npm run changelog:check` |
+| Comando manual | Comando nuevo o comportamiento modificado | Ejecucion humana y `--json` si aplica, con exit code esperado |
+
+Regla de cobertura equivalente:
+
+- No borrar tests existentes sin listar que comportamiento cubrian.
+- No reemplazar tests por snapshots mas amplios si se pierde verificacion de campos, exit codes o stderr.
+- Si una cobertura vieja no puede mantenerse, registrar riesgo residual y aprobacion requerida.
+- Tests nuevos no sustituyen evidencia manual cuando el cambio afecta UX humana, help o side effects.
+
+Formato obligatorio de cierre:
+
+- Cambios de comportamiento: que hacia antes, que hace ahora, por que mejora.
+- Evidencia ejecutada: comando exacto y resultado.
+- Evidencia pendiente: comando no ejecutado, motivo y riesgo.
+- Riesgos residuales: impacto posible y rollback.
+- Decision sobre ramas: conservar, cerrar o revisar, sin ejecutar limpieza automatica.
+
+## Cambios de comportamiento
+
+Ninguno. Solo contrato de evidencia.
+
+## Regresiones detectadas
+
+Ninguna.
+
+## Riesgos residuales
+
+- No se ejecutaron tests en este slice porque no hubo implementacion runtime.
+- El contrato depende de que cada slice tecnico declare sus archivos afectados y no oculte cambios de comportamiento.
+- Si aparece una suite nueva de comandos, debe mapearse contra esta matriz antes de reemplazar la existente.
+
+## Decision sobre ramas
+
+No cerrar ramas fuente hasta completar evidencia de extraccion o decision de descarte.

package/docs/specs/01-spec/07-slice/EXECUTION_BRIEF.md

@@ -0,0 +1,39 @@
+# EXECUTION_BRIEF - 07-slice
+
+## Objetivo
+
+Definir evidencia minima para que docs, tests y CLI no diverjan.
+
+## Base segura
+
+Usar baseline y contrato aprobados.
+
+## Archivos candidatos
+
+Documentos de checklist/evidencia dentro del spec.
+
+## Archivos excluidos
+
+Tests reales, docs reales generadas y codigo fuente.
+
+## Funcionalidad existente afectada
+
+Ninguna durante este slice.
+
+## Matriz antes/despues
+
+Debe requerirse en implementaciones futuras que cambien comandos o docs.
+
+## Validaciones
+
+- Evidencia minima por tipo de cambio.
+- Cobertura equivalente si se reemplazan tests.
+- Gate CLI/docs.
+
+## Riesgos
+
+Falsa seguridad si se registran validaciones pendientes como exitos.
+
+## Rollback
+
+Corregir el contrato de evidencia antes de autorizar implementacion.

package/docs/specs/01-spec/08-slice/08-slice.json

@@ -0,0 +1,36 @@
+{
+  "slice_id": "08-slice",
+  "slice_number": "08",
+  "title": "Limpieza controlada de ramas",
+  "objective": "Proponer cierre o eliminacion de ramas solo cuando exista evidencia y aprobacion explicita.",
+  "problem": "Evita borrar ramas utiles, protegidas, historicas o con PRs abiertos por una clasificacion incompleta.",
+  "value_outcome": "Lista final de acciones sugeridas por rama, con aprobacion requerida y sin ejecutar ninguna accion.",
+  "scope": {
+    "includes": ["Clasificacion final", "Local/remota/protegida/historica", "Dependencias", "Recomendaciones", "Comandos seguros sugeridos"],
+    "excludes": ["Delete local/remoto", "Cerrar PRs", "Push", "Cambiar protecciones"]
+  },
+  "actors": ["Maintainer", "Tech Lead", "Usuario aprobador"],
+  "preconditions": ["Extracciones completadas o decision de no extraer mas valor"],
+  "inputs": ["Inventario de ramas", "Matriz de extraccion", "Decisiones de cierre", "Aprobaciones"],
+  "outputs": ["Plan de limpieza pendiente de aprobacion"],
+  "workflow": [
+    {"step": 1, "name": "Revisar ramas", "description": "Revisar ramas sin delta y fuentes de extraccion."},
+    {"step": 2, "name": "Marcar protecciones", "description": "Distinguir historicas, protegidas y no tocar."},
+    {"step": 3, "name": "Verificar frescura", "description": "Verificar estado remoto antes de accion final."},
+    {"step": 4, "name": "Pedir aprobacion", "description": "Solicitar aprobacion explicita antes de eliminar."}
+  ],
+  "business_rules": ["No eliminar sin aprobacion", "Cerrar y eliminar son distintos", "Historicas/protegidas se conservan", "Fuentes se conservan hasta cerrar extracciones"],
+  "validations": ["Accion y motivo por rama", "Eliminacion requiere aprobacion", "Estados diferenciados", "Sin extracciones pendientes"],
+  "error_cases": ["PR abierto", "Ref remota stale", "Backup historico"],
+  "acceptance_criteria": ["No se ejecuta eliminacion", "Destructivo pendiente de aprobacion", "Fuentes no eliminadas prematuramente", "Estados no mezclados", "Comandos seguros sugeridos"],
+  "dependencies": {
+    "functional": ["Inventario", "Decisiones de extraccion"],
+    "technical": ["Git"],
+    "external": ["Politica de proteccion de ramas si existe"],
+    "depends_on_slices": ["01-slice", "04-slice"]
+  },
+  "implementation_order": 8,
+  "slicing_rationale": "La limpieza se deja al final para no perder fuentes antes de extraer valor.",
+  "risks": ["Requiere verificacion remota o politica externa"],
+  "open_questions": ["Aprobacion por rama o por grupo claramente listado?"]
+}

package/docs/specs/01-spec/08-slice/08-slice.md

@@ -0,0 +1,105 @@
+# 08-slice - Limpieza controlada de ramas
+
+## 1. Nombre del slice
+
+Limpieza controlada de ramas.
+
+## 2. Objetivo del slice
+
+Proponer cierre o eliminacion de ramas solo cuando exista evidencia y aprobacion explicita.
+
+## 3. Problema puntual que resuelve
+
+Evita borrar ramas utiles, protegidas, historicas o con PRs abiertos por una clasificacion incompleta.
+
+## 4. Valor observable que entrega
+
+Lista final de acciones sugeridas por rama, con aprobacion requerida y sin ejecutar ninguna accion.
+
+## 5. Alcance especifico
+
+Plan documental de limpieza. No elimina ramas.
+
+## 6. Que incluye
+
+- Clasificacion final de ramas.
+- Distincion local/remota/protegida/historica.
+- Dependencias con extracciones pendientes.
+- Recomendacion: mantener, cerrar, eliminar con aprobacion, revisar.
+- Comandos seguros sugeridos.
+
+## 7. Que no incluye
+
+- Ejecutar delete local/remoto.
+- Cerrar PRs.
+- Push.
+- Cambiar protecciones.
+
+## 8. Actores involucrados
+
+Maintainer, Tech Lead y usuario aprobador.
+
+## 9. Precondiciones
+
+Slices de extraccion completados o decision explicita de no extraer mas valor.
+
+## 10. Entradas necesarias
+
+Inventario de ramas, matriz de extraccion, decisiones de cierre y aprobaciones.
+
+## 11. Flujo operativo paso a paso
+
+1. Revisar ramas sin delta.
+2. Revisar ramas usadas como fuente de extraccion.
+3. Marcar protegidas/historicas/no tocar.
+4. Verificar freshness remota antes de accion final.
+5. Agrupar recomendaciones.
+6. Pedir aprobacion explicita antes de eliminar.
+
+## 12. Salidas esperadas
+
+Plan de limpieza con acciones pendientes de aprobacion.
+
+## 13. Reglas de negocio aplicables
+
+- No eliminar sin aprobacion explicita.
+- `cerrar` y `eliminar` son acciones distintas.
+- Ramas historicas/protegidas se conservan salvo decision explicita.
+- Ramas fuente se conservan hasta cerrar extracciones.
+
+## 14. Validaciones
+
+- Cada rama tiene accion propuesta y motivo.
+- Cada eliminacion requiere aprobacion.
+- Local/remota/protegida/historica estan diferenciadas.
+- No quedan extracciones pendientes antes de limpiar fuente.
+
+## 15. Manejo de errores o edge cases
+
+- Si hay PR abierto, marcar revision manual.
+- Si rama remota no existe, registrar stale ref.
+- Si rama es backup, confirmar si se conserva como historica.
+
+## 16. Criterios de aceptacion
+
+- No se ejecuta ninguna eliminacion.
+- Toda accion destructiva queda como pendiente de aprobacion.
+- Ramas usadas como fuente no se eliminan prematuramente.
+- Estados `sin delta`, `cerrable` y `eliminable` no se mezclan.
+- El plan incluye comandos seguros sugeridos.
+
+## 17. Dependencias tecnicas, funcionales o externas
+
+Inventario actualizado y decisiones de extraccion.
+
+## 18. Depende de slices
+
+`01-slice` y `04-slice`; idealmente despues de `05-slice` y `06-slice`.
+
+## 19. Riesgos / decisiones abiertas
+
+Puede requerir verificacion remota o politica externa de proteccion de ramas.
+
+## 20. Pendientes / preguntas abiertas
+
+Definir si la aprobacion sera por rama o por grupo de ramas claramente listado.

package/docs/specs/01-spec/08-slice/CLOSURE_BRIEF.md

@@ -0,0 +1,114 @@
+# CLOSURE_BRIEF - 08-slice
+
+## Resultado
+
+Completado como plan de limpieza controlada con snapshot remoto fresco del 2026-06-09; no se ejecuto limpieza.
+
+## Evidencia
+
+Politica de acciones:
+
+| Estado | Accion permitida ahora | Requiere aprobacion |
+|---|---|---|
+| `sin delta` (`ahead=0`) | Marcar como sin merge pendiente | Cierre/eliminacion posterior |
+| `historical/no-delta` | Conservar salvo decision explicita | Cualquier eliminacion |
+| `review-for-extraction` | Mantener hasta decidir extraccion | Cierre/eliminacion |
+| `extract-or-conflict-review` | Mantener hasta resolver matriz/riesgo | Cierre/eliminacion |
+| remoto stale/no verificado | No tocar | Verificacion remota + aprobacion |
+
+Snapshot usado:
+
+| Dato | Valor |
+|---|---|
+| Fecha | 2026-06-09 |
+| Base | `origin/main` |
+| SHA base | `7c22ce1` |
+| Rama activa | `feature/QUIVER-08-controlled-branch-cleanup` |
+| Metodo remoto | `git fetch origin` + `git ls-remote --heads origin` |
+| PRs abiertos detectados | `#94 feature/QUIVER-46-49-cli-modernization -> main` |
+
+Ramas remotas reales en GitHub:
+
+| Grupo | Ramas | Estado contra `origin/main` | Accion recomendada |
+|---|---|---|---|
+| Remotas sin delta pendiente | `docs/QUIVER-11-existing-project-migration`, `docs/QUIVER-21-ai-first-layout`, `docs/npx-node-modules-guidance`, `feature/QUIVER-04-next-command`, `feature/QUIVER-04-workflow-guardrails-alignment` | `ahead=0`; ya estan contenidas en `origin/main` | Candidatas a cierre/eliminacion remota con aprobacion explicita por grupo |
+| Remotas con delta pendiente | `drafts/v19-v22-orchestration-followups`, `feature/QUIVER-01-ci-matrix-verified`, `feature/QUIVER-20-ai-cli-orchestration` | `ahead>0`; tienen commits no incluidos en `origin/main` | Revisar manualmente antes de cerrar o eliminar |
+| Remota fuente con PR abierto | `feature/QUIVER-46-49-cli-modernization` | `ahead=3`; PR abierto `#94` | Mantener; no cerrar ni eliminar hasta resolver PR/extracciones |
+| Protegida/base | `main` | Base actual | No tocar |
+
+Refs `origin/*` locales stale detectadas:
+
+| Ref local stale | Estado | Accion recomendada |
+|---|---|---|
+| `origin/feature/QUIVER-05-parser-command-registry` | No existe en `ls-remote`; `ahead=0` | Prune local de remote-tracking solo con aprobacion; no hay rama remota que eliminar |
+| `origin/feature/QUIVER-06-command-wrappers` | No existe en `ls-remote`; `ahead=0` | Prune local de remote-tracking solo con aprobacion; no hay rama remota que eliminar |
+| `origin/feature/QUIVER-07-docs-tests-evidence` | No existe en `ls-remote`; `ahead=0` | Prune local de remote-tracking solo con aprobacion; no hay rama remota que eliminar |
+| `origin/feature/QUIVER-52-02-v52-generated-cli-reference` | No existe en `ls-remote`; `ahead=0` | Prune local de remote-tracking solo con aprobacion; no hay rama remota que eliminar |
+| `origin/feature/QUIVER-52-03-v52-release-package-hygiene` | No existe en `ls-remote`; `ahead=0` | Prune local de remote-tracking solo con aprobacion; no hay rama remota que eliminar |
+
+Ramas locales con delta pendiente o decision manual:
+
+| Rama local | Estado | Accion recomendada |
+|---|---|---|
+| `main` | Divergida: `ahead=1`, `behind=50` contra `origin/main` | No usar como base; revisar y decidir sincronizacion por separado |
+| `backup/QUIVER-52-03-before-squash` | Local-only backup; `ahead=3` | Mantener como historica hasta aprobacion explicita |
+| `backup/main-before-pull-v31` | Local-only backup; `ahead=9` | Mantener como historica hasta aprobacion explicita |
+| `docs/QUIVER-02-decision-log-context-checkpoint` | Local-only; `ahead=1` | Revisar manualmente antes de limpiar |
+| `drafts/v19-v22-orchestration-followups` | Remota real; `ahead=1` | Revisar manualmente antes de limpiar |
+| `feature/QUIVER-01-ci-matrix-verified` | Remota real; `ahead=2` | Revisar manualmente antes de limpiar |
+| `feature/QUIVER-03-project-map-reading-order` | Local-only; `ahead=1` | Revisar manualmente antes de limpiar |
+| `feature/QUIVER-20-ai-cli-orchestration` | Remota real; `ahead=1` | Revisar manualmente antes de limpiar |
+| `feature/QUIVER-46-49-cli-modernization` | Remota real; `ahead=3`; PR `#94` abierto | Mantener; fuente principal y PR abierto |
+| `feature/QUIVER-50-01-runtime-minimum-and-package-metadata` | Local-only; `ahead=1` | Revisar manualmente antes de limpiar |
+| `feature/QUIVER-50-03-v50-security-reporting` | Local-only; `ahead=1` | Revisar manualmente antes de limpiar |
+| `feature/QUIVER-50-06-contributor-and-architecture-docs` | Local-only; `ahead=1` | Revisar manualmente antes de limpiar |
+
+Ramas locales sin delta pendiente candidatas a limpieza local con aprobacion:
+
+| Grupo | Ramas | Accion recomendada |
+|---|---|---|
+| Slices ya mergeados | `feature/QUIVER-05-parser-command-registry`, `feature/QUIVER-06-command-wrappers`, `feature/QUIVER-07-docs-tests-evidence` | Candidatas a eliminar localmente con aprobacion despues de confirmar que no se necesitan para rollback |
+| Docs historicas sin delta | `codex/wdd-sdd-ai-readme`, `docs/QUIVER-02-close-v06-roadmap`, `docs/QUIVER-20-ai-first-readme`, `docs/QUIVER-21-ai-first-layout`, `docs/mark-v08-v12-slices-completed`, `docs/npx-node-modules-guidance`, `docs/onboarding-prompt-contract`, `docs/pr-policy-slice-default`, `docs/quiver-v18-stabilization-close`, `docs/quiver-v18-stabilization-spec`, `docs/readme-cross-platform-onboarding`, `docs/restore-documentation-index`, `docs/update-v09-release` | Candidatas a limpieza local con aprobacion; conservar si se quieren como historicas |
+| Features sin delta | `feature/QUIVER-01-auto-install-dev-dep`, `feature/QUIVER-22-guided-ai-workflow`, `feature/QUIVER-24-dx-onboarding-hardening`, `feature/QUIVER-28-pixel-quiver-feedback-reconciliation`, `feature/QUIVER-29-planner-prepare-context-cli-ux`, `feature/QUIVER-30-interactive-cli-ux-agent-selection`, `feature/QUIVER-31-ai-model-catalog-agent-selection`, `feature/QUIVER-33-approval-ux-and-planner-progress`, `feature/QUIVER-35-compact-dashboard-version-ux`, `feature/QUIVER-36-ai-run-watch-portable-spec`, `feature/QUIVER-37-cli-i18n-foundation`, `feature/QUIVER-38-01-v38-version-dashboard-help`, `feature/QUIVER-38-02-v38-flow-doctor-next-graph`, `feature/QUIVER-39-01-v39-init-interactive-language`, `feature/QUIVER-40-01-v40-spec-create-start-status`, `feature/QUIVER-41-01-v41-ai-run-status-resume`, `feature/QUIVER-42-01-v42-template-language-routing`, `feature/QUIVER-43-01-v43-command-language-mode-matrix`, `feature/QUIVER-44-00-v44-tui-lite-contract-foundation`, `feature/QUIVER-50-audit-trust-foundation`, `feature/QUIVER-50-audit-trust-foundation-execution`, `feature/QUIVER-51-01-v51-flow-json-compatibility`, `feature/QUIVER-51-02-v51-dashboard-section-i18n`, `feature/QUIVER-51-03-v51-base-branch-policy`, `feature/QUIVER-51-04-v51-next-plan-graph-ux`, `feature/QUIVER-51-05-v51-evidence-robustness`, `feature/QUIVER-51-06-v51-namespace-windows-scripts`, `feature/QUIVER-51-cli-ergonomics-automation-contracts`, `feature/QUIVER-52-01-v52-slice-json-schema`, `feature/QUIVER-52-02-v52-generated-cli-reference`, `feature/QUIVER-52-03-v52-release-package-hygiene`, `feature/QUIVER-52-schema-docs-release-hygiene`, `feature/quiver-readme-onboarding-guides`, `feature/quiver-v25-ai-first-lifecycle-orchestrator`, `feature/quiver-v26-0121-smoke-hardening` | Candidatas a limpieza local con aprobacion |
+| Fix/hotfix/release sin delta | `fix/QUIVER-45-01-ci-actions-node24-readiness`, `hotfix/QUIVER-24-ci-after-merge`, `hotfix/onboarding-docs-0.9.1`, `release/0.8.0` | Candidatas a limpieza local con aprobacion; confirmar politica historica antes |
+| Protegida/historica especial | `develop` | Aunque `ahead=0`, conservar o revisar manualmente por posible politica historica |
+| Rama activa | `feature/QUIVER-08-controlled-branch-cleanup` | Mantener hasta cerrar este slice/PR |
+
+Comandos seguros sugeridos para revision manual futura:
+
+```bash
+git ls-remote --heads origin
+gh pr list --state open --json number,headRefName,baseRefName,title,url --limit 100
+git remote prune origin --dry-run
+git branch --contains <branch>
+git log --oneline origin/main..<branch>
+git diff --stat origin/main...<branch>
+git merge-tree "$(git merge-base origin/main <branch>)" origin/main <branch>
+```
+
+Comandos destructivos que no se ejecutaron y requieren aprobacion explicita:
+
+```bash
+git branch -d <branch>
+git push origin --delete <branch>
+git remote prune origin
+```
+
+## Cambios de comportamiento
+
+Ninguno.
+
+## Regresiones detectadas
+
+Ninguna.
+
+## Riesgos residuales
+
+- Hubo `fetch`, pero no hubo `prune`; las refs stale siguen locales a proposito.
+- La verificacion de PRs abiertos detecto `#94`; cualquier cambio de estado posterior requiere nueva consulta.
+- Politicas externas de ramas protegidas no son visibles solo con Git local.
+- Ramas `backup/*`, `develop`, `release/*` y `hotfix/*` pueden tener valor historico aunque no tengan delta pendiente.
+
+## Decision sobre ramas
+
+Ninguna rama fue eliminada, cerrada, mergeada o modificada. Toda accion destructiva queda pendiente de aprobacion explicita posterior.

package/docs/specs/01-spec/08-slice/EXECUTION_BRIEF.md

@@ -0,0 +1,39 @@
+# EXECUTION_BRIEF - 08-slice
+
+## Objetivo
+
+Preparar recomendaciones de limpieza sin ejecutar ninguna accion destructiva.
+
+## Base segura
+
+Usar inventario actualizado y decisiones de extraccion cerradas.
+
+## Archivos candidatos
+
+Documentos de plan de limpieza.
+
+## Archivos excluidos
+
+Refs Git, ramas locales/remotas, PRs y configuracion remota.
+
+## Funcionalidad existente afectada
+
+Ninguna durante este slice.
+
+## Matriz antes/despues
+
+No aplica a comportamiento de CLI. Debe existir matriz de estado por rama.
+
+## Validaciones
+
+- Cada rama tiene accion y motivo.
+- Eliminaciones requieren aprobacion explicita.
+- Fuentes de extraccion no se eliminan antes de cierre.
+
+## Riesgos
+
+Borrar una rama historica, protegida o con PR abierto si no se verifica correctamente.
+
+## Rollback
+
+No ejecutar delete. Si una recomendacion es incorrecta, corregir el plan antes de pedir aprobacion.

package/docs/specs/01-spec/CLOSURE_BRIEF.md

@@ -0,0 +1,87 @@
+# CLOSURE_BRIEF - Spec 01
+
+## Resultado
+
+Spec 01 cerrada como iniciativa de recuperacion segura de ramas y extraccion incremental sin regresiones.
+
+El cierre es documental y operativo. No ejecuta limpieza de ramas, no elimina refs, no hace merge adicional, no hace rebase y no cambia comportamiento runtime.
+
+## Base de cierre
+
+| Dato | Valor |
+|---|---|
+| Fecha de cierre | 2026-06-09 |
+| Base usada | `origin/main` |
+| SHA base al crear rama de cierre | `fd62e8b` |
+| Rama de cierre | `chore/QUIVER-01-final-closure` |
+| Estado local relevante | `pr.md` sigue untracked y queda fuera del cierre |
+
+## Estado por slice
+
+| Slice | Estado | Evidencia |
+|---|---|---|
+| `01-slice` | Cerrado | Snapshot inicial de ramas documentado |
+| `02-slice` | Cerrado | Baseline de comportamiento documentado |
+| `03-slice` | Cerrado | Contrato de no regresion documentado |
+| `04-slice` | Cerrado | Matriz de extraccion documentada |
+| `05-slice` | Mergeado | Commit `96b9fad` contenido en `origin/main` |
+| `06-slice` | Mergeado | PR `#110`; commit `28e6e8b` contenido en `origin/main` |
+| `07-slice` | Mergeado | PR `#111`; commit `564b37d` contenido en `origin/main` |
+| `08-slice` | Mergeado | PR `#112`; commit `dde1347` contenido en `origin/main` |
+
+## Cambios integrados
+
+- Parser y command registry extraidos de forma incremental.
+- Wrapper read-only `changelog` integrado con help, docs generadas y tests contractuales.
+- Gate de docs/tests/evidencia formalizado para futuros cambios de CLI.
+- Plan de limpieza controlada de ramas documentado con snapshot remoto fresco.
+
+## Funcionalidad existente
+
+- No se quito funcionalidad existente.
+- No se eliminaron aliases.
+- No se modifico `package.json` ni versionado dentro del cierre.
+- `status` top-level sigue sin habilitarse para evitar colision con `ai status` y `spec status`.
+- Las acciones destructivas sobre ramas siguen bloqueadas hasta aprobacion explicita.
+
+## Validaciones y evidencia consolidada
+
+| Area | Evidencia |
+|---|---|
+| Parser/registry | Tests contractuales del `05-slice` ejecutados antes de merge |
+| `changelog` | `node --test tests/commands/parser-contract.test.js tests/commands/cli-contract.test.js` paso con `17/17` |
+| Docs generadas | `npm run docs:commands:check` paso antes del PR `#110` |
+| Changelog | `npm run changelog:check` paso antes del PR `#110` |
+| Limpieza de ramas | Solo snapshot y propuesta; no se ejecuto delete/prune |
+
+## Decisiones finales
+
+- `origin/main` queda como base segura para ramas nuevas.
+- `main` local no debe usarse como base mientras siga divergida.
+- `feature/QUIVER-46-49-cli-modernization` sigue siendo fuente historica y tiene manejo separado por PR abierto detectado en el `08-slice`.
+- Ramas con `ahead=0` no quedan automaticamente autorizadas para eliminar.
+- Cualquier limpieza local/remota requiere aprobacion posterior por rama o grupo claramente listado.
+
+## Acciones no ejecutadas
+
+No se ejecuto ninguno de estos comandos:
+
+```bash
+git branch -d <branch>
+git branch -D <branch>
+git push origin --delete <branch>
+git remote prune origin
+git merge
+git rebase
+```
+
+## Pendientes o riesgos residuales
+
+- `pr.md` queda local sin trackear como archivo auxiliar de PR; no fue eliminado.
+- La limpieza de ramas sigue pendiente de aprobacion explicita.
+- El estado de PRs abiertos y ramas remotas puede cambiar; antes de limpiar, repetir `git fetch origin`, `git ls-remote --heads origin` y `gh pr list`.
+- Politicas externas de proteccion de ramas no son completamente visibles desde Git local.
+
+## Recomendacion
+
+Cerrar esta spec con un PR documental. Despues del merge, decidir por separado si se autoriza limpieza de ramas por grupo, empezando por `git remote prune origin --dry-run` y sin borrar nada hasta nueva aprobacion.