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
"""The one line `repowise update --workspace` prints when contracts broke."""
from __future__ import annotations
from datetime import UTC, datetime, timedelta
from pathlib import Path
import pytest
from repowise.cli.commands.update_cmd.workspace import _print_breaking_changes
from repowise.core.workspace.breaking_change import (
BreakingChange,
BreakingChangeReport,
ImpactedConsumer,
save_breaking_change_report,
)
STAMP = datetime(2026, 8, 23, 12, 0, tzinfo=UTC)
def _save(
root: Path,
*,
generated_at: str | None,
severity: str = "breaking",
consumer_repo: str = "frontend",
) -> None:
save_breaking_change_report(
BreakingChangeReport(
generated_at=generated_at,
changes=[
BreakingChange(
kind="removed_endpoint",
severity=severity,
contract_id="code::@acme/types::Order",
contract_type="code",
provider_repo="api",
provider_file="src/types.ts",
provider_symbol="Order",
provider_service=None,
detail="code::@acme/types::Order was removed",
impacted_consumers=[
ImpactedConsumer(
repo=consumer_repo,
service=None,
node_id=consumer_repo,
file="src/api.ts",
symbol="@acme/types:Order",
match_type="exact",
confidence=0.9,
)
],
)
],
),
root,
)
def _save_many(root: Path, count: int) -> None:
"""`count` breaking changes, each crossing a repo boundary."""
save_breaking_change_report(
BreakingChangeReport(
generated_at=(STAMP + timedelta(seconds=5)).isoformat(),
changes=[
BreakingChange(
kind="removed_endpoint",
severity="breaking",
contract_id=f"http::GET::/thing/{i}",
contract_type="http",
provider_repo="api",
provider_file="src/routes.ts",
provider_symbol="handler",
provider_service=None,
detail=f"http::GET::/thing/{i} was removed",
impacted_consumers=[
ImpactedConsumer(
repo="frontend",
service=None,
node_id="frontend",
file="src/api.ts",
symbol="getThing",
match_type="exact",
confidence=0.9,
)
],
)
for i in range(count)
],
),
root,
)
def test_names_the_first_few_changes_under_the_count(
tmp_path: Path, capsys: pytest.CaptureFixture[str]
):
_save_many(tmp_path, 5)
_print_breaking_changes(tmp_path, STAMP)
out = capsys.readouterr().out
assert "5 breaking contract change(s)" in out
for i in range(3):
assert f"http::GET::/thing/{i}" in out
assert "http::GET::/thing/3" not in out
assert "api -> frontend" in out
assert "and 2 more" in out
def test_no_overflow_line_when_every_change_is_named(
tmp_path: Path, capsys: pytest.CaptureFixture[str]
):
_save_many(tmp_path, 2)
_print_breaking_changes(tmp_path, STAMP)
out = capsys.readouterr().out
assert "http::GET::/thing/1" in out
assert "more" not in out
def test_reports_a_report_this_update_wrote(tmp_path: Path, capsys: pytest.CaptureFixture[str]):
_save(tmp_path, generated_at=(STAMP + timedelta(seconds=5)).isoformat())
_print_breaking_changes(tmp_path, STAMP)
out = capsys.readouterr().out
assert "1 breaking contract change(s)" in out
assert "frontend" in out
assert "workspace check" in out
def test_silent_on_a_report_from_a_previous_update(
tmp_path: Path, capsys: pytest.CaptureFixture[str]
):
"""A stale artifact belongs to an earlier run and must not be attributed here."""
_save(tmp_path, generated_at=(STAMP - timedelta(hours=1)).isoformat())
_print_breaking_changes(tmp_path, STAMP)
assert capsys.readouterr().out == ""
def test_silent_when_detection_never_ran(tmp_path: Path, capsys: pytest.CaptureFixture[str]):
_save(tmp_path, generated_at=None)
_print_breaking_changes(tmp_path, STAMP)
assert capsys.readouterr().out == ""
def test_silent_without_a_report(tmp_path: Path, capsys: pytest.CaptureFixture[str]):
_print_breaking_changes(tmp_path, STAMP)
assert capsys.readouterr().out == ""
def test_a_warning_is_not_announced_as_a_break(tmp_path: Path, capsys: pytest.CaptureFixture[str]):
"""`workspace check` would pass on this, so the line must not alarm."""
_save(tmp_path, generated_at=(STAMP + timedelta(seconds=5)).isoformat(), severity="warning")
_print_breaking_changes(tmp_path, STAMP)
out = capsys.readouterr().out
assert "none breaks another repo" in out
assert "breaking contract change" not in out
def test_an_internal_only_break_is_not_announced(tmp_path: Path, capsys: pytest.CaptureFixture[str]):
"""Same filter `workspace check` gates on, so the two never contradict."""
_save(tmp_path, generated_at=(STAMP + timedelta(seconds=5)).isoformat(), consumer_repo="api")
_print_breaking_changes(tmp_path, STAMP)
assert "none breaks another repo" in capsys.readouterr().out