karajan-code 3.15.0 → 3.15.2

package/README.md

@@ -234,7 +234,7 @@ Karajan ships as **layers you opt into**. The base CLI is tiny (~5 MB). Heavier
 - **Pipeline RAM peak**: 1–2 GB per `kj run` (one orchestrator + one coder + one reviewer subprocess at a time).
 - **SQLite is in-process.** No separate DB daemon. `~/.karajan/` is a folder, not a service.
 - **First-run Ollama pull**: ~5 min in the background; you can keep working — `kj` falls back to a cloud embedder if Ollama isn't ready yet.
-- **Runtime**: Node.js ≥ 22.22.1 (Active LTS). v3.0.0 dropped Node 20 support. Use `kj doctor` to verify your environment.
+- **Runtime**: Node.js ≥ 22.12.0 (Active LTS). v3.0.0 dropped Node 20 support. Use `kj doctor` to verify your environment.
 
 ## Two ways to use Karajan
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "karajan-code",
-  "version": "3.15.0",
+  "version": "3.15.2",
   "description": "Local multi-agent coding orchestrator with TDD, SonarQube, and code review pipeline",
   "type": "module",
   "license": "AGPL-3.0",
@@ -24,7 +24,7 @@
     "cli"
   ],
   "engines": {
-    "node": ">=22.22.1"
+    "node": ">=22.12.0"
   },
   "kj": {
     "harden": {

package/packages/ai-trash/package.json

@@ -25,7 +25,7 @@
     "aider"
   ],
   "engines": {
-    "node": ">=22.22.1"
+    "node": ">=22.12.0"
   },
   "bin": {
     "kj-trash": "bin/kj-trash.js"

package/packages/hu-board/package.json

@@ -5,7 +5,7 @@
   "type": "module",
   "private": true,
   "engines": {
-    "node": ">=22.22.1"
+    "node": ">=22.12.0"
   },
   "scripts": {
     "start": "node src/server.js",

package/src/brain/agent-error-classifier.js

@@ -31,7 +31,11 @@ export const ERROR_CLASS = Object.freeze({
 const ONE_HOUR_MS = 60 * 60 * 1000;
 const ONE_WEEK_MS = 7 * 24 * 60 * 60 * 1000;
 
-const AUTH_PATTERNS = /\b401\b|\b403\b|unauthorized|invalid\s+api\s+key|authentication\s+failed|expired\s+token/i;
+// `error\s+authenticating` + `IneligibleTierError` (KJC-BUG-0113): the
+// retired Gemini Code Assist CLI fails with "Error authenticating:
+// IneligibleTierError … migrate to Antigravity" — it classified as
+// UNKNOWN_FATAL and left the run without the AUTH escalation message.
+const AUTH_PATTERNS = /\b401\b|\b403\b|unauthorized|invalid\s+api\s+key|authentication\s+failed|expired\s+token|error\s+authenticating|IneligibleTierError/i;
 const SILENCED_PATTERNS = /killed\s+after\s+\d+\s*ms|silence\s*timeout|no\s+output\s+for\s+\d+/i;
 // `session\s+limit` / `weekly\s+limit` cover Claude Code's usage caps
 // ("You've hit your session limit · resets 10:10pm"). Without them the

package/src/checks/node.js

@@ -2,8 +2,12 @@
  * Node.js runtime version check. Requires Node >= 22 — the Active LTS
  * baseline since Karajan v3.0.0 (KJC-TSK-0500, 2026-06-03). Node 20 was
  * dropped because (a) Node 20 reaches EOL on 2026-04-30 and (b) three
- * dependencies forced the bump: lint-staged 17 needs ≥22.22.1, commander
- * 15 needs ≥22.12.0, and better-sqlite3 v12.10+ dropped Node 20 prebuilds.
+ * dependencies forced the bump: commander 15 needs ≥22.12.0 and
+ * better-sqlite3 v12.10+ dropped Node 20 prebuilds. engines.node is
+ * ">=22.12.0" — the highest RUNTIME floor. KJC-BUG-0111: it briefly sat
+ * at 22.22.1 (lint-staged 17's floor — a devDependency end users never
+ * run) and npm silently served karajan-code@2.34.0 to every Node
+ * 22.0-22.21 install; keep dev-tool floors out of engines.
  * Strategy: manual — we cannot auto-upgrade the runtime. Users on older
  * Node get a clear upgrade instruction with nvm + brew hints instead of a
  * silent runtime crash.

package/src/git/automation.js

@@ -16,7 +16,8 @@ import {
   commitAll,
   pushBranch,
   createPullRequest,
-  listPendingPaths
+  listPendingPaths,
+  hasRemote
 } from "../utils/git.js";
 
 /**
@@ -276,7 +277,19 @@ export async function finalizeGitAutomation({ config, gitCtx, task, logger, sess
     logger.info(committed ? "Committed changes" : "No changes to commit");
   }
 
-  if (config.git.auto_push || config.git.auto_pr) {
+  // KJC-BUG-0112: without an `origin` remote (the quickstart scenario:
+  // fresh folder + git init) push/PR automation has nothing to talk to —
+  // fetchBase used to throw here and escalate to Solomon on EVERY
+  // iteration, burning the whole budget on an expected condition.
+  const remoteAvailable = (config.git.auto_push || config.git.auto_pr)
+    ? await hasRemote()
+    : false;
+  if ((config.git.auto_push || config.git.auto_pr) && !remoteAvailable) {
+    logger.info("No remote configured — skipping push/PR automation");
+    await addCheckpoint(session, { stage: "git-push", skipped: "no-remote" });
+  }
+
+  if (remoteAvailable && (config.git.auto_push || config.git.auto_pr)) {
     await fetchBase(gitCtx.baseBranch);
     await ensureBranchUpToDateWithBase({
       branch: gitCtx.branch,
@@ -286,14 +299,14 @@ export async function finalizeGitAutomation({ config, gitCtx, task, logger, sess
     await addCheckpoint(session, { stage: "git-rebase-check", branch: gitCtx.branch });
   }
 
-  if (config.git.auto_push || config.git.auto_pr) {
+  if (remoteAvailable && (config.git.auto_push || config.git.auto_pr)) {
     await pushBranch(gitCtx.branch);
     await addCheckpoint(session, { stage: "git-push", branch: gitCtx.branch });
     logger.info(`Pushed branch: ${gitCtx.branch}`);
   }
 
   let prUrl = session.ci_pr_url || null;
-  if (config.git.auto_pr && !prUrl) {
+  if (remoteAvailable && config.git.auto_pr && !prUrl) {
     const body = buildPrBody({ task, stageResults });
     prUrl = await createPullRequest({
       baseBranch: gitCtx.baseBranch,

package/src/orchestrator/solomon-escalation.js

@@ -123,7 +123,11 @@ export async function invokeSolomon({ config, logger, emitter, eventBase, stage,
     return escalateToHuman({ askQuestion, session, emitter, eventBase, stage, conflict, iteration });
   }
 
-  const solomonProvider = config?.roles?.solomon?.provider || "gemini";
+  // KJC-BUG-0113: the fallback used to be "gemini" — Google retired the
+  // Gemini Code Assist CLI for individuals (IneligibleTierError), so an
+  // unconfigured Solomon died on every escalation. Claude matches the
+  // brain.provider default.
+  const solomonProvider = config?.roles?.solomon?.provider || "claude";
   emitProgress(
     emitter,
     makeEvent("solomon:start", { ...eventBase, stage: "solomon" }, {

package/src/roles/commiter-role.js

@@ -8,7 +8,8 @@ import {
   commitAll,
   pushBranch,
   createPullRequest,
-  revParse
+  revParse,
+  hasRemote
 } from "../utils/git.js";
 
 function buildCommitMessage(task) {
@@ -59,7 +60,13 @@ export class CommiterRole extends BaseRole {
     await commitAll(msg);
     const commitHash = await revParse("HEAD");
 
-    if (push) {
+    // KJC-BUG-0112: no `origin` remote (quickstart scenario) → skip
+    // push/PR instead of throwing on fetch.
+    const remoteAvailable = push ? await hasRemote() : false;
+    if (push && !remoteAvailable) {
+      this.logger?.info?.("No remote configured — skipping push/PR");
+    }
+    if (push && remoteAvailable) {
       const baseBranch = this.config.base_branch || "main";
       await fetchBase(baseBranch);
       await ensureBranchUpToDateWithBase({
@@ -71,7 +78,7 @@ export class CommiterRole extends BaseRole {
     }
 
     let prUrl = null;
-    if (push && createPr) {
+    if (push && createPr && remoteAvailable) {
       const baseBranch = this.config.base_branch || "main";
       prUrl = await createPullRequest({
         baseBranch,

package/src/utils/agent-detect.js

@@ -12,7 +12,10 @@ const KNOWN_AGENTS = [
 
 export async function checkBinary(name, versionArg = "--version") {
   const resolved = resolveBin(name);
-  const res = await runCommand(resolved, [versionArg]);
+  // KJC-BUG-0113: a zombie CLI that hangs on --version (seen with the
+  // retired Gemini Code Assist binary) must not hang init/preflight —
+  // 5s is generous for a version print.
+  const res = await runCommand(resolved, [versionArg], { timeout: 5000 });
   const version = (res.stdout || res.stderr || "").split("\n")[0].trim();
   return { ok: res.exitCode === 0, version, path: resolved };
 }

package/src/utils/git.js

@@ -251,6 +251,16 @@ export async function commitAll(message, cwd = null) {
   return { committed: true, commit: { hash, message: commitMessage } };
 }
 
+/**
+ * KJC-BUG-0112: whether the repo has an `origin` remote. The quickstart
+ * scenario (fresh folder + git init) has none — post-approval push/PR
+ * automation must skip instead of failing and escalating to Solomon.
+ */
+export async function hasRemote(cwd = null) {
+  const res = await run("git", ["remote", "get-url", "origin"], cwd ? { cwd } : {});
+  return res.exitCode === 0;
+}
+
 export async function pushBranch(branch, cwd = null) {
   await runGit(["push", "-u", "origin", branch], cwd ? { cwd } : {});
 }