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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: teddy-cli
-Version: 0.1.17.dev1407
+Version: 0.1.17.dev1408
 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.dev1408}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "teddy-cli"
-version = "0.1.17.dev1407"
+version = "0.1.17.dev1408"
 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.dev1408}/src/teddy_executor/__main__.py

@@ -194,7 +194,10 @@ def _ensure_project_initialized(container, root_dir: str | None = None) -> None:
             factory=lambda: LocalRepoTreeGenerator(
                 root_dir=root,
                 max_depth=c.resolve(IConfigService).get_setting(
-                    "context.max_tree_depth", 4
+                    "context.max_tree_depth", 3
+                ),
+                max_tree_width=c.resolve(IConfigService).get_setting(
+                    "context.max_tree_width", 20
                 ),
             ),
             scope=Scope.transient,

{teddy_cli-0.1.17.dev1407 → teddy_cli-0.1.17.dev1408}/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):
@@ -19,22 +19,37 @@ class LocalRepoTreeGenerator(IRepoTreeGenerator):
         self,
         root_dir: str = ".",
         max_depth: int = DEFAULT_APP_CONFIG.context.max_tree_depth,
+        max_tree_width: int = DEFAULT_APP_CONFIG.context.max_tree_width,
     ):
         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_tree_width >= 1, (
+            f"max_tree_width must be positive, got {max_tree_width}"
+        )
         self.root_dir = Path(root_dir).resolve()
         self.ignore_spec = load_ignore_spec(self.root_dir)
         self._max_depth = max_depth
+        self._max_tree_width = max_tree_width
+
+    @property
+    def max_depth(self) -> int:
+        """The configured maximum directory nesting depth."""
+        return self._max_depth
+
+    @property
+    def max_tree_width(self) -> int:
+        """The configured maximum visible entries per non-root directory."""
+        return self._max_tree_width
 
     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 +72,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_tree_width:
+            return [self._compact_notice(entries)]
+
         names: list[str] = []
         for entry, is_directory, child_path in entries:
             names.append(entry.name)
@@ -119,25 +142,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.dev1408}/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_tree_depth: int = 3
+    max_tree_width: int = 20
 
 
 @dataclass(frozen=True)
@@ -211,6 +212,7 @@ _SCHEMA_FIELDS: tuple[_FieldSpec, ...] = (
     _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_tree_width", "context", "max_tree_width", 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.dev1408}/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_tree_width(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.dev1408}/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_tree_width}: "
+            "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.dev1408}/src/teddy_executor/registries/infrastructure.py

@@ -148,7 +148,11 @@ def register_infrastructure(container: punq.Container) -> None:
         factory=lambda: LocalRepoTreeGenerator(
             max_depth=container.resolve(IConfigService).get_setting(
                 "context.max_tree_depth", DEFAULT_APP_CONFIG.context.max_tree_depth
-            )
+            ),
+            max_tree_width=container.resolve(IConfigService).get_setting(
+                "context.max_tree_width",
+                DEFAULT_APP_CONFIG.context.max_tree_width,
+            ),
         ),
         scope=punq.Scope.transient,
     )

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

@@ -18,7 +18,8 @@ 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_tree_depth: 3                 # Max project tree depth.
+  max_tree_width: 20                # Max entries listed per directory.
 
 research:
   max_results: 5                    # Number of search results to fetch and scrape.