@xyrlan/mnemo 0.14.0 → 0.15.0

package/lib/bootstrap.js

@@ -5,7 +5,7 @@ const { probeOnPath } = require("./detect");
 const { resolveMnemoBinary } = require("./runMnemo");
 
 
-const PIN_SPEC = "mnemo-claude>=0.14,<0.15";
+const PIN_SPEC = "mnemo-claude>=0.15,<0.16";
 
 
 function buildInstallCmd(installer, spec = PIN_SPEC) {
@@ -38,8 +38,14 @@ function isAlreadyInstalled(resolverFn = resolveMnemoBinary) {
 }
 
 
-function runShell(cmd, { quiet = false } = {}) {
-  const result = spawnSync("sh", ["-c", cmd], { stdio: quiet ? "ignore" : "inherit" });
+function runShell(cmd, { quiet = false, platform = process.platform } = {}) {
+  const isWin = platform === "win32";
+  const shellCmd = isWin ? "cmd.exe" : "sh";
+  const shellArgs = isWin ? ["/d", "/s", "/c", cmd] : ["-c", cmd];
+  const result = spawnSync(shellCmd, shellArgs, {
+    stdio: quiet ? "ignore" : "inherit",
+    windowsHide: true,
+  });
   return result.status === null ? 1 : result.status;
 }
 
@@ -52,11 +58,40 @@ function verifyOnPath() {
 }
 
 
-function pathFixHint(installer) {
+function _userBaseFromPython(execFn) {
+  // `python3 -m site --user-base` is authoritative across platforms:
+  //   Linux  → ~/.local
+  //   macOS  → ~/Library/Python/<X.Y>     (NOT ~/.local — common gotcha)
+  //   Win    → %APPDATA%\Python
+  // Returns the bin/Scripts dir, or null on failure (caller falls back to
+  // platform heuristics).
+  try {
+    const out = execFn("python3 -m site --user-base").trim();
+    if (!out) return null;
+    return out;
+  } catch (_e) {
+    return null;
+  }
+}
+
+
+function pathFixHint(installer, {
+  platform = process.platform,
+  execFn = (cmd) => execSync(cmd, { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }),
+} = {}) {
   if (installer === "pipx") return "Run `pipx ensurepath` and reopen your shell.";
   if (installer === "uv")   return "Run `uv tool update-shell` and reopen your shell.";
   if (installer === "pip-user") {
-    if (process.platform === "win32") return "Add %APPDATA%\\Python\\Scripts to PATH.";
+    if (platform === "win32") {
+      const base = _userBaseFromPython(execFn);
+      if (base) return `Add ${base}\\Scripts to PATH.`;
+      return "Add %APPDATA%\\Python\\Scripts to PATH.";
+    }
+    const base = _userBaseFromPython(execFn);
+    if (base) return `Add ${base}/bin to PATH (e.g. via your shell profile).`;
+    if (platform === "darwin") {
+      return "Add ~/Library/Python/<X.Y>/bin to PATH (run `python3 -m site --user-base` to find the right X.Y).";
+    }
     return "Add ~/.local/bin to PATH (e.g. via your shell profile).";
   }
   return "Re-open your shell to refresh PATH.";

package/lib/runInstall.js

@@ -15,7 +15,7 @@ const { buildInitArgs, runMnemo } = require("./runMnemo");
 const m = require("./messages");
 
 
-function parseFlags(argv) {
+function parseFlags(argv, { warn = (msg) => process.stderr.write(`warning: ${msg}\n`) } = {}) {
   const flags = { scope: null, vaultRoot: null, upgrade: false, yes: false, quiet: false };
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
@@ -24,7 +24,18 @@ function parseFlags(argv) {
     else if (a === "--upgrade")        flags.upgrade = true;
     else if (a === "--yes" || a === "-y") flags.yes = true;
     else if (a === "--quiet")          flags.quiet = true;
-    else if (a === "--vault-root")     { flags.vaultRoot = argv[++i]; }
+    else if (a === "--vault-root") {
+      const next = argv[i + 1];
+      if (!next || next.startsWith("--")) {
+        warn(`--vault-root requires a path argument; ignoring.`);
+      } else {
+        flags.vaultRoot = next;
+        i++;
+      }
+    }
+    else if (a && a.startsWith("-")) {
+      warn(`unknown flag: ${a}`);
+    }
   }
   return flags;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xyrlan/mnemo",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "One-command installer for mnemo (the Obsidian that populates itself).",
   "bin": {
     "mnemo": "bin/mnemo.js"
@@ -18,7 +18,7 @@
     "access": "public"
   },
   "scripts": {
-    "test": "node --test test/"
+    "test": "node --test test/*.test.js"
   },
   "files": [
     "bin/",