Repository navigation
release: prepare 2.0.0-preview.5 - #2506
bradygaster wants to merge 7 commits into
Conversation
Drain all 27 pending changesets into preview.5 release notes, bump the private root and public packages in lockstep (CLI -> SDK >=2.0.0-preview.5), add the 2.0.0-preview.5 CHANGELOG and whatsnew entries, regenerate the Claude plugin and marketplace against 2.0.0-preview.5, and document one team shared across hosts. Homebrew, WinGet, latest and stable stay held. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
🔴 Impact Analysis — PR #2506Risk tier: 🔴 CRITICAL 📊 Summary
🎯 Risk Factors
📦 Modules Affecteddocs (3 files)
root (32 files)
squad-cli (2 files)
squad-sdk (2 files)
tests (1 file)
|
🏗️ Architectural Review
Automated architectural review — informational only. |
🔒 Security Review
🔒 Security review: 3 info.
Automated security review — informational only. |
🛫 PR Readiness Check
PR Scope: 🔧 Infrastructure
|
| Status | Check | Details |
|---|---|---|
| ❌ | Single commit | 7 commits — consider squashing before review |
| ✅ | Not in draft | Ready for review |
| ✅ | Branch up to date | Up to date with dev |
| ❌ | Copilot review | No Copilot review yet — it may still be processing |
| ✅ | Changeset present | Changeset file found |
| ✅ | Scope clean | No .squad/ or docs/proposals/ files |
| ✅ | No merge conflicts | No merge conflicts |
| ✅ | Copilot threads resolved | No Copilot review threads |
| ✅ | CI passing | All checks passing |
Files Changed (40 files, +176 −178)
| File | +/− |
|---|---|
.changeset/backend-outage-stop.md |
+0 −6 |
.changeset/claude-agent-sdk-harness.md |
+0 −6 |
.changeset/claude-agent-tool-dispatch.md |
+0 −5 |
.changeset/claude-code-plugin.md |
+0 −8 |
.changeset/claude-dashboard.md |
+0 −5 |
.changeset/claude-demo-blockers.md |
+0 −6 |
.changeset/claude-governance-hooks.md |
+0 −6 |
.changeset/claude-init-inline-cast.md |
+0 −6 |
.changeset/claude-linked-team.md |
+0 −6 |
.changeset/claude-member-subagents.md |
+0 −6 |
.changeset/claude-polish.md |
+0 −10 |
.changeset/claude-projection-v2.md |
+0 −5 |
.changeset/claude-skills-projection.md |
+0 −5 |
.changeset/claude-watch-preset.md |
+0 −5 |
.changeset/dashboard-headless-end.md |
+0 −5 |
.changeset/decide-where-stored.md |
+0 −5 |
.changeset/doctor-real-paths.md |
+0 −5 |
.changeset/human-signoff-gate.md |
+0 −6 |
.changeset/init-next-steps.md |
+0 −5 |
.changeset/launcher-path-lookup.md |
+0 −6 |
.changeset/mcp-launcher-subfolder.md |
+0 −6 |
.changeset/plugin-icon-human-members.md |
+0 −6 |
.changeset/portable-launch.md |
+0 −6 |
.changeset/self-sufficient-digests.md |
+0 −6 |
.changeset/symlinked-team-root.md |
+0 −6 |
.claude-plugin/marketplace.json |
+1 −1 |
CHANGELOG.md |
+4 −2 |
docs/src/content/docs/scenarios/release-process.md |
+8 −8 |
docs/src/content/docs/scenarios/using-squad-across-clients.md |
+19 −0 |
docs/src/content/docs/whatsnew.md |
+4 −0 |
package-lock.json |
+13 −5 |
package.json |
+1 −1 |
packages/squad-cli/CHANGELOG.md |
+55 −0 |
packages/squad-cli/package.json |
+5 −5 |
packages/squad-sdk/CHANGELOG.md |
+57 −0 |
packages/squad-sdk/package.json |
+1 −1 |
plugins/squad/.claude-plugin/plugin.json |
+1 −1 |
plugins/squad/README.md |
+2 −2 |
plugins/squad/agents/squad.md |
+1 −1 |
test/registry-preflight.test.ts |
+4 −4 |
Total: +176 −178
This check runs automatically on every push. Fix any ❌ items and push again.
See CONTRIBUTING.md and PR Requirements for details.
There was a problem hiding this comment.
🔵 Needs a closer look
Release-owner review is needed to coordinate the marketplace’s preview.5 requirements with separate npm publication, avoiding an interval where the plugin requires an unavailable CLI or bridge.
No open issues 🎉
What changed in this PR
Prepares Squad 2.0.0-preview.5 without publishing, aligning package and Claude plugin versions and consolidating release notes for the expanded Claude Code support.
Changes:
- Bumps root, SDK, CLI, and plugin metadata to preview.5; updates the CLI’s SDK requirement and optional-peer lockfile metadata.
- Moves pending changesets into package changelogs and adds preview.5 release documentation.
- Documents shared teams across Claude Code and Copilot, and refreshes release instructions and registry-preflight fixtures.
| File | Description |
|---|---|
test/registry-preflight.test.ts |
Updates target and prior-release fixtures. |
plugins/squad/README.md |
Updates plugin version and fallback command documentation. |
plugins/squad/agents/squad.md |
Updates the coordinator’s required bridge version. |
plugins/squad/.claude-plugin/plugin.json |
Bumps plugin version. |
packages/squad-sdk/package.json |
Bumps SDK version. |
packages/squad-sdk/CHANGELOG.md |
Consolidates SDK preview.5 release notes. |
packages/squad-cli/package.json |
Bumps CLI version and SDK requirement. |
packages/squad-cli/CHANGELOG.md |
Consolidates CLI preview.5 release notes. |
package.json |
Bumps root workspace version. |
package-lock.json |
Aligns versions and records optional Claude SDK peer metadata. |
docs/src/content/docs/whatsnew.md |
Adds preview.5 highlights. |
docs/src/content/docs/scenarios/using-squad-across-clients.md |
Documents cross-host team sharing. |
docs/src/content/docs/scenarios/release-process.md |
Updates release examples and distribution holds. |
CHANGELOG.md |
Promotes Claude Code notes into the dated preview.5 section. |
.claude-plugin/marketplace.json |
Bumps marketplace plugin version. |
.changeset/symlinked-team-root.md |
Removes fragment incorporated into symlink-support notes. |
.changeset/self-sufficient-digests.md |
Removes fragment incorporated into coordinator-independence notes. |
.changeset/portable-launch.md |
Removes fragment incorporated into portable-launcher notes. |
.changeset/plugin-icon-human-members.md |
Removes fragment incorporated into plugin and template notes. |
.changeset/mcp-launcher-subfolder.md |
Removes fragment incorporated into subfolder-launch notes. |
.changeset/launcher-path-lookup.md |
Removes fragment incorporated into PATH-lookup notes. |
.changeset/init-next-steps.md |
Removes fragment incorporated into host-specific startup notes. |
.changeset/human-signoff-gate.md |
Removes fragment incorporated into human-sign-off notes. |
.changeset/doctor-real-paths.md |
Removes fragment incorporated into doctor symlink notes. |
.changeset/decide-where-stored.md |
Removes fragment incorporated into decision-storage notes. |
.changeset/dashboard-headless-end.md |
Removes fragment incorporated into dashboard completion notes. |
.changeset/claude-watch-preset.md |
Removes fragment incorporated into Claude watch-runner notes. |
.changeset/claude-skills-projection.md |
Removes fragment incorporated into native-skills notes. |
.changeset/claude-projection-v2.md |
Removes fragment incorporated into projection-v2 notes. |
.changeset/claude-polish.md |
Removes fragment incorporated into Claude follow-up notes. |
.changeset/claude-member-subagents.md |
Removes fragment incorporated into member-subagent notes. |
.changeset/claude-linked-team.md |
Removes fragment incorporated into linked-team notes. |
.changeset/claude-init-inline-cast.md |
Removes fragment incorporated into initialization notes. |
.changeset/claude-governance-hooks.md |
Removes fragment incorporated into advisory-hook notes. |
.changeset/claude-demo-blockers.md |
Removes fragment incorporated into permissions and review-gate notes. |
.changeset/claude-dashboard.md |
Removes fragment incorporated into dashboard feature notes. |
.changeset/claude-code-plugin.md |
Removes fragment incorporated into Claude plugin notes. |
.changeset/claude-agent-tool-dispatch.md |
Removes fragment incorporated into Agent-tool terminology notes. |
.changeset/claude-agent-sdk-harness.md |
Removes fragment incorporated into experimental harness notes. |
.changeset/backend-outage-stop.md |
Removes fragment incorporated into backend-outage safeguards. |
Review effort: Balanced (dynamic)
…me roster (#2522) `squad init` scaffolds the Scribe, Ralph, Rai and Fact Checker charters but leaves the roster empty, and `squad cast --name` only adds the member being cast. A team cast that way (Claude Code's Init Mode path) had no built-ins in team.md, so Copilot, which reads the roster from team.md, reported a smaller team than Claude did. - squad cast adds the `## Built-in Support Agents` table (the same one createTeam writes) when the built-in charters exist and team.md doesn't list them anywhere. It stays out of `## Members`, so Init Mode's empty-roster check is unaffected. - Coordinator wording (Copilot template and the shared source for other hosts): a roster answer lists the members and built-ins and describes the coordinator separately, instead of listing "Squad" as a member. - Regenerated the Claude plugin tree and the Copilot projection snapshot. Closes #2522 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…eview) Add a row only for a built-in whose charter exists and that the roster doesn't already list (by charter path or name row), instead of using Scribe as the sentinel for all four. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…to release/prepare-2.0.0-preview.5
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
tamirdresher
left a comment
There was a problem hiding this comment.
The new cross-host setup example invokes the wrong npm package.
| One person can use Claude Code while another uses GitHub Copilot, on the same team. List both hosts, commit what Squad writes, and each person starts their own host as usual: | ||
|
|
||
| ```bash | ||
| npx squad init --client claude,copilot |
There was a problem hiding this comment.
npx squad resolves the unscoped squad@3.0.0 package, which has no executable, so this setup command does not run Squad. Please invoke the CLI package explicitly, for example npm exec --yes --package=@bradygaster/squad-cli@2.0.0-preview.5 -- squad init --client claude,copilot.
This prepares 2.0.0-preview.5, following the same steps as the preview.4 prep (#2444). It does not publish anything.
What changes
2.0.0-preview.5in lockstep. The CLI requires SDK>=2.0.0-preview.5. The lockfile also gains the SDK's optional@anthropic-ai/claude-agent-sdkpeer metadata, whichdev's lockfile was missing.packages/squad-sdk/CHANGELOG.mdandpackages/squad-cli/CHANGELOG.md(6 minor and 16 patch entries per package). Two of them were folded in by hand from fix(claude): don't project Copilot's template Init Mode skills #2504 and fix(coordinator): a user's team decision reaches decisions.md in the same turn #2505, which removed theirs because of the changeset-drift limit.squad castnow adds the built-in members (Scribe, Ralph, Rai, Fact Checker) toteam.md, so Claude Code and Copilot report the same roster after a cast. The coordinators also describe themselves separately in roster answers. The fix branch is merged in, and its entry is folded into all three changelogs by hand (it had no changeset, because of the drift limit). The rebuilt plugin is byte-identical at preview.5. Full suite: 2 gh-aw tests failed under parallel load and pass on their own.CHANGELOG.mdgets## [2.0.0-preview.5] - 2026-11-14, with the Claude Code section that was waiting in Unreleased.whatsnew.mdgetsv2.0.0-preview.5, andrelease-process.mdandtest/registry-preflight.test.tsnow refer to preview.5.2.0.0-preview.5. The coordinator is stamped with the SDK version, so leaving the plugin pinned to preview.4 would give the stamp and the pin different versions. The merge and the dispatch should happen close together: until the preview.5 packages are on npm, the plugin'snpxfallback (opt-in withSQUAD_ALLOW_NPX=1) can't install the CLI.using-squad-across-clients.md. It's backed by today's live run: Claude Code 2.1.318 and Copilot CLI 1.0.111 sharing one squad (fix(coordinator): a user's team decision reaches decisions.md in the same turn #2505).Checks run locally
node scripts/release/policy-gates.mjs --mode=release: all 7 gates pass (workspace-integrity, prerelease-guard, node-security-floor, publish-policy, publish-allowlist, changelog-heading, changeset-drain).SKIP_BUILD_BUMP=1 npm run buildmade no version or lockfile changes.npx vitest run: 412 of 412 test files pass (13,543 tests).Held, as for preview.4: Homebrew, WinGet,
latestand stable promotion. npm publishesinsideras canonical, withpreviewas an alias.After merge (a human runs this; agents don't dispatch releases):
🤖 Generated with Claude Code