Skip to content

feat(run): squads pause/resume — activation state enforced by runner + org planner (#877)#892

Merged
kokevidaurre merged 4 commits into
developfrom
squads/run-cli-mqdvmxjx-0
Jun 14, 2026
Merged

feat(run): squads pause/resume — activation state enforced by runner + org planner (#877)#892
kokevidaurre merged 4 commits into
developfrom
squads/run-cli-mqdvmxjx-0

Conversation

@agents-squads

@agents-squads agents-squads Bot commented Jun 14, 2026

Copy link
Copy Markdown
Contributor

What & why

Implements #877: squad pause state was declarative-only (SQUAD.md frontmatter status: paused) — nothing read it, so the org planner dispatched paused squads anyway and freezes only worked by agents happening to read prose. This makes pause first-class and enforced in one command.

Changes

  • squads pause <squad> [--reason] / squads resume <squad> (src/commands/pause.ts) — write existing SQUAD.md frontmatter (status, paused_since, paused_reason); no new state store; --json supported.
  • Enforcement: squads run refuses a paused squad (--force bypasses); org runner/planner skips paused (org-cycle.ts, fixes the dispatch-paused waste bug); cron/scheduled skips them (autonomous.ts).
  • Visibility: squads status + squads dash show paused state + since/reason.
  • Docs + seed skill reference regenerated.

Validation

build ✓ · tsc --noEmit ✓ · eslint ✓ · 2001 tests pass (60 new: pause writes frontmatter, run refuses paused, --force overrides, org skips paused).

Closes #877. Also resolves polish items found during implementation: #879, #881, #883, #884, #885.

)

Remove all references to `squads autopilot` (deprecated) from docs/commands.md
and docs/running.md, replacing with the correct `squads autonomous` commands.
Add a Pause and Resume section to docs/commands.md covering usage, options,
and runtime behavior when a squad is paused.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@agents-squads agents-squads Bot requested a review from kokevidaurre as a code owner June 14, 2026 15:01
@github-actions github-actions Bot added the docs label Jun 14, 2026
- #883: update --force description to mention pause-enforcement bypass
- #884: resumeCommand returns cleanly (exit 0) when squad is not paused,
  making the command idempotent; setSquadPauseState is never called
- #885: add test coverage verifying command field in all JSON error
  responses for pauseCommand and resumeCommand

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…ity (#877)

Refuse 'squads run' on a paused squad (--force overrides); org planner and
cron/scheduled dispatch skip paused squads; status + dash surface pause state.
Reads existing SQUAD.md frontmatter (status/paused_since/paused_reason).

Co-Authored-By: Claude <noreply@anthropic.com>
@codecov-commenter

Copy link
Copy Markdown

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

❌ Patch coverage is 10.00000% with 27 lines in your changes missing coverage. Please review.

Files with missing lines Patch % Lines
src/lib/squad-parser.ts 13.04% 20 Missing ⚠️
src/lib/org-cycle.ts 0.00% 7 Missing ⚠️

📢 Thoughts on this report? Let us know!

Co-Authored-By: Claude <noreply@anthropic.com>
@kokevidaurre kokevidaurre changed the title docs: fix deprecated autopilot refs and add pause/resume docs feat(run): squads pause/resume — activation state enforced by runner + org planner (#877) Jun 14, 2026
@kokevidaurre kokevidaurre enabled auto-merge (squash) June 14, 2026 16:21
@kokevidaurre kokevidaurre merged commit 30f81b2 into develop Jun 14, 2026
13 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants