karajan-code 3.13.0 → 3.13.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "karajan-code",
-  "version": "3.13.0",
+  "version": "3.13.1",
   "description": "Local multi-agent coding orchestrator with TDD, SonarQube, and code review pipeline",
   "type": "module",
   "license": "AGPL-3.0",

package/src/config/defaults.js

@@ -55,7 +55,10 @@ const DEFAULTS = {
   review_mode: "standard",
   max_iterations: 5,
   hu_max_iterations: 3,
-  max_budget_usd: null,
+  // Hard per-run spend ceiling, ON by default (KJC-TSK-0621): a stuck or
+  // runaway run must never drain a subscription quota unattended. Explicit
+  // null in the user's config opts out (no cap).
+  max_budget_usd: 5,
   review_rules: "./.karajan/review-rules.md",
   coder_rules: "./.karajan/coder-rules.md",
   base_branch: "main",

package/src/config/overrides.js

@@ -172,8 +172,14 @@ export function applyRunOverrides(config, flags) {
   out.git = out.git || {};
   out.development = out.development || {};
   out.sonarqube = out.sonarqube || {};
-  if (out.max_budget_usd === undefined || out.max_budget_usd === null) {
-    out.max_budget_usd = out.session.max_budget_usd ?? null;
+  // Precedence: explicit top-level value (including null = opt-out) wins;
+  // the legacy session.max_budget_usd location next; the shipped default
+  // (KJC-TSK-0621: 5) last. When top-level still carries the default, a
+  // session-level value — including an explicit null — takes over.
+  if (out.max_budget_usd === undefined) {
+    out.max_budget_usd = out.session.max_budget_usd !== undefined ? out.session.max_budget_usd : DEFAULTS.max_budget_usd;
+  } else if (out.max_budget_usd === DEFAULTS.max_budget_usd && out.session.max_budget_usd !== undefined) {
+    out.max_budget_usd = out.session.max_budget_usd;
   }
   out.budget = mergeDeep(DEFAULTS.budget, out.budget || {});
   out.roles = mergeDeep(DEFAULTS.roles, out.roles || {});

package/src/orchestrator/flow-control.js

@@ -153,7 +153,11 @@ export async function checkBudgetExceeded({ budgetTracker, config, session, emit
 
   await markSessionStatus(session, "failed");
   const totalCost = budgetTracker.total().cost_usd;
-  const message = `Budget exceeded: $${totalCost.toFixed(2)} > $${budgetLimit.toFixed(2)}`;
+  const limit = Number(budgetLimit ?? config?.max_budget_usd);
+  const message =
+    `Budget exceeded: $${totalCost.toFixed(2)} > $${limit.toFixed(2)}. ` +
+    `Continue consciously with \`kj resume ${session.id}\`, or raise the cap ` +
+    `(max_budget_usd in .karajan/kj.config.yml; null removes it).`;
   emitProgress(
     emitter,
     makeEvent("session:end", { ...eventBase, iteration: i, stage: "budget" }, {

package/templates/kj.config.yml

@@ -114,5 +114,7 @@ output:
 session:
   max_iteration_minutes: 15
   max_total_minutes: 120
-  max_budget_usd: null
+  # Hard per-run spend ceiling (USD-equivalent). The run stops with a summary
+  # when exceeded; resume with `kj resume`. Set to null to remove the cap.
+  max_budget_usd: 5
   fail_fast_repeats: 2