crucible-mcp 1.0.0__tar.gz → 1.1.0__tar.gz

{crucible_mcp-1.0.0 → crucible_mcp-1.1.0}/PKG-INFO

@@ -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 → crucible_mcp-1.1.0}/README.md

@@ -91,13 +91,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 → crucible_mcp-1.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "crucible-mcp"
-version = "1.0.0"
+version = "1.1.0"
 description = "Code review MCP server for Claude. Not affiliated with Atlassian."
 readme = "README.md"
 requires-python = ">=3.11"

{crucible_mcp-1.0.0 → crucible_mcp-1.1.0}/src/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_mcp-1.0.0 → crucible_mcp-1.1.0}/src/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 → crucible_mcp-1.1.0}/src/crucible_mcp.egg-info/PKG-INFO

@@ -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