mcp-adr-analysis-server 2.1.9 → 2.1.20

package/dist/src/utils/mermaid-diagrams.js

@@ -0,0 +1,445 @@
+/**
+ * Mermaid Diagram Generation Utilities
+ *
+ * Provides standardized mermaid diagram generation for ADRs and documentation.
+ * Supports workflow diagrams, sequence diagrams, state diagrams, and more.
+ */
+// ============================================================================
+// Interactive ADR Planning Diagrams
+// ============================================================================
+/**
+ * Generate workflow diagram for interactive ADR planning
+ */
+export function generateInteractiveADRWorkflow(phases, currentPhase) {
+    const sortedPhases = phases.sort((a, b) => a.order - b.order);
+    let diagram = '```mermaid\ngraph LR\n';
+    sortedPhases.forEach((phase, index) => {
+        const nodeId = `P${index + 1}`;
+        const nextNodeId = `P${index + 2}`;
+        // Add styling based on status
+        let style = '';
+        if (phase.status === 'completed') {
+            style = ':::completed';
+        }
+        else if (phase.status === 'in_progress' || phase.id === currentPhase) {
+            style = ':::inProgress';
+        }
+        else {
+            style = ':::pending';
+        }
+        // Format node label
+        const label = phase.name.replace(/\n/g, '<br/>');
+        diagram += `    ${nodeId}["${label}"]${style}\n`;
+        // Add connection to next phase
+        if (index < sortedPhases.length - 1) {
+            diagram += `    ${nodeId} --> ${nextNodeId}\n`;
+        }
+    });
+    // Add styling definitions
+    diagram += '\n';
+    diagram += '    classDef completed fill:#d4edda,stroke:#28a745,stroke-width:2px\n';
+    diagram += '    classDef inProgress fill:#fff3cd,stroke:#ffc107,stroke-width:3px\n';
+    diagram += '    classDef pending fill:#f8f9fa,stroke:#6c757d,stroke-width:1px\n';
+    diagram += '```\n';
+    return diagram;
+}
+/**
+ * Generate detailed phase breakdown diagram
+ */
+export function generateADRPlanningDetailedFlow() {
+    return `\`\`\`mermaid
+graph TB
+    Start([Start ADR Planning]) --> P1[Problem Definition]
+
+    P1 --> P1A[Clarify Challenge]
+    P1A --> P1B[Identify Stakeholders]
+    P1B --> P1C[Define Success Criteria]
+    P1C --> P2[Research & Analysis]
+
+    P2 --> P2A[Gather Context]
+    P2A --> P2B[Review Documentation]
+    P2B --> P2C[Analyze Codebase]
+    P2C --> P3[Option Exploration]
+
+    P3 --> P3A[Identify Alternatives]
+    P3A --> P3B[Evaluate Pros/Cons]
+    P3B --> P3C[Assess Risks]
+    P3C --> P4[Decision Making]
+
+    P4 --> P4A[Select Approach]
+    P4A --> P4B[Document Rationale]
+    P4B --> P4C[Define Tradeoffs]
+    P4C --> P5[Impact Assessment]
+
+    P5 --> P5A[Technical Impact]
+    P5A --> P5B[Business Impact]
+    P5B --> P5C[Team Impact]
+    P5C --> P6[Implementation Planning]
+
+    P6 --> P6A[Generate TODOs]
+    P6A --> P6B[Estimate Timeline]
+    P6B --> P6C[Identify Dependencies]
+    P6C --> P7[ADR Generation]
+
+    P7 --> P7A[Create Document]
+    P7A --> P7B[Add Diagrams]
+    P7B --> P7C[Review & Finalize]
+    P7C --> End([ADR Complete])
+
+    style Start fill:#e1f5ff
+    style End fill:#d4edda
+    style P4 fill:#fff3cd
+    style P7 fill:#d1ecf1
+\`\`\`
+`;
+}
+// ============================================================================
+// Deployment Guidance Diagrams
+// ============================================================================
+/**
+ * Generate deployment sequence diagram
+ */
+export function generateDeploymentSequence(steps, environment = 'production') {
+    let diagram = '```mermaid\nsequenceDiagram\n';
+    diagram += `    participant User as Developer\n`;
+    diagram += `    participant Tool as Deployment Tool\n`;
+    diagram += `    participant ADR as ADR Documents\n`;
+    diagram += `    participant Script as Deploy Scripts\n`;
+    diagram += `    participant Env as ${environment.charAt(0).toUpperCase() + environment.slice(1)} Environment\n\n`;
+    // Add sequence steps
+    steps.forEach((step, index) => {
+        const from = step.participant || 'Tool';
+        const to = step.target || 'Env';
+        const message = step.action;
+        diagram += `    ${from}->>${to}: ${message}\n`;
+        if (step.validation) {
+            diagram += `    ${to}-->>Tool: ${step.validation}\n`;
+        }
+        if (index < steps.length - 1 && step.phase !== steps[index + 1]?.phase) {
+            diagram += `\n    Note over User,Env: Phase ${index + 1} Complete\n\n`;
+        }
+    });
+    diagram += '```\n';
+    return diagram;
+}
+/**
+ * Generate deployment workflow diagram
+ */
+export function generateDeploymentWorkflow(platform, phases) {
+    let diagram = '```mermaid\nflowchart TD\n';
+    diagram += `    Start([Start Deployment]) --> Detect[Detect Platform]\n`;
+    diagram += `    Detect --> Platform{Platform:<br/>${platform}}\n`;
+    diagram += `    Platform --> LoadADR[Read ADR Decisions]\n`;
+    diagram += `    LoadADR --> GenScripts[Generate Deploy Scripts]\n\n`;
+    // Add phases
+    phases.forEach((phase, index) => {
+        const phaseId = `Phase${index + 1}`;
+        diagram += `    ${index === 0 ? 'GenScripts' : `Phase${index}`} --> ${phaseId}[${phase}]\n`;
+    });
+    const lastPhaseId = `Phase${phases.length}`;
+    diagram += `\n    ${lastPhaseId} --> Validate{Validation<br/>Passed?}\n`;
+    diagram += `    Validate -->|No| Fix[Auto-fix Issues]\n`;
+    diagram += `    Fix --> ${lastPhaseId}\n`;
+    diagram += `    Validate -->|Yes| Success([✅ Deployment Success])\n\n`;
+    // Add styling
+    diagram += `    style Start fill:#e1f5ff\n`;
+    diagram += `    style Platform fill:#fff3cd\n`;
+    diagram += `    style Success fill:#d4edda\n`;
+    diagram += `    style Fix fill:#f8d7da\n`;
+    diagram += '```\n';
+    return diagram;
+}
+// ============================================================================
+// ADR Suggestion Diagrams
+// ============================================================================
+/**
+ * Generate implicit decision detection flow
+ */
+export function generateImplicitDecisionFlow() {
+    return `\`\`\`mermaid
+graph TB
+    Start([Scan Codebase]) --> Analyze[Code Analysis]
+
+    Analyze --> TreeSitter[Tree-sitter AST<br/>Parsing]
+    Analyze --> Pattern[Pattern Detection]
+    Analyze --> Deps[Dependency Analysis]
+
+    TreeSitter --> Detect[Detect Implicit<br/>Decisions]
+    Pattern --> Detect
+    Deps --> Detect
+
+    Detect --> Type{Decision<br/>Type?}
+
+    Type -->|Architecture| A1[Layered Architecture]
+    Type -->|Architecture| A2[Microservices]
+    Type -->|Architecture| A3[Event-Driven]
+
+    Type -->|Technology| T1[Framework Choice]
+    Type -->|Technology| T2[Database Selection]
+    Type -->|Technology| T3[Build Tools]
+
+    Type -->|Security| S1[Authentication]
+    Type -->|Security| S2[Authorization]
+    Type -->|Security| S3[Encryption]
+
+    Type -->|Performance| P1[Caching Strategy]
+    Type -->|Performance| P2[Load Balancing]
+    Type -->|Performance| P3[Optimization]
+
+    A1 --> Priority[Prioritize Suggestions]
+    A2 --> Priority
+    A3 --> Priority
+    T1 --> Priority
+    T2 --> Priority
+    T3 --> Priority
+    S1 --> Priority
+    S2 --> Priority
+    S3 --> Priority
+    P1 --> Priority
+    P2 --> Priority
+    P3 --> Priority
+
+    Priority --> Confidence{Confidence<br/>>80%?}
+    Confidence -->|Yes| High[High Priority ADR]
+    Confidence -->|No| Review[Requires Review]
+
+    High --> Output[Generate ADR<br/>Suggestions]
+    Review --> Output
+
+    Output --> End([Present to User])
+
+    style Start fill:#e1f5ff
+    style Detect fill:#fff3cd
+    style Type fill:#fff3cd
+    style High fill:#d4edda
+    style Review fill:#f8d7da
+    style End fill:#d1ecf1
+\`\`\`
+`;
+}
+/**
+ * Generate code change analysis flow
+ */
+export function generateCodeChangeAnalysisFlow() {
+    return `\`\`\`mermaid
+sequenceDiagram
+    participant User as Developer
+    participant Tool as ADR Suggestion Tool
+    participant Code as Codebase
+    participant AI as AI Analysis
+    participant ADR as ADR Suggestions
+
+    User->>Tool: Provide code changes
+    Tool->>Code: Analyze before code
+    Tool->>Code: Analyze after code
+    Code-->>Tool: Code differences
+
+    Tool->>AI: Semantic analysis
+    AI->>AI: Detect architectural impact
+    AI->>AI: Identify decision patterns
+    AI-->>Tool: Analysis results
+
+    Tool->>Tool: Classify changes
+    Note over Tool: Architecture, Security,<br/>Performance, Data
+
+    Tool->>ADR: Generate suggestions
+    ADR->>ADR: Rank by importance
+    ADR->>ADR: Add context & rationale
+    ADR-->>User: Prioritized ADR list
+
+    User->>User: Review suggestions
+    User->>ADR: Approve ADR creation
+\`\`\`
+`;
+}
+// ============================================================================
+// Deployment Readiness Diagrams
+// ============================================================================
+/**
+ * Generate deployment readiness validation flow
+ */
+export function generateDeploymentReadinessFlow(strictMode = true) {
+    const tolerance = strictMode ? '0 failures' : 'Low tolerance';
+    return `\`\`\`mermaid
+flowchart TD
+    Start([Check Deployment Readiness]) --> Tests[Run All Tests]
+
+    Tests --> Unit[Unit Tests]
+    Tests --> Integration[Integration Tests]
+    Tests --> E2E[End-to-End Tests]
+
+    Unit --> Coverage{Test Coverage<br/>≥80%?}
+    Integration --> Coverage
+    E2E --> Coverage
+
+    Coverage -->|No| Block1[❌ BLOCKED<br/>Insufficient Coverage]
+    Coverage -->|Yes| Failures{Test<br/>Failures?}
+
+    Failures -->|Yes| Block2[❌ BLOCKED<br/>${tolerance}]
+    Failures -->|No| Quality[Code Quality Checks]
+
+    Quality --> Lint[Linting]
+    Quality --> Type[Type Checking]
+    Quality --> Format[Formatting]
+
+    Lint --> QualityPass{All Checks<br/>Pass?}
+    Type --> QualityPass
+    Format --> QualityPass
+
+    QualityPass -->|No| Block3[❌ BLOCKED<br/>Quality Issues]
+    QualityPass -->|Yes| ADR[ADR Compliance Check]
+
+    ADR --> Impl{All ADRs<br/>Implemented?}
+    Impl -->|No| Block4[❌ BLOCKED<br/>Missing Implementation]
+    Impl -->|Yes| Mock[Mock vs Production Check]
+
+    Mock --> RealCode{Production-Ready<br/>Code?}
+    RealCode -->|No| Block5[❌ BLOCKED<br/>Mock Implementation]
+    RealCode -->|Yes| Config[Configuration Validation]
+
+    Config --> Secrets{Secrets<br/>Configured?}
+    Secrets -->|No| Block6[❌ BLOCKED<br/>Missing Secrets]
+    Secrets -->|Yes| Env{Environment<br/>Variables Set?}
+
+    Env -->|No| Block7[❌ BLOCKED<br/>Missing Env Vars]
+    Env -->|Yes| Ready[✅ READY TO DEPLOY]
+
+    Ready --> Score[Deployment Score:<br/>100/100]
+
+    Block1 --> Report[Generate Detailed<br/>Failure Report]
+    Block2 --> Report
+    Block3 --> Report
+    Block4 --> Report
+    Block5 --> Report
+    Block6 --> Report
+    Block7 --> Report
+
+    Report --> Remediation[Provide Fix Steps]
+
+    style Start fill:#e1f5ff
+    style Ready fill:#d4edda
+    style Score fill:#d4edda
+    style Block1 fill:#f8d7da
+    style Block2 fill:#f8d7da
+    style Block3 fill:#f8d7da
+    style Block4 fill:#f8d7da
+    style Block5 fill:#f8d7da
+    style Block6 fill:#f8d7da
+    style Block7 fill:#f8d7da
+    style Report fill:#fff3cd
+\`\`\`
+`;
+}
+/**
+ * Generate test validation pyramid
+ */
+export function generateTestValidationPyramid() {
+    return `\`\`\`mermaid
+graph TB
+    subgraph "Test Pyramid"
+        E2E[End-to-End Tests<br/>10% of tests]
+        Integration[Integration Tests<br/>30% of tests]
+        Unit[Unit Tests<br/>60% of tests]
+    end
+
+    E2E --> Integration
+    Integration --> Unit
+
+    Unit --> Coverage{Coverage<br/>≥80%?}
+    Coverage -->|Yes| Pass[✅ Tests Pass]
+    Coverage -->|No| Fail[❌ Blocked]
+
+    style E2E fill:#fff3cd
+    style Integration fill:#cfe2ff
+    style Unit fill:#e1f5ff
+    style Pass fill:#d4edda
+    style Fail fill:#f8d7da
+\`\`\`
+`;
+}
+// ============================================================================
+// Tool Chain Orchestrator Diagrams
+// ============================================================================
+/**
+ * Generate tool orchestration flow
+ */
+export function generateToolOrchestrationFlow(tools) {
+    let diagram = '```mermaid\ngraph LR\n';
+    diagram += '    Start([User Request]) --> AI[AI Planning]\n';
+    diagram += '    AI --> Analyze[Analyze Request]\n';
+    diagram += '    Analyze --> Plan[Generate Tool Sequence]\n\n';
+    const sortedTools = tools.sort((a, b) => a.order - b.order);
+    sortedTools.forEach((tool, index) => {
+        const toolId = `T${index + 1}`;
+        diagram += `    ${index === 0 ? 'Plan' : `T${index}`} --> ${toolId}[${tool.name}]\n`;
+        if (tool.depends && tool.depends.length > 0) {
+            diagram += `    Note right of ${toolId}: Depends on:<br/>${tool.depends.join(', ')}\n`;
+        }
+    });
+    const lastToolId = `T${sortedTools.length}`;
+    diagram += `\n    ${lastToolId} --> Validate{All Tools<br/>Succeeded?}\n`;
+    diagram += `    Validate -->|No| Retry[Retry Failed Tools]\n`;
+    diagram += `    Retry --> ${lastToolId}\n`;
+    diagram += `    Validate -->|Yes| Result[Combine Results]\n`;
+    diagram += `    Result --> End([Return to User])\n\n`;
+    // Add styling
+    diagram += '    style Start fill:#e1f5ff\n';
+    diagram += '    style AI fill:#fff3cd\n';
+    diagram += '    style End fill:#d4edda\n';
+    diagram += '    style Retry fill:#f8d7da\n';
+    diagram += '```\n';
+    return diagram;
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Sanitize text for mermaid diagram labels
+ */
+export function sanitizeMermaidLabel(text) {
+    return text.replace(/"/g, "'").replace(/\[/g, '(').replace(/]/g, ')').replace(/\n/g, '<br/>');
+}
+/**
+ * Generate a simple state diagram
+ */
+export function generateStateFlow(states) {
+    let diagram = '```mermaid\nstateDiagram-v2\n';
+    states.forEach((state, index) => {
+        if (state.type === 'start') {
+            diagram += `    [*] --> ${state.id}\n`;
+        }
+        diagram += `    ${state.id}: ${sanitizeMermaidLabel(state.label)}\n`;
+        if (index < states.length - 1) {
+            diagram += `    ${state.id} --> ${states[index + 1]?.id}\n`;
+        }
+        if (state.type === 'end') {
+            diagram += `    ${state.id} --> [*]\n`;
+        }
+    });
+    diagram += '```\n';
+    return diagram;
+}
+// ============================================================================
+// Export all diagram generators
+// ============================================================================
+export const MermaidDiagrams = {
+    // Interactive ADR Planning
+    generateInteractiveADRWorkflow,
+    generateADRPlanningDetailedFlow,
+    // Deployment Guidance
+    generateDeploymentSequence,
+    generateDeploymentWorkflow,
+    // ADR Suggestions
+    generateImplicitDecisionFlow,
+    generateCodeChangeAnalysisFlow,
+    // Deployment Readiness
+    generateDeploymentReadinessFlow,
+    generateTestValidationPyramid,
+    // Tool Orchestration
+    generateToolOrchestrationFlow,
+    // Helpers
+    sanitizeMermaidLabel,
+    generateStateFlow,
+};
+export default MermaidDiagrams;
+//# sourceMappingURL=mermaid-diagrams.js.map

package/dist/src/utils/mermaid-diagrams.js.map

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

package/dist/src/utils/monitoring.d.ts

@@ -0,0 +1,249 @@
+/**
+ * Monitoring and Analytics Framework
+ *
+ * Provides comprehensive monitoring and analytics for MCP server:
+ * - Request/response tracking
+ * - Performance metrics (latency, throughput)
+ * - Error tracking and reporting
+ * - Resource usage analytics
+ * - Cache performance metrics
+ * - Tool execution metrics
+ * - Health checks
+ * - Metrics aggregation and reporting
+ */
+/**
+ * Metric types for categorization
+ */
+export declare enum MetricType {
+    COUNTER = "counter",
+    GAUGE = "gauge",
+    HISTOGRAM = "histogram",
+    TIMER = "timer"
+}
+/**
+ * Metric category for organization
+ */
+export declare enum MetricCategory {
+    REQUEST = "request",
+    RESOURCE = "resource",
+    TOOL = "tool",
+    CACHE = "cache",
+    ERROR = "error",
+    PERFORMANCE = "performance",
+    SYSTEM = "system"
+}
+/**
+ * Individual metric data point
+ */
+export interface Metric {
+    name: string;
+    type: MetricType;
+    category: MetricCategory;
+    value: number;
+    timestamp: string;
+    tags?: Record<string, string>;
+    metadata?: Record<string, any>;
+}
+/**
+ * Aggregated metric statistics
+ */
+export interface MetricStats {
+    count: number;
+    sum: number;
+    min: number;
+    max: number;
+    avg: number;
+    p50: number;
+    p95: number;
+    p99: number;
+}
+/**
+ * Health check result
+ */
+export interface HealthCheck {
+    name: string;
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    message?: string;
+    timestamp: string;
+    duration: number;
+    metadata?: Record<string, any>;
+}
+/**
+ * Request tracking data
+ */
+export interface RequestMetrics {
+    requestId: string;
+    type: 'tool' | 'resource' | 'prompt';
+    name: string;
+    startTime: string;
+    endTime?: string;
+    duration?: number;
+    status: 'pending' | 'success' | 'error';
+    error?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Performance snapshot
+ */
+export interface PerformanceSnapshot {
+    timestamp: string;
+    requests: {
+        total: number;
+        success: number;
+        error: number;
+        pending: number;
+    };
+    latency: {
+        p50: number;
+        p95: number;
+        p99: number;
+        avg: number;
+    };
+    throughput: {
+        requestsPerSecond: number;
+        requestsPerMinute: number;
+    };
+    cache: {
+        hitRate: number;
+        totalHits: number;
+        totalMisses: number;
+    };
+    errors: {
+        total: number;
+        byType: Record<string, number>;
+    };
+}
+/**
+ * Monitoring configuration
+ */
+export interface MonitoringConfig {
+    enabled: boolean;
+    metricsRetentionMs: number;
+    aggregationIntervalMs: number;
+    maxMetricsInMemory: number;
+    enableHealthChecks: boolean;
+    healthCheckIntervalMs: number;
+}
+/**
+ * Monitoring manager class
+ */
+export declare class MonitoringManager {
+    private config;
+    private metrics;
+    private requests;
+    private healthChecks;
+    private aggregationTimer;
+    private healthCheckTimer;
+    private startTime;
+    constructor(config?: Partial<MonitoringConfig>);
+    /**
+     * Record a counter metric (incrementing value)
+     */
+    recordCounter(name: string, category: MetricCategory, value?: number, tags?: Record<string, string>, metadata?: Record<string, any>): void;
+    /**
+     * Record a gauge metric (point-in-time value)
+     */
+    recordGauge(name: string, category: MetricCategory, value: number, tags?: Record<string, string>, metadata?: Record<string, any>): void;
+    /**
+     * Record a histogram value (for distribution analysis)
+     */
+    recordHistogram(name: string, category: MetricCategory, value: number, tags?: Record<string, string>, metadata?: Record<string, any>): void;
+    /**
+     * Start tracking a request
+     */
+    startRequest(requestId: string, type: 'tool' | 'resource' | 'prompt', name: string, metadata?: Record<string, any>): void;
+    /**
+     * Complete a request successfully
+     */
+    completeRequest(requestId: string, metadata?: Record<string, any>): void;
+    /**
+     * Mark a request as failed
+     */
+    failRequest(requestId: string, error: string, metadata?: Record<string, any>): void;
+    /**
+     * Record cache hit
+     */
+    recordCacheHit(cacheKey: string): void;
+    /**
+     * Record cache miss
+     */
+    recordCacheMiss(cacheKey: string): void;
+    /**
+     * Register a health check
+     */
+    registerHealthCheck(_name: string, _check: () => Promise<{
+        status: 'healthy' | 'degraded' | 'unhealthy';
+        message?: string;
+    }>): void;
+    /**
+     * Run a health check
+     */
+    runHealthCheck(name: string, check: () => Promise<{
+        status: 'healthy' | 'degraded' | 'unhealthy';
+        message?: string;
+    }>): Promise<HealthCheck>;
+    /**
+     * Get all health checks
+     */
+    getHealthChecks(): HealthCheck[];
+    /**
+     * Get overall health status
+     */
+    getHealthStatus(): 'healthy' | 'degraded' | 'unhealthy';
+    /**
+     * Get performance snapshot
+     */
+    getPerformanceSnapshot(): PerformanceSnapshot;
+    /**
+     * Get metric statistics by name and category
+     */
+    getMetricStats(name: string, category: MetricCategory): MetricStats | null;
+    /**
+     * Get all metrics
+     */
+    getMetrics(): Metric[];
+    /**
+     * Get metrics by category
+     */
+    getMetricsByCategory(category: MetricCategory): Metric[];
+    /**
+     * Get recent requests
+     */
+    getRecentRequests(limit?: number): RequestMetrics[];
+    /**
+     * Clear old metrics based on retention policy
+     */
+    cleanup(): number;
+    /**
+     * Reset all metrics
+     */
+    reset(): void;
+    /**
+     * Stop monitoring
+     */
+    stop(): void;
+    /**
+     * Get uptime in milliseconds
+     */
+    getUptime(): number;
+    /**
+     * Export metrics to JSON
+     */
+    exportMetrics(): string;
+    private addMetric;
+    private getMetricSum;
+    private calculatePercentiles;
+    private calculateStats;
+    private percentile;
+    private startAggregation;
+    private startHealthChecks;
+}
+/**
+ * Singleton monitoring instance
+ */
+export declare const monitoring: MonitoringManager;
+/**
+ * Helper to track async operations
+ */
+export declare function trackOperation<T>(operation: () => Promise<T>, name: string, category: MetricCategory, tags?: Record<string, string>): Promise<T>;
+//# sourceMappingURL=monitoring.d.ts.map