create-quiver 0.15.4 → 0.17.0

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

@@ -0,0 +1,67 @@
+# CLOSURE_BRIEF - 06-slice
+
+## Resultado
+
+Completado como plan de comandos/wrappers y ejecutado parcialmente con un wrapper read-only de bajo riesgo: `changelog`.
+
+## Evidencia
+
+Plan por comando/namespace:
+
+| Comando/namespace | Estado en `origin/main` | Decision |
+|---|---|---|
+| `slice ...` | Ya existe como namespace canonico en help | No re-agregar; comparar gaps antes de tocar |
+| `handoff ...` | Ya existe como namespace canonico en help | No re-agregar; comparar gaps antes de tocar |
+| `evidence list/show` | Ya existe en help | No importar version vieja sin diff contractual |
+| `doctor` | Ya existe | Solo mejoras puntuales con antes/despues |
+| `init` | Ya existe | Solo mejoras puntuales con side effects controlados |
+| `analyze` | Ya existe y escribe docs/.quiver | Requiere sandbox/dry-run antes de cambios |
+| `status` top-level | No aparece como top-level en baseline; existe `ai status` y `spec status` | Candidato nuevo solo si no colisiona y mejora es verificable |
+| `changelog` top-level | No aparece como top-level en baseline; hay scripts/checks | Implementado como wrapper read-only separado, sin package/version |
+| `ai` subcommands | Amplios y provider-aware | Separar por subcomando; depende de baseline adicional |
+
+Implementacion ejecutada:
+
+| Comando | Antes | Despues | Motivo | Mejora | Validacion esperada | Rollback |
+|---|---|---|---|---|---|---|
+| `changelog` | `unsupported command: changelog`, exit `1` | Muestra ultimas entradas parseables de `CHANGELOG.md`; `--json` emite `schema_version: 1`, `source`, `missing`, `entries`; exit `0` | Recuperar wrapper util sin importar la modernizacion completa ni tocar versionado | Consulta read-only del changelog local con salida humana y JSON estable | `node --test tests/commands/parser-contract.test.js tests/commands/cli-contract.test.js`; `node bin/create-quiver.js changelog`; `node bin/create-quiver.js changelog --json`; confirmar que `status --json` sigue unsupported | Remover `src/create-quiver/commands/changelog.js`, quitar `changelog` del registry, help, dispatch y tests asociados |
+
+Reglas para cada implementacion futura:
+
+- Un comando por unidad de cambio salvo dependencia justificada.
+- Antes/despues obligatorio.
+- Si cambia stdout/stderr, JSON, exit code o side effect, requiere aprobacion explicita.
+- No tocar package/version.
+
+## Cambios de comportamiento
+
+- `changelog` top-level pasa de unsupported a comando soportado.
+- No se quita funcionalidad existente.
+- `status` top-level sigue sin habilitarse para evitar colision con `ai status` y `spec status`.
+- No cambia `package.json`, versionado, aliases ni comandos con side effects.
+
+## Regresiones detectadas
+
+Ninguna detectada.
+
+## Validacion ejecutada
+
+| Comando | Resultado |
+|---|---|
+| `node --check src/create-quiver/index.js && node --check src/create-quiver/commands/changelog.js && node --check src/create-quiver/lib/cli/command-registry.js && node --check tests/commands/parser-contract.test.js && node --check tests/commands/cli-contract.test.js` | OK |
+| `node --test tests/commands/parser-contract.test.js tests/commands/cli-contract.test.js` | OK, 17 tests, 17 pass |
+| `npm run docs:commands:write` | OK, sincronizo `docs/reference/commands.md` |
+| `npm run docs:commands:check` | OK, referencia de comandos sincronizada |
+| `node bin/create-quiver.js changelog` | OK, salida humana con entradas de `CHANGELOG.md` |
+| `node bin/create-quiver.js changelog --json` | OK, `schema_version: 1`, `missing: false`, `entries` parseable |
+| `node bin/create-quiver.js status --json` | OK, sigue unsupported con exit `1` |
+
+## Riesgos residuales
+
+- `status` requiere decision de producto para evitar colision de UX.
+- `changelog` validado localmente antes de merge.
+- Comandos write-capable necesitan baseline adicional en sandbox antes de implementarse.
+
+## Decision sobre ramas
+
+Mantener ramas fuente hasta cerrar comparacion por comando. No importar wrappers en bloque.

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

@@ -0,0 +1,39 @@
+# EXECUTION_BRIEF - 06-slice
+
+## Objetivo
+
+Planificar extraccion de comandos/wrappers por unidad independiente.
+
+## Base segura
+
+`origin/main` con baseline, contrato y matriz aprobados.
+
+## Archivos candidatos
+
+Archivos de comando especificos autorizados por la matriz.
+
+## Archivos excluidos
+
+Parser global salvo dependencia aprobada, package files y version/release files.
+
+## Funcionalidad existente afectada
+
+Solo comandos listados explicitamente en la matriz del slice.
+
+## Matriz antes/despues
+
+Obligatoria por comando: flags, aliases, help, JSON, exit code, stdout/stderr, side effects.
+
+## Validaciones
+
+- Un comando por unidad de implementacion futura.
+- Mejora verificable.
+- No se pierden aliases/flags.
+
+## Riesgos
+
+Duplicar comandos existentes o cambiar UX sin evidencia.
+
+## Rollback
+
+Revertir comando afectado y validar baseline de ese comando.

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

@@ -0,0 +1,36 @@
+{
+  "slice_id": "07-slice",
+  "slice_number": "07",
+  "title": "Docs, tests y evidencia",
+  "objective": "Planificar como validar y documentar cambios futuros para que CLI, docs y tests no diverjan.",
+  "problem": "Evita que tests nuevos den falsa seguridad o que docs generadas no coincidan con la CLI real.",
+  "value_outcome": "Contrato de evidencia para futuras implementaciones: pruebas minimas, docs afectadas y criterios de cierre.",
+  "scope": {
+    "includes": ["Mapa de cobertura", "Regla de cobertura equivalente", "Gate CLI/docs", "Evidencia minima", "Validaciones pendientes"],
+    "excludes": ["Ejecutar tests", "Modificar tests", "Regenerar docs", "Cambiar codigo"]
+  },
+  "actors": ["Reviewer", "Implementador futuro", "Maintainer", "Usuarios CLI"],
+  "preconditions": ["Contrato aprobado", "Planes de extraccion definidos"],
+  "inputs": ["Baseline", "Matriz de comandos", "Tests existentes", "Docs actuales"],
+  "outputs": ["Checklist de validacion", "Contrato de evidencia"],
+  "workflow": [
+    {"step": 1, "name": "Mapear cobertura", "description": "Relacionar tests actuales con comportamiento."},
+    {"step": 2, "name": "Mapear docs", "description": "Identificar docs que describen comandos."},
+    {"step": 3, "name": "Definir evidencia", "description": "Crear checklist por tipo de cambio."},
+    {"step": 4, "name": "Definir cierre", "description": "Definir riesgos residuales y validaciones pendientes."}
+  ],
+  "business_rules": ["No eliminar cobertura sin reemplazo", "Docs reflejan CLI real", "Pendiente no es exito", "JSON/exit code requiere prueba especifica"],
+  "validations": ["Evidencia minima por cambio", "Gate CLI/docs", "Cobertura equivalente", "Formato de riesgos"],
+  "error_cases": ["Validacion no ejecutable", "Docs generadas sin proceso", "Test viejo borrado"],
+  "acceptance_criteria": ["Checklist de evidencia", "Gate CLI/docs", "Regla de cobertura", "Pendientes separados de exitos", "Riesgos residuales explicitos"],
+  "dependencies": {
+    "functional": ["Baseline", "Contrato", "Planes de extraccion"],
+    "technical": [],
+    "external": [],
+    "depends_on_slices": ["03-slice", "05-slice", "06-slice"]
+  },
+  "implementation_order": 7,
+  "slicing_rationale": "La evidencia evita que extracciones parciales se cierren sin pruebas suficientes.",
+  "risks": ["Proceso de docs generadas no documentado"],
+  "open_questions": ["Evidencia minima manual, automatizada o ambas?"]
+}

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.