@mnemom/mnemom 0.14.0 → 0.14.1

package/dist/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { pathToFileURL } from "node:url";
 import { program } from "commander";
+import { isEntrypoint } from "./lib/entrypoint.js";
 import { CLI_VERSION } from "./version.js";
 import { statusCommand } from "./commands/status.js";
 import { integrityCommand } from "./commands/integrity.js";
@@ -1326,8 +1326,8 @@ program
 // statically introspect the command surface WITHOUT executing the CLI.
 export { program };
 // Parse argv only when invoked as the CLI entrypoint — not when imported.
-// (ESM has no `require.main`; compare this module's URL to argv[1].)
-const invokedDirectly = process.argv[1] !== undefined && import.meta.url === pathToFileURL(process.argv[1]).href;
-if (invokedDirectly) {
+// The symlink-safe guard lives in ./lib/entrypoint so it can be unit-tested
+// without executing this module's top-level parse().
+if (isEntrypoint(import.meta.url, process.argv[1])) {
     program.parse();
 }

package/dist/lib/entrypoint.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Decide whether the current module is being run as the CLI entrypoint
+ * (so it should `program.parse()`) rather than merely imported.
+ *
+ * ESM has no `require.main`, so we compare this module's URL to argv[1].
+ * The catch: npm installs the global bin as a SYMLINK
+ * (…/bin/mnemom → …/dist/index.js). When invoked through that symlink Node
+ * sets `process.argv[1]` to the symlink path while `import.meta.url` is the
+ * real resolved file — so a naive comparison never matches and the CLI
+ * silently no-ops. Canonicalize argv[1] with `realpathSync` before comparing
+ * so the symlinked global bin and the real path both resolve to the same URL.
+ *
+ * `realpathSync` is wrapped in try/catch because argv[1] may be missing or
+ * point at a path that no longer exists (ENOENT); in that case we return
+ * `false` to preserve the safe default of not auto-running.
+ */
+export declare function isEntrypoint(moduleUrl: string, argv1: string | undefined): boolean;

package/dist/lib/entrypoint.js

@@ -0,0 +1,28 @@
+import { realpathSync } from "node:fs";
+import { pathToFileURL } from "node:url";
+/**
+ * Decide whether the current module is being run as the CLI entrypoint
+ * (so it should `program.parse()`) rather than merely imported.
+ *
+ * ESM has no `require.main`, so we compare this module's URL to argv[1].
+ * The catch: npm installs the global bin as a SYMLINK
+ * (…/bin/mnemom → …/dist/index.js). When invoked through that symlink Node
+ * sets `process.argv[1]` to the symlink path while `import.meta.url` is the
+ * real resolved file — so a naive comparison never matches and the CLI
+ * silently no-ops. Canonicalize argv[1] with `realpathSync` before comparing
+ * so the symlinked global bin and the real path both resolve to the same URL.
+ *
+ * `realpathSync` is wrapped in try/catch because argv[1] may be missing or
+ * point at a path that no longer exists (ENOENT); in that case we return
+ * `false` to preserve the safe default of not auto-running.
+ */
+export function isEntrypoint(moduleUrl, argv1) {
+    if (argv1 === undefined)
+        return false;
+    try {
+        return pathToFileURL(realpathSync(argv1)).href === moduleUrl;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/smoltbot-shim.js

@@ -2,6 +2,9 @@
 // smoltbot is deprecated — this shim prints a warning then hands off to mnemom
 process.stderr.write("\n⚠️  The smoltbot command is deprecated. Use mnemom instead.\n" +
     "   Install: npm install -g @mnemom/mnemom\n\n");
-// Dynamic import runs index.ts which calls program.parse(process.argv) automatically
-await import("./index.js");
+// argv[1] here is the smoltbot bin path, so index.js's entrypoint guard never
+// fires (it resolves to dist/index.js, not this shim). Import the assembled
+// program and call parse() explicitly instead of relying on its auto-parse.
+const { program } = await import("./index.js");
+program.parse(process.argv);
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mnemom/mnemom",
-  "version": "0.14.0",
+  "version": "0.14.1",
   "description": "Transparent AI agent tracing",
   "type": "module",
   "bin": {