create-quiver 0.15.3 → 0.16.0

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

@@ -0,0 +1,36 @@
+{
+  "slice_id": "06-slice",
+  "slice_number": "06",
+  "title": "Extraccion de comandos y wrappers",
+  "objective": "Planificar extracciones futuras de comandos/wrappers sin perder comportamiento existente.",
+  "problem": "Evita incorporar wrappers desde ramas viejas sin explicar que comando cambian y por que mejora.",
+  "value_outcome": "Plan por comando con matriz antes/despues, archivos candidatos, exclusiones y validaciones.",
+  "scope": {
+    "includes": ["Comandos candidatos", "Estado actual", "Cambio propuesto", "Motivo", "Mejora verificable", "Validacion", "Rollback"],
+    "excludes": ["Implementar comandos", "Eliminar aliases", "Cambiar parser global sin 05-slice", "Modificar package/version"]
+  },
+  "actors": ["Tech Lead", "Usuarios CLI", "Reviewer", "Implementador futuro"],
+  "preconditions": ["Baseline aprobado", "Contrato aprobado", "Matriz de extraccion aprobada"],
+  "inputs": ["Matriz de extraccion", "Baseline de comandos", "Diffs de ramas fuente"],
+  "outputs": ["Backlog de comandos con planes independientes"],
+  "workflow": [
+    {"step": 1, "name": "Seleccionar comando", "description": "Elegir un comando candidato."},
+    {"step": 2, "name": "Registrar antes/despues", "description": "Documentar comportamiento actual y cambio propuesto."},
+    {"step": 3, "name": "Definir validacion", "description": "Definir evidencia esperada y rollback."},
+    {"step": 4, "name": "Repetir", "description": "Repetir por comando sin mezclar responsabilidades."}
+  ],
+  "business_rules": ["Comando no cambia sin antes/despues", "Mejora verificable", "JSON/exit code/side effect requiere aprobacion", "No eliminar aliases/flags sin aprobacion"],
+  "validations": ["Matriz completa por comando", "Motivo y mejora", "Rollback", "Sin scope creep"],
+  "error_cases": ["Comando nuevo colisiona", "Comando existente con otro comportamiento", "Dependencia de parser"],
+  "acceptance_criteria": ["Plan individual por comando", "Sin perdida funcional sin aprobacion", "Salidas justificadas", "Package/version fuera", "Rollback definido"],
+  "dependencies": {
+    "functional": ["Baseline", "Matriz de extraccion"],
+    "technical": [],
+    "external": [],
+    "depends_on_slices": ["04-slice"]
+  },
+  "implementation_order": 6,
+  "slicing_rationale": "Separar comandos evita fixes parciales y reduce blast radius.",
+  "risks": ["Wrappers duplican comandos existentes o cambian UX"],
+  "open_questions": ["Orden exacto de comandos segun valor y riesgo"]
+}

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

@@ -0,0 +1,107 @@
+# 06-slice - Extraccion de comandos y wrappers
+
+## 1. Nombre del slice
+
+Extraccion de comandos y wrappers.
+
+## 2. Objetivo del slice
+
+Planificar extracciones futuras de comandos/wrappers sin perder comportamiento existente.
+
+## 3. Problema puntual que resuelve
+
+Evita incorporar wrappers desde ramas viejas sin explicar que comando cambian y por que mejora.
+
+## 4. Valor observable que entrega
+
+Plan por comando con matriz antes/despues, archivos candidatos, exclusiones y validaciones.
+
+## 5. Alcance especifico
+
+Planificacion de comandos como `status`, `changelog`, `doctor`, `handoff`, `slice`, `init` y otros candidatos.
+
+## 6. Que incluye
+
+- Lista de comandos candidatos.
+- Estado actual de cada comando.
+- Cambio propuesto.
+- Motivo y mejora verificable.
+- Validacion por comando.
+- Rollback por comando.
+
+## 7. Que no incluye
+
+- Implementar comandos.
+- Eliminar aliases.
+- Cambiar parser global sin `05-slice`.
+- Modificar package/version.
+
+## 8. Actores involucrados
+
+Tech Lead, usuarios CLI, reviewer e implementador futuro.
+
+## 9. Precondiciones
+
+Baseline, contrato y matriz de extraccion aprobados.
+
+## 10. Entradas necesarias
+
+Matriz de extraccion, baseline de comandos y diffs de ramas fuente.
+
+## 11. Flujo operativo paso a paso
+
+1. Seleccionar un comando candidato.
+2. Registrar comportamiento actual.
+3. Describir cambio propuesto y mejora.
+4. Definir archivos candidatos y excluidos.
+5. Definir validaciones.
+6. Definir rollback.
+7. Repetir por comando sin mezclar responsabilidades.
+
+## 12. Salidas esperadas
+
+Backlog de comandos con planes implementables independientes.
+
+## 13. Reglas de negocio aplicables
+
+- Un comando no puede cambiar sin antes/despues.
+- Mejoras deben ser verificables.
+- Si cambia JSON, exit code o side effect, requiere aprobacion explicita.
+- No se eliminan aliases ni flags sin aprobacion.
+
+## 14. Validaciones
+
+- Cada comando tiene matriz completa.
+- Cada cambio tiene motivo y mejora.
+- Cada comando tiene rollback.
+- No hay scope creep entre comandos.
+
+## 15. Manejo de errores o edge cases
+
+- Si el comando no existe hoy, documentar como nuevo y validar que no colisiona.
+- Si ya existe con otro comportamiento, requerir compatibilidad o aprobacion.
+- Si depende de parser, bloquear hasta `05-slice`.
+
+## 16. Criterios de aceptacion
+
+- Cada comando candidato tiene plan individual.
+- Ningun comportamiento existente desaparece sin aprobacion.
+- Cambios de salida estan justificados y validados.
+- Package/version fuera del alcance.
+- Rollback por comando definido.
+
+## 17. Dependencias tecnicas, funcionales o externas
+
+Baseline y matriz de extraccion.
+
+## 18. Depende de slices
+
+`04-slice`; puede depender de `05-slice` si el comando requiere parser nuevo.
+
+## 19. Riesgos / decisiones abiertas
+
+Algunos wrappers pueden duplicar comandos existentes o cambiar UX.
+
+## 20. Pendientes / preguntas abiertas
+
+Definir orden exacto de comandos segun valor y riesgo.

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.