specsmith 0.12.0.dev493__tar.gz → 0.12.0.dev494__tar.gz

{specsmith-0.12.0.dev493/src/specsmith.egg-info → specsmith-0.12.0.dev494}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.12.0.dev493
+Version: 0.12.0.dev494
 Summary: Applied Epistemic Engineering toolkit — AEE agent sessions, execution profiles, FPGA/HDL governance, tool installer, 50+ CLI commands.
 Author: BitConcepts
 License-Expression: MIT

{specsmith-0.12.0.dev493 → specsmith-0.12.0.dev494}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "specsmith"
-version = "0.12.0.dev493"
+version = "0.12.0.dev494"
 description = "Applied Epistemic Engineering toolkit — AEE agent sessions, execution profiles, FPGA/HDL governance, tool installer, 50+ CLI commands."
 readme = "README.md"
 license = "MIT"

{specsmith-0.12.0.dev493 → specsmith-0.12.0.dev494}/src/specsmith/cli.py

@@ -3207,32 +3207,61 @@ def checkpoint_cmd(project_dir: str, as_json: bool) -> None:
 
     # ── Human-readable anchor block ───────────────────────────────────────────
     # Designed to be compact and survive context summarization.
-    hbar = "\u2550" * 57  # ═══…
+    _w = 57  # interior width — must match len(hbar)
+    hbar = "\u2550" * _w  # ═══…
     vbar = "\u2551"  # ║
     health_icon = "\u2713" if health_ok else "\u2717"
     esdb_icon = "\u2713" if esdb_ok else "\u2717"
     wi_str = ", ".join(recent_wis) if recent_wis else "none seen"
 
+    def _arow(rich: str, plain: str, wide: int = 0) -> str:
+        """Format one anchor box row: ║ <content padded to _w terminal cols> ║.
+
+        ``plain`` is the markup-free string used for width calculation.
+        ``wide`` is the count of 2-wide (full-width/emoji) characters in ``plain``
+        that add an extra terminal column beyond their Python ``len()``.
+        """
+        pad = " " * max(0, _w - len(plain) - wide)
+        return f"[bold cyan]{vbar}[/bold cyan]{rich}{pad}[bold cyan]{vbar}[/bold cyan]"
+
     console.print(f"[bold cyan]\u2554{hbar}\u2557[/bold cyan]")
-    console.print(f"[bold cyan]{vbar}[/bold cyan] GOVERNANCE ANCHOR  {ts}")
-    console.print(f"[bold cyan]{vbar}[/bold cyan] Project : [bold]{project_name}[/bold]")
-    console.print(
-        f"[bold cyan]{vbar}[/bold cyan] Phase   : {phase_emoji} {phase_label} ({phase_pct}%)"
+
+    r1 = f" GOVERNANCE ANCHOR  {ts}"
+    console.print(_arow(r1, r1))
+
+    r2_plain = f" Project : {project_name}"
+    console.print(_arow(f" Project : [bold]{project_name}[/bold]", r2_plain))
+
+    r3_plain = f" Phase   : {phase_emoji} {phase_label} ({phase_pct}%)"
+    console.print(_arow(r3_plain, r3_plain, wide=1 if phase_emoji else 0))
+
+    r4_plain = (
+        f" Health  : {health_icon} clean"
+        if health_ok
+        else f" Health  : {health_icon} {audit_failed} issues"
     )
-    health_str = (
-        f"[green]{health_icon} clean[/green]"
+    r4_rich = (
+        f" Health  : [green]{health_icon} clean[/green]"
         if health_ok
-        else f"[red]{health_icon} {audit_failed} issues[/red]"
+        else f" Health  : [red]{health_icon} {audit_failed} issues[/red]"
     )
-    console.print(f"[bold cyan]{vbar}[/bold cyan] Health  : {health_str}")
-    console.print(
-        f"[bold cyan]{vbar}[/bold cyan] REQs    : {req_count}   TESTs: {test_count}"
+    console.print(_arow(r4_rich, r4_plain))
+
+    r5 = (
+        f" REQs    : {req_count}   TESTs: {test_count}"
         f"   ESDB: {esdb_records} records ({esdb_icon} chain)"
     )
-    console.print(f"[bold cyan]{vbar}[/bold cyan] WIs     : {wi_str}")
+    console.print(_arow(r5, r5))
+
+    r6 = f" WIs     : {wi_str}"
+    console.print(_arow(r6, r6))
+
     if last_preflight:
-        pf_short = last_preflight[:55]
-        console.print(f"[bold cyan]{vbar}[/bold cyan] Preflight: {pf_short}")
+        _pf_max = _w - len(" Preflight: ")  # 45 — was incorrectly 55
+        pf_short = last_preflight[:_pf_max]
+        r7 = f" Preflight: {pf_short}"
+        console.print(_arow(r7, r7))
+
     console.print(f"[bold cyan]\u255a{hbar}\u255d[/bold cyan]")
     console.print(
         "[dim]Include this block verbatim in any context summary "
@@ -9021,13 +9050,23 @@ def mcp_list_cmd(project_dir: str, as_json: bool) -> None:
 
 @mcp_group.command(name="serve")
 @click.option("--project-dir", type=click.Path(), default=".", show_default=True)
-def mcp_serve_cmd(project_dir: str) -> None:
+@click.option(
+    "--project-dirs",
+    default="",
+    help=(
+        "Additional project directories to register (comma-separated absolute paths). "
+        "All registered projects are accessible to any tool call via their "
+        "absolute path as the project_dir argument."
+    ),
+)
+def mcp_serve_cmd(project_dir: str, project_dirs: str) -> None:
     """Start the native governance MCP stdio server (REQ-363).
 
     Implements MCP 2024-11-05 over stdin/stdout (JSON-RPC 2.0).
-    Exposes six governance tools to any MCP client:
+    Exposes seven governance tools to any MCP client:
 
     \b
+    governance_project_list List all registered projects
     governance_audit        Run governance audit
     governance_checkpoint   Emit GOVERNANCE ANCHOR JSON
     governance_preflight    Preflight a change intent
@@ -9036,9 +9075,17 @@ def mcp_serve_cmd(project_dir: str) -> None:
     governance_trace_seal   Seal a milestone/decision
 
     \b
-    Warp config (Settings → Agents → MCP servers)::
+    Single-project Warp config (Settings → Agents → MCP servers)::
 
-        {"specsmith-governance": {"command": "specsmith", "args": ["mcp", "serve"]}}
+        {"specsmith-governance": {"command": "specsmith",
+         "args": ["mcp", "serve", "--project-dir", "/path/to/project"]}}
+
+    \b
+    Multi-project Warp config::
+
+        {"specsmith-governance": {"command": "specsmith",
+         "args": ["mcp", "serve", "--project-dir", "/path/to/proj1",
+                  "--project-dirs", "/path/to/proj2,/path/to/proj3"]}}
 
     \b
     Or pass inline to oz (use ``specsmith mcp install-warp`` for the full snippet)::
@@ -9047,17 +9094,26 @@ def mcp_serve_cmd(project_dir: str) -> None:
     """
     from specsmith.mcp_server import run_server
 
-    run_server(project_dir=project_dir)
+    extra = [p.strip() for p in project_dirs.split(",") if p.strip()] if project_dirs else []
+    run_server(project_dir=project_dir, extra_project_dirs=extra)
 
 
 @mcp_group.command(name="install-warp")
 @click.option("--project-dir", type=click.Path(), default=".", show_default=True)
+@click.option(
+    "--project-dirs",
+    default="",
+    help="Additional project dirs (comma-separated) to include in the multi-project config.",
+)
 @click.option("--json", "as_json", is_flag=True, default=False, help="Emit JSON config only.")
-def mcp_install_warp_cmd(project_dir: str, as_json: bool) -> None:
+def mcp_install_warp_cmd(project_dir: str, project_dirs: str, as_json: bool) -> None:
     """Print the Warp MCP config snippet for the governance server (REQ-363).
 
     Copy the output into Warp Settings → Agents → MCP servers, or pass it
     to ``oz agent run --mcp '<json>'`` for a one-off cloud agent run.
+
+    For multi-project setups pass ``--project-dirs`` with comma-separated
+    absolute paths; one server instance will serve all projects.
     """
     import json as _json
     import shutil
@@ -9068,10 +9124,17 @@ def mcp_install_warp_cmd(project_dir: str, as_json: bool) -> None:
     specsmith_exe = shutil.which("specsmith") or str(
         Path(sys.executable).parent / ("specsmith.exe" if sys.platform == "win32" else "specsmith")
     )
+    default_dir = str(Path(project_dir).resolve())
+    args: list[str] = ["mcp", "serve", "--project-dir", default_dir]
+
+    extra_dirs = [p.strip() for p in project_dirs.split(",") if p.strip()] if project_dirs else []
+    if extra_dirs:
+        args += ["--project-dirs", ",".join(extra_dirs)]
+
     config = {
         "specsmith-governance": {
             "command": specsmith_exe,
-            "args": ["mcp", "serve", "--project-dir", str(Path(project_dir).resolve())],
+            "args": args,
         }
     }
 
@@ -9085,12 +9148,22 @@ def mcp_install_warp_cmd(project_dir: str, as_json: bool) -> None:
         "or pass inline to [bold]oz agent run --mcp '<json>'[/bold]:\n"
     )
     console.print(_json.dumps(config, indent=2))
-    console.print(
-        "\n[dim]After adding, Warp/Oz can call governance_audit, governance_preflight,\n"
-        "governance_checkpoint, governance_phase, governance_req_list, and\n"
-        "governance_trace_seal as structured MCP tool calls.\n"
-        "\nVerify with: specsmith mcp serve (then send an initialize message).[/dim]"
-    )
+    if extra_dirs:
+        console.print(
+            f"\n[dim]Serving {1 + len(extra_dirs)} projects. "
+            "Call [bold]governance_project_list[/bold] to see all registered paths,\n"
+            "then pass any path as [bold]project_dir[/bold] to target a specific project.[/dim]"
+        )
+    else:
+        console.print(
+            "\n[dim]After adding, Warp/Oz can call governance_project_list, "
+            "governance_audit, governance_preflight,\n"
+            "governance_checkpoint, governance_phase, governance_req_list, and\n"
+            "governance_trace_seal as structured MCP tool calls.\n"
+            "\nFor multiple projects add --project-dirs /path/a,/path/b to serve them "
+            "all from one server instance.\n"
+            "\nVerify with: specsmith mcp serve (then send an initialize message).[/dim]"
+        )
 
 
 main.add_command(mcp_group)

{specsmith-0.12.0.dev493 → specsmith-0.12.0.dev494}/src/specsmith/mcp_server.py

@@ -35,7 +35,6 @@ No external dependencies — stdlib only + existing specsmith modules.
 
 from __future__ import annotations
 
-import contextlib
 import json
 import sys
 import time
@@ -50,7 +49,30 @@ MCP_PROTOCOL_VERSION = "2024-11-05"
 SERVER_NAME = "specsmith-governance"
 SERVER_VERSION = "0.12.0"
 
+# ---------------------------------------------------------------------------
+# Multi-project state — populated by run_server() at startup
+# ---------------------------------------------------------------------------
+
+# Default project dir used when a tool call omits ``project_dir``.
+_DEFAULT_PROJECT_DIR: str = "."
+
+# All registered project directories (absolute paths), default first.
+_REGISTERED_PROJECTS: list[str] = []
+
 _TOOLS: list[dict[str, Any]] = [
+    {
+        "name": "governance_project_list",
+        "description": (
+            "List all project directories registered in this MCP server instance. "
+            "Use the returned paths as the `project_dir` argument for other tools "
+            "when working with multiple simultaneous projects."
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {},
+            "required": [],
+        },
+    },
     {
         "name": "governance_audit",
         "description": (
@@ -195,10 +217,25 @@ _TOOLS: list[dict[str, Any]] = [
 
 
 def _resolve_root(args: dict[str, Any]) -> Path:
-    raw = args.get("project_dir", ".")
+    """Resolve project_dir from args, falling back to the server default.
+
+    If ``project_dir`` is not in *args* (or is empty), we use
+    ``_DEFAULT_PROJECT_DIR`` so callers don't have to repeat the path on
+    every tool call when only one project is active.
+    """
+    raw = args.get("project_dir") or _DEFAULT_PROJECT_DIR
     return Path(str(raw)).resolve()
 
 
+def _handle_governance_project_list(args: dict[str, Any]) -> dict[str, Any]:  # noqa: ARG001
+    """Return the list of projects registered in this server instance."""
+    return {
+        "default_project": _DEFAULT_PROJECT_DIR,
+        "projects": _REGISTERED_PROJECTS,
+        "count": len(_REGISTERED_PROJECTS),
+    }
+
+
 def _handle_governance_audit(args: dict[str, Any]) -> dict[str, Any]:
     """Run the governance audit and return structured results."""
     root = _resolve_root(args)
@@ -487,6 +524,7 @@ def _handle_governance_trace_seal(args: dict[str, Any]) -> dict[str, Any]:
 # ---------------------------------------------------------------------------
 
 _HANDLERS = {
+    "governance_project_list": _handle_governance_project_list,
     "governance_audit": _handle_governance_audit,
     "governance_checkpoint": _handle_governance_checkpoint,
     "governance_preflight": _handle_governance_preflight,
@@ -576,20 +614,32 @@ def _handle_request(msg: dict[str, Any]) -> dict[str, Any] | None:
     return None
 
 
-def run_server(project_dir: str = ".") -> None:
+def run_server(
+    project_dir: str = ".",
+    extra_project_dirs: list[str] | None = None,
+) -> None:
     """Start the MCP stdio server. Blocks until stdin closes.
 
     Reads newline-delimited JSON-RPC 2.0 messages from stdin and
     writes responses to stdout. Stderr is used for diagnostic messages.
-    The ``project_dir`` is injected into every tool call that doesn't
-    supply its own ``project_dir`` argument.
-    """
-    import os
 
-    # Set working directory so relative paths in tool calls resolve correctly
-    if project_dir and project_dir != ".":
-        with contextlib.suppress(OSError):
-            os.chdir(project_dir)
+    ``project_dir`` becomes the default for tool calls that omit
+    ``project_dir``.  ``extra_project_dirs`` registers additional projects
+    accessible via ``governance_project_list`` and addressable by any tool
+    using their absolute path as ``project_dir``.
+
+    The server no longer calls ``os.chdir()``; all paths are resolved
+    absolutely, so the server can serve multiple projects from one process.
+    """
+    global _DEFAULT_PROJECT_DIR, _REGISTERED_PROJECTS
+
+    # Register projects — always use absolute paths
+    _DEFAULT_PROJECT_DIR = str(Path(project_dir).resolve())
+    _REGISTERED_PROJECTS = [_DEFAULT_PROJECT_DIR]
+    for extra in extra_project_dirs or []:
+        abs_extra = str(Path(extra).resolve())
+        if abs_extra not in _REGISTERED_PROJECTS:
+            _REGISTERED_PROJECTS.append(abs_extra)
 
     for raw_line in sys.stdin:
         raw_line = raw_line.strip()

{specsmith-0.12.0.dev493 → specsmith-0.12.0.dev494/src/specsmith.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.12.0.dev493
+Version: 0.12.0.dev494
 Summary: Applied Epistemic Engineering toolkit — AEE agent sessions, execution profiles, FPGA/HDL governance, tool installer, 50+ CLI commands.
 Author: BitConcepts
 License-Expression: MIT

{specsmith-0.12.0.dev493 → specsmith-0.12.0.dev494}/tests/test_mcp_server.py

@@ -78,12 +78,13 @@ class TestMcpProtocol:
         assert result["serverInfo"]["name"] == "specsmith-governance"
         assert "tools" in result["capabilities"]
 
-    def test_tools_list_returns_six_tools(self) -> None:
+    def test_tools_list_returns_seven_tools(self) -> None:
         resp = _send_rpc(_make_rpc("tools/list", {}, req_id=2))
         tools = resp["result"]["tools"]
-        assert len(tools) == 6
+        assert len(tools) == 7
         names = {t["name"] for t in tools}
         assert names == {
+            "governance_project_list",
             "governance_audit",
             "governance_checkpoint",
             "governance_preflight",
@@ -311,6 +312,80 @@ class TestGovernanceReqList:
         assert resp["result"]["isError"] is False
 
 
+class TestGovernanceProjectList:
+    def test_returns_default_project(self, tmp_path: Path) -> None:
+        from specsmith.mcp_server import _handle_governance_project_list, run_server
+
+        # Prime server state with a known directory
+        run_server.__func__ if hasattr(run_server, "__func__") else run_server  # noqa: B018
+        import specsmith.mcp_server as _mod
+
+        _mod._DEFAULT_PROJECT_DIR = str(tmp_path)
+        _mod._REGISTERED_PROJECTS = [str(tmp_path)]
+
+        result = _handle_governance_project_list({})
+        assert result["default_project"] == str(tmp_path)
+        assert str(tmp_path) in result["projects"]
+        assert result["count"] >= 1
+
+    def test_via_tools_call(self, tmp_path: Path) -> None:
+        import specsmith.mcp_server as _mod
+
+        _mod._DEFAULT_PROJECT_DIR = str(tmp_path)
+        _mod._REGISTERED_PROJECTS = [str(tmp_path)]
+
+        resp = _send_rpc(
+            _make_rpc(
+                "tools/call",
+                {"name": "governance_project_list", "arguments": {}},
+                req_id=30,
+            )
+        )
+        assert resp["result"]["isError"] is False
+        content = json.loads(resp["result"]["content"][0]["text"])
+        assert "projects" in content
+        assert "count" in content
+
+    def test_extra_projects_registered(self, tmp_path: Path) -> None:
+        """run_server registers extra_project_dirs and they appear in project_list."""
+        import io
+
+        import specsmith.mcp_server as _mod
+        from specsmith.mcp_server import run_server
+
+        extra = tmp_path / "extra"
+        extra.mkdir()
+
+        # Patch stdin to EOF immediately so run_server exits
+        old_stdin = sys.stdin
+        sys.stdin = io.StringIO("")
+        try:
+            run_server(project_dir=str(tmp_path), extra_project_dirs=[str(extra)])
+        finally:
+            sys.stdin = old_stdin
+
+        assert str(tmp_path.resolve()) == _mod._DEFAULT_PROJECT_DIR
+        assert str(extra.resolve()) in _mod._REGISTERED_PROJECTS
+        assert _mod._REGISTERED_PROJECTS[0] == str(tmp_path.resolve())
+
+    def test_no_chdir_called(self, tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
+        """run_server must NOT call os.chdir — paths are resolved absolutely."""
+        import io
+
+        from specsmith.mcp_server import run_server
+
+        chdir_calls: list[str] = []
+        monkeypatch.setattr("os.chdir", lambda p: chdir_calls.append(str(p)))
+        old_stdin = sys.stdin
+        sys.stdin = io.StringIO("")
+        try:
+            run_server(project_dir=str(tmp_path))
+        finally:
+            sys.stdin = old_stdin
+
+        assert chdir_calls == [], "run_server must not call os.chdir"
+
+
 class TestGovernanceTraceSeal:
     def test_missing_description_returns_error(self, tmp_path: Path) -> None:
         from specsmith.mcp_server import _handle_governance_trace_seal
@@ -458,4 +533,4 @@ class TestMcpServeCli:
         tools_resp = json.loads(lines[-1])
         assert "result" in tools_resp
         tools = tools_resp["result"]["tools"]
-        assert len(tools) == 6
+        assert len(tools) == 7