Skip to content

Rulvar API reference


Rulvar API reference / @rulvar/core / WireCapacityEstimate

Interface: WireCapacityEstimate

Defined in: packages/core/src/orchestrator/admission.ts:588

What one orchestration plan costs in wires, base and worst case (RV4005).

Properties

PropertyTypeDescriptionDefined in
baseWiresnumberThe plan's wire total with no repair of any kind.packages/core/src/orchestrator/admission.ts:599
basis"declared-estimate"What these numbers ARE (RV4206): a fold over the counts the caller DECLARED, never a measurement of a run. The literal exists so a capacity report that embeds the estimate carries its provenance on its face, the CostReport.basis precedent: the sixth comparison run's answer presented a declared estimate over a misdeclared plan as the runtime's own economics.packages/core/src/orchestrator/admission.ts:597
mechanicalRepairDeltaWiresnumberEach granted mechanical repair turn is one more wire on its invocation.packages/core/src/orchestrator/admission.ts:613
repairRoundDeltaWiresnumberThe armed semantic repair round's delta. With no posture declared: the legacy constant 2, ONE more composition PLUS ONE more judge pass (RV3307; the fifth comparison run modeled 34 to 35 and lost the decisive correctness point to exactly this). With the posture declared (RV4304): derived by the same semanticRoundArming the acceptance tail prices, so 0 with nothing armed, 2 for a lone round, and 3 for the merged round or a citation round that rejudges a configured claim pass, which the sixth comparison run's constant could not express.packages/core/src/orchestrator/admission.ts:611
repairWiresCeiling?numberThe pool-bounded worst case of every repair wire (RV4705), present exactly when maxTotalRepairRounds was declared: each pool token is one repair event, so the ceiling maximizes over the round dispatched beside the mechanical grants the pool still holds (mechanics never draw the declared reserve, and the round consumes at least one token) and the all-mechanical pool. Absent, the pool is undeclared and repair wires are bounded only by the stage bounds the spec does not carry.packages/core/src/orchestrator/admission.ts:628
roundOverheadSharenumberrepairRoundDeltaWires / baseWires: the round's overhead share.packages/core/src/orchestrator/admission.ts:617
wiresWithRoundnumberbaseWires + repairRoundDeltaWires.packages/core/src/orchestrator/admission.ts:615