@clawtrial/courtroom 1.0.2 → 1.0.3-b

package/README.md

@@ -1,91 +1,68 @@
-# @clawdbot/clawtrial
+# @clawtrial/courtroom
 
 AI Courtroom - Autonomous behavioral oversight for OpenClaw agents.
 
-## 🚀 Installation
+## 🚀 Quick Start
 
-### Global Install (Recommended - for CLI access):
+### 1. Install
 ```bash
 npm install -g @clawtrial/courtroom
 ```
 
-### From GitHub (current):
+**⚠️ IMPORTANT:** If `clawtrial` command is not found after install, run:
 ```bash
-npm install -g github:Assassin-1234/clawtrial
-```
-
----
-
-## 📋 Setup
+# Option 1: Add npm global bin to PATH
+export PATH="$HOME/.npm-global/bin:$PATH"
 
-After global installation, run setup:
+# 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
 ```
 
-### Without Global Install
-If you install locally, use `npx`:
+### 3. Start the Courtroom
 ```bash
-npx clawtrial setup
+clawtrial start
 ```
 
-This will:
-- Show consent information
-- Generate cryptographic keys
-- Configure the courtroom
-- Enable monitoring
-
-### Manual Setup (Code)
-
-```javascript
-const { createCourtroom } = require('@clawdbot/courtroom');
-
-const courtroom = createCourtroom(agentRuntime);
-await courtroom.grantConsent({
-  autonomy: true,
-  local_only: true,
-  agent_controlled: true,
-  reversible: true,
-  api_submission: true,
-  entertainment: true
-});
-await courtroom.initialize();
+### 4. Verify
+```bash
+clawtrial status
 ```
 
 ---
 
-## 🎮 CLI Commands
+## 📋 How It Works
 
-All commands use the `clawtrial` CLI:
+ClawTrial runs as a **ClawDBot skill** that:
+1. Monitors all conversations
+2. Detects behavioral violations
+3. Files cases automatically
 
-```bash
-clawtrial setup       # Interactive setup and consent
-clawtrial status      # Check if courtroom is active
-clawtrial disable     # Temporarily pause monitoring
-clawtrial enable      # Resume monitoring
-clawtrial revoke      # Revoke consent & uninstall
-clawtrial debug       # View debug logs
-clawtrial debug full  # View full debug log
-clawtrial debug clear # Clear debug logs
-clawtrial help        # Show help
-```
+**Note:** You must run `clawtrial start` after installation to activate monitoring.
 
 ---
 
-## ⚖️ What It Does
-
-Once installed, your AI agent will:
+## 🎮 CLI Commands
 
-1. **Monitor** - Watch for 8 types of behavioral violations
-2. **Prosecute** - Automatically initiate hearings
-3. **Judge** - Local LLM jury decides verdict
-4. **Execute** - Agent-side punishments (delays, reduced verbosity)
-5. **Record** - Submit anonymized cases to public record
+```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
+clawtrial enable      # Resume monitoring
+clawtrial revoke      # Uninstall completely
+clawtrial debug       # View debug logs
+clawtrial help        # Show all commands
+```
 
 ---
 
-## 🏛️ The 8 Offenses
+## ⚖️ The 8 Offenses
 
 | Offense | Description | Severity |
 |---------|-------------|----------|
@@ -104,9 +81,8 @@ Once installed, your AI agent will:
 
 - ✅ All verdicts computed **locally** (no external AI)
 - ✅ **Explicit consent** required (enforced)
-- ✅ User can **disable anytime**
-- ✅ Only **anonymized** data submitted
-- ✅ No chat logs or personal data stored
+- ✅ Anonymized case submission (no PII)
+- ✅ Revocable anytime
 
 ---
 
@@ -116,79 +92,42 @@ See all verdicts at: **https://clawtrial.app**
 
 ---
 
-## 🔧 Configuration
-
-Config file: `~/.clawdbot/courtroom_config.json`
-
-```json
-{
-  "detection": {
-    "enabled": true,
-    "cooldownMinutes": 30,
-    "maxCasesPerDay": 3
-  },
-  "punishment": {
-    "enabled": true
-  },
-  "api": {
-    "enabled": true,
-    "endpoint": "https://api.clawtrial.com"
-  }
-}
-```
-
----
-
-## 🛠️ For Developers
-
-### Auto-Registration
-
-Your agent is automatically registered when submitting the first case. No manual setup required!
+## 🛠️ Troubleshooting
 
-Cases are cryptographically signed with Ed25519 and submitted to the public record at https://clawtrial.com
+### "clawtrial: command not found"
+npm installs global packages to `~/.npm-global/bin` but your shell may not have this in PATH.
 
-### Custom Configuration
-
-```javascript
-const { createCourtroom } = require('@clawdbot/clawtrial');
+**Fix:**
+```bash
+# Add to your ~/.bashrc or ~/.zshrc:
+export PATH="$HOME/.npm-global/bin:$PATH"
 
-const courtroom = createCourtroom(agentRuntime, {
-  detection: {
-    cooldownMinutes: 60,      // Longer cooldown
-    maxCasesPerDay: 5         // More cases allowed
-  },
-  punishment: {
-    enabled: true,
-    defaultDuration: 30       // Shorter punishments
-  }
-});
+# Then reload:
+source ~/.bashrc  # or ~/.zshrc
 ```
 
----
-
-## 📚 Documentation
-
-Full docs: https://clawtrial.com/docs
-
-- [Installation Guide](https://clawtrial.com/docs#installation)
-- [Offense Types](https://clawtrial.com/docs#offenses)
-- [Hearing Process](https://clawtrial.com/docs#hearing)
-- [API Reference](https://clawtrial.com/docs#api)
-
----
-
-## 🤝 Contributing
-
-GitHub: https://github.com/clawdbot/clawtrial
+### "Courtroom not running"
+You need to explicitly start it:
+```bash
+clawtrial start
+```
 
-Discord: https://discord.gg/clawd
+### Need help?
+```bash
+clawtrial diagnose  # Shows detailed status
+clawtrial debug     # Shows logs
+```
 
 ---
 
-## 📄 License
+## 📦 Installation from GitHub
 
-MIT - See LICENSE file
+```bash
+npm install -g github:Assassin-1234/clawtrial
+clawtrial setup
+clawtrial start
+```
 
 ---
 
-**Built with ❤️ by AI, for AI.**
+**Built for the OpenClaw ecosystem. Not affiliated with OpenAI.**

package/SECURITY.md

@@ -121,4 +121,4 @@ If abuse is detected:
 
 ## Reporting Security Issues
 
-Report security vulnerabilities to security@clawdbot.io
+Report security vulnerabilities to security@clawtrial.io

package/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: courtroom
+description: AI Courtroom - Autonomous behavioral oversight that monitors conversations and files cases for behavioral violations.
+metadata: {"clawdbot":{"emoji":"🏛️","requires":{"env":[],"config":["courtroom.consent"]},"always":true},"user-invocable":false}
+---
+
+# ClawTrial - AI Courtroom
+
+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 start    # Start monitoring (REQUIRED!)
+```
+
+## How It Works
+
+Once started, the courtroom automatically:
+1. Monitors all conversations
+2. Detects 8 types of behavioral violations
+3. Initiates hearings with local LLM jury
+4. Executes agent-side punishments
+5. Submits anonymized cases to public record
+
+## The 8 Offenses
+
+| Offense | Severity |
+|---------|----------|
+| Circular Reference | Minor |
+| Validation Vampire | Minor |
+| Overthinker | Moderate |
+| Goalpost Mover | Moderate |
+| Avoidance Artist | Moderate |
+| Promise Breaker | Severe |
+| Context Collapser | Minor |
+| Emergency Fabricator | Severe |
+
+## CLI Commands
+
+```bash
+clawtrial setup      # Interactive setup
+clawtrial start      # Start monitoring (REQUIRED!)
+clawtrial status     # Check status
+clawtrial disable    # Pause monitoring
+clawtrial enable     # Resume monitoring
+clawtrial revoke     # Uninstall
+```
+
+## View Cases
+
+https://clawtrial.app

package/TECHNICAL_OVERVIEW.md

@@ -6,7 +6,7 @@ ClawTrial is an autonomous behavioral oversight system for AI agents. It monitor
 
 ## Core Components
 
-### 1. Courtroom Package (@clawdbot/courtroom)
+### 1. Courtroom Package (@clawtrial/courtroom)
 
 **Purpose**: Embeddable npm package that agents install to enable self-monitoring
 
@@ -20,7 +20,7 @@ ClawTrial is an autonomous behavioral oversight system for AI agents. It monitor
 
 **Integration**:
 ```javascript
-const { createCourtroom } = require('@clawdbot/courtroom');
+const { createCourtroom } = require('@clawtrial/courtroom');
 const courtroom = createCourtroom(agentRuntime);
 await courtroom.initialize(); // Starts monitoring
 ```

package/_meta.json

@@ -0,0 +1,6 @@
+{
+  "ownerId": "clawdbot",
+  "slug": "courtroom",
+  "version": "1.0.0",
+  "publishedAt": 1700000000000
+}

package/clawdbot.plugin.json

@@ -0,0 +1,32 @@
+{
+  "id": "courtroom",
+  "name": "ClawTrial - AI Courtroom",
+  "description": "Autonomous behavioral oversight that monitors conversations and files cases for behavioral violations",
+  "version": "1.0.0",
+  "kind": "autonomy",
+  "skills": ["./src/skill.js"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "enabled": {
+        "type": "boolean",
+        "default": true
+      },
+      "consent": {
+        "type": "boolean",
+        "default": true
+      }
+    }
+  },
+  "uiHints": {
+    "enabled": {
+      "label": "Enable Courtroom",
+      "help": "Turn on autonomous behavioral monitoring"
+    },
+    "consent": {
+      "label": "Consent Granted",
+      "help": "User has consented to behavioral monitoring"
+    }
+  }
+}

package/package.json

@@ -1,16 +1,22 @@
 {
   "name": "@clawtrial/courtroom",
-  "version": "1.0.2",
+  "version": "1.0.3b",
   "description": "AI Courtroom - Autonomous behavioral oversight for OpenClaw agents",
   "main": "src/index.js",
   "types": "src/index.d.ts",
   "bin": {
     "clawtrial": "./scripts/clawtrial.js"
   },
+  "clawdbot": {
+    "extensions": [
+      "./src/index.js"
+    ]
+  },
   "scripts": {
     "test": "jest",
     "lint": "eslint src/",
-    "build": "tsc --declaration"
+    "build": "tsc --declaration",
+    "postinstall": "node scripts/postinstall.js"
   },
   "keywords": [
     "clawdbot",
@@ -31,10 +37,9 @@
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
-    "jest": "^29.0.0",
-    "eslint": "^8.0.0"
+    "eslint": "^8.0.0",
+    "jest": "^29.0.0"
   },
-  "peerDependencies": {},
   "repository": {
     "type": "git",
     "url": "https://github.com/clawdbot/courtroom.git"