create-quiver 0.15.3 → 0.16.0

package/specs/quiver-v50-audit-trust-foundation/slices/slice-05-init-analyze-progress-and-summaries/CLOSURE_BRIEF.md

@@ -0,0 +1,25 @@
+# CLOSURE_BRIEF - slice-05 init/analyze progress and summaries
+
+## Summary
+
+Added safe transient progress for `init` and `analyze` using `createUx.withSpinner(..., { echo: false })`, preserving existing final summaries and suppressing progress in no-TTY, CI, JSON, and `--no-color` paths. The repo does not have separate `commands/init.js` or `commands/analyze.js`; both flows are implemented in `src/create-quiver/index.js`.
+
+## Validation
+
+- [x] `node --test tests/commands/analyze.test.js`
+- [x] `node --test tests/commands/init-profiles.test.js`
+- [x] `node --test tests/lib/cli-ux.test.js tests/lib/i18n-catalog.test.js`
+- [x] `node --test`
+- [x] `git diff --check`
+- [x] `node bin/create-quiver.js spec validate specs/quiver-v50-audit-trust-foundation`
+- [x] `node bin/create-quiver.js check-slice specs/quiver-v50-audit-trust-foundation/slices/slice-05-init-analyze-progress-and-summaries/slice.json --local`
+
+## Closure Conditions
+
+- [x] TTY progress added safely.
+- [x] CI/no-TTY/JSON/no-color behavior preserved by tests and `echo:false` contract.
+- [x] Stable summaries and i18n complete for new messages.
+
+## Open Items
+
+- None.

package/specs/quiver-v50-audit-trust-foundation/slices/slice-05-init-analyze-progress-and-summaries/EXECUTION_BRIEF.md

@@ -0,0 +1,73 @@
+# EXECUTION_BRIEF - slice-05 init/analyze progress and summaries
+
+## Context
+
+`init` and `analyze` are onboarding commands. They need feedback for humans without contaminating CI, JSON, no-TTY, or no-color flows.
+
+## Objective
+
+Add safe progress feedback and stable summaries to onboarding commands.
+
+## Scope
+
+- `init` progress and summary.
+- `analyze` progress and summary.
+- UX mode detection.
+- EN/ES messages.
+- Tests for TTY/no-TTY/CI/JSON/no-color behavior.
+
+## Acceptance Criteria
+
+- Progress appears only in safe TTY conditions.
+- Progress does not appear in `CI=true`, no-TTY, `--json`, or `--no-color`.
+- Final summaries remain in normal human output.
+- JSON outputs remain clean.
+- New messages are localized.
+
+## Expected Files To Modify
+
+- `src/create-quiver/commands/init.js`
+- `src/create-quiver/commands/analyze.js`
+- `src/create-quiver/index.js`
+- `src/create-quiver/lib/cli/ux.js`
+- `src/create-quiver/lib/i18n/messages/en.js`
+- `src/create-quiver/lib/i18n/messages/es.js`
+- `tests/commands/analyze.test.js`
+- `tests/commands/init-profiles.test.js`
+- `tests/lib/cli-ux.test.js`
+- `specs/quiver-v50-audit-trust-foundation/EVIDENCE_REPORT.md`
+
+## Validations Required
+
+- `node --test tests/commands/analyze.test.js`
+- `node --test tests/commands/init-profiles.test.js`
+- `node --test tests/lib/cli-ux.test.js`
+- `node --test`
+- `git diff --check`
+
+## Risks
+
+- Spinner/progress noise in CI.
+- Accidentally suppressing useful final summaries.
+- Snapshot drift in existing tests.
+
+## Dependencies
+
+- Depends on `slice-00-audit-baseline-and-resolved-findings`.
+- Depends on `slice-04-user-facing-i18n-error-coverage`.
+
+## Instructions For Executor
+
+1. Use existing UX helpers where possible.
+2. Keep transient progress separate from final summary output.
+3. Test stdout/stderr behavior explicitly.
+
+## Completion Checklist
+
+- [ ] Acceptance criteria satisfied.
+- [ ] Required validations run or blockers documented.
+- [ ] Closure brief updated.
+
+## Conditions Of Closure
+
+- Onboarding commands feel responsive without breaking automation.

package/specs/quiver-v50-audit-trust-foundation/slices/slice-05-init-analyze-progress-and-summaries/slice.json

@@ -0,0 +1,72 @@
+{
+  "slice_id": "slice-05-init-analyze-progress-and-summaries",
+  "ticket": "QUIVER-50-05",
+  "type": "feature",
+  "title": "Init/analyze progress and summaries",
+  "objective": "Add safe progress feedback and stable summaries to onboarding commands.",
+  "description": "Improves perceived responsiveness for init and analyze while preserving JSON, CI, no-TTY, and no-color behavior.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v50-init-analyze-progress",
+    "branch_name": "feature/QUIVER-50-05-v50-init-analyze-progress"
+  },
+  "files": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/cli/ux.js",
+    "src/create-quiver/lib/i18n/messages/en.js",
+    "src/create-quiver/lib/i18n/messages/es.js",
+    "tests/commands/init*.test.js",
+    "tests/commands/analyze.test.js",
+    "tests/lib/cli-ux.test.js",
+    "specs/quiver-v50-audit-trust-foundation/**"
+  ],
+  "expected_read_paths": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/cli/ux.js",
+    "tests/commands/analyze.test.js",
+    "tests/commands/init-profiles.test.js"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/**",
+    "tests/**",
+    "specs/quiver-v50-audit-trust-foundation/**"
+  ],
+  "depends_on": [
+    "slice-00-audit-baseline-and-resolved-findings",
+    "slice-04-user-facing-i18n-error-coverage"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "Progress messages share i18n and UX behavior with slice-04.",
+  "must": [
+    "Show transient progress only in safe TTY conditions.",
+    "Preserve final summaries in normal human output.",
+    "Suppress progress frames in JSON, no-TTY, CI=true, and --no-color.",
+    "Localize new human messages."
+  ],
+  "not_included": [
+    "Changing init/analyze core logic.",
+    "Adding progress to unrelated commands."
+  ],
+  "acceptance": [
+    "TTY users see progress during slow phases.",
+    "CI/no-TTY/JSON/no-color do not receive transient progress.",
+    "Stable final summaries remain in normal human output.",
+    "Tests distinguish progress from final summaries."
+  ],
+  "tests": [
+    "node --test tests/commands/analyze.test.js",
+    "node --test tests/commands/init-profiles.test.js",
+    "node --test tests/lib/cli-ux.test.js tests/lib/i18n-catalog.test.js",
+    "node --test",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "If using createUx.withSpinner, ensure fallback echo does not create progress noise in CI."
+  ],
+  "estimated_hours": 5,
+  "status": "completed",
+  "blocked_reason": null,
+  "actual_hours": 5,
+  "completed_at": "2026-06-01T22:59:17-0300"
+}

package/specs/quiver-v50-audit-trust-foundation/slices/slice-06-contributor-and-architecture-docs/CLOSURE_BRIEF.md

@@ -0,0 +1,22 @@
+# CLOSURE_BRIEF - slice-06 contributor and architecture docs
+
+## Summary
+
+Expanded contributor documentation and added a real architecture guide aligned to the current CLI, package scripts, templates, specs, tests, CI, and npm package boundary.
+
+## Validation
+
+- [x] `node bin/create-quiver.js --help`
+- [x] `git diff --check`
+- [x] `node bin/create-quiver.js spec validate specs/quiver-v50-audit-trust-foundation`
+- [x] `node bin/create-quiver.js check-slice specs/quiver-v50-audit-trust-foundation/slices/slice-06-contributor-and-architecture-docs/slice.json --local`
+
+## Closure Conditions
+
+- [x] CONTRIBUTING expanded.
+- [x] ARCHITECTURE created.
+- [x] Public docs aligned with real commands and spec structure.
+
+## Open Items
+
+- None.

package/specs/quiver-v50-audit-trust-foundation/slices/slice-06-contributor-and-architecture-docs/EXECUTION_BRIEF.md

@@ -0,0 +1,66 @@
+# EXECUTION_BRIEF - slice-06 contributor and architecture docs
+
+## Context
+
+Contributor documentation must reflect the real CLI, package, test, and spec structure. This repo uses `specs/quiver-vNN-*`, not `docs/specs`.
+
+## Objective
+
+Make contribution and architecture documentation accurate enough for external contributors.
+
+## Scope
+
+- `CONTRIBUTING.md`.
+- `ARCHITECTURE.md`.
+- Public docs cleanup.
+- Templates/examples explanation.
+- Package boundary explanation.
+
+## Acceptance Criteria
+
+- A new contributor can set up and run tests using `CONTRIBUTING.md`.
+- `ARCHITECTURE.md` documents real entrypoints and layers.
+- Spec convention is documented as `specs/quiver-vNN-*`.
+- Commands mentioned exist in current `--help`.
+- Public docs avoid unexplained internal `vNN` references.
+
+## Expected Files To Modify
+
+- `CONTRIBUTING.md`
+- `ARCHITECTURE.md`
+- `README.md`
+- `ROADMAP.md`
+- `docs/CLI_UX_GUIDE.md`
+- `docs/reference/commands.md`
+- `specs/quiver-v50-audit-trust-foundation/EVIDENCE_REPORT.md`
+
+## Validations Required
+
+- `node bin/create-quiver.js --help`
+- `git diff --check`
+
+## Risks
+
+- Documenting idealized architecture instead of actual code.
+- Introducing stale command references.
+- Mixing internal dogfooding details into public docs.
+
+## Dependencies
+
+- Depends on `slice-00-audit-baseline-and-resolved-findings`.
+
+## Instructions For Executor
+
+1. Inspect code and package scripts before writing docs.
+2. Distinguish user npm behavior from contributor repo behavior.
+3. Keep docs actionable and concise.
+
+## Completion Checklist
+
+- [ ] Acceptance criteria satisfied.
+- [ ] Required validations run or blockers documented.
+- [ ] Closure brief updated.
+
+## Conditions Of Closure
+
+- External contributors can understand and work on Quiver without reverse-engineering the repo.

package/specs/quiver-v50-audit-trust-foundation/slices/slice-06-contributor-and-architecture-docs/slice.json

@@ -0,0 +1,74 @@
+{
+  "slice_id": "slice-06-contributor-and-architecture-docs",
+  "ticket": "QUIVER-50-06",
+  "type": "documentation",
+  "title": "Contributor and architecture docs",
+  "objective": "Make contribution and architecture documentation accurate enough for external contributors.",
+  "description": "Expands CONTRIBUTING.md and creates ARCHITECTURE.md based on the real CLI/package/spec structure.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v50-contributor-architecture-docs",
+    "branch_name": "feature/QUIVER-50-06-v50-contributor-architecture-docs"
+  },
+  "files": [
+    "CONTRIBUTING.md",
+    "ARCHITECTURE.md",
+    "README.md",
+    "ROADMAP.md",
+    "docs/CLI_UX_GUIDE.md",
+    "docs/reference/commands.md",
+    "specs/quiver-v50-audit-trust-foundation/**"
+  ],
+  "expected_read_paths": [
+    "README.md",
+    "README_FOR_AI.md",
+    "package.json",
+    "src/create-quiver/**",
+    "specs/quiver-v49-parser-modernization/**",
+    "scripts/package-quiver.sh",
+    ".npmignore"
+  ],
+  "allowed_write_paths": [
+    "CONTRIBUTING.md",
+    "ARCHITECTURE.md",
+    "README.md",
+    "ROADMAP.md",
+    "docs/**",
+    "specs/quiver-v50-audit-trust-foundation/**"
+  ],
+  "depends_on": [
+    "slice-00-audit-baseline-and-resolved-findings"
+  ],
+  "parallel_safe": "yes",
+  "parallel_safe_reason": "Docs work can run independently after baseline, but must stay aligned with real commands.",
+  "must": [
+    "Document real setup, tests, smokes, commits, and PR process.",
+    "Document real architecture and package boundaries.",
+    "Document specs/quiver-vNN-* as the real spec convention.",
+    "Explain templates and examples.",
+    "Clean public references to internal vNN wording where needed."
+  ],
+  "not_included": [
+    "Creating a docs site.",
+    "Changing CLI behavior."
+  ],
+  "acceptance": [
+    "A contributor can set up and run tests from CONTRIBUTING.md.",
+    "ARCHITECTURE.md describes real entrypoints, layers, specs, and package boundaries.",
+    "Docs mention only commands that exist in current help.",
+    "Public docs avoid unexplained internal version references."
+  ],
+  "tests": [
+    "node bin/create-quiver.js --help",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Do not document docs/specs as canonical; this repo uses specs/quiver-vNN-*."
+  ],
+  "estimated_hours": 5,
+  "status": "completed",
+  "blocked_reason": null,
+  "actual_hours": 3,
+  "completed_at": "2026-06-01T22:13:40-0300"
+}

package/specs/quiver-v50-audit-trust-foundation/slices/slice-07-ci-and-documentation-lint-baseline/CLOSURE_BRIEF.md

@@ -0,0 +1,29 @@
+# CLOSURE_BRIEF - slice-07 CI and documentation lint baseline
+
+## Summary
+
+Added a portable CI/docs baseline: shell-free Node test wrapper, explicit docs lint/link wrappers, markdown configs with non-flaky local-link scope, npm scripts for local parity, CI `tests`/`docs` jobs, and Windows `pwsh` coverage for a portable CLI/test path.
+
+## Validation
+
+- [x] `npm ci`
+- [x] `npm run docs:lint`
+- [x] `npm run docs:links`
+- [x] `npm run docs:check`
+- [x] `npm run test:ci -- tests/lib/paths.test.js`
+- [x] `node --test`
+- [x] `npm run package:quiver`
+- [x] `git diff --check`
+- [x] `node bin/create-quiver.js spec validate specs/quiver-v50-audit-trust-foundation`
+- [x] `node bin/create-quiver.js check-slice specs/quiver-v50-audit-trust-foundation/slices/slice-07-ci-and-documentation-lint-baseline/slice.json --local`
+
+## Closure Conditions
+
+- [x] CI hardened.
+- [x] Docs lint/link checks controlled.
+- [x] Windows PowerShell path validated through CI workflow coverage.
+- [x] Lockfile synchronized.
+
+## Open Items
+
+- Local `pwsh` was not available on this machine; CI includes the Windows-only `pwsh` coverage required by the slice.

package/specs/quiver-v50-audit-trust-foundation/slices/slice-07-ci-and-documentation-lint-baseline/EXECUTION_BRIEF.md

@@ -0,0 +1,74 @@
+# EXECUTION_BRIEF - slice-07 CI and documentation lint baseline
+
+## Context
+
+CI exists but must be hardened for production-quality PR validation without introducing flaky docs gates.
+
+## Objective
+
+Harden CI with portable tests, docs lint, link checks, and Windows PowerShell coverage.
+
+## Scope
+
+- GitHub Actions.
+- `npm ci`.
+- Portable test runner.
+- OS matrix and Windows `pwsh`.
+- Markdown lint/link check baseline.
+- Local check documentation.
+
+## Acceptance Criteria
+
+- CI runs `npm ci`.
+- Tests run without shell glob expansion.
+- Windows `pwsh` validates a portable path.
+- Docs lint/link checks have controlled, non-flaky scope.
+- `package-lock.json` is synchronized.
+- Local equivalent commands are documented.
+
+## Expected Files To Modify
+
+- `.github/workflows/ci.yml`
+- `.markdownlint.json`
+- `.markdown-link-check.json`
+- `package.json`
+- `package-lock.json`
+- `CONTRIBUTING.md`
+- `scripts/ci/**`
+- `specs/quiver-v50-audit-trust-foundation/EVIDENCE_REPORT.md`
+
+## Validations Required
+
+- `npm ci`
+- `node --test`
+- `npm run package:quiver`
+- `git diff --check`
+
+## Risks
+
+- Flaky external link checks.
+- PowerShell path failures.
+- Unsynchronized lockfile.
+- Large unrelated markdown churn.
+
+## Dependencies
+
+- Depends on `slice-01-runtime-minimum-and-package-metadata`.
+- Depends on `slice-06-contributor-and-architecture-docs`.
+
+## Instructions For Executor
+
+1. Prefer portable Node-based scripts over shell-specific globs.
+2. Keep docs lint scope small and explicit.
+3. Document any non-blocking external link check decision.
+4. Verify lockfile sync.
+
+## Completion Checklist
+
+- [ ] Acceptance criteria satisfied.
+- [ ] Required validations run or blockers documented.
+- [ ] Closure brief updated.
+
+## Conditions Of Closure
+
+- CI is a trustworthy gate without becoming noisy or flaky.

package/specs/quiver-v50-audit-trust-foundation/slices/slice-07-ci-and-documentation-lint-baseline/slice.json

@@ -0,0 +1,81 @@
+{
+  "slice_id": "slice-07-ci-and-documentation-lint-baseline",
+  "ticket": "QUIVER-50-07",
+  "type": "automation",
+  "title": "CI and documentation lint baseline",
+  "objective": "Harden CI with portable tests, docs lint, link checks, and Windows PowerShell coverage.",
+  "description": "Improves CI without introducing flaky external link failures or broad documentation churn.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v50-ci-docs-lint-baseline",
+    "branch_name": "feature/QUIVER-50-07-v50-ci-docs-lint-baseline"
+  },
+  "files": [
+    ".github/workflows/ci.yml",
+    ".markdownlint.json",
+    ".markdown-link-check.json",
+    "package.json",
+    "package-lock.json",
+    "CONTRIBUTING.md",
+    "scripts/ci/**",
+    "specs/quiver-v50-audit-trust-foundation/**"
+  ],
+  "expected_read_paths": [
+    ".github/workflows/ci.yml",
+    "package.json",
+    "package-lock.json",
+    "scripts/ci/**",
+    "CONTRIBUTING.md"
+  ],
+  "allowed_write_paths": [
+    ".github/workflows/ci.yml",
+    ".markdownlint.json",
+    ".markdown-link-check.json",
+    "package.json",
+    "package-lock.json",
+    "CONTRIBUTING.md",
+    "scripts/ci/**",
+    "specs/quiver-v50-audit-trust-foundation/**"
+  ],
+  "depends_on": [
+    "slice-01-runtime-minimum-and-package-metadata",
+    "slice-06-contributor-and-architecture-docs"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "CI depends on package metadata and docs baseline.",
+  "must": [
+    "Run npm ci in CI.",
+    "Use portable test runner without shell glob expansion.",
+    "Add Windows pwsh coverage for portable commands.",
+    "Adopt docs lint/link checks with controlled scope.",
+    "Keep package-lock.json synchronized."
+  ],
+  "not_included": [
+    "npm publish automation.",
+    "Aggressive markdown reformatting.",
+    "Flaky blocking external link checks."
+  ],
+  "acceptance": [
+    "CI validates tests and smokes on supported OS matrix.",
+    "Windows pwsh runs at least one portable npm/CLI path.",
+    "Docs lint/link checks have explicit non-flaky scope.",
+    "Local equivalent commands are documented."
+  ],
+  "tests": [
+    "npm ci",
+    "npm run docs:check",
+    "npm run test:ci -- tests/lib/paths.test.js",
+    "node --test",
+    "npm run package:quiver",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "If external link checking is unstable, make external checks informational for this slice."
+  ],
+  "estimated_hours": 8,
+  "actual_hours": 6,
+  "status": "completed",
+  "completed_at": "2026-06-01T23:07:41-0300",
+  "blocked_reason": null
+}