memorizz 0.5.2 → 0.6.2

package/README.md

@@ -11,6 +11,10 @@ developers. On `npm install -g memorizz` it:
 
 The `memorizz` command then execs the uv-installed CLI.
 
+This includes `memorizz harness` for governing installed Codex, Claude Code,
+OpenHands, and native MemAgent workers. The bootstrapper does not install those
+vendor CLIs; inspect local readiness with `memorizz harness doctor`.
+
 ## First-class install paths
 
 If you already use Python tooling, prefer these:

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");
@@ -12,6 +12,17 @@ const path = require("path");
 const fs = require("fs");
 const VERSION = require("../package.json").version;
 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,19 +39,52 @@ 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 '${PACKAGE_SPEC}'\n`
     );
     process.exit(127);
   }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "memorizz",
-  "version": "0.5.2",
-  "description": "npm bootstrapper for the memorizz Python CLI — installs the real tool via uv.",
+  "version": "0.6.2",
+  "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",
   "repository": {
@@ -9,16 +9,33 @@
     "url": "git+https://github.com/RichmondAlake/memorizz.git",
     "directory": "packaging/npm"
   },
-  "keywords": ["memorizz", "ai", "agent", "cli", "memory", "llm", "ollama"],
+  "keywords": [
+    "memorizz",
+    "ai",
+    "agent",
+    "cli",
+    "memory",
+    "llm",
+    "metaharness",
+    "ollama"
+  ],
   "bin": {
     "memorizz": "bin/memorizz.js"
   },
   "scripts": {
     "postinstall": "node scripts/postinstall.js"
   },
-  "files": ["bin/", "scripts/", "README.md"],
+  "files": [
+    "bin/",
+    "scripts/",
+    "README.md"
+  ],
   "engines": {
     "node": ">=16"
   },
-  "os": ["darwin", "linux", "win32"]
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ]
 }