readme

Makefile

@@ -35,7 +35,7 @@ egress-logs:
 
 # --- Dev servers (one per service, run in separate terminals) ---
 dev-orchestrator:
-	cd orchestrator && uv run uvicorn main:app --reload --port 8010
+	cd orchestrator && uv run uvicorn main:app --reload --port 8000
 
 dev-gateway:
 	cd sandbox-gateway && cargo run

README.md

@@ -19,7 +19,7 @@ all visible and steerable from a web UI.
 ```bash
 cp infra/.env.example infra/.env      # once
 make init                             # boot databases + sandbox egress (docker compose up -d)
-make dev-orchestrator                 # terminal 1 — API + agent brain (http://localhost:8010)
+make dev-orchestrator                 # terminal 1 — API + agent brain (http://localhost:8000)
 make dev-gateway                      # terminal 2 — Rust gateway
 make dev-fleet                        # terminal 3 — fleet manager
 make dev-frontend                     # terminal 4 — UI

docs/step-0-pre-flight.md

@@ -28,29 +28,29 @@ Port 8000 is already occupied by the user's other project ("Clario Backend" resp
   ```
 - After:
   ```
-  cd orchestrator && uv run uvicorn main:app --reload --port 8010
+  cd orchestrator && uv run uvicorn main:app --reload --port 8000
   ```
 
 ## Documentation sync
 
 ### File: `README.md`, line 22
 - Before: `make dev-orchestrator  # terminal 1 — API + agent brain (http://localhost:8000)`
-- After: `make dev-orchestrator  # terminal 1 — API + agent brain (http://localhost:8010)`
+- After: `make dev-orchestrator  # terminal 1 — API + agent brain (http://localhost:8000)`
 
 ## Port map (now consistent everywhere)
 
 | Service | Port | Command |
 |---|---|---|
-| orchestrator | 8010 | `make dev-orchestrator` |
+| orchestrator | 8000 | `make dev-orchestrator` |
 | sandbox-gateway | 8080 | `make dev-gateway` |
 | sandbox-fleet | 8011 | `make dev-fleet` |
 | frontend (bun) | 3000 | `make dev-frontend` |
 
 ## Verification (real output, 9 Aug 2026)
 
-Orchestrator on 8010:
+Orchestrator on 8000:
 ```
-Uvicorn running on http://127.0.0.1:8010
+Uvicorn running on http://127.0.0.1:8000
 GET /health 200 OK -> {"status":"ok","service":"orchestrator"}
 ```
 

docs/step-1-litellm.md

@@ -46,11 +46,11 @@ Note: `openrouter/free` is OpenRouter's auto-router - it picks any currently-fre
 
 ```
 cd ~/Desktop/devin-clone/orchestrator
-uv run uvicorn main:app --reload --port 8010
-curl http://127.0.0.1:8010/llm/ping
+uv run uvicorn main:app --reload --port 8000
+curl http://127.0.0.1:8000/llm/ping
 ```
 
 ## Next steps
-- Fix `make dev-fleet` and orchestrator port 8000 -> 8010 (Clario owns 8000)
+- Fix `make dev-fleet` (broken FastAPI start → uvicorn)
 - Day 1 sandbox v0: Rust gateway `POST /exec` + Docker container with egress allowlist
 - Benchmark `cohere/north-mini-code:free` vs `openai/gpt-oss-20b:free` and pin the winner in `.env`

docs/step3-e2e.md

@@ -6,7 +6,7 @@ The first real agent action: the orchestrator (the "brain") sends a command thro
 
 ```
 curl /sandbox/ls
-  -> orchestrator (FastAPI :8010)  sandbox.py -> httpx POST
+  -> orchestrator (FastAPI :8000)  sandbox.py -> httpx POST
   -> sandbox-gateway (Rust :8080)  /exec handler -> docker run
   -> sandbox-net (--internal network)
   -> python:3.12-slim container   sh -lc "ls -la /"
@@ -47,7 +47,7 @@ curl /sandbox/ls
 ## Proof (real output, 9 Aug 2026)
 
 ```
-$ curl http://127.0.0.1:8010/sandbox/ls
+$ curl http://127.0.0.1:8000/sandbox/ls
 {"exit_code":0,"stdout":"total 56\ndrwxr-xr-x   1 root root 4096 Aug  9 16:55 .\n...
 drwxr-xr-x   1 root root 4096 Aug  3 00:00 usr\ndrwxr-xr-x   1 root root 4096 Aug  3 00:00 var\n",
  "stderr":"","timed_out":false,"duration_ms":494}

docs/steps.txt

@@ -1,7 +1,11 @@
+Day 1:
+
 hen I execute Day 1 (after you approve this plan)
 Wire LLM — add LiteLLM to orchestrator, load infra/.env, make a real call to openrouter/free with your key to prove the loop works
-Fix 2 pre-flight bugs — make dev-fleet (broken FastAPI start → uvicorn) and orchestrator port 8000 → 8010 (Clario owns 8000)
+Fix 2 pre-flight bugs — make dev-fleet (broken FastAPI start → uvicorn) and orchestrator port 8010 → 8000 
 Build sandbox v0 — Rust gateway POST /exec → runs command in Docker container with egress allowlist (only npm/pip/GitHub reachable — the Ch 12 golden rule)
 End-to-end test — orchestrator → gateway → container → ls output comes back to you (first real agent action!)
 Benchmark + pin — test cohere/north-mini-code:free vs gpt-oss-20b:free on a coding task, pin the winner in .env
 Commit + push — per your standing rule, I report each change (what → which file → what it brings) and push to main
+
+