crucible-mcp 1.0.0__py3-none-any.whl → 1.1.0__py3-none-any.whl

crucible/enforcement/compliance.py

@@ -6,6 +6,7 @@ Supports Sonnet (default) and Opus (for high-stakes assertions).
 
 import json
 import os
+import sys
 from typing import Any
 
 from crucible.enforcement.budget import (
@@ -79,8 +80,8 @@ def _load_api_key_from_config() -> str | None:
                     key = data.get("anthropic_api_key") or data.get("ANTHROPIC_API_KEY")
                     if key:
                         return key
-            except Exception:
-                pass  # Ignore malformed config files
+            except Exception as e:
+                print(f"Warning: failed to read {config_path}: {e}", file=sys.stderr)
 
     return None
 
@@ -294,27 +295,30 @@ def run_single_assertion(
         )
 
     except ImportError as e:
+        print(f"Warning: LLM assertion '{assertion.id}' skipped: {e}", file=sys.stderr)
         return LLMAssertionResult(
             assertion_id=assertion.id,
-            passed=True,  # Don't fail on missing dependency
+            passed=True,  # Graceful degradation - don't fail on missing dependency
             findings=(),
             tokens_used=0,
             model_used=model_name,
             error=str(e),
         )
     except ValueError as e:
+        print(f"Warning: LLM assertion '{assertion.id}' skipped: {e}", file=sys.stderr)
         return LLMAssertionResult(
             assertion_id=assertion.id,
-            passed=True,  # Don't fail on missing API key
+            passed=True,  # Graceful degradation - don't fail on missing API key
             findings=(),
             tokens_used=0,
             model_used=model_name,
             error=str(e),
         )
     except Exception as e:
+        print(f"Warning: LLM assertion '{assertion.id}' failed: {e}", file=sys.stderr)
         return LLMAssertionResult(
             assertion_id=assertion.id,
-            passed=True,  # Don't fail on API errors
+            passed=True,  # Graceful degradation - don't fail on API errors
             findings=(),
             tokens_used=0,
             model_used=model_name,

crucible/server.py

@@ -7,6 +7,7 @@ from mcp.server import Server
 from mcp.server.stdio import stdio_server
 from mcp.types import TextContent, Tool
 
+from crucible.enforcement.assertions import load_assertions
 from crucible.knowledge.loader import (
     get_custom_knowledge_files,
     load_all_knowledge,
@@ -314,6 +315,20 @@ async def list_tools() -> list[Tool]:
                 },
             },
         ),
+        Tool(
+            name="get_assertions",
+            description="Load active enforcement assertions for this project. Call at session start to understand what code patterns are enforced. Returns all pattern and LLM assertions that will be checked during reviews.",
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "include_compliance": {
+                        "type": "boolean",
+                        "description": "Include LLM compliance assertion details (default: true)",
+                        "default": True,
+                    },
+                },
+            },
+        ),
     ]
 
 
@@ -715,6 +730,61 @@ def _handle_load_knowledge(arguments: dict[str, Any]) -> list[TextContent]:
     return [TextContent(type="text", text="\n".join(output_parts))]
 
 
+def _handle_get_assertions(arguments: dict[str, Any]) -> list[TextContent]:
+    """Handle get_assertions tool - load active enforcement rules."""
+    include_compliance = arguments.get("include_compliance", True)
+
+    assertions, load_errors = load_assertions()
+
+    if not assertions and not load_errors:
+        return [TextContent(type="text", text="No assertions found. Add assertion files to .crucible/assertions/ or use bundled assertions.")]
+
+    parts: list[str] = ["# Active Enforcement Assertions\n"]
+    parts.append("These patterns are enforced during code review. Avoid these in your code.\n")
+
+    if load_errors:
+        parts.append("## Load Errors\n")
+        for error in load_errors:
+            parts.append(f"- {error}")
+        parts.append("")
+
+    # Group by source file / category
+    pattern_assertions = [a for a in assertions if a.type.value == "pattern"]
+    llm_assertions = [a for a in assertions if a.type.value == "llm"]
+
+    if pattern_assertions:
+        parts.append("## Pattern Assertions (fast, always run)\n")
+        parts.append("| ID | Message | Severity | Languages |")
+        parts.append("|---|---|---|---|")
+        for a in pattern_assertions:
+            langs = ", ".join(a.languages) if a.languages else "all"
+            parts.append(f"| `{a.id}` | {a.message} | {a.severity} | {langs} |")
+        parts.append("")
+
+    if llm_assertions and include_compliance:
+        parts.append("## LLM Compliance Assertions (semantic, budget-controlled)\n")
+        parts.append("| ID | Message | Severity | Model |")
+        parts.append("|---|---|---|---|")
+        for a in llm_assertions:
+            model = a.model or "sonnet"
+            parts.append(f"| `{a.id}` | {a.message} | {a.severity} | {model} |")
+        parts.append("")
+
+        # Show compliance requirements for LLM assertions
+        parts.append("### Compliance Requirements\n")
+        for a in llm_assertions:
+            parts.append(f"**{a.id}:**")
+            if a.compliance:
+                parts.append(f"```\n{a.compliance.strip()}\n```")
+            parts.append("")
+
+    # Summary
+    parts.append("---\n")
+    parts.append(f"**Total:** {len(pattern_assertions)} pattern + {len(llm_assertions)} LLM assertions")
+
+    return [TextContent(type="text", text="\n".join(parts))]
+
+
 def _handle_delegate_semgrep(arguments: dict[str, Any]) -> list[TextContent]:
     """Handle delegate_semgrep tool."""
     path = arguments.get("path", "")
@@ -1241,7 +1311,8 @@ async def call_tool(name: str, arguments: dict[str, Any]) -> list[TextContent]:
         "quick_review": _handle_quick_review,
         "full_review": _handle_full_review,
         "review_changes": _handle_review_changes,
-        # Other tools
+        # Context injection tools (call at session start)
+        "get_assertions": _handle_get_assertions,
         "get_principles": _handle_get_principles,
         "load_knowledge": _handle_load_knowledge,
         "delegate_semgrep": _handle_delegate_semgrep,

{crucible_mcp-1.0.0.dist-info → crucible_mcp-1.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crucible-mcp
-Version: 1.0.0
+Version: 1.1.0
 Summary: Code review MCP server for Claude. Not affiliated with Atlassian.
 Author: be.nvy
 License-Expression: MIT
@@ -109,13 +109,16 @@ Add to Claude Code (`.mcp.json`):
 
 | Tool | Purpose |
 |------|---------|
+| `get_assertions()` | **Session start:** Load enforced patterns into context |
+| `get_principles(topic)` | **Session start:** Load engineering knowledge by topic |
+| `load_knowledge(files)` | **Session start:** Load specific knowledge files |
 | `review(path)` | Full review: analysis + skills + knowledge + assertions |
 | `review(mode='staged')` | Review git changes with enforcement |
-| `load_knowledge(files)` | Load specific knowledge files |
-| `get_principles(topic)` | Load engineering knowledge by topic |
 | `delegate_*` | Direct tool access (semgrep, ruff, slither, bandit) |
 | `check_tools()` | Show installed analysis tools |
 
+**Tip:** Call `get_assertions()` at the start of a session so Claude knows what patterns to avoid *before* writing code.
+
 ## CLI
 
 ```bash

{crucible_mcp-1.0.0.dist-info → crucible_mcp-1.1.0.dist-info}/RECORD

@@ -2,13 +2,13 @@ crucible/__init__.py,sha256=M4v_CsJVOdiAAPgmd54mxkkbnes8e5ifMznDuOJhzzY,77
 crucible/cli.py,sha256=DTYt-V5W-DJSkQV3qXumsxImd2Ib3rn2ZgeL-m-dEvA,79233
 crucible/errors.py,sha256=HrX_yvJEhXJoKodXGo_iY9wqx2J3ONYy0a_LbrVC5As,819
 crucible/models.py,sha256=jaxbiPc1E7bJxKPLadZe1dbSJdq-WINsxjveeSNNqeg,2066
-crucible/server.py,sha256=oyfDl5-Ih3eoXBGDZ0ud7H3m2v0tn-Mc7mo19Bd-d00,46756
+crucible/server.py,sha256=TtvLWYSJsd8Szi0ZmjYQO4cPmqDlH_J6VxQ8xQY46Bo,49864
 crucible/domain/__init__.py,sha256=2fsoB5wH2Pl3vtGRt4voYOSZ04-zLoW8pNq6nvzVMgU,118
 crucible/domain/detection.py,sha256=TNeLB_VQgS1AsT5BKDf_tIpGa47THrFoRXwU4u54VB0,1797
 crucible/enforcement/__init__.py,sha256=FOaGSrE1SWFPxBJ1L5VoDhQDmlJgRXXs_iiI20wHf2Q,867
 crucible/enforcement/assertions.py,sha256=ay5QvJIr_YaqWYbrJNhbouafJOiy4ZhwiX7E9VAY3s4,8166
 crucible/enforcement/budget.py,sha256=-wFTlVY80c3-eJhvmlWrdlS8LB8E25aMnhtYpwR38sQ,4706
-crucible/enforcement/compliance.py,sha256=tkK-lSC5OMGOgt5xXY_APVSr-qHGB9kE8dUtoTF_n5w,14889
+crucible/enforcement/compliance.py,sha256=skod0sa381Jwrg-N1FmjJBw4o0BeiBiDEqQ1osKGDQk,15269
 crucible/enforcement/models.py,sha256=dEcPiUL6JEOBtxWOgKd_PZnsW_nUIaFsx18L70fM59M,4574
 crucible/enforcement/patterns.py,sha256=hE4Z-JJ9OBruSFPBDxw_aNaSJbyUPD2SWCEwA1KzDmI,9720
 crucible/enforcement/bundled/error-handling.yaml,sha256=2OSRhZwUGkF18bNfpARrVRsvgPgpyWr3pC0OUhtLgl0,2741
@@ -59,8 +59,8 @@ crucible/synthesis/__init__.py,sha256=CYrkZG4bdAjp8XdOh1smfKscd3YU5lZlaDLGwLE9c-
 crucible/tools/__init__.py,sha256=gFRThTk1E-fHzpe8bB5rtBG6Z6G-ysPzjVEHfKGbEYU,400
 crucible/tools/delegation.py,sha256=_x1y76No3qkmGjjROVvMx1pSKKwU59aRu5R-r07lVFU,12871
 crucible/tools/git.py,sha256=7-aJCesoQe3ZEBFcRxHBhY8RpZrBlNtHSns__RqiG04,10406
-crucible_mcp-1.0.0.dist-info/METADATA,sha256=LQZsUGpijH_MyRt2I-HgJf3ozOX7TbWpBPYkEg11WYQ,6231
-crucible_mcp-1.0.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-crucible_mcp-1.0.0.dist-info/entry_points.txt,sha256=18BZaH1OlFSFYtKuHq0Z8yYX8Wmx7Ikfqay-P00ZX3Q,83
-crucible_mcp-1.0.0.dist-info/top_level.txt,sha256=4hzuFgqbFPOO-WiU_DYxTm8VYIxTXh7Wlp0gRcWR0Cs,9
-crucible_mcp-1.0.0.dist-info/RECORD,,
+crucible_mcp-1.1.0.dist-info/METADATA,sha256=3mJv-xrzkQHnjHaBFQvQsX8DeoCAVyAEu-jl2GhJ6uA,6471
+crucible_mcp-1.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+crucible_mcp-1.1.0.dist-info/entry_points.txt,sha256=18BZaH1OlFSFYtKuHq0Z8yYX8Wmx7Ikfqay-P00ZX3Q,83
+crucible_mcp-1.1.0.dist-info/top_level.txt,sha256=4hzuFgqbFPOO-WiU_DYxTm8VYIxTXh7Wlp0gRcWR0Cs,9
+crucible_mcp-1.1.0.dist-info/RECORD,,