Add orchestrator docs + state machine diagram to README.md

[albertywu]

Summary

Add orchestrator docs + state machine diagram to README.md

stateDiagram-v2
    [*] --> start: land request (from gateway)

    start --> validate: request persisted, URIs claimed
    validate --> batch: validated (not duplicate, mergeable)
    batch --> score: grouped into batch
    score --> speculate: batch scored

    speculate --> build: start speculation
    build --> buildsignal: build triggered
    buildsignal --> speculate: build result received

    speculate --> merge: dependencies succeeded
    merge --> speculate: re-plan dependents

    merge --> conclude: merged (success or conflict)
    speculate --> conclude: dependency failed / self-heal

    conclude --> [*]: request Landed / Error

    start --> log: audit event (async)
    score --> log: audit event (async)
    log --> [*]

Loading

[Copilot]

Pull request overview

Adds a Mermaid state machine diagram and accompanying notes to the orchestrator README, documenting the pipeline of queues and how stages publish to one another.

Changes:

• Replaces a single-line README with a structured document describing the orchestrator pipeline.
• Adds a Mermaid stateDiagram-v2 showing transitions across start, validate, batch, score, speculate, build, buildsignal, merge, conclude, and log.
• Adds notes explaining feedback loops, self-healing, and the async log sink.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[behinddwalls]

I believe this is captured in docs/workflow.md file

[albertywu]

I believe this is captured in docs/workflow.md file

ACK, will close this one out.