@trawlme/cli 1.19.0 → 1.19.1

package/README.md

@@ -83,7 +83,7 @@ trawl scraps account session set <id> -c <file>
 
 ### Claude Code skills
 
-The CLI bundles a Claude Code skill that teaches Claude how to use `trawl`. Once installed, Claude can manage scraps for you via prompts.
+The CLI bundles 5 Claude Code skills that teach Claude how to use `trawl`. Once installed, Claude can manage scraps for you via prompts.
 
 ```
 trawl skills list                                     List bundled skills and install status

package/dist/index.d.ts

@@ -24,7 +24,18 @@ export declare function resolveCommandName(actionCommand: Command | undefined):
  */
 export declare function collectCommandNames(root: Command): string[];
 export declare function createProgram(): Command;
-/** True when this module is the process entrypoint (not merely imported by a test). */
+/**
+ * True when this module is the process entrypoint (not merely imported by a test).
+ *
+ * npm installs the global bin as a SYMLINK (`bin/trawl` -> `dist/index.js`). For an
+ * ESM entrypoint Node realpaths the module URL (`import.meta.url` = the real
+ * `dist/index.js`) but leaves `process.argv[1]` as the symlink path — so a raw
+ * `moduleUrl === pathToFileURL(argv1).href` compare is FALSE for the normal global
+ * invocation, the guard never fires, and `runCli()` never runs (silent no-op, #103).
+ * Canonicalise both sides with `realpathSync` before comparing. A genuine entrypoint
+ * was just loaded by Node, so both realpath calls resolve; the catch only trips for a
+ * non-file module URL (exotic loaders) — correctly "not the entrypoint".
+ */
 export declare function isEntryPoint(argv1: string | undefined, moduleUrl: string): boolean;
 /**
  * True when the invocation is a pure `--help`/`--version` query, a bare

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { Command, CommanderError } from 'commander';
-import { readFileSync } from 'node:fs';
-import { fileURLToPath, pathToFileURL } from 'node:url';
+import { readFileSync, realpathSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';
 import { login, logout } from './commands/login.js';
 import { scraps } from './commands/scraps.js';
@@ -74,9 +74,27 @@ export function createProgram() {
     program.addCommand(token);
     return program;
 }
-/** True when this module is the process entrypoint (not merely imported by a test). */
+/**
+ * True when this module is the process entrypoint (not merely imported by a test).
+ *
+ * npm installs the global bin as a SYMLINK (`bin/trawl` -> `dist/index.js`). For an
+ * ESM entrypoint Node realpaths the module URL (`import.meta.url` = the real
+ * `dist/index.js`) but leaves `process.argv[1]` as the symlink path — so a raw
+ * `moduleUrl === pathToFileURL(argv1).href` compare is FALSE for the normal global
+ * invocation, the guard never fires, and `runCli()` never runs (silent no-op, #103).
+ * Canonicalise both sides with `realpathSync` before comparing. A genuine entrypoint
+ * was just loaded by Node, so both realpath calls resolve; the catch only trips for a
+ * non-file module URL (exotic loaders) — correctly "not the entrypoint".
+ */
 export function isEntryPoint(argv1, moduleUrl) {
-    return argv1 !== undefined && moduleUrl === pathToFileURL(argv1).href;
+    if (argv1 === undefined)
+        return false;
+    try {
+        return realpathSync(fileURLToPath(moduleUrl)) === realpathSync(argv1);
+    }
+    catch {
+        return false;
+    }
 }
 /**
  * True when the invocation is a pure `--help`/`--version` query, a bare

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trawlme/cli",
-  "version": "1.19.0",
+  "version": "1.19.1",
   "description": "Trawl CLI — manage scraps from the terminal",
   "type": "module",
   "bin": {