Codebase-Migration über Tage statt Minuten

import { defineAgent, step } from "@hostspezial/agent-sdk";

export default defineAgent({
  name: "framework-migration",
  // Tage statt Minuten: Der Lauf darf lange leben und muss
  // jeden Neustart der Plattform ueberstehen.
  budget: { eur: 180, wallClockMs: 72 * 3_600_000 },

  async run(ctx) {
    const files = await step(ctx, "survey", () => ctx.tools.repo.scan({ pattern: "**/*.ts" }));
    const done: string[] = [], manual: string[] = [];

    for (const file of files) {
      // step() ist der Checkpoint. Nach einem Absturz setzt der Lauf
      // bei genau dieser Datei auf — bereits erledigte werden
      // uebersprungen, nicht erneut bearbeitet.
      const r = await step(ctx, `migrate:${file}`, { retry: { attempts: 2 } }, async () => {
        await ctx.tools.repo.edit(file, ctx.plan(file));
        return ctx.tools.ci.runTests({ scope: file });   // das Erfolgskriterium
      });

      (r.passed ? done : manual).push(file);

      // PRs in Review-Groesse statt eines 2 600-Dateien-Monsters.
      if (done.length % 25 === 0) {
        await step(ctx, `pr:${done.length}`, () => ctx.tools.git.openPr(done.slice(-25)));
      }
    }
    return { migrated: done.length, manual: manual.length, manual };
  },
});