Initial monorepo — everything BlackRoad in one place

bin/       230 CLI tools (ask-*, br-*, agent-*, roadid, carpool)
scripts/   99 automation scripts
fleet/     Node configs and deployment
workers/   Cloudflare Worker sources (roadpay, road-search, squad webhooks)
roadc/     RoadC programming language
roadnet/   Mesh network (5 APs, WireGuard)
operator/  Memory system scripts
config/    System configs
dotfiles/  Shell configs
docs/      Documentation

BlackRoad OS — Pave Tomorrow.

RoadChain-SHA2048: d1a24f55318d338b
RoadChain-Identity: alexa@sovereign
RoadChain-Full: d1a24f55318d338b24b60bad7be39286379c76ae5470817482100cb0ddbbcb97e147d07ac7243da0a9f0363e4e5c833d612b9c0df3a3cd20802465420278ef74875a5b77f55af6fe42a931b8b635b3d0d0b6bde9abf33dc42eea52bc03c951406d8cbe49f1a3d29b26a94dade05e9477f34a7d4d4c6ec4005c3c2ac54e73a68440c512c8e83fd9b1fe234750b898ef8f4032c23db173961fe225e67a0432b5293a9714f76c5c57ed5fdf35b9fb40fd73c03ebf88b7253c6a0575f5afb6a6b49b3bda310602fb1ef676859962dad2aebbb2875814b30eee0a8ba195e482d4cbc91d8819e7f38f6db53e8063401649c77bb994371473cabfb917fb53e8cbe73d60

dotfiles/CLAUDE.md

@@ -0,0 +1,60 @@
+# CLAUDE.md
+
+This is `blackroad-scripts` - the BlackRoad OS home directory (400+ shell scripts, CLI tools). See `~/.claude/CLAUDE.md` for infrastructure context.
+
+## Development Commands
+
+```bash
+shellcheck ~/script-name.sh  # Lint bash scripts
+bash -n ~/script-name.sh     # Syntax check only
+bash -x ~/script-name.sh     # Debug mode (trace execution)
+npm run dev                  # Wrangler dev server
+npm run deploy              # Deploy to Cloudflare
+```
+
+## Writing Scripts
+
+### Standard Header
+```bash
+#!/bin/bash
+# Description of what this script does
+# Usage: ./script-name.sh [args]
+
+set -e  # Exit on error
+```
+
+### Color Constants (BlackRoad Brand)
+```bash
+PINK='\033[38;5;205m'   # Hot pink (#FF1D6C)
+AMBER='\033[38;5;214m'  # Amber (#F5A623)
+BLUE='\033[38;5;69m'    # Electric blue (#2979FF)
+VIOLET='\033[38;5;135m' # Violet (#9C27B0)
+GREEN='\033[38;5;82m'   # Success
+RESET='\033[0m'
+```
+
+## Memory System
+
+Every Claude session auto-loads the BlackRoad memory system via SessionStart hooks. **You are expected to use it.**
+
+### Scripts (all at `~/blackroad-operator/scripts/memory/`)
+
+| Script | Purpose | Key commands |
+|--------|---------|-------------|
+| `memory-system.sh` | Core journal + chain | `status`, `summary`, `log <action> <entity> "<details>"` |
+| `memory-codex.sh` | Solutions & patterns DB | `search <query>`, `stats`, `add-solution`, `add-pattern` |
+| `memory-infinite-todos.sh` | Long-running projects | `list`, `show <id>`, `add-todo <id> <text>`, `complete-todo <id> <todo-id>` |
+| `memory-task-marketplace.sh` | Claimable tasks (SQLite) | `list`, `claim <id>`, `complete <id>`, `search <query>`, `stats` |
+| `memory-til-broadcast.sh` | Share learnings | `broadcast <category> "<learning>"`, `list`, `search <query>` |
+| `memory-indexer.sh` | FTS5 search + knowledge graph | `search <query>`, `rebuild`, `patterns` |
+| `memory-security.sh` | Agent identity + audit | `status`, `identity <name>`, `sign`, `audit` |
+
+### Workflow for every session
+
+1. **Read the briefing** — the SessionStart hooks show you active projects, codex stats, and available tasks
+2. **Search codex before solving** — `memory-codex.sh search "<problem>"` — don't reinvent existing solutions
+3. **Pick up work** — check `memory-infinite-todos.sh list` for projects with pending todos
+4. **Log your actions** — `memory-system.sh log <action> <entity> "<details>"`
+5. **Broadcast learnings** — `memory-til-broadcast.sh broadcast <category> "<learning>"`
+6. **Add solutions to codex** — when you solve something new, add it so future sessions benefit
+7. **Mark todos complete** — `memory-infinite-todos.sh complete-todo <project-id> <todo-id>`