learngraph 0.1.1 → 0.3.0

package/dist/cjs/llm/prompts.js

@@ -0,0 +1,367 @@
+"use strict";
+/**
+ * Prompts for LLM-based educational tasks
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DECOMPOSITION_SCHEMA = exports.BLOOM_ANALYSIS_SCHEMA = exports.PREREQUISITE_SCHEMA = exports.EXTRACTION_SCHEMA = exports.SYSTEM_PROMPTS = void 0;
+exports.buildExtractionPrompt = buildExtractionPrompt;
+exports.buildPrerequisitePrompt = buildPrerequisitePrompt;
+exports.buildBloomPrompt = buildBloomPrompt;
+exports.buildDecompositionPrompt = buildDecompositionPrompt;
+// ─────────────────────────────────────────────────────────────────────────────
+// System Prompts
+// ─────────────────────────────────────────────────────────────────────────────
+exports.SYSTEM_PROMPTS = {
+    skillExtraction: `You are an expert educational curriculum analyst specializing in competency-based education and learning science.
+
+Your task is to analyze curriculum content and extract discrete, measurable skills that learners should master.
+
+For each skill you identify:
+1. Name: A concise, action-oriented name (e.g., "Calculate derivative of polynomial")
+2. Description: A clear explanation of what mastery of this skill looks like
+3. Bloom's Level: Classify using Bloom's Taxonomy (remember, understand, apply, analyze, evaluate, create)
+4. Difficulty: Estimate difficulty on a 0-1 scale based on cognitive complexity
+5. Threshold Concept: Identify if this is a transformative "gateway" skill that changes understanding
+6. Estimated Time: How long a typical learner needs to achieve mastery
+
+Focus on:
+- Observable, measurable outcomes
+- Skills that can be assessed
+- Appropriate granularity (not too broad, not too narrow)
+- Clear prerequisite relationships
+
+Bloom's Level Guidelines:
+- remember (0.20): Recall facts, terms, basic concepts
+- understand (0.35): Explain ideas, interpret, summarize
+- apply (0.50): Use information in new situations, solve problems
+- analyze (0.65): Draw connections, organize, compare, contrast
+- evaluate (0.80): Justify decisions, make judgments, critique
+- create (0.90): Produce new work, design, construct`,
+    prerequisiteInference: `You are an expert in learning science and curriculum design, specializing in prerequisite mapping and learning path optimization.
+
+Your task is to analyze skills and infer prerequisite relationships between them.
+
+For each prerequisite relationship:
+1. Identify which skill must be learned first (source/prerequisite)
+2. Identify which skill depends on it (target/dependent)
+3. Classify the relationship type:
+   - hard: Absolutely required - cannot learn target without source
+   - soft: Strongly beneficial but not strictly required
+   - recommended: Helpful for optimal learning path
+4. Estimate strength (0-1): How critical is this prerequisite?
+5. Provide clear reasoning for the relationship
+
+Consider:
+- Bloom's level progression (lower levels typically prerequisite to higher)
+- Conceptual dependencies (foundational concepts before advanced)
+- Skill hierarchies within domains
+- Transfer of learning between related skills
+- Avoid circular dependencies`,
+    bloomAnalysis: `You are an expert in Bloom's Taxonomy and educational assessment design.
+
+Analyze the given text and determine its cognitive level according to Bloom's Taxonomy:
+
+1. remember - Recall facts and basic concepts
+   Verbs: define, identify, list, name, recall, recognize, state
+
+2. understand - Explain ideas or concepts
+   Verbs: describe, explain, interpret, summarize, classify, compare
+
+3. apply - Use information in new situations
+   Verbs: apply, calculate, solve, demonstrate, implement, use
+
+4. analyze - Draw connections among ideas
+   Verbs: analyze, compare, contrast, differentiate, examine, organize
+
+5. evaluate - Justify a decision or course of action
+   Verbs: evaluate, assess, critique, judge, justify, recommend
+
+6. create - Produce new or original work
+   Verbs: create, design, develop, construct, formulate, produce
+
+Provide:
+- The Bloom's level
+- Confidence score (0-1)
+- Key indicators (verbs/phrases) that led to this classification
+- Brief reasoning`,
+    curriculumDecomposition: `You are an expert curriculum designer and learning scientist.
+
+Your task is to decompose curriculum content into a structured skill graph suitable for adaptive learning systems.
+
+Process:
+1. Identify the overall learning goals and outcomes
+2. Break down content into discrete, measurable skills
+3. Classify each skill by Bloom's level and difficulty
+4. Identify threshold concepts (transformative gateway skills)
+5. Map prerequisite relationships between skills
+6. Ensure appropriate granularity for personalized learning
+
+Output a complete skill graph with:
+- Skills: Name, description, Bloom's level, difficulty, estimated time
+- Prerequisites: Source skill, target skill, type, strength, reasoning
+
+Principles:
+- Every skill should be assessable
+- Skills should be at appropriate granularity (15-45 min to master)
+- Clear progression from foundational to advanced
+- Identify threshold concepts that unlock new understanding
+- Consider both hard prerequisites (required) and soft (beneficial)`,
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// JSON Schemas for Structured Output
+// ─────────────────────────────────────────────────────────────────────────────
+exports.EXTRACTION_SCHEMA = {
+    type: 'object',
+    properties: {
+        skills: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Concise, action-oriented skill name' },
+                    description: { type: 'string', description: 'What mastery of this skill looks like' },
+                    bloomLevel: {
+                        type: 'string',
+                        enum: ['remember', 'understand', 'apply', 'analyze', 'evaluate', 'create'],
+                        description: "Bloom's Taxonomy level",
+                    },
+                    difficulty: {
+                        type: 'number',
+                        minimum: 0,
+                        maximum: 1,
+                        description: 'Difficulty on 0-1 scale',
+                    },
+                    confidence: {
+                        type: 'number',
+                        minimum: 0,
+                        maximum: 1,
+                        description: 'Confidence in this extraction',
+                    },
+                    isThresholdConcept: {
+                        type: 'boolean',
+                        description: 'Is this a transformative gateway skill?',
+                    },
+                    estimatedMinutes: {
+                        type: 'number',
+                        description: 'Estimated time to master in minutes',
+                    },
+                    keywords: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Associated keywords/concepts',
+                    },
+                    reasoning: {
+                        type: 'string',
+                        description: 'Why this skill was extracted',
+                    },
+                },
+                required: ['name', 'description', 'bloomLevel', 'difficulty', 'confidence'],
+            },
+        },
+        warnings: {
+            type: 'array',
+            items: { type: 'string' },
+            description: 'Any warnings or notes about the extraction',
+        },
+    },
+    required: ['skills'],
+};
+exports.PREREQUISITE_SCHEMA = {
+    type: 'object',
+    properties: {
+        prerequisites: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    sourceId: { type: 'string', description: 'ID of the prerequisite skill' },
+                    targetId: { type: 'string', description: 'ID of the dependent skill' },
+                    strength: {
+                        type: 'number',
+                        minimum: 0,
+                        maximum: 1,
+                        description: 'How critical is this prerequisite (0-1)',
+                    },
+                    type: {
+                        type: 'string',
+                        enum: ['hard', 'soft', 'recommended'],
+                        description: 'Type of prerequisite relationship',
+                    },
+                    confidence: {
+                        type: 'number',
+                        minimum: 0,
+                        maximum: 1,
+                        description: 'Confidence in this inference',
+                    },
+                    reasoning: {
+                        type: 'string',
+                        description: 'Why this prerequisite relationship exists',
+                    },
+                },
+                required: ['sourceId', 'targetId', 'strength', 'type', 'confidence', 'reasoning'],
+            },
+        },
+    },
+    required: ['prerequisites'],
+};
+exports.BLOOM_ANALYSIS_SCHEMA = {
+    type: 'object',
+    properties: {
+        level: {
+            type: 'string',
+            enum: ['remember', 'understand', 'apply', 'analyze', 'evaluate', 'create'],
+            description: "Detected Bloom's level",
+        },
+        confidence: {
+            type: 'number',
+            minimum: 0,
+            maximum: 1,
+            description: 'Confidence in detection',
+        },
+        indicators: {
+            type: 'array',
+            items: { type: 'string' },
+            description: 'Key verbs/phrases indicating this level',
+        },
+        reasoning: {
+            type: 'string',
+            description: 'Explanation for the classification',
+        },
+    },
+    required: ['level', 'confidence', 'indicators', 'reasoning'],
+};
+exports.DECOMPOSITION_SCHEMA = {
+    type: 'object',
+    properties: {
+        title: { type: 'string', description: 'Course/curriculum title' },
+        skills: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    id: { type: 'string', description: 'Unique skill identifier' },
+                    name: { type: 'string' },
+                    description: { type: 'string' },
+                    bloomLevel: {
+                        type: 'string',
+                        enum: ['remember', 'understand', 'apply', 'analyze', 'evaluate', 'create'],
+                    },
+                    difficulty: { type: 'number', minimum: 0, maximum: 1 },
+                    isThresholdConcept: { type: 'boolean' },
+                    estimatedMinutes: { type: 'number' },
+                    keywords: { type: 'array', items: { type: 'string' } },
+                },
+                required: ['id', 'name', 'description', 'bloomLevel', 'difficulty'],
+            },
+        },
+        prerequisites: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    sourceId: { type: 'string' },
+                    targetId: { type: 'string' },
+                    strength: { type: 'number', minimum: 0, maximum: 1 },
+                    type: { type: 'string', enum: ['hard', 'soft', 'recommended'] },
+                    reasoning: { type: 'string' },
+                },
+                required: ['sourceId', 'targetId', 'strength', 'type'],
+            },
+        },
+        warnings: {
+            type: 'array',
+            items: { type: 'string' },
+        },
+    },
+    required: ['title', 'skills', 'prerequisites'],
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Prompt Builders
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Build a skill extraction prompt
+ */
+function buildExtractionPrompt(content, options) {
+    let prompt = `Analyze the following curriculum content and extract all discrete, measurable skills.\n\n`;
+    if (options?.domain) {
+        prompt += `Domain: ${options.domain}\n`;
+    }
+    if (options?.gradeLevel) {
+        prompt += `Target Audience: ${options.gradeLevel}\n`;
+    }
+    if (options?.context) {
+        prompt += `Additional Context: ${options.context}\n`;
+    }
+    prompt += `\n--- CURRICULUM CONTENT ---\n${content}\n--- END CONTENT ---\n\n`;
+    prompt += `Extract all skills from this content. For each skill, provide name, description, Bloom's level, difficulty (0-1), and identify if it's a threshold concept.`;
+    return prompt;
+}
+/**
+ * Build a prerequisite inference prompt
+ */
+function buildPrerequisitePrompt(skills, options) {
+    let prompt = `Analyze the following skills and infer prerequisite relationships between them.\n\n`;
+    if (options?.domain) {
+        prompt += `Domain: ${options.domain}\n`;
+    }
+    prompt += `\n--- SKILLS ---\n`;
+    for (const skill of skills) {
+        prompt += `ID: ${skill.id}\n`;
+        prompt += `Name: ${skill.name}\n`;
+        prompt += `Description: ${skill.description}\n`;
+        prompt += `Bloom's Level: ${skill.bloomLevel}\n`;
+        prompt += `Difficulty: ${skill.difficulty}\n\n`;
+    }
+    prompt += `--- END SKILLS ---\n\n`;
+    prompt += `For each prerequisite relationship you identify:\n`;
+    prompt += `1. Specify sourceId (prerequisite) and targetId (dependent)\n`;
+    prompt += `2. Classify as hard, soft, or recommended\n`;
+    prompt += `3. Provide strength (0-1) and reasoning\n`;
+    if (options?.inferTransitive === false) {
+        prompt += `\nNote: Only infer direct prerequisites, not transitive ones.`;
+    }
+    return prompt;
+}
+/**
+ * Build a Bloom's analysis prompt
+ */
+function buildBloomPrompt(text, context) {
+    let prompt = `Analyze the following text and determine its Bloom's Taxonomy level.\n\n`;
+    if (context) {
+        prompt += `Context: ${context}\n\n`;
+    }
+    prompt += `--- TEXT ---\n${text}\n--- END TEXT ---\n\n`;
+    prompt += `Classify this text according to Bloom's Taxonomy (remember, understand, apply, analyze, evaluate, create).`;
+    return prompt;
+}
+/**
+ * Build a curriculum decomposition prompt
+ */
+function buildDecompositionPrompt(content, options) {
+    let prompt = `Decompose the following curriculum into a complete skill graph.\n\n`;
+    if (options?.title) {
+        prompt += `Course Title: ${options.title}\n`;
+    }
+    if (options?.domain) {
+        prompt += `Domain: ${options.domain}\n`;
+    }
+    if (options?.gradeLevel) {
+        prompt += `Target Audience: ${options.gradeLevel}\n`;
+    }
+    if (options?.context) {
+        prompt += `Additional Context: ${options.context}\n`;
+    }
+    if (options?.maxDepth) {
+        prompt += `Maximum Skill Hierarchy Depth: ${options.maxDepth}\n`;
+    }
+    prompt += `\n--- CURRICULUM CONTENT ---\n${content}\n--- END CONTENT ---\n\n`;
+    prompt += `Create a complete skill graph with:\n`;
+    prompt += `1. All discrete, measurable skills with unique IDs\n`;
+    prompt += `2. Bloom's level and difficulty for each skill\n`;
+    prompt += `3. Prerequisite relationships between skills\n`;
+    prompt += `4. Identify threshold concepts that unlock understanding\n`;
+    return prompt;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/cjs/llm/prompts.js.map

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

package/dist/cjs/parsers/base.js

@@ -0,0 +1,189 @@
+"use strict";
+/**
+ * Base parser utilities
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_PARSE_OPTIONS = void 0;
+exports.extractTime = extractTime;
+exports.isObjectiveLine = isObjectiveLine;
+exports.cleanText = cleanText;
+exports.objectiveToSkillName = objectiveToSkillName;
+exports.createObjective = createObjective;
+exports.createEmptyResult = createEmptyResult;
+exports.calculateStats = calculateStats;
+const bloom_js_1 = require("../types/bloom.js");
+/**
+ * Default parse options
+ */
+exports.DEFAULT_PARSE_OPTIONS = {
+    detectBloom: true,
+    extractTime: true,
+    suggestNames: true,
+    includeRaw: false,
+    sectionHeaders: [
+        'module',
+        'chapter',
+        'unit',
+        'week',
+        'section',
+        'part',
+        'lesson',
+        'topic',
+    ],
+    objectiveMarkers: [
+        'students will be able to',
+        'learners will',
+        'by the end of this',
+        'learning objectives',
+        'objectives:',
+        'learning outcomes',
+        'outcomes:',
+        'lo:',
+        'swbat',
+        '•',
+        '-',
+        '*',
+    ],
+};
+/**
+ * Common time patterns in syllabi
+ * Note: Decimal hours pattern must come before integer hours pattern
+ */
+const TIME_PATTERNS = [
+    /(\d+)\s*(?:min(?:ute)?s?|mins?)/i,
+    /(\d+\.\d+)\s*(?:hour?s?|hrs?)/i,
+    /(\d+)\s*(?:hour?s?|hrs?)/i,
+];
+/**
+ * Extract estimated time from text
+ */
+function extractTime(text) {
+    for (const pattern of TIME_PATTERNS) {
+        const match = text.match(pattern);
+        if (match && match[1]) {
+            const value = parseFloat(match[1]);
+            if (pattern.source.includes('hour')) {
+                return Math.round(value * 60);
+            }
+            return Math.round(value);
+        }
+    }
+    return undefined;
+}
+/**
+ * Detect if a line is a learning objective
+ */
+function isObjectiveLine(line, markers) {
+    const lower = line.toLowerCase().trim();
+    return markers.some((marker) => lower.includes(marker.toLowerCase()));
+}
+/**
+ * Clean and normalize text
+ */
+function cleanText(text) {
+    return text
+        .replace(/\s+/g, ' ')
+        .replace(/^\s*[-•*]\s*/, '')
+        .replace(/^\d+\.\s*/, '')
+        .trim();
+}
+/**
+ * Generate a skill name from an objective
+ */
+function objectiveToSkillName(objective) {
+    const cleaned = cleanText(objective);
+    // Remove common prefixes
+    const prefixes = [
+        /^students will be able to\s+/i,
+        /^learners will\s+/i,
+        /^by the end of this [\w\s]+,?\s*/i,
+        /^the student will\s+/i,
+        /^understand\s+/i,
+        /^learn\s+/i,
+    ];
+    let result = cleaned;
+    for (const prefix of prefixes) {
+        result = result.replace(prefix, '');
+    }
+    // Capitalize first letter
+    result = result.charAt(0).toUpperCase() + result.slice(1);
+    // Truncate if too long
+    if (result.length > 80) {
+        result = result.substring(0, 77) + '...';
+    }
+    return result;
+}
+/**
+ * Create a learning objective from text
+ */
+function createObjective(text, section, week) {
+    const cleaned = cleanText(text);
+    const bloomLevel = (0, bloom_js_1.detectBloomLevel)(cleaned);
+    const objective = {
+        text: cleaned,
+        bloomLevel,
+        bloomConfidence: bloomLevel ? 0.8 : 0,
+        suggestedName: objectiveToSkillName(cleaned),
+    };
+    if (section !== undefined) {
+        objective.section = section;
+    }
+    if (week !== undefined) {
+        objective.week = week;
+    }
+    return objective;
+}
+/**
+ * Create empty parse result
+ */
+function createEmptyResult(source, format) {
+    return {
+        metadata: {
+            source,
+            format,
+            parsedAt: new Date().toISOString(),
+        },
+        modules: [],
+        topics: [],
+        objectives: [],
+        warnings: [],
+        stats: {
+            moduleCount: 0,
+            topicCount: 0,
+            objectiveCount: 0,
+            bloomDetectedCount: 0,
+            durationMs: 0,
+        },
+    };
+}
+/**
+ * Calculate parse statistics
+ */
+function calculateStats(result, startTime) {
+    let objectiveCount = result.objectives.length;
+    let bloomDetectedCount = result.objectives.filter((o) => o.bloomLevel).length;
+    for (const topic of result.topics) {
+        objectiveCount += topic.objectives.length;
+        bloomDetectedCount += topic.objectives.filter((o) => o.bloomLevel).length;
+    }
+    for (const mod of result.modules) {
+        objectiveCount += mod.objectives.length;
+        bloomDetectedCount += mod.objectives.filter((o) => o.bloomLevel).length;
+        for (const topic of mod.topics) {
+            objectiveCount += topic.objectives.length;
+            bloomDetectedCount += topic.objectives.filter((o) => o.bloomLevel).length;
+        }
+    }
+    const topicCount = result.topics.length +
+        result.modules.reduce((sum, m) => sum + m.topics.length, 0);
+    return {
+        moduleCount: result.modules.length,
+        topicCount,
+        objectiveCount,
+        bloomDetectedCount,
+        durationMs: Date.now() - startTime,
+    };
+}
+//# sourceMappingURL=base.js.map

package/dist/cjs/parsers/base.js.map

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