# Bridge Phase B slice 1 — cascade orchestrator — 2026-09-15

**Lane:** id 9 (vibecoder-standalone-mavis)
**Commit:** 4c10cf3 b3041

## What ships

`bridge/lib/cascade-orchestrator.cjs` was a SCAFFOLD (threw "not yet implemented").
It now re-exports the canonical wrapper's public API:

```js
const cascade = require('../../vibe-agents/execute-cascade.cjs');
const providerRegistry = require('../../config/provider-registry.cjs');

module.exports = {
  executeCascade,                    // from wrapper
  callTier,                          // from wrapper
  providerRegistry: {                // from config/provider-registry.cjs
    REGISTRY,
    getRowByModel,
    getRowByLabel,
    getRowsForAccount,
    getStagger,
  },
};
```

Constraint honoured: the wrapper (`vibe-agents/execute-cascade.cjs`) is unchanged.
server.cjs is unchanged.

## Spec delta

The dispatch (Phase 2a) expected the orchestrator to re-export `{ executeCascade, getEndpoint, providerRegistry }`. The wrapper only exports `{ executeCascade, callTier }`. `getEndpoint` is private to the wrapper and the dispatch constraint says do NOT modify the wrapper — so `getEndpoint` is intentionally NOT re-exported. `providerRegistry` lives at `config/provider-registry.cjs` (canonical), so the orchestrator re-exports the helpers from there.

If a future caller needs `getEndpoint`, the cleanest path is a public function in this orchestrator file that consults `provider-registry.getRowByModel` and re-runs env-var resolution (mirrors the wrapper's private logic). Defer to a future slice if/when needed.

## Smoke results on VPS

| Probe | Endpoint | HTTP | Notes |
|---|---|---|---|
| Modular bridge startup | `BRIDGE_IMPL=modular PORT=3004 node bridge/main.cjs` | OK | `[bridge:modular] listening on http://127.0.0.1:3004` |
| Modular bridge: search | `GET /api/agent/index/search?q=Canvas&limit=2` (3004) | **200** | 2 hits, score 115 — proves route + orchestrator load correctly |
| Modular bridge: chat | `POST /api/agent/ai/chat` (3004) | **501** | Expected — `chat-handler.cjs` is the next slice (Phase B slice 2), still stubbed |
| Orchestrator unit test | `node -e "require('./bridge/lib/cascade-orchestrator.cjs')"` | OK | executeCascade=function, callTier=function, providerRegistry={REGISTRY, getRowByModel, getRowByLabel, getRowsForAccount, getStagger} |
| Modular bridge cleanup | `pkill -f bridge/main.cjs` | OK | No more `bridge/main.cjs` processes |
| Monolith post-deploy | `GET /api/agent/index/search?q=Canvas` (3003) | **200** | Unchanged behaviour, 18,935 entities |

## What this slice did NOT do (per dispatch acknowledgement)

chat.cjs NOT modified. It still imports `handleChat` from `bridge/lib/chat-handler.cjs` (which is still a stub throwing "not yet implemented"). When `chat-handler.cjs` is extracted from server.cjs in the next slice, it will use the now-real orchestrator. That's Phase B slice 2.

The dispatch's "Update bridge/routes/chat.cjs to import from bridge/lib/cascade-orchestrator.cjs instead of stubbing" — chat.cjs doesn't import from the orchestrator directly (it's chat-handler's internal dependency). The chat route's stub status hasn't changed because the orchestrator is chat-handler's concern, not the route's.

## Constraint compliance

- [x] Do NOT modify server.cjs — untouched (verified with `git diff 5f547b6 HEAD -- server.cjs` = empty)
- [x] Do NOT modify the wrapper — `vibe-agents/execute-cascade.cjs` untouched (verified)
- [x] Modular bridge started successfully on 3004
- [x] Capture error: chat test 501 expected and documented (chat-handler still stubbed)
- [x] Did not retry any failed step
- [x] Monolith on 3003 restarted cleanly on the new HEAD (PID 1370942, started 20:15:40 UTC)

## VPS state

| Anchor | Value |
|---|---|
| /opt/vibecoder-bridge HEAD | 4c10cf3 (matches local + origin/main) |
| Monolith PID | 1370942 (server.cjs) |
| Monolith uptime | since 20:15:40 UTC |
| Modular bridge | not running (cleaned up after smoke test) |
| deploy-gate | PASS |
| fv-gallery pull | PASS |

## Self-build prereq tally

| # | Prerequisite | Status |
|---|---|---|
| 1 | VibeCoder works end-to-end | ✅ |
| 2 | POST /api/agent/clone | ✅ |
| 3 | POST /api/agent/push | ✅ |
| 4 | Retrieval index + /api/agent/index/search | ✅ |
| 5 | Multi-repo indexing + ?repo= | ✅ |
| 6 | Bridge Phase A scaffold | ✅ (PROMPT #15) |
| **7** | **Bridge Phase B slice 1 — cascade orchestrator** | ✅ **THIS DISPATCH** |
| 8 | Bridge Phase B slice 2 — chat-handler extraction | pending |
| 9 | Bridge Phase B slice 3 — 175 route migrations | pending |