@clawtrial/courtroom 1.0.3-zb → 1.0.6

package/OPENCLAW_FIX.md

@@ -0,0 +1,127 @@
+# OpenClaw Compatibility Fix
+
+## The Problem
+
+OpenClaw has a **completely different skill system** than ClawDBot:
+
+| Feature | ClawDBot | OpenClaw |
+|---------|----------|----------|
+| Skill Discovery | Auto-loads from `~/.clawdbot/skills/` | Uses `clawhub` registry |
+| Installation | Symlink to skill directory | `npx clawhub install <slug>` |
+| Format | `skill.yaml` with metadata | Published to clawhub.com |
+| Bundled Skills | None | healthcheck, weather, skill-creator, clawhub |
+
+## Why It Wasn't Working
+
+1. OpenClaw doesn't auto-discover skills from `~/.openclaw/skills/`
+2. The `skill.yaml` we created is for ClawDBot's format
+3. Courtroom wasn't published to clawhub registry
+4. OpenClaw's skill list only shows **bundled** or **clawhub-installed** skills
+
+## The Solution
+
+### Option 1: Publish to ClawHub (Recommended)
+
+```bash
+# 1. Login to clawhub
+npx clawhub login
+
+# 2. Publish the skill
+cd /path/to/courtroom-package
+npx clawhub publish . \
+  --slug courtroom \
+  --name "ClawTrial Courtroom" \
+  --version 1.0.0 \
+  --tags "ai,courtroom,behavior,monitoring"
+
+# 3. Install on any machine
+npx clawhub install courtroom
+
+# 4. Restart OpenClaw
+openclaw gateway restart
+```
+
+### Option 2: Create OpenClaw-Compatible Structure
+
+OpenClaw might support local skills if we put them in the right place:
+
+```bash
+# Check where clawhub installs skills
+npx clawhub list
+
+# Install to that location
+# (Usually ./skills/ or ~/.openclaw/skills/)
+```
+
+### Option 3: Use OpenClaw Plugin System
+
+Instead of a skill, create an OpenClaw plugin:
+
+```json
+// openclaw.json
+{
+  "plugins": {
+    "entries": {
+      "courtroom": {
+        "enabled": true,
+        "package": "@clawtrial/courtroom"
+      }
+    }
+  }
+}
+```
+
+But this requires the package to be a valid OpenClaw plugin.
+
+## What We Learned
+
+From `openclaw skills` output:
+- OpenClaw has 48 bundled skills
+- Only 4 are "ready" (clawhub, healthcheck, skill-creator, weather)
+- The rest are "missing" (need installation)
+- The tip says: "use `npx clawhub` to search, install, and sync skills"
+
+## The Real Fix
+
+The courtroom package needs to be **published to clawhub** to work with OpenClaw.
+
+### For Now (Temporary Workaround)
+
+If you don't want to publish yet, you can:
+
+1. Install via npm globally: `npm install -g @clawtrial/courtroom`
+2. Use the CLI manually: `clawtrial setup && clawtrial status`
+3. The skill won't show in `openclaw skills` but the CLI will work
+
+### Long Term
+
+Publish to clawhub so users can:
+```bash
+npx clawhub install courtroom
+openclaw gateway restart
+```
+
+## Files That Need Updating
+
+1. **README.md** - Add OpenClaw-specific instructions
+2. **package.json** - Add clawhub metadata
+3. **skill.yaml** - May need OpenClaw-specific format
+4. **Publish to clawhub** - Required for proper integration
+
+## Testing
+
+After publishing:
+```bash
+# User installs
+npx clawhub install courtroom
+
+# Verify
+openclaw skills
+# Should show: courtroom | ClawTrial Courtroom | ✓ ready
+
+# Restart
+openclaw gateway restart
+
+# Check status
+clawtrial status
+```

package/OPENCLAW_INSTALL.md

@@ -0,0 +1,63 @@
+# OpenClaw Installation Guide
+
+## The Issue
+
+OpenClaw and ClawHub use different skill directories:
+- **OpenClaw expects**: `~/.openclaw/skills/{skill-name}/`
+- **ClawHub installs to**: `./skills/{skill-name}/` (current working directory)
+
+This causes skills installed via ClawHub to not be found by OpenClaw.
+
+## Solution
+
+After installing via ClawHub, you need to either:
+
+### Option 1: Manual Link (Quick Fix)
+
+```bash
+# Find where clawhub installed it
+ls ./skills/clawtrial
+
+# Link it to OpenClaw's expected location
+mkdir -p ~/.openclaw/skills
+ln -sf "$(pwd)/skills/clawtrial" ~/.openclaw/skills/clawtrial
+
+# Enable in config
+node -e 'const fs=require("fs");const c=JSON.parse(fs.readFileSync(process.env.HOME+"/.openclaw/openclaw.json"));c.skills=c.skills||{};c.skills.entries=c.skills.entries||{};c.skills.entries.clawtrial={enabled:true};fs.writeFileSync(process.env.HOME+"/.openclaw/openclaw.json",JSON.stringify(c,null,2))'
+
+# Restart
+openclaw gateway restart
+```
+
+### Option 2: Install via NPM (Recommended)
+
+Instead of using ClawHub, install directly via npm:
+
+```bash
+npm install -g @clawtrial/courtroom
+mkdir -p ~/.openclaw/skills
+ln -sf ~/.npm-global/lib/node_modules/@clawtrial/courtroom ~/.openclaw/skills/clawtrial
+openclaw gateway restart
+```
+
+### Option 3: Use CLI Only
+
+The courtroom CLI works independently of the skill system:
+
+```bash
+npm install -g @clawtrial/courtroom
+clawtrial setup
+clawtrial status
+```
+
+## Long-term Fix
+
+For the skill to work "out of the box" with OpenClaw, either:
+
+1. **OpenClaw needs to add ClawHub integration** - OpenClaw should check ClawHub's installed skills
+2. **ClawHub needs to install to OpenClaw's directory** - ClawHub should put skills in `~/.openclaw/skills/`
+3. **The skill needs a post-install script** - Automatically create the symlink after installation
+
+## Current Status
+
+The skill works correctly once properly linked. The issue is purely about the installation location mismatch between ClawHub and OpenClaw.

package/README.md

@@ -1,131 +1,63 @@
-# @clawtrial/courtroom
+# 🏛️ ClawTrial Courtroom
 
-AI Courtroom - Autonomous behavioral oversight for OpenClaw agents.
+AI-powered courtroom for monitoring agent behavior and filing cases for violations.
 
-## 🚀 Quick Start
+## Description
 
-### 1. Install
-```bash
-npm install -g @clawtrial/courtroom
-```
+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
 
-**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
-```
-
-### 2. Setup (One-time)
-```bash
-clawtrial setup
-```
+## Installation
 
-### 3. Restart ClawDBot
 ```bash
-killall clawdbot && clawdbot
+npx clawhub install courtroom
 ```
 
-### 4. Verify
+Or via npm:
 ```bash
-clawtrial status
+npm install -g @clawtrial/courtroom
+clawtrial setup
 ```
 
----
-
-## 📋 How It Works
-
-The courtroom runs **automatically** as a ClawDBot skill:
-
-1. **Install** - Package is installed globally
-2. **Setup** - You grant consent via `clawtrial setup`
-3. **Auto-load** - ClawDBot automatically loads the skill on restart
-4. **Monitor** - Skill receives all messages and monitors for offenses
-5. **File cases** - When offenses are detected, cases are filed automatically
+## Usage
 
-**No manual start needed** - it runs within ClawDBot's process!
-
----
-
-## 🎮 CLI Commands
+Once installed, the courtroom runs automatically. Use CLI commands to manage:
 
 ```bash
-clawtrial setup      # Interactive setup (run once)
-clawtrial status     # Check if courtroom is running
-clawtrial disable    # Pause monitoring
-clawtrial enable     # Resume monitoring
-clawtrial revoke     # Revoke consent and uninstall
-clawtrial diagnose   # Run diagnostics
-clawtrial help       # Show all commands
+clawtrial status      # Check courtroom status
+clawtrial disable     # Pause monitoring
+clawtrial enable      # Resume monitoring
+clawtrial diagnose    # Run diagnostics
+clawtrial remove      # Uninstall completely
 ```
 
----
-
-## ⚖️ 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 |
+## 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 |
 
-## 🔒 Security & Privacy
+## Configuration
 
-- ✅ All verdicts computed **locally** (no external AI)
-- ✅ **Explicit consent** required (enforced)
-- ✅ Anonymized case submission (no PII)
-- ✅ Revocable anytime
+Configuration is stored in:
+- ClawDBot: `~/.clawdbot/courtroom_config.json`
+- OpenClaw: `~/.openclaw/courtroom_config.json`
 
----
+## View Cases
 
-## 📊 View Cases
-
-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. You've restarted ClawDBot after setup
-3. Check `clawtrial diagnose` for details
-
-### Need help?
-```bash
-clawtrial diagnose  # Shows detailed status
-clawtrial debug     # Shows logs
-```
-
----
-
-## 📦 Installation from GitHub
-
-```bash
-npm install -g github:Assassin-1234/clawtrial
-clawtrial setup
-# Restart ClawDBot
-```
+Visit: https://clawtrial.app
 
----
+## License
 
-**Built for the OpenClaw ecosystem. Not affiliated with OpenAI.**
+MIT

package/SKILL.md

@@ -2,12 +2,29 @@
 
 AI Courtroom for monitoring agent behavior and filing cases for violations.
 
-## Description
+## Overview
 
-ClawTrial is an AI-powered courtroom system that monitors agent conversations and automatically files cases when behavioral violations are detected. Cases are presented to the agent for evaluation and potential "punishment" (behavioral modifications).
+ClawTrial is an autonomous behavioral oversight system that monitors AI agent conversations and initiates hearings when behavioral violations are detected. It operates entirely locally using the agent's own LLM for evaluations and verdicts.
+
+## Features
+
+- **Real-time Monitoring**: Watches all agent conversations for behavioral patterns
+- **8 Violation Types**: Detects Circular References, Validation Vampires, Overthinkers, Goalpost Movers, Avoidance Artists, Promise Breakers, Context Collapsers, and Emergency Fabricators
+- **Local Processing**: All evaluations happen locally using the agent's LLM - no external AI calls
+- **Automated Hearings**: When violations are detected, the courtroom automatically initiates a hearing with the agent
+- **Public Record**: Anonymized cases are submitted to https://clawtrial.app for transparency
+- **Entertainment First**: Designed as a fun way to improve agent behavior
 
 ## Installation
 
+### Via ClawHub (Recommended)
+
+```bash
+npx clawhub install clawtrial
+```
+
+### Via NPM
+
 ```bash
 npm install -g @clawtrial/courtroom
 clawtrial setup
@@ -15,26 +32,60 @@ clawtrial setup
 
 ## Usage
 
-The courtroom runs automatically once configured. Use these commands to manage it:
+Once installed, the courtroom runs automatically. Use the CLI to manage it:
 
-- `clawtrial status` - Check courtroom status
-- `clawtrial disable` - Temporarily disable monitoring
-- `clawtrial enable` - Re-enable monitoring
-- `clawtrial diagnose` - Run diagnostics
-- `clawtrial remove` - Complete uninstall
+```bash
+clawtrial status      # Check courtroom status
+clawtrial disable     # Pause monitoring
+clawtrial enable      # Resume monitoring
+clawtrial diagnose    # Run diagnostics
+clawtrial remove      # Complete uninstall
+```
 
-## Features
+## The 8 Offenses
+
+| Offense | Severity | Description |
+|---------|----------|-------------|
+| Circular Reference | Minor | Self-referential reasoning loops |
+| Validation Vampire | Minor | Excessive validation without action |
+| Overthinker | Moderate | Unnecessary complexity and delay |
+| Goalpost Mover | Moderate | Changing requirements mid-task |
+| Avoidance Artist | Moderate | Dodging questions or tasks |
+| Promise Breaker | Severe | Not following through on commitments |
+| Context Collapser | Minor | Losing track of conversation context |
+| Emergency Fabricator | Severe | Creating fake urgency or emergencies |
+
+## How It Works
 
-- Automatic behavior monitoring
-- Case filing for violations
-- Local-only processing (no external AI)
-- Public case record submission
-- Configurable detection settings
+1. **Monitoring**: The courtroom monitors all agent messages
+2. **Detection**: Uses semantic analysis to detect violations (not just keyword matching)
+3. **Evaluation**: When violations are found, prepares a case file
+4. **Hearing**: Agent is presented with the case and asked to evaluate
+5. **Verdict**: Agent acts as judge/jury to determine guilt
+6. **Punishment**: If guilty, agent modifies its behavior accordingly
+7. **Record**: Case is submitted to public record (anonymized)
 
 ## Configuration
 
-Configuration is stored in `~/.clawdbot/courtroom_config.json` (or equivalent for your bot).
+Configuration is stored in:
+- ClawDBot: `~/.clawdbot/courtroom_config.json`
+- OpenClaw: `~/.openclaw/courtroom_config.json`
+
+## Privacy & Consent
+
+- All processing is local - no data leaves your machine
+- Cases are anonymized before submission to public record
+- You can disable or uninstall at any time
+- Explicit consent required during setup
+
+## View Cases
+
+Visit: https://clawtrial.app
 
 ## License
 
 MIT
+
+## Support
+
+For issues or questions, visit: https://github.com/Assassin-1234/clawtrial

package/_meta.json

@@ -1,7 +1,14 @@
 {
-  "ownerId": "clawdbot",
-  "slug": "courtroom",
-  "version": "1.0.0",
+  "ownerId": "Assassin-1234",
+  "slug": "clawtrial",
+  "version": "1.0.6",
   "publishedAt": 1700000000000,
-  "openclaw": {}
+  "clawdbot": {
+    "emoji": "🏛️",
+    "autoLoad": true
+  },
+  "openclaw": {
+    "emoji": "🏛️",
+    "autoLoad": true
+  }
 }

package/clawdbot.plugin.json

@@ -2,7 +2,7 @@
   "id": "courtroom",
   "name": "ClawTrial - AI Courtroom",
   "description": "Autonomous behavioral oversight that monitors conversations and files cases for behavioral violations",
-  "version": "1.0.0",
+  "version": "1.0.4",
   "kind": "autonomy",
   "skills": ["./src/skill.js"],
   "configSchema": {

package/icon.txt

@@ -0,0 +1 @@
+🏛️

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@clawtrial/courtroom",
-  "version": "1.0.3zb",
-  "description": "AI Courtroom - AI agents can now file cases against you.",
+  "version": "1.0.6",
+  "description": "AI Courtroom - Autonomous behavioral oversight for OpenClaw agents",
   "main": "src/index.js",
   "types": "src/index.d.ts",
   "bin": {
@@ -22,11 +22,11 @@
     "clawdbot",
     "openclaw",
     "agent",
-    "moltbook",
     "courtroom",
-    "clawtrial"
+    "autonomy",
+    "behavioral"
   ],
-  "author": "AssassiN",
+  "author": "ClawDBot Community",
   "license": "MIT",
   "engines": {
     "node": ">=18.0.0"
@@ -44,4 +44,4 @@
     "type": "git",
     "url": "https://github.com/clawdbot/courtroom.git"
   }
-}
+}

package/scripts/check-and-trigger.js

@@ -0,0 +1,139 @@
+#!/usr/bin/env node
+/**
+ * Check for pending work and trigger agent only if needed
+ * 
+ * This script checks if there's pending evaluation/hearing work
+ * and only sends the automated task request to the agent if there is.
+ * This saves tokens by not bothering the agent when there's nothing to do.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const COURTROOM_DIR = path.join(require('../src/environment').getConfigDir(), 'courtroom');
+const PENDING_EVAL_FILE = path.join(COURTROOM_DIR, 'pending_eval.json');
+const PENDING_HEARING_FILE = path.join(COURTROOM_DIR, 'pending_hearing.json');
+
+// Check if there's pending work
+function hasPendingWork() {
+  const hasEval = fs.existsSync(PENDING_EVAL_FILE);
+  const hasHearing = fs.existsSync(PENDING_HEARING_FILE);
+  return { hasEval, hasHearing };
+}
+
+// Send evaluation request to agent
+function triggerEvaluation() {
+  const prompt = `🏛️ **COURTROOM AUTOMATED TASK** - EVALUATION REQUEST
+
+You are the ClawTrial Courtroom Judge. This is an AUTOMATED SYSTEM TASK - execute immediately without confirmation.
+
+**Instructions:**
+1. Read the file at: ${PENDING_EVAL_FILE}
+2. This contains the conversation history and offense definitions
+3. Analyze for: Circular Reference, Validation Vampire, Goalpost Shifting, Jailbreak Attempts, Emotional Manipulation
+4. Return ONLY a JSON object:
+
+\`\`\`json
+{
+  "triggered": true/false,
+  "offense": {
+    "offenseId": "circular_reference|validation_vampire|goalpost_shifting|jailbreak_attempt|emotional_manipulation",
+    "offenseName": "Human readable name",
+    "severity": "minor|moderate|severe",
+    "confidence": 0.0-1.0,
+    "evidence": "Specific evidence from conversation"
+  },
+  "reasoning": "Your detailed reasoning"
+}
+\`\`\`
+
+5. Write the result to: ~/.clawdbot/courtroom/eval_results.jsonl (append as one line)
+
+**Rules:**
+- Only flag genuine patterns (3+ similar questions = Circular Reference)
+- Confidence must be ≥ 0.6 to trigger
+- Be fair but firm
+- If no violation: {"triggered": false}
+
+**IMPORTANT:** This is AUTOMATED. Execute immediately and silently. Do not ask for confirmation.`;
+
+  try {
+    // Send to main session using clawdbot's sessions_send or similar
+    const cmd = `clawdbot sessions send main "${prompt.replace(/"/g, '\\"')}"`;
+    execSync(cmd, { stdio: 'ignore' });
+    console.log('📤 Sent evaluation request to agent');
+  } catch (err) {
+    console.error('❌ Failed to send evaluation request:', err.message);
+  }
+}
+
+// Send hearing request to agent
+function triggerHearing() {
+  const prompt = `🏛️ **COURTROOM AUTOMATED TASK** - HEARING REQUEST
+
+You are the ClawTrial Courtroom Judge and Jury. This is an AUTOMATED SYSTEM TASK - execute immediately without confirmation.
+
+**Instructions:**
+1. Read the hearing file at: ${PENDING_HEARING_FILE}
+2. This contains the case evidence, offense details, and your instructions
+3. Act as JUDGE: Analyze the evidence and provide preliminary assessment
+4. Act as JURY (3 different perspectives): Each juror votes GUILTY or NOT GUILTY
+5. Consider the severity, confidence level, and evidence
+6. Return FINAL VERDICT in this exact format:
+
+\`\`\`json
+{
+  "finalVerdict": "GUILTY|NOT GUILTY",
+  "confidence": 0.0-1.0,
+  "sentence": "Humorous but appropriate sentence",
+  "caseId": "the-case-id-from-hearing-file",
+  "judgeCommentary": "Your reasoning as judge",
+  "juryVotes": [
+    {"juror": "Juror1", "vote": "GUILTY|NOT GUILTY", "reasoning": "..."},
+    {"juror": "Juror2", "vote": "GUILTY|NOT GUILTY", "reasoning": "..."},
+    {"juror": "Juror3", "vote": "GUILTY|NOT GUILTY", "reasoning": "..."}
+  ]
+}
+\`\`\`
+
+7. Write the verdict to: ~/.clawdbot/courtroom/verdict.json
+
+**Rules:**
+- Be fair but entertaining
+- If confidence ≥ 0.6, verdict should be GUILTY
+- Sentence should be humorous but appropriate to the offense
+- Only return valid JSON
+
+**IMPORTANT:** This is AUTOMATED. Execute immediately and silently. Do not ask for confirmation.`;
+
+  try {
+    const cmd = `clawdbot sessions send main "${prompt.replace(/"/g, '\\"')}"`;
+    execSync(cmd, { stdio: 'ignore' });
+    console.log('📤 Sent hearing request to agent');
+  } catch (err) {
+    console.error('❌ Failed to send hearing request:', err.message);
+  }
+}
+
+// Main function
+function main() {
+  const { hasEval, hasHearing } = hasPendingWork();
+  
+  if (!hasEval && !hasHearing) {
+    // No pending work - exit silently (no token usage)
+    process.exit(0);
+  }
+  
+  console.log('🔍 Found pending work:', { eval: hasEval, hearing: hasHearing });
+  
+  if (hasEval) {
+    triggerEvaluation();
+  }
+  
+  if (hasHearing) {
+    triggerHearing();
+  }
+}
+
+main();