universal-dev-standards 6.13.1 → 6.14.0-beta.10

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 (693) hide show
  1. package/README.md +13 -3
  2. package/bin/uds.js +75 -3
  3. package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
  4. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  5. package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
  6. package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
  7. package/bundled/ai/standards/code-review.ai.yaml +15 -2
  8. package/bundled/ai/standards/commit-message.ai.yaml +18 -4
  9. package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
  10. package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
  11. package/bundled/ai/standards/open-work-tracking.ai.yaml +254 -4
  12. package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
  13. package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
  14. package/bundled/ai/standards/turn-completion-integrity.ai.yaml +14 -7
  15. package/bundled/core/ai-response-navigation.md +128 -12
  16. package/bundled/core/code-review-checklist.md +20 -2
  17. package/bundled/core/commit-message-guide.md +22 -19
  18. package/bundled/core/developer-memory.md +12 -2
  19. package/bundled/core/full-coverage-testing.md +99 -5
  20. package/bundled/core/open-work-tracking.md +251 -8
  21. package/bundled/core/pipeline-security-gates.md +63 -0
  22. package/bundled/core/project-context-memory.md +10 -2
  23. package/bundled/core/turn-completion-integrity.md +58 -11
  24. package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
  25. package/bundled/extensions/languages/csharp-style.md +464 -0
  26. package/bundled/extensions/languages/php-style.md +700 -0
  27. package/bundled/extensions/locales/zh-cn.md +717 -0
  28. package/bundled/extensions/locales/zh-tw.md +717 -0
  29. package/bundled/hooks/check-turn-completion-agy.mjs +147 -0
  30. package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
  31. package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
  32. package/bundled/locales/COVERAGE.md +5 -4
  33. package/bundled/locales/zh-CN/CHANGELOG.md +211 -3
  34. package/bundled/locales/zh-CN/README.md +3 -3
  35. package/bundled/locales/zh-CN/SECURITY.md +3 -1
  36. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  37. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
  38. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  39. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
  40. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
  41. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
  42. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
  43. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  44. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  45. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  46. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  47. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  48. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  49. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  50. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  51. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  52. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  53. package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
  54. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  55. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  56. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  57. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  58. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  59. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  60. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  61. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  62. package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
  63. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  64. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  65. package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
  66. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  67. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  68. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  69. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  70. package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
  71. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  72. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  73. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  74. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  75. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  76. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  77. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  78. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  79. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  80. package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
  81. package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
  82. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  83. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  84. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  87. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  88. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  89. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  90. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  91. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  92. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  93. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  94. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  95. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  96. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  97. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  98. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  99. package/bundled/locales/zh-CN/core/turn-completion-integrity.md +46 -13
  100. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  101. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  102. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  103. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  104. package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
  105. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +11 -2
  106. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  107. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +76 -40
  108. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +32 -15
  109. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  110. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
  111. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  112. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
  113. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  114. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  115. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
  116. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  117. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  118. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  119. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  120. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  121. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  122. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  123. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  124. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  125. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  126. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  127. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  128. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  129. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  130. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  133. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  135. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  136. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  137. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  138. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  139. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  140. package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
  141. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  142. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  143. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  144. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  145. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  146. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  147. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  148. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  149. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  150. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  151. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  152. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  153. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  154. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  155. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  156. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  157. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  158. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  159. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  160. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  161. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  162. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  163. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  164. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  165. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  166. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  167. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  168. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  171. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  172. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  173. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  174. package/bundled/locales/zh-CN/skills/README.md +3 -1
  175. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  176. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  177. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  178. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  179. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  180. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  181. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  182. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  183. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  184. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  185. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  186. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  187. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  188. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  189. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  190. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  191. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  192. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  193. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  194. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  195. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  196. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  197. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  198. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  199. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  200. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  201. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  202. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  203. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  204. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  205. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  206. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  207. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  208. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  209. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  210. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  211. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  212. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  213. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  215. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  216. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  217. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  218. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  219. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  220. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  221. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  222. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  223. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  224. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  225. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  226. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  227. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  228. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  229. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  230. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  231. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  232. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  233. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  234. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  235. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  236. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  237. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  238. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  239. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  240. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  241. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  242. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  244. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  245. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  246. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  247. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  248. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  249. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
  250. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  251. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  252. package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
  253. package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
  254. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  255. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  256. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  257. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  258. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  259. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  260. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  261. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  262. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  263. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  264. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  265. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  266. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  267. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  268. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  269. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  270. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  271. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  272. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  273. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  274. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  275. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  276. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  277. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  278. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  279. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  280. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  281. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  282. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  283. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  284. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  285. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  286. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  287. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  288. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  289. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  290. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  291. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  292. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  293. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  294. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  295. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  296. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  297. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  298. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  299. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  300. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  301. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  302. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  303. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  304. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  305. package/bundled/locales/zh-TW/CHANGELOG.md +211 -3
  306. package/bundled/locales/zh-TW/README.md +3 -3
  307. package/bundled/locales/zh-TW/SECURITY.md +3 -1
  308. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  309. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
  310. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  311. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
  312. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
  313. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
  314. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
  315. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  316. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  317. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  318. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  319. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  320. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  321. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  322. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  323. package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
  324. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  325. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  326. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  327. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  328. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  329. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  330. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  331. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  332. package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
  333. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  334. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  335. package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
  336. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  337. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  338. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  339. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  340. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  341. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  342. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  343. package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
  344. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  345. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  346. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  347. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  348. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  349. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  350. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  351. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  352. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  353. package/bundled/locales/zh-TW/core/open-work-tracking.md +164 -9
  354. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  355. package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
  356. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  357. package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
  358. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  359. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  360. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  361. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  362. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  363. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  364. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  365. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  366. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  367. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  368. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  369. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  370. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  371. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  372. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  373. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  374. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  375. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  376. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  377. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  378. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  379. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  380. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  381. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  382. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  383. package/bundled/locales/zh-TW/core/turn-completion-integrity.md +46 -13
  384. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  385. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  386. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  387. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  388. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  389. package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
  390. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +11 -2
  391. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  392. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +69 -33
  393. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  394. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +32 -15
  395. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  396. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
  397. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  398. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
  399. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  400. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  401. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
  402. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  403. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  404. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  405. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  406. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  407. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  408. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  409. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  410. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  411. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  412. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  413. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  414. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  415. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  416. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  417. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  418. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  419. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  420. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  421. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  422. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  423. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  424. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  425. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  426. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  427. package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
  428. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  429. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  430. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  431. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  432. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  433. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  434. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  435. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  436. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  437. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  438. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  439. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  440. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  441. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  442. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  443. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  444. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  445. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  446. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  447. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  448. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  449. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  450. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  451. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  452. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  453. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  454. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  455. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  456. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  457. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  458. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  459. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  460. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  461. package/bundled/locales/zh-TW/skills/README.md +3 -1
  462. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  463. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  464. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  465. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  466. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  467. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  468. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  469. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  470. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  471. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  472. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  473. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  474. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  475. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  476. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  477. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  478. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  479. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  480. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  481. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  482. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  483. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  484. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  485. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  486. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  487. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  488. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  489. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  490. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  491. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  492. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  493. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  494. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  495. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  496. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  497. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  498. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  499. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  500. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  501. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  502. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  503. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  504. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  505. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  506. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  507. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  508. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  509. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  510. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  511. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  512. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  513. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  514. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  515. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  516. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  517. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  518. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  519. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  520. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  521. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  522. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  523. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  524. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  525. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  526. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  527. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  528. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  529. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  530. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  531. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  532. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  533. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  534. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  535. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  536. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  537. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  538. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  539. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  540. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  541. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  542. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  543. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  544. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  545. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  546. package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
  547. package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
  548. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  549. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  550. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  551. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  552. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  553. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  554. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  555. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  556. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  557. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  558. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  559. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  560. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  561. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  562. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  563. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  564. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  565. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  566. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  567. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  568. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  569. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  570. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  571. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  572. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  573. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  574. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  575. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  576. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  577. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  578. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  579. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  580. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  581. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  582. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  583. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  584. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  585. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  586. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  587. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  588. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  589. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  590. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  591. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  592. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  593. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  594. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  595. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  596. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  597. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  598. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  599. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  600. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  601. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  602. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  603. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  604. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  605. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  606. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  607. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  608. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  609. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  610. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  611. package/bundled/skills/README.md +1 -0
  612. package/bundled/skills/SKILL_NAMING.md +9 -0
  613. package/bundled/skills/commit-standards/SKILL.md +2 -2
  614. package/bundled/skills/commit-standards/guide.md +3 -2
  615. package/bundled/skills/commit-standards/language-options.md +19 -17
  616. package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
  617. package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
  618. package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
  619. package/bundled/templates/gates/check-stubs.mjs +644 -0
  620. package/package.json +5 -3
  621. package/src/commands/audit.js +20 -2
  622. package/src/commands/check.js +155 -28
  623. package/src/commands/deps.js +31 -1
  624. package/src/commands/hitl.js +3 -0
  625. package/src/commands/init.js +173 -49
  626. package/src/commands/list.js +12 -3
  627. package/src/commands/mcp.js +2 -3
  628. package/src/commands/open-work.js +123 -0
  629. package/src/commands/quickstart.js +29 -13
  630. package/src/commands/release.js +102 -19
  631. package/src/commands/run-intent.js +10 -0
  632. package/src/commands/simulate.js +20 -8
  633. package/src/commands/skills.js +59 -33
  634. package/src/commands/spec-split.js +30 -17
  635. package/src/commands/spec.js +55 -21
  636. package/src/commands/uninstall.js +146 -32
  637. package/src/commands/update.js +471 -93
  638. package/src/core/install-records.js +192 -0
  639. package/src/core/manifest.js +12 -10
  640. package/src/core/marketplace-sentinel.js +5 -0
  641. package/src/core/open-work-config.js +122 -0
  642. package/src/core/project-config.js +92 -38
  643. package/src/flows/init-flow.js +10 -0
  644. package/src/hitl/manager.js +4 -2
  645. package/src/i18n/messages.js +413 -78
  646. package/src/installers/hooks-installer.js +320 -24
  647. package/src/installers/integration-installer.js +5 -1
  648. package/src/installers/skills-installer.js +3 -1
  649. package/src/installers/standards-installer.js +16 -23
  650. package/src/mcp/__tests__/server.test.js +0 -1
  651. package/src/mcp/server.js +16 -4
  652. package/src/prompts/init.js +148 -13
  653. package/src/reconciler/backup-locations.js +80 -0
  654. package/src/reconciler/backup-manager.js +451 -123
  655. package/src/reconciler/index.js +86 -10
  656. package/src/reconciler/install-roots.js +90 -0
  657. package/src/reconciler/plan-executor.js +37 -15
  658. package/src/uninstallers/hook-uninstaller.js +323 -33
  659. package/src/uninstallers/integration-uninstaller.js +35 -5
  660. package/src/uninstallers/skills-uninstaller.js +95 -16
  661. package/src/uninstallers/standards-uninstaller.js +56 -7
  662. package/src/utils/agents-installer.js +10 -17
  663. package/src/utils/available-standards-report.js +144 -0
  664. package/src/utils/available-standards.js +216 -0
  665. package/src/utils/command-hash-ownership.js +103 -0
  666. package/src/utils/commit-message-judge.js +155 -0
  667. package/src/utils/copier.js +80 -2
  668. package/src/utils/deps-applicability.js +25 -0
  669. package/src/utils/detector.js +46 -1
  670. package/src/utils/friction-detector.js +27 -0
  671. package/src/utils/gate-scripts.js +141 -0
  672. package/src/utils/git-hooks.js +139 -7
  673. package/src/utils/hasher.js +36 -0
  674. package/src/utils/health-scorer.js +10 -7
  675. package/src/utils/installed-names-ownership.js +114 -0
  676. package/src/utils/integration-generator.js +36 -24
  677. package/src/utils/legacy-hook-migration.js +112 -0
  678. package/src/utils/locale.js +19 -0
  679. package/src/utils/open-work-tracking.mjs +1754 -0
  680. package/src/utils/prompt-closed.js +18 -0
  681. package/src/utils/sdd-header.js +66 -0
  682. package/src/utils/skill-frontmatter.js +102 -0
  683. package/src/utils/skill-hash-ownership.js +64 -0
  684. package/src/utils/skill-name-collision.js +169 -0
  685. package/src/utils/skills-install-paths.js +114 -0
  686. package/src/utils/skills-installer.js +75 -106
  687. package/src/utils/standard-validator.js +98 -27
  688. package/src/utils/test-change-check.js +160 -0
  689. package/src/utils/test-policy.js +214 -0
  690. package/src/utils/transient-fs.js +113 -0
  691. package/src/utils/update-summary.js +29 -0
  692. package/src/vibe/micro-spec.js +15 -0
  693. package/standards-registry.json +48 -9
@@ -10,7 +10,9 @@
10
10
  import { mkdirSync, writeFileSync, existsSync, readFileSync, readdirSync, copyFileSync, statSync, rmSync, unlinkSync } from 'fs';
11
11
  import { dirname, join, basename } from 'path';
12
12
  import { createHash } from 'crypto';
13
+ import chalk from 'chalk';
13
14
  import { fileURLToPath } from 'url';
15
+ import { parseFrontmatter, rebuildWithFrontmatter } from './skill-frontmatter.js';
14
16
  import {
15
17
  getAgentConfig,
16
18
  getSkillsDirForAgent,
@@ -22,6 +24,7 @@ import {
22
24
  import { computeDirectoryHashes, computeFileHash, normalizeLineEndings } from './hasher.js';
23
25
  import { isLocalizedLocale } from './locale.js';
24
26
  import { getSkillsSourceDir } from './skills-source.js';
27
+ import { t } from '../i18n/messages.js';
25
28
 
26
29
  // Get the CLI package root directory
27
30
  const __filename = fileURLToPath(import.meta.url);
@@ -33,16 +36,21 @@ const BUNDLED_DIR = join(CLI_ROOT, 'bundled');
33
36
  // Its previous private copy here was the half that worked; the copy in github.js was not.
34
37
 
35
38
  /**
36
- * Get the localized Skills source directory for a given locale.
37
- * Falls back to the English source directory if the localized path does not exist.
38
- * @param {string} locale - Locale identifier (e.g., 'zh-TW', 'zh-CN', 'en')
39
- * @returns {string} Path to skills source directory for the locale
39
+ * Where this copy of UDS keeps the skill texts of a locale, or `null` when it keeps none.
40
+ *
41
+ * `null` is the answer that matters (XSPEC-468 R3). This lookup used to fall back to the English directory
42
+ * on its own, so a copy of UDS without the locale pack installed English skills for `--locale zh-tw`, exit
43
+ * code 0, and not one word about it: the same shape as `zh-CN` becoming English in XSPEC-451. Whoever asks
44
+ * now learns the pack is absent and says so.
45
+ *
46
+ * The pack is part of the npm package (`cli/scripts/prepack.mjs` bundles `locales/` into
47
+ * `bundled/locales/`), so an absent pack means an incomplete or damaged copy, not a missing network.
48
+ *
49
+ * @param {string} locale - e.g. 'zh-TW', 'zh-CN'
50
+ * @returns {string|null}
40
51
  */
41
- function getLocalizedSkillsSourceDir(locale) {
42
- const enDir = getSkillsSourceDir();
43
- if (!isLocalizedLocale(locale)) {
44
- return enDir;
45
- }
52
+ export function findLocalePackSkillsDir(locale) {
53
+ if (!isLocalizedLocale(locale)) return null;
46
54
 
47
55
  // Try bundled path first (npm install)
48
56
  const bundledPath = join(BUNDLED_DIR, 'locales', locale, 'skills');
@@ -56,8 +64,16 @@ function getLocalizedSkillsSourceDir(locale) {
56
64
  return devPath;
57
65
  }
58
66
 
59
- // Locale directory not found, fall back to English
60
- return enDir;
67
+ return null;
68
+ }
69
+
70
+ /**
71
+ * Whether the skill texts of `locale` are in this copy of UDS. Always true for English.
72
+ * @param {string} locale
73
+ * @returns {boolean}
74
+ */
75
+ export function isLocalePackAvailable(locale) {
76
+ return !isLocalizedLocale(locale) || findLocalePackSkillsDir(locale) !== null;
61
77
  }
62
78
 
63
79
  /**
@@ -248,105 +264,27 @@ export async function installSkillsForAgent(agent, level, skillNames = null, pro
248
264
 
249
265
  // Compute file hashes for tracking
250
266
  // Key format: agent/level/skillName/filename (e.g., "opencode/project/commit-standards/SKILL.md")
267
+ //
268
+ // XSPEC-454 R2: only the skills THIS run installed are recorded. This used to hash the whole
269
+ // target directory, so everything that happened to sit in `.claude/skills/` — the adopter's own
270
+ // skills, and the `agents/`, `workflows/`, `_shared/` folders an old CLI copied in by mistake —
271
+ // became "files UDS installed". `uds update` later (rightly) deleted the old strays but kept their
272
+ // records, and `uds check` listed 26 of them as missing. A record has to mean "UDS wrote this".
273
+ // `.manifest.json` is deliberately not recorded either: it is UDS's own bookkeeping, rewritten by
274
+ // every install, and nothing a user edits — a hash of it could only ever raise a false alarm.
251
275
  const baseKey = `${agent}/${level}`;
252
- results.fileHashes = computeDirectoryHashes(targetDir, baseKey);
253
- }
254
-
255
- return results;
256
- }
257
-
258
- /**
259
- * Parse YAML frontmatter from a markdown file content.
260
- * Handles multi-line values (e.g., `description: |`).
261
- * @param {string} content - File content with YAML frontmatter
262
- * @returns {{ frontmatter: Object, body: string } | null} Parsed result or null if no frontmatter
263
- */
264
- export function parseFrontmatter(content) {
265
- const match = content.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
266
- if (!match) return null;
267
-
268
- const [, yamlText, body] = match;
269
- const frontmatter = {};
270
-
271
- const lines = yamlText.split('\n');
272
- let currentKey = null;
273
- let currentValue = '';
274
- let isMultiline = false;
275
-
276
- for (const line of lines) {
277
- if (isMultiline) {
278
- // Multi-line value: lines starting with spaces belong to current key
279
- if (line.match(/^\s/) || line === '') {
280
- currentValue += (currentValue ? '\n' : '') + line;
281
- continue;
282
- } else {
283
- // End of multi-line value
284
- frontmatter[currentKey] = currentValue.trimEnd();
285
- isMultiline = false;
286
- }
287
- }
288
-
289
- const keyMatch = line.match(/^([a-zA-Z_-]+):\s*(.*)$/);
290
- if (keyMatch) {
291
- currentKey = keyMatch[1];
292
- const value = keyMatch[2].trim();
293
-
294
- if (value === '|' || value === '>') {
295
- // Start of multi-line value
296
- isMultiline = true;
297
- currentValue = '';
298
- } else {
299
- frontmatter[currentKey] = value;
300
- }
276
+ results.fileHashes = {};
277
+ for (const name of results.installed) {
278
+ Object.assign(results.fileHashes, computeDirectoryHashes(join(targetDir, name), `${baseKey}/${name}`));
301
279
  }
302
280
  }
303
281
 
304
- // Flush last multi-line value
305
- if (isMultiline && currentKey) {
306
- frontmatter[currentKey] = currentValue.trimEnd();
307
- }
308
-
309
- return { frontmatter, body };
310
- }
311
-
312
- /**
313
- * Rebuild file content with updated frontmatter fields.
314
- * Preserves existing frontmatter fields and adds/overrides with provided fields.
315
- * @param {string} content - Original file content
316
- * @param {Object} fieldsToMerge - Fields to add or override in frontmatter
317
- * @returns {string} Rebuilt content
318
- */
319
- export function rebuildWithFrontmatter(content, fieldsToMerge) {
320
- const parsed = parseFrontmatter(content);
321
- if (!parsed) {
322
- // No existing frontmatter — create one
323
- const lines = ['---'];
324
- for (const [key, value] of Object.entries(fieldsToMerge)) {
325
- lines.push(`${key}: ${value}`);
326
- }
327
- lines.push('---');
328
- return lines.join('\n') + '\n' + content;
329
- }
330
-
331
- const merged = { ...parsed.frontmatter, ...fieldsToMerge };
332
-
333
- const lines = ['---'];
334
- for (const [key, value] of Object.entries(merged)) {
335
- if (value && value.includes('\n')) {
336
- // Multi-line value
337
- lines.push(`${key}: |`);
338
- for (const vline of value.split('\n')) {
339
- lines.push(vline);
340
- }
341
- } else {
342
- lines.push(`${key}: ${value}`);
343
- }
344
- }
345
- lines.push('---');
346
-
347
- return lines.join('\n') + '\n' + parsed.body;
282
+ return results;
348
283
  }
349
284
 
285
+ // parseFrontmatter / rebuildWithFrontmatter live in ./skill-frontmatter.js (no dependencies, so scripts at the
286
+ // repo root can import them without installing the CLI's packages); imported above and re-exported here, so every existing importer keeps working.
287
+ export { parseFrontmatter, rebuildWithFrontmatter };
350
288
  /**
351
289
  * Merge required Claude Code frontmatter fields from the English source
352
290
  * into an installed localized SKILL.md.
@@ -439,8 +377,9 @@ export function resolveSkillFiles(skillName, locale = 'en') {
439
377
  let fallbackToEn = false;
440
378
 
441
379
  if (isLocalizedLocale(locale)) {
442
- const localizedSkillDir = join(getLocalizedSkillsSourceDir(locale), skillName);
443
- if (existsSync(localizedSkillDir)) {
380
+ const packDir = findLocalePackSkillsDir(locale);
381
+ const localizedSkillDir = packDir ? join(packDir, skillName) : null;
382
+ if (localizedSkillDir && existsSync(localizedSkillDir)) {
444
383
  sourceDir = localizedSkillDir;
445
384
  needsFrontmatterMerge = true;
446
385
  } else {
@@ -1117,6 +1056,25 @@ export function deduplicateInstallations(installations) {
1117
1056
  return deduped;
1118
1057
  }
1119
1058
 
1059
+ /**
1060
+ * Tell the adopter the locale pack is not in this copy of UDS and that English was installed instead.
1061
+ * Not an error, not silence: the install goes on in English, the message says why and how to get the texts.
1062
+ * @param {string} locale
1063
+ */
1064
+ const localePackMissingTold = new Set();
1065
+ function printLocalePackMissing(locale) {
1066
+ // Skills and commands both go through here; once per run is enough.
1067
+ if (localePackMissingTold.has(locale)) return;
1068
+ localePackMissingTold.add(locale);
1069
+ const msg = t().commands.common;
1070
+ const fill = (text) => text.replaceAll('{locale}', locale).replaceAll('{localeLower}', String(locale).toLowerCase());
1071
+ console.log();
1072
+ console.log(chalk.yellow(`⚠ ${fill(msg.localePackMissingTitle)}`));
1073
+ for (const line of msg.localePackMissingLines) {
1074
+ console.log(chalk.gray(` ${fill(line)}`));
1075
+ }
1076
+ }
1077
+
1120
1078
  /**
1121
1079
  * Install skills to multiple agents at once
1122
1080
  * @param {Array<{agent: string, level: string}>} installations - Array of installation targets
@@ -1142,6 +1100,13 @@ export async function installSkillsToMultipleAgents(installations, skillNames =
1142
1100
 
1143
1101
  const fallbackSet = new Set();
1144
1102
 
1103
+ // XSPEC-468 R3: every skills install (init, update, the reconciler's plan) goes through here, so this is the
1104
+ // one place that can say "the texts you asked for are not in this copy of UDS" for all of them.
1105
+ if (uniqueInstallations.length > 0 && !isLocalePackAvailable(locale)) {
1106
+ results.localePackMissing = true;
1107
+ printLocalePackMissing(locale);
1108
+ }
1109
+
1145
1110
  for (const { agent, level } of uniqueInstallations) {
1146
1111
  const result = await installSkillsForAgent(agent, level, skillNames, projectPath, locale);
1147
1112
  results.installations.push(result);
@@ -1194,6 +1159,10 @@ export async function installCommandsToMultipleAgents(installations, commandName
1194
1159
  allFileHashes: {} // New: combined file hashes from all installations
1195
1160
  };
1196
1161
 
1162
+ if (uniqueInstallations.length > 0 && !isLocalePackAvailable(locale)) {
1163
+ printLocalePackMissing(locale);
1164
+ }
1165
+
1197
1166
  for (const item of uniqueInstallations) {
1198
1167
  const agent = item.agent;
1199
1168
  const level = item.level;
@@ -5,6 +5,7 @@ import { exec } from 'child_process';
5
5
  import util from 'util';
6
6
  import { pathToFileURL } from 'node:url';
7
7
  import { readManifest } from './copier.js';
8
+ import { judgeCommitMessage } from './commit-message-judge.js';
8
9
 
9
10
  const execAsync = util.promisify(exec);
10
11
 
@@ -395,51 +396,121 @@ export class StandardValidator {
395
396
  }
396
397
 
397
398
  /**
398
- * Run a simulation to predict compliance with a standard
399
+ * Standards in this project that define a `physical_spec.simulator` (the only ones `uds simulate` can run).
400
+ * @returns {string[]} Standard ids, sorted
401
+ */
402
+ listSimulatableStandards() {
403
+ const ids = [];
404
+ let files;
405
+ try {
406
+ files = fs.readdirSync(this.standardsDir).filter(f => f.endsWith('.ai.yaml'));
407
+ } catch {
408
+ return ids;
409
+ }
410
+ for (const file of files) {
411
+ try {
412
+ const doc = yaml.load(fs.readFileSync(path.join(this.standardsDir, file), 'utf-8'));
413
+ if (doc?.physical_spec?.simulator) ids.push(doc?.standard?.id || file.replace(/\.ai\.yaml$/, ''));
414
+ } catch {
415
+ // an unreadable standard is not simulatable
416
+ }
417
+ }
418
+ return ids.sort();
419
+ }
420
+
421
+ /**
422
+ * Run a simulation to predict compliance with a standard.
423
+ *
424
+ * XSPEC-456 R2. Three outcomes, never two:
425
+ * - `pass` - the input complies;
426
+ * - `fail` - the input does not comply (the standard's rules say so);
427
+ * - `cannot-simulate` - no verdict was reached: the standard has no simulator, the standard is not
428
+ * installed, or the tool a simulator delegates to is not usable. Reporting that
429
+ * as `fail` told people their input was non-compliant when nothing had judged it.
430
+ * `success` stays for existing readers and is true only for `pass`.
431
+ *
399
432
  * @param {string} standardId - Standard ID
400
- * @param {string} input - Input to test (e.g. commit message)
401
- * @returns {Promise<Object>} Simulation result
433
+ * @param {string} input - Input to test (e.g. a commit message)
434
+ * @returns {Promise<{ status: 'pass'|'fail'|'cannot-simulate', success: boolean, message: string, details?: string }>}
402
435
  */
403
436
  async simulate(standardId, input) {
437
+ const cannot = (message, details) => ({ status: 'cannot-simulate', success: false, message, ...(details ? { details } : {}) });
438
+
404
439
  const standardFile = this.findStandardFile(standardId);
405
440
  if (!standardFile) {
406
- return { success: false, message: `Standard '${standardId}' not found.` };
441
+ return cannot(`Standard '${standardId}' not found.`, this._simulatableHint());
407
442
  }
408
443
 
409
444
  let standardConfig;
410
445
  try {
411
446
  standardConfig = yaml.load(fs.readFileSync(standardFile, 'utf-8'));
412
447
  } catch (e) {
413
- return { success: false, message: `Failed to parse standard: ${e.message}` };
448
+ return cannot(`Failed to parse standard: ${e.message}`);
414
449
  }
415
450
 
416
- if (!standardConfig.physical_spec || !standardConfig.physical_spec.simulator) {
417
- return {
418
- success: false,
419
- message: `Standard '${standardId}' does not support simulation (no 'simulator' spec defined).`
420
- };
451
+ const simulator = standardConfig?.physical_spec?.simulator;
452
+ if (!simulator) {
453
+ return cannot(
454
+ `Standard '${standardId}' does not support simulation (no 'simulator' spec defined).`,
455
+ this._simulatableHint()
456
+ );
421
457
  }
422
458
 
423
- const { command } = standardConfig.physical_spec.simulator;
424
-
425
- // Sanitization: Escape double quotes to prevent breaking the echo command
426
- // This is a basic implementation. For production, consider using spawn with stdin stream.
427
- const sanitizedInput = input.replace(/"/g, '\\"');
428
- const finalCommand = command.replace('{input}', sanitizedInput);
459
+ // In-process judges. A standard names one with `simulator.judge`; copies installed before that field
460
+ // existed carry `command: echo "{input}" | npx commitlint`, and are routed the same way.
461
+ const judgeName = simulator.judge
462
+ || (standardConfig?.standard?.id === 'commit-message' && /commitlint/.test(simulator.command || '') ? 'commit-message' : null);
463
+ if (judgeName === 'commit-message') {
464
+ const outcome = judgeCommitMessage(standardConfig, input, { standardsDir: this.standardsDir });
465
+ const details = [
466
+ ...outcome.findings.map(f => `- ${f}`),
467
+ `Checked: ${outcome.checked.join('; ')}`,
468
+ `Not checked: ${outcome.notChecked.join('; ')}`
469
+ ].join('\n');
470
+ return outcome.verdict === 'pass'
471
+ ? { status: 'pass', success: true, message: 'Simulation passed', details }
472
+ : { status: 'fail', success: false, message: 'Simulation failed: the input does not comply', details };
473
+ }
474
+ if (simulator.judge) {
475
+ return cannot(`Standard '${standardId}' names an unknown simulator judge '${simulator.judge}'.`);
476
+ }
477
+
478
+ if (typeof simulator.command !== 'string' || simulator.command.trim() === '') {
479
+ return cannot(`Standard '${standardId}' defines a simulator without a command or a judge.`);
480
+ }
481
+ return this._simulateWithCommand(simulator.command, input);
482
+ }
483
+
484
+ /** @private Names the standards that can be simulated, for messages. */
485
+ _simulatableHint() {
486
+ const ids = this.listSimulatableStandards();
487
+ return ids.length > 0
488
+ ? `Standards that can be simulated in this project: ${ids.join(', ')}.`
489
+ : 'No installed standard defines a simulator.';
490
+ }
491
+
492
+ /**
493
+ * @private Delegate to the command a standard gives. The input never becomes part of the shell string:
494
+ * `{input}` is replaced by a reference to an environment variable, which the shell expands without
495
+ * re-reading its value (so quotes, `$` and backticks in the input stay data). A tool that is not usable
496
+ * (not found, not executable) is `cannot-simulate`; a tool that ran and said no is `fail`.
497
+ */
498
+ async _simulateWithCommand(command, input) {
499
+ const ref = process.platform === 'win32' ? '%UDS_SIMULATE_INPUT%' : '$UDS_SIMULATE_INPUT';
500
+ const finalCommand = command.split('{input}').join(ref);
501
+ const env = { ...process.env, UDS_SIMULATE_INPUT: String(input) };
429
502
 
430
503
  try {
431
- const { stdout } = await execAsync(finalCommand, { cwd: this.projectPath });
432
- return {
433
- success: true,
434
- message: 'Simulation passed',
435
- details: stdout.trim()
436
- };
504
+ const { stdout } = await execAsync(finalCommand, { cwd: this.projectPath, env });
505
+ return { status: 'pass', success: true, message: 'Simulation passed', details: stdout.trim() };
437
506
  } catch (e) {
438
- return {
439
- success: false,
440
- message: 'Simulation failed',
441
- details: e.message + (e.stdout ? `\nOutput: ${e.stdout}` : '')
442
- };
507
+ const text = `${e.stderr || ''}`;
508
+ const notUsable = e.code === 126 || e.code === 127 || e.code === 9009
509
+ || /command not found|not recognized as an internal or external command|ENOENT/i.test(text);
510
+ const details = e.message + (e.stdout ? `\nOutput: ${e.stdout}` : '');
511
+ return notUsable
512
+ ? { status: 'cannot-simulate', success: false, message: 'Simulation could not run: the tool the standard delegates to is not usable here', details }
513
+ : { status: 'fail', success: false, message: 'Simulation failed: the input does not comply', details };
443
514
  }
444
515
  }
445
516
  }
@@ -0,0 +1,160 @@
1
+ /**
2
+ * "This commit changes code and touches no test" — the pre-commit check.
3
+ * // implements XSPEC-444 R2
4
+ *
5
+ * Runs inside `uds check`, which is what the pre-commit hook UDS writes calls. It reads
6
+ * what is staged (`git diff --cached`); with nothing staged (a CI run, a manual
7
+ * `uds check`) it says nothing, because there is no commit to judge.
8
+ *
9
+ * What it decides, per staged file (see test-policy.js for the table):
10
+ * source + no test in the same change → warn, listing every code file
11
+ * a file of a type the table has never seen → warn, listing it and saying how to
12
+ * classify it. Never read as "fine".
13
+ * pure rename (git's R100) → exempt; recorded in the output with its reason
14
+ * deletion → not a code change that needs a test
15
+ * `exempt` entry in the policy → exempt; recorded with the adopter's reason
16
+ *
17
+ * Severity: "warn" by default. `"mode": "block"` in `.standards/test-policy.json` makes a
18
+ * code change without a test fail the check. An unclassified file never blocks — it is
19
+ * UDS's own gap, not the committer's.
20
+ *
21
+ * NOT done here, on purpose (reported to the maintainer instead of guessed):
22
+ * - the ratchet ("count of unpaired changes may only go down"): `uds check` is read-only
23
+ * by design and the spec does not say where the baseline lives or what a "change" is
24
+ * counted in.
25
+ * - per-commit exemption with a reason: a pre-commit hook cannot read the commit message
26
+ * (that is the commit-msg hook), so a per-commit reason has nowhere to be read from.
27
+ * Standing exemptions with reasons are `exempt` entries in the policy file.
28
+ */
29
+
30
+ import { execFileSync } from 'child_process';
31
+ import chalk from 'chalk';
32
+ import { loadPolicy, classifyPath, POLICY_FILE } from './test-policy.js';
33
+
34
+ /**
35
+ * Parse `git diff --name-status -z` output.
36
+ * Records: `A\0path\0`, `M\0path\0`, `D\0path\0`, `R100\0old\0new\0`, `C75\0old\0new\0`.
37
+ * @returns {{ status: string, path: string, oldPath?: string, similarity?: number }[]}
38
+ */
39
+ export function parseNameStatusZ(output) {
40
+ const parts = output.split('\0');
41
+ if (parts[parts.length - 1] === '') parts.pop();
42
+ const out = [];
43
+ for (let i = 0; i < parts.length;) {
44
+ const code = parts[i++];
45
+ if (!code) continue;
46
+ const letter = code[0];
47
+ if (letter === 'R' || letter === 'C') {
48
+ out.push({ status: letter, oldPath: parts[i++], path: parts[i++], similarity: parseInt(code.slice(1), 10) || 0 });
49
+ } else {
50
+ out.push({ status: letter, path: parts[i++] });
51
+ }
52
+ }
53
+ return out;
54
+ }
55
+
56
+ /** The staged changes of the repository at `projectPath`, or `{ error }` when git cannot say. */
57
+ export function readStagedChanges(projectPath) {
58
+ try {
59
+ const out = execFileSync('git', ['-c', 'core.quotepath=off', 'diff', '--cached', '--name-status', '-M', '-z'], {
60
+ cwd: projectPath,
61
+ encoding: 'utf-8',
62
+ stdio: ['ignore', 'pipe', 'pipe'],
63
+ maxBuffer: 64 * 1024 * 1024
64
+ });
65
+ return { changes: parseNameStatusZ(out) };
66
+ } catch (e) {
67
+ const stderr = String(e.stderr || e.message || '').trim().split('\n')[0];
68
+ // "not a git repository" is not a failure of this check: there is no commit to judge.
69
+ if (/not a git repository/i.test(stderr) || e.code === 'ENOENT') return { notRepo: true, error: stderr || 'git not found' };
70
+ return { error: stderr || 'git diff failed' };
71
+ }
72
+ }
73
+
74
+ /**
75
+ * Judge a list of staged changes against a policy. Pure: no I/O.
76
+ * @returns {{
77
+ * staged: number, source: string[], tests: string[], unclassified: string[],
78
+ * exempt: {path:string, reason:string}[], verdict: 'none'|'ok'|'warn'
79
+ * }}
80
+ */
81
+ export function judgeChanges(changes, policy) {
82
+ const result = { staged: changes.length, source: [], tests: [], unclassified: [], exempt: [], verdict: 'none' };
83
+ for (const ch of changes) {
84
+ if (ch.status === 'D') continue;
85
+ const cls = classifyPath(ch.path, policy);
86
+ if (cls.kind === 'test') { result.tests.push(ch.path); continue; }
87
+ if (cls.kind === 'unclassified') { result.unclassified.push(ch.path); continue; }
88
+ if (cls.kind !== 'source') continue; // ignored / noncode
89
+ if (ch.status === 'R' && ch.similarity === 100) {
90
+ result.exempt.push({ path: ch.path, reason: `pure rename of ${ch.oldPath} (content unchanged)` });
91
+ continue;
92
+ }
93
+ if (cls.exempt) {
94
+ result.exempt.push({ path: ch.path, reason: `policy exemption "${cls.exempt.pattern}": ${cls.exempt.reason}` });
95
+ continue;
96
+ }
97
+ result.source.push(ch.path);
98
+ }
99
+ if (result.staged === 0) result.verdict = 'none';
100
+ else if (result.source.length > 0 && result.tests.length === 0) result.verdict = 'warn';
101
+ else result.verdict = 'ok';
102
+ return result;
103
+ }
104
+
105
+ const show = (list, max = 12) => {
106
+ const lines = list.slice(0, max).map((f) => ` - ${f}`);
107
+ if (list.length > max) lines.push(` ... and ${list.length - max} more`);
108
+ return lines;
109
+ };
110
+
111
+ /**
112
+ * Run the check and print its report. Never throws; never changes the exit code in
113
+ * "warn" mode. In "block" mode a code change with no test sets `process.exitCode = 1`.
114
+ * @returns {{ ran: boolean, stagedCount: number, verdict: string, mode: string, blocked: boolean, policyProblems: string[] }}
115
+ */
116
+ export function runTestChangeCheck(projectPath, { log = console.log } = {}) {
117
+ const { policy, problems } = loadPolicy(projectPath);
118
+ const staged = readStagedChanges(projectPath);
119
+ const base = { ran: false, stagedCount: 0, verdict: 'none', mode: policy.mode, blocked: false, policyProblems: problems };
120
+
121
+ for (const p of problems) log(chalk.yellow(` ⚠ [test-change] ${p}`));
122
+
123
+ if (staged.notRepo) return base;
124
+ if (staged.error) {
125
+ log(chalk.yellow(` ⚠ [test-change] could not read the staged changes (${staged.error}); the code-without-test check did not run.`));
126
+ return base;
127
+ }
128
+ const judged = judgeChanges(staged.changes, policy);
129
+ const result = { ...base, ran: true, stagedCount: judged.staged, verdict: judged.verdict };
130
+ if (judged.staged === 0) return result;
131
+
132
+ const blocking = judged.verdict === 'warn' && policy.mode === 'block';
133
+
134
+ if (judged.verdict === 'warn') {
135
+ const head = blocking
136
+ ? ` ✗ [test-change] BLOCKED: this commit changes ${judged.source.length} code file(s) and touches no test file (XSPEC-444 R2, mode "block").`
137
+ : ` ⚠ [test-change] This commit changes ${judged.source.length} code file(s) and touches no test file (XSPEC-444 R2). Warning only — the commit is not blocked.`;
138
+ log(blocking ? chalk.red(head) : chalk.yellow(head));
139
+ log(chalk.gray(' code files changed without a test change:'));
140
+ for (const l of show(judged.source)) log(chalk.gray(l));
141
+ log(chalk.gray(' A change to behavior needs a test that fails without it. Not a behavior change (generated code, a rename with edits)?'));
142
+ log(chalk.gray(` Record the exemption with its reason in ${POLICY_FILE}: "exempt": [{ "pattern": "<glob>", "reason": "<why>" }]`));
143
+ if (!blocking) log(chalk.gray(` To make this block the commit instead: set "mode": "block" in ${POLICY_FILE}.`));
144
+ }
145
+ if (judged.unclassified.length > 0) {
146
+ log(chalk.yellow(` ⚠ [test-change] ${judged.unclassified.length} changed file(s) are of a type UDS does not recognize, so it cannot tell whether they are code (never assumed fine, never blocks):`));
147
+ for (const l of show(judged.unclassified)) log(chalk.gray(l));
148
+ log(chalk.gray(` Say what they are in ${POLICY_FILE}: "sourceExtensions": ["<ext>"] (code) or "nonCodeExtensions": ["<ext>"] (not code); test files: "testPatterns".`));
149
+ }
150
+ if (judged.exempt.length > 0) {
151
+ log(chalk.gray(' ℹ [test-change] exempt from the test requirement, with the reason on record:'));
152
+ for (const e of judged.exempt.slice(0, 12)) log(chalk.gray(` - ${e.path} — ${e.reason}`));
153
+ }
154
+ if (blocking) {
155
+ process.exitCode = 1;
156
+ result.blocked = true;
157
+ }
158
+ if (judged.verdict === 'warn' || judged.unclassified.length > 0 || judged.exempt.length > 0) log();
159
+ return result;
160
+ }