Distillation

Date: Aug 24, 2026

• 🟡 (15:19) src/index.ts establishes the active workspace before yargs parsing/builders by calling setActiveWorkspace(extractWorkspaceSelection(argv)) after fixGlobalBooleanFlags(process.argv.slice(2)); this is required because command builders such as publish may read configuration and derive --target choices before middleware, so workspace selection in middleware would occur too late.
• 🟡 (15:19) extractWorkspaceSelection(argv) is documented as the single source of truth for --workspace versus CRAFT_WORKSPACE precedence.
• 🟡 (15:19) GLOBAL_BOOLEAN_FLAGS defines global no-input and dry-run flags; fixGlobalBooleanFlags(argv) manually scans arguments and injects '1' after a standalone matching global flag so yargs can treat environment-backed string flags as booleans while permitting --flag=no.
• 🟡 (15:19) Assistant proposed replacing fixGlobalBooleanFlags’ manual argument scan with Node’s parseArgs({ tokens: true }), while preserving early workspace selection before yargs command builders run.