fly-to-moon 0.1.12 → 0.1.14

package/README.md

@@ -2,10 +2,10 @@
 <h1 align="center">Fly to the Moon, Fly to Mars</h1>
 
 <p align="center">
-  <a href="https://www.npmjs.com/package/fttm"
+  <a href="https://www.npmjs.com/package/fly-to-moon"
     ><img
       alt="npm"
-      src="https://img.shields.io/npm/v/fttm?style=flat-square"
+      src="https://img.shields.io/npm/v/fly-to-moon?style=flat-square"
   /></a>
   <a
     href="https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-blue?style=flat-square"
@@ -16,7 +16,7 @@
 </p>
 
 <p align="center">
-  <img src="docs/splash.png" alt="fttm — Fly to the Moon" width="800">
+  <!-- <img src="assets/splash.png" alt="fttm — Fly to the Moon" width="800"> -->
 </p>
 
 Never wake up empty-handed.
@@ -29,31 +29,36 @@ fttm is an autonomous coding agent orchestrator — each iteration makes one sma
 
 ## Quick Start
 
-```sh
-$ fttm "reduce complexity of the codebase without changing functionality"
-# have a good sleep
-```
+### Install
 
 ```sh
-$ fttm "reduce complexity of the codebase without changing functionality" \
-    --max-iterations 10 \
-    --max-tokens 5000000
-# have a good nap
+npm install -g fly-to-moon
 ```
 
-### OpenCode with Specific Model
+### OpenCode
 
 ```sh
-$ fttm "implement a new feature" \
+fttm "your task here" \
     --agent opencode \
     --model minimax-cn-coding-plan/MiniMax-M2.7
-# foreground mode, model displayed in UI
+```
+
+### Claude Code
+
+```sh
+fttm "your task here" --agent claude
+```
+
+### Codex
+
+```sh
+fttm "your task here" --agent codex
 ```
 
 ### Background/Daemon Mode
 
 ```sh
-$ fttm "implement a new feature" \
+fttm "your task here" \
     --agent opencode \
     --model minimax-cn-coding-plan/MiniMax-M2.7 \
     --max-iterations 50 \
@@ -61,22 +66,28 @@ $ fttm "implement a new feature" \
 # runs in background, returns immediately to terminal
 ```
 
-Run `fttm` from inside a Git repository with a clean working tree. If you are starting from a plain directory, run `git init` first.
-`fttm` supports macOS, Linux, and Windows.
+### Skills
 
-## Install
-
-**npm**
+Install the `fttm` skill for interactive command generation:
 
 ```sh
-npm install -g fttm
+npx skills add evoerax/fly-to-the-moon --skill fttm
+```
+
+Then use it:
+
+```
+fttm skill -> interactive fttm command builder
 ```
 
-**From source**
+Run `fttm` from inside a Git repository with a clean working tree. If you are starting from a plain directory, run `git init` first.
+`fttm` supports macOS, Linux, and Windows.
+
+## Install (From source)
 
 ```sh
-git clone https://github.com/YOUR_USERNAME/fttm.git
-cd fttm
+git clone https://github.com/evoerax/fly-to-the-moon.git
+cd fly-to-the-moon
 npm install
 npm run build
 npm link
@@ -191,6 +202,34 @@ agentPathOverride:
 Paths may be absolute, bare executable names already on your `PATH`, `~`-prefixed, or relative to the config directory (`~/.fttm/`). 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 fttm invokes it as `<bin> rovodev serve ...`.
 When sleep prevention is enabled, `fttm` uses the native mechanism for your OS: `caffeinate` on macOS, `systemd-inhibit` on Linux, and a small PowerShell helper backed by `SetThreadExecutionState` on Windows.
 
+### Sleep Prevention
+
+By default, `fttm` prevents your computer from sleeping while running:
+
+| OS      | Command                                | What it does                         |
+| ------- | -------------------------------------- | ------------------------------------ |
+| macOS   | `caffeinate -i -w <pid>`               | Prevents idle sleep until fttm exits |
+| Linux   | `systemd-inhibit`                      | Blocks sleep via systemd logind      |
+| Windows | PowerShell + `SetThreadExecutionState` | Calls Windows sleep blocker API      |
+
+You can disable this with `--prevent-sleep off`.
+
+## Local Run Metadata
+
+`fttm` stores run data in `.fttm/runs/<run-id>/` within your project:
+
+```
+.fttm/
+└── runs/
+    └── <run-id>/
+        ├── notes.md          # Iteration history (cumulative)
+        ├── prompt.md         # Original prompt
+        ├── base-commit       # Git commit hash where run started
+        └── output-schema.json # JSON schema for agent output
+```
+
+This folder is automatically added to `.gitignore` — it never gets committed.
+
 ## Debug Logs
 
 Set `FTtm_DEBUG_LOG_PATH` to capture lifecycle events as JSONL while debugging a run:

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { appendFileSync, createWriteStream, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, rmdirSync, writeFileSync } from "node:fs";
 import { homedir, tmpdir } from "node:os";
-import { basename, dirname, isAbsolute, join, resolve } from "node:path";
+import { basename, dirname, join, resolve } from "node:path";
 import process$1 from "node:process";
 import { createInterface } from "node:readline";
 import { Command, InvalidArgumentError } from "commander";
@@ -259,22 +259,11 @@ function writeSchemaFile(schemaPath) {
 	writeFileSync(schemaPath, JSON.stringify(AGENT_OUTPUT_SCHEMA, null, 2), "utf-8");
 }
 function ensureRunMetadataIgnored(cwd) {
-	const excludePath = execFileSync("git", [
-		"rev-parse",
-		"--git-path",
-		"info/exclude"
-	], {
-		cwd,
-		encoding: "utf-8"
-	}).trim();
-	const resolved = isAbsolute(excludePath) ? excludePath : join(cwd, excludePath);
-	const entry = ".fttm/runs/";
-	mkdirSync(dirname(resolved), { recursive: true });
-	if (existsSync(resolved)) {
-		const content = readFileSync(resolved, "utf-8");
-		if (content.split("\n").some((line) => line.trim() === entry)) return;
-		appendFileSync(resolved, `${content.length > 0 && !content.endsWith("\n") ? "\n" : ""}${entry}\n`, "utf-8");
-	} else writeFileSync(resolved, `${entry}\n`, "utf-8");
+	const ftmDir = join(cwd, ".fttm");
+	const gitignorePath = join(ftmDir, ".gitignore");
+	if (existsSync(gitignorePath)) return;
+	mkdirSync(ftmDir, { recursive: true });
+	writeFileSync(gitignorePath, "*\n", "utf-8");
 }
 function setupRun(runId, prompt, baseCommit, cwd) {
 	ensureRunMetadataIgnored(cwd);
@@ -2112,23 +2101,23 @@ function createAgent(name, runInfo, pathOverride, model) {
 //#endregion
 //#region src/templates/iteration-prompt.ts
 function buildIterationPrompt(params) {
-	return `You are working autonomously on an objective given below.
-This is iteration ${params.n} of an ongoing loop to fully accomplish the objective.
+	return `You are working autonomously towards an objective given below.
+This is iteration ${params.n}. Each iteration aims to make an incremental step forward, not to complete the entire objective.
 
 ## Instructions
 
-1. Read .fttm/runs/${params.runId}/notes.md first to understand what has been done in previous iterations.
-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 fttm orchestrator.
-5. When you are done, respond with a JSON object according to the provided schema.
+1. Read .fttm/runs/${params.runId}/notes.md first to understand what has been done in previous iterations
+2. Identify the next smallest logical unit of work that's individually verifiable and would make incremental progress towards the objective, and treat that as the scope of this iteration
+3. If you attempted a solution and it didn't end up moving the needle on the objective, document learnings and record success=false, then conclude the iteration rather than continuously pivoting
+4. If you made code changes, run build/tests/linters/formatters if available to validate your work. Do NOT make any git commits - that will be handled automatically by the fttm orchestrator
+6. Finally, 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
+- success: whether you were able to make a meaningful contribution that got us closer towards the objective. setting this to false means any code change you made should be discarded
 - 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
+- key_learnings: an array of new learnings that were surprising, weren't captured by previous notes and would be informative for future iterations
 
 ## Objective
 
@@ -2149,6 +2138,7 @@ var Orchestrator = class extends EventEmitter {
 	activeIterationPromise = null;
 	activeAbortController = null;
 	pendingAbortReason = null;
+	loopDone = false;
 	state = {
 		status: "running",
 		currentIteration: 0,
@@ -2182,6 +2172,10 @@ var Orchestrator = class extends EventEmitter {
 	stop() {
 		this.stopRequested = true;
 		this.activeAbortController?.abort();
+		if (this.loopDone) {
+			this.emit("stopped");
+			return;
+		}
 		if (this.stopPromise) return;
 		this.stopPromise = (async () => {
 			if (this.activeIterationPromise) {
@@ -2265,6 +2259,7 @@ var Orchestrator = class extends EventEmitter {
 			this.activeIterationPromise = null;
 			if (this.stopPromise) await this.stopPromise;
 			else await this.closeAgent();
+			this.loopDone = true;
 		}
 	}
 	async runIteration(prompt) {
@@ -2789,6 +2784,7 @@ const MOON_PHASE_PERIOD = 1600;
 const MAX_MSG_LINES = 3;
 const MAX_MSG_LINE_LEN = CONTENT_WIDTH;
 const RESUME_HINT = "[ctrl+c to stop, fttm again to resume]";
+const DONE_HINT = "[ctrl+c to exit]";
 function spacedLabel(text) {
 	return text.split("").join(" ");
 }
@@ -2914,10 +2910,8 @@ function centerLineCells(content, width) {
 		...emptyCells(rightPad)
 	];
 }
-function renderResumeHintCells(width, modelName) {
-	const hint = RESUME_HINT;
-	if (modelName) return centerLineCells(textToCells(`${modelName}  ${hint}`, "dim"), width);
-	return centerLineCells(textToCells(hint, "dim"), width);
+function renderResumeHintCells(width, done) {
+	return centerLineCells(textToCells(done ? DONE_HINT : RESUME_HINT, "dim"), width);
 }
 /**
 * Builds the centered content viewport for the renderer.
@@ -3025,7 +3019,8 @@ function buildFrameCells(prompt, agentName, modelName, state, topStars, bottomSt
 		]);
 	}
 	for (let y = 0; y < bottomHeight; y++) frame.push(renderStarLineCells(bottomStars, terminalWidth, y, now));
-	frame.push(renderResumeHintCells(terminalWidth, modelName));
+	const isDone = state.status === "aborted";
+	frame.push(renderResumeHintCells(terminalWidth, isDone));
 	frame.push(emptyCells(terminalWidth));
 	return frame;
 }
@@ -3327,7 +3322,7 @@ program.name("fttm").description("Fly to the moon, fly to the mars - AI agents f
 	process$1.on("SIGINT", handleSigInt);
 	process$1.on("SIGTERM", handleSigTerm);
 	const orchestratorPromise = orchestrator.start().finally(() => {
-		renderer.stop();
+		if (!(orchestrator.getState().status === "aborted" && process$1.stdin.isTTY)) renderer.stop();
 	}).catch((err) => {
 		exitAltScreen();
 		die(err instanceof Error ? err.message : String(err));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fly-to-moon",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "Humans fly to space. AI does the work. — Fly to the moon, fly to Mars",
   "type": "module",
   "bin": {
@@ -43,7 +43,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/evoerax/fttm"
+    "url": "https://github.com/evoerax/fly-to-the-moon"
   },
   "engines": {
     "node": ">=20"