@pimmesz/afterburner 1.0.9 → 1.0.10

package/dist/{chunk-OZAFLQDP.js → chunk-Z3H5GIPM.js}

@@ -417,37 +417,6 @@ function budgetFromUsageCache(cache, opts, nowMs) {
   return { budget: { sessionAvailable, weeklyRemainingPct, weeklyRemainingTokensEst } };
 }
 
-// src/core/store/run-store.ts
-import { appendFile, mkdir as mkdir2, readFile as readFile3 } from "fs/promises";
-import { dirname as dirname2 } from "path";
-var JsonlRunStore = class {
-  constructor(filePath = defaultRunStorePath()) {
-    this.filePath = filePath;
-  }
-  filePath;
-  async append(record) {
-    await mkdir2(dirname2(this.filePath), { recursive: true });
-    await appendFile(this.filePath, `${JSON.stringify(record)}
-`, "utf8");
-  }
-  async list() {
-    let raw;
-    try {
-      raw = await readFile3(this.filePath, "utf8");
-    } catch (error) {
-      if (error.code === "ENOENT") return [];
-      throw error;
-    }
-    return raw.split("\n").filter((line) => line.trim().length > 0).map((line) => JSON.parse(line));
-  }
-  async hasOpenOrMergedPr(fingerprint) {
-    const records = await this.list();
-    return records.some(
-      (r) => r.fingerprint === fingerprint && (r.outcome === "pr-opened" || !!r.prUrl)
-    );
-  }
-};
-
 // src/core/budget/claude-usage.ts
 var ClaudeUsageBudgetProvider = class {
   constructor(opts) {
@@ -519,16 +488,6 @@ function createBudgetProvider(config, opts = {}) {
   };
 }
 
-// src/core/notify/console.ts
-var ConsoleNotifier = class {
-  async notify(record) {
-    const pr = record.prUrl ? ` pr=${record.prUrl}` : "";
-    console.log(
-      `[afterburner] ${record.outcome} ${record.category} "${record.title}" repo=${record.repoUrl} branch=${record.branch} est=${record.estCostSonnetTokens.toLocaleString("en-US")} sonnet-eq tokens${pr}`
-    );
-  }
-};
-
 // src/core/scheduler/gate.ts
 function shouldIgnite(budget, estCostSonnetTokens, config) {
   if (!Number.isFinite(budget.weeklyRemainingPct) || !Number.isFinite(budget.weeklyRemainingTokensEst) || !Number.isFinite(estCostSonnetTokens) || !Number.isFinite(config.safetyMarginTokens)) {
@@ -553,6 +512,228 @@ function shouldIgnite(budget, estCostSonnetTokens, config) {
   return { go: true, reason: "session available and estimated cost fits within weekly headroom" };
 }
 
+// src/core/scheduler/native.ts
+import { homedir as homedir2 } from "os";
+import { join as join4 } from "path";
+function parseSimpleCron(cron) {
+  const parts = cron.trim().split(/\s+/);
+  if (parts.length !== 5) throw unsupportedCron(cron);
+  const [minutePart, hourPart, dom, month, dow] = parts;
+  if (dom !== "*" || month !== "*" || dow !== "*") throw unsupportedCron(cron);
+  const minute = Number(minutePart);
+  if (!Number.isInteger(minute) || minute < 0 || minute > 59) throw unsupportedCron(cron);
+  const allHours = Array.from({ length: 24 }, (_, h) => h);
+  let hours;
+  if (hourPart === "*") {
+    hours = allHours;
+  } else if (/^\*\/\d+$/.test(hourPart)) {
+    const step = Number(hourPart.slice(2));
+    if (step < 1 || step > 23) throw unsupportedCron(cron);
+    hours = allHours.filter((h) => h % step === 0);
+  } else if (/^\d+(,\d+)*$/.test(hourPart)) {
+    hours = hourPart.split(",").map(Number);
+    if (hours.some((h) => h < 0 || h > 23)) throw unsupportedCron(cron);
+  } else {
+    throw unsupportedCron(cron);
+  }
+  return { minute, hours };
+}
+function unsupportedCron(cron) {
+  return new Error(
+    `Cron expression "${cron}" is too complex for native scheduler installation. Supported shapes: "M * * * *", "M H * * *", "M */N * * *", "M H1,H2 * * *". Use \`afterburner watch\` for full cron support, or install a native entry manually.`
+  );
+}
+function nextSimpleCronFire(schedule2, now, timezone) {
+  const wallClock = new Intl.DateTimeFormat("en-GB", {
+    timeZone: timezone,
+    hour: "2-digit",
+    minute: "2-digit",
+    hourCycle: "h23"
+  });
+  const start = Math.floor(now.getTime() / 6e4 + 1) * 6e4;
+  for (let i = 0; i < 49 * 60; i++) {
+    const candidate = new Date(start + i * 6e4);
+    const parts = wallClock.formatToParts(candidate);
+    const hour = Number(parts.find((p) => p.type === "hour")?.value);
+    const minute = Number(parts.find((p) => p.type === "minute")?.value);
+    if (minute === schedule2.minute && schedule2.hours.includes(hour)) return candidate;
+  }
+  throw new Error(`No fire time within 49h for the schedule; is timezone "${timezone}" valid?`);
+}
+var launchdPlistPath = () => join4(homedir2(), "Library", "LaunchAgents", `${LAUNCHD_LABEL}.plist`);
+var systemdUnitPaths = () => {
+  const unitDir = join4(homedir2(), ".config", "systemd", "user");
+  return {
+    service: join4(unitDir, "afterburner.service"),
+    timer: join4(unitDir, "afterburner.timer")
+  };
+};
+function scheduleArtifactPaths(platform) {
+  switch (platform) {
+    case "darwin":
+      return [launchdPlistPath()];
+    case "linux": {
+      const units = systemdUnitPaths();
+      return [units.service, units.timer];
+    }
+    case "win32":
+      return [];
+  }
+}
+function generateScheduleArtifacts(platform, opts) {
+  const schedule2 = parseSimpleCron(opts.cron);
+  const command = [
+    opts.nodePath,
+    opts.cliPath,
+    "run-once",
+    ...opts.configPath ? ["--config", opts.configPath] : []
+  ];
+  switch (platform) {
+    case "darwin":
+      return launchdArtifacts(schedule2, opts, command);
+    case "linux":
+      return systemdArtifacts(schedule2, opts, command);
+    case "win32":
+      return schtasksArtifacts(schedule2, opts, command);
+  }
+}
+var LAUNCHD_LABEL = "io.afterburner.run-once";
+function launchdArtifacts(schedule2, opts, command) {
+  const plistPath = launchdPlistPath();
+  const intervals = schedule2.hours.map(
+    (hour) => `    <dict>
+      <key>Hour</key><integer>${hour}</integer>
+      <key>Minute</key><integer>${schedule2.minute}</integer>
+    </dict>`
+  ).join("\n");
+  const programArgs = command.map((arg) => `    <string>${escapeXml(arg)}</string>`).join("\n");
+  const content = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${LAUNCHD_LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+${programArgs}
+  </array>
+  <key>StartCalendarInterval</key>
+  <array>
+${intervals}
+  </array>
+  <key>StandardOutPath</key>
+  <string>/tmp/afterburner.out.log</string>
+  <key>StandardErrorPath</key>
+  <string>/tmp/afterburner.err.log</string>
+</dict>
+</plist>
+`;
+  return {
+    kind: "launchd",
+    files: [{ path: plistPath, content }],
+    activationHint: `launchctl load -w ${plistPath}
+(note: launchd schedules in LOCAL time; your configured timezone "${opts.timezone}" is not applied)`,
+    removalHint: `launchctl unload -w ${plistPath} && rm ${plistPath}`
+  };
+}
+function systemdArtifacts(schedule2, opts, command) {
+  const { service: servicePath, timer: timerPath } = systemdUnitPaths();
+  const minute = String(schedule2.minute).padStart(2, "0");
+  const onCalendarLines = schedule2.hours.map(
+    (hour) => `OnCalendar=*-*-* ${String(hour).padStart(2, "0")}:${minute}:00 ${opts.timezone}`
+  ).join("\n");
+  const execStart = command.map((arg) => systemdQuote(arg)).join(" ");
+  const service = `[Unit]
+Description=Afterburner single run (budget-gated, PR-only)
+
+[Service]
+Type=oneshot
+ExecStart=${execStart}
+`;
+  const timer = `[Unit]
+Description=Afterburner schedule
+
+[Timer]
+${onCalendarLines}
+Persistent=false
+
+[Install]
+WantedBy=timers.target
+`;
+  return {
+    kind: "systemd-user",
+    files: [
+      { path: servicePath, content: service },
+      { path: timerPath, content: timer }
+    ],
+    activationHint: `systemctl --user daemon-reload && systemctl --user enable --now afterburner.timer`,
+    removalHint: `systemctl --user disable --now afterburner.timer && rm ${servicePath} ${timerPath} && systemctl --user daemon-reload`
+  };
+}
+function schtasksArtifacts(schedule2, opts, command) {
+  const minute = String(schedule2.minute).padStart(2, "0");
+  const taskName = (hour) => `Afterburner-${String(hour).padStart(2, "0")}${minute}`;
+  const tr = command.map((arg) => `\\"${arg}\\"`).join(" ");
+  const createCommands = schedule2.hours.map(
+    (hour) => `schtasks /Create /TN "${taskName(hour)}" /TR "${tr}" /SC DAILY /ST ${String(hour).padStart(2, "0")}:${minute}`
+  ).join("\n");
+  const deleteCommands = schedule2.hours.map((hour) => `schtasks /Delete /TN "${taskName(hour)}" /F`).join("\n");
+  return {
+    kind: "schtasks",
+    files: [],
+    activationHint: `${createCommands}
+(run from cmd.exe; note: schtasks schedules in LOCAL time; your configured timezone "${opts.timezone}" is not applied)`,
+    removalHint: deleteCommands
+  };
+}
+function escapeXml(value) {
+  return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
+function systemdQuote(value) {
+  return /[\s"']/.test(value) ? `"${value.replaceAll('"', '\\"')}"` : value;
+}
+
+// src/core/store/run-store.ts
+import { appendFile, mkdir as mkdir2, readFile as readFile3 } from "fs/promises";
+import { dirname as dirname2 } from "path";
+var JsonlRunStore = class {
+  constructor(filePath = defaultRunStorePath()) {
+    this.filePath = filePath;
+  }
+  filePath;
+  async append(record) {
+    await mkdir2(dirname2(this.filePath), { recursive: true });
+    await appendFile(this.filePath, `${JSON.stringify(record)}
+`, "utf8");
+  }
+  async list() {
+    let raw;
+    try {
+      raw = await readFile3(this.filePath, "utf8");
+    } catch (error) {
+      if (error.code === "ENOENT") return [];
+      throw error;
+    }
+    return raw.split("\n").filter((line) => line.trim().length > 0).map((line) => JSON.parse(line));
+  }
+  async hasOpenOrMergedPr(fingerprint) {
+    const records = await this.list();
+    return records.some(
+      (r) => r.fingerprint === fingerprint && (r.outcome === "pr-opened" || !!r.prUrl)
+    );
+  }
+};
+
+// src/core/notify/console.ts
+var ConsoleNotifier = class {
+  async notify(record) {
+    const pr = record.prUrl ? ` pr=${record.prUrl}` : "";
+    console.log(
+      `[afterburner] ${record.outcome} ${record.category} "${record.title}" repo=${record.repoUrl} branch=${record.branch} est=${record.estCostSonnetTokens.toLocaleString("en-US")} sonnet-eq tokens${pr}`
+    );
+  }
+};
+
 // src/core/orchestrator.ts
 async function runOnce(deps) {
   const { config } = deps;
@@ -736,7 +917,7 @@ function liveDowngradeReason(config, liveFlag, configPath) {
 // src/core/tasks/selector.ts
 import { readdir as readdir2, readFile as readFile4, stat as stat2 } from "fs/promises";
 import { existsSync as existsSync2 } from "fs";
-import { basename, extname, join as join4, relative } from "path";
+import { basename, extname, join as join5, relative } from "path";
 var BASE_TASK_TOKENS = {
   security: 12e4,
   tests: 9e4,
@@ -855,7 +1036,7 @@ async function collectFiles(root) {
     const entries = await readdir2(dir, { withFileTypes: true });
     for (const entry of entries) {
       if (results.length >= MAX_FILES) return;
-      const fullPath = join4(dir, entry.name);
+      const fullPath = join5(dir, entry.name);
       if (entry.isDirectory()) {
         if (!SKIP_DIRS.has(entry.name)) await walk(fullPath);
         continue;
@@ -876,152 +1057,6 @@ async function collectFiles(root) {
   return results;
 }
 
-// src/core/scheduler/native.ts
-import { homedir as homedir2 } from "os";
-import { join as join5 } from "path";
-function parseSimpleCron(cron) {
-  const parts = cron.trim().split(/\s+/);
-  if (parts.length !== 5) throw unsupportedCron(cron);
-  const [minutePart, hourPart, dom, month, dow] = parts;
-  if (dom !== "*" || month !== "*" || dow !== "*") throw unsupportedCron(cron);
-  const minute = Number(minutePart);
-  if (!Number.isInteger(minute) || minute < 0 || minute > 59) throw unsupportedCron(cron);
-  const allHours = Array.from({ length: 24 }, (_, h) => h);
-  let hours;
-  if (hourPart === "*") {
-    hours = allHours;
-  } else if (/^\*\/\d+$/.test(hourPart)) {
-    const step = Number(hourPart.slice(2));
-    if (step < 1 || step > 23) throw unsupportedCron(cron);
-    hours = allHours.filter((h) => h % step === 0);
-  } else if (/^\d+(,\d+)*$/.test(hourPart)) {
-    hours = hourPart.split(",").map(Number);
-    if (hours.some((h) => h < 0 || h > 23)) throw unsupportedCron(cron);
-  } else {
-    throw unsupportedCron(cron);
-  }
-  return { minute, hours };
-}
-function unsupportedCron(cron) {
-  return new Error(
-    `Cron expression "${cron}" is too complex for native scheduler installation. Supported shapes: "M * * * *", "M H * * *", "M */N * * *", "M H1,H2 * * *". Use \`afterburner watch\` for full cron support, or install a native entry manually.`
-  );
-}
-function generateScheduleArtifacts(platform, opts) {
-  const schedule2 = parseSimpleCron(opts.cron);
-  const command = [
-    opts.nodePath,
-    opts.cliPath,
-    "run-once",
-    ...opts.configPath ? ["--config", opts.configPath] : []
-  ];
-  switch (platform) {
-    case "darwin":
-      return launchdArtifacts(schedule2, opts, command);
-    case "linux":
-      return systemdArtifacts(schedule2, opts, command);
-    case "win32":
-      return schtasksArtifacts(schedule2, opts, command);
-  }
-}
-var LAUNCHD_LABEL = "io.afterburner.run-once";
-function launchdArtifacts(schedule2, opts, command) {
-  const plistPath = join5(homedir2(), "Library", "LaunchAgents", `${LAUNCHD_LABEL}.plist`);
-  const intervals = schedule2.hours.map(
-    (hour) => `    <dict>
-      <key>Hour</key><integer>${hour}</integer>
-      <key>Minute</key><integer>${schedule2.minute}</integer>
-    </dict>`
-  ).join("\n");
-  const programArgs = command.map((arg) => `    <string>${escapeXml(arg)}</string>`).join("\n");
-  const content = `<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-  <key>Label</key>
-  <string>${LAUNCHD_LABEL}</string>
-  <key>ProgramArguments</key>
-  <array>
-${programArgs}
-  </array>
-  <key>StartCalendarInterval</key>
-  <array>
-${intervals}
-  </array>
-  <key>StandardOutPath</key>
-  <string>/tmp/afterburner.out.log</string>
-  <key>StandardErrorPath</key>
-  <string>/tmp/afterburner.err.log</string>
-</dict>
-</plist>
-`;
-  return {
-    kind: "launchd",
-    files: [{ path: plistPath, content }],
-    activationHint: `launchctl load -w ${plistPath}
-(note: launchd schedules in LOCAL time; your configured timezone "${opts.timezone}" is not applied)`,
-    removalHint: `launchctl unload -w ${plistPath} && rm ${plistPath}`
-  };
-}
-function systemdArtifacts(schedule2, opts, command) {
-  const unitDir = join5(homedir2(), ".config", "systemd", "user");
-  const servicePath = join5(unitDir, "afterburner.service");
-  const timerPath = join5(unitDir, "afterburner.timer");
-  const minute = String(schedule2.minute).padStart(2, "0");
-  const onCalendarLines = schedule2.hours.map(
-    (hour) => `OnCalendar=*-*-* ${String(hour).padStart(2, "0")}:${minute}:00 ${opts.timezone}`
-  ).join("\n");
-  const execStart = command.map((arg) => systemdQuote(arg)).join(" ");
-  const service = `[Unit]
-Description=Afterburner single run (budget-gated, PR-only)
-
-[Service]
-Type=oneshot
-ExecStart=${execStart}
-`;
-  const timer = `[Unit]
-Description=Afterburner schedule
-
-[Timer]
-${onCalendarLines}
-Persistent=false
-
-[Install]
-WantedBy=timers.target
-`;
-  return {
-    kind: "systemd-user",
-    files: [
-      { path: servicePath, content: service },
-      { path: timerPath, content: timer }
-    ],
-    activationHint: `systemctl --user daemon-reload && systemctl --user enable --now afterburner.timer`,
-    removalHint: `systemctl --user disable --now afterburner.timer && rm ${servicePath} ${timerPath} && systemctl --user daemon-reload`
-  };
-}
-function schtasksArtifacts(schedule2, opts, command) {
-  const minute = String(schedule2.minute).padStart(2, "0");
-  const taskName = (hour) => `Afterburner-${String(hour).padStart(2, "0")}${minute}`;
-  const tr = command.map((arg) => `\\"${arg}\\"`).join(" ");
-  const createCommands = schedule2.hours.map(
-    (hour) => `schtasks /Create /TN "${taskName(hour)}" /TR "${tr}" /SC DAILY /ST ${String(hour).padStart(2, "0")}:${minute}`
-  ).join("\n");
-  const deleteCommands = schedule2.hours.map((hour) => `schtasks /Delete /TN "${taskName(hour)}" /F`).join("\n");
-  return {
-    kind: "schtasks",
-    files: [],
-    activationHint: `${createCommands}
-(run from cmd.exe; note: schtasks schedules in LOCAL time; your configured timezone "${opts.timezone}" is not applied)`,
-    removalHint: deleteCommands
-  };
-}
-function escapeXml(value) {
-  return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
-}
-function systemdQuote(value) {
-  return /[\s"']/.test(value) ? `"${value.replaceAll('"', '\\"')}"` : value;
-}
-
 // src/core/scheduler/watch.ts
 import { schedule, validate } from "node-cron";
 function startWatch(opts) {
@@ -1071,13 +1106,17 @@ export {
   readUsageCache,
   writeUsageCache,
   budgetFromUsageCache,
-  looksRemoteRepoUrl,
-  JsonlRunStore,
   ClaudeUsageBudgetProvider,
   ManualBudgetProvider,
   createBudgetProvider,
-  ConsoleNotifier,
   shouldIgnite,
+  parseSimpleCron,
+  nextSimpleCronFire,
+  scheduleArtifactPaths,
+  generateScheduleArtifacts,
+  looksRemoteRepoUrl,
+  JsonlRunStore,
+  ConsoleNotifier,
   runOnce,
   ApiKeyRunner,
   taskFingerprint,
@@ -1092,7 +1131,5 @@ export {
   BASE_TASK_TOKENS,
   createSelector,
   DeterministicTaskSelector,
-  parseSimpleCron,
-  generateScheduleArtifacts,
   startWatch
 };

package/dist/cli/index.js

@@ -16,11 +16,15 @@ import {
   liveDowngradeReason,
   loadConfig,
   looksRemoteRepoUrl,
+  nextSimpleCronFire,
+  parseSimpleCron,
   readUsageCache,
   runOnce,
+  scheduleArtifactPaths,
+  shouldIgnite,
   startWatch,
   writeUsageCache
-} from "../chunk-OZAFLQDP.js";
+} from "../chunk-Z3H5GIPM.js";
 import {
   MCP_STUB_MESSAGE
 } from "../chunk-2NSOEZWY.js";
@@ -31,7 +35,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@pimmesz/afterburner",
-  version: "1.0.9",
+  version: "1.0.10",
   description: "Convert idle Claude subscription quota into shippable engineering work: budget-aware trigger, bounded task selection, PR-only output.",
   license: "Apache-2.0",
   publishConfig: {
@@ -337,12 +341,120 @@ async function runDoctor(opts) {
 ${green(`${deco(emoji.rocket)}All checks passed.`)}` : `
 ${red(`${failures} check(s) failed.`)}`
   );
+  let summary;
+  if (failures === 0 && config && config.repos.length > 0) {
+    try {
+      summary = await buildRunSummary(config);
+    } catch {
+    }
+  }
   console.log(
     `
-${renderDoctorNextSteps({ config, configPath, failed: results.filter((r) => !r.ok) })}`
+${renderDoctorNextSteps({
+      config,
+      configPath,
+      failed: results.filter((r) => !r.ok),
+      ...summary ? { summary } : {}
+    })}`
   );
   process.exitCode = failures === 0 ? 0 : 1;
 }
+async function buildRunSummary(config) {
+  let budget = null;
+  try {
+    budget = await createBudgetProvider(config).provider.getBudget();
+  } catch {
+  }
+  const platform = process.platform;
+  const probeable = platform === "darwin" || platform === "linux";
+  const paths = probeable ? scheduleArtifactPaths(platform) : [];
+  const scheduleInstalled = probeable ? paths.every((p) => existsSync2(p)) : "unknown";
+  return renderRunSummary({
+    config,
+    budget,
+    scheduleInstalled,
+    scheduleKind: platform === "linux" ? "systemd-user" : "launchd",
+    systemTimezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+    now: /* @__PURE__ */ new Date()
+  });
+}
+function renderRunSummary(opts) {
+  const { config, budget } = opts;
+  const repoNames = config.repos.map((r) => r.url);
+  const repoLabel = repoNames.length === 1 ? repoNames[0] : `${repoNames.length} repos`;
+  const categories = [
+    ...new Set(
+      config.repos.flatMap(
+        (r) => r.enabledTaskCategories.filter((c) => config.taskCategories[c].enabled)
+      )
+    )
+  ];
+  const what = categories.length === 0 ? `Would review ${repoLabel}, but every repo task category is switched off in taskCategories` : `Reviews ${repoLabel} for ${categories.join("/")} tasks`;
+  let why;
+  if (!budget) {
+    why = `Based on ${config.budget.provider}: no numbers available right now, so a run would refuse to start.`;
+  } else {
+    const gateConfig = {
+      minWeeklyHeadroomPct: config.budget.minWeeklyHeadroomPct,
+      safetyMarginTokens: config.budget.safetyMarginTokens,
+      requireSessionAvailable: config.budget.requireSessionAvailable
+    };
+    const fullSize = shouldIgnite(budget, config.agent.maxTaskTokens, gateConfig);
+    const anySize = fullSize.go ? fullSize : shouldIgnite(budget, 0, gateConfig);
+    const verdict = fullSize.go ? "the budget gate would let a run through right now" : anySize.go ? `a task at the ${formatTokens(config.agent.maxTaskTokens)}-token cap would not fit right now, though cheaper tasks still could` : `the budget gate would block any run right now (${fullSize.reason})`;
+    const usage = `${Math.round(budget.weeklyRemainingPct)}% of the weekly quota left (~${formatTokens(Math.round(budget.weeklyRemainingTokensEst))} tokens), 5-hour session ${budget.sessionAvailable ? "available" : "exhausted"}`;
+    why = `Based on ${config.budget.provider}: ${usage} \u2192 ${verdict}.`;
+  }
+  return `${section(emoji.thrust, "Summary")}
+  ${what} \u2014 at most one PR per run, up to ${formatTokens(config.agent.maxTaskTokens)} tokens.
+  ${renderWhen(opts)}
+  ${why}`;
+}
+function renderWhen(opts) {
+  const { config } = opts;
+  const cron = config.schedule.cron;
+  const cadence = describeCadence(cron);
+  if (opts.scheduleInstalled === false) {
+    return `When: no afterburner schedule is installed \u2014 it only runs when you start it; \`afterburner schedule install\` would run it ${cadence}.`;
+  }
+  if (opts.scheduleInstalled === "unknown") {
+    return `When: ${cadence}, once the entries from \`afterburner schedule install\` are active (not auto-detectable on this platform).`;
+  }
+  const zone = opts.scheduleKind === "systemd-user" ? config.schedule.timezone : opts.systemTimezone;
+  const kindLabel = opts.scheduleKind === "systemd-user" ? "systemd" : "launchd";
+  const zoneNote = opts.scheduleKind === "launchd" && zone !== config.schedule.timezone ? ` \u2014 launchd fires in local ${zone} time, not the configured ${config.schedule.timezone}` : "";
+  try {
+    const next = nextSimpleCronFire(parseSimpleCron(cron), opts.now, zone);
+    const formatted = new Intl.DateTimeFormat("en-GB", {
+      timeZone: zone,
+      weekday: "short",
+      day: "numeric",
+      month: "short",
+      hour: "2-digit",
+      minute: "2-digit",
+      hourCycle: "h23"
+    }).format(next);
+    return `When: next run ${formatted} (${zone}), then ${cadence} \u2014 via the installed ${kindLabel} entry, if activated and in sync with this config${zoneNote}.`;
+  } catch {
+    return `When: an installed ${kindLabel} entry runs it on cron '${cron}' (${zone}), if activated.`;
+  }
+}
+function describeCadence(cron) {
+  let minute;
+  let hours;
+  try {
+    ({ minute, hours } = parseSimpleCron(cron));
+  } catch {
+    return `on cron '${cron}'`;
+  }
+  if (hours.length === 24) return `every hour at minute ${minute}`;
+  const step2 = (hours[1] ?? 0) - (hours[0] ?? 0);
+  const uniform = hours.length > 1 && hours[0] === 0 && 24 % step2 === 0 && hours.length === 24 / step2 && hours.every((h, i) => h === i * step2);
+  if (uniform) return `every ${step2} hours at minute ${minute}`;
+  const mm = String(minute).padStart(2, "0");
+  const times = hours.map((h) => `${String(h).padStart(2, "0")}:${mm}`);
+  return `daily at ${times.join(", ")}`;
+}
 function renderDoctorNextSteps(opts) {
   const next = section(emoji.rocket, "Next");
   if (!opts.config || !opts.configPath) {
@@ -379,13 +491,15 @@ ${nextCmd(cmd("doctor"))}`;
   Repos:  ${repoLine}
   Engine: ${engineLine}
   Budget: ${budgetLine}
-  Limits: at most one task per repo per run, capped at ${config.agent.maxTaskTokens.toLocaleString("en-US")} tokens, delivered as one PR on its own branch
+  Limits: at most one task per run, capped at ${config.agent.maxTaskTokens.toLocaleString("en-US")} tokens, delivered as one PR on its own branch
   Gate:   ${gateLine}
   Safety: live PRs need BOTH a live engine in the config AND --live (two-part opt-in)
   Runs:   only when you start them \u2014 \`afterburner schedule install\` (recommended OS scheduler; cron '${config.schedule.cron}' ${config.schedule.timezone}) or \`afterburner watch\` (foreground) make it recurring
   Stop:   \`afterburner schedule uninstall\` (or Ctrl-C for watch); ${cmd("log")} lists every past run
 
-${next}
+${opts.summary ? `${opts.summary}
+
+` : ""}${next}
 ${nextCmd(cmd("run-once --dry-run"), nextNote)}`;
 }
 function checkVersion(opts) {

package/dist/core/index.js

@@ -45,7 +45,7 @@ import {
   summarizeTranscriptUsage,
   taskFingerprint,
   writeUsageCache
-} from "../chunk-OZAFLQDP.js";
+} from "../chunk-Z3H5GIPM.js";
 export {
   ApiKeyRunner,
   BASE_TASK_TOKENS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pimmesz/afterburner",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "description": "Convert idle Claude subscription quota into shippable engineering work: budget-aware trigger, bounded task selection, PR-only output.",
   "license": "Apache-2.0",
   "publishConfig": {