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
|
@@ -0,0 +1,192 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Install records — the manifest's account of what UDS itself put on disk, kept
|
|
3
|
+
* so that `uds uninstall` removes exactly that and nothing else.
|
|
4
|
+
*
|
|
5
|
+
* Why a record and not a rule: `uds uninstall` used to leave four kinds of UDS
|
|
6
|
+
* output behind (hook scripts under scripts/hooks/, emptied `.codex/`-style
|
|
7
|
+
* folders, integration files whose generated header sits outside the UDS
|
|
8
|
+
* marker block, and the body of the native pre-commit hook). Each could be
|
|
9
|
+
* cleaned by pattern-matching on its content or path — and each of those
|
|
10
|
+
* patterns also matches files an adopter wrote themselves (`scripts/hooks/` is
|
|
11
|
+
* a directory UDS scaffolds INSIDE the adopter's project, where their own hook
|
|
12
|
+
* scripts may live). Origin is a fact about the moment of writing, so it is
|
|
13
|
+
* recorded then: a file is deleted only if a record says UDS wrote it AND its
|
|
14
|
+
* content still hashes to what UDS wrote. No record, or a changed hash, means
|
|
15
|
+
* the file is kept and the reason is printed.
|
|
16
|
+
*
|
|
17
|
+
* Deliberately NOT stored in `fileHashes` (`uds check` treats that as the list of
|
|
18
|
+
* standards files and would report these as modified/untracked) or in
|
|
19
|
+
* `provenance` (`uds update` prunes entries outside its expected set).
|
|
20
|
+
* `installedArtifacts` is read by nothing except uninstall.
|
|
21
|
+
*
|
|
22
|
+
* Shape:
|
|
23
|
+
* installedArtifacts: {
|
|
24
|
+
* files: { '<rel/path>': { kind, hash, size, installedAt } },
|
|
25
|
+
* createdDirs: ['<rel/dir>', ...] // directories UDS had to mkdir
|
|
26
|
+
* }
|
|
27
|
+
*
|
|
28
|
+
* `kind` selects what `hash` covers:
|
|
29
|
+
* 'hook-script', 'gate-script', 'git-hook' → whole file (line endings normalized)
|
|
30
|
+
* 'integration-file' → everything outside the UDS marker block
|
|
31
|
+
*
|
|
32
|
+
* @module core/install-records
|
|
33
|
+
*/
|
|
34
|
+
|
|
35
|
+
import { existsSync, mkdirSync, lstatSync, readFileSync, writeFileSync } from 'fs';
|
|
36
|
+
import { join, dirname, relative, isAbsolute } from 'path';
|
|
37
|
+
import { computeFileHash, computeOutsideBlockHash } from '../utils/hasher.js';
|
|
38
|
+
import { getManifestPath } from './manifest.js';
|
|
39
|
+
|
|
40
|
+
export const RECORDS_KEY = 'installedArtifacts';
|
|
41
|
+
|
|
42
|
+
export const RECORD_KINDS = Object.freeze({
|
|
43
|
+
HOOK_SCRIPT: 'hook-script',
|
|
44
|
+
GATE_SCRIPT: 'gate-script',
|
|
45
|
+
GIT_HOOK: 'git-hook',
|
|
46
|
+
INTEGRATION_FILE: 'integration-file'
|
|
47
|
+
});
|
|
48
|
+
|
|
49
|
+
const norm = (p) => String(p).replace(/\\/g, '/');
|
|
50
|
+
|
|
51
|
+
/** A fresh, empty recorder. Installers fill it; a caller persists it. */
|
|
52
|
+
export function newRecorder() {
|
|
53
|
+
return { files: {}, createdDirs: [] };
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
/**
|
|
57
|
+
* The hash a record of this kind holds for a file as it is on disk right now.
|
|
58
|
+
* Also what uninstall recomputes and compares — one function, so the two sides
|
|
59
|
+
* cannot drift apart.
|
|
60
|
+
* @returns {{hash: string, size: number}|null}
|
|
61
|
+
*/
|
|
62
|
+
export function currentHashFor(kind, absPath) {
|
|
63
|
+
if (kind === RECORD_KINDS.INTEGRATION_FILE) return computeOutsideBlockHash(absPath);
|
|
64
|
+
return computeFileHash(absPath);
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
/**
|
|
68
|
+
* Record a file UDS has just written. Call it AFTER the write, so the hash is of
|
|
69
|
+
* what is on disk. No-op (returns false) if the file cannot be hashed.
|
|
70
|
+
*/
|
|
71
|
+
export function recordFile(recorder, projectPath, relPath, kind) {
|
|
72
|
+
const rel = norm(relPath);
|
|
73
|
+
const h = currentHashFor(kind, join(projectPath, rel));
|
|
74
|
+
if (!h) return false;
|
|
75
|
+
recorder.files[rel] = { kind, hash: h.hash, size: h.size, installedAt: new Date().toISOString() };
|
|
76
|
+
return true;
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
/**
|
|
80
|
+
* `mkdir -p`, remembering every directory that did not exist before this call.
|
|
81
|
+
* "UDS created this directory" is only knowable at the moment of creation; after
|
|
82
|
+
* that an empty `.codex/` looks the same whether UDS or the adopter made it.
|
|
83
|
+
*/
|
|
84
|
+
export function mkdirTracked(recorder, projectPath, absDir) {
|
|
85
|
+
const missing = [];
|
|
86
|
+
let cur = absDir;
|
|
87
|
+
while (!existsSync(cur)) {
|
|
88
|
+
missing.push(cur);
|
|
89
|
+
const parent = dirname(cur);
|
|
90
|
+
if (parent === cur) break;
|
|
91
|
+
cur = parent;
|
|
92
|
+
}
|
|
93
|
+
if (missing.length === 0) return;
|
|
94
|
+
mkdirSync(absDir, { recursive: true });
|
|
95
|
+
for (const dir of missing.reverse()) {
|
|
96
|
+
const rel = norm(relative(projectPath, dir));
|
|
97
|
+
if (!rel || rel.startsWith('..') || isAbsolute(rel)) continue;
|
|
98
|
+
if (!recorder.createdDirs.includes(rel)) recorder.createdDirs.push(rel);
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
/** Fold a recorder into a manifest object (returned as a new object; input untouched). */
|
|
103
|
+
export function mergeRecorderInto(manifest, recorder) {
|
|
104
|
+
const prev = manifest?.[RECORDS_KEY] || {};
|
|
105
|
+
const dirs = new Set([...(prev.createdDirs || []), ...(recorder?.createdDirs || [])]);
|
|
106
|
+
return {
|
|
107
|
+
...manifest,
|
|
108
|
+
[RECORDS_KEY]: {
|
|
109
|
+
files: { ...(prev.files || {}), ...(recorder?.files || {}) },
|
|
110
|
+
createdDirs: [...dirs]
|
|
111
|
+
}
|
|
112
|
+
};
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
/** Drop records for paths UDS has now removed. */
|
|
116
|
+
export function forgetRecords(manifest, relPaths) {
|
|
117
|
+
const prev = manifest?.[RECORDS_KEY];
|
|
118
|
+
if (!prev) return manifest;
|
|
119
|
+
const gone = new Set((relPaths || []).map(norm));
|
|
120
|
+
const files = Object.fromEntries(Object.entries(prev.files || {}).filter(([k]) => !gone.has(k)));
|
|
121
|
+
const createdDirs = (prev.createdDirs || []).filter((d) => !gone.has(d));
|
|
122
|
+
return { ...manifest, [RECORDS_KEY]: { files, createdDirs } };
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
/** The record for a path, or undefined. */
|
|
126
|
+
export function getFileRecord(manifest, relPath) {
|
|
127
|
+
return manifest?.[RECORDS_KEY]?.files?.[norm(relPath)];
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
/** True when the recorder holds anything worth writing. */
|
|
131
|
+
export function hasRecords(recorder) {
|
|
132
|
+
return !!recorder && (Object.keys(recorder.files).length > 0 || recorder.createdDirs.length > 0);
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
/**
|
|
136
|
+
* Persist a recorder into the project's manifest on disk. For callers that run
|
|
137
|
+
* after the manifest was written (init's hook step, `uds update --with-hooks`).
|
|
138
|
+
* Returns false — and writes nothing — when there is nothing to record or no
|
|
139
|
+
* manifest to record it in.
|
|
140
|
+
*
|
|
141
|
+
* Reads and writes the manifest as RAW JSON, not through `readManifest`. That
|
|
142
|
+
* function migrates on read (it rewrites `standards` from paths to registry IDs,
|
|
143
|
+
* among other normalizations), so a read-modify-write through it would silently
|
|
144
|
+
* change every other field in the file as a side effect of recording one new
|
|
145
|
+
* one — measured: the e2e test "auto-restore missing files" reads `standards`
|
|
146
|
+
* straight from the file `uds init` wrote and started failing because init's
|
|
147
|
+
* manifest had come out in a different format.
|
|
148
|
+
*/
|
|
149
|
+
export function persistRecorder(projectPath, recorder) {
|
|
150
|
+
if (!hasRecords(recorder)) return false;
|
|
151
|
+
const manifestPath = getManifestPath(projectPath);
|
|
152
|
+
if (!existsSync(manifestPath)) return false;
|
|
153
|
+
let raw;
|
|
154
|
+
try {
|
|
155
|
+
raw = JSON.parse(readFileSync(manifestPath, 'utf-8'));
|
|
156
|
+
} catch {
|
|
157
|
+
return false;
|
|
158
|
+
}
|
|
159
|
+
if (!raw || typeof raw !== 'object') return false;
|
|
160
|
+
writeFileSync(manifestPath, JSON.stringify(mergeRecorderInto(raw, recorder), null, 2));
|
|
161
|
+
return true;
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
/** Is `absPath` a real directory (not a symlink to one)? Uninstall never follows links. */
|
|
165
|
+
export function isRealDirectory(absPath) {
|
|
166
|
+
try {
|
|
167
|
+
const st = lstatSync(absPath);
|
|
168
|
+
return st.isDirectory() && !st.isSymbolicLink();
|
|
169
|
+
} catch {
|
|
170
|
+
return false;
|
|
171
|
+
}
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
/**
|
|
175
|
+
* @returns {{ state: 'proven'|'no-record'|'changed', why: string }}
|
|
176
|
+
* proven a record exists and the file still hashes to it
|
|
177
|
+
* no-record nothing says UDS wrote it (older UDS, or written by hand)
|
|
178
|
+
* changed UDS wrote it, and it has been edited since
|
|
179
|
+
*/
|
|
180
|
+
export function proveUnchanged(manifest, projectPath, relPath) {
|
|
181
|
+
const rec = getFileRecord(manifest, relPath);
|
|
182
|
+
if (!rec) {
|
|
183
|
+
return {
|
|
184
|
+
state: 'no-record',
|
|
185
|
+
why: 'no install record — installed by an older UDS or not by UDS, so UDS cannot prove it wrote this'
|
|
186
|
+
};
|
|
187
|
+
}
|
|
188
|
+
const now = currentHashFor(rec.kind, join(projectPath, relPath));
|
|
189
|
+
if (now && now.hash === rec.hash) return { state: 'proven', why: 'unchanged since UDS wrote it' };
|
|
190
|
+
return { state: 'changed', why: 'modified since UDS wrote it' };
|
|
191
|
+
}
|
|
192
|
+
|
package/src/core/manifest.js
CHANGED
|
@@ -851,11 +851,10 @@ export function areCommandsInstalled(manifest) {
|
|
|
851
851
|
return manifest.commands?.installed || false;
|
|
852
852
|
}
|
|
853
853
|
|
|
854
|
-
|
|
855
|
-
|
|
856
|
-
|
|
857
|
-
|
|
858
|
-
export const MARKETPLACE_NAMES_SENTINEL = 'all-via-plugin';
|
|
854
|
+
// Placeholder stored in `skills.names` when skills come from the Claude Code plugin marketplace.
|
|
855
|
+
// It lives in its own module so the name-ownership code can read it without loading this whole module.
|
|
856
|
+
export { MARKETPLACE_NAMES_SENTINEL } from './marketplace-sentinel.js';
|
|
857
|
+
import { MARKETPLACE_NAMES_SENTINEL } from './marketplace-sentinel.js';
|
|
859
858
|
|
|
860
859
|
/**
|
|
861
860
|
* Merge the names actually installed by a run into a manifest name list.
|
|
@@ -872,11 +871,14 @@ export const MARKETPLACE_NAMES_SENTINEL = 'all-via-plugin';
|
|
|
872
871
|
* update.js and config.js, and a private copy per module is how the writers drift
|
|
873
872
|
* apart again.
|
|
874
873
|
*
|
|
875
|
-
*
|
|
876
|
-
* (
|
|
877
|
-
*
|
|
878
|
-
*
|
|
879
|
-
*
|
|
874
|
+
* This function only ever adds; removing is a separate step done right after it
|
|
875
|
+
* (XSPEC-456 R4, `utils/installed-names-ownership.js`). The earlier version of this
|
|
876
|
+
* comment said pruning was unnecessary because "over-reporting is harmless" - it is
|
|
877
|
+
* not: after an update removed the five non-skill directories an old deny-list bug
|
|
878
|
+
* had misfiled as skills (`_shared`, `agents`, `ai`, `tools`, `workflows`), the
|
|
879
|
+
* manifest still named them as installed skills, next to a `skillHashes` that had
|
|
880
|
+
* been cleaned. A name that UDS does not ship, or that is not on disk where it was
|
|
881
|
+
* installed, is dropped by `uds update`.
|
|
880
882
|
*
|
|
881
883
|
* @param {string[]} existing - Current manifest list
|
|
882
884
|
* @param {Object} installResult - Result from installSkills/CommandsToMultipleAgents
|
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* What an adopting project declares for `uds open-work`, read from the `open_work` section of
|
|
3
|
+
* uds.project.yaml (dev-platform XSPEC-460 R4 and XSPEC-461 R2: one namespace for both).
|
|
4
|
+
*
|
|
5
|
+
* version: "1"
|
|
6
|
+
* open_work:
|
|
7
|
+
* projects: # logical project name -> where it lives on THIS machine
|
|
8
|
+
* uds: ../universal-dev-standards
|
|
9
|
+
* vibeops: ../vibeops
|
|
10
|
+
* next_action_words: # extra words that mean "next action" in this project's carriers
|
|
11
|
+
* - 待辦
|
|
12
|
+
* command_words: # extra program names read as a command in a next action or a draft
|
|
13
|
+
* - kubectl
|
|
14
|
+
* asked_at_words: # extra words that head the "when was it asked" column (XSPEC-475 R3)
|
|
15
|
+
* - 何時問
|
|
16
|
+
* waiting_for_words: # extra words that head the "what is it waiting for" column (XSPEC-475 R3)
|
|
17
|
+
* - 問什麼
|
|
18
|
+
*
|
|
19
|
+
* This file holds no rule. It turns the section into the same `--root NAME=DIR` and
|
|
20
|
+
* `--next-action-word WORD` arguments a person could type, and hands them to the checker, which
|
|
21
|
+
* is self-contained (node builtins only) and therefore cannot read YAML itself. The repository
|
|
22
|
+
* shim `node scripts/check-open-work-tracking.mjs` does not read uds.project.yaml: it takes the
|
|
23
|
+
* flags only.
|
|
24
|
+
*
|
|
25
|
+
* Directories are resolved against the directory holding uds.project.yaml. A relative path keeps
|
|
26
|
+
* the committed file free of a user name and valid on every machine that lays the projects out
|
|
27
|
+
* the same way; an absolute path works but is the machine-specific thing OWT-027 keeps out of a
|
|
28
|
+
* carrier, so it belongs in a file that is not committed.
|
|
29
|
+
*
|
|
30
|
+
* @module core/open-work-config
|
|
31
|
+
*/
|
|
32
|
+
|
|
33
|
+
import { resolve, isAbsolute } from 'path';
|
|
34
|
+
import { loadProjectConfig, CONFIG_FILENAME } from './project-config.js';
|
|
35
|
+
import { PROJECT_NAME } from '../utils/open-work-tracking.mjs';
|
|
36
|
+
|
|
37
|
+
/**
|
|
38
|
+
* @returns {{projects: Object<string,string>, nextActionWords: string[], note: string|null, error: string|null}}
|
|
39
|
+
* `note`: the file exists but could not be read at all (nothing was applied; the command goes on).
|
|
40
|
+
* `error`: the file is readable and its open_work section is wrong (the command stops with exit 2).
|
|
41
|
+
*/
|
|
42
|
+
export function readOpenWorkDeclarations(cwd = process.cwd()) {
|
|
43
|
+
const out = { projects: {}, nextActionWords: [], commandWords: [], askedAtWords: [], waitingForWords: [], note: null, error: null };
|
|
44
|
+
let config;
|
|
45
|
+
try {
|
|
46
|
+
config = loadProjectConfig(cwd);
|
|
47
|
+
} catch (e) {
|
|
48
|
+
out.note = `${CONFIG_FILENAME} could not be read (${String(e.message).split('\n')[0]}); the open_work declarations in it were not applied`;
|
|
49
|
+
return out;
|
|
50
|
+
}
|
|
51
|
+
const section = config ? config.open_work : undefined;
|
|
52
|
+
if (section === undefined) return out;
|
|
53
|
+
const bad = (why) => { out.error = `${CONFIG_FILENAME}: open_work ${why}`; return out; };
|
|
54
|
+
if (typeof section !== 'object' || Array.isArray(section)) return bad('must be a mapping with projects and next_action_words');
|
|
55
|
+
|
|
56
|
+
if (section.projects !== undefined && section.projects !== null) {
|
|
57
|
+
if (typeof section.projects !== 'object' || Array.isArray(section.projects)) return bad('.projects must be a mapping of project name to directory');
|
|
58
|
+
for (const [name, dir] of Object.entries(section.projects)) {
|
|
59
|
+
if (!PROJECT_NAME.test(name)) return bad(`.projects: "${name}" is not a logical project name (lower-case letters, digits, "-" and "_", starting with a letter, 2 to 32 characters)`);
|
|
60
|
+
if (typeof dir !== 'string' || dir.trim() === '') return bad(`.projects.${name} must be a directory, written as text`);
|
|
61
|
+
out.projects[name] = isAbsolute(dir) ? dir : resolve(cwd, dir);
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
if (section.next_action_words !== undefined && section.next_action_words !== null) {
|
|
65
|
+
if (!Array.isArray(section.next_action_words)) return bad('.next_action_words must be a list of words');
|
|
66
|
+
for (const w of section.next_action_words) {
|
|
67
|
+
if (typeof w !== 'string') return bad('.next_action_words must hold text only; write each word as plain text');
|
|
68
|
+
out.nextActionWords.push(w);
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
if (section.command_words !== undefined && section.command_words !== null) {
|
|
72
|
+
if (!Array.isArray(section.command_words)) return bad('.command_words must be a list of program names');
|
|
73
|
+
for (const w of section.command_words) {
|
|
74
|
+
if (typeof w !== 'string') return bad('.command_words must hold text only; write each program name as plain text');
|
|
75
|
+
out.commandWords.push(w);
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
for (const [key, into] of [['asked_at_words', out.askedAtWords], ['waiting_for_words', out.waitingForWords]]) {
|
|
79
|
+
if (section[key] === undefined || section[key] === null) continue;
|
|
80
|
+
if (!Array.isArray(section[key])) return bad(`.${key} must be a list of words`);
|
|
81
|
+
for (const w of section[key]) {
|
|
82
|
+
if (typeof w !== 'string') return bad(`.${key} must hold text only; write each word as plain text`);
|
|
83
|
+
into.push(w);
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
return out;
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
/**
|
|
90
|
+
* The `--root` arguments for `uds open-work waiting`: what was typed (a plain DIR, and NAME=DIR for other
|
|
91
|
+
* projects), then every project the file declares that was not already named on the command line (the command
|
|
92
|
+
* line wins for a name given in both).
|
|
93
|
+
*/
|
|
94
|
+
export function rootArguments(cliRoots, declaredProjects = {}) {
|
|
95
|
+
const given = [].concat(cliRoots ?? []);
|
|
96
|
+
const named = new Set(given.map((v) => /^([^\s/\\=]+)=/.exec(String(v))?.[1]).filter(Boolean));
|
|
97
|
+
const argv = [];
|
|
98
|
+
for (const [name, dir] of Object.entries(declaredProjects)) if (!named.has(name)) argv.push('--root', `${name}=${dir}`);
|
|
99
|
+
for (const v of given) argv.push('--root', v);
|
|
100
|
+
return argv;
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
/** The `--command-word` arguments, merged the same way. */
|
|
104
|
+
export function commandArguments(cliWords, declaredWords = []) {
|
|
105
|
+
const argv = [];
|
|
106
|
+
for (const w of [].concat(cliWords ?? [], declaredWords)) argv.push('--command-word', w);
|
|
107
|
+
return argv;
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
/** The `--next-action-word` arguments: the command line's words, then the file's. Merged, never either-or. */
|
|
111
|
+
export function wordArguments(cliWords, declaredWords = []) {
|
|
112
|
+
const argv = [];
|
|
113
|
+
for (const w of [].concat(cliWords ?? [], declaredWords)) argv.push('--next-action-word', w);
|
|
114
|
+
return argv;
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
/** The `--asked-at-word` or `--waiting-for-word` arguments (XSPEC-475 R3): the command line's words, then the file's. */
|
|
118
|
+
export function fieldWordArguments(flag, cliWords, declaredWords = []) {
|
|
119
|
+
const argv = [];
|
|
120
|
+
for (const w of [].concat(cliWords ?? [], declaredWords)) argv.push(flag, w);
|
|
121
|
+
return argv;
|
|
122
|
+
}
|
|
@@ -4,13 +4,23 @@
|
|
|
4
4
|
*/
|
|
5
5
|
import { existsSync, readFileSync } from 'fs';
|
|
6
6
|
import { join } from 'path';
|
|
7
|
+
import * as yaml from 'js-yaml';
|
|
7
8
|
|
|
8
9
|
const CONFIG_FILENAME = 'uds.project.yaml';
|
|
9
10
|
|
|
11
|
+
/** Sections whose entries are `intent: command` pairs. */
|
|
12
|
+
const COMMAND_SECTIONS = ['commands', 'custom'];
|
|
13
|
+
|
|
10
14
|
/**
|
|
11
15
|
* Parse uds.project.yaml from the given project path.
|
|
12
16
|
* Returns null if the file does not exist.
|
|
13
17
|
* Throws if the file exists but is invalid.
|
|
18
|
+
*
|
|
19
|
+
* XSPEC-456 R1: the file is read as YAML. It used to go through a hand-written line parser that
|
|
20
|
+
* kept everything after the first colon as the value, so a trailing comment
|
|
21
|
+
* (`test: dotnet test X.csproj # 90 tests pass`) became part of the command. A POSIX shell hides
|
|
22
|
+
* that (an unquoted `#` starts a comment), `cmd.exe` does not - the comment reached MSBuild as
|
|
23
|
+
* arguments. Reading the value the way YAML defines it removes the comment before anything is run.
|
|
14
24
|
*/
|
|
15
25
|
export function loadProjectConfig(projectPath = '.') {
|
|
16
26
|
const configPath = join(projectPath, CONFIG_FILENAME);
|
|
@@ -18,55 +28,64 @@ export function loadProjectConfig(projectPath = '.') {
|
|
|
18
28
|
|
|
19
29
|
const raw = readFileSync(configPath, 'utf8');
|
|
20
30
|
|
|
21
|
-
|
|
22
|
-
// We deliberately avoid a heavy dependency — uds.project.yaml is intentionally simple.
|
|
23
|
-
const config = parseMinimalYaml(raw, configPath);
|
|
31
|
+
const config = parseProjectYaml(raw, configPath);
|
|
24
32
|
validateConfig(config, configPath);
|
|
25
33
|
return config;
|
|
26
34
|
}
|
|
27
35
|
|
|
28
36
|
/**
|
|
29
|
-
* Parse a
|
|
30
|
-
*
|
|
37
|
+
* Parse the file with a real YAML parser and normalise it to the shape callers use:
|
|
38
|
+
* top-level scalars and the `commands` / `custom` sections are strings.
|
|
31
39
|
*/
|
|
32
|
-
function
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
const
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
40
|
+
function parseProjectYaml(raw, filePath) {
|
|
41
|
+
let doc;
|
|
42
|
+
try {
|
|
43
|
+
doc = yaml.load(raw);
|
|
44
|
+
} catch (err) {
|
|
45
|
+
const line = err?.mark ? ` (line ${err.mark.line + 1})` : '';
|
|
46
|
+
const reason = err?.reason || err?.message || String(err);
|
|
47
|
+
// A double-quoted YAML value reads backslashes as escapes. Windows paths written that way
|
|
48
|
+
// used to work (the old parser kept them verbatim), so say what to do instead of only failing.
|
|
49
|
+
const hint = /escape|hexadecimal/i.test(reason)
|
|
50
|
+
? ' Inside double quotes a backslash starts an escape sequence; write Windows paths in single quotes or without quotes.'
|
|
51
|
+
: '';
|
|
52
|
+
throw new Error(`${filePath}: not valid YAML${line}: ${reason}.${hint}`);
|
|
53
|
+
}
|
|
54
|
+
if (doc === null || doc === undefined) return {};
|
|
55
|
+
if (typeof doc !== 'object' || Array.isArray(doc)) {
|
|
56
|
+
throw new Error(`${filePath}: the file must be a mapping of keys to values.`);
|
|
57
|
+
}
|
|
45
58
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
} else {
|
|
55
|
-
result[key] = {};
|
|
56
|
-
currentSection = key;
|
|
57
|
-
}
|
|
58
|
-
} else if (currentSection && indent > 0) {
|
|
59
|
-
// Nested key under current section
|
|
60
|
-
const match = trimmed.trim().match(/^([a-zA-Z_][a-zA-Z0-9_-]*):\s*(.*)$/);
|
|
61
|
-
if (!match) continue;
|
|
62
|
-
const [, key, value] = match;
|
|
63
|
-
result[currentSection][key] = value.trim().replace(/^["']|["']$/g, '');
|
|
59
|
+
const result = {};
|
|
60
|
+
for (const [key, value] of Object.entries(doc)) {
|
|
61
|
+
if (COMMAND_SECTIONS.includes(key)) {
|
|
62
|
+
result[key] = normaliseCommandSection(key, value, filePath);
|
|
63
|
+
} else if (value !== null && typeof value === 'object') {
|
|
64
|
+
result[key] = value;
|
|
65
|
+
} else if (value !== null && value !== undefined) {
|
|
66
|
+
result[key] = String(value);
|
|
64
67
|
}
|
|
65
68
|
}
|
|
66
|
-
|
|
67
69
|
return result;
|
|
68
70
|
}
|
|
69
71
|
|
|
72
|
+
function normaliseCommandSection(name, value, filePath) {
|
|
73
|
+
if (value === null || value === undefined) return {};
|
|
74
|
+
if (typeof value !== 'object' || Array.isArray(value)) {
|
|
75
|
+
throw new Error(`${filePath}: "${name}" must be a mapping of intent: command pairs.`);
|
|
76
|
+
}
|
|
77
|
+
const out = {};
|
|
78
|
+
for (const [intent, command] of Object.entries(value)) {
|
|
79
|
+
if (command === null || command === undefined) continue;
|
|
80
|
+
if (typeof command === 'object') {
|
|
81
|
+
throw new Error(`${filePath}: "${name}.${intent}" must be a single command string, not a list or mapping.`);
|
|
82
|
+
}
|
|
83
|
+
const text = String(command).trim();
|
|
84
|
+
if (text) out[intent] = text;
|
|
85
|
+
}
|
|
86
|
+
return out;
|
|
87
|
+
}
|
|
88
|
+
|
|
70
89
|
function validateConfig(config, filePath) {
|
|
71
90
|
if (!config.version) {
|
|
72
91
|
throw new Error(
|
|
@@ -79,13 +98,48 @@ function validateConfig(config, filePath) {
|
|
|
79
98
|
}
|
|
80
99
|
}
|
|
81
100
|
|
|
101
|
+
/**
|
|
102
|
+
* The text YAML dropped from an unquoted `commands:` / `custom:` value because it follows a space and a `#` (YAML reads
|
|
103
|
+
* that as the start of a comment), or null when nothing was dropped. XSPEC-475 R5(c).
|
|
104
|
+
*
|
|
105
|
+
* `build: node -p "'quoted # kept'"` is a valid plain YAML value that ends at `node -p "'quoted`: the shell would have
|
|
106
|
+
* kept the `#`, YAML does not. CHANGELOG 6.14.0 says so, but nothing said it at the moment it happened. A trailing
|
|
107
|
+
* comment (`test: dotnet test # 90 tests pass`) is also dropped; the two look the same in the file, so both are reported
|
|
108
|
+
* and the person decides.
|
|
109
|
+
*
|
|
110
|
+
* Only a plain (unquoted) scalar on one line is looked at, and only when the value YAML produced is exactly the text
|
|
111
|
+
* before the `#` - so a line this cannot match up with the parsed value is never reported.
|
|
112
|
+
* @param {string} projectPath
|
|
113
|
+
* @param {string} intent
|
|
114
|
+
* @param {string} command - the value YAML produced for `intent`
|
|
115
|
+
* @returns {string|null} the dropped text, starting at the `#`
|
|
116
|
+
*/
|
|
117
|
+
export function droppedYamlComment(projectPath, intent, command) {
|
|
118
|
+
const configPath = join(projectPath, CONFIG_FILENAME);
|
|
119
|
+
if (!existsSync(configPath)) return null;
|
|
120
|
+
const escaped = intent.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
|
|
121
|
+
const line = new RegExp(`^[ \\t]+${escaped}[ \\t]*:[ \\t]+(.*)$`);
|
|
122
|
+
for (const text of readFileSync(configPath, 'utf8').split(/\r?\n/)) {
|
|
123
|
+
const m = line.exec(text);
|
|
124
|
+
if (!m) continue;
|
|
125
|
+
const value = m[1].trim();
|
|
126
|
+
if (/^["'|>[{&*!]/.test(value)) continue; // quoted, block, flow or anchored: not a plain scalar
|
|
127
|
+
const at = value.search(/\s#/);
|
|
128
|
+
if (at < 0) continue;
|
|
129
|
+
if (value.slice(0, at).trim() !== command) continue; // not the line YAML read this value from
|
|
130
|
+
return value.slice(at).trim(); // [mutation-anchor:dropped-comment]
|
|
131
|
+
}
|
|
132
|
+
return null;
|
|
133
|
+
}
|
|
134
|
+
|
|
82
135
|
/**
|
|
83
136
|
* Get a specific command intent from config.
|
|
84
137
|
* Returns undefined if not configured.
|
|
85
138
|
*/
|
|
86
139
|
export function getCommand(config, intent) {
|
|
87
140
|
if (!config) return undefined;
|
|
88
|
-
|
|
141
|
+
const own = (section) => (section && Object.prototype.hasOwnProperty.call(section, intent) ? section[intent] : undefined);
|
|
142
|
+
return own(config.commands) ?? own(config.custom);
|
|
89
143
|
}
|
|
90
144
|
|
|
91
145
|
export { CONFIG_FILENAME };
|
package/src/flows/init-flow.js
CHANGED
|
@@ -139,6 +139,16 @@ export async function runInitFlow(options, detected, projectPath) {
|
|
|
139
139
|
|
|
140
140
|
const installations = await promptSkillsInstallLocation(aiTools);
|
|
141
141
|
|
|
142
|
+
// XSPEC-468 R1: the project way is pre-selected, so an empty answer was a deliberate "no". Say what that
|
|
143
|
+
// means (nothing is written to the project) and where the skills can come from instead.
|
|
144
|
+
if (installations.length === 0) {
|
|
145
|
+
console.log();
|
|
146
|
+
console.log(chalk.yellow(msgAfterLang.skillsSkippedTitle));
|
|
147
|
+
for (const line of msgAfterLang.skillsFromPluginLines) {
|
|
148
|
+
console.log(chalk.gray(` ${line}`));
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
|
|
142
152
|
if (installations.length > 0) {
|
|
143
153
|
const isMarketplace = installations.some(i => i.level === 'marketplace');
|
|
144
154
|
|
package/src/hitl/manager.js
CHANGED
|
@@ -40,8 +40,10 @@ export class HitlManager {
|
|
|
40
40
|
}
|
|
41
41
|
|
|
42
42
|
async _promptUser(operation, riskLevel, context) {
|
|
43
|
-
// Check if we are in non-interactive mode
|
|
44
|
-
|
|
43
|
+
// Check if we are in non-interactive mode: CI, a declared non-interactive run, or no terminal to answer on.
|
|
44
|
+
// A prompt with no terminal never gets an answer; @inquirer/prompts then lets the process end with exit code 0 and a
|
|
45
|
+
// stack trace, which `uds hitl check` callers read as "approved". No one to ask means blocked, as in CI.
|
|
46
|
+
if (process.env.CI || process.env.UDS_NON_INTERACTIVE || !process.stdin.isTTY) {
|
|
45
47
|
console.log(chalk.yellow(''));
|
|
46
48
|
console.log(chalk.yellow('HITL Checkpoint triggered in non-interactive mode.'));
|
|
47
49
|
console.log(chalk.gray(` Operation: ${operation}`));
|