learngraph 0.4.0 → 0.7.0

package/dist/cjs/query/spaced-repetition.js.map

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

package/dist/cjs/query/zpd.js

@@ -0,0 +1,216 @@
+"use strict";
+/**
+ * Zone of Proximal Development (ZPD) Calculator
+ *
+ * Implements Vygotsky's Zone of Proximal Development theory to identify
+ * skills that are "just right" for a learner - challenging but achievable.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZPDCalculator = exports.ZPD_DEFAULTS = void 0;
+exports.createZPDCalculator = createZPDCalculator;
+/**
+ * Default options for ZPD calculation
+ */
+exports.ZPD_DEFAULTS = {
+    difficultyTolerance: 0.2,
+    prioritizeThresholdConcepts: true,
+    maxResults: 50,
+};
+/**
+ * ZPD Calculator
+ *
+ * Calculates the Zone of Proximal Development for a learner based on:
+ * 1. Current mastery states
+ * 2. Prerequisite graph structure
+ * 3. Skill difficulty levels
+ *
+ * A skill is in the ZPD if:
+ * - All prerequisites are mastered
+ * - The skill is not yet mastered
+ * - The skill difficulty is within tolerance of learner ability
+ */
+class ZPDCalculator {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /**
+     * Calculate ZPD for a learner
+     *
+     * @param learner - Learner profile with mastery states
+     * @param options - Calculation options
+     * @returns ZPD result with ready skills and blocked skills
+     *
+     * @example
+     * ```typescript
+     * const calculator = new ZPDCalculator(storage);
+     *
+     * const learner = {
+     *   masteryStates: new Map([
+     *     ['skill-1', { skillId: 'skill-1', mastery: 0.9, ... }],
+     *     ['skill-2', { skillId: 'skill-2', mastery: 0.3, ... }],
+     *   ])
+     * };
+     *
+     * const zpd = await calculator.calculate(learner);
+     * console.log('Ready to learn:', zpd.ready.map(s => s.name));
+     * ```
+     */
+    async calculate(learner, options = {}) {
+        const opts = { ...exports.ZPD_DEFAULTS, ...options };
+        // Get all skills from storage
+        let allSkills = await this.storage.findSkills({});
+        // Apply filters
+        if (opts.filterTags && opts.filterTags.length > 0) {
+            allSkills = allSkills.filter((skill) => opts.filterTags.some((tag) => skill.tags.includes(tag)));
+        }
+        if (opts.filterDomain) {
+            allSkills = allSkills.filter((skill) => skill.metadata?.domain === opts.filterDomain);
+        }
+        // Calculate learner ability level if not provided
+        const abilityLevel = learner.abilityLevel ?? this.calculateAbilityLevel(learner);
+        // Categorize skills
+        const zpd = [];
+        const ready = [];
+        const blocked = new Map();
+        let masteredCount = 0;
+        for (const skill of allSkills) {
+            const mastery = learner.masteryStates.get(skill.id);
+            const masteryLevel = mastery?.mastery ?? 0;
+            // Check if already mastered
+            if (masteryLevel >= skill.masteryThreshold) {
+                masteredCount++;
+                continue;
+            }
+            // Get prerequisites
+            const prerequisites = await this.storage.getPrerequisitesOf(skill.id);
+            const unmetPrereqs = [];
+            for (const prereq of prerequisites) {
+                const prereqMastery = learner.masteryStates.get(prereq.id);
+                const prereqLevel = prereqMastery?.mastery ?? 0;
+                if (prereqLevel < prereq.masteryThreshold) {
+                    unmetPrereqs.push(prereq.name);
+                }
+            }
+            if (unmetPrereqs.length > 0) {
+                // Skill is blocked
+                blocked.set(skill.id, unmetPrereqs);
+            }
+            else {
+                // Skill is in ZPD (prerequisites met, not yet mastered)
+                zpd.push(skill);
+                // Check if within difficulty tolerance
+                const difficultyDelta = skill.difficulty - abilityLevel;
+                if (difficultyDelta <= opts.difficultyTolerance) {
+                    ready.push(skill);
+                }
+            }
+        }
+        // Sort ready skills by priority
+        this.sortByPriority(ready, opts.prioritizeThresholdConcepts);
+        // Limit results
+        const limitedReady = opts.maxResults ? ready.slice(0, opts.maxResults) : ready;
+        const limitedZpd = opts.maxResults ? zpd.slice(0, opts.maxResults) : zpd;
+        return {
+            zpd: limitedZpd,
+            ready: limitedReady,
+            blocked,
+            stats: {
+                totalSkills: allSkills.length,
+                mastered: masteredCount,
+                inZPD: zpd.length,
+                blocked: blocked.size,
+            },
+        };
+    }
+    /**
+     * Get the next recommended skill to learn
+     *
+     * @param learner - Learner profile
+     * @param options - ZPD options
+     * @returns The highest priority skill to learn next, or null if none available
+     */
+    async getNextSkill(learner, options = {}) {
+        const zpd = await this.calculate(learner, { ...options, maxResults: 1 });
+        return zpd.ready[0] ?? zpd.zpd[0] ?? null;
+    }
+    /**
+     * Check if a specific skill is in the learner's ZPD
+     *
+     * @param skillId - Skill to check
+     * @param learner - Learner profile
+     * @returns Object with inZPD status and blocking prerequisites if any
+     */
+    async isInZPD(skillId, learner) {
+        const skill = await this.storage.getSkill(skillId);
+        if (!skill) {
+            return { inZPD: false, blocking: ['Skill not found'] };
+        }
+        // Check if already mastered
+        const mastery = learner.masteryStates.get(skillId);
+        if (mastery && mastery.mastery >= skill.masteryThreshold) {
+            return { inZPD: false, blocking: [] };
+        }
+        // Check prerequisites
+        const prerequisites = await this.storage.getPrerequisitesOf(skillId);
+        const blocking = [];
+        for (const prereq of prerequisites) {
+            const prereqMastery = learner.masteryStates.get(prereq.id);
+            const prereqLevel = prereqMastery?.mastery ?? 0;
+            if (prereqLevel < prereq.masteryThreshold) {
+                blocking.push(prereq.name);
+            }
+        }
+        return {
+            inZPD: blocking.length === 0,
+            blocking,
+        };
+    }
+    /**
+     * Calculate learner ability level from mastery states
+     */
+    calculateAbilityLevel(learner) {
+        if (learner.masteryStates.size === 0) {
+            return 0.3; // Default starting ability
+        }
+        let totalWeighted = 0;
+        let totalWeight = 0;
+        for (const state of learner.masteryStates.values()) {
+            // Weight by mastery level (higher mastery = more confident estimate)
+            const weight = state.mastery;
+            totalWeighted += state.mastery * weight;
+            totalWeight += weight;
+        }
+        return totalWeight > 0 ? totalWeighted / totalWeight : 0.3;
+    }
+    /**
+     * Sort skills by learning priority
+     */
+    sortByPriority(skills, prioritizeThreshold) {
+        skills.sort((a, b) => {
+            // Threshold concepts first (if enabled)
+            if (prioritizeThreshold) {
+                if (a.isThresholdConcept && !b.isThresholdConcept)
+                    return -1;
+                if (!a.isThresholdConcept && b.isThresholdConcept)
+                    return 1;
+            }
+            // Then by difficulty (easier first for progressive learning)
+            if (a.difficulty !== b.difficulty) {
+                return a.difficulty - b.difficulty;
+            }
+            // Finally by estimated time (shorter first)
+            return a.estimatedMinutes - b.estimatedMinutes;
+        });
+    }
+}
+exports.ZPDCalculator = ZPDCalculator;
+/**
+ * Create a ZPD calculator
+ */
+function createZPDCalculator(storage) {
+    return new ZPDCalculator(storage);
+}
+//# sourceMappingURL=zpd.js.map

package/dist/cjs/query/zpd.js.map

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

package/dist/cjs/types/assessment.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * Assessment Types
+ *
+ * Comprehensive type definitions for the assessment framework including:
+ * - Question types (multiple choice, free response, etc.)
+ * - Assessment structures
+ * - Item Response Theory (IRT) parameters
+ * - Bayesian Knowledge Tracing (BKT) parameters
+ * - Evidence of learning
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BKT_DEFAULTS = void 0;
+exports.createQuestionId = createQuestionId;
+exports.createAssessmentId = createAssessmentId;
+exports.createResponseId = createResponseId;
+/**
+ * Create a typed QuestionId from a string
+ */
+function createQuestionId(id) {
+    return id;
+}
+/**
+ * Create a typed AssessmentId from a string
+ */
+function createAssessmentId(id) {
+    return id;
+}
+/**
+ * Create a typed ResponseId from a string
+ */
+function createResponseId(id) {
+    return id;
+}
+/**
+ * Default BKT parameters (empirically derived)
+ */
+exports.BKT_DEFAULTS = {
+    pInit: 0.3, // 30% prior mastery
+    pLearn: 0.1, // 10% chance to learn per opportunity
+    pSlip: 0.1, // 10% slip rate
+    pGuess: 0.2, // 20% guess rate
+};
+//# sourceMappingURL=assessment.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assessment.js","sourceRoot":"","sources":["../../../src/types/assessment.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAiBH,4CAEC;AAsGD,gDAEC;AAkGD,4CAEC;AAjND;;GAEG;AACH,SAAgB,gBAAgB,CAAC,EAAU;IACzC,OAAO,EAAgB,CAAC;AAC1B,CAAC;AAmGD;;GAEG;AACH,SAAgB,kBAAkB,CAAC,EAAU;IAC3C,OAAO,EAAkB,CAAC;AAC5B,CAAC;AA+FD;;GAEG;AACH,SAAgB,gBAAgB,CAAC,EAAU;IACzC,OAAO,EAAgB,CAAC;AAC1B,CAAC;AAwJD;;GAEG;AACU,QAAA,YAAY,GAAkB;IACzC,KAAK,EAAE,GAAG,EAAK,oBAAoB;IACnC,MAAM,EAAE,GAAG,EAAI,sCAAsC;IACrD,KAAK,EAAE,GAAG,EAAK,gBAAgB;IAC/B,MAAM,EAAE,GAAG,EAAI,iBAAiB;CACjC,CAAC"}

package/dist/cjs/types/bloom.js

@@ -1,9 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BLOOM_VERBS = exports.BLOOM_LEVEL_ORDER = void 0;
+exports.BLOOM_VERBS = exports.BLOOM_LEVEL_ORDER = exports.BLOOM_LEVELS = void 0;
 exports.detectBloomLevel = detectBloomLevel;
 exports.compareBloomLevels = compareBloomLevels;
 exports.meetsBloomThreshold = meetsBloomThreshold;
+/**
+ * All Bloom's levels as an ordered array
+ */
+exports.BLOOM_LEVELS = [
+    'remember',
+    'understand',
+    'apply',
+    'analyze',
+    'evaluate',
+    'create',
+];
 /**
  * Numeric mapping for Bloom's levels (1-6 scale)
  */

package/dist/cjs/types/bloom.js.map

@@ -1 +1 @@
-{"version":3,"file":"bloom.js","sourceRoot":"","sources":["../../../src/types/bloom.ts"],"names":[],"mappings":";;;AAoJA,4CA4BC;AAMD,gDAEC;AAKD,kDAEC;AA/KD;;GAEG;AACU,QAAA,iBAAiB,GAA+B;IAC3D,QAAQ,EAAE,CAAC;IACX,UAAU,EAAE,CAAC;IACb,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,CAAC;IACX,MAAM,EAAE,CAAC;CACD,CAAC;AAEX;;;GAGG;AACU,QAAA,WAAW,GAA0C;IAChE,QAAQ,EAAE;QACR,QAAQ;QACR,UAAU;QACV,UAAU;QACV,OAAO;QACP,MAAM;QACN,OAAO;QACP,MAAM;QACN,SAAS;QACT,QAAQ;QACR,WAAW;QACX,WAAW;QACX,QAAQ;QACR,OAAO;QACP,UAAU;QACV,QAAQ;KACT;IACD,UAAU,EAAE;QACV,UAAU;QACV,SAAS;QACT,UAAU;QACV,aAAa;QACb,SAAS;QACT,QAAQ;QACR,YAAY;QACZ,OAAO;QACP,WAAW;QACX,YAAY;QACZ,SAAS;QACT,WAAW;QACX,WAAW;QACX,SAAS;QACT,aAAa;KACd;IACD,KAAK,EAAE;QACL,OAAO;QACP,WAAW;QACX,QAAQ;QACR,UAAU;QACV,SAAS;QACT,WAAW;QACX,aAAa;QACb,UAAU;QACV,YAAY;QACZ,QAAQ;QACR,SAAS;QACT,SAAS;QACT,SAAS;QACT,SAAS;QACT,OAAO;QACP,KAAK;QACL,WAAW;QACX,SAAS;KACV;IACD,OAAO,EAAE;QACP,SAAS;QACT,YAAY;QACZ,YAAY;QACZ,SAAS;QACT,UAAU;QACV,aAAa;QACb,eAAe;QACf,cAAc;QACd,aAAa;QACb,SAAS;QACT,YAAY;QACZ,UAAU;QACV,OAAO;QACP,UAAU;QACV,MAAM;QACN,aAAa;KACd;IACD,QAAQ,EAAE;QACR,UAAU;QACV,OAAO;QACP,QAAQ;QACR,QAAQ;QACR,UAAU;QACV,UAAU;QACV,QAAQ;QACR,QAAQ;QACR,UAAU;QACV,OAAO;QACP,SAAS;QACT,YAAY;QACZ,MAAM;QACN,MAAM;QACN,WAAW;QACX,SAAS;QACT,OAAO;KACR;IACD,MAAM,EAAE;QACN,UAAU;QACV,SAAS;QACT,WAAW;QACX,QAAQ;QACR,QAAQ;QACR,SAAS;QACT,QAAQ;QACR,WAAW;QACX,UAAU;QACV,aAAa;QACb,QAAQ;QACR,MAAM;QACN,SAAS;QACT,OAAO;QACP,YAAY;QACZ,WAAW;KACZ;CACO,CAAC;AAEX;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAE5C,yEAAyE;IACzE,MAAM,MAAM,GAAiB;QAC3B,QAAQ;QACR,UAAU;QACV,SAAS;QACT,OAAO;QACP,YAAY;QACZ,UAAU;KACX,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,mBAAW,CAAC,KAAK,CAAC,CAAC;QACjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,yDAAyD;YACzD,IACE,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC;gBAC1B,SAAS,CAAC,UAAU,CAAC,MAAM,IAAI,EAAE,CAAC;gBAClC,SAAS,CAAC,QAAQ,CAAC,IAAI,IAAI,GAAG,CAAC,EAC/B,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,CAAa,EAAE,CAAa;IAC7D,OAAO,yBAAiB,CAAC,CAAC,CAAC,GAAG,yBAAiB,CAAC,CAAC,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,KAAiB,EAAE,OAAmB;IACxE,OAAO,yBAAiB,CAAC,KAAK,CAAC,IAAI,yBAAiB,CAAC,OAAO,CAAC,CAAC;AAChE,CAAC"}
+{"version":3,"file":"bloom.js","sourceRoot":"","sources":["../../../src/types/bloom.ts"],"names":[],"mappings":"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"}

package/dist/cjs/types/index.js

@@ -5,8 +5,9 @@
  * @packageDocumentation
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GRAPH_VERSION = exports.masteryGap = exports.hasMastery = exports.MASTERY_THRESHOLDS = exports.suggestEdgeType = exports.isValidEdgeStrength = exports.EDGE_STRENGTH_THRESHOLDS = exports.createEdgeId = exports.isValidMasteryThreshold = exports.isValidDifficulty = exports.THRESHOLD_CONCEPT_MASTERY = exports.SKILL_DEFAULTS = exports.createSkillId = exports.meetsBloomThreshold = exports.compareBloomLevels = exports.detectBloomLevel = exports.BLOOM_VERBS = exports.BLOOM_LEVEL_ORDER = void 0;
+exports.BKT_DEFAULTS = exports.createResponseId = exports.createAssessmentId = exports.createQuestionId = exports.GRAPH_VERSION = exports.masteryGap = exports.hasMastery = exports.MASTERY_THRESHOLDS = exports.suggestEdgeType = exports.isValidEdgeStrength = exports.EDGE_STRENGTH_THRESHOLDS = exports.createEdgeId = exports.isValidMasteryThreshold = exports.isValidDifficulty = exports.THRESHOLD_CONCEPT_MASTERY = exports.SKILL_DEFAULTS = exports.createSkillId = exports.meetsBloomThreshold = exports.compareBloomLevels = exports.detectBloomLevel = exports.BLOOM_VERBS = exports.BLOOM_LEVEL_ORDER = exports.BLOOM_LEVELS = void 0;
 var bloom_js_1 = require("./bloom.js");
+Object.defineProperty(exports, "BLOOM_LEVELS", { enumerable: true, get: function () { return bloom_js_1.BLOOM_LEVELS; } });
 Object.defineProperty(exports, "BLOOM_LEVEL_ORDER", { enumerable: true, get: function () { return bloom_js_1.BLOOM_LEVEL_ORDER; } });
 Object.defineProperty(exports, "BLOOM_VERBS", { enumerable: true, get: function () { return bloom_js_1.BLOOM_VERBS; } });
 Object.defineProperty(exports, "detectBloomLevel", { enumerable: true, get: function () { return bloom_js_1.detectBloomLevel; } });
@@ -29,4 +30,9 @@ Object.defineProperty(exports, "hasMastery", { enumerable: true, get: function (
 Object.defineProperty(exports, "masteryGap", { enumerable: true, get: function () { return mastery_js_1.masteryGap; } });
 var graph_js_1 = require("./graph.js");
 Object.defineProperty(exports, "GRAPH_VERSION", { enumerable: true, get: function () { return graph_js_1.GRAPH_VERSION; } });
+var assessment_js_1 = require("./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; } });
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAMH,uCAMoB;AALlB,6GAAA,iBAAiB,OAAA;AACjB,uGAAA,WAAW,OAAA;AACX,4GAAA,gBAAgB,OAAA;AAChB,8GAAA,kBAAkB,OAAA;AAClB,+GAAA,mBAAmB,OAAA;AAOrB,uCAMoB;AALlB,yGAAA,aAAa,OAAA;AACb,0GAAA,cAAc,OAAA;AACd,qHAAA,yBAAyB,OAAA;AACzB,6GAAA,iBAAiB,OAAA;AACjB,mHAAA,uBAAuB,OAAA;AAOzB,qCAKmB;AAJjB,uGAAA,YAAY,OAAA;AACZ,mHAAA,wBAAwB,OAAA;AACxB,8GAAA,mBAAmB,OAAA;AACnB,0GAAA,eAAe,OAAA;AAOjB,2CAA0E;AAAjE,gHAAA,kBAAkB,OAAA;AAAE,wGAAA,UAAU,OAAA;AAAE,wGAAA,UAAU,OAAA;AAanD,uCAA2C;AAAlC,yGAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAMH,uCAOoB;AANlB,wGAAA,YAAY,OAAA;AACZ,6GAAA,iBAAiB,OAAA;AACjB,uGAAA,WAAW,OAAA;AACX,4GAAA,gBAAgB,OAAA;AAChB,8GAAA,kBAAkB,OAAA;AAClB,+GAAA,mBAAmB,OAAA;AAOrB,uCAMoB;AALlB,yGAAA,aAAa,OAAA;AACb,0GAAA,cAAc,OAAA;AACd,qHAAA,yBAAyB,OAAA;AACzB,6GAAA,iBAAiB,OAAA;AACjB,mHAAA,uBAAuB,OAAA;AAOzB,qCAKmB;AAJjB,uGAAA,YAAY,OAAA;AACZ,mHAAA,wBAAwB,OAAA;AACxB,8GAAA,mBAAmB,OAAA;AACnB,0GAAA,eAAe,OAAA;AAOjB,2CAA0E;AAAjE,gHAAA,kBAAkB,OAAA;AAAE,wGAAA,UAAU,OAAA;AAAE,wGAAA,UAAU,OAAA;AAanD,uCAA2C;AAAlC,yGAAA,aAAa,OAAA;AAgItB,iDAKyB;AAJvB,iHAAA,gBAAgB,OAAA;AAChB,mHAAA,kBAAkB,OAAA;AAClB,iHAAA,gBAAgB,OAAA;AAChB,6GAAA,YAAY,OAAA"}

package/dist/esm/api/routes/analytics.js

@@ -0,0 +1,285 @@
+/**
+ * Analytics routes
+ *
+ * Endpoints for skill analytics and cohort analysis.
+ *
+ * @packageDocumentation
+ */
+import { Hono } from 'hono';
+import { success, error, ErrorCodes } from '../server.js';
+import { createSkillId } from '../../types/index.js';
+/**
+ * Create analytics routes
+ */
+export function createAnalyticsRoutes(ctx) {
+    const app = new Hono();
+    // ─────────────────────────────────────────────────────────────────────────
+    // Skill Analytics
+    // ─────────────────────────────────────────────────────────────────────────
+    app.get('/skills/:skillId', async (c) => {
+        try {
+            const skillIdParam = c.req.param('skillId');
+            const skillId = createSkillId(skillIdParam);
+            const skill = await ctx.storage.getSkill(skillId);
+            if (!skill) {
+                return c.json(error(ErrorCodes.NOT_FOUND, `Skill not found: ${skillIdParam}`), 404);
+            }
+            // Get all learners and their mastery for this skill
+            if (!ctx.storage.getAllLearners || !ctx.storage.getMastery) {
+                return c.json(success({
+                    skillId: skillIdParam,
+                    skillName: skill.name,
+                    learnerCount: 0,
+                    averageMastery: 0,
+                    masteryDistribution: new Array(10).fill(0),
+                    averageTimeToMastery: skill.estimatedMinutes,
+                    commonMistakes: [],
+                    message: 'Learner analytics not available - storage does not support learner operations',
+                }));
+            }
+            const learners = await ctx.storage.getAllLearners();
+            const masteryLevels = [];
+            for (const learner of learners) {
+                const mastery = await ctx.storage.getMastery(learner.id, skillIdParam);
+                if (mastery) {
+                    masteryLevels.push(mastery.mastery);
+                }
+            }
+            // Calculate distribution (10 buckets: 0-10%, 10-20%, etc.)
+            const distribution = new Array(10).fill(0);
+            for (const level of masteryLevels) {
+                const bucket = Math.min(Math.floor(level * 10), 9);
+                distribution[bucket]++;
+            }
+            const averageMastery = masteryLevels.length > 0
+                ? masteryLevels.reduce((a, b) => a + b, 0) / masteryLevels.length
+                : 0;
+            return c.json(success({
+                skillId: skillIdParam,
+                skillName: skill.name,
+                learnerCount: masteryLevels.length,
+                averageMastery,
+                masteryDistribution: distribution,
+                averageTimeToMastery: skill.estimatedMinutes,
+                commonMistakes: [],
+            }));
+        }
+        catch (err) {
+            console.error('Skill analytics error:', err);
+            return c.json(error(ErrorCodes.INTERNAL_ERROR, 'Failed to get skill analytics'), 500);
+        }
+    });
+    // ─────────────────────────────────────────────────────────────────────────
+    // Cohort Analytics
+    // ─────────────────────────────────────────────────────────────────────────
+    app.get('/cohort', async (c) => {
+        try {
+            const cohortTag = c.req.query('tag');
+            if (!ctx.storage.getAllLearners || !ctx.storage.getLearnerMastery) {
+                return c.json(success({
+                    learnerCount: 0,
+                    averageMastery: 0,
+                    masteryDistribution: new Array(10).fill(0),
+                    strugglingSkills: [],
+                    topPerformers: [],
+                    atRiskLearners: [],
+                    message: 'Learner analytics not available - storage does not support learner operations',
+                }));
+            }
+            let learners = await ctx.storage.getAllLearners();
+            // Filter by cohort tag if provided
+            if (cohortTag) {
+                learners = learners.filter((l) => l.metadata?.cohort === cohortTag ||
+                    l.metadata?.tags?.includes(cohortTag));
+            }
+            if (learners.length === 0) {
+                return c.json(success({
+                    learnerCount: 0,
+                    averageMastery: 0,
+                    masteryDistribution: new Array(10).fill(0),
+                    strugglingSkills: [],
+                    topPerformers: [],
+                    atRiskLearners: [],
+                }));
+            }
+            // Calculate overall mastery
+            const learnerMasteries = [];
+            const skillMasteries = new Map();
+            for (const learner of learners) {
+                const masteryStates = await ctx.storage.getLearnerMastery(learner.id);
+                const avgMastery = masteryStates.length > 0
+                    ? masteryStates.reduce((sum, m) => sum + m.mastery, 0) / masteryStates.length
+                    : 0;
+                learnerMasteries.push({ id: learner.id, avgMastery });
+                for (const m of masteryStates) {
+                    if (!skillMasteries.has(m.skillId)) {
+                        skillMasteries.set(m.skillId, []);
+                    }
+                    skillMasteries.get(m.skillId).push(m.mastery);
+                }
+            }
+            // Calculate distribution
+            const distribution = new Array(10).fill(0);
+            for (const { avgMastery } of learnerMasteries) {
+                const bucket = Math.min(Math.floor(avgMastery * 10), 9);
+                distribution[bucket]++;
+            }
+            const overallAverage = learnerMasteries.reduce((sum, l) => sum + l.avgMastery, 0) / learnerMasteries.length;
+            // Find struggling skills (low average mastery)
+            const skillAverages = [];
+            for (const [skillId, levels] of skillMasteries) {
+                const avg = levels.reduce((a, b) => a + b, 0) / levels.length;
+                skillAverages.push({ id: skillId, avg });
+            }
+            skillAverages.sort((a, b) => a.avg - b.avg);
+            const strugglingSkills = skillAverages.slice(0, 5).map((s) => s.id);
+            // Top performers and at-risk learners
+            learnerMasteries.sort((a, b) => b.avgMastery - a.avgMastery);
+            const topPerformers = learnerMasteries.slice(0, 5).map((l) => l.id);
+            const atRiskLearners = learnerMasteries
+                .filter((l) => l.avgMastery < 0.3)
+                .slice(0, 5)
+                .map((l) => l.id);
+            return c.json(success({
+                learnerCount: learners.length,
+                averageMastery: overallAverage,
+                masteryDistribution: distribution,
+                strugglingSkills,
+                topPerformers,
+                atRiskLearners,
+            }));
+        }
+        catch (err) {
+            console.error('Cohort analytics error:', err);
+            return c.json(error(ErrorCodes.INTERNAL_ERROR, 'Failed to get cohort analytics'), 500);
+        }
+    });
+    // ─────────────────────────────────────────────────────────────────────────
+    // Progress Over Time
+    // ─────────────────────────────────────────────────────────────────────────
+    app.get('/progress', async (c) => {
+        try {
+            const learnerId = c.req.query('learnerId');
+            const skillIdParam = c.req.query('skillId');
+            const days = Number(c.req.query('days')) || 30;
+            if (!learnerId) {
+                return c.json(error(ErrorCodes.BAD_REQUEST, 'learnerId is required'), 400);
+            }
+            if (!ctx.storage.getLearner || !ctx.storage.getLearnerMastery) {
+                return c.json(error(ErrorCodes.BAD_REQUEST, 'Learner operations not supported by storage'), 400);
+            }
+            const learner = await ctx.storage.getLearner(learnerId);
+            if (!learner) {
+                return c.json(error(ErrorCodes.NOT_FOUND, `Learner not found: ${learnerId}`), 404);
+            }
+            // Get mastery history
+            const masteryStates = await ctx.storage.getLearnerMastery(learnerId);
+            let filtered = masteryStates;
+            if (skillIdParam) {
+                filtered = filtered.filter((m) => m.skillId === skillIdParam);
+            }
+            // Generate daily progress (placeholder - would use actual historical data)
+            const now = Date.now();
+            const dayMs = 24 * 60 * 60 * 1000;
+            const dataPoints = [];
+            for (let i = days - 1; i >= 0; i--) {
+                const date = new Date(now - i * dayMs).toISOString().split('T')[0];
+                const avgMastery = filtered.length > 0
+                    ? filtered.reduce((sum, m) => sum + m.mastery, 0) / filtered.length
+                    : 0;
+                // Simulate progression (in reality, would use historical data)
+                const progress = avgMastery * (1 - i / days / 2);
+                dataPoints.push({
+                    date,
+                    mastery: progress,
+                    skillsWorked: Math.floor(Math.random() * 5),
+                });
+            }
+            return c.json(success({
+                learnerId,
+                skillId: skillIdParam || 'all',
+                days,
+                dataPoints,
+            }));
+        }
+        catch (err) {
+            console.error('Progress analytics error:', err);
+            return c.json(error(ErrorCodes.INTERNAL_ERROR, 'Failed to get progress'), 500);
+        }
+    });
+    // ─────────────────────────────────────────────────────────────────────────
+    // Graph Bottlenecks
+    // ─────────────────────────────────────────────────────────────────────────
+    app.get('/bottlenecks', async (c) => {
+        try {
+            const skills = await ctx.storage.findSkills({});
+            const edges = await ctx.storage.findPrerequisites({});
+            if (!ctx.storage.getAllLearners || !ctx.storage.getMastery) {
+                // Return graph-only analysis without learner data
+                const dependentCounts = new Map();
+                for (const edge of edges) {
+                    const sourceStr = String(edge.sourceId);
+                    dependentCounts.set(sourceStr, (dependentCounts.get(sourceStr) || 0) + 1);
+                }
+                const bottlenecks = skills
+                    .map((skill) => ({
+                    id: String(skill.id),
+                    name: skill.name,
+                    dependentCount: dependentCounts.get(String(skill.id)) || 0,
+                    averageMastery: 0,
+                    learnersStuck: 0,
+                }))
+                    .filter((b) => b.dependentCount >= 2)
+                    .sort((a, b) => b.dependentCount - a.dependentCount)
+                    .slice(0, 10);
+                return c.json(success(bottlenecks));
+            }
+            const learners = await ctx.storage.getAllLearners();
+            // Find skills that are prerequisites for many others
+            const dependentCounts = new Map();
+            for (const edge of edges) {
+                const sourceStr = String(edge.sourceId);
+                dependentCounts.set(sourceStr, (dependentCounts.get(sourceStr) || 0) + 1);
+            }
+            // Calculate average mastery for high-dependency skills
+            const bottlenecks = [];
+            for (const skill of skills) {
+                const skillIdStr = String(skill.id);
+                const dependentCount = dependentCounts.get(skillIdStr) || 0;
+                if (dependentCount < 2)
+                    continue; // Only consider skills with multiple dependents
+                let totalMastery = 0;
+                let stuckCount = 0;
+                let learnerCount = 0;
+                for (const learner of learners) {
+                    const mastery = await ctx.storage.getMastery(learner.id, skillIdStr);
+                    if (mastery) {
+                        learnerCount++;
+                        totalMastery += mastery.mastery;
+                        if (mastery.mastery < skill.masteryThreshold && mastery.mastery > 0.1) {
+                            stuckCount++;
+                        }
+                    }
+                }
+                if (learnerCount > 0) {
+                    bottlenecks.push({
+                        id: skillIdStr,
+                        name: skill.name,
+                        dependentCount,
+                        averageMastery: totalMastery / learnerCount,
+                        learnersStuck: stuckCount,
+                    });
+                }
+            }
+            // Sort by impact (dependents * stuck learners)
+            bottlenecks.sort((a, b) => b.dependentCount * b.learnersStuck - a.dependentCount * a.learnersStuck);
+            return c.json(success(bottlenecks.slice(0, 10)));
+        }
+        catch (err) {
+            console.error('Bottlenecks error:', err);
+            return c.json(error(ErrorCodes.INTERNAL_ERROR, 'Failed to get bottlenecks'), 500);
+        }
+    });
+    return app;
+}
+//# sourceMappingURL=analytics.js.map