uncle6me-web
bb548b6fdf
leo 2026-08-12：「根本就不應該在 CLI，我要的是一個大家都可以用到的規則。」
「這個實例該用哪些資源」換到安裝器就要重寫一次 ⇒ 依 rules/07-thin-shell.md 的判準
它是**能力**，而它原本住在 cli/src/lib/resource-resolver.ts ⇒ 那本身就是違規。
後果已經真的發生：acr 那條有 Arcrun#97 的修法、安裝器那條沒有，於是安裝器照名字
找、找不到就建一顆空的綁上去 ⇒「我按了更新，工作流和登入全不見了」。
規則搬到 shared/resource-rule/（零依賴 ESM，Node 與 Workers runtime 都直接跑）：
· rule.mjs 規則本體＋把 CF 回應讀成事實的 normalizeLive*
· cf-resource-api.mjs ResourceApi 的 CF REST 實作——**眼睛也共用**：
兩條路各自解讀 CF 回應，只要一邊看不到既有綁定就會去新建，
#97 不需要規則寫錯就能重演
· installer-entry.mjs 安裝器唯一該碰的入口 resolveInstanceResources()
不是做成 cypher 端點的理由（自舉）：這條規則要在「決定怎麼裝」的當下就用得到，
而那時 cypher 可能還不存在（安裝器的工作正是把它生出來）；且輸入是使用者自己帳號的
綁定狀態，不該送去平台換答案。它是純函式，用不著變成服務。
只有一份，機械看守：
· 安裝器直接 import repo archive 裡的原稿，**不需要副本**
· acr 因為 npm pack 打不進套件目錄外的檔案，帶一份逐位元組鏡射
（scripts/sync-resource-rule.mjs 產生；build/test 先跑 --check，差一位元組就紅）
——同 cli/harness/ 產生物＋世代閘的既有慣例
· cli/tests/single-implementation.test.ts 掃全 repo：7 支規則函式的實作只有一處
CLI 淨 -496 行（邏輯是搬走，不是複製）。cf-api.ts 的 CfAccountClient 保留公開介面，
ResourceApi 那七個方法全部委派共用 client。
驗證：cli 58/58 綠（含新增的兩條路一致性 fixture ＋ 三種情境），tsc --noEmit 乾淨。
112 lines
5.0 KiB
TypeScript
112 lines
5.0 KiB
TypeScript
/**
|
||
* 「只有一份」的機械證明。
|
||
*
|
||
* leo 的驗收條件：「改完之後，`grep` 得出『決定用哪些資源』的邏輯**只有一個地方**。
|
||
* 兩個以上呼叫端各自有一份 ⇒ 不算完成。」
|
||
*
|
||
* 這份測試就是把那個 grep 寫成會紅的東西：
|
||
* ① 規則的每一支函式，全 repo 只有 `shared/resource-rule/` 有實作
|
||
* （`cli/src/lib/resource-rule/` 是它的逐位元組鏡射，由 sync 腳本產生並看守，不算第二份）
|
||
* ② 鏡射與原稿逐位元組相同（sync --check 的同一道閘，這裡再測一次讓 `npm test` 也擋得住）
|
||
* ③ 共用層不准長出依賴——有依賴就會有某條路吃不到它
|
||
*/
|
||
|
||
import { test } from 'node:test';
|
||
import assert from 'node:assert/strict';
|
||
import { readFileSync, readdirSync, statSync } from 'node:fs';
|
||
import { join, relative } from 'node:path';
|
||
import { fileURLToPath } from 'node:url';
|
||
import { createHash } from 'node:crypto';
|
||
|
||
const REPO = join(fileURLToPath(new URL('.', import.meta.url)), '..', '..');
|
||
const SOURCE_DIR = join(REPO, 'shared/resource-rule');
|
||
const MIRROR_DIR = join(REPO, 'cli/src/lib/resource-rule');
|
||
|
||
/** 規則的實作特徵：這些**宣告**只准出現在原稿目錄（與它的鏡射）裡。 */
|
||
const RULE_DECLARATIONS = [
|
||
'function planResources',
|
||
'function applyResourcePlan',
|
||
'function shareSameResource',
|
||
'function parseWranglerRequirements',
|
||
'function normalizeLiveBindings',
|
||
'function normalizeLiveVars',
|
||
'function createCloudflareResourceApi',
|
||
];
|
||
|
||
const SKIP_DIRS = new Set([
|
||
'node_modules', '.git', 'dist', '.wrangler', '.worker-builds', '.component-builds',
|
||
'.github-public', 'coverage',
|
||
]);
|
||
|
||
/** 只掃「人會寫程式的地方」；產生物與二進位不掃。 */
|
||
function walk(dir: string, out: string[] = []): string[] {
|
||
for (const name of readdirSync(dir)) {
|
||
if (SKIP_DIRS.has(name)) continue;
|
||
const abs = join(dir, name);
|
||
const st = statSync(abs);
|
||
if (st.isDirectory()) walk(abs, out);
|
||
else if (/\.(ts|tsx|js|mjs|cjs)$/.test(name)) out.push(abs);
|
||
}
|
||
return out;
|
||
}
|
||
|
||
const sha256 = (b: Buffer): string => createHash('sha256').update(b).digest('hex');
|
||
|
||
test('① 規則的實作全 repo 只有一份（原稿目錄 + 它的鏡射，沒有第三處）', () => {
|
||
const files = walk(REPO);
|
||
const offenders: string[] = [];
|
||
|
||
for (const abs of files) {
|
||
const rel = relative(REPO, abs);
|
||
// 原稿與鏡射本來就該有；測試檔在講規則、不是實作規則
|
||
if (rel.startsWith('shared/resource-rule/')) continue;
|
||
if (rel.startsWith('cli/src/lib/resource-rule/')) continue;
|
||
if (rel.startsWith('cli/tests/')) continue;
|
||
if (rel === 'scripts/sync-resource-rule.mjs') continue;
|
||
|
||
const src = readFileSync(abs, 'utf8');
|
||
for (const decl of RULE_DECLARATIONS) {
|
||
if (src.includes(decl)) offenders.push(`${rel} → ${decl}`);
|
||
}
|
||
}
|
||
|
||
assert.deepEqual(offenders, [],
|
||
'「決定用哪些資源」的實作出現在共用層之外——這正是本票要消滅的東西：\n' +
|
||
offenders.map((o) => ` • ${o}`).join('\n') +
|
||
'\n要改規則就改 shared/resource-rule/，呼叫端只准 import。');
|
||
|
||
console.log(`\n ① 掃過 ${files.length} 個原始碼檔，${RULE_DECLARATIONS.length} 支規則函式的實作` +
|
||
' 全部只出現在 shared/resource-rule/（＋機械鏡射）');
|
||
});
|
||
|
||
test('② CLI 帶的那份與原稿逐位元組相同（漂移＝第二份實作偷偷長出來）', () => {
|
||
const files = readdirSync(SOURCE_DIR).filter((f) => f.endsWith('.mjs')).sort();
|
||
assert.ok(files.length > 0, 'shared/resource-rule/ 裡沒有任何 .mjs 原稿');
|
||
|
||
const mirrored = readdirSync(MIRROR_DIR).filter((f) => f.endsWith('.mjs')).sort();
|
||
assert.deepEqual(mirrored, files, '鏡射目錄的檔案清單與原稿不一致');
|
||
|
||
for (const f of files) {
|
||
const a = sha256(readFileSync(join(SOURCE_DIR, f)));
|
||
const b = sha256(readFileSync(join(MIRROR_DIR, f)));
|
||
assert.equal(b, a, `cli/src/lib/resource-rule/${f} 與原稿不一致——不要手改產生物，` +
|
||
'改 shared/resource-rule/ 後跑 node scripts/sync-resource-rule.mjs');
|
||
console.log(` ② ${f.padEnd(24)} sha256 ${a.slice(0, 16)} 原稿 = 鏡射`);
|
||
}
|
||
});
|
||
|
||
test('③ 共用層零外部依賴（只准 import 同目錄的兄弟檔）', () => {
|
||
for (const f of readdirSync(SOURCE_DIR).filter((x) => x.endsWith('.mjs'))) {
|
||
const src = readFileSync(join(SOURCE_DIR, f), 'utf8');
|
||
const imports = [...src.matchAll(/^\s*import\s[^'"]*['"]([^'"]+)['"]/gm)].map((m) => m[1]);
|
||
for (const spec of imports) {
|
||
assert.ok(spec.startsWith('./'),
|
||
`shared/resource-rule/${f} import 了 "${spec}"——共用層一旦有外部依賴，` +
|
||
'就會有某條路（Workers runtime／安裝器）吃不到它。');
|
||
}
|
||
assert.doesNotMatch(src, /require\(|from\s+['"]node:/,
|
||
`shared/resource-rule/${f} 用到 node 專屬 API——Cloudflare Workers 上跑不起來。`);
|
||
console.log(` ③ ${f.padEnd(24)} import: ${imports.length ? imports.join(', ') : '（無）'}`);
|
||
}
|
||
});
|