🌐 feat: Translate Docs With Claude Haiku 5.5 and Batch Prefetch

.env.template

@@ -38,7 +38,7 @@ SUPABASE_SERVICE_ROLE_KEY=
 OPENROUTER_API_KEY=
 # OpenRouter model ID (default: openai/gpt-5.4-nano)
 OPENROUTER_MODEL=
-# Model used for automatic docs translation (default: openai/gpt-5.4-nano)
+# Model used for automatic docs translation (default: anthropic/claude-haiku-5.5)
 OPENROUTER_TRANSLATE_MODEL=
 
 # Web Bot Auth (required in production for the public JWKS and signed agent requests)

.github/workflows/translate_docs.yml

@@ -16,7 +16,7 @@ on:
   # Convergence sweep. A push only translates after a content change, and adding a
   # new language doesn't touch content/docs at all — so a big batch (several new
   # locales and/or long files) can't fully land in the single push-triggered run
-  # under the flex-tier rate limit. This run writes generated docs to
+  # under provider rate limits. This run writes generated docs to
   # TRANSLATE_BRANCH and keeps translation memory in the Actions cache, so main stays
   # free of partial progress commits and cache files.
   #
@@ -175,7 +175,13 @@ jobs:
           if [ "${{ inputs.force }}" = "true" ]; then
             FLAGS="--force"
           fi
-          npx tsx scripts/translate.ts $FLAGS
+          # --batch sends every uncached block through the model's half-price
+          # `:batch` endpoint first and runs only the leftovers live. It waits up to
+          # TRANSLATE_BATCH_WAIT_MINUTES (default 180) so the live tail and the
+          # commit still fit in the job's 6-hour limit. Blocks of a batch still
+          # running then stay in English; content/.i18n-cache/batches.json carries
+          # the batch to the next run, which collects its answers.
+          npx tsx scripts/translate.ts --batch $FLAGS
 
       # `!cancelled()` so a translate step that failed part-way still commits the
       # pages it did finish; gated on the prepare step so a failure in checkout or