Repository navigation
Docs: Migration guide pins v0.8.18 — should reference latest or @latest #320
Description
Problem
The migration guide hard-codes @0.8.18 throughout, which leads users to install an outdated version that is missing critical fixes (e.g., the Node 24+ ESM compatibility fix shipped in v0.8.23).
Current latest release is v0.8.25.
Affected Sections
The following all explicitly reference 0.8.18:
- Quick Reference table — shows
v0.8.18as the "After" version - Scenario 2 (Upgrading from v0.5.4 Beta), Step 3:
npm install -g @bradygaster/squad-cli@0.8.18 - Scenario 3 (Already on v0.8.x) —
Expected output: 0.8.18 - Scenario 8 (CI/CD) — pins
@0.8.18in workflow examples - "What's New in v0.8.18" section heading in the TOC
Impact
Users following the migration guide install v0.8.18, which crashes on Node 24+ with:
Error [ERR_MODULE_NOT_FOUND]: Cannot find module '...vscode-jsonrpc/node'
This was fixed in v0.8.23 but the docs send users to the broken version.
Suggested Fix
- Replace pinned
@0.8.18references with@latest(or at minimum@0.8.25) - For CI/CD pinning advice, recommend pinning to the current latest rather than hard-coding
0.8.18 - Update the Quick Reference table and TOC to reflect the current version
Activity
fix: harden adapter layer - event mapping, typed casts, dead code (gi…
bradygaster commentedon Mar 10, 2026
Triage: Migration guide pins v0.8.18 — outdated, sends users to broken version. Should reference @latest or v0.8.25+. P1 — docs quality & correctness. @pao + @Surgeon to coordinate.
github-actions commentedon Mar 10, 2026
📋 Assigned to PAO (DevRel)
Issue: #320 — Docs: Migration guide pins v0.8.18 — should reference latest or @latest
PAO will pick this up in the next Copilot session.
bradygaster commentedon Mar 10, 2026
Triage by PAO
The migration guide hard-codes v0.8.18 throughout—users following it install an outdated version missing Node 24+ compatibility fixes (shipped in v0.8.23, current is v0.8.25).
Affected sections:
Fix needed:
Replace hard-coded v0.8.18 references with @latest (or @0.8.25 minimum). For CI/CD advice, recommend versioning to current latest rather than a fixed old version.
This is P1 — blocks users on current Node versions.
github-actions commentedon Mar 13, 2026
📋 Assigned to PAO (DevRel)
Issue: #320 — Docs: Migration guide pins v0.8.18 — should reference latest or @latest
PAO will pick this up in the next Copilot session.
docs: Replace hardcoded v0.8.18 refs with @latest and add Node.js 24+…
docs: update migration guide to use @latest instead of pinned v0.8.18 (…
docs: update migration guide to use @latest instead of pinned v0.8.18 (…
docs: update migration guide to use @latest instead of pinned v0.8.18 (…