deepseek-tui 0.8.7 → 0.8.8

package/README.md

@@ -52,11 +52,18 @@ is `https://integrate.api.nvidia.com/v1`. With `--provider nvidia-nim`,
 
 ## Supported platforms
 
+Prebuilt binaries for the GitHub release are downloaded automatically:
+
 - Linux x64
+- Linux arm64 (v0.8.8+)
 - macOS x64 / arm64
 - Windows x64
 
-Other platform/architecture combinations are not supported and will fail during install.
+Other platform/architecture combinations (musl, riscv64, FreeBSD, …) aren't
+shipped as prebuilts. The `postinstall` will exit with a clear error pointing
+you at `cargo install deepseek-tui-cli deepseek-tui --locked` and the full
+[docs/INSTALL.md](https://github.com/Hmbown/DeepSeek-TUI/blob/main/docs/INSTALL.md)
+build-from-source guide.
 
 ## Configuration
 
@@ -65,6 +72,7 @@ Other platform/architecture combinations are not supported and will fail during
 - Set `DEEPSEEK_TUI_GITHUB_REPO` or `DEEPSEEK_GITHUB_REPO` to override the source repo (defaults to `Hmbown/DeepSeek-TUI`).
 - Set `DEEPSEEK_TUI_FORCE_DOWNLOAD=1` to force download even when the cached binary is already present.
 - Set `DEEPSEEK_TUI_DISABLE_INSTALL=1` to skip install-time download.
+- Set `DEEPSEEK_TUI_OPTIONAL_INSTALL=1` to make the `postinstall` step warn and exit `0` on download/extract errors instead of failing `npm install` (useful in CI matrices).
 
 ## Release integrity
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "deepseek-tui",
-  "version": "0.8.7",
-  "deepseekBinaryVersion": "0.8.7",
+  "version": "0.8.8",
+  "deepseekBinaryVersion": "0.8.8",
   "description": "Install and run deepseek and deepseek-tui binaries from GitHub release artifacts.",
   "author": "Hmbown",
   "license": "MIT",

package/scripts/artifacts.js

@@ -6,7 +6,7 @@ const CHECKSUM_MANIFEST = "deepseek-artifacts-sha256.txt";
 const ASSET_MATRIX = {
   linux: {
     x64: ["deepseek-linux-x64", "deepseek-tui-linux-x64"],
-    // arm64: ["deepseek-linux-arm64", "deepseek-tui-linux-arm64"], // Uncomment when binaries are available
+    arm64: ["deepseek-linux-arm64", "deepseek-tui-linux-arm64"],
   },
   darwin: {
     x64: ["deepseek-macos-x64", "deepseek-tui-macos-x64"],
@@ -23,12 +23,19 @@ function detectBinaryNames() {
   const defaults = ASSET_MATRIX[platform];
   if (!defaults) {
     const supported = Object.keys(ASSET_MATRIX).map(p => `'${p}'`).join(', ');
-    throw new Error(`Unsupported platform: ${platform}. Supported platforms: ${supported}`);
+    throw new Error(
+      `Unsupported platform: ${platform}. Supported platforms: ${supported}.\n\n` +
+      unsupportedBuildHint(),
+    );
   }
   const pair = defaults[arch];
   if (!pair) {
     const supported = Object.keys(defaults).map(a => `'${a}'`).join(', ');
-    throw new Error(`Unsupported architecture: ${arch} on platform ${platform}. Supported architectures: ${supported}`);
+    throw new Error(
+      `Unsupported architecture: ${arch} on platform ${platform}. ` +
+      `Supported architectures: ${supported}.\n\n` +
+      unsupportedBuildHint(),
+    );
   }
   return {
     platform,
@@ -38,6 +45,27 @@ function detectBinaryNames() {
   };
 }
 
+function unsupportedBuildHint() {
+  return [
+    "No prebuilt binary is available for this platform/architecture combo.",
+    "You can still run DeepSeek TUI by building from source with Cargo:",
+    "",
+    "  # Requires Rust 1.85+ (https://rustup.rs)",
+    "  cargo install deepseek-tui-cli --locked   # provides `deepseek`",
+    "  cargo install deepseek-tui     --locked   # provides `deepseek-tui`",
+    "",
+    "Or build from a checkout:",
+    "",
+    "  git clone https://github.com/Hmbown/DeepSeek-TUI.git",
+    "  cd DeepSeek-TUI",
+    "  cargo install --path crates/cli --locked",
+    "  cargo install --path crates/tui --locked",
+    "",
+    "See https://github.com/Hmbown/DeepSeek-TUI/blob/main/docs/INSTALL.md",
+    "for cross-compilation, mirror, and Linux ARM64 specifics.",
+  ].join("\n");
+}
+
 function executableName(base, platform) {
   return platform === "win32" ? `${base}.exe` : base;
 }

package/scripts/install.js

@@ -210,6 +210,12 @@ module.exports = {
 if (require.main === module) {
   run().catch((error) => {
     console.error("deepseek-tui install failed:", error.message);
+    if (process.env.DEEPSEEK_TUI_OPTIONAL_INSTALL === "1") {
+      console.error(
+        "DEEPSEEK_TUI_OPTIONAL_INSTALL=1 set; continuing without a usable binary.",
+      );
+      process.exit(0);
+    }
     process.exit(1);
   });
 }