create-quiver 0.12.0 → 0.12.1

package/specs/quiver-v26-0121-smoke-hardening/slices/slice-07-smoke-release-readiness/EXECUTION_BRIEF.md

@@ -0,0 +1,55 @@
+# EXECUTION BRIEF - slice-07: Smoke and release readiness
+
+## Context
+
+This final slice proves the hotfix is ready for PR, merge, and later npm publication. It should not publish npm itself.
+
+## Objective
+
+Run full validation, prepare `0.12.1` package metadata, perform candidate tarball smoke, and record evidence.
+
+## Scope
+
+- Version metadata.
+- Changelog/release notes.
+- Test and smoke scripts if needed.
+- Evidence report and PR body.
+
+## Acceptance Criteria
+
+- Full test suite passes.
+- Required smokes pass.
+- Candidate tarball smoke passes from `/private/tmp`.
+- Package metadata targets `0.12.1`.
+- Evidence and PR body are updated.
+
+## Technical Plan Summary
+
+Integrate all previous slices, run package safety and clean install smoke, then update release artifacts for PR review.
+
+## Suggested Execution Steps
+
+1. Confirm all prior slices are complete.
+2. Bump package metadata to `0.12.1`.
+3. Run full test and smoke suite.
+4. Run `npm pack` and smoke the tarball from `/private/tmp`.
+5. Update `EVIDENCE_REPORT.md`, `STATUS.md`, `CHANGELOG.md`, and `pr.md`.
+6. Leave npm publication for post-merge release.
+
+## Restrictions
+
+- Do not publish npm.
+- Do not create the real demo project in `/Prueba`.
+- Do not ignore failed smoke output.
+
+## Risks
+
+- Tarball smoke may reveal packaging-only issues not covered by local tests.
+
+## Completion Checklist
+
+- [ ] Full tests passed.
+- [ ] Smokes passed.
+- [ ] Tarball smoke passed.
+- [ ] Evidence recorded.
+- [ ] Version metadata ready.

package/specs/quiver-v26-0121-smoke-hardening/slices/slice-07-smoke-release-readiness/slice.json

@@ -0,0 +1,92 @@
+{
+  "slice_id": "slice-07-smoke-release-readiness",
+  "ticket": "QUIVER-26-07",
+  "type": "release",
+  "title": "Smoke and release readiness",
+  "objective": "Validate the hotfix end to end, prepare 0.12.1 package metadata, and record evidence before PR and publication.",
+  "description": "Run the full validation suite, candidate tarball smoke, documentation sync, version bump, evidence updates, and release-readiness checks.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "smoke-release-readiness",
+    "branch_name": "feature/QUIVER-26-07-smoke-release-readiness"
+  },
+  "files": [
+    "package.json",
+    "package-lock.json",
+    "CHANGELOG.md",
+    "README_FOR_AI.md",
+    "ROADMAP.md",
+    "scripts/ci/**",
+    "specs/quiver-v26-0121-smoke-hardening/**",
+    "tests/**"
+  ],
+  "expected_read_paths": [
+    "package.json",
+    "package-lock.json",
+    "CHANGELOG.md",
+    "scripts/release-quiver.sh",
+    "scripts/package-quiver.sh",
+    "scripts/ci/**",
+    "specs/quiver-v26-0121-smoke-hardening/EVIDENCE_REPORT.md"
+  ],
+  "allowed_write_paths": [
+    "package.json",
+    "package-lock.json",
+    "CHANGELOG.md",
+    "README_FOR_AI.md",
+    "ROADMAP.md",
+    "scripts/ci/**",
+    "specs/quiver-v26-0121-smoke-hardening/**",
+    "tests/**"
+  ],
+  "depends_on": [
+    "slice-01-cli-help-version-contract",
+    "slice-02-init-doc-links-and-flow-guidance",
+    "slice-03-ai-approval-review-consistency",
+    "slice-04-local-validation-brief-contracts",
+    "slice-05-demo-scaffold-readiness",
+    "slice-06-plan-graph-scope-performance"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "Final integration and release readiness must run after every implementation slice.",
+  "must": [
+    "Bump package metadata to 0.12.1 only after implementation slices are complete.",
+    "Run full local tests and smokes.",
+    "Run candidate tarball smoke from a clean temp directory.",
+    "Record evidence and remaining risks.",
+    "Prepare PR body and release notes without publishing npm."
+  ],
+  "not_included": [
+    "Publishing npm before PR merge.",
+    "Creating the real Quiver Spec Viewer project.",
+    "Skipping failed smoke results."
+  ],
+  "acceptance": [
+    "node --test tests/**/*.test.js passes.",
+    "npm run smoke:create-quiver passes.",
+    "npm run smoke:guided-workflow passes.",
+    "npm run smoke:doctor-fixtures passes.",
+    "git diff --check passes.",
+    "Candidate tarball smoke validates init, analyze, doctor, flow, AI dry-runs, demo, and validate.",
+    "CHANGELOG.md and evidence report document 0.12.1 readiness."
+  ],
+  "tests": [
+    "node --test tests/**/*.test.js",
+    "npm run smoke:create-quiver",
+    "npm run smoke:guided-workflow",
+    "npm run smoke:doctor-fixtures",
+    "npm pack",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Use /private/tmp for tarball smoke.",
+    "Do not rely on the local checkout path for candidate validation.",
+    "After merge and publish, verify npm with npm view create-quiver version."
+  ],
+  "estimated_hours": 4,
+  "status": "completed",
+  "blocked_reason": null,
+  "actual_hours": 3,
+  "completed_at": "2026-05-23T00:00:00-0300"
+}