specsmith 0.12.0.dev493__tar.gz → 0.12.0.dev496__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.12.0.dev493
+Version: 0.12.0.dev496
 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.dev496}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "specsmith"
-version = "0.12.0.dev493"
+version = "0.12.0.dev496"
 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.dev496}/src/specsmith/auditor.py

@@ -441,9 +441,11 @@ def check_ledger_health(root: Path) -> list[AuditResult]:
             )
         )
 
-    # Open TODOs
-    open_todos = sum(1 for line in lines if "- [ ]" in line)
-    closed_todos = sum(1 for line in lines if "- [x]" in line)
+    # Open TODOs — only count lines where the checklist marker is at the
+    # start of the trimmed line, not prose references such as:
+    #   "- TODO closure: all 109 - [ ] items changed to - [x]"
+    open_todos = sum(1 for line in lines if line.lstrip().startswith("- [ ]"))
+    closed_todos = sum(1 for line in lines if line.lstrip().startswith("- [x]"))
     if open_todos > 20:
         results.append(
             AuditResult(
@@ -715,8 +717,34 @@ def check_tool_configuration(root: Path) -> list[AuditResult]:
     return results
 
 
+# Types that require explicit configuration and cannot be reliably inferred
+# from file-extension counts alone.  When a project declares one of these,
+# auto-detection is skipped so that auxiliary tooling languages (e.g. Python
+# verification scripts in an FPGA project) do not produce a false-positive
+# mismatch.  See GitHub issue #194.
+_EXPLICIT_ONLY_TYPES: frozenset[str] = frozenset(
+    [
+        "fpga-rtl",
+        "fpga-rtl-amd",
+        "fpga-rtl-intel",
+        "fpga-rtl-lattice",
+        "mixed-fpga-embedded",
+        "mixed-fpga-firmware",
+        "embedded-hardware",
+        "pcb-hardware",
+        "yocto-bsp",
+    ]
+)
+
+
 def check_type_mismatch(root: Path) -> list[AuditResult]:
-    """Check if scaffold.yml type matches actual detected project type."""
+    """Check if scaffold.yml type matches actual detected project type.
+
+    For hardware / vendor-specific types that cannot be auto-detected from
+    file-extension counts (see ``_EXPLICIT_ONLY_TYPES``), the detection step
+    is skipped entirely so that auxiliary languages (e.g. Python scripts in an
+    FPGA project) never produce a false-positive mismatch.
+    """
     results: list[AuditResult] = []
     scaffold_path = root / "scaffold.yml"
     if not scaffold_path.exists():
@@ -731,6 +759,20 @@ def check_type_mismatch(root: Path) -> list[AuditResult]:
         with open(scaffold_path) as f:
             raw = yaml.safe_load(f)
         config = ProjectConfig(**raw)
+
+        # Skip auto-detection for types that must be specified explicitly.
+        if config.type in _EXPLICIT_ONLY_TYPES:
+            results.append(
+                AuditResult(
+                    name="type-mismatch",
+                    passed=True,
+                    message=(
+                        f"Project type {config.type} is explicitly set; auto-detection skipped"
+                    ),
+                )
+            )
+            return results
+
         detected = detect_project(root)
         if detected.inferred_type and detected.inferred_type != config.type:
             results.append(

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

@@ -350,6 +350,16 @@ def init(config_path: str | None, output_dir: str, no_git: bool, guided: bool) -
 
     write_phase(target, "inception")
 
+    # Auto-register with the MCP governance server (best-effort, never blocks)
+    with contextlib.suppress(Exception):
+        from specsmith.mcp_server import register_project
+
+        if register_project(str(target)):
+            console.print(
+                "  [dim]\u2713 Registered with MCP server "
+                "([bold]specsmith mcp projects[/bold] to view)[/dim]"
+            )
+
 
 def _load_config_with_inheritance(config_path: str) -> dict[str, object]:
     """Load scaffold.yml, merging parent config if `extends` is set."""
@@ -1746,6 +1756,16 @@ def import_project(
     console.print(f"\n[bold green]Done.[/bold green] {len(created)} governance files generated.")
     console.print("Governance files generated. Review project configuration.")
 
+    # Auto-register with the MCP governance server (best-effort, never blocks)
+    with contextlib.suppress(Exception):
+        from specsmith.mcp_server import register_project
+
+        if register_project(str(root)):
+            console.print(
+                "  [dim]\u2713 Registered with MCP server "
+                "([bold]specsmith mcp projects[/bold] to view)[/dim]"
+            )
+
 
 def _run_guided_architecture(cfg: ProjectConfig, target: Path) -> list[Path]:
     """Run interactive architecture definition and generate REQ/TEST stubs."""
@@ -3207,32 +3227,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 "
@@ -9020,42 +9069,63 @@ 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-dir",
+    type=click.Path(),
+    default=None,
+    help=(
+        "Set this path as the *primary* project (first slot / default for tool calls "
+        "that omit project_dir). Omit to use the registry automatically."
+    ),
+)
+@click.option(
+    "--project-dirs",
+    default="",
+    help=(
+        "Extra project directories to add on top of the registry (comma-separated absolute paths)."
+    ),
+)
+def mcp_serve_cmd(project_dir: str | None, 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_audit        Run governance audit
-    governance_checkpoint   Emit GOVERNANCE ANCHOR JSON
-    governance_preflight    Preflight a change intent
-    governance_phase        Current AEE phase + readiness %
-    governance_req_list     List all requirements
-    governance_trace_seal   Seal a milestone/decision
+    Recommended Warp config (set once, never touch again)::
+
+        {"specsmith-governance": {"command": "specsmith", "args": ["mcp", "serve"]}}
 
     \b
-    Warp config (Settings → Agents → MCP servers)::
+    Then register each project once from inside that project::
 
-        {"specsmith-governance": {"command": "specsmith", "args": ["mcp", "serve"]}}
+        specsmith mcp register
+
+    \b
+    The server reads the registry at startup and serves all registered
+    projects automatically — no config changes needed for new projects.
 
     \b
-    Or pass inline to oz (use ``specsmith mcp install-warp`` for the full snippet)::
+    Or pass inline to oz (use ``specsmith mcp install-warp`` for the snippet)::
 
         oz agent run --mcp "$(specsmith mcp install-warp --json)" --prompt "..."
     """
     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("--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(as_json: bool) -> None:
     """Print the Warp MCP config snippet for the governance server (REQ-363).
 
+    Generates a minimal, registry-aware config — paste it into Warp once
+    and never change it again.  Register new projects with::
+
+        specsmith mcp register          # in the project directory
+
     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.
     """
@@ -9063,15 +9133,36 @@ def mcp_install_warp_cmd(project_dir: str, as_json: bool) -> None:
     import shutil
     import sys
 
-    # Resolve the specsmith CLI executable: prefer the one on PATH, then
-    # fall back to deriving it from the current interpreter (dev installs).
-    specsmith_exe = shutil.which("specsmith") or str(
-        Path(sys.executable).parent / ("specsmith.exe" if sys.platform == "win32" else "specsmith")
-    )
+    # Env vars the server needs regardless of how it is invoked.
+    # SPECSMITH_ALLOW_NON_PIPX=1  — prevents the pipx-enforcement gate from
+    #   exiting before the MCP handshake when Warp starts the server directly.
+    # SPECSMITH_NO_AUTO_UPDATE / SPECSMITH_PYPI_CHECKED  — suppress network
+    #   calls on startup so the server responds immediately.
+    server_env = {
+        "SPECSMITH_ALLOW_NON_PIPX": "1",
+        "SPECSMITH_NO_AUTO_UPDATE": "1",
+        "SPECSMITH_PYPI_CHECKED": "1",
+    }
+
+    # Executable detection strategy (in priority order):
+    # 1. specsmith (or specsmith.exe) on PATH — covers pipx shims and system installs.
+    # 2. python -m specsmith via the current interpreter — reliable fallback
+    #    for editable dev installs and venvs where the console script wrapper
+    #    is absent or resolves incorrectly (e.g. some Windows pipx setups).
+    specsmith_exe = shutil.which("specsmith") or shutil.which("specsmith.exe")
+    if specsmith_exe:
+        cmd = specsmith_exe
+        args: list[str] = ["mcp", "serve"]
+    else:
+        # Fall back to `python -m specsmith` using the current interpreter.
+        cmd = sys.executable
+        args = ["-m", "specsmith", "mcp", "serve"]
+
     config = {
         "specsmith-governance": {
-            "command": specsmith_exe,
-            "args": ["mcp", "serve", "--project-dir", str(Path(project_dir).resolve())],
+            "command": cmd,
+            "args": args,
+            "env": server_env,
         }
     }
 
@@ -9086,10 +9177,122 @@ def mcp_install_warp_cmd(project_dir: str, as_json: bool) -> None:
     )
     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]"
+        "\n[dim][bold]One-time setup[/bold] — paste this config into Warp once,"  # noqa: E501
+        " then never touch it again.\n"
+        "\nTo add each project, run this inside the project directory:\n"
+        "  [bold]specsmith mcp register[/bold]\n"
+        "\nThe server reads [bold]~/.specsmith/mcp-projects.json[/bold] at startup\n"
+        "and serves all registered projects automatically.\n"
+        "\nView registered projects: [bold]specsmith mcp projects[/bold]\n"
+        "\nVerify server: specsmith mcp serve (then send an initialize message).[/dim]"
+    )
+
+
+@mcp_group.command(name="register")
+@click.argument("path", default=".", required=False)
+def mcp_register_cmd(path: str) -> None:
+    """Register a project directory with the MCP server registry.
+
+    Run once inside a project directory to add it to
+    ``~/.specsmith/mcp-projects.json``.  The next ``specsmith mcp serve``
+    invocation will automatically include it — no Warp config changes needed.
+
+    \b
+    Examples::
+
+        specsmith mcp register          # register current directory
+        specsmith mcp register /path/to/myproject
+    """
+    from specsmith.mcp_server import register_project
+
+    root = Path(path).resolve()
+    if not root.exists():
+        console.print(f"[red]\u2717[/red] Path does not exist: {root}")
+        raise SystemExit(1)
+
+    added = register_project(str(root))
+    if added:
+        console.print(f"[green]\u2713[/green] Registered: [bold]{root}[/bold]")
+        if not (root / ".specsmith").exists():
+            console.print(
+                "  [yellow]\u26a0[/yellow] No .specsmith/ found. "
+                "Run [bold]specsmith init[/bold] or [bold]specsmith import[/bold] first."
+            )
+    else:
+        console.print(f"[dim]Already registered: {root}[/dim]")
+    console.print(
+        "  [dim]specsmith mcp projects  ← view all registered[/dim]\n"
+        "  [dim]specsmith mcp serve      ← start the server[/dim]"
+    )
+
+
+@mcp_group.command(name="unregister")
+@click.argument("path", default=".", required=False)
+def mcp_unregister_cmd(path: str) -> None:
+    """Remove a project directory from the MCP server registry.
+
+    \b
+    Examples::
+
+        specsmith mcp unregister          # unregister current directory
+        specsmith mcp unregister /path/to/myproject
+    """
+    from specsmith.mcp_server import unregister_project
+
+    root = Path(path).resolve()
+    removed = unregister_project(str(root))
+    if removed:
+        console.print(f"[green]\u2713[/green] Unregistered: [bold]{root}[/bold]")
+    else:
+        console.print(f"[yellow]Not registered: {root}[/yellow]")
+
+
+@mcp_group.command(name="projects")
+@click.option("--json", "as_json", is_flag=True, default=False, help="Emit as JSON.")
+def mcp_projects_cmd(as_json: bool) -> None:
+    """List all projects registered with the MCP server.
+
+    Shows each registered project path and whether it still exists on disk.
+    The first entry is the default (used when a tool call omits project_dir).
+    """
+    import json as _json
+    import os
+
+    from specsmith.mcp_server import _registry_file, read_registry
+
+    projects = read_registry()
+    reg_path = _registry_file()
+
+    if as_json:
+        entries = [
+            {"path": p, "exists": Path(p).exists(), "is_default": i == 0}
+            for i, p in enumerate(projects)
+        ]
+        click.echo(_json.dumps({"registry": str(reg_path), "projects": entries}, indent=2))
+        return
+
+    if not projects:
+        console.print("[yellow]No projects registered.[/yellow]")
+        console.print(
+            "[dim]Run [bold]specsmith mcp register[/bold] inside a project to add it.[/dim]"
+        )
+        return
+
+    console.print(
+        f"[bold]Registered MCP projects[/bold] ({len(projects)})  [dim]{reg_path}[/dim]\n"
+    )
+    for i, p in enumerate(projects):
+        exists = Path(p).exists()
+        default_tag = "  [bold cyan][default][/bold cyan]" if i == 0 else ""
+        health = "[green]\u2713 exists[/green]" if exists else "[red]\u2717 not found[/red]"
+        # Abbreviate long paths using ~ for home
+        display = p.replace(os.path.expanduser("~"), "~")
+        console.print(f"  {health}  {display}{default_tag}")
+
+    console.print(
+        "\n[dim]  specsmith mcp register [path]    ← add a project"
+        "\n  specsmith mcp unregister [path]  ← remove a project"
+        "\n  specsmith mcp serve              ← start the server[/dim]"
     )
 
 

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

@@ -35,8 +35,8 @@ No external dependencies — stdlib only + existing specsmith modules.
 
 from __future__ import annotations
 
-import contextlib
 import json
+import os
 import sys
 import time
 from pathlib import Path
@@ -50,7 +50,92 @@ 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] = []
+
+
+# ---------------------------------------------------------------------------
+# Persistent project registry  (~/.specsmith/mcp-projects.json)
+# ---------------------------------------------------------------------------
+
+
+def _registry_file() -> Path:
+    """Return the path to the user-level MCP project registry file.
+
+    Respects ``SPECSMITH_HOME`` if set; otherwise uses
+    ``~/.specsmith/mcp-projects.json``.
+    """
+    base = os.environ.get("SPECSMITH_HOME", "").strip()
+    home = Path(base) if base else Path.home() / ".specsmith"
+    return home / "mcp-projects.json"
+
+
+def read_registry() -> list[str]:
+    """Return all absolute project paths from the registry.
+
+    Returns an empty list when the registry file is missing or malformed.
+    Invalid entries (empty strings, non-strings) are silently skipped.
+    """
+    try:
+        data = json.loads(_registry_file().read_text(encoding="utf-8"))
+        projects = data.get("projects", []) if isinstance(data, dict) else []
+        return [p for p in projects if isinstance(p, str) and p]
+    except Exception:  # noqa: BLE001
+        return []
+
+
+def write_registry(paths: list[str]) -> None:
+    """Persist *paths* to the registry file (creates parent dirs as needed)."""
+    reg = _registry_file()
+    reg.parent.mkdir(parents=True, exist_ok=True)
+    reg.write_text(
+        json.dumps({"projects": paths}, indent=2, ensure_ascii=False),
+        encoding="utf-8",
+    )
+
+
+def register_project(path: str = ".") -> bool:
+    """Add *path* to the registry. Returns True if it was newly added."""
+    abs_path = str(Path(path).resolve())
+    projects = read_registry()
+    if abs_path in projects:
+        return False
+    projects.append(abs_path)
+    write_registry(projects)
+    return True
+
+
+def unregister_project(path: str = ".") -> bool:
+    """Remove *path* from the registry. Returns True if it was present."""
+    abs_path = str(Path(path).resolve())
+    projects = read_registry()
+    if abs_path not in projects:
+        return False
+    write_registry([p for p in projects if p != abs_path])
+    return True
+
+
 _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 +280,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 +587,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 +677,57 @@ 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 | None = None,
+    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.
+
+    Project discovery order (highest priority first):
+
+    1. ``project_dir`` — if provided, becomes the *default* project (first
+       slot).  Any tool call that omits ``project_dir`` will target this.
+    2. **Registry** — all paths in ``~/.specsmith/mcp-projects.json`` are
+       merged in.  Run ``specsmith mcp register`` in a project once to add it.
+    3. ``extra_project_dirs`` — additional paths appended after the registry.
+    4. **Fallback** — if nothing resolves, the current working directory is
+       used (useful for development/testing).
+
+    All paths are resolved to absolute form; duplicates are silently dropped.
+    The server never calls ``os.chdir()``.
     """
-    import os
+    global _DEFAULT_PROJECT_DIR, _REGISTERED_PROJECTS
+
+    all_dirs: list[str] = []
+    seen: set[str] = set()
 
-    # 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)
+    def _add(p: str) -> None:
+        abs_p = str(Path(p).resolve())
+        if abs_p not in seen:
+            seen.add(abs_p)
+            all_dirs.append(abs_p)
+
+    # 1. Explicit primary project (becomes the default)
+    if project_dir is not None:
+        _add(project_dir)
+
+    # 2. Persistent registry
+    for p in read_registry():
+        _add(p)
+
+    # 3. Additional explicit dirs
+    for p in extra_project_dirs or []:
+        _add(p)
+
+    # 4. CWD fallback when nothing is registered
+    if not all_dirs:
+        _add(".")
+
+    _DEFAULT_PROJECT_DIR = all_dirs[0]
+    _REGISTERED_PROJECTS = all_dirs
 
     for raw_line in sys.stdin:
         raw_line = raw_line.strip()
@@ -615,4 +753,14 @@ def run_server(project_dir: str = ".") -> None:
             _send(response)
 
 
-__all__ = ["run_server", "SERVER_NAME", "SERVER_VERSION", "_TOOLS", "_HANDLERS"]
+__all__ = [
+    "run_server",
+    "read_registry",
+    "write_registry",
+    "register_project",
+    "unregister_project",
+    "SERVER_NAME",
+    "SERVER_VERSION",
+    "_TOOLS",
+    "_HANDLERS",
+]

{specsmith-0.12.0.dev493 → specsmith-0.12.0.dev496/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.dev496
 Summary: Applied Epistemic Engineering toolkit — AEE agent sessions, execution profiles, FPGA/HDL governance, tool installer, 50+ CLI commands.
 Author: BitConcepts
 License-Expression: MIT