@react-grab/cli 0.1.41 → 0.1.42

package/dist/cli.cjs

@@ -493,15 +493,15 @@ const promptSkillInstall = async ({ yes = false, global = false, cwd = process.c
 	for (const record of failed) logger.log(`  ${highlighter.error("✗")} ${agentLabel(record.agent)} ${record.error}`);
 	return true;
 };
-const removeSkill = async (cwd = process.cwd()) => {
+const removeSkill = async ({ cwd = process.cwd(), global = false } = {}) => {
 	const agents = await detectAvailableAgents();
 	const removedAgents = [];
 	const dirsToRemove = /* @__PURE__ */ new Set();
 	for (const agent of agents) {
-		const present = [installedSkillDir(agent, false, cwd), installedSkillDir(agent, true, cwd)].filter((dir) => (0, node_fs.existsSync)(dir));
-		if (present.length === 0) continue;
+		const skillDir = installedSkillDir(agent, global, cwd);
+		if (!(0, node_fs.existsSync)(skillDir)) continue;
 		removedAgents.push(agent);
-		for (const dir of present) dirsToRemove.add(dir);
+		dirsToRemove.add(skillDir);
 	}
 	for (const skillDir of dirsToRemove) (0, node_fs.rmSync)(skillDir, {
 		recursive: true,
@@ -512,7 +512,7 @@ const removeSkill = async (cwd = process.cwd()) => {
 };
 //#endregion
 //#region src/commands/add.ts
-const VERSION$5 = "0.1.41";
+const VERSION$5 = "0.1.42";
 const add = new commander.Command().name("add").alias("install").description("install the React Grab skill for your agent").option("-y, --yes", "skip confirmation prompts", false).option("-c, --cwd <cwd>", "working directory (defaults to current directory)", process.cwd()).option("-g, --global", "install the skill globally instead of in the project", false).action(async (opts) => {
 	console.log(`${picocolors.default.magenta("✿")} ${picocolors.default.bold("React Grab")} ${picocolors.default.gray(VERSION$5)}`);
 	console.log();
@@ -1111,7 +1111,9 @@ const previewCdnTransform = (projectRoot, framework, nextRouterType, targetCdnDo
 //#region src/utils/constants.ts
 const MAX_KEY_HOLD_DURATION_MS = 2e3;
 const DEFAULT_WATCH_DIR = ".react-grab";
-const MAX_GRAB_AGE_MS = 300 * 1e3;
+const DEFAULT_GRAB_AGE_MS = 300 * 1e3;
+const MAX_READ_HISTORY_BYTES = 128 * 1024 * 1024;
+const MIGRATION_SCAN_CHUNK_BYTES = 1024 * 1024;
 //#endregion
 //#region src/utils/format-activation-key.ts
 const formatActivationKeyDisplay = (activationKey) => {
@@ -1129,7 +1131,7 @@ const formatActivationKeyDisplay = (activationKey) => {
 };
 //#endregion
 //#region src/commands/configure.ts
-const VERSION$4 = "0.1.41";
+const VERSION$4 = "0.1.42";
 const isMac = process.platform === "darwin";
 const META_LABEL = isMac ? "Cmd" : "Win";
 const ALT_LABEL = isMac ? "Option" : "Alt";
@@ -1748,7 +1750,7 @@ const installPackagesWithFeedback = async (packages, packageManager, projectRoot
 };
 //#endregion
 //#region src/commands/init.ts
-const VERSION$3 = "0.1.41";
+const VERSION$3 = "0.1.42";
 const REPORT_URL = "https://react-grab.com/api/report-cli";
 const DOCS_URL = "https://github.com/aidenybai/react-grab";
 const reportToCli = (type, config, error) => {
@@ -2105,6 +2107,8 @@ const sleep = (durationMs) => new Promise((resolve) => setTimeout(resolve, durat
 //#endregion
 //#region src/utils/clipboard.ts
 const HISTORY_FILE_NAME = "history.jsonl";
+const NO_READER_MESSAGE = "no clipboard reader available. Linux: install xclip or wl-clipboard. macOS: install Xcode CLI tools (swiftc) or rely on pbpaste. Windows: ensure PowerShell is on PATH.";
+const READERS_DIR = node_path.default.dirname((0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href));
 const READ_TIMEOUT_MS = 2500;
 const MAX_CLIPBOARD_BYTES = 64 * 1024 * 1024;
 const ID_RADIX = 36;
@@ -2198,7 +2202,7 @@ const compileSwiftReader = (readersDir, workDir) => {
 	return binary;
 };
 const createDarwinReader = (options) => {
-	const binary = options.textOnly ? null : compileSwiftReader(options.readersDir, options.workDir);
+	const binary = options.textOnly ? null : compileSwiftReader(READERS_DIR, options.workDir);
 	if (binary) return {
 		mode: "darwin-native",
 		read: () => {
@@ -2281,7 +2285,7 @@ const detectPowershell = () => hasCommand("pwsh") ? "pwsh" : hasCommand("powersh
 const createWindowsReader = (options) => {
 	const shell = detectPowershell();
 	if (!shell) return null;
-	const scriptPath = node_path.default.join(options.readersDir, "read-clipboard.ps1");
+	const scriptPath = node_path.default.join(READERS_DIR, "read-clipboard.ps1");
 	if (options.textOnly || !node_fs.default.existsSync(scriptPath)) return {
 		mode: "win-text",
 		read: () => {
@@ -2420,108 +2424,291 @@ const runWatchLoop = async (options) => {
 	}
 };
 //#endregion
+//#region src/utils/daemon.ts
+const PID_FILE_NAME = "watch.pid";
+const pidFilePath = (dir) => node_path.default.join(dir, PID_FILE_NAME);
+const cliEntryPath = () => process.argv[1] ?? (0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href);
+const isProcessAlive = (pid) => {
+	if (!Number.isInteger(pid) || pid <= 0) return false;
+	try {
+		process.kill(pid, 0);
+		return true;
+	} catch (error) {
+		return error.code === "EPERM";
+	}
+};
+const readDaemonPid = (dir) => {
+	try {
+		const pid = Number.parseInt(node_fs.default.readFileSync(pidFilePath(dir), "utf8").trim(), 10);
+		return Number.isInteger(pid) && pid > 0 ? pid : null;
+	} catch {
+		return null;
+	}
+};
+const isDaemonRunning = (dir) => {
+	const pid = readDaemonPid(dir);
+	return pid !== null && isProcessAlive(pid);
+};
+const claimDaemon = (dir) => {
+	const file = pidFilePath(dir);
+	for (let attempt = 0; attempt < 50; attempt += 1) try {
+		const handle = node_fs.default.openSync(file, "wx");
+		node_fs.default.writeFileSync(handle, String(process.pid));
+		node_fs.default.closeSync(handle);
+		return readDaemonPid(dir) === process.pid;
+	} catch (error) {
+		if (error.code !== "EEXIST") throw error;
+		if (isDaemonRunning(dir)) return false;
+		try {
+			node_fs.default.rmSync(file, { force: true });
+		} catch {}
+	}
+	return false;
+};
+const releaseDaemon = (dir) => {
+	if (readDaemonPid(dir) === process.pid) try {
+		node_fs.default.rmSync(pidFilePath(dir), { force: true });
+	} catch {}
+};
+const stopDaemon = (dir) => {
+	const pid = readDaemonPid(dir);
+	if (pid === null) return null;
+	const wasAlive = isProcessAlive(pid);
+	if (wasAlive) try {
+		process.kill(pid, "SIGTERM");
+	} catch {}
+	if (readDaemonPid(dir) === pid) try {
+		node_fs.default.rmSync(pidFilePath(dir), { force: true });
+	} catch {}
+	return wasAlive ? pid : null;
+};
+const spawnDaemon = (options) => {
+	const args = [
+		cliEntryPath(),
+		"watch",
+		"--dir",
+		options.dir,
+		"--interval",
+		String(options.intervalMs)
+	];
+	if (options.textOnly) args.push("--text-only");
+	if (options.replayLast) args.push("--replay-last");
+	(0, node_child_process.spawn)(process.execPath, args, {
+		detached: true,
+		stdio: "ignore",
+		windowsHide: true
+	}).unref();
+};
+const ensureDaemon = (options) => {
+	if (isDaemonRunning(options.dir)) return "already-running";
+	if (!createReader({
+		textOnly: options.textOnly,
+		workDir: options.dir
+	})) return "no-reader";
+	spawnDaemon(options);
+	return "started";
+};
+//#endregion
 //#region src/utils/grab-log.ts
 const CURSOR_FILE_NAME = "cursor.txt";
+const NEWLINE_BYTE = 10;
 const cursorFilePath = (dir) => node_path.default.join(dir, CURSOR_FILE_NAME);
-const readCompleteGrabLines = (dir) => {
-	let raw;
+const historyFilePath = (dir) => node_path.default.join(dir, HISTORY_FILE_NAME);
+const fileSize = (filePath) => {
 	try {
-		raw = node_fs.default.readFileSync(node_path.default.join(dir, HISTORY_FILE_NAME), "utf8");
+		return node_fs.default.statSync(filePath).size;
 	} catch {
-		return [];
+		return 0;
 	}
-	const lastNewline = raw.lastIndexOf("\n");
-	if (lastNewline < 0) return [];
-	return raw.slice(0, lastNewline).split("\n").filter(Boolean);
+};
+const readHistoryRange = (dir, start, length) => {
+	if (length <= 0) return "";
+	const fd = node_fs.default.openSync(historyFilePath(dir), "r");
+	try {
+		const buffer = Buffer.allocUnsafe(length);
+		const bytesRead = node_fs.default.readSync(fd, buffer, 0, length, start);
+		return buffer.toString("utf8", 0, bytesRead);
+	} finally {
+		node_fs.default.closeSync(fd);
+	}
+};
+const writeGrabCursor = (dir, offset) => {
+	const target = cursorFilePath(dir);
+	const tempPath = `${target}.${process.pid}.tmp`;
+	node_fs.default.writeFileSync(tempPath, JSON.stringify({ offset }));
+	node_fs.default.renameSync(tempPath, target);
+};
+const byteOffsetAfterLines = (dir, lineCount) => {
+	const filePath = historyFilePath(dir);
+	const size = fileSize(filePath);
+	if (lineCount <= 0 || size === 0) return 0;
+	const fd = node_fs.default.openSync(filePath, "r");
+	try {
+		const buffer = Buffer.allocUnsafe(MIGRATION_SCAN_CHUNK_BYTES);
+		let position = 0;
+		let seen = 0;
+		while (position < size) {
+			const bytesRead = node_fs.default.readSync(fd, buffer, 0, MIGRATION_SCAN_CHUNK_BYTES, position);
+			if (bytesRead <= 0) break;
+			for (let index = 0; index < bytesRead; index += 1) {
+				if (buffer[index] !== NEWLINE_BYTE) continue;
+				seen += 1;
+				if (seen === lineCount) return position + index + 1;
+			}
+			position += bytesRead;
+		}
+	} finally {
+		node_fs.default.closeSync(fd);
+	}
+	return size;
 };
 const readGrabCursor = (dir) => {
+	let raw;
 	try {
-		const value = Number.parseInt(node_fs.default.readFileSync(cursorFilePath(dir), "utf8").trim(), 10);
-		return Number.isInteger(value) && value >= 0 ? value : 0;
+		raw = node_fs.default.readFileSync(cursorFilePath(dir), "utf8").trim();
 	} catch {
 		return 0;
 	}
-};
-const grabReceivedAt = (line) => {
+	if (raw === "") return 0;
+	let parsed;
 	try {
-		const value = JSON.parse(line).receivedAt;
-		return typeof value === "number" ? value : null;
+		parsed = JSON.parse(raw);
 	} catch {
-		return null;
+		return 0;
 	}
+	if (typeof parsed === "number") {
+		if (!Number.isInteger(parsed) || parsed < 0) return 0;
+		const offset = byteOffsetAfterLines(dir, parsed);
+		writeGrabCursor(dir, offset);
+		return offset;
+	}
+	return typeof parsed.offset === "number" && Number.isInteger(parsed.offset) && parsed.offset >= 0 ? parsed.offset : 0;
+};
+const readCompleteGrabLines = (dir) => {
+	const size = fileSize(historyFilePath(dir));
+	if (size === 0) return [];
+	const raw = readHistoryRange(dir, 0, size);
+	const lastNewline = raw.lastIndexOf("\n");
+	if (lastNewline < 0) return [];
+	return raw.slice(0, lastNewline).split("\n").filter(Boolean);
 };
 const consumeGrabs = (dir, options) => {
-	const lines = readCompleteGrabLines(dir);
-	if (options.all) return lines;
-	const maxAgeMs = options.maxAgeMs ?? 0;
+	if (options.all) return readCompleteGrabLines(dir);
+	const size = fileSize(historyFilePath(dir));
 	const cursor = readGrabCursor(dir);
-	const total = lines.length;
+	const start = cursor > size ? 0 : cursor;
+	if (start >= size) {
+		if (start !== cursor) writeGrabCursor(dir, start);
+		return [];
+	}
+	const chunk = readHistoryRange(dir, start, Math.min(size - start, MAX_READ_HISTORY_BYTES));
+	const lastNewline = chunk.lastIndexOf("\n");
+	if (lastNewline < 0) return [];
 	const now = Date.now();
 	const fresh = [];
-	let index = Math.min(cursor, total);
-	while (index < total && (options.limit <= 0 || fresh.length < options.limit)) {
-		const line = lines[index];
-		index += 1;
-		if (maxAgeMs > 0) {
-			const receivedAt = grabReceivedAt(line);
-			if (receivedAt !== null && now - receivedAt > maxAgeMs) continue;
+	let consumedBytes = 0;
+	let lineStart = 0;
+	while (lineStart <= lastNewline && (options.limit <= 0 || fresh.length < options.limit)) {
+		const newlineIndex = chunk.indexOf("\n", lineStart);
+		const line = chunk.slice(lineStart, newlineIndex);
+		consumedBytes += Buffer.byteLength(chunk.slice(lineStart, newlineIndex + 1), "utf8");
+		lineStart = newlineIndex + 1;
+		if (line.length === 0) continue;
+		let parsed;
+		try {
+			parsed = JSON.parse(line);
+		} catch {
+			continue;
+		}
+		if (options.maxAgeMs > 0 && typeof parsed.receivedAt === "number") {
+			if (now - parsed.receivedAt > options.maxAgeMs) continue;
 		}
 		fresh.push(line);
 	}
-	if (index !== cursor) node_fs.default.writeFileSync(cursorFilePath(dir), String(index));
+	const nextCursor = start + consumedBytes;
+	if (nextCursor !== cursor) writeGrabCursor(dir, nextCursor);
 	return fresh;
 };
 //#endregion
-//#region src/commands/read.ts
+//#region src/utils/read-args.ts
 const parseWaitMs = (raw) => {
-	if (!raw) return 0;
-	if (/^(inf|infinite|forever)$/i.test(raw.trim())) return Number.POSITIVE_INFINITY;
-	const ms = Number(raw);
-	return Number.isFinite(ms) && ms > 0 ? ms : 0;
+	if (raw === void 0) return 0;
+	const trimmed = raw.trim();
+	if (trimmed === "") return 0;
+	if (/^(inf|infinite|infinity|forever)$/i.test(trimmed)) return Number.POSITIVE_INFINITY;
+	const ms = Number(trimmed);
+	return Number.isFinite(ms) && ms >= 0 ? ms : null;
+};
+const parseNonNegativeInt = (raw) => {
+	if (raw === void 0) return null;
+	const trimmed = raw.trim();
+	if (trimmed === "") return null;
+	const value = Number(trimmed);
+	return Number.isInteger(value) && value >= 0 ? value : null;
 };
-const parseNonNegativeInt = (raw, fallback) => {
-	const value = Number(raw);
-	return Number.isInteger(value) && value >= 0 ? value : fallback;
+//#endregion
+//#region src/commands/pull.ts
+const fail = (message) => {
+	process.stderr.write(`react-grab pull: ${message}\n`);
+	process.exit(1);
+};
+const emitAndExit = (lines) => {
+	process.stdout.write(`${lines.join("\n")}\n`, () => process.exit(0));
 };
-const read = new commander.Command().name("read").description("print React Grab selections captured since the last read, then advance the cursor").option("-d, --dir <dir>", "work dir holding history.jsonl + cursor.txt", DEFAULT_WATCH_DIR).option("-w, --wait <ms>", "block up to <ms> (or 'infinite') for a new grab (default: no wait)").option("-n, --limit <count>", "max grabs to print per call (0 = no limit); the cursor only advances past what is printed", String(50)).option("--max-age <ms>", "skip grabs captured longer ago than <ms> (0 = never evict)", String(MAX_GRAB_AGE_MS)).option("--all", "print the entire history without advancing the cursor").action(async (options) => {
+const pull = new commander.Command().name("pull").description("start the watcher if needed, then wait for and print the next React Grab grab(s)").option("-d, --dir <dir>", "work dir for history.jsonl + watch.pid", DEFAULT_WATCH_DIR).option("-w, --wait <ms>", "how long to wait for a grab: ms, 'infinite', or 0 for none", "infinite").option("-n, --limit <count>", "max grabs to print per call (0 = no limit)", String(50)).option("--max-age <ms>", "skip grabs captured longer ago than <ms> (0 = never)", String(DEFAULT_GRAB_AGE_MS)).option("--text-only", "watcher uses the plain-text clipboard reader (ignored if already running)").option("--all", "print the whole history without advancing the cursor").action(async (options) => {
 	const dir = node_path.default.resolve(options.dir);
 	try {
 		prepareWorkDir(dir);
 	} catch (error) {
-		process.stderr.write(`react-grab read: ${String(error?.message ?? error)}\n`);
-		process.exit(1);
+		fail(String(error?.message ?? error));
 	}
-	unrefStdin();
-	const limit = parseNonNegativeInt(options.limit, 50);
-	const maxAgeMs = parseNonNegativeInt(options.maxAge, MAX_GRAB_AGE_MS);
-	const all = Boolean(options.all);
-	const drain = () => {
-		const fresh = consumeGrabs(dir, {
-			limit,
-			all,
-			maxAgeMs
-		});
-		if (fresh.length > 0) process.stdout.write(`${fresh.join("\n")}\n`);
-		return fresh.length;
-	};
 	const waitMs = parseWaitMs(options.wait);
-	const deadline = waitMs === Number.POSITIVE_INFINITY ? Number.POSITIVE_INFINITY : Date.now() + waitMs;
-	if (drain() > 0) process.exit(0);
+	if (waitMs === null) fail(`invalid --wait "${options.wait}" (use milliseconds or "infinite")`);
+	const limit = parseNonNegativeInt(options.limit);
+	if (limit === null) fail(`invalid --limit "${options.limit}" (use a non-negative integer)`);
+	const maxAgeMs = parseNonNegativeInt(options.maxAge);
+	if (maxAgeMs === null) fail(`invalid --max-age "${options.maxAge}" (use milliseconds, 0 to disable)`);
+	const all = Boolean(options.all);
+	if (ensureDaemon({
+		dir,
+		intervalMs: 800,
+		textOnly: Boolean(options.textOnly),
+		replayLast: false
+	}) === "no-reader") fail(NO_READER_MESSAGE);
+	unrefStdin();
+	const consume = () => consumeGrabs(dir, {
+		limit,
+		all,
+		maxAgeMs
+	});
+	const first = consume();
+	if (first.length > 0) {
+		emitAndExit(first);
+		return;
+	}
+	const deadline = Date.now() + waitMs;
 	while (Date.now() < deadline) {
 		await sleep(200);
-		if (drain() > 0) break;
+		const batch = consume();
+		if (batch.length > 0) {
+			emitAndExit(batch);
+			return;
+		}
 	}
 	process.exit(0);
 });
 //#endregion
 //#region src/commands/remove.ts
-const VERSION$2 = "0.1.41";
-const remove = new commander.Command().name("remove").description("uninstall the React Grab skill from your agent").action(async () => {
+const VERSION$2 = "0.1.42";
+const remove = new commander.Command().name("remove").description("uninstall the React Grab skill from your agent").option("-c, --cwd <cwd>", "working directory (defaults to current directory)", process.cwd()).option("-g, --global", "remove the globally-installed skill instead of the project's", false).action(async (opts) => {
 	console.log(`${picocolors.default.magenta("✿")} ${picocolors.default.bold("React Grab")} ${picocolors.default.gray(VERSION$2)}`);
 	console.log();
 	try {
 		logger.break();
-		const removedCount = await removeSkill();
+		const removedCount = await removeSkill({
+			cwd: (0, node_path.resolve)(opts.cwd),
+			global: opts.global
+		});
 		logger.break();
 		if (removedCount === 0) logger.log("React Grab skill is not installed in any detected agent.");
 		else logger.log(`${highlighter.success("Removed")} the React Grab skill from ${removedCount} agent${removedCount === 1 ? "" : "s"}.`);
@@ -2531,8 +2718,16 @@ const remove = new commander.Command().name("remove").description("uninstall the
 	}
 });
 //#endregion
+//#region src/commands/stop.ts
+const stop = new commander.Command().name("stop").description("stop the React Grab watcher for this dir").option("-d, --dir <dir>", "work dir holding watch.pid", DEFAULT_WATCH_DIR).action((options) => {
+	const dir = node_path.default.resolve(options.dir);
+	const stoppedPid = stopDaemon(dir);
+	process.stderr.write(stoppedPid ? `react-grab stop: stopped watcher (pid ${stoppedPid})\n` : `react-grab stop: no watcher running for ${dir}\n`);
+	process.exit(0);
+});
+//#endregion
 //#region src/commands/upgrade.ts
-const VERSION$1 = "0.1.41";
+const VERSION$1 = "0.1.42";
 const NPM_REGISTRY_URL = "https://registry.npmjs.org/react-grab/latest";
 const fetchLatestVersion = async () => {
 	try {
@@ -2606,95 +2801,24 @@ const upgrade = new commander.Command().name("upgrade").alias("update").descript
 	}
 });
 //#endregion
-//#region src/utils/daemon.ts
-const PID_FILE_NAME = "watch.pid";
-const pidFilePath = (dir) => node_path.default.join(dir, PID_FILE_NAME);
-const cliEntryPath = () => process.argv[1] ?? (0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href);
-const isProcessAlive = (pid) => {
-	if (!Number.isInteger(pid) || pid <= 0) return false;
-	try {
-		process.kill(pid, 0);
-		return true;
-	} catch (error) {
-		return error.code === "EPERM";
-	}
-};
-const readDaemonPid = (dir) => {
-	try {
-		const pid = Number.parseInt(node_fs.default.readFileSync(pidFilePath(dir), "utf8").trim(), 10);
-		return Number.isInteger(pid) && pid > 0 ? pid : null;
-	} catch {
-		return null;
-	}
-};
-const isDaemonRunning = (dir) => {
-	const pid = readDaemonPid(dir);
-	return pid !== null && isProcessAlive(pid);
-};
-const claimDaemon = (dir) => {
-	const file = pidFilePath(dir);
-	for (let attempt = 0; attempt < 50; attempt += 1) try {
-		const handle = node_fs.default.openSync(file, "wx");
-		node_fs.default.writeFileSync(handle, String(process.pid));
-		node_fs.default.closeSync(handle);
-		return readDaemonPid(dir) === process.pid;
-	} catch (error) {
-		if (error.code !== "EEXIST") throw error;
-		if (isDaemonRunning(dir)) return false;
-		try {
-			node_fs.default.rmSync(file, { force: true });
-		} catch {}
-	}
-	return false;
-};
-const releaseDaemon = (dir) => {
-	if (readDaemonPid(dir) === process.pid) try {
-		node_fs.default.rmSync(pidFilePath(dir), { force: true });
-	} catch {}
-};
-const stopDaemon = (dir) => {
-	const pid = readDaemonPid(dir);
-	if (pid === null) return null;
-	const wasAlive = isProcessAlive(pid);
-	if (wasAlive) try {
-		process.kill(pid, "SIGTERM");
-	} catch {}
-	if (readDaemonPid(dir) === pid) try {
-		node_fs.default.rmSync(pidFilePath(dir), { force: true });
-	} catch {}
-	return wasAlive ? pid : null;
-};
-const spawnDaemon = (options) => {
-	const args = [
-		cliEntryPath(),
-		"watch",
-		"--foreground",
-		"--dir",
-		options.dir,
-		"--interval",
-		String(options.intervalMs)
-	];
-	if (options.textOnly) args.push("--text-only");
-	if (options.replayLast) args.push("--replay-last");
-	(0, node_child_process.spawn)(process.execPath, args, {
-		detached: true,
-		stdio: "ignore",
-		windowsHide: true
-	}).unref();
-};
-//#endregion
 //#region src/commands/watch.ts
-const readersDir = () => node_path.default.dirname((0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href));
-const NO_READER_MESSAGE = "no clipboard reader available. Linux: install xclip or wl-clipboard. macOS: install Xcode CLI tools (swiftc) or rely on pbpaste. Windows: ensure PowerShell is on PATH.";
 const writeStatus = (message) => {
 	process.stderr.write(`react-grab watch: ${message}\n`);
 };
-const runForeground = (dir, intervalMs, textOnly, replayLast) => {
+const watch = new commander.Command().name("watch").description("run the React Grab capture daemon in the foreground (used internally by `pull`)").option("-d, --dir <dir>", "work dir for history.jsonl + watch.pid", DEFAULT_WATCH_DIR).option("-i, --interval <ms>", "clipboard poll interval in ms", String(800)).option("--text-only", "skip the native reader and use the plain-text fallback").option("--replay-last", "also capture the grab already on the clipboard at startup").action((options) => {
+	const dir = node_path.default.resolve(options.dir);
+	const intervalRaw = Number(options.interval);
+	const intervalMs = Number.isFinite(intervalRaw) && intervalRaw > 0 ? intervalRaw : 800;
+	try {
+		prepareWorkDir(dir);
+	} catch (error) {
+		writeStatus(String(error?.message ?? error));
+		process.exit(1);
+	}
 	if (!claimDaemon(dir)) process.exit(0);
 	process.on("exit", () => releaseDaemon(dir));
 	const reader = createReader({
-		textOnly,
-		readersDir: readersDir(),
+		textOnly: Boolean(options.textOnly),
 		workDir: dir
 	});
 	if (!reader) {
@@ -2706,58 +2830,16 @@ const runForeground = (dir, intervalMs, textOnly, replayLast) => {
 		reader,
 		dir,
 		intervalMs,
-		replayLast,
+		replayLast: Boolean(options.replayLast),
 		onWarn: writeStatus
 	}).catch((error) => {
 		writeStatus(String(error?.message ?? error));
 		process.exit(1);
 	});
-};
-const watch = new commander.Command().name("watch").description("start a background daemon that captures React Grab selections to history.jsonl").option("-d, --dir <dir>", "work dir for history.jsonl + watch.pid", DEFAULT_WATCH_DIR).option("-i, --interval <ms>", "clipboard poll interval in ms", String(800)).option("--text-only", "skip the native reader and use the plain-text fallback").option("--replay-last", "also capture the grab already on the clipboard at startup").option("--foreground", "run the capture loop in this process instead of detaching a daemon").option("--stop", "stop the daemon watching this dir").action((options) => {
-	const dir = node_path.default.resolve(options.dir);
-	const intervalRaw = Number(options.interval);
-	const intervalMs = Number.isFinite(intervalRaw) && intervalRaw > 0 ? intervalRaw : 800;
-	const textOnly = Boolean(options.textOnly);
-	const replayLast = Boolean(options.replayLast);
-	try {
-		prepareWorkDir(dir);
-	} catch (error) {
-		writeStatus(String(error?.message ?? error));
-		process.exit(1);
-	}
-	if (options.stop) {
-		const stoppedPid = stopDaemon(dir);
-		writeStatus(stoppedPid ? `stopped daemon (pid ${stoppedPid})` : `no daemon running for ${dir}`);
-		process.exit(0);
-	}
-	if (options.foreground) {
-		runForeground(dir, intervalMs, textOnly, replayLast);
-		return;
-	}
-	if (isDaemonRunning(dir)) {
-		writeStatus(`already watching ${dir} (pid ${readDaemonPid(dir)})`);
-		process.exit(0);
-	}
-	if (!createReader({
-		textOnly,
-		readersDir: readersDir(),
-		workDir: dir
-	})) {
-		writeStatus(NO_READER_MESSAGE);
-		process.exit(1);
-	}
-	spawnDaemon({
-		dir,
-		intervalMs,
-		textOnly,
-		replayLast
-	});
-	writeStatus(`started; capturing grabs → ${node_path.default.join(dir, HISTORY_FILE_NAME)} (run \`grab read\` to consume, \`grab watch --stop\` to stop)`);
-	process.exit(0);
 });
 //#endregion
 //#region src/cli.ts
-const VERSION = "0.1.41";
+const VERSION = "0.1.42";
 const VERSION_API_URL = "https://www.react-grab.com/api/version";
 process.on("SIGINT", () => process.exit(0));
 process.on("SIGTERM", () => process.exit(0));
@@ -2770,8 +2852,9 @@ program.addCommand(add);
 program.addCommand(remove);
 program.addCommand(configure);
 program.addCommand(upgrade);
-program.addCommand(watch);
-program.addCommand(read);
+program.addCommand(pull);
+program.addCommand(stop);
+program.addCommand(watch, { hidden: true });
 const main = async () => {
 	await program.parseAsync();
 };