universal-dev-standards 6.14.0-beta.9 → 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 +2309 -1110
- 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 +2282 -1112
- 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 +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 +173 -20
- 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
|
|
|
@@ -1940,7 +1947,6 @@ export function migrateLegacyPreCommitHook(projectPath, manifest, { plan = false
|
|
|
1940
1947
|
if (r.state === 'error') {
|
|
1941
1948
|
console.log(chalk.yellow(` ${msg.hookMigrateFailed.replace('{error}', r.error)}`));
|
|
1942
1949
|
console.log();
|
|
1943
|
-
return r;
|
|
1944
1950
|
}
|
|
1945
1951
|
if (r.state === 'migrated') console.log(chalk.green(` ${msg.hookMigrated}`));
|
|
1946
1952
|
if (r.state === 'would-migrate') console.log(chalk.cyan(` ${msg.hookWouldMigrate}`));
|
|
@@ -1954,6 +1960,30 @@ export function migrateLegacyPreCommitHook(projectPath, manifest, { plan = false
|
|
|
1954
1960
|
// this the record persisted just above would be overwritten by the older copy.
|
|
1955
1961
|
Object.assign(manifest, mergeRecorderInto(manifest, r.recorder));
|
|
1956
1962
|
}
|
|
1963
|
+
|
|
1964
|
+
// XSPEC-482 R3 + R5: hooks that run the check and cannot stop a commit - the husky block that runs `check`
|
|
1965
|
+
// without `--ci`, and the native hook of 5.x .. 6.13.1 / the betas. Same treatment as above: only a text UDS
|
|
1966
|
+
// provably wrote is replaced, anything else is named and left alone, and --plan lists it.
|
|
1967
|
+
const huskyCi = migrateHuskyBlockWithoutCi(projectPath, { plan, manifest });
|
|
1968
|
+
if (huskyCi.state === 'error') console.log(chalk.yellow(` ${msg.hookMigrateFailed.replace('{error}', huskyCi.error)}`));
|
|
1969
|
+
if (huskyCi.state === 'migrated') console.log(chalk.green(` ${msg.hookHuskyCiMigrated}`)); // wire:update-migrates-husky-ci
|
|
1970
|
+
if (huskyCi.state === 'would-migrate') console.log(chalk.cyan(` ${msg.hookHuskyCiWouldMigrate}`));
|
|
1971
|
+
|
|
1972
|
+
const native = migrateOlderNativeHook(projectPath, { plan }); // wire:update-migrates-native-hook
|
|
1973
|
+
const nativeFrom = native.from === 'legacy-6.11' ? msg.hookNativeFromLegacy : msg.hookNativeFromWithoutCi;
|
|
1974
|
+
if (native.state === 'error') console.log(chalk.yellow(` ${msg.hookNativeFailed.replace('{error}', native.error)}`));
|
|
1975
|
+
if (native.state === 'migrated') console.log(chalk.green(` ${msg.hookNativeMigrated.replace('{from}', nativeFrom)}`));
|
|
1976
|
+
if (native.state === 'would-migrate') console.log(chalk.cyan(` ${msg.hookNativeWouldMigrate.replace('{from}', nativeFrom)}`));
|
|
1977
|
+
for (const k of native.kept) {
|
|
1978
|
+
console.log(chalk.yellow(` ${msg.hookNativeKept.replace('{line}', k.line).replace('{text}', k.text)}`));
|
|
1979
|
+
}
|
|
1980
|
+
if (huskyCi.state !== 'none' || native.state !== 'none') console.log();
|
|
1981
|
+
for (const extra of [huskyCi.recorder, native.recorder]) {
|
|
1982
|
+
if (extra) {
|
|
1983
|
+
persistRecorder(projectPath, extra);
|
|
1984
|
+
Object.assign(manifest, mergeRecorderInto(manifest, extra));
|
|
1985
|
+
}
|
|
1986
|
+
}
|
|
1957
1987
|
return r;
|
|
1958
1988
|
}
|
|
1959
1989
|
|
|
@@ -2724,13 +2754,21 @@ async function planSkills(projectPath, manifest, options) {
|
|
|
2724
2754
|
return;
|
|
2725
2755
|
}
|
|
2726
2756
|
|
|
2757
|
+
// XSPEC-482 R7: "unchanged" needs the files to agree too, as `uds update --plan` judges them - a recorded version
|
|
2758
|
+
// equal to the shipped one says nothing about a skill file that was deleted or edited.
|
|
2759
|
+
const skillActions = await skillActionsOf(projectPath);
|
|
2760
|
+
|
|
2727
2761
|
let changed = 0;
|
|
2728
2762
|
for (const inst of installations) {
|
|
2729
2763
|
const info = getInstalledSkillsInfoForAgent(inst.agent, inst.level, projectPath);
|
|
2730
2764
|
const current = info?.version || 'unknown';
|
|
2731
|
-
const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath);
|
|
2732
|
-
|
|
2765
|
+
const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath) ?? '(no such folder)'; // XSPEC-486: null when the tool has no folder at that level
|
|
2766
|
+
const differing = skillActions.filter((a) => a.details?.metadata?.agent === inst.agent && (a.details?.metadata?.level || 'project') === inst.level);
|
|
2767
|
+
if (current === latestVersion && differing.length === 0) {
|
|
2733
2768
|
console.log(chalk.gray(` = ${getAgentDisplayName(inst.agent)} (${inst.level}): v${current} — unchanged`));
|
|
2769
|
+
} else if (current === latestVersion) {
|
|
2770
|
+
changed++;
|
|
2771
|
+
console.log(chalk.yellow(` ~ ${getAgentDisplayName(inst.agent)} (${inst.level}): v${current} — ${differing.length} skill file(s) differ from what this UDS ships ${dir}`));
|
|
2734
2772
|
} else {
|
|
2735
2773
|
changed++;
|
|
2736
2774
|
console.log(chalk.yellow(` ~ ${getAgentDisplayName(inst.agent)} (${inst.level}): v${current} → v${latestVersion} ${dir}`));
|
|
@@ -2759,21 +2797,44 @@ async function planCommands(projectPath, manifest, options) {
|
|
|
2759
2797
|
return;
|
|
2760
2798
|
}
|
|
2761
2799
|
|
|
2800
|
+
// XSPEC-482 R7: ask the reconciler, the same question `uds update --plan` answers, instead of saying "would be
|
|
2801
|
+
// reinstalled" for every installation whatever is on disk. A project that is current used to get "51 command(s)
|
|
2802
|
+
// would be reinstalled" here, "unchanged" from `--plan --skills` and "No changes" from `--plan`.
|
|
2803
|
+
const actions = await commandActionsOf(projectPath);
|
|
2804
|
+
|
|
2805
|
+
let changed = 0;
|
|
2762
2806
|
for (const inst of installations) {
|
|
2763
2807
|
const agent = typeof inst === 'string' ? inst : inst.agent;
|
|
2764
2808
|
const level = typeof inst === 'string' ? 'project' : (inst.level || 'project');
|
|
2765
2809
|
const info = getInstalledCommandsForAgent(agent, level, projectPath);
|
|
2766
2810
|
const dir = getCommandsDirForAgent(agent, level, projectPath);
|
|
2767
|
-
|
|
2811
|
+
const differing = actions.filter((a) => a.details?.metadata?.agent === agent && (a.details?.metadata?.level || 'project') === level);
|
|
2812
|
+
if (differing.length === 0) {
|
|
2813
|
+
console.log(chalk.gray(` = ${getAgentDisplayName(agent)} (${level}): ${info?.count || 0} command(s) — unchanged`));
|
|
2814
|
+
} else {
|
|
2815
|
+
changed++;
|
|
2816
|
+
console.log(chalk.yellow(` ~ ${getAgentDisplayName(agent)} (${level}): ${differing.length} command file(s) would be written or removed ${dir}`)); // wire:plan-commands-asks-reconciler
|
|
2817
|
+
}
|
|
2768
2818
|
}
|
|
2769
2819
|
|
|
2770
2820
|
console.log();
|
|
2771
|
-
console.log(`Summary: ${
|
|
2821
|
+
console.log(`Summary: ${changed} installation(s) would be reinstalled, ${installations.length - changed} unchanged.`);
|
|
2772
2822
|
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.'));
|
|
2823
|
+
if (changed > 0) console.log(chalk.gray(' Run `uds update --apply --yes --commands` to apply.'));
|
|
2774
2824
|
console.log();
|
|
2775
2825
|
}
|
|
2776
2826
|
|
|
2827
|
+
/** The reconciler's plan actions for skill and command files (what `uds update --plan` would list). */
|
|
2828
|
+
async function commandActionsOf(projectPath) {
|
|
2829
|
+
const { plan } = await reconcilerPlan(projectPath, {});
|
|
2830
|
+
return plan.actions.filter((a) => a.category === 'command');
|
|
2831
|
+
}
|
|
2832
|
+
|
|
2833
|
+
async function skillActionsOf(projectPath) {
|
|
2834
|
+
const { plan } = await reconcilerPlan(projectPath, {});
|
|
2835
|
+
return plan.actions.filter((a) => a.category === 'skill');
|
|
2836
|
+
}
|
|
2837
|
+
|
|
2777
2838
|
async function updateSkillsOnly(projectPath, manifest, options) {
|
|
2778
2839
|
const msg = t().commands.update;
|
|
2779
2840
|
const repoInfo = getRepositoryInfo();
|
|
@@ -2819,7 +2880,19 @@ async function updateSkillsOnly(projectPath, manifest, options) {
|
|
|
2819
2880
|
return Boolean(config?.supportsSkills && config?.skills);
|
|
2820
2881
|
});
|
|
2821
2882
|
const agents = detectedSkillsTools.length > 0 ? detectedSkillsTools : ['claude-code'];
|
|
2822
|
-
|
|
2883
|
+
// XSPEC-486 R2: a tool with no folder at the recorded level (antigravity has no user-level one) is not given
|
|
2884
|
+
// an installation that has nowhere to go.
|
|
2885
|
+
// …and the run says so, as `init` and `config` do (beta.15 Windows retest, Issue 1: this path was silent).
|
|
2886
|
+
for (const agent of agents) {
|
|
2887
|
+
if (hasSkillsLevel(agent, legacyLocation)) {
|
|
2888
|
+
skillsInstallations.push({ agent, level: legacyLocation });
|
|
2889
|
+
} else {
|
|
2890
|
+
console.log(chalk.yellow(
|
|
2891
|
+
`⚠ ${getAgentDisplayName(agent) || agent}: ` +
|
|
2892
|
+
`${msg.skillsNoUserPath || 'has no user-level skills folder (only the project one), so this update left it out. To put its skills into this project instead: uds config --type skills --ai-tool antigravity --skills-location project'}`
|
|
2893
|
+
));
|
|
2894
|
+
}
|
|
2895
|
+
}
|
|
2823
2896
|
} else if (legacyLocation === 'marketplace') {
|
|
2824
2897
|
console.log(chalk.yellow(msg.skillsViaMarketplace || 'Skills installed via Marketplace'));
|
|
2825
2898
|
console.log(chalk.gray(` ${msg.updateViaMarketplace || 'Update through Plugin Marketplace'}`));
|
|
@@ -2892,7 +2965,7 @@ async function updateSkillsOnly(projectPath, manifest, options) {
|
|
|
2892
2965
|
// Build location summary
|
|
2893
2966
|
const locations = fileBasedInstallations.map(inst => {
|
|
2894
2967
|
const displayName = getAgentDisplayName(inst.agent);
|
|
2895
|
-
const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath);
|
|
2968
|
+
const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath) ?? '(no such folder)'; // XSPEC-486
|
|
2896
2969
|
return `${displayName}: ${dir}`;
|
|
2897
2970
|
}).join(', ');
|
|
2898
2971
|
|
|
@@ -3366,7 +3439,7 @@ async function promptNewFeatureInstallation(missingSkills, outdatedSkills, missi
|
|
|
3366
3439
|
console.log(chalk.yellow(msg.skillsOutdatedFor || 'Skills updates available for these AI tools:'));
|
|
3367
3440
|
for (const skill of outdatedSkills) {
|
|
3368
3441
|
const levelLabel = skill.level === 'user' ? 'user' : 'project';
|
|
3369
|
-
const pathDisplay = skill.path || getSkillsDirForAgent(skill.agent, skill.level);
|
|
3442
|
+
const pathDisplay = skill.path || getSkillsDirForAgent(skill.agent, skill.level) || '(no such folder)';
|
|
3370
3443
|
console.log(chalk.gray(` • ${skill.displayName} (${levelLabel}: ${pathDisplay})`));
|
|
3371
3444
|
console.log(chalk.gray(` ${skill.currentVersion} → ${skill.latestVersion}`));
|
|
3372
3445
|
}
|
|
@@ -3375,7 +3448,7 @@ async function promptNewFeatureInstallation(missingSkills, outdatedSkills, missi
|
|
|
3375
3448
|
// Build checkbox choices with path info
|
|
3376
3449
|
const updateChoices = outdatedSkills.map(skill => {
|
|
3377
3450
|
const levelLabel = skill.level === 'user' ? 'user' : 'project';
|
|
3378
|
-
const pathDisplay = skill.path || getSkillsDirForAgent(skill.agent, skill.level);
|
|
3451
|
+
const pathDisplay = skill.path || getSkillsDirForAgent(skill.agent, skill.level) || '(no such folder)';
|
|
3379
3452
|
return {
|
|
3380
3453
|
name: `${skill.displayName} ${chalk.gray(`(${levelLabel}: ${pathDisplay}) ${skill.currentVersion} → ${skill.latestVersion}`)}`,
|
|
3381
3454
|
value: skill.agent,
|
|
@@ -3511,14 +3584,14 @@ function takeStepBackup(projectPath, label, installations, kind) {
|
|
|
3511
3584
|
console.log();
|
|
3512
3585
|
return { ok: false };
|
|
3513
3586
|
}
|
|
3514
|
-
cleanupBackupsQuietly(projectPath);
|
|
3515
|
-
return { ok: true, backupId: backup.backupId };
|
|
3587
|
+
return { ok: true, backupId: backup.backupId, cleanup: cleanupBackupsQuietly(projectPath) };
|
|
3516
3588
|
}
|
|
3517
3589
|
|
|
3518
3590
|
/** The step is over (its last manifest write is done): record what it created, and say how to undo it. */
|
|
3519
3591
|
function finishStepBackup(projectPath, backup) {
|
|
3520
3592
|
finalizeBackup(projectPath, backup.backupId);
|
|
3521
3593
|
printBackupLocation(backup.backupId);
|
|
3594
|
+
printBackupCleanup(backup.cleanup);
|
|
3522
3595
|
}
|
|
3523
3596
|
|
|
3524
3597
|
/**
|
|
@@ -3534,9 +3607,34 @@ function printBackupLocation(backupId) {
|
|
|
3534
3607
|
|
|
3535
3608
|
function cleanupBackupsQuietly(projectPath) {
|
|
3536
3609
|
try {
|
|
3537
|
-
cleanupBackups(projectPath);
|
|
3610
|
+
return cleanupBackups(projectPath);
|
|
3538
3611
|
} catch {
|
|
3539
3612
|
// an old backup that cannot be removed is not a reason to stop the update
|
|
3613
|
+
return null;
|
|
3614
|
+
}
|
|
3615
|
+
}
|
|
3616
|
+
|
|
3617
|
+
/**
|
|
3618
|
+
* Say what the backup limit did (XSPEC-475 R2). A backup is the adopter's data: one deleted without a word
|
|
3619
|
+
* is how an adopter loses the only copy of something version control cannot give back.
|
|
3620
|
+
* - every backup removed because `.uds-backups/` holds more than the limit is named;
|
|
3621
|
+
* - backups an older UDS left in the project root (`.uds-backup-*`) are never removed by the limit; they
|
|
3622
|
+
* are listed here with a suggestion to move them out themselves.
|
|
3623
|
+
* // implements XSPEC-475 R2
|
|
3624
|
+
*/
|
|
3625
|
+
function printBackupCleanup(cleanup) {
|
|
3626
|
+
if (!cleanup) return;
|
|
3627
|
+
const removed = cleanup.removed || [];
|
|
3628
|
+
const legacy = cleanup.legacyKept || [];
|
|
3629
|
+
if (removed.length > 0) {
|
|
3630
|
+
console.log(chalk.yellow(` Removed ${removed.length} old backup(s) beyond the limit of ${cleanup.keep} in .uds-backups/:`));
|
|
3631
|
+
for (const id of removed) console.log(chalk.yellow(` ✕ ${id}`));
|
|
3632
|
+
}
|
|
3633
|
+
for (const err of cleanup.errors || []) console.log(chalk.red(` ${err}`));
|
|
3634
|
+
if (legacy.length > 0) {
|
|
3635
|
+
console.log(chalk.yellow(` ${legacy.length} backup(s) from an older UDS are still in the project root and were NOT removed by the limit:`));
|
|
3636
|
+
for (const id of legacy) console.log(chalk.yellow(` - ${id}`));
|
|
3637
|
+
console.log(chalk.gray(' UDS never deletes these. If you need them, move them out of the project yourself (for example, to a folder outside the repository).'));
|
|
3540
3638
|
}
|
|
3541
3639
|
}
|
|
3542
3640
|
|
|
@@ -3551,20 +3649,37 @@ function printPaths(prefix, paths, limit, colour) {
|
|
|
3551
3649
|
* updates, then say, item by item, what was restored, what was removed, and what was NOT put back.
|
|
3552
3650
|
* It never ends in "successful" while any of those lists is not empty (XSPEC-454 R1).
|
|
3553
3651
|
*/
|
|
3554
|
-
async function handleRollback(projectPath) {
|
|
3652
|
+
async function handleRollback(projectPath, options = {}) {
|
|
3555
3653
|
const backups = listBackups(projectPath);
|
|
3556
3654
|
if (backups.length === 0) {
|
|
3557
3655
|
console.log(chalk.yellow('No backups found. Nothing to rollback.'));
|
|
3558
3656
|
console.log();
|
|
3657
|
+
if (options.from) process.exitCode = 1;
|
|
3559
3658
|
return;
|
|
3560
3659
|
}
|
|
3561
3660
|
|
|
3562
|
-
|
|
3661
|
+
// XSPEC-482 R11: `--from` names the one backup to restore. The default picks the newest series, and a backup an older
|
|
3662
|
+
// UDS made is never in it (it records no manifest hash to chain on), so without this there was no way to reach it.
|
|
3663
|
+
let chosen = null;
|
|
3664
|
+
if (options.from) {
|
|
3665
|
+
const wanted = String(options.from).replace(/\\/g, '/').replace(/\/+$/, '');
|
|
3666
|
+
const leaf = (id) => id.slice(id.lastIndexOf('/') + 1);
|
|
3667
|
+
chosen = backups.find((b) => b.backupId === wanted) || backups.find((b) => leaf(b.backupId) === leaf(wanted));
|
|
3668
|
+
if (!chosen) {
|
|
3669
|
+
console.log(chalk.red(`No backup named "${options.from}". Backups in this project:`));
|
|
3670
|
+
for (const b of backups) console.log(chalk.gray(` ${b.backupId} (${b.createdAt || 'no date'})`));
|
|
3671
|
+
console.log();
|
|
3672
|
+
process.exitCode = 1;
|
|
3673
|
+
return;
|
|
3674
|
+
}
|
|
3675
|
+
}
|
|
3676
|
+
|
|
3677
|
+
const latest = chosen || backups[0];
|
|
3563
3678
|
console.log(chalk.cyan(`Rolling back from: ${latest.backupId}`));
|
|
3564
3679
|
console.log(chalk.gray(` Created: ${latest.createdAt}`));
|
|
3565
3680
|
console.log();
|
|
3566
3681
|
|
|
3567
|
-
const result = rollbackLast(projectPath);
|
|
3682
|
+
const result = rollbackLast(projectPath, chosen ? chosen.backupId : undefined);
|
|
3568
3683
|
|
|
3569
3684
|
for (const step of result.steps || []) {
|
|
3570
3685
|
console.log(chalk.cyan(`${step.backupId}${step.label ? ` (${step.label})` : ''}`));
|
|
@@ -3582,7 +3697,16 @@ async function handleRollback(projectPath) {
|
|
|
3582
3697
|
console.log(chalk.gray(` ${result.steps.length} consecutive updates were undone together (each one started from where the previous one ended).`));
|
|
3583
3698
|
}
|
|
3584
3699
|
if (result.olderBackups > 0) {
|
|
3585
|
-
|
|
3700
|
+
// Say the true reason. A backup an older UDS made records no manifest hash, so there is nothing to tell whether it
|
|
3701
|
+
// continues the series; one that does carry the hash and still does not match means something else changed the project.
|
|
3702
|
+
const inSeries = (result.steps || []).length;
|
|
3703
|
+
const next = backups[inSeries];
|
|
3704
|
+
const why = next && !next.postManifestHash
|
|
3705
|
+
? 'it was made by an older UDS, which did not record what links one backup to the next, so it cannot be joined to the series'
|
|
3706
|
+
: 'something else changed the project after it was made';
|
|
3707
|
+
console.log(chalk.gray(` ${result.olderBackups} older backup(s) are not part of that series (${why}) and were left alone.`));
|
|
3708
|
+
console.log(chalk.gray(' To restore one of them on its own: `uds update --rollback --from <backup>`. They are:'));
|
|
3709
|
+
for (const b of backups.slice(inSeries)) console.log(chalk.gray(` ${b.backupId} (${b.createdAt || 'no date'})`)); // wire:rollback-names-older-backups
|
|
3586
3710
|
}
|
|
3587
3711
|
|
|
3588
3712
|
if (result.errors.length > 0) {
|
|
@@ -3677,8 +3801,24 @@ async function handleReconcile(projectPath, options, { force, addStandards = []
|
|
|
3677
3801
|
// XSPEC-454 R2: nothing to apply, but the manifest may still list skill files UDS never installed
|
|
3678
3802
|
// (they only ever get corrected by a write, and an up-to-date project has none coming).
|
|
3679
3803
|
const current = readManifest(projectPath);
|
|
3680
|
-
|
|
3804
|
+
// XSPEC-475 R6: nothing to apply means the files are what this UDS ships; the recorded versions say so too.
|
|
3805
|
+
let aligned = current ? alignRecordedVersions(current).changed : false; // wire:up-to-date-aligns-versions
|
|
3806
|
+
// XSPEC-482 R6: the same for the standards version, which only an executed plan used to record.
|
|
3807
|
+
if (current && alignUpstreamVersion(current).changed) aligned = true; // wire:up-to-date-aligns-upstream
|
|
3808
|
+
// XSPEC-456 R4 (kept through XSPEC-482 R6): the NAME lists are corrected here too. This early return used to be reached only by
|
|
3809
|
+
// a project that had nothing else to rewrite, which a fresh `uds init` almost never was; once init leaves the project current
|
|
3810
|
+
// it is the normal case, and the names UDS cannot vouch for (`_shared`, a retired skill) stayed in the manifest for good.
|
|
3811
|
+
// Ownership test only, as the reconciler does (no disk test).
|
|
3812
|
+
let droppedNames = 0;
|
|
3813
|
+
if (current) {
|
|
3814
|
+
const before = (current.skills?.names?.length || 0) + (current.commands?.names?.length || 0);
|
|
3815
|
+
pruneForeignSkillNames(current, '');
|
|
3816
|
+
pruneForeignCommandNames(current, '');
|
|
3817
|
+
droppedNames = before - ((current.skills?.names?.length || 0) + (current.commands?.names?.length || 0)); // wire:up-to-date-prunes-names
|
|
3818
|
+
}
|
|
3819
|
+
if (current && ((pruneForeignSkillHashes(current).length + pruneForeignCommandHashes(current).length) > 0 || aligned || droppedNames > 0)) writeManifest(current, projectPath);
|
|
3681
3820
|
console.log(chalk.green('Everything is up to date. No changes needed.'));
|
|
3821
|
+
if (droppedNames > 0) console.log(chalk.gray(` ${t().commands.update.droppedForeignNames.replace('{count}', droppedNames)}`));
|
|
3682
3822
|
// XSPEC-458 R2: "up to date" is about the files UDS manages; say what UDS ships that is not managed here.
|
|
3683
3823
|
printAvailableStandardsSection(planResult.manifest, { phase: 'apply' });
|
|
3684
3824
|
console.log();
|
|
@@ -3721,6 +3861,7 @@ async function handleReconcile(projectPath, options, { force, addStandards = []
|
|
|
3721
3861
|
|
|
3722
3862
|
if (result.execution?.backupId) {
|
|
3723
3863
|
printBackupLocation(result.execution.backupId);
|
|
3864
|
+
printBackupCleanup(result.execution.backupCleanup);
|
|
3724
3865
|
}
|
|
3725
3866
|
|
|
3726
3867
|
if (result.errors.length > 0) {
|
|
@@ -3731,6 +3872,18 @@ async function handleReconcile(projectPath, options, { force, addStandards = []
|
|
|
3731
3872
|
}
|
|
3732
3873
|
}
|
|
3733
3874
|
|
|
3875
|
+
if (!result.success) {
|
|
3876
|
+
// XSPEC-482 R10: say what a partly failed run left behind and the way to finish it.
|
|
3877
|
+
console.log();
|
|
3878
|
+
console.log(chalk.yellow(
|
|
3879
|
+
'Not everything was applied. The overall version record did not advance, and a skills or commands batch that failed keeps its ' +
|
|
3880
|
+
'old version record; a batch that succeeded has already recorded its new version. ' +
|
|
3881
|
+
'Fix the cause, then run `uds update --apply` again: it completes what is left.'
|
|
3882
|
+
));
|
|
3883
|
+
// XSPEC-482 R2: a failed action is a failed run. CI and scripts read the exit code, not the colour of a line.
|
|
3884
|
+
process.exitCode = 1; // wire:apply-fails-exit-1
|
|
3885
|
+
}
|
|
3886
|
+
|
|
3734
3887
|
// XSPEC-458 R2: the count of what UDS ships and this project lacks, with the command that installs one.
|
|
3735
3888
|
printAvailableStandardsSection(result.manifest || planResult.manifest, { phase: 'apply' });
|
|
3736
3889
|
console.log();
|
|
@@ -8,6 +8,7 @@
|
|
|
8
8
|
*/
|
|
9
9
|
|
|
10
10
|
import { BaseCompiler } from './base-compiler.js';
|
|
11
|
+
import { normalizeMatcher } from '../installers/hooks-installer.js';
|
|
11
12
|
|
|
12
13
|
const DEFAULT_MATCHERS = {
|
|
13
14
|
UserPromptSubmit: '',
|
|
@@ -27,7 +28,14 @@ export class ClaudeCodeCompiler extends BaseCompiler {
|
|
|
27
28
|
|
|
28
29
|
for (const std of enforceable) {
|
|
29
30
|
const { hook_script, trigger } = std.enforcement;
|
|
30
|
-
|
|
31
|
+
// Claude Code's matcher is a string (https://code.claude.com/docs/en/hooks, "Matcher patterns"). A standard may
|
|
32
|
+
// declare it as an object (`matcher: { tool: Write, path: "src/**/*.ts" }`); that used to be written to
|
|
33
|
+
// settings.json as the object, which the documented format has no place for (XSPEC-482 R4). Same reduction
|
|
34
|
+
// `uds init --with-hooks` and `uds update --with-hooks` apply, so the three write one format.
|
|
35
|
+
const declared = std.enforcement.matcher;
|
|
36
|
+
const matcher = declared === undefined || declared === null
|
|
37
|
+
? (DEFAULT_MATCHERS[trigger] ?? '')
|
|
38
|
+
: normalizeMatcher(declared); // wire:compile-matcher-is-a-string
|
|
31
39
|
|
|
32
40
|
if (!hooks[trigger]) {
|
|
33
41
|
hooks[trigger] = [];
|
|
@@ -354,13 +354,26 @@ export function getSkillsDirForAgent(agent, level = 'user', projectPath = null)
|
|
|
354
354
|
if (!config || !config.skills) return null;
|
|
355
355
|
|
|
356
356
|
if (level === 'user') {
|
|
357
|
-
|
|
357
|
+
// A tool can have no user-level folder (antigravity, on purpose). `null`, never `undefined`: every caller
|
|
358
|
+
// already treats a falsy answer as "no such place" (XSPEC-486 R2).
|
|
359
|
+
return config.skills.user || null; // wire:skills-dir-user-null-not-undefined
|
|
358
360
|
} else if (level === 'project' && projectPath) {
|
|
359
361
|
return join(projectPath, config.skills.project);
|
|
360
362
|
}
|
|
361
363
|
return null;
|
|
362
364
|
}
|
|
363
365
|
|
|
366
|
+
/**
|
|
367
|
+
* Does the agent have a skills folder at this level? A tool may have only a project folder (antigravity: agy
|
|
368
|
+
* knows one skills location, the workspace) - then no user-level skills can be listed, installed or removed.
|
|
369
|
+
* @param {string} agent - Agent identifier
|
|
370
|
+
* @param {string} level - 'user' or 'project'
|
|
371
|
+
* @returns {boolean}
|
|
372
|
+
*/
|
|
373
|
+
export function hasSkillsLevel(agent, level) {
|
|
374
|
+
return Boolean(AI_AGENT_PATHS[agent]?.skills?.[level]);
|
|
375
|
+
}
|
|
376
|
+
|
|
364
377
|
/**
|
|
365
378
|
* Get commands directory path for an agent
|
|
366
379
|
* @param {string} agent - Agent identifier
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Which file formats a manifest's `format` setting puts on disk.
|
|
3
|
+
*
|
|
4
|
+
* `both` is not a third kind of file: it is the human copy (.md) and the AI copy (.ai.yaml) of every standard and
|
|
5
|
+
* every option, side by side. The installer copies once per entry of this list, and the reconciler has to expect
|
|
6
|
+
* exactly the same set. When the reconciler read `both` as one format it resolved only the human copy and planned
|
|
7
|
+
* to delete every AI copy the installer had just written (XSPEC-483).
|
|
8
|
+
*
|
|
9
|
+
* @param {string} [format] - 'ai', 'human' or 'both'. Anything else, including a missing value, is read as 'ai'.
|
|
10
|
+
* @returns {string[]} The formats to resolve a source file in: ['ai', 'human'] for 'both', otherwise one entry.
|
|
11
|
+
*/
|
|
12
|
+
export function getInstalledFormats(format) {
|
|
13
|
+
if (format === 'both') return ['ai', 'human'];
|
|
14
|
+
return [format || 'ai'];
|
|
15
|
+
}
|
|
@@ -11,6 +11,10 @@
|
|
|
11
11
|
* - 待辦
|
|
12
12
|
* command_words: # extra program names read as a command in a next action or a draft
|
|
13
13
|
* - kubectl
|
|
14
|
+
* asked_at_words: # extra words that head the "when was it asked" column (XSPEC-475 R3)
|
|
15
|
+
* - 何時問
|
|
16
|
+
* waiting_for_words: # extra words that head the "what is it waiting for" column (XSPEC-475 R3)
|
|
17
|
+
* - 問什麼
|
|
14
18
|
*
|
|
15
19
|
* This file holds no rule. It turns the section into the same `--root NAME=DIR` and
|
|
16
20
|
* `--next-action-word WORD` arguments a person could type, and hands them to the checker, which
|
|
@@ -36,7 +40,7 @@ import { PROJECT_NAME } from '../utils/open-work-tracking.mjs';
|
|
|
36
40
|
* `error`: the file is readable and its open_work section is wrong (the command stops with exit 2).
|
|
37
41
|
*/
|
|
38
42
|
export function readOpenWorkDeclarations(cwd = process.cwd()) {
|
|
39
|
-
const out = { projects: {}, nextActionWords: [], commandWords: [], note: null, error: null };
|
|
43
|
+
const out = { projects: {}, nextActionWords: [], commandWords: [], askedAtWords: [], waitingForWords: [], note: null, error: null };
|
|
40
44
|
let config;
|
|
41
45
|
try {
|
|
42
46
|
config = loadProjectConfig(cwd);
|
|
@@ -71,6 +75,14 @@ export function readOpenWorkDeclarations(cwd = process.cwd()) {
|
|
|
71
75
|
out.commandWords.push(w);
|
|
72
76
|
}
|
|
73
77
|
}
|
|
78
|
+
for (const [key, into] of [['asked_at_words', out.askedAtWords], ['waiting_for_words', out.waitingForWords]]) {
|
|
79
|
+
if (section[key] === undefined || section[key] === null) continue;
|
|
80
|
+
if (!Array.isArray(section[key])) return bad(`.${key} must be a list of words`);
|
|
81
|
+
for (const w of section[key]) {
|
|
82
|
+
if (typeof w !== 'string') return bad(`.${key} must hold text only; write each word as plain text`);
|
|
83
|
+
into.push(w);
|
|
84
|
+
}
|
|
85
|
+
}
|
|
74
86
|
return out;
|
|
75
87
|
}
|
|
76
88
|
|
|
@@ -101,3 +113,10 @@ export function wordArguments(cliWords, declaredWords = []) {
|
|
|
101
113
|
for (const w of [].concat(cliWords ?? [], declaredWords)) argv.push('--next-action-word', w);
|
|
102
114
|
return argv;
|
|
103
115
|
}
|
|
116
|
+
|
|
117
|
+
/** The `--asked-at-word` or `--waiting-for-word` arguments (XSPEC-475 R3): the command line's words, then the file's. */
|
|
118
|
+
export function fieldWordArguments(flag, cliWords, declaredWords = []) {
|
|
119
|
+
const argv = [];
|
|
120
|
+
for (const w of [].concat(cliWords ?? [], declaredWords)) argv.push(flag, w);
|
|
121
|
+
return argv;
|
|
122
|
+
}
|
|
@@ -98,6 +98,61 @@ function validateConfig(config, filePath) {
|
|
|
98
98
|
}
|
|
99
99
|
}
|
|
100
100
|
|
|
101
|
+
/**
|
|
102
|
+
* True when `text` ends inside an open quote, reading it the way a shell does: a `'` inside `"..."` (and a `"` inside
|
|
103
|
+
* `'...'`) is plain text, and a backslash escapes the next character outside single quotes.
|
|
104
|
+
*/
|
|
105
|
+
function endsInsideQuote(text) {
|
|
106
|
+
let open = null;
|
|
107
|
+
for (let i = 0; i < text.length; i++) {
|
|
108
|
+
const ch = text[i];
|
|
109
|
+
if (open === null) {
|
|
110
|
+
if (ch === '\\') i++;
|
|
111
|
+
else if (ch === '"' || ch === "'") open = ch;
|
|
112
|
+
} else if (open === '"' && ch === '\\') {
|
|
113
|
+
i++;
|
|
114
|
+
} else if (ch === open) {
|
|
115
|
+
open = null;
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
return open !== null;
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
/**
|
|
122
|
+
* The 1-based line of uds.project.yaml whose command YAML cut short in the middle of a quote, or null. XSPEC-475 R5(c).
|
|
123
|
+
*
|
|
124
|
+
* YAML ends an unquoted value at a space followed by `#`. `build: node -p "'quoted # kept'"` therefore becomes
|
|
125
|
+
* `node -p "'quoted`: the shell would have kept the `#`, YAML does not, and what is left has an unclosed quote - a command
|
|
126
|
+
* that cannot be what the author meant. A genuine trailing comment (`test: dotnet test X.csproj # 90 tests pass`) leaves a
|
|
127
|
+
* complete command and is the supported way to comment, so it is NOT reported. Only the cut-short case is, and the text YAML
|
|
128
|
+
* dropped is not repeated (it may be a comment the person wants kept out of the output).
|
|
129
|
+
*
|
|
130
|
+
* Only a plain (unquoted) scalar on one line is looked at, and only when the value YAML produced is exactly the text
|
|
131
|
+
* before the `#` - so a line this cannot match up with the parsed value is never reported.
|
|
132
|
+
* @param {string} projectPath
|
|
133
|
+
* @param {string} intent
|
|
134
|
+
* @param {string} command - the value YAML produced for `intent`
|
|
135
|
+
* @returns {number|null}
|
|
136
|
+
*/
|
|
137
|
+
export function truncatedYamlValueLine(projectPath, intent, command) {
|
|
138
|
+
const configPath = join(projectPath, CONFIG_FILENAME);
|
|
139
|
+
if (!existsSync(configPath)) return null;
|
|
140
|
+
const escaped = intent.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
|
|
141
|
+
const line = new RegExp(`^[ \\t]+${escaped}[ \\t]*:[ \\t]+(.*)$`);
|
|
142
|
+
const lines = readFileSync(configPath, 'utf8').split(/\r?\n/);
|
|
143
|
+
for (let n = 0; n < lines.length; n++) {
|
|
144
|
+
const m = line.exec(lines[n]);
|
|
145
|
+
if (!m) continue;
|
|
146
|
+
const value = m[1].trim();
|
|
147
|
+
if (/^["'|>[{&*!]/.test(value)) continue; // quoted, block, flow or anchored: not a plain scalar
|
|
148
|
+
const at = value.search(/\s#/);
|
|
149
|
+
if (at < 0) continue;
|
|
150
|
+
if (value.slice(0, at).trim() !== command) continue; // not the line YAML read this value from
|
|
151
|
+
return endsInsideQuote(command) ? n + 1 : null; // [mutation-anchor:cut-inside-quote]
|
|
152
|
+
}
|
|
153
|
+
return null;
|
|
154
|
+
}
|
|
155
|
+
|
|
101
156
|
/**
|
|
102
157
|
* Get a specific command intent from config.
|
|
103
158
|
* Returns undefined if not configured.
|