{
  "slug": "heroku-cli-adds-postgres-upgrade-run-and-wait-commands-92ca264ab386",
  "title": "Heroku CLI adds Postgres upgrade run and wait commands",
  "tools": [
    "heroku"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-04-15T20:07:03.000Z",
  "announced_at": "2026-04-15T20:07:03.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "For a major-version upgrade of a Heroku Postgres Advanced database, run `data:pg:upgrade:run` with the database and app, optionally specifying a target version. Then run `data:pg:upgrade:wait` for that database and app until the upgrade completes.",
    "examples": [
      "heroku data:pg:upgrade:run <DATABASE> --version <VERSION> --app <APP>",
      "heroku data:pg:upgrade:wait <DATABASE> --app <APP>"
    ],
    "gotchas": [
      "Version: v11.3.0",
      "DATABASE (required): Database name, attachment name, or related config var on an app.",
      "--app, -a (required): App to run the command against.",
      "--version, -v: Postgres version to upgrade to.",
      "--confirm, -c: Pass in the app name to skip confirmation prompts.",
      "--remote, -r: Git remote of the app to use.",
      "--no-notify: Suppress the OS notification while waiting.",
      "--wait-interval: Polling interval in seconds; default is 5.",
      "Prerequisite: The upgrade command is for a Postgres Advanced database.",
      "The commands are for upgrading major versions of Heroku Postgres Advanced databases.",
      "`data:pg:upgrade:wait` inherits the behavior of `data:pg:wait` and guides users dealing with a Classic database to run the correct command."
    ]
  },
  "why_it_matters": "Upgrade a Heroku Postgres Advanced database to a new major version and wait for the upgrade to finish.",
  "sources": [
    "https://github.com/heroku/cli/releases/tag/v11.3.0",
    "https://github.com/heroku/cli/pull/3551",
    "https://devcenter.heroku.com/articles/heroku-cli-commands"
  ],
  "rank": 0.96014,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "wave2a-20261017",
    "verdict_id": "wave2a-20261017:wave2a-20261017-3360558165c477a4-0:gate",
    "evidence_hash": "13823d3ae118106ffb4076f91a20a7cbe8f0a9af8f9d5b2c6d75328fb9118299"
  },
  "review": {
    "draft_hash": "aec9ca50d3224e5cafc3f8ac65937b3d79bb4e3ca2c89dfc7d4884fdce9f56d8",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave2a-20261017:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.96 >= 0.9; 2 needed) and Jev gave 0.66 (>= 0.6 needed)."
  }
}