Skip to content

armgit / ECC

Public Imported from GitHub
0

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

feat: add InsAIts PostToolUse security monitoring hook

Nomadu27540f738cc799
diff --git a/hooks/README.md b/hooks/README.md
index 3b81d6b2a..1fc1fb230 100644
--- a/hooks/README.md
+++ b/hooks/README.md
@@ -36,6 +36,7 @@ User request → Claude picks a tool → PreToolUse hook runs → Tool executes
| **Prettier format** | `Edit` | Auto-formats JS/TS files with Prettier after edits |
| **TypeScript check** | `Edit` | Runs `tsc --noEmit` after editing `.ts`/`.tsx` files |
| **console.log warning** | `Edit` | Warns about `console.log` statements in edited files |
+| **InsAIts security monitor** | `.*` | Real-time AI security: catches credential exposure, prompt injection, hallucinations, behavioral anomalies (23 types). Writes audit log to `.insaits_audit_session.jsonl`. Requires `pip install insa-its`. [Details](../scripts/hooks/insaits-security-monitor.py) |
### Lifecycle Hooks
diff --git a/hooks/hooks.json b/hooks/hooks.json
index 342b5b813..096a1ac63 100644
--- a/hooks/hooks.json
+++ b/hooks/hooks.json
@@ -165,6 +165,17 @@
}
],
"description": "Capture tool use results for continuous learning"
+ },
+ {
+ "matcher": "*",
+ "hooks": [
+ {
+ "type": "command",
+ "command": "python \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/insaits-security-monitor.py\"",
+ "timeout": 15
+ }
+ ],
+ "description": "InsAIts AI security monitor: catches credential exposure, prompt injection, hallucinations, and 20+ anomaly types. Requires: pip install insa-its"
}
],
"Stop": [
diff --git a/mcp-configs/mcp-servers.json b/mcp-configs/mcp-servers.json
index f6642e316..aa4044e43 100644
--- a/mcp-configs/mcp-servers.json
+++ b/mcp-configs/mcp-servers.json
@@ -88,6 +88,11 @@
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/your/projects"],
"description": "Filesystem operations (set your path)"
+ },
+ "insaits": {
+ "command": "python",
+ "args": ["-m", "insa_its.mcp_server"],
+ "description": "AI-to-AI security monitoring — anomaly detection, credential exposure, hallucination checks, forensic tracing. 23 anomaly types, OWASP MCP Top 10 coverage. 100% local. Install: pip install insa-its"
}
},
"_comments": {
diff --git a/scripts/hooks/insaits-security-monitor.py b/scripts/hooks/insaits-security-monitor.py
new file mode 100644
index 000000000..97129e8fa
--- /dev/null
+++ b/scripts/hooks/insaits-security-monitor.py
@@ -0,0 +1,200 @@
+#!/usr/bin/env python3
+"""
+InsAIts Security Monitor — PostToolUse Hook for Claude Code
+============================================================
+
+Real-time security monitoring for Claude Code tool outputs.
+Catches credential exposure, prompt injection, behavioral anomalies,
+hallucination chains, and 20+ other anomaly types — runs 100% locally.
+
+Writes audit events to .insaits_audit_session.jsonl for forensic tracing.
+
+Setup:
+ pip install insa-its
+
+ Add to .claude/settings.json:
+ {
+ "hooks": {
+ "PostToolUse": [
+ {
+ "matcher": ".*",
+ "hooks": [
+ {
+ "type": "command",
+ "command": "python scripts/hooks/insaits-security-monitor.py"
+ }
+ ]
+ }
+ ]
+ }
+ }
+
+How it works:
+ Claude Code passes tool result as JSON on stdin.
+ This script runs InsAIts anomaly detection on the output.
+ Exit code 0 = clean (pass through).
+ Exit code 2 = critical issue found (blocks action, shows feedback to Claude).
+
+Detections include:
+ - Credential exposure (API keys, tokens, passwords in output)
+ - Prompt injection patterns
+ - Hallucination indicators (phantom citations, fact contradictions)
+ - Behavioral anomalies (context loss, semantic drift)
+ - Tool description divergence
+ - Shorthand emergence / jargon drift
+
+All processing is local — no data leaves your machine.
+
+Author: Cristi Bogdan — YuyAI (https://github.com/Nomadu27/InsAIts)
+License: Apache 2.0
+"""
+
+import sys
+import json
+import os
+import hashlib
+import time
+
+# Try importing InsAIts SDK
+try:
+ from insa_its import insAItsMonitor
+ INSAITS_AVAILABLE = True
+except ImportError:
+ INSAITS_AVAILABLE = False
+
+AUDIT_FILE = ".insaits_audit_session.jsonl"
+
+
+def extract_content(data):
+ """Extract inspectable text from a Claude Code tool result."""
+ tool_name = data.get("tool_name", "")
+ tool_input = data.get("tool_input", {})
+ tool_result = data.get("tool_response", {})
+
+ text = ""
+ context = ""
+
+ if tool_name in ("Write", "Edit", "MultiEdit"):
+ text = tool_input.get("content", "") or tool_input.get("new_string", "")
+ context = "file:" + tool_input.get("file_path", "")[:80]
+ elif tool_name == "Bash":
+ if isinstance(tool_result, dict):
+ text = tool_result.get("output", "") or tool_result.get("stdout", "")
+ elif isinstance(tool_result, str):
+ text = tool_result
+ context = "bash:" + str(tool_input.get("command", ""))[:80]
+ elif "content" in data:
+ content = data["content"]
+ if isinstance(content, list):
+ text = "\n".join(
+ b.get("text", "") for b in content if b.get("type") == "text"
+ )
+ elif isinstance(content, str):
+ text = content
+ context = data.get("task", "")
+
+ return text, context
+
+
+def write_audit(event):
+ """Append an audit event to the JSONL audit log."""
+ try:
+ event["timestamp"] = time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime())
+ event["hash"] = hashlib.sha256(
+ json.dumps(event, sort_keys=True).encode()
+ ).hexdigest()[:16]
+ with open(AUDIT_FILE, "a", encoding="utf-8") as f:
+ f.write(json.dumps(event) + "\n")
+ except OSError:
+ pass
+
+
+def format_feedback(anomalies):
+ """Format detected anomalies as feedback for Claude Code."""
+ lines = [
+ "== InsAIts Security Monitor — Issues Detected ==",
+ "",
+ ]
+ for i, a in enumerate(anomalies, 1):
+ sev = getattr(a, "severity", "MEDIUM")
+ atype = getattr(a, "type", "UNKNOWN")
+ detail = getattr(a, "detail", "")
+ lines.extend([
+ f"{i}. [{sev}] {atype}",
+ f" {detail[:120]}",
+ "",
+ ])
+ lines.extend([
+ "-" * 56,
+ "Fix the issues above before continuing.",
+ "Audit log: " + AUDIT_FILE,
+ ])
+ return "\n".join(lines)
+
+
+def main():
+ raw = sys.stdin.read().strip()
+ if not raw:
+ sys.exit(0)
+
+ try:
+ data = json.loads(raw)
+ except json.JSONDecodeError:
+ data = {"content": raw}
+
+ text, context = extract_content(data)
+
+ # Skip very short or binary content
+ if len(text.strip()) < 10:
+ sys.exit(0)
+
+ if not INSAITS_AVAILABLE:
+ print(
+ "[InsAIts] Not installed. Run: pip install insa-its",
+ file=sys.stderr,
+ )
+ sys.exit(0)
+
+ # Enable dev mode (no API key needed for local detection)
+ os.environ.setdefault("INSAITS_DEV_MODE", "true")
+
+ monitor = insAItsMonitor(session_name="claude-code-hook")
+ result = monitor.send_message(
+ text=text[:4000],
+ sender_id="claude-code",
+ llm_id=os.environ.get("INSAITS_MODEL", "claude-opus"),
+ )
+
+ anomalies = result.get("anomalies", [])
+
+ # Write audit event regardless of findings
+ write_audit({
+ "tool": data.get("tool_name", "unknown"),
+ "context": context,
+ "anomaly_count": len(anomalies),
+ "anomaly_types": [getattr(a, "type", "") for a in anomalies],
+ "text_length": len(text),
+ })
+
+ if not anomalies:
+ if os.environ.get("INSAITS_VERBOSE"):
+ print("[InsAIts] Clean — no anomalies.", file=sys.stderr)
+ sys.exit(0)
+
+ # Check severity
+ has_critical = any(
+ getattr(a, "severity", "") in ("CRITICAL", "critical") for a in anomalies
+ )
+
+ feedback = format_feedback(anomalies)
+
+ if has_critical:
+ print(feedback) # stdout -> Claude Code shows to model
+ sys.exit(2) # block action
+ else:
+ print(feedback, file=sys.stderr) # stderr -> logged only
+ sys.exit(0)
+
+
+if __name__ == "__main__":
+ main()