move repos into monorepo

bin/supervisor/examples/osiris_openrpc/README.md

@@ -0,0 +1,102 @@
+# OSIRIS + OpenRPC Comprehensive Example
+
+This example demonstrates the complete workflow of using Hero Supervisor with OSIRIS runners via OpenRPC.
+
+## What This Example Does
+
+1. **Builds and starts** Hero Supervisor with OpenRPC server enabled
+2. **Builds** the OSIRIS runner binary
+3. **Connects** an OpenRPC client to the supervisor
+4. **Registers and starts** an OSIRIS runner
+5. **Dispatches multiple jobs** via OpenRPC:
+   - Create a Note
+   - Create an Event
+   - Query stored data
+   - Test access control (expected to fail)
+6. **Monitors** job execution and results
+7. **Gracefully shuts down** all components
+
+## Prerequisites
+
+**IMPORTANT: Redis must be running before starting this example!**
+
+```bash
+# Start Redis (if not already running)
+redis-server
+```
+
+Other requirements:
+- Redis server running on `localhost:6379`
+- Rust toolchain installed
+- Both `supervisor` and `runner_rust` crates available
+
+## Running the Example
+
+```bash
+cargo run --example osiris_openrpc
+```
+
+## Job Scripts
+
+The example uses separate Rhai script files for each job:
+
+- `note.rhai` - Creates and stores a Note object
+- `event.rhai` - Creates and stores an Event object
+- `query.rhai` - Queries and retrieves stored objects
+- `access_denied.rhai` - Tests access control (should fail)
+
+## Architecture
+
+```
+┌─────────────────┐
+│   This Example  │
+│   (OpenRPC      │
+│    Client)      │
+└────────┬────────┘
+         │ JSON-RPC
+         ↓
+┌─────────────────┐
+│   Supervisor    │
+│  (OpenRPC       │
+│   Server)       │
+└────────┬────────┘
+         │ Redis Queue
+         ↓
+┌─────────────────┐
+│ OSIRIS Runner   │
+│  (Rhai Engine   │
+│   + HeroDB)     │
+└─────────────────┘
+```
+
+## Key Features Demonstrated
+
+- **Automatic binary building** using escargot
+- **OpenRPC communication** between client and supervisor
+- **Runner registration** with configuration
+- **Job dispatching** with signatories
+- **Context-based access control** in OSIRIS
+- **Typed object storage** (Note, Event)
+- **Graceful shutdown** and cleanup
+
+## Expected Output
+
+The example will:
+1. ✅ Create a Note successfully
+2. ✅ Create an Event successfully
+3. ✅ Query and retrieve stored objects
+4. ✅ Deny access for unauthorized participants
+5. ✅ Clean up all resources
+
+## Troubleshooting
+
+**Redis Connection Error:**
+- Ensure Redis is running: `redis-server`
+
+**Build Errors:**
+- Ensure both supervisor and runner_rust crates are available
+- Check that all dependencies are up to date
+
+**OpenRPC Connection Error:**
+- Port 3030 might be in use
+- Check supervisor logs for startup issues