Codebase intelligence for AI and humans: code health scores, auto-generated docs, git analytics, dead code detection, and architectural decisions via MCP.
Python aicode-complexitycode-healthcode-intelligencecode-qualitydead-codedeveloper-toolsdocumentationgit-analyticsmcpopen-sourcepythonrefactoringstatic-analysistechnical-debt
"""Workspace CLAUDE.md contract-table curation.
Raw contract links include intra-repo rows and one row per provider file for
the same (contract, consumer); in a real workspace that rendered 30+
near-duplicate rows before the first genuinely cross-repo contract.
"""
from __future__ import annotations
from repowise.cli.commands.claude_md_cmd import _MAX_CONTRACT_LINKS, _curate_contract_links
def _link(
provider_repo,
consumer_repo,
contract_id,
provider_file="src/models.py",
consumer_file="src/client.ts",
confidence=None,
):
return {
"provider_repo": provider_repo,
"consumer_repo": consumer_repo,
"provider_file": provider_file,
"consumer_file": consumer_file,
"contract_id": contract_id,
"contract_type": "data",
**({"confidence": confidence} if confidence is not None else {}),
}
def test_intra_repo_links_are_dropped():
links = [
_link("api", "api", "data::repositories"),
_link("api", "web", "http::GET::/repos"),
]
out = _curate_contract_links(links)
assert len(out) == 1
assert out[0]["consumer_repo"] == "web"
def test_duplicate_providers_collapse_preferring_non_migration():
links = [
_link("api", "web", "data::users", provider_file="alembic/versions/0001_init.py"),
_link("api", "web", "data::users", provider_file="src/models.py"),
]
out = _curate_contract_links(links)
assert len(out) == 1
assert out[0]["provider_file"] == "src/models.py"
def test_distinct_consumers_survive():
links = [
_link("api", "web", "data::users", consumer_file="a.ts"),
_link("api", "web", "data::users", consumer_file="b.ts"),
]
assert len(_curate_contract_links(links)) == 2
def test_capped():
links = [_link("api", "web", f"http::GET::/x{i}") for i in range(40)]
assert len(_curate_contract_links(links)) == _MAX_CONTRACT_LINKS
def test_cap_prefers_higher_confidence_links():
"""Issue #1588: when more links than the cap exist, the ones that make the
file must be the highest-confidence ones, not the first ones scanned."""
weak = _link("api", "web", "http::GET::/weak", confidence=0.5)
strong = [
_link("api", "web", f"http::GET::/strong{i}", confidence=0.9)
for i in range(_MAX_CONTRACT_LINKS)
]
# Weak link scanned FIRST; without the sort it would survive the cap.
out = _curate_contract_links([weak, *strong])
assert len(out) == _MAX_CONTRACT_LINKS
assert all("strong" in item["contract_id"] for item in out)
def test_links_without_confidence_rank_last_but_stable():
"""Links that predate the confidence field keep a stable order between
runs (tiebreak on stable fields), and never outrank a confident one."""
bare = [_link("api", "web", f"http::GET::/bare{i}") for i in range(_MAX_CONTRACT_LINKS)]
confident = _link("api", "web", "http::GET::/confident", confidence=0.8)
out = _curate_contract_links([*bare, confident])
assert out[0]["contract_id"] == "http::GET::/confident"
# Stable across calls: same input, same order.
assert [item["contract_id"] for item in out] == [
item["contract_id"] for item in _curate_contract_links([*bare, confident])
]
def test_malformed_entries_ignored():
assert _curate_contract_links(["nope", None]) == []