teddy-cli 0.1.17.dev1407__tar.gz → 0.1.17.dev1409__tar.gz

{teddy_cli-0.1.17.dev1407 → teddy_cli-0.1.17.dev1409}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: teddy-cli
-Version: 0.1.17.dev1407
+Version: 0.1.17.dev1409
 Summary: The local-first, test-driven agentic engineering harness. Because you should own the means of development.
 Author: Raphael Atteritano
 License: AGPL-3.0-only

{teddy_cli-0.1.17.dev1407 → teddy_cli-0.1.17.dev1409}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "teddy-cli"
-version = "0.1.17.dev1407"
+version = "0.1.17.dev1409"
 description = "The local-first, test-driven agentic engineering harness. Because you should own the means of development."
 readme = "README.md"
 keywords = [

{teddy_cli-0.1.17.dev1407 → teddy_cli-0.1.17.dev1409}/src/teddy_executor/__main__.py

@@ -193,8 +193,9 @@ def _ensure_project_initialized(container, root_dir: str | None = None) -> None:
             IRepoTreeGenerator,
             factory=lambda: LocalRepoTreeGenerator(
                 root_dir=root,
-                max_depth=c.resolve(IConfigService).get_setting(
-                    "context.max_tree_depth", 4
+                max_depth=c.resolve(IConfigService).get_setting("context.max_depth", 3),
+                max_children=c.resolve(IConfigService).get_setting(
+                    "context.max_children", 20
                 ),
             ),
             scope=Scope.transient,

{teddy_cli-0.1.17.dev1407 → teddy_cli-0.1.17.dev1409}/src/teddy_executor/adapters/outbound/local_repo_tree_generator.py

@@ -6,7 +6,7 @@ from teddy_executor.core.ports.outbound.repo_tree_generator import IRepoTreeGene
 
 logger = logging.getLogger(__name__)
 
-UNREADABLE_MARKER = "[... directory not expanded (unreadable): 0 folders, 0 files]"
+UNREADABLE_MARKER = "[unreadable]"
 
 
 class LocalRepoTreeGenerator(IRepoTreeGenerator):
@@ -18,23 +18,36 @@ class LocalRepoTreeGenerator(IRepoTreeGenerator):
     def __init__(
         self,
         root_dir: str = ".",
-        max_depth: int = DEFAULT_APP_CONFIG.context.max_tree_depth,
+        max_depth: int = DEFAULT_APP_CONFIG.context.max_depth,
+        max_children: int = DEFAULT_APP_CONFIG.context.max_children,
     ):
         from teddy_executor.adapters.outbound.filesystem_helpers import (
             load_ignore_spec,
         )
 
         assert max_depth >= 0, f"max_depth must be non-negative, got {max_depth}"
+        assert max_children >= 1, f"max_children must be positive, got {max_children}"
         self.root_dir = Path(root_dir).resolve()
         self.ignore_spec = load_ignore_spec(self.root_dir)
         self._max_depth = max_depth
+        self._max_children = max_children
+
+    @property
+    def max_depth(self) -> int:
+        """The configured maximum directory nesting depth."""
+        return self._max_depth
+
+    @property
+    def max_children(self) -> int:
+        """The configured maximum visible entries per non-root directory."""
+        return self._max_children
 
     def generate_tree(self) -> str:
         """
         Generates a string representation of the file tree in a single pass.
         """
         sections: list[tuple[str, str, list[str]]] = []
-        root_names = self._collect_directory(self.root_dir, "", sections)
+        root_names = self._collect_directory(self.root_dir, "", sections, is_root=True)
         # Sections sort by their relative path, and the root resolves to ".",
         # so a top-level name below "." (for example "!important") renders
         # before the root block. The "." key preserves that exact order.
@@ -57,26 +70,34 @@ class LocalRepoTreeGenerator(IRepoTreeGenerator):
         relative_path: str,
         sections: list[tuple[str, str, list[str]]],
         depth: int = 0,
+        is_root: bool = False,
     ) -> list[str]:
         """
         Collects one directory's visible names and recurses into its children.
 
-        A directory at or beyond the configured depth limit renders one
-        omission marker instead of expanding, so truncation is never silent.
-        An unreadable directory renders an explicit marker rather than an
-        empty section, so it never looks like a readable empty directory.
-        Directory and symlink flags come from the scan cache, so each entry
-        costs no additional stat call. Symlinks are listed as files and are
-        never followed, which keeps circular links from recursing.
+        One scan supplies both limits. A directory at or beyond the configured
+        depth limit renders one compact count notice instead of expanding, so
+        truncation is never silent. A non-root directory holding more visible
+        entries than the width cap renders the same notice and withholds its
+        descendants, because names without their parent folder cannot be
+        mapped. The project root is exempt from the width cap, because it is
+        the only place where a top-level file is named. An unreadable directory
+        renders an explicit marker rather than an empty section, so it never
+        looks like a readable empty directory. Directory and symlink flags come
+        from the scan cache, so each entry costs no additional stat call.
+        Symlinks are listed as files and are never followed, which keeps
+        circular links from recursing.
         """
         if depth >= self._max_depth:
-            marker = self._depth_limit_marker(directory, relative_path)
-            return [marker] if marker else []
+            return self._omission_notice(directory, relative_path)
 
         entries = self._scan_visible_entries(directory, relative_path)
         if entries is None:
             return [UNREADABLE_MARKER]
 
+        if not is_root and len(entries) > self._max_children:
+            return [self._compact_notice(entries)]
+
         names: list[str] = []
         for entry, is_directory, child_path in entries:
             names.append(entry.name)
@@ -119,25 +140,27 @@ class LocalRepoTreeGenerator(IRepoTreeGenerator):
             visible.append((entry, is_directory, child_path))
         return visible
 
-    def _depth_limit_marker(self, directory: str | Path, relative_path: str) -> str:
+    def _omission_notice(self, directory: str | Path, relative_path: str) -> list[str]:
         """
-        Renders the omission marker for a directory at the depth limit.
+        Renders the compact notice for a directory at the depth limit.
 
         Counts only the visible immediate children after ignore rules. An
-        unreadable directory renders the unreadable marker instead. Returns an
-        empty string when no child is visible, so a genuinely empty directory
-        renders no section rather than a misleading marker.
+        unreadable directory renders the unreadable marker instead, and a
+        directory with no visible child renders nothing, so a genuinely empty
+        directory is not shown as an omission.
         """
         entries = self._scan_visible_entries(directory, relative_path)
         if entries is None:
-            return UNREADABLE_MARKER
+            return [UNREADABLE_MARKER]
+        if not entries:
+            return []
+        return [self._compact_notice(entries)]
+
+    @staticmethod
+    def _compact_notice(entries: list[tuple[os.DirEntry, bool, str]]) -> str:
+        """Render the compact ``[X folders, Y files]`` notice for ``entries``."""
         folders = sum(1 for _entry, is_directory, _path in entries if is_directory)
         files = len(entries) - folders
-        if not folders and not files:
-            return ""
         folder_noun = "folder" if folders == 1 else "folders"
         file_noun = "file" if files == 1 else "files"
-        return (
-            f"[... directory not expanded (depth limit {self._max_depth}): "
-            f"{folders} {folder_noun}, {files} {file_noun}]"
-        )
+        return f"[{folders} {folder_noun}, {files} {file_noun}]"

{teddy_cli-0.1.17.dev1407 → teddy_cli-0.1.17.dev1409}/src/teddy_executor/core/domain/models/config_schema.py

@@ -44,7 +44,8 @@ class ReadConfig:
 
 @dataclass(frozen=True)
 class ContextConfig:
-    max_tree_depth: int = 4
+    max_depth: int = 3
+    max_children: int = 20
 
 
 @dataclass(frozen=True)
@@ -210,7 +211,8 @@ _SCHEMA_FIELDS: tuple[_FieldSpec, ...] = (
     _FieldSpec("workspace.pre-commit", "workspace", "pre_commit", bool),
     _FieldSpec("workspace.pull", "workspace", "pull", bool),
     _FieldSpec("read.max_lines", "read", "max_lines", int, minimum=1),
-    _FieldSpec("context.max_tree_depth", "context", "max_tree_depth", int, minimum=0),
+    _FieldSpec("context.max_depth", "context", "max_depth", int, minimum=0),
+    _FieldSpec("context.max_children", "context", "max_children", int, minimum=1),
     _FieldSpec("research.max_results", "research", "max_results", int, minimum=1),
     _FieldSpec("checks.prompts", "checks", "prompts", bool),
     _FieldSpec("checks.templates", "checks", "templates", bool),

{teddy_cli-0.1.17.dev1407 → teddy_cli-0.1.17.dev1409}/src/teddy_executor/core/ports/outbound/repo_tree_generator.py

@@ -6,6 +6,16 @@ class IRepoTreeGenerator(Protocol):
     Outbound Port for generating a repository file tree.
     """
 
+    @property
+    def max_depth(self) -> int:
+        """The maximum directory nesting depth rendered in the tree."""
+        ...
+
+    @property
+    def max_children(self) -> int:
+        """The maximum visible entries listed for a non-root directory."""
+        ...
+
     def generate_tree(self) -> str:
         """
         Generates a string representation of the file tree,

{teddy_cli-0.1.17.dev1407 → teddy_cli-0.1.17.dev1409}/src/teddy_executor/core/services/context_service.py

@@ -371,6 +371,7 @@ class ContextService(IGetContextUseCase):
             "\n## Git Status",
             git_status_body,
             "\n## Project Structure",
+            self._format_tree_subtitle(),
             f"```\n{repo_tree}\n```",
         ]
 
@@ -388,6 +389,14 @@ class ContextService(IGetContextUseCase):
 
         return "\n".join(content_parts)
 
+    def _format_tree_subtitle(self) -> str:
+        """State both tree limits once, so the compact notices stay meaningful."""
+        return (
+            f"*Tree capped at depth {self._repo_tree_generator.max_depth} "
+            f"and width {self._repo_tree_generator.max_children}: "
+            "truncated directories show counts only.*"
+        )
+
     def _format_workspace_contents(
         self,
         workspace_paths: List[str],

{teddy_cli-0.1.17.dev1407 → teddy_cli-0.1.17.dev1409}/src/teddy_executor/registries/infrastructure.py

@@ -147,8 +147,12 @@ def register_infrastructure(container: punq.Container) -> None:
         IRepoTreeGenerator,
         factory=lambda: LocalRepoTreeGenerator(
             max_depth=container.resolve(IConfigService).get_setting(
-                "context.max_tree_depth", DEFAULT_APP_CONFIG.context.max_tree_depth
-            )
+                "context.max_depth", DEFAULT_APP_CONFIG.context.max_depth
+            ),
+            max_children=container.resolve(IConfigService).get_setting(
+                "context.max_children",
+                DEFAULT_APP_CONFIG.context.max_children,
+            ),
         ),
         scope=punq.Scope.transient,
     )

{teddy_cli-0.1.17.dev1407 → teddy_cli-0.1.17.dev1409}/src/teddy_executor/resources/config/config.yaml

@@ -10,15 +10,16 @@ edit:
   similarity_threshold: 0.95        # EDIT match threshold (1.0 = exact match; ignores relative indentation).
 
 workspace:
-  init: true         # Initialize a missing Git repository (start and resume).
-  pre-commit: true   # Install pre-commit and post-commit git hooks (start and resume).
-  pull: true         # Fast-forward pull before starting a new session (start only).
+  init: true                        # Initialize a missing Git repository (start and resume).
+  pre-commit: true                  # Install pre-commit and post-commit git hooks (start and resume).
+  pull: true                        # Fast-forward pull before starting a new session (start only).
 
 read:
   max_lines: 1000                   # Caps READ action output lines.
 
 context:
-  max_tree_depth: 4                 # Max project tree depth (0 = omit tree; raise the number to show more levels).
+  max_depth: 3                      # Max project tree depth.
+  max_children: 20                  # Max entries listed per directory.
 
 research:
   max_results: 5                    # Number of search results to fetch and scrape.
@@ -39,15 +40,18 @@ guardrails:                         # Non-interactive limits (--yolo / --pipelin
 auto_pruning:
   enabled: true
   turn_context_threshold: 50000     # Token budget for turn-scoped files only (excludes session.context & system prompts).
-  prune_failure_history: true      # Prunes non-green turns once recovery succeeds.
+  prune_failure_history: true       # Prunes non-green turns once recovery succeeds.
   prune_validation_failures: true   # Prunes malformed turns that failed validation.
   preserve_message_turns: true      # Preserves user-communicating turns from pruning.
   max_turns_retention: 10           # Max historical turns retained in turn context.
 
 # LiteLLM reference: https://docs.litellm.ai/docs/completion/input (all keys under llm pass directly to litellm).
+# OpenRouter syntax: "openrouter/<slug>" (:nitro=fastest, :floor=cheapest).
+# ${TEDDY_LLM_API_KEY} resolves from .teddy/.env or shell environment.
+
 llm:
-  model: "openrouter/~deepseek/deepseek-flash-latest:nitro"  # OpenRouter syntax: "openrouter/<slug>" (:nitro=fast, :floor=cheap).
-  api_key: "${TEDDY_LLM_API_KEY}"                           # Resolves from .teddy/.env or shell environment.
+  model: "openrouter/~deepseek/deepseek-flash-latest:nitro"
+  api_key: "${TEDDY_LLM_API_KEY}"
   max_retries: 3
   timeout: 300
   extra_headers: