teddy-cli 0.1.17.dev1209__tar.gz → 0.1.17.dev1211__tar.gz

{teddy_cli-0.1.17.dev1209 → teddy_cli-0.1.17.dev1211}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: teddy-cli
-Version: 0.1.17.dev1209
+Version: 0.1.17.dev1211
 Summary: A local-first, file-based AI coding workflow that applies the UNIX philosophy to AI collaboration.
 Author: Raphael Atteritano
 License: AGPL-3.0-only

{teddy_cli-0.1.17.dev1209 → teddy_cli-0.1.17.dev1211}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "teddy-cli"
-version = "0.1.17.dev1209"
+version = "0.1.17.dev1211"
 description = "A local-first, file-based AI coding workflow that applies the UNIX philosophy to AI collaboration."
 authors = [{ name = "Raphael Atteritano" }]
 license = { text = "AGPL-3.0-only" }

{teddy_cli-0.1.17.dev1209 → teddy_cli-0.1.17.dev1211}/src/teddy_executor/adapters/inbound/session_cli_handlers.py

@@ -369,10 +369,48 @@ def _orchestrate_session_loop(
         signal.signal(signal.SIGINT, previous_handler)
 
 
-def _display_update_notification(cache_path: Path) -> None:
+def _display_drift_notification(container: Container) -> None:
+    """Advises the restore command when user prompts/templates have drifted.
+
+    Compares the user's ``.teddy/prompts/`` and ``docs/templates/`` against the
+    bundled defaults (via ``IInitUseCase.check_drift``) and, when they have
+    drifted (edited or missing), emits a yellow, actionable advice naming the
+    restore command(s). Advisory only: it runs on the preflight HEALTHY path and
+    never blocks the session. Gated by the checks.prompts_templates config
+    toggle (defaults to enabled).
+    """
+    config = container.resolve(IConfigService)
+    if not config.get_setting("checks.prompts_templates", True):
+        return
+
+    report = container.resolve(IInitUseCase).check_drift()
+    if not report.has_drift:
+        return
+
+    commands: list[str] = []
+    if report.prompts_drifted:
+        commands.append("teddy init prompts")
+    if report.templates_drifted:
+        commands.append("teddy init templates")
+
+    typer.echo(
+        typer.style(
+            "ℹ Prompt/template drift detected. To restore the bundled "
+            f"defaults, run: {' and '.join(commands)}\n",
+            fg=typer.colors.YELLOW,
+        )
+    )
+
+
+def _display_update_notification(container: Container, cache_path: Path) -> None:
     """Check the update cache and display a non-blocking notification
     if a newer version is available. Called on session startup, after
-    the background check thread has been started."""
+    the background check thread has been started. Gated by the
+    checks.update config toggle (defaults to enabled); a disabled toggle
+    suppresses the notification only -- the background fetch still runs."""
+    config = container.resolve(IConfigService)
+    if not config.get_setting("checks.update", True):
+        return
     try:
         cache = read_update_cache(cache_path)
         if cache is None:
@@ -428,7 +466,7 @@ def handle_new_session(  # noqa: PLR0913
         daemon=True,
     )
     thread.start()
-    _display_update_notification(cache_path)
+    _display_update_notification(container, cache_path)
 
     try:
         # 0. Pipeline mode requires an initial message
@@ -591,6 +629,7 @@ def _run_cli_preflight_check(
         # one-time setup stays decoupled from the approval flag (Slice 00-26).
         if setup_editor:
             _validate_editor_config(container)
+        _display_drift_notification(container)
         return
 
     error_msg = f"Configuration Error: {', '.join(errors)}"
@@ -977,7 +1016,7 @@ def handle_resume_session(  # noqa: PLR0913
         daemon=True,
     )
     thread.start()
-    _display_update_notification(cache_path)
+    _display_update_notification(container, cache_path)
 
     try:
         # 1. Health checks (advisory, non-blocking)

teddy_cli-0.1.17.dev1211/src/teddy_executor/core/domain/models/drift_report.py

@@ -0,0 +1,38 @@
+"""Domain model describing drift between user files and bundled defaults.
+
+Seam Items 3/4 (session-behaviour): ``InitService.check_drift`` returns this
+immutable report so the CLI preflight can advise ``teddy init prompts`` /
+``teddy init templates`` when the user's local copies have diverged from (or are
+missing relative to) the bundled defaults.
+"""
+
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class DriftReport:
+    """Immutable summary of user files that diverge from bundled defaults.
+
+    Each field holds the *basenames* (e.g. ``pathfinder.xml``) of the affected
+    files, preserving the canonical manifest order for deterministic output.
+    """
+
+    edited_prompts: tuple[str, ...] = ()
+    missing_prompts: tuple[str, ...] = ()
+    edited_templates: tuple[str, ...] = ()
+    missing_templates: tuple[str, ...] = ()
+
+    @property
+    def prompts_drifted(self) -> bool:
+        """True when any user prompt is edited or missing."""
+        return bool(self.edited_prompts or self.missing_prompts)
+
+    @property
+    def templates_drifted(self) -> bool:
+        """True when any user template is edited or missing."""
+        return bool(self.edited_templates or self.missing_templates)
+
+    @property
+    def has_drift(self) -> bool:
+        """True when any user prompt or template has drifted from its default."""
+        return self.prompts_drifted or self.templates_drifted

{teddy_cli-0.1.17.dev1209 → teddy_cli-0.1.17.dev1211}/src/teddy_executor/core/ports/inbound/init.py

@@ -1,5 +1,7 @@
 from abc import ABC, abstractmethod
 
+from teddy_executor.core.domain.models.drift_report import DriftReport
+
 
 class IInitUseCase(ABC):
     """
@@ -60,3 +62,15 @@ class IInitUseCase(ABC):
             A human-readable status string (e.g., "Templates updated (11 files).").
         """
         pass
+
+    @abstractmethod
+    def check_drift(self) -> DriftReport:
+        """
+        Compares the user's prompts and templates against the bundled defaults.
+
+        Returns:
+            A DriftReport enumerating which ``.teddy/prompts/*.xml`` and
+            ``docs/templates/*.md`` files are edited or missing relative to the
+            bundled defaults.
+        """
+        pass

{teddy_cli-0.1.17.dev1209 → teddy_cli-0.1.17.dev1211}/src/teddy_executor/core/services/init_service.py

@@ -5,6 +5,7 @@ from importlib import resources
 
 import yaml
 
+from teddy_executor.core.domain.models.drift_report import DriftReport
 from teddy_executor.core.ports.inbound.init import IInitUseCase
 from teddy_executor.core.ports.outbound.file_system_manager import IFileSystemManager
 
@@ -53,6 +54,19 @@ _TEMPLATE_FILES = [
     "pre-commit.md",
 ]
 
+# Bundled prompt XMLs copied into a project's ``.teddy/prompts/`` by
+# ``_init_prompts`` and compared by ``check_drift``. Kept as a fixed manifest
+# (mirroring ``_TEMPLATE_FILES``) so the copy routine and the drift check share
+# one single source of truth.
+_PROMPT_FILES = [
+    "architect.xml",
+    "assistant.xml",
+    "debugger.xml",
+    "developer.xml",
+    "pathfinder.xml",
+    "prototyper.xml",
+]
+
 
 class InitService(IInitUseCase):
     """
@@ -189,14 +203,7 @@ class InitService(IInitUseCase):
         """
         return self._copy_bundled_files(
             dest_dir=".teddy/prompts",
-            filenames=[
-                "architect.xml",
-                "assistant.xml",
-                "debugger.xml",
-                "developer.xml",
-                "pathfinder.xml",
-                "prototyper.xml",
-            ],
+            filenames=_PROMPT_FILES,
             resolve_content=lambda fname: self._get_default_content(f"prompts/{fname}"),
             overwrite=overwrite,
         )
@@ -285,3 +292,59 @@ class InitService(IInitUseCase):
         """
         status = self._init_templates(overwrite=overwrite)
         return f"Templates {status}."
+
+    def _classify_drift(
+        self,
+        dest_dir: str,
+        filenames: Sequence[str],
+        resolve_bundled: Callable[[str], str | None],
+    ) -> tuple[tuple[str, ...], tuple[str, ...]]:
+        """Partitions ``filenames`` into (edited, missing) against bundled defaults.
+
+        A file is MISSING when its user copy is absent. It is EDITED when the
+        user copy exists, a bundled default is resolvable, and the two contents
+        differ. Unresolvable bundled defaults are skipped (never reported as
+        drift). Order is preserved from ``filenames`` for deterministic output.
+        """
+        edited: list[str] = []
+        missing: list[str] = []
+        for fname in filenames:
+            user_path = f"{dest_dir}/{fname}"
+            if not self._file_system.path_exists(user_path):
+                missing.append(fname)
+                continue
+            bundled_content = resolve_bundled(fname)
+            if bundled_content is None:
+                continue
+            if self._file_system.read_file(user_path) != bundled_content:
+                edited.append(fname)
+        return tuple(edited), tuple(missing)
+
+    def check_drift(self) -> DriftReport:
+        """Compares the user's prompts and templates against bundled defaults.
+
+        Reports which ``.teddy/prompts/*.xml`` and ``docs/templates/*.md`` files
+        have been EDITED away from their bundled default and which are MISSING,
+        so the CLI preflight can advise ``teddy init prompts`` /
+        ``teddy init templates``. An absent ``.teddy/prompts/`` directory simply
+        makes every prompt report as MISSING (per-file check, no directory
+        special-casing).
+        """
+        edited_prompts, missing_prompts = self._classify_drift(
+            dest_dir=".teddy/prompts",
+            filenames=_PROMPT_FILES,
+            resolve_bundled=lambda fname: self._get_default_content(f"prompts/{fname}"),
+        )
+        edited_templates, missing_templates = self._classify_drift(
+            dest_dir="docs/templates",
+            filenames=_TEMPLATE_FILES,
+            resolve_bundled=lambda fname: self._read_bundled_resource(
+                self._templates_dir, fname
+            ),
+        )
+        return DriftReport(
+            edited_prompts=edited_prompts,
+            missing_prompts=missing_prompts,
+            edited_templates=edited_templates,
+            missing_templates=missing_templates,
+        )