gnhf 0.1.9 → 0.1.11

package/README.md

@@ -160,6 +160,11 @@ Config lives at `~/.gnhf/config.yml`:
 # Agent to use by default (claude, codex, rovodev, or opencode)
 agent: claude
 
+# Custom paths to agent binaries (optional)
+# agentPathOverride:
+#   claude: /path/to/custom-claude
+#   codex: /path/to/custom-codex
+
 # Abort after this many consecutive failures
 maxConsecutiveFailures: 3
 
@@ -171,6 +176,18 @@ If the file does not exist yet, `gnhf` creates it on first run using the resolve
 
 CLI flags override config file values. `--prevent-sleep` accepts `on`/`off` as well as `true`/`false`; the config file always uses a boolean.
 The iteration and token caps are runtime-only flags and are not persisted in `config.yml`.
+
+### Custom Agent Paths
+
+Use `agentPathOverride` to point any agent at a custom binary — useful for wrappers like Claude Code Switch or custom Codex builds that accept the same flags and arguments as the original:
+
+```yaml
+agentPathOverride:
+  claude: ~/bin/claude-code-switch
+  codex: /usr/local/bin/my-codex-wrapper
+```
+
+Paths may be absolute, bare executable names already on your `PATH`, `~`-prefixed, or relative to the config directory (`~/.gnhf/`). The override replaces only the binary name; all standard arguments are preserved, so the replacement must be CLI-compatible with the original agent. On Windows, `.cmd` and `.bat` wrappers are supported, including bare names resolved from `PATH`. For `rovodev`, the override must point to an `acli`-compatible binary since gnhf invokes it as `<bin> rovodev serve ...`.
 When sleep prevention is enabled, `gnhf` uses the native mechanism for your OS: `caffeinate` on macOS, `systemd-inhibit` on Linux, and a small PowerShell helper backed by `SetThreadExecutionState` on Windows.
 
 ## Debug Logs

package/dist/cli.mjs

@@ -11,8 +11,15 @@ import { createServer } from "node:net";
 import { EventEmitter } from "node:events";
 import { createHash } from "node:crypto";
 //#region src/core/config.ts
+const AGENT_NAMES = [
+	"claude",
+	"codex",
+	"rovodev",
+	"opencode"
+];
 const DEFAULT_CONFIG = {
 	agent: "claude",
+	agentPathOverride: {},
 	maxConsecutiveFailures: 3,
 	preventSleep: true
 };
@@ -25,7 +32,35 @@ function normalizePreventSleep(value) {
 	if (value === "on") return true;
 	if (value === "off") return false;
 }
-function normalizeConfig(config) {
+/**
+* Resolve a user-supplied path against the config directory (~/.gnhf).
+* Expands leading `~` or `~/` to the home directory, then resolves relative
+* paths against `baseDir` so that entries like `./bin/codex` work predictably
+* regardless of the repo's cwd. Bare executable names and absolute paths pass
+* through unchanged.
+*/
+function resolveConfigPath(raw, baseDir) {
+	if (raw !== "~" && !raw.startsWith("~/") && !raw.startsWith("~\\") && !raw.includes("/") && !raw.includes("\\")) return raw;
+	const home = homedir();
+	let expanded = raw;
+	if (expanded === "~") expanded = home;
+	else if (expanded.startsWith("~/") || expanded.startsWith("~\\")) expanded = join(home, expanded.slice(2));
+	return resolve(baseDir, expanded);
+}
+function normalizeAgentPathOverride(value, configDir) {
+	if (value === void 0 || value === null) return void 0;
+	if (typeof value !== "object" || Array.isArray(value)) throw new InvalidConfigError(`Invalid config value for agentPathOverride: expected an object mapping agent names to paths`);
+	const validNames = new Set(AGENT_NAMES);
+	const result = {};
+	for (const [key, val] of Object.entries(value)) {
+		if (!validNames.has(key)) throw new InvalidConfigError(`Invalid agent name in agentPathOverride: "${key}". Use "claude", "codex", "rovodev", or "opencode".`);
+		if (typeof val !== "string") throw new InvalidConfigError(`Invalid path for agentPathOverride.${key}: expected a string`);
+		if (val.trim() === "") throw new InvalidConfigError(`Invalid path for agentPathOverride.${key}: expected a non-empty string`);
+		result[key] = resolveConfigPath(val, configDir);
+	}
+	return result;
+}
+function normalizeConfig(config, configDir) {
 	const normalized = { ...config };
 	const hasPreventSleep = Object.prototype.hasOwnProperty.call(config, "preventSleep");
 	const preventSleep = normalizePreventSleep(config.preventSleep);
@@ -33,22 +68,47 @@ function normalizeConfig(config) {
 		if (hasPreventSleep && config.preventSleep !== void 0) throw new InvalidConfigError(`Invalid config value for preventSleep: ${String(config.preventSleep)}`);
 		delete normalized.preventSleep;
 	} else normalized.preventSleep = preventSleep;
+	if (Object.prototype.hasOwnProperty.call(config, "agentPathOverride")) {
+		const resolveDir = configDir ?? join(homedir(), ".gnhf");
+		const agentPathOverride = normalizeAgentPathOverride(config.agentPathOverride, resolveDir);
+		if (agentPathOverride === void 0) delete normalized.agentPathOverride;
+		else normalized.agentPathOverride = agentPathOverride;
+	} else delete normalized.agentPathOverride;
 	return normalized;
 }
 function isMissingConfigError(error) {
 	if (!(error instanceof Error)) return false;
 	return "code" in error ? error.code === "ENOENT" : error.message.includes("ENOENT");
 }
+function serializeAgentPathOverride(agentPathOverride) {
+	const serializedOverrides = Object.fromEntries(AGENT_NAMES.flatMap((name) => {
+		const value = agentPathOverride[name];
+		return value === void 0 ? [] : [[name, value]];
+	}));
+	if (Object.keys(serializedOverrides).length === 0) return "";
+	return yaml.dump({ agentPathOverride: serializedOverrides }, {
+		lineWidth: -1,
+		noRefs: true,
+		sortKeys: false
+	}).trimEnd();
+}
 function serializeConfig(config) {
-	return `# Agent to use by default
-agent: ${config.agent}
-
-# Abort after this many consecutive failures
-maxConsecutiveFailures: ${config.maxConsecutiveFailures}
-
-# Prevent the machine from sleeping during a run
-preventSleep: ${config.preventSleep}
-`;
+	const agentPathOverrideSection = serializeAgentPathOverride(config.agentPathOverride);
+	const lines = [
+		"# Agent to use by default",
+		`agent: ${config.agent}`,
+		"",
+		"# Custom paths to agent binaries (optional)",
+		"# Paths may be absolute, bare executable names on PATH,",
+		"# ~-prefixed, or relative to this config directory.",
+		"# Note: rovodev overrides must point to an acli-compatible binary.",
+		"# agentPathOverride:",
+		"#   claude: /path/to/custom-claude",
+		"#   codex: /path/to/custom-codex"
+	];
+	if (agentPathOverrideSection) lines.push(...agentPathOverrideSection.split("\n"));
+	lines.push("", "# Abort after this many consecutive failures", `maxConsecutiveFailures: ${config.maxConsecutiveFailures}`, "", "# Prevent the machine from sleeping during a run", `preventSleep: ${config.preventSleep}`, "");
+	return lines.join("\n");
 }
 function loadConfig(overrides) {
 	const configDir = join(homedir(), ".gnhf");
@@ -57,7 +117,7 @@ function loadConfig(overrides) {
 	let shouldBootstrapConfig = false;
 	try {
 		const raw = readFileSync(configPath, "utf-8");
-		fileConfig = normalizeConfig(yaml.load(raw) ?? {});
+		fileConfig = normalizeConfig(yaml.load(raw) ?? {}, configDir);
 	} catch (error) {
 		if (error instanceof InvalidConfigError) throw error;
 		if (isMissingConfigError(error)) shouldBootstrapConfig = true;
@@ -745,10 +805,12 @@ function parseJSONLStream(stream, logStream, callback) {
 * Wire an AbortSignal to kill a child process.
 * Returns true if the signal was already aborted (caller should return early).
 */
-function setupAbortHandler(signal, child, reject) {
+function setupAbortHandler(signal, child, reject, abortChild = () => {
+	child.kill("SIGTERM");
+}) {
 	if (!signal) return false;
 	const onAbort = () => {
-		child.kill("SIGTERM");
+		abortChild();
 		reject(/* @__PURE__ */ new Error("Agent was aborted"));
 	};
 	if (signal.aborted) {
@@ -761,13 +823,52 @@ function setupAbortHandler(signal, child, reject) {
 }
 //#endregion
 //#region src/core/agents/claude.ts
+function shouldUseWindowsShell$2(bin, platform) {
+	if (platform !== "win32") return false;
+	if (/\.(cmd|bat)$/i.test(bin)) return true;
+	if (/[\\/]/.test(bin)) return false;
+	try {
+		const firstMatch = execFileSync("where", [bin], {
+			encoding: "utf8",
+			stdio: [
+				"ignore",
+				"pipe",
+				"ignore"
+			]
+		}).split(/\r?\n/).map((line) => line.trim()).find(Boolean);
+		return firstMatch ? /\.(cmd|bat)$/i.test(firstMatch) : false;
+	} catch {
+		return false;
+	}
+}
+function terminateClaudeProcess(child, platform) {
+	if (platform === "win32" && child.pid) {
+		try {
+			execFileSync("taskkill", [
+				"/T",
+				"/F",
+				"/PID",
+				String(child.pid)
+			], { stdio: "ignore" });
+		} catch {}
+		return;
+	}
+	child.kill("SIGTERM");
+}
 var ClaudeAgent = class {
 	name = "claude";
+	bin;
+	platform;
+	constructor(binOrDeps = {}) {
+		const deps = typeof binOrDeps === "string" ? { bin: binOrDeps } : binOrDeps;
+		this.bin = deps.bin ?? "claude";
+		this.platform = deps.platform ?? process.platform;
+	}
 	run(prompt, cwd, options) {
 		const { onUsage, onMessage, signal, logPath } = options ?? {};
 		return new Promise((resolve, reject) => {
 			const logStream = logPath ? createWriteStream(logPath) : null;
-			const child = spawn("claude", [
+			const child = spawn(this.bin, [
 				"-p",
 				prompt,
 				"--verbose",
@@ -778,6 +879,7 @@ var ClaudeAgent = class {
 				"--dangerously-skip-permissions"
 			], {
 				cwd,
+				shell: shouldUseWindowsShell$2(this.bin, this.platform),
 				stdio: [
 					"ignore",
 					"pipe",
@@ -785,7 +887,7 @@ var ClaudeAgent = class {
 				],
 				env: process.env
 			});
-			if (setupAbortHandler(signal, child, reject)) return;
+			if (setupAbortHandler(signal, child, reject, () => terminateClaudeProcess(child, this.platform))) return;
 			let resultEvent = null;
 			const cumulative = {
 				inputTokens: 0,
@@ -841,17 +943,54 @@ var ClaudeAgent = class {
 };
 //#endregion
 //#region src/core/agents/codex.ts
+function shouldUseWindowsShell$1(bin, platform) {
+	if (platform !== "win32") return false;
+	if (/\.(cmd|bat)$/i.test(bin)) return true;
+	if (/[\\/]/.test(bin)) return false;
+	try {
+		const firstMatch = execFileSync("where", [bin], {
+			encoding: "utf8",
+			stdio: [
+				"ignore",
+				"pipe",
+				"ignore"
+			]
+		}).split(/\r?\n/).map((line) => line.trim()).find(Boolean);
+		return firstMatch ? /\.(cmd|bat)$/i.test(firstMatch) : false;
+	} catch {
+		return false;
+	}
+}
+function terminateCodexProcess(child, platform) {
+	if (platform === "win32" && child.pid) {
+		try {
+			execFileSync("taskkill", [
+				"/T",
+				"/F",
+				"/PID",
+				String(child.pid)
+			], { stdio: "ignore" });
+		} catch {}
+		return;
+	}
+	child.kill("SIGTERM");
+}
 var CodexAgent = class {
 	name = "codex";
+	bin;
+	platform;
 	schemaPath;
-	constructor(schemaPath) {
+	constructor(schemaPath, binOrDeps = {}) {
+		const deps = typeof binOrDeps === "string" ? { bin: binOrDeps } : binOrDeps;
+		this.bin = deps.bin ?? "codex";
+		this.platform = deps.platform ?? process.platform;
 		this.schemaPath = schemaPath;
 	}
 	run(prompt, cwd, options) {
 		const { onUsage, onMessage, signal, logPath } = options ?? {};
 		return new Promise((resolve, reject) => {
 			const logStream = logPath ? createWriteStream(logPath) : null;
-			const child = spawn("codex", [
+			const child = spawn(this.bin, [
 				"exec",
 				prompt,
 				"--json",
@@ -862,6 +1001,7 @@ var CodexAgent = class {
 				"never"
 			], {
 				cwd,
+				shell: shouldUseWindowsShell$1(this.bin, this.platform),
 				stdio: [
 					"ignore",
 					"pipe",
@@ -869,7 +1009,7 @@ var CodexAgent = class {
 				],
 				env: process.env
 			});
-			if (setupAbortHandler(signal, child, reject)) return;
+			if (setupAbortHandler(signal, child, reject, () => terminateCodexProcess(child, this.platform))) return;
 			let lastAgentMessage = null;
 			const cumulative = {
 				inputTokens: 0,
@@ -1018,6 +1158,7 @@ function withTimeoutSignal$1(signal, timeoutMs) {
 }
 var OpenCodeAgent = class {
 	name = "opencode";
+	bin;
 	fetchFn;
 	getPortFn;
 	killProcessFn;
@@ -1026,6 +1167,7 @@ var OpenCodeAgent = class {
 	server = null;
 	closingPromise = null;
 	constructor(deps = {}) {
+		this.bin = deps.bin ?? "opencode";
 		this.fetchFn = deps.fetch ?? fetch;
 		this.getPortFn = deps.getPort ?? getAvailablePort$1;
 		this.killProcessFn = deps.killProcess ?? process.kill.bind(process);
@@ -1077,7 +1219,7 @@ var OpenCodeAgent = class {
 		const port = await this.getPortFn();
 		const isWindows = this.platform === "win32";
 		const detached = !isWindows;
-		const child = this.spawnFn("opencode", [
+		const child = this.spawnFn(this.bin, [
 			"serve",
 			"--hostname",
 			"127.0.0.1",
@@ -1463,6 +1605,38 @@ function createAbortError() {
 function isAbortError(error) {
 	return error instanceof Error && error.name === "AbortError";
 }
+function shouldUseWindowsShell(bin, platform) {
+	if (platform !== "win32") return false;
+	if (/\.(cmd|bat)$/i.test(bin)) return true;
+	if (/[\\/]/.test(bin)) return false;
+	try {
+		const firstMatch = execFileSync("where", [bin], {
+			encoding: "utf8",
+			stdio: [
+				"ignore",
+				"pipe",
+				"ignore"
+			]
+		}).split(/\r?\n/).map((line) => line.trim()).find(Boolean);
+		return firstMatch ? /\.(cmd|bat)$/i.test(firstMatch) : false;
+	} catch {
+		return false;
+	}
+}
+function terminateRovoDevProcess(child, platform) {
+	if (platform === "win32" && child.pid) {
+		try {
+			execFileSync("taskkill", [
+				"/T",
+				"/F",
+				"/PID",
+				String(child.pid)
+			], { stdio: "ignore" });
+		} catch {}
+		return;
+	}
+	child.kill("SIGTERM");
+}
 function getAvailablePort() {
 	return new Promise((resolve, reject) => {
 		const server = createServer();
@@ -1509,18 +1683,22 @@ async function delay(ms, signal) {
 }
 var RovoDevAgent = class {
 	name = "rovodev";
+	bin;
 	schemaPath;
 	fetchFn;
 	getPortFn;
 	killProcessFn;
+	platform;
 	spawnFn;
 	server = null;
 	closingPromise = null;
 	constructor(schemaPath, deps = {}) {
+		this.bin = deps.bin ?? "acli";
 		this.schemaPath = schemaPath;
 		this.fetchFn = deps.fetch ?? fetch;
 		this.getPortFn = deps.getPort ?? getAvailablePort;
 		this.killProcessFn = deps.killProcess ?? process.kill.bind(process);
+		this.platform = deps.platform ?? process.platform;
 		this.spawnFn = deps.spawn ?? spawn;
 	}
 	async run(prompt, cwd, options) {
@@ -1564,8 +1742,8 @@ var RovoDevAgent = class {
 		}
 		if (this.server && !this.server.closed) await this.shutdownServer();
 		const port = await this.getPortFn();
-		const detached = process.platform !== "win32";
-		const child = this.spawnFn("acli", [
+		const detached = this.platform !== "win32";
+		const child = this.spawnFn(this.bin, [
 			"rovodev",
 			"serve",
 			"--disable-session-token",
@@ -1573,6 +1751,7 @@ var RovoDevAgent = class {
 		], {
 			cwd,
 			detached,
+			shell: shouldUseWindowsShell(this.bin, this.platform),
 			stdio: [
 				"ignore",
 				"pipe",
@@ -1837,11 +2016,29 @@ var RovoDevAgent = class {
 			cwd: server.cwd,
 			port: server.port
 		});
-		this.closingPromise = shutdownChildProcess(server.child, {
+		this.closingPromise = this.platform === "win32" ? new Promise((resolve) => {
+			const handleClose = () => {
+				server.child.off("close", handleClose);
+				resolve();
+			};
+			server.child.on("close", handleClose);
+			try {
+				terminateRovoDevProcess(server.child, this.platform);
+			} catch {
+				server.child.off("close", handleClose);
+				resolve();
+				return;
+			}
+			setTimeout(() => {
+				server.child.off("close", handleClose);
+				resolve();
+			}, 100).unref?.();
+		}) : shutdownChildProcess(server.child, {
 			detached: server.detached,
 			killProcess: this.killProcessFn,
 			timeoutMs: 3e3
-		}).finally(() => {
+		});
+		this.closingPromise = this.closingPromise.finally(() => {
 			if (this.server === server) this.server = null;
 			this.closingPromise = null;
 		});
@@ -1875,12 +2072,12 @@ function withTimeoutSignal(signal, timeoutMs) {
 }
 //#endregion
 //#region src/core/agents/factory.ts
-function createAgent(name, runInfo) {
+function createAgent(name, runInfo, pathOverride) {
 	switch (name) {
-		case "claude": return new ClaudeAgent();
-		case "codex": return new CodexAgent(runInfo.schemaPath);
-		case "opencode": return new OpenCodeAgent();
-		case "rovodev": return new RovoDevAgent(runInfo.schemaPath);
+		case "claude": return new ClaudeAgent(pathOverride);
+		case "codex": return new CodexAgent(runInfo.schemaPath, pathOverride);
+		case "opencode": return new OpenCodeAgent({ bin: pathOverride });
+		case "rovodev": return new RovoDevAgent(runInfo.schemaPath, { bin: pathOverride });
 	}
 }
 //#endregion
@@ -2356,7 +2553,68 @@ function formatTokens(count) {
 	return String(count);
 }
 //#endregion
+//#region src/utils/terminal-width.ts
+const graphemeSegmenter = new Intl.Segmenter(void 0, { granularity: "grapheme" });
+const MARK_REGEX = /\p{Mark}/u;
+const REGIONAL_INDICATOR_REGEX = /\p{Regional_Indicator}/u;
+const EXTENDED_PICTOGRAPHIC_REGEX = /\p{Extended_Pictographic}/u;
+function isFullWidthCodePoint(codePoint) {
+	return codePoint >= 4352 && (codePoint <= 4447 || codePoint === 9001 || codePoint === 9002 || codePoint >= 11904 && codePoint <= 12871 && codePoint !== 12351 || codePoint >= 12880 && codePoint <= 19903 || codePoint >= 19968 && codePoint <= 42182 || codePoint >= 43360 && codePoint <= 43388 || codePoint >= 44032 && codePoint <= 55203 || codePoint >= 63744 && codePoint <= 64255 || codePoint >= 65040 && codePoint <= 65049 || codePoint >= 65072 && codePoint <= 65131 || codePoint >= 65281 && codePoint <= 65376 || codePoint >= 65504 && codePoint <= 65510 || codePoint >= 110592 && codePoint <= 110593 || codePoint >= 127488 && codePoint <= 127569 || codePoint >= 131072 && codePoint <= 262141);
+}
+function codePointWidth(codePoint) {
+	if (codePoint === 0 || codePoint === 8204 || codePoint === 8205 || codePoint === 65038 || codePoint === 65039) return 0;
+	if (MARK_REGEX.test(String.fromCodePoint(codePoint))) return 0;
+	return isFullWidthCodePoint(codePoint) ? 2 : 1;
+}
+function isWideEmojiGrapheme(grapheme) {
+	return grapheme.includes("‍") || grapheme.includes("️") || grapheme.includes("⃣") || REGIONAL_INDICATOR_REGEX.test(grapheme) || Array.from(grapheme).some((char) => EXTENDED_PICTOGRAPHIC_REGEX.test(char));
+}
+function splitGraphemes(text) {
+	return Array.from(graphemeSegmenter.segment(text), ({ segment }) => segment);
+}
+function graphemeWidth(grapheme) {
+	if (!grapheme) return 0;
+	if (isWideEmojiGrapheme(grapheme)) return 2;
+	let width = 0;
+	for (const char of grapheme) width += codePointWidth(char.codePointAt(0) ?? 0);
+	return width;
+}
+function stringWidth(text) {
+	let width = 0;
+	for (const grapheme of splitGraphemes(text)) width += graphemeWidth(grapheme);
+	return width;
+}
+//#endregion
 //#region src/utils/wordwrap.ts
+function sliceToWidth(text, width) {
+	let result = "";
+	let currentWidth = 0;
+	for (const grapheme of splitGraphemes(text)) {
+		const nextWidth = currentWidth + graphemeWidth(grapheme);
+		if (nextWidth > width) break;
+		result += grapheme;
+		currentWidth = nextWidth;
+	}
+	return result;
+}
+function splitByWidth(text, width) {
+	const lines = [];
+	let current = "";
+	let currentWidth = 0;
+	for (const grapheme of splitGraphemes(text)) {
+		const glyphWidth = graphemeWidth(grapheme);
+		if (current && currentWidth + glyphWidth > width) {
+			lines.push(current);
+			current = grapheme;
+			currentWidth = glyphWidth;
+			continue;
+		}
+		current += grapheme;
+		currentWidth += glyphWidth;
+	}
+	if (current) lines.push(current);
+	return lines;
+}
 function wordWrap(text, width, maxLines) {
 	if (!text) return [];
 	const lines = [];
@@ -2367,26 +2625,34 @@ function wordWrap(text, width, maxLines) {
 			continue;
 		}
 		let current = "";
+		let currentWidth = 0;
 		for (const word of words) {
-			if (word.length > width) {
+			const wordWidth = stringWidth(word);
+			if (wordWidth > width) {
 				if (current) {
 					lines.push(current);
 					current = "";
+					currentWidth = 0;
 				}
-				for (let i = 0; i < word.length; i += width) lines.push(word.slice(i, i + width));
+				for (const slice of splitByWidth(word, width)) lines.push(slice);
 				continue;
 			}
-			if (current && current.length + 1 + word.length > width) {
+			const nextWidth = current ? currentWidth + 1 + wordWidth : wordWidth;
+			if (current && nextWidth > width) {
 				lines.push(current);
 				current = word;
-			} else current = current ? current + " " + word : word;
+				currentWidth = wordWidth;
+			} else {
+				current = current ? current + " " + word : word;
+				currentWidth = nextWidth;
+			}
 		}
 		if (current) lines.push(current);
 	}
 	if (maxLines && lines.length > maxLines) {
 		const capped = lines.slice(0, maxLines);
 		const last = capped[maxLines - 1];
-		capped[maxLines - 1] = last.length >= width ? last.slice(0, width - 1) + "…" : last + "…";
+		capped[maxLines - 1] = stringWidth(last) >= width ? sliceToWidth(last, width - 1) + "…" : last + "…";
 		return capped;
 	}
 	return lines;
@@ -2402,13 +2668,13 @@ function makeCell(char, style) {
 	return {
 		char,
 		style,
-		width: (char.codePointAt(0) ?? 0) > 65535 ? 2 : 1
+		width: graphemeWidth(char)
 	};
 }
 function textToCells(text, style) {
 	const cells = [];
-	for (const char of text) {
-		const cell = makeCell(char, style);
+	for (const grapheme of splitGraphemes(text)) {
+		const cell = makeCell(grapheme, style);
 		cells.push(cell);
 		if (cell.width === 2) cells.push({
 			char: "",
@@ -2490,7 +2756,7 @@ const TICK_MS = 200;
 const MOONS_PER_ROW = 30;
 const MOON_PHASE_PERIOD = 1600;
 const MAX_MSG_LINES = 3;
-const MAX_MSG_LINE_LEN = 64;
+const MAX_MSG_LINE_LEN = CONTENT_WIDTH;
 const RESUME_HINT = "[ctrl+c to stop, gnhf again to resume]";
 function spacedLabel(text) {
 	return text.split("").join(" ");
@@ -2584,52 +2850,124 @@ function renderSideStarsCells(stars, rowIndex, xOffset, sideWidth, now) {
 	placeStarsInCells(cells, stars, rowIndex, xOffset, xOffset + sideWidth, xOffset, now);
 	return cells;
 }
+function clampCellsToWidth(content, width) {
+	if (content.length <= width) return content;
+	const clamped = [];
+	let remaining = width;
+	for (let i = 0; i < content.length && remaining > 0; i++) {
+		const cell = content[i];
+		if (cell.width === 0) continue;
+		if (cell.width > remaining) break;
+		clamped.push(cell);
+		remaining -= cell.width;
+		if (cell.width === 2 && content[i + 1]?.width === 0) {
+			clamped.push(content[i + 1]);
+			i += 1;
+		}
+	}
+	return clamped;
+}
 function centerLineCells(content, width) {
-	const w = content.length;
+	const clamped = clampCellsToWidth(content, width);
+	const w = clamped.length;
 	const pad = Math.max(0, Math.floor((width - w) / 2));
 	const rightPad = Math.max(0, width - w - pad);
 	return [
 		...emptyCells(pad),
-		...content,
+		...clamped,
 		...emptyCells(rightPad)
 	];
 }
 function renderResumeHintCells(width) {
 	return centerLineCells(textToCells(RESUME_HINT, "dim"), width);
 }
-function fitContentRows(contentRows, maxRows) {
-	if (contentRows.length <= maxRows) return contentRows;
-	const fitted = [...contentRows];
-	while (fitted.length > maxRows) {
-		const emptyRowIndex = fitted.findIndex((row) => row.length === 0);
-		if (emptyRowIndex === -1) break;
-		fitted.splice(emptyRowIndex, 1);
-	}
-	return fitted.length > maxRows ? fitted.slice(fitted.length - maxRows) : fitted;
-}
-function buildContentCells(prompt, agentName, state, elapsed, now) {
-	const rows = [];
+/**
+* Builds the centered content viewport for the renderer.
+*
+* When `availableHeight` is constrained, the layout drops optional sections in
+* priority order (ASCII art, eyebrow, agent message, then prompt) so the stats
+* row remains visible and any remaining space is used for the newest moon rows.
+*/
+function buildContentCells(prompt, agentName, state, elapsed, now, availableHeight) {
 	const isRunning = state.status === "running" || state.status === "waiting";
-	rows.push([]);
-	rows.push(...renderTitleCells(agentName));
-	rows.push([], []);
+	const moonRows = renderMoonStripCells(state.iterations, isRunning, now);
+	const maxRows = availableHeight ?? Infinity;
+	if (maxRows <= 0) return [];
+	const titleCells = renderTitleCells(agentName);
+	const titleSpacer = titleCells[1] ?? [];
 	const promptLines = wordWrap(prompt, CONTENT_WIDTH, MAX_PROMPT_LINES);
+	const promptRows = [];
 	for (let i = 0; i < MAX_PROMPT_LINES; i++) {
 		const pl = promptLines[i] ?? "";
-		rows.push(pl ? textToCells(pl, "dim") : []);
-	}
-	rows.push([], []);
-	rows.push(renderStatsCells(elapsed, state.totalInputTokens, state.totalOutputTokens, state.commitCount));
-	rows.push([], []);
-	rows.push(...renderAgentMessageCells(state.lastMessage, state.status));
-	rows.push([], []);
-	rows.push(...renderMoonStripCells(state.iterations, isRunning, now));
+		promptRows.push(pl ? textToCells(pl, "dim") : []);
+	}
+	const sections = {
+		top: [[]],
+		eyebrow: [
+			titleCells[0],
+			[],
+			[]
+		],
+		art: titleCells.slice(2),
+		prompt: [
+			titleSpacer,
+			...promptRows,
+			[],
+			[]
+		],
+		stats: [renderStatsCells(elapsed, state.totalInputTokens, state.totalOutputTokens, state.commitCount)],
+		agent: [
+			[],
+			[],
+			...renderAgentMessageCells(state.lastMessage, state.status)
+		],
+		moon: [
+			[],
+			[],
+			...moonRows
+		]
+	};
+	const flattenSections = () => [
+		...sections.top,
+		...sections.eyebrow,
+		...sections.art,
+		...sections.prompt,
+		...sections.stats,
+		...sections.agent,
+		...sections.moon
+	];
+	const optionalSections = [
+		"art",
+		"eyebrow",
+		"agent",
+		"prompt"
+	];
+	let rows = flattenSections();
+	for (const section of optionalSections) {
+		if (rows.length <= maxRows) break;
+		sections[section] = [];
+		rows = flattenSections();
+	}
+	if (rows.length > maxRows) rows = rows.filter((row) => row.length > 0);
+	if (rows.length > maxRows) {
+		const nonMoonRows = [
+			...sections.top,
+			...sections.eyebrow,
+			...sections.art,
+			...sections.prompt,
+			...sections.stats,
+			...sections.agent
+		].filter((row) => row.length > 0);
+		const allowedMoonRows = Math.max(0, maxRows - nonMoonRows.length);
+		const visibleMoonRows = allowedMoonRows === 0 ? [] : moonRows.filter((row) => row.length > 0).slice(-allowedMoonRows);
+		rows = [...nonMoonRows, ...visibleMoonRows];
+	}
 	return rows;
 }
 function buildFrameCells(prompt, agentName, state, topStars, bottomStars, sideStars, now, terminalWidth, terminalHeight) {
 	const elapsed = formatElapsed(now - state.startTime.getTime());
 	const availableHeight = Math.max(0, terminalHeight - 2);
-	const contentRows = fitContentRows(buildContentCells(prompt, agentName, state, elapsed, now), availableHeight);
+	const contentRows = buildContentCells(prompt, agentName, state, elapsed, now, availableHeight);
 	while (contentRows.length < Math.min(BASE_CONTENT_ROWS, availableHeight)) contentRows.push([]);
 	const contentCount = contentRows.length;
 	const remaining = Math.max(0, availableHeight - contentCount);
@@ -2668,11 +3006,17 @@ var Renderer = class {
 	cachedHeight = 0;
 	prevCells = [];
 	isFirstFrame = true;
+	seedTop;
+	seedBottom;
+	seedSide;
 	constructor(orchestrator, prompt, agentName) {
 		this.orchestrator = orchestrator;
 		this.prompt = prompt;
 		this.agentName = agentName;
 		this.state = orchestrator.getState();
+		this.seedTop = Math.floor(Math.random() * 2147483646) + 1;
+		this.seedBottom = Math.floor(Math.random() * 2147483646) + 1;
+		this.seedSide = Math.floor(Math.random() * 2147483646) + 1;
 		this.exitPromise = new Promise((resolve) => {
 			this.exitResolve = resolve;
 		});
@@ -2736,9 +3080,9 @@ var Renderer = class {
 					rest: "dim"
 				} : star;
 			};
-			this.topStars = generateStarField(w, h, STAR_DENSITY, 42).map((s) => shrinkBig(s, s.y >= topHeight - proximityRows));
-			this.bottomStars = generateStarField(w, h, STAR_DENSITY, 137).map((s) => shrinkBig(s, s.y < proximityRows));
-			this.sideStars = generateStarField(w, Math.max(BASE_CONTENT_ROWS, availableHeight), STAR_DENSITY, 99);
+			this.topStars = generateStarField(w, h, STAR_DENSITY, this.seedTop).map((s) => shrinkBig(s, s.y >= topHeight - proximityRows));
+			this.bottomStars = generateStarField(w, h, STAR_DENSITY, this.seedBottom).map((s) => shrinkBig(s, s.y < proximityRows));
+			this.sideStars = generateStarField(w, Math.max(BASE_CONTENT_ROWS, availableHeight), STAR_DENSITY, this.seedSide);
 			return true;
 		}
 		return false;
@@ -2934,7 +3278,7 @@ program.name("gnhf").description("Before I go to bed, I tell my agents: good nig
 		}
 	}
 	appendDebugLog("run:start", { args: process$1.argv.slice(2) });
-	const orchestrator = new Orchestrator(config, createAgent(config.agent, runInfo), runInfo, prompt, cwd, startIteration, {
+	const orchestrator = new Orchestrator(config, createAgent(config.agent, runInfo, config.agentPathOverride[config.agent]), runInfo, prompt, cwd, startIteration, {
 		maxIterations: options.maxIterations,
 		maxTokens: options.maxTokens
 	});

package/package.json

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