universal-dev-standards 6.14.0-beta.9 → 6.14.0

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.
Files changed (711) hide show
  1. package/bin/uds.js +12 -1
  2. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  3. package/bundled/ai/standards/commit-message.ai.yaml +12 -2
  4. package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
  5. package/bundled/core/commit-message-guide.md +22 -19
  6. package/bundled/core/secret-management-standards.md +13 -1
  7. package/bundled/extensions/locales/zh-tw.md +19 -19
  8. package/bundled/hooks/validate-commit-msg.mjs +52 -9
  9. package/bundled/locales/zh-CN/CHANGELOG.md +2309 -1110
  10. package/bundled/locales/zh-CN/CLAUDE.md +987 -101
  11. package/bundled/locales/zh-CN/README.md +3 -3
  12. package/bundled/locales/zh-CN/SECURITY.md +3 -3
  13. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  14. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
  15. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  16. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
  17. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
  18. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
  19. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
  20. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  21. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  22. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  23. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  24. package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
  25. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  26. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  27. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  28. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  29. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  30. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
  31. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  32. package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
  33. package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
  34. package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
  35. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  36. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  37. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  38. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  39. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  40. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  41. package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
  42. package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
  43. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  44. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  45. package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
  46. package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
  47. package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
  48. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  49. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  50. package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
  51. package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
  52. package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
  53. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  54. package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
  55. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
  56. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  57. package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
  58. package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
  59. package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
  60. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  61. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  62. package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
  63. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
  64. package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
  65. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  66. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  67. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  68. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  69. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  70. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  71. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  72. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  73. package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
  74. package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
  75. package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
  78. package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
  79. package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
  80. package/bundled/locales/zh-CN/core/project-structure.md +550 -170
  81. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  82. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  83. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  84. package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
  87. package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
  88. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  89. package/bundled/locales/zh-CN/core/security-standards.md +169 -16
  90. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  91. package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
  92. package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
  93. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  94. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  95. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  96. package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
  97. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  98. package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
  99. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  100. package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
  101. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  102. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  103. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  104. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  105. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  106. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  107. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  108. package/bundled/locales/zh-CN/core/versioning.md +737 -73
  109. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  110. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  111. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  112. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
  113. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  114. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
  115. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
  116. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  117. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
  118. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  119. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
  120. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  121. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  122. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
  123. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  124. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  125. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  126. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  127. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  128. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  129. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  130. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  133. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  135. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  136. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  137. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  138. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  139. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  140. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  141. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  142. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  143. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  144. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  145. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  146. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  147. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  148. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  149. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  150. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  151. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  152. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  153. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  154. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  155. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  156. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  157. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  158. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  159. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  160. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  161. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  162. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  163. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  164. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  165. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  166. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  167. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  168. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  171. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  172. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  173. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  174. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  175. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  176. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  177. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  178. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  179. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  180. package/bundled/locales/zh-CN/skills/README.md +2 -1
  181. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  182. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  183. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  184. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  185. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  186. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  187. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  188. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  189. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  190. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  191. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  192. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  193. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
  194. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  195. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  196. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  197. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  198. package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
  199. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  200. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  201. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  202. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  203. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
  204. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  205. package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
  206. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  207. package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
  208. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  209. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  210. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  211. package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
  212. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  213. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  215. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  216. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  217. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  218. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  219. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  220. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  221. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  222. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  223. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  224. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  225. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  226. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  227. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  228. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  229. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  230. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  231. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  232. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  233. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  234. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  235. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  236. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  237. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  238. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  239. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  240. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  241. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  242. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  244. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  245. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  246. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  247. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  248. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  249. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  250. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  251. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  252. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  253. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  254. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  255. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  256. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  257. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  258. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  259. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  260. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  261. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
  262. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  263. package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
  264. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  265. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
  266. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  267. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  268. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
  269. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  270. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  271. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  272. package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
  273. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  274. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  275. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  276. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  277. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  278. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  279. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  280. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  281. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  282. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  283. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  284. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  285. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  286. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  287. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
  288. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  289. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  290. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  291. package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
  292. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  293. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  294. package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
  295. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  296. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  297. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  298. package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
  299. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  300. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  301. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  302. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
  303. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  304. package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
  305. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  306. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  307. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  308. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  309. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  310. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  311. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
  312. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  313. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  314. package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
  315. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  316. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  317. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  318. package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
  319. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  320. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  321. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  322. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  323. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  324. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  325. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  326. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  327. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  328. package/bundled/locales/zh-TW/CHANGELOG.md +2282 -1112
  329. package/bundled/locales/zh-TW/CLAUDE.md +962 -76
  330. package/bundled/locales/zh-TW/README.md +3 -3
  331. package/bundled/locales/zh-TW/SECURITY.md +3 -3
  332. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  333. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
  334. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  335. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
  336. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
  337. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
  338. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
  339. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  340. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  341. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  342. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  343. package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
  344. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  345. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  346. package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
  347. package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
  348. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  349. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
  350. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  351. package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
  352. package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
  353. package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
  354. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  355. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  356. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  357. package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
  358. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  359. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  360. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  361. package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
  362. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  363. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  364. package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
  365. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  366. package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
  367. package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
  368. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  369. package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
  370. package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
  371. package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
  372. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  373. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  374. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  375. package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
  376. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  377. package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
  378. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  379. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  380. package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
  381. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
  382. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  383. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  384. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  385. package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
  386. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  387. package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
  388. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  389. package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
  390. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  391. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  392. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  393. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  394. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  395. package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
  396. package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
  397. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  398. package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
  399. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  400. package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
  401. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  402. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  403. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  404. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  405. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  406. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  407. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  408. package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
  409. package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
  410. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  411. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  412. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  413. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  414. package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
  415. package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
  416. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  417. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  418. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  419. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  420. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  421. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  422. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  423. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  424. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  425. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  426. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  427. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  428. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  429. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  430. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  431. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  432. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  433. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  434. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  435. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
  436. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  437. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
  438. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  439. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
  440. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  441. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
  442. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  443. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
  444. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  445. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  446. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
  447. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  448. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  449. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  450. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  451. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  452. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  453. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  454. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  455. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  456. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  457. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  458. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  459. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  460. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  461. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  462. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  463. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  464. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  465. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  466. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  467. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  468. package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
  469. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  470. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  471. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  472. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  473. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  474. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  475. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  476. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  477. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  478. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  479. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  480. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  481. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  482. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  483. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  484. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  485. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  486. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  487. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  488. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  489. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  490. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  491. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  492. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  493. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  494. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  495. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  496. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  497. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  498. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  499. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  500. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  501. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  502. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  503. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  504. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  505. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  506. package/bundled/locales/zh-TW/skills/README.md +2 -1
  507. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  508. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  509. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  510. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  511. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  512. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  513. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  514. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  515. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  516. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  517. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  518. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  519. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  520. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  521. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  522. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  523. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  524. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  525. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  526. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  527. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  528. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  529. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  530. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  531. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  532. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  533. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  534. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  535. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  536. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  537. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  538. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  539. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  541. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  542. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  543. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  544. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  545. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  546. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  547. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  548. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  549. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  550. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  551. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  552. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  553. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  554. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  555. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  556. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  557. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  558. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  559. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  560. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  561. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  562. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  563. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  564. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  565. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  566. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  567. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  568. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  569. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  570. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  571. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  572. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  573. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  574. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  575. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  576. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  577. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  578. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  579. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  580. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  581. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  582. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  583. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  584. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  585. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  586. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  587. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  588. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  589. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  590. package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
  591. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  592. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
  593. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  594. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  595. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  596. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  597. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  598. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  599. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  600. package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
  601. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  602. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  603. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  604. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  605. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  606. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  607. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  608. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  609. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  610. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  611. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  612. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  613. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  614. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
  615. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  616. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  617. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  618. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  619. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  620. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  621. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  622. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  623. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
  624. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  625. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  626. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  627. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  628. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  629. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  630. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  631. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  632. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  633. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  634. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  635. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  636. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  637. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  638. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  639. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  640. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  641. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  642. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  643. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  644. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  645. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  646. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  647. package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
  648. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  649. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  650. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  651. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  652. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  653. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  654. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  655. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  656. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  657. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  658. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  659. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  660. package/bundled/skills/.claude-plugin/plugin.json +71 -0
  661. package/bundled/skills/commit-standards/SKILL.md +2 -2
  662. package/bundled/skills/commit-standards/guide.md +3 -2
  663. package/bundled/skills/commit-standards/language-options.md +19 -17
  664. package/package.json +2 -2
  665. package/src/commands/audit.js +28 -1
  666. package/src/commands/check.js +72 -3
  667. package/src/commands/compile.js +37 -4
  668. package/src/commands/config.js +49 -24
  669. package/src/commands/init.js +78 -30
  670. package/src/commands/open-work.js +6 -2
  671. package/src/commands/release-messages.js +228 -0
  672. package/src/commands/release.js +127 -68
  673. package/src/commands/run-intent.js +11 -0
  674. package/src/commands/spec.js +4 -2
  675. package/src/commands/update.js +173 -20
  676. package/src/compilers/claude-code-compiler.js +9 -1
  677. package/src/config/ai-agent-paths.js +14 -1
  678. package/src/core/installed-formats.js +15 -0
  679. package/src/core/open-work-config.js +20 -1
  680. package/src/core/project-config.js +55 -0
  681. package/src/i18n/messages.js +106 -2
  682. package/src/installers/hooks-installer.js +1 -1
  683. package/src/installers/manifest-installer.js +1 -1
  684. package/src/installers/skills-installer.js +1 -1
  685. package/src/installers/standards-installer.js +3 -1
  686. package/src/mcp/server.js +9 -3
  687. package/src/prompts/init.js +26 -22
  688. package/src/reconciler/actual-state-scanner.js +2 -8
  689. package/src/reconciler/backup-locations.js +5 -0
  690. package/src/reconciler/backup-manager.js +19 -11
  691. package/src/reconciler/desired-state-calculator.js +89 -57
  692. package/src/reconciler/plan-executor.js +101 -8
  693. package/src/reconciler/recorded-versions.js +49 -0
  694. package/src/reconciler/relative-path.js +23 -0
  695. package/src/uninstallers/hook-uninstaller.js +9 -1
  696. package/src/uninstallers/skills-uninstaller.js +22 -3
  697. package/src/utils/available-standards-report.js +25 -4
  698. package/src/utils/available-standards.js +13 -3
  699. package/src/utils/build-manifest.js +1 -1
  700. package/src/utils/commit-message-judge.js +60 -13
  701. package/src/utils/friction-detector.js +23 -11
  702. package/src/utils/git-hooks.js +106 -4
  703. package/src/utils/integration-generator.js +95 -67
  704. package/src/utils/legacy-hook-migration.js +121 -2
  705. package/src/utils/open-work-tracking.mjs +105 -16
  706. package/src/utils/sdd-header.js +16 -4
  707. package/src/utils/skills-installer.js +2 -1
  708. package/src/utils/spinner.js +14 -4
  709. package/src/utils/standard-validator.js +3 -2
  710. package/standards-registry.json +10 -8
  711. package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
@@ -29,6 +29,10 @@ export const messages = {
29
29
  categoryLine: '{category} ({count})',
30
30
  installHint: 'Install one: uds update --apply --add-standard <id> (repeat the flag for several; add --plan to preview first)',
31
31
  othersLine: 'Not listed above: {count} more standard(s) in categories `uds init` never installs ({breakdown}). Any of them can still be installed by id with --add-standard.',
32
+ recommendedTitle: 'Recommended core standards, not installed ({count})',
33
+ recommendedApply: '{count} recommended core standard(s) are not installed ({ids}); see them with uds update --plan.',
34
+ checkRecommended: '{count} recommended core standard(s) not installed ({ids}) — run `uds update --plan` for the install commands',
35
+ frictionRecommended: '{count} recommended core standard(s) not installed',
32
36
  applySummary: '{count} standard(s) UDS ships are not installed in this project (no file was changed for them).',
33
37
  applyHint: 'See them: uds update --plan Install one: uds update --apply --add-standard <id>',
34
38
  checkLine: '{count} upstream standard(s) not installed — run `uds update --plan` to see them',
@@ -256,6 +260,26 @@ export const messages = {
256
260
  },
257
261
 
258
262
  // Release Mode
263
+ // Prompts of the optional uds.project.yaml step of `uds init` (XSPEC-482 R13: they were English in every language).
264
+ projectContract: {
265
+ confirmCreate: 'Create uds.project.yaml (project command contract)?',
266
+ title: '📋 Project Command Contract (uds.project.yaml)',
267
+ intro1: 'Tell UDS how to run standard commands in this project (language-agnostic).',
268
+ intro2: 'Press Enter to accept a suggestion, or type your own. Leave blank to skip.',
269
+ detected: 'Detected suggestions:',
270
+ alreadyExists: 'uds.project.yaml already exists.',
271
+ keptSections: 'These sections are kept exactly as they are: {sections}.',
272
+ noOtherSections: 'It has no other sections.',
273
+ updateQuestion: 'Update the commands (test, lint, build, security) in the existing uds.project.yaml? {kept}',
274
+ replaceQuestion: 'The existing uds.project.yaml cannot be read as YAML, so none of its content can be kept. Replace the whole file?',
275
+ skippedKeeping: 'Skipped — keeping existing uds.project.yaml',
276
+ commandOptional: '{intent} command (optional):',
277
+ commandDefault: '{intent} command (default: {value}):',
278
+ noneEntered: 'No commands entered — uds.project.yaml not created.',
279
+ updated: '✔ uds.project.yaml updated (other sections kept as they were)',
280
+ created: '✔ uds.project.yaml created',
281
+ path: 'Path: {path}'
282
+ },
259
283
  releaseMode: {
260
284
  title: 'Release Mode:',
261
285
  description: 'Choose release mode, affects how versions are published',
@@ -1082,6 +1106,7 @@ export const messages = {
1082
1106
  // Named per detected tool, never per one tool: the install now goes to each
1083
1107
  // tool's own path (XSPEC-408 §18.3), so a Claude-only label would be a lie.
1084
1108
  skillsPathUnknown: 'no verified skills path for this tool — nothing was installed for it',
1109
+ skillsNoUserPath: 'has no user-level skills folder (only the project one) — nothing was installed for it at the user level; run again with --skills-location project to install it into this project',
1085
1110
  installedSkills: 'Installed {count} Skills to {locations}',
1086
1111
  installedSkillsWithErrors: 'Installed {count} Skills with {errors} errors',
1087
1112
  // P1-CLI-1: locale fallback summary (printed after install when some
@@ -1105,6 +1130,7 @@ export const messages = {
1105
1130
 
1106
1131
  // update command
1107
1132
  update: {
1133
+ skillsNoUserPath: 'has no user-level skills folder (only the project one), so this update left it out. To put its skills into this project instead: uds config --type skills --ai-tool antigravity --skills-location project',
1108
1134
  errorExitOffer: {
1109
1135
  title: ' Single exit for error messages (gate)',
1110
1136
  guards: ' It guards against: every caller turning an error response into its own human-readable string.',
@@ -1142,6 +1168,14 @@ export const messages = {
1142
1168
  hookWouldMigrate: '+ .husky/pre-commit: would replace the line an older UDS wrote (it asks npm to resolve the bare name "uds", which is not this project) with one that runs only the installed UDS CLI.',
1143
1169
  hookLegacyKept: '⚠ .husky/pre-commit line {line} ("{text}") asks npm to resolve the bare name "uds", which on the npm registry is an unrelated package. UDS did not write this exact line, so it was left alone. Change it to "universal-dev-standards check" — it needs the UDS CLI installed in this project or on PATH.',
1144
1170
  hookMigrateFailed: '⚠ Could not rewrite .husky/pre-commit: {error}. The line that asks npm for the bare name "uds" is still there — change it to "universal-dev-standards check".',
1171
+ hookNativeMigrated: '✓ .git/hooks/pre-commit: replaced the hook an older UDS wrote ({from}) with the current one. The old one ran the check with its errors thrown away and let every commit through; the new one stops a commit when `check --ci` reports an issue.',
1172
+ hookNativeWouldMigrate: '+ .git/hooks/pre-commit: would replace the hook an older UDS wrote ({from}) with the current one. The old one ran the check with its errors thrown away and let every commit through; the new one stops a commit when `check --ci` reports an issue.',
1173
+ hookNativeKept: '⚠ .git/hooks/pre-commit line {line} ("{text}") runs the UDS check and lets the commit through whatever it finds. The file is not exactly what UDS wrote, so it was left alone. Change that line to "universal-dev-standards check --ci" — it needs the UDS CLI installed in this project or on PATH.',
1174
+ hookHuskyCiMigrated: '✓ .husky/pre-commit: the UDS block now runs `check --ci`, so the hook stops a commit when the check finds an issue. (The block an earlier beta wrote ran `check` alone, which exits 0 even when a standard file was edited.)',
1175
+ hookHuskyCiWouldMigrate: '+ .husky/pre-commit: would change the UDS block to run `check --ci`, so the hook stops a commit when the check finds an issue. (The block an earlier beta wrote ran `check` alone, which exits 0 even when a standard file was edited.)',
1176
+ hookNativeFromLegacy: 'UDS 5.x to 6.13.1: `uds check 2>/dev/null || true`',
1177
+ hookNativeFromWithoutCi: 'UDS 6.14.0 betas: `check` without `--ci`',
1178
+ hookNativeFailed: '⚠ Could not rewrite .git/hooks/pre-commit: {error}. It still lets every commit through — replace its UDS check line with "universal-dev-standards check --ci".',
1145
1179
  newerVersion: '(You have a newer version than the registry: {version})',
1146
1180
  updateAvailable: 'Update available: {current} → {latest}',
1147
1181
  // Files
@@ -1402,6 +1436,10 @@ export const messages = {
1402
1436
  categoryLine: '{category}({count})',
1403
1437
  installHint: '要裝其中一個:uds update --apply --add-standard <id>(可重複旗標裝多個;先加 --plan 預覽)',
1404
1438
  othersLine: '上面沒列出的另有 {count} 個標準,屬於 `uds init` 從不安裝的類別({breakdown});它們仍可用 --add-standard 指名安裝。',
1439
+ recommendedTitle: '建議安裝的 core 標準,尚未安裝({count} 個)',
1440
+ recommendedApply: '有 {count} 個建議安裝的 core 標準沒裝({ids});用 uds update --plan 查看。',
1441
+ checkRecommended: '有 {count} 個建議安裝的 core 標準未安裝({ids})— 執行 `uds update --plan` 看安裝指令',
1442
+ frictionRecommended: '{count} 個建議安裝的 core 標準未安裝',
1405
1443
  applySummary: '上游有 {count} 個標準沒裝在這個專案(沒有為它們改動任何檔案)。',
1406
1444
  applyHint: '查看:uds update --plan 安裝其中一個:uds update --apply --add-standard <id>',
1407
1445
  checkLine: '上游有 {count} 個標準未安裝 — 執行 `uds update --plan` 查看',
@@ -1629,6 +1667,26 @@ export const messages = {
1629
1667
  },
1630
1668
 
1631
1669
  // Release Mode
1670
+ // `uds init` 選填 uds.project.yaml 步驟的提問(XSPEC-482 R13:原本每種語言都是英文)。
1671
+ projectContract: {
1672
+ confirmCreate: '要建立 uds.project.yaml(專案指令契約)嗎?',
1673
+ title: '📋 專案指令契約(uds.project.yaml)',
1674
+ intro1: '告訴 UDS 這個專案如何執行標準指令(與程式語言無關)。',
1675
+ intro2: '按 Enter 接受建議值,或自行輸入。留空代表略過。',
1676
+ detected: '偵測到的建議值:',
1677
+ alreadyExists: 'uds.project.yaml 已存在。',
1678
+ keptSections: '這些區段會原封不動保留:{sections}。',
1679
+ noOtherSections: '它沒有其他區段。',
1680
+ updateQuestion: '要更新現有 uds.project.yaml 裡的指令(test、lint、build、security)嗎?{kept}',
1681
+ replaceQuestion: '現有的 uds.project.yaml 無法當成 YAML 讀取,所以其中內容都無法保留。要整份取代嗎?',
1682
+ skippedKeeping: '已略過——保留現有的 uds.project.yaml',
1683
+ commandOptional: '{intent} 指令(選填):',
1684
+ commandDefault: '{intent} 指令(預設:{value}):',
1685
+ noneEntered: '沒有輸入任何指令——未建立 uds.project.yaml。',
1686
+ updated: '✔ uds.project.yaml 已更新(其他區段維持原樣)',
1687
+ created: '✔ 已建立 uds.project.yaml',
1688
+ path: '路徑:{path}'
1689
+ },
1632
1690
  releaseMode: {
1633
1691
  title: '發布模式:',
1634
1692
  description: '選擇發布模式,影響版本如何發布',
@@ -2451,6 +2509,7 @@ export const messages = {
2451
2509
  couldNotGenerateAgentsMd: '無法產生 AGENTS.md',
2452
2510
  installingSkills: '安裝 Skills 中...',
2453
2511
  skillsPathUnknown: '沒有查證過的 skills 路徑,這個工具沒有安裝任何東西',
2512
+ skillsNoUserPath: '沒有使用者層級的 skills 資料夾(只有專案層級)— 沒有為它安裝使用者層級的 skills;要裝進這個專案,請改用 --skills-location project 再執行一次',
2454
2513
  installedSkills: '已安裝 {count} 個 Skills 到 {locations}',
2455
2514
  installedSkillsWithErrors: '已安裝 {count} 個 Skills,有 {errors} 個錯誤',
2456
2515
  // P1-CLI-1:locale fallback 摘要(安裝結束後顯示,列出沒有對應語系變體而退回英文來源的 skill)
@@ -2473,6 +2532,7 @@ export const messages = {
2473
2532
 
2474
2533
  // update command
2475
2534
  update: {
2535
+ skillsNoUserPath: '沒有使用者層級的 skills 資料夾(只有專案層級),這次更新沒有處理它。要把它的技能裝進這個專案,請執行:uds config --type skills --ai-tool antigravity --skills-location project',
2476
2536
  errorExitOffer: {
2477
2537
  title: ' 錯誤訊息單一出口閘門',
2478
2538
  guards: ' 防的是:每個呼叫端各自把錯誤回應拼成給人看的字串。',
@@ -2510,6 +2570,14 @@ export const messages = {
2510
2570
  hookWouldMigrate: '+ .husky/pre-commit:將把舊版 UDS 寫入的那一行(它會請 npm 解析裸名稱 uds,而那不是本專案)換成只執行已安裝 UDS CLI 的寫法。',
2511
2571
  hookLegacyKept: '⚠ .husky/pre-commit 第 {line} 行(「{text}」)會請 npm 解析裸名稱 uds,而它在 npm registry 上是不相干的套件。這一行不是 UDS 寫入的原樣,所以沒有動它。請自行改成 universal-dev-standards check——需要在本專案或 PATH 上已安裝 UDS CLI。',
2512
2572
  hookMigrateFailed: '⚠ 無法改寫 .husky/pre-commit:{error}。請 npm 解析裸名稱 uds 的那一行仍在,請自行改成 universal-dev-standards check。',
2573
+ hookNativeMigrated: '✓ .git/hooks/pre-commit:已把舊版 UDS 寫入的掛鉤({from})換成現行版本。舊的會把檢查的錯誤丟掉、讓每個 commit 都通過;新的會在 `check --ci` 回報問題時擋下 commit。',
2574
+ hookNativeWouldMigrate: '+ .git/hooks/pre-commit:將把舊版 UDS 寫入的掛鉤({from})換成現行版本。舊的會把檢查的錯誤丟掉、讓每個 commit 都通過;新的會在 `check --ci` 回報問題時擋下 commit。',
2575
+ hookNativeKept: '⚠ .git/hooks/pre-commit 第 {line} 行(「{text}」)會執行 UDS 檢查,但不論查到什麼都讓 commit 通過。這個檔案不是 UDS 寫入的原樣,所以沒有動它。請自行把那一行改成 universal-dev-standards check --ci——需要在本專案或 PATH 上已安裝 UDS CLI。',
2576
+ hookHuskyCiMigrated: '✓ .husky/pre-commit:UDS 區塊現在執行 `check --ci`,檢查發現問題時掛鉤會擋下 commit。(較早的 beta 寫入的區塊只跑 `check`,標準檔被改了也回 0。)',
2577
+ hookHuskyCiWouldMigrate: '+ .husky/pre-commit:將把 UDS 區塊改成執行 `check --ci`,檢查發現問題時掛鉤會擋下 commit。(較早的 beta 寫入的區塊只跑 `check`,標準檔被改了也回 0。)',
2578
+ hookNativeFromLegacy: 'UDS 5.x 至 6.13.1:`uds check 2>/dev/null || true`',
2579
+ hookNativeFromWithoutCi: 'UDS 6.14.0 的 beta:`check` 沒帶 `--ci`',
2580
+ hookNativeFailed: '⚠ 無法改寫 .git/hooks/pre-commit:{error}。它仍會讓每個 commit 通過——請自行把其中的 UDS 檢查那一行換成 universal-dev-standards check --ci。',
2513
2581
  newerVersion: '(你的版本比登錄庫更新:{version})',
2514
2582
  updateAvailable: '有可用更新:{current} → {latest}',
2515
2583
  // Files
@@ -2768,6 +2836,10 @@ export const messages = {
2768
2836
  categoryLine: '{category}({count})',
2769
2837
  installHint: '要装其中一个:uds update --apply --add-standard <id>(可重复该选项装多个;先加 --plan 预览)',
2770
2838
  othersLine: '上面没列出的另有 {count} 个标准,属于 `uds init` 从不安装的类别({breakdown});它们仍可用 --add-standard 指名安装。',
2839
+ recommendedTitle: '建议安装的 core 标准,尚未安装({count} 个)',
2840
+ recommendedApply: '有 {count} 个建议安装的 core 标准没装({ids});用 uds update --plan 查看。',
2841
+ checkRecommended: '有 {count} 个建议安装的 core 标准未安装({ids})— 执行 `uds update --plan` 看安装指令',
2842
+ frictionRecommended: '{count} 个建议安装的 core 标准未安装',
2771
2843
  applySummary: '上游有 {count} 个标准没装在这个项目(没有为它们改动任何文件)。',
2772
2844
  applyHint: '查看:uds update --plan 安装其中一个:uds update --apply --add-standard <id>',
2773
2845
  checkLine: '上游有 {count} 个标准未安装 — 执行 `uds update --plan` 查看',
@@ -2995,6 +3067,26 @@ export const messages = {
2995
3067
  },
2996
3068
 
2997
3069
  // Release Mode
3070
+ // `uds init` 可选的 uds.project.yaml 步骤的提问(XSPEC-482 R13:原本每种语言都是英文)。
3071
+ projectContract: {
3072
+ confirmCreate: '要创建 uds.project.yaml(项目命令契约)吗?',
3073
+ title: '📋 项目命令契约(uds.project.yaml)',
3074
+ intro1: '告诉 UDS 这个项目如何执行标准命令(与编程语言无关)。',
3075
+ intro2: '按 Enter 接受建议值,或自行输入。留空表示跳过。',
3076
+ detected: '检测到的建议值:',
3077
+ alreadyExists: 'uds.project.yaml 已存在。',
3078
+ keptSections: '这些区段会原封不动保留:{sections}。',
3079
+ noOtherSections: '它没有其他区段。',
3080
+ updateQuestion: '要更新现有 uds.project.yaml 里的命令(test、lint、build、security)吗?{kept}',
3081
+ replaceQuestion: '现有的 uds.project.yaml 无法当作 YAML 读取,所以其中内容都无法保留。要整份替换吗?',
3082
+ skippedKeeping: '已跳过——保留现有的 uds.project.yaml',
3083
+ commandOptional: '{intent} 命令(可选):',
3084
+ commandDefault: '{intent} 命令(默认:{value}):',
3085
+ noneEntered: '没有输入任何命令——未创建 uds.project.yaml。',
3086
+ updated: '✔ uds.project.yaml 已更新(其他区段保持原样)',
3087
+ created: '✔ 已创建 uds.project.yaml',
3088
+ path: '路径:{path}'
3089
+ },
2998
3090
  releaseMode: {
2999
3091
  title: '发布模式:',
3000
3092
  description: '选择发布模式,影响版本如何发布',
@@ -3184,12 +3276,14 @@ export const messages = {
3184
3276
  question: '选择产出语言:',
3185
3277
  choices: {
3186
3278
  english: '标准国际格式',
3187
- chinese: '适合中文团队',
3279
+ chinese: '适合中文团队(提交信息使用繁体;简体请选双语)',
3188
3280
  bilingual: '英文和中文并用'
3189
3281
  },
3190
3282
  labels: {
3191
3283
  english: 'English',
3192
- chinese: '简体中文',
3284
+ // Issue #254: this option installs the traditional-chinese commit option (no simplified one ships),
3285
+ // so the label must say so. Simplified Chinese reaches commits only through the bilingual option.
3286
+ chinese: '繁体中文',
3193
3287
  bilingual: '双语'
3194
3288
  }
3195
3289
  },
@@ -3480,6 +3574,7 @@ export const messages = {
3480
3574
  generatedAgentsMd: '已生成 AGENTS.md(通用摘要)',
3481
3575
  couldNotGenerateAgentsMd: '无法生成 AGENTS.md',
3482
3576
  installingSkills: '正在安装 Claude Code Skills...',
3577
+ skillsNoUserPath: '没有用户级别的 skills 文件夹(只有项目级别)— 没有为它安装用户级别的 skills;要装进这个项目,请改用 --skills-location project 再执行一次',
3483
3578
  installedSkills: '已安装 {count} 个 Skills 到 {locations}',
3484
3579
  installedSkillsWithErrors: '已安装 {count} 个 Skills,有 {errors} 个错误',
3485
3580
  // P1-CLI-1:locale fallback 摘要(安装结束后显示,列出没有对应语种变体而退回英文来源的 skill)
@@ -3763,6 +3858,7 @@ export const messages = {
3763
3858
 
3764
3859
  // update command
3765
3860
  update: {
3861
+ skillsNoUserPath: '没有用户级别的 skills 文件夹(只有项目级别),这次更新没有处理它。要把它的技能装进这个项目,请执行:uds config --type skills --ai-tool antigravity --skills-location project',
3766
3862
  errorExitOffer: {
3767
3863
  title: ' 错误信息单一出口闸门',
3768
3864
  guards: ' 防的是:每个调用端各自把错误响应拼成给人看的字符串。',
@@ -3800,6 +3896,14 @@ export const messages = {
3800
3896
  hookWouldMigrate: '+ .husky/pre-commit:将把旧版 UDS 写入的那一行(它会请 npm 解析裸名称 uds,而那不是本项目)换成只执行已安装 UDS CLI 的写法。',
3801
3897
  hookLegacyKept: '⚠ .husky/pre-commit 第 {line} 行(“{text}”)会请 npm 解析裸名称 uds,而它在 npm registry 上是不相干的包。这一行不是 UDS 写入的原样,所以没有动它。请自行改成 universal-dev-standards check——需要在本项目或 PATH 上已安装 UDS CLI。',
3802
3898
  hookMigrateFailed: '⚠ 无法改写 .husky/pre-commit:{error}。请 npm 解析裸名称 uds 的那一行仍在,请自行改成 universal-dev-standards check。',
3899
+ hookNativeMigrated: '✓ .git/hooks/pre-commit:已把旧版 UDS 写入的钩子({from})换成现行版本。旧的会把检查的错误丢掉、让每个 commit 都通过;新的会在 `check --ci` 报告问题时拦下 commit。',
3900
+ hookNativeWouldMigrate: '+ .git/hooks/pre-commit:将把旧版 UDS 写入的钩子({from})换成现行版本。旧的会把检查的错误丢掉、让每个 commit 都通过;新的会在 `check --ci` 报告问题时拦下 commit。',
3901
+ hookNativeKept: '⚠ .git/hooks/pre-commit 第 {line} 行(“{text}”)会执行 UDS 检查,但不论查到什么都让 commit 通过。这个文件不是 UDS 写入的原样,所以没有动它。请自行把那一行改成 universal-dev-standards check --ci——需要在本项目或 PATH 上已安装 UDS CLI。',
3902
+ hookHuskyCiMigrated: '✓ .husky/pre-commit:UDS 区块现在执行 `check --ci`,检查发现问题时钩子会拦下 commit。(较早的 beta 写入的区块只跑 `check`,标准文件被改了也返回 0。)',
3903
+ hookHuskyCiWouldMigrate: '+ .husky/pre-commit:将把 UDS 区块改成执行 `check --ci`,检查发现问题时钩子会拦下 commit。(较早的 beta 写入的区块只跑 `check`,标准文件被改了也返回 0。)',
3904
+ hookNativeFromLegacy: 'UDS 5.x 至 6.13.1:`uds check 2>/dev/null || true`',
3905
+ hookNativeFromWithoutCi: 'UDS 6.14.0 的 beta:`check` 没带 `--ci`',
3906
+ hookNativeFailed: '⚠ 无法改写 .git/hooks/pre-commit:{error}。它仍会让每个 commit 通过——请自行把其中的 UDS 检查那一行换成 universal-dev-standards check --ci。',
3803
3907
  newerVersion: '(您有比注册表更新的版本:{version})',
3804
3908
  updateAvailable: '有可用更新:{current} → {latest}',
3805
3909
  // Files
@@ -57,7 +57,7 @@ export const hooksSourceDir = () => resolveDir(['hooks'], ['scripts', 'hooks']);
57
57
  * (`matcher: { tool: Bash }`), which would be written into settings.json
58
58
  * verbatim and never match anything.
59
59
  */
60
- function normalizeMatcher(matcher) {
60
+ export function normalizeMatcher(matcher) {
61
61
  if (typeof matcher === 'string') return matcher;
62
62
  if (matcher && typeof matcher === 'object' && typeof matcher.tool === 'string') return matcher.tool;
63
63
  return '';
@@ -94,7 +94,7 @@ export function writeFinalManifest(config, results, projectPath) {
94
94
  } else if (results.skills?.length > 0) {
95
95
  const skillLocations = (config.skillsConfig.skillsInstallations || []).map(inst => {
96
96
  const displayName = getAgentDisplayName(inst.agent);
97
- const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath);
97
+ const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath) ?? '(no such folder)'; // XSPEC-486
98
98
  return `${displayName}: ${dir}`;
99
99
  }).join(' and ');
100
100
  console.log(chalk.gray(` ${msg.skillsInstalledTo.replace('{count}', results.skills.length).replace('{locations}', skillLocations)}`));
@@ -147,7 +147,7 @@ export async function installSkills(skillsConfig, projectPath, messages, results
147
147
  // Build location summary for display
148
148
  const targetLocations = (skillsConfig.skillsInstallations || []).map(inst => {
149
149
  const displayName = getAgentDisplayName(inst.agent);
150
- const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath);
150
+ const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath) ?? '(no such folder)'; // XSPEC-486
151
151
  return `${displayName} (${dir})`;
152
152
  }).join(', ');
153
153
 
@@ -11,6 +11,7 @@ import { copyStandard, copyExtension } from '../utils/copier.js';
11
11
  import { t } from '../i18n/messages.js';
12
12
  import { computeFileHash } from '../utils/hasher.js';
13
13
  import { MANIFEST_OPTION_BINDINGS } from '../core/constants.js';
14
+ import { getInstalledFormats } from '../core/installed-formats.js';
14
15
 
15
16
  // Extension file mappings
16
17
  export const EXTENSION_MAPPINGS = {
@@ -78,7 +79,8 @@ export async function installStandards(config, projectPath) {
78
79
  const copySpinner = createSpinner(msg.copyingStandards).start();
79
80
 
80
81
  // Copy standards based on format
81
- const formatsToUse = config.format === 'both' ? ['ai', 'human'] : [config.format];
82
+ // The reconciler expects the same list (XSPEC-483), so the two cannot disagree about what `both` installs.
83
+ const formatsToUse = config.format === 'both' ? getInstalledFormats('both') : [config.format];
82
84
 
83
85
  for (const std of standardsToCopy) {
84
86
  for (const targetFormat of formatsToUse) {
package/src/mcp/server.js CHANGED
@@ -123,6 +123,9 @@ export class McpServer {
123
123
  switch (method) {
124
124
  case 'initialize':
125
125
  return this.handleInitialize(request);
126
+ case 'ping':
127
+ // MCP utility: a liveness check; the answer is an empty result (XSPEC-482 R14c).
128
+ return { jsonrpc: '2.0', id, result: {} }; // wire:mcp-ping
126
129
  case 'tools/list':
127
130
  return this.handleToolsList(request);
128
131
  case 'tools/call':
@@ -252,12 +255,15 @@ export class McpServer {
252
255
  result: toolResult,
253
256
  };
254
257
  } catch (err) {
258
+ // A tool that ran and failed (a file it needed is not there) answers with a RESULT marked `isError`, as MCP
259
+ // specifies for tool execution errors, so the model calling it can read the reason and go on. A JSON-RPC
260
+ // error is for a request the server could not take at all (XSPEC-482 R14c).
255
261
  return {
256
262
  jsonrpc: '2.0',
257
263
  id,
258
- error: {
259
- code: -32000,
260
- message: err.message,
264
+ result: {
265
+ content: [{ type: 'text', text: err.message }],
266
+ isError: true, // wire:mcp-tool-error-is-a-result
261
267
  },
262
268
  };
263
269
  }
@@ -190,11 +190,15 @@ export async function promptSkillsInstallLocation(selectedTools = []) {
190
190
  const config = getAgentConfig(tool);
191
191
  const displayName = getAgentDisplayName(tool);
192
192
 
193
- // User level option
194
- choices.push({
195
- name: `${chalk.blue(displayName)} - ${msg.choices.userLevel} ${chalk.gray(`(${config.skills.user.replace(os.homedir(), '~')})`)}`,
196
- value: `${tool}:user`
197
- });
193
+ // User level option - only for a tool whose path table has a user-level skills folder (XSPEC-486 R1).
194
+ // Antigravity has none on purpose (agy knows one skills location, the workspace); offering the choice there
195
+ // called `.replace` on undefined and ended the whole `uds init`.
196
+ if (config.skills.user) { // wire:skills-prompt-user-level-only-if-path
197
+ choices.push({
198
+ name: `${chalk.blue(displayName)} - ${msg.choices.userLevel} ${chalk.gray(`(${config.skills.user.replace(os.homedir(), '~')})`)}`,
199
+ value: `${tool}:user`
200
+ });
201
+ }
198
202
 
199
203
  // Project level option. Pre-selected (XSPEC-468 R1): the project way is the main path, so pressing Enter
200
204
  // installs the skills into the project. Deselect everything to skip them (for example, to use the plugin).
@@ -1569,7 +1573,7 @@ export function mergeProjectConfigYaml(existing, commands) {
1569
1573
  export async function promptProjectContractStep(projectPath) {
1570
1574
  try {
1571
1575
  const wantContract = await inquirerConfirm({
1572
- message: 'Create uds.project.yaml (project command contract)?',
1576
+ message: t().projectContract.confirmCreate,
1573
1577
  default: true
1574
1578
  });
1575
1579
  if (wantContract) {
@@ -1600,22 +1604,21 @@ export async function promptProjectCommandContract(projectPath) {
1600
1604
  existing = describeProjectConfig(existingText);
1601
1605
 
1602
1606
  console.log();
1603
- console.log(chalk.yellow(' uds.project.yaml already exists.'));
1607
+ console.log(chalk.yellow(` ${t().projectContract.alreadyExists}`));
1604
1608
 
1605
1609
  const kept = existing.sections.filter(name => name !== 'commands');
1610
+ const pc = t().projectContract;
1606
1611
  const message = existing.readable
1607
- ? 'Update the commands (test, lint, build, security) in the existing uds.project.yaml? ' +
1608
- (kept.length > 0
1609
- ? `These sections are kept exactly as they are: ${kept.join(', ')}.`
1610
- : 'It has no other sections.')
1612
+ ? pc.updateQuestion.replace('{kept}', kept.length > 0
1613
+ ? pc.keptSections.replace('{sections}', kept.join(', '))
1614
+ : pc.noOtherSections)
1611
1615
  // Not YAML: nothing in it can be kept, so the question names the loss instead of hiding it.
1612
- : 'The existing uds.project.yaml cannot be read as YAML, so none of its content can be kept. ' +
1613
- 'Replace the whole file?';
1616
+ : pc.replaceQuestion;
1614
1617
 
1615
1618
  const overwrite = await inquirerConfirm({ message, default: false });
1616
1619
 
1617
1620
  if (!overwrite) {
1618
- console.log(chalk.gray(' Skipped — keeping existing uds.project.yaml'));
1621
+ console.log(chalk.gray(` ${t().projectContract.skippedKeeping}`));
1619
1622
  return false;
1620
1623
  }
1621
1624
  }
@@ -1624,13 +1627,14 @@ export async function promptProjectCommandContract(projectPath) {
1624
1627
  const hasAnySuggestion = Object.values(suggestions).some(v => v);
1625
1628
 
1626
1629
  console.log();
1627
- console.log(chalk.bold('📋 Project Command Contract (uds.project.yaml)'));
1628
- console.log(chalk.gray(' Tell UDS how to run standard commands in this project (language-agnostic).'));
1629
- console.log(chalk.gray(' Press Enter to accept a suggestion, or type your own. Leave blank to skip.'));
1630
+ const pcm = t().projectContract;
1631
+ console.log(chalk.bold(pcm.title));
1632
+ console.log(chalk.gray(` ${pcm.intro1}`));
1633
+ console.log(chalk.gray(` ${pcm.intro2}`));
1630
1634
  console.log();
1631
1635
 
1632
1636
  if (hasAnySuggestion) {
1633
- console.log(chalk.gray(' Detected suggestions:'));
1637
+ console.log(chalk.gray(` ${pcm.detected}`));
1634
1638
  for (const [intent, cmd] of Object.entries(suggestions)) {
1635
1639
  if (cmd) console.log(chalk.gray(` ${intent}: ${cmd}`));
1636
1640
  }
@@ -1644,7 +1648,7 @@ export async function promptProjectCommandContract(projectPath) {
1644
1648
  // A command the file already declares is the default, so Enter keeps it; the ecosystem guess only fills gaps.
1645
1649
  const defaultVal = existing?.commands?.[intent] || suggestions[intent] || '';
1646
1650
  const answer = await input({
1647
- message: ` ${intent} command${defaultVal ? ` (default: ${defaultVal})` : ' (optional)'}:`,
1651
+ message: ` ${defaultVal ? pcm.commandDefault.replace('{intent}', intent).replace('{value}', defaultVal) : pcm.commandOptional.replace('{intent}', intent)}`,
1648
1652
  default: defaultVal
1649
1653
  });
1650
1654
  commands[intent] = answer.trim();
@@ -1652,7 +1656,7 @@ export async function promptProjectCommandContract(projectPath) {
1652
1656
 
1653
1657
  const hasAnyCommand = Object.values(commands).some(v => v);
1654
1658
  if (!hasAnyCommand) {
1655
- console.log(chalk.gray(' No commands entered — uds.project.yaml not created.'));
1659
+ console.log(chalk.gray(` ${pcm.noneEntered}`));
1656
1660
  return false;
1657
1661
  }
1658
1662
 
@@ -1665,7 +1669,7 @@ export async function promptProjectCommandContract(projectPath) {
1665
1669
  writeFileSync(contractPath, content, 'utf-8');
1666
1670
 
1667
1671
  console.log();
1668
- console.log(chalk.green(merging ? ' ✔ uds.project.yaml updated (other sections kept as they were)' : ' ✔ uds.project.yaml created'));
1669
- console.log(chalk.gray(` Path: ${contractPath}`));
1672
+ console.log(chalk.green(` ${merging ? pcm.updated : pcm.created}`));
1673
+ console.log(chalk.gray(` ${pcm.path.replace('{path}', contractPath)}`));
1670
1674
  return true;
1671
1675
  }
@@ -11,6 +11,7 @@ import { existsSync, readdirSync, readFileSync, statSync } from 'fs';
11
11
  import { createHash } from 'crypto';
12
12
  import { join, relative } from 'path';
13
13
  import { readManifest } from '../core/manifest.js';
14
+ import { projectRelative } from './relative-path.js';
14
15
  import { computeFileHash, computeIntegrationBlockHash, normalizeLineEndings } from '../utils/hasher.js';
15
16
  import { SUPPORTED_AI_TOOLS, UDS_MARKERS } from '../core/constants.js';
16
17
  import { locateMarkerBlock, AmbiguousMarkerError } from '../utils/marker-locator.js';
@@ -600,12 +601,5 @@ function scanDirectoryRecursive(dirPath, callback, baseDir = dirPath) {
600
601
  * Get relative path from project root.
601
602
  */
602
603
  function getRelativePath(projectPath, absPath) {
603
- if (absPath.startsWith(projectPath)) {
604
- let rel = absPath.slice(projectPath.length);
605
- if (rel.startsWith('/') || rel.startsWith('\\')) {
606
- rel = rel.slice(1);
607
- }
608
- return rel;
609
- }
610
- return absPath;
604
+ return projectRelative(projectPath, absPath); // `/` on every system (XSPEC-486 R4)
611
605
  }
@@ -58,6 +58,11 @@ export function ensureBackupsDir(projectPath, errors) {
58
58
  }
59
59
  }
60
60
 
61
+ /** True for a backup id in the shared folder (`.uds-backups/<name>`), false for a legacy one in the project root. */
62
+ export function isSharedBackupId(backupId) {
63
+ return backupId.startsWith(`${BACKUPS_DIR}/`);
64
+ }
65
+
61
66
  /** Ids of the backups in the shared folder. */
62
67
  export function sharedBackupIds(projectPath) {
63
68
  const dir = join(projectPath, BACKUPS_DIR);
@@ -14,8 +14,8 @@
14
14
  * Before 6.14.0 (this change) every backup was its own folder in the project root, `.uds-backup-<ISO timestamp>/`.
15
15
  * Those are NOT moved, and they are still backups: `backupId` is the backup folder's path relative to the
16
16
  * project root (`.uds-backups/<time>-<NNNN>` or `.uds-backup-<time>-<NNNN>`), so every place that builds a
17
- * path from it works for both layouts, and listing, chaining, rollback and "keep the 5 most recent" look at
18
- * both places and order them together by time.
17
+ * path from it works for both layouts, and listing, chaining and rollback look at both places and order them together by time.
18
+ * The "keep the 5 most recent" limit counts only `.uds-backups/` (XSPEC-475 R2).
19
19
  *
20
20
  * Only the paths a step will touch are backed up (minimal footprint). Keeps the 5 most recent
21
21
  * backups; auto-cleans older ones.
@@ -47,7 +47,7 @@ import {
47
47
  } from 'fs';
48
48
  import { createHash } from 'crypto';
49
49
  import { join, dirname, isAbsolute, sep } from 'path';
50
- import { newBackupId, ensureBackupsDir, sharedBackupIds, addLegacyBackupIds } from './backup-locations.js';
50
+ import { newBackupId, ensureBackupsDir, sharedBackupIds, addLegacyBackupIds, isSharedBackupId } from './backup-locations.js';
51
51
 
52
52
  const MAX_BACKUPS = 5;
53
53
  const MANIFEST_REL = '.standards/manifest.json';
@@ -574,22 +574,30 @@ export function listBackups(projectPath) {
574
574
  }
575
575
 
576
576
  /**
577
- * Clean up old backups, keeping only the most recent N.
577
+ * Clean up old backups, keeping only the most recent N in the shared folder `.uds-backups/`.
578
+ * // implements XSPEC-475 R2
579
+ *
580
+ * The limit counts ONLY backups in `.uds-backups/`. A backup an older UDS left in the project root
581
+ * (`.uds-backup-*`) is never removed by the limit - it used to be counted together with the new ones, so an
582
+ * adopter with 4 old backups lost 2 of them over a three-step upgrade without a word. They are still listed
583
+ * (for rollback), and returned in `legacyKept` so the caller can name them and suggest moving them.
578
584
  *
579
585
  * @param {string} projectPath
580
- * @param {number} [keep=MAX_BACKUPS] - Number of backups to keep
581
- * @returns {{ removed: string[], errors: string[] }}
586
+ * @param {number} [keep=MAX_BACKUPS] - Number of backups to keep in `.uds-backups/`
587
+ * @returns {{ removed: string[], errors: string[], legacyKept: string[], keep: number }}
582
588
  */
583
589
  export function cleanupBackups(projectPath, keep = MAX_BACKUPS) {
584
- const backups = listBackups(projectPath);
590
+ const all = listBackups(projectPath);
591
+ const legacyKept = all.filter((b) => !isSharedBackupId(b.backupId)).map((b) => b.backupId);
592
+ const shared = all.filter((b) => isSharedBackupId(b.backupId));
585
593
  const removed = [];
586
594
  const errors = [];
587
595
 
588
- if (backups.length <= keep) {
589
- return { removed, errors };
596
+ if (shared.length <= keep) {
597
+ return { removed, errors, legacyKept, keep };
590
598
  }
591
599
 
592
- const toRemove = backups.slice(keep);
600
+ const toRemove = shared.slice(keep);
593
601
  for (const backup of toRemove) {
594
602
  const backupDir = join(projectPath, backup.backupId);
595
603
  try {
@@ -600,5 +608,5 @@ export function cleanupBackups(projectPath, keep = MAX_BACKUPS) {
600
608
  }
601
609
  }
602
610
 
603
- return { removed, errors };
611
+ return { removed, errors, legacyKept, keep };
604
612
  }