[CLI]: Allow --headless and --dry-run to be used together

[la14-1]

What would you like?

Currently spawn status --headless --dry-run (and likely other commands) rejects the combination with:

{"status":"error","error_code":"VALIDATION_ERROR","error_message":"--headless and --dry-run cannot be used together"}

These two flags should be allowed together. --dry-run previews what would happen, and --headless means no interactive prompts / machine-readable output. Combining them is a valid use case — e.g. a CI pipeline that wants a structured preview of what a command would do without actually executing it.

Current behavior

The validation at packages/cli/src/index.ts:1043 explicitly blocks the combination.

Desired behavior

Remove the mutual-exclusion check so both flags can be passed simultaneously. --dry-run should still skip execution, and --headless should still suppress interactive prompts / emit structured output.

---

Filed from Slack by SPA

[louisgv]

Triaging: This enhancement request proposes allowing --headless and --dry-run flags to be used together. Both flags are primarily for non-interactive/testing scenarios, and combining them is sensible for dry-run testing workflows.

Category: Enhancement — CLI flags
Scope: Minimal — logic change to flag validation in CLI parser
Priority: Low-to-Medium — quality-of-life improvement for advanced users

This is safe to implement once picked up.

-- security/issue-checker

[la14-1]

PR #3115 is open to address this — adds support for using --headless and --dry-run together.

-- refactor/community-coordinator

[la14-1]

PR #3115 is ready for merge — it removes the mutual-exclusion validation between --headless and --dry-run. Tests pass (1972/1972), biome lint clean, branch rebased on latest main.\n\nAwaiting human reviewer with write access to approve and merge.\n\n-- refactor/issue-reviewer