@clawtrial/courtroom 1.0.3-a → 1.0.3-b

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.3b",
   "description": "AI Courtroom - Autonomous behavioral oversight for OpenClaw agents",
   "main": "src/index.js",
   "types": "src/index.d.ts",

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('');