specsmith 0.11.8.dev487__tar.gz → 0.12.0.dev492__tar.gz

{specsmith-0.11.8.dev487/src/specsmith.egg-info → specsmith-0.12.0.dev492}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.11.8.dev487
+Version: 0.12.0.dev492
 Summary: Applied Epistemic Engineering toolkit — AEE agent sessions, execution profiles, FPGA/HDL governance, tool installer, 50+ CLI commands.
 Author: BitConcepts
 License-Expression: MIT
@@ -87,7 +87,7 @@ specsmith treats belief systems like code: codable, testable, and deployable. It
 epistemically-governed projects, stress-tests requirements as BeliefArtifacts, runs
 cryptographically-sealed trace vaults, and orchestrates AI agents under formal AEE governance.
 
-**v0.11.4 — Codity.ai AI code review integration, 70 built-in skills, EU AI Act / NIST AI RMF compliance, context window management, and governance tools panel.**
+**v0.12.0 — Native Warp/Oz MCP governance server, repository workflows, 72 built-in skills, EU AI Act / NIST AI RMF compliance, multi-agent DAG dispatch, and context window management.**
 Specsmith ships a full compliance and auditability layer aligned to the EU AI Act (2024/1689)
 and the NIST AI Risk Management Framework 1.0. Every agent action is cryptographically sealed,
 every AI-generated output is disclosed, context windows are GPU-aware and protected against
@@ -994,6 +994,59 @@ oz agent run-cloud --skill "layer1labs/specsmith:specsmith-save" --prompt "save
 
 ---
 
+## Warp Terminal Integration (v0.12.0)
+
+specsmith ships native integration with [Warp](https://www.warp.dev) terminal — both as
+an MCP server and as repository workflows.
+
+### Native MCP Governance Server
+
+`specsmith mcp serve` starts a zero-dependency stdio MCP server (JSON-RPC 2.0, MCP 2024-11-05).
+Warp/Oz, Cursor, Claude Code, or any other MCP client can call governance commands as structured
+tool calls — no shell roundtrip, fully typed inputs and outputs.
+
+**Setup (one time):**
+
+```bash
+# Get the Warp config snippet
+specsmith mcp install-warp
+```
+
+Copy the output JSON into **Warp Settings → Agents → MCP servers**. Or pass it inline:
+
+```bash
+oz agent run --mcp '{"specsmith-governance": {"command": "specsmith", "args": ["mcp", "serve"]}}' \
+  --prompt "check governance health and preflight my next change"
+```
+
+**Six MCP tools exposed:**
+
+| Tool | What it returns |
+|---|---|
+| `governance_audit` | Full audit health JSON — passed/failed checks, fixable count |
+| `governance_checkpoint` | GOVERNANCE ANCHOR snapshot — phase, health, REQ/TEST counts, ESDB chain |
+| `governance_preflight` | Preflight decision — `accepted`/`needs_clarification` + `work_item_id` |
+| `governance_phase` | Current AEE phase, readiness %, failing checks |
+| `governance_req_list` | All requirements with status + test coverage, filterable |
+| `governance_trace_seal` | Create a cryptographic trace vault seal |
+
+### Repository Workflows (Ctrl+Shift+R)
+
+Clone this repo and open it in Warp — seven governance workflows appear automatically in
+`Ctrl+Shift+R` search:
+
+| Workflow | Command |
+|---|---|
+| specsmith — Session Start | Full bootstrap: kill → migrate → audit → sync → checkpoint |
+| specsmith — Audit | `specsmith audit` |
+| specsmith — Checkpoint | `specsmith checkpoint` (emits GOVERNANCE ANCHOR) |
+| specsmith — Preflight | `specsmith preflight "{{intent}}" --json` |
+| specsmith — Save | `specsmith save` |
+| specsmith — Phase Status | `specsmith phase show` |
+| specsmith — Session End | `specsmith save && specsmith kill-session` |
+
+---
+
 ## The specsmith Bootstrap
 
 specsmith governs itself — the specsmith repo is a specsmith-managed project. Run `specsmith audit`

{specsmith-0.11.8.dev487 → specsmith-0.12.0.dev492}/README.md

@@ -15,7 +15,7 @@ specsmith treats belief systems like code: codable, testable, and deployable. It
 epistemically-governed projects, stress-tests requirements as BeliefArtifacts, runs
 cryptographically-sealed trace vaults, and orchestrates AI agents under formal AEE governance.
 
-**v0.11.4 — Codity.ai AI code review integration, 70 built-in skills, EU AI Act / NIST AI RMF compliance, context window management, and governance tools panel.**
+**v0.12.0 — Native Warp/Oz MCP governance server, repository workflows, 72 built-in skills, EU AI Act / NIST AI RMF compliance, multi-agent DAG dispatch, and context window management.**
 Specsmith ships a full compliance and auditability layer aligned to the EU AI Act (2024/1689)
 and the NIST AI Risk Management Framework 1.0. Every agent action is cryptographically sealed,
 every AI-generated output is disclosed, context windows are GPU-aware and protected against
@@ -922,6 +922,59 @@ oz agent run-cloud --skill "layer1labs/specsmith:specsmith-save" --prompt "save
 
 ---
 
+## Warp Terminal Integration (v0.12.0)
+
+specsmith ships native integration with [Warp](https://www.warp.dev) terminal — both as
+an MCP server and as repository workflows.
+
+### Native MCP Governance Server
+
+`specsmith mcp serve` starts a zero-dependency stdio MCP server (JSON-RPC 2.0, MCP 2024-11-05).
+Warp/Oz, Cursor, Claude Code, or any other MCP client can call governance commands as structured
+tool calls — no shell roundtrip, fully typed inputs and outputs.
+
+**Setup (one time):**
+
+```bash
+# Get the Warp config snippet
+specsmith mcp install-warp
+```
+
+Copy the output JSON into **Warp Settings → Agents → MCP servers**. Or pass it inline:
+
+```bash
+oz agent run --mcp '{"specsmith-governance": {"command": "specsmith", "args": ["mcp", "serve"]}}' \
+  --prompt "check governance health and preflight my next change"
+```
+
+**Six MCP tools exposed:**
+
+| Tool | What it returns |
+|---|---|
+| `governance_audit` | Full audit health JSON — passed/failed checks, fixable count |
+| `governance_checkpoint` | GOVERNANCE ANCHOR snapshot — phase, health, REQ/TEST counts, ESDB chain |
+| `governance_preflight` | Preflight decision — `accepted`/`needs_clarification` + `work_item_id` |
+| `governance_phase` | Current AEE phase, readiness %, failing checks |
+| `governance_req_list` | All requirements with status + test coverage, filterable |
+| `governance_trace_seal` | Create a cryptographic trace vault seal |
+
+### Repository Workflows (Ctrl+Shift+R)
+
+Clone this repo and open it in Warp — seven governance workflows appear automatically in
+`Ctrl+Shift+R` search:
+
+| Workflow | Command |
+|---|---|
+| specsmith — Session Start | Full bootstrap: kill → migrate → audit → sync → checkpoint |
+| specsmith — Audit | `specsmith audit` |
+| specsmith — Checkpoint | `specsmith checkpoint` (emits GOVERNANCE ANCHOR) |
+| specsmith — Preflight | `specsmith preflight "{{intent}}" --json` |
+| specsmith — Save | `specsmith save` |
+| specsmith — Phase Status | `specsmith phase show` |
+| specsmith — Session End | `specsmith save && specsmith kill-session` |
+
+---
+
 ## The specsmith Bootstrap
 
 specsmith governs itself — the specsmith repo is a specsmith-managed project. Run `specsmith audit`

{specsmith-0.11.8.dev487 → specsmith-0.12.0.dev492}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "specsmith"
-version = "0.11.8.dev487"
+version = "0.12.0.dev492"
 description = "Applied Epistemic Engineering toolkit — AEE agent sessions, execution profiles, FPGA/HDL governance, tool installer, 50+ CLI commands."
 readme = "README.md"
 license = "MIT"
@@ -129,6 +129,8 @@ select = ["E", "F", "W", "I", "UP", "B", "SIM"]
 "src/specsmith/context_orchestrator.py" = ["E501"]
 # Skills module: skill body strings contain markdown content with long lines
 "src/specsmith/skills/*.py" = ["E501"]
+# MCP server module: tool schema description strings are long but cannot be split
+"src/specsmith/mcp_server.py" = ["E501"]
 # Migration files: rule description strings and template content
 "src/specsmith/migrations/m001_governance_yaml.py" = ["E501"]
 "src/specsmith/migrations/m004_ledger_esdb.py" = ["E501"]
@@ -220,6 +222,8 @@ module = [
     "specsmith.ci_manager",
     "specsmith.context_orchestrator",
     "specsmith.session_store",
+    # MCP server: lazy in-function imports and dynamic Any patterns
+    "specsmith.mcp_server",
 ]
 ignore_errors = true
 

{specsmith-0.11.8.dev487 → specsmith-0.12.0.dev492}/src/specsmith/cli.py

@@ -9019,6 +9019,77 @@ def mcp_list_cmd(project_dir: str, as_json: bool) -> None:
             console.print(f"    [dim]{s['description']}[/dim]")
 
 
+@mcp_group.command(name="serve")
+@click.option("--project-dir", type=click.Path(), default=".", show_default=True)
+def mcp_serve_cmd(project_dir: 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:
+
+    \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
+
+    \b
+    Warp config (Settings → Agents → MCP servers)::
+
+        {"specsmith-governance": {"command": "specsmith", "args": ["mcp", "serve"]}}
+
+    \b
+    Or pass inline to oz (use ``specsmith mcp install-warp`` for the full snippet)::
+
+        oz agent run --mcp "$(specsmith mcp install-warp --json)" --prompt "..."
+    """
+    from specsmith.mcp_server import run_server
+
+    run_server(project_dir=project_dir)
+
+
+@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:
+    """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.
+    """
+    import json as _json
+    import os
+    import sys
+
+    config = {
+        "specsmith-governance": {
+            "command": (
+                sys.executable if os.environ.get("SPECSMITH_ALLOW_NON_PIPX") else "specsmith"
+            ),
+            "args": ["mcp", "serve", "--project-dir", str(Path(project_dir).resolve())],
+        }
+    }
+
+    if as_json:
+        click.echo(_json.dumps(config, indent=2))
+        return
+
+    console.print("[bold green]specsmith Governance MCP Server[/bold green]\n")
+    console.print(
+        "Add the following to [bold]Warp Settings → Agents → MCP servers[/bold],\n"
+        "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]"
+    )
+
+
 main.add_command(mcp_group)