create-quiver 0.13.0 → 0.14.1

package/specs/quiver-v29-planner-prepare-context-cli-ux/slices/slice-05-progressive-command-adoption/CLOSURE_BRIEF.md

@@ -0,0 +1,34 @@
+# CLOSURE_BRIEF - slice-05 Progressive command adoption
+
+## Summary
+
+Completed progressive UX adoption for selected high-value commands.
+
+## Validation Against Acceptance Criteria
+
+- `ai plan` accepts the UX flags, reports planner/review/interactive intent in dry-run, supports editor review of provider drafts before saving, and can require interactive approval before saving.
+- `spec create` supports `--review` as a guarded preview review before writes and `--interactive` as explicit confirmation before generation.
+- `ai pr` supports review/edit of `pr.md` before creating the PR plan and interactive confirmation before `gh pr create`.
+- `ai pr` still rejects `--with-planner` through the centralized flag matrix.
+- Existing tests for the affected commands continue to pass.
+
+## Relevant Changes
+
+- Updated `src/create-quiver/commands/ai.js` for `ai plan` draft review/interactive confirmation and `ai pr` PR body review/interactive confirmation.
+- Updated `src/create-quiver/commands/spec.js` for `spec create` review/interactive guardrails.
+- Updated `src/create-quiver/index.js` to await async `spec create`.
+- Added command tests in `tests/commands/ai-plan.test.js`, `tests/commands/spec-create.test.js`, and `tests/commands/ai-pr.test.js`.
+
+## Pending Work
+
+- Final docs and command reference updates must document these supported flags.
+- Remaining commands should be migrated only through future scoped slices.
+
+## Remaining Risks
+
+- Command UX can drift unless docs and matrix are updated in the final slice.
+- `spec create --review` reviews the preview artifact and does not treat preview edits as source-of-truth changes; this is intentional guardrail behavior, but docs should explain it.
+
+## Future Recommendations
+
+- Consider future UX adoption for `doctor --interactive --fix`, `ai onboard`, and `ai revise`.

package/specs/quiver-v29-planner-prepare-context-cli-ux/slices/slice-05-progressive-command-adoption/EXECUTION_BRIEF.md

@@ -0,0 +1,46 @@
+# EXECUTION_BRIEF - slice-05 Progressive command adoption
+
+## Context
+
+After `ai prepare-context` implements the full pattern, selected commands should adopt the same standard where it clearly improves UX.
+
+## Objective
+
+Apply UX flags and review/interactive behavior to `ai plan`, `spec create`, and `ai pr` without redesigning unrelated commands.
+
+## Scope
+
+- `ai plan`: planner-related UX flags and optional review flow.
+- `spec create`: guarded review/interactive path.
+- `ai pr`: interactive PR inputs and review/edit of `pr.md`; no `--with-planner`.
+- Tests for supported and unsupported combinations.
+
+## Acceptance Criteria
+
+- No command becomes interactive by default.
+- Every interactive choice has a flag equivalent.
+- Machine output stays clean.
+- Unsupported flags fail clearly.
+
+## Suggested Steps
+
+1. Start with `ai pr --review` because it maps cleanly to existing `pr.md`.
+2. Add minimal `spec create --review` guardrails.
+3. Add `ai plan` UX flag compatibility.
+4. Add tests for each.
+
+## Restrictions
+
+- Do not apply the standard to all commands in this slice.
+- Do not add planner mode to `ai pr`.
+
+## Risks
+
+- Broad command changes can create regressions. Keep adoption narrow and test heavily.
+
+## Completion Checklist
+
+- [ ] `ai plan` compatibility tested.
+- [ ] `spec create` review/interactive behavior tested.
+- [ ] `ai pr` review/interactive behavior tested.
+- [ ] Existing command tests still pass.

package/specs/quiver-v29-planner-prepare-context-cli-ux/slices/slice-05-progressive-command-adoption/slice.json

@@ -0,0 +1,83 @@
+{
+  "slice_id": "slice-05-progressive-command-adoption",
+  "ticket": "QUIVER-29-05",
+  "type": "feature",
+  "title": "Progressive command adoption",
+  "objective": "Apply the new UX standard to selected high-value commands after `ai prepare-context` proves the pattern.",
+  "description": "Adds focused UX improvements to `ai plan`, `spec create`, and `ai pr` without redesigning the whole CLI.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v29-progressive-command-adoption",
+    "branch_name": "feature/QUIVER-29-05-v29-progressive-command-adoption"
+  },
+  "files": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/commands/spec.js",
+    "src/create-quiver/lib/ai/github.js",
+    "src/create-quiver/lib/ai/spec-generator.js",
+    "tests/commands/ai-plan.test.js",
+    "tests/commands/spec-create.test.js",
+    "tests/commands/ai-pr.test.js",
+    "tests/commands/ux-flags.test.js",
+    "specs/quiver-v29-planner-prepare-context-cli-ux/**"
+  ],
+  "expected_read_paths": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/commands/spec.js",
+    "src/create-quiver/lib/ai/**",
+    "tests/commands/ai-plan.test.js",
+    "tests/commands/spec-create.test.js",
+    "tests/commands/ai-pr.test.js"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/commands/spec.js",
+    "src/create-quiver/lib/ai/github.js",
+    "src/create-quiver/lib/ai/spec-generator.js",
+    "tests/commands/ai-plan.test.js",
+    "tests/commands/spec-create.test.js",
+    "tests/commands/ai-pr.test.js",
+    "tests/commands/ux-flags.test.js",
+    "specs/quiver-v29-planner-prepare-context-cli-ux/**"
+  ],
+  "depends_on": [
+    "slice-03-prepare-context-planner-review-flow",
+    "slice-04-ux-flag-matrix-compatibility"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "Touches multiple command integrations and should run after the prepare-context pattern stabilizes.",
+  "must": [
+    "Apply the standard to `ai plan` only where planner semantics are already natural.",
+    "Apply the standard to `spec create` with safe review/interactive guardrails.",
+    "Apply `--interactive` and `--review` to `ai pr` without adding `--with-planner`.",
+    "Keep non-interactive flag equivalents for every prompt.",
+    "Avoid changing command outputs in --json and CI modes."
+  ],
+  "not_included": [
+    "Full UX migration for all commands.",
+    "TUI dashboards.",
+    "Planner behavior for ai pr."
+  ],
+  "acceptance": [
+    "`ai plan` supports documented UX flags without breaking existing planner drafts.",
+    "`spec create` supports documented review/interactive guardrails where safe.",
+    "`ai pr` can review/edit PR body and interactive inputs without planner mode.",
+    "Existing tests for those commands still pass.",
+    "New tests cover unsupported and compatible flag combinations."
+  ],
+  "tests": [
+    "node --test tests/commands/ai-plan.test.js tests/commands/spec-create.test.js tests/commands/ai-pr.test.js tests/commands/ux-flags.test.js"
+  ],
+  "validation_hints": [
+    "Prefer minimal adoption over broad rewrites.",
+    "Keep generated artifacts backward compatible."
+  ],
+  "estimated_hours": 9,
+  "actual_hours": 4,
+  "status": "completed",
+  "completed_at": "2026-05-26"
+}

package/specs/quiver-v29-planner-prepare-context-cli-ux/slices/slice-06-docs-tests-smoke-readiness/CLOSURE_BRIEF.md

@@ -0,0 +1,31 @@
+# CLOSURE_BRIEF - slice-06 Docs, tests, smoke, and release readiness
+
+## Summary
+
+Completed final documentation, template, workflow, test, smoke, package, and tarball readiness for Quiver v29.
+
+## Validation Against Acceptance Criteria
+
+- Documentation now covers deterministic and planner-assisted `ai prepare-context`, guarded UX flags, review/interactive flows, color tokens, JSON/CI/no-TTY behavior, and command applicability.
+- `README_FOR_AI.md` is synchronized with implemented behavior and records v29 as implemented but pending package publication.
+- Generated templates now include planner-assisted context guidance and UX flag rules.
+- Full tests, focused tests, smoke commands, package validation, tarball dry-run, spec validation, handoff validation, JSON validation, and diff check passed.
+
+## Relevant Changes
+
+- Added `docs/CLI_UX_GUIDE.md`.
+- Updated `README.md`, `README_FOR_AI.md`, `docs/reference/commands.md`, generated templates, workflow guides, `CHANGELOG.md`, and `ROADMAP.md`.
+- Updated spec status, evidence, and slice metadata.
+
+## Pending Work
+
+- Npm publication and PR creation are outside this slice unless explicitly requested later.
+
+## Remaining Risks
+
+- Package version remains `0.14.0`; publication/version bump is intentionally outside this slice.
+- The npm CLI printed an update notice for npm `11.12.1 -> 11.15.0`; it did not block validation.
+
+## Future Recommendations
+
+- Use dogfooding findings from the first planner-assisted projects to scope the next UX adoption batch.

package/specs/quiver-v29-planner-prepare-context-cli-ux/slices/slice-06-docs-tests-smoke-readiness/EXECUTION_BRIEF.md

@@ -0,0 +1,50 @@
+# EXECUTION_BRIEF - slice-06 Docs, tests, smoke, and release readiness
+
+## Context
+
+This is the final Quiver v29 slice. It must reconcile implementation, documentation, generated templates, tests, and package safety.
+
+## Objective
+
+Close the spec with complete documentation and validation evidence.
+
+## Scope
+
+- Update public and AI-facing docs.
+- Add or update `docs/CLI_UX_GUIDE.md`.
+- Update command references and templates.
+- Run full tests and smoke commands.
+- Update spec status, evidence, and closure briefs.
+
+## Acceptance Criteria
+
+- Documentation matches implemented behavior.
+- README_FOR_AI.md remains source-of-truth aligned.
+- Tests and package smoke pass.
+- Any blocker is explicitly documented.
+
+## Suggested Steps
+
+1. Compare implementation against `SPEC.md`.
+2. Update docs and templates.
+3. Run focused tests, then full test suite.
+4. Run smoke/package commands.
+5. Update status/evidence/closure docs.
+
+## Restrictions
+
+- Do not add new behavior in this slice unless required to fix a validation failure from prior slices.
+- Do not publish npm.
+- Do not open PR.
+
+## Risks
+
+- Docs can easily drift from real behavior. Verify against `node bin/create-quiver.js --help`.
+
+## Completion Checklist
+
+- [ ] Docs synchronized.
+- [ ] Full tests run.
+- [ ] Smoke/package validation run.
+- [ ] Spec status updated.
+- [ ] Final risks recorded.

package/specs/quiver-v29-planner-prepare-context-cli-ux/slices/slice-06-docs-tests-smoke-readiness/slice.json

@@ -0,0 +1,95 @@
+{
+  "slice_id": "slice-06-docs-tests-smoke-readiness",
+  "ticket": "QUIVER-29-06",
+  "type": "docs",
+  "title": "Docs, tests, smoke, and release readiness",
+  "objective": "Close the spec by synchronizing documentation, templates, tests, package safety, and release evidence.",
+  "description": "Ensures the implemented CLI UX standard and planner-assisted prepare-context flow are documented, tested, and package-ready.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v29-docs-tests-smoke-readiness",
+    "branch_name": "feature/QUIVER-29-06-v29-docs-tests-smoke-readiness"
+  },
+  "files": [
+    "README.md",
+    "README_FOR_AI.md",
+    "CHANGELOG.md",
+    "ROADMAP.md",
+    "docs/COMMANDS.md.template",
+    "docs/AI_CONTEXT.md.template",
+    "docs/AI_ONBOARDING_PROMPT.md.template",
+    "docs/CLI_UX_GUIDE.md",
+    "docs/reference/commands.md",
+    "docs/workflows/*.md",
+    "tests/**",
+    "specs/quiver-v29-planner-prepare-context-cli-ux/**"
+  ],
+  "expected_read_paths": [
+    "README.md",
+    "README_FOR_AI.md",
+    "docs/**",
+    "tests/**",
+    "scripts/package-quiver.sh",
+    "scripts/ci/**"
+  ],
+  "allowed_write_paths": [
+    "README.md",
+    "README_FOR_AI.md",
+    "CHANGELOG.md",
+    "ROADMAP.md",
+    "docs/COMMANDS.md.template",
+    "docs/AI_CONTEXT.md.template",
+    "docs/AI_ONBOARDING_PROMPT.md.template",
+    "docs/CLI_UX_GUIDE.md",
+    "docs/reference/commands.md",
+    "docs/workflows/*.md",
+    "tests/**",
+    "specs/quiver-v29-planner-prepare-context-cli-ux/**"
+  ],
+  "depends_on": [
+    "slice-02-planner-context-proposal-contract",
+    "slice-03-prepare-context-planner-review-flow",
+    "slice-04-ux-flag-matrix-compatibility",
+    "slice-05-progressive-command-adoption"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "Final validation and docs sync must run after all behavior slices.",
+  "must": [
+    "Document the UX standard, color tokens, and flag matrix.",
+    "Document deterministic and planner-assisted prepare-context flows.",
+    "Update generated templates where needed.",
+    "Run full test and smoke suite.",
+    "Record validation evidence in the spec.",
+    "Keep README_FOR_AI.md synchronized with implemented behavior."
+  ],
+  "not_included": [
+    "Publishing npm.",
+    "Opening the final PR.",
+    "Adding new behavior beyond closing docs/tests."
+  ],
+  "acceptance": [
+    "Docs do not contradict implemented command behavior.",
+    "Generated docs/templates include the new UX and planner guidance.",
+    "Full tests and smoke commands pass or documented blockers are explicit.",
+    "Package/tarball dry-run is clean.",
+    "Spec status and closure briefs reflect final implementation state."
+  ],
+  "tests": [
+    "node --test tests/**/*.test.js",
+    "npm run smoke:create-quiver",
+    "npm run smoke:doctor-fixtures",
+    "npm run smoke:guided-workflow",
+    "npm run package:quiver",
+    "npm pack --dry-run",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Run this slice last.",
+    "Check README_FOR_AI.md against actual CLI behavior before closing."
+  ],
+  "estimated_hours": 6,
+  "actual_hours": 4,
+  "status": "completed",
+  "completed_at": "2026-05-26"
+}