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
|
@@ -9,6 +9,7 @@
|
|
|
9
9
|
|
|
10
10
|
import { join, basename } from 'path';
|
|
11
11
|
import { getAllStandards, getStandardSource, findOption, getOptionSource } from '../utils/registry.js';
|
|
12
|
+
import { getInstalledFormats } from '../core/installed-formats.js';
|
|
12
13
|
import {
|
|
13
14
|
resolveToolKey,
|
|
14
15
|
SUPPORTED_AI_TOOLS,
|
|
@@ -25,6 +26,7 @@ import {
|
|
|
25
26
|
buildAgentsMdSummaryConfig
|
|
26
27
|
} from '../utils/integration-generator.js';
|
|
27
28
|
import { PathResolver } from '../core/paths.js';
|
|
29
|
+
import { projectRelative } from './relative-path.js';
|
|
28
30
|
import { computeFileHash } from '../utils/hasher.js';
|
|
29
31
|
import { createHash } from 'crypto';
|
|
30
32
|
import {
|
|
@@ -106,7 +108,7 @@ export function calculateDesiredState(projectPath, manifest) {
|
|
|
106
108
|
* Calculate expected standard files.
|
|
107
109
|
*/
|
|
108
110
|
function calculateStandards(state, manifest) {
|
|
109
|
-
const
|
|
111
|
+
const formats = getInstalledFormats(manifest.format); // wire:calculator-standards-formats
|
|
110
112
|
const allStandards = getAllStandards();
|
|
111
113
|
|
|
112
114
|
for (const standardId of (manifest.standards || [])) {
|
|
@@ -131,35 +133,39 @@ function calculateStandards(state, manifest) {
|
|
|
131
133
|
|
|
132
134
|
if (!registryEntry) continue;
|
|
133
135
|
|
|
134
|
-
|
|
135
|
-
if (
|
|
136
|
+
// `format: both` installs the human and the AI copy of every standard, so it expects both files. Reading
|
|
137
|
+
// `both` as if it were one format resolved only the human copy and planned to delete every AI copy (XSPEC-483).
|
|
138
|
+
for (const fileFormat of formats) {
|
|
139
|
+
const source = getStandardSource(registryEntry, fileFormat);
|
|
140
|
+
if (!source) continue;
|
|
136
141
|
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
142
|
+
// Target path in .standards/
|
|
143
|
+
const fileName = basename(source);
|
|
144
|
+
const relativePath = `.standards/${fileName}`;
|
|
140
145
|
|
|
141
|
-
|
|
142
|
-
|
|
146
|
+
// Resolve source to absolute path
|
|
147
|
+
const absSource = PathResolver.getStandardSource(source);
|
|
143
148
|
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
149
|
+
// Compute hash from source if available
|
|
150
|
+
let hash = null;
|
|
151
|
+
let size = null;
|
|
152
|
+
if (absSource) {
|
|
153
|
+
const hashInfo = computeFileHash(absSource);
|
|
154
|
+
if (hashInfo) {
|
|
155
|
+
hash = hashInfo.hash;
|
|
156
|
+
size = hashInfo.size;
|
|
157
|
+
}
|
|
152
158
|
}
|
|
153
|
-
}
|
|
154
159
|
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
160
|
+
state.standards.set(relativePath, {
|
|
161
|
+
relativePath,
|
|
162
|
+
hash,
|
|
163
|
+
size,
|
|
164
|
+
category: 'standard',
|
|
165
|
+
sourcePath: absSource,
|
|
166
|
+
metadata: { standardId, format: fileFormat, registryEntry }
|
|
167
|
+
});
|
|
168
|
+
}
|
|
163
169
|
}
|
|
164
170
|
}
|
|
165
171
|
|
|
@@ -180,7 +186,7 @@ function calculateStandards(state, manifest) {
|
|
|
180
186
|
* not into a `<standardId>/<categoryKey>/` tree.
|
|
181
187
|
*/
|
|
182
188
|
function calculateOptions(state, manifest) {
|
|
183
|
-
const
|
|
189
|
+
const formats = getInstalledFormats(manifest.format); // wire:calculator-options-formats
|
|
184
190
|
const allStandards = getAllStandards();
|
|
185
191
|
|
|
186
192
|
if (!manifest.options) return;
|
|
@@ -201,30 +207,33 @@ function calculateOptions(state, manifest) {
|
|
|
201
207
|
const option = findOption(registryEntry, binding.categoryKey, optionId);
|
|
202
208
|
if (!option) continue;
|
|
203
209
|
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
if (
|
|
215
|
-
|
|
216
|
-
|
|
210
|
+
// As for the standards: `format: both` installs each option in both formats (XSPEC-483).
|
|
211
|
+
for (const fileFormat of formats) {
|
|
212
|
+
const source = getOptionSource(option, fileFormat);
|
|
213
|
+
if (!source) continue;
|
|
214
|
+
|
|
215
|
+
const relativePath = `${OPTIONS_INSTALL_DIR}/${basename(source)}`;
|
|
216
|
+
const absSource = PathResolver.getStandardSource(source);
|
|
217
|
+
|
|
218
|
+
let hash = null;
|
|
219
|
+
let size = null;
|
|
220
|
+
if (absSource) {
|
|
221
|
+
const hashInfo = computeFileHash(absSource);
|
|
222
|
+
if (hashInfo) {
|
|
223
|
+
hash = hashInfo.hash;
|
|
224
|
+
size = hashInfo.size;
|
|
225
|
+
}
|
|
217
226
|
}
|
|
218
|
-
}
|
|
219
227
|
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
+
state.options.set(relativePath, {
|
|
229
|
+
relativePath,
|
|
230
|
+
hash,
|
|
231
|
+
size,
|
|
232
|
+
category: 'option',
|
|
233
|
+
sourcePath: absSource,
|
|
234
|
+
metadata: { standardId: binding.standardId, categoryKey: binding.categoryKey, optionId, format: fileFormat }
|
|
235
|
+
});
|
|
236
|
+
}
|
|
228
237
|
}
|
|
229
238
|
}
|
|
230
239
|
}
|
|
@@ -357,12 +366,39 @@ function isToolGenuinelySelected(toolName, manifest) {
|
|
|
357
366
|
return (manifest.aiTools || []).some((t) => (LEGACY_TOOL_MAPPINGS[t] || t) === toolName);
|
|
358
367
|
}
|
|
359
368
|
|
|
369
|
+
/**
|
|
370
|
+
* Which integrations the manifest says are in use: tool keys or file paths.
|
|
371
|
+
*
|
|
372
|
+
* `manifest.integrations` is the declared list, but it is not the only record. An adopter manifest with
|
|
373
|
+
* `integrations: []`, `aiTools: ['claude-code']` and an `integrationBlockHashes` entry for CLAUDE.md produced
|
|
374
|
+
* an EMPTY desired set, so `uds update --plan` proposed "integration no longer configured, removing UDS block"
|
|
375
|
+
* while `uds check` called the same project compliant (issue #269; an empty array is a different shape from
|
|
376
|
+
* the file-name one XSPEC-343 R1 handled).
|
|
377
|
+
*
|
|
378
|
+
* When the list is empty or absent, fall back to the two other records of the same fact - `aiTools` (the
|
|
379
|
+
* declared configuration; update.js's orphan-hash pruning already treats it as the source of truth) and the
|
|
380
|
+
* files `integrationBlockHashes` says UDS wrote a block into. A non-empty `integrations` is used as written:
|
|
381
|
+
* this is a fallback for a missing declaration, not a second opinion on a present one. A genuinely removed
|
|
382
|
+
* integration has none of the three, so it is still proposed for removal.
|
|
383
|
+
*
|
|
384
|
+
* @param {Object} manifest
|
|
385
|
+
* @returns {string[]} tool keys or file paths, in the shapes `resolveToolKey` accepts
|
|
386
|
+
*/
|
|
387
|
+
function integrationEntriesOf(manifest) {
|
|
388
|
+
const declared = manifest.integrations;
|
|
389
|
+
if (Array.isArray(declared) && declared.length > 0) return declared;
|
|
390
|
+
const fromAiTools = (manifest.aiTools || []).map((t) => LEGACY_TOOL_MAPPINGS[t] || t);
|
|
391
|
+
const fromBlockHashes = Object.keys(manifest.integrationBlockHashes || {});
|
|
392
|
+
return [...fromAiTools, ...fromBlockHashes];
|
|
393
|
+
}
|
|
394
|
+
|
|
360
395
|
/**
|
|
361
396
|
* Calculate expected integration files.
|
|
362
397
|
* For integrations we track the UDS marker block, not the entire file.
|
|
363
398
|
*/
|
|
364
399
|
function calculateIntegrations(state, manifest) {
|
|
365
|
-
|
|
400
|
+
const seenTools = new Set();
|
|
401
|
+
for (const entry of integrationEntriesOf(manifest)) {
|
|
366
402
|
// Accept both shapes. `manifest.integrations` is normalised to tool keys by
|
|
367
403
|
// the v3.5.0 migration, but a repo whose manifest has not been re-read and
|
|
368
404
|
// rewritten still holds file paths — and treating those as unknown tools
|
|
@@ -376,6 +412,9 @@ function calculateIntegrations(state, manifest) {
|
|
|
376
412
|
const toolName = resolveToolKey(entry);
|
|
377
413
|
const toolConfig = toolName ? SUPPORTED_AI_TOOLS[toolName] : null;
|
|
378
414
|
if (!toolConfig) continue;
|
|
415
|
+
// Two entries can name the same tool (`aiTools: ['claude-code']` plus a recorded `CLAUDE.md` block hash).
|
|
416
|
+
if (seenTools.has(toolName)) continue;
|
|
417
|
+
seenTools.add(toolName);
|
|
379
418
|
|
|
380
419
|
// XSPEC-418 R2/R3: the desired path is the tool's ACTUAL target, not always
|
|
381
420
|
// its default file — a local-target claude-code install's desired state
|
|
@@ -564,12 +603,5 @@ function calculateCommands(state, projectPath, manifest) {
|
|
|
564
603
|
* @returns {string}
|
|
565
604
|
*/
|
|
566
605
|
function getRelativePath(projectPath, absPath) {
|
|
567
|
-
|
|
568
|
-
let rel = absPath.slice(projectPath.length);
|
|
569
|
-
if (rel.startsWith('/') || rel.startsWith('\\')) {
|
|
570
|
-
rel = rel.slice(1);
|
|
571
|
-
}
|
|
572
|
-
return rel;
|
|
573
|
-
}
|
|
574
|
-
return absPath;
|
|
606
|
+
return projectRelative(projectPath, absPath); // `/` on every system (XSPEC-486 R4)
|
|
575
607
|
}
|
|
@@ -11,7 +11,9 @@
|
|
|
11
11
|
* Each action is executed independently — single failures don't block the rest.
|
|
12
12
|
*/
|
|
13
13
|
|
|
14
|
-
import { existsSync, unlinkSync, mkdirSync, rmSync, copyFileSync, statSync } from 'fs';
|
|
14
|
+
import { existsSync, unlinkSync, mkdirSync, rmSync, copyFileSync, statSync, readFileSync, writeFileSync } from 'fs';
|
|
15
|
+
import { UDS_MARKERS } from '../core/constants.js';
|
|
16
|
+
import { tryLocateMarkerBlock } from '../utils/marker-locator.js';
|
|
15
17
|
import { join, dirname } from 'path';
|
|
16
18
|
import { copyStandard } from '../utils/copier.js';
|
|
17
19
|
import {
|
|
@@ -24,12 +26,13 @@ import {
|
|
|
24
26
|
installSkillsToMultipleAgents,
|
|
25
27
|
installCommandsToMultipleAgents
|
|
26
28
|
} from '../utils/skills-installer.js';
|
|
27
|
-
import { writeManifest } from '../core/manifest.js';
|
|
29
|
+
import { writeManifest, mergeInstalledNames } from '../core/manifest.js';
|
|
28
30
|
import { getRepositoryInfo } from '../utils/registry.js';
|
|
29
31
|
import { displayLanguageToLocale } from '../utils/locale.js';
|
|
30
32
|
import { computeFileHash, pruneIntegrationFileHashes } from '../utils/hasher.js';
|
|
31
33
|
import { createBackup, cleanupBackups, finalizeBackup } from './backup-manager.js';
|
|
32
34
|
import { bookkeepingFiles } from './install-roots.js';
|
|
35
|
+
import { alignRecordedVersions } from './recorded-versions.js';
|
|
33
36
|
|
|
34
37
|
/**
|
|
35
38
|
* @typedef {Object} ExecutionResult
|
|
@@ -56,6 +59,7 @@ export async function executePlan(projectPath, plan, manifest, options = {}) {
|
|
|
56
59
|
const { backup = true, dryRun = false, onAction } = options;
|
|
57
60
|
const results = [];
|
|
58
61
|
let backupId = null;
|
|
62
|
+
let backupCleanup = null;
|
|
59
63
|
const updatedManifest = { ...manifest };
|
|
60
64
|
|
|
61
65
|
// Ensure hash containers exist
|
|
@@ -106,8 +110,8 @@ export async function executePlan(projectPath, plan, manifest, options = {}) {
|
|
|
106
110
|
}
|
|
107
111
|
backupId = backupResult.backupId;
|
|
108
112
|
|
|
109
|
-
// Clean up old backups
|
|
110
|
-
cleanupBackups(projectPath);
|
|
113
|
+
// Clean up old backups. The result is returned so the command can name what was removed (XSPEC-475 R2).
|
|
114
|
+
backupCleanup = cleanupBackups(projectPath);
|
|
111
115
|
}
|
|
112
116
|
|
|
113
117
|
// Execute actions
|
|
@@ -178,6 +182,9 @@ export async function executePlan(projectPath, plan, manifest, options = {}) {
|
|
|
178
182
|
// the weekly staleness scout — which reads exactly `upstream.version` — kept
|
|
179
183
|
// reporting the repo as stale after a fully successful reconcile. (XSPEC-343 R2)
|
|
180
184
|
if (!dryRun && results.every(r => r.success)) {
|
|
185
|
+
// XSPEC-475 R6: a clean reconcile leaves the skills and commands exactly as this UDS ships them (the plan covers every
|
|
186
|
+
// difference), so the versions recorded for them move with it - also when no file needed rewriting.
|
|
187
|
+
alignRecordedVersions(updatedManifest); // wire:apply-aligns-versions
|
|
181
188
|
const version = getRepositoryInfo()?.standards?.version;
|
|
182
189
|
if (version) {
|
|
183
190
|
updatedManifest.upstream = {
|
|
@@ -219,6 +226,7 @@ export async function executePlan(projectPath, plan, manifest, options = {}) {
|
|
|
219
226
|
return {
|
|
220
227
|
success: summary.failed === 0,
|
|
221
228
|
backupId,
|
|
229
|
+
backupCleanup,
|
|
222
230
|
results,
|
|
223
231
|
updatedManifest,
|
|
224
232
|
summary
|
|
@@ -324,6 +332,31 @@ async function executeCreateOrUpdate(projectPath, action, manifest) {
|
|
|
324
332
|
return { action, success: false, error: `Unsupported create/update for category: ${action.category}` };
|
|
325
333
|
}
|
|
326
334
|
|
|
335
|
+
/**
|
|
336
|
+
* Remove the UDS marker block from an integration file, keeping everything else.
|
|
337
|
+
* Deletes the file only when the block was all it held. A file with no UDS block is left alone:
|
|
338
|
+
* nothing in it is ours to delete.
|
|
339
|
+
* @param {string} targetPath
|
|
340
|
+
* @returns {{ok: true} | {ok: false, error: string}}
|
|
341
|
+
*/
|
|
342
|
+
function removeUdsBlock(targetPath) {
|
|
343
|
+
const content = readFileSync(targetPath, 'utf-8');
|
|
344
|
+
for (const markers of [UDS_MARKERS.markdown, UDS_MARKERS.plaintext]) {
|
|
345
|
+
const found = tryLocateMarkerBlock(content, markers);
|
|
346
|
+
if (!found.ok) {
|
|
347
|
+
return { ok: false, error: `${found.error.message} — left ${targetPath} untouched` };
|
|
348
|
+
}
|
|
349
|
+
if (!found.block) continue;
|
|
350
|
+
let end = found.block.endIdx + markers.end.length;
|
|
351
|
+
if (content[end] === '\n') end += 1;
|
|
352
|
+
const rest = (content.slice(0, found.block.startIdx) + content.slice(end)).replace(/\n{3,}/g, '\n\n');
|
|
353
|
+
if (rest.trim() === '') unlinkSync(targetPath);
|
|
354
|
+
else writeFileSync(targetPath, rest, 'utf-8');
|
|
355
|
+
return { ok: true };
|
|
356
|
+
}
|
|
357
|
+
return { ok: true };
|
|
358
|
+
}
|
|
359
|
+
|
|
327
360
|
/**
|
|
328
361
|
* Execute a delete action.
|
|
329
362
|
*/
|
|
@@ -338,6 +371,12 @@ function executeDelete(projectPath, action, manifest) {
|
|
|
338
371
|
const stat = statSync(targetPath);
|
|
339
372
|
if (stat.isDirectory()) {
|
|
340
373
|
rmSync(targetPath, { recursive: true, force: true });
|
|
374
|
+
} else if (action.category === 'integration') {
|
|
375
|
+
// An integration file (CLAUDE.md, AGENTS.md, ...) holds the user's own content around the UDS block.
|
|
376
|
+
// Removing the integration removes the block only; the file goes away only when nothing else is left.
|
|
377
|
+
// Unlinking the whole file deleted text the user wrote (found while fixing issue #269).
|
|
378
|
+
const removed = removeUdsBlock(targetPath);
|
|
379
|
+
if (!removed.ok) return { action, success: false, error: removed.error };
|
|
341
380
|
} else {
|
|
342
381
|
unlinkSync(targetPath);
|
|
343
382
|
}
|
|
@@ -416,6 +455,50 @@ function executeMigrateBlock(projectPath, action, manifest) {
|
|
|
416
455
|
return { action, success: false, error: result.error };
|
|
417
456
|
}
|
|
418
457
|
|
|
458
|
+
/**
|
|
459
|
+
* After a batch install that succeeded, make the manifest say what the disk now holds: the version of the skills/commands
|
|
460
|
+
* this UDS ships, and the names installed (added to the ones already recorded). XSPEC-475 R6.
|
|
461
|
+
* @param {Object} manifest
|
|
462
|
+
* @param {'skills'|'commands'} kind
|
|
463
|
+
* @param {Object} installResult - from installSkills/CommandsToMultipleAgents
|
|
464
|
+
*/
|
|
465
|
+
function recordInstalledSet(manifest, kind, installResult) {
|
|
466
|
+
const shipped = getRepositoryInfo()?.skills?.version;
|
|
467
|
+
manifest[kind] = { ...(manifest[kind] || {}) };
|
|
468
|
+
if (shipped) manifest[kind].version = shipped;
|
|
469
|
+
manifest[kind].names = mergeInstalledNames(manifest[kind].names, installResult);
|
|
470
|
+
}
|
|
471
|
+
|
|
472
|
+
/**
|
|
473
|
+
* The outcome of one skill or command action after its batch ran (XSPEC-482 R10).
|
|
474
|
+
*
|
|
475
|
+
* The batch installer answers once for all of them. The old code copied that one answer onto every action and gave
|
|
476
|
+
* no reason, so a read-only skills folder printed "8 failed" and then eight lines of "Unknown error" with neither a path nor a
|
|
477
|
+
* cause, and a skill that had installed fine was counted as failed too. Here each action is judged on its own: it fails when
|
|
478
|
+
* the installer recorded an error for its name (or for its whole agent), and the error says which path and why.
|
|
479
|
+
*
|
|
480
|
+
* @param {Object} action - plan action (category 'skill' or 'command')
|
|
481
|
+
* @param {Object} installResult - from installSkills/CommandsToMultipleAgents
|
|
482
|
+
* @param {'skill'|'command'} kind
|
|
483
|
+
* @returns {{ action: Object, success: boolean, error?: string }}
|
|
484
|
+
*/
|
|
485
|
+
export function judgeBatchAction(action, installResult, kind) {
|
|
486
|
+
const meta = action.details?.metadata;
|
|
487
|
+
const name = kind === 'skill' ? meta?.skillName : meta?.commandName;
|
|
488
|
+
const installs = (installResult.installations || []).filter(i => !meta?.agent || i.agent === meta.agent);
|
|
489
|
+
const reasons = [];
|
|
490
|
+
for (const inst of installs) {
|
|
491
|
+
if (inst.error) reasons.push(inst.error);
|
|
492
|
+
for (const e of inst.errors || []) {
|
|
493
|
+
if (e && e[kind] === name && e.error) reasons.push(e.error);
|
|
494
|
+
}
|
|
495
|
+
}
|
|
496
|
+
if (reasons.length > 0) return { action, success: false, error: `${action.path}: ${reasons[0]}` };
|
|
497
|
+
if (installResult.success) return { action, success: true };
|
|
498
|
+
if (installs.some(i => (i.installed || []).includes(name))) return { action, success: true };
|
|
499
|
+
return { action, success: false, error: `${action.path}: the installer did not install ${kind} "${name}" and gave no reason` };
|
|
500
|
+
}
|
|
501
|
+
|
|
419
502
|
/**
|
|
420
503
|
* Batch execute skill installations.
|
|
421
504
|
*/
|
|
@@ -475,13 +558,20 @@ async function executeSkillBatch(projectPath, skillActions, manifest) {
|
|
|
475
558
|
if (installResult.allFileHashes) {
|
|
476
559
|
Object.assign(manifest.skillHashes, installResult.allFileHashes);
|
|
477
560
|
}
|
|
561
|
+
// XSPEC-475 R6: the skill files were just rewritten to what this UDS ships, so the records that describe them
|
|
562
|
+
// are brought to match. They were left at the old version and name list (the 6.11.0 -> 6.14 upgrade rewrote about
|
|
563
|
+
// 200 files and still recorded 6.11.0 and no `comprehension-ladder`), and the second command `--skills` was the
|
|
564
|
+
// only way to make the manifest agree with the disk.
|
|
565
|
+
if (installResult.success) {
|
|
566
|
+
recordInstalledSet(manifest, 'skills', installResult); // wire:apply-records-skills
|
|
567
|
+
}
|
|
478
568
|
|
|
479
569
|
for (const action of toInstall) {
|
|
480
|
-
results.push(
|
|
570
|
+
results.push(judgeBatchAction(action, installResult, 'skill')); // wire:skill-batch-names-its-failures
|
|
481
571
|
}
|
|
482
572
|
} catch (err) {
|
|
483
573
|
for (const action of toInstall) {
|
|
484
|
-
results.push({ action, success: false, error: err.message });
|
|
574
|
+
results.push({ action, success: false, error: `${action.path}: ${err.message}` });
|
|
485
575
|
}
|
|
486
576
|
}
|
|
487
577
|
}
|
|
@@ -562,13 +652,16 @@ async function executeCommandBatch(projectPath, commandActions, manifest) {
|
|
|
562
652
|
// neither line.
|
|
563
653
|
Object.assign(manifest.commandHashes, installResult.allFileHashes);
|
|
564
654
|
}
|
|
655
|
+
if (installResult.success) {
|
|
656
|
+
recordInstalledSet(manifest, 'commands', installResult); // wire:apply-records-commands (XSPEC-475 R6)
|
|
657
|
+
}
|
|
565
658
|
|
|
566
659
|
for (const action of toInstall) {
|
|
567
|
-
results.push(
|
|
660
|
+
results.push(judgeBatchAction(action, installResult, 'command'));
|
|
568
661
|
}
|
|
569
662
|
} catch (err) {
|
|
570
663
|
for (const action of toInstall) {
|
|
571
|
-
results.push({ action, success: false, error: err.message });
|
|
664
|
+
results.push({ action, success: false, error: `${action.path}: ${err.message}` });
|
|
572
665
|
}
|
|
573
666
|
}
|
|
574
667
|
}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The version the manifest records for the skills and the commands (XSPEC-475 R6).
|
|
3
|
+
*
|
|
4
|
+
* When a reconcile leaves nothing to do (or does everything cleanly), the skill and command files are exactly what this UDS
|
|
5
|
+
* ships, so the version recorded for them is the shipped one. It was left at the version of the UDS that installed them, and
|
|
6
|
+
* `uds check` went on saying "Commands: v6.11.0 -> v6.14..." for a project that was in fact current.
|
|
7
|
+
*
|
|
8
|
+
* @module reconciler/recorded-versions
|
|
9
|
+
*/
|
|
10
|
+
|
|
11
|
+
import { getRepositoryInfo } from '../utils/registry.js';
|
|
12
|
+
|
|
13
|
+
/**
|
|
14
|
+
* Set `skills.version` and `commands.version` to the shipped version for each that is installed (not a marketplace install).
|
|
15
|
+
* Mutates and returns `manifest`; `changed` says whether anything differed.
|
|
16
|
+
* @param {Object} manifest
|
|
17
|
+
* @returns {{ manifest: Object, changed: boolean }}
|
|
18
|
+
*/
|
|
19
|
+
export function alignRecordedVersions(manifest) {
|
|
20
|
+
const shipped = getRepositoryInfo()?.skills?.version;
|
|
21
|
+
let changed = false;
|
|
22
|
+
if (!shipped) return { manifest, changed };
|
|
23
|
+
for (const kind of ['skills', 'commands']) {
|
|
24
|
+
const record = manifest[kind];
|
|
25
|
+
if (record?.installed === true && record.location !== 'marketplace' && record.version !== shipped) {
|
|
26
|
+
manifest[kind] = { ...record, version: shipped }; // [mutation-anchor:align-version]
|
|
27
|
+
changed = true;
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
return { manifest, changed };
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* Set `upstream.version` (and the date it was recorded) to the standards version this UDS ships (XSPEC-482 R6).
|
|
35
|
+
*
|
|
36
|
+
* The same reasoning as for skills and commands above: when a reconcile finds nothing to do, every standard file is exactly
|
|
37
|
+
* what this UDS ships, so the version recorded for the standards is the shipped one. Only a reconcile that EXECUTED a plan
|
|
38
|
+
* recorded it, so a project whose files were already current kept the version of the UDS that installed them; it surfaced
|
|
39
|
+
* once `uds init` left a project with nothing for the first `--apply` to do (the XSPEC-382 R5 end-to-end test seeds an old
|
|
40
|
+
* version and expects `--apply` to move it).
|
|
41
|
+
* @param {Object} manifest
|
|
42
|
+
* @returns {{ manifest: Object, changed: boolean }}
|
|
43
|
+
*/
|
|
44
|
+
export function alignUpstreamVersion(manifest) {
|
|
45
|
+
const shipped = getRepositoryInfo()?.standards?.version;
|
|
46
|
+
if (!shipped || !manifest?.upstream || manifest.upstream.version === shipped) return { manifest, changed: false };
|
|
47
|
+
manifest.upstream = { ...manifest.upstream, version: shipped, installed: new Date().toISOString().split('T')[0] };
|
|
48
|
+
return { manifest, changed: true };
|
|
49
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Project-relative paths as the user sees them (XSPEC-486 R4).
|
|
3
|
+
*
|
|
4
|
+
* The reconciler names every file it plans, writes or fails on by a path relative to the project. The standards rows
|
|
5
|
+
* were already written with `/`; the skill and command rows came from `path.join`, so on Windows they read
|
|
6
|
+
* `.claude\skills\x` next to `.standards/y` in the same plan and error list. One rule for all of them: `/`.
|
|
7
|
+
*/
|
|
8
|
+
|
|
9
|
+
import path from 'path';
|
|
10
|
+
|
|
11
|
+
/**
|
|
12
|
+
* @param {string} projectPath - Project root
|
|
13
|
+
* @param {string} absPath - A path under the project (a path outside it is returned as it is: it is not "relative")
|
|
14
|
+
* @param {{ sep: string }} [pathModule] - The path flavour that built `absPath` (a test passes `path.win32`)
|
|
15
|
+
* @returns {string} The path relative to the project, with `/` between the parts
|
|
16
|
+
*/
|
|
17
|
+
export function projectRelative(projectPath, absPath, pathModule = path) {
|
|
18
|
+
if (!absPath.startsWith(projectPath)) return absPath;
|
|
19
|
+
let rel = absPath.slice(projectPath.length);
|
|
20
|
+
if (rel.startsWith('/') || rel.startsWith('\\')) rel = rel.slice(1);
|
|
21
|
+
// Only where `\` is the separator: on POSIX a backslash is a legal character of a file name.
|
|
22
|
+
return pathModule.sep === '\\' ? rel.split('\\').join('/') : rel;
|
|
23
|
+
}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { existsSync, readFileSync, writeFileSync, unlinkSync, readdirSync, rmdirSync } from 'fs';
|
|
2
2
|
import { join, basename } from 'path';
|
|
3
3
|
import { proveUnchanged, RECORD_KINDS, RECORDS_KEY, isRealDirectory } from '../core/install-records.js';
|
|
4
|
-
import { stripUdsHookBlock } from '../utils/git-hooks.js';
|
|
4
|
+
import { stripUdsHookBlock, classifyNativePreCommitHook } from '../utils/git-hooks.js';
|
|
5
5
|
import {
|
|
6
6
|
collectHookConfigs, standardsSourceDir, hooksSourceDir,
|
|
7
7
|
CODEX_HOOK_SCRIPT, GEMINI_HOOK_SCRIPT, AGY_HOOK_SCRIPT,
|
|
@@ -427,6 +427,14 @@ export function uninstallHook(projectPath, options = {}) {
|
|
|
427
427
|
if (!dryRun) unlinkSync(nativeHookPath);
|
|
428
428
|
result.removed.push(`.git/hooks/pre-commit (UDS native hook, file removed — ${proof.why})`);
|
|
429
429
|
result.deletedPaths.push('.git/hooks/pre-commit');
|
|
430
|
+
} else if (classifyNativePreCommitHook(content)) { // wire:uninstall-removes-known-native-hook
|
|
431
|
+
// XSPEC-482 R8: no install record (an older UDS wrote it, and old versions recorded nothing), but the file
|
|
432
|
+
// is byte for byte a hook UDS has written - the always-pass hook of 5.x to 6.13.1, or one of the later ones.
|
|
433
|
+
// Exact text is the proof; deleting only the matching lines used to leave a script behind that still
|
|
434
|
+
// printed "Pre-commit checks passed" and checked nothing.
|
|
435
|
+
if (!dryRun) unlinkSync(nativeHookPath);
|
|
436
|
+
result.removed.push('.git/hooks/pre-commit (UDS native hook, file removed - its text is exactly what UDS writes, so nothing of yours is in it)');
|
|
437
|
+
result.deletedPaths.push('.git/hooks/pre-commit');
|
|
430
438
|
} else if (!NATIVE_UDS_LINE.test(content) && !stripUdsHookBlock(content).removed) {
|
|
431
439
|
result.skipped.push('.git/hooks/pre-commit (no UDS lines found)');
|
|
432
440
|
} else {
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { existsSync, rmSync, rmdirSync, readdirSync, unlinkSync } from 'fs';
|
|
2
|
-
import { dirname, join } from 'path';
|
|
2
|
+
import { dirname, join, relative, isAbsolute, resolve } from 'path';
|
|
3
3
|
import {
|
|
4
4
|
getSkillsDirForAgent,
|
|
5
5
|
getCommandsDirForAgent
|
|
@@ -76,6 +76,14 @@ function removeIfEmpty(dir) {
|
|
|
76
76
|
}
|
|
77
77
|
}
|
|
78
78
|
|
|
79
|
+
/** Remove the folder that held `dir` when it is empty and strictly inside `projectPath`. */
|
|
80
|
+
function removeEmptyParentInside(dir, projectPath) {
|
|
81
|
+
const parent = dirname(dir);
|
|
82
|
+
const rel = relative(projectPath, parent);
|
|
83
|
+
if (rel === '' || rel.startsWith('..') || isAbsolute(rel)) return;
|
|
84
|
+
removeIfEmpty(parent);
|
|
85
|
+
}
|
|
86
|
+
|
|
79
87
|
/**
|
|
80
88
|
* Process a single skill/command installation for removal
|
|
81
89
|
*/
|
|
@@ -140,10 +148,21 @@ function processInstallation(install, type, projectPath, manifest, options, resu
|
|
|
140
148
|
if (existsSync(marker)) rmSync(marker, { force: true });
|
|
141
149
|
}
|
|
142
150
|
// Folders UDS emptied, deepest first, then the installation folder itself.
|
|
151
|
+
// The installation folder is compared as a resolved path: `dir` carries the trailing slash the path table
|
|
152
|
+
// gives it (`.gemini/commands/`) and `dirname(file)` does not, so the old `d !== dir` was true for the
|
|
153
|
+
// installation folder itself. It was removed in this loop, `removeIfEmpty(dir)` below then found nothing to
|
|
154
|
+
// remove and answered "not gone": the line said "folder kept" for a folder that was deleted, and the tool's
|
|
155
|
+
// own parent (`.gemini/`, `.opencode/`) was never looked at, so an empty one stayed (XSPEC-482 R8).
|
|
156
|
+
const installDir = resolve(dir);
|
|
143
157
|
for (const d of [...touched].sort((a, b) => b.length - a.length)) {
|
|
144
|
-
if (d !==
|
|
158
|
+
if (resolve(d) !== installDir) removeIfEmpty(d);
|
|
145
159
|
}
|
|
146
|
-
|
|
160
|
+
removeIfEmpty(dir);
|
|
161
|
+
const gone = !existsSync(dir); // wire:uninstall-folder-removed-is-reported
|
|
162
|
+
// XSPEC-475 R5(d): the tool's own folder (`.claude/`, `.codex/` ...) that held only what UDS wrote is empty now; an
|
|
163
|
+
// empty `.claude/` left in the project is a trace of UDS. Only an EMPTY folder inside the project, never the project
|
|
164
|
+
// root, and never a user-level folder.
|
|
165
|
+
if (gone && !isUserLevel) removeEmptyParentInside(dir, projectPath);
|
|
147
166
|
result.removed.push(`${label} → ${dir} (${toRemove.length} file(s) UDS wrote${gone ? '' : '; folder kept: it still holds files that are not UDS\'s'})`);
|
|
148
167
|
if (changed.length > 0) result.skipped.push(`${label} — kept ${changed.length} file(s) changed since UDS wrote them`);
|
|
149
168
|
} catch (error) {
|
|
@@ -35,7 +35,7 @@ function breakdown(byCategory) {
|
|
|
35
35
|
*/
|
|
36
36
|
export function printAvailableStandardsSection(manifest, { phase }) {
|
|
37
37
|
const msg = t().availableStandards;
|
|
38
|
-
const { offered, notOffered,
|
|
38
|
+
const { offered, notOffered, recommended } = getAvailableStandards(manifest);
|
|
39
39
|
|
|
40
40
|
console.log();
|
|
41
41
|
if (offered.length === 0) {
|
|
@@ -57,20 +57,41 @@ export function printAvailableStandardsSection(manifest, { phase }) {
|
|
|
57
57
|
console.log(chalk.gray(` ${msg.installHint}`));
|
|
58
58
|
}
|
|
59
59
|
|
|
60
|
-
|
|
61
|
-
|
|
60
|
+
// XSPEC-475 R9: the recommended core standards, one by one, each with the command that installs it.
|
|
61
|
+
if (recommended.length > 0) {
|
|
62
|
+
if (phase === 'apply') {
|
|
63
|
+
console.log(chalk.cyan(fill(msg.recommendedApply, { count: recommended.length, ids: recommended.map((s) => s.id).join(', ') })));
|
|
64
|
+
} else {
|
|
65
|
+
console.log(chalk.cyan(fill(msg.recommendedTitle, { count: recommended.length })));
|
|
66
|
+
for (const std of recommended) {
|
|
67
|
+
console.log(` ${chalk.green(std.id)} ${chalk.gray(`— ${std.description}`)}`);
|
|
68
|
+
console.log(chalk.gray(` uds update --apply --add-standard ${std.id}`)); // [mutation-anchor:recommended-install-command]
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
// "Not listed above" counts what is NOT listed: the recommended ones were listed one by one, so they are taken out of the
|
|
74
|
+
// count and of the breakdown (XSPEC-475 R9; it said 95 when 2 of the 95 were on the lines above).
|
|
75
|
+
const unlisted = notOffered.filter((n) => !recommended.some((r) => r.id === n.id)); // [mutation-anchor:unlisted-count]
|
|
76
|
+
if (unlisted.length > 0) {
|
|
77
|
+
const byCategory = {};
|
|
78
|
+
for (const n of unlisted) byCategory[n.category] = (byCategory[n.category] || 0) + 1;
|
|
79
|
+
console.log(chalk.gray(fill(msg.othersLine, { count: unlisted.length, breakdown: breakdown(byCategory) })));
|
|
62
80
|
}
|
|
63
81
|
}
|
|
64
82
|
|
|
65
83
|
/** `uds check`: one line, never part of the verdict. */
|
|
66
84
|
export function printAvailableStandardsCheckLine(manifest) {
|
|
67
85
|
const msg = t().availableStandards;
|
|
68
|
-
const { offered } = getAvailableStandards(manifest);
|
|
86
|
+
const { offered, recommended } = getAvailableStandards(manifest);
|
|
69
87
|
if (offered.length === 0) {
|
|
70
88
|
console.log(chalk.gray(msg.checkNone));
|
|
71
89
|
} else {
|
|
72
90
|
console.log(chalk.cyan(fill(msg.checkLine, { count: offered.length })));
|
|
73
91
|
}
|
|
92
|
+
if (recommended.length > 0) {
|
|
93
|
+
console.log(chalk.cyan(fill(msg.checkRecommended, { count: recommended.length, ids: recommended.map((s) => s.id).join(', ') })));
|
|
94
|
+
}
|
|
74
95
|
}
|
|
75
96
|
|
|
76
97
|
/**
|
|
@@ -23,6 +23,14 @@
|
|
|
23
23
|
* "new upstream" — they were never in the offer. Why, per category, is in CATEGORY_NOTES.
|
|
24
24
|
* They are still returned (with a reason) so no command can silently pretend they do not exist.
|
|
25
25
|
*
|
|
26
|
+
* Recommended core standards (XSPEC-475 R9)
|
|
27
|
+
* -----------------------------------------
|
|
28
|
+
* 59 core standards are not installed by `uds init`, and listing all of them one by one in every `--plan` would bury the
|
|
29
|
+
* few an adopter asked about. A registry entry marked `"recommended": true` (today `turn-completion-integrity` and
|
|
30
|
+
* `pipeline-security-gates`, the two adopters named) is returned in `recommended` and listed one by one with its install
|
|
31
|
+
* command; the rest stay a count. `recommended` is information only: it is NOT in `offered`, so the old `uds update --yes`
|
|
32
|
+
* path, which installs whatever `offered` holds, does not install them (XSPEC-458: listing and installing stay apart).
|
|
33
|
+
*
|
|
26
34
|
* Manifest fields that look like they should matter, and do not (measured 2026-10-07):
|
|
27
35
|
* - `level` — a manifest written by 6.11.0 carries it only as a leftover snapshot inside
|
|
28
36
|
* `integrationConfigs[<file>].level`; no code reads it to decide what to install, the generator
|
|
@@ -122,7 +130,8 @@ export function oneLineDescription(description, max = 100) {
|
|
|
122
130
|
* @returns {{
|
|
123
131
|
* offered: AvailableStandard[],
|
|
124
132
|
* notOffered: Array<AvailableStandard & {reason: string, addable: boolean}>,
|
|
125
|
-
* notOfferedByCategory: Object<string, number
|
|
133
|
+
* notOfferedByCategory: Object<string, number>,
|
|
134
|
+
* recommended: AvailableStandard[]
|
|
126
135
|
* }}
|
|
127
136
|
*/
|
|
128
137
|
export function getAvailableStandards(manifest) {
|
|
@@ -138,7 +147,7 @@ export function getAvailableStandards(manifest) {
|
|
|
138
147
|
const name = basename(source);
|
|
139
148
|
if (installed.has(name)) continue;
|
|
140
149
|
|
|
141
|
-
const item = { id: std.id, category: std.category, description: oneLineDescription(std.description), source, name };
|
|
150
|
+
const item = { id: std.id, category: std.category, description: oneLineDescription(std.description), source, name, recommended: std.recommended === true };
|
|
142
151
|
if (OFFERED_CATEGORIES.includes(std.category)) {
|
|
143
152
|
offered.push(item);
|
|
144
153
|
} else {
|
|
@@ -152,7 +161,8 @@ export function getAvailableStandards(manifest) {
|
|
|
152
161
|
|
|
153
162
|
const notOfferedByCategory = {};
|
|
154
163
|
for (const n of notOffered) notOfferedByCategory[n.category] = (notOfferedByCategory[n.category] || 0) + 1;
|
|
155
|
-
|
|
164
|
+
const recommended = notOffered.filter((n) => n.addable && n.recommended); // [mutation-anchor:recommended-core]
|
|
165
|
+
return { offered, notOffered, notOfferedByCategory, recommended };
|
|
156
166
|
}
|
|
157
167
|
|
|
158
168
|
/** Plain edit distance, enough for "did you mean". */
|