hub

Hub

One session that looks across the projects Orca knows: which orchestrators exist, which are alive, a read-only answer from a stopped one, or waking one in a visible Orca terminal when the work needs a human at its gates. An Orca addon: it runs only with LETS_LAUNCHER=orca.

IMPORTANT: If the spec below invokes any deferred tool (e.g. AskUserQuestion), you MUST load and call it as specified. Never skip the call, never substitute a default answer of your own — the tool invocation is part of the contract. This is critical.

Step 1: Preflight (before any lets call)

[ "{LETS_LAUNCHER}" = "orca" ] || echo HUB_NEEDS_ORCA

HUB_NEEDS_ORCA -> print one line /lets:hub is an Orca addon - pick the Orca launcher in /lets:init (LETS_LAUNCHER=orca) and stop. Otherwise:

lets orca status --json

Not running (status.running=false or a reason) -> orca_unavailable plus the reason; stop.

Step 2: List

lets peers who --orca-repos --json

Go validates every repo Orca lists and tags each row with repo_index; later calls pass --repo-index <n>, never a path. A project's orchestrators are the names recorded in its merge-branch task-state, and only when none of them is live the <repo>-orc[-<scope>] convention. Render one row per orchestrator - live ones from peers[], stopped ones from last_orchestrators[]:

| project (repos[index].name) | orchestrator | scope | alive | last seen |

Name every degraded[] entry in one line each. A project with several orchestrators lists each.

Step 3: Route the request

Pick the target: the orchestrator the user named; else, when the project has several:

AskUserQuestion(
  questions=[{
    question: "Which orchestrator of {project}?",
    header: "Orchestrator",
    options: [ /* up to 3: label = name, description = "{scope} - {alive | stopped}" */ ],
    multiSelect: false
  }]
)

Classify the request, and when unsure treat it as gated. Every message to a live orchestrator goes by its NAME from this run's listing, with via=hub: the orc skill sends outside the hub's own repo only to a row this hub run printed. A row marked duplicate_name cannot be addressed by name - say so and stop for it.