From d52d1fc15b348537a5c32ad04b15d28ac333b885 Mon Sep 17 00:00:00 2001 From: Jorge Vidaurre Date: Fri, 24 Apr 2026 17:59:03 -0400 Subject: [PATCH 1/3] =?UTF-8?q?chore:=20bump=20to=200.3.1=20=E2=80=94=20fi?= =?UTF-8?q?rst=20usable=20v0.3.x=20on=20@latest?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Skipping 0.3.0 because that version slot was claimed by a deprecated historical pre-release (Jan 2026, deprecated as part of the "deprecate all pre-release versions 0.3.0-0.6.2" cleanup). npm enforces version immutability — we cannot republish 0.3.0. 0.3.1 is the smallest available version after rc.1 in the 0.3.x line. After merge, tag v0.3.1 → release.yml publishes to @latest via OIDC. Same content as the rc.1 burn-in candidate (0.3.0-rc.1 on @next). Co-Authored-By: Claude --- package-lock.json | 4 ++-- package.json | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/package-lock.json b/package-lock.json index 9955f021..6cfe6b18 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "squads-cli", - "version": "0.3.0", + "version": "0.3.1", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "squads-cli", - "version": "0.3.0", + "version": "0.3.1", "license": "MIT", "dependencies": { "@anthropic-ai/sdk": "^0.71.2", diff --git a/package.json b/package.json index 2ffa5101..b6b967ae 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "squads-cli", - "version": "0.3.0", + "version": "0.3.1", "description": "Your AI workforce. Every user gets an AI manager that runs their team — finance, marketing, engineering, operations — for the cost of API calls.", "type": "module", "bin": { From ac18a8447ccc2a6542ad6c45d9c46dbe0ad1d9e2 Mon Sep 17 00:00:00 2001 From: Jorge Vidaurre Date: Fri, 24 Apr 2026 18:03:15 -0400 Subject: [PATCH 2/3] docs: add CHANGELOG.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Hand-curated changelog covering 0.2.1 → 0.3.1. Notes the deprecated historical pre-releases (0.3.0, 0.4.x, 0.5.x, 0.6.x, 0.7.0) so users don't accidentally install them. GitHub Releases remain the canonical record (auto-generated by release.yml on tag push); this file is the human-readable summary and lives in the package itself (npm view shows it). Co-Authored-By: Claude --- CHANGELOG.md | 57 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 CHANGELOG.md diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 00000000..2d43da78 --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,57 @@ +# Changelog + +All notable changes to `squads-cli` are documented here. + +This project follows [Semantic Versioning](https://semver.org/). +Releases are also published as [GitHub Releases](https://github.com/agents-squads/squads-cli/releases). + +## [0.3.1] — 2026-04-24 + +First stable v0.3.x release on `@latest`. Same code as `0.3.0-rc.1` (burned in on `@next`). + +> Note: `0.3.0` was skipped because that version slot is reserved by a deprecated historical pre-release (Jan 2026) and npm enforces version immutability. + +### Added +- **Conversation protocol** — agents talk to each other and use tools mid-conversation. `squads run ` now drives a lead → scan → work → review → verify cycle. +- **Org cycle** — `squads run` with no target runs all squads in waves, with smart-skip for converged work. +- **New commands** — `review`, `credentials`, `goals`, `log`, plus minor refinements to `init`, `status`, and `run`. +- **Project config system** — `.squads/config.yml` for per-project settings (`agent_timeout_minutes`, `token_budget`, `cost_ceiling`, `company_name`, `compose_file`, `telemetry`). Resolution: env var > config file > defaults. +- **PreToolUse guardrail hooks** — agent sessions can be gated by user-defined safety hooks. +- **Demo agent scaffold** — `squads init` now includes starter agents and "what's next" guidance. +- **Growth squad template** — added to `squads init` seed templates. +- **Tier 2 documentation** — guides for local-services mode (Postgres, Redis, API, Bridge). + +### Changed +- **Run engine rewrite** — decomposed into smaller modules (`conversation.ts`, `workflow.ts`, context helpers). Foundation for future cloud execution. +- **Role-based timeouts** — workers, reviewers, and leads have appropriate per-role timeouts (replaces hardcoded 8-minute ceiling). +- **Anti-collision rules** — multiple squads no longer race to create the same release PR or duplicate issues. +- **Prompts extracted** — lead briefings, planning instructions, and orchestrator prompts moved from TypeScript into `templates/prompts/*.md`. +- **Services command** — agnostic compose-file discovery (no hardcoded internal paths). +- **OIDC trusted publishing** — `release.yml` and `publish.yml` now publish via GitHub OIDC instead of `NPM_TOKEN`. No long-lived secret to rotate. +- **Audit remediation** — removed hardcoded values, parameterized company name, extracted internal prompts. + +### Fixed +- **Telemetry write-only key** — restored after being incorrectly removed in March (telemetry has been silent since 2026-03-14). +- **First-run UX** — prerequisites check, helpful empty-state for `squads list` with no squads, schedule hint after first run. + +### Infrastructure +- `@next` dist-tag channel — pre-release tags (`v0.3.0-rc.1`, `v0.4.0-beta.1`, etc.) auto-publish to `@next` for burn-in. Clean semver tags publish to `@latest`. +- npm install via `npm i -g squads-cli@next` for early access. + +## [0.2.2] — 2026-03-28 + +- IDP (Internal Developer Platform), observability infrastructure, tiered architecture, org cycle scaffolding. + +## [0.2.1] — 2026-03-13 + +- First-run experience reset. + +## [0.2.0] and earlier + +See [GitHub Releases](https://github.com/agents-squads/squads-cli/releases) for the full history. + +> Versions `0.3.0`, `0.4.0`–`0.4.13`, `0.5.0`–`0.5.1`, `0.6.0`–`0.6.2`, and `0.7.0` were experimental pre-releases published in early 2026 and have been **deprecated** on npm. Do not install them. Start at `0.2.2` or `0.3.1+`. + +[0.3.1]: https://github.com/agents-squads/squads-cli/releases/tag/v0.3.1 +[0.2.2]: https://github.com/agents-squads/squads-cli/releases/tag/v0.2.2 +[0.2.1]: https://github.com/agents-squads/squads-cli/releases/tag/v0.2.1 From ec80521bd8b97470eef8b3381a7c498eb97fd829 Mon Sep 17 00:00:00 2001 From: Jorge Vidaurre Date: Fri, 24 Apr 2026 18:04:26 -0400 Subject: [PATCH 3/3] feat(cli): add Resources footer to --help with changelog link Surfaces the canonical changelog, releases, and issues URLs at the bottom of \`squads --help\` so users discover them without hunting. Co-Authored-By: Claude --- src/cli.ts | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/src/cli.ts b/src/cli.ts index 036c1964..0707f9af 100644 --- a/src/cli.ts +++ b/src/cli.ts @@ -189,6 +189,12 @@ program .name('squads') .description('Your AI workforce — business operating system for AI managers') .version(version) + .addHelpText('after', ` +Resources: + Changelog https://github.com/agents-squads/squads-cli/blob/main/CHANGELOG.md + Releases https://github.com/agents-squads/squads-cli/releases + Issues https://github.com/agents-squads/squads-cli/issues +`) // Enable typo suggestions (Commander.js built-in feature) .showSuggestionAfterError(true) // Configure help to exit with code 0 (Unix convention)