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
@@ -1,13 +1,26 @@
1
- import { existsSync, rmSync } from 'fs';
1
+ import { existsSync, rmSync, rmdirSync, readdirSync, unlinkSync } from 'fs';
2
+ import { dirname, join, relative, isAbsolute } from 'path';
2
3
  import {
3
4
  getSkillsDirForAgent,
4
- getCommandsDirForAgent,
5
- getAgentsDirForAgent,
6
- getWorkflowsDirForAgent
5
+ getCommandsDirForAgent
7
6
  } from '../config/ai-agent-paths.js';
7
+ import { computeFileHash } from '../utils/hasher.js';
8
8
 
9
9
  /**
10
- * Uninstall skills, commands, agents, and workflows
10
+ * Uninstall skills and commands
11
+ *
12
+ * Skills and commands go into folders the adopter shares with other things
13
+ * (`.claude/skills/` holds their own skills too; `init` says so where it writes
14
+ * them). So this removes only what UDS can PROVE it wrote and nobody has changed
15
+ * since: a record in the manifest (`skillHashes` / `commandHashes`) plus a
16
+ * matching content hash. The same rule `uds uninstall` already applies to hook
17
+ * scripts and integration files. A file with no record, or edited since, is
18
+ * kept and said so. A folder UDS emptied is removed; a folder that still holds
19
+ * something else is left alone.
20
+ *
21
+ * This used to `rmSync` the whole skills folder, which took the adopter's own
22
+ * skills with it.
23
+ *
11
24
  * @param {string} projectPath - Project root path
12
25
  * @param {Object} manifest - Parsed manifest object
13
26
  * @param {Object} options - { dryRun, includeUserLevel }
@@ -26,30 +39,60 @@ export function uninstallSkills(projectPath, manifest, options = {}) {
26
39
  // Process skill installations
27
40
  const skillInstalls = manifest?.skills?.installations || [];
28
41
  for (const install of skillInstalls) {
29
- processInstallation(install, 'skills', projectPath, options, result);
42
+ processInstallation(install, 'skills', projectPath, manifest, options, result);
30
43
  }
31
44
 
32
45
  // Process command installations
33
46
  const cmdInstalls = manifest?.commands?.installations || [];
34
47
  for (const install of cmdInstalls) {
35
- processInstallation(install, 'commands', projectPath, options, result);
48
+ processInstallation(install, 'commands', projectPath, manifest, options, result);
36
49
  }
37
50
 
38
51
  return result;
39
52
  }
40
53
 
41
54
  /**
42
- * Process a single skill/command/agent/workflow installation for removal
55
+ * The files the manifest says UDS wrote into one installation's folder.
56
+ * Skill records are keyed `<agent>/<level>/<skill>/<file>`; command records
57
+ * `<agent>/<file>` (they carry no level).
58
+ * @returns {Array<{ rel: string, hash: string }>} path inside the folder (forward slashes) and recorded hash
43
59
  */
44
- function processInstallation(install, type, projectPath, options, result) {
60
+ function recordedFiles(manifest, type, agent, level) {
61
+ const table = (type === 'skills' ? manifest?.skillHashes : manifest?.commandHashes) || {};
62
+ const prefix = type === 'skills' ? `${agent}/${level}/` : `${agent}/`;
63
+ return Object.entries(table)
64
+ .filter(([key]) => key.startsWith(prefix))
65
+ .map(([key, info]) => ({ rel: key.slice(prefix.length), hash: info && info.hash }));
66
+ }
67
+
68
+ /** Remove `dir` if nothing is left in it. Returns whether it is gone. */
69
+ function removeIfEmpty(dir) {
70
+ try {
71
+ if (readdirSync(dir).length > 0) return false;
72
+ rmdirSync(dir);
73
+ return true;
74
+ } catch {
75
+ return false;
76
+ }
77
+ }
78
+
79
+ /** Remove the folder that held `dir` when it is empty and strictly inside `projectPath`. */
80
+ function removeEmptyParentInside(dir, projectPath) {
81
+ const parent = dirname(dir);
82
+ const rel = relative(projectPath, parent);
83
+ if (rel === '' || rel.startsWith('..') || isAbsolute(rel)) return;
84
+ removeIfEmpty(parent);
85
+ }
86
+
87
+ /**
88
+ * Process a single skill/command installation for removal
89
+ */
90
+ function processInstallation(install, type, projectPath, manifest, options, result) {
45
91
  const { dryRun = false, includeUserLevel = false } = options;
46
92
  const { agent, level } = install;
47
93
 
48
94
  // Determine directory getter
49
- const getDirFn = type === 'skills' ? getSkillsDirForAgent :
50
- type === 'commands' ? getCommandsDirForAgent :
51
- type === 'agents' ? getAgentsDirForAgent :
52
- getWorkflowsDirForAgent;
95
+ const getDirFn = type === 'skills' ? getSkillsDirForAgent : getCommandsDirForAgent;
53
96
 
54
97
  const dir = getDirFn(agent, level || 'project', projectPath);
55
98
  if (!dir) {
@@ -71,14 +114,50 @@ function processInstallation(install, type, projectPath, options, result) {
71
114
  return;
72
115
  }
73
116
 
117
+ const records = recordedFiles(manifest, type, agent, level || 'project');
118
+ if (records.length === 0) {
119
+ result.skipped.push(`${label} — kept ${dir}: the manifest records no file UDS wrote there, so UDS cannot prove which are its own`);
120
+ return;
121
+ }
122
+
123
+ const toRemove = [];
124
+ const changed = [];
125
+ for (const { rel, hash } of records) {
126
+ const file = join(dir, ...rel.split('/'));
127
+ if (!existsSync(file)) continue;
128
+ const now = computeFileHash(file);
129
+ if (now && hash && now.hash === hash) toRemove.push(file);
130
+ else changed.push(rel);
131
+ }
132
+
74
133
  if (dryRun) {
75
- result.removed.push(`${label} → ${dir}`);
134
+ result.removed.push(`${label} → ${dir} (${toRemove.length} file(s) UDS wrote)`);
135
+ if (changed.length > 0) result.skipped.push(`${label} — would keep ${changed.length} file(s) changed since UDS wrote them`);
76
136
  return;
77
137
  }
78
138
 
79
139
  try {
80
- rmSync(dir, { recursive: true, force: true });
81
- result.removed.push(`${label} → ${dir}`);
140
+ const touched = new Set();
141
+ for (const file of toRemove) {
142
+ unlinkSync(file);
143
+ touched.add(dirname(file));
144
+ }
145
+ // UDS's own bookkeeping for the folder (written by the skills installer, never hashed): go with the last of its files.
146
+ if (changed.length === 0) {
147
+ const marker = join(dir, '.manifest.json');
148
+ if (existsSync(marker)) rmSync(marker, { force: true });
149
+ }
150
+ // Folders UDS emptied, deepest first, then the installation folder itself.
151
+ for (const d of [...touched].sort((a, b) => b.length - a.length)) {
152
+ if (d !== dir) removeIfEmpty(d);
153
+ }
154
+ const gone = removeIfEmpty(dir);
155
+ // XSPEC-475 R5(d): the tool's own folder (`.claude/`, `.codex/` ...) that held only what UDS wrote is empty now; an
156
+ // empty `.claude/` left in the project is a trace of UDS. Only an EMPTY folder inside the project, never the project
157
+ // root, and never a user-level folder.
158
+ if (gone && !isUserLevel) removeEmptyParentInside(dir, projectPath);
159
+ result.removed.push(`${label} → ${dir} (${toRemove.length} file(s) UDS wrote${gone ? '' : '; folder kept: it still holds files that are not UDS\'s'})`);
160
+ if (changed.length > 0) result.skipped.push(`${label} — kept ${changed.length} file(s) changed since UDS wrote them`);
82
161
  } catch (error) {
83
162
  result.errors.push(`${label} — ${error.message}`);
84
163
  }
@@ -1,14 +1,27 @@
1
- import { existsSync, rmSync } from 'fs';
1
+ import { existsSync, readdirSync, rmdirSync, unlinkSync } from 'fs';
2
2
  import { join } from 'path';
3
+ import { classifyStandardsFiles, computeFileHash } from '../utils/hasher.js';
3
4
 
4
5
  /**
5
- * Uninstall .standards/ directory
6
+ * Uninstall the files UDS wrote into .standards/
7
+ *
8
+ * `.standards/` is a folder the adopter may add files to (UDS's own docs invite
9
+ * teams to), so this removes only what UDS can PROVE it wrote and nobody has
10
+ * changed since: a file the manifest records (`fileHashes`, or `provenance`)
11
+ * whose content still matches its recorded hash. A file with no record, or edited
12
+ * since, is kept and said so. The manifest goes last, and the folder only when
13
+ * nothing else is in it. The same rule `uds uninstall` applies to skills, hook
14
+ * scripts and integration files.
15
+ *
16
+ * This used to `rmSync` the whole folder, which took the adopter's own files
17
+ * with it.
18
+ *
6
19
  * @param {string} projectPath - Project root path
7
- * @param {Object} options - { dryRun: boolean }
20
+ * @param {Object} options - { dryRun: boolean, manifest: Object } (the manifest says which files UDS wrote)
8
21
  * @returns {Object} { removed: string[], skipped: string[], errors: string[] }
9
22
  */
10
23
  export function uninstallStandards(projectPath, options = {}) {
11
- const { dryRun = false } = options;
24
+ const { dryRun = false, manifest = null } = options;
12
25
  const result = { removed: [], skipped: [], errors: [] };
13
26
  const standardsDir = join(projectPath, '.standards');
14
27
 
@@ -16,18 +29,54 @@ export function uninstallStandards(projectPath, options = {}) {
16
29
  result.skipped.push('.standards/ (not found)');
17
30
  return result;
18
31
  }
32
+ if (!manifest) {
33
+ result.skipped.push('.standards/ — kept: there is no manifest to say which files UDS wrote');
34
+ return result;
35
+ }
36
+
37
+ const census = classifyStandardsFiles(projectPath, manifest);
38
+ const toRemove = [];
39
+ const changed = [];
40
+ for (const rel of census.udsOwned) {
41
+ const record = manifest.fileHashes && manifest.fileHashes[rel];
42
+ const file = join(projectPath, ...rel.split('/'));
43
+ if (record && record.hash) {
44
+ const now = computeFileHash(file);
45
+ if (!now || now.hash !== record.hash) { changed.push(rel); continue; }
46
+ }
47
+ toRemove.push(file);
48
+ }
49
+ const notUds = [...census.foreign, ...census.unknown];
50
+ const kept = [...changed, ...notUds];
51
+ const manifestFile = join(standardsDir, 'manifest.json');
52
+ const count = toRemove.length + (existsSync(manifestFile) ? 1 : 0);
53
+
54
+ const describe = (wholeFolderGone) => `.standards/ (${count} file(s) UDS wrote${wholeFolderGone ? '' : '; folder kept: it still holds files that are not UDS\'s'})`;
55
+ const keptNote = `.standards/ — kept ${kept.length} file(s) UDS did not write or that changed since: ${kept.slice(0, 5).join(', ')}${kept.length > 5 ? ', ...' : ''}`;
19
56
 
20
57
  if (dryRun) {
21
- result.removed.push('.standards/');
58
+ result.removed.push(describe(kept.length === 0));
59
+ if (kept.length > 0) result.skipped.push(keptNote);
22
60
  return result;
23
61
  }
24
62
 
25
63
  try {
26
- rmSync(standardsDir, { recursive: true, force: true });
27
- result.removed.push('.standards/');
64
+ for (const file of toRemove) unlinkSync(file);
65
+ if (existsSync(manifestFile)) unlinkSync(manifestFile);
66
+ removeEmptyFolders(standardsDir);
67
+ result.removed.push(describe(!existsSync(standardsDir)));
68
+ if (kept.length > 0) result.skipped.push(keptNote);
28
69
  } catch (error) {
29
70
  result.errors.push(`.standards/ — ${error.message}`);
30
71
  }
31
72
 
32
73
  return result;
33
74
  }
75
+
76
+ /** Remove every folder under `dir` that is empty, deepest first, then `dir` itself if it ends up empty. */
77
+ function removeEmptyFolders(dir) {
78
+ for (const entry of readdirSync(dir, { withFileTypes: true })) {
79
+ if (entry.isDirectory()) removeEmptyFolders(join(dir, entry.name));
80
+ }
81
+ if (readdirSync(dir).length === 0) rmdirSync(dir);
82
+ }
@@ -10,6 +10,7 @@
10
10
  import { mkdirSync, writeFileSync, existsSync, readFileSync, readdirSync, statSync } from 'fs';
11
11
  import { dirname, join, basename } from 'path';
12
12
  import { fileURLToPath } from 'url';
13
+ import * as yaml from 'js-yaml';
13
14
  import {
14
15
  getAgentConfig,
15
16
  getAgentsDirForAgent,
@@ -83,28 +84,20 @@ export function getAgentContent(agentName) {
83
84
  * @returns {Object} Parsed frontmatter fields
84
85
  */
85
86
  export function parseAgentFrontmatter(content) {
86
- const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
87
+ const frontmatterMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
87
88
  if (!frontmatterMatch) {
88
89
  return {};
89
90
  }
90
91
 
91
- const frontmatter = {};
92
- const lines = frontmatterMatch[1].split('\n');
93
-
94
- for (const line of lines) {
95
- const match = line.match(/^(\w[\w-]*):\s*(.+)$/);
96
- if (match) {
97
- const [, key, value] = match;
98
- // Handle arrays (simple case)
99
- if (value.startsWith('[') && value.endsWith(']')) {
100
- frontmatter[key] = value.slice(1, -1).split(',').map(s => s.trim().replace(/"/g, ''));
101
- } else {
102
- frontmatter[key] = value.trim();
103
- }
104
- }
92
+ // The agent files are YAML: `description: |` is a block, `expertise:` is a list. A line-by-line `key: value`
93
+ // reader saw the description as the single character `|` and dropped every list, so `uds agent list` and
94
+ // `uds agent info` showed an empty description and no expertise, tools or skills.
95
+ try {
96
+ const parsed = yaml.load(frontmatterMatch[1]);
97
+ return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : {};
98
+ } catch {
99
+ return {};
105
100
  }
106
-
107
- return frontmatter;
108
101
  }
109
102
 
110
103
  /**
@@ -0,0 +1,144 @@
1
+ /**
2
+ * Printing for the "available upstream, not installed" findings (XSPEC-458 R2, R3, R5).
3
+ *
4
+ * Everything here reads `getAvailableStandards()` and prints; none of it changes a plan, a verdict,
5
+ * an exit code or a score. (The one exception is `resolveAddStandardRequest`, which sets a non-zero
6
+ * exit code for a bad `--add-standard` id — that is its whole job.)
7
+ *
8
+ * @module utils/available-standards-report
9
+ */
10
+
11
+ import chalk from 'chalk';
12
+ import { t } from '../i18n/messages.js';
13
+ import { getAvailableStandards, judgeAddStandard } from './available-standards.js';
14
+
15
+ const CATEGORY_ORDER = ['reference', 'skill'];
16
+
17
+ function fill(template, values) {
18
+ return Object.entries(values).reduce((text, [key, value]) => text.replaceAll(`{${key}}`, String(value)), template);
19
+ }
20
+
21
+ function breakdown(byCategory) {
22
+ return Object.entries(byCategory)
23
+ .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
24
+ .map(([category, count]) => `${category} ${count}`)
25
+ .join(', ');
26
+ }
27
+
28
+ /**
29
+ * `uds update --plan` / `--apply`: the section itself, or (apply) its count and the commands.
30
+ * Always printed — "none" is said out loud, because silence reads as "this step did not run".
31
+ *
32
+ * @param {Object} manifest - The manifest the plan was computed from (a standard chosen with
33
+ * --add-standard is already in it, so it is not listed as still available)
34
+ * @param {{phase: 'plan'|'apply'}} opts
35
+ */
36
+ export function printAvailableStandardsSection(manifest, { phase }) {
37
+ const msg = t().availableStandards;
38
+ const { offered, notOffered, notOfferedByCategory } = getAvailableStandards(manifest);
39
+
40
+ console.log();
41
+ if (offered.length === 0) {
42
+ console.log(chalk.gray(msg.none));
43
+ } else if (phase === 'apply') {
44
+ console.log(chalk.cyan(fill(msg.applySummary, { count: offered.length })));
45
+ console.log(chalk.gray(` ${msg.applyHint}`));
46
+ } else {
47
+ console.log(chalk.cyan(fill(msg.title, { count: offered.length })));
48
+ const categories = [...new Set([...CATEGORY_ORDER, ...offered.map(s => s.category)])];
49
+ for (const category of categories) {
50
+ const group = offered.filter(s => s.category === category);
51
+ if (group.length === 0) continue;
52
+ console.log(chalk.bold(` ${fill(msg.categoryLine, { category, count: group.length })}`));
53
+ for (const std of group) {
54
+ console.log(` ${chalk.green(std.id)} ${chalk.gray(`— ${std.description}`)}`);
55
+ }
56
+ }
57
+ console.log(chalk.gray(` ${msg.installHint}`));
58
+ }
59
+
60
+ if (notOffered.length > 0) {
61
+ console.log(chalk.gray(fill(msg.othersLine, { count: notOffered.length, breakdown: breakdown(notOfferedByCategory) })));
62
+ }
63
+ }
64
+
65
+ /** `uds check`: one line, never part of the verdict. */
66
+ export function printAvailableStandardsCheckLine(manifest) {
67
+ const msg = t().availableStandards;
68
+ const { offered } = getAvailableStandards(manifest);
69
+ if (offered.length === 0) {
70
+ console.log(chalk.gray(msg.checkNone));
71
+ } else {
72
+ console.log(chalk.cyan(fill(msg.checkLine, { count: offered.length })));
73
+ }
74
+ }
75
+
76
+ /**
77
+ * `--add-standard` belongs to the reconciliation (`--plan` / `--apply`). Any other mode would take the
78
+ * flag and quietly not use it, so those combinations are refused, in words.
79
+ *
80
+ * @param {Object} options - Parsed `uds update` options
81
+ * @returns {string|null} The message to print, or null when the flags are compatible
82
+ */
83
+ export function findAddStandardConflict(options) {
84
+ const msg = t().availableStandards;
85
+ if (!options.plan && !options.apply && !options.force) return msg.addNeedsMode;
86
+ const clashes = [
87
+ ['rollback', '--rollback'], ['claudeTarget', '--claude-target'], ['withHooks', '--with-hooks'],
88
+ ['syncRefs', '--sync-refs'], ['integrationsOnly', '--integrations-only']
89
+ ];
90
+ for (const [key, flag] of clashes) {
91
+ if (options[key]) return fill(msg.addCannotCombine, { flag });
92
+ }
93
+ if (options.plan && options.skills) return fill(msg.addCannotCombine, { flag: '--plan --skills' });
94
+ if (options.plan && options.commands) return fill(msg.addCannotCombine, { flag: '--plan --commands' });
95
+ return null;
96
+ }
97
+
98
+ /**
99
+ * Judge every `--add-standard <id>`, say what is wrong with the ones that are, and return what is
100
+ * left to install. A bad id is never ignored: it prints the problem, sets a non-zero exit code and
101
+ * stops the run (`proceed: false`) before anything is planned or written.
102
+ *
103
+ * @param {Object} manifest
104
+ * @param {string[]} ids
105
+ * @returns {{proceed: boolean, ids: string[], alreadyInstalled: string[]}}
106
+ */
107
+ export function resolveAddStandardRequest(manifest, ids) {
108
+ const msg = t().availableStandards;
109
+ const toAdd = [];
110
+ const alreadyInstalled = [];
111
+ let failed = false;
112
+
113
+ for (const id of [...new Set(ids)]) {
114
+ const judged = judgeAddStandard(id, manifest);
115
+ switch (judged.status) {
116
+ case 'add':
117
+ toAdd.push(id);
118
+ break;
119
+ case 'installed':
120
+ alreadyInstalled.push(id);
121
+ console.log(chalk.gray(fill(msg.addAlreadyInstalled, { id })));
122
+ break;
123
+ case 'unknown':
124
+ failed = true;
125
+ console.log(chalk.red(fill(msg.addUnknown, { id })));
126
+ for (const near of judged.closest) console.log(chalk.gray(` ${near}`));
127
+ break;
128
+ case 'other-means':
129
+ failed = true;
130
+ console.log(chalk.red(fill(msg.addOtherMeans, { id, category: judged.entry.category })));
131
+ break;
132
+ default:
133
+ failed = true;
134
+ console.log(chalk.red(fill(msg.addNoSource, { id, format: manifest.format || 'ai' })));
135
+ }
136
+ }
137
+
138
+ if (failed) {
139
+ process.exitCode = 1;
140
+ console.log();
141
+ return { proceed: false, ids: [], alreadyInstalled };
142
+ }
143
+ return { proceed: true, ids: toAdd, alreadyInstalled };
144
+ }
@@ -0,0 +1,216 @@
1
+ /**
2
+ * Available-but-not-installed standards (XSPEC-458 R1).
3
+ *
4
+ * ONE definition, used by three commands. `uds update` (the old path's "new standards" list,
5
+ * `--plan`/`--apply`'s "available upstream" section, `--add-standard`), `uds check`'s one-line
6
+ * count and `uds audit --friction` all ask this module and nothing else. Before this existed the
7
+ * old path had its own copy inside update.js and the reconciler path had none: `--apply` printed
8
+ * a green "everything is up to date" for a project that was missing a standard UDS ships.
9
+ *
10
+ * What counts as "available but not installed"
11
+ * --------------------------------------------
12
+ * A registry standard that
13
+ * 1. is in a category `uds init` installs (reference, skill — see OFFERED_CATEGORIES),
14
+ * 2. has a source file in the project's `manifest.format` (a skill-only entry has none), and
15
+ * 3. is not already in `manifest.standards` (matched by file name, so an ID-format entry
16
+ * and a path-format entry such as `ai/standards/x.ai.yaml` both count as installed).
17
+ * That is exactly the set the old `checkNewStandards()` computed; it now calls this.
18
+ *
19
+ * What does NOT count, and is reported instead of being dropped (`notOffered`)
20
+ * ----------------------------------------------------------------------------
21
+ * Every other registry category (core, testing, security, deployment, operations, extension,
22
+ * integration, template). `uds init` has never installed them, so for a project they are not
23
+ * "new upstream" — they were never in the offer. Why, per category, is in CATEGORY_NOTES.
24
+ * They are still returned (with a reason) so no command can silently pretend they do not exist.
25
+ *
26
+ * Manifest fields that look like they should matter, and do not (measured 2026-10-07):
27
+ * - `level` — a manifest written by 6.11.0 carries it only as a leftover snapshot inside
28
+ * `integrationConfigs[<file>].level`; no code reads it to decide what to install, the generator
29
+ * never reads `config.level`, and the registry's level system is a deprecated stub (registry.js).
30
+ * DEAD.
31
+ * - `profile` — appears nowhere in the CLI or in any manifest. DEAD (it does not exist).
32
+ * - `contentMode` — LIVE, but only for how the integration file (CLAUDE.md) is rendered
33
+ * (minimal vs index). It never decides which standards are installed.
34
+ * None of the three enters this computation, on purpose.
35
+ *
36
+ * @module utils/available-standards
37
+ */
38
+
39
+ import { basename } from 'path';
40
+ import { getAllStandards, getStandardSource } from './registry.js';
41
+
42
+ /** Categories `uds init` installs into `.standards/`. Must match installers/standards-installer.js. */
43
+ export const OFFERED_CATEGORIES = Object.freeze(['reference', 'skill']);
44
+
45
+ /**
46
+ * Categories whose registry entry is not a plain standard file under `.standards/`: they are
47
+ * installed by other means (a language/locale option, a per-tool integration file, a template
48
+ * copy), so `--add-standard` does not install them.
49
+ */
50
+ export const INSTALLED_BY_OTHER_MEANS = Object.freeze(['extension', 'integration', 'template']);
51
+
52
+ /**
53
+ * Why each category outside OFFERED_CATEGORIES is not offered. Written down so the exclusion is a
54
+ * visible decision, not a filter nobody can explain. (Rendered in docs/user/CLI-REFERENCE and the
55
+ * R1 section of the update guide; keep in step with them.)
56
+ */
57
+ export const CATEGORY_NOTES = Object.freeze({
58
+ core: 'added to the registry after the installer\'s reference/skill filter was written; never installed by init',
59
+ testing: 'same as core: added later, never installed by init',
60
+ security: 'same as core: added later, never installed by init',
61
+ deployment: 'same as core: added later, never installed by init',
62
+ operations: 'same as core: added later, never installed by init',
63
+ extension: 'installed by a language/framework/locale choice at init, not as a standard',
64
+ integration: 'a per-tool integration file, installed through the AI-tool choice at init',
65
+ template: 'a document template to copy, not a standard file'
66
+ });
67
+
68
+ /**
69
+ * File names (basenames) of the standards a manifest already lists.
70
+ * Handles both legacy path entries ("ai/standards/foo.ai.yaml") and ID entries ("foo").
71
+ * Option paths are skipped: they live under `.standards/options/` and are not standards.
72
+ *
73
+ * @param {Object} manifest
74
+ * @param {Array} [registryStandards]
75
+ * @returns {Set<string>}
76
+ */
77
+ export function installedStandardFileNames(manifest, registryStandards = getAllStandards()) {
78
+ const format = manifest.format || 'ai';
79
+ const names = new Set();
80
+ for (const s of (manifest.standards || [])) {
81
+ if (typeof s !== 'string') continue;
82
+ if (s.includes('/options/') || s.startsWith('options/')) continue;
83
+ if (!s.includes('/') && !s.includes('.')) {
84
+ const entry = registryStandards.find(r => r.id === s);
85
+ if (entry) {
86
+ const sourcePath = getStandardSource(entry, format);
87
+ if (sourcePath) names.add(basename(sourcePath));
88
+ }
89
+ } else {
90
+ names.add(basename(s));
91
+ }
92
+ }
93
+ return names;
94
+ }
95
+
96
+ /**
97
+ * One line of description: the first sentence, cut to `max` characters.
98
+ * @param {string} description
99
+ * @param {number} [max]
100
+ * @returns {string}
101
+ */
102
+ export function oneLineDescription(description, max = 100) {
103
+ const text = String(description || '').replace(/\s+/g, ' ').trim();
104
+ const firstSentence = text.split(/(?<=[.。])\s/)[0] || text;
105
+ const cut = firstSentence.length > max ? `${firstSentence.slice(0, max - 1).trimEnd()}…` : firstSentence;
106
+ return cut;
107
+ }
108
+
109
+ /**
110
+ * @typedef {Object} AvailableStandard
111
+ * @property {string} id
112
+ * @property {string} category
113
+ * @property {string} description One line.
114
+ * @property {string} source Registry source path in the project's format (what the manifest records).
115
+ * @property {string} name File name under `.standards/`.
116
+ */
117
+
118
+ /**
119
+ * The single definition of "available but not installed".
120
+ *
121
+ * @param {Object} manifest
122
+ * @returns {{
123
+ * offered: AvailableStandard[],
124
+ * notOffered: Array<AvailableStandard & {reason: string, addable: boolean}>,
125
+ * notOfferedByCategory: Object<string, number>
126
+ * }}
127
+ */
128
+ export function getAvailableStandards(manifest) {
129
+ const format = manifest.format || 'ai';
130
+ const registryStandards = getAllStandards();
131
+ const installed = installedStandardFileNames(manifest, registryStandards);
132
+
133
+ const offered = [];
134
+ const notOffered = [];
135
+ for (const std of registryStandards) {
136
+ const source = getStandardSource(std, format);
137
+ if (!source) continue; // skill-only entry: no file to install
138
+ const name = basename(source);
139
+ if (installed.has(name)) continue;
140
+
141
+ const item = { id: std.id, category: std.category, description: oneLineDescription(std.description), source, name };
142
+ if (OFFERED_CATEGORIES.includes(std.category)) {
143
+ offered.push(item);
144
+ } else {
145
+ notOffered.push({
146
+ ...item,
147
+ reason: CATEGORY_NOTES[std.category] || 'category not installed by init',
148
+ addable: !INSTALLED_BY_OTHER_MEANS.includes(std.category)
149
+ });
150
+ }
151
+ }
152
+
153
+ const notOfferedByCategory = {};
154
+ for (const n of notOffered) notOfferedByCategory[n.category] = (notOfferedByCategory[n.category] || 0) + 1;
155
+ return { offered, notOffered, notOfferedByCategory };
156
+ }
157
+
158
+ /** Plain edit distance, enough for "did you mean". */
159
+ function editDistance(a, b) {
160
+ const prev = Array.from({ length: b.length + 1 }, (_, j) => j);
161
+ for (let i = 1; i <= a.length; i++) {
162
+ let diagonal = prev[0];
163
+ prev[0] = i;
164
+ for (let j = 1; j <= b.length; j++) {
165
+ const above = prev[j];
166
+ prev[j] = a[i - 1] === b[j - 1] ? diagonal : 1 + Math.min(diagonal, above, prev[j - 1]);
167
+ diagonal = above;
168
+ }
169
+ }
170
+ return prev[b.length];
171
+ }
172
+
173
+ /**
174
+ * The registry ids nearest to `id` (substring matches first, then by edit distance).
175
+ * @param {string} id
176
+ * @param {number} [limit]
177
+ * @returns {string[]}
178
+ */
179
+ export function closestStandardIds(id, limit = 5) {
180
+ const needle = String(id || '').toLowerCase();
181
+ const scored = getAllStandards().map(s => {
182
+ const candidate = s.id.toLowerCase();
183
+ const contains = needle.length >= 3 && (candidate.includes(needle) || needle.includes(candidate));
184
+ return { id: s.id, score: (contains ? 0 : 1000) + editDistance(needle, candidate) };
185
+ });
186
+ scored.sort((x, y) => x.score - y.score || x.id.localeCompare(y.id));
187
+ return scored.slice(0, limit).map(s => s.id);
188
+ }
189
+
190
+ /**
191
+ * Judge one `--add-standard <id>` request against a manifest.
192
+ *
193
+ * status:
194
+ * 'add' installable now; `source` is what goes into manifest.standards
195
+ * 'installed' already in manifest.standards (not an error)
196
+ * 'unknown' not a registry id; `closest` lists the nearest ids
197
+ * 'other-means' a registry id, but installed through language/integration/template choices
198
+ * 'no-source' a registry id with no file in the project's format
199
+ *
200
+ * @param {string} id
201
+ * @param {Object} manifest
202
+ * @returns {{status: string, id: string, entry?: Object, source?: string, closest?: string[]}}
203
+ */
204
+ export function judgeAddStandard(id, manifest) {
205
+ const format = manifest.format || 'ai';
206
+ const registryStandards = getAllStandards();
207
+ const entry = registryStandards.find(s => s.id === id);
208
+ if (!entry) return { status: 'unknown', id, closest: closestStandardIds(id) };
209
+ if (INSTALLED_BY_OTHER_MEANS.includes(entry.category)) return { status: 'other-means', id, entry };
210
+ const source = getStandardSource(entry, format);
211
+ if (!source) return { status: 'no-source', id, entry };
212
+ if (installedStandardFileNames(manifest, registryStandards).has(basename(source))) {
213
+ return { status: 'installed', id, entry, source };
214
+ }
215
+ return { status: 'add', id, entry, source };
216
+ }