@gpc-cli/core 0.9.52 → 0.9.53

package/dist/index.d.ts

@@ -1323,15 +1323,43 @@ declare function renderJson(g: GeneratedChangelog): string;
 
 declare function renderPrompt(g: GeneratedChangelog): string;
 
+type Provider = "anthropic" | "openai" | "google";
+type TranslationPath = "gateway" | "direct";
+type ErrorReason = "rate_limited" | "auth" | "safety_blocked" | "timeout" | "network" | "no_source" | "unknown";
+interface TranslationResult {
+    text: string;
+    tokensIn: number;
+    tokensOut: number;
+}
+type Translator = (locale: string, sourceText: string) => Promise<TranslationResult>;
+interface TranslatorConfig {
+    path: TranslationPath;
+    provider: Provider;
+    model: string;
+    runId: string;
+}
+interface ResolveAiConfigOptions {
+    provider?: string;
+    model?: string;
+    env?: NodeJS.ProcessEnv;
+}
+declare const PROVIDER_WHITELIST: readonly Provider[];
+declare const DEFAULT_MODELS: Record<Provider, string>;
+declare function resolveAiConfig(opts?: ResolveAiConfigOptions): TranslatorConfig;
+declare function classifyError(err: unknown): ErrorReason;
+declare function createTranslator(config: TranslatorConfig): Promise<Translator>;
+declare function fetchAggregateCost(runId: string): Promise<number | undefined>;
+declare function formatPathLabel(config: TranslatorConfig): string;
+
 declare const PLAY_STORE_LIMIT = 500;
-declare const PLACEHOLDER_TEXT = "[needs translation \u2014 pass --ai once v0.9.63 ships, or paste the prompt emitted by --format prompt]";
+declare const PLACEHOLDER_TEXT = "[needs translation \u2014 pass --ai, or paste the prompt emitted by --format prompt]";
 type PlayStoreFormat = "md" | "json" | "prompt";
 interface LocaleEntry {
     language: string;
     text: string;
     chars: number;
     limit: number;
-    status: "ok" | "over" | "placeholder" | "empty";
+    status: "ok" | "over" | "placeholder" | "empty" | "failed";
 }
 interface LocaleBundle {
     from: string;
@@ -1354,6 +1382,22 @@ declare function renderPlayStore(g: GeneratedChangelog, opts: PlayStoreRenderOpt
     output: string;
     bundle: LocaleBundle;
 };
+interface TranslationFailure {
+    language: string;
+    reason: ErrorReason;
+}
+interface TranslateBundleOptions {
+    translator: Translator;
+    strict?: boolean;
+    onError?: (failure: TranslationFailure, err: unknown) => void;
+    onTranslated?: (entry: LocaleEntry) => void;
+}
+interface TranslatedBundle extends LocaleBundle {
+    tokensIn: number;
+    tokensOut: number;
+    failures: TranslationFailure[];
+}
+declare function translateBundle(bundle: LocaleBundle, options: TranslateBundleOptions): Promise<TranslatedBundle>;
 
 type Renderer = (g: GeneratedChangelog) => string;
 declare const RENDERERS: Record<OutputMode, Renderer>;
@@ -1409,4 +1453,4 @@ declare function decodeNotification(base64Payload: string): DecodedNotification;
  */
 declare function formatNotification(notification: DecodedNotification): Record<string, unknown>;
 
-export { ApiError, type AppInfo, type AppStatus, type AuditEntry, type BatchSyncResult, type BundleAnalysis, type BundleComparison, type BundleEntry, type BundleSizeCheckResult, type BundleSizeConfig, type ChangelogEntry, type CommandContext, type CommitCluster, ConfigError, type CreateEnterpriseAppParams, DEFAULT_LIMITS, DEFAULT_PREFLIGHT_CONFIG, type DecodedNotification, type DiffToken, type DiscoverPluginsOptions, type DryRunPublishResult, type DryRunResult, type DryRunUploadResult, type ExportImagesOptions, type ExportImagesSummary, type FastlaneDetection, type FastlaneLane, type FetchChangelogOptions, type FieldLintResult, type FileValidationResult, type FindingSeverity, GOOGLE_PLAY_LANGUAGES, type GenerateOptions, type GeneratedChangelog, type GetAppStatusOptions, type GitNotesOptions, type GitReleaseNotes, type GitRunner, GpcError, type ImageValidationResult, type InitOptions, type InitResult, type InternalSharingUploadResult, type ListIapOptions, type ListSubscriptionsOptions, type ListUsersOptions, type ListVoidedOptions, type ListingDiff, type ListingFieldLimits, type ListingLintResult, type ListingsResult, type LoadedPlugin, type LocaleBundle, type LocaleEntry, type MigrationResult, NetworkError, type OneTimeProductDiff, type OutputMode, PERMISSION_PROPAGATION_WARNING, PLACEHOLDER_TEXT, PLAY_STORE_LIMIT, type ParsedCommit, type ParsedManifest, type ParsedMonth, type PlayStoreFormat, type PlayStoreRenderOptions, PluginManager, type PreflightConfig, type PreflightFinding, type PreflightOptions, type PreflightResult, type PreflightScanner, type PublishOptions, type PublishResult, type PushResult, type QuotaUsage, RENDERERS, type RawCommit, type ReleaseDiff, type ReleaseNotesValidation, type ReleaseStatusResult, type Renderer, type ResolveLocalesOptions, type ReviewAnalysis, type ReviewExportOptions, type ReviewsFilterOptions, type RtdnStatus, SECTION_ORDER, SENSITIVE_ARG_KEYS, SENSITIVE_KEYS, SEVERITY_ORDER, type ScaffoldOptions, type ScaffoldResult, type Spinner, type StatusDiff, type StatusRelease, type StatusReviews, type StatusVitalMetric, type SubscriptionAnalytics, type SubscriptionDiff, type SyncResult, type ThresholdResult, type TrainConfig, type TrainState, type UploadResult, type ValidateCheck, type ValidateOptions, type ValidateResult, type VersionVitalsComparison, type VersionVitalsRow, type VitalsOverview, type VitalsQueryOptions, type VitalsTrendComparison, type WatchOptions, type WatchVitalsOptions, type WebhookPayload, abortTrain, acknowledgeProductPurchase, activateBasePlan, activateOffer, addRecoveryTargeting, addTesters, advanceTrain, analyzeBundle, analyzeRemoteListings, analyzeReviews, batchGetOrders, batchSyncInAppProducts, buildLocaleBundle, cancelRecoveryAction, cancelSubscriptionPurchase, cancelSubscriptionV2, checkBundleSize, checkThreshold, clearAuditLog, compareBundles, compareVersionVitals, compareVitalsTrend, computeStatusDiff, consumeProductPurchase, convertRegionPrices, createAuditEntry, createDeviceTier, createEnterpriseApp, createExternalTransaction, createGrant, createInAppProduct, createOffer, createOneTimeOffer, createOneTimeProduct, createRecoveryAction, createSpinner, createSubscription, createTrack, deactivateBasePlan, deactivateOffer, decodeNotification, defaultGitRunner, deferSubscriptionPurchase, deferSubscriptionV2, deleteBasePlan, deleteGrant, deleteImage, deleteInAppProduct, deleteListing, deleteOffer, deleteOneTimeOffer, deleteOneTimeProduct, deleteSubscription, deployRecoveryAction, detectFastlane, detectOutputFormat, diffListings, diffListingsCommand, diffListingsEnhanced, diffOneTimeProduct, diffReleases, diffSubscription, discoverPlugins, downloadGeneratedApk, downloadReport, exportImages, exportReviews, fetchChangelog, fetchReleaseNotes, formatChangelogEntry, formatCustomPayload, formatDiscordPayload, formatJunit, formatNotification, formatOutput, formatSlackPayload, formatStatusDiff, formatStatusSummary, formatStatusTable, formatWordDiff, generateChangelog, generateMigrationPlan, generateNotesFromGit, getAllScannerNames, getAppInfo, getAppStatus, getCountryAvailability, getDeviceTier, getExternalTransaction, getInAppProduct, getListings, getOffer, getOneTimeOffer, getOneTimeProduct, getOrderDetails, getProductPurchase, getProductPurchaseV2, getQuotaUsage, getReleasesStatus, getReview, getRtdnStatus, getSubscription, getSubscriptionAnalytics, getSubscriptionPurchase, getTrainStatus, getUser, getVitalsAnomalies, getVitalsAnr, getVitalsBattery, getVitalsCrashes, getVitalsErrorCount, getVitalsLmk, getVitalsMemory, getVitalsOverview, getVitalsRendering, getVitalsStartup, importDataSafety, importTestersFromCsv, initAudit, initProject, inviteUser, isFinancialReportType, isStatsReportType, isValidBcp47, isValidReportType, isValidStatsDimension, lintListing, lintListings, lintLocalListings, listAchievements, listAuditEvents, listDeviceTiers, listEvents, listGeneratedApks, listGrants, listImages, listInAppProducts, listLeaderboards, listOffers, listOneTimeOffers, listOneTimeProducts, listRecoveryActions, listReports, listReviews, listSubscriptions, listTesters, listTracks, listUsers, listVoidedPurchases, loadPreflightConfig, loadStatusCache, maybePaginate, migratePrices, parseAppfile, parseCommit, parseFastfile, parseGrantArg, parseMonth, parseRemoteUrl, pauseTrain, promoteRelease, publish, publishEnterpriseApp, pullListings, pushListings, readListingsFromDir, readReleaseNotesFromDir, redactAuditArgs, redactSensitive, refundExternalTransaction, refundOrder, relativeTime, removeTesters, removeUser, renderJson, renderMarkdown, renderPlayStore, renderPlayStoreJson, renderPlayStoreMd, renderPlayStorePrompt, renderPrompt, replyToReview, resolveLocales, revokeSubscriptionPurchase, runPreflight, runWatchLoop, safePath, safePathWithin, saveStatusCache, scaffoldPlugin, searchAuditEvents, searchVitalsErrors, sendNotification, sendWebhook, sortResults, startTrain, statusHasBreach, syncInAppProducts, topFiles, trackBreachState, updateAppDetails, updateDataSafety, updateGrant, updateInAppProduct, updateListing, updateOffer, updateOneTimeOffer, updateOneTimeProduct, updateRollout, updateSubscription, updateTrackConfig, updateUser, uploadExternallyHosted, uploadImage, uploadInternalSharing, uploadRelease, validateImage, validateLanguageCode, validatePackageName, validatePreSubmission, validateReleaseNotes, validateSku, validateTrackName, validateUploadFile, validateVersionCode, watchVitalsWithAutoHalt, wordDiff, writeAuditLog, writeListingsToDir, writeMigrationOutput };
+export { ApiError, type AppInfo, type AppStatus, type AuditEntry, type BatchSyncResult, type BundleAnalysis, type BundleComparison, type BundleEntry, type BundleSizeCheckResult, type BundleSizeConfig, type ChangelogEntry, type CommandContext, type CommitCluster, ConfigError, type CreateEnterpriseAppParams, DEFAULT_LIMITS, DEFAULT_MODELS, DEFAULT_PREFLIGHT_CONFIG, type DecodedNotification, type DiffToken, type DiscoverPluginsOptions, type DryRunPublishResult, type DryRunResult, type DryRunUploadResult, type ErrorReason, type ExportImagesOptions, type ExportImagesSummary, type FastlaneDetection, type FastlaneLane, type FetchChangelogOptions, type FieldLintResult, type FileValidationResult, type FindingSeverity, GOOGLE_PLAY_LANGUAGES, type GenerateOptions, type GeneratedChangelog, type GetAppStatusOptions, type GitNotesOptions, type GitReleaseNotes, type GitRunner, GpcError, type ImageValidationResult, type InitOptions, type InitResult, type InternalSharingUploadResult, type ListIapOptions, type ListSubscriptionsOptions, type ListUsersOptions, type ListVoidedOptions, type ListingDiff, type ListingFieldLimits, type ListingLintResult, type ListingsResult, type LoadedPlugin, type LocaleBundle, type LocaleEntry, type MigrationResult, NetworkError, type OneTimeProductDiff, type OutputMode, PERMISSION_PROPAGATION_WARNING, PLACEHOLDER_TEXT, PLAY_STORE_LIMIT, PROVIDER_WHITELIST, type ParsedCommit, type ParsedManifest, type ParsedMonth, type PlayStoreFormat, type PlayStoreRenderOptions, PluginManager, type PreflightConfig, type PreflightFinding, type PreflightOptions, type PreflightResult, type PreflightScanner, type Provider, type PublishOptions, type PublishResult, type PushResult, type QuotaUsage, RENDERERS, type RawCommit, type ReleaseDiff, type ReleaseNotesValidation, type ReleaseStatusResult, type Renderer, type ResolveAiConfigOptions, type ResolveLocalesOptions, type ReviewAnalysis, type ReviewExportOptions, type ReviewsFilterOptions, type RtdnStatus, SECTION_ORDER, SENSITIVE_ARG_KEYS, SENSITIVE_KEYS, SEVERITY_ORDER, type ScaffoldOptions, type ScaffoldResult, type Spinner, type StatusDiff, type StatusRelease, type StatusReviews, type StatusVitalMetric, type SubscriptionAnalytics, type SubscriptionDiff, type SyncResult, type ThresholdResult, type TrainConfig, type TrainState, type TranslateBundleOptions, type TranslatedBundle, type TranslationFailure, type TranslationPath, type TranslationResult, type Translator, type TranslatorConfig, type UploadResult, type ValidateCheck, type ValidateOptions, type ValidateResult, type VersionVitalsComparison, type VersionVitalsRow, type VitalsOverview, type VitalsQueryOptions, type VitalsTrendComparison, type WatchOptions, type WatchVitalsOptions, type WebhookPayload, abortTrain, acknowledgeProductPurchase, activateBasePlan, activateOffer, addRecoveryTargeting, addTesters, advanceTrain, analyzeBundle, analyzeRemoteListings, analyzeReviews, batchGetOrders, batchSyncInAppProducts, buildLocaleBundle, cancelRecoveryAction, cancelSubscriptionPurchase, cancelSubscriptionV2, checkBundleSize, checkThreshold, classifyError, clearAuditLog, compareBundles, compareVersionVitals, compareVitalsTrend, computeStatusDiff, consumeProductPurchase, convertRegionPrices, createAuditEntry, createDeviceTier, createEnterpriseApp, createExternalTransaction, createGrant, createInAppProduct, createOffer, createOneTimeOffer, createOneTimeProduct, createRecoveryAction, createSpinner, createSubscription, createTrack, createTranslator, deactivateBasePlan, deactivateOffer, decodeNotification, defaultGitRunner, deferSubscriptionPurchase, deferSubscriptionV2, deleteBasePlan, deleteGrant, deleteImage, deleteInAppProduct, deleteListing, deleteOffer, deleteOneTimeOffer, deleteOneTimeProduct, deleteSubscription, deployRecoveryAction, detectFastlane, detectOutputFormat, diffListings, diffListingsCommand, diffListingsEnhanced, diffOneTimeProduct, diffReleases, diffSubscription, discoverPlugins, downloadGeneratedApk, downloadReport, exportImages, exportReviews, fetchAggregateCost, fetchChangelog, fetchReleaseNotes, formatChangelogEntry, formatCustomPayload, formatDiscordPayload, formatJunit, formatNotification, formatOutput, formatPathLabel, formatSlackPayload, formatStatusDiff, formatStatusSummary, formatStatusTable, formatWordDiff, generateChangelog, generateMigrationPlan, generateNotesFromGit, getAllScannerNames, getAppInfo, getAppStatus, getCountryAvailability, getDeviceTier, getExternalTransaction, getInAppProduct, getListings, getOffer, getOneTimeOffer, getOneTimeProduct, getOrderDetails, getProductPurchase, getProductPurchaseV2, getQuotaUsage, getReleasesStatus, getReview, getRtdnStatus, getSubscription, getSubscriptionAnalytics, getSubscriptionPurchase, getTrainStatus, getUser, getVitalsAnomalies, getVitalsAnr, getVitalsBattery, getVitalsCrashes, getVitalsErrorCount, getVitalsLmk, getVitalsMemory, getVitalsOverview, getVitalsRendering, getVitalsStartup, importDataSafety, importTestersFromCsv, initAudit, initProject, inviteUser, isFinancialReportType, isStatsReportType, isValidBcp47, isValidReportType, isValidStatsDimension, lintListing, lintListings, lintLocalListings, listAchievements, listAuditEvents, listDeviceTiers, listEvents, listGeneratedApks, listGrants, listImages, listInAppProducts, listLeaderboards, listOffers, listOneTimeOffers, listOneTimeProducts, listRecoveryActions, listReports, listReviews, listSubscriptions, listTesters, listTracks, listUsers, listVoidedPurchases, loadPreflightConfig, loadStatusCache, maybePaginate, migratePrices, parseAppfile, parseCommit, parseFastfile, parseGrantArg, parseMonth, parseRemoteUrl, pauseTrain, promoteRelease, publish, publishEnterpriseApp, pullListings, pushListings, readListingsFromDir, readReleaseNotesFromDir, redactAuditArgs, redactSensitive, refundExternalTransaction, refundOrder, relativeTime, removeTesters, removeUser, renderJson, renderMarkdown, renderPlayStore, renderPlayStoreJson, renderPlayStoreMd, renderPlayStorePrompt, renderPrompt, replyToReview, resolveAiConfig, resolveLocales, revokeSubscriptionPurchase, runPreflight, runWatchLoop, safePath, safePathWithin, saveStatusCache, scaffoldPlugin, searchAuditEvents, searchVitalsErrors, sendNotification, sendWebhook, sortResults, startTrain, statusHasBreach, syncInAppProducts, topFiles, trackBreachState, translateBundle, updateAppDetails, updateDataSafety, updateGrant, updateInAppProduct, updateListing, updateOffer, updateOneTimeOffer, updateOneTimeProduct, updateRollout, updateSubscription, updateTrackConfig, updateUser, uploadExternallyHosted, uploadImage, uploadInternalSharing, uploadRelease, validateImage, validateLanguageCode, validatePackageName, validatePreSubmission, validateReleaseNotes, validateSku, validateTrackName, validateUploadFile, validateVersionCode, watchVitalsWithAutoHalt, wordDiff, writeAuditLog, writeListingsToDir, writeMigrationOutput };

package/dist/index.js

@@ -7881,9 +7881,179 @@ function renderPrompt(g) {
   return lines.join("\n");
 }
 
+// src/commands/changelog-ai.ts
+import { randomUUID } from "crypto";
+var PROVIDER_WHITELIST = ["anthropic", "openai", "google"];
+var DEFAULT_MODELS = {
+  anthropic: "claude-sonnet-4-6",
+  openai: "gpt-4o-mini",
+  google: "gemini-2.5-flash"
+};
+function resolveAiConfig(opts = {}) {
+  const env = opts.env ?? process.env;
+  const hasGateway = typeof env["AI_GATEWAY_API_KEY"] === "string" && env["AI_GATEWAY_API_KEY"].length > 0;
+  let provider;
+  if (opts.provider) {
+    const normalized = opts.provider.toLowerCase();
+    if (!PROVIDER_WHITELIST.includes(normalized)) {
+      throw new GpcError(
+        `Unknown --provider "${opts.provider}"`,
+        "CHANGELOG_AI_UNKNOWN_PROVIDER",
+        2,
+        `Valid providers: ${PROVIDER_WHITELIST.join(", ")}`
+      );
+    }
+    provider = normalized;
+  } else if (hasGateway || env["ANTHROPIC_API_KEY"]) {
+    provider = "anthropic";
+  } else if (env["OPENAI_API_KEY"]) {
+    provider = "openai";
+  } else if (env["GOOGLE_GENERATIVE_AI_API_KEY"]) {
+    provider = "google";
+  } else {
+    throw new GpcError(
+      "No AI provider credentials found in env",
+      "CHANGELOG_AI_NO_CREDENTIALS",
+      3,
+      "Set one of: AI_GATEWAY_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY, GOOGLE_GENERATIVE_AI_API_KEY."
+    );
+  }
+  const model = opts.model ?? DEFAULT_MODELS[provider];
+  const path = hasGateway ? "gateway" : "direct";
+  const runId = randomUUID();
+  return { path, provider, model, runId };
+}
+function classifyError(err) {
+  if (!err || typeof err !== "object") return "unknown";
+  const e = err;
+  const name = typeof e["name"] === "string" ? e["name"] : "";
+  const statusCode = typeof e["statusCode"] === "number" ? e["statusCode"] : typeof e["status"] === "number" ? e["status"] : 0;
+  const message = typeof e["message"] === "string" ? e["message"].toLowerCase() : "";
+  const finishReason = typeof e["finishReason"] === "string" ? e["finishReason"] : "";
+  if (name === "RateLimitError" || statusCode === 429 || statusCode === 529) return "rate_limited";
+  if (statusCode === 401 || statusCode === 403) return "auth";
+  if (message.includes("api key invalid") || message.includes("invalid api key")) return "auth";
+  if (finishReason === "SAFETY") return "safety_blocked";
+  if (statusCode === 400 && (message.includes("content_policy") || message.includes("content policy") || message.includes("safety"))) {
+    return "safety_blocked";
+  }
+  if (name === "AbortError" || name === "TimeoutError") return "timeout";
+  if (message.includes("timeout") || message.includes("timed out")) return "timeout";
+  if (message.includes("econnrefused") || message.includes("enotfound") || message.includes("etimedout") || message.includes("network") || name === "TypeError" && message.includes("fetch")) {
+    return "network";
+  }
+  return "unknown";
+}
+function buildSystemPrompt() {
+  return [
+    `You translate Play Store "What's new" release notes for Android apps.`,
+    "Rules:",
+    "- Translation MUST be at most 500 Unicode code points.",
+    '- Preserve bullet format (one item per line, starts with "- ").',
+    "- User-facing tone. Avoid internal jargon.",
+    '- Do not translate technical names (package names, CLI flags, "GPC").',
+    "- Drop the conventional-commit prefix (feat:/fix:/docs:) if it feels unnatural in the target language.",
+    "Respond with the translated text only. No explanations, no markdown headings."
+  ].join("\n");
+}
+function buildUserPrompt(locale, sourceText) {
+  return `Translate the following release notes into ${locale}:
+
+${sourceText}`;
+}
+function providerSpecificOptions(provider) {
+  if (provider === "google") {
+    return { google: { thinkingConfig: { thinkingBudget: 0 } } };
+  }
+  return {};
+}
+function readUsage(usage) {
+  if (!usage || typeof usage !== "object") return { tokensIn: 0, tokensOut: 0 };
+  const u = usage;
+  const tokensIn = typeof u["inputTokens"] === "number" ? u["inputTokens"] : typeof u["promptTokens"] === "number" ? u["promptTokens"] : 0;
+  const tokensOut = typeof u["outputTokens"] === "number" ? u["outputTokens"] : typeof u["completionTokens"] === "number" ? u["completionTokens"] : 0;
+  return { tokensIn, tokensOut };
+}
+async function createTranslator(config) {
+  const ai = await import("ai");
+  const generateText = ai.generateText;
+  if (config.path === "gateway") {
+    const modelString = `${config.provider}/${config.model}`;
+    return async (locale, sourceText) => {
+      const result = await generateText({
+        model: ai.gateway(modelString),
+        system: buildSystemPrompt(),
+        prompt: buildUserPrompt(locale, sourceText),
+        temperature: 0.2,
+        providerOptions: {
+          gateway: { tags: [`gpc-changelog-${config.runId}`] },
+          ...providerSpecificOptions(config.provider)
+          // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        }
+      });
+      const { tokensIn, tokensOut } = readUsage(result.usage);
+      return { text: result.text, tokensIn, tokensOut };
+    };
+  }
+  let modelFactory;
+  if (config.provider === "anthropic") {
+    const mod = await import("@ai-sdk/anthropic");
+    modelFactory = (id) => mod.anthropic(id);
+  } else if (config.provider === "openai") {
+    const mod = await import("@ai-sdk/openai");
+    modelFactory = (id) => mod.openai(id);
+  } else {
+    const mod = await import("@ai-sdk/google");
+    modelFactory = (id) => mod.google(id);
+  }
+  return async (locale, sourceText) => {
+    const result = await generateText({
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      model: modelFactory(config.model),
+      system: buildSystemPrompt(),
+      prompt: buildUserPrompt(locale, sourceText),
+      temperature: 0.2,
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      providerOptions: providerSpecificOptions(config.provider)
+    });
+    const { tokensIn, tokensOut } = readUsage(result.usage);
+    return { text: result.text, tokensIn, tokensOut };
+  };
+}
+async function fetchAggregateCost(runId) {
+  try {
+    const { gateway } = await import("ai");
+    const now = /* @__PURE__ */ new Date();
+    const yesterday = new Date(now.getTime() - 24 * 60 * 60 * 1e3);
+    const today = now.toISOString().slice(0, 10);
+    const startDate = yesterday.toISOString().slice(0, 10);
+    const report = await gateway.getSpendReport({
+      startDate,
+      endDate: today,
+      groupBy: "tag",
+      tags: [`gpc-changelog-${runId}`]
+    });
+    const results = report.results ?? [];
+    return results.reduce((sum, row) => sum + (row.totalCost ?? 0), 0);
+  } catch {
+    return void 0;
+  }
+}
+var PROVIDER_BRAND = {
+  anthropic: "Anthropic",
+  openai: "OpenAI",
+  google: "Google"
+};
+function formatPathLabel(config) {
+  if (config.path === "gateway") {
+    return `routing via AI Gateway (${config.provider}/${config.model})`;
+  }
+  return `direct ${PROVIDER_BRAND[config.provider]} SDK (${config.model})`;
+}
+
 // src/commands/changelog-renderers/play-store.ts
 var PLAY_STORE_LIMIT = 500;
-var PLACEHOLDER_TEXT = "[needs translation \u2014 pass --ai once v0.9.63 ships, or paste the prompt emitted by --format prompt]";
+var PLACEHOLDER_TEXT = "[needs translation \u2014 pass --ai, or paste the prompt emitted by --format prompt]";
 function safeLine2(s) {
   return s.replace(/[\r\n]+/g, " ").trim();
 }
@@ -8038,6 +8208,88 @@ function renderPlayStore(g, opts) {
       return { output: renderPlayStorePrompt(bundle, g), bundle };
   }
 }
+async function translateBundle(bundle, options) {
+  const source = bundle.locales.find((e) => e.language === bundle.sourceLanguage);
+  const sourceText = source?.text ?? "";
+  const hasSource = source !== void 0 && sourceText.trim().length > 0;
+  let tokensIn = 0;
+  let tokensOut = 0;
+  const failures = [];
+  const newLocales = [];
+  for (const entry of bundle.locales) {
+    if (entry.status !== "placeholder") {
+      newLocales.push(entry);
+      continue;
+    }
+    if (!hasSource) {
+      const failure = { language: entry.language, reason: "no_source" };
+      failures.push(failure);
+      options.onError?.(failure, new Error("source locale missing or empty"));
+      const failedText = `[translation failed: no_source]`;
+      newLocales.push({
+        language: entry.language,
+        text: failedText,
+        chars: countChars(failedText),
+        limit: PLAY_STORE_LIMIT,
+        status: "failed"
+      });
+      continue;
+    }
+    try {
+      const result = await options.translator(entry.language, sourceText);
+      tokensIn += result.tokensIn;
+      tokensOut += result.tokensOut;
+      let text = result.text.trim();
+      let chars = countChars(text);
+      let status = "ok";
+      if (chars > PLAY_STORE_LIMIT) {
+        text = truncateToLimit(text, PLAY_STORE_LIMIT);
+        chars = countChars(text);
+        status = "over";
+      }
+      const translated2 = {
+        language: entry.language,
+        text,
+        chars,
+        limit: PLAY_STORE_LIMIT,
+        status
+      };
+      newLocales.push(translated2);
+      options.onTranslated?.(translated2);
+    } catch (err) {
+      const reason = classifyError(err);
+      const failure = { language: entry.language, reason };
+      failures.push(failure);
+      options.onError?.(failure, err);
+      const failedText = `[translation failed: ${reason}]`;
+      newLocales.push({
+        language: entry.language,
+        text: failedText,
+        chars: countChars(failedText),
+        limit: PLAY_STORE_LIMIT,
+        status: "failed"
+      });
+    }
+  }
+  const overflows = newLocales.filter((e) => e.status === "over").map((e) => e.language);
+  const translated = {
+    ...bundle,
+    locales: newLocales,
+    overflows,
+    tokensIn,
+    tokensOut,
+    failures
+  };
+  if (options.strict && failures.length > 0) {
+    throw new GpcError(
+      `${failures.length} locale${failures.length === 1 ? "" : "s"} failed to translate: ${failures.map((f) => `${f.language}=${f.reason}`).join(", ")}`,
+      "CHANGELOG_AI_TRANSLATION_FAILED",
+      1,
+      "Remove --strict to continue on errors, or check credentials and retry."
+    );
+  }
+  return translated;
+}
 
 // src/commands/changelog-renderers/index.ts
 var RENDERERS = {
@@ -8204,6 +8456,7 @@ export {
   ApiError,
   ConfigError,
   DEFAULT_LIMITS,
+  DEFAULT_MODELS,
   DEFAULT_PREFLIGHT_CONFIG,
   GOOGLE_PLAY_LANGUAGES,
   GpcError,
@@ -8211,6 +8464,7 @@ export {
   PERMISSION_PROPAGATION_WARNING,
   PLACEHOLDER_TEXT,
   PLAY_STORE_LIMIT,
+  PROVIDER_WHITELIST,
   PluginManager,
   RENDERERS,
   SECTION_ORDER,
@@ -8235,6 +8489,7 @@ export {
   cancelSubscriptionV2,
   checkBundleSize,
   checkThreshold,
+  classifyError,
   clearAuditLog,
   compareBundles,
   compareVersionVitals,
@@ -8255,6 +8510,7 @@ export {
   createSpinner,
   createSubscription,
   createTrack,
+  createTranslator,
   deactivateBasePlan,
   deactivateOffer,
   decodeNotification,
@@ -8284,6 +8540,7 @@ export {
   downloadReport,
   exportImages,
   exportReviews,
+  fetchAggregateCost,
   fetchChangelog,
   fetchReleaseNotes,
   formatChangelogEntry,
@@ -8292,6 +8549,7 @@ export {
   formatJunit,
   formatNotification,
   formatOutput,
+  formatPathLabel,
   formatSlackPayload,
   formatStatusDiff,
   formatStatusSummary,
@@ -8399,6 +8657,7 @@ export {
   renderPlayStorePrompt,
   renderPrompt,
   replyToReview,
+  resolveAiConfig,
   resolveLocales,
   revokeSubscriptionPurchase,
   runPreflight,
@@ -8417,6 +8676,7 @@ export {
   syncInAppProducts,
   topFiles,
   trackBreachState,
+  translateBundle,
   updateAppDetails,
   updateDataSafety,
   updateGrant,