svc-infra 0.1.706__py3-none-any.whl → 1.1.0__py3-none-any.whl

svc_infra/cache/utils.py

@@ -8,7 +8,8 @@ hashing complex objects, and formatting key templates.
 import hashlib
 import json
 import logging
-from typing import Any, Iterable, Union
+from collections.abc import Iterable
+from typing import Any
 
 logger = logging.getLogger(__name__)
 
@@ -33,9 +34,7 @@ def stable_hash(*args: Any, **kwargs: Any) -> str:
     """
     try:
         # Use JSON serialization for stable, deterministic output
-        raw = json.dumps(
-            [args, kwargs], default=str, sort_keys=True, separators=(",", ":")
-        )
+        raw = json.dumps([args, kwargs], default=str, sort_keys=True, separators=(",", ":"))
     except (TypeError, ValueError) as e:
         # Fallback to repr if JSON serialization fails
         logger.warning(f"JSON serialization failed for hash input, using repr: {e}")
@@ -44,7 +43,7 @@ def stable_hash(*args: Any, **kwargs: Any) -> str:
     return hashlib.sha1(raw.encode("utf-8")).hexdigest()
 
 
-def join_key(parts: Iterable[Union[str, int, None]]) -> str:
+def join_key(parts: Iterable[str | int | None]) -> str:
     """
     Join key parts into a cache key, filtering out empty values.
 
@@ -100,7 +99,7 @@ def format_tuple_key(key_tuple: tuple[str, ...], **kwargs) -> str:
         raise ValueError(f"Failed to format key template: {e}") from e
 
 
-def normalize_cache_key(key: Union[str, tuple[str, ...]], **kwargs) -> str:
+def normalize_cache_key(key: str | tuple[str, ...], **kwargs) -> str:
     """
     Normalize a cache key from various input formats.
 

svc_infra/cli/__init__.py

@@ -23,9 +23,7 @@ app = typer.Typer(no_args_is_help=True, add_completion=False, help=_HELP)
 pre_cli(app)
 
 # --- db ops group ---
-db_app = typer.Typer(
-    no_args_is_help=True, add_completion=False, help="Database operations"
-)
+db_app = typer.Typer(no_args_is_help=True, add_completion=False, help="Database operations")
 register_db_ops(db_app)
 app.add_typer(db_app, name="db")
 
@@ -37,24 +35,18 @@ register_sql_export(sql_app)
 app.add_typer(sql_app, name="sql")
 
 # --- mongo group ---
-mongo_app = typer.Typer(
-    no_args_is_help=True, add_completion=False, help="MongoDB commands"
-)
+mongo_app = typer.Typer(no_args_is_help=True, add_completion=False, help="MongoDB commands")
 register_mongo(mongo_app)
 register_mongo_scaffold(mongo_app)
 app.add_typer(mongo_app, name="mongo")
 
 # --- health group ---
-health_app = typer.Typer(
-    no_args_is_help=True, add_completion=False, help="Health checks"
-)
+health_app = typer.Typer(no_args_is_help=True, add_completion=False, help="Health checks")
 register_health(health_app)
 app.add_typer(health_app, name="health")
 
 # -- obs group ---
-obs_app = typer.Typer(
-    no_args_is_help=True, add_completion=False, help="Observability commands"
-)
+obs_app = typer.Typer(no_args_is_help=True, add_completion=False, help="Observability commands")
 register_obs(obs_app)
 app.add_typer(obs_app, name="obs")
 

svc_infra/cli/cmds/db/nosql/mongo/mongo_cmds.py

@@ -2,7 +2,8 @@ from __future__ import annotations
 
 import importlib
 import os
-from typing import Any, Optional, Sequence
+from collections.abc import Sequence
+from typing import Any
 
 import typer
 
@@ -17,7 +18,7 @@ from svc_infra.db.nosql.utils import prepare_process_env
 # -------------------- helpers --------------------
 
 
-def _apply_mongo_env(mongo_url: Optional[str], mongo_db: Optional[str]) -> None:
+def _apply_mongo_env(mongo_url: str | None, mongo_db: str | None) -> None:
     """If provided, set MONGO_URL / MONGO_DB for the current process."""
     if mongo_url:
         os.environ["MONGO_URL"] = mongo_url
@@ -63,13 +64,13 @@ def cmd_prepare(
         "--resources",
         help="Dotted path to NoSqlResource(s). e.g. 'app.db.mongo:RESOURCES'",
     ),
-    mongo_url: Optional[str] = typer.Option(
+    mongo_url: str | None = typer.Option(
         None, "--mongo-url", help="Overrides env MONGO_URL for this command."
     ),
-    mongo_db: Optional[str] = typer.Option(
+    mongo_db: str | None = typer.Option(
         None, "--mongo-db", help="Overrides env MONGO_DB for this command."
     ),
-    service_id: Optional[str] = typer.Option(
+    service_id: str | None = typer.Option(
         None,
         "--service-id",
         help="Stable ID for this service/app. Defaults to top-level module name.",
@@ -125,13 +126,13 @@ def cmd_setup_and_prepare(
         "--resources",
         help="Dotted path to NoSqlResource(s). e.g. 'app.db.mongo:RESOURCES'",
     ),
-    mongo_url: Optional[str] = typer.Option(
+    mongo_url: str | None = typer.Option(
         None, "--mongo-url", help="Overrides env MONGO_URL for this command."
     ),
-    mongo_db: Optional[str] = typer.Option(
+    mongo_db: str | None = typer.Option(
         None, "--mongo-db", help="Overrides env MONGO_DB for this command."
     ),
-    service_id: Optional[str] = typer.Option(
+    service_id: str | None = typer.Option(
         None,
         "--service-id",
         help="Stable ID for this service/app. Defaults to top-level module name.",
@@ -157,10 +158,10 @@ def cmd_setup_and_prepare(
 
 
 def cmd_ping(
-    mongo_url: Optional[str] = typer.Option(
+    mongo_url: str | None = typer.Option(
         None, "--mongo-url", help="Overrides env MONGO_URL for this command."
     ),
-    mongo_db: Optional[str] = typer.Option(
+    mongo_db: str | None = typer.Option(
         None, "--mongo-db", help="Overrides env MONGO_DB for this command."
     ),
 ):

svc_infra/cli/cmds/db/nosql/mongo/mongo_scaffold_cmds.py

@@ -1,7 +1,6 @@
 from __future__ import annotations
 
 from pathlib import Path
-from typing import Optional
 
 import typer
 
@@ -17,9 +16,7 @@ def cmd_scaffold(
     entity_name: str = typer.Option(
         "Item", help="Entity class name (e.g., User, Member, Product)."
     ),
-    documents_dir: Path = typer.Option(
-        ..., help="Directory for Mongo document models."
-    ),
+    documents_dir: Path = typer.Option(..., help="Directory for Mongo document models."),
     schemas_dir: Path = typer.Option(..., help="Directory for Pydantic CRUD schemas."),
     overwrite: bool = typer.Option(False, help="Overwrite existing files."),
     same_dir: bool = typer.Option(
@@ -27,10 +24,10 @@ def cmd_scaffold(
         "--same-dir/--no-same-dir",
         help="Put documents & schemas into the same directory.",
     ),
-    documents_filename: Optional[str] = typer.Option(
+    documents_filename: str | None = typer.Option(
         None, help="Custom filename for documents (separate-dir mode)."
     ),
-    schemas_filename: Optional[str] = typer.Option(
+    schemas_filename: str | None = typer.Option(
         None, help="Custom filename for schemas (separate-dir mode)."
     ),
 ):
@@ -55,7 +52,7 @@ def cmd_scaffold_documents(
     dest_dir: Path = typer.Option(..., "--dest-dir", resolve_path=True),
     entity_name: str = typer.Option("Item", "--entity-name"),
     overwrite: bool = typer.Option(False, "--overwrite/--no-overwrite"),
-    documents_filename: Optional[str] = typer.Option(
+    documents_filename: str | None = typer.Option(
         None,
         "--documents-filename",
         help="Filename to write (e.g. product_doc.py). Defaults to <snake(entity)>.py",
@@ -75,7 +72,7 @@ def cmd_scaffold_schemas(
     dest_dir: Path = typer.Option(..., "--dest-dir", resolve_path=True),
     entity_name: str = typer.Option("Item", "--entity-name"),
     overwrite: bool = typer.Option(False, "--overwrite/--no-overwrite"),
-    schemas_filename: Optional[str] = typer.Option(
+    schemas_filename: str | None = typer.Option(
         None,
         "--schemas-filename",
         help="Filename to write (e.g. product_schemas.py). Defaults to <snake(entity)>.py",
@@ -98,7 +95,7 @@ def cmd_scaffold_resources(
         "--entity-name",
         help="Used only to prefill example placeholders.",
     ),
-    filename: Optional[str] = typer.Option(
+    filename: str | None = typer.Option(
         None,
         "--filename",
         help='Output filename (default: "resources.py")',

svc_infra/cli/cmds/db/ops_cmds.py

@@ -10,13 +10,12 @@ from __future__ import annotations
 import asyncio
 import os
 import time
-from typing import Optional
 
 import typer
 
 
 def cmd_wait(
-    database_url: Optional[str] = typer.Option(
+    database_url: str | None = typer.Option(
         None,
         "--url",
         "-u",
@@ -106,7 +105,7 @@ def cmd_kill_queries(
         ...,
         help="Table name to find blocking queries for.",
     ),
-    database_url: Optional[str] = typer.Option(
+    database_url: str | None = typer.Option(
         None,
         "--url",
         "-u",
@@ -244,9 +243,7 @@ def cmd_kill_queries(
                             typer.secho(f"  {action} PID {pid}", fg=typer.colors.GREEN)
                     else:
                         if not quiet:
-                            typer.echo(
-                                f"  PID {pid}: already finished or permission denied"
-                            )
+                            typer.echo(f"  PID {pid}: already finished or permission denied")
                 except Exception as e:
                     if not quiet:
                         typer.secho(f"  PID {pid}: Error - {e}", fg=typer.colors.YELLOW)

svc_infra/cli/cmds/db/sql/alembic_cmds.py

@@ -3,7 +3,6 @@ from __future__ import annotations
 import json
 import os
 from importlib import import_module
-from typing import List, Optional
 
 import typer
 
@@ -19,13 +18,13 @@ from svc_infra.db.sql.core import stamp as core_stamp
 from svc_infra.db.sql.core import upgrade as core_upgrade
 
 
-def apply_database_url(database_url: Optional[str]) -> None:
+def apply_database_url(database_url: str | None) -> None:
     """If provided, set SQL_URL for the current process."""
     if database_url:
         os.environ["SQL_URL"] = database_url
 
 
-def _find_pkgs(with_payments, discover_packages) -> List[str]:
+def _find_pkgs(with_payments, discover_packages) -> list[str]:
     from os import getenv
 
     payments_enabled = (
@@ -43,12 +42,12 @@ def _find_pkgs(with_payments, discover_packages) -> List[str]:
 
 
 def cmd_init(
-    database_url: Optional[str] = typer.Option(
+    database_url: str | None = typer.Option(
         None,
         help="Database URL; overrides env SQL_URL for this command. "
         "Async vs sync is auto-detected from the URL.",
     ),
-    discover_packages: Optional[List[str]] = typer.Option(
+    discover_packages: list[str] | None = typer.Option(
         None,
         help="Packages to search for SQLAlchemy metadata; may pass multiple. "
         "If omitted, automatic discovery is used.",
@@ -74,19 +73,13 @@ def cmd_init(
 
 def cmd_revision(
     message: str = typer.Option(..., "-m", "--message", help="Revision message."),
-    database_url: Optional[str] = typer.Option(
+    database_url: str | None = typer.Option(
         None, help="Database URL; overrides env for this command."
     ),
-    autogenerate: bool = typer.Option(
-        False, help="Autogenerate migrations by comparing metadata."
-    ),
-    head: Optional[str] = typer.Option(
-        "head", help="Set the head to base this revision on."
-    ),
-    branch_label: Optional[str] = typer.Option(None, help="Branch label."),
-    version_path: Optional[str] = typer.Option(
-        None, help="Alternative versions/ path."
-    ),
+    autogenerate: bool = typer.Option(False, help="Autogenerate migrations by comparing metadata."),
+    head: str | None = typer.Option("head", help="Set the head to base this revision on."),
+    branch_label: str | None = typer.Option(None, help="Branch label."),
+    version_path: str | None = typer.Option(None, help="Alternative versions/ path."),
     sql: bool = typer.Option(False, help="Don't generate Python; dump SQL to stdout."),
 ):
     """Create a new Alembic revision, either empty or autogenerated."""
@@ -102,10 +95,8 @@ def cmd_revision(
 
 
 def cmd_upgrade(
-    revision_target: str = typer.Argument(
-        "head", help="Target revision (default head)."
-    ),
-    database_url: Optional[str] = typer.Option(
+    revision_target: str = typer.Argument("head", help="Target revision (default head)."),
+    database_url: str | None = typer.Option(
         None, help="Database URL; overrides env for this command."
     ),
 ):
@@ -116,7 +107,7 @@ def cmd_upgrade(
 
 def cmd_downgrade(
     revision_target: str = typer.Argument("-1", help="Target revision (default -1)."),
-    database_url: Optional[str] = typer.Option(
+    database_url: str | None = typer.Option(
         None, help="Database URL; overrides env for this command."
     ),
 ):
@@ -126,7 +117,7 @@ def cmd_downgrade(
 
 
 def cmd_current(
-    database_url: Optional[str] = typer.Option(
+    database_url: str | None = typer.Option(
         None, help="Database URL; overrides env for this command."
     ),
     verbose: bool = typer.Option(False, help="Verbose output."),
@@ -141,7 +132,7 @@ def cmd_current(
 
 
 def cmd_history(
-    database_url: Optional[str] = typer.Option(
+    database_url: str | None = typer.Option(
         None, help="Database URL; overrides env for this command."
     ),
     verbose: bool = typer.Option(False, help="Verbose output."),
@@ -153,7 +144,7 @@ def cmd_history(
 
 def cmd_stamp(
     revision_target: str = typer.Argument("head"),
-    database_url: Optional[str] = typer.Option(
+    database_url: str | None = typer.Option(
         None, help="Database URL; overrides env for this command."
     ),
 ):
@@ -163,12 +154,10 @@ def cmd_stamp(
 
 
 def cmd_merge_heads(
-    database_url: Optional[str] = typer.Option(
+    database_url: str | None = typer.Option(
         None, help="Database URL; overrides env for this command."
     ),
-    message: Optional[str] = typer.Option(
-        None, "-m", "--message", help="Merge revision message."
-    ),
+    message: str | None = typer.Option(None, "-m", "--message", help="Merge revision message."),
 ):
     """Create a merge revision for multiple heads."""
     apply_database_url(database_url)
@@ -176,23 +165,19 @@ def cmd_merge_heads(
 
 
 def cmd_setup_and_migrate(
-    database_url: Optional[str] = typer.Option(
+    database_url: str | None = typer.Option(
         None,
         help="Overrides env for this command. Async vs sync is auto-detected from the URL.",
     ),
-    overwrite_scaffold: bool = typer.Option(
-        False, help="Overwrite alembic scaffold if present."
-    ),
-    create_db_if_missing: bool = typer.Option(
-        True, help="Create the database/schema if missing."
-    ),
+    overwrite_scaffold: bool = typer.Option(False, help="Overwrite alembic scaffold if present."),
+    create_db_if_missing: bool = typer.Option(True, help="Create the database/schema if missing."),
     create_followup_revision: bool = typer.Option(
         True, help="Create an autogen follow-up revision if revisions already exist."
     ),
     initial_message: str = typer.Option("initial schema"),
     followup_message: str = typer.Option("autogen"),
     # NEW:
-    discover_packages: Optional[List[str]] = typer.Option(
+    discover_packages: list[str] | None = typer.Option(
         None,
         help="Packages Alembic should import to discover models "
         "(e.g. app.models,svc_infra.apf_payments.models).",
@@ -267,7 +252,7 @@ def _import_callable(path: str):
             # Example: tests use a global `called` dict; point legacy to unit
             try:
                 if hasattr(unit_mod, "called"):
-                    setattr(mod, "called", getattr(unit_mod, "called"))
+                    mod.called = unit_mod.called  # type: ignore[attr-defined]
             except Exception:
                 pass
         # If legacy mod missing but unit exists, use unit
@@ -277,15 +262,13 @@ def _import_callable(path: str):
         mod = import_module(mod_name)
     fn = getattr(mod, fn_name, None)
     if not callable(fn):
-        raise typer.BadParameter(
-            f"Callable '{fn_name}' not found in module '{mod_name}'"
-        )
+        raise typer.BadParameter(f"Callable '{fn_name}' not found in module '{mod_name}'")
     return fn
 
 
 def cmd_seed(
     target: str = typer.Argument(..., help="Seed callable path 'module:func'"),
-    database_url: Optional[str] = typer.Option(
+    database_url: str | None = typer.Option(
         None,
         help="Database URL; overrides env for this command.",
     ),

svc_infra/cli/cmds/db/sql/sql_export_cmds.py

@@ -5,7 +5,7 @@ import json
 import os
 import sys
 from pathlib import Path
-from typing import Any, Optional, cast
+from typing import Any, cast
 
 import typer
 from sqlalchemy import text
@@ -20,20 +20,12 @@ except Exception:  # pragma: no cover - fallback when async extras unavailable
 
 
 def export_tenant(
-    table: str = typer.Argument(
-        ..., help="Qualified table name to export (e.g., public.items)"
-    ),
-    tenant_id: str = typer.Option(
-        ..., "--tenant-id", help="Tenant id value to filter by."
-    ),
-    tenant_field: str = typer.Option(
-        "tenant_id", help="Column name for tenant id filter."
-    ),
-    output: Optional[Path] = typer.Option(
-        None, "--output", help="Output file; defaults to stdout."
-    ),
-    limit: Optional[int] = typer.Option(None, help="Max rows to export."),
-    database_url: Optional[str] = typer.Option(
+    table: str = typer.Argument(..., help="Qualified table name to export (e.g., public.items)"),
+    tenant_id: str = typer.Option(..., "--tenant-id", help="Tenant id value to filter by."),
+    tenant_field: str = typer.Option("tenant_id", help="Column name for tenant id filter."),
+    output: Path | None = typer.Option(None, "--output", help="Output file; defaults to stdout."),
+    limit: int | None = typer.Option(None, help="Max rows to export."),
+    database_url: str | None = typer.Option(
         None, "--database-url", help="Overrides env SQL_URL for this command."
     ),
 ):
@@ -61,7 +53,7 @@ def export_tenant(
     is_async_engine = sa_async is not None and isinstance(engine, sa_async.AsyncEngine)
 
     if is_async_engine:
-        async_engine = cast(Any, engine)
+        async_engine = cast("Any", engine)
 
         async def _fetch() -> list[dict[str, Any]]:
             async with async_engine.connect() as conn:
@@ -70,7 +62,7 @@ def export_tenant(
 
         rows = asyncio.run(_fetch())
     else:
-        sync_engine = cast(Engine, engine)
+        sync_engine = cast("Engine", engine)
         with sync_engine.connect() as conn:
             result = conn.execute(stmt, params)
             rows = [dict(row) for row in result.mappings()]

svc_infra/cli/cmds/db/sql/sql_scaffold_cmds.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from pathlib import Path
-from typing import Optional, cast
+from typing import cast
 
 import click
 import typer
@@ -23,7 +23,7 @@ def cmd_scaffold(
     entity_name: str = typer.Option(
         "Item", help="Class name for entity/auth (e.g., User, Member, Product)."
     ),
-    table_name: Optional[str] = typer.Option(
+    table_name: str | None = typer.Option(
         None,
         help="Optional table name. For kind=auth, can also be set via AUTH_TABLE_NAME; defaults to plural snake of entity.",
     ),
@@ -35,10 +35,10 @@ def cmd_scaffold(
         "--same-dir/--no-same-dir",
         help="Put models & schemas into the same dir.",
     ),
-    models_filename: Optional[str] = typer.Option(
+    models_filename: str | None = typer.Option(
         None, help="Custom filename for models (separate-dir mode)."
     ),
-    schemas_filename: Optional[str] = typer.Option(
+    schemas_filename: str | None = typer.Option(
         None, help="Custom filename for schemas (separate-dir mode)."
     ),
 ):
@@ -50,7 +50,7 @@ def cmd_scaffold(
     res = scaffold_core(
         models_dir=models_dir,
         schemas_dir=schemas_dir,
-        kind=cast(Kind, kind.lower()),
+        kind=cast("Kind", kind.lower()),
         entity_name=entity_name,
         table_name=table_name,
         overwrite=overwrite,
@@ -70,13 +70,13 @@ def cmd_scaffold_models(
         click_type=click.Choice(["entity", "auth"], case_sensitive=False),
     ),
     entity_name: str = typer.Option("Item", "--entity-name"),
-    table_name: Optional[str] = typer.Option(None, "--table-name"),
+    table_name: str | None = typer.Option(None, "--table-name"),
     include_tenant: bool = typer.Option(True, "--include-tenant/--no-include-tenant"),
     include_soft_delete: bool = typer.Option(
         False, "--include-soft-delete/--no-include-soft-delete"
     ),
     overwrite: bool = typer.Option(False, "--overwrite/--no-overwrite"),
-    models_filename: Optional[str] = typer.Option(
+    models_filename: str | None = typer.Option(
         None,
         "--models-filename",
         help="Filename to write (e.g. project_models.py). Defaults to <snake(entity)>.py",
@@ -89,7 +89,7 @@ def cmd_scaffold_models(
     """
     res = scaffold_models_core(
         dest_dir=dest_dir,
-        kind=cast(Kind, kind.lower()),
+        kind=cast("Kind", kind.lower()),
         entity_name=entity_name,
         table_name=table_name,
         include_tenant=include_tenant,
@@ -111,7 +111,7 @@ def cmd_scaffold_schemas(
     entity_name: str = typer.Option("Item", "--entity-name"),
     include_tenant: bool = typer.Option(True, "--include-tenant/--no-include-tenant"),
     overwrite: bool = typer.Option(False, "--overwrite/--no-overwrite"),
-    schemas_filename: Optional[str] = typer.Option(
+    schemas_filename: str | None = typer.Option(
         None,
         "--schemas-filename",
         help="Filename to write (e.g. project_schemas.py). Defaults to <snake(entity)>.py",
@@ -124,7 +124,7 @@ def cmd_scaffold_schemas(
     """
     res = scaffold_schemas_core(
         dest_dir=dest_dir,
-        kind=cast(Kind, kind.lower()),
+        kind=cast("Kind", kind.lower()),
         entity_name=entity_name,
         include_tenant=include_tenant,
         overwrite=overwrite,

svc_infra/cli/cmds/docs/docs_cmds.py

@@ -4,7 +4,6 @@ import os
 from importlib.resources import as_file
 from importlib.resources import files as pkg_files
 from pathlib import Path
-from typing import Dict, List
 
 import click
 import typer
@@ -17,8 +16,8 @@ def _norm(name: str) -> str:
     return name.strip().lower().replace(" ", "-").replace("_", "-")
 
 
-def _discover_fs_topics(docs_dir: Path) -> Dict[str, Path]:
-    topics: Dict[str, Path] = {}
+def _discover_fs_topics(docs_dir: Path) -> dict[str, Path]:
+    topics: dict[str, Path] = {}
     if docs_dir.exists() and docs_dir.is_dir():
         for p in sorted(docs_dir.glob("*.md")):
             if p.is_file():
@@ -26,12 +25,12 @@ def _discover_fs_topics(docs_dir: Path) -> Dict[str, Path]:
     return topics
 
 
-def _discover_pkg_topics() -> Dict[str, Path]:
+def _discover_pkg_topics() -> dict[str, Path]:
     """
     Discover docs shipped inside the installed package at svc_infra/docs/*,
     using importlib.resources so this works for wheels, sdists, and zipped wheels.
     """
-    topics: Dict[str, Path] = {}
+    topics: dict[str, Path] = {}
     try:
         docs_root = pkg_files("svc_infra").joinpath("docs")
         # docs_root is a Traversable; it may be inside a zip. Iterate safely.
@@ -74,8 +73,8 @@ def _resolve_docs_dir(ctx: click.Context) -> Path | None:
 
 
 class DocsGroup(TyperGroup):
-    def list_commands(self, ctx: click.Context) -> List[str]:
-        names: List[str] = list(super().list_commands(ctx) or [])
+    def list_commands(self, ctx: click.Context) -> list[str]:
+        names: list[str] = list(super().list_commands(ctx) or [])
         dir_to_use = _resolve_docs_dir(ctx)
         fs = _discover_fs_topics(dir_to_use) if dir_to_use else {}
         pkg = _discover_pkg_topics()
@@ -122,9 +121,7 @@ def register(app: typer.Typer) -> None:
         # No group-level options; dynamic commands and 'show' handle topics.
         return None
 
-    @docs_app.command(
-        "show", help="Show docs for a topic (alternative to dynamic subcommand)"
-    )
+    @docs_app.command("show", help="Show docs for a topic (alternative to dynamic subcommand)")
     def show(topic: str) -> None:
         key = _norm(topic)
         ctx = click.get_current_context()

svc_infra/cli/cmds/dx/dx_cmds.py

@@ -18,7 +18,7 @@ app = typer.Typer(no_args_is_help=True, add_completion=False)
 def cmd_openapi(path: str = typer.Argument(..., help="Path to OpenAPI JSON")):
     try:
         check_openapi_problem_schema(path=path)
-    except Exception as e:  # noqa: BLE001
+    except Exception as e:
         typer.secho(f"OpenAPI check failed: {e}", fg=typer.colors.RED, err=True)
         raise typer.Exit(2)
     typer.secho("OpenAPI checks passed", fg=typer.colors.GREEN)
@@ -28,7 +28,7 @@ def cmd_openapi(path: str = typer.Argument(..., help="Path to OpenAPI JSON")):
 def cmd_migrations(project_root: str = typer.Option(".", help="Project root")):
     try:
         check_migrations_up_to_date(project_root=project_root)
-    except Exception as e:  # noqa: BLE001
+    except Exception as e:
         typer.secho(f"Migrations check failed: {e}", fg=typer.colors.RED, err=True)
         raise typer.Exit(2)
     typer.secho("Migrations checks passed", fg=typer.colors.GREEN)
@@ -37,9 +37,7 @@ def cmd_migrations(project_root: str = typer.Option(".", help="Project root")):
 @app.command("changelog")
 def cmd_changelog(
     version: str = typer.Argument(..., help="Version (e.g., 0.1.604)"),
-    commits_file: str = typer.Option(
-        None, help="Path to JSON lines of commits (sha,subject)"
-    ),
+    commits_file: str = typer.Option(None, help="Path to JSON lines of commits (sha,subject)"),
 ):
     """Generate a changelog section from commit messages.
 
@@ -56,9 +54,7 @@ def cmd_changelog(
         )
         raise typer.Exit(2)
     rows = [
-        json.loads(line)
-        for line in Path(commits_file).read_text().splitlines()
-        if line.strip()
+        json.loads(line) for line in Path(commits_file).read_text().splitlines() if line.strip()
     ]
     commits = [Commit(sha=r["sha"], subject=r["subject"]) for r in rows]
     out = generate_release_section(version=version, commits=commits)
@@ -67,9 +63,7 @@ def cmd_changelog(
 
 @app.command("ci")
 def cmd_ci(
-    run: bool = typer.Option(
-        False, help="Execute the steps; default just prints a plan"
-    ),
+    run: bool = typer.Option(False, help="Execute the steps; default just prints a plan"),
     openapi: str | None = typer.Option(None, help="Path to OpenAPI JSON to lint"),
     project_root: str = typer.Option(".", help="Project root for migrations check"),
 ):