@shimatoworks/stw-agent 0.1.0 → 0.1.1

package/README.md

@@ -51,6 +51,12 @@ stw-agent --help
   `stw-manage` の `docs/guides/案件コンテキストの集め方.md`
 - なぜこの形なのか・過去の判断: `stw-manage` の `docs/records/235-agent-read-api.md`
 
+## 変更履歴
+
+- **0.1.1** — `npm i -g` した `stw-agent`（symlink）が無出力で終了する不具合を修正。
+  実体パスでの直接実行は 0.1.0 でも動いていた
+- 0.1.0 — 最初の公開
+
 ## ライセンス
 
 `UNLICENSED`（社内利用）。npm の scope は公開だが、利用許諾を与えるものではない。

package/bin/stw-agent.mjs

@@ -31,6 +31,7 @@
 // 契約が 2 か所に増えて食い違う。**CLI が自分で断るのは「使い方」だけ**
 // （`--project` と `--channel` の排他など、要求を組み立てられない場合）。
 
+import { realpathSync } from 'node:fs';
 import { readFile } from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
@@ -632,6 +633,41 @@ export async function runCli(argv, overrides = {}) {
   }
 }
 
-const isDirectExecution =
-  process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href;
-if (isDirectExecution) process.exitCode = await runCli(process.argv.slice(2));
+/**
+ * この実行が「CLI として直接呼ばれた」ものか（ライブラリとして import されたのではなく）。
+ *
+ * ## symlink 経由で無出力になっていた（0.1.0 の不具合）
+ *
+ * `npm i -g` が作る `~/.npm-global/bin/stw-agent` は
+ * `../lib/node_modules/@shimatoworks/stw-agent/bin/stw-agent.mjs` への **symlink** である。
+ * このとき Node が渡す値は 2 つで食い違う。
+ *
+ * ```text
+ * process.argv[1]   /Users/x/.npm-global/bin/stw-agent          ← 呼ばれた名前（symlink）
+ * import.meta.url   file:///Users/x/.npm-global/lib/…/bin/stw-agent.mjs  ← 実体
+ * ```
+ *
+ * Node は既定でモジュールの**実体パス**で `import.meta.url` を作るので、
+ * `argv[1]` をそのまま URL 化して比べると一致しない。判定が false になり、
+ * **何も実行せず exit 0**（無出力）になっていた。
+ *
+ * symlink は bin 自体だけでなく**途中のディレクトリ**にもある（macOS の `/tmp` は
+ * `/private/tmp` への symlink）。だから「realpath に直してから比べる」で両方に効く。
+ *
+ * `--preserve-symlinks-main` を付けて起動した場合は逆に `import.meta.url` が
+ * symlink 側になるので、**素の比較も残して両方を許す**。
+ */
+export function isDirectExecution(argv1, moduleUrl) {
+  if (!argv1) return false;
+  if (pathToFileURL(argv1).href === moduleUrl) return true;
+  try {
+    return pathToFileURL(realpathSync(argv1)).href === moduleUrl;
+  } catch {
+    // argv[1] が実在しない（`node --eval` など）。**ここで落とさない。**
+    return false;
+  }
+}
+
+if (isDirectExecution(process.argv[1], import.meta.url)) {
+  process.exitCode = await runCli(process.argv.slice(2));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shimatoworks/stw-agent",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "CLI for the Shimatoworks project-context read API (project registry entries and Slack discussion).",
   "type": "module",
   "license": "UNLICENSED",