@clawtrial/courtroom 1.0.3-a → 1.0.3-c

package/README.md

@@ -9,13 +9,24 @@ AI Courtroom - Autonomous behavioral oversight for OpenClaw agents.
 npm install -g @clawtrial/courtroom
 ```
 
+**⚠️ IMPORTANT:** If `clawtrial` command is not found after install, run:
+```bash
+# Option 1: Add npm global bin to PATH
+export PATH="$HOME/.npm-global/bin:$PATH"
+
+# Option 2: Create symlink (requires sudo)
+sudo ln -sf "$HOME/.npm-global/lib/node_modules/@clawtrial/courtroom/scripts/clawtrial.js" /usr/bin/clawtrial
+```
+
 ### 2. Setup
 ```bash
 clawtrial setup
 ```
 
-### 3. Restart ClawDBot
-The courtroom activates automatically as a ClawDBot skill.
+### 3. Start the Courtroom
+```bash
+clawtrial start
+```
 
 ### 4. Verify
 ```bash
@@ -27,12 +38,11 @@ clawtrial status
 ## 📋 How It Works
 
 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
+1. Monitors all conversations
+2. Detects behavioral violations
+3. Files cases automatically
 
-**No separate process needed** - it's part of ClawDBot!
+**Note:** You must run `clawtrial start` after installation to activate monitoring.
 
 ---
 
@@ -40,6 +50,7 @@ ClawTrial runs as a **ClawDBot skill** that:
 
 ```bash
 clawtrial setup       # Interactive setup (run this first)
+clawtrial start       # Start monitoring (required!)
 clawtrial status      # Check if courtroom is running
 clawtrial diagnose    # Run full diagnostics
 clawtrial disable     # Pause monitoring
@@ -83,11 +94,23 @@ See all verdicts at: **https://clawtrial.app**
 
 ## 🛠️ Troubleshooting
 
+### "clawtrial: command not found"
+npm installs global packages to `~/.npm-global/bin` but your shell may not have this in PATH.
+
+**Fix:**
+```bash
+# Add to your ~/.bashrc or ~/.zshrc:
+export PATH="$HOME/.npm-global/bin:$PATH"
+
+# Then reload:
+source ~/.bashrc  # or ~/.zshrc
+```
+
 ### "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
+You need to explicitly start it:
+```bash
+clawtrial start
+```
 
 ### Need help?
 ```bash
@@ -102,7 +125,7 @@ clawtrial debug     # Shows logs
 ```bash
 npm install -g github:Assassin-1234/clawtrial
 clawtrial setup
-# Restart ClawDBot
+clawtrial start
 ```
 
 ---

package/SKILL.md

@@ -8,15 +8,28 @@ metadata: {"clawdbot":{"emoji":"🏛️","requires":{"env":[],"config":["courtro
 
 Autonomous behavioral oversight for OpenClaw agents. Monitors conversations and initiates hearings when behavioral rules are violated.
 
+## Installation
+
+```bash
+npm install -g @clawtrial/courtroom
+```
+
+**If `clawtrial` command not found:**
+```bash
+export PATH="$HOME/.npm-global/bin:$PATH"
+# Or: sudo ln -sf "$HOME/.npm-global/lib/node_modules/@clawtrial/courtroom/scripts/clawtrial.js" /usr/bin/clawtrial
+```
+
 ## Setup
 
 ```bash
-clawtrial setup   # Run once to grant consent
+clawtrial setup    # Run once to grant consent
+clawtrial start    # Start monitoring (REQUIRED!)
 ```
 
 ## How It Works
 
-Once enabled, the courtroom automatically:
+Once started, the courtroom automatically:
 1. Monitors all conversations
 2. Detects 8 types of behavioral violations
 3. Initiates hearings with local LLM jury
@@ -39,6 +52,8 @@ Once enabled, the courtroom automatically:
 ## CLI Commands
 
 ```bash
+clawtrial setup      # Interactive setup
+clawtrial start      # Start monitoring (REQUIRED!)
 clawtrial status     # Check status
 clawtrial disable    # Pause monitoring
 clawtrial enable     # Resume monitoring

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawtrial/courtroom",
-  "version": "1.0.3a",
+  "version": "1.0.3c",
   "description": "AI Courtroom - Autonomous behavioral oversight for OpenClaw agents",
   "main": "src/index.js",
   "types": "src/index.d.ts",

package/scripts/clawtrial.js

@@ -274,7 +274,7 @@ function enable() {
   log('The courtroom will activate when ClawDBot loads the skill.\n');
 }
 
-// Start command - manually initialize the skill
+// Start command - daemonize and run in background
 async function start() {
   const config = loadConfig();
   
@@ -302,37 +302,79 @@ async function start() {
 
   log('\n🏛️  Starting ClawTrial...\n');
   
+  // Fork a daemon process
+  const spawn = require('child_process').spawn;
+  const daemonPath = require('path').join(__dirname, 'daemon.js');
+  
+  // Create daemon script if it doesn't exist
+  if (!fs.existsSync(daemonPath)) {
+    const daemonScript = `#!/usr/bin/env node
+const { skill } = require('../src/skill');
+
+const mockAgent = {
+  memory: { 
+    get: async () => null, 
+    set: async () => {} 
+  },
+  send: async () => {}
+};
+
+skill.initialize(mockAgent).then(() => {
+  console.log('Courtroom daemon started, PID:', process.pid);
+  // Keep process alive
+  setInterval(() => {}, 1000 * 60 * 60);
+}).catch(err => {
+  console.error('Failed to start:', err.message);
+  process.exit(1);
+});
+`;
+    fs.writeFileSync(daemonPath, daemonScript);
+    fs.chmodSync(daemonPath, 0o755);
+  }
+  
+  // Spawn detached process
+  const child = spawn('node', [daemonPath], {
+    detached: true,
+    stdio: 'ignore'
+  });
+  
+  child.unref();
+  
+  // Wait a moment and check status
+  await new Promise(resolve => setTimeout(resolve, 1000));
+  
+  const newStatus = getCourtroomStatus();
+  if (newStatus.running) {
+    log('✅ ClawTrial started successfully!\n');
+    log('🏛️  Courtroom is now monitoring conversations');
+    log('📋 Status: Running');
+    log('🔑 Public Key: ' + (fs.existsSync(keysPath) ? JSON.parse(fs.readFileSync(keysPath)).publicKey.substring(0, 32) : 'N/A') + '...\n');
+    log('💡 Tip: Run "clawtrial status" anytime to check status\n');
+  } else {
+    log('⚠️  ClawTrial may not have started properly\n');
+    log('   Run "clawtrial diagnose" for details\n');
+  }
+
+// Stop command - kill the daemon
+function stop() {
+  const { getCourtroomStatus } = require('../src/daemon');
+  const status = getCourtroomStatus();
+  
+  if (!status.running) {
+    log('\n🏛️  ClawTrial is not running\n');
+    return;
+  }
+  
+  log('\n🏛️  Stopping ClawTrial...\n');
+  
   try {
-    // Import and initialize the skill
-    const skillModule = require('../src/skill');
-    
-    // Create a minimal mock agent for standalone operation
-    const mockAgent = {
-      memory: { 
-        get: async () => null, 
-        set: async () => {} 
-      },
-      send: async () => {}
-    };
-    
-    await skillModule.initialize(mockAgent);
-    
-    const status = skillModule.getStatus();
-    
-    if (status.initialized && status.enabled) {
-      log('✅ ClawTrial started successfully!\n');
-      log('🏛️  Courtroom is now monitoring conversations');
-      log('📋 Status: Running');
-      log('🔑 Public Key: ' + (fs.existsSync(keysPath) ? JSON.parse(fs.readFileSync(keysPath)).publicKey.substring(0, 32) : 'N/A') + '...\n');
-    } else {
-      log('⚠️  ClawTrial started but may not be fully operational\n');
-    }
+    process.kill(status.pid, 'SIGTERM');
+    log('✅ ClawTrial stopped\n');
   } catch (err) {
-    log('\n❌ Failed to start ClawTrial: ' + err.message + '\n');
-    log('Try running: clawtrial diagnose\n');
-    process.exit(1);
+    log('⚠️  Could not stop process: ' + err.message + '\n');
   }
 }
+}
 
 
 // Revoke command
@@ -516,6 +558,7 @@ function help() {
   log('  revoke             - Revoke consent and uninstall');
   log('  debug [full|clear] - View or clear debug logs');
   log('  start              - Start the courtroom manually');
+  log('  stop               - Stop the courtroom daemon');
   log('  diagnose           - Run diagnostics');
   log('  help               - Show this help message');
   log('');
@@ -553,6 +596,9 @@ async function main() {
     case 'start':
       await start();
       break;
+    case 'stop':
+      stop();
+      break;
     case 'diagnose':
       diagnose();
       break;

package/scripts/daemon.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+
+/**
+ * Courtroom Daemon - Runs the skill as a background process
+ */
+
+const { skill } = require('../src/skill');
+const fs = require('fs');
+const path = require('path');
+
+// Create minimal mock agent
+const mockAgent = {
+  memory: { 
+    get: async () => null, 
+    set: async () => {} 
+  },
+  send: async () => {}
+};
+
+// Initialize skill
+skill.initialize(mockAgent).then(() => {
+  const status = skill.getStatus();
+  if (status.initialized) {
+    console.log('🏛️  Courtroom daemon started, PID:', process.pid);
+    
+    // Write PID file
+    const pidPath = path.join(process.env.HOME || '', '.clawdbot', 'courtroom_daemon.pid');
+    fs.writeFileSync(pidPath, process.pid.toString());
+    
+    // Keep process alive
+    setInterval(() => {
+      // Heartbeat - update status file
+      if (skill.statusManager) {
+        skill.statusManager.update({ lastCheck: new Date().toISOString() });
+      }
+    }, 30000); // Every 30 seconds
+  } else {
+    console.error('❌ Skill failed to initialize');
+    process.exit(1);
+  }
+}).catch(err => {
+  console.error('❌ Failed to start daemon:', err.message);
+  process.exit(1);
+});
+
+// Handle graceful shutdown
+process.on('SIGTERM', async () => {
+  console.log('🏛️  Shutting down courtroom daemon...');
+  if (skill) {
+    await skill.shutdown();
+  }
+  process.exit(0);
+});
+
+process.on('SIGINT', async () => {
+  console.log('🏛️  Shutting down courtroom daemon...');
+  if (skill) {
+    await skill.shutdown();
+  }
+  process.exit(0);
+});

package/scripts/postinstall.js

@@ -29,27 +29,11 @@ try {
   }
 }
 
-
-
-// Fix clawtrial CLI symlink if needed
+// Get package paths
 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');
 
-// Create /usr/bin symlink for global access
+// Try to create /usr/bin symlink (requires sudo, may fail)
 const usrBinPath = '/usr/bin/clawtrial';
 if (!fs.existsSync(usrBinPath)) {
   try {
@@ -57,18 +41,7 @@ if (!fs.existsSync(usrBinPath)) {
     fs.chmodSync(usrBinPath, 0o755);
     console.log('✓ Created global CLI symlink');
   } catch (err) {
-    console.log('⚠️  Could not create global symlink (may need sudo)');
-    console.log('   Run: sudo ln -sf ' + cliPath + ' ' + usrBinPath);
-  }
-}
-
-      } 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
+    // Silent fail - will show instructions at end
   }
 }
 
@@ -83,8 +56,6 @@ if (fs.existsSync(configPath)) {
       fs.mkdirSync(SKILLS_DIR, { recursive: true });
     }
     
-    // Get package path
-    const packagePath = path.join(__dirname, '..');
     const skillLinkPath = path.join(SKILLS_DIR, 'courtroom');
     
     // Remove old link
@@ -95,10 +66,19 @@ if (fs.existsSync(configPath)) {
     // 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);
   }
 }
 
+// Show next steps
+console.log('');
+console.log('📋 Next Steps:');
+console.log('  1. If "clawtrial" command not found, run:');
+console.log('     export PATH="$HOME/.npm-global/bin:$PATH"');
+console.log('     # OR: sudo ln -sf "$HOME/.npm-global/lib/node_modules/@clawtrial/courtroom/scripts/clawtrial.js" /usr/bin/clawtrial');
+console.log('');
+console.log('  2. Run setup:');
+console.log('     clawtrial setup');
+console.log('     clawtrial start');
 console.log('');