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
@@ -0,0 +1,103 @@
1
+ /**
2
+ * Which `manifest.commandHashes` records `uds check` may hold this project to (XSPEC-454 R2, the
3
+ * Commands half).
4
+ *
5
+ * A record is `<agent>/<file>` (`opencode/commit.md`, `gemini-cli/commit.toml`) with no level in it.
6
+ * Two kinds of record do not describe a file this project's check can vouch for:
7
+ *
8
+ * - FOREIGN: the name is not a command UDS ships (any more). A retired command whose file is gone is
9
+ * a "missing" nobody can restore. These are dropped for good by `uds update`.
10
+ * - ELSEWHERE: the command was installed at user level (`~/.config/opencode/command`), shared by every
11
+ * project on the machine. The check looks inside the project, so every one of them would read
12
+ * "missing" — and another project's `uds update` can rewrite them at any time, so "modified" would
13
+ * be noise too. They are ignored by the check and left in the manifest (user-level update still
14
+ * refreshes them).
15
+ *
16
+ * Both exist for the same reason the skills ones do: once a missing or changed command file counts toward
17
+ * the verdict, a record that points at nothing this project owns would fail the project for a file
18
+ * nobody can fix.
19
+ *
20
+ * @module utils/command-hash-ownership
21
+ */
22
+
23
+ import { getAvailableCommandNames } from './skills-installer.js';
24
+ import { getCommandFileExtension } from '../config/ai-agent-paths.js';
25
+
26
+ /** Below this many shipped commands the source tree did not load; never treat that as "UDS ships none". */
27
+ const MIN_SHIPPED_COMMANDS = 10;
28
+
29
+ /**
30
+ * @param {string} key - A commandHashes key
31
+ * @param {Set<string>} shipped - Names of the commands UDS ships (no extension)
32
+ * @returns {boolean}
33
+ */
34
+ export function isUdsCommandHashKey(key, shipped) {
35
+ const parts = String(key).split('/');
36
+ if (parts.length !== 2 || !parts[0] || !parts[1]) return false;
37
+ const [agent, file] = parts;
38
+ const ext = getCommandFileExtension(agent);
39
+ return file.endsWith(ext) && shipped.has(file.slice(0, -ext.length));
40
+ }
41
+
42
+ /**
43
+ * Drop the commandHashes records for commands UDS does not ship. Mutates `manifest`.
44
+ * @param {Object} manifest
45
+ * @param {Set<string>} [shipped] - Injection point for tests
46
+ * @returns {string[]} The keys dropped, sorted
47
+ */
48
+ export function pruneForeignCommandHashes(manifest, shipped = new Set(getAvailableCommandNames())) {
49
+ const hashes = manifest?.commandHashes;
50
+ if (!hashes || shipped.size < MIN_SHIPPED_COMMANDS) return [];
51
+ const dropped = [];
52
+ for (const key of Object.keys(hashes)) {
53
+ if (isUdsCommandHashKey(key, shipped)) continue;
54
+ delete hashes[key];
55
+ dropped.push(key);
56
+ }
57
+ return dropped.sort();
58
+ }
59
+
60
+ /**
61
+ * Agents whose commands are installed, but only outside this project (user level or marketplace).
62
+ * An agent with no recorded installation at all is a legacy manifest and counts as project-level.
63
+ * @param {Object} manifest
64
+ * @returns {Set<string>}
65
+ */
66
+ export function agentsWithCommandsOutsideProject(manifest) {
67
+ const levels = new Map(); // agent -> Set of levels
68
+ for (const entry of manifest?.commands?.installations || []) {
69
+ const agent = typeof entry === 'string' ? entry : entry?.agent;
70
+ const level = typeof entry === 'string' ? 'project' : (entry?.level || 'project');
71
+ if (!agent) continue;
72
+ if (!levels.has(agent)) levels.set(agent, new Set());
73
+ levels.get(agent).add(level);
74
+ }
75
+ return new Set([...levels].filter(([, set]) => !set.has('project')).map(([agent]) => agent));
76
+ }
77
+
78
+ /**
79
+ * The part of `manifest.commandHashes` this project's check is responsible for.
80
+ * @param {Object} manifest
81
+ * @returns {{ hashes: Object, ignored: string[] }} `ignored` are the keys set aside as ELSEWHERE
82
+ */
83
+ export function projectCommandHashes(manifest) {
84
+ const all = manifest?.commandHashes || {};
85
+ const outside = agentsWithCommandsOutsideProject(manifest);
86
+ const hashes = {};
87
+ const ignored = [];
88
+ for (const [key, info] of Object.entries(all)) {
89
+ if (outside.has(key.split('/')[0])) ignored.push(key);
90
+ else hashes[key] = info;
91
+ }
92
+ return { hashes, ignored };
93
+ }
94
+
95
+ /**
96
+ * The command files `uds check` has to report: missing and modified, as one list. Its result is what the
97
+ * verdict is built from — it used to be discarded, like the Skills one.
98
+ * @param {{ missing?: string[], modified?: string[] }} status
99
+ * @returns {string[]}
100
+ */
101
+ export function commandIssuesOf(status) {
102
+ return [...(status?.missing || []), ...(status?.modified || [])];
103
+ }
@@ -0,0 +1,155 @@
1
+ /**
2
+ * Judge a commit message against the commit-message standard, in this process.
3
+ * // implements XSPEC-456 R2
4
+ *
5
+ * `uds simulate -s commit-message` used to pipe the message into `npx commitlint`. That needs the
6
+ * network the first time (npx downloads the tool), needs a commitlint config in the project, and
7
+ * interpolates the message into a shell string. In a project with no commitlint config the tool refuses
8
+ * to run at all, and the old code printed that refusal as "Simulation Failed" - the same answer for a
9
+ * compliant message and a non-compliant one, which is the one thing a simulator must not do.
10
+ *
11
+ * Here the verdict comes from the standard's own rules, read from the installed standard file
12
+ * (`.standards/commit-message.ai.yaml`):
13
+ *
14
+ * - the header shape `<type>(<scope>): <subject>` from `format.template` (scope optional, as the
15
+ * standard's component list says);
16
+ * - the allowed types, from the commit-message option files installed next to the standard
17
+ * (`.standards/options/`, files whose `meta.parent` is `commit-message`); the Conventional Commits
18
+ * set when none are installed;
19
+ * - rule `scope-lowercase` and rule `subject-max-length`, using the `validator` pattern the standard gives.
20
+ *
21
+ * What it does NOT judge is returned in `notChecked`, so a pass never reads as more than it is: rules
22
+ * with no machine-checkable pattern (imperative mood, one logical change per commit) and the language
23
+ * option.
24
+ *
25
+ * @module utils/commit-message-judge
26
+ */
27
+
28
+ import fs from 'fs';
29
+ import path from 'path';
30
+ import * as yaml from 'js-yaml';
31
+
32
+ /** Used only when no commit-message option file is installed. The Conventional Commits type set. */
33
+ export const FALLBACK_TYPES = ['feat', 'fix', 'docs', 'style', 'refactor', 'perf', 'test', 'build', 'ci', 'chore', 'revert'];
34
+
35
+ /**
36
+ * `type(scope)!: subject` - scope and the breaking-change mark are optional.
37
+ * // implements XSPEC-475 R1
38
+ * The type is any run of letters (any script) and digits, not only ASCII: the traditional-chinese option file
39
+ * allows types like 新增 and 修正. Whether the word is an ALLOWED type is decided afterwards, from the option
40
+ * files; the header shape only says where the type is.
41
+ */
42
+ const HEADER = /^(?<type>\p{L}[\p{L}\p{N}-]*)(?:\((?<scope>[^()]*)\))?(?<bang>!)?: (?<subject>\S.*)$/u;
43
+
44
+ /**
45
+ * Lowercase rules (`scope-lowercase`) are about letters that HAVE a case. A Chinese character has no
46
+ * lowercase form, so it can neither pass nor break the rule. Each such letter is replaced with a lowercase
47
+ * stand-in before the standard's own pattern is applied, so the pattern stays the single source of the rule.
48
+ * // implements XSPEC-475 R1
49
+ */
50
+ function withUncasedLettersAsLowercase(text) {
51
+ return text.replace(/\p{L}/gu, (ch) => (ch.toLowerCase() === ch.toUpperCase() ? 'a' : ch));
52
+ }
53
+
54
+ /**
55
+ * The commit types the project's installed option files allow. An option file belongs to this standard when
56
+ * its `meta.parent` is `commit-message`. Installed projects keep option files flat in `.standards/options/`
57
+ * (`english.ai.yaml`); a checkout of UDS itself nests them (`.standards/options/commit-message/`). Both are read.
58
+ * @param {string} standardsDir - `<project>/.standards`
59
+ * @returns {{ types: string[], source: string }}
60
+ */
61
+ export function allowedCommitTypes(standardsDir) {
62
+ const found = new Set();
63
+ const optionsDir = path.join(standardsDir, 'options');
64
+ for (const dir of [optionsDir, path.join(optionsDir, 'commit-message')]) {
65
+ let names = [];
66
+ try {
67
+ names = fs.readdirSync(dir).filter((n) => n.endsWith('.ai.yaml'));
68
+ } catch {
69
+ continue; // this layout is not present
70
+ }
71
+ for (const name of names) {
72
+ try {
73
+ const doc = yaml.load(fs.readFileSync(path.join(dir, name), 'utf-8'));
74
+ if (doc?.meta?.parent !== 'commit-message') continue;
75
+ for (const entry of doc.types || []) {
76
+ if (entry && typeof entry.type === 'string') found.add(entry.type);
77
+ }
78
+ } catch {
79
+ // an unreadable option file contributes nothing
80
+ }
81
+ }
82
+ }
83
+ if (found.size === 0) return { types: FALLBACK_TYPES, source: 'the Conventional Commits set, because no commit-message option file is installed' };
84
+ return { types: [...found], source: '.standards/options' };
85
+ }
86
+
87
+ /** The `validator` pattern of a rule in the standard, as a RegExp, or null when there is none. */
88
+ function ruleValidator(standardConfig, ruleId) {
89
+ const rule = (standardConfig?.standard?.rules || []).find((r) => r && r.id === ruleId);
90
+ if (!rule || typeof rule.validator !== 'string') return null;
91
+ try {
92
+ return new RegExp(rule.validator);
93
+ } catch {
94
+ return null;
95
+ }
96
+ }
97
+
98
+ /**
99
+ * @param {Object} standardConfig - the parsed commit-message standard
100
+ * @param {string} input - the commit message (only the first line is the header)
101
+ * @param {{ standardsDir: string }} context
102
+ * @returns {{ verdict: 'pass' | 'fail', findings: string[], checked: string[], notChecked: string[] }}
103
+ */
104
+ export function judgeCommitMessage(standardConfig, input, { standardsDir }) {
105
+ const findings = [];
106
+ const checked = [];
107
+ const notChecked = [];
108
+
109
+ const header = String(input).replace(/\r\n/g, '\n').split('\n')[0];
110
+ const match = HEADER.exec(header);
111
+
112
+ checked.push('header format <type>(<scope>): <subject>');
113
+ if (!match) {
114
+ findings.push('The first line is not in the form <type>(<scope>): <subject> (scope is optional).');
115
+ } else {
116
+ const { type, scope, subject } = match.groups;
117
+ const { types, source } = allowedCommitTypes(standardsDir);
118
+
119
+ checked.push(`type is one of: ${types.join(', ')} (from ${source})`);
120
+ if (!types.includes(type)) {
121
+ findings.push(`Type "${type}" is not one of: ${types.join(', ')}.${/[^\u0020-\u007E]/.test(type)
122
+ ? ' The type must be an English word from that list; only the subject may be Chinese (for example `feat(api): 新增部門端點`).'
123
+ : ''}`);
124
+ }
125
+
126
+ if (scope !== undefined) {
127
+ const scopeRule = ruleValidator(standardConfig, 'scope-lowercase');
128
+ if (scopeRule) {
129
+ checked.push('rule scope-lowercase');
130
+ if (scope === '' || !scopeRule.test(withUncasedLettersAsLowercase(scope))) {
131
+ findings.push(`Scope "${scope}" breaks rule scope-lowercase (use lowercase letters, digits and dashes, starting with a letter).`);
132
+ }
133
+ } else {
134
+ notChecked.push('rule scope-lowercase (this copy of the standard gives no pattern for it)');
135
+ }
136
+ }
137
+
138
+ if (subject.trim() === '') findings.push('The subject is empty.');
139
+ }
140
+
141
+ const lengthRule = ruleValidator(standardConfig, 'subject-max-length');
142
+ if (lengthRule) {
143
+ checked.push('rule subject-max-length');
144
+ if (!lengthRule.test(header)) {
145
+ findings.push(`The subject line is ${header.length} characters, which breaks rule subject-max-length.`);
146
+ }
147
+ } else {
148
+ notChecked.push('rule subject-max-length (this copy of the standard gives no pattern for it)');
149
+ }
150
+
151
+ notChecked.push('rule imperative-mood (the standard gives no machine-checkable pattern)');
152
+ notChecked.push('rule no-mixed-changes and the commit language option');
153
+
154
+ return { verdict: findings.length === 0 ? 'pass' : 'fail', findings, checked, notChecked };
155
+ }
@@ -1,4 +1,5 @@
1
- import { existsSync, mkdirSync, copyFileSync } from 'fs';
1
+ import { existsSync, mkdirSync, copyFileSync, readFileSync } from 'fs';
2
+ import { copyFileSyncRetrying } from './transient-fs.js';
2
3
  import { dirname, join, basename } from 'path';
3
4
  import { fileURLToPath } from 'url';
4
5
  import { downloadStandard, downloadIntegration } from './github.js';
@@ -26,15 +27,92 @@ function getSourcePath(sourcePath) {
26
27
  return PathResolver.getStandardSource(sourcePath);
27
28
  }
28
29
 
30
+ /**
31
+ * Is this source path one of the add-on files under `extensions/`?
32
+ * @param {string} sourcePath - Relative path from repo root
33
+ * @returns {boolean}
34
+ */
35
+ export function isExtensionPath(sourcePath) {
36
+ return typeof sourcePath === 'string' && sourcePath.replace(/\\/g, '/').startsWith('extensions/');
37
+ }
38
+
39
+ /**
40
+ * Copy an extension file (language style guide, framework pattern, locale pack)
41
+ * into the target project — from the installed package ONLY.
42
+ *
43
+ * 🔴 There is deliberately no download fallback here (XSPEC-452 R2). `extensions/`
44
+ * used to be missing from the npm package, so the copy below fell through to
45
+ * `raw.githubusercontent.com/.../main`: offline installs failed, an install pulled
46
+ * whatever `main` held that day instead of the version the adopter had installed,
47
+ * and a file that did not exist anywhere (`extensions/locales/zh-cn.md`, XSPEC-451)
48
+ * hid behind that fallback until someone ran the locale. A declared extension that
49
+ * is not in the package is a packaging defect, so it fails — by name.
50
+ *
51
+ * @param {string} sourcePath - Relative path from repo root (e.g., 'extensions/locales/zh-tw.md')
52
+ * @param {string} targetDir - Target directory (usually '.standards')
53
+ * @param {string} projectPath - Project root path
54
+ * @returns {Promise<Object>} Result with success status and copied path
55
+ */
56
+ export async function copyExtension(sourcePath, targetDir, projectPath) {
57
+ try {
58
+ const packagedSource = getSourcePath(sourcePath);
59
+ if (!packagedSource) {
60
+ return failure(
61
+ `Extension file not found in the installed package: ${sourcePath} (extension files are never downloaded; reinstall or upgrade universal-dev-standards)`,
62
+ ERROR_CODES.FILE_NOT_FOUND,
63
+ { sourcePath, targetDir }
64
+ );
65
+ }
66
+ const targetFolder = join(projectPath, targetDir);
67
+ const targetFile = join(targetFolder, basename(sourcePath));
68
+ if (!existsSync(targetFolder)) {
69
+ mkdirSync(targetFolder, { recursive: true });
70
+ }
71
+ copyFileSyncRetrying(packagedSource, targetFile);
72
+ return success(targetFile, { source: 'local', sourcePath, targetFile });
73
+ } catch (error) {
74
+ return failure(
75
+ error.message,
76
+ ERROR_CODES.FILE_COPY_FAILED,
77
+ { sourcePath, targetDir, projectPath }
78
+ );
79
+ }
80
+ }
81
+
82
+ /**
83
+ * Read the original of a source path from the installed package — never from the network.
84
+ *
85
+ * This is what `uds check --diff` compares an adopter's file against (XSPEC-453 R1). The original
86
+ * used to be downloaded from GitHub `main`: offline it failed, and whatever UDS had changed on `main`
87
+ * since the adopter installed was listed as a difference the adopter had made. The package's own copy
88
+ * is the version that was installed, so a difference against it is the adopter's.
89
+ *
90
+ * Returns `null` when the installed package has no such file; the caller says so by name. There is
91
+ * deliberately no fallback to a download here.
92
+ *
93
+ * @param {string} sourcePath - Relative path from repo root (e.g., 'ai/standards/x.ai.yaml', 'extensions/locales/zh-tw.md')
94
+ * @returns {string|null} File content, or null if the installed package does not contain it
95
+ */
96
+ export function readPackagedSource(sourcePath) {
97
+ const source = getSourcePath(sourcePath);
98
+ if (!source) return null;
99
+ return readFileSync(source, 'utf-8');
100
+ }
101
+
29
102
  /**
30
103
  * Copy a standard file to target project
31
104
  * Falls back to downloading from GitHub if local file not found
105
+ * (except for `extensions/` files, which are package-only — see copyExtension)
32
106
  * @param {string} sourcePath - Relative path from repo root (e.g., 'core/anti-hallucination.md')
33
107
  * @param {string} targetDir - Target directory (usually '.standards')
34
108
  * @param {string} projectPath - Project root path
35
109
  * @returns {Promise<Object>} Result with success status and copied path
36
110
  */
37
111
  export async function copyStandard(sourcePath, targetDir, projectPath) {
112
+ // Extensions never take the GitHub fallback below, whichever caller got here (XSPEC-452 R2).
113
+ if (isExtensionPath(sourcePath)) {
114
+ return copyExtension(sourcePath, targetDir, projectPath);
115
+ }
38
116
  try {
39
117
  const targetFolder = join(projectPath, targetDir);
40
118
  const targetFile = join(targetFolder, basename(sourcePath));
@@ -47,7 +125,7 @@ export async function copyStandard(sourcePath, targetDir, projectPath) {
47
125
  // Try local copy first (bundled or repo)
48
126
  const source = getSourcePath(sourcePath);
49
127
  if (source) {
50
- copyFileSync(source, targetFile);
128
+ copyFileSyncRetrying(source, targetFile);
51
129
  return success(targetFile, {
52
130
  source: 'local',
53
131
  sourcePath,
@@ -0,0 +1,25 @@
1
+ /**
2
+ * When `uds deps --if-present` is allowed to say "not applicable" instead of failing.
3
+ * // implements XSPEC-456 R6
4
+ *
5
+ * `uds deps` exits 1 when there is no package.json, on purpose: a check that examined nothing must not
6
+ * be able to show a pass (the same rule as `clean` in utils/dependency-resolution.js). That makes it
7
+ * awkward in a shared script that also runs in .NET, Python or Go projects, where callers ended up
8
+ * writing `if [ -f package.json ]` around it. `--if-present` is that guard made part of the command
9
+ * AND visible: the run says nothing was checked, in words, and exits 0.
10
+ *
11
+ * @module utils/deps-applicability
12
+ */
13
+
14
+ import { existsSync } from 'fs';
15
+ import { join } from 'path';
16
+
17
+ /**
18
+ * @param {string} root - Directory `uds deps` would examine
19
+ * @param {boolean} ifPresent - Whether `--if-present` was given
20
+ * @returns {'no-package-json' | null} Why the run is not applicable, or null when it must be run
21
+ */
22
+ export function notApplicableReason(root, ifPresent) {
23
+ if (ifPresent && !existsSync(join(root, 'package.json'))) return 'no-package-json';
24
+ return null;
25
+ }
@@ -111,6 +111,50 @@ export function detectFramework(projectPath) {
111
111
  return detected;
112
112
  }
113
113
 
114
+ /**
115
+ * Files and directories under `.agents/` that Antigravity (agy) owns.
116
+ *
117
+ * 🔴 Detection used to be `.agents/AGENTS.md` alone (2026-09-08). That file is one
118
+ * of the things agy reads but a project can use agy for a long time without ever
119
+ * creating it, so `uds init --with-hooks` in such a project never wired the hook
120
+ * (found 2026-09-29 installing 6.14.0-beta.1 into a fresh project).
121
+ *
122
+ * The markers below come from the agy 1.2.12 binary (`strings`: the literal path
123
+ * templates `.agents/rules/`, `.agents/workflows/`, `.agents/plugins/`,
124
+ * `.agents/hooks.json`, `.agents/skills.json`, `.agents/agents/`) and from
125
+ * antigravity.google/docs/hooks (project hooks live at `.agents/hooks.json`;
126
+ * "Rules" and "Workflows" are documented Antigravity concepts). Chosen: the ones
127
+ * documented or carried by the tool itself whose NAME is agy's — not the generic
128
+ * `agents/` or `skills.json`.
129
+ *
130
+ * ⚠️ `.agents/skills/` is NOT a marker. Codex reads project skills from the same
131
+ * `.agents/skills/` (measured 2026-09-08: only that arm made Codex see the
132
+ * skills), so a directory that both tools share cannot say which one is in use.
133
+ * A repo with root AGENTS.md plus `.agents/skills/` is Codex and must stay Codex.
134
+ *
135
+ * ⚠️ `.agents/hooks.json` is also the file `uds` itself writes for agy. Detecting
136
+ * on it is self-referential: after an install it proves the install happened, not
137
+ * that the adopter uses agy. It is kept because a hooks.json that someone else
138
+ * (the adopter, another tool) put there is real evidence, and because dropping it
139
+ * would make a re-run of the installer stop seeing the project it just wired.
140
+ *
141
+ * Not used: `~/.gemini/projects.json` lists the projects agy has opened. It is the
142
+ * tool's own registry and a strong signal, but it lives in the user's home, is
143
+ * machine-local, and would make the same repository detect differently on two
144
+ * machines. Detection stays a function of the project directory.
145
+ */
146
+ export const ANTIGRAVITY_MARKERS = ['AGENTS.md', 'hooks.json', 'rules', 'workflows', 'plugins'];
147
+
148
+ /**
149
+ * @param {string} projectPath
150
+ * @returns {boolean} true when `.agents/` carries something Antigravity owns
151
+ */
152
+ export function detectAntigravity(projectPath) {
153
+ const dir = join(projectPath, '.agents');
154
+ if (!existsSync(dir)) return false;
155
+ return ANTIGRAVITY_MARKERS.some((m) => existsSync(join(dir, m)));
156
+ }
157
+
114
158
  /**
115
159
  * Detect AI tools configured in the project
116
160
  * @param {string} projectPath - Path to the project
@@ -129,7 +173,8 @@ export function detectAITools(projectPath) {
129
173
  // Antigravity never read INSTRUCTIONS.md.
130
174
  // Measured 2026-09-08 with two positive controls in the same run: tokens planted in `AGENTS.md` and `.agents/AGENTS.md` both came back with correct attribution; the one in INSTRUCTIONS.md did not.
131
175
  // `.agents/AGENTS.md` is used rather than the repo root so it does not collide with Codex/OpenCode, which both target root AGENTS.md.
132
- antigravity: existsSync(join(projectPath, '.agents', 'AGENTS.md')),
176
+ // See detectAntigravity() for the wider marker set and for what is deliberately NOT one.
177
+ antigravity: detectAntigravity(projectPath),
133
178
  // 🔴 Roo Code had a full entry in the path table (`.roo/skills/`, tier "complete"
134
179
  // in REGISTRY.json) and NO line here, so `uds init` could never install for it —
135
180
  // however correct those paths were. Found by `check:install-paths`, which walks
@@ -15,6 +15,8 @@ import { join } from 'path';
15
15
  import { compareFileHash, hasFileHashes, computeFileHash } from './hasher.js';
16
16
  import { SUPPORTED_AI_TOOLS } from '../core/constants.js';
17
17
  import { getAllStandards, getStandardSource } from './registry.js';
18
+ import { getAvailableStandards } from './available-standards.js';
19
+ import { t } from '../i18n/messages.js';
18
20
 
19
21
  /**
20
22
  * Run friction detection on a UDS installation
@@ -39,9 +41,34 @@ export function detectFrictions(projectPath, manifest) {
39
41
  const orphaned = detectOrphanedFiles(projectPath, manifest);
40
42
  frictions.push(...orphaned);
41
43
 
44
+ // Type 4: Standards UDS ships that this project does not have (LOW severity, XSPEC-458 R5).
45
+ // One finding, not one per standard. It is information: `audit --score` does not read frictions,
46
+ // so this cannot move a score.
47
+ frictions.push(...detectAvailableStandards(manifest));
48
+
42
49
  return frictions;
43
50
  }
44
51
 
52
+ /**
53
+ * Standards UDS ships (and `uds init` installs) that this project's manifest does not list.
54
+ * @param {Object} manifest
55
+ * @returns {Array}
56
+ */
57
+ function detectAvailableStandards(manifest) {
58
+ const { offered } = getAvailableStandards(manifest);
59
+ if (offered.length === 0) return [];
60
+
61
+ const msg = t().availableStandards;
62
+ const shown = offered.slice(0, 5).map(s => s.id).join(', ');
63
+ return [{
64
+ standard: msg.frictionStandard.replace('{count}', offered.length),
65
+ type: 'not-installed',
66
+ severity: 'LOW',
67
+ diff: offered.length > 5 ? `${shown}, …` : shown,
68
+ suggestion: msg.frictionSuggestion
69
+ }];
70
+ }
71
+
45
72
  /**
46
73
  * Detect standards files that were modified by the user
47
74
  * @param {string} projectPath
@@ -0,0 +1,141 @@
1
+ /**
2
+ * The two scanners UDS ships into an adopter's project, and the code that runs them.
3
+ * // implements XSPEC-444 R5
4
+ *
5
+ * `full-coverage-testing` has always told adopters to "add scripts/check-stubs.sh and
6
+ * scripts/check-anti-fake-tests.sh", and its validator checked that those files EXIST —
7
+ * but UDS shipped neither, so the instruction could not be followed and the check could
8
+ * only ever say "missing". This is the missing half:
9
+ *
10
+ * installGateScripts() `uds init` writes the two scanners (templates/gates/*.mjs) to
11
+ * `<project>/scripts/`, records them for `uds uninstall`, and never
12
+ * overwrites a file that is already there.
13
+ * runTestQualityGates() `uds check` (what the pre-commit hook runs) executes the ones that
14
+ * are installed and prints what they found as a WARNING. It does not
15
+ * change the exit code unless the adopter set `"mode": "block"`.
16
+ *
17
+ * Why the scanners are written into the project instead of run from the CLI: they are the
18
+ * adopter's to read, edit and wire into CI (`node scripts/check-stubs.mjs` is a hard gate on
19
+ * its own), and a standard that says "this file must exist" is only honest if the file does.
20
+ */
21
+
22
+ import { existsSync, readFileSync, writeFileSync } from 'fs';
23
+ import { dirname, join } from 'path';
24
+ import { spawnSync } from 'child_process';
25
+ import chalk from 'chalk';
26
+ import { getRepoRoot } from './copier.js';
27
+ import { newRecorder, mkdirTracked, recordFile, RECORD_KINDS } from '../core/install-records.js';
28
+ import { loadPolicy } from './test-policy.js';
29
+ import { readStagedChanges } from './test-change-check.js';
30
+
31
+ /** The standard that asks for these scripts; they are only written when it is installed. */
32
+ export const GATE_STANDARD_FILE = 'full-coverage-testing.ai.yaml';
33
+
34
+ export const GATE_SCRIPTS = Object.freeze([
35
+ { file: 'check-anti-fake-tests.mjs', label: 'anti-fake-test', what: 'tests that cannot fail' },
36
+ { file: 'check-stubs.mjs', label: 'stub', what: 'placeholders and empty shells' }
37
+ ]);
38
+
39
+ const templatePath = (file) => join(getRepoRoot(), 'templates', 'gates', file);
40
+ const destRel = (file) => `scripts/${file}`;
41
+
42
+ export function gateStandardInstalled(projectPath) {
43
+ return existsSync(join(projectPath, '.standards', GATE_STANDARD_FILE));
44
+ }
45
+
46
+ /**
47
+ * Write the scanners into `<project>/scripts/`. Never overwrites: a file that exists is the
48
+ * adopter's (they may have edited it), and is reported as kept.
49
+ * @param {string} projectPath
50
+ * @param {object} recorder an install-records recorder (see core/install-records.js)
51
+ * @returns {{ written: string[], kept: string[], missingTemplate: string[], skipped?: string }}
52
+ */
53
+ export function installGateScripts(projectPath, recorder = newRecorder()) {
54
+ const result = { written: [], kept: [], missingTemplate: [] };
55
+ if (!gateStandardInstalled(projectPath)) {
56
+ result.skipped = `${GATE_STANDARD_FILE} is not installed in this project`;
57
+ return result;
58
+ }
59
+ for (const { file } of GATE_SCRIPTS) {
60
+ const rel = destRel(file);
61
+ const dest = join(projectPath, rel);
62
+ if (existsSync(dest)) { result.kept.push(rel); continue; }
63
+ const src = templatePath(file);
64
+ if (!existsSync(src)) { result.missingTemplate.push(file); continue; }
65
+ mkdirTracked(recorder, projectPath, dirname(dest));
66
+ writeFileSync(dest, readFileSync(src, 'utf-8'), 'utf-8');
67
+ recordFile(recorder, projectPath, rel, RECORD_KINDS.GATE_SCRIPT);
68
+ result.written.push(rel);
69
+ }
70
+ return result;
71
+ }
72
+
73
+ const MAX_SHOWN = 12;
74
+
75
+ /**
76
+ * Run the installed scanners and print the outcome. Never throws.
77
+ * @param {string} projectPath
78
+ * @param {{ staged?: boolean, mode?: 'warn'|'block', log?: Function }} [opts]
79
+ * staged — scan only the files staged for commit (what a pre-commit run wants);
80
+ * otherwise the whole project (a CI or manual run). Default: staged when
81
+ * something is staged, whole project when nothing is.
82
+ * @returns {{ ran: string[], findings: Record<string, number>, couldNotJudge: string[], blocked: boolean, missing: string[] }}
83
+ */
84
+ export function runTestQualityGates(projectPath, { staged, mode, log = console.log } = {}) {
85
+ const result = { ran: [], findings: {}, couldNotJudge: [], blocked: false, missing: [] };
86
+ const effectiveMode = mode || loadPolicy(projectPath).policy.mode;
87
+ const blocking = effectiveMode === 'block';
88
+
89
+ if (!gateStandardInstalled(projectPath)) return result;
90
+ if (staged === undefined) {
91
+ const s = readStagedChanges(projectPath);
92
+ staged = Array.isArray(s.changes) && s.changes.length > 0;
93
+ }
94
+
95
+ for (const { file, label } of GATE_SCRIPTS) {
96
+ const rel = destRel(file);
97
+ const abs = join(projectPath, rel);
98
+ if (!existsSync(abs)) { result.missing.push(file); continue; }
99
+
100
+ const args = [abs, ...(staged ? ['--staged'] : [])];
101
+ const r = spawnSync(process.execPath, args, { cwd: projectPath, encoding: 'utf-8', timeout: 120000, maxBuffer: 32 * 1024 * 1024 });
102
+ result.ran.push(file);
103
+
104
+ if (r.status === 0) {
105
+ log(chalk.gray(` ✓ [${label}] ${rel}: nothing found${staged ? ' in the staged files' : ''}`));
106
+ // "Nothing found" must not hide what was NOT looked at: the script lists files it could not
107
+ // judge (a language it has no rule for, an unparsable call) on lines that start with `·`.
108
+ for (const l of (r.stdout || '').split('\n').filter((x) => /^\s*·/.test(x))) log((/NOT scanned|could not be parsed/.test(l) ? chalk.yellow : chalk.gray)(` ${l.trim()}`));
109
+ continue;
110
+ }
111
+ if (r.status === 1) {
112
+ const lines = (r.stdout || '').split('\n').filter((l) => l.trim());
113
+ const count = lines.filter((l) => /^\s*✗/.test(l)).length;
114
+ result.findings[label] = count;
115
+ const head = blocking
116
+ ? ` ✗ [${label}] BLOCKED: ${rel} found ${count} finding(s) (mode "block").`
117
+ : ` ⚠ [${label}] ${rel} found ${count} finding(s) — warning only, the commit is not blocked.`;
118
+ log(blocking ? chalk.red(head) : chalk.yellow(head));
119
+ const shown = lines.slice(0, MAX_SHOWN + 4);
120
+ for (const l of shown) log(chalk.gray(` ${l.trim()}`));
121
+ if (lines.length > shown.length) log(chalk.gray(` ... (run \`node ${rel}\` to see everything)`));
122
+ if (blocking) result.blocked = true;
123
+ continue;
124
+ }
125
+ // exit 2, a crash, a timeout, a missing node: the scanner could not judge. Never a pass.
126
+ const why = r.error ? r.error.message : (r.stderr || r.stdout || `exit ${r.status}`).split('\n').find((l) => l.trim()) || `exit ${r.status}`;
127
+ result.couldNotJudge.push(label);
128
+ const head = blocking
129
+ ? ` ✗ [${label}] BLOCKED: ${rel} could not judge (mode "block" treats that as a failure): ${why.trim()}`
130
+ : ` ⚠ [${label}] ${rel} could not judge — this is NOT a pass: ${why.trim()}`;
131
+ log(blocking ? chalk.red(head) : chalk.yellow(head));
132
+ if (blocking) result.blocked = true;
133
+ }
134
+
135
+ if (result.missing.length > 0) {
136
+ log(chalk.gray(` ℹ [test-gates] ${result.missing.map(destRel).join(', ')} not installed (the full-coverage-testing standard asks for them). \`uds update\` offers to install them.`));
137
+ }
138
+ if (result.blocked) process.exitCode = 1;
139
+ if (result.ran.length > 0 || result.missing.length > 0) log();
140
+ return result;
141
+ }