learngraph 0.4.0 → 0.7.0

package/dist/types/api/types.d.ts

@@ -0,0 +1,443 @@
+/**
+ * REST API Types
+ *
+ * Type definitions for the LearnGraph REST API.
+ *
+ * @packageDocumentation
+ */
+import type { SkillId, QuestionId } from '../types/index.js';
+/**
+ * Learner identifier (string alias for readability)
+ */
+export type LearnerId = string;
+/**
+ * API Response wrapper
+ */
+export interface ApiResponse<T> {
+    success: boolean;
+    data?: T;
+    error?: ApiError;
+    meta?: ResponseMeta;
+}
+/**
+ * API Error
+ */
+export interface ApiError {
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+}
+/**
+ * Response metadata (pagination, timing, etc.)
+ */
+export interface ResponseMeta {
+    total?: number;
+    page?: number;
+    pageSize?: number;
+    hasMore?: boolean;
+    requestId?: string;
+    timing?: number;
+}
+/**
+ * Common pagination parameters
+ */
+export interface PaginationParams {
+    page?: number;
+    pageSize?: number;
+    offset?: number;
+    limit?: number;
+}
+/**
+ * Skill query parameters
+ */
+export interface SkillQueryParams extends PaginationParams {
+    tags?: string[];
+    bloomLevel?: string;
+    difficulty?: {
+        min?: number;
+        max?: number;
+    };
+    search?: string;
+    expand?: string[];
+    sortBy?: 'name' | 'difficulty' | 'createdAt' | 'updatedAt';
+    sortOrder?: 'asc' | 'desc';
+}
+/**
+ * Learner query parameters
+ */
+export interface LearnerQueryParams extends PaginationParams {
+    search?: string;
+    minMastery?: number;
+    maxMastery?: number;
+}
+/**
+ * Create skill request
+ */
+export interface CreateSkillRequest {
+    name: string;
+    description: string;
+    bloomLevel: string;
+    difficulty?: number;
+    isThresholdConcept?: boolean;
+    masteryThreshold?: number;
+    estimatedMinutes?: number;
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Update skill request
+ */
+export interface UpdateSkillRequest {
+    name?: string;
+    description?: string;
+    bloomLevel?: string;
+    difficulty?: number;
+    isThresholdConcept?: boolean;
+    masteryThreshold?: number;
+    estimatedMinutes?: number;
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Skill with expansion data
+ */
+export interface SkillWithExpansions {
+    id: SkillId;
+    name: string;
+    description: string;
+    bloomLevel: string;
+    difficulty: number;
+    isThresholdConcept: boolean;
+    masteryThreshold: number;
+    estimatedMinutes: number;
+    tags: string[];
+    metadata: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+    prerequisites?: PrerequisiteSummary[];
+    dependents?: DependentSummary[];
+    questions?: QuestionSummary[];
+}
+/**
+ * Prerequisite skill summary
+ */
+export interface PrerequisiteSummary {
+    id: SkillId;
+    name: string;
+    strength: number;
+}
+/**
+ * Dependent skill summary
+ */
+export interface DependentSummary {
+    id: SkillId;
+    name: string;
+    strength: number;
+}
+/**
+ * Question summary
+ */
+export interface QuestionSummary {
+    id: QuestionId;
+    prompt: string;
+    type: string;
+}
+/**
+ * Create edge request
+ */
+export interface CreateEdgeRequest {
+    from: SkillId;
+    to: SkillId;
+    strength?: number;
+    type?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Update edge request
+ */
+export interface UpdateEdgeRequest {
+    strength?: number;
+    type?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Create learner request
+ */
+export interface CreateLearnerRequest {
+    name?: string;
+    email?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Learner profile response
+ */
+export interface LearnerProfileResponse {
+    id: LearnerId;
+    name?: string;
+    email?: string;
+    masteryCount: number;
+    averageMastery: number;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Learner dashboard response
+ */
+export interface LearnerDashboardResponse {
+    profile: LearnerProfileResponse;
+    mastery: MasterySummary;
+    zpd: ZPDSummary;
+    reviews: ReviewSummary;
+    progress: ProgressSummary;
+}
+/**
+ * Mastery summary for dashboard
+ */
+export interface MasterySummary {
+    totalSkills: number;
+    masteredSkills: number;
+    inProgressSkills: number;
+    notStartedSkills: number;
+    averageMastery: number;
+}
+/**
+ * ZPD summary for dashboard
+ */
+export interface ZPDSummary {
+    readyToLearn: number;
+    recommendedNext: SkillId[];
+}
+/**
+ * Review summary for dashboard
+ */
+export interface ReviewSummary {
+    dueNow: number;
+    dueSoon: number;
+    nextReviewSkill?: SkillId;
+}
+/**
+ * Progress summary for dashboard
+ */
+export interface ProgressSummary {
+    streak: number;
+    lastActiveAt?: string;
+    skillsThisWeek: number;
+    totalTimeMinutes: number;
+}
+/**
+ * Record response request
+ */
+export interface RecordResponseRequest {
+    correct: boolean;
+    responseTimeMs?: number;
+    questionId?: QuestionId;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Mastery state response
+ */
+export interface MasteryStateResponse {
+    skillId: SkillId;
+    skillName: string;
+    mastery: number;
+    confidence: number;
+    isMastered: boolean;
+    lastPracticed?: string;
+    responseCount: number;
+}
+/**
+ * Learning path response
+ */
+export interface LearningPathResponse {
+    targetSkill?: SkillId;
+    skills: PathSkill[];
+    totalMinutes: number;
+    sessions: PathSession[];
+}
+/**
+ * Skill in learning path
+ */
+export interface PathSkill {
+    id: SkillId;
+    name: string;
+    bloomLevel: string;
+    estimatedMinutes: number;
+    currentMastery: number;
+    isCheckpoint: boolean;
+}
+/**
+ * Study session in path
+ */
+export interface PathSession {
+    skills: SkillId[];
+    estimatedMinutes: number;
+}
+/**
+ * Start assessment session request
+ */
+export interface StartSessionRequest {
+    assessmentId: string;
+    config?: {
+        maxQuestions?: number;
+        timeLimit?: number;
+        targetPrecision?: number;
+    };
+}
+/**
+ * Assessment session response
+ */
+export interface SessionResponse {
+    sessionId: string;
+    status: 'active' | 'completed' | 'terminated';
+    currentQuestion?: QuestionResponse;
+    questionsAnswered: number;
+    estimatedAbility?: number;
+    standardError?: number;
+}
+/**
+ * Question response
+ */
+export interface QuestionResponse {
+    id: QuestionId;
+    prompt: string;
+    type: string;
+    options?: string[];
+    skillId: SkillId;
+}
+/**
+ * Submit answer request
+ */
+export interface SubmitAnswerRequest {
+    answer: unknown;
+    responseTimeMs?: number;
+}
+/**
+ * Assessment result response
+ */
+export interface AssessmentResultResponse {
+    sessionId: string;
+    abilityEstimate: number;
+    standardError: number;
+    percentile: number;
+    questionsAnswered: number;
+    correctCount: number;
+    masteryUpdates: MasteryStateResponse[];
+    recommendations: SkillId[];
+}
+/**
+ * Learning goal
+ */
+export interface LearningGoal {
+    id: string;
+    targetSkillId: SkillId;
+    targetSkillName: string;
+    targetDate?: string;
+    progress: number;
+    createdAt: string;
+}
+/**
+ * Create goal request
+ */
+export interface CreateGoalRequest {
+    targetSkillId: SkillId;
+    targetDate?: string;
+}
+/**
+ * Study session request
+ */
+export interface StartStudySessionRequest {
+    minutes: number;
+    skillIds?: SkillId[];
+    focus?: 'new' | 'review' | 'mixed';
+}
+/**
+ * Study session response
+ */
+export interface StudySessionResponse {
+    sessionId: string;
+    estimatedMinutes: number;
+    skills: PathSkill[];
+    questionsTotal: number;
+    reviewsTotal: number;
+}
+/**
+ * Skill analytics response
+ */
+export interface SkillAnalyticsResponse {
+    skillId: SkillId;
+    skillName: string;
+    learnerCount: number;
+    averageMastery: number;
+    masteryDistribution: number[];
+    averageTimeToMastery: number;
+    commonMistakes: string[];
+}
+/**
+ * Cohort analytics response
+ */
+export interface CohortAnalyticsResponse {
+    learnerCount: number;
+    averageMastery: number;
+    masteryDistribution: number[];
+    strugglingSkills: SkillId[];
+    topPerformers: LearnerId[];
+    atRiskLearners: LearnerId[];
+}
+/**
+ * Prerequisites response
+ */
+export interface PrerequisitesResponse {
+    skillId: SkillId;
+    skillName: string;
+    prerequisites: PrerequisiteDetail[];
+    depth?: number;
+}
+/**
+ * Prerequisite detail
+ */
+export interface PrerequisiteDetail {
+    id: SkillId;
+    name: string;
+    bloomLevel: string;
+    strength: number;
+    depth: number;
+    mastery?: number;
+}
+/**
+ * Dependents response
+ */
+export interface DependentsResponse {
+    skillId: SkillId;
+    skillName: string;
+    dependents: DependentDetail[];
+    depth?: number;
+}
+/**
+ * Dependent detail
+ */
+export interface DependentDetail {
+    id: SkillId;
+    name: string;
+    bloomLevel: string;
+    strength: number;
+    depth: number;
+}
+/**
+ * Path between skills response
+ */
+export interface SkillPathResponse {
+    from: SkillId;
+    to: SkillId;
+    path: PathNode[];
+    totalSteps: number;
+    exists: boolean;
+}
+/**
+ * Node in skill path
+ */
+export interface PathNode {
+    id: SkillId;
+    name: string;
+    step: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/api/types.d.ts.map

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

package/dist/types/assessment/adaptive.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Adaptive Assessment Framework
+ *
+ * Implements adaptive testing with:
+ * - IRT-based item selection (Maximum Fisher Information)
+ * - Content balancing across skills
+ * - Termination criteria (precision, item count, time)
+ * - Real-time ability estimation
+ *
+ * @packageDocumentation
+ */
+import type { SkillId, QuestionId, Question, Assessment, IRTParameters, IRTAbilityEstimate, AdaptiveState, AdaptiveConfig, ItemSelection, TerminationCriteria } from '../types/index.js';
+import { type IRTResponse } from './irt.js';
+/**
+ * Default adaptive configuration
+ */
+export declare const ADAPTIVE_DEFAULTS: Required<AdaptiveConfig>;
+/**
+ * Default termination criteria
+ */
+export declare const TERMINATION_DEFAULTS: Required<TerminationCriteria>;
+/**
+ * Question pool for adaptive testing
+ */
+export interface QuestionPool {
+    /** Available questions */
+    questions: Map<QuestionId, Question>;
+    /** IRT parameters for questions (if calibrated) */
+    irtParams: Map<QuestionId, IRTParameters>;
+    /** Questions by skill */
+    bySkill: Map<SkillId, QuestionId[]>;
+    /** Exposure counts (for exposure control) */
+    exposureCounts: Map<QuestionId, number>;
+    /** Total administrations */
+    totalAdministrations: number;
+}
+/**
+ * Active adaptive session
+ */
+export interface AdaptiveSession {
+    /** Session ID */
+    id: string;
+    /** Assessment being administered */
+    assessmentId: string;
+    /** Learner ID */
+    learnerId: string;
+    /** Question pool */
+    pool: QuestionPool;
+    /** Administered questions in order */
+    administeredQuestions: QuestionId[];
+    /** Responses */
+    responses: IRTResponse[];
+    /** Current ability estimate */
+    abilityEstimate: IRTAbilityEstimate;
+    /** Content coverage counts */
+    contentCoverage: Map<SkillId, number>;
+    /** Start time */
+    startTime: Date;
+    /** Configuration */
+    config: Required<AdaptiveConfig>;
+    /** Termination criteria */
+    termination: Required<TerminationCriteria>;
+    /** Current state */
+    state: AdaptiveState;
+}
+/**
+ * Adaptive Assessment Engine
+ *
+ * Manages adaptive testing sessions with intelligent item selection.
+ *
+ * @example
+ * ```typescript
+ * const engine = new AdaptiveEngine();
+ *
+ * // Create session
+ * const session = engine.createSession(pool, assessment, 'learner-1');
+ *
+ * // Get next question
+ * const next = engine.selectNextQuestion(session);
+ * if (next) {
+ *   // Present question to learner...
+ *   session = engine.recordResponse(session, next.questionId, true);
+ * }
+ *
+ * // Check if complete
+ * if (engine.shouldTerminate(session)) {
+ *   const result = engine.getResult(session);
+ * }
+ * ```
+ */
+export declare class AdaptiveEngine {
+    private readonly irtEstimator;
+    constructor();
+    /**
+     * Create a new adaptive session
+     */
+    createSession(pool: QuestionPool, assessment: Assessment, learnerId: string, config?: AdaptiveConfig, termination?: TerminationCriteria): AdaptiveSession;
+    /**
+     * Select the next question using the configured strategy
+     */
+    selectNextQuestion(session: AdaptiveSession): ItemSelection | null;
+    /**
+     * Record a response and update ability estimate
+     */
+    recordResponse(session: AdaptiveSession, questionId: QuestionId, correct: boolean): AdaptiveSession;
+    /**
+     * Check if assessment should terminate
+     */
+    shouldTerminate(session: AdaptiveSession): boolean;
+    /**
+     * Get reason for termination
+     */
+    private getTerminationReason;
+    /**
+     * Get eligible questions based on constraints
+     */
+    private getEligibleQuestions;
+    /**
+     * Maximum Fisher Information selection
+     */
+    private selectMFI;
+    /**
+     * Kullback-Leibler information selection
+     * (Simplified implementation - selects based on KL divergence)
+     */
+    private selectKL;
+    /**
+     * Expected Bayesian Information selection
+     */
+    private selectEBI;
+    /**
+     * Minimum Expected Posterior Variance selection
+     */
+    private selectMEPV;
+    /**
+     * Get session result
+     */
+    getResult(session: AdaptiveSession): {
+        abilityEstimate: IRTAbilityEstimate;
+        score: number;
+        itemCount: number;
+        elapsedMinutes: number;
+        contentCoverage: Map<SkillId, number>;
+        terminationReason: string;
+    };
+}
+/**
+ * Create question pool from questions with IRT parameters
+ */
+export declare function createQuestionPool(questions: Question[], getIRTParams?: (q: Question) => IRTParameters | undefined): QuestionPool;
+/**
+ * Create an adaptive engine
+ */
+export declare function createAdaptiveEngine(): AdaptiveEngine;
+//# sourceMappingURL=adaptive.d.ts.map

package/dist/types/assessment/adaptive.d.ts.map

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