From e267cf016e9f46bf54ca19686e274cdb5c363c53 Mon Sep 17 00:00:00 2001 From: brady gaster Date: Fri, 21 Aug 2026 12:40:22 -0700 Subject: [PATCH] fix(gh-aw): bump activation CLI pin 0.11.0 -> 0.12.0 (new-repo readiness) The Squad bootstrap in workflows/shared/squad.md pins the CLI version the activation job installs. The default fell behind the npm registry: - workflows/shared/squad.md: SQUAD_CLI_VERSION default was 0.11.0 - docs/src/content/docs/guide/gh-aw.md: doc default was 0.11.0 - npm dist-tags today: latest=0.12.0, insider=0.12.0 - in-repo packages/squad-cli/package.json: 0.13.0 (UNPUBLISHED; npm 404) An existing repo with vars.SQUAD_CLI_VERSION set is unaffected. A brand-new repo has no variable, falls through the '|| 0.11.0' fallback in both the env block and the npx one-liner, and lands on the two-minor-old CLI. That is exactly the population targeted by the upcoming new-repo E2E wave. Pinning to 0.12.0 (not 0.13.0) is deliberate: - 0.13.0 is the version bump waiting on unmerged changesets; it is not on npm yet. Pinning there would take activation from stale to hard-broken (npx --yes @bradygaster/squad-cli@0.13.0 -> E404). - The reproducibility-vs-freshness tradeoff is called out below. Reproducibility vs floating tag: - Kept as a fixed pin rather than switching to 'latest'. The activation bootstrap runs in the unrestricted-network job and hands state off to the sandboxed agent job; a bad point release in the middle of that hop is a hard-to-debug failure. Fixed pin preserves the property that the same @dev commit produces the same activation, and consumers keep the vars.SQUAD_CLI_VERSION override for opt-in freshness. Scope: - workflows/shared/squad.md: 3 occurrences (comment, env default, npx fallback) all bumped - docs/src/content/docs/guide/gh-aw.md: 1 occurrence (variable table) - No changeset required: the changelog gate regex at .github/workflows/squad-ci.yml:271 covers packages/squad-(sdk|cli)/src/, packages/squad-(sdk|cli)/templates/, .squad-templates/, templates/, and .squad/agents/*/charter.md. Neither workflows/shared/ nor docs/ matches. - docs/src/content/docs/features/standalone-install.md still cites v0.11.0 in curl/actions examples; that is a separate distribution channel and a separate finding, out of scope here. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 7532d43f-3da4-4087-9d0b-5a3c38bbf9e9 --- docs/src/content/docs/guide/gh-aw.md | 2 +- workflows/shared/squad.md | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/src/content/docs/guide/gh-aw.md b/docs/src/content/docs/guide/gh-aw.md index 3c96129ea..a99c1942c 100644 --- a/docs/src/content/docs/guide/gh-aw.md +++ b/docs/src/content/docs/guide/gh-aw.md @@ -142,7 +142,7 @@ Set a repository variable to control which Squad CLI version the workflow uses: | Variable | Purpose | Default | |----------|---------|---------| -| `SQUAD_CLI_VERSION` | Squad CLI version to install during activation | `0.11.0` | +| `SQUAD_CLI_VERSION` | Squad CLI version to install during activation | `0.12.0` | Set it in **Settings → Secrets and variables → Actions → Variables**. diff --git a/workflows/shared/squad.md b/workflows/shared/squad.md index fde0f40a5..0f7264724 100644 --- a/workflows/shared/squad.md +++ b/workflows/shared/squad.md @@ -45,7 +45,7 @@ # # Optional custom Squad CLI version: # vars.SQUAD_CLI_VERSION -# Default is 0.11.0. +# Default is 0.12.0. # # Optional model override: # vars.SQUAD_MODEL @@ -78,7 +78,7 @@ jobs: - name: Initialize Squad team env: - SQUAD_CLI_VERSION: ${{ vars.SQUAD_CLI_VERSION || '0.11.0' }} + SQUAD_CLI_VERSION: ${{ vars.SQUAD_CLI_VERSION || '0.12.0' }} GH_TOKEN: ${{ steps.squad-app-token.outputs.token || secrets.SQUAD_GITHUB_TOKEN || github.token }} run: | # Preserve committed cast state: if .squad/team.md already exists with @@ -87,7 +87,7 @@ jobs: echo "✓ Existing squad team detected with roster entries — skipping init." else echo "No existing squad team found — running squad init." - npx --yes "@bradygaster/squad-cli@${SQUAD_CLI_VERSION:-0.11.0}" init --preset default --state-backend local + npx --yes "@bradygaster/squad-cli@${SQUAD_CLI_VERSION:-0.12.0}" init --preset default --state-backend local fi - name: Upload Squad state artifact