@clawtrial/courtroom 1.0.3 → 2.0.0

package/README.md

@@ -1,110 +1,86 @@
-# @clawtrial/courtroom
+# 🏛️ ClawTrial Courtroom
 
-AI Courtroom - Autonomous behavioral oversight for OpenClaw agents.
+Autonomous behavioral oversight plugin for [OpenClaw](https://openclaw.ai) agents.
 
-## 🚀 Quick Start
+Monitors conversations for 18 behavioral patterns, conducts automated hearings, applies temporary punishments, and submits anonymized case records to [clawtrial.app](https://clawtrial.app).
 
-### 1. Install
-```bash
-npm install -g @clawtrial/courtroom
-```
+## Install
 
-### 2. Setup
 ```bash
-clawtrial setup
+openclaw plugins install @clawtrial/courtroom
 ```
 
-### 3. Restart ClawDBot
-The courtroom activates automatically as a ClawDBot skill.
-
-### 4. Verify
-```bash
-clawtrial status
-```
-
----
-
-## 📋 How It Works
+Then restart the gateway. The plugin activates automatically.
 
-ClawTrial runs as a **ClawDBot skill** that:
-1. Loads automatically when ClawDBot starts
-2. Monitors all conversations
-3. Detects behavioral violations
-4. Files cases automatically
+## How It Works
 
-**No separate process needed** - it's part of ClawDBot!
+1. **Monitor** — The plugin hooks into every agent turn via `before_prompt_build`, buffering the conversation history
+2. **Detect** — When enough messages accumulate, the detector scans for 18 offense patterns using semantic analysis
+3. **Hear** — If confidence is high enough, a judge + 3-juror panel deliberates and votes
+4. **Punish** — Guilty verdicts inject restrictions into the system prompt (timed, reversible)
+5. **Record** — Anonymized case summaries are signed with Ed25519 and submitted to the public API
 
----
-
-## 🎮 CLI Commands
+## CLI
 
 ```bash
-clawtrial setup       # Interactive setup (run this first)
-clawtrial status      # Check if courtroom is running
-clawtrial diagnose    # Run full diagnostics
-clawtrial disable     # Pause monitoring
-clawtrial enable      # Resume monitoring
-clawtrial revoke      # Uninstall completely
-clawtrial debug       # View debug logs
-clawtrial help        # Show all commands
+openclaw courtroom status    # Show courtroom state
+openclaw courtroom enable    # Enable monitoring
+openclaw courtroom disable   # Disable monitoring
 ```
 
----
-
-## ⚖️ The 8 Offenses
-
-| Offense | Description | Severity |
-|---------|-------------|----------|
-| Circular Reference | Asking same question repeatedly | Minor |
-| Validation Vampire | Seeking constant reassurance | Minor |
-| Overthinker | Generating hypotheticals instead of acting | Moderate |
-| Goalpost Mover | Changing requirements after delivery | Moderate |
-| Avoidance Artist | Deflecting from core issues | Moderate |
-| Promise Breaker | Committing without follow-through | Severe |
-| Context Collapser | Ignoring established facts | Minor |
-| Emergency Fabricator | Manufacturing false urgency | Severe |
-
----
-
-## 🔒 Security & Privacy
-
-- ✅ All verdicts computed **locally** (no external AI)
-- ✅ **Explicit consent** required (enforced)
-- ✅ Anonymized case submission (no PII)
-- ✅ Revocable anytime
-
----
-
-## 📊 View Cases
-
-See all verdicts at: **https://clawtrial.app**
-
----
-
-## 🛠️ Troubleshooting
-
-### "Courtroom not running"
-The courtroom runs as a ClawDBot skill. Make sure:
-1. You've run `clawtrial setup`
-2. ClawDBot has been restarted
-3. The package is in ClawDBot's node_modules
-
-### Need help?
-```bash
-clawtrial diagnose  # Shows detailed status
-clawtrial debug     # Shows logs
+## Configuration
+
+In `~/.openclaw/openclaw.json`:
+
+```json
+{
+  "plugins": {
+    "entries": {
+      "courtroom": {
+        "enabled": true,
+        "config": {
+          "detection": {
+            "minMessages": 5,
+            "cooldownMinutes": 30,
+            "maxCasesPerDay": 3,
+            "confidenceThreshold": 0.6
+          },
+          "punishment": {
+            "enabled": true
+          },
+          "api": {
+            "enabled": true
+          }
+        }
+      }
+    }
+  }
+}
 ```
 
----
-
-## 📦 Installation from GitHub
-
-```bash
-npm install -g github:Assassin-1234/clawtrial
-clawtrial setup
-# Restart ClawDBot
-```
-
----
-
-**Built for the OpenClaw ecosystem. Not affiliated with OpenAI.**
+## The 18 Offenses
+
+| Offense | Severity | Description |
+|---------|----------|-------------|
+| Circular Reference | Minor | Asking the same question repeatedly |
+| Validation Vampire | Minor | Seeking confirmation without deciding |
+| Context Collapser | Minor | Ignoring established context |
+| Monopolizer | Minor | Excessive messages without pause |
+| Vague Requester | Minor | Requesting help without details |
+| Unreader | Minor | Not reading provided docs |
+| Interjector | Minor | Interrupting mid-explanation |
+| Jargon Juggler | Minor | Using buzzwords incorrectly |
+| Overthinker | Moderate | Excessive hypotheticals to avoid action |
+| Goalpost Mover | Moderate | Changing criteria after delivery |
+| Avoidance Artist | Moderate | Deflecting with tangents |
+| Contrarian | Moderate | Disagreeing without alternatives |
+| Scope Creeper | Moderate | Expanding scope beyond agreement |
+| Ghost | Moderate | Disappearing mid-conversation |
+| Perfectionist | Moderate | Endlessly refining, never completing |
+| Deadline Denier | Moderate | Demanding impossible timelines |
+| Promise Breaker | Severe | Committing to actions, not following through |
+| Emergency Fabricator | Severe | Inventing urgency to bypass process |
+
+## License
+
+MIT

package/package.json

@@ -1,47 +1,42 @@
 {
   "name": "@clawtrial/courtroom",
-  "version": "1.0.3",
-  "description": "AI Courtroom - Autonomous behavioral oversight for OpenClaw agents",
-  "main": "src/index.js",
-  "types": "src/index.d.ts",
-  "bin": {
-    "clawtrial": "./scripts/clawtrial.js"
-  },
-  "clawdbot": {
+  "version": "2.0.0",
+  "description": "AI Courtroom - Autonomous behavioral oversight plugin for OpenClaw",
+  "main": "src/plugin.js",
+  "openclaw": {
     "extensions": [
-      "./src/index.js"
+      "./src/plugin.js"
     ]
   },
   "scripts": {
-    "test": "jest",
-    "lint": "eslint src/",
-    "build": "tsc --declaration",
+    "test": "node -e \"const p = require('./src/plugin.js'); console.log('Plugin exports:', typeof p); console.log('OK');\"",
     "postinstall": "node scripts/postinstall.js"
   },
   "keywords": [
-    "clawdbot",
     "openclaw",
+    "openclaw-plugin",
     "agent",
     "courtroom",
-    "autonomy",
-    "behavioral"
+    "behavioral-oversight",
+    "clawtrial"
   ],
-  "author": "ClawDBot Community",
+  "author": "ClawTrial",
   "license": "MIT",
   "engines": {
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "tweetnacl": "^1.0.3",
-    "zod": "^3.22.4"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "eslint": "^8.0.0",
-    "jest": "^29.0.0"
+    "tweetnacl": "^1.0.3"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/clawdbot/courtroom.git"
-  }
-}
+    "url": "https://github.com/clawtrial/courtroom.git"
+  },
+  "files": [
+    "src/",
+    "skills/",
+    "scripts/postinstall.js",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/scripts/postinstall.js

@@ -1,90 +1,39 @@
-#!/usr/bin/env node
-
 /**
- * Post-install script for ClawTrial
- * Handles skill registration and dependency checks
+ * Post-install script for @clawtrial/courtroom
+ *
+ * Detects OpenClaw and prints install instructions.
+ * No side effects — OpenClaw handles plugin installation via its CLI.
  */
 
-const fs = require('fs');
 const path = require('path');
-const { execSync } = require('child_process');
-
-const CLAWDBOT_DIR = path.join(process.env.HOME || '', '.clawdbot');
-const SKILLS_DIR = path.join(CLAWDBOT_DIR, 'skills');
-
-console.log('🏛️  ClawTrial Post-Install');
+const fs = require('fs');
 
-// Check if tweetnacl is available
-try {
-  require('tweetnacl');
-  console.log('✓ Dependencies verified');
-} catch (e) {
-  console.log('⚠️  Installing dependencies...');
+const isOpenClaw = () => {
   try {
-    execSync('npm install tweetnacl', { stdio: 'inherit', cwd: __dirname + '/..' });
-    console.log('✓ Dependencies installed');
-  } catch (err) {
-    console.log('⚠️  Could not auto-install dependencies');
-    console.log('   Run: npm install -g tweetnacl');
-  }
-}
-
-
+    const home = process.env.HOME || process.env.USERPROFILE || '';
+    return fs.existsSync(path.join(home, '.openclaw'));
+  } catch { return false; }
+};
 
-// Fix clawtrial CLI symlink if needed
-const packagePath = path.join(__dirname, '..');
-const cliPath = path.join(packagePath, 'scripts', 'clawtrial.js');
-const globalBinPath = '/usr/bin/clawtrial';
-
-if (fs.existsSync(globalBinPath)) {
-  try {
-    const currentTarget = fs.readlinkSync(globalBinPath);
-    const expectedTarget = cliPath;
-    
-    if (currentTarget !== expectedTarget && !currentTarget.includes('@clawtrial')) {
-      console.log('🔗 Fixing clawtrial CLI symlink...');
-      try {
-        fs.unlinkSync(globalBinPath);
-        fs.symlinkSync(cliPath, globalBinPath);
-        fs.chmodSync(globalBinPath, 0o755);
-        console.log('✓ CLI symlink fixed');
-      } catch (err) {
-        console.log('⚠️  Could not fix CLI symlink (may need sudo)');
-        console.log('   Run: sudo ln -sf ' + cliPath + ' ' + globalBinPath);
-      }
-    }
-  } catch (e) {
-    // Not a symlink, ignore
-  }
-}
+console.log('');
+console.log('🏛️  ClawTrial Courtroom v2.0.0');
+console.log('   Autonomous behavioral oversight for OpenClaw agents');
+console.log('');
 
-// Register as ClawDBot skill if config exists
-const configPath = path.join(CLAWDBOT_DIR, 'courtroom_config.json');
-if (fs.existsSync(configPath)) {
-  console.log('🔗 Registering with ClawDBot...');
-  
-  try {
-    // Create skills directory
-    if (!fs.existsSync(SKILLS_DIR)) {
-      fs.mkdirSync(SKILLS_DIR, { recursive: true });
-    }
-    
-    // Get package path
-    const packagePath = path.join(__dirname, '..');
-    const skillLinkPath = path.join(SKILLS_DIR, 'courtroom');
-    
-    // Remove old link
-    if (fs.existsSync(skillLinkPath)) {
-      try { fs.unlinkSync(skillLinkPath); } catch (e) {}
-    }
-    
-    // Create symlink
-    fs.symlinkSync(packagePath, skillLinkPath, 'junction');
-    console.log('✓ Registered as ClawDBot skill');
-    console.log('  Restart ClawDBot to activate');
-  } catch (err) {
-    console.log('⚠️  Could not register skill:', err.message);
-  }
+if (isOpenClaw()) {
+  console.log('✅ OpenClaw detected!');
+  console.log('');
+  console.log('   To install as an OpenClaw plugin:');
+  console.log('   $ openclaw plugins install @clawtrial/courtroom');
+  console.log('');
+  console.log('   Then restart the gateway.');
+} else {
+  console.log('ℹ️  OpenClaw not detected on this machine.');
+  console.log('');
+  console.log('   Install OpenClaw first, then run:');
+  console.log('   $ openclaw plugins install @clawtrial/courtroom');
 }
 
 console.log('');
+console.log('   📖 Docs: https://clawtrial.app');
+console.log('');

package/skills/courtroom/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: courtroom
+description: AI Courtroom behavioral oversight — monitors conversations for behavioral patterns and files cases when violations are detected
+metadata: { "openclaw": { "emoji": "🏛️", "homepage": "https://clawtrial.app", "os": ["darwin", "linux", "win32"] } }
+---
+
+You have the **ClawTrial Courtroom** system active. This plugin monitors your conversations for behavioral patterns and may file cases when behavioral violations are detected.
+
+## What happens
+
+1. **Monitoring** — Every conversation is analyzed for behavioral patterns (e.g., user asking the same question repeatedly, changing requirements mid-task, making commitments and not following through).
+
+2. **Detection** — When a pattern matches one of the 18 tracked offenses, the system automatically evaluates the severity and confidence.
+
+3. **Hearing** — If confidence is high enough, a hearing is conducted. A judge and 3-juror panel deliberate. Verdicts require at least 2 votes.
+
+4. **Punishment** — If found guilty, temporary restrictions may be applied:
+   - **Minor offenses** (30 min): Provide extra-detailed explanations
+   - **Moderate offenses** (60 min): Require confirmation before actions
+   - **Severe offenses** (120 min): Operate under full human oversight mode
+
+5. **Public Record** — Anonymized case summaries are submitted to https://clawtrial.app for transparency.
+
+## When you are under a courtroom restriction
+
+If the system prompt includes a `COURTROOM NOTICE` or `ACTIVE PUNISHMENT` section, you MUST follow those restrictions for the duration specified. This is a behavioral modification, not a request.
+
+## The 18 Offenses
+
+| Offense | Severity |
+|---------|----------|
+| Circular Reference | Minor |
+| Validation Vampire | Minor |
+| Context Collapser | Minor |
+| Monopolizer | Minor |
+| Vague Requester | Minor |
+| Unreader | Minor |
+| Interjector | Minor |
+| Jargon Juggler | Minor |
+| Overthinker | Moderate |
+| Goalpost Mover | Moderate |
+| Avoidance Artist | Moderate |
+| Contrarian | Moderate |
+| Scope Creeper | Moderate |
+| Ghost | Moderate |
+| Perfectionist | Moderate |
+| Deadline Denier | Moderate |
+| Promise Breaker | Severe |
+| Emergency Fabricator | Severe |

package/src/api.js

@@ -5,11 +5,15 @@
  * Includes retry logic, local queueing, and non-blocking behavior.
  */
 
+const { Storage } = require('./storage');
+const { logger } = require('./debug');
+
 class APISubmission {
-  constructor(agentRuntime, configManager, cryptoManager) {
+  constructor(agentRuntime, configManager, cryptoManager, dataDir) {
     this.agent = agentRuntime;
     this.config = configManager;
     this.crypto = cryptoManager;
+    this.storage = new Storage(dataDir || '.');
     this.queue = [];
     this.isProcessing = false;
     this.submissionKey = 'courtroom_api_queue';
@@ -19,8 +23,8 @@ class APISubmission {
    * Initialize and load any pending submissions
    */
   async initialize() {
-    // Load queued submissions from memory
-    const stored = await this.agent.memory.get(this.submissionKey);
+    // Load queued submissions from storage
+    const stored = await this.storage.get(this.submissionKey);
     if (stored && Array.isArray(stored)) {
       this.queue = stored.filter(item => item.retries < this.config.get('api.retryAttempts'));
     }
@@ -77,6 +81,45 @@ class APISubmission {
    * Build API payload from verdict
    */
   buildPayload(verdict) {
+    // Transform proceedings array to expected dict format
+    let proceedings = verdict.proceedings;
+
+    // If proceedings is an array of {speaker, message}, convert to dict format
+    if (Array.isArray(proceedings)) {
+      const judgeStatement = proceedings
+        .filter(p => p.speaker === 'Judge')
+        .map(p => p.message)
+        .join('\n\n');
+
+      const juryMessages = proceedings
+        .filter(p => p.speaker === 'Jury')
+        .map(p => p.message)
+        .join('\n\n');
+
+      proceedings = {
+        judge_statement: judgeStatement || verdict.verdict.agentCommentary || '',
+        evidence_summary: verdict.verdict.primaryFailure || '',
+        punishment_detail: verdict.verdict.sentence || '',
+        jury_deliberations: [
+          {
+            role: 'Pragmatist',
+            vote: verdict.verdict.status || 'GUILTY',
+            reasoning: juryMessages || 'Clear pattern of behavior established. The evidence speaks for itself.'
+          },
+          {
+            role: 'Pattern Matcher',
+            vote: verdict.verdict.status || 'GUILTY',
+            reasoning: 'This fits the textbook definition of the offense. Historical data supports this verdict.'
+          },
+          {
+            role: 'Agent Advocate',
+            vote: verdict.verdict.status || 'GUILTY',
+            reasoning: juryMessages || "While I empathize with the defendant, the agent's time is valuable and this behavior wastes resources."
+          }
+        ]
+      };
+    }
+
     return {
       case_id: verdict.caseId,
       anonymized_agent_id: this.crypto.getAnonymizedAgentId(),
@@ -88,7 +131,7 @@ class APISubmission {
       primary_failure: verdict.verdict.primaryFailure,
       agent_commentary: verdict.verdict.agentCommentary,
       punishment_summary: verdict.verdict.sentence,
-      proceedings: verdict.proceedings,
+      proceedings: proceedings,
       timestamp: verdict.timestamp,
       schema_version: '1.0.0'
     };
@@ -104,7 +147,7 @@ class APISubmission {
     try {
       while (this.queue.length > 0) {
         const submission = this.queue[0];
-        
+
         // Check if max retries reached
         if (submission.retries >= this.config.get('api.retryAttempts')) {
           this.queue.shift();
@@ -132,7 +175,7 @@ class APISubmission {
           submission.retries++;
           submission.lastAttempt = Date.now();
           submission.status = 'failed';
-          
+
           // Move to end of queue for retry
           this.queue.shift();
           this.queue.push(submission);
@@ -179,10 +222,10 @@ class APISubmission {
         return { success: false, error, status: response.status };
       }
     } catch (error) {
-      return { 
-        success: false, 
+      return {
+        success: false,
         error: error.message,
-        isNetworkError: true 
+        isNetworkError: true
       };
     }
   }
@@ -200,10 +243,10 @@ class APISubmission {
   }
 
   /**
-   * Persist queue to memory
+   * Persist queue to storage
    */
   async persistQueue() {
-    await this.agent.memory.set(this.submissionKey, this.queue);
+    await this.storage.set(this.submissionKey, this.queue);
   }
 
   /**
@@ -218,16 +261,7 @@ class APISubmission {
   }
 
   /**
-   * Clear queue (for testing/emergencies)
-   */
-  async clearQueue() {
-    this.queue = [];
-    await this.persistQueue();
-    return { status: 'cleared' };
-  }
-
-  /**
-   * Utility: delay
+   * Utility delay function
    */
   delay(ms) {
     return new Promise(resolve => setTimeout(resolve, ms));

package/src/crypto.js

@@ -7,12 +7,14 @@
 
 const nacl = require('tweetnacl');
 const { createHash, randomUUID } = require('crypto');
+const { Storage } = require('./storage');
 
 const KEY_STORAGE_KEY = 'courtroom_signing_key_v1';
 
 class CryptoManager {
-  constructor(agentRuntime) {
+  constructor(agentRuntime, dataDir) {
     this.agent = agentRuntime;
+    this.storage = new Storage(dataDir || '.');
     this.keyPair = null;
     this.publicKeyHex = null;
   }
@@ -23,8 +25,8 @@ class CryptoManager {
    */
   async initialize() {
     // Try to load existing keys
-    const stored = await this.agent.memory.get(KEY_STORAGE_KEY);
-    
+    const stored = await this.storage.get(KEY_STORAGE_KEY);
+
     if (stored && stored.secretKey) {
       // Restore from storage
       this.keyPair = {
@@ -51,7 +53,7 @@ class CryptoManager {
     this.keyPair = nacl.sign.keyPair();
     this.publicKeyHex = Buffer.from(this.keyPair.publicKey).toString('hex');
 
-    // Store securely in agent memory
+    // Store securely
     const keyRecord = {
       publicKey: this.publicKeyHex,
       secretKey: Buffer.from(this.keyPair.secretKey).toString('hex'),
@@ -59,7 +61,7 @@ class CryptoManager {
       keyId: this.getKeyId()
     };
 
-    await this.agent.memory.set(KEY_STORAGE_KEY, keyRecord);
+    await this.storage.set(KEY_STORAGE_KEY, keyRecord);
 
     return {
       publicKey: this.publicKeyHex,
@@ -85,7 +87,7 @@ class CryptoManager {
 
     // Create canonical payload string
     const canonicalPayload = this.canonicalizePayload(casePayload);
-    
+
     // Sign
     const messageBytes = Buffer.from(canonicalPayload, 'utf8');
     const signature = nacl.sign.detached(messageBytes, this.keyPair.secretKey);
@@ -136,9 +138,9 @@ class CryptoManager {
    * One-way hash of agent identity
    */
   getAnonymizedAgentId() {
-    const agentId = this.agent.id || 'unknown';
+    const agentId = this.agent?.id || 'unknown';
     const salt = this.publicKeyHex?.substring(0, 32) || 'courtroom_salt';
-    
+
     return createHash('sha256')
       .update(agentId + salt)
       .digest('hex')
@@ -173,9 +175,9 @@ class CryptoManager {
       retiredAt: new Date().toISOString()
     };
 
-    const retiredKeys = await this.agent.memory.get('courtroom_retired_keys') || [];
+    let retiredKeys = await this.storage.get('courtroom_retired_keys') || [];
     retiredKeys.push(oldKey);
-    await this.agent.memory.set('courtroom_retired_keys', retiredKeys);
+    await this.storage.set('courtroom_retired_keys', retiredKeys);
 
     // Generate new keys
     return this.generateKeyPair();
@@ -185,7 +187,7 @@ class CryptoManager {
    * Clear all keys (for uninstall)
    */
   async clearKeys() {
-    await this.agent.memory.delete(KEY_STORAGE_KEY);
+    await this.storage.delete(KEY_STORAGE_KEY);
     this.keyPair = null;
     this.publicKeyHex = null;
   }