Distillation

Date: Aug 24, 2026

• 🟡 (15:20) Assistant identified that the PR targets 2.29.0-dev.0, confirming Bugbot’s stale-gate finding.
• 🟡 (15:20) Assistant planned to update the version gate to 2.29.0.
• 🟡 (15:20) Assistant planned to normalize build metadata before version comparisons.
• 🟡 (15:20) Assistant planned to replace fixGlobalBooleanFlags’ manual argv scan with Node’s parser.
• 🟡 (15:20) src/utils/helpers.ts defines MAX_STEP_OUTPUT_BYTES = 64 * 1024.
• 🟡 (15:20) envToBool(envVar) lowercases String(envVar) and returns false for values in FALSY_ENV_VALUES: '', 'undefined', 'null', '0', 'false', and 'no'.
• 🟡 (15:20) extractWorkspaceSelection(argv, env = process.env) in src/utils/helpers.ts reads CRAFT_WORKSPACE; supports --workspace foo and --workspace=foo; a supplied CLI workspace value takes precedence over the environment value; bare/valueless --workspace, or --workspace= with an empty value, falls back to CRAFT_WORKSPACE; returns undefined when neither provides a value.
• 🟡 (15:20) extractWorkspaceSelection treats a following token as the --workspace value only when it exists and does not start with '-'; it intentionally leaves bare --workspace for yargs validation rather than consuming another option as its workspace name.
• 🟡 (15:20) GlobalFlags in src/utils/helpers.ts includes optional 'dry-run'?: boolean, 'no-input'?: boolean, and 'log-level'?: keyof typeof LogLevel; internal defaults in GLOBAL_FLAGS are 'dry-run': false, 'no-input': false, and 'log-level': 'Info'.