@tamagui/native-ci 2.7.7 → 3.0.0-beta.637.1

package/dist/cli.mjs

@@ -1,15 +1,16 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
 import { generateFingerprint, generatePreFingerprintHash } from "./fingerprint.mjs";
-import { createCacheKey, saveFingerprintToKV, getFingerprintFromKV, saveCache, loadCache } from "./cache.mjs";
-import { setGitHubOutput, isGitHubActions, isCI } from "./runner.mjs";
-import { ensureIosDeps, ensureAndroidDeps, ensureMaestro, printDepsStatus } from "./deps.mjs";
+import { createCacheKey, getFingerprintFromKV, loadCache, saveCache, saveFingerprintToKV } from "./cache.mjs";
+import { isCI, isGitHubActions, setGitHubOutput } from "./runner.mjs";
+import { ensureAndroidDeps, ensureIosDeps, ensureMaestro, printDepsStatus } from "./deps.mjs";
 import { withMetro } from "./metro.mjs";
 import { runDetoxTests } from "./detox.mjs";
-import { ensureIOSFolder, ensureIOSApp, ensureBootedSimulator, ensureAppInstalled, getBootedSimulatorUDID, getMaestroBundleId } from "./ios";
-import { setupAndroidDevice, ensureAndroidFolder } from "./android";
+import { ensureAppInstalled, ensureBootedSimulator, ensureIOSApp, ensureIOSFolder, getBootedSimulatorUDID, getMaestroBundleId } from "./ios-utils.mjs";
+import { ensureAndroidFolder, setupAndroidDevice } from "./android-utils.mjs";
 import { chmodSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
+
 const HELP = `
 native-ci - Native CI/CD helpers for Expo apps
 
@@ -63,9 +64,9 @@ EXAMPLES:
   native-ci fingerprint-test
 `;
 function createMaestroXcrunShim() {
-  const binDir = mkdtempSync(join(tmpdir(), "native-ci-maestro-"));
-  const xcrunPath = join(binDir, "xcrun");
-  writeFileSync(xcrunPath, `#!/bin/sh
+	const binDir = mkdtempSync(join(tmpdir(), "native-ci-maestro-"));
+	const xcrunPath = join(binDir, "xcrun");
+	writeFileSync(xcrunPath, `#!/bin/sh
 if [ "$1" = "devicectl" ] && [ "$2" = "--json-output" ] && [ "$4" = "list" ] && [ "$5" = "devices" ]; then
   printf '{"result":{"devices":[]}}\\n' > "$3"
   exit 0
@@ -73,327 +74,307 @@ fi
 
 exec /usr/bin/xcrun "$@"
 `);
-  chmodSync(xcrunPath, 493);
-  return binDir;
+	chmodSync(xcrunPath, 493);
+	return binDir;
 }
 function parseArgs(argv) {
-  const args2 = [];
-  const options2 = {
-    projectRoot: process.cwd(),
-    config: "",
-    recordLogs: "all",
-    retries: 0,
-    headless: false,
-    prefix: "native-build",
-    githubOutput: false,
-    json: false,
-    help: false
-  };
-  let i = 0;
-  while (i < argv.length) {
-    const arg = argv[i];
-    if (arg === "--project-root" && argv[i + 1]) {
-      options2.projectRoot = argv[++i];
-    } else if (arg === "--config" && argv[i + 1]) {
-      options2.config = argv[++i];
-    } else if (arg === "--record-logs" && argv[i + 1]) {
-      options2.recordLogs = argv[++i];
-    } else if (arg === "--retries" && argv[i + 1]) {
-      const val = Number.parseInt(argv[++i], 10);
-      if (!Number.isNaN(val) && val >= 0) {
-        options2.retries = val;
-      }
-    } else if (arg === "--prefix" && argv[i + 1]) {
-      options2.prefix = argv[++i];
-    } else if (arg === "--github-output") {
-      options2.githubOutput = true;
-    } else if (arg === "--json") {
-      options2.json = true;
-    } else if (arg === "--help" || arg === "-h") {
-      options2.help = true;
-    } else if (!arg.startsWith("-")) {
-      args2.push(arg);
-    }
-    i++;
-  }
-  return {
-    command: args2[0] || "",
-    subcommand: args2[1] || "",
-    args: args2.slice(2),
-    options: options2
-  };
+	const args2 = [];
+	const options2 = {
+		projectRoot: process.cwd(),
+		config: "",
+		recordLogs: "all",
+		retries: 0,
+		headless: false,
+		prefix: "native-build",
+		githubOutput: false,
+		json: false,
+		help: false
+	};
+	let i = 0;
+	while (i < argv.length) {
+		const arg = argv[i];
+		if (arg === "--project-root" && argv[i + 1]) {
+			options2.projectRoot = argv[++i];
+		} else if (arg === "--config" && argv[i + 1]) {
+			options2.config = argv[++i];
+		} else if (arg === "--record-logs" && argv[i + 1]) {
+			options2.recordLogs = argv[++i];
+		} else if (arg === "--retries" && argv[i + 1]) {
+			const val = Number.parseInt(argv[++i], 10);
+			if (!Number.isNaN(val) && val >= 0) {
+				options2.retries = val;
+			}
+		} else if (arg === "--prefix" && argv[i + 1]) {
+			options2.prefix = argv[++i];
+		} else if (arg === "--github-output") {
+			options2.githubOutput = true;
+		} else if (arg === "--json") {
+			options2.json = true;
+		} else if (arg === "--help" || arg === "-h") {
+			options2.help = true;
+		} else if (!arg.startsWith("-")) {
+			args2.push(arg);
+		}
+		i++;
+	}
+	return {
+		command: args2[0] || "",
+		subcommand: args2[1] || "",
+		args: args2.slice(2),
+		options: options2
+	};
 }
 function validatePlatform(value) {
-  if (value !== "ios" && value !== "android") {
-    console.error('Error: platform must be "ios" or "android"');
-    process.exit(1);
-  }
-  return value;
+	if (value !== "ios" && value !== "android") {
+		console.error("Error: platform must be \"ios\" or \"android\"");
+		process.exit(1);
+	}
+	return value;
 }
 function getKVCredentials() {
-  const url = process.env.KV_STORE_REDIS_REST_URL;
-  const token = process.env.KV_STORE_REDIS_REST_TOKEN;
-  if (!url || !token) {
-    console.error("Error: KV_STORE_REDIS_REST_URL and KV_STORE_REDIS_REST_TOKEN required");
-    process.exit(1);
-  }
-  return {
-    url,
-    token
-  };
+	const url = process.env.KV_STORE_REDIS_REST_URL;
+	const token = process.env.KV_STORE_REDIS_REST_TOKEN;
+	if (!url || !token) {
+		console.error("Error: KV_STORE_REDIS_REST_URL and KV_STORE_REDIS_REST_TOKEN required");
+		process.exit(1);
+	}
+	return {
+		url,
+		token
+	};
 }
-const {
-  command,
-  subcommand,
-  args,
-  options
-} = parseArgs(process.argv.slice(2));
+const { command, subcommand, args, options } = parseArgs(process.argv.slice(2));
 if (options.help || !command) {
-  console.info(HELP);
-  process.exit(options.help ? 0 : 1);
+	console.info(HELP);
+	process.exit(options.help ? 0 : 1);
 }
 try {
-  switch (command) {
-    // ========================================
-    // Test Commands
-    // ========================================
-    case "test":
-      {
-        if (isCI() && !process.env.NATIVE_CI_FORCE_RUN) {
-          console.info("Skipping native tests in CI (handled by separate workflow)");
-          console.info("Set NATIVE_CI_FORCE_RUN=1 to force run");
-          process.exit(0);
-        }
-        const platform = subcommand || "ios";
-        if (platform === "ios") {
-          ensureBootedSimulator();
-          await ensureIosDeps();
-          const config = options.config || "ios.sim.debug";
-          console.info("=== iOS Detox Test Runner ===");
-          console.info(`Config: ${config}`);
-          console.info(`Project root: ${options.projectRoot}`);
-          process.chdir(options.projectRoot);
-          await ensureIOSFolder();
-          await ensureIOSApp(config);
-          const exitCode = await withMetro("ios", async () => {
-            return runDetoxTests({
-              config,
-              projectRoot: options.projectRoot,
-              recordLogs: options.recordLogs,
-              retries: options.retries,
-              testFiles: args.length > 0 ? args : void 0
-            });
-          });
-          process.exit(exitCode);
-        } else if (platform === "android") {
-          await ensureAndroidDeps();
-          const config = options.config || "android.emu.debug";
-          console.info("=== Android Detox Test Runner ===");
-          console.info(`Config: ${config}`);
-          console.info(`Project root: ${options.projectRoot}`);
-          console.info(`Headless: ${options.headless}`);
-          process.chdir(options.projectRoot);
-          await ensureAndroidFolder();
-          await setupAndroidDevice();
-          const exitCode = await withMetro("android", async () => {
-            return runDetoxTests({
-              config,
-              projectRoot: options.projectRoot,
-              recordLogs: options.recordLogs,
-              retries: options.retries,
-              headless: options.headless,
-              testFiles: args.length > 0 ? args : void 0
-            });
-          });
-          process.exit(exitCode);
-        } else if (platform === "maestro") {
-          ensureBootedSimulator();
-          await ensureMaestro();
-          const flow = args[0] || "";
-          console.info("=== Maestro Test Runner ===");
-          console.info(`Flow: ${flow || "all"}`);
-          console.info(`Project root: ${options.projectRoot}`);
-          process.chdir(options.projectRoot);
-          const udid = getBootedSimulatorUDID();
-          const bundleId = getMaestroBundleId(options.projectRoot);
-          await ensureAppInstalled({
-            projectRoot: options.projectRoot,
-            bundleId,
-            udid
-          });
-          const exitCode = await withMetro("ios", async () => {
-            const {
-              $
-            } = await import("bun");
-            const flowArg = flow ? `./flows/${flow}` : "./flows";
-            const udidArgs = ["--udid", udid];
-            const debugDir = `${options.projectRoot}/.maestro-debug`;
-            const xcrunShimDir = createMaestroXcrunShim();
-            const previousPath = process.env.PATH;
-            try {
-              process.env.PATH = `${xcrunShimDir}:${previousPath ?? ""}`;
-              const result = await $`maestro test ${flowArg} --exclude-tags=util --no-ansi --debug-output=${debugDir} ${udidArgs}`.nothrow();
-              return result.exitCode;
-            } finally {
-              if (previousPath === void 0) {
-                delete process.env.PATH;
-              } else {
-                process.env.PATH = previousPath;
-              }
-              rmSync(xcrunShimDir, {
-                recursive: true,
-                force: true
-              });
-            }
-          });
-          process.exit(exitCode);
-        } else if (platform === "all") {
-          ensureBootedSimulator();
-          console.info("=== Running All Native Tests ===\n");
-          await ensureIosDeps();
-          console.info("\n--- iOS Tests ---\n");
-          process.chdir(options.projectRoot);
-          await ensureIOSFolder();
-          await ensureIOSApp(options.config || "ios.sim.debug");
-          let iosExit = 0;
-          try {
-            iosExit = await withMetro("ios", async () => {
-              return runDetoxTests({
-                config: options.config || "ios.sim.debug",
-                projectRoot: options.projectRoot,
-                recordLogs: options.recordLogs,
-                retries: options.retries
-              });
-            });
-          } catch (err) {
-            console.error("iOS tests failed:", err);
-            iosExit = 1;
-          }
-          await ensureAndroidDeps();
-          console.info("\n--- Android Tests ---\n");
-          await ensureAndroidFolder();
-          await setupAndroidDevice();
-          let androidExit = 0;
-          try {
-            androidExit = await withMetro("android", async () => {
-              return runDetoxTests({
-                config: options.config || "android.emu.debug",
-                projectRoot: options.projectRoot,
-                recordLogs: options.recordLogs,
-                retries: options.retries,
-                headless: options.headless
-              });
-            });
-          } catch (err) {
-            console.error("Android tests failed:", err);
-            androidExit = 1;
-          }
-          const success = iosExit === 0 && androidExit === 0;
-          console.info(`
+	switch (command) {
+		case "test": {
+			if (isCI() && !process.env.NATIVE_CI_FORCE_RUN) {
+				console.info("Skipping native tests in CI (handled by separate workflow)");
+				console.info("Set NATIVE_CI_FORCE_RUN=1 to force run");
+				process.exit(0);
+			}
+			const platform = subcommand || "ios";
+			if (platform === "ios") {
+				ensureBootedSimulator();
+				await ensureIosDeps();
+				const config = options.config || "ios.sim.debug";
+				console.info("=== iOS Detox Test Runner ===");
+				console.info(`Config: ${config}`);
+				console.info(`Project root: ${options.projectRoot}`);
+				process.chdir(options.projectRoot);
+				await ensureIOSFolder();
+				await ensureIOSApp(config);
+				const exitCode = await withMetro("ios", async () => {
+					return runDetoxTests({
+						config,
+						projectRoot: options.projectRoot,
+						recordLogs: options.recordLogs,
+						retries: options.retries,
+						testFiles: args.length > 0 ? args : void 0
+					});
+				});
+				process.exit(exitCode);
+			} else if (platform === "android") {
+				await ensureAndroidDeps();
+				const config = options.config || "android.emu.debug";
+				console.info("=== Android Detox Test Runner ===");
+				console.info(`Config: ${config}`);
+				console.info(`Project root: ${options.projectRoot}`);
+				console.info(`Headless: ${options.headless}`);
+				process.chdir(options.projectRoot);
+				await ensureAndroidFolder();
+				await setupAndroidDevice();
+				const exitCode = await withMetro("android", async () => {
+					return runDetoxTests({
+						config,
+						projectRoot: options.projectRoot,
+						recordLogs: options.recordLogs,
+						retries: options.retries,
+						headless: options.headless,
+						testFiles: args.length > 0 ? args : void 0
+					});
+				});
+				process.exit(exitCode);
+			} else if (platform === "maestro") {
+				ensureBootedSimulator();
+				await ensureMaestro();
+				const flow = args[0] || "";
+				console.info("=== Maestro Test Runner ===");
+				console.info(`Flow: ${flow || "all"}`);
+				console.info(`Project root: ${options.projectRoot}`);
+				process.chdir(options.projectRoot);
+				const udid = getBootedSimulatorUDID();
+				const bundleId = getMaestroBundleId(options.projectRoot);
+				await ensureAppInstalled({
+					projectRoot: options.projectRoot,
+					bundleId,
+					udid
+				});
+				const exitCode = await withMetro("ios", async () => {
+					const { $ } = await import("bun");
+					const flowArg = flow ? `./flows/${flow}` : "./flows";
+					const udidArgs = ["--udid", udid];
+					const debugDir = `${options.projectRoot}/.maestro-debug`;
+					const xcrunShimDir = createMaestroXcrunShim();
+					const previousPath = process.env.PATH;
+					try {
+						process.env.PATH = `${xcrunShimDir}:${previousPath ?? ""}`;
+						const result = await $`maestro test ${flowArg} --exclude-tags=util --no-ansi --debug-output=${debugDir} ${udidArgs}`.nothrow();
+						return result.exitCode;
+					} finally {
+						if (previousPath === void 0) {
+							delete process.env.PATH;
+						} else {
+							process.env.PATH = previousPath;
+						}
+						rmSync(xcrunShimDir, {
+							recursive: true,
+							force: true
+						});
+					}
+				});
+				process.exit(exitCode);
+			} else if (platform === "all") {
+				ensureBootedSimulator();
+				console.info("=== Running All Native Tests ===\n");
+				await ensureIosDeps();
+				console.info("\n--- iOS Tests ---\n");
+				process.chdir(options.projectRoot);
+				await ensureIOSFolder();
+				await ensureIOSApp(options.config || "ios.sim.debug");
+				let iosExit = 0;
+				try {
+					iosExit = await withMetro("ios", async () => {
+						return runDetoxTests({
+							config: options.config || "ios.sim.debug",
+							projectRoot: options.projectRoot,
+							recordLogs: options.recordLogs,
+							retries: options.retries
+						});
+					});
+				} catch (err) {
+					console.error("iOS tests failed:", err);
+					iosExit = 1;
+				}
+				await ensureAndroidDeps();
+				console.info("\n--- Android Tests ---\n");
+				await ensureAndroidFolder();
+				await setupAndroidDevice();
+				let androidExit = 0;
+				try {
+					androidExit = await withMetro("android", async () => {
+						return runDetoxTests({
+							config: options.config || "android.emu.debug",
+							projectRoot: options.projectRoot,
+							recordLogs: options.recordLogs,
+							retries: options.retries,
+							headless: options.headless
+						});
+					});
+				} catch (err) {
+					console.error("Android tests failed:", err);
+					androidExit = 1;
+				}
+				const success = iosExit === 0 && androidExit === 0;
+				console.info(`
 === Test Results ===`);
-          console.info(`iOS: ${iosExit === 0 ? "PASSED" : "FAILED"}`);
-          console.info(`Android: ${androidExit === 0 ? "PASSED" : "FAILED"}`);
-          process.exit(success ? 0 : 1);
-        } else {
-          console.error(`Unknown test platform: ${platform}`);
-          console.info("Usage: native-ci test [ios|android|maestro|all]");
-          process.exit(1);
-        }
-        break;
-      }
-    // ========================================
-    // Dependency Commands
-    // ========================================
-    case "deps":
-      {
-        if (!subcommand || subcommand === "status") {
-          printDepsStatus();
-        } else if (subcommand === "install") {
-          console.info("Installing all dependencies...\n");
-          await ensureIosDeps();
-          await ensureMaestro();
-          console.info("\nAll dependencies installed!");
-        } else if (subcommand === "install-ios") {
-          await ensureIosDeps();
-        } else if (subcommand === "install-android") {
-          await ensureAndroidDeps();
-        } else if (subcommand === "install-maestro") {
-          await ensureMaestro();
-        } else {
-          console.error(`Unknown deps subcommand: ${subcommand}`);
-          process.exit(1);
-        }
-        break;
-      }
-    // ========================================
-    // Fingerprint Commands
-    // ========================================
-    case "fingerprint":
-      {
-        const platform = validatePlatform(subcommand);
-        const result = await generateFingerprint({
-          platform,
-          projectRoot: options.projectRoot
-        });
-        if (options.githubOutput || isGitHubActions()) {
-          setGitHubOutput("fingerprint", result.hash);
-          setGitHubOutput("cache-key", createCacheKey({
-            platform,
-            fingerprint: result.hash,
-            prefix: options.prefix
-          }));
-        }
-        if (options.json) {
-          console.info(JSON.stringify(result, null, 2));
-        } else {
-          console.info(result.hash);
-        }
-        break;
-      }
-    case "fingerprint-test":
-      {
-        const CACHE_FILE = ".fingerprint-cache.json";
-        console.info("Generating fingerprints...\n");
-        const iosResult = await generateFingerprint({
-          platform: "ios",
-          projectRoot: options.projectRoot
-        });
-        const androidResult = await generateFingerprint({
-          platform: "android",
-          projectRoot: options.projectRoot
-        });
-        const iosFingerprint = iosResult.hash;
-        const androidFingerprint = androidResult.hash;
-        console.info("Current fingerprints:");
-        console.info(`  iOS:     ${iosFingerprint}`);
-        console.info(`  Android: ${androidFingerprint}`);
-        console.info("");
-        const cache = loadCache(CACHE_FILE);
-        if (cache?.ios && cache?.android) {
-          console.info("Previous fingerprints (from cache):");
-          console.info(`  iOS:     ${cache.ios}`);
-          console.info(`  Android: ${cache.android}`);
-          console.info("");
-          const iosChanged = cache.ios !== iosFingerprint;
-          const androidChanged = cache.android !== androidFingerprint;
-          if (iosChanged || androidChanged) {
-            console.info("Fingerprints changed!");
-            if (iosChanged) console.info("   - iOS fingerprint changed (would trigger iOS rebuild)");
-            if (androidChanged) console.info("   - Android fingerprint changed (would trigger Android rebuild)");
-          } else {
-            console.info("Fingerprints match - no rebuild needed");
-          }
-        } else {
-          console.info("No previous fingerprints cached.");
-        }
-        saveCache(CACHE_FILE, {
-          ios: iosFingerprint,
-          android: androidFingerprint,
-          timestamp: (/* @__PURE__ */new Date()).toISOString()
-        });
-        console.info(`
+				console.info(`iOS: ${iosExit === 0 ? "PASSED" : "FAILED"}`);
+				console.info(`Android: ${androidExit === 0 ? "PASSED" : "FAILED"}`);
+				process.exit(success ? 0 : 1);
+			} else {
+				console.error(`Unknown test platform: ${platform}`);
+				console.info("Usage: native-ci test [ios|android|maestro|all]");
+				process.exit(1);
+			}
+			break;
+		}
+		case "deps": {
+			if (!subcommand || subcommand === "status") {
+				printDepsStatus();
+			} else if (subcommand === "install") {
+				console.info("Installing all dependencies...\n");
+				await ensureIosDeps();
+				await ensureMaestro();
+				console.info("\nAll dependencies installed!");
+			} else if (subcommand === "install-ios") {
+				await ensureIosDeps();
+			} else if (subcommand === "install-android") {
+				await ensureAndroidDeps();
+			} else if (subcommand === "install-maestro") {
+				await ensureMaestro();
+			} else {
+				console.error(`Unknown deps subcommand: ${subcommand}`);
+				process.exit(1);
+			}
+			break;
+		}
+		case "fingerprint": {
+			const platform = validatePlatform(subcommand);
+			const result = await generateFingerprint({
+				platform,
+				projectRoot: options.projectRoot
+			});
+			if (options.githubOutput || isGitHubActions()) {
+				setGitHubOutput("fingerprint", result.hash);
+				setGitHubOutput("cache-key", createCacheKey({
+					platform,
+					fingerprint: result.hash,
+					prefix: options.prefix
+				}));
+			}
+			if (options.json) {
+				console.info(JSON.stringify(result, null, 2));
+			} else {
+				console.info(result.hash);
+			}
+			break;
+		}
+		case "fingerprint-test": {
+			const CACHE_FILE = ".fingerprint-cache.json";
+			console.info("Generating fingerprints...\n");
+			const iosResult = await generateFingerprint({
+				platform: "ios",
+				projectRoot: options.projectRoot
+			});
+			const androidResult = await generateFingerprint({
+				platform: "android",
+				projectRoot: options.projectRoot
+			});
+			const iosFingerprint = iosResult.hash;
+			const androidFingerprint = androidResult.hash;
+			console.info("Current fingerprints:");
+			console.info(`  iOS:     ${iosFingerprint}`);
+			console.info(`  Android: ${androidFingerprint}`);
+			console.info("");
+			const cache = loadCache(CACHE_FILE);
+			if (cache?.ios && cache?.android) {
+				console.info("Previous fingerprints (from cache):");
+				console.info(`  iOS:     ${cache.ios}`);
+				console.info(`  Android: ${cache.android}`);
+				console.info("");
+				const iosChanged = cache.ios !== iosFingerprint;
+				const androidChanged = cache.android !== androidFingerprint;
+				if (iosChanged || androidChanged) {
+					console.info("Fingerprints changed!");
+					if (iosChanged) console.info("   - iOS fingerprint changed (would trigger iOS rebuild)");
+					if (androidChanged) console.info("   - Android fingerprint changed (would trigger Android rebuild)");
+				} else {
+					console.info("Fingerprints match - no rebuild needed");
+				}
+			} else {
+				console.info("No previous fingerprints cached.");
+			}
+			saveCache(CACHE_FILE, {
+				ios: iosFingerprint,
+				android: androidFingerprint,
+				timestamp: (/* @__PURE__ */ new Date()).toISOString()
+			});
+			console.info(`
 Saved fingerprints to ${CACHE_FILE}`);
-        console.info(`
+			console.info(`
 To test cache invalidation:
   1. Add a native dependency:    yarn add react-native-mmkv
   2. Run this script again:      native-ci fingerprint-test
@@ -401,91 +382,85 @@ To test cache invalidation:
   4. Remove the dependency:      yarn remove react-native-mmkv
   5. Run this script again - fingerprints should match original
 `);
-        break;
-      }
-    case "pre-hash":
-      {
-        const files = [subcommand, ...args].filter(Boolean);
-        if (files.length === 0) {
-          console.error("Error: at least one file required");
-          process.exit(1);
-        }
-        const hash = generatePreFingerprintHash(files, options.projectRoot);
-        if (options.githubOutput || isGitHubActions()) {
-          setGitHubOutput("pre-fingerprint-hash", hash);
-        }
-        if (options.json) {
-          console.info(JSON.stringify({
-            hash,
-            files
-          }, null, 2));
-        } else {
-          console.info(hash);
-        }
-        break;
-      }
-    case "cache-key":
-      {
-        const platform = validatePlatform(subcommand);
-        const fingerprint = args[0];
-        if (!fingerprint) {
-          console.error("Error: fingerprint is required");
-          process.exit(1);
-        }
-        const cacheKey = createCacheKey({
-          platform,
-          fingerprint,
-          prefix: options.prefix
-        });
-        if (options.githubOutput || isGitHubActions()) {
-          setGitHubOutput("cache-key", cacheKey);
-        }
-        console.info(cacheKey);
-        break;
-      }
-    // ========================================
-    // KV Store Commands
-    // ========================================
-    case "kv-get":
-      {
-        const key = subcommand;
-        if (!key) {
-          console.error("Error: key is required");
-          process.exit(1);
-        }
-        const kv = getKVCredentials();
-        const value = await getFingerprintFromKV(kv, key);
-        if (options.githubOutput || isGitHubActions()) {
-          setGitHubOutput("value", value || "");
-          setGitHubOutput("found", value ? "true" : "false");
-        }
-        if (value) {
-          console.info(value);
-        } else {
-          process.exit(1);
-        }
-        break;
-      }
-    case "kv-set":
-      {
-        const key = subcommand;
-        const value = args[0];
-        if (!key || !value) {
-          console.error("Error: key and value are required");
-          process.exit(1);
-        }
-        const kv = getKVCredentials();
-        await saveFingerprintToKV(kv, key, value);
-        console.info("OK");
-        break;
-      }
-    default:
-      console.error(`Unknown command: ${command}`);
-      console.info(HELP);
-      process.exit(1);
-  }
+			break;
+		}
+		case "pre-hash": {
+			const files = [subcommand, ...args].filter(Boolean);
+			if (files.length === 0) {
+				console.error("Error: at least one file required");
+				process.exit(1);
+			}
+			const hash = generatePreFingerprintHash(files, options.projectRoot);
+			if (options.githubOutput || isGitHubActions()) {
+				setGitHubOutput("pre-fingerprint-hash", hash);
+			}
+			if (options.json) {
+				console.info(JSON.stringify({
+					hash,
+					files
+				}, null, 2));
+			} else {
+				console.info(hash);
+			}
+			break;
+		}
+		case "cache-key": {
+			const platform = validatePlatform(subcommand);
+			const fingerprint = args[0];
+			if (!fingerprint) {
+				console.error("Error: fingerprint is required");
+				process.exit(1);
+			}
+			const cacheKey = createCacheKey({
+				platform,
+				fingerprint,
+				prefix: options.prefix
+			});
+			if (options.githubOutput || isGitHubActions()) {
+				setGitHubOutput("cache-key", cacheKey);
+			}
+			console.info(cacheKey);
+			break;
+		}
+		case "kv-get": {
+			const key = subcommand;
+			if (!key) {
+				console.error("Error: key is required");
+				process.exit(1);
+			}
+			const kv = getKVCredentials();
+			const value = await getFingerprintFromKV(kv, key);
+			if (options.githubOutput || isGitHubActions()) {
+				setGitHubOutput("value", value || "");
+				setGitHubOutput("found", value ? "true" : "false");
+			}
+			if (value) {
+				console.info(value);
+			} else {
+				process.exit(1);
+			}
+			break;
+		}
+		case "kv-set": {
+			const key = subcommand;
+			const value = args[0];
+			if (!key || !value) {
+				console.error("Error: key and value are required");
+				process.exit(1);
+			}
+			const kv = getKVCredentials();
+			await saveFingerprintToKV(kv, key, value);
+			console.info("OK");
+			break;
+		}
+		default:
+			console.error(`Unknown command: ${command}`);
+			console.info(HELP);
+			process.exit(1);
+	}
 } catch (error) {
-  console.error("Error:", error.message);
-  process.exit(1);
+	console.error("Error:", error.message);
+	process.exit(1);
 }
+
 //# sourceMappingURL=cli.mjs.map