Framework migration: core parser

[SorraTheOrc]

Summary: Replace hand-rolled argument parsing in src/cli.ts with the chosen CLI framework and wire core commands (generate, list, show, play, version).

Acceptance Criteria

• Core commands accept the same flags/args as today for parity.
• Programmatic main() export remains for tests.
• Unit and integration tests for core commands pass.

Minimal Implementation

• Add framework scaffold and implement generate dispatch to existing implementation.
• Keep old parsing module behind a compatibility shim until parity proven.

Dependencies: TF-0MMJ7YHID0S9PFY1 (Evaluate CLI libraries and choose one).

Deliverables:

• Updated src/cli.ts (or split files), migration notes, and updated tests.

[SorraTheOrc]

\n\n**OpenCode**\n\nStarted implementation: added that wraps the existing and updated to use the wrapper. This enables an incremental migration path using . Next: wire to call existing render path directly in a small patch and run tests.

[SorraTheOrc]

\n\n**OpenCode**\n\nPOC implemented: added (yargs command module) and wired to use . Added to . Next: run tests and fix any import/compat issues; then migrate additional commands incrementally.

[SorraTheOrc]

\n\n**OpenCode**\n\nImplemented yargs command modules: generate, list, show, play, version. These modules wire to existing code paths (renderRecipe, encodeWav, decodeWavFile, playAudio). Next: run full test suite and iterate on any failing tests; then remove compatibility delegations where safe and continue migrating remaining commands.

[SorraTheOrc]

\n\n**OpenCode**\n\nOpened PR for yargs migration POC: https://github.com//pull/138. This PR contains the yargs loader and command modules for generate/list/show/play/version. Tests passed locally before pushing.

[SorraTheOrc]

\n\n**OpenCode**\n\nImplementation progress: hardened yargs migration wrapper to preserve full CLI parity while introducing framework-based command routing. Updated file: src/cli.yargs.ts. Behavior: for migrated commands (generate/list/show/play/version) we parse through yargs, then delegate execution to legacy main for exact output/error compatibility; all other commands and top-level help/version continue through legacy path. Validation: npm test passed (111 files, 2337 tests). Commit hash: not committed yet.

[SorraTheOrc]

\n\n**OpenCode**\n\nCommitted parity-preserving yargs wrapper hardening in commit ab357c3. Files: src/cli.yargs.ts. Changes: route help/version and non-migrated commands directly to legacy main; parse migrated commands with yargs then delegate to legacy execution to keep output/exit compatibility while retaining framework scaffolding. Validation: npm test passed (111 files, 2337 tests).