mcp-adr-analysis-server 1.1.0 → 2.0.2

package/dist/src/types/ape-framework.d.ts

@@ -0,0 +1,566 @@
+/**
+ * TypeScript interfaces for Automatic Prompt Engineer (APE) Framework
+ * Implements automatic prompt generation, evaluation, and optimization
+ */
+import { z } from 'zod';
+export interface PromptObject {
+    prompt: string;
+    instructions: string;
+    context: any;
+}
+export type GenerationStrategy = 'template-variation' | 'semantic-variation' | 'style-variation' | 'length-variation' | 'structure-variation' | 'hybrid-approach';
+export type EvaluationCriterion = 'task-completion' | 'clarity' | 'specificity' | 'robustness' | 'efficiency' | 'context-awareness';
+export type SelectionStrategy = 'highest-score' | 'multi-criteria' | 'ensemble' | 'context-aware' | 'balanced';
+export type OptimizationPhase = 'candidate-generation' | 'evaluation' | 'selection' | 'refinement' | 'validation';
+export interface APEConfig {
+    candidateCount: number;
+    evaluationCriteria: EvaluationCriterion[];
+    optimizationRounds: number;
+    selectionStrategy: SelectionStrategy;
+    cacheEnabled: boolean;
+    performanceTracking: boolean;
+    maxOptimizationTime: number;
+    qualityThreshold: number;
+    diversityWeight: number;
+}
+export declare const APEConfigSchema: z.ZodObject<{
+    candidateCount: z.ZodNumber;
+    evaluationCriteria: z.ZodArray<z.ZodEnum<["task-completion", "clarity", "specificity", "robustness", "efficiency", "context-awareness"]>, "many">;
+    optimizationRounds: z.ZodNumber;
+    selectionStrategy: z.ZodEnum<["highest-score", "multi-criteria", "ensemble", "context-aware", "balanced"]>;
+    cacheEnabled: z.ZodBoolean;
+    performanceTracking: z.ZodBoolean;
+    maxOptimizationTime: z.ZodNumber;
+    qualityThreshold: z.ZodNumber;
+    diversityWeight: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    cacheEnabled: boolean;
+    candidateCount: number;
+    evaluationCriteria: ("task-completion" | "clarity" | "specificity" | "robustness" | "efficiency" | "context-awareness")[];
+    optimizationRounds: number;
+    selectionStrategy: "highest-score" | "multi-criteria" | "ensemble" | "context-aware" | "balanced";
+    performanceTracking: boolean;
+    maxOptimizationTime: number;
+    qualityThreshold: number;
+    diversityWeight: number;
+}, {
+    cacheEnabled: boolean;
+    candidateCount: number;
+    evaluationCriteria: ("task-completion" | "clarity" | "specificity" | "robustness" | "efficiency" | "context-awareness")[];
+    optimizationRounds: number;
+    selectionStrategy: "highest-score" | "multi-criteria" | "ensemble" | "context-aware" | "balanced";
+    performanceTracking: boolean;
+    maxOptimizationTime: number;
+    qualityThreshold: number;
+    diversityWeight: number;
+}>;
+export interface ToolOptimizationConfig {
+    toolName: string;
+    taskType: string;
+    apeConfig: APEConfig;
+    contextRequirements: string[];
+    successCriteria: string[];
+    customEvaluators?: CustomEvaluator[];
+}
+export interface PromptCandidate {
+    id: string;
+    prompt: string;
+    instructions: string;
+    context: any;
+    generationStrategy: GenerationStrategy;
+    metadata: CandidateMetadata;
+    parentId?: string;
+    generation: number;
+}
+export interface CandidateMetadata {
+    generatedAt: string;
+    generationTime: number;
+    strategy: GenerationStrategy;
+    templateUsed?: string;
+    variationApplied?: string[];
+    complexity: number;
+    estimatedQuality: number;
+    tokens: number;
+}
+export interface GenerationRequest {
+    basePrompt: PromptObject;
+    strategies: GenerationStrategy[];
+    candidateCount: number;
+    context: GenerationContext;
+    constraints: GenerationConstraints;
+}
+export interface GenerationContext {
+    taskType: string;
+    domain: string;
+    targetAudience: string;
+    complexity: 'simple' | 'moderate' | 'complex';
+    style: 'formal' | 'conversational' | 'technical';
+    length: 'short' | 'medium' | 'long';
+}
+export interface GenerationConstraints {
+    maxLength: number;
+    minLength: number;
+    requiredKeywords: string[];
+    forbiddenTerms: string[];
+    styleRequirements: string[];
+    formatRequirements: string[];
+}
+export interface EvaluationResult {
+    candidateId: string;
+    scores: Record<EvaluationCriterion, number>;
+    overallScore: number;
+    feedback: EvaluationFeedback[];
+    evaluationTime: number;
+    evaluatorVersion: string;
+    metadata: EvaluationMetadata;
+}
+export interface EvaluationFeedback {
+    criterion: EvaluationCriterion;
+    score: number;
+    reasoning: string;
+    suggestions: string[];
+    examples?: string[];
+}
+export interface EvaluationMetadata {
+    evaluatedAt: string;
+    evaluationMethod: string;
+    confidence: number;
+    reliability: number;
+    contextMatch: number;
+    biasScore: number;
+}
+export interface CustomEvaluator {
+    name: string;
+    criterion: EvaluationCriterion;
+    weight: number;
+    evaluationPrompt: string;
+    expectedOutputFormat: string;
+    validationRules: ValidationRule[];
+}
+export interface ValidationRule {
+    type: 'length' | 'keyword' | 'format' | 'score';
+    condition: string;
+    errorMessage: string;
+}
+export interface SelectionResult {
+    selectedCandidates: PromptCandidate[];
+    selectionReasoning: string;
+    diversityScore: number;
+    qualityScore: number;
+    selectionTime: number;
+    metadata: SelectionMetadata;
+}
+export interface SelectionMetadata {
+    strategy: SelectionStrategy;
+    candidatesConsidered: number;
+    selectionCriteria: EvaluationCriterion[];
+    weights: Record<EvaluationCriterion, number>;
+    diversityWeight: number;
+    qualityThreshold: number;
+}
+export interface OptimizationResult {
+    optimizedPrompt: PromptObject;
+    originalPrompt: PromptObject;
+    improvementScore: number;
+    optimizationRounds: number;
+    candidatesEvaluated: number;
+    totalOptimizationTime: number;
+    cacheKey: string;
+    metadata: OptimizationMetadata;
+    performanceMetrics: PerformanceMetrics;
+}
+export interface OptimizationMetadata {
+    optimizedAt: string;
+    apeVersion: string;
+    configUsed: APEConfig;
+    strategiesApplied: GenerationStrategy[];
+    evaluationCriteria: EvaluationCriterion[];
+    selectionStrategy: SelectionStrategy;
+    qualityImprovement: number;
+    convergenceRound: number;
+}
+export interface PerformanceMetrics {
+    generationTime: number;
+    evaluationTime: number;
+    selectionTime: number;
+    totalTime: number;
+    candidatesGenerated: number;
+    candidatesEvaluated: number;
+    cacheHits: number;
+    cacheMisses: number;
+    memoryUsage: number;
+    successRate: number;
+}
+export interface OptimizationHistory {
+    optimizationId: string;
+    timestamp: string;
+    toolName: string;
+    taskType: string;
+    originalPrompt: PromptObject;
+    optimizedPrompt: PromptObject;
+    improvementScore: number;
+    config: APEConfig;
+    metrics: PerformanceMetrics;
+    userFeedback?: UserFeedback;
+}
+export interface UserFeedback {
+    rating: number;
+    comments: string;
+    usefulnessScore: number;
+    clarityScore: number;
+    effectivenessScore: number;
+    wouldRecommend: boolean;
+    submittedAt: string;
+}
+export interface APECacheEntry {
+    key: string;
+    type: 'candidate' | 'evaluation' | 'optimization' | 'performance';
+    data: any;
+    timestamp: string;
+    ttl: number;
+    accessCount: number;
+    lastAccessed: string;
+    metadata: CacheEntryMetadata;
+}
+export interface CacheEntryMetadata {
+    version: string;
+    compressed: boolean;
+    size: number;
+    tags: string[];
+    priority: 'low' | 'medium' | 'high';
+    context: string;
+}
+export interface APEError {
+    code: string;
+    message: string;
+    phase: OptimizationPhase;
+    candidateId?: string;
+    timestamp: string;
+    recoverable: boolean;
+    context?: any;
+}
+export interface OptimizationStatus {
+    status: 'pending' | 'generating' | 'evaluating' | 'selecting' | 'optimizing' | 'completed' | 'failed';
+    progress: number;
+    currentPhase: OptimizationPhase;
+    candidatesGenerated: number;
+    candidatesEvaluated: number;
+    estimatedTimeRemaining: number;
+    errors: APEError[];
+    warnings: string[];
+}
+export declare const PromptCandidateSchema: z.ZodObject<{
+    id: z.ZodString;
+    prompt: z.ZodString;
+    instructions: z.ZodString;
+    context: z.ZodAny;
+    generationStrategy: z.ZodEnum<["template-variation", "semantic-variation", "style-variation", "length-variation", "structure-variation", "hybrid-approach"]>;
+    metadata: z.ZodObject<{
+        generatedAt: z.ZodString;
+        generationTime: z.ZodNumber;
+        strategy: z.ZodString;
+        templateUsed: z.ZodOptional<z.ZodString>;
+        variationApplied: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        complexity: z.ZodNumber;
+        estimatedQuality: z.ZodNumber;
+        tokens: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        generatedAt: string;
+        generationTime: number;
+        strategy: string;
+        complexity: number;
+        estimatedQuality: number;
+        tokens: number;
+        templateUsed?: string | undefined;
+        variationApplied?: string[] | undefined;
+    }, {
+        generatedAt: string;
+        generationTime: number;
+        strategy: string;
+        complexity: number;
+        estimatedQuality: number;
+        tokens: number;
+        templateUsed?: string | undefined;
+        variationApplied?: string[] | undefined;
+    }>;
+    parentId: z.ZodOptional<z.ZodString>;
+    generation: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    metadata: {
+        generatedAt: string;
+        generationTime: number;
+        strategy: string;
+        complexity: number;
+        estimatedQuality: number;
+        tokens: number;
+        templateUsed?: string | undefined;
+        variationApplied?: string[] | undefined;
+    };
+    prompt: string;
+    instructions: string;
+    id: string;
+    generationStrategy: "template-variation" | "semantic-variation" | "style-variation" | "length-variation" | "structure-variation" | "hybrid-approach";
+    generation: number;
+    context?: any;
+    parentId?: string | undefined;
+}, {
+    metadata: {
+        generatedAt: string;
+        generationTime: number;
+        strategy: string;
+        complexity: number;
+        estimatedQuality: number;
+        tokens: number;
+        templateUsed?: string | undefined;
+        variationApplied?: string[] | undefined;
+    };
+    prompt: string;
+    instructions: string;
+    id: string;
+    generationStrategy: "template-variation" | "semantic-variation" | "style-variation" | "length-variation" | "structure-variation" | "hybrid-approach";
+    generation: number;
+    context?: any;
+    parentId?: string | undefined;
+}>;
+export declare const OptimizationResultSchema: z.ZodObject<{
+    optimizedPrompt: z.ZodObject<{
+        prompt: z.ZodString;
+        instructions: z.ZodString;
+        context: z.ZodAny;
+    }, "strip", z.ZodTypeAny, {
+        prompt: string;
+        instructions: string;
+        context?: any;
+    }, {
+        prompt: string;
+        instructions: string;
+        context?: any;
+    }>;
+    originalPrompt: z.ZodObject<{
+        prompt: z.ZodString;
+        instructions: z.ZodString;
+        context: z.ZodAny;
+    }, "strip", z.ZodTypeAny, {
+        prompt: string;
+        instructions: string;
+        context?: any;
+    }, {
+        prompt: string;
+        instructions: string;
+        context?: any;
+    }>;
+    improvementScore: z.ZodNumber;
+    optimizationRounds: z.ZodNumber;
+    candidatesEvaluated: z.ZodNumber;
+    totalOptimizationTime: z.ZodNumber;
+    cacheKey: z.ZodString;
+    metadata: z.ZodObject<{
+        optimizedAt: z.ZodString;
+        apeVersion: z.ZodString;
+        configUsed: z.ZodObject<{
+            candidateCount: z.ZodNumber;
+            evaluationCriteria: z.ZodArray<z.ZodEnum<["task-completion", "clarity", "specificity", "robustness", "efficiency", "context-awareness"]>, "many">;
+            optimizationRounds: z.ZodNumber;
+            selectionStrategy: z.ZodEnum<["highest-score", "multi-criteria", "ensemble", "context-aware", "balanced"]>;
+            cacheEnabled: z.ZodBoolean;
+            performanceTracking: z.ZodBoolean;
+            maxOptimizationTime: z.ZodNumber;
+            qualityThreshold: z.ZodNumber;
+            diversityWeight: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            cacheEnabled: boolean;
+            candidateCount: number;
+            evaluationCriteria: ("task-completion" | "clarity" | "specificity" | "robustness" | "efficiency" | "context-awareness")[];
+            optimizationRounds: number;
+            selectionStrategy: "highest-score" | "multi-criteria" | "ensemble" | "context-aware" | "balanced";
+            performanceTracking: boolean;
+            maxOptimizationTime: number;
+            qualityThreshold: number;
+            diversityWeight: number;
+        }, {
+            cacheEnabled: boolean;
+            candidateCount: number;
+            evaluationCriteria: ("task-completion" | "clarity" | "specificity" | "robustness" | "efficiency" | "context-awareness")[];
+            optimizationRounds: number;
+            selectionStrategy: "highest-score" | "multi-criteria" | "ensemble" | "context-aware" | "balanced";
+            performanceTracking: boolean;
+            maxOptimizationTime: number;
+            qualityThreshold: number;
+            diversityWeight: number;
+        }>;
+        strategiesApplied: z.ZodArray<z.ZodString, "many">;
+        evaluationCriteria: z.ZodArray<z.ZodString, "many">;
+        selectionStrategy: z.ZodString;
+        qualityImprovement: z.ZodNumber;
+        convergenceRound: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        evaluationCriteria: string[];
+        selectionStrategy: string;
+        optimizedAt: string;
+        apeVersion: string;
+        configUsed: {
+            cacheEnabled: boolean;
+            candidateCount: number;
+            evaluationCriteria: ("task-completion" | "clarity" | "specificity" | "robustness" | "efficiency" | "context-awareness")[];
+            optimizationRounds: number;
+            selectionStrategy: "highest-score" | "multi-criteria" | "ensemble" | "context-aware" | "balanced";
+            performanceTracking: boolean;
+            maxOptimizationTime: number;
+            qualityThreshold: number;
+            diversityWeight: number;
+        };
+        strategiesApplied: string[];
+        qualityImprovement: number;
+        convergenceRound: number;
+    }, {
+        evaluationCriteria: string[];
+        selectionStrategy: string;
+        optimizedAt: string;
+        apeVersion: string;
+        configUsed: {
+            cacheEnabled: boolean;
+            candidateCount: number;
+            evaluationCriteria: ("task-completion" | "clarity" | "specificity" | "robustness" | "efficiency" | "context-awareness")[];
+            optimizationRounds: number;
+            selectionStrategy: "highest-score" | "multi-criteria" | "ensemble" | "context-aware" | "balanced";
+            performanceTracking: boolean;
+            maxOptimizationTime: number;
+            qualityThreshold: number;
+            diversityWeight: number;
+        };
+        strategiesApplied: string[];
+        qualityImprovement: number;
+        convergenceRound: number;
+    }>;
+    performanceMetrics: z.ZodObject<{
+        generationTime: z.ZodNumber;
+        evaluationTime: z.ZodNumber;
+        selectionTime: z.ZodNumber;
+        totalTime: z.ZodNumber;
+        candidatesGenerated: z.ZodNumber;
+        candidatesEvaluated: z.ZodNumber;
+        cacheHits: z.ZodNumber;
+        cacheMisses: z.ZodNumber;
+        memoryUsage: z.ZodNumber;
+        successRate: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        generationTime: number;
+        cacheHits: number;
+        cacheMisses: number;
+        candidatesEvaluated: number;
+        evaluationTime: number;
+        selectionTime: number;
+        totalTime: number;
+        candidatesGenerated: number;
+        memoryUsage: number;
+        successRate: number;
+    }, {
+        generationTime: number;
+        cacheHits: number;
+        cacheMisses: number;
+        candidatesEvaluated: number;
+        evaluationTime: number;
+        selectionTime: number;
+        totalTime: number;
+        candidatesGenerated: number;
+        memoryUsage: number;
+        successRate: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    metadata: {
+        evaluationCriteria: string[];
+        selectionStrategy: string;
+        optimizedAt: string;
+        apeVersion: string;
+        configUsed: {
+            cacheEnabled: boolean;
+            candidateCount: number;
+            evaluationCriteria: ("task-completion" | "clarity" | "specificity" | "robustness" | "efficiency" | "context-awareness")[];
+            optimizationRounds: number;
+            selectionStrategy: "highest-score" | "multi-criteria" | "ensemble" | "context-aware" | "balanced";
+            performanceTracking: boolean;
+            maxOptimizationTime: number;
+            qualityThreshold: number;
+            diversityWeight: number;
+        };
+        strategiesApplied: string[];
+        qualityImprovement: number;
+        convergenceRound: number;
+    };
+    cacheKey: string;
+    optimizationRounds: number;
+    optimizedPrompt: {
+        prompt: string;
+        instructions: string;
+        context?: any;
+    };
+    originalPrompt: {
+        prompt: string;
+        instructions: string;
+        context?: any;
+    };
+    improvementScore: number;
+    candidatesEvaluated: number;
+    totalOptimizationTime: number;
+    performanceMetrics: {
+        generationTime: number;
+        cacheHits: number;
+        cacheMisses: number;
+        candidatesEvaluated: number;
+        evaluationTime: number;
+        selectionTime: number;
+        totalTime: number;
+        candidatesGenerated: number;
+        memoryUsage: number;
+        successRate: number;
+    };
+}, {
+    metadata: {
+        evaluationCriteria: string[];
+        selectionStrategy: string;
+        optimizedAt: string;
+        apeVersion: string;
+        configUsed: {
+            cacheEnabled: boolean;
+            candidateCount: number;
+            evaluationCriteria: ("task-completion" | "clarity" | "specificity" | "robustness" | "efficiency" | "context-awareness")[];
+            optimizationRounds: number;
+            selectionStrategy: "highest-score" | "multi-criteria" | "ensemble" | "context-aware" | "balanced";
+            performanceTracking: boolean;
+            maxOptimizationTime: number;
+            qualityThreshold: number;
+            diversityWeight: number;
+        };
+        strategiesApplied: string[];
+        qualityImprovement: number;
+        convergenceRound: number;
+    };
+    cacheKey: string;
+    optimizationRounds: number;
+    optimizedPrompt: {
+        prompt: string;
+        instructions: string;
+        context?: any;
+    };
+    originalPrompt: {
+        prompt: string;
+        instructions: string;
+        context?: any;
+    };
+    improvementScore: number;
+    candidatesEvaluated: number;
+    totalOptimizationTime: number;
+    performanceMetrics: {
+        generationTime: number;
+        cacheHits: number;
+        cacheMisses: number;
+        candidatesEvaluated: number;
+        evaluationTime: number;
+        selectionTime: number;
+        totalTime: number;
+        candidatesGenerated: number;
+        memoryUsage: number;
+        successRate: number;
+    };
+}>;
+//# sourceMappingURL=ape-framework.d.ts.map

package/dist/src/types/ape-framework.d.ts.map

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

package/dist/src/types/ape-framework.js

@@ -0,0 +1,98 @@
+/**
+ * TypeScript interfaces for Automatic Prompt Engineer (APE) Framework
+ * Implements automatic prompt generation, evaluation, and optimization
+ */
+import { z } from 'zod';
+export const APEConfigSchema = z.object({
+    candidateCount: z.number().min(1).max(20),
+    evaluationCriteria: z.array(z.enum([
+        'task-completion',
+        'clarity',
+        'specificity',
+        'robustness',
+        'efficiency',
+        'context-awareness'
+    ])),
+    optimizationRounds: z.number().min(1).max(10),
+    selectionStrategy: z.enum([
+        'highest-score',
+        'multi-criteria',
+        'ensemble',
+        'context-aware',
+        'balanced'
+    ]),
+    cacheEnabled: z.boolean(),
+    performanceTracking: z.boolean(),
+    maxOptimizationTime: z.number().min(1000),
+    qualityThreshold: z.number().min(0).max(1),
+    diversityWeight: z.number().min(0).max(1),
+});
+// ============================================================================
+// Export Schemas for Runtime Validation
+// ============================================================================
+export const PromptCandidateSchema = z.object({
+    id: z.string(),
+    prompt: z.string(),
+    instructions: z.string(),
+    context: z.any(),
+    generationStrategy: z.enum([
+        'template-variation',
+        'semantic-variation',
+        'style-variation',
+        'length-variation',
+        'structure-variation',
+        'hybrid-approach'
+    ]),
+    metadata: z.object({
+        generatedAt: z.string(),
+        generationTime: z.number(),
+        strategy: z.string(),
+        templateUsed: z.string().optional(),
+        variationApplied: z.array(z.string()).optional(),
+        complexity: z.number().min(0).max(1),
+        estimatedQuality: z.number().min(0).max(1),
+        tokens: z.number()
+    }),
+    parentId: z.string().optional(),
+    generation: z.number()
+});
+export const OptimizationResultSchema = z.object({
+    optimizedPrompt: z.object({
+        prompt: z.string(),
+        instructions: z.string(),
+        context: z.any()
+    }),
+    originalPrompt: z.object({
+        prompt: z.string(),
+        instructions: z.string(),
+        context: z.any()
+    }),
+    improvementScore: z.number().min(0).max(1),
+    optimizationRounds: z.number(),
+    candidatesEvaluated: z.number(),
+    totalOptimizationTime: z.number(),
+    cacheKey: z.string(),
+    metadata: z.object({
+        optimizedAt: z.string(),
+        apeVersion: z.string(),
+        configUsed: APEConfigSchema,
+        strategiesApplied: z.array(z.string()),
+        evaluationCriteria: z.array(z.string()),
+        selectionStrategy: z.string(),
+        qualityImprovement: z.number().min(0).max(1),
+        convergenceRound: z.number()
+    }),
+    performanceMetrics: z.object({
+        generationTime: z.number(),
+        evaluationTime: z.number(),
+        selectionTime: z.number(),
+        totalTime: z.number(),
+        candidatesGenerated: z.number(),
+        candidatesEvaluated: z.number(),
+        cacheHits: z.number(),
+        cacheMisses: z.number(),
+        memoryUsage: z.number(),
+        successRate: z.number().min(0).max(1)
+    })
+});
+//# sourceMappingURL=ape-framework.js.map

package/dist/src/types/ape-framework.js.map

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