learngraph 0.4.0 → 0.7.0

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

@@ -0,0 +1,288 @@
+"use strict";
+/**
+ * Analytics routes
+ *
+ * Endpoints for skill analytics and cohort analysis.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAnalyticsRoutes = createAnalyticsRoutes;
+const hono_1 = require("hono");
+const server_js_1 = require("../server.js");
+const index_js_1 = require("../../types/index.js");
+/**
+ * Create analytics routes
+ */
+function createAnalyticsRoutes(ctx) {
+    const app = new hono_1.Hono();
+    // ─────────────────────────────────────────────────────────────────────────
+    // Skill Analytics
+    // ─────────────────────────────────────────────────────────────────────────
+    app.get('/skills/:skillId', async (c) => {
+        try {
+            const skillIdParam = c.req.param('skillId');
+            const skillId = (0, index_js_1.createSkillId)(skillIdParam);
+            const skill = await ctx.storage.getSkill(skillId);
+            if (!skill) {
+                return c.json((0, server_js_1.error)(server_js_1.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((0, server_js_1.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((0, server_js_1.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((0, server_js_1.error)(server_js_1.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((0, server_js_1.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((0, server_js_1.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((0, server_js_1.success)({
+                learnerCount: learners.length,
+                averageMastery: overallAverage,
+                masteryDistribution: distribution,
+                strugglingSkills,
+                topPerformers,
+                atRiskLearners,
+            }));
+        }
+        catch (err) {
+            console.error('Cohort analytics error:', err);
+            return c.json((0, server_js_1.error)(server_js_1.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((0, server_js_1.error)(server_js_1.ErrorCodes.BAD_REQUEST, 'learnerId is required'), 400);
+            }
+            if (!ctx.storage.getLearner || !ctx.storage.getLearnerMastery) {
+                return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.BAD_REQUEST, 'Learner operations not supported by storage'), 400);
+            }
+            const learner = await ctx.storage.getLearner(learnerId);
+            if (!learner) {
+                return c.json((0, server_js_1.error)(server_js_1.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((0, server_js_1.success)({
+                learnerId,
+                skillId: skillIdParam || 'all',
+                days,
+                dataPoints,
+            }));
+        }
+        catch (err) {
+            console.error('Progress analytics error:', err);
+            return c.json((0, server_js_1.error)(server_js_1.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((0, server_js_1.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((0, server_js_1.success)(bottlenecks.slice(0, 10)));
+        }
+        catch (err) {
+            console.error('Bottlenecks error:', err);
+            return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.INTERNAL_ERROR, 'Failed to get bottlenecks'), 500);
+        }
+    });
+    return app;
+}
+//# sourceMappingURL=analytics.js.map

package/dist/cjs/api/routes/analytics.js.map

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

package/dist/cjs/api/routes/assessments.js

@@ -0,0 +1,269 @@
+"use strict";
+/**
+ * Assessment routes
+ *
+ * Endpoints for assessments, questions, and adaptive testing.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAssessmentRoutes = createAssessmentRoutes;
+const hono_1 = require("hono");
+const server_js_1 = require("../server.js");
+const index_js_1 = require("../../types/index.js");
+// SkillNode type used in comments for documentation
+/**
+ * Create assessment routes
+ */
+function createAssessmentRoutes(ctx) {
+    const app = new hono_1.Hono();
+    // In-memory session storage (in production, use Redis or database)
+    const sessions = new Map();
+    // ─────────────────────────────────────────────────────────────────────────
+    // List Questions for a Skill
+    // ─────────────────────────────────────────────────────────────────────────
+    app.get('/skills/:skillId/questions', async (c) => {
+        try {
+            const skillIdParam = c.req.param('skillId');
+            const skillId = (0, index_js_1.createSkillId)(skillIdParam);
+            const skill = await ctx.storage.getSkill(skillId);
+            if (!skill) {
+                return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.NOT_FOUND, `Skill not found: ${skillIdParam}`), 404);
+            }
+            // Questions would be stored in skill metadata or separate storage
+            const questions = skill.metadata?.questions || [];
+            return c.json((0, server_js_1.success)(questions));
+        }
+        catch (err) {
+            console.error('List questions error:', err);
+            return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.INTERNAL_ERROR, 'Failed to list questions'), 500);
+        }
+    });
+    // ─────────────────────────────────────────────────────────────────────────
+    // Start Assessment Session
+    // ─────────────────────────────────────────────────────────────────────────
+    app.post('/sessions', async (c) => {
+        try {
+            const learnerId = c.req.header('X-Learner-Id');
+            if (!learnerId) {
+                return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.UNAUTHORIZED, 'Learner ID required'), 401);
+            }
+            const body = await c.req.json();
+            // Get questions from specified skills
+            const skillIds = body.skillIds || [];
+            const questions = [];
+            for (const skillIdParam of skillIds) {
+                const skillId = (0, index_js_1.createSkillId)(skillIdParam);
+                const skill = await ctx.storage.getSkill(skillId);
+                if (skill?.metadata?.questions) {
+                    const skillQuestions = skill.metadata.questions;
+                    questions.push(...skillQuestions.map((q) => q.id));
+                }
+            }
+            if (questions.length === 0) {
+                return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.VALIDATION_ERROR, 'No questions available for selected skills'), 400);
+            }
+            // Shuffle and limit questions
+            const shuffled = questions.sort(() => Math.random() - 0.5);
+            const limited = shuffled.slice(0, body.maxQuestions || 10);
+            const sessionId = `session_${Date.now()}_${Math.random().toString(36).slice(2)}`;
+            const session = {
+                id: sessionId,
+                learnerId,
+                assessmentId: body.assessmentId || sessionId,
+                status: 'active',
+                questions: limited,
+                currentIndex: 0,
+                responses: [],
+                startedAt: new Date().toISOString(),
+                estimatedAbility: 0,
+            };
+            sessions.set(sessionId, session);
+            return c.json((0, server_js_1.success)({
+                sessionId,
+                status: 'active',
+                totalQuestions: limited.length,
+                questionsAnswered: 0,
+            }), 201);
+        }
+        catch (err) {
+            console.error('Start session error:', err);
+            return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.INTERNAL_ERROR, 'Failed to start session'), 500);
+        }
+    });
+    // ─────────────────────────────────────────────────────────────────────────
+    // Get Current Question
+    // ─────────────────────────────────────────────────────────────────────────
+    app.get('/sessions/:sessionId/question', async (c) => {
+        try {
+            const sessionId = c.req.param('sessionId');
+            const session = sessions.get(sessionId);
+            if (!session) {
+                return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.NOT_FOUND, `Session not found: ${sessionId}`), 404);
+            }
+            if (session.status !== 'active') {
+                return c.json((0, server_js_1.success)({
+                    sessionId,
+                    status: session.status,
+                    message: 'Session is no longer active',
+                }));
+            }
+            if (session.currentIndex >= session.questions.length) {
+                session.status = 'completed';
+                return c.json((0, server_js_1.success)({
+                    sessionId,
+                    status: 'completed',
+                    message: 'All questions answered',
+                }));
+            }
+            const questionId = session.questions[session.currentIndex];
+            // Find the question (in real implementation, would have a question storage)
+            const skills = await ctx.storage.findSkills({});
+            let question = null;
+            for (const skill of skills) {
+                const questions = skill.metadata?.questions;
+                if (questions) {
+                    const found = questions.find((q) => q.id === questionId);
+                    if (found) {
+                        question = { ...found, skillId: String(skill.id) };
+                        break;
+                    }
+                }
+            }
+            if (!question) {
+                // Skip missing question
+                session.currentIndex++;
+                return c.json((0, server_js_1.success)({
+                    sessionId,
+                    status: 'active',
+                    message: 'Question not found, skipping',
+                }));
+            }
+            return c.json((0, server_js_1.success)({
+                sessionId,
+                status: 'active',
+                questionNumber: session.currentIndex + 1,
+                totalQuestions: session.questions.length,
+                question: {
+                    id: question.id,
+                    prompt: question.prompt,
+                    type: question.type,
+                    options: question.options,
+                    skillId: question.skillId,
+                },
+            }));
+        }
+        catch (err) {
+            console.error('Get question error:', err);
+            return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.INTERNAL_ERROR, 'Failed to get question'), 500);
+        }
+    });
+    // ─────────────────────────────────────────────────────────────────────────
+    // Submit Answer
+    // ─────────────────────────────────────────────────────────────────────────
+    app.post('/sessions/:sessionId/answer', async (c) => {
+        try {
+            const sessionId = c.req.param('sessionId');
+            const session = sessions.get(sessionId);
+            if (!session) {
+                return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.NOT_FOUND, `Session not found: ${sessionId}`), 404);
+            }
+            if (session.status !== 'active') {
+                return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.BAD_REQUEST, 'Session is not active'), 400);
+            }
+            const body = await c.req.json();
+            const questionId = session.questions[session.currentIndex];
+            if (!questionId) {
+                return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.BAD_REQUEST, 'No current question'), 400);
+            }
+            // In a real implementation, we would validate the answer
+            // For now, assume we have a way to check correctness
+            const correct = Math.random() > 0.5; // Placeholder
+            session.responses.push({
+                questionId,
+                correct,
+                ...(body.responseTimeMs !== undefined ? { responseTimeMs: body.responseTimeMs } : {}),
+            });
+            // Update ability estimate (simplified)
+            const correctCount = session.responses.filter((r) => r.correct).length;
+            session.estimatedAbility = correctCount / session.responses.length;
+            session.currentIndex++;
+            const isComplete = session.currentIndex >= session.questions.length;
+            if (isComplete) {
+                session.status = 'completed';
+                // Update mastery for the learner
+                // This would integrate with the mastery engine
+            }
+            return c.json((0, server_js_1.success)({
+                sessionId,
+                correct,
+                status: session.status,
+                questionsAnswered: session.responses.length,
+                questionsRemaining: session.questions.length - session.currentIndex,
+                estimatedAbility: session.estimatedAbility,
+            }));
+        }
+        catch (err) {
+            console.error('Submit answer error:', err);
+            return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.INTERNAL_ERROR, 'Failed to submit answer'), 500);
+        }
+    });
+    // ─────────────────────────────────────────────────────────────────────────
+    // Get Session Results
+    // ─────────────────────────────────────────────────────────────────────────
+    app.get('/sessions/:sessionId/results', async (c) => {
+        try {
+            const sessionId = c.req.param('sessionId');
+            const session = sessions.get(sessionId);
+            if (!session) {
+                return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.NOT_FOUND, `Session not found: ${sessionId}`), 404);
+            }
+            if (session.status === 'active') {
+                return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.BAD_REQUEST, 'Session is still active'), 400);
+            }
+            const correctCount = session.responses.filter((r) => r.correct).length;
+            const accuracy = session.responses.length > 0
+                ? correctCount / session.responses.length
+                : 0;
+            return c.json((0, server_js_1.success)({
+                sessionId,
+                status: session.status,
+                questionsAnswered: session.responses.length,
+                correctCount,
+                accuracy,
+                estimatedAbility: session.estimatedAbility,
+                responses: session.responses,
+                startedAt: session.startedAt,
+                completedAt: new Date().toISOString(),
+            }));
+        }
+        catch (err) {
+            console.error('Get results error:', err);
+            return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.INTERNAL_ERROR, 'Failed to get results'), 500);
+        }
+    });
+    // ─────────────────────────────────────────────────────────────────────────
+    // End Session Early
+    // ─────────────────────────────────────────────────────────────────────────
+    app.post('/sessions/:sessionId/end', async (c) => {
+        try {
+            const sessionId = c.req.param('sessionId');
+            const session = sessions.get(sessionId);
+            if (!session) {
+                return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.NOT_FOUND, `Session not found: ${sessionId}`), 404);
+            }
+            session.status = 'terminated';
+            return c.json((0, server_js_1.success)({
+                sessionId,
+                status: 'terminated',
+                questionsAnswered: session.responses.length,
+            }));
+        }
+        catch (err) {
+            console.error('End session error:', err);
+            return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.INTERNAL_ERROR, 'Failed to end session'), 500);
+        }
+    });
+    return app;
+}
+//# sourceMappingURL=assessments.js.map

package/dist/cjs/api/routes/assessments.js.map

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