gnhf 0.1.0 → 0.1.3

package/README.md

@@ -1,4 +1,8 @@
-<h1 align="center">gnhf</h1>
+# gnhf
+
+<p align="center">Before I go to bed, I tell my agents:</p>
+<h1 align="center">good night, have fun</h1>
+
 <p align="center">
   <a href="https://www.npmjs.com/package/gnhf"
     ><img
@@ -33,14 +37,15 @@
   /></a>
 </p>
 
-<h3 align="center">Before I go to bed, I tell my agents: good night, have fun.</h3>
-
-You have a backlog of improvements you'll never get to. Tests that need writing, complexity that needs reducing, types that need fixing. You could spend a Saturday on it, or you could hand it to a coding agent and go to sleep.
+<p align="center">
+  <img src="docs/splash.png" alt="gnhf — Good Night, Have Fun" width="800">
+</p>
 
-gnhf is an orchestrator that runs your coding agent in a loop — each iteration makes one small, committed, documented change towards an objective. You wake up to a branch full of clean work and a log of everything that happened.
+gnhf is a [ralph loop](https://ghuntley.com/ralph/), autoresearch-style orchestrator that keeps your agents running while you sleep — each iteration makes one small, committed, documented change towards an objective.
+You wake up to a branch full of clean work and a log of everything that happened.
 
-- **Set it and forget it** — one command starts an autonomous loop that runs until you Ctrl+C
-- **Safe by design** — each iteration is committed on success, rolled back on failure, with exponential backoff and auto-abort after consecutive failures
+- **Dead simple** — one command starts an autonomous loop that runs until you Ctrl+C
+- **Long running** — each iteration is committed on success, rolled back on failure, with sensible retries and exponential backoff
 - **Agent-agnostic** — works with Claude Code or Codex out of the box
 
 ## Quick Start
@@ -105,7 +110,7 @@ npm link
                    │   ┌──────────┘                        │
                    ▼   ▼                                   │
               ┌────────────┐    yes   ┌──────────┐         │
-              │ 5 consec.  ├─────────►│  abort   │         │
+              │ 3 consec.  ├─────────►│  abort   │         │
               │ failures?  │          └──────────┘         │
               └─────┬──────┘                               │
                  no │                                      │
@@ -118,11 +123,12 @@ npm link
 
 ## CLI Reference
 
-| Command                 | Description                                     |
-| ----------------------- | ----------------------------------------------- |
-| `gnhf "<prompt>"`       | Start a new run with the given objective        |
-| `gnhf`                  | Resume a run (when on an existing gnhf/ branch) |
-| `echo "prompt" \| gnhf` | Pipe prompt via stdin                           |
+| Command                   | Description                                     |
+| ------------------------- | ----------------------------------------------- |
+| `gnhf "<prompt>"`         | Start a new run with the given objective        |
+| `gnhf`                    | Resume a run (when on an existing gnhf/ branch) |
+| `echo "<prompt>" \| gnhf` | Pipe prompt via stdin                           |
+| `cat prd.md \| gnhf`      | Pipe a large spec or PRD via stdin              |
 
 ### Flags
 
@@ -140,7 +146,7 @@ Config lives at `~/.gnhf/config.yml`:
 agent: claude
 
 # Abort after this many consecutive failures
-maxConsecutiveFailures: 5
+maxConsecutiveFailures: 3
 ```
 
 CLI flags override config file values.

package/dist/cli.mjs

@@ -12,7 +12,7 @@ import { createHash } from "node:crypto";
 //#region src/core/config.ts
 const DEFAULT_CONFIG = {
 	agent: "claude",
-	maxConsecutiveFailures: 5
+	maxConsecutiveFailures: 3
 };
 function loadConfig(overrides) {
 	const configPath = join(homedir(), ".gnhf", "config.yml");
@@ -401,11 +401,18 @@ This is iteration ${params.n} of an ongoing loop to fully accomplish the objecti
 ## Instructions
 
 1. Read .gnhf/runs/${params.runId}/notes.md first to understand what has been done in previous iterations.
-2. Focus on one smallest logical unit of work that's individually testable and would make incremental progress towards the objective. Do NOT try to do everything at once.
-3. Run build/tests/linters/formatters if available to validate your work.
+2. Focus on the next smallest logical unit of work that's individually testable and would make incremental progress towards the objective - that's the scope of this iteration.
+3. If you made code changes, run build/tests/linters/formatters if available to validate your work.
 4. Do NOT make any git commits. Commits will be handled automatically by the gnhf orchestrator.
 5. When you are done, respond with a JSON object according to the provided schema.
 
+## Output
+
+- success: whether you were able to complete your iteration. set to false only if something made it impossible for you to do your work
+- summary: a concise one-sentence summary of the accomplishment in this iteration
+- key_changes_made: an array of descriptions for key changes you made. don't group this by file - group by logical units of work. don't describe activities - describe material outcomes
+- key_learnings: an array of new learnings that were surprising and weren't captured by previous notes
+
 ## Objective
 
 ${params.prompt}`;
@@ -767,24 +774,30 @@ function formatTokens(count) {
 //#region src/utils/wordwrap.ts
 function wordWrap(text, width, maxLines) {
 	if (!text) return [];
-	const words = text.split(/\s+/);
 	const lines = [];
-	let current = "";
-	for (const word of words) {
-		if (word.length > width) {
-			if (current) {
-				lines.push(current);
-				current = "";
-			}
-			for (let i = 0; i < word.length; i += width) lines.push(word.slice(i, i + width));
+	for (const paragraph of text.split("\n")) {
+		const words = paragraph.split(/\s+/).filter(Boolean);
+		if (words.length === 0) {
+			lines.push("");
 			continue;
 		}
-		if (current && current.length + 1 + word.length > width) {
-			lines.push(current);
-			current = word;
-		} else current = current ? current + " " + word : word;
+		let current = "";
+		for (const word of words) {
+			if (word.length > width) {
+				if (current) {
+					lines.push(current);
+					current = "";
+				}
+				for (let i = 0; i < word.length; i += width) lines.push(word.slice(i, i + width));
+				continue;
+			}
+			if (current && current.length + 1 + word.length > width) {
+				lines.push(current);
+				current = word;
+			} else current = current ? current + " " + word : word;
+		}
+		if (current) lines.push(current);
 	}
-	if (current) lines.push(current);
 	if (maxLines && lines.length > maxLines) {
 		const capped = lines.slice(0, maxLines);
 		const last = capped[maxLines - 1];
@@ -1142,6 +1155,7 @@ function slugifyPrompt(prompt) {
 }
 //#endregion
 //#region src/cli.ts
+const packageVersion = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8")).version;
 function ask(question) {
 	const rl = createInterface({
 		input: process$1.stdin,
@@ -1155,7 +1169,7 @@ function ask(question) {
 	});
 }
 const program = new Command();
-program.name("gnhf").description("Before I go to bed, I tell my agents: good night, have fun").version("0.1.0").argument("[prompt]", "The objective for the coding agent").option("--agent <agent>", "Agent to use (claude or codex)", "claude").option("--mock", "", false).action(async (promptArg, options) => {
+program.name("gnhf").description("Before I go to bed, I tell my agents: good night, have fun").version(packageVersion).argument("[prompt]", "The objective for the coding agent").option("--agent <agent>", "Agent to use (claude or codex)", "claude").option("--mock", "", false).action(async (promptArg, options) => {
 	if (options.mock) {
 		const mock = new MockOrchestrator();
 		enterAltScreen();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gnhf",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "Before I go to bed, I tell my agents: good night, have fun",
   "type": "module",
   "bin": {
@@ -40,6 +40,10 @@
   "publishConfig": {
     "access": "public"
   },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kunchenguid/gnhf"
+  },
   "engines": {
     "node": ">=20"
   }