Module scan 

Task scanning command that inspects repo state and updates the queue.

Responsibilities:

• Validate queue state before/after scanning and persist updated tasks.
• Render scan prompts with repo context and dispatch runner execution.
• Enforce clean-repo and queue-lock safety around scan operations.

Not handled here:

• CLI parsing or interactive UI wiring.
• Runner process implementation details or output parsing.
• Queue schema definitions or config persistence.

Invariants/assumptions:

• Queue/done files are the source of truth for task ordering and status.
• Runner execution requires stream-json output for parsing.
• Permission/approval defaults come from config unless overridden at CLI.

Structs

ScanOptions

Enums

ScanLockMode

Functions

run_scan

set_debug_mode

Set the global debug mode flag.