universal-dev-standards 6.14.0-beta.9 → 6.14.1-beta.1
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/mock-boundary.ai.yaml +138 -2
- package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
- package/bundled/ai/standards/turn-completion-integrity.ai.yaml +6 -2
- package/bundled/core/commit-message-guide.md +22 -19
- package/bundled/core/mock-boundary.md +70 -2
- package/bundled/core/secret-management-standards.md +13 -1
- package/bundled/core/turn-completion-integrity.md +8 -2
- package/bundled/extensions/locales/zh-tw.md +19 -19
- package/bundled/hooks/check-dangerous-cmd.mjs +161 -26
- package/bundled/hooks/check-logging-standard.mjs +35 -6
- package/bundled/hooks/validate-commit-msg.mjs +317 -28
- package/bundled/locales/zh-CN/CHANGELOG.md +2323 -1099
- 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 +4 -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/mock-boundary.md +74 -6
- 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/turn-completion-integrity.md +8 -6
- 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 +2323 -1128
- 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 +4 -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/mock-boundary.md +74 -6
- 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/turn-completion-integrity.md +8 -6
- 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 +72 -3
- 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.js +4 -2
- package/src/commands/update.js +227 -47
- 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 +106 -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
|
|
|
@@ -544,20 +551,15 @@ export async function updateCommand(options) {
|
|
|
544
551
|
return;
|
|
545
552
|
}
|
|
546
553
|
await handleReconcile(projectPath, options, { force: !!options.force, addStandards });
|
|
547
|
-
//
|
|
548
|
-
|
|
549
|
-
if (scopedToSkills) await updateSkillsOnly(projectPath, manifest, options);
|
|
554
|
+
// A single scope exits the process on completion; two are chained and exit once.
|
|
555
|
+
await runScopes(projectPath, manifest, options, { skills: scopedToSkills, commands: scopedToCommands });
|
|
550
556
|
return;
|
|
551
557
|
}
|
|
552
558
|
|
|
553
|
-
// Scope without a mode: the original shortcuts.
|
|
554
|
-
|
|
555
|
-
|
|
556
|
-
|
|
557
|
-
}
|
|
558
|
-
|
|
559
|
-
if (scopedToCommands) {
|
|
560
|
-
await updateCommandsOnly(projectPath, manifest, options);
|
|
559
|
+
// Scope without a mode: the original shortcuts. Both flags mean both scopes —
|
|
560
|
+
// neither may be dropped for the other (the 6.14.0 bug).
|
|
561
|
+
if (scopedToSkills || scopedToCommands) {
|
|
562
|
+
await runScopes(projectPath, manifest, options, { skills: scopedToSkills, commands: scopedToCommands });
|
|
561
563
|
return;
|
|
562
564
|
}
|
|
563
565
|
|
|
@@ -1940,7 +1942,6 @@ export function migrateLegacyPreCommitHook(projectPath, manifest, { plan = false
|
|
|
1940
1942
|
if (r.state === 'error') {
|
|
1941
1943
|
console.log(chalk.yellow(` ${msg.hookMigrateFailed.replace('{error}', r.error)}`));
|
|
1942
1944
|
console.log();
|
|
1943
|
-
return r;
|
|
1944
1945
|
}
|
|
1945
1946
|
if (r.state === 'migrated') console.log(chalk.green(` ${msg.hookMigrated}`));
|
|
1946
1947
|
if (r.state === 'would-migrate') console.log(chalk.cyan(` ${msg.hookWouldMigrate}`));
|
|
@@ -1954,6 +1955,30 @@ export function migrateLegacyPreCommitHook(projectPath, manifest, { plan = false
|
|
|
1954
1955
|
// this the record persisted just above would be overwritten by the older copy.
|
|
1955
1956
|
Object.assign(manifest, mergeRecorderInto(manifest, r.recorder));
|
|
1956
1957
|
}
|
|
1958
|
+
|
|
1959
|
+
// XSPEC-482 R3 + R5: hooks that run the check and cannot stop a commit - the husky block that runs `check`
|
|
1960
|
+
// without `--ci`, and the native hook of 5.x .. 6.13.1 / the betas. Same treatment as above: only a text UDS
|
|
1961
|
+
// provably wrote is replaced, anything else is named and left alone, and --plan lists it.
|
|
1962
|
+
const huskyCi = migrateHuskyBlockWithoutCi(projectPath, { plan, manifest });
|
|
1963
|
+
if (huskyCi.state === 'error') console.log(chalk.yellow(` ${msg.hookMigrateFailed.replace('{error}', huskyCi.error)}`));
|
|
1964
|
+
if (huskyCi.state === 'migrated') console.log(chalk.green(` ${msg.hookHuskyCiMigrated}`)); // wire:update-migrates-husky-ci
|
|
1965
|
+
if (huskyCi.state === 'would-migrate') console.log(chalk.cyan(` ${msg.hookHuskyCiWouldMigrate}`));
|
|
1966
|
+
|
|
1967
|
+
const native = migrateOlderNativeHook(projectPath, { plan }); // wire:update-migrates-native-hook
|
|
1968
|
+
const nativeFrom = native.from === 'legacy-6.11' ? msg.hookNativeFromLegacy : msg.hookNativeFromWithoutCi;
|
|
1969
|
+
if (native.state === 'error') console.log(chalk.yellow(` ${msg.hookNativeFailed.replace('{error}', native.error)}`));
|
|
1970
|
+
if (native.state === 'migrated') console.log(chalk.green(` ${msg.hookNativeMigrated.replace('{from}', nativeFrom)}`));
|
|
1971
|
+
if (native.state === 'would-migrate') console.log(chalk.cyan(` ${msg.hookNativeWouldMigrate.replace('{from}', nativeFrom)}`));
|
|
1972
|
+
for (const k of native.kept) {
|
|
1973
|
+
console.log(chalk.yellow(` ${msg.hookNativeKept.replace('{line}', k.line).replace('{text}', k.text)}`));
|
|
1974
|
+
}
|
|
1975
|
+
if (huskyCi.state !== 'none' || native.state !== 'none') console.log();
|
|
1976
|
+
for (const extra of [huskyCi.recorder, native.recorder]) {
|
|
1977
|
+
if (extra) {
|
|
1978
|
+
persistRecorder(projectPath, extra);
|
|
1979
|
+
Object.assign(manifest, mergeRecorderInto(manifest, extra));
|
|
1980
|
+
}
|
|
1981
|
+
}
|
|
1957
1982
|
return r;
|
|
1958
1983
|
}
|
|
1959
1984
|
|
|
@@ -2724,13 +2749,21 @@ async function planSkills(projectPath, manifest, options) {
|
|
|
2724
2749
|
return;
|
|
2725
2750
|
}
|
|
2726
2751
|
|
|
2752
|
+
// XSPEC-482 R7: "unchanged" needs the files to agree too, as `uds update --plan` judges them - a recorded version
|
|
2753
|
+
// equal to the shipped one says nothing about a skill file that was deleted or edited.
|
|
2754
|
+
const skillActions = await skillActionsOf(projectPath);
|
|
2755
|
+
|
|
2727
2756
|
let changed = 0;
|
|
2728
2757
|
for (const inst of installations) {
|
|
2729
2758
|
const info = getInstalledSkillsInfoForAgent(inst.agent, inst.level, projectPath);
|
|
2730
2759
|
const current = info?.version || 'unknown';
|
|
2731
|
-
const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath);
|
|
2732
|
-
|
|
2760
|
+
const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath) ?? '(no such folder)'; // XSPEC-486: null when the tool has no folder at that level
|
|
2761
|
+
const differing = skillActions.filter((a) => a.details?.metadata?.agent === inst.agent && (a.details?.metadata?.level || 'project') === inst.level);
|
|
2762
|
+
if (current === latestVersion && differing.length === 0) {
|
|
2733
2763
|
console.log(chalk.gray(` = ${getAgentDisplayName(inst.agent)} (${inst.level}): v${current} — unchanged`));
|
|
2764
|
+
} else if (current === latestVersion) {
|
|
2765
|
+
changed++;
|
|
2766
|
+
console.log(chalk.yellow(` ~ ${getAgentDisplayName(inst.agent)} (${inst.level}): v${current} — ${differing.length} skill file(s) differ from what this UDS ships ${dir}`));
|
|
2734
2767
|
} else {
|
|
2735
2768
|
changed++;
|
|
2736
2769
|
console.log(chalk.yellow(` ~ ${getAgentDisplayName(inst.agent)} (${inst.level}): v${current} → v${latestVersion} ${dir}`));
|
|
@@ -2759,22 +2792,83 @@ async function planCommands(projectPath, manifest, options) {
|
|
|
2759
2792
|
return;
|
|
2760
2793
|
}
|
|
2761
2794
|
|
|
2795
|
+
// XSPEC-482 R7: ask the reconciler, the same question `uds update --plan` answers, instead of saying "would be
|
|
2796
|
+
// reinstalled" for every installation whatever is on disk. A project that is current used to get "51 command(s)
|
|
2797
|
+
// would be reinstalled" here, "unchanged" from `--plan --skills` and "No changes" from `--plan`.
|
|
2798
|
+
const actions = await commandActionsOf(projectPath);
|
|
2799
|
+
|
|
2800
|
+
let changed = 0;
|
|
2762
2801
|
for (const inst of installations) {
|
|
2763
2802
|
const agent = typeof inst === 'string' ? inst : inst.agent;
|
|
2764
2803
|
const level = typeof inst === 'string' ? 'project' : (inst.level || 'project');
|
|
2765
2804
|
const info = getInstalledCommandsForAgent(agent, level, projectPath);
|
|
2766
2805
|
const dir = getCommandsDirForAgent(agent, level, projectPath);
|
|
2767
|
-
|
|
2806
|
+
const differing = actions.filter((a) => a.details?.metadata?.agent === agent && (a.details?.metadata?.level || 'project') === level);
|
|
2807
|
+
if (differing.length === 0) {
|
|
2808
|
+
console.log(chalk.gray(` = ${getAgentDisplayName(agent)} (${level}): ${info?.count || 0} command(s) — unchanged`));
|
|
2809
|
+
} else {
|
|
2810
|
+
changed++;
|
|
2811
|
+
console.log(chalk.yellow(` ~ ${getAgentDisplayName(agent)} (${level}): ${differing.length} command file(s) would be written or removed ${dir}`)); // wire:plan-commands-asks-reconciler
|
|
2812
|
+
}
|
|
2768
2813
|
}
|
|
2769
2814
|
|
|
2770
2815
|
console.log();
|
|
2771
|
-
console.log(`Summary: ${
|
|
2816
|
+
console.log(`Summary: ${changed} installation(s) would be reinstalled, ${installations.length - changed} unchanged.`);
|
|
2772
2817
|
console.log(chalk.gray(` Locale that would be used: ${resolveLocale(manifest, projectPath, options)}`));
|
|
2773
|
-
console.log(chalk.gray(' Run `uds update --apply --yes --commands` to apply.'));
|
|
2818
|
+
if (changed > 0) console.log(chalk.gray(' Run `uds update --apply --yes --commands` to apply.'));
|
|
2774
2819
|
console.log();
|
|
2775
2820
|
}
|
|
2776
2821
|
|
|
2777
|
-
|
|
2822
|
+
/** The reconciler's plan actions for skill and command files (what `uds update --plan` would list). */
|
|
2823
|
+
async function commandActionsOf(projectPath) {
|
|
2824
|
+
const { plan } = await reconcilerPlan(projectPath, {});
|
|
2825
|
+
return plan.actions.filter((a) => a.category === 'command');
|
|
2826
|
+
}
|
|
2827
|
+
|
|
2828
|
+
async function skillActionsOf(projectPath) {
|
|
2829
|
+
const { plan } = await reconcilerPlan(projectPath, {});
|
|
2830
|
+
return plan.actions.filter((a) => a.category === 'skill');
|
|
2831
|
+
}
|
|
2832
|
+
|
|
2833
|
+
/**
|
|
2834
|
+
* How one scope step (Skills or commands) ends.
|
|
2835
|
+
*
|
|
2836
|
+
* Alone, it ends the process, as it always did. When `--skills` and `--commands` come
|
|
2837
|
+
* together the other scope still has to run, so it hands its exit code back instead and
|
|
2838
|
+
* {@link runScopes} ends the process once, with the worse code of the two.
|
|
2839
|
+
* (Found 2026-10-27 on Windows: `--skills --commands` ran one scope, exited 0 and said
|
|
2840
|
+
* nothing about the other. The same two axes XSPEC-372 R1/R2 separated, one level down.)
|
|
2841
|
+
* @param {number} code - 0 on success, non-zero on failure
|
|
2842
|
+
* @param {boolean} chained - true when another scope runs after this one
|
|
2843
|
+
* @returns {number} the code, so a caller can `return endScope(...)`
|
|
2844
|
+
*/
|
|
2845
|
+
function endScope(code, chained) {
|
|
2846
|
+
if (!chained) process.exit(code);
|
|
2847
|
+
return code;
|
|
2848
|
+
}
|
|
2849
|
+
|
|
2850
|
+
/**
|
|
2851
|
+
* Run the scope steps the flags name. One scope runs exactly as before (it exits the
|
|
2852
|
+
* process itself). Both run in a fixed order, each printing its own section, and the
|
|
2853
|
+
* process ends with the worst code: any failure is non-zero, and so is a failure the
|
|
2854
|
+
* reconciler already recorded in `process.exitCode` (`--apply`).
|
|
2855
|
+
* @param {string} projectPath
|
|
2856
|
+
* @param {Object} manifest
|
|
2857
|
+
* @param {Object} options
|
|
2858
|
+
* @param {{skills: boolean, commands: boolean}} scopes
|
|
2859
|
+
*/
|
|
2860
|
+
async function runScopes(projectPath, manifest, options, { skills, commands }) {
|
|
2861
|
+
if (skills && commands) {
|
|
2862
|
+
const skillsCode = await updateSkillsOnly(projectPath, manifest, options, { chained: true });
|
|
2863
|
+
const commandsCode = await updateCommandsOnly(projectPath, manifest, options, { chained: true });
|
|
2864
|
+
process.exit(Math.max(skillsCode, commandsCode, Number(process.exitCode) || 0));
|
|
2865
|
+
return;
|
|
2866
|
+
}
|
|
2867
|
+
if (skills) await updateSkillsOnly(projectPath, manifest, options);
|
|
2868
|
+
if (commands) await updateCommandsOnly(projectPath, manifest, options);
|
|
2869
|
+
}
|
|
2870
|
+
|
|
2871
|
+
async function updateSkillsOnly(projectPath, manifest, options, { chained = false } = {}) {
|
|
2778
2872
|
const msg = t().commands.update;
|
|
2779
2873
|
const repoInfo = getRepositoryInfo();
|
|
2780
2874
|
const latestVersion = repoInfo.skills.version;
|
|
@@ -2819,13 +2913,24 @@ async function updateSkillsOnly(projectPath, manifest, options) {
|
|
|
2819
2913
|
return Boolean(config?.supportsSkills && config?.skills);
|
|
2820
2914
|
});
|
|
2821
2915
|
const agents = detectedSkillsTools.length > 0 ? detectedSkillsTools : ['claude-code'];
|
|
2822
|
-
|
|
2916
|
+
// XSPEC-486 R2: a tool with no folder at the recorded level (antigravity has no user-level one) is not given
|
|
2917
|
+
// an installation that has nowhere to go.
|
|
2918
|
+
// …and the run says so, as `init` and `config` do (beta.15 Windows retest, Issue 1: this path was silent).
|
|
2919
|
+
for (const agent of agents) {
|
|
2920
|
+
if (hasSkillsLevel(agent, legacyLocation)) {
|
|
2921
|
+
skillsInstallations.push({ agent, level: legacyLocation });
|
|
2922
|
+
} else {
|
|
2923
|
+
console.log(chalk.yellow(
|
|
2924
|
+
`⚠ ${getAgentDisplayName(agent) || agent}: ` +
|
|
2925
|
+
`${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'}`
|
|
2926
|
+
));
|
|
2927
|
+
}
|
|
2928
|
+
}
|
|
2823
2929
|
} else if (legacyLocation === 'marketplace') {
|
|
2824
2930
|
console.log(chalk.yellow(msg.skillsViaMarketplace || 'Skills installed via Marketplace'));
|
|
2825
2931
|
console.log(chalk.gray(` ${msg.updateViaMarketplace || 'Update through Plugin Marketplace'}`));
|
|
2826
2932
|
console.log();
|
|
2827
|
-
|
|
2828
|
-
return;
|
|
2933
|
+
return endScope(0, chained);
|
|
2829
2934
|
}
|
|
2830
2935
|
}
|
|
2831
2936
|
}
|
|
@@ -2834,8 +2939,7 @@ async function updateSkillsOnly(projectPath, manifest, options) {
|
|
|
2834
2939
|
console.log(chalk.yellow(msg.noSkillsInstalled || 'No Skills installations found'));
|
|
2835
2940
|
console.log(chalk.gray(` ${msg.runInitToInstall || 'Run uds init to install Skills'}`));
|
|
2836
2941
|
console.log();
|
|
2837
|
-
|
|
2838
|
-
return;
|
|
2942
|
+
return endScope(0, chained);
|
|
2839
2943
|
}
|
|
2840
2944
|
|
|
2841
2945
|
// Show current status
|
|
@@ -2865,8 +2969,7 @@ async function updateSkillsOnly(projectPath, manifest, options) {
|
|
|
2865
2969
|
if (fileBasedInstallations.length === 0) {
|
|
2866
2970
|
console.log(chalk.green(msg.allSkillsUpToDate || 'All Skills are up to date'));
|
|
2867
2971
|
console.log();
|
|
2868
|
-
|
|
2869
|
-
return;
|
|
2972
|
+
return endScope(0, chained);
|
|
2870
2973
|
}
|
|
2871
2974
|
|
|
2872
2975
|
// XSPEC-454 R1: this step writes outside the reconciler, so it takes its own rollback point — the skill
|
|
@@ -2875,8 +2978,7 @@ async function updateSkillsOnly(projectPath, manifest, options) {
|
|
|
2875
2978
|
// No backup, no write: an install that cannot be undone must not start.
|
|
2876
2979
|
const skillsBackup = takeStepBackup(projectPath, 'skills', fileBasedInstallations, 'skills');
|
|
2877
2980
|
if (!skillsBackup.ok) {
|
|
2878
|
-
|
|
2879
|
-
return;
|
|
2981
|
+
return endScope(1, chained);
|
|
2880
2982
|
}
|
|
2881
2983
|
|
|
2882
2984
|
const spinner = createSpinner(msg.installingSkills || 'Installing Skills...').start();
|
|
@@ -2892,7 +2994,7 @@ async function updateSkillsOnly(projectPath, manifest, options) {
|
|
|
2892
2994
|
// Build location summary
|
|
2893
2995
|
const locations = fileBasedInstallations.map(inst => {
|
|
2894
2996
|
const displayName = getAgentDisplayName(inst.agent);
|
|
2895
|
-
const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath);
|
|
2997
|
+
const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath) ?? '(no such folder)'; // XSPEC-486
|
|
2896
2998
|
return `${displayName}: ${dir}`;
|
|
2897
2999
|
}).join(', ');
|
|
2898
3000
|
|
|
@@ -2963,7 +3065,7 @@ async function updateSkillsOnly(projectPath, manifest, options) {
|
|
|
2963
3065
|
// XSPEC-465 R1: a personal skill with the same name as one of the UDS skills just written wins silently.
|
|
2964
3066
|
// Information only: it does not change what was installed or the exit code.
|
|
2965
3067
|
printSkillNameCollisionWarning(projectPath);
|
|
2966
|
-
|
|
3068
|
+
return endScope(0, chained);
|
|
2967
3069
|
}
|
|
2968
3070
|
|
|
2969
3071
|
/**
|
|
@@ -2972,7 +3074,7 @@ async function updateSkillsOnly(projectPath, manifest, options) {
|
|
|
2972
3074
|
* @param {Object} manifest - Manifest object
|
|
2973
3075
|
* @param {Object} [options] - CLI options (forwarded for locale resolution)
|
|
2974
3076
|
*/
|
|
2975
|
-
async function updateCommandsOnly(projectPath, manifest, options) {
|
|
3077
|
+
async function updateCommandsOnly(projectPath, manifest, options, { chained = false } = {}) {
|
|
2976
3078
|
const msg = t().commands.update;
|
|
2977
3079
|
|
|
2978
3080
|
console.log(chalk.cyan(msg.updatingCommandsOnly || 'Updating slash commands for all AI Agents...'));
|
|
@@ -2999,8 +3101,7 @@ async function updateCommandsOnly(projectPath, manifest, options) {
|
|
|
2999
3101
|
console.log(chalk.yellow(msg.noCommandsInstalled || 'No slash commands installations found'));
|
|
3000
3102
|
console.log(chalk.gray(` ${msg.runInitToInstall || 'Run uds init to install commands'}`));
|
|
3001
3103
|
console.log();
|
|
3002
|
-
|
|
3003
|
-
return;
|
|
3104
|
+
return endScope(0, chained);
|
|
3004
3105
|
}
|
|
3005
3106
|
|
|
3006
3107
|
// Show current status
|
|
@@ -3022,8 +3123,7 @@ async function updateCommandsOnly(projectPath, manifest, options) {
|
|
|
3022
3123
|
// XSPEC-454 R1: same as the Skills step — a rollback point first, and no write without one.
|
|
3023
3124
|
const commandsBackup = takeStepBackup(projectPath, 'commands', commandsInstallations, 'commands');
|
|
3024
3125
|
if (!commandsBackup.ok) {
|
|
3025
|
-
|
|
3026
|
-
return;
|
|
3126
|
+
return endScope(1, chained);
|
|
3027
3127
|
}
|
|
3028
3128
|
|
|
3029
3129
|
const spinner = createSpinner(msg.installingCommands || 'Installing commands...').start();
|
|
@@ -3109,7 +3209,7 @@ async function updateCommandsOnly(projectPath, manifest, options) {
|
|
|
3109
3209
|
finishStepBackup(projectPath, commandsBackup);
|
|
3110
3210
|
|
|
3111
3211
|
console.log();
|
|
3112
|
-
|
|
3212
|
+
return endScope(0, chained);
|
|
3113
3213
|
}
|
|
3114
3214
|
|
|
3115
3215
|
/**
|
|
@@ -3366,7 +3466,7 @@ async function promptNewFeatureInstallation(missingSkills, outdatedSkills, missi
|
|
|
3366
3466
|
console.log(chalk.yellow(msg.skillsOutdatedFor || 'Skills updates available for these AI tools:'));
|
|
3367
3467
|
for (const skill of outdatedSkills) {
|
|
3368
3468
|
const levelLabel = skill.level === 'user' ? 'user' : 'project';
|
|
3369
|
-
const pathDisplay = skill.path || getSkillsDirForAgent(skill.agent, skill.level);
|
|
3469
|
+
const pathDisplay = skill.path || getSkillsDirForAgent(skill.agent, skill.level) || '(no such folder)';
|
|
3370
3470
|
console.log(chalk.gray(` • ${skill.displayName} (${levelLabel}: ${pathDisplay})`));
|
|
3371
3471
|
console.log(chalk.gray(` ${skill.currentVersion} → ${skill.latestVersion}`));
|
|
3372
3472
|
}
|
|
@@ -3375,7 +3475,7 @@ async function promptNewFeatureInstallation(missingSkills, outdatedSkills, missi
|
|
|
3375
3475
|
// Build checkbox choices with path info
|
|
3376
3476
|
const updateChoices = outdatedSkills.map(skill => {
|
|
3377
3477
|
const levelLabel = skill.level === 'user' ? 'user' : 'project';
|
|
3378
|
-
const pathDisplay = skill.path || getSkillsDirForAgent(skill.agent, skill.level);
|
|
3478
|
+
const pathDisplay = skill.path || getSkillsDirForAgent(skill.agent, skill.level) || '(no such folder)';
|
|
3379
3479
|
return {
|
|
3380
3480
|
name: `${skill.displayName} ${chalk.gray(`(${levelLabel}: ${pathDisplay}) ${skill.currentVersion} → ${skill.latestVersion}`)}`,
|
|
3381
3481
|
value: skill.agent,
|
|
@@ -3511,14 +3611,14 @@ function takeStepBackup(projectPath, label, installations, kind) {
|
|
|
3511
3611
|
console.log();
|
|
3512
3612
|
return { ok: false };
|
|
3513
3613
|
}
|
|
3514
|
-
cleanupBackupsQuietly(projectPath);
|
|
3515
|
-
return { ok: true, backupId: backup.backupId };
|
|
3614
|
+
return { ok: true, backupId: backup.backupId, cleanup: cleanupBackupsQuietly(projectPath) };
|
|
3516
3615
|
}
|
|
3517
3616
|
|
|
3518
3617
|
/** The step is over (its last manifest write is done): record what it created, and say how to undo it. */
|
|
3519
3618
|
function finishStepBackup(projectPath, backup) {
|
|
3520
3619
|
finalizeBackup(projectPath, backup.backupId);
|
|
3521
3620
|
printBackupLocation(backup.backupId);
|
|
3621
|
+
printBackupCleanup(backup.cleanup);
|
|
3522
3622
|
}
|
|
3523
3623
|
|
|
3524
3624
|
/**
|
|
@@ -3534,9 +3634,34 @@ function printBackupLocation(backupId) {
|
|
|
3534
3634
|
|
|
3535
3635
|
function cleanupBackupsQuietly(projectPath) {
|
|
3536
3636
|
try {
|
|
3537
|
-
cleanupBackups(projectPath);
|
|
3637
|
+
return cleanupBackups(projectPath);
|
|
3538
3638
|
} catch {
|
|
3539
3639
|
// an old backup that cannot be removed is not a reason to stop the update
|
|
3640
|
+
return null;
|
|
3641
|
+
}
|
|
3642
|
+
}
|
|
3643
|
+
|
|
3644
|
+
/**
|
|
3645
|
+
* Say what the backup limit did (XSPEC-475 R2). A backup is the adopter's data: one deleted without a word
|
|
3646
|
+
* is how an adopter loses the only copy of something version control cannot give back.
|
|
3647
|
+
* - every backup removed because `.uds-backups/` holds more than the limit is named;
|
|
3648
|
+
* - backups an older UDS left in the project root (`.uds-backup-*`) are never removed by the limit; they
|
|
3649
|
+
* are listed here with a suggestion to move them out themselves.
|
|
3650
|
+
* // implements XSPEC-475 R2
|
|
3651
|
+
*/
|
|
3652
|
+
function printBackupCleanup(cleanup) {
|
|
3653
|
+
if (!cleanup) return;
|
|
3654
|
+
const removed = cleanup.removed || [];
|
|
3655
|
+
const legacy = cleanup.legacyKept || [];
|
|
3656
|
+
if (removed.length > 0) {
|
|
3657
|
+
console.log(chalk.yellow(` Removed ${removed.length} old backup(s) beyond the limit of ${cleanup.keep} in .uds-backups/:`));
|
|
3658
|
+
for (const id of removed) console.log(chalk.yellow(` ✕ ${id}`));
|
|
3659
|
+
}
|
|
3660
|
+
for (const err of cleanup.errors || []) console.log(chalk.red(` ${err}`));
|
|
3661
|
+
if (legacy.length > 0) {
|
|
3662
|
+
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:`));
|
|
3663
|
+
for (const id of legacy) console.log(chalk.yellow(` - ${id}`));
|
|
3664
|
+
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).'));
|
|
3540
3665
|
}
|
|
3541
3666
|
}
|
|
3542
3667
|
|
|
@@ -3551,20 +3676,37 @@ function printPaths(prefix, paths, limit, colour) {
|
|
|
3551
3676
|
* updates, then say, item by item, what was restored, what was removed, and what was NOT put back.
|
|
3552
3677
|
* It never ends in "successful" while any of those lists is not empty (XSPEC-454 R1).
|
|
3553
3678
|
*/
|
|
3554
|
-
async function handleRollback(projectPath) {
|
|
3679
|
+
async function handleRollback(projectPath, options = {}) {
|
|
3555
3680
|
const backups = listBackups(projectPath);
|
|
3556
3681
|
if (backups.length === 0) {
|
|
3557
3682
|
console.log(chalk.yellow('No backups found. Nothing to rollback.'));
|
|
3558
3683
|
console.log();
|
|
3684
|
+
if (options.from) process.exitCode = 1;
|
|
3559
3685
|
return;
|
|
3560
3686
|
}
|
|
3561
3687
|
|
|
3562
|
-
|
|
3688
|
+
// XSPEC-482 R11: `--from` names the one backup to restore. The default picks the newest series, and a backup an older
|
|
3689
|
+
// UDS made is never in it (it records no manifest hash to chain on), so without this there was no way to reach it.
|
|
3690
|
+
let chosen = null;
|
|
3691
|
+
if (options.from) {
|
|
3692
|
+
const wanted = String(options.from).replace(/\\/g, '/').replace(/\/+$/, '');
|
|
3693
|
+
const leaf = (id) => id.slice(id.lastIndexOf('/') + 1);
|
|
3694
|
+
chosen = backups.find((b) => b.backupId === wanted) || backups.find((b) => leaf(b.backupId) === leaf(wanted));
|
|
3695
|
+
if (!chosen) {
|
|
3696
|
+
console.log(chalk.red(`No backup named "${options.from}". Backups in this project:`));
|
|
3697
|
+
for (const b of backups) console.log(chalk.gray(` ${b.backupId} (${b.createdAt || 'no date'})`));
|
|
3698
|
+
console.log();
|
|
3699
|
+
process.exitCode = 1;
|
|
3700
|
+
return;
|
|
3701
|
+
}
|
|
3702
|
+
}
|
|
3703
|
+
|
|
3704
|
+
const latest = chosen || backups[0];
|
|
3563
3705
|
console.log(chalk.cyan(`Rolling back from: ${latest.backupId}`));
|
|
3564
3706
|
console.log(chalk.gray(` Created: ${latest.createdAt}`));
|
|
3565
3707
|
console.log();
|
|
3566
3708
|
|
|
3567
|
-
const result = rollbackLast(projectPath);
|
|
3709
|
+
const result = rollbackLast(projectPath, chosen ? chosen.backupId : undefined);
|
|
3568
3710
|
|
|
3569
3711
|
for (const step of result.steps || []) {
|
|
3570
3712
|
console.log(chalk.cyan(`${step.backupId}${step.label ? ` (${step.label})` : ''}`));
|
|
@@ -3582,7 +3724,16 @@ async function handleRollback(projectPath) {
|
|
|
3582
3724
|
console.log(chalk.gray(` ${result.steps.length} consecutive updates were undone together (each one started from where the previous one ended).`));
|
|
3583
3725
|
}
|
|
3584
3726
|
if (result.olderBackups > 0) {
|
|
3585
|
-
|
|
3727
|
+
// Say the true reason. A backup an older UDS made records no manifest hash, so there is nothing to tell whether it
|
|
3728
|
+
// continues the series; one that does carry the hash and still does not match means something else changed the project.
|
|
3729
|
+
const inSeries = (result.steps || []).length;
|
|
3730
|
+
const next = backups[inSeries];
|
|
3731
|
+
const why = next && !next.postManifestHash
|
|
3732
|
+
? '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'
|
|
3733
|
+
: 'something else changed the project after it was made';
|
|
3734
|
+
console.log(chalk.gray(` ${result.olderBackups} older backup(s) are not part of that series (${why}) and were left alone.`));
|
|
3735
|
+
console.log(chalk.gray(' To restore one of them on its own: `uds update --rollback --from <backup>`. They are:'));
|
|
3736
|
+
for (const b of backups.slice(inSeries)) console.log(chalk.gray(` ${b.backupId} (${b.createdAt || 'no date'})`)); // wire:rollback-names-older-backups
|
|
3586
3737
|
}
|
|
3587
3738
|
|
|
3588
3739
|
if (result.errors.length > 0) {
|
|
@@ -3677,8 +3828,24 @@ async function handleReconcile(projectPath, options, { force, addStandards = []
|
|
|
3677
3828
|
// XSPEC-454 R2: nothing to apply, but the manifest may still list skill files UDS never installed
|
|
3678
3829
|
// (they only ever get corrected by a write, and an up-to-date project has none coming).
|
|
3679
3830
|
const current = readManifest(projectPath);
|
|
3680
|
-
|
|
3831
|
+
// XSPEC-475 R6: nothing to apply means the files are what this UDS ships; the recorded versions say so too.
|
|
3832
|
+
let aligned = current ? alignRecordedVersions(current).changed : false; // wire:up-to-date-aligns-versions
|
|
3833
|
+
// XSPEC-482 R6: the same for the standards version, which only an executed plan used to record.
|
|
3834
|
+
if (current && alignUpstreamVersion(current).changed) aligned = true; // wire:up-to-date-aligns-upstream
|
|
3835
|
+
// XSPEC-456 R4 (kept through XSPEC-482 R6): the NAME lists are corrected here too. This early return used to be reached only by
|
|
3836
|
+
// a project that had nothing else to rewrite, which a fresh `uds init` almost never was; once init leaves the project current
|
|
3837
|
+
// it is the normal case, and the names UDS cannot vouch for (`_shared`, a retired skill) stayed in the manifest for good.
|
|
3838
|
+
// Ownership test only, as the reconciler does (no disk test).
|
|
3839
|
+
let droppedNames = 0;
|
|
3840
|
+
if (current) {
|
|
3841
|
+
const before = (current.skills?.names?.length || 0) + (current.commands?.names?.length || 0);
|
|
3842
|
+
pruneForeignSkillNames(current, '');
|
|
3843
|
+
pruneForeignCommandNames(current, '');
|
|
3844
|
+
droppedNames = before - ((current.skills?.names?.length || 0) + (current.commands?.names?.length || 0)); // wire:up-to-date-prunes-names
|
|
3845
|
+
}
|
|
3846
|
+
if (current && ((pruneForeignSkillHashes(current).length + pruneForeignCommandHashes(current).length) > 0 || aligned || droppedNames > 0)) writeManifest(current, projectPath);
|
|
3681
3847
|
console.log(chalk.green('Everything is up to date. No changes needed.'));
|
|
3848
|
+
if (droppedNames > 0) console.log(chalk.gray(` ${t().commands.update.droppedForeignNames.replace('{count}', droppedNames)}`));
|
|
3682
3849
|
// XSPEC-458 R2: "up to date" is about the files UDS manages; say what UDS ships that is not managed here.
|
|
3683
3850
|
printAvailableStandardsSection(planResult.manifest, { phase: 'apply' });
|
|
3684
3851
|
console.log();
|
|
@@ -3721,6 +3888,7 @@ async function handleReconcile(projectPath, options, { force, addStandards = []
|
|
|
3721
3888
|
|
|
3722
3889
|
if (result.execution?.backupId) {
|
|
3723
3890
|
printBackupLocation(result.execution.backupId);
|
|
3891
|
+
printBackupCleanup(result.execution.backupCleanup);
|
|
3724
3892
|
}
|
|
3725
3893
|
|
|
3726
3894
|
if (result.errors.length > 0) {
|
|
@@ -3731,6 +3899,18 @@ async function handleReconcile(projectPath, options, { force, addStandards = []
|
|
|
3731
3899
|
}
|
|
3732
3900
|
}
|
|
3733
3901
|
|
|
3902
|
+
if (!result.success) {
|
|
3903
|
+
// XSPEC-482 R10: say what a partly failed run left behind and the way to finish it.
|
|
3904
|
+
console.log();
|
|
3905
|
+
console.log(chalk.yellow(
|
|
3906
|
+
'Not everything was applied. The overall version record did not advance, and a skills or commands batch that failed keeps its ' +
|
|
3907
|
+
'old version record; a batch that succeeded has already recorded its new version. ' +
|
|
3908
|
+
'Fix the cause, then run `uds update --apply` again: it completes what is left.'
|
|
3909
|
+
));
|
|
3910
|
+
// XSPEC-482 R2: a failed action is a failed run. CI and scripts read the exit code, not the colour of a line.
|
|
3911
|
+
process.exitCode = 1; // wire:apply-fails-exit-1
|
|
3912
|
+
}
|
|
3913
|
+
|
|
3734
3914
|
// XSPEC-458 R2: the count of what UDS ships and this project lacks, with the command that installs one.
|
|
3735
3915
|
printAvailableStandardsSection(result.manifest || planResult.manifest, { phase: 'apply' });
|
|
3736
3916
|
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
|
+
}
|