@kevin0181/memoc 1.0.3 → 1.0.5

package/README.md

@@ -12,7 +12,7 @@ npx @kevin0181/memoc init
 
 Run inside your project directory. Detects your stack automatically and generates everything agents need.
 
-`init` also creates PATH helpers so agents can keep using memoc even when the global/npm bin is not on PATH. It installs a user-local `memoc` launcher and adds that launcher directory to PATH on Windows, macOS, and Linux; open a new terminal if the current shell does not pick it up immediately.
+`init` also creates PATH helpers so agents can keep using memoc even when the global/npm bin is not on PATH. It installs a `memoc` launcher into a writable directory already on the current PATH when possible, then also installs a user-local launcher and registers that launcher directory on Windows, macOS, and Linux.
 
 ```bash
 # PowerShell

package/bin/cli.js

@@ -209,15 +209,15 @@ function write(filePath, content) {
 }
 
 function tplMemocCmdWrapper() {
-  return `@echo off\r\nnpx @kevin0181/memoc %*\r\n`;
+  return `@echo off\r\nnpm exec --yes --package "@kevin0181/memoc" -- memoc %*\r\n`;
 }
 
 function tplMemocPs1Wrapper() {
-  return `npx @kevin0181/memoc @args\nexit $LASTEXITCODE\n`;
+  return `npm exec --yes --package '@kevin0181/memoc' -- memoc @args\nexit $LASTEXITCODE\n`;
 }
 
 function tplMemocShWrapper() {
-  return `#!/bin/sh\nexec npx @kevin0181/memoc "$@"\n`;
+  return `#!/bin/sh\nexec npm exec --yes --package '@kevin0181/memoc' -- memoc "$@"\n`;
 }
 
 function defaultUserBinDir() {
@@ -247,30 +247,46 @@ function ensurePathHelpers(dir, mark) {
 
   for (const [fp, tpl, executable] of files) {
     const rel = path.relative(dir, fp);
-    const added = ensure(fp, tpl());
+    const added = writeIfChanged(fp, tpl());
     if (executable) chmodExecutable(fp);
-    mark(added ? 'add' : 'skip', rel);
+    mark(added, rel);
   }
 }
 
 function ensureUserLauncher(mark) {
   const userBin = defaultUserBinDir();
+  writeLaunchers(userBin, mark, 'user bin');
+  return userBin;
+}
+
+function writeLaunchers(binDir, mark, label) {
   const files = [
-    [path.join(userBin, 'memoc.cmd'), tplMemocCmdWrapper, false],
-    [path.join(userBin, 'memoc.ps1'), tplMemocPs1Wrapper, false],
-    [path.join(userBin, 'memoc'), tplMemocShWrapper, true],
+    [path.join(binDir, 'memoc.cmd'), tplMemocCmdWrapper, false],
+    [path.join(binDir, 'memoc.ps1'), tplMemocPs1Wrapper, false],
+    [path.join(binDir, 'memoc'), tplMemocShWrapper, true],
   ];
 
   for (const [fp, tpl, executable] of files) {
-    const added = ensure(fp, tpl());
+    const added = writeIfChanged(fp, tpl());
     if (executable) chmodExecutable(fp);
-    mark(added ? 'add' : 'skip', `user bin ${path.basename(fp)}`);
+    mark(added, `${label} ${path.basename(fp)}`);
   }
+}
 
-  return userBin;
+function writeIfChanged(filePath, content) {
+  if (!fs.existsSync(filePath)) {
+    write(filePath, content);
+    return 'add';
+  }
+  try {
+    if (fs.readFileSync(filePath, 'utf8') === content) return 'skip';
+  } catch {}
+  write(filePath, content);
+  return 'update';
 }
 
 function ensurePathRegistration(dir, mark) {
+  ensureCurrentPathLauncher(mark);
   const binDir = ensureUserLauncher(mark);
   const pathSep = path.delimiter;
 
@@ -319,6 +335,75 @@ function ensurePathRegistration(dir, mark) {
   }
 }
 
+function ensureCurrentPathLauncher(mark) {
+  const target = findWritablePathDir();
+  if (!target) {
+    mark('skip', 'active PATH launcher (no writable PATH directory found)');
+    return false;
+  }
+  writeLaunchers(target, mark, 'active PATH');
+  return true;
+}
+
+function findWritablePathDir() {
+  const dirs = [...new Set((process.env.PATH || '').split(path.delimiter).filter(Boolean))];
+  const npmBin = npmGlobalBinDir();
+  const ranked = dirs
+    .filter(d => !isVolatilePathDir(d))
+    .filter(d => {
+      try { return fs.existsSync(d) && fs.statSync(d).isDirectory() && canWriteDir(d); }
+      catch { return false; }
+    })
+    .sort((a, b) => pathRank(a, npmBin) - pathRank(b, npmBin));
+  return ranked[0] || null;
+}
+
+function pathRank(dir, npmBin) {
+  if (npmBin && samePath(dir, npmBin)) return 0;
+  const lower = dir.toLowerCase();
+  for (const root of userWritableRoots()) {
+    if (root && lower.startsWith(root.toLowerCase())) return 1;
+  }
+  return 5;
+}
+
+function userWritableRoots() {
+  return [
+    process.env.APPDATA,
+    process.env.LOCALAPPDATA,
+    process.env.HOME,
+    process.env.USERPROFILE,
+  ].filter(Boolean).map(p => path.resolve(p));
+}
+
+function npmGlobalBinDir() {
+  try {
+    const prefix = require('child_process').execFileSync('npm', ['config', 'get', 'prefix'], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+    if (!prefix) return null;
+    return currentPlatform() === 'win32' ? prefix : path.join(prefix, 'bin');
+  } catch {
+    return null;
+  }
+}
+
+function isVolatilePathDir(dir) {
+  const lower = dir.toLowerCase();
+  return lower.includes(`${path.sep}_npx${path.sep}`) ||
+    lower.includes(`${path.sep}node_modules${path.sep}.bin`) ||
+    lower.includes(`${path.sep}npm-cache${path.sep}_npx${path.sep}`);
+}
+
+function canWriteDir(dir) {
+  const probe = path.join(dir, `.memoc-write-test-${process.pid}-${Date.now()}`);
+  try {
+    fs.writeFileSync(probe, '');
+    fs.unlinkSync(probe);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 function ensureUnixPathRegistration(binDir) {
   if (process.env.MEMOC_SKIP_PATH_REGISTER === '1') return false;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kevin0181/memoc",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Give AI agents a memory. Scaffolds session-to-session context for Claude Code, Codex, Cursor, and more.",
   "keywords": [
     "ai",