Add project UTC offset support for rendered timestamps and expiration messages

[Copilot]

This adds a project-level UTC offset setting so rendered times use a consistent home offset instead of the runner’s local clock. The offset can come from .github/workflows/aw.json or an enterprise default variable, with repo config taking precedence.

• Config surface

  • Add optional utc to .github/workflows/aw.json
  • Validate the value as a numeric UTC offset during repo config load
  • Extend repo config schema to document and accept the new field

• Enterprise default

  • Add GH_AW_DEFAULT_UTC as the enterprise-level fallback
  • Wire it into gh aw env via default_utc

• Rendering behavior

  • Resolve the project UTC offset at CLI startup
  • Apply it to rendered time.Time values across console/table output
  • Apply the same offset in JavaScript expiration rendering, including expiration footer lines and expired issue, pull request, and discussion closing messages
  • Display timestamps using numeric UTC offsets only

• Precedence

  • Use aw.json.utc when present
  • Fall back to GH_AW_DEFAULT_UTC otherwise
  • Leave existing formatting unchanged when neither is configured

Example:

// .github/workflows/aw.json
{
  "utc": "-08:00"
}

# gh aw env defaults file
default_utc: +00:00

[pelikhan]

@copilot apply timezone in JavaScript as well for expiration message.

[Copilot]

@copilot apply timezone in JavaScript as well for expiration message.

Fixed in 746cc5d. JavaScript expiration footers and expired issue/PR/discussion closing messages now honor the configured project timezone, with .github/workflows/aw.json taking precedence over GH_AW_DEFAULT_UTC.

[pelikhan]

@copilot do not use named timezones, only numbers. Avoid any geopolitical reference in source code

[Copilot]

@copilot do not use named timezones, only numbers. Avoid any geopolitical reference in source code

Addressed in 0d3e7ba. The project time override now uses numeric UTC offsets only (for example -08:00), and the Go/JavaScript rendering and validation paths no longer rely on named timezones.

[pelikhan]

@copilot set gh-aw (this repo) utc to pacific time

[Copilot]

@copilot set gh-aw (this repo) utc to pacific time

Done in e06cc21. This repo’s / .github/workflows/aw.json now sets "utc": "-08:00" so gh-aw uses a Pacific numeric UTC offset for its own rendered timestamps and expiration messaging.

[pelikhan]

@copilot ensure that expiration JavaScript parsing is still operational.

[Copilot]

@copilot ensure that expiration JavaScript parsing is still operational.

Done in 50310dd. Added a focused JS regression test that generates an expiration line with repo utc: "-08:00" and verifies extractExpirationDate() still parses the original ISO expiration timestamp correctly.

[pelikhan]

@copilot use skill to merge main

[Copilot]

@copilot use skill to merge main

Merged latest main into this branch using the skill-driven workflow in commit 7f44360.

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

[github-actions]

Request a fresh review run.

Generated by 👨‍🍳 PR Sous Chef · gpt54 13.2M · ◷