neurostack 0.1.0 → 0.3.2

package/bin/neurostack.js

@@ -1,19 +1,66 @@
 #!/usr/bin/env node
 "use strict";
 
-const { execFileSync } = require("child_process");
+const { execFileSync, execSync } = require("child_process");
+const fs = require("fs");
 const path = require("path");
 const os = require("os");
 
 const INSTALL_DIR = path.join(os.homedir(), ".local", "share", "neurostack", "repo");
+const UV_BIN = path.join(os.homedir(), ".local", "bin", "uv");
+
+function which(cmd) {
+  try {
+    return execSync(`command -v ${cmd}`, { encoding: "utf8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+  } catch { return null; }
+}
+
+// Handle `neurostack uninstall` — clean up data then remove the npm package
+if (process.argv[2] === "uninstall") {
+  const preuninstall = path.join(__dirname, "..", "preuninstall.js");
+  if (fs.existsSync(preuninstall)) {
+    require(preuninstall);
+  }
+  console.log("  \x1b[36m▸\x1b[0m Removing npm package...\n");
+  try {
+    execSync("npm uninstall -g neurostack", { stdio: "inherit" });
+  } catch {
+    console.error("  \x1b[33m▸\x1b[0m npm uninstall failed — run manually: npm uninstall -g neurostack");
+  }
+  process.exit(0);
+}
+
+// Resolve uv — check PATH first, then common install location
+const uv = which("uv") || (fs.existsSync(UV_BIN) ? UV_BIN : null);
+
+if (!uv) {
+  console.error(
+    "\x1b[31mError:\x1b[0m uv is not installed or not on PATH.\n" +
+    "  Fix: npm rebuild neurostack   (will auto-install uv)\n" +
+    "  Or:  https://docs.astral.sh/uv/getting-started/installation/"
+  );
+  process.exit(1);
+}
+
+if (!fs.existsSync(path.join(INSTALL_DIR, "pyproject.toml"))) {
+  console.error(
+    "\x1b[31mError:\x1b[0m NeuroStack not found at " + INSTALL_DIR + "\n" +
+    "  Fix: npm rebuild neurostack   (will re-download and set up)"
+  );
+  process.exit(1);
+}
 
 try {
-  execFileSync("uv", ["run", "--project", INSTALL_DIR, "python", "-m", "neurostack.cli", ...process.argv.slice(2)], {
+  execFileSync(uv, ["run", "--python", "3.12", "--project", INSTALL_DIR, "python", "-m", "neurostack.cli", ...process.argv.slice(2)], {
     stdio: "inherit",
     env: { ...process.env }
   });
 } catch (e) {
   if (e.status != null) process.exit(e.status);
-  console.error("Failed to run neurostack. Is it installed? Try: npm rebuild neurostack");
+  console.error(
+    "\x1b[31mError:\x1b[0m Failed to launch neurostack.\n" +
+    "  Try: npm rebuild neurostack\n" +
+    "  Debug: " + uv + " run --python 3.12 --project " + INSTALL_DIR + " python -m neurostack.cli --help"
+  );
   process.exit(1);
 }

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "neurostack",
-  "version": "0.1.0",
+  "version": "0.3.2",
   "description": "Build, maintain, and search your knowledge vault with AI",
   "bin": {
     "neurostack": "bin/neurostack.js"
   },
   "scripts": {
-    "postinstall": "node postinstall.js"
+    "postinstall": "node postinstall.js",
+    "preuninstall": "node preuninstall.js"
   },
   "keywords": [
     "knowledge-management",
@@ -34,10 +35,14 @@
   "engines": {
     "node": ">=16"
   },
-  "os": ["linux", "darwin"],
+  "os": [
+    "linux",
+    "darwin"
+  ],
   "files": [
     "bin/",
     "postinstall.js",
+    "preuninstall.js",
     "README.md",
     "LICENSE"
   ]

package/postinstall.js

@@ -1,17 +1,26 @@
 #!/usr/bin/env node
 "use strict";
 
-const { execSync, execFileSync } = require("child_process");
+const { execSync } = require("child_process");
 const fs = require("fs");
 const path = require("path");
 const os = require("os");
+const https = require("https");
+const { createWriteStream } = require("fs");
+const { createGunzip } = require("zlib");
 
 const INSTALL_DIR = path.join(os.homedir(), ".local", "share", "neurostack", "repo");
-const REPO = "https://github.com/raphasouthall/neurostack.git";
+const TARBALL_URL = "https://github.com/raphasouthall/neurostack/archive/refs/heads/main.tar.gz";
+const UV_INSTALL_URL = "https://astral.sh/uv/install.sh";
+const UV_BIN_DIR = path.join(os.homedir(), ".local", "bin");
+const PYTHON_VERSION = "3.12";
 
-function info(msg) { console.log(`  [*] ${msg}`); }
-function warn(msg) { console.error(`  [!] ${msg}`); }
-function die(msg) { console.error(`  [X] ${msg}`); process.exit(1); }
+function info(msg) { console.log(`  \x1b[36m▸\x1b[0m ${msg}`); }
+function warn(msg) { console.error(`  \x1b[33m▸\x1b[0m ${msg}`); }
+function die(msg) {
+  console.error(`\n  \x1b[31m✗\x1b[0m ${msg}\n`);
+  process.exit(1);
+}
 
 function which(cmd) {
   try {
@@ -23,64 +32,131 @@ function run(cmd, opts = {}) {
   return execSync(cmd, { encoding: "utf8", stdio: "inherit", ...opts });
 }
 
-// --- Python check ---
-let python = null;
-for (const cmd of ["python3.13", "python3.12", "python3.11", "python3"]) {
-  if (!which(cmd)) continue;
-  try {
-    const ver = execSync(`${cmd} -c "import sys; print(f'{sys.version_info.major}.{sys.version_info.minor}')"`,
-      { encoding: "utf8", stdio: ["pipe", "pipe", "pipe"] }).trim();
-    const [major, minor] = ver.split(".").map(Number);
-    if (major >= 3 && minor >= 11) { python = cmd; break; }
-  } catch { /* skip */ }
+function uvCmd() {
+  return which("uv") || (fs.existsSync(path.join(UV_BIN_DIR, "uv")) ? path.join(UV_BIN_DIR, "uv") : null);
 }
-if (!python) die("Python 3.11+ is required. Install it and try again.");
-info(`Python: ${execSync(`${python} --version`, { encoding: "utf8" }).trim()}`);
-
-// --- FTS5 check ---
-try {
-  execSync(`${python} -c "import sqlite3; c=sqlite3.connect(':memory:'); c.execute('CREATE VIRTUAL TABLE t USING fts5(c)'); c.close()"`,
-    { stdio: ["pipe", "pipe", "pipe"] });
-  info("FTS5: available");
-} catch {
-  die("SQLite FTS5 extension required but not available in your Python build");
+
+/** Download a URL to a file or string using Node built-in https (follows redirects) */
+function download(url, destPath) {
+  return new Promise((resolve, reject) => {
+    const get = (u) => {
+      https.get(u, { headers: { "User-Agent": "neurostack-installer" } }, (res) => {
+        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+          return get(res.headers.location);
+        }
+        if (res.statusCode !== 200) {
+          return reject(new Error(`HTTP ${res.statusCode} from ${u}`));
+        }
+        if (destPath) {
+          const ws = createWriteStream(destPath);
+          res.pipe(ws);
+          ws.on("finish", () => resolve(destPath));
+          ws.on("error", reject);
+        } else {
+          const chunks = [];
+          res.on("data", (c) => chunks.push(c));
+          res.on("end", () => resolve(Buffer.concat(chunks).toString()));
+        }
+        res.on("error", reject);
+      }).on("error", reject);
+    };
+    get(url);
+  });
 }
 
-// --- git check ---
-if (!which("git")) die("git is required. Install it and try again.");
+async function main() {
+  console.log("\n  \x1b[1mNeuroStack installer\x1b[0m\n");
 
-// --- uv check/install ---
-if (!which("uv")) {
-  info("Installing uv...");
-  run("curl -LsSf https://astral.sh/uv/install.sh | sh");
-  process.env.PATH = `${path.join(os.homedir(), ".local", "bin")}:${process.env.PATH}`;
-}
-info(`uv: ${execSync("uv --version", { encoding: "utf8" }).trim()}`);
-
-// --- Clone/update ---
-if (fs.existsSync(path.join(INSTALL_DIR, ".git"))) {
-  info("Updating existing installation...");
-  run(`git -C ${INSTALL_DIR} pull --ff-only`);
-} else {
-  info("Cloning NeuroStack...");
-  fs.mkdirSync(path.dirname(INSTALL_DIR), { recursive: true });
-  run(`git clone ${REPO} ${INSTALL_DIR}`);
-}
+  // ── Step 1: Install uv (the only external dependency) ──
+  if (!uvCmd()) {
+    info("Installing uv (Python package manager)...");
+    try {
+      const script = await download(UV_INSTALL_URL);
+      const tmpFile = path.join(os.tmpdir(), `uv-install-${Date.now()}.sh`);
+      fs.writeFileSync(tmpFile, script, { mode: 0o755 });
+      run(`sh "${tmpFile}"`, { env: { ...process.env, UV_UNMANAGED_INSTALL: UV_BIN_DIR } });
+      fs.unlinkSync(tmpFile);
+      process.env.PATH = `${UV_BIN_DIR}:${process.env.PATH}`;
+    } catch (e) {
+      die(
+        `Failed to install uv: ${e.message}\n` +
+        `      Install manually: https://docs.astral.sh/uv/getting-started/installation/\n` +
+        `      Then re-run: npm rebuild neurostack`
+      );
+    }
+  }
+  const uv = uvCmd();
+  if (!uv) die("uv installed but not found on PATH. Run: npm rebuild neurostack");
+  info(`uv: ${execSync(`"${uv}" --version`, { encoding: "utf8" }).trim()}`);
+
+  // ── Step 2: Install Python via uv (no system Python needed) ──
+  info(`Ensuring Python ${PYTHON_VERSION} is available...`);
+  try {
+    run(`"${uv}" python install ${PYTHON_VERSION}`);
+  } catch (e) {
+    die(`Failed to install Python ${PYTHON_VERSION} via uv: ${e.message}`);
+  }
 
-// --- Install with uv ---
-const mode = process.env.NEUROSTACK_MODE || "lite";
-const extraArgs = mode === "community" ? "--extra full --extra community"
-               : mode === "full" ? "--extra full"
-               : "";
-info(`Installing in ${mode} mode...`);
-run(`uv sync ${extraArgs}`.trim(), { cwd: INSTALL_DIR });
-
-// --- Config ---
-const configDir = path.join(os.homedir(), ".config", "neurostack");
-const configFile = path.join(configDir, "config.toml");
-if (!fs.existsSync(configFile)) {
-  fs.mkdirSync(configDir, { recursive: true });
-  fs.writeFileSync(configFile, `# NeuroStack Configuration
+  // Verify FTS5 in the uv-managed Python
+  try {
+    run(
+      `"${uv}" run --python ${PYTHON_VERSION} python -c "import sqlite3; c=sqlite3.connect(':memory:'); c.execute('CREATE VIRTUAL TABLE t USING fts5(c)'); c.close()"`,
+      { stdio: ["pipe", "pipe", "pipe"] }
+    );
+    info("SQLite FTS5: ok");
+  } catch {
+    warn("FTS5 check skipped — will verify at first run");
+  }
+
+  // ── Step 3: Download source tarball (no git needed) ──
+  if (fs.existsSync(path.join(INSTALL_DIR, "pyproject.toml"))) {
+    // Existing install — try git pull if available, otherwise re-download
+    if (fs.existsSync(path.join(INSTALL_DIR, ".git")) && which("git")) {
+      info("Updating existing installation...");
+      try {
+        run(`git -C "${INSTALL_DIR}" pull --ff-only`);
+      } catch {
+        warn("git pull failed — re-downloading...");
+        fs.rmSync(INSTALL_DIR, { recursive: true, force: true });
+      }
+    } else {
+      info("Re-downloading source...");
+      fs.rmSync(INSTALL_DIR, { recursive: true, force: true });
+    }
+  }
+
+  if (!fs.existsSync(path.join(INSTALL_DIR, "pyproject.toml"))) {
+    info("Downloading NeuroStack...");
+    const tarFile = path.join(os.tmpdir(), `neurostack-${Date.now()}.tar.gz`);
+    try {
+      await download(TARBALL_URL, tarFile);
+      fs.mkdirSync(INSTALL_DIR, { recursive: true });
+      // GitHub tarballs extract to neurostack-main/ — strip that prefix
+      run(`tar xzf "${tarFile}" --strip-components=1 -C "${INSTALL_DIR}"`);
+      fs.unlinkSync(tarFile);
+    } catch (e) {
+      die(
+        `Failed to download source: ${e.message}\n` +
+        `      Check your internet connection and try: npm rebuild neurostack`
+      );
+    }
+  }
+  info("Source: ok");
+
+  // ── Step 4: Install Python dependencies ──
+  const mode = process.env.NEUROSTACK_MODE || "lite";
+  const extraArgs = mode === "community" ? "--extra full --extra community"
+                 : mode === "full" ? "--extra full"
+                 : "";
+  info(`Installing Python dependencies (${mode} mode)...`);
+  run(`"${uv}" sync --python ${PYTHON_VERSION} ${extraArgs}`.trim(), { cwd: INSTALL_DIR });
+
+  // ── Step 5: Default config ──
+  const configDir = path.join(os.homedir(), ".config", "neurostack");
+  const configFile = path.join(configDir, "config.toml");
+  if (!fs.existsSync(configFile)) {
+    fs.mkdirSync(configDir, { recursive: true });
+    fs.writeFileSync(configFile, `# NeuroStack Configuration
 # See: https://github.com/raphasouthall/neurostack#configuration
 
 vault_root = "${os.homedir()}/brain"
@@ -88,9 +164,23 @@ embed_url = "http://localhost:11435"
 llm_url = "http://localhost:11434"
 llm_model = "phi3.5"
 `);
-  info(`Config written: ${configFile}`);
-} else {
-  info(`Config exists: ${configFile}`);
+    info(`Config: ${configFile}`);
+  } else {
+    info(`Config exists: ${configFile}`);
+  }
+
+  // ── Done ──
+  console.log(`
+  \x1b[32m✓ NeuroStack installed!\x1b[0m (${mode} mode)
+
+  Get started:
+    neurostack init          Set up vault structure
+    neurostack index         Index your vault
+    neurostack search 'q'    Search
+    neurostack doctor        Health check
+`);
 }
 
-info("NeuroStack installed successfully via npm!");
+main().catch((e) => {
+  die(`Unexpected error: ${e.message}\n      Please report: https://github.com/raphasouthall/neurostack/issues`);
+});

package/preuninstall.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+
+const INSTALL_DIR = path.join(os.homedir(), ".local", "share", "neurostack");
+const CONFIG_DIR = path.join(os.homedir(), ".config", "neurostack");
+const DB_FILE = path.join(INSTALL_DIR, "neurostack.db");
+
+function info(msg) { console.log(`  \x1b[36m▸\x1b[0m ${msg}`); }
+function warn(msg) { console.error(`  \x1b[33m▸\x1b[0m ${msg}`); }
+
+console.log("\n  \x1b[1mUninstalling NeuroStack\x1b[0m\n");
+
+// Remove source repo + venv (~/.local/share/neurostack/repo)
+const repoDir = path.join(INSTALL_DIR, "repo");
+if (fs.existsSync(repoDir)) {
+  fs.rmSync(repoDir, { recursive: true, force: true });
+  info("Removed source and venv: " + repoDir);
+} else {
+  info("Source directory not found (already clean)");
+}
+
+// Remove database if present
+if (fs.existsSync(DB_FILE)) {
+  fs.rmSync(DB_FILE, { force: true });
+  // Also clean up WAL/SHM journal files
+  for (const suffix of ["-wal", "-shm"]) {
+    const f = DB_FILE + suffix;
+    if (fs.existsSync(f)) fs.rmSync(f, { force: true });
+  }
+  info("Removed database: " + DB_FILE);
+}
+
+// Remove parent dir if empty
+if (fs.existsSync(INSTALL_DIR)) {
+  try {
+    fs.rmdirSync(INSTALL_DIR);
+    info("Removed empty directory: " + INSTALL_DIR);
+  } catch {
+    // Not empty — user may have other files there
+    warn("Directory not empty, kept: " + INSTALL_DIR);
+  }
+}
+
+// Preserve config — user may want to reinstall later
+if (fs.existsSync(CONFIG_DIR)) {
+  warn("Config preserved: " + CONFIG_DIR);
+  warn("To remove manually: rm -rf " + CONFIG_DIR);
+}
+
+console.log("\n  \x1b[32m✓ NeuroStack uninstalled.\x1b[0m\n");