@llm-translate/cli 1.0.0-next.1 → 1.0.0-next.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llm-translate/cli",
-  "version": "1.0.0-next.1",
+  "version": "1.0.0-next.3",
   "description": "CLI-based document translation tool powered by LLMs with glossary enforcement and quality-aware refinement",
   "type": "module",
   "main": "./dist/index.js",

package/src/cli/commands/serve.ts

@@ -11,6 +11,7 @@ export interface ServeCommandOptions {
   auth?: boolean; // Commander's --no-auth sets this to false
   cors?: boolean;
   json?: boolean;
+  cacheDir?: string;
 }
 
 // ============================================================================
@@ -28,6 +29,11 @@ export const serveCommand = new Command('serve')
   .option('--no-auth', 'Disable API key authentication')
   .option('--cors', 'Enable CORS for browser clients')
   .option('--json', 'Use JSON logging format (for containers)')
+  .option(
+    '--cache-dir <path>',
+    'Cache directory path (env: TRANSLATE_CACHE_DIR)',
+    process.env['TRANSLATE_CACHE_DIR']
+  )
   .action((options: ServeCommandOptions) => {
     const port = parseInt(options.port ?? '3000', 10);
     const host = options.host ?? '0.0.0.0';
@@ -56,5 +62,6 @@ export const serveCommand = new Command('serve')
       enableCors: options.cors ?? false,
       apiKey: process.env['TRANSLATE_API_KEY'],
       jsonLogging: options.json ?? false,
+      cachePath: options.cacheDir,
     });
   });

package/src/core/engine.ts

@@ -35,6 +35,8 @@ export interface TranslationEngineOptions {
   verbose?: boolean;
   /** Disable caching (--no-cache mode) */
   noCache?: boolean;
+  /** External CacheManager instance (for server mode shared cache) */
+  cacheManager?: CacheManager;
 }
 
 export interface TranslateFileOptions {
@@ -83,20 +85,29 @@ export class TranslationEngine {
     }
 
     // Initialize cache
-    const cacheDisabled = options.noCache || !this.config.paths?.cache;
-    if (cacheDisabled) {
-      this.cache = createNullCacheManager();
-      if (this.verbose && options.noCache) {
-        logger.info('Cache disabled (--no-cache)');
-      }
-    } else {
-      this.cache = createCacheManager({
-        cacheDir: this.config.paths.cache!,
-        verbose: this.verbose,
-      });
+    if (options.cacheManager) {
+      // Use externally provided cache manager (e.g., server mode)
+      this.cache = options.cacheManager;
       if (this.verbose) {
         const stats = this.cache.getStats();
-        logger.info(`Cache initialized: ${stats.entries} entries`);
+        logger.info(`Using shared cache: ${stats.entries} entries`);
+      }
+    } else {
+      const cacheDisabled = options.noCache || !this.config.paths?.cache;
+      if (cacheDisabled) {
+        this.cache = createNullCacheManager();
+        if (this.verbose && options.noCache) {
+          logger.info('Cache disabled (--no-cache)');
+        }
+      } else {
+        this.cache = createCacheManager({
+          cacheDir: this.config.paths.cache!,
+          verbose: this.verbose,
+        });
+        if (this.verbose) {
+          const stats = this.cache.getStats();
+          logger.info(`Cache initialized: ${stats.entries} entries`);
+        }
       }
     }
   }

package/src/server/index.ts

@@ -19,6 +19,14 @@ import type { ServerConfig, ErrorResponse, HonoVariables } from './types.js';
 export function createApp(options: ServerConfig) {
   const app = new Hono<{ Variables: HonoVariables }>();
 
+  // Inject cachePath into context for all routes
+  if (options.cachePath) {
+    app.use('*', async (c, next) => {
+      c.set('cachePath', options.cachePath);
+      await next();
+    });
+  }
+
   // Request logging (first middleware)
   app.use('*', createLoggerMiddleware({
     json: options.jsonLogging ?? false,
@@ -113,6 +121,7 @@ export function startServer(options: ServerConfig): ServerType {
   console.log(`  - Translate: http://${options.host}:${options.port}/translate`);
   console.log(`  - Auth: ${options.enableAuth ? 'enabled' : 'disabled'}`);
   console.log(`  - CORS: ${options.enableCors ? 'enabled' : 'disabled'}`);
+  console.log(`  - Cache: ${options.cachePath ?? 'disabled'}`);
   console.log('');
 
   // Graceful shutdown handlers

package/src/server/routes/translate.ts

@@ -55,6 +55,9 @@ translateRouter.post(
       // Get mode presets
       const modeConfig = MODE_PRESETS[body.mode ?? 'balanced'];
 
+      // Get cache path from context (if configured via --cache-dir)
+      const cachePath = c.get('cachePath');
+
       // Build config with overrides
       const config = {
         ...baseConfig,
@@ -73,13 +76,17 @@ translateRouter.post(
           threshold: body.qualityThreshold ?? modeConfig.qualityThreshold,
           maxIterations: body.maxIterations ?? modeConfig.maxIterations,
         },
+        paths: {
+          ...baseConfig.paths,
+          cache: cachePath,
+        },
       };
 
-      // Create engine (API mode doesn't use file cache)
+      // Create engine
       const engine = createTranslationEngine({
         config,
         verbose: false,
-        noCache: true,
+        noCache: !cachePath,
       });
 
       // Convert inline glossary to resolved format if provided

package/src/server/types.ts

@@ -108,6 +108,7 @@ export interface ServerConfig {
   enableCors: boolean;
   apiKey?: string;
   jsonLogging?: boolean;
+  cachePath?: string;
 }
 
 // ============================================================================
@@ -119,6 +120,7 @@ export interface ServerConfig {
  */
 export interface HonoVariables {
   requestId: string;
+  cachePath?: string;
 }
 
 // ============================================================================