Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
109 commits
Select commit Hold shift + click to select a range
1aaead4
fix: auto-scaffold Fact Checker agent during init and cast (#1222)
tamirdresher Jun 7, 2026
010f6fc
fix(upgrade): auto-scaffold Rai + Fact Checker on squad upgrade (#1222)
tamirdresher Jun 7, 2026
d41b046
Merge pull request #1223 from tamirdresher/fix/1222-fact-checker-auto…
bradygaster Jun 7, 2026
e5c1800
fix(permissions): use 'approve-once' for Copilot CLI v1.0.54+ contrac…
bradygaster Jun 9, 2026
a081832
feat: Squad.Agents.AI - Microsoft Agent Framework adapter for the Squ…
tamirdresher Jun 9, 2026
28962e2
ci(Squad.Agents.AI): switch NuGet publish to Trusted Publishing (OIDC…
tamirdresher Jun 9, 2026
647f337
fix(Squad.Agents.AI): expose SessionConfig + default OnPermissionRequ…
tamirdresher Jun 10, 2026
cc37a2f
Squad.Agents.AI 0.2.0: bump to MAF 1.10.0-rc1 / SDK 1.0.0 GA — file-I…
tamirdresher Jun 10, 2026
39ee9c7
fix: address pre-existing Copilot review comments from PR #1212 (#1258)
bradygaster Jun 11, 2026
611a82b
fix: expose memory tools via MCP + route writes through governed pipe…
bradygaster Jun 11, 2026
eeb68f2
docs(skills): update path references from .squad/skills/ to .copilot/…
bradygaster Jun 11, 2026
c11274d
feat(init): prompt to add @copilot as a team member during squad init…
bradygaster Jun 11, 2026
5824b60
docs: align skills path + state-backend upgrade flow (#1241, #1226) (…
bradygaster Jun 11, 2026
152bbf0
Squad.Agents.AI 0.3.0: first-class subagent observability (#1265)
tamirdresher Jun 11, 2026
d3c2d84
chore(lockfile): sync package-lock with package.json after v0.10.0 bu…
tamirdresher Jun 11, 2026
f79b03a
fix(bump-build): also update package-lock workspace entries (#1267)
tamirdresher Jun 11, 2026
da17eef
fix: release pipeline version pinning (#1203, #1204) (#1250)
bradygaster Jun 11, 2026
ce15d6b
chore: include CHANGELOG.md in published npm tarball (#1257)
bradygaster Jun 11, 2026
c076ffb
Squad.Agents.AI 0.4.0: default-on subagent observability + Aspire-sty…
tamirdresher Jun 11, 2026
dfc5b94
Squad.Agents.AI 0.5.0: auto-inject --agent squad (CLI parity by defau…
tamirdresher Jun 11, 2026
edcc39d
Squad.Agents.AI 0.5.1: fix 0.5.0 regression — use --agent CLI flag (n…
tamirdresher Jun 11, 2026
217e0bd
Add squad registry add/list/remove for discovery-only peer squads (#1…
tamirdresher Jun 12, 2026
2ca906d
fix(cli): stop writing squad_state to ~/.copilot/mcp-config.json on e…
tamirdresher Jun 13, 2026
84ce747
fix(sdk): wire team.md/routing.md/casting state on \squad preset appl…
tamirdresher Jun 13, 2026
68e2774
fix(docs): tell coordinator to roster Fact Checker on first-time cast…
tamirdresher Jun 13, 2026
16c6b25
fix(sdk): plumb Fact Checker like Rai — rich charter at init + .squad…
tamirdresher Jun 13, 2026
76ba4e7
fix(skills): rename squad disambiguation skill to squad-help (superse…
tamirdresher Jun 13, 2026
918cbd4
fix(prompt): coordinator must probe for squad_state/memory tools befo…
tamirdresher Jun 13, 2026
608f858
feat(skills): make /squad a real slash command (user-invocable: true …
tamirdresher Jun 13, 2026
40f78f2
fix(skills): install bundled skills to .github/skills/ (closes #1126)…
tamirdresher Jun 13, 2026
6afd067
feat(sdk): bundle cross-squad-communication skill (#5 cross-squad pro…
tamirdresher Jun 13, 2026
b79e64a
fix(coordinator): route "spawn a squad" / "another squad" prompts thr…
tamirdresher Jun 13, 2026
89a1b96
fix(sdk,cli): bundle missing skills on init + strip fabricated tiered…
tamirdresher Jun 13, 2026
942270b
docs: add feature pages for preset, cross-squad discover/delegate, an…
tamirdresher Jun 14, 2026
f9f77c0
docs: add feature pages for remaining 8 v0.10 features (tiered-memory…
tamirdresher Jun 14, 2026
caef438
docs(state-backends): document pre-commit hook, post-upgrade flow, an…
tamirdresher Jun 14, 2026
ae6f4e7
docs: clarify that .squad/casting/* files are identity, not two-layer…
tamirdresher Jun 14, 2026
567f447
fix(state-backend): conditional .gitignore entries for two-layer/orph…
tamirdresher Jun 14, 2026
264b876
feat(sdk): thread reasoningEffort through agent spawning pipeline (#1…
ahhlun Jun 15, 2026
6278510
deps: Bump xunit from 2.9.2 to 2.9.3 (#1237)
dependabot[bot] Jun 15, 2026
ca3fdd6
fix(test): anchor docs fence-parity regex to line start (#1319)
tamirdresher Jun 15, 2026
937665a
deps: Bump Microsoft.Extensions.Configuration and 8 others (#1317)
dependabot[bot] Jun 15, 2026
89bf31f
ci(dependabot): add npm ecosystem coverage for JS workspaces (#1320)
tamirdresher Jun 15, 2026
0b38155
deps: Bump GitHub.Copilot.SDK from 1.0.0 to 1.0.1 (#1316)
dependabot[bot] Jun 15, 2026
eb57b87
ci: bump the github-actions group across 1 directory with 8 updates (…
dependabot[bot] Jun 15, 2026
8418ef8
deps: Bump xunit.runner.visualstudio from 2.8.2 to 3.1.5 (#1238)
dependabot[bot] Jun 15, 2026
9a5babc
deps: bump the minor-patch group in /docs with 7 updates (#1330)
dependabot[bot] Jun 15, 2026
a137f9b
deps: Bump Microsoft.Extensions.AI from 10.6.0 to 10.7.0 (#1331)
dependabot[bot] Jun 15, 2026
03bc88a
deps: bump eslint-plugin-n from 17.24.0 to 18.1.0 (#1336)
dependabot[bot] Jun 15, 2026
6643897
deps: bump astro from 5.18.0 to 6.4.7 in /docs (#1332)
dependabot[bot] Jun 15, 2026
8fe1096
chore(deps): bump flask in /test-fixtures/dogfood/python-flask (#1341)
dependabot[bot] Jun 15, 2026
0df0bb0
chore(deps): bump black in /test-fixtures/dogfood/python-flask (#1340)
dependabot[bot] Jun 15, 2026
0024464
chore(deps): bump pytest in /test-fixtures/dogfood/mixed-lang/backend…
dependabot[bot] Jun 15, 2026
a23e9b2
fix(docs): migrate to astro 6 content collection config (#1345)
tamirdresher Jun 15, 2026
0796216
chore(deps-dev): bump vite in /samples/streaming-chat (#1344)
dependabot[bot] Jun 16, 2026
3ac4731
chore(deps): bump esbuild, tsx and vitest in /samples/streaming-chat …
dependabot[bot] Jun 16, 2026
daef99a
deps: bump typedoc-plugin-markdown from 4.11.0 to 4.12.0 in /packages…
dependabot[bot] Jun 16, 2026
616cf9f
deps: bump markdown-it from 14.1.1 to 14.2.0 (#1346)
dependabot[bot] Jun 16, 2026
e97ed62
deps: bump the minor-patch group across 1 directory with 13 updates (…
dependabot[bot] Jun 16, 2026
9ea067f
chore: bump @types/node to 25.9.3 (cli + sdk) (#1349)
tamirdresher Jun 16, 2026
f45f856
chore: adapt CLI to ink 7 (#1350)
tamirdresher Jun 16, 2026
f020c8f
deps: bump vscode-jsonrpc from 8.2.1 to 9.0.0 in /packages/squad-cli …
dependabot[bot] Jun 16, 2026
be0c7df
chore: upgrade to TypeScript 6 (cli + sdk + root) and align @typescri…
tamirdresher Jun 16, 2026
04c80ab
chore: upgrade vitest to v4 (coordinated with @vitest/coverage-v8 v4)…
tamirdresher Jun 16, 2026
d5ada48
deps: bump vscode-jsonrpc from 8.2.1 to 9.0.0 in /packages/squad-sdk …
dependabot[bot] Jun 16, 2026
9bb88c6
deps: bump sharp from 0.35.1 to 0.35.2 in /docs in the minor-patch gr…
dependabot[bot] Jun 23, 2026
79ead09
deps: bump the minor-patch group with 2 updates (#1360)
dependabot[bot] Jun 23, 2026
af128fd
deps: Bump GitHub.Copilot.SDK from 1.0.1 to 1.0.3 (#1359)
dependabot[bot] Jun 23, 2026
9329802
deps: bump hono from 4.12.22 to 4.12.26 (#1355)
dependabot[bot] Jun 23, 2026
e76a21d
fix(coordinator): restore always-on inline-dispatch gate (#1378)
tamirdresher Jun 24, 2026
bcdd2e5
chore(deps): bump flask in /test-fixtures/dogfood/mixed-lang/backend …
dependabot[bot] Jun 24, 2026
bcc1d8b
chore(deps): bump pytest in /test-fixtures/dogfood/python-flask (#1376)
dependabot[bot] Jun 24, 2026
df5686d
fix(docs): rephrase 'fenced code block' row in skill-security-scanner…
tamirdresher Jun 24, 2026
1166b8f
docs(Squad.Agents.AI): update README header to 0.5.1 and multi-target…
tamirdresher Jun 24, 2026
0250d5f
ci(release): stop publishing on test-only dep bumps (#1342)
bradygaster Jun 24, 2026
3cfd2c5
ci: bump actions/checkout from 6 to 7 in the github-actions group (#1…
dependabot[bot] Jun 24, 2026
fc057de
fix: respect SQUAD_HOME env var, implement SQUAD_PERSONAL_DIR, fix Wi…
bradygaster Jun 25, 2026
389f147
docs: fix platform paths and explain global squad.agent.md (#1381)
bradygaster Jun 25, 2026
b563251
fix: CLI and upgrade bug fixes (#1050, #1048, #1047, #1052, #1029, #1…
bradygaster Jun 25, 2026
ae6f5c9
fix(sdk): export gitignore-state helpers; bump Squad.Agents.AI to 0.5…
bradygaster Jun 25, 2026
9eda638
feat(tracing): capture task-tool dispatch + tool requests for subagen…
tamirdresher Jun 25, 2026
dff05c4
fix: escape args for cmd.exe shell on Windows (DEP0190) (#1388)
tamirdresher Jun 25, 2026
78c48ca
feat(coordinator): spawn cast members as sub-sessions in Copilot App …
bradygaster Jun 25, 2026
7e49eb7
fix(coordinator): address #1385 review follow-ups (#1390)
bradygaster Jun 25, 2026
d407b82
Rename .NET Aspire references to Aspire (#1239)
Meir017 Jun 25, 2026
ea48282
chore: simplify workflow files by removing .ai-team fallback logic (#…
bradygaster Jun 25, 2026
45080ad
fix(routing): strip surrounding quotes from routing.md examples (#1357)
duongau Jun 25, 2026
ee1870d
fix(cli): add externalize/internalize to top-level squad --help (#1232)
primetimetank21 Jun 25, 2026
54ded23
deps: bump @types/node from 25.9.4 to 26.0.0 in /packages/squad-cli (…
dependabot[bot] Jun 25, 2026
a61f950
deps: bump @types/node from 25.9.4 to 26.0.0 in /packages/squad-sdk (…
dependabot[bot] Jun 25, 2026
5b9db05
ci: bump esbuild and tsx in /samples/storage-provider-sqlite (#1380)
dependabot[bot] Jun 25, 2026
918bbe8
deps: bump @opentelemetry/sdk-trace-base from 1.30.1 to 2.8.0 in /pac…
dependabot[bot] Jun 26, 2026
63ab588
deps: bump @opentelemetry/resources from 1.30.1 to 2.8.0 in /packages…
dependabot[bot] Jun 26, 2026
173880a
deps: bump @github/copilot-sdk from 0.3.0 to 1.0.4 (#1361)
dependabot[bot] Jun 26, 2026
98542a6
deps: bump @github/copilot-sdk from 0.3.0 to 1.0.4 in /packages/squad…
dependabot[bot] Jun 26, 2026
606840a
deps: bump cspell from 9.7.0 to 10.0.1 (#1362)
dependabot[bot] Jun 26, 2026
097c2fa
docs(casting): add spoiler-awareness to casting/naming rules (#1196)
obit91 Jun 26, 2026
f69cb03
feat(prompt): slim squad.agent.md by extracting 3 sections to satelli…
tamirdresher Jun 26, 2026
62c5249
feat(cli): rename hire to cast (#1394)
bradygaster Jun 26, 2026
89c36ab
Add OSS release checklist files (#1217)
bradygaster Jun 28, 2026
dc3bcf4
feat: add 'squad preset install <source>' for sharing presets via rep…
tamirdresher Jun 28, 2026
04682c6
fix: update adapter/client.ts for @github/copilot-sdk 1.0.4 API chang…
bradygaster Jun 28, 2026
6c7e110
deps: bump @opentelemetry/sdk-metrics and sdk-trace-node to 2.8.0 (#1…
bradygaster Jun 29, 2026
4ef3282
fix(cli): pin squad-sdk to workspace:* (fixes prerelease build crash)…
bradygaster Jun 29, 2026
897d883
Fix green test suite (#1416)
bradygaster Jun 29, 2026
6e6f1aa
Stage 0.11.0 release (#1420)
bradygaster Jun 30, 2026
7e01965
Guard symlink test for Windows/restricted environments (#1418)
bradygaster Jun 30, 2026
f963839
chore: promote dev → main (v0.11.0)
bradygaster Jun 30, 2026
e4cf2f8
chore: allow SWE-bench docs terms
bradygaster Jun 30, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
docs(state-backends): document pre-commit hook, post-upgrade flow, an…
…d recovery (#1227)

- Correct hook list (4 -> 6) in state-backends.md
- Correct misleading claim that working-tree files remain as read-only reference (they're deleted after migration per migrate-backend.ts:218-235)
- Add Steady-state safety net section explaining pre-commit + post-commit hooks
- Add troubleshooting entry for refusing to commit two-layer state with recovery flow
- Add post-upgrade verification checklist to upgrading.md

Closes #1226

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  • Loading branch information
tamirdresher and Copilot authored Jun 14, 2026
commit caef438d2a77d6080bca9807ef9f9bc3764dbcc6
35 changes: 35 additions & 0 deletions docs/src/content/docs/features/state-backends.md
Original file line number Diff line number Diff line change
Expand Up @@ -416,6 +416,41 @@ Change `stateBackend` in `.squad/config.json`. The coordinator adapts on the nex

---

## Steady-state safety net

Once you've migrated to `orphan` or `two-layer`, two additional git hooks enforce the invariant that mutable state never lands in your working branch.

### `pre-commit` — blocks state from entering the working tree

Before every commit, this hook scans the staged index for files that belong on the orphan branch:

- `.squad/decisions.md`
- `.squad/agents/*/history.md`
- `.squad/casting/`
- `.squad/routing/`

If any of those paths are staged, the commit is refused with:

```
⚠ squad pre-commit: refusing to commit two-layer state into the working tree.
Unstage the state files and let the post-commit hook sync them:
git restore --staged .squad/decisions.md .squad/agents/*/history.md
```

**Why files might reappear:** A tool, editor save, or agent code path that writes directly via `fs.writeFile` (bypassing `StateBackend`) will recreate the file on disk. Staging it and attempting a commit triggers this hook.

For the full recovery flow see [troubleshooting](#squad-pre-commit-refusing-to-commit-two-layer-state-into-the-working-tree).

### `post-commit` — keeps the orphan branch current

After every successful commit, `squad sync --quiet` is called automatically. This pushes any pending state from the in-memory queue onto the `squad-state` branch, so the orphan branch stays up to date without manual intervention.

### `SQUAD_SYNC_ACTIVE=1` bypass

Setting `SQUAD_SYNC_ACTIVE=1` in the environment causes both hooks to exit immediately without running. This is used **internally** by `squad sync` itself to avoid hook recursion.

> ⚠️ **Do not use `SQUAD_SYNC_ACTIVE=1` routinely.** Bypassing the pre-commit hook lets state files land in your working branch commits — exactly the situation `two-layer` is designed to prevent. Any PR created from that branch will carry squad state in the diff, defeating the clean-PR promise of the two-layer backend. Use the recovery flow instead.

## Troubleshooting

### "Pre-commit hook refused my commit"
Expand Down
47 changes: 47 additions & 0 deletions docs/src/content/docs/scenarios/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -156,3 +156,50 @@ If below v20, upgrade to the latest LTS:
- Use PowerShell or Git Bash (not cmd.exe)
- Ensure git is in your PATH
- Ensure `gh` CLI is in your PATH

---

## "⚠ squad pre-commit: refusing to commit two-layer state into the working tree"

**Problem:** A `git commit` is blocked with the message above.

**Cause:** You're on the `orphan` or `two-layer` backend, and one or more state files (`.squad/decisions.md`, `.squad/agents/*/history.md`, `.squad/casting/`, `.squad/routing/`) were staged for commit. These files belong on the `squad-state` orphan branch, not in your working branch. Something wrote them back to disk after the migration — a direct `fs.writeFile` call, an editor auto-save, or an external tool — and you staged them unintentionally.

**Recovery flow:**

1. **Unstage the state files:**
```bash
git restore --staged .squad/decisions.md
git restore --staged ".squad/agents/*/history.md"
```

2. **Check whether the orphan branch already has the content** (it should, if `squad sync` has run):
```bash
git show squad-state:decisions.md
git show squad-state:agents/<agent-name>/history.md
```

3. **If the working-tree copy contains new content not yet on the orphan branch**, lift it through Squad before deleting:
```bash
squad memory write --file .squad/decisions.md
```

4. **Remove the working-tree copies:**
```bash
# PowerShell
Remove-Item .squad\decisions.md -ErrorAction SilentlyContinue
Get-ChildItem .squad\agents -Recurse -Filter history.md | Remove-Item
```
```bash
# bash
rm -f .squad/decisions.md .squad/agents/*/history.md
```

5. **Commit normally** — the `post-commit` hook will call `squad sync --quiet` automatically:
```bash
git commit -m "your commit message"
```

**When to use `SQUAD_SYNC_ACTIVE=1`:** Rarely. This env var bypasses both the pre-commit and post-commit hooks. It's intended for internal use by `squad sync` itself to prevent recursion. If you set it to unblock a commit, the state files will land in your working-branch history and appear in PRs — exactly what two-layer is designed to prevent. Use the recovery flow above instead.

---
37 changes: 37 additions & 0 deletions docs/src/content/docs/scenarios/upgrading.md
Original file line number Diff line number Diff line change
Expand Up @@ -153,3 +153,40 @@ No changes to `.ai-team/` — the diff is limited to Squad-owned files.
- **Upgrade is safe.** It only overwrites files that Squad owns. Your team state is never modified.
- **Don't customize `squad.agent.md`.** Any changes you make will be overwritten on the next upgrade. If you need custom behavior, use directives in `decisions.md` instead.
- **Re-running upgrade is harmless.** If you're not sure whether an upgrade completed, run it again. It's idempotent.

---

## After upgrading to `two-layer` or `orphan`

After running `squad upgrade --state-backend two-layer` (or `--state-backend orphan`), verify the migration completed cleanly:

### 1. Working tree is clean

```bash
git status
```

You should see no changes. The migration removes the working-tree state files after copying them to the orphan branch — if `.squad/decisions.md` or any `history.md` files still appear as untracked or modified, rerun the migration.

### 2. Orphan branch contains your state

```bash
git ls-tree --name-only -r squad-state
```

You should see your state files listed (e.g. `decisions.md`, `agents/scribe/history.md`). If the branch is missing or empty, the migration may not have completed.

### 3. Push the orphan branch and notes once

The orphan branch and any git notes need to be pushed to the remote so collaborators can access them:

```bash
git push origin squad-state
git push origin 'refs/notes/squad*:refs/notes/squad*'
```

After this, the `post-commit` hook keeps both in sync automatically on every commit.

### If state files reappear later

If `.squad/decisions.md` or `history.md` files reappear in the working tree and a `git commit` is blocked with `⚠ squad pre-commit: refusing to commit two-layer state into the working tree`, see the [pre-commit troubleshooting entry](./troubleshooting#squad-pre-commit-refusing-to-commit-two-layer-state-into-the-working-tree) for the recovery flow.
Loading