exai 1.6.2 → 1.7.0

package/dist/ai/query-cache.js

@@ -1,274 +1,25 @@
 /**
- * Query Cache - Local cache for LLM query results
+ * Query Cache - compatibility wrapper around the unified ExaiCache.
  *
- * Prevents duplicate API calls by caching responses locally based on:
- * - Prompt content
- * - Context content
- * - Model used
- * - Temperature setting
- *
- * Cache entries expire after 7 days by default.
- */
-import { createHash } from 'crypto';
-import { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync, statSync, unlinkSync } from 'fs';
-import { join } from 'path';
-import { tmpdir } from 'os';
-const DEFAULT_OPTIONS = {
-    cacheDir: join(tmpdir(), 'exai-cache'),
-    ttlDays: 7,
-    maxEntries: 100,
-    verbose: false,
-};
-/**
- * Generate cache key from query parameters
- */
-function generateCacheKey(prompt, model, temperature, format, context) {
-    const hash = createHash('sha256');
-    hash.update(prompt);
-    hash.update(model);
-    hash.update(String(temperature));
-    hash.update(format);
-    if (context) {
-        hash.update(context);
-    }
-    return hash.digest('hex');
-}
-/**
- * Generate shorter hash for context (for logging)
- */
-function generateContextHash(context) {
-    return createHash('sha256').update(context).digest('hex').slice(0, 8);
-}
-/**
- * Ensure cache directory exists
- */
-function ensureCacheDir(cacheDir) {
-    if (!existsSync(cacheDir)) {
-        mkdirSync(cacheDir, { recursive: true });
-    }
-}
-/**
- * Get cache file path for a given key
- */
-function getCacheFilePath(cacheDir, key) {
-    return join(cacheDir, `${key}.cache`);
-}
-/**
- * Check if a cache entry is expired
- */
-function isExpired(timestamp, ttlDays) {
-    const now = Date.now();
-    const age = now - timestamp;
-    const maxAge = ttlDays * 24 * 60 * 60 * 1000; // Convert days to milliseconds
-    return age > maxAge;
-}
-/**
- * Get cached response if it exists and is not expired
- */
-export function getCachedResponse(prompt, model, temperature, format, context, options = {}) {
-    const opts = { ...DEFAULT_OPTIONS, ...options };
-    const key = generateCacheKey(prompt, model, temperature, format, context);
-    ensureCacheDir(opts.cacheDir);
-    const cacheFile = getCacheFilePath(opts.cacheDir, key);
-    if (opts.verbose) {
-        console.log(`  Cache directory: ${opts.cacheDir}`);
-        console.log(`  Cache key: ${key.slice(0, 16)}...`);
-        console.log(`  Cache file: ${cacheFile}`);
-    }
-    if (!existsSync(cacheFile)) {
-        if (opts.verbose) {
-            console.log('  Cache miss: No cached response found');
-        }
-        return null;
-    }
-    try {
-        const content = readFileSync(cacheFile, 'utf-8');
-        const entry = JSON.parse(content);
-        // Check if expired
-        if (isExpired(entry.timestamp, opts.ttlDays)) {
-            if (opts.verbose) {
-                console.log('  Cache miss: Entry expired');
-            }
-            // Clean up expired entry
-            try {
-                unlinkSync(cacheFile);
-            }
-            catch {
-                // Ignore cleanup errors
-            }
-            return null;
-        }
-        // Validate entry matches
-        if (entry.prompt !== prompt ||
-            entry.model !== model ||
-            entry.temperature !== temperature ||
-            entry.format !== format) {
-            if (opts.verbose) {
-                console.log('  Cache miss: Parameters mismatch');
-            }
-            return null;
-        }
-        const age = Math.floor((Date.now() - entry.timestamp) / 1000 / 60); // minutes
-        if (opts.verbose) {
-            console.log(`  Cache hit: Response found (age: ${age}m)`);
-        }
-        return entry.response;
-    }
-    catch (error) {
-        if (opts.verbose) {
-            console.log(`  Cache error: ${error instanceof Error ? error.message : error}`);
-        }
-        return null;
-    }
-}
-/**
- * Cache a response
- */
-export function cacheResponse(prompt, model, temperature, format, response, context, options = {}) {
-    const opts = { ...DEFAULT_OPTIONS, ...options };
-    const key = generateCacheKey(prompt, model, temperature, format, context);
-    ensureCacheDir(opts.cacheDir);
-    const entry = {
-        key,
-        prompt,
-        model,
-        temperature,
-        format,
-        response,
-        timestamp: Date.now(),
-        contextHash: context ? generateContextHash(context) : undefined,
-    };
-    const cacheFile = getCacheFilePath(opts.cacheDir, key);
-    try {
-        writeFileSync(cacheFile, JSON.stringify(entry, null, 2), 'utf-8');
-        if (opts.verbose) {
-            console.log(`  Response cached successfully`);
-            console.log(`  Cache file: ${cacheFile}`);
-        }
-        // Clean up old entries if we exceed maxEntries
-        cleanupOldEntries(opts.cacheDir, opts.maxEntries, opts.verbose);
-    }
-    catch (error) {
-        if (opts.verbose) {
-            console.log(`  Cache write error: ${error instanceof Error ? error.message : error}`);
-        }
-        // Don't fail if caching fails
-    }
-}
-/**
- * Clean up old cache entries to stay within maxEntries limit
- */
-function cleanupOldEntries(cacheDir, maxEntries, verbose) {
-    try {
-        const files = readdirSync(cacheDir)
-            .filter(f => f.endsWith('.cache'))
-            .map(f => ({
-            path: join(cacheDir, f),
-            mtime: statSync(join(cacheDir, f)).mtime.getTime(),
-        }))
-            .sort((a, b) => b.mtime - a.mtime); // Sort by modified time, newest first
-        if (files.length <= maxEntries) {
-            return;
-        }
-        // Remove oldest entries
-        const toRemove = files.slice(maxEntries);
-        for (const file of toRemove) {
-            try {
-                unlinkSync(file.path);
-                if (verbose) {
-                    console.log(`  Cleaned up old cache entry: ${file.path}`);
-                }
-            }
-            catch {
-                // Ignore cleanup errors
-            }
-        }
-    }
-    catch (error) {
-        if (verbose) {
-            console.log(`  Cache cleanup error: ${error instanceof Error ? error.message : error}`);
-        }
-    }
-}
-/**
- * Clear all cache entries
- */
-export function clearCache(options = {}) {
-    const opts = { ...DEFAULT_OPTIONS, ...options };
-    if (!existsSync(opts.cacheDir)) {
-        return 0;
-    }
-    try {
-        const files = readdirSync(opts.cacheDir).filter(f => f.endsWith('.cache'));
-        let cleared = 0;
-        for (const file of files) {
-            try {
-                unlinkSync(join(opts.cacheDir, file));
-                cleared++;
-            }
-            catch {
-                // Ignore errors
-            }
-        }
-        return cleared;
-    }
-    catch (error) {
-        if (opts.verbose) {
-            console.log(`  Cache clear error: ${error instanceof Error ? error.message : error}`);
-        }
-        return 0;
-    }
-}
-/**
- * Get cache statistics
- */
-export function getCacheStats(options = {}) {
-    const opts = { ...DEFAULT_OPTIONS, ...options };
-    if (!existsSync(opts.cacheDir)) {
-        return {
-            totalEntries: 0,
-            totalSize: 0,
-            oldestEntry: null,
-            newestEntry: null,
-        };
-    }
-    try {
-        const files = readdirSync(opts.cacheDir)
-            .filter(f => f.endsWith('.cache'))
-            .map(f => join(opts.cacheDir, f));
-        let totalSize = 0;
-        let oldestEntry = null;
-        let newestEntry = null;
-        for (const file of files) {
-            try {
-                const stats = statSync(file);
-                totalSize += stats.size;
-                const mtime = stats.mtime.getTime();
-                if (oldestEntry === null || mtime < oldestEntry) {
-                    oldestEntry = mtime;
-                }
-                if (newestEntry === null || mtime > newestEntry) {
-                    newestEntry = mtime;
-                }
-            }
-            catch {
-                // Ignore errors
-            }
-        }
-        return {
-            totalEntries: files.length,
-            totalSize,
-            oldestEntry,
-            newestEntry,
-        };
-    }
-    catch (error) {
-        return {
-            totalEntries: 0,
-            totalSize: 0,
-            oldestEntry: null,
-            newestEntry: null,
-        };
-    }
+ * Public API is unchanged so existing call-sites continue to compile.
+ * Configuration (TTL, maxEntries, verbose) is now managed on the shared
+ * `cache` singleton in cache.ts — the options parameters below are accepted
+ * for backward compatibility but are no longer used.
+ */
+import { cache, makeKey } from './cache.js';
+// ── Delegating functions ──────────────────────────────────────────────────────
+export function getCachedResponse(prompt, model, temperature, format, context, _options = {}) {
+    const key = makeKey(prompt, model, temperature, format, context ?? '');
+    return cache.get('llm', key);
+}
+export function cacheResponse(prompt, model, temperature, format, response, context, _options = {}) {
+    const key = makeKey(prompt, model, temperature, format, context ?? '');
+    cache.set('llm', key, response);
+}
+export function clearCache(_options = {}) {
+    return cache.clear();
+}
+export function getCacheStats(_options = {}) {
+    return cache.stats();
 }
 //# sourceMappingURL=query-cache.js.map

package/dist/ai/query-cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"query-cache.js","sourceRoot":"","sources":["../../src/ai/query-cache.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"query-cache.js","sourceRoot":"","sources":["../../src/ai/query-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAsB5C,iFAAiF;AAEjF,MAAM,UAAU,iBAAiB,CAC7B,MAAc,EACd,KAAa,EACb,WAAmB,EACnB,MAAc,EACd,OAAgB,EAChB,WAAyB,EAAE;IAE3B,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IACvE,OAAO,KAAK,CAAC,GAAG,CAAS,KAAK,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,aAAa,CACzB,MAAc,EACd,KAAa,EACb,WAAmB,EACnB,MAAc,EACd,QAAgB,EAChB,OAAgB,EAChB,WAAyB,EAAE;IAE3B,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IACvE,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,WAAyB,EAAE;IAClD,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,WAAyB,EAAE;IAMrD,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC"}

package/dist/cli.js

@@ -16,7 +16,7 @@ import { layoutGraph } from './layout/elk-layout.js';
 import { generateExcalidraw, serializeExcalidraw } from './generator/excalidraw-generator.js';
 import { generateFlowchartInput } from './ai/openrouter.js';
 import { gatherContext } from './ai/context-gatherer.js';
-import { clearCache, getCacheStats } from './ai/query-cache.js';
+import { cache } from './ai/cache.js';
 import { loadConfig, CONFIG_TEMPLATE } from './ai/config.js';
 const require = createRequire(import.meta.url);
 const pkg = require('../package.json');
@@ -230,22 +230,34 @@ program
 program
     .command('parse')
     .description('Parse and validate input without generating output')
-    .argument('<input>', 'Input file path')
+    .argument('[input]', 'Input file path')
     .option('-f, --format <type>', 'Input format: dsl, json, dot (default: dsl)', 'dsl')
+    .option('--inline <dsl>', 'Inline DSL/DOT string')
+    .option('--stdin', 'Read input from stdin')
     .action((inputFile, options, command) => {
     try {
-        const input = readFileSync(inputFile, 'utf-8');
+        let input;
         let format = options.format;
         const formatExplicitlySet = command.getOptionValueSource('format') === 'cli';
-        // Auto-detect format from file extension (only if --format not explicitly set)
-        if (!formatExplicitlySet) {
-            if (inputFile.endsWith('.json')) {
-                format = 'json';
-            }
-            else if (inputFile.endsWith('.dot') || inputFile.endsWith('.gv')) {
-                format = 'dot';
+        if (options.inline) {
+            input = options.inline;
+        }
+        else if (options.stdin) {
+            input = readFileSync(0, 'utf-8');
+        }
+        else if (inputFile) {
+            input = readFileSync(inputFile, 'utf-8');
+            if (!formatExplicitlySet) {
+                if (inputFile.endsWith('.json'))
+                    format = 'json';
+                else if (inputFile.endsWith('.dot') || inputFile.endsWith('.gv'))
+                    format = 'dot';
             }
         }
+        else {
+            console.error('Error: No input provided. Use --inline, --stdin, or provide an input file.');
+            process.exit(1);
+        }
         // Parse input
         let graph;
         if (format === 'json') {
@@ -260,6 +272,8 @@ program
         console.log('Parse successful!');
         console.log(`  Nodes: ${graph.nodes.length}`);
         console.log(`  Edges: ${graph.edges.length}`);
+        if (graph.groups?.length)
+            console.log(`  Groups: ${graph.groups.length}`);
         console.log(`  Direction: ${graph.options.direction}`);
         console.log('\nNodes:');
         for (const node of graph.nodes) {
@@ -272,6 +286,15 @@ program
             const label = edge.label ? ` "${edge.label}"` : '';
             console.log(`  - ${sourceNode?.label} ->${label} ${targetNode?.label}`);
         }
+        if (graph.groups?.length) {
+            console.log('\nGroups:');
+            for (const group of graph.groups) {
+                const memberLabels = group.nodeIds
+                    .map((id) => graph.nodes.find((n) => n.id === id)?.label ?? id)
+                    .join(', ');
+                console.log(`  - [${group.id}] "${group.label}" (${memberLabels})`);
+            }
+        }
     }
     catch (error) {
         console.error('Parse error:', error instanceof Error ? error.message : error);
@@ -297,7 +320,9 @@ program
     .option('--allow-test-files', 'Include test files in context (default: excluded)')
     .option('--no-compress', 'Disable context compression')
     .option('--compress-mode <mode>', 'Compression mode: balanced, aggressive, minimal (default: balanced)', 'balanced')
-    .option('--no-cache', 'Disable LLM response caching')
+    .option('--no-cache', 'Disable LLM response cache')
+    .option('--no-context-cache', 'Disable context-gather cache (re-gather files every run)')
+    .option('--redraw', 'Re-render using cached context + cached LLM response — no API call (fails if either cache is cold)')
     .option('--only-context', 'Only gather and display context, do not generate diagram')
     .option('--config-path <path>', 'Path to config JSON file')
     .option('--verbose', 'Verbose output')
@@ -307,6 +332,13 @@ program
         // Load config file if provided and merge with CLI options
         // Priority: CLI flags > env/.env > config file > hardcoded defaults
         let config = {};
+        const DEFAULT_CONFIG_NAME = 'exai.config.json';
+        const autoConfigPath = resolve(DEFAULT_CONFIG_NAME);
+        let configAutoDetected = false;
+        if (!options.configPath && existsSync(autoConfigPath)) {
+            options.configPath = autoConfigPath;
+            configAutoDetected = true;
+        }
         if (options.configPath) {
             config = loadConfig(options.configPath);
             // Helper: use CLI value if explicitly set, otherwise config value
@@ -340,13 +372,26 @@ program
             // Cache
             if (config.cache !== undefined && src('cache') !== 'cli')
                 options.cache = config.cache;
+            if (config.contextCache !== undefined && src('contextCache') !== 'cli')
+                options.contextCache = config.contextCache;
             // Misc
             if (config.verbose !== undefined && src('verbose') !== 'cli')
                 options.verbose = config.verbose;
             if (options.verbose) {
-                console.log(`📄 Config loaded from: ${resolve(options.configPath)}`);
+                const label = configAutoDetected ? '📄 Config auto-detected' : '📄 Config loaded';
+                console.log(`${label}: ${resolve(options.configPath)}`);
+                const applied = Object.keys(config).filter(k => k !== 'apiKey');
+                if (applied.length > 0) {
+                    console.log(`   Keys applied: ${applied.join(', ')}`);
+                }
             }
         }
+        // Configure the shared cache singleton (TTL, maxEntries, verbose)
+        cache.configure({
+            ttlDays: config.cacheTtlDays,
+            maxEntries: config.cacheMaxEntries,
+            verbose: options.verbose,
+        });
         const format = options.format;
         // Validate format
         if (format !== 'dsl' && format !== 'json') {
@@ -387,11 +432,21 @@ program
             console.log(`🧪 Test files: included`);
         }
         console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
+        // --redraw requires context paths
+        if (options.redraw && (!options.context || options.context.length === 0)) {
+            console.error('Error: --redraw requires at least one context path via -c or config "context".');
+            process.exit(1);
+        }
         // Gather context if provided
         let contextString;
+        if (options.onlyContext && options.context.length === 0) {
+            console.error('Error: --only-context requires at least one context path via -c or config "context".');
+            process.exit(1);
+        }
         if (options.context && options.context.length > 0) {
             try {
-                console.log('📂 [1/5] Gathering Context...');
+                const isRedraw = options.redraw === true;
+                console.log(`📂 [1/5] ${isRedraw ? 'Loading Context from cache...' : 'Gathering Context...'}`);
                 if (options.verbose) {
                     console.log(`  CLI received context paths:`);
                     options.context.forEach((p) => console.log(`    - ${p}`));
@@ -403,41 +458,45 @@ program
                 const compressionOptions = config.compressOptions
                     ? { ...modeDefaults, ...config.compressOptions }
                     : modeDefaults;
+                // context cache: disabled by --no-context-cache, forced cache-only by --redraw
+                const useContextCache = options.contextCache !== false && !isRedraw;
+                const contextCacheOnly = isRedraw;
                 const contextResult = await gatherContext(options.context, {
                     apiKey: options.apiKey,
                     filterModel: config.filterModel,
                     verbose: options.verbose,
                     compress: options.compress !== false,
                     compressOptions: compressionOptions,
-                    useCache: options.cache !== false,
+                    useCache: useContextCache,
+                    cacheOnly: contextCacheOnly,
                     excludePatterns: options.exclude,
                     allowTestFiles: options.allowTestFiles ?? false,
                     maxFileSize: config.maxFileSize,
                     maxDepth: config.maxDepth,
                     maxTreeItems: config.maxTreeItems,
-                    cacheTtlDays: config.cacheTtlDays,
-                    cacheMaxEntries: config.cacheMaxEntries,
+                    timeoutMs: config.timeoutSecs !== undefined ? config.timeoutSecs * 1000 : undefined,
                 });
+                if (contextResult === null) {
+                    console.error('❌ --redraw failed: context cache is cold for these paths.');
+                    console.error('   Run without --redraw first to populate the cache.');
+                    process.exit(1);
+                }
                 contextString = contextResult.markdown;
                 const contextTime = Date.now() - contextStart;
-                let contextMsg = `✓ Context gathered (${(contextString.length / 1024).toFixed(1)}KB in ${contextTime}ms)`;
+                let contextMsg = `✓ Context ${contextResult.fromCache ? '[CACHE]' : 'gathered'} (${(contextString.length / 1024).toFixed(1)}KB in ${contextTime}ms)`;
                 if (contextResult.compression && options.compress !== false) {
                     contextMsg += ` - ${contextResult.compression.ratio.toFixed(1)}% compression`;
                 }
-                if (contextResult.fromCache) {
-                    contextMsg += ` [FROM CACHE]`;
-                }
                 console.log(contextMsg);
                 if (options.verbose) {
                     const t = contextResult.timing;
-                    let summary = `Context gathering: ${(contextString.length / 1024).toFixed(1)}KB `;
+                    let summary = `Context: ${(contextString.length / 1024).toFixed(1)}KB `;
                     if (contextResult.compression) {
                         summary += `(${contextResult.compression.ratio.toFixed(1)}% compressed) `;
                     }
                     summary += `(tree: ${t.treeMs}ms, filter: ${t.filterMs}ms, read: ${t.readMs}ms`;
-                    if (t.compressMs) {
+                    if (t.compressMs)
                         summary += `, compress: ${t.compressMs}ms`;
-                    }
                     summary += `)`;
                     console.log(`  ${summary}`);
                     console.log(`  Cache key: ${contextResult.cacheKey}`);
@@ -453,7 +512,7 @@ program
                     console.log(`✅ Context gathering complete!`);
                     console.log(`📦 Size: ${(contextString.length / 1024).toFixed(1)}KB`);
                     if (contextResult.cacheKey) {
-                        const cachePath = join(tmpdir(), 'exai-cache', contextResult.cacheKey);
+                        const cachePath = join(tmpdir(), 'exai-cache', `context__${contextResult.cacheKey}.json`);
                         console.log(`🔑 Cache key: ${contextResult.cacheKey}`);
                         console.log(`📁 Cache path: ${cachePath}`);
                     }
@@ -466,23 +525,34 @@ program
                 process.exit(1);
             }
         }
-        // Generate input using AI
-        console.log('🤖 [2/5] Calling AI to generate flowchart...');
+        // Generate input using AI (or load from LLM cache on --redraw)
+        const isRedraw = options.redraw === true;
+        console.log(`🤖 [2/5] ${isRedraw ? 'Loading diagram from LLM cache...' : 'Calling AI to generate flowchart...'}`);
         const aiStart = Date.now();
-        const input = await generateFlowchartInput(prompt, format, {
-            model: options.model,
-            apiKey: options.apiKey,
-            temperature,
-            context: contextString,
-            verbose: options.verbose,
-            useCache: options.cache !== false,
-            cacheOptions: {
-                ttlDays: config.cacheTtlDays,
-                maxEntries: config.cacheMaxEntries,
-            },
-        });
+        let input;
+        try {
+            input = await generateFlowchartInput(prompt, format, {
+                model: options.model,
+                apiKey: options.apiKey,
+                temperature,
+                context: contextString,
+                verbose: options.verbose,
+                useCache: options.cache !== false,
+                cacheOnly: isRedraw,
+                timeoutMs: config.timeoutSecs !== undefined ? config.timeoutSecs * 1000 : undefined,
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (msg.startsWith('CACHE_MISS:')) {
+                console.error('❌ --redraw failed: LLM cache is cold for this prompt + context.');
+                console.error('   Run without --redraw first to populate the cache.');
+                process.exit(1);
+            }
+            throw err;
+        }
         const aiTime = Date.now() - aiStart;
-        console.log(`✓ AI generation complete (${input.length} chars in ${aiTime}ms)`);
+        console.log(`✓ ${isRedraw ? 'Loaded from LLM cache' : 'AI generation complete'} (${input.length} chars in ${aiTime}ms)`);
         if (options.verbose) {
             console.log(`\n${format.toUpperCase()} Output:`);
             console.log('─────────────────────────────────────────');
@@ -563,11 +633,11 @@ program
     .action((action) => {
     try {
         if (action === 'clear') {
-            const cleared = clearCache({ verbose: true });
+            const cleared = cache.clear();
             console.log(`✓ Cleared ${cleared} cache entries`);
         }
         else if (action === 'stats') {
-            const stats = getCacheStats();
+            const stats = cache.stats();
             console.log('Cache Statistics:');
             console.log(`  Total Entries: ${stats.totalEntries}`);
             console.log(`  Total Size: ${(stats.totalSize / 1024).toFixed(2)} KB`);