memorizz 0.1.0

package/README.md

@@ -0,0 +1,31 @@
+# memorizz (npm bootstrapper)
+
+This npm package is a **convenience bridge** that installs the real
+[`memorizz`](https://pypi.org/project/memorizz/) Python CLI for Node-first
+developers. On `npm install -g memorizz` it:
+
+1. finds or installs [`uv`](https://docs.astral.sh/uv/) (a standalone binary that
+   manages its own Python — you do **not** need Python pre-installed), then
+2. runs `uv tool install memorizz`.
+
+The `memorizz` command then execs the uv-installed CLI.
+
+## First-class install paths
+
+If you already use Python tooling, prefer these:
+
+```bash
+uv tool install memorizz     # recommended
+pipx install memorizz
+```
+
+## Uninstall
+
+```bash
+npm uninstall -g memorizz
+uv tool uninstall memorizz   # the npm shim does not remove the uv-managed tool
+```
+
+## Env
+
+- `MEMORIZZ_SKIP_POSTINSTALL=1` — skip the bootstrap during `npm install`.

package/bin/memorizz.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+// Copyright (c) 2024 Richmond Alake. Licensed under PolyForm Noncommercial 1.0.0.
+//
+// Thin launcher: exec the uv-installed `memorizz`, forwarding argv/stdio/exit
+// code. Falls back to `uv tool run memorizz` when the launcher isn't yet on PATH
+// (e.g. a fresh shell after install, or a postinstall that failed soft).
+"use strict";
+
+const { spawnSync } = require("child_process");
+const os = require("os");
+const path = require("path");
+const fs = require("fs");
+
+function findExe(name) {
+  const finder = process.platform === "win32" ? "where" : "which";
+  const onPath = spawnSync(finder, [name], { encoding: "utf8" });
+  if (onPath.status === 0 && onPath.stdout.trim()) {
+    return onPath.stdout.split(/\r?\n/)[0].trim();
+  }
+  const home = os.homedir();
+  const exe = process.platform === "win32" ? `${name}.exe` : name;
+  for (const dir of [path.join(home, ".local", "bin"), path.join(home, ".cargo", "bin")]) {
+    const candidate = path.join(dir, exe);
+    if (fs.existsSync(candidate)) return candidate;
+  }
+  return null;
+}
+
+const args = process.argv.slice(2);
+const exe = findExe("memorizz");
+
+let res;
+if (exe) {
+  res = spawnSync(exe, args, { stdio: "inherit" });
+} else {
+  const uv = findExe("uv");
+  if (!uv) {
+    process.stderr.write(
+      "[memorizz] CLI not installed and uv not found.\n" +
+        "  Try: npm rebuild -g memorizz   (re-runs the bootstrapper)\n" +
+        "  Or:  uv tool install memorizz  /  pipx install memorizz\n"
+    );
+    process.exit(127);
+  }
+  res = spawnSync(uv, ["tool", "run", "memorizz", ...args], { stdio: "inherit" });
+}
+
+process.exit(res.status == null ? 1 : res.status);

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "memorizz",
+  "version": "0.1.0",
+  "description": "npm bootstrapper for the memorizz Python CLI — installs the real tool via uv.",
+  "license": "PolyForm-Noncommercial-1.0.0",
+  "homepage": "https://github.com/RichmondAlake/memorizz",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RichmondAlake/memorizz.git",
+    "directory": "packaging/npm"
+  },
+  "keywords": ["memorizz", "ai", "agent", "cli", "memory", "llm", "ollama"],
+  "bin": {
+    "memorizz": "bin/memorizz.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "files": ["bin/", "scripts/", "README.md"],
+  "engines": {
+    "node": ">=16"
+  },
+  "os": ["darwin", "linux", "win32"]
+}

package/scripts/postinstall.js

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+// Copyright (c) 2024 Richmond Alake. Licensed under PolyForm Noncommercial 1.0.0.
+//
+// Convenience bootstrapper: `npm i -g memorizz` installs the real Python CLI via
+// `uv` (a standalone binary that manages its own Python — no pre-existing Python
+// required). This is NOT the canonical install path; `uv tool install memorizz`
+// and `pipx install memorizz` are first-class. Fails soft: a bootstrap error
+// never bricks the package — bin/memorizz.js retries via `uv tool run` on first
+// use.
+"use strict";
+
+const { spawnSync } = require("child_process");
+const os = require("os");
+const path = require("path");
+const fs = require("fs");
+
+const VERSION = require("../package.json").version;
+
+const log = (m) => process.stdout.write(`[memorizz] ${m}\n`);
+const warn = (m) => process.stderr.write(`[memorizz] ${m}\n`);
+
+function which(cmd) {
+  const finder = process.platform === "win32" ? "where" : "which";
+  const r = spawnSync(finder, [cmd], { encoding: "utf8" });
+  if (r.status === 0 && r.stdout) return r.stdout.split(/\r?\n/)[0].trim();
+  return null;
+}
+
+function uvBinDirs() {
+  const home = os.homedir();
+  return [
+    path.join(home, ".local", "bin"),
+    path.join(home, ".cargo", "bin"),
+    path.join(home, ".local", "share", "uv", "bin"),
+  ];
+}
+
+function findUv() {
+  const onPath = which("uv");
+  if (onPath) return onPath;
+  const exe = process.platform === "win32" ? "uv.exe" : "uv";
+  for (const dir of uvBinDirs()) {
+    const candidate = path.join(dir, exe);
+    if (fs.existsSync(candidate)) return candidate;
+  }
+  return null;
+}
+
+function installUv() {
+  log("Installing uv (standalone, no Python required)…");
+  if (process.platform === "win32") {
+    spawnSync(
+      "powershell",
+      ["-NoProfile", "-ExecutionPolicy", "Bypass", "-Command", "irm https://astral.sh/uv/install.ps1 | iex"],
+      { stdio: "inherit" }
+    );
+  } else {
+    spawnSync("sh", ["-c", "curl -LsSf https://astral.sh/uv/install.sh | sh"], { stdio: "inherit" });
+  }
+  return findUv();
+}
+
+function main() {
+  if (process.env.MEMORIZZ_SKIP_POSTINSTALL) {
+    log("postinstall skipped (MEMORIZZ_SKIP_POSTINSTALL set)");
+    return;
+  }
+
+  let uv = findUv() || installUv();
+  if (uv) {
+    log(`Installing memorizz==${VERSION} via uv…`);
+    const r = spawnSync(uv, ["tool", "install", "--force", `memorizz==${VERSION}`], { stdio: "inherit" });
+    if (r.status === 0) {
+      log("Done. Run:  memorizz");
+      return;
+    }
+    warn("uv install failed — trying pipx fallback.");
+  }
+
+  const pipx = which("pipx");
+  if (pipx) {
+    const r = spawnSync(pipx, ["install", "--force", `memorizz==${VERSION}`], { stdio: "inherit" });
+    if (r.status === 0) {
+      log("Done (via pipx). Run:  memorizz");
+      return;
+    }
+  }
+
+  warn(
+    [
+      "Could not bootstrap memorizz automatically.",
+      "Install it manually with either:",
+      "  curl -LsSf https://astral.sh/uv/install.sh | sh   # then: uv tool install memorizz",
+      "  pipx install memorizz",
+      "The `memorizz` launcher will also retry via `uv tool run` on first use.",
+    ].join("\n")
+  );
+  // Intentionally exit 0 (fail-soft).
+}
+
+main();