ai-i18n-tools 1.5.0 → 1.6.0

package/README.md

@@ -7,26 +7,38 @@
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
 [![CI](https://github.com/wsj-br/ai-i18n-tools/actions/workflows/ci.yml/badge.svg)](https://github.com/wsj-br/ai-i18n-tools/actions/workflows/ci.yml)
 
-CLI and toolkit for internationalising JavaScript/TypeScript applications and documentation sites using large language models via [OpenRouter](https://openrouter.ai/). Two independent workflows: **UI Translation** extracts `t("…")` calls and writes locale-ready JSON for i18next; **Document Translation** translates markdown, MDX, and SVG files with a smart SQLite cache so only changed segments are re-sent to the LLM.
+A CLI and toolkit for internationalizing JavaScript/TypeScript applications and documentation sites using large language models via [OpenRouter](https://openrouter.ai/). Three modular workflows, all sharing a single config file, support different translation needs:
 
+- **Workflow 1 — UI Translation:** Extracts `t("…")` calls from JS/TS (and optionally from `.astro` files) and generates flat, per-locale JSON for i18next or static SSG lookup.
+- **Workflow 2 — Document Translation:** Translates markdown, MDX, and `.astro` pages (for websites and Starlight) listed in `docs[].contentPaths` using `translate-docs`.
+- **Workflow 3 — JSON File Translation:** Translates arbitrary nested JSON bundles defined in `json[]`. Use `translate-json` when UI copy is stored in per-locale JSON files instead of using `t()` in source.
+
+**SVG** assets are translated using `features.translateSVG`, the top-level `svg` block, and `translate-svg`—not `docs[].contentPaths`.
+
+**Which workflow should I use?**
+- Source uses `t()` → **Workflow 1** (`extract` / `translate-ui`)
+- Localized pages or Docusaurus catalog JSON → **Workflow 2** (`translate-docs`)
+- Only standalone, nested JSON locale files → **Workflow 3** (`translate-json`)
+
+All workflows maintain a file/SQLite cache to ensure that only new or changed segments (strings or text chunks) are sent to the LLM.
 
 <small>**Read in other languages:** </small>
 <small id="lang-list">[English (GB)](./README.md) · [Deutsch](./translated-docs/README.de.md) · [Español](./translated-docs/README.es.md) · [Français](./translated-docs/README.fr.md) · [हिन्दी](./translated-docs/README.hi.md) · [日本語](./translated-docs/README.ja.md) · [한국어](./translated-docs/README.ko.md) · [Português (Brasil)](./translated-docs/README.pt-BR.md) · [中文 (中国大陆)](./translated-docs/README.zh-CN.md) · [中文 (台灣)](./translated-docs/README.zh-TW.md)</small>
 
-<small>Translated READMEs and docs are committed under [`translated-docs/`](https://github.com/wsj-br/ai-i18n-tools/tree/main/translated-docs) on GitHub; the npm package ships English `docs/` only.</small>
 
 <!-- START doctoc generated TOC please keep comment here to allow auto update -->
 <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
 **Table of Contents** 
 
-- [Two core workflows](#two-core-workflows)
+- [Core workflows](#core-workflows)
 - [Installation](#installation)
   - [Using the CLI](#using-the-cli)
 - [OpenRouter](#openrouter)
 - [Quick start](#quick-start)
   - [Workflow 1 - UI Translation](#workflow-1---ui-translation)
   - [Workflow 2 - Document Translation](#workflow-2---document-translation)
-  - [Both workflows](#both-workflows)
+  - [Astro (plain Astro & Starlight)](#astro-plain-astro--starlight)
+  - [Combined workflow](#combined-workflow)
 - [Runtime helpers](#runtime-helpers)
 - [CLI commands](#cli-commands)
 - [Documentation](#documentation)
@@ -38,18 +50,22 @@ CLI and toolkit for internationalising JavaScript/TypeScript applications and do
 
 
 
-<a id="two-core-workflows"></a>
-## Two core workflows
+<a id="core-workflows"></a>
+## Core workflows
+
+**Workflow 1 - UI Translation** — for any JS/TS project using i18next (React, Next.js, Node.js, CLIs) or static Astro SSG
 
-**Workflow 1 - UI Translation** — for any JS/TS project using i18next (React, Next.js, Node.js, CLIs)
+Scans source files for `t("…")` / `i18n.t("…")` literals (add `.astro` to `ui.uiExtractor.extensions` for Astro frontmatter and template expressions), builds a master catalog (`strings.json`), translates missing entries per locale via OpenRouter, and writes flat JSON files (`de.json`, `pt-BR.json`, …). English source text is the runtime lookup key in those bundles — `strings.json` is the extraction cache, not the runtime bundle.
 
-Scans source files for `t("…")` / `i18n.t("…")` literals, builds a master catalog (`strings.json`), translates missing entries per locale via OpenRouter, and writes flat JSON files (`de.json`, `pt-BR.json`, …) ready for i18next.
+**Workflow 2 - Document Translation** — for markdown, MDX, and `.astro` under `docs[].contentPaths`
 
-**Workflow 2 - Document Translation** — for markdown/MDX docs (Docusaurus, Astro Starlight, plain README files) and `.astro` page HTML (plain Astro marketing sites)
+Designed primarily for **markdown, MDX, and `.astro` documentation** (Docusaurus, [Astro Starlight](https://starlight.astro.build/), plain README files, and plain Astro marketing pages). `translate-docs` writes localised copies with a shared SQLite cache. On Docusaurus sites, set `docs[].docusaurusCatalogDir` to the `write-translations` catalog folder so shell JSON (navbar, footer, theme strings) is translated in the same command. `docs[].docsOutput.style` supports `"nested"`, `"flat"`, `"doc-system"`, and aliases `"docusaurus"` / `"astro-starlight"` (see [Output layouts](docs/GETTING_STARTED.md#output-layouts) in Getting Started). Arbitrary nested UI JSON that is not a Docusaurus catalog belongs in Workflow 3 (`json[]` / `translate-json`), not `docs[]`.
 
-Translates `.md`, `.mdx`, and `.astro` source files to every target locale with a shared SQLite cache — only new or changed segments are sent to the LLM. Optional Docusaurus shell JSON (`jsonSource`, from `write-translations`) covers navbar, footer, and theme UI strings. SVG file translation is enabled via `features.translateSVG` and the top-level `svg` block. For plain Astro sites, see [`examples/astro-website`](examples/astro-website/) (hybrid: `translate-docs` for page HTML plus `t()` for frontmatter strings).
+**Workflow 3 - JSON file translation** — nested locale JSON without `t()` in source
 
-Both workflows share a single `ai-i18n-tools.config.json` file and can be used independently or together.
+Translate files such as `src/i18n/en/translation.json` via top-level `json[]`, `features.translateJson`, and `translate-json`. Scaffold with `init -t ui-json-bundles`.
+
+All workflows share `ai-i18n-tools.config.json` and can be combined; `sync` runs extract, UI translation, translate SVG, `translate-docs`, and `translate-json` in order according to your `features` flags.
 
 ---
 
@@ -76,11 +92,22 @@ npx ai-i18n-tools sync        # or: pnpm exec ai-i18n-tools sync
 
 ```json
 "scripts": {
+  "i18n:extract": "ai-i18n-tools extract",
   "i18n:sync": "ai-i18n-tools sync",
-  "i18n:translate": "ai-i18n-tools translate-docs"
+  "i18n:translate:ui": "ai-i18n-tools translate-ui",
+  "i18n:translate:svg": "ai-i18n-tools translate-svg",
+  "i18n:translate:docs": "ai-i18n-tools translate-docs",
+  "i18n:translate:json": "ai-i18n-tools translate-json",
+  "i18n:translate": "ai-i18n-tools translate-docs",
+  "i18n:dashboard": "ai-i18n-tools dashboard"
 }
 ```
 
+You can also use the ai-i18n-tools CLI commands directly, for instance `ai-i18n-tools sync`.
+
+
+Prefer `sync` over hand-chaining `extract`, `translate-ui`, `translate-svg`, `translate-docs`, and `translate-json` — order and feature flags are easy to get wrong when run manually. See [Recommended `package.json` scripts](docs/GETTING_STARTED.md#recommended-packagejson-scripts) in Getting Started.
+
 **Zero-install one-off** — `npx ai-i18n-tools <cmd>` or `pnpm dlx ai-i18n-tools <cmd>` (downloads for that invocation only).
 
 > **Tip:** To run `ai-i18n-tools` bare in an interactive shell without `npx`, add `node_modules/.bin` to your `PATH` (bash/zsh: `export PATH="$PWD/node_modules/.bin:$PATH"`). See [Getting Started](docs/GETTING_STARTED.md#installation) for direnv and Windows instructions.
@@ -96,7 +123,7 @@ export OPENROUTER_API_KEY=sk-or-v1-your-key-here
 <a id="openrouter"></a>
 ## OpenRouter
 
-Commands that call OpenRouter (`translate-ui`, `translate-docs`, `sync`, `check-models`, and related scripts) need `OPENROUTER_API_KEY` in the environment. `check-markdown` does not use OpenRouter.
+Commands that call OpenRouter (`translate-ui`, `translate-docs`, `translate-json`, `sync`, `check-models`, and related scripts) need `OPENROUTER_API_KEY` in the environment. `check-markdown` does not use OpenRouter.
 
 In `ai-i18n-tools.config.json`, the `openrouter` object includes model lists, `baseUrl`, `maxTokens`, `temperature`, and `requestTimeoutMs`: the maximum time in milliseconds to wait for each HTTP request to OpenRouter (chat completions and internal `GET /models` calls). The default is `30000` (30 seconds).
 
@@ -111,7 +138,7 @@ Run `ai-i18n-tools check-models` to verify each configured model id against Open
 ### Workflow 1 - UI Translation
 
 ```bash
-# 1. Create config
+# 1. Create config (default ui-markdown; plain Astro: init -t ui-astro-website)
 npx ai-i18n-tools init
 
 # 2. Extract UI strings to strings.json
@@ -126,24 +153,48 @@ Then wire i18next in your app using the helpers from `'ai-i18n-tools/runtime'`.
 <a id="workflow-2---document-translation"></a>
 ### Workflow 2 - Document Translation
 
+The default `init` template (`ui-markdown`) enables UI extraction only. Use a docs-oriented template (or enable `features.translateDocs` and add `docs[]`) before `translate-docs`:
+
 ```bash
-# 1. Create config for Docusaurus
+# Docusaurus docs + optional write-translations catalog
 npx ai-i18n-tools init -t ui-docusaurus
-# Astro Starlight: npx ai-i18n-tools init -t ui-starlight
-# Plain Astro website (UI + optional page HTML): npx ai-i18n-tools init -t ui-astro-website
 
-# 2. Translate all docs
-npx ai-i18n-tools translate-docs
+# Astro Starlight documentation
+# npx ai-i18n-tools init -t ui-starlight
 
-# 3. Check status
+# Plain Astro website — UI extraction for t() in .astro; add docs[] for page HTML (see Astro below)
+# npx ai-i18n-tools init -t ui-astro-website
+
+npx ai-i18n-tools translate-docs
 npx ai-i18n-tools status
+# npx ai-i18n-tools translate-docs --locale de   # single locale
 ```
 
-<a id="both-workflows"></a>
-### Both workflows
+Edit `ai-i18n-tools.config.json`: set `docs[].contentPaths` to markdown, MDX, and/or `.astro` sources; `docs[].outputDir` and `docs[].docsOutput.style` (`"docusaurus"`, `"astro-starlight"`, `"flat"`, etc.). Full field reference: [Workflow 2 - Document Translation](docs/GETTING_STARTED.md#workflow-2---document-translation).
+
+<a id="astro-plain-astro--starlight"></a>
+### Astro (plain Astro & Starlight)
+
+**Astro Starlight** — `init -t ui-starlight`, then `translate-docs`. Starlight UI overrides can use `src/content/i18n/en.json` with `jsonPathTemplate` in a separate `docs[]` block when needed ([Getting Started → Workflow 2](docs/GETTING_STARTED.md#step-1-initialise-for-documentation)).
+
+**Plain Astro** (marketing or app sites, not Starlight) — combine [Astro built-in i18n routing](https://docs.astro.build/en/guides/internationalization/) with ai-i18n-tools. Reference project: [`examples/astro-website`](examples/astro-website/) (English at `/`, locales at `/{locale}/`).
+
+Most teams use a **hybrid** of two pipelines:
+
+| Pipeline | Use for | Commands | Output |
+|----------|---------|----------|--------|
+| **Page HTML** | Headings, paragraphs, nav labels, inline arrays in the template body | `translate-docs` | `src/pages/{locale}/index.astro` per locale |
+| **UI strings (`t()`)** | Frontmatter data, tab labels, shared arrays | `extract` → `translate-ui` | `public/locales/{locale}.json` (English source as key) |
+
+Scaffold UI with `init -t ui-astro-website`. For hardcoded HTML in `.astro` pages, enable `features.translateDocs` and add a `docs[]` block with `docsOutput.style: "astro-starlight"` (see [Astro website pages (parse-and-replace)](docs/GETTING_STARTED.md#astro-website-pages-parse-and-replace)). Keep `targetLocales`, `i18n.locales` in `astro.config.mjs`, and `ui-languages.json` aligned (Astro routes use lowercase codes such as `pt-br`; flat bundle filenames follow config casing, e.g. `pt-BR.json`).
+
+Wire `t()` at build time without i18next unless you add client islands — see [Astro website UI strings (SSG)](docs/GETTING_STARTED.md#astro-website-ui-strings-ssg) and the example’s `src/i18n/t.ts`.
+
+<a id="combined-workflow"></a>
+### Combined workflow
 
 ```bash
-npx ai-i18n-tools sync   # Extract UI strings, then translate UI strings, SVG, and docs
+npx ai-i18n-tools sync   # extract → translate-ui → translate-svg → translate-docs → translate-json (per features)
 ```
 
 ---
@@ -157,6 +208,9 @@ The following helpers are exported from `'ai-i18n-tools/runtime'` and work in an
 |------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
 | `defaultI18nInitOptions(sourceLocale)`                                 | Standard i18next init options for key-as-default setups.                                                                               |
 | `setupKeyAsDefaultT(i18n, { stringsJson, sourcePluralFlatBundle? })`   | Recommended wiring: key-trim + plural `wrapT` from `strings.json`, optionally merges `translate-ui` `{sourceLocale}.json` plural keys. |
+| `wrapT(i18n, options)`                                                 | Lower-level plural-aware `t()` wrapper (usually installed by `setupKeyAsDefaultT`).                                                    |
+| `buildPluralIndexFromStringsJson(entries)`                               | Builds the plural group index `wrapT` uses from catalog rows with `"plural": true`.                                                    |
+| `extractInterpolationNamesForWrap(key)`                                  | Parses `{{var}}` names from a source key for `wrapT` / key-trim fallback.                                                              |
 | `wrapI18nWithKeyTrim(i18n)`                                            | Lower-level key-trim wrapper only (deprecated for app wiring; prefer `setupKeyAsDefaultT`).                                            |
 | `makeLocaleLoadersFromManifest(uiLanguages, sourceLocale, makeLoader)` | Builds the `localeLoaders` map for `makeLoadLocale` from `ui-languages.json` (every `code` except `sourceLocale`).                     |
 | `makeLoadLocale(i18n, loaders, sourceLocale)`                          | Factory for async locale file loading.                                                                                                 |
@@ -174,39 +228,40 @@ The following helpers are exported from `'ai-i18n-tools/runtime'` and work in an
 
 ```bash
 ai-i18n-tools version
-ai-i18n-tools help [command]
-ai-i18n-tools init [-t ui-markdown|ui-docusaurus] [-o path] [--with-translate-ignore]
 ai-i18n-tools check-models
-ai-i18n-tools generate-ui-languages [--master path] [--dry-run]
+ai-i18n-tools init [-t ui-markdown|ui-docusaurus|ui-starlight|ui-astro-website|ui-json-bundles] [-o path] [--with-translate-ignore]
+ai-i18n-tools write-heading-ids …
 ai-i18n-tools extract
 ai-i18n-tools translate-docs …
-ai-i18n-tools write-heading-ids …
-ai-i18n-tools strip-md-bold-inline …
-ai-i18n-tools check-markdown [-p|--path <path>] [--json] [--no-cache]
+ai-i18n-tools translate-json …
 ai-i18n-tools translate-svg …
 ai-i18n-tools translate-ui …
+ai-i18n-tools sync-ui …
 ai-i18n-tools lint-source …
+ai-i18n-tools check-markdown [-p|--path <path>] [-f|--file <path>] [--json] [--no-cache]
 ai-i18n-tools export-ui-xliff …
 ai-i18n-tools sync …
-ai-i18n-tools status [--max-columns <n>]
-ai-i18n-tools statistics [--max-columns <n>]
-ai-i18n-tools dashboard
-ai-i18n-tools cleanup [--dry-run] [--no-backup] [--backup <path>]
-ai-i18n-tools clean-temp [-r|--root <path>] [-f|--force] [--dry-run]
+ai-i18n-tools status …
+ai-i18n-tools statistics …
+ai-i18n-tools cleanup …
+ai-i18n-tools clean-temp …
+ai-i18n-tools dashboard …
+ai-i18n-tools generate-ui-languages [--master path] [--dry-run]
 ai-i18n-tools glossary-generate
+ai-i18n-tools help [command]
 ```
 
 
 Complete per-command flag lists are in [Getting Started — CLI reference](docs/GETTING_STARTED.md#cli-reference). Run `ai-i18n-tools <command> --help` for built-in usage text.
 
-Global options on every command: `-c <config>` (default: `ai-i18n-tools.config.json`), `-v` (verbose), optional `-w` / `--write-logs [path]` to tee console output to a log file (default: under the translation cache directory), `-V` / `--version`, and `-h` / `--help`. See [Getting Started](docs/GETTING_STARTED.md#cli-reference) for the command overview table.
+Global options on every command: `-c <config>` (default: `ai-i18n-tools.config.json`), `-v` (verbose), optional `-w` / `--write-logs [path]` to tee console output to a log file (default: under the translation cache directory), `-V` / `--version`, and `-h` / `--help`. Several commands accept `-l` / `--locale <codes>` (comma-separated BCP-47) to limit target locales; `lint-source` uses a single source locale. See [Getting Started](docs/GETTING_STARTED.md#cli-reference) for the command overview table.
 
 ---
 
 <a id="documentation"></a>
 ## Documentation
 
-- [Getting Started](docs/GETTING_STARTED.md) - full setup guide for both workflows, CLI reference, and config field reference.
+- [Getting Started](docs/GETTING_STARTED.md) - full setup for all workflows (UI, docs/`.astro`, JSON bundles, Astro Starlight and plain Astro), CLI reference, and config field reference.
 - [Locale assets guide](docs/LOCALE-ASSETS-GUIDE.md) - screenshots and illustrated SVGs in translated docs (Patterns A–E, flat link rewriter, screenshot scripts).
 - [Package Overview](docs/PACKAGE_OVERVIEW.md) - architecture, internals, programmatic API, and extension points.
 - [AI Agent Context](docs/ai-i18n-tools-context.md) - **for apps using the package:** integration prompts for downstream projects (copy into your repo’s agent rules).

package/bin/ai-i18n-tools.mjs

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+/**
+ * Stable package.json "bin" entry. pnpm links this file during install before
+ * dist/ exists; the compiled CLI is emitted to dist/cli/index.js by `pnpm build`.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const cliEntry = path.join(root, "dist", "cli", "index.js");
+
+if (!fs.existsSync(cliEntry)) {
+  console.error(
+    "ai-i18n-tools is not built yet. From the repository root, run:\n  pnpm run build",
+  );
+  process.exit(1);
+}
+
+await import(cliEntry);

package/dist/build-info.generated.d.ts

@@ -1,3 +1,3 @@
 /** Auto-generated by scripts/write-build-info.mjs — do not edit */
-export declare const BUILD_TIMESTAMP_ISO = "2026-05-24T19:52:06.081Z";
+export declare const BUILD_TIMESTAMP_ISO = "2026-06-07T23:31:38.898Z";
 //# sourceMappingURL=build-info.generated.d.ts.map

package/dist/build-info.generated.js

@@ -1,3 +1,3 @@
 /** Auto-generated by scripts/write-build-info.mjs — do not edit */
-export const BUILD_TIMESTAMP_ISO = "2026-05-24T19:52:06.081Z";
+export const BUILD_TIMESTAMP_ISO = "2026-06-07T23:31:38.898Z";
 //# sourceMappingURL=build-info.generated.js.map

package/dist/cli/doc-translate-quality-retry.d.ts

@@ -0,0 +1,81 @@
+import type { DocumentPromptContentType } from "../core/prompt-builder.js";
+import type { Segment, TranslationFailureInsert } from "../core/types.js";
+import { PlaceholderHandler } from "../processors/placeholder-handler.js";
+import type { Glossary } from "../glossary/glossary.js";
+import type { OpenRouterClient } from "../api/openrouter.js";
+type ProtectState = {
+    glossaryForceReplacements?: string[];
+} & ReturnType<PlaceholderHandler["protectForTranslation"]>;
+export type DocQualityLogOutcome = "retrying_next_model" | "fatal" | "individual_success";
+export type DocQualityLogWriter = (opts: {
+    segmentsLabel: string;
+    outcome: DocQualityLogOutcome;
+    failedModel: string;
+    nextModel?: string;
+    qualityErrors: string[];
+    perSegmentLines: string[];
+    systemPrompt: string;
+    userContent: string;
+    rawAssistantContent: string;
+    mode: "failed" | "debug";
+}) => string | undefined;
+export type ProtectSegmentFn = (raw: string) => {
+    text: string;
+    state: ProtectState;
+};
+export type TranslateOneSegmentQualityRetryParams = {
+    client: OpenRouterClient;
+    locale: string;
+    glossary: Glossary;
+    contentType: DocumentPromptContentType;
+    models: readonly string[];
+    /** Original segment (pre-placeholder source text in `content`). */
+    original: Segment;
+    /** Protected text sent to the API for the top-level segment (unused when splitDepth > 0). */
+    protectedContent: string;
+    /** Placeholder state for the top-level segment (unused when splitDepth > 0). */
+    protectState: ProtectState | undefined;
+    /** Model index to start trying from (0-based). */
+    startModelIndex: number;
+    splitDepth: number;
+    qualityRetrySplit: boolean;
+    maxQualityRetrySplitDepth: number;
+    protectForTranslation: ProtectSegmentFn;
+    segmentHash: string;
+    failureFp: string | null;
+    recordFailures: (rows: TranslationFailureInsert[]) => Promise<void>;
+    buildQualityFailureRows: (model: string, modelOrder: number | null, errors: readonly string[], fatal: boolean) => TranslationFailureInsert[];
+    buildRuntimeFailureRow: (model: string | null, modelOrder: number | null, message: string, fatal: boolean) => TranslationFailureInsert;
+    modelOrder1Based: (model: string | null) => number | null;
+    segLabelSingle: string;
+    batchSegIndex?: number;
+    docIdx0?: number;
+    docLog?: {
+        relativePath: string;
+        totalSegments: number;
+    };
+    failureLogDirAbs?: string | null;
+    writeFailureLog?: DocQualityLogWriter;
+    writeDebugLog?: DocQualityLogWriter;
+    warnModelSwitch?: (failedModel: string, nextModel: string, detail: string, nextModelOrdinal: {
+        index1Based: number;
+        total: number;
+    }) => void;
+    abortSignal?: AbortSignal;
+};
+export type TranslateOneSegmentQualityRetryResult = {
+    text: string;
+    modelUsed: string;
+    inTok: number;
+    outTok: number;
+    cost: number;
+    validationFailures: number;
+    individualCalls: number;
+    qualitySplitRetries: number;
+};
+/**
+ * Translate one markdown segment with model cycling and progressive split-on-AST-failure fallback.
+ */
+export declare function translateOneSegmentWithQualityRetry(params: TranslateOneSegmentQualityRetryParams): Promise<TranslateOneSegmentQualityRetryResult>;
+export {};
+//# sourceMappingURL=doc-translate-quality-retry.d.ts.map

package/dist/cli/doc-translate-quality-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-translate-quality-retry.d.ts","sourceRoot":"","sources":["../../src/cli/doc-translate-quality-retry.ts"],"names":[],"mappings":"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"}

package/dist/cli/doc-translate-quality-retry.js

@@ -0,0 +1,223 @@
+import chalk from "chalk";
+import { splitSegmentForQualityRetry } from "../extractors/markdown-quality-split.js";
+import { PlaceholderHandler } from "../processors/placeholder-handler.js";
+import { restoreGlossaryForcedTerms } from "../processors/glossary-force-placeholders.js";
+import { errorsIncludeAstMismatch, validateDocTranslatePair } from "../processors/validator.js";
+import { throwIfAbortSignal } from "../utils/run-interrupt.js";
+function restoreSegmentTranslation(ph, raw, st) {
+    if (!st) {
+        return raw;
+    }
+    let out = ph.restoreAfterTranslation(raw, st);
+    out = restoreGlossaryForcedTerms(out, st.glossaryForceReplacements ?? []);
+    return out;
+}
+function isModelRetryFailure(result) {
+    return result.ok === false;
+}
+function perSegLine(params, ok, errors, partLabel) {
+    const hashLabel = partLabel ? `${params.segmentHash} part ${partLabel}` : params.segmentHash;
+    if (params.docLog && params.docIdx0 !== undefined && params.batchSegIndex !== undefined) {
+        return `doc #${params.docIdx0 + 1}/${params.docLog.totalSegments} seg id=${params.batchSegIndex} (hash ${hashLabel}): ${ok ? "OK" : errors.join("; ")}`;
+    }
+    if (params.batchSegIndex !== undefined) {
+        return `batch seg id=${params.batchSegIndex} (hash ${hashLabel}): ${ok ? "OK" : errors.join("; ")}`;
+    }
+    return `(hash ${hashLabel}): ${ok ? "OK" : errors.join("; ")}`;
+}
+async function translateProtectedContent(params, originalContent, protectedContent, protectState, startModelIndex, partLabel) {
+    const { client, locale, glossary, contentType, models, original, recordFailures, buildQualityFailureRows, buildRuntimeFailureRow, modelOrder1Based, segLabelSingle, failureLogDirAbs, docLog, writeFailureLog, writeDebugLog, warnModelSwitch, } = params;
+    const hints = glossary.findTermsInText(protectedContent, locale);
+    const ph = new PlaceholderHandler();
+    let startIdx = startModelIndex;
+    let remainingErrors = [];
+    let inTok = 0;
+    let outTok = 0;
+    let cost = 0;
+    let validationFailures = 0;
+    let individualCalls = 0;
+    while (startIdx < models.length) {
+        throwIfAbortSignal(params.abortSignal);
+        individualCalls++;
+        const startModel = models[startIdx] ?? null;
+        let single;
+        try {
+            single = await client.translateDocumentSegment(protectedContent, locale, hints, {
+                contentType,
+                startModelIndex: startIdx,
+                docLogContext: docLog?.relativePath
+                    ? { locale, relativePath: docLog.relativePath }
+                    : undefined,
+            });
+        }
+        catch (err) {
+            await recordFailures([
+                buildRuntimeFailureRow(startModel, modelOrder1Based(startModel), String(err), true),
+            ]);
+            throw err;
+        }
+        throwIfAbortSignal(params.abortSignal);
+        inTok += single.usage.inputTokens;
+        outTok += single.usage.outputTokens;
+        cost += single.cost ?? 0;
+        const restored = restoreSegmentTranslation(ph, single.content, protectState);
+        const origSeg = { ...original, content: originalContent };
+        const v = await validateDocTranslatePair(origSeg, restored);
+        const nextIdx = models.indexOf(single.model) + 1;
+        const line = perSegLine(params, v.ok, v.errors, partLabel);
+        if (failureLogDirAbs && docLog && writeDebugLog) {
+            const debugLogPath = writeDebugLog({
+                segmentsLabel: segLabelSingle || "(segment range unknown)",
+                outcome: v.ok
+                    ? "individual_success"
+                    : nextIdx >= models.length
+                        ? "fatal"
+                        : "retrying_next_model",
+                failedModel: single.model,
+                nextModel: nextIdx < models.length ? models[nextIdx] : undefined,
+                qualityErrors: v.errors,
+                perSegmentLines: [line],
+                systemPrompt: single.debugPrompt?.systemPrompt ?? "",
+                userContent: single.debugPrompt?.userContent ?? "",
+                rawAssistantContent: single.rawAssistantContent ?? "(missing raw response; rebuild ai-i18n-tools)",
+                mode: "debug",
+            });
+            if (debugLogPath) {
+                console.warn(chalk.gray(`  🧪 Debug log: ${debugLogPath}`));
+            }
+        }
+        if (v.ok) {
+            return {
+                ok: true,
+                text: restored,
+                modelUsed: single.model,
+                inTok,
+                outTok,
+                cost,
+                validationFailures,
+                individualCalls,
+                qualitySplitRetries: 0,
+            };
+        }
+        validationFailures++;
+        remainingErrors = v.errors;
+        await recordFailures(buildQualityFailureRows(single.model, modelOrder1Based(single.model), v.errors, nextIdx >= models.length));
+        if (failureLogDirAbs && docLog && writeFailureLog) {
+            const failureLogPath = writeFailureLog({
+                segmentsLabel: segLabelSingle || "(segment range unknown)",
+                outcome: nextIdx >= models.length ? "fatal" : "retrying_next_model",
+                failedModel: single.model,
+                nextModel: nextIdx < models.length ? models[nextIdx] : undefined,
+                qualityErrors: v.errors,
+                perSegmentLines: [line],
+                systemPrompt: single.debugPrompt?.systemPrompt ?? "",
+                userContent: single.debugPrompt?.userContent ?? "",
+                rawAssistantContent: single.rawAssistantContent ?? "(missing raw response; rebuild ai-i18n-tools)",
+                mode: "failed",
+            });
+            if (failureLogPath) {
+                console.warn(chalk.gray(`  📝 Failure log: ${failureLogPath}`));
+            }
+        }
+        if (nextIdx >= models.length) {
+            break;
+        }
+        warnModelSwitch?.(single.model, models[nextIdx], v.errors.join("; "), {
+            index1Based: nextIdx + 1,
+            total: models.length,
+        });
+        startIdx = nextIdx;
+    }
+    return {
+        ok: false,
+        remainingErrors,
+        inTok,
+        outTok,
+        cost,
+        validationFailures,
+        individualCalls,
+    };
+}
+function throwQualityFatal(params, errors) {
+    const loc = params.docLog?.relativePath ?? "?";
+    throw new Error(`Doc translation quality failed (${params.locale}, ${loc}): ${params.segLabelSingle ? `${params.segLabelSingle}: ` : ""}${errors.join("; ")}`);
+}
+/**
+ * Translate one markdown segment with model cycling and progressive split-on-AST-failure fallback.
+ */
+export async function translateOneSegmentWithQualityRetry(params) {
+    const { original, protectedContent, protectState, startModelIndex, splitDepth, qualityRetrySplit, maxQualityRetrySplitDepth, protectForTranslation, docLog, segLabelSingle, locale, } = params;
+    const direct = await translateProtectedContent(params, original.content, protectedContent, protectState, startModelIndex);
+    if (!isModelRetryFailure(direct)) {
+        const { ok: _ok, ...result } = direct;
+        return result;
+    }
+    const { remainingErrors } = direct;
+    const splittable = qualityRetrySplit &&
+        errorsIncludeAstMismatch(remainingErrors) &&
+        splitSegmentForQualityRetry(original.content, original.type, splitDepth, maxQualityRetrySplitDepth) !== null;
+    if (!splittable) {
+        throwQualityFatal(params, remainingErrors);
+    }
+    const parts = splitSegmentForQualityRetry(original.content, original.type, splitDepth, maxQualityRetrySplitDepth);
+    if (!parts || parts.length <= 1) {
+        throwQualityFatal(params, remainingErrors);
+    }
+    const baseLoc = docLog?.relativePath ? `${locale} ${docLog.relativePath}` : locale;
+    console.warn(chalk.magenta(`  ✂️  ${baseLoc}: splitting segment into ${parts.length} part(s) after model exhaustion (depth ${splitDepth + 1}/${maxQualityRetrySplitDepth}) — ${segLabelSingle || `hash ${params.segmentHash}`}`));
+    const translatedParts = [];
+    const modelsUsed = new Set();
+    let inTok = direct.inTok;
+    let outTok = direct.outTok;
+    let cost = direct.cost;
+    let validationFailures = direct.validationFailures;
+    let individualCalls = direct.individualCalls;
+    let qualitySplitRetries = 1;
+    for (let pi = 0; pi < parts.length; pi++) {
+        throwIfAbortSignal(params.abortSignal);
+        const partContent = parts[pi];
+        const { text: partProtected, state: partState } = protectForTranslation(partContent);
+        const partOriginal = {
+            ...original,
+            content: partContent,
+        };
+        const partResult = await translateOneSegmentWithQualityRetry({
+            ...params,
+            original: partOriginal,
+            protectedContent: partProtected,
+            protectState: partState,
+            startModelIndex: 0,
+            splitDepth: splitDepth + 1,
+        });
+        inTok += partResult.inTok;
+        outTok += partResult.outTok;
+        cost += partResult.cost;
+        validationFailures += partResult.validationFailures;
+        individualCalls += partResult.individualCalls;
+        qualitySplitRetries += partResult.qualitySplitRetries;
+        for (const m of partResult.modelUsed.split(",")) {
+            const t = m.trim();
+            if (t) {
+                modelsUsed.add(t);
+            }
+        }
+        translatedParts.push(partResult.text);
+    }
+    const joined = translatedParts.join("\n");
+    const joinedValidation = await validateDocTranslatePair(original, joined);
+    if (!joinedValidation.ok) {
+        throwQualityFatal(params, [`joined sub-parts: ${joinedValidation.errors.join("; ")}`]);
+    }
+    const modelUsed = [...modelsUsed].sort((a, b) => a.localeCompare(b)).join(",");
+    return {
+        text: joined,
+        modelUsed,
+        inTok,
+        outTok,
+        cost,
+        validationFailures,
+        individualCalls,
+        qualitySplitRetries,
+    };
+}
+//# sourceMappingURL=doc-translate-quality-retry.js.map

package/dist/cli/doc-translate-quality-retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-translate-quality-retry.js","sourceRoot":"","sources":["../../src/cli/doc-translate-quality-retry.ts"],"names":[],"mappings":"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"}