chore: promote dev → main (v0.11.0)

.changeset/bump-otel-sdk-2x.md

@@ -0,0 +1,5 @@
+---
+"@bradygaster/squad-sdk": patch
+---
+
+deps: bump @opentelemetry/sdk-metrics and @opentelemetry/sdk-trace-node from 1.x to 2.8.0

.changeset/cli-upgrade-fixes.md

@@ -0,0 +1,12 @@
+---
+"@bradygaster/squad-cli": patch
+"@bradygaster/squad-sdk": patch
+---
+
+Fix CLI and upgrade bugs:
+- `squad externalize` and `squad internalize` now appear in `squad --help` output (#1050)
+- `squad build` writes files to the externalized state directory when applicable (#1048)
+- `squad new agent` correctly adds agent definitions to `squad.config.ts` (#1047)
+- `squad upgrade` backs up customized `squad.agent.md` before overwriting; supports `--dry-run` (#1052)
+- Explicit `@agent` mentions bypass direct-response handler and route to named agent (#1029)
+- `state-mcp` server uses lazy initialization to avoid blocking multi-MCP startup (#1353)

.changeset/docs-platform-path-fixes.md

@@ -0,0 +1,6 @@
+---
+"@bradygaster/squad-sdk": patch
+"@bradygaster/squad-cli": patch
+---
+
+Fix platform-specific path examples in personal squad docs, JSDoc, and bundled skill templates.

.changeset/feat-preset-install.md

@@ -0,0 +1,60 @@
+---
+"@bradygaster/squad-cli": minor
+"@bradygaster/squad-sdk": minor
+---
+
+feat: add `squad preset install <source>` for sharing presets via repo URL or local path (#1224)
+
+Closes #1224. Adds a new subcommand that installs a single preset from a GitHub URL or local path into `$SQUAD_HOME/presets/<name>/` — the peer-to-peer preset sharing flow that was missing in v0.10.0.
+
+### CLI
+
+```bash
+# From a GitHub repo (preset at <repo-root>/preset.json or <repo-root>/presets/<name>/)
+squad preset install https://github.com/tamir/my-presets#my-awesome-team
+
+# From a sub-path
+squad preset install https://github.com/tamir/my-presets/tree/main/presets/my-awesome-team
+
+# From SSH URL
+squad preset install git@github.com:tamir/my-presets.git#my-awesome-team
+
+# From a local path
+squad preset install ./my-awesome-team
+
+# Override the installed name
+squad preset install https://github.com/tamir/my-presets#my-awesome-team --name corp-team
+
+# Overwrite an existing preset
+squad preset install <source> --force
+```
+
+After install, the preset is a normal entry in `$SQUAD_HOME/presets/` — `squad preset list`, `squad preset apply <name>`, and `squad init --preset <name>` all work as today.
+
+### Why
+
+The existing `squad preset init --remote` flow is for syncing your *whole* `$SQUAD_HOME` repo across machines (single-user, multi-machine use case). There was no built-in way to install just *one* preset from someone else's repo. Users had to:
+1. Manually clone the repo to a temp dir
+2. `cp -r <clone>/presets/<name> $SQUAD_HOME/presets/`
+3. Then `squad preset apply <name>`
+
+…or hijack `SQUAD_HOME` (which collides with their own personal squad config).
+
+### What it does
+
+1. Resolves source — GitHub URL → shallow `git clone --depth 1` to a temp dir; local path → use as-is
+2. Locates the preset within the source via 3 patterns:
+   - Source dir contains `preset.json` → single-preset source
+   - Source dir contains a `presets/` collection → require `--name` (or `#name` fragment) to pick
+   - Source dir IS the `presets/` dir → require `--name`, or auto-pick if only one preset
+3. Validates the preset's `preset.json` manifest (name, agents[]) before any destructive action
+4. Verifies `agents/` directory exists
+5. Copies `preset.json` (with optional rename) + `agents/` into `$SQUAD_HOME/presets/<name>/`
+6. Fail-stops if destination exists, unless `--force` is passed
+7. Cleans up the temp clone whether install succeeds or fails
+
+### What's NOT in scope (deferred to follow-ups)
+
+- `squad preset uninstall` — `rm -rf $SQUAD_HOME/presets/<name>` works for now
+- `squad preset update <name>` to pull a fresh version from origin
+- Public preset registry / discovery catalog

.changeset/fix-cli-sdk-workspace-pin.md

@@ -0,0 +1,5 @@
+---
+"@bradygaster/squad-cli": patch
+---
+
+Force the CLI's squad-sdk dependency through the repo workspace by using a root file dependency plus an npm override for the CLI package. This keeps fresh installs linked to the local SDK prerelease instead of pulling the stale published SDK. Closes #1405.

.changeset/fix-coordinator-inline-dispatch-gate.md

@@ -0,0 +1,24 @@
+---
+"@bradygaster/squad-cli": patch
+"@bradygaster/squad-sdk": patch
+---
+
+Fix coordinator inline-dispatch regression: restore always-on dispatch gate in the Squad coordinator template
+
+**Problem**
+
+In v0.10.0 the Squad coordinator started doing domain work itself instead of dispatching to roster agents (it worked in v0.9.4). Root cause: commit `afe78188` (#1035, "context overflow sentinel + coordinator size reduction") relocated the concrete inline-dispatch gate and the dispatch mechanics out of the always-on coordinator prompt (`.squad-templates/squad.agent.md`) into lazy-loaded reference files (`client-compatibility-reference.md`, `spawn-reference.md`). The remaining inline one-liner ("inline work is last-resort fallback only") was too soft, and the concrete "when may I work inline?" rule + the VS Code `runSubagent` how-to were no longer in-context, so the coordinator defaulted to executing work itself.
+
+**Fix**
+
+Three minimal edits to the canonical coordinator template (`.squad-templates/squad.agent.md`), synced to all mirrors via `npm run sync-templates`:
+
+1. **Client Compatibility** — replaced the soft one-liner with an explicit **Inline-dispatch gate**: doing domain work inline is permitted ONLY in Direct Mode, or when NEITHER `task` NOR `runSubagent` is available; otherwise the coordinator MUST dispatch.
+2. **How to Spawn an Agent** — added a one-line **STOP gate**: about to produce a domain artifact with no `task` / `runSubagent` call this turn → STOP and dispatch (exceptions: Direct Mode, or no spawn tool exists).
+3. Re-inlined a ~5-line **VS Code `runSubagent` micro-playbook** so the how-to-dispatch mechanics are always-on instead of lazy-loaded.
+
+The legitimate Direct/Lightweight response modes are preserved (Lightweight still spawns one agent; Direct still answers from context without spawning).
+
+**Validation**
+
+New deterministic, subprocess-free regression test `test/coordinator-inline-dispatch-gate.test.ts` asserts the gate/STOP-gate/micro-playbook exist in canonical and that the gate is present in all 5 synced copies (parity). Red before the fix (8/8 failing), green after. Existing requires a `squad upgrade` for existing installs to pick up the new template.

.changeset/fix-copilot-sdk-type-compat.md

@@ -0,0 +1,12 @@
+---
+"@bradygaster/squad-sdk": patch
+---
+
+fix: update adapter/client.ts for @github/copilot-sdk 1.0.4 API changes
+
+Fixes 5 TypeScript errors caused by breaking changes in `@github/copilot-sdk@1.0.4`:
+
+- Replace removed `cliPath`/`cliArgs`/`useStdio`/`port`/`cliUrl` options with the new `RuntimeConnection` pattern
+- Update `ping()` return type from `timestamp: number` to `timestamp: string`
+- Make `SquadModelBilling.multiplier` optional to match upstream `ModelBilling`
+- Replace `client.on()` with `client.onLifecycle()` for session lifecycle events

.changeset/fix-dep0190-shell-spawn.md

@@ -0,0 +1,11 @@
+---
+"@bradygaster/squad-cli": patch
+---
+
+Fix Windows shell spawn issues and gh auth false-negative
+
+- **DEP0190 fix:** Added `escapeForCmd()`/`escapeArgs()` to properly quote args when `shell: true` is used on Windows. Changed `shell: true` → `shell: IS_WINDOWS`.
+- **Capability migration:** Moved monitor-email, monitor-teams, retro, decision-hygiene from inline `buildAgentCommand`/`spawnWithTimeout` to shared `agent-spawn.ts` module.
+- **gh auth fix:** Use `gh auth token` instead of `gh auth status` — the latter returns non-zero when any keyring entry is stale, even if the active account works fine.
+- **Copilot flag fix:** Use `-p` (correct) instead of `--message` (non-existent) for copilot CLI prompt flag.
+- **Default --yolo:** When `--execute` is active and no `copilotFlags`/`agentCmd` are set, default to `--yolo` so copilot doesn't hang waiting for permission prompts.

.changeset/fix-green-suite.md

@@ -0,0 +1,5 @@
+---
+"@bradygaster/squad-sdk": patch
+---
+
+Fix local test-suite failures by aligning personal squad path expectations, stabilizing observer file classification, and skipping environment-dependent docs/Aspire checks when required local dependencies are unavailable.

.changeset/fix-routing-strip-example-quotes.md

@@ -0,0 +1,9 @@
+---
+"@bradygaster/squad-sdk": patch
+---
+
+Fix: strip surrounding quotes from routing.md example phrases in `parseRoutingMarkdown`
+
+`parseRoutingMarkdown` split the Examples cell on commas but never stripped the surrounding quotes, so a quoted example like `"unit tests"` was stored verbatim (quotes included). When `compileRoutingRules` / `matchRoute` later tokenized it, the quote characters glued onto the boundary words (`"unit`, `tests"`), producing regex patterns that could never match — so routing tables that used quoted examples silently routed every message to the fallback agent.
+
+Leading/trailing quotes (`"`, `'`, `` ` ``) are now stripped from each example, so quoted and unquoted examples behave identically. Adds regression tests covering both the parse step and end-to-end `matchRoute`.

.changeset/fix-sdk-export-gitignore-state.md

@@ -0,0 +1,11 @@
+---
+"@bradygaster/squad-sdk": patch
+---
+
+fix(sdk): export `addSquadStateGitignoreBlock` / `removeSquadStateGitignoreBlock` from the package root
+
+`packages/squad-cli/src/cli/commands/migrate-backend.ts` imports these helpers from
+`@bradygaster/squad-sdk`, but they were never re-exported from `src/index.ts`. This broke
+the CLI TypeScript build (`TS2305: has no exported member`). Re-export the two functions
+(plus their marker constants) so the CLI compiles and the state-backend migration command
+resolves them. Unblocks cutting a stable release that carries the #1378 inline-dispatch-gate fix.

.changeset/fix-squad-home-env-bugs.md

@@ -0,0 +1,12 @@
+---
+"@bradygaster/squad-sdk": patch
+"@bradygaster/squad-cli": patch
+---
+
+fix: respect SQUAD_HOME in capabilities.ts and comms-teams.ts, implement SQUAD_PERSONAL_DIR env var, fix Windows shell flag in loop preflight, link personal squad during init
+
+- capabilities.ts: use `resolveSquadHome()` instead of hardcoded `~/.squad/` for machine-capabilities.json (#1280)
+- comms-teams.ts: use `resolveSquadHome()` instead of hardcoded `~/.squad/` for Teams OAuth token storage (#1279)
+- resolution.ts: implement `SQUAD_PERSONAL_DIR` env var override in `resolvePersonalSquadDir()` (#1278)
+- loop.ts: add `shell: process.platform === 'win32'` to `checkCopilotCli()` execFile call (#1372)
+- init.ts: set `teamRoot` in config.json to personal squad directory when one exists (#1010, #984)

.changeset/help-externalize-internalize.md

@@ -0,0 +1,5 @@
+---
+"@bradygaster/squad-cli": patch
+---
+
+Add `externalize` and `internalize` to the top-level `squad --help` command list so they are discoverable (#1050).

.changeset/ink7-adaptation.md

@@ -0,0 +1,12 @@
+---
+"@bradygaster/squad-cli": patch
+---
+
+chore: adapt CLI to ink 7.0.6
+
+Updates the ink dependency from ^6.8.0 to ^7.0.6 and adapts keyboard handling in InputPrompt.tsx to ink 7's revised API:
+
+- key.meta no longer fires on bare Escape; guard updated to use key.escape
+- useInput callbacks are now wrapped in reconciler.discreteUpdates(), which flushes React state synchronously at end of callback; rewrote Enter/paste handler to call setValue('') inside the flush rather than in a deferred timer
+
+Closes #1322, #1335.

.changeset/observer-hardening.md

@@ -0,0 +1,5 @@
+---
+"@bradygaster/squad-sdk": patch
+---
+
+Harden squad observer change resolution against directory events, symlinks, and filesystem scan errors.

.changeset/otel-resource-api-migration.md

@@ -0,0 +1,5 @@
+---
+"@bradygaster/squad-sdk": patch
+---
+
+Migrate OTel Resource API to `resourceFromAttributes` for compatibility with `@opentelemetry/resources` 2.x (replaces the removed `Resource` class constructor in `packages/squad-sdk/src/runtime/otel.ts` and `test/aspire-integration.test.ts`)

.changeset/reasoning-effort.md

@@ -0,0 +1,17 @@
+---
+"@bradygaster/squad-sdk": minor
+---
+
+Add reasoning effort support to agent spawning pipeline
+
+Thread `reasoningEffort` through the full agent lifecycle:
+
+- **Charter**: Parse `**Reasoning Effort:**` from `## Model` section in `charter.md`
+- **Config**: Read/write `defaultReasoningEffort` and `agentReasoningEffortOverrides` in `.squad/config.json`
+- **Resolution**: New `resolveReasoningEffort()` with layered priority (per-agent config override > global config > spawn override > charter preference > undefined)
+- **Clamping**: New `clampReasoningEffort()` caps effort to model's max supported level
+- **Lifecycle**: `SpawnAgentOptions.reasoningEffortOverride` passes through to `SquadSessionConfig`
+- **Fan-Out**: `AgentSpawnConfig.reasoningEffortOverride` passes through to `createSession()`
+- **Builders**: `defineAgent()` and `defineDefaults()` accept `reasoningEffort: "low" | "medium" | "high" | "xhigh"`
+- **Template**: Updated charter template with `**Reasoning Effort:** auto`
+- **Validation**: `"auto"` and invalid values are normalized to `undefined` at parse time

.changeset/release-0.11.0.md

@@ -0,0 +1,6 @@
+---
+"@bradygaster/squad-cli": minor
+"@bradygaster/squad-sdk": minor
+---
+
+Stage the 0.11.0 release by cleaning the committed package versions and publishing the 0.11.0 changelog notes.

.changeset/rename-dotnet-aspire-to-aspire.md

@@ -0,0 +1,5 @@
+---
+"@bradygaster/squad-cli": patch
+---
+
+Rename user-facing Aspire terminology in CLI help text and command output. Aspire is a standalone OTLP dashboard, not limited to .NET apps.

.changeset/rename-hire-to-cast.md

@@ -0,0 +1,5 @@
+---
+"squad-cli": minor
+---
+
+Rename `hire` command to `cast` in CLI help and documentation. The `hire` command continues to work as a silent alias (like `cls`/`clear` in PowerShell) — no deprecation, no warnings, it just does the same thing. All user-facing text now presents `cast` as the canonical verb because we're casting agents, not hiring humans.

.changeset/slim-squad-agent-md-phase1.md

@@ -0,0 +1,90 @@
+---
+"@bradygaster/squad-sdk": minor
+"@bradygaster/squad-cli": minor
+---
+
+Slim squad.agent.md by extracting 3 sections to satellite skills (closes #1308 phase 1)
+
+## Symptom
+
+`squad.agent.md` is loaded as the agent prompt at every Copilot session start. As of v0.10.0-insider.1 it sits at **81 KB / 1,137 lines** and was steadily growing — the v0.10 stabilisation pass alone added +10.6 KB / +114 lines. Every byte of that file is paid at every session.
+
+## Phase 1 fix (this PR)
+
+Extract three **low-cross-reference, high-byte** sections into satellite skills the coordinator loads on demand via the `skill` tool. Same pattern that already worked for `cross-squad-communication` (#1295).
+
+| Extracted to satellite skill | Bytes saved in main file |
+|---|---|
+| `coordinator-init-mode` (Init Mode Phase 1 + Phase 2) | 5.4 KB |
+| `coordinator-source-of-truth` (Source of Truth Hierarchy table) | 4.4 KB |
+| `coordinator-response-mode` (Response Mode Selection + Lightweight Spawn Template) | 3.9 KB |
+
+### Result
+
+- `squad.agent.md`: **81 KB → 70 KB** (-13.9%, -140 lines)
+- Three new bundled skills (`coordinator-source-of-truth`, `coordinator-response-mode`, `coordinator-init-mode`) installed alongside the existing 16 — total 19 skills at `.github/skills/`
+- Behaviour unchanged: each removed section is replaced with a stub that names the trigger condition and instructs the coordinator to `skill(coordinator-X)` before acting
+
+## Stubs left in `squad.agent.md`
+
+Each extracted section keeps a short stub (4-12 lines) so the coordinator still knows the section exists and what triggers it. The full algorithm/table/template lives in the satellite skill.
+
+Example (Source of Truth, was 30+ lines, now 9):
+
+```markdown
+## Source of Truth Hierarchy
+
+Squad files split into **authoritative** (governance, roster, charters — static) and 
+**derived / append-only** (decisions, history, logs — runtime-owned). The four 
+governing rules:
+
+1. **`squad.agent.md` wins** any conflict with another file.
+2. **Append-only files** are never retroactively edited.
+3. **Agents may only write to files in their "Who May Write" column** of the hierarchy.
+4. **Only Squad (Coordinator)** records accepted decisions in `.squad/decisions.md`.
+
+**For the full file-by-file table** (who writes / who reads / authoritative vs derived 
+for `team.md`, `decisions.md`, `routing.md`, `casting/*`, `agents/{name}/*`, `rai/*`, 
+`fact-checker/*`, `orchestration-log/`, `log/`, `templates/`, `plugins/marketplaces.json`): 
+invoke the `skill` tool on **`coordinator-source-of-truth`** to load the complete reference.
+```
+
+## What is NOT extracted (intentional)
+
+These sections stay in `squad.agent.md` because they're loaded on EVERY prompt and / or are load-bearing for first-touch behaviour:
+
+- **Team Mode + state-backend handshake + HARD RULE** (#1306) — handshake must fire before any state write
+- **Routing table** — the trigger table for every user prompt
+- **Hard trigger — keyword-to-skill match** paragraph (#1307) — load-bearing for the spawn-routing fix
+- **How to Spawn an Agent** — referenced from every routing-table action
+- **Coordinator Identity / Personal Squad / Memory Governance Tools** — frequently re-read inline
+
+Follow-up issues will tackle these one at a time if/when needed.
+
+## Wired changes
+
+- New: `.squad/skills/coordinator-{source-of-truth,response-mode,init-mode}/SKILL.md` are the **canonical source files** kept in the squad repo itself (the same convention every other bundled skill follows). At install/upgrade time they are copied to `.github/skills/coordinator-{x}/SKILL.md` in the user's repo — that's the Copilot CLI custom-skills location adopted by #1304 (formerly `.copilot/skills/`).
+- Mirrored at build time to `packages/squad-cli/templates/skills/` and `packages/squad-sdk/templates/skills/` via `scripts/sync-skill-templates.mjs` (same path every other manifest skill takes).
+- `MANIFEST_SKILL_NAMES` in `packages/squad-sdk/src/config/init.ts` grows by 3 entries (now 19)
+- `TEMPLATE_MANIFEST` in `packages/squad-cli/src/cli/core/templates.ts` grows by 3 entries with `../.github/skills/` destinations (matching the post-#1304 install location)
+- `.squad-templates/squad.agent.md` replaces each extracted section with a stub
+- 4 mirrored copies re-synced via `scripts/sync-templates.mjs --sync`
+
+## Tests
+
+- `test/init.test.ts > should install every manifest-curated skill (regression: bradygaster/squad#1289, #1264)` — already imports `MANIFEST_SKILL_NAMES` and iterates it, so it automatically asserts the 3 new skills install. **287/287 tests pass.**
+- Smoke test: fresh `squad init` produces 19 skills at `.github/skills/`, `squad.agent.md` is 70 KB.
+
+## Composability
+
+Disjoint from all other open PRs. Pure file moves + a few line replacements + 3 manifest entries.
+
+## Follow-ups (separate PRs)
+
+The remaining high-bloat sections in `squad.agent.md` are stickier and need careful design to extract:
+
+- **Routing table** (9.2 KB) — needed on every prompt; can't be lazy-loaded as-is. May be slimmable by moving the action-cell verbiage into satellite skills (the trigger table stays, the action prose moves).
+- **Team Mode** (5.5 KB) — contains the state-backend handshake, which MUST fire on every session. Maybe extract the worktree-awareness / casting-migration sub-sections.
+- **How to Spawn an Agent** (3.2 KB) — could extract the role-emoji catalog.
+
+Target: get the coordinator down to **~45 KB** in 2-3 follow-up PRs.