Add cache.maxAge to CI

[jpwilliams]

Summary

Adds cache.maxAge to ci.job()s, allowing JIT builds/caching to rebuild if the latest is not recent enough.

const base = ci.job(
  {
    id: "base",
    cache: {
      key: files("images/node-base/**"),
      maxAge: "1d",
    },
  },
  async () => {
    await checkout();

    await $`pnpm install`;
  },
);

Checklist

• Added a docs PR that references this PR N/A Later bump
• Added unit/integration tests
• Added changesets if applicable

[changeset-bot]

🦋 Changeset detected

Latest commit: 6ec7368

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@inngest/ci	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[Copilot]

🟢 Approval recommended

The freshness behavior, validation, race resolution, tests, and public documentation are consistent, with only a minor grammar issue noted.

1 open finding

• Fix missing noun in possessive phrase · New

What changed in this PR

Adds configurable cache freshness to @inngest/ci, allowing jobs to rebuild snapshots older than cache.maxAge.

Changes:

• Adds and validates the cache.maxAge duration option.
• Applies freshness checks during cache lookup and name-conflict resolution.
• Adds tests, documentation, and a minor changeset.

File	Description
.changeset/​ci-cache-max-age.md	Records the new cache option.
packages/​ci/​README.md	Documents maxAge usage.
packages/​ci/​src/​cache/​cache.test.ts	Tests snapshot freshness and replacement.
packages/​ci/​src/​cache/​cache.ts	Implements age-aware cache usability.
packages/​ci/​src/​machine/​machine.ts	Passes cache configuration during snapshot naming.
packages/​ci/​src/​pipeline/​cacheGuarantees.test.ts	Adds end-to-end cache-age tests.
packages/​ci/​src/​pipeline/​job.ts	Validates durations and forwards cache settings.
packages/​ci/​src/​types.ts	Exposes CacheConfig.maxAge.

🧠 Review effort: Balanced

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[greptile-apps]

Confidence Score: 5/5

[Medium impact] The PR appears safe to merge; no actionable defects were found.

Summary

Adds cache.maxAge so jobs rebuild snapshots that are too old.

• CI jobs rebuild cached snapshots after a configured age.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart TD
  A[Resolve parent snapshot] --> B[Compute cache name]
  B --> C{Usable snapshot found?}
  C -->|Yes| D[Reuse snapshot]
  C -->|No| E[Build job]
  E --> F{Cache name available?}
  F -->|Yes| G[Save named snapshot]
  F -->|No| H{Usable holder found?}
  H -->|Yes| D
  H -->|No| I[Delete old ready holder]
  I --> J[Retry named snapshot]

Loading

_{Reviews (1) · Last reviewed commit: "docs(ci): rewrite cache-max-age changese..." · Reviewed by Greptile}