teddy-cli 0.1.17.dev1380__tar.gz → 0.1.17.dev1382__tar.gz

{teddy_cli-0.1.17.dev1380 → teddy_cli-0.1.17.dev1382}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: teddy-cli
-Version: 0.1.17.dev1380
+Version: 0.1.17.dev1382
 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
@@ -282,6 +282,31 @@ teddy resume -m "your next instruction"
 | `--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`.                   |
 
+### Exporting Context
+
+`teddy context` bundles system information, git status, project structure, and file contents into a single Markdown payload. It copies the payload to the clipboard unless you pass `--no-copy`.
+
+Pass `-c/--context` to add ad-hoc values for a single run. The flag is repeatable and accepts comma-separated values. Explicit values extend the default set from `.teddy/init.context`. They do not replace it.
+
+```bash
+# Add two files beside the default init.context entries
+teddy context -c README.md -c src/app.py
+
+# Comma-separated values expand to separate entries
+teddy context -c "README.md,pyproject.toml"
+
+# Export only the chosen files and skip the default set
+teddy context --only -c README.md
+```
+
+A `-c` value resolves by kind. A directory expands recursively. A URL is fetched instead of resolved on disk. A file named `<name>.context` is treated as a manifest: the command reads one path per line, skips blank lines and `#` comments, and expands each entry. Any other file is embedded verbatim.
+
+```bash
+teddy context -c review.context
+```
+
+`--only` requires at least one `-c` value. Without one the command exits with a usage error, because an empty explicit set would export no files.
+
 ### Chat-Oriented Workflow (CHOP)
 
 You do not need API keys or per-token billing to use TeDDy. If you already have an active subscription (ChatGPT, Claude, Gemini, etc.), you can also use TeDDy to practice **[Chat-Oriented Programming (CHOP)](https://sourcegraph.com/blog/chat-oriented-programming-in-action)** from your web browser.
@@ -308,7 +333,7 @@ TeDDy packages your workspace context into a single clipboard payload, and the a
 | `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`). |
+| `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/`).     |
 
 > [!NOTE]

{teddy_cli-0.1.17.dev1380 → teddy_cli-0.1.17.dev1382}/README.md

@@ -248,6 +248,31 @@ teddy resume -m "your next instruction"
 | `--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`.                   |
 
+### Exporting Context
+
+`teddy context` bundles system information, git status, project structure, and file contents into a single Markdown payload. It copies the payload to the clipboard unless you pass `--no-copy`.
+
+Pass `-c/--context` to add ad-hoc values for a single run. The flag is repeatable and accepts comma-separated values. Explicit values extend the default set from `.teddy/init.context`. They do not replace it.
+
+```bash
+# Add two files beside the default init.context entries
+teddy context -c README.md -c src/app.py
+
+# Comma-separated values expand to separate entries
+teddy context -c "README.md,pyproject.toml"
+
+# Export only the chosen files and skip the default set
+teddy context --only -c README.md
+```
+
+A `-c` value resolves by kind. A directory expands recursively. A URL is fetched instead of resolved on disk. A file named `<name>.context` is treated as a manifest: the command reads one path per line, skips blank lines and `#` comments, and expands each entry. Any other file is embedded verbatim.
+
+```bash
+teddy context -c review.context
+```
+
+`--only` requires at least one `-c` value. Without one the command exits with a usage error, because an empty explicit set would export no files.
+
 ### Chat-Oriented Workflow (CHOP)
 
 You do not need API keys or per-token billing to use TeDDy. If you already have an active subscription (ChatGPT, Claude, Gemini, etc.), you can also use TeDDy to practice **[Chat-Oriented Programming (CHOP)](https://sourcegraph.com/blog/chat-oriented-programming-in-action)** from your web browser.
@@ -274,7 +299,7 @@ TeDDy packages your workspace context into a single clipboard payload, and the a
 | `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`). |
+| `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/`).     |
 
 > [!NOTE]

{teddy_cli-0.1.17.dev1380 → teddy_cli-0.1.17.dev1382}/pyproject.toml

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

@@ -277,16 +277,9 @@ def start(  # noqa: PLR0913
     _ensure_project_initialized(container)
     config_service = container.resolve(IConfigService)
 
-    additional_context = (
-        [
-            path.strip()
-            for occurrence in context
-            for path in occurrence.split(",")
-            if path.strip()
-        ]
-        if context
-        else None
-    )
+    from teddy_executor.adapters.inbound.cli_helpers import normalize_context_values
+
+    additional_context = normalize_context_values(context)
 
     interactive = not (_resolve_yolo(yolo, config_service) or pipeline)
     system_env = container.resolve(ISystemEnvironment)
@@ -461,6 +454,20 @@ def context(
         "--no-copy",
         help="Do not copy the output to the clipboard.",
     ),
+    context: Optional[list[str]] = typer.Option(
+        None,
+        "--context",
+        "-c",
+        help=(
+            "Additional files/dirs for context. Repeatable (-c a.py -c b.md); "
+            'comma-separated values are also accepted (-c "a.py,b.md").'
+        ),
+    ),
+    only: bool = typer.Option(
+        False,
+        "--only",
+        help="Export only the --context values, skipping the default set.",
+    ),
 ):
     """
     Gathers and displays project context (file tree + file contents).
@@ -473,7 +480,10 @@ def context(
 
     container = get_container()
     _ensure_project_initialized(container)
-    handle_context_gathering(container, no_copy)
+    from teddy_executor.adapters.inbound.cli_helpers import normalize_context_values
+
+    additional_context = normalize_context_values(context)
+    handle_context_gathering(container, no_copy, additional_context, only)
 
 
 @app.command(name="get-prompt")

{teddy_cli-0.1.17.dev1380 → teddy_cli-0.1.17.dev1382}/src/teddy_executor/adapters/inbound/cli_helpers.py

@@ -34,6 +34,25 @@ def find_project_root() -> Path:
     return current
 
 
+def normalize_context_values(
+    values: Optional[List[str]],
+) -> Optional[List[str]]:
+    """Normalizes a repeatable and comma-separated context option.
+
+    Each occurrence is split on commas, every fragment is stripped, and empty
+    fragments are dropped. A falsy option returns ``None`` so callers can
+    distinguish "no value supplied" from an explicitly empty list.
+    """
+    if not values:
+        return None
+    return [
+        path.strip()
+        for occurrence in values
+        for path in occurrence.split(",")
+        if path.strip()
+    ]
+
+
 def echo_and_copy(
     content: str,
     no_copy: bool = False,

{teddy_cli-0.1.17.dev1380 → teddy_cli-0.1.17.dev1382}/src/teddy_executor/adapters/inbound/session_cli_handlers.py

@@ -16,6 +16,7 @@ from teddy_executor.core.domain.models.session import SessionOptions
 from teddy_executor.core.ports.outbound.user_interactor import IUserInteractor
 from teddy_executor.core.ports.outbound.session_loop_guard import ISessionLoopGuard
 from teddy_executor.core.ports.outbound.config_service import IConfigService
+from teddy_executor.core.ports.outbound.file_system_manager import IFileSystemManager
 from teddy_executor.core.ports.outbound.session_repository import ISessionRepository
 from teddy_executor.core.utils.interrupt_guard import InterruptGuard
 from teddy_executor.core.utils.session_notices import format_interrupt_notice
@@ -1103,10 +1104,40 @@ def detect_session_context() -> Optional[Dict[str, Sequence[str]]]:
     return None
 
 
-def handle_context_gathering(container: Container, no_copy: bool):
+def _default_context_paths(container: Container) -> list[str]:
+    """Resolves the default `.teddy/*.context` entries outside a session."""
+    file_system_manager = container.resolve(IFileSystemManager)
+    return file_system_manager.get_context_paths()
+
+
+def handle_context_gathering(
+    container: Container,
+    no_copy: bool,
+    additional_context: Optional[Sequence[str]] = None,
+    only: bool = False,
+):
     """Logic for the 'context' command."""
     context_service: IGetContextUseCase = container.resolve(IGetContextUseCase)
     context_files = detect_session_context()
+
+    if only and not additional_context:
+        raise typer.BadParameter("--only requires at least one --context value.")
+
+    if additional_context:
+        explicit_scope = {"Explicit": list(additional_context)}
+        if only:
+            context_files = explicit_scope
+        else:
+            # Outside a session no scope map exists, so the defaults are
+            # resolved here: the service globs only when the map is falsy.
+            scopes = (
+                dict(context_files)
+                if context_files
+                else {"Default": _default_context_paths(container)}
+            )
+            scopes.update(explicit_scope)
+            context_files = scopes
+
     # Performance: Formatting context for Markdown doesn't use tokens, so we skip them.
     context_result = context_service.get_context(
         context_files=context_files, include_tokens=False