@memberjunction/rubrics-base 0.0.0 → 6.2.0-edge.2

package/dist/evidence.js

@@ -0,0 +1,38 @@
+/**
+ * Evidence stored on a score. A typed list is kept. Plain text becomes one quote.
+ * Empty text is null, not a string stuffed into the JSON column.
+ */
+/** True when the value is evidence. Blank text, an empty list, and `'[]'` are not. */
+export function EvidenceSatisfied(value) {
+    if (value == null)
+        return false;
+    if (Array.isArray(value))
+        return value.length > 0;
+    if (typeof value === 'string') {
+        const text = value.trim();
+        return text.length > 0 && text !== '[]';
+    }
+    return true;
+}
+export function EvidenceJson(value) {
+    if (value == null)
+        return null;
+    if (Array.isArray(value))
+        return value.length === 0 ? null : JSON.stringify(value);
+    const text = String(value).trim();
+    if (!text)
+        return null;
+    if (text.startsWith('[')) {
+        try {
+            const parsed = JSON.parse(text);
+            if (Array.isArray(parsed))
+                return parsed.length === 0 ? null : JSON.stringify(parsed);
+        }
+        catch {
+            // The scorer typed a sentence that happens to start with a bracket.
+        }
+    }
+    const quote = { Type: 'Quote', Text: text };
+    return JSON.stringify([quote]);
+}
+//# sourceMappingURL=evidence.js.map

package/dist/evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.js","sourceRoot":"","sources":["../src/evidence.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,sFAAsF;AACtF,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC5C,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IAChC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,KAAK,IAAI,CAAC;IAC5C,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACvC,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACnF,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IAClC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;YAC3C,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;gBAAE,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC1F,CAAC;QAAC,MAAM,CAAC;YACL,oEAAoE;QACxE,CAAC;IACL,CAAC;IACD,MAAM,KAAK,GAAkB,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC3D,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AACnC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { RUBRIC_CACHE_ENTITIES, RubricEngineBase } from './RubricEngineBase.js';
+export type { AgentRubricRecord, CachedPublishedVersion, RubricCacheSnapshot, RubricCategoryRecord, RubricRecord, RubricScaleLevelRecord, RubricScaleRecord, RubricVersionRecord, } from './RubricEngineBase.js';
+export { BandFor, DraftProblems, Frozen, WeightShares } from './authoring.js';
+export { EvidenceJson, EvidenceSatisfied, type QuoteEvidence } from './evidence.js';
+export { RubricScoring, RubricValidationError, SCORING_ENGINE_VERSION } from './RubricScoring.js';
+export { HighestNonDraftVersion, RubricVersionDiff } from './RubricVersionDiff.js';
+export type { VersionNumberRow } from './RubricVersionDiff.js';
+export { DriftDeltas, DriftSeries, KeepSample, PeriodMeans, RubricIdFromVersion, SampleBucket, type DriftEvaluationRow, type DriftRunRow, type DriftScoreRow, } from './sampling.js';
+export { CanonicalJson, ContentProjection, ScoringProjection, Sha256Hex } from './canonical.js';
+export { NodeSnapshotFromRecord, SnapshotFromRows, type SnapshotRows } from './snapshot.js';
+export type { NotApplicablePolicy, RollupMethod, RubricAnswer, RubricBandSnapshot, RubricLevelAnchorSnapshot, RubricNodeSnapshot, RubricNodeType, RubricOutcome, RubricScaleLevelSnapshot, RubricScaleSnapshot, RubricScaleType, RubricScoreInput, RubricScoreResult, RubricVersionSnapshot, ScoredNode, VersionBump, VersionChange, VersionDiffResult, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAChF,YAAY,EACR,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAClG,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACnF,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EACH,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EACjD,mBAAmB,EAAE,YAAY,EACjC,KAAK,kBAAkB,EAAE,KAAK,WAAW,EAAE,KAAK,aAAa,GAChE,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChG,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAC5F,YAAY,EACR,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,yBAAyB,EACzB,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,UAAU,EACV,WAAW,EACX,aAAa,EACb,iBAAiB,GACpB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { RUBRIC_CACHE_ENTITIES, RubricEngineBase } from './RubricEngineBase.js';
+export { BandFor, DraftProblems, Frozen, WeightShares } from './authoring.js';
+export { EvidenceJson, EvidenceSatisfied } from './evidence.js';
+export { RubricScoring, RubricValidationError, SCORING_ENGINE_VERSION } from './RubricScoring.js';
+export { HighestNonDraftVersion, RubricVersionDiff } from './RubricVersionDiff.js';
+export { DriftDeltas, DriftSeries, KeepSample, PeriodMeans, RubricIdFromVersion, SampleBucket, } from './sampling.js';
+export { CanonicalJson, ContentProjection, ScoringProjection, Sha256Hex } from './canonical.js';
+export { NodeSnapshotFromRecord, SnapshotFromRows } from './snapshot.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAWhF,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAsB,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAClG,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEnF,OAAO,EACH,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EACjD,mBAAmB,EAAE,YAAY,GAEpC,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChG,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAqB,MAAM,eAAe,CAAC"}

package/dist/sampling.d.ts

@@ -0,0 +1,71 @@
+/** Stable bucket 0..9999 for a run id. The same id always lands in the same bucket. */
+export declare function SampleBucket(runId: string): number;
+/** True when the run falls inside the link's sample rate. Rate is 0..1. */
+export declare function KeepSample(runId: string, sampleRate: number): boolean;
+export interface DriftScoreRow {
+    evaluationId: string;
+    criterionId: string;
+    /** The criterion's Key. Drift is keyed by this, not by the row id. */
+    criterionKey?: string;
+    normalizedScore: number;
+}
+export interface DriftEvaluationRow {
+    id: string;
+    subjectRecordId: string;
+    /** The evaluation stores a version id. The rubric id comes from that version. */
+    rubricVersionId: string;
+    at: string;
+}
+export interface DriftRunRow {
+    id: string;
+    agentId: string;
+}
+/** Rubric id stored on the version. An unknown version resolves to an empty string. */
+export declare function RubricIdFromVersion(versionId: string, versions: {
+    id: string;
+    rubricId: string;
+}[]): string;
+/**
+ * Joins a score to its evaluation and that evaluation's agent run.
+ * The key is agent, rubric, and criterion. A score with no matching run is left out.
+ */
+export declare function DriftSeries(input: {
+    scores: DriftScoreRow[];
+    evaluations: DriftEvaluationRow[];
+    runs: DriftRunRow[];
+    versions: {
+        id: string;
+        rubricId: string;
+    }[];
+    /** Criterion id to Key. The series key uses Key, so two ids of one criterion stay together. */
+    criteria?: {
+        id: string;
+        key: string;
+    }[];
+}): {
+    key: string;
+    score: number;
+    at: string;
+}[];
+/** Mean score of each key whose timestamp falls in [start, end). */
+export declare function PeriodMeans(rows: {
+    key: string;
+    score: number;
+    at: string;
+}[], start: string, end: string): {
+    key: string;
+    mean: number;
+}[];
+/** Drop of the current period's mean below the previous period. A drop past the threshold alerts. */
+export declare function DriftDeltas(current: {
+    key: string;
+    mean: number;
+}[], previous: {
+    key: string;
+    mean: number;
+}[], threshold: number): {
+    key: string;
+    drop: number;
+    alert: boolean;
+}[];
+//# sourceMappingURL=sampling.d.ts.map

package/dist/sampling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampling.d.ts","sourceRoot":"","sources":["../src/sampling.ts"],"names":[],"mappings":"AAEA,uFAAuF;AACvF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAIrE;AAED,MAAM,WAAW,aAAa;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,iFAAiF;IACjF,eAAe,EAAE,MAAM,CAAC;IACxB,EAAE,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,MAAM,CAE3G;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE;IAC/B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7C,+FAA+F;IAC/F,QAAQ,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC5C,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,CAe/C;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAS3I;AAED,qGAAqG;AACrG,wBAAgB,WAAW,CAAC,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,EAAE,QAAQ,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,EAAE,CAMnL"}

package/dist/sampling.js

@@ -0,0 +1,63 @@
+import { NormalizeUUID, UUIDsEqual } from '@memberjunction/global';
+/** Stable bucket 0..9999 for a run id. The same id always lands in the same bucket. */
+export function SampleBucket(runId) {
+    let hash = 0;
+    for (const char of NormalizeUUID(runId))
+        hash = Math.imul(hash, 31) + char.charCodeAt(0);
+    return (hash >>> 0) % 10000;
+}
+/** True when the run falls inside the link's sample rate. Rate is 0..1. */
+export function KeepSample(runId, sampleRate) {
+    if (sampleRate <= 0)
+        return false;
+    if (sampleRate >= 1)
+        return true;
+    return SampleBucket(runId) < sampleRate * 10000;
+}
+/** Rubric id stored on the version. An unknown version resolves to an empty string. */
+export function RubricIdFromVersion(versionId, versions) {
+    return versions.find(row => UUIDsEqual(row.id, versionId))?.rubricId ?? '';
+}
+/**
+ * Joins a score to its evaluation and that evaluation's agent run.
+ * The key is agent, rubric, and criterion. A score with no matching run is left out.
+ */
+export function DriftSeries(input) {
+    const evaluations = new Map(input.evaluations.map(row => [row.id, row]));
+    const agents = new Map(input.runs.map(row => [row.id, row.agentId]));
+    const criterionKeys = new Map((input.criteria ?? []).map(row => [row.id, row.key]));
+    const rows = [];
+    for (const score of input.scores) {
+        const evaluation = evaluations.get(score.evaluationId);
+        if (!evaluation || !Number.isFinite(score.normalizedScore))
+            continue;
+        const agentId = agents.get(evaluation.subjectRecordId);
+        const rubricId = RubricIdFromVersion(evaluation.rubricVersionId, input.versions);
+        const criterionKey = score.criterionKey || criterionKeys.get(score.criterionId) || score.criterionId;
+        if (!agentId || !rubricId || !criterionKey)
+            continue;
+        rows.push({ key: `${agentId}|${rubricId}|${criterionKey}`, score: score.normalizedScore, at: evaluation.at });
+    }
+    return rows;
+}
+/** Mean score of each key whose timestamp falls in [start, end). */
+export function PeriodMeans(rows, start, end) {
+    const buckets = new Map();
+    for (const row of rows) {
+        if (row.at < start || row.at >= end)
+            continue;
+        const list = buckets.get(row.key) ?? [];
+        list.push(row.score);
+        buckets.set(row.key, list);
+    }
+    return [...buckets.entries()].map(([key, scores]) => ({ key, mean: scores.reduce((sum, score) => sum + score, 0) / scores.length }));
+}
+/** Drop of the current period's mean below the previous period. A drop past the threshold alerts. */
+export function DriftDeltas(current, previous, threshold) {
+    return current.map(row => {
+        const prior = previous.find(item => item.key === row.key);
+        const drop = prior == null ? 0 : prior.mean - row.mean;
+        return { key: row.key, drop, alert: prior != null && drop > threshold };
+    });
+}
+//# sourceMappingURL=sampling.js.map

package/dist/sampling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampling.js","sourceRoot":"","sources":["../src/sampling.ts"],"names":[],"mappings":"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"}

package/dist/snapshot.d.ts

@@ -0,0 +1,16 @@
+import type { RubricNodeSnapshot, RubricVersionSnapshot } from './types.js';
+/** One version, its criteria, anchors, bands, and scales, as rows the database returned. */
+export interface SnapshotRows {
+    version: unknown;
+    rubricId: string;
+    criteria: unknown[];
+    anchors: unknown[];
+    bands: unknown[];
+    scales: unknown[];
+    levels: unknown[];
+}
+/** The one snapshot every scorer uses. EvaluatorConfig JSON is parsed. Anchors are ordered. */
+export declare function SnapshotFromRows(rows: SnapshotRows): RubricVersionSnapshot;
+/** One criterion or group row, including parsed EvaluatorConfig. */
+export declare function NodeSnapshotFromRecord(row: unknown, anchors?: unknown[]): RubricNodeSnapshot;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAE5E,4FAA4F;AAC5F,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,MAAM,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,qBAAqB,CAgD1E;AAED,oEAAoE;AACpE,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,OAAO,EAAO,GAAG,kBAAkB,CA0BhG"}

package/dist/snapshot.js

@@ -0,0 +1,114 @@
+import { CompareCodePoints } from './canonical.js';
+/** The one snapshot every scorer uses. EvaluatorConfig JSON is parsed. Anchors are ordered. */
+export function SnapshotFromRows(rows) {
+    const version = rows.version;
+    const anchors = [...rows.anchors].sort((left, right) => {
+        const sequence = number(field(left, 'Sequence')) - number(field(right, 'Sequence'));
+        return sequence !== 0 ? sequence : CompareCodePoints(String(field(left, 'ID') ?? ''), String(field(right, 'ID') ?? ''));
+    });
+    return {
+        id: String(field(version, 'ID') ?? ''),
+        rubricId: rows.rubricId,
+        majorVersion: numberOrNull(field(version, 'MajorVersion')),
+        minorVersion: numberOrNull(field(version, 'MinorVersion')),
+        patchVersion: numberOrNull(field(version, 'PatchVersion')),
+        notApplicablePolicy: (text(field(version, 'NotApplicablePolicy')) || 'ExcludeAndRedistribute'),
+        passThreshold: numberOrNull(field(version, 'PassThreshold')),
+        minimumCompleteness: numberOrNull(field(version, 'MinimumCompleteness')),
+        instructions: textOrNull(field(version, 'Instructions')),
+        scoreDisplayMin: number(field(version, 'ScoreDisplayMin')),
+        scoreDisplayMax: number(field(version, 'ScoreDisplayMax') ?? 100),
+        nodes: rows.criteria.map(row => NodeSnapshotFromRecord(row, anchors.filter(anchor => String(field(anchor, 'CriterionID')) === String(field(row, 'ID'))))),
+        scales: rows.scales.map(scale => ({
+            id: String(field(scale, 'ID') ?? ''),
+            scaleType: (text(field(scale, 'ScaleType')) || 'Levels'),
+            minValue: numberOrNull(field(scale, 'MinValue')),
+            maxValue: numberOrNull(field(scale, 'MaxValue')),
+            step: numberOrNull(field(scale, 'Step')),
+            higherIsBetter: field(scale, 'HigherIsBetter') === true || field(scale, 'HigherIsBetter') === 1,
+            levels: rows.levels.filter(level => {
+                const scaleId = field(level, 'ScaleID');
+                return scaleId == null || scaleId === '' || String(scaleId) === String(field(scale, 'ID'));
+            }).map(level => ({
+                id: String(field(level, 'ID') ?? ''),
+                label: String(field(level, 'Label') ?? ''),
+                value: number(field(level, 'Value')),
+                normalizedValue: number(field(level, 'NormalizedValue')),
+                description: textOrNull(field(level, 'Description')),
+                sequence: number(field(level, 'Sequence')),
+            })),
+        })),
+        bands: rows.bands.map(row => ({
+            id: String(field(row, 'ID') ?? ''),
+            label: String(field(row, 'Label') ?? ''),
+            description: textOrNull(field(row, 'Description')),
+            minScore: number(field(row, 'MinScore')),
+            maxScore: number(field(row, 'MaxScore')),
+            displayTone: text(field(row, 'DisplayTone')) || 'Neutral',
+            sequence: number(field(row, 'Sequence')),
+        })),
+    };
+}
+/** One criterion or group row, including parsed EvaluatorConfig. */
+export function NodeSnapshotFromRecord(row, anchors = []) {
+    return {
+        id: String(field(row, 'ID') ?? ''),
+        key: String(field(row, 'Key') ?? ''),
+        parentId: textOrNull(field(row, 'ParentID')),
+        name: String(field(row, 'Name') ?? field(row, 'Key') ?? ''),
+        description: textOrNull(field(row, 'Description')),
+        guidance: textOrNull(field(row, 'Guidance')),
+        nodeType: field(row, 'NodeType') === 'Group' ? 'Group' : 'Criterion',
+        scaleId: textOrNull(field(row, 'ScaleID')),
+        weight: field(row, 'Weight') == null ? 1 : number(field(row, 'Weight')),
+        isAdvisory: field(row, 'IsAdvisory') === true || field(row, 'IsAdvisory') === 1,
+        isGate: field(row, 'IsGate') === true || field(row, 'IsGate') === 1,
+        gateMinimumScore: numberOrNull(field(row, 'GateMinimumScore')),
+        notApplicablePolicy: textOrNull(field(row, 'NotApplicablePolicy')),
+        rollupMethod: textOrNull(field(row, 'RollupMethod')),
+        evidenceRequired: field(row, 'EvidenceRequired') === true || field(row, 'EvidenceRequired') === 1,
+        rationaleRequired: field(row, 'RationaleRequired') === true || field(row, 'RationaleRequired') === 1,
+        sequence: number(field(row, 'Sequence')),
+        evaluatorConfig: parseConfig(field(row, 'EvaluatorConfig')),
+        anchors: anchors.map(anchor => ({
+            scaleLevelId: textOrNull(field(anchor, 'ScaleLevelID')),
+            anchorValue: numberOrNull(field(anchor, 'AnchorValue')),
+            descriptor: String(field(anchor, 'Descriptor') ?? ''),
+        })),
+    };
+}
+function field(row, name) {
+    const record = row;
+    if (record && record[name] === undefined && typeof record.Get === 'function')
+        return record.Get(name);
+    return record?.[name];
+}
+function parseConfig(value) {
+    if (typeof value !== 'string' || value.length === 0)
+        return value ?? null;
+    try {
+        return JSON.parse(value);
+    }
+    catch (error) {
+        throw new Error(`EvaluatorConfig is not valid JSON. ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function text(value) {
+    return value == null ? '' : String(value);
+}
+function textOrNull(value) {
+    if (value == null || value === '')
+        return null;
+    return String(value);
+}
+function number(value) {
+    const parsed = Number(value ?? 0);
+    return Number.isFinite(parsed) ? parsed : 0;
+}
+function numberOrNull(value) {
+    if (value == null || value === '')
+        return null;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : null;
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAcnD,+FAA+F;AAC/F,MAAM,UAAU,gBAAgB,CAAC,IAAkB;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7B,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;QACpF,OAAO,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5H,CAAC,CAAC,CAAC;IACH,OAAO;QACH,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QACtC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,YAAY,EAAE,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC1D,YAAY,EAAE,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC1D,YAAY,EAAE,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC1D,mBAAmB,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC,IAAI,wBAAwB,CAAiD;QAC9I,aAAa,EAAE,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QAC5D,mBAAmB,EAAE,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;QACxE,YAAY,EAAE,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QACxD,eAAe,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;QAC1D,eAAe,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,iBAAiB,CAAC,IAAI,GAAG,CAAC;QACjE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,sBAAsB,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACzJ,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC9B,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;YACpC,SAAS,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,IAAI,QAAQ,CAAyB;YAChF,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;YAChD,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;YAChD,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACxC,cAAc,EAAE,KAAK,CAAC,KAAK,EAAE,gBAAgB,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC;YAC/F,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;gBAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;gBACxC,OAAO,OAAO,IAAI,IAAI,IAAI,OAAO,KAAK,EAAE,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;YAC/F,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACb,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;gBACpC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;gBAC1C,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBACpC,eAAe,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;gBACxD,WAAW,EAAE,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;gBACpD,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;aAC7C,CAAC,CAAC;SACN,CAAC,CAAC;QACH,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC1B,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;YAClC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;YACxC,WAAW,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;YAClD,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;YACxC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;YACxC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,IAAI,SAAS;YACzD,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;SAC3C,CAAC,CAAC;KACN,CAAC;AACN,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,sBAAsB,CAAC,GAAY,EAAE,UAAqB,EAAE;IACxE,OAAO;QACH,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAClC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QACpC,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAC5C,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QAC3D,WAAW,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;QAClD,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAC5C,QAAQ,EAAE,KAAK,CAAC,GAAG,EAAE,UAAU,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW;QACpE,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC1C,MAAM,EAAE,KAAK,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACvE,UAAU,EAAE,KAAK,CAAC,GAAG,EAAE,YAAY,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,GAAG,EAAE,YAAY,CAAC,KAAK,CAAC;QAC/E,MAAM,EAAE,KAAK,CAAC,GAAG,EAAE,QAAQ,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC;QACnE,gBAAgB,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;QAC9D,mBAAmB,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAA8C;QAC/G,YAAY,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,cAAc,CAAC,CAAuC;QAC1F,gBAAgB,EAAE,KAAK,CAAC,GAAG,EAAE,kBAAkB,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,GAAG,EAAE,kBAAkB,CAAC,KAAK,CAAC;QACjG,iBAAiB,EAAE,KAAK,CAAC,GAAG,EAAE,mBAAmB,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,GAAG,EAAE,mBAAmB,CAAC,KAAK,CAAC;QACpG,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACxC,eAAe,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;QAC3D,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC5B,YAAY,EAAE,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;YACvD,WAAW,EAAE,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;YACvD,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC,IAAI,EAAE,CAAC;SACxD,CAAC,CAAC;KACN,CAAC;AACN,CAAC;AAED,SAAS,KAAK,CAAC,GAAY,EAAE,IAAY;IACrC,MAAM,MAAM,GAAG,GAAyE,CAAC;IACzF,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,UAAU;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtG,OAAO,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,IAAI,IAAI,CAAC;IAC1E,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,sCAAsC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACpH,CAAC;AACL,CAAC;AAED,SAAS,IAAI,CAAC,KAAc;IACxB,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAC9B,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC/C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;IAClC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAChC,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACnD,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,170 @@
+/** How a not-applicable answer changes the node's weight. Criterion policy wins over the version policy. */
+export type NotApplicablePolicy = 'ExcludeAndRedistribute' | 'CountAsZero' | 'FailEvaluation' | 'NotAllowed';
+/** How a group combines its included, non-advisory children. Null on a group means WeightedMean. */
+export type RollupMethod = 'WeightedMean' | 'Minimum' | 'Maximum';
+export type RubricNodeType = 'Group' | 'Criterion';
+export type RubricScaleType = 'Levels' | 'Numeric';
+/** First match wins. See RubricScoring.Compute. */
+export type RubricOutcome = 'Incomplete' | 'NotApplicableFailure' | 'GateFailed' | 'BelowThreshold' | 'Passed' | 'Scored';
+/** How much a draft differs from the version it was cloned from. Initial is the first publish. */
+export type VersionBump = 'Major' | 'Minor' | 'Patch' | 'Initial';
+export interface RubricScaleLevelSnapshot {
+    id: string;
+    label: string;
+    value: number;
+    /** Explicit 0..1 position. A levels answer scores this, not a linear map of value. */
+    normalizedValue: number;
+    description?: string | null;
+    sequence: number;
+}
+export interface RubricScaleSnapshot {
+    id: string;
+    /** Display name. The author select shows this, not the id. */
+    name?: string;
+    scaleType: RubricScaleType;
+    minValue?: number | null;
+    maxValue?: number | null;
+    step?: number | null;
+    higherIsBetter: boolean;
+    levels: RubricScaleLevelSnapshot[];
+}
+export interface RubricLevelAnchorSnapshot {
+    scaleLevelId?: string | null;
+    anchorValue?: number | null;
+    descriptor: string;
+}
+export interface RubricNodeSnapshot {
+    id: string;
+    /** Stable identity across versions. Diff and hashes match nodes by this, not by id. */
+    key: string;
+    parentId?: string | null;
+    name: string;
+    description?: string | null;
+    guidance?: string | null;
+    nodeType: RubricNodeType;
+    scaleId?: string | null;
+    weight: number;
+    isAdvisory: boolean;
+    isGate: boolean;
+    gateMinimumScore?: number | null;
+    notApplicablePolicy?: NotApplicablePolicy | null;
+    rollupMethod?: RollupMethod | null;
+    evidenceRequired: boolean;
+    rationaleRequired: boolean;
+    sequence: number;
+    evaluatorConfig?: unknown;
+    anchors?: RubricLevelAnchorSnapshot[];
+}
+export interface RubricBandSnapshot {
+    id: string;
+    label: string;
+    description?: string | null;
+    minScore: number;
+    maxScore: number;
+    displayTone: string;
+    sequence: number;
+}
+/** One published or draft version, already loaded. Ids are local to this snapshot. */
+export interface RubricVersionSnapshot {
+    id: string;
+    rubricId: string;
+    majorVersion?: number | null;
+    minorVersion?: number | null;
+    patchVersion?: number | null;
+    instructions?: string | null;
+    passThreshold?: number | null;
+    minimumCompleteness?: number | null;
+    notApplicablePolicy: NotApplicablePolicy;
+    scoreDisplayMin: number;
+    scoreDisplayMax: number;
+    nodes: RubricNodeSnapshot[];
+    scales: RubricScaleSnapshot[];
+    bands: RubricBandSnapshot[];
+}
+/** One leaf answer. Groups are not answered; the scorer writes their rows. */
+export interface RubricAnswer {
+    criterionId: string;
+    scaleLevelId?: string | null;
+    rawValue?: number | null;
+    isNotApplicable?: boolean;
+    /** 0..1 when the evaluator reported one. Omitted values are left out of the confidence mean. */
+    confidence?: number | null;
+    /** The evaluator's reason for this leaf. Copied onto the score row. */
+    rationale?: string;
+    /** Quotes or other evidence the evaluator attached. Copied onto the score row as JSON. */
+    evidence?: unknown;
+}
+export interface RubricScoreInput {
+    version: RubricVersionSnapshot;
+    answers: RubricAnswer[];
+    /** Consumer override. Stored as PassThresholdApplied. Null means the version threshold. */
+    passThresholdOverride?: number | null;
+}
+export interface ScoredNode {
+    id: string;
+    key: string;
+    /** 0..1, or null when the node is excluded or unanswered. Rounded to 6 places. */
+    normalizedScore: number | null;
+    /** This node's share of its included siblings. Null when the node is not in the rollup. */
+    effectiveWeight: number | null;
+    /**
+     * normalizedScore times the product of effective weights from this node to the root.
+     * Null when any ancestor rolls up by Minimum or Maximum.
+     */
+    overallContribution: number | null;
+    gateFailed: boolean;
+    isNotApplicable: boolean;
+    isAdvisory: boolean;
+    /** Group rows: scored applicable descendants over applicable descendants. Null on a leaf. */
+    completeness?: number | null;
+    /** A leaf's reported confidence, or a group's path-weighted mean of those reports. */
+    confidence?: number | null;
+}
+export interface RubricScoreResult {
+    /** 0..1 WeightedMean of the included top-level nodes, or null when nothing was included. */
+    normalizedScore: number | null;
+    /**
+     * Scored applicable non-advisory leaves divided by applicable non-advisory leaves.
+     * 1 when nothing is applicable.
+     */
+    completeness: number | null;
+    outcome: RubricOutcome;
+    /** True only for Passed. Null for Scored, and for Incomplete when there is no threshold and no gate. */
+    passed: boolean | null;
+    gateFailed: boolean;
+    passThresholdApplied: number | null;
+    bandId: string | null;
+    /** Path-weight mean of leaf confidences that were reported. Path weight is the product of effective weights to the root, not the score. */
+    confidence: number | null;
+    /** Non-advisory leaves that received a score. */
+    scoredCriteriaCount: number;
+    /** Non-advisory leaves that count toward completeness. */
+    applicableCriteriaCount: number;
+    /** Non-advisory leaves on the version. */
+    totalCriteriaCount: number;
+    nodes: ScoredNode[];
+    scoringEngineVersion: '1.0';
+}
+export interface VersionChange {
+    bump: 'Major' | 'Minor' | 'Patch';
+    /** Node key, band id, scale id, or "version". */
+    subject: string;
+    property: string;
+    /** Previous value. Null when the subject was added. */
+    from: unknown;
+    /** Next value. Null when the subject was removed. */
+    to: unknown;
+}
+export interface VersionDiffResult {
+    changes: VersionChange[];
+    /** Null when the draft is identical to its base and cannot be published. */
+    computedBump: 'Major' | 'Minor' | 'Patch' | null;
+    /** max(computed, requested). An author may go higher, never lower. Initial on the first publish. */
+    appliedBump: VersionBump | null;
+    nextVersion: {
+        major: number;
+        minor: number;
+        patch: number;
+    } | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,10 +1,42 @@
 {
   "name": "@memberjunction/rubrics-base",
-  "version": "0.0.0",
-  "description": "OIDC trusted publishing setup package for @memberjunction/rubrics-base",
+  "type": "module",
+  "version": "6.2.0-edge.2",
+  "description": "UI-safe rubric scoring and version classification. Pure functions: no database and no Angular.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "/dist"
+  ],
   "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
-}
+    "MemberJunction",
+    "rubrics"
+  ],
+  "author": "MemberJunction.com",
+  "license": "BUSL-1.1",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MemberJunction/MJ"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@memberjunction/core": "6.2.0-edge.2",
+    "@memberjunction/global": "6.2.0-edge.2"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "tsc-alias": "^1.8.16",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "build": "tsc && tsc-alias -f",
+    "test": "vitest run"
+  }
+}