specsmith 0.12.0.dev494__tar.gz → 0.12.0.dev496__tar.gz

{specsmith-0.12.0.dev494/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.dev494
+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.dev494 → specsmith-0.12.0.dev496}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "specsmith"
-version = "0.12.0.dev494"
+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.dev494 → 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.dev494 → 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."""
@@ -9049,46 +9069,44 @@ 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)
+@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=(
-        "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."
+        "Extra project directories to add on top of the registry (comma-separated absolute paths)."
     ),
 )
-def mcp_serve_cmd(project_dir: str, project_dirs: str) -> None:
+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 seven 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
-    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
-    Single-project Warp config (Settings → Agents → MCP servers)::
+    Then register each project once from inside that project::
 
-        {"specsmith-governance": {"command": "specsmith",
-         "args": ["mcp", "serve", "--project-dir", "/path/to/project"]}}
+        specsmith mcp register
 
     \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"]}}
+    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 "..."
     """
@@ -9099,42 +9117,52 @@ def mcp_serve_cmd(project_dir: str, project_dirs: str) -> None:
 
 
 @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, project_dirs: 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.
-
-    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
     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")
-    )
-    default_dir = str(Path(project_dir).resolve())
-    args: list[str] = ["mcp", "serve", "--project-dir", default_dir]
+    # 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",
+    }
 
-    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)]
+    # 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,
+            "command": cmd,
             "args": args,
+            "env": server_env,
         }
     }
 
@@ -9148,22 +9176,124 @@ def mcp_install_warp_cmd(project_dir: str, project_dirs: str, as_json: bool) ->
         "or pass inline to [bold]oz agent run --mcp '<json>'[/bold]:\n"
     )
     console.print(_json.dumps(config, indent=2))
-    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]"
-        )
+    console.print(
+        "\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(
-            "\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]"
+            "[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]"
+    )
 
 
 main.add_command(mcp_group)

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

@@ -36,6 +36,7 @@ No external dependencies — stdlib only + existing specsmith modules.
 from __future__ import annotations
 
 import json
+import os
 import sys
 import time
 from pathlib import Path
@@ -59,6 +60,68 @@ _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",
@@ -615,7 +678,7 @@ def _handle_request(msg: dict[str, Any]) -> dict[str, Any] | None:
 
 
 def run_server(
-    project_dir: str = ".",
+    project_dir: str | None = None,
     extra_project_dirs: list[str] | None = None,
 ) -> None:
     """Start the MCP stdio server. Blocks until stdin closes.
@@ -623,23 +686,48 @@ def run_server(
     Reads newline-delimited JSON-RPC 2.0 messages from stdin and
     writes responses to stdout. Stderr is used for diagnostic messages.
 
-    ``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``.
+    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).
 
-    The server no longer calls ``os.chdir()``; all paths are resolved
-    absolutely, so the server can serve multiple projects from one process.
+    All paths are resolved to absolute form; duplicates are silently dropped.
+    The server never calls ``os.chdir()``.
     """
     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)
+    all_dirs: list[str] = []
+    seen: set[str] = set()
+
+    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()
@@ -665,4 +753,14 @@ def run_server(
             _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.dev494 → 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.dev494
+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.dev494 → specsmith-0.12.0.dev496}/tests/test_auditor.py

@@ -304,3 +304,92 @@ class TestAcceptedWarningsSuppression:
         assert report.suppressed_count == 2
         assert report.failed == 0
         assert report.healthy is True
+
+
+# ---------------------------------------------------------------------------
+# Regression: issue #195 — LEDGER open-TODO counter false positive
+# ---------------------------------------------------------------------------
+
+
+class TestLedgerTodoCounterRegression:
+    """Regression tests for #195 — prose '- [ ]' strings must not be counted."""
+
+    def test_prose_todo_reference_not_counted(self, tmp_path: Path) -> None:
+        """A narrative Checks run: line referencing '- [ ]' must not add open TODOs."""
+        from specsmith.auditor import check_ledger_health
+
+        ledger = (
+            "# Ledger\n\n"
+            "## Session 2026-05-30\n"
+            "### Checks run:\n"
+            "- TODO closure: all 109 - [ ] items changed to - [x] (batch, 2026-05-30)\n"
+        )
+        (tmp_path / "LEDGER.md").write_text(ledger, encoding="utf-8")
+        results = check_ledger_health(tmp_path)
+        todo_result = next(r for r in results if r.name == "ledger-open-todos")
+        assert todo_result.passed
+        assert "0 open" in todo_result.message
+
+    def test_real_open_todo_is_counted(self, tmp_path: Path) -> None:
+        """A genuine checklist item starting with '- [ ]' must still be counted."""
+        from specsmith.auditor import check_ledger_health
+
+        ledger = "# Ledger\n\n" + "\n".join(f"- [ ] item {i}" for i in range(25))
+        (tmp_path / "LEDGER.md").write_text(ledger, encoding="utf-8")
+        results = check_ledger_health(tmp_path)
+        todo_result = next(r for r in results if r.name == "ledger-open-todos")
+        assert not todo_result.passed
+        assert "25 open" in todo_result.message
+
+
+# ---------------------------------------------------------------------------
+# Regression: issue #194 — check_type_mismatch false positive for FPGA types
+# ---------------------------------------------------------------------------
+
+
+class TestTypeMismatchExplicitOnlyTypes:
+    """Regression tests for #194 — hardware/vendor types skip auto-detection."""
+
+    def test_fpga_rtl_amd_skips_detection(self, tmp_path: Path) -> None:
+        """fpga-rtl-amd type must pass type-mismatch even when Python files dominate."""
+        from specsmith.auditor import check_type_mismatch
+
+        # Lots of .py files to simulate an FPGA project with Python tooling
+        src = tmp_path / "python"
+        src.mkdir()
+        for i in range(20):
+            (src / f"tool_{i}.py").write_text("pass\n", encoding="utf-8")
+
+        (tmp_path / "scaffold.yml").write_text(
+            "name: fpga-project\ntype: fpga-rtl-amd\nspec_version: 0.10.1\nvcs_platform: github\n",
+            encoding="utf-8",
+        )
+        results = check_type_mismatch(tmp_path)
+        assert len(results) == 1
+        assert results[0].passed
+        assert "explicitly set" in results[0].message
+
+    @pytest.mark.parametrize(
+        "ptype",
+        [
+            "fpga-rtl",
+            "fpga-rtl-intel",
+            "fpga-rtl-lattice",
+            "mixed-fpga-embedded",
+            "mixed-fpga-firmware",
+            "embedded-hardware",
+            "pcb-hardware",
+            "yocto-bsp",
+        ],
+    )
+    def test_all_explicit_only_types_skip_detection(self, tmp_path: Path, ptype: str) -> None:
+        """Every member of _EXPLICIT_ONLY_TYPES must bypass auto-detection."""
+        from specsmith.auditor import check_type_mismatch
+
+        (tmp_path / "scaffold.yml").write_text(
+            f"name: proj\ntype: {ptype}\nspec_version: 0.10.1\nvcs_platform: github\n",
+            encoding="utf-8",
+        )
+        results = check_type_mismatch(tmp_path)
+        assert len(results) == 1
+        assert results[0].passed