@mcptoolshop/backpropagate 1.2.0 → 1.4.0

package/bin/backpropagate.js

@@ -1,204 +1,55 @@
 #!/usr/bin/env node
 "use strict";
 
-const { spawnSync } = require("child_process");
-const path = require("path");
-const fs = require("fs");
-const os = require("os");
-
 // ---------------------------------------------------------------------------
-// Linux: bootstrap a private venv and run backpropagate from PyPI.
+// npm distribution of backpropagate is deprecated as of v1.3.
 //
-// PyTorch's libtorch_cpu.so is ~1.5 GB on x86_64 Linux. A PyInstaller
-// --onefile binary lands at 4.16 GB — 2x GitHub's release asset limit.
-// macOS/Windows don't hit this because Accelerate is system-provided and
-// Windows torch is smaller.
+// History: v1.0–v1.2 shipped PyInstaller binaries from a GitHub Release,
+// pulled via @mcptoolshop/npm-launcher. Linux bootstrapped a managed venv
+// instead because libtorch_cpu.so blew past GitHub's 2GB release-asset cap.
+// The binary build pipeline failed three consecutive times in v1.2.0 and the
+// release tag has zero attached assets — the launcher would 404 on download.
 //
-// Instead of shipping a broken giant binary, we bootstrap a managed venv
-// on first run and exec the pip-installed CLI from there.
-// ---------------------------------------------------------------------------
-
-const TOOL = "backpropagate";
-const VERSION = "1.2.0";
-
-if (process.platform === "linux") {
-  // XDG-compliant install root
-  const dataHome = process.env.XDG_DATA_HOME
-    || path.join(os.homedir(), ".local", "share");
-  const installRoot = process.env.BACKPROPAGATE_BOOTSTRAP_ROOT
-    || path.join(dataHome, TOOL);
-  const venvDir = path.join(installRoot, "venv");
-  const metaPath = path.join(installRoot, "install.json");
-  const venvBin = path.join(venvDir, "bin", TOOL);
-  const venvPython = path.join(venvDir, "bin", "python3");
-
-  // -- helpers --------------------------------------------------------------
-
-  function findPython() {
-    // Prefer python3, fall back to python (if it's 3.x)
-    for (const cmd of ["python3", "python"]) {
-      const r = spawnSync(cmd, ["--version"], {
-        encoding: "utf8",
-        stdio: ["ignore", "pipe", "pipe"],
-      });
-      if (r.status === 0) {
-        const ver = (r.stdout || r.stderr || "").trim();
-        const match = ver.match(/Python\s+(\d+)\.(\d+)/);
-        if (match && parseInt(match[1], 10) >= 3 && parseInt(match[2], 10) >= 10) {
-          return cmd;
-        }
-      }
-    }
-    return null;
-  }
-
-  function readMeta() {
-    try {
-      return JSON.parse(fs.readFileSync(metaPath, "utf8"));
-    } catch {
-      return null;
-    }
-  }
-
-  function writeMeta(obj) {
-    fs.mkdirSync(installRoot, { recursive: true });
-    fs.writeFileSync(metaPath, JSON.stringify(obj, null, 2) + "\n");
-  }
-
-  function fail(message, hint) {
-    process.stderr.write(`\n${TOOL}: ${message}\n`);
-    if (hint) process.stderr.write(`\n${hint}\n`);
-    process.stderr.write("\n");
-    process.exit(1);
-  }
-
-  // -- bootstrap ------------------------------------------------------------
-
-  function bootstrap() {
-    const forceReinstall = process.env.BACKPROPAGATE_FORCE_REINSTALL === "1";
-    const meta = readMeta();
-
-    const versionMatch = meta && meta.version === VERSION;
-    const binaryPresent = fs.existsSync(venvBin);
-
-    if (versionMatch && binaryPresent && !forceReinstall) {
-      return; // fast path — venv exists, version matches, no forced reinstall
-    }
-
-    // Decide what to tell the user
-    if (forceReinstall) {
-      process.stderr.write(`Forced reinstall requested (BACKPROPAGATE_FORCE_REINSTALL=1).\n`);
-    } else if (meta && !versionMatch) {
-      process.stderr.write(
-        `Updating ${TOOL}: ${meta.version} -> ${VERSION}\n`
-      );
-    } else if (meta && !binaryPresent) {
-      process.stderr.write(
-        `Repairing ${TOOL}: binary missing, reinstalling ${VERSION}...\n`
-      );
-    }
-
-    // Find system Python
-    const python = findPython();
-    if (!python) {
-      fail(
-        "Python 3.10+ is required but not found.",
-        "Install Python and try again:\n" +
-        "  Ubuntu/Debian:  sudo apt install python3 python3-venv\n" +
-        "  Fedora/RHEL:    sudo dnf install python3\n" +
-        "  Arch:           sudo pacman -S python\n" +
-        "  Or use pyenv:   https://github.com/pyenv/pyenv"
-      );
-    }
-
-    // Recreate venv on force-reinstall (nuke corrupted state)
-    if (forceReinstall && fs.existsSync(venvDir)) {
-      process.stderr.write("Removing existing venv...\n");
-      fs.rmSync(venvDir, { recursive: true, force: true });
-    }
-
-    // Create venv if missing
-    if (!fs.existsSync(venvPython)) {
-      if (!meta) {
-        process.stderr.write(
-          `First run on Linux: setting up local Python environment for ${TOOL}...\n`
-        );
-      }
-      fs.mkdirSync(installRoot, { recursive: true });
-      const venvResult = spawnSync(python, ["-m", "venv", venvDir], {
-        stdio: "inherit",
-      });
-      if (venvResult.status !== 0) {
-        fail(
-          "Failed to create Python virtual environment.",
-          "The venv module may be missing. Try:\n" +
-          "  Ubuntu/Debian:  sudo apt install python3-venv\n" +
-          "  Fedora/RHEL:    sudo dnf install python3-libs"
-        );
-      }
-    }
-
-    // Install or upgrade backpropagate
-    // --force-reinstall needed for repair (binary missing but pip metadata intact)
-    // and force-reinstall (nuked venv rebuilt). Without it, pip sees the same
-    // version in metadata and skips recreating the entrypoint script.
-    const needsForce = !binaryPresent || forceReinstall;
-    const pipArgs = ["-m", "pip", "install", "--quiet", "--upgrade"];
-    if (needsForce) pipArgs.push("--force-reinstall");
-    pipArgs.push(`${TOOL}==${VERSION}`);
-
-    process.stderr.write(`Installing ${TOOL} ${VERSION}${needsForce ? " (force)" : ""}...\n`);
-    const pipResult = spawnSync(venvPython, pipArgs, { stdio: "inherit" });
-    if (pipResult.status !== 0) {
-      fail(
-        `pip install failed (exit ${pipResult.status}).`,
-        "Check your network connection and try again.\n" +
-        "You can also install manually:\n" +
-        `  pip install ${TOOL}==${VERSION}`
-      );
-    }
-
-    // Verify the binary actually exists after install
-    if (!fs.existsSync(venvBin)) {
-      fail(
-        `Installation completed but ${TOOL} binary not found at expected path.`,
-        `Expected: ${venvBin}\n` +
-        "Try installing manually:\n" +
-        `  pipx install ${TOOL}`
-      );
-    }
-
-    // Record metadata
-    writeMeta({
-      version: VERSION,
-      installedAt: new Date().toISOString(),
-      python,
-      venvDir,
-    });
-
-    process.stderr.write("Ready.\n");
-  }
-
-  // -- exec -----------------------------------------------------------------
-
-  bootstrap();
-  const result = spawnSync(venvBin, process.argv.slice(2), { stdio: "inherit" });
-  if (result.error) {
-    fail(`Failed to execute ${TOOL}: ${result.error.message}`);
-  }
-  process.exit(result.status ?? 1);
-}
-
-// ---------------------------------------------------------------------------
-// macOS + Windows: download and launch prebuilt binary via npm-launcher
+// Rather than ship a broken installer, the npm shim now prints install
+// guidance for the supported channels. The package stays published so this
+// message reaches operators who still have `npm install -g backpropagate`
+// in their tooling.
+//
+// Tracked: D2 SPLIT in the v1.3 brief. Wave 1 landed the friendly-error
+// hotfix; Wave 3.5 deleted .github/workflows/release-binaries.yml; Wave 6a
+// removed the PyInstaller .spec files at the repo root and added the v1.2.x
+// → v1.3 handbook migration page that walks operators from the
+// pre-deprecation `npm install -g backpropagate` install line to the
+// supported channels. The migration is complete in v1.3.
 // ---------------------------------------------------------------------------
 
-process.env.MCPTOOLSHOP_LAUNCH_CONFIG = JSON.stringify({
-  toolName: TOOL,
-  owner: "mcp-tool-shop-org",
-  repo: "backpropagate",
-  version: VERSION,
-  tag: `v${VERSION}`,
-});
-
-require("@mcptoolshop/npm-launcher/bin/mcptoolshop-launch.js");
+// BRIDGE-B (Stage C humanization): the shim's WHOLE job is the friendly-error
+// path. Three rules the message has to satisfy:
+//   1. Name the next step (every error names the next step).
+//   2. Make the install commands copy-paste-runnable on the operator's host
+//      (no shell quoting that fails on cmd.exe, no `sudo` prefix that
+//      misleads on Windows).
+//   3. Stay calibrated — the v1.2 PyInstaller-bin build failed 3 times so
+//      v1.3 redirected operators to PyPI / pipx / uv; the message names the
+//      channels in preference order (isolated > shared > root-installable).
+process.stderr.write(
+  "npm distribution of backpropagate is deprecated as of v1.3.\n" +
+  "\n" +
+  "Next step — install from PyPI via one of these channels (pick one):\n" +
+  "  pipx install backpropagate         # recommended on macOS/Linux (isolated venv, on PATH)\n" +
+  "  uv tool install backpropagate      # recommended on Windows (uv handles venv + PATH)\n" +
+  "  pip install backpropagate          # plain pip (use inside a venv)\n" +
+  "\n" +
+  "Verify the install:  backprop --version\n" +
+  "\n" +
+  "Optional extras (Reflex UI, GGUF export, monitoring) — pick one bundle:\n" +
+  "  pipx install 'backpropagate[standard]'    # unsloth + ui (recommended)\n" +
+  "  pipx install 'backpropagate[full]'        # everything\n" +
+  "  pipx install 'backpropagate[ui]'          # just the Reflex web UI\n" +
+  "\n" +
+  "Getting started + extras documentation:\n" +
+  "  https://mcp-tool-shop-org.github.io/backpropagate/handbook/getting-started/\n" +
+  "Source + issues:\n" +
+  "  https://github.com/mcp-tool-shop-org/backpropagate\n"
+);
+process.exit(2);

package/package.json

@@ -1,13 +1,10 @@
 {
   "name": "@mcptoolshop/backpropagate",
-  "version": "1.2.0",
-  "description": "Headless LLM fine-tuning CLI with smart defaults — train, export, serve. Reflex web UI (auth-gated), HF Hub push, resume-from-checkpoint, run history, model cards, multi-run SLAO. v1.2.0: auth-bypass closed + truth-in-advertising sweep.",
+  "version": "1.4.0",
+  "description": "Deprecated npm distribution shim for backpropagate — prints install guidance for pipx/uv tool/pip. See https://github.com/mcp-tool-shop-org/backpropagate",
   "type": "commonjs",
   "license": "MIT",
   "engines": { "node": ">=20" },
-  "dependencies": {
-    "@mcptoolshop/npm-launcher": "^1.0.0"
-  },
   "bin": {
     "backpropagate": "bin/backpropagate.js"
   },