Update readme and fix CI

[zmcddn]

Summary

Describe what changed and why.

Checklist

• I ran the relevant tests locally
• I updated docs if behavior changed
• For UI rendering changes, I checked whether a layout fixture was needed
  under fixtures
• I avoided committing secrets or machine-specific state
• I added or updated changelog notes if this is user-visible

Notes for reviewers

Anything you want reviewers to focus on.

[github-actions]

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

OpenSSF Scorecard

Package	Version	Score	Details
pip/mypy	2.3.1	Unknown	Unknown
pip/packaging	26.3	Unknown	Unknown
pip/ruff	0.16.3	Unknown	Unknown
pip/typer	0.27.1	Unknown	Unknown

Scanned Files

• uv.lock