Clearing Primitives

Route

The decision that binds Work to a Worker, carrying the explanation of who was eligible, how they scored, and why the winner won.

A Route is the decision that binds Work to a WorkerRoute (Decision) joined with its Explanation. It is not just an assignment; it is an explained assignment. Every route records who was eligible, how each candidate scored, and why the winner won, so a routing decision can be read back and defended long after it was made.

A strategy produces the ranking. Ductor ships more than twenty — weighted round-robin, least-loaded, geographic, SLA-deadline, yield-optimized, and learning strategies (Thompson-sampling and LinUCB bandits) that route toward workers who historically convert. Strategies are versioned and hot-swappable, and a candidate can run in shadow against production traffic to reveal exactly where its decisions would diverge before it is trusted.

Status
shipping — decisions, explanations, strategies, and shadow campaigns exist today; market-cleared routes carry the winner's worker identity and clearing price in exact micro-units.

Outcomes

A route resolves to a DecisionOutcome:

DecisionOutcome
assigned

Work is bound to a worker.

DecisionOutcome
queued · queued_for_claim

Held for a worker to pull, in claim-based pools.

DecisionOutcome
no_eligible_recipients

No worker was eligible under the pool's rules.

DecisionOutcome
dropped · rejected · error

A visible terminal state — never a silent disappearance.

Where to go deeper