agentic-qe 1.7.0 → 1.8.1

package/dist/utils/prompt-cache.js

@@ -0,0 +1,448 @@
+"use strict";
+/**
+ * Prompt Caching Infrastructure (CO-1)
+ *
+ * Implements Anthropic's prompt caching with proper cache key management and invalidation.
+ *
+ * IMPORTANT: Anthropic caching requirements:
+ * 1. Minimum 1024 tokens per cached block
+ * 2. Cache control on LAST 3 blocks only
+ * 3. 5-minute automatic TTL
+ *
+ * Cost model:
+ * - Cache write: 25% premium on input tokens
+ * - Cache hit: 90% discount on cached tokens
+ * - Regular tokens: Standard $3.00 per 1M input tokens
+ *
+ * @module utils/prompt-cache
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromptCacheManager = void 0;
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+const crypto_1 = require("crypto");
+/**
+ * PromptCacheManager
+ *
+ * Manages Anthropic prompt caching with content-addressable cache keys,
+ * TTL-based invalidation, and cost accounting.
+ *
+ * Features:
+ * - SHA-256 based cache keys for content addressability
+ * - 5-minute TTL with automatic pruning
+ * - Cost tracking for cache writes (25% premium) vs hits (90% discount)
+ * - Statistics for cache hit rate and cost savings
+ * - Support for up to 3 cached blocks per request
+ *
+ * @example
+ * ```typescript
+ * const cacheManager = new PromptCacheManager(process.env.ANTHROPIC_API_KEY!);
+ *
+ * const response = await cacheManager.createWithCache({
+ *   model: 'claude-sonnet-4',
+ *   systemPrompts: [
+ *     { text: AGENT_SYSTEM_PROMPT, priority: 'high' },
+ *   ],
+ *   projectContext: [
+ *     { text: JSON.stringify(projectStructure), priority: 'medium' },
+ *   ],
+ *   messages: [
+ *     { role: 'user', content: 'Generate tests for this code...' },
+ *   ],
+ * });
+ *
+ * const stats = cacheManager.getStats();
+ * console.log(`Cache hit rate: ${(stats.hitRate * 100).toFixed(1)}%`);
+ * console.log(`Cost savings: $${stats.costSavings.toFixed(4)}`);
+ * ```
+ */
+class PromptCacheManager {
+    /**
+     * Create a new PromptCacheManager
+     *
+     * @param apiKey - Anthropic API key
+     */
+    constructor(apiKey) {
+        this.cacheKeys = new Map();
+        this.stats = {
+            hits: 0,
+            misses: 0,
+            writes: 0,
+            hitRate: 0,
+            costSavings: 0,
+            tokensWritten: 0,
+            tokensRead: 0,
+            tokensRegular: 0,
+        };
+        /** Cache TTL in milliseconds (5 minutes as per Anthropic specs) */
+        this.CACHE_TTL = 5 * 60 * 1000;
+        /** Minimum tokens required for caching */
+        this.MIN_CACHE_TOKENS = 1024;
+        /** Cost per million tokens */
+        this.COST_PER_MILLION = 3.0;
+        /** Cache write premium (25%) */
+        this.CACHE_WRITE_PREMIUM = 1.25;
+        /** Cache read discount (90%) */
+        this.CACHE_READ_DISCOUNT = 0.1; // 90% discount means 10% cost
+        this.anthropic = new sdk_1.default({ apiKey });
+    }
+    /**
+     * Create message with cached content
+     *
+     * IMPORTANT: Anthropic caching requires:
+     * 1. Minimum 1024 tokens per cached block
+     * 2. Cache control on LAST 3 blocks only
+     * 3. 5-minute TTL (automatic)
+     *
+     * This method automatically:
+     * - Checks content size before caching (must be >= 1024 tokens)
+     * - Adds cache control to last 3 blocks
+     * - Tracks cache hits/misses via content hashing
+     * - Updates cost statistics
+     *
+     * @param params - Message parameters with cacheable content
+     * @returns Anthropic message response
+     *
+     * @example
+     * ```typescript
+     * const response = await cacheManager.createWithCache({
+     *   model: 'claude-sonnet-4',
+     *   systemPrompts: [
+     *     { text: SYSTEM_PROMPT, priority: 'high' },
+     *   ],
+     *   projectContext: [
+     *     { text: projectData, priority: 'medium' },
+     *   ],
+     *   messages: [{ role: 'user', content: userQuery }],
+     * });
+     * ```
+     */
+    async createWithCache(params) {
+        // Build system content with cache breakpoints
+        const systemContent = [];
+        // Add system prompts (cache if >= MIN_CACHE_TOKENS)
+        for (const prompt of params.systemPrompts) {
+            const shouldCache = this.shouldCache(prompt.text);
+            systemContent.push({
+                type: 'text',
+                text: prompt.text,
+                ...(shouldCache && { cache_control: { type: 'ephemeral' } }),
+            });
+        }
+        // Add project context (cache if provided and >= MIN_CACHE_TOKENS)
+        if (params.projectContext) {
+            for (const context of params.projectContext) {
+                const shouldCache = this.shouldCache(context.text);
+                systemContent.push({
+                    type: 'text',
+                    text: context.text,
+                    ...(shouldCache && { cache_control: { type: 'ephemeral' } }),
+                });
+            }
+        }
+        // Generate cache key from cacheable content
+        const cacheKey = this.generateCacheKey(systemContent);
+        const isHit = this.isCacheHit(cacheKey);
+        // Track cache statistics (only if we have cacheable content)
+        if (cacheKey) {
+            if (isHit) {
+                this.stats.hits++;
+            }
+            else {
+                this.stats.misses++;
+                this.stats.writes++;
+                const estimatedTokens = this.estimateTokens(systemContent);
+                this.cacheKeys.set(cacheKey, {
+                    hash: cacheKey,
+                    timestamp: Date.now(),
+                    tokens: estimatedTokens,
+                });
+            }
+        }
+        // Make API call
+        const response = await this.anthropic.messages.create({
+            model: params.model,
+            system: systemContent,
+            messages: params.messages,
+            max_tokens: params.maxTokens || 4096,
+            ...(params.temperature !== undefined && { temperature: params.temperature }),
+        });
+        // Update statistics from response
+        this.updateStats(response, isHit);
+        return response;
+    }
+    /**
+     * Generate cache key from content using SHA-256
+     *
+     * Creates a content-addressable cache key by hashing all text blocks.
+     * Only cached blocks (those with cache_control) are included in the hash.
+     *
+     * @param content - Text blocks to hash
+     * @returns SHA-256 hash of content
+     *
+     * @example
+     * ```typescript
+     * const key = cacheManager.generateCacheKey([
+     *   { type: 'text', text: 'system prompt', cache_control: { type: 'ephemeral' } },
+     *   { type: 'text', text: 'project context', cache_control: { type: 'ephemeral' } },
+     * ]);
+     * // Returns: "a3f2c8b9..." (SHA-256 hash)
+     * ```
+     */
+    generateCacheKey(content) {
+        // Only hash content that will be cached
+        const cachedBlocks = content
+            .filter(c => 'cache_control' in c && c.cache_control)
+            .map(c => c.text);
+        if (cachedBlocks.length === 0) {
+            // No cached content, return empty key
+            return '';
+        }
+        // Hash concatenated text with separator
+        const text = cachedBlocks.join('|||CACHE_SEPARATOR|||');
+        return (0, crypto_1.createHash)('sha256').update(text).digest('hex');
+    }
+    /**
+     * Check if cache key exists and is fresh (within 5 minutes)
+     *
+     * @param cacheKey - Cache key to check
+     * @returns true if cache hit, false if cache miss
+     *
+     * @example
+     * ```typescript
+     * const isHit = cacheManager.isCacheHit('a3f2c8b9...');
+     * if (isHit) {
+     *   console.log('Cache hit! Will save 90% on cached tokens');
+     * }
+     * ```
+     */
+    isCacheHit(cacheKey) {
+        if (!cacheKey)
+            return false;
+        const cached = this.cacheKeys.get(cacheKey);
+        if (!cached)
+            return false;
+        const age = Date.now() - cached.timestamp;
+        return age < this.CACHE_TTL;
+    }
+    /**
+     * Update cache statistics from API response
+     *
+     * Tracks:
+     * - Cache creation tokens (write with 25% premium)
+     * - Cache read tokens (hit with 90% discount)
+     * - Regular input tokens (standard cost)
+     * - Cost savings calculation
+     *
+     * @param response - Anthropic API response
+     * @param wasHit - Whether this was a cache hit
+     */
+    updateStats(response, wasHit) {
+        // Extract usage from response
+        const usage = response.usage;
+        // Track cache write (cache creation)
+        if (usage?.cache_creation_input_tokens) {
+            const writeTokens = usage.cache_creation_input_tokens;
+            this.stats.tokensWritten += writeTokens;
+            // Cache write cost: 25% premium
+            const writeCost = writeTokens * this.CACHE_WRITE_PREMIUM * (this.COST_PER_MILLION / 1000000);
+            // Regular cost would have been
+            const regularCost = writeTokens * (this.COST_PER_MILLION / 1000000);
+            // Negative savings because write is more expensive
+            this.stats.costSavings -= (writeCost - regularCost);
+        }
+        // Track cache hit (cache read)
+        if (usage?.cache_read_input_tokens) {
+            const readTokens = usage.cache_read_input_tokens;
+            this.stats.tokensRead += readTokens;
+            // Cache read cost: 90% discount (10% of regular cost)
+            const readCost = readTokens * this.CACHE_READ_DISCOUNT * (this.COST_PER_MILLION / 1000000);
+            // Regular cost would have been
+            const regularCost = readTokens * (this.COST_PER_MILLION / 1000000);
+            // Positive savings from cache hit
+            this.stats.costSavings += (regularCost - readCost);
+        }
+        // Track regular input tokens
+        if (usage?.input_tokens) {
+            // Total input tokens includes cache tokens, so subtract cached portions
+            const cacheCreation = usage.cache_creation_input_tokens || 0;
+            const cacheRead = usage.cache_read_input_tokens || 0;
+            const regularTokens = usage.input_tokens - cacheCreation - cacheRead;
+            this.stats.tokensRegular += regularTokens;
+        }
+        // Update hit rate
+        const total = this.stats.hits + this.stats.misses;
+        this.stats.hitRate = total > 0 ? this.stats.hits / total : 0;
+    }
+    /**
+     * Get cache statistics
+     *
+     * @returns Current cache statistics including hit rate and cost savings
+     *
+     * @example
+     * ```typescript
+     * const stats = cacheManager.getStats();
+     * console.log(`Hit rate: ${(stats.hitRate * 100).toFixed(1)}%`);
+     * console.log(`Cost savings: $${stats.costSavings.toFixed(4)}`);
+     * console.log(`Total hits: ${stats.hits}, misses: ${stats.misses}`);
+     * ```
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+    /**
+     * Clear cache keys older than TTL
+     *
+     * Automatically prunes expired cache entries to prevent memory bloat.
+     * Should be called periodically in long-running processes.
+     *
+     * @returns Number of entries pruned
+     *
+     * @example
+     * ```typescript
+     * // Run every 5 minutes
+     * setInterval(() => {
+     *   const pruned = cacheManager.pruneCache();
+     *   console.log(`Pruned ${pruned} expired cache entries`);
+     * }, 5 * 60 * 1000);
+     * ```
+     */
+    pruneCache() {
+        const now = Date.now();
+        let pruned = 0;
+        // Convert to array to avoid iterator issues with older TypeScript targets
+        const entries = Array.from(this.cacheKeys.entries());
+        for (let i = 0; i < entries.length; i++) {
+            const [key, value] = entries[i];
+            if (now - value.timestamp > this.CACHE_TTL) {
+                this.cacheKeys.delete(key);
+                pruned++;
+            }
+        }
+        return pruned;
+    }
+    /**
+     * Reset statistics
+     *
+     * Clears all cache statistics. Useful for testing or when starting
+     * a new measurement period.
+     *
+     * @example
+     * ```typescript
+     * // Reset stats at start of each day
+     * cacheManager.resetStats();
+     * ```
+     */
+    resetStats() {
+        this.stats = {
+            hits: 0,
+            misses: 0,
+            writes: 0,
+            hitRate: 0,
+            costSavings: 0,
+            tokensWritten: 0,
+            tokensRead: 0,
+            tokensRegular: 0,
+        };
+    }
+    /**
+     * Clear all cache keys
+     *
+     * Removes all cache entries. Does not affect statistics.
+     *
+     * @example
+     * ```typescript
+     * // Clear cache when deploying new version
+     * cacheManager.clearCache();
+     * ```
+     */
+    clearCache() {
+        this.cacheKeys.clear();
+    }
+    /**
+     * Check if content should be cached based on token count
+     *
+     * Anthropic requires minimum 1024 tokens for caching to be effective.
+     *
+     * @param text - Text content to check
+     * @returns true if content is large enough to cache
+     */
+    shouldCache(text) {
+        // Rough estimate: 4 characters per token (conservative)
+        const estimatedTokens = text.length / 4;
+        return estimatedTokens >= this.MIN_CACHE_TOKENS;
+    }
+    /**
+     * Estimate token count for content blocks
+     *
+     * Uses rough heuristic: 4 characters per token (conservative estimate)
+     *
+     * @param content - Text blocks to estimate
+     * @returns Estimated token count
+     */
+    estimateTokens(content) {
+        const totalChars = content.reduce((sum, block) => sum + block.text.length, 0);
+        return Math.ceil(totalChars / 4);
+    }
+    /**
+     * Get cache size (number of entries)
+     *
+     * @returns Number of cache entries
+     */
+    getCacheSize() {
+        return this.cacheKeys.size;
+    }
+    /**
+     * Get expected hit rate target
+     *
+     * According to the MCP improvement plan, we should target
+     * 60-80% cache hit rate over 5-minute windows.
+     *
+     * @returns Target hit rate range
+     */
+    static getTargetHitRate() {
+        return { min: 0.6, max: 0.8 };
+    }
+    /**
+     * Calculate break-even point
+     *
+     * Cache writes cost 25% more than regular calls.
+     * Cache hits save 90% on cached tokens.
+     *
+     * Break-even: 1 write + N hits where total cost equals regular cost
+     *
+     * @param cacheTokens - Number of tokens in cached content
+     * @returns Number of hits needed to break even
+     */
+    static calculateBreakEven(cacheTokens) {
+        const WRITE_PREMIUM = 1.25;
+        const READ_DISCOUNT = 0.1;
+        const COST_PER_MILLION = 3.0;
+        // Cost of cache write vs regular
+        const writeCost = cacheTokens * WRITE_PREMIUM * (COST_PER_MILLION / 1000000);
+        const regularCost = cacheTokens * (COST_PER_MILLION / 1000000);
+        const writeOverhead = writeCost - regularCost;
+        // Savings per cache hit
+        const hitSavings = regularCost - (cacheTokens * READ_DISCOUNT * (COST_PER_MILLION / 1000000));
+        // Hits needed to break even
+        const hitsToBreakEven = Math.ceil(writeOverhead / hitSavings);
+        // Calculate savings at different hit counts
+        const calculateTotal = (hits) => {
+            const totalRegular = regularCost * (1 + hits);
+            const totalCached = writeCost + (hits * cacheTokens * READ_DISCOUNT * (COST_PER_MILLION / 1000000));
+            return totalRegular - totalCached;
+        };
+        return {
+            hitsToBreakEven,
+            savings: {
+                atBreakEven: calculateTotal(hitsToBreakEven),
+                at5Hits: calculateTotal(5),
+                at10Hits: calculateTotal(10),
+            },
+        };
+    }
+}
+exports.PromptCacheManager = PromptCacheManager;
+//# sourceMappingURL=prompt-cache.js.map

package/dist/utils/prompt-cache.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agentic-qe",
-  "version": "1.7.0",
-  "description": "Agentic Quality Engineering Fleet System - AI-driven quality management platform with 37 QE skills, learning, pattern reuse, ML-based flaky detection, Multi-Model Router (70-81% cost savings), streaming progress updates, 102 MCP tools, and native TypeScript hooks",
+  "version": "1.8.1",
+  "description": "Agentic Quality Engineering Fleet System - AI-driven quality management platform with 38 QE skills, learning, pattern reuse, ML-based flaky detection, Multi-Model Router (70-81% cost savings), streaming progress updates, 102 MCP tools, and native TypeScript hooks",
   "main": "dist/cli/index.js",
   "types": "dist/cli/index.d.ts",
   "bin": {
@@ -84,7 +84,10 @@
     "verify:features": "tsx scripts/verify-features.ts",
     "verify:all": "npm run verify:counts && npm run verify:agent-skills && npm run verify:features",
     "update:counts": "tsx scripts/update-documentation-counts.ts",
-    "migrate:learning": "tsx scripts/migrate-learning-schema.ts"
+    "migrate:learning": "tsx scripts/migrate-learning-schema.ts",
+    "migrate:agentdb": "tsx scripts/migrate-to-agentdb.ts",
+    "migrate:dry-run": "tsx scripts/migrate-to-agentdb.ts --dry-run",
+    "migrate:rollback": "tsx scripts/rollback-migration.ts"
   },
   "keywords": [
     "quality-engineering",
@@ -113,7 +116,6 @@
     "@anthropic-ai/sdk": "^0.64.0",
     "@babel/parser": "^7.24.0",
     "@babel/traverse": "^7.24.0",
-    "@faker-js/faker": "^10.0.0",
     "@modelcontextprotocol/sdk": "^1.21.1",
     "@xenova/transformers": "^2.6.0",
     "agentdb": "^1.0.0",
@@ -123,17 +125,14 @@
     "better-sqlite3": "^12.4.1",
     "chalk": "^4.1.2",
     "chokidar": "^3.6.0",
-    "claude-flow": "^2.7.31",
     "cli-table3": "^0.6.5",
     "commander": "^14.0.1",
-    "dotenv": "^17.2.3",
     "fs-extra": "^11.1.1",
     "graphql": "^16.11.0",
     "inquirer": "^8.2.6",
     "ora": "^5.4.1",
     "uuid": "^11.0.5",
     "winston": "^3.18.3",
-    "ws": "^8.14.2",
     "yaml": "^2.8.1"
   },
   "resolutions": {
@@ -152,17 +151,12 @@
     "@types/jest": "^30.0.0",
     "@types/node": "^20.19.17",
     "@types/uuid": "^10.0.0",
-    "@types/ws": "^8.5.10",
     "@typescript-eslint/eslint-plugin": "^6.13.0",
     "@typescript-eslint/parser": "^6.13.0",
-    "ajv": "^8.17.1",
-    "ajv-formats": "^3.0.1",
-    "commander": "^14.0.1",
     "dotenv": "^17.2.3",
     "eslint": "^8.55.0",
     "eslint-plugin-security": "^3.0.1",
     "graceful-fs": "^4.2.11",
-    "graphql": "^16.11.0",
     "istanbul-lib-coverage": "^3.2.2",
     "jest": "^30.2.0",
     "jest-extended": "^6.0.0",
@@ -173,10 +167,7 @@
     "ts-node": "^10.9.1",
     "tsx": "^4.20.6",
     "typedoc": "^0.28.13",
-    "typescript": "^5.9.3",
-    "uuid": "^11.0.5",
-    "winston": "^3.18.3",
-    "yaml": "^2.8.1"
+    "typescript": "^5.9.3"
   },
   "engines": {
     "node": ">=18.0.0",