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
|
@@ -26,9 +26,12 @@
|
|
|
26
26
|
* @module utils/legacy-hook-migration
|
|
27
27
|
*/
|
|
28
28
|
|
|
29
|
-
import { existsSync, readFileSync, writeFileSync } from 'fs';
|
|
29
|
+
import { existsSync, readFileSync, writeFileSync, chmodSync } from 'fs';
|
|
30
30
|
import { join } from 'path';
|
|
31
|
-
import {
|
|
31
|
+
import {
|
|
32
|
+
buildPreCommitBlock, buildNativePreCommitHook, classifyNativePreCommitHook,
|
|
33
|
+
UDS_HOOK_MARKER, UDS_HOOK_END_MARKER, BARE_UDS_RUNNER_RE, hasBareUdsRunner
|
|
34
|
+
} from './git-hooks.js';
|
|
32
35
|
import { getFileRecord, proveUnchanged, recordFile, newRecorder, RECORD_KINDS } from '../core/install-records.js';
|
|
33
36
|
|
|
34
37
|
/** The exact command lines UDS itself has written under the marker, and the extra arguments each carried. */
|
|
@@ -110,3 +113,119 @@ export function migrateLegacyHuskyHook(projectPath, { plan = false, manifest = n
|
|
|
110
113
|
}
|
|
111
114
|
return { state: 'migrated', replaced, kept, recorder };
|
|
112
115
|
}
|
|
116
|
+
|
|
117
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
118
|
+
// XSPEC-482 R3 + R5: pre-commit hooks that look like a check and cannot stop a commit.
|
|
119
|
+
//
|
|
120
|
+
// Two shapes are on disk in projects UDS set up earlier, and both let every commit through:
|
|
121
|
+
// - `.git/hooks/pre-commit` of 5.x .. 6.13.1: `uds check 2>/dev/null || true` (the CLI PATH happens to
|
|
122
|
+
// hold, errors thrown away, "Pre-commit checks passed" printed whatever happened);
|
|
123
|
+
// - the hook of 6.14.0-beta.2 .. beta.12 (native file, or the block inside `.husky/pre-commit`): it runs
|
|
124
|
+
// the installed CLI, but `check` without `--ci` exits 0 when a standard file was edited.
|
|
125
|
+
// `uds init` now writes `check --ci`. These functions bring the files already on disk to it.
|
|
126
|
+
//
|
|
127
|
+
// What counts as "UDS wrote this": the whole file equals one of the known texts (native hook), or the
|
|
128
|
+
// block between UDS's two marker lines equals the known block (husky). Exact equality, not a pattern: a
|
|
129
|
+
// hook someone edited is NOT replaced - it is reported with the line number and what to write instead.
|
|
130
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
131
|
+
|
|
132
|
+
|
|
133
|
+
/** A hook line that runs a UDS check and is built never to fail: `... check ... || true`. */
|
|
134
|
+
const ALWAYS_PASS_CHECK_RE = /\b(?:uds|universal-dev-standards)\s+check\b[^\n]*\|\|\s*true\b/;
|
|
135
|
+
|
|
136
|
+
/**
|
|
137
|
+
* Bring the native `.git/hooks/pre-commit` of an older UDS to the one this CLI writes.
|
|
138
|
+
*
|
|
139
|
+
* @param {string} projectPath
|
|
140
|
+
* @param {{plan?: boolean}} [opts] plan - report what would change, write nothing
|
|
141
|
+
* @returns {{
|
|
142
|
+
* file: '.git/hooks/pre-commit',
|
|
143
|
+
* state: 'none'|'migrated'|'would-migrate'|'kept'|'error',
|
|
144
|
+
* from?: 'legacy-6.11'|'without-ci',
|
|
145
|
+
* kept: Array<{line: number, text: string}>, // lines that make the check always pass, in a file UDS cannot prove it wrote
|
|
146
|
+
* recorder: object|null, // install record to fold into the manifest when non-null
|
|
147
|
+
* error?: string
|
|
148
|
+
* }}
|
|
149
|
+
*/
|
|
150
|
+
export function migrateOlderNativeHook(projectPath, { plan = false } = {}) {
|
|
151
|
+
const file = '.git/hooks/pre-commit';
|
|
152
|
+
const abs = join(projectPath, '.git', 'hooks', 'pre-commit');
|
|
153
|
+
const none = { file, state: 'none', kept: [], recorder: null };
|
|
154
|
+
if (!existsSync(abs)) return none;
|
|
155
|
+
|
|
156
|
+
let content;
|
|
157
|
+
try {
|
|
158
|
+
content = readFileSync(abs, 'utf-8');
|
|
159
|
+
} catch (e) {
|
|
160
|
+
return { ...none, state: 'error', error: e.message };
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
const known = classifyNativePreCommitHook(content);
|
|
164
|
+
if (known === 'legacy-6.11' || known === 'without-ci') {
|
|
165
|
+
if (plan) return { ...none, state: 'would-migrate', from: known };
|
|
166
|
+
try {
|
|
167
|
+
// Keep the file's own line endings: a hook saved with CRLF stays CRLF (the husky path below does the same).
|
|
168
|
+
const fresh = buildNativePreCommitHook();
|
|
169
|
+
writeFileSync(abs, content.includes('\r\n') ? fresh.replace(/\n/g, '\r\n') : fresh, 'utf-8'); // wire:native-migration-keeps-eol
|
|
170
|
+
// writeFileSync keeps an existing file's mode; make sure git will still run it.
|
|
171
|
+
if (process.platform !== 'win32') chmodSync(abs, 0o755);
|
|
172
|
+
} catch (e) {
|
|
173
|
+
return { ...none, state: 'error', from: known, error: e.message };
|
|
174
|
+
}
|
|
175
|
+
// The whole file is UDS's again: record it, so `uds uninstall` can delete it as provably ours.
|
|
176
|
+
const recorder = newRecorder();
|
|
177
|
+
recordFile(recorder, projectPath, file, RECORD_KINDS.GIT_HOOK);
|
|
178
|
+
return { ...none, state: 'migrated', from: known, recorder };
|
|
179
|
+
}
|
|
180
|
+
if (known === 'current') return none;
|
|
181
|
+
|
|
182
|
+
// Not a text UDS wrote: if it still carries the always-pass check, say where. It is not replaced.
|
|
183
|
+
const kept = [];
|
|
184
|
+
content.split('\n').forEach((raw, i) => {
|
|
185
|
+
const text = raw.replace(/\r$/, '');
|
|
186
|
+
if (ALWAYS_PASS_CHECK_RE.test(text)) kept.push({ line: i + 1, text: text.trim() });
|
|
187
|
+
});
|
|
188
|
+
return kept.length > 0 ? { ...none, state: 'kept', kept } : none;
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
/**
|
|
192
|
+
* Bring the block `.husky/pre-commit` carries from beta.2 .. beta.12 (`check` without `--ci`) to the current one.
|
|
193
|
+
* Only the block between UDS's two marker lines, and only when it is exactly the old text; the lines around it
|
|
194
|
+
* are the adopter's and stay as they are.
|
|
195
|
+
*
|
|
196
|
+
* @param {string} projectPath
|
|
197
|
+
* @param {{plan?: boolean, manifest?: object|null}} [opts] manifest - read only to see whether the whole file was provably UDS's
|
|
198
|
+
* @returns {{file: '.husky/pre-commit', state: 'none'|'migrated'|'would-migrate'|'error', recorder: object|null, error?: string}}
|
|
199
|
+
*/
|
|
200
|
+
export function migrateHuskyBlockWithoutCi(projectPath, { plan = false, manifest = null } = {}) {
|
|
201
|
+
const file = '.husky/pre-commit';
|
|
202
|
+
const abs = join(projectPath, '.husky', 'pre-commit');
|
|
203
|
+
const none = { file, state: 'none', recorder: null };
|
|
204
|
+
if (!existsSync(abs)) return none;
|
|
205
|
+
|
|
206
|
+
let content;
|
|
207
|
+
try {
|
|
208
|
+
content = readFileSync(abs, 'utf-8');
|
|
209
|
+
} catch (e) {
|
|
210
|
+
return { ...none, state: 'error', error: e.message };
|
|
211
|
+
}
|
|
212
|
+
const eol = content.includes('\r\n') ? '\r\n' : '\n';
|
|
213
|
+
const text = content.replace(/\r\n/g, '\n');
|
|
214
|
+
const oldBlock = buildPreCommitBlock({ ci: false });
|
|
215
|
+
if (!text.includes(oldBlock) || !text.includes(UDS_HOOK_END_MARKER)) return none;
|
|
216
|
+
if (plan) return { ...none, state: 'would-migrate' };
|
|
217
|
+
|
|
218
|
+
const wasProven = !!manifest && !!getFileRecord(manifest, file) && proveUnchanged(manifest, projectPath, file).state === 'proven';
|
|
219
|
+
try {
|
|
220
|
+
const next = text.replace(oldBlock, buildPreCommitBlock());
|
|
221
|
+
writeFileSync(abs, eol === '\r\n' ? next.replace(/\n/g, '\r\n') : next, 'utf-8');
|
|
222
|
+
} catch (e) {
|
|
223
|
+
return { ...none, state: 'error', error: e.message };
|
|
224
|
+
}
|
|
225
|
+
let recorder = null;
|
|
226
|
+
if (wasProven) {
|
|
227
|
+
recorder = newRecorder();
|
|
228
|
+
recordFile(recorder, projectPath, file, RECORD_KINDS.GIT_HOOK);
|
|
229
|
+
}
|
|
230
|
+
return { ...none, state: 'migrated', recorder };
|
|
231
|
+
}
|
|
@@ -130,7 +130,7 @@
|
|
|
130
130
|
* uds open-work revision --file PATH --base GIT_REV
|
|
131
131
|
* uds open-work revision --before FILE --after FILE
|
|
132
132
|
* uds open-work separation <file...> [--next-action-word WORD ...]
|
|
133
|
-
* uds open-work waiting <file...> [--root DIR] [--root NAME=DIR ...] [--id-pattern RE] [--now YYYY-MM-DD]
|
|
133
|
+
* uds open-work waiting <file...> [--root DIR] [--root NAME=DIR ...] [--id-pattern RE] [--now YYYY-MM-DD] [--asked-at-word WORD ...] [--waiting-for-word WORD ...]
|
|
134
134
|
* uds open-work observations <file...> [--now YYYY-MM-DD] [--stale-after DAYS]
|
|
135
135
|
* uds open-work self-test
|
|
136
136
|
* node scripts/check-open-work-tracking.mjs next-action <file...> ... (repo clone)
|
|
@@ -202,6 +202,34 @@ export function normaliseDeclaredWords(raw = []) {
|
|
|
202
202
|
return { words, error: null };
|
|
203
203
|
}
|
|
204
204
|
|
|
205
|
+
/**
|
|
206
|
+
* Field words an adopter declares for the waiting checks (XSPEC-475 R3): the words that head the asked-at column and the
|
|
207
|
+
* "what is it waiting for" column in THIS project's carriers. Same rules as the next-action words: plain text, never a
|
|
208
|
+
* pattern, case-insensitive, and a blank one is refused (an empty alternative would match every header).
|
|
209
|
+
* @param {string[]} raw
|
|
210
|
+
* @param {string} flag - the option name, for the message (for example `--asked-at-word`)
|
|
211
|
+
* @param {string} example - a word to show in the message
|
|
212
|
+
* @returns {{words:string[], error:string|null}}
|
|
213
|
+
*/
|
|
214
|
+
export function normaliseDeclaredFieldWords(raw = [], flag = '--asked-at-word', example = '何時問') {
|
|
215
|
+
const words = [];
|
|
216
|
+
for (const w of raw) {
|
|
217
|
+
const word = typeof w === 'string' ? w.replace(/\s+/g, ' ').trim() : '';
|
|
218
|
+
if (!word) return { words: [], error: `a declared ${flag} is empty or blank; it would match every header, so it is refused (give the exact word, for example ${flag} ${example})` }; // [mutation-anchor:blank-field-word-refused]
|
|
219
|
+
if (!words.some((x) => x.toLowerCase() === word.toLowerCase())) words.push(word);
|
|
220
|
+
}
|
|
221
|
+
return { words, error: null };
|
|
222
|
+
}
|
|
223
|
+
|
|
224
|
+
/** `--asked-at-word` and `--waiting-for-word`, validated: `{ words: { askedAt, awaiting }, error }`. */
|
|
225
|
+
function declaredRoleWords(flagAll) {
|
|
226
|
+
const askedAt = normaliseDeclaredFieldWords(flagAll('--asked-at-word'), '--asked-at-word', '何時問');
|
|
227
|
+
if (askedAt.error) return { words: {}, error: askedAt.error };
|
|
228
|
+
const awaiting = normaliseDeclaredFieldWords(flagAll('--waiting-for-word'), '--waiting-for-word', '問什麼');
|
|
229
|
+
if (awaiting.error) return { words: {}, error: awaiting.error };
|
|
230
|
+
return { words: { askedAt: askedAt.words, awaiting: awaiting.words }, error: null };
|
|
231
|
+
}
|
|
232
|
+
|
|
205
233
|
/**
|
|
206
234
|
* Program names an adopter declares (461 R5), under the same rules as the next-action words: plain text, never a
|
|
207
235
|
* pattern, and a blank one is refused. A command is one program name, so a word with a space in it could never
|
|
@@ -553,9 +581,14 @@ export function checkSeparation(carriers, opts = {}) {
|
|
|
553
581
|
|
|
554
582
|
const stripPunct = (s) => s.replace(/^[("'「『“]+|[)"'」』”.,;:!?、。,;:)]+$/g, '');
|
|
555
583
|
|
|
584
|
+
// A slash command (`/work`, `/sdd`): one leading slash and one word, no extension. It names an action to run, not a file.
|
|
585
|
+
// XSPEC-475 R5(b): it used to be read as the absolute path `/work` and reported path-missing.
|
|
586
|
+
const SLASH_COMMAND = /^\/[A-Za-z][\w-]*$/;
|
|
587
|
+
|
|
556
588
|
function pathLike(tok, inCode) {
|
|
557
589
|
const t = stripPunct(tok).replace(/:\d+(?::\d+)?$/, '');
|
|
558
590
|
if (!t || /\s/.test(t) || /^[a-z][a-z0-9+.-]*:\/\//i.test(t)) return null;
|
|
591
|
+
if (SLASH_COMMAND.test(t)) return null; // [mutation-anchor:slash-command-not-path]
|
|
559
592
|
const segs = t.split('/');
|
|
560
593
|
const last = segs[segs.length - 1];
|
|
561
594
|
const ext = /\.([A-Za-z0-9]+)$/.exec(last);
|
|
@@ -581,7 +614,8 @@ export function classifyNextAction(text, opts = {}) {
|
|
|
581
614
|
const prose = text.replace(/`([^`]+)`/g, (_, c) => {
|
|
582
615
|
const code = c.trim();
|
|
583
616
|
const first = code.split(/\s+/)[0].replace(/^\$\s*/, '');
|
|
584
|
-
if (
|
|
617
|
+
if (/^\/[A-Za-z][\w-]*(?:\s|$)/.test(code)) push('command', code); // a slash command, with or without arguments (XSPEC-475 R5(b))
|
|
618
|
+
else if (pathLike(code, true)) push('path', pathLike(code, true)); // [mutation-anchor:kind-path]
|
|
585
619
|
else if (commands.includes(first) || /^\.{1,2}\//.test(first)) push('command', code); // [mutation-anchor:kind-command]
|
|
586
620
|
else if (/\.(?:test|spec)\.[cm]?[jt]sx?|(?:^|[\s/])test_\w+|::/.test(code)) push('test', code); // [mutation-anchor:kind-test]
|
|
587
621
|
else {
|
|
@@ -596,6 +630,7 @@ export function classifyNextAction(text, opts = {}) {
|
|
|
596
630
|
for (const tok of prose.split(/\s+/)) {
|
|
597
631
|
const p = pathLike(tok, false);
|
|
598
632
|
if (p) push('path', p);
|
|
633
|
+
else if (SLASH_COMMAND.test(stripPunct(tok))) push('command', stripPunct(tok));
|
|
599
634
|
}
|
|
600
635
|
const cmdRe = new RegExp(`(?:^|[^\\w-])(${commands.map(escapeRegExp).join('|')})\\s+([-@\\w./:]+)`, 'g');
|
|
601
636
|
let m;
|
|
@@ -738,7 +773,7 @@ export function checkNextActions(carriers, opts = {}) {
|
|
|
738
773
|
const staleAfter = opts.staleAfterDays ?? DEFAULT_STALE_AFTER_DAYS;
|
|
739
774
|
const res = { walked: 0, empty: 0, counts: { 'named-resolved': 0, 'named-unresolved': 0, unnamed: 0, 'waiting-on-reply': 0 }, unresolvedSplit: { 'path-missing': 0, 'not-resolvable': 0 }, violations: [], detail: [], noFieldCarriers: [], undecidable: [], waitingOnReply: [], staleAfter };
|
|
740
775
|
// No project is declared, so no other project is looked up: this call reads the carriers' own rows and nothing else.
|
|
741
|
-
const rows = checkWaiting(carriers, { now, root: opts.root, idPattern: opts.idPattern, extraCommands: opts.extraCommands, projects: new Map() }).records;
|
|
776
|
+
const rows = checkWaiting(carriers, { now, root: opts.root, idPattern: opts.idPattern, extraCommands: opts.extraCommands, roleWords: opts.roleWords, projects: new Map() }).records;
|
|
742
777
|
for (const c of carriers) {
|
|
743
778
|
const { fields, items, ragged } = extractNextActions(c.content, opts.words);
|
|
744
779
|
for (const g of ragged) res.undecidable.push({ path: c.path, ...g });
|
|
@@ -897,7 +932,28 @@ export const DEFAULT_STALE_AFTER_DAYS = 7;
|
|
|
897
932
|
const BLANK_FIELD = /^(?:|-+|—|–|n\/?a|none|tbd|\?+|無|待定|未知|unknown)$/i;
|
|
898
933
|
const stripMd = (s) => s.replace(/\*\*|__|`/g, '').trim();
|
|
899
934
|
|
|
900
|
-
|
|
935
|
+
/** A regex for words the adopter declared for one role, or null when there are none. Plain text, any case. */
|
|
936
|
+
const plainAlternation = (words) => words.map((w) => escapeRegExp(w)).join('|');
|
|
937
|
+
const declaredRoleRegExp = (words = []) => (words.length ? new RegExp(plainAlternation(words), 'i') : null);
|
|
938
|
+
|
|
939
|
+
/**
|
|
940
|
+
* The roles a header (or label) plays: the built-in vocabulary, plus the words the adopter declared for `askedAt` and
|
|
941
|
+
* `awaiting` (XSPEC-475 R3). `roleWords` is `{ askedAt: string[], awaiting: string[] }`.
|
|
942
|
+
*/
|
|
943
|
+
const rolesOf = (header, roleWords = {}) => {
|
|
944
|
+
const roles = Object.entries(VOCAB_STATE.roles).filter(([, re]) => re.test(header)).map(([role]) => role);
|
|
945
|
+
for (const role of ['askedAt', 'awaiting']) {
|
|
946
|
+
if (!roles.includes(role) && declaredRoleRegExp(roleWords[role])?.test(header)) roles.push(role); // [mutation-anchor:declared-role-word]
|
|
947
|
+
}
|
|
948
|
+
return roles;
|
|
949
|
+
};
|
|
950
|
+
|
|
951
|
+
/** The words that are read as these roles out of the box, for a message that says what is accepted. */
|
|
952
|
+
const ACCEPTED_ROLE_WORDS = {
|
|
953
|
+
askedAt: 'asked-at, asked on, asked date, 詢問時間, 詢問日期, 發問時間, 發問日期, 送出時間, 送出日期, 寄出時間, 寄出日期, 已問時間, 已問日期, 問於',
|
|
954
|
+
awaiting: 'waiting for, waiting on, awaiting, blocked on, 等什麼, 等待對象, 等待什麼, 等待內容, 等誰',
|
|
955
|
+
release: 'release, unblock, 解除, 放行',
|
|
956
|
+
};
|
|
901
957
|
|
|
902
958
|
// inline labels in a list item: "status: not-yet-asked; draft: drafts/q.md"
|
|
903
959
|
const LABEL_WORDS = [
|
|
@@ -917,9 +973,10 @@ const LABEL_WORDS = [
|
|
|
917
973
|
['nextAction', VOCAB.nextAction],
|
|
918
974
|
];
|
|
919
975
|
|
|
920
|
-
function parseRoleLabels(text) {
|
|
976
|
+
function parseRoleLabels(text, roleWords = {}) {
|
|
921
977
|
const hits = [];
|
|
922
|
-
|
|
978
|
+
const declaredLabels = ['askedAt', 'awaiting'].filter((role) => (roleWords[role] || []).length).map((role) => [role, { source: plainAlternation(roleWords[role]) }]);
|
|
979
|
+
for (const [role, word] of [...LABEL_WORDS, ...declaredLabels]) {
|
|
923
980
|
const re = new RegExp(`(?:^|[;;,,|((]\\s*|\\s)(${word.source})[\\w\\s-]{0,12}[::]`, 'gi');
|
|
924
981
|
let m;
|
|
925
982
|
while ((m = re.exec(text)) !== null) {
|
|
@@ -950,7 +1007,7 @@ function parseRoleLabels(text) {
|
|
|
950
1007
|
* `ragged`, never read as empty (same rule as the next-action table).
|
|
951
1008
|
* @returns {{records:object[], ragged:object[]}}
|
|
952
1009
|
*/
|
|
953
|
-
export function extractRecords(md) {
|
|
1010
|
+
export function extractRecords(md, roleWords = {}) {
|
|
954
1011
|
const lines = parseDoc(md);
|
|
955
1012
|
const records = [];
|
|
956
1013
|
const ragged = [];
|
|
@@ -958,7 +1015,7 @@ export function extractRecords(md) {
|
|
|
958
1015
|
for (const t of findTables(lines)) {
|
|
959
1016
|
inTable.add(t.headerIdx); inTable.add(t.headerIdx + 1);
|
|
960
1017
|
t.rows.forEach((r) => inTable.add(r.idx));
|
|
961
|
-
const roles = t.header.map(rolesOf);
|
|
1018
|
+
const roles = t.header.map((h) => rolesOf(h, roleWords));
|
|
962
1019
|
const columns = new Set(roles.flat());
|
|
963
1020
|
if (!columns.size) continue;
|
|
964
1021
|
for (const r of t.rows) {
|
|
@@ -968,16 +1025,16 @@ export function extractRecords(md) {
|
|
|
968
1025
|
const f = {};
|
|
969
1026
|
const fr = {};
|
|
970
1027
|
roles.forEach((rs, n) => rs.forEach((role) => { if (f[role] === undefined) { f[role] = stripMd(r.cells[n]); fr[role] = r.cells[n]; } }));
|
|
971
|
-
records.push({ where, title, f, fr, columns, lineStart: r.idx, lineEnd: r.idx });
|
|
1028
|
+
records.push({ where, title, f, fr, columns, headers: t.header.map(stripMd), lineStart: r.idx, lineEnd: r.idx });
|
|
972
1029
|
}
|
|
973
1030
|
}
|
|
974
1031
|
let cur = null;
|
|
975
1032
|
const flush = () => {
|
|
976
1033
|
if (cur) {
|
|
977
1034
|
const text = cur.parts.join(' ; ');
|
|
978
|
-
const { f, fr, title } = parseRoleLabels(text);
|
|
1035
|
+
const { f, fr, title } = parseRoleLabels(text, roleWords);
|
|
979
1036
|
if (Object.keys(f).length) {
|
|
980
|
-
records.push({ where: `list item (line ${cur.idx + 1}, "${clip(title || stripMd(cur.parts[0]), 40)}")`, title: title || stripMd(cur.parts[0]), f, fr, columns: new Set(Object.keys(f)), lineStart: cur.idx, lineEnd: cur.end });
|
|
1037
|
+
records.push({ where: `list item (line ${cur.idx + 1}, "${clip(title || stripMd(cur.parts[0]), 40)}")`, title: title || stripMd(cur.parts[0]), f, fr, columns: new Set(Object.keys(f)), headers: null, lineStart: cur.idx, lineEnd: cur.end });
|
|
981
1038
|
}
|
|
982
1039
|
}
|
|
983
1040
|
cur = null;
|
|
@@ -1153,6 +1210,25 @@ export function resolveReference(ref, projects, env = REAL_ENV) {
|
|
|
1153
1210
|
return { status: 'needs-a-person', why: `a ${ref.kind === 'id' ? 'requirement or specification identifier' : ref.kind === 'object' ? 'free-form object' : ref.kind} in another project has nothing this check can read` }; // [mutation-anchor:needs-a-person]
|
|
1154
1211
|
}
|
|
1155
1212
|
|
|
1213
|
+
/** The option and uds.project.yaml key that declare a word for each role (XSPEC-475 R3). `release` has none: it is not declarable. */
|
|
1214
|
+
const ROLE_DECLARE = {
|
|
1215
|
+
askedAt: { label: 'asked-at', flag: '--asked-at-word', key: 'open_work.asked_at_words' },
|
|
1216
|
+
awaiting: { label: 'what it waits for', flag: '--waiting-for-word', key: 'open_work.waiting_for_words' },
|
|
1217
|
+
release: { label: 'release', flag: null, key: null },
|
|
1218
|
+
};
|
|
1219
|
+
|
|
1220
|
+
/**
|
|
1221
|
+
* Appended to a violation when the record has NO field read as `role` at all (as opposed to a field that is empty or wrong):
|
|
1222
|
+
* says what was looked for, what the record showed, and how to declare the project's own word. XSPEC-475 R3.
|
|
1223
|
+
*/
|
|
1224
|
+
function fieldNotFound(record, role, roleWords = {}) {
|
|
1225
|
+
const d = ROLE_DECLARE[role];
|
|
1226
|
+
const seen = record.headers ? `headers seen: ${record.headers.map((h) => `"${clip(h, 30)}"`).join(', ')}` : `labels seen: ${[...record.columns].join(', ')}`;
|
|
1227
|
+
const declared = (roleWords[role] || []).length ? `; declared by you: ${roleWords[role].join(', ')}` : '';
|
|
1228
|
+
const how = d.flag ? ` To declare your own word: ${d.flag} <word>, or ${d.key} in uds.project.yaml.` : '';
|
|
1229
|
+
return `. No column or label of this record is read as ${d.label} (${seen}). Accepted: ${ACCEPTED_ROLE_WORDS[role]}${declared}.${how}`;
|
|
1230
|
+
}
|
|
1231
|
+
|
|
1156
1232
|
/**
|
|
1157
1233
|
* OWT-020 / OWT-021 / OWT-022. Reads every record that has a status field (OWT-010: a structural
|
|
1158
1234
|
* field, never prose). `now` is a UTC day (ms); inject it, never read the clock inside a rule.
|
|
@@ -1169,8 +1245,9 @@ export function checkWaiting(carriers, opts = {}) {
|
|
|
1169
1245
|
// list to decide which rows OWT-019 does not apply to, so the two commands cannot disagree about a row (R2 by construction).
|
|
1170
1246
|
records: [],
|
|
1171
1247
|
};
|
|
1248
|
+
const roleWords = opts.roleWords ?? {}; // XSPEC-475 R3: the asked-at / waiting-for words the project declared
|
|
1172
1249
|
for (const c of carriers) {
|
|
1173
|
-
const { records, ragged } = extractRecords(c.content);
|
|
1250
|
+
const { records, ragged } = extractRecords(c.content, roleWords);
|
|
1174
1251
|
for (const g of ragged) if (g.columns.has('status')) res.ragged.push({ path: c.path, ...g });
|
|
1175
1252
|
const withStatus = records.filter((r) => r.f.status !== undefined);
|
|
1176
1253
|
if (!withStatus.length) { res.noStateCarriers.push(c.path); continue; }
|
|
@@ -1209,12 +1286,15 @@ export function checkWaiting(carriers, opts = {}) {
|
|
|
1209
1286
|
}
|
|
1210
1287
|
if (state === 'asked-awaiting') {
|
|
1211
1288
|
const day = parseDay(r.f.askedAt);
|
|
1212
|
-
|
|
1289
|
+
// XSPEC-475 R3: three different faults, three different messages. A field that was not FOUND is a vocabulary problem (the
|
|
1290
|
+
// project may call the column something else, and can declare it); a field that is blank or not a date is a value problem.
|
|
1291
|
+
if (day === null) bad('OWT-022', r.f.askedAt === undefined ? `is asked-awaiting but has no asked-at${fieldNotFound(r, 'askedAt', roleWords)}` : BLANK_FIELD.test(r.f.askedAt) ? 'is asked-awaiting but has no asked-at' : `has an asked-at that is not a date with a year: "${clip(r.f.askedAt, 40)}"`); // [mutation-anchor:asked-at-required]
|
|
1213
1292
|
else if (day > now) bad('OWT-022', `has an asked-at (${dayString(day)}) later than today (${dayString(now)})`);
|
|
1214
1293
|
else { note.push(`asked ${ageDays(now, day)}d ago`); askedDay = day; }
|
|
1215
1294
|
const hasWhat = r.f.awaiting !== undefined && !BLANK_FIELD.test(r.f.awaiting);
|
|
1216
1295
|
const hasRelease = r.f.release !== undefined && !BLANK_FIELD.test(r.f.release);
|
|
1217
|
-
|
|
1296
|
+
const notFound = (!hasWhat && r.f.awaiting === undefined ? fieldNotFound(r, 'awaiting', roleWords) : '') + (!hasRelease && r.f.release === undefined ? fieldNotFound(r, 'release', roleWords) : '');
|
|
1297
|
+
if (!(hasWhat && hasRelease)) bad('OWT-022', `is asked-awaiting but does not state ${!hasWhat && !hasRelease ? 'what it waits for and what event releases it' : !hasWhat ? 'what it waits for' : 'what event releases it'} (OWT-002)${notFound}`); // [mutation-anchor:asked-release-required]
|
|
1218
1298
|
}
|
|
1219
1299
|
res.detail.push({ ...at, state, text: r.title, note: note.join(', ') });
|
|
1220
1300
|
// 464 R1: `asked-awaiting` and nothing OWT-020 or OWT-022 objects to. Both rules are read from what THIS function just raised
|
|
@@ -1338,6 +1418,11 @@ export function selfTestArms() {
|
|
|
1338
1418
|
expect('OWT-022 violating: asked-awaiting does not say what releases it (OWT-002)', ruleOf(waiting('| q | asked-awaiting | | 2026-10-01 | the quote | |\n'), 'OWT-022') === 1);
|
|
1339
1419
|
expect('OWT-022 clean: asked-awaiting with asked-at, what it waits for and its release', ruleOf(waiting('| q | asked-awaiting | | 2026-10-01 | the quote | the reply arrives |\n'), 'OWT-022') === 0);
|
|
1340
1420
|
expect('OWT-020 clean: a done item is not waiting', waiting('| q | done | | | | |\n').violations.length === 0);
|
|
1421
|
+
// XSPEC-475 R3: the words the not-found message lists as accepted are the words the vocabulary reads (one list said twice would drift), and a declared header is read.
|
|
1422
|
+
expect('XSPEC-475 R3 clean: every word the not-found message lists as accepted is read by the vocabulary', Object.entries(ACCEPTED_ROLE_WORDS).every(([role, list]) => list.split(', ').every((w) => VOCAB_STATE.roles[role].test(w))));
|
|
1423
|
+
const declaredTab = '| item | status | 何時問 | 問什麼 | release |\n|---|---|---|---|---|\n| q | asked-awaiting | 2026-10-01 | the quote | the reply arrives |\n';
|
|
1424
|
+
expect('XSPEC-475 R3 violating: a header the vocabulary does not hold is not read as asked-at until it is declared', ruleOf(checkWaiting([{ path: 'd.md', content: declaredTab }], { now: NOW }), 'OWT-022') >= 1);
|
|
1425
|
+
expect('XSPEC-475 R3 clean: the same header, declared, is read as asked-at and as what it waits for', ruleOf(checkWaiting([{ path: 'd.md', content: declaredTab }], { now: NOW, roleWords: { askedAt: ['何時問'], awaiting: ['問什麼'] } }), 'OWT-022') === 0);
|
|
1341
1426
|
|
|
1342
1427
|
const otab = (rows) => `| fact | status | observed-by | observed-at | value |\n|---|---|---|---|---|\n${rows}`;
|
|
1343
1428
|
const obs = (rows, o = {}) => checkObservations([{ path: 'o.md', content: otab(rows) }], { now: NOW, ...o });
|
|
@@ -1520,6 +1605,8 @@ export function main(argv, io = { log: console.log, err: console.error }) {
|
|
|
1520
1605
|
if (declared.error) { say(`[owt] next-action: ${declared.error}`); return finish(2); }
|
|
1521
1606
|
const commandsDeclared = normaliseDeclaredCommands(flagAll('--command-word'));
|
|
1522
1607
|
if (commandsDeclared.error) { say(`[owt] next-action: ${commandsDeclared.error}`); return finish(2); }
|
|
1608
|
+
const roleWords = declaredRoleWords(flagAll);
|
|
1609
|
+
if (roleWords.error) { say(`[owt] next-action: ${roleWords.error}`); return finish(2); }
|
|
1523
1610
|
// 464: today and the stale threshold are injected, as they are for `waiting` and `observations`, never read inside a rule.
|
|
1524
1611
|
const nowArg = flag('--now');
|
|
1525
1612
|
const now = nowArg === undefined ? todayUtc() : parseDay(nowArg);
|
|
@@ -1530,7 +1617,7 @@ export function main(argv, io = { log: console.log, err: console.error }) {
|
|
|
1530
1617
|
const files = args;
|
|
1531
1618
|
if (!files.length) { say('[owt] next-action: no files given'); return finish(2); }
|
|
1532
1619
|
const carriers = files.map(readCarrier);
|
|
1533
|
-
const res = checkNextActions(carriers, { root, idPattern, words: declared.words, extraCommands: commandsDeclared.words, now, staleAfterDays });
|
|
1620
|
+
const res = checkNextActions(carriers, { root, idPattern, words: declared.words, extraCommands: commandsDeclared.words, roleWords: roleWords.words, now, staleAfterDays });
|
|
1534
1621
|
say(`[owt] OWT-019 walked ${res.walked} next-action field(s) in ${files.length} carrier(s); ${res.empty} empty/done field(s) not evaluated; ${res.noFieldCarriers.length} carrier(s) had no next-action field`);
|
|
1535
1622
|
// `waiting-on-reply=N` is appended only when N is not 0, as `waiting-cross-project` is: a carrier with no such row prints what it always printed.
|
|
1536
1623
|
say(`[owt] named-resolved=${res.counts['named-resolved']} named-unresolved=${res.counts['named-unresolved']} unnamed=${res.counts.unnamed} undecidable-table-rows=${res.undecidable.length}${res.counts['waiting-on-reply'] ? ` waiting-on-reply=${res.counts['waiting-on-reply']}` : ''}`);
|
|
@@ -1609,11 +1696,13 @@ export function main(argv, io = { log: console.log, err: console.error }) {
|
|
|
1609
1696
|
const idPattern = cmd === 'waiting' ? flag('--id-pattern') : undefined;
|
|
1610
1697
|
const commandsDeclared = cmd === 'waiting' ? normaliseDeclaredCommands(flagAll('--command-word')) : { words: [], error: null };
|
|
1611
1698
|
if (commandsDeclared.error) { say(`[owt] waiting: ${commandsDeclared.error}`); return finish(2); }
|
|
1699
|
+
const roleWords = cmd === 'waiting' ? declaredRoleWords(flagAll) : { words: {}, error: null };
|
|
1700
|
+
if (roleWords.error) { say(`[owt] waiting: ${roleWords.error}`); return finish(2); }
|
|
1612
1701
|
const files = args;
|
|
1613
1702
|
if (!files.length) { say(`[owt] ${cmd}: no files given`); return finish(2); }
|
|
1614
1703
|
const carriers = files.map(readCarrier);
|
|
1615
1704
|
if (cmd === 'waiting') {
|
|
1616
|
-
const res = checkWaiting(carriers, { now, root, idPattern, projects, extraCommands: commandsDeclared.words });
|
|
1705
|
+
const res = checkWaiting(carriers, { now, root, idPattern, projects, extraCommands: commandsDeclared.words, roleWords: roleWords.words });
|
|
1617
1706
|
say(`[owt] OWT-020/021/022 walked ${res.walked} record(s) with a status field in ${carriers.length} carrier(s) (today ${dayString(now)}); ${res.noStateCarriers.length} carrier(s) had none`);
|
|
1618
1707
|
say(`[owt] not-yet-asked=${res.counts['not-yet-asked']} asked-awaiting=${res.counts['asked-awaiting']} waiting-unspecified=${res.counts['waiting-unspecified']} done=${res.counts.done} other=${res.counts.other}${res.counts['waiting-cross-project'] ? ` waiting-cross-project=${res.counts['waiting-cross-project']}` : ''} undecidable-table-rows=${res.ragged.length}`);
|
|
1619
1708
|
for (const d of res.detail) say(`[owt] ${d.state.padEnd(20)} ${d.path} ${d.where}: ${d.text.slice(0, 60)}${d.note ? ` (${d.note})` : ''}`);
|
package/src/utils/sdd-header.js
CHANGED
|
@@ -12,10 +12,12 @@
|
|
|
12
12
|
*/
|
|
13
13
|
|
|
14
14
|
/** Where a status or type can be read in a header table: `| Status | Approved (2026-01-01) |`. */
|
|
15
|
-
const TABLE_FIELD = (name) => new RegExp(`^\\|\\s*\\**\\s
|
|
15
|
+
const TABLE_FIELD = (name) => new RegExp(`^\\|\\s*\\**\\s*(?:${name})\\s*\\**\\s*\\|\\s*(.+?)\\s*\\|?\\s*$`, 'i');
|
|
16
16
|
/** ...in a field line: `- **Status**: Archived`, `> **Status**: Stable`, `Status: Draft`. */
|
|
17
|
-
const LINE_FIELD = (name) => new RegExp(`^[\\s>*-]*\\**\\s
|
|
17
|
+
const LINE_FIELD = (name) => new RegExp(`^[\\s>*-]*\\**\\s*(?:${name})\\s*\\**\\s*[:\uFF1A]\\s*\\**\\s*(.+?)\\s*$`, 'i');
|
|
18
18
|
const TABLE_SEPARATOR = /^\|[\s:|-]+\|?\s*$/;
|
|
19
|
+
/** Between two fields on one line: a full-width or half-width bar. */
|
|
20
|
+
const FIELD_SEPARATOR = /\s*[\uFF5C|]\s*/;
|
|
19
21
|
|
|
20
22
|
/** First word of a header value, lower-cased (`Approved (2026-01-01)` -> `approved`); text it cannot split stays as written. */
|
|
21
23
|
function headerWord(value) {
|
|
@@ -51,15 +53,25 @@ export function readSddHeader(content) {
|
|
|
51
53
|
const row = TABLE_FIELD(name).exec(lines[i]);
|
|
52
54
|
// A header row of a table (`| Status | Description |`) is followed by a separator row; a field row is not.
|
|
53
55
|
if (row && !TABLE_SEPARATOR.test(lines[i + 1] || '')) return headerWord(row[1]);
|
|
56
|
+
// XSPEC-475 R8: several fields on one line, separated by a full-width `|` or a half-width `|`
|
|
57
|
+
// (`**規格**: SPEC-002 | **狀態**: Draft(驗收中)`). Each piece is read as a field line of its own. A table row
|
|
58
|
+
// (a line that starts with `|`) was handled above and is never split.
|
|
59
|
+
if (!/^\s*\|/.test(lines[i])) {
|
|
60
|
+
for (const piece of lines[i].split(FIELD_SEPARATOR)) {
|
|
61
|
+
const inPiece = LINE_FIELD(name).exec(piece); // [mutation-anchor:same-line-fields]
|
|
62
|
+
if (inPiece) return headerWord(inPiece[1]);
|
|
63
|
+
}
|
|
64
|
+
}
|
|
54
65
|
const field = LINE_FIELD(name).exec(lines[i]);
|
|
55
66
|
if (field) return headerWord(field[1]);
|
|
56
67
|
}
|
|
57
68
|
for (const line of frontMatter) {
|
|
58
|
-
const fm = new RegExp(
|
|
69
|
+
const fm = new RegExp(`^(?:${name})\\s*:\\s*(.+?)\\s*$`, 'i').exec(line);
|
|
59
70
|
if (fm) return headerWord(fm[1]);
|
|
60
71
|
}
|
|
61
72
|
return null;
|
|
62
73
|
};
|
|
63
74
|
|
|
64
|
-
|
|
75
|
+
// // implements XSPEC-475 R5(a): the Chinese field names (`| 狀態 |`, `**狀態**: Draft`) are read like the English ones
|
|
76
|
+
return { title, status: read('Status|狀態'), type: read('Type|類型') };
|
|
65
77
|
}
|
|
@@ -158,7 +158,8 @@ export function getSkillsSourceEntryNames() {
|
|
|
158
158
|
try {
|
|
159
159
|
return new Set(
|
|
160
160
|
readdirSync(SKILLS_LOCAL_DIR, { withFileTypes: true })
|
|
161
|
-
|
|
161
|
+
// Dot folders are settings, not skills (skills/.claude-plugin holds the plugin manifest, 2026-10-21).
|
|
162
|
+
.filter((e) => e.isDirectory() && !e.name.startsWith('.'))
|
|
162
163
|
.map((e) => e.name)
|
|
163
164
|
);
|
|
164
165
|
} catch {
|
package/src/utils/spinner.js
CHANGED
|
@@ -22,10 +22,20 @@ import ora from 'ora';
|
|
|
22
22
|
* @returns {import('ora').Ora}
|
|
23
23
|
*/
|
|
24
24
|
export function createSpinner(options) {
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
25
|
+
const base = typeof options === 'string' ? { text: options } : options;
|
|
26
|
+
return ora({ stream: process.stdout, ...base, ...disabledWhenNoWidth(process.stdout) });
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
/**
|
|
30
|
+
* ora's clear step divides the length of the line by the stream's width to know how many lines to erase. A terminal that
|
|
31
|
+
* reports a width of 0 (a pty opened with no window size, which is what `expect` and some CI runners give a child) makes
|
|
32
|
+
* that Infinity, and the spinner sat in the erase loop at full CPU, so the command never finished (XSPEC-482 R14f).
|
|
33
|
+
* With no usable width there is nothing to animate: the spinner is switched off and prints its plain lines instead.
|
|
34
|
+
* @param {{isTTY?: boolean, columns?: number}} stream
|
|
35
|
+
* @returns {{isEnabled?: boolean}}
|
|
36
|
+
*/
|
|
37
|
+
export function disabledWhenNoWidth(stream) {
|
|
38
|
+
return stream && stream.isTTY && !(stream.columns > 0) ? { isEnabled: false } : {}; // wire:spinner-off-without-width
|
|
29
39
|
}
|
|
30
40
|
|
|
31
41
|
export default createSpinner;
|
|
@@ -4,7 +4,7 @@ import * as yaml from 'js-yaml';
|
|
|
4
4
|
import { exec } from 'child_process';
|
|
5
5
|
import util from 'util';
|
|
6
6
|
import { pathToFileURL } from 'node:url';
|
|
7
|
-
import { readManifest } from './copier.js';
|
|
7
|
+
import { readManifest, getRepoRoot } from './copier.js';
|
|
8
8
|
import { judgeCommitMessage } from './commit-message-judge.js';
|
|
9
9
|
|
|
10
10
|
const execAsync = util.promisify(exec);
|
|
@@ -461,9 +461,10 @@ export class StandardValidator {
|
|
|
461
461
|
const judgeName = simulator.judge
|
|
462
462
|
|| (standardConfig?.standard?.id === 'commit-message' && /commitlint/.test(simulator.command || '') ? 'commit-message' : null);
|
|
463
463
|
if (judgeName === 'commit-message') {
|
|
464
|
-
const outcome = judgeCommitMessage(standardConfig, input, { standardsDir: this.standardsDir });
|
|
464
|
+
const outcome = judgeCommitMessage(standardConfig, input, { standardsDir: this.standardsDir, shippedRoot: getRepoRoot() }); // wire:simulate-shipped-root
|
|
465
465
|
const details = [
|
|
466
466
|
...outcome.findings.map(f => `- ${f}`),
|
|
467
|
+
...outcome.notes.map(n => `Note: ${n}`),
|
|
467
468
|
`Checked: ${outcome.checked.join('; ')}`,
|
|
468
469
|
`Not checked: ${outcome.notChecked.join('; ')}`
|
|
469
470
|
].join('\n');
|
package/standards-registry.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
-
"version": "6.14.0
|
|
3
|
+
"version": "6.14.0",
|
|
4
4
|
"lastUpdated": "2026-05-13",
|
|
5
5
|
"description": "Standards registry for universal-dev-standards with integrated skills and AI-optimized formats",
|
|
6
6
|
"formats": {
|
|
@@ -58,14 +58,14 @@
|
|
|
58
58
|
"standards": {
|
|
59
59
|
"name": "universal-dev-standards",
|
|
60
60
|
"url": "https://github.com/AsiaOstrich/universal-dev-standards",
|
|
61
|
-
"version": "6.14.0
|
|
61
|
+
"version": "6.14.0"
|
|
62
62
|
},
|
|
63
63
|
"skills": {
|
|
64
64
|
"name": "universal-dev-standards",
|
|
65
65
|
"url": "https://github.com/AsiaOstrich/universal-dev-standards",
|
|
66
66
|
"localPath": "skills",
|
|
67
67
|
"rawUrl": "https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/skills",
|
|
68
|
-
"version": "6.14.0
|
|
68
|
+
"version": "6.14.0",
|
|
69
69
|
"note": "Skills are now included in the main repository under skills/"
|
|
70
70
|
}
|
|
71
71
|
},
|
|
@@ -774,6 +774,7 @@
|
|
|
774
774
|
"ai": "ai/standards/turn-completion-integrity.ai.yaml"
|
|
775
775
|
},
|
|
776
776
|
"category": "core",
|
|
777
|
+
"recommended": true,
|
|
777
778
|
"description": "An agent must not end a turn having stated a next action it did not take; enforced at turn end by a Stop hook, with a per-language corpus that runs in CI"
|
|
778
779
|
},
|
|
779
780
|
{
|
|
@@ -2295,6 +2296,7 @@
|
|
|
2295
2296
|
"ai": "ai/standards/pipeline-security-gates.ai.yaml"
|
|
2296
2297
|
},
|
|
2297
2298
|
"category": "core",
|
|
2299
|
+
"recommended": true,
|
|
2298
2300
|
"description": "Security checkpoints embedded in CI pipeline — SAST, DAST, SCA, secrets scan (including the scanner's own output and failure behaviour) with block/warn/log behavior"
|
|
2299
2301
|
},
|
|
2300
2302
|
{
|
|
@@ -2334,7 +2336,7 @@
|
|
|
2334
2336
|
"id": "license-compliance",
|
|
2335
2337
|
"name": "License Compliance Standards",
|
|
2336
2338
|
"nameZh": "授權合規標準",
|
|
2337
|
-
"version": "6.14.0
|
|
2339
|
+
"version": "6.14.0",
|
|
2338
2340
|
"source": {
|
|
2339
2341
|
"human": "core/license-compliance.md",
|
|
2340
2342
|
"ai": "ai/standards/license-compliance.ai.yaml"
|
|
@@ -2346,7 +2348,7 @@
|
|
|
2346
2348
|
"id": "verification-oracle",
|
|
2347
2349
|
"name": "Verification Oracle Standards",
|
|
2348
2350
|
"nameZh": "驗證 Oracle 標準",
|
|
2349
|
-
"version": "6.14.0
|
|
2351
|
+
"version": "6.14.0",
|
|
2350
2352
|
"source": {
|
|
2351
2353
|
"human": "core/verification-oracle.md",
|
|
2352
2354
|
"ai": "ai/standards/verification-oracle.ai.yaml"
|
|
@@ -2358,7 +2360,7 @@
|
|
|
2358
2360
|
"id": "model-provenance",
|
|
2359
2361
|
"name": "Model Provenance Policy Standards",
|
|
2360
2362
|
"nameZh": "模型來源政策標準",
|
|
2361
|
-
"version": "6.14.0
|
|
2363
|
+
"version": "6.14.0",
|
|
2362
2364
|
"source": {
|
|
2363
2365
|
"human": "core/model-provenance.md",
|
|
2364
2366
|
"ai": "ai/standards/model-provenance.ai.yaml"
|
|
@@ -2370,7 +2372,7 @@
|
|
|
2370
2372
|
"id": "resource-cost-boundary",
|
|
2371
2373
|
"name": "Resource / Cost Boundary Declaration Standards",
|
|
2372
2374
|
"nameZh": "資源/成本邊界宣告標準",
|
|
2373
|
-
"version": "6.14.0
|
|
2375
|
+
"version": "6.14.0",
|
|
2374
2376
|
"source": {
|
|
2375
2377
|
"human": "core/resource-cost-boundary.md",
|
|
2376
2378
|
"ai": "ai/standards/resource-cost-boundary.ai.yaml"
|
|
@@ -2464,7 +2466,7 @@
|
|
|
2464
2466
|
"ai": "ai/standards/secret-management-standards.ai.yaml"
|
|
2465
2467
|
},
|
|
2466
2468
|
"category": "core",
|
|
2467
|
-
"description": "Three secret source tiers (Vault, Cloud KMS, SOPS), rotation policies by credential type, hardcoded secret prevention, and safe injection patterns"
|
|
2469
|
+
"description": "Three secret source tiers (Vault, Cloud KMS, SOPS), rotation policies by credential type, hardcoded secret prevention (scanner rules PSG-1 to PSG-3 of pipeline-security-gates), and safe injection patterns"
|
|
2468
2470
|
},
|
|
2469
2471
|
{
|
|
2470
2472
|
"id": "prd-standards",
|