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

package/.github/workflows/docker-publish.yml

@@ -0,0 +1,99 @@
+name: Docker Publish
+
+on:
+  push:
+    branches:
+      - develop
+      - main
+    tags:
+      - "v*"
+    paths-ignore:
+      - "docs/**"
+      - "*.md"
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+permissions:
+  contents: read
+
+jobs:
+  build-and-push:
+    name: Build and Push Docker Image
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+      attestations: write
+      id-token: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract version from package.json
+        id: pkg
+        run: |
+          VERSION=$(node -p "require('./package.json').version")
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+      - name: Generate Docker tags
+        id: tags
+        run: |
+          IMAGE="${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}"
+          IMAGE_LOWER=$(echo "$IMAGE" | tr '[:upper:]' '[:lower:]')
+          VERSION="${{ steps.pkg.outputs.version }}"
+
+          if [[ "${{ github.ref_type }}" == "tag" ]]; then
+            # Tag push (v*) - stable release
+            TAG_VERSION="${GITHUB_REF_NAME#v}"
+            TAGS="${IMAGE_LOWER}:${TAG_VERSION},${IMAGE_LOWER}:latest"
+          elif [[ "${{ github.ref_name }}" == "main" ]]; then
+            # Main branch push - stable release
+            TAGS="${IMAGE_LOWER}:${VERSION},${IMAGE_LOWER}:latest"
+          elif [[ "${{ github.ref_name }}" == "develop" ]]; then
+            # Develop branch push - alpha release
+            ALPHA_VERSION="${VERSION}-alpha.${{ github.run_number }}"
+            TAGS="${IMAGE_LOWER}:${ALPHA_VERSION},${IMAGE_LOWER}:alpha"
+          fi
+
+          echo "tags=$TAGS" >> $GITHUB_OUTPUT
+          echo "Generated tags: $TAGS"
+
+      - name: Build and push Docker image
+        id: push
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          platforms: linux/amd64,linux/arm64
+          push: true
+          tags: ${{ steps.tags.outputs.tags }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+          labels: |
+            org.opencontainers.image.title=llm-translate
+            org.opencontainers.image.description=CLI-based document translation tool powered by LLMs
+            org.opencontainers.image.source=${{ github.server_url }}/${{ github.repository }}
+            org.opencontainers.image.revision=${{ github.sha }}
+            org.opencontainers.image.version=${{ steps.pkg.outputs.version }}
+
+      - name: Generate artifact attestation
+        uses: actions/attest-build-provenance@v2
+        with:
+          subject-name: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          subject-digest: ${{ steps.push.outputs.digest }}
+          push-to-registry: true

package/Dockerfile

@@ -38,9 +38,13 @@ COPY --from=builder --chown=llmtranslate:nodejs /app/node_modules ./node_modules
 COPY --from=builder --chown=llmtranslate:nodejs /app/dist ./dist
 COPY --from=builder --chown=llmtranslate:nodejs /app/package.json ./
 
+# Create cache directory with correct ownership
+RUN mkdir -p /app/cache && chown llmtranslate:nodejs /app/cache
+
 # Environment
 ENV NODE_ENV=production
 ENV TRANSLATE_PORT=3000
+ENV TRANSLATE_CACHE_DIR=/app/cache
 
 # Switch to non-root user
 USER llmtranslate
@@ -51,5 +55,6 @@ EXPOSE 3000
 HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
   CMD node -e "fetch('http://localhost:3000/health/live').then(r => r.ok ? process.exit(0) : process.exit(1)).catch(() => process.exit(1))"
 
-# Start server with JSON logging for container environments
-CMD ["node", "dist/cli/index.js", "serve", "--json"]
+# ENTRYPOINT for CLI, CMD for default arguments
+ENTRYPOINT ["node", "dist/cli/index.js"]
+CMD ["serve", "--json", "--cors", "--no-auth", "--cache-dir", "/app/cache"]

package/dist/cli/index.js

@@ -2973,20 +2973,28 @@ var init_engine = __esm({
           }
           this.provider = getProvider(this.config.provider.default, providerConfig);
         }
-        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) {
+          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`);
+            }
           }
         }
       }
@@ -4232,6 +4240,7 @@ translateRouter.post(
     try {
       const baseConfig = await loadConfig();
       const modeConfig = MODE_PRESETS2[body.mode ?? "balanced"];
+      const cachePath = c.get("cachePath");
       const config2 = {
         ...baseConfig,
         languages: {
@@ -4248,12 +4257,16 @@ translateRouter.post(
           ...baseConfig.quality,
           threshold: body.qualityThreshold ?? modeConfig.qualityThreshold,
           maxIterations: body.maxIterations ?? modeConfig.maxIterations
+        },
+        paths: {
+          ...baseConfig.paths,
+          cache: cachePath
         }
       };
       const engine = createTranslationEngine({
         config: config2,
         verbose: false,
-        noCache: true
+        noCache: !cachePath
       });
       if (body.glossary && body.glossary.length > 0) {
         convertInlineGlossary(body.glossary, body.sourceLang, body.targetLang);
@@ -4345,6 +4358,12 @@ function handleTranslationError(c, error, requestId) {
 // src/server/index.ts
 function createApp(options) {
   const app = new Hono();
+  if (options.cachePath) {
+    app.use("*", async (c, next) => {
+      c.set("cachePath", options.cachePath);
+      await next();
+    });
+  }
   app.use("*", createLoggerMiddleware({
     json: options.jsonLogging ?? false
   }));
@@ -4411,6 +4430,7 @@ llm-translate server started`);
   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("");
   const shutdown = (signal) => {
     console.log(`
@@ -4438,7 +4458,11 @@ var serveCommand = new Command("serve").description("Start the translation API s
   "-p, --port <number>",
   "Server port (env: TRANSLATE_PORT)",
   process.env["TRANSLATE_PORT"] ?? "3000"
-).option("-H, --host <string>", "Host to bind", "0.0.0.0").option("--no-auth", "Disable API key authentication").option("--cors", "Enable CORS for browser clients").option("--json", "Use JSON logging format (for containers)").action((options) => {
+).option("-H, --host <string>", "Host to bind", "0.0.0.0").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) => {
   const port = parseInt(options.port ?? "3000", 10);
   const host = options.host ?? "0.0.0.0";
   if (isNaN(port) || port < 1 || port > 65535) {
@@ -4460,7 +4484,8 @@ var serveCommand = new Command("serve").description("Start the translation API s
     enableAuth,
     enableCors: options.cors ?? false,
     apiKey: process.env["TRANSLATE_API_KEY"],
-    jsonLogging: options.json ?? false
+    jsonLogging: options.json ?? false,
+    cachePath: options.cacheDir
   });
 });