feat(cli): add --version option 🤖🤖🤖

[AnayGarodia]

Description

Add a standard vocalinux --version option backed by the package's existing __version__ value. The parser now also uses a stable program name so help and version output remain consistent across Python versions.

Closes #555

Type of Change

• ✨ New feature
• ✅ Test update

Validation

• PYTHONPATH=src python3 -m pytest tests/test_main_args_deps.py -q (25 passed)
• python3 -m py_compile src/vocalinux/main.py tests/test_main_args_deps.py

Checklist

• Code follows the existing project style
• Tests cover the new behavior
• Focused tests pass locally

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 85.50%. Comparing base (fbcd28d) to head (b9d74dd).
⚠️ Report is 9 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #563      +/-   ##
==========================================
+ Coverage   84.83%   85.50%   +0.67%     
==========================================
  Files          33       33              
  Lines        5864     5866       +2     
  Branches      952      952              
==========================================
+ Hits         4975     5016      +41     
+ Misses        688      649      -39     
  Partials      201      201              

Files with missing lines	Coverage Δ
src/vocalinux/main.py	91.55% <100.00%> (+0.07%)	⬆️

... and 2 files with indirect coverage changes

🚀 New features to boost your workflow:

• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[jatinkrmalik]

There is a real gap on the full CLI path: main() still acquires the single-instance lock before parse_arguments(). With Vocalinux already running (the common tray case), vocalinux --version exits 1 with "Another instance is already running" and never prints the version. I reproduced that with a held flock on instance.lock.

Requested change

Please parse (or special-case --version) before acquire_lock, similar to how PR #568 by @webenefits handles --toggle / --start / --stop. A main()-level test with the lock held would lock this in.

Happy to approve once that ordering is fixed.

[AnayGarodia]

good catch, moved parse_arguments() before the lock so --version and --help work while the app is running. added a test that runs main() with the lock held and checks --version exits 0. full suite passes

[jatinkrmalik]

Thanks for the follow-up fix. Moving arg parsing before the lock check makes sense. Looks good to merge.