@gpc-cli/core 0.10.6 → 0.10.8

package/dist/index.js

@@ -2686,6 +2686,100 @@ var METRIC_SET_METRICS = {
   ],
   errorCountMetricSet: ["errorReportCount", "distinctUsers"]
 };
+var REQUIRED_DIMENSIONS = {
+  slowStartRateMetricSet: ["startType"],
+  errorCountMetricSet: ["reportType"]
+};
+function withRequiredDimensions(metricSet, query) {
+  const required = REQUIRED_DIMENSIONS[metricSet];
+  if (!required) return query;
+  const dimensions = [...required];
+  for (const dim2 of query.dimensions ?? []) {
+    if (!dimensions.includes(dim2)) dimensions.push(dim2);
+  }
+  return { ...query, dimensions };
+}
+function readMetricValue(row, metric) {
+  const metrics = row?.metrics;
+  if (!metrics || typeof metrics !== "object") return void 0;
+  let entry;
+  if (Array.isArray(metrics)) {
+    entry = metric ? metrics.find((m) => m?.metric === metric) : metrics[0];
+  } else {
+    const map = metrics;
+    const key = metric ?? Object.keys(map)[0];
+    entry = key ? map[key] : void 0;
+  }
+  const raw = entry?.decimalValue?.value;
+  if (raw === void 0) return void 0;
+  const value = Number(raw);
+  return Number.isFinite(value) ? value : void 0;
+}
+function rowDateKey(row) {
+  const t = row.startTime;
+  if (!t) return "";
+  const pad = (n) => String(n ?? 0).padStart(2, "0");
+  return `${t.year ?? 0}-${pad(t.month)}-${pad(t.day)}T${pad(t.hours)}`;
+}
+function rowSliceKey(row) {
+  const dims = row.dimensions;
+  if (!dims || typeof dims !== "object") return "";
+  const pairs = Array.isArray(dims) ? dims.map((d) => [d?.dimension ?? "", d?.stringValue ?? d?.int64Value ?? ""]) : Object.entries(dims).map(([k, d]) => [
+    k,
+    d?.stringValue ?? d?.int64Value ?? ""
+  ]);
+  return JSON.stringify(pairs.sort());
+}
+function latestWorstValue(rows, metric) {
+  if (!rows || rows.length === 0) return void 0;
+  const latest = rows.map(rowDateKey).reduce((a, b) => b > a ? b : a);
+  let worst;
+  for (const row of rows) {
+    if (rowDateKey(row) !== latest) continue;
+    const value = readMetricValue(row, metric);
+    if (value !== void 0 && (worst === void 0 || value > worst)) worst = value;
+  }
+  return worst;
+}
+function worstSliceAverage(rows, metric) {
+  const sums = /* @__PURE__ */ new Map();
+  for (const row of rows ?? []) {
+    const value = readMetricValue(row, metric);
+    if (value === void 0) continue;
+    const key = rowSliceKey(row);
+    const entry = sums.get(key) ?? { total: 0, count: 0 };
+    entry.total += value;
+    entry.count++;
+    sums.set(key, entry);
+  }
+  let worst;
+  for (const { total, count } of sums.values()) {
+    const avg = total / count;
+    if (worst === void 0 || avg > worst) worst = avg;
+  }
+  return worst;
+}
+function assertRateThreshold(label, threshold) {
+  if (!Number.isFinite(threshold) || threshold < 0) {
+    throw new GpcError(
+      `Invalid ${label} threshold: expected a fraction such as 0.02.`,
+      "THRESHOLD_INVALID",
+      2,
+      "Write rates as fractions: 0.02 means 2%."
+    );
+  }
+  if (threshold >= 1) {
+    throw new GpcError(
+      `${label} threshold ${threshold} can never be reached: rates are between 0 and 1.`,
+      "THRESHOLD_INVALID",
+      2,
+      `Write rates as fractions: ${threshold / 100} means ${threshold}%. Check vitals.thresholds in your config too.`
+    );
+  }
+}
+function isGamesOnlyMetricError(err) {
+  return err?.code === "API_METRIC_GAMES_ONLY";
+}
 async function getFreshnessEndDate(reporting, packageName, metricSet, aggregation = "DAILY") {
   try {
     const info = await reporting.getMetricSetFreshness(packageName, metricSet);
@@ -2699,12 +2793,16 @@ async function getFreshnessEndDate(reporting, packageName, metricSet, aggregatio
   }
   return void 0;
 }
+async function latestQueryableEndDate(reporting, packageName, metricSet) {
+  const fallback = new Date(Date.now() - 2 * 24 * 60 * 60 * 1e3);
+  const freshnessEnd = await getFreshnessEndDate(reporting, packageName, metricSet);
+  return freshnessEnd ?? fallback;
+}
 function buildQuery(metricSet, options, freshnessEnd) {
   const metrics = METRIC_SET_METRICS[metricSet] ?? ["errorReportCount", "distinctUsers"];
   const days = options?.days ?? 30;
   const DAY_MS = 24 * 60 * 60 * 1e3;
-  const yesterday = new Date(Date.now() - DAY_MS);
-  const end = freshnessEnd && freshnessEnd < yesterday ? freshnessEnd : yesterday;
+  const end = freshnessEnd ?? new Date(Date.now() - 2 * DAY_MS);
   const start = new Date(end.getTime() - days * DAY_MS);
   const query = {
     metrics,
@@ -2725,7 +2823,7 @@ function buildQuery(metricSet, options, freshnessEnd) {
   if (options?.dimension) {
     query.dimensions = [options.dimension];
   }
-  return query;
+  return withRequiredDimensions(metricSet, query);
 }
 async function queryMetric(reporting, packageName, metricSet, options) {
   const freshnessEnd = await getFreshnessEndDate(
@@ -2761,16 +2859,29 @@ async function getVitalsOverview(reporting, packageName) {
     })
   );
   const overview = {};
+  const unavailable = [];
+  let firstFailure;
+  let succeeded = 0;
   for (let i = 0; i < metricSets.length; i++) {
     const entry = metricSets[i];
-    if (!entry) continue;
-    const key = entry[1];
     const result = results[i];
-    if (!result) continue;
+    if (!entry || !result) continue;
+    const key = entry[1];
     if (result.status === "fulfilled") {
       overview[key] = result.value.rows || [];
+      succeeded++;
+      continue;
     }
+    const err = result.reason;
+    if (!isGamesOnlyMetricError(err)) firstFailure ??= result.reason;
+    unavailable.push({
+      metric: key,
+      code: typeof err?.code === "string" ? err.code : "UNKNOWN_ERROR",
+      reason: isGamesOnlyMetricError(err) ? "Only available for apps categorised as games." : typeof err?.message === "string" ? err.message : String(result.reason)
+    });
   }
+  if (succeeded === 0 && firstFailure !== void 0) throw firstFailure;
+  if (unavailable.length > 0) overview.unavailable = unavailable;
   return overview;
 }
 async function getVitalsCrashes(reporting, packageName, options) {
@@ -2780,8 +2891,7 @@ async function getVitalsAnr(reporting, packageName, options) {
   return queryMetric(reporting, packageName, "anrRateMetricSet", options);
 }
 async function getVitalsStartup(reporting, packageName, options) {
-  const opts = options?.dimension ? options : { ...options, dimension: "startType" };
-  return queryMetric(reporting, packageName, "slowStartRateMetricSet", opts);
+  return queryMetric(reporting, packageName, "slowStartRateMetricSet", options);
 }
 async function getVitalsRendering(reporting, packageName, options) {
   return queryMetric(reporting, packageName, "slowRenderingRateMetricSet", options);
@@ -2811,8 +2921,7 @@ async function getVitalsMemoryBitmap(reporting, packageName, options) {
   });
 }
 async function getVitalsErrorCount(reporting, packageName, options) {
-  const opts = options?.dimension ? options : { ...options, dimension: "reportType" };
-  return queryMetric(reporting, packageName, "errorCountMetricSet", opts);
+  return queryMetric(reporting, packageName, "errorCountMetricSet", options);
 }
 async function getVitalsAnomalies(reporting, packageName) {
   return reporting.getAnomalies(packageName);
@@ -2836,7 +2945,7 @@ async function compareVitalsTrend(reporting, packageName, metricSet, days = 7) {
     month: d.getUTCMonth() + 1,
     day: d.getUTCDate()
   });
-  const makeQuery = (start, end) => ({
+  const makeQuery = (start, end) => withRequiredDimensions(metricSet, {
     metrics,
     timelineSpec: {
       aggregationPeriod: "DAILY",
@@ -2940,7 +3049,8 @@ function watchVitalsWithAutoHalt(reporting, packageName, options) {
     threshold,
     metricSet = "crashRateMetricSet",
     onHalt,
-    onPoll
+    onPoll,
+    onError
   } = options;
   let stopped = false;
   let haltTriggered = false;
@@ -2948,16 +3058,15 @@ function watchVitalsWithAutoHalt(reporting, packageName, options) {
     if (stopped) return;
     try {
       const result = await queryMetric(reporting, packageName, metricSet, { days: 1 });
-      const latestRow = result.rows?.[result.rows.length - 1];
-      const firstMetric = latestRow?.metrics ? Object.keys(latestRow.metrics)[0] : void 0;
-      const value = firstMetric ? Number(latestRow?.metrics[firstMetric]?.decimalValue?.value) : void 0;
+      const value = latestWorstValue(result.rows, METRIC_SET_METRICS[metricSet]?.[0]);
       const breached = value !== void 0 && value > threshold;
       onPoll?.(value, breached);
       if (breached && !haltTriggered && onHalt) {
         haltTriggered = true;
         await onHalt(value);
       }
-    } catch {
+    } catch (err) {
+      onError?.(err);
     }
     if (!stopped) {
       timerId = setTimeout(poll, intervalMs);
@@ -3023,33 +3132,28 @@ var WARN_MARGIN = 0.2;
 function toApiDate(d) {
   return { year: d.getUTCFullYear(), month: d.getUTCMonth() + 1, day: d.getUTCDate() };
 }
-async function queryVitalForStatus(reporting, packageName, metricSet, days, offsetDays = 0) {
+async function queryVitalForStatus(reporting, packageName, metricSet, days, latestEnd, offsetDays = 0) {
   const DAY_MS = 24 * 60 * 60 * 1e3;
-  const baseMs = Date.now() - 2 * DAY_MS - offsetDays * DAY_MS;
+  const baseMs = latestEnd.getTime() - offsetDays * DAY_MS;
   const end = new Date(baseMs);
   const start = new Date(baseMs - days * DAY_MS);
   const metrics = METRIC_SET_METRICS2[metricSet] ?? ["distinctUsers"];
-  const query = {
+  const query = withRequiredDimensions(metricSet, {
     metrics,
     timelineSpec: {
       aggregationPeriod: "DAILY",
       startTime: toApiDate(start),
       endTime: toApiDate(end)
     }
-  };
+  });
   const result = await reporting.queryMetricSet(packageName, metricSet, query);
-  if (!result.rows || result.rows.length === 0) return void 0;
-  const values = result.rows.map((row) => {
-    const firstKey = Object.keys(row.metrics)[0];
-    return firstKey ? Number(row.metrics[firstKey]?.decimalValue?.value) : NaN;
-  }).filter((v) => !isNaN(v));
-  if (values.length === 0) return void 0;
-  return values.reduce((a, b) => a + b, 0) / values.length;
+  return worstSliceAverage(result.rows, metrics[0]);
 }
 async function queryVitalWithTrend(reporting, packageName, metricSet, days) {
+  const latestEnd = await latestQueryableEndDate(reporting, packageName, metricSet);
   const [current, previous] = await Promise.all([
-    queryVitalForStatus(reporting, packageName, metricSet, days, 0),
-    queryVitalForStatus(reporting, packageName, metricSet, days, days)
+    queryVitalForStatus(reporting, packageName, metricSet, days, latestEnd, 0),
+    queryVitalForStatus(reporting, packageName, metricSet, days, latestEnd, days)
   ]);
   let trend = null;
   if (current !== void 0 && previous !== void 0) {
@@ -3147,7 +3251,7 @@ async function getAppStatus(client, reporting, packageName, options = {}) {
   if (slowStartResult.status === "rejected")
     sectionErrors.push(`vitals/slowStarts: ${String(slowStartResult.reason)}`);
   const slowRender = slowRenderResult.status === "fulfilled" ? slowRenderResult.value : SKIPPED_VITAL;
-  if (slowRenderResult.status === "rejected")
+  if (slowRenderResult.status === "rejected" && !isGamesOnlyMetricError(slowRenderResult.reason))
     sectionErrors.push(`vitals/slowRender: ${String(slowRenderResult.reason)}`);
   const rawReviews = reviewsResult.status === "fulfilled" ? reviewsResult.value.reviews : [];
   if (reviewsResult.status === "rejected")
@@ -3528,31 +3632,34 @@ async function queryWatchMetric(reporting, packageName, metric) {
   const metricSet = METRIC_TO_SET[metric];
   const metricKey = METRIC_KEY[metric];
   const DAY_MS = 24 * 60 * 60 * 1e3;
-  const end = new Date(Date.now() - 2 * DAY_MS);
-  const start = new Date(end.getTime() - 7 * DAY_MS);
   const toDate = (d) => ({
     year: d.getUTCFullYear(),
     month: d.getUTCMonth() + 1,
     day: d.getUTCDate()
   });
   try {
-    const result = await reporting.queryMetricSet(packageName, metricSet, {
-      metrics: [metricKey, "distinctUsers"],
-      timelineSpec: {
-        aggregationPeriod: "DAILY",
-        startTime: toDate(start),
-        endTime: toDate(end)
-      }
-    });
-    if (!result.rows || result.rows.length === 0) return void 0;
-    const values = result.rows.map((row) => {
-      const val = row.metrics[metricKey]?.decimalValue?.value;
-      return val !== void 0 ? Number(val) : NaN;
-    }).filter((v) => !isNaN(v));
-    if (values.length === 0) return void 0;
-    return values.reduce((a, b) => a + b, 0) / values.length;
-  } catch {
-    return void 0;
+    const end = await latestQueryableEndDate(reporting, packageName, metricSet);
+    const start = new Date(end.getTime() - 7 * DAY_MS);
+    const result = await reporting.queryMetricSet(
+      packageName,
+      metricSet,
+      withRequiredDimensions(metricSet, {
+        metrics: [metricKey, "distinctUsers"],
+        timelineSpec: {
+          aggregationPeriod: "DAILY",
+          startTime: toDate(start),
+          endTime: toDate(end)
+        }
+      })
+    );
+    return { value: latestWorstValue(result.rows, metricKey) };
+  } catch (err) {
+    const code = err?.code;
+    return {
+      value: void 0,
+      error: typeof code === "string" ? code : err instanceof Error ? err.message : String(err),
+      gamesOnly: isGamesOnlyMetricError(err)
+    };
   }
 }
 async function fetchRollout(client, packageName, track) {
@@ -3631,12 +3738,17 @@ async function runWatch(client, reporting, config, callbacks) {
       "Watch interval must be at least 60 seconds",
       "WATCH_USAGE_ERROR",
       2,
-      "Use --interval 60 or higher. Google vitals data is delayed 24-48h, so frequent polling wastes API quota."
+      "Use --interval 60 or higher. Google vitals data is delayed 2-4 days, so frequent polling wastes API quota."
     );
   }
+  for (const [metric, threshold] of Object.entries(config.thresholds)) {
+    if (metric !== "errorCount" && threshold !== void 0) assertRateThreshold(metric, threshold);
+  }
   let running = true;
   const events = [];
   let breachCount = 0;
+  let unreadableRounds = 0;
+  let lastRoundUnreadable = false;
   let halted = false;
   const startTime = Date.now();
   const cleanup = () => {
@@ -3652,19 +3764,24 @@ async function runWatch(client, reporting, config, callbacks) {
       const vitals = {};
       const metricResults = await Promise.all(
         config.metrics.map(async (metric) => {
-          const value = await queryWatchMetric(reporting, config.packageName, metric);
-          return { metric, value };
+          const reading = await queryWatchMetric(reporting, config.packageName, metric);
+          return { metric, ...reading };
         })
       );
-      for (const { metric, value } of metricResults) {
+      let unreadable = false;
+      for (const { metric, value, error, gamesOnly } of metricResults) {
         const threshold = config.thresholds[metric];
+        if (error && threshold !== void 0 && !gamesOnly) unreadable = true;
         const result = threshold !== void 0 ? checkThreshold(value, threshold) : { breached: false };
         vitals[metric] = {
           value,
           threshold,
-          breached: result.breached
+          breached: result.breached,
+          ...error ? { error } : {}
         };
       }
+      if (unreadable) unreadableRounds++;
+      lastRoundUnreadable = unreadable;
       const breaches = Object.entries(vitals).filter(([, v]) => v.breached).map(([k]) => k);
       const event = {
         round,
@@ -3716,6 +3833,8 @@ async function runWatch(client, reporting, config, callbacks) {
     durationMs: Date.now() - startTime,
     finalRollout: events[events.length - 1]?.rollout?.userFraction ?? null,
     breachCount,
+    unreadableRounds,
+    lastRoundUnreadable,
     halted,
     events
   };
@@ -5411,10 +5530,9 @@ async function advanceTrain(apiClient, reportingClient, packageName) {
   if (state.gates) {
     if (state.gates.crashes?.max !== void 0) {
       const result = await getVitalsCrashes(reportingClient, packageName, { days: 1 });
-      const latestRow = result.rows?.[result.rows.length - 1];
-      const firstMetric = latestRow?.metrics ? Object.keys(latestRow.metrics)[0] : void 0;
-      const value = firstMetric ? Number(latestRow?.metrics[firstMetric]?.decimalValue?.value) : void 0;
-      if (value !== void 0 && value > state.gates.crashes.max / 100) {
+      const value = latestWorstValue(result.rows, "crashRate");
+      if (value === void 0) throw trainGateNoData("Crash", "crashes");
+      if (value > state.gates.crashes.max / 100) {
         state.status = "paused";
         state.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
         await writeTrainState(packageName, state);
@@ -5428,10 +5546,9 @@ async function advanceTrain(apiClient, reportingClient, packageName) {
     }
     if (state.gates.anr?.max !== void 0) {
       const result = await getVitalsAnr(reportingClient, packageName, { days: 1 });
-      const latestRow = result.rows?.[result.rows.length - 1];
-      const firstMetric = latestRow?.metrics ? Object.keys(latestRow.metrics)[0] : void 0;
-      const value = firstMetric ? Number(latestRow?.metrics[firstMetric]?.decimalValue?.value) : void 0;
-      if (value !== void 0 && value > state.gates.anr.max / 100) {
+      const value = latestWorstValue(result.rows, "anrRate");
+      if (value === void 0) throw trainGateNoData("ANR", "anr");
+      if (value > state.gates.anr.max / 100) {
         state.status = "paused";
         state.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
         await writeTrainState(packageName, state);
@@ -5463,6 +5580,14 @@ async function executeStage(apiClient, packageName, state, stageIndex) {
   state.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
   await writeTrainState(packageName, state);
 }
+function trainGateNoData(label, command) {
+  return new GpcError(
+    `${label} gate has no data to check, so the train was not advanced.`,
+    "TRAIN_GATE_NO_DATA",
+    6,
+    `Vitals data often lags 2-4 days. Run the train again later, or check with: gpc vitals ${command} --days 3`
+  );
+}
 
 // src/commands/games.ts
 import { mkdir as mkdir5, readdir as readdir4, readFile as readFile9, writeFile as writeFile5 } from "fs/promises";
@@ -6683,7 +6808,7 @@ var manifestScanner = {
             ruleId: "geofencing-foreground-service",
             severity: "warning",
             title: `Possible geofencing via foreground service "${service.name}"`,
-            message: `Service "${service.name}" uses foregroundServiceType "location" and the app declares ACCESS_BACKGROUND_LOCATION. Google Play no longer approves geofencing as a foreground service use case (sensitive-permissions policy announced April 15, 2026); enforcement for apps targeting Android 17 (API 37+) begins October 28, 2026.`,
+            message: `Service "${service.name}" uses foregroundServiceType "location" and the app declares ACCESS_BACKGROUND_LOCATION. Google Play no longer approves geofencing as a foreground service use case (sensitive-permissions policy announced April 15, 2026).`,
             suggestion: 'If this service performs geofencing, migrate to the Geofencing API (LocationServices.getGeofencingClient) or WorkManager/AlarmManager. If this is legitimate background location tracking (navigation, fitness), suppress this rule via .preflightrc.json: "disabledRules": ["geofencing-foreground-service"].',
             policyUrl: "https://support.google.com/googleplay/android-developer/answer/16926792"
           });
@@ -6773,7 +6898,7 @@ var RESTRICTED_PERMISSIONS = [
     permission: "android.permission.READ_CALL_LOG",
     severity: "critical",
     title: "READ_CALL_LOG requires declaration form",
-    message: "READ_CALL_LOG is restricted to default phone/assistant handler apps. As of July 15, 2026, account verification via phone call is no longer an accepted use case for the Call Log permissions.",
+    message: "READ_CALL_LOG is restricted to default phone/assistant handler apps. From January 27, 2027, account verification via phone call is no longer an accepted use case for the Call Log permissions.",
     suggestion: "Remove READ_CALL_LOG unless your app is a default phone or assistant handler. For phone-number verification, use the Digital Credentials API; for one-time codes, use the SMS Retriever API instead of reading the call log.",
     policyUrl: "https://support.google.com/googleplay/android-developer/answer/10208820"
   },
@@ -6916,14 +7041,14 @@ var permissionsScanner = {
     ].filter((p) => manifest.permissions.includes(p) && !allowed.has(p));
     if (contactsPerms.length > 0) {
       const names = contactsPerms.map((p) => p.split(".").pop()).join(", ");
-      const enforced = manifest.targetSdk >= 37 ? ` Your app targets API ${manifest.targetSdk}, so this is enforced.` : "";
+      const enforced = manifest.targetSdk >= 37 ? ` Your app targets API ${manifest.targetSdk}, so this applies to it.` : "";
       findings.push({
         scanner: "permissions",
         ruleId: "contacts-permission-broad",
         severity: "warning",
         title: "Broad contacts access requires migration to Contact Picker",
-        message: `Your app declares ${names}. Google Play's Contacts Permissions policy requires the Android Contact Picker (Intent.ACTION_PICK_CONTACTS) unless broad access is core to your app. Mandatory for apps targeting Android 17 (API 37+) on October 28, 2026.${enforced}`,
-        suggestion: "Migrate to the Android Contact Picker (Intent.ACTION_PICK_CONTACTS) for user-initiated contact selection, or file a Permissions Declaration Form before October 28, 2026 if the picker cannot serve your core functionality. Remove READ_CONTACTS/WRITE_CONTACTS unless your app is a dialer, messaging, or contacts management app.",
+        message: `Your app declares ${names}. Google Play's Contacts Permissions policy requires the Android Contact Picker (Intent.ACTION_PICK_CONTACTS) unless broad access is core to your app and you submit a Play Console declaration. Mandatory for apps targeting Android 17 (API 37+) on January 27, 2027.${enforced}`,
+        suggestion: "Migrate to the Android Contact Picker (Intent.ACTION_PICK_CONTACTS) for user-initiated contact selection, or submit the contacts declaration in Play Console before January 27, 2027 if the picker cannot serve your core functionality. Remove READ_CONTACTS/WRITE_CONTACTS unless your app is a dialer, messaging, or contacts management app.",
         policyUrl: "https://support.google.com/googleplay/android-developer/answer/16935362"
       });
     }
@@ -6935,8 +7060,8 @@ var permissionsScanner = {
         ruleId: "location-minimal-scope",
         severity: targetsApi37 ? "warning" : "info",
         title: "Precise location \u2014 consider the location button (minimum scope)",
-        message: `Your app declares ACCESS_FINE_LOCATION. Google Play's Location Permissions policy makes the Android location button the recommended minimum scope for transactional (one-time) precise location. Mandatory for apps targeting Android 17 (API 37+) on October 28, 2026.${targetsApi37 ? ` Your app targets API ${manifest.targetSdk}.` : ""}`,
-        suggestion: 'For one-time/transactional precise location, use the system location button instead of requesting ACCESS_FINE_LOCATION up front. Only keep continuous fine location if navigation, fitness, or a similar feature is core functionality. Suppress via .preflightrc.json "disabledRules": ["location-minimal-scope"] if fine location is essential.',
+        message: `Your app declares ACCESS_FINE_LOCATION. Google Play's Location Permissions policy requires the Android location button for one-time or infrequent precise location, and a Play Console declaration explaining why coarse location or the location button is not enough. Mandatory for apps targeting Android 17 (API 37+) on January 27, 2027.${targetsApi37 ? ` Your app targets API ${manifest.targetSdk}.` : ""}`,
+        suggestion: 'For one-time/transactional precise location, use the system location button instead of requesting ACCESS_FINE_LOCATION up front. Only keep continuous fine location if navigation, fitness, or a similar feature is core functionality, and complete the precise location declaration in Play Console. Suppress via .preflightrc.json "disabledRules": ["location-minimal-scope"] if fine location is essential.',
         policyUrl: "https://support.google.com/googleplay/android-developer/answer/17033915"
       });
     }
@@ -10404,6 +10529,7 @@ export {
   analyzeReviews2 as analyzeReviews,
   annotateListResult,
   applyReleaseNotes,
+  assertRateThreshold,
   assignRelease,
   batchGetOrders,
   batchSyncInAppProducts,
@@ -10558,6 +10684,7 @@ export {
   isValidStatsDimension,
   isVersionedNotesDir,
   isZip,
+  latestWorstValue,
   lintListing,
   lintListings,
   lintLocalListings,
@@ -10609,6 +10736,7 @@ export {
   pushLeaderboardConfigs,
   pushListings,
   readListingsFromDir,
+  readMetricValue,
   readReleaseNotesForVersion,
   readReleaseNotesFromDir,
   readinessBadgeColor,
@@ -10698,6 +10826,7 @@ export {
   waitForBundleProcessing,
   watchVitalsWithAutoHalt,
   wordDiff,
+  worstSliceAverage,
   writeAuditLog,
   writeListingsToDir,
   writeMigrationOutput