@gpc-cli/core 0.9.52 → 0.9.54

package/README.md

@@ -60,6 +60,7 @@ const analysis = await analyzeBundle("./app.aab");
 | **Testers**       | `listTesters`, `addTesters`, `removeTesters`, `importTestersFromCsv`                                                |
 | **Bundle**        | `analyzeBundle`, `compareBundles` (zero-dependency AAB/APK size analysis)                                           |
 | **Publishing**    | `publish` (end-to-end: upload + track + notes + commit)                                                             |
+| **Changelog**     | `generateChangelog`, `fetchChangelog`, `formatChangelogEntry`, `buildLocaleBundle`, `renderPlayStore`, `renderMarkdown`, `renderJson`, `renderPrompt`, `translateBundle`, `resolveLocales` |
 | **Validation**    | `validateUploadFile`, `validateImage`, `validatePreSubmission`                                                      |
 
 ## Utilities

package/dist/index.d.ts

@@ -109,6 +109,7 @@ interface AppInfo {
 }
 declare function getAppInfo(client: PlayApiClient, packageName: string): Promise<AppInfo>;
 
+declare function waitForBundleProcessing(client: PlayApiClient, packageName: string, editId: string, versionCode: number, backoff?: number[]): Promise<void>;
 interface UploadResult {
     versionCode: number;
     track: string;
@@ -183,6 +184,19 @@ declare function fetchReleaseNotes(client: PlayApiClient, packageName: string, t
     language: string;
     text: string;
 }[]>;
+interface ApplyReleaseNotesResult {
+    track: string;
+    versionCodes: string[];
+    localeCount: number;
+    releaseNotes: {
+        language: string;
+        text: string;
+    }[];
+}
+declare function applyReleaseNotes(client: PlayApiClient, packageName: string, track: string, releaseNotes: {
+    language: string;
+    text: string;
+}[], commitOptions?: EditCommitOptions): Promise<ApplyReleaseNotesResult>;
 interface ReleaseDiff {
     field: string;
     track1Value: string;
@@ -1323,15 +1337,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 +1396,27 @@ 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>;
+declare function validateBundleForApply(bundle: LocaleBundle): string[];
+declare function bundleToReleaseNotes(bundle: LocaleBundle): {
+    language: string;
+    text: string;
+}[];
 
 type Renderer = (g: GeneratedChangelog) => string;
 declare const RENDERERS: Record<OutputMode, Renderer>;
@@ -1409,4 +1472,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 ApplyReleaseNotesResult, 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, applyReleaseNotes, batchGetOrders, batchSyncInAppProducts, buildLocaleBundle, bundleToReleaseNotes, 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, validateBundleForApply, validateImage, validateLanguageCode, validatePackageName, validatePreSubmission, validateReleaseNotes, validateSku, validateTrackName, validateUploadFile, validateVersionCode, waitForBundleProcessing, watchVitalsWithAutoHalt, wordDiff, writeAuditLog, writeListingsToDir, writeMigrationOutput };

package/dist/index.js

@@ -650,6 +650,20 @@ function formatSize(bytes) {
 }
 
 // src/commands/releases.ts
+var BUNDLE_POLL_BACKOFF = [2e3, 3e3, 5e3, 8e3, 13e3];
+async function waitForBundleProcessing(client, packageName, editId, versionCode, backoff = BUNDLE_POLL_BACKOFF) {
+  for (let i = 0; i < backoff.length; i++) {
+    const bundles = await client.bundles.list(packageName, editId);
+    if (bundles.some((b) => b.versionCode === versionCode)) return;
+    await new Promise((r) => setTimeout(r, backoff[i]));
+  }
+  throw new GpcError(
+    `Bundle versionCode ${versionCode} not ready after ${backoff.length} poll attempts (~${Math.round(backoff.reduce((a, b) => a + b, 0) / 1e3)}s)`,
+    "BUNDLE_PROCESSING_TIMEOUT",
+    4,
+    "The AAB is still being processed by Google. Retry the upload, or use --status draft and commit later."
+  );
+}
 async function withRetryOnConflict(client, packageName, operation) {
   const edit = await client.edits.insert(packageName);
   try {
@@ -763,6 +777,9 @@ ${validation.errors.join("\n")}`,
       uploadOpts,
       options.deviceTierConfigId
     );
+    if (!isApk) {
+      await waitForBundleProcessing(client, packageName, edit.id, bundle.versionCode);
+    }
     if (options.mappingFile) {
       await client.deobfuscation.upload(
         packageName,
@@ -1023,6 +1040,35 @@ async function fetchReleaseNotes(client, packageName, track) {
     });
   }
 }
+async function applyReleaseNotes(client, packageName, track, releaseNotes, commitOptions) {
+  return withRetryOnConflict(client, packageName, async (edit) => {
+    const trackData = await client.tracks.get(packageName, edit.id, track);
+    const draft = trackData.releases?.find((r) => r.status === "draft");
+    if (!draft) {
+      throw new GpcError(
+        `No draft release found on track "${track}"`,
+        "RELEASE_NO_DRAFT",
+        1,
+        `Upload an AAB/APK first to create a draft, or check the --track value. Current track: "${track}".`
+      );
+    }
+    const patched = {
+      ...draft,
+      releaseNotes
+    };
+    await client.tracks.update(packageName, edit.id, track, patched);
+    if (!commitOptions?.changesNotSentForReview) {
+      await client.edits.validate(packageName, edit.id);
+    }
+    await client.edits.commit(packageName, edit.id, commitOptions);
+    return {
+      track,
+      versionCodes: draft.versionCodes || [],
+      localeCount: releaseNotes.length,
+      releaseNotes
+    };
+  });
+}
 async function diffReleases(client, packageName, fromTrack, toTrack) {
   const edit = await client.edits.insert(packageName);
   try {
@@ -7377,7 +7423,16 @@ var KNOWN_TYPES = /* @__PURE__ */ new Set([
   "release"
 ]);
 var FILTERED_TYPES = /* @__PURE__ */ new Set(["chore", "refactor", "test", "build", "style", "merge"]);
-var SECTION_ORDER = ["breaking", "feat", "fix", "perf", "docs", "ci", "release", "other"];
+var SECTION_ORDER = [
+  "breaking",
+  "feat",
+  "fix",
+  "perf",
+  "docs",
+  "ci",
+  "release",
+  "other"
+];
 var FIXUP_PATTERNS = [
   /^wip\b/i,
   /^fix\s+typo\b/i,
@@ -7841,14 +7896,18 @@ function renderPrompt(g) {
   if (g.headlineCandidates.length > 0) {
     lines.push("HEADLINE CANDIDATES (largest first):");
     for (const c of g.headlineCandidates) {
-      lines.push(`  ${c.label} (weight ${c.weight}, ${c.commits.length} commits, primary ${c.primaryType})`);
+      lines.push(
+        `  ${c.label} (weight ${c.weight}, ${c.commits.length} commits, primary ${c.primaryType})`
+      );
     }
     lines.push("");
   }
   lines.push("CLUSTERED COMMITS:");
   lines.push("");
   for (const cluster of g.clusters) {
-    lines.push(`[cluster: ${cluster.label}, weight ${cluster.weight}, ${cluster.commits.length} commits, primary ${cluster.primaryType}]`);
+    lines.push(
+      `[cluster: ${cluster.label}, weight ${cluster.weight}, ${cluster.commits.length} commits, primary ${cluster.primaryType}]`
+    );
     for (const commit of cluster.commits) {
       lines.push(`- ${commit.type}: ${safeLine(commit.subject)} (${commit.sha.slice(0, 7)})`);
       if (commit.files.length > 0) {
@@ -7881,9 +7940,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();
 }
@@ -7989,7 +8218,9 @@ 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(
+    `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}`);
@@ -8000,7 +8231,9 @@ function renderPlayStorePrompt(bundle, g) {
   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(
+    "- 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("```");
@@ -8038,6 +8271,103 @@ 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;
+}
+function validateBundleForApply(bundle) {
+  const errors = [];
+  for (const entry of bundle.locales) {
+    if (entry.status === "placeholder") {
+      errors.push(`${entry.language}: untranslated placeholder \u2014 use --ai or remove this locale`);
+    }
+    if (entry.status === "failed") {
+      errors.push(`${entry.language}: translation failed \u2014 retry or remove this locale`);
+    }
+  }
+  return errors;
+}
+function bundleToReleaseNotes(bundle) {
+  return bundle.locales.filter((e) => e.status !== "placeholder" && e.status !== "failed").map((e) => ({ language: e.language, text: e.text }));
+}
 
 // src/commands/changelog-renderers/index.ts
 var RENDERERS = {
@@ -8204,6 +8534,7 @@ export {
   ApiError,
   ConfigError,
   DEFAULT_LIMITS,
+  DEFAULT_MODELS,
   DEFAULT_PREFLIGHT_CONFIG,
   GOOGLE_PLAY_LANGUAGES,
   GpcError,
@@ -8211,6 +8542,7 @@ export {
   PERMISSION_PROPAGATION_WARNING,
   PLACEHOLDER_TEXT,
   PLAY_STORE_LIMIT,
+  PROVIDER_WHITELIST,
   PluginManager,
   RENDERERS,
   SECTION_ORDER,
@@ -8227,14 +8559,17 @@ export {
   analyzeBundle,
   analyzeRemoteListings,
   analyzeReviews2 as analyzeReviews,
+  applyReleaseNotes,
   batchGetOrders,
   batchSyncInAppProducts,
   buildLocaleBundle,
+  bundleToReleaseNotes,
   cancelRecoveryAction,
   cancelSubscriptionPurchase,
   cancelSubscriptionV2,
   checkBundleSize,
   checkThreshold,
+  classifyError,
   clearAuditLog,
   compareBundles,
   compareVersionVitals,
@@ -8255,6 +8590,7 @@ export {
   createSpinner,
   createSubscription,
   createTrack,
+  createTranslator,
   deactivateBasePlan,
   deactivateOffer,
   decodeNotification,
@@ -8284,6 +8620,7 @@ export {
   downloadReport,
   exportImages,
   exportReviews,
+  fetchAggregateCost,
   fetchChangelog,
   fetchReleaseNotes,
   formatChangelogEntry,
@@ -8292,6 +8629,7 @@ export {
   formatJunit,
   formatNotification,
   formatOutput,
+  formatPathLabel,
   formatSlackPayload,
   formatStatusDiff,
   formatStatusSummary,
@@ -8399,6 +8737,7 @@ export {
   renderPlayStorePrompt,
   renderPrompt,
   replyToReview,
+  resolveAiConfig,
   resolveLocales,
   revokeSubscriptionPurchase,
   runPreflight,
@@ -8417,6 +8756,7 @@ export {
   syncInAppProducts,
   topFiles,
   trackBreachState,
+  translateBundle,
   updateAppDetails,
   updateDataSafety,
   updateGrant,
@@ -8433,6 +8773,7 @@ export {
   uploadImage,
   uploadInternalSharing,
   uploadRelease,
+  validateBundleForApply,
   validateImage,
   validateLanguageCode,
   validatePackageName,
@@ -8442,6 +8783,7 @@ export {
   validateTrackName,
   validateUploadFile,
   validateVersionCode,
+  waitForBundleProcessing,
   watchVitalsWithAutoHalt,
   wordDiff,
   writeAuditLog,