Angular Modernizer
    Preparing search index...

    MCP tool for analyzing parser performance metrics from transformation feedback sessions. Generates improvement recommendations based on parser behavior and efficiency.

    Multi-Session Aggregation:

    • Aggregates metrics across multiple sessions
    • Calculates average performance statistics
    • Identifies common improvement opportunities

    Location Support:

    • 'both' (default): the project, plus the platform store when ANGULAR_MODERNIZER_PLATFORM_ROOT is set
    • Automatic session deduplication by sessionId

    Implements

    Index

    Constructors

    Properties

    Methods

    Constructors

    Properties

    annotations: ToolAnnotations = ...

    Behavior hints for clients (MCP 2025-03-26); hints, not guarantees.

    description: string = ...

    Human-readable description of what the tool does.

    name: string = 'analyze-parser-performance'

    Unique tool name.

    title: string = 'Analyze Parser Performance'

    Display name for clients (MCP 2025-06-18).

    Methods

    • Execute analyze-parser-performance tool to analyze parser metrics from feedback sessions

      This method loads feedback sessions from configured storage locations (project, platform, or both), extracts parser metadata from transformations, aggregates metrics across sessions, and generates prioritized improvement recommendations.

      Parameters

      • args: Record<string, unknown>

        Tool input arguments conforming to AnalyzeParserPerformanceInput interface

        • projectRoot

          Optional project root path (default: process.cwd())

        • sessionIds

          Optional specific session IDs to analyze (default: all sessions)

        • source

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

      Returns Promise<AnalyzeParserPerformanceOutput>

      AnalyzeParserPerformanceOutput containing:

      • sessionsAnalyzed: Number of sessions that contained parser metadata
      • totalTransformations: Total transformations analyzed across all sessions
      • sourcesRead: Array of directory paths where sessions were read from
      • aggregatedMetrics: Aggregated metrics across all sessions
      • suggestions: Array of improvement suggestions sorted by priority (high → medium → low)
      • sessionMetrics: Per-session detailed metrics for comparison

      Error if feedback storage initialization fails or critical errors occur

      // Analyze all sessions from both locations
      const result = await tool.execute({
      source: 'both'
      });

      // Analyze specific sessions
      const result = await tool.execute({
      sessionIds: ['session-123', 'session-456'],
      source: 'project'
      });
      • Only sessions with parser metadata are analyzed
      • Sessions without parser metadata are silently skipped
      • Deduplicates sessions when reading from multiple locations
      • Aggregates metrics using weighted averages across sessions
      • Platform root can be overridden via ANGULAR_MODERNIZER_PLATFORM_ROOT environment variable
      • Suggestions are sorted by priority (high → medium → low)