teddy-cli 0.1.4__tar.gz → 0.1.6__tar.gz

{teddy_cli-0.1.4 → teddy_cli-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: teddy-cli
-Version: 0.1.4
+Version: 0.1.6
 Summary: A local-first, file-based AI coding workflow that applies the UNIX philosophy to AI collaboration.
 License: AGPL-3.0-only
 License-File: LICENSE
@@ -30,6 +30,7 @@ Requires-Dist: python-dotenv (>=1.0.1)
 Requires-Dist: pyyaml (>=6.0,<7.0)
 Requires-Dist: requests (>=2.33.0,<3.0.0)
 Requires-Dist: textual (>=8.1.0,<9.0.0)
+Requires-Dist: tld (>=0.10,<1.0)
 Requires-Dist: trafilatura (>=2.0.0,<3.0.0)
 Requires-Dist: typer[all]
 Requires-Dist: urllib3 (>=2.7.0,<3.0.0)

{teddy_cli-0.1.4 → teddy_cli-0.1.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "teddy-cli"
-version = "0.1.4"
+version = "0.1.6"
 description = "A local-first, file-based AI coding workflow that applies the UNIX philosophy to AI collaboration."
 authors = ["Raphael Atteritano"]
 license = "AGPL-3.0-only"
@@ -29,6 +29,7 @@ bandit = ">=1.7.9,<1.8.0"
 pip-audit = ">=2.7.3,<2.8.0"
 textual = "^8.1.0"
 urllib3 = "^2.7.0"
+tld = ">=0.10,<1.0"
 
 [tool.poetry.group.dev.dependencies]
 pytest = "^9.0.3"

{teddy_cli-0.1.4 → teddy_cli-0.1.6}/src/teddy_executor/__main__.py

@@ -57,8 +57,12 @@ logging.basicConfig(
 )
 
 
-def _ensure_project_initialized(container) -> None:
-    """Lazily performs project anchoring and initialization."""
+def _ensure_project_initialized(container, root_dir: str | None = None) -> None:
+    """Lazily performs project anchoring and initialization.
+
+    If root_dir is provided, uses that path as the root. Otherwise, finds
+    the nearest parent containing .teddy/ via find_project_root().
+    """
     from teddy_executor.adapters.inbound.cli_helpers import find_project_root
     from teddy_executor.core.ports.outbound.file_system_manager import (
         IFileSystemManager,
@@ -77,7 +81,10 @@ def _ensure_project_initialized(container) -> None:
     from teddy_executor.adapters.outbound.yaml_config_adapter import YamlConfigAdapter
     from punq import Scope
 
-    root = str(find_project_root())
+    if root_dir is None:
+        root = str(find_project_root())
+    else:
+        root = root_dir
     c = container
 
     regs = getattr(c.registrations, "_Registry__registrations", {})
@@ -165,24 +172,61 @@ def start(  # noqa: PLR0913
     )
 
 
-@app.command()
-def init():
+init_app = typer.Typer()
+
+
+@init_app.callback(invoke_without_command=True)
+def init_callback(ctx: typer.Context):
     """
     Initializes the .teddy directory and pre-warms heavy imports for faster startup.
     """
+    from teddy_executor.adapters.inbound.cli_helpers import prewarm_imports
+    from teddy_executor.core.ports.inbound.init import IInitUseCase
+
     container = get_container()
-    _ensure_project_initialized(container)
-    # Pre-warm heavy imports to reduce first-run latency
-    try:
-        import litellm  # noqa: F401
-        import trafilatura  # noqa: F401
-        import pyperclip  # noqa: F401
-        from bs4 import BeautifulSoup  # noqa: F401
-        from ddgs import DDGS  # noqa: F401
-    except ImportError:
-        pass  # Some optional dependencies may not be installed
+    _ensure_project_initialized(container, root_dir=str(Path.cwd()))
+    prewarm_imports()
     # Auto-login would trigger here once `teddy login` is implemented (no-op for now)
-    typer.echo("TeDDy initialized in .teddy folder.")
+    if ctx.invoked_subcommand is not None:
+        # A subcommand (e.g., prompts, config) will handle its own initialization
+        # and output. Skip the full summary to avoid conflicting messages.
+        return
+    init_use_case = container.resolve(IInitUseCase)
+    summary = init_use_case.ensure_initialized()
+    typer.echo(f"TeDDy initialized in .teddy folder. {summary}")
+
+
+@init_app.command()
+def prompts():
+    """
+    Overwrites bundled prompt XMLs in .teddy/prompts/ with defaults.
+    """
+    from teddy_executor.core.ports.inbound.init import IInitUseCase
+
+    container = get_container()
+    init_use_case = container.resolve(IInitUseCase)
+    status = init_use_case.ensure_prompts_initialized(overwrite=True)
+    typer.echo(status)
+
+
+@init_app.command()
+def config():
+    """
+    Overwrites config.yaml, .gitignore, and init.context with defaults.
+    """
+    from teddy_executor.core.ports.inbound.init import IInitUseCase
+
+    container = get_container()
+    init_use_case = container.resolve(IInitUseCase)
+    status = init_use_case.ensure_config_initialized(overwrite=True)
+    typer.echo(status)
+
+
+app.add_typer(
+    init_app,
+    name="init",
+    help="Initialize .teddy directory, prompts, or configuration.",
+)
 
 
 @app.command()
@@ -194,6 +238,65 @@ def version() -> None:
     typer.echo(f"TeDDy v{installed}")
 
 
+@app.command()
+def update(
+    experimental: bool = typer.Option(
+        False,
+        "--experimental",
+        help="Check and upgrade from TestPyPI instead of PyPI.",
+    ),
+):
+    """Checks PyPI for the latest version of TeDDy and displays upgrade
+    instructions. Does not upgrade automatically."""
+    from teddy_executor.core.services.update_checker import (
+        get_current_version,
+        fetch_latest_version,
+        compare_versions,
+        is_prerelease,
+        PYPI_URL,
+        TEST_PYPI_URL,
+    )
+
+    index_url = TEST_PYPI_URL if experimental else PYPI_URL
+    # When experimental, include prerelease versions (TestPyPI only has dev releases)
+    latest = fetch_latest_version(index_url, stable_only=not experimental)
+
+    if latest is None:
+        typer.echo("Could not check for updates: network error.")
+        return
+
+    current = get_current_version()
+
+    needs_update = compare_versions(current, latest)
+    is_channel_switch = False
+    if not needs_update:
+        # If current is a pre-release and the latest is stable, allow downgrade
+        # to the stable channel
+        if is_prerelease(current) and not is_prerelease(latest):
+            is_channel_switch = True
+
+    if not needs_update and not is_channel_switch:
+        typer.echo(f"You are already running the latest version ({current}).")
+        return
+
+    if is_channel_switch:
+        typer.echo(f"You are running the latest experimental version ({current}).")
+        typer.echo(
+            "To switch to the stable release, run: pip uninstall -y teddy-cli && pip install teddy-cli"
+        )
+        typer.echo("To apply prompt updates, run: teddy init prompts")
+    elif experimental:
+        typer.echo(f"A new experimental version {latest} is available.")
+        typer.echo(
+            "To upgrade, run: pip install --upgrade teddy-cli --index-url https://test.pypi.org/simple/"
+        )
+        typer.echo("To apply prompt updates, run: teddy init prompts")
+    else:
+        typer.echo(f"A new version {latest} is available.")
+        typer.echo("To upgrade, run: pip install --upgrade teddy-cli")
+        typer.echo("To apply prompt updates, run: teddy init prompts")
+
+
 @app.command()
 def context(
     no_copy: bool = typer.Option(

{teddy_cli-0.1.4 → teddy_cli-0.1.6}/src/teddy_executor/adapters/inbound/cli_helpers.py

@@ -247,3 +247,18 @@ def apply_ui_mode_override(container: Container, ui_mode_bool: bool) -> None:
 
     mode = "tui" if ui_mode_bool else "console"
     register_reviewer(container, ui_mode=mode)
+
+
+def prewarm_imports() -> None:
+    """
+    Pre-warm heavy imports to reduce first-run latency.
+    Extracted from __main__.py init command for reuse by update command.
+    """
+    try:
+        import litellm  # noqa: F401
+        import trafilatura  # noqa: F401
+        import pyperclip  # noqa: F401
+        from bs4 import BeautifulSoup  # noqa: F401
+        from ddgs import DDGS  # noqa: F401
+    except ImportError:
+        pass

{teddy_cli-0.1.4 → teddy_cli-0.1.6}/src/teddy_executor/adapters/inbound/session_cli_handlers.py

@@ -1,5 +1,9 @@
+import logging
+import shutil
+import subprocess  # nosec B404
 from pathlib import Path
 from typing import Dict, Optional, Sequence
+
 import typer
 from punq import Container
 
@@ -17,9 +21,94 @@ from teddy_executor.core.utils.string import slugify
 from teddy_executor.adapters.inbound.cli_formatter import format_project_context
 from teddy_executor.adapters.inbound.cli_helpers import (
     echo_and_copy,
+    find_project_root,
+)
+from teddy_executor.core.services.update_checker import (
+    background_check,
+    compare_versions,
+    get_current_version,
+    read_update_cache,
 )
 
 
+logger = logging.getLogger(__name__)
+
+
+def _ensure_commit_hooks() -> None:
+    """Install pre-commit hooks if config exists and CLI is available.
+    Shows green notification on success, yellow warning if config missing
+    or CLI not found."""
+    config_path = Path.cwd() / ".pre-commit-config.yaml"
+    if not config_path.exists():
+        typer.secho(
+            "⚠ No pre-commit hooks configured",
+            fg=typer.colors.YELLOW,
+            err=True,
+        )
+        return
+    if not shutil.which("pre-commit"):
+        typer.secho(
+            "⚠ pre-commit CLI not found",
+            fg=typer.colors.YELLOW,
+            err=True,
+        )
+        return
+    try:
+        subprocess.run(  # nosec B603 B607
+            ["pre-commit", "install", "-t", "pre-commit", "-t", "post-commit"],
+            check=True,
+            capture_output=True,
+        )
+    except subprocess.CalledProcessError:
+        logger.debug("pre-commit install failed", exc_info=True)
+        return
+    typer.secho(
+        "✓ pre-commit hooks installed",
+        fg=typer.colors.GREEN,
+        err=True,
+    )
+
+
+def _check_git_initialized() -> None:
+    """Verify git repository status. Auto-initializes if not a repo.
+    Shows green notification if already a repo or freshly initialized,
+    yellow warning if git CLI not found.
+    Only checks the current working directory for a `.git` marker.
+    Does NOT walk up parent directories."""
+    if not shutil.which("git"):
+        typer.secho(
+            "⚠ Git CLI not found",
+            fg=typer.colors.YELLOW,
+            err=True,
+        )
+        return
+    # Check if CWD itself contains a .git marker (directory or file)
+    if (Path.cwd() / ".git").exists():
+        typer.secho(
+            "✓ Git repository detected",
+            fg=typer.colors.GREEN,
+            err=True,
+        )
+        return
+    # No local .git found – auto-initialize
+    try:
+        subprocess.run(["git", "init"], check=True, capture_output=True)  # nosec B603 B607
+    except subprocess.CalledProcessError:
+        logger.debug("git init failed", exc_info=True)
+        return
+    typer.secho(
+        "✓ Git repository initialized",
+        fg=typer.colors.GREEN,
+        err=True,
+    )
+
+
+def _run_health_checks() -> None:
+    """Run all startup health checks and display notifications if needed."""
+    _ensure_commit_hooks()
+    _check_git_initialized()
+
+
 def _determine_session_name(name: Optional[str], message: Optional[str]) -> str:
     """Determine session name (slugify message if name is missing)."""
     if name:
@@ -78,6 +167,34 @@ def _orchestrate_session_loop(
             break
 
 
+def _display_update_notification(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."""
+    try:
+        cache = read_update_cache(cache_path)
+        if cache is None:
+            return
+        latest = cache.get("latest_version", "")
+        if not latest:
+            return
+        current = get_current_version()
+        if compare_versions(current, latest):
+            typer.echo(
+                typer.style(
+                    f"ℹ A new version {latest} is available. "
+                    "To upgrade, run: pip install --upgrade teddy-cli\n"
+                    "   To apply prompt updates: delete .teddy/prompts/ and run 'teddy init'",
+                    fg=typer.colors.YELLOW,
+                )
+            )
+    except Exception:
+        import logging
+
+        logger = logging.getLogger(__name__)
+        logger.debug("Failed to display update notification", exc_info=True)
+
+
 def handle_new_session(  # noqa: PLR0913
     container: Container,
     name: Optional[str],
@@ -91,11 +208,26 @@ def handle_new_session(  # noqa: PLR0913
     api_key: Optional[str] = None,
 ):
     """Logic for the 'start' command."""
+    import threading
+
+    # Start non-blocking background version check
+    cache_path = find_project_root() / ".teddy" / ".update_cache.json"
+    thread = threading.Thread(
+        target=background_check,
+        args=(cache_path,),
+        daemon=True,
+    )
+    thread.start()
+    _display_update_notification(cache_path)
+
     try:
         # 0. Ensure project is initialized
         container.resolve(IInitUseCase).ensure_initialized()
 
-        # 1. Pre-flight checks (Fail-fast before user interaction)
+        # 1. Health checks (advisory, non-blocking)
+        _run_health_checks()
+
+        # 2. Pre-flight checks (Fail-fast before user interaction)
         typer.echo("Checking configurations...", err=True)
         _run_cli_preflight_check(container, agent=agent)
         _echo_config_success(container, agent, model=model)
@@ -326,8 +458,23 @@ def handle_resume_session(  # noqa: PLR0913
     api_key: Optional[str] = None,
 ):
     """Logic for the 'resume' command."""
+    import threading
+
+    # Start non-blocking background version check
+    cache_path = find_project_root() / ".teddy" / ".update_cache.json"
+    thread = threading.Thread(
+        target=background_check,
+        args=(cache_path,),
+        daemon=True,
+    )
+    thread.start()
+    _display_update_notification(cache_path)
+
     try:
-        # 1. Pre-flight checks
+        # 1. Health checks (advisory, non-blocking)
+        _run_health_checks()
+
+        # 2. Pre-flight checks
         typer.echo("Checking configurations...", err=True)
         _run_cli_preflight_check(container)
 

{teddy_cli-0.1.4 → teddy_cli-0.1.6}/src/teddy_executor/adapters/inbound/textual_plan_reviewer_execution.py

@@ -154,6 +154,9 @@ async def orchestrate_execution(app: ReviewerApp, node: Any, update_fn: Any) ->
     action.state = ExecutionStatus.RUNNING
     app._refresh_node(node)
 
+    # Harvest modified content from pending_temp_file before execution
+    harvest_action_content(action, app.INSTRUCTION_MARKER)
+
     try:
         import anyio
 

{teddy_cli-0.1.4 → teddy_cli-0.1.6}/src/teddy_executor/adapters/outbound/system_environment_inspector.py

@@ -39,7 +39,7 @@ class SystemEnvironmentInspector(IEnvironmentInspector):
 
     def get_git_status(self) -> Optional[str]:
         """
-        Gathers the current Git status of the working directory.
+        Gathers the current Git status of the working directory (short format).
         """
         try:
             result = self._run_func(  # nosec B603 B607
@@ -52,3 +52,19 @@ class SystemEnvironmentInspector(IEnvironmentInspector):
             return result.stdout.rstrip() if result.stdout else ""
         except (subprocess.CalledProcessError, FileNotFoundError):
             return None
+
+    def get_full_git_status(self) -> Optional[str]:
+        """
+        Gathers the full Git status of the working directory (including branch info).
+        """
+        try:
+            result = self._run_func(  # nosec B603 B607
+                ["git", "status"],
+                capture_output=True,
+                text=True,
+                check=True,
+                stdin=subprocess.DEVNULL,
+            )
+            return result.stdout.rstrip() if result.stdout else ""
+        except (subprocess.CalledProcessError, FileNotFoundError):
+            return None

teddy_cli-0.1.6/src/teddy_executor/core/ports/inbound/init.py

@@ -0,0 +1,47 @@
+from abc import ABC, abstractmethod
+
+
+class IInitUseCase(ABC):
+    """
+    Inbound port for project initialization.
+    """
+
+    @abstractmethod
+    def ensure_initialized(self) -> str:
+        """
+        Ensures the .teddy/ directory and its essential configuration
+        files are present in the current project root.
+
+        Returns:
+            A human-readable summary string (e.g., "Config: unchanged. Prompts: updated (3 files).").
+        """
+        pass
+
+    @abstractmethod
+    def ensure_prompts_initialized(self, overwrite: bool = False) -> str:
+        """
+        Ensures prompt XML files are present in the .teddy/prompts/ directory.
+
+        Args:
+            overwrite: If True, always overwrite existing prompt files with defaults.
+                       If False (default), only write missing files.
+
+        Returns:
+            A human-readable status string (e.g., "Prompts overwritten (6 files).").
+        """
+        pass
+
+    @abstractmethod
+    def ensure_config_initialized(self, overwrite: bool = False) -> str:
+        """
+        Ensures configuration files (config.yaml, .gitignore, init.context) are present
+        in the .teddy/ directory.
+
+        Args:
+            overwrite: If True, always overwrite existing config files with defaults.
+                       If False (default), only write missing files.
+
+        Returns:
+            A human-readable status string (e.g., "Configuration files overwritten (3 files).").
+        """
+        pass

{teddy_cli-0.1.4 → teddy_cli-0.1.6}/src/teddy_executor/core/ports/outbound/environment_inspector.py

@@ -22,9 +22,18 @@ class IEnvironmentInspector(Protocol):
 
     def get_git_status(self) -> Optional[str]:
         """
-        Gathers the current Git status of the working directory.
+        Gathers the current Git status of the working directory (short format).
 
         Returns:
             Optional[str]: The output of 'git status -s' or None if not a git repo.
         """
         ...
+
+    def get_full_git_status(self) -> Optional[str]:
+        """
+        Gathers the full Git status of the working directory (including branch info).
+
+        Returns:
+            Optional[str]: The output of 'git status' or None if not a git repo.
+        """
+        ...

{teddy_cli-0.1.4 → teddy_cli-0.1.6}/src/teddy_executor/core/services/context_service.py

@@ -39,7 +39,7 @@ class ContextService(IGetContextUseCase):
         self._llm_client = llm_client
         self._web_scraper = web_scraper
 
-    def get_context(
+    def get_context(  # noqa: PLR0913
         self,
         context_files: Optional[Dict[str, Sequence[str]]] = None,
         include_tokens: bool = True,
@@ -53,7 +53,8 @@ class ContextService(IGetContextUseCase):
         Gathers all project context information by orchestrating its dependencies.
         """
         system_info = self._environment_inspector.get_environment_info()
-        git_status = self._environment_inspector.get_git_status()
+        short_git_status = self._environment_inspector.get_git_status()
+        full_git_status = self._environment_inspector.get_full_git_status()
         repo_tree = self._repo_tree_generator.generate_tree()
 
         scoped_paths, all_resolved_paths = self._resolve_scoped_paths(context_files)
@@ -79,7 +80,7 @@ class ContextService(IGetContextUseCase):
                     file_contents[url] = None
 
         content = self._format_content(
-            repo_tree, scoped_paths, file_contents, git_status
+            repo_tree, scoped_paths, file_contents, full_git_status
         )
         content_tokens = (
             self._llm_client.get_text_token_count(content) if include_tokens else 0
@@ -89,9 +90,9 @@ class ContextService(IGetContextUseCase):
             header=self._format_header(system_info, current_turn),
             content=content,
             scoped_paths=scoped_paths,
-            git_status=git_status,
+            git_status=full_git_status,
             items=self._collect_items(
-                scoped_paths, file_contents, git_status, include_tokens
+                scoped_paths, file_contents, short_git_status, include_tokens
             ),
             agent_name=agent_name,
             total_window=total_window,
@@ -303,10 +304,6 @@ class ContextService(IGetContextUseCase):
         git_status: Optional[str] = None,
     ) -> str:
         """Formats the main content section of the context report."""
-        display_status = git_status
-        if git_status == "":
-            display_status = "nothing to commit, working tree clean"
-
         # Gather all unique paths
         all_paths: List[str] = []
         for paths in scoped_paths.values():
@@ -320,7 +317,7 @@ class ContextService(IGetContextUseCase):
 
         content_parts = [
             "\n## Git Status",
-            display_status if display_status is not None else "",
+            git_status if isinstance(git_status, str) else "",
             "\n## Project Structure",
             f"```\n{repo_tree}\n```",
         ]