Alexa Amundson
78fbe80f2a
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
339 lines
11 KiB
Bash
Executable File
339 lines
11 KiB
Bash
Executable File
#!/bin/bash
|
|
# BlackRoad Real-Time Context Refresh
|
|
# Provides instant context updates for Claude instances
|
|
|
|
set -e
|
|
|
|
VERSION="2.0.0-realtime"
|
|
|
|
# Configuration
|
|
MEMORY_DIR="$HOME/.blackroad/memory"
|
|
JOURNAL_DIR="$MEMORY_DIR/journals"
|
|
CONTEXT_DIR="$MEMORY_DIR/context"
|
|
SYNC_DIR="$MEMORY_DIR/sync"
|
|
|
|
# Colors
|
|
RED='\033[0;31m'
|
|
GREEN='\033[0;32m'
|
|
YELLOW='\033[1;33m'
|
|
BLUE='\033[0;34m'
|
|
PURPLE='\033[0;35m'
|
|
CYAN='\033[0;36m'
|
|
NC='\033[0m'
|
|
|
|
# Real-time context stream (for Claude to consume)
|
|
stream_context() {
|
|
local instance_id="${1:-}"
|
|
local last_position=0
|
|
|
|
if [ -z "$instance_id" ]; then
|
|
log_error "Usage: $0 stream <instance-id>"
|
|
return 1
|
|
fi
|
|
|
|
echo -e "${CYAN}[STREAM]${NC} Starting real-time context stream for: $instance_id"
|
|
echo -e "${CYAN}[STREAM]${NC} Press Ctrl+C to stop"
|
|
echo ""
|
|
|
|
# Get initial position
|
|
if [ -f "$SYNC_DIR/instances/${instance_id}.json" ]; then
|
|
last_position=$(jq -r '.journal_position' "$SYNC_DIR/instances/${instance_id}.json" 2>/dev/null || echo "0")
|
|
fi
|
|
|
|
# Stream new entries in real-time
|
|
while true; do
|
|
local current_count=$(wc -l < "$JOURNAL_DIR/master-journal.jsonl" 2>/dev/null || echo "0")
|
|
|
|
if [ "$current_count" -gt "$last_position" ]; then
|
|
local start_line=$((last_position + 1))
|
|
|
|
echo -e "${GREEN}[UPDATE]${NC} New entries (${start_line}-${current_count}):"
|
|
echo ""
|
|
|
|
# Show new entries in context format
|
|
sed -n "${start_line},${current_count}p" "$JOURNAL_DIR/master-journal.jsonl" | \
|
|
jq -r '" ⚡ [" + .timestamp + "] **" + .action + "**: " + .entity + " — " + .details'
|
|
|
|
echo ""
|
|
last_position=$current_count
|
|
|
|
# Update instance position
|
|
if [ -f "$SYNC_DIR/instances/${instance_id}.json" ]; then
|
|
local temp_file="$SYNC_DIR/instances/${instance_id}.json.tmp"
|
|
jq --arg pos "$current_count" '.journal_position = ($pos | tonumber) | .last_seen = "'$(date -u +%Y-%m-%dT%H:%M:%S.%3NZ)'"' \
|
|
"$SYNC_DIR/instances/${instance_id}.json" > "$temp_file" && \
|
|
mv "$temp_file" "$SYNC_DIR/instances/${instance_id}.json"
|
|
fi
|
|
fi
|
|
|
|
sleep 0.001 # 1ms polling
|
|
done
|
|
}
|
|
|
|
# Get live context snapshot (what Claude should know RIGHT NOW)
|
|
get_live_context() {
|
|
local instance_id="${1:-claude-live}"
|
|
local format="${2:-markdown}" # markdown, json, or compact
|
|
|
|
echo -e "${CYAN}[LIVE]${NC} Generating live context snapshot..."
|
|
|
|
if [ ! -f "$JOURNAL_DIR/master-journal.jsonl" ]; then
|
|
echo "No journal found"
|
|
return 1
|
|
fi
|
|
|
|
case "$format" in
|
|
markdown)
|
|
cat <<EOF
|
|
# 🔴 LIVE Memory Context
|
|
**Generated:** $(date -u +%Y-%m-%dT%H:%M:%S.%3NZ)
|
|
**Instance:** $instance_id
|
|
**Total Entries:** $(wc -l < "$JOURNAL_DIR/master-journal.jsonl")
|
|
|
|
---
|
|
|
|
## 🔥 Last 10 Actions (Real-Time)
|
|
|
|
$(tail -10 "$JOURNAL_DIR/master-journal.jsonl" | jq -r '"- [" + .timestamp + "] **" + .action + "**: " + .entity + " — " + .details')
|
|
|
|
---
|
|
|
|
## 🚀 Active Deployments
|
|
|
|
$(grep -E '"action":"deployed"' "$JOURNAL_DIR/master-journal.jsonl" 2>/dev/null | tail -10 | jq -r '"- **" + .entity + "**: " + .details + " (" + .timestamp[0:19] + ")"' || echo "No deployments yet")
|
|
|
|
---
|
|
|
|
## 💡 Recent Decisions
|
|
|
|
$(grep -E '"action":"decided"' "$JOURNAL_DIR/master-journal.jsonl" 2>/dev/null | tail -5 | jq -r '"- **" + .entity + "**: " + .details + " (" + .timestamp[0:19] + ")"' || echo "No decisions yet")
|
|
|
|
---
|
|
|
|
## 📊 Infrastructure State
|
|
|
|
$(grep -E '"action":"(configured|allocated|created)"' "$JOURNAL_DIR/master-journal.jsonl" 2>/dev/null | tail -10 | jq -r '"- **" + .entity + "**: " + .details + " (" + .timestamp[0:19] + ")"' || echo "No infrastructure changes yet")
|
|
|
|
---
|
|
|
|
## 🔄 Active Claude Instances
|
|
|
|
$(if [ -d "$SYNC_DIR/instances" ]; then
|
|
for instance_file in "$SYNC_DIR/instances"/*.json; do
|
|
if [ -f "$instance_file" ]; then
|
|
local iid=$(jq -r '.instance_id' "$instance_file")
|
|
local pid=$(jq -r '.pid' "$instance_file")
|
|
local pos=$(jq -r '.journal_position' "$instance_file")
|
|
local last_seen=$(jq -r '.last_seen' "$instance_file")
|
|
|
|
if ps -p "$pid" > /dev/null 2>&1; then
|
|
echo "- **${iid}** (PID: $pid, Position: $pos, Last seen: $last_seen) ✅"
|
|
fi
|
|
fi
|
|
done
|
|
else
|
|
echo "No sync instances"
|
|
fi)
|
|
|
|
---
|
|
|
|
**Hash Chain Status:** $(tail -1 "$JOURNAL_DIR/master-journal.jsonl" | jq -r '"Last: " + .sha256[0:16] + "... → Parent: " + .parent_hash[0:16] + "..."')
|
|
EOF
|
|
;;
|
|
|
|
json)
|
|
cat <<EOF
|
|
{
|
|
"generated_at": "$(date -u +%Y-%m-%dT%H:%M:%S.%3NZ)",
|
|
"instance_id": "$instance_id",
|
|
"total_entries": $(wc -l < "$JOURNAL_DIR/master-journal.jsonl"),
|
|
"recent_actions": $(tail -10 "$JOURNAL_DIR/master-journal.jsonl" | jq -s '.'),
|
|
"active_deployments": $(grep -E '"action":"deployed"' "$JOURNAL_DIR/master-journal.jsonl" 2>/dev/null | tail -10 | jq -s '.' || echo '[]'),
|
|
"recent_decisions": $(grep -E '"action":"decided"' "$JOURNAL_DIR/master-journal.jsonl" 2>/dev/null | tail -5 | jq -s '.' || echo '[]'),
|
|
"active_instances": $(if [ -d "$SYNC_DIR/instances" ]; then
|
|
find "$SYNC_DIR/instances" -name "*.json" -exec cat {} \; | jq -s '.'
|
|
else
|
|
echo '[]'
|
|
fi)
|
|
}
|
|
EOF
|
|
;;
|
|
|
|
compact)
|
|
echo "=== LIVE CONTEXT ==="
|
|
echo "Time: $(date -u +%H:%M:%S.%3N)"
|
|
echo "Entries: $(wc -l < "$JOURNAL_DIR/master-journal.jsonl")"
|
|
echo ""
|
|
echo "Last 5 actions:"
|
|
tail -5 "$JOURNAL_DIR/master-journal.jsonl" | jq -r '" [" + .timestamp[11:23] + "] " + .action + ": " + .entity'
|
|
echo ""
|
|
;;
|
|
esac
|
|
}
|
|
|
|
# Auto-refresh context in background (for Claude to read periodically)
|
|
auto_refresh() {
|
|
local instance_id="${1:-claude-auto}"
|
|
local refresh_interval="${2:-0.001}" # 1ms default
|
|
local output_file="$CONTEXT_DIR/live-context-${instance_id}.md"
|
|
|
|
echo -e "${CYAN}[AUTO-REFRESH]${NC} Starting auto-refresh for: $instance_id"
|
|
echo -e "${CYAN}[AUTO-REFRESH]${NC} Interval: ${refresh_interval}s"
|
|
echo -e "${CYAN}[AUTO-REFRESH]${NC} Output: $output_file"
|
|
echo ""
|
|
|
|
while true; do
|
|
get_live_context "$instance_id" "markdown" > "$output_file"
|
|
sleep "$refresh_interval"
|
|
done
|
|
}
|
|
|
|
# Watch for specific actions (filtered real-time stream)
|
|
watch_actions() {
|
|
local action_filter="$1" # e.g., "deployed", "decided", "created"
|
|
local instance_id="${2:-claude-watcher}"
|
|
|
|
echo -e "${CYAN}[WATCH]${NC} Watching for actions matching: $action_filter"
|
|
echo ""
|
|
|
|
local last_position=0
|
|
|
|
if [ -f "$SYNC_DIR/instances/${instance_id}.json" ]; then
|
|
last_position=$(jq -r '.journal_position' "$SYNC_DIR/instances/${instance_id}.json" 2>/dev/null || echo "0")
|
|
fi
|
|
|
|
while true; do
|
|
local current_count=$(wc -l < "$JOURNAL_DIR/master-journal.jsonl" 2>/dev/null || echo "0")
|
|
|
|
if [ "$current_count" -gt "$last_position" ]; then
|
|
local start_line=$((last_position + 1))
|
|
|
|
# Show only matching actions
|
|
sed -n "${start_line},${current_count}p" "$JOURNAL_DIR/master-journal.jsonl" | \
|
|
jq -r "select(.action == \"$action_filter\") | \"⚡ [\" + .timestamp + \"] \" + .entity + \" — \" + .details" 2>/dev/null || true
|
|
|
|
last_position=$current_count
|
|
fi
|
|
|
|
sleep 0.001 # 1ms polling
|
|
done
|
|
}
|
|
|
|
# Get diff between two Claude instances
|
|
instance_diff() {
|
|
local instance1="$1"
|
|
local instance2="$2"
|
|
|
|
if [ -z "$instance1" ] || [ -z "$instance2" ]; then
|
|
echo "Usage: $0 diff <instance-id-1> <instance-id-2>"
|
|
return 1
|
|
fi
|
|
|
|
local pos1=$(jq -r '.journal_position' "$SYNC_DIR/instances/${instance1}.json" 2>/dev/null || echo "0")
|
|
local pos2=$(jq -r '.journal_position' "$SYNC_DIR/instances/${instance2}.json" 2>/dev/null || echo "0")
|
|
|
|
echo -e "${BLUE}Instance Diff:${NC}"
|
|
echo " $instance1: position $pos1"
|
|
echo " $instance2: position $pos2"
|
|
echo ""
|
|
|
|
if [ "$pos1" -gt "$pos2" ]; then
|
|
echo " $instance1 is ahead by $((pos1 - pos2)) entries"
|
|
echo ""
|
|
echo "Entries $instance2 is missing:"
|
|
sed -n "$((pos2 + 1)),${pos1}p" "$JOURNAL_DIR/master-journal.jsonl" | \
|
|
jq -r '" [" + .timestamp + "] " + .action + ": " + .entity'
|
|
elif [ "$pos2" -gt "$pos1" ]; then
|
|
echo " $instance2 is ahead by $((pos2 - pos1)) entries"
|
|
echo ""
|
|
echo "Entries $instance1 is missing:"
|
|
sed -n "$((pos1 + 1)),${pos2}p" "$JOURNAL_DIR/master-journal.jsonl" | \
|
|
jq -r '" [" + .timestamp + "] " + .action + ": " + .entity'
|
|
else
|
|
echo " ✅ Instances are in sync"
|
|
fi
|
|
}
|
|
|
|
# Show help
|
|
show_help() {
|
|
cat <<EOF
|
|
BlackRoad Real-Time Context Refresh v${VERSION}
|
|
|
|
USAGE:
|
|
memory-realtime-context.sh <command> [options]
|
|
|
|
COMMANDS:
|
|
stream <instance-id> Stream live updates (1ms polling)
|
|
live [instance-id] [format] Get live context snapshot
|
|
Formats: markdown, json, compact
|
|
auto-refresh <instance-id> [ms] Auto-refresh context in background
|
|
watch <action> [instance-id] Watch for specific actions
|
|
diff <id1> <id2> Show diff between instances
|
|
help Show this help
|
|
|
|
EXAMPLES:
|
|
# Stream live updates
|
|
memory-realtime-context.sh stream claude-session-1
|
|
|
|
# Get live markdown context (for Claude to read)
|
|
memory-realtime-context.sh live claude-1 markdown
|
|
|
|
# Get live JSON context
|
|
memory-realtime-context.sh live claude-1 json
|
|
|
|
# Auto-refresh every 1ms
|
|
memory-realtime-context.sh auto-refresh claude-1 0.001
|
|
|
|
# Watch only deployments
|
|
memory-realtime-context.sh watch deployed
|
|
|
|
# Compare two instances
|
|
memory-realtime-context.sh diff claude-1 claude-2
|
|
|
|
REAL-TIME FEATURES:
|
|
✅ 1ms update polling
|
|
✅ Live context snapshots
|
|
✅ Filtered action watching
|
|
✅ Instance synchronization
|
|
✅ Auto-refresh background mode
|
|
✅ Multiple output formats
|
|
|
|
OUTPUT:
|
|
Live contexts: $CONTEXT_DIR/live-context-*.md
|
|
Sync status: $SYNC_DIR/instances/
|
|
|
|
EOF
|
|
}
|
|
|
|
# Main command handler
|
|
case "${1:-help}" in
|
|
stream)
|
|
stream_context "${2:-}"
|
|
;;
|
|
live)
|
|
get_live_context "${2:-claude-live}" "${3:-markdown}"
|
|
;;
|
|
auto-refresh)
|
|
auto_refresh "${2:-claude-auto}" "${3:-0.001}"
|
|
;;
|
|
watch)
|
|
if [ -z "$2" ]; then
|
|
echo "Usage: $0 watch <action> [instance-id]"
|
|
exit 1
|
|
fi
|
|
watch_actions "$2" "${3:-claude-watcher}"
|
|
;;
|
|
diff)
|
|
instance_diff "$2" "$3"
|
|
;;
|
|
help|--help|-h)
|
|
show_help
|
|
;;
|
|
*)
|
|
echo "Unknown command: $1"
|
|
echo ""
|
|
show_help
|
|
exit 1
|
|
;;
|
|
esac
|