memorizz 0.6.0 → 0.6.3

package/README.md

@@ -6,8 +6,9 @@ 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[mcp]"` so the full CLI, including MCP
-   client/server commands, is available.
+2. runs `uv tool install --python 3.12 "memorizz[mcp]"` so the full CLI,
+   including MCP client/server commands, is available even when the host's
+   default Python is older.
 
 The `memorizz` command then execs the uv-installed CLI.
 
@@ -20,7 +21,7 @@ vendor CLIs; inspect local readiness with `memorizz harness doctor`.
 If you already use Python tooling, prefer these:
 
 ```bash
-uv tool install "memorizz[mcp]"     # recommended for the complete CLI
+uv tool install --python 3.12 "memorizz[mcp]"  # recommended complete CLI
 pipx install "memorizz[mcp]"
 ```
 

package/bin/memorizz.js

@@ -1,9 +1,9 @@
 #!/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).
+// Thin launcher: exec the exact uv-installed `memorizz`, forwarding
+// argv/stdio/exit code. Falls back to `uv tool run` with the pinned package
+// specification when the managed binary is missing or stale.
 "use strict";
 
 const { spawnSync } = require("child_process");
@@ -11,7 +11,19 @@ const os = require("os");
 const path = require("path");
 const fs = require("fs");
 const VERSION = require("../package.json").version;
+const PYTHON_VERSION = "3.12";
 const PACKAGE_SPEC = `memorizz[mcp]==${VERSION}`;
+const EXPECTED_VERSION = `memorizz ${VERSION}`;
+
+function realpath(value) {
+  try {
+    return fs.realpathSync(value);
+  } catch (_) {
+    return path.resolve(value);
+  }
+}
+
+const LAUNCHER_PATH = realpath(__filename);
 
 function findExe(name) {
   const finder = process.platform === "win32" ? "where" : "which";
@@ -28,23 +40,60 @@ function findExe(name) {
   return null;
 }
 
+function uvToolBinDir(uv) {
+  const result = spawnSync(uv, ["tool", "dir", "--bin"], {
+    encoding: "utf8",
+  });
+  if (result.status !== 0 || !result.stdout.trim()) return null;
+  return result.stdout.trim().split(/\r?\n/).pop();
+}
+
+function isExpectedCli(candidate) {
+  if (!candidate || !fs.existsSync(candidate)) return false;
+  if (realpath(candidate) === LAUNCHER_PATH) return false;
+  const result = spawnSync(candidate, ["--version"], { encoding: "utf8" });
+  return result.status === 0 && result.stdout.trim() === EXPECTED_VERSION;
+}
+
+function findUvManagedCli(uv) {
+  const binDir = uvToolBinDir(uv);
+  if (!binDir) return null;
+  const executable = process.platform === "win32" ? "memorizz.exe" : "memorizz";
+  const candidate = path.join(binDir, executable);
+  return isExpectedCli(candidate) ? candidate : null;
+}
+
+function findCompatibleCliOnPath() {
+  const executable = process.platform === "win32" ? "memorizz.exe" : "memorizz";
+  for (const directory of (process.env.PATH || "").split(path.delimiter)) {
+    if (!directory) continue;
+    const candidate = path.join(directory, executable);
+    if (isExpectedCli(candidate)) return candidate;
+  }
+  return null;
+}
+
 const args = process.argv.slice(2);
-const exe = findExe("memorizz");
+const uv = findExe("uv");
+const exe = (uv && findUvManagedCli(uv)) || findCompatibleCliOnPath();
 
 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" +
+      `[memorizz] MemoRizz ${VERSION} is not installed and uv was not found.\n` +
         "  Try: npm rebuild -g memorizz   (re-runs the bootstrapper)\n" +
-        "  Or:  uv tool install memorizz  /  pipx install memorizz\n"
+        `  Or:  uv tool install --python ${PYTHON_VERSION} '${PACKAGE_SPEC}'\n`
     );
     process.exit(127);
   }
-  res = spawnSync(uv, ["tool", "run", "--from", PACKAGE_SPEC, "memorizz", ...args], { stdio: "inherit" });
+  res = spawnSync(
+    uv,
+    ["tool", "run", "--python", PYTHON_VERSION, "--from", PACKAGE_SPEC, "memorizz", ...args],
+    { stdio: "inherit" }
+  );
 }
 
 process.exit(res.status == null ? 1 : res.status);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memorizz",
-  "version": "0.6.0",
+  "version": "0.6.3",
   "description": "npm bootstrapper for the memory-first Memorizz agent CLI and meta-harness.",
   "license": "PolyForm-Noncommercial-1.0.0",
   "homepage": "https://github.com/RichmondAlake/memorizz",

package/scripts/postinstall.js

@@ -3,8 +3,9 @@
 //
 // 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
+// required). This is NOT the canonical install path; `uv tool install
+// --python 3.12 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";
@@ -15,6 +16,7 @@ const path = require("path");
 const fs = require("fs");
 
 const VERSION = require("../package.json").version;
+const PYTHON_VERSION = "3.12";
 // The npm bridge represents the complete command-line product, including MCP
 // client/server commands whose Python dependencies are optional for library-only
 // installs.
@@ -73,7 +75,11 @@ function main() {
   let uv = findUv() || installUv();
   if (uv) {
     log(`Installing ${PACKAGE_SPEC} via uv…`);
-    const r = spawnSync(uv, ["tool", "install", "--force", PACKAGE_SPEC], { stdio: "inherit" });
+    const r = spawnSync(
+      uv,
+      ["tool", "install", "--python", PYTHON_VERSION, "--force", PACKAGE_SPEC],
+      { stdio: "inherit" }
+    );
     if (r.status === 0) {
       log("Done. Run:  memorizz");
       return;
@@ -95,7 +101,7 @@ function main() {
       "Could not bootstrap memorizz automatically.",
       "Install it manually with either:",
       "  curl -LsSf https://astral.sh/uv/install.sh | sh",
-      `  uv tool install '${PACKAGE_SPEC}'`,
+      `  uv tool install --python ${PYTHON_VERSION} '${PACKAGE_SPEC}'`,
       `  pipx install '${PACKAGE_SPEC}'`,
       "The `memorizz` launcher will also retry via `uv tool run` on first use.",
     ].join("\n")