specsmith 0.20.1.dev749__tar.gz → 0.20.1.dev759__tar.gz

{specsmith-0.20.1.dev749/src/specsmith.egg-info → specsmith-0.20.1.dev759}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.20.1.dev749
+Version: 0.20.1.dev759
 Summary: AEE governance toolkit for AI-assisted development — session preflight gates, multi-agent dispatch, requirements↔test traceability, ESDB persistence, MCP server, and skills for Warp, Cursor, Claude Code, Copilot, Windsurf, and Aider.
 Author: Layer1Labs Silicon, Inc.
 License-Expression: MIT
@@ -1341,6 +1341,20 @@ oz agent run --mcp '{"specsmith-governance": {"command": "specsmith", "args": ["
 | `governance_req_list` | All requirements with status + test coverage, filterable |
 | `governance_trace_seal` | Create a cryptographic trace vault seal |
 
+### Third-party CLI agent toolbar
+
+For **specsmith** and **aider** (not yet natively supported by Warp), add this regex once in **Warp → Settings → Agents → Third party CLI agents → Commands that enable the toolbar**:
+
+```
+specsmith\s+run|aider
+```
+
+`claude`, `codex`, `gemini`, and `cursor` are already natively supported — no regex needed.
+
+Once set, the toolbelt (Rich Input, attach code, File Explorer, Tab Configs, Remote Control) appears whenever `specsmith run` or `aider` is running. `specsmith run` also emits an OSC 9 desktop notification on session start — intercepted automatically by Warp, iTerm2, and Windows Terminal.
+
+Run `specsmith integrate warp` to regenerate `.warp/SETUP.md` with the full per-REPL setup guide.
+
 ### Repository Workflows (Ctrl+Shift+R)
 
 Clone this repo and open it in Warp — seven governance workflows appear automatically in

{specsmith-0.20.1.dev749 → specsmith-0.20.1.dev759}/README.md

@@ -1263,6 +1263,20 @@ oz agent run --mcp '{"specsmith-governance": {"command": "specsmith", "args": ["
 | `governance_req_list` | All requirements with status + test coverage, filterable |
 | `governance_trace_seal` | Create a cryptographic trace vault seal |
 
+### Third-party CLI agent toolbar
+
+For **specsmith** and **aider** (not yet natively supported by Warp), add this regex once in **Warp → Settings → Agents → Third party CLI agents → Commands that enable the toolbar**:
+
+```
+specsmith\s+run|aider
+```
+
+`claude`, `codex`, `gemini`, and `cursor` are already natively supported — no regex needed.
+
+Once set, the toolbelt (Rich Input, attach code, File Explorer, Tab Configs, Remote Control) appears whenever `specsmith run` or `aider` is running. `specsmith run` also emits an OSC 9 desktop notification on session start — intercepted automatically by Warp, iTerm2, and Windows Terminal.
+
+Run `specsmith integrate warp` to regenerate `.warp/SETUP.md` with the full per-REPL setup guide.
+
 ### Repository Workflows (Ctrl+Shift+R)
 
 Clone this repo and open it in Warp — seven governance workflows appear automatically in

{specsmith-0.20.1.dev749 → specsmith-0.20.1.dev759}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "specsmith"
-version = "0.20.1.dev749"
+version = "0.20.1.dev759"
 description = "AEE governance toolkit for AI-assisted development — session preflight gates, multi-agent dispatch, requirements↔test traceability, ESDB persistence, MCP server, and skills for Warp, Cursor, Claude Code, Copilot, Windsurf, and Aider."
 readme = "README.md"
 license = "MIT"

{specsmith-0.20.1.dev749 → specsmith-0.20.1.dev759}/src/specsmith/agent/runner.py

@@ -306,6 +306,13 @@ class AgentRunner:
 
         # Host-terminal detection (REQ-444): when running inside Warp the
         # banner/ready frame advertises native integration. Read-only.
+        # Set SPECSMITH_RUN_ACTIVE so any child specsmith command (audit,
+        # preflight, checkpoint, etc.) can detect they are running inside
+        # the Nexus REPL and report context-aware governance notifications.
+        import os as _os_init
+
+        _os_init.environ.setdefault("SPECSMITH_RUN_ACTIVE", "1")
+
         from specsmith.agent.terminal_env import detect_terminal
 
         self.terminal = detect_terminal()
@@ -395,6 +402,11 @@ class AgentRunner:
             if self.terminal.is_warp:
                 ver = f" {self.terminal.version}" if self.terminal.version else ""
                 lines.insert(3, f"  terminal: Warp{ver} \u2014 native integration active")
+                # Emit OSC 9 desktop notification so Warp surfaces a popup.
+                from specsmith.agent.terminal_env import emit_warp_notification
+
+                proj = Path(self.project_dir).name
+                emit_warp_notification(f"specsmith run | {proj} | governance active")
             for s in statuses:
                 if s.available:
                     lines.append(

specsmith-0.20.1.dev759/src/specsmith/agent/terminal_env.py

@@ -0,0 +1,119 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 Layer1Labs Silicon, Inc. All rights reserved.
+"""Terminal-environment detection for specsmith (REQ-444).
+
+Lets the interactive REPL (``specsmith run``) and standalone CLI commands
+detect when they are running inside Warp and which CLI agent REPL is active.
+Detection is based on:
+  * ``TERM_PROGRAM=WarpTerminal`` / any ``WARP_*`` env var — Warp host
+  * ``SPECSMITH_RUN_ACTIVE=1``     — set by ``specsmith run`` on REPL start
+  * ``AIDER_MODEL`` / ``AIDER_CONFIG``  — set by aider at session start
+  * ``CLAUDE_CODE_ENTRYPOINT``     — set by Claude Code CLI
+  * ``CODEX_CLI_SESSION``          — set by OpenAI Codex CLI
+  * ``GEMINI_CLI``                 — set by Gemini CLI
+  * ``CURSOR_TRACE_ID``            — set by Cursor CLI
+
+All detection is read-only and purely best-effort.
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+from dataclasses import asdict, dataclass
+from typing import TextIO
+
+# ---------------------------------------------------------------------------
+# Known CLI-agent env-var signals.
+# Keys are canonical agent IDs; values are lists of env vars that
+# confirm the agent is (or recently was) active in this shell session.
+# Warp natively supports: claude, codex, gemini, cursor.
+# specsmith and aider are NOT natively supported — users add them via the
+# custom toolbar regex in Warp Settings → Agents → Third party CLI agents.
+# ---------------------------------------------------------------------------
+_AGENT_ENV_SIGNALS: dict[str, list[str]] = {
+    "specsmith": ["SPECSMITH_RUN_ACTIVE"],
+    "aider": ["AIDER_MODEL", "AIDER_CONFIG", "AIDER_CHAT_LANGUAGE"],
+    "claude": ["CLAUDE_CODE_ENTRYPOINT", "ANTHROPIC_CLAUDE_CODE_SESSION"],
+    "codex": ["CODEX_CLI_SESSION", "OPENAI_CODEX_CLI"],
+    "gemini": ["GEMINI_CLI", "GEMINI_CLI_SESSION"],
+    "cursor": ["CURSOR_TRACE_ID", "CURSOR_SESSION_ID"],
+    "copilot": ["GITHUB_COPILOT_CLI", "GH_COPILOT_SESSION"],
+    "windsurf": ["WINDSURF_SESSION", "CODEIUM_SESSION"],
+}
+
+
+@dataclass(frozen=True)
+class TerminalInfo:
+    """Information about the host terminal and active CLI agent REPL."""
+
+    is_warp: bool
+    program: str
+    version: str
+    #: Canonical agent ID when a known CLI agent REPL is detected, else "".
+    #: Examples: ``"specsmith"``, ``"aider"``, ``"claude"``, ``"codex"``.
+    active_agent: str = ""
+
+    def as_dict(self) -> dict[str, object]:
+        """Return a flat dict suitable for the ``ready`` event frame."""
+        return asdict(self)
+
+
+def detect_terminal(env: dict[str, str] | None = None) -> TerminalInfo:
+    """Detect the host terminal and active CLI agent from environment variables.
+
+    Warp sets ``TERM_PROGRAM=WarpTerminal`` (and ``TERM_PROGRAM_VERSION``).
+    As a fallback we also treat the presence of any ``WARP_*`` variable as a
+    Warp signal.  Pass *env* to override ``os.environ`` (used by tests).
+    """
+    source = os.environ if env is None else env
+    program = (source.get("TERM_PROGRAM") or "").strip()
+    version = (source.get("TERM_PROGRAM_VERSION") or "").strip()
+    is_warp = program == "WarpTerminal" or any(k.startswith("WARP_") for k in source)
+    if is_warp and not program:
+        program = "WarpTerminal"
+
+    # Detect the active CLI-agent REPL by checking known signal env vars.
+    # First match wins; order matters (specsmith checked before generic agents).
+    active_agent = ""
+    for agent, signals in _AGENT_ENV_SIGNALS.items():
+        if any(source.get(sig) for sig in signals):
+            active_agent = agent
+            break
+
+    return TerminalInfo(
+        is_warp=is_warp,
+        program=program,
+        version=version,
+        active_agent=active_agent,
+    )
+
+
+# ---------------------------------------------------------------------------
+# OSC 9 terminal notification (Warp, iTerm2, Windows Terminal)
+# ---------------------------------------------------------------------------
+
+
+def emit_warp_notification(message: str, *, stream: TextIO | None = None) -> None:
+    """Emit an OSC 9 terminal notification that Warp (and compatible terminals)
+    surfaces as a desktop notification.
+
+    The escape sequence ``ESC ] 9 ; <message> BEL`` is the standard notification
+    protocol supported by Warp, iTerm2, and Windows Terminal.  When *stream* is
+    ``None`` (the default), the function skips silently if stdout is not a TTY
+    (e.g. captured in tests or CI).  Pass an explicit *stream* to override.
+
+    This is always safe to call — it is a no-op outside Warp and raises no
+    exceptions.
+    """
+    out = stream if stream is not None else sys.stdout
+    try:
+        # When using the default stdout and it's not a tty, skip silently
+        # to avoid polluting captured output in tests or piped commands.
+        if stream is None and hasattr(out, "isatty") and not out.isatty():
+            return
+        out.write(f"\033]9;{message}\007")
+        if hasattr(out, "flush"):
+            out.flush()
+    except Exception:  # noqa: BLE001  # intentional: notification is best-effort
+        pass

specsmith-0.20.1.dev759/src/specsmith/integrations/warp.py

@@ -0,0 +1,179 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 Layer1Labs Silicon, Inc. All rights reserved.
+"""Warp integration adapter (REQ-444).
+
+Generates Warp-native artifacts so Warp's agent is governed by specsmith:
+
+  * ``.warp/specsmith-mcp.json``                      — governance MCP server config
+  * ``.warp/launch_configs/specsmith-governed.yaml``  — launch config for a governed session
+  * ``.agents/skills/SKILL.md``                       — governance skill (shared with agent-skill)
+
+``AGENTS.md`` is already the governance hub Warp reads as project Rules, so the
+adapter does not duplicate it.
+
+This adapter supersedes the pre-0.5.0 ``warp`` name that previously aliased to
+the generic ``agent-skill`` adapter; the skill is still emitted here (by reusing
+``AgentSkillAdapter``), so existing setups keep their ``.agents/skills/SKILL.md``.
+"""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+from specsmith.config import ProjectConfig
+from specsmith.integrations.agent_skill import AgentSkillAdapter
+from specsmith.integrations.base import AgentAdapter
+
+
+class WarpAdapter(AgentAdapter):
+    """Generate Warp-native governance integration files."""
+
+    @property
+    def name(self) -> str:
+        return "warp"
+
+    @property
+    def description(self) -> str:
+        return "Warp native integration (MCP server config, launch config, governance skill)"
+
+    def generate(self, config: ProjectConfig, target: Path) -> list[Path]:
+        created: list[Path] = []
+        warp_dir = target / ".warp"
+        warp_dir.mkdir(parents=True, exist_ok=True)
+
+        # 1. MCP governance server config (shared builder with `mcp install-warp`).
+        from specsmith.mcp_server import build_warp_mcp_config
+
+        mcp_path = warp_dir / "specsmith-mcp.json"
+        mcp_path.write_text(
+            json.dumps(build_warp_mcp_config(), indent=2) + "\n",
+            encoding="utf-8",
+        )
+        created.append(mcp_path)
+
+        # 2. Launch config for a governed `specsmith run` session.
+        launch_dir = warp_dir / "launch_configs"
+        launch_dir.mkdir(parents=True, exist_ok=True)
+        launch_path = launch_dir / "specsmith-governed.yaml"
+        launch_path.write_text(self._render_launch_config(config, target), encoding="utf-8")
+        created.append(launch_path)
+
+        # 3. Governance skill (reuse the agent-skill adapter; .agents/skills/SKILL.md).
+        created.extend(AgentSkillAdapter().generate(config, target))
+
+        # 4. Third-party CLI agent toolbar setup guide.
+        setup_path = warp_dir / "SETUP.md"
+        setup_path.write_text(self._render_setup_guide(config), encoding="utf-8")
+        created.append(setup_path)
+
+        # Print the single most-important instruction so it appears immediately
+        # after `specsmith integrate warp` completes.
+        import sys
+
+        print(
+            "\n  ↳ Warp toolbar (one-time, per machine):\n"
+            "    Settings → Agents → Third party CLI agents\n"
+            "    Commands that enable the toolbar → add regex:\n"
+            "      specsmith\\s+run|aider\n"
+            "    (claude, codex, gemini, cursor — already natively supported)\n"
+            "\n"
+            "    Full setup guide: .warp/SETUP.md",
+            file=sys.stdout,
+            flush=True,
+        )
+
+        return created
+
+    def _render_setup_guide(self, config: ProjectConfig) -> str:  # noqa: ARG002
+        """Render the .warp/SETUP.md toolbar + notification setup guide."""
+        return """\
+# Warp — specsmith governance integration
+
+## Third-party CLI agent toolbar (one-time setup per machine)
+
+Warp natively supports the toolbar for: **claude**, **codex**, **gemini**, **cursor**.
+For **specsmith** and **aider** (not yet natively supported), add the following
+regex to Warp → Settings → Agents → Third party CLI agents → Commands that enable the toolbar:
+
+```
+specsmith\\s+run|aider
+```
+
+Once saved, the Warp toolbelt appears automatically when either `specsmith run` or
+`aider` is active in any pane, providing Rich Input (Ctrl+G), attach code as context,
+File Explorer, Tab Configs, and Remote Control.
+
+## Desktop notifications
+
+`specsmith run` emits OSC 9 desktop notifications when running inside Warp
+(or any OSC-9-compatible terminal such as iTerm2 or Windows Terminal).
+No extra setup is needed — Warp intercepts the escape sequence automatically.
+
+Notification events:
+- Session start: `specsmith run | <project> | governance active`
+
+## MCP governance server
+
+Add `.warp/specsmith-mcp.json` to Warp → Settings → Agents → MCP servers so
+Warp's Oz agent can call governance tools natively (preflight, audit, checkpoint,
+req_list, phase, trace_seal) without shell roundtrips.
+
+Paste the contents of `.warp/specsmith-mcp.json` or run:
+```bash
+specsmith mcp install-warp
+```
+
+## Launch configuration
+
+`.warp/launch_configs/specsmith-governed.yaml` opens a governed `specsmith run`
+session. Copy it to your Warp launch configurations directory:
+- macOS/Linux: `~/.warp/launch_configurations/`
+- Windows: `%APPDATA%/warp/Warp/data/launch_configurations/`
+
+## Supported REPLs and their Warp status
+
+| REPL | Toolbar | How |
+|---|---|---|
+| `specsmith run` | Custom regex | Add `specsmith\\s+run` to toolbar regex |
+| `aider` | Custom regex | Add `aider` to toolbar regex |
+| `claude` | Native | Built into Warp — no setup needed |
+| `codex` | Native | Built into Warp — no setup needed |
+| `gemini` | Native | Built into Warp — no setup needed |
+| `cursor` | Native | Built into Warp — no setup needed |
+
+## Session protocol (all REPLs)
+
+```bash
+# Session start
+specsmith kill-session 2>/dev/null || true
+specsmith audit --project-dir .
+specsmith sync  --project-dir .
+specsmith checkpoint --project-dir .   # output GOVERNANCE ANCHOR verbatim
+
+# Before every code change
+specsmith preflight "<describe the change>" --json
+
+# Session end
+specsmith save && specsmith kill-session
+```
+"""
+
+    def _render_launch_config(self, config: ProjectConfig, target: Path) -> str:
+        cwd = str(target).replace("\\", "/")
+        return f"""\
+# specsmith governed session — Warp launch configuration.
+# Copy to your Warp launch configurations directory to use it:
+#   macOS/Linux: ~/.warp/launch_configurations/
+#   Windows:     %APPDATA%/warp/Warp/data/launch_configurations/
+# The governance MCP server config lives in .warp/specsmith-mcp.json — add it
+# under Warp Settings -> Agents -> MCP servers so Warp's agent is governed.
+name: {config.name} — specsmith governed
+windows:
+  - tabs:
+      - title: specsmith
+        layout:
+          cwd: "{cwd}"
+          commands:
+            - exec: specsmith run
+"""

{specsmith-0.20.1.dev749 → specsmith-0.20.1.dev759/src/specsmith.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.20.1.dev749
+Version: 0.20.1.dev759
 Summary: AEE governance toolkit for AI-assisted development — session preflight gates, multi-agent dispatch, requirements↔test traceability, ESDB persistence, MCP server, and skills for Warp, Cursor, Claude Code, Copilot, Windsurf, and Aider.
 Author: Layer1Labs Silicon, Inc.
 License-Expression: MIT
@@ -1341,6 +1341,20 @@ oz agent run --mcp '{"specsmith-governance": {"command": "specsmith", "args": ["
 | `governance_req_list` | All requirements with status + test coverage, filterable |
 | `governance_trace_seal` | Create a cryptographic trace vault seal |
 
+### Third-party CLI agent toolbar
+
+For **specsmith** and **aider** (not yet natively supported by Warp), add this regex once in **Warp → Settings → Agents → Third party CLI agents → Commands that enable the toolbar**:
+
+```
+specsmith\s+run|aider
+```
+
+`claude`, `codex`, `gemini`, and `cursor` are already natively supported — no regex needed.
+
+Once set, the toolbelt (Rich Input, attach code, File Explorer, Tab Configs, Remote Control) appears whenever `specsmith run` or `aider` is running. `specsmith run` also emits an OSC 9 desktop notification on session start — intercepted automatically by Warp, iTerm2, and Windows Terminal.
+
+Run `specsmith integrate warp` to regenerate `.warp/SETUP.md` with the full per-REPL setup guide.
+
 ### Repository Workflows (Ctrl+Shift+R)
 
 Clone this repo and open it in Warp — seven governance workflows appear automatically in

{specsmith-0.20.1.dev749 → specsmith-0.20.1.dev759}/tests/test_integrations_warp.py

@@ -79,6 +79,30 @@ class TestWarpAdapterGenerate:
         assert "test-project" in content
         assert "AGENTS.md" in content
 
+    def test_generates_setup_md(self, config: ProjectConfig, tmp_path: Path) -> None:
+        WarpAdapter().generate(config, tmp_path)
+        setup = tmp_path / ".warp" / "SETUP.md"
+        assert setup.exists()
+        content = setup.read_text(encoding="utf-8")
+        # Must document the toolbar regex for non-native REPLs.
+        assert "specsmith" in content
+        assert "aider" in content
+        # Must distinguish natively supported agents.
+        assert "claude" in content
+        assert "Native" in content
+
+    def test_setup_md_contains_toolbar_regex(self, config: ProjectConfig, tmp_path: Path) -> None:
+        WarpAdapter().generate(config, tmp_path)
+        setup = tmp_path / ".warp" / "SETUP.md"
+        content = setup.read_text(encoding="utf-8")
+        # The regex the user must paste into Warp settings.
+        assert r"specsmith\s+run|aider" in content
+
+    def test_generated_files_includes_setup_md(self, config: ProjectConfig, tmp_path: Path) -> None:
+        files = WarpAdapter().generate(config, tmp_path)
+        rel = {p.relative_to(tmp_path).as_posix() for p in files}
+        assert ".warp/SETUP.md" in rel
+
     def test_idempotent(self, config: ProjectConfig, tmp_path: Path) -> None:
         first = WarpAdapter().generate(config, tmp_path)
         first_contents = {p: p.read_text(encoding="utf-8") for p in first}

specsmith-0.20.1.dev759/tests/test_terminal_env.py

@@ -0,0 +1,137 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 Layer1Labs Silicon, Inc. All rights reserved.
+"""Tests for host-terminal detection (REQ-444)."""
+
+from __future__ import annotations
+
+import io
+
+from specsmith.agent.terminal_env import TerminalInfo, detect_terminal, emit_warp_notification
+
+
+class TestDetectTerminal:
+    def test_detects_warp_via_term_program(self) -> None:
+        info = detect_terminal(
+            {"TERM_PROGRAM": "WarpTerminal", "TERM_PROGRAM_VERSION": "0.2026.06.01"}
+        )
+        assert info.is_warp is True
+        assert info.program == "WarpTerminal"
+        assert info.version == "0.2026.06.01"
+
+    def test_detects_warp_via_warp_env_var(self) -> None:
+        info = detect_terminal({"WARP_HONOR_PS1": "0"})
+        assert info.is_warp is True
+        # Program is backfilled when only a WARP_* signal is present.
+        assert info.program == "WarpTerminal"
+
+    def test_non_warp_terminal(self) -> None:
+        info = detect_terminal({"TERM_PROGRAM": "iTerm.app"})
+        assert info.is_warp is False
+        assert info.program == "iTerm.app"
+        assert info.version == ""
+
+    def test_empty_env(self) -> None:
+        info = detect_terminal({})
+        assert info.is_warp is False
+        assert info.program == ""
+        assert info.version == ""
+
+    def test_as_dict_round_trip(self) -> None:
+        info = detect_terminal({"TERM_PROGRAM": "WarpTerminal"})
+        d = info.as_dict()
+        assert d == {
+            "is_warp": True,
+            "program": "WarpTerminal",
+            "version": "",
+            "active_agent": "",
+        }
+
+    def test_frozen_dataclass(self) -> None:
+        info = TerminalInfo(is_warp=False, program="x", version="1")
+        try:
+            info.is_warp = True  # type: ignore[misc]
+        except AttributeError:
+            pass
+        else:  # pragma: no cover - dataclass should be frozen
+            raise AssertionError("TerminalInfo should be frozen")
+
+
+class TestActiveAgentDetection:
+    def test_detects_specsmith_repl(self) -> None:
+        info = detect_terminal({"SPECSMITH_RUN_ACTIVE": "1"})
+        assert info.active_agent == "specsmith"
+
+    def test_detects_aider_via_model(self) -> None:
+        info = detect_terminal({"AIDER_MODEL": "gpt-4o"})
+        assert info.active_agent == "aider"
+
+    def test_detects_aider_via_config(self) -> None:
+        info = detect_terminal({"AIDER_CONFIG": "/home/user/.aider.conf.yml"})
+        assert info.active_agent == "aider"
+
+    def test_detects_claude(self) -> None:
+        info = detect_terminal({"CLAUDE_CODE_ENTRYPOINT": "cli"})
+        assert info.active_agent == "claude"
+
+    def test_detects_codex(self) -> None:
+        info = detect_terminal({"CODEX_CLI_SESSION": "abc123"})
+        assert info.active_agent == "codex"
+
+    def test_detects_gemini(self) -> None:
+        info = detect_terminal({"GEMINI_CLI": "1"})
+        assert info.active_agent == "gemini"
+
+    def test_no_agent_in_plain_shell(self) -> None:
+        info = detect_terminal({"TERM_PROGRAM": "iTerm.app"})
+        assert info.active_agent == ""
+
+    def test_specsmith_wins_over_aider_when_both_present(self) -> None:
+        # SPECSMITH_RUN_ACTIVE is checked first in the signals dict.
+        info = detect_terminal({"SPECSMITH_RUN_ACTIVE": "1", "AIDER_MODEL": "gpt-4o"})
+        assert info.active_agent == "specsmith"
+
+    def test_active_agent_included_in_as_dict(self) -> None:
+        info = detect_terminal({"AIDER_MODEL": "claude-3-5-sonnet"})
+        assert info.as_dict()["active_agent"] == "aider"
+
+
+class TestEmitWarpNotification:
+    def test_writes_osc9_sequence_to_explicit_stream(self) -> None:
+        buf = io.StringIO()
+        emit_warp_notification("hello warp", stream=buf)
+        assert buf.getvalue() == "\033]9;hello warp\007"
+
+    def test_message_is_included_verbatim(self) -> None:
+        buf = io.StringIO()
+        emit_warp_notification("specsmith run | myproj | governance active", stream=buf)
+        assert "specsmith run | myproj | governance active" in buf.getvalue()
+
+    def test_empty_message_still_writes_osc_frame(self) -> None:
+        buf = io.StringIO()
+        emit_warp_notification("", stream=buf)
+        # Should still write the OSC frame (empty body is valid)
+        assert "\033]9;" in buf.getvalue()
+
+    def test_no_exception_on_closed_stream(self) -> None:
+        buf = io.StringIO()
+        buf.close()
+        # Must not raise
+        emit_warp_notification("test", stream=buf)
+
+
+class TestBannerReflectsTerminal:
+    def test_runner_reads_terminal(self, tmp_path, monkeypatch) -> None:
+        monkeypatch.setenv("TERM_PROGRAM", "WarpTerminal")
+        from specsmith.agent.runner import AgentRunner
+
+        runner = AgentRunner(project_dir=str(tmp_path), json_events=True)
+        assert runner.terminal.is_warp is True
+
+    def test_runner_sets_specsmith_run_active(self, tmp_path, monkeypatch) -> None:
+        import os
+
+        monkeypatch.delenv("SPECSMITH_RUN_ACTIVE", raising=False)
+        from specsmith.agent.runner import AgentRunner
+
+        AgentRunner(project_dir=str(tmp_path), json_events=True)
+        assert os.environ.get("SPECSMITH_RUN_ACTIVE") == "1"

specsmith-0.20.1.dev749/src/specsmith/agent/terminal_env.py

@@ -1,43 +0,0 @@
-# SPDX-License-Identifier: MIT
-# Copyright (c) 2026 Layer1Labs Silicon, Inc. All rights reserved.
-"""Terminal-environment detection for specsmith (REQ-444).
-
-Lets the interactive REPL (``specsmith run``) detect when it is running
-inside Warp so it can adapt its banner / ``ready`` frame.  Detection is
-based on the standard ``TERM_PROGRAM`` signal Warp sets, plus any
-``WARP_*`` environment variables, and is purely read-only.
-"""
-
-from __future__ import annotations
-
-import os
-from dataclasses import asdict, dataclass
-
-
-@dataclass(frozen=True)
-class TerminalInfo:
-    """Information about the host terminal."""
-
-    is_warp: bool
-    program: str
-    version: str
-
-    def as_dict(self) -> dict[str, object]:
-        """Return a flat dict suitable for the ``ready`` event frame."""
-        return asdict(self)
-
-
-def detect_terminal(env: dict[str, str] | None = None) -> TerminalInfo:
-    """Detect the host terminal from environment variables.
-
-    Warp sets ``TERM_PROGRAM=WarpTerminal`` (and ``TERM_PROGRAM_VERSION``).
-    As a fallback we also treat the presence of any ``WARP_*`` variable as a
-    Warp signal.  Pass *env* to override ``os.environ`` (used by tests).
-    """
-    source = os.environ if env is None else env
-    program = (source.get("TERM_PROGRAM") or "").strip()
-    version = (source.get("TERM_PROGRAM_VERSION") or "").strip()
-    is_warp = program == "WarpTerminal" or any(k.startswith("WARP_") for k in source)
-    if is_warp and not program:
-        program = "WarpTerminal"
-    return TerminalInfo(is_warp=is_warp, program=program, version=version)