universal-dev-standards 5.1.0-beta.7 → 5.1.1

package/README.md

@@ -349,6 +349,12 @@ npm install
 npm link
 ```
 
+### Type Checking | 型別檢查
+
+No `typecheck` script is provided — this CLI is pure ESM JavaScript (`.js` / `.mjs`), no TypeScript sources, and no `tsconfig.json`. Static analysis is handled by `npm run lint` (ESLint). Tracked under BUG-A04 (XSPEC-073).
+
+未提供 `typecheck` 腳本 —— 本 CLI 為純 ESM JavaScript（`.js` / `.mjs`），無 TypeScript 原始碼亦無 `tsconfig.json`。靜態分析由 `npm run lint`（ESLint）負責。追蹤於 BUG-A04（XSPEC-073）。
+
 ### Git Hooks | Git 鉤子
 
 Git hooks work through Git Bash, which is included with Git for Windows. No additional configuration needed.

package/bin/uds.js

@@ -128,6 +128,7 @@ program
   .option('--content-layout <layout>', 'Content layout (flat, layered) [default: flat]')
   .option('-y, --yes', 'Use defaults, skip interactive prompts')
   .option('-E, --experimental', 'Enable experimental features (methodology)')
+  .option('--force', 'Bypass UDS source-repo self-adoption guard (DEC-044 / XSPEC-071)')
   .action(initCommand);
 
 program
@@ -173,6 +174,7 @@ program
   .option('--ci', 'CI mode: disable interactive prompts and set exit code on issues')
   .option('--migrate', 'Migrate legacy manifest to hash-based tracking')
   .option('--offline', 'Skip npm registry check for CLI updates')
+  .option('--force', 'Bypass UDS source-repo self-adoption guard (DEC-044 / XSPEC-071)')
   .action(checkCommand);
 
 program

package/bundled/ai/standards/checkin-standards.ai.yaml

@@ -147,6 +147,24 @@ standard:
       instruction: AI must NOT auto-execute git add/commit/push, wait for explicit user approval
       priority: required
 
+    - id: project-file-sync
+      trigger: adding a new source file to disk
+      instruction: >
+        For legacy project formats (e.g. .NET Framework .csproj, MSBuild), every
+        source file on disk must also be registered in the project manifest file.
+        Unregistered files are silently excluded from compilation without any error
+        or warning. Run a pre-build or pre-commit check comparing files on disk
+        against project manifest entries; fail fast on any unregistered file.
+      priority: required
+      applicability: legacy_project_formats
+      examples:
+        - ".NET Framework .csproj (ItemGroup/Compile Include)"
+        - "legacy MSBuild project files"
+      evidence: >
+        Real incident (2026-04): ADAccountManagerV2.aspx.cs added to disk but not
+        registered in MSPlatform.csproj — silently excluded from build, causing
+        production crash with "Cannot load type" error.
+
 physical_spec:
   type: custom_script
   validator:

package/bundled/ai/standards/test-governance.ai.yaml

@@ -146,3 +146,15 @@ standard:
         System tests should stub external dependencies but use real internal services.
         Use SIT environment for system-level validation.
       priority: recommended
+
+    - id: test-execution-continuity
+      trigger: adding or completing a test case
+      instruction: >
+        A test case must be wired to an automated execution trigger (CI gate, build
+        hook, or scheduled run). A test that exists but is never run provides false
+        confidence and is worse than no test at all. Verify that execution history
+        exists before marking test coverage as complete.
+      priority: required
+      evidence: >
+        BUG-A08 post-mortem (2026-04-20): 22 tests existed in UDS but were never
+        executed by any CI gate, passing silently and masking real failures.

package/bundled/ai/standards/testing.ai.yaml

@@ -113,6 +113,20 @@ standard:
       instruction: Use test doubles sparingly; prefer real implementations when fast enough
       priority: recommended
 
+    - id: e2e-precondition-scope
+      trigger: writing E2E globalSetup or environment pre-checks
+      instruction: >
+        E2E environment pre-checks must verify the health of ALL pages and endpoints
+        under test, not just the authentication entry point. A smoke check that only
+        validates the login page will silently pass even when feature pages return
+        HTTP 500. Maintain an explicit list of pages covered by the suite and verify
+        each returns a non-5xx response before running tests.
+      priority: recommended
+      evidence: >
+        Real incident (2026-04): E2E globalSetup only checked Login.aspx health;
+        feature page returned 500 silently — full E2E suite passed with false
+        confidence, masking a production crash.
+
 physical_spec:
   type: custom_script
   validator:

package/bundled/ai/standards/translation-lifecycle-standards.ai.yaml

@@ -0,0 +1,145 @@
+# Translation Lifecycle Standards - AI Optimized
+# Source: core/translation-lifecycle-standards.md
+
+id: translation-lifecycle-standards
+meta:
+  version: "1.0.0"
+  updated: "2026-04-20"
+  status: trial
+  since: "2026-04-20"
+  expires: "2026-10-20"
+  source: core/translation-lifecycle-standards.md
+  description: >
+    MISSING vs OUTDATED distinction, semver-aware severity (PATCH/MINOR/MAJOR),
+    and automation integration for translation sync in multi-locale projects.
+  scope: universal
+  parent: documentation-lifecycle
+
+severity_levels:
+  MISSING:
+    condition: Translation file does not exist
+    exit_code: 1
+    label: "[MISSING]"
+    action: Create before release
+  MAJOR:
+    condition: source major version ahead of translation source_version major
+    exit_code: 1
+    label: "[MAJOR]"
+    action: Update before stable release (blocker)
+  MINOR:
+    condition: source minor version ahead (same major)
+    exit_code: 0
+    label: "[MINOR]"
+    action: Update before next release (advisory)
+  PATCH:
+    condition: source patch version ahead (same major.minor)
+    exit_code: 0
+    label: "[PATCH]"
+    action: Update when convenient (advisory)
+  CURRENT:
+    condition: source_version == current source version
+    exit_code: 0
+    label: "[CURRENT]"
+    action: None
+
+frontmatter_schema:
+  required:
+    - source          # relative path to source file
+    - source_version  # source version at last sync (semver)
+    - translation_version  # translation's own version
+    - last_synced     # YYYY-MM-DD
+    - status          # current | outdated | draft
+
+trigger_conditions:
+  - event: new_standard_added
+    action: Create translation in ALL supported locales
+    severity: MISSING (blocker if absent)
+  - event: standard_patch_bump
+    action: Update frontmatter source_version + last_synced
+    severity: PATCH (advisory)
+  - event: standard_minor_bump
+    action: Translate new content + update frontmatter
+    severity: MINOR (advisory, before next release)
+  - event: standard_major_bump
+    action: Full retranslation + update frontmatter
+    severity: MAJOR (blocker, before current release)
+
+automation:
+  pre_commit_hook:
+    file: .githooks/pre-commit
+    trigger: core/*.md files staged
+    behavior: warn on OUTDATED, never block commit
+    setup: ./scripts/install-hooks.sh
+  release_gate:
+    command: bash scripts/check-translation-sync.sh
+    exit_1_conditions: [MISSING, MAJOR]
+    exit_0_conditions: [MINOR, PATCH, CURRENT]
+  bump_version_integration:
+    command: runs check-translation-sync.sh after version files updated
+    purpose: immediate feedback on translation health at bump time
+
+rules:
+  - id: missing-is-blocker
+    trigger: running release gate check
+    instruction: >
+      Any translation file that does not exist is a release blocker.
+      The release gate must exit 1 if MISSING count > 0.
+    priority: required
+
+  - id: major-gap-is-blocker
+    trigger: running release gate check
+    instruction: >
+      If a translation's source_version MAJOR is behind the current source MAJOR,
+      the translation may be fundamentally incorrect. Exit 1.
+    priority: required
+
+  - id: minor-patch-advisory
+    trigger: running release gate check
+    instruction: >
+      MINOR and PATCH version gaps are advisory. Show warnings but exit 0.
+      Users can still read the translation; it is slightly stale, not wrong.
+    priority: required
+
+  - id: frontmatter-required
+    trigger: creating or updating a translation file
+    instruction: >
+      Every translation file MUST start with YAML frontmatter containing:
+      source, source_version, translation_version, last_synced, status.
+      Files without frontmatter are flagged as MISSING_FRONTMATTER.
+    priority: required
+
+  - id: update-on-source-change
+    trigger: modifying a source standard in core/
+    instruction: >
+      After modifying a core standard, check if translations need updating.
+      At minimum update frontmatter source_version + last_synced for PATCH changes.
+      For MINOR/MAJOR changes, update translated content too.
+    priority: recommended
+
+scenarios:
+  - id: new-standard
+    given: A new standard is added to core/ with no translations
+    when: check-translation-sync.sh runs
+    then: Reports [MISSING] for each locale; exits 1
+    error_code: TRANS-001
+
+  - id: patch-bump
+    given: Source goes from 1.0.0 to 1.0.1; translation source_version=1.0.0
+    when: check-translation-sync.sh runs
+    then: Reports [PATCH] advisory; exits 0
+
+  - id: major-gap
+    given: Source is at 2.0.0; translation source_version=1.5.0
+    when: check-translation-sync.sh runs
+    then: Reports [MAJOR] blocker; exits 1
+    error_code: TRANS-002
+
+integration_points:
+  - system: check-translation-sync.sh
+    role: primary automation; enforces severity levels
+  - system: .githooks/pre-commit
+    role: commit-time reminder when core/ files staged
+  - system: bump-version.sh
+    role: release-time advisory snapshot
+  - system: pre-release-check.sh
+    role: final gate before npm publish (calls check-translation-sync.sh)

package/bundled/core/checkin-standards.md

@@ -2,8 +2,8 @@
 
 > **Language**: English | [繁體中文](../locales/zh-TW/core/checkin-standards.md)
 
-**Version**: 1.5.0
-**Last Updated**: 2026-03-18
+**Version**: 1.6.0
+**Last Updated**: 2026-04-20
 **Applicability**: All software projects using version control
 **Scope**: partial
 **Industry Standards**: SWEBOK v4.0 Chapter 6
@@ -906,6 +906,25 @@ obj/
 node_modules/
 ```
 
+### Legacy Project File Sync (project-file-sync)
+
+> **Applicability**: .NET Framework, MSBuild `.csproj`, and any legacy format that requires explicit file registration.
+
+Legacy project formats (e.g. `.NET Framework .csproj`) do **not** auto-include source files on disk — every file must be explicitly listed in the project manifest. Unregistered files are **silently excluded from compilation** with no error or warning.
+
+**Risk**: You add a new `.cs`/`.aspx.cs` file, rebuild the DLL — the file is excluded. Tests pass (they're testing the old DLL). Production crashes with "Cannot load type".
+
+**Pre-commit check**:
+
+```bash
+# Find .cs files on disk not registered in .csproj
+comm -23 \
+  <(find . -name "*.cs" | sort) \
+  <(grep -oP '(?<=Include=")[^"]+\.cs' MyProject.csproj | sort)
+```
+
+**Rule**: If your project uses a legacy format, run a disk-vs-manifest comparison before every commit. Fail fast on any unregistered file.
+
 ---
 
 ## Common Violations and Solutions

package/bundled/core/test-governance.md

@@ -2,6 +2,8 @@
 
 > **Language**: English | [繁體中文](../locales/zh-TW/core/test-governance.md)
 
+**Version**: 1.1.0
+**Last Updated**: 2026-04-20
 **Applicability**: All software projects
 **Scope**: universal
 
@@ -121,6 +123,7 @@ Release completion criteria (checked before release):
 | enforce-completion-criteria | Completing a task or feature | Verify all required completion criteria are met before marking task/feature as done | Required |
 | pyramid-compliance | Planning test strategy | Follow the 70/20/7/3 pyramid ratio as a guideline. Deviation is acceptable with documented justification | Required |
 | sit-isolation | Running system tests | System tests should stub external dependencies but use real internal services. Use SIT environment for system-level validation | Recommended |
+| test-execution-continuity | Adding or completing a test case | A test case must be wired to an automated execution trigger (CI gate, build hook, or scheduled run). A test that exists but is never run provides false confidence and is worse than no test at all. Verify that execution history exists before marking test coverage as complete. | Required |
 
 ---
 

package/bundled/core/testing-standards.md

@@ -2,8 +2,8 @@
 
 > **Language**: English | [繁體中文](../locales/zh-TW/core/testing-standards.md)
 
-**Version**: 3.1.0
-**Last Updated**: 2026-03-24
+**Version**: 3.2.0
+**Last Updated**: 2026-04-20
 **Applicability**: All software projects
 **Scope**: universal
 **Industry Standards**: ISTQB CTFL v4.0, ISO/IEC/IEEE 29119
@@ -231,6 +231,29 @@ This standard defines actionable testing rules and conventions for AI agents and
 e2e/[feature]/[scenario].[ext]
 ```
 
+#### E2E Precondition Scope (e2e-precondition-scope)
+
+E2E environment pre-checks (`globalSetup`, `beforeAll`) must verify the health of **all pages and endpoints under test**, not just the authentication entry point.
+
+**Anti-pattern** — login-only health check:
+```ts
+// ❌ Passes even when feature pages return 500
+await page.goto('/login');
+expect(response.status()).toBe(200);
+```
+
+**Required pattern** — explicit coverage list:
+```ts
+// ✅ Verify all pages covered by the suite
+const PAGES_UNDER_TEST = ['/login', '/dashboard', '/feature-x'];
+for (const path of PAGES_UNDER_TEST) {
+  const res = await fetch(`${BASE_URL}${path}`);
+  expect(res.status).toBeLessThan(500); // fail fast on 5xx
+}
+```
+
+> **Evidence**: Real incident — E2E `globalSetup` only checked `Login.aspx`; a feature page returned HTTP 500 silently. The full E2E suite passed with false confidence, masking a production crash.
+
 ---
 
 ## Test Doubles

package/bundled/core/translation-lifecycle-standards.md

@@ -0,0 +1,162 @@
+# Translation Lifecycle Standards
+
+> **Language**: English | [繁體中文](../locales/zh-TW/core/translation-lifecycle-standards.md)
+
+**Version**: 1.0.0
+**Last Updated**: 2026-04-20
+**Status**: Trial (expires 2026-10-20)
+**Applicability**: All projects with multi-language documentation
+**Scope**: universal
+**Source**: Derived from UDS BUG-A06 post-mortem (2026-04-20)
+**Parent Standard**: [documentation-lifecycle](documentation-lifecycle.md)
+
+---
+
+## Purpose
+
+Translation lifecycle standards: MISSING vs OUTDATED distinction, semver-aware severity classification, and automation integration (pre-commit hook, release gate).
+
+The `documentation-lifecycle` standard mentions translation sync as a release-gate check, but does not define how to classify or respond to different degrees of drift. This standard fills that gap: a translation that is absent is fundamentally different from one that is slightly stale, and a major-version gap is fundamentally different from a patch bump. Without this distinction, teams either over-block (failing on any staleness) or under-block (ignoring all staleness until it becomes a user-visible defect).
+
+**Evidence (BUG-A06 post-mortem)**:
+1. UDS accumulated 32 missing translations over 3 months of adding new standards without a MISSING gate — only discovered during a Q2 audit.
+2. `anti-hallucination.md` zh-CN was at 1.5.0 while the source shipped 1.5.1 — a new Agent Epistemic Calibration framework section was completely absent in the zh-CN edition, invisible to users.
+
+---
+
+## Core Rules
+
+- `MISSING` (translation file does not exist) is always a release blocker — `exit 1`
+- `MAJOR` version gap (source X vs translation x where X > x) is a release blocker — `exit 1`
+- `MINOR` version gap is advisory — warn prominently, do not block
+- `PATCH` version gap is advisory — warn softly, do not block
+- Severity is determined by semver comparison of `source_version` in translation frontmatter vs current source file version
+- Every translation file MUST have YAML frontmatter with `source`, `source_version`, `translation_version`, `last_synced`, `status`
+- When a source standard is modified, the translation's `source_version` becomes stale immediately — this drift is detectable at commit time via pre-commit hook
+
+---
+
+## Severity Classification
+
+| Level | Condition | Exit Code | Action |
+|-------|-----------|-----------|--------|
+| `MISSING` | Translation file does not exist | 1 | Create before release |
+| `MAJOR` | source MAJOR > translation MAJOR | 1 | Update before stable release |
+| `MINOR` | source MINOR > translation MINOR | 0 | Update before next release (advisory) |
+| `PATCH` | source PATCH > translation PATCH | 0 | Update when convenient (advisory) |
+| `CURRENT` | source_version == translation source_version | 0 | No action needed |
+
+### Semver Diff Formula
+
+```
+diff_level = compare(
+  strip_prerelease(current_source_version),
+  strip_prerelease(translation.source_version)
+)
+
+where: MAJOR if maj differs, MINOR if min differs, else PATCH
+```
+
+---
+
+## Trigger Conditions
+
+| Event | Required Action |
+|-------|----------------|
+| New standard added to `core/` | Create translation in all supported locales (MISSING check blocks release) |
+| Standard version bumped (PATCH) | Update translation's `source_version` + `last_synced` when convenient |
+| Standard version bumped (MINOR) | Update translation content + frontmatter before next release |
+| Standard version bumped (MAJOR) | Update translation content + frontmatter before current release (blocker) |
+| Translation file manually updated | Bump `translation_version` + `last_synced` in frontmatter |
+
+---
+
+## Translation Frontmatter Protocol
+
+Every translation file MUST begin with:
+
+```yaml
+---
+source: ../../../core/<filename>.md          # relative path to source
+source_version: <X.Y.Z>                      # source version at last sync
+translation_version: <X.Y.Z>                 # translation's own version
+last_synced: <YYYY-MM-DD>                    # date of last sync
+status: current | outdated | draft           # human-readable status
+---
+```
+
+When updating a translation after a source change:
+1. Translate the new/changed content
+2. Set `source_version` = new source version
+3. Set `translation_version` = same as `source_version` (or bump independently)
+4. Set `last_synced` = today's date
+5. Set `status: current`
+
+---
+
+## Automation Integration
+
+### Pre-Commit Hook
+
+When `core/*.md` files are staged, the pre-commit hook runs `check-translation-sync.sh` and shows OUTDATED warnings. The hook **never blocks** the commit (blocking at commit time is too disruptive) — it is a reminder only.
+
+Setup: `./scripts/install-hooks.sh` (one-time, after clone)
+
+### Release Gate (`check-translation-sync.sh`)
+
+Run before `npm publish` or as part of `pre-release-check.sh`:
+
+```bash
+bash scripts/check-translation-sync.sh
+# exit 1 if MISSING or MAJOR gap found
+# exit 0 if only MINOR/PATCH gaps (with advisory output)
+```
+
+### Version Bump Integration (`bump-version.sh`)
+
+`bump-version.sh` automatically runs `check-translation-sync.sh` after version files are updated, showing the translation health snapshot at the moment of bump — giving the author immediate feedback on what needs updating before publish.
+
+---
+
+## Scenarios
+
+**Scenario 1 — Standard patch bump (1.0.0 → 1.0.1)**
+- Translation `source_version: 1.0.0`, source now at `1.0.1`
+- Severity: `PATCH` — advisory, exit 0
+- Action: Update at next opportunity, no release block
+
+**Scenario 2 — Standard minor bump with new section (1.0.0 → 1.1.0)**
+- Translation `source_version: 1.0.0`, source now at `1.1.0`
+- Severity: `MINOR` — advisory, exit 0
+- Action: Update before next release; zh-CN users missing new content
+
+**Scenario 3 — Standard major rewrite (1.x.x → 2.0.0)**
+- Translation `source_version: 1.5.0`, source now at `2.0.0`
+- Severity: `MAJOR` — blocker, exit 1
+- Action: Must update before stable release
+
+**Scenario 4 — New standard, no translation file**
+- No `locales/zh-TW/core/new-standard.md` exists
+- Severity: `MISSING` — blocker, exit 1
+- Action: Create translation file before release
+
+---
+
+## Error Codes
+
+| Code | Description |
+|------|-------------|
+| `TRANS-001` | `MISSING_TRANSLATION` — Translation file does not exist for a source standard |
+| `TRANS-002` | `MAJOR_VERSION_GAP` — Translation source_version is MAJOR behind current source |
+| `TRANS-003` | `MISSING_FRONTMATTER` — Translation file lacks required YAML frontmatter |
+| `TRANS-004` | `STALE_SOURCE_REF` — `source` path in frontmatter points to non-existent file |
+
+---
+
+## References
+
+- [documentation-lifecycle.md](documentation-lifecycle.md) — Parent standard; trigger matrix and check pyramid
+- [standard-admission-criteria.md](standard-admission-criteria.md) — How new standards are admitted (triggers TRANS-001)
+- `scripts/check-translation-sync.sh` — Implementation of this standard's automation rules
+- `.githooks/pre-commit` — Pre-commit integration
+- `scripts/install-hooks.sh` — Hook installation

package/bundled/locales/zh-CN/CHANGELOG.md

@@ -1,8 +1,8 @@
 ---
 source: ../../CHANGELOG.md
-source_version: 5.1.0-beta.7
-translation_version: 5.1.0-beta.7
-last_synced: 2026-04-17
+source_version: 5.1.1
+translation_version: 5.1.1
+last_synced: 2026-04-20
 status: current
 ---
 
@@ -17,6 +17,53 @@ status: current
 
 ## [Unreleased]
 
+## [5.1.1] - 2026-04-20
+
+> **补丁版本**：Windows CI 修正、53 个 SKILL.md 补 `name` 字段、三份 `.md` 源文件依 BUG-A08 事后分析新增规则、zh-TW/zh-CN 翻译同步。
+
+### 修正
+- **`cli/src/utils/directory-mapper.js`**：以 `path.basename(dir)` 取代 `dir.split('/').pop()`，修正 Windows CI 路径分隔符兼容性问题（修复 Windows CI runner 上 `directory-mapper.test.js` 测试失败）。
+
+### 新增
+- **`name` 字段** 补齐至 9 个源目录 `skills/*/SKILL.md` 及 44 个 `locales/zh-TW/skills/*/SKILL.md`，符合 Skill 验证工具需求。
+
+### 变更
+- **`core/test-governance.md`** 1.0.0 → 1.1.0：新增 `test-execution-continuity` 规则（BUG-A08 事后分析 — 22 个测试存在但未连接任何 CI 执行触发器）。
+- **`core/checkin-standards.md`** 1.5.0 → 1.6.0：新增旧版项目文件同步（`project-file-sync`）章节 — 磁盘上的每个源文件必须注册于旧版项目 manifest 中。
+- **`core/testing-standards.md`** 3.1.0 → 3.2.0：新增 E2E 前置条件范围（`e2e-precondition-scope`）章节 — E2E 前置检查必须验证所有受测页面/端点，而非仅验证认证入口。
+- **zh-TW 与 zh-CN 翻译** 已同步 `test-governance.md`、`checkin-standards.md`、`testing-standards.md` 三份文件。
+
+[5.1.1]: https://github.com/AsiaOstrich/universal-dev-standards/compare/v5.1.0...v5.1.1
+
+## [5.1.0] - 2026-04-20
+
+> **正式版**：BUG-A06 i18n 完整性 — 新增 32 份缺失翻译、Semver 感知翻译闸门、新增 `translation-lifecycle-standards` UDS 标准。BUG-A07 Shell 测试覆盖 — 20+ 脚本的 bats smoke tests。BUG-A08 假通过测试审计 — 修正 22 个测试。Pre-release Batch 0：6 个标准从 Trial 升至 Adopt（DEC-021/025/031/035/038/040）。标准总数：106 个。
+
+### 新增
+- **`translation-lifecycle-standards`**（Trial，到期 2026-10-20）：新 UDS 标准，定义 MISSING 与 OUTDATED 的区别、Semver 严重度分级（MISSING/MAJOR = 发布阻塞器，MINOR/PATCH = advisory），以及自动化集成（pre-commit hook、release gate、bump-version 集成）。来源：BUG-A06 事后分析。
+- **`.githooks/pre-commit`** + **`scripts/install-hooks.sh`**：commit 时若暂存 `core/*.md` 文件则显示 OUTDATED 警告，永不阻塞 commit。通过 `./scripts/install-hooks.sh` 启用。
+- **32 份 zh-TW 与 zh-CN 翻译**（BUG-A06）：所有核心标准现已有完整 zh-TW 和 zh-CN 翻译，包含 `circuit-breaker`、`token-budget`、`dual-phase-output`、`failure-source-taxonomy`、`immutability-first`、`security-decision`、`capability-declaration`、`recovery-recipe-registry`、`retry-standards`、`health-check-standards`、`timeout-standards`、`skill-standard-alignment-check`、`standard-admission-criteria`、`standard-lifecycle-management`、`packaging-standards`、`frontend-design-standards`、`translation-lifecycle-standards` 等。
+- **bats smoke tests**（BUG-A07）：`tests/scripts/` — 20+ 个 Shell 脚本的 smoke tests，涵盖 `check-translation-sync.sh`、`check-version-sync.sh`、`bump-version.sh`、`install-hooks.sh` 等。
+
+### 变更
+- **`check-translation-sync.sh`**：Semver 感知严重度 — MAJOR 版本落差现在 exit 1（发布阻塞器）；MINOR/PATCH 落差 exit 0 附 advisory 警告。新增 `semver_diff()` 函数与 `[MAJOR]`/`[MINOR]`/`[PATCH]` 严重度标签。
+- **`bump-version.sh`**：更新版本文件后自动执行 `check-translation-sync.sh`，在升版时提供翻译健康状态快照。
+- **`scripts/pre-release-check.sh`**：更新为将 `check-translation-sync.sh` 作为硬闸门（MISSING + MAJOR = exit 1）。
+
+### 修正
+- **zh-CN `anti-hallucination.md`**（BUG-A06）：从 1.5.0 更新至 1.5.1 — 补上缺失的「Agent 认识论校准」章节（Answer/Ask/Abstain 框架，XSPEC-008）。该章节自 2026-04-13 起在 zh-CN 中完全缺失。
+- **22 个假通过测试**（BUG-A08）：修正未正确验证行为的测试，加入真实断言。
+
+### 升至 Adopt（Pre-release Batch 0）
+- `circuit-breaker`（DEC-021）：Trial 6 个月后升至 Adopt
+- `token-budget`（DEC-025）：Trial 6 个月后升至 Adopt
+- `dual-phase-output`（DEC-031）：Trial 6 个月后升至 Adopt
+- `security-decision`（DEC-035）：Trial 6 个月后升至 Adopt
+- `immutability-first`（DEC-038）：Trial 6 个月后升至 Adopt
+- `failure-source-taxonomy`（DEC-040）：Trial 6 个月后升至 Adopt
+
+[5.1.0]: https://github.com/AsiaOstrich/universal-dev-standards/compare/v5.1.0-beta.7...v5.1.0
+
 ## [5.1.0-beta.7] - 2026-04-17
 
 > **Beta Release**：DEC-043 Wave 1 — 六个 Trial 状态标准，涵盖可靠性模式与治理 Meta 框架。

package/bundled/locales/zh-CN/README.md

@@ -6,7 +6,7 @@
 
 > **语言**: [English](../../README.md) | [繁體中文](../zh-TW/README.md) | 简体中文
 
-**版本**: 5.1.0-beta.7 (Pre-release) | **发布日期**: 2026-04-13 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
+**版本**: 5.1.1 | **发布日期**: 2026-04-13 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
 
 语言无关、框架无关的软件项目文档标准。通过 AI 原生工作流，确保不同技术栈之间的一致性、质量和可维护性。
 

package/bundled/locales/zh-CN/core/anti-hallucination.md

@@ -1,8 +1,8 @@
 ---
 source: ../../../core/anti-hallucination.md
-source_version: 1.5.0
-translation_version: 1.5.0
-last_synced: 2026-02-10
+source_version: 1.5.1
+translation_version: 1.5.1
+last_synced: 2026-04-20
 status: current
 ---
 
@@ -742,6 +742,24 @@ Redis 是最佳选择。如果这是单实例应用程序且有
 
 ---
 
+## Agent 认识论校准（v1.4.0，XSPEC-008）
+
+Agent 必须使用 Answer / Ask / Abstain 框架声明其认识论状态：
+
+| 动作 | 使用时机 | 必填字段 |
+|------|---------|---------|
+| `answer` | 拥有足够信息 | 无（completeness/confidence 为选填）|
+| `ask` | 缺少关键信息 | `missing_variables` 列表 |
+| `abstain` | 真正超出能力范围 | `abstain_reason` |
+
+**Fail-closed Agent**（必须始终回答）：`evaluator`、`guardian`
+
+**向后兼容**：缺少 `epistemic` 字段时默认为 `action_type: "answer"`。
+
+参见：XSPEC-008、DEC-014（PassiveQA）
+
+---
+
 ## 相关标准
 
 - [测试标准](testing-standards.md) - 确保验证 AI 分析结果（或使用 `/testing-guide` 技能）
@@ -754,6 +772,7 @@ Redis 是最佳选择。如果这是单实例应用程序且有
 
 | 版本 | 日期 | 变更 |
 |------|------|------|
+| 1.5.1 | 2026-04-13 | 新增: Agent 认识论校准（Answer/Ask/Abstain）框架（XSPEC-008）|
 | 1.4.0 | 2026-01-19 | 新增: 副作用分析规则（第 7 条禁止行为）、工作流程步骤及检查清单项目 |
 | 1.3.1 | 2025-12-24 | 新增: 相关标准章节 |
 | 1.3.0 | 2025-12-22 | 增强: 禁止行为章节，新增详细对比范例 |