create-quiver 0.15.4 → 0.17.0

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.

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.