v2.5.0

v2.5.0 (2026-02-22)

Bug Fixes

• plugin: Address CodeRabbit PR #94 review comments (#94, 6a002e9)

• plugin: Address PR review comments (#94, 6a002e9)

• plugin: Address self-review HIGH findings from CodeRabbit fixes (#94, 6a002e9)

• skill: Restore full planpilot invocation fallback chain (#94, 6a002e9)

• skill: Standardize plan-sync on uvx/pipx run invocation (#94, 6a002e9)

• skill: Use verified-planpilot-cmd in plan-sync init steps (#94, 6a002e9)

• skills: Lean skill preflight, install via uv/pipx/pip3 to PATH (#94, 6a002e9)

Chores

• Move project rules to user-level ~/.claude/rules/ (#95, 8f6be3b)

Documentation

• Address CodeRabbit review comments (#95, 8f6be3b)

• Improve CLAUDE.md clarity and add project rules (#95, 8f6be3b)

• Sync plugin/skills docs with github-source install changes (#94, 6a002e9)

• install: Add planpilot update instructions (#94, 6a002e9)

• install: Prefer uvx over pipx as primary installation method (#94, 6a002e9)

• plan-sync: Remove install instructions from skill (#94, 6a002e9)

• skills: Add planpilot CLI dependency with uvx preference (#94, 6a002e9)

• skills: Address remaining unresolved CodeRabbit comments (#94, 6a002e9)

Features

• plugin: Add full metadata to marketplace.json (#94, 6a002e9)

• plugin: Zero-install github-source plugin distribution (#94, 6a002e9)

---

Detailed Changes: v2.4.1...v2.5.0

v2.4.1

v2.4.1 (2026-02-22)

Bug Fixes

• plugin: Fix marketplace and plugin paths (#93, ecc6b84)

Documentation

• claude: Add worktree setup convention (aedd462)

---

Detailed Changes: v2.4.0...v2.4.1

v2.4.0

v2.4.0 (2026-02-22)

Bug Fixes

• Add missing sync map line to README dry-run output (#86, d2017c7)

• Address PR review comments from CodeRabbit (#85, d45f184)

• Address PR review findings and checks (#76, 0f09d41)

• Avoid redundant label reconciliation updates (#76, 0f09d41)

• Enforce markdown link integrity in CI (#78, 63bac09)

• Fetch full git history for gitleaks scan (#76, 0f09d41)

• Quote GitHub search labels for robust discovery (#76, 0f09d41)

• Reconcile relations and harden workflows/docs (#76, 0f09d41)

• Reconcile relations, harden workflows, and tighten docs governance (#76, 0f09d41)

• Reconcile sync relations and harden workflows (#76, 0f09d41)

• Resolve workflow lint regressions (#76, 0f09d41)

• Use main branch for skill install URLs (#87, 57848f5)

• ci: Checkout branch ref to avoid detached HEAD in release (#92, 8fd0e19)

• ci: Revert accidental scripts/commit-msg change (#92, 8fd0e19)

• docs: Fix clean diagram order and add map sync zero-candidates case (#88, f01efa4)

• docs: Fix label→marker terminology and clarify plugin distribution (#88, f01efa4)

• docs: Fix stale skill URLs and marketplace add format (#88, f01efa4)

• docs: MD040 language specifier and path consistency (#88, f01efa4)

• plugin: Add schema, sync version on release, fix phrasing (#88, f01efa4)

• plugin: Pip source, commands key, email, version 2.3.0 (#88, f01efa4)

• skills: Correct copy errors in install doc and spec (#87, 57848f5)

• skills: Warn against absolute paths in specs (#87, 57848f5)

Chores

• Add .worktrees to gitignore (#88, f01efa4)

• Add workflow linting and docs governance guidance (#76, 0f09d41)

• Harden CI toolchain and workflow reliability (#76, 0f09d41)

• Improve OSS adoption and update package author (#86, d2017c7)

• Refresh lockfile for pyproject updates (#76, 0f09d41)

• Repo audit and docs refresh (#85, d45f184)

• ci: Bump github/codeql-action (#79, ad6e6df)

• ci: Bump github/codeql-action from 4.32.3 to 4.32.4 (#89, fbeea61)

• ci: Bump gitleaks/gitleaks-action from 2.3.6 to 2.3.9 (#83, facda1c)

• ci: Bump python-semantic-release/publish-action (#80, a095857)

• ci: Bump python-semantic-release/python-semantic-release (#82, 2c1652d)

• deps: Bump poethepoet from 0.40.0 to 0.41.0 (#81, 6e379c8)

• deps: Bump rich from 14.3.2 to 14.3.3 (#91, bcda40b)

• deps: Bump ruff from 0.15.0 to 0.15.1 (#84, 043c364)

• deps: Bump ruff from 0.15.1 to 0.15.2 (#90, 8309cac)

Documentation

• Add claude plugin design doc (#88, f01efa4)

• Add claude plugin implementation plan (#88, f01efa4)

• Add CLAUDE.md with architecture and development guidance (#85, d45f184)

• Add docs index completeness plan (#78, 63bac09)

• Add documentation architecture and update policy (#76, 0f09d41)

• Add plugin guide, update design docs, remove plan artifacts (#88, f01efa4)

• Add post-execution verification report (#78, 63bac09)

• Add second post-execution verification report (#78, 63bac09)

• Add skill test artifacts and design docs (#87, 57848f5)

• Add workflow and contributor verification references (#78, 63bac09)

• Align SDK docs and add map-sync/clean design guides (#76, 0f09d41)

• Execute full docs architecture and reference overhaul (#76, 0f09d41)

• Harden docs integrity c...

v2.3.0

v2.3.0 (2026-02-12)

Bug Fixes

• Address remaining PR review items for enrich and tests (#73, 128a44a)

• Address reviewer findings in engine and provider paths (#73, 128a44a)

• Avoid mixed import style in provider tests (#73, 128a44a)

• Clean uses real provider for discovery and adds --all flag (#73, 128a44a)

• Default clean config path to planpilot.json (#73, 128a44a)

• Harden clean behavior and cover SDK clean flows (#73, 128a44a)

• Harden idempotent relations and clean --all (#73, 128a44a)

• Make clean deletion leaf-first and hierarchy-aware (#73, 128a44a)

• Make sync pipeline fully idempotent on re-run (#73, 128a44a)

• Polish progress UX and align CLI docs (#73, 128a44a)

• Preserve relation updates when no items were touched (#73, 128a44a)

• Satisfy mypy variable scoping in init auth preflight (#73, 128a44a)

Chores

• Add test1/ to gitignore (#73, 128a44a)

• Exclude generated GraphQL client from CodeQL scan (#73, 128a44a)

Features

• Add clean workflow and make sync fully idempotent (#73, 128a44a)

• Add planpilot clean command for permanent issue deletion (#73, 128a44a)

• Add progress to clean, map sync, and init preflight (#73, 128a44a)

Testing

• Raise clean/provider patch coverage and tighten local checks (#73, 128a44a)

• Raise cli/sdk patch coverage for PR checks (#73, 128a44a)

---

Detailed Changes: v2.2.0...v2.3.0

v2.2.0

v2.2.0 (2026-02-12)

Bug Fixes

• Address PR bot feedback on init and map-sync coverage (#74, e5b7f13)

• Validate init auth and project context up front (#74, e5b7f13)

Features

• Add initial planpilot configuration file (#74, e5b7f13)

• Add map sync reconcile workflow with plan-id discovery (#74, e5b7f13)

• Bootstrap local plans via map sync and expand init defaults (#74, e5b7f13)

• Enhance init validation, UX, and map sync reconciliation (#74, e5b7f13)

• Enhance planpilot configuration and CLI defaults (#74, e5b7f13)

Testing

• Raise scaffold and sdk map-sync branch coverage (#74, e5b7f13)

---

Detailed Changes: v2.1.0...v2.2.0

v2.1.0

v2.1.0 (2026-02-11)

Documentation

• Add progress bar screenshot (#72, a539435)

Features

• Add Rich progress bar to sync CLI (#72, a539435)

Refactoring

• Decouple SyncProgress from SDK, add phase_error (#72, a539435)

---

Detailed Changes: v2.0.1...v2.1.0

v2.0.1

v2.0.1 (2026-02-09)

Bug Fixes

• Resolve TaskGroup crashes in sync relations (#71, 750f3a7)

Documentation

• Fix step reference in agent install instructions (#70, 3083ce7)

• Recommend pipx for install (fixes PEP 668) (#70, 3083ce7)

---

Detailed Changes: v2.0.0...v2.0.1

v2.0.0

v2.0.0 (2026-02-09)

Bug Fixes

• Regenerate formatted client (#69, 4c29efa)

• Remove unused _UNIFIED_DEFAULT variable in scaffold.py (#69, 4c29efa)

• v2: Align engine behavior with v2 docs (#69, 4c29efa)

• v2: Guard self-parent relations in sync engine (#69, 4c29efa)

• v2: Normalize auth hostname parsing (#69, 4c29efa)

• v2: Update examples, add mypy to CI, drop legacy docs (#69, 4c29efa)

• v2/providers: Address PR review feedback (#69, 4c29efa)

• v2/providers: Harden provider spec compliance (#69, 4c29efa)

• v2/providers: Optimize atomic create/update (#69, 4c29efa)

Chores

• Remove phase 3 plan artifact (#69, 4c29efa)

Code Style

• v2: Sort engine test imports (#69, 4c29efa)

Continuous Integration

• build: Finalize canonical tooling and workflow paths (#69, 4c29efa)

Documentation

• Add planpilot + skill install instructions to readme (#69, 4c29efa)

• Fix GitHub provider description in CONTRIBUTING.md (#69, 4c29efa)

• Overhaul agent skill and restructure install files (#69, 4c29efa)

• Update AGENTS.md for scaffold, skill, and install changes (#69, 4c29efa)

• skill: Make spec-to-planpilot-sync standalone for pip usage (#69, 4c29efa)

• v2: Add AGENTS documentation for providers and knowledge base (#69, 4c29efa)

• v2: Add user guides and finalize docs cleanup (#69, 4c29efa)

• v2: Align documentation with post-cutover layout (#69, 4c29efa)

• v2: Align phase1 engine dry-run guidance (#69, 4c29efa)

• v2: Move v2 docs to root and archive v1 docs (#69, 4c29efa)

• v2: Refresh AGENTS knowledge hierarchy (#69, 4c29efa)

Features

• Planpilot v2 — full rewrite with async engine, GraphQL client, and agent skill (#69, 4c29efa)

• test: Add offline e2e suite and ci workflow (#69, 4c29efa)

• v2: Add phase-0 contracts, test infra, and ci gate (#69, 4c29efa)

• v2: Generate typed GitHub GraphQL client (#69, 4c29efa)

• v2: Implement phase 3 sdk and align implementation docs (#69, 4c29efa)

• v2: Implement phase 3 sdk and docs alignment (#69, 4c29efa)

• v2: Implement phase1 auth module (#69, 4c29efa)

• v2: Implement phase1 engine module (#69, 4c29efa)

• v2: Implement phase1 plan module (#69, 4c29efa)

• v2: Implement phase1 renderers module (#69, 4c29efa)

• v2: Integrate phase1 core modules (#69, 4c29efa)

• v2: Phase 2 - GitHub provider with generated GraphQL client (#69, 4c29efa)

• v2-cli: Add planpilot init interactive config generator (#69, 4c29efa)

• v2-cli: Implement phase 4 cli (#69, 4c29efa)

• v2/providers: Add generated GraphQL GitHub provider (#69, 4c29efa)

• v2/providers: Implement phase 2 github provider (#69, 4c29efa)

• v2/providers: Migrate to generated GraphQL client (#69, 4c29efa)

Refactoring

• v2: Cut over package layout and finalize v2 docs (#69, 4c29efa)

• v2: Cut over runtime and tests to canonical package (#69, 4c29efa)

• v2: Move auth resolvers into shared subpackage (#69, 4c29efa)

Testing

• v2: Enforce 95% coverage floor and close gaps (#69, 4c29efa)

• v2: Harden phase1 plan validator coverage (#69, 4c29efa)

• v2: Package phase1 test modules (#69, 4c29efa)

• v2: Raise phase1 coverage for v2 gate (#69, 4c29efa)

---

Detailed Changes: v1.2.1...v2.0.0

v1.2.1

v1.2.1 (2026-02-09)

Bug Fixes

• v2: Address PR review feedback (#62, 1ed12a0)

Documentation

• Add CLI module spec for v2 architecture (#62, 1ed12a0)

• Add config module spec for v2 architecture (#62, 1ed12a0)

• Add engine module spec with contracts requirements (#62, 1ed12a0)

• Add GitHub provider implementation research (#62, 1ed12a0)

• Add plan module spec (#62, 1ed12a0)

• Add providers module spec with GitHub adapter structure (#62, 1ed12a0)

• Add renderers module spec (#62, 1ed12a0)

• Add SDK module spec for v2 architecture (#62, 1ed12a0)

• Add v2 architecture specification (#62, 1ed12a0)

• Align v2 design specs with implementation decisions (#62, 1ed12a0)

• Apply review fixes across all v2 module specs (#62, 1ed12a0)

• Cross-spec consistency fixes across v2 design docs (#62, 1ed12a0)

• Fix config spec — add auth, remove dry_run, cascade to all specs (#62, 1ed12a0)

• Fix sequence diagram and sync map migration in v2 architecture (#62, 1ed12a0)

• Fix v2 architecture design issues from review (#62, 1ed12a0)

• Flatten PlanItem model — remove Epic/Story/Task subclasses (#62, 1ed12a0)

• Make auth method configurable via planpilot.json (#62, 1ed12a0)

• Rewrite GitHub provider design with codegen + separated auth (#62, 1ed12a0)

• v2: Add auth module spec and fix diagram consistency (#62, 1ed12a0)

• v2: Add implementation guide and relocate design docs (#62, 1ed12a0)

• v2: Add implementation guide, relocate design docs (#62, 1ed12a0)

• v2: Add same-level concurrency and retry/pool specs (#62, 1ed12a0)

• v2: Fix review issues across reorganized docs (#62, 1ed12a0)

• v2: Refine dry-run, partial mode, and concurrency contracts (#62, 1ed12a0)

• v2: Reorganize and deduplicate architecture docs (#62, 1ed12a0)

• v2: Resolve redesign doc inconsistencies (#62, 1ed12a0)

• v2: Resolve round-2 design review gaps (#62, 1ed12a0)

---

Detailed Changes: v1.2.0...v1.2.1

v1.2.0

v1.2.0 (2026-02-08)

Bug Fixes

• Resolve multi-epic review gaps and docs inconsistencies (#21, 2aec7d1)

• provider: Tighten project item id typing for mypy (#21, 2aec7d1)

Documentation

• Finalize native-only consistency and remove phase2 leftovers (#21, 2aec7d1)

• Fix native migration command with required flags (#21, 2aec7d1)

• Migrate guidance to packaged multi-epic workflow (#21, 2aec7d1)

• Switch guidance to native-only multi-epic workflow (#21, 2aec7d1)

• Update guidance for native multi-epic sync (#21, 2aec7d1)

Features

• Enable native-only multi-epic sync flow (#21, 2aec7d1)

• cli: Add sync-all command orchestration path (#21, 2aec7d1)

• slice: Harden multi-epic slicing and validation (#21, 2aec7d1)

• sync: Add multi-epic orchestrator and sync-map merge (#21, 2aec7d1)

• validator: Support native multi-epic plan validation (#21, 2aec7d1)

Refactoring

• cli: Remove sync-all compatibility path (#21, 2aec7d1)

• slice: Remove planpilot-slice compatibility path (#21, 2aec7d1)

Testing

• Drop compatibility suites and keep native-only cli coverage (#21, 2aec7d1)

• sync: Cover native multi-epic relations and dry-run (#21, 2aec7d1)

---

Detailed Changes: v1.1.4...v1.2.0