Skip to content

Codebase intelligence for AI and humans: code health scores, auto-generated docs, git analytics, dead code detection, and architectural decisions via MCP.

fix(cli): warn when cascade budget truncates regeneration (#1720)

Jyotirmya Sharma248c5e27d98c
diff --git a/packages/cli/src/repowise/cli/commands/update_cmd/command.py b/packages/cli/src/repowise/cli/commands/update_cmd/command.py
index bdd86272f..2b88bf4fd 100644
--- a/packages/cli/src/repowise/cli/commands/update_cmd/command.py
+++ b/packages/cli/src/repowise/cli/commands/update_cmd/command.py
@@ -1223,7 +1223,8 @@ def run_update(
emitter.stage("plan_pages")
# Determine affected pages (auto-scale budget if not explicitly set)
- if cascade_budget is None:
+ cascade_budget_is_auto = cascade_budget is None
+ if cascade_budget_is_auto:
from repowise.core.ingestion.change_detector import compute_adaptive_budget
cascade_budget = compute_adaptive_budget(file_diffs, file_count)
@@ -1248,6 +1249,16 @@ def run_update(
affected.regenerate = list(dict.fromkeys([*affected.regenerate, *stale_renderer_paths]))
console.print(f"Pages from an older renderer: [cyan]{len(stale_renderer_paths)}[/cyan]")
+ if affected.stale_due_to_budget > 0:
+ console.print(
+ f"\n[yellow]⚠ Cascade budget of {cascade_budget} pages was reached. "
+ f"{affected.stale_due_to_budget} dependent pages were skipped and marked stale.[/yellow]"
+ )
+ console.print(
+ f"[yellow] Pass `--cascade-budget {cascade_budget + affected.stale_due_to_budget}` "
+ f"to regenerate them all.[/yellow]\n"
+ )
+
console.print(f"Pages to regenerate: [cyan]{len(affected.regenerate)}[/cyan]")
if affected.decay_only:
console.print(f"Pages to decay: [yellow]{len(affected.decay_only)}[/yellow]")
diff --git a/packages/core/src/repowise/core/ingestion/change_detector.py b/packages/core/src/repowise/core/ingestion/change_detector.py
index 81b051b49..2fb1ad65d 100644
--- a/packages/core/src/repowise/core/ingestion/change_detector.py
+++ b/packages/core/src/repowise/core/ingestion/change_detector.py
@@ -76,6 +76,7 @@ class AffectedPages:
regenerate: list[str] # page IDs to fully regenerate
rename_patch: list[str] # pages that only need a symbol rename text patch
decay_only: list[str] # pages to mark stale without immediate regeneration
+ stale_due_to_budget: int = 0 # pages skipped due to cascade budget cap
def compute_adaptive_budget(file_diffs: list[FileDiff], total_files: int) -> int:
@@ -464,12 +465,14 @@ class ChangeDetector:
decay_only = (
all_pages_needing_regen[cascade_budget:] + sorted(two_hop) + sorted(co_change_decay)
)
+ stale_due_to_budget = max(0, len(all_pages_needing_regen) - cascade_budget)
rename_patch = [p for p in rename_candidates if p in regenerate]
return AffectedPages(
regenerate=regenerate,
rename_patch=rename_patch,
decay_only=decay_only,
+ stale_due_to_budget=stale_due_to_budget,
)
# ------------------------------------------------------------------
diff --git a/tests/unit/ingestion/test_change_detector.py b/tests/unit/ingestion/test_change_detector.py
index 92673f4f1..56bb00454 100644
--- a/tests/unit/ingestion/test_change_detector.py
+++ b/tests/unit/ingestion/test_change_detector.py
@@ -236,6 +236,18 @@ class TestGetAffectedPages:
assert len(result.regenerate) <= 3
# Some go to decay_only
assert len(result.decay_only) > 0
+ # Check that skipped pages are counted in stale_due_to_budget
+ assert result.stale_due_to_budget > 0
+ assert result.stale_due_to_budget == 10 - len(result.regenerate)
+
+ def test_stale_due_to_budget_is_zero_when_under_budget(self, tmp_path: Path) -> None:
+ """When under cascade budget, stale_due_to_budget should be 0."""
+ d = self._detector(tmp_path)
+ g = nx.DiGraph()
+ g.add_node("file0.py")
+ diff = self._simple_file_diff("file0.py")
+ result = d.get_affected_pages([diff], graph=g, cascade_budget=50)
+ assert result.stale_due_to_budget == 0
def test_all_lists_are_disjoint(self, tmp_path: Path) -> None:
"""regenerate, rename_patch, and decay_only should be disjoint."""