Skip to content

chore(release): prepare v1.0.0 - #2150

Merged
tamirdresher merged 1 commit into
github:devfrom
tamirdresher:tamirdresher-microsoft-laughing-barnacle
Oct 2, 2026
Merged

tamirdresher merged 1 commit into
github:devfrom
tamirdresher:tamirdresher-microsoft-laughing-barnacle

Conversation

@tamirdresher

Copy link
Copy Markdown
Collaborator

Summary

Prepares Squad CLI/SDK for a 1.0.0 stable release:

  • Bump version 0.13.1 -> 1.0.0 in root package.json, packages/squad-cli/package.json, packages/squad-sdk/package.json, and matching package-lock.json entries.
  • Bump squad-cli's dependency floor on @bradygaster/squad-sdk from >=0.11.0 to >=1.0.0.
  • Add ## [1.0.0] - 2026-10-02 entry to CHANGELOG.md.
  • Remove the blanket "Experimental - Squad is alpha software" banner from 87 docs files under docs/src/content/docs/**, while leaving genuine preview-channel language intact (SDK-first mode warning, GitLab Issues Mode, plugin-security MVP gate, preview/insider channel labels).

Not touched: src/Squad.Agents.AI (.NET/NuGet) - already released at 1.0.0 via #2143, immutable, not re-published here. Pending .changeset/*.md fragments for unrelated feature work are out of scope.

Release process note

This PR targets dev, not main. Per .github/workflows/squad-promote.yml, promotion to main is performed by a bot-dispatched job that merges dev -> main itself (stripping internal .squad//.ai-team/ paths, validating version/CHANGELOG consistency, building, and testing) before pushing main directly and dispatching squad-release.yml for the actual npm/GitHub Release/Homebrew/WinGet pipeline. Once this PR merges to dev, promotion requires a human (or authorized automation) with workflow_dispatch/contents:write permissions to run squad-promote.yml - that step is outside this PR's scope.

Validation

  • node --test test/*.test.cjs: 134/134 passing.
  • Manually replicated squad-promote.yml's version-consistency and CHANGELOG-presence checks - both pass.
  • markdownlint-cli2 across changed docs: 0 issues. cspell on new CHANGELOG text: 0 new issues.
  • npm run build: fails, but confirmed pre-existing on an unmodified dev checkout in this sandbox (unrelated TS/dependency-resolution issue) - not introduced by this change.

Working as release-engineer (Release Engineer).

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

Promote the Squad CLI/SDK npm packages (@bradygaster/squad-cli,
@bradygaster/squad-sdk) to 1.0.0.

- Bump root, squad-cli, and squad-sdk package.json + package-lock.json
  from 0.13.1 to 1.0.0.
- Bump squad-cli's declared dependency floor on squad-sdk from
  >=0.11.0 to >=1.0.0.
- Add a [1.0.0] CHANGELOG.md entry.
- Remove the blanket "Experimental - Squad is alpha software" banner
  from 87 documentation pages under docs/src/content/docs/**. Genuine
  preview-channel and feature-specific warnings (SDK-first mode,
  GitLab Issues Mode, the plugin security MVP gate, and preview/
  insider release channels) are left untouched.

This does not touch src/Squad.Agents.AI (the separately-versioned
.NET/NuGet package, already stable at 1.0.0 via PR github#2143) and does not
consolidate the pending .changeset/*.md fragments, which track
unrelated in-flight feature work.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI balanced review requested due to automatic review settings October 2, 2026 18:03
@github-actions

github-actions Bot commented Oct 2, 2026

Copy link
Copy Markdown
Contributor

🔴 Impact Analysis — PR #2150

Risk tier: 🔴 CRITICAL

📊 Summary

Metric Count
Files changed 92
Files added 0
Files modified 92
Files deleted 0
Modules touched 4
Critical files 3

🎯 Risk Factors

  • 92 files changed (>50 → CRITICAL)
  • 4 modules touched (2-4 → MEDIUM)
  • Critical files touched: package.json, packages/squad-cli/package.json, packages/squad-sdk/package.json

📦 Modules Affected

docs (87 files)
  • docs/src/content/docs/concepts/what-is-squad.md
  • docs/src/content/docs/cookbook/recipes.md
  • docs/src/content/docs/features/capability-routing.md
  • docs/src/content/docs/features/ceremonies.md
  • docs/src/content/docs/features/cleanup.md
  • docs/src/content/docs/features/consult-mode.md
  • docs/src/content/docs/features/context-hygiene.md
  • docs/src/content/docs/features/coordinator-as-agent-export.md
  • docs/src/content/docs/features/copilot-coding-agent.md
  • docs/src/content/docs/features/copilot-mcp-trust.md
  • docs/src/content/docs/features/cost-tracking.md
  • docs/src/content/docs/features/cross-squad-discover.md
  • docs/src/content/docs/features/directives.md
  • docs/src/content/docs/features/distributed-mesh.md
  • docs/src/content/docs/features/dual-mode-deployment.md
  • docs/src/content/docs/features/error-recovery.md
  • docs/src/content/docs/features/export-import.md
  • docs/src/content/docs/features/external-state.md
  • docs/src/content/docs/features/fleet-dispatch.md
  • docs/src/content/docs/features/github-issues.md
  • docs/src/content/docs/features/human-team-members.md
  • docs/src/content/docs/features/issue-templates.md
  • docs/src/content/docs/features/keda-scaling.md
  • docs/src/content/docs/features/labels.md
  • docs/src/content/docs/features/loop.md
  • docs/src/content/docs/features/marketplace.md
  • docs/src/content/docs/features/mcp-frontmatter.md
  • docs/src/content/docs/features/mcp.md
  • docs/src/content/docs/features/memory.md
  • docs/src/content/docs/features/model-selection.md
  • docs/src/content/docs/features/notification-level.md
  • docs/src/content/docs/features/notifications.md
  • docs/src/content/docs/features/parallel-execution.md
  • docs/src/content/docs/features/plugins.md
  • docs/src/content/docs/features/preset.md
  • docs/src/content/docs/features/project-boards.md
  • docs/src/content/docs/features/rate-limiting.md
  • docs/src/content/docs/features/reflect.md
  • docs/src/content/docs/features/remote-control.md
  • docs/src/content/docs/features/response-modes.md
  • docs/src/content/docs/features/reviewer-protocol.md
  • docs/src/content/docs/features/routing.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/skill-security-scanner.md
  • docs/src/content/docs/features/skills.md
  • docs/src/content/docs/features/standalone-install.md
  • docs/src/content/docs/features/storage-provider.md
  • docs/src/content/docs/features/team-setup.md
  • docs/src/content/docs/features/teams-comms.md
  • docs/src/content/docs/features/tiered-memory.md
  • docs/src/content/docs/features/upstream-inheritance.md
  • docs/src/content/docs/features/vscode.md
  • docs/src/content/docs/features/worktrees.md
  • docs/src/content/docs/get-started/choosing-your-path.md
  • docs/src/content/docs/guide/build-autonomous-agent.md
  • docs/src/content/docs/guide/building-extensions.md
  • docs/src/content/docs/guide/extensibility.md
  • docs/src/content/docs/guide/faq.md
  • docs/src/content/docs/guide/personal-squad.md
  • docs/src/content/docs/guide/sample-prompts.md
  • docs/src/content/docs/guide/shell.md
  • docs/src/content/docs/guide/tips-and-tricks.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/glossary.md
  • docs/src/content/docs/reference/integration.md
  • docs/src/content/docs/reference/sdk.md
  • docs/src/content/docs/reference/state-backend-selection.md
  • docs/src/content/docs/reference/tools-and-hooks.md
  • docs/src/content/docs/reference/vscode-troubleshooting.md
  • docs/src/content/docs/scenarios/aks-deployment.md
  • docs/src/content/docs/scenarios/aspire-dashboard.md
  • docs/src/content/docs/scenarios/azure-container-apps.md
  • docs/src/content/docs/scenarios/ci-cd-integration.md
  • docs/src/content/docs/scenarios/existing-repo.md
  • docs/src/content/docs/scenarios/issue-driven-dev.md
  • docs/src/content/docs/scenarios/monorepo.md
  • docs/src/content/docs/scenarios/production-observability.md
  • docs/src/content/docs/scenarios/production-troubleshooting.md
  • docs/src/content/docs/scenarios/remote-qa.md
  • docs/src/content/docs/scenarios/solo-dev.md
  • docs/src/content/docs/scenarios/team-of-humans.md
  • docs/src/content/docs/whatsnew.md
root (3 files)
  • CHANGELOG.md
  • package-lock.json
  • package.json
squad-cli (1 file)
  • packages/squad-cli/package.json
squad-sdk (1 file)
  • packages/squad-sdk/package.json

⚠️ Critical Files

  • package.json
  • packages/squad-cli/package.json
  • packages/squad-sdk/package.json

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

@github-actions

github-actions Bot commented Oct 2, 2026

Copy link
Copy Markdown
Contributor

🛫 PR Readiness Check

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

PR Scope: 🔧 Infrastructure

⚠️ 2 item(s) to address before review

Status Check Details
✅ Single commit 1 commit — clean history
✅ 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 CHANGELOG.md edit found
✅ Scope clean No .squad/ or docs/proposals/ files
✅ No merge conflicts No merge conflicts
✅ Copilot threads resolved No Copilot review threads
❌ CI passing 10 check(s) still running

Files Changed (92 files, +18 −230)

File +/−
CHANGELOG.md +9 −0
docs/src/content/docs/concepts/what-is-squad.md +0 −3
docs/src/content/docs/cookbook/recipes.md +0 −3
docs/src/content/docs/features/capability-routing.md +0 −2
docs/src/content/docs/features/ceremonies.md +0 −3
docs/src/content/docs/features/cleanup.md +0 −3
docs/src/content/docs/features/consult-mode.md +0 −3
docs/src/content/docs/features/context-hygiene.md +0 −3
docs/src/content/docs/features/coordinator-as-agent-export.md +0 −2
docs/src/content/docs/features/copilot-coding-agent.md +0 −3
docs/src/content/docs/features/copilot-mcp-trust.md +0 −2
docs/src/content/docs/features/cost-tracking.md +0 −2
docs/src/content/docs/features/cross-squad-discover.md +0 −2
docs/src/content/docs/features/directives.md +0 −3
docs/src/content/docs/features/distributed-mesh.md +0 −2
docs/src/content/docs/features/dual-mode-deployment.md +0 −2
docs/src/content/docs/features/error-recovery.md +0 −2
docs/src/content/docs/features/export-import.md +0 −3
docs/src/content/docs/features/external-state.md +0 −3
docs/src/content/docs/features/fleet-dispatch.md +0 −2
docs/src/content/docs/features/github-issues.md +0 −3
docs/src/content/docs/features/human-team-members.md +0 −3
docs/src/content/docs/features/issue-templates.md +0 −3
docs/src/content/docs/features/keda-scaling.md +0 −2
docs/src/content/docs/features/labels.md +0 −3
docs/src/content/docs/features/loop.md +0 −2
docs/src/content/docs/features/marketplace.md +0 −3
docs/src/content/docs/features/mcp-frontmatter.md +0 −2
docs/src/content/docs/features/mcp.md +0 −3
docs/src/content/docs/features/memory.md +0 −3
docs/src/content/docs/features/model-selection.md +0 −3
docs/src/content/docs/features/notification-level.md +0 −2
docs/src/content/docs/features/notifications.md +0 −3
docs/src/content/docs/features/parallel-execution.md +0 −3
docs/src/content/docs/features/plugins.md +0 −2
docs/src/content/docs/features/preset.md +0 −2
docs/src/content/docs/features/project-boards.md +0 −3
docs/src/content/docs/features/rate-limiting.md +0 −2
docs/src/content/docs/features/reflect.md +0 −2
docs/src/content/docs/features/remote-control.md +0 −3
docs/src/content/docs/features/response-modes.md +0 −3
docs/src/content/docs/features/reviewer-protocol.md +0 −3
docs/src/content/docs/features/routing.md +0 −3
docs/src/content/docs/features/scratch-dir.md +0 −3
docs/src/content/docs/features/security-hardening.md +0 −2
docs/src/content/docs/features/self-upgrade.md +0 −3
docs/src/content/docs/features/skill-security-scanner.md +0 −2
docs/src/content/docs/features/skills.md +0 −3
docs/src/content/docs/features/standalone-install.md +0 −2
docs/src/content/docs/features/storage-provider.md +0 −3
... +42 more files

Total: +18 −230


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 Oct 2, 2026

Copy link
Copy Markdown
Contributor

🔒 Security Review

Authoritative evidence: base-controlled pull_request_target reporter.

🔒 Security review: 3 info.

Severity Category Finding Location
ℹ️ info new-dependency 1 new/changed dependency version(s) in package.json. Verify these packages are trusted and necessary. package.json:3
ℹ️ info new-dependency 1 new/changed dependency version(s) in packages/squad-cli/package.json. Verify these packages are trusted and necessary. packages/squad-cli/package.json:3
ℹ️ info new-dependency 1 new/changed dependency version(s) in packages/squad-sdk/package.json. Verify these packages are trusted and necessary. packages/squad-sdk/package.json:3

Automated security review — informational only.

@github-actions

github-actions Bot commented Oct 2, 2026

Copy link
Copy Markdown
Contributor

🏗️ Architectural Review

Authoritative evidence: base-controlled pull_request_target reporter.

⚠️ Architectural review: 1 warning(s).

Severity Category Finding Files
🟡 warning sweeping-refactor This PR touches 92 files (92 modified/added, 0 deleted). Large PRs are harder to review — consider splitting if possible. —

Automated architectural review — informational only.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

The API documentation generator still recreates the removed alpha disclaimer.

1 open finding
What changed in this PR

Prepares the CLI and SDK for the stable 1.0.0 release and removes obsolete alpha disclaimers.

Changes:

  • Bumps package and lockfile versions to 1.0.0.
  • Raises the CLI SDK dependency floor to 1.0.0.
  • Adds release notes and removes alpha banners from 87 documentation pages.
File Description
package.json Bumps root version.
package-lock.json Synchronizes release metadata.
packages/​squad-cli/​package.json Bumps CLI and SDK floor.
packages/​squad-sdk/​package.json Bumps SDK version.
CHANGELOG.md Adds 1.0.0 release notes.
docs/​src/​content/​docs/​whatsnew.md Removes alpha banner.
docs/​src/​content/​docs/​scenarios/​team-of-humans.md Removes alpha banner.
docs/​src/​content/​docs/​scenarios/​solo-dev.md Removes alpha banner.
docs/​src/​content/​docs/​scenarios/​remote-qa.md Removes alpha banner.
docs/​src/​content/​docs/​scenarios/​production-troubleshooting.md Removes alpha banner.
docs/​src/​content/​docs/​scenarios/​production-observability.md Removes alpha banner.
docs/​src/​content/​docs/​scenarios/​monorepo.md Removes alpha banner.
docs/​src/​content/​docs/​scenarios/​issue-driven-dev.md Removes alpha banner.
docs/​src/​content/​docs/​scenarios/​existing-repo.md Removes alpha banner.
docs/​src/​content/​docs/​scenarios/​ci-cd-integration.md Removes alpha banner.
docs/​src/​content/​docs/​scenarios/​azure-container-apps.md Removes alpha banner.
docs/​src/​content/​docs/​scenarios/​aspire-dashboard.md Removes alpha banner.
docs/​src/​content/​docs/​scenarios/​aks-deployment.md Removes alpha banner.
docs/​src/​content/​docs/​reference/​vscode-troubleshooting.md Removes alpha banner.
docs/​src/​content/​docs/​reference/​tools-and-hooks.md Removes alpha banner.
docs/​src/​content/​docs/​reference/​state-backend-selection.md Removes alpha banner.
docs/​src/​content/​docs/​reference/​sdk.md Removes alpha banner.
docs/​src/​content/​docs/​reference/​integration.md Removes alpha banner.
docs/​src/​content/​docs/​reference/​glossary.md Removes alpha banner.
docs/​src/​content/​docs/​reference/​container-image.md Removes alpha banner.
docs/​src/​content/​docs/​reference/​config.md Removes alpha banner.
docs/​src/​content/​docs/​reference/​cli.md Removes alpha banner.
docs/​src/​content/​docs/​reference/​api-reference.md Removes alpha banner.
docs/​src/​content/​docs/​guide/​tips-and-tricks.md Removes alpha banner.
docs/​src/​content/​docs/​guide/​shell.md Removes alpha banner.
docs/​src/​content/​docs/​guide/​sample-prompts.md Removes alpha banner.
docs/​src/​content/​docs/​guide/​personal-squad.md Removes alpha banner.
docs/​src/​content/​docs/​guide/​faq.md Removes alpha banner.
docs/​src/​content/​docs/​guide/​extensibility.md Removes banner and stray quoting.
docs/​src/​content/​docs/​guide/​building-extensions.md Removes alpha banner.
docs/​src/​content/​docs/​guide/​build-autonomous-agent.md Removes alpha banner.
docs/​src/​content/​docs/​get-started/​choosing-your-path.md Removes alpha banner.
docs/​src/​content/​docs/​features/​worktrees.md Removes alpha banner.
docs/​src/​content/​docs/​features/​vscode.md Removes alpha banner.
docs/​src/​content/​docs/​features/​upstream-inheritance.md Removes alpha banner.
docs/​src/​content/​docs/​features/​tiered-memory.md Removes alpha banner.
docs/​src/​content/​docs/​features/​teams-comms.md Removes alpha banner.
docs/​src/​content/​docs/​features/​team-setup.md Removes alpha banner.
docs/​src/​content/​docs/​features/​storage-provider.md Removes alpha banner.
docs/​src/​content/​docs/​features/​standalone-install.md Removes alpha banner.
docs/​src/​content/​docs/​features/​skills.md Removes alpha banner.
docs/​src/​content/​docs/​features/​skill-security-scanner.md Removes alpha banner.
docs/​src/​content/​docs/​features/​self-upgrade.md Removes alpha banner.
docs/​src/​content/​docs/​features/​security-hardening.md Removes alpha banner.
docs/​src/​content/​docs/​features/​scratch-dir.md Removes alpha banner.
docs/​src/​content/​docs/​features/​routing.md Removes alpha banner.
docs/​src/​content/​docs/​features/​reviewer-protocol.md Removes alpha banner.
docs/​src/​content/​docs/​features/​response-modes.md Removes alpha banner.
docs/​src/​content/​docs/​features/​remote-control.md Removes alpha banner.
docs/​src/​content/​docs/​features/​reflect.md Removes alpha banner.
docs/​src/​content/​docs/​features/​rate-limiting.md Removes alpha banner.
docs/​src/​content/​docs/​features/​project-boards.md Removes alpha banner.
docs/​src/​content/​docs/​features/​preset.md Removes alpha banner.
docs/​src/​content/​docs/​features/​plugins.md Removes alpha banner.
docs/​src/​content/​docs/​features/​parallel-execution.md Removes alpha banner.
docs/​src/​content/​docs/​features/​notifications.md Removes alpha banner.
docs/​src/​content/​docs/​features/​notification-level.md Removes alpha banner.
docs/​src/​content/​docs/​features/​model-selection.md Removes alpha banner.
docs/​src/​content/​docs/​features/​memory.md Removes alpha banner.
docs/​src/​content/​docs/​features/​mcp.md Removes alpha banner.
docs/​src/​content/​docs/​features/​mcp-frontmatter.md Removes alpha banner.
docs/​src/​content/​docs/​features/​marketplace.md Removes alpha banner.
docs/​src/​content/​docs/​features/​loop.md Removes alpha banner.
docs/​src/​content/​docs/​features/​labels.md Removes alpha banner.
docs/​src/​content/​docs/​features/​keda-scaling.md Removes alpha banner.
docs/​src/​content/​docs/​features/​issue-templates.md Removes alpha banner.
docs/​src/​content/​docs/​features/​human-team-members.md Removes alpha banner.
docs/​src/​content/​docs/​features/​github-issues.md Removes alpha banner.
docs/​src/​content/​docs/​features/​fleet-dispatch.md Removes alpha banner.
docs/​src/​content/​docs/​features/​external-state.md Removes alpha banner.
docs/​src/​content/​docs/​features/​export-import.md Removes alpha banner.
docs/​src/​content/​docs/​features/​error-recovery.md Removes alpha banner.
docs/​src/​content/​docs/​features/​dual-mode-deployment.md Removes alpha banner.
docs/​src/​content/​docs/​features/​distributed-mesh.md Removes alpha banner.
docs/​src/​content/​docs/​features/​directives.md Removes alpha banner.
docs/​src/​content/​docs/​features/​cross-squad-discover.md Removes alpha banner.
docs/​src/​content/​docs/​features/​cost-tracking.md Removes alpha banner.
docs/​src/​content/​docs/​features/​copilot-mcp-trust.md Removes alpha banner.
docs/​src/​content/​docs/​features/​copilot-coding-agent.md Removes alpha banner.
docs/​src/​content/​docs/​features/​coordinator-as-agent-export.md Removes alpha banner.
docs/​src/​content/​docs/​features/​context-hygiene.md Removes alpha banner.
docs/​src/​content/​docs/​features/​consult-mode.md Removes alpha banner.
docs/​src/​content/​docs/​features/​cleanup.md Removes alpha banner.
docs/​src/​content/​docs/​features/​ceremonies.md Removes alpha banner.
docs/​src/​content/​docs/​features/​capability-routing.md Removes alpha banner.
docs/​src/​content/​docs/​cookbook/​recipes.md Removes alpha banner.
docs/​src/​content/​docs/​concepts/​what-is-squad.md Removes banner and stray quoting.

🧠 Review effort: Balanced


💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread CHANGELOG.md

### Changed

- Removed the blanket "Experimental — Squad is alpha software" disclaimer banner from 87 documentation pages under `docs/src/content/docs/**`. Genuine preview-channel and feature-specific warnings (SDK-first mode, GitLab Issues Mode, the plugin security MVP gate, and preview/insider release channels) are unchanged and still documented.
@tamirdresher
tamirdresher merged commit f65ade9 into github:dev Oct 2, 2026
17 checks passed
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