agent-yes 1.128.0 → 1.129.0

package/dist/SUPPORTED_CLIS-BEGaVwg2.js

@@ -0,0 +1,8 @@
+import "./ts-D21pYxoi.js";
+import "./logger-B9h0djqx.js";
+import "./versionChecker-VKD48fzV.js";
+import "./pidStore-CGKIhaJO.js";
+import "./globalPidIndex-C7r2m6s7.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-CRiTrZVs.js";
+
+export { SUPPORTED_CLIS };

package/dist/{SUPPORTED_CLIS-C3hbWNlY.js → SUPPORTED_CLIS-CRiTrZVs.js}

@@ -1,8 +1,8 @@
-import { t as CLIS_CONFIG } from "./ts-blmSvxN5.js";
+import { t as CLIS_CONFIG } from "./ts-D21pYxoi.js";
 
 //#region ts/SUPPORTED_CLIS.ts
 const SUPPORTED_CLIS = Object.keys(CLIS_CONFIG);
 
 //#endregion
 export { SUPPORTED_CLIS as t };
-//# sourceMappingURL=SUPPORTED_CLIS-C3hbWNlY.js.map
+//# sourceMappingURL=SUPPORTED_CLIS-CRiTrZVs.js.map

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env bun
 import { n as logger } from "./logger-B9h0djqx.js";
-import { i as versionString, n as displayVersion, r as getInstalledPackage, t as checkAndAutoUpdate } from "./versionChecker-BmttWH-a.js";
+import { i as versionString, n as displayVersion, r as getInstalledPackage, t as checkAndAutoUpdate } from "./versionChecker-VKD48fzV.js";
 import { argv } from "process";
 import { execFileSync, spawn } from "child_process";
 import ms from "ms";
@@ -482,7 +482,7 @@ function buildRustArgs(argv, cliFromScript, supportedClis) {
 {
 	const rawArg = process.argv[2];
 	const isHelpFlag = rawArg === "-h" || rawArg === "--help";
-	const { isSubcommand, runSubcommand, cmdHelp } = await import("./subcommands-DA0MhdpJ.js");
+	const { isSubcommand, runSubcommand, cmdHelp } = await import("./subcommands-BLUX23IJ.js");
 	if (isHelpFlag && process.argv.length === 3) {
 		cmdHelp();
 		process.exit(0);
@@ -515,7 +515,7 @@ if (config.useRust) {
 		}
 	}
 	if (rustBinary) {
-		const { SUPPORTED_CLIS } = await import("./SUPPORTED_CLIS-9oihdzOp.js");
+		const { SUPPORTED_CLIS } = await import("./SUPPORTED_CLIS-BEGaVwg2.js");
 		const rustArgs = buildRustArgs(process.argv, config.cli, SUPPORTED_CLIS);
 		if (config.verbose) {
 			console.log(`[rust] Using binary: ${rustBinary}`);

package/dist/index.js

@@ -1,6 +1,6 @@
-import { a as removeControlCharacters, i as AgentContext, n as agentYes, r as config, t as CLIS_CONFIG } from "./ts-blmSvxN5.js";
+import { a as removeControlCharacters, i as AgentContext, n as agentYes, r as config, t as CLIS_CONFIG } from "./ts-D21pYxoi.js";
 import "./logger-B9h0djqx.js";
-import "./versionChecker-BmttWH-a.js";
+import "./versionChecker-VKD48fzV.js";
 import "./pidStore-CGKIhaJO.js";
 import "./globalPidIndex-C7r2m6s7.js";
 

package/dist/{schedule-CNhFqdnP.js → schedule-QakndFJf.js}

@@ -1,9 +1,9 @@
-import "./ts-blmSvxN5.js";
+import "./ts-D21pYxoi.js";
 import "./logger-B9h0djqx.js";
-import "./versionChecker-BmttWH-a.js";
+import "./versionChecker-VKD48fzV.js";
 import "./pidStore-CGKIhaJO.js";
 import "./globalPidIndex-C7r2m6s7.js";
-import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-C3hbWNlY.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-CRiTrZVs.js";
 import { n as resolveSpawnCwd } from "./workspaceConfig-BJO4fzEn.js";
 import { createHash } from "node:crypto";
 
@@ -141,4 +141,4 @@ async function cmdSchedule(rest) {
 
 //#endregion
 export { cmdSchedule };
-//# sourceMappingURL=schedule-CNhFqdnP.js.map
+//# sourceMappingURL=schedule-QakndFJf.js.map

package/dist/{serve-CgHUyl6K.js → serve-DpBmExxp.js}

@@ -1,13 +1,13 @@
-import "./ts-blmSvxN5.js";
+import "./ts-D21pYxoi.js";
 import "./logger-B9h0djqx.js";
-import { r as getInstalledPackage } from "./versionChecker-BmttWH-a.js";
+import { r as getInstalledPackage } from "./versionChecker-VKD48fzV.js";
 import "./pidStore-CGKIhaJO.js";
 import { a as updateGlobalPidStatus } from "./globalPidIndex-C7r2m6s7.js";
 import { t as pgidForWrapper } from "./reaper-BkjPN7mw.js";
 import "./configShared-C5QaNPnz.js";
-import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-C3hbWNlY.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-CRiTrZVs.js";
 import "./remotes-D8GvSbhf.js";
-import { f as readNotes, g as snapshotStatus, m as resolveOne, o as extractTaskCounts, p as renderRawLog, r as controlCodeFromName, u as listRecords, v as writeToIpc } from "./subcommands-7ZNa2rCG.js";
+import { d as listRecords, g as resolveOne, i as controlCodeFromName, m as renderRawLog, p as readNotes, s as extractTaskCounts, x as writeToIpc, y as snapshotStatus } from "./subcommands-D1floyWA.js";
 import yargs from "yargs";
 import { mkdir, open, readFile, stat, writeFile } from "fs/promises";
 import { homedir, hostname, userInfo } from "os";
@@ -1134,4 +1134,4 @@ Options:
 
 //#endregion
 export { cmdServe };
-//# sourceMappingURL=serve-CgHUyl6K.js.map
+//# sourceMappingURL=serve-DpBmExxp.js.map

package/dist/{setup-Bituq_if.js → setup-DCisWuHB.js}

@@ -32,7 +32,7 @@ async function cmdSetup(rest) {
 	if (!existsSync(abs)) process.stderr.write(`  note: that directory doesn't exist yet — create it, or agents spawned there will fail\n`);
 	if (noShare) return 0;
 	process.stdout.write(`\nsharing this machine to agent-yes.com…\n`);
-	const { cmdServe } = await import("./serve-CgHUyl6K.js");
+	const { cmdServe } = await import("./serve-DpBmExxp.js");
 	return cmdServe([
 		"install",
 		"--share",
@@ -42,4 +42,4 @@ async function cmdSetup(rest) {
 
 //#endregion
 export { cmdSetup };
-//# sourceMappingURL=setup-Bituq_if.js.map
+//# sourceMappingURL=setup-DCisWuHB.js.map

package/dist/subcommands-BLUX23IJ.js

@@ -0,0 +1,7 @@
+import "./logger-B9h0djqx.js";
+import "./globalPidIndex-C7r2m6s7.js";
+import "./configShared-C5QaNPnz.js";
+import "./remotes-D8GvSbhf.js";
+import { _ as resolveReadWindow, a as cursorAbs, b as stopTipForCli, c as finalizedLines, d as listRecords, f as matchKeyword, g as resolveOne, h as renderRawLogLines, i as controlCodeFromName, l as isPidAlive, m as renderRawLog, n as READ_PAGE_DEFAULT, o as extractNeedsInput, p as readNotes, r as cmdHelp, s as extractTaskCounts, t as GRACEFUL_EXIT_COMMANDS, u as isSubcommand, v as runSubcommand, x as writeToIpc, y as snapshotStatus } from "./subcommands-D1floyWA.js";
+
+export { cmdHelp, isSubcommand, runSubcommand };

package/dist/{subcommands-7ZNa2rCG.js → subcommands-D1floyWA.js}

@@ -524,15 +524,15 @@ async function runSubcommand(argv) {
 			case "restart": return await cmdRestart(rest);
 			case "note": return await cmdNote(rest);
 			case "serve": {
-				const { cmdServe } = await import("./serve-CgHUyl6K.js");
+				const { cmdServe } = await import("./serve-DpBmExxp.js");
 				return cmdServe(rest);
 			}
 			case "setup": {
-				const { cmdSetup } = await import("./setup-Bituq_if.js");
+				const { cmdSetup } = await import("./setup-DCisWuHB.js");
 				return cmdSetup(rest);
 			}
 			case "schedule": {
-				const { cmdSchedule } = await import("./schedule-CNhFqdnP.js");
+				const { cmdSchedule } = await import("./schedule-QakndFJf.js");
 				return cmdSchedule(rest);
 			}
 			case "remote": {
@@ -552,7 +552,7 @@ async function runSubcommand(argv) {
 	}
 }
 function cmdHelp() {
-	process.stdout.write("ay - agent-yes CLI\n\nManagement:\n  ay ls [keyword]                     list running agents\n  ay tail [-f] <keyword>              stream output  (Ctrl-C to stop)\n  ay cat <keyword>                    full log\n  ay head <keyword>                   first N lines\n  ay send <keyword> <msg>             send a message\n  ay attach <keyword>                 interactive attach (detach: Ctrl-\\)\n  ay stop <keyword>                   graceful shutdown (/exit for claude/codex)\n  ay status <keyword>                 agent status snapshot\n  ay result <keyword> [--wait]        pull an agent's structured result envelope\n  ay result set '<json>'              (inside an agent) deposit your result envelope\n  ay reap                             kill process groups leaked by dead agents\n\nRemote:\n  ay setup                            guided setup: pick a workspace, share to agent-yes.com\n  ay schedule <when> <cli> -- <msg>   run an agent on a schedule (HH:MM or cron)\n  ay serve [--port N]                 start HTTP API server (prints token)\n  ay serve status                     show serve daemon/server status\n  ay remote add <alias> http://<token>@<host>:<port>\n  ay remote ls / rm <alias>           manage saved remotes\n  ay ls   <token>@<host>:<port>       connect inline (no alias needed)\n  ay send <token>@<host>:<port>:<kw> <msg>\n\nRun an agent:\n  ay [claude|codex|gemini|...] [options] -- [prompt]\n  ay claude -- \"fix the bug in auth.ts\"\n  ay claude --help                    full agent-runner options\n\nLabs (examples at https://github.com/snomiao/agent-yes/tree/main/lab):\n  local-role-play/   designer + builder on one machine\n  http-remote/       ay serve remote access demo\n  p2p-pairing/       libp2p P2P  (needs: cargo build --features swarm)\n");
+	process.stdout.write("ay - agent-yes CLI\n\nManagement:\n  ay ls [keyword]                     list running agents\n  ay tail [-f] [-n N] <keyword>       last N lines (96), -f to follow\n  ay read <keyword> [page opts]       paginate: --last/--head N, --range A:B,\n                                        --before-line L [--limit N]\n  ay cat <keyword>                    full log\n  ay head <keyword>                   first N lines\n  ay send <keyword> <msg>             send a message\n  ay attach <keyword>                 interactive attach (detach: Ctrl-\\)\n  ay stop <keyword>                   graceful shutdown (/exit for claude/codex)\n  ay status <keyword>                 agent status snapshot\n  ay result <keyword> [--wait]        pull an agent's structured result envelope\n  ay result set '<json>'              (inside an agent) deposit your result envelope\n  ay reap                             kill process groups leaked by dead agents\n\nRemote:\n  ay setup                            guided setup: pick a workspace, share to agent-yes.com\n  ay schedule <when> <cli> -- <msg>   run an agent on a schedule (HH:MM or cron)\n  ay serve [--port N]                 start HTTP API server (prints token)\n  ay serve status                     show serve daemon/server status\n  ay remote add <alias> http://<token>@<host>:<port>\n  ay remote ls / rm <alias>           manage saved remotes\n  ay ls   <token>@<host>:<port>       connect inline (no alias needed)\n  ay send <token>@<host>:<port>:<kw> <msg>\n\nRun an agent:\n  ay [claude|codex|gemini|...] [options] -- [prompt]\n  ay claude -- \"fix the bug in auth.ts\"\n  ay claude --help                    full agent-runner options\n\nLabs (examples at https://github.com/snomiao/agent-yes/tree/main/lab):\n  local-role-play/   designer + builder on one machine\n  http-remote/       ay serve remote access demo\n  p2p-pairing/       libp2p P2P  (needs: cargo build --features swarm)\n");
 	return 0;
 }
 function matchKeyword(record, keyword) {
@@ -1153,7 +1153,7 @@ function truncate(s, n) {
 	return s.slice(0, n - 1) + "…";
 }
 async function cmdRead(rest, { mode }) {
-	const argv = await yargs(rest).usage("Usage: ay read/cat/tail/head <keyword> [options]").option("follow", {
+	const argv = await yargs(rest).usage("Usage: ay read/cat/tail/head <keyword> [options]\n\nPagination (static read; render the log once, window the rendered lines):\n  --last N | --head N         last / first N lines\n  --range A:B                 lines A..B (1-indexed, inclusive)\n  --before-line L [--limit N] the page of N lines ending just above line L").option("follow", {
 		alias: "f",
 		type: "boolean",
 		default: false,
@@ -1161,6 +1161,21 @@ async function cmdRead(rest, { mode }) {
 	}).option("n", {
 		type: "number",
 		description: "Number of lines (default: 96 for tail/head)"
+	}).option("last", {
+		type: "number",
+		description: "Show the last N rendered lines"
+	}).option("head", {
+		type: "number",
+		description: "Show the first N rendered lines"
+	}).option("range", {
+		type: "string",
+		description: "Show rendered lines A:B (1-indexed, inclusive)"
+	}).option("before-line", {
+		type: "number",
+		description: "Paginate: show the page of lines ending just above line L"
+	}).option("limit", {
+		type: "number",
+		description: "Page size for --before-line (default 96)"
 	}).option("plain", {
 		type: "boolean",
 		default: false,
@@ -1214,22 +1229,41 @@ async function cmdRead(rest, { mode }) {
 	}
 	if (!stats.isFile()) throw new Error(`pid ${record.pid}: log path is not a file: ${logPath}`);
 	const buf = await readFile(logPath);
-	const rendered = await renderRawLog(buf, {
-		mode,
-		n
-	});
 	const noteLabel = (await readNotes()).get(record.pid);
 	const header = noteLabel ? `[pid ${record.pid}  ${shortenPath(record.cwd)}  * ${noteLabel}]` : `[pid ${record.pid}  ${shortenPath(record.cwd)}]`;
-	process.stderr.write(header + "\n");
-	process.stdout.write(rendered);
-	if (!rendered.endsWith("\n")) process.stdout.write("\n");
 	if (follow) {
+		const rendered = await renderRawLog(buf, {
+			mode,
+			n
+		});
+		process.stderr.write(header + "\n");
+		process.stdout.write(rendered);
+		if (!rendered.endsWith("\n")) process.stdout.write("\n");
 		setInterval(() => void recordRead(reader.key, record.pid), 3e4).unref?.();
 		return plain ? followPlainLocal(logPath, buf) : followRawLocal(logPath, buf);
 	}
-	process.stderr.write(`
-  ay ls                                 # list all agents
-  ay tail -f ${record.pid}              # follow live output\n  ay send ${record.pid} "next: ..."      # send a prompt\n  ay send ${record.pid} "" --code=ctrl-c # interrupt\n`);
+	const allLines = await renderRawLogLines(buf);
+	const total = allLines.length;
+	const win = resolveReadWindow({
+		total,
+		mode,
+		n: argv.n,
+		last: argv.last,
+		head: argv.head,
+		range: argv.range,
+		beforeLine: argv["before-line"],
+		limit: argv.limit
+	});
+	const rendered = allLines.slice(win.start, win.end).join("\n");
+	process.stderr.write(header + "\n");
+	process.stdout.write(rendered);
+	if (!rendered.endsWith("\n")) process.stdout.write("\n");
+	const firstVisible = win.start + 1;
+	const shown = win.end - win.start;
+	const hints = [`\n`, `  ay ls                                 # list all agents\n`];
+	if (win.start > 0) hints.push(`  ay read ${record.pid} --before-line ${firstVisible} --limit ${shown || READ_PAGE_DEFAULT}   # older lines (page up)\n`);
+	hints.push(`  ay read ${record.pid} --range A:B            # lines A..B of ${total}\n`, `  ay tail -f ${record.pid}              # follow live output\n`, `  ay send ${record.pid} "next: ..."      # send a prompt\n`);
+	process.stderr.write(hints.join(""));
 	return 0;
 }
 /**
@@ -1394,9 +1428,23 @@ async function followPlainLocal(logPath, buf) {
 * Same approach as koho's renderTerminalBuffer + agent-yes's XtermProxy.
 */
 async function renderRawLog(buf, { mode, n }) {
+	const lines = await renderRawLogLines(buf);
+	if (mode === "cat") return lines.join("\n");
+	if (mode === "tail") return lines.slice(Math.max(0, lines.length - n)).join("\n");
+	return lines.slice(0, n).join("\n");
+}
+/**
+* Render the raw PTY byte stream to its full array of scrollback lines (trailing
+* blanks trimmed). This is the substrate `renderRawLog` slices by mode and that
+* pagination (`resolveReadWindow`) indexes into — slicing the FINAL rendered
+* state is sound, but rendering from an arbitrary mid-stream offset is not (PTY
+* cursor moves / clears / wraps), so we always render the whole buffer once and
+* window the resulting lines.
+*/
+async function renderRawLogLines(buf) {
 	const cols = 200;
 	const rows = 50;
-	const scrollback = Math.max(5e4, n + rows + 100);
+	const scrollback = 5e4;
 	try {
 		const { Terminal } = await import("@xterm/headless");
 		const term = new Terminal({
@@ -1413,18 +1461,73 @@ async function renderRawLog(buf, { mode, n }) {
 			lines.push(line ? line.translateToString(false).trimEnd() : "");
 		}
 		while (lines.length > 0 && lines[lines.length - 1] === "") lines.pop();
-		if (mode === "cat") return lines.join("\n");
-		if (mode === "tail") return lines.slice(Math.max(0, lines.length - n)).join("\n");
-		return lines.slice(0, n).join("\n");
+		return lines;
 	} catch {
 		let text = new TextDecoder().decode(buf);
 		text = text.replace(/\x1b\[[0-?]*[ -/]*[@-~]|\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)|\x1b[@-Z\\-_]/g, "").replace(/[\x00-\x08\x0b\x0c\x0e-\x1f\x7f]/g, "");
 		const lines = text.split("\n");
-		if (mode === "cat") return lines.join("\n");
-		if (mode === "tail") return lines.slice(Math.max(0, lines.length - n)).join("\n");
-		return lines.slice(0, n).join("\n");
+		while (lines.length > 0 && lines[lines.length - 1] === "") lines.pop();
+		return lines;
 	}
 }
+const READ_PAGE_DEFAULT = 96;
+/**
+* Resolve which rendered lines to show. Precedence (first match wins):
+*   1. `range` "A:B"        — explicit 1-indexed inclusive window
+*   2. `beforeLine` (+limit)— the page of `limit` lines ending just ABOVE line L
+*                             (the pagination cursor `ay read` prints in its footer)
+*   3. `head` / `last`      — explicit first/last N rendered lines
+*   4. mode preset + `-n`   — tail/head default to the last/first N (96); cat = all
+* Indices are clamped to `[0, total]`; an empty / non-matching `range` falls through.
+*/
+function resolveReadWindow(opts) {
+	const total = Math.max(0, Math.floor(opts.total));
+	const clamp = (v) => Math.max(0, Math.min(total, Math.floor(v)));
+	const pos = (v) => v != null && Number.isFinite(v) && v > 0 ? Math.floor(v) : void 0;
+	const range = opts.range?.trim();
+	if (range) {
+		const m = /^(\d+):(\d+)$/.exec(range);
+		if (m) {
+			const a = parseInt(m[1], 10);
+			const b = parseInt(m[2], 10);
+			return {
+				start: clamp(Math.min(a, b) - 1),
+				end: clamp(Math.max(a, b))
+			};
+		}
+	}
+	if (opts.beforeLine != null && Number.isFinite(opts.beforeLine)) {
+		const limit = pos(opts.limit) ?? READ_PAGE_DEFAULT;
+		const end = clamp(opts.beforeLine - 1);
+		return {
+			start: clamp(end - limit),
+			end
+		};
+	}
+	const head = pos(opts.head);
+	if (head != null) return {
+		start: 0,
+		end: clamp(head)
+	};
+	const last = pos(opts.last);
+	if (last != null) return {
+		start: clamp(total - last),
+		end: total
+	};
+	const n = pos(opts.n);
+	if (opts.mode === "head") return {
+		start: 0,
+		end: clamp(n ?? READ_PAGE_DEFAULT)
+	};
+	if (opts.mode === "tail") return {
+		start: clamp(total - (n ?? READ_PAGE_DEFAULT)),
+		end: total
+	};
+	return {
+		start: 0,
+		end: total
+	};
+}
 /**
 * Extract a one-line activity summary from a raw log file.
 * Reads only the last 32 KB for speed, renders via xterm for clean output.
@@ -2303,5 +2406,5 @@ async function cmdResultSet(rest) {
 }
 
 //#endregion
-export { stopTipForCli as _, extractNeedsInput as a, isPidAlive as c, matchKeyword as d, readNotes as f, snapshotStatus as g, runSubcommand as h, cursorAbs as i, isSubcommand as l, resolveOne as m, cmdHelp as n, extractTaskCounts as o, renderRawLog as p, controlCodeFromName as r, finalizedLines as s, GRACEFUL_EXIT_COMMANDS as t, listRecords as u, writeToIpc as v };
-//# sourceMappingURL=subcommands-7ZNa2rCG.js.map
+export { resolveReadWindow as _, cursorAbs as a, stopTipForCli as b, finalizedLines as c, listRecords as d, matchKeyword as f, resolveOne as g, renderRawLogLines as h, controlCodeFromName as i, isPidAlive as l, renderRawLog as m, READ_PAGE_DEFAULT as n, extractNeedsInput as o, readNotes as p, cmdHelp as r, extractTaskCounts as s, GRACEFUL_EXIT_COMMANDS as t, isSubcommand as u, runSubcommand as v, writeToIpc as x, snapshotStatus as y };
+//# sourceMappingURL=subcommands-D1floyWA.js.map

package/dist/{ts-blmSvxN5.js → ts-D21pYxoi.js}

@@ -1,5 +1,5 @@
 import { n as logger, t as addTransport } from "./logger-B9h0djqx.js";
-import { r as getInstalledPackage } from "./versionChecker-BmttWH-a.js";
+import { r as getInstalledPackage } from "./versionChecker-VKD48fzV.js";
 import { t as agentYesHome } from "./agentYesHome-BvaUOzCV.js";
 import { i as shouldUseLock, r as releaseLock, t as acquireLock } from "./runningLock-CJxsoGdb.js";
 import { t as PidStore } from "./pidStore-CGKIhaJO.js";
@@ -1787,4 +1787,4 @@ function sleep(ms) {
 
 //#endregion
 export { removeControlCharacters as a, AgentContext as i, agentYes as n, config as r, CLIS_CONFIG as t };
-//# sourceMappingURL=ts-blmSvxN5.js.map
+//# sourceMappingURL=ts-D21pYxoi.js.map

package/dist/{versionChecker-BmttWH-a.js → versionChecker-VKD48fzV.js}

@@ -7,7 +7,7 @@ import { fileURLToPath } from "url";
 
 //#region package.json
 var name = "agent-yes";
-var version = "1.128.0";
+var version = "1.129.0";
 
 //#endregion
 //#region ts/versionChecker.ts
@@ -215,4 +215,4 @@ async function displayVersion() {
 
 //#endregion
 export { versionString as i, displayVersion as n, getInstalledPackage as r, checkAndAutoUpdate as t };
-//# sourceMappingURL=versionChecker-BmttWH-a.js.map
+//# sourceMappingURL=versionChecker-VKD48fzV.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-yes",
-  "version": "1.128.0",
+  "version": "1.129.0",
   "description": "A wrapper tool that automates interactions with various AI CLI tools by automatically handling common prompts and responses.",
   "keywords": [
     "ai",

package/ts/subcommands.spec.ts

@@ -1253,3 +1253,74 @@ describe("subcommands.listRecords merges per-cwd TS file with global", () => {
     }
   });
 });
+
+describe("subcommands.resolveReadWindow", () => {
+  const total = 100;
+
+  it("defaults: tail = last 96, head = first 96, cat = all", async () => {
+    const { resolveReadWindow } = await loadModule();
+    expect(resolveReadWindow({ total: 200, mode: "tail" })).toEqual({ start: 104, end: 200 });
+    expect(resolveReadWindow({ total: 200, mode: "head" })).toEqual({ start: 0, end: 96 });
+    expect(resolveReadWindow({ total: 200, mode: "cat" })).toEqual({ start: 0, end: 200 });
+  });
+
+  it("respects -n for tail/head; cat ignores -n (stays whole)", async () => {
+    const { resolveReadWindow } = await loadModule();
+    expect(resolveReadWindow({ total, mode: "tail", n: 10 })).toEqual({ start: 90, end: 100 });
+    expect(resolveReadWindow({ total, mode: "head", n: 10 })).toEqual({ start: 0, end: 10 });
+    expect(resolveReadWindow({ total, mode: "cat", n: 10 })).toEqual({ start: 0, end: 100 });
+  });
+
+  it("--last / --head override the mode", async () => {
+    const { resolveReadWindow } = await loadModule();
+    expect(resolveReadWindow({ total, mode: "cat", last: 5 })).toEqual({ start: 95, end: 100 });
+    expect(resolveReadWindow({ total, mode: "tail", head: 5 })).toEqual({ start: 0, end: 5 });
+  });
+
+  it("--range A:B is 1-indexed inclusive and order-insensitive", async () => {
+    const { resolveReadWindow } = await loadModule();
+    expect(resolveReadWindow({ total, mode: "cat", range: "10:20" })).toEqual({
+      start: 9,
+      end: 20,
+    });
+    expect(resolveReadWindow({ total, mode: "cat", range: "20:10" })).toEqual({
+      start: 9,
+      end: 20,
+    });
+  });
+
+  it("--before-line L shows the page of `limit` lines ending just above L", async () => {
+    const { resolveReadWindow } = await loadModule();
+    // page-up cursor: lines strictly before line 51, limit 10 -> [41..50] (0-idx 40..50)
+    expect(resolveReadWindow({ total, mode: "cat", beforeLine: 51, limit: 10 })).toEqual({
+      start: 40,
+      end: 50,
+    });
+    // round-trip: first-visible of the above is line 41; paging up again from 41
+    expect(resolveReadWindow({ total, mode: "cat", beforeLine: 41, limit: 10 })).toEqual({
+      start: 30,
+      end: 40,
+    });
+  });
+
+  it("clamps out-of-range indices", async () => {
+    const { resolveReadWindow } = await loadModule();
+    expect(resolveReadWindow({ total: 5, mode: "tail", n: 999 })).toEqual({ start: 0, end: 5 });
+    expect(resolveReadWindow({ total: 5, mode: "cat", range: "3:999" })).toEqual({
+      start: 2,
+      end: 5,
+    });
+    expect(resolveReadWindow({ total: 5, mode: "cat", beforeLine: 2, limit: 999 })).toEqual({
+      start: 0,
+      end: 1,
+    });
+  });
+
+  it("ignores a malformed --range and falls through to the mode default", async () => {
+    const { resolveReadWindow } = await loadModule();
+    expect(resolveReadWindow({ total, mode: "head", range: "not-a-range" })).toEqual({
+      start: 0,
+      end: 96,
+    });
+  });
+});

package/dist/SUPPORTED_CLIS-9oihdzOp.js

@@ -1,8 +0,0 @@
-import "./ts-blmSvxN5.js";
-import "./logger-B9h0djqx.js";
-import "./versionChecker-BmttWH-a.js";
-import "./pidStore-CGKIhaJO.js";
-import "./globalPidIndex-C7r2m6s7.js";
-import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-C3hbWNlY.js";
-
-export { SUPPORTED_CLIS };

package/dist/subcommands-DA0MhdpJ.js

@@ -1,7 +0,0 @@
-import "./logger-B9h0djqx.js";
-import "./globalPidIndex-C7r2m6s7.js";
-import "./configShared-C5QaNPnz.js";
-import "./remotes-D8GvSbhf.js";
-import { _ as stopTipForCli, a as extractNeedsInput, c as isPidAlive, d as matchKeyword, f as readNotes, g as snapshotStatus, h as runSubcommand, i as cursorAbs, l as isSubcommand, m as resolveOne, n as cmdHelp, o as extractTaskCounts, p as renderRawLog, r as controlCodeFromName, s as finalizedLines, t as GRACEFUL_EXIT_COMMANDS, u as listRecords, v as writeToIpc } from "./subcommands-7ZNa2rCG.js";
-
-export { cmdHelp, isSubcommand, runSubcommand };