learngraph 0.5.0 → 0.7.0

package/dist/esm/mcp/prompts.js

@@ -0,0 +1,419 @@
+/**
+ * MCP Prompt Templates
+ *
+ * Educational prompt templates for curriculum building and learning path generation.
+ *
+ * @packageDocumentation
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// Prompt Definitions
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * All available prompt templates
+ */
+export const PROMPT_DEFINITIONS = {
+    analyze_syllabus: {
+        name: 'analyze_syllabus',
+        description: 'Analyze a course syllabus and extract skills with Bloom\'s Taxonomy levels',
+        arguments: [
+            {
+                name: 'syllabus_text',
+                description: 'The syllabus content to analyze',
+                required: true,
+            },
+            {
+                name: 'course_name',
+                description: 'Name of the course (optional)',
+                required: false,
+            },
+        ],
+        template: (args) => `You are an expert curriculum designer and educational psychologist. Analyze the following syllabus and extract all learning objectives as discrete skills.
+
+For each skill, determine:
+1. A clear, concise skill name
+2. A description of what the learner will be able to do
+3. The Bloom's Taxonomy level (remember, understand, apply, analyze, evaluate, create)
+4. Estimated time to master (in minutes)
+5. Relevant tags for categorization
+
+Course: ${args.course_name || 'Unknown'}
+
+Syllabus:
+${args.syllabus_text}
+
+Use the create_skill tool to add each skill to the knowledge graph. After creating skills, identify prerequisite relationships and use create_prerequisite to link them.
+
+Focus on creating a coherent learning progression that respects cognitive load and builds from foundational to advanced concepts.`,
+    },
+    generate_learning_path: {
+        name: 'generate_learning_path',
+        description: 'Generate a personalized learning path for a student',
+        arguments: [
+            {
+                name: 'target_skill',
+                description: 'The skill the learner wants to achieve',
+                required: true,
+            },
+            {
+                name: 'mastered_skills',
+                description: 'Comma-separated list of skills already mastered',
+                required: false,
+            },
+            {
+                name: 'time_available',
+                description: 'Available study time per session in minutes',
+                required: false,
+            },
+        ],
+        template: (args) => `You are a personalized learning coach. Create an optimal learning path for a student.
+
+Target Skill: ${args.target_skill}
+Already Mastered: ${args.mastered_skills || 'None specified'}
+Time Available: ${args.time_available || '30'} minutes per session
+
+First, use the search_skills tool to find the target skill. Then use get_learning_path to generate the recommended path.
+
+For each skill in the path:
+1. Explain why this skill is necessary
+2. Suggest learning resources or activities
+3. Provide practice exercises appropriate for the Bloom's level
+4. Estimate time needed based on the skill's complexity
+
+Present the path as a numbered journey, highlighting:
+- Prerequisites that must be completed first
+- Skills in the Zone of Proximal Development
+- The final target skill
+
+Include motivational checkpoints and suggest review intervals based on spaced repetition principles.`,
+    },
+    identify_prerequisites: {
+        name: 'identify_prerequisites',
+        description: 'Identify prerequisite relationships between skills',
+        arguments: [
+            {
+                name: 'skill_list',
+                description: 'Comma-separated list of skill names to analyze',
+                required: true,
+            },
+            {
+                name: 'domain',
+                description: 'The subject domain (e.g., mathematics, programming, biology)',
+                required: false,
+            },
+        ],
+        template: (args) => `You are an expert in educational prerequisite mapping. Analyze the following skills and determine which ones are prerequisites for others.
+
+Skills to analyze: ${args.skill_list}
+Domain: ${args.domain || 'General'}
+
+For each potential prerequisite relationship, consider:
+1. **Conceptual Dependency**: Does understanding skill A require understanding skill B first?
+2. **Procedural Dependency**: Does performing skill A require the ability to perform skill B?
+3. **Strength**: How essential is this prerequisite? (0.0-1.0)
+   - 1.0: Absolutely required (hard prerequisite)
+   - 0.7-0.9: Strongly recommended
+   - 0.4-0.6: Helpful but not essential (soft prerequisite)
+4. **Type**: Is this a hard, soft, or recommended prerequisite?
+
+Use the search_skills tool to find each skill, then use create_prerequisite to establish the relationships.
+
+Avoid creating cycles in the dependency graph. If A → B and B → C, don't create A → C unless there's a direct conceptual reason.`,
+    },
+    zpd_recommendations: {
+        name: 'zpd_recommendations',
+        description: 'Get personalized skill recommendations in the Zone of Proximal Development',
+        arguments: [
+            {
+                name: 'learner_profile',
+                description: 'JSON description of learner including mastered skills and goals',
+                required: true,
+            },
+            {
+                name: 'session_time',
+                description: 'Available time for this learning session in minutes',
+                required: false,
+            },
+        ],
+        template: (args) => `You are an adaptive learning system implementing Vygotsky's Zone of Proximal Development (ZPD).
+
+Learner Profile: ${args.learner_profile}
+Session Time: ${args.session_time || '45'} minutes
+
+Use the get_zpd_skills tool with the learner's mastered skill IDs to find skills they're ready to learn.
+
+For each recommended skill:
+1. Explain why this skill is in their ZPD
+2. Connect it to skills they've already mastered
+3. Suggest scaffolding strategies
+4. Provide concrete activities appropriate for the Bloom's level:
+   - Remember: Flashcards, recall exercises
+   - Understand: Explanations, summarizations
+   - Apply: Practice problems, simulations
+   - Analyze: Case studies, comparisons
+   - Evaluate: Critiques, decision-making scenarios
+   - Create: Projects, original work
+
+Prioritize skills that:
+- Have all prerequisites mastered
+- Align with the learner's stated goals
+- Fit within the available session time
+- Build toward more advanced competencies`,
+    },
+    curriculum_validation: {
+        name: 'curriculum_validation',
+        description: 'Validate a curriculum for pedagogical soundness',
+        arguments: [
+            {
+                name: 'focus_area',
+                description: 'Specific area to focus validation on (optional)',
+                required: false,
+            },
+        ],
+        template: (args) => `You are an educational quality assurance specialist. Validate the current curriculum for pedagogical soundness.
+
+Focus Area: ${args.focus_area || 'Complete curriculum'}
+
+Use the following tools in sequence:
+1. validate_curriculum - Check for structural issues
+2. get_graph_stats - Understand the curriculum structure
+3. list_skills - Review all skills
+
+Evaluate against these criteria:
+
+**Structural Integrity**
+- No circular dependencies
+- All skills are reachable from entry points
+- No orphaned skills without connections
+
+**Bloom's Taxonomy Progression**
+- Lower levels generally precede higher levels
+- Appropriate distribution across cognitive levels
+- Complex skills have adequate foundational prerequisites
+
+**Time Estimates**
+- Reasonable time allocations for each skill
+- Total learning time is feasible
+- Complex topics have sufficient depth
+
+**Coverage**
+- No significant gaps in the learning progression
+- Skills build logically toward competency
+- Tags and categories are consistent
+
+Provide a detailed report with:
+- Summary of findings
+- Critical issues requiring immediate attention
+- Recommendations for improvement
+- Suggestions for additional skills or relationships`,
+    },
+    gap_analysis: {
+        name: 'gap_analysis',
+        description: 'Analyze gaps between learner\'s current state and target competencies',
+        arguments: [
+            {
+                name: 'current_skills',
+                description: 'Comma-separated list of currently mastered skills',
+                required: true,
+            },
+            {
+                name: 'target_competency',
+                description: 'The target competency or role requirements',
+                required: true,
+            },
+        ],
+        template: (args) => `You are a competency gap analyst. Analyze the distance between a learner's current state and target competency.
+
+Current Skills: ${args.current_skills}
+Target Competency: ${args.target_competency}
+
+Steps:
+1. Use search_skills to find skills matching the target competency
+2. For each target skill, use get_learning_path to find required prerequisites
+3. Compare against the learner's current skills
+4. Calculate the skill gap
+
+Provide analysis including:
+
+**Gap Summary**
+- Total skills needed to reach target
+- Estimated total learning time
+- Percentage of path already completed
+
+**Priority Skills**
+- Critical skills blocking multiple pathways
+- Quick wins (easily achievable with current knowledge)
+- High-impact skills that unlock many dependents
+
+**Learning Roadmap**
+- Suggested order of skill acquisition
+- Milestones and checkpoints
+- Estimated timeline with realistic pacing
+
+**Risk Assessment**
+- Skills that may be particularly challenging
+- Potential bottlenecks in the learning path
+- Prerequisites that may need reinforcement`,
+    },
+    create_assessment: {
+        name: 'create_assessment',
+        description: 'Create an assessment for a specific skill',
+        arguments: [
+            {
+                name: 'skill_id',
+                description: 'The skill ID to assess',
+                required: true,
+            },
+            {
+                name: 'difficulty',
+                description: 'Assessment difficulty (easy, medium, hard)',
+                required: false,
+            },
+            {
+                name: 'question_count',
+                description: 'Number of questions to generate',
+                required: false,
+            },
+        ],
+        template: (args) => `You are an assessment designer creating formative assessments aligned with learning objectives.
+
+Skill ID: ${args.skill_id}
+Difficulty: ${args.difficulty || 'medium'}
+Question Count: ${args.question_count || '5'}
+
+First, use get_skill to retrieve the skill details including its Bloom's Taxonomy level.
+
+Design questions that:
+
+1. **Align with Bloom's Level**
+   - Remember: Recognition, recall questions
+   - Understand: Explanation, interpretation
+   - Apply: Problem-solving, procedural
+   - Analyze: Pattern identification, comparisons
+   - Evaluate: Judgment, critique questions
+   - Create: Open-ended, design challenges
+
+2. **Use Appropriate Formats**
+   - Multiple choice for lower Bloom's levels
+   - Short answer for mid-levels
+   - Extended response for higher levels
+   - Performance tasks for application/creation
+
+3. **Include Scaffolding**
+   - Start with easier questions
+   - Build complexity gradually
+   - Provide hints or partial solutions where appropriate
+
+4. **Enable Mastery Assessment**
+   - Clear success criteria
+   - Rubrics for subjective questions
+   - Passing threshold aligned with skill's mastery threshold
+
+Output the assessment as a structured JSON with:
+- Question text
+- Question type
+- Correct answer(s)
+- Distractors (for multiple choice)
+- Point value
+- Bloom's level targeted`,
+    },
+    explain_concept: {
+        name: 'explain_concept',
+        description: 'Generate a multi-level explanation of a concept from the curriculum',
+        arguments: [
+            {
+                name: 'skill_id',
+                description: 'The skill ID to explain',
+                required: true,
+            },
+            {
+                name: 'learner_level',
+                description: 'Learner level (beginner, intermediate, advanced)',
+                required: false,
+            },
+        ],
+        template: (args) => `You are an expert educator skilled at explaining concepts at multiple levels of complexity.
+
+Skill ID: ${args.skill_id}
+Learner Level: ${args.learner_level || 'intermediate'}
+
+First, use get_skill to retrieve the skill details and use get_prerequisites to understand the foundational concepts.
+
+Create a comprehensive explanation including:
+
+**Core Concept (ELI5)**
+A simple explanation that a beginner could understand. Use analogies and everyday examples.
+
+**Technical Definition**
+A precise, formal definition suitable for reference.
+
+**Prerequisites Recap**
+Brief review of prerequisite concepts that support understanding.
+
+**Detailed Explanation**
+Step-by-step breakdown appropriate for the learner's level.
+
+**Examples**
+- Simple worked example
+- More complex example showing edge cases
+- Common mistakes to avoid
+
+**Connections**
+- How this skill relates to other skills in the graph
+- Real-world applications
+- Why this skill matters
+
+**Practice Suggestions**
+- Activities to reinforce understanding
+- Resources for further learning
+- Next skills to explore in the learning path
+
+Adapt language complexity, example sophistication, and depth based on the specified learner level.`,
+    },
+};
+/**
+ * Get prompt metadata for MCP listing
+ */
+export function getPromptMetas() {
+    return Object.values(PROMPT_DEFINITIONS).map((def) => {
+        const result = {
+            name: def.name,
+        };
+        if (def.description !== undefined) {
+            result.description = def.description;
+        }
+        if (def.arguments !== undefined) {
+            result.arguments = def.arguments;
+        }
+        return result;
+    });
+}
+/**
+ * Render a prompt with arguments
+ */
+export function renderPrompt(promptName, args) {
+    const prompt = PROMPT_DEFINITIONS[promptName];
+    if (!prompt) {
+        return null;
+    }
+    return prompt.template(args);
+}
+/**
+ * Get a prompt definition by name
+ */
+export function getPromptDefinition(promptName) {
+    const def = PROMPT_DEFINITIONS[promptName];
+    if (!def) {
+        return null;
+    }
+    const result = {
+        name: def.name,
+    };
+    if (def.description !== undefined) {
+        result.description = def.description;
+    }
+    if (def.arguments !== undefined) {
+        result.arguments = def.arguments;
+    }
+    return result;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/esm/mcp/prompts.js.map

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