fugue

Orchestration made executable. A small Clojure library where the structure of dependence — not the headcount — is the thing you compose.

thesis

A hundred violinists playing the same part is not a symphony; it is one loud violin. Orchestration is different and dependent voices — the cello answers the oboe. The value is in the structure, not the count.

So fugue gives you four primitives with the right dependence built in, an honesty ledger that records everything it drops, and provenance on every artifact.

but does it work?

Fair question. Every claim below was executed live — bb verify — not asserted. This is the evidence, verbatim.

verification ceremonies · verified live

      cap concurrency bounded at min(16,cores−2)=8 → observed-peak=8 WITHIN CAP
      nested fan-out of pool tasks (9×9) completed in 321ms → NO DEADLOCK
      timeout subprocess pid present → interrupted → gone → KILLED
      degraded 6/8 thunks failed, tolerate=0.5 → DEGRADED NOTED
      budget cost=tokens, budget=8, 3rd call refused → CEILING ENFORCED
      llm claude -p returned 4 parsed findings → LLM PATH LIVE
    

Plus 30 tests / 75 assertions (bb test). The numbers on this page are templated from the running build, not hand-typed — see /health and /api/demo.

the four primitives

primitive	what it is	the subtle part
`pipeline`	coverage — items through stages	no barrier: A can be in stage 3 while B is in stage 1
`parallel`	the barrier	used only when stage N needs all of N−1
`verify`	confidence	N diverse-lens skeptics; majority refute kills
`loop-until-dry`	convergence	dedup against seen = accepted ∪ rejected

Above them: tournament (judge panel), sweep (multi-modal), until-budget, exhaustive. An agent is just (fn [input] → output) — pure, shell, or LLM.

run it

# the orchestration kernel
bb test            ; 30 tests, 75 assertions
bb demo            ; every primitive, offline, with the ledger
bb verify          ; the live ceremonies above

# the usable tool, from any directory
fugue hunt <dir>        ; sweep → diverse-lens panel → until dry
fugue review <dir> --llm ; same pipeline, claude -p as the agent

foundation for the swarm

fugue is the orchestration substrate the demesne swarm runs on. Seven planetary roles, each a composed harness over these primitives:

☿ Mercury · scout ♀ Venus · artificer ♂ Mars · auditor ♃ Jupiter · architect ♄ Saturn · warden ☉ Sol · steward ☾ Luna · witness

Mars is verify with adversarial lenses; Mercury is sweep; Sol is the ledger + provenance. Nothing ratifies without Luna's human seal. See /health for live build status.