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