@morphixai/mxenv-cli 0.12.0 → 0.12.1

package/README.md

@@ -8,6 +8,8 @@ L3 management face for [mxenv](https://github.com/Morphicai/morphix-env) — mac
 npm i -g @morphixai/mxenv-cli
 ```
 
+> ⚠️ **Do not install `@morphixai/mxenv-cli` and `@morphixai/mxenv` globally side by side** — both register the `mxenv`/`mx-env`/`morphix-env` bin names and the later install silently takes over the symlinks. Keep `mxenv` as a project devDependency and install this package globally (or vice versa, never both).
+
 ## Commands
 
 - `mxenv-cli shell-init` — generate/remove PATH shims and the marked rc block (global + project shim manifests)

package/dist/cli.js

@@ -85,27 +85,29 @@ function writeShims(commands, homeDir = (0, import_os.homedir)()) {
   return { written, removed, skipped };
 }
 function removeAllShims(homeDir = (0, import_os.homedir)()) {
-  const dir = (0, import_mxenv_core.shimsDir)(homeDir);
-  if (!(0, import_fs.existsSync)(dir)) return [];
   const removed = [];
-  for (const file of (0, import_fs.readdirSync)(dir)) {
-    const path = (0, import_path.join)(dir, file);
-    const content = readIfExists(path);
-    if (content !== null && isGeneratedShim(content)) {
-      (0, import_fs.rmSync)(path);
-      removed.push(file);
+  for (const dir of [(0, import_mxenv_core.shimsDir)(homeDir), (0, import_mxenv_core.legacyShimsDir)(homeDir)]) {
+    if (!(0, import_fs.existsSync)(dir)) continue;
+    for (const file of (0, import_fs.readdirSync)(dir)) {
+      const path = (0, import_path.join)(dir, file);
+      const content = readIfExists(path);
+      if (content !== null && isGeneratedShim(content)) {
+        (0, import_fs.rmSync)(path);
+        removed.push(file);
+      }
     }
   }
   return removed;
 }
 function detectHandmadeReservedShims(homeDir = (0, import_os.homedir)()) {
-  const dir = (0, import_mxenv_core.shimsDir)(homeDir);
-  if (!(0, import_fs.existsSync)(dir)) return [];
   const found = [];
-  for (const file of (0, import_fs.readdirSync)(dir)) {
-    if (!import_mxenv_core.RESERVED_SHIM_NAMES.includes(file.toLowerCase())) continue;
-    const content = readIfExists((0, import_path.join)(dir, file));
-    if (content === null || !isGeneratedShim(content)) found.push(file);
+  for (const dir of [(0, import_mxenv_core.shimsDir)(homeDir), (0, import_mxenv_core.legacyShimsDir)(homeDir)]) {
+    if (!(0, import_fs.existsSync)(dir)) continue;
+    for (const file of (0, import_fs.readdirSync)(dir)) {
+      if (!import_mxenv_core.RESERVED_SHIM_NAMES.includes(file.toLowerCase())) continue;
+      const content = readIfExists((0, import_path.join)(dir, file));
+      if (content === null || !isGeneratedShim(content)) found.push(file);
+    }
   }
   return found;
 }
@@ -171,7 +173,7 @@ function findShadowedCommands(commands, originalPath, homeDir = (0, import_os.ho
 // package.json
 var package_default = {
   name: "@morphixai/mxenv-cli",
-  version: "0.12.0",
+  version: "0.12.1",
   description: "L3 management face for mxenv \u2014 machine-level extras like shell-init.",
   license: "MIT",
   author: "MorphixAI <dev@morphixai.com>",
@@ -256,6 +258,7 @@ function parseArgs(argv) {
     write: false,
     remove: false,
     warnPlaintext: false,
+    help: false,
     unknownFlags: []
   };
   let i = 2;
@@ -311,6 +314,8 @@ function parseArgs(argv) {
       args.serve = true;
     } else if (arg === "--warn-plaintext") {
       args.warnPlaintext = true;
+    } else if (arg === "--help" || arg === "-h") {
+      args.help = true;
     } else if (args.command === "run") {
       args.subArgs = argv.slice(i);
       break;
@@ -328,6 +333,10 @@ function configLayers() {
 }
 var bootInfo = { viaShim: false };
 function cmdShellInit(args) {
+  if (args.help) {
+    showHelp();
+    return 0;
+  }
   if (process.platform === "win32") {
     console.error("[mxenv] shell-init is supported on macOS/Linux only; on Windows keep using explicit `mxenv run -- <command>`.");
     return 1;
@@ -425,10 +434,30 @@ function cmdReserved(command) {
   console.error(`[mxenv] "${command}" is reserved for a future release and is not implemented yet.`);
   return 1;
 }
+var PROJECT_COMMANDS = /* @__PURE__ */ new Set([
+  "run",
+  "fetch",
+  "export",
+  "render",
+  "inject",
+  "generate",
+  "gen",
+  "inspect",
+  "migrate",
+  "audit",
+  "edit",
+  "doc",
+  "skill"
+]);
 async function main() {
   (0, import_mxenv_core3.warnDeprecatedBinInvocation)(process.argv[1]);
   Object.assign(bootInfo, (0, import_mxenv_core3.sanitizeBootEnv)());
   const args = parseArgs(process.argv);
+  if (args.noGlobal) (0, import_mxenv_core3.suppressLegacyHomeHint)();
+  if (args.help && args.command !== "shell-init") {
+    showHelp();
+    return 0;
+  }
   switch (args.command) {
     case "shell-init":
       return cmdShellInit(args);
@@ -446,7 +475,14 @@ async function main() {
       console.log(VERSION);
       return 0;
     default:
-      if (args.command) console.error(`[mxenv] Unknown command: ${args.command}`);
+      if (args.command) {
+        console.error(`[mxenv] Unknown command: ${args.command}`);
+        if (args.command === "migrate") {
+          console.error("[mxenv] `migrate --home` (machine-level global-directory migration) runs as `npx @morphixai/mxenv migrate --home` from anywhere; plaintext migration is a project command \u2014 run it inside a project.");
+        } else if (PROJECT_COMMANDS.has(args.command)) {
+          console.error(`[mxenv] "${args.command}" is a project command from @morphixai/mxenv \u2014 run it inside a project (\`npx mxenv ${args.command} \u2026\` or an npm script). This CLI is the machine-level face only.`);
+        }
+      }
       showHelp();
       return args.command ? 1 : 0;
   }

package/dist/index.d.ts

@@ -69,11 +69,12 @@ declare function writeShims(commands: string[], homeDir?: string): {
     removed: string[];
     skipped: string[];
 };
-/** Removes every tool-generated shim; handmade files are left alone. */
+/** Removes every tool-generated shim (current **and** legacy shim dirs); handmade files are left alone. */
 declare function removeAllShims(homeDir?: string): string[];
 /**
  * Handmade files that shadow reserved mxenv names would wrap mxenv itself in
  * a shim (weird but terminating) — surface them so the user can delete them.
+ * Sweeps both the current and the legacy shim dir (0.12.x compat window).
  */
 declare function detectHandmadeReservedShims(homeDir?: string): string[];
 /** Infers the rc file from $SHELL; returns null for shells we do not write. */

package/dist/index.js

@@ -180,27 +180,29 @@ function writeShims(commands, homeDir = (0, import_os.homedir)()) {
   return { written, removed, skipped };
 }
 function removeAllShims(homeDir = (0, import_os.homedir)()) {
-  const dir = (0, import_mxenv_core.shimsDir)(homeDir);
-  if (!(0, import_fs2.existsSync)(dir)) return [];
   const removed = [];
-  for (const file of (0, import_fs2.readdirSync)(dir)) {
-    const path = (0, import_path2.join)(dir, file);
-    const content = readIfExists(path);
-    if (content !== null && isGeneratedShim(content)) {
-      (0, import_fs2.rmSync)(path);
-      removed.push(file);
+  for (const dir of [(0, import_mxenv_core.shimsDir)(homeDir), (0, import_mxenv_core.legacyShimsDir)(homeDir)]) {
+    if (!(0, import_fs2.existsSync)(dir)) continue;
+    for (const file of (0, import_fs2.readdirSync)(dir)) {
+      const path = (0, import_path2.join)(dir, file);
+      const content = readIfExists(path);
+      if (content !== null && isGeneratedShim(content)) {
+        (0, import_fs2.rmSync)(path);
+        removed.push(file);
+      }
     }
   }
   return removed;
 }
 function detectHandmadeReservedShims(homeDir = (0, import_os.homedir)()) {
-  const dir = (0, import_mxenv_core.shimsDir)(homeDir);
-  if (!(0, import_fs2.existsSync)(dir)) return [];
   const found = [];
-  for (const file of (0, import_fs2.readdirSync)(dir)) {
-    if (!import_mxenv_core.RESERVED_SHIM_NAMES.includes(file.toLowerCase())) continue;
-    const content = readIfExists((0, import_path2.join)(dir, file));
-    if (content === null || !isGeneratedShim(content)) found.push(file);
+  for (const dir of [(0, import_mxenv_core.shimsDir)(homeDir), (0, import_mxenv_core.legacyShimsDir)(homeDir)]) {
+    if (!(0, import_fs2.existsSync)(dir)) continue;
+    for (const file of (0, import_fs2.readdirSync)(dir)) {
+      if (!import_mxenv_core.RESERVED_SHIM_NAMES.includes(file.toLowerCase())) continue;
+      const content = readIfExists((0, import_path2.join)(dir, file));
+      if (content === null || !isGeneratedShim(content)) found.push(file);
+    }
   }
   return found;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morphixai/mxenv-cli",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "description": "L3 management face for mxenv \u2014 machine-level extras like shell-init.",
   "license": "MIT",
   "author": "MorphixAI <dev@morphixai.com>",