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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: teddy-cli
-Version: 0.1.17.dev1408
+Version: 0.1.17.dev1410
 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
@@ -159,7 +159,7 @@ TeDDy is built on the belief that you should own your software delivery lifecycl
 
 - **High-Level Governance Rules (`PROJECT.md` & `ARCHITECTURE.md`):** The simplest way to guide agents. Define product roadmaps, engineering principles, system laws, and component boundaries in living Markdown documents that agents read on every turn.
 - **Artifact Templates (`docs/templates/`):** Standardize the artifacts produced during development. Customize the Markdown templates for vertical slices, specifications, case files, and milestones to match your documentation standards.
-- **Agent Prompts (`.teddy/prompts/`):** To change the process itself, customize the agent prompts. Each agent's workflow is broken down into structured phases and individual steps, defined entirely in Markdown. You can tweak instructions, add domain-specific quality gates, or introduce brand-new agent personas to match how your team builds software.
+- **Agent Prompts (`.teddy/prompts/`):** To change the process itself, customize the agent prompts. Each agent's workflow is broken down into structured phases and individual steps, defined entirely in Markdown. You can tweak instructions, add domain-specific quality gates, or introduce brand-new agent personas to match how your team builds software. TeDDy assembles each system prompt from two layers: the agent-specific instructions come first and the shared response protocol instructions are appended automatically. The composed prompt is saved in the session folder, and `teddy get-prompt <agent>` prints the identical result, so you can read exactly what the model receives. A customized prompt that already carries its own `<response_format>` suppresses the shared block and is used as-is.
 - **Command Automation (`Makefile`):** Instead of hardcoding shell commands inside agent prompts, common development and verification operations are routed through the Makefile. When you need to change a flag, runner, or environment setup, you change it once in the Makefile instead of updating instructions across multiple agent prompts.
 - **Context Filtering (`.teddyignore`):** Control which files TeDDy scans during context generation and tree traversal. A `.teddyignore` file in the project root follows standard ignore syntax and takes precedence over `.gitignore`, allowing you to ignore extra paths or re-include git-ignored files using negation patterns.
 
@@ -270,17 +270,17 @@ teddy resume -m "your next instruction"
 
 ### Optional Flags
 
-| Flag | Description |
-| :--- | :--- |
-| <nobr>`--agent`, `-a`</nobr> | Select agent persona (`pathfinder`, `architect`, `developer`, `debugger`, `assistant`). Default: `pathfinder` (`assistant` in pipeline mode). |
-| <nobr>`--context`, `-c`</nobr> | Supply additional context files or directories. Repeatable (`-c a.py -c b.md`) or comma-separated (`-c "a.py,b.md"`). |
-| <nobr>`--model`</nobr> | Override the default configured model. |
-| <nobr>`--yolo`, `-y`</nobr> | Auto-approve all actions. To make this default, set `yolo_default: true` in `.teddy/config.yaml`. |
-| <nobr>`--no-yolo`, `-n`</nobr> | Force interactive mode for a single run. |
-| <nobr>`--message`, `-m`</nobr> | Initial instruction to pass directly to the agent. |
-| <nobr>`--pipeline`, `-p`</nobr> | Pipeline mode. Auto-approves actions, requires `-m`, exits immediately after the first message turn, and defaults to the `assistant` agent. |
-| <nobr>`--max-turns`</nobr> | Maximum turns for a non-interactive run. Overrides `guardrails.max_turns` in `.teddy/config.yaml`. |
-| <nobr>`--max-cost`</nobr> | Maximum session cost in dollars for a non-interactive run. Overrides `guardrails.max_session_cost` in `.teddy/config.yaml`. |
+| Flag                            | Description                                                                                                                                   |
+| :------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------- |
+| <nobr>`--agent`, `-a`</nobr>    | Select agent persona (`pathfinder`, `architect`, `developer`, `debugger`, `assistant`). Default: `pathfinder` (`assistant` in pipeline mode). |
+| <nobr>`--context`, `-c`</nobr>  | Supply additional context files or directories. Repeatable (`-c a.py -c b.md`) or comma-separated (`-c "a.py,b.md"`).                         |
+| <nobr>`--model`</nobr>          | Override the default configured model.                                                                                                        |
+| <nobr>`--yolo`, `-y`</nobr>     | Auto-approve all actions. To make this default, set `yolo_default: true` in `.teddy/config.yaml`.                                             |
+| <nobr>`--no-yolo`, `-n`</nobr>  | Force interactive mode for a single run.                                                                                                      |
+| <nobr>`--message`, `-m`</nobr>  | Initial instruction to pass directly to the agent.                                                                                            |
+| <nobr>`--pipeline`, `-p`</nobr> | Pipeline mode. Auto-approves actions, requires `-m`, exits immediately after the first message turn, and defaults to the `assistant` agent.   |
+| <nobr>`--max-turns`</nobr>      | Maximum turns for a non-interactive run. Overrides `guardrails.max_turns` in `.teddy/config.yaml`.                                            |
+| <nobr>`--max-cost`</nobr>       | Maximum session cost in dollars for a non-interactive run. Overrides `guardrails.max_session_cost` in `.teddy/config.yaml`.                   |
 
 ### Chat-Oriented Workflow (CHOP)
 
@@ -323,18 +323,18 @@ teddy context -c review.context
 
 ## Command Reference
 
-| Command                       | Description                                                                  |
-| :---------------------------- | :--------------------------------------------------------------------------- |
-| `init`                        | Initialize `.teddy` workspace with defaults and pre-warm dependencies.       |
-| <nobr>`init prompts`</nobr>   | Overwrite bundled prompt Markdown files in `.teddy/prompts/` with defaults.  |
-| <nobr>`init config`</nobr>    | Overwrite `config.yaml`, `.gitignore`, and `init.context` with defaults.     |
-| <nobr>`init templates`</nobr> | Overwrite bundled Markdown templates in `docs/templates/` with defaults.     |
-| `start`                       | Start an interactive agent session.                                          |
-| `resume`                      | Resume an existing session.                                                  |
-| `update`                      | Check for updates and display upgrade instructions.                          |
-| `execute`                     | Execute a Markdown plan (reads from clipboard if no path is provided).       |
+| Command                       | Description                                                                                                                              |
+| :---------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------- |
+| `init`                        | Initialize `.teddy` workspace with defaults and pre-warm dependencies.                                                                   |
+| <nobr>`init prompts`</nobr>   | Overwrite bundled prompt Markdown files in `.teddy/prompts/` with defaults.                                                              |
+| <nobr>`init config`</nobr>    | Overwrite `config.yaml`, `.gitignore`, and `init.context` with defaults.                                                                 |
+| <nobr>`init templates`</nobr> | Overwrite bundled Markdown templates in `docs/templates/` with defaults.                                                                 |
+| `start`                       | Start an interactive agent session.                                                                                                      |
+| `resume`                      | Resume an existing session.                                                                                                              |
+| `update`                      | Check for updates and display upgrade instructions.                                                                                      |
+| `execute`                     | Execute a Markdown plan (reads from clipboard if no path is provided).                                                                   |
 | `context`                     | Export context payload (system info, git status, file tree, `init.context`). Add ad-hoc files with `-c` and skip defaults with `--only`. |
-| <nobr>`get-prompt`</nobr>     | Retrieve agent system prompts (respects overrides in `.teddy/prompts/`).     |
+| <nobr>`get-prompt`</nobr>     | Print the composed system prompt (agent-specific instructions plus shared `MRP.md`).                                                     |
 
 > [!NOTE]
 > By default, `execute` and `context` copy output to the clipboard. Use `--no-copy` to bypass.

{teddy_cli-0.1.17.dev1408 → teddy_cli-0.1.17.dev1410}/README.md

@@ -125,7 +125,7 @@ TeDDy is built on the belief that you should own your software delivery lifecycl
 
 - **High-Level Governance Rules (`PROJECT.md` & `ARCHITECTURE.md`):** The simplest way to guide agents. Define product roadmaps, engineering principles, system laws, and component boundaries in living Markdown documents that agents read on every turn.
 - **Artifact Templates (`docs/templates/`):** Standardize the artifacts produced during development. Customize the Markdown templates for vertical slices, specifications, case files, and milestones to match your documentation standards.
-- **Agent Prompts (`.teddy/prompts/`):** To change the process itself, customize the agent prompts. Each agent's workflow is broken down into structured phases and individual steps, defined entirely in Markdown. You can tweak instructions, add domain-specific quality gates, or introduce brand-new agent personas to match how your team builds software.
+- **Agent Prompts (`.teddy/prompts/`):** To change the process itself, customize the agent prompts. Each agent's workflow is broken down into structured phases and individual steps, defined entirely in Markdown. You can tweak instructions, add domain-specific quality gates, or introduce brand-new agent personas to match how your team builds software. TeDDy assembles each system prompt from two layers: the agent-specific instructions come first and the shared response protocol instructions are appended automatically. The composed prompt is saved in the session folder, and `teddy get-prompt <agent>` prints the identical result, so you can read exactly what the model receives. A customized prompt that already carries its own `<response_format>` suppresses the shared block and is used as-is.
 - **Command Automation (`Makefile`):** Instead of hardcoding shell commands inside agent prompts, common development and verification operations are routed through the Makefile. When you need to change a flag, runner, or environment setup, you change it once in the Makefile instead of updating instructions across multiple agent prompts.
 - **Context Filtering (`.teddyignore`):** Control which files TeDDy scans during context generation and tree traversal. A `.teddyignore` file in the project root follows standard ignore syntax and takes precedence over `.gitignore`, allowing you to ignore extra paths or re-include git-ignored files using negation patterns.
 
@@ -236,17 +236,17 @@ teddy resume -m "your next instruction"
 
 ### Optional Flags
 
-| Flag | Description |
-| :--- | :--- |
-| <nobr>`--agent`, `-a`</nobr> | Select agent persona (`pathfinder`, `architect`, `developer`, `debugger`, `assistant`). Default: `pathfinder` (`assistant` in pipeline mode). |
-| <nobr>`--context`, `-c`</nobr> | Supply additional context files or directories. Repeatable (`-c a.py -c b.md`) or comma-separated (`-c "a.py,b.md"`). |
-| <nobr>`--model`</nobr> | Override the default configured model. |
-| <nobr>`--yolo`, `-y`</nobr> | Auto-approve all actions. To make this default, set `yolo_default: true` in `.teddy/config.yaml`. |
-| <nobr>`--no-yolo`, `-n`</nobr> | Force interactive mode for a single run. |
-| <nobr>`--message`, `-m`</nobr> | Initial instruction to pass directly to the agent. |
-| <nobr>`--pipeline`, `-p`</nobr> | Pipeline mode. Auto-approves actions, requires `-m`, exits immediately after the first message turn, and defaults to the `assistant` agent. |
-| <nobr>`--max-turns`</nobr> | Maximum turns for a non-interactive run. Overrides `guardrails.max_turns` in `.teddy/config.yaml`. |
-| <nobr>`--max-cost`</nobr> | Maximum session cost in dollars for a non-interactive run. Overrides `guardrails.max_session_cost` in `.teddy/config.yaml`. |
+| Flag                            | Description                                                                                                                                   |
+| :------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------- |
+| <nobr>`--agent`, `-a`</nobr>    | Select agent persona (`pathfinder`, `architect`, `developer`, `debugger`, `assistant`). Default: `pathfinder` (`assistant` in pipeline mode). |
+| <nobr>`--context`, `-c`</nobr>  | Supply additional context files or directories. Repeatable (`-c a.py -c b.md`) or comma-separated (`-c "a.py,b.md"`).                         |
+| <nobr>`--model`</nobr>          | Override the default configured model.                                                                                                        |
+| <nobr>`--yolo`, `-y`</nobr>     | Auto-approve all actions. To make this default, set `yolo_default: true` in `.teddy/config.yaml`.                                             |
+| <nobr>`--no-yolo`, `-n`</nobr>  | Force interactive mode for a single run.                                                                                                      |
+| <nobr>`--message`, `-m`</nobr>  | Initial instruction to pass directly to the agent.                                                                                            |
+| <nobr>`--pipeline`, `-p`</nobr> | Pipeline mode. Auto-approves actions, requires `-m`, exits immediately after the first message turn, and defaults to the `assistant` agent.   |
+| <nobr>`--max-turns`</nobr>      | Maximum turns for a non-interactive run. Overrides `guardrails.max_turns` in `.teddy/config.yaml`.                                            |
+| <nobr>`--max-cost`</nobr>       | Maximum session cost in dollars for a non-interactive run. Overrides `guardrails.max_session_cost` in `.teddy/config.yaml`.                   |
 
 ### Chat-Oriented Workflow (CHOP)
 
@@ -289,18 +289,18 @@ teddy context -c review.context
 
 ## Command Reference
 
-| Command                       | Description                                                                  |
-| :---------------------------- | :--------------------------------------------------------------------------- |
-| `init`                        | Initialize `.teddy` workspace with defaults and pre-warm dependencies.       |
-| <nobr>`init prompts`</nobr>   | Overwrite bundled prompt Markdown files in `.teddy/prompts/` with defaults.  |
-| <nobr>`init config`</nobr>    | Overwrite `config.yaml`, `.gitignore`, and `init.context` with defaults.     |
-| <nobr>`init templates`</nobr> | Overwrite bundled Markdown templates in `docs/templates/` with defaults.     |
-| `start`                       | Start an interactive agent session.                                          |
-| `resume`                      | Resume an existing session.                                                  |
-| `update`                      | Check for updates and display upgrade instructions.                          |
-| `execute`                     | Execute a Markdown plan (reads from clipboard if no path is provided).       |
+| Command                       | Description                                                                                                                              |
+| :---------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------- |
+| `init`                        | Initialize `.teddy` workspace with defaults and pre-warm dependencies.                                                                   |
+| <nobr>`init prompts`</nobr>   | Overwrite bundled prompt Markdown files in `.teddy/prompts/` with defaults.                                                              |
+| <nobr>`init config`</nobr>    | Overwrite `config.yaml`, `.gitignore`, and `init.context` with defaults.                                                                 |
+| <nobr>`init templates`</nobr> | Overwrite bundled Markdown templates in `docs/templates/` with defaults.                                                                 |
+| `start`                       | Start an interactive agent session.                                                                                                      |
+| `resume`                      | Resume an existing session.                                                                                                              |
+| `update`                      | Check for updates and display upgrade instructions.                                                                                      |
+| `execute`                     | Execute a Markdown plan (reads from clipboard if no path is provided).                                                                   |
 | `context`                     | Export context payload (system info, git status, file tree, `init.context`). Add ad-hoc files with `-c` and skip defaults with `--only`. |
-| <nobr>`get-prompt`</nobr>     | Retrieve agent system prompts (respects overrides in `.teddy/prompts/`).     |
+| <nobr>`get-prompt`</nobr>     | Print the composed system prompt (agent-specific instructions plus shared `MRP.md`).                                                     |
 
 > [!NOTE]
 > By default, `execute` and `context` copy output to the clipboard. Use `--no-copy` to bypass.

{teddy_cli-0.1.17.dev1408 → teddy_cli-0.1.17.dev1410}/pyproject.toml

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

@@ -193,11 +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", 3
-                ),
-                max_tree_width=c.resolve(IConfigService).get_setting(
-                    "context.max_tree_width", 20
+                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.dev1408 → teddy_cli-0.1.17.dev1410}/src/teddy_executor/adapters/outbound/local_repo_tree_generator.py

@@ -18,21 +18,19 @@ class LocalRepoTreeGenerator(IRepoTreeGenerator):
     def __init__(
         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,
+        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_tree_width >= 1, (
-            f"max_tree_width must be positive, got {max_tree_width}"
-        )
+        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_tree_width = max_tree_width
+        self._max_children = max_children
 
     @property
     def max_depth(self) -> int:
@@ -40,9 +38,9 @@ class LocalRepoTreeGenerator(IRepoTreeGenerator):
         return self._max_depth
 
     @property
-    def max_tree_width(self) -> int:
+    def max_children(self) -> int:
         """The configured maximum visible entries per non-root directory."""
-        return self._max_tree_width
+        return self._max_children
 
     def generate_tree(self) -> str:
         """
@@ -97,7 +95,7 @@ class LocalRepoTreeGenerator(IRepoTreeGenerator):
         if entries is None:
             return [UNREADABLE_MARKER]
 
-        if not is_root and len(entries) > self._max_tree_width:
+        if not is_root and len(entries) > self._max_children:
             return [self._compact_notice(entries)]
 
         names: list[str] = []

{teddy_cli-0.1.17.dev1408 → teddy_cli-0.1.17.dev1410}/src/teddy_executor/core/domain/models/config_schema.py

@@ -44,8 +44,8 @@ class ReadConfig:
 
 @dataclass(frozen=True)
 class ContextConfig:
-    max_tree_depth: int = 3
-    max_tree_width: int = 20
+    max_depth: int = 3
+    max_children: int = 20
 
 
 @dataclass(frozen=True)
@@ -211,8 +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_tree_width", "context", "max_tree_width", int, minimum=1),
+    _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.dev1408 → teddy_cli-0.1.17.dev1410}/src/teddy_executor/core/ports/outbound/repo_tree_generator.py

@@ -12,7 +12,7 @@ class IRepoTreeGenerator(Protocol):
         ...
 
     @property
-    def max_tree_width(self) -> int:
+    def max_children(self) -> int:
         """The maximum visible entries listed for a non-root directory."""
         ...
 

{teddy_cli-0.1.17.dev1408 → teddy_cli-0.1.17.dev1410}/src/teddy_executor/core/services/context_service.py

@@ -393,7 +393,7 @@ class ContextService(IGetContextUseCase):
         """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}: "
+            f"and width {self._repo_tree_generator.max_children}: "
             "truncated directories show counts only.*"
         )
 

{teddy_cli-0.1.17.dev1408 → teddy_cli-0.1.17.dev1410}/src/teddy_executor/registries/infrastructure.py

@@ -147,11 +147,11 @@ 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_tree_width=container.resolve(IConfigService).get_setting(
-                "context.max_tree_width",
-                DEFAULT_APP_CONFIG.context.max_tree_width,
+            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.dev1408 → teddy_cli-0.1.17.dev1410}/src/teddy_executor/resources/config/config.yaml

@@ -10,16 +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: 3                 # Max project tree depth.
-  max_tree_width: 20                # Max entries listed per directory.
+  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.
@@ -40,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: