gnhf 0.1.27 → 0.1.29

package/README.md

@@ -45,7 +45,7 @@ gnhf is a [ralph](https://ghuntley.com/ralph/), [autoresearch](https://github.co
 You wake up to a branch full of clean work and a log of everything that happened.
 
 - **Dead simple** — one command starts an autonomous loop that runs until you request stop or a configured runtime cap is reached
-- **Long running** — each iteration is committed on success, rolled back on failure, with sensible retries; hard agent errors back off exponentially while agent-reported failures continue immediately
+- **Long running** — each iteration is committed on success, rolled back on failure, with sensible retries; retryable hard agent errors back off exponentially while agent-reported failures continue immediately
 - **Live terminal title** — interactive runs keep your terminal title updated with live status, token totals, and commit count, then restore the previous title on exit
 - **Agent-agnostic**: works with Claude Code, Codex, Rovo Dev, OpenCode, GitHub Copilot CLI, or Pi out of the box
 
@@ -129,14 +129,16 @@ npm link
                    ▼   ▼                                   │
               ┌────────────┐    yes   ┌──────────┐         │
               │ 3 consec.  ├─────────►│  abort   │         │
-              │ failures?  │          └──────────┘         │
+              │ failures   │          └────▲─────┘         │
+              │ or perm.   ├───────────────┘               │
+              │ error?     │                               │
               └─────┬──────┘                               │
                  no │                                      │
                     └──────────────────────────────────────┘
 ```
 
 - **Incremental commits** — each successful iteration is a separate git commit, so you can cherry-pick or revert individual changes
-- **Failure handling** - all failed iterations are rolled back with `git reset --hard`; agent-reported failures proceed to the next iteration immediately, while hard agent errors use exponential backoff
+- **Failure handling** - all failed iterations are rolled back with `git reset --hard`; agent-reported failures proceed to the next iteration immediately, retryable hard agent errors use exponential backoff, and permanent agent errors such as Claude low credit balance abort immediately and print the run log path
 - **Runtime caps** - `--max-iterations` stops before the next iteration begins, `--max-tokens` can abort mid-iteration once reported usage reaches the cap, and `--stop-when` ends the loop after an iteration whose agent output reports the natural-language condition is met; resumed runs reuse the saved stop condition unless you pass a new value, or `--stop-when ""` to clear it; uncommitted work is rolled back in either case, and in the interactive TUI the final state remains visible until you press Ctrl+C to exit
 - **Iteration finalization** - agents are expected to finish validation, stop any background processes they started, and only then emit the final JSON result for the iteration
 - **Graceful interrupts** - in the interactive TUI, the first Ctrl+C requests a graceful stop and lets the current iteration finish (or ends backoff early), the second Ctrl+C force-stops immediately, and `SIGTERM` also force-stops immediately
@@ -172,15 +174,15 @@ If you run `gnhf` on an existing `gnhf/` branch with a different prompt, gnhf as
 
 ### Flags
 
-| Flag                     | Description                                                                | Default                |
-| ------------------------ | -------------------------------------------------------------------------- | ---------------------- |
+| Flag                     | Description                                                                 | Default                |
+| ------------------------ | --------------------------------------------------------------------------- | ---------------------- |
 | `--agent <agent>`        | Agent to use (`claude`, `codex`, `rovodev`, `opencode`, `copilot`, or `pi`) | config file (`claude`) |
-| `--max-iterations <n>`   | Abort after `n` total iterations                                           | unlimited              |
-| `--max-tokens <n>`       | Abort after `n` total input+output tokens                                  | unlimited              |
-| `--stop-when <cond>`     | End the loop when the agent reports this condition; persists across resume | unlimited              |
-| `--prevent-sleep <mode>` | Prevent system sleep during the run (`on`/`off` or `true`/`false`)         | config file (`on`)     |
-| `--worktree`             | Run in a separate git worktree (enables multiple agents concurrently)      | `false`                |
-| `--version`              | Show version                                                               |                        |
+| `--max-iterations <n>`   | Abort after `n` total iterations                                            | unlimited              |
+| `--max-tokens <n>`       | Abort after `n` total input+output tokens                                   | unlimited              |
+| `--stop-when <cond>`     | End the loop when the agent reports this condition; persists across resume  | unlimited              |
+| `--prevent-sleep <mode>` | Prevent system sleep during the run (`on`/`off` or `true`/`false`)          | config file (`on`)     |
+| `--worktree`             | Run in a separate git worktree (enables multiple agents concurrently)       | `false`                |
+| `--version`              | Show version                                                                |                        |
 
 ## Configuration
 
@@ -263,8 +265,8 @@ Including a snippet of `gnhf.log` is the single most useful thing you can attach
 | ------------------ | ------------------ | -------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Claude Code        | `--agent claude`   | Install Anthropic's `claude` CLI and sign in first.                        | `gnhf` invokes `claude` directly in non-interactive mode. After Claude emits a successful structured result, `gnhf` treats that result as final and shuts down any lingering Claude process tree after a short grace period. |
 | Codex              | `--agent codex`    | Install OpenAI's `codex` CLI and sign in first.                            | `gnhf` invokes `codex exec` directly in non-interactive mode.                                                                                                                                                                |
-| GitHub Copilot CLI | `--agent copilot`  | Install GitHub Copilot CLI and sign in first.                              | `gnhf` invokes `copilot` directly in non-interactive JSONL mode. Copilot currently exposes assistant output tokens, but not full input/cache token totals; see https://github.com/github/copilot-cli/issues/1152.             |
-| Pi                 | `--agent pi`       | Install the `pi` CLI and configure a usable provider/model first.          | `gnhf` invokes `pi` directly in JSON mode, appends the final output schema to the prompt, and disables Pi session persistence with `--no-session`.                                                                          |
+| GitHub Copilot CLI | `--agent copilot`  | Install GitHub Copilot CLI and sign in first.                              | `gnhf` invokes `copilot` directly in non-interactive JSONL mode. Copilot currently exposes assistant output tokens, but not full input/cache token totals; see https://github.com/github/copilot-cli/issues/1152.            |
+| Pi                 | `--agent pi`       | Install the `pi` CLI and configure a usable provider/model first.          | `gnhf` invokes `pi` directly in JSON mode, appends the final output schema to the prompt, and disables Pi session persistence with `--no-session`.                                                                           |
 | Rovo Dev           | `--agent rovodev`  | Install Atlassian's `acli` and authenticate it with Rovo Dev first.        | `gnhf` starts a local `acli rovodev serve --disable-session-token <port>` process automatically in the repo workspace.                                                                                                       |
 | OpenCode           | `--agent opencode` | Install `opencode` and configure at least one usable model provider first. | `gnhf` starts a local `opencode serve --hostname 127.0.0.1 --port <port> --print-logs` process automatically, creates a per-run session, and applies a blanket allow rule so tool calls do not block on prompts.             |
 

package/dist/cli.mjs

@@ -492,6 +492,14 @@ function buildAgentOutputSchema(opts) {
 		required
 	};
 }
+var PermanentAgentError = class extends Error {
+	detail;
+	constructor(message, detail) {
+		super(message, { cause: detail });
+		this.name = "PermanentAgentError";
+		this.detail = detail;
+	}
+};
 //#endregion
 //#region src/core/run.ts
 const LOG_FILENAME = "gnhf.log";
@@ -1177,6 +1185,9 @@ function isSameUsage$1(a, b) {
 function extendsUsage(next, previous) {
 	return next.inputTokens >= previous.inputTokens && next.outputTokens >= previous.outputTokens && next.cacheReadTokens >= previous.cacheReadTokens && next.cacheCreationTokens >= previous.cacheCreationTokens && !isSameUsage$1(next, previous);
 }
+function isPermanentClaudeError(stderr) {
+	return /credit balance\s+is\s+too\s+low/i.test(stderr);
+}
 var ClaudeAgent = class {
 	name = "claude";
 	bin;
@@ -1305,7 +1316,8 @@ var ClaudeAgent = class {
 				if (finalResultCleanupTimer) clearTimeout(finalResultCleanupTimer);
 				logStream?.end();
 				if (code !== 0 && !closedAfterFinalCleanup) {
-					reject(/* @__PURE__ */ new Error(`claude exited with code ${code}: ${stderr}`));
+					const detail = `claude exited with code ${code}: ${stderr}`;
+					reject(isPermanentClaudeError(stderr) ? new PermanentAgentError("claude credit balance too low - see gnhf.log", detail) : new Error(detail));
 					return;
 				}
 				const terminalResultEvent = finalStructuredResultEvent ?? resultEvent;
@@ -2978,7 +2990,7 @@ var RovoDevAgent = class {
 		return server;
 	}
 	async waitForHealthy(server, signal) {
-		const deadline = Date.now() + 3e4;
+		const deadline = Date.now() + 9e4;
 		let spawnErrorMessage = null;
 		server.child.once("error", (error) => {
 			spawnErrorMessage = error.message;
@@ -3436,7 +3448,8 @@ var Orchestrator = class extends EventEmitter {
 		consecutiveErrors: 0,
 		startTime: /* @__PURE__ */ new Date(),
 		waitingUntil: null,
-		lastMessage: null
+		lastMessage: null,
+		lastAgentError: null
 	};
 	constructor(config, agent, runInfo, prompt, cwd, startIteration = 0, limits = {}) {
 		super();
@@ -3727,6 +3740,14 @@ var Orchestrator = class extends EventEmitter {
 				elapsedMs,
 				error: serializeError(err)
 			});
+			if (err instanceof PermanentAgentError) {
+				resetHard(this.cwd);
+				this.state.lastAgentError = err.detail;
+				return {
+					type: "aborted",
+					reason: err.message
+				};
+			}
 			const summary = err instanceof Error ? err.message : String(err);
 			return {
 				type: "completed",
@@ -3745,6 +3766,7 @@ var Orchestrator = class extends EventEmitter {
 		this.state.successCount++;
 		this.state.consecutiveFailures = 0;
 		this.state.consecutiveErrors = 0;
+		this.state.lastAgentError = null;
 		return {
 			number: this.state.currentIteration,
 			success: true,
@@ -3759,8 +3781,13 @@ var Orchestrator = class extends EventEmitter {
 		resetHard(this.cwd);
 		this.state.failCount++;
 		this.state.consecutiveFailures++;
-		if (kind === "error") this.state.consecutiveErrors++;
-		else this.state.consecutiveErrors = 0;
+		if (kind === "error") {
+			this.state.consecutiveErrors++;
+			this.state.lastAgentError = recordSummary;
+		} else {
+			this.state.consecutiveErrors = 0;
+			this.state.lastAgentError = null;
+		}
 		return {
 			number: this.state.currentIteration,
 			success: false,
@@ -4334,10 +4361,15 @@ function renderStatsCells(elapsed, inputTokens, outputTokens, commitCount) {
 		...textToCells(formatCommitCount(commitCount), "normal")
 	];
 }
-function renderAgentMessageCells(message, status) {
+function renderAgentMessageCells(message, status, lastAgentError) {
 	const lines = [];
-	if (status === "waiting") lines.push("waiting (backoff)...");
-	else if (status === "aborted" && !message) lines.push("max consecutive failures reached");
+	if (status === "waiting") {
+		lines.push("waiting (backoff)...");
+		if (lastAgentError) lines.push(...wordWrap(lastAgentError, MAX_MSG_LINE_LEN, 2));
+	} else if (status === "aborted" && lastAgentError) {
+		lines.push(...wordWrap(message ?? "max consecutive failures reached", MAX_MSG_LINE_LEN, 1));
+		lines.push(...wordWrap(lastAgentError, MAX_MSG_LINE_LEN, 2));
+	} else if (status === "aborted" && !message) lines.push("max consecutive failures reached");
 	else if (!message) lines.push("working...");
 	else {
 		const wrapped = wordWrap(message, MAX_MSG_LINE_LEN, MAX_MSG_LINES);
@@ -4460,7 +4492,7 @@ function buildContentCells(prompt, agentName, state, elapsed, now, availableHeig
 		agent: [
 			[],
 			[],
-			...renderAgentMessageCells(state.lastMessage, state.status)
+			...renderAgentMessageCells(state.lastMessage, state.status, state.lastAgentError)
 		],
 		moon: [
 			[],
@@ -5100,6 +5132,7 @@ program.name("gnhf").description("Before I go to bed, I tell my agents: good nig
 			commitCount: finalState.commitCount,
 			worktreePath
 		});
+		if (finalState.status === "aborted") console.error(`\n  gnhf: Run log: ${runInfo.logPath}\n`);
 		if (worktreePath) if (finalState.commitCount > 0) {
 			worktreeCleanup = null;
 			console.error(`\n  gnhf: worktree preserved at ${worktreePath}\n  gnhf: merge the branch and remove with: git worktree remove "${worktreePath}"\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gnhf",
-  "version": "0.1.27",
+  "version": "0.1.29",
   "description": "Before I go to bed, I tell my agents: good night, have fun",
   "type": "module",
   "bin": {