@the-i18n-kit/cli 5.0.0 → 7.0.0

package/dist/providers-BbVPelvp.js

@@ -0,0 +1,406 @@
+import { r as ToolError } from "./errors-coI1dhw1.js";
+//#region src/core/shared.ts
+/**
+* Look up a locale directory by layer name and throw LAYER_NOT_FOUND with fuzzy
+* matching hints if the name is not found.
+*/
+function findLayerOrThrow(config, layer) {
+	const localeDir = config.localeDirs.find((d) => d.layer === layer);
+	if (!localeDir) throw new ToolError(`Layer not found: "${layer}". Available: ${config.localeDirs.map((d) => d.layer).join(", ")}.${config.projectConfig?.layerRules?.find((r) => r.layer === layer) ? ` Note: "${layer}" matches a layerRules entry in .i18n-mcp.json but is not an internal layer name.` : ""} Use discover to see all layers.`, "LAYER_NOT_FOUND");
+	return localeDir;
+}
+/**
+* Look up a layer that will be written to: same as findLayerOrThrow, but also
+* rejects alias layers (writes must target the source layer).
+*/
+function findWritableLayerOrThrow(config, layer) {
+	const localeDir = findLayerOrThrow(config, layer);
+	if (localeDir.aliasOf) throw new ToolError(`Layer "${layer}" is an alias of "${localeDir.aliasOf}". Modify the source layer "${localeDir.aliasOf}" instead.`, "LAYER_IS_ALIAS");
+	return localeDir;
+}
+/**
+* Resolve the reference locale (requested or project default) and throw
+* REFERENCE_LOCALE_NOT_FOUND when it does not exist.
+*/
+function findReferenceLocaleOrThrow(config, requested) {
+	const refCode = requested ?? config.defaultLocale;
+	const refLocale = findLocaleImpl(config, refCode);
+	if (!refLocale) throw new ToolError(`Reference locale not found: "${refCode}". Available: ${config.locales.map((l) => l.code).join(", ")}. Pass a valid locale code as referenceLocale, or omit it to use the project default.`, "REFERENCE_LOCALE_NOT_FOUND");
+	return refLocale;
+}
+/**
+* The locale directories an operation should scan: one named layer, or every
+* non-alias layer. Alias layers are skipped because they point at another
+* layer's files, so scanning both would count the same keys twice.
+*
+* Throws rather than returning empty: an operation with nothing to scan has no
+* meaningful result, and a mistyped layer name should say so.
+*/
+function resolveLayersToScan(config, layer) {
+	const layers = layer ? config.localeDirs.filter((d) => d.layer === layer) : config.localeDirs.filter((d) => !d.aliasOf);
+	if (layers.length === 0) {
+		if (layer) findLayerOrThrow(config, layer);
+		throw new ToolError("No locale directories found. Run discover to verify the project setup.", "LAYER_NOT_FOUND");
+	}
+	return layers;
+}
+function localeRefInfo(locale) {
+	return {
+		code: locale.code,
+		...locale.language ? { language: locale.language } : {},
+		...locale.file ? { file: locale.file } : {},
+		...locale.name ? { name: locale.name } : {}
+	};
+}
+function localeAcceptedRefs(locale) {
+	return [...new Set([
+		locale.code,
+		locale.language,
+		locale.file
+	].filter(Boolean))];
+}
+function formatLocaleChoices(locales) {
+	return locales.map((locale) => `- code: ${locale.code}${locale.language ? `, language: ${locale.language}` : ""}${locale.file ? `, file: ${locale.file}` : ""}${locale.name ? `, name: ${locale.name}` : ""}`).join("\n");
+}
+const stripJson = (ref) => ref.endsWith(".json") ? ref.slice(0, -5) : ref;
+/**
+* How well one of a locale's refs matches the requested one. Higher wins.
+* Ranking matters rather than first-match: for "de-DE-formal", the informal
+* `de` locale matches by containment (its language is `de-DE`) while the
+* formal one matches exactly once `.json` is stripped from its file name.
+* First-match order returned `de`, pointing the caller at the wrong locale —
+* following that hint would write formal German into the informal file (#301).
+*/
+function suggestionScore(locale, normalized) {
+	let best = 0;
+	for (const ref of localeAcceptedRefs(locale)) {
+		const candidate = stripJson(ref);
+		if (candidate === normalized) return 3;
+		if (candidate.toLowerCase() === normalized.toLowerCase()) best = Math.max(best, 2);
+		else if (candidate.includes(normalized) || normalized.includes(candidate)) best = Math.max(best, 1);
+	}
+	return best;
+}
+function findLocaleSuggestion(config, localeRef) {
+	const normalized = stripJson(localeRef);
+	let suggestion;
+	let bestScore = 0;
+	for (const locale of config.locales) {
+		const score = suggestionScore(locale, normalized);
+		if (score > bestScore) {
+			bestScore = score;
+			suggestion = locale;
+		}
+	}
+	if (!suggestion) return "";
+	return ` Did you mean ${localeAcceptedRefs(suggestion).map((ref) => `"${ref}"`).join(" or ")}?`;
+}
+/** Fields a locale ref may match, in resolution precedence order. */
+const LOCALE_MATCH_FIELDS = [
+	"code",
+	"language",
+	"file"
+];
+/**
+* Resolve a locale ref with deliberate precedence: an exact `code` outranks a
+* `language` tag, which outranks a `file` name.
+*
+* Codes are unique by construction; language tags are not — two locales can
+* both declare `de-DE` (an informal and a formal German, say). Without
+* precedence, a locale's unique code could be shadowed by a different locale's
+* language tag purely through config ordering. Within one field a ref that
+* still matches several locales is reported as ambiguous rather than silently
+* resolved to whichever came first, because that choice depends on array order
+* and can change under the caller without warning (#301).
+*/
+function resolveLocaleRef(config, localeRef) {
+	for (const field of LOCALE_MATCH_FIELDS) {
+		const matches = config.locales.filter((locale) => locale[field] === localeRef);
+		const [first] = matches;
+		if (!first) continue;
+		if (matches.length === 1) return { locale: first };
+		return {
+			locale: first,
+			ambiguity: {
+				ref: localeRef,
+				matchedBy: field,
+				candidates: matches.map((m) => m.code),
+				resolvedTo: first.code
+			}
+		};
+	}
+	return {};
+}
+function findLocaleImpl(config, localeRef) {
+	return resolveLocaleRef(config, localeRef).locale;
+}
+/**
+* Resolve the reference locale for scan operations: the requested ref or the
+* project default. Throws LOCALE_NOT_FOUND listing the available codes.
+*/
+function resolveReferenceLocale(config, requested) {
+	const localeCode = requested ?? config.defaultLocale;
+	const localeDef = findLocaleImpl(config, localeCode);
+	if (!localeDef) throw new ToolError(`Locale not found: "${localeCode}". Available: ${config.locales.map((l) => l.code).join(", ")}`, "LOCALE_NOT_FOUND");
+	return {
+		localeCode,
+		localeDef
+	};
+}
+function findLocaleOrThrow(config, localeRef) {
+	const locale = findLocaleImpl(config, localeRef);
+	if (!locale) throw new ToolError(`Locale not found: "${localeRef}".${findLocaleSuggestion(config, localeRef)}\nAvailable locales:\n${formatLocaleChoices(config.locales)}`, "LOCALE_NOT_FOUND");
+	return locale;
+}
+//#endregion
+//#region src/llm/providers.ts
+/**
+* A classified provider failure. `auth` errors are not retryable (the caller
+* should abort the run), `rate-limit` errors should be retried with backoff,
+* and `provider` covers everything else (server errors, network, …).
+* `config` marks an unusable provider setup and is raised while building the
+* TranslateFn, before any request exists — so it surfaces from the command
+* and never reaches the retry loop.
+*/
+var TranslateProviderError = class extends Error {
+	kind;
+	status;
+	constructor(message, kind, status) {
+		super(message);
+		this.name = "TranslateProviderError";
+		this.kind = kind;
+		this.status = status;
+	}
+};
+/** Defensively extract an HTTP status code from an unknown error shape. */
+function extractStatus(error) {
+	if (error === null || typeof error !== "object") return void 0;
+	const e = error;
+	if (typeof e.status === "number") return e.status;
+	if (e.response !== null && typeof e.response === "object") {
+		const status = e.response.status;
+		if (typeof status === "number") return status;
+	}
+}
+/**
+* Classify a provider error into a TranslateProviderError:
+* 401/403 → auth, 429 → rate-limit, anything else → provider.
+* Already-classified errors pass through unchanged.
+*/
+function classifyProviderError(error) {
+	if (error instanceof TranslateProviderError) return error;
+	const status = extractStatus(error);
+	return new TranslateProviderError(error instanceof Error ? error.message : String(error), status === 401 || status === 403 ? "auth" : status === 429 ? "rate-limit" : "provider", status);
+}
+/** Environment variable carrying the provider base URL override. */
+const BASE_URL_ENV = "I18N_BASE_URL";
+/**
+* Resolve the provider base URL from its three sources, highest precedence
+* first: an explicit flag, the I18N_BASE_URL env var, then the project
+* config's `providerBaseUrl`.
+*
+* Blank values count as unset. Shells produce them routinely — `--baseUrl
+* "$UNSET"` or an exported-but-empty variable — and a blank must not shadow a
+* real endpoint configured further down the chain. A blank in the config file
+* is a different case: it cannot arise by accident, so the strict schema
+* rejects it at load time rather than letting it reach this function.
+*/
+function resolveProviderBaseUrl(sources) {
+	for (const value of [
+		sources.flag,
+		sources.env,
+		sources.config
+	]) if (typeof value === "string" && value.trim().length > 0) return value.trim();
+}
+const ENV_KEY_MAP = {
+	openai: "OPENAI_API_KEY",
+	anthropic: "ANTHROPIC_API_KEY",
+	google: "GEMINI_API_KEY"
+};
+function resolveApiKey(provider, configKey) {
+	if (configKey) return configKey;
+	const envKey = ENV_KEY_MAP[provider];
+	const key = process.env[envKey];
+	if (!key) throw new TranslateProviderError(`No API key found for provider "${provider}". Set ${envKey} environment variable or pass apiKey in config.`, "config");
+	return key;
+}
+/** Default endpoints, each overridable through the base URL sources. */
+const DEFAULT_BASE_URL = {
+	openai: "https://api.openai.com/v1",
+	anthropic: "https://api.anthropic.com",
+	google: "https://generativelanguage.googleapis.com"
+};
+/**
+* Per-request timeout, keeping the ten-minute default the provider SDKs
+* applied before this transport existed. It is deliberately generous: every
+* request asks for the same large token budget, and a slow endpoint — a
+* self-hosted model behind a base URL above all — can take minutes to produce
+* it. The ceiling only exists to stop a hung socket from stalling a run.
+*/
+const REQUEST_TIMEOUT_MS = 600 * 1e3;
+/** Join a base URL with a path, tolerating a trailing slash on the base. */
+function joinUrl(baseUrl, path) {
+	return `${baseUrl.replace(/\/+$/, "")}${path}`;
+}
+/** Cap an untrusted provider body so it stays readable inside an error. */
+function summarize(raw) {
+	const text = raw.trim();
+	return text.length > 300 ? `${text.slice(0, 300)}…` : text;
+}
+/**
+* Pull the human-readable message out of a provider error body. All three
+* providers nest it under `error.message`; anything else — an HTML error page
+* from a proxy, say — is reported verbatim but capped.
+*/
+function errorDetail(raw) {
+	try {
+		const body = JSON.parse(raw);
+		if (body !== null && typeof body === "object") {
+			const { error, message } = body;
+			const nested = error !== null && typeof error === "object" ? error.message : error;
+			if (typeof nested === "string" && nested.trim() !== "") return nested;
+			if (typeof message === "string" && message.trim() !== "") return message;
+		}
+	} catch {}
+	return summarize(raw);
+}
+/**
+* POST a JSON body and return the parsed response, mapping every failure onto
+* a classified TranslateProviderError: an HTTP status keeps its meaning
+* (401/403 auth, 429 rate limit), while network, timeout and malformed-body
+* failures land on `provider` and are retried by the caller.
+*/
+async function postJson(request) {
+	let response;
+	let raw;
+	try {
+		response = await fetch(request.url, {
+			method: "POST",
+			headers: {
+				"content-type": "application/json",
+				...request.headers
+			},
+			body: JSON.stringify(request.body),
+			signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
+		});
+		raw = await response.text();
+	} catch (error) {
+		if (error instanceof Error && (error.name === "TimeoutError" || error.name === "AbortError")) throw new TranslateProviderError(`Provider "${request.provider}" did not respond within ${REQUEST_TIMEOUT_MS / 1e3}s.`, "provider");
+		throw classifyProviderError(error);
+	}
+	if (!response.ok) {
+		const failure = /* @__PURE__ */ new Error(`Provider "${request.provider}" request failed (HTTP ${response.status}): ${errorDetail(raw)}`);
+		failure.status = response.status;
+		throw classifyProviderError(failure);
+	}
+	try {
+		return JSON.parse(raw);
+	} catch {
+		throw new TranslateProviderError(`Provider "${request.provider}" returned a non-JSON response: ${summarize(raw)}`, "provider", response.status);
+	}
+}
+/** Assemble a TranslateResponse, omitting `truncated` unless it is true. */
+function toTranslateResponse(text, model, fallbackModel, truncated) {
+	return {
+		text,
+		model: model || fallbackModel,
+		...truncated ? { truncated: true } : {}
+	};
+}
+function createOpenAiTranslateFn(config) {
+	const apiKey = resolveApiKey("openai", config.apiKey);
+	const url = joinUrl(config.baseUrl ?? DEFAULT_BASE_URL.openai, "/chat/completions");
+	return async (opts) => {
+		const response = await postJson({
+			provider: "openai",
+			url,
+			headers: { authorization: `Bearer ${apiKey}` },
+			body: {
+				model: config.model,
+				messages: [{
+					role: "system",
+					content: opts.systemPrompt
+				}, {
+					role: "user",
+					content: opts.userMessage
+				}],
+				max_tokens: opts.maxTokens,
+				temperature: 0,
+				response_format: { type: "json_object" }
+			}
+		});
+		const choice = response.choices?.[0];
+		return toTranslateResponse(choice?.message?.content ?? "", response.model, config.model, choice?.finish_reason === "length");
+	};
+}
+function createAnthropicTranslateFn(config) {
+	const apiKey = resolveApiKey("anthropic", config.apiKey);
+	const url = joinUrl(config.baseUrl ?? DEFAULT_BASE_URL.anthropic, "/v1/messages");
+	return async (opts) => {
+		const response = await postJson({
+			provider: "anthropic",
+			url,
+			headers: {
+				"x-api-key": apiKey,
+				"anthropic-version": "2023-06-01"
+			},
+			body: {
+				model: config.model,
+				system: opts.systemPrompt,
+				messages: [{
+					role: "user",
+					content: opts.userMessage
+				}],
+				max_tokens: opts.maxTokens,
+				temperature: 0
+			}
+		});
+		return toTranslateResponse((response.content ?? []).filter((block) => block?.type === "text").map((block) => block.text ?? "").join(""), response.model, config.model, response.stop_reason === "max_tokens");
+	};
+}
+function createGoogleTranslateFn(config) {
+	const apiKey = resolveApiKey("google", config.apiKey);
+	const model = config.model.replace(/^models\//, "");
+	const url = joinUrl(config.baseUrl ?? DEFAULT_BASE_URL.google, `/v1beta/models/${model}:generateContent`);
+	return async (opts) => {
+		const response = await postJson({
+			provider: "google",
+			url,
+			headers: { "x-goog-api-key": apiKey },
+			body: {
+				contents: [{
+					role: "user",
+					parts: [{ text: opts.userMessage }]
+				}],
+				systemInstruction: { parts: [{ text: opts.systemPrompt }] },
+				generationConfig: {
+					maxOutputTokens: opts.maxTokens,
+					temperature: 0,
+					responseMimeType: "application/json"
+				}
+			}
+		});
+		const candidate = response.candidates?.[0];
+		return toTranslateResponse((candidate?.content?.parts ?? []).map((part) => part.text ?? "").join(""), response.modelVersion, config.model, candidate?.finishReason === "MAX_TOKENS");
+	};
+}
+/**
+* Create a TranslateFn from an LLM provider config. Every provider is called
+* over plain HTTP, so nothing beyond the CLI has to be installed.
+* Throws if the API key is missing.
+*/
+async function createTranslateFn(config) {
+	switch (config.provider) {
+		case "openai": return createOpenAiTranslateFn(config);
+		case "anthropic": return createAnthropicTranslateFn(config);
+		case "google": return createGoogleTranslateFn(config);
+		default: {
+			const _exhaustive = config.provider;
+			throw new Error(`Unknown provider: ${_exhaustive}`);
+		}
+	}
+}
+//#endregion
+export { resolveProviderBaseUrl as a, findLocaleOrThrow as c, findWritableLayerOrThrow as d, localeRefInfo as f, resolveReferenceLocale as h, createTranslateFn as i, findLocaleSuggestion as l, resolveLocaleRef as m, TranslateProviderError as n, findLayerOrThrow as o, resolveLayersToScan as p, classifyProviderError as r, findLocaleImpl as s, BASE_URL_ENV as t, findReferenceLocaleOrThrow as u };
+
+//# sourceMappingURL=providers-BbVPelvp.js.map

package/dist/providers-BbVPelvp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers-BbVPelvp.js","names":[],"sources":["../src/core/shared.ts","../src/llm/providers.ts"],"sourcesContent":["/**\n * Shared locale/layer lookup helpers used across the core operation modules.\n */\n\nimport type { I18nConfig, LocaleDefinition, LocaleDir } from '../config/types.js'\nimport { ToolError } from '../utils/errors.js'\n\nimport type { LocaleRefInfo } from './types.js'\n\n/**\n * Look up a locale directory by layer name and throw LAYER_NOT_FOUND with fuzzy\n * matching hints if the name is not found.\n */\nexport function findLayerOrThrow(config: I18nConfig, layer: string): LocaleDir {\n  const localeDir = config.localeDirs.find(d => d.layer === layer)\n  if (!localeDir) {\n    const available = config.localeDirs.map(d => d.layer).join(', ')\n    const layerRule = config.projectConfig?.layerRules?.find(r => r.layer === layer)\n    const fuzzyHint = layerRule\n      ? ` Note: \"${layer}\" matches a layerRules entry in .i18n-mcp.json but is not an internal layer name.`\n      : ''\n    throw new ToolError(\n      `Layer not found: \"${layer}\". Available: ${available}.${fuzzyHint} Use discover to see all layers.`,\n      'LAYER_NOT_FOUND',\n    )\n  }\n  return localeDir\n}\n\n/**\n * Look up a layer that will be written to: same as findLayerOrThrow, but also\n * rejects alias layers (writes must target the source layer).\n */\nexport function findWritableLayerOrThrow(config: I18nConfig, layer: string): LocaleDir {\n  const localeDir = findLayerOrThrow(config, layer)\n  if (localeDir.aliasOf) {\n    throw new ToolError(`Layer \"${layer}\" is an alias of \"${localeDir.aliasOf}\". Modify the source layer \"${localeDir.aliasOf}\" instead.`, 'LAYER_IS_ALIAS')\n  }\n  return localeDir\n}\n\n/**\n * Resolve the reference locale (requested or project default) and throw\n * REFERENCE_LOCALE_NOT_FOUND when it does not exist.\n */\nexport function findReferenceLocaleOrThrow(config: I18nConfig, requested?: string): LocaleDefinition {\n  const refCode = requested ?? config.defaultLocale\n  const refLocale = findLocaleImpl(config, refCode)\n  if (!refLocale) {\n    throw new ToolError(`Reference locale not found: \"${refCode}\". Available: ${config.locales.map(l => l.code).join(', ')}. Pass a valid locale code as referenceLocale, or omit it to use the project default.`, 'REFERENCE_LOCALE_NOT_FOUND')\n  }\n  return refLocale\n}\n\n/**\n * The locale directories an operation should scan: one named layer, or every\n * non-alias layer. Alias layers are skipped because they point at another\n * layer's files, so scanning both would count the same keys twice.\n *\n * Throws rather than returning empty: an operation with nothing to scan has no\n * meaningful result, and a mistyped layer name should say so.\n */\nexport function resolveLayersToScan(config: I18nConfig, layer?: string): LocaleDir[] {\n  const layers = layer\n    ? config.localeDirs.filter(d => d.layer === layer)\n    : config.localeDirs.filter(d => !d.aliasOf)\n\n  if (layers.length === 0) {\n    // Surfaces the better \"layer not found, here are the valid ones\" error.\n    if (layer) findLayerOrThrow(config, layer)\n    throw new ToolError(\n      'No locale directories found. Run discover to verify the project setup.',\n      'LAYER_NOT_FOUND',\n    )\n  }\n  return layers\n}\n\nexport function localeRefInfo(locale: LocaleDefinition): LocaleRefInfo {\n  return {\n    code: locale.code,\n    ...(locale.language ? { language: locale.language } : {}),\n    ...(locale.file ? { file: locale.file } : {}),\n    ...(locale.name ? { name: locale.name } : {}),\n  }\n}\n\nfunction localeAcceptedRefs(locale: LocaleDefinition): string[] {\n  // Deduped: code and language are frequently the same string (a generic\n  // adapter derives both from the filename), and \"de\" or \"de\" or \"de.json\"\n  // reads like a bug in the suggestion rather than one locale's three refs.\n  return [...new Set([locale.code, locale.language, locale.file].filter(Boolean) as string[])]\n}\n\nfunction formatLocaleChoices(locales: LocaleDefinition[]): string {\n  return locales\n    .map(locale => `- code: ${locale.code}${locale.language ? `, language: ${locale.language}` : ''}${locale.file ? `, file: ${locale.file}` : ''}${locale.name ? `, name: ${locale.name}` : ''}`)\n    .join('\\n')\n}\n\nconst stripJson = (ref: string) => (ref.endsWith('.json') ? ref.slice(0, -5) : ref)\n\n/**\n * How well one of a locale's refs matches the requested one. Higher wins.\n * Ranking matters rather than first-match: for \"de-DE-formal\", the informal\n * `de` locale matches by containment (its language is `de-DE`) while the\n * formal one matches exactly once `.json` is stripped from its file name.\n * First-match order returned `de`, pointing the caller at the wrong locale —\n * following that hint would write formal German into the informal file (#301).\n */\nfunction suggestionScore(locale: LocaleDefinition, normalized: string): number {\n  let best = 0\n  for (const ref of localeAcceptedRefs(locale)) {\n    const candidate = stripJson(ref)\n    if (candidate === normalized) return 3\n    if (candidate.toLowerCase() === normalized.toLowerCase()) best = Math.max(best, 2)\n    else if (candidate.includes(normalized) || normalized.includes(candidate)) best = Math.max(best, 1)\n  }\n  return best\n}\n\nexport function findLocaleSuggestion(config: I18nConfig, localeRef: string): string {\n  const normalized = stripJson(localeRef)\n\n  let suggestion: LocaleDefinition | undefined\n  let bestScore = 0\n  for (const locale of config.locales) {\n    const score = suggestionScore(locale, normalized)\n    if (score > bestScore) {\n      bestScore = score\n      suggestion = locale\n    }\n  }\n  if (!suggestion) return ''\n\n  const refs = localeAcceptedRefs(suggestion).map(ref => `\"${ref}\"`).join(' or ')\n  return ` Did you mean ${refs}?`\n}\n\n/** Fields a locale ref may match, in resolution precedence order. */\nconst LOCALE_MATCH_FIELDS = ['code', 'language', 'file'] as const\nexport type LocaleMatchField = (typeof LOCALE_MATCH_FIELDS)[number]\n\nexport interface LocaleRefAmbiguity {\n  ref: string\n  /** The field that matched more than one locale. */\n  matchedBy: LocaleMatchField\n  /** Codes of every locale the ref matched, in config order. */\n  candidates: string[]\n  /** The one that was used — the first candidate. */\n  resolvedTo: string\n}\n\nexport interface LocaleRefResolution {\n  locale?: LocaleDefinition\n  ambiguity?: LocaleRefAmbiguity\n}\n\n/**\n * Resolve a locale ref with deliberate precedence: an exact `code` outranks a\n * `language` tag, which outranks a `file` name.\n *\n * Codes are unique by construction; language tags are not — two locales can\n * both declare `de-DE` (an informal and a formal German, say). Without\n * precedence, a locale's unique code could be shadowed by a different locale's\n * language tag purely through config ordering. Within one field a ref that\n * still matches several locales is reported as ambiguous rather than silently\n * resolved to whichever came first, because that choice depends on array order\n * and can change under the caller without warning (#301).\n */\nexport function resolveLocaleRef(config: I18nConfig, localeRef: string): LocaleRefResolution {\n  for (const field of LOCALE_MATCH_FIELDS) {\n    const matches = config.locales.filter(locale => locale[field] === localeRef)\n    const [first] = matches\n    if (!first) continue\n    if (matches.length === 1) return { locale: first }\n    return {\n      locale: first,\n      ambiguity: {\n        ref: localeRef,\n        matchedBy: field,\n        candidates: matches.map(m => m.code),\n        resolvedTo: first.code,\n      },\n    }\n  }\n  return {}\n}\n\nexport function findLocaleImpl(config: I18nConfig, localeRef: string) {\n  return resolveLocaleRef(config, localeRef).locale\n}\n\n/**\n * Resolve the reference locale for scan operations: the requested ref or the\n * project default. Throws LOCALE_NOT_FOUND listing the available codes.\n */\nexport function resolveReferenceLocale(\n  config: I18nConfig,\n  requested?: string,\n): { localeCode: string; localeDef: LocaleDefinition } {\n  const localeCode = requested ?? config.defaultLocale\n  const localeDef = findLocaleImpl(config, localeCode)\n  if (!localeDef) {\n    throw new ToolError(\n      `Locale not found: \"${localeCode}\". Available: ${config.locales.map(l => l.code).join(', ')}`,\n      'LOCALE_NOT_FOUND',\n    )\n  }\n  return { localeCode, localeDef }\n}\n\nexport function findLocaleOrThrow(config: I18nConfig, localeRef: string): LocaleDefinition {\n  const locale = findLocaleImpl(config, localeRef)\n  if (!locale) {\n    throw new ToolError(\n      `Locale not found: \"${localeRef}\".${findLocaleSuggestion(config, localeRef)}\\nAvailable locales:\\n${formatLocaleChoices(config.locales)}`,\n      'LOCALE_NOT_FOUND',\n    )\n  }\n  return locale\n}\n","import type { TranslateFn, TranslateRequest, TranslateResponse } from '../core/types.js'\n\nexport type LlmProvider = 'openai' | 'anthropic' | 'google'\n\n// ─── Error classification ───────────────────────────────────────\n\n/** How a provider failure should be handled by the caller. */\nexport type TranslateProviderErrorKind = 'auth' | 'rate-limit' | 'provider' | 'config'\n\n/**\n * A classified provider failure. `auth` errors are not retryable (the caller\n * should abort the run), `rate-limit` errors should be retried with backoff,\n * and `provider` covers everything else (server errors, network, …).\n * `config` marks an unusable provider setup and is raised while building the\n * TranslateFn, before any request exists — so it surfaces from the command\n * and never reaches the retry loop.\n */\nexport class TranslateProviderError extends Error {\n  public readonly kind: TranslateProviderErrorKind\n  public readonly status?: number\n\n  constructor(message: string, kind: TranslateProviderErrorKind, status?: number) {\n    super(message)\n    this.name = 'TranslateProviderError'\n    this.kind = kind\n    this.status = status\n  }\n}\n\n/** Defensively extract an HTTP status code from an unknown error shape. */\nfunction extractStatus(error: unknown): number | undefined {\n  if (error === null || typeof error !== 'object') return undefined\n  const e = error as { status?: unknown, response?: unknown }\n  if (typeof e.status === 'number') return e.status\n  if (e.response !== null && typeof e.response === 'object') {\n    const status = (e.response as { status?: unknown }).status\n    if (typeof status === 'number') return status\n  }\n  return undefined\n}\n\n/**\n * Classify a provider error into a TranslateProviderError:\n * 401/403 → auth, 429 → rate-limit, anything else → provider.\n * Already-classified errors pass through unchanged.\n */\nexport function classifyProviderError(error: unknown): TranslateProviderError {\n  if (error instanceof TranslateProviderError) return error\n  const status = extractStatus(error)\n  const message = error instanceof Error ? error.message : String(error)\n  const kind: TranslateProviderErrorKind\n    = status === 401 || status === 403 ? 'auth'\n      : status === 429 ? 'rate-limit'\n        : 'provider'\n  return new TranslateProviderError(message, kind, status)\n}\n\nexport interface LlmProviderConfig {\n  provider: LlmProvider\n  model: string\n  /** Override API key. Falls back to env vars */\n  apiKey?: string\n  /** Base URL override for proxies / compatible APIs */\n  baseUrl?: string\n}\n\n/** Environment variable carrying the provider base URL override. */\nexport const BASE_URL_ENV = 'I18N_BASE_URL'\n\n/**\n * Resolve the provider base URL from its three sources, highest precedence\n * first: an explicit flag, the I18N_BASE_URL env var, then the project\n * config's `providerBaseUrl`.\n *\n * Blank values count as unset. Shells produce them routinely — `--baseUrl\n * \"$UNSET\"` or an exported-but-empty variable — and a blank must not shadow a\n * real endpoint configured further down the chain. A blank in the config file\n * is a different case: it cannot arise by accident, so the strict schema\n * rejects it at load time rather than letting it reach this function.\n */\nexport function resolveProviderBaseUrl(sources: {\n  flag?: string\n  env?: string\n  config?: string\n}): string | undefined {\n  for (const value of [sources.flag, sources.env, sources.config]) {\n    if (typeof value === 'string' && value.trim().length > 0) return value.trim()\n  }\n  return undefined\n}\n\nconst ENV_KEY_MAP: Record<LlmProvider, string> = {\n  openai: 'OPENAI_API_KEY',\n  anthropic: 'ANTHROPIC_API_KEY',\n  google: 'GEMINI_API_KEY',\n}\n\nfunction resolveApiKey(provider: LlmProvider, configKey?: string): string {\n  if (configKey) return configKey\n  const envKey = ENV_KEY_MAP[provider]\n  const key = process.env[envKey]\n  if (!key) {\n    throw new TranslateProviderError(\n      `No API key found for provider \"${provider}\". Set ${envKey} environment variable or pass apiKey in config.`,\n      'config',\n    )\n  }\n  return key\n}\n\n// ─── HTTP transport ─────────────────────────────────────────────\n\n/** Default endpoints, each overridable through the base URL sources. */\nconst DEFAULT_BASE_URL: Record<LlmProvider, string> = {\n  openai: 'https://api.openai.com/v1',\n  anthropic: 'https://api.anthropic.com',\n  google: 'https://generativelanguage.googleapis.com',\n}\n\n/**\n * Per-request timeout, keeping the ten-minute default the provider SDKs\n * applied before this transport existed. It is deliberately generous: every\n * request asks for the same large token budget, and a slow endpoint — a\n * self-hosted model behind a base URL above all — can take minutes to produce\n * it. The ceiling only exists to stop a hung socket from stalling a run.\n */\nconst REQUEST_TIMEOUT_MS = 10 * 60 * 1000\n\n/** Join a base URL with a path, tolerating a trailing slash on the base. */\nfunction joinUrl(baseUrl: string, path: string): string {\n  return `${baseUrl.replace(/\\/+$/, '')}${path}`\n}\n\n/** Cap an untrusted provider body so it stays readable inside an error. */\nfunction summarize(raw: string): string {\n  const text = raw.trim()\n  return text.length > 300 ? `${text.slice(0, 300)}…` : text\n}\n\n/**\n * Pull the human-readable message out of a provider error body. All three\n * providers nest it under `error.message`; anything else — an HTML error page\n * from a proxy, say — is reported verbatim but capped.\n */\nfunction errorDetail(raw: string): string {\n  try {\n    const body: unknown = JSON.parse(raw)\n    if (body !== null && typeof body === 'object') {\n      const { error, message } = body as { error?: unknown, message?: unknown }\n      const nested = error !== null && typeof error === 'object'\n        ? (error as { message?: unknown }).message\n        : error\n      if (typeof nested === 'string' && nested.trim() !== '') return nested\n      if (typeof message === 'string' && message.trim() !== '') return message\n    }\n  } catch {\n    // Not JSON — the raw body is the best detail available.\n  }\n  return summarize(raw)\n}\n\ninterface ProviderRequest {\n  provider: LlmProvider\n  url: string\n  headers: Record<string, string>\n  body: unknown\n}\n\n/**\n * POST a JSON body and return the parsed response, mapping every failure onto\n * a classified TranslateProviderError: an HTTP status keeps its meaning\n * (401/403 auth, 429 rate limit), while network, timeout and malformed-body\n * failures land on `provider` and are retried by the caller.\n */\nasync function postJson<T>(request: ProviderRequest): Promise<T> {\n  let response: Response\n  let raw: string\n  try {\n    response = await fetch(request.url, {\n      method: 'POST',\n      headers: { 'content-type': 'application/json', ...request.headers },\n      body: JSON.stringify(request.body),\n      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),\n    })\n    raw = await response.text()\n  } catch (error) {\n    if (error instanceof Error && (error.name === 'TimeoutError' || error.name === 'AbortError')) {\n      throw new TranslateProviderError(\n        `Provider \"${request.provider}\" did not respond within ${REQUEST_TIMEOUT_MS / 1000}s.`,\n        'provider',\n      )\n    }\n    throw classifyProviderError(error)\n  }\n\n  if (!response.ok) {\n    const failure = new Error(\n      `Provider \"${request.provider}\" request failed (HTTP ${response.status}): ${errorDetail(raw)}`,\n    ) as Error & { status: number }\n    failure.status = response.status\n    throw classifyProviderError(failure)\n  }\n\n  try {\n    return JSON.parse(raw) as T\n  } catch {\n    throw new TranslateProviderError(\n      `Provider \"${request.provider}\" returned a non-JSON response: ${summarize(raw)}`,\n      'provider',\n      response.status,\n    )\n  }\n}\n\n/** Assemble a TranslateResponse, omitting `truncated` unless it is true. */\nfunction toTranslateResponse(text: string, model: string | undefined, fallbackModel: string, truncated: boolean): TranslateResponse {\n  return { text, model: model || fallbackModel, ...(truncated ? { truncated: true } : {}) }\n}\n\n// ─── Providers ──────────────────────────────────────────────────\n\ninterface OpenAiChatResponse {\n  model?: string\n  choices?: Array<{\n    message?: { content?: string | null }\n    finish_reason?: string\n  }>\n}\n\nfunction createOpenAiTranslateFn(config: LlmProviderConfig): TranslateFn {\n  const apiKey = resolveApiKey('openai', config.apiKey)\n  const url = joinUrl(config.baseUrl ?? DEFAULT_BASE_URL.openai, '/chat/completions')\n\n  return async (opts: TranslateRequest): Promise<TranslateResponse> => {\n    const response = await postJson<OpenAiChatResponse>({\n      provider: 'openai',\n      url,\n      headers: { authorization: `Bearer ${apiKey}` },\n      body: {\n        model: config.model,\n        messages: [\n          { role: 'system', content: opts.systemPrompt },\n          { role: 'user', content: opts.userMessage },\n        ],\n        max_tokens: opts.maxTokens,\n        temperature: 0,\n        response_format: { type: 'json_object' },\n      },\n    })\n\n    const choice = response.choices?.[0]\n    return toTranslateResponse(\n      choice?.message?.content ?? '',\n      response.model,\n      config.model,\n      choice?.finish_reason === 'length',\n    )\n  }\n}\n\ninterface AnthropicMessagesResponse {\n  model?: string\n  stop_reason?: string\n  content?: Array<{ type?: string, text?: string }>\n}\n\nfunction createAnthropicTranslateFn(config: LlmProviderConfig): TranslateFn {\n  const apiKey = resolveApiKey('anthropic', config.apiKey)\n  const url = joinUrl(config.baseUrl ?? DEFAULT_BASE_URL.anthropic, '/v1/messages')\n\n  return async (opts: TranslateRequest): Promise<TranslateResponse> => {\n    const response = await postJson<AnthropicMessagesResponse>({\n      provider: 'anthropic',\n      url,\n      headers: {\n        'x-api-key': apiKey,\n        // Pinned: the Messages API requires a version and an unpinned one would\n        // let a future breaking release reshape the response under us.\n        'anthropic-version': '2023-06-01',\n      },\n      body: {\n        model: config.model,\n        system: opts.systemPrompt,\n        messages: [{ role: 'user', content: opts.userMessage }],\n        max_tokens: opts.maxTokens,\n        temperature: 0,\n      },\n    })\n\n    // A reply arrives as a list of blocks; only the text ones carry the JSON.\n    const text = (response.content ?? [])\n      .filter(block => block?.type === 'text')\n      .map(block => block.text ?? '')\n      .join('')\n    return toTranslateResponse(text, response.model, config.model, response.stop_reason === 'max_tokens')\n  }\n}\n\ninterface GoogleGenerateContentResponse {\n  modelVersion?: string\n  candidates?: Array<{\n    content?: { parts?: Array<{ text?: string }> }\n    finishReason?: string\n  }>\n}\n\nfunction createGoogleTranslateFn(config: LlmProviderConfig): TranslateFn {\n  const apiKey = resolveApiKey('google', config.apiKey)\n  // The REST path already carries the `models/` prefix, so accept a model name\n  // written either way rather than producing `/models/models/gemini-…`.\n  const model = config.model.replace(/^models\\//, '')\n  const url = joinUrl(config.baseUrl ?? DEFAULT_BASE_URL.google, `/v1beta/models/${model}:generateContent`)\n\n  return async (opts: TranslateRequest): Promise<TranslateResponse> => {\n    const response = await postJson<GoogleGenerateContentResponse>({\n      provider: 'google',\n      url,\n      headers: { 'x-goog-api-key': apiKey },\n      body: {\n        contents: [{ role: 'user', parts: [{ text: opts.userMessage }] }],\n        systemInstruction: { parts: [{ text: opts.systemPrompt }] },\n        generationConfig: {\n          maxOutputTokens: opts.maxTokens,\n          temperature: 0,\n          responseMimeType: 'application/json',\n        },\n      },\n    })\n\n    const candidate = response.candidates?.[0]\n    const text = (candidate?.content?.parts ?? []).map(part => part.text ?? '').join('')\n    return toTranslateResponse(text, response.modelVersion, config.model, candidate?.finishReason === 'MAX_TOKENS')\n  }\n}\n\n/**\n * Create a TranslateFn from an LLM provider config. Every provider is called\n * over plain HTTP, so nothing beyond the CLI has to be installed.\n * Throws if the API key is missing.\n */\nexport async function createTranslateFn(config: LlmProviderConfig): Promise<TranslateFn> {\n  switch (config.provider) {\n    case 'openai':\n      return createOpenAiTranslateFn(config)\n    case 'anthropic':\n      return createAnthropicTranslateFn(config)\n    case 'google':\n      return createGoogleTranslateFn(config)\n    default: {\n      const _exhaustive: never = config.provider\n      throw new Error(`Unknown provider: ${_exhaustive}`)\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/report-By1-5JtO.js

@@ -0,0 +1,37 @@
+import { r as ToolError } from "./errors-coI1dhw1.js";
+import { relative, resolve } from "node:path";
+//#region src/core/report.ts
+/**
+* Report-file plumbing: path validation and resolution for tools that
+* support writing their output to a JSON report file.
+*/
+const DEFAULT_REPORT_DIR = ".i18n-reports";
+function validateReportPath(baseDir, absPath) {
+	const normalizedBase = resolve(baseDir);
+	const rel = relative(normalizedBase, resolve(absPath));
+	if (rel.startsWith("..") || rel === "") throw new ToolError(`Report path "${absPath}" resolves outside the project directory. Path must stay within "${normalizedBase}".`, "INVALID_REPORT_PATH");
+}
+/**
+* Resolve a caller-supplied outputFile against the project dir. Relative
+* paths must anchor to `dir`, not the process cwd — otherwise
+* `--output-file report.json --project-dir /x` run from elsewhere can never
+* pass the in-project guard. Absolute paths pass through unchanged; either
+* way the result must stay within the project dir.
+*/
+function resolveOutputFile(dir, outputFile) {
+	if (!outputFile) return void 0;
+	const absPath = resolve(dir, outputFile);
+	validateReportPath(dir, absPath);
+	return absPath;
+}
+function resolveReportFilePath(config, dir, toolName) {
+	const reportOutput = config.projectConfig?.reportOutput;
+	if (!reportOutput) return void 0;
+	const absPath = resolve(dir, reportOutput === true ? DEFAULT_REPORT_DIR : reportOutput, `${toolName}.json`);
+	validateReportPath(dir, absPath);
+	return absPath;
+}
+//#endregion
+export { resolveReportFilePath as n, validateReportPath as r, resolveOutputFile as t };
+
+//# sourceMappingURL=report-By1-5JtO.js.map

package/dist/report-By1-5JtO.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-By1-5JtO.js","names":[],"sources":["../src/core/report.ts"],"sourcesContent":["/**\n * Report-file plumbing: path validation and resolution for tools that\n * support writing their output to a JSON report file.\n */\n\nimport { resolve, relative } from 'node:path'\n\nimport type { I18nConfig } from '../config/types.js'\nimport { ToolError } from '../utils/errors.js'\n\nconst DEFAULT_REPORT_DIR = '.i18n-reports'\n\nexport function validateReportPath(baseDir: string, absPath: string): void {\n  const normalizedBase = resolve(baseDir)\n  const normalizedPath = resolve(absPath)\n  const rel = relative(normalizedBase, normalizedPath)\n  if (rel.startsWith('..') || rel === '') {\n    throw new ToolError(\n      `Report path \"${absPath}\" resolves outside the project directory. Path must stay within \"${normalizedBase}\".`,\n      'INVALID_REPORT_PATH',\n    )\n  }\n}\n\n/**\n * Resolve a caller-supplied outputFile against the project dir. Relative\n * paths must anchor to `dir`, not the process cwd — otherwise\n * `--output-file report.json --project-dir /x` run from elsewhere can never\n * pass the in-project guard. Absolute paths pass through unchanged; either\n * way the result must stay within the project dir.\n */\nexport function resolveOutputFile(\n  dir: string,\n  outputFile: string | undefined,\n): string | undefined {\n  if (!outputFile) return undefined\n  const absPath = resolve(dir, outputFile)\n  validateReportPath(dir, absPath)\n  return absPath\n}\n\nexport function resolveReportFilePath(\n  config: I18nConfig,\n  dir: string,\n  toolName: string,\n): string | undefined {\n  const reportOutput = config.projectConfig?.reportOutput\n  if (!reportOutput) return undefined\n  const relDir = reportOutput === true ? DEFAULT_REPORT_DIR : reportOutput\n  const absPath = resolve(dir, relDir, `${toolName}.json`)\n  validateReportPath(dir, absPath)\n  return absPath\n}\n"],"mappings":";;;;;;;AAUA,MAAM,qBAAqB;AAE3B,SAAgB,mBAAmB,SAAiB,SAAuB;CACzE,MAAM,iBAAiB,QAAQ,QAAQ;CAEvC,MAAM,MAAM,SAAS,gBADE,QAAQ,QAAQ,CACa;AACpD,KAAI,IAAI,WAAW,KAAK,IAAI,QAAQ,GAClC,OAAM,IAAI,UACR,gBAAgB,QAAQ,mEAAmE,eAAe,KAC1G,sBACD;;;;;;;;;AAWL,SAAgB,kBACd,KACA,YACoB;AACpB,KAAI,CAAC,WAAY,QAAO,KAAA;CACxB,MAAM,UAAU,QAAQ,KAAK,WAAW;AACxC,oBAAmB,KAAK,QAAQ;AAChC,QAAO;;AAGT,SAAgB,sBACd,QACA,KACA,UACoB;CACpB,MAAM,eAAe,OAAO,eAAe;AAC3C,KAAI,CAAC,aAAc,QAAO,KAAA;CAE1B,MAAM,UAAU,QAAQ,KADT,iBAAiB,OAAO,qBAAqB,cACvB,GAAG,SAAS,OAAO;AACxD,oBAAmB,KAAK,QAAQ;AAChC,QAAO"}

package/dist/report-CHZgH9Wy.js

@@ -0,0 +1,2 @@
+import { n as resolveReportFilePath, r as validateReportPath, t as resolveOutputFile } from "./report-By1-5JtO.js";
+export { resolveOutputFile, resolveReportFilePath, validateReportPath };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@the-i18n-kit/cli",
-  "version": "5.0.0",
-  "description": "Find missing translations, remove dead keys, rename across all locales at once — for Nuxt, Laravel, Vue, React/Next.js, or any project with JSON/PHP locale files",
+  "version": "7.0.0",
+  "description": "Find missing translations, remove dead keys, rename across all locales at once — for Nuxt, Laravel, Vue, React/Next.js, or any project with JSON, YAML or PHP locale files",
   "keywords": [
     "i18n",
     "internationalization",
@@ -41,12 +41,6 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsdown",
-    "dev": "tsdown --watch",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit"
-  },
   "dependencies": {
     "citty": "^0.2.2",
     "consola": "^3.4.2",
@@ -54,29 +48,18 @@
     "oxc-parser": "^0.144.0",
     "sort-keys": "^6.0.0",
     "tinyglobby": "^0.2.15",
+    "yaml": "^2.8.2",
     "zod": "^4.3.6"
   },
   "peerDependencies": {
-    "@anthropic-ai/sdk": "^0.30.0",
-    "@google/genai": "^2.0.0",
     "@nuxt/kit": "^3.0.0 || ^4.0.0",
-    "openai": "^4.0.0 || ^5.0.0",
     "php-array-reader": "^2.1.3",
     "php-parser": "^3.2.0"
   },
   "peerDependenciesMeta": {
-    "@anthropic-ai/sdk": {
-      "optional": true
-    },
-    "@google/genai": {
-      "optional": true
-    },
     "@nuxt/kit": {
       "optional": true
     },
-    "openai": {
-      "optional": true
-    },
     "php-array-reader": {
       "optional": true
     },
@@ -90,7 +73,12 @@
     "php-array-reader": "^2.1.3",
     "php-parser": "^3.7.0",
     "tsdown": "^0.12.0",
-    "vitest": "^3.2.0",
-    "yaml": "2.8.2"
+    "vitest": "^3.2.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
   }
-}
+}

package/dist/_shared-DFyy3sh8.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"_shared-DFyy3sh8.js","names":[],"sources":["../src/commands/_shared.ts"],"sourcesContent":["import { defineCommand } from 'citty'\nimport type { CommandDef } from 'citty'\nimport { log } from '../utils/logger.js'\nimport { toErrorMessage } from '../utils/errors.js'\nimport { writeResult } from '../utils/stdout-guard.js'\nimport { createTranslateFn, resolveProviderBaseUrl, BASE_URL_ENV } from '../llm/providers.js'\nimport type { LlmProvider } from '../llm/providers.js'\nimport type { TranslateFn } from '../core/types.js'\nimport { loadProjectConfig } from '../config/project-config.js'\n\n/** Factory for commands that call an operation and output its result. */\nexport function createCommand(opts: {\n  name: string\n  description: string\n  args?: Record<string, unknown>\n  /**\n   * CI gates this command evaluates. The factory reads the requesting flag off\n   * args and evaluates every gate uniformly, so no command grows bespoke exit\n   * logic. Declaring a flagged gate does not add its flag — pair each spec\n   * with an entry in `args`. A spec without a flag is always evaluated.\n   */\n  gates?: GateSpec[]\n  /**\n   * Receives citty's parsed args. `any` is deliberate: each command declares\n   * its own `args` shape and citty does not thread that type through to the\n   * handler, so narrowing here only moves the cast into all nineteen command\n   * modules. The shape is validated by citty against the `args` above.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- see above\n  run: (args: any) => Promise<unknown>\n}): CommandDef {\n  // Retained on the definition, not only consumed here: the generated CLI\n  // reference has to state which commands fail a build on findings, and a gate\n  // with no flag leaves no trace in the arg descriptions to infer it from.\n  return withGates(defineCommand({\n    meta: { name: opts.name, description: opts.description },\n    args: { ...sharedArgs, ...(opts.args ?? {}) },\n    async run({ args }) {\n      try {\n        const result = await opts.run(args)\n        const decision = resolveExitCode(result, requestedGates(opts.gates ?? [], args), isTotalFailure(result))\n        outputResult(withGateReport(result, decision.tripped), args)\n        // Assign only on a non-zero decision: a clean run must leave the exit\n        // code exactly as it found it, as it did before gates existed.\n        if (decision.code !== EXIT_SUCCESS) process.exitCode = decision.code\n      } catch (error) {\n        emitErrorResult(error, args)\n        process.exitCode = EXIT_RUN_FAILED\n      }\n    },\n  }) as CommandDef, opts.gates ?? [])\n}\n\n/**\n * A command definition carrying the gates its factory evaluates. Read\n * structurally by the reference generator rather than by importing this type,\n * which would make the docs build depend on the CLI's internals.\n */\ninterface GatedCommandDef extends CommandDef {\n  gates: GateSpec[]\n}\n\nfunction withGates(def: CommandDef, gates: GateSpec[]): GatedCommandDef {\n  return Object.assign(def, { gates })\n}\n\n/** The run succeeded and no gate tripped. */\nexport const EXIT_SUCCESS = 0\n/** The run itself failed — a bad API key, an unreadable project, a total translate failure. */\nexport const EXIT_RUN_FAILED = 1\n/** The run succeeded but a requested gate tripped — findings exist, the tool worked. */\nexport const EXIT_GATE_TRIPPED = 2\n\n/**\n * A CI gate a command evaluates. `counter` is the field of `result.summary`\n * carrying the observed value.\n *\n * The two shapes are a union rather than one type with optional halves so the\n * invariants hold at compile time: a flagged gate always has a flag to read\n * its name and threshold from, and a flagless one always carries both itself.\n * Stated as options, `{ counter, threshold }` type-checks and then has no name\n * to report the gate under.\n */\nexport type GateSpec = FlaggedGateSpec | AlwaysOnGateSpec\n\ninterface GateSpecBase {\n  counter: string\n  /** 'above' trips when observed > threshold (default); 'below' when observed < threshold. */\n  direction?: 'above' | 'below'\n}\n\n/**\n * Requested by a flag, and evaluated only when that flag is passed. Omitting\n * `threshold` takes it from the flag's own value, so a boolean flag pairs with\n * `threshold: 0` and a numeric one (`--fail-under 90`) omits it.\n */\nexport interface FlaggedGateSpec extends GateSpecBase {\n  flag: string\n  name?: never\n  threshold?: number\n}\n\n/**\n * Always evaluated, for findings that are a defect rather than a threshold — a\n * key that renders raw in production is not something you opt into caring\n * about. It still reports as a gate: the run succeeded, and what it found is\n * what you are being told about.\n */\nexport interface AlwaysOnGateSpec extends GateSpecBase {\n  flag?: never\n  name: string\n  threshold: number\n}\n\n/** A gate the caller asked for, with its threshold already resolved. */\nexport interface RequestedGate {\n  name: string\n  counter: string\n  direction: 'above' | 'below'\n  threshold: number\n}\n\n/** A gate that tripped, as reported in the result. */\nexport interface TrippedGate extends RequestedGate {\n  observed: number\n}\n\nexport interface ExitDecision {\n  code: typeof EXIT_SUCCESS | typeof EXIT_RUN_FAILED | typeof EXIT_GATE_TRIPPED\n  tripped: TrippedGate[]\n}\n\n/**\n * Pure decision from an operation result plus the gates the caller requested\n * to an exit code. A failed run outranks a tripped gate — exit 1 wins over\n * exit 2 — and gates are not even consulted in that case, because counters\n * from a run that fell over say nothing about the project.\n */\nexport function resolveExitCode(\n  result: unknown,\n  gates: RequestedGate[],\n  runFailed = false,\n): ExitDecision {\n  if (runFailed) return { code: EXIT_RUN_FAILED, tripped: [] }\n\n  const tripped: TrippedGate[] = []\n  for (const gate of gates) {\n    const observed = observedValue(result, gate.counter)\n    if (observed === undefined || !trips(gate, observed)) continue\n    tripped.push({ ...gate, observed })\n  }\n\n  return {\n    code: tripped.length > 0 ? EXIT_GATE_TRIPPED : EXIT_SUCCESS,\n    tripped,\n  }\n}\n\n/**\n * Read a gate's counter off result.summary. Works on inline results and on\n * the { reportFile, summary } shape alike, since both carry the summary.\n * A missing or non-numeric counter yields undefined and never trips a gate.\n */\nfunction observedValue(result: unknown, counter: string): number | undefined {\n  if (result === null || typeof result !== 'object') return undefined\n  const summary = (result as Record<string, unknown>).summary\n  if (summary === null || typeof summary !== 'object') return undefined\n  const value = (summary as Record<string, unknown>)[counter]\n  return typeof value === 'number' && Number.isFinite(value) ? value : undefined\n}\n\nfunction trips(gate: RequestedGate, observed: number): boolean {\n  return gate.direction === 'below' ? observed < gate.threshold : observed > gate.threshold\n}\n\n/** Filter the declared gates down to the ones this invocation asked for. */\nfunction requestedGates(specs: GateSpec[], args: Record<string, unknown>): RequestedGate[] {\n  const requested: RequestedGate[] = []\n  for (const spec of specs) {\n    const resolved = spec.flag === undefined\n      ? { name: spec.name, threshold: spec.threshold }\n      : { name: kebabCase(spec.flag), threshold: thresholdFromFlag(spec, args) }\n    if (resolved.threshold === undefined || !Number.isFinite(resolved.threshold)) continue\n    requested.push({\n      name: resolved.name,\n      counter: spec.counter,\n      direction: spec.direction ?? 'above',\n      threshold: resolved.threshold,\n    })\n  }\n  return requested\n}\n\n/** The gate's threshold, or undefined when this invocation did not ask for it. */\nfunction thresholdFromFlag(spec: FlaggedGateSpec, args: Record<string, unknown>): number | undefined {\n  const raw = args[spec.flag]\n  if (raw === undefined || raw === null || raw === false || raw === '') return undefined\n  return spec.threshold ?? Number(raw)\n}\n\n/**\n * Name a tripped gate by the flag that requested it, so the JSON says\n * \"fail-on-missing\" — what the user typed — rather than \"failOnMissing\".\n */\nfunction kebabCase(flag: string): string {\n  return flag.replace(/[A-Z]/g, c => `-${c.toLowerCase()}`)\n}\n\n/**\n * Attach the gate report without disturbing the rest of the result: consumers\n * parsing today's shape keep working, and a run where nothing tripped is\n * byte-for-byte what it was before gates existed.\n */\nfunction withGateReport(result: unknown, tripped: TrippedGate[]): unknown {\n  if (tripped.length === 0) return result\n  if (result === null || typeof result !== 'object' || Array.isArray(result)) return result\n  return { ...(result as Record<string, unknown>), gatesTripped: tripped }\n}\n\n/**\n * True when a run completed but achieved nothing: failures present and zero\n * successes. Covers translate-missing-style results (summary.totalFailed /\n * summary.totalTranslated) and translate-key-style results (top-level\n * failed[] / translated[]). Results without those fields are never a\n * total failure, so unrelated commands are unaffected.\n */\nexport function isTotalFailure(result: unknown): boolean {\n  if (result === null || typeof result !== 'object') return false\n  const r = result as Record<string, unknown>\n\n  const summary = r.summary\n  if (summary !== null && typeof summary === 'object') {\n    const s = summary as Record<string, unknown>\n    if (typeof s.totalFailed === 'number' && typeof s.totalTranslated === 'number') {\n      return s.totalFailed > 0 && s.totalTranslated === 0\n    }\n  }\n\n  if (Array.isArray(r.failed) && Array.isArray(r.translated)) {\n    return r.failed.length > 0 && r.translated.length === 0\n  }\n\n  return false\n}\n\nconst sharedArgs = {\n  projectDir: {\n    type: 'string' as const,\n    alias: 'd',\n    description: 'Project directory (default: cwd)',\n  },\n  json: {\n    type: 'boolean' as const,\n    description: 'Output as JSON (default for non-TTY)',\n    default: false,\n  },\n}\n\n/** Output result — stdout always carries the result, machine-parseable when piped/--json */\nfunction outputResult(data: unknown, args: { json?: boolean }): void {\n  const jsonMode = args.json || !process.stdout.isTTY\n  if (\n    !jsonMode &&\n    data !== null &&\n    typeof data === 'object' &&\n    'reportFile' in (data as Record<string, unknown>)\n  ) {\n    const { reportFile, ...rest } = data as Record<string, unknown>\n    log.info(`Wrote report to: ${reportFile}`)\n    writeResult(JSON.stringify(rest, null, 2) + '\\n')\n    return\n  }\n  // JSON mode emits the full result (including reportFile when present) as pure JSON\n  writeResult(JSON.stringify(data, null, 2) + '\\n')\n}\n\n/**\n * Failure output. In JSON mode stdout must still carry parseable JSON —\n * consumers pipe it into jq, and zero bytes is a parse error — so the\n * structured error object IS the result on stdout; the human-readable\n * message goes to stderr in every mode. Exit code stays non-zero (callers\n * set it).\n */\nexport function emitErrorResult(error: unknown, args: { json?: boolean }): void {\n  log.error(toErrorMessage(error))\n  const jsonMode = args.json || !process.stdout.isTTY\n  if (!jsonMode) return\n  const payload = { error: { code: errorCode(error), message: toErrorMessage(error) } }\n  writeResult(JSON.stringify(payload, null, 2) + '\\n')\n}\n\n/** ToolError/FileIOError carry codes; Node errors expose e.g. ENOENT. */\nfunction errorCode(error: unknown): string {\n  if (error instanceof Error) {\n    const code = (error as { code?: unknown }).code\n    if (typeof code === 'string') return code\n    if (error.name === 'ConfigError') return 'CONFIG_ERROR'\n  }\n  return 'UNKNOWN_ERROR'\n}\n\n/** Provider selection flags shared by the translate commands. */\nexport const providerArgs = {\n  provider: { type: 'string' as const, description: 'LLM provider: \"openai\", \"anthropic\", or \"google\". Required for automatic translation.', valueHint: 'openai|anthropic|google' },\n  model: { type: 'string' as const, description: 'Model name (required when --provider is set)' },\n  apiKey: { type: 'string' as const, description: 'API key (falls back to OPENAI_API_KEY / ANTHROPIC_API_KEY / GEMINI_API_KEY env).' },\n  baseUrl: { type: 'string' as const, description: `Provider base URL for gateways, self-hosted models and proxies speaking the provider's protocol. Falls back to ${BASE_URL_ENV}, then providerBaseUrl in .i18n-mcp.json. Not supported by \"google\".` },\n}\n\n/**\n * Build a TranslateFn from the provider flags, or undefined when no provider\n * was given (agent mode). The base URL resolves flag > env > project config;\n * the config file is only read when neither of the first two is set, so a\n * fully-flagged invocation never depends on config discovery.\n */\nexport async function resolveProviderTranslateFn(args: {\n  provider?: string\n  model?: string\n  apiKey?: string\n  baseUrl?: string\n  projectDir?: string\n}): Promise<TranslateFn | undefined> {\n  if (!args.provider) return undefined\n  if (!args.model) {\n    throw new Error('--model is required when --provider is set')\n  }\n\n  let baseUrl = resolveProviderBaseUrl({ flag: args.baseUrl, env: process.env[BASE_URL_ENV] })\n  if (!baseUrl) {\n    const projectConfig = await loadProjectConfig(args.projectDir ?? process.cwd())\n    baseUrl = resolveProviderBaseUrl({ config: projectConfig?.providerBaseUrl })\n  }\n  if (baseUrl) log.debug(`Provider base URL: ${redactBaseUrl(baseUrl)}`)\n\n  return createTranslateFn({\n    provider: args.provider as LlmProvider,\n    model: args.model,\n    apiKey: args.apiKey,\n    baseUrl,\n  })\n}\n\n/**\n * Strip anything secret-shaped from a base URL before it reaches a log.\n * Gateways are routinely addressed as https://user:pass@host or with the key\n * in a query parameter, so keep only origin and path.\n */\nexport function redactBaseUrl(raw: string): string {\n  let url: URL\n  try {\n    url = new URL(raw)\n  } catch {\n    return '<unparseable base URL>'\n  }\n  const credentials = url.username || url.password ? '<redacted>@' : ''\n  const query = url.search || url.hash ? ' (query redacted)' : ''\n  return `${url.protocol}//${credentials}${url.host}${url.pathname}${query}`\n}\n\n/** Split a comma-separated string into a trimmed array, or return undefined */\nexport function splitList(val: string | undefined): string[] | undefined {\n  if (!val) return undefined\n  return val.split(',').map(s => s.trim()).filter(Boolean)\n}\n\n/** Parse a JSON string with a user-friendly error */\nexport function parseJsonArg<T = Record<string, Record<string, string>>>(\n  value: string,\n  argName: string,\n): T {\n  try {\n    return JSON.parse(value) as T\n  } catch (err) {\n    const detail = err instanceof SyntaxError ? err.message : String(err)\n    throw new Error(`Invalid JSON in --${argName}: ${detail}`)\n  }\n}\n"],"mappings":"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"}