@gpc-cli/core 0.9.23 → 0.9.24

package/dist/index.d.ts

@@ -737,6 +737,8 @@ interface StatusVitalMetric {
     value: number | undefined;
     threshold: number;
     status: "ok" | "warn" | "breach" | "unknown";
+    previousValue?: number | undefined;
+    trend?: "up" | "down" | "flat" | null;
 }
 interface StatusRelease {
     track: string;
@@ -765,8 +767,34 @@ interface AppStatus {
     };
     reviews: StatusReviews;
 }
+interface StatusDiff {
+    versionCode: {
+        from: string | null;
+        to: string | null;
+    };
+    crashRate: {
+        from: number | null;
+        to: number | null;
+        delta: number | null;
+    };
+    anrRate: {
+        from: number | null;
+        to: number | null;
+        delta: number | null;
+    };
+    reviewCount: {
+        from: number | null;
+        to: number | null;
+    };
+    averageRating: {
+        from: number | null;
+        to: number | null;
+        delta: number | null;
+    };
+}
 interface GetAppStatusOptions {
     days?: number;
+    sections?: string[];
     vitalThresholds?: {
         crashRate?: number;
         anrRate?: number;
@@ -774,10 +802,23 @@ interface GetAppStatusOptions {
         slowRenderingRate?: number;
     };
 }
+interface WatchOptions {
+    intervalSeconds: number;
+    render: (status: AppStatus) => string;
+    fetch: () => Promise<AppStatus>;
+    save: (status: AppStatus) => Promise<void>;
+}
 declare function loadStatusCache(packageName: string, ttlSeconds?: number): Promise<AppStatus | null>;
 declare function saveStatusCache(packageName: string, data: AppStatus, ttlSeconds?: number): Promise<void>;
 declare function getAppStatus(client: PlayApiClient, reporting: ReportingApiClient, packageName: string, options?: GetAppStatusOptions): Promise<AppStatus>;
 declare function formatStatusTable(status: AppStatus): string;
+declare function formatStatusSummary(status: AppStatus): string;
+declare function computeStatusDiff(prev: AppStatus, curr: AppStatus): StatusDiff;
+declare function formatStatusDiff(diff: StatusDiff, since: string): string;
+declare function runWatchLoop(opts: WatchOptions): Promise<void>;
+/** Returns true if breach state changed (breach started or cleared). */
+declare function trackBreachState(packageName: string, isBreaching: boolean): Promise<boolean>;
+declare function sendNotification(title: string, body: string): void;
 declare function statusHasBreach(status: AppStatus): boolean;
 
-export { ApiError, type AppInfo, type AppStatus, type AuditEntry, type BatchSyncResult, type BundleAnalysis, type BundleComparison, type BundleEntry, type CommandContext, ConfigError, type DiscoverPluginsOptions, type DryRunPublishResult, type DryRunResult, type DryRunUploadResult, type ExportImagesOptions, type ExportImagesSummary, type FastlaneDetection, type FastlaneLane, type FileValidationResult, GOOGLE_PLAY_LANGUAGES, type GetAppStatusOptions, type GitNotesOptions, type GitReleaseNotes, GpcError, type ImageValidationResult, type InternalSharingUploadResult, type ListIapOptions, type ListSubscriptionsOptions, type ListUsersOptions, type ListVoidedOptions, type ListingDiff, type ListingsResult, type LoadedPlugin, type MigrationResult, NetworkError, type OneTimeProductDiff, PERMISSION_PROPAGATION_WARNING, type ParsedMonth, PluginManager, type PublishOptions, type PublishResult, type PushResult, type ReleaseDiff, type ReleaseNotesValidation, type ReleaseStatusResult, type ReviewExportOptions, type ReviewsFilterOptions, SENSITIVE_ARG_KEYS, SENSITIVE_KEYS, type ScaffoldOptions, type ScaffoldResult, type Spinner, type StatusRelease, type StatusReviews, type StatusVitalMetric, type SubscriptionDiff, type SyncResult, type ThresholdResult, type UploadResult, type ValidateCheck, type ValidateOptions, type ValidateResult, type VitalsOverview, type VitalsQueryOptions, type VitalsTrendComparison, type WebhookPayload, acknowledgeProductPurchase, activateBasePlan, activateOffer, activatePurchaseOption, addRecoveryTargeting, addTesters, analyzeBundle, batchSyncInAppProducts, cancelRecoveryAction, cancelSubscriptionPurchase, checkThreshold, clearAuditLog, compareBundles, compareVitalsTrend, consumeProductPurchase, convertRegionPrices, createAuditEntry, createDeviceTier, createExternalTransaction, createInAppProduct, createOffer, createOneTimeOffer, createOneTimeProduct, createPurchaseOption, createRecoveryAction, createSpinner, createSubscription, createTrack, deactivateBasePlan, deactivateOffer, deactivatePurchaseOption, deferSubscriptionPurchase, deleteBasePlan, deleteImage, deleteInAppProduct, deleteListing, deleteOffer, deleteOneTimeOffer, deleteOneTimeProduct, deleteSubscription, deployRecoveryAction, detectFastlane, detectOutputFormat, diffListings, diffListingsCommand, diffOneTimeProduct, diffReleases, diffSubscription, discoverPlugins, downloadGeneratedApk, downloadReport, exportDataSafety, exportImages, exportReviews, formatCustomPayload, formatDiscordPayload, formatJunit, formatOutput, formatSlackPayload, formatStatusTable, generateMigrationPlan, generateNotesFromGit, getAppInfo, getAppStatus, getCountryAvailability, getDataSafety, getDeviceTier, getExternalTransaction, getInAppProduct, getListings, getOffer, getOneTimeOffer, getOneTimeProduct, getProductPurchase, getPurchaseOption, getReleasesStatus, getReview, getSubscription, getSubscriptionPurchase, getUser, getVitalsAnomalies, getVitalsAnr, getVitalsBattery, getVitalsCrashes, getVitalsMemory, getVitalsOverview, getVitalsRendering, getVitalsStartup, importDataSafety, importTestersFromCsv, initAudit, inviteUser, isFinancialReportType, isStatsReportType, isValidBcp47, isValidReportType, isValidStatsDimension, listAuditEvents, listDeviceTiers, listGeneratedApks, listImages, listInAppProducts, listOffers, listOneTimeOffers, listOneTimeProducts, listPurchaseOptions, listRecoveryActions, listReports, listReviews, listSubscriptions, listTesters, listTracks, listUsers, listVoidedPurchases, loadStatusCache, migratePrices, parseAppfile, parseFastfile, parseGrantArg, parseMonth, promoteRelease, publish, pullListings, pushListings, readListingsFromDir, readReleaseNotesFromDir, redactAuditArgs, redactSensitive, refundExternalTransaction, refundOrder, removeTesters, removeUser, replyToReview, revokeSubscriptionPurchase, safePath, safePathWithin, saveStatusCache, scaffoldPlugin, searchAuditEvents, searchVitalsErrors, sendWebhook, sortResults, statusHasBreach, syncInAppProducts, updateAppDetails, updateDataSafety, updateInAppProduct, updateListing, updateOffer, updateOneTimeOffer, updateOneTimeProduct, updateRollout, updateSubscription, updateTrackConfig, updateUser, uploadExternallyHosted, uploadImage, uploadInternalSharing, uploadRelease, validateImage, validateLanguageCode, validatePackageName, validatePreSubmission, validateReleaseNotes, validateSku, validateTrackName, validateUploadFile, validateVersionCode, writeAuditLog, writeListingsToDir, writeMigrationOutput };
+export { ApiError, type AppInfo, type AppStatus, type AuditEntry, type BatchSyncResult, type BundleAnalysis, type BundleComparison, type BundleEntry, type CommandContext, ConfigError, type DiscoverPluginsOptions, type DryRunPublishResult, type DryRunResult, type DryRunUploadResult, type ExportImagesOptions, type ExportImagesSummary, type FastlaneDetection, type FastlaneLane, type FileValidationResult, GOOGLE_PLAY_LANGUAGES, type GetAppStatusOptions, type GitNotesOptions, type GitReleaseNotes, GpcError, type ImageValidationResult, type InternalSharingUploadResult, type ListIapOptions, type ListSubscriptionsOptions, type ListUsersOptions, type ListVoidedOptions, type ListingDiff, type ListingsResult, type LoadedPlugin, type MigrationResult, NetworkError, type OneTimeProductDiff, PERMISSION_PROPAGATION_WARNING, type ParsedMonth, PluginManager, type PublishOptions, type PublishResult, type PushResult, type ReleaseDiff, type ReleaseNotesValidation, type ReleaseStatusResult, type ReviewExportOptions, type ReviewsFilterOptions, SENSITIVE_ARG_KEYS, SENSITIVE_KEYS, type ScaffoldOptions, type ScaffoldResult, type Spinner, type StatusDiff, type StatusRelease, type StatusReviews, type StatusVitalMetric, type SubscriptionDiff, type SyncResult, type ThresholdResult, type UploadResult, type ValidateCheck, type ValidateOptions, type ValidateResult, type VitalsOverview, type VitalsQueryOptions, type VitalsTrendComparison, type WatchOptions, type WebhookPayload, acknowledgeProductPurchase, activateBasePlan, activateOffer, activatePurchaseOption, addRecoveryTargeting, addTesters, analyzeBundle, batchSyncInAppProducts, cancelRecoveryAction, cancelSubscriptionPurchase, checkThreshold, clearAuditLog, compareBundles, compareVitalsTrend, computeStatusDiff, consumeProductPurchase, convertRegionPrices, createAuditEntry, createDeviceTier, createExternalTransaction, createInAppProduct, createOffer, createOneTimeOffer, createOneTimeProduct, createPurchaseOption, createRecoveryAction, createSpinner, createSubscription, createTrack, deactivateBasePlan, deactivateOffer, deactivatePurchaseOption, deferSubscriptionPurchase, deleteBasePlan, deleteImage, deleteInAppProduct, deleteListing, deleteOffer, deleteOneTimeOffer, deleteOneTimeProduct, deleteSubscription, deployRecoveryAction, detectFastlane, detectOutputFormat, diffListings, diffListingsCommand, diffOneTimeProduct, diffReleases, diffSubscription, discoverPlugins, downloadGeneratedApk, downloadReport, exportDataSafety, exportImages, exportReviews, formatCustomPayload, formatDiscordPayload, formatJunit, formatOutput, formatSlackPayload, formatStatusDiff, formatStatusSummary, formatStatusTable, generateMigrationPlan, generateNotesFromGit, getAppInfo, getAppStatus, getCountryAvailability, getDataSafety, getDeviceTier, getExternalTransaction, getInAppProduct, getListings, getOffer, getOneTimeOffer, getOneTimeProduct, getProductPurchase, getPurchaseOption, getReleasesStatus, getReview, getSubscription, getSubscriptionPurchase, getUser, getVitalsAnomalies, getVitalsAnr, getVitalsBattery, getVitalsCrashes, getVitalsMemory, getVitalsOverview, getVitalsRendering, getVitalsStartup, importDataSafety, importTestersFromCsv, initAudit, inviteUser, isFinancialReportType, isStatsReportType, isValidBcp47, isValidReportType, isValidStatsDimension, listAuditEvents, listDeviceTiers, listGeneratedApks, listImages, listInAppProducts, listOffers, listOneTimeOffers, listOneTimeProducts, listPurchaseOptions, listRecoveryActions, listReports, listReviews, listSubscriptions, listTesters, listTracks, listUsers, listVoidedPurchases, loadStatusCache, migratePrices, parseAppfile, parseFastfile, parseGrantArg, parseMonth, promoteRelease, publish, pullListings, pushListings, readListingsFromDir, readReleaseNotesFromDir, redactAuditArgs, redactSensitive, refundExternalTransaction, refundOrder, removeTesters, removeUser, replyToReview, revokeSubscriptionPurchase, runWatchLoop, safePath, safePathWithin, saveStatusCache, scaffoldPlugin, searchAuditEvents, searchVitalsErrors, sendNotification, sendWebhook, sortResults, statusHasBreach, syncInAppProducts, trackBreachState, updateAppDetails, updateDataSafety, updateInAppProduct, updateListing, updateOffer, updateOneTimeOffer, updateOneTimeProduct, updateRollout, updateSubscription, updateTrackConfig, updateUser, uploadExternallyHosted, uploadImage, uploadInternalSharing, uploadRelease, validateImage, validateLanguageCode, validatePackageName, validatePreSubmission, validateReleaseNotes, validateSku, validateTrackName, validateUploadFile, validateVersionCode, writeAuditLog, writeListingsToDir, writeMigrationOutput };

package/dist/index.js

@@ -39,9 +39,9 @@ var NetworkError = class extends GpcError {
 };
 
 // src/output.ts
-import process from "process";
+import process2 from "process";
 function detectOutputFormat() {
-  return process.stdout.isTTY ? "table" : "json";
+  return process2.stdout.isTTY ? "table" : "json";
 }
 function formatOutput(data, format, redact = true) {
   const safe = redact ? redactSensitive(data) : data;
@@ -3183,23 +3183,23 @@ async function deleteOneTimeOffer(client, packageName, productId, offerId) {
 }
 
 // src/utils/spinner.ts
-import process2 from "process";
+import process3 from "process";
 var FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
 var INTERVAL_MS = 80;
 function createSpinner(message) {
-  const isTTY = process2.stderr.isTTY === true;
+  const isTTY = process3.stderr.isTTY === true;
   let frameIndex = 0;
   let timer;
   let currentMessage = message;
   let started = false;
   function clearLine() {
     if (isTTY) {
-      process2.stderr.write("\r\x1B[K");
+      process3.stderr.write("\r\x1B[K");
     }
   }
   function renderFrame() {
     const frame = FRAMES[frameIndex % FRAMES.length];
-    process2.stderr.write(`\r\x1B[K${frame} ${currentMessage}`);
+    process3.stderr.write(`\r\x1B[K${frame} ${currentMessage}`);
     frameIndex++;
   }
   return {
@@ -3207,7 +3207,7 @@ function createSpinner(message) {
       if (started) return;
       started = true;
       if (!isTTY) {
-        process2.stderr.write(`${currentMessage}
+        process3.stderr.write(`${currentMessage}
 `);
         return;
       }
@@ -3222,10 +3222,10 @@ function createSpinner(message) {
       const text = msg ?? currentMessage;
       if (isTTY) {
         clearLine();
-        process2.stderr.write(`\u2714 ${text}
+        process3.stderr.write(`\u2714 ${text}
 `);
       } else if (!started) {
-        process2.stderr.write(`${text}
+        process3.stderr.write(`${text}
 `);
       }
       started = false;
@@ -3238,10 +3238,10 @@ function createSpinner(message) {
       const text = msg ?? currentMessage;
       if (isTTY) {
         clearLine();
-        process2.stderr.write(`\u2718 ${text}
+        process3.stderr.write(`\u2718 ${text}
 `);
       } else if (!started) {
-        process2.stderr.write(`${text}
+        process3.stderr.write(`${text}
 `);
       }
       started = false;
@@ -3975,6 +3975,7 @@ function compareBundles(before, after) {
 
 // src/commands/status.ts
 import { mkdir as mkdir5, readFile as readFile10, writeFile as writeFile7 } from "fs/promises";
+import { execSync } from "child_process";
 import { join as join7 } from "path";
 import { getCacheDir } from "@gpc-cli/config";
 var DEFAULT_TTL_SECONDS = 3600;
@@ -3996,12 +3997,11 @@ async function saveStatusCache(packageName, data, ttlSeconds = DEFAULT_TTL_SECON
   try {
     const dir = getCacheDir();
     await mkdir5(dir, { recursive: true });
-    const entry = {
-      fetchedAt: data.fetchedAt,
-      ttl: ttlSeconds,
-      data
-    };
-    await writeFile7(cacheFilePath(packageName), JSON.stringify(entry, null, 2), { encoding: "utf-8", mode: 384 });
+    const entry = { fetchedAt: data.fetchedAt, ttl: ttlSeconds, data };
+    await writeFile7(cacheFilePath(packageName), JSON.stringify(entry, null, 2), {
+      encoding: "utf-8",
+      mode: 384
+    });
   } catch {
   }
 }
@@ -4021,9 +4021,9 @@ 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) {
+async function queryVitalForStatus(reporting, packageName, metricSet, days, offsetDays = 0) {
   const DAY_MS = 24 * 60 * 60 * 1e3;
-  const baseMs = Date.now() - 2 * DAY_MS;
+  const baseMs = Date.now() - 2 * DAY_MS - offsetDays * DAY_MS;
   const end = new Date(baseMs);
   const start = new Date(baseMs - days * DAY_MS);
   const metrics = METRIC_SET_METRICS2[metricSet] ?? ["distinctUsers"];
@@ -4044,13 +4044,26 @@ async function queryVitalForStatus(reporting, packageName, metricSet, days) {
   if (values.length === 0) return void 0;
   return values.reduce((a, b) => a + b, 0) / values.length;
 }
-function toVitalMetric(value, threshold) {
-  if (value === void 0) {
-    return { value: void 0, threshold, status: "unknown" };
-  }
-  if (value > threshold) return { value, threshold, status: "breach" };
-  if (value > threshold * (1 - WARN_MARGIN)) return { value, threshold, status: "warn" };
-  return { value, threshold, status: "ok" };
+async function queryVitalWithTrend(reporting, packageName, metricSet, days) {
+  const [current, previous] = await Promise.all([
+    queryVitalForStatus(reporting, packageName, metricSet, days, 0),
+    queryVitalForStatus(reporting, packageName, metricSet, days, days)
+  ]);
+  let trend = null;
+  if (current !== void 0 && previous !== void 0) {
+    if (current > previous) trend = "up";
+    else if (current < previous) trend = "down";
+    else trend = "flat";
+  }
+  return { current, previous, trend };
+}
+var SKIPPED_VITAL = { current: void 0, previous: void 0, trend: null };
+function toVitalMetric(value, threshold, previousValue, trend) {
+  const base = previousValue !== void 0 ? { value, threshold, status: "unknown", previousValue, trend: trend ?? null } : { value, threshold, status: "unknown" };
+  if (value === void 0) return { ...base, status: "unknown" };
+  if (value > threshold) return { ...base, status: "breach" };
+  if (value > threshold * (1 - WARN_MARGIN)) return { ...base, status: "warn" };
+  return { ...base, status: "ok" };
 }
 function computeReviewSentiment(reviews, windowDays) {
   const now = Date.now();
@@ -4089,6 +4102,7 @@ function computeReviewSentiment(reviews, windowDays) {
 }
 async function getAppStatus(client, reporting, packageName, options = {}) {
   const days = options.days ?? 7;
+  const sections = new Set(options.sections ?? ["releases", "vitals", "reviews"]);
   const thresholds = {
     crashRate: options.vitalThresholds?.crashRate ?? DEFAULT_THRESHOLDS.crashRate,
     anrRate: options.vitalThresholds?.anrRate ?? DEFAULT_THRESHOLDS.anrRate,
@@ -4096,12 +4110,12 @@ async function getAppStatus(client, reporting, packageName, options = {}) {
     slowRenderingRate: options.vitalThresholds?.slowRenderingRate ?? DEFAULT_THRESHOLDS.slowRenderingRate
   };
   const [releasesResult, crashesResult, anrResult, slowStartResult, slowRenderResult, reviewsResult] = await Promise.allSettled([
-    getReleasesStatus(client, packageName),
-    queryVitalForStatus(reporting, packageName, "crashRateMetricSet", days),
-    queryVitalForStatus(reporting, packageName, "anrRateMetricSet", days),
-    queryVitalForStatus(reporting, packageName, "slowStartRateMetricSet", days),
-    queryVitalForStatus(reporting, packageName, "slowRenderingRateMetricSet", days),
-    listReviews(client, packageName, { maxResults: 500 })
+    sections.has("releases") ? getReleasesStatus(client, packageName) : Promise.resolve([]),
+    sections.has("vitals") ? queryVitalWithTrend(reporting, packageName, "crashRateMetricSet", days) : Promise.resolve(SKIPPED_VITAL),
+    sections.has("vitals") ? queryVitalWithTrend(reporting, packageName, "anrRateMetricSet", days) : Promise.resolve(SKIPPED_VITAL),
+    sections.has("vitals") ? queryVitalWithTrend(reporting, packageName, "slowStartRateMetricSet", days) : Promise.resolve(SKIPPED_VITAL),
+    sections.has("vitals") ? queryVitalWithTrend(reporting, packageName, "slowRenderingRateMetricSet", days) : Promise.resolve(SKIPPED_VITAL),
+    sections.has("reviews") ? listReviews(client, packageName, { maxResults: 500 }) : Promise.resolve([])
   ]);
   const rawReleases = releasesResult.status === "fulfilled" ? releasesResult.value : [];
   const releases = rawReleases.map((r) => ({
@@ -4110,36 +4124,49 @@ async function getAppStatus(client, reporting, packageName, options = {}) {
     status: r.status,
     userFraction: r.userFraction ?? null
   }));
-  const crashValue = crashesResult.status === "fulfilled" ? crashesResult.value : void 0;
-  const anrValue = anrResult.status === "fulfilled" ? anrResult.value : void 0;
-  const slowStartValue = slowStartResult.status === "fulfilled" ? slowStartResult.value : void 0;
-  const slowRenderValue = slowRenderResult.status === "fulfilled" ? slowRenderResult.value : void 0;
+  const crashes = crashesResult.status === "fulfilled" ? crashesResult.value : SKIPPED_VITAL;
+  const anr = anrResult.status === "fulfilled" ? anrResult.value : SKIPPED_VITAL;
+  const slowStart = slowStartResult.status === "fulfilled" ? slowStartResult.value : SKIPPED_VITAL;
+  const slowRender = slowRenderResult.status === "fulfilled" ? slowRenderResult.value : SKIPPED_VITAL;
   const rawReviews = reviewsResult.status === "fulfilled" ? reviewsResult.value : [];
   const reviews = computeReviewSentiment(rawReviews, 30);
-  const fetchedAt = (/* @__PURE__ */ new Date()).toISOString();
   return {
     packageName,
-    fetchedAt,
+    fetchedAt: (/* @__PURE__ */ new Date()).toISOString(),
     cached: false,
     releases,
     vitals: {
       windowDays: days,
-      crashes: toVitalMetric(crashValue, thresholds.crashRate),
-      anr: toVitalMetric(anrValue, thresholds.anrRate),
-      slowStarts: toVitalMetric(slowStartValue, thresholds.slowStartRate),
-      slowRender: toVitalMetric(slowRenderValue, thresholds.slowRenderingRate)
+      crashes: toVitalMetric(crashes.current, thresholds.crashRate, crashes.previous, crashes.trend),
+      anr: toVitalMetric(anr.current, thresholds.anrRate, anr.previous, anr.trend),
+      slowStarts: toVitalMetric(
+        slowStart.current,
+        thresholds.slowStartRate,
+        slowStart.previous,
+        slowStart.trend
+      ),
+      slowRender: toVitalMetric(
+        slowRender.current,
+        thresholds.slowRenderingRate,
+        slowRender.previous,
+        slowRender.trend
+      )
     },
     reviews
   };
 }
 function vitalIndicator(metric) {
-  if (metric.status === "unknown") return "?";
+  if (metric.status === "unknown") return "\u2014";
   if (metric.status === "breach") return "\u2717";
   if (metric.status === "warn") return "\u26A0";
   return "\u2713";
 }
+function vitalTrendArrow(metric) {
+  if (!metric.trend || metric.trend === "flat") return "";
+  return metric.trend === "up" ? " \u2191" : " \u2193";
+}
 function formatVitalValue(metric) {
-  if (metric.value === void 0) return "n/a";
+  if (metric.value === void 0) return "\u2014";
   return `${(metric.value * 100).toFixed(2)}%`;
 }
 function formatFraction(fraction) {
@@ -4147,7 +4174,7 @@ function formatFraction(fraction) {
   return `${Math.round(fraction * 100)}%`;
 }
 function formatRating(rating) {
-  if (rating === void 0) return "n/a";
+  if (rating === void 0) return "\u2014";
   return `\u2605 ${rating.toFixed(1)}`;
 }
 function formatTrend(current, previous) {
@@ -4156,6 +4183,9 @@ function formatTrend(current, previous) {
   if (current < previous) return `  \u2193 from ${previous.toFixed(1)}`;
   return "";
 }
+function allVitalsUnknown(vitals) {
+  return vitals.crashes.status === "unknown" && vitals.anr.status === "unknown" && vitals.slowStarts.status === "unknown" && vitals.slowRender.status === "unknown";
+}
 function formatStatusTable(status) {
   const lines = [];
   const cachedLabel = status.cached ? `  (cached ${new Date(status.fetchedAt).toLocaleTimeString()})` : `  (fetched ${new Date(status.fetchedAt).toLocaleTimeString()})`;
@@ -4176,23 +4206,188 @@ function formatStatusTable(status) {
   }
   lines.push("");
   lines.push(`VITALS  (last ${status.vitals.windowDays} days)`);
-  const { crashes, anr, slowStarts, slowRender } = status.vitals;
-  lines.push(
-    `  crashes     ${formatVitalValue(crashes).padEnd(8)}  ${vitalIndicator(crashes)}    anr         ${formatVitalValue(anr).padEnd(8)}  ${vitalIndicator(anr)}`
-  );
-  lines.push(
-    `  slow starts ${formatVitalValue(slowStarts).padEnd(8)}  ${vitalIndicator(slowStarts)}    slow render ${formatVitalValue(slowRender).padEnd(8)}  ${vitalIndicator(slowRender)}`
-  );
+  if (allVitalsUnknown(status.vitals)) {
+    lines.push("  No vitals data available for this period.");
+  } else {
+    const { crashes, anr, slowStarts, slowRender } = status.vitals;
+    const crashVal = `${formatVitalValue(crashes)}${vitalTrendArrow(crashes)}`;
+    const anrVal = `${formatVitalValue(anr)}${vitalTrendArrow(anr)}`;
+    const slowStartVal = `${formatVitalValue(slowStarts)}${vitalTrendArrow(slowStarts)}`;
+    const slowRenderVal = `${formatVitalValue(slowRender)}${vitalTrendArrow(slowRender)}`;
+    lines.push(
+      `  crashes     ${crashVal.padEnd(10)}  ${vitalIndicator(crashes)}    anr         ${anrVal.padEnd(10)}  ${vitalIndicator(anr)}`
+    );
+    lines.push(
+      `  slow starts ${slowStartVal.padEnd(10)}  ${vitalIndicator(slowStarts)}    slow render ${slowRenderVal.padEnd(10)}  ${vitalIndicator(slowRender)}`
+    );
+  }
   lines.push("");
   lines.push(`REVIEWS  (last ${status.reviews.windowDays} days)`);
   const { averageRating, previousAverageRating, totalNew, positivePercent } = status.reviews;
-  const trend = formatTrend(averageRating, previousAverageRating);
-  const positiveStr = positivePercent !== void 0 ? `  ${positivePercent}% positive` : "";
+  if (totalNew === 0 && averageRating === void 0) {
+    lines.push("  No reviews in this period.");
+  } else {
+    const trend = formatTrend(averageRating, previousAverageRating);
+    const positiveStr = positivePercent !== void 0 ? `  ${positivePercent}% positive` : "";
+    lines.push(`  ${formatRating(averageRating)}   ${totalNew} new${positiveStr}${trend}`);
+  }
+  return lines.join("\n");
+}
+function formatStatusSummary(status) {
+  const parts = [status.packageName];
+  const latestRelease = status.releases.find((r) => r.status !== "draft") ?? status.releases[0];
+  if (latestRelease) {
+    parts.push(`v${latestRelease.versionCode} ${latestRelease.track}`);
+  }
+  const { crashes, anr } = status.vitals;
+  if (crashes.status !== "unknown") {
+    const arrow = crashes.trend === "up" ? " \u2191" : crashes.trend === "down" ? " \u2193" : "";
+    parts.push(`crashes ${formatVitalValue(crashes)}${arrow} ${vitalIndicator(crashes)}`);
+  }
+  if (anr.status !== "unknown") {
+    const arrow = anr.trend === "up" ? " \u2191" : anr.trend === "down" ? " \u2193" : "";
+    parts.push(`ANR ${formatVitalValue(anr)}${arrow} ${vitalIndicator(anr)}`);
+  }
+  const { averageRating, totalNew } = status.reviews;
+  if (averageRating !== void 0) {
+    parts.push(`avg ${averageRating.toFixed(1)}\u2605`);
+  }
+  if (totalNew > 0) {
+    parts.push(`${totalNew} reviews`);
+  }
+  return parts.join(" \xB7 ") + (statusHasBreach(status) ? " [ALERT]" : "");
+}
+function computeStatusDiff(prev, curr) {
+  const prevVersion = prev.releases[0]?.versionCode ?? null;
+  const currVersion = curr.releases[0]?.versionCode ?? null;
+  const prevCrash = prev.vitals.crashes.value ?? null;
+  const currCrash = curr.vitals.crashes.value ?? null;
+  const prevAnr = prev.vitals.anr.value ?? null;
+  const currAnr = curr.vitals.anr.value ?? null;
+  const prevRating = prev.reviews.averageRating ?? null;
+  const currRating = curr.reviews.averageRating ?? null;
+  return {
+    versionCode: { from: prevVersion, to: currVersion },
+    crashRate: {
+      from: prevCrash,
+      to: currCrash,
+      delta: currCrash !== null && prevCrash !== null ? currCrash - prevCrash : null
+    },
+    anrRate: {
+      from: prevAnr,
+      to: currAnr,
+      delta: currAnr !== null && prevAnr !== null ? currAnr - prevAnr : null
+    },
+    reviewCount: { from: prev.reviews.totalNew, to: curr.reviews.totalNew },
+    averageRating: {
+      from: prevRating,
+      to: currRating,
+      delta: currRating !== null && prevRating !== null ? Math.round((currRating - prevRating) * 10) / 10 : null
+    }
+  };
+}
+function formatStatusDiff(diff, since) {
+  const lines = [`Changes since ${since}:`];
+  if (diff.versionCode.from !== diff.versionCode.to) {
+    lines.push(`  Version:    ${diff.versionCode.from ?? "\u2014"} \u2192 ${diff.versionCode.to ?? "\u2014"}`);
+  }
+  const fmtRate = (v) => v !== null ? `${(v * 100).toFixed(2)}%` : "\u2014";
+  const fmtDelta = (d, lowerIsBetter = true) => {
+    if (d === null || Math.abs(d) < 1e-4) return "no change";
+    const sign = d > 0 ? "+" : "";
+    const good = lowerIsBetter ? d < 0 : d > 0;
+    return `${sign}${(d * 100).toFixed(2)}% ${good ? "\u2713" : "\u2717"}`;
+  };
   lines.push(
-    `  ${formatRating(averageRating)}   ${totalNew} new${positiveStr}${trend}`
+    `  Crash rate: ${fmtRate(diff.crashRate.from)} \u2192 ${fmtRate(diff.crashRate.to)} (${fmtDelta(diff.crashRate.delta)})`
   );
+  lines.push(
+    `  ANR rate:   ${fmtRate(diff.anrRate.from)} \u2192 ${fmtRate(diff.anrRate.to)} (${fmtDelta(diff.anrRate.delta)})`
+  );
+  const ratingDelta = diff.averageRating.delta;
+  const prevR = diff.averageRating.from !== null ? `${diff.averageRating.from.toFixed(1)}\u2605` : "\u2014";
+  const currR = diff.averageRating.to !== null ? `${diff.averageRating.to.toFixed(1)}\u2605` : "\u2014";
+  const ratingStr = ratingDelta === null || Math.abs(ratingDelta) < 0.05 ? "no change" : `${ratingDelta > 0 ? "+" : ""}${ratingDelta.toFixed(1)} ${ratingDelta > 0 ? "\u2713" : "\u2717"}`;
+  lines.push(`  Reviews:    ${prevR} \u2192 ${currR} (${ratingStr})`);
   return lines.join("\n");
 }
+async function runWatchLoop(opts) {
+  if (opts.intervalSeconds < 10) {
+    console.error("Error: --watch interval must be at least 10 seconds");
+    process.exit(2);
+  }
+  let running = true;
+  const cleanup = () => {
+    running = false;
+    process.stdout.write("\n");
+    process.exit(0);
+  };
+  process.on("SIGINT", cleanup);
+  process.on("SIGTERM", cleanup);
+  while (running) {
+    process.stdout.write("\x1B[2J\x1B[H");
+    try {
+      const status = await opts.fetch();
+      await opts.save(status);
+      console.log(opts.render(status));
+    } catch (err) {
+      console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    console.log(`
+[gpc status] Refreshing in ${opts.intervalSeconds}s\u2026 (Ctrl+C to stop)`);
+    for (let i = 0; i < opts.intervalSeconds && running; i++) {
+      await new Promise((r) => setTimeout(r, 1e3));
+    }
+  }
+}
+function breachStateFilePath(packageName) {
+  return join7(getCacheDir(), `breach-state-${packageName}.json`);
+}
+async function trackBreachState(packageName, isBreaching) {
+  const filePath = breachStateFilePath(packageName);
+  let prevBreaching = false;
+  try {
+    const raw = await readFile10(filePath, "utf-8");
+    prevBreaching = JSON.parse(raw).breaching;
+  } catch {
+  }
+  if (prevBreaching !== isBreaching) {
+    try {
+      await mkdir5(getCacheDir(), { recursive: true });
+      await writeFile7(
+        filePath,
+        JSON.stringify({ breaching: isBreaching, since: (/* @__PURE__ */ new Date()).toISOString() }, null, 2),
+        { encoding: "utf-8", mode: 384 }
+      );
+    } catch {
+    }
+    return true;
+  }
+  return false;
+}
+function sendNotification(title, body) {
+  if (process.env["CI"]) return;
+  try {
+    const p = process.platform;
+    if (p === "darwin") {
+      execSync(
+        `osascript -e 'display notification ${JSON.stringify(body)} with title ${JSON.stringify(title)}'`,
+        { stdio: "ignore" }
+      );
+    } else if (p === "linux") {
+      execSync(`notify-send ${JSON.stringify(title)} ${JSON.stringify(body)}`, {
+        stdio: "ignore"
+      });
+    } else if (p === "win32") {
+      const escaped = (s) => s.replace(/'/g, "''");
+      execSync(
+        `powershell -Command "Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.MessageBox]::Show('${escaped(body)}', '${escaped(title)}')"`,
+        { stdio: "ignore" }
+      );
+    }
+  } catch {
+  }
+}
 function statusHasBreach(status) {
   return status.vitals.crashes.status === "breach" || status.vitals.anr.status === "breach" || status.vitals.slowStarts.status === "breach" || status.vitals.slowRender.status === "breach";
 }
@@ -4220,6 +4415,7 @@ export {
   clearAuditLog,
   compareBundles,
   compareVitalsTrend,
+  computeStatusDiff,
   consumeProductPurchase,
   convertRegionPrices,
   createAuditEntry,
@@ -4265,6 +4461,8 @@ export {
   formatJunit,
   formatOutput,
   formatSlackPayload,
+  formatStatusDiff,
+  formatStatusSummary,
   formatStatusTable,
   generateMigrationPlan,
   generateNotesFromGit,
@@ -4340,16 +4538,19 @@ export {
   removeUser,
   replyToReview,
   revokeSubscriptionPurchase,
+  runWatchLoop,
   safePath,
   safePathWithin,
   saveStatusCache,
   scaffoldPlugin,
   searchAuditEvents,
   searchVitalsErrors,
+  sendNotification,
   sendWebhook,
   sortResults,
   statusHasBreach,
   syncInAppProducts,
+  trackBreachState,
   updateAppDetails,
   updateDataSafety,
   updateInAppProduct,