create-quiver 0.15.4 → 0.16.0

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

@@ -0,0 +1,88 @@
+# CLOSURE_BRIEF - 02-slice
+
+## Resultado
+
+Completado como baseline inicial obligatorio.
+
+## Evidencia
+
+Baseline ejecutado desde una copia temporal de `origin/main`, no desde `main` local.
+
+Base: `origin/main` @ `7bc234bbf96fb17d8c44863fac25430b59fc832e`.
+
+Package de base:
+
+| Campo | Valor |
+|---|---|
+| Package | `create-quiver` |
+| Version CLI | `0.15.3` |
+| Binarios | `create-quiver`, `quiver` -> `bin/create-quiver.js` |
+| Dependencias runtime | `@clack/prompts`, `zod` |
+
+Comandos seguros ejecutados:
+
+| Comando | Resultado | Exit code | Contrato observado |
+|---|---|---:|---|
+| `node bin/create-quiver.js --help` | Imprime referencia completa | 0 | stdout humano, sin writes |
+| `node bin/create-quiver.js help` | Igual a `--help` | 0 | alias compatible |
+| `node bin/create-quiver.js version` | Reporte humano Quiver CLI `0.15.3` | 0 | stdout humano con runtime/OS/project |
+| `node bin/create-quiver.js version --json` | JSON parseable | 0 | schema `version_schema_version: 1` |
+| `node bin/create-quiver.js __unknown__` | Error localizado + hint de help/init/update | 1 | stderr/stdout de error via wrapper, exit no cero |
+
+Baseline ampliado ejecutado desde copia temporal de `origin/main`:
+
+| Comando | Resultado | Exit code | Contrato observado |
+|---|---|---:|---|
+| `node bin/create-quiver.js config language show --json` | JSON parseable con `schema_version`, `language`, `source`, `requested_source`, `requested_language`, `warnings` | 0 | Read-only |
+| `node bin/create-quiver.js slice` | Error de subcomando faltante | 1 | Subcomandos soportados: `start`, `check`, `pr`, `scope`, `cleanup`, `refresh-active` |
+| `node bin/create-quiver.js slice check` | Error de argumento faltante | 1 | Requiere path `slice.json` |
+| `node bin/create-quiver.js slice start` | Error de argumento faltante | 1 | Requiere path `slice.json` |
+| `node bin/create-quiver.js handoff` | Error de subcomando faltante | 1 | Subcomandos soportados: `check`, `new` |
+| `node bin/create-quiver.js handoff check` | Error de argumento faltante | 1 | Requiere handoff o brief path |
+| `node bin/create-quiver.js evidence list --json` | JSON parseable `{ "evidence": [] }` | 0 | Read-only cuando no hay evidencia local |
+| `node bin/create-quiver.js evidence show missing --json` | Error de evidencia no encontrada | 1 | No crea archivos |
+| `node bin/create-quiver.js doctor --dry-run` | Error porque el proyecto temporal no esta inicializado por Quiver | 1 | No aplica fixes |
+| `node bin/create-quiver.js init --name Baseline --dir <tmp>/generated --dry-run` | Plan de init con `Planned create: 26`, `Planned update: 0` | 0 | Dry-run, sin escribir en el repo |
+| `node bin/create-quiver.js ai status --json` | Salida humana: `Status: no active run` | 0 | La flag `--json` no emitio JSON en este estado; requiere contrato especifico antes de cambios |
+| `node bin/create-quiver.js spec status specs/missing` | Error `missing SPEC.md` | 1 | No crea archivos |
+
+Superficie CLI observada en help de `origin/main`:
+
+| Categoria | Comandos / namespaces |
+|---|---|
+| Bootstrap/contexto | `init`, `analyze`, `doctor`, `flow`, `dashboard`, `version`, `config language show|set`, `prepare`, `migrate` |
+| Planificacion | `plan`, `graph`, `next` |
+| AI lifecycle | `ai run`, `ai active-slice`, `ai status`, `ai resume`, `ai onboard`, `ai prepare-context`, `ai agent`, `ai models`, `ai plan`, `ai revise`, `ai repair-plan`, `ai review-plan`, `ai approve`, `ai approvals`, `ai prompt-slice`, `ai execute-slice`, `ai execute-plan`, `ai doctor`, `ai pr` |
+| Inspeccion/export | `ai inspect`, `ai export`, `ai specs list`, `ai slices list`, `ai trace report` |
+| Specs/slices | `spec create|start|status|validate|close`, `slice start|check|pr|scope|cleanup|refresh-active`, legacy `start-slice`, `check-slice`, `check-pr`, `check-scope`, `cleanup-slice`, `refresh-active-slices` |
+| Handoffs | `handoff check|new`, legacy `check-handoff`, `new-handoff` |
+| Evidencia/demos | `evidence run|list|show`, `demo create spec-viewer` |
+| Compatibilidad | `--name`, `--version`, `-V`, `--help`, `help`, alias local `quiver` |
+
+Clasificacion de side effects:
+
+| Tipo | Comandos |
+|---|---|
+| Read-only observado | `help`, `--help`, `version`, `version --json`, unknown command |
+| Read-only esperado, pendiente de validar individualmente | `flow`, `dashboard`, `plan`, `graph`, `next`, `config language show`, `ai inspect`, `ai export`, `ai specs list`, `ai slices list`, `ai trace report`, `ai models list` |
+| Write-capable; requiere `--dry-run` o sandbox antes de ejecutar | `init`, `analyze`, `migrate`, `config language set`, `start-slice`, `cleanup-slice`, `refresh-active-slices`, `spec create/start/close`, `evidence run`, `demo create`, `ai run create/close`, `ai plan/revise/repair-plan/approve/execute-slice/execute-plan/pr`, `ai agent set/repair` |
+| High-risk behavior | comandos con provider externo, GitHub, worktrees, commits, PRs o escritura de docs/evidencia |
+
+## Cambios de comportamiento
+
+Ninguno. La copia temporal de `origin/main` fue usada solo para observacion y eliminada al finalizar.
+
+## Regresiones detectadas
+
+Ninguna; no se modifico codigo.
+
+## Riesgos residuales
+
+- Baseline completo por comando queda pendiente para comandos write-capable y comandos con side effects.
+- La version del working tree local es `0.15.4`, pero la base contractual `origin/main` es `0.15.3`.
+- `ai status --json` no produjo JSON en el baseline ampliado; cualquier cambio futuro debe preservar o corregir este contrato solo con decision explicita.
+- No se validaron todos los JSON modes posibles; quedaron cubiertos `version --json`, `config language show --json` y `evidence list --json`.
+
+## Decision sobre ramas
+
+Ninguna decision de limpieza. Este baseline bloquea cualquier extraccion que afecte comandos no cubiertos.

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

@@ -0,0 +1,40 @@
+# EXECUTION_BRIEF - 02-slice
+
+## Objetivo
+
+Crear baseline de comportamiento actual antes de cualquier extraccion tecnica.
+
+## Base segura
+
+Usar `origin/main` con SHA registrado desde `01-slice`.
+
+## Archivos candidatos
+
+Documentos de baseline o evidencia del slice.
+
+## Archivos excluidos
+
+Codigo fuente, package files y tests existentes.
+
+## Funcionalidad existente afectada
+
+Ninguna. Este slice observa y documenta.
+
+## Matriz antes/despues
+
+Antes: comportamiento actual de `origin/main`.
+Despues: no aplica, porque no se modifica comportamiento.
+
+## Validaciones
+
+- Comandos, aliases y flags inventariados.
+- `--help`, `--json`, exit codes, stdout/stderr y side effects registrados.
+- Gaps explicitos.
+
+## Riesgos
+
+Baseline incompleto puede permitir regresiones futuras.
+
+## Rollback
+
+Descartar baseline incompleto y regenerar con alcance corregido.

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

@@ -0,0 +1,36 @@
+{
+  "slice_id": "03-slice",
+  "slice_number": "03",
+  "title": "Contrato de no regresion",
+  "objective": "Definir reglas verificables para modificar o extraer funcionalidad sin quitar comportamiento existente.",
+  "problem": "Evita que cambios futuros se aprueben por intencion general en vez de evidencia contra baseline.",
+  "value_outcome": "Contrato que obliga matriz antes/despues, aprobacion explicita de cambios incompatibles y rollback por slice.",
+  "scope": {
+    "includes": ["Definicion de funcionalidad", "Matriz antes/despues", "Categorias de compatibilidad", "Reglas JSON/exit codes/streams/aliases/side effects", "Rollback"],
+    "excludes": ["Cambios de comandos", "Ejecucion de tests", "Implementacion de parser"]
+  },
+  "actors": ["Tech Lead", "Reviewer", "Maintainer", "Implementador futuro"],
+  "preconditions": ["02-slice aprobado como baseline suficiente"],
+  "inputs": ["Baseline", "Criterios aprobados", "Riesgos del plan"],
+  "outputs": ["Contrato de no regresion"],
+  "workflow": [
+    {"step": 1, "name": "Definir funcionalidad", "description": "Formalizar que comportamientos cuentan como existentes."},
+    {"step": 2, "name": "Definir matriz", "description": "Crear formato antes/despues obligatorio."},
+    {"step": 3, "name": "Definir compatibilidad", "description": "Separar cambios compatibles, incompatibles y aprobados."},
+    {"step": 4, "name": "Definir rollback", "description": "Exigir rollback y evidencia minima."}
+  ],
+  "business_rules": ["Nada inventariado desaparece sin aprobacion", "Todo cambio de comando explica antes/despues", "JSON/exit codes/side effects requieren validacion", "No mezclar refactor con bump de version"],
+  "validations": ["Contrato cubre comandos/API/scripts/docs/tests", "Criterios de cierre definidos", "Reglas verificables"],
+  "error_cases": ["Mejora no verificable", "Regresion intencional sin aprobacion", "Falta baseline"],
+  "acceptance_criteria": ["Definicion formal de funcionalidad", "Formato de matriz antes/despues", "Regla anti-fix parcial", "Rollback requerido", "Cambios incompatibles requieren aprobacion"],
+  "dependencies": {
+    "functional": ["Baseline"],
+    "technical": [],
+    "external": [],
+    "depends_on_slices": ["02-slice"]
+  },
+  "implementation_order": 3,
+  "slicing_rationale": "El contrato permite que slices tecnicos sean revisables y no regresivos.",
+  "risks": ["Contrato demasiado laxo"],
+  "open_questions": ["Cambios menores de texto humano requieren aprobacion explicita?"]
+}

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

@@ -0,0 +1,103 @@
+# 03-slice - Contrato de no regresion
+
+## 1. Nombre del slice
+
+Contrato de no regresion.
+
+## 2. Objetivo del slice
+
+Definir reglas verificables para modificar o extraer funcionalidad sin quitar comportamiento existente.
+
+## 3. Problema puntual que resuelve
+
+Evita que cambios futuros se aprueben por intencion general en vez de evidencia contra baseline.
+
+## 4. Valor observable que entrega
+
+Un contrato que obliga matriz antes/despues, aprobacion explicita de cambios incompatibles y rollback por slice.
+
+## 5. Alcance especifico
+
+Formalizar reglas de compatibilidad y criterios de cierre.
+
+## 6. Que incluye
+
+- Definicion de funcionalidad existente.
+- Matriz antes/despues obligatoria.
+- Categorias de cambio compatible, incompatible y aprobado.
+- Reglas para JSON, exit codes, streams, aliases y side effects.
+- Requisitos de rollback.
+
+## 7. Que no incluye
+
+- Cambios de comandos.
+- Ejecucion de tests.
+- Implementacion de parser.
+
+## 8. Actores involucrados
+
+Tech Lead, reviewer, maintainer e implementador futuro.
+
+## 9. Precondiciones
+
+`02-slice` debe existir o estar aprobado como baseline suficiente.
+
+## 10. Entradas necesarias
+
+Baseline, criterios aprobados y riesgos del plan.
+
+## 11. Flujo operativo paso a paso
+
+1. Definir funcionalidad existente en terminos verificables.
+2. Definir matriz antes/despues obligatoria.
+3. Definir criterios para cambios compatibles.
+4. Definir aprobacion para cambios incompatibles.
+5. Definir rollback y evidencia minima.
+6. Definir condiciones anti-fix parcial.
+
+## 12. Salidas esperadas
+
+Contrato de no regresion reusable por todos los slices tecnicos futuros.
+
+## 13. Reglas de negocio aplicables
+
+- Ningun comportamiento inventariado puede desaparecer sin aprobacion.
+- Todo cambio de comando debe explicar que hacia antes y que mejora.
+- `--json`, exit codes y side effects requieren validacion explicita.
+- Refactor y bump de version no se mezclan.
+
+## 14. Validaciones
+
+- El contrato cubre comandos, API interna, scripts, docs y tests.
+- Hay criterios para cierre completo, parcial, bloqueado y descartado.
+- Cada regla es verificable.
+
+## 15. Manejo de errores o edge cases
+
+- Si la mejora no es verificable, no se aprueba como mejora.
+- Si una regresion es intencional, requiere aprobacion explicita.
+- Si falta baseline para un comando, el cambio queda bloqueado.
+
+## 16. Criterios de aceptacion
+
+- Existe definicion formal de funcionalidad existente.
+- Existe formato obligatorio de matriz antes/despues.
+- Existe regla anti-fix parcial.
+- Existe requerimiento de rollback por slice implementable.
+- Cambios incompatibles requieren aprobacion explicita.
+
+## 17. Dependencias tecnicas, funcionales o externas
+
+Baseline del `02-slice`.
+
+## 18. Depende de slices
+
+`02-slice`.
+
+## 19. Riesgos / decisiones abiertas
+
+El contrato puede ser demasiado laxo si no enumera outputs y side effects.
+
+## 20. Pendientes / preguntas abiertas
+
+Definir si cambios de texto humano menor requieren aprobacion o solo evidencia.

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

@@ -0,0 +1,54 @@
+# CLOSURE_BRIEF - 03-slice
+
+## Resultado
+
+Completado.
+
+## Evidencia
+
+Contrato de no regresion fijado a partir del baseline inicial.
+
+Funcionalidad existente protegida:
+
+- Comandos y namespaces visibles en help.
+- Aliases: `help`, `--help`, `--version`, `-V`, `quiver`, shortcuts legacy de slice/handoff.
+- Flags globales y por comando documentados en help.
+- Salidas humanas y JSON conocidas.
+- Exit codes observados para exito y error basico.
+- Stdout/stderr y mensajes de error/hints.
+- Side effects: archivos generados, worktrees, evidencia, docs, config y PRs.
+- Scripts npm y binarios declarados.
+- Templates y docs generadas cuando se modifiquen en slices futuros.
+
+Regla antes/despues obligatoria para comandos:
+
+| Campo requerido | Descripcion |
+|---|---|
+| Comando/namespace | Comando exacto afectado |
+| Antes | Comportamiento actual desde baseline |
+| Despues | Comportamiento propuesto |
+| Motivo | Por que cambia |
+| Mejora verificable | Evidencia objetiva esperada |
+| Compatibilidad | Aliases, flags, outputs, JSON, exit codes y side effects preservados o cambio aprobado |
+| Validacion | Comando/test/evidencia requerida |
+| Rollback | Como volver al comportamiento anterior |
+
+Regla anti-fix parcial:
+
+Un slice tecnico no puede cerrarse como completo si falta baseline del comando afectado, cambia outputs sin matriz antes/despues, elimina comportamiento sin aprobacion, mezcla refactor con version/package o deja regresiones sin decision explicita.
+
+## Cambios de comportamiento
+
+Ninguno. Solo se formalizo el contrato documental.
+
+## Regresiones detectadas
+
+Ninguna.
+
+## Riesgos residuales
+
+Comandos no cubiertos por baseline completo bloquean extracciones que los afecten.
+
+## Decision sobre ramas
+
+Ninguna decision de limpieza.

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

@@ -0,0 +1,39 @@
+# EXECUTION_BRIEF - 03-slice
+
+## Objetivo
+
+Crear el contrato de no regresion usado por todos los slices tecnicos futuros.
+
+## Base segura
+
+Usar baseline aprobado del `02-slice`.
+
+## Archivos candidatos
+
+Documentos del contrato dentro del spec.
+
+## Archivos excluidos
+
+Codigo fuente, tests y package files.
+
+## Funcionalidad existente afectada
+
+Ninguna. Este slice define reglas.
+
+## Matriz antes/despues
+
+No aplica a comportamiento. Debe definir el formato obligatorio para slices futuros.
+
+## Validaciones
+
+- Reglas verificables.
+- Cambios incompatibles requieren aprobacion.
+- Rollback obligatorio para implementacion futura.
+
+## Riesgos
+
+Contrato incompleto permite fixes parciales.
+
+## Rollback
+
+Revertir/ajustar el contrato documental antes de permitir implementacion.

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

@@ -0,0 +1,36 @@
+{
+  "slice_id": "04-slice",
+  "slice_number": "04",
+  "title": "Matriz de extraccion por rama",
+  "objective": "Determinar que partes de ramas conflictivas se deben extraer como codigo, concepto, rehacer o descartar.",
+  "problem": "Evita merges parciales improvisados y cherry-picks grandes desde ramas viejas.",
+  "value_outcome": "Matriz de decisiones por rama, archivo, comando o concepto con riesgo y proxima accion.",
+  "scope": {
+    "includes": ["Ramas candidatas", "Cambios por modulo", "Clasificacion de hallazgos", "Riesgo textual/semantico/contrato", "Dependencias", "Exclusiones"],
+    "excludes": ["Aplicar cambios", "Resolver conflictos", "Cherry-pick", "Modificar package/version"]
+  },
+  "actors": ["Tech Lead", "Reviewer", "Implementador futuro"],
+  "preconditions": ["03-slice aprobado", "Baseline disponible"],
+  "inputs": ["Diffs", "Logs", "merge-tree", "Baseline", "Contrato de no regresion"],
+  "outputs": ["Matriz de extraccion", "Backlog de slices tecnicos"],
+  "workflow": [
+    {"step": 1, "name": "Seleccionar ramas", "description": "Elegir ramas candidatas para extraccion."},
+    {"step": 2, "name": "Agrupar cambios", "description": "Agrupar por modulo o comportamiento."},
+    {"step": 3, "name": "Clasificar hallazgos", "description": "Marcar codigo, concepto, rehacer o descartar."},
+    {"step": 4, "name": "Ordenar extraccion", "description": "Proponer orden con riesgos y dependencias."}
+  ],
+  "business_rules": ["No mergear rama completa si mezcla riesgos", "No cherry-pick grande sin separar", "Codigo viejo puede ser concepto", "Sin mejora verificable se descarta"],
+  "validations": ["Cada hallazgo clasificado", "Riesgo tipificado", "Exclusiones justificadas", "Referencia a baseline"],
+  "error_cases": ["Valor historico con codigo obsoleto", "Archivo duplicado en origin/main", "Evidencia faltante"],
+  "acceptance_criteria": ["QUIVER-46-49 no queda como merge completo", "Cada candidato tiene decision", "Package/version fuera", "No hay utilidad sin evidencia", "Matriz habilita slices pequenos"],
+  "dependencies": {
+    "functional": ["Contrato de no regresion"],
+    "technical": ["Git read-only"],
+    "external": [],
+    "depends_on_slices": ["03-slice"]
+  },
+  "implementation_order": 4,
+  "slicing_rationale": "La matriz evita extraccion oportunista y reduce riesgo de fixes parciales.",
+  "risks": ["Clasificacion requiere conocimiento funcional"],
+  "open_questions": ["Revisar todas las ramas conflictivas o empezar por QUIVER-46-49?"]
+}

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

@@ -0,0 +1,107 @@
+# 04-slice - Matriz de extraccion por rama
+
+## 1. Nombre del slice
+
+Matriz de extraccion por rama.
+
+## 2. Objetivo del slice
+
+Determinar que partes de ramas conflictivas se deben extraer como codigo, concepto, rehacer o descartar.
+
+## 3. Problema puntual que resuelve
+
+Evita merges parciales improvisados y cherry-picks grandes desde ramas viejas.
+
+## 4. Valor observable que entrega
+
+Una matriz de decisiones por rama, archivo, comando o concepto con riesgo y proxima accion.
+
+## 5. Alcance especifico
+
+Analisis documental de ramas candidatas, especialmente `feature/QUIVER-46-49-cli-modernization`.
+
+## 6. Que incluye
+
+- Lista de ramas candidatas.
+- Cambios por modulo.
+- Clasificacion: extraer codigo, extraer concepto, rehacer, descartar.
+- Riesgo textual, semantico y de contrato.
+- Dependencias entre extracciones.
+- Exclusiones explicitas.
+
+## 7. Que no incluye
+
+- Aplicar cambios.
+- Resolver conflictos.
+- Cherry-pick.
+- Modificar package/version.
+
+## 8. Actores involucrados
+
+Tech Lead, reviewer e implementador futuro.
+
+## 9. Precondiciones
+
+`03-slice` aprobado y baseline disponible.
+
+## 10. Entradas necesarias
+
+Diffs, logs, merge-tree, baseline, contrato de no regresion y analisis de ramas.
+
+## 11. Flujo operativo paso a paso
+
+1. Seleccionar ramas candidatas.
+2. Agrupar cambios por comportamiento o modulo.
+3. Comparar contra baseline.
+4. Clasificar cada hallazgo.
+5. Registrar riesgos y dependencias.
+6. Excluir cambios de version/package salvo slice futuro dedicado.
+7. Proponer orden de extraccion.
+
+## 12. Salidas esperadas
+
+Matriz de extraccion y backlog de slices tecnicos futuros.
+
+## 13. Reglas de negocio aplicables
+
+- No mergear rama completa si mezcla riesgos.
+- No cherry-pick de commits grandes sin separar hallazgos.
+- Codigo viejo puede convertirse en concepto a rehacer.
+- Cambios sin mejora verificable se descartan.
+
+## 14. Validaciones
+
+- Cada hallazgo tiene clasificacion.
+- Cada riesgo indica tipo: textual, semantico o contrato.
+- Cada exclusion tiene motivo.
+- Cada extraccion referencia baseline afectado.
+
+## 15. Manejo de errores o edge cases
+
+- Si una rama tiene valor historico pero codigo obsoleto, clasificar como concepto.
+- Si un archivo ya existe en `origin/main` con contenido distinto, marcar conflicto de contrato.
+- Si falta evidencia, marcar revision manual con dato faltante.
+
+## 16. Criterios de aceptacion
+
+- `feature/QUIVER-46-49-cli-modernization` no queda como merge completo.
+- Cada cambio candidato tiene decision concreta.
+- Package/version queda fuera salvo slice dedicado.
+- No hay hallazgos marcados utiles sin validacion o pregunta abierta.
+- La matriz permite planificar slices tecnicos pequenos.
+
+## 17. Dependencias tecnicas, funcionales o externas
+
+Git read-only y baseline aprobado.
+
+## 18. Depende de slices
+
+`03-slice`.
+
+## 19. Riesgos / decisiones abiertas
+
+La clasificacion puede requerir conocimiento funcional de comandos.
+
+## 20. Pendientes / preguntas abiertas
+
+Definir si se revisaran primero todas las ramas conflictivas o solo `QUIVER-46-49`.

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

@@ -0,0 +1,46 @@
+# CLOSURE_BRIEF - 04-slice
+
+## Resultado
+
+Completado como matriz inicial de extraccion.
+
+## Evidencia
+
+Matriz de decision por fuente:
+
+| Fuente | Decision | Motivo | Siguiente slice |
+|---|---|---|---|
+| `feature/QUIVER-46-49-cli-modernization` | Extraer selectivamente; no merge completo | 176 archivos, conflictos textuales, impacto CLI transversal | `05`, `06`, `07` |
+| `origin/feature/QUIVER-46-49-cli-modernization` | Duplicado remoto de fuente | Misma decision que local | `05`, `06`, `07` |
+| `src/create-quiver/lib/cli/command-registry.js` desde `QUIVER-46-49` | Extraer codigo o rehacer tras comparacion | Valor potencial, bajo numero de archivos, alto impacto contractual | `05` |
+| `src/create-quiver/lib/cli/parser.js` desde `QUIVER-46-49` | Extraer concepto o codigo solo con compatibilidad total | Parser afecta todos los comandos | `05` |
+| Split de `src/create-quiver/commands/ai.js` | Rehacer concepto o extraer por modulo | Riesgo alto por lifecycle/proveedores/outputs | `05`/`06` |
+| Wrappers `status`, `changelog`, `doctor`, `handoff`, `init`, `slice` | Evaluar por comando; no importar en bloque | Algunos namespaces ya existen en `origin/main` | `06` |
+| Docs/specs v46-v49 | Diferir y reconciliar con CLI real | Pueden estar obsoletas frente a PRs #95-#108 | `07` |
+| `package.json`, `package-lock.json`, bump `0.15.4` | Fuera de alcance; decision release separada | No mezclar refactor con version/package | Ninguno en esta spec |
+| `feature/QUIVER-50-01-runtime-minimum-and-package-metadata` | Extraer concepto en slice futuro separado | Toca CI/package/version docs; conflictivo | Fuera de extraccion inicial |
+| `feature/QUIVER-50-03-v50-security-reporting` | Extraer documentacion si sigue faltando | Valor posible en `SECURITY.md`; requiere revision manual | Futuro doc slice |
+| `feature/QUIVER-50-06-contributor-and-architecture-docs` | Extraer concepto/documentacion si vigente | Riesgo de arquitectura desactualizada | Futuro doc slice |
+| `feature/QUIVER-01-ci-matrix-verified` | Revisar manualmente; extraer concepto si falta | Muy vieja, conflictiva, posible duplicacion de `slice-graph` | Futuro analisis |
+| `drafts/v19-v22-orchestration-followups` | Conservar como draft; no merge directo | Documentacion antigua, sin conflicto textual | Limpieza posterior |
+| `backup/QUIVER-52-03-before-squash` | No merge; comparar solo si falta evidencia | Backup pre-squash | `08` posterior |
+| `main` local | No usar como base; no merge | Divergida `ahead 1 / behind 44`, version `0.15.4` | Decision release separada |
+| Ramas revert viejas (`docs/QUIVER-02...`, `feature/QUIVER-03...`, `feature/QUIVER-20...`) | Candidatas a descarte/cierre, no merge | Reverts viejos, conflictivos, valor dudoso | `08` con aprobacion |
+
+## Cambios de comportamiento
+
+Ninguno. La matriz no aplica cambios.
+
+## Regresiones detectadas
+
+Ninguna.
+
+## Riesgos residuales
+
+- La matriz no reemplaza revision de codigo antes de implementar.
+- Ramas remotas requieren verificacion de frescura antes de cerrar/eliminar.
+- Algunos hallazgos quedan como concepto, no codigo listo.
+
+## Decision sobre ramas
+
+No se elimina ni cierra ninguna rama. `feature/QUIVER-46-49-cli-modernization` debe conservarse como fuente hasta cerrar `05`, `06` y `07`.

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

@@ -0,0 +1,39 @@
+# EXECUTION_BRIEF - 04-slice
+
+## Objetivo
+
+Crear matriz de extraccion por rama sin aplicar cambios.
+
+## Base segura
+
+Usar `origin/main` con baseline y contrato aprobados.
+
+## Archivos candidatos
+
+Documentacion de matriz de extraccion.
+
+## Archivos excluidos
+
+Codigo fuente, package files, tests y ramas Git.
+
+## Funcionalidad existente afectada
+
+Ninguna durante este slice. Se identifican funcionalidades que podrian afectarse en slices futuros.
+
+## Matriz antes/despues
+
+Obligatoria para cada candidato que modifique comandos en slices futuros.
+
+## Validaciones
+
+- Cada hallazgo clasificado.
+- Cada riesgo tipificado.
+- Exclusion de package/version registrada.
+
+## Riesgos
+
+Clasificar como codigo algo que deberia rehacerse como concepto.
+
+## Rollback
+
+Revisar o descartar la matriz antes de autorizar implementacion.

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

@@ -0,0 +1,36 @@
+{
+  "slice_id": "05-slice",
+  "slice_number": "05",
+  "title": "Parser y command registry",
+  "objective": "Planificar la recuperacion segura de parser y command registry como cambio transversal de alto riesgo.",
+  "problem": "Evita tratar parser/registry como refactor pequeno cuando afecta la entrada de toda la CLI.",
+  "value_outcome": "Plan tecnico futuro con compatibilidad total contra baseline, archivos candidatos/excluidos y rollback.",
+  "scope": {
+    "includes": ["Archivos candidatos", "Matriz de comandos afectados", "Gates de compatibilidad", "Aliases/flags/outputs", "Rollback"],
+    "excludes": ["Implementar parser", "Cambiar dispatch CLI", "Modificar package/version", "Eliminar comportamiento existente"]
+  },
+  "actors": ["Tech Lead", "Implementador futuro", "Reviewer", "Usuarios CLI"],
+  "preconditions": ["04-slice identifica parser/registry como candidato aprobado"],
+  "inputs": ["Matriz de extraccion", "Baseline", "Contrato de no regresion", "Diffs de rama fuente"],
+  "outputs": ["Plan tecnico para rama futura desde origin/main"],
+  "workflow": [
+    {"step": 1, "name": "Confirmar decision", "description": "Definir extraer codigo, concepto o rehacer."},
+    {"step": 2, "name": "Mapear comandos", "description": "Listar comandos afectados por parser."},
+    {"step": 3, "name": "Definir gates", "description": "Definir compatibilidad y validaciones."},
+    {"step": 4, "name": "Preparar rollback", "description": "Definir como revertir si falla."}
+  ],
+  "business_rules": ["Parser/registry es alto riesgo", "Aliases/flags/exit codes no desaparecen sin aprobacion", "JSON requiere contrato", "No mezclar con bump de version"],
+  "validations": ["Todos los comandos baseline mapeados", "Diferencias con motivo y mejora", "Rollback definido", "Package/version fuera"],
+  "error_cases": ["Comando sin baseline", "Alias no preservable", "Codigo viejo no encaja"],
+  "acceptance_criteria": ["No permite merge/cherry-pick amplio", "Cambio transversal reconocido", "Matriz por comando", "Package/version fuera", "Rollback definido"],
+  "dependencies": {
+    "functional": ["Baseline", "Contrato", "Matriz de extraccion"],
+    "technical": [],
+    "external": [],
+    "depends_on_slices": ["04-slice"]
+  },
+  "implementation_order": 5,
+  "slicing_rationale": "Parser/registry requiere plan dedicado porque su blast radius es toda la CLI.",
+  "risks": ["Compatibilidad total puede requerir tests adicionales"],
+  "open_questions": ["Extraer codigo exacto o reimplementar concepto?"]
+}