[codex] Add agent-friendly refactor audit routing

[NeapolitanIcecream]

Summary

• upgrade scripts/refactor_audit.py from a static hotspot report into an agent-friendly routing queue with git history, change coupling, ambiguity signals, optional coverage, and subsystem summaries
• add signal-health reporting plus compatibility-pressure scoring so compat-heavy files and missing coverage are surfaced explicitly in repo verdicts
• split structural debt status from routing pressure, add basic shared-commit coupling denoising, and keep routing advice out of regression gating
• preserve legacy run_refactor_audit(**legacy_kwargs) defaults and retain git-history scoring for explicit scoped files that sit outside the default audit target set
• update docs and the checked-in refactor baseline to schema v2 so the workflow, baseline semantics, and current output stay aligned

Impact

• the audit now answers which files an agent should touch next, not just which symbols look structurally large
• repo verdict semantics are less ambiguous: debt_status is hotspot/baseline-driven, while routing_pressure remains advisory
• coverage remains optional, but runs without --coverage-json are explicitly marked as partial-signal analyses
• shared-commit coupling now filters obvious sweep commits by ignoring very large tracked-file commits
• explicit scoped audits such as main.py keep their own churn and commit-frequency history instead of falling back to synthetic zeroes
• the refreshed baseline tracks the new routing queue and current strained-but-non-regressing state

Follow-ups

• routing weights and thresholds are still fixed in code for this PR; moving them into config is deferred follow-up work
• scripts/refactor_audit.py is better segmented internally now, but a larger module split is also deferred follow-up work

Validation

• uv run pytest tests/test_refactor_audit.py -q
• uv run ruff check scripts/refactor_audit.py tests/test_refactor_audit.py
• uv run pyright scripts/refactor_audit.py tests/test_refactor_audit.py
• uv run python scripts/refactor_audit.py
• uv run python scripts/refactor_audit.py --update-baseline
• uv run python scripts/refactor_audit.py main.py --out-dir /tmp/recoleta-final-scope-check

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 623d4958b7

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".