@warnyin/agents 0.18.0 → 0.18.1

package/CHANGELOG.md

@@ -23,6 +23,12 @@
 
 ## [Unreleased]
 
+## [0.18.1] - 2026-06-13
+
+### Fixed
+- **installer เงียบ exit 0 ไม่ติดตั้งเมื่อรันผ่าน symlink** (critical — กระทบ `npx @warnyin/agents` ของผู้ใช้ปลายทาง + `setup:dogfood`) — main-guard ของ `cli.mjs` เทียบ `path.resolve(process.argv[1])` กับ `fileURLToPath(import.meta.url)` แต่ ESM `import.meta.url` เป็น realpath เสมอ ส่วน `argv[1]` เป็น symlink path (npx รัน bin ผ่าน `node_modules/.bin/` symlink; `setup:dogfood` extract tarball ลง `os.tmpdir()` ที่เป็น symlink บน macOS) → เทียบไม่ตรง → `main()` ไม่ถูกเรียก → ไม่ติดตั้งอะไร. แก้ด้วย `isEntrypoint()` ที่ realpath ทั้งสองฝั่ง (+ fallback `path.resolve`)
+- **setup:dogfood ดึง payload เก่า + รายงานสำเร็จลวง (false-success)** — fix 3 ชั้น: `verifyInstalled` active เมื่อ stamp ขาด + version ≥ 0.17.0 (LR2), `installViaPack` เพิ่ม `prefer-online` สมมาตรกับ npx + `checkTarballVersion` เทียบ version ที่ source, `installViaNpx` ระบุ explicit bin `warnyin-agents`
+
 ## [0.18.0] - 2026-06-13
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warnyin/agents",
-  "version": "0.18.0",
+  "version": "0.18.1",
   "description": "Warnyin Standard Workflow installer — 5-stage ways of work (Discovery/DESIGN/BUILD/VERIFY/SHIP) สำหรับทุกโปรเจกต์",
   "type": "module",
   "license": "MIT",

package/src/bin/cli.mjs

@@ -327,7 +327,31 @@ async function main() {
   }
 }
 
-// main-guard: รันเฉพาะตอน execute ตรง ๆ (ไม่ trigger ตอน import เพื่อ unit-test resolveMode)
-if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+/**
+ * ตรวจว่า module ถูก execute ตรง ๆ (entrypoint) ไม่ใช่ถูก import — เทียบ argv[1] กับ path ของ module เอง
+ * ★ ต้อง realpath argv[1] ด้วย: ESM `import.meta.url` เป็น realpath (resolve symlink) เสมอ แต่ argv[1]
+ *   เป็น path ตามที่ผู้เรียกระบุ (ไม่ resolve symlink). เมื่อรันผ่าน symlink — npx รัน bin ผ่าน
+ *   `.bin/<name>` symlink, setup:dogfood extract tarball ลง `os.tmpdir()` ที่เป็น symlink บน macOS
+ *   (`/var/folders/.../T` → `/private/var/...`) — `path.resolve(argv[1])` จะคืน symlink path ≠ realpath
+ *   ของ module → mismatch → main() ไม่ถูกเรียก → installer เงียบ exit 0 ไม่ทำอะไร (bug critical:
+ *   กระทบทั้ง npx ของผู้ใช้ปลายทาง + setup:dogfood). realpath ทั้งสองฝั่งจึง match ถูกต้อง.
+ * @param {string|undefined} argv1 — process.argv[1] (path ของ script ที่ node รัน)
+ * @param {string} metaUrl — import.meta.url ของ module (เป็น realpath เสมอใน ESM)
+ * @param {(p: string) => string} [realpath] — injectable เพื่อ unit-test (default fs.realpathSync)
+ * @returns {boolean}
+ */
+export function isEntrypoint(argv1, metaUrl, realpath = fs.realpathSync) {
+  if (!argv1) return false
+  const self = fileURLToPath(metaUrl)
+  try {
+    return realpath(argv1) === self
+  } catch {
+    // argv1 resolve เป็น realpath ไม่ได้ (ไฟล์ไม่อยู่จริง ฯลฯ) → fallback เทียบ path ปกติ
+    return path.resolve(argv1) === self
+  }
+}
+
+// main-guard: รันเฉพาะตอน execute ตรง ๆ (ไม่ trigger ตอน import เพื่อ unit-test resolveMode/isEntrypoint)
+if (isEntrypoint(process.argv[1], import.meta.url)) {
   await main()
 }