create-quiver 0.15.4 → 0.17.0

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

@@ -0,0 +1,80 @@
+# CLOSURE_BRIEF - 01-slice
+
+## Resultado
+
+Completado.
+
+## Evidencia
+
+Snapshot local tomado el `2026-06-08T17:04:35-0300`.
+
+Base usada: `origin/main` @ `7bc234bbf96fb17d8c44863fac25430b59fc832e`.
+
+Estado del working tree al iniciar snapshot: `main...origin/main [ahead 1, behind 44]`.
+
+Verificacion remota no destructiva ejecutada el `2026-06-08T17:12:45-0300`:
+
+| Campo | Valor |
+|---|---|
+| Remote URL | `git@github-personal:FabriJuncal/quiver.git` |
+| `origin/main` local | `7bc234bbf96fb17d8c44863fac25430b59fc832e` |
+| `main` remoto | `7bc234bbf96fb17d8c44863fac25430b59fc832e` |
+| `origin/main` fresco | Si |
+| Heads remotos actuales | 10 |
+| Remote-tracking refs locales bajo `origin` | 13 |
+
+Remote-tracking refs locales stale detectados, sin pruning automatico:
+
+- `origin/feature/QUIVER-52-02-v52-generated-cli-reference`
+- `origin/feature/QUIVER-52-03-v52-release-package-hygiene`
+
+Resumen de refs revisados:
+
+| Metrica | Valor |
+|---|---:|
+| Total refs revisados, excluyendo `origin/main` | 76 |
+| Locales | 65 |
+| Remotos | 11 |
+| Sin delta contra `origin/main` | 60 |
+| Con commits por encima de `origin/main` | 16 |
+| Con conflictos textuales probables por `merge-tree` | 13 |
+| Sin merge-base / desconocidos | 0 |
+
+Refs con commits por encima de `origin/main`:
+
+| Ref | Ahead | Behind | Conflicto textual | Estado |
+|---|---:|---:|---|---|
+| `backup/QUIVER-52-03-before-squash` | 3 | 2 | No | revisar como backup, no merge directo |
+| `backup/main-before-pull-v31` | 9 | 111 | Si | conflicto / backup obsoleto |
+| `docs/QUIVER-02-decision-log-context-checkpoint` | 1 | 326 | Si | conflicto / revert viejo |
+| `drafts/v19-v22-orchestration-followups` | 1 | 286 | No | revisar como draft documental |
+| `feature/QUIVER-01-ci-matrix-verified` | 2 | 300 | Si | revisar/extraccion manual |
+| `feature/QUIVER-03-project-map-reading-order` | 1 | 324 | Si | conflicto / revert viejo |
+| `feature/QUIVER-20-ai-cli-orchestration` | 1 | 253 | Si | conflicto / probablemente obsoleto |
+| `feature/QUIVER-46-49-cli-modernization` | 3 | 44 | Si | fuente de extraccion, no merge completo |
+| `feature/QUIVER-50-01-runtime-minimum-and-package-metadata` | 1 | 38 | Si | extraccion conceptual separada |
+| `feature/QUIVER-50-03-v50-security-reporting` | 1 | 38 | Si | extraccion documental manual |
+| `feature/QUIVER-50-06-contributor-and-architecture-docs` | 1 | 38 | Si | extraccion documental manual |
+| `main` | 1 | 44 | Si | divergida, no usar como base |
+| `origin/drafts/v19-v22-orchestration-followups` | 1 | 286 | No | duplicado remoto de draft |
+| `origin/feature/QUIVER-01-ci-matrix-verified` | 2 | 300 | Si | duplicado remoto para revisar |
+| `origin/feature/QUIVER-20-ai-cli-orchestration` | 1 | 253 | Si | duplicado remoto obsoleto |
+| `origin/feature/QUIVER-46-49-cli-modernization` | 3 | 44 | Si | duplicado remoto de fuente de extraccion |
+
+## Cambios de comportamiento
+
+Ninguno. Solo se ejecutaron comandos Git read-only y `merge-tree`.
+
+## Regresiones detectadas
+
+Ninguna; no se modifico codigo ni ramas.
+
+## Riesgos residuales
+
+- No se ejecuto `fetch` ni `prune`; hay remote-tracking refs locales stale documentados.
+- `merge-tree` cubre conflicto textual, no conflicto semantico ni de contrato.
+- Ramas `ahead=0` quedan como `sin delta`, no como eliminables.
+
+## Decision sobre ramas
+
+No se cierra ni elimina ninguna rama. Las ramas fuente de extraccion quedan retenidas hasta completar la matriz de extraccion.

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

@@ -0,0 +1,39 @@
+# EXECUTION_BRIEF - 01-slice
+
+## Objetivo
+
+Generar un snapshot verificable de ramas sin modificar el repo.
+
+## Base segura
+
+Usar `origin/main` y registrar su SHA exacto al momento de ejecucion.
+
+## Archivos candidatos
+
+Solo documentos de evidencia del slice si se implementa documentacion posterior.
+
+## Archivos excluidos
+
+Codigo fuente, package files, ramas Git y configuracion remota.
+
+## Funcionalidad existente afectada
+
+Ninguna. Este slice es read-only.
+
+## Matriz antes/despues
+
+No aplica porque no modifica comportamiento.
+
+## Validaciones
+
+- Inventario incluye local/remota.
+- Inventario registra SHA y fecha.
+- No hay acciones destructivas.
+
+## Riesgos
+
+Snapshot remoto desactualizado si no se autoriza `fetch`.
+
+## Rollback
+
+No aplica a codigo. Si el reporte es incorrecto, descartarlo y regenerarlo con snapshot fresco.

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

@@ -0,0 +1,36 @@
+{
+  "slice_id": "02-slice",
+  "slice_number": "02",
+  "title": "Baseline de comportamiento actual",
+  "objective": "Documentar el comportamiento actual que no debe romperse antes de cualquier extraccion o refactor.",
+  "problem": "Sin baseline, la regla de no quitar funcionalidad no es verificable.",
+  "value_outcome": "Matriz de comportamiento actual para comandos, flags, aliases, outputs, JSON, exit codes, side effects, exports, scripts, templates y docs generadas.",
+  "scope": {
+    "includes": ["Comandos", "Aliases", "Flags", "Help", "JSON", "Exit codes", "Stdout/stderr", "Archivos generados", "Scripts", "Exports", "Templates", "Docs generadas"],
+    "excludes": ["Cambios de parser", "Cambios de comandos", "Bumps de version", "Reemplazo de tests"]
+  },
+  "actors": ["Tech Lead", "Reviewer", "Usuarios CLI", "Automatizaciones"],
+  "preconditions": ["01-slice completado o snapshot aprobado"],
+  "inputs": ["CLI actual", "Documentacion actual", "Tests existentes"],
+  "outputs": ["Matriz baseline", "Lista de gaps"],
+  "workflow": [
+    {"step": 1, "name": "Enumerar comandos", "description": "Listar comandos y aliases actuales."},
+    {"step": 2, "name": "Registrar contratos", "description": "Registrar flags, help, JSON, exit codes y streams."},
+    {"step": 3, "name": "Registrar side effects", "description": "Documentar archivos generados, scripts, exports y templates."},
+    {"step": 4, "name": "Marcar gaps", "description": "Listar areas sin evidencia suficiente."}
+  ],
+  "business_rules": ["Ningun slice tecnico avanza sin baseline", "JSON y exit codes son contrato", "Falta de evidencia se marca como riesgo"],
+  "validations": ["Cada comando critico tiene entrada", "Cada gap esta marcado", "La matriz permite comparacion futura"],
+  "error_cases": ["Comandos con side effects", "Outputs variables", "JSON no soportado"],
+  "acceptance_criteria": ["Existe matriz baseline", "Cubre comandos/flags/aliases/help/JSON/exit codes/side effects", "Gaps listados", "Cambios futuros comparan contra baseline"],
+  "dependencies": {
+    "functional": ["Snapshot aprobado"],
+    "technical": ["CLI actual"],
+    "external": [],
+    "depends_on_slices": ["01-slice"]
+  },
+  "implementation_order": 2,
+  "slicing_rationale": "El baseline transforma no regresion en criterio verificable.",
+  "risks": ["Cobertura incompleta de comandos"],
+  "open_questions": ["Cuales son comandos criticos minimos si se prioriza?"]
+}

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

@@ -0,0 +1,108 @@
+# 02-slice - Baseline de comportamiento actual
+
+## 1. Nombre del slice
+
+Baseline de comportamiento actual.
+
+## 2. Objetivo del slice
+
+Documentar el comportamiento actual que no debe romperse antes de cualquier extraccion o refactor.
+
+## 3. Problema puntual que resuelve
+
+Sin baseline, la regla de no quitar funcionalidad no es verificable.
+
+## 4. Valor observable que entrega
+
+Matriz de comportamiento actual para comandos, flags, aliases, outputs, JSON, exit codes, side effects, exports, scripts, templates y docs generadas.
+
+## 5. Alcance especifico
+
+Crear un contrato de observacion del estado actual. No cambia codigo ni tests.
+
+## 6. Que incluye
+
+- Inventario de comandos visibles.
+- Aliases y flags.
+- `--help` y `--json`.
+- Exit codes para exito/error.
+- Stdout/stderr esperados.
+- Archivos generados y rutas.
+- Scripts CI relevantes.
+- Exports internos usados por tests o consumidores.
+- Templates y docs generadas.
+
+## 7. Que no incluye
+
+- Cambios de parser.
+- Cambios de comandos.
+- Bumps de version.
+- Reemplazo de tests.
+
+## 8. Actores involucrados
+
+Tech Lead, reviewer, usuarios CLI y automatizaciones.
+
+## 9. Precondiciones
+
+`01-slice` completado o snapshot de base aprobado.
+
+## 10. Entradas necesarias
+
+CLI actual sobre `origin/main`, documentacion actual y tests existentes.
+
+## 11. Flujo operativo paso a paso
+
+1. Enumerar comandos y aliases actuales.
+2. Registrar flags por comando.
+3. Capturar comportamiento de ayuda.
+4. Registrar contratos JSON cuando existan.
+5. Registrar exit codes y streams.
+6. Registrar archivos generados y side effects.
+7. Registrar scripts y exports relevantes.
+8. Identificar areas sin evidencia.
+
+## 12. Salidas esperadas
+
+Matriz de baseline y lista de gaps que bloquean extracciones futuras.
+
+## 13. Reglas de negocio aplicables
+
+- Ningun slice tecnico puede avanzar sin baseline suficiente.
+- `--json`, exit codes y side effects son contrato funcional.
+- Falta de evidencia se documenta como riesgo, no se asume seguro.
+
+## 14. Validaciones
+
+- Cada comando critico tiene entrada en la matriz.
+- Cada cambio futuro puede referenciar baseline.
+- Los gaps estan marcados explicitamente.
+
+## 15. Manejo de errores o edge cases
+
+- Si un comando no puede ejecutarse sin side effects, registrar precondiciones y no forzarlo.
+- Si no existe JSON mode, registrar como no soportado.
+- Si hay outputs variables, registrar partes estables.
+
+## 16. Criterios de aceptacion
+
+- Existe matriz baseline antes de extraer codigo.
+- Baseline cubre comandos, flags, aliases, help, JSON, exit codes y side effects.
+- Las areas no cubiertas estan listadas como riesgos.
+- Ningun cambio futuro puede declararse no regresivo sin comparar contra este baseline.
+
+## 17. Dependencias tecnicas, funcionales o externas
+
+Snapshot aprobado y acceso a CLI/documentacion actual.
+
+## 18. Depende de slices
+
+`01-slice`.
+
+## 19. Riesgos / decisiones abiertas
+
+Puede ser costoso cubrir todos los comandos; si se prioriza, debe quedar explicito.
+
+## 20. Pendientes / preguntas abiertas
+
+Definir comandos criticos minimos si el baseline completo requiere varias iteraciones.

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