/** * daemon-version.test.mjs — 證明**產生端**吐的是裸號(inkstone/arcrun-rag#88) * * 🔴 **這支測試現在釘的是「還沒做到」,不是「做到了」**(誠實優先於好看)。 * * leo 2026-08-17 定「對外號就是三個數字,不要 v」;隔天他問「剛剛不是說不要 v?」, * 因為 `install.arcrun.dev/api/latest` 照舊回 `daemon.version = "v0.18.28"`。 * 那個 `v` 的產地就是本目錄的 `daemon-version.py`。 * * 2026-08-18 實際改成裸號,當場撞到:**那個 `v` 目前身兼「哪一條版本線」的判別器** * (三支閘+`changelogRelFor()` 靠它認出「這份 changelog 是不是 daemon 的」)。 * 一改裸號,daemon 的閘就把雲端那條 `## 1.4.47(…)` 當成 daemon 版本撈走 * ⇒ `installer/scripts/daemon-in-bundle-gate.test.mjs` 的 ①⑮⑯ 轉紅, * 而它們釘的正是 D95 第二輪剛修好的「指到錯的 changelog 卻安靜放行」。 * * ⇒ 所以本檔的測試**斷言的是現況(一律吐 `v`)**,並把「為什麼還不能改」釘成 * 一支會說話的測試。等替代判別器就位(見 `daemon-version.py` 那段註解與 * `inkstone/arcrun-rag#88`),把 ①②③ 的期望值改成裸號,這支就變成驗收。 * * 為什麼住在 `collector/` 而不是 `installer/scripts/`: * 被測的 `daemon-version.py` 是 collector 自己的版本產生器(D95 第一輪把它的三個輸入 * 全搬進 collector/,就是為了讓 collector/ 搬得成獨立 repo)。測試跟著被測物走, * 拆 repo 時不會留下一支指向別人家的孤兒測試。 * * 跑法:node --test collector/cmd/arcrun-app/daemon-version.test.mjs */ import { test } from 'node:test'; import assert from 'node:assert/strict'; import { execFileSync } from 'node:child_process'; import { mkdtempSync, mkdirSync, writeFileSync, readFileSync, copyFileSync, rmSync } from 'node:fs'; import { tmpdir } from 'node:os'; import { join, dirname } from 'node:path'; import { fileURLToPath } from 'node:url'; const HERE = dirname(fileURLToPath(import.meta.url)); const SCRIPT = join(HERE, 'daemon-version.py'); /** * 造一個**只有版本產生器需要的三樣東西**的假 collector 樹,然後真的跑那支腳本。 * 刻意不是 git repo:`source_fingerprint()` 的 `git ls-files` 會失敗 → 回空字串 → 指紋閘不參與, * 這裡要量的是「版本號長什麼樣」,不是指紋機制(它有自己的病史,不要攪在一起)。 */ function runProducer({ changelog, line = '0.18', stamp = false }) { const root = mkdtempSync(join(tmpdir(), 'daemon-version-')); const appDir = join(root, 'cmd', 'arcrun-app'); mkdirSync(appDir, { recursive: true }); writeFileSync(join(root, 'CHANGELOG.md'), changelog); writeFileSync(join(root, 'DAEMON_LINE'), `${line}\n`); copyFileSync(SCRIPT, join(appDir, 'daemon-version.py')); try { const stdout = execFileSync('python3', [ join(appDir, 'daemon-version.py'), ...(stamp ? ['--stamp'] : []), ], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] }); return { version: stdout.trim(), changelogAfter: readFileSync(join(root, 'CHANGELOG.md'), 'utf8') }; } finally { rmSync(root, { recursive: true, force: true }); } } const UNRELEASED = '## 下一版(未發佈)\n\n- 修了一件事\n\n'; const OLD_V = '## v0.18.28(2026-08-16)\n\n- 舊的那一版\n'; test('① 升版:**目前**仍吐帶 v 的版本號(leo 要的裸號尚未落到產生端)', () => { const { version } = runProducer({ changelog: UNRELEASED + OLD_V }); assert.equal(version, 'v0.18.29'); // 🔴 這一行是給未來的人看的:改成裸號之前,先讀 daemon-version.py 裡 // `version = "v%d.%d.%d" % nxt` 上方那段——單獨改這裡會讓 manifest 說謊。 }); test('② 升版並戳章:寫進 changelog 的標題也帶 v(兩邊一致,不會自我矛盾)', () => { const { version, changelogAfter } = runProducer({ changelog: UNRELEASED + OLD_V, stamp: true }); assert.equal(version, 'v0.18.29'); assert.match(changelogAfter, /^## v0\.18\.29(\d{4}-\d{2}-\d{2})$/m); }); test('③ 換版本線:新線第一版(同樣帶 v)', () => { const { version } = runProducer({ changelog: UNRELEASED + OLD_V, line: '0.19' }); assert.equal(version, 'v0.19.0'); }); test('④ 重打同一版:冪等,不虛增(原有行為,未動)', () => { const { version } = runProducer({ changelog: OLD_V }); assert.equal(version, 'v0.18.28'); }); test('⑤ 🔴 判別器還在:daemon 的判斷式**不可以**撈到雲端那條線的版號', () => { // 這支就是「為什麼還不能改裸號」的本體。`v` 目前是兩條版本線唯一的區分方式: // installer/scripts/daemon-notes.mjs 的 DAEMON_RELEASED_RE 只認 `^## vX.Y.Z(`。 // 放寬成 v? 之後,`## 1.4.47(…)` 會被 daemon 的閘當成 daemon 版本。 const CLOUD = '## 1.4.47(2026-08-15)\n\n- 雲端那條線\n'; const strict = /^## (v\d+\.\d+\.\d+)(/m; const loose = /^## (v?\d+\.\d+\.\d+)(/m; assert.equal(CLOUD.match(strict), null, '嚴格版正確地認不出雲端版號'); assert.equal(CLOUD.match(loose)[1], '1.4.47', '放寬版會撈到雲端版號 ⇒ 這就是那三支閘轉紅的原因'); }); test('⑥ 產生端與那條判斷式對得上(兩份實作靠測試對齊,不靠註解)', () => { const { version } = runProducer({ changelog: UNRELEASED + OLD_V, stamp: true }); const { changelogAfter } = runProducer({ changelog: UNRELEASED + OLD_V, stamp: true }); const strict = /^## (v\d+\.\d+\.\d+)(/m; assert.equal(changelogAfter.match(strict)[1], version, '產生端戳出來的標題,必須被 installer 那三支閘的判斷式讀得回同一個版本'); });