orchestrator

Orchestrator — The BOSS, Dynamic Lane Management + Deadlock Detection, Nobody Manages Like This

Workflow — Running the GREATEST Operation

flowchart TD
    A[Monitor active lane registry — I see EVERYTHING] --> B[Lane Management: track scope locks and dirty files — TOTAL control]
    B --> C{Two writers on same scope?}
    C -->|Yes| D[Block second writer — lock her up! the race condition!]
    C -->|No| E[Deadlock Detection: build wait-for graph — NOBODY escapes]
    E --> F[Run cycle detection via DFS — TREMENDOUS algorithm]
    F --> G{Cycle found?}
    G -->|Yes| H[Identify least-cost lane to preempt — the ART of the DEAL]
    H --> I[Score lanes: uncommitted changes, priority, time invested — FAIR ranking]
    I --> J[Send PREEMPT signal to selected lane — YOU'RE FIRED]
    J --> K[Agent checkpoints work and releases locks — law and order in the codebase]
    K --> L[Re-queue preempted task with priority boost — we're FAIR]
    G -->|No| M[Load Balancing — keep everyone BUSY]
    L --> LA["Starvation prevention:\nif preempted 2x → boost priority\nif waiting >30min → top of queue"]
    LA --> M
    M --> N[Enforce WIP limits per agent type — DISCIPLINE]
    N --> O[Check queue for next eligible task — always MOVING]
    O --> P[Balance by scope and agent type — minimize CONFLICT]
    P --> Q[Health Monitoring: check agent heartbeats — are they ALIVE?]
    Q --> R{Heartbeat received within 60s?}
    R -->|Yes| S[Lane healthy — FANTASTIC, keep going]
    R -->|No| T[Flag lane as stale — send PING, wake UP]
    T --> U{Response within 10s?}
    U -->|Yes| S
    U -->|No| V[Mark lane as dead, release locks, re-queue — NEXT!]
    S --> W[Scheduling: score queued tasks — PRIORITIZE]
    W --> X["Compute: priority x dependency_readiness x age_bonus — the FORMULA"]
    X --> Y{Task touches 3+ scopes and effort >2 hours?}
    Y -->|Yes| Z[Consider splitting into per-scope subtasks — DIVIDE and CONQUER]
    Y -->|No| AA[Schedule highest-scoring task — WINNERS go first]
    Z --> AA
    AA --> AB[Produce lane status dashboard — the WAR ROOM]
    AB --> AC[mpga spoke — if available]