GPC

Appearance

Changelog ​

All notable user-facing changes to GPC are documented here. For full release details, see the GitHub Releases page.

v0.9.28 latest ​

March 2026

  • fix: gpc audit clear --dry-run no longer deletes entries — the global --dry-run flag was consumed by the root program before the audit clear subcommand action ran, making options.dryRun always undefined. Entries were deleted. Now uses isDryRun(cmd) to read from root opts — same fix pattern as gpc doctor --json in v0.9.25.
  • 1,392 tests

v0.9.27 ​

March 2026

  • fix: gpc status --sections now filters output — --sections vitals previously skipped the API calls correctly but still rendered all three sections (RELEASES, VITALS, REVIEWS). Now only the requested sections appear in both table and JSON output.
  • 1,391 tests

v0.9.26 ​

March 2026

  • feat: trend arrows on vitals — gpc status now shows ↑↓ next to crash rate and ANR rate, comparing the current window against the prior period so you can see at a glance if things are improving or worsening
  • feat: --format summary — one-liner output for shell prompts and post-deploy hooks: tv.visioo.app · v142 internal · crashes 1.20% ↓ ✓ · avg 4.1★
  • feat: --sections <list> — fetch only what you need; --sections vitals skips the releases and reviews API calls entirely
  • feat: --watch [N] — real polling loop with terminal clear, Ctrl+C to stop, min 10s interval, default 30s
  • feat: --since-last — diff mode: shows version, crash rate, ANR rate, and rating deltas vs the last cached run
  • feat: --all-apps — run status for all configured app profiles in one command (max 5 apps)
  • feat: --notify — desktop notification on threshold breach or clear (macOS, Linux, Windows); skipped in CI; only fires on state change
  • fix: unknown vitals/reviews display — shows — instead of ?/n/a; renders "No vitals data available for this period" or "No reviews in this period" when there is nothing to show
  • 1,388 tests

v0.9.25 ​

March 2026

  • fix: gpc publish / gpc releases upload always failed — Google Play API returns Bundle directly from the upload endpoint, not wrapped in { bundle: Bundle }. The client was accessing data.bundle (always undefined), throwing "Upload succeeded but no bundle data returned" on every upload even though the file transferred successfully.
  • fix: gpc doctor --json always output human-readable text — the global -j, --json option on the root Commander program was consumed before the doctor subcommand action ran. Now reads cmd.parent?.opts().
  • fix: gpc status --days N / gpc vitals compare --days N wrong date window — Commander calls parseInt(value, previousValue) when a coerce function and default are both given. Using parseInt directly meant the default (e.g. 7) was passed as the radix — parseInt("7", 7) = NaN, parseInt("14", 7) = 11. Now uses (v) => parseInt(v, 10).
  • fix: gpc validate table output showed raw JSON — ValidateResult.checks[] was passed directly to formatOutput, producing JSON.stringify(...) in table/markdown cells. Now flattens checks to rows with a separate warnings list and Valid/Invalid footer.
  • fix: JUnit name attribute showed - for releases status — commands that set name: s["name"] || "-" produced sentinel "-" strings that stopped the ?? fallback chain. Now uses a loop that skips "" and "-", falling through to track, versionCode, etc.
  • 1,358 tests

v0.9.24 ​

March 2026

  • Feat: gpc status — unified app health snapshot: releases, vitals, and reviews in one command. 6 parallel API calls, results in under 3 seconds. Cached 1 hour. --cached, --refresh, --watch <seconds>, --days. Exit code 6 if any vitals threshold is breached. See status command.
  • Fix: migrate rollout mapping — supply(rollout: "0.1") now correctly maps to gpc releases upload --rollout 10 (was releases promote)
  • Feat: migrate --dry-run — gpc migrate fastlane --dry-run previews the migration plan and .gpcrc.json without writing any files
  • Feat: migrate conflict detection — warns before overwriting an existing .gpcrc.json
  • Feat: parse warnings — Fastlane complex Ruby constructs (begin/rescue/if/unless) now surface a warning in migration output instead of silently producing incomplete lane detection
  • Fix: validate warnings surfaced — file validation warnings (e.g., "Large file") are now included in ValidateResult.warnings and shown to the user
  • Feat: git notes truncation flag — generateNotesFromGit now returns truncated: boolean; CLI warns to stderr when release notes were trimmed
  • Fix: doctor package name check — added Android package name format validation to gpc doctor
  • Feat: config init wizard — gpc config init now runs a guided setup wizard with auth method selection, file existence validation, and post-init summary
  • Fix: publish rollout guard — gpc publish rejects non-finite and out-of-range rollout values (< 1 or > 100) with exit code 2
  • 1,355 tests

v0.9.23 ​

March 2026

  • Feat: bundle analysis — new gpc bundle analyze and gpc bundle compare commands for zero-dependency AAB/APK size breakdown by module and category, with --threshold CI gate (exit code 6 on breach)
  • Fix: vitals compare 400 error — gpc vitals compare now uses non-overlapping date ranges, preventing start_time must be earlier than end_time API errors
  • Feat: --dry-run for 4 more commands — tracks create, tracks update, device-tiers create, and internal-sharing upload now support --dry-run
  • Fix: exit code consistency — data-safety get/export and reports download financial/stats now exit 2 (usage error) instead of 1 for unsupported operations
  • 1,299 tests

v0.9.22 ​

March 2026

  • Feat: table flattening audit — releases status, reviews list, vitals crashes/anr/overview, purchases get/voided, testers list, users list, device-tiers list now show flat, readable columns instead of nested JSON objects
  • Feat: audit log querying — new gpc audit list, gpc audit search, and gpc audit clear commands to query, filter, and manage the JSONL audit log
  • Feat: persistent vitals thresholds — set thresholds once via gpc config set vitals.thresholds.crashRate 2.0 — automatically checked on every gpc vitals crashes run (exit code 6 on breach)
  • Feat: batch IAP commands — gpc iap batch-get --skus sku1,sku2 and gpc iap batch-update --file products.json for bulk in-app product operations
  • Fix: vitals end-date freshness — capped timeline end date to yesterday since the Reporting API data has ~1 day lag, fixing 400 errors on vitals crashes, vitals anr, and other metric queries
  • 1,286 tests

v0.9.21 ​

March 2026

  • Fix: vitals crashes/anr 400 errors — timelineSpec is now always included (defaults to 30 days), and each metric set uses its own valid metrics instead of hardcoded errorReportCount
  • Fix: reports GCS limitation — reports list and reports download now show clear messages explaining that financial and stats reports are delivered via Google Cloud Storage, not the REST API
  • Fix: purchase-options redirect — standalone purchase-options commands now redirect to otp offers (the correct sub-resource path)
  • Fix: pricing convert table — correctly extracts units/nanos/currencyCode from the Money object instead of showing empty cells
  • Fix: subscriptions get listings — handles array-format listings, showing language codes (en-US, fr-FR) instead of array indices (0, 1, 2)
  • Fix: generated-apks table — flattens nested objects into readable columns (id, variantId, moduleName, sha256)
  • Fix: JUnit testcase names — expanded fallback chain (productId, packageName, trackId, region, languageCode, item-N) instead of raw JSON dumps
  • 1,276 tests

v0.9.20 ​

March 2026

  • Fix: vitals API endpoints — corrected metric set names (crashRateMetricSet instead of vitals.crashrate) — vitals commands now work against the real Google Play Reporting API
  • Fix: upload timeout — auto-scales based on file size (30s + 1s/MB), no more 30s hard limit; supports --timeout flag and GPC_UPLOAD_TIMEOUT env var
  • Fix: HTML error messages — API errors returning HTML (e.g., 404 pages) are now stripped to plain text
  • Fix: data-safety get — shows clear message that the Google Play API has no GET endpoint for data safety
  • Fix: listings push --dry-run — no longer says "Listings pushed" in dry-run mode
  • Fix: recovery list — requires --version-code (validated locally instead of sending invalid request)
  • Fix: empty output — otp list, testers list, device-tiers list, listings availability, vitals errors search, and all vitals metric commands now show human-readable messages when no data
  • Fix: table formatting — subscriptions get, subscriptions offers list, and pricing convert flatten nested objects for readable table output
  • 1,273 tests

v0.9.19 ​

March 2026

  • Fix: OTP update regionsVersion + updateMask — otp update and otp offers update now include regionsVersion.version=2022/02 and auto-derived updateMask, matching the subscription fix from v0.9.18
  • Fix: table cell truncation — cells wider than 60 characters are truncated with ... in table and markdown output
  • Fix: flatten subscriptions/OTP list — subscriptions list and otp list show readable summaries (productId, counts, state) in table/markdown output instead of nested JSON blobs
  • Fix: better JSON parse errors — file read errors now include the filename in the error message
  • gpc releases diff — compare releases between two tracks (--from internal --to production), showing version codes, status, rollout, and release notes differences
  • gpc subscriptions diff — compare a local JSON file against the remote subscription state
  • gpc otp diff — compare a local JSON file against the remote one-time product state
  • 1,271 tests

v0.9.18 ​

March 2026

  • Fix: regionsVersion on subscription update — subscriptions update and offers update now always include the regionsVersion.version=2022/02 query param, matching the existing create behavior
  • Fix: table/markdown [object Object] — table and markdown output formatters now render nested objects as JSON instead of displaying [object Object]

v0.9.17 ​

March 2026

  • Fix: subscriptions create validation — auto-add regionsVersion.version query param, strip output-only fields (state, archived), auto-prefix prorationMode enum values
  • Fix: one-time products create — add missing regionsVersion.version query param
  • Client-side validation — benefits max 4, description max 80 chars, gracePeriodDuration + accountHoldDuration must sum to P30D–P60D, Money.units coerced to string
  • subscriptions create --activate — auto-activate DRAFT base plans after creation
  • Empty result messages — reviews list and vitals overview now show helpful messages when no data is available
  • 1,262 tests

v0.9.16 ​

March 2026

  • Fix: subscriptions create missing productId — productId and offerId are now correctly passed as query parameters when creating subscriptions and offers

v0.9.15 ​

March 2026

  • Fix: --output flag ignored — table, yaml, markdown, and junit output formats now work correctly via --output flag and config
  • Fix: recovery list used POST instead of GET — corrected HTTP method, added --version-code filter
  • Fix: iap list/get used deprecated API — migrated to oneTimeProducts API (inappproducts endpoint deprecated, shutdown Aug 2027)
  • Fix: vitals errors/anomalies missing OAuth scope — auth now requests playdeveloperreporting scope alongside androidpublisher
  • Fix: data-safety get/update used edits workflow — data safety API calls no longer require edit insert/commit
  • Fix: missing query params — added productId for subscriptions.create, offerId for createOffer, regionsVersion for update/updateOffer, autoConvertMissingPrices/allowMissing for inappproducts
  • 1,262 tests (up from 1,255)

v0.9.14 ​

March 2026

  • Fix: subscriptions API paths — removed incorrect /monetization/ segment from all 17 subscription endpoint paths (list, get, create, update, delete, basePlans, offers)
  • Fix: convertRegionPrices path — corrected from /monetization/convertRegionPrices to /pricing:convertRegionPrices
  • Added troubleshooting docs for enabling the Play Developer Reporting API (required for vitals commands)

v0.9.13 ​

March 2026

  • gpc install-skills — interactive wizard for installing agent skills (pick skills, target agents, review security, install)
  • Updated Homebrew formula to v0.9.13 with standalone binaries for all 5 platforms
  • Docs consistency pass — all version, endpoint, and test count references aligned

v0.9.12 ​

March 2026

  • Input validation at core layer for package names, SKUs, version codes, language codes, and track names
  • Security hardening — aligned sensitive key redaction (23 field patterns), error message truncation to prevent key leakage
  • 1,255 tests (up from 932) — added API coverage, credential security, redaction, error codes, help consistency, e2e tests
  • Performance benchmarks: CLI cold start under 300ms, command latency sub-millisecond
  • License compliance checker for all production dependencies
  • New docs: tracks command page, interactive mode and dry-run guides
  • Release workflow: pre-publish dry-run, npm provenance, post-publish verification
  • engines.node >= 20 declared on all packages

v0.9.11 ​

March 2026

  • New documentation pages: agent skills, troubleshooting, FAQ, changelog
  • Enhanced gpc doctor with additional environment checks
  • CLI help text improvements across all commands

v0.9.10 ​

March 2026

  • Improved error messages with actionable suggestions for common failures
  • Polished help text and command descriptions
  • Enhanced gpc doctor output with more diagnostic checks

v0.9.9 ​

March 2026

  • Final pre-launch polish with full API coverage and CLI refinements
  • Updated test suite to 932 tests across all packages
  • Bug fixes and stability improvements

v0.9.8 ​

March 2026

  • Published all 7 packages to npm under the @gpc-cli scope
  • Added Homebrew tap: brew install yasserstudio/tap/gpc
  • Standalone binary builds for macOS, Linux, and Windows (5 platform targets)
  • Complete API coverage reaching ~187 endpoints

v0.9.7 ​

March 2026

  • Launched VitePress documentation site at yasserstudio.github.io/gpc
  • Security audit and hardening across all packages
  • New command pages for recovery, data safety, and external transactions
  • DX improvements and SDK polish

v0.9.6 ​

March 2026

  • Plugin SDK with lifecycle hooks and custom command registration
  • Plugin CI package for CI/CD integration helpers
  • Auto-update checker with 24-hour cache
  • Enhanced --dry-run for releases, upload, and publish commands
  • Consolidated all documentation into VitePress (apps/docs/)

v0.9.5 ​

March 2026

  • Security hardening and input validation across all packages
  • Added 88 edge case tests (597 to 685 total)
  • Reports, users, testers, and grants commands
  • CSV import for tester management
  • Bug fixes for auth token refresh

For the complete release history and migration guides, visit the GitHub Releases page.

Released under the MIT License.

Not affiliated with Google LLC. Google Play is a trademark of Google LLC.