create-quiver 0.5.0 → 0.7.0

package/specs/quiver-v11-existing-project-migration/slices/slice-02-version-metadata-doctor-upgrade-checks/slice.json

@@ -0,0 +1,71 @@
+{
+  "slice_id": "slice-02-version-metadata-doctor-upgrade-checks",
+  "ticket": "QUIVER-02",
+  "type": "feature",
+  "title": "Version Metadata and Doctor Upgrade Checks",
+  "objective": "Record Quiver project state and teach `doctor` to identify projects that need migration or analysis.",
+  "description": "After migration exists, Quiver needs a durable way to know which template version initialized or migrated the project. This slice adds metadata and extends doctor diagnostics so users get the right next command instead of guessing.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "existing-project-migration",
+    "branch_name": "feature/QUIVER-02-existing-project-migration"
+  },
+  "must": [
+    "Create or update a project-local metadata file such as `.quiver/state.json`",
+    "Record initialized version, migrated version, last migration date, and last analysis date where available",
+    "Update `init`, `migrate`, and `analyze` to maintain metadata",
+    "Teach `doctor` to report missing metadata without failing older projects unnecessarily",
+    "Teach `doctor` to recommend `npx create-quiver migrate --dir .` when required upgrade artifacts are missing",
+    "Keep metadata deterministic and free of secrets"
+  ],
+  "not_included": [
+    "Remote telemetry",
+    "User identity tracking",
+    "AI-generated metadata",
+    "Changing package publish flow"
+  ],
+  "acceptance": [
+    "Newly initialized projects include Quiver metadata",
+    "Migrated projects update metadata",
+    "`analyze` updates last analysis metadata",
+    "`doctor` distinguishes missing analysis from missing migration",
+    "Older projects without metadata receive a clear migration recommendation",
+    "Metadata contains no absolute secrets or credential values"
+  ],
+  "files": [
+    "src/create-quiver/index.js",
+    "scripts/ci/smoke-create-quiver.sh",
+    "scripts/ci/smoke-init-docs.sh",
+    "scripts/package-quiver.sh",
+    "specs/quiver-v11-existing-project-migration/STATUS.md",
+    "specs/quiver-v11-existing-project-migration/EVIDENCE_REPORT.md",
+    "specs/quiver-v11-existing-project-migration/slices/slice-02-version-metadata-doctor-upgrade-checks/slice.json"
+  ],
+  "tests": [
+    "init smoke verifies `.quiver/state.json`",
+    "migrate smoke verifies migration metadata",
+    "analyze smoke verifies last analysis metadata",
+    "doctor smoke verifies migration recommendation",
+    "git diff --check"
+  ],
+  "documentation": [
+    "specs/quiver-v11-existing-project-migration/STATUS.md",
+    "specs/quiver-v11-existing-project-migration/EVIDENCE_REPORT.md"
+  ],
+  "dependencies": [
+    "slice-01-non-destructive-migrate-command"
+  ],
+  "assumptions": [
+    "A local metadata file is simpler and more reliable than parsing docs for version state",
+    "Metadata should supplement, not replace, user-facing docs",
+    "Doctor should guide remediation but not run migration automatically"
+  ],
+  "estimated_hours": 4,
+  "actual_hours": 4,
+  "status": "completed",
+  "blocked_reason": null,
+  "ready_at": null,
+  "started_at": "2026-04-22T00:00:00Z",
+  "completed_at": "2026-04-22T00:00:00Z"
+}

package/specs/quiver-v11-existing-project-migration/slices/slice-03-upgrade-docs-legacy-project-smokes/slice.json

@@ -0,0 +1,78 @@
+{
+  "slice_id": "slice-03-upgrade-docs-legacy-project-smokes",
+  "ticket": "QUIVER-03",
+  "type": "docs",
+  "title": "Upgrade Docs and Legacy Project Smokes",
+  "objective": "Document the upgrade path for existing projects and add smoke coverage for legacy generated projects.",
+  "description": "Users need a clear path when they already initialized Quiver with an older package. This slice updates README and generated docs with upgrade instructions and adds fixtures or smoke setup that simulate older projects missing newer onboarding artifacts.",
+  "git": {
+    "branch_type": "docs",
+    "base_branch": "main",
+    "branch_slug": "existing-project-migration",
+    "branch_name": "docs/QUIVER-03-existing-project-migration"
+  },
+  "must": [
+    "Add an `Upgrading Existing Projects` section to the root README",
+    "Document both `npx` and devDependency upgrade flows",
+    "Update generated README or AI docs to mention migration for already-initialized projects",
+    "Add smoke coverage for a legacy project missing `docs/AI_ONBOARDING_PROMPT.md` and metadata",
+    "Verify migration does not overwrite edited context docs",
+    "Close the spec status and evidence"
+  ],
+  "not_included": [
+    "Publishing a release",
+    "Changing migration behavior beyond doc/test-driven fixes found during validation",
+    "Adding provider-specific AI instructions",
+    "Supporting global installation as a recommended path"
+  ],
+  "acceptance": [
+    "README explains what to do if Quiver was already initialized with an older version",
+    "Generated guidance points existing projects to `migrate`, then `analyze`, then `doctor`",
+    "Legacy project smoke proves missing files are added",
+    "Legacy project smoke proves edited docs are preserved",
+    "Package smoke passes",
+    "Spec status and evidence show all slices completed"
+  ],
+  "files": [
+    "README.md",
+    "README_FOR_AI.md",
+    "scripts/init-docs.sh",
+    "scripts/ci/smoke-create-quiver.sh",
+    "scripts/ci/smoke-init-docs.sh",
+    "scripts/package-quiver.sh",
+    "specs/quiver-v11-existing-project-migration/SPEC.md",
+    "specs/quiver-v11-existing-project-migration/STATUS.md",
+    "specs/quiver-v11-existing-project-migration/EVIDENCE_REPORT.md",
+    "specs/quiver-v11-existing-project-migration/slices/slice-03-upgrade-docs-legacy-project-smokes/slice.json"
+  ],
+  "tests": [
+    "bash scripts/ci/smoke-init-docs.sh",
+    "bash scripts/ci/smoke-create-quiver.sh",
+    "bash scripts/package-quiver.sh",
+    "legacy migration fixture or smoke path",
+    "git diff --check"
+  ],
+  "documentation": [
+    "README.md",
+    "README_FOR_AI.md",
+    "specs/quiver-v11-existing-project-migration/SPEC.md",
+    "specs/quiver-v11-existing-project-migration/STATUS.md",
+    "specs/quiver-v11-existing-project-migration/EVIDENCE_REPORT.md"
+  ],
+  "dependencies": [
+    "slice-01-non-destructive-migrate-command",
+    "slice-02-version-metadata-doctor-upgrade-checks"
+  ],
+  "assumptions": [
+    "Existing projects should not need to delete generated docs before upgrading",
+    "The safest upgrade order is migrate, analyze, doctor, then AI prompt",
+    "Smoke fixtures can simulate old projects by deleting newer artifacts from a generated project"
+  ],
+  "estimated_hours": 3,
+  "actual_hours": 3,
+  "status": "completed",
+  "blocked_reason": null,
+  "ready_at": null,
+  "started_at": "2026-04-22T00:00:00Z",
+  "completed_at": "2026-04-22T00:00:00Z"
+}

package/specs/quiver-v12-cross-platform-native-runtime/EVIDENCE_REPORT.md

@@ -0,0 +1,30 @@
+# Quiver v0.12 Evidence Report
+
+**Spec:** quiver-v12-cross-platform-native-runtime
+**Date:** 2026-04-22
+**Status:** Completed
+
+## Summary
+
+This spec will make Quiver native across macOS, Linux, and Windows by moving user-facing workflow commands from Bash scripts to Node.js CLI commands.
+
+## Slice Evidence
+
+| Slice | Status | Evidence |
+|-------|--------|----------|
+| slice-01 | Completed | Updated README, README_FOR_AI, support matrix template, troubleshooting template, and init-docs README generation; validated with `bash scripts/ci/smoke-init-docs.sh`, `bash scripts/ci/smoke-create-quiver.sh`, and `git diff --check` |
+| slice-02 | Completed | Ported `init` to the Node runtime via `src/create-quiver/lib/init-docs.js`; `src/create-quiver/index.js` now calls it directly; `scripts/ci/smoke-init-docs.sh` now validates the real CLI path. Verified with `node -c src/create-quiver/index.js`, `node -c src/create-quiver/lib/init-docs.js`, `bash -n scripts/init-docs.sh scripts/ci/smoke-init-docs.sh scripts/ci/smoke-create-quiver.sh scripts/package-quiver.sh`, `bash scripts/ci/smoke-init-docs.sh`, `bash scripts/ci/smoke-create-quiver.sh`, and `bash scripts/package-quiver.sh` |
+| slice-03 | Completed | Ported `migrate` off Bash by calling the Node init runtime with `migrateMode: true`; added shared path and state helpers in `src/create-quiver/lib/paths.js` and `src/create-quiver/lib/state.js`; updated doctor/init output to use Node-native commands; added smoke coverage for spaces and Windows-style paths in `scripts/ci/smoke-create-quiver.sh`. Verified with `node -c src/create-quiver/index.js`, `node -c src/create-quiver/lib/init-docs.js`, `node -c src/create-quiver/lib/paths.js`, `node -c src/create-quiver/lib/state.js`, `node -c src/create-quiver/lib/analyze.js`, `node -c src/create-quiver/lib/doctor.js`, `bash -n scripts/init-docs.sh scripts/ci/smoke-init-docs.sh scripts/ci/smoke-create-quiver.sh scripts/package-quiver.sh`, `bash scripts/ci/smoke-init-docs.sh`, `bash scripts/ci/smoke-create-quiver.sh`, `bash scripts/package-quiver.sh`, and `git diff --check` |
+| slice-04 | Completed | Ported slice lifecycle and readiness gates to Node CLI commands in `src/create-quiver/lib/lifecycle.js`, `src/create-quiver/lib/readiness.js`, `src/create-quiver/lib/scope.js`, `src/create-quiver/lib/git.js`, and `src/create-quiver/lib/slice.js`; updated `src/create-quiver/index.js` to route `start-slice`, `check-slice`, `check-pr`, `cleanup-slice`, `check-scope`, and `refresh-active-slices`; updated `scripts/ci/smoke-workflow-gates.sh` to exercise the CLI directly. Verified with `node -c src/create-quiver/index.js`, `node -c src/create-quiver/lib/git.js`, `node -c src/create-quiver/lib/slice.js`, `node -c src/create-quiver/lib/lifecycle.js`, `node -c src/create-quiver/lib/readiness.js`, `node -c src/create-quiver/lib/scope.js`, `bash -n scripts/ci/smoke-workflow-gates.sh scripts/ci/smoke-create-quiver.sh scripts/ci/smoke-init-docs.sh scripts/package-quiver.sh`, `bash scripts/ci/smoke-workflow-gates.sh`, `bash scripts/ci/smoke-create-quiver.sh`, `bash scripts/package-quiver.sh`, and `git diff --check` |
+| slice-05 | Completed | Added `quiver:*` npm scripts to generated and migrated projects, kept legacy Bash aliases for compatibility, taught `doctor` to flag projects that still need script migration, and updated smoke coverage to verify additive migration and user script preservation. Verified with `node -c src/create-quiver/index.js`, `node -c src/create-quiver/lib/init-docs.js`, `bash -n scripts/init-docs.sh scripts/ci/smoke-init-docs.sh scripts/ci/smoke-create-quiver.sh scripts/package-quiver.sh`, `bash scripts/ci/smoke-init-docs.sh`, `bash scripts/ci/smoke-create-quiver.sh`, `bash scripts/package-quiver.sh`, and `git diff --check` |
+| slice-06 | Completed | Added a cross-platform Node smoke script at `scripts/ci/smoke-cross-platform.js` and switched `.github/workflows/ci.yml` to a Linux/macOS/Windows matrix that runs the Node smoke without Bash as the required path. Verified with `node -c src/create-quiver/index.js`, `node -c src/create-quiver/lib/init-docs.js`, `node -c scripts/ci/smoke-cross-platform.js`, `bash -n scripts/init-docs.sh scripts/ci/smoke-init-docs.sh scripts/ci/smoke-create-quiver.sh scripts/package-quiver.sh`, `bash scripts/ci/smoke-init-docs.sh`, `node scripts/ci/smoke-cross-platform.js`, `bash scripts/package-quiver.sh`, and `git diff --check` |
+
+## Required Final Evidence
+
+- Node syntax checks for all new runtime modules
+- Unit or smoke coverage for path handling on Windows-style and POSIX-style paths
+- Generated project smoke on Linux
+- Generated project smoke on macOS
+- Generated project smoke on Windows
+- Package smoke proving npm wrappers invoke CLI commands correctly
+- Documentation check proving Bash is no longer documented as the primary path

package/specs/quiver-v12-cross-platform-native-runtime/SPEC.md

@@ -0,0 +1,86 @@
+# Quiver v0.12 - Cross-Platform Native Runtime
+
+**Date:** 2026-04-22
+**Status:** Completed
+
+Slice numbering resets here: this spec starts at `slice-01` and does not continue any previous spec's numbering.
+
+## Objective
+
+Make Quiver run natively on macOS, Linux, and Windows by moving the framework runtime from Bash scripts to Node.js CLI commands.
+
+## Scope
+
+### Included
+
+- Define the official cross-platform support contract for macOS, Linux, Windows PowerShell, and Windows CMD
+- Remove Bash as a required runtime dependency for user-facing Quiver commands
+- Port generated project initialization and migration from shell scripts to Node.js
+- Add Node-native commands for slice lifecycle and readiness gates
+- Update generated `package.json` scripts to call `create-quiver` directly
+- Keep existing `.sh` scripts as legacy Unix wrappers where useful
+- Add cross-platform CI coverage for Linux, macOS, and Windows
+- Update docs, support matrix, troubleshooting, and generated project guidance
+
+### Excluded
+
+- Auto-installing Bash, Git Bash, MSYS2, or WSL
+- Removing existing Bash wrappers in this spec
+- Changing the one slice = one commit or one spec = one PR workflow
+- Integrating AI provider execution into the CLI
+- Publishing a release as part of this spec
+
+## Target Native Flow
+
+From any supported OS, inside the target project root:
+
+```bash
+npx create-quiver migrate
+npx create-quiver analyze
+npx create-quiver doctor
+npx create-quiver start-slice specs/app/slices/slice-01/slice.json
+npx create-quiver check-slice specs/app/slices/slice-01/slice.json
+npx create-quiver check-pr specs/app/slices/slice-01/slice.json
+```
+
+`--dir` remains available for explicit out-of-project targeting, but it is not the primary developer path.
+
+## Support Contract
+
+Quiver should support:
+
+- macOS with Terminal shells
+- Linux with standard shell environments
+- Windows with PowerShell
+- Windows with CMD
+- Node.js LTS and npm
+- Git with `worktree` support
+
+Quiver should not require:
+
+- Bash on Windows
+- WSL for normal Windows usage
+- executable bits for user-facing commands
+- POSIX-only path behavior in generated project workflows
+
+## Slices
+
+| Slice | Title | Status | Spec |
+|-------|-------|--------|------|
+| 01 | Cross-Platform Support Contract | Completed | [slice-01](./slices/slice-01-cross-platform-support-contract/slice.json) |
+| 02 | Node Init Docs Runtime | Completed | [slice-02](./slices/slice-02-node-init-docs-runtime/slice.json) |
+| 03 | Node Migrate, Analyze, and Doctor Flow | Completed | [slice-03](./slices/slice-03-node-migrate-analyze-doctor-flow/slice.json) |
+| 04 | Node Slice Lifecycle Commands | Completed | [slice-04](./slices/slice-04-node-slice-lifecycle-commands/slice.json) |
+| 05 | Generated Project Scripts and Migration | Completed | [slice-05](./slices/slice-05-generated-project-scripts-and-migration/slice.json) |
+| 06 | Cross-Platform CI and Release Readiness | Completed | [slice-06](./slices/slice-06-cross-platform-ci-release-readiness/slice.json) |
+
+## Definition of Done
+
+- New Quiver projects can be initialized without invoking Bash
+- Existing Quiver projects can migrate without invoking Bash
+- Analyzer and doctor work from PowerShell, CMD, macOS, and Linux
+- Slice lifecycle commands have Node-native CLI entrypoints
+- Generated `package.json` scripts use `create-quiver` commands instead of `bash tools/scripts/*.sh`
+- Existing Unix wrappers still work or clearly point to the new CLI commands
+- CI validates core workflows on `ubuntu-latest`, `macos-latest`, and `windows-latest`
+- README and generated docs describe Windows native support accurately

package/specs/quiver-v12-cross-platform-native-runtime/STATUS.md

@@ -0,0 +1,29 @@
+# Quiver v0.12 Spec Status
+
+**Spec:** quiver-v12-cross-platform-native-runtime
+**Last updated:** 2026-04-22
+
+Slice numbering is local to this spec. The first slice is `slice-01`.
+
+## Status
+
+| Slice | Title | Status | PR | Estimated hours | Actual hours |
+|-------|-------|--------|----|-----------------|--------------|
+| slice-01 | Cross-Platform Support Contract | Completed | - | 3 | 3 |
+| slice-02 | Node Init Docs Runtime | Completed | - | 8 | 4 |
+| slice-03 | Node Migrate, Analyze, and Doctor Flow | Completed | - | 5 | 5 |
+| slice-04 | Node Slice Lifecycle Commands | Completed | - | 10 | 10 |
+| slice-05 | Generated Project Scripts and Migration | Completed | - | 5 | 5 |
+| slice-06 | Cross-Platform CI and Release Readiness | Completed | - | 5 | 5 |
+
+## Progress
+
+- Completed slices: 6 / 6
+- Estimated hours: 36
+- Actual hours: 32
+
+## Blockers
+
+| Slice | Blocker | Since | Action needed |
+|-------|---------|-------|---------------|
+| - | - | - | - |

package/specs/quiver-v12-cross-platform-native-runtime/slices/slice-01-cross-platform-support-contract/slice.json

@@ -0,0 +1,69 @@
+{
+  "slice_id": "slice-01-cross-platform-support-contract",
+  "ticket": "QUIVER-01",
+  "type": "documentation",
+  "title": "Cross-Platform Support Contract",
+  "objective": "Define the official macOS, Linux, and Windows support contract before runtime code is ported.",
+  "description": "Quiver currently documents macOS and Linux as the supported environments. This slice updates the support contract, README, generated docs, and troubleshooting language so the project has a precise target for native Windows support.",
+  "git": {
+    "branch_type": "docs",
+    "base_branch": "main",
+    "branch_slug": "cross-platform-support-contract",
+    "branch_name": "docs/QUIVER-01-cross-platform-support-contract"
+  },
+  "must": [
+    "Document macOS, Linux, Windows PowerShell, and Windows CMD as the target support matrix for the cross-platform work",
+    "State that Bash remains a legacy compatibility path, not the future required runtime",
+    "Define common requirements: Node.js LTS, npm, Git, and Git worktree support",
+    "Document that Quiver should not auto-install Bash, Git Bash, MSYS2, or WSL",
+    "Update generated support matrix and troubleshooting templates",
+    "Keep Windows marked as target support until CI proves native behavior"
+  ],
+  "not_included": [
+    "Porting Bash scripts to Node",
+    "Changing generated package scripts",
+    "Adding Windows CI",
+    "Publishing a release"
+  ],
+  "acceptance": [
+    "README explains the target native Windows support approach",
+    "Support matrix template includes macOS, Linux, PowerShell, and CMD expectations",
+    "Troubleshooting explains when to use WSL or Git Bash as a fallback during transition",
+    "No doc claims Windows is fully supported before runtime and CI slices are complete"
+  ],
+  "files": [
+    "README.md",
+    "README_FOR_AI.md",
+    "docs/SUPPORT_MATRIX.md.template",
+    "docs/TROUBLESHOOTING.md.template",
+    "scripts/init-docs.sh",
+    "specs/quiver-v12-cross-platform-native-runtime/SPEC.md",
+    "specs/quiver-v12-cross-platform-native-runtime/STATUS.md",
+    "specs/quiver-v12-cross-platform-native-runtime/EVIDENCE_REPORT.md",
+    "specs/quiver-v12-cross-platform-native-runtime/slices/slice-01-cross-platform-support-contract/slice.json"
+  ],
+  "tests": [
+    "bash scripts/ci/smoke-init-docs.sh",
+    "git diff --check"
+  ],
+  "documentation": [
+    "specs/quiver-v12-cross-platform-native-runtime/SPEC.md",
+    "specs/quiver-v12-cross-platform-native-runtime/STATUS.md",
+    "specs/quiver-v12-cross-platform-native-runtime/EVIDENCE_REPORT.md"
+  ],
+  "dependencies": [
+    "quiver-v11-existing-project-migration",
+    "docs/root-first-docs-flow"
+  ],
+  "assumptions": [
+    "The support contract should lead implementation but avoid overstating current Windows readiness",
+    "Bash wrappers can remain documented as legacy Unix compatibility"
+  ],
+  "estimated_hours": 3,
+  "actual_hours": null,
+  "status": "draft",
+  "blocked_reason": null,
+  "ready_at": null,
+  "started_at": null,
+  "completed_at": null
+}

package/specs/quiver-v12-cross-platform-native-runtime/slices/slice-02-node-init-docs-runtime/slice.json

@@ -0,0 +1,76 @@
+{
+  "slice_id": "slice-02-node-init-docs-runtime",
+  "ticket": "QUIVER-02",
+  "type": "feature",
+  "title": "Node Init Docs Runtime",
+  "objective": "Replace the Bash dependency in project initialization with a Node.js implementation.",
+  "description": "The current installer invokes `bash docs-template/scripts/init-docs.sh`, which blocks native Windows usage at the first command. This slice ports initialization behavior to Node while preserving generated file content, migration-safe copy behavior, package.json sync, and Quiver state metadata.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "node-init-docs-runtime",
+    "branch_name": "feature/QUIVER-02-node-init-docs-runtime"
+  },
+  "must": [
+    "Add a Node-native initialization module used by `create-quiver --name`",
+    "Copy templates and replace placeholders without invoking Bash, sed, cp, or chmod as required steps",
+    "Preserve existing files according to current init and migration behavior",
+    "Generate docs, specs, tools, package.json scripts, README, and `.quiver/state.json` with equivalent content",
+    "Keep `scripts/init-docs.sh` as a compatibility wrapper or legacy path where useful",
+    "Update package smoke so packaged installs initialize without Bash"
+  ],
+  "not_included": [
+    "Porting slice lifecycle scripts",
+    "Changing the spec/slice workflow semantics",
+    "Adding Windows CI matrix",
+    "Removing legacy shell scripts"
+  ],
+  "acceptance": [
+    "`node bin/create-quiver.js --name \"Smoke Project\" --dir <target>` initializes without spawning Bash",
+    "Generated project files match the current contract",
+    "Existing file preservation still works",
+    "Package smoke proves initialization from the tarball works through Node runtime",
+    "Unix `scripts/init-docs.sh` compatibility path still passes or clearly delegates to Node"
+  ],
+  "files": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/init-docs.js",
+    "src/create-quiver/lib/templates.js",
+    "src/create-quiver/lib/package-json.js",
+    "scripts/init-docs.sh",
+    "scripts/ci/smoke-init-docs.sh",
+    "scripts/ci/smoke-create-quiver.sh",
+    "scripts/package-quiver.sh",
+    "specs/quiver-v12-cross-platform-native-runtime/SPEC.md",
+    "specs/quiver-v12-cross-platform-native-runtime/STATUS.md",
+    "specs/quiver-v12-cross-platform-native-runtime/EVIDENCE_REPORT.md",
+    "specs/quiver-v12-cross-platform-native-runtime/slices/slice-02-node-init-docs-runtime/slice.json"
+  ],
+  "tests": [
+    "node -c src/create-quiver/index.js",
+    "node -c src/create-quiver/lib/init-docs.js",
+    "bash scripts/ci/smoke-init-docs.sh",
+    "bash scripts/ci/smoke-create-quiver.sh",
+    "bash scripts/package-quiver.sh",
+    "git diff --check"
+  ],
+  "documentation": [
+    "specs/quiver-v12-cross-platform-native-runtime/SPEC.md",
+    "specs/quiver-v12-cross-platform-native-runtime/STATUS.md",
+    "specs/quiver-v12-cross-platform-native-runtime/EVIDENCE_REPORT.md"
+  ],
+  "dependencies": [
+    "slice-01-cross-platform-support-contract"
+  ],
+  "assumptions": [
+    "Node.js is the shared runtime across all supported systems",
+    "Current generated content should remain stable unless cross-platform support requires a wording change"
+  ],
+  "estimated_hours": 8,
+  "actual_hours": null,
+  "status": "draft",
+  "blocked_reason": null,
+  "ready_at": null,
+  "started_at": null,
+  "completed_at": null
+}

package/specs/quiver-v12-cross-platform-native-runtime/slices/slice-03-node-migrate-analyze-doctor-flow/slice.json

@@ -0,0 +1,74 @@
+{
+  "slice_id": "slice-03-node-migrate-analyze-doctor-flow",
+  "ticket": "QUIVER-03",
+  "type": "feature",
+  "title": "Node Migrate, Analyze, and Doctor Flow",
+  "objective": "Make `migrate`, `analyze`, and `doctor` fully Node-native and Windows-safe.",
+  "description": "After initialization no longer requires Bash, the core maintenance loop must also avoid shell assumptions. This slice hardens path handling, metadata updates, and diagnostics for macOS, Linux, PowerShell, and CMD.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "node-core-flow",
+    "branch_name": "feature/QUIVER-03-node-core-flow"
+  },
+  "must": [
+    "Ensure `create-quiver migrate` uses the Node initialization runtime instead of Bash",
+    "Normalize paths with Node APIs and avoid POSIX-only separators in logic",
+    "Keep `analyze` and `doctor` usable from the project root without Bash",
+    "Update doctor diagnostics so Windows users see PowerShell/CMD-safe commands",
+    "Add focused tests or smoke fixtures for Windows-style paths and paths with spaces",
+    "Preserve existing metadata fields in `.quiver/state.json`"
+  ],
+  "not_included": [
+    "Porting `start-slice` or readiness gates",
+    "Adding GitHub Actions Windows matrix",
+    "Removing shell wrappers",
+    "Publishing a release"
+  ],
+  "acceptance": [
+    "`create-quiver migrate`, `analyze`, and `doctor` do not invoke Bash",
+    "Commands work when the project path contains spaces",
+    "Doctor output uses commands valid in PowerShell, CMD, macOS, and Linux",
+    "State metadata remains valid after migration and analysis",
+    "Existing smoke coverage still passes"
+  ],
+  "files": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/paths.js",
+    "src/create-quiver/lib/state.js",
+    "src/create-quiver/lib/analyze.js",
+    "src/create-quiver/lib/doctor.js",
+    "scripts/ci/smoke-create-quiver.sh",
+    "specs/quiver-v12-cross-platform-native-runtime/SPEC.md",
+    "specs/quiver-v12-cross-platform-native-runtime/STATUS.md",
+    "specs/quiver-v12-cross-platform-native-runtime/EVIDENCE_REPORT.md",
+    "specs/quiver-v12-cross-platform-native-runtime/slices/slice-03-node-migrate-analyze-doctor-flow/slice.json"
+  ],
+  "tests": [
+    "node -c src/create-quiver/index.js",
+    "node bin/create-quiver.js migrate",
+    "node bin/create-quiver.js analyze",
+    "node bin/create-quiver.js doctor",
+    "bash scripts/ci/smoke-create-quiver.sh",
+    "git diff --check"
+  ],
+  "documentation": [
+    "specs/quiver-v12-cross-platform-native-runtime/SPEC.md",
+    "specs/quiver-v12-cross-platform-native-runtime/STATUS.md",
+    "specs/quiver-v12-cross-platform-native-runtime/EVIDENCE_REPORT.md"
+  ],
+  "dependencies": [
+    "slice-02-node-init-docs-runtime"
+  ],
+  "assumptions": [
+    "Analyze and doctor should remain read-mostly except for analysis metadata updates",
+    "`--dir` remains supported for explicit out-of-project targeting"
+  ],
+  "estimated_hours": 5,
+  "actual_hours": null,
+  "status": "draft",
+  "blocked_reason": null,
+  "ready_at": null,
+  "started_at": null,
+  "completed_at": null
+}

package/specs/quiver-v12-cross-platform-native-runtime/slices/slice-04-node-slice-lifecycle-commands/slice.json

@@ -0,0 +1,81 @@
+{
+  "slice_id": "slice-04-node-slice-lifecycle-commands",
+  "ticket": "QUIVER-04",
+  "type": "feature",
+  "title": "Node Slice Lifecycle Commands",
+  "objective": "Port slice lifecycle and readiness gates from Bash scripts to Node CLI commands.",
+  "description": "The primary developer workflow still depends on Bash for `start-slice`, readiness checks, PR checks, cleanup, and scope checks. This slice introduces Node-native commands that preserve current behavior while working from PowerShell and CMD.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "node-slice-lifecycle",
+    "branch_name": "feature/QUIVER-04-node-slice-lifecycle"
+  },
+  "must": [
+    "Add CLI commands for `start-slice`, `check-slice`, `check-pr`, `cleanup-slice`, `check-scope`, and `refresh-active-slices`",
+    "Port slice JSON parsing and validation to Node",
+    "Port Git worktree creation, lookup, cleanup, and status checks to Node",
+    "Handle paths with spaces and Windows drive letters safely",
+    "Handle Windows executable-bit differences without false failures",
+    "Keep legacy `.sh` wrappers usable on Unix by delegating to the new CLI commands where practical"
+  ],
+  "not_included": [
+    "Changing the slice JSON schema unless required for compatibility",
+    "Changing branch naming rules",
+    "Changing one slice = one commit validation",
+    "Adding release publishing"
+  ],
+  "acceptance": [
+    "`npx create-quiver start-slice <slice.json>` creates or reuses the expected worktree",
+    "`npx create-quiver check-slice <slice.json>` validates the same contract as the current shell gate",
+    "`npx create-quiver check-pr <slice.json>` validates PR readiness without Bash",
+    "`npx create-quiver cleanup-slice <slice.json>` removes worktree and branch according to existing flags",
+    "Unix shell wrappers still pass existing smokes",
+    "Cross-platform path tests cover spaces and Windows-style path strings"
+  ],
+  "files": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/git.js",
+    "src/create-quiver/lib/slice.js",
+    "src/create-quiver/lib/lifecycle.js",
+    "src/create-quiver/lib/readiness.js",
+    "src/create-quiver/lib/scope.js",
+    "scripts/start-slice.sh",
+    "scripts/check-slice-readiness.sh",
+    "scripts/check-pr-readiness.sh",
+    "scripts/cleanup-slice.sh",
+    "scripts/check-scope.sh",
+    "scripts/refresh-active-slices.sh",
+    "scripts/ci/smoke-workflow-gates.sh",
+    "scripts/ci/smoke-create-quiver.sh",
+    "specs/quiver-v12-cross-platform-native-runtime/SPEC.md",
+    "specs/quiver-v12-cross-platform-native-runtime/STATUS.md",
+    "specs/quiver-v12-cross-platform-native-runtime/EVIDENCE_REPORT.md",
+    "specs/quiver-v12-cross-platform-native-runtime/slices/slice-04-node-slice-lifecycle-commands/slice.json"
+  ],
+  "tests": [
+    "node -c src/create-quiver/index.js",
+    "bash scripts/ci/smoke-workflow-gates.sh",
+    "bash scripts/ci/smoke-create-quiver.sh",
+    "git diff --check"
+  ],
+  "documentation": [
+    "specs/quiver-v12-cross-platform-native-runtime/SPEC.md",
+    "specs/quiver-v12-cross-platform-native-runtime/STATUS.md",
+    "specs/quiver-v12-cross-platform-native-runtime/EVIDENCE_REPORT.md"
+  ],
+  "dependencies": [
+    "slice-03-node-migrate-analyze-doctor-flow"
+  ],
+  "assumptions": [
+    "Git remains an external dependency and is not bundled",
+    "The Node implementation should preserve current shell behavior before improving ergonomics"
+  ],
+  "estimated_hours": 10,
+  "actual_hours": null,
+  "status": "draft",
+  "blocked_reason": null,
+  "ready_at": null,
+  "started_at": null,
+  "completed_at": null
+}