Skip to content

feat(release): parameterize npm distribution identity (rename off @bradygaster, scope TBD) - #2536

Draft
tamirdresher wants to merge 3 commits into
devfrom
squad/rename-distribution-identity
Draft

tamirdresher wants to merge 3 commits into
devfrom
squad/rename-distribution-identity

Conversation

@tamirdresher

Copy link
Copy Markdown
Collaborator

Warning

Draft, do not merge. The target npm scope is not settled. @squad on npm is not owned by this team (Brady: "if you mean there's a team at npm/squad - that's not me"), and on 2026-11-18 Brady chose to ship 2.0.0 under the existing @bradygaster names and rename later ("option 3 for now ... push it to our OG destination now, we'll move it from there later"). @github/squad-cli / @github/squad-sdk is the leading candidate, pending confirmation from GitHub's npm org owners. This PR is not part of the 2.0.0 release path.

What

Moves Squad's npm distribution identity behind a single source of truth, scripts/release/distribution-identity.json, plus a re-runnable codemod, scripts/rename-distribution-identity.mjs, and applies it to rename @bradygaster/squad-cli / @bradygaster/squad-sdk to a placeholder target (@squad/cli / @squad/sdk). Existing installs keep working: the CLI recognizes the legacy names, and squad upgrade --self (and the update banner) removes a legacy global install before installing the new package. The Homebrew tap (bradygaster/homebrew-squad) and WinGet ID (bradygaster.Squad) are recorded in the identity file but deliberately left unchanged. Nothing is published, deprecated, or dispatched.

Why

Requested by Tamir: move packages off bradygaster, then deprecate the old names once the replacements are live. Because the final scope is undecided, the rename is parameterized so retargeting is one JSON edit plus node scripts/rename-distribution-identity.mjs --write --from <old> (and the two constants in package-identity.ts).

How

  • Identity + codemod. distribution-identity.json holds current and legacy names for npm CLI/SDK, the Homebrew tap and the WinGet ID. The codemod rewrites every separator form (/, %2F, escaped, path segments), version-anchored tarball names (bradygaster-squad-cli-${VERSION}.tgz to squad-cli-${VERSION}.tgz), and skips preserved history: CHANGELOGs, blog, .squad/, .github/aw/, .changeset/, published-tarball fixtures, the upgrade-matrix fixture, and uninstall/"Upgrading from" lines. With no arguments it is a check (exit 1 if retired names remain outside preserved paths); it reports 0.
  • Runtime compatibility (packages/squad-cli/src/cli/core/package-identity.ts, zero dependencies): current/legacy names, isKnownCliPackageSpec, getInstalledCliPackageName. Used by upgrade.ts (self-upgrade command, dist-tag lookup, agent-stamp normalization), mcp-root.ts (legacy MCP entries still count as Squad-managed), mcp-spec.ts, and self-update.ts.
  • Release gates derive from the identity file: policy-gates.mjs now builds its verified-tarball allowance from the identity (packTarballPrefix), and test/publish-policy.test.ts imports that same regex, so a future retarget can't silently break the gate. workspace-lockfile.mjs, build-manifest.mjs (baseline lookup falls back to legacy names) and verify-team-isolation.mjs also read it.
  • Bug fixed along the way: scripts/release/verify-publish-evidence.mjs identified the CLI with name.endsWith('squad-cli'), which skipped the CLI-to-SDK pin check for some names; it now compares with the exact expected name.
  • Docs: new get-started/package-rename guide (uninstall-then-install for npm/pnpm/yarn, upgrade --self migration, maintainer retarget steps), plus notes in README, README.zh, CLI README and installation.
  • Kept on legacy names on purpose: samples pinned to published SDK 0.8, the upgrade-matrix fixture and the preview-tarball matrix (those artifacts were published under the old names).

⚠️ Quick Check

  • If SDK/CLI source files changed: completed the applicable Changeset step below (npx changeset add / .changeset/*.md, direct CHANGELOG.md entry for maintainers, or skip-changelog label for no user-facing changes)

PR Readiness Checklist

The PR readiness bot will validate these automatically after push.
Check each item before requesting review. See CONTRIBUTING.md for full details.

Branch & Commit

  • Branch created from dev (not main)
  • Branch is up to date with dev (git fetch upstream && git rebase upstream/dev)
  • Verified diff contains only intended changes (git diff --cached --stat)
  • PR is not in draft mode (mark ready when checks pass) — intentionally draft until the npm scope is confirmed
  • Commit history is clean (squash fixups before review)

Build & Test

  • npm run build passes
  • npm test passes (all tests green) — see test summary below; remaining local failures are pre-existing on dev or environmental
  • npm run lint passes (type check clean)
  • npm run lint:eslint passes
  • For migration PRs (>20 files): include test output summary in PR description

Test output summary (Windows, local):

  • SKIP_BUILD_BUMP=1 npm run build: passed.
  • npm run lint: passed. npm run lint:eslint: passed (0 errors, warnings only).
  • node scripts/release/policy-gates.mjs: all 7 gates passed (workspace-integrity, prerelease-guard, node-security-floor, publish-policy, publish-allowlist, changelog-heading, changeset-drain).
  • node scripts/rename-distribution-identity.mjs: 0 files still reference retired identities.
  • node scripts/check-shebang-eol.mjs: passed.
  • npx vitest run test/publish-policy.test.ts test/package-identity.test.ts test/squad-20-preview-tarball-matrix.test.ts test/standalone-release-workflow.test.ts test/verify-preview-evidence.test.ts test/cli/upgrade.test.ts test/template-sync.test.ts: 7 files passed, 602 passed, 50 skipped.
  • Full npm test: the parallel run on this machine hit widespread 5s timeouts under load. Rerunning the non-timeout failures in isolation left 4 failures in cli-packaging-smoke (forced-missing node-pty), claude-v2-review-fixes (2: backtick/< filenames, concurrent lockout) and fs-storage-symlinked-root; the same 4 fail identically on a clean dev checkout (e6ec5130), so they are pre-existing Windows issues. gh-aw compile suites fail locally with "Compilation requires gh-aw v0.91.5 with matching immutable action pins" (environmental; this PR touches no gh-aw sources or lock files). CI on Linux is authoritative.

Changeset

  • Changeset added via npx changeset add (if packages/squad-sdk/src/ or packages/squad-cli/src/ changed)
  • Or direct CHANGELOG.md entry (maintainers only — write-protected for external contributors)
  • Or skip-changelog label applied (if no user-facing changes)

Docs

  • README section updated (if new feature/module)
  • Docs feature page (if new user-facing capability)

Exports

  • package.json subpath exports updated (if new module) — N/A, no new SDK modules

Breaking Changes

Yes, once merged and published: the npm package names change. Global installs of the old CLI and both packages can't coexist (both own the squad bin), so squad upgrade --self uninstalls the legacy package first; users who installed manually follow the uninstall-then-install steps in the package-rename guide. SDK consumers must update their dependency name. The old @bradygaster packages are not deprecated or removed by this PR; deprecation is a separate step after the replacements are published and verified.

Waivers

Waived: "PR is not in draft mode", reason: blocked on npm scope ownership and on the decision to ship 2.0.0 under @bradygaster; approved by: pending.
Waived: "npm test passes", reason: local Windows failures are pre-existing on dev (verified) or environmental (gh-aw pins, load timeouts); relying on Linux CI, approved by: pending.

20 files: the large diff for this rename was explicitly approved by Tamir ("thats ok do it").

…squad/cli + @squad/sdk

Move Squad's npm packages off the @bradygaster scope behind a single identity
file (scripts/release/distribution-identity.json) and a re-runnable codemod
(scripts/rename-distribution-identity.mjs). Existing installs keep working:
the CLI recognizes legacy @bradygaster names in MCP entries and agent stamps,
and `squad upgrade --self` uninstalls the legacy package before installing the
new one. The release policy gate derives its verified tarball names from the
identity file.

Homebrew tap and WinGet ID are unchanged. Nothing is published, deprecated,
or dispatched. Do not merge until npm scope ownership is confirmed.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Comment thread README.md
Comment on lines 60 to +66
`squad-insider` Homebrew casks, or as `bradygaster.Squad.Preview` and
`bradygaster.Squad.Insider` WinGet packages.

> **Upgrading from `@bradygaster/squad-cli`?** The npm packages are now
> `@squad/cli` and `@squad/sdk`. Run `npm uninstall -g @bradygaster/squad-cli`
> before installing `@squad/cli`; see the
> [Package Rename guide](https://github.github.com/squad/docs/get-started/package-rename/).
Comment on lines 69 to +72
mcpServers:
squad_state:
command: npx
args: ["-y", "@bradygaster/squad-cli@latest", "state-mcp"]
args: ["-y", "@squad/cli@latest", "state-mcp"]
Comment thread plugins/squad/README.md
- Slash commands: `/squad:ralph`, `/squad:cast`, `/squad:ceremony`, `/squad:status`, `/squad:dashboard`.
- Squad's advisory governance hooks. They act only when `.squad/config.json` has `"claudeHooks": "advisory"`.
- `squad` on the Bash PATH. The launcher runs, in order: `SQUAD_CLI`, the project's `node_modules/@bradygaster/squad-cli`, or a `squad` on PATH. With none of them it fails and says how to install the CLI; set `SQUAD_ALLOW_NPX=1` to let it run `npx -y @bradygaster/squad-cli@2.0.0` instead.
- `squad` on the Bash PATH. The launcher runs, in order: `SQUAD_CLI`, the project's `node_modules/@squad/cli`, or a `squad` on PATH. With none of them it fails and says how to install the CLI; set `SQUAD_ALLOW_NPX=1` to let it run `npx -y @squad/cli@2.0.0` instead.
@github-actions

github-actions Bot commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

🔴 Impact Analysis — PR #2536

Risk tier: 🔴 CRITICAL

📊 Summary

Metric Count
Files changed 472
Files added 6
Files modified 466
Files deleted 0
Modules touched 9
Critical files 24

🎯 Risk Factors

  • 472 files changed (>50 → CRITICAL)
  • 9 modules touched (>8 → CRITICAL)
  • Critical files touched: package.json, packages/squad-cli/package.json, packages/squad-cli/src/cli/commands/watch/index.ts, packages/squad-cli/src/cli/shell/index.ts, packages/squad-sdk/package.json, packages/squad-sdk/src/backend/index.ts, packages/squad-sdk/src/clients/index.ts, packages/squad-sdk/src/roles/index.ts, samples/azure-function-squad/package.json, samples/hello-squad/index.ts, samples/hello-squad/package.json, samples/hook-governance/index.ts, samples/hook-governance/package.json, samples/knock-knock/index.ts, samples/knock-knock/package.json, samples/rock-paper-scissors/index.ts, samples/rock-paper-scissors/package.json, samples/skill-discovery/index.ts, samples/skill-discovery/package.json, samples/storage-provider-azure/package.json, samples/storage-provider-sqlite/index.ts, samples/storage-provider-sqlite/package.json, samples/streaming-chat/index.ts, samples/streaming-chat/package.json

📦 Modules Affected

ci-workflows (8 files)
  • .github/actions/squad-init/action.yml
  • .github/workflows/squad-ci.yml
  • .github/workflows/squad-insider-publish.yml
  • .github/workflows/squad-npm-publish.yml
  • .github/workflows/squad-promote.yml
  • .github/workflows/squad-release-verify.yml
  • .github/workflows/squad-release.yml
  • .github/workflows/squad-upgrade-matrix.yml
copilot-config (4 files)
  • .copilot/skills/architectural-review/SKILL.md
  • .copilot/skills/pr-lifecycle/SKILL.md
  • .copilot/skills/protected-files/SKILL.md
  • .copilot/skills/release-process/SKILL.md
docs (61 files)
  • docs/SQUAD-2.0-OVERVIEW.md
  • docs/migration/teams-async-adapter.md
  • docs/proposals/squad-2.0-security-and-isolation.md
  • docs/specification/README.md
  • docs/specification/adr-002-work-claims-and-external-queues.md
  • docs/specification/charter-v0.1.md
  • docs/specification/client-backend-decoupling-v0.2.md
  • docs/specification/client-harness-adapters-v0.2.md
  • docs/src/components/Footer.astro
  • docs/src/content/docs/concepts/squad-2-0-architecture.md
  • docs/src/content/docs/features/built-in-roles.md
  • docs/src/content/docs/features/claude-code-plugin.md
  • docs/src/content/docs/features/coordinator-as-agent-export.md
  • docs/src/content/docs/features/cost-tracking.md
  • docs/src/content/docs/features/dual-mode-deployment.md
  • docs/src/content/docs/features/mcp-frontmatter.md
  • docs/src/content/docs/features/scratch-dir.md
  • docs/src/content/docs/features/security-hardening.md
  • docs/src/content/docs/features/self-upgrade.md
  • docs/src/content/docs/features/standalone-install.md
  • docs/src/content/docs/features/state-backends.md
  • docs/src/content/docs/features/storage-provider.md
  • docs/src/content/docs/features/teams-comms.md
  • docs/src/content/docs/features/upstream-inheritance.md
  • docs/src/content/docs/features/vscode.md
  • docs/src/content/docs/get-started/choose-your-interface.md
  • docs/src/content/docs/get-started/choosing-your-path.md
  • docs/src/content/docs/get-started/installation.md
  • docs/src/content/docs/get-started/migration.md
  • docs/src/content/docs/get-started/package-rename.md
  • docs/src/content/docs/guide.md
  • docs/src/content/docs/guide/agent-framework-integration.md
  • docs/src/content/docs/guide/build-autonomous-agent.md
  • docs/src/content/docs/guide/contributing.md
  • docs/src/content/docs/guide/gh-aw.md
  • docs/src/content/docs/insider-program.md
  • docs/src/content/docs/reference/api-reference.md
  • docs/src/content/docs/reference/cli.md
  • docs/src/content/docs/reference/config.md
  • docs/src/content/docs/reference/container-image.md
  • docs/src/content/docs/reference/host-feature-matrix.md
  • docs/src/content/docs/reference/integration.md
  • docs/src/content/docs/reference/sdk.md
  • docs/src/content/docs/reference/tools-and-hooks.md
  • docs/src/content/docs/scenarios/disaster-recovery.md
  • docs/src/content/docs/scenarios/keep-my-squad.md
  • docs/src/content/docs/scenarios/mid-project.md
  • docs/src/content/docs/scenarios/multiple-squads.md
  • docs/src/content/docs/scenarios/new-project.md
  • docs/src/content/docs/scenarios/open-source.md
  • docs/src/content/docs/scenarios/release-process.md
  • docs/src/content/docs/scenarios/team-portability.md
  • docs/src/content/docs/scenarios/troubleshooting.md
  • docs/src/content/docs/scenarios/upgrading.md
  • docs/src/content/docs/scenarios/using-squad-across-clients.md
  • docs/src/content/docs/sdk-first-mode.md
  • docs/src/content/docs/whatsnew.md
  • docs/src/navigation.ts
  • docs/src/pages/index.astro
  • docs/tutorials/durable-backend-and-custom-harness.md
  • docs/tutorials/multi-client-quickstart.md
root (63 files)
  • .changeset/rename-npm-packages-squad-scope.md
  • CONTRIBUTING.md
  • CONTRIBUTORS.md
  • Dockerfile
  • README.md
  • README.zh.md
  • cli.js
  • package-lock.json
  • package.json
  • plugins/squad/README.md
  • plugins/squad/scripts/squad.mjs
  • plugins/squad/skills/e2e-template-testing/SKILL.md
  • plugins/squad/skills/release-process/SKILL.md
  • plugins/squad/skills/squad-version-check/SKILL.md
  • plugins/squad/skills/versioning-policy/SKILL.md
  • samples/azure-function-squad/package-lock.json
  • samples/azure-function-squad/package.json
  • samples/azure-function-squad/src/squad/config.ts
  • samples/hello-squad/docs/PRD.md
  • samples/hello-squad/index.ts
  • samples/hello-squad/package-lock.json
  • samples/hello-squad/package.json
  • samples/hello-squad/tests/hello-squad.test.ts
  • samples/hook-governance/docs/PRD.md
  • samples/hook-governance/index.ts
  • samples/hook-governance/package-lock.json
  • samples/hook-governance/package.json
  • samples/hook-governance/tests/hook-governance.test.ts
  • samples/knock-knock/index.ts
  • samples/knock-knock/package-lock.json
  • samples/knock-knock/package.json
  • samples/rock-paper-scissors/index.ts
  • samples/rock-paper-scissors/package-lock.json
  • samples/rock-paper-scissors/package.json
  • samples/skill-discovery/TEST-SCRIPT.md
  • samples/skill-discovery/docs/PRD.md
  • samples/skill-discovery/index.ts
  • samples/skill-discovery/package.json
  • samples/skill-discovery/tests/skill-discovery.test.ts
  • samples/storage-provider-azure/README.md
  • samples/storage-provider-azure/azure-blob-storage-provider.ts
  • samples/storage-provider-azure/package-lock.json
  • samples/storage-provider-azure/package.json
  • samples/storage-provider-sqlite/README.md
  • samples/storage-provider-sqlite/index.ts
  • samples/storage-provider-sqlite/package-lock.json
  • samples/storage-provider-sqlite/package.json
  • samples/streaming-chat/docs/PRD.md
  • samples/streaming-chat/index.ts
  • samples/streaming-chat/package-lock.json
  • samples/streaming-chat/package.json
  • samples/streaming-chat/tests/streaming-chat.test.ts
  • templates/model-selection-reference.md
  • templates/ralph-reference.md
  • templates/session-init-reference.md
  • templates/skills/e2e-template-testing/SKILL.md
  • templates/skills/release-process/SKILL.md
  • templates/skills/squad-version-check/SKILL.md
  • templates/skills/versioning-policy/SKILL.md
  • templates/workflows/squad-insider-release.yml
  • test-fixtures/spec/suite-v0.2/host-feature-matrix.json
  • test-fixtures/spec/suite-v0.2/upgrade-matrix.json
  • vitest.config.ts
scripts (26 files)
  • scripts/build-standalone.mjs
  • scripts/bump-build.mjs
  • scripts/generate-api-docs.mjs
  • scripts/promote-insider-tag.mjs
  • scripts/release/assert-publish-identity.mjs
  • scripts/release/build-manifest.mjs
  • scripts/release/classify-npm-registry.mjs
  • scripts/release/closure-items.json
  • scripts/release/distribution-identity.json
  • scripts/release/emit-pack-evidence-hashes.mjs
  • scripts/release/manifest.schema.json
  • scripts/release/npm-pair-verify.mjs
  • scripts/release/override-standalone-package-versions.mjs
  • scripts/release/pack-evidence.mjs
  • scripts/release/policy-gates.mjs
  • scripts/release/registry-preflight.mjs
  • scripts/release/set-package-versions.mjs
  • scripts/release/smoke-sdk-exports.mjs
  • scripts/release/verify-draft-release-assets.mjs
  • scripts/release/verify-preview-evidence.mjs
  • scripts/release/verify-publish-evidence.mjs
  • scripts/release/workspace-lockfile.mjs
  • scripts/rename-distribution-identity.mjs
  • scripts/render-upgrade-matrix.mjs
  • scripts/run-benchmarks.mjs
  • scripts/verify-team-isolation.mjs
squad-cli (88 files)
  • packages/squad-cli/README.md
  • packages/squad-cli/package.json
  • packages/squad-cli/src/cli-entry.ts
  • packages/squad-cli/src/cli/commands/build.ts
  • packages/squad-cli/src/cli/commands/cast.ts
  • packages/squad-cli/src/cli/commands/client.ts
  • packages/squad-cli/src/cli/commands/config.ts
  • packages/squad-cli/src/cli/commands/copilot.ts
  • packages/squad-cli/src/cli/commands/cost.ts
  • packages/squad-cli/src/cli/commands/cross-squad.ts
  • packages/squad-cli/src/cli/commands/doctor.ts
  • packages/squad-cli/src/cli/commands/economy.ts
  • packages/squad-cli/src/cli/commands/export.ts
  • packages/squad-cli/src/cli/commands/externalize.ts
  • packages/squad-cli/src/cli/commands/health.ts
  • packages/squad-cli/src/cli/commands/hook.ts
  • packages/squad-cli/src/cli/commands/import.ts
  • packages/squad-cli/src/cli/commands/init-remote.ts
  • packages/squad-cli/src/cli/commands/install-hooks.ts
  • packages/squad-cli/src/cli/commands/link.ts
  • packages/squad-cli/src/cli/commands/lockout.ts
  • packages/squad-cli/src/cli/commands/loop.ts
  • packages/squad-cli/src/cli/commands/memory.ts
  • packages/squad-cli/src/cli/commands/migrate-backend.ts
  • packages/squad-cli/src/cli/commands/migrate.ts
  • packages/squad-cli/src/cli/commands/models.ts
  • packages/squad-cli/src/cli/commands/notes.ts
  • packages/squad-cli/src/cli/commands/plugin.ts
  • packages/squad-cli/src/cli/commands/preset.ts
  • packages/squad-cli/src/cli/commands/rc.ts
  • packages/squad-cli/src/cli/commands/roles.ts
  • packages/squad-cli/src/cli/commands/schedule.ts
  • packages/squad-cli/src/cli/commands/start.ts
  • packages/squad-cli/src/cli/commands/state-mcp.ts
  • packages/squad-cli/src/cli/commands/streams.ts
  • packages/squad-cli/src/cli/commands/update-check.ts
  • packages/squad-cli/src/cli/commands/upstream.ts
  • packages/squad-cli/src/cli/commands/watch/agent-spawn.ts
  • packages/squad-cli/src/cli/commands/watch/capabilities/cleanup.ts
  • packages/squad-cli/src/cli/commands/watch/capabilities/decision-hygiene.ts
  • packages/squad-cli/src/cli/commands/watch/capabilities/execute.ts
  • packages/squad-cli/src/cli/commands/watch/capabilities/fleet-dispatch.ts
  • packages/squad-cli/src/cli/commands/watch/capabilities/notes-promote.ts
  • packages/squad-cli/src/cli/commands/watch/capabilities/retro.ts
  • packages/squad-cli/src/cli/commands/watch/claim-counters.ts
  • packages/squad-cli/src/cli/commands/watch/claim-metrics.ts
  • packages/squad-cli/src/cli/commands/watch/claims.ts
  • packages/squad-cli/src/cli/commands/watch/config.ts
  • packages/squad-cli/src/cli/commands/watch/index.ts
  • packages/squad-cli/src/cli/commands/watch/types.ts
  • packages/squad-cli/src/cli/copilot-install.ts
  • packages/squad-cli/src/cli/core/backend-mcp.ts
  • packages/squad-cli/src/cli/core/cast.ts
  • packages/squad-cli/src/cli/core/clients.ts
  • packages/squad-cli/src/cli/core/effective-squad-dir.ts
  • packages/squad-cli/src/cli/core/email-scrub.ts
  • packages/squad-cli/src/cli/core/init.ts
  • packages/squad-cli/src/cli/core/mcp-probe.ts
  • packages/squad-cli/src/cli/core/mcp-root.ts
  • packages/squad-cli/src/cli/core/mcp-spec.ts
  • packages/squad-cli/src/cli/core/migrate-directory.ts
  • packages/squad-cli/src/cli/core/migrations.ts
  • packages/squad-cli/src/cli/core/nap.ts
  • packages/squad-cli/src/cli/core/npm-registry.ts
  • packages/squad-cli/src/cli/core/package-identity.ts
  • packages/squad-cli/src/cli/core/project-type.ts
  • packages/squad-cli/src/cli/core/team-md.ts
  • packages/squad-cli/src/cli/core/templates.ts
  • packages/squad-cli/src/cli/core/upgrade.ts
  • packages/squad-cli/src/cli/core/version.ts
  • packages/squad-cli/src/cli/self-update.ts
  • packages/squad-cli/src/cli/shell/commands.ts
  • packages/squad-cli/src/cli/shell/coordinator.ts
  • packages/squad-cli/src/cli/shell/index.ts
  • packages/squad-cli/src/cli/shell/lifecycle.ts
  • packages/squad-cli/src/cli/shell/session-store.ts
  • packages/squad-cli/src/cli/shell/shell-metrics.ts
  • packages/squad-cli/src/cli/shell/spawn.ts
  • packages/squad-cli/src/cli/shell/stream-bridge.ts
  • packages/squad-cli/src/cli/upgrade.ts
  • packages/squad-cli/templates/model-selection-reference.md
  • packages/squad-cli/templates/ralph-reference.md
  • packages/squad-cli/templates/session-init-reference.md
  • packages/squad-cli/templates/skills/e2e-template-testing/SKILL.md
  • packages/squad-cli/templates/skills/release-process/SKILL.md
  • packages/squad-cli/templates/skills/squad-version-check/SKILL.md
  • packages/squad-cli/templates/skills/versioning-policy/SKILL.md
  • packages/squad-cli/templates/workflows/squad-insider-release.yml
squad-sdk (20 files)
  • packages/squad-sdk/README.md
  • packages/squad-sdk/package.json
  • packages/squad-sdk/src/agents/model-selector.ts
  • packages/squad-sdk/src/backend/index.ts
  • packages/squad-sdk/src/backend/types.ts
  • packages/squad-sdk/src/build/github-dist.ts
  • packages/squad-sdk/src/build/install-migration.ts
  • packages/squad-sdk/src/client/adapters/claude-plugin.ts
  • packages/squad-sdk/src/clients/index.ts
  • packages/squad-sdk/src/config/init.ts
  • packages/squad-sdk/src/config/models.ts
  • packages/squad-sdk/src/roles/index.ts
  • packages/squad-sdk/templates/model-selection-reference.md
  • packages/squad-sdk/templates/ralph-reference.md
  • packages/squad-sdk/templates/session-init-reference.md
  • packages/squad-sdk/templates/skills/e2e-template-testing/SKILL.md
  • packages/squad-sdk/templates/skills/release-process/SKILL.md
  • packages/squad-sdk/templates/skills/squad-version-check/SKILL.md
  • packages/squad-sdk/templates/skills/versioning-policy/SKILL.md
  • packages/squad-sdk/templates/workflows/squad-insider-release.yml
templates (8 files)
  • .squad-templates/model-selection-reference.md
  • .squad-templates/ralph-reference.md
  • .squad-templates/session-init-reference.md
  • .squad-templates/skills/e2e-template-testing/SKILL.md
  • .squad-templates/skills/release-process/SKILL.md
  • .squad-templates/skills/squad-version-check/SKILL.md
  • .squad-templates/skills/versioning-policy/SKILL.md
  • .squad-templates/workflows/squad-insider-release.yml
tests (194 files)
  • test/adapter-client.test.ts
  • test/agent-doc.test.ts
  • test/agent-name-extraction.test.ts
  • test/agent-session-manager.test.ts
  • test/agent-source-github.test.ts
  • test/agents.test.ts
  • test/aspire-command.test.ts
  • test/aspire-integration.test.ts
  • test/backend.test.ts
  • test/benchmarks.test.ts
  • test/bundle.test.ts
  • test/capabilities.test.ts
  • test/casting-handwritten-repair.test.ts
  • test/casting-history.test.ts
  • test/casting-registry-template.test.ts
  • test/casting.test.ts
  • test/catalog-refresh.test.ts
  • test/charter-compiler.test.ts
  • test/charter-spec.test.ts
  • test/claude-hooks.test.ts
  • test/claude-plugin.test.ts
  • test/claude-projection-v3-plugin.test.ts
  • test/cli-packaging-smoke.test.ts
  • test/cli.test.ts
  • test/cli/cast.test.ts
  • test/cli/copilot-bridge.test.ts
  • test/cli/copilot.test.ts
  • test/cli/doctor.test.ts
  • test/cli/export-import.test.ts
  • test/cli/health-command.test.ts
  • test/cli/health-legacy.test.ts
  • test/cli/init-remote.test.ts
  • test/cli/init-upgrade-parity.test.ts
  • test/cli/init.test.ts
  • test/cli/legacy-casting-upgrade.test.ts
  • test/cli/link.test.ts
  • test/cli/loop.test.ts
  • test/cli/patch-esm-imports.test.ts
  • test/cli/preview2-cli-fixes.test.ts
  • test/cli/rai-rename-git.test.ts
  • test/cli/rc-tunnel.test.ts
  • test/cli/rc.test.ts
  • test/cli/remote-mode.test.ts
  • test/cli/roster.test.ts
  • test/cli/scrub-emails.test.ts
  • test/cli/start.test.ts
  • test/cli/state-mcp.test.ts
  • test/cli/upgrade-idempotent.test.ts
  • test/cli/upgrade-portability.test.ts
  • test/cli/upgrade.test.ts
  • test/cli/watch-capabilities.test.ts
  • test/cli/watch-circuit-breaker.test.ts
  • test/cli/watch-claim-telemetry.test.ts
  • test/cli/watch-claims.test.ts
  • test/cli/watch-double-pick.test.ts
  • test/cli/watch-health.test.ts
  • test/cli/watch.test.ts
  • test/client.test.ts
  • test/clients.test.ts
  • test/compat-v041.test.ts
  • test/config-integration.test.ts
  • test/config-schema.test.ts
  • test/config.test.ts
  • test/consumer-imports.test.ts
  • test/coordinator-routing.test.ts
  • test/coordinator.test.ts
  • test/crlf-normalization.test.ts
  • test/cross-package-exports.test.ts
  • test/detect-squad-dir-zero-deps.test.ts
  • test/direct-response.test.ts
  • test/docs-site-location.test.ts
  • test/dual-root-resolver.test.ts
  • test/e2e-migration.test.ts
  • test/economy-mode.test.ts
  • test/effective-squad-dir.test.ts
  • test/ensure-squad-path-dual.test.ts
  • test/error-messages.test.ts
  • test/errors.test.ts
  • test/event-bus.test.ts
  • test/external-state.test.ts
  • test/fact-checker-role.test.ts
  • test/fan-out.test.ts
  • test/feature-audit.test.ts
  • test/feature-parity.test.ts
  • test/first-run-gating.test.ts
  • test/fixtures/squad-init-approved.json
  • test/gh-aw-enlistment-skill.test.ts
  • test/gh-aw-quality.test.ts
  • test/helpers/claim-provider-contract.ts
  • test/history-shadow.test.ts
  • test/hooks-security.test.ts
  • test/hooks.test.ts
  • test/i18n.test.ts
  • test/init-scaffolding.test.ts
  • test/init-sdk.test.ts
  • test/init.test.ts
  • test/install.test.ts
  • test/integration.test.ts
  • test/launcher-argv.test.ts
  • test/lifecycle.test.ts
  • test/marketplace-advanced.test.ts
  • test/marketplace-integration.test.ts
  • test/marketplace.test.ts
  • test/mcp-root-write.test.ts
  • test/mcp-spec-init.test.ts
  • test/migrate.test.ts
  • test/migration.test.ts
  • test/migrations.test.ts
  • test/model-fallback.test.ts
  • test/model-hydrafusion.test.ts
  • test/model-preference.test.ts
  • test/model-quality-profiles.test.ts
  • test/model-selector-policy.test.ts
  • test/models-refresh.test.ts
  • test/models.test.ts
  • test/npm-registry-fallback.test.ts
  • test/npm-registry-reconciliation.test.ts
  • test/offline.test.ts
  • test/otel-agent-traces.test.ts
  • test/otel-bridge.test.ts
  • test/otel-coordinator-traces.test.ts
  • test/otel-export.test.ts
  • test/otel-integration-e2e.test.ts
  • test/otel-metric-wiring.test.ts
  • test/otel-metrics.test.ts
  • test/otel-provider.test.ts
  • test/package-exports.test.ts
  • test/package-identity.test.ts
  • test/parser-contracts.test.ts
  • test/portable-launch.test.ts
  • test/presets.test.ts
  • test/profile-boundary.test.ts
  • test/profile-squad-tombstone.test.ts
  • test/promote-insider-tag-spawn.test.ts
  • test/promote-insider-tag.test.ts
  • test/publish-policy.test.ts
  • test/ralph-claims-git.test.ts
  • test/ralph-claims.test.ts
  • test/rate-limiting.test.ts
  • test/registry-preflight.test.ts
  • test/release-pack-install.test.ts
  • test/release-policy-changeset-drain.test.ts
  • test/release.test.ts
  • test/remote-control.test.ts
  • test/repl-ux-fixes.test.ts
  • test/repo-sync.test.ts
  • test/resolution.test.ts
  • test/resolve-cache.test.ts
  • test/response-tiers.test.ts
  • test/rework.test.ts
  • test/routing.test.ts
  • test/scratch-dir.test.ts
  • test/scripts/crlf-worktree-repair.test.ts
  • test/sdk-real-session.test.ts
  • test/sdk/squad-decide-inbox.test.ts
  • test/sdk/squad-route.test.ts
  • test/self-upgrade.test.ts
  • test/session-adapter.test.ts
  • test/session-store.test.ts
  • test/session-traces.test.ts
  • test/sharing-advanced.test.ts
  • test/sharing.test.ts
  • test/shell-integration.test.ts
  • test/shell-metrics.test.ts
  • test/shell-polish.test.ts
  • test/shell.test.ts
  • test/skill-script-loader.test.ts
  • test/skill-source.test.ts
  • test/skills.test.ts
  • test/spawn-backend.test.ts
  • test/speed-gates.test.ts
  • test/squad-20-all-scenarios.e2e.test.ts
  • test/squad-20-pack-smoke.test.ts
  • test/squad-20-preview-tarball-matrix.test.ts
  • test/squad-20-real-clients-stdio.e2e.test.ts
  • test/squad-20-security-contracts.test.ts
  • test/squad-20-upgrade-matrix.test.ts
  • test/squad-observer.test.ts
  • test/standalone-release-workflow.test.ts
  • test/streaming.test.ts
  • test/telemetry-auto-wiring.test.ts
  • test/telemetry.test.ts
  • test/template-sync.test.ts
  • test/tool-name-normalization.test.ts
  • test/tools.test.ts
  • test/type-extensions.test.ts
  • test/upgrade-eperm-false-success.test.ts
  • test/upgrade-profile-teamroot.test.ts
  • test/upgrade-state-backend.test.ts
  • test/verify-draft-release-assets.test.ts
  • test/verify-preview-evidence.test.ts
  • test/verify-publish-evidence.test.ts
  • test/watch-run-bounds-runtime.test.ts
  • test/worktree.test.ts

⚠️ Critical Files

  • package.json
  • packages/squad-cli/package.json
  • packages/squad-cli/src/cli/commands/watch/index.ts
  • packages/squad-cli/src/cli/shell/index.ts
  • packages/squad-sdk/package.json
  • packages/squad-sdk/src/backend/index.ts
  • packages/squad-sdk/src/clients/index.ts
  • packages/squad-sdk/src/roles/index.ts
  • samples/azure-function-squad/package.json
  • samples/hello-squad/index.ts
  • samples/hello-squad/package.json
  • samples/hook-governance/index.ts
  • samples/hook-governance/package.json
  • samples/knock-knock/index.ts
  • samples/knock-knock/package.json
  • samples/rock-paper-scissors/index.ts
  • samples/rock-paper-scissors/package.json
  • samples/skill-discovery/index.ts
  • samples/skill-discovery/package.json
  • samples/storage-provider-azure/package.json
  • samples/storage-provider-sqlite/index.ts
  • samples/storage-provider-sqlite/package.json
  • samples/streaming-chat/index.ts
  • samples/streaming-chat/package.json

This report is generated automatically for every PR. See #733 for details.

@github-actions

github-actions Bot commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

🛫 PR Readiness Check

ℹ️ This comment updates on each push. Last checked: commit 1dd1a6c

PR Scope: 📦🔧 Mixed (product + infrastructure)

⚠️ 4 item(s) to address before review

Status Check Details
❌ Single commit 3 commits — consider squashing before review
❌ Not in draft PR is still in draft — mark as ready for review when done
✅ 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 ⚠️ PR includes 1 docs/proposals/ file(s) — ensure these are intentional
✅ No merge conflicts No merge conflicts
✅ Copilot threads resolved No Copilot review threads
❌ CI passing 18 check(s) still running

Files Changed (472 files, +2355 −1870)

File +/−
.changeset/rename-npm-packages-squad-scope.md +6 −0
.copilot/skills/architectural-review/SKILL.md +4 −4
.copilot/skills/pr-lifecycle/SKILL.md +2 −2
.copilot/skills/protected-files/SKILL.md +1 −1
.copilot/skills/release-process/SKILL.md +5 −5
.github/actions/squad-init/action.yml +1 −1
.github/workflows/squad-ci.yml +1 −1
.github/workflows/squad-insider-publish.yml +6 −6
.github/workflows/squad-npm-publish.yml +12 −12
.github/workflows/squad-promote.yml +4 −4
.github/workflows/squad-release-verify.yml +2 −2
.github/workflows/squad-release.yml +1 −1
.github/workflows/squad-upgrade-matrix.yml +1 −1
.squad-templates/model-selection-reference.md +1 −1
.squad-templates/ralph-reference.md +8 −8
.squad-templates/session-init-reference.md +1 −1
.squad-templates/skills/e2e-template-testing/SKILL.md +3 −3
.squad-templates/skills/release-process/SKILL.md +7 −7
.squad-templates/skills/squad-version-check/SKILL.md +7 −7
.squad-templates/skills/versioning-policy/SKILL.md +4 −4
.squad-templates/workflows/squad-insider-release.yml +1 −1
CONTRIBUTING.md +7 −7
CONTRIBUTORS.md +1 −1
Dockerfile +1 −1
README.md +11 −6
README.zh.md +10 −6
cli.js +2 −2
docs/SQUAD-2.0-OVERVIEW.md +6 −6
docs/migration/teams-async-adapter.md +2 −2
docs/proposals/squad-2.0-security-and-isolation.md +1 −1
docs/specification/README.md +1 −1
docs/specification/adr-002-work-claims-and-external-queues.md +1 −1
docs/specification/charter-v0.1.md +1 −1
docs/specification/client-backend-decoupling-v0.2.md +2 −2
docs/specification/client-harness-adapters-v0.2.md +6 −6
docs/src/components/Footer.astro +2 −2
docs/src/content/docs/concepts/squad-2-0-architecture.md +10 −10
docs/src/content/docs/features/built-in-roles.md +1 −1
docs/src/content/docs/features/claude-code-plugin.md +3 −3
docs/src/content/docs/features/coordinator-as-agent-export.md +2 −2
docs/src/content/docs/features/cost-tracking.md +1 −1
docs/src/content/docs/features/dual-mode-deployment.md +2 −2
docs/src/content/docs/features/mcp-frontmatter.md +2 −2
docs/src/content/docs/features/scratch-dir.md +3 −3
docs/src/content/docs/features/security-hardening.md +1 −1
docs/src/content/docs/features/self-upgrade.md +2 −2
docs/src/content/docs/features/standalone-install.md +1 −1
docs/src/content/docs/features/state-backends.md +3 −3
docs/src/content/docs/features/storage-provider.md +2 −2
docs/src/content/docs/features/teams-comms.md +2 −2
... +422 more files

Total: +2355 −1870


This check runs automatically on every push. Fix any ❌ items and push again.
See CONTRIBUTING.md and PR Requirements for details.

@github-actions

github-actions Bot commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

🏗️ Architectural Review

Authoritative evidence: scanners from the PR base commit, posted by the default-branch workflow_run reporter.
Results for head commit 1dd1a6cb64e7ca491138f75cd5ed04e14add8c97.

⚠️ Architectural review: 2 warning(s).

Severity Category Finding Files
🟡 warning bootstrap-area 19 file(s) in the bootstrap area (packages/squad-cli/src/cli/core/) were modified. These files must maintain zero external dependencies. Review carefully. packages/squad-cli/src/cli/core/backend-mcp.ts, packages/squad-cli/src/cli/core/cast.ts, packages/squad-cli/src/cli/core/clients.ts, packages/squad-cli/src/cli/core/effective-squad-dir.ts, packages/squad-cli/src/cli/core/email-scrub.ts, packages/squad-cli/src/cli/core/init.ts, packages/squad-cli/src/cli/core/mcp-probe.ts, packages/squad-cli/src/cli/core/mcp-root.ts, packages/squad-cli/src/cli/core/mcp-spec.ts, packages/squad-cli/src/cli/core/migrate-directory.ts, packages/squad-cli/src/cli/core/migrations.ts, packages/squad-cli/src/cli/core/nap.ts, packages/squad-cli/src/cli/core/npm-registry.ts, packages/squad-cli/src/cli/core/package-identity.ts, packages/squad-cli/src/cli/core/project-type.ts, packages/squad-cli/src/cli/core/team-md.ts, packages/squad-cli/src/cli/core/templates.ts, packages/squad-cli/src/cli/core/upgrade.ts, packages/squad-cli/src/cli/core/version.ts
🟡 warning sweeping-refactor This PR touches 472 files (472 modified/added, 0 deleted). Large PRs are harder to review — consider splitting if possible. —

Automated architectural review — informational only.

…ntity

Pinned npm producers (0.9.1, 0.13.1, 1.0.0) were published as
@bradygaster/squad-cli and @bradygaster/squad-sdk, so the suite now picks
whichever known current/legacy identity the fixture pins, and packs the
tree under test under the current names. The renderer reads the same
file, so a later scope retarget leaves the harness unchanged.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

/** Registry metadata path for a scoped name, e.g. `@squad%2Fcli`. */
export function registryPackagePath(name: string): string {
return name.replace('/', '%2F');
});

it('encodes scoped names for registry URLs', () => {
expect(registryPackagePath(CLI_PACKAGE_NAME)).toBe(CLI_PACKAGE_NAME.replace('/', '%2F'));
): string {
const tag: SelfUpgradeTag = typeof insiderOrTag === 'boolean' ? (insiderOrTag ? 'insider' : 'latest') : insiderOrTag;
const pkg = `@bradygaster/squad-cli@${tag}`;
const pkg = `${CLI_PACKAGE_NAME}@${tag}`;
case 'pnpm': return `pnpm add -g ${pkg}`;
case 'yarn': return `yarn global add ${pkg}`;
default: return `npm install -g ${pkg}`;
case 'pnpm': return `${legacy ? `pnpm remove -g ${legacy} && ` : ''}pnpm add -g ${pkg}`;
case 'yarn': return `yarn global add ${pkg}`;
default: return `npm install -g ${pkg}`;
case 'pnpm': return `${legacy ? `pnpm remove -g ${legacy} && ` : ''}pnpm add -g ${pkg}`;
case 'yarn': return `${legacy ? `yarn global remove ${legacy} && ` : ''}yarn global add ${pkg}`;
default: return `npm install -g ${pkg}`;
case 'pnpm': return `${legacy ? `pnpm remove -g ${legacy} && ` : ''}pnpm add -g ${pkg}`;
case 'yarn': return `${legacy ? `yarn global remove ${legacy} && ` : ''}yarn global add ${pkg}`;
default: return `${legacy ? `npm uninstall -g ${legacy} && ` : ''}npm install -g ${pkg}`;
Both platforms re-recorded by run 44384646543 at the identity-aware
harness (48482391aaaf): 35 pass, 7 structurally inapplicable, 0 fail per
OS. Folded with render-upgrade-matrix.mjs --merge; only runs data and the
generated docs section change.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

This branch has not been deployed

No deployments
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.

2 participants