@rnbsolucoes/axion-code 0.1.69 → 0.1.70

package/npm/bin/axion.mjs

@@ -1,478 +1,478 @@
-#!/usr/bin/env node
-import { spawnSync } from "node:child_process";
-import { chmodSync, copyFileSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
-import https from "node:https";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const here = dirname(fileURLToPath(import.meta.url));
-const root = resolve(here, "..", "..");
-const isWindows = process.platform === "win32";
-const exeName = isWindows ? "axion-code.exe" : "axion-code";
-const platformKey = `${process.platform}-${process.arch}`;
-const packagedExePath = join(root, "npm", "releases", platformKey, exeName);
-const binDir = isWindows
-  ? join(process.env.LOCALAPPDATA || join(process.env.USERPROFILE || root, "AppData", "Local"), "AxionCode", "bin")
-  : join(process.env.HOME || root, ".local", "share", "axion-code", "bin");
-const exePath = join(binDir, exeName);
-const markerPath = join(binDir, ".axion-code-package-version");
-const updateCachePath = join(binDir, ".axion-code-update.json");
-const packageJSON = JSON.parse(readFileSync(join(root, "package.json"), "utf8"));
-const updateSource = packageJSON.name;
-const githubSource = "github:rnbsolucoes/Axion-CLI";
-const updatePackageURL = "https://raw.githubusercontent.com/rnbsolucoes/Axion-CLI/main/package.json";
-const npmRegistryURL = "https://registry.npmjs.org/@rnbsolucoes%2Faxion-code/latest";
-const updateCommand = "axion update";
-const updateCacheTTL = 12 * 60 * 60 * 1000;
-
-function findGo() {
-  if (process.env.AXION_GO) {
-    return process.env.AXION_GO;
-  }
-  if (isWindows && process.env.USERPROFILE) {
-    const bundled = join(process.env.USERPROFILE, ".codex", "toolchains", "go1.26.4", "go", "bin", "go.exe");
-    if (existsSync(bundled)) {
-      return bundled;
-    }
-  }
-  return "go";
-}
-
-function sourceAvailable() {
-  return existsSync(join(root, "go.mod")) && existsSync(join(root, "cmd", "axion-code"));
-}
-
-function sleep(ms) {
-  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
-}
-
-function markerMatches(expectedMarker) {
-  try {
-    return existsSync(exePath) && readFileSync(markerPath, "utf8").trim() === expectedMarker;
-  } catch {
-    return false;
-  }
-}
-
-function copyPackagedBinaryWithRetry(expectedMarker) {
-  for (let attempt = 0; attempt < 8; attempt += 1) {
-    try {
-      copyFileSync(packagedExePath, exePath);
-      return;
-    } catch (error) {
-      const retryable = error && (error.code === "EBUSY" || error.code === "EPERM");
-      if (!retryable) {
-        throw error;
-      }
-      if (markerMatches(expectedMarker)) {
-        return;
-      }
-      if (attempt === 7) {
-        throw error;
-      }
-      sleep(75 * (attempt + 1));
-    }
-  }
-}
-
-function installPackagedBinary() {
-  if (!existsSync(packagedExePath)) {
-    return false;
-  }
-  const marker = packagedBinaryMarker();
-  copyPackagedBinaryWithRetry(marker);
-  if (!isWindows) {
-    chmodSync(exePath, 0o755);
-  }
-  writeFileSync(markerPath, `${marker}\n`, "utf8");
-  return true;
-}
-
-function buildFromSource() {
-  const go = findGo();
-  const result = spawnSync(go, ["build", "-o", exePath, "./cmd/axion-code"], {
-    cwd: root,
-    stdio: "inherit",
-    shell: false
-  });
-  if (result.status !== 0) {
-    return false;
-  }
-  writeFileSync(markerPath, `${sourceBinaryMarker()}\n`, "utf8");
-  return true;
-}
-
-function ensureBinary() {
-  const marker = existsSync(markerPath) ? readFileSync(markerPath, "utf8").trim() : "";
-  const desiredMarker = existsSync(packagedExePath) ? packagedBinaryMarker() : sourceBinaryMarker();
-  if (existsSync(exePath) && marker === desiredMarker) {
-    return;
-  }
-  mkdirSync(binDir, { recursive: true });
-  if (installPackagedBinary()) {
-    return;
-  }
-  if (sourceAvailable() && buildFromSource()) {
-    return;
-  }
-  console.error("");
-  console.error(`Axion Code binary for ${platformKey} was not found in this package.`);
-  console.error("If you are using a source clone, install Go 1.26+ on PATH or set AXION_GO and run:");
-  console.error("  npm run install:local");
-  console.error("If you installed from npm, update to a package that includes your platform binary.");
-  process.exit(1);
-}
-
-function packagedBinaryMarker() {
-  try {
-    const stat = statSync(packagedExePath);
-    return `${packageJSON.version}|${platformKey}|pkg|${stat.size}|${Math.trunc(stat.mtimeMs)}`;
-  } catch {
-    return `${packageJSON.version}|${platformKey}|pkg`;
-  }
-}
-
-function sourceBinaryMarker() {
-  return `${packageJSON.version}|${platformKey}|source`;
-}
-
-function semverParts(value) {
-  return String(value || "")
-    .trim()
-    .split(/[+-]/)[0]
-    .split(".")
-    .slice(0, 3)
-    .map((part) => Number.parseInt(part, 10) || 0);
-}
-
-function compareVersions(a, b) {
-  const aa = semverParts(a);
-  const bb = semverParts(b);
-  for (let i = 0; i < 3; i += 1) {
-    if ((aa[i] || 0) > (bb[i] || 0)) return 1;
-    if ((aa[i] || 0) < (bb[i] || 0)) return -1;
-  }
-  return String(a || "").localeCompare(String(b || ""));
-}
-
-function readJSON(path) {
-  try {
-    return JSON.parse(readFileSync(path, "utf8"));
-  } catch {
-    return null;
-  }
-}
-
-function writeJSON(path, value) {
-  try {
-    mkdirSync(dirname(path), { recursive: true });
-    writeFileSync(path, `${JSON.stringify(value, null, 2)}\n`, "utf8");
-  } catch {
-    // Update metadata is advisory; failing to cache must not block startup.
-  }
-}
-
-function fetchJSON(url, timeoutMs = 1800) {
-  return new Promise((resolvePromise, rejectPromise) => {
-    const headers = { "User-Agent": `Axion-Code/${packageJSON.version}` };
-    if (url.includes("githubusercontent.com")) {
-      const token = process.env.GH_TOKEN || process.env.GITHUB_TOKEN || "";
-      if (token) {
-        headers.Authorization = `Bearer ${token}`;
-      }
-    }
-    const req = https.get(url, { headers }, (res) => {
-      if (res.statusCode !== 200) {
-        res.resume();
-        rejectPromise(new Error(`status ${res.statusCode}`));
-        return;
-      }
-      let body = "";
-      res.setEncoding("utf8");
-      res.on("data", (chunk) => {
-        body += chunk;
-        if (body.length > 128 * 1024) {
-          req.destroy(new Error("version payload too large"));
-        }
-      });
-      res.on("end", () => {
-        try {
-          resolvePromise(JSON.parse(body));
-        } catch (error) {
-          rejectPromise(error);
-        }
-      });
-    });
-    req.setTimeout(timeoutMs, () => req.destroy(new Error("version check timeout")));
-    req.on("error", rejectPromise);
-  });
-}
-
-async function fetchLatestPackage() {
-  const errors = [];
-  for (const candidate of [
-    { url: npmRegistryURL, source: packageJSON.name },
-    { url: updatePackageURL, source: githubSource }
-  ]) {
-    try {
-      const remote = await fetchJSON(candidate.url);
-      const latestVersion = String(remote.version || "").trim();
-      if (latestVersion) {
-        return { latestVersion, source: candidate.source };
-      }
-      errors.push(`${candidate.url}: missing version`);
-    } catch (error) {
-      errors.push(`${candidate.url}: ${error.message}`);
-    }
-  }
-  throw new Error(errors.join("; "));
-}
-
-async function readUpdateInfo({ force = false } = {}) {
-  const cached = readJSON(updateCachePath);
-  const now = Date.now();
-  if (
-    !force &&
-    cached?.latestVersion &&
-    compareVersions(cached.latestVersion, packageJSON.version) >= 0 &&
-    now - Number(cached.checkedAt || 0) < updateCacheTTL
-  ) {
-    return {
-      currentVersion: packageJSON.version,
-      latestVersion: cached.latestVersion,
-      updateAvailable: compareVersions(cached.latestVersion, packageJSON.version) > 0,
-      source: updateSource,
-      checkedAt: cached.checkedAt,
-      fromCache: true
-    };
-  }
-  try {
-    const remote = await fetchLatestPackage();
-    const latestVersion = remote.latestVersion;
-    const info = {
-      currentVersion: packageJSON.version,
-      latestVersion,
-      updateAvailable: latestVersion ? compareVersions(latestVersion, packageJSON.version) > 0 : false,
-      source: remote.source || updateSource,
-      checkedAt: now,
-      fromCache: false
-    };
-    if (latestVersion) {
-      writeJSON(updateCachePath, { latestVersion, checkedAt: now, source: info.source });
-    }
-    return info;
-  } catch (error) {
-    const usableCachedVersion =
-      cached?.latestVersion && compareVersions(cached.latestVersion, packageJSON.version) >= 0
-        ? cached.latestVersion
-        : "";
-    return {
-      currentVersion: packageJSON.version,
-      latestVersion: usableCachedVersion,
-      updateAvailable: usableCachedVersion ? compareVersions(usableCachedVersion, packageJSON.version) > 0 : false,
-      source: cached?.source || updateSource,
-      checkedAt: cached?.checkedAt || 0,
-      fromCache: Boolean(usableCachedVersion),
-      error: error.message
-    };
-  }
-}
-
-async function updateCommandHandler(args) {
-  const checkOnly = args.includes("--check");
-  const asJSON = args.includes("--json");
-  const info = await readUpdateInfo({ force: true });
-  if (checkOnly) {
-    if (asJSON) {
-      console.log(JSON.stringify({
-        current: info.currentVersion,
-        latest: info.latestVersion || undefined,
-        update_available: info.updateAvailable,
-        source: info.source,
-        command: updateCommand,
-        checked: Boolean(info.latestVersion),
-        error: info.error || undefined
-      }));
-      return;
-    }
-    if (info.updateAvailable) {
-      console.log(`Update available: ${info.currentVersion} -> ${info.latestVersion}`);
-      console.log(`Run: ${updateCommand}`);
-      return;
-    }
-    if (info.latestVersion) {
-      console.log(`Axion Code ${info.currentVersion} is up to date.`);
-      return;
-    }
-    console.log(`Axion Code ${info.currentVersion}. Could not check latest version.`);
-    if (info.error) {
-      console.error(`Version check warning: ${info.error}`);
-    }
-    return;
-  }
-  const source = info.source === packageJSON.name ? packageJSON.name : updateSource;
-  console.log(`Updating Axion Code from ${source}...`);
-  // shell:true so Windows resolves npm.cmd (spawning bare "npm" with shell:false
-  // fails with ENOENT there). Args are fixed constants, so no injection risk.
-  const result = spawnSync("npm", ["install", "-g", source], {
-    stdio: "inherit",
-    shell: true
-  });
-  if (result.error) {
-    console.error(result.error.message);
-    process.exit(1);
-  }
-  if (result.status !== 0) {
-    process.exit(result.status || 1);
-  }
-  console.log("Axion Code update completed. Run axion again.");
-}
-
-function applyTerminalSetup({ auto = false } = {}) {
-  // Map Shift+Enter and Ctrl+Enter to send a literal newline (LF). Axion's
-  // composer inserts a line break on LF, while plain Enter (CR) still sends.
-  // This is needed because terminals do not report Shift+Enter/Ctrl+Enter as
-  // distinct keys to the app on Windows. In auto mode it stays silent, never
-  // clobbers an existing user binding, and swallows failures.
-  if (!isWindows) {
-    if (!auto) {
-      console.log("axion terminal-setup currently automates Windows Terminal.");
-      console.log("On other terminals, bind Shift+Enter (and/or Ctrl+Enter) to send a newline (\\n).");
-    }
-    return { changed: false, reason: "unsupported" };
-  }
-  const localAppData = process.env.LOCALAPPDATA || join(process.env.USERPROFILE || root, "AppData", "Local");
-  const candidates = [
-    join(localAppData, "Packages", "Microsoft.WindowsTerminal_8wekyb3d8bbwe", "LocalState", "settings.json"),
-    join(localAppData, "Packages", "Microsoft.WindowsTerminalPreview_8wekyb3d8bbwe", "LocalState", "settings.json"),
-    join(localAppData, "Microsoft", "Windows Terminal", "settings.json")
-  ];
-  const settingsPath = candidates.find((p) => existsSync(p));
-  if (!settingsPath) {
-    if (!auto) {
-      console.log("Windows Terminal settings.json not found.");
-      console.log("If you use another terminal, bind Shift+Enter / Ctrl+Enter to send a newline (\\n).");
-    }
-    return { changed: false, reason: "not-found" };
-  }
-  let settings;
-  try {
-    settings = JSON.parse(readFileSync(settingsPath, "utf8"));
-  } catch (err) {
-    if (!auto) {
-      console.error(`Could not parse ${settingsPath}: ${err.message}`);
-      process.exit(1);
-    }
-    return { changed: false, reason: "parse-error" };
-  }
-  if (!Array.isArray(settings.keybindings)) settings.keybindings = [];
-  const wanted = ["shift+enter", "ctrl+enter"];
-  // Windows Terminal may normalize an inline {command,keys} binding into an
-  // id-based one ({id,keys}) plus an entry in `actions`, so resolve both forms.
-  const effectiveCommand = (k) => {
-    if (!k) return null;
-    if (k.command) return k.command;
-    if (k.id) {
-      const a = (settings.actions || []).find((x) => x && x.id === k.id);
-      if (a && a.command) return a.command;
-    }
-    return null;
-  };
-  const isOurs = (k, keys) => {
-    if (!k || k.keys !== keys) return false;
-    const c = effectiveCommand(k);
-    return c && c.action === "sendInput" && c.input === "\n";
-  };
-  if (wanted.every((keys) => settings.keybindings.some((k) => isOurs(k, keys)))) {
-    if (!auto) console.log("Windows Terminal is already set up: Shift+Enter and Ctrl+Enter insert a newline.");
-    return { changed: false, reason: "already" };
-  }
-  if (auto) {
-    // Never overwrite a binding the user assigned to these keys themselves.
-    for (const keys of wanted) {
-      const existing = settings.keybindings.find((k) => k && k.keys === keys);
-      if (existing && !isOurs(existing, keys)) return { changed: false, reason: "conflict" };
-    }
-  }
-  settings.keybindings = settings.keybindings.filter((k) => !(k && wanted.includes(k.keys)));
-  for (const keys of wanted) {
-    settings.keybindings.push({ command: { action: "sendInput", input: "\n" }, keys });
-  }
-  const backup = `${settingsPath}.axion-bak`;
-  try {
-    copyFileSync(settingsPath, backup);
-  } catch {}
-  try {
-    writeFileSync(settingsPath, JSON.stringify(settings, null, 4));
-  } catch (err) {
-    if (!auto) {
-      console.error(err.message);
-      process.exit(1);
-    }
-    return { changed: false, reason: "write-error" };
-  }
-  if (!auto) {
-    console.log("Windows Terminal configured: Shift+Enter and Ctrl+Enter now insert a newline in Axion (Enter still sends).");
-    console.log(`Settings: ${settingsPath}`);
-    console.log(`Backup:   ${backup}`);
-    console.log("Reopen the terminal tab if the change does not take effect immediately.");
-  }
-  return { changed: true, settingsPath, backup };
-}
-
-function terminalSetupHandler() {
-  applyTerminalSetup({ auto: false });
-}
-
-function maybeFirstRunTerminalSetup() {
-  if (!isWindows || process.env.AXION_SKIP_TERMINAL_SETUP) return;
-  const marker = join(binDir, ".axion-terminal-setup-done");
-  if (existsSync(marker)) return;
-  try {
-    const res = applyTerminalSetup({ auto: true });
-    if (res.changed) {
-      console.log(
-        `Axion enabled Shift+Enter and Ctrl+Enter as newline keys in Windows Terminal ` +
-        `(reopen the tab to apply; backup at ${res.backup}, opt out with AXION_SKIP_TERMINAL_SETUP=1, ` +
-        `redo with 'axion terminal-setup').`
-      );
-    }
-  } catch {}
-  try {
-    mkdirSync(binDir, { recursive: true });
-    writeFileSync(marker, new Date().toISOString());
-  } catch {}
-}
-
-const args = process.argv.slice(2);
-if (args[0] === "update") {
-  await updateCommandHandler(args.slice(1));
-  process.exit(0);
-}
-if (args[0] === "terminal-setup") {
-  terminalSetupHandler();
-  process.exit(0);
-}
-
-maybeFirstRunTerminalSetup();
-
-const updateInfo = await readUpdateInfo();
-ensureBinary();
-const run = spawnSync(exePath, process.argv.slice(2), {
-  stdio: "inherit",
-  shell: false,
-  env: {
-    ...process.env,
-    AXION_CODE_VERSION: packageJSON.version,
-    AXION_CODE_LATEST_VERSION: updateInfo.latestVersion || "",
-    AXION_CODE_UPDATE_AVAILABLE: updateInfo.updateAvailable ? "1" : "0",
-    AXION_CODE_UPDATE_COMMAND: updateCommand,
-    AXION_CODE_UPDATE_SOURCE: updateSource
-  }
-});
-
-if (run.error) {
-  console.error(run.error.message);
-  process.exit(1);
-}
-process.exit(run.status ?? 0);
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import { chmodSync, copyFileSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import https from "node:https";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const root = resolve(here, "..", "..");
+const isWindows = process.platform === "win32";
+const exeName = isWindows ? "axion-code.exe" : "axion-code";
+const platformKey = `${process.platform}-${process.arch}`;
+const packagedExePath = join(root, "npm", "releases", platformKey, exeName);
+const binDir = isWindows
+  ? join(process.env.LOCALAPPDATA || join(process.env.USERPROFILE || root, "AppData", "Local"), "AxionCode", "bin")
+  : join(process.env.HOME || root, ".local", "share", "axion-code", "bin");
+const exePath = join(binDir, exeName);
+const markerPath = join(binDir, ".axion-code-package-version");
+const updateCachePath = join(binDir, ".axion-code-update.json");
+const packageJSON = JSON.parse(readFileSync(join(root, "package.json"), "utf8"));
+const updateSource = packageJSON.name;
+const githubSource = "github:rnbsolucoes/Axion-CLI";
+const updatePackageURL = "https://raw.githubusercontent.com/rnbsolucoes/Axion-CLI/main/package.json";
+const npmRegistryURL = "https://registry.npmjs.org/@rnbsolucoes%2Faxion-code/latest";
+const updateCommand = "axion update";
+const updateCacheTTL = 12 * 60 * 60 * 1000;
+
+function findGo() {
+  if (process.env.AXION_GO) {
+    return process.env.AXION_GO;
+  }
+  if (isWindows && process.env.USERPROFILE) {
+    const bundled = join(process.env.USERPROFILE, ".codex", "toolchains", "go1.26.4", "go", "bin", "go.exe");
+    if (existsSync(bundled)) {
+      return bundled;
+    }
+  }
+  return "go";
+}
+
+function sourceAvailable() {
+  return existsSync(join(root, "go.mod")) && existsSync(join(root, "cmd", "axion-code"));
+}
+
+function sleep(ms) {
+  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+
+function markerMatches(expectedMarker) {
+  try {
+    return existsSync(exePath) && readFileSync(markerPath, "utf8").trim() === expectedMarker;
+  } catch {
+    return false;
+  }
+}
+
+function copyPackagedBinaryWithRetry(expectedMarker) {
+  for (let attempt = 0; attempt < 8; attempt += 1) {
+    try {
+      copyFileSync(packagedExePath, exePath);
+      return;
+    } catch (error) {
+      const retryable = error && (error.code === "EBUSY" || error.code === "EPERM");
+      if (!retryable) {
+        throw error;
+      }
+      if (markerMatches(expectedMarker)) {
+        return;
+      }
+      if (attempt === 7) {
+        throw error;
+      }
+      sleep(75 * (attempt + 1));
+    }
+  }
+}
+
+function installPackagedBinary() {
+  if (!existsSync(packagedExePath)) {
+    return false;
+  }
+  const marker = packagedBinaryMarker();
+  copyPackagedBinaryWithRetry(marker);
+  if (!isWindows) {
+    chmodSync(exePath, 0o755);
+  }
+  writeFileSync(markerPath, `${marker}\n`, "utf8");
+  return true;
+}
+
+function buildFromSource() {
+  const go = findGo();
+  const result = spawnSync(go, ["build", "-o", exePath, "./cmd/axion-code"], {
+    cwd: root,
+    stdio: "inherit",
+    shell: false
+  });
+  if (result.status !== 0) {
+    return false;
+  }
+  writeFileSync(markerPath, `${sourceBinaryMarker()}\n`, "utf8");
+  return true;
+}
+
+function ensureBinary() {
+  const marker = existsSync(markerPath) ? readFileSync(markerPath, "utf8").trim() : "";
+  const desiredMarker = existsSync(packagedExePath) ? packagedBinaryMarker() : sourceBinaryMarker();
+  if (existsSync(exePath) && marker === desiredMarker) {
+    return;
+  }
+  mkdirSync(binDir, { recursive: true });
+  if (installPackagedBinary()) {
+    return;
+  }
+  if (sourceAvailable() && buildFromSource()) {
+    return;
+  }
+  console.error("");
+  console.error(`Axion Code binary for ${platformKey} was not found in this package.`);
+  console.error("If you are using a source clone, install Go 1.26+ on PATH or set AXION_GO and run:");
+  console.error("  npm run install:local");
+  console.error("If you installed from npm, update to a package that includes your platform binary.");
+  process.exit(1);
+}
+
+function packagedBinaryMarker() {
+  try {
+    const stat = statSync(packagedExePath);
+    return `${packageJSON.version}|${platformKey}|pkg|${stat.size}|${Math.trunc(stat.mtimeMs)}`;
+  } catch {
+    return `${packageJSON.version}|${platformKey}|pkg`;
+  }
+}
+
+function sourceBinaryMarker() {
+  return `${packageJSON.version}|${platformKey}|source`;
+}
+
+function semverParts(value) {
+  return String(value || "")
+    .trim()
+    .split(/[+-]/)[0]
+    .split(".")
+    .slice(0, 3)
+    .map((part) => Number.parseInt(part, 10) || 0);
+}
+
+function compareVersions(a, b) {
+  const aa = semverParts(a);
+  const bb = semverParts(b);
+  for (let i = 0; i < 3; i += 1) {
+    if ((aa[i] || 0) > (bb[i] || 0)) return 1;
+    if ((aa[i] || 0) < (bb[i] || 0)) return -1;
+  }
+  return String(a || "").localeCompare(String(b || ""));
+}
+
+function readJSON(path) {
+  try {
+    return JSON.parse(readFileSync(path, "utf8"));
+  } catch {
+    return null;
+  }
+}
+
+function writeJSON(path, value) {
+  try {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+  } catch {
+    // Update metadata is advisory; failing to cache must not block startup.
+  }
+}
+
+function fetchJSON(url, timeoutMs = 1800) {
+  return new Promise((resolvePromise, rejectPromise) => {
+    const headers = { "User-Agent": `Axion-Code/${packageJSON.version}` };
+    if (url.includes("githubusercontent.com")) {
+      const token = process.env.GH_TOKEN || process.env.GITHUB_TOKEN || "";
+      if (token) {
+        headers.Authorization = `Bearer ${token}`;
+      }
+    }
+    const req = https.get(url, { headers }, (res) => {
+      if (res.statusCode !== 200) {
+        res.resume();
+        rejectPromise(new Error(`status ${res.statusCode}`));
+        return;
+      }
+      let body = "";
+      res.setEncoding("utf8");
+      res.on("data", (chunk) => {
+        body += chunk;
+        if (body.length > 128 * 1024) {
+          req.destroy(new Error("version payload too large"));
+        }
+      });
+      res.on("end", () => {
+        try {
+          resolvePromise(JSON.parse(body));
+        } catch (error) {
+          rejectPromise(error);
+        }
+      });
+    });
+    req.setTimeout(timeoutMs, () => req.destroy(new Error("version check timeout")));
+    req.on("error", rejectPromise);
+  });
+}
+
+async function fetchLatestPackage() {
+  const errors = [];
+  for (const candidate of [
+    { url: npmRegistryURL, source: packageJSON.name },
+    { url: updatePackageURL, source: githubSource }
+  ]) {
+    try {
+      const remote = await fetchJSON(candidate.url);
+      const latestVersion = String(remote.version || "").trim();
+      if (latestVersion) {
+        return { latestVersion, source: candidate.source };
+      }
+      errors.push(`${candidate.url}: missing version`);
+    } catch (error) {
+      errors.push(`${candidate.url}: ${error.message}`);
+    }
+  }
+  throw new Error(errors.join("; "));
+}
+
+async function readUpdateInfo({ force = false } = {}) {
+  const cached = readJSON(updateCachePath);
+  const now = Date.now();
+  if (
+    !force &&
+    cached?.latestVersion &&
+    compareVersions(cached.latestVersion, packageJSON.version) >= 0 &&
+    now - Number(cached.checkedAt || 0) < updateCacheTTL
+  ) {
+    return {
+      currentVersion: packageJSON.version,
+      latestVersion: cached.latestVersion,
+      updateAvailable: compareVersions(cached.latestVersion, packageJSON.version) > 0,
+      source: updateSource,
+      checkedAt: cached.checkedAt,
+      fromCache: true
+    };
+  }
+  try {
+    const remote = await fetchLatestPackage();
+    const latestVersion = remote.latestVersion;
+    const info = {
+      currentVersion: packageJSON.version,
+      latestVersion,
+      updateAvailable: latestVersion ? compareVersions(latestVersion, packageJSON.version) > 0 : false,
+      source: remote.source || updateSource,
+      checkedAt: now,
+      fromCache: false
+    };
+    if (latestVersion) {
+      writeJSON(updateCachePath, { latestVersion, checkedAt: now, source: info.source });
+    }
+    return info;
+  } catch (error) {
+    const usableCachedVersion =
+      cached?.latestVersion && compareVersions(cached.latestVersion, packageJSON.version) >= 0
+        ? cached.latestVersion
+        : "";
+    return {
+      currentVersion: packageJSON.version,
+      latestVersion: usableCachedVersion,
+      updateAvailable: usableCachedVersion ? compareVersions(usableCachedVersion, packageJSON.version) > 0 : false,
+      source: cached?.source || updateSource,
+      checkedAt: cached?.checkedAt || 0,
+      fromCache: Boolean(usableCachedVersion),
+      error: error.message
+    };
+  }
+}
+
+async function updateCommandHandler(args) {
+  const checkOnly = args.includes("--check");
+  const asJSON = args.includes("--json");
+  const info = await readUpdateInfo({ force: true });
+  if (checkOnly) {
+    if (asJSON) {
+      console.log(JSON.stringify({
+        current: info.currentVersion,
+        latest: info.latestVersion || undefined,
+        update_available: info.updateAvailable,
+        source: info.source,
+        command: updateCommand,
+        checked: Boolean(info.latestVersion),
+        error: info.error || undefined
+      }));
+      return;
+    }
+    if (info.updateAvailable) {
+      console.log(`Update available: ${info.currentVersion} -> ${info.latestVersion}`);
+      console.log(`Run: ${updateCommand}`);
+      return;
+    }
+    if (info.latestVersion) {
+      console.log(`Axion Code ${info.currentVersion} is up to date.`);
+      return;
+    }
+    console.log(`Axion Code ${info.currentVersion}. Could not check latest version.`);
+    if (info.error) {
+      console.error(`Version check warning: ${info.error}`);
+    }
+    return;
+  }
+  const source = info.source === packageJSON.name ? packageJSON.name : updateSource;
+  console.log(`Updating Axion Code from ${source}...`);
+  // shell:true so Windows resolves npm.cmd (spawning bare "npm" with shell:false
+  // fails with ENOENT there). Args are fixed constants, so no injection risk.
+  const result = spawnSync("npm", ["install", "-g", source], {
+    stdio: "inherit",
+    shell: true
+  });
+  if (result.error) {
+    console.error(result.error.message);
+    process.exit(1);
+  }
+  if (result.status !== 0) {
+    process.exit(result.status || 1);
+  }
+  console.log("Axion Code update completed. Run axion again.");
+}
+
+function applyTerminalSetup({ auto = false } = {}) {
+  // Map Shift+Enter and Ctrl+Enter to send a literal newline (LF). Axion's
+  // composer inserts a line break on LF, while plain Enter (CR) still sends.
+  // This is needed because terminals do not report Shift+Enter/Ctrl+Enter as
+  // distinct keys to the app on Windows. In auto mode it stays silent, never
+  // clobbers an existing user binding, and swallows failures.
+  if (!isWindows) {
+    if (!auto) {
+      console.log("axion terminal-setup currently automates Windows Terminal.");
+      console.log("On other terminals, bind Shift+Enter (and/or Ctrl+Enter) to send a newline (\\n).");
+    }
+    return { changed: false, reason: "unsupported" };
+  }
+  const localAppData = process.env.LOCALAPPDATA || join(process.env.USERPROFILE || root, "AppData", "Local");
+  const candidates = [
+    join(localAppData, "Packages", "Microsoft.WindowsTerminal_8wekyb3d8bbwe", "LocalState", "settings.json"),
+    join(localAppData, "Packages", "Microsoft.WindowsTerminalPreview_8wekyb3d8bbwe", "LocalState", "settings.json"),
+    join(localAppData, "Microsoft", "Windows Terminal", "settings.json")
+  ];
+  const settingsPath = candidates.find((p) => existsSync(p));
+  if (!settingsPath) {
+    if (!auto) {
+      console.log("Windows Terminal settings.json not found.");
+      console.log("If you use another terminal, bind Shift+Enter / Ctrl+Enter to send a newline (\\n).");
+    }
+    return { changed: false, reason: "not-found" };
+  }
+  let settings;
+  try {
+    settings = JSON.parse(readFileSync(settingsPath, "utf8"));
+  } catch (err) {
+    if (!auto) {
+      console.error(`Could not parse ${settingsPath}: ${err.message}`);
+      process.exit(1);
+    }
+    return { changed: false, reason: "parse-error" };
+  }
+  if (!Array.isArray(settings.keybindings)) settings.keybindings = [];
+  const wanted = ["shift+enter", "ctrl+enter"];
+  // Windows Terminal may normalize an inline {command,keys} binding into an
+  // id-based one ({id,keys}) plus an entry in `actions`, so resolve both forms.
+  const effectiveCommand = (k) => {
+    if (!k) return null;
+    if (k.command) return k.command;
+    if (k.id) {
+      const a = (settings.actions || []).find((x) => x && x.id === k.id);
+      if (a && a.command) return a.command;
+    }
+    return null;
+  };
+  const isOurs = (k, keys) => {
+    if (!k || k.keys !== keys) return false;
+    const c = effectiveCommand(k);
+    return c && c.action === "sendInput" && c.input === "\n";
+  };
+  if (wanted.every((keys) => settings.keybindings.some((k) => isOurs(k, keys)))) {
+    if (!auto) console.log("Windows Terminal is already set up: Shift+Enter and Ctrl+Enter insert a newline.");
+    return { changed: false, reason: "already" };
+  }
+  if (auto) {
+    // Never overwrite a binding the user assigned to these keys themselves.
+    for (const keys of wanted) {
+      const existing = settings.keybindings.find((k) => k && k.keys === keys);
+      if (existing && !isOurs(existing, keys)) return { changed: false, reason: "conflict" };
+    }
+  }
+  settings.keybindings = settings.keybindings.filter((k) => !(k && wanted.includes(k.keys)));
+  for (const keys of wanted) {
+    settings.keybindings.push({ command: { action: "sendInput", input: "\n" }, keys });
+  }
+  const backup = `${settingsPath}.axion-bak`;
+  try {
+    copyFileSync(settingsPath, backup);
+  } catch {}
+  try {
+    writeFileSync(settingsPath, JSON.stringify(settings, null, 4));
+  } catch (err) {
+    if (!auto) {
+      console.error(err.message);
+      process.exit(1);
+    }
+    return { changed: false, reason: "write-error" };
+  }
+  if (!auto) {
+    console.log("Windows Terminal configured: Shift+Enter and Ctrl+Enter now insert a newline in Axion (Enter still sends).");
+    console.log(`Settings: ${settingsPath}`);
+    console.log(`Backup:   ${backup}`);
+    console.log("Reopen the terminal tab if the change does not take effect immediately.");
+  }
+  return { changed: true, settingsPath, backup };
+}
+
+function terminalSetupHandler() {
+  applyTerminalSetup({ auto: false });
+}
+
+function maybeFirstRunTerminalSetup() {
+  if (!isWindows || process.env.AXION_SKIP_TERMINAL_SETUP) return;
+  const marker = join(binDir, ".axion-terminal-setup-done");
+  if (existsSync(marker)) return;
+  try {
+    const res = applyTerminalSetup({ auto: true });
+    if (res.changed) {
+      console.log(
+        `Axion enabled Shift+Enter and Ctrl+Enter as newline keys in Windows Terminal ` +
+        `(reopen the tab to apply; backup at ${res.backup}, opt out with AXION_SKIP_TERMINAL_SETUP=1, ` +
+        `redo with 'axion terminal-setup').`
+      );
+    }
+  } catch {}
+  try {
+    mkdirSync(binDir, { recursive: true });
+    writeFileSync(marker, new Date().toISOString());
+  } catch {}
+}
+
+const args = process.argv.slice(2);
+if (args[0] === "update") {
+  await updateCommandHandler(args.slice(1));
+  process.exit(0);
+}
+if (args[0] === "terminal-setup") {
+  terminalSetupHandler();
+  process.exit(0);
+}
+
+maybeFirstRunTerminalSetup();
+
+const updateInfo = await readUpdateInfo();
+ensureBinary();
+const run = spawnSync(exePath, process.argv.slice(2), {
+  stdio: "inherit",
+  shell: false,
+  env: {
+    ...process.env,
+    AXION_CODE_VERSION: packageJSON.version,
+    AXION_CODE_LATEST_VERSION: updateInfo.latestVersion || "",
+    AXION_CODE_UPDATE_AVAILABLE: updateInfo.updateAvailable ? "1" : "0",
+    AXION_CODE_UPDATE_COMMAND: updateCommand,
+    AXION_CODE_UPDATE_SOURCE: updateSource
+  }
+});
+
+if (run.error) {
+  console.error(run.error.message);
+  process.exit(1);
+}
+process.exit(run.status ?? 0);