universal-dev-standards 6.14.0-beta.9 → 6.14.1-beta.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bin/uds.js +12 -1
- package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
- package/bundled/ai/standards/commit-message.ai.yaml +12 -2
- package/bundled/ai/standards/mock-boundary.ai.yaml +138 -2
- package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
- package/bundled/ai/standards/turn-completion-integrity.ai.yaml +6 -2
- package/bundled/core/commit-message-guide.md +22 -19
- package/bundled/core/mock-boundary.md +70 -2
- package/bundled/core/secret-management-standards.md +13 -1
- package/bundled/core/turn-completion-integrity.md +8 -2
- package/bundled/extensions/locales/zh-tw.md +19 -19
- package/bundled/hooks/check-dangerous-cmd.mjs +161 -26
- package/bundled/hooks/check-logging-standard.mjs +35 -6
- package/bundled/hooks/validate-commit-msg.mjs +317 -28
- package/bundled/locales/zh-CN/CHANGELOG.md +2323 -1099
- package/bundled/locales/zh-CN/CLAUDE.md +987 -101
- package/bundled/locales/zh-CN/README.md +3 -3
- package/bundled/locales/zh-CN/SECURITY.md +4 -3
- package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
- package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
- package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
- package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
- package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
- package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
- package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
- package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
- package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
- package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
- package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
- package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
- package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
- package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
- package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
- package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
- package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
- package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
- package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
- package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
- package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
- package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
- package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
- package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
- package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
- package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
- package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
- package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
- package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
- package/bundled/locales/zh-CN/core/database-standards.md +115 -114
- package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
- package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
- package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
- package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
- package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
- package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
- package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
- package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
- package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
- package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
- package/bundled/locales/zh-CN/core/execution-history.md +2 -1
- package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
- package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
- package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
- package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
- package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
- package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
- package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
- package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
- package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
- package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
- package/bundled/locales/zh-CN/core/mock-boundary.md +74 -6
- package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
- package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
- package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
- package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
- package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
- package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
- package/bundled/locales/zh-CN/core/project-structure.md +550 -170
- package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
- package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
- package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
- package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
- package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
- package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
- package/bundled/locales/zh-CN/core/security-decision.md +45 -70
- package/bundled/locales/zh-CN/core/security-standards.md +169 -16
- package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
- package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
- package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
- package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
- package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
- package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
- package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
- package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
- package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
- package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
- package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
- package/bundled/locales/zh-CN/core/test-governance.md +94 -43
- package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
- package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-CN/core/token-budget.md +44 -80
- package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
- package/bundled/locales/zh-CN/core/turn-completion-integrity.md +8 -6
- package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
- package/bundled/locales/zh-CN/core/versioning.md +737 -73
- package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
- package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
- package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
- package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
- package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
- package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
- package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
- package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-CN/docs/user/README.md +4 -2
- package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
- package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
- package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
- package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
- package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
- package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
- package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
- package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
- package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
- package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
- package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
- package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
- package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
- package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
- package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
- package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
- package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
- package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
- package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
- package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
- package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
- package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/skills/README.md +2 -1
- package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
- package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
- package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
- package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
- package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
- package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
- package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
- package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
- package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
- package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
- package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
- package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
- package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
- package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
- package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
- package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
- package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
- package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
- package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
- package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
- package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
- package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
- package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
- package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
- package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
- package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
- package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
- package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
- package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
- package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
- package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
- package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
- package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
- package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
- package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
- package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
- package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
- package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
- package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
- package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
- package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
- package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
- package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
- package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
- package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
- package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
- package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
- package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
- package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
- package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
- package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
- package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
- package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
- package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
- package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
- package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
- package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
- package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
- package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
- package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
- package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
- package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
- package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
- package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
- package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
- package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
- package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
- package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
- package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
- package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
- package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
- package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
- package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
- package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
- package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
- package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
- package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
- package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
- package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
- package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
- package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
- package/bundled/locales/zh-TW/CHANGELOG.md +2323 -1128
- package/bundled/locales/zh-TW/CLAUDE.md +962 -76
- package/bundled/locales/zh-TW/README.md +3 -3
- package/bundled/locales/zh-TW/SECURITY.md +4 -3
- package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
- package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
- package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
- package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
- package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
- package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
- package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
- package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
- package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
- package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
- package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
- package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
- package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
- package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
- package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
- package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
- package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
- package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
- package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
- package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
- package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
- package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
- package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
- package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
- package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
- package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
- package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
- package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
- package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
- package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
- package/bundled/locales/zh-TW/core/database-standards.md +2 -1
- package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
- package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
- package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
- package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
- package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
- package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
- package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
- package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
- package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
- package/bundled/locales/zh-TW/core/execution-history.md +2 -1
- package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
- package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
- package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
- package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
- package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
- package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
- package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
- package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
- package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
- package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
- package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
- package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
- package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
- package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
- package/bundled/locales/zh-TW/core/mock-boundary.md +74 -6
- package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
- package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
- package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
- package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
- package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
- package/bundled/locales/zh-TW/core/project-structure.md +240 -19
- package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
- package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
- package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
- package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
- package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
- package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
- package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
- package/bundled/locales/zh-TW/core/security-decision.md +43 -84
- package/bundled/locales/zh-TW/core/security-standards.md +204 -25
- package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
- package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
- package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
- package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
- package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
- package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
- package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
- package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
- package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
- package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
- package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
- package/bundled/locales/zh-TW/core/test-governance.md +92 -32
- package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
- package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-TW/core/token-budget.md +41 -112
- package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
- package/bundled/locales/zh-TW/core/turn-completion-integrity.md +8 -6
- package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
- package/bundled/locales/zh-TW/core/versioning.md +6 -2
- package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
- package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
- package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
- package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
- package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
- package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
- package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
- package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
- package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-TW/docs/user/README.md +2 -0
- package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
- package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
- package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
- package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
- package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
- package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
- package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
- package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
- package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
- package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
- package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
- package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
- package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
- package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
- package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
- package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
- package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
- package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
- package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
- package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
- package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
- package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
- package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/skills/README.md +2 -1
- package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
- package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
- package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
- package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
- package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
- package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
- package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
- package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
- package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
- package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
- package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
- package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
- package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
- package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
- package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
- package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
- package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
- package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
- package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
- package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
- package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
- package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
- package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
- package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
- package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
- package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
- package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
- package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
- package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
- package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
- package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
- package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
- package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
- package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
- package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
- package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
- package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
- package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
- package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
- package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
- package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
- package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
- package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
- package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
- package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
- package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
- package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
- package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
- package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
- package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
- package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
- package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
- package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
- package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
- package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
- package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
- package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
- package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
- package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
- package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
- package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
- package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
- package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
- package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
- package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
- package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
- package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
- package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
- package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
- package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
- package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
- package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
- package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
- package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
- package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
- package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
- package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
- package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
- package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
- package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
- package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
- package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
- package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
- package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
- package/bundled/skills/.claude-plugin/plugin.json +71 -0
- package/bundled/skills/commit-standards/SKILL.md +2 -2
- package/bundled/skills/commit-standards/guide.md +3 -2
- package/bundled/skills/commit-standards/language-options.md +19 -17
- package/package.json +2 -2
- package/src/commands/audit.js +28 -1
- package/src/commands/check.js +72 -3
- package/src/commands/compile.js +37 -4
- package/src/commands/config.js +49 -24
- package/src/commands/init.js +78 -30
- package/src/commands/open-work.js +6 -2
- package/src/commands/release-messages.js +228 -0
- package/src/commands/release.js +127 -68
- package/src/commands/run-intent.js +11 -0
- package/src/commands/spec.js +4 -2
- package/src/commands/update.js +227 -47
- package/src/compilers/claude-code-compiler.js +9 -1
- package/src/config/ai-agent-paths.js +14 -1
- package/src/core/installed-formats.js +15 -0
- package/src/core/open-work-config.js +20 -1
- package/src/core/project-config.js +55 -0
- package/src/i18n/messages.js +106 -2
- package/src/installers/hooks-installer.js +1 -1
- package/src/installers/manifest-installer.js +1 -1
- package/src/installers/skills-installer.js +1 -1
- package/src/installers/standards-installer.js +3 -1
- package/src/mcp/server.js +9 -3
- package/src/prompts/init.js +26 -22
- package/src/reconciler/actual-state-scanner.js +2 -8
- package/src/reconciler/backup-locations.js +5 -0
- package/src/reconciler/backup-manager.js +19 -11
- package/src/reconciler/desired-state-calculator.js +89 -57
- package/src/reconciler/plan-executor.js +101 -8
- package/src/reconciler/recorded-versions.js +49 -0
- package/src/reconciler/relative-path.js +23 -0
- package/src/uninstallers/hook-uninstaller.js +9 -1
- package/src/uninstallers/skills-uninstaller.js +22 -3
- package/src/utils/available-standards-report.js +25 -4
- package/src/utils/available-standards.js +13 -3
- package/src/utils/build-manifest.js +1 -1
- package/src/utils/commit-message-judge.js +60 -13
- package/src/utils/friction-detector.js +23 -11
- package/src/utils/git-hooks.js +106 -4
- package/src/utils/integration-generator.js +95 -67
- package/src/utils/legacy-hook-migration.js +121 -2
- package/src/utils/open-work-tracking.mjs +105 -16
- package/src/utils/sdd-header.js +16 -4
- package/src/utils/skills-installer.js +2 -1
- package/src/utils/spinner.js +14 -4
- package/src/utils/standard-validator.js +3 -2
- package/standards-registry.json +10 -8
- package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Mock Boundary Standards
|
|
2
2
|
|
|
3
|
-
**Version**: 1.
|
|
4
|
-
**Last Updated**: 2026-
|
|
3
|
+
**Version**: 1.3.0
|
|
4
|
+
**Last Updated**: 2026-10-28
|
|
5
5
|
**Applicability**: All software projects with unit and integration tests
|
|
6
6
|
**Scope**: universal
|
|
7
7
|
**Industry Standards**: ISTQB Foundation (Test Doubles), xUnit Patterns (Gerard Meszaros)
|
|
@@ -101,6 +101,67 @@ The test injects `DeterministicDispatcher`, exercises the code under test, then
|
|
|
101
101
|
|
|
102
102
|
---
|
|
103
103
|
|
|
104
|
+
## Blocking Hooks: Test the Host's Entry, Not the Matcher
|
|
105
|
+
|
|
106
|
+
A **hook** is a script an AI host (Claude Code, Codex, Gemini CLI, Antigravity CLI, and others) runs at a lifecycle event. Some hooks can **stop** what the host was about to do: refuse a tool call, reject a prompt, keep a turn from ending. For these the hollow-test problem needs no mock at all. The test simply never touches the entry the host calls.
|
|
107
|
+
|
|
108
|
+
A hook has two layers. The **judgement** decides whether this command is dangerous. The **wiring** reads the host's stdin payload and answers in the signal the host reads (an exit code, or JSON on stdout). A unit test that imports the judgement function exercises the first layer only, and the host reads the second. A wrong exit code, a payload field read under the wrong name, or output in a shape the host ignores all leave that test green.
|
|
109
|
+
|
|
110
|
+
### Counter-example: UDS's own dangerous-command hook blocked 0 of 26
|
|
111
|
+
|
|
112
|
+
`scripts/hooks/check-dangerous-cmd.mjs` is a PreToolUse hook. When it detected a dangerous command it exited **1**. Claude Code blocks a tool call only on exit **2**; any other non-zero code is a non-blocking hook error and the command runs anyway. Its tests imported the matcher function (`isDangerousCommand()`) and called it directly, so they were green for months.
|
|
113
|
+
|
|
114
|
+
Replaying 11,617 real shell calls (2026-10-27) the rule `rm -rf /` fired 26 times. The host blocked **0** of them. 25 of the 26 were harmless temp cleanups such as `rm -rf /tmp/x`; none was a real attempt to wipe the root. The same pattern missed `rm -fr /` and `rm -r -f /`. The fix and its entry tests shipped in PR #281.
|
|
115
|
+
|
|
116
|
+
### Rules
|
|
117
|
+
|
|
118
|
+
**H1 (MUST).** A hook that can stop a tool call, a prompt or a turn MUST have at least one test that does all three:
|
|
119
|
+
|
|
120
|
+
1. **Runs the hook as a separate process**, with the same command the host's config runs. Spawning the script counts; importing it does not.
|
|
121
|
+
2. **Sends the host's own payload on stdin**, with the field names that host uses (see the table below: Claude Code sends `tool_name` / `tool_input`, Antigravity sends `toolCall`). A payload shaped like the author's idea of the host proves nothing.
|
|
122
|
+
3. **Asserts the signal the host reads**: the exact exit code, or the JSON the host parses on stdout. "Non-zero", "exited with an error" and "stderr contained the word" do not count: exit 1 is non-zero and blocks nothing on Claude Code.
|
|
123
|
+
|
|
124
|
+
A test that imports and calls an internal function MAY exist and is useful for the judgement, but it does not count toward H1.
|
|
125
|
+
|
|
126
|
+
**H2 (SHOULD).** Pair the blocking case with an allowing case run the same way, and assert the host's allow signal (for example exit 0 with nothing on stdout). A hook that blocks everything passes a blocking-only test.
|
|
127
|
+
|
|
128
|
+
**H3 (SHOULD).** Cut check: change the hook's block signal (for example `exit 2` to `exit 1`) and confirm the entry test goes red. A test that stays green has not been guarding the wiring.
|
|
129
|
+
|
|
130
|
+
H1 also applies to a hook whose only effect is that the host reads its signal, such as a PostToolUse hook that uses exit 2 to put its stderr in front of the model. The tool has already run, so it cannot be undone, but a wrong code silences the hook just the same.
|
|
131
|
+
|
|
132
|
+
### What each host reads as "blocked"
|
|
133
|
+
|
|
134
|
+
Retrieved 2026-10-28 from each host's own documentation. Hosts change these contracts; re-check the source before relying on a cell, and when a cell says "not found" the page was read and says nothing, which is not the same as "no".
|
|
135
|
+
|
|
136
|
+
| Host | Event | Blocks | Does not block | Source |
|
|
137
|
+
|---|---|---|---|---|
|
|
138
|
+
| Claude Code | PreToolUse | exit **2** (stderr is the reason); or exit 0 with stdout `{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"..."}}` | any other exit code, **including 1**, is a non-blocking hook error and the action proceeds; invalid JSON likewise. Exception stated by the docs: a hook configured with `onFailure: "block"` blocks when it fails | code.claude.com/docs/en/hooks: Exit code output, Exit code 2, Other exit codes, Decision control |
|
|
139
|
+
| Claude Code | UserPromptSubmit | exit **2** (the prompt never reaches the model); or exit 0 with stdout `{"decision":"block","reason":"..."}` | any other exit code (same `onFailure: "block"` exception) | same page, Exit code 2 behavior per event |
|
|
140
|
+
| Claude Code | PostToolUse | cannot block: the tool already ran. Exit 2 only shows stderr to the model | any exit code, for blocking purposes | same page, Exit code 2 behavior per event |
|
|
141
|
+
| Codex | PreToolUse | exit **2** with the reason on stderr; or stdout `{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"..."}}`; the older `{"decision":"block","reason":"..."}` is also accepted | plain text on stdout is ignored; `permissionDecision:"ask"`, `continue:false`, `stopReason`, `suppressOutput` are not supported and the hook run is marked failed while the tool call continues; other non-zero exit codes: not found | developers.openai.com/codex/hooks, PreToolUse |
|
|
142
|
+
| Codex | UserPromptSubmit | exit **2** with the reason on stderr; or stdout `{"decision":"block","reason":"..."}` | plain text on stdout is added as context; other non-zero exit codes: not found | same page, UserPromptSubmit |
|
|
143
|
+
| Codex | PermissionRequest | stdout `{"hookSpecificOutput":{"decision":{"behavior":"deny","message":"..."}}}`; any `deny` wins | exit 2 for this event: not found; plain text on stdout is ignored | same page, PermissionRequest |
|
|
144
|
+
| Gemini CLI (legacy) | BeforeTool | exit **2** (stderr is the reason sent to the agent); or exit 0 with stdout `{"decision":"deny","reason":"..."}` (`"block"` is an alias). The docs name the JSON form the preferred path | any other exit code is a warning and the CLI continues | geminicli.com/docs/hooks/reference, Global hook mechanics and BeforeTool |
|
|
145
|
+
| Gemini CLI (legacy) | BeforeAgent, BeforeModel | exit **2** aborts the turn (BeforeAgent also erases the prompt from context; BeforeModel skips the LLM call); or `decision:"deny"` | as above | same page |
|
|
146
|
+
| Antigravity CLI (`agy`) | PreToolUse | exit 0 with stdout `{"decision":"deny","reason":"..."}` ("Hard blocks execution immediately"). The `decision` field is required; its other values are `allow`, `auto_approve`, `ask`, `force_ask`, `deny_unless_prior_grant`. stdin carries `toolCall.name` and `toolCall.args`, not Claude Code's names | exit-code semantics: not found (the official page is silent). Do not assume Claude Code's exit 2 applies. A third-party guide claims any non-zero code denies; it is not official and is not used here | antigravity.google/docs/hooks, Input and output contract, PreToolUse |
|
|
147
|
+
| Cursor and other hosts | any | not found (not surveyed in this revision) | not found | none |
|
|
148
|
+
|
|
149
|
+
Stop-type events (Claude Code and Codex Stop, Gemini CLI AfterAgent, Antigravity Stop) are **not repeated here**. Their block contracts are in the "Supported harnesses" table of [turn-completion-integrity](turn-completion-integrity.md), the single place they are written down. That table also records one case where a failed Antigravity hook was let through silently, which is the same wiring failure this section is about.
|
|
150
|
+
|
|
151
|
+
### A replay validates the wiring, not the rules
|
|
152
|
+
|
|
153
|
+
Replaying recorded real calls through a hook (for example with rules-to-guards) is a strong way to check the wiring. It has a limit that must be stated whenever its result is reported. If the same rule list decides both "this should be blocked" and "this should not", the replay proves the hook behaves as its rules say. It does not prove the rules are right.
|
|
154
|
+
|
|
155
|
+
The 0-of-26 measurement could be made because the host's contract (exit 2 blocks) is a fact outside the hook. For "which commands deserve blocking" there was only the hook's own pattern: all 26 hits were consistent with it, 0 were real dangers, and `rm -fr /`, which the pattern did not cover, could never show up as a miss because the oracle shares the blind spot.
|
|
156
|
+
|
|
157
|
+
So report a replay as "wiring is correct" or "wiring is wrong". Do not report "the rules are correct" from it. To say anything about the rules, read the commands that actually matched, or keep a separate answer key (see [verification-oracle](verification-oracle.md)) written without looking at the hook's patterns.
|
|
158
|
+
|
|
159
|
+
### Enforcement in UDS
|
|
160
|
+
|
|
161
|
+
UDS checks this rule against its own shipped hooks in CI: `node scripts/check-hook-entry-tests.mjs` (npm run `check:hook-entry-tests`) fails when a hook UDS ships that can block has no test that spawns it, feeds stdin and asserts the host's signal. It is static text analysis: it shows that a test of the right shape exists, not that the test would go red if the hook regressed. That is what H3 is for.
|
|
162
|
+
|
|
163
|
+
---
|
|
164
|
+
|
|
104
165
|
## Hollow Test Detection
|
|
105
166
|
|
|
106
167
|
Before submitting a test file, check:
|
|
@@ -109,6 +170,7 @@ Before submitting a test file, check:
|
|
|
109
170
|
2. **All assertions are `.toHaveBeenCalled()` variants** → Add output-value assertions
|
|
110
171
|
3. **Mock path matches test subject directory** → Self-referential mock; remove it
|
|
111
172
|
4. **More mock setup lines than assertion lines** → Likely hollow
|
|
173
|
+
5. **A blocking hook whose tests only import and call its functions** → Add an entry test that spawns it and asserts the host's signal (see Blocking Hooks)
|
|
112
174
|
|
|
113
175
|
---
|
|
114
176
|
|
|
@@ -119,6 +181,7 @@ Before submitting a test file, check:
|
|
|
119
181
|
- **Orphan Mock**: Cross-module mock with no integration test counterpart
|
|
120
182
|
- **Security Bypass Mock**: Auth/permission logic replaced with pass-through stub
|
|
121
183
|
- **Database Mock Cascade**: DB returns hardcoded data, hiding real query errors
|
|
184
|
+
- **Matcher-Only Hook Test**: A blocking hook whose tests import and call its judgement function and never run the hook as the host does. Green while the hook blocks nothing (UDS's own 0-of-26)
|
|
122
185
|
- **Poll/Sleep for Background Result**: Sleeping or polling to wait for fire-and-forget work to finish. The race is still there — the timeout merely hides it most of the time while slowing the whole suite and, on a shared runner, leaking flakiness into other MRs' CI. Inject a deterministic runner and await the tracked task instead.
|
|
123
186
|
|
|
124
187
|
---
|
|
@@ -133,6 +196,8 @@ Before submitting a test file, check:
|
|
|
133
196
|
| No security mock | Test involves auth/permissions | Use real test user + real token |
|
|
134
197
|
| Hollow review | Mock count ≥ import count | Add output-value assertion |
|
|
135
198
|
| No poll/sleep for background work | Test asserts a fire-and-forget side effect | Inject deterministic runner; await the tracked task |
|
|
199
|
+
| Host entry test for blocking hooks | Hook can stop a tool call, prompt or turn | Spawn it, send the host's payload on stdin, assert the exit code or stdout JSON the host reads |
|
|
200
|
+
| Replay proves wiring only | Reporting a replay of real calls through a hook | Report "wiring correct"; do not report "rules correct" unless the rules were checked against an independent answer |
|
|
136
201
|
|
|
137
202
|
---
|
|
138
203
|
|
|
@@ -141,6 +206,8 @@ Before submitting a test file, check:
|
|
|
141
206
|
- **testing**: Mock boundary rules apply to all test levels in the testing pyramid
|
|
142
207
|
- **test-completeness-dimensions**: Dimension 8 (AI Test Quality) references these rules
|
|
143
208
|
- **flow-based-testing**: Flow tests must follow mock boundary rules
|
|
209
|
+
- **turn-completion-integrity**: Holds the block contracts for Stop-type events; this standard holds them for tool and prompt events, and neither repeats the other
|
|
210
|
+
- **verification-oracle**: An answer key for judging whether a hook's rules are right must not be derived from the hook's own patterns
|
|
144
211
|
|
|
145
212
|
---
|
|
146
213
|
|
|
@@ -150,3 +217,4 @@ Before submitting a test file, check:
|
|
|
150
217
|
|---------|------|--------|
|
|
151
218
|
| 1.0.0 | 2026-05-04 | Initial standard: hollow test problem, CAN/CANNOT mock tables, detection, anti-patterns, rules summary |
|
|
152
219
|
| 1.1.0 | 2026-07-01 | Added injectable background execution as a seam (parallel to clock injection): CAN-mock row, `Injectable Background Execution` section, `Poll/Sleep for Background Result` anti-pattern, and no-poll/sleep rule (issue #143) |
|
|
220
|
+
| 1.3.0 | 2026-10-28 | Added `Blocking Hooks: Test the Host's Entry, Not the Matcher`: H1 MUST (spawn the hook, send the host's stdin payload, assert the signal the host reads), H2/H3 SHOULD, the per-host block-signal table, and the replay-validates-wiring-not-rules note, with UDS's own 0-of-26 as the counter-example. Number re-aligned with `mock-boundary.ai.yaml`, which had used 1.2.0 for the background-execution addition recorded here as 1.1.0 |
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Secret Management and Credential Hygiene Standards
|
|
2
2
|
|
|
3
|
-
> **Version**: 1.
|
|
3
|
+
> **Version**: 1.1.0 | **Status**: Active | **Updated**: 2026-10-12
|
|
4
4
|
> **AI-optimized version**: `ai/standards/secret-management-standards.ai.yaml`
|
|
5
5
|
> **Spec**: XSPEC-065 (cross-project/specs/XSPEC-065-uds-infrastructure-pack.md)
|
|
6
6
|
|
|
@@ -69,6 +69,14 @@ detected patterns: AWS access key format (`AKIA[0-9A-Z]{16}`), PEM private key
|
|
|
69
69
|
headers (`-----BEGIN .* PRIVATE KEY`), generic API token patterns
|
|
70
70
|
(`api[_-]?key\s*[:=]\s*\S{16,}`), and connection strings containing passwords.
|
|
71
71
|
|
|
72
|
+
How the scanners are run is governed by [`pipeline-security-gates`](./pipeline-security-gates.md), and the
|
|
73
|
+
three rules there apply to every scanner this requirement asks for: **PSG-1** — the scan output (terminal, CI log,
|
|
74
|
+
report file) MUST NOT contain the matched secret value, only the file, the line and the rule name; **PSG-2** — a
|
|
75
|
+
scanner that cannot run (not installed, crashed, no network for its rules) counts as a failed gate and MUST block the
|
|
76
|
+
commit or the pipeline, never let it through; **PSG-3** — every detection rule the team writes itself SHOULD have one
|
|
77
|
+
sample that must be caught (red) and one that must not be reported (green), executed in a test. The four minimum
|
|
78
|
+
patterns above are the rules PSG-3 applies to when a team writes its own.
|
|
79
|
+
|
|
72
80
|
### REQ-004 — Secret Injection
|
|
73
81
|
|
|
74
82
|
Secrets MUST be injected into application processes via environment variables or
|
|
@@ -91,6 +99,9 @@ secrets as read-only volumes with restrictive file permissions (0400 or 0600).
|
|
|
91
99
|
|
|
92
100
|
- **`iac-design-principles`** — secret backends (Vault/KMS state) are themselves
|
|
93
101
|
versioned, access-controlled infrastructure.
|
|
102
|
+
- **`pipeline-security-gates`** — PSG-1 to PSG-3 govern how the scanners of REQ-003 are run (no secret value in
|
|
103
|
+
their output, a scanner that cannot run blocks, red and green samples for self-written rules); the two standards
|
|
104
|
+
point at each other.
|
|
94
105
|
- **`audit-trail`** — rotation, access, and injection events are auditable
|
|
95
106
|
operations (REQ-002 mandates logging rotation events).
|
|
96
107
|
- **`pii-classification`** — credentials guarding TIER-1 PII inherit the strictest
|
|
@@ -107,4 +118,5 @@ secrets as read-only volumes with restrictive file permissions (0400 or 0600).
|
|
|
107
118
|
|
|
108
119
|
| Version | Date | Changes |
|
|
109
120
|
|---------|------|---------|
|
|
121
|
+
| v1.1.0 | 2026-10-12 | REQ-003 points to `pipeline-security-gates` PSG-1 to PSG-3 for how the scanners are run; integration section lists the cross-reference (XSPEC-475 OQ3) |
|
|
110
122
|
| v1.0.0 | 2026-06-17 | Initial — REQ-001~004: secret source options, rotation policy, hardcoded-secret prevention, secret injection (XSPEC-065) |
|
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
> **Language**: English | [繁體中文](../locales/zh-TW/core/turn-completion-integrity.md)
|
|
4
4
|
|
|
5
|
-
**Version**: 1.5.
|
|
6
|
-
**Last Updated**: 2026-
|
|
5
|
+
**Version**: 1.5.1
|
|
6
|
+
**Last Updated**: 2026-10-28
|
|
7
7
|
**Applicability**: Any harness where an agent ends a turn and hands control back to a human
|
|
8
8
|
**Scope**: universal
|
|
9
9
|
**Industry Standards**: none claimed — derived from observed failures, see Evidence
|
|
@@ -158,6 +158,12 @@ actually wired into that harness's own config. As of v1.5.0:
|
|
|
158
158
|
| Gemini CLI (legacy) | AfterAgent | `.gemini/settings.json` | stdout `{"decision":"deny","reason":...}`, exit 0 — the documented preferred path over exit code 2 |
|
|
159
159
|
| Antigravity CLI (`agy`) | Stop | `.agents/hooks.json` | stdout `{"decision":"continue","reason":...}`, exit 0; `{}` allows |
|
|
160
160
|
|
|
161
|
+
This table covers Stop-type events only. The signals a host reads for events that
|
|
162
|
+
stop a tool call or a prompt (PreToolUse, UserPromptSubmit, BeforeTool) are in the
|
|
163
|
+
"What each host reads as 'blocked'" table of [mock-boundary](mock-boundary.md), the
|
|
164
|
+
one place they are written down, together with the rule that a blocking hook must be
|
|
165
|
+
tested by running it as the host does. They are not repeated here.
|
|
166
|
+
|
|
161
167
|
Wired is not running on Codex. Codex skips a project hook until the project
|
|
162
168
|
is trusted **and** that exact hook definition has been trusted through `/hooks`
|
|
163
169
|
in an interactive Codex session; trust is recorded against the definition's
|
|
@@ -348,29 +348,29 @@ public class UserService
|
|
|
348
348
|
|
|
349
349
|
### Commit Types in Traditional Chinese | 繁體中文 Commit 類型
|
|
350
350
|
|
|
351
|
-
Use Traditional Chinese
|
|
352
|
-
|
|
353
|
-
|
|
|
354
|
-
|
|
355
|
-
|
|
|
356
|
-
|
|
|
357
|
-
|
|
|
358
|
-
|
|
|
359
|
-
|
|
|
360
|
-
|
|
|
361
|
-
|
|
|
362
|
-
|
|
|
363
|
-
|
|
|
364
|
-
|
|
|
365
|
-
|
|
|
366
|
-
|
|
|
351
|
+
Use the **English type** with a **Traditional Chinese subject and body** for Taiwan-based teams (XSPEC-475). A Chinese type such as `新增` is not allowed, because commitlint's `type-enum` and `uds simulate` read English types:
|
|
352
|
+
|
|
353
|
+
| 英文類型 | 說明 | 範例 |
|
|
354
|
+
|---------|------|------|
|
|
355
|
+
| `feat` | 新功能 | `feat(auth): 加入 OAuth2 登入` |
|
|
356
|
+
| `fix` | Bug 修復 | `fix(api): 處理空值回應` |
|
|
357
|
+
| `refactor` | 程式碼重構 | `refactor(core): 簡化驗證邏輯` |
|
|
358
|
+
| `docs` | 文件更新 | `docs(readme): 更新安裝指南` |
|
|
359
|
+
| `test` | 測試相關 | `test(auth): 新增登入單元測試` |
|
|
360
|
+
| `style` | 程式碼格式 | `style(lint): 修正縮排` |
|
|
361
|
+
| `perf` | 效能優化 | `perf(query): 最佳化資料庫查詢` |
|
|
362
|
+
| `build` | 建置系統 | `build(deps): 升級 lodash` |
|
|
363
|
+
| `ci` | CI/CD 變更 | `ci(github): 新增覆蓋率工作流程` |
|
|
364
|
+
| `chore` | 維護任務 | `chore(deps): 更新開發相依套件` |
|
|
365
|
+
| `revert` | 回退提交 | `revert: feat(auth): 加入 OAuth2 登入` |
|
|
366
|
+
| `security` | 安全漏洞修復 | `security(auth): 修正 XSS 漏洞` |
|
|
367
367
|
|
|
368
368
|
---
|
|
369
369
|
|
|
370
370
|
### Commit Message Examples | Commit 訊息範例
|
|
371
371
|
|
|
372
372
|
```
|
|
373
|
-
|
|
373
|
+
feat(auth): 實作 OAuth2 Google 登入功能
|
|
374
374
|
|
|
375
375
|
- 新增 GoogleAuthService 處理 Google OAuth2 流程
|
|
376
376
|
- 整合 JWT token 產生邏輯
|
|
@@ -385,7 +385,7 @@ Closes #123
|
|
|
385
385
|
```
|
|
386
386
|
|
|
387
387
|
```
|
|
388
|
-
|
|
388
|
+
fix(api): 解決並發更新使用者資料時的競爭條件
|
|
389
389
|
|
|
390
390
|
問題原因:
|
|
391
391
|
- 兩個同時發出的 PUT /users/:id 請求會互相覆蓋
|
|
@@ -406,7 +406,7 @@ Fixes #456
|
|
|
406
406
|
```
|
|
407
407
|
|
|
408
408
|
```
|
|
409
|
-
|
|
409
|
+
refactor(database): 提取連線池管理為獨立模組
|
|
410
410
|
|
|
411
411
|
重構原因:
|
|
412
412
|
- 連線池邏輯散落在多個 Repository 中
|
|
@@ -2,10 +2,20 @@
|
|
|
2
2
|
/**
|
|
3
3
|
* UDS Hook: Dangerous Command Detection
|
|
4
4
|
*
|
|
5
|
-
* Detects
|
|
6
|
-
* Exit code: 0 = safe, 1 = dangerous
|
|
5
|
+
* Detects destructive shell commands and blocks the tool call.
|
|
7
6
|
*
|
|
8
|
-
*
|
|
7
|
+
* Exit code: 0 = allow, 2 = dangerous (blocks the tool call).
|
|
8
|
+
* Claude Code blocks a PreToolUse call ONLY on exit 2; any other non-zero code
|
|
9
|
+
* is a non-blocking hook error and the command still runs.
|
|
10
|
+
*
|
|
11
|
+
* Input, in order of preference:
|
|
12
|
+
* 1. Claude Code PreToolUse payload on stdin:
|
|
13
|
+
* {"hook_event_name":"PreToolUse","tool_name":"Bash","tool_input":{"command":"..."}}
|
|
14
|
+
* Only `tool_input.command` is inspected, never the other fields.
|
|
15
|
+
* 2. A raw command line on stdin when stdin is not a JSON object.
|
|
16
|
+
* 3. A command line as argv[2].
|
|
17
|
+
*
|
|
18
|
+
* Usage: echo '{"tool_input":{"command":"rm -rf /"}}' | node check-dangerous-cmd.mjs
|
|
9
19
|
* or: node check-dangerous-cmd.mjs "rm -rf /"
|
|
10
20
|
*
|
|
11
21
|
* Performance target: < 500ms
|
|
@@ -13,48 +23,173 @@
|
|
|
13
23
|
* @see docs/specs/SPEC-HOOKS-001-core-standard-hooks.md (REQ-2)
|
|
14
24
|
*/
|
|
15
25
|
|
|
16
|
-
const
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
26
|
+
const BLOCK_EXIT_CODE = 2;
|
|
27
|
+
|
|
28
|
+
// Where `rm -r` is never what the user meant: the filesystem root or the home directory.
|
|
29
|
+
// `/`, `//`, `/*`, `~`, `~/`, `~/*`, `$HOME`, `${HOME}`, `$HOME/`, `$HOME/*`. Not `/tmp/x`, not `~/proj`.
|
|
30
|
+
const ROOT_OR_HOME = /^(?:\/+\*?|(?:~|\$HOME|\$\{HOME\})(?:\/+\*?)?)$/;
|
|
31
|
+
|
|
32
|
+
// Words after which the real command follows (`sudo -u root rm ...`, `bash -c "rm ..."`, `then rm ...`).
|
|
33
|
+
const WRAPPERS = new Set([
|
|
34
|
+
'sudo', 'doas', 'env', 'command', 'builtin', 'exec', 'nohup', 'time', 'nice', 'ionice', 'timeout',
|
|
35
|
+
'bash', 'sh', 'zsh', 'dash', 'ksh', 'eval',
|
|
36
|
+
'then', 'do', 'else', 'elif', 'if', 'while', 'until', '!', '{',
|
|
37
|
+
]);
|
|
38
|
+
|
|
39
|
+
const baseName = (word) => word.slice(word.lastIndexOf('/') + 1);
|
|
40
|
+
const unquote = (word) => word.replace(/^["'`]+|["'`]+$/g, '');
|
|
41
|
+
|
|
42
|
+
/** Split a command line into simple commands, each a list of unquoted words. */
|
|
43
|
+
function simpleCommands(cmd) {
|
|
44
|
+
return cmd
|
|
45
|
+
.split(/[;&|\n()`]+/)
|
|
46
|
+
.map((segment) => segment.split(/\s+/).map(unquote).filter(Boolean))
|
|
47
|
+
.filter((words) => words.length > 0);
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
/**
|
|
51
|
+
* Index of the real command word in a simple command, or -1.
|
|
52
|
+
* The command is the first word, or the first word after a run of wrappers.
|
|
53
|
+
* `echo rm -rf /` and `git commit -m "rm -rf /"` have no `rm` command, so they never reach here.
|
|
54
|
+
*/
|
|
55
|
+
function commandIndex(words, name) {
|
|
56
|
+
let i = 0;
|
|
57
|
+
while (i < words.length && /^[A-Za-z_][A-Za-z0-9_]*=/.test(words[i])) i++; // VAR=value prefix
|
|
58
|
+
if (i >= words.length) return -1;
|
|
59
|
+
if (matches(words[i], name)) return i;
|
|
60
|
+
if (!WRAPPERS.has(words[i])) return -1;
|
|
61
|
+
for (let j = i + 1; j < words.length; j++) {
|
|
62
|
+
if (matches(words[j], name)) return j;
|
|
63
|
+
}
|
|
64
|
+
return -1;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
const matches = (word, name) => (typeof name === 'string' ? baseName(word) === name : name.test(baseName(word)));
|
|
68
|
+
|
|
69
|
+
function partition(args) {
|
|
70
|
+
const flags = [];
|
|
71
|
+
const operands = [];
|
|
72
|
+
let optionsEnded = false;
|
|
73
|
+
for (const arg of args) {
|
|
74
|
+
if (!optionsEnded && arg === '--') optionsEnded = true;
|
|
75
|
+
else if (!optionsEnded && arg.startsWith('-') && arg.length > 1) flags.push(arg);
|
|
76
|
+
else operands.push(arg);
|
|
77
|
+
}
|
|
78
|
+
return { flags, operands };
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
const isRecursive = (flags) =>
|
|
82
|
+
flags.some((f) => f === '--recursive' || (!f.startsWith('--') && /[rR]/.test(f)));
|
|
83
|
+
|
|
84
|
+
const RULES = [
|
|
85
|
+
{
|
|
86
|
+
name: 'rm-recursive-root-or-home',
|
|
87
|
+
test: (words) => {
|
|
88
|
+
const at = commandIndex(words, 'rm');
|
|
89
|
+
if (at < 0) return false;
|
|
90
|
+
const { flags, operands } = partition(words.slice(at + 1));
|
|
91
|
+
return isRecursive(flags) && operands.some((t) => ROOT_OR_HOME.test(t));
|
|
92
|
+
},
|
|
93
|
+
},
|
|
94
|
+
{
|
|
95
|
+
name: 'mkfs',
|
|
96
|
+
test: (words) => commandIndex(words, /^mkfs(?:\..+)?$/) >= 0,
|
|
97
|
+
},
|
|
98
|
+
{
|
|
99
|
+
name: 'dd-to-device',
|
|
100
|
+
test: (words) => {
|
|
101
|
+
const at = commandIndex(words, 'dd');
|
|
102
|
+
if (at < 0) return false;
|
|
103
|
+
return words.slice(at + 1).some((w) => /^of=\/dev\//.test(w) && !/^of=\/dev\/(?:null|zero|stdout|stderr|tty|fd\/)/.test(w));
|
|
104
|
+
},
|
|
105
|
+
},
|
|
106
|
+
{
|
|
107
|
+
name: 'format-drive',
|
|
108
|
+
test: (words) => {
|
|
109
|
+
const at = commandIndex(words, /^format(?:\.com|\.exe)?$/i);
|
|
110
|
+
return at >= 0 && words.slice(at + 1).some((w) => /^[a-zA-Z]:/.test(w));
|
|
111
|
+
},
|
|
112
|
+
},
|
|
113
|
+
{
|
|
114
|
+
name: 'chmod-recursive-777-root',
|
|
115
|
+
test: (words) => {
|
|
116
|
+
const at = commandIndex(words, 'chmod');
|
|
117
|
+
if (at < 0) return false;
|
|
118
|
+
const { flags, operands } = partition(words.slice(at + 1));
|
|
119
|
+
const recursive = flags.some((f) => f === '--recursive' || (!f.startsWith('--') && /R/.test(f)));
|
|
120
|
+
const wideOpen = operands.some((o) => /^(?:0?777|[ugoa]*\+rwx)$/.test(o));
|
|
121
|
+
return recursive && wideOpen && operands.some((t) => ROOT_OR_HOME.test(t));
|
|
122
|
+
},
|
|
123
|
+
},
|
|
124
|
+
];
|
|
125
|
+
|
|
126
|
+
// Matched on the whole command line, not per word: they are syntax, not a command word.
|
|
127
|
+
const WHOLE_LINE_RULES = [
|
|
128
|
+
{ name: 'redirect-to-disk', pattern: />\s*\/dev\/(?:sd[a-z]|hd[a-z]|vd[a-z]|xvd[a-z]|nvme\d+n\d+|r?disk\d+)/ },
|
|
129
|
+
{ name: 'fork-bomb', pattern: /:\s*\(\s*\)\s*\{\s*:\s*\|\s*:\s*&\s*\}\s*;\s*:/ },
|
|
24
130
|
];
|
|
25
131
|
|
|
132
|
+
/**
|
|
133
|
+
* Name of the first dangerous rule the command trips, or null.
|
|
134
|
+
* @param {string} cmd - The shell command to check
|
|
135
|
+
* @returns {string|null}
|
|
136
|
+
*/
|
|
137
|
+
export function findDangerousRule(cmd) {
|
|
138
|
+
if (!cmd || typeof cmd !== 'string') return null;
|
|
139
|
+
for (const rule of WHOLE_LINE_RULES) {
|
|
140
|
+
if (rule.pattern.test(cmd)) return rule.name;
|
|
141
|
+
}
|
|
142
|
+
for (const words of simpleCommands(cmd)) {
|
|
143
|
+
for (const rule of RULES) {
|
|
144
|
+
if (rule.test(words)) return rule.name;
|
|
145
|
+
}
|
|
146
|
+
}
|
|
147
|
+
return null;
|
|
148
|
+
}
|
|
149
|
+
|
|
26
150
|
/**
|
|
27
151
|
* Check if a command matches dangerous patterns.
|
|
28
152
|
* @param {string} cmd - The shell command to check
|
|
29
153
|
* @returns {boolean} true if dangerous
|
|
30
154
|
*/
|
|
31
155
|
export function isDangerousCommand(cmd) {
|
|
32
|
-
|
|
33
|
-
|
|
156
|
+
return findDangerousRule(cmd) !== null;
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
/**
|
|
160
|
+
* The command to check, from stdin text. A Claude Code payload yields only
|
|
161
|
+
* `tool_input.command` (null when it has none); anything else is a raw command line.
|
|
162
|
+
* @param {string} raw
|
|
163
|
+
* @returns {string|null}
|
|
164
|
+
*/
|
|
165
|
+
export function commandFromInput(raw) {
|
|
166
|
+
let payload;
|
|
167
|
+
try { payload = JSON.parse(raw); } catch { return raw; }
|
|
168
|
+
if (payload === null || typeof payload !== 'object' || Array.isArray(payload)) return raw;
|
|
169
|
+
const command = payload.tool_input?.command;
|
|
170
|
+
return typeof command === 'string' ? command : null;
|
|
171
|
+
}
|
|
172
|
+
|
|
173
|
+
function verdict(cmd) {
|
|
174
|
+
const rule = findDangerousRule(cmd);
|
|
175
|
+
if (rule === null) process.exit(0);
|
|
176
|
+
console.error(`Blocked by UDS security standard (rule: ${rule}): ${cmd}`);
|
|
177
|
+
process.exit(BLOCK_EXIT_CODE);
|
|
34
178
|
}
|
|
35
179
|
|
|
36
180
|
// CLI mode
|
|
37
181
|
if (process.argv[1] && process.argv[1].endsWith('check-dangerous-cmd.mjs')) {
|
|
38
182
|
const input = process.argv[2];
|
|
39
183
|
if (input) {
|
|
40
|
-
|
|
41
|
-
console.error(`⚠️ Dangerous command detected: "${input}"`);
|
|
42
|
-
process.exit(1);
|
|
43
|
-
} else {
|
|
44
|
-
process.exit(0);
|
|
45
|
-
}
|
|
184
|
+
verdict(input);
|
|
46
185
|
} else {
|
|
47
186
|
let data = '';
|
|
48
187
|
process.stdin.setEncoding('utf-8');
|
|
49
188
|
process.stdin.on('data', (chunk) => { data += chunk; });
|
|
50
189
|
process.stdin.on('end', () => {
|
|
51
|
-
const
|
|
52
|
-
if (
|
|
53
|
-
|
|
54
|
-
process.exit(1);
|
|
55
|
-
} else {
|
|
56
|
-
process.exit(0);
|
|
57
|
-
}
|
|
190
|
+
const raw = data.trim();
|
|
191
|
+
if (!raw) process.exit(0);
|
|
192
|
+
verdict(commandFromInput(raw));
|
|
58
193
|
});
|
|
59
194
|
}
|
|
60
195
|
}
|
|
@@ -4,7 +4,19 @@
|
|
|
4
4
|
*
|
|
5
5
|
* Checks code for unstructured logging calls (console.log, console.warn, etc.)
|
|
6
6
|
* and suggests using structured logging instead.
|
|
7
|
-
* Exit code: 0 = pass,
|
|
7
|
+
* Exit code: 0 = pass, 2 = unstructured logging found
|
|
8
|
+
*
|
|
9
|
+
* Why 2 and not 1: Claude Code shows a PostToolUse hook's stderr to the model only on
|
|
10
|
+
* exit 2. Any other non-zero code is a non-blocking hook error that the model never
|
|
11
|
+
* sees, so the suggestion would reach nobody. (The Write has already happened, so
|
|
12
|
+
* exit 2 here feeds the message back; it cannot undo anything.)
|
|
13
|
+
*
|
|
14
|
+
* Input, in order of preference:
|
|
15
|
+
* 1. Claude Code PostToolUse payload on stdin: only the written text
|
|
16
|
+
* (`tool_input.content`, or `tool_input.new_string` for an Edit) is checked,
|
|
17
|
+
* never the other fields such as file_path.
|
|
18
|
+
* 2. Raw code on stdin when stdin is not a JSON object.
|
|
19
|
+
* 3. Code as argv[2].
|
|
8
20
|
*
|
|
9
21
|
* Usage: echo 'console.log("debug")' | node check-logging-standard.mjs
|
|
10
22
|
* or: node check-logging-standard.mjs 'console.log("debug")'
|
|
@@ -32,13 +44,29 @@ export function hasUnstructuredLogging(code) {
|
|
|
32
44
|
return UNSTRUCTURED_PATTERNS.some((p) => p.test(code));
|
|
33
45
|
}
|
|
34
46
|
|
|
47
|
+
/**
|
|
48
|
+
* The code to check, from stdin text. A Claude Code payload yields only the written
|
|
49
|
+
* text (null when it carries none); anything else is raw code.
|
|
50
|
+
* @param {string} raw
|
|
51
|
+
* @returns {string|null}
|
|
52
|
+
*/
|
|
53
|
+
export function codeFromInput(raw) {
|
|
54
|
+
let payload;
|
|
55
|
+
try { payload = JSON.parse(raw); } catch { return raw; }
|
|
56
|
+
if (payload === null || typeof payload !== 'object' || Array.isArray(payload)) return raw;
|
|
57
|
+
const text = payload.tool_input?.content ?? payload.tool_input?.new_string;
|
|
58
|
+
return typeof text === 'string' ? text : null;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
const FEEDBACK_EXIT_CODE = 2;
|
|
62
|
+
|
|
35
63
|
// CLI mode
|
|
36
64
|
if (process.argv[1] && process.argv[1].endsWith('check-logging-standard.mjs')) {
|
|
37
65
|
const input = process.argv[2];
|
|
38
66
|
if (input) {
|
|
39
67
|
if (hasUnstructuredLogging(input)) {
|
|
40
|
-
console.error('
|
|
41
|
-
process.exit(
|
|
68
|
+
console.error('Unstructured logging detected. Use structured logging (e.g., JSON logger) instead.');
|
|
69
|
+
process.exit(FEEDBACK_EXIT_CODE);
|
|
42
70
|
} else {
|
|
43
71
|
process.exit(0);
|
|
44
72
|
}
|
|
@@ -47,10 +75,11 @@ if (process.argv[1] && process.argv[1].endsWith('check-logging-standard.mjs')) {
|
|
|
47
75
|
process.stdin.setEncoding('utf-8');
|
|
48
76
|
process.stdin.on('data', (chunk) => { data += chunk; });
|
|
49
77
|
process.stdin.on('end', () => {
|
|
50
|
-
const
|
|
78
|
+
const raw = data.trim();
|
|
79
|
+
const code = raw ? codeFromInput(raw) : null;
|
|
51
80
|
if (hasUnstructuredLogging(code)) {
|
|
52
|
-
console.error('
|
|
53
|
-
process.exit(
|
|
81
|
+
console.error('Unstructured logging detected. Use structured logging (e.g., JSON logger) instead.');
|
|
82
|
+
process.exit(FEEDBACK_EXIT_CODE);
|
|
54
83
|
} else {
|
|
55
84
|
process.exit(0);
|
|
56
85
|
}
|