universal-dev-standards 6.13.1 → 6.14.0-beta.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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 +254 -4
- package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
- package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
- package/bundled/ai/standards/turn-completion-integrity.ai.yaml +14 -7
- 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 +251 -8
- package/bundled/core/pipeline-security-gates.md +63 -0
- package/bundled/core/project-context-memory.md +10 -2
- package/bundled/core/turn-completion-integrity.md +58 -11
- 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/check-turn-completion-agy.mjs +147 -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 +211 -3
- package/bundled/locales/zh-CN/README.md +3 -3
- package/bundled/locales/zh-CN/SECURITY.md +3 -1
- 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/turn-completion-integrity.md +46 -13
- 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 +11 -2
- package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +76 -40
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +32 -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 +211 -3
- package/bundled/locales/zh-TW/README.md +3 -3
- package/bundled/locales/zh-TW/SECURITY.md +3 -1
- 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 +164 -9
- 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/turn-completion-integrity.md +46 -13
- 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 +11 -2
- package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +69 -33
- package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +32 -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 +173 -49
- 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 +320 -24
- 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 +323 -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
package/src/commands/init.js
CHANGED
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
import chalk from 'chalk';
|
|
2
2
|
import { createSpinner } from '../utils/spinner.js';
|
|
3
|
-
import {
|
|
4
|
-
import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
|
|
3
|
+
import { existsSync, mkdirSync, readFileSync, writeFileSync, chmodSync } from 'fs';
|
|
5
4
|
import { join } from 'path';
|
|
6
5
|
import {
|
|
7
6
|
manifestExists as isInitialized,
|
|
@@ -15,20 +14,28 @@ import { runInitFlow } from '../flows/init-flow.js';
|
|
|
15
14
|
import { installStandards } from '../installers/standards-installer.js';
|
|
16
15
|
import { installIntegrations, generateUniversalAgentsMd } from '../installers/integration-installer.js';
|
|
17
16
|
import { installSkills, installCommands } from '../installers/skills-installer.js';
|
|
17
|
+
import { printSkillNameCollisionWarning } from '../utils/skill-name-collision.js';
|
|
18
|
+
import { printDoubleInstallWarning } from '../utils/skills-install-paths.js';
|
|
18
19
|
import { writeFinalManifest } from '../installers/manifest-installer.js';
|
|
19
20
|
import {
|
|
20
21
|
getInstalledSkillsInfo,
|
|
21
22
|
getProjectInstalledSkillsInfo,
|
|
23
|
+
getMarketplaceSkillsInfo,
|
|
22
24
|
getAgentConfig,
|
|
23
25
|
getAgentDisplayName
|
|
24
26
|
} from '../utils/github.js';
|
|
25
|
-
import { displayLanguageToLocale } from '../utils/locale.js';
|
|
27
|
+
import { displayLanguageToLocale, normalizeRequestedLocale } from '../utils/locale.js';
|
|
28
|
+
import localeUtils from '../utils/locale.js';
|
|
29
|
+
const LOCALE_MAP_FOR_INIT = localeUtils.LOCALE_MAP;
|
|
26
30
|
import { generateReleaseConfig, RELEASE_MODE_LABELS } from '../utils/release-config.js';
|
|
27
31
|
import { guardAgainstSelfAdoption } from '../utils/detect-self-adoption.js';
|
|
28
32
|
import { readInstallYaml } from '../utils/config-manager.js';
|
|
29
33
|
import { resolveIntegrationTargetFile } from '../utils/integration-generator.js';
|
|
30
34
|
import { withFileTransaction } from '../utils/transaction.js';
|
|
31
|
-
import {
|
|
35
|
+
import { newRecorder, mkdirTracked, recordFile, persistRecorder, RECORD_KINDS } from '../core/install-records.js';
|
|
36
|
+
import { wireGitHooksPath, getLocalHooksPathConfig, stripLegacyHuskyShLine, ensureShebang, hookRunsUdsCheck, buildPreCommitBlock } from '../utils/git-hooks.js';
|
|
37
|
+
import { migrateLegacyHuskyHook } from '../utils/legacy-hook-migration.js';
|
|
38
|
+
import { installGateScripts } from '../utils/gate-scripts.js';
|
|
32
39
|
|
|
33
40
|
/**
|
|
34
41
|
* Init command - initialize standards in current project
|
|
@@ -52,6 +59,8 @@ export async function initCommand(options) {
|
|
|
52
59
|
if (isInitialized(projectPath)) {
|
|
53
60
|
console.log(chalk.yellow(msg.alreadyInitialized));
|
|
54
61
|
console.log(chalk.gray(` ${msg.useUpdateOrDelete}`));
|
|
62
|
+
// `init` cannot run twice, so `--with-hooks` has no effect here; say where the door is.
|
|
63
|
+
if (options.withHooks) console.log(chalk.yellow(` ${msg.useUpdateWithHooks}`));
|
|
55
64
|
return;
|
|
56
65
|
}
|
|
57
66
|
|
|
@@ -211,7 +220,11 @@ export async function initCommand(options) {
|
|
|
211
220
|
skillHashes: skillsResults.skillHashes,
|
|
212
221
|
commandHashes: skillsResults.commandHashes,
|
|
213
222
|
integrationBlockHashes: integrationResults.integrationBlockHashes,
|
|
214
|
-
manifestIntegrationConfigs: integrationResults.manifestIntegrationConfigs
|
|
223
|
+
manifestIntegrationConfigs: integrationResults.manifestIntegrationConfigs,
|
|
224
|
+
createdIntegrationFiles: [
|
|
225
|
+
...(integrationResults.createdFiles ?? []),
|
|
226
|
+
...(agentsMdResult.created ? [agentsMdResult.path] : [])
|
|
227
|
+
]
|
|
215
228
|
};
|
|
216
229
|
},
|
|
217
230
|
// A half-installed project must never be committed: if any installer
|
|
@@ -256,9 +269,13 @@ export async function initCommand(options) {
|
|
|
256
269
|
}
|
|
257
270
|
|
|
258
271
|
// 4.6. Install enforcement hooks (if --with-hooks)
|
|
272
|
+
// What this step writes is recorded in the manifest (installedArtifacts) so
|
|
273
|
+
// `uds uninstall` can remove exactly it — hook scripts, and the folders UDS had
|
|
274
|
+
// to create for them — and leave everything the adopter put there alone.
|
|
275
|
+
const installRecorder = newRecorder();
|
|
259
276
|
if (config.withHooks) {
|
|
260
277
|
const { installHooks } = await import('../installers/hooks-installer.js');
|
|
261
|
-
const hookResult = installHooks(projectPath);
|
|
278
|
+
const hookResult = installHooks(projectPath, { recorder: installRecorder });
|
|
262
279
|
if (hookResult.installed) {
|
|
263
280
|
console.log(chalk.green(
|
|
264
281
|
` ✓ Enforcement hooks installed (${hookResult.scriptsCount} scripts, `
|
|
@@ -281,8 +298,8 @@ export async function initCommand(options) {
|
|
|
281
298
|
}
|
|
282
299
|
}
|
|
283
300
|
|
|
284
|
-
// turn-completion-integrity is also extended to Codex
|
|
285
|
-
// (2026-09-25), each with its own config file and output contract — see
|
|
301
|
+
// turn-completion-integrity is also extended to Codex, Gemini CLI and
|
|
302
|
+
// Antigravity CLI (2026-09-25; agy 2026-09-29), each with its own config file and output contract — see
|
|
286
303
|
// installCodexHooks/installGeminiHooks in hooks-installer.js. Gated on the
|
|
287
304
|
// tools the adopter actually selected: writing a hooks.json into every
|
|
288
305
|
// project's .codex/ regardless of whether Codex is used would be noise,
|
|
@@ -290,7 +307,7 @@ export async function initCommand(options) {
|
|
|
290
307
|
const selectedTools = config.integrations || config.aiTools || [];
|
|
291
308
|
if (selectedTools.includes('codex')) {
|
|
292
309
|
const { installCodexHooks } = await import('../installers/hooks-installer.js');
|
|
293
|
-
const codexResult = installCodexHooks(projectPath);
|
|
310
|
+
const codexResult = installCodexHooks(projectPath, { recorder: installRecorder });
|
|
294
311
|
if (codexResult.installed) {
|
|
295
312
|
console.log(chalk.green(' ✓ Codex Stop hook installed (turn-completion-integrity)'));
|
|
296
313
|
// Measured 2026-09-28 (codex-cli 0.155.1): Codex skips a project hook
|
|
@@ -304,13 +321,72 @@ export async function initCommand(options) {
|
|
|
304
321
|
}
|
|
305
322
|
if (selectedTools.includes('gemini-cli')) {
|
|
306
323
|
const { installGeminiHooks } = await import('../installers/hooks-installer.js');
|
|
307
|
-
const geminiResult = installGeminiHooks(projectPath);
|
|
324
|
+
const geminiResult = installGeminiHooks(projectPath, { recorder: installRecorder });
|
|
308
325
|
if (geminiResult.installed) {
|
|
309
326
|
console.log(chalk.green(' ✓ Gemini CLI AfterAgent hook installed (turn-completion-integrity; Gemini CLI is legacy — see the standard)'));
|
|
310
327
|
} else {
|
|
311
328
|
console.log(chalk.yellow(` ⚠ Gemini CLI hook not installed — ${geminiResult.reason}`));
|
|
312
329
|
}
|
|
313
330
|
}
|
|
331
|
+
if (selectedTools.includes('antigravity')) {
|
|
332
|
+
const { installAgyHooks } = await import('../installers/hooks-installer.js');
|
|
333
|
+
const agyResult = installAgyHooks(projectPath, { recorder: installRecorder });
|
|
334
|
+
if (agyResult.installed) {
|
|
335
|
+
console.log(chalk.green(' ✓ Antigravity CLI Stop hook installed (turn-completion-integrity; .agents/hooks.json)'));
|
|
336
|
+
// Verified 2026-09-29 (agy 1.2.12): single turn, no tool calls, `agy -p`.
|
|
337
|
+
// Multi-turn, tool-call turns and interactive mode are not verified —
|
|
338
|
+
// say so here, where the adopter believes it now works everywhere.
|
|
339
|
+
console.log(chalk.yellow(' ⚠ Verified against a real agy session for a single turn without tool calls in `agy -p` mode only; multi-turn, tool-call turns and interactive mode are not yet verified.'));
|
|
340
|
+
} else {
|
|
341
|
+
console.log(chalk.yellow(` ⚠ Antigravity CLI hook not installed — ${agyResult.reason}`));
|
|
342
|
+
}
|
|
343
|
+
}
|
|
344
|
+
}
|
|
345
|
+
|
|
346
|
+
// 4.7. Record the integration files UDS created from nothing, and the hook
|
|
347
|
+
// files/folders written above. Their text outside the UDS marker block (the
|
|
348
|
+
// `> Auto-generated by ...` header, the generated sections) is what makes
|
|
349
|
+
// "delete the whole file" provable at uninstall time.
|
|
350
|
+
for (const created of combinedResults.createdIntegrationFiles ?? []) {
|
|
351
|
+
recordFile(installRecorder, projectPath, created, RECORD_KINDS.INTEGRATION_FILE);
|
|
352
|
+
}
|
|
353
|
+
|
|
354
|
+
// 4.8. Ship the fake-test and stub scanners the full-coverage-testing standard asks for
|
|
355
|
+
// (XSPEC-444 R5). They are written whether or not git is present — the hook step below
|
|
356
|
+
// needs a repository, the scanners do not — and recorded so `uds uninstall` removes
|
|
357
|
+
// exactly these files. A file that already exists is the adopter's and is left alone.
|
|
358
|
+
const gateResult = installGateScripts(projectPath, installRecorder);
|
|
359
|
+
for (const rel of gateResult.written) {
|
|
360
|
+
console.log(chalk.green(` ✓ ${rel} (fake-test / stub scanner — \`uds check\` runs it and warns; edit it freely)`));
|
|
361
|
+
}
|
|
362
|
+
for (const rel of gateResult.kept) {
|
|
363
|
+
console.log(chalk.gray(` · ${rel} already exists — kept as is`));
|
|
364
|
+
}
|
|
365
|
+
for (const file of gateResult.missingTemplate) {
|
|
366
|
+
console.log(chalk.yellow(` ⚠ scripts/${file} not installed — the template is missing from this UDS package`));
|
|
367
|
+
}
|
|
368
|
+
persistRecorder(projectPath, installRecorder);
|
|
369
|
+
|
|
370
|
+
// 4.9. XSPEC-465 R1: tell the adopter now if a personal skill of theirs has the same name as a UDS skill
|
|
371
|
+
// that was just installed (the personal one wins, with no error). Information only: it does not change
|
|
372
|
+
// what was installed or the exit code.
|
|
373
|
+
if ((combinedResults?.skills?.length ?? 0) > 0) {
|
|
374
|
+
// XSPEC-468 R1: skills now go into the project by default, so a project whose owner already has the UDS
|
|
375
|
+
// plugin would list every skill twice. Same warning `uds check` prints (XSPEC-462 R2); information only,
|
|
376
|
+
// it changes neither what was installed nor the exit code.
|
|
377
|
+
printDoubleInstallWarning(projectPath, getMarketplaceSkillsInfo());
|
|
378
|
+
printSkillNameCollisionWarning(projectPath);
|
|
379
|
+
}
|
|
380
|
+
|
|
381
|
+
// 4.95. XSPEC-468 R1: the adopter asked for the plugin by name, so no skill file was written. Say so at the
|
|
382
|
+
// end, where they look for the skills, and say where they come from and what the other way would do.
|
|
383
|
+
if (config.skillsConfig.location === 'marketplace') {
|
|
384
|
+
console.log();
|
|
385
|
+
console.log(chalk.cyan(msg.skillsFromPluginTitle));
|
|
386
|
+
for (const line of msg.skillsFromPluginLines) {
|
|
387
|
+
console.log(chalk.gray(` ${line}`));
|
|
388
|
+
}
|
|
389
|
+
console.log();
|
|
314
390
|
}
|
|
315
391
|
|
|
316
392
|
// 5. Setup Pre-commit Hook
|
|
@@ -324,7 +400,7 @@ export async function initCommand(options) {
|
|
|
324
400
|
* - Node.js projects: use husky
|
|
325
401
|
* - Non-Node.js projects: write native .git/hooks/pre-commit
|
|
326
402
|
*/
|
|
327
|
-
export async function setupHuskyHook(projectPath, { allowInTest = false } = {}) {
|
|
403
|
+
export async function setupHuskyHook(projectPath, { allowInTest = false, platform = process.platform } = {}) {
|
|
328
404
|
// 2026-07-30:本函式在跑測試時改寫了 universal-dev-standards 自己
|
|
329
405
|
// ——`npm install --save-dev husky`、改 package.json、建 .husky/pre-commit。
|
|
330
406
|
//
|
|
@@ -344,6 +420,9 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
|
|
|
344
420
|
|
|
345
421
|
const isNodeProject = existsSync(join(projectPath, 'package.json'));
|
|
346
422
|
|
|
423
|
+
// What this function creates, for `uds uninstall` (see core/install-records.js).
|
|
424
|
+
const recorder = newRecorder();
|
|
425
|
+
|
|
347
426
|
if (isNodeProject) {
|
|
348
427
|
console.log(chalk.cyan('Configuring Pre-commit Hook...'));
|
|
349
428
|
|
|
@@ -421,7 +500,7 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
|
|
|
421
500
|
// 3. Ensure .husky directory exists
|
|
422
501
|
if (!existsSync(huskyDir)) {
|
|
423
502
|
try {
|
|
424
|
-
|
|
503
|
+
mkdirTracked(recorder, projectPath, huskyDir);
|
|
425
504
|
} catch (e) {
|
|
426
505
|
console.log(chalk.red(` ✗ Failed to create .husky directory: ${e.message}`));
|
|
427
506
|
return;
|
|
@@ -430,8 +509,10 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
|
|
|
430
509
|
|
|
431
510
|
// 4. Add pre-commit hook content
|
|
432
511
|
const preCommitPath = join(huskyDir, 'pre-commit');
|
|
433
|
-
const udsCmd = 'npx uds check';
|
|
434
512
|
|
|
513
|
+
// Only a hook file UDS creates from nothing can later be proven to be wholly
|
|
514
|
+
// its own; one that already existed is appended to and stays the adopter's.
|
|
515
|
+
const preCommitExisted = existsSync(preCommitPath);
|
|
435
516
|
try {
|
|
436
517
|
// husky v9's own templates carry no shebang, no `_/husky.sh` sourcing
|
|
437
518
|
// (that is v8 syntax, deprecated in v9 and removed in v10). Verified
|
|
@@ -449,6 +530,18 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
|
|
|
449
530
|
// — cheap, harmless on POSIX, and required on Windows. Existing files
|
|
450
531
|
// are appended to, never rewritten — their contents are the adopter's,
|
|
451
532
|
// not ours; ensureShebang only ever prepends a missing first line.
|
|
533
|
+
// A hook an older UDS wrote asks npx for the bare name `uds`, which on the
|
|
534
|
+
// npm registry is an unrelated package (see buildPreCommitBlock). Swap the
|
|
535
|
+
// line UDS itself wrote for the current block before anything else reads
|
|
536
|
+
// the file; a line the adopter edited is left alone and reported below.
|
|
537
|
+
const legacy = existsSync(preCommitPath) ? migrateLegacyHuskyHook(projectPath) : null;
|
|
538
|
+
if (legacy?.state === 'migrated') {
|
|
539
|
+
console.log(chalk.green(' ✓ Replaced the pre-commit line an older UDS wrote (it asked npm to resolve the bare name "uds", which is not this project) with one that runs only the installed UDS CLI'));
|
|
540
|
+
}
|
|
541
|
+
for (const k of legacy?.kept ?? []) {
|
|
542
|
+
console.log(chalk.yellow(` ⚠ .husky/pre-commit line ${k.line} ("${k.text}") asks npm to resolve the bare name "uds", which on the npm registry is an unrelated package. UDS did not write this exact line, so it was left alone — change it to "universal-dev-standards check" (with the CLI installed in this project or on PATH).`));
|
|
543
|
+
}
|
|
544
|
+
|
|
452
545
|
let content = existsSync(preCommitPath) ? readFileSync(preCommitPath, 'utf-8') : '';
|
|
453
546
|
|
|
454
547
|
// A pre-existing file may still carry husky v8's `_/husky.sh` sourcing
|
|
@@ -464,10 +557,10 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
|
|
|
464
557
|
const { content: destripped, removed: hadLegacyLine } = stripLegacyHuskyShLine(content);
|
|
465
558
|
content = destripped;
|
|
466
559
|
|
|
467
|
-
const needsAppend = !content
|
|
560
|
+
const needsAppend = !hookRunsUdsCheck(content);
|
|
468
561
|
if (needsAppend) {
|
|
469
562
|
const sep = content && !content.endsWith('\n') ? '\n' : '';
|
|
470
|
-
content = `${content}${sep}\n
|
|
563
|
+
content = `${content}${sep}\n${buildPreCommitBlock()}`;
|
|
471
564
|
}
|
|
472
565
|
|
|
473
566
|
const { content: shebanged, added: addedShebang } = ensureShebang(content);
|
|
@@ -475,10 +568,22 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
|
|
|
475
568
|
|
|
476
569
|
if (hadLegacyLine || needsAppend || addedShebang) {
|
|
477
570
|
writeFileSync(preCommitPath, content, 'utf-8');
|
|
478
|
-
|
|
479
|
-
|
|
480
|
-
|
|
481
|
-
|
|
571
|
+
if (!preCommitExisted) recordFile(recorder, projectPath, '.husky/pre-commit', RECORD_KINDS.GIT_HOOK);
|
|
572
|
+
// 🔴 Was `execSync(`chmod +x ...`)` inside try/catch. On Windows that
|
|
573
|
+
// spawned cmd.exe, which printed "'chmod' is not recognized as an
|
|
574
|
+
// internal or external command" straight to the user's terminal —
|
|
575
|
+
// execSync inherits the child's stderr by default, so the catch hid the
|
|
576
|
+
// failure from the code and left it loud for the human (adopter report,
|
|
577
|
+
// 6.14.0-beta.2, Windows 11). No shell is needed to change a mode, and
|
|
578
|
+
// Windows has no exec bit to set (git for Windows runs the hook through
|
|
579
|
+
// its own sh regardless), so it is skipped there.
|
|
580
|
+
if (platform !== 'win32') {
|
|
581
|
+
try {
|
|
582
|
+
chmodSync(preCommitPath, 0o755);
|
|
583
|
+
} catch {
|
|
584
|
+
// A filesystem that refuses the mode change (FAT, some mounts) is not
|
|
585
|
+
// a reason to fail the install; git reports a non-executable hook itself.
|
|
586
|
+
}
|
|
482
587
|
}
|
|
483
588
|
}
|
|
484
589
|
|
|
@@ -497,6 +602,8 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
|
|
|
497
602
|
console.log(chalk.red(` ✗ Failed to configure pre-commit hook: ${e.message}`));
|
|
498
603
|
}
|
|
499
604
|
|
|
605
|
+
persistRecorder(projectPath, recorder);
|
|
606
|
+
|
|
500
607
|
// 5. Wire git so the hook ACTUALLY runs — this is the fix. Setting
|
|
501
608
|
// `core.hooksPath` ourselves is what husky's own bootstrap does internally
|
|
502
609
|
// (verified against husky ^9.1.7's source: `git config core.hooksPath
|
|
@@ -552,7 +659,7 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
|
|
|
552
659
|
|
|
553
660
|
if (existsSync(hookPath)) {
|
|
554
661
|
const existingContent = readFileSync(hookPath, 'utf-8');
|
|
555
|
-
if (existingContent
|
|
662
|
+
if (hookRunsUdsCheck(existingContent)) {
|
|
556
663
|
console.log(chalk.gray(' ✓ Pre-commit hook already configured'));
|
|
557
664
|
} else {
|
|
558
665
|
// Never clobber an adopter's own hook (this fix — it used to be
|
|
@@ -561,27 +668,42 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
|
|
|
561
668
|
console.log(chalk.gray(' UDS will not overwrite it. Add "uds check" to it yourself, or remove it and re-run `uds init`.'));
|
|
562
669
|
}
|
|
563
670
|
} else {
|
|
671
|
+
// Fail-closed (XSPEC-444 R1 class sweep). This script used to run the linters
|
|
672
|
+
// as `... 2>/dev/null || true` and `uds check 2>/dev/null || true`, then print
|
|
673
|
+
// "Pre-commit checks passed" — it could not block a commit for any reason.
|
|
674
|
+
// Now: a linter that is installed and fails blocks the commit; one that is not
|
|
675
|
+
// installed is skipped. The UDS check is the same block the husky path writes
|
|
676
|
+
// (buildPreCommitBlock): its exit status stops the commit, and a missing CLI
|
|
677
|
+
// says so and blocks rather than being skipped in silence.
|
|
564
678
|
const hookContent = `#!/bin/sh
|
|
565
679
|
# UDS pre-commit hook
|
|
566
680
|
# Auto-generated by uds init
|
|
567
681
|
|
|
568
682
|
echo "Running UDS pre-commit checks..."
|
|
569
683
|
|
|
570
|
-
#
|
|
684
|
+
# Lint, when the language's linter is installed. A failing linter blocks the commit.
|
|
571
685
|
if [ -f pyproject.toml ] || [ -f requirements.txt ]; then
|
|
572
|
-
python -m ruff
|
|
686
|
+
if python -m ruff --version >/dev/null 2>&1; then
|
|
687
|
+
python -m ruff check . || exit $?
|
|
688
|
+
fi
|
|
573
689
|
elif [ -f go.mod ]; then
|
|
574
|
-
|
|
690
|
+
if command -v go >/dev/null 2>&1; then
|
|
691
|
+
go vet ./... || exit $?
|
|
692
|
+
fi
|
|
575
693
|
elif [ -f Cargo.toml ]; then
|
|
576
|
-
cargo
|
|
694
|
+
if command -v cargo >/dev/null 2>&1; then
|
|
695
|
+
cargo clippy || exit $?
|
|
696
|
+
fi
|
|
577
697
|
fi
|
|
578
698
|
|
|
579
|
-
|
|
580
|
-
uds check 2>/dev/null || true
|
|
581
|
-
|
|
699
|
+
${buildPreCommitBlock({ hookFile: '.git/hooks/pre-commit' })}
|
|
582
700
|
echo "Pre-commit checks passed"
|
|
583
701
|
`;
|
|
584
702
|
writeFileSync(hookPath, hookContent, { mode: 0o755 });
|
|
703
|
+
// Created from nothing (the branch above is "file does not exist"), so the
|
|
704
|
+
// whole file is UDS's — record its hash for `uds uninstall`.
|
|
705
|
+
recordFile(recorder, projectPath, '.git/hooks/pre-commit', RECORD_KINDS.GIT_HOOK);
|
|
706
|
+
persistRecorder(projectPath, recorder);
|
|
585
707
|
console.log(chalk.green(' ✓ Installed .git/hooks/pre-commit (native git hook)'));
|
|
586
708
|
}
|
|
587
709
|
} catch (e) {
|
|
@@ -599,9 +721,16 @@ function buildNonInteractiveConfig(options, detected, projectPath) {
|
|
|
599
721
|
// CLI --locale > .uds/install.yaml locale: > UDS_LOCALE env > LANG > 'en'
|
|
600
722
|
// detectLanguage() handles UDS_LOCALE + LANG fallback internally (P1-CLI-3).
|
|
601
723
|
const installYaml = readInstallYaml(projectPath);
|
|
602
|
-
const
|
|
724
|
+
const requestedLanguage = options.locale
|
|
603
725
|
|| installYaml.locale
|
|
604
726
|
|| detectLanguage(null);
|
|
727
|
+
// Case-insensitive, and an unsupported value is said out loud instead of silently becoming English
|
|
728
|
+
// (dev-platform XSPEC-451 follow-up: `--locale zh-CN` used to install English with exit 0).
|
|
729
|
+
const { displayLanguage: normalizedLanguage, supported } = normalizeRequestedLocale(requestedLanguage);
|
|
730
|
+
const displayLanguage = supported ? normalizedLanguage : 'en';
|
|
731
|
+
if (!supported) {
|
|
732
|
+
console.log(chalk.yellow(`⚠ Unsupported locale "${requestedLanguage}" — installing in English. Supported: ${Object.keys(LOCALE_MAP_FOR_INIT).join(', ')}.`));
|
|
733
|
+
}
|
|
605
734
|
|
|
606
735
|
// Determine AI tools
|
|
607
736
|
const detectedAiTools = Object.keys(detected.aiTools).filter(k => detected.aiTools[k]);
|
|
@@ -637,30 +766,21 @@ function buildNonInteractiveConfig(options, detected, projectPath) {
|
|
|
637
766
|
return Boolean(config?.supportsSkills && config?.skills);
|
|
638
767
|
});
|
|
639
768
|
const hasSkillsCompatibleTool = skillsCapableTools.length > 0;
|
|
640
|
-
//
|
|
641
|
-
//
|
|
642
|
-
//
|
|
643
|
-
//
|
|
644
|
-
//
|
|
645
|
-
//
|
|
646
|
-
//
|
|
647
|
-
//
|
|
648
|
-
//
|
|
649
|
-
//
|
|
650
|
-
|
|
651
|
-
// nobody is left with a successful init and an empty directory.
|
|
652
|
-
const reachesMarketplace = t => {
|
|
653
|
-
const c = getAgentConfig(t);
|
|
654
|
-
return Boolean(c?.supportsMarketplace || c?.fallbackSkillsPath);
|
|
655
|
-
};
|
|
656
|
-
const onlySkillsCompatibleTools =
|
|
657
|
-
hasSkillsCompatibleTool && aiToolsNormalized.every(reachesMarketplace);
|
|
769
|
+
// XSPEC-468 R1: with no --skills-location, skills go INTO THE PROJECT (the main path, XSPEC-462).
|
|
770
|
+
// This used to pick 'marketplace' whenever every detected tool could reach Claude's plugin, which left
|
|
771
|
+
// `uds init --yes` with no `.claude/skills/` at all and told a new user to go and install a plugin: the
|
|
772
|
+
// opposite of the recommendation printed by `uds skills`. The plugin is still there for anyone who asks
|
|
773
|
+
// for it by name (`--skills-location marketplace`), and the plugin's limits are printed, not hidden.
|
|
774
|
+
//
|
|
775
|
+
// Two cases keep their old answer, and they are knowledge, not default:
|
|
776
|
+
// - tools were detected and none of them can take skills -> 'none' (nothing to install, said below);
|
|
777
|
+
// - nothing was detected at all -> 'project' with Claude Code's own project folder (the historical
|
|
778
|
+
// guess; see `noToolDetected` below).
|
|
779
|
+
const noToolDetected = aiToolsNormalized.length === 0;
|
|
658
780
|
|
|
659
781
|
let skillsLocationFlag = options.skillsLocation;
|
|
660
782
|
if (!skillsLocationFlag) {
|
|
661
|
-
skillsLocationFlag = hasSkillsCompatibleTool
|
|
662
|
-
? (onlySkillsCompatibleTools ? 'marketplace' : 'project')
|
|
663
|
-
: 'none';
|
|
783
|
+
skillsLocationFlag = (noToolDetected || hasSkillsCompatibleTool) ? 'project' : 'none';
|
|
664
784
|
}
|
|
665
785
|
|
|
666
786
|
// A detected tool that can take skills and is getting none must SAY SO. The worst
|
|
@@ -735,6 +855,10 @@ function buildNonInteractiveConfig(options, detected, projectPath) {
|
|
|
735
855
|
// `installSkills()` takes its legacy branch, and every tool's skills land in
|
|
736
856
|
// `.claude/skills/` — see the block above for what that measured.
|
|
737
857
|
skillsInstallationsForYes = skillsCapableTools.map(agent => ({ agent, level: location }));
|
|
858
|
+
// Nothing detected: name Claude Code's folder explicitly. Leaving the list empty sent the install down
|
|
859
|
+
// the legacy branch of `installSkills()`, which does not take the locale (so `--locale zh-tw` in a
|
|
860
|
+
// project with no tool marker would have installed English and said nothing).
|
|
861
|
+
if (noToolDetected) skillsInstallationsForYes = [{ agent: 'claude-code', level: location }];
|
|
738
862
|
|
|
739
863
|
// 🔴 Detected tools, none of which can take skills, is NOT the same as "no tools
|
|
740
864
|
// detected". The first is knowledge — install nothing and say why. The second is
|
package/src/commands/list.js
CHANGED
|
@@ -8,6 +8,14 @@ import {
|
|
|
8
8
|
import { readManifest, isInitialized } from '../utils/copier.js';
|
|
9
9
|
import { t, getLanguage, setLanguage, isLanguageExplicitlySet } from '../i18n/messages.js';
|
|
10
10
|
|
|
11
|
+
/**
|
|
12
|
+
* The order the listing shows its categories in. A category the registry holds standards for but that is not named
|
|
13
|
+
* here is still listed (after these, under its own key): the "Total" line counts every standard in the registry, so a
|
|
14
|
+
* category that was left out of the display used to make the total larger than the list (82 of 163 standards were
|
|
15
|
+
* counted and never shown, and `--category core` was refused as unknown).
|
|
16
|
+
*/
|
|
17
|
+
const CATEGORY_ORDER = ['skill', 'reference', 'core', 'testing', 'security', 'deployment', 'operations', 'extension', 'integration', 'template'];
|
|
18
|
+
|
|
11
19
|
/**
|
|
12
20
|
* List command - displays available standards
|
|
13
21
|
* @param {Object} options - Command options
|
|
@@ -44,7 +52,8 @@ export function listCommand(options) {
|
|
|
44
52
|
const categoryInfo = getCategoryInfo(category);
|
|
45
53
|
if (!categoryInfo) {
|
|
46
54
|
console.log(chalk.red(`${msg.errorUnknownCategory} '${category}'`));
|
|
47
|
-
|
|
55
|
+
const valid = CATEGORY_ORDER.filter((c) => getCategoryInfo(c));
|
|
56
|
+
console.log(chalk.gray(`${msg.validCategories} ${valid.join(', ')}`));
|
|
48
57
|
process.exit(1);
|
|
49
58
|
}
|
|
50
59
|
standards = getStandardsByCategory(category);
|
|
@@ -65,13 +74,13 @@ export function listCommand(options) {
|
|
|
65
74
|
}
|
|
66
75
|
|
|
67
76
|
// Display each category
|
|
68
|
-
const categoryOrder = [
|
|
77
|
+
const categoryOrder = [...CATEGORY_ORDER, ...Object.keys(grouped).filter((c) => !CATEGORY_ORDER.includes(c))];
|
|
69
78
|
|
|
70
79
|
for (const cat of categoryOrder) {
|
|
71
80
|
if (!grouped[cat] || grouped[cat].length === 0) continue;
|
|
72
81
|
|
|
73
82
|
const catInfo = getCategoryInfo(cat);
|
|
74
|
-
console.log(chalk.yellow.bold(`${catInfo
|
|
83
|
+
console.log(chalk.yellow.bold(`${catInfo?.name ?? cat} (${grouped[cat].length})`));
|
|
75
84
|
|
|
76
85
|
for (const std of grouped[cat]) {
|
|
77
86
|
const name = std.skillName
|
package/src/commands/mcp.js
CHANGED
|
@@ -16,9 +16,8 @@ export function mcpCommand(program) {
|
|
|
16
16
|
mcp
|
|
17
17
|
.command('serve')
|
|
18
18
|
.description('Start MCP Design Standards Server (stdio transport)')
|
|
19
|
-
.
|
|
20
|
-
|
|
21
|
-
const server = new McpServer({ udsRoot: options.root });
|
|
19
|
+
.action(() => {
|
|
20
|
+
const server = new McpServer();
|
|
22
21
|
server.start();
|
|
23
22
|
// Log to stderr only — stdout is reserved for MCP JSON-RPC messages
|
|
24
23
|
process.stderr.write('UDS MCP Design Standards Server started (stdio)\n');
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `uds open-work` — the open-work-tracking reference checks (OWT-017 … OWT-028)
|
|
3
|
+
* as a command, so an adopter can run them from the npm package.
|
|
4
|
+
*
|
|
5
|
+
* This file holds no rules. The one body of them is
|
|
6
|
+
* `../utils/open-work-tracking.mjs`; this only turns commander's parsed
|
|
7
|
+
* arguments back into the argv that module's `main()` reads, so the command and
|
|
8
|
+
* `node scripts/check-open-work-tracking.mjs` cannot disagree.
|
|
9
|
+
*
|
|
10
|
+
* Exit codes are the module's and are not translated: 0 no violation, 1
|
|
11
|
+
* violation, 2 cannot decide (no structure found, git failed, or the checker's
|
|
12
|
+
* own self-test arms failed). 2 is NOT a pass. `process.exitCode` is set rather
|
|
13
|
+
* than calling `process.exit()`, so commander's post-action hook still runs.
|
|
14
|
+
*
|
|
15
|
+
* It is a reference decision procedure offered as evidence (OWT-015), not a
|
|
16
|
+
* gate, and its coverage is unknown and uncalibrated (OWT-011, OWT-016); the
|
|
17
|
+
* module prints both statements on every run.
|
|
18
|
+
*
|
|
19
|
+
* @module commands/open-work
|
|
20
|
+
*/
|
|
21
|
+
|
|
22
|
+
import { main } from '../utils/open-work-tracking.mjs';
|
|
23
|
+
import { readOpenWorkDeclarations, rootArguments, wordArguments, commandArguments, fieldWordArguments } from '../core/open-work-config.js';
|
|
24
|
+
|
|
25
|
+
/** Append `--name value` when the option was given. */
|
|
26
|
+
function withOption(argv, name, value) {
|
|
27
|
+
if (value !== undefined && value !== null) argv.push(name, String(value));
|
|
28
|
+
return argv;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
function run(argv) {
|
|
32
|
+
process.exitCode = main(argv);
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
/**
|
|
36
|
+
* What uds.project.yaml declares for open-work, or null after saying why the command stops.
|
|
37
|
+
* A file that cannot be read at all is a note and the command goes on without it (a project's
|
|
38
|
+
* unrelated YAML problem must not stop a check that never needed the file); a readable file whose
|
|
39
|
+
* open_work section is wrong stops it, because the check would otherwise run without what the
|
|
40
|
+
* project meant to declare and look cleaner than it is.
|
|
41
|
+
*/
|
|
42
|
+
function declarationsOrStop() {
|
|
43
|
+
const declared = readOpenWorkDeclarations(process.cwd()); // wire:declarations
|
|
44
|
+
if (declared.note) console.error(`[owt] NOTE: ${declared.note}`);
|
|
45
|
+
if (declared.error) {
|
|
46
|
+
console.error(`[owt] CANNOT DECIDE: ${declared.error}. Exit 2 is not a pass.`);
|
|
47
|
+
process.exitCode = 2;
|
|
48
|
+
return null;
|
|
49
|
+
}
|
|
50
|
+
return declared;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
/**
|
|
54
|
+
* uds open-work next-action [files...] [--root DIR] [--id-pattern RE] [--next-action-word WORD ...] [--command-word WORD ...] [--now DATE] [--stale-after DAYS] — OWT-019
|
|
55
|
+
* `--now` and `--stale-after` are what the fourth outcome (an asked-awaiting row, XSPEC-464) needs to show an age and to mark it old.
|
|
56
|
+
*/
|
|
57
|
+
export function openWorkNextActionCommand(files = [], options = {}) {
|
|
58
|
+
const declared = declarationsOrStop();
|
|
59
|
+
if (!declared) return;
|
|
60
|
+
const argv = ['next-action'];
|
|
61
|
+
withOption(argv, '--root', options.root);
|
|
62
|
+
withOption(argv, '--id-pattern', options.idPattern);
|
|
63
|
+
withOption(argv, '--now', options.now);
|
|
64
|
+
withOption(argv, '--stale-after', options.staleAfter);
|
|
65
|
+
const wordArgv = wordArguments(options.nextActionWord, declared.nextActionWords); // wire:next-action-words
|
|
66
|
+
const commandArgv = commandArguments(options.commandWord, declared.commandWords); // wire:next-action-command-words
|
|
67
|
+
argv.push(...fieldWordArguments('--asked-at-word', options.askedAtWord, declared.askedAtWords)); // wire:next-action-asked-at-words
|
|
68
|
+
argv.push(...fieldWordArguments('--waiting-for-word', options.waitingForWord, declared.waitingForWords));
|
|
69
|
+
process.exitCode = main([...argv, ...wordArgv, ...commandArgv, ...files]); // wire:next-action
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
/** uds open-work revision (--file PATH --base REV | --before FILE --after FILE) — OWT-018 */
|
|
73
|
+
export function openWorkRevisionCommand(options = {}) {
|
|
74
|
+
const argv = ['revision'];
|
|
75
|
+
withOption(argv, '--file', options.file);
|
|
76
|
+
withOption(argv, '--base', options.base);
|
|
77
|
+
withOption(argv, '--before', options.before);
|
|
78
|
+
withOption(argv, '--after', options.after);
|
|
79
|
+
run(argv);
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
/** uds open-work separation [files...] [--next-action-word WORD ...] — OWT-017 */
|
|
83
|
+
export function openWorkSeparationCommand(files = [], options = {}) {
|
|
84
|
+
const declared = declarationsOrStop();
|
|
85
|
+
if (!declared) return;
|
|
86
|
+
const wordArgv = wordArguments(options.nextActionWord, declared.nextActionWords); // wire:separation-words
|
|
87
|
+
process.exitCode = main(['separation', ...wordArgv, ...files]); // wire:separation
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
/**
|
|
91
|
+
* uds open-work waiting [files...] [--root DIR] [--root NAME=DIR ...] [--id-pattern RE] [--now DATE] [--asked-at-word WORD ...] [--waiting-for-word WORD ...] — OWT-020 to OWT-022, OWT-027/028.
|
|
92
|
+
* Calls the imported `main` itself rather than the shared `run()`: the line that carries this
|
|
93
|
+
* command into the checker is then its own, and cutting it silences exactly this command.
|
|
94
|
+
* `--root` repeats: a plain DIR is what relative paths resolve against (as before), NAME=DIR says where
|
|
95
|
+
* another project lives (and uds.project.yaml's open_work.projects says the same, without typing it).
|
|
96
|
+
*/
|
|
97
|
+
export function openWorkWaitingCommand(files = [], options = {}) {
|
|
98
|
+
const declared = declarationsOrStop();
|
|
99
|
+
if (!declared) return;
|
|
100
|
+
const argv = ['waiting'];
|
|
101
|
+
const rootArgv = rootArguments(options.root, declared.projects); // wire:roots
|
|
102
|
+
argv.push(...rootArgv);
|
|
103
|
+
withOption(argv, '--id-pattern', options.idPattern);
|
|
104
|
+
withOption(argv, '--now', options.now);
|
|
105
|
+
const commandArgv = commandArguments(options.commandWord, declared.commandWords); // wire:waiting-command-words
|
|
106
|
+
argv.push(...commandArgv);
|
|
107
|
+
argv.push(...fieldWordArguments('--asked-at-word', options.askedAtWord, declared.askedAtWords)); // wire:waiting-asked-at-words
|
|
108
|
+
argv.push(...fieldWordArguments('--waiting-for-word', options.waitingForWord, declared.waitingForWords)); // wire:waiting-waiting-for-words
|
|
109
|
+
process.exitCode = main([...argv, ...files]); // wire:waiting
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
/** uds open-work observations [files...] [--now DATE] [--stale-after DAYS] — OWT-023/024/025/026 (same reason as above) */
|
|
113
|
+
export function openWorkObservationsCommand(files = [], options = {}) {
|
|
114
|
+
const argv = ['observations'];
|
|
115
|
+
withOption(argv, '--now', options.now);
|
|
116
|
+
withOption(argv, '--stale-after', options.staleAfter);
|
|
117
|
+
process.exitCode = main([...argv, ...files]); // wire:observations
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
/** uds open-work self-test — run the checker's own arms and nothing else */
|
|
121
|
+
export function openWorkSelfTestCommand() {
|
|
122
|
+
run(['--self-test']);
|
|
123
|
+
}
|
|
@@ -21,6 +21,7 @@
|
|
|
21
21
|
|
|
22
22
|
import chalk from 'chalk';
|
|
23
23
|
import { select } from '@inquirer/prompts';
|
|
24
|
+
import { isPromptClosed } from '../utils/prompt-closed.js';
|
|
24
25
|
|
|
25
26
|
export const WORKFLOWS = [
|
|
26
27
|
{
|
|
@@ -64,6 +65,18 @@ export const WORKFLOWS = [
|
|
|
64
65
|
},
|
|
65
66
|
];
|
|
66
67
|
|
|
68
|
+
/** Print one workflow: its name, what it is for, and its numbered commands. */
|
|
69
|
+
function printWorkflow(workflow) {
|
|
70
|
+
console.log(chalk.bold(`\n${workflow.name}\n`));
|
|
71
|
+
console.log(chalk.gray(`${workflow.description}\n`));
|
|
72
|
+
|
|
73
|
+
for (let i = 0; i < workflow.steps.length; i++) {
|
|
74
|
+
const step = workflow.steps[i];
|
|
75
|
+
console.log(` ${chalk.cyan(`${i + 1}.`)} ${chalk.yellow(step.cmd)}`);
|
|
76
|
+
console.log(` ${chalk.gray(step.desc)}\n`);
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
|
|
67
80
|
/**
|
|
68
81
|
* Execute the quickstart command
|
|
69
82
|
*/
|
|
@@ -77,20 +90,23 @@ export async function quickstartCommand() {
|
|
|
77
90
|
description: w.description,
|
|
78
91
|
}));
|
|
79
92
|
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
console.log(
|
|
93
|
+
let selected;
|
|
94
|
+
try {
|
|
95
|
+
selected = await select({
|
|
96
|
+
message: 'Which workflow do you want to follow?',
|
|
97
|
+
choices,
|
|
98
|
+
});
|
|
99
|
+
} catch (promptError) {
|
|
100
|
+
if (!isPromptClosed(promptError)) throw promptError;
|
|
101
|
+
// Nothing can answer (not a terminal: an AI assistant, CI, a pipe). The guide's whole job is to show the commands, so show all of them
|
|
102
|
+
// rather than a stack trace and an exit code of 0.
|
|
103
|
+
console.log(chalk.gray('Nothing here can answer the question (not a terminal), so every workflow is shown.'));
|
|
104
|
+
for (const workflow of WORKFLOWS) printWorkflow(workflow);
|
|
105
|
+
console.log(chalk.gray('Tip: Run "uds quickstart" in a terminal to pick one workflow.\n'));
|
|
106
|
+
return;
|
|
93
107
|
}
|
|
94
108
|
|
|
109
|
+
printWorkflow(WORKFLOWS[selected]);
|
|
110
|
+
|
|
95
111
|
console.log(chalk.gray('Tip: Run each command in order. Use "uds quickstart" anytime to see this guide again.\n'));
|
|
96
112
|
}
|