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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (712) hide show
  1. package/bin/uds.js +12 -1
  2. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  3. package/bundled/ai/standards/commit-message.ai.yaml +12 -2
  4. package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
  5. package/bundled/core/commit-message-guide.md +22 -19
  6. package/bundled/core/secret-management-standards.md +13 -1
  7. package/bundled/extensions/locales/zh-tw.md +19 -19
  8. package/bundled/hooks/validate-commit-msg.mjs +52 -9
  9. package/bundled/locales/zh-CN/CHANGELOG.md +2312 -1102
  10. package/bundled/locales/zh-CN/CLAUDE.md +987 -101
  11. package/bundled/locales/zh-CN/README.md +3 -3
  12. package/bundled/locales/zh-CN/SECURITY.md +3 -3
  13. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  14. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
  15. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  16. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
  17. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
  18. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
  19. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
  20. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  21. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  22. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  23. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  24. package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
  25. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  26. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  27. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  28. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  29. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  30. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
  31. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  32. package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
  33. package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
  34. package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
  35. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  36. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  37. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  38. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  39. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  40. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  41. package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
  42. package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
  43. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  44. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  45. package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
  46. package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
  47. package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
  48. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  49. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  50. package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
  51. package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
  52. package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
  53. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  54. package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
  55. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
  56. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  57. package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
  58. package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
  59. package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
  60. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  61. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  62. package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
  63. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
  64. package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
  65. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  66. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  67. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  68. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  69. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  70. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  71. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  72. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  73. package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
  74. package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
  75. package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
  78. package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
  79. package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
  80. package/bundled/locales/zh-CN/core/project-structure.md +550 -170
  81. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  82. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  83. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  84. package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
  87. package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
  88. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  89. package/bundled/locales/zh-CN/core/security-standards.md +169 -16
  90. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  91. package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
  92. package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
  93. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  94. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  95. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  96. package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
  97. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  98. package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
  99. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  100. package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
  101. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  102. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  103. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  104. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  105. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  106. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  107. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  108. package/bundled/locales/zh-CN/core/versioning.md +737 -73
  109. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  110. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  111. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  112. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
  113. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  114. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
  115. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
  116. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  117. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
  118. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  119. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
  120. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  121. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  122. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
  123. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  124. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  125. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  126. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  127. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  128. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  129. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  130. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  133. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  135. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  136. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  137. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  138. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  139. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  140. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  141. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  142. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  143. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  144. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  145. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  146. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  147. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  148. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  149. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  150. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  151. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  152. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  153. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  154. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  155. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  156. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  157. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  158. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  159. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  160. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  161. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  162. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  163. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  164. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  165. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  166. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  167. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  168. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  171. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  172. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  173. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  174. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  175. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  176. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  177. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  178. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  179. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  180. package/bundled/locales/zh-CN/skills/README.md +2 -1
  181. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  182. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  183. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  184. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  185. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  186. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  187. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  188. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  189. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  190. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  191. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  192. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  193. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
  194. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  195. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  196. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  197. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  198. package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
  199. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  200. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  201. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  202. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  203. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
  204. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  205. package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
  206. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  207. package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
  208. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  209. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  210. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  211. package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
  212. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  213. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  215. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  216. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  217. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  218. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  219. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  220. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  221. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  222. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  223. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  224. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  225. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  226. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  227. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  228. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  229. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  230. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  231. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  232. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  233. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  234. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  235. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  236. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  237. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  238. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  239. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  240. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  241. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  242. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  244. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  245. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  246. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  247. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  248. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  249. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  250. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  251. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  252. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  253. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  254. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  255. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  256. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  257. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  258. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  259. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  260. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  261. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
  262. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  263. package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
  264. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  265. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
  266. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  267. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  268. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
  269. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  270. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  271. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  272. package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
  273. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  274. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  275. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  276. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  277. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  278. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  279. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  280. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  281. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  282. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  283. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  284. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  285. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  286. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  287. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
  288. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  289. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  290. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  291. package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
  292. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  293. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  294. package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
  295. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  296. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  297. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  298. package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
  299. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  300. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  301. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  302. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
  303. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  304. package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
  305. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  306. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  307. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  308. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  309. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  310. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  311. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
  312. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  313. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  314. package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
  315. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  316. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  317. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  318. package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
  319. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  320. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  321. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  322. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  323. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  324. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  325. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  326. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  327. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  328. package/bundled/locales/zh-TW/CHANGELOG.md +2291 -1110
  329. package/bundled/locales/zh-TW/CLAUDE.md +962 -76
  330. package/bundled/locales/zh-TW/README.md +3 -3
  331. package/bundled/locales/zh-TW/SECURITY.md +3 -3
  332. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  333. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
  334. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  335. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
  336. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
  337. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
  338. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
  339. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  340. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  341. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  342. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  343. package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
  344. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  345. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  346. package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
  347. package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
  348. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  349. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
  350. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  351. package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
  352. package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
  353. package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
  354. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  355. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  356. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  357. package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
  358. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  359. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  360. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  361. package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
  362. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  363. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  364. package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
  365. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  366. package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
  367. package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
  368. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  369. package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
  370. package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
  371. package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
  372. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  373. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  374. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  375. package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
  376. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  377. package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
  378. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  379. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  380. package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
  381. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
  382. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  383. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  384. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  385. package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
  386. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  387. package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
  388. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  389. package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
  390. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  391. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  392. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  393. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  394. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  395. package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
  396. package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
  397. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  398. package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
  399. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  400. package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
  401. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  402. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  403. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  404. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  405. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  406. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  407. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  408. package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
  409. package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
  410. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  411. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  412. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  413. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  414. package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
  415. package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
  416. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  417. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  418. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  419. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  420. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  421. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  422. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  423. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  424. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  425. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  426. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  427. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  428. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  429. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  430. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  431. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  432. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  433. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  434. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  435. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
  436. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  437. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
  438. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  439. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
  440. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  441. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
  442. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  443. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
  444. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  445. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  446. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
  447. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  448. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  449. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  450. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  451. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  452. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  453. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  454. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  455. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  456. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  457. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  458. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  459. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  460. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  461. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  462. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  463. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  464. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  465. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  466. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  467. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  468. package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
  469. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  470. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  471. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  472. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  473. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  474. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  475. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  476. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  477. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  478. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  479. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  480. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  481. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  482. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  483. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  484. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  485. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  486. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  487. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  488. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  489. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  490. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  491. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  492. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  493. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  494. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  495. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  496. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  497. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  498. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  499. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  500. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  501. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  502. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  503. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  504. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  505. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  506. package/bundled/locales/zh-TW/skills/README.md +2 -1
  507. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  508. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  509. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  510. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  511. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  512. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  513. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  514. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  515. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  516. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  517. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  518. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  519. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  520. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  521. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  522. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  523. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  524. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  525. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  526. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  527. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  528. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  529. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  530. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  531. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  532. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  533. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  534. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  535. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  536. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  537. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  538. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  539. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  541. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  542. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  543. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  544. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  545. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  546. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  547. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  548. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  549. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  550. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  551. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  552. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  553. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  554. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  555. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  556. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  557. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  558. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  559. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  560. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  561. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  562. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  563. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  564. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  565. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  566. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  567. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  568. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  569. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  570. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  571. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  572. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  573. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  574. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  575. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  576. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  577. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  578. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  579. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  580. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  581. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  582. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  583. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  584. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  585. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  586. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  587. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  588. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  589. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  590. package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
  591. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  592. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
  593. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  594. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  595. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  596. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  597. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  598. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  599. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  600. package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
  601. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  602. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  603. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  604. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  605. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  606. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  607. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  608. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  609. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  610. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  611. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  612. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  613. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  614. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
  615. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  616. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  617. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  618. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  619. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  620. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  621. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  622. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  623. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
  624. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  625. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  626. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  627. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  628. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  629. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  630. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  631. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  632. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  633. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  634. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  635. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  636. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  637. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  638. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  639. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  640. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  641. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  642. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  643. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  644. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  645. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  646. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  647. package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
  648. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  649. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  650. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  651. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  652. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  653. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  654. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  655. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  656. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  657. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  658. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  659. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  660. package/bundled/skills/.claude-plugin/plugin.json +71 -0
  661. package/bundled/skills/commit-standards/SKILL.md +2 -2
  662. package/bundled/skills/commit-standards/guide.md +3 -2
  663. package/bundled/skills/commit-standards/language-options.md +19 -17
  664. package/package.json +2 -2
  665. package/src/commands/audit.js +28 -1
  666. package/src/commands/check.js +77 -7
  667. package/src/commands/compile.js +37 -4
  668. package/src/commands/config.js +49 -24
  669. package/src/commands/init.js +78 -30
  670. package/src/commands/open-work.js +6 -2
  671. package/src/commands/release-messages.js +228 -0
  672. package/src/commands/release.js +127 -68
  673. package/src/commands/run-intent.js +11 -0
  674. package/src/commands/spec-split.js +2 -1
  675. package/src/commands/spec.js +11 -2
  676. package/src/commands/update.js +184 -30
  677. package/src/compilers/claude-code-compiler.js +9 -1
  678. package/src/config/ai-agent-paths.js +14 -1
  679. package/src/core/installed-formats.js +15 -0
  680. package/src/core/open-work-config.js +20 -1
  681. package/src/core/project-config.js +55 -0
  682. package/src/i18n/messages.js +160 -2
  683. package/src/installers/hooks-installer.js +1 -1
  684. package/src/installers/manifest-installer.js +1 -1
  685. package/src/installers/skills-installer.js +1 -1
  686. package/src/installers/standards-installer.js +3 -1
  687. package/src/mcp/server.js +9 -3
  688. package/src/prompts/init.js +26 -22
  689. package/src/reconciler/actual-state-scanner.js +2 -8
  690. package/src/reconciler/backup-locations.js +5 -0
  691. package/src/reconciler/backup-manager.js +19 -11
  692. package/src/reconciler/desired-state-calculator.js +89 -57
  693. package/src/reconciler/plan-executor.js +101 -8
  694. package/src/reconciler/recorded-versions.js +49 -0
  695. package/src/reconciler/relative-path.js +23 -0
  696. package/src/uninstallers/hook-uninstaller.js +9 -1
  697. package/src/uninstallers/skills-uninstaller.js +22 -3
  698. package/src/utils/available-standards-report.js +25 -4
  699. package/src/utils/available-standards.js +13 -3
  700. package/src/utils/build-manifest.js +1 -1
  701. package/src/utils/commit-message-judge.js +60 -13
  702. package/src/utils/friction-detector.js +23 -11
  703. package/src/utils/git-hooks.js +106 -4
  704. package/src/utils/integration-generator.js +95 -67
  705. package/src/utils/legacy-hook-migration.js +121 -2
  706. package/src/utils/open-work-tracking.mjs +105 -16
  707. package/src/utils/sdd-header.js +16 -4
  708. package/src/utils/skills-installer.js +2 -1
  709. package/src/utils/spinner.js +14 -4
  710. package/src/utils/standard-validator.js +3 -2
  711. package/standards-registry.json +10 -8
  712. package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
@@ -52,6 +52,7 @@ import {
52
52
  getAgentDisplayName,
53
53
  getAgentConfig,
54
54
  getSkillsDirForAgent,
55
+ hasSkillsLevel,
55
56
  getCommandsDirForAgent
56
57
  } from '../config/ai-agent-paths.js';
57
58
  import { getMarketplaceSkillsInfo } from '../utils/github.js';
@@ -60,7 +61,7 @@ import { detectAITools } from '../utils/detector.js';
60
61
  import { HOOK_CAPABLE_TOOLS, resolveHookTools, installMissingHooks } from '../installers/hooks-installer.js';
61
62
  import { persistRecorder, mergeRecorderInto, newRecorder } from '../core/install-records.js';
62
63
  import { installGateScripts, gateStandardInstalled, GATE_SCRIPTS } from '../utils/gate-scripts.js';
63
- import { migrateLegacyHuskyHook } from '../utils/legacy-hook-migration.js';
64
+ import { migrateLegacyHuskyHook, migrateHuskyBlockWithoutCi, migrateOlderNativeHook } from '../utils/legacy-hook-migration.js';
64
65
  import {
65
66
  promptSkillsInstallLocation,
66
67
  promptCommandsInstallation
@@ -76,6 +77,7 @@ import {
76
77
  cleanupBackups
77
78
  } from '../reconciler/index.js';
78
79
  import { stepWritePaths } from '../reconciler/install-roots.js';
80
+ import { alignRecordedVersions, alignUpstreamVersion } from '../reconciler/recorded-versions.js';
79
81
  import { restoreSingleFile } from './check.js';
80
82
  import { guardAgainstSelfAdoption } from '../utils/detect-self-adoption.js';
81
83
  import { resolveIntegrationFile, SUPPORTED_AI_TOOLS, getToolFormat } from '../core/constants.js';
@@ -513,6 +515,11 @@ export async function updateCommand(options) {
513
515
  migrateLegacyPreCommitHook(projectPath, manifest, { plan: !!options.plan });
514
516
  }
515
517
 
518
+ if (options.from && !options.rollback) {
519
+ console.log(chalk.yellow(' ! --from names the backup for --rollback; without --rollback it does nothing and is ignored.'));
520
+ console.log();
521
+ }
522
+
516
523
  // Handle --rollback option (DSR). It restores a whole backup, so a scope
517
524
  // flag cannot narrow it — say so rather than appearing to honour it.
518
525
  if (options.rollback) {
@@ -520,7 +527,7 @@ export async function updateCommand(options) {
520
527
  console.log(chalk.yellow(' ! --rollback restores a complete backup; --skills/--commands cannot narrow it and are ignored.'));
521
528
  console.log();
522
529
  }
523
- await handleRollback(projectPath);
530
+ await handleRollback(projectPath, options);
524
531
  return;
525
532
  }
526
533
 
@@ -1707,29 +1714,30 @@ async function offerErrorExitGate(projectPath, options) {
1707
1714
  const src = join(getRepoRoot(), 'templates', 'gates', 'check-error-exit.mjs');
1708
1715
  if (!existsSync(src)) return; // 範本沒出貨——沉默,不要假裝提供了
1709
1716
 
1710
- console.log(chalk.bold(' 錯誤訊息單一出口閘門'));
1711
- console.log(chalk.gray(' 防的是:每個呼叫端各自把錯誤回應拼成給人看的字串。'));
1712
- console.log(chalk.gray(' 第一處是實作,第二處開始就會各寫各的,而畫面上只剩一句 Bad Request。'));
1713
- console.log(chalk.gray(` 要寫入:scripts/check-error-exit.mjs(純 Node、零相依、${Math.round(readFileSync(src, 'utf-8').length / 1024)}KB)`));
1714
- console.log(chalk.gray(' 寫入後它會 exit 2 直到你填好 CONFIG——那是刻意的,'));
1715
- console.log(chalk.gray(' 一支在新 repo 裡靜靜回綠的閘門跟一支沒裝的無從分辨。'));
1717
+ const m = t().commands.update.errorExitOffer;
1718
+ console.log(chalk.bold(m.title));
1719
+ console.log(chalk.gray(m.guards));
1720
+ console.log(chalk.gray(m.drift));
1721
+ console.log(chalk.gray(m.willWrite.replace('{kb}', String(Math.round(readFileSync(src, 'utf-8').length / 1024)))));
1722
+ console.log(chalk.gray(m.exit2a));
1723
+ console.log(chalk.gray(m.exit2b));
1716
1724
  console.log();
1717
1725
 
1718
1726
  const ok = await confirmOrFail({
1719
- message: '要把這道閘門寫進 scripts/check-error-exit.mjs 嗎?',
1727
+ message: m.question,
1720
1728
  defaultValue: false, // 🔴 預設不寫。沉默不是同意。
1721
1729
  options
1722
1730
  });
1723
1731
  if (!ok) {
1724
- console.log(chalk.gray(' 跳過。`uds check` 之後會再提醒,但不會自己寫進去。'));
1732
+ console.log(chalk.gray(m.skipped));
1725
1733
  console.log();
1726
1734
  return;
1727
1735
  }
1728
1736
 
1729
1737
  mkdirSync(dirname(dest), { recursive: true });
1730
1738
  writeFileSync(dest, readFileSync(src, 'utf-8'), 'utf-8');
1731
- console.log(chalk.green(' ✓ 已寫入 scripts/check-error-exit.mjs'));
1732
- console.log(chalk.gray(' 下一步:填好檔頭的 CONFIG,然後把它接進你的 CI 或 pre-commit。'));
1739
+ console.log(chalk.green(m.written));
1740
+ console.log(chalk.gray(m.next));
1733
1741
  console.log();
1734
1742
  }
1735
1743
 
@@ -1939,7 +1947,6 @@ export function migrateLegacyPreCommitHook(projectPath, manifest, { plan = false
1939
1947
  if (r.state === 'error') {
1940
1948
  console.log(chalk.yellow(` ${msg.hookMigrateFailed.replace('{error}', r.error)}`));
1941
1949
  console.log();
1942
- return r;
1943
1950
  }
1944
1951
  if (r.state === 'migrated') console.log(chalk.green(` ${msg.hookMigrated}`));
1945
1952
  if (r.state === 'would-migrate') console.log(chalk.cyan(` ${msg.hookWouldMigrate}`));
@@ -1953,6 +1960,30 @@ export function migrateLegacyPreCommitHook(projectPath, manifest, { plan = false
1953
1960
  // this the record persisted just above would be overwritten by the older copy.
1954
1961
  Object.assign(manifest, mergeRecorderInto(manifest, r.recorder));
1955
1962
  }
1963
+
1964
+ // XSPEC-482 R3 + R5: hooks that run the check and cannot stop a commit - the husky block that runs `check`
1965
+ // without `--ci`, and the native hook of 5.x .. 6.13.1 / the betas. Same treatment as above: only a text UDS
1966
+ // provably wrote is replaced, anything else is named and left alone, and --plan lists it.
1967
+ const huskyCi = migrateHuskyBlockWithoutCi(projectPath, { plan, manifest });
1968
+ if (huskyCi.state === 'error') console.log(chalk.yellow(` ${msg.hookMigrateFailed.replace('{error}', huskyCi.error)}`));
1969
+ if (huskyCi.state === 'migrated') console.log(chalk.green(` ${msg.hookHuskyCiMigrated}`)); // wire:update-migrates-husky-ci
1970
+ if (huskyCi.state === 'would-migrate') console.log(chalk.cyan(` ${msg.hookHuskyCiWouldMigrate}`));
1971
+
1972
+ const native = migrateOlderNativeHook(projectPath, { plan }); // wire:update-migrates-native-hook
1973
+ const nativeFrom = native.from === 'legacy-6.11' ? msg.hookNativeFromLegacy : msg.hookNativeFromWithoutCi;
1974
+ if (native.state === 'error') console.log(chalk.yellow(` ${msg.hookNativeFailed.replace('{error}', native.error)}`));
1975
+ if (native.state === 'migrated') console.log(chalk.green(` ${msg.hookNativeMigrated.replace('{from}', nativeFrom)}`));
1976
+ if (native.state === 'would-migrate') console.log(chalk.cyan(` ${msg.hookNativeWouldMigrate.replace('{from}', nativeFrom)}`));
1977
+ for (const k of native.kept) {
1978
+ console.log(chalk.yellow(` ${msg.hookNativeKept.replace('{line}', k.line).replace('{text}', k.text)}`));
1979
+ }
1980
+ if (huskyCi.state !== 'none' || native.state !== 'none') console.log();
1981
+ for (const extra of [huskyCi.recorder, native.recorder]) {
1982
+ if (extra) {
1983
+ persistRecorder(projectPath, extra);
1984
+ Object.assign(manifest, mergeRecorderInto(manifest, extra));
1985
+ }
1986
+ }
1956
1987
  return r;
1957
1988
  }
1958
1989
 
@@ -2723,13 +2754,21 @@ async function planSkills(projectPath, manifest, options) {
2723
2754
  return;
2724
2755
  }
2725
2756
 
2757
+ // XSPEC-482 R7: "unchanged" needs the files to agree too, as `uds update --plan` judges them - a recorded version
2758
+ // equal to the shipped one says nothing about a skill file that was deleted or edited.
2759
+ const skillActions = await skillActionsOf(projectPath);
2760
+
2726
2761
  let changed = 0;
2727
2762
  for (const inst of installations) {
2728
2763
  const info = getInstalledSkillsInfoForAgent(inst.agent, inst.level, projectPath);
2729
2764
  const current = info?.version || 'unknown';
2730
- const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath);
2731
- if (current === latestVersion) {
2765
+ const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath) ?? '(no such folder)'; // XSPEC-486: null when the tool has no folder at that level
2766
+ const differing = skillActions.filter((a) => a.details?.metadata?.agent === inst.agent && (a.details?.metadata?.level || 'project') === inst.level);
2767
+ if (current === latestVersion && differing.length === 0) {
2732
2768
  console.log(chalk.gray(` = ${getAgentDisplayName(inst.agent)} (${inst.level}): v${current} — unchanged`));
2769
+ } else if (current === latestVersion) {
2770
+ changed++;
2771
+ console.log(chalk.yellow(` ~ ${getAgentDisplayName(inst.agent)} (${inst.level}): v${current} — ${differing.length} skill file(s) differ from what this UDS ships ${dir}`));
2733
2772
  } else {
2734
2773
  changed++;
2735
2774
  console.log(chalk.yellow(` ~ ${getAgentDisplayName(inst.agent)} (${inst.level}): v${current} → v${latestVersion} ${dir}`));
@@ -2758,21 +2797,44 @@ async function planCommands(projectPath, manifest, options) {
2758
2797
  return;
2759
2798
  }
2760
2799
 
2800
+ // XSPEC-482 R7: ask the reconciler, the same question `uds update --plan` answers, instead of saying "would be
2801
+ // reinstalled" for every installation whatever is on disk. A project that is current used to get "51 command(s)
2802
+ // would be reinstalled" here, "unchanged" from `--plan --skills` and "No changes" from `--plan`.
2803
+ const actions = await commandActionsOf(projectPath);
2804
+
2805
+ let changed = 0;
2761
2806
  for (const inst of installations) {
2762
2807
  const agent = typeof inst === 'string' ? inst : inst.agent;
2763
2808
  const level = typeof inst === 'string' ? 'project' : (inst.level || 'project');
2764
2809
  const info = getInstalledCommandsForAgent(agent, level, projectPath);
2765
2810
  const dir = getCommandsDirForAgent(agent, level, projectPath);
2766
- console.log(chalk.yellow(` ~ ${getAgentDisplayName(agent)} (${level}): ${info?.count || 0} command(s) would be reinstalled ${dir}`));
2811
+ const differing = actions.filter((a) => a.details?.metadata?.agent === agent && (a.details?.metadata?.level || 'project') === level);
2812
+ if (differing.length === 0) {
2813
+ console.log(chalk.gray(` = ${getAgentDisplayName(agent)} (${level}): ${info?.count || 0} command(s) — unchanged`));
2814
+ } else {
2815
+ changed++;
2816
+ console.log(chalk.yellow(` ~ ${getAgentDisplayName(agent)} (${level}): ${differing.length} command file(s) would be written or removed ${dir}`)); // wire:plan-commands-asks-reconciler
2817
+ }
2767
2818
  }
2768
2819
 
2769
2820
  console.log();
2770
- console.log(`Summary: ${installations.length} installation(s) would be reinstalled.`);
2821
+ console.log(`Summary: ${changed} installation(s) would be reinstalled, ${installations.length - changed} unchanged.`);
2771
2822
  console.log(chalk.gray(` Locale that would be used: ${resolveLocale(manifest, projectPath, options)}`));
2772
- console.log(chalk.gray(' Run `uds update --apply --yes --commands` to apply.'));
2823
+ if (changed > 0) console.log(chalk.gray(' Run `uds update --apply --yes --commands` to apply.'));
2773
2824
  console.log();
2774
2825
  }
2775
2826
 
2827
+ /** The reconciler's plan actions for skill and command files (what `uds update --plan` would list). */
2828
+ async function commandActionsOf(projectPath) {
2829
+ const { plan } = await reconcilerPlan(projectPath, {});
2830
+ return plan.actions.filter((a) => a.category === 'command');
2831
+ }
2832
+
2833
+ async function skillActionsOf(projectPath) {
2834
+ const { plan } = await reconcilerPlan(projectPath, {});
2835
+ return plan.actions.filter((a) => a.category === 'skill');
2836
+ }
2837
+
2776
2838
  async function updateSkillsOnly(projectPath, manifest, options) {
2777
2839
  const msg = t().commands.update;
2778
2840
  const repoInfo = getRepositoryInfo();
@@ -2818,7 +2880,19 @@ async function updateSkillsOnly(projectPath, manifest, options) {
2818
2880
  return Boolean(config?.supportsSkills && config?.skills);
2819
2881
  });
2820
2882
  const agents = detectedSkillsTools.length > 0 ? detectedSkillsTools : ['claude-code'];
2821
- for (const agent of agents) skillsInstallations.push({ agent, level: legacyLocation });
2883
+ // XSPEC-486 R2: a tool with no folder at the recorded level (antigravity has no user-level one) is not given
2884
+ // an installation that has nowhere to go.
2885
+ // …and the run says so, as `init` and `config` do (beta.15 Windows retest, Issue 1: this path was silent).
2886
+ for (const agent of agents) {
2887
+ if (hasSkillsLevel(agent, legacyLocation)) {
2888
+ skillsInstallations.push({ agent, level: legacyLocation });
2889
+ } else {
2890
+ console.log(chalk.yellow(
2891
+ `⚠ ${getAgentDisplayName(agent) || agent}: ` +
2892
+ `${msg.skillsNoUserPath || 'has no user-level skills folder (only the project one), so this update left it out. To put its skills into this project instead: uds config --type skills --ai-tool antigravity --skills-location project'}`
2893
+ ));
2894
+ }
2895
+ }
2822
2896
  } else if (legacyLocation === 'marketplace') {
2823
2897
  console.log(chalk.yellow(msg.skillsViaMarketplace || 'Skills installed via Marketplace'));
2824
2898
  console.log(chalk.gray(` ${msg.updateViaMarketplace || 'Update through Plugin Marketplace'}`));
@@ -2891,7 +2965,7 @@ async function updateSkillsOnly(projectPath, manifest, options) {
2891
2965
  // Build location summary
2892
2966
  const locations = fileBasedInstallations.map(inst => {
2893
2967
  const displayName = getAgentDisplayName(inst.agent);
2894
- const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath);
2968
+ const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath) ?? '(no such folder)'; // XSPEC-486
2895
2969
  return `${displayName}: ${dir}`;
2896
2970
  }).join(', ');
2897
2971
 
@@ -3365,7 +3439,7 @@ async function promptNewFeatureInstallation(missingSkills, outdatedSkills, missi
3365
3439
  console.log(chalk.yellow(msg.skillsOutdatedFor || 'Skills updates available for these AI tools:'));
3366
3440
  for (const skill of outdatedSkills) {
3367
3441
  const levelLabel = skill.level === 'user' ? 'user' : 'project';
3368
- const pathDisplay = skill.path || getSkillsDirForAgent(skill.agent, skill.level);
3442
+ const pathDisplay = skill.path || getSkillsDirForAgent(skill.agent, skill.level) || '(no such folder)';
3369
3443
  console.log(chalk.gray(` • ${skill.displayName} (${levelLabel}: ${pathDisplay})`));
3370
3444
  console.log(chalk.gray(` ${skill.currentVersion} → ${skill.latestVersion}`));
3371
3445
  }
@@ -3374,7 +3448,7 @@ async function promptNewFeatureInstallation(missingSkills, outdatedSkills, missi
3374
3448
  // Build checkbox choices with path info
3375
3449
  const updateChoices = outdatedSkills.map(skill => {
3376
3450
  const levelLabel = skill.level === 'user' ? 'user' : 'project';
3377
- const pathDisplay = skill.path || getSkillsDirForAgent(skill.agent, skill.level);
3451
+ const pathDisplay = skill.path || getSkillsDirForAgent(skill.agent, skill.level) || '(no such folder)';
3378
3452
  return {
3379
3453
  name: `${skill.displayName} ${chalk.gray(`(${levelLabel}: ${pathDisplay}) ${skill.currentVersion} → ${skill.latestVersion}`)}`,
3380
3454
  value: skill.agent,
@@ -3510,14 +3584,14 @@ function takeStepBackup(projectPath, label, installations, kind) {
3510
3584
  console.log();
3511
3585
  return { ok: false };
3512
3586
  }
3513
- cleanupBackupsQuietly(projectPath);
3514
- return { ok: true, backupId: backup.backupId };
3587
+ return { ok: true, backupId: backup.backupId, cleanup: cleanupBackupsQuietly(projectPath) };
3515
3588
  }
3516
3589
 
3517
3590
  /** The step is over (its last manifest write is done): record what it created, and say how to undo it. */
3518
3591
  function finishStepBackup(projectPath, backup) {
3519
3592
  finalizeBackup(projectPath, backup.backupId);
3520
3593
  printBackupLocation(backup.backupId);
3594
+ printBackupCleanup(backup.cleanup);
3521
3595
  }
3522
3596
 
3523
3597
  /**
@@ -3533,9 +3607,34 @@ function printBackupLocation(backupId) {
3533
3607
 
3534
3608
  function cleanupBackupsQuietly(projectPath) {
3535
3609
  try {
3536
- cleanupBackups(projectPath);
3610
+ return cleanupBackups(projectPath);
3537
3611
  } catch {
3538
3612
  // an old backup that cannot be removed is not a reason to stop the update
3613
+ return null;
3614
+ }
3615
+ }
3616
+
3617
+ /**
3618
+ * Say what the backup limit did (XSPEC-475 R2). A backup is the adopter's data: one deleted without a word
3619
+ * is how an adopter loses the only copy of something version control cannot give back.
3620
+ * - every backup removed because `.uds-backups/` holds more than the limit is named;
3621
+ * - backups an older UDS left in the project root (`.uds-backup-*`) are never removed by the limit; they
3622
+ * are listed here with a suggestion to move them out themselves.
3623
+ * // implements XSPEC-475 R2
3624
+ */
3625
+ function printBackupCleanup(cleanup) {
3626
+ if (!cleanup) return;
3627
+ const removed = cleanup.removed || [];
3628
+ const legacy = cleanup.legacyKept || [];
3629
+ if (removed.length > 0) {
3630
+ console.log(chalk.yellow(` Removed ${removed.length} old backup(s) beyond the limit of ${cleanup.keep} in .uds-backups/:`));
3631
+ for (const id of removed) console.log(chalk.yellow(` ✕ ${id}`));
3632
+ }
3633
+ for (const err of cleanup.errors || []) console.log(chalk.red(` ${err}`));
3634
+ if (legacy.length > 0) {
3635
+ console.log(chalk.yellow(` ${legacy.length} backup(s) from an older UDS are still in the project root and were NOT removed by the limit:`));
3636
+ for (const id of legacy) console.log(chalk.yellow(` - ${id}`));
3637
+ console.log(chalk.gray(' UDS never deletes these. If you need them, move them out of the project yourself (for example, to a folder outside the repository).'));
3539
3638
  }
3540
3639
  }
3541
3640
 
@@ -3550,20 +3649,37 @@ function printPaths(prefix, paths, limit, colour) {
3550
3649
  * updates, then say, item by item, what was restored, what was removed, and what was NOT put back.
3551
3650
  * It never ends in "successful" while any of those lists is not empty (XSPEC-454 R1).
3552
3651
  */
3553
- async function handleRollback(projectPath) {
3652
+ async function handleRollback(projectPath, options = {}) {
3554
3653
  const backups = listBackups(projectPath);
3555
3654
  if (backups.length === 0) {
3556
3655
  console.log(chalk.yellow('No backups found. Nothing to rollback.'));
3557
3656
  console.log();
3657
+ if (options.from) process.exitCode = 1;
3558
3658
  return;
3559
3659
  }
3560
3660
 
3561
- const latest = backups[0];
3661
+ // XSPEC-482 R11: `--from` names the one backup to restore. The default picks the newest series, and a backup an older
3662
+ // UDS made is never in it (it records no manifest hash to chain on), so without this there was no way to reach it.
3663
+ let chosen = null;
3664
+ if (options.from) {
3665
+ const wanted = String(options.from).replace(/\\/g, '/').replace(/\/+$/, '');
3666
+ const leaf = (id) => id.slice(id.lastIndexOf('/') + 1);
3667
+ chosen = backups.find((b) => b.backupId === wanted) || backups.find((b) => leaf(b.backupId) === leaf(wanted));
3668
+ if (!chosen) {
3669
+ console.log(chalk.red(`No backup named "${options.from}". Backups in this project:`));
3670
+ for (const b of backups) console.log(chalk.gray(` ${b.backupId} (${b.createdAt || 'no date'})`));
3671
+ console.log();
3672
+ process.exitCode = 1;
3673
+ return;
3674
+ }
3675
+ }
3676
+
3677
+ const latest = chosen || backups[0];
3562
3678
  console.log(chalk.cyan(`Rolling back from: ${latest.backupId}`));
3563
3679
  console.log(chalk.gray(` Created: ${latest.createdAt}`));
3564
3680
  console.log();
3565
3681
 
3566
- const result = rollbackLast(projectPath);
3682
+ const result = rollbackLast(projectPath, chosen ? chosen.backupId : undefined);
3567
3683
 
3568
3684
  for (const step of result.steps || []) {
3569
3685
  console.log(chalk.cyan(`${step.backupId}${step.label ? ` (${step.label})` : ''}`));
@@ -3581,7 +3697,16 @@ async function handleRollback(projectPath) {
3581
3697
  console.log(chalk.gray(` ${result.steps.length} consecutive updates were undone together (each one started from where the previous one ended).`));
3582
3698
  }
3583
3699
  if (result.olderBackups > 0) {
3584
- console.log(chalk.gray(` ${result.olderBackups} older backup(s) are not part of that series (something else changed the project in between) and were left alone.`));
3700
+ // Say the true reason. A backup an older UDS made records no manifest hash, so there is nothing to tell whether it
3701
+ // continues the series; one that does carry the hash and still does not match means something else changed the project.
3702
+ const inSeries = (result.steps || []).length;
3703
+ const next = backups[inSeries];
3704
+ const why = next && !next.postManifestHash
3705
+ ? 'it was made by an older UDS, which did not record what links one backup to the next, so it cannot be joined to the series'
3706
+ : 'something else changed the project after it was made';
3707
+ console.log(chalk.gray(` ${result.olderBackups} older backup(s) are not part of that series (${why}) and were left alone.`));
3708
+ console.log(chalk.gray(' To restore one of them on its own: `uds update --rollback --from <backup>`. They are:'));
3709
+ for (const b of backups.slice(inSeries)) console.log(chalk.gray(` ${b.backupId} (${b.createdAt || 'no date'})`)); // wire:rollback-names-older-backups
3585
3710
  }
3586
3711
 
3587
3712
  if (result.errors.length > 0) {
@@ -3676,8 +3801,24 @@ async function handleReconcile(projectPath, options, { force, addStandards = []
3676
3801
  // XSPEC-454 R2: nothing to apply, but the manifest may still list skill files UDS never installed
3677
3802
  // (they only ever get corrected by a write, and an up-to-date project has none coming).
3678
3803
  const current = readManifest(projectPath);
3679
- if (current && (pruneForeignSkillHashes(current).length + pruneForeignCommandHashes(current).length) > 0) writeManifest(current, projectPath);
3804
+ // XSPEC-475 R6: nothing to apply means the files are what this UDS ships; the recorded versions say so too.
3805
+ let aligned = current ? alignRecordedVersions(current).changed : false; // wire:up-to-date-aligns-versions
3806
+ // XSPEC-482 R6: the same for the standards version, which only an executed plan used to record.
3807
+ if (current && alignUpstreamVersion(current).changed) aligned = true; // wire:up-to-date-aligns-upstream
3808
+ // XSPEC-456 R4 (kept through XSPEC-482 R6): the NAME lists are corrected here too. This early return used to be reached only by
3809
+ // a project that had nothing else to rewrite, which a fresh `uds init` almost never was; once init leaves the project current
3810
+ // it is the normal case, and the names UDS cannot vouch for (`_shared`, a retired skill) stayed in the manifest for good.
3811
+ // Ownership test only, as the reconciler does (no disk test).
3812
+ let droppedNames = 0;
3813
+ if (current) {
3814
+ const before = (current.skills?.names?.length || 0) + (current.commands?.names?.length || 0);
3815
+ pruneForeignSkillNames(current, '');
3816
+ pruneForeignCommandNames(current, '');
3817
+ droppedNames = before - ((current.skills?.names?.length || 0) + (current.commands?.names?.length || 0)); // wire:up-to-date-prunes-names
3818
+ }
3819
+ if (current && ((pruneForeignSkillHashes(current).length + pruneForeignCommandHashes(current).length) > 0 || aligned || droppedNames > 0)) writeManifest(current, projectPath);
3680
3820
  console.log(chalk.green('Everything is up to date. No changes needed.'));
3821
+ if (droppedNames > 0) console.log(chalk.gray(` ${t().commands.update.droppedForeignNames.replace('{count}', droppedNames)}`));
3681
3822
  // XSPEC-458 R2: "up to date" is about the files UDS manages; say what UDS ships that is not managed here.
3682
3823
  printAvailableStandardsSection(planResult.manifest, { phase: 'apply' });
3683
3824
  console.log();
@@ -3720,6 +3861,7 @@ async function handleReconcile(projectPath, options, { force, addStandards = []
3720
3861
 
3721
3862
  if (result.execution?.backupId) {
3722
3863
  printBackupLocation(result.execution.backupId);
3864
+ printBackupCleanup(result.execution.backupCleanup);
3723
3865
  }
3724
3866
 
3725
3867
  if (result.errors.length > 0) {
@@ -3730,6 +3872,18 @@ async function handleReconcile(projectPath, options, { force, addStandards = []
3730
3872
  }
3731
3873
  }
3732
3874
 
3875
+ if (!result.success) {
3876
+ // XSPEC-482 R10: say what a partly failed run left behind and the way to finish it.
3877
+ console.log();
3878
+ console.log(chalk.yellow(
3879
+ 'Not everything was applied. The overall version record did not advance, and a skills or commands batch that failed keeps its ' +
3880
+ 'old version record; a batch that succeeded has already recorded its new version. ' +
3881
+ 'Fix the cause, then run `uds update --apply` again: it completes what is left.'
3882
+ ));
3883
+ // XSPEC-482 R2: a failed action is a failed run. CI and scripts read the exit code, not the colour of a line.
3884
+ process.exitCode = 1; // wire:apply-fails-exit-1
3885
+ }
3886
+
3733
3887
  // XSPEC-458 R2: the count of what UDS ships and this project lacks, with the command that installs one.
3734
3888
  printAvailableStandardsSection(result.manifest || planResult.manifest, { phase: 'apply' });
3735
3889
  console.log();
@@ -8,6 +8,7 @@
8
8
  */
9
9
 
10
10
  import { BaseCompiler } from './base-compiler.js';
11
+ import { normalizeMatcher } from '../installers/hooks-installer.js';
11
12
 
12
13
  const DEFAULT_MATCHERS = {
13
14
  UserPromptSubmit: '',
@@ -27,7 +28,14 @@ export class ClaudeCodeCompiler extends BaseCompiler {
27
28
 
28
29
  for (const std of enforceable) {
29
30
  const { hook_script, trigger } = std.enforcement;
30
- const matcher = std.enforcement.matcher ?? DEFAULT_MATCHERS[trigger] ?? '';
31
+ // Claude Code's matcher is a string (https://code.claude.com/docs/en/hooks, "Matcher patterns"). A standard may
32
+ // declare it as an object (`matcher: { tool: Write, path: "src/**/*.ts" }`); that used to be written to
33
+ // settings.json as the object, which the documented format has no place for (XSPEC-482 R4). Same reduction
34
+ // `uds init --with-hooks` and `uds update --with-hooks` apply, so the three write one format.
35
+ const declared = std.enforcement.matcher;
36
+ const matcher = declared === undefined || declared === null
37
+ ? (DEFAULT_MATCHERS[trigger] ?? '')
38
+ : normalizeMatcher(declared); // wire:compile-matcher-is-a-string
31
39
 
32
40
  if (!hooks[trigger]) {
33
41
  hooks[trigger] = [];
@@ -354,13 +354,26 @@ export function getSkillsDirForAgent(agent, level = 'user', projectPath = null)
354
354
  if (!config || !config.skills) return null;
355
355
 
356
356
  if (level === 'user') {
357
- return config.skills.user;
357
+ // A tool can have no user-level folder (antigravity, on purpose). `null`, never `undefined`: every caller
358
+ // already treats a falsy answer as "no such place" (XSPEC-486 R2).
359
+ return config.skills.user || null; // wire:skills-dir-user-null-not-undefined
358
360
  } else if (level === 'project' && projectPath) {
359
361
  return join(projectPath, config.skills.project);
360
362
  }
361
363
  return null;
362
364
  }
363
365
 
366
+ /**
367
+ * Does the agent have a skills folder at this level? A tool may have only a project folder (antigravity: agy
368
+ * knows one skills location, the workspace) - then no user-level skills can be listed, installed or removed.
369
+ * @param {string} agent - Agent identifier
370
+ * @param {string} level - 'user' or 'project'
371
+ * @returns {boolean}
372
+ */
373
+ export function hasSkillsLevel(agent, level) {
374
+ return Boolean(AI_AGENT_PATHS[agent]?.skills?.[level]);
375
+ }
376
+
364
377
  /**
365
378
  * Get commands directory path for an agent
366
379
  * @param {string} agent - Agent identifier
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Which file formats a manifest's `format` setting puts on disk.
3
+ *
4
+ * `both` is not a third kind of file: it is the human copy (.md) and the AI copy (.ai.yaml) of every standard and
5
+ * every option, side by side. The installer copies once per entry of this list, and the reconciler has to expect
6
+ * exactly the same set. When the reconciler read `both` as one format it resolved only the human copy and planned
7
+ * to delete every AI copy the installer had just written (XSPEC-483).
8
+ *
9
+ * @param {string} [format] - 'ai', 'human' or 'both'. Anything else, including a missing value, is read as 'ai'.
10
+ * @returns {string[]} The formats to resolve a source file in: ['ai', 'human'] for 'both', otherwise one entry.
11
+ */
12
+ export function getInstalledFormats(format) {
13
+ if (format === 'both') return ['ai', 'human'];
14
+ return [format || 'ai'];
15
+ }
@@ -11,6 +11,10 @@
11
11
  * - 待辦
12
12
  * command_words: # extra program names read as a command in a next action or a draft
13
13
  * - kubectl
14
+ * asked_at_words: # extra words that head the "when was it asked" column (XSPEC-475 R3)
15
+ * - 何時問
16
+ * waiting_for_words: # extra words that head the "what is it waiting for" column (XSPEC-475 R3)
17
+ * - 問什麼
14
18
  *
15
19
  * This file holds no rule. It turns the section into the same `--root NAME=DIR` and
16
20
  * `--next-action-word WORD` arguments a person could type, and hands them to the checker, which
@@ -36,7 +40,7 @@ import { PROJECT_NAME } from '../utils/open-work-tracking.mjs';
36
40
  * `error`: the file is readable and its open_work section is wrong (the command stops with exit 2).
37
41
  */
38
42
  export function readOpenWorkDeclarations(cwd = process.cwd()) {
39
- const out = { projects: {}, nextActionWords: [], commandWords: [], note: null, error: null };
43
+ const out = { projects: {}, nextActionWords: [], commandWords: [], askedAtWords: [], waitingForWords: [], note: null, error: null };
40
44
  let config;
41
45
  try {
42
46
  config = loadProjectConfig(cwd);
@@ -71,6 +75,14 @@ export function readOpenWorkDeclarations(cwd = process.cwd()) {
71
75
  out.commandWords.push(w);
72
76
  }
73
77
  }
78
+ for (const [key, into] of [['asked_at_words', out.askedAtWords], ['waiting_for_words', out.waitingForWords]]) {
79
+ if (section[key] === undefined || section[key] === null) continue;
80
+ if (!Array.isArray(section[key])) return bad(`.${key} must be a list of words`);
81
+ for (const w of section[key]) {
82
+ if (typeof w !== 'string') return bad(`.${key} must hold text only; write each word as plain text`);
83
+ into.push(w);
84
+ }
85
+ }
74
86
  return out;
75
87
  }
76
88
 
@@ -101,3 +113,10 @@ export function wordArguments(cliWords, declaredWords = []) {
101
113
  for (const w of [].concat(cliWords ?? [], declaredWords)) argv.push('--next-action-word', w);
102
114
  return argv;
103
115
  }
116
+
117
+ /** The `--asked-at-word` or `--waiting-for-word` arguments (XSPEC-475 R3): the command line's words, then the file's. */
118
+ export function fieldWordArguments(flag, cliWords, declaredWords = []) {
119
+ const argv = [];
120
+ for (const w of [].concat(cliWords ?? [], declaredWords)) argv.push(flag, w);
121
+ return argv;
122
+ }
@@ -98,6 +98,61 @@ function validateConfig(config, filePath) {
98
98
  }
99
99
  }
100
100
 
101
+ /**
102
+ * True when `text` ends inside an open quote, reading it the way a shell does: a `'` inside `"..."` (and a `"` inside
103
+ * `'...'`) is plain text, and a backslash escapes the next character outside single quotes.
104
+ */
105
+ function endsInsideQuote(text) {
106
+ let open = null;
107
+ for (let i = 0; i < text.length; i++) {
108
+ const ch = text[i];
109
+ if (open === null) {
110
+ if (ch === '\\') i++;
111
+ else if (ch === '"' || ch === "'") open = ch;
112
+ } else if (open === '"' && ch === '\\') {
113
+ i++;
114
+ } else if (ch === open) {
115
+ open = null;
116
+ }
117
+ }
118
+ return open !== null;
119
+ }
120
+
121
+ /**
122
+ * The 1-based line of uds.project.yaml whose command YAML cut short in the middle of a quote, or null. XSPEC-475 R5(c).
123
+ *
124
+ * YAML ends an unquoted value at a space followed by `#`. `build: node -p "'quoted # kept'"` therefore becomes
125
+ * `node -p "'quoted`: the shell would have kept the `#`, YAML does not, and what is left has an unclosed quote - a command
126
+ * that cannot be what the author meant. A genuine trailing comment (`test: dotnet test X.csproj # 90 tests pass`) leaves a
127
+ * complete command and is the supported way to comment, so it is NOT reported. Only the cut-short case is, and the text YAML
128
+ * dropped is not repeated (it may be a comment the person wants kept out of the output).
129
+ *
130
+ * Only a plain (unquoted) scalar on one line is looked at, and only when the value YAML produced is exactly the text
131
+ * before the `#` - so a line this cannot match up with the parsed value is never reported.
132
+ * @param {string} projectPath
133
+ * @param {string} intent
134
+ * @param {string} command - the value YAML produced for `intent`
135
+ * @returns {number|null}
136
+ */
137
+ export function truncatedYamlValueLine(projectPath, intent, command) {
138
+ const configPath = join(projectPath, CONFIG_FILENAME);
139
+ if (!existsSync(configPath)) return null;
140
+ const escaped = intent.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
141
+ const line = new RegExp(`^[ \\t]+${escaped}[ \\t]*:[ \\t]+(.*)$`);
142
+ const lines = readFileSync(configPath, 'utf8').split(/\r?\n/);
143
+ for (let n = 0; n < lines.length; n++) {
144
+ const m = line.exec(lines[n]);
145
+ if (!m) continue;
146
+ const value = m[1].trim();
147
+ if (/^["'|>[{&*!]/.test(value)) continue; // quoted, block, flow or anchored: not a plain scalar
148
+ const at = value.search(/\s#/);
149
+ if (at < 0) continue;
150
+ if (value.slice(0, at).trim() !== command) continue; // not the line YAML read this value from
151
+ return endsInsideQuote(command) ? n + 1 : null; // [mutation-anchor:cut-inside-quote]
152
+ }
153
+ return null;
154
+ }
155
+
101
156
  /**
102
157
  * Get a specific command intent from config.
103
158
  * Returns undefined if not configured.