Interface LedgerEntry

One ledger row. Rows are never updated; a verdict is a row of its own that names its candidate.

interface LedgerEntry {
    id: string;
    rowType: "candidate" | "verdict";
    candidateId: string;
    learner: LedgerLearner;
    kind: LearningKind;
    actor: string;
    subject: string;
    before: unknown;
    after: unknown;
    evidence: LedgerEvidence;
    verdict: LedgerVerdict;
    reason: string;
    versions: LedgerVersions;
    sessionId?: string;
    turnUserId?: string;
    prevHash: string;
    seq: number;
    stateDigest?: string;
    createdAt: string;
}

Properties

id rowType candidateId learner kind actor subject before after evidence verdict reason versions sessionId? turnUserId? prevHash seq stateDigest? createdAt

Properties

id

id: string

A ULID.

rowType

rowType: "candidate" | "verdict"

candidateId

candidateId: string

learner

learner: LedgerLearner

kind

kind: LearningKind

actor

actor: string

operator:<id>, operator:persona, tool:<name>, memory:<writer>, rule:<id>@<version>, gate, user:<id>.

subject

subject: string

A trait name or traits, a trace id or a set's id, a setting's name.

before

before: unknown

after

after: unknown

evidence

evidence: LedgerEvidence

verdict

verdict: LedgerVerdict

reason

reason: string

versions

versions: LedgerVersions

Optional sessionId

sessionId?: string

Optional turnUserId

turnUserId?: string

On a userId: null row, the explicit id of a second user whose turn it records.

prevHash

prevHash: string

The hash of the chain's previous row; 64 zeros on the first.

seq

seq: number

The row's place in its chain, from 1.

Optional stateDigest

stateDigest?: string

On a row that changes its subject's stored state, the digest of that state after the change.

createdAt

createdAt: string

Settings

Member Visibility

Theme

On This Page

idrowTypecandidateIdlearnerkindactorsubjectbeforeafterevidenceverdictreasonversionssessionIdturnUserIdprevHashseqstateDigestcreatedAt