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/utils/git-hooks.js
CHANGED
|
@@ -11,6 +11,7 @@
|
|
|
11
11
|
* adopters (asiaostrich-telemetry-server, asiaostrich-telemetry-client,
|
|
12
12
|
* machine-setup): all three have `.husky/pre-commit` calling `npx uds check`,
|
|
13
13
|
* none has `core.hooksPath` set, and the hook has never once run.
|
|
14
|
+
* (That `npx uds check` form was itself replaced — see buildPreCommitBlock.)
|
|
14
15
|
*
|
|
15
16
|
* Fix: set `core.hooksPath` directly ourselves. This is exactly what husky's
|
|
16
17
|
* own `index.js` does internally (verified against husky ^9.1.7's source:
|
|
@@ -94,7 +95,7 @@ export function wireGitHooksPath(projectPath, targetRelDir) {
|
|
|
94
95
|
return {
|
|
95
96
|
wired: false,
|
|
96
97
|
reason: `git core.hooksPath is already set to "${configured}"`,
|
|
97
|
-
hint: `UDS will not override an existing core.hooksPath. Confirm the hook script there also runs \`
|
|
98
|
+
hint: `UDS will not override an existing core.hooksPath. Confirm the hook script there also runs \`universal-dev-standards check\` (the installed CLI — not the short name "uds", which on the npm registry is an unrelated package), or switch it yourself: git config --local core.hooksPath ${targetRelDir}`
|
|
98
99
|
};
|
|
99
100
|
}
|
|
100
101
|
|
|
@@ -107,7 +108,7 @@ export function wireGitHooksPath(projectPath, targetRelDir) {
|
|
|
107
108
|
return {
|
|
108
109
|
wired: false,
|
|
109
110
|
reason: '.git/hooks/pre-commit already exists',
|
|
110
|
-
hint: 'UDS will not overwrite or bypass an existing .git/hooks/pre-commit. Add "
|
|
111
|
+
hint: 'UDS will not overwrite or bypass an existing .git/hooks/pre-commit. Add a "universal-dev-standards check" line to it manually (it needs the UDS CLI installed in this project or on PATH), or remove it and re-run `uds init`.'
|
|
111
112
|
};
|
|
112
113
|
}
|
|
113
114
|
|
|
@@ -126,10 +127,133 @@ export function wireGitHooksPath(projectPath, targetRelDir) {
|
|
|
126
127
|
}
|
|
127
128
|
}
|
|
128
129
|
|
|
129
|
-
|
|
130
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
131
|
+
// What UDS writes into `.husky/pre-commit`.
|
|
132
|
+
//
|
|
133
|
+
// 🔴 This used to be the single line `npx uds check`. `npx` resolves a bare
|
|
134
|
+
// command name from node_modules/.bin and PATH first, and only when neither has
|
|
135
|
+
// it does it go to the npm registry — and the registry package named `uds` is
|
|
136
|
+
// NOT this project (it is an unrelated package by another maintainer, no
|
|
137
|
+
// `bin`, last published 2022). So a clone with no UDS installed had a commit
|
|
138
|
+
// hook that asked npm for a stranger's package by name. It failed today only
|
|
139
|
+
// because that package has no executable; the day its owner publishes one with a
|
|
140
|
+
// `uds` bin, every adopter's every commit runs the stranger's code.
|
|
141
|
+
//
|
|
142
|
+
// Measured 2026-09-30 against a local fake registry that logs each request
|
|
143
|
+
// (npm 10.9.9, 11.20.0, 12.1.0 — identical): `npx --no-install uds` STILL fetches
|
|
144
|
+
// the package metadata for `uds` (GET /uds), so `--no-install` is not a fix; and
|
|
145
|
+
// `npx --no-install --package=universal-dev-standards uds` does not find a
|
|
146
|
+
// GLOBAL install at all (it goes to the registry for our own name and fails).
|
|
147
|
+
// Neither is usable, so the hook does not involve npm at all: it looks in this
|
|
148
|
+
// project's node_modules/.bin, then on PATH, and it looks for the bin named
|
|
149
|
+
// after the full package name — `universal-dev-standards` is a name only this
|
|
150
|
+
// project can publish, `uds` is a name anyone's package can also claim.
|
|
151
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
152
|
+
|
|
153
|
+
/** First line of the block UDS writes (also the marker older UDS versions wrote). */
|
|
154
|
+
export const UDS_HOOK_MARKER = '# UDS Standard Check';
|
|
155
|
+
/** Last line of the block — lets uninstall remove the whole block, not guess line by line. */
|
|
156
|
+
export const UDS_HOOK_END_MARKER = '# End UDS Standard Check';
|
|
157
|
+
/** The bin every UDS release has shipped since the rename; named after the package on purpose. */
|
|
158
|
+
export const UDS_BIN_NAME = 'universal-dev-standards';
|
|
159
|
+
/** A hook line that runs the UDS check — the old short form or the current full-name form. */
|
|
160
|
+
export const UDS_CHECK_COMMAND_RE = /\b(?:uds|universal-dev-standards)\s+check\b/;
|
|
161
|
+
|
|
162
|
+
/**
|
|
163
|
+
* Any place a hook script runs the bare name `uds` through a package runner
|
|
164
|
+
* (npx, bunx, pnpm dlx, yarn dlx, npm exec ...). Broader than the two exact lines UDS
|
|
165
|
+
* ever wrote (see legacy-hook-migration.js): this finds lines to TELL the
|
|
166
|
+
* adopter about, not lines UDS may change.
|
|
167
|
+
*/
|
|
168
|
+
export const BARE_UDS_RUNNER_RE = /\b(?:npx|bunx|pnpx|pnpm\s+dlx|yarn\s+dlx|npm\s+exec|npm\s+x)\s+(?:-\S+\s+)*uds\b/;
|
|
169
|
+
|
|
170
|
+
/** Does this hook script still run the bare name `uds` through a package runner? */
|
|
171
|
+
export function hasBareUdsRunner(content) {
|
|
172
|
+
return typeof content === 'string' && content.split('\n').some((l) => BARE_UDS_RUNNER_RE.test(l));
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
/** Does hook script `content` run the UDS check, in either the old or the current form? */
|
|
176
|
+
export function hookRunsUdsCheck(content) {
|
|
177
|
+
return typeof content === 'string' && UDS_CHECK_COMMAND_RE.test(content);
|
|
178
|
+
}
|
|
179
|
+
|
|
180
|
+
/**
|
|
181
|
+
* The block `uds init` appends to `.husky/pre-commit` (and `uds update` swaps in
|
|
182
|
+
* for the old one-liner). POSIX sh; runs in git-bash on Windows.
|
|
183
|
+
*
|
|
184
|
+
* - The subshell keeps the PATH change from leaking into the adopter's own
|
|
185
|
+
* commands in the same hook file.
|
|
186
|
+
* - `|| exit $?` makes both outcomes stop the commit even when the adopter has
|
|
187
|
+
* put more commands after this block. Without it the "not installed" branch
|
|
188
|
+
* would be a silent skip of the check, which is what this must never be.
|
|
189
|
+
* - Not installed: say what is missing and how to fix it, exit non-zero. It
|
|
190
|
+
* neither skips the check nor downloads anything.
|
|
191
|
+
*
|
|
192
|
+
* @param {{args?: string, hookFile?: string}} [opts]
|
|
193
|
+
* args — extra arguments to keep on the check command
|
|
194
|
+
* (e.g. `--standard checkin-standards`, which older UDS versions wrote).
|
|
195
|
+
* hookFile — the file the block is written into, named in the "blocked" message so
|
|
196
|
+
* it points at the file the adopter actually has (default `.husky/pre-commit`;
|
|
197
|
+
* the native hook passes `.git/hooks/pre-commit`).
|
|
198
|
+
* @returns {string} the block, LF line endings, ending with a newline
|
|
199
|
+
*/
|
|
200
|
+
export function buildPreCommitBlock({ args = '', hookFile = '.husky/pre-commit' } = {}) {
|
|
201
|
+
const cmd = args ? `${UDS_BIN_NAME} check ${args}` : `${UDS_BIN_NAME} check`;
|
|
202
|
+
return [
|
|
203
|
+
UDS_HOOK_MARKER,
|
|
204
|
+
'# Runs the UDS CLI installed in this project (node_modules/.bin) or on PATH.',
|
|
205
|
+
'# It never asks npm to fetch anything: the short name "uds" on the npm registry',
|
|
206
|
+
'# belongs to an unrelated package, and npx would download and run it.',
|
|
207
|
+
'(',
|
|
208
|
+
' PATH="$PWD/node_modules/.bin:$PATH"',
|
|
209
|
+
` if command -v ${UDS_BIN_NAME} >/dev/null 2>&1; then`,
|
|
210
|
+
` ${cmd}`,
|
|
211
|
+
' exit $?',
|
|
212
|
+
' fi',
|
|
213
|
+
` echo "[UDS] Pre-commit check cannot run: the UDS CLI (${UDS_BIN_NAME}) is not installed." >&2`,
|
|
214
|
+
` echo "[UDS] Install it: npm install --save-dev ${UDS_BIN_NAME} (or: npm install -g ${UDS_BIN_NAME})" >&2`,
|
|
215
|
+
` echo "[UDS] This commit is blocked until it is installed, or until you remove this block from ${hookFile}." >&2`,
|
|
216
|
+
' exit 1',
|
|
217
|
+
') || exit $?',
|
|
218
|
+
UDS_HOOK_END_MARKER,
|
|
219
|
+
''
|
|
220
|
+
].join('\n');
|
|
221
|
+
}
|
|
222
|
+
|
|
223
|
+
/**
|
|
224
|
+
* Remove the block buildPreCommitBlock() writes — from the marker line through
|
|
225
|
+
* the end-marker line, inclusive — and nothing else. A block whose end marker is
|
|
226
|
+
* gone (the adopter cut into it) is left alone: what remains of it is no longer
|
|
227
|
+
* provably UDS's, and the caller's line-level fallback deals with the lines it can name.
|
|
228
|
+
* @returns {{content: string, removed: boolean}}
|
|
229
|
+
*/
|
|
230
|
+
export function stripUdsHookBlock(content) {
|
|
231
|
+
const lines = content.split('\n');
|
|
232
|
+
const out = [];
|
|
233
|
+
let removed = false;
|
|
234
|
+
for (let i = 0; i < lines.length; i++) {
|
|
235
|
+
if (lines[i].trim() === UDS_HOOK_MARKER) {
|
|
236
|
+
let end = -1;
|
|
237
|
+
for (let j = i + 1; j < lines.length; j++) {
|
|
238
|
+
if (lines[j].trim() === UDS_HOOK_END_MARKER) { end = j; break; }
|
|
239
|
+
// Another marker before an end marker means this block is not well-formed.
|
|
240
|
+
if (lines[j].trim() === UDS_HOOK_MARKER) break;
|
|
241
|
+
}
|
|
242
|
+
if (end !== -1) {
|
|
243
|
+
i = end;
|
|
244
|
+
removed = true;
|
|
245
|
+
continue;
|
|
246
|
+
}
|
|
247
|
+
}
|
|
248
|
+
out.push(lines[i]);
|
|
249
|
+
}
|
|
250
|
+
return { content: out.join('\n'), removed };
|
|
251
|
+
}
|
|
252
|
+
|
|
253
|
+
/** Does `filePath` contain a hook line UDS manages (the old one-liner or the current block)? */
|
|
130
254
|
function hasUdsMarker(filePath) {
|
|
131
255
|
try {
|
|
132
|
-
return readFileSync(filePath, 'utf-8')
|
|
256
|
+
return hookRunsUdsCheck(readFileSync(filePath, 'utf-8'));
|
|
133
257
|
} catch {
|
|
134
258
|
return false;
|
|
135
259
|
}
|
|
@@ -225,7 +349,7 @@ export function stripLegacyHuskyShLine(content) {
|
|
|
225
349
|
* @param {string} projectPath
|
|
226
350
|
* @returns {{relevant: boolean, wired?: boolean, hookFile?: string,
|
|
227
351
|
* configuredHooksPath?: string|null, effectiveHooksDir?: string|null,
|
|
228
|
-
* legacyV8?: boolean, missingShebang?: boolean}}
|
|
352
|
+
* legacyV8?: boolean, missingShebang?: boolean, legacyBareUds?: boolean}}
|
|
229
353
|
* `relevant: false` means there is nothing UDS-managed to report on (no
|
|
230
354
|
* hook file, or hooks-dir could not be determined — never guess "unwired"
|
|
231
355
|
* from a failed lookup).
|
|
@@ -252,6 +376,13 @@ export function checkPreCommitHookWiring(projectPath) {
|
|
|
252
376
|
try { return !hasShebang(readFileSync(managedPath, 'utf-8')); } catch { return false; }
|
|
253
377
|
})();
|
|
254
378
|
|
|
379
|
+
// Independent of wiring, like missingShebang: the file can be wired and still ask
|
|
380
|
+
// npm for the bare name `uds` (see buildPreCommitBlock). Only the husky file is
|
|
381
|
+
// examined — that is the one UDS wrote the old one-liner into.
|
|
382
|
+
const legacyBareUds = hasHuskyHook && (() => {
|
|
383
|
+
try { return hasBareUdsRunner(readFileSync(huskyHookPath, 'utf-8')); } catch { return false; }
|
|
384
|
+
})();
|
|
385
|
+
|
|
255
386
|
const effectiveFile = join(effectiveHooksDir, 'pre-commit');
|
|
256
387
|
let wired = false;
|
|
257
388
|
if (existsSync(effectiveFile)) {
|
|
@@ -264,7 +395,7 @@ export function checkPreCommitHookWiring(projectPath) {
|
|
|
264
395
|
}
|
|
265
396
|
}
|
|
266
397
|
|
|
267
|
-
if (wired) return { relevant: true, wired: true, hookFile, missingShebang };
|
|
398
|
+
if (wired) return { relevant: true, wired: true, hookFile, missingShebang, legacyBareUds };
|
|
268
399
|
|
|
269
400
|
const legacyV8 = hasHuskyHook && (() => {
|
|
270
401
|
try { return hasLegacyHuskyShLine(readFileSync(huskyHookPath, 'utf-8')); } catch { return false; }
|
|
@@ -277,6 +408,7 @@ export function checkPreCommitHookWiring(projectPath) {
|
|
|
277
408
|
configuredHooksPath: getLocalHooksPathConfig(projectPath),
|
|
278
409
|
effectiveHooksDir,
|
|
279
410
|
legacyV8,
|
|
280
|
-
missingShebang
|
|
411
|
+
missingShebang,
|
|
412
|
+
legacyBareUds
|
|
281
413
|
};
|
|
282
414
|
}
|
package/src/utils/hasher.js
CHANGED
|
@@ -532,6 +532,42 @@ export function computeIntegrationBlockHash(filePath) {
|
|
|
532
532
|
}
|
|
533
533
|
}
|
|
534
534
|
|
|
535
|
+
/**
|
|
536
|
+
* Hash everything in an integration file that is OUTSIDE the UDS marker block.
|
|
537
|
+
*
|
|
538
|
+
* `computeIntegrationBlockHash` answers "did anyone edit what UDS manages?".
|
|
539
|
+
* This answers the opposite question, which `uds uninstall` needs: "is anything
|
|
540
|
+
* outside the block something other than what UDS itself wrote?". A file UDS
|
|
541
|
+
* created from nothing (AGENTS.md's `# AGENTS.md` / `> Auto-generated by ...`
|
|
542
|
+
* header and its trailing sections, CLAUDE.md's leading guidance) has plenty of
|
|
543
|
+
* text outside the markers, and that text alone cannot tell "generated by UDS"
|
|
544
|
+
* from "typed by the adopter" — only a hash recorded when UDS created the file,
|
|
545
|
+
* compared with the same hash now, can.
|
|
546
|
+
*
|
|
547
|
+
* Line endings are normalized (same reason as every other hash here) and each
|
|
548
|
+
* side is trimmed, so an editor adding a trailing newline is not "a user edit".
|
|
549
|
+
*
|
|
550
|
+
* @param {string} filePath - Absolute file path
|
|
551
|
+
* @returns {{hash: string, size: number}|null} null when the file cannot be read,
|
|
552
|
+
* has no marker block, or has an ambiguous marker pair (no proof is available)
|
|
553
|
+
*/
|
|
554
|
+
export function computeOutsideBlockHash(filePath) {
|
|
555
|
+
try {
|
|
556
|
+
const content = normalizeLineEndings(readFileSync(filePath, 'utf-8'));
|
|
557
|
+
const { before, blockContent, after } = extractBlockContent(content, detectFormat(filePath));
|
|
558
|
+
if (!blockContent) return null;
|
|
559
|
+
const outside = `${before.trim()}\n\u0000\n${after.trim()}`;
|
|
560
|
+
return {
|
|
561
|
+
hash: `sha256:${createHash('sha256').update(outside).digest('hex')}`,
|
|
562
|
+
size: Buffer.byteLength(outside, 'utf-8')
|
|
563
|
+
};
|
|
564
|
+
} catch {
|
|
565
|
+
// Includes AmbiguousMarkerError: with two marker pairs there is no single
|
|
566
|
+
// "outside", so there is nothing to prove anything with.
|
|
567
|
+
return null;
|
|
568
|
+
}
|
|
569
|
+
}
|
|
570
|
+
|
|
535
571
|
/**
|
|
536
572
|
* Compare integration block hash with stored hash info
|
|
537
573
|
* @param {string} filePath - Absolute file path
|
|
@@ -177,20 +177,26 @@ export function calculateConsistency(projectPath) {
|
|
|
177
177
|
}
|
|
178
178
|
|
|
179
179
|
/**
|
|
180
|
-
* Calculate coverage score
|
|
180
|
+
* Calculate coverage score — how many of the two check scripts each installed standard can
|
|
181
|
+
* have (`scripts/check-<id>.sh`, `scripts/check-<id>-sync.sh`) are present.
|
|
182
|
+
*
|
|
183
|
+
* XSPEC-444 R5: this used to report `details.has_tests` and add it into the sum, but
|
|
184
|
+
* `hasTests` was declared as 0 and never incremented anywhere — a number that was always 0 and
|
|
185
|
+
* looked like a measurement of whether the standards have tests. It is removed rather than
|
|
186
|
+
* faked. The SCORE is unchanged: the denominator was already two per standard, which is the
|
|
187
|
+
* two script kinds above, so no project's coverage score moves.
|
|
181
188
|
* @param {string} projectPath
|
|
182
189
|
* @param {string[]} standardIds
|
|
183
190
|
* @returns {{ score: number, details: object }}
|
|
184
191
|
*/
|
|
185
192
|
export function calculateCoverage(projectPath, standardIds) {
|
|
186
193
|
if (!standardIds || standardIds.length === 0) {
|
|
187
|
-
return { score: 0, details: { has_check_script: 0,
|
|
194
|
+
return { score: 0, details: { has_check_script: 0, total: 0 } };
|
|
188
195
|
}
|
|
189
196
|
|
|
190
197
|
// Check for check scripts matching standard names
|
|
191
198
|
const scriptsDir = join(projectPath, 'scripts');
|
|
192
199
|
let hasCheckScript = 0;
|
|
193
|
-
let hasTests = 0;
|
|
194
200
|
|
|
195
201
|
for (const id of standardIds) {
|
|
196
202
|
const scriptName = `check-${id}.sh`;
|
|
@@ -204,16 +210,13 @@ export function calculateCoverage(projectPath, standardIds) {
|
|
|
204
210
|
}
|
|
205
211
|
}
|
|
206
212
|
|
|
207
|
-
const ratio = standardIds.length
|
|
208
|
-
? (hasCheckScript + hasTests) / (standardIds.length * 2)
|
|
209
|
-
: 0;
|
|
213
|
+
const ratio = hasCheckScript / (standardIds.length * 2);
|
|
210
214
|
const score = Math.round(Math.min(ratio * 100, 100));
|
|
211
215
|
|
|
212
216
|
return {
|
|
213
217
|
score,
|
|
214
218
|
details: {
|
|
215
219
|
has_check_script: hasCheckScript,
|
|
216
|
-
has_tests: hasTests,
|
|
217
220
|
total: standardIds.length
|
|
218
221
|
}
|
|
219
222
|
};
|
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Which names in `manifest.skills.names` / `manifest.commands.names` UDS can still vouch for.
|
|
3
|
+
* // implements XSPEC-456 R4
|
|
4
|
+
*
|
|
5
|
+
* XSPEC-454 R2 cleaned `skillHashes` and `commandHashes` and left these two lists alone, on the
|
|
6
|
+
* reasoning that an over-long list is harmless. It is not: after `uds update --apply --skills` removed
|
|
7
|
+
* the `_shared`, `agents`, `ai`, `tools` and `workflows` folders an old CLI had copied into the skills
|
|
8
|
+
* folder, the manifest still listed all five as installed skills (61 names for 56 skills), which
|
|
9
|
+
* contradicted both the disk and the release notes' claim that the records were cleaned.
|
|
10
|
+
*
|
|
11
|
+
* The rule is the one XSPEC-454 R2 uses for the hash records: **what UDS can vouch for stays**.
|
|
12
|
+
* - a skill (command) name stays only if UDS ships a skill (command) of that name;
|
|
13
|
+
* - when asked to (`checkDisk`), only if it is also present in one of the places the manifest says
|
|
14
|
+
* it was installed. That second test is skipped when it cannot be made (no install location
|
|
15
|
+
* recorded, or none of the recorded folders exists): a name list is never emptied because the
|
|
16
|
+
* tool could not find where to look.
|
|
17
|
+
*
|
|
18
|
+
* Every manifest field that records skill or command NAMES, and what handles it:
|
|
19
|
+
* skills.names -> this module (skills)
|
|
20
|
+
* commands.names -> this module (commands)
|
|
21
|
+
* skillHashes -> utils/skill-hash-ownership.js (XSPEC-454 R2; the name is the 3rd path segment)
|
|
22
|
+
* commandHashes -> utils/command-hash-ownership.js (XSPEC-454 R2; the name is the file stem)
|
|
23
|
+
* `skills.installations` / `commands.installations` record tools and levels, not names, and
|
|
24
|
+
* `installedArtifacts` records only integration files and created directories.
|
|
25
|
+
*
|
|
26
|
+
* @module utils/installed-names-ownership
|
|
27
|
+
*/
|
|
28
|
+
|
|
29
|
+
import { existsSync } from 'fs';
|
|
30
|
+
import { join } from 'path';
|
|
31
|
+
import { getAvailableSkillNames, getAvailableCommandNames } from './skills-installer.js';
|
|
32
|
+
import { MARKETPLACE_NAMES_SENTINEL } from '../core/marketplace-sentinel.js';
|
|
33
|
+
import { getSkillsDirForAgent, getCommandsDirForAgent, getCommandFileExtension } from '../config/ai-agent-paths.js';
|
|
34
|
+
|
|
35
|
+
/** Below these sizes the source tree did not load; never read that as "UDS ships nothing". */
|
|
36
|
+
const MIN_SHIPPED = 10;
|
|
37
|
+
|
|
38
|
+
/** `{ agent, level }` for every recorded installation (strings are legacy project-level entries). */
|
|
39
|
+
function installationsOf(section) {
|
|
40
|
+
return (section?.installations || [])
|
|
41
|
+
.map((entry) => (typeof entry === 'string'
|
|
42
|
+
? { agent: entry, level: 'project' }
|
|
43
|
+
: { agent: entry?.agent, level: entry?.level || 'project' }))
|
|
44
|
+
.filter((entry) => entry.agent);
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
/** Folders a skill of the recorded installations would live in. Empty when the manifest does not say. */
|
|
48
|
+
function skillFolders(manifest, projectPath) {
|
|
49
|
+
const dirs = installationsOf(manifest.skills)
|
|
50
|
+
.map(({ agent, level }) => getSkillsDirForAgent(agent, level, projectPath))
|
|
51
|
+
.filter(Boolean);
|
|
52
|
+
if (dirs.length > 0) return dirs;
|
|
53
|
+
// A legacy manifest records no installations, only where the skills went.
|
|
54
|
+
const location = manifest.skills?.location;
|
|
55
|
+
if (location === 'project' || location === 'user') {
|
|
56
|
+
const dir = getSkillsDirForAgent('claude-code', location, projectPath);
|
|
57
|
+
return dir ? [dir] : [];
|
|
58
|
+
}
|
|
59
|
+
return [];
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
/** `[folder, extension]` pairs where a command of the recorded installations would live. */
|
|
63
|
+
function commandFolders(manifest, projectPath) {
|
|
64
|
+
return installationsOf(manifest.commands)
|
|
65
|
+
.map(({ agent, level }) => [getCommandsDirForAgent(agent, level, projectPath), getCommandFileExtension(agent)])
|
|
66
|
+
.filter(([dir]) => Boolean(dir));
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
function prune(names, keep) {
|
|
70
|
+
const kept = [];
|
|
71
|
+
const dropped = [];
|
|
72
|
+
for (const name of names) (keep(name) ? kept : dropped).push(name);
|
|
73
|
+
return { kept, dropped: dropped.sort() };
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
/**
|
|
77
|
+
* Drop the names in `manifest.skills.names` that UDS cannot vouch for. Mutates `manifest`.
|
|
78
|
+
*
|
|
79
|
+
* @param {Object} manifest
|
|
80
|
+
* @param {string} projectPath
|
|
81
|
+
* @param {Object} [options]
|
|
82
|
+
* @param {boolean} [options.checkDisk=false] - also require the skill to be present where it was installed
|
|
83
|
+
* @param {Set<string>} [options.shipped] - Injection point for tests; defaults to the skills this CLI ships
|
|
84
|
+
* @returns {string[]} The names dropped, sorted
|
|
85
|
+
*/
|
|
86
|
+
export function pruneForeignSkillNames(manifest, projectPath, { checkDisk = false, shipped = new Set(getAvailableSkillNames()) } = {}) {
|
|
87
|
+
const names = manifest?.skills?.names;
|
|
88
|
+
if (!Array.isArray(names) || shipped.size < MIN_SHIPPED) return [];
|
|
89
|
+
// Marketplace installs record a sentinel instead of names; there is nothing to prune.
|
|
90
|
+
if (names.includes(MARKETPLACE_NAMES_SENTINEL)) return [];
|
|
91
|
+
|
|
92
|
+
const dirs = checkDisk ? skillFolders(manifest, projectPath) : [];
|
|
93
|
+
const diskTestPossible = dirs.some((dir) => existsSync(dir));
|
|
94
|
+
const { kept, dropped } = prune(names, (name) =>
|
|
95
|
+
shipped.has(name) && (!diskTestPossible || dirs.some((dir) => existsSync(join(dir, name)))));
|
|
96
|
+
if (dropped.length > 0) manifest.skills.names = kept;
|
|
97
|
+
return dropped;
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
/**
|
|
101
|
+
* Drop the names in `manifest.commands.names` that UDS cannot vouch for. Mutates `manifest`.
|
|
102
|
+
* Same contract as {@link pruneForeignSkillNames}.
|
|
103
|
+
*/
|
|
104
|
+
export function pruneForeignCommandNames(manifest, projectPath, { checkDisk = false, shipped = new Set(getAvailableCommandNames()) } = {}) {
|
|
105
|
+
const names = manifest?.commands?.names;
|
|
106
|
+
if (!Array.isArray(names) || shipped.size < MIN_SHIPPED) return [];
|
|
107
|
+
|
|
108
|
+
const places = checkDisk ? commandFolders(manifest, projectPath) : [];
|
|
109
|
+
const diskTestPossible = places.some(([dir]) => existsSync(dir));
|
|
110
|
+
const { kept, dropped } = prune(names, (name) =>
|
|
111
|
+
shipped.has(name) && (!diskTestPossible || places.some(([dir, ext]) => existsSync(join(dir, `${name}${ext}`)))));
|
|
112
|
+
if (dropped.length > 0) manifest.commands.names = kept;
|
|
113
|
+
return dropped;
|
|
114
|
+
}
|
|
@@ -172,20 +172,22 @@ const COMMIT_TYPE_TEMPLATES = {
|
|
|
172
172
|
format: '<type>(<scope>): <subject>',
|
|
173
173
|
formatNote: 'English types for maximum tool compatibility'
|
|
174
174
|
},
|
|
175
|
+
// XSPEC-475 OQ1: English types, Traditional Chinese subject. It used to list Chinese types (功能, 修正, ...), which the
|
|
176
|
+
// commit-message simulator could not read and no adopter's commitlint type-enum allowed.
|
|
175
177
|
'traditional-chinese': {
|
|
176
178
|
types: [
|
|
177
|
-
{ type: '
|
|
178
|
-
{ type: '
|
|
179
|
-
{ type: '
|
|
180
|
-
{ type: '
|
|
181
|
-
{ type: '
|
|
182
|
-
{ type: '
|
|
183
|
-
{ type: '
|
|
184
|
-
{ type: '
|
|
185
|
-
{ type: '
|
|
179
|
+
{ type: 'feat', description: '新功能', example: 'feat(auth): 新增 OAuth2 登入' },
|
|
180
|
+
{ type: 'fix', description: '錯誤修正', example: 'fix(api): 處理空值回應' },
|
|
181
|
+
{ type: 'docs', description: '文件更新', example: 'docs(readme): 更新安裝指南' },
|
|
182
|
+
{ type: 'style', description: '格式調整', example: 'style(lint): 修正縮排' },
|
|
183
|
+
{ type: 'refactor', description: '程式碼重構', example: 'refactor(user): 抽取驗證邏輯' },
|
|
184
|
+
{ type: 'test', description: '測試相關', example: 'test(cart): 新增結帳測試' },
|
|
185
|
+
{ type: 'chore', description: '維護任務', example: 'chore(deps): 更新套件' },
|
|
186
|
+
{ type: 'perf', description: '效能改善', example: 'perf(query): 優化資料庫查詢' },
|
|
187
|
+
{ type: 'ci', description: '持續整合', example: 'ci(github): 新增部署流程' }
|
|
186
188
|
],
|
|
187
|
-
format: '
|
|
188
|
-
formatNote: '
|
|
189
|
+
format: '<type>(<scope>): <主旨>',
|
|
190
|
+
formatNote: '類型使用英文(與 english 選項相同,不可用中文類型),主旨與本文使用繁體中文,範圍可使用英文或中文'
|
|
189
191
|
},
|
|
190
192
|
bilingual: {
|
|
191
193
|
types: [
|
|
@@ -233,10 +235,10 @@ function generateCommitTypesTable(outputLanguage, format = 'markdown') {
|
|
|
233
235
|
|
|
234
236
|
if (format === 'markdown') {
|
|
235
237
|
if (outputLanguage === 'traditional-chinese') {
|
|
236
|
-
lines.push('| 類型 |
|
|
237
|
-
lines.push('
|
|
238
|
+
lines.push('| 類型 | 說明 | 範例 |');
|
|
239
|
+
lines.push('|------|------|------|');
|
|
238
240
|
for (const t of template.types) {
|
|
239
|
-
lines.push(`| \`${t.type}\` | ${t.
|
|
241
|
+
lines.push(`| \`${t.type}\` | ${t.description} | ${t.example} |`);
|
|
240
242
|
}
|
|
241
243
|
} else if (outputLanguage === 'bilingual') {
|
|
242
244
|
lines.push('| Type | EN Description | 中文說明 | Example |');
|
|
@@ -263,7 +265,7 @@ function generateCommitTypesTable(outputLanguage, format = 'markdown') {
|
|
|
263
265
|
// Plaintext format
|
|
264
266
|
if (outputLanguage === 'traditional-chinese') {
|
|
265
267
|
for (const t of template.types) {
|
|
266
|
-
lines.push(`- ${t.type}
|
|
268
|
+
lines.push(`- ${t.type}: ${t.description}`);
|
|
267
269
|
}
|
|
268
270
|
} else if (outputLanguage === 'bilingual' || outputLanguage === 'bilingual-zhcn') {
|
|
269
271
|
for (const t of template.types) {
|
|
@@ -2625,12 +2627,12 @@ function generateOutputLanguageDirective(outputLanguage, language) {
|
|
|
2625
2627
|
|
|
2626
2628
|
if (outputLanguage === 'traditional-chinese') {
|
|
2627
2629
|
if (language === 'zh-tw') {
|
|
2628
|
-
return '## 提交訊息語言\n
|
|
2630
|
+
return '## 提交訊息語言\n所有提交訊息的主旨與本文必須使用**繁體中文**撰寫;類型維持英文(feat、fix、docs 等)。\n格式:`<type>(<scope>): <主旨>`';
|
|
2629
2631
|
}
|
|
2630
2632
|
if (language === 'zh-cn') {
|
|
2631
|
-
return '## 提交消息语言\n
|
|
2633
|
+
return '## 提交消息语言\n所有提交消息的主旨与正文必须使用**繁体中文**撰写;类型保持英文(feat、fix、docs 等)。\n格式:`<type>(<scope>): <主旨>`';
|
|
2632
2634
|
}
|
|
2633
|
-
return '## Commit Message Language\nWrite all commit messages in **Traditional Chinese (繁體中文)
|
|
2635
|
+
return '## Commit Message Language\nWrite the subject and body of all commit messages in **Traditional Chinese (繁體中文)**; keep the type English (feat, fix, docs, ...).\nFormat: `<type>(<scope>): <主旨>`';
|
|
2634
2636
|
}
|
|
2635
2637
|
|
|
2636
2638
|
if (outputLanguage === 'simplified-chinese') {
|
|
@@ -3202,8 +3204,14 @@ export function writeIntegrationFile(tool, config, projectPath) {
|
|
|
3202
3204
|
try {
|
|
3203
3205
|
let content = generateIntegrationContent({ ...config, tool });
|
|
3204
3206
|
|
|
3207
|
+
// Whether this call CREATES the file (as opposed to merging into one that was
|
|
3208
|
+
// already there). Only a file UDS created from nothing can later be proven
|
|
3209
|
+
// to be wholly UDS's — see core/install-records.js. Taken from the existence
|
|
3210
|
+
// check that already gates the merge below, before anything is written.
|
|
3211
|
+
const created = !existsSync(filePath);
|
|
3212
|
+
|
|
3205
3213
|
// Handle merge if file exists
|
|
3206
|
-
if (
|
|
3214
|
+
if (!created) {
|
|
3207
3215
|
const existingContent = readFileSync(filePath, 'utf-8');
|
|
3208
3216
|
|
|
3209
3217
|
if (config.mergeStrategy) {
|
|
@@ -3242,6 +3250,7 @@ export function writeIntegrationFile(tool, config, projectPath) {
|
|
|
3242
3250
|
success: true,
|
|
3243
3251
|
path: fileName, // Return relative path for consistency
|
|
3244
3252
|
absolutePath: filePath,
|
|
3253
|
+
created,
|
|
3245
3254
|
blockHashInfo // Contains: blockHash, blockSize, fullHash, fullSize
|
|
3246
3255
|
};
|
|
3247
3256
|
} catch (error) {
|
|
@@ -3584,8 +3593,8 @@ export function parseStandardsIndexCount(content) {
|
|
|
3584
3593
|
export function wrapWithMarkers(content, format) {
|
|
3585
3594
|
const markers = UDS_MARKERS[format] || UDS_MARKERS.markdown;
|
|
3586
3595
|
const warning = format === 'plaintext'
|
|
3587
|
-
? '# WARNING: This block is managed by UDS
|
|
3588
|
-
: '<!-- WARNING: This block is managed by UDS
|
|
3596
|
+
? '# WARNING: This block is managed by UDS. DO NOT manually edit. Use \'npx universal-dev-standards init\' or \'npx universal-dev-standards update\' to modify.'
|
|
3597
|
+
: '<!-- WARNING: This block is managed by UDS. DO NOT manually edit. Use \'npx universal-dev-standards init\' or \'npx universal-dev-standards update\' to modify. -->';
|
|
3589
3598
|
// 冪等:warning 位於 markers **內部**,而 extractMarkedContent 取出的內容也含它,
|
|
3590
3599
|
// 於是重新包裝會疊出第二份(dev-platform CLAUDE.md 實測 178/179 兩行完全相同)。
|
|
3591
3600
|
// 這裡先剝掉內容開頭既有的 warning,不論上游哪條路徑造成都能修掉。
|
|
@@ -3949,7 +3958,7 @@ export function generateAgentsMdSummary(config = {}) {
|
|
|
3949
3958
|
blockLines.push(`- \`${dir}/${filename}\` — ${filename.replace(suffix, '')}`);
|
|
3950
3959
|
}
|
|
3951
3960
|
} else {
|
|
3952
|
-
blockLines.push('No standards installed yet. Run `npx
|
|
3961
|
+
blockLines.push('No standards installed yet. Run `npx universal-dev-standards init` to install.');
|
|
3953
3962
|
}
|
|
3954
3963
|
|
|
3955
3964
|
lines.push(wrapWithMarkers(blockLines.join('\n'), 'markdown'));
|
|
@@ -3976,12 +3985,14 @@ export function generateAgentsMdSummary(config = {}) {
|
|
|
3976
3985
|
*/
|
|
3977
3986
|
export function writeAgentsMdSummary(config, projectPath) {
|
|
3978
3987
|
const filePath = join(projectPath, 'AGENTS.md');
|
|
3979
|
-
|
|
3980
3988
|
try {
|
|
3981
3989
|
let content = generateAgentsMdSummary({ ...config, projectPath });
|
|
3982
3990
|
|
|
3991
|
+
// See writeIntegrationFile: true only when this call creates the file.
|
|
3992
|
+
const created = !existsSync(filePath);
|
|
3993
|
+
|
|
3983
3994
|
// Handle merge if file exists (preserve user content outside markers)
|
|
3984
|
-
if (
|
|
3995
|
+
if (!created) {
|
|
3985
3996
|
const existingContent = readFileSync(filePath, 'utf-8');
|
|
3986
3997
|
const newParts = extractMarkedContent(content, 'markdown');
|
|
3987
3998
|
if (newParts.content) {
|
|
@@ -3997,6 +4008,7 @@ export function writeAgentsMdSummary(config, projectPath) {
|
|
|
3997
4008
|
success: true,
|
|
3998
4009
|
path: 'AGENTS.md',
|
|
3999
4010
|
absolutePath: filePath,
|
|
4011
|
+
created,
|
|
4000
4012
|
blockHashInfo
|
|
4001
4013
|
};
|
|
4002
4014
|
} catch (error) {
|
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Migrate the pre-commit hook line older UDS versions wrote
|
|
3
|
+
* (`npx uds check`) to the block current UDS writes.
|
|
4
|
+
*
|
|
5
|
+
* Why it exists: every adopter who ran `uds init` before this fix has
|
|
6
|
+
* `.husky/pre-commit` asking `npx` to run the bare name `uds`. `npx` looks in
|
|
7
|
+
* node_modules/.bin and PATH first and otherwise asks the npm registry — where
|
|
8
|
+
* `uds` is an unrelated package that is not ours (see buildPreCommitBlock in
|
|
9
|
+
* git-hooks.js for the measurements). Fixing what `uds init` writes today does
|
|
10
|
+
* nothing for the hooks already on disk, so `uds update` swaps them.
|
|
11
|
+
*
|
|
12
|
+
* ⚠️ THIS FILE RECOGNISES the old text; it must never EMIT it. The regression
|
|
13
|
+
* guard (tests/unit/no-bare-uds-npx.test.js) lists this file as the one place
|
|
14
|
+
* a bare-name npx string is allowed, and says why. Nothing here may write one.
|
|
15
|
+
*
|
|
16
|
+
* What counts as "UDS wrote this line" — exact equality, not a pattern:
|
|
17
|
+
* only the two shapes UDS has ever generated, and only directly under the
|
|
18
|
+
* marker comment UDS put above them.
|
|
19
|
+
* 2026-02-04 .. 2026-03-04 npx uds check --standard checkin-standards
|
|
20
|
+
* 2026-03-04 .. this fix npx uds check
|
|
21
|
+
* (from `git log -S` on the writer in cli/src/commands/init.js.) A line an
|
|
22
|
+
* adopter edited, or wrote themselves, is NOT swapped: it cannot be proven to be
|
|
23
|
+
* ours, and a hook that runs the adopter's own arguments is theirs to change.
|
|
24
|
+
* It is reported, with the exact line number and what to write instead.
|
|
25
|
+
*
|
|
26
|
+
* @module utils/legacy-hook-migration
|
|
27
|
+
*/
|
|
28
|
+
|
|
29
|
+
import { existsSync, readFileSync, writeFileSync } from 'fs';
|
|
30
|
+
import { join } from 'path';
|
|
31
|
+
import { buildPreCommitBlock, UDS_HOOK_MARKER, BARE_UDS_RUNNER_RE, hasBareUdsRunner } from './git-hooks.js';
|
|
32
|
+
import { getFileRecord, proveUnchanged, recordFile, newRecorder, RECORD_KINDS } from '../core/install-records.js';
|
|
33
|
+
|
|
34
|
+
/** The exact command lines UDS itself has written under the marker, and the extra arguments each carried. */
|
|
35
|
+
const UDS_WRITTEN_LEGACY_LINES = new Map([
|
|
36
|
+
['npx uds check', ''],
|
|
37
|
+
['npx uds check --standard checkin-standards', '--standard checkin-standards']
|
|
38
|
+
]);
|
|
39
|
+
|
|
40
|
+
/**
|
|
41
|
+
* Swap the legacy hook line UDS wrote in `.husky/pre-commit` for the current block.
|
|
42
|
+
*
|
|
43
|
+
* @param {string} projectPath
|
|
44
|
+
* @param {{plan?: boolean, manifest?: object|null}} [opts]
|
|
45
|
+
* plan — report what would change, write nothing
|
|
46
|
+
* manifest — read only to see whether the file was provably UDS's before the
|
|
47
|
+
* swap (so the install record can follow it); may be null
|
|
48
|
+
* @returns {{
|
|
49
|
+
* state: 'none'|'migrated'|'would-migrate'|'kept'|'error',
|
|
50
|
+
* replaced: number, // legacy UDS-written lines swapped (or that would be)
|
|
51
|
+
* kept: Array<{line: number, text: string}>, // bare-name lines UDS cannot prove it wrote
|
|
52
|
+
* recorder: object|null, // fold into the manifest when non-null
|
|
53
|
+
* error?: string
|
|
54
|
+
* }}
|
|
55
|
+
*/
|
|
56
|
+
export function migrateLegacyHuskyHook(projectPath, { plan = false, manifest = null } = {}) {
|
|
57
|
+
const rel = '.husky/pre-commit';
|
|
58
|
+
const abs = join(projectPath, '.husky', 'pre-commit');
|
|
59
|
+
const none = { state: 'none', replaced: 0, kept: [], recorder: null };
|
|
60
|
+
if (!existsSync(abs)) return none;
|
|
61
|
+
|
|
62
|
+
let content;
|
|
63
|
+
try {
|
|
64
|
+
content = readFileSync(abs, 'utf-8');
|
|
65
|
+
} catch (e) {
|
|
66
|
+
return { ...none, state: 'error', error: e.message };
|
|
67
|
+
}
|
|
68
|
+
if (!hasBareUdsRunner(content)) return none;
|
|
69
|
+
|
|
70
|
+
const eol = content.includes('\r\n') ? '\r\n' : '\n';
|
|
71
|
+
const lines = content.split('\n');
|
|
72
|
+
const out = [];
|
|
73
|
+
const kept = [];
|
|
74
|
+
let replaced = 0;
|
|
75
|
+
|
|
76
|
+
for (let i = 0; i < lines.length; i++) {
|
|
77
|
+
const text = lines[i].replace(/\r$/, '');
|
|
78
|
+
const next = i + 1 < lines.length ? lines[i + 1].replace(/\r$/, '').trim() : null;
|
|
79
|
+
// Marker line directly followed by a line UDS is known to have written.
|
|
80
|
+
if (text.trim() === UDS_HOOK_MARKER && next !== null && UDS_WRITTEN_LEGACY_LINES.has(next)) {
|
|
81
|
+
const block = buildPreCommitBlock({ args: UDS_WRITTEN_LEGACY_LINES.get(next) });
|
|
82
|
+
// block ends with '\n'; drop that so the surrounding line join supplies it.
|
|
83
|
+
out.push(...block.replace(/\n$/, '').split('\n').map((l) => l + (eol === '\r\n' ? '\r' : '')));
|
|
84
|
+
replaced += 1;
|
|
85
|
+
i += 1; // the legacy command line is consumed
|
|
86
|
+
continue;
|
|
87
|
+
}
|
|
88
|
+
if (BARE_UDS_RUNNER_RE.test(text)) kept.push({ line: i + 1, text: text.trim() });
|
|
89
|
+
out.push(lines[i]);
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
if (replaced === 0) return { state: 'kept', replaced: 0, kept, recorder: null };
|
|
93
|
+
|
|
94
|
+
if (plan) return { state: 'would-migrate', replaced, kept, recorder: null };
|
|
95
|
+
|
|
96
|
+
// Was the whole file provably UDS's until now? Then the swap must not cost it
|
|
97
|
+
// that proof: re-record the new content, or uninstall falls back from "delete
|
|
98
|
+
// the file UDS created" to "strip lines".
|
|
99
|
+
let recorder = null;
|
|
100
|
+
const wasProven = !!manifest && !!getFileRecord(manifest, rel) && proveUnchanged(manifest, projectPath, rel).state === 'proven';
|
|
101
|
+
|
|
102
|
+
try {
|
|
103
|
+
writeFileSync(abs, out.join('\n'), 'utf-8');
|
|
104
|
+
} catch (e) {
|
|
105
|
+
return { state: 'error', replaced: 0, kept, recorder: null, error: e.message };
|
|
106
|
+
}
|
|
107
|
+
if (wasProven) {
|
|
108
|
+
recorder = newRecorder();
|
|
109
|
+
recordFile(recorder, projectPath, rel, RECORD_KINDS.GIT_HOOK);
|
|
110
|
+
}
|
|
111
|
+
return { state: 'migrated', replaced, kept, recorder };
|
|
112
|
+
}
|