repo-dive 0.16.3 → 0.16.4

package/dist/cli.js

@@ -11,7 +11,7 @@ import path, * as Path from "node:path";
 import { DatabaseSync } from "node:sqlite";
 import * as NodeUrl from "node:url";
 import { fileURLToPath, pathToFileURL } from "node:url";
-import { access, mkdir, mkdtemp, readFile, readdir, rm, writeFile } from "node:fs/promises";
+import { access, mkdir, mkdtemp, readFile, readdir, rename, rm, writeFile } from "node:fs/promises";
 import * as readline from "node:readline";
 import { registerHooks } from "node:module";
 //#region node_modules/.pnpm/effect@4.0.0/node_modules/effect/dist/Pipeable.js
@@ -8720,6 +8720,8 @@ var AsyncFiberError = class extends (/*#__PURE__*/ TaggedError$2("AsyncFiberErro
 /** @internal */
 var UnknownErrorTypeId = "~effect/Cause/UnknownError";
 /** @internal */
+var isUnknownError$1 = (u) => hasProperty(u, UnknownErrorTypeId);
+/** @internal */
 var UnknownError$2 = class extends (/*#__PURE__*/ TaggedError$2("UnknownError")) {
 	[UnknownErrorTypeId] = UnknownErrorTypeId;
 	constructor(cause, message) {
@@ -11188,6 +11190,22 @@ var IllegalArgumentError = IllegalArgumentError$1;
 */
 var ExceededCapacityError = ExceededCapacityError$1;
 /**
+* Checks whether an arbitrary value is an `UnknownError`.
+*
+* **Example** (Checking the runtime type)
+*
+* ```ts import.meta.vitest
+* import { Cause } from "effect"
+*
+* Cause.isUnknownError(new Cause.UnknownError("x")) // => true
+* Cause.isUnknownError("nope") // => false
+* ```
+*
+* @category guards
+* @since 4.0.0
+*/
+var isUnknownError = isUnknownError$1;
+/**
 * Constructs an `UnknownError`. The first argument is the original
 * cause (stored in `Error.cause`); the second is an optional human-readable
 * message.
@@ -26041,7 +26059,7 @@ var concatTokens = (prevTokens, nextTokens, isSeparated) => isSeparated || prevT
 	...nextTokens.slice(1)
 ];
 //#endregion
-//#region node_modules/.pnpm/@effect+platform-node-shared@4.0.2_effect@4.0.0/node_modules/@effect/platform-node-shared/dist/internal/nodeChildProcessSpawner.js
+//#region node_modules/.pnpm/@effect+platform-node-shared@4.0.3_effect@4.0.0/node_modules/@effect/platform-node-shared/dist/internal/nodeChildProcessSpawner.js
 var buildSpawnOptions = (options, base, platform) => {
 	const detached = options.detached ?? platform !== "win32";
 	return {
@@ -26052,7 +26070,7 @@ var buildSpawnOptions = (options, base, platform) => {
 	};
 };
 //#endregion
-//#region node_modules/.pnpm/@effect+platform-node-shared@4.0.2_effect@4.0.0/node_modules/@effect/platform-node-shared/dist/internal/utils.js
+//#region node_modules/.pnpm/@effect+platform-node-shared@4.0.3_effect@4.0.0/node_modules/@effect/platform-node-shared/dist/internal/utils.js
 /** @internal */
 var handleErrnoException = (module, method) => (err, [path]) => {
 	let reason = "Unknown";
@@ -26087,7 +26105,7 @@ var handleErrnoException = (module, method) => (err, [path]) => {
 	});
 };
 //#endregion
-//#region node_modules/.pnpm/@effect+platform-node-shared@4.0.2_effect@4.0.0/node_modules/@effect/platform-node-shared/dist/NodeSink.js
+//#region node_modules/.pnpm/@effect+platform-node-shared@4.0.3_effect@4.0.0/node_modules/@effect/platform-node-shared/dist/NodeSink.js
 /**
 * Creates a `Sink` that writes chunks to a Node writable stream, respecting
 * backpressure, mapping writable errors with `onError`, and ending the stream
@@ -26170,7 +26188,7 @@ var pullIntoWritable = (options) => options.pull.pipe(flatMap$1((chunk) => {
 	});
 })));
 //#endregion
-//#region node_modules/.pnpm/@effect+platform-node-shared@4.0.2_effect@4.0.0/node_modules/@effect/platform-node-shared/dist/NodeStream.js
+//#region node_modules/.pnpm/@effect+platform-node-shared@4.0.3_effect@4.0.0/node_modules/@effect/platform-node-shared/dist/NodeStream.js
 /**
 * Adapters between Node streams and Effect streams, channels, and readables.
 *
@@ -26253,7 +26271,7 @@ var readableToPullUnsafe = (options) => {
 };
 var defaultOnError = (error) => new UnknownError$1(error);
 //#endregion
-//#region node_modules/.pnpm/@effect+platform-node-shared@4.0.2_effect@4.0.0/node_modules/@effect/platform-node-shared/dist/NodeChildProcessSpawner.js
+//#region node_modules/.pnpm/@effect+platform-node-shared@4.0.3_effect@4.0.0/node_modules/@effect/platform-node-shared/dist/NodeChildProcessSpawner.js
 var toError = (error) => error instanceof globalThis.Error ? error : new globalThis.Error(String(error));
 var toPlatformError = (method, error, command) => {
 	const { commands } = flattenCommand(command);
@@ -34500,7 +34518,7 @@ var validateSize = (method, size) => Number.isSafeInteger(size) && size >= 0 ? s
 	description: "size must be a non-negative safe integer"
 }));
 //#endregion
-//#region node_modules/.pnpm/@effect+platform-node-shared@4.0.2_effect@4.0.0/node_modules/@effect/platform-node-shared/dist/NodeCrypto.js
+//#region node_modules/.pnpm/@effect+platform-node-shared@4.0.3_effect@4.0.0/node_modules/@effect/platform-node-shared/dist/NodeCrypto.js
 /**
 * Node-compatible implementation of Effect's `Crypto` service.
 *
@@ -34556,7 +34574,7 @@ var layer$10 = /* @__PURE__ */ succeed$5(Crypto, /* @__PURE__ */ make$12({
 	digest
 }));
 //#endregion
-//#region node_modules/.pnpm/@effect+platform-node-shared@4.0.2_effect@4.0.0/node_modules/@effect/platform-node-shared/dist/NodeFileSystem.js
+//#region node_modules/.pnpm/@effect+platform-node-shared@4.0.3_effect@4.0.0/node_modules/@effect/platform-node-shared/dist/NodeFileSystem.js
 /**
 * Shared Node-compatible implementation of Effect's `FileSystem` service.
 *
@@ -34653,12 +34671,41 @@ var makeTempDirectoryScoped = /*#__PURE__*/ (() => {
 	const removeDirectory = /*#__PURE__*/ removeFactory("makeTempDirectoryScoped");
 	return (options) => acquireRelease(makeDirectory(options), (directory) => orDie(removeDirectory(directory, { recursive: true })));
 })();
+var openFlagBits = (flag) => {
+	const { O_APPEND, O_CREAT, O_EXCL, O_RDONLY, O_RDWR, O_TRUNC, O_WRONLY } = NFS.constants;
+	switch (flag) {
+		case "r": return O_RDONLY;
+		case "r+": return O_RDWR;
+		case "w": return O_TRUNC | O_CREAT | O_WRONLY;
+		case "wx": return O_TRUNC | O_CREAT | O_WRONLY | O_EXCL;
+		case "w+": return O_TRUNC | O_CREAT | O_RDWR;
+		case "wx+": return O_TRUNC | O_CREAT | O_RDWR | O_EXCL;
+		case "a": return O_APPEND | O_CREAT | O_WRONLY;
+		case "ax": return O_APPEND | O_CREAT | O_WRONLY | O_EXCL;
+		case "a+": return O_APPEND | O_CREAT | O_RDWR;
+		case "ax+": return O_APPEND | O_CREAT | O_RDWR | O_EXCL;
+	}
+};
+var noFollowFlags = (method, flag) => suspend$2(() => {
+	const { O_NOFOLLOW } = NFS.constants;
+	if (process.platform === "win32" || typeof O_NOFOLLOW !== "number" || O_NOFOLLOW === 0) return fail$3(badArgument({
+		module: "FileSystem",
+		method,
+		description: "noFollow is not supported on this platform"
+	}));
+	return succeed$4(openFlagBits(flag) | O_NOFOLLOW);
+});
 var openFactory = (method) => {
 	const nodeOpen = effectify(NFS.open, handleErrnoException("FileSystem", method), handleBadArgument(method));
 	const nodeClose = effectify(NFS.close, handleErrnoException("FileSystem", method), handleBadArgument(method));
-	return (path, options) => pipe(acquireRelease(nodeOpen(path, options?.flag ?? "r", options?.mode), (fd) => orDie(nodeClose(fd))), map$6((fd) => makeFile(fd, options?.flag?.startsWith("a") ?? false)));
+	return (path, options) => pipe(acquireRelease(options?.noFollow === true ? flatMap$1(noFollowFlags(method, options.flag ?? "r"), (flags) => nodeOpen(path, flags, options.mode)) : nodeOpen(path, options?.flag ?? "r", options?.mode), (fd) => orDie(nodeClose(fd))), map$6((fd) => makeFile(fd, options?.flag?.startsWith("a") ?? false)));
 };
 var open = /*#__PURE__*/ openFactory("open");
+var negativePosition = (method) => badArgument({
+	module: "FileSystem",
+	method,
+	description: "Cannot read before the start of the file"
+});
 var makeFile = /*#__PURE__*/ (() => {
 	const nodeReadFactory = (method) => effectify(NFS.read, handleErrnoException("FileSystem", method), handleBadArgument(method));
 	const nodeRead = /*#__PURE__*/ nodeReadFactory("read");
@@ -34697,8 +34744,13 @@ var makeFile = /*#__PURE__*/ (() => {
 				return succeed$4(position);
 			});
 		}
-		read(buffer) {
+		read(buffer, options) {
 			return suspend$2(() => {
+				const explicit = options?.position;
+				if (explicit !== void 0) return explicit < BigInt(0) ? fail$3(negativePosition("read")) : nodeRead(this.fd, {
+					buffer,
+					position: explicit
+				});
 				const position = this.position;
 				return map$6(nodeRead(this.fd, {
 					buffer,
@@ -34709,18 +34761,20 @@ var makeFile = /*#__PURE__*/ (() => {
 				});
 			});
 		}
-		readAlloc(size) {
+		readAlloc(size, options) {
 			return suspend$2(() => {
 				try {
 					if (!Number.isInteger(size) || size < 0) throw new RangeError("size must be a non-negative integer");
+					const explicit = options?.position;
+					if (explicit !== void 0 && explicit < BigInt(0)) return fail$3(negativePosition("readAlloc"));
 					const buffer = Buffer.allocUnsafeSlow(size);
-					const position = this.position;
+					const position = explicit ?? this.position;
 					return map$6(nodeReadAlloc(this.fd, {
 						buffer,
 						position
 					}), (bytesRead) => {
 						if (bytesRead === 0) return none();
-						this.position = position + BigInt(bytesRead);
+						if (explicit === void 0) this.position = position + BigInt(bytesRead);
 						if (bytesRead === size) return some(buffer);
 						const dst = Buffer.allocUnsafeSlow(bytesRead);
 						buffer.copy(dst, 0, 0, bytesRead);
@@ -34808,7 +34862,7 @@ var realPath = /*#__PURE__*/ (() => {
 	const nodeRealPath = /*#__PURE__*/ effectify(NFS.realpath, /*#__PURE__*/ handleErrnoException("FileSystem", "realPath"), /*#__PURE__*/ handleBadArgument("realPath"));
 	return (path) => nodeRealPath(path);
 })();
-var rename = /*#__PURE__*/ (() => {
+var rename$1 = /*#__PURE__*/ (() => {
 	const nodeRename = /*#__PURE__*/ effectify(NFS.rename, /*#__PURE__*/ handleErrnoException("FileSystem", "rename"), /*#__PURE__*/ handleBadArgument("rename"));
 	return (oldPath, newPath) => nodeRename(oldPath, newPath);
 })();
@@ -34920,7 +34974,7 @@ var makeFileSystem = /*#__PURE__*/ map$6(/*#__PURE__*/ serviceOption(WatchBacken
 	readLink,
 	realPath,
 	remove,
-	rename,
+	rename: rename$1,
 	stat,
 	symlink,
 	truncate,
@@ -34950,7 +35004,7 @@ var makeFileSystem = /*#__PURE__*/ map$6(/*#__PURE__*/ serviceOption(WatchBacken
 */
 var layer$8 = /* @__PURE__ */ effect(FileSystem)(makeFileSystem);
 //#endregion
-//#region node_modules/.pnpm/@effect+platform-node-shared@4.0.2_effect@4.0.0/node_modules/@effect/platform-node-shared/dist/NodePath.js
+//#region node_modules/.pnpm/@effect+platform-node-shared@4.0.3_effect@4.0.0/node_modules/@effect/platform-node-shared/dist/NodePath.js
 /**
 * Node-backed provider for Effect's `Path` service.
 *
@@ -35035,6 +35089,7 @@ var layer$4 = /* @__PURE__ */ succeed$5(Stdio, /*#__PURE__*/ make$15({
 	args: /*#__PURE__*/ sync(() => process.argv.slice(2)),
 	stdinIsTerminal: /*#__PURE__*/ sync(() => process.stdin.isTTY === true),
 	stdoutIsTerminal: /*#__PURE__*/ sync(() => process.stdout.isTTY === true),
+	stderrIsTerminal: /*#__PURE__*/ sync(() => process.stderr.isTTY === true),
 	stdout: (options) => fromWritable({
 		evaluate: () => process.stdout,
 		onError: (cause) => systemError({
@@ -35147,7 +35202,7 @@ var make$10 = (impl) => Terminal.of({
 });
 /**
 * Provides the default process-backed `Terminal` service, ending key input on
-* Ctrl+C or Ctrl+D.
+* bare Esc, Ctrl+C, or Ctrl+D.
 *
 * @stability unstable
 * @category layers
@@ -35252,7 +35307,8 @@ var layer$3 = /*#__PURE__*/ effect(Terminal, /*#__PURE__*/ (/* @__PURE__ */ fnUn
 	});
 }))(defaultShouldQuit));
 function defaultShouldQuit(input) {
-	return input.key.ctrl && (input.key.name === "c" || input.key.name === "d");
+	const key = input.key;
+	return key.name === "escape" || key.ctrl && (key.name === "c" || key.name === "d");
 }
 //#endregion
 //#region node_modules/.pnpm/@effect+platform-node@4.0.0_effect@4.0.0_redis@6.3.0/node_modules/@effect/platform-node/dist/NodeServices.js
@@ -42749,7 +42805,7 @@ var runWith = (command, config) => {
 };
 var package_default = {
 	name: "repo-dive",
-	version: "0.16.3",
+	version: "0.16.4",
 	description: "Dive into a git repo's history: per-commit snapshots, an indexed metrics catalog and an interactive dashboard",
 	keywords: [
 		"git",
@@ -42819,7 +42875,7 @@ var package_default = {
 	prettier: "@kachkaev/prettier-config",
 	devDependencies: {
 		"@babel/core": "8.0.7",
-		"@base-ui/react": "1.8.0",
+		"@base-ui/react": "1.9.0",
 		"@changesets/changelog-github": "1.0.1",
 		"@changesets/cli": "3.0.3",
 		"@changesets/config": "4.0.1",
@@ -42851,7 +42907,7 @@ var package_default = {
 		"eslint": "10.12.0",
 		"eslint-plugin-react-hooks": "7.1.1",
 		"husky": "9.1.7",
-		"knip": "6.39.0",
+		"knip": "6.41.0",
 		"lint-staged": "17.6.0",
 		"lucide-react": "1.52.0",
 		"markdownlint-cli": "0.49.1",
@@ -50656,14 +50712,42 @@ var CatalogFormatError = class extends TaggedError$1("CatalogFormatError") {
 		return `Catalog at ${this.rootPath} has format version ${String(this.formatVersion)}, but this version of repo-dive expects ${catalogFormatVersion}. Delete the folder to re-collect from scratch.`;
 	}
 };
-var writeJson = (filePath, value) => tryPromise(() => writeFile(filePath, `${JSON.stringify(value, void 0, 2)}\n`, "utf8"));
-var readJsonIfExists = (filePath) => tryPromise(async () => {
+/**
+* Writes beside the target, then renames over it. A scan cut short (Ctrl+C, a
+* CI step timeout) or a copy of the catalog taken mid-scan (a CI cache save)
+* then sees either the previous file or the complete new one, never a
+* truncated one. A temporary file a cut-short write leaves behind is reused by
+* the next write of the same file.
+*/
+var writeJson = (filePath, value) => tryPromise(async () => {
+	const temporaryPath = `${filePath}.tmp`;
+	await writeFile(temporaryPath, `${JSON.stringify(value, void 0, 2)}\n`, "utf8");
+	await rename(temporaryPath, filePath);
+});
+var readTextIfExists = async (filePath) => {
 	try {
-		return JSON.parse(await readFile(filePath, "utf8"));
+		return await readFile(filePath, "utf8");
 	} catch (error) {
 		if (error instanceof Error && "code" in error && error.code === "ENOENT") return;
 		throw error;
 	}
+};
+var readJsonIfExists = (filePath) => tryPromise(async () => {
+	const raw = await readTextIfExists(filePath);
+	return raw === void 0 ? void 0 : JSON.parse(raw);
+});
+/**
+* Like {@link readJsonIfExists}, but a file that does not parse reads as
+* missing too. Catalogs written before writes became atomic can hold
+* truncated files, and failing on one would fail every scan from then on.
+*/
+var readJsonIfIntact = (filePath) => tryPromise(async () => {
+	const raw = await readTextIfExists(filePath);
+	try {
+		return raw === void 0 ? void 0 : JSON.parse(raw);
+	} catch {
+		return;
+	}
 });
 var cacheKeyOf = (sidecar) => typeof sidecar === "object" && sidecar !== null && "cacheKey" in sidecar ? sidecar.cacheKey : void 0;
 var formatVersionOf = (manifest) => typeof manifest === "object" && manifest !== null && "formatVersion" in manifest ? manifest.formatVersion : void 0;
@@ -50720,8 +50804,11 @@ var openCatalog = fn("openCatalog")(function* ({ repoRoot, catalogPath }) {
 	};
 });
 var collectorDir = (catalog, sha, collectorName) => path.join(catalog.rootPath, "commits", sha, collectorName);
-/** Reads the cache fingerprint recorded in a collector's sidecar, if any. */
-var readCollectorCacheKey = (catalog, sha, collectorName) => readJsonIfExists(path.join(collectorDir(catalog, sha, collectorName), "collector.json")).pipe(map$6(cacheKeyOf));
+/**
+* Reads the cache fingerprint recorded in a collector's sidecar, if any. A
+* truncated sidecar has none, so the commit is collected afresh.
+*/
+var readCollectorCacheKey = (catalog, sha, collectorName) => readJsonIfIntact(path.join(collectorDir(catalog, sha, collectorName), "collector.json")).pipe(map$6(cacheKeyOf));
 /**
 * A (commit, collector) pair is done when a sidecar recording the current cache
 * fingerprint exists. `cacheKey` folds in the collector version and any config
@@ -51322,6 +51409,11 @@ var summarizeCommits = (commits) => {
 		lastCommitDate: dates.at(-1)
 	};
 };
+/**
+* A scan's remaining time at the precision an estimate deserves: seconds only
+* while under a minute, whole minutes from then on (`~1m`, not `~1m 52s`).
+*/
+var formatTimeLeft = (seconds) => seconds < 60 ? `${seconds}s` : `${Math.floor(seconds / 60)}m`;
 var runCollector = ({ catalog, sha, collector, cacheKey, worktreePath }) => collector.collect({
 	repoRoot: catalog.repoRoot,
 	catalogPath: catalog.rootPath,
@@ -51442,9 +51534,7 @@ var runScan = fn("runScan")(function* ({ repoPath, collectorNames, maxCommits, s
 		const elapsedSeconds = (now - startedAt) / 1e3;
 		const rate = processed / Math.max(1, elapsedSeconds);
 		const remainingSeconds = Math.round((selected.length - processed) / Math.max(.01, rate));
-		const minutes = Math.floor(remainingSeconds / 60);
-		const seconds = remainingSeconds % 60;
-		return `${Math.round(rate)}/s, ~${minutes > 0 ? `${minutes}m ` : ""}${seconds}s left`;
+		return `${Math.round(rate)}/s, ~${formatTimeLeft(remainingSeconds)} left`;
 	};
 	const processedRef = yield* make$31(0);
 	const outcomes = yield* forEach$1(selected, (commit) => collectCommit({
@@ -52321,6 +52411,7 @@ var runIndex = fn("runIndex")(function* ({ repoPath }) {
 		const factsByCollector = /* @__PURE__ */ new Map();
 		let unknownCollectorDirs = 0;
 		let offMainlineSnapshots = 0;
+		let incompleteOutputs = 0;
 		for (const collectorName of await readdir(commitDir)) {
 			const collector = registry.get(collectorName);
 			if (!collector) {
@@ -52331,7 +52422,16 @@ var runIndex = fn("runIndex")(function* ({ repoPath }) {
 				offMainlineSnapshots += 1;
 				continue;
 			}
-			const raw = JSON.parse(await readFile(path.join(commitDir, collectorName, "output.json"), "utf8"));
+			let raw;
+			try {
+				raw = JSON.parse(await readFile(path.join(commitDir, collectorName, "output.json"), "utf8"));
+			} catch (error) {
+				if (error instanceof SyntaxError || error instanceof Error && "code" in error && error.code === "ENOENT") {
+					incompleteOutputs += 1;
+					continue;
+				}
+				throw error;
+			}
 			factsByCollector.set(collectorName, collector.normalize(raw));
 		}
 		return {
@@ -52344,12 +52444,14 @@ var runIndex = fn("runIndex")(function* ({ repoPath }) {
 				factsByCollector
 			},
 			unknownCollectorDirs,
-			offMainlineSnapshots
+			offMainlineSnapshots,
+			incompleteOutputs
 		};
 	}), { concurrency: 16 });
 	const commitFacts = readOutcomes.map((outcome) => outcome.facts);
 	const unknownCollectorDirs = readOutcomes.reduce((total, outcome) => total + outcome.unknownCollectorDirs, 0);
 	const offMainlineSnapshots = readOutcomes.reduce((total, outcome) => total + outcome.offMainlineSnapshots, 0);
+	const incompleteOutputs = readOutcomes.reduce((total, outcome) => total + outcome.incompleteOutputs, 0);
 	const indexDir = path.join(catalogPath, "index");
 	yield* tryPromise(() => mkdir(indexDir, { recursive: true }));
 	const dbPath = path.join(indexDir, "metrics.sqlite");
@@ -52363,7 +52465,8 @@ var runIndex = fn("runIndex")(function* ({ repoPath }) {
 		`Cube: ${dbPath}`,
 		`Dashboard data: ${dashboardPath}`,
 		...unknownCollectorDirs > 0 ? [`Skipped ${unknownCollectorDirs} outputs from unknown collectors (see \`gc --stale\`).`] : [],
-		...offMainlineSnapshots > 0 ? [`Skipped ${offMainlineSnapshots} tree snapshots taken off the lineages.`] : []
+		...offMainlineSnapshots > 0 ? [`Skipped ${offMainlineSnapshots} tree snapshots taken off the lineages.`] : [],
+		...incompleteOutputs > 0 ? [`Skipped ${incompleteOutputs} incomplete outputs left by an interrupted scan.`] : []
 	].join("\n"));
 	yield* warnAboutIgnoreFiles({
 		repoRoot,
@@ -59635,5 +59738,14 @@ var cli = make$8("repo-dive", {
 var ReportedCliFailure = class extends TaggedError$1("ReportedCliFailure") {
 	[errorReported] = false;
 };
-run(cli, { version: package_default.version }).pipe(catchIf((error) => !isCliError(error), (error$1) => error(error$1 instanceof Error ? error$1.message : String(error$1)).pipe(andThen(fail$3(new ReportedCliFailure())))), provide(layer$1), runMain);
+/**
+* The one line a domain failure prints as. `Effect.try` / `Effect.tryPromise`
+* failures only say "An error occurred in Effect.tryPromise", so the error
+* they wrap is what tells the user what went wrong.
+*/
+var describeFailure = (error) => {
+	if (!(error instanceof Error)) return String(error);
+	return isUnknownError(error) && error.cause instanceof Error ? `${error.message}: ${error.cause.message}` : error.message;
+};
+run(cli, { version: package_default.version }).pipe(catchIf((error) => !isCliError(error), (error$1) => error(describeFailure(error$1)).pipe(andThen(fail$3(new ReportedCliFailure())))), provide(layer$1), runMain);
 //#endregion