Skip to content

release: v0.30.3 — version banner fix + doctor duplication check + install docs - #603

Merged
HenryLach merged 2 commits into
mainfrom
release/v0.30.3
Jun 17, 2026
Merged

release: v0.30.3 — version banner fix + doctor duplication check + install docs#603
HenryLach merged 2 commits into
mainfrom
release/v0.30.3

Conversation

@HenryLach

Copy link
Copy Markdown
Owner

Patch release wrapping three observability/polish improvements since v0.30.2.

Patch justification (semver)

All three entries are non-breaking improvements:

  • Fixed: taskplane --version placeholder cosmetic bug — display-only.
  • Enhanced: taskplane doctor gains a new advisory check; existing checks unchanged.
  • Docs: README + install tutorial guidance updates.

No code changes affect /orch or /task execution. Patch bump (0.30.2 → 0.30.3) is the appropriate semver level.

Issues / PRs included

# Title
#601 version-banner placeholders + doctor duplication check + install docs
#602 Sage review follow-up: context-aware doctor summary, PowerShell remediation, execSync timeout

No issues are 'closed by' this release directly — both PRs were operator-experience polish in response to today's workflow discoveries around Pi 0.75.0's install-location change.

Highlights

  • Doctor now warns about the Pi-private vs npm-global duplication state that silently strands users with stale CLI versions. Includes platform-aware remediation (PowerShell on Windows, bash elsewhere). This is the actual fix for the operator-pain root cause we identified today: pi update reporting success while the system-wide CLI stays stale.
  • taskplane --version no longer shows "(vundefined, initialized unknown)" for repos where .pi/taskplane.json exists for non-init purposes (e.g. taskplane's own source repo).
  • Documentation steers new users toward the Pi-managed install (single-source via pi update) and away from npm install -g taskplane (which creates the duplication state in the first place).

Validation

Run on 54009550 (the version-bump commit):

Gate Result
npm run typecheck ✅ pass
npm run lint ✅ identical to v0.30.2
npm run format:check ✅ pass
cd extensions && npm run test:fast ✅ 3,714 / 3,715 pass, 1 skipped
node bin/taskplane.mjs help ✅ pass
node bin/taskplane.mjs doctor ✅ all checks pass
npm pack --dry-run ✅ 77 files, no spurious entries

After merge

Per the release workflow, after this PR merges I'll push the v0.30.3 tag from local. The .github/workflows/release.yml workflow handles tag validation, test re-run, npm publish --provenance via Trusted Publishing, and the GitHub release with notes extracted from CHANGELOG.

Expected total time after tag push: ~30–60 seconds.

Move the three improvements from [Unreleased] into a dated [0.30.3]
section:

  Fixed:
    - taskplane --version 'vundefined' placeholder (#601)

  Enhanced:
    - taskplane doctor duplicate-install detection with platform-aware
      remediation (#601, #602)

  Docs:
    - README install section + install tutorial Pi 0.75.0 PATH guidance
      (#601)

Insert fresh empty [Unreleased] placeholder per keep-a-changelog
convention.
@HenryLach
HenryLach enabled auto-merge June 17, 2026 21:25
@HenryLach
HenryLach merged commit e4a6f4a into main Jun 17, 2026
1 check passed
@HenryLach
HenryLach deleted the release/v0.30.3 branch June 17, 2026 21:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant