codemod 1.7.6 → 1.7.7

package/README.md

@@ -30,32 +30,37 @@ Whether you're an individual developer tackling tech debt, an OSS maintainer shi
 ## Installation
 
 ```bash
-npm install -g codemod@latest
+npm install -g codemod
 ```
 
 Or use via `npx` without installation:
 
 ```bash
-npx codemod@latest <command>
+npx codemod
 ```
 
+In an interactive terminal, bare `npx codemod` opens a launcher and refreshes to the latest published CLI before showing the prompt. In non-interactive contexts, it prints next steps and exits with status `1`.
+
 ## Quick Start
 
 ```bash
-# 1. Create a codemod package
+# 1. Start with the launcher or scaffold directly
+npx codemod
+
+# 2. Create a codemod package
 npx codemod init my-codemod
 cd my-codemod
 
 # You can create codemod packages with the help of AI using Codemod MCP or Studio
 
-# 2. Run it locally
+# 3. Run it locally
 npx codemod workflow run -w ./example-codemod -t /abs/path/to/repo
 
-# 3. Publish to registry
+# 4. Publish to registry
 npx codemod login
 npx codemod publish
 
-# 4. Run from registry
+# 5. Run from registry
 npx codemod @your-org/example-codemod
 ```
 

package/codemod

@@ -5,6 +5,7 @@ const fs = require("fs");
 const path = require("path");
 
 const binaryName = process.platform === "win32" ? "codemod.exe" : "codemod";
+const CODEMOD_BOOTSTRAPPED_ENV = "CODEMOD_BOOTSTRAPPED";
 
 function detectPackageName() {
   const { platform, arch } = process;
@@ -93,8 +94,6 @@ function resolveBinaryPath() {
     }
   }
 
-  console.log("pkgName", pkgName);
-
   const releaseCandidate = path.join(
     __dirname,
     "..",
@@ -125,43 +124,121 @@ function resolveBinaryPath() {
   failToLocateBinary(pkgName, moduleError);
 }
 
-const { binaryPath } = resolveBinaryPath();
+function npmExecutable(platform = process.platform) {
+  return platform === "win32" ? "npm.cmd" : "npm";
+}
 
-const child = spawn(binaryPath, process.argv.slice(2), {
-  stdio: "inherit",
-});
+function latestBootstrapArgs() {
+  return [
+    "exec",
+    "--yes",
+    "--prefer-online",
+    "--package",
+    "codemod@latest",
+    "--",
+    "codemod",
+  ];
+}
 
-child.on("error", (error) => {
-  console.error("Failed to execute codemod binary.");
-  console.error(error);
-  process.exit(1);
-});
+function shouldBootstrapLatestNoCommand(argv, env = process.env) {
+  return argv.length === 0 && !env[CODEMOD_BOOTSTRAPPED_ENV];
+}
 
-const signals = ["SIGINT", "SIGTERM", "SIGHUP"];
+function spawnLatestCli({ env = process.env, platform = process.platform, spawnImpl = spawn }) {
+  return spawnImpl(npmExecutable(platform), latestBootstrapArgs(), {
+    stdio: "inherit",
+    env: {
+      ...env,
+      [CODEMOD_BOOTSTRAPPED_ENV]: "1",
+    },
+  });
+}
 
-const forwarders = signals.map((signal) => {
-  const handler = () => {
-    if (child.killed) {
-      return;
-    }
-    try {
-      child.kill(signal);
-    } catch (_) {
-      // Ignore
-    }
-  };
-  process.on(signal, handler);
-  return { signal, handler };
-});
-
-child.on("exit", (code, signal) => {
-  forwarders.forEach(({ signal, handler }) => {
-    process.removeListener(signal, handler);
+function spawnResolvedBinary({
+  argv,
+  spawnImpl = spawn,
+  resolveBinaryPathImpl = resolveBinaryPath,
+}) {
+  const { binaryPath } = resolveBinaryPathImpl();
+  return spawnImpl(binaryPath, argv, {
+    stdio: "inherit",
   });
+}
 
-  if (signal) {
-    process.kill(process.pid, signal);
-  } else {
-    process.exit(code == null ? 1 : code);
+function run({
+  argv = process.argv.slice(2),
+  env = process.env,
+  platform = process.platform,
+  spawnImpl = spawn,
+  resolveBinaryPathImpl = resolveBinaryPath,
+} = {}) {
+  if (shouldBootstrapLatestNoCommand(argv, env)) {
+    return spawnLatestCli({ env, platform, spawnImpl });
   }
-});
+
+  return spawnResolvedBinary({ argv, spawnImpl, resolveBinaryPathImpl });
+}
+
+function attachChildLifecycle(
+  child,
+  {
+    signalSource = process,
+    processObject = process,
+    logger = console.error,
+  } = {},
+) {
+  child.on("error", (error) => {
+    logger("Failed to execute codemod binary.");
+    logger(error);
+    processObject.exit(1);
+  });
+
+  const signals = ["SIGINT", "SIGTERM", "SIGHUP"];
+
+  const forwarders = signals.map((signal) => {
+    const handler = () => {
+      if (child.killed) {
+        return;
+      }
+      try {
+        child.kill(signal);
+      } catch (_) {
+        // Ignore
+      }
+    };
+    signalSource.on(signal, handler);
+    return { signal, handler };
+  });
+
+  child.on("exit", (code, signal) => {
+    forwarders.forEach(({ signal, handler }) => {
+      signalSource.removeListener(signal, handler);
+    });
+
+    if (signal) {
+      processObject.kill(processObject.pid, signal);
+    } else {
+      processObject.exit(code == null ? 1 : code);
+    }
+  });
+}
+
+function main() {
+  const child = run();
+  attachChildLifecycle(child);
+}
+
+if (require.main === module) {
+  main();
+}
+
+module.exports = {
+  CODEMOD_BOOTSTRAPPED_ENV,
+  latestBootstrapArgs,
+  npmExecutable,
+  shouldBootstrapLatestNoCommand,
+  spawnLatestCli,
+  spawnResolvedBinary,
+  run,
+  attachChildLifecycle,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codemod",
-  "version": "1.7.6",
+  "version": "1.7.7",
   "description": "Codemod platform for semantic code transformations",
   "keywords": [
     "ast",
@@ -19,15 +19,18 @@
     "README.md",
     "codemod"
   ],
+  "scripts": {
+    "test": "node --test tests/*.test.js"
+  },
   "dependencies": {
     "detect-libc": "^2.0.3"
   },
   "optionalDependencies": {
-    "@codemod.com/cli-darwin-arm64": "1.7.6",
-    "@codemod.com/cli-darwin-x64": "1.7.6",
-    "@codemod.com/cli-linux-arm64-gnu": "1.7.6",
-    "@codemod.com/cli-linux-x64-gnu": "1.7.6",
-    "@codemod.com/cli-win32-x64-msvc": "1.7.6"
+    "@codemod.com/cli-darwin-arm64": "1.7.7",
+    "@codemod.com/cli-darwin-x64": "1.7.7",
+    "@codemod.com/cli-linux-arm64-gnu": "1.7.7",
+    "@codemod.com/cli-linux-x64-gnu": "1.7.7",
+    "@codemod.com/cli-win32-x64-msvc": "1.7.7"
   },
   "engines": {
     "node": ">= 16.0.0"