Class SuggestImprovementsTool

constructor

• new SuggestImprovementsTool(): SuggestImprovementsTool

  Returns SuggestImprovementsTool

annotations

description

name

title

execute

• execute(args: Record<string, unknown>): Promise<SuggestImprovementsOutput>

  Execute suggest-improvements tool to generate actionable rule improvement suggestions

  This method loads feedback for a specific rule from configured storage locations, calculates current performance metrics (success rate, duration, quality), generates improvement suggestions based on detected patterns (failures, approaches, quality trends), and returns actionable recommendations that require human approval.

  Parameters

  • args: Record<string, unknown>

    Tool input arguments conforming to SuggestImprovementsInput interface

    • ruleId

      Rule identifier to analyze (e.g., 'standalone-migration', 'constructor-to-inject')

    • minConfidence

      Minimum confidence threshold 0.0-1.0 (default: 0.7)

    • source

      Storage location strategy: 'project', 'platform', or 'both' (default: 'both')

  Returns Promise<SuggestImprovementsOutput>

  SuggestImprovementsOutput containing:

  • ruleId: Rule identifier analyzed
  • currentPerformance: Performance metrics (successRate, avgDuration, qualityImprovement)
  • suggestions: Array of Suggestion objects sorted by confidence
  • feedbackCount: Number of feedback records analyzed for this rule
  • sourcesRead: Array of directory paths where feedback was read from

  Throws

  Error if feedback storage initialization fails or critical errors occur

  Example

  // Analyze standalone migration rule
  const result = await tool.execute({
    ruleId: 'standalone-migration',
    minConfidence: 0.8
  });
  
  // Analyze specific rule from project only
  const result = await tool.execute({
    ruleId: 'constructor-to-inject',
    source: 'project',
    minConfidence: 0.7
  });
  Copy

  Remarks

  • Suggestions filtered by minConfidence threshold
  • All suggestions have requiresApproval: true
  • The platform store is read only when ANGULAR_MODERNIZER_PLATFORM_ROOT is set
  • Suggestions are sorted by confidence in descending order
  • Requires at least 2 feedback records to generate suggestions