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
feat(cli): make init/update quiet by default, show debug logs under --verbose (#929)
Raghav Chamadiya3d727f942a23
diff --git a/packages/cli/src/repowise/cli/_setup.py b/packages/cli/src/repowise/cli/_setup.pyindex 835960c23..f7eb162ab 100644--- a/packages/cli/src/repowise/cli/_setup.py+++ b/packages/cli/src/repowise/cli/_setup.py@@ -3,32 +3,48 @@from __future__ import annotations-def setup_logging_silence() -> None:- """Quiet library + structlog output so progress bars are the only output.+def configure_cli_logging(*, verbose: bool = False) -> None:+ """Set library + structlog verbosity for a progress-bar command.- ``init`` / ``update`` render their own Rich progress bars; the underlying- library loggers (httpx/httpcore) and the ``repowise.core`` / ``repowise.server``- structlog loggers would otherwise interleave debug/info lines with the bars.+ ``init`` / ``update`` render their own Rich progress bars. By default the+ underlying library loggers (httpx/httpcore) and the ``repowise.core`` /+ ``repowise.server`` structlog loggers are quieted to ERROR so they don't+ interleave debug/info lines with the bars. ``verbose=True`` lets the+ repowise loggers through at DEBUG so a user can see provider/pipeline+ activity (``repowise update -v``); httpx/httpcore stay quiet either way,+ since their debug stream is HTTP-level noise that buries the useful lines.``cache_logger_on_first_use=False`` is load-bearing: modules that called``structlog.get_logger(__name__)`` at import time hold a bound logger- snapshotted before this ``configure`` runs — so without disabling the cache,- debug lines from ``core/ingestion/*`` (graph, traverser, parser, …) leak past- the ERROR filter on the first run of a session.+ snapshotted before this ``configure`` runs, so without disabling the cache,+ debug lines from ``core/ingestion/*`` (graph, traverser, parser, ...) leak+ past the filter on the first run of a session."""import logging+ level = logging.DEBUG if verbose else logging.ERROR+logging.getLogger("httpx").setLevel(logging.ERROR)logging.getLogger("httpcore").setLevel(logging.ERROR)for _logger_name in ("repowise.core", "repowise.server"):- logging.getLogger(_logger_name).setLevel(logging.ERROR)+ logging.getLogger(_logger_name).setLevel(level)try:import structlogstructlog.configure(- wrapper_class=structlog.make_filtering_bound_logger(logging.ERROR),+ wrapper_class=structlog.make_filtering_bound_logger(level),cache_logger_on_first_use=False,)except ImportError:pass+++def setup_logging_silence() -> None:+ """Quiet library + structlog output so progress bars are the only output.++ Thin wrapper over :func:`configure_cli_logging` for the quiet (default)+ path, kept for the call sites that never want logs regardless of a verbose+ flag (e.g. the multi-repo workspace flow).+ """+ configure_cli_logging(verbose=False)diff --git a/packages/cli/src/repowise/cli/commands/init_cmd/command.py b/packages/cli/src/repowise/cli/commands/init_cmd/command.pyindex c9751110c..4a6ffb3e5 100644--- a/packages/cli/src/repowise/cli/commands/init_cmd/command.py+++ b/packages/cli/src/repowise/cli/commands/init_cmd/command.py@@ -18,7 +18,7 @@ import clickfrom rich.progress import BarColumn, Progress, SpinnerColumn, TextColumn, TimeElapsedColumnfrom rich.table import Table-from repowise.cli._setup import setup_logging_silence+from repowise.cli._setup import configure_cli_loggingfrom repowise.cli.editor_integrations.defaults import (get_default_disabled_project_files,get_default_integration_overrides,@@ -500,7 +500,10 @@ def _run_generation_phase("-v",is_flag=True,default=False,- help="Show the full changed-file list and per-phase internals.",+ help=(+ "Show per-phase internals plus debug logs. Without it, debug/info "+ "logging is suppressed so the progress bar is the only output."+ ),)@click.option("--progress",@@ -678,8 +681,9 @@ def init_command(ensure_repowise_dir(repo_path)load_dotenv(repo_path)- # Suppress library/structlog output — progress bars are the only output needed.- setup_logging_silence()+ # Quiet library/structlog output so the progress bars are the only output;+ # `-v` lets repowise's debug lines through for troubleshooting.+ configure_cli_logging(verbose=verbose)# On --resume, continue the prior run's git tier so a resumed fast index# doesn't silently fall back to the expensive FULL tier (issue #341). Donediff --git a/packages/cli/src/repowise/cli/commands/update_cmd/command.py b/packages/cli/src/repowise/cli/commands/update_cmd/command.pyindex 04dd6270b..ac561d291 100644--- a/packages/cli/src/repowise/cli/commands/update_cmd/command.py+++ b/packages/cli/src/repowise/cli/commands/update_cmd/command.py@@ -16,6 +16,7 @@ from typing import Anyimport clickimport structlog+from repowise.cli._setup import configure_cli_loggingfrom repowise.cli.helpers import (clear_update_pending,clear_update_queued,@@ -263,7 +264,9 @@ def _surface_release_news(*, written_by: str | None) -> None:help=("Show the full changed-file list and per-phase internals (adaptive ""cascade budget, decision-marker/evolution counts, best-effort skip "- "warnings, and the detailed generation report)."+ "warnings, and the detailed generation report), plus debug logs. "+ "Without it, debug/info logging is suppressed so the progress bar is "+ "the only output."),)@click.option(@@ -377,6 +380,11 @@ def run_update(click.get_current_context().call_on_close(lambda: setattr(console, "file", None))emitter = JsonProgressEmitter()emitter.start(repo=str(path or "."), since=since)+ else:+ # Human console mode: quiet library/structlog output so it doesn't+ # interleave with the live progress bar (issue #922); `-v` lets+ # repowise's debug lines through for troubleshooting.+ configure_cli_logging(verbose=verbose)# --- Resolve target up front (single repo or workspace) ---target = resolve_command_target(diff --git a/tests/unit/cli/test_shared_helpers.py b/tests/unit/cli/test_shared_helpers.pyindex e6f716609..dfad2be55 100644--- a/tests/unit/cli/test_shared_helpers.py+++ b/tests/unit/cli/test_shared_helpers.py@@ -161,5 +161,38 @@ def test_setup_logging_silence_runs() -> None:assert logging.getLogger("httpcore").level == logging.ERROR+def test_configure_cli_logging_quiet_by_default() -> None:+ import logging++ prior = {n: logging.getLogger(n).level for n in ("repowise.core", "repowise.server")}+ try:+ _setup.configure_cli_logging(verbose=False)+ assert logging.getLogger("repowise.core").level == logging.ERROR+ assert logging.getLogger("repowise.server").level == logging.ERROR+ # HTTP libs stay quiet regardless of verbosity.+ assert logging.getLogger("httpx").level == logging.ERROR+ finally:+ for name, level in prior.items():+ logging.getLogger(name).setLevel(level)+++def test_configure_cli_logging_verbose_shows_repowise_debug() -> None:+ import logging++ prior = {n: logging.getLogger(n).level for n in ("repowise.core", "repowise.server")}+ try:+ _setup.configure_cli_logging(verbose=True)+ assert logging.getLogger("repowise.core").level == logging.DEBUG+ assert logging.getLogger("repowise.server").level == logging.DEBUG+ # HTTP libs are HTTP-level noise; kept at ERROR even in verbose mode.+ assert logging.getLogger("httpx").level == logging.ERROR+ assert logging.getLogger("httpcore").level == logging.ERROR+ finally:+ for name, level in prior.items():+ logging.getLogger(name).setLevel(level)+ # Restore the quiet default so verbose state doesn't leak to other tests.+ _setup.configure_cli_logging(verbose=False)++def test_repo_session_exposes_open_repo_db() -> None:assert callable(_repo_session.open_repo_db)