@jamesaphoenix/tx-test-utils 0.4.2

package/dist/llm-cache/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/llm-cache/cli.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAkB,UAAU,EAAE,MAAM,YAAY,CAAA;AAMvD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,8CAA8C;IAC9C,UAAU,EAAE,IAAI,GAAG,IAAI,CAAA;IACvB,8CAA8C;IAC9C,UAAU,EAAE,IAAI,GAAG,IAAI,CAAA;IACvB,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,SAAS,CAAC,EAAE,IAAI,CAAA;IAChB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yBAAyB;IACzB,GAAG,CAAC,EAAE,OAAO,CAAA;CACd;AAMD;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,QAAa,OAAO,CAAC,UAAU,CAqDxD,CAAA;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,UAAU,GAAU,UAAS,iBAAsB,KAAG,OAAO,CAAC,MAAM,CA+ChF,CAAA;AA2BD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,UAAU,KAAG,MA4BpD,CAAA;AAMD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,GAAU,CAAC,GAAG,OAAO,EAAE,MAAM,MAAM,KAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAU3F,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,QAAa,OAAO,CAAC,MAAM,EAAE,CAWzD,CAAA"}

package/dist/llm-cache/cli.js

@@ -0,0 +1,248 @@
+/**
+ * CLI utilities for LLM cache management.
+ *
+ * Provides functions to inspect, clear, and manage the LLM response cache.
+ *
+ * @module @tx/test-utils/llm-cache/cli
+ */
+import * as fs from "fs/promises";
+import * as path from "path";
+import { getCacheConfig } from "./cache.js";
+// =============================================================================
+// Cache Statistics
+// =============================================================================
+/**
+ * Get statistics about the LLM cache.
+ *
+ * @example
+ * ```typescript
+ * const stats = await getCacheStats()
+ * console.log(`Cache has ${stats.count} entries using ${stats.totalBytes} bytes`)
+ * console.log(`Models: ${Object.keys(stats.byModel).join(', ')}`)
+ * ```
+ */
+export const getCacheStats = async () => {
+    const config = getCacheConfig();
+    const stats = {
+        count: 0,
+        totalBytes: 0,
+        oldestDate: null,
+        newestDate: null,
+        byModel: {},
+        byVersion: {}
+    };
+    let files;
+    try {
+        files = await fs.readdir(config.cacheDir);
+    }
+    catch {
+        // Directory doesn't exist - return empty stats
+        return stats;
+    }
+    const jsonFiles = files.filter((f) => f.endsWith(".json"));
+    stats.count = jsonFiles.length;
+    for (const file of jsonFiles) {
+        const filePath = path.join(config.cacheDir, file);
+        try {
+            const stat = await fs.stat(filePath);
+            stats.totalBytes += stat.size;
+            const content = await fs.readFile(filePath, "utf-8");
+            const entry = JSON.parse(content);
+            // Track by model
+            stats.byModel[entry.model] = (stats.byModel[entry.model] ?? 0) + 1;
+            // Track by version
+            stats.byVersion[entry.version] = (stats.byVersion[entry.version] ?? 0) + 1;
+            // Track date range
+            const date = new Date(entry.cachedAt);
+            if (!stats.oldestDate || date < stats.oldestDate) {
+                stats.oldestDate = date;
+            }
+            if (!stats.newestDate || date > stats.newestDate) {
+                stats.newestDate = date;
+            }
+        }
+        catch {
+            // Skip corrupted files
+            continue;
+        }
+    }
+    return stats;
+};
+// =============================================================================
+// Cache Clearing
+// =============================================================================
+/**
+ * Clear cache entries based on options.
+ *
+ * @returns Number of entries deleted (-1 if unknown when using `all`)
+ *
+ * @example
+ * ```typescript
+ * // Clear all cache
+ * await clearCache({ all: true })
+ *
+ * // Clear entries older than 30 days
+ * const thirtyDaysAgo = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000)
+ * const deleted = await clearCache({ olderThan: thirtyDaysAgo })
+ *
+ * // Clear entries for specific model
+ * await clearCache({ model: 'claude-haiku' })
+ *
+ * // Clear entries with specific version (useful after schema changes)
+ * await clearCache({ version: 1 })
+ * ```
+ */
+export const clearCache = async (options = {}) => {
+    const config = getCacheConfig();
+    // Clear all - fastest path
+    if (options.all) {
+        try {
+            await fs.rm(config.cacheDir, { recursive: true, force: true });
+            await fs.mkdir(config.cacheDir, { recursive: true });
+        }
+        catch {
+            // Directory may not exist
+        }
+        return -1; // Unknown count
+    }
+    let files;
+    try {
+        files = await fs.readdir(config.cacheDir);
+    }
+    catch {
+        return 0; // Directory doesn't exist
+    }
+    const jsonFiles = files.filter((f) => f.endsWith(".json"));
+    let deleted = 0;
+    for (const file of jsonFiles) {
+        const filePath = path.join(config.cacheDir, file);
+        try {
+            const content = await fs.readFile(filePath, "utf-8");
+            const entry = JSON.parse(content);
+            const shouldDelete = (options.olderThan && new Date(entry.cachedAt) < options.olderThan) ||
+                (options.model && entry.model === options.model) ||
+                (options.version !== undefined && entry.version === options.version);
+            if (shouldDelete) {
+                await fs.unlink(filePath);
+                deleted++;
+            }
+        }
+        catch {
+            // Skip files that can't be read
+            continue;
+        }
+    }
+    return deleted;
+};
+// =============================================================================
+// Formatting
+// =============================================================================
+/**
+ * Format bytes into human-readable string.
+ */
+const formatBytes = (bytes) => {
+    if (bytes === 0)
+        return "0 B";
+    const units = ["B", "KB", "MB", "GB"];
+    const k = 1024;
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${(bytes / Math.pow(k, i)).toFixed(1)} ${units[i]}`;
+};
+/**
+ * Format date for display.
+ */
+const formatDate = (date) => {
+    if (!date)
+        return "N/A";
+    return date.toISOString().split("T")[0];
+};
+/**
+ * Format cache statistics for display.
+ *
+ * @example
+ * ```typescript
+ * const stats = await getCacheStats()
+ * console.log(formatCacheStats(stats))
+ * // Output:
+ * // LLM Cache Statistics:
+ * //   Entries: 142
+ * //   Size: 3.2 MB
+ * //   Date range: 2024-01-15 to 2024-02-01
+ * //   By model:
+ * //     claude-sonnet-4: 98
+ * //     claude-haiku: 44
+ * ```
+ */
+export const formatCacheStats = (stats) => {
+    const lines = [
+        "LLM Cache Statistics:",
+        `  Entries: ${stats.count}`,
+        `  Size: ${formatBytes(stats.totalBytes)}`
+    ];
+    if (stats.oldestDate && stats.newestDate) {
+        lines.push(`  Date range: ${formatDate(stats.oldestDate)} to ${formatDate(stats.newestDate)}`);
+    }
+    const models = Object.entries(stats.byModel);
+    if (models.length > 0) {
+        lines.push("  By model:");
+        for (const [model, count] of models.sort((a, b) => b[1] - a[1])) {
+            lines.push(`    ${model}: ${count}`);
+        }
+    }
+    const versions = Object.entries(stats.byVersion);
+    if (versions.length > 1) {
+        lines.push("  By version:");
+        for (const [version, count] of versions.sort((a, b) => Number(b[0]) - Number(a[0]))) {
+            lines.push(`    v${version}: ${count}`);
+        }
+    }
+    return lines.join("\n");
+};
+// =============================================================================
+// Cache Entry Inspection
+// =============================================================================
+/**
+ * Get a specific cache entry by hash.
+ *
+ * @example
+ * ```typescript
+ * const entry = await getCacheEntry('a1b2c3d4...')
+ * if (entry) {
+ *   console.log(`Cached at: ${entry.cachedAt}`)
+ *   console.log(`Model: ${entry.model}`)
+ * }
+ * ```
+ */
+export const getCacheEntry = async (hash) => {
+    const config = getCacheConfig();
+    const filePath = path.join(config.cacheDir, `${hash}.json`);
+    try {
+        const content = await fs.readFile(filePath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+};
+/**
+ * List all cache entry hashes.
+ *
+ * @example
+ * ```typescript
+ * const hashes = await listCacheEntries()
+ * console.log(`Found ${hashes.length} cached responses`)
+ * ```
+ */
+export const listCacheEntries = async () => {
+    const config = getCacheConfig();
+    try {
+        const files = await fs.readdir(config.cacheDir);
+        return files
+            .filter((f) => f.endsWith(".json"))
+            .map((f) => f.replace(".json", ""));
+    }
+    catch {
+        return [];
+    }
+};
+//# sourceMappingURL=cli.js.map

package/dist/llm-cache/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/llm-cache/cli.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAA;AACjC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAA;AAC5B,OAAO,EAAE,cAAc,EAAc,MAAM,YAAY,CAAA;AAsCvD,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,IAAyB,EAAE;IAC3D,MAAM,MAAM,GAAG,cAAc,EAAE,CAAA;IAC/B,MAAM,KAAK,GAAe;QACxB,KAAK,EAAE,CAAC;QACR,UAAU,EAAE,CAAC;QACb,UAAU,EAAE,IAAI;QAChB,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,EAAE;QACX,SAAS,EAAE,EAAE;KACd,CAAA;IAED,IAAI,KAAe,CAAA;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,+CAA+C;QAC/C,OAAO,KAAK,CAAA;IACd,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAA;IAC1D,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC,MAAM,CAAA;IAE9B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;QAEjD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YACpC,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,CAAA;YAE7B,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;YACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAwB,CAAA;YAExD,iBAAiB;YACjB,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;YAElE,mBAAmB;YACnB,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;YAE1E,mBAAmB;YACnB,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;YACrC,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,IAAI,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;gBACjD,KAAK,CAAC,UAAU,GAAG,IAAI,CAAA;YACzB,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,IAAI,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;gBACjD,KAAK,CAAC,UAAU,GAAG,IAAI,CAAA;YACzB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;YACvB,SAAQ;QACV,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAAE,UAA6B,EAAE,EAAmB,EAAE;IACnF,MAAM,MAAM,GAAG,cAAc,EAAE,CAAA;IAE/B,2BAA2B;IAC3B,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;YAC9D,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B;QAC5B,CAAC;QACD,OAAO,CAAC,CAAC,CAAA,CAAC,gBAAgB;IAC5B,CAAC;IAED,IAAI,KAAe,CAAA;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAA,CAAC,0BAA0B;IACrC,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAA;IAC1D,IAAI,OAAO,GAAG,CAAC,CAAA;IAEf,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;QAEjD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;YACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAwB,CAAA;YAExD,MAAM,YAAY,GAChB,CAAC,OAAO,CAAC,SAAS,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;gBACnE,CAAC,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,CAAC;gBAChD,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;YAEtE,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;gBACzB,OAAO,EAAE,CAAA;YACX,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,gCAAgC;YAChC,SAAQ;QACV,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAED,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF;;GAEG;AACH,MAAM,WAAW,GAAG,CAAC,KAAa,EAAU,EAAE;IAC5C,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAE7B,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;IACrC,MAAM,CAAC,GAAG,IAAI,CAAA;IACd,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IAEnD,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;AAC7D,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,UAAU,GAAG,CAAC,IAAiB,EAAU,EAAE;IAC/C,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAA;IACvB,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;AACzC,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAiB,EAAU,EAAE;IAC5D,MAAM,KAAK,GAAa;QACtB,uBAAuB;QACvB,cAAc,KAAK,CAAC,KAAK,EAAE;QAC3B,WAAW,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE;KAC3C,CAAA;IAED,IAAI,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,iBAAiB,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;IAChG,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC5C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;QACzB,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,KAAK,KAAK,EAAE,CAAC,CAAA;QACtC,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IAChD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;QAC3B,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACpF,KAAK,CAAC,IAAI,CAAC,QAAQ,OAAO,KAAK,KAAK,EAAE,CAAC,CAAA;QACzC,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC,CAAA;AAED,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAe,IAAY,EAAiC,EAAE;IAC9F,MAAM,MAAM,GAAG,cAAc,EAAE,CAAA;IAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,IAAI,OAAO,CAAC,CAAA;IAE3D,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QACpD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAkB,CAAA;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,IAAuB,EAAE;IAC5D,MAAM,MAAM,GAAG,cAAc,EAAE,CAAA;IAE/B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QAC/C,OAAO,KAAK;aACT,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;aAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC,CAAA"}

package/dist/llm-cache/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * LLM response caching for deterministic tests.
+ *
+ * Caches expensive LLM API calls by hashing inputs with SHA256.
+ * Enables fast, repeatable tests without hitting real APIs.
+ *
+ * @example
+ * ```typescript
+ * import { cachedLLMCall, withLLMCache, hashInput } from '@tx/test-utils/llm-cache'
+ *
+ * // Direct caching
+ * const result = await cachedLLMCall(
+ *   "What is 2+2?",
+ *   "claude-sonnet-4",
+ *   () => anthropic.messages.create({...})
+ * )
+ *
+ * // Wrapper pattern
+ * const cachedExtract = withLLMCache(extractCandidates, {
+ *   model: "claude-sonnet-4",
+ *   version: 1
+ * })
+ * ```
+ *
+ * @module @tx/test-utils/llm-cache
+ */
+export { hashInput, cachedLLMCall, withLLMCache, configureLLMCache, getCacheConfig, resetCacheConfig } from "./cache.js";
+export type { CacheEntry, CachedLLMCallOptions, WithLLMCacheOptions } from "./cache.js";
+export { getCacheStats, clearCache, formatCacheStats, getCacheEntry, listCacheEntries } from "./cli.js";
+export type { CacheStats, ClearCacheOptions } from "./cli.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/llm-cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm-cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,EACL,SAAS,EACT,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EACjB,MAAM,YAAY,CAAA;AAGnB,YAAY,EACV,UAAU,EACV,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,YAAY,CAAA;AAGnB,OAAO,EACL,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EACjB,MAAM,UAAU,CAAA;AAGjB,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA"}

package/dist/llm-cache/index.js

@@ -0,0 +1,31 @@
+/**
+ * LLM response caching for deterministic tests.
+ *
+ * Caches expensive LLM API calls by hashing inputs with SHA256.
+ * Enables fast, repeatable tests without hitting real APIs.
+ *
+ * @example
+ * ```typescript
+ * import { cachedLLMCall, withLLMCache, hashInput } from '@tx/test-utils/llm-cache'
+ *
+ * // Direct caching
+ * const result = await cachedLLMCall(
+ *   "What is 2+2?",
+ *   "claude-sonnet-4",
+ *   () => anthropic.messages.create({...})
+ * )
+ *
+ * // Wrapper pattern
+ * const cachedExtract = withLLMCache(extractCandidates, {
+ *   model: "claude-sonnet-4",
+ *   version: 1
+ * })
+ * ```
+ *
+ * @module @tx/test-utils/llm-cache
+ */
+// Core caching functions
+export { hashInput, cachedLLMCall, withLLMCache, configureLLMCache, getCacheConfig, resetCacheConfig } from "./cache.js";
+// CLI utilities
+export { getCacheStats, clearCache, formatCacheStats, getCacheEntry, listCacheEntries } from "./cli.js";
+//# sourceMappingURL=index.js.map

package/dist/llm-cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/llm-cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,yBAAyB;AACzB,OAAO,EACL,SAAS,EACT,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EACjB,MAAM,YAAY,CAAA;AASnB,gBAAgB;AAChB,OAAO,EACL,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EACjB,MAAM,UAAU,CAAA"}

package/dist/mocks/anthropic.mock.d.ts

@@ -0,0 +1,173 @@
+/**
+ * Mock Anthropic client for testing.
+ *
+ * Provides configurable mock Anthropic clients with call tracking,
+ * response fixtures, and failure injection for testing services
+ * that depend on the Anthropic API.
+ *
+ * @module @tx/test-utils/mocks/anthropic
+ */
+/**
+ * Message structure matching Anthropic SDK format.
+ */
+export interface MockMessage {
+    role: "user" | "assistant";
+    content: string;
+}
+/**
+ * Tracked API call parameters.
+ */
+export interface MockAnthropicCall {
+    model: string;
+    messages: Array<{
+        role: string;
+        content: string;
+    }>;
+    max_tokens?: number;
+}
+/**
+ * Response structure matching Anthropic SDK format.
+ */
+export interface MockAnthropicResponse {
+    id: string;
+    type: "message";
+    role: "assistant";
+    content: Array<{
+        type: string;
+        text?: string;
+    }>;
+    model: string;
+    usage?: {
+        input_tokens?: number;
+        output_tokens?: number;
+    };
+}
+/**
+ * Configuration options for the mock Anthropic client.
+ */
+export interface MockAnthropicConfig {
+    /**
+     * Map of specific responses keyed by JSON-serialized messages.
+     * Allows returning different responses for different inputs.
+     */
+    responses?: Map<string, MockAnthropicResponse>;
+    /**
+     * Default response when no specific response matches.
+     * If not provided, returns an empty array response.
+     */
+    defaultResponse?: MockAnthropicResponse;
+    /**
+     * When true, all API calls will throw an error.
+     */
+    shouldFail?: boolean;
+    /**
+     * Custom error message when shouldFail is true.
+     * Defaults to "Mock Anthropic API error".
+     */
+    failureMessage?: string;
+    /**
+     * Custom error to throw when shouldFail is true.
+     * Takes precedence over failureMessage.
+     */
+    failureError?: Error;
+    /**
+     * Simulated latency in milliseconds.
+     * Useful for testing timeout handling.
+     */
+    latencyMs?: number;
+}
+/**
+ * Result returned by createMockAnthropic.
+ */
+export interface MockAnthropicResult {
+    /**
+     * The mock client that can be used in place of the real Anthropic SDK.
+     */
+    client: {
+        messages: {
+            create(params: MockAnthropicCall): Promise<MockAnthropicResponse>;
+        };
+    };
+    /**
+     * Array of all calls made to the mock client.
+     * Useful for assertions about API usage.
+     */
+    calls: MockAnthropicCall[];
+    /**
+     * Reset the calls array to empty.
+     */
+    reset: () => void;
+    /**
+     * Get the total number of calls made.
+     */
+    getCallCount: () => number;
+    /**
+     * Get the most recent call made, or undefined if no calls.
+     */
+    getLastCall: () => MockAnthropicCall | undefined;
+}
+/**
+ * Create a mock Anthropic client for testing.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const mock = createMockAnthropic()
+ * const response = await mock.client.messages.create({
+ *   model: "claude-haiku-4-20250514",
+ *   max_tokens: 256,
+ *   messages: [{ role: "user", content: "Hello" }]
+ * })
+ * expect(mock.calls).toHaveLength(1)
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With custom response
+ * const mock = createMockAnthropic({
+ *   defaultResponse: {
+ *     id: "test-id",
+ *     type: "message",
+ *     role: "assistant",
+ *     content: [{ type: "text", text: "Custom response" }],
+ *     model: "claude-haiku-4-20250514",
+ *     usage: { input_tokens: 10, output_tokens: 5 }
+ *   }
+ * })
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With failure injection
+ * const mock = createMockAnthropic({
+ *   shouldFail: true,
+ *   failureMessage: "Rate limit exceeded"
+ * })
+ * await expect(mock.client.messages.create(params)).rejects.toThrow("Rate limit exceeded")
+ * ```
+ */
+export declare const createMockAnthropic: (config?: MockAnthropicConfig) => MockAnthropicResult;
+/**
+ * Create a mock Anthropic client configured to return specific extraction candidates.
+ *
+ * This is a convenience factory for testing CandidateExtractorService and similar
+ * services that expect JSON array responses from the LLM.
+ *
+ * @example
+ * ```typescript
+ * const mock = createMockAnthropicForExtraction([
+ *   { content: "Always use transactions", confidence: "high", category: "patterns" },
+ *   { content: "Test database migrations", confidence: "medium", category: "testing" }
+ * ])
+ *
+ * // The mock will return these candidates as JSON text
+ * const response = await mock.client.messages.create({ ... })
+ * // response.content[0].text === '[{"content":"Always use transactions",...}]'
+ * ```
+ */
+export declare const createMockAnthropicForExtraction: (candidates: Array<{
+    content: string;
+    confidence: string;
+    category: string;
+}>) => MockAnthropicResult;
+//# sourceMappingURL=anthropic.mock.d.ts.map

package/dist/mocks/anthropic.mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.mock.d.ts","sourceRoot":"","sources":["../../src/mocks/anthropic.mock.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;IAC1B,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAClD,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,SAAS,CAAA;IACf,IAAI,EAAE,WAAW,CAAA;IACjB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC/C,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC1D;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAA;IAC9C;;;OAGG;IACH,eAAe,CAAC,EAAE,qBAAqB,CAAA;IACvC;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,KAAK,CAAA;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,EAAE;QACN,QAAQ,EAAE;YACR,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAA;SAClE,CAAA;KACF,CAAA;IACD;;;OAGG;IACH,KAAK,EAAE,iBAAiB,EAAE,CAAA;IAC1B;;OAEG;IACH,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB;;OAEG;IACH,YAAY,EAAE,MAAM,MAAM,CAAA;IAC1B;;OAEG;IACH,WAAW,EAAE,MAAM,iBAAiB,GAAG,SAAS,CAAA;CACjD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAQ,mBAAwB,KAAG,mBAkDtE,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gCAAgC,GAC3C,YAAY,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,KAC3E,mBAWF,CAAA"}

package/dist/mocks/anthropic.mock.js

@@ -0,0 +1,125 @@
+/**
+ * Mock Anthropic client for testing.
+ *
+ * Provides configurable mock Anthropic clients with call tracking,
+ * response fixtures, and failure injection for testing services
+ * that depend on the Anthropic API.
+ *
+ * @module @tx/test-utils/mocks/anthropic
+ */
+/**
+ * Create a mock Anthropic client for testing.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const mock = createMockAnthropic()
+ * const response = await mock.client.messages.create({
+ *   model: "claude-haiku-4-20250514",
+ *   max_tokens: 256,
+ *   messages: [{ role: "user", content: "Hello" }]
+ * })
+ * expect(mock.calls).toHaveLength(1)
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With custom response
+ * const mock = createMockAnthropic({
+ *   defaultResponse: {
+ *     id: "test-id",
+ *     type: "message",
+ *     role: "assistant",
+ *     content: [{ type: "text", text: "Custom response" }],
+ *     model: "claude-haiku-4-20250514",
+ *     usage: { input_tokens: 10, output_tokens: 5 }
+ *   }
+ * })
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With failure injection
+ * const mock = createMockAnthropic({
+ *   shouldFail: true,
+ *   failureMessage: "Rate limit exceeded"
+ * })
+ * await expect(mock.client.messages.create(params)).rejects.toThrow("Rate limit exceeded")
+ * ```
+ */
+export const createMockAnthropic = (config = {}) => {
+    const calls = [];
+    const client = {
+        messages: {
+            create: async (params) => {
+                // Track the call
+                calls.push(params);
+                // Simulate latency if configured
+                if (config.latencyMs) {
+                    await new Promise(resolve => setTimeout(resolve, config.latencyMs));
+                }
+                // Handle failure injection
+                if (config.shouldFail) {
+                    throw config.failureError || new Error(config.failureMessage || "Mock Anthropic API error");
+                }
+                // Check for specific response by message content
+                if (config.responses) {
+                    const key = JSON.stringify(params.messages);
+                    const specificResponse = config.responses.get(key);
+                    if (specificResponse) {
+                        return specificResponse;
+                    }
+                }
+                // Return default response or a minimal valid response
+                return config.defaultResponse || {
+                    id: "mock-msg-id",
+                    type: "message",
+                    role: "assistant",
+                    content: [{ type: "text", text: "[]" }],
+                    model: params.model,
+                    usage: { input_tokens: 10, output_tokens: 5 }
+                };
+            }
+        }
+    };
+    return {
+        client,
+        calls,
+        reset: () => {
+            calls.length = 0;
+        },
+        getCallCount: () => calls.length,
+        getLastCall: () => calls[calls.length - 1]
+    };
+};
+/**
+ * Create a mock Anthropic client configured to return specific extraction candidates.
+ *
+ * This is a convenience factory for testing CandidateExtractorService and similar
+ * services that expect JSON array responses from the LLM.
+ *
+ * @example
+ * ```typescript
+ * const mock = createMockAnthropicForExtraction([
+ *   { content: "Always use transactions", confidence: "high", category: "patterns" },
+ *   { content: "Test database migrations", confidence: "medium", category: "testing" }
+ * ])
+ *
+ * // The mock will return these candidates as JSON text
+ * const response = await mock.client.messages.create({ ... })
+ * // response.content[0].text === '[{"content":"Always use transactions",...}]'
+ * ```
+ */
+export const createMockAnthropicForExtraction = (candidates) => {
+    return createMockAnthropic({
+        defaultResponse: {
+            id: "mock-extraction-id",
+            type: "message",
+            role: "assistant",
+            content: [{ type: "text", text: JSON.stringify(candidates) }],
+            model: "claude-haiku-4-20250514",
+            usage: { input_tokens: 100, output_tokens: 50 }
+        }
+    });
+};
+//# sourceMappingURL=anthropic.mock.js.map

package/dist/mocks/anthropic.mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.mock.js","sourceRoot":"","sources":["../../src/mocks/anthropic.mock.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiGH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,SAA8B,EAAE,EAAuB,EAAE;IAC3F,MAAM,KAAK,GAAwB,EAAE,CAAA;IAErC,MAAM,MAAM,GAAG;QACb,QAAQ,EAAE;YACR,MAAM,EAAE,KAAK,EAAE,MAAyB,EAAkC,EAAE;gBAC1E,iBAAiB;gBACjB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;gBAElB,iCAAiC;gBACjC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;oBACrB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAA;gBACrE,CAAC;gBAED,2BAA2B;gBAC3B,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;oBACtB,MAAM,MAAM,CAAC,YAAY,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,cAAc,IAAI,0BAA0B,CAAC,CAAA;gBAC7F,CAAC;gBAED,iDAAiD;gBACjD,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;oBACrB,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;oBAC3C,MAAM,gBAAgB,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;oBAClD,IAAI,gBAAgB,EAAE,CAAC;wBACrB,OAAO,gBAAgB,CAAA;oBACzB,CAAC;gBACH,CAAC;gBAED,sDAAsD;gBACtD,OAAO,MAAM,CAAC,eAAe,IAAI;oBAC/B,EAAE,EAAE,aAAa;oBACjB,IAAI,EAAE,SAAS;oBACf,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;oBACvC,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,KAAK,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE;iBAC9C,CAAA;YACH,CAAC;SACF;KACF,CAAA;IAED,OAAO;QACL,MAAM;QACN,KAAK;QACL,KAAK,EAAE,GAAG,EAAE;YACV,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;QAClB,CAAC;QACD,YAAY,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM;QAChC,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;KAC3C,CAAA;AACH,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAC9C,UAA4E,EACvD,EAAE;IACvB,OAAO,mBAAmB,CAAC;QACzB,eAAe,EAAE;YACf,EAAE,EAAE,oBAAoB;YACxB,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7D,KAAK,EAAE,yBAAyB;YAChC,KAAK,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,EAAE,EAAE,EAAE;SAChD;KACF,CAAC,CAAA;AACJ,CAAC,CAAA"}