create-quiver 0.16.0 → 0.17.1

package/specs/quiver-v46-deep-project-analysis/slices/slice-04-validation-docs-release-readiness/CLOSURE_BRIEF.md

@@ -0,0 +1,20 @@
+# CLOSURE_BRIEF - slice-04 Validation, docs, fixtures, and release readiness
+
+## Summary
+
+Implemented the release-readiness layer for `ai analyze-project`: post-write validation, public docs, fixture coverage, command matrix updates, and package readiness hardening. Validation now checks analysis/doc proposal schemas, evidence paths, managed-block presence, critical placeholders, snapshot manifest entries, and deterministic conflicts between `docs/PROJECT_MAP.md` and context docs. `--strict` turns important deterministic doc conflicts into errors. Public docs now describe read-only defaults, privacy exclusions, provider/review gates, budgets, scope, JSON output, limitations, and safe write behavior.
+
+## Validation
+
+- [x] `node --test`
+- [x] `npm run smoke:create-quiver`
+- [x] `npm run package:quiver`
+- [x] `node bin/create-quiver.js spec validate specs/quiver-v46-deep-project-analysis --strict`
+- [x] `git diff --check`
+
+## Closure Notes
+
+- Fixture coverage is documented in `tests/fixtures/ai-analyze-project/matrix.json` and exercised by discovery, parser, provider, review, and validation tests.
+- The package smoke initially failed because local `.quiver/runs` state was included in the npm tarball. `.npmignore` now excludes `.quiver/`, and package smoke passes.
+- Deferred follow-up: full human-output i18n for `ai analyze-project`; this is recorded as an accepted exception in the v43 command language matrix. JSON output remains stable.
+- Deferred follow-up: stack-specific adapters such as Rails, Django, Laravel, NestJS, Spring, and mobile can improve sampling later without changing the v46 schema.

package/specs/quiver-v46-deep-project-analysis/slices/slice-04-validation-docs-release-readiness/EXECUTION_BRIEF.md

@@ -0,0 +1,32 @@
+# EXECUTION_BRIEF - slice-04 Validation, docs, fixtures, and release readiness
+
+## Context
+
+The feature can discover, analyze, review, and safely write docs after slices 01-03. This final slice makes the behavior releasable and documented.
+
+## Objective
+
+Add post-write validation, public docs, fixtures, smokes, and final release-readiness evidence.
+
+## Acceptance Criteria
+
+- Post-write validation checks schema, placeholders, evidence paths, deterministic-doc conflicts, and strict-mode behavior.
+- `--strict` turns important conflicts into errors.
+- Public docs explain read-only default, privacy preflight, review/write gates, budgets, scope, limitations, and JSON output.
+- Fixtures cover Next/Supabase, unknown stack, monorepo, secrets, binaries, large repo, no package manager, symlinks, truncation, and invalid provider JSON.
+- Package and smoke validation pass.
+- v46 evidence report and status are updated.
+
+## Production Guardrails
+
+- Do not claim perfect project understanding.
+- Document insufficient-evidence behavior and `--input <requirements.md>` usage.
+- Preserve clean automation output.
+
+## Completion Checklist
+
+- [ ] Validation module added.
+- [ ] Docs updated.
+- [ ] Fixtures and smokes added.
+- [ ] Final evidence captured.
+- [ ] Spec marked ready/completed as appropriate.

package/specs/quiver-v46-deep-project-analysis/slices/slice-04-validation-docs-release-readiness/slice.json

@@ -0,0 +1,85 @@
+{
+  "slice_id": "slice-04-validation-docs-release-readiness",
+  "ticket": "QUIVER-46-04",
+  "type": "release-readiness",
+  "title": "Validation, docs, fixtures, and release readiness",
+  "objective": "Complete post-write validation, public documentation, fixtures, smokes, and release evidence for ai analyze-project.",
+  "description": "Adds consistency validation, placeholder checks, docs updates, command reference updates, fixture coverage, smoke tests, and final package readiness evidence.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v46-validation-docs-readiness",
+    "branch_name": "feature/QUIVER-46-04-v46-validation-docs-readiness"
+  },
+  "files": [
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/lib/ai/analyze-project-validation.js",
+    ".npmignore",
+    "docs/**",
+    "README.md",
+    "README_FOR_AI.md",
+    "tests/**",
+    "scripts/ci/**",
+    "specs/quiver-v46-deep-project-analysis/**"
+  ],
+  "expected_read_paths": [
+    "docs/CLI_UX_GUIDE.md",
+    "docs/reference/commands.md",
+    "README.md",
+    "README_FOR_AI.md",
+    "scripts/ci",
+    "tests"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/lib/ai/analyze-project-validation.js",
+    ".npmignore",
+    "docs/**",
+    "README.md",
+    "README_FOR_AI.md",
+    "tests/**",
+    "scripts/ci/**",
+    "specs/quiver-v46-deep-project-analysis/**"
+  ],
+  "depends_on": [
+    "slice-03-doc-proposal-review-safe-writes"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "Final validation and docs depend on the completed runtime behavior.",
+  "must": [
+    "Validate post-write schema and evidence paths.",
+    "Check placeholders and doc conflicts, with --strict converting important conflicts to errors.",
+    "Document command usage, safe defaults, privacy preflight, review flow, JSON output, budgets, scope, and limitations.",
+    "Add fixture coverage for Next/Supabase, unknown stack, monorepo, secrets, binary files, large repo, no package manager, symlinks, truncation, and invalid provider JSON.",
+    "Update command reference and AI guidance.",
+    "Capture final validation evidence."
+  ],
+  "not_included": [
+    "New product feature implementation in target projects.",
+    "Full language-specific AST indexing.",
+    "Provider-specific account setup docs beyond existing Quiver provider guidance."
+  ],
+  "acceptance": [
+    "Post-write validation reports schema, placeholders, evidence path issues, and doc conflicts.",
+    "--strict turns important conflicts into failures.",
+    "Public docs describe default read-only behavior and explicit write gates.",
+    "Fixtures cover production-risk edge cases.",
+    "Package and smoke validation pass.",
+    "Spec status and evidence report are updated with final commands."
+  ],
+  "tests": [
+    "node --test tests/**/*.test.js",
+    "npm run smoke:create-quiver",
+    "npm run package:quiver",
+    "node bin/create-quiver.js spec validate specs/quiver-v46-deep-project-analysis --strict",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Run docs command reference checks if available.",
+    "Verify --json output remains clean in every tested mode."
+  ],
+  "estimated_hours": 8,
+  "status": "completed",
+  "completed_at": "2026-06-10",
+  "blocked_reason": null
+}