[BUG] Ambiguous Argument Parsing in 'build' and 'package' commands

[mark-e-deyoung]

Problem

Positional arguments are currently overloaded. Passing a version string (e.g., 'v0.0.1') to is often misinterpreted as a project directory path, causing the build to fail if a directory named 'v0.0.1' does not exist.

Proposed Implementation Strategy

1. Explicit Flags: Refactor the CLI to prioritize explicit flags (e.g., or ) for metadata.
2. Directory Validation: Implement a check that verifies if a positional argument is a valid directory before assuming it is the project root.
3. Parser Modernization: Move from simple positional shifting to a more robust argument parser that can distinguish between paths and semantic versions.