style: trim redundant comments and docstrings

Audit pass against the repo's "comments only when the WHY is
non-obvious" standard. Deleted three test docstrings that restated
the function name. Shortened five over-explanatory comments to one
line each. Kept the assertion-failure diagnostics that genuinely help
the next maintainer (sushi config drift messages; the kwarg-presence
assertion message documenting why we don't only check the value).

Net: -38 lines / +6 lines across the touched files. No behaviour
change.

Coding-Agent: pi
Model: anthropic/claude-opus-4-7
Signed-off-by: Joe Hartshorn <8881940+j-hartshorn@users.noreply.github.com>

Author: j-hartshorn

sqlmesh/cli/main.py

@@ -116,8 +116,7 @@ def cli(
     configure_console(ignore_warnings=ignore_warnings)
 
     load = True
-    # Computed outside the single-path block: local-only behaviour must apply
-    # regardless of how many --paths were provided, unlike SKIP_LOAD_COMMANDS.
+    # Outside the single-path block: applies regardless of --paths count.
     load_state = ctx.invoked_subcommand not in LOCAL_ONLY_COMMANDS
 
     if len(paths) == 1:

sqlmesh/core/context.py

@@ -363,7 +363,7 @@ class GenericContext(BaseContext, t.Generic[C]):
             connection as it appears in configuration will be used.
         concurrent_tasks: The maximum number of tasks that can use the connection concurrently.
         load: Whether or not to automatically load all models and macros (default True).
-        load_state: Whether to merge remote state into the local project during load (default True). Consulted by load(); has no effect when load() is not called.
+        load_state: Whether to merge remote state into the local project during load (default True).
         console: The rich instance used for printing out CLI command results.
         users: A list of users to make known to SQLMesh.
     """

tests/cli/test_cli.py

@@ -2240,7 +2240,6 @@ def test_format_leading_comma_default(runner: CliRunner, tmp_path: Path):
 
 
 def _setup_local_only_project(tmp_path, mocker):
-    """Scaffold a project with a non-empty `project` name and patch state to raise."""
     create_example_project(tmp_path, template=ProjectTemplate.EMPTY)
     config_path = tmp_path / "config.yaml"
     existing = config_path.read_text(encoding="utf-8")
@@ -2272,22 +2271,7 @@ def test_lint_runs_without_state(runner: CliRunner, tmp_path: Path, mocker):
 
 
 def test_plan_still_loads_state(runner: CliRunner, tmp_path: Path, mocker):
-    """Guard-rail: confirm `plan` is not in LOCAL_ONLY_COMMANDS.
-
-    Asserts two complementary things, because either alone has a blind spot:
-      1. The CLI explicitly passes `load_state=True` to `Context(...)` for `plan`.
-         Checking `"load_state" in call.kwargs` (not just the value) catches a
-         regression where someone deletes the `load_state=load_state` line in
-         cli/main.py entirely — the kwarg would be absent and silently default
-         to True without this check.
-      2. State sync was actually accessed. Catches a regression where someone
-         adds `"plan"` to LOCAL_ONLY_COMMANDS — `load_state` would be False and
-         the patched method would never be called.
-
-    The `plan` invocation is expected to fail because state access is patched
-    to raise. We don't assert on exit_code; mocker.spy records the constructor
-    call before the wrapped __init__ runs, so kwargs are recorded regardless.
-    """
+    """Guard that `plan` explicitly passes `load_state=True` and still reaches state sync."""
     mock = _setup_local_only_project(tmp_path, mocker)
     init_spy = mocker.spy(Context, "__init__")
 
@@ -2307,18 +2291,7 @@ def test_plan_still_loads_state(runner: CliRunner, tmp_path: Path, mocker):
 def test_format_does_not_open_state_connection(
     runner: CliRunner, tmp_path: Path, mocker, monkeypatch
 ):
-    """Realistic CI scenario: a config.yaml declaring a remote Postgres state
-    connection with credentials sourced from unset env vars. Format must still
-    succeed without opening the state connection.
-
-    Distinct from test_format_runs_without_state: that one proves the gate by
-    patching get_versions on a default-DuckDB project. This one proves the
-    end-to-end CI use case where the config declares a real remote backend and
-    no secrets are provisioned. Jinja `env_var('FOO')` with `FOO` unset
-    renders the string `"None"` into the YAML; Pydantic accepts that for
-    Postgres's `user`/`password` (both typed `str`), so config validation
-    passes with placeholder values. The gate then prevents any connection.
-    """
+    """Format must not open a configured remote Postgres state connection when CI secrets are unset."""
     pytest.importorskip("psycopg2")
 
     for var in ("PG_HOST", "PG_USER", "PG_PASSWORD", "PG_DATABASE"):

tests/core/linter/test_builtin.py

@@ -235,15 +235,13 @@ def test_no_missing_unit_tests(tmp_path, copy_to_temp_path):
 
 
 def test_lint_without_state_load(tmp_path, copy_to_temp_path, mocker) -> None:
-    """`lint_models` with `load_state=False` runs built-in rules without touching state sync."""
     sushi_paths = copy_to_temp_path("examples/sushi")
     sushi_path = sushi_paths[0]
 
     with open(sushi_path / "config.py", "r") as f:
         read_file = f.read()
 
-    # Set a non-empty project name so `any(self._projects)` is truthy and the
-    # state-merge guard in `Context.load()` actually exercises `self._load_state`.
+    # Set a project name so state-merge code reaches the `self._load_state` guard.
     project_anchor = "config = Config(\n    gateways="
     assert project_anchor in read_file, (
         "sushi config.py shape drifted; update project_anchor in test"
@@ -253,8 +251,7 @@ def test_lint_without_state_load(tmp_path, copy_to_temp_path, mocker) -> None:
         'config = Config(\n    project="sushi",\n    gateways=',
     )
 
-    # Enable the linter with one built-in rule so `lint_models` actually executes
-    # a rule under `load_state=False`, not just the empty-rule-set path.
+    # Enable one built-in rule so `lint_models` doesn't take the empty-rule-set path.
     before = """    linter=LinterConfig(
         enabled=False,
         rules=[

tests/core/test_format.py

@@ -147,7 +147,6 @@ def test_ignore_formating_files(tmp_path: pathlib.Path):
 
 
 def test_format_without_state_load(tmp_path: pathlib.Path, mocker: MockerFixture):
-    """`format` with `load_state=False` runs end-to-end without touching state sync."""
     mock = mocker.patch(
         "sqlmesh.core.state_sync.db.facade.EngineAdapterStateSync.get_versions",
         side_effect=RuntimeError("state should not be accessed"),