create-quiver 0.15.3 → 0.16.0

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?"]
+}

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

@@ -0,0 +1,106 @@
+# 05-slice - Parser y command registry
+
+## 1. Nombre del slice
+
+Parser y command registry.
+
+## 2. Objetivo del slice
+
+Planificar la recuperacion segura de parser y command registry como cambio transversal de alto riesgo.
+
+## 3. Problema puntual que resuelve
+
+Evita tratar parser/registry como refactor pequeno cuando afecta la entrada de toda la CLI.
+
+## 4. Valor observable que entrega
+
+Plan tecnico futuro con compatibilidad total contra baseline, archivos candidatos/excluidos y rollback.
+
+## 5. Alcance especifico
+
+Planificacion de extraccion o rehacer de `command-registry` y `parser` sin implementacion.
+
+## 6. Que incluye
+
+- Analisis de archivos candidatos.
+- Matriz de comandos afectados.
+- Gates de compatibilidad.
+- Criterios para conservar aliases, flags y outputs.
+- Rollback futuro.
+
+## 7. Que no incluye
+
+- Implementar parser.
+- Cambiar dispatch CLI.
+- Modificar `package.json` o version.
+- Eliminar comportamiento existente.
+
+## 8. Actores involucrados
+
+Tech Lead, implementador futuro, reviewer y usuarios CLI.
+
+## 9. Precondiciones
+
+`04-slice` debe identificar parser/registry como candidato con decision aprobada.
+
+## 10. Entradas necesarias
+
+Matriz de extraccion, baseline, contrato de no regresion y diffs de rama fuente.
+
+## 11. Flujo operativo paso a paso
+
+1. Confirmar decision: extraer codigo, extraer concepto o rehacer.
+2. Listar comandos afectados por parser.
+3. Definir compatibilidad obligatoria.
+4. Excluir package/version.
+5. Definir validaciones por comando.
+6. Definir rollback.
+7. Preparar handoff para implementacion futura.
+
+## 12. Salidas esperadas
+
+Plan tecnico listo para una rama futura desde `origin/main`.
+
+## 13. Reglas de negocio aplicables
+
+- Parser/registry es alto riesgo.
+- Ningun alias, flag o exit code puede desaparecer sin aprobacion.
+- Cambios de salida JSON requieren contrato explicito.
+- No se mezcla con bump de version.
+
+## 14. Validaciones
+
+- Todos los comandos del baseline estan mapeados.
+- Cada diferencia propuesta tiene motivo y mejora.
+- Rollback definido.
+- No hay archivos package/version en alcance.
+
+## 15. Manejo de errores o edge cases
+
+- Si un comando no tiene baseline, parser queda bloqueado para ese comando.
+- Si un alias no puede preservarse, requiere aprobacion.
+- Si el codigo viejo no encaja, se rehace el concepto.
+
+## 16. Criterios de aceptacion
+
+- El plan no permite merge/cherry-pick amplio.
+- Parser/registry se tratan como cambio transversal.
+- Existe matriz de compatibilidad por comando.
+- Package/version quedan fuera.
+- Rollback y evidencia estan definidos.
+
+## 17. Dependencias tecnicas, funcionales o externas
+
+Baseline, contrato y matriz de extraccion.
+
+## 18. Depende de slices
+
+`04-slice`.
+
+## 19. Riesgos / decisiones abiertas
+
+La compatibilidad total puede requerir tests adicionales antes de implementar.
+
+## 20. Pendientes / preguntas abiertas
+
+Definir si se extrae codigo exacto o se reimplementa concepto desde cero.

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

@@ -0,0 +1,84 @@
+# CLOSURE_BRIEF - 05-slice
+
+## Resultado
+
+Implementado con alcance minimo aprobado.
+
+## Evidencia
+
+Plan de extraccion segura:
+
+| Area | Decision | Restriccion |
+|---|---|---|
+| `command-registry.js` | Rehacer desde `origin/main`; no copiar literal de `QUIVER-46-49` | La rama candidata incluye `status`/`changelog` top-level; no habilitarlos |
+| `parser.js` | Extraer como adaptador conservador sobre parser legacy | No introducir parser nuevo |
+| Dispatch en `index.js` | Cambio minimo para imports y llamada al adapter | No cambiar validaciones ni dispatch |
+| `parser-contract.test.js` | Tomar casos compatibles con baseline | Excluir casos que dependan de comandos no aprobados |
+| `cli-contract.test.js` | Ajustes solo si reflejan baseline real | No adoptar expectativas viejas de rama |
+| `ai.js` modularizado / `ai-core.js` | Fuera del slice | Alto riesgo por providers/lifecycle |
+| Package/version | Excluido | No tocar en este slice |
+
+Delta inspeccionado en rama fuente:
+
+| Archivo | Estado | Tamano/riesgo |
+|---|---|---|
+| `src/create-quiver/lib/cli/command-registry.js` | Nuevo | 139 lineas; util como referencia, requiere reconstruccion |
+| `src/create-quiver/lib/cli/parser.js` | Nuevo | 14 lineas; adapter sobre `legacyParseArgs` |
+| `src/create-quiver/index.js` | Modificado | 726 lineas de diff; tocar solo minimo |
+| `src/create-quiver/commands/ai.js` | Modificado masivo | Fuera del slice |
+| `src/create-quiver/commands/ai-core.js` | Nuevo, 3443 lineas | Fuera del slice |
+| `tests/commands/parser-contract.test.js` | Nuevo | Util como fuente de contratos filtrados |
+
+Gate de compatibilidad para implementacion futura:
+
+- Help global preserva comandos y shortcuts legacy.
+- `help` y `--help` siguen equivalentes.
+- `version` y `version --json` conservan contrato observado.
+- Unknown command mantiene exit code no cero y hints de help/init/update.
+- Cualquier comando sin baseline completo queda bloqueado o requiere baseline adicional.
+- `config language show --json`, `slice`, `handoff`, `evidence list --json`, `init --dry-run`, `doctor --dry-run`, `ai status --json` y `spec status` conservan el contrato observado o requieren decision explicita.
+- No aparecen `status` o `changelog` top-level como comandos nuevos.
+
+Plan de implementacion futura aprobado por este cierre:
+
+1. Rama nueva creada desde `origin/main`: `feature/QUIVER-05-parser-command-registry`.
+2. `src/create-quiver/lib/cli/command-registry.js` creado con los sets existentes de `origin/main`.
+3. `src/create-quiver/lib/cli/parser.js` creado como adapter de `parseArgs`.
+4. `src/create-quiver/index.js` ajustado solo para importar registry/parser y delegar a `parseCliArgs` con `legacyParseArgs`.
+5. `tests/commands/parser-contract.test.js` agregado con contratos compatibles con baseline.
+6. Validaciones focalizadas ejecutadas y aprobadas.
+
+Validaciones ejecutadas:
+
+| Validacion | Resultado |
+|---|---|
+| `node --check src/create-quiver/index.js` | OK |
+| `node --check src/create-quiver/lib/cli/command-registry.js` | OK |
+| `node --check src/create-quiver/lib/cli/parser.js` | OK |
+| `node --check tests/commands/parser-contract.test.js` | OK |
+| `node --test tests/commands/parser-contract.test.js tests/commands/cli-contract.test.js` | OK, 17 tests passed |
+| `node bin/create-quiver.js --help` | OK |
+| `node bin/create-quiver.js help` | OK |
+| `node bin/create-quiver.js version` | OK |
+| `node bin/create-quiver.js version --json` | OK, JSON parseable |
+| `node bin/create-quiver.js __unknown__` | OK, exit `1` |
+| `node bin/create-quiver.js status --json` | OK, sigue unsupported, exit `1` |
+| `node bin/create-quiver.js changelog` | OK, sigue unsupported, exit `1` |
+
+## Cambios de comportamiento
+
+No se busca cambio funcional. La implementacion mueve constantes a registry y delega parsing al adapter legacy.
+
+## Regresiones detectadas
+
+Ninguna en las validaciones focalizadas del slice.
+
+## Riesgos residuales
+
+Parser/registry sigue siendo alto riesgo por blast radius total sobre CLI.
+
+`ai status --json` conserva una ambiguedad detectada: en baseline emite salida humana. No corregir dentro de este slice.
+
+## Decision sobre ramas
+
+Mantener `feature/QUIVER-46-49-cli-modernization` y su remoto como referencia hasta decidir si parser/registry se extraen como codigo o se rehacen.

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

@@ -0,0 +1,109 @@
+# EXECUTION_BRIEF - 05-slice
+
+## Objetivo
+
+Preparar la implementacion futura de parser/command registry como cambio transversal seguro, sin copiar el refactor masivo de `feature/QUIVER-46-49-cli-modernization`.
+
+## Base segura
+
+La rama futura debe nacer desde `origin/main` @ `7bc234bbf96fb17d8c44863fac25430b59fc832e` o un SHA posterior verificado fresco.
+
+No usar `main` local como base mientras siga divergida de `origin/main`.
+
+## Archivos candidatos
+
+Permitidos en primera implementacion:
+
+- `src/create-quiver/lib/cli/command-registry.js`
+- `src/create-quiver/lib/cli/parser.js`
+- `src/create-quiver/index.js`, solo para extraer constantes existentes e invocar el adaptador parser sin cambiar comportamiento.
+- `tests/commands/parser-contract.test.js`, solo como suite nueva de contratos de parser.
+- `tests/commands/cli-contract.test.js`, solo para ajustar expectativas al comportamiento real de `origin/main`, no al comportamiento viejo de la rama candidata.
+
+## Archivos excluidos
+
+- `package.json`
+- `package-lock.json`
+- Version/release files
+- Cambios de comandos no mapeados
+- `src/create-quiver/commands/ai.js`
+- `src/create-quiver/commands/ai-core.js`
+- Cualquier split de comandos `ai/*`
+- Wrappers top-level nuevos como `status` o `changelog`
+- Docs generadas o templates, salvo que el cambio futuro demuestre que el help real ya cambio y se apruebe en `07-slice`
+
+## Funcionalidad existente afectada
+
+Todos los comandos CLI pueden verse afectados por parser/dispatch.
+
+## Matriz antes/despues
+
+Obligatoria por comando, alias, flag, help, JSON, exit code y side effect.
+
+Baseline minimo que debe quedar igual:
+
+| Area | Antes en `origin/main` | Despues permitido |
+|---|---|---|
+| `--help` / `help` | Ambos imprimen la misma referencia CLI | Igual, sin perder comandos ni aliases |
+| `version` | Reporte humano `Quiver CLI: 0.15.3` sobre base actual | Igual salvo version si se implementa en base posterior |
+| `version --json` | JSON con `version_schema_version`, `cli`, `runtime`, `package_manager`, `project` | Igual schema y campos |
+| Unknown command | Exit `1`, stderr con unsupported command + hints | Igual contrato |
+| `config language show --json` | JSON con `schema_version`, `language`, `source`, `requested_source`, `requested_language`, `warnings` | Igual contrato |
+| `slice` sin subcomando | Exit `1`, lista subcomandos soportados | Igual contrato |
+| `handoff` sin subcomando | Exit `1`, lista subcomandos soportados | Igual contrato |
+| `evidence list --json` | JSON `{ "evidence": [] }` cuando no hay evidencia | Igual contrato |
+| `init --dry-run` | Plan sin escribir en el repo | Igual contrato dry-run |
+| `ai status --json` | Actualmente salida humana en estado sin run | No corregir ni cambiar sin decision explicita |
+
+## Validaciones
+
+- Compatibilidad total contra baseline.
+- No se pierden aliases ni flags.
+- Rollback definido antes de implementar.
+- `parser.js` debe seguir usando el parser legacy como adapter durante esta etapa.
+- `command-registry.js` debe reconstruirse desde `origin/main`, no copiarse tal cual desde `QUIVER-46-49`.
+- `HELP_OPTION_SCOPES` puede extraerse como metadata solo si no cambia texto publico sin aprobacion.
+
+## Riesgos
+
+Regresion transversal silenciosa.
+
+Riesgos especificos detectados:
+
+- `feature/QUIVER-46-49-cli-modernization` cambia `7` archivos clave con `4235` inserciones y `3755` eliminaciones en el area parser/CLI.
+- El `command-registry.js` candidato incluye comandos top-level `status` y `changelog`; no deben habilitarse en este slice.
+- El split `ai-core.js` tiene `3443` lineas nuevas; queda fuera para evitar mezclar parser con modularizacion AI.
+- El test candidato `parser-contract.test.js` contiene casos utiles, pero algunos dependen de comportamiento de rama (`status` top-level) que no pertenece al baseline actual.
+
+## Rollback
+
+Revertir los archivos candidatos al estado previo de `origin/main` y validar:
+
+- `node bin/create-quiver.js --help`
+- `node bin/create-quiver.js help`
+- `node bin/create-quiver.js version`
+- `node bin/create-quiver.js version --json`
+- `node bin/create-quiver.js __unknown__`
+- `node bin/create-quiver.js config language show --json`
+- `node bin/create-quiver.js slice`
+- `node bin/create-quiver.js handoff`
+- `node bin/create-quiver.js evidence list --json`
+
+## Decision tecnica exacta
+
+Implementar en una rama futura como migracion conservadora:
+
+1. Crear `command-registry.js` nuevo, pero poblarlo con los sets actuales de `origin/main`, no con la lista literal de `QUIVER-46-49`.
+2. Crear `parser.js` como adaptador de `parseArgs`, equivalente al candidato de rama, sin introducir parser nuevo.
+3. Cambiar `index.js` solo para importar los sets desde `command-registry.js` y llamar `parseCliArgs(..., { legacyParseArgs: parseArgs })`.
+4. No cambiar logica de parsing, validaciones, dispatch ni comandos.
+5. Agregar tests de contrato seleccionados del candidato, filtrando casos que dependan de comandos no aprobados.
+6. No tocar `ai.js`, `ai-core.js`, wrappers, docs, package ni version.
+
+## Criterio de salida para aprobar implementacion futura
+
+- Diff acotado a archivos candidatos.
+- Help global sin perdida de comandos.
+- Contratos basicos de baseline preservados.
+- Tests nuevos solo pinnean comportamiento existente o riesgos aprobados.
+- No aparecen `status` o `changelog` top-level como comandos nuevos.