learngraph 0.5.0 → 0.7.0

package/dist/cjs/assessment/bkt.js

@@ -0,0 +1,362 @@
+"use strict";
+/**
+ * Bayesian Knowledge Tracing (BKT)
+ *
+ * Implements the classic BKT model for tracking learner mastery.
+ * BKT is a hidden Markov model with two hidden states (mastery/no mastery)
+ * and uses four parameters:
+ * - P(L₀): Prior probability of mastery (pInit)
+ * - P(T): Probability of learning/transition (pLearn)
+ * - P(S): Probability of slip (wrong despite mastery) (pSlip)
+ * - P(G): Probability of guess (correct despite no mastery) (pGuess)
+ *
+ * @see Corbett & Anderson (1994). Knowledge tracing: Modeling the acquisition
+ *      of procedural knowledge. User Modeling and User-Adapted Interaction.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BKTEngine = exports.BKT_CONFIG_DEFAULTS = void 0;
+exports.fitBKTParameters = fitBKTParameters;
+exports.calculateLogLikelihood = calculateLogLikelihood;
+exports.createBKTEngine = createBKTEngine;
+exports.estimateMastery = estimateMastery;
+const assessment_js_1 = require("../types/assessment.js");
+/**
+ * Default BKT configuration
+ */
+exports.BKT_CONFIG_DEFAULTS = {
+    masteryThreshold: 0.95,
+    individualizedParams: false,
+    trackHistory: false,
+};
+/**
+ * Bayesian Knowledge Tracing Engine
+ *
+ * Tracks learner mastery using the classic BKT model.
+ * Can be used with skill-level or global parameters.
+ *
+ * @example
+ * ```typescript
+ * const bkt = new BKTEngine();
+ *
+ * // Initialize state for a skill
+ * let state = bkt.initializeState('skill-1');
+ *
+ * // Update after correct response
+ * state = bkt.update(state, true).state;
+ * console.log(`Mastery: ${state.pMastery.toFixed(2)}`);
+ *
+ * // Update after incorrect response
+ * state = bkt.update(state, false).state;
+ * ```
+ */
+class BKTEngine {
+    config;
+    skillParams;
+    globalParams;
+    constructor(config = {}, globalParams = assessment_js_1.BKT_DEFAULTS) {
+        this.config = { ...exports.BKT_CONFIG_DEFAULTS, ...config };
+        this.globalParams = globalParams;
+        this.skillParams = new Map();
+    }
+    /**
+     * Set parameters for a specific skill
+     */
+    setSkillParameters(skillId, params) {
+        this.skillParams.set(skillId, params);
+    }
+    /**
+     * Get parameters for a skill (falls back to global)
+     */
+    getParameters(skillId) {
+        if (skillId && this.config.individualizedParams) {
+            return this.skillParams.get(skillId) ?? this.globalParams;
+        }
+        return this.globalParams;
+    }
+    /**
+     * Initialize BKT state for a skill
+     */
+    initializeState(skillId) {
+        const params = this.getParameters(skillId);
+        const baseState = {
+            skillId,
+            pMastery: params.pInit,
+            observations: 0,
+        };
+        if (this.config.trackHistory) {
+            baseState.history = [];
+        }
+        return baseState;
+    }
+    /**
+     * Update BKT state based on an observed response
+     *
+     * Uses Bayes' theorem to update the mastery probability:
+     * - For correct response: P(Lₙ|correct) ∝ P(correct|Lₙ) × P(Lₙ)
+     * - For incorrect response: P(Lₙ|incorrect) ∝ P(incorrect|Lₙ) × P(Lₙ)
+     *
+     * Then applies the learning transition.
+     *
+     * @param state - Current BKT state
+     * @param correct - Whether the response was correct
+     * @param skillId - Optional skill ID for skill-specific parameters
+     * @returns Updated state and result information
+     */
+    update(state, correct, skillId) {
+        const params = this.getParameters(skillId ?? state.skillId);
+        const previousMastery = state.pMastery;
+        // Calculate likelihood of observation given each hidden state
+        // P(correct | mastered) = 1 - P(slip)
+        // P(correct | not mastered) = P(guess)
+        const pCorrectGivenMastery = 1 - params.pSlip;
+        const pCorrectGivenNoMastery = params.pGuess;
+        // Calculate posterior probability of mastery given observation
+        let pMasteryGivenObs;
+        let likelihood;
+        if (correct) {
+            // P(L|correct) = P(correct|L) × P(L) / P(correct)
+            const pCorrect = pCorrectGivenMastery * state.pMastery +
+                pCorrectGivenNoMastery * (1 - state.pMastery);
+            pMasteryGivenObs = (pCorrectGivenMastery * state.pMastery) / pCorrect;
+            likelihood = pCorrect;
+        }
+        else {
+            // P(L|incorrect) = P(incorrect|L) × P(L) / P(incorrect)
+            const pIncorrect = params.pSlip * state.pMastery +
+                (1 - params.pGuess) * (1 - state.pMastery);
+            pMasteryGivenObs = (params.pSlip * state.pMastery) / pIncorrect;
+            likelihood = pIncorrect;
+        }
+        // Apply learning transition: P(Lₙ₊₁) = P(Lₙ|obs) + P(T) × (1 - P(Lₙ|obs))
+        // This accounts for the possibility of learning during the opportunity
+        const pMastery = pMasteryGivenObs + params.pLearn * (1 - pMasteryGivenObs);
+        // Build updated state
+        const newState = {
+            skillId: state.skillId,
+            pMastery,
+            observations: state.observations + 1,
+        };
+        if (this.config.trackHistory) {
+            newState.history = [...(state.history ?? []), correct];
+        }
+        const result = {
+            pMastery,
+            isMastered: pMastery >= this.config.masteryThreshold,
+            likelihood,
+            previousMastery,
+        };
+        return { state: newState, result };
+    }
+    /**
+     * Update from multiple responses
+     */
+    updateBatch(state, responses, skillId) {
+        let currentState = state;
+        const results = [];
+        for (const correct of responses) {
+            const { state: newState, result } = this.update(currentState, correct, skillId);
+            currentState = newState;
+            results.push(result);
+        }
+        return { state: currentState, results };
+    }
+    /**
+     * Predict the probability of a correct response
+     */
+    predict(state, skillId) {
+        const params = this.getParameters(skillId ?? state.skillId);
+        // P(correct) = P(correct|mastered) × P(mastered) + P(correct|not mastered) × P(not mastered)
+        const pCorrect = (1 - params.pSlip) * state.pMastery +
+            params.pGuess * (1 - state.pMastery);
+        // What would mastery be after correct/incorrect?
+        const { state: stateIfCorrect } = this.update({ ...state }, true, skillId);
+        const { state: stateIfIncorrect } = this.update({ ...state }, false, skillId);
+        return {
+            pCorrect,
+            masteryIfCorrect: stateIfCorrect.pMastery,
+            masteryIfIncorrect: stateIfIncorrect.pMastery,
+        };
+    }
+    /**
+     * Estimate number of opportunities until mastery
+     *
+     * Uses a forward simulation assuming consistent correct responses.
+     */
+    estimateOpportunitiesToMastery(state, skillId, maxOpportunities = 100) {
+        if (state.pMastery >= this.config.masteryThreshold) {
+            return 0;
+        }
+        let currentState = { ...state };
+        for (let i = 1; i <= maxOpportunities; i++) {
+            // Simulate correct response
+            const { state: newState } = this.update(currentState, true, skillId);
+            if (newState.pMastery >= this.config.masteryThreshold) {
+                return i;
+            }
+            currentState = newState;
+        }
+        return null; // Mastery not achievable within max opportunities
+    }
+    /**
+     * Check if mastery threshold is met
+     */
+    isMastered(state) {
+        return state.pMastery >= this.config.masteryThreshold;
+    }
+    /**
+     * Convert BKT state to MasteryState for integration with other systems
+     */
+    toMasteryState(state) {
+        return {
+            skillId: state.skillId,
+            mastery: state.pMastery,
+            attempts: state.observations,
+            streak: this.calculateStreak(state),
+        };
+    }
+    /**
+     * Calculate current streak from history
+     */
+    calculateStreak(state) {
+        if (!state.history || state.history.length === 0) {
+            return 0;
+        }
+        let streak = 0;
+        for (let i = state.history.length - 1; i >= 0; i--) {
+            if (state.history[i]) {
+                streak++;
+            }
+            else {
+                break;
+            }
+        }
+        return streak;
+    }
+}
+exports.BKTEngine = BKTEngine;
+/**
+ * Fit BKT parameters to response data
+ *
+ * @param sequences - Array of response sequences (true = correct)
+ * @param gridSize - Number of values to try for each parameter
+ * @returns Best fitting parameters
+ *
+ * @example
+ * ```typescript
+ * const sequences = [
+ *   [false, false, true, true, true],
+ *   [true, false, true, true, true],
+ *   [false, true, true, true, true],
+ * ];
+ *
+ * const result = fitBKTParameters(sequences);
+ * console.log('Best parameters:', result.params);
+ * ```
+ */
+function fitBKTParameters(sequences, gridSize = 10) {
+    // Generate grid values
+    const values = Array.from({ length: gridSize }, (_, i) => (i + 1) / (gridSize + 1));
+    // Constraints on parameters
+    const pInitValues = values.filter((v) => v >= 0.1 && v <= 0.9);
+    const pLearnValues = values.filter((v) => v >= 0.01 && v <= 0.5);
+    const pSlipValues = values.filter((v) => v >= 0.01 && v <= 0.3);
+    const pGuessValues = values.filter((v) => v >= 0.01 && v <= 0.4);
+    let bestParams = assessment_js_1.BKT_DEFAULTS;
+    let bestLogLikelihood = -Infinity;
+    let evaluations = 0;
+    // Grid search
+    for (const pInit of pInitValues) {
+        for (const pLearn of pLearnValues) {
+            for (const pSlip of pSlipValues) {
+                for (const pGuess of pGuessValues) {
+                    // Skip invalid combinations (guess + slip should be < 1 for identifiability)
+                    if (pSlip + pGuess >= 1)
+                        continue;
+                    const params = { pInit, pLearn, pSlip, pGuess };
+                    const logLikelihood = calculateLogLikelihood(sequences, params);
+                    evaluations++;
+                    if (logLikelihood > bestLogLikelihood) {
+                        bestLogLikelihood = logLikelihood;
+                        bestParams = params;
+                    }
+                }
+            }
+        }
+    }
+    return {
+        params: bestParams,
+        logLikelihood: bestLogLikelihood,
+        evaluations,
+    };
+}
+/**
+ * Calculate log-likelihood of response sequences given BKT parameters
+ */
+function calculateLogLikelihood(sequences, params) {
+    let totalLogLikelihood = 0;
+    for (const sequence of sequences) {
+        let pMastery = params.pInit;
+        for (const correct of sequence) {
+            // P(correct | state)
+            const pCorrectGivenMastery = 1 - params.pSlip;
+            const pCorrectGivenNoMastery = params.pGuess;
+            // P(observation)
+            const pObs = correct
+                ? pCorrectGivenMastery * pMastery + pCorrectGivenNoMastery * (1 - pMastery)
+                : params.pSlip * pMastery + (1 - params.pGuess) * (1 - pMastery);
+            // Avoid log(0)
+            totalLogLikelihood += Math.log(Math.max(pObs, 1e-10));
+            // Update mastery
+            if (correct) {
+                const pCorrect = pCorrectGivenMastery * pMastery +
+                    pCorrectGivenNoMastery * (1 - pMastery);
+                pMastery = (pCorrectGivenMastery * pMastery) / pCorrect;
+            }
+            else {
+                const pIncorrect = params.pSlip * pMastery + (1 - params.pGuess) * (1 - pMastery);
+                pMastery = (params.pSlip * pMastery) / pIncorrect;
+            }
+            // Learning transition
+            pMastery = pMastery + params.pLearn * (1 - pMastery);
+        }
+    }
+    return totalLogLikelihood;
+}
+/**
+ * Create a BKT engine with default configuration
+ */
+function createBKTEngine(config, params) {
+    return new BKTEngine(config, params);
+}
+/**
+ * Quick mastery estimation using BKT
+ *
+ * Convenience function for simple use cases.
+ *
+ * @param responses - Sequence of correct/incorrect responses
+ * @param params - BKT parameters (optional, uses defaults)
+ * @returns Final mastery probability
+ */
+function estimateMastery(responses, params = assessment_js_1.BKT_DEFAULTS) {
+    let pMastery = params.pInit;
+    for (const correct of responses) {
+        const pCorrectGivenMastery = 1 - params.pSlip;
+        const pCorrectGivenNoMastery = params.pGuess;
+        // Posterior
+        if (correct) {
+            const pCorrect = pCorrectGivenMastery * pMastery +
+                pCorrectGivenNoMastery * (1 - pMastery);
+            pMastery = (pCorrectGivenMastery * pMastery) / pCorrect;
+        }
+        else {
+            const pIncorrect = params.pSlip * pMastery + (1 - params.pGuess) * (1 - pMastery);
+            pMastery = (params.pSlip * pMastery) / pIncorrect;
+        }
+        // Learning transition
+        pMastery = pMastery + params.pLearn * (1 - pMastery);
+    }
+    return pMastery;
+}
+//# sourceMappingURL=bkt.js.map

package/dist/cjs/assessment/bkt.js.map

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

package/dist/cjs/assessment/index.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * Assessment Framework
+ *
+ * This module provides comprehensive assessment capabilities:
+ * - Bayesian Knowledge Tracing (BKT) for skill-level mastery
+ * - Item Response Theory (IRT) for ability estimation
+ * - Unified mastery estimation engine
+ * - Adaptive testing with intelligent item selection
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TERMINATION_DEFAULTS = exports.ADAPTIVE_DEFAULTS = exports.createQuestionPool = exports.createAdaptiveEngine = exports.AdaptiveEngine = exports.MASTERY_ENGINE_DEFAULTS = exports.createMasteryEngine = exports.MasteryEngine = exports.IRT_CONFIG_DEFAULTS = exports.estimateAbility = exports.abilityToGradeLevel = exports.abilityToPercentile = exports.selectNextItemMFI = exports.calculateStandardError = exports.calculateTestInformation = exports.calculateInformation = exports.calculateProbabilityDerivative = exports.calculateProbability = exports.createIRTEstimator = exports.IRTEstimator = exports.BKT_CONFIG_DEFAULTS = exports.estimateMastery = exports.calculateLogLikelihood = exports.fitBKTParameters = exports.createBKTEngine = exports.BKTEngine = exports.BKT_DEFAULTS = exports.createResponseId = exports.createAssessmentId = exports.createQuestionId = void 0;
+var assessment_js_1 = require("../types/assessment.js");
+Object.defineProperty(exports, "createQuestionId", { enumerable: true, get: function () { return assessment_js_1.createQuestionId; } });
+Object.defineProperty(exports, "createAssessmentId", { enumerable: true, get: function () { return assessment_js_1.createAssessmentId; } });
+Object.defineProperty(exports, "createResponseId", { enumerable: true, get: function () { return assessment_js_1.createResponseId; } });
+Object.defineProperty(exports, "BKT_DEFAULTS", { enumerable: true, get: function () { return assessment_js_1.BKT_DEFAULTS; } });
+// Bayesian Knowledge Tracing
+var bkt_js_1 = require("./bkt.js");
+Object.defineProperty(exports, "BKTEngine", { enumerable: true, get: function () { return bkt_js_1.BKTEngine; } });
+Object.defineProperty(exports, "createBKTEngine", { enumerable: true, get: function () { return bkt_js_1.createBKTEngine; } });
+Object.defineProperty(exports, "fitBKTParameters", { enumerable: true, get: function () { return bkt_js_1.fitBKTParameters; } });
+Object.defineProperty(exports, "calculateLogLikelihood", { enumerable: true, get: function () { return bkt_js_1.calculateLogLikelihood; } });
+Object.defineProperty(exports, "estimateMastery", { enumerable: true, get: function () { return bkt_js_1.estimateMastery; } });
+Object.defineProperty(exports, "BKT_CONFIG_DEFAULTS", { enumerable: true, get: function () { return bkt_js_1.BKT_CONFIG_DEFAULTS; } });
+// Item Response Theory
+var irt_js_1 = require("./irt.js");
+Object.defineProperty(exports, "IRTEstimator", { enumerable: true, get: function () { return irt_js_1.IRTEstimator; } });
+Object.defineProperty(exports, "createIRTEstimator", { enumerable: true, get: function () { return irt_js_1.createIRTEstimator; } });
+Object.defineProperty(exports, "calculateProbability", { enumerable: true, get: function () { return irt_js_1.calculateProbability; } });
+Object.defineProperty(exports, "calculateProbabilityDerivative", { enumerable: true, get: function () { return irt_js_1.calculateProbabilityDerivative; } });
+Object.defineProperty(exports, "calculateInformation", { enumerable: true, get: function () { return irt_js_1.calculateInformation; } });
+Object.defineProperty(exports, "calculateTestInformation", { enumerable: true, get: function () { return irt_js_1.calculateTestInformation; } });
+Object.defineProperty(exports, "calculateStandardError", { enumerable: true, get: function () { return irt_js_1.calculateStandardError; } });
+Object.defineProperty(exports, "selectNextItemMFI", { enumerable: true, get: function () { return irt_js_1.selectNextItemMFI; } });
+Object.defineProperty(exports, "abilityToPercentile", { enumerable: true, get: function () { return irt_js_1.abilityToPercentile; } });
+Object.defineProperty(exports, "abilityToGradeLevel", { enumerable: true, get: function () { return irt_js_1.abilityToGradeLevel; } });
+Object.defineProperty(exports, "estimateAbility", { enumerable: true, get: function () { return irt_js_1.estimateAbility; } });
+Object.defineProperty(exports, "IRT_CONFIG_DEFAULTS", { enumerable: true, get: function () { return irt_js_1.IRT_CONFIG_DEFAULTS; } });
+// Mastery Engine
+var mastery_engine_js_1 = require("./mastery-engine.js");
+Object.defineProperty(exports, "MasteryEngine", { enumerable: true, get: function () { return mastery_engine_js_1.MasteryEngine; } });
+Object.defineProperty(exports, "createMasteryEngine", { enumerable: true, get: function () { return mastery_engine_js_1.createMasteryEngine; } });
+Object.defineProperty(exports, "MASTERY_ENGINE_DEFAULTS", { enumerable: true, get: function () { return mastery_engine_js_1.MASTERY_ENGINE_DEFAULTS; } });
+// Adaptive Testing
+var adaptive_js_1 = require("./adaptive.js");
+Object.defineProperty(exports, "AdaptiveEngine", { enumerable: true, get: function () { return adaptive_js_1.AdaptiveEngine; } });
+Object.defineProperty(exports, "createAdaptiveEngine", { enumerable: true, get: function () { return adaptive_js_1.createAdaptiveEngine; } });
+Object.defineProperty(exports, "createQuestionPool", { enumerable: true, get: function () { return adaptive_js_1.createQuestionPool; } });
+Object.defineProperty(exports, "ADAPTIVE_DEFAULTS", { enumerable: true, get: function () { return adaptive_js_1.ADAPTIVE_DEFAULTS; } });
+Object.defineProperty(exports, "TERMINATION_DEFAULTS", { enumerable: true, get: function () { return adaptive_js_1.TERMINATION_DEFAULTS; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/assessment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/assessment/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AA4CH,wDAKgC;AAJ9B,iHAAA,gBAAgB,OAAA;AAChB,mHAAA,kBAAkB,OAAA;AAClB,iHAAA,gBAAgB,OAAA;AAChB,6GAAA,YAAY,OAAA;AAGd,6BAA6B;AAC7B,mCAUkB;AAThB,mGAAA,SAAS,OAAA;AACT,yGAAA,eAAe,OAAA;AACf,0GAAA,gBAAgB,OAAA;AAChB,gHAAA,sBAAsB,OAAA;AACtB,yGAAA,eAAe,OAAA;AACf,6GAAA,mBAAmB,OAAA;AAMrB,uBAAuB;AACvB,mCAckB;AAbhB,sGAAA,YAAY,OAAA;AACZ,4GAAA,kBAAkB,OAAA;AAClB,8GAAA,oBAAoB,OAAA;AACpB,wHAAA,8BAA8B,OAAA;AAC9B,8GAAA,oBAAoB,OAAA;AACpB,kHAAA,wBAAwB,OAAA;AACxB,gHAAA,sBAAsB,OAAA;AACtB,2GAAA,iBAAiB,OAAA;AACjB,6GAAA,mBAAmB,OAAA;AACnB,6GAAA,mBAAmB,OAAA;AACnB,yGAAA,eAAe,OAAA;AACf,6GAAA,mBAAmB,OAAA;AAIrB,iBAAiB;AACjB,yDAO6B;AAN3B,kHAAA,aAAa,OAAA;AACb,wHAAA,mBAAmB,OAAA;AACnB,4HAAA,uBAAuB,OAAA;AAMzB,mBAAmB;AACnB,6CAQuB;AAPrB,6GAAA,cAAc,OAAA;AACd,mHAAA,oBAAoB,OAAA;AACpB,iHAAA,kBAAkB,OAAA;AAClB,gHAAA,iBAAiB,OAAA;AACjB,mHAAA,oBAAoB,OAAA"}