get_lesson_recommendations

Instructions

Implementation Reference

• index.ts:845-903 (handler)

  Main handler function in KnowledgeGraphManager class that implements get_lesson_recommendations tool logic: loads lessons from files, calculates similarity scores based on error patterns, observations, relations, and success rates against provided context, filters and sorts by relevance.

  async getLessonRecommendations(context: string): Promise<LessonEntity[]> {
    // Load all files containing lessons
    const lessonFiles = await this.fileManager.getFilesForEntityType('lesson');
    const allLessons: LessonEntity[] = [];
  
    // Load and merge lessons from all files
    for (const filePath of lessonFiles) {
      try {
        const fileContent = await fs.readFile(filePath, 'utf-8');
        const fileGraph = JSON.parse(fileContent);
        const lessons = fileGraph.entities.filter((e: Entity): e is LessonEntity =>
          e.entityType === 'lesson'
        );
        allLessons.push(...lessons);
      } catch (error) {
        console.error(`Error loading lessons from ${filePath}:`, error);
      }
    }
  
    // Calculate relevance scores for each lesson
    const scoredLessons = await Promise.all(
      allLessons.map(async (lesson) => {
        let score = 0;
  
        // Check error pattern fields
        if (lesson.errorPattern) {
          score += this.calculateSimilarity(lesson.errorPattern.type, context) * 0.3;
          score += this.calculateSimilarity(lesson.errorPattern.message, context) * 0.3;
          score += this.calculateSimilarity(lesson.errorPattern.context, context) * 0.2;
        }
  
        // Check observations
        const observationScores = lesson.observations.map(obs =>
          this.calculateSimilarity(obs, context)
        );
        if (observationScores.length > 0) {
          score += Math.max(...observationScores) * 0.2;
        }
  
        // Check related lessons
        const relatedLessons = await this.getRelatedLessons(lesson.name);
        if (relatedLessons.length > 0) {
          score *= 1.2; // Boost score for lessons with relations
        }
  
        // Consider success rate
        const successRate = lesson.metadata?.successRate ?? 0;
        score *= (1 + successRate) / 2; // Weight by success rate
  
        return { lesson, score };
      })
    );
  
    // Filter lessons with a minimum relevance score and sort by score
    return scoredLessons
      .filter(({ score }) => score > 0.1) // Minimum relevance threshold
      .sort((a, b) => b.score - a.score)
      .map(({ lesson }) => lesson);
  }

• index.ts:1197-1210 (registration)

  Tool registration in the ListToolsRequestSchema handler, defining name, description, and input schema.

  {
    name: "get_lesson_recommendations",
    description: "Get relevant lessons based on the current context",
    inputSchema: {
      type: "object",
      properties: {
        context: {
          type: "string",
          description: "The current context to find relevant lessons for"
        }
      },
      required: ["context"]
    }
  }

• index.ts:1251-1252 (handler)

  Dispatch case in CallToolRequestSchema handler that invokes the getLessonRecommendations method.

  case "get_lesson_recommendations":
    return { content: [{ type: "text", text: JSON.stringify(await knowledgeGraphManager.getLessonRecommendations(args.context as string), null, 2) }] };

• index.ts:69-73 (schema)

  Type definition for LessonEntity used in the tool's return type.

  interface LessonEntity extends Entity {
    errorPattern: ErrorPattern;
    metadata: Metadata;
    verificationSteps: VerificationStep[];
  }

• index.ts:761-786 (helper)

  Helper function used by getLessonRecommendations to compute similarity between context and lesson components.

  private calculateSimilarity(str1: string, str2: string): number {
    const s1 = str1.toLowerCase();
    const s2 = str2.toLowerCase();
  
    // Exact match
    if (s1 === s2) return 1;
  
    // Contains full string
    if (s1.includes(s2) || s2.includes(s1)) return 0.8;
  
    // Split into words and check for word matches
    const words1 = s1.split(/\s+/);
    const words2 = s2.split(/\s+/);
  
    const commonWords = words1.filter(w => words2.includes(w));
    if (commonWords.length > 0) {
      return 0.5 * (commonWords.length / Math.max(words1.length, words2.length));
    }
  
    // Partial word matches
    const partialMatches = words1.filter(w1 =>
      words2.some(w2 => w1.includes(w2) || w2.includes(w1))
    );
  
    return 0.3 * (partialMatches.length / Math.max(words1.length, words2.length));
  }