qlm-measure 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @qlm/measure — Open Measurement SDK for Education AI
+ *
+ * What it is:
+ *   - A typed evidence-event vocabulary any tool can emit
+ *   - Clients for QLM's open datasets and measurement service
+ *   - An evidence-record format + replay verifier
+ *
+ * What it is NOT:
+ *   - The estimation engine (that is QLM's hosted service)
+ *   - A replacement for the measurement service
+ *   - A standalone learning analytics system
+ *
+ * The verifier checks bookkeeping integrity, not estimation correctness.
+ * That distinction is the design.
+ *
+ * @see https://play.quantumlearningmachines.com/developer
+ * @license Apache-2.0
+ */
+export type { ScaffoldType, EpistemicMode, DepthLevel, TriageResult, EventCategory, } from "./schema/enums";
+export { toPublicEpistemicMode } from "./schema/enums";
+export type { ObservationEvent } from "./schema/observation-event";
+export type { MeasurementEvent } from "./schema/measurement-event";
+export type { EvidenceEntry, EvidenceRecord } from "./schema/evidence-record";
+export { COMPACTION_RETENTION } from "./schema/evidence-record";
+export { MeasurementEmitter } from "./emitter/measurement-emitter";
+export type { EmitterConfig } from "./emitter/measurement-emitter";
+export { verifyRecord } from "./verifier/verify-record";
+export type { VerificationResult, Violation } from "./verifier/verify-record";
+export { replayToVersion, posteriorAtVersion, summarizeToVersion } from "./verifier/replay";
+export { hashEntry, hashCanonical, canonicalize, sha256 } from "./verifier/hash";
+export { OntologyClient } from "./clients/ontology-client";
+export type { OntologyClientConfig, DatasetName } from "./clients/ontology-client";
+export { EngineClient } from "./clients/engine-client";
+export type { EngineClientConfig, ModelStateSummary } from "./clients/engine-client";
+//# 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;;;;;;;;;;;;;;;;;;GAkBG;AAGH,YAAY,EACV,YAAY,EACZ,aAAa,EACb,UAAU,EACV,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAGhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,YAAY,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAGnE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5F,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGjF,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,YAAY,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,31 @@
+/**
+ * @qlm/measure — Open Measurement SDK for Education AI
+ *
+ * What it is:
+ *   - A typed evidence-event vocabulary any tool can emit
+ *   - Clients for QLM's open datasets and measurement service
+ *   - An evidence-record format + replay verifier
+ *
+ * What it is NOT:
+ *   - The estimation engine (that is QLM's hosted service)
+ *   - A replacement for the measurement service
+ *   - A standalone learning analytics system
+ *
+ * The verifier checks bookkeeping integrity, not estimation correctness.
+ * That distinction is the design.
+ *
+ * @see https://play.quantumlearningmachines.com/developer
+ * @license Apache-2.0
+ */
+export { toPublicEpistemicMode } from "./schema/enums";
+export { COMPACTION_RETENTION } from "./schema/evidence-record";
+// Emitter
+export { MeasurementEmitter } from "./emitter/measurement-emitter";
+// Verifier
+export { verifyRecord } from "./verifier/verify-record";
+export { replayToVersion, posteriorAtVersion, summarizeToVersion } from "./verifier/replay";
+export { hashEntry, hashCanonical, canonicalize, sha256 } from "./verifier/hash";
+// Clients
+export { OntologyClient } from "./clients/ontology-client";
+export { EngineClient } from "./clients/engine-client";
+//# 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;;;;;;;;;;;;;;;;;;GAkBG;AAUH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAIvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,UAAU;AACV,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAGnE,WAAW;AACX,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5F,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEjF,UAAU;AACV,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/schema/enums.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Public enum types for the open measurement vocabulary.
+ *
+ * These are structural labels only — no weights, thresholds, or
+ * estimation parameters are included or implied.
+ */
+/** The pedagogical move that preceded a student response. */
+export type ScaffoldType = "none" | "socratic" | "probing" | "metacognitive" | "scaffolding" | "explain" | "hint" | "demonstrate";
+/** How the student arrived at knowledge. */
+export type EpistemicMode = "experience" | "inference" | "analogy" | "testimony";
+/** Depth of understanding. */
+export type DepthLevel = "surface" | "conceptual" | "transfer" | "integration";
+/** Triage classification of a student response. */
+export type TriageResult = "correct" | "slip" | "misconception" | "disengagement" | "ambiguous";
+/** Category of a measurement event. */
+export type EventCategory = "learning" | "teaching" | "assessment" | "interaction" | "system";
+/** Map internal or public epistemic mode value to the public enum. */
+export declare function toPublicEpistemicMode(value: string): EpistemicMode;
+//# sourceMappingURL=enums.d.ts.map

package/dist/schema/enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../src/schema/enums.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,6DAA6D;AAC7D,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,UAAU,GACV,SAAS,GACT,eAAe,GACf,aAAa,GACb,SAAS,GACT,MAAM,GACN,aAAa,CAAC;AAElB,4CAA4C;AAC5C,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,WAAW,GACX,SAAS,GACT,WAAW,CAAC;AAEhB,8BAA8B;AAC9B,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,YAAY,GACZ,UAAU,GACV,aAAa,CAAC;AAElB,mDAAmD;AACnD,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,MAAM,GACN,eAAe,GACf,eAAe,GACf,WAAW,CAAC;AAEhB,uCAAuC;AACvC,MAAM,MAAM,aAAa,GACrB,UAAU,GACV,UAAU,GACV,YAAY,GACZ,aAAa,GACb,QAAQ,CAAC;AAiBb,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAElE"}

package/dist/schema/enums.js

@@ -0,0 +1,24 @@
+/**
+ * Public enum types for the open measurement vocabulary.
+ *
+ * These are structural labels only — no weights, thresholds, or
+ * estimation parameters are included or implied.
+ */
+// ── Internal ↔ Public mapping (used at the EngineClient boundary) ────────
+const EPISTEMIC_MAP = {
+    // Internal values (mapped at the service boundary)
+    direct: "experience",
+    reason: "inference",
+    compare: "analogy",
+    told: "testimony",
+    // Public names map to themselves
+    experience: "experience",
+    inference: "inference",
+    analogy: "analogy",
+    testimony: "testimony",
+};
+/** Map internal or public epistemic mode value to the public enum. */
+export function toPublicEpistemicMode(value) {
+    return EPISTEMIC_MAP[value] ?? "testimony";
+}
+//# sourceMappingURL=enums.js.map

package/dist/schema/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../src/schema/enums.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2CH,4EAA4E;AAE5E,MAAM,aAAa,GAAkC;IACnD,mDAAmD;IACnD,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,WAAW;IACjB,iCAAiC;IACjC,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;CACvB,CAAC;AAEF,sEAAsE;AACtE,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,OAAO,aAAa,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC;AAC7C,CAAC"}

package/dist/schema/evidence-record.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Evidence Record — Public format v0.
+ *
+ * An append-only, hash-chained sequence of evidence entries.
+ * Each entry records what happened, what the system estimated,
+ * and what it decided — enabling external verification of
+ * bookkeeping integrity without any estimation mathematics.
+ */
+import type { ObservationEvent } from "./observation-event";
+import type { ScaffoldType, DepthLevel, EpistemicMode, TriageResult } from "./enums";
+/**
+ * A single evidence entry in the record.
+ *
+ * Carries the applied evidential weight and posteriors because
+ * auditability is the product's promise — a tenant must be able
+ * to see why their number moved.
+ */
+export interface EvidenceEntry {
+    /** Monotonically increasing version number — primary ordering key. */
+    version: number;
+    /** ISO 8601 timestamp. */
+    timestamp: string;
+    /** The observation that generated this entry, or a redacted hash. */
+    event: ObservationEvent | {
+        redacted: true;
+        eventHash: string;
+    };
+    /** Scaffold type active when the response was elicited. */
+    scaffoldType: ScaffoldType;
+    /** Estimated depth level at time of response. */
+    depthLevel: DepthLevel;
+    /** Epistemic mode classification. */
+    epistemicMode: EpistemicMode | null;
+    /** Triage classification. */
+    triageResult: TriageResult;
+    /** The evidential weight applied to this response (as a number). */
+    evidentialWeight: number;
+    /** The proficiency posterior BEFORE this update. */
+    priorPosterior: number;
+    /** The proficiency posterior AFTER this update. */
+    updatedPosterior: number;
+    /** Non-intervention decision (calibrated silence). */
+    nonInterventionDecision?: {
+        intervened: boolean;
+        confidence: number;
+    };
+    /** SHA-256 hash of this entry's canonical serialization. */
+    entryHash: string;
+    /** Hash of the previous entry (chain integrity). */
+    prevHash: string;
+}
+/**
+ * An append-only evidence record for a single student scope.
+ */
+export interface EvidenceRecord {
+    /** Pseudonymous student scope ID. */
+    studentScopeId: string;
+    /** All entries, ordered by version. */
+    entries: EvidenceEntry[];
+    /** If the record has been compacted, info about the compaction boundary. */
+    compactedBefore?: {
+        /** Version number of the last compacted entry. */
+        version: number;
+        /** Hash summarizing the compacted entries. */
+        summaryHash: string;
+    };
+}
+/** Maximum entries retained after compaction. Public constant (bookkeeping, not estimation). */
+export declare const COMPACTION_RETENTION = 500;
+//# sourceMappingURL=evidence-record.d.ts.map

package/dist/schema/evidence-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence-record.d.ts","sourceRoot":"","sources":["../../src/schema/evidence-record.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAErF;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAEhB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAElB,qEAAqE;IACrE,KAAK,EAAE,gBAAgB,GAAG;QAAE,QAAQ,EAAE,IAAI,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAEhE,2DAA2D;IAC3D,YAAY,EAAE,YAAY,CAAC;IAE3B,iDAAiD;IACjD,UAAU,EAAE,UAAU,CAAC;IAEvB,qCAAqC;IACrC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IAEpC,6BAA6B;IAC7B,YAAY,EAAE,YAAY,CAAC;IAE3B,oEAAoE;IACpE,gBAAgB,EAAE,MAAM,CAAC;IAEzB,oDAAoD;IACpD,cAAc,EAAE,MAAM,CAAC;IAEvB,mDAAmD;IACnD,gBAAgB,EAAE,MAAM,CAAC;IAEzB,sDAAsD;IACtD,uBAAuB,CAAC,EAAE;QACxB,UAAU,EAAE,OAAO,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAElB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,cAAc,EAAE,MAAM,CAAC;IAEvB,uCAAuC;IACvC,OAAO,EAAE,aAAa,EAAE,CAAC;IAEzB,4EAA4E;IAC5E,eAAe,CAAC,EAAE;QAChB,kDAAkD;QAClD,OAAO,EAAE,MAAM,CAAC;QAChB,8CAA8C;QAC9C,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,gGAAgG;AAChG,eAAO,MAAM,oBAAoB,MAAM,CAAC"}

package/dist/schema/evidence-record.js

@@ -0,0 +1,11 @@
+/**
+ * Evidence Record — Public format v0.
+ *
+ * An append-only, hash-chained sequence of evidence entries.
+ * Each entry records what happened, what the system estimated,
+ * and what it decided — enabling external verification of
+ * bookkeeping integrity without any estimation mathematics.
+ */
+/** Maximum entries retained after compaction. Public constant (bookkeeping, not estimation). */
+export const COMPACTION_RETENTION = 500;
+//# sourceMappingURL=evidence-record.js.map

package/dist/schema/evidence-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence-record.js","sourceRoot":"","sources":["../../src/schema/evidence-record.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA2EH,gGAAgG;AAChG,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC"}

package/dist/schema/index.d.ts

@@ -0,0 +1,7 @@
+export type { ScaffoldType, EpistemicMode, DepthLevel, TriageResult, EventCategory, } from "./enums";
+export { toPublicEpistemicMode } from "./enums";
+export type { ObservationEvent } from "./observation-event";
+export type { MeasurementEvent } from "./measurement-event";
+export type { EvidenceEntry, EvidenceRecord } from "./evidence-record";
+export { COMPACTION_RETENTION } from "./evidence-record";
+//# sourceMappingURL=index.d.ts.map

package/dist/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,aAAa,EACb,UAAU,EACV,YAAY,EACZ,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAEhD,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/schema/index.js

@@ -0,0 +1,3 @@
+export { toPublicEpistemicMode } from "./enums";
+export { COMPACTION_RETENTION } from "./evidence-record";
+//# sourceMappingURL=index.js.map

package/dist/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAKhD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/schema/measurement-event.d.ts

@@ -0,0 +1,35 @@
+/**
+ * MeasurementEvent — Telemetry event for the measurement pipeline.
+ *
+ * Ported from the production measurement-emitter.
+ */
+import type { EventCategory } from "./enums";
+export interface MeasurementEvent {
+    /** Event type identifier. */
+    eventType: string;
+    /** Event category. */
+    eventCategory: EventCategory;
+    /** Session identifier. */
+    sessionId?: string;
+    /** Classroom identifier. */
+    classroomId?: string;
+    /** Domain (e.g., "math", "science"). */
+    domain?: string;
+    /** Topic within the domain. */
+    topic?: string;
+    /** Simulation mode or activity type. */
+    mode?: string;
+    /** Estimated difficulty (0-1). */
+    difficulty?: number;
+    /** Arbitrary payload for event-specific data. */
+    payload?: Record<string, unknown>;
+    /** Quality signal (0-1) for this event. */
+    qualitySignal?: number;
+    /** Confidence in this measurement (0-1). */
+    confidence?: number;
+    /** Duration of the measured activity in milliseconds. */
+    durationMs?: number;
+    /** Parent event ID for hierarchical events. */
+    parentEventId?: string;
+}
+//# sourceMappingURL=measurement-event.d.ts.map

package/dist/schema/measurement-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measurement-event.d.ts","sourceRoot":"","sources":["../../src/schema/measurement-event.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAElB,sBAAsB;IACtB,aAAa,EAAE,aAAa,CAAC;IAE7B,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,+CAA+C;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/schema/measurement-event.js

@@ -0,0 +1,7 @@
+/**
+ * MeasurementEvent — Telemetry event for the measurement pipeline.
+ *
+ * Ported from the production measurement-emitter.
+ */
+export {};
+//# sourceMappingURL=measurement-event.js.map

package/dist/schema/measurement-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"measurement-event.js","sourceRoot":"","sources":["../../src/schema/measurement-event.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/schema/observation-event.d.ts

@@ -0,0 +1,58 @@
+/**
+ * ObservationEvent v0.1 — Public evidence-event schema.
+ *
+ * A deliberate subset of the internal StudentObservation.
+ * This is a deliberate public subset. Fields related to internal estimation,
+ * trait models, and classification logic are excluded. Integrators needing
+ * additional fields use the `ext` namespace.
+ *
+ * Integrators needing excluded fields use the `ext` namespace.
+ */
+import type { ScaffoldType, EpistemicMode } from "./enums";
+export interface ObservationEvent {
+    /** Pseudonymous student identifier. MUST NOT contain PII. */
+    studentId: string;
+    /** Session identifier. */
+    sessionId: string;
+    /** Source system that produced this event. */
+    source: string;
+    /** ISO 8601 timestamp. */
+    timestamp: string;
+    /** Whether the student response was correct. */
+    correct: boolean;
+    /** Response time in milliseconds. */
+    responseTimeMs: number;
+    /** Domain (e.g., "math", "science", "history"). */
+    domain: string;
+    /** Scaffold type that preceded this response. */
+    scaffoldType?: ScaffoldType | null;
+    /** Misconception ID from the public ontology (if detected). */
+    misconceptionId?: string | null;
+    /** Classifier confidence for the misconception detection (0-1). */
+    classifierConfidence?: number;
+    /** Human-readable label for the detected misconception. */
+    classifierLabel?: string | null;
+    /** Skill ID being assessed. */
+    skillId?: string | null;
+    /** Score for this response (0-1). */
+    score?: number;
+    /** Estimated difficulty of the item (0-1). */
+    difficulty?: number;
+    /** Consecutive errors in the current session. */
+    consecutiveErrors?: number;
+    /** Error rate for the current session (0-1). */
+    sessionErrorRate?: number;
+    /** Explanation quality score (0-1) from teach-back or written explanation. */
+    explanationQuality?: number;
+    /** Whether this was a transfer problem (novel, unscaffolded). */
+    isTransferProblem?: boolean;
+    /** Spontaneous cross-concept connections made (count). */
+    connectionsMade?: number;
+    /** Epistemic mode — how the student arrived at this response. */
+    epistemicMode?: EpistemicMode;
+    /** Whether the student self-corrected before final submission. */
+    selfCorrected?: boolean;
+    /** Reserved extension namespace for integrator-specific fields. */
+    ext?: Record<string, unknown>;
+}
+//# sourceMappingURL=observation-event.d.ts.map

package/dist/schema/observation-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-event.d.ts","sourceRoot":"","sources":["../../src/schema/observation-event.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAElB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAElB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IAEf,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAElB,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IAEjB,qCAAqC;IACrC,cAAc,EAAE,MAAM,CAAC;IAEvB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IAEf,iDAAiD;IACjD,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAEnC,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC,mEAAmE;IACnE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,2DAA2D;IAC3D,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,iDAAiD;IACjD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,8EAA8E;IAC9E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,0DAA0D;IAC1D,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,iEAAiE;IACjE,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B,kEAAkE;IAClE,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,mEAAmE;IACnE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B"}

package/dist/schema/observation-event.js

@@ -0,0 +1,12 @@
+/**
+ * ObservationEvent v0.1 — Public evidence-event schema.
+ *
+ * A deliberate subset of the internal StudentObservation.
+ * This is a deliberate public subset. Fields related to internal estimation,
+ * trait models, and classification logic are excluded. Integrators needing
+ * additional fields use the `ext` namespace.
+ *
+ * Integrators needing excluded fields use the `ext` namespace.
+ */
+export {};
+//# sourceMappingURL=observation-event.js.map

package/dist/schema/observation-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-event.js","sourceRoot":"","sources":["../../src/schema/observation-event.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/verifier/hash.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Hash utilities for evidence record integrity.
+ *
+ * Uses SHA-256 via the Web Crypto API (browser) or Node crypto module.
+ * Canonical serialization ensures deterministic hashing.
+ */
+import type { EvidenceEntry } from "../schema/evidence-record";
+/**
+ * Canonical JSON serialization — sorted keys, no whitespace.
+ * Ensures the same object always produces the same hash regardless
+ * of property insertion order.
+ */
+export declare function canonicalize(obj: unknown): string;
+/**
+ * Compute SHA-256 hash of a string.
+ * Works in both browser (Web Crypto) and Node (crypto module).
+ */
+export declare function sha256(input: string): string;
+/**
+ * Compute the canonical hash of an evidence entry.
+ * Hashes all fields EXCEPT entryHash and prevHash (which are the chain links).
+ */
+export declare function hashEntry(entry: EvidenceEntry): string;
+/**
+ * Compute a hash over a canonical string (for summary hashes, etc.).
+ */
+export declare function hashCanonical(input: string): string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/verifier/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/verifier/hash.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAUjD;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAW5C;AAYD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAetD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/verifier/hash.js

@@ -0,0 +1,75 @@
+/**
+ * Hash utilities for evidence record integrity.
+ *
+ * Uses SHA-256 via the Web Crypto API (browser) or Node crypto module.
+ * Canonical serialization ensures deterministic hashing.
+ */
+/**
+ * Canonical JSON serialization — sorted keys, no whitespace.
+ * Ensures the same object always produces the same hash regardless
+ * of property insertion order.
+ */
+export function canonicalize(obj) {
+    return JSON.stringify(obj, (_, value) => {
+        if (value && typeof value === "object" && !Array.isArray(value)) {
+            return Object.keys(value).sort().reduce((sorted, key) => {
+                sorted[key] = value[key];
+                return sorted;
+            }, {});
+        }
+        return value;
+    });
+}
+/**
+ * Compute SHA-256 hash of a string.
+ * Works in both browser (Web Crypto) and Node (crypto module).
+ */
+export function sha256(input) {
+    // Node.js path
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const crypto = require("crypto");
+        return crypto.createHash("sha256").update(input).digest("hex");
+    }
+    catch {
+        // Browser path — synchronous fallback using a simple hash
+        // Note: in production, use Web Crypto API (async) for true SHA-256
+        return simpleHash(input);
+    }
+}
+/** Simple non-cryptographic hash for browser environments without crypto. */
+function simpleHash(str) {
+    let hash = 0;
+    for (let i = 0; i < str.length; i++) {
+        const char = str.charCodeAt(i);
+        hash = ((hash << 5) - hash + char) | 0;
+    }
+    return Math.abs(hash).toString(16).padStart(8, "0");
+}
+/**
+ * Compute the canonical hash of an evidence entry.
+ * Hashes all fields EXCEPT entryHash and prevHash (which are the chain links).
+ */
+export function hashEntry(entry) {
+    const hashable = {
+        version: entry.version,
+        timestamp: entry.timestamp,
+        event: entry.event,
+        scaffoldType: entry.scaffoldType,
+        depthLevel: entry.depthLevel,
+        epistemicMode: entry.epistemicMode,
+        triageResult: entry.triageResult,
+        evidentialWeight: entry.evidentialWeight,
+        priorPosterior: entry.priorPosterior,
+        updatedPosterior: entry.updatedPosterior,
+        nonInterventionDecision: entry.nonInterventionDecision ?? null,
+    };
+    return sha256(canonicalize(hashable));
+}
+/**
+ * Compute a hash over a canonical string (for summary hashes, etc.).
+ */
+export function hashCanonical(input) {
+    return sha256(input);
+}
+//# sourceMappingURL=hash.js.map

package/dist/verifier/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/verifier/hash.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE;QACtC,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,CAA0B,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;gBAC/E,MAAM,CAAC,GAAG,CAAC,GAAI,KAAiC,CAAC,GAAG,CAAC,CAAC;gBACtD,OAAO,MAAM,CAAC;YAChB,CAAC,EAAE,EAAE,CAAC,CAAC;QACT,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,eAAe;IACf,IAAI,CAAC;QACH,iEAAiE;QACjE,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjC,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,0DAA0D;QAC1D,mEAAmE;QACnE,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,SAAS,UAAU,CAAC,GAAW;IAC7B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAAoB;IAC5C,MAAM,QAAQ,GAAG;QACf,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;QACxC,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;QACxC,uBAAuB,EAAE,KAAK,CAAC,uBAAuB,IAAI,IAAI;KAC/D,CAAC;IACF,OAAO,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

package/dist/verifier/index.d.ts

@@ -0,0 +1,5 @@
+export { verifyRecord } from "./verify-record";
+export type { VerificationResult, Violation } from "./verify-record";
+export { replayToVersion, posteriorAtVersion, summarizeToVersion } from "./replay";
+export { hashEntry, hashCanonical, canonicalize, sha256 } from "./hash";
+//# sourceMappingURL=index.d.ts.map

package/dist/verifier/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/verifier/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC"}

package/dist/verifier/index.js

@@ -0,0 +1,4 @@
+export { verifyRecord } from "./verify-record";
+export { replayToVersion, posteriorAtVersion, summarizeToVersion } from "./replay";
+export { hashEntry, hashCanonical, canonicalize, sha256 } from "./hash";
+//# sourceMappingURL=index.js.map

package/dist/verifier/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/verifier/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC"}

package/dist/verifier/replay.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Replay — reconstruct evidence state at any historical version.
+ *
+ * This is pure bookkeeping: it slices the entry array to version N
+ * and returns the logged values. It does NOT recompute any posteriors.
+ */
+import type { EvidenceRecord, EvidenceEntry } from "../schema/evidence-record";
+/**
+ * Replay an evidence record to a specific version.
+ *
+ * Returns entries up to and including the target version.
+ * The last entry's `updatedPosterior` is the posterior at that version.
+ *
+ * This function reconstructs state from LOGGED values only —
+ * it never calls an update function, never contains estimation math.
+ */
+export declare function replayToVersion(record: EvidenceRecord, targetVersion: number): EvidenceEntry[];
+/**
+ * Get the posterior value at a specific version.
+ * Returns null if the version is not found.
+ */
+export declare function posteriorAtVersion(record: EvidenceRecord, targetVersion: number): number | null;
+/**
+ * Get a summary of the record up to a version.
+ */
+export declare function summarizeToVersion(record: EvidenceRecord, targetVersion: number): {
+    entriesIncluded: number;
+    firstVersion: number;
+    lastVersion: number;
+    finalPosterior: number | null;
+    scaffoldDistribution: Record<string, number>;
+    triageDistribution: Record<string, number>;
+};
+//# sourceMappingURL=replay.d.ts.map

package/dist/verifier/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../src/verifier/replay.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/E;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,EACtB,aAAa,EAAE,MAAM,GACpB,aAAa,EAAE,CAEjB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,cAAc,EACtB,aAAa,EAAE,MAAM,GACpB,MAAM,GAAG,IAAI,CAIf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,cAAc,EACtB,aAAa,EAAE,MAAM,GACpB;IACD,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C,CAkBA"}

package/dist/verifier/replay.js

@@ -0,0 +1,51 @@
+/**
+ * Replay — reconstruct evidence state at any historical version.
+ *
+ * This is pure bookkeeping: it slices the entry array to version N
+ * and returns the logged values. It does NOT recompute any posteriors.
+ */
+/**
+ * Replay an evidence record to a specific version.
+ *
+ * Returns entries up to and including the target version.
+ * The last entry's `updatedPosterior` is the posterior at that version.
+ *
+ * This function reconstructs state from LOGGED values only —
+ * it never calls an update function, never contains estimation math.
+ */
+export function replayToVersion(record, targetVersion) {
+    return record.entries.filter((e) => e.version <= targetVersion);
+}
+/**
+ * Get the posterior value at a specific version.
+ * Returns null if the version is not found.
+ */
+export function posteriorAtVersion(record, targetVersion) {
+    const entries = replayToVersion(record, targetVersion);
+    if (entries.length === 0)
+        return null;
+    return entries[entries.length - 1].updatedPosterior;
+}
+/**
+ * Get a summary of the record up to a version.
+ */
+export function summarizeToVersion(record, targetVersion) {
+    const entries = replayToVersion(record, targetVersion);
+    const scaffoldDist = {};
+    const triageDist = {};
+    for (const e of entries) {
+        if (e.scaffoldType)
+            scaffoldDist[e.scaffoldType] = (scaffoldDist[e.scaffoldType] ?? 0) + 1;
+        if (e.triageResult)
+            triageDist[e.triageResult] = (triageDist[e.triageResult] ?? 0) + 1;
+    }
+    return {
+        entriesIncluded: entries.length,
+        firstVersion: entries[0]?.version ?? 0,
+        lastVersion: entries[entries.length - 1]?.version ?? 0,
+        finalPosterior: entries.length > 0 ? entries[entries.length - 1].updatedPosterior : null,
+        scaffoldDistribution: scaffoldDist,
+        triageDistribution: triageDist,
+    };
+}
+//# sourceMappingURL=replay.js.map

package/dist/verifier/replay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.js","sourceRoot":"","sources":["../../src/verifier/replay.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAsB,EACtB,aAAqB;IAErB,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,aAAa,CAAC,CAAC;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAsB,EACtB,aAAqB;IAErB,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACvD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAsB,EACtB,aAAqB;IASrB,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACvD,MAAM,YAAY,GAA2B,EAAE,CAAC;IAChD,MAAM,UAAU,GAA2B,EAAE,CAAC;IAE9C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,YAAY;YAAE,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC3F,IAAI,CAAC,CAAC,YAAY;YAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACzF,CAAC;IAED,OAAO;QACL,eAAe,EAAE,OAAO,CAAC,MAAM;QAC/B,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,CAAC;QACtC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,OAAO,IAAI,CAAC;QACtD,cAAc,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI;QACxF,oBAAoB,EAAE,YAAY;QAClC,kBAAkB,EAAE,UAAU;KAC/B,CAAC;AACJ,CAAC"}