teddy-cli 0.2.1.dev1428__tar.gz → 0.2.1.dev1431__tar.gz

{teddy_cli-0.2.1.dev1428 → teddy_cli-0.2.1.dev1431}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: teddy-cli
-Version: 0.2.1.dev1428
+Version: 0.2.1.dev1431
 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
@@ -35,13 +35,13 @@ Description-Content-Type: text/markdown
 <div align="center">
 
 <p align="center">
-  <img src="./assets/banner.png" alt="TeDDy: The opinionated software engineering harness - Because you should own the means of development" width="100%" style="max-width: 650px;" />
+  <img src="https://raw.githubusercontent.com/atte500/teddy/main/assets/banner.png" alt="TeDDy: The opinionated software engineering harness - Because you should own the means of development" width="100%" style="max-width: 650px;" />
 </p>
 
 <p align="center">
   <a href="https://pypi.org/project/teddy-cli/"><img src="https://img.shields.io/pypi/v/teddy-cli?color=blue&style=flat-square" alt="PyPI version" /></a>
   <a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.11+-blue.svg?style=flat-square" alt="Python 3.11+" /></a>
-  <a href="LICENSE"><img src="https://img.shields.io/badge/license-AGPL--3.0-purple.svg?style=flat-square" alt="License: AGPL-3.0" /></a>
+  <a href="https://github.com/atte500/teddy/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-AGPL--3.0-purple.svg?style=flat-square" alt="License: AGPL-3.0" /></a>
 </p>
 
 ```bash
@@ -49,7 +49,7 @@ uv tool install teddy-cli
 ```
 
 <p align="center">
-  <img src="./assets/demo.gif" alt="TeDDy TUI Demo" width="100%" style="max-width: 100%; height: auto;" />
+  <img src="https://raw.githubusercontent.com/atte500/teddy/main/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) &bull; [Support](#support)
@@ -130,7 +130,7 @@ For **technical defects**, TeDDy prevents structural failures through Design by
 For **misalignment**, TeDDy prevents building the wrong thing by using spikes and prototypes to de-risk uncertain solutions before committing to an architecture. During implementation, it mitigates drift by delivering features through small vertical slices. Specific Markdown documents mediate every phase transition, anchoring the agents and providing a high-level steering interface to keep humans in the loop.
 
 <p align="center">
-  <img src="./assets/matrix.png" alt="Workflow Matrix" width="800" />
+  <img src="https://raw.githubusercontent.com/atte500/teddy/main/assets/matrix.png" alt="Workflow Matrix" width="100%" />
 </p>
 
 ---
@@ -140,7 +140,7 @@ For **misalignment**, TeDDy prevents building the wrong thing by using spikes an
 Instead of winging the process on the go or taking the shortest path to generate code, agents follow a structured delivery process mediated by plain Markdown documents:
 
 <p align="center">
-  <img src="./assets/workflow-schematic.png" alt="TeDDy Workflow" width="850" />
+  <img src="https://raw.githubusercontent.com/atte500/teddy/main/assets/workflow-schematic.png" alt="TeDDy Workflow" width="100%" />
 </p>
 
 1. **Strategic Alignment & Roadmapping:** The **Pathfinder** aligns incoming requests with the product vision, roadmap, and permanent system invariant specifications.
@@ -398,9 +398,9 @@ The tool itself is not monetized. If your team needs custom agent architectures,
 
 ## Learn More
 
-- [Project Roadmap & Vision](./docs/project/PROJECT.md)
-- [System Architecture](./docs/architecture/ARCHITECTURE.md)
-- [Agent Prompt Templates](./src/teddy_executor/resources/config/prompts/)
+- [Project Roadmap & Vision](https://github.com/atte500/teddy/blob/main/docs/project/PROJECT.md)
+- [System Architecture](https://github.com/atte500/teddy/blob/main/docs/architecture/ARCHITECTURE.md)
+- [Agent Prompt Templates](https://github.com/atte500/teddy/tree/main/src/teddy_executor/resources/config/prompts)
 
 ---
 

{teddy_cli-0.2.1.dev1428 → teddy_cli-0.2.1.dev1431}/README.md

@@ -1,13 +1,13 @@
 <div align="center">
 
 <p align="center">
-  <img src="./assets/banner.png" alt="TeDDy: The opinionated software engineering harness - Because you should own the means of development" width="100%" style="max-width: 650px;" />
+  <img src="https://raw.githubusercontent.com/atte500/teddy/main/assets/banner.png" alt="TeDDy: The opinionated software engineering harness - Because you should own the means of development" width="100%" style="max-width: 650px;" />
 </p>
 
 <p align="center">
   <a href="https://pypi.org/project/teddy-cli/"><img src="https://img.shields.io/pypi/v/teddy-cli?color=blue&style=flat-square" alt="PyPI version" /></a>
   <a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.11+-blue.svg?style=flat-square" alt="Python 3.11+" /></a>
-  <a href="LICENSE"><img src="https://img.shields.io/badge/license-AGPL--3.0-purple.svg?style=flat-square" alt="License: AGPL-3.0" /></a>
+  <a href="https://github.com/atte500/teddy/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-AGPL--3.0-purple.svg?style=flat-square" alt="License: AGPL-3.0" /></a>
 </p>
 
 ```bash
@@ -15,7 +15,7 @@ uv tool install teddy-cli
 ```
 
 <p align="center">
-  <img src="./assets/demo.gif" alt="TeDDy TUI Demo" width="100%" style="max-width: 100%; height: auto;" />
+  <img src="https://raw.githubusercontent.com/atte500/teddy/main/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) &bull; [Support](#support)
@@ -96,7 +96,7 @@ For **technical defects**, TeDDy prevents structural failures through Design by
 For **misalignment**, TeDDy prevents building the wrong thing by using spikes and prototypes to de-risk uncertain solutions before committing to an architecture. During implementation, it mitigates drift by delivering features through small vertical slices. Specific Markdown documents mediate every phase transition, anchoring the agents and providing a high-level steering interface to keep humans in the loop.
 
 <p align="center">
-  <img src="./assets/matrix.png" alt="Workflow Matrix" width="800" />
+  <img src="https://raw.githubusercontent.com/atte500/teddy/main/assets/matrix.png" alt="Workflow Matrix" width="100%" />
 </p>
 
 ---
@@ -106,7 +106,7 @@ For **misalignment**, TeDDy prevents building the wrong thing by using spikes an
 Instead of winging the process on the go or taking the shortest path to generate code, agents follow a structured delivery process mediated by plain Markdown documents:
 
 <p align="center">
-  <img src="./assets/workflow-schematic.png" alt="TeDDy Workflow" width="850" />
+  <img src="https://raw.githubusercontent.com/atte500/teddy/main/assets/workflow-schematic.png" alt="TeDDy Workflow" width="100%" />
 </p>
 
 1. **Strategic Alignment & Roadmapping:** The **Pathfinder** aligns incoming requests with the product vision, roadmap, and permanent system invariant specifications.
@@ -364,9 +364,9 @@ The tool itself is not monetized. If your team needs custom agent architectures,
 
 ## Learn More
 
-- [Project Roadmap & Vision](./docs/project/PROJECT.md)
-- [System Architecture](./docs/architecture/ARCHITECTURE.md)
-- [Agent Prompt Templates](./src/teddy_executor/resources/config/prompts/)
+- [Project Roadmap & Vision](https://github.com/atte500/teddy/blob/main/docs/project/PROJECT.md)
+- [System Architecture](https://github.com/atte500/teddy/blob/main/docs/architecture/ARCHITECTURE.md)
+- [Agent Prompt Templates](https://github.com/atte500/teddy/tree/main/src/teddy_executor/resources/config/prompts)
 
 ---
 

{teddy_cli-0.2.1.dev1428 → teddy_cli-0.2.1.dev1431}/pyproject.toml

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

{teddy_cli-0.2.1.dev1428 → teddy_cli-0.2.1.dev1431}/src/teddy_executor/adapters/inbound/session_cli_handlers.py

@@ -428,23 +428,25 @@ def _report_fast_forward(git_run: Callable[..., Any], before: str, after: str) -
     )
 
 
-def _start_background_update_check(container: Container) -> list[str]:
-    """Start the non-blocking version check and report the update-check keys.
+def _update_cache_path() -> Path:
+    """Resolve the project-local cache file that carries the latest version."""
+    return find_project_root() / ".teddy" / ".update_cache.json"
 
-    Both session entry points share this preamble: it spawns the daemon
-    version-fetch thread, then emits the cached update notification (if any).
-    The returned list names the update checks that fired.
+
+def _start_background_update_check() -> None:
+    """Start the daemon version fetch that fills the cache for the next run.
+
+    The fetch never blocks startup and never prints. The startup preamble emits
+    the notice from the cache this fetch leaves behind.
     """
     import threading
 
-    cache_path = find_project_root() / ".teddy" / ".update_cache.json"
     thread = threading.Thread(
         target=background_check,
-        args=(cache_path,),
+        args=(_update_cache_path(),),
         daemon=True,
     )
     thread.start()
-    return _display_update_notification(container, cache_path)
 
 
 def _run_startup_preamble(
@@ -458,10 +460,10 @@ def _run_startup_preamble(
 
     The order is fixed so the banner layout cannot drift: health checks, the
     start-only workspace fast-forward line, one separator blank line, the
-    ``Checking configurations...`` line, then the preflight check. ``start``
-    forwards its ``agent`` so the preflight validates the agent prompt and
-    enables ``pull_workspace``; ``resume`` leaves the agent ``None`` and keeps
-    the pull off.
+    ``Checking configurations...`` line, the cached update notice, then the
+    preflight check with its drift advice. ``start`` forwards its ``agent`` so
+    the preflight validates the agent prompt and enables ``pull_workspace``;
+    ``resume`` leaves the agent ``None`` and keeps the pull off.
     """
     config_service = container.resolve(IConfigService)
     _run_health_checks(config_service)
@@ -470,6 +472,7 @@ def _run_startup_preamble(
     # One separator groups the checkmark block above with the notices below.
     typer.echo("", err=True)
     typer.echo("Checking configurations...", err=True)
+    _display_update_notification(container, _update_cache_path())
     _run_cli_preflight_check(
         container,
         agent=agent,
@@ -800,7 +803,7 @@ def _display_update_notification(container: Container, cache_path: Path) -> list
             typer.echo(
                 typer.style(
                     f"ℹ A new version {latest} is available. "
-                    f"To upgrade, run: {command}\n",
+                    f"To upgrade, run: {command}",
                     fg=typer.colors.YELLOW,
                 ),
                 err=True,
@@ -830,7 +833,7 @@ def handle_new_session(  # noqa: PLR0913
     max_cost: Optional[float] = None,
 ):
     """Logic for the 'start' command."""
-    _start_background_update_check(container)
+    _start_background_update_check()
 
     try:
         # 0. Pipeline mode requires an initial message
@@ -1513,7 +1516,7 @@ def handle_resume_session(  # noqa: PLR0913
     max_cost: Optional[float] = None,
 ):
     """Logic for the 'resume' command."""
-    _start_background_update_check(container)
+    _start_background_update_check()
 
     try:
         # 1. Shared startup preamble (health checks + preflight)