@arkveil/cli 1.1.0 → 1.2.0

package/dist/index.js

@@ -5413,9 +5413,9 @@ var require_src = __commonJS({
 });
 
 // src/index.ts
-import { readFileSync as readFileSync4 } from "fs";
-import { fileURLToPath as fileURLToPath2 } from "url";
-import { dirname, join as join2 } from "path";
+import { readFileSync as readFileSync5 } from "fs";
+import { fileURLToPath as fileURLToPath4 } from "url";
+import { dirname as dirname2, join as join3 } from "path";
 
 // node_modules/.pnpm/commander@12.1.0/node_modules/commander/esm.mjs
 var import_index = __toESM(require_commander(), 1);
@@ -14954,12 +14954,255 @@ function registerAdmin(program2) {
   });
 }
 
+// src/commands/update/update.ts
+import { execFile as execFile6 } from "child_process";
+import { fileURLToPath as fileURLToPath3 } from "url";
+
+// src/commands/update/npm.ts
+import { existsSync, readFileSync as readFileSync4 } from "fs";
+import { fileURLToPath as fileURLToPath2 } from "url";
+import { dirname, join as join2, parse } from "path";
+function readPackageMeta() {
+  let dir = dirname(fileURLToPath2(import.meta.url));
+  const { root } = parse(dir);
+  while (true) {
+    const candidate = join2(dir, "package.json");
+    if (existsSync(candidate)) {
+      const pkg = JSON.parse(readFileSync4(candidate, "utf8"));
+      return { name: pkg.name ?? "@arkveil/cli", version: pkg.version ?? "0.0.0" };
+    }
+    if (dir === root) break;
+    dir = dirname(dir);
+  }
+  return { name: "@arkveil/cli", version: "0.0.0" };
+}
+function parseSemver(version) {
+  const cleaned = version.trim().replace(/^v/, "");
+  const [main3 = "", pre = null] = cleaned.split("-", 2);
+  const core = main3.split(".").map((p) => Number.parseInt(p, 10) || 0);
+  while (core.length < 3) core.push(0);
+  return { core: core.slice(0, 3), pre: pre ?? null };
+}
+function compareSemver(a3, b3) {
+  const pa = parseSemver(a3);
+  const pb = parseSemver(b3);
+  for (let i = 0; i < 3; i++) {
+    const diff = (pa.core[i] ?? 0) - (pb.core[i] ?? 0);
+    if (diff !== 0) return diff < 0 ? -1 : 1;
+  }
+  if (pa.pre === pb.pre) return 0;
+  if (pa.pre === null) return 1;
+  if (pb.pre === null) return -1;
+  return pa.pre < pb.pre ? -1 : 1;
+}
+var PACKAGE_MANAGERS = ["pnpm", "yarn", "bun", "npm"];
+function detectPackageManager(modulePath, env2 = process.env) {
+  const path2 = modulePath.toLowerCase();
+  if (path2.includes("pnpm")) return "pnpm";
+  if (path2.includes(`${"/"}.bun${"/"}`) || path2.includes("/bun/")) return "bun";
+  if (path2.includes(".yarn") || path2.includes("/yarn/")) return "yarn";
+  const agent = (env2.npm_config_user_agent ?? "").toLowerCase();
+  const fromAgent = PACKAGE_MANAGERS.find((pm) => agent.startsWith(pm));
+  if (fromAgent) return fromAgent;
+  return "npm";
+}
+function installCommand(pm, spec) {
+  switch (pm) {
+    case "pnpm":
+      return { cmd: "pnpm", args: ["add", "-g", spec] };
+    case "yarn":
+      return { cmd: "yarn", args: ["global", "add", spec] };
+    case "bun":
+      return { cmd: "bun", args: ["add", "-g", spec] };
+    case "npm":
+    default:
+      return { cmd: "npm", args: ["install", "-g", spec] };
+  }
+}
+async function fetchLatestVersion(opts) {
+  const tag = opts.tag ?? "latest";
+  const registry = (opts.registry ?? "https://registry.npmjs.org").replace(/\/+$/, "");
+  const encoded = opts.name.replace("/", "%2f");
+  const url = `${registry}/${encoded}/${tag}`;
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), opts.timeoutMs ?? 1e4);
+  try {
+    const res = await fetch(url, {
+      headers: { accept: "application/json" },
+      signal: controller.signal
+    });
+    if (!res.ok) {
+      throw new NetworkError(
+        `npm registry returned ${res.status} for ${opts.name}@${tag}.`,
+        "Check your network connection and that the package/tag exists."
+      );
+    }
+    const body = await res.json();
+    if (!body.version) {
+      throw new NetworkError(
+        `npm registry response for ${opts.name}@${tag} had no version.`
+      );
+    }
+    return body.version;
+  } catch (err) {
+    if (err instanceof NetworkError) throw err;
+    if (err instanceof Error && err.name === "AbortError") {
+      throw new NetworkError(
+        `Timed out contacting the npm registry for ${opts.name}@${tag}.`,
+        "Retry, or increase the timeout with --timeout <ms>.",
+        err
+      );
+    }
+    throw new NetworkError(
+      `Could not reach the npm registry: ${err instanceof Error ? err.message : String(err)}`,
+      "Check your network connection.",
+      err
+    );
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+// src/commands/update/update.ts
+var VALID_PMS = ["npm", "pnpm", "yarn", "bun"];
+async function selfUpdate(ctx, options) {
+  const { out, config } = ctx;
+  const meta = readPackageMeta();
+  const tag = options.tag ?? "latest";
+  if (options.use && !VALID_PMS.includes(options.use)) {
+    throw new CliError(`Unknown package manager "${options.use}".`, {
+      exitCode: ExitCode.Usage,
+      hint: `Choose one of: ${VALID_PMS.join(", ")}.`
+    });
+  }
+  const spinner = out.spinner(`Checking npm for ${meta.name}@${tag}\u2026`);
+  let latest;
+  try {
+    latest = await fetchLatestVersion({
+      name: meta.name,
+      tag,
+      timeoutMs: config.timeoutMs
+    });
+    spinner.stop();
+  } catch (err) {
+    spinner.fail("Could not check for updates.");
+    throw err;
+  }
+  const cmp = compareSemver(meta.version, latest);
+  const upToDate = cmp >= 0;
+  const willUpdate = !upToDate || Boolean(options.force);
+  const pm = options.use ?? detectPackageManager(fileURLToPath3(import.meta.url));
+  const spec = `${meta.name}@${tag}`;
+  const { cmd, args } = installCommand(pm, spec);
+  const commandLine = `${cmd} ${args.join(" ")}`;
+  if (options.check || options.dryRun || !willUpdate) {
+    out.data(
+      {
+        name: meta.name,
+        current: meta.version,
+        latest,
+        tag,
+        updateAvailable: !upToDate,
+        upToDate,
+        packageManager: pm,
+        command: commandLine,
+        action: options.dryRun ? "dry-run" : options.check ? "check" : "none"
+      },
+      (o2) => {
+        if (upToDate) {
+          return `${o2.c.green("\u2714")} ${meta.name} is up to date (${meta.version}).`;
+        }
+        const lines = [
+          `${o2.c.yellow("!")} Update available: ${o2.c.dim(meta.version)} \u2192 ${o2.c.green(latest)}`
+        ];
+        if (options.dryRun) {
+          lines.push(`  Would run: ${o2.c.cyan(commandLine)}`);
+        } else {
+          lines.push(`  Run ${o2.c.cyan("arkveil update")} to upgrade (uses: ${o2.c.cyan(commandLine)}).`);
+        }
+        return lines.join("\n");
+      }
+    );
+    return;
+  }
+  const label = upToDate ? `Reinstalling ${spec}\u2026` : `Updating ${meta.name} ${meta.version} \u2192 ${latest}\u2026`;
+  out.verbose(`Running: ${commandLine}`);
+  const install = out.spinner(label);
+  try {
+    await runInstall(cmd, args);
+    install.succeed(`Updated to ${latest}. Run \`arkveil --version\` to confirm.`);
+  } catch (err) {
+    install.fail("Update failed.");
+    throw toInstallError(err, pm, commandLine);
+  }
+  out.data(
+    {
+      name: meta.name,
+      previous: meta.version,
+      latest,
+      tag,
+      packageManager: pm,
+      command: commandLine,
+      action: "updated"
+    },
+    () => {
+    }
+  );
+}
+function runInstall(cmd, args) {
+  return new Promise((resolve2, reject) => {
+    execFile6(cmd, args, { timeout: 12e4 }, (err) => {
+      if (err) reject(err);
+      else resolve2();
+    });
+  });
+}
+function toInstallError(err, pm, commandLine) {
+  const e2 = err;
+  if (e2?.code === "ENOENT") {
+    return new CliError(`${pm} was not found on your PATH.`, {
+      exitCode: ExitCode.Generic,
+      hint: `Install ${pm}, or pass --use <npm|pnpm|yarn|bun> to pick another package manager.`,
+      cause: err
+    });
+  }
+  const detail = (e2?.stderr ?? e2?.message ?? String(err)).trim().split("\n").slice(-3).join(" ");
+  return new CliError(`Upgrade command failed: ${detail || commandLine}`, {
+    exitCode: ExitCode.Generic,
+    hint: `Try running it yourself: ${commandLine}. A global install may require elevated permissions (sudo).`,
+    cause: err
+  });
+}
+
+// src/commands/update/index.ts
+function registerUpdate(program2) {
+  program2.command("update").aliases(["upgrade", "self-update"]).description("Update the Arkveil CLI to the latest published version").option("--check", "only report whether an update is available; don't install").option("--dry-run", "print the install command that would run, without executing it").option("--tag <tag>", "npm dist-tag to install (default latest)", "latest").option("--use <pm>", "package manager to use: npm, pnpm, yarn, or bun").option("--force", "reinstall even if already on the target version").addHelpText(
+    "after",
+    `
+Checks the npm registry for a newer release of the CLI and upgrades this install
+in place using the package manager that installed it (auto-detected; override
+with --use). Use --check in scripts/CI to detect a pending update via the exit
+output without changing anything.
+
+Examples:
+  $ arkveil update                 # upgrade to the latest release
+  $ arkveil update --check         # is a newer version available?
+  $ arkveil update --dry-run       # show the command without running it
+  $ arkveil update --tag next      # install the "next" dist-tag
+  $ arkveil update --use pnpm      # force pnpm for the global install
+  $ arkveil update --json          # machine-readable result
+`
+  ).action(async (options, command) => {
+    await run(command, (ctx) => selfUpdate(ctx, options));
+  });
+}
+
 // src/index.ts
 function readVersion() {
   try {
-    const here = dirname(fileURLToPath2(import.meta.url));
+    const here = dirname2(fileURLToPath4(import.meta.url));
     const pkg = JSON.parse(
-      readFileSync4(join2(here, "..", "package.json"), "utf8")
+      readFileSync5(join3(here, "..", "package.json"), "utf8")
     );
     return pkg.version ?? "0.0.0";
   } catch {
@@ -14993,6 +15236,7 @@ function buildProgram() {
   registerEval(program2);
   registerAbac(program2);
   registerAdmin(program2);
+  registerUpdate(program2);
   program2.addHelpText(
     "after",
     `
@@ -15002,6 +15246,7 @@ Examples:
   $ arkveil tags list --json                 List tags as JSON
   $ arkveil trees forest                     Show the full navigation forest
   $ arkveil sdk info                         How to install & use the SDK
+  $ arkveil update                           Update the CLI to the latest release
   $ arkveil formula syntax                   Print the formula DSL reference
   $ arkveil eval explain -a orders:read \\
       --user '{"role":"admin"}' --context '{}'   Explain an access decision