feat(builtins): add aspect ci warming task

[gregmagolan]

Summary

Adds a new built-in AXL task: aspect ci warming.

1. Cleans ${ASPECT__STORAGE_PATH}/{bazel,output,caches/repository} (matching rosetta's WarmingTaskRef cleanup).
2. Runs bazel build --nobuild against the given targets so the repository, output, and bazel caches under the ephemeral mount are populated.
3. When ASPECT_WORKFLOWS_RUNNER is set, also invokes /etc/aspect/workflows/bin/warming_archive to upload the populated caches to the warming bucket. Off-runner this step is skipped with a stderr warning; the populate step still runs so the task is useful for local testing.

This collapses the customer-facing GHA warming workflow to:

jobs:
    warming-archive:
        name: Aspect Workflows Warming
        runs-on: [self-hosted, aspect-workflows, aspect-default]
        steps:
            - uses: actions/checkout@v4
            - name: Warming Task
              run: aspect ci warming

(Replacing the prior 5-step flow that called configure_workflows_env, agent_health_check, rosetta run warming, and warming_archive separately.)

• Default targets //...; positional args override.
• Honors BazelTrait flags / startup_flags contributions so warming sees the same --config=... etc. as real builds.
• Cleanup is no-op when ASPECT__STORAGE_PATH is unset.

This is the new-task half of the warming-refactor plan. Sibling PRs:

• feat: route launcher and AXL caches via env vars #1062 — env-var routing of the launcher / AXL caches (ASPECT_LAUNCHER_CACHE, ASPECT_CLI_CACHE).
• silo PR that exports the env vars on Workflows runners and adds the resulting cache subtrees to archive.sh / restore.sh.

The three pieces are runtime-coupled but compile-independent. Either PR here can land first.

Test plan

Tested locally on macOS aarch64.

• cargo build -p aspect-cli — clean
• aspect ci warming --help — CLI surface exposes the task under group ci
• aspect ci warming //... in a Bazel example workspace — cleanup is no-op (no ASPECT__STORAGE_PATH), bazel build --nobuild runs, exits 0 with 0 total actions, then prints the ASPECT_WORKFLOWS_RUNNER is not set; skipping the warming archive upload step. warning to stderr
• Pre-seeded ASPECT__STORAGE_PATH=/tmp/warmtest with bazel/, output/, caches/repository/ subdirs and a sentinel file → after aspect ci warming, all three subdirs are removed
• ASPECT_WORKFLOWS_RUNNER=1 ASPECT_WORKFLOWS_RUNNER_STORAGE_PATH=/tmp/warmtest aspect ci warming //... — task progresses past the bazel populate step and attempts to spawn /etc/aspect/workflows/bin/warming_archive (fails on a laptop because the binary isn't there, which confirms the call site is wired)
• End-to-end on a staging Workflows runner — depends on feat: route launcher and AXL caches via env vars #1062 + the silo PR

🤖 Generated with Claude Code

[aspect-workflows]

✨ Aspect Workflows Tasks

📅 Wed May 13 02:41:48 UTC 2026

❌ 1 failed task

• ❌ format (buildifier-gha-debug) · ⏱ 1m 20s · ✨ Aspect · 🐙 GitHub Actions · ☑️ Check
  💬 failed in diff · Format failed (1 file needs format)

✅ 14 successful tasks

• ✅ build (build-gha) · ⏱ 1m 14s · ✨ Aspect · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel build complete (161 built)
• ✅ build (build-gha-debug) · ⏱ 1m 12s · ✨ Aspect · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel build complete (161 built)
• ✅ delivery (delivery-gha) · ⏱ 1m 47s · ✨ Aspect · 🐙 GitHub Actions · ☑️ Check
  💬 Delivery complete (1 delivered)
• ✅ delivery (delivery-gha-debug) · ⏱ 5m 5s · ✨ Aspect · 🐙 GitHub Actions · ☑️ Check
  💬 Delivery complete (1 delivered)
• ✅ format (format-gha) · ⏱ 1m 24s · ✨ Aspect · 🐙 GitHub Actions · ☑️ Check
  💬 Format complete (clean)
• ✅ format (format-gha-debug) · ⏱ 1m 14s · ✨ Aspect · 🐙 GitHub Actions · ☑️ Check
  💬 Format complete (clean)
• ✅ gazelle (gazelle-from-source-gha) · ⏱ 1m 23s · ✨ Aspect · 🐙 GitHub Actions · ☑️ Check
  💬 Gazelle complete (clean)
• ✅ gazelle (gazelle-from-source-gha-debug) · ⏱ 1m 13s · ✨ Aspect · 🐙 GitHub Actions · ☑️ Check
  💬 Gazelle complete (clean)
• ✅ gazelle (gazelle-gha) · ⏱ 1m 11s · ✨ Aspect · 🐙 GitHub Actions · ☑️ Check
  💬 Gazelle complete (clean)
• ✅ gazelle (gazelle-gha-debug) · ⏱ 1m 9s · ✨ Aspect · 🐙 GitHub Actions · ☑️ Check
  💬 Gazelle complete (clean)
• ✅ lint (lint-gha) · ⏱ 1m 22s · ✨ Aspect · 🐙 GitHub Actions · ☑️ Check
  💬 Lint complete (clean)
• ✅ lint (lint-gha-debug) · ⏱ 1m 14s · ✨ Aspect · 🐙 GitHub Actions · ☑️ Check
  💬 Lint complete (clean)
• ✅ test (test-gha) · ⏱ 1m 10s · ✨ Aspect · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (25/25 passed · 25 cached)
• ✅ test (test-gha-debug) · ⏱ 1m 9s · ✨ Aspect · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (25/25 passed · 25 cached)

🔁 Reproduce

❌ format (buildifier-gha-debug)

aspect format --check=true --scope=changed --formatter-target=//tools/format:format-starlark

🛠️ Fix

❌ format (buildifier-gha-debug)

aspect format --check=false --formatter-target=//tools/format:format-starlark -- \
  crates/aspect-cli/src/builtins/aspect/warming.axl

---

_{Powered by Aspect Build · GitHub · X · LinkedIn · YouTube}

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 573c2b0010

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

[chatgpt-codex-connector]

Use runner storage env var for warming cleanup

The cleanup step reads ASPECT__STORAGE_PATH, but the runner environment model in lib/environment.axl is keyed off ASPECT_WORKFLOWS_RUNNER_STORAGE_PATH (with defaults derived from it). On Workflows runners where only the documented ASPECT_WORKFLOWS_RUNNER_* variables are present, mount is empty, so the pre-warming cleanup is skipped and stale cache contents can be re-archived by warming_archive, defeating the task’s “clean then repopulate” behavior.

Useful? React with 👍 / 👎.