stim 1.8.0 → 1.9.0

package/dist/{config-B7iyKWkL.mjs → config-Cp9lM3wX.mjs}

@@ -1,24 +1,33 @@
 import { n as __exportAll, r as __reExport } from "./rolldown-runtime-BsOwBuO_.mjs";
-import { t as getExecutor } from "./exec-B29XNuhP.mjs";
-import { join } from "node:path";
-import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, readlinkSync, renameSync, statSync, unlinkSync, writeFileSync } from "fs";
-import { homedir } from "os";
-import { dirname as dirname$1, isAbsolute as isAbsolute$1, join as join$1, normalize, parse as parse$1, sep as sep$1 } from "path";
+import { t as getExecutor } from "./exec-jIAlgilk.mjs";
+import { readFileSync } from "node:fs";
+import { InvalidArgumentError } from "commander";
+import { existsSync as existsSync$1, lstatSync as lstatSync$1, mkdirSync as mkdirSync$1, readdirSync as readdirSync$1, readlinkSync, renameSync as renameSync$1, statSync as statSync$1, unlinkSync as unlinkSync$1, writeFileSync as writeFileSync$1 } from "fs";
+import { dirname, isAbsolute, join, normalize, parse, sep } from "path";
 import { configDir, withDirLock } from "@stim-cli/core";
+import { join as join$1 } from "node:path";
 //#region src/devices/device-slots.ts
 const DEFAULT_DEVICE_SLOT = "default";
-function validateDeviceSlot(slot = "default") {
-	if (!/^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/.test(slot) || [
+const DEVICE_SLOT_RULE = "A device slot must be 1-64 letters, digits, underscores or hyphens, starting with a letter or digit.";
+function isDeviceSlot(slot) {
+	return /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/.test(slot) && ![
 		"constructor",
 		"prototype",
 		"__proto__"
-	].includes(slot)) {
-		const error = /* @__PURE__ */ new Error("A device slot must be 1-64 letters, digits, underscores or hyphens, starting with a letter or digit.");
+	].includes(slot);
+}
+function validateDeviceSlot(slot = "default") {
+	if (!isDeviceSlot(slot)) {
+		const error = /* @__PURE__ */ new Error(DEVICE_SLOT_RULE);
 		Object.assign(error, { code: "STIM_BAD_ARG" });
 		throw error;
 	}
 	return slot;
 }
+function parseDeviceSlotOption(slot) {
+	if (!isDeviceSlot(slot)) throw new InvalidArgumentError(DEVICE_SLOT_RULE);
+	return slot;
+}
 function deviceSlotPlatforms(project, slot = DEFAULT_DEVICE_SLOT) {
 	validateDeviceSlot(slot);
 	if (slot === DEFAULT_DEVICE_SLOT) return project?.platforms;
@@ -98,26 +107,26 @@ const WINDOWS = process.platform === "win32";
 const DRIVE_LETTERS = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
 function volumeRootFor(path) {
 	const normalized = normalize(String(path));
-	if (WINDOWS) return parse$1(normalized).root.replace(/^[a-z]:/, (drive) => drive.toUpperCase());
+	if (WINDOWS) return parse(normalized).root.replace(/^[a-z]:/, (drive) => drive.toUpperCase());
 	const m = normalized.match(/^\/volumes\/([^/]+)/i);
 	return m ? `/Volumes/${m[1]}` : "/";
 }
 function resolveWorkspaceRealish(workspacePath) {
 	const raw = String(workspacePath);
-	if (!isAbsolute$1(raw)) return null;
+	if (!isAbsolute(raw)) return null;
 	let current = raw;
 	const MAX_HOPS = 40;
 	for (let hops = 0; hops < MAX_HOPS; hops++) {
 		const normalized = normalize(current);
-		const root = parse$1(normalized).root;
-		const segments = normalized.slice(root.length).split(sep$1).filter(Boolean);
-		let prefix = root.endsWith(sep$1) ? root.slice(0, -sep$1.length) : root;
+		const root = parse(normalized).root;
+		const segments = normalized.slice(root.length).split(sep).filter(Boolean);
+		let prefix = root.endsWith(sep) ? root.slice(0, -sep.length) : root;
 		let followedSymlink = false;
 		for (const segment of segments) {
-			prefix += `${sep$1}${segment}`;
+			prefix += `${sep}${segment}`;
 			let st;
 			try {
-				st = lstatSync(prefix);
+				st = lstatSync$1(prefix);
 			} catch (err) {
 				if (err && err.code === "ENOENT") return normalized;
 				return null;
@@ -129,7 +138,7 @@ function resolveWorkspaceRealish(workspacePath) {
 				} catch {
 					return null;
 				}
-				current = `${isAbsolute$1(target) ? target : normalize(join$1(dirname$1(prefix), target))}${normalized.slice(prefix.length)}`;
+				current = `${isAbsolute(target) ? target : normalize(join(dirname(prefix), target))}${normalized.slice(prefix.length)}`;
 				followedSymlink = true;
 				break;
 			}
@@ -144,7 +153,7 @@ function isRealMount(entryDev, rootDev) {
 function listWindowsVolumeRoots(statFn) {
 	const roots = [];
 	for (const letter of DRIVE_LETTERS) {
-		const root = `${letter}:${sep$1}`;
+		const root = `${letter}:${sep}`;
 		try {
 			statFn(root);
 		} catch {
@@ -154,7 +163,7 @@ function listWindowsVolumeRoots(statFn) {
 	}
 	return roots;
 }
-function listMountedVolumes({ statFn = statSync } = {}) {
+function listMountedVolumes({ statFn = statSync$1 } = {}) {
 	if (WINDOWS) return listWindowsVolumeRoots(statFn);
 	const roots = ["/"];
 	let rootDev;
@@ -164,8 +173,8 @@ function listMountedVolumes({ statFn = statSync } = {}) {
 		return roots;
 	}
 	try {
-		for (const name of readdirSync("/Volumes")) {
-			const path = join$1("/Volumes", name);
+		for (const name of readdirSync$1("/Volumes")) {
+			const path = join("/Volumes", name);
 			let entryDev;
 			try {
 				entryDev = statFn(path).dev;
@@ -181,26 +190,29 @@ function resolveVolumeRoot(path) {
 	const realish = resolveWorkspaceRealish(path);
 	return realish === null ? null : volumeRootFor(realish);
 }
-function uncShareIsReachable(volume) {
-	if (!WINDOWS || !volume.startsWith(`${sep$1}${sep$1}`)) return false;
+function uncShareIsReachable(volume, statFn) {
+	if (!WINDOWS || !volume.startsWith(`${sep}${sep}`)) return false;
 	try {
-		return statSync(volume).isDirectory();
+		return statFn(volume).isDirectory();
 	} catch {
 		return false;
 	}
 }
-function isOnMountedVolume(path, mountedVolumes) {
+function isOnMountedVolume(path, mountedVolumes, { statFn = statSync$1 } = {}) {
 	const mounted = new Set(mountedVolumes || listMountedVolumes());
 	const volume = resolveVolumeRoot(path);
 	if (volume === null) return false;
-	return mounted.has(volume) || uncShareIsReachable(volume);
+	return mounted.has(volume) || uncShareIsReachable(volume, statFn);
 }
 function directorySize(dir, { timeoutMs } = {}) {
+	return measuredDirectorySize(dir, { timeoutMs }) ?? 0;
+}
+function measuredDirectorySize(dir, { timeoutMs } = {}) {
 	let out;
 	try {
 		out = getExecutor().runFile("du", ["-sk", dir], { timeoutMs });
 	} catch {
-		return 0;
+		return null;
 	}
 	if (!out) return 0;
 	const kb = parseInt(out.split(/\s+/)[0] ?? "", 10);
@@ -212,6 +224,22 @@ function formatBytes(bytes) {
 	return `${Math.round(bytes / 1024)}K`;
 }
 //#endregion
+//#region src/json-file.ts
+function readJsonFile(path) {
+	return JSON.parse(readFileSync(path, "utf-8"));
+}
+function isJsonObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readJsonObject(path) {
+	try {
+		const value = readJsonFile(path);
+		return isJsonObject(value) ? value : null;
+	} catch {
+		return null;
+	}
+}
+//#endregion
 //#region src/ownership-claim.ts
 var ownership_claim_exports = /* @__PURE__ */ __exportAll({});
 import * as import__stim_cli_core_ownership_claim from "@stim-cli/core/ownership-claim";
@@ -219,7 +247,7 @@ __reExport(ownership_claim_exports, import__stim_cli_core_ownership_claim);
 //#endregion
 //#region src/devices/avd-claim.ts
 function acquireAvdClaim(avdName) {
-	const root = join(configDir(), "avd-locks", `${encodeURIComponent(avdName.toLowerCase())}.lock`);
+	const root = join$1(configDir(), "avd-locks", `${encodeURIComponent(avdName.toLowerCase())}.lock`);
 	const label = `AVD ${avdName}`;
 	const attempt = (0, ownership_claim_exports.tryAcquireClaim)({
 		root,
@@ -243,18 +271,31 @@ __reExport(process_identity_exports, import__stim_cli_core_process_identity);
 //#endregion
 //#region src/workspace/config.ts
 function getConfigDir() {
-	return process.env.STIM_HOME || join$1(homedir(), ".stim");
+	return configDir();
+}
+function refuseRelativeStimPaths(env = process.env) {
+	for (const name of [
+		"STIM_HOME",
+		"STIM_BUILD_CACHE",
+		"STIM_METRO_CACHE"
+	]) {
+		const value = env[name];
+		if (!value || isAbsolute(value)) continue;
+		const error = /* @__PURE__ */ new Error(`${name}=${value} is not an absolute path. Set it to an absolute path, or unset it to use the default.`);
+		error.code = "STIM_RELATIVE_PATH";
+		throw error;
+	}
 }
 function getConfigPath() {
-	return join$1(getConfigDir(), "config.json");
+	return join(getConfigDir(), "config.json");
 }
 function ensureDir() {
 	const dir = getConfigDir();
-	if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+	if (!existsSync$1(dir)) mkdirSync$1(dir, { recursive: true });
 }
 const LOCK_DIR_NAME = "config.lock";
 function lockPath() {
-	return join$1(getConfigDir(), LOCK_DIR_NAME);
+	return join(getConfigDir(), LOCK_DIR_NAME);
 }
 function withConfigLock(fn) {
 	return withDirLock(lockPath(), fn, { ensureParent: ensureDir });
@@ -270,40 +311,50 @@ function configCorrupt(reason, path = getConfigPath()) {
 }
 function loadConfig() {
 	const p = getConfigPath();
-	if (!existsSync(p)) return null;
-	const raw = readFileSync(p, "utf-8");
+	if (!existsSync$1(p)) return null;
+	let parsed;
 	try {
-		return JSON.parse(raw);
+		parsed = readJsonFile(p);
 	} catch (err) {
+		if (!(err instanceof SyntaxError)) throw err;
 		throw configCorrupt(`is not valid JSON: ${err.message}`, p);
 	}
+	return configFromJson(parsed, p);
 }
-function isRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
+function configFromJson(value, path) {
+	if (!isJsonObject(value)) throw configCorrupt(`is not a JSON object: ${JSON.stringify(value)}`, path);
+	return {
+		...value,
+		projects: registryFromJson(value, "projects", path),
+		repos: registryFromJson(value, "repos", path)
+	};
 }
 /**
 * An array or scalar container swallows every write silently: `JSON.stringify` drops a string key set on
-* an array, so the record is gone by the time the file is written. Absent is created; unusable is refused.
+* an array, so the record is gone by the time the file is written. Absent or null is read as empty; an
+* unusable container or entry is refused.
 */
-function adoptContainer(cfg, key) {
-	const value = cfg[key];
-	if (value === void 0 || value === null) {
-		cfg[key] = {};
-		return true;
+function registryFromJson(config, key, path) {
+	const value = config[key];
+	if (value === void 0 || value === null) return {};
+	if (!isJsonObject(value)) throw configCorrupt(`has a ${key} that is not an object: ${JSON.stringify(value)}`, path);
+	const registry = {};
+	for (const [name, entry] of Object.entries(value)) {
+		if (!isJsonObject(entry)) throw configCorrupt(`has a ${key} entry ${JSON.stringify(name)} that is not an object: ${JSON.stringify(entry)}`, path);
+		registry[name] = entry;
 	}
-	if (!isRecord(value)) throw configCorrupt(`has a ${key} that is not an object: ${JSON.stringify(value)}`);
-	return false;
+	return registry;
 }
 function saveConfig(config) {
 	ensureDir();
 	const target = getConfigPath();
 	const tmp = `${target}.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`;
-	writeFileSync(tmp, JSON.stringify(config, null, 2) + "\n");
+	writeFileSync$1(tmp, JSON.stringify(config, null, 2) + "\n");
 	try {
-		renameSync(tmp, target);
+		renameSync$1(tmp, target);
 	} catch (err) {
 		try {
-			unlinkSync(tmp);
+			unlinkSync$1(tmp);
 		} catch {}
 		throw err;
 	}
@@ -313,14 +364,10 @@ function ensureConfig() {
 	return withConfigLock(() => {
 		const existing = loadConfig();
 		if (existing) {
-			let changed = false;
-			if (adoptContainer(existing, "projects")) changed = true;
-			if (adoptContainer(existing, "repos")) changed = true;
 			if (existing.version !== CONFIG_VERSION) {
 				existing.version = CONFIG_VERSION;
-				changed = true;
+				saveConfig(existing);
 			}
-			if (changed) saveConfig(existing);
 			return existing;
 		}
 		const fresh = {
@@ -336,7 +383,7 @@ function getProject(projectPath) {
 	return loadConfig()?.projects?.[projectPath] || null;
 }
 function requireAbsoluteProjectPath(projectPath) {
-	if (isAbsolute$1(projectPath)) return;
+	if (isAbsolute(projectPath)) return;
 	throw new Error(`Project key "${projectPath}" is not an absolute path. The registry is keyed by the realpath of a workspace root, so a relative key can never resolve.`);
 }
 function upsertProject(projectPath, fields) {
@@ -378,6 +425,15 @@ function claimMetroPort(projectPath, port) {
 		return port;
 	});
 }
+function releaseMetroPort(projectPath, port) {
+	withConfigLock(() => {
+		const cfg = loadConfig();
+		const project = cfg?.projects?.[projectPath];
+		if (!cfg || project?.metroPort !== port) return;
+		project.metroPort = null;
+		saveConfig(cfg);
+	});
+}
 function setDevice(projectPath, platform, deviceFields, slot = "default") {
 	requireAbsoluteProjectPath(projectPath);
 	withConfigLock(() => {
@@ -456,6 +512,80 @@ function getProjectSettings(projectPath) {
 function getRepoSettings(gitCommonDir) {
 	return loadConfig()?.repos?.[gitCommonDir]?.settings || {};
 }
+function targetSettings(cfg, target, create) {
+	if (target.scope === "machine") return cfg;
+	if (target.scope === "workspace") {
+		if (!cfg.projects[target.projectPath]) {
+			if (!create) return null;
+			cfg.projects[target.projectPath] = {
+				metroPort: null,
+				platforms: {}
+			};
+		}
+		const project = cfg.projects[target.projectPath];
+		if (!project.settings && create) project.settings = {};
+		return project.settings ?? null;
+	}
+	if (!cfg.repos[target.gitCommonDir]) {
+		if (!create) return null;
+		cfg.repos[target.gitCommonDir] = {};
+	}
+	const repo = cfg.repos[target.gitCommonDir];
+	if (!repo.settings && create) repo.settings = {};
+	return repo.settings ?? null;
+}
+function writeConfigSetting(target, dottedKey, value) {
+	if (target.scope === "workspace") requireAbsoluteProjectPath(target.projectPath);
+	return withConfigLock(() => {
+		const cfg = value === void 0 ? loadConfig() : ensureConfig();
+		const settings = cfg ? targetSettings(cfg, target, value !== void 0) : null;
+		if (!cfg || !settings) return false;
+		if (value === void 0) {
+			if (!deleteNested(settings, dottedKey)) return false;
+		} else writeNested(settings, dottedKey, value);
+		saveConfig(cfg);
+		return true;
+	});
+}
+function writeNested(obj, dottedKey, value) {
+	const keys = dottedKey.split(".");
+	let cur = obj;
+	for (let i = 0; i < keys.length - 1; i++) {
+		const k = keys[i];
+		if (k === void 0) continue;
+		const next = cur[k];
+		if (typeof next !== "object" || next === null) cur[k] = {};
+		cur = cur[k];
+	}
+	const leaf = keys[keys.length - 1];
+	if (leaf !== void 0) cur[leaf] = value;
+}
+function deleteNested(obj, dottedKey) {
+	const keys = dottedKey.split(".");
+	const chain = [obj];
+	let cur = obj;
+	for (let i = 0; i < keys.length - 1; i++) {
+		const k = keys[i];
+		if (k === void 0) return false;
+		const next = cur[k];
+		if (next == null || typeof next !== "object") return false;
+		cur = next;
+		chain.push(cur);
+	}
+	const leaf = keys[keys.length - 1];
+	if (leaf === void 0) return false;
+	if (!(leaf in cur)) return false;
+	delete cur[leaf];
+	for (let i = chain.length - 2; i >= 0; i--) {
+		const parent = chain[i];
+		const key = keys[i];
+		const child = chain[i + 1];
+		if (parent === void 0 || key === void 0 || child === void 0) break;
+		if (Object.keys(child).length === 0) delete parent[key];
+		else break;
+	}
+	return true;
+}
 function isPathPrefix(prefix, path) {
 	const head = comparablePath(prefix);
 	const candidate = comparablePath(path);
@@ -463,7 +593,7 @@ function isPathPrefix(prefix, path) {
 	return candidate.startsWith(head.endsWith("/") ? head : `${head}/`);
 }
 function comparablePath(path) {
-	return sep$1 === "/" ? path : path.replaceAll(sep$1, "/");
+	return sep === "/" ? path : path.replaceAll(sep, "/");
 }
 function findEnclosingWorktreeRoot(projectPath) {
 	const cfg = loadConfig();
@@ -489,7 +619,7 @@ function allConsolePortsAndSerials({ isMounted = isOnMountedVolume } = {}) {
 	};
 	if (!cfg) return result;
 	for (const [path, proj] of Object.entries(cfg.projects || {})) {
-		if (!existsSync(path) && isMounted(path)) continue;
+		if (!existsSync$1(path) && isMounted(path)) continue;
 		for (const { platforms } of projectDeviceSlots(proj)) {
 			const android = platforms.android;
 			if (typeof android?.consolePort === "number") result.androidConsolePorts.push(android.consolePort);
@@ -499,4 +629,4 @@ function allConsolePortsAndSerials({ isMounted = isOnMountedVolume } = {}) {
 	return result;
 }
 //#endregion
-export { isOnMountedVolume as A, validateDeviceSlot as B, withConfigLock as C, withDirLock as D, ownership_claim_exports as E, deviceSlotKey as F, deviceSlotPlatforms as I, parseDeviceSlotKey as L, volumeRootFor as M, assignSlotDevice as N, directorySize as O, deviceSlotFileKey as P, projectDeviceSlots as R, upsertProject as S, acquireAvdClaim as T, releaseAndroidConsolePort as _, clearSupervisor as a, setDevice as b, findEnclosingWorktreeRoot as c, getConfigPath as d, getProject as f, loadConfig as g, isPathPrefix as h, clearDevice as i, listMountedVolumes as j, formatBytes as k, getConcurrencyLimits as l, getRepoSettings as m, allMetroPorts as n, configCorruptRepair as o, getProjectSettings as p, claimMetroPort as r, ensureConfig as s, allConsolePortsAndSerials as t, getConfigDir as u, removeProject as v, process_identity_exports as w, setSupervisor as x, saveConfig as y, removeSlotDevice as z };
+export { withDirLock as A, assignSlotDevice as B, setSupervisor as C, process_identity_exports as D, writeConfigSetting as E, formatBytes as F, parseDeviceSlotOption as G, deviceSlotKey as H, isOnMountedVolume as I, validateDeviceSlot as J, projectDeviceSlots as K, listMountedVolumes as L, readJsonFile as M, readJsonObject as N, acquireAvdClaim as O, directorySize as P, measuredDirectorySize as R, setDevice as S, withConfigLock as T, deviceSlotPlatforms as U, deviceSlotFileKey as V, parseDeviceSlotKey as W, refuseRelativeStimPaths as _, clearSupervisor as a, removeProject as b, findEnclosingWorktreeRoot as c, getConfigPath as d, getProject as f, loadConfig as g, isPathPrefix as h, clearDevice as i, isJsonObject as j, ownership_claim_exports as k, getConcurrencyLimits as l, getRepoSettings as m, allMetroPorts as n, configCorruptRepair as o, getProjectSettings as p, removeSlotDevice as q, claimMetroPort as r, ensureConfig as s, allConsolePortsAndSerials as t, getConfigDir as u, releaseAndroidConsolePort as v, upsertProject as w, saveConfig as x, releaseMetroPort as y, volumeRootFor as z };

package/dist/{dependency-state-D0M7oKA7.mjs → dependency-state-Bq5DcLGn.mjs}

@@ -1,5 +1,5 @@
-import { t as getExecutor } from "./exec-B29XNuhP.mjs";
-import { g as repoRoot } from "./worktree-FG_ZKKdb.mjs";
+import { t as getExecutor } from "./exec-jIAlgilk.mjs";
+import { _ as repoRoot } from "./worktree-R_cUlE7s.mjs";
 import { existsSync } from "node:fs";
 import { dirname, join, relative } from "node:path";
 //#region src/dependency-state.ts

package/dist/{deps-oCXVNEqQ.mjs → deps-Cip5vUm1.mjs}

@@ -1,11 +1,13 @@
-import { t as getExecutor } from "./exec-B29XNuhP.mjs";
-import { n as stripAnsi, r as waitForChild, t as createLineReader } from "./process-output-Dl5uKE03.mjs";
-import { d as startBuildHeartbeat, m as bundlerPin, n as HEARTBEAT_INTERVAL_MS } from "./xcode-B6YaWeg0.mjs";
+import { t as getExecutor } from "./exec-jIAlgilk.mjs";
+import { n as stripAnsi, r as waitForChild, t as createLineReader } from "./process-output-Fpl8PYi8.mjs";
+import { n as spawnDeclared } from "./spawn-claims-Dn3C_N6w.mjs";
+import { d as startBuildHeartbeat, m as bundlerPin, n as HEARTBEAT_INTERVAL_MS } from "./xcode-BZqyxh3e.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import { delimiter, dirname, join, relative, resolve, sep } from "node:path";
 import { homedir } from "node:os";
 //#region src/engine/deps.ts
 const DEPS_ERROR = "STIM_DEPS_FAILED";
+const TRANSCRIPT_LINES = 2e3;
 const MAX_POD_DIAGNOSTIC_LINES = 15;
 const POD_MARKER = /^\[!\]/;
 const POD_CONTINUATION = /^\s+\S/;
@@ -182,6 +184,7 @@ async function runCaptured(ctx) {
 		const msg = stripAnsi(String(line)).trimEnd();
 		if (!msg.trim()) return;
 		transcript.push(msg);
+		if (transcript.length > TRANSCRIPT_LINES) transcript.splice(TRANSCRIPT_LINES / 2, 1);
 		ctx.logWriter?.write?.({
 			src: "build",
 			level: "debug",
@@ -192,7 +195,7 @@ async function runCaptured(ctx) {
 	};
 	let child;
 	try {
-		child = ctx.spawn(ctx.cmd, ctx.args, {
+		child = spawnDeclared(() => ctx.spawn(ctx.cmd, ctx.args, {
 			cwd: ctx.cwd,
 			stdio: [
 				"ignore",
@@ -200,7 +203,7 @@ async function runCaptured(ctx) {
 				"pipe"
 			],
 			env: ctx.env
-		});
+		}));
 	} catch (error) {
 		return {
 			transcript,

package/dist/{detached-entry-Bpo6ZY_I.mjs → detached-entry-KEu0_AXL.mjs}

@@ -1,4 +1,4 @@
-import { t as getExecutor } from "./exec-B29XNuhP.mjs";
+import { t as getExecutor } from "./exec-jIAlgilk.mjs";
 import { openSync } from "node:fs";
 //#region src/detached-entry.ts
 const LOG_FILE_FLAG = "--log-file";