feat: add config diff command to show non-default settings

Closes #248

Author: TheCodingDragon0

src/bernstein/cli/aliases.py

@@ -4,11 +4,18 @@
 
 Provides a Click Group subclass that resolves short aliases to
 full command names, plus a registry of built-in aliases.
+User-defined aliases can be loaded from ``~/.bernstein/aliases.yaml``.
 """
 
 from __future__ import annotations
 
+import logging
+from pathlib import Path
+
 import click
+import yaml
+
+logger = logging.getLogger(__name__)
 
 # ---------------------------------------------------------------------------
 # Alias registry
@@ -25,6 +32,11 @@
     "i": "overture",  # init (hidden name: overture)
 }
 
+# Track which aliases are user-defined (populated at load time)
+_USER_ALIASES: dict[str, str] = {}
+
+_USER_ALIASES_PATH = Path.home() / ".bernstein" / "aliases.yaml"
+
 
 def get_alias(name: str) -> str | None:
     """Return the full command name for an alias, or None.
@@ -43,6 +55,32 @@ def get_all_aliases() -> dict[str, str]:
     return dict(ALIASES)
 
 
+def _load_user_aliases() -> dict[str, str]:
+    """Load user-defined aliases from ~/.bernstein/aliases.yaml."""
+    if not _USER_ALIASES_PATH.is_file():
+        return {}
+    try:
+        with open(_USER_ALIASES_PATH) as f:
+            data = yaml.safe_load(f) or {}
+        if not isinstance(data, dict):
+            return {}
+        return {str(k): str(v) for k, v in data.items() if isinstance(k, str) and isinstance(v, str)}
+    except Exception:
+        logger.debug("Failed to load user aliases from %s", _USER_ALIASES_PATH, exc_info=True)
+        return {}
+
+
+def _merge_aliases() -> None:
+    """Merge user aliases into the global registry (user overrides built-in)."""
+    global _USER_ALIASES
+    _USER_ALIASES = _load_user_aliases()
+    ALIASES.update(_USER_ALIASES)
+
+
+# Call at module load time
+_merge_aliases()
+
+
 class AliasGroup(click.Group):
     """Click Group that resolves short aliases to full command names.
 
@@ -92,6 +130,7 @@ def aliases_cmd() -> None:
     table = Table(title="Command Aliases", show_header=True, header_style="bold cyan")
     table.add_column("Alias", style="green", width=10)
     table.add_column("Command", style="white", width=20)
+    table.add_column("Source", style="dim", width=10)
     table.add_column("Description", style="dim")
 
     _descriptions: dict[str, str] = {
@@ -107,7 +146,8 @@ def aliases_cmd() -> None:
 
     for alias, command in sorted(ALIASES.items()):
         desc = _descriptions.get(alias, "")
-        table.add_row(alias, command, desc)
+        source = "[cyan]user[/cyan]" if alias in _USER_ALIASES else "[dim]built-in[/dim]"
+        table.add_row(alias, command, source, desc)
 
     console.print(table)
     console.print("\n[dim]Usage: bernstein <alias> [options][/dim]")

src/bernstein/cli/config_diff_cli.py

@@ -0,0 +1,69 @@
+"""Config diff command: show settings that differ from defaults.
+
+CFG-010: CLI wrapper around core.config_diff_cmd.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import yaml
+
+
+def _load_current_config() -> dict[str, object]:
+    """Load the current config from bernstein.yaml/yml."""
+    for name in ("bernstein.yaml", "bernstein.yml"):
+        p = Path.cwd() / name
+        if p.is_file():
+            with open(p) as f:
+                data = yaml.safe_load(f) or {}
+            if isinstance(data, dict):
+                return data
+    return {}
+
+
+def config_diff_cmd() -> None:
+    """Show settings that differ from defaults."""
+    from rich.table import Table
+
+    from bernstein.cli.helpers import console
+    from bernstein.core.config_diff_cmd import diff_against_defaults
+
+    current_yaml = _load_current_config()
+
+    if not current_yaml:
+        console.print("[dim]No bernstein.yaml found in current directory.[/dim]")
+        return
+
+    report = diff_against_defaults(current_yaml)
+
+    if not report.has_deviations:
+        console.print("[green]All settings match defaults.[/green]")
+        return
+
+    table = Table(title="Configuration diff", show_header=True, header_style="bold cyan")
+    table.add_column("Setting", style="cyan")
+    table.add_column("Kind", style="dim")
+    table.add_column("Default", style="dim")
+    table.add_column("Current", style="bold green")
+
+    for dev in report.deviations:
+        kind_style = {
+            "changed": "yellow",
+            "added": "green",
+            "removed": "red",
+        }.get(dev.kind, "dim")
+        table.add_row(
+            dev.key,
+            f"[{kind_style}]{dev.kind}[/{kind_style}]",
+            str(dev.default_value) if dev.default_value is not None else "",
+            str(dev.current_value) if dev.current_value is not None else "",
+        )
+
+    console.print(table)
+    console.print(
+        f"\n{report.changed_count} changed, "
+        f"{report.added_count} added, "
+        f"{report.removed_count} removed "
+        f"out of {report.total_keys} total settings."
+    )

src/bernstein/cli/workspace_cmd.py

@@ -245,6 +245,14 @@ def config_list(project_dir: str) -> None:
     console.print(table)
 
 
+@config_group.command("diff")
+def config_diff() -> None:
+    """Show settings that differ from defaults."""
+    from bernstein.cli.config_diff_cli import config_diff_cmd as _diff_cmd
+
+    _diff_cmd()
+
+
 @config_group.command("validate")
 def config_validate() -> None:
     """Validate project configuration (model policy, providers, etc.).