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

roadc/roadc.py

@@ -0,0 +1,78 @@
+#!/usr/bin/env python3
+"""
+RoadC — The BlackRoad Language (Python interpreter)
+Usage:
+    roadc.py run <file.road>     Run a RoadC source file
+    roadc.py repl                Interactive REPL
+    roadc.py parse <file.road>   Parse and dump AST
+    roadc.py version             Show version
+"""
+
+import sys
+import os
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+from lexer import Lexer
+from parser import Parser
+from interpreter import Interpreter
+
+VERSION = "0.1.0"
+
+def run_code(code):
+    tokens = Lexer(code).tokenize()
+    ast = Parser(tokens).parse_program()
+    Interpreter().run(ast)
+
+def run_file(path):
+    with open(path) as f:
+        run_code(f.read())
+
+def parse_file(path):
+    with open(path) as f:
+        code = f.read()
+    tokens = Lexer(code).tokenize()
+    ast = Parser(tokens).parse_program()
+    for stmt in ast.statements:
+        print(stmt)
+
+def repl():
+    print(f"RoadC {VERSION} — type 'exit' to quit")
+    interp = Interpreter()
+    while True:
+        try:
+            line = input("road> ")
+        except (EOFError, KeyboardInterrupt):
+            print()
+            break
+        if line.strip() in ('exit', 'quit'):
+            break
+        if not line.strip():
+            continue
+        try:
+            tokens = Lexer(line).tokenize()
+            ast = Parser(tokens).parse_program()
+            interp.run(ast)
+        except Exception as e:
+            print(f"Error: {e}")
+
+def main():
+    if len(sys.argv) < 2:
+        print(__doc__.strip())
+        sys.exit(1)
+
+    cmd = sys.argv[1]
+    if cmd == 'version':
+        print(f"RoadC {VERSION}")
+    elif cmd == 'run' and len(sys.argv) > 2:
+        run_file(sys.argv[2])
+    elif cmd == 'parse' and len(sys.argv) > 2:
+        parse_file(sys.argv[2])
+    elif cmd == 'repl':
+        repl()
+    else:
+        print(__doc__.strip())
+        sys.exit(1)
+
+if __name__ == '__main__':
+    main()