docs(cli): require --auto high in droid exec mission examples

[lukealvoeiro]

Gap

EXEC-23 / EXEC-4 / EXEC-59 (docs make a command fail, P2). Every headless mission example in the docs is rejected by the CLI before anything runs, because missions require --auto high (or --skip-permissions-unsafe).

Evidence

• Docs (EN and JP have the same lines):
  • docs/features/missions/reference.mdx:22: droid exec --mission -f mission.md
  • docs/features/missions/reference.mdx:28-33: worker/validator override example, no --auto
  • docs/cli/droid-exec/overview.mdx:503-509 (JP :438-444): uses --auto medium
  • docs/reference/cli-reference.mdx:149-153 (JP :79-83): the five mission rows. None has --auto, and the four worker/validator rows have no prompt either.
• Code: apps/cli/src/entrypoints/exec/assertValidOptions.ts:254-258 in factory-mono:

  if (!options.skipPermissionsUnsafe && options.auto !== AutonomyLevel.High)

  throws Invalid flags: --mission requires --auto high or --skip-permissions-unsafe. The orchestrator needs high autonomy to manage workers.
• Command run: none. The audit environment blocks any shell command containing the mission flag, so this finding rests on the validation code above. The one example that already passes --auto high (enterprise/security-review.mdx:51, EN and JP) is consistent with it.

Why it matters

Anyone who copies the documented mission command (the main headless example on the Missions reference page, the droid exec overview, or the CLI reference table) gets an immediate "Invalid flags" error.

Fix

• Add --auto high to every droid exec mission example in EN and JP.
• Change --auto medium to --auto high in the droid exec overview example.
• Add -f mission.md to the four worker/validator rows in the CLI reference, which otherwise had no prompt.
• Prose is unchanged.

Validation

• Grepped docs/ (EN and JP) for droid exec mission invocations: every code example now includes --auto high. Remaining matches are prose mentions and changelog entries, not runnable examples.
• Edits are confined to code fences and table cells; table pipe counts are unchanged.

Found by the scheduled CLI arguments audit.

[factory-droid]

Droid finished @lukealvoeiro's task —— View job

---

The mission examples now consistently include the required high-autonomy flag and a mission prompt. No actionable issues were found.

0 inline comments posted