Fix bin entry-guard to handle npm symlinked invocation (v0.1.1) (#54)

Found post-publish: 0.1.0's CLI exits 0 with no output when invoked
via npm bin symlink (e.g. ./node_modules/.bin/nativeapptemplate-agent
or `npx nativeapptemplate-agent`). The pipeline never runs.

Root cause: src/index.ts entry-guard compared the wrong shapes:

  if (import.meta.url === `file://${process.argv[1]}`) { main() }

  - import.meta.url resolves to the actual module file URL (e.g.
    file:///.../node_modules/nativeapptemplate-agent/dist/index.js)
  - process.argv[1] under npm bin invocation is the symlink path
    (e.g. /tmp/x/node_modules/.bin/nativeapptemplate-agent)
  - The two never match, the guard fails silently, main() is never
    called, the script exits with no error.

  Direct `node dist/index.js` worked because both sides resolved
  to the same path; symlinked bin invocation didn't, but the bug
  was invisible until the package was published and tested via
  `npx`.

Fix: resolve both sides to canonical (symlink-followed) paths
using realpathSync + fileURLToPath:

  function isEntryPoint(): boolean {
    const argv1 = process.argv[1];
    if (!argv1) return false;
    try {
      const modulePath = fileURLToPath(import.meta.url);
      const argv1Real = realpathSync(argv1);
      return argv1Real === modulePath;
    } catch {
      return false;
    }
  }

Verified post-fix:
  - direct invocation: `node dist/index.js "test spec"` → full
    output, overall: PASS, exit 0.
  - symlink invocation: ln -s dist/index.js /tmp/x/nat-bin &&
    /tmp/x/nat-bin "test spec" → identical output. Confirms the
    fix works for the published-package code path.
  - npm run ci: 19/19 green.

Bumps version 0.1.0 -> 0.1.1 for the patch release.

Out of scope (next, manual):
  - User runs `npm publish` to release 0.1.1.
  - Once 0.1.1 is on the registry, deprecate 0.1.0:
    `npm deprecate nativeapptemplate-agent@0.1.0 \
      "Silent no-op when invoked via npm bin symlink. Use 0.1.1+."`

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: dadachi

package.json

@@ -1,6 +1,6 @@
 {
   "name": "nativeapptemplate-agent",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "A Claude Code agent that turns a natural-language SaaS spec into a working three-platform implementation (Rails API + SwiftUI iOS + Jetpack Compose Android).",
   "type": "module",
   "main": "dist/index.js",

src/index.ts

@@ -1,4 +1,6 @@
 #!/usr/bin/env node
+import { realpathSync } from "node:fs";
+import { fileURLToPath } from "node:url";
 import { dispatch } from "./dispatch.js";
 import { loadDotenvIfPresent } from "./env.js";
 
@@ -23,9 +25,27 @@ export async function main(spec?: string): Promise<void> {
   console.log(`overall: ${result.overallPass ? 'PASS' : 'FAIL'}`);
 }
 
-if (import.meta.url === `file://${process.argv[1]}`) {
+// Entry guard: run main() when this file is the program entry point. Resolve
+// both sides to canonical (symlink-followed) paths so npm bin symlinks (e.g.
+// node_modules/.bin/nativeapptemplate-agent → ../nativeapptemplate-agent/dist/
+// index.js) compare equal to import.meta.url. Without realpath, the guard
+// fails silently on symlinked invocations and main() never runs — the CLI
+// would exit 0 with no output.
+if (isEntryPoint()) {
   main().catch((err) => {
     console.error(err);
     process.exitCode = 1;
   });
 }
+
+function isEntryPoint(): boolean {
+  const argv1 = process.argv[1];
+  if (!argv1) return false;
+  try {
+    const modulePath = fileURLToPath(import.meta.url);
+    const argv1Real = realpathSync(argv1);
+    return argv1Real === modulePath;
+  } catch {
+    return false;
+  }
+}