helpofai 0.8.68 → 0.8.69

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "helpofai",
-  "version": "0.8.68",
-  "helpofaiBinaryVersion": "0.8.68",
+  "version": "0.8.69",
+  "helpofaiBinaryVersion": "0.8.69",
   "description": "Install and run HelpOfAi, the agentic terminal for open-source and open-weight coding models, from GitHub release artifacts.",
   "author": "helpofai",
   "license": "MIT",

package/scripts/artifacts.js

@@ -80,10 +80,10 @@ function executableName(base, platform) {
 
 function releaseBaseUrl(version, repo = "helpofai/HelpOfAi-Cli") {
   // HELPOFAI_RELEASE_BASE_URL is the canonical override.
-  // DEEPSEEK_TUI_RELEASE_BASE_URL / DEEPSEEK_RELEASE_BASE_URL are legacy aliases.
+  // HELPOFAI_RELEASE_BASE_URL / DEEPSEEK_RELEASE_BASE_URL are legacy aliases.
   const override =
     process.env.HELPOFAI_RELEASE_BASE_URL ||
-    process.env.DEEPSEEK_TUI_RELEASE_BASE_URL ||
+    process.env.HELPOFAI_RELEASE_BASE_URL ||
     process.env.DEEPSEEK_RELEASE_BASE_URL;
   if (override) {
     const trimmed = String(override).trim();
@@ -134,3 +134,4 @@ module.exports = {
   releaseBaseUrl,
   releaseBinaryDirectory,
 };
+

package/scripts/install.js

@@ -80,7 +80,7 @@ class DownloadTimeoutError extends Error {
 
 function resolvePackageVersion() {
   const configuredVersion =
-    process.env.DEEPSEEK_TUI_VERSION ||
+    process.env.HELPOFAI_VERSION ||
     process.env.DEEPSEEK_VERSION ||
     pkg.deepseekBinaryVersion ||
     pkg.version;
@@ -88,13 +88,13 @@ function resolvePackageVersion() {
 }
 
 function resolveRepo() {
-  return process.env.DEEPSEEK_TUI_GITHUB_REPO || process.env.DEEPSEEK_GITHUB_REPO || "helpofai/HelpOfAi-Cli";
+  return process.env.HELPOFAI_GITHUB_REPO || process.env.DEEPSEEK_GITHUB_REPO || "helpofai/HelpOfAi-Cli";
 }
 
 function isOptionalInstall(argv = process.argv.slice(2), env = process.env) {
   return (
     argv.includes("--optional") ||
-    env.DEEPSEEK_TUI_OPTIONAL_INSTALL === "1" ||
+    env.HELPOFAI_OPTIONAL_INSTALL === "1" ||
     env.DEEPSEEK_OPTIONAL_INSTALL === "1"
   );
 }
@@ -155,7 +155,7 @@ function binaryPaths() {
 // ────────────────────────────────────────────────────────────────────────────
 
 function isQuietInstall() {
-  if (process.env.DEEPSEEK_TUI_QUIET_INSTALL === "1") {
+  if (process.env.HELPOFAI_QUIET_INSTALL === "1") {
     return true;
   }
   const level = (process.env.npm_config_loglevel || "").toLowerCase();
@@ -173,7 +173,7 @@ function installFailureHint(error) {
   const message = error && error.message ? String(error.message) : "";
   const code = error && error.code ? String(error.code) : "";
   const releaseBase =
-    process.env.DEEPSEEK_TUI_RELEASE_BASE_URL ||
+    process.env.HELPOFAI_RELEASE_BASE_URL ||
     process.env.DEEPSEEK_RELEASE_BASE_URL;
   const networkMarkers = [
     "github.com",
@@ -195,7 +195,7 @@ function installFailureHint(error) {
   if (releaseBase) {
     return [
       "helpofai install hint:",
-      `  DEEPSEEK_TUI_RELEASE_BASE_URL is set to ${releaseBase}`,
+      `  HELPOFAI_RELEASE_BASE_URL is set to ${releaseBase}`,
       "  Verify that this directory contains helpofai-artifacts-sha256.txt",
       "  plus the helpofai/helpofai-tui binary assets for your platform.",
     ].join("\n");
@@ -205,7 +205,7 @@ function installFailureHint(error) {
     "helpofai install hint:",
     "  The npm package downloads prebuilt binaries from GitHub Releases.",
     "  If GitHub is unavailable on this network, mirror the release assets and set:",
-    "    DEEPSEEK_TUI_RELEASE_BASE_URL=https://<mirror>/<release-asset-directory>/",
+    "    HELPOFAI_RELEASE_BASE_URL=https://<mirror>/<release-asset-directory>/",
     "  The directory must contain helpofai-artifacts-sha256.txt and the platform binaries.",
     "  See docs/INSTALL.md#npm-binary-download-times-out.",
   ].join("\n");
@@ -225,14 +225,14 @@ function envInt(name, fallback) {
 
 function downloadTimeoutMs(context = "runtime") {
   return envInt(
-    "DEEPSEEK_TUI_DOWNLOAD_TIMEOUT_MS",
+    "HELPOFAI_DOWNLOAD_TIMEOUT_MS",
     envInt("DEEPSEEK_DOWNLOAD_TIMEOUT_MS", defaultTimeoutMs(context)),
   );
 }
 
 function downloadStallMs(context = "runtime") {
   return envInt(
-    "DEEPSEEK_TUI_DOWNLOAD_STALL_MS",
+    "HELPOFAI_DOWNLOAD_STALL_MS",
     envInt("DEEPSEEK_DOWNLOAD_STALL_MS", defaultStallMs(context)),
   );
 }
@@ -531,7 +531,7 @@ function httpRequest(rawUrl, opts = {}) {
       totalTimer = setTimeout(() => {
         fail(new DownloadTimeoutError(
           `download exceeded total timeout of ${totalTimeoutMs} ms ` +
-          `(set DEEPSEEK_TUI_DOWNLOAD_TIMEOUT_MS to raise it; current stall budget is ${stallMs} ms)`,
+          `(set HELPOFAI_DOWNLOAD_TIMEOUT_MS to raise it; current stall budget is ${stallMs} ms)`,
         ));
       }, totalTimeoutMs);
     }
@@ -542,7 +542,7 @@ function httpRequest(rawUrl, opts = {}) {
       stallTimer = setTimeout(() => {
         fail(new DownloadTimeoutError(
           `download stalled — no bytes received for ${stallMs} ms ` +
-          `(set DEEPSEEK_TUI_DOWNLOAD_STALL_MS to raise it; total budget is ${totalTimeoutMs} ms)`,
+          `(set HELPOFAI_DOWNLOAD_STALL_MS to raise it; total budget is ${totalTimeoutMs} ms)`,
         ));
       }, stallMs);
     };
@@ -1055,7 +1055,7 @@ async function adoptExistingBinaryIfValid(targetPath, assetName, version, getChe
 async function ensureBinary(targetPath, assetName, version, repo, getChecksums, options = {}) {
   const marker = `${targetPath}.version`;
   const downloadIfNeeded =
-    process.env.DEEPSEEK_TUI_FORCE_DOWNLOAD === "1" || process.env.DEEPSEEK_FORCE_DOWNLOAD === "1";
+    process.env.HELPOFAI_FORCE_DOWNLOAD === "1" || process.env.DEEPSEEK_FORCE_DOWNLOAD === "1";
   if (!downloadIfNeeded) {
     const existing = await fileExists(targetPath);
     if (existing) {
@@ -1106,7 +1106,7 @@ function shouldIgnoreInstallFailure(
 async function run(options = {}) {
   const context =
     options.context === undefined || options.context === null ? "runtime" : options.context;
-  if (process.env.DEEPSEEK_TUI_DISABLE_INSTALL === "1" || process.env.DEEPSEEK_DISABLE_INSTALL === "1") {
+  if (process.env.HELPOFAI_DISABLE_INSTALL === "1" || process.env.DEEPSEEK_DISABLE_INSTALL === "1") {
     return;
   }
   if (shouldSkipOptionalPostinstall(context)) {
@@ -1179,4 +1179,4 @@ if (require.main === module) {
     }
     process.exit(1);
   });
-}
+}

package/scripts/preflight-glibc.js

@@ -86,7 +86,6 @@ function buildFromSourceHint() {
 function skipGlibcCheck() {
   return (
     process.env.HELPOFAI_SKIP_GLIBC_CHECK === "1" ||
-    process.env.DEEPSEEK_TUI_SKIP_GLIBC_CHECK === "1" ||
     process.env.DEEPSEEK_SKIP_GLIBC_CHECK === "1"
   );
 }
@@ -145,3 +144,5 @@ module.exports = {
     skipGlibcCheck,
   },
 };
+
+

package/scripts/run.js

@@ -69,3 +69,4 @@ if (require.main === module) {
     runHelpOfAi();
   }
 }
+

package/scripts/verify-release-assets.js

@@ -11,7 +11,7 @@ const pkg = require("../package.json");
 
 function resolveBinaryVersion() {
   const configuredVersion =
-    process.env.DEEPSEEK_TUI_VERSION ||
+    process.env.HELPOFAI_VERSION ||
     process.env.DEEPSEEK_VERSION ||
     pkg.helpofaiBinaryVersion || pkg.deepseekBinaryVersion ||
     pkg.version;
@@ -19,7 +19,7 @@ function resolveBinaryVersion() {
 }
 
 function resolveRepo() {
-  return process.env.DEEPSEEK_TUI_GITHUB_REPO || process.env.DEEPSEEK_GITHUB_REPO || "helpofai/HelpOfAi-Cli";
+  return process.env.HELPOFAI_GITHUB_REPO || process.env.DEEPSEEK_GITHUB_REPO || "helpofai/HelpOfAi-Cli";
 }
 
 function requestStatus(url, method = "HEAD", redirects = 0) {
@@ -138,3 +138,4 @@ run().catch((error) => {
   console.error("Release asset verification failed:", error.message);
   process.exit(1);
 });
+

package/test/artifacts.test.js

@@ -74,3 +74,4 @@ test("allAssetNames includes every matrix entry", () => {
   assert.ok(assetNames.includes("helpofai.bat"));
   assert.ok(allReleaseAssetNames().includes("helpofai.bat"));
 });
+

package/test/install.test.js

@@ -30,17 +30,17 @@ async function exists(file) {
 }
 
 async function withoutForcedDownload(callback) {
-  const previousTui = process.env.DEEPSEEK_TUI_FORCE_DOWNLOAD;
+  const previousTui = process.env.HELPOFAI_FORCE_DOWNLOAD;
   const previousLegacy = process.env.DEEPSEEK_FORCE_DOWNLOAD;
-  delete process.env.DEEPSEEK_TUI_FORCE_DOWNLOAD;
+  delete process.env.HELPOFAI_FORCE_DOWNLOAD;
   delete process.env.DEEPSEEK_FORCE_DOWNLOAD;
   try {
     return await callback();
   } finally {
     if (previousTui === undefined) {
-      delete process.env.DEEPSEEK_TUI_FORCE_DOWNLOAD;
+      delete process.env.HELPOFAI_FORCE_DOWNLOAD;
     } else {
-      process.env.DEEPSEEK_TUI_FORCE_DOWNLOAD = previousTui;
+      process.env.HELPOFAI_FORCE_DOWNLOAD = previousTui;
     }
     if (previousLegacy === undefined) {
       delete process.env.DEEPSEEK_FORCE_DOWNLOAD;
@@ -65,8 +65,8 @@ test("install script remains parseable before the Node support guard runs", () =
 });
 
 test("install failure hint explains release base override for blocked GitHub downloads", () => {
-  const previous = process.env.DEEPSEEK_TUI_RELEASE_BASE_URL;
-  delete process.env.DEEPSEEK_TUI_RELEASE_BASE_URL;
+  const previous = process.env.HELPOFAI_RELEASE_BASE_URL;
+  delete process.env.HELPOFAI_RELEASE_BASE_URL;
   try {
     const error = Object.assign(
       new Error(
@@ -77,22 +77,22 @@ test("install failure hint explains release base override for blocked GitHub dow
 
     const hint = installFailureHint(error);
 
-    assert.match(hint, /DEEPSEEK_TUI_RELEASE_BASE_URL/);
+    assert.match(hint, /HELPOFAI_RELEASE_BASE_URL/);
     assert.match(hint, /helpofai-artifacts-sha256\.txt/);
     assert.match(hint, /platform binaries/);
     assert.match(hint, /#npm-binary-download-times-out/);
   } finally {
     if (previous === undefined) {
-      delete process.env.DEEPSEEK_TUI_RELEASE_BASE_URL;
+      delete process.env.HELPOFAI_RELEASE_BASE_URL;
     } else {
-      process.env.DEEPSEEK_TUI_RELEASE_BASE_URL = previous;
+      process.env.HELPOFAI_RELEASE_BASE_URL = previous;
     }
   }
 });
 
 test("install failure hint checks configured release base when override is already set", () => {
-  const previous = process.env.DEEPSEEK_TUI_RELEASE_BASE_URL;
-  process.env.DEEPSEEK_TUI_RELEASE_BASE_URL = "https://mirror.example/deepseek/";
+  const previous = process.env.HELPOFAI_RELEASE_BASE_URL;
+  process.env.HELPOFAI_RELEASE_BASE_URL = "https://mirror.example/deepseek/";
   try {
     const error = Object.assign(new Error("download stalled"), {
       code: "EDOWNLOADTIMEOUT",
@@ -105,9 +105,9 @@ test("install failure hint checks configured release base when override is alrea
     assert.doesNotMatch(hint, /If GitHub is unavailable/);
   } finally {
     if (previous === undefined) {
-      delete process.env.DEEPSEEK_TUI_RELEASE_BASE_URL;
+      delete process.env.HELPOFAI_RELEASE_BASE_URL;
     } else {
-      process.env.DEEPSEEK_TUI_RELEASE_BASE_URL = previous;
+      process.env.HELPOFAI_RELEASE_BASE_URL = previous;
     }
   }
 });
@@ -124,17 +124,17 @@ test("glibc preflight message is HelpOfAi-branded and actionable", () => {
 
 test("glibc preflight accepts canonical and legacy skip env vars", () => {
   const previousCodewhale = process.env.HELPOFAI_SKIP_GLIBC_CHECK;
-  const previousTui = process.env.DEEPSEEK_TUI_SKIP_GLIBC_CHECK;
+  const previousTui = process.env.HELPOFAI_SKIP_GLIBC_CHECK;
   const previousLegacy = process.env.DEEPSEEK_SKIP_GLIBC_CHECK;
   delete process.env.HELPOFAI_SKIP_GLIBC_CHECK;
-  delete process.env.DEEPSEEK_TUI_SKIP_GLIBC_CHECK;
+  delete process.env.HELPOFAI_SKIP_GLIBC_CHECK;
   delete process.env.DEEPSEEK_SKIP_GLIBC_CHECK;
   try {
     assert.equal(glibcInternal.skipGlibcCheck(), false);
     process.env.HELPOFAI_SKIP_GLIBC_CHECK = "1";
     assert.equal(glibcInternal.skipGlibcCheck(), true);
     delete process.env.HELPOFAI_SKIP_GLIBC_CHECK;
-    process.env.DEEPSEEK_TUI_SKIP_GLIBC_CHECK = "1";
+    process.env.HELPOFAI_SKIP_GLIBC_CHECK = "1";
     assert.equal(glibcInternal.skipGlibcCheck(), true);
   } finally {
     if (previousCodewhale === undefined) {
@@ -143,9 +143,9 @@ test("glibc preflight accepts canonical and legacy skip env vars", () => {
       process.env.HELPOFAI_SKIP_GLIBC_CHECK = previousCodewhale;
     }
     if (previousTui === undefined) {
-      delete process.env.DEEPSEEK_TUI_SKIP_GLIBC_CHECK;
+      delete process.env.HELPOFAI_SKIP_GLIBC_CHECK;
     } else {
-      process.env.DEEPSEEK_TUI_SKIP_GLIBC_CHECK = previousTui;
+      process.env.HELPOFAI_SKIP_GLIBC_CHECK = previousTui;
     }
     if (previousLegacy === undefined) {
       delete process.env.DEEPSEEK_SKIP_GLIBC_CHECK;
@@ -222,3 +222,4 @@ test("manual binaries with mismatched checksums are not adopted", async (t) => {
   assert.equal(adopted, false);
   assert.equal(await exists(`${target}.version`), false);
 });
+

package/test/postinstall.test.js

@@ -11,17 +11,17 @@ test("postinstall opts into optional install mode", () => {
 test("optional install can be enabled by command-line flag or env", () => {
   assert.equal(_internal.isOptionalInstall(["--optional"], {}), true);
   assert.equal(_internal.isOptionalInstall([], {}), false);
-  assert.equal(_internal.isOptionalInstall([], { DEEPSEEK_TUI_OPTIONAL_INSTALL: "1" }), true);
+  assert.equal(_internal.isOptionalInstall([], { HELPOFAI_OPTIONAL_INSTALL: "1" }), true);
   assert.equal(_internal.isOptionalInstall([], { DEEPSEEK_OPTIONAL_INSTALL: "1" }), true);
 });
 
 test("optional mode only changes install-time defaults", () => {
-  assert.equal(_internal.maxAttempts("install", { DEEPSEEK_TUI_OPTIONAL_INSTALL: "1" }), 1);
-  assert.equal(_internal.maxAttempts("runtime", { DEEPSEEK_TUI_OPTIONAL_INSTALL: "1" }), 5);
-  assert.equal(_internal.defaultTimeoutMs("install", { DEEPSEEK_TUI_OPTIONAL_INSTALL: "1" }), 15_000);
-  assert.equal(_internal.defaultTimeoutMs("runtime", { DEEPSEEK_TUI_OPTIONAL_INSTALL: "1" }), 300_000);
-  assert.equal(_internal.defaultStallMs("install", { DEEPSEEK_TUI_OPTIONAL_INSTALL: "1" }), 5_000);
-  assert.equal(_internal.defaultStallMs("runtime", { DEEPSEEK_TUI_OPTIONAL_INSTALL: "1" }), 30_000);
+  assert.equal(_internal.maxAttempts("install", { HELPOFAI_OPTIONAL_INSTALL: "1" }), 1);
+  assert.equal(_internal.maxAttempts("runtime", { HELPOFAI_OPTIONAL_INSTALL: "1" }), 5);
+  assert.equal(_internal.defaultTimeoutMs("install", { HELPOFAI_OPTIONAL_INSTALL: "1" }), 15_000);
+  assert.equal(_internal.defaultTimeoutMs("runtime", { HELPOFAI_OPTIONAL_INSTALL: "1" }), 300_000);
+  assert.equal(_internal.defaultStallMs("install", { HELPOFAI_OPTIONAL_INSTALL: "1" }), 5_000);
+  assert.equal(_internal.defaultStallMs("runtime", { HELPOFAI_OPTIONAL_INSTALL: "1" }), 30_000);
 });
 
 test("pnpm optional postinstall skips install-time download", () => {
@@ -87,8 +87,8 @@ test("optional install only swallows retryable download failures", () => {
 });
 
 test("optional install still swallows wrapped http 5xx failures", async () => {
-  const previous = process.env.DEEPSEEK_TUI_OPTIONAL_INSTALL;
-  process.env.DEEPSEEK_TUI_OPTIONAL_INSTALL = "1";
+  const previous = process.env.HELPOFAI_OPTIONAL_INSTALL;
+  process.env.HELPOFAI_OPTIONAL_INSTALL = "1";
   const http5xx = new Error("Request failed with status 502: https://example.invalid");
   http5xx.name = "HttpStatusError";
   http5xx.status = 502;
@@ -110,9 +110,9 @@ test("optional install still swallows wrapped http 5xx failures", async () => {
     );
   } finally {
     if (previous === undefined) {
-      delete process.env.DEEPSEEK_TUI_OPTIONAL_INSTALL;
+      delete process.env.HELPOFAI_OPTIONAL_INSTALL;
     } else {
-      process.env.DEEPSEEK_TUI_OPTIONAL_INSTALL = previous;
+      process.env.HELPOFAI_OPTIONAL_INSTALL = previous;
     }
   }
 });
@@ -155,3 +155,4 @@ test("withRetry prints install hint on first retryable failure", async () => {
     global.setTimeout = previousSetTimeout;
   }
 });
+

package/test/run.test.js

@@ -59,3 +59,4 @@ test("version flags fall back to package metadata when the binary is unavailable
   assert.match(lines.join("\n"), /helpofai \(npm wrapper\) v/);
   assert.match(lines.join("\n"), /binary version: v/);
 });
+