Get started

Fallback chains

Source

What may serve a lane when the model a decision named cannot.

The question a chain has to answer

A fallback is the first thing this register holds that serves production traffic without a decision having chosen it for that request. So the question is not which model, but who said this model may ever answer for this lane.

The answer is a column. Every entry names the accepted decision it was registered under, and every request a fallback serves carries that decision on its ledger row. A fallback serve is still an attributable serve.

Registering one

bash
npm run aperture:fallback:add -- --workload convexity/deep-research \
  --sku anthropic/claude-sonnet-5 --note "cross-vendor cover for the frontier tier"

The decision is not a flag. It is the workload's standing accepted decision, read at the moment of registration, because that is what the chain exists to back up.

--position puts an entry at a place in the chain; without it the entry goes on the end. The runtime walks the chain in order and stops at the first model that answers.

Re-deciding a lane retires its chain

When a lane is re-decided, every fallback registered under the old decision stops being emittable, and `aperture:policy` refuses rather than shipping them:

text
convexity/deep-research falls back to anthropic/claude-sonnet-5 under decision
154, and decision 161 is what stands. Re-register the chain under 161, or take
it out

That is deliberate, and it is the part worth arguing with. A chain assembled to back up one model is not self-evidently the right chain to back up whatever replaced it, and quietly carrying it over would be the register deciding something nobody did. Re-registering is one command per entry.

The refusals

Refusal
The lane has no accepted decision, so there is nothing to back up
The sku is what the lane already serves, so the chain would repeat itself
The sku is from another market than the workload
The sku cannot be named in a request
The sku is already in this chain
That place in the chain is held by another sku

Taking one out

bash
npm run aperture:fallback:remove -- --workload convexity/deep-research \
  --sku anthropic/claude-sonnet-5 --reason "no longer cleared for this work"

The row is kept and dated rather than deleted. A fallback that served traffic during an incident is part of what happened, and a row that vanished when somebody tidied the chain would take that with it. A reason is required by the database as well as by the command.

The remaining entries keep the positions they had; the emitter renumbers from one when it writes the policy, so a gap here is not a gap there.

What the runtime does with a chain

See serving a lane. In short: it walks the chain only when a provider cannot serve the request now, which means a transport failure, a rate limit or the provider's own 5xx. A 4xx is the request being wrong, and asking a second model the same wrong question spends money to be told the same thing twice.

Every attempt is its own ledger row, so one request a fallback answered is two: the primary's failure, worth no units, and the fallback's serve, worth one.

What a chain costs, and why the engine does not say

Nothing. Not because a chain is free, but because its price is not knowable before it runs.

A route's cost depends on how often the primary fails over, and that rate is the one number no tape carries: it is a property of an incident, not of a listing. So the engine prices the primary and reports the chain as a constraint the decision was made under, and the brief says as much where a reader would otherwise take the figure for the cost of the route.

That is a choice with a cost, so both sides are written down. What it buys is that a lane carrying a chain is decidable at all, with every existing trigger and comparison working unchanged. What it costs is a figure narrower than the thing it sits beside, which is why the disclosure is part of the brief rather than a footnote somebody may skip.

The alternative stays available and is the truer answer once there is enough history: require an observed split from a prior window before a route is decidable, which makes a route economically knowable only in its second generation. Since importing usage now attributes units to a declared fallback rather than merely tolerating them, the reading that alternative needs is being collected. The rule stays as written until somebody wants the second generation more than the first.