rulvar API reference / @rulvar/rulvar / KbProposal
Interface: KbProposal
Defined in: packages/core/dist/index.d.ts
One orchestrator model-knowledge proposal (phase 3). A proposal is a run-ledger record, NOT a claim: it lives ONLY in the RunLedger section modelObservations, is never rendered into any prompt of any run before the human gate (absolute quarantine, the note included), and reaches the gate exclusively through LedgerExport. The engine assembles it from the tier-relative kb_propose payload: the subject model is resolved by the engine from the referenced lineage's declared ladder, never named by the orchestrator; evidence must resolve into the proposing run's own decision entries.
Properties
| Property | Type | Description | Defined in |
|---|---|---|---|
evidence | { entryRef: number; kind: "journal"; runId: string; }[] | - | packages/core/dist/index.d.ts |
note? | string | <=200 chars; not rendered into any prompt before the gate. | packages/core/dist/index.d.ts |
polarity | "strength" | "weakness" | - | packages/core/dist/index.d.ts |
subject | { effort?: Effort; model: `${string}:${string}`; } | - | packages/core/dist/index.d.ts |
subject.effort? | Effort | - | packages/core/dist/index.d.ts |
subject.model | `${string}:${string}` | - | packages/core/dist/index.d.ts |
taskClass | TaskClass | - | packages/core/dist/index.d.ts |
trigger | KbProposalTrigger | - | packages/core/dist/index.d.ts |