universal-dev-standards 6.14.0-beta.8 → 6.14.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bin/uds.js +12 -1
- package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
- package/bundled/ai/standards/commit-message.ai.yaml +12 -2
- package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
- package/bundled/core/commit-message-guide.md +22 -19
- package/bundled/core/secret-management-standards.md +13 -1
- package/bundled/extensions/locales/zh-tw.md +19 -19
- package/bundled/hooks/validate-commit-msg.mjs +52 -9
- package/bundled/locales/zh-CN/CHANGELOG.md +2312 -1102
- package/bundled/locales/zh-CN/CLAUDE.md +987 -101
- package/bundled/locales/zh-CN/README.md +3 -3
- package/bundled/locales/zh-CN/SECURITY.md +3 -3
- package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
- package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
- package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
- package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
- package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
- 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/accessibility-standards.md +871 -62
- 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-friendly-architecture.md +311 -72
- package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
- package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
- package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
- package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
- 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/changelog-standards.md +485 -63
- package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
- 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 +37 -23
- package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
- package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
- 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/deprecation-standards.md +155 -40
- package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
- package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
- package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
- package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
- package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
- package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
- package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
- package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
- package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
- 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/feature-flag-standards.md +202 -57
- package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
- package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
- 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/mutation-testing.md +45 -6
- package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
- package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
- package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
- package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
- package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
- package/bundled/locales/zh-CN/core/project-structure.md +550 -170
- 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/retrospective-standards.md +215 -22
- package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
- package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
- package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
- package/bundled/locales/zh-CN/core/security-decision.md +45 -70
- package/bundled/locales/zh-CN/core/security-standards.md +169 -16
- package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
- package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
- package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
- 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/supply-chain-security-standards.md +159 -32
- package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
- package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
- package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
- package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
- package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
- package/bundled/locales/zh-CN/core/test-governance.md +94 -43
- package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
- package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-CN/core/token-budget.md +44 -80
- package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
- package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
- package/bundled/locales/zh-CN/core/versioning.md +737 -73
- 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/CHEATSHEET.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
- package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
- package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
- package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
- 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 +2 -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/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 +2 -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/ai-instruction-standards/SKILL.md +217 -137
- 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/atdd-assistant/guide.md +148 -132
- 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/bdd-assistant/guide.md +122 -121
- package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
- package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
- 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/guide.md +119 -45
- 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 +4 -4
- package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
- package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
- package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
- package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
- 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/SKILL.md +4 -2
- 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/docs-generator/guide.md +8 -7
- 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-discovery/guide.md +158 -157
- 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/refactoring-assistant/guide.md +172 -171
- 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/guide.md +51 -43
- 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/guide.md +88 -79
- 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/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
- 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-derivation/SKILL.md +2 -2
- 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/guide.md +217 -156
- 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/test-coverage-assistant/guide.md +25 -12
- 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 +2291 -1110
- package/bundled/locales/zh-TW/CLAUDE.md +962 -76
- package/bundled/locales/zh-TW/README.md +3 -3
- package/bundled/locales/zh-TW/SECURITY.md +3 -3
- package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
- package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
- package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
- package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
- package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
- 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/accessibility-standards.md +895 -46
- 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/agent-dispatch.md +102 -33
- package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
- package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
- package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
- package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
- package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
- package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
- 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/branch-completion.md +130 -34
- 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/chaos-engineering-standards.md +138 -36
- 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 +19 -7
- package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
- package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
- package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
- package/bundled/locales/zh-TW/core/database-standards.md +2 -1
- package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
- package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
- package/bundled/locales/zh-TW/core/developer-memory.md +102 -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/environment-standards.md +250 -72
- package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
- package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
- 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/feature-flag-standards.md +202 -57
- package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
- package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
- 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/anti-hallucination-guide.md +234 -487
- package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
- package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
- package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
- package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
- 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/observability-standards.md +284 -40
- package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
- package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
- package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
- package/bundled/locales/zh-TW/core/project-context-memory.md +210 -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/runbook-standards.md +296 -23
- package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
- 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/slo-standards.md +301 -49
- package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
- package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
- package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
- package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
- package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
- package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
- package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
- package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
- package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
- package/bundled/locales/zh-TW/core/test-governance.md +92 -32
- package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
- package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-TW/core/token-budget.md +41 -112
- package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
- package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
- package/bundled/locales/zh-TW/core/versioning.md +6 -2
- package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
- package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
- package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
- package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
- package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
- package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
- package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
- 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 +2 -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/methodologies/guides/tdd-guide.md +584 -475
- 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/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 +2 -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/guide.md +137 -17
- package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
- package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
- 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/docs-generator/guide.md +4 -3
- 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/observability-assistant/SKILL.md +85 -18
- 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/SKILL.md +91 -45
- 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/language-examples.md +693 -47
- 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/.claude-plugin/plugin.json +71 -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/package.json +2 -2
- package/src/commands/audit.js +28 -1
- package/src/commands/check.js +77 -7
- package/src/commands/compile.js +37 -4
- package/src/commands/config.js +49 -24
- package/src/commands/init.js +78 -30
- package/src/commands/open-work.js +6 -2
- package/src/commands/release-messages.js +228 -0
- package/src/commands/release.js +127 -68
- package/src/commands/run-intent.js +11 -0
- package/src/commands/spec-split.js +2 -1
- package/src/commands/spec.js +11 -2
- package/src/commands/update.js +184 -30
- package/src/compilers/claude-code-compiler.js +9 -1
- package/src/config/ai-agent-paths.js +14 -1
- package/src/core/installed-formats.js +15 -0
- package/src/core/open-work-config.js +20 -1
- package/src/core/project-config.js +55 -0
- package/src/i18n/messages.js +160 -2
- package/src/installers/hooks-installer.js +1 -1
- package/src/installers/manifest-installer.js +1 -1
- package/src/installers/skills-installer.js +1 -1
- package/src/installers/standards-installer.js +3 -1
- package/src/mcp/server.js +9 -3
- package/src/prompts/init.js +26 -22
- package/src/reconciler/actual-state-scanner.js +2 -8
- package/src/reconciler/backup-locations.js +5 -0
- package/src/reconciler/backup-manager.js +19 -11
- package/src/reconciler/desired-state-calculator.js +89 -57
- package/src/reconciler/plan-executor.js +101 -8
- package/src/reconciler/recorded-versions.js +49 -0
- package/src/reconciler/relative-path.js +23 -0
- package/src/uninstallers/hook-uninstaller.js +9 -1
- package/src/uninstallers/skills-uninstaller.js +22 -3
- package/src/utils/available-standards-report.js +25 -4
- package/src/utils/available-standards.js +13 -3
- package/src/utils/build-manifest.js +1 -1
- package/src/utils/commit-message-judge.js +60 -13
- package/src/utils/friction-detector.js +23 -11
- package/src/utils/git-hooks.js +106 -4
- package/src/utils/integration-generator.js +95 -67
- package/src/utils/legacy-hook-migration.js +121 -2
- package/src/utils/open-work-tracking.mjs +105 -16
- package/src/utils/sdd-header.js +16 -4
- package/src/utils/skills-installer.js +2 -1
- package/src/utils/spinner.js +14 -4
- package/src/utils/standard-validator.js +3 -2
- package/standards-registry.json +10 -8
- package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
package/src/commands/update.js
CHANGED
|
@@ -52,6 +52,7 @@ import {
|
|
|
52
52
|
getAgentDisplayName,
|
|
53
53
|
getAgentConfig,
|
|
54
54
|
getSkillsDirForAgent,
|
|
55
|
+
hasSkillsLevel,
|
|
55
56
|
getCommandsDirForAgent
|
|
56
57
|
} from '../config/ai-agent-paths.js';
|
|
57
58
|
import { getMarketplaceSkillsInfo } from '../utils/github.js';
|
|
@@ -60,7 +61,7 @@ import { detectAITools } from '../utils/detector.js';
|
|
|
60
61
|
import { HOOK_CAPABLE_TOOLS, resolveHookTools, installMissingHooks } from '../installers/hooks-installer.js';
|
|
61
62
|
import { persistRecorder, mergeRecorderInto, newRecorder } from '../core/install-records.js';
|
|
62
63
|
import { installGateScripts, gateStandardInstalled, GATE_SCRIPTS } from '../utils/gate-scripts.js';
|
|
63
|
-
import { migrateLegacyHuskyHook } from '../utils/legacy-hook-migration.js';
|
|
64
|
+
import { migrateLegacyHuskyHook, migrateHuskyBlockWithoutCi, migrateOlderNativeHook } from '../utils/legacy-hook-migration.js';
|
|
64
65
|
import {
|
|
65
66
|
promptSkillsInstallLocation,
|
|
66
67
|
promptCommandsInstallation
|
|
@@ -76,6 +77,7 @@ import {
|
|
|
76
77
|
cleanupBackups
|
|
77
78
|
} from '../reconciler/index.js';
|
|
78
79
|
import { stepWritePaths } from '../reconciler/install-roots.js';
|
|
80
|
+
import { alignRecordedVersions, alignUpstreamVersion } from '../reconciler/recorded-versions.js';
|
|
79
81
|
import { restoreSingleFile } from './check.js';
|
|
80
82
|
import { guardAgainstSelfAdoption } from '../utils/detect-self-adoption.js';
|
|
81
83
|
import { resolveIntegrationFile, SUPPORTED_AI_TOOLS, getToolFormat } from '../core/constants.js';
|
|
@@ -513,6 +515,11 @@ export async function updateCommand(options) {
|
|
|
513
515
|
migrateLegacyPreCommitHook(projectPath, manifest, { plan: !!options.plan });
|
|
514
516
|
}
|
|
515
517
|
|
|
518
|
+
if (options.from && !options.rollback) {
|
|
519
|
+
console.log(chalk.yellow(' ! --from names the backup for --rollback; without --rollback it does nothing and is ignored.'));
|
|
520
|
+
console.log();
|
|
521
|
+
}
|
|
522
|
+
|
|
516
523
|
// Handle --rollback option (DSR). It restores a whole backup, so a scope
|
|
517
524
|
// flag cannot narrow it — say so rather than appearing to honour it.
|
|
518
525
|
if (options.rollback) {
|
|
@@ -520,7 +527,7 @@ export async function updateCommand(options) {
|
|
|
520
527
|
console.log(chalk.yellow(' ! --rollback restores a complete backup; --skills/--commands cannot narrow it and are ignored.'));
|
|
521
528
|
console.log();
|
|
522
529
|
}
|
|
523
|
-
await handleRollback(projectPath);
|
|
530
|
+
await handleRollback(projectPath, options);
|
|
524
531
|
return;
|
|
525
532
|
}
|
|
526
533
|
|
|
@@ -1707,29 +1714,30 @@ async function offerErrorExitGate(projectPath, options) {
|
|
|
1707
1714
|
const src = join(getRepoRoot(), 'templates', 'gates', 'check-error-exit.mjs');
|
|
1708
1715
|
if (!existsSync(src)) return; // 範本沒出貨——沉默,不要假裝提供了
|
|
1709
1716
|
|
|
1710
|
-
|
|
1711
|
-
console.log(chalk.
|
|
1712
|
-
console.log(chalk.gray(
|
|
1713
|
-
console.log(chalk.gray(
|
|
1714
|
-
console.log(chalk.gray('
|
|
1715
|
-
console.log(chalk.gray(
|
|
1717
|
+
const m = t().commands.update.errorExitOffer;
|
|
1718
|
+
console.log(chalk.bold(m.title));
|
|
1719
|
+
console.log(chalk.gray(m.guards));
|
|
1720
|
+
console.log(chalk.gray(m.drift));
|
|
1721
|
+
console.log(chalk.gray(m.willWrite.replace('{kb}', String(Math.round(readFileSync(src, 'utf-8').length / 1024)))));
|
|
1722
|
+
console.log(chalk.gray(m.exit2a));
|
|
1723
|
+
console.log(chalk.gray(m.exit2b));
|
|
1716
1724
|
console.log();
|
|
1717
1725
|
|
|
1718
1726
|
const ok = await confirmOrFail({
|
|
1719
|
-
message:
|
|
1727
|
+
message: m.question,
|
|
1720
1728
|
defaultValue: false, // 🔴 預設不寫。沉默不是同意。
|
|
1721
1729
|
options
|
|
1722
1730
|
});
|
|
1723
1731
|
if (!ok) {
|
|
1724
|
-
console.log(chalk.gray(
|
|
1732
|
+
console.log(chalk.gray(m.skipped));
|
|
1725
1733
|
console.log();
|
|
1726
1734
|
return;
|
|
1727
1735
|
}
|
|
1728
1736
|
|
|
1729
1737
|
mkdirSync(dirname(dest), { recursive: true });
|
|
1730
1738
|
writeFileSync(dest, readFileSync(src, 'utf-8'), 'utf-8');
|
|
1731
|
-
console.log(chalk.green(
|
|
1732
|
-
console.log(chalk.gray(
|
|
1739
|
+
console.log(chalk.green(m.written));
|
|
1740
|
+
console.log(chalk.gray(m.next));
|
|
1733
1741
|
console.log();
|
|
1734
1742
|
}
|
|
1735
1743
|
|
|
@@ -1939,7 +1947,6 @@ export function migrateLegacyPreCommitHook(projectPath, manifest, { plan = false
|
|
|
1939
1947
|
if (r.state === 'error') {
|
|
1940
1948
|
console.log(chalk.yellow(` ${msg.hookMigrateFailed.replace('{error}', r.error)}`));
|
|
1941
1949
|
console.log();
|
|
1942
|
-
return r;
|
|
1943
1950
|
}
|
|
1944
1951
|
if (r.state === 'migrated') console.log(chalk.green(` ${msg.hookMigrated}`));
|
|
1945
1952
|
if (r.state === 'would-migrate') console.log(chalk.cyan(` ${msg.hookWouldMigrate}`));
|
|
@@ -1953,6 +1960,30 @@ export function migrateLegacyPreCommitHook(projectPath, manifest, { plan = false
|
|
|
1953
1960
|
// this the record persisted just above would be overwritten by the older copy.
|
|
1954
1961
|
Object.assign(manifest, mergeRecorderInto(manifest, r.recorder));
|
|
1955
1962
|
}
|
|
1963
|
+
|
|
1964
|
+
// XSPEC-482 R3 + R5: hooks that run the check and cannot stop a commit - the husky block that runs `check`
|
|
1965
|
+
// without `--ci`, and the native hook of 5.x .. 6.13.1 / the betas. Same treatment as above: only a text UDS
|
|
1966
|
+
// provably wrote is replaced, anything else is named and left alone, and --plan lists it.
|
|
1967
|
+
const huskyCi = migrateHuskyBlockWithoutCi(projectPath, { plan, manifest });
|
|
1968
|
+
if (huskyCi.state === 'error') console.log(chalk.yellow(` ${msg.hookMigrateFailed.replace('{error}', huskyCi.error)}`));
|
|
1969
|
+
if (huskyCi.state === 'migrated') console.log(chalk.green(` ${msg.hookHuskyCiMigrated}`)); // wire:update-migrates-husky-ci
|
|
1970
|
+
if (huskyCi.state === 'would-migrate') console.log(chalk.cyan(` ${msg.hookHuskyCiWouldMigrate}`));
|
|
1971
|
+
|
|
1972
|
+
const native = migrateOlderNativeHook(projectPath, { plan }); // wire:update-migrates-native-hook
|
|
1973
|
+
const nativeFrom = native.from === 'legacy-6.11' ? msg.hookNativeFromLegacy : msg.hookNativeFromWithoutCi;
|
|
1974
|
+
if (native.state === 'error') console.log(chalk.yellow(` ${msg.hookNativeFailed.replace('{error}', native.error)}`));
|
|
1975
|
+
if (native.state === 'migrated') console.log(chalk.green(` ${msg.hookNativeMigrated.replace('{from}', nativeFrom)}`));
|
|
1976
|
+
if (native.state === 'would-migrate') console.log(chalk.cyan(` ${msg.hookNativeWouldMigrate.replace('{from}', nativeFrom)}`));
|
|
1977
|
+
for (const k of native.kept) {
|
|
1978
|
+
console.log(chalk.yellow(` ${msg.hookNativeKept.replace('{line}', k.line).replace('{text}', k.text)}`));
|
|
1979
|
+
}
|
|
1980
|
+
if (huskyCi.state !== 'none' || native.state !== 'none') console.log();
|
|
1981
|
+
for (const extra of [huskyCi.recorder, native.recorder]) {
|
|
1982
|
+
if (extra) {
|
|
1983
|
+
persistRecorder(projectPath, extra);
|
|
1984
|
+
Object.assign(manifest, mergeRecorderInto(manifest, extra));
|
|
1985
|
+
}
|
|
1986
|
+
}
|
|
1956
1987
|
return r;
|
|
1957
1988
|
}
|
|
1958
1989
|
|
|
@@ -2723,13 +2754,21 @@ async function planSkills(projectPath, manifest, options) {
|
|
|
2723
2754
|
return;
|
|
2724
2755
|
}
|
|
2725
2756
|
|
|
2757
|
+
// XSPEC-482 R7: "unchanged" needs the files to agree too, as `uds update --plan` judges them - a recorded version
|
|
2758
|
+
// equal to the shipped one says nothing about a skill file that was deleted or edited.
|
|
2759
|
+
const skillActions = await skillActionsOf(projectPath);
|
|
2760
|
+
|
|
2726
2761
|
let changed = 0;
|
|
2727
2762
|
for (const inst of installations) {
|
|
2728
2763
|
const info = getInstalledSkillsInfoForAgent(inst.agent, inst.level, projectPath);
|
|
2729
2764
|
const current = info?.version || 'unknown';
|
|
2730
|
-
const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath);
|
|
2731
|
-
|
|
2765
|
+
const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath) ?? '(no such folder)'; // XSPEC-486: null when the tool has no folder at that level
|
|
2766
|
+
const differing = skillActions.filter((a) => a.details?.metadata?.agent === inst.agent && (a.details?.metadata?.level || 'project') === inst.level);
|
|
2767
|
+
if (current === latestVersion && differing.length === 0) {
|
|
2732
2768
|
console.log(chalk.gray(` = ${getAgentDisplayName(inst.agent)} (${inst.level}): v${current} — unchanged`));
|
|
2769
|
+
} else if (current === latestVersion) {
|
|
2770
|
+
changed++;
|
|
2771
|
+
console.log(chalk.yellow(` ~ ${getAgentDisplayName(inst.agent)} (${inst.level}): v${current} — ${differing.length} skill file(s) differ from what this UDS ships ${dir}`));
|
|
2733
2772
|
} else {
|
|
2734
2773
|
changed++;
|
|
2735
2774
|
console.log(chalk.yellow(` ~ ${getAgentDisplayName(inst.agent)} (${inst.level}): v${current} → v${latestVersion} ${dir}`));
|
|
@@ -2758,21 +2797,44 @@ async function planCommands(projectPath, manifest, options) {
|
|
|
2758
2797
|
return;
|
|
2759
2798
|
}
|
|
2760
2799
|
|
|
2800
|
+
// XSPEC-482 R7: ask the reconciler, the same question `uds update --plan` answers, instead of saying "would be
|
|
2801
|
+
// reinstalled" for every installation whatever is on disk. A project that is current used to get "51 command(s)
|
|
2802
|
+
// would be reinstalled" here, "unchanged" from `--plan --skills` and "No changes" from `--plan`.
|
|
2803
|
+
const actions = await commandActionsOf(projectPath);
|
|
2804
|
+
|
|
2805
|
+
let changed = 0;
|
|
2761
2806
|
for (const inst of installations) {
|
|
2762
2807
|
const agent = typeof inst === 'string' ? inst : inst.agent;
|
|
2763
2808
|
const level = typeof inst === 'string' ? 'project' : (inst.level || 'project');
|
|
2764
2809
|
const info = getInstalledCommandsForAgent(agent, level, projectPath);
|
|
2765
2810
|
const dir = getCommandsDirForAgent(agent, level, projectPath);
|
|
2766
|
-
|
|
2811
|
+
const differing = actions.filter((a) => a.details?.metadata?.agent === agent && (a.details?.metadata?.level || 'project') === level);
|
|
2812
|
+
if (differing.length === 0) {
|
|
2813
|
+
console.log(chalk.gray(` = ${getAgentDisplayName(agent)} (${level}): ${info?.count || 0} command(s) — unchanged`));
|
|
2814
|
+
} else {
|
|
2815
|
+
changed++;
|
|
2816
|
+
console.log(chalk.yellow(` ~ ${getAgentDisplayName(agent)} (${level}): ${differing.length} command file(s) would be written or removed ${dir}`)); // wire:plan-commands-asks-reconciler
|
|
2817
|
+
}
|
|
2767
2818
|
}
|
|
2768
2819
|
|
|
2769
2820
|
console.log();
|
|
2770
|
-
console.log(`Summary: ${
|
|
2821
|
+
console.log(`Summary: ${changed} installation(s) would be reinstalled, ${installations.length - changed} unchanged.`);
|
|
2771
2822
|
console.log(chalk.gray(` Locale that would be used: ${resolveLocale(manifest, projectPath, options)}`));
|
|
2772
|
-
console.log(chalk.gray(' Run `uds update --apply --yes --commands` to apply.'));
|
|
2823
|
+
if (changed > 0) console.log(chalk.gray(' Run `uds update --apply --yes --commands` to apply.'));
|
|
2773
2824
|
console.log();
|
|
2774
2825
|
}
|
|
2775
2826
|
|
|
2827
|
+
/** The reconciler's plan actions for skill and command files (what `uds update --plan` would list). */
|
|
2828
|
+
async function commandActionsOf(projectPath) {
|
|
2829
|
+
const { plan } = await reconcilerPlan(projectPath, {});
|
|
2830
|
+
return plan.actions.filter((a) => a.category === 'command');
|
|
2831
|
+
}
|
|
2832
|
+
|
|
2833
|
+
async function skillActionsOf(projectPath) {
|
|
2834
|
+
const { plan } = await reconcilerPlan(projectPath, {});
|
|
2835
|
+
return plan.actions.filter((a) => a.category === 'skill');
|
|
2836
|
+
}
|
|
2837
|
+
|
|
2776
2838
|
async function updateSkillsOnly(projectPath, manifest, options) {
|
|
2777
2839
|
const msg = t().commands.update;
|
|
2778
2840
|
const repoInfo = getRepositoryInfo();
|
|
@@ -2818,7 +2880,19 @@ async function updateSkillsOnly(projectPath, manifest, options) {
|
|
|
2818
2880
|
return Boolean(config?.supportsSkills && config?.skills);
|
|
2819
2881
|
});
|
|
2820
2882
|
const agents = detectedSkillsTools.length > 0 ? detectedSkillsTools : ['claude-code'];
|
|
2821
|
-
|
|
2883
|
+
// XSPEC-486 R2: a tool with no folder at the recorded level (antigravity has no user-level one) is not given
|
|
2884
|
+
// an installation that has nowhere to go.
|
|
2885
|
+
// …and the run says so, as `init` and `config` do (beta.15 Windows retest, Issue 1: this path was silent).
|
|
2886
|
+
for (const agent of agents) {
|
|
2887
|
+
if (hasSkillsLevel(agent, legacyLocation)) {
|
|
2888
|
+
skillsInstallations.push({ agent, level: legacyLocation });
|
|
2889
|
+
} else {
|
|
2890
|
+
console.log(chalk.yellow(
|
|
2891
|
+
`⚠ ${getAgentDisplayName(agent) || agent}: ` +
|
|
2892
|
+
`${msg.skillsNoUserPath || 'has no user-level skills folder (only the project one), so this update left it out. To put its skills into this project instead: uds config --type skills --ai-tool antigravity --skills-location project'}`
|
|
2893
|
+
));
|
|
2894
|
+
}
|
|
2895
|
+
}
|
|
2822
2896
|
} else if (legacyLocation === 'marketplace') {
|
|
2823
2897
|
console.log(chalk.yellow(msg.skillsViaMarketplace || 'Skills installed via Marketplace'));
|
|
2824
2898
|
console.log(chalk.gray(` ${msg.updateViaMarketplace || 'Update through Plugin Marketplace'}`));
|
|
@@ -2891,7 +2965,7 @@ async function updateSkillsOnly(projectPath, manifest, options) {
|
|
|
2891
2965
|
// Build location summary
|
|
2892
2966
|
const locations = fileBasedInstallations.map(inst => {
|
|
2893
2967
|
const displayName = getAgentDisplayName(inst.agent);
|
|
2894
|
-
const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath);
|
|
2968
|
+
const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath) ?? '(no such folder)'; // XSPEC-486
|
|
2895
2969
|
return `${displayName}: ${dir}`;
|
|
2896
2970
|
}).join(', ');
|
|
2897
2971
|
|
|
@@ -3365,7 +3439,7 @@ async function promptNewFeatureInstallation(missingSkills, outdatedSkills, missi
|
|
|
3365
3439
|
console.log(chalk.yellow(msg.skillsOutdatedFor || 'Skills updates available for these AI tools:'));
|
|
3366
3440
|
for (const skill of outdatedSkills) {
|
|
3367
3441
|
const levelLabel = skill.level === 'user' ? 'user' : 'project';
|
|
3368
|
-
const pathDisplay = skill.path || getSkillsDirForAgent(skill.agent, skill.level);
|
|
3442
|
+
const pathDisplay = skill.path || getSkillsDirForAgent(skill.agent, skill.level) || '(no such folder)';
|
|
3369
3443
|
console.log(chalk.gray(` • ${skill.displayName} (${levelLabel}: ${pathDisplay})`));
|
|
3370
3444
|
console.log(chalk.gray(` ${skill.currentVersion} → ${skill.latestVersion}`));
|
|
3371
3445
|
}
|
|
@@ -3374,7 +3448,7 @@ async function promptNewFeatureInstallation(missingSkills, outdatedSkills, missi
|
|
|
3374
3448
|
// Build checkbox choices with path info
|
|
3375
3449
|
const updateChoices = outdatedSkills.map(skill => {
|
|
3376
3450
|
const levelLabel = skill.level === 'user' ? 'user' : 'project';
|
|
3377
|
-
const pathDisplay = skill.path || getSkillsDirForAgent(skill.agent, skill.level);
|
|
3451
|
+
const pathDisplay = skill.path || getSkillsDirForAgent(skill.agent, skill.level) || '(no such folder)';
|
|
3378
3452
|
return {
|
|
3379
3453
|
name: `${skill.displayName} ${chalk.gray(`(${levelLabel}: ${pathDisplay}) ${skill.currentVersion} → ${skill.latestVersion}`)}`,
|
|
3380
3454
|
value: skill.agent,
|
|
@@ -3510,14 +3584,14 @@ function takeStepBackup(projectPath, label, installations, kind) {
|
|
|
3510
3584
|
console.log();
|
|
3511
3585
|
return { ok: false };
|
|
3512
3586
|
}
|
|
3513
|
-
cleanupBackupsQuietly(projectPath);
|
|
3514
|
-
return { ok: true, backupId: backup.backupId };
|
|
3587
|
+
return { ok: true, backupId: backup.backupId, cleanup: cleanupBackupsQuietly(projectPath) };
|
|
3515
3588
|
}
|
|
3516
3589
|
|
|
3517
3590
|
/** The step is over (its last manifest write is done): record what it created, and say how to undo it. */
|
|
3518
3591
|
function finishStepBackup(projectPath, backup) {
|
|
3519
3592
|
finalizeBackup(projectPath, backup.backupId);
|
|
3520
3593
|
printBackupLocation(backup.backupId);
|
|
3594
|
+
printBackupCleanup(backup.cleanup);
|
|
3521
3595
|
}
|
|
3522
3596
|
|
|
3523
3597
|
/**
|
|
@@ -3533,9 +3607,34 @@ function printBackupLocation(backupId) {
|
|
|
3533
3607
|
|
|
3534
3608
|
function cleanupBackupsQuietly(projectPath) {
|
|
3535
3609
|
try {
|
|
3536
|
-
cleanupBackups(projectPath);
|
|
3610
|
+
return cleanupBackups(projectPath);
|
|
3537
3611
|
} catch {
|
|
3538
3612
|
// an old backup that cannot be removed is not a reason to stop the update
|
|
3613
|
+
return null;
|
|
3614
|
+
}
|
|
3615
|
+
}
|
|
3616
|
+
|
|
3617
|
+
/**
|
|
3618
|
+
* Say what the backup limit did (XSPEC-475 R2). A backup is the adopter's data: one deleted without a word
|
|
3619
|
+
* is how an adopter loses the only copy of something version control cannot give back.
|
|
3620
|
+
* - every backup removed because `.uds-backups/` holds more than the limit is named;
|
|
3621
|
+
* - backups an older UDS left in the project root (`.uds-backup-*`) are never removed by the limit; they
|
|
3622
|
+
* are listed here with a suggestion to move them out themselves.
|
|
3623
|
+
* // implements XSPEC-475 R2
|
|
3624
|
+
*/
|
|
3625
|
+
function printBackupCleanup(cleanup) {
|
|
3626
|
+
if (!cleanup) return;
|
|
3627
|
+
const removed = cleanup.removed || [];
|
|
3628
|
+
const legacy = cleanup.legacyKept || [];
|
|
3629
|
+
if (removed.length > 0) {
|
|
3630
|
+
console.log(chalk.yellow(` Removed ${removed.length} old backup(s) beyond the limit of ${cleanup.keep} in .uds-backups/:`));
|
|
3631
|
+
for (const id of removed) console.log(chalk.yellow(` ✕ ${id}`));
|
|
3632
|
+
}
|
|
3633
|
+
for (const err of cleanup.errors || []) console.log(chalk.red(` ${err}`));
|
|
3634
|
+
if (legacy.length > 0) {
|
|
3635
|
+
console.log(chalk.yellow(` ${legacy.length} backup(s) from an older UDS are still in the project root and were NOT removed by the limit:`));
|
|
3636
|
+
for (const id of legacy) console.log(chalk.yellow(` - ${id}`));
|
|
3637
|
+
console.log(chalk.gray(' UDS never deletes these. If you need them, move them out of the project yourself (for example, to a folder outside the repository).'));
|
|
3539
3638
|
}
|
|
3540
3639
|
}
|
|
3541
3640
|
|
|
@@ -3550,20 +3649,37 @@ function printPaths(prefix, paths, limit, colour) {
|
|
|
3550
3649
|
* updates, then say, item by item, what was restored, what was removed, and what was NOT put back.
|
|
3551
3650
|
* It never ends in "successful" while any of those lists is not empty (XSPEC-454 R1).
|
|
3552
3651
|
*/
|
|
3553
|
-
async function handleRollback(projectPath) {
|
|
3652
|
+
async function handleRollback(projectPath, options = {}) {
|
|
3554
3653
|
const backups = listBackups(projectPath);
|
|
3555
3654
|
if (backups.length === 0) {
|
|
3556
3655
|
console.log(chalk.yellow('No backups found. Nothing to rollback.'));
|
|
3557
3656
|
console.log();
|
|
3657
|
+
if (options.from) process.exitCode = 1;
|
|
3558
3658
|
return;
|
|
3559
3659
|
}
|
|
3560
3660
|
|
|
3561
|
-
|
|
3661
|
+
// XSPEC-482 R11: `--from` names the one backup to restore. The default picks the newest series, and a backup an older
|
|
3662
|
+
// UDS made is never in it (it records no manifest hash to chain on), so without this there was no way to reach it.
|
|
3663
|
+
let chosen = null;
|
|
3664
|
+
if (options.from) {
|
|
3665
|
+
const wanted = String(options.from).replace(/\\/g, '/').replace(/\/+$/, '');
|
|
3666
|
+
const leaf = (id) => id.slice(id.lastIndexOf('/') + 1);
|
|
3667
|
+
chosen = backups.find((b) => b.backupId === wanted) || backups.find((b) => leaf(b.backupId) === leaf(wanted));
|
|
3668
|
+
if (!chosen) {
|
|
3669
|
+
console.log(chalk.red(`No backup named "${options.from}". Backups in this project:`));
|
|
3670
|
+
for (const b of backups) console.log(chalk.gray(` ${b.backupId} (${b.createdAt || 'no date'})`));
|
|
3671
|
+
console.log();
|
|
3672
|
+
process.exitCode = 1;
|
|
3673
|
+
return;
|
|
3674
|
+
}
|
|
3675
|
+
}
|
|
3676
|
+
|
|
3677
|
+
const latest = chosen || backups[0];
|
|
3562
3678
|
console.log(chalk.cyan(`Rolling back from: ${latest.backupId}`));
|
|
3563
3679
|
console.log(chalk.gray(` Created: ${latest.createdAt}`));
|
|
3564
3680
|
console.log();
|
|
3565
3681
|
|
|
3566
|
-
const result = rollbackLast(projectPath);
|
|
3682
|
+
const result = rollbackLast(projectPath, chosen ? chosen.backupId : undefined);
|
|
3567
3683
|
|
|
3568
3684
|
for (const step of result.steps || []) {
|
|
3569
3685
|
console.log(chalk.cyan(`${step.backupId}${step.label ? ` (${step.label})` : ''}`));
|
|
@@ -3581,7 +3697,16 @@ async function handleRollback(projectPath) {
|
|
|
3581
3697
|
console.log(chalk.gray(` ${result.steps.length} consecutive updates were undone together (each one started from where the previous one ended).`));
|
|
3582
3698
|
}
|
|
3583
3699
|
if (result.olderBackups > 0) {
|
|
3584
|
-
|
|
3700
|
+
// Say the true reason. A backup an older UDS made records no manifest hash, so there is nothing to tell whether it
|
|
3701
|
+
// continues the series; one that does carry the hash and still does not match means something else changed the project.
|
|
3702
|
+
const inSeries = (result.steps || []).length;
|
|
3703
|
+
const next = backups[inSeries];
|
|
3704
|
+
const why = next && !next.postManifestHash
|
|
3705
|
+
? 'it was made by an older UDS, which did not record what links one backup to the next, so it cannot be joined to the series'
|
|
3706
|
+
: 'something else changed the project after it was made';
|
|
3707
|
+
console.log(chalk.gray(` ${result.olderBackups} older backup(s) are not part of that series (${why}) and were left alone.`));
|
|
3708
|
+
console.log(chalk.gray(' To restore one of them on its own: `uds update --rollback --from <backup>`. They are:'));
|
|
3709
|
+
for (const b of backups.slice(inSeries)) console.log(chalk.gray(` ${b.backupId} (${b.createdAt || 'no date'})`)); // wire:rollback-names-older-backups
|
|
3585
3710
|
}
|
|
3586
3711
|
|
|
3587
3712
|
if (result.errors.length > 0) {
|
|
@@ -3676,8 +3801,24 @@ async function handleReconcile(projectPath, options, { force, addStandards = []
|
|
|
3676
3801
|
// XSPEC-454 R2: nothing to apply, but the manifest may still list skill files UDS never installed
|
|
3677
3802
|
// (they only ever get corrected by a write, and an up-to-date project has none coming).
|
|
3678
3803
|
const current = readManifest(projectPath);
|
|
3679
|
-
|
|
3804
|
+
// XSPEC-475 R6: nothing to apply means the files are what this UDS ships; the recorded versions say so too.
|
|
3805
|
+
let aligned = current ? alignRecordedVersions(current).changed : false; // wire:up-to-date-aligns-versions
|
|
3806
|
+
// XSPEC-482 R6: the same for the standards version, which only an executed plan used to record.
|
|
3807
|
+
if (current && alignUpstreamVersion(current).changed) aligned = true; // wire:up-to-date-aligns-upstream
|
|
3808
|
+
// XSPEC-456 R4 (kept through XSPEC-482 R6): the NAME lists are corrected here too. This early return used to be reached only by
|
|
3809
|
+
// a project that had nothing else to rewrite, which a fresh `uds init` almost never was; once init leaves the project current
|
|
3810
|
+
// it is the normal case, and the names UDS cannot vouch for (`_shared`, a retired skill) stayed in the manifest for good.
|
|
3811
|
+
// Ownership test only, as the reconciler does (no disk test).
|
|
3812
|
+
let droppedNames = 0;
|
|
3813
|
+
if (current) {
|
|
3814
|
+
const before = (current.skills?.names?.length || 0) + (current.commands?.names?.length || 0);
|
|
3815
|
+
pruneForeignSkillNames(current, '');
|
|
3816
|
+
pruneForeignCommandNames(current, '');
|
|
3817
|
+
droppedNames = before - ((current.skills?.names?.length || 0) + (current.commands?.names?.length || 0)); // wire:up-to-date-prunes-names
|
|
3818
|
+
}
|
|
3819
|
+
if (current && ((pruneForeignSkillHashes(current).length + pruneForeignCommandHashes(current).length) > 0 || aligned || droppedNames > 0)) writeManifest(current, projectPath);
|
|
3680
3820
|
console.log(chalk.green('Everything is up to date. No changes needed.'));
|
|
3821
|
+
if (droppedNames > 0) console.log(chalk.gray(` ${t().commands.update.droppedForeignNames.replace('{count}', droppedNames)}`));
|
|
3681
3822
|
// XSPEC-458 R2: "up to date" is about the files UDS manages; say what UDS ships that is not managed here.
|
|
3682
3823
|
printAvailableStandardsSection(planResult.manifest, { phase: 'apply' });
|
|
3683
3824
|
console.log();
|
|
@@ -3720,6 +3861,7 @@ async function handleReconcile(projectPath, options, { force, addStandards = []
|
|
|
3720
3861
|
|
|
3721
3862
|
if (result.execution?.backupId) {
|
|
3722
3863
|
printBackupLocation(result.execution.backupId);
|
|
3864
|
+
printBackupCleanup(result.execution.backupCleanup);
|
|
3723
3865
|
}
|
|
3724
3866
|
|
|
3725
3867
|
if (result.errors.length > 0) {
|
|
@@ -3730,6 +3872,18 @@ async function handleReconcile(projectPath, options, { force, addStandards = []
|
|
|
3730
3872
|
}
|
|
3731
3873
|
}
|
|
3732
3874
|
|
|
3875
|
+
if (!result.success) {
|
|
3876
|
+
// XSPEC-482 R10: say what a partly failed run left behind and the way to finish it.
|
|
3877
|
+
console.log();
|
|
3878
|
+
console.log(chalk.yellow(
|
|
3879
|
+
'Not everything was applied. The overall version record did not advance, and a skills or commands batch that failed keeps its ' +
|
|
3880
|
+
'old version record; a batch that succeeded has already recorded its new version. ' +
|
|
3881
|
+
'Fix the cause, then run `uds update --apply` again: it completes what is left.'
|
|
3882
|
+
));
|
|
3883
|
+
// XSPEC-482 R2: a failed action is a failed run. CI and scripts read the exit code, not the colour of a line.
|
|
3884
|
+
process.exitCode = 1; // wire:apply-fails-exit-1
|
|
3885
|
+
}
|
|
3886
|
+
|
|
3733
3887
|
// XSPEC-458 R2: the count of what UDS ships and this project lacks, with the command that installs one.
|
|
3734
3888
|
printAvailableStandardsSection(result.manifest || planResult.manifest, { phase: 'apply' });
|
|
3735
3889
|
console.log();
|
|
@@ -8,6 +8,7 @@
|
|
|
8
8
|
*/
|
|
9
9
|
|
|
10
10
|
import { BaseCompiler } from './base-compiler.js';
|
|
11
|
+
import { normalizeMatcher } from '../installers/hooks-installer.js';
|
|
11
12
|
|
|
12
13
|
const DEFAULT_MATCHERS = {
|
|
13
14
|
UserPromptSubmit: '',
|
|
@@ -27,7 +28,14 @@ export class ClaudeCodeCompiler extends BaseCompiler {
|
|
|
27
28
|
|
|
28
29
|
for (const std of enforceable) {
|
|
29
30
|
const { hook_script, trigger } = std.enforcement;
|
|
30
|
-
|
|
31
|
+
// Claude Code's matcher is a string (https://code.claude.com/docs/en/hooks, "Matcher patterns"). A standard may
|
|
32
|
+
// declare it as an object (`matcher: { tool: Write, path: "src/**/*.ts" }`); that used to be written to
|
|
33
|
+
// settings.json as the object, which the documented format has no place for (XSPEC-482 R4). Same reduction
|
|
34
|
+
// `uds init --with-hooks` and `uds update --with-hooks` apply, so the three write one format.
|
|
35
|
+
const declared = std.enforcement.matcher;
|
|
36
|
+
const matcher = declared === undefined || declared === null
|
|
37
|
+
? (DEFAULT_MATCHERS[trigger] ?? '')
|
|
38
|
+
: normalizeMatcher(declared); // wire:compile-matcher-is-a-string
|
|
31
39
|
|
|
32
40
|
if (!hooks[trigger]) {
|
|
33
41
|
hooks[trigger] = [];
|
|
@@ -354,13 +354,26 @@ export function getSkillsDirForAgent(agent, level = 'user', projectPath = null)
|
|
|
354
354
|
if (!config || !config.skills) return null;
|
|
355
355
|
|
|
356
356
|
if (level === 'user') {
|
|
357
|
-
|
|
357
|
+
// A tool can have no user-level folder (antigravity, on purpose). `null`, never `undefined`: every caller
|
|
358
|
+
// already treats a falsy answer as "no such place" (XSPEC-486 R2).
|
|
359
|
+
return config.skills.user || null; // wire:skills-dir-user-null-not-undefined
|
|
358
360
|
} else if (level === 'project' && projectPath) {
|
|
359
361
|
return join(projectPath, config.skills.project);
|
|
360
362
|
}
|
|
361
363
|
return null;
|
|
362
364
|
}
|
|
363
365
|
|
|
366
|
+
/**
|
|
367
|
+
* Does the agent have a skills folder at this level? A tool may have only a project folder (antigravity: agy
|
|
368
|
+
* knows one skills location, the workspace) - then no user-level skills can be listed, installed or removed.
|
|
369
|
+
* @param {string} agent - Agent identifier
|
|
370
|
+
* @param {string} level - 'user' or 'project'
|
|
371
|
+
* @returns {boolean}
|
|
372
|
+
*/
|
|
373
|
+
export function hasSkillsLevel(agent, level) {
|
|
374
|
+
return Boolean(AI_AGENT_PATHS[agent]?.skills?.[level]);
|
|
375
|
+
}
|
|
376
|
+
|
|
364
377
|
/**
|
|
365
378
|
* Get commands directory path for an agent
|
|
366
379
|
* @param {string} agent - Agent identifier
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Which file formats a manifest's `format` setting puts on disk.
|
|
3
|
+
*
|
|
4
|
+
* `both` is not a third kind of file: it is the human copy (.md) and the AI copy (.ai.yaml) of every standard and
|
|
5
|
+
* every option, side by side. The installer copies once per entry of this list, and the reconciler has to expect
|
|
6
|
+
* exactly the same set. When the reconciler read `both` as one format it resolved only the human copy and planned
|
|
7
|
+
* to delete every AI copy the installer had just written (XSPEC-483).
|
|
8
|
+
*
|
|
9
|
+
* @param {string} [format] - 'ai', 'human' or 'both'. Anything else, including a missing value, is read as 'ai'.
|
|
10
|
+
* @returns {string[]} The formats to resolve a source file in: ['ai', 'human'] for 'both', otherwise one entry.
|
|
11
|
+
*/
|
|
12
|
+
export function getInstalledFormats(format) {
|
|
13
|
+
if (format === 'both') return ['ai', 'human'];
|
|
14
|
+
return [format || 'ai'];
|
|
15
|
+
}
|
|
@@ -11,6 +11,10 @@
|
|
|
11
11
|
* - 待辦
|
|
12
12
|
* command_words: # extra program names read as a command in a next action or a draft
|
|
13
13
|
* - kubectl
|
|
14
|
+
* asked_at_words: # extra words that head the "when was it asked" column (XSPEC-475 R3)
|
|
15
|
+
* - 何時問
|
|
16
|
+
* waiting_for_words: # extra words that head the "what is it waiting for" column (XSPEC-475 R3)
|
|
17
|
+
* - 問什麼
|
|
14
18
|
*
|
|
15
19
|
* This file holds no rule. It turns the section into the same `--root NAME=DIR` and
|
|
16
20
|
* `--next-action-word WORD` arguments a person could type, and hands them to the checker, which
|
|
@@ -36,7 +40,7 @@ import { PROJECT_NAME } from '../utils/open-work-tracking.mjs';
|
|
|
36
40
|
* `error`: the file is readable and its open_work section is wrong (the command stops with exit 2).
|
|
37
41
|
*/
|
|
38
42
|
export function readOpenWorkDeclarations(cwd = process.cwd()) {
|
|
39
|
-
const out = { projects: {}, nextActionWords: [], commandWords: [], note: null, error: null };
|
|
43
|
+
const out = { projects: {}, nextActionWords: [], commandWords: [], askedAtWords: [], waitingForWords: [], note: null, error: null };
|
|
40
44
|
let config;
|
|
41
45
|
try {
|
|
42
46
|
config = loadProjectConfig(cwd);
|
|
@@ -71,6 +75,14 @@ export function readOpenWorkDeclarations(cwd = process.cwd()) {
|
|
|
71
75
|
out.commandWords.push(w);
|
|
72
76
|
}
|
|
73
77
|
}
|
|
78
|
+
for (const [key, into] of [['asked_at_words', out.askedAtWords], ['waiting_for_words', out.waitingForWords]]) {
|
|
79
|
+
if (section[key] === undefined || section[key] === null) continue;
|
|
80
|
+
if (!Array.isArray(section[key])) return bad(`.${key} must be a list of words`);
|
|
81
|
+
for (const w of section[key]) {
|
|
82
|
+
if (typeof w !== 'string') return bad(`.${key} must hold text only; write each word as plain text`);
|
|
83
|
+
into.push(w);
|
|
84
|
+
}
|
|
85
|
+
}
|
|
74
86
|
return out;
|
|
75
87
|
}
|
|
76
88
|
|
|
@@ -101,3 +113,10 @@ export function wordArguments(cliWords, declaredWords = []) {
|
|
|
101
113
|
for (const w of [].concat(cliWords ?? [], declaredWords)) argv.push('--next-action-word', w);
|
|
102
114
|
return argv;
|
|
103
115
|
}
|
|
116
|
+
|
|
117
|
+
/** The `--asked-at-word` or `--waiting-for-word` arguments (XSPEC-475 R3): the command line's words, then the file's. */
|
|
118
|
+
export function fieldWordArguments(flag, cliWords, declaredWords = []) {
|
|
119
|
+
const argv = [];
|
|
120
|
+
for (const w of [].concat(cliWords ?? [], declaredWords)) argv.push(flag, w);
|
|
121
|
+
return argv;
|
|
122
|
+
}
|
|
@@ -98,6 +98,61 @@ function validateConfig(config, filePath) {
|
|
|
98
98
|
}
|
|
99
99
|
}
|
|
100
100
|
|
|
101
|
+
/**
|
|
102
|
+
* True when `text` ends inside an open quote, reading it the way a shell does: a `'` inside `"..."` (and a `"` inside
|
|
103
|
+
* `'...'`) is plain text, and a backslash escapes the next character outside single quotes.
|
|
104
|
+
*/
|
|
105
|
+
function endsInsideQuote(text) {
|
|
106
|
+
let open = null;
|
|
107
|
+
for (let i = 0; i < text.length; i++) {
|
|
108
|
+
const ch = text[i];
|
|
109
|
+
if (open === null) {
|
|
110
|
+
if (ch === '\\') i++;
|
|
111
|
+
else if (ch === '"' || ch === "'") open = ch;
|
|
112
|
+
} else if (open === '"' && ch === '\\') {
|
|
113
|
+
i++;
|
|
114
|
+
} else if (ch === open) {
|
|
115
|
+
open = null;
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
return open !== null;
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
/**
|
|
122
|
+
* The 1-based line of uds.project.yaml whose command YAML cut short in the middle of a quote, or null. XSPEC-475 R5(c).
|
|
123
|
+
*
|
|
124
|
+
* YAML ends an unquoted value at a space followed by `#`. `build: node -p "'quoted # kept'"` therefore becomes
|
|
125
|
+
* `node -p "'quoted`: the shell would have kept the `#`, YAML does not, and what is left has an unclosed quote - a command
|
|
126
|
+
* that cannot be what the author meant. A genuine trailing comment (`test: dotnet test X.csproj # 90 tests pass`) leaves a
|
|
127
|
+
* complete command and is the supported way to comment, so it is NOT reported. Only the cut-short case is, and the text YAML
|
|
128
|
+
* dropped is not repeated (it may be a comment the person wants kept out of the output).
|
|
129
|
+
*
|
|
130
|
+
* Only a plain (unquoted) scalar on one line is looked at, and only when the value YAML produced is exactly the text
|
|
131
|
+
* before the `#` - so a line this cannot match up with the parsed value is never reported.
|
|
132
|
+
* @param {string} projectPath
|
|
133
|
+
* @param {string} intent
|
|
134
|
+
* @param {string} command - the value YAML produced for `intent`
|
|
135
|
+
* @returns {number|null}
|
|
136
|
+
*/
|
|
137
|
+
export function truncatedYamlValueLine(projectPath, intent, command) {
|
|
138
|
+
const configPath = join(projectPath, CONFIG_FILENAME);
|
|
139
|
+
if (!existsSync(configPath)) return null;
|
|
140
|
+
const escaped = intent.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
|
|
141
|
+
const line = new RegExp(`^[ \\t]+${escaped}[ \\t]*:[ \\t]+(.*)$`);
|
|
142
|
+
const lines = readFileSync(configPath, 'utf8').split(/\r?\n/);
|
|
143
|
+
for (let n = 0; n < lines.length; n++) {
|
|
144
|
+
const m = line.exec(lines[n]);
|
|
145
|
+
if (!m) continue;
|
|
146
|
+
const value = m[1].trim();
|
|
147
|
+
if (/^["'|>[{&*!]/.test(value)) continue; // quoted, block, flow or anchored: not a plain scalar
|
|
148
|
+
const at = value.search(/\s#/);
|
|
149
|
+
if (at < 0) continue;
|
|
150
|
+
if (value.slice(0, at).trim() !== command) continue; // not the line YAML read this value from
|
|
151
|
+
return endsInsideQuote(command) ? n + 1 : null; // [mutation-anchor:cut-inside-quote]
|
|
152
|
+
}
|
|
153
|
+
return null;
|
|
154
|
+
}
|
|
155
|
+
|
|
101
156
|
/**
|
|
102
157
|
* Get a specific command intent from config.
|
|
103
158
|
* Returns undefined if not configured.
|