create-quiver 0.12.0 → 0.13.0

package/specs/quiver-v25-ai-first-lifecycle-orchestrator/slices/slice-06-spec-slice-generator/slice.json

@@ -0,0 +1,55 @@
+{
+  "slice_id": "slice-06-spec-slice-generator",
+  "ticket": "QUIVER-25-06",
+  "type": "feature",
+  "title": "Spec, slice, handoff, and PR body generation",
+  "objective": "Generate versionable implementation artifacts only after the technical plan is approved.",
+  "description": "Create SPEC, STATUS, evidence, execution plan, PR body, mandatory slice-00, slice JSON, execution briefs, closure briefs, and file scope declarations from approved planner output.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "spec-slice-generator",
+    "branch_name": "feature/QUIVER-25-06-spec-slice-generator"
+  },
+  "files": [
+    "src/create-quiver/**",
+    "docs/**",
+    "specs/**",
+    "tests/**"
+  ],
+  "depends_on": [
+    "slice-05-approval-gates"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "Creates the artifact contract consumed by planning and execution slices.",
+  "must": [
+    "Generate top-level spec artifacts from approved plan only.",
+    "Always create mandatory slice-00.",
+    "Create slice.json, EXECUTION_BRIEF.md, and CLOSURE_BRIEF.md for each slice.",
+    "Create pr.md body.",
+    "Include depends_on, parallel safety, expected read paths, allowed write paths, and validation hints.",
+    "Support dry-run previews before writing."
+  ],
+  "not_included": [
+    "Executing slices.",
+    "Opening PRs.",
+    "Dashboard export."
+  ],
+  "acceptance": [
+    "Spec generation is blocked before plan approval.",
+    "Dry-run reports all files that would be written.",
+    "Written artifacts match Quiver spec layout.",
+    "slice-00 is present and must run first.",
+    "Every slice has handoffs and parseable JSON.",
+    "PR body is generated."
+  ],
+  "tests": [
+    "node --test tests/**/*.test.js",
+    "find <fixture-output> -name \"slice.json\" -print -exec node -e \"JSON.parse(require('fs').readFileSync(process.argv[1], 'utf8'))\" {} \\;",
+    "git diff --check"
+  ],
+  "estimated_hours": 8,
+  "status": "completed",
+  "blocked_reason": null,
+  "completed_at": "2026-05-22T16:49:40-0300"
+}

package/specs/quiver-v25-ai-first-lifecycle-orchestrator/slices/slice-07-slice-execution-planner/CLOSURE_BRIEF.md

@@ -0,0 +1,33 @@
+# CLOSURE BRIEF - slice-07: Slice execution planning and parallel safety
+
+## Summary of Work
+
+Connected execution planning to the generated write-scope contract. Slice graph reads now use `allowed_write_paths` as the authoritative write scope when present, execution plans expose read/write/validation metadata for downstream agents, and human output labels dependency levels as waves with parallel-safety rationale.
+
+## Validation Against Acceptance Criteria
+
+- [x] Wave 0 verified.
+- [x] Parallel grouping verified.
+- [x] Conflict blocking verified.
+- [x] JSON output verified.
+- [x] Tests run.
+
+## Relevant Changes
+
+- `readAllSlices` now resolves write scope from `allowed_write_paths` before falling back to `files`.
+- Execution plan JSON includes `expected_read_paths`, `allowed_write_paths`, and `validation_hints` for each slice.
+- Human execution plan output now uses `Wave <n>` and prints each slice's parallel-safety declaration.
+- Added conflict tests for slices that only declare `allowed_write_paths`.
+- Added CLI JSON coverage for `ai execute-plan --json`.
+
+## Pending
+
+None for this slice.
+
+## Remaining Risks
+
+- Parallel safety still assumes declared write paths are accurate; later validation should flag incomplete scopes earlier.
+
+## Future Recommendations
+
+- Use this planner before any delegated multi-agent execution.

package/specs/quiver-v25-ai-first-lifecycle-orchestrator/slices/slice-07-slice-execution-planner/EXECUTION_BRIEF.md

@@ -0,0 +1,54 @@
+# EXECUTION BRIEF - slice-07: Slice execution planning and parallel safety
+
+## Context
+
+After specs and slices exist, Quiver must tell the human and agents what can run now, what must wait, and what can safely run in parallel.
+
+## Objective
+
+Generate execution plans with waves, dependencies, file conflicts, and JSON output.
+
+## Scope
+
+- Execution waves.
+- Dependency validation.
+- Parallel-safety rules.
+- File scope conflict checks.
+- Human and machine-readable output.
+
+## Acceptance Criteria
+
+- `slice-00` is always Wave 0.
+- Parallel waves exclude conflicting slices.
+- Blocked slices explain why.
+- JSON output is available.
+- Existing planning commands remain compatible.
+
+## Technical Plan Summary
+
+Extend current slice graph/planning machinery with file-scope-aware waves and clearer output.
+
+## Suggested Execution Steps
+
+1. Inspect current slice graph utilities.
+2. Add file conflict handling based on declared paths.
+3. Add wave output.
+4. Add JSON output tests.
+5. Validate with fixtures.
+
+## Restrictions
+
+- Do not execute slices.
+- Do not create commits.
+
+## Risks
+
+- False parallel safety can cause agents to edit the same files. Prefer conservative blocking.
+
+## Completion Checklist
+
+- [ ] Wave planning tested.
+- [ ] Conflict detection tested.
+- [ ] JSON output tested.
+- [ ] Docs updated.
+- [ ] Evidence appended.

package/specs/quiver-v25-ai-first-lifecycle-orchestrator/slices/slice-07-slice-execution-planner/slice.json

@@ -0,0 +1,52 @@
+{
+  "slice_id": "slice-07-slice-execution-planner",
+  "ticket": "QUIVER-25-07",
+  "type": "feature",
+  "title": "Slice execution planning and parallel safety",
+  "objective": "Generate a reliable execution plan that shows required order, parallel waves, dependencies, risks, and file conflicts.",
+  "description": "Turn generated slices into execution waves while enforcing slice-00 first, dependency validation, parallel safety, and conflict detection.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "slice-execution-planner",
+    "branch_name": "feature/QUIVER-25-07-slice-execution-planner"
+  },
+  "files": [
+    "src/create-quiver/**",
+    "docs/**",
+    "tests/**"
+  ],
+  "depends_on": [
+    "slice-06-spec-slice-generator"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "Uses generated artifact contracts and feeds executor behavior.",
+  "must": [
+    "Generate sequential and parallel execution waves.",
+    "Force slice-00 to execute first.",
+    "Detect dependency cycles and missing dependencies.",
+    "Detect overlapping allowed write paths between parallel slices.",
+    "Explain why a slice is blocked or parallel-safe.",
+    "Emit human and JSON output."
+  ],
+  "not_included": [
+    "Executing agents.",
+    "Creating commits.",
+    "Opening PRs."
+  ],
+  "acceptance": [
+    "Execution plan shows Wave 0 for slice-00.",
+    "Parallel-ready slices are grouped only when dependencies and file scopes allow it.",
+    "Unsafe parallel execution is explained.",
+    "JSON output is suitable for downstream agents or dashboards.",
+    "Existing `plan`, `graph`, and `next` behavior remains compatible."
+  ],
+  "tests": [
+    "node --test tests/**/*.test.js",
+    "git diff --check"
+  ],
+  "estimated_hours": 6,
+  "status": "completed",
+  "blocked_reason": null,
+  "completed_at": "2026-05-22T16:52:33-0300"
+}

package/specs/quiver-v25-ai-first-lifecycle-orchestrator/slices/slice-08-controlled-slice-execution/CLOSURE_BRIEF.md

@@ -0,0 +1,39 @@
+# CLOSURE BRIEF - slice-08: Controlled slice execution and evidence
+
+## Summary of Work
+
+Implemented controlled slice execution and evidence closure. Direct `ai execute-slice` now uses the generated write-scope contract, blocks dirty or wrong worktrees, validates changed files against declared scope, writes closure/evidence/status artifacts after successful execution, redacts likely secrets from logs, and refuses to close no-op provider runs.
+
+## Validation Against Acceptance Criteria
+
+- [x] Prompt-only mode verified.
+- [x] Minimal context verified.
+- [x] Worktree preflight verified.
+- [x] Scope validation verified.
+- [x] Closure/evidence update verified.
+- [x] Secret redaction verified.
+- [x] No-op provider protection verified.
+
+## Relevant Changes
+
+- `resolveSliceContext` now prefers `allowed_write_paths` over legacy `files` and exposes generated read/validation metadata.
+- `validateScopeSnapshot` supports simple glob scopes and reports violations against the declared slice scope.
+- `ai execute-slice` validates the declared slice branch, clean tree, provider changes, scope, validations, and lifecycle artifacts.
+- Successful execution updates `CLOSURE_BRIEF.md`, `EVIDENCE_REPORT.md`, `COMMAND_LOG.md`, `STATUS.md`, and `slice.json`.
+- Provider and validation output are redacted before printing, returning, or writing evidence.
+- `ai execute-plan` passes an internal branch-check bypass because delegated worktrees are managed by the orchestrator.
+- README and generated command/workflow docs describe the controlled execution contract.
+
+## Pending
+
+None for this slice.
+
+## Remaining Risks
+
+- Scope glob support is intentionally lightweight and should stay covered by regression tests if Quiver adds richer path patterns.
+- Direct single-slice execution is stricter than orchestrated delegated execution by design; docs should keep that distinction visible.
+
+## Future Recommendations
+
+- Use the captured evidence as input for PR creation and review.
+- In `slice-10`, keep adding fixtures around path scopes, redaction, and worktree failures.

package/specs/quiver-v25-ai-first-lifecycle-orchestrator/slices/slice-08-controlled-slice-execution/EXECUTION_BRIEF.md

@@ -0,0 +1,56 @@
+# EXECUTION BRIEF - slice-08: Controlled slice execution and evidence
+
+## Context
+
+Executors should be cheap and focused. They need only the slice context, clear restrictions, and a closure contract.
+
+## Objective
+
+Enable controlled slice execution with minimal context, file scope validation, closure updates, evidence, and logs.
+
+## Scope
+
+- Executor prompt/context generation.
+- Prompt-only and execution modes.
+- Worktree and clean-tree checks.
+- File scope validation.
+- Closure/evidence/command-log updates.
+- Secret redaction.
+
+## Acceptance Criteria
+
+- Context excludes unrelated files by default.
+- Prompt-only mode works.
+- Dirty or wrong worktree blocks execution.
+- Out-of-scope writes are detected.
+- Closure and evidence are updated.
+
+## Technical Plan Summary
+
+Use execution-plan output and agent adapters to prepare focused executor handoffs and validate results before a slice can close.
+
+## Suggested Execution Steps
+
+1. Define executor context pack contract.
+2. Add prompt-only slice command.
+3. Add preflight checks.
+4. Add file scope diff validation.
+5. Add closure/evidence updates.
+6. Test manual and delegated paths with fixtures.
+
+## Restrictions
+
+- Do not auto-commit in this slice unless already required by existing command behavior.
+- Do not open PRs.
+
+## Risks
+
+- File scope validation can miss generated files if path rules are too strict. Report clearly and allow explicit review.
+
+## Completion Checklist
+
+- [ ] Context pack tested.
+- [ ] Preflight tested.
+- [ ] Scope validation tested.
+- [ ] Closure/evidence updated.
+- [ ] Evidence appended.

package/specs/quiver-v25-ai-first-lifecycle-orchestrator/slices/slice-08-controlled-slice-execution/slice.json

@@ -0,0 +1,53 @@
+{
+  "slice_id": "slice-08-controlled-slice-execution",
+  "ticket": "QUIVER-25-08",
+  "type": "feature",
+  "title": "Controlled slice execution and evidence",
+  "objective": "Execute or print executor prompts for slices with minimal context, scope enforcement, closure updates, evidence, and command logging.",
+  "description": "Prepare executor context packs, support prompt-only/manual/delegated modes, validate touched files, update closure briefs, capture evidence, and support one-slice closure.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "controlled-slice-execution",
+    "branch_name": "feature/QUIVER-25-08-controlled-slice-execution"
+  },
+  "files": [
+    "src/create-quiver/**",
+    "docs/**",
+    "tests/**"
+  ],
+  "depends_on": [
+    "slice-07-slice-execution-planner"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "Central executor behavior must be stable before Git/PR automation depends on it.",
+  "must": [
+    "Prepare minimal executor context from slice metadata and relevant spec excerpts.",
+    "Support prompt-only execution.",
+    "Validate correct worktree and clean working tree before execution.",
+    "Validate modified files against declared slice scope.",
+    "Update CLOSURE_BRIEF.md, evidence report, command log, and status.",
+    "Redact likely secrets from captured logs."
+  ],
+  "not_included": [
+    "Creating PRs.",
+    "Closing worktrees after merge.",
+    "Dashboard export."
+  ],
+  "acceptance": [
+    "Executor context excludes unrelated docs/specs by default.",
+    "Prompt-only mode produces directly usable prompts.",
+    "Dirty or wrong worktree blocks execution.",
+    "Out-of-scope file changes are reported or blocked.",
+    "Closure and evidence are updated after successful execution.",
+    "Logs redact likely secrets."
+  ],
+  "tests": [
+    "node --test tests/**/*.test.js",
+    "git diff --check"
+  ],
+  "estimated_hours": 8,
+  "status": "completed",
+  "blocked_reason": null,
+  "completed_at": "2026-05-22T17:02:29-03:00"
+}

package/specs/quiver-v25-ai-first-lifecycle-orchestrator/slices/slice-09-git-worktree-pr-lifecycle/CLOSURE_BRIEF.md

@@ -0,0 +1,38 @@
+# CLOSURE BRIEF - slice-09: Git worktree, commit, PR, and close lifecycle
+
+## Summary of Work
+
+Implemented Git/worktree/PR lifecycle hardening around the AI-first flow. Quiver can now dry-run spec worktree creation, refuses dirty-tree slice commits, requires explicit SSH host alias input for PR preflight, blocks PR creation while spec slices remain open, and keeps post-merge worktree cleanup/pull guidance visible.
+
+## Validation Against Acceptance Criteria
+
+- [x] Worktree lifecycle verified.
+- [x] Commit-by-slice verified.
+- [x] PR preflight verified.
+- [x] PR body usage verified.
+- [x] Post-merge close verified.
+- [x] Open-slice PR blocking verified.
+- [x] Cross-platform SSH alias guidance verified.
+
+## Relevant Changes
+
+- `spec start --dry-run` now previews branch/base/worktree without creating a worktree.
+- CLI wiring passes `--dry-run` into `startSpecWorktree`.
+- `ai execute-slice --commit` blocks when the worktree is dirty before execution, even if `--allow-dirty` is set.
+- GitHub PR preflight requires `--ssh-host-alias` and reports macOS/Linux/Windows setup guidance when missing.
+- PR creation from a generated spec `pr.md` refuses to continue while any slice in that spec is not completed.
+- README, README_FOR_AI, generated command docs, workflow docs, and CLI help describe the hardened lifecycle.
+
+## Pending
+
+None for this slice.
+
+## Remaining Risks
+
+- SSH alias presence is validated, but key authentication still depends on the user's local SSH configuration.
+- Open-slice blocking is intentionally scoped to standard `specs/<slug>/pr.md` PR bodies.
+
+## Future Recommendations
+
+- Keep `gh` and SSH alias guidance platform-specific and actionable.
+- Consider adding a future `ai doctor --ssh-host-alias <alias>` live SSH probe when network access is intentionally available.

package/specs/quiver-v25-ai-first-lifecycle-orchestrator/slices/slice-09-git-worktree-pr-lifecycle/EXECUTION_BRIEF.md

@@ -0,0 +1,57 @@
+# EXECUTION BRIEF - slice-09: Git worktree, commit, PR, and close lifecycle
+
+## Context
+
+Quiver's intended workflow uses one worktree per spec, one commit per slice, and one PR per spec.
+
+## Objective
+
+Implement safe Git/GitHub lifecycle commands around worktrees, slice commits, PR creation, and post-merge cleanup.
+
+## Scope
+
+- Worktree create/status/repair/close.
+- Clean-tree checks.
+- Commit-by-slice.
+- GitHub CLI preflight.
+- SSH alias guidance across macOS, Linux, and Windows.
+- PR creation from `pr.md`.
+- Post-merge cleanup guidance.
+
+## Acceptance Criteria
+
+- Existing worktrees/branches/PRs are handled safely.
+- Commits refuse unrelated mixed changes.
+- PR preflight catches missing prerequisites.
+- PR uses generated body.
+- Close guides worktree removal and pull.
+
+## Technical Plan Summary
+
+Build on controlled slice execution so only closed, validated slice work can be committed and included in PR creation.
+
+## Suggested Execution Steps
+
+1. Audit current worktree and PR commands.
+2. Add status/repair paths.
+3. Harden clean-tree and commit checks.
+4. Add/extend PR preflight.
+5. Add post-merge close guidance.
+6. Test with mocked Git/GitHub states.
+
+## Restrictions
+
+- Do not auto-merge PRs.
+- Do not create SSH keys without explicit user approval.
+
+## Risks
+
+- Git state can vary widely. Prefer diagnostic output over destructive repair.
+
+## Completion Checklist
+
+- [ ] Worktree flows tested.
+- [ ] Commit-by-slice tested.
+- [ ] PR preflight tested.
+- [ ] Close flow tested.
+- [ ] Evidence appended.

package/specs/quiver-v25-ai-first-lifecycle-orchestrator/slices/slice-09-git-worktree-pr-lifecycle/slice.json

@@ -0,0 +1,52 @@
+{
+  "slice_id": "slice-09-git-worktree-pr-lifecycle",
+  "ticket": "QUIVER-25-09",
+  "type": "feature",
+  "title": "Git worktree, commit, PR, and close lifecycle",
+  "objective": "Manage the spec-level Git workflow: worktree per spec, one commit per slice, PR creation, and post-merge cleanup.",
+  "description": "Harden worktree creation/status/repair/close, commit-by-slice behavior, GitHub CLI preflight, SSH alias guidance, PR creation, and post-merge pull.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "git-worktree-pr-lifecycle",
+    "branch_name": "feature/QUIVER-25-09-git-worktree-pr-lifecycle"
+  },
+  "files": [
+    "src/create-quiver/**",
+    "docs/**",
+    "tests/**"
+  ],
+  "depends_on": [
+    "slice-08-controlled-slice-execution"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "Depends on reliable slice closure and touches shared Git workflow commands.",
+  "must": [
+    "Create or validate one worktree per spec.",
+    "Report existing worktree, branch, remote branch, or PR state.",
+    "Require clean working tree before slice execution and commit.",
+    "Create one commit per closed slice.",
+    "Validate `gh`, authentication, remote, branch, SSH alias guidance, and PR body before PR creation.",
+    "Guide post-merge worktree removal and pull."
+  ],
+  "not_included": [
+    "Automatic PR merge.",
+    "Credential creation without user action.",
+    "Provider execution."
+  ],
+  "acceptance": [
+    "Worktree create/status/repair/close behavior is safe and dry-run-capable where mutating.",
+    "Commit by slice refuses mixed unrelated changes.",
+    "PR preflight catches missing `gh`, auth, remote, branch, alias, body, or open slices.",
+    "PR creation uses the generated `pr.md`.",
+    "Post-merge close guides worktree cleanup and local pull."
+  ],
+  "tests": [
+    "node --test tests/**/*.test.js",
+    "git diff --check"
+  ],
+  "estimated_hours": 8,
+  "status": "completed",
+  "blocked_reason": null,
+  "completed_at": "2026-05-22T17:07:41-03:00"
+}

package/specs/quiver-v25-ai-first-lifecycle-orchestrator/slices/slice-10-validation-errors-fixtures/CLOSURE_BRIEF.md

@@ -0,0 +1,39 @@
+# CLOSURE BRIEF - slice-10: Validation, actionable errors, redaction, and fixtures
+
+## Summary of Work
+
+Implemented validation hardening with actionable error formatting, doctor environment warnings, an official fixture matrix, and smoke coverage. The slice also improves missing agent-profile guidance and keeps PR preflight failures clearer for humans and agents.
+
+## Validation Against Acceptance Criteria
+
+- [x] Error format verified.
+- [x] Dry-run consistency verified.
+- [x] Redaction verified.
+- [x] Fixture matrix verified.
+- [x] Smokes run.
+- [x] Doctor environment warnings verified.
+- [x] Missing agent profile guidance verified.
+
+## Relevant Changes
+
+- Added `src/create-quiver/lib/actionable-error.js`.
+- Added actionable error output for missing agent profile, missing SSH alias, and open-slice PR blocking.
+- Added doctor environment warning collection for Node, npm, git, gh, gh auth, shell, write permission, and spaced paths.
+- Added `tests/fixtures/validation-errors/matrix.json` and `scripts/ci/smoke-doctor-fixtures.js`.
+- Added `smoke:doctor-fixtures` to `package.json`.
+- Added tests for environment warnings, actionable error output, missing profile guidance, and fixture matrix.
+- Updated README, README_FOR_AI, and command docs.
+
+## Pending
+
+None for this slice.
+
+## Remaining Risks
+
+- Doctor environment checks intentionally warn instead of fail.
+- The fixture matrix manifest should keep expanding with future dogfooding bugs.
+
+## Future Recommendations
+
+- Treat every bug found in dogfooding as a new fixture candidate.
+- Add deeper per-state fixture directories if a future bug requires filesystem-level reproduction.

package/specs/quiver-v25-ai-first-lifecycle-orchestrator/slices/slice-10-validation-errors-fixtures/EXECUTION_BRIEF.md

@@ -0,0 +1,55 @@
+# EXECUTION BRIEF - slice-10: Validation, actionable errors, redaction, and fixtures
+
+## Context
+
+The lifecycle is only production-ready if failures are understandable and edge cases are covered by fixtures.
+
+## Objective
+
+Harden validation, errors, redaction, dry-runs, doctor checks, and fixture coverage.
+
+## Scope
+
+- Actionable error format.
+- Dry-run consistency checks.
+- Secret redaction.
+- Cross-platform doctor checks.
+- Fixture matrix and tests.
+
+## Acceptance Criteria
+
+- Errors include failure, impact, fix, and next command.
+- Mutating commands support dry-run or justify why not.
+- Logs redact likely secrets.
+- Fixture matrix covers required project states.
+- Smoke/tests cover the matrix.
+
+## Technical Plan Summary
+
+Create shared error/redaction/dry-run test helpers and use fixture projects to prevent partial fixes.
+
+## Suggested Execution Steps
+
+1. Define error output contract.
+2. Add redaction tests.
+3. Build fixture matrix.
+4. Add doctor validations.
+5. Add smoke coverage.
+6. Run full targeted test set.
+
+## Restrictions
+
+- Do not publish a package.
+- Do not expose real env values in test output.
+
+## Risks
+
+- Fixture setup can become heavy. Keep fixtures focused and reusable.
+
+## Completion Checklist
+
+- [ ] Error contract implemented.
+- [ ] Redaction tested.
+- [ ] Fixture matrix added.
+- [ ] Smokes updated.
+- [ ] Evidence appended.

package/specs/quiver-v25-ai-first-lifecycle-orchestrator/slices/slice-10-validation-errors-fixtures/slice.json

@@ -0,0 +1,56 @@
+{
+  "slice_id": "slice-10-validation-errors-fixtures",
+  "ticket": "QUIVER-25-10",
+  "type": "quality",
+  "title": "Validation, actionable errors, redaction, and fixtures",
+  "objective": "Harden lifecycle behavior with actionable errors, dry-run consistency, redaction, cross-platform checks, and fixture coverage.",
+  "description": "Add production-grade validation and tests for the AI-first lifecycle across new, existing, older, monorepo, dirty git, no git, no gh, path-with-spaces, docs-conflict, and missing-agent scenarios.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "validation-errors-fixtures",
+    "branch_name": "feature/QUIVER-25-10-validation-errors-fixtures"
+  },
+  "files": [
+    "src/create-quiver/**",
+    "docs/**",
+    "tests/**",
+    "scripts/**"
+  ],
+  "depends_on": [
+    "slice-01-cli-contract-compatibility",
+    "slice-02-run-state-phase-locks",
+    "slice-08-controlled-slice-execution"
+  ],
+  "parallel_safe": "yes",
+  "parallel_safe_reason": "Can run beside export/migration if fixture and validation files do not overlap.",
+  "must": [
+    "Standardize actionable error shape.",
+    "Ensure write-capable commands have dry-run behavior or explicit justification.",
+    "Redact likely secrets from logs/evidence.",
+    "Add cross-platform doctor checks for Node, npm, git, gh, shell, permissions, paths with spaces, and auth hints.",
+    "Add official fixtures for the major project states."
+  ],
+  "not_included": [
+    "Dashboard export implementation.",
+    "Provider-specific feature expansion.",
+    "Package publishing."
+  ],
+  "acceptance": [
+    "Errors explain what failed, why it matters, how to fix it, and next command.",
+    "Dry-run behavior is consistent for mutating commands.",
+    "Secret-like output is redacted before writing logs.",
+    "Fixtures cover new, existing, old Quiver, monorepo, no git, dirty git, no gh, paths with spaces, docs contradiction, and missing agent profile.",
+    "Tests and smoke commands validate the fixture matrix."
+  ],
+  "tests": [
+    "node --test tests/**/*.test.js",
+    "npm run smoke:create-quiver",
+    "npm run smoke:guided-workflow",
+    "git diff --check"
+  ],
+  "estimated_hours": 8,
+  "status": "completed",
+  "blocked_reason": null,
+  "completed_at": "2026-05-22T17:13:38-03:00"
+}