@kevin0181/memoc 1.0.1 → 1.0.4

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 project-local PATH helpers so agents can keep using memoc even when the global/npm bin is not on PATH:
+`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

@@ -220,6 +220,14 @@ function tplMemocShWrapper() {
   return `#!/bin/sh\nexec npx @kevin0181/memoc "$@"\n`;
 }
 
+function defaultUserBinDir() {
+  if (process.env.MEMOC_USER_BIN_DIR) return process.env.MEMOC_USER_BIN_DIR;
+  if (currentPlatform() === 'win32') {
+    return path.join(process.env.LOCALAPPDATA || path.join(process.env.USERPROFILE || process.cwd(), 'AppData', 'Local'), 'memoc', 'bin');
+  }
+  return path.join(process.env.HOME || process.cwd(), '.local', 'bin');
+}
+
 function tplEnvPs1() {
   return `$memocBin = Join-Path $PSScriptRoot 'bin'\n$parts = $env:PATH -split [IO.Path]::PathSeparator\nif ($parts -notcontains $memocBin) {\n  $env:PATH = \"$memocBin$([IO.Path]::PathSeparator)$env:PATH\"\n}\n`;
 }
@@ -245,6 +253,194 @@ function ensurePathHelpers(dir, mark) {
   }
 }
 
+function ensureUserLauncher(mark) {
+  const userBin = defaultUserBinDir();
+  writeLaunchers(userBin, mark, 'user bin');
+  return userBin;
+}
+
+function writeLaunchers(binDir, mark, label) {
+  const files = [
+    [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());
+    if (executable) chmodExecutable(fp);
+    mark(added ? 'add' : 'skip', `${label} ${path.basename(fp)}`);
+  }
+}
+
+function ensurePathRegistration(dir, mark) {
+  ensureCurrentPathLauncher(mark);
+  const binDir = ensureUserLauncher(mark);
+  const pathSep = path.delimiter;
+
+  if ((process.env.PATH || '').split(pathSep).some(p => samePath(p, binDir))) {
+    mark('skip', 'PATH (user memoc bin already active)');
+    return;
+  }
+
+  process.env.PATH = `${binDir}${pathSep}${process.env.PATH || ''}`;
+
+  if (process.env.MEMOC_SKIP_PATH_REGISTER === '1') {
+    mark('skip', 'PATH registration (test mode)');
+    return;
+  }
+
+  if (currentPlatform() !== 'win32') {
+    const updated = ensureUnixPathRegistration(binDir);
+    mark(updated ? 'update' : 'skip', `${currentPlatform()} PATH (${userPathShellHint(binDir)})`);
+    return;
+  }
+
+  try {
+    const current = require('child_process')
+      .execFileSync('powershell.exe', [
+        '-NoProfile',
+        '-ExecutionPolicy', 'Bypass',
+        '-Command',
+        "[Environment]::GetEnvironmentVariable('Path','User')",
+      ], { encoding: 'utf8' })
+      .trim();
+    const parts = current.split(pathSep).filter(Boolean);
+    if (parts.some(p => samePath(p, binDir))) {
+      mark('skip', 'User PATH (memoc bin already registered)');
+      return;
+    }
+    const nextPath = [binDir, ...parts].join(pathSep);
+    require('child_process').execFileSync('powershell.exe', [
+      '-NoProfile',
+      '-ExecutionPolicy', 'Bypass',
+      '-Command',
+      `[Environment]::SetEnvironmentVariable('Path', ${JSON.stringify(nextPath)}, 'User')`,
+    ], { stdio: 'ignore' });
+    mark('update', 'User PATH (memoc bin added; open a new terminal if needed)');
+  } catch {
+    mark('skip', 'User PATH registration failed (use . .\\.memoc\\env.ps1)');
+  }
+}
+
+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;
+
+  const home = process.env.HOME;
+  if (!home) return false;
+
+  const block = [
+    '# memoc PATH',
+    `MEMOC_BIN=${shellSingleQuote(binDir)}`,
+    'case ":$PATH:" in *":$MEMOC_BIN:"*) ;; *) PATH="$MEMOC_BIN:$PATH"; export PATH ;; esac',
+    '# end memoc PATH',
+  ].join('\n');
+
+  const candidates = [
+    path.join(home, '.profile'),
+    path.join(home, '.zshrc'),
+    path.join(home, '.bashrc'),
+  ];
+
+  let changed = false;
+  for (const fp of candidates) {
+    try {
+      const src = fs.existsSync(fp) ? fs.readFileSync(fp, 'utf8') : '';
+      if (src.includes(binDir) || src.includes('# memoc PATH')) continue;
+      fs.appendFileSync(fp, `${src.endsWith('\n') || !src ? '' : '\n'}\n${block}\n`, 'utf8');
+      changed = true;
+    } catch {}
+  }
+  return changed;
+}
+
+function userPathShellHint(binDir) {
+  return `user bin ${binDir} ${process.env.MEMOC_SKIP_PATH_REGISTER === '1' ? 'test mode' : 'registered; open a new terminal if needed'}`;
+}
+
+function currentPlatform() {
+  return process.env.MEMOC_PLATFORM || process.platform;
+}
+
+function shellSingleQuote(value) {
+  return `'${String(value).replace(/'/g, `'\\''`)}'`;
+}
+
+function samePath(a, b) {
+  if (!a || !b) return false;
+  const norm = p => path.resolve(p).toLowerCase().replace(/[\\/]+$/, '');
+  try { return norm(a) === norm(b); } catch { return false; }
+}
+
 function updateSection(filePath, startMark, endMark, inner) {
   if (!fs.existsSync(filePath)) return false;
   const src = fs.readFileSync(filePath, 'utf8');
@@ -290,7 +486,7 @@ function managedBlock() {
 ## Session Start
 - [ ] Read \`.memoc/session-summary.md\`
 - [ ] \`.pending\` exists? → review changed files → update memory if needed → delete it
-- [ ] Put the project-local memoc wrapper on PATH when needed: PowerShell \`. .\\.memoc\\env.ps1\`; sh \`. ./.memoc/env.sh\`
+- [ ] If \`memoc\` is not found in an existing shell, open a new terminal or load the local helper: PowerShell \`. .\\.memoc\\env.ps1\`; sh \`. ./.memoc/env.sh\`
 
 ## Before Opening More Files
 - [ ] Run memoc commands in this order: \`memoc search "<query>"\` → \`.\\.memoc\\bin\\memoc.cmd search "<query>"\` (Windows) or \`.memoc/bin/memoc search "<query>"\` (sh) → \`npx @kevin0181/memoc search "<query>"\`
@@ -1074,6 +1270,7 @@ function run(dir, forceUpdate) {
 
     // PATH helpers — let agents run memoc even when the npm bin is not on PATH
     ensurePathHelpers(dir, mark);
+    ensurePathRegistration(dir, mark);
 
   } else {
     // ── UPDATE MODE
@@ -1166,6 +1363,7 @@ function run(dir, forceUpdate) {
 
     // PATH helpers — let agents run memoc even when the npm bin is not on PATH
     ensurePathHelpers(dir, mark);
+    ensurePathRegistration(dir, mark);
 
     // Append update record to log.md
     const logPath = path.join(memDir, 'log.md');

package/package.json

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