@gpc-cli/core 0.9.51 → 0.9.53

package/dist/index.d.ts

@@ -1323,9 +1323,91 @@ 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, 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" | "failed";
+}
+interface LocaleBundle {
+    from: string;
+    to: string;
+    limit: number;
+    sourceLanguage: string;
+    locales: LocaleEntry[];
+    overflows: string[];
+}
+interface PlayStoreRenderOptions {
+    locales: string[];
+    format: PlayStoreFormat;
+    sourceLanguage?: string;
+}
+declare function buildLocaleBundle(g: GeneratedChangelog, opts: PlayStoreRenderOptions): LocaleBundle;
+declare function renderPlayStoreMd(bundle: LocaleBundle): string;
+declare function renderPlayStoreJson(bundle: LocaleBundle): string;
+declare function renderPlayStorePrompt(bundle: LocaleBundle, g: GeneratedChangelog): string;
+declare function renderPlayStore(g: GeneratedChangelog, opts: PlayStoreRenderOptions): {
+    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>;
 
+interface ResolveLocalesOptions {
+    client?: PlayApiClient;
+    packageName?: string;
+}
+declare function resolveLocales(input: string, options?: ResolveLocalesOptions): Promise<string[]>;
+
 interface RtdnStatus {
     topicName: string | null;
     enabled: boolean;
@@ -1371,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 MigrationResult, NetworkError, type OneTimeProductDiff, type OutputMode, PERMISSION_PROPAGATION_WARNING, type ParsedCommit, type ParsedManifest, type ParsedMonth, 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 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, 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, renderPrompt, replyToReview, 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,6 +7881,416 @@ 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, or paste the prompt emitted by --format prompt]";
+function safeLine2(s) {
+  return s.replace(/[\r\n]+/g, " ").trim();
+}
+function countChars(s) {
+  return [...s].length;
+}
+function truncateToLimit(text, limit) {
+  if (countChars(text) <= limit) return text;
+  const chars = [...text];
+  return chars.slice(0, limit - 1).join("") + "\u2026";
+}
+function renderEnglishBullets(g) {
+  const lines = [];
+  for (const type of SECTION_ORDER) {
+    const commits = g.grouped[type] ?? [];
+    for (const commit of commits) {
+      lines.push(`- ${type}: ${safeLine2(commit.subject)}`);
+    }
+  }
+  return lines.join("\n");
+}
+function buildLocaleBundle(g, opts) {
+  const sourceLanguage = opts.sourceLanguage ?? "en-US";
+  const sourceText = renderEnglishBullets(g);
+  const isEmpty = sourceText.length === 0;
+  const overflows = [];
+  const entries = opts.locales.map((language) => {
+    if (language === sourceLanguage) {
+      if (isEmpty) {
+        const emptyText = "No notable changes.";
+        return {
+          language,
+          text: emptyText,
+          chars: countChars(emptyText),
+          limit: PLAY_STORE_LIMIT,
+          status: "empty"
+        };
+      }
+      const chars = countChars(sourceText);
+      const status = chars > PLAY_STORE_LIMIT ? "over" : "ok";
+      if (status === "over") overflows.push(language);
+      const text = status === "over" ? truncateToLimit(sourceText, PLAY_STORE_LIMIT) : sourceText;
+      return {
+        language,
+        text,
+        chars,
+        limit: PLAY_STORE_LIMIT,
+        status
+      };
+    }
+    return {
+      language,
+      text: PLACEHOLDER_TEXT,
+      chars: countChars(PLACEHOLDER_TEXT),
+      limit: PLAY_STORE_LIMIT,
+      status: "placeholder"
+    };
+  });
+  return {
+    from: g.from,
+    to: g.to,
+    limit: PLAY_STORE_LIMIT,
+    sourceLanguage,
+    locales: entries,
+    overflows
+  };
+}
+function renderPlayStoreMd(bundle) {
+  const lines = [];
+  lines.push(`# Play Store release notes (${bundle.from} \u2192 ${bundle.to})`);
+  lines.push("");
+  for (const entry of bundle.locales) {
+    let heading;
+    if (entry.status === "placeholder") {
+      heading = `## ${entry.language} (needs translation)`;
+    } else if (entry.status === "empty") {
+      heading = `## ${entry.language} (empty)`;
+    } else {
+      const suffix = entry.status === "over" ? ` \u26A0 truncated` : "";
+      heading = `## ${entry.language} (${entry.chars}/${entry.limit})${suffix}`;
+    }
+    lines.push(heading);
+    lines.push(entry.text);
+    lines.push("");
+  }
+  lines.push("## Summary");
+  for (const entry of bundle.locales) {
+    if (entry.status === "placeholder") {
+      lines.push(`- ${entry.language}: placeholder`);
+    } else if (entry.status === "empty") {
+      lines.push(`- ${entry.language}: empty`);
+    } else {
+      const mark = entry.status === "over" ? "\u2717 over limit" : "\u2713";
+      lines.push(`- ${entry.language}: ${entry.chars}/${entry.limit} ${mark}`);
+    }
+  }
+  return lines.join("\n");
+}
+function renderPlayStoreJson(bundle) {
+  return JSON.stringify(bundle, null, 2);
+}
+function renderPlayStorePrompt(bundle, g) {
+  const source = bundle.locales.find((e) => e.language === bundle.sourceLanguage);
+  const targets = bundle.locales.filter((e) => e.language !== bundle.sourceLanguage);
+  const lines = [];
+  lines.push(`You are translating Play Store "What's new" release notes from ${bundle.sourceLanguage}.`);
+  lines.push("");
+  lines.push("TARGETS:");
+  for (const t of targets) lines.push(`  - ${t.language}`);
+  if (targets.length === 0) lines.push("  (none \u2014 source-only bundle)");
+  lines.push("");
+  lines.push("CONSTRAINTS:");
+  lines.push(`- Each translation MUST be \u2264 ${bundle.limit} Unicode code points`);
+  lines.push('- Preserve the bullet format (one item per line, starts with "- ")');
+  lines.push("- Keep a user-facing tone (no internal jargon)");
+  lines.push('- Do not translate technical names (package names, CLI flags, "GPC")');
+  lines.push("- Drop the conventional-commit prefix (feat:/fix:) if it feels unnatural in the target language");
+  lines.push("");
+  lines.push(`SOURCE (${bundle.sourceLanguage}, ${source?.chars ?? 0}/${bundle.limit} chars):`);
+  lines.push("```");
+  lines.push(source?.text ?? "(empty)");
+  lines.push("```");
+  lines.push("");
+  if (g.headlineCandidates.length > 0) {
+    lines.push("CONTEXT (clusters, for theme awareness):");
+    for (const c of g.headlineCandidates) {
+      lines.push(`  - ${c.label} (${c.commits.length} commits, primary ${c.primaryType})`);
+    }
+    lines.push("");
+  }
+  lines.push("OUTPUT FORMAT (one heading + body per target language):");
+  lines.push("```markdown");
+  for (const t of targets) {
+    lines.push(`## ${t.language}`);
+    lines.push("<translation>");
+    lines.push("");
+  }
+  if (targets.length === 0) {
+    lines.push("(no target locales \u2014 nothing to translate)");
+  }
+  lines.push("```");
+  return lines.join("\n");
+}
+function renderPlayStore(g, opts) {
+  const bundle = buildLocaleBundle(g, opts);
+  switch (opts.format) {
+    case "md":
+      return { output: renderPlayStoreMd(bundle), bundle };
+    case "json":
+      return { output: renderPlayStoreJson(bundle), bundle };
+    case "prompt":
+      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 = {
   md: renderMarkdown,
@@ -7888,6 +8298,68 @@ var RENDERERS = {
   prompt: renderPrompt
 };
 
+// src/commands/changelog-locales.ts
+async function resolveLocales(input, options = {}) {
+  const trimmed = input.trim();
+  if (!trimmed) {
+    throw new GpcError(
+      "--locales is empty",
+      "CHANGELOG_LOCALES_REQUIRED",
+      2,
+      "Pass a comma-separated list (e.g., --locales en-US,fr-FR) or --locales auto."
+    );
+  }
+  if (trimmed === "auto") {
+    const { client, packageName } = options;
+    if (!client || !packageName) {
+      throw new GpcError(
+        "--locales auto requires an authenticated API client and --app",
+        "CHANGELOG_LOCALES_AUTO_NO_APP",
+        2,
+        "Pass --app <package> or set config.app, and ensure credentials are configured."
+      );
+    }
+    const edit = await client.edits.insert(packageName);
+    try {
+      const listings = await client.listings.list(packageName, edit.id);
+      await client.edits.delete(packageName, edit.id);
+      const langs = listings.map((l) => l.language);
+      if (langs.length === 0) {
+        throw new GpcError(
+          `No Play Store listings found for ${packageName}`,
+          "CHANGELOG_LOCALES_EMPTY",
+          1,
+          "Create at least one listing in Play Console, or pass --locales explicitly."
+        );
+      }
+      return langs;
+    } catch (error) {
+      await client.edits.delete(packageName, edit.id).catch(() => {
+      });
+      throw error;
+    }
+  }
+  const locales = trimmed.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+  if (locales.length === 0) {
+    throw new GpcError(
+      "--locales parsed to an empty list",
+      "CHANGELOG_LOCALES_REQUIRED",
+      2,
+      "Pass a comma-separated list (e.g., --locales en-US,fr-FR) or --locales auto."
+    );
+  }
+  const invalid = locales.filter((l) => !isValidBcp47(l));
+  if (invalid.length > 0) {
+    throw new GpcError(
+      `Invalid locale(s): ${invalid.join(", ")}`,
+      "CHANGELOG_LOCALES_INVALID",
+      2,
+      "Use BCP 47 codes recognized by Google Play (e.g., en-US, fr-FR, de-DE)."
+    );
+  }
+  return locales;
+}
+
 // src/commands/rtdn.ts
 var SUBSCRIPTION_NOTIFICATION_TYPES = {
   1: "SUBSCRIPTION_RECOVERED",
@@ -7984,11 +8456,15 @@ export {
   ApiError,
   ConfigError,
   DEFAULT_LIMITS,
+  DEFAULT_MODELS,
   DEFAULT_PREFLIGHT_CONFIG,
   GOOGLE_PLAY_LANGUAGES,
   GpcError,
   NetworkError,
   PERMISSION_PROPAGATION_WARNING,
+  PLACEHOLDER_TEXT,
+  PLAY_STORE_LIMIT,
+  PROVIDER_WHITELIST,
   PluginManager,
   RENDERERS,
   SECTION_ORDER,
@@ -8007,11 +8483,13 @@ export {
   analyzeReviews2 as analyzeReviews,
   batchGetOrders,
   batchSyncInAppProducts,
+  buildLocaleBundle,
   cancelRecoveryAction,
   cancelSubscriptionPurchase,
   cancelSubscriptionV2,
   checkBundleSize,
   checkThreshold,
+  classifyError,
   clearAuditLog,
   compareBundles,
   compareVersionVitals,
@@ -8032,6 +8510,7 @@ export {
   createSpinner,
   createSubscription,
   createTrack,
+  createTranslator,
   deactivateBasePlan,
   deactivateOffer,
   decodeNotification,
@@ -8061,6 +8540,7 @@ export {
   downloadReport,
   exportImages,
   exportReviews,
+  fetchAggregateCost,
   fetchChangelog,
   fetchReleaseNotes,
   formatChangelogEntry,
@@ -8069,6 +8549,7 @@ export {
   formatJunit,
   formatNotification,
   formatOutput,
+  formatPathLabel,
   formatSlackPayload,
   formatStatusDiff,
   formatStatusSummary,
@@ -8170,8 +8651,14 @@ export {
   removeUser,
   renderJson,
   renderMarkdown,
+  renderPlayStore,
+  renderPlayStoreJson,
+  renderPlayStoreMd,
+  renderPlayStorePrompt,
   renderPrompt,
   replyToReview,
+  resolveAiConfig,
+  resolveLocales,
   revokeSubscriptionPurchase,
   runPreflight,
   runWatchLoop,
@@ -8189,6 +8676,7 @@ export {
   syncInAppProducts,
   topFiles,
   trackBreachState,
+  translateBundle,
   updateAppDetails,
   updateDataSafety,
   updateGrant,