Function workOrder

packages/scripts/maintenance/file-upgrades.ts:73–119

(d: Drift)

const issueTitle = (d: Drift) => `⬆️ Upgrade ${d.slug} to ${d.latest}`;

function workOrder(d: Drift): string {
  const edits = d.edits
    .map((e) => `- \`${e.file}\`\n  - \`${e.from}\` → \`${e.to}\``)
    .join("\n");

  return `**${d.name}** is on \`${d.current}\`; upstream released [\`${d.latest}\`](${d.releaseNotes})${
    d.releaseDate ? ` on ${d.releaseDate}` : ""
  } (${d.severity} bump).

### Changes to apply

${edits}

${
  d.imageTag
    ? `Container tag \`${d.imageTag}\` was verified to exist upstream.`
    : `> [!WARNING]\n> No published container tag was found for this version. Confirm the image exists before doing anything else — a release without an image is not shippable.`
}

${d.warnings.length ? `### Warnings\n\n${d.warnings.map((w) => `- ${w}`).join("\n")}\n` : ""}
### Required before merging

A newer release is not evidence that the new version still works with our
compose file, our \`.env\` and our volumes. Establish a baseline first, then
prove the bump did not regress it:

\`\`\`bash
# 1. baseline: does it pass today, before any change?
./packages/scripts/maintenance/test-stack.sh ${d.slug}

# 2. apply the edits above, then:
./packages/scripts/maintenance/test-stack.sh ${d.slug}
\`\`\`

The test pulls every image, waits for all services to become healthy, checks
that nothing crash-loops during a settle window, and makes a real HTTP request
to the app's entry point.

- If the baseline fails too, this app was already broken: fix that first or say
  so in the PR — it is not a regression from this bump.
- If the baseline passes and the bump fails, do **not** merge. Read the release
  notes: a required new env var or a migration usually needs \`.env\` or
  \`compose.yaml\` changes alongside the version.
- ${d.severity === "major" ? "This is a **major** bump: assume breaking changes and read the upgrade guide before touching anything." : "Attach the test output to the PR."}

<sub>Filed automatically from \`work/version-drift.json\`.</sub>`;
}

function main() {
  const report = JSON.parse(readFileSync(REPORT, "utf-8"));