universal-dev-standards 6.14.0 → 6.14.1-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,7 +1,7 @@
1
1
  # UDS 功能参考手册
2
2
 
3
3
  > Universal Development Standards - 完整功能文档
4
- > Auto-generated | Last updated: 2026-10-13
4
+ > Auto-generated | Last updated: 2026-10-30
5
5
 
6
6
  **Language**: [English](../../../docs/reference/FEATURE-REFERENCE.md) | [繁體中文](../../zh-TW/docs/FEATURE-REFERENCE.md) | 简体中文
7
7
 
@@ -15,9 +15,9 @@
15
15
  4. [代理](#agents) (5)
16
16
  5. [工作流程](#workflows) (5)
17
17
  6. [核心规范](#core-standards) (153)
18
- 7. [脚本](#scripts) (66)
18
+ 7. [脚本](#scripts) (68)
19
19
 
20
- **Total Features: 360**
20
+ **Total Features: 362**
21
21
 
22
22
  ---
23
23
 
@@ -160,7 +160,7 @@
160
160
  | `--add-standard` | With --plan or --apply: also install this standard UDS ships and the project lacks, and record it in the manifest (repeatable; `uds update --plan` lists what is available) |
161
161
  | `--claude-target` | Switch an existing install to a different Claude Code integration target: project (CLAUDE.md) or local (CLAUDE.local.md) — moves the UDS block, keeps your content, no reinstall |
162
162
  | `--locale` | Override locale for skills install (zh-tw, zh-cn, en); also reads .uds/install.yaml + UDS_LOCALE env |
163
- | `--with-hooks` | Install the enforcement hooks that are missing from this already-initialized project (re-detects tools; hooks already there and your own hooks are not touched; with --plan, writes nothing; --force also overwrites edited hook scripts) |
163
+ | `--with-hooks` | Install the enforcement hooks that are missing from this already-initialized project (re-detects tools; hooks already there and your own hooks are not touched; a hook script that is an unmodified copy from an older UDS is replaced, an edited one is kept; with --plan, writes nothing; --force also overwrites edited hook scripts) |
164
164
  | `--ai-tool` | With --with-hooks: comma-separated tools to install hooks for (claude-code, codex, gemini-cli, antigravity) instead of detecting them |
165
165
 
166
166
  ### `uds skills`
@@ -520,7 +520,7 @@
520
520
  | `license-compliance` | 2.1.0 | **Status**: Active | **Updated**: 2026-05-16 | |
521
521
  | `llm-output-validation` | - | |
522
522
  | `logging-standards` | 1.4.0 | |
523
- | `mock-boundary` | 1.1.0 | This document defines rules for what can and cannot be mocked in tests. Its goal |
523
+ | `mock-boundary` | 1.3.0 | This document defines rules for what can and cannot be mocked in tests. Its goal |
524
524
  | `model-provenance` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
525
525
  | `model-selection` | 2.1.0 | Define how to choose **which model** and **how deeply it should think** — two in |
526
526
  | `multi-environment-e2e-testing` | 1.0.0 | **Status**: Active | **Updated**: 2026-05-13 | |
@@ -585,7 +585,7 @@
585
585
  | `timeout-standards` | - | |
586
586
  | `token-budget` | - | |
587
587
  | `translation-lifecycle-standards` | 1.0.1 | Translation lifecycle standards: MISSING vs OUTDATED distinction, semver-aware s |
588
- | `turn-completion-integrity` | 1.5.0 | An agent writes *"I'll do X next"* and then ends the turn without doing X. |
588
+ | `turn-completion-integrity` | 1.5.1 | An agent writes *"I'll do X next"* and then ends the turn without doing X. |
589
589
  | `user-journey-testing` | - | |
590
590
  | `user-story-mapping` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
591
591
  | `verification-evidence` | 1.3.0 | Establish an "Iron Law" that no task can be claimed as complete without verifica |
@@ -623,6 +623,7 @@
623
623
  | `check-error-exit.mjs` | 🔴 沒填就是沒設定,而沒設定會 exit 2, |
624
624
  | `check-external-references.mjs` | External Reference Checker (SPEC-SELFDIAG-001 REQ-5, AC-7) |
625
625
  | `check-home-untouched.mjs` | check-home-untouched — did this run write anywhere UDS writes under HOME? |
626
+ | `check-hook-entry-tests.mjs` | / |
626
627
  | `check-open-work-tracking.mjs` | Open-work-tracking reference checks for OWT-017 to OWT-028 — repo entry point. |
627
628
  | `check-orphan-specs.ps1` | Check Orphan Specs |
628
629
  | `check-orphan-specs.sh` | Orphan Spec Detection Script |
@@ -653,6 +654,7 @@
653
654
  | `fix-manifest-paths.sh` | Manifest Path Fixer |
654
655
  | `generate-adoption-skills.mjs` | Self-Adoption Skill Copy Generator and Drift Gate — XSPEC-385 |
655
656
  | `generate-docs.mjs` | Look up the release date for `version` from CHANGELOG.md's own |
657
+ | `generate-hook-fingerprints.mjs` | Generate the table of hook script contents UDS has shipped (for telling an old UDS copy from an edit). |
656
658
  | `generate-llms-txt.mjs` | llms.txt Generator and Drift Gate — XSPEC-385 |
657
659
  | `generate-locale-coverage.mjs` | Locale Coverage Generator |
658
660
  | `generate-version-manifest.mjs` | Generate Version Manifest (SPEC-SELFDIAG-001 REQ-9, AC-14) |
@@ -1,9 +1,9 @@
1
1
  ---
2
2
  source: ../../CHANGELOG.md
3
- source_version: 6.14.0
4
- translation_version: 6.14.0
5
- last_synced: 2026-10-22
6
- source_hash: 94f283a77794
3
+ source_version: 6.14.1-beta.2
4
+ translation_version: 6.14.1-beta.2
5
+ last_synced: 2026-10-29
6
+ source_hash: 5dcc2a09effc
7
7
  status: current
8
8
  ---
9
9
 
@@ -18,6 +18,43 @@ status: current
18
18
 
19
19
  ## [Unreleased]
20
20
 
21
+ ## [6.14.1-beta.2] - 2026-10-30
22
+
23
+ > **測試版**——以 `npm install -g universal-dev-standards@beta` 安裝。要測什麼、如何退回正式版:[docs/PRE-RELEASE.md](../../docs/PRE-RELEASE.md)。**在 6.14.1-beta.1 之上的一項修正:** `uds update --with-hooks` 現在會替換舊版 UDS 安裝、且沒有人改過的 hook 腳本,即使 hook 已經設定好。因此已有危險指令 hook 的專案會拿到會攔截的版本;beta.1 留下的是從不攔截的舊副本,還得你手動複製檔案。包含以下 6.14.1-beta.1 的所有內容。
24
+
25
+ ### 修正
26
+
27
+ - **`uds update --with-hooks` 現在會替換舊版 UDS 安裝、且沒有人改過的 hook 腳本,即使 hook 已經設定好。** 在 6.14.1-beta.1,已經有危險指令 hook 的專案會留著 6.14.0 的 `scripts/hooks/check-dangerous-cmd.mjs`,它以 exit 1 結束、從不攔截:安裝器看到 hook 設定「已存在」,印出「已安裝、未動」,從不比對旁邊的腳本(實測:`uds update --with-hooks`、`uds update --with-hooks --force` 與 `uds update --apply` 都讓它原封不動)。現在不論設定是否已存在,每個工具都會比對。與出貨版不同的腳本依內容判斷:若與歷代 UDS 某版出貨的內容逐位元相同(忽略換行字元,所以 Windows 在 `core.autocrlf` 下的檢出仍算),表示沒人改過,直接替換,輸出會列出每個檔案與它來自哪一版;其他任何差異都表示被改過:保留、列出,並說明如何強制。歷代內容列在 `cli/src/installers/hook-script-fingerprints.json`,由 `scripts/generate-hook-fingerprints.mjs` 從 git 標籤產生(不是手寫,也不會被縮減);單元測試在 `scripts/hooks/` 任一腳本的內容不在清單裡時失敗,所以改了 hook 就無法不更新清單而提交,`scripts/pre-release-check.sh` 的第 29 步另檢查每個發版標籤。回報依「實際寫入」而非「量測結果」。**`--force`:** 搭配 `--with-hooks` 時,現在連被改過的 hook 腳本也會用出貨版覆蓋,hook 已經安裝時也一樣(以前只在補裝缺少的 hook 時才會),輸出會說覆蓋了幾個;你的修改沒有備份。`--with-hooks --plan` 列出將替換或覆蓋的項目,且不寫任何檔。**`--apply`、單獨的 `--force` 與一般的 `uds update` 不管理 hook 腳本,仍然不會替換它們;**當其中一個是過期且未改過的副本時,它們現在會印一行說明,並指出 `uds update --with-hooks`。**誰會看到差異:** 用 6.14.0 或更早版本安裝過 hook、並在這個版本執行 `uds update --with-hooks` 的人:他們沒改過的每個 hook 腳本都會被替換(替換的檔案有記錄,所以 `uds uninstall` 仍會移除)。**如果你改過 hook 腳本**,它會被保留,在你手動合併或使用 `--force` 之前拿不到之後的修正(以危險指令 hook 來說,就是 exit 2 的修正)。
28
+
29
+ ### 測試
30
+
31
+ - **macOS 發佈後驗收不再丟失步驟輸出的結尾(在 6.14.0 與 6.14.1-beta.1 發現)。** `xspec482-init-interactive-manual` 只在 macOS 上紅:擷取到的輸出在一行中間斷掉,沒有驅動程式最後印的 `DRIVE-EXIT=0`,但 `uds init` 其實成功了。`scripts/beta-acceptance/steps.json` 裡的驗收輔助程式(兩支互動式驅動程式與三支小包裝)在寫出結果後立刻呼叫 `process.exit()`。標準輸出是管線時,Node 在 macOS 上把放不進管線的部分非同步寫出,`process.exit()` 會把剩下的丟掉;Linux 上同樣的寫入是同步的,所以同一步在那裡是綠的。現在它們等寫完才結束(寫入的回呼,或 `process.exitCode`)。驗證:新增一支測試,用真正的驅動程式文字對一個印 300 KB 的替身、搭配讀得很慢的讀取端;在 macOS 上,修改前只收到 65,536 位元組、沒有 `DRIVE-EXIT` 行,修改後收到全部輸出。**沒有證明的部分:** 真實步驟只印約 2.8 KB,放得進管線,而且在維護者的 macOS 上修改前後都通過,所以 CI 上輸出遺失出自這個原因是合理的判讀,不是量到的結果;以本版的發佈後驗收為準。僅動測試與驗收程式;使用者執行的東西沒有變。
32
+
33
+ ## [6.14.1-beta.1] - 2026-10-30
34
+
35
+ > **測試版**——以 `npm install -g universal-dev-standards@beta` 安裝。要測什麼、如何退回正式版:[docs/PRE-RELEASE.md](../../docs/PRE-RELEASE.md)。**安全修正:** 危險指令 hook(`scripts/hooks/check-dangerous-cmd.mjs`)偵測到時以 exit 1 回報,而 Claude Code 不把 exit 1 當成攔截,因此 6.14.0 及更早版本從未擋下任何指令(重播 11,617 筆真實 shell 呼叫,規則命中 26 次,宿主擋下 0 次);現在改以 exit 2 結束,且只判斷指令本身。**在這個版本,已經安裝這個 hook 的專案會保留舊的腳本副本,直到你手動換掉;6.14.1-beta.2(見上)已修正:`uds update --with-hooks` 會替換它。**另修正:提交訊息 hook 略過 `git commit -am "..."` 與其他合併短旗標,以及 `uds update --skills --commands` 只執行兩者其中之一。包含以下 6.14.0 的所有內容。
36
+
37
+ ### 新增
38
+
39
+ - **mock-boundary 1.3.0:能攔截的 hook 必須以宿主執行它的方式測試,並使用各宿主讀取的訊號。** UDS 自己的 `scripts/hooks/check-dangerous-cmd.mjs` 以 exit 1 結束,而 Claude Code 只在 exit 2 時攔截;它的測試匯入比對函式,因此一直是綠的;重播 11,617 筆真實 shell 呼叫,規則命中 26 次,宿主擋下 0 次(已於 #281 修正)。標準現在規定:能擋下工具呼叫、提示或回合的 hook,必須(MUST)至少有一支測試把它當成行程啟動,送入宿主自己的 stdin 資料,並斷言宿主讀取的結束碼或 stdout JSON(H1);匯入並呼叫內部函式的測試不計入,只斷言「非 0」也不計入。同時應該(SHOULD)以同樣方式執行一個放行案例(H2),並確認改掉擋下訊號時測試會變紅(H3)。標準附上一張表,列出 Claude Code、Codex、Gemini CLI 與 Antigravity CLI 在 PreToolUse 類事件中各自視為「已擋下」的訊號,每一列都附官方出處,宿主頁面沒寫的寫「未查到」(Antigravity 的結束碼行為沒有文件,且其 stdin 使用 `toolCall` 而非 `tool_input`)。標準也註明:以同一份規則清單同時決定「該擋」與「不該擋」的真實呼叫重播,只證明接線,不證明規則(重播中 26 次命中全部與規則一致,0 次是真正的危險,而 `rm -fr /` 對它是隱形的)。`turn-completion-integrity` 1.5.1 僅在非 Stop 事件上指向新表;其 Stop 表與規則不變,訊號只寫在一處。對 UDS 自己出貨的 hook 套用 H1 的 CI 閘門是 `npm run check:hook-entry-tests`。**誰會看到差異:** 採用者在下次 `uds update` 取得新文字;除非專案出貨了攔截型 hook(此時標準要求多一支測試),否則專案內沒有任何東西改變。同時更正 `mock-boundary.md` 的版本:同一份內容在 `mock-boundary.md` 寫 1.1.0、在 `mock-boundary.ai.yaml` 寫 1.2.0,現在兩者都是 1.3.0。
40
+
41
+ ### 修正
42
+
43
+ - **危險指令 hook 現在會攔截,且不再擋下一般的清理指令。** `scripts/hooks/check-dangerous-cmd.mjs`(安全標準的 PreToolUse/Bash hook)從來沒有擋下過任何東西:它以 exit 1 結束,而 Claude Code 只在 exit 2 時攔截工具呼叫,所以指令照常執行。它還拿整段 stdin JSON 來比對,而不是 `tool_input.command`。重播 11,617 筆真實 shell 呼叫,舊的 `rm -rf /` 規則命中 26 次,其中 25 次是無害的暫存清理(`rm -rf /tmp/x`),而 `rm -fr /` 與 `rm -r -f /` 卻漏網。現在 hook 讀取 `tool_input.command`(stdin 不是 JSON 時讀取原始指令列),以 exit 2 攔截並在 stderr 寫出規則名稱;`rm` 只在遞迴且目標正好是 `/`、`/*`、`~`、`~/` 或 `$HOME` 時才攔截,旗標順序不拘,`sudo` 之後也適用。原本從未命中任何東西的 fork bomb 規則(`()` 是空的 regex 群組)現在會命中;沒有點號的 `mkfs`、沒有 `if=` 的 `dd of=/dev/…`,以及對 `/` 之下路徑的 `chmod -R 777`(以前會誤中 `/home/me/x`)改以指令詞判斷,而不是子字串。**行為改變:** `rm -rf /home` 與其他根目錄之下的路徑不再被攔截;它們不是這條規則原本要防的對象。命令列模式(`node check-dangerous-cmd.mjs "<command>"`)現在也以 exit 2 而非 1 結束。 **在這個版本,已經安裝這個 hook 的專案不會從 `uds update` 取得修正:** 安裝器會保留 `scripts/hooks/` 裡已有的 hook 腳本(實測:`uds update --with-hooks`、`uds update --with-hooks --force` 與 `uds update --apply` 都讓舊的 `check-dangerous-cmd.mjs` 原封不動,它對 `rm -rf /` 仍以 exit 1 結束),當時的解法是手動把隨附的檔案複製過去覆蓋。6.14.1-beta.2(見上)已修正這一點。在這個版本上執行 `uds init --with-hooks` 的專案拿到的是修正後的腳本。
44
+ - **結構化日誌 hook 現在會傳到模型。** `scripts/hooks/check-logging-standard.mjs`(PostToolUse/Write)原本以 exit 1 結束,Claude Code 視為不攔截的 hook 錯誤,模型看不到訊息;現在改以 exit 2,讓 stderr 的建議回饋給模型,且只判斷寫入的文字(`tool_input.content` 或 `new_string`),不看 payload 的其餘部分。Write 已經發生,所以這無法復原任何事。
45
+ - **提交訊息 hook 現在檢查 git 在命令列上接收訊息的每一種寫法,且不再擋下它誤讀的訊息。** `scripts/hooks/validate-commit-msg.mjs`(PreToolUse/Bash hook)原本只在單獨的 `-m` 之後找訊息,所以 `git commit -am "wip"`(由它新增的進入點測試發現)與其他所有合併短旗標(`-vam`、`-sam`)都不經檢查就放行。現在它像 git 一樣讀取命令:`-m` 出現在短旗標串的任何位置,值附在後面(`-m"msg"`、`-mmsg`、`-am"msg"`)或接在下一個詞,`--message=msg`、`--message msg` 與 git 不含糊的縮寫(`--mess=msg`),以及串接命令中的每一個 `git commit`(`git commit -m "feat: a" && git commit -m wip` 在第二個被擋下)。多個 `-m` 如 git 一樣以空行相連,所以被判斷的是第一個,即主旨。同一次重寫也修掉兩種誤擋,成因是在讀取引號之前就在 `;`、`&&`、`|` 與換行處切開命令:訊息本身含其中之一(`-m "feat: a; b"`),以及 Claude Code 最常寫的 `-m "$(cat <<'EOF' ... EOF)"` 形式——它以前被當成垃圾訊息 `"$(cat` 擋下,現在改以本文判斷。訊息文字不在命令列上的提交照舊放行:`-F`、`-C`/`-c`、`--amend --no-edit`、編輯器、`--fixup`/`--squash`(git 自己寫 `fixup!` 主旨,`-m` 變成本文),以及由 shell 計算的訊息(`-m "$MSG"`、`$(...)`、反引號)。**行為改變:** 以前放行的命令,在訊息不是 Conventional Commit 時現在會被擋下:`-am`/`-vam` 風格的提交、`--message`、串接命令的第二個提交,以及 `VAR=value` 之後的提交。
46
+ - **`uds update --skills --commands` 現在兩者都更新;以前只更新一邊,對另一邊什麼也沒說(在 6.14.0 的 Windows 11 上發現)。** 兩個旗標都帶並加 `--apply` 時,只有指令執行:Skills 段落從未出現,manifest 裡的 Skills 停在舊版本(一個專案:51 個指令已更新,Skills 仍在 6.11.0),結束碼是 0。兩個旗標都帶但不加 `--apply` 時,只有 Skills 執行,`--commands` 被丟掉。旗標的順序沒有差別。原因:兩個步驟各自在完成時結束整個程序,所以另一個永遠沒開始,且不加 `--apply` 的路徑在第一個之後就返回。現在兩者都執行,不論旗標順序都是 Skills 先、指令後,各自印出自己的段落,並以兩者中較差的結束碼結束(任一邊失敗即非 0,`--apply` 對帳已記下的失敗也一樣)。單一範圍(只帶 `--skills` 或只帶 `--commands`)的行為與輸出和以前完全相同,`--plan --skills --commands` 本來就會規劃兩者,沒有改變。**誰會看到差異:** 傳過兩個旗標的人。請再執行一次 `uds update --apply --yes --skills --commands`;經過那次有問題的執行的專案沒有損壞,只是它的 Skills(或指令)落後。有一件事這次沒有改變:只帶單一範圍的 `--apply` 在對帳中失敗時仍以結束碼 0 結束,因為該步驟一向以明確的 0 結束程序。
47
+
48
+ ### 變更
49
+
50
+ - **每個能攔截的 hook 現在都需要一支以宿主方式執行它的測試,並由 CI 強制執行(`npm run check:hook-entry-tests`)。** 新的 CI 工作 `scripts/check-hook-entry-tests.mjs` 從安裝器推出 UDS 出貨的 hook(各標準的 `enforcement:` 區塊,加上 Codex、Gemini 與 Antigravity 的轉接器),凡是能攔截的 hook,除非 `cli/tests` 下有測試真的啟動該腳本、從 stdin 送入宿主格式的 payload 並斷言 exit 2(Stop hook 則斷言 stdout 的決定),否則失敗。未分類的出貨腳本同樣失敗。這是有已記載盲點的靜態檢查,附自我測試與樣本測試。它抓到的第一個是沒有進入點測試的 `validate-commit-msg.mjs`,現已補上一支。這就是上方 `mock-boundary` 1.3.0 規則所指的檢查。它在 UDS 自己的 CI 中執行,不隨 npm 套件出貨。
51
+ - **正式版閘門現在也在發布時執行,且正式版必須等於它驗收過的預覽版(XSPEC-498)。** 閘門原本只在 `scripts/bump-version.mjs` 裡執行,所以從別處建立的 GitHub Release 會繞過它直接走到 `npm publish`;6.14.0 就是這樣發出去的,比它驗收過的預覽版(6.14.0-beta.15)多了四個修正與一次翻譯同步。`publish.yml` 現在對正式版(預覽版不受影響)在 `npm publish` 之前執行 `scripts/beta-acceptance/check-stable-gate.mjs`,checkout 取得完整歷史與 tag。閘門新增一條規則:HEAD 與預覽版 tag 的差異只能是版本檔與發版紀錄(三份更新日誌、`docs/PRE-RELEASE.md`、驗收報告);其他有變動的檔案會使發布被拒絕並被列出,找不到 tag 或不是 git 儲存庫的資料夾同樣被拒絕。版本檔清單移到 `scripts/lib/version-files.mjs`,`bump-version.mjs` 現在由它寫入,寫入者與閘門共用同一份清單。**誰會看到差異:** 發布正式版的維護者;採用者與 CLI 使用者看不到任何變化。
52
+ - **開發相依套件已更新,`npm audit` 高風險公告從 3 筆降為 0。** 只動 `cli/package-lock.json`(`npm audit fix`):`vite` 8.3.0 升到 8.3.5、`brace-expansion` 5.0.9 升到 5.0.12、`source-map-js` 1.2.1 升到 1.2.2,加上它們帶進來的 `rolldown`、`postcss`、`nanoid` 升級;變動的每個套件都是開發相依,所以使用者安裝時不會拿到任何一項(#279)。6.14.0 之後的 Dependabot 更新是 `@commitlint/cli` 與 `@commitlint/config-conventional` 由 21.2.3 升到 21.2.4(根目錄 `devDependencies`,#275、#276),以及 `/cli` 中 `lint-staged` 17.5.1 升到 17.6.0、`@vitest/coverage-v8` 5.0.3 升到 5.0.5、`@inquirer/prompts` 8.7.2 升到 8.7.4(#263、#261、#262)。這三項 `/cli` 更新只改了 `cli/package-lock.json`:`cli/package.json` 與 6.14.0 相同,所以使用者安裝時解析到的版本範圍(`@inquirer/prompts` 是執行期相依,範圍 `^8.7.2`)沒有改變。
53
+
54
+ ### 測試
55
+
56
+ - **修正正式版閘門測試與語系安裝測試在 Windows CI 上的時間上限。** `xspec-471-r5-stable-gate.test.js` 中會多次啟動 `bump-version.mjs` 的八項測試,現在共用一個具名的 120 秒上限(其中四項曾在 `windows-latest` 上超過預設的 30 秒:#284 計入三項,#286 又補上一項);`init-every-declared-locale.test.js` 的每個語系安裝現在各用一個以序號命名的資料夾,因為 `zh-cn` 與 `zh-CN` 在 Windows 與預設的 macOS 上是同一個資料夾,兩個安裝在裡面互搶(準備階段現在會拒絕忽略大小寫後相同的名稱,#280)。僅限測試;使用者執行的東西沒有任何改變。
57
+
21
58
  ## [6.14.0] - 2026-10-22
22
59
 
23
60
  > **正式版發布**:包含下方 6.14.0-beta.1 至 beta.15 的所有內容,加上本節列出的 beta.15 之後的修正。beta.15 已在 Windows、macOS、Linux 完成發布後驗收(0 項失敗)。
@@ -15,7 +15,7 @@ status: current
15
15
 
16
16
  > **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
17
17
 
18
- **版本**: 6.14.0 | **發布日期**: 2026-10-22 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
18
+ **版本**: 6.14.1-beta.2 (Pre-release) | **發布日期**: 2026-10-30 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
19
19
 
20
20
  語言無關、框架無關的軟體專案文件標準。透過 AI 原生工作流,確保不同技術堆疊之間的一致性、品質和可維護性。
21
21
 
@@ -14,6 +14,7 @@ status: current
14
14
  <!-- UDS_SUPPORTED_VERSIONS_START -->
15
15
  | 版本 | 支援狀態 |
16
16
  |------|--------|
17
+ | 6.14.1-beta.2 | ✅ 預發布版本 |
17
18
  | 6.14.0 | ✅ 最新正式版 |
18
19
  | < 6.0.0 | ❌ 已終止支援 |
19
20
  <!-- UDS_SUPPORTED_VERSIONS_END -->
@@ -1,9 +1,9 @@
1
1
  ---
2
2
  source: ../../../core/mock-boundary.md
3
- source_version: 1.1.0
4
- translation_version: 1.1.0
5
- last_synced: 2026-07-01
6
- source_hash: fe4715991a4c
3
+ source_version: 1.3.0
4
+ translation_version: 1.3.0
5
+ last_synced: 2026-10-28
6
+ source_hash: b95f3da59a8e
7
7
  status: current
8
8
  ---
9
9
 
@@ -11,8 +11,8 @@ status: current
11
11
 
12
12
  > **Language**: [English](../../../core/mock-boundary.md) | 繁體中文
13
13
 
14
- **版本**: 1.1.0
15
- **最後更新**: 2026-07-01
14
+ **版本**: 1.3.0
15
+ **最後更新**: 2026-10-28
16
16
  **適用範圍**: 所有具備單元測試與整合測試的軟體專案
17
17
  **Scope**: universal
18
18
  **產業標準**: ISTQB Foundation(Test Doubles), xUnit Patterns(Gerard Meszaros)
@@ -110,6 +110,67 @@ class DeterministicDispatcher implements BackgroundDispatcher {
110
110
 
111
111
  ---
112
112
 
113
+ ## 攔截型 Hook:測宿主的入口,不是測比對函式
114
+
115
+ **hook** 是 AI 宿主(Claude Code、Codex、Gemini CLI、Antigravity CLI 等)在生命週期事件上執行的腳本。有些 hook 能**擋下**宿主原本要做的事:拒絕一次工具呼叫、拒絕一則提示、不讓一個回合結束。對這類 hook,空心測試根本不需要任何 mock——測試只是從來沒碰到宿主會呼叫的入口。
116
+
117
+ hook 有兩層。**判斷層**決定這條指令危不危險;**接線層**讀宿主送來的 stdin 資料,並用宿主會讀的訊號回答(結束碼,或標準輸出的 JSON)。匯入判斷函式的單元測試只練到第一層,而宿主讀的是第二層。結束碼錯、欄位名稱讀錯、輸出格式宿主不認,這些都不會讓那支測試變紅。
118
+
119
+ ### 反例:UDS 自己的危險指令 hook,擋下 0/26
120
+
121
+ `scripts/hooks/check-dangerous-cmd.mjs` 是 PreToolUse hook。偵測到危險指令時它 `exit 1`。Claude Code 只有 `exit 2` 才擋下工具呼叫;其他非 0 結束碼都是不阻擋的 hook 錯誤,指令照樣執行。它的測試匯入比對函式(`isDangerousCommand()`)直接呼叫,所以綠了好幾個月。
122
+
123
+ 重播 11,617 次真實 shell 呼叫(2026-10-27),規則 `rm -rf /` 命中 26 次,宿主擋下 **0** 次。26 次中有 25 次是無害的暫存清理,例如 `rm -rf /tmp/x`;沒有任何一次是真的要清空根目錄。同一個規則還漏掉 `rm -fr /` 與 `rm -r -f /`。修正與入口測試在 PR #281 出貨。
124
+
125
+ ### 規則
126
+
127
+ **H1(MUST)**:能擋下工具呼叫、提示或回合的 hook,至少要有一支測試同時做到下列三件事:
128
+
129
+ 1. **另起行程執行 hook**,用宿主設定檔裡執行它的同一個指令。啟動腳本算數;匯入不算。
130
+ 2. **在 stdin 送入宿主自己的資料**,欄位名稱用該宿主的(見下表:Claude Code 送 `tool_name`/`tool_input`,Antigravity 送 `toolCall`)。照作者想像的宿主格式做出來的資料什麼也證明不了。
131
+ 3. **斷言宿主據以判斷的訊號**:確切的結束碼,或宿主在標準輸出解析的 JSON。「非 0」「有錯誤結束」「stderr 含某個字」都不算:exit 1 是非 0,卻在 Claude Code 上什麼也沒擋。
132
+
133
+ 匯入並呼叫內部函式的測試可以存在,對判斷層也有用,但**不計入** H1。
134
+
135
+ **H2(SHOULD)**:擋下的案例旁邊,用同樣方式跑一個放行的案例,並斷言宿主的放行訊號(例如 exit 0 且標準輸出為空)。一個什麼都擋的 hook 可以通過只測擋下的測試。
136
+
137
+ **H3(SHOULD)**:切斷檢查——把 hook 的擋下訊號改掉(例如 `exit 2` 改成 `exit 1`),確認入口測試變紅。維持綠色,代表那支測試沒在守接線。
138
+
139
+ H1 也適用於「唯一作用是讓宿主讀到它的訊號」的 hook,例如用 exit 2 把 stderr 送到模型面前的 PostToolUse hook。工具已經跑完、無法撤銷,但錯的結束碼一樣會讓這支 hook 無聲無息。
140
+
141
+ ### 各宿主把什麼當成「已擋下」
142
+
143
+ 2026-10-28 取自各宿主自己的官方文件。宿主會改這些約定;採信某一格之前請重查出處。格子寫「未查到」,是讀過該頁而頁面沒寫,不等於「沒有」。
144
+
145
+ | 宿主 | 事件 | 擋下 | 不擋下 | 出處 |
146
+ |---|---|---|---|---|
147
+ | Claude Code | PreToolUse | exit **2**(stderr 是理由);或 exit 0 並在 stdout 輸出 `{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"..."}}` | 其他任何結束碼,**包含 1**,都是不阻擋的 hook 錯誤,動作照常進行;無效的 JSON 同理。文件寫明的例外:設定了 `onFailure: "block"` 的 hook,失敗時會擋下 | code.claude.com/docs/en/hooks:Exit code output、Exit code 2、Other exit codes、Decision control |
148
+ | Claude Code | UserPromptSubmit | exit **2**(提示不會送到模型);或 exit 0 並在 stdout 輸出 `{"decision":"block","reason":"..."}` | 其他任何結束碼(同樣有 `onFailure: "block"` 的例外) | 同頁,Exit code 2 behavior per event |
149
+ | Claude Code | PostToolUse | 不能擋:工具已經執行。exit 2 只會把 stderr 顯示給模型 | 以擋下而言,任何結束碼都不行 | 同頁,Exit code 2 behavior per event |
150
+ | Codex | PreToolUse | exit **2** 並把理由寫到 stderr;或 stdout 輸出 `{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"..."}}`;舊式 `{"decision":"block","reason":"..."}` 也接受 | stdout 的純文字會被忽略;`permissionDecision:"ask"`、`continue:false`、`stopReason`、`suppressOutput` 尚不支援,該次 hook 執行被標為失敗而工具呼叫繼續;其他非 0 結束碼:未查到 | developers.openai.com/codex/hooks,PreToolUse |
151
+ | Codex | UserPromptSubmit | exit **2** 並把理由寫到 stderr;或 stdout 輸出 `{"decision":"block","reason":"..."}` | stdout 純文字會被當成額外脈絡;其他非 0 結束碼:未查到 | 同頁,UserPromptSubmit |
152
+ | Codex | PermissionRequest | stdout 輸出 `{"hookSpecificOutput":{"decision":{"behavior":"deny","message":"..."}}}`;任一 `deny` 即勝出 | 此事件的 exit 2:未查到;stdout 純文字會被忽略 | 同頁,PermissionRequest |
153
+ | Gemini CLI(舊版) | BeforeTool | exit **2**(stderr 是送給 agent 的理由);或 exit 0 並在 stdout 輸出 `{"decision":"deny","reason":"..."}`(`"block"` 是別名)。文件把 JSON 形式列為優先路徑 | 其他任何結束碼只是警告,CLI 繼續 | geminicli.com/docs/hooks/reference,Global hook mechanics 與 BeforeTool |
154
+ | Gemini CLI(舊版) | BeforeAgent、BeforeModel | exit **2** 中止該回合(BeforeAgent 還會把提示從脈絡抹除;BeforeModel 跳過 LLM 呼叫);或 `decision:"deny"` | 同上 | 同頁 |
155
+ | Antigravity CLI(`agy`) | PreToolUse | exit 0 並在 stdout 輸出 `{"decision":"deny","reason":"..."}`(「Hard blocks execution immediately」)。`decision` 欄位必填,其他值為 `allow`、`auto_approve`、`ask`、`force_ask`、`deny_unless_prior_grant`。stdin 帶的是 `toolCall.name` 與 `toolCall.args`,不是 Claude Code 的欄位名 | 結束碼語意:未查到(官方頁面沒寫)。不要假設 Claude Code 的 exit 2 適用。第三方文章宣稱任何非 0 都視為拒絕;那不是官方說法,此處不採用 | antigravity.google/docs/hooks,Input and output contract,PreToolUse |
156
+ | Cursor 與其他宿主 | 任何 | 未查到(本版未調查) | 未查到 | 無 |
157
+
158
+ Stop 類事件(Claude Code 與 Codex 的 Stop、Gemini CLI 的 AfterAgent、Antigravity 的 Stop)**不在這裡重複**。它們的擋下約定寫在 [turn-completion-integrity](turn-completion-integrity.md) 的「支援的執行環境」表,那是唯一寫下它們的地方。該表也記錄了一個 Antigravity hook 失敗後被靜默放行的案例,與本節要防的接線失敗是同一型。
159
+
160
+ ### 重播驗證的是接線,不是規則
161
+
162
+ 把錄下的真實呼叫重播給 hook(例如用 rules-to-guards)是檢查接線的有力方法。但它有一個每次回報結果時都必須講明的限制:若同一份規則清單同時決定「該擋」與「不該擋」,重播只證明 hook 照它的規則運作,**不證明規則本身是對的**。
163
+
164
+ 0/26 之所以量得出來,是因為宿主的約定(exit 2 才擋)是 hook 之外的事實。至於「哪些指令值得擋」,手上只有 hook 自己的比對式:26 次命中都與它一致,真正的危險 0 次,而它沒涵蓋的 `rm -fr /` 永遠不會在重播裡顯示為漏掉,因為答案來源與 hook 共用同一個盲點。
165
+
166
+ 所以重播的結果只能報「接線正確」或「接線錯誤」,不要由它得出「規則正確」。要對規則下結論,請去讀實際命中的指令,或另備一份不看 hook 比對式寫成的獨立答案(見 [verification-oracle](verification-oracle.md))。
167
+
168
+ ### UDS 的執行方式
169
+
170
+ UDS 在 CI 對自己出貨的 hook 檢查這條規則:`node scripts/check-hook-entry-tests.mjs`(npm 指令 `check:hook-entry-tests`),出貨的、能擋下的 hook 若沒有「啟動它、送 stdin、斷言宿主訊號」的測試就判失敗。它是靜態文字分析:只證明「形狀對的測試存在」,不證明 hook 退化時那支測試會變紅——那是 H3 的工作。
171
+
172
+ ---
173
+
113
174
  ## 空心測試偵測
114
175
 
115
176
  提交測試檔之前,請檢查:
@@ -118,6 +179,7 @@ class DeterministicDispatcher implements BackgroundDispatcher {
118
179
  2. **所有斷言都是 `.toHaveBeenCalled()` 系列** → 加入輸出值斷言
119
180
  3. **Mock 路徑與受測對象目錄相同** → 自我引用 mock;移除之
120
181
  4. **Mock 設定行數多於斷言行數** → 很可能是空心測試
182
+ 5. **攔截型 hook 的測試只匯入並呼叫它的函式** → 補一支啟動 hook 並斷言宿主訊號的入口測試(見「攔截型 Hook」)
121
183
 
122
184
  ---
123
185
 
@@ -128,6 +190,7 @@ class DeterministicDispatcher implements BackgroundDispatcher {
128
190
  - **Orphan Mock**:跨模組 mock 卻沒有對應的整合測試
129
191
  - **Security Bypass Mock**:auth/權限邏輯被換成直接放行的 stub
130
192
  - **Database Mock Cascade**:DB 回傳寫死的資料,隱藏真實查詢錯誤
193
+ - **Matcher-Only Hook Test**:攔截型 hook 的測試只匯入並呼叫其判斷函式,從未照宿主的方式執行 hook。hook 什麼也沒擋,測試卻是綠的(UDS 自己的 0/26)
131
194
  - **Poll/Sleep for Background Result**:用 sleep 或 poll 等待 fire-and-forget 背景工作完成。race 依然存在——timeout 只是多數時候把它遮住,同時拖慢整套測試;在共用 runner 上更會把 flakiness 洩漏進其他 MR 的 CI。改注入 deterministic runner 並 await 被追蹤的 task。
132
195
 
133
196
  ---
@@ -142,6 +205,8 @@ class DeterministicDispatcher implements BackgroundDispatcher {
142
205
  | 禁止 mock 安全機制 | 測試涉及 auth/權限 | 使用真實測試使用者 + 真實 token |
143
206
  | 空心審查 | Mock 數量 ≥ import 數量 | 加入輸出值斷言 |
144
207
  | 背景工作禁止 poll/sleep | 測試斷言某個 fire-and-forget 副作用 | 注入 deterministic runner;await 被追蹤的 task |
208
+ | 攔截型 hook 要有宿主入口測試 | hook 能擋下工具呼叫、提示或回合 | 啟動它、在 stdin 送宿主的資料、斷言宿主據以判斷的結束碼或 stdout JSON |
209
+ | 重播只證明接線 | 回報把真實呼叫重播給 hook 的結果 | 報「接線正確」;除非規則另以獨立答案核對過,否則不報「規則正確」 |
145
210
 
146
211
  ---
147
212
 
@@ -150,6 +215,8 @@ class DeterministicDispatcher implements BackgroundDispatcher {
150
215
  - **testing**:Mock 邊界規則適用於測試金字塔的所有測試層級
151
216
  - **test-completeness-dimensions**:維度 8(AI 測試品質)引用了這些規則
152
217
  - **flow-based-testing**:Flow 測試必須遵循 mock 邊界規則
218
+ - **turn-completion-integrity**:Stop 類事件的擋下約定寫在那裡;工具與提示事件的寫在本標準,兩邊都不重複對方
219
+ - **verification-oracle**:用來判斷 hook 規則對不對的答案來源,不得由 hook 自己的比對式推出
153
220
 
154
221
  ---
155
222
 
@@ -159,3 +226,4 @@ class DeterministicDispatcher implements BackgroundDispatcher {
159
226
  |------|------|------|
160
227
  | 1.0.0 | 2026-05-04 | 初始標準:空心測試問題、可/不可 Mock 表格、偵測、反模式、規則摘要 |
161
228
  | 1.1.0 | 2026-07-01 | 新增可注入的背景執行作為 seam(平行於 clock injection):可 Mock 表列、`可注入的背景執行` 章節、`Poll/Sleep for Background Result` 反模式,以及背景工作禁止 poll/sleep 規則(issue #143) |
229
+ | 1.3.0 | 2026-10-28 | 新增《攔截型 Hook:測宿主的入口,不是測比對函式》:H1 MUST(啟動 hook、送宿主的 stdin 資料、斷言宿主據以判斷的訊號)、H2/H3 SHOULD、各宿主擋下訊號對照表,以及「重播驗證接線、不驗證規則」的註記,並以 UDS 自己的 0/26 為反例。版本號與 `mock-boundary.ai.yaml` 對齊——該檔先前把「背景執行」那次新增記為 1.2.0,本檔記為 1.1.0 |
@@ -1,9 +1,9 @@
1
1
  ---
2
2
  source: ../../../core/turn-completion-integrity.md
3
- source_version: 1.5.0
4
- translation_version: 1.5.0
5
- last_synced: 2026-09-29
6
- source_hash: 08579653d9a4
3
+ source_version: 1.5.1
4
+ translation_version: 1.5.1
5
+ last_synced: 2026-10-28
6
+ source_hash: 46c790f970d3
7
7
  status: current
8
8
  ---
9
9
 
@@ -11,8 +11,8 @@ status: current
11
11
 
12
12
  > **Language**: [English](../../../core/turn-completion-integrity.md) | 繁體中文
13
13
 
14
- **版本**: 1.5.0
15
- **最後更新**: 2026-09-29
14
+ **版本**: 1.5.1
15
+ **最後更新**: 2026-10-28
16
16
  **適用範圍**: 任何由 agent 結束回合、把控制權交還給人的執行環境
17
17
  **Scope**: universal
18
18
  **產業標準**: 不宣稱任何來源——由實際觀察到的失敗歸納,見「證據」
@@ -153,6 +153,8 @@ agent 寫下「我接著做 X」,然後結束回合,而 X 沒有做。
153
153
  | Gemini CLI(過時) | AfterAgent | `.gemini/settings.json` | stdout 印 `{"decision":"deny","reason":...}`,exit 0——官方文件標記為優先於 exit code 2 的做法 |
154
154
  | Antigravity CLI(`agy`) | Stop | `.agents/hooks.json` | stdout 印 `{"decision":"continue","reason":...}`,exit 0;`{}` 即放行 |
155
155
 
156
+ 這張表只涵蓋 Stop 類事件。宿主對「擋下工具呼叫或提示」的事件(PreToolUse、UserPromptSubmit、BeforeTool)所讀的訊號,寫在 [mock-boundary](mock-boundary.md) 的「各宿主把什麼當成「已擋下」」表——那是唯一寫下它們的地方,連同「擋下型 hook 必須照宿主的方式執行來測」的規則,本處不重複。
157
+
156
158
  在 Codex 上,接上了不等於會執行。Codex 會略過專案層級的 hook,直到專案被信任、**而且**
157
159
  這一支 hook 的定義在互動式 Codex 工作階段裡透過 `/hooks` 被信任為止;信任紀錄綁在定義的
158
160
  雜湊值上,定義一改就要重新信任。在 `codex exec` 底下,未被信任的 hook 會被略過,而且完全
@@ -1,6 +1,6 @@
1
1
  # UDS 速查表
2
2
 
3
- > Quick reference for all UDS features | Last updated: 2026-10-13
3
+ > Quick reference for all UDS features | Last updated: 2026-10-30
4
4
 
5
5
  **Language**: [English](../../../docs/user/CHEATSHEET.md) | 繁體中文 | [简体中文](../../zh-CN/docs/CHEATSHEET.md)
6
6
 
@@ -356,6 +356,7 @@
356
356
  | `check-error-exit.mjs` | 🔴 沒填就是沒設定,而沒設定會 exit 2, |
357
357
  | `check-external-references.mjs` | External Reference Checker (SPEC-SELFDIAG-001 REQ- |
358
358
  | `check-home-untouched.mjs` | check-home-untouched — did this run write anywhere |
359
+ | `check-hook-entry-tests.mjs` | / |
359
360
  | `check-open-work-tracking.mjs` | Open-work-tracking reference checks for OWT-017 to |
360
361
  | `check-orphan-specs.ps1` | Check Orphan Specs |
361
362
  | `check-orphan-specs.sh` | Orphan Spec Detection Script |
@@ -386,6 +387,7 @@
386
387
  | `fix-manifest-paths.sh` | Manifest Path Fixer |
387
388
  | `generate-adoption-skills.mjs` | Self-Adoption Skill Copy Generator and Drift Gate |
388
389
  | `generate-docs.mjs` | Look up the release date for `version` from CHANGE |
390
+ | `generate-hook-fingerprints.mjs` | Generate the table of hook script contents UDS has |
389
391
  | `generate-llms-txt.mjs` | llms.txt Generator and Drift Gate — XSPEC-385 |
390
392
  | `generate-locale-coverage.mjs` | Locale Coverage Generator |
391
393
  | `generate-version-manifest.mjs` | Generate Version Manifest (SPEC-SELFDIAG-001 REQ-9 |
@@ -1,7 +1,7 @@
1
1
  # UDS 功能參考手冊
2
2
 
3
3
  > Universal Development Standards - 完整功能文件
4
- > Auto-generated | Last updated: 2026-10-13
4
+ > Auto-generated | Last updated: 2026-10-30
5
5
 
6
6
  **Language**: [English](../../../docs/reference/FEATURE-REFERENCE.md) | 繁體中文 | [简体中文](../../zh-CN/docs/FEATURE-REFERENCE.md)
7
7
 
@@ -15,9 +15,9 @@
15
15
  4. [代理](#agents) (5)
16
16
  5. [工作流程](#workflows) (5)
17
17
  6. [核心規範](#core-standards) (153)
18
- 7. [腳本](#scripts) (66)
18
+ 7. [腳本](#scripts) (68)
19
19
 
20
- **Total Features: 360**
20
+ **Total Features: 362**
21
21
 
22
22
  ---
23
23
 
@@ -160,7 +160,7 @@
160
160
  | `--add-standard` | With --plan or --apply: also install this standard UDS ships and the project lacks, and record it in the manifest (repeatable; `uds update --plan` lists what is available) |
161
161
  | `--claude-target` | Switch an existing install to a different Claude Code integration target: project (CLAUDE.md) or local (CLAUDE.local.md) — moves the UDS block, keeps your content, no reinstall |
162
162
  | `--locale` | Override locale for skills install (zh-tw, zh-cn, en); also reads .uds/install.yaml + UDS_LOCALE env |
163
- | `--with-hooks` | Install the enforcement hooks that are missing from this already-initialized project (re-detects tools; hooks already there and your own hooks are not touched; with --plan, writes nothing; --force also overwrites edited hook scripts) |
163
+ | `--with-hooks` | Install the enforcement hooks that are missing from this already-initialized project (re-detects tools; hooks already there and your own hooks are not touched; a hook script that is an unmodified copy from an older UDS is replaced, an edited one is kept; with --plan, writes nothing; --force also overwrites edited hook scripts) |
164
164
  | `--ai-tool` | With --with-hooks: comma-separated tools to install hooks for (claude-code, codex, gemini-cli, antigravity) instead of detecting them |
165
165
 
166
166
  ### `uds skills`
@@ -520,7 +520,7 @@
520
520
  | `license-compliance` | 2.1.0 | **Status**: Active | **Updated**: 2026-05-16 | |
521
521
  | `llm-output-validation` | - | |
522
522
  | `logging-standards` | 1.4.0 | |
523
- | `mock-boundary` | 1.1.0 | This document defines rules for what can and cannot be mocked in tests. Its goal |
523
+ | `mock-boundary` | 1.3.0 | This document defines rules for what can and cannot be mocked in tests. Its goal |
524
524
  | `model-provenance` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
525
525
  | `model-selection` | 2.1.0 | Define how to choose **which model** and **how deeply it should think** — two in |
526
526
  | `multi-environment-e2e-testing` | 1.0.0 | **Status**: Active | **Updated**: 2026-05-13 | |
@@ -585,7 +585,7 @@
585
585
  | `timeout-standards` | - | |
586
586
  | `token-budget` | - | |
587
587
  | `translation-lifecycle-standards` | 1.0.1 | Translation lifecycle standards: MISSING vs OUTDATED distinction, semver-aware s |
588
- | `turn-completion-integrity` | 1.5.0 | An agent writes *"I'll do X next"* and then ends the turn without doing X. |
588
+ | `turn-completion-integrity` | 1.5.1 | An agent writes *"I'll do X next"* and then ends the turn without doing X. |
589
589
  | `user-journey-testing` | - | |
590
590
  | `user-story-mapping` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
591
591
  | `verification-evidence` | 1.3.0 | Establish an "Iron Law" that no task can be claimed as complete without verifica |
@@ -623,6 +623,7 @@
623
623
  | `check-error-exit.mjs` | 🔴 沒填就是沒設定,而沒設定會 exit 2, |
624
624
  | `check-external-references.mjs` | External Reference Checker (SPEC-SELFDIAG-001 REQ-5, AC-7) |
625
625
  | `check-home-untouched.mjs` | check-home-untouched — did this run write anywhere UDS writes under HOME? |
626
+ | `check-hook-entry-tests.mjs` | / |
626
627
  | `check-open-work-tracking.mjs` | Open-work-tracking reference checks for OWT-017 to OWT-028 — repo entry point. |
627
628
  | `check-orphan-specs.ps1` | Check Orphan Specs |
628
629
  | `check-orphan-specs.sh` | Orphan Spec Detection Script |
@@ -653,6 +654,7 @@
653
654
  | `fix-manifest-paths.sh` | Manifest Path Fixer |
654
655
  | `generate-adoption-skills.mjs` | Self-Adoption Skill Copy Generator and Drift Gate — XSPEC-385 |
655
656
  | `generate-docs.mjs` | Look up the release date for `version` from CHANGELOG.md's own |
657
+ | `generate-hook-fingerprints.mjs` | Generate the table of hook script contents UDS has shipped (for telling an old UDS copy from an edit). |
656
658
  | `generate-llms-txt.mjs` | llms.txt Generator and Drift Gate — XSPEC-385 |
657
659
  | `generate-locale-coverage.mjs` | Locale Coverage Generator |
658
660
  | `generate-version-manifest.mjs` | Generate Version Manifest (SPEC-SELFDIAG-001 REQ-9, AC-14) |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "universal-dev-standards",
3
- "version": "6.14.0",
3
+ "version": "6.14.1-beta.2",
4
4
  "description": "CLI tool for adopting Universal Development Standards",
5
5
  "keywords": [
6
6
  "documentation",