mcp-nervous-system 1.2.0 → 1.4.0

package/README.md

@@ -4,7 +4,7 @@
 
 7 mechanically enforced rules that prevent the most common failure modes when LLMs have access to real infrastructure: context loss, silent failures, file damage, goal drift, and overreach.
 
-Built by [Arthur Palyan](https://www.levelsofself.com) at Palyan AI. 11 tools. Battle-tested on a 12-member AI family running 22 processes 24/7 on a single VPS. 55+ violations logged, 0 bypassed.
+Built by [Arthur Palyan](https://www.levelsofself.com) at Palyan Family AI System. 12 tools including configuration drift detection and emergency kill switch. Battle-tested on an 11-member AI family running 28 processes 24/7 on a single VPS. 58+ violations logged, 0 bypassed.
 
 ## The Problem
 
@@ -60,6 +60,13 @@ Protocol: MCP 2024-11-05 (Streamable HTTP + SSE)
 Authentication: None required
 ```
 
+## NEW in v1.4.0
+
+**drift_audit** (free tier)
+Configuration drift detection across 5 scopes: roles, versions, files, processes, and website. Scans source-of-truth files (family-roles.json, package.json, UNTOUCHABLE_FILES.txt) against all downstream references - HTML pages, JSON configs, markdown docs, and running PM2 processes. Change one file, drift_audit tells you everywhere else that needs updating. The closed loop that keeps your entire system consistent.
+
+**Positioning: Auto mode decides what Claude CAN do. The Nervous System governs HOW it behaves while doing it.**
+
 ## The 7 Rules
 
 | # | Rule | What It Prevents |
@@ -72,7 +79,7 @@ Authentication: None required
 | 6 | **Ask Before Touching** | Unauthorized changes. Logic changes need human approval. |
 | 7 | **Hand Off** | Context loss. Written handoffs every 3-4 exchanges. |
 
-## MCP Tools (11)
+## MCP Tools (12)
 
 | Tool | Description |
 |------|------------|
@@ -87,6 +94,7 @@ Authentication: None required
 | `emergency_kill_switch` | Emergency shutdown of all PM2 processes. Requires kill switch secret. Logs to tamper-evident audit trail |
 | `verify_audit_chain` | Walks the SHA-256 hash-chained audit log and verifies every entry. Returns chain integrity status |
 | `dispatch_to_llm` | Spawns a background LLM agent to handle a task. Checks RAM, enforces max 2 concurrent dispatches |
+| `drift_audit` | Configuration drift detection across roles, versions, files, processes, and website. Finds stale values everywhere. |
 
 ## Kill Switch
 
@@ -102,7 +110,7 @@ Every guardrail violation, kill switch activation, and dispatch event is recorde
 
 - Use `verify_audit_chain` to walk the entire chain and verify integrity
 - Returns: valid/invalid status, entry count, and break point if tampered
-- 55+ violations logged, 0 bypassed, 0 chain breaks
+- 58+ violations logged, 0 bypassed, 0 chain breaks
 
 ## Dispatch to LLM
 
@@ -119,22 +127,23 @@ The Nervous System provides practical compliance tools for the EU AI Act. See th
 
 https://api.100levelup.com/family/eu-ai-act.html
 
-## Resources (4)
+## Resources (5)
 
 - `nervous-system://framework` - The complete framework
 - `nervous-system://quick-start` - Quick start guide
 - `nervous-system://rules` - The 7 core rules
 - `nervous-system://templates` - Templates for handoffs, worklogs, preflight
+- `nervous-system://drift-audit` - Configuration drift detection
 
 ## Production Stats
 
-From the live Palyan AI deployment (Feb 28 - Mar 5, 2026):
+From the live Palyan Family AI System deployment (Feb 28 - Mar 5, 2026):
 
-- **55+** violations caught
+- **58+** violations caught
 - **29** edits blocked by preflight
 - **13** unique files protected
 - **0** rules bypassed
-- **22** processes monitored
+- **28** processes monitored
 - **7** days continuous operation
 
 ## Live Demo