@tuned-tensor/cli 0.10.0 → 0.11.0

package/README.md

@@ -63,6 +63,11 @@ Selection metadata can be overridden per process with
 After configuration, run `tt` to open one terminal for conversation and
 commands:
 
+Before the shell opens, `tt` performs a short, non-blocking npm version check.
+If a newer stable release is available it recommends
+`npm install -g @tuned-tensor/cli@latest`; offline or unavailable registry
+checks are ignored.
+
 ```text
 tt cloud support-agent › What happened in my latest training run?
 TT  Your latest run completed...

package/dist/index.js

@@ -8213,6 +8213,95 @@ function registerPipelineCommands(parent) {
   });
 }
 
+// src/update-check.ts
+var PACKAGE_LATEST_URL = "https://registry.npmjs.org/@tuned-tensor%2fcli/latest";
+function parseVersion(version) {
+  const match = version.trim().match(
+    /^v?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/
+  );
+  if (!match) return null;
+  const prerelease = match[4]?.split(".") ?? [];
+  if (prerelease.some((part) => /^0\d+$/.test(part))) return null;
+  return {
+    major: BigInt(match[1]),
+    minor: BigInt(match[2]),
+    patch: BigInt(match[3]),
+    prerelease
+  };
+}
+function comparePrerelease(left, right) {
+  if (left.length === 0 && right.length === 0) return 0;
+  if (left.length === 0) return 1;
+  if (right.length === 0) return -1;
+  for (let index = 0; index < Math.max(left.length, right.length); index += 1) {
+    const leftPart = left[index];
+    const rightPart = right[index];
+    if (leftPart === void 0) return -1;
+    if (rightPart === void 0) return 1;
+    if (leftPart === rightPart) continue;
+    const leftNumeric = /^\d+$/.test(leftPart);
+    const rightNumeric = /^\d+$/.test(rightPart);
+    if (leftNumeric && rightNumeric) {
+      if (leftPart.length !== rightPart.length) {
+        return leftPart.length > rightPart.length ? 1 : -1;
+      }
+      return leftPart > rightPart ? 1 : -1;
+    }
+    if (leftNumeric !== rightNumeric) return leftNumeric ? -1 : 1;
+    return leftPart > rightPart ? 1 : -1;
+  }
+  return 0;
+}
+function compareVersions(left, right) {
+  for (const key of ["major", "minor", "patch"]) {
+    if (left[key] !== right[key]) return left[key] > right[key] ? 1 : -1;
+  }
+  return comparePrerelease(left.prerelease, right.prerelease);
+}
+async function checkForCliUpdate(currentVersion, options = {}) {
+  const current = parseVersion(currentVersion);
+  if (!current) return null;
+  const controller = new AbortController();
+  const timeoutMs = options.timeoutMs ?? 750;
+  let timeout;
+  const request2 = (async () => {
+    try {
+      const response = await (options.fetchImpl ?? fetch)(PACKAGE_LATEST_URL, {
+        headers: { accept: "application/json" },
+        signal: controller.signal
+      });
+      if (!response.ok) return null;
+      const payload = await response.json();
+      if (typeof payload.version !== "string") return null;
+      const latest = parseVersion(payload.version);
+      if (!latest || latest.prerelease.length > 0 || compareVersions(latest, current) <= 0) return null;
+      return {
+        currentVersion,
+        latestVersion: payload.version
+      };
+    } catch {
+      return null;
+    }
+  })();
+  const deadline = new Promise((resolve8) => {
+    timeout = setTimeout(() => {
+      controller.abort();
+      resolve8(null);
+    }, timeoutMs);
+  });
+  try {
+    return await Promise.race([request2, deadline]);
+  } finally {
+    if (timeout) clearTimeout(timeout);
+  }
+}
+function formatCliUpdateNotice(update) {
+  return [
+    `Update available: tt ${update.currentVersion} \u2192 ${update.latestVersion}`,
+    "Upgrade with: npm install -g @tuned-tensor/cli@latest"
+  ].join("\n");
+}
+
 // src/cli.ts
 async function createDefaultAgentClient(runtime, env, cloud, workspaceRoot) {
   const selection = getAgentSelection(env);
@@ -8543,9 +8632,19 @@ async function runCli(version, runtime = {}) {
     stdoutIsTTY: runtime.stdoutIsTTY ?? process.stdout.isTTY,
     env
   })) {
-    const invokeSelf = runtime.runSelfCommand ?? runSelfCommand;
     const output = runtime.stdout ?? process.stdout;
     const error = runtime.stderr ?? process.stderr;
+    let update = null;
+    try {
+      update = await (runtime.checkForUpdate ?? checkForCliUpdate)(version);
+    } catch {
+    }
+    if (update) {
+      error.write(`${formatCliUpdateNotice(update)}
+
+`);
+    }
+    const invokeSelf = runtime.runSelfCommand ?? runSelfCommand;
     const agent = createShellAgent({
       client: runtime.agentClient ?? createLazyDefaultAgentClient(runtime, env, {
         apiKey: env.TUNED_TENSOR_API_KEY,
@@ -8578,7 +8677,7 @@ async function runCli(version, runtime = {}) {
 }
 
 // src/index.ts
-runCli("0.10.0").catch((err) => {
+runCli("0.11.0").catch((err) => {
   reportError(err);
   process.exit(1);
 });