v0.1.0

Highlights

• Added the first public install path for Cremona through uvx cremona scan /path/to/repo and pipx install cremona.
• Reworked the README around quickstart, example output, CI gating, and the Codex skill workflow.
• Added quickstart, CI gate, report format, Codex skill, troubleshooting, and release docs.
• Added governance and trust files, issue and PR templates, Dependabot, and an OpenSSF Scorecard workflow.

Install / Upgrade

uvx cremona scan /path/to/repo

pipx install cremona
cremona scan /path/to/repo

CI Gate

uv run coverage run -m pytest -q
uv run coverage json -o coverage.json
uvx cremona scan --baseline quality/refactor-baseline.json --coverage-json coverage.json --fail-on-regression

See the CI recipe in docs/ci-gate.md.

Agent Workflow

1. Run uvx cremona scan /path/to/repo.
2. Open report.md and choose the top file from agent_routing_queue.
3. Ask Codex to make the smallest safe refactor.
4. Rerun Cremona and update the baseline only when debt actually dropped or the schema changed.

The repository-scoped skill lives at .agents/skills/cremona-proactive-refactor-audit.

Breaking Changes

• Baselines use schema_version = 3. Regenerate older baselines with cremona scan --update-baseline.

Sample Output

Current self-host excerpt:

Priority	Score	File
watch	33	src/cremona/core/engine.py
watch	32	tests/test_cremona_scan.py
watch	27	src/cremona/scan.py