@pimmesz/afterburner 1.0.13 → 1.0.14

package/README.md

@@ -256,6 +256,7 @@ writes `.mjs` by default. There's a commented example in
 | `agent.modelByCategory`               | sonnet/opus/haiku mix  | Per-category model routing. Plain strings, so a new model never breaks the config.                                                  |
 | `agent.maxTaskTokens`                 | `200_000`              | Hard per-task ceiling in Sonnet-equivalent tokens                                                                                   |
 | `agent.allowFable`                    | `false`                | Explicit opt-in for Fable-family models                                                                                             |
+| `notify.desktop`                      | `false`                | Desktop banner per completed run (macOS/Linux/Windows), opt-in; the PR stays the primary signal                                     |
 | `taskCategories`                      | all enabled, weighted  | Per-category enable/disable plus a ranking weight                                                                                   |
 
 Task categories are `security`, `tests`, `types-lint`, `dead-code`, `perf`, `infra`, and

package/afterburner.config.example.ts

@@ -72,7 +72,8 @@ const config = {
     backend: 'dry-run',
     // Per-category model routing. Plain strings on purpose, so a new model
     // can't break the config. Omitted categories use the built-in defaults
-    // (sonnet for most, opus for perf and infra, haiku for the simple end).
+    // (sonnet for security and tests, opus for perf and infra, haiku for the
+    // simple end: types-lint, dead-code, docs).
     modelByCategory: {
       perf: 'claude-opus-4-8',
       docs: 'claude-haiku-4-5',

package/dist/{chunk-4TD2KS3A.js → chunk-HAERJCAI.js}

@@ -495,7 +495,7 @@ function createBudgetProvider(config, opts = {}) {
 
 // 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)) {
+  if (!Number.isFinite(budget.weeklyRemainingPct) || !Number.isFinite(budget.weeklyRemainingTokensEst) || !Number.isFinite(estCostSonnetTokens) || !Number.isFinite(config.safetyMarginTokens) || !Number.isFinite(config.minWeeklyHeadroomPct)) {
     return { go: false, reason: "budget or estimate is not a finite number; refusing to ignite" };
   }
   if (config.requireSessionAvailable && !budget.sessionAvailable) {
@@ -514,7 +514,10 @@ function shouldIgnite(budget, estCostSonnetTokens, config) {
       reason: `weekly cap: task needs ~${needed.toLocaleString("en-US")} Sonnet-eq tokens (incl. ${config.safetyMarginTokens.toLocaleString("en-US")} safety margin) but only ~${budget.weeklyRemainingTokensEst.toLocaleString("en-US")} remain`
     };
   }
-  return { go: true, reason: "session available and estimated cost fits within weekly headroom" };
+  return {
+    go: true,
+    reason: `${budget.sessionAvailable ? "session available" : "session check waived"} and estimated cost fits within weekly headroom`
+  };
 }
 
 // src/core/scheduler/native.ts

package/dist/cli/index.js

@@ -25,7 +25,7 @@ import {
   shouldIgnite,
   startWatch,
   writeUsageCache
-} from "../chunk-4TD2KS3A.js";
+} from "../chunk-HAERJCAI.js";
 import {
   MCP_STUB_MESSAGE
 } from "../chunk-2NSOEZWY.js";
@@ -36,7 +36,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@pimmesz/afterburner",
-  version: "1.0.13",
+  version: "1.0.14",
   description: "Convert idle Claude subscription quota into shippable engineering work: budget-aware trigger, bounded task selection, PR-only output.",
   license: "Apache-2.0",
   publishConfig: {
@@ -485,7 +485,7 @@ ${nextCmd(cmd("doctor"))}`;
   const repoLine = repoNames.length <= 2 ? repoNames.join(", ") : `${repoNames.slice(0, 2).join(", ")} (and ${repoNames.length - 2} more)`;
   const engineLine = config.agent.backend === "dry-run" ? "dry-run \u2014 simulation only; set agent.backend: 'claude-code' in the config to do real work" : config.agent.backend === "claude-code" ? "claude-code \u2014 spends subscription quota you already pay for; PRs only with --live" : "api-key \u2014 bills your Anthropic API account per token (real money); PRs only with --live";
   const budgetLine = config.budget.provider === "manual" ? "manual \u2014 trusts budget.manual (automatic option: `afterburner statusline install`, then budget.provider: 'claude-usage')" : config.budget.provider === "claude-usage" ? "claude-usage \u2014 reads your real usage via the status line hook" : "claude-code-transcripts \u2014 estimates from local Claude Code session logs";
-  const nextNote = config.agent.backend === "dry-run" ? "previews the next task; nothing is executed or spent" : `previews the next task (live execution ships in a future release; ${cmd("run-once --live")} currently validates and refuses)`;
+  const nextNote = config.agent.backend === "dry-run" ? "previews the next task; nothing is executed or spent" : `previews the next task (live execution ships in a future release; ${cmd("run-once --live")} currently arms LIVE then exits with a not-implemented error \u2014 no PR is opened)`;
   const stopLine = `\`afterburner schedule uninstall\` (or Ctrl-C for watch); ${cmd("log")} lists every past run`;
   if (opts.summary) {
     return `${section(emoji.flame, "Ready")}
@@ -1122,7 +1122,7 @@ async function collectAnswers(rl, opts, cwd = process.cwd()) {
   let targetDir = cwd;
   let target = join2(targetDir, "afterburner.config.mjs");
   console.log(
-    "Afterburner turns unused Claude subscription quota into small, reviewed pull requests.\nDry-run first: nothing executes or spends until a live engine is set in the config\nAND you pass --live. Three questions, then an optional health check.\n"
+    "Afterburner turns unused Claude subscription quota into small, reviewed pull requests.\nDry-run first: nothing executes or spends until a live engine is set in the config\nAND you pass --live. (No run can open a PR yet \u2014 live execution ships in a future\nrelease.) Three questions, then an optional health check.\n"
   );
   console.log(bold("Step 1 of 3 \u2014 Engine (who does the work, and what it can spend)"));
   OFFERED_BACKENDS.forEach((name, i) => {
@@ -1354,7 +1354,7 @@ function registerMcp(program2) {
 // src/cli/commands/run-once.ts
 function registerRunOnce(program2) {
   program2.command("run-once").description(
-    "Run one ignition cycle: pick at most one bounded task per configured repo (dry-run by default)"
+    "Run one ignition cycle: pick at most one bounded task per run (dry-run by default)"
   ).option("--config <path>", "path to a config file").option("--dry-run", "force a dry run (this is the default behavior)").option(
     "--live",
     "arm live execution; only takes effect when agent.backend is also a live engine in the config (two-part opt-in)"
@@ -1442,7 +1442,7 @@ ${section(emoji.rocket, "Next")}`);
       console.log(
         config.agent.backend === "dry-run" ? `  This was a preview. Live execution ships in a future release; once it does,
   set agent.backend: 'claude-code' in ${filepath}, then: ${liveCmd}` : `  This was a preview. Live execution ships in a future release;
-  ${liveCmd} currently validates the setup and refuses.`
+  ${liveCmd} currently arms LIVE then exits with a not-implemented error (no PR is opened).`
       );
     }
   });
@@ -1910,7 +1910,7 @@ function renderWelcome(configPath) {
       cmd("afterburner run-once --dry-run", "preview the next task (no changes made)"),
       cmd(
         "afterburner run-once --live",
-        "real PRs (stubbed in this version; validates and refuses)"
+        "real PRs (stubbed in this version; arms LIVE then errors out, no PR opened)"
       ),
       cmd("afterburner log", "recent run history")
     );

package/dist/core/index.d.ts

@@ -673,10 +673,12 @@ declare class JsonlRunStore implements RunStore {
 }
 
 /**
- * Notification seam. Core ships ONLY ConsoleNotifier: the pull request is the
- * real notification and the run store is the audit trail. This interface is
- * the documented extension point for a future opt-in generic webhook, vendor
- * SDKs are never bundled into core.
+ * Notification seam. ConsoleNotifier always runs — its line is the audit trail
+ * that reaches the scheduler's stdout log — and an opt-in DesktopNotifier
+ * (OS-native banner, gated by notify.desktop) layers on top via
+ * CompositeNotifier/createNotifier. The pull request stays the real
+ * notification and the run store the source of truth. Notifiers shell out to
+ * platform tools; vendor SDKs are never bundled into core.
  */
 interface Notifier {
     notify(record: RunRecord): Promise<void>;
@@ -748,11 +750,12 @@ interface GateDecision {
     reason: string;
 }
 /**
- * Both-caps gate, a non-negotiable rule encoded as a pure function: only fire
- * when a session window is available AND the estimated cost plus the safety
- * margin fits inside the remaining weekly budget (with the configured
- * headroom). Reasons are returned, not just booleans, so every skipped run is
- * explainable in the log.
+ * Both-caps gate encoded as a pure function: only fire when the estimated cost
+ * plus the safety margin fits inside the remaining weekly budget (with the
+ * configured headroom) — the non-negotiable weekly cap — AND, when
+ * config.requireSessionAvailable is set (the default), a 5-hour session window
+ * is also free. Reasons are returned, not just booleans, so every skipped run
+ * is explainable in the log.
  */
 declare function shouldIgnite(budget: Budget, estCostSonnetTokens: number, config: GateConfig): GateDecision;
 

package/dist/core/index.js

@@ -49,7 +49,7 @@ import {
   summarizeTranscriptUsage,
   taskFingerprint,
   writeUsageCache
-} from "../chunk-4TD2KS3A.js";
+} from "../chunk-HAERJCAI.js";
 export {
   ApiKeyRunner,
   BASE_TASK_TOKENS,

package/package.json

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