Skip to content

Rulvar API reference


Rulvar API reference / @rulvar/core / WireCapacitySpec

Interface: WireCapacitySpec

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

The declared wire counts of one orchestration plan (RV4005). Since RV4206 the intake is CLOSED: an unknown key is a typed ConfigError instead of a silent zero. The sixth comparison experiment's harness passed repairRound and transportRetries (plausible names this spec never had) and childWires: 4 for four children of ten turns each; every unknown key was ignored and the estimate answered confidently for a plan nobody had declared.

Extends

Properties

PropertyTypeDescriptionInherited fromDefined in
children?numberThe structural fan-out declaration (RV4206): children workers of turnsPerChild provider dispatches each. Declare BOTH or neither; the pair exists because childWires invites passing the child count where the wire total belongs, the exact call the sixth comparison harness made.-packages/core/src/orchestrator/admission.ts:540
childWires?numberFan-out provider dispatches: children TIMES their turns, the total, not the child count. Optional since RV4206 when the structural pair below is given; declaring both is legal only when they agree (childWires === children * turnsPerChild), refused typed otherwise. The semantic posture fields inherited from SemanticRoundPosture (RV4304) switch the estimate from the legacy constant round to the declared arithmetic: with ANY of them declared, the judge wire counts are COMPUTED from the posture (a manually declared judgeWires/citationJudgeWires must agree or refuses typed, the childWires-contradiction symmetry), and repairRoundDeltaWires is derived by the same semanticRoundArming the acceptance tail prices, so money and wires cannot disagree: 0 with nothing armed, 2 for a lone claim or citation round, 3 for the merged round or a citation round that rejudges a configured claim pass. With none of them declared the historical bytes hold exactly: the delta is the documented legacy constant 2 (assume one single-judge round).-packages/core/src/orchestrator/admission.ts:532
citationJudgeWires?numberCitation entailment audit judge dispatches (RV4206): one per pass, so 1 unarmed and the UNARMED reading here too when you read repairRoundDeltaWires as the whole round. The audit's wires were previously unnameable in this spec while the acceptance tail priced their money: the sixth comparison run's capacity model simply lost them.-packages/core/src/orchestrator/admission.ts:564
citationOnFound?"repair" | "report" | "fail"Mirrors OrchestrateCitationAudit.onFound; 'repair' arms the audit's round.SemanticRoundPosture.citationOnFoundpackages/core/src/orchestrator/admission.ts:321
claimConfigured?booleanTrue when a claim-consistency pass is declared.SemanticRoundPosture.claimConfiguredpackages/core/src/orchestrator/admission.ts:323
claimOnFound?"repair" | "report" | "carry" | "fail"Mirrors OrchestrateClaimConsistency.onFound; absent reads 'report'.SemanticRoundPosture.claimOnFoundpackages/core/src/orchestrator/admission.ts:319
claimStage?"draft" | "final" | "both"Mirrors OrchestrateClaimConsistency.stage; absent reads 'draft'.SemanticRoundPosture.claimStagepackages/core/src/orchestrator/admission.ts:317
coordinationWires?numberCoordination loop dispatches, the finish exchanges included.-packages/core/src/orchestrator/admission.ts:544
extractWires?numberSeparate extract dispatches, when the finish rides one (RV3908 spares the schema'd final).-packages/core/src/orchestrator/admission.ts:566
judgeWires?numberWorst-case claim judge dispatches; feed acceptanceJudgePasses the declared posture to get it. NOTE: that count already includes the armed round's rejudge, while the estimate below prices the round's delta separately, so pass the UNARMED reading here ((stage === 'both') ? 2 : 1) when you intend to read repairRoundDeltaWires as the whole round.-packages/core/src/orchestrator/admission.ts:555
maxSemanticRepairRounds?numberMirrors OrchestrateOptions.maxSemanticRepairRounds (RV4705): the scoped semantic reserve inside the pool. It shrinks the mechanical share of repairWiresCeiling exactly like the runtime split; greater than the declared total refuses typed, the intake contradiction.-packages/core/src/orchestrator/admission.ts:584
maxTotalRepairRounds?numberMirrors OrchestrateOptions.maxTotalRepairRounds (RV4406, scoped by RV4705): the one run-wide pool every provider-dispatching repair grant consumes from. Declared, the estimate reports repairWiresCeiling, the pool-bounded worst case of every repair wire; the eighth comparison rerun's plan had a one-token pool under an armed round plus a mechanical grant, a worst case the estimate could not express.-packages/core/src/orchestrator/admission.ts:576
synthesisWires?numberComposition invocations of the base plan (the initial synthesis).-packages/core/src/orchestrator/admission.ts:546
turnsPerChild?numberSee children; the two resolve to children * turnsPerChild fan-out wires.-packages/core/src/orchestrator/admission.ts:542