Title: Docs: Migration guide pins v0.8.18 — should reference latest or @latest · Issue #320 · github/squad · GitHub
Open Graph Title: Docs: Migration guide pins v0.8.18 — should reference latest or @latest · Issue #320 · github/squad
X Title: Docs: Migration guide pins v0.8.18 — should reference latest or @latest · Issue #320 · github/squad
Description: Squad: AI agent teams for any project. Contribute to github/squad development by creating an account on GitHub.
Open Graph Description: Squad: AI agent teams for any project. Contribute to github/squad development by creating an account on GitHub.
X Description: Squad: AI agent teams for any project. Contribute to github/squad development by creating an account on GitHub.
Opengraph URL: https://github.com/github/squad
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Docs: Migration guide pins v0.8.18 — should reference latest or @latest","articleBody":"## Problem\n\nThe [migration guide](https://bradygaster.github.io/squad/docs/get-started/migration/) 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).\n\nCurrent latest release is **v0.8.25**.\n\n## Affected Sections\n\nThe following all explicitly reference `0.8.18`:\n\n- **Quick Reference table** — shows `v0.8.18` as the \"After\" version\n- **Scenario 2** (Upgrading from v0.5.4 Beta), Step 3:\n `npm install -g @bradygaster/squad-cli@0.8.18`\n- **Scenario 3** (Already on v0.8.x) — `Expected output: 0.8.18`\n- **Scenario 8** (CI/CD) — pins `@0.8.18` in workflow examples\n- **\"What's New in v0.8.18\"** section heading in the TOC\n\n## Impact\n\nUsers following the migration guide install v0.8.18, which crashes on Node 24+ with:\n\n```\nError [ERR_MODULE_NOT_FOUND]: Cannot find module '...vscode-jsonrpc/node'\n```\n\nThis was fixed in v0.8.23 but the docs send users to the broken version.\n\n## Suggested Fix\n\n- Replace pinned `@0.8.18` references with `@latest` (or at minimum `@0.8.25`)\n- For CI/CD pinning advice, recommend pinning to the *current* latest rather than hard-coding `0.8.18`\n- Update the Quick Reference table and TOC to reflect the current version","author":{"url":"https://github.com/uvirk","@type":"Person","name":"uvirk"},"datePublished":"2026-03-09T18:53:02Z","url":"https://github.com/github/squad/issues/320"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /:user_id/:repository/issues/:id(.:format) |
| route-controller | issues |
| route-action | show |
| fetch-nonce | v2:6b211663-781d-b3a8-8a4c-3dca58a9a298 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | CD1C:2E124E:1972D29:2073813:6B014E42 |
| html-safe-nonce | 58c232475ac31920c467d7eff58a1a8803fb3eaffa02de027e1359fc95921274 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJDRDFDOjJFMTI0RToxOTcyRDI5OjIwNzM4MTM6NkIwMTRFNDIiLCJ2aXNpdG9yX2lkIjoiNzcwODI4ODA1MTE0NzAwMTQxMCIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | ce6ab6285104125257766953e0c105e83f67904ef4bcbfac9e70b6694e4f25a2 |
| hovercard-subject-tag | repository:1151205052 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/github/squad/issues/320 |
| twitter:image | https://opengraph.githubassets.com/1aa2f2df0f926e36f8dd3089f1ab8db7f8cb492371a4f46631e2985d33baee67/github/squad |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/1aa2f2df0f926e36f8dd3089f1ab8db7f8cb492371a4f46631e2985d33baee67/github/squad |
| og:image:alt | Squad: AI agent teams for any project. Contribute to github/squad development by creating an account on GitHub. |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| hostname | github.com |
| expected-hostname | github.com |
| None | cc5dfdd32f62ebd3223cab3af3aa2b268d3605218237326a48a99d1efd89495c |
| turbo-cache-control | no-cache |
| go-import | github.com/github/squad git https://github.com/github/squad.git |
| octolytics-dimension-user_id | 9919 |
| octolytics-dimension-user_login | github |
| octolytics-dimension-repository_id | 1151205052 |
| octolytics-dimension-repository_nwo | github/squad |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 1151205052 |
| octolytics-dimension-repository_network_root_nwo | github/squad |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 8c77c9e8439031ad54c75a250694842892f693e1 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width