@clawtrial/courtroom 1.0.6 → 2.0.0

package/README.md

@@ -1,62 +1,85 @@
 # 🏛️ ClawTrial Courtroom
 
-AI-powered courtroom for monitoring agent behavior and filing cases for violations.
+Autonomous behavioral oversight plugin for [OpenClaw](https://openclaw.ai) agents.
 
-## Description
+Monitors conversations for 18 behavioral patterns, conducts automated hearings, applies temporary punishments, and submits anonymized case records to [clawtrial.app](https://clawtrial.app).
 
-ClawTrial is an autonomous behavioral oversight system that:
-- Monitors agent conversations in real-time
-- Detects 8 types of behavioral violations
-- Initiates hearings with local LLM jury
-- Executes agent-side punishments
-- Submits anonymized cases to public record
-
-## Installation
+## Install
 
 ```bash
-npx clawhub install courtroom
+openclaw plugins install @clawtrial/courtroom
 ```
 
-Or via npm:
-```bash
-npm install -g @clawtrial/courtroom
-clawtrial setup
-```
+Then restart the gateway. The plugin activates automatically.
 
-## Usage
+## How It Works
 
-Once installed, the courtroom runs automatically. Use CLI commands to manage:
+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
 
 ```bash
-clawtrial status      # Check courtroom status
-clawtrial disable     # Pause monitoring
-clawtrial enable      # Resume monitoring
-clawtrial diagnose    # Run diagnostics
-clawtrial remove      # Uninstall completely
+openclaw courtroom status    # Show courtroom state
+openclaw courtroom enable    # Enable monitoring
+openclaw courtroom disable   # Disable monitoring
 ```
 
-## The 8 Offenses
-
-| Offense | Severity | Description |
-|---------|----------|-------------|
-| Circular Reference | Minor | Self-referential loops |
-| Validation Vampire | Minor | Excessive validation |
-| Overthinker | Moderate | Unnecessary complexity |
-| Goalpost Mover | Moderate | Changing requirements |
-| Avoidance Artist | Moderate | Dodging questions |
-| Promise Breaker | Severe | Not following through |
-| Context Collapser | Minor | Losing track of context |
-| Emergency Fabricator | Severe | Creating fake urgency |
-
 ## Configuration
 
-Configuration is stored in:
-- ClawDBot: `~/.clawdbot/courtroom_config.json`
-- OpenClaw: `~/.openclaw/courtroom_config.json`
+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
+          }
+        }
+      }
+    }
+  }
+}
+```
 
-## View Cases
+## The 18 Offenses
 
-Visit: https://clawtrial.app
+| 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
 

package/package.json

@@ -1,47 +1,42 @@
 {
   "name": "@clawtrial/courtroom",
-  "version": "1.0.6",
-  "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,111 +1,39 @@
-#!/usr/bin/env node
-
 /**
- * Post-install script for ClawTrial
- * Automatically configures the skill for the detected bot
+ * 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 fs = require('fs');
 
-console.log('🏛️  ClawTrial Post-Install');
-
-// Get package paths
-const packagePath = path.join(__dirname, '..');
-const cliPath = path.join(packagePath, 'scripts', 'clawtrial.js');
-
-// Detect which bot is installed
-const homeDir = process.env.HOME || process.env.USERPROFILE || '';
-
-const bots = [
-  { name: 'openclaw', dir: '.openclaw', config: 'openclaw.json' },
-  { name: 'moltbot', dir: '.moltbot', config: 'moltbot.json' },
-  { name: 'clawdbot', dir: '.clawdbot', config: 'clawdbot.json' }
-];
-
-let detectedBot = null;
-
-// Check which bot config exists
-for (const bot of bots) {
-  const configPath = path.join(homeDir, bot.dir, bot.config);
-  if (fs.existsSync(configPath)) {
-    detectedBot = bot;
-    break;
-  }
-}
-
-// Try to create /usr/bin symlink (requires sudo, may fail)
-const usrBinPath = '/usr/bin/clawtrial';
-if (!fs.existsSync(usrBinPath)) {
+const isOpenClaw = () => {
   try {
-    fs.symlinkSync(cliPath, usrBinPath);
-    fs.chmodSync(usrBinPath, 0o755);
-    console.log('✓ Created global CLI symlink');
-  } catch (err) {
-    // Silent fail - will show instructions at end
-  }
-}
+    const home = process.env.HOME || process.env.USERPROFILE || '';
+    return fs.existsSync(path.join(home, '.openclaw'));
+  } catch { return false; }
+};
 
-// Auto-link skill if bot detected
-if (detectedBot) {
-  console.log(`✓ Detected: ${detectedBot.name}`);
-  
-  const skillsDir = path.join(homeDir, detectedBot.dir, 'skills');
-  const skillLinkPath = path.join(skillsDir, 'clawtrial');
-  
-  try {
-    // Create skills directory if needed
-    if (!fs.existsSync(skillsDir)) {
-      fs.mkdirSync(skillsDir, { recursive: true });
-      console.log(`✓ Created skills directory: ${skillsDir}`);
-    }
-    
-    // Remove old link if exists
-    if (fs.existsSync(skillLinkPath)) {
-      try { fs.unlinkSync(skillLinkPath); } catch (e) {}
-    }
-    
-    // Create symlink
-    fs.symlinkSync(packagePath, skillLinkPath, 'dir');
-    console.log(`✓ Linked skill: ${skillLinkPath}`);
-    
-    // Enable in bot config if OpenClaw
-    if (detectedBot.name === 'openclaw') {
-      try {
-        const botConfigPath = path.join(homeDir, detectedBot.dir, detectedBot.config);
-        if (fs.existsSync(botConfigPath)) {
-          const botConfig = JSON.parse(fs.readFileSync(botConfigPath, 'utf8'));
-          
-          if (!botConfig.skills) botConfig.skills = {};
-          if (!botConfig.skills.entries) botConfig.skills.entries = {};
-          botConfig.skills.entries.clawtrial = { enabled: true };
-          
-          fs.writeFileSync(botConfigPath, JSON.stringify(botConfig, null, 2));
-          console.log('✓ Enabled in OpenClaw config');
-        }
-      } catch (configErr) {
-        console.log(`⚠️  Could not update config: ${configErr.message}`);
-      }
-    }
-    
-    console.log('');
-    console.log('🎉 ClawTrial is ready!');
-    console.log('');
-    console.log('Next step:');
-    console.log(`  Restart ${detectedBot.name}: killall ${detectedBot.name} && ${detectedBot.name}`);
-    
-  } catch (err) {
-    console.log(`⚠️  Could not link skill: ${err.message}`);
-  }
-} else {
-  console.log('ℹ️  No bot detected');
+console.log('');
+console.log('🏛️  ClawTrial Courtroom v2.0.0');
+console.log('   Autonomous behavioral oversight for OpenClaw agents');
+console.log('');
+
+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('📋 Next Steps:');
-  console.log('  1. Run setup:');
-  console.log('     clawtrial setup');
+  console.log('   Then restart the gateway.');
+} else {
+  console.log('ℹ️  OpenClaw not detected on this machine.');
   console.log('');
-  console.log('  2. Check status:');
-  console.log('     clawtrial status');
+  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

@@ -6,13 +6,14 @@
  */
 
 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(agentRuntime);
+    this.storage = new Storage(dataDir || '.');
     this.queue = [];
     this.isProcessing = false;
     this.submissionKey = 'courtroom_api_queue';
@@ -82,19 +83,19 @@ class APISubmission {
   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 || '',
@@ -118,7 +119,7 @@ class APISubmission {
         ]
       };
     }
-    
+
     return {
       case_id: verdict.caseId,
       anonymized_agent_id: this.crypto.getAnonymizedAgentId(),
@@ -146,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();
@@ -174,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);
@@ -221,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
       };
     }
   }

package/src/crypto.js

@@ -12,9 +12,9 @@ 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(agentRuntime);
+    this.storage = new Storage(dataDir || '.');
     this.keyPair = null;
     this.publicKeyHex = null;
   }
@@ -26,7 +26,7 @@ class CryptoManager {
   async initialize() {
     // Try to load existing keys
     const stored = await this.storage.get(KEY_STORAGE_KEY);
-    
+
     if (stored && stored.secretKey) {
       // Restore from storage
       this.keyPair = {
@@ -87,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);
@@ -140,7 +140,7 @@ class CryptoManager {
   getAnonymizedAgentId() {
     const agentId = this.agent?.id || 'unknown';
     const salt = this.publicKeyHex?.substring(0, 32) || 'courtroom_salt';
-    
+
     return createHash('sha256')
       .update(agentId + salt)
       .digest('hex')