higherdata 0.3.0 → 0.3.1

package/README.md

@@ -213,9 +213,8 @@ Formats follow the current [Claude Code MCP](https://code.claude.com/docs/en/mcp
 ## Compatibility
 
 The CLI reads public `/api/v1/meta` once per day per API origin and caches the
-policy beside its config file. Updates are announced on stderr so JSON output
-stays machine-readable. Versions below the server's minimum refuse commands
-with `npm install --global higherdata@latest` as the upgrade command. `login`,
+policy beside its config file. Update notices are written to stderr only during interactive invocations.
+Versions below the server's minimum refuse commands and suggest `higherdata update`. `update`, `login`,
 `--help` and `--version` remain available without a compatibility check.
 
 The metadata request times out after three seconds. On network failure the CLI
@@ -224,3 +223,31 @@ checks are cached for a day too. A read-only cache directory allows commands but
 cannot persist the daily check, so subsequent invocations may check again.
 
 Download the loaded search page to a new file with `higherdata search companies --country-code CA --out results.csv`. Add `--all` to download up to 5,000 rows, or use a `.jsonl` destination for JSON Lines. The interactive results screen offers "This page" and "All results" when you press `d`. For larger sets, save the search to a list and export the list. Existing files are never overwritten.
+
+## Updates
+
+Run `higherdata update` (alias `higherdata upgrade`) to check npm and install the
+latest stable release. The CLI installs the exact version it checked and prints
+the old and new versions. A permission failure prints npm's error summary and
+the manual command. It never retries with sudo.
+
+Interactive npm global installs check npm on every run with a 1.5-second timeout, then
+automatically install a newer release and restart the same command with the
+same arguments. Failed installs print a manual command and continue on the
+current version. Timeouts and network failures continue silently. There is no
+cache for this npm release check.
+
+Automatic updates are skipped when either stdin or stdout is not a TTY, `CI`
+is set, `--json` or `--jsonl` is used, for MCP or stdio protocols, and for `npx`
+or non-global installs. To opt out for an invocation, set
+`HIGHERDATA_NO_AUTO_UPDATE=1`. To persist the preference, run:
+
+```sh
+higherdata config set auto-update false
+# Re-enable automatic updates
+higherdata config set auto-update true
+```
+
+Explicit `higherdata update` remains available with an opt-out or a server
+minimum-version refusal. Users on 0.3.0 must reinstall once to obtain the update
+command: `npm install --global higherdata@latest`.

package/dist/index.js

@@ -20573,6 +20573,7 @@ var init_config = __esm({
       space: external_exports.string().min(1).optional()
     });
     configSchema = external_exports.strictObject({
+      autoUpdate: external_exports.boolean().optional(),
       activeProfile: external_exports.string().min(1),
       profiles: external_exports.record(external_exports.string().min(1), profileSchema)
     }).refine((config2) => Object.hasOwn(config2.profiles, config2.activeProfile), {
@@ -20587,6 +20588,16 @@ var init_config = __esm({
   }
 });
 
+// ../../src/lib/ai/messages.ts
+var OWN_KEY_REQUIRED, OWN_KEY_REJECTED;
+var init_messages = __esm({
+  "../../src/lib/ai/messages.ts"() {
+    "use strict";
+    OWN_KEY_REQUIRED = "Add your OpenRouter key in Settings to use AI features.";
+    OWN_KEY_REJECTED = "Your OpenRouter key was rejected. Update it in Settings.";
+  }
+});
+
 // ../sdk/src/generated.ts
 var TOOL_CATALOG;
 var init_generated = __esm({
@@ -28312,6 +28323,7 @@ function apiFailure(status, data) {
   if (code === "limit_exceeded" && message && /^This month's email verification allowance is reached\. Resets \d{4}-\d{2}-\d{2}\. Upgrade: (https:\/\/[^\s]+|\/docs\/plans-and-limits)$/.test(message)) return new CliError(message, EXIT_CODES.LIMIT);
   if (status === 429 || code === "limit_exceeded") return new CliError("A HigherData limit was reached. Wait until the limit resets.", EXIT_CODES.LIMIT);
   if (code === "suppressed" || code === "suppressed_only") return new CliError("All requested records are suppressed.", EXIT_CODES.SUPPRESSED_ONLY);
+  if (code === "ai_key_required" || code === "ai_key_rejected") return new CliError(code === "ai_key_required" ? OWN_KEY_REQUIRED : OWN_KEY_REJECTED);
   if (code === "needs_approval") return new CliError("This operation needs approval.", EXIT_CODES.NEEDS_APPROVAL);
   if (code === "jobs_unavailable") return new CliError("Background jobs are not configured for this deployment.");
   if (code === "invalid_input") return new CliError("The API rejected the input. Check the command's filters and identifiers.");
@@ -28322,6 +28334,7 @@ var CliError, object2, ApiClient;
 var init_api2 = __esm({
   "src/api.ts"() {
     "use strict";
+    init_messages();
     init_src();
     init_zod();
     init_exit_codes();
@@ -28481,7 +28494,7 @@ async function checkCliVersion(input2) {
     }
   }
   if (!policy) return;
-  const upgrade = "npm install --global higherdata@latest";
+  const upgrade = "higherdata update";
   if (compareVersions(input2.version, policy.minCliVersion) < 0) throw new CliError(`HigherData CLI ${input2.version} is no longer supported; minimum is ${policy.minCliVersion}. Upgrade: ${upgrade}`);
   if (compareVersions(input2.version, policy.latestCliVersion) < 0) input2.warn(`HigherData CLI ${policy.latestCliVersion} is available. Upgrade: ${upgrade}
 `);
@@ -31926,7 +31939,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "higherdata",
-      version: "0.3.0",
+      version: "0.3.1",
       type: "module",
       bin: {
         higherdata: "dist/index.js"
@@ -36832,11 +36845,11 @@ function parseTree(text2, errors2 = [], options = ParseOptions.DEFAULT) {
       onValue({ type: getNodeType(value), offset, length, parent: currentParent, value });
       ensurePropertyComplete(offset + length);
     },
-    onSeparator: (sep, offset, length) => {
+    onSeparator: (sep2, offset, length) => {
       if (currentParent.type === "property") {
-        if (sep === ":") {
+        if (sep2 === ":") {
           currentParent.colonOffset = offset;
-        } else if (sep === ",") {
+        } else if (sep2 === ",") {
           ensurePropertyComplete(offset);
         }
       }
@@ -38079,6 +38092,7 @@ function recordFields(value, prefix = "") {
   if (!value || typeof value !== "object") return [[prefix || "Value", shownValue(value)]];
   return Object.entries(value).flatMap(([key, child]) => {
     if (internalCostKey(key) || child === void 0 || child === null && !["before", "after"].includes(key) || ["nextCursor", "requestId", "releaseId", "rawId", "warehouseId"].includes(key)) return [];
+    if (key === "aiMode") return [["AI key", { byok: "Own key", platform: "Platform", none: "Not configured" }[String(child)] ?? "Unavailable"]];
     const name = prefix ? `${prefix} / ${title(key)}` : title(key);
     if (Array.isArray(child) && child.some((item) => item && typeof item === "object")) return child.flatMap((item, i) => recordFields(item, `${name} ${i + 1}`));
     if (child && typeof child === "object" && !Array.isArray(child)) return recordFields(child, name);
@@ -39441,8 +39455,158 @@ function registerSuppressCommands(program2, helpers) {
 
 // src/commands.ts
 init_install();
+
+// src/update.ts
+init_zod();
+init_api2();
+init_version_policy();
+import { execFile as execFile3, spawn } from "child_process";
+import { realpath } from "fs/promises";
+import { isAbsolute, join as join4, sep } from "path";
+import { promisify as promisify2 } from "util";
+var NpmUpdateError = class extends Error {
+};
+function npmSummary(error63) {
+  const value = error63;
+  const lines = typeof value?.stderr === "string" ? value.stderr.split(/\r?\n/u) : [];
+  const line = lines.find((line2) => /^npm (?:error|ERR!) code [A-Z0-9_]+$/u.test(line2.trim())) ?? lines.find((line2) => /^npm (?:error|ERR!) (?:EACCES|EPERM|ENOENT|ETIMEDOUT)\b/u.test(line2.trim()));
+  return line?.trim().slice(0, 200) ?? (typeof value?.code === "string" && /^[A-Z0-9_]+$/u.test(value.code) ? value.code : "npm install failed");
+}
+function updateRuntime() {
+  return {
+    stdinTTY: Boolean(process.stdin.isTTY),
+    stdoutTTY: Boolean(process.stdout.isTTY),
+    script: process.argv[1] ?? "",
+    realpath,
+    async npm(args, env) {
+      try {
+        return (await promisify2(execFile3)("npm", args, { env, timeout: args[0] === "install" ? 12e4 : 1500, maxBuffer: 64 * 1024 })).stdout;
+      } catch (error63) {
+        throw new NpmUpdateError(npmSummary(error63));
+      }
+    },
+    rerun(script, args, env) {
+      return new Promise((resolve2, reject) => {
+        const child = spawn(process.execPath, [script, ...args], { env, stdio: "inherit" });
+        child.once("error", reject);
+        child.once("exit", (code, signal) => resolve2(code ?? (signal === "SIGINT" ? 130 : signal === "SIGTERM" ? 143 : 1)));
+      });
+    }
+  };
+}
+async function npmLatest(fetchImpl, timeoutMs = 3e3) {
+  try {
+    const response = await fetchImpl("https://registry.npmjs.org/higherdata/latest", { headers: { accept: "application/json" }, redirect: "error", signal: AbortSignal.timeout(timeoutMs) });
+    if (!response.ok || !response.body) {
+      await response.body?.cancel();
+      throw new Error();
+    }
+    const reader = response.body.getReader(), chunks = [];
+    let size = 0;
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        size += value.length;
+        if (size > 16384) {
+          await reader.cancel();
+          throw new Error();
+        }
+        chunks.push(value);
+      }
+    } finally {
+      reader.releaseLock();
+    }
+    return external_exports.object({ version: releaseVersion }).parse(JSON.parse(Buffer.concat(chunks).toString("utf8"))).version;
+  } catch {
+    throw new CliError("Could not check the npm release. Try higherdata update again.");
+  }
+}
+var installArgs = (version2) => ["install", "--global", `higherdata@${releaseVersion.parse(version2)}`];
+var manual = (version2) => `npm install --global higherdata@${releaseVersion.parse(version2)}`;
+async function updateCli(input2) {
+  const latest = await npmLatest(input2.fetchImpl);
+  if (compareVersions(input2.version, latest) >= 0) {
+    input2.out(`HigherData CLI ${input2.version} is up to date.
+`);
+    return;
+  }
+  try {
+    await input2.runtime.npm(installArgs(latest), input2.env);
+  } catch (error63) {
+    throw new CliError(`${error63 instanceof NpmUpdateError ? error63.message : "npm install failed"}. Run: ${manual(latest)}`);
+  }
+  input2.out(`Updated HigherData CLI ${input2.version} to ${latest}
+`);
+}
+function primaryCommand(args) {
+  for (let index = 0; index < args.length; index++) {
+    const arg = args[index];
+    if (["--api-url", "--idempotency-key"].includes(arg)) {
+      index++;
+      continue;
+    }
+    if (arg === "--") return args[index + 1];
+    if (!arg.startsWith("-")) return arg;
+  }
+}
+function interactiveUpdateAllowed(args, env, runtime) {
+  return runtime.stdinTTY && runtime.stdoutTTY && !Object.hasOwn(env, "CI") && !["mcp", "stdio"].includes(primaryCommand(args) ?? "") && !args.some((arg) => ["--json", "--jsonl", "--stdio", "--help", "-h", "--version", "-V"].includes(arg) || /^(--jsonl?|--stdio)=/u.test(arg));
+}
+async function possibleGlobalScript(runtime, env) {
+  try {
+    const script = await runtime.realpath(runtime.script);
+    if (script.split(sep).includes("_npx") || env.npm_command === "exec" || env.npm_lifecycle_event === "npx") return null;
+    return script.endsWith(`${sep}${join4("node_modules", "higherdata", "dist", "index.js")}`) ? script : null;
+  } catch {
+    return null;
+  }
+}
+async function globalScript(runtime, env, script) {
+  try {
+    const prefix = (await runtime.npm(["prefix", "-g"], env)).trim();
+    if (!isAbsolute(prefix)) return null;
+    const root = await runtime.realpath(prefix);
+    const expected = join4(root, process.platform === "win32" ? "node_modules" : "lib/node_modules", "higherdata", "dist/index.js");
+    return script === expected ? script : null;
+  } catch {
+    return null;
+  }
+}
+async function autoUpdate(input2) {
+  if (!interactiveUpdateAllowed(input2.args, input2.env, input2.runtime) || input2.env.HIGHERDATA_NO_AUTO_UPDATE === "1" || input2.env.HIGHERDATA_UPDATE_RERUN === "1" || ["update", "upgrade", "config"].includes(primaryCommand(input2.args) ?? "")) return null;
+  if ((await input2.readConfig()).autoUpdate === false) return null;
+  const candidate = await possibleGlobalScript(input2.runtime, input2.env);
+  if (!candidate) return null;
+  let latest = null;
+  try {
+    latest = await npmLatest(input2.fetchImpl, 1500);
+  } catch {
+    return null;
+  }
+  if (!latest || compareVersions(input2.version, latest) >= 0) return null;
+  const script = await globalScript(input2.runtime, input2.env, candidate);
+  if (!script) return null;
+  input2.warn(`Updating HigherData CLI to ${latest}...
+`);
+  try {
+    await input2.runtime.npm(installArgs(latest), input2.env);
+  } catch {
+    input2.warn(`Automatic update failed. Run: ${manual(latest)}
+`);
+    return null;
+  }
+  try {
+    return await input2.runtime.rerun(script, input2.args, { ...input2.env, HIGHERDATA_UPDATE_RERUN: "1" });
+  } catch {
+    input2.warn("Could not restart HigherData CLI. Run your command again.\n");
+    return 2;
+  }
+}
+
+// src/commands.ts
 function cliRuntime(overrides = {}) {
-  return { installation: installRuntime(), versionCache: fileVersionCache(), write: overrides.write ?? (overrides.out ? async (text2) => {
+  return { updater: updateRuntime(), installation: installRuntime(), versionCache: fileVersionCache(), write: overrides.write ?? (overrides.out ? async (text2) => {
     overrides.out(text2);
   } : (text2) => new Promise((resolve2, reject) => {
     process.stdout.write(text2, (error63) => error63 ? reject(error63) : resolve2());
@@ -39606,9 +39770,21 @@ function createProgram(overrides = {}) {
     } else program2.outputHelp();
   });
   program2.hook("preAction", async (_program, command) => {
-    if (command === program2 || command.name() === "login" || ["mcp", "skills"].includes(command.parent?.name() ?? "")) return;
+    if (["login", "update", "upgrade"].includes(command.name()) || ["mcp", "skills", "config"].includes(command.parent?.name() ?? "")) return;
+    if (command === program2 && (!runtime.updater.stdinTTY || !runtime.updater.stdoutTTY || Object.hasOwn(runtime.env, "CI") || program2.opts().json || program2.opts().jsonl)) return;
     const settings = resolveSettings(await runtime.readConfig(), command.optsWithGlobals(), runtime.env);
-    await checkCliVersion({ apiUrl: settings.apiUrl, version: package_default.version, cache: runtime.versionCache, fetchImpl: runtime.fetchImpl, now: runtime.now, warn: runtime.err });
+    const interactive = runtime.updater.stdinTTY && runtime.updater.stdoutTTY && !Object.hasOwn(runtime.env, "CI") && !command.optsWithGlobals().json && !command.optsWithGlobals().jsonl;
+    await checkCliVersion({ apiUrl: settings.apiUrl, version: package_default.version, cache: runtime.versionCache, fetchImpl: runtime.fetchImpl, now: runtime.now, warn: interactive ? runtime.err : () => {
+    } });
+  });
+  program2.command("update").alias("upgrade").description("Install the latest HigherData CLI release").action(() => updateCli({ version: package_default.version, fetchImpl: runtime.fetchImpl, runtime: runtime.updater, env: runtime.env, out: runtime.out }));
+  program2.command("config").description("Configure the CLI").command("set <key> <value>").action(async (key, value) => {
+    if (key !== "auto-update" || !["true", "false"].includes(value)) throw new CliError("Use higherdata config set auto-update true or false.");
+    const config2 = await runtime.readConfig();
+    config2.autoUpdate = value === "true";
+    await runtime.writeConfig(config2);
+    runtime.out(`Automatic updates ${config2.autoUpdate ? "enabled" : "disabled"}.
+`);
   });
   registerCommands(program2, runtime);
   registerToolCommands(program2, runtime);
@@ -39619,6 +39795,18 @@ async function runCli(args = process.argv.slice(2), overrides = {}) {
   const runtime = cliRuntime(overrides);
   const program2 = createProgram(runtime);
   try {
+    if (interactiveUpdateAllowed(args, runtime.env, runtime.updater)) {
+      const restarted = await autoUpdate({
+        args,
+        version: package_default.version,
+        env: runtime.env,
+        runtime: runtime.updater,
+        readConfig: runtime.readConfig,
+        fetchImpl: runtime.fetchImpl,
+        warn: runtime.err
+      });
+      if (restarted !== null) return restarted;
+    }
     await program2.parseAsync(args, { from: "user" });
     return EXIT_CODES.OK;
   } catch (error63) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "higherdata",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "type": "module",
   "bin": {
     "higherdata": "dist/index.js"