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): name the same model step for the same index mode everywhere (#4309)

Raghav Chamadiyab7316385b27c
diff --git a/packages/cli/src/repowise/cli/commands/init_cmd/_generate.py b/packages/cli/src/repowise/cli/commands/init_cmd/_generate.py
index 51c48335a..48c73fb5f 100644
--- a/packages/cli/src/repowise/cli/commands/init_cmd/_generate.py
+++ b/packages/cli/src/repowise/cli/commands/init_cmd/_generate.py
@@ -13,6 +13,7 @@ from repowise.cli.helpers import console, load_config, warn
from repowise.cli.ui import BRAND, VALUE, print_stage
from repowise.cli.ui.mode_names import INDEX_ONLY, provider_model
from repowise.core.generation.styles import DEFAULT_STYLE
+from repowise.core.index_scope import FAST_TO_FULL_COMMAND, MODEL_COMMAND
from ._exit import COST_UNCONFIRMED_BUILT, COST_UNCONFIRMED_KEPT
from ._options import InitRun
@@ -401,7 +402,7 @@ def _after_cost_declined(run: InitRun) -> None:
run.cost_declined = True
console.print(
" [dim]Building documentation from code instead. Run "
- "[bold]repowise update --full[/bold] to write it with a "
+ f"[bold]{MODEL_COMMAND}[/bold] to write it with a "
"model later.[/dim]"
)
# Declining the bill keeps the configured embedder.
@@ -434,8 +435,6 @@ def _generate(run: InitRun) -> bool:
# Fast mode is a graph-and-git index only.
if opts.index_only and opts.run_mode == "fast":
- from repowise.core.index_scope import FAST_TO_FULL_COMMAND
-
console.print(
f" [dim]{INDEX_ONLY}: fast mode skips documentation. Run "
f"[bold]{FAST_TO_FULL_COMMAND}[/bold] to build it from code (no key "
diff --git a/packages/cli/src/repowise/cli/commands/init_cmd/_provider.py b/packages/cli/src/repowise/cli/commands/init_cmd/_provider.py
index 58f1c4097..f8f849fb7 100644
--- a/packages/cli/src/repowise/cli/commands/init_cmd/_provider.py
+++ b/packages/cli/src/repowise/cli/commands/init_cmd/_provider.py
@@ -14,6 +14,7 @@ from repowise.cli.ui import MODEL, OK, VALUE, WARN
from repowise.cli.ui.glyphs import glyph
from repowise.cli.ui.mascot import owl_status
from repowise.cli.ui.mode_names import BUILT_FROM_CODE, INDEX_ONLY, model_name, written_by
+from repowise.core.index_scope import MODEL_COMMAND
from ._options import InitRun
@@ -67,8 +68,8 @@ def _resolve_or_fall_back(run: InitRun) -> None:
console.print(
f"[{WARN}]No model configured.[/] Building documentation from "
"code instead (no key, no spend).\n"
- "[dim]Set a key (or pass --provider) and run [bold]repowise "
- "update --full[/bold] to have a model write it.[/dim]"
+ f"[dim]Set a key (or pass --provider) and run [bold]{MODEL_COMMAND}"
+ "[/bold] to have a model write it.[/dim]"
)
# A provider that was configured but could not be built is a different
# problem from none being configured, and the message above would send
diff --git a/packages/cli/src/repowise/cli/commands/init_cmd/workspace.py b/packages/cli/src/repowise/cli/commands/init_cmd/workspace.py
index e3aab31bc..4fb1edd1e 100644
--- a/packages/cli/src/repowise/cli/commands/init_cmd/workspace.py
+++ b/packages/cli/src/repowise/cli/commands/init_cmd/workspace.py
@@ -17,6 +17,8 @@ from datetime import UTC, datetime
from pathlib import Path
from typing import Any
+from rich.markup import escape
+
from repowise.cli._setup import setup_logging_silence
from repowise.cli.cost_gate import spend_phrase
from repowise.cli.editor_integrations.defaults import (
@@ -65,7 +67,7 @@ from repowise.cli.ui.mode_names import pages
from repowise.core.decision_lanes import record_decision_lanes
from repowise.core.docs_mode import docs_mode_state_fields
from repowise.core.generation.styles import DEFAULT_STYLE
-from repowise.core.index_scope import fast_to_full_command
+from repowise.core.index_scope import MODEL_COMMAND
from ._exit import COST_UNCONFIRMED_BUILT, exit_on_gaps
from ._ingest import structural_generation_config
@@ -521,7 +523,7 @@ def _generate_repo_with_model(
ctx.gaps.append(f"{repo.alias}: {COST_UNCONFIRMED_BUILT}")
console.print(
" [dim]Building this repo's documentation from code instead. Run "
- f"[bold]{fast_to_full_command(repo.alias)}[/bold] to write it with a model "
+ f"[bold]{MODEL_COMMAND} {escape(str(repo.path))}[/bold] to write it with a model "
"later.[/dim]"
)
_render_repo_from_templates(repo, ctx, index, docs)
diff --git a/packages/cli/src/repowise/cli/commands/status_cmd.py b/packages/cli/src/repowise/cli/commands/status_cmd.py
index 4840b308a..7f805e4b4 100644
--- a/packages/cli/src/repowise/cli/commands/status_cmd.py
+++ b/packages/cli/src/repowise/cli/commands/status_cmd.py
@@ -33,7 +33,12 @@ from repowise.cli.ui.mode_names import (
from repowise.cli.ui.result_panels import keyless_upgrade_note
from repowise.core.decision_lanes import lanes_label, pending_decision_lanes
from repowise.core.docs_mode import resolve_docs_mode
-from repowise.core.index_scope import fast_to_full_command, resolve_index_scope, upgrade_command
+from repowise.core.index_scope import (
+ fast_to_full_command,
+ model_command,
+ resolve_index_scope,
+ upgrade_command,
+)
# ---------------------------------------------------------------------------
# Workspace status
@@ -744,6 +749,7 @@ def status_command(path: str | None, workspace: bool, no_workspace: bool, fmt: s
"next_actions": _next_actions_summary(_load_actions(repo_path) if has_db else None),
"index_scope": scope,
"upgrade_command": upgrade_command(scope),
+ "model_command": model_command(scope),
"decision_lanes_pending": list(pending_lanes),
"rescore_pending": rescore,
}
@@ -813,7 +819,7 @@ def status_command(path: str | None, workspace: bool, no_workspace: bool, fmt: s
if pending_lanes:
state_table.add_row(
"Decisions",
- f"{lanes_label(pending_lanes)} not read yet (needs a model): repowise generate",
+ f"{lanes_label(pending_lanes)} not read yet (needs a model): {model_command(scope)}",
)
console.print(state_table)
diff --git a/packages/cli/src/repowise/cli/commands/update_cmd/reporting.py b/packages/cli/src/repowise/cli/commands/update_cmd/reporting.py
index bf1272c4b..4bbc821c4 100644
--- a/packages/cli/src/repowise/cli/commands/update_cmd/reporting.py
+++ b/packages/cli/src/repowise/cli/commands/update_cmd/reporting.py
@@ -27,6 +27,7 @@ from repowise.cli.ui.mode_names import (
provider_model,
)
from repowise.cli.ui.result_panels import serve_step
+from repowise.core.index_scope import MODEL_COMMAND
# Status -> display color, shared by the changed-file summary.
_STATUS_COLOR = {"added": "green", "deleted": "red", "modified": "yellow", "renamed": "blue"}
@@ -363,7 +364,7 @@ def show_index_only_completion(
# The scoped, cost-gated upgrade path — a coverage, a directory or one
# page at a time — not the all-or-nothing `update --full`.
next_steps.append(
- ("repowise generate", "write the documentation with a model (needs a key)")
+ (MODEL_COMMAND, "write the documentation with a model (needs a key)")
)
elif upgrade_command:
# Index only: there are no docs to regenerate.
diff --git a/packages/cli/src/repowise/cli/ui/result_panels.py b/packages/cli/src/repowise/cli/ui/result_panels.py
index b542ce105..8202e596f 100644
--- a/packages/cli/src/repowise/cli/ui/result_panels.py
+++ b/packages/cli/src/repowise/cli/ui/result_panels.py
@@ -157,9 +157,9 @@ def build_contextual_next_steps(
candidates: list[tuple[str, str]] = []
if setup is not None and getattr(setup, "editor_setup_disabled", False):
candidates.append(("repowise mcp .", "connect an MCP client (Cursor, Codex, Claude Code)"))
- if fast_mode:
- from repowise.core.index_scope import FAST_TO_FULL_COMMAND
+ from repowise.core.index_scope import FAST_TO_FULL_COMMAND, MODEL_COMMAND
+ if fast_mode:
candidates.append(
(FAST_TO_FULL_COMMAND, "build documentation from code and the full git history (no key)")
)
@@ -167,7 +167,7 @@ def build_contextual_next_steps(
# `generate` is the scoped, cost-gated upgrade: a coverage, a directory
# or one page at a time, each behind an estimate.
candidates.append(
- ("repowise generate", "write the documentation with a model (needs a key)")
+ (MODEL_COMMAND, "write the documentation with a model (needs a key)")
)
dead = dead_unreachable + dead_unused
if dead > 0:
@@ -200,8 +200,10 @@ def keyless_upgrade_note(semantic_available: bool, reindex_command: str | None =
the stamped scope use that exact command instead of the generic default,
so the note cannot name a flag combination the run did not actually need.
"""
+ from repowise.core.index_scope import MODEL_COMMAND
+
prose = (
- "repowise generate writes the subsystem pages with a model "
+ f"{MODEL_COMMAND} writes the subsystem pages with a model "
"(needs a key, or --provider ollama for a local model)"
)
if semantic_available:
diff --git a/packages/core/src/repowise/core/generation/editor_files/data.py b/packages/core/src/repowise/core/generation/editor_files/data.py
index 2b7d80666..1265117f1 100644
--- a/packages/core/src/repowise/core/generation/editor_files/data.py
+++ b/packages/core/src/repowise/core/generation/editor_files/data.py
@@ -150,6 +150,13 @@ class EditorFileData:
and search.get("semantic") == "unavailable"
)
+ @property
+ def model_command(self) -> str:
+ """The command that has a model write this index's documentation."""
+ from repowise.core.index_scope import model_command
+
+ return model_command(self.index_scope)
+
@property
def scope_gaps(self) -> list[str]:
"""What this index lacks, for the header; empty when nothing does."""
diff --git a/packages/core/src/repowise/core/generation/templates/_editor_block.j2 b/packages/core/src/repowise/core/generation/templates/_editor_block.j2
index 3f93a1ab2..f069e356b 100644
--- a/packages/core/src/repowise/core/generation/templates/_editor_block.j2
+++ b/packages/core/src/repowise/core/generation/templates/_editor_block.j2
@@ -65,7 +65,7 @@ Fix first:
- **Trust the index.** `verified: true` and `_meta.complete` mean the bytes were checked against the live tree, so never re-read them. Re-read only what `bounds: "approximate"` names. When `_meta.stale_warning` is set, Read the files that response served. After a batch of uncommitted edits, `repowise update --working-tree` refreshes the index. `confidence` rates the prose, not the evidence: on `low` read the top evidence row or the `candidate_files` the reply names, and run `repowise update` and ask again if `_meta.hint` says the index is behind HEAD. `index_behind: true` alone is informational.
{% if data.keyless %}
-- **No model on this index.** `get_answer` replies are low confidence by design, so open its top `best_guesses` / `candidate_files` rows; `search_codebase` is full-text only, so `[fts]` hits are normal. The user adds a model with a provider key and `{{ 'repowise update --full' if data.index_scope.get('content_provenance') == 'none' else 'repowise generate' }}`; suggest it, do not run it.
+- **No model on this index.** `get_answer` replies are low confidence by design, so open its top `best_guesses` / `candidate_files` rows; `search_codebase` is full-text only, so `[fts]` hits are normal. The user adds a model with a provider key and `{{ data.model_command }}`; suggest it, do not run it.
{% endif %}
- **A zero carries its basis.** An empty `callers`/`callees`/`used_by` comes with a `*_basis` saying how much of that language's calls the graph resolved, so read it before concluding nothing calls a symbol. On `get_answer`, `_meta.scope_hint` names the areas the answer did not touch.
- **Pre-edit, not instead-of-edit.** These tools decide *which* files to read and edit. {{ read_note }}
@@ -77,7 +77,7 @@ Fix first:
- **Pre-edit, not instead-of-edit.** These tools decide *which* files to read and edit. {{ read_note }} Bytes marked `verified: true` need no re-read; re-read only what `bounds: "approximate"` names. An empty `callers`/`used_by` comes with a `*_basis`: read it before concluding nothing calls a symbol.
{% if data.keyless %}
-- **No model on this index.** `get_answer` replies are low confidence by design, so open its top `best_guesses` / `candidate_files` rows; `search_codebase` is full-text only, so `[fts]` hits are normal. The user adds a model with a provider key and `{{ 'repowise update --full' if data.index_scope.get('content_provenance') == 'none' else 'repowise generate' }}`; suggest it, do not run it.
+- **No model on this index.** `get_answer` replies are low confidence by design, so open its top `best_guesses` / `candidate_files` rows; `search_codebase` is full-text only, so `[fts]` hits are normal. The user adds a model with a provider key and `{{ data.model_command }}`; suggest it, do not run it.
{% endif %}
- **Noisy commands** (tests, builds, `git log`/`diff`): prefer `repowise distill <cmd>`, same exit code, errors first. Recover a `[repowise#<ref>: N lines omitted]` marker with `repowise expand <ref>` (`-q <regex>` filters); never re-run the command.
- **Record a decision** you reasoned out: `repowise decision add --title T --decision D` (lands `proposed` for a person to confirm).
diff --git a/packages/core/src/repowise/core/index_scope.py b/packages/core/src/repowise/core/index_scope.py
index af88fbc80..c16018be5 100644
--- a/packages/core/src/repowise/core/index_scope.py
+++ b/packages/core/src/repowise/core/index_scope.py
@@ -29,12 +29,26 @@ def fast_to_full_command(repo_alias: str | None = None) -> str:
return f"repowise update --repo {repo_alias} --full" if repo_alias else FAST_TO_FULL_COMMAND
+#: The command that has a model write the documentation of an index that has
+#: pages. An Index only repo has none yet, so it takes FAST_TO_FULL_COMMAND.
+MODEL_COMMAND = "repowise generate"
+
+
def upgrade_command(scope: Mapping[str, Any] | None) -> str | None:
"""The fast-to-full command when *scope* is Index only (no documentation), else None."""
- if isinstance(scope, Mapping) and scope.get("content_provenance") == "none":
+ if not isinstance(scope, Mapping):
+ return None
+ provenance = scope.get("content_provenance")
+ # A fast run whose state predates the docs stamp is Index only too.
+ if provenance == "none" or (provenance == "unknown" and scope.get("run_mode") == "fast"):
return FAST_TO_FULL_COMMAND
return None
+
+def model_command(scope: Mapping[str, Any] | None) -> str:
+ """The command that has a model write *scope*'s documentation, for its mode."""
+ return upgrade_command(scope) or MODEL_COMMAND
+
# repo dir -> (identity of the files it was built from, scope). Every MCP
# response embeds this, so without a cache each one re-reads state.json and
# re-parses config.yaml. Keyed on mtime+size so an index rebuild invalidates it.
diff --git a/packages/core/src/repowise/core/pipeline/_run/analysis.py b/packages/core/src/repowise/core/pipeline/_run/analysis.py
index 72b7da3c8..54b04ccee 100644
--- a/packages/core/src/repowise/core/pipeline/_run/analysis.py
+++ b/packages/core/src/repowise/core/pipeline/_run/analysis.py
@@ -16,7 +16,7 @@ from repowise.core.pipeline.phases._common import (
_phase_done,
limit_to_top_pagerank,
)
-from repowise.core.pipeline.phases.analysis import STRUCTURAL_RUN_REASON
+from repowise.core.pipeline.phases.analysis import INDEX_ONLY_RUN_REASON, STRUCTURAL_RUN_REASON
from repowise.core.pipeline.progress import STAGE_ANALYSIS, emit_stage
from repowise.core.pipeline.resume import ResumePhase
@@ -75,7 +75,10 @@ async def _rehydrate_analysis(run: PipelineRun) -> bool:
def _no_model_reason(run: PipelineRun) -> str | None:
"""Why a deterministic run has no model, for its skipped decision sources."""
config = run.generation_config
- return STRUCTURAL_RUN_REASON if config is not None and config.deterministic else None
+ if config is None or not config.deterministic:
+ return None
+ # Only a fast run indexes git at the essential tier.
+ return INDEX_ONLY_RUN_REASON if run.git_tier == "essential" else STRUCTURAL_RUN_REASON
async def _backfill_decisions(run: PipelineRun) -> None:
diff --git a/packages/core/src/repowise/core/pipeline/phases/analysis.py b/packages/core/src/repowise/core/pipeline/phases/analysis.py
index 359a6377e..43035c3f9 100644
--- a/packages/core/src/repowise/core/pipeline/phases/analysis.py
+++ b/packages/core/src/repowise/core/pipeline/phases/analysis.py
@@ -20,13 +20,16 @@ from repowise.core.analysis.decisions.discovery import (
DiscoveryReport,
run_update_discovery,
)
+from repowise.core.index_scope import FAST_TO_FULL_COMMAND, MODEL_COMMAND
from repowise.core.pipeline.progress import ProgressCallback
from ._common import _phase_done
# Shown for the model-only decision sources of a deterministic run, which may
# well have a key configured.
-STRUCTURAL_RUN_REASON = "this run builds from code; repowise generate adds them"
+STRUCTURAL_RUN_REASON = f"this run builds from code; {MODEL_COMMAND} adds them"
+# The same for a fast run, which writes no pages for `generate` to work on.
+INDEX_ONLY_RUN_REASON = f"this run writes no documentation; {FAST_TO_FULL_COMMAND} adds them"
logger = structlog.get_logger(__name__)
diff --git a/tests/unit/cli/test_commands.py b/tests/unit/cli/test_commands.py
index 8ab9f80d3..2cabadc03 100644
--- a/tests/unit/cli/test_commands.py
+++ b/tests/unit/cli/test_commands.py
@@ -160,6 +160,10 @@ class TestErrorCases:
result = runner.invoke(cli, ["init", str(tmp_path)])
assert result.exit_code == 0, result.output
assert "No model configured" in result.output
+ # Built from code: `generate` is the model step, not the fast-to-full one.
+ out = " ".join(result.output.split())
+ assert "run repowise generate to have a model write it" in out
+ assert "update --full" not in out
def test_init_explicit_provider_still_errors(self, runner, tmp_path, monkeypatch):
"""A named --provider that cannot resolve is a real error, not a fallback.
diff --git a/tests/unit/cli/test_fast_mode_offer.py b/tests/unit/cli/test_fast_mode_offer.py
index 1551db052..498c03039 100644
--- a/tests/unit/cli/test_fast_mode_offer.py
+++ b/tests/unit/cli/test_fast_mode_offer.py
@@ -234,3 +234,19 @@ def test_keyless_upgrade_note_falls_back_without_a_next_command():
note = keyless_upgrade_note(semantic_available=False, reindex_command=None)
assert "repowise reindex adds semantic search" in note
assert "..." not in note
+
+
+def test_declining_the_cost_names_generate_for_the_pages_built_from_code(monkeypatch):
+ import io
+ from types import SimpleNamespace
+
+ from rich.console import Console
+
+ from repowise.cli.commands.init_cmd import _generate
+
+ buf = io.StringIO()
+ monkeypatch.setattr(_generate, "console", Console(file=buf, width=200))
+ monkeypatch.setattr(_generate, "_render_template_wiki", lambda *_a, **_k: None)
+ run = SimpleNamespace(prior_docs_mode=None, gaps=[], cost_declined=False)
+ _generate._after_cost_declined(run)
+ assert "Run repowise generate to write it with a model later." in buf.getvalue()
diff --git a/tests/unit/cli/test_generate_decision_lanes.py b/tests/unit/cli/test_generate_decision_lanes.py
index de8ae2396..13a299273 100644
--- a/tests/unit/cli/test_generate_decision_lanes.py
+++ b/tests/unit/cli/test_generate_decision_lanes.py
@@ -128,6 +128,16 @@ def test_status_names_pending_lanes_and_the_command_that_runs_them(monkeypatch,
assert "PRs, history and comments not read yet (needs a model): repowise generate" in out
+def test_status_names_the_fast_to_full_command_for_lanes_on_an_index_only_repo(
+ monkeypatch, tmp_path
+) -> None:
+ # `generate` refuses a repo with no documentation.
+ state = {PENDING_DECISION_LANES_KEY: list(LANES), "docs_mode": "none", "run_mode": "fast"}
+ out, _ = _status(monkeypatch, tmp_path, state)
+ assert "(needs a model): repowise update --full" in out
+ assert "repowise generate" not in out
+
+
def test_status_is_quiet_once_the_lanes_ran(monkeypatch, tmp_path) -> None:
out, _ = _status(monkeypatch, tmp_path, {"docs_mode": "llm"})
assert "not read yet" not in out
@@ -142,6 +152,16 @@ def test_status_json_carries_the_pending_lanes(monkeypatch, tmp_path) -> None:
assert json.loads(raw)["decision_lanes_pending"] == ["pr"]
+def test_status_json_names_generate_for_a_repo_built_from_code(monkeypatch, tmp_path) -> None:
+ import json
+
+ _, raw = _status(monkeypatch, tmp_path, {"docs_mode": "deterministic"}, "--format", "json")
+ payload = json.loads(raw)
+ # `upgrade_command` stays the Index only signal; the model step is named per mode.
+ assert payload["upgrade_command"] is None
+ assert payload["model_command"] == "repowise generate"
+
+
def test_keyless_init_records_the_lanes_a_model_init_does_not(tmp_path: Path) -> None:
from repowise.cli.commands.init_cmd._ingest import decision_llm_client
diff --git a/tests/unit/cli/test_update_full_keyless.py b/tests/unit/cli/test_update_full_keyless.py
index d9c8831fe..c0e51b8ed 100644
--- a/tests/unit/cli/test_update_full_keyless.py
+++ b/tests/unit/cli/test_update_full_keyless.py
@@ -241,7 +241,9 @@ def test_status_names_the_fast_to_full_command(tmp_path) -> None:
repo = _repo(tmp_path)
result = CliRunner().invoke(status_command, [str(repo), "--no-workspace", "--format", "json"])
assert result.exit_code == 0, result.output
- assert json.loads(result.output)["upgrade_command"] == "repowise update --full"
+ payload = json.loads(result.output)
+ assert payload["upgrade_command"] == "repowise update --full"
+ assert payload["model_command"] == "repowise update --full"
result = CliRunner().invoke(status_command, [str(repo), "--no-workspace"])
assert "Index only" in result.output
diff --git a/tests/unit/core/test_fast_to_full_command.py b/tests/unit/core/test_fast_to_full_command.py
index 312f0e240..f89f17435 100644
--- a/tests/unit/core/test_fast_to_full_command.py
+++ b/tests/unit/core/test_fast_to_full_command.py
@@ -4,8 +4,10 @@ from __future__ import annotations
from repowise.core.index_scope import (
FAST_TO_FULL_COMMAND,
+ MODEL_COMMAND,
compact_index_scope,
fast_to_full_command,
+ model_command,
resolve_index_scope,
upgrade_command,
)
@@ -32,3 +34,16 @@ def test_compact_scope_carries_the_command_only_when_index_only() -> None:
assert compact_index_scope(_scope("none"))["upgrade_command"] == FAST_TO_FULL_COMMAND
assert "upgrade_command" not in compact_index_scope(_scope("deterministic"))
assert "upgrade_command" not in compact_index_scope(_scope("llm"))
+
+
+def test_a_fast_run_without_a_docs_stamp_is_index_only() -> None:
+ # The same fallback the mode label applies, so the label and command agree.
+ assert upgrade_command(resolve_index_scope({"run_mode": "fast"})) == FAST_TO_FULL_COMMAND
+ assert upgrade_command(resolve_index_scope({"run_mode": "standard"})) is None
+
+
+def test_model_command_names_the_step_for_each_mode() -> None:
+ assert MODEL_COMMAND == "repowise generate"
+ assert model_command(_scope("none")) == FAST_TO_FULL_COMMAND
+ assert model_command(_scope("deterministic")) == MODEL_COMMAND
+ assert model_command(_scope("llm")) == MODEL_COMMAND
diff --git a/tests/unit/pipeline/test_decision_source_reporting.py b/tests/unit/pipeline/test_decision_source_reporting.py
index 0715fac13..4aab5b862 100644
--- a/tests/unit/pipeline/test_decision_source_reporting.py
+++ b/tests/unit/pipeline/test_decision_source_reporting.py
@@ -298,3 +298,18 @@ async def test_the_headline_separates_kept_decisions_from_candidates(_patched, m
"→ 5 architectural decisions kept from 16 candidates: "
"13 from git history, 3 from comments",
) in progress.messages
+
+
+def test_a_fast_run_points_skipped_sources_at_update_full() -> None:
+ from types import SimpleNamespace
+
+ from repowise.core.pipeline._run.analysis import _no_model_reason
+
+ def reason(tier: str, deterministic: bool = True) -> str | None:
+ config = SimpleNamespace(deterministic=deterministic)
+ return _no_model_reason(SimpleNamespace(generation_config=config, git_tier=tier))
+
+ # `generate` refuses a repo with no documentation, so a fast run names update --full.
+ assert reason("essential").endswith("repowise update --full adds them")
+ assert reason("full").endswith("repowise generate adds them")
+ assert reason("full", deterministic=False) is None