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

package/dist/RubricEngineBase.js

@@ -0,0 +1,267 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { BaseEngine } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { SnapshotFromRows } from './snapshot.js';
+/** Entities {@link RubricEngineBase.Config} keeps fresh. */
+export const RUBRIC_CACHE_ENTITIES = [
+    'MJ: Rubric Categories',
+    'MJ: Rubric Scales',
+    'MJ: Rubric Scale Levels',
+    'MJ: Rubrics',
+    'MJ: Rubric Versions',
+    'MJ: Rubric Criteria',
+    'MJ: Rubric Criterion Levels',
+    'MJ: Rubric Bands',
+    'MJ: AI Agent Rubrics',
+];
+/**
+ * Cache of rubric definitions. It is a {@link BaseEngine}, so a metadata provider
+ * can refresh it. Only versions whose status is Published are kept, each with its
+ * criteria, level anchors, bands, and the scales those criteria use. Drafts are dropped.
+ * Callers can still replace the shaped cache directly.
+ */
+let RubricEngineBase = class RubricEngineBase extends BaseEngine {
+    static get Instance() {
+        return super.getInstance();
+    }
+    constructor() {
+        super();
+        this.categories = new Map();
+        this.scales = new Map();
+        this.rubrics = new Map();
+        this.published = new Map();
+        this.publishedByRubric = new Map();
+        this.agentRubrics = new Map();
+    }
+    /**
+     * Loads the rubric entities, then rebuilds the published-version maps the
+     * readers use. A metadata refresh is not visible until that rebuild.
+     */
+    async Config(forceRefresh, contextUser, provider) {
+        const configs = RUBRIC_CACHE_ENTITIES.map(entityName => ({
+            Type: 'entity',
+            EntityName: entityName,
+            PropertyName: propertyName(entityName),
+            CacheLocal: true,
+        }));
+        await this.Load(configs, provider, forceRefresh, contextUser);
+        this.ReplaceCache(ShapedCacheFromRows({
+            categories: this.loaded('MJ: Rubric Categories'),
+            scales: this.loaded('MJ: Rubric Scales'),
+            levels: this.loaded('MJ: Rubric Scale Levels'),
+            rubrics: this.loaded('MJ: Rubrics'),
+            versions: this.loaded('MJ: Rubric Versions'),
+            criteria: this.loaded('MJ: Rubric Criteria'),
+            anchors: this.loaded('MJ: Rubric Criterion Levels'),
+            bands: this.loaded('MJ: Rubric Bands'),
+            agentRubrics: this.loaded('MJ: AI Agent Rubrics'),
+        }));
+    }
+    loaded(entityName) {
+        const value = this[propertyName(entityName)];
+        return Array.isArray(value) ? value : [];
+    }
+    /**
+     * Replace the whole cache. Published versions are stored with their tree.
+     * A Draft or Retired version is not stored, even when its criteria were loaded.
+     */
+    ReplaceCache(snapshot) {
+        this.categories = new Map(snapshot.categories.map(category => [category.id, category]));
+        this.scales = new Map(snapshot.scales.map(scale => [scale.id, scale]));
+        this.rubrics = new Map(snapshot.rubrics.map(rubric => [rubric.id, rubric]));
+        this.published = new Map();
+        this.publishedByRubric = new Map();
+        this.agentRubrics = new Map();
+        for (const version of snapshot.versions) {
+            if (version.status !== 'Published')
+                continue;
+            const scaleIds = new Set(version.nodes.map(node => node.scaleId).filter((id) => !!id));
+            const cached = {
+                id: version.id,
+                rubricId: version.rubricId,
+                majorVersion: version.majorVersion ?? 0,
+                minorVersion: version.minorVersion ?? 0,
+                patchVersion: version.patchVersion ?? 0,
+                notApplicablePolicy: version.notApplicablePolicy,
+                passThreshold: version.passThreshold ?? null,
+                minimumCompleteness: version.minimumCompleteness ?? null,
+                instructions: version.instructions ?? null,
+                scoreDisplayMin: version.scoreDisplayMin,
+                scoreDisplayMax: version.scoreDisplayMax,
+                nodes: version.nodes,
+                bands: version.bands,
+                scales: [...scaleIds].map(id => this.scales.get(id)).filter((scale) => !!scale),
+            };
+            this.published.set(cached.id, cached);
+            const list = this.publishedByRubric.get(cached.rubricId) ?? [];
+            list.push(cached);
+            this.publishedByRubric.set(cached.rubricId, list);
+        }
+        for (const link of snapshot.agentRubrics) {
+            const list = this.agentRubrics.get(link.agentId) ?? [];
+            list.push(link);
+            this.agentRubrics.set(link.agentId, list);
+        }
+    }
+    /** Category by id, or null when it was not in the last snapshot. */
+    GetCategory(id) {
+        return this.categories.get(id) ?? null;
+    }
+    /** Scale by id, including its levels, or null. */
+    GetScale(id) {
+        return this.scales.get(id) ?? null;
+    }
+    /** Rubric definition by id, or null. */
+    GetRubric(id) {
+        return this.rubrics.get(id) ?? null;
+    }
+    /**
+ * A published version with its criteria, anchors, bands, and scales.
+ * Returns null for an unknown id and for a draft that was present in the snapshot.
+ */
+    GetPublishedVersion(versionId) {
+        return this.published.get(versionId) ?? null;
+    }
+    /** Every cached published version of one rubric, highest number first. */
+    GetPublishedVersions(rubricId) {
+        const list = this.publishedByRubric.get(rubricId) ?? [];
+        return [...list].sort(compareVersionDesc);
+    }
+    /** The highest published version of a rubric, or null when none is published. */
+    GetLatestPublishedVersion(rubricId) {
+        return this.GetPublishedVersions(rubricId)[0] ?? null;
+    }
+    /** Rubrics linked to an agent, highest priority first. */
+    GetAgentRubrics(agentId) {
+        const list = this.agentRubrics.get(agentId) ?? [];
+        return [...list].sort((a, b) => b.priority - a.priority);
+    }
+};
+RubricEngineBase = __decorate([
+    RegisterClass(BaseEngine, 'RubricEngineBase'),
+    __metadata("design:paramtypes", [])
+], RubricEngineBase);
+export { RubricEngineBase };
+function compareVersionDesc(a, b) {
+    if (a.majorVersion !== b.majorVersion)
+        return b.majorVersion - a.majorVersion;
+    if (a.minorVersion !== b.minorVersion)
+        return b.minorVersion - a.minorVersion;
+    return b.patchVersion - a.patchVersion;
+}
+function propertyName(entityName) {
+    return `_${entityName.replace(/[^A-Za-z0-9]/g, '')}`;
+}
+/** Builds the shaped cache from the entity rows {@link RubricEngineBase.Config} just loaded. */
+export function ShapedCacheFromRows(loaded) {
+    const scales = loaded.scales.map(scale => {
+        const id = text(cell(scale, 'ID'));
+        return {
+            id,
+            name: text(cell(scale, 'Name')),
+            scaleType: cell(scale, 'ScaleType') === 'Numeric' ? 'Numeric' : 'Levels',
+            minValue: numberOrNull(cell(scale, 'MinValue')),
+            maxValue: numberOrNull(cell(scale, 'MaxValue')),
+            step: numberOrNull(cell(scale, 'Step')),
+            higherIsBetter: cell(scale, 'HigherIsBetter') == null ? true : bit(cell(scale, 'HigherIsBetter')),
+            levels: loaded.levels.filter(level => text(cell(level, 'ScaleID')) === id).map(level => ({
+                id: text(cell(level, 'ID')),
+                label: text(cell(level, 'Label')),
+                value: numberOrZero(cell(level, 'Value')),
+                normalizedValue: numberOrZero(cell(level, 'NormalizedValue')),
+                description: text(cell(level, 'Description')) || null,
+                sequence: numberOrZero(cell(level, 'Sequence')),
+            })),
+        };
+    });
+    const versions = loaded.versions.map(version => {
+        const id = text(cell(version, 'ID'));
+        const rubricId = text(cell(version, 'RubricID'));
+        const criteria = loaded.criteria.filter(row => text(cell(row, 'RubricVersionID')) === id);
+        const criterionIds = new Set(criteria.map(row => text(cell(row, 'ID'))));
+        const scaleIds = criteria.map(row => text(cell(row, 'ScaleID'))).filter(scaleId => scaleId.length > 0);
+        const tree = SnapshotFromRows({
+            version,
+            rubricId,
+            criteria,
+            anchors: loaded.anchors.filter(row => criterionIds.has(text(cell(row, 'CriterionID')))),
+            bands: loaded.bands.filter(row => text(cell(row, 'RubricVersionID')) === id),
+            scales: loaded.scales.filter(row => scaleIds.includes(text(cell(row, 'ID')))),
+            levels: loaded.levels.filter(row => scaleIds.includes(text(cell(row, 'ScaleID')))),
+        });
+        return {
+            id,
+            rubricId,
+            status: text(cell(version, 'Status')),
+            majorVersion: numberOrNull(cell(version, 'MajorVersion')),
+            minorVersion: numberOrNull(cell(version, 'MinorVersion')),
+            patchVersion: numberOrNull(cell(version, 'PatchVersion')),
+            notApplicablePolicy: (text(cell(version, 'NotApplicablePolicy')) || 'ExcludeAndRedistribute'),
+            passThreshold: numberOrNull(cell(version, 'PassThreshold')),
+            minimumCompleteness: numberOrNull(cell(version, 'MinimumCompleteness')),
+            instructions: text(cell(version, 'Instructions')) || null,
+            scoreDisplayMin: numberOrZero(cell(version, 'ScoreDisplayMin')),
+            scoreDisplayMax: cell(version, 'ScoreDisplayMax') == null ? 100 : numberOrZero(cell(version, 'ScoreDisplayMax')),
+            nodes: tree.nodes,
+            bands: tree.bands,
+        };
+    });
+    return {
+        categories: loaded.categories.map(row => ({
+            id: text(cell(row, 'ID')),
+            name: text(cell(row, 'Name')),
+            parentId: text(cell(row, 'ParentID')) || null,
+            description: text(cell(row, 'Description')) || null,
+            sequence: numberOrZero(cell(row, 'Sequence')),
+        })),
+        scales,
+        rubrics: loaded.rubrics.map(row => ({
+            id: text(cell(row, 'ID')),
+            name: text(cell(row, 'Name')),
+            categoryId: text(cell(row, 'CategoryID')) || null,
+            description: text(cell(row, 'Description')) || null,
+            status: text(cell(row, 'Status')),
+        })),
+        versions,
+        agentRubrics: loaded.agentRubrics.map(row => ({
+            id: text(cell(row, 'ID')),
+            agentId: text(cell(row, 'AgentID')),
+            rubricId: text(cell(row, 'RubricID')),
+            purpose: text(cell(row, 'Purpose')) || null,
+            isDefault: bit(cell(row, 'IsDefault')),
+            status: text(cell(row, 'Status')),
+            priority: numberOrZero(cell(row, 'Priority')),
+        })),
+    };
+}
+function cell(row, name) {
+    const record = row;
+    if (record && record[name] === undefined && typeof record.Get === 'function')
+        return record.Get(name);
+    return record?.[name];
+}
+function text(value) {
+    return value == null ? '' : String(value);
+}
+function numberOrZero(value) {
+    const parsed = typeof value === 'number' ? value : Number(value);
+    return Number.isFinite(parsed) ? parsed : 0;
+}
+function numberOrNull(value) {
+    if (value == null || value === '')
+        return null;
+    const parsed = typeof value === 'number' ? value : Number(value);
+    return Number.isFinite(parsed) ? parsed : null;
+}
+function bit(value) {
+    return value === true || value === 1 || value === '1';
+}
+//# sourceMappingURL=RubricEngineBase.js.map

package/dist/RubricEngineBase.js.map

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

package/dist/RubricScoring.d.ts

@@ -0,0 +1,60 @@
+import type { RubricScoreInput, RubricScoreResult } from './types.js';
+export declare const SCORING_ENGINE_VERSION: "1.0";
+/** Submit is refused. The message names the criterion when one answer is illegal. */
+export declare class RubricValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Pure §6 scoring. No database. Scores are on a closed 0..1 scale.
+ *
+ * A levels answer scores the chosen level's NormalizedValue. A numeric answer scores
+ * (value − min) / (max − min), inverted when HigherIsBetter is false. A value outside
+ * the range or off Step is refused, not clamped.
+ *
+ * The not-applicable policy (the criterion's, otherwise the version's) changes weight:
+ * ExcludeAndRedistribute drops the node and the siblings' weights renormalize, and the
+ * node is not applicable. CountAsZero scores 0 and keeps the weight. FailEvaluation
+ * drops the node and raises NotApplicableFailure. NotAllowed refuses the submit and
+ * names the criterion.
+ *
+ * An unanswered applicable node is dropped from the math the same way, and it lowers
+ * completeness. Advisory nodes are stored when they have a score and never enter a
+ * rollup, a gate, completeness, or the verdict.
+ *
+ * Outcome, first match: Incomplete when completeness is below the minimum; then
+ * NotApplicableFailure, including when that policy is why the overall score is null;
+ * then Incomplete when the overall score is null for any other reason; then GateFailed;
+ * then BelowThreshold or Passed when a threshold applies; otherwise Scored. Passed is true only for
+ * Passed. It is null for Scored, and for Incomplete when the version has no threshold
+ * and no gate. Otherwise it is false.
+ *
+ * Stored decimals are rounded to 6 places after the arithmetic. Threshold, gate,
+ * band, and completeness comparisons use that same rounding, so a float such as
+ * the weighted mean of 0.1, 0.2, and 0.7 is not treated as below the value it
+ * rounds to.
+ */
+export declare class RubricScoring {
+    static Compute(input: RubricScoreInput): RubricScoreResult;
+    private static scoreNode;
+    private static scoreLeaf;
+    private static applyGate;
+    private static hasValue;
+    private static normalize;
+    private static combine;
+    /** Sets each included sibling's share of the parent. All-zero weights share equally. */
+    private static rollupWeights;
+    private static assignContributions;
+    private static outcome;
+    private static passed;
+    /** Half-open ranges. The band whose max is 1 also contains 1. */
+    private static bandId;
+    private static confidence;
+    /** Path weight keeps going under a Minimum or Maximum group. Contribution does not. */
+    private static assignPathWeights;
+    private static assignGroupConfidence;
+    private static groupCompleteness;
+    private static leafConfidence;
+    private static flatten;
+    private static toStored;
+}
+//# sourceMappingURL=RubricScoring.d.ts.map

package/dist/RubricScoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RubricScoring.d.ts","sourceRoot":"","sources":["../src/RubricScoring.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAMR,gBAAgB,EAChB,iBAAiB,EAGpB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,sBAAsB,EAAG,KAAc,CAAC;AAErD,qFAAqF;AACrF,qBAAa,qBAAsB,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAIrC;AAuBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,aAAa;WACR,OAAO,CAAC,KAAK,EAAE,gBAAgB,GAAG,iBAAiB;IAoD7D,OAAO,CAAC,MAAM,CAAC,SAAS;IAyC5B,OAAO,CAAC,MAAM,CAAC,SAAS;IA+DxB,OAAO,CAAC,MAAM,CAAC,SAAS;IAOxB,OAAO,CAAC,MAAM,CAAC,QAAQ;IAKvB,OAAO,CAAC,MAAM,CAAC,SAAS;IAmCxB,OAAO,CAAC,MAAM,CAAC,OAAO;IAUtB,wFAAwF;IACxF,OAAO,CAAC,MAAM,CAAC,aAAa;IAiB5B,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAclC,OAAO,CAAC,MAAM,CAAC,OAAO;IAgBtB,OAAO,CAAC,MAAM,CAAC,MAAM;IAWrB,iEAAiE;IACjE,OAAO,CAAC,MAAM,CAAC,MAAM;IAIrB,OAAO,CAAC,MAAM,CAAC,UAAU;IAazB,uFAAuF;IACvF,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAahC,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAQpC,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAOhC,OAAO,CAAC,MAAM,CAAC,cAAc;IAI7B,OAAO,CAAC,MAAM,CAAC,OAAO;IAUtB,OAAO,CAAC,MAAM,CAAC,QAAQ;CAc1B"}