create-quiver 0.16.0 → 0.17.1

package/copys-landing-page.md

@@ -1,244 +0,0 @@
-# Copys para Landing Page de Quiver
-
-> Basados exclusivamente en funcionalidades y propuesta de valor documentadas en el proyecto.  
-> Los campos marcados con `[Completar con información real del producto]` requieren datos del equipo.
-
----
-
-## 1. Hero Section
-
-### Título principal
-
-**"Que la IA trabaje rápido. Pero con orden."**
-
----
-
-### Subtítulo
-
-Los agentes de IA aceleran el desarrollo, pero sin estructura generan caos. Quiver convierte el trabajo asistido por IA en un flujo guiado: requerimientos, criterios, plan técnico, specs, slices, commits y pull requests — todo visible, todo verificable.
-
----
-
-### CTA principal
-
-**Empezar ahora** → `npx create-quiver@latest init --name "Mi Proyecto"`
-
----
-
-### CTA secundario
-
-**Ver la guía completa** → [docs/workflows/full-ai-spec-to-pr.md]
-
----
-
-## 2. Propuesta de Valor
-
-### Bloque 1 — Del caos al flujo repetible
-
-**"Un proceso que se puede repetir, auditar y mejorar."**
-
-En lugar de pedirle a un agente "hacé esto y vemos qué pasa", Quiver define un camino repetible: entender el repositorio, preparar contexto, planificar con aprobaciones humanas, generar specs, ejecutar slice por slice, validar con evidencia y abrir el PR.
-
----
-
-### Bloque 2 — El humano siempre aprueba lo importante
-
-**"IA rápida, decisiones humanas."**
-
-Quiver separa los pasos que necesitan aprobación humana (criterios de aceptación, plan técnico) de los que puede automatizar la IA (ejecución de slices, commits, validación). El humano mantiene el control sin perder velocidad.
-
----
-
-### Bloque 3 — Contexto mínimo, resultados máximos
-
-**"El agente ejecutor solo lee lo que necesita."**
-
-Quiver entrega a cada agente un contexto acotado: el slice exacto, sus dependencias y su alcance aprobado. Sin ruido. Sin contexto incorrecto. Sin implementaciones que se desvían del plan.
-
----
-
-### Bloque 4 — Documentación generada, no escrita
-
-**"El proyecto se documenta solo mientras se trabaja."**
-
-Quiver crea y mantiene `AI_CONTEXT.md`, `PROJECT_MAP.md`, `AGENTS.md`, briefs de ejecución y reportes de evidencia como parte del flujo normal de trabajo. No como tarea adicional.
-
----
-
-### Bloque 5 — Compatible con tu stack y tu equipo
-
-**"Funciona donde ya trabajás."**
-
-Quiver se ejecuta con `npx` sin instalación. Soporta macOS, Linux y Windows. Compatible con npm, yarn, pnpm y bun. Funciona con Codex, Claude, Gemini y cualquier CLI de proveedor que soporte.
-
----
-
-## 3. Beneficios Principales
-
-- **Trazabilidad completa:** cada cambio tiene una spec aprobada, un slice definido y evidencia de validación asociada.
-- **Sin sorpresas en el PR:** el alcance del pull request está definido antes de que el agente escriba una sola línea.
-- **Onboarding instantáneo para agentes:** `AGENTS.md` y `AI_ONBOARDING_PROMPT.md` generados automáticamente le dan a cualquier agente el contexto necesario en segundos.
-- **Independiente de cualquier proveedor de IA:** Quiver orquesta el flujo; los proveedores (Codex, Claude, Gemini) hacen el trabajo de generación.
-- **Flujo verificable en cualquier momento:** `quiver flow`, `quiver dashboard` y `quiver doctor` muestran el estado real del proyecto en cualquier momento.
-- **Sin API keys en el repositorio:** las credenciales viven en los CLIs de proveedor y en el sistema operativo, nunca en los archivos de Quiver.
-- **Soporte en inglés y español:** output del CLI, documentación generada y mensajes de error disponibles en ambos idiomas.
-- **Funciona con proyectos nuevos y existentes:** `init` para proyectos nuevos, `migrate` para los que ya tienen código.
-
----
-
-## 4. Sección de Problema
-
-### "¿Por qué los agentes de IA fallan en proyectos reales?"
-
-Los agentes de IA pueden escribir código rápido. Pero suelen fallar por motivos sorprendentemente mundanos:
-
-- **Leen demasiado contexto o el contexto incorrecto.** El agente procesa miles de líneas que no tienen que ver con la tarea.
-- **Implementan antes de cerrar criterios de aceptación.** El equipo no sabe qué construyó el agente hasta que ya está hecho.
-- **Saltean la aprobación del plan.** No hay una fase donde el humano valide qué se va a cambiar antes de que se cambie.
-- **Mezclan cambios no relacionados en el mismo PR.** Un pull request que toca diez cosas distintas es imposible de revisar.
-- **Olvidan qué se decidió en fases anteriores.** Sin estado persistente, cada sesión empieza de cero.
-- **Generan código sin evidencia de validación.** Nadie puede auditar si los tests pasaron, cuánto tardaron o qué salida produjeron.
-- **Dejan al equipo reconstruyendo qué pasó.** El historial de chat se pierde. El contexto desaparece.
-
-El resultado: trabajo más rápido en el corto plazo, caos técnico que crece con cada iteración.
-
----
-
-## 5. Sección de Solución
-
-### "Quiver convierte el trabajo asistido por IA en un flujo con estructura."
-
-Quiver no reemplaza al agente. Lo ordena.
-
-Combina dos metodologías complementarias:
-- **WDD (Workflow-Driven Development):** primero se define cómo se trabaja, después se trabaja.
-- **SDD (Spec-Driven Development):** el trabajo se describe como specs y slices antes de implementarse.
-
-En la práctica, Quiver separa dos roles de agentes:
-
-- Un **agente planificador** prepara criterios de aceptación, plan técnico, specs, slices, briefs y el cuerpo del PR. El humano aprueba en cada fase importante.
-- Un **agente ejecutor** recibe solo el contexto mínimo de un slice y modifica código dentro del alcance exacto que fue aprobado.
-
-El resultado es un flujo visible de principio a fin: requerimiento → criterios aprobados → plan aprobado → spec generada → slices ejecutados → evidencia validada → PR abierto → spec cerrada.
-
-Cada paso es verificable. Cada decisión es auditable. El equipo mantiene el control.
-
----
-
-## 6. Features Destacadas
-
-### `quiver flow` — Tu brújula de workflow
-
-Ejecutá `quiver flow` en cualquier momento para saber exactamente en qué etapa está el proyecto y cuál es el próximo comando seguro. Funciona como un GPS para el flujo de trabajo: siempre te dice dónde estás y hacia dónde ir.
-
----
-
-### `quiver ai plan` — El planner genera el plan, el humano lo aprueba
-
-En lugar de pedirle al agente que "haga algo", Quiver hace que el agente proponga criterios de aceptación y un plan técnico estructurado. Guardás los borradores, los revisás, y aprobás la versión que querés usar como base para la implementación. Sin aprobación, no hay avance.
-
----
-
-### `quiver spec create` — De plan aprobado a spec lista para ejecutar
-
-Una vez aprobado el plan técnico, `spec create` genera automáticamente la estructura de spec: directorio, slices numerados, briefs de ejecución, cuerpo del PR y plan de ejecución en olas. Todo listo para que el ejecutor trabaje slice por slice.
-
----
-
-### `quiver ai execute-slice` — Ejecución controlada, un slice por vez
-
-El agente ejecutor recibe solo el contexto del slice que tiene que implementar: archivos en scope, dependencias, criterios de validación. Ejecuta, valida y commitea. El alcance está definido de antemano; si el agente se desvía, Quiver lo detecta.
-
----
-
-### `quiver evidence run` — Validación con registro
-
-Ejecutá cualquier comando (tests, builds, linters) y Quiver registra automáticamente el código de salida, la duración y el output redactado como archivo de evidencia Markdown. Sin capturas de pantalla, sin copy-paste. Evidencia reproducible por defecto.
-
----
-
-### `quiver dashboard` — Estado consolidado en un vistazo
-
-Un resumen compacto de specs, slices, runs, aprobaciones y agentes configurados. Filtrable por sección, spec y cantidad de items. Con `--json` para integrarlo en dashboards externos.
-
----
-
-### `quiver ai agent set` — Configura tus agentes una sola vez
-
-Configurá un perfil de planner, ejecutor, revisor y doctor con proveedor y modelo técnico. Quiver les pasa el modelo exacto al CLI del proveedor en cada ejecución. Sin configurar lo mismo en cada sesión. Sin guardar API keys en el repositorio.
-
----
-
-### `quiver doctor` — Diagnóstico del contrato del proyecto
-
-Valida que la estructura del proyecto esté sana: archivos requeridos, scripts de `package.json`, estado de Quiver. Con `--fix` aplica reparaciones seguras y no destructivas. Con `--json` es integrable en pipelines de CI.
-
----
-
-## 7. Sección de Confianza
-
-### Construido con el mismo flujo que describe
-
-Quiver se desarrolla usando Quiver. El repositorio es la demostración del producto: cada spec visible en `specs/`, cada slice ejecutado con evidencia, cada PR abierto siguiendo el flujo documentado.
-
----
-
-### Transparencia de implementación
-
-Todo el código de Quiver es código abierto bajo licencia MIT. Los specs, slices y evidencias del desarrollo del framework están en el repositorio. Podés ver exactamente qué se implementó, cómo, y por qué.
-
----
-
-### Independiente de cualquier proveedor
-
-Quiver no te ata a un proveedor de IA. Hoy podés usar Codex, mañana Claude, pasado Gemini. Las credenciales viven en los CLIs de cada proveedor. Quiver solo orquesta el flujo.
-
----
-
-### Sin datos de proyecto enviados a servicios externos
-
-`quiver flow`, `quiver doctor`, `quiver plan` y `quiver dashboard` son comandos que solo leen el estado local del proyecto. No envían datos a ningún servicio externo. El código y el contexto de tu proyecto no salen de tu máquina salvo cuando vos explícitamente invocás un proveedor de IA.
-
----
-
-### Disponible en npm desde el día uno
-
-```bash
-npx create-quiver@latest --help
-```
-
-Sin registro. Sin trial. Sin tarjeta de crédito. Ejecutable en segundos desde cualquier terminal con Node.js.
-
----
-
-### Soporte en múltiples plataformas
-
-macOS · Linux · Windows PowerShell · Windows Git Bash · WSL
-
-Documentación de instalación paso a paso para cada plataforma.
-
----
-
-## 8. CTA Final
-
-### "Tu próximo feature. Con IA. Con orden."
-
-No necesitás cambiar tu stack, tu repositorio ni tu equipo.
-
-Solo necesitás correr un comando desde la raíz de tu proyecto:
-
-```bash
-npx create-quiver@latest init --name "Mi Proyecto"
-```
-
-En minutos tenés el contexto de IA preparado, el flujo definido y el primer paso claro.
-
-**[Empezar gratis →]** `npx create-quiver@latest init`
-
-**[Leer la guía completa →]** Ver documentación
-
-**[Ver el código →]** [Completar con información real del producto: URL del repositorio]
-
----
-
-> *Quiver es MIT. No hay costos de licencia. El único costo es el de los proveedores de IA que elijas usar.*

package/docs/ai/ACTIVE_SLICE.md

@@ -1,61 +0,0 @@
----
-purpose: "Active slice execution brief"
-applies_when: "implementation"
-token_cost: 409
-last_updated: "2026-06-09"
-supersedes: null
----
-
-# Active Slice
-
-## Slice ID
-
-slice-01-json-schema-for-slice-json
-
-## Title
-
-JSON Schema for slice.json
-
-## Objective
-
-Publish a slice.json JSON Schema aligned with runtime behavior.
-
-## allowed_files
-- docs/INDEX.md
-- docs/reference/slice-schema.md
-- docs/schema/**
-- package.json
-- package-lock.json
-- scripts/ci/check-slice-schema.js
-- scripts/package-quiver.sh
-- tests/fixtures/slice-schema/invalid/empty-files.json
-- tests/fixtures/slice-schema/invalid/missing-git-field.json
-- tests/fixtures/slice-schema/invalid/missing-slice-id.json
-- tests/fixtures/slice-schema/invalid/unsafe-allowed-write-path.json
-- tests/schema/slice-schema.test.js
-- specs/quiver-v52-schema-docs-release-hygiene/SPEC.md
-- specs/quiver-v52-schema-docs-release-hygiene/STATUS.md
-- specs/quiver-v52-schema-docs-release-hygiene/EVIDENCE_REPORT.md
-- specs/quiver-v52-schema-docs-release-hygiene/slices/slice-01-json-schema-for-slice-json/CLOSURE_BRIEF.md
-- specs/quiver-v52-schema-docs-release-hygiene/slices/slice-01-json-schema-for-slice-json/slice.json
-- specs/quiver-v52-schema-docs-release-hygiene/slices/slice-01-json-schema-for-slice-json/pr.md
-
-## Validation Commands
-- npm ci
-- npm run schema:slice:check
-- node --test tests/schema/slice-schema.test.js
-- npm run docs:check
-- node --test
-- npm run package:quiver
-- git diff --check
-
-## Definition of Done
-- Schema is valid JSON Schema Draft-07 or higher.
-- Schema validates existing valid slice fixtures.
-- Schema rejects representative invalid fixtures.
-- Docs reference the schema.
-- Package smoke includes the schema if it is public.
-
-## Prohibition
-
-Do not edit any file outside allowed_files.

package/pr.md

@@ -1,154 +0,0 @@
-## Title
-
-chore(release): 0.16.0
-
-## Summary
-
-Prepares `create-quiver` `0.16.0` for publication. This release bumps package metadata from `0.15.3` to `0.16.0` and updates the changelog with the newly integrated read-only `changelog` command, parser/registry extraction, Spec 01 closure package, and release-readiness command-role audit.
-
-## PR Policy
-
-- One release = one commit.
-- Base branch: `main`.
-- Branch: `release/create-quiver-0.16.0`.
-- Human merge required.
-- This PR does not publish to npm.
-- Publishing remains explicitly guarded by `QUIVER_ALLOW_NPM_PUBLISH=1` and npm auth.
-
-## Scope
-
-Includes:
-
-- Bump `package.json` to `0.16.0`.
-- Bump `package-lock.json` root/package versions to `0.16.0`.
-- Update `CHANGELOG.md` with release notes for the command wrapper, parser/registry extraction, evidence gates, and Spec 01 closure.
-- Validate the CLI command surface and release gates before opening the PR.
-
-Excludes:
-
-- No `npm publish`.
-- No npm tag creation.
-- No Git tag creation.
-- No branch cleanup.
-- No runtime code changes beyond already-merged slices.
-
-## Files
-
-- `package.json`
-- `package-lock.json`
-- `CHANGELOG.md`
-
-## How to Test (DETAILED - REQUIRED)
-
-### Required Environment
-
-- Node.js and npm installed.
-- Dependencies installed with `npm ci` or existing `node_modules` available.
-- Git checkout of this PR branch.
-- npm publish credentials are not required for PR validation.
-
-### Worktree Access
-
-1. Checkout `release/create-quiver-0.16.0`.
-2. Confirm the package version is `0.16.0`:
-
-   ```bash
-   node -e "const p=require('./package.json'); const l=require('./package-lock.json'); console.log(p.version, l.version, l.packages[''].version)"
-   ```
-
-3. Confirm only release metadata files changed:
-
-   ```bash
-   git diff --stat origin/main...HEAD
-   ```
-
-### Run the Project
-
-No server is required. This is a CLI package release PR.
-
-### Use Cases
-
-1. Confirm release version metadata.
-
-   Expected:
-
-   - `package.json` reports `0.16.0`.
-   - `package-lock.json` reports `0.16.0` at root and package entry.
-
-2. Confirm changelog explains why the release exists.
-
-   Expected:
-
-   - `CHANGELOG.md` includes `changelog` command notes.
-   - `CHANGELOG.md` includes parser/registry extraction and release-readiness evidence notes.
-
-3. Confirm the new command role.
-
-   Expected:
-
-   - `changelog` is read-only.
-   - Human output explains packaged release notes.
-   - JSON output is parseable for automation.
-
-4. Confirm public command roles are understood before publish.
-
-   Expected:
-
-   - Help/version/changelog/config are direct inspection commands.
-   - Init/analyze/migrate/demo/evidence write only in explicit or fixture-safe modes.
-   - Flow/dashboard/plan/graph/next/spec/slice/handoff commands describe workflow state and validation.
-   - AI commands are lifecycle, planning, provider-profile, execution, inspection, and PR-preflight surfaces.
-   - Commands with missing prerequisites fail with actionable, controlled errors instead of crashes.
-
-### Technical Verification
-
-Run:
-
-```bash
-npm run changelog:check
-npm run docs:check
-npm run schema:slice:check
-npm test
-```
-
-Optional release dry-run from a clean worktree:
-
-```bash
-npm ci
-bash scripts/release-quiver.sh patch
-```
-
-Expected:
-
-- Changelog validation passes.
-- Docs lint/link/generated command reference checks pass.
-- Slice schema validation passes.
-- Full test suite passes.
-- Release dry-run passes through changelog/docs/schema, installer smoke, package artifact, and installed CLI smoke.
-
-## Evidence
-
-Validated locally before PR:
-
-- `npm run changelog:check`: OK, `Unreleased entries: 26`.
-- `npm run docs:check`: OK.
-- `npm run schema:slice:check`: OK.
-- `npm test`: OK, `655/655` pass.
-- Manual command-role audit: OK after correcting fixtures/preconditions.
-- `changelog` human output: OK.
-- `changelog --json`: OK, parseable JSON.
-- `status --json`: controlled unsupported top-level command, as intended.
-- Release dry-run in clean temporary worktree with `npm ci`: OK.
-- Package smoke: OK, `create-quiver-0.16.0.tgz` installed CLI smoke passed.
-
-## Rollback
-
-Revert the single release commit before merge. If already merged but not published, revert the release commit on `main`. If already published, do not unpublish by default; publish a corrective patch release instead.
-
-## Risks / Notes
-
-- npm `latest` is currently `0.15.4`; this PR intentionally prepares `0.16.0` because the public CLI surface changed with `changelog`.
-- Local `npm whoami` previously returned `401 Unauthorized`; publishing requires npm login before the final publish step.
-- `QUIVER_ALLOW_NPM_PUBLISH=1` must be explicitly set for guarded publish flows.
-- The release script does not publish in this PR.
-- Local `pr.md` is not part of the PR commit.