fix: CLI entry-point guard for npx/bunx invocation (closes #160)

Entry-point guard only matched aimock-cli.js/aimock-cli.ts but npx/bunx
create a symlink named 'aimock', so the guard never fired and the CLI
exited immediately without starting the server.

Add basename match for 'aimock' alongside the existing suffix checks.
Add integration test that invokes the CLI via an 'aimock' symlink.

Author: jpr5

src/__tests__/aimock-cli.test.ts

@@ -1,6 +1,6 @@
 import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
 import { execFile, type ChildProcess } from "node:child_process";
-import { existsSync, mkdtempSync, writeFileSync, rmSync } from "node:fs";
+import { existsSync, mkdtempSync, writeFileSync, rmSync, symlinkSync, unlinkSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join, resolve } from "node:path";
 import { runAimockCli, type AimockCliDeps } from "../aimock-cli.js";
@@ -189,6 +189,66 @@ describe.skipIf(!CLI_AVAILABLE)("aimock CLI: server lifecycle", () => {
   });
 });
 
+describe.skipIf(!CLI_AVAILABLE)("aimock CLI: npx/bunx symlink invocation (#160)", () => {
+  let tmpDir: string;
+  let symlinkPath: string;
+
+  beforeEach(() => {
+    tmpDir = makeTmpDir();
+    symlinkPath = join(tmpDir, "aimock");
+    symlinkSync(CLI_PATH, symlinkPath);
+  });
+
+  afterEach(() => {
+    try {
+      unlinkSync(symlinkPath);
+    } catch {
+      /* already cleaned up */
+    }
+    rmSync(tmpDir, { recursive: true, force: true });
+  });
+
+  it("starts when invoked as 'aimock' symlink (npx/bunx scenario)", async () => {
+    const fixturePath = writeFixtureFile(tmpDir);
+    const configPath = writeConfig(tmpDir, {
+      llm: { fixtures: fixturePath },
+    });
+
+    let out = "";
+    let err = "";
+    const cp = execFile("node", [symlinkPath, "--config", configPath]);
+    cp.stdout?.on("data", (d: string) => {
+      out += d;
+    });
+    cp.stderr?.on("data", (d: string) => {
+      err += d;
+    });
+
+    // Wait for "listening" output — proves the entry-point guard fired
+    await new Promise<void>((resolve, reject) => {
+      const deadline = setTimeout(() => {
+        reject(new Error(`Timed out — stdout: ${out}, stderr: ${err}`));
+      }, 5000);
+      const check = () => {
+        if (/listening on/i.test(out) || /listening on/i.test(err)) {
+          clearTimeout(deadline);
+          resolve();
+          return;
+        }
+        setTimeout(check, 50);
+      };
+      check();
+    });
+
+    expect(out).toContain("listening on");
+
+    cp.kill("SIGTERM");
+    await new Promise<void>((resolve) => {
+      cp.on("close", () => resolve());
+    });
+  });
+});
+
 /* ================================================================== */
 /* Unit tests (exercise runAimockCli directly for coverage)            */
 /* ================================================================== */

src/aimock-cli.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { parseArgs } from "node:util";
-import { resolve } from "node:path";
+import { resolve, basename } from "node:path";
 import { loadConfig, startFromConfig } from "./config-loader.js";
 import { runConvertCli, type ConvertCliDeps } from "./convert.js";
 
@@ -137,7 +137,8 @@ export function runAimockCli(deps: AimockCliDeps = {}): void {
 // Run when executed as a script (not when imported for testing).
 /* v8 ignore start -- entry-point guard, exercised by integration tests */
 const scriptName = process.argv[1] ?? "";
-if (scriptName.endsWith("aimock-cli.js") || scriptName.endsWith("aimock-cli.ts")) {
+const base = basename(scriptName);
+if (base === "aimock" || base === "aimock-cli.js" || base === "aimock-cli.ts") {
   runAimockCli();
 }
 /* v8 ignore stop */