Jeremy McSpadden eb302fe1d2 feat: parallel milestone orchestration foundation (#672 )

Add infrastructure for parallel milestone execution behind
`parallel.enabled: false` flag (opt-in, zero impact to existing users).

New modules:
- session-status-io.ts: File-based IPC protocol with atomic writes,
  signal lifecycle (pause/resume/stop), and stale session detection
- parallel-eligibility.ts: Milestone parallelism analysis checking
  dependency satisfaction and file overlap across slice plans
- parallel-orchestrator.ts: Core orchestrator managing worker lifecycle,
  budget tracking, and coordination via session status files
- /gsd parallel [start|status|stop|pause|resume] command handlers

Modified:
- types.ts: ParallelConfig interface (enabled, max_workers, budget_ceiling,
  merge_strategy, auto_merge)
- preferences.ts: Parallel config validation, merging, and resolver
- commands.ts: /gsd parallel subcommand routing with argument completions

Tests: 39 new tests covering session I/O roundtrip, signal lifecycle,
stale detection, eligibility formatting, orchestrator lifecycle,
budget enforcement, and preference validation.

2026-03-16 20:32:10 -06:00

772 B

Raw Blame History

Issue #672: Parallel Milestone Orchestration

Issue: https://github.com/gsd-build/gsd-2/issues/672 Contributor: @deseltrus (7 merged PRs, proven contributor) Status: WIP — foundation modules built, orchestrator core in progress Default: parallel.enabled: false — opt-in, zero impact to existing users

Delivery Plan (6 PRs)

PR 1: Worktree Bugfixes - MERGED (#675)

PR 2: Dispatch Hardening (Small) - pending contributor

PR 3: Parallel Config + Preferences (Small) - included in this PR

PR 4: Session Status Protocol (Medium) - included in this PR

PR 5: Orchestrator Core (Large) - included in this PR

PR 6: Dashboard + Commands (Medium) - commands included, dashboard deferred

See full plan in the GitHub issue comment.

772 B Raw Blame History