v0.1.2

Highlights

• Adds optional sticky PR comments to the reusable Cremona GitHub workflow.
• PR comments summarize the repo verdict, routing pressure, baseline diff, top routing rows, and top hotspots.
• Comment updates are same-repository pull_request only, with fork PRs skipped and stale run updates guarded by PR head SHA.

Install / Upgrade

uvx cremona scan /path/to/repo
pipx install --force cremona==0.1.2

CI Gate

Use the reusable workflow at NeapolitanIcecream/cremona/.github/workflows/reusable-gate.yml@v0.1.2.

To enable the sticky PR comment, set comment-on-pr: true and grant the caller job actions: read, contents: read, and pull-requests: write.

Agent Workflow

Use the PR comment to choose the next target from the top routing rows, make a narrow refactor, rerun Cremona, and update the baseline only when structural debt genuinely improves or the schema changes.

Breaking Changes

None. CLI usage and report schema remain unchanged at schema_version = 3.

Sample Output

## Cremona report

- Debt status: `stable`
- Routing pressure: `investigate_soon`
- Signal health: `full`
- Baseline regressions: `false`
- Baseline diff: `new=0`, `worsened=0`, `resolved=0`

### Top routing rows

| Priority | Score | File | Change | Coverage |
| --- | ---: | --- | --- | --- |
| `investigate_soon` | 36 | `src/cremona/core/engine.py` | `6 commits / 3328 churn` | `branch 0.82` |