universal-dev-standards 6.3.8 → 6.3.9

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

@@ -1,8 +1,8 @@
 ---
 source: ../../CHANGELOG.md
-source_version: 6.3.8
-translation_version: 6.3.8
-last_synced: 2026-08-08
+source_version: 6.3.9
+translation_version: 6.3.9
+last_synced: 2026-08-09
 status: current
 ---
 
@@ -17,6 +17,12 @@ status: current
 
 ## [Unreleased]
 
+## [6.3.9] - 2026-08-09
+
+### 修复
+
+- **标准索引声明的数字與 sync 检查对不上，而两者描述的是同一份 manifest。** 6.3.8 让检查改為透過 registry 解析 manifest 项目；而索引区块仍直接声明 manifest 的 `installedStandards.length`。在一個真实项目上那是 78 對 70，差额正是 `MIGRATION-v6` §2 於 6.0.0 移除的八個机器可读标准——它们在兩個主版本之后仍声明於 manifest 中，因为 `uds update` 不会修剪它们。撇开检查不谈，七十八本来就是错的数字：它就写在「權威清單為 `.standards/manifest.json` 的 `standards` 字段」正上方——把读者指向这个差異的来源、仿佛那就解決了它——并且告訴 agent 去期待八個并不存在的文件。区块现在数的是解析得到文件的项目，其余在下方指名並说明它们为何还在，于是兩個数字都会出现，都不必靠推测。
+
 ## [6.3.8] - 2026-08-08
 
 ### 修复

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

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

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

@@ -1,8 +1,8 @@
 ---
 source: ../../CHANGELOG.md
-source_version: 6.3.8
-translation_version: 6.3.8
-last_synced: 2026-08-08
+source_version: 6.3.9
+translation_version: 6.3.9
+last_synced: 2026-08-09
 status: current
 ---
 
@@ -17,6 +17,12 @@ status: current
 
 ## [Unreleased]
 
+## [6.3.9] - 2026-08-09
+
+### 修正
+
+- **標準索引宣告的數字與 sync 檢查對不上，而兩者描述的是同一份 manifest。** 6.3.8 讓檢查改為透過 registry 解析 manifest 項目；而索引區塊仍直接宣告 manifest 的 `installedStandards.length`。在一個真實專案上那是 78 對 70，差額正是 `MIGRATION-v6` §2 於 6.0.0 移除的八個機器可讀標準——它們在兩個主版本之後仍宣告於 manifest 中，因為 `uds update` 不會修剪它們。撇開檢查不談，七十八本來就是錯的數字：它就寫在「權威清單為 `.standards/manifest.json` 的 `standards` 欄位」正上方——把讀者指向這個差異的來源、彷彿那就解決了它——並且告訴 agent 去期待八個並不存在的檔案。區塊現在數的是解析得到檔案的項目，其餘在下方指名並說明它們為何還在，於是兩個數字都會出現，都不必用推的。
+
 ## [6.3.8] - 2026-08-08
 
 ### 修正

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

@@ -15,7 +15,7 @@ status: current
 
 > **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
 
-**版本**: 6.3.8 | **發布日期**: 2026-07-31 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
+**版本**: 6.3.9 | **發布日期**: 2026-07-31 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
 
 語言無關、框架無關的軟體專案文件標準。透過 AI 原生工作流，確保不同技術堆疊之間的一致性、品質和可維護性。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-dev-standards",
-  "version": "6.3.8",
+  "version": "6.3.9",
   "description": "CLI tool for adopting Universal Development Standards",
   "keywords": [
     "documentation",

package/src/utils/integration-generator.js

@@ -2754,7 +2754,8 @@ export function generateIntegrationContent(config) {
         const standardsIndex = generateStandardsIndex(
           installedStandards,
           format,
-          language
+          language,
+          standardsFormat
         );
 
         standardsContent += complianceInstructions + '\n\n' + standardsIndex;
@@ -3042,13 +3043,27 @@ export function generateComplianceInstructions(
  * @param {string} language - Language: 'en', 'zh-tw', or 'bilingual'
  * @returns {string} Generated standards index
  */
-export function generateStandardsIndex(installedStandards, format, language = 'zh-tw') {
+export function generateStandardsIndex(installedStandards, format, language = 'zh-tw', standardsFormat = 'ai') {
   if (!installedStandards || installedStandards.length === 0) {
     return '';
   }
 
-  const total = installedStandards.length;
-  const optionCount = installedStandards.filter(
+  // Counted after resolution, so the number matches the files that exist.
+  //
+  // It used to be `installedStandards.length` straight off the manifest, which
+  // includes entries with nothing behind them — the eight standards
+  // MIGRATION-v6 §2 removed in 6.0.0 are still declared in manifests two
+  // majors later. On dev-platform that made the block announce 78 while 70
+  // resolve, and it announced it directly above "the authoritative list is the
+  // `standards` field of `.standards/manifest.json`", pointing the reader at
+  // the source of the discrepancy as if it settled it. The sync check counts
+  // resolvable entries, so the two disagreed by exactly those eight.
+  //
+  // Saying 70 and naming the 8 is the honest version of both numbers.
+  const resolvable = installedStandards.filter((e) => resolveStandardFilename(e, standardsFormat));
+  const unresolved = installedStandards.filter((e) => !resolveStandardFilename(e, standardsFormat));
+  const total = resolvable.length;
+  const optionCount = resolvable.filter(
     (p) => p.includes('/options/') || p.includes('\\options\\')
   ).length;
   const coreCount = total - optionCount;
@@ -3059,12 +3074,18 @@ export function generateStandardsIndex(installedStandards, format, language = 'z
     ? [
       `This project has adopted **${total}** UDS standards (${coreCount} core, ${optionCount} options), installed in \`.standards/\`.`,
       '',
-      'The authoritative list is the `standards` field of `.standards/manifest.json`. Read a standard\'s own file to see what it requires — and check its first line, which is where a deprecated standard says so.'
+      'The authoritative list is the `standards` field of `.standards/manifest.json`. Read a standard\'s own file to see what it requires — and check its first line, which is where a deprecated standard says so.',
+      ...(unresolved.length > 0
+        ? ['', `${unresolved.length} further manifest entr${unresolved.length === 1 ? 'y has' : 'ies have'} no installed file and ${unresolved.length === 1 ? 'is' : 'are'} not counted above: ${unresolved.join(', ')}. Standards removed upstream stay in a manifest until someone drops them; \`uds update\` does not prune them.`]
+        : [])
     ]
     : [
       `本專案採用 UDS 標準共 **${total}** 條（core ${coreCount}、options ${optionCount}），安裝於 \`.standards/\`。`,
       '',
-      '權威清單為 `.standards/manifest.json` 的 `standards` 欄位。要知道某標準要求什麼，讀它自己的檔案——並看第一行，已棄用的標準會在那裡寫明。'
+      '權威清單為 `.standards/manifest.json` 的 `standards` 欄位。要知道某標準要求什麼，讀它自己的檔案——並看第一行，已棄用的標準會在那裡寫明。',
+      ...(unresolved.length > 0
+        ? ['', `另有 ${unresolved.length} 筆 manifest 項目沒有已安裝的檔案，未計入上方數字：${unresolved.join('、')}。上游移除的標準會留在 manifest 裡直到有人拿掉它；\`uds update\` 不會修剪它們。`]
+        : [])
     ];
 
   const plainBody = body.map((l) => l.replace(/`/g, ''));

package/standards-registry.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "version": "6.3.8",
+  "version": "6.3.9",
   "lastUpdated": "2026-05-13",
   "description": "Standards registry for universal-dev-standards with integrated skills and AI-optimized formats",
   "formats": {
@@ -58,14 +58,14 @@
     "standards": {
       "name": "universal-dev-standards",
       "url": "https://github.com/AsiaOstrich/universal-dev-standards",
-      "version": "6.3.8"
+      "version": "6.3.9"
     },
     "skills": {
       "name": "universal-dev-standards",
       "url": "https://github.com/AsiaOstrich/universal-dev-standards",
       "localPath": "skills",
       "rawUrl": "https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/skills",
-      "version": "6.3.8",
+      "version": "6.3.9",
       "note": "Skills are now included in the main repository under skills/"
     }
   },
@@ -2236,7 +2236,7 @@
       "id": "license-compliance",
       "name": "License Compliance Standards",
       "nameZh": "授權合規標準",
-      "version": "6.3.8",
+      "version": "6.3.9",
       "source": {
         "human": "core/license-compliance.md",
         "ai": "ai/standards/license-compliance.ai.yaml"
@@ -2248,7 +2248,7 @@
       "id": "verification-oracle",
       "name": "Verification Oracle Standards",
       "nameZh": "驗證 Oracle 標準",
-      "version": "6.3.8",
+      "version": "6.3.9",
       "source": {
         "human": "core/verification-oracle.md",
         "ai": "ai/standards/verification-oracle.ai.yaml"
@@ -2260,7 +2260,7 @@
       "id": "model-provenance",
       "name": "Model Provenance Policy Standards",
       "nameZh": "模型來源政策標準",
-      "version": "6.3.8",
+      "version": "6.3.9",
       "source": {
         "human": "core/model-provenance.md",
         "ai": "ai/standards/model-provenance.ai.yaml"
@@ -2272,7 +2272,7 @@
       "id": "resource-cost-boundary",
       "name": "Resource / Cost Boundary Declaration Standards",
       "nameZh": "資源／成本邊界宣告標準",
-      "version": "6.3.8",
+      "version": "6.3.9",
       "source": {
         "human": "core/resource-cost-boundary.md",
         "ai": "ai/standards/resource-cost-boundary.ai.yaml"