phase-argument-parsing

Phase argument parsing handles different input variations by extracting the first numeric argument, applying zero-padding to the integer part, and preserving decimal suffixes. It validates phase existence via the bgsd-tools plan route and resolves the full directory path for downstream tasks.

Directory lookup resolves the full phase directory path by validating the phase existence via the bgsd-tools plan:find-phase route. This ensures downstream planning tasks receive standardized phase formatting and accurate directory routing for consistent execution.

Phase argument parsing extracts flags prefixed with -- alongside the phase number from user input. Remaining text after the numeric argument and flags becomes the description, enabling insert and add commands to receive structured input for downstream planning tasks.

Zero-padding phase numbers ensures consistent lexicographic sorting and uniform directory naming across the roadmap. Normalizing 8 to 08 prevents ordering anomalies and mismatched directory lookups when multiple agents reference different phases concurrently.

Normalizing phase references with decimal suffixes handles inputs like 8.1 by padding only the integer component to 08.1. The parser isolates the decimal portion during extraction, ensuring the suffix remains unchanged through the zero-padding and validation process.