teddy-cli 0.1.17.dev1377__tar.gz → 0.1.17.dev1379__tar.gz

{teddy_cli-0.1.17.dev1377 → teddy_cli-0.1.17.dev1379}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: teddy-cli
-Version: 0.1.17.dev1377
+Version: 0.1.17.dev1379
 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
@@ -52,7 +52,7 @@ uv tool install teddy-cli
   <img src="./assets/demo.gif" alt="TeDDy TUI Demo" width="100%" style="max-width: 100%; height: auto;" />
 </p>
 
-[Why TeDDy?](#why-not-just-use) &bull; [TeDDy's SDLC](#teddys-software-delivery-lifecycle) &bull; [Owning Your SDLC](#owning-your-sdlc) &bull; [Quickstart](#getting-started) &bull; [Usage](#usage) &bull; [FAQ](#frequently-asked-questions)
+[Why TeDDy?](#why-not-just-use) &bull; [TeDDy's SDLC](#teddys-software-delivery-lifecycle) &bull; [Owning Your SDLC](#owning-your-sdlc) &bull; [Quickstart](#getting-started) &bull; [Usage](#usage) &bull; [FAQ](#frequently-asked-questions) &bull; [Support](#support)
 
 </div>
 
@@ -161,10 +161,11 @@ TeDDy is built on the belief that you should own your software delivery lifecycl
 - **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.
 - **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.
 
 > [!TIP]
 > *Interested in bringing TeDDy into your team or designing custom agent workflows?* <br>
-> **[Professional consulting is available!](mailto:raphael@atteritano.ch)**
+> **[Professional consulting is available!](#support)**
 
 ---
 
@@ -269,15 +270,17 @@ teddy resume -m "your next instruction"
 
 ### Optional Flags
 
-- `--agent` / `-a`: Select agent persona (`pathfinder`, `architect`, `developer`, `debugger`, `assistant`). Default: `pathfinder` (`assistant` in pipeline mode).
-- `--context` / `-c`: Supply additional context files or directories. Repeatable (`-c a.py -c b.md`) or comma-separated (`-c "a.py,b.md"`).
-- `--model`: Override the default configured model.
-- `--yolo` / `-y`: Auto-approve all actions. To make this default, set `yolo_default: true` in `.teddy/config.yaml`.
-- `--no-yolo` / `-n`: Force interactive mode for a single run.
-- `--message` / `-m`: Initial instruction to pass directly to the agent.
-- `--pipeline` / `-p`: Pipeline mode. Auto-approves actions, requires `-m`, exits immediately after the first message turn, and defaults to the `assistant` agent.
-- `--max-turns`: Maximum turns for a non-interactive run. Overrides `guardrails.max_turns` in `.teddy/config.yaml`.
-- `--max-cost`: Maximum session cost in dollars for a non-interactive run. Overrides `guardrails.max_session_cost` in `.teddy/config.yaml`.
+| Flag               | Description                                                                                                                                   |
+| :----------------- | :-------------------------------------------------------------------------------------------------------------------------------------------- |
+| `--agent`, `-a`    | Select agent persona (`pathfinder`, `architect`, `developer`, `debugger`, `assistant`). Default: `pathfinder` (`assistant` in pipeline mode). |
+| `--context`, `-c`  | Supply additional context files or directories. Repeatable (`-c a.py -c b.md`) or comma-separated (`-c "a.py,b.md"`).                         |
+| `--model`          | Override the default configured model.                                                                                                        |
+| `--yolo`, `-y`     | Auto-approve all actions. To make this default, set `yolo_default: true` in `.teddy/config.yaml`.                                             |
+| `--no-yolo`, `-n`  | Force interactive mode for a single run.                                                                                                      |
+| `--message`, `-m`  | Initial instruction to pass directly to the agent.                                                                                            |
+| `--pipeline`, `-p` | Pipeline mode. Auto-approves actions, requires `-m`, exits immediately after the first message turn, and defaults to the `assistant` agent.   |
+| `--max-turns`      | Maximum turns for a non-interactive run. Overrides `guardrails.max_turns` in `.teddy/config.yaml`.                                            |
+| `--max-cost`       | Maximum session cost in dollars for a non-interactive run. Overrides `guardrails.max_session_cost` in `.teddy/config.yaml`.                   |
 
 ### Chat-Oriented Workflow (CHOP)
 
@@ -376,14 +379,16 @@ The tool itself is not monetized. If your team needs custom agent architectures,
 
 ---
 
-<div align="center">
-
-### Star TeDDy on GitHub
+<div align="center" id="support">
 
-If you find TeDDy useful for your workflow, consider giving it a star. It helps other developers find the project.
+### Support
 
-[![GitHub stars](https://img.shields.io/github/stars/atte500/teddy?style=social)](https://github.com/atte500/teddy)
+If you find TeDDy useful, consider giving it a star!
 
-Need custom agent architectures or team onboarding? **[Let's get in touch!](mailto:raphael@atteritano.ch)**
+<p align="center">
+  <a href="https://github.com/atte500/teddy"><img src="https://img.shields.io/github/stars/atte500/teddy?style=flat-square&logo=github&label=Star%20TeDDy" alt="GitHub stars" /></a>
+  <a href="https://www.youtube.com/@xCogito-tv"><img src="https://img.shields.io/badge/YouTube-@xCogito--tv-red?style=flat-square&logo=youtube" alt="YouTube" /></a>
+  <a href="mailto:raphael@atteritano.ch"><img src="https://img.shields.io/badge/Email-raphael%40atteritano.ch-blue?style=flat-square&logo=gmail" alt="Email" /></a>
+</p>
 
 </div>

{teddy_cli-0.1.17.dev1377 → teddy_cli-0.1.17.dev1379}/README.md

@@ -18,7 +18,7 @@ uv tool install teddy-cli
   <img src="./assets/demo.gif" alt="TeDDy TUI Demo" width="100%" style="max-width: 100%; height: auto;" />
 </p>
 
-[Why TeDDy?](#why-not-just-use) &bull; [TeDDy's SDLC](#teddys-software-delivery-lifecycle) &bull; [Owning Your SDLC](#owning-your-sdlc) &bull; [Quickstart](#getting-started) &bull; [Usage](#usage) &bull; [FAQ](#frequently-asked-questions)
+[Why TeDDy?](#why-not-just-use) &bull; [TeDDy's SDLC](#teddys-software-delivery-lifecycle) &bull; [Owning Your SDLC](#owning-your-sdlc) &bull; [Quickstart](#getting-started) &bull; [Usage](#usage) &bull; [FAQ](#frequently-asked-questions) &bull; [Support](#support)
 
 </div>
 
@@ -127,10 +127,11 @@ TeDDy is built on the belief that you should own your software delivery lifecycl
 - **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.
 - **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.
 
 > [!TIP]
 > *Interested in bringing TeDDy into your team or designing custom agent workflows?* <br>
-> **[Professional consulting is available!](mailto:raphael@atteritano.ch)**
+> **[Professional consulting is available!](#support)**
 
 ---
 
@@ -235,15 +236,17 @@ teddy resume -m "your next instruction"
 
 ### Optional Flags
 
-- `--agent` / `-a`: Select agent persona (`pathfinder`, `architect`, `developer`, `debugger`, `assistant`). Default: `pathfinder` (`assistant` in pipeline mode).
-- `--context` / `-c`: Supply additional context files or directories. Repeatable (`-c a.py -c b.md`) or comma-separated (`-c "a.py,b.md"`).
-- `--model`: Override the default configured model.
-- `--yolo` / `-y`: Auto-approve all actions. To make this default, set `yolo_default: true` in `.teddy/config.yaml`.
-- `--no-yolo` / `-n`: Force interactive mode for a single run.
-- `--message` / `-m`: Initial instruction to pass directly to the agent.
-- `--pipeline` / `-p`: Pipeline mode. Auto-approves actions, requires `-m`, exits immediately after the first message turn, and defaults to the `assistant` agent.
-- `--max-turns`: Maximum turns for a non-interactive run. Overrides `guardrails.max_turns` in `.teddy/config.yaml`.
-- `--max-cost`: Maximum session cost in dollars for a non-interactive run. Overrides `guardrails.max_session_cost` in `.teddy/config.yaml`.
+| Flag               | Description                                                                                                                                   |
+| :----------------- | :-------------------------------------------------------------------------------------------------------------------------------------------- |
+| `--agent`, `-a`    | Select agent persona (`pathfinder`, `architect`, `developer`, `debugger`, `assistant`). Default: `pathfinder` (`assistant` in pipeline mode). |
+| `--context`, `-c`  | Supply additional context files or directories. Repeatable (`-c a.py -c b.md`) or comma-separated (`-c "a.py,b.md"`).                         |
+| `--model`          | Override the default configured model.                                                                                                        |
+| `--yolo`, `-y`     | Auto-approve all actions. To make this default, set `yolo_default: true` in `.teddy/config.yaml`.                                             |
+| `--no-yolo`, `-n`  | Force interactive mode for a single run.                                                                                                      |
+| `--message`, `-m`  | Initial instruction to pass directly to the agent.                                                                                            |
+| `--pipeline`, `-p` | Pipeline mode. Auto-approves actions, requires `-m`, exits immediately after the first message turn, and defaults to the `assistant` agent.   |
+| `--max-turns`      | Maximum turns for a non-interactive run. Overrides `guardrails.max_turns` in `.teddy/config.yaml`.                                            |
+| `--max-cost`       | Maximum session cost in dollars for a non-interactive run. Overrides `guardrails.max_session_cost` in `.teddy/config.yaml`.                   |
 
 ### Chat-Oriented Workflow (CHOP)
 
@@ -342,14 +345,16 @@ The tool itself is not monetized. If your team needs custom agent architectures,
 
 ---
 
-<div align="center">
-
-### Star TeDDy on GitHub
+<div align="center" id="support">
 
-If you find TeDDy useful for your workflow, consider giving it a star. It helps other developers find the project.
+### Support
 
-[![GitHub stars](https://img.shields.io/github/stars/atte500/teddy?style=social)](https://github.com/atte500/teddy)
+If you find TeDDy useful, consider giving it a star!
 
-Need custom agent architectures or team onboarding? **[Let's get in touch!](mailto:raphael@atteritano.ch)**
+<p align="center">
+  <a href="https://github.com/atte500/teddy"><img src="https://img.shields.io/github/stars/atte500/teddy?style=flat-square&logo=github&label=Star%20TeDDy" alt="GitHub stars" /></a>
+  <a href="https://www.youtube.com/@xCogito-tv"><img src="https://img.shields.io/badge/YouTube-@xCogito--tv-red?style=flat-square&logo=youtube" alt="YouTube" /></a>
+  <a href="mailto:raphael@atteritano.ch"><img src="https://img.shields.io/badge/Email-raphael%40atteritano.ch-blue?style=flat-square&logo=gmail" alt="Email" /></a>
+</p>
 
 </div>

{teddy_cli-0.1.17.dev1377 → teddy_cli-0.1.17.dev1379}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "teddy-cli"
-version = "0.1.17.dev1377"
+version = "0.1.17.dev1379"
 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.dev1377 → teddy_cli-0.1.17.dev1379}/src/teddy_executor/adapters/outbound/yaml_config_adapter.py

@@ -1,15 +1,67 @@
 import os
 import re
+from collections.abc import Hashable
 from importlib import resources
 from typing import Any, Dict, Optional
 import yaml
 from dotenv import dotenv_values, set_key
+from teddy_executor.core.domain.models.exceptions import ConfigurationError
 from teddy_executor.core.ports.outbound.config_service import IConfigService
 
 _INTERPOLATION_PATTERN = re.compile(
     r"\$\$|\$\{([_A-Za-z][_A-Za-z0-9]*)(?::-([^}]*))?\}"
 )
 
+_MERGE_TAG = "tag:yaml.org,2002:merge"
+
+
+def _strict_load(text: str, source_path: str) -> Any:
+    """Parse ``text`` and reject a repeated mapping key at any depth."""
+
+    class _StrictLoader(yaml.SafeLoader):
+        pass
+
+    def _construct_mapping(
+        loader: yaml.SafeLoader, node: yaml.MappingNode, deep: bool = False
+    ) -> Dict[Any, Any]:
+        if isinstance(node, yaml.MappingNode):
+            seen: set[Any] = set()
+            for key_node, _value_node in node.value:
+                if key_node.tag == _MERGE_TAG:
+                    continue
+                key = loader.construct_object(key_node, deep=True)
+                if not isinstance(key, Hashable):
+                    # An unhashable key is invalid YAML for a mapping. The base
+                    # loader raises its standard error, which the adapter treats
+                    # as an unreadable user config.
+                    continue
+                if key in seen:
+                    line = key_node.start_mark.line + 1
+                    raise ConfigurationError(
+                        f"Duplicate configuration key {key!r} in {source_path} "
+                        f"at line {line}. Remove or rename one occurrence."
+                    )
+                seen.add(key)
+        return yaml.SafeLoader.construct_mapping(loader, node, deep=deep)
+
+    _StrictLoader.add_constructor(
+        yaml.resolver.BaseResolver.DEFAULT_MAPPING_TAG, _construct_mapping
+    )
+    return yaml.load(text, Loader=_StrictLoader)
+
+
+def _normalize_key_token(token: str) -> str:
+    """Unquote a YAML key token so ``"llm.model"`` matches ``llm.model``."""
+    quote = token[:1]
+    if quote and quote in ("'", '"') and token[-1:] == quote:
+        try:
+            parsed = yaml.safe_load(token)
+        except yaml.YAMLError:
+            return token
+        if isinstance(parsed, str):
+            return parsed
+    return token
+
 
 class YamlConfigAdapter(IConfigService):
     """
@@ -51,13 +103,17 @@ class YamlConfigAdapter(IConfigService):
             return {}
 
     def _load_user_config(self) -> Dict[str, Any]:
-        """Loads the user-specific YAML configuration file if it exists."""
+        """Loads the user config, failing fast on a repeated mapping key.
+
+        Unreadable YAML still falls back to an empty user config, but a
+        ``ConfigurationError`` for a duplicate key propagates to the caller.
+        """
         if not os.path.exists(self._config_path):
             return {}
 
         try:
             with open(self._config_path, "r", encoding="utf-8") as f:
-                data = yaml.safe_load(f)
+                data = _strict_load(f.read(), self._config_path)
                 return data if isinstance(data, dict) else {}
         except (yaml.YAMLError, OSError):
             return {}
@@ -189,10 +245,11 @@ class YamlConfigAdapter(IConfigService):
         through a data-only loader (``yaml.safe_load``/``yaml.dump``), which
         would strip all comments and reformat the document.
 
-        Supports dot-notation for nested keys. The user config file and its
-        parent directory are created if they do not exist. After writing, the
-        in-memory merged cache is updated so a subsequent ``get_setting()`` on
-        THIS adapter reflects the change without a reload.
+        Supports dot-notation for nested keys and honours the same precedence
+        as ``get_setting``: an exact top-level dotted key wins over a nested
+        key. The user config file and its parent directory are created if they
+        do not exist. After writing, the merged cache is rebuilt from disk so a
+        subsequent ``get_setting()`` on THIS adapter matches a fresh reload.
         """
         # 1. Ensure the parent directory exists.
         parent_dir = os.path.dirname(self._config_path)
@@ -212,16 +269,11 @@ class YamlConfigAdapter(IConfigService):
         with open(self._config_path, "w", encoding="utf-8") as f:
             f.write(text)
 
-        # 4. Synchronize the in-memory merged cache so a subsequent
-        #    get_setting() on THIS adapter reflects the change.
-        cache = self._config
-        for part in key_path[:-1]:
-            nxt = cache.get(part)
-            if not isinstance(nxt, dict):
-                nxt = {}
-                cache[part] = nxt
-            cache = nxt
-        cache[key_path[-1]] = value
+        # 4. Rebuild the merged cache from disk so a subsequent get_setting()
+        #    on THIS adapter resolves exactly what a fresh adapter resolves.
+        merged = self._load_layered_config()
+        self._config.clear()
+        self._config.update(merged)
 
     def _scalar_repr(self, value: Any) -> str:
         """Render a scalar value as YAML text with no document-end marker."""
@@ -238,7 +290,7 @@ class YamlConfigAdapter(IConfigService):
             if ":" not in stripped:
                 continue
             indent = len(raw) - len(raw.lstrip(" "))
-            key_part = stripped.split(":", 1)[0].strip()
+            key_part = _normalize_key_token(stripped.split(":", 1)[0].strip())
             while stack and stack[-1][0] >= indent:
                 stack.pop()
             current = [k for _, k in stack] + [key_part]
@@ -252,7 +304,11 @@ class YamlConfigAdapter(IConfigService):
         lines = text.split("\n")
         value_str = self._scalar_repr(value)
 
-        idx = self._find_key_line(lines, key_path)
+        idx = None
+        if len(key_path) > 1:
+            idx = self._find_key_line(lines, [".".join(key_path)])
+        if idx is None:
+            idx = self._find_key_line(lines, key_path)
         if idx is not None:
             raw = lines[idx]
             colon = raw.index(":")

{teddy_cli-0.1.17.dev1377 → teddy_cli-0.1.17.dev1379}/src/teddy_executor/resources/MRP.md

@@ -104,7 +104,7 @@ Use `EXECUTE` with shell commands or inline Python when surgical `EDIT` is britt
 
 ### Template-First Documentation & Tooling
 
-All documentation and project infrastructure are template-first. Before creating or modifying files under `docs/`, CI workflows, pre-commit hooks, or the `Makefile`, you MUST `READ` the matching template in `docs/templates/`. Follow the artifact numbering and path conventions defined in `docs/project/PROJECT.md`. If `docs/templates/` does not exist, EXECUTE `teddy init templates` to initialize defaults. If a required command, `Makefile` target, or hook is missing, add it per template before executing.
+All documentation and project infrastructure are template-first. Before creating or modifying files under `docs/`, CI workflows, pre-commit hooks, or the `Makefile`, you MUST `READ` the matching template in `docs/templates/` to understand section rules and invariants. Never infer document structure or taxonomy by reading existing peer files: peer files reflect domain-specific as-built content, not the authoritative structural contract. Follow the artifact numbering and path conventions defined in `docs/project/PROJECT.md`. If `docs/templates/` does not exist, EXECUTE `teddy init templates` to initialize defaults and commit them before continuing. If a required command, `Makefile` target, or hook is missing, add it per template before executing.
 
 ### Communication Hygiene
 
@@ -134,7 +134,7 @@ Your entire response is parsed into an AST and must strictly adhere to the forma
 
 ### No Preamble
 
-Output your response as raw Markdown. Do NOT wrap your response in a code block, and do not add any introductory or concluding text. Start immediately with the Level 1 Markdown heading.
+Output your response as raw Markdown. The very first token of your response MUST be the `#` character of the Level 1 heading. Do not output preambles, greetings, blank lines, or enclosing code fences before or around your response.
 
 ### Rationale Encapsulation
 

{teddy_cli-0.1.17.dev1377 → teddy_cli-0.1.17.dev1379}/src/teddy_executor/resources/config/config.yaml

@@ -3,7 +3,7 @@
 editor: ""
 
 execution:
-  default_timeout_seconds: 60       # EXECUTE timeout.
+  default_timeout_seconds: 60       # Default timeout for EXECUTE actions (in seconds).
   similarity_threshold: 0.95        # EDIT match threshold (1.0 = exact match; ignores relative indentation).
   max_output_lines: 100             # Caps EXECUTE stdout/stderr output lines.