universal-dev-standards 6.13.1 → 6.14.0-beta.10
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/README.md +13 -3
- package/bin/uds.js +75 -3
- package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
- package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
- package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
- package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
- package/bundled/ai/standards/code-review.ai.yaml +15 -2
- package/bundled/ai/standards/commit-message.ai.yaml +18 -4
- package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
- package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
- package/bundled/ai/standards/open-work-tracking.ai.yaml +254 -4
- package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
- package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
- package/bundled/ai/standards/turn-completion-integrity.ai.yaml +14 -7
- package/bundled/core/ai-response-navigation.md +128 -12
- package/bundled/core/code-review-checklist.md +20 -2
- package/bundled/core/commit-message-guide.md +22 -19
- package/bundled/core/developer-memory.md +12 -2
- package/bundled/core/full-coverage-testing.md +99 -5
- package/bundled/core/open-work-tracking.md +251 -8
- package/bundled/core/pipeline-security-gates.md +63 -0
- package/bundled/core/project-context-memory.md +10 -2
- package/bundled/core/turn-completion-integrity.md +58 -11
- package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
- package/bundled/extensions/languages/csharp-style.md +464 -0
- package/bundled/extensions/languages/php-style.md +700 -0
- package/bundled/extensions/locales/zh-cn.md +717 -0
- package/bundled/extensions/locales/zh-tw.md +717 -0
- package/bundled/hooks/check-turn-completion-agy.mjs +147 -0
- package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
- package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
- package/bundled/locales/COVERAGE.md +5 -4
- package/bundled/locales/zh-CN/CHANGELOG.md +211 -3
- package/bundled/locales/zh-CN/README.md +3 -3
- package/bundled/locales/zh-CN/SECURITY.md +3 -1
- package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
- package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
- package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
- package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
- package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
- 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/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-instruction-standards.md +71 -49
- package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
- 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/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 +54 -23
- 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/developer-memory.md +159 -60
- package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
- package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
- 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/full-coverage-testing.md +103 -9
- 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/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
- package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
- 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/retry-standards.md +46 -101
- package/bundled/locales/zh-CN/core/security-decision.md +45 -70
- package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
- 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/systematic-debugging.md +87 -42
- package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
- 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 +46 -13
- package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
- 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/AVAILABLE-STANDARDS.md +70 -0
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +11 -2
- package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +76 -40
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +32 -15
- package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
- package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
- package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
- 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 +46 -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/code-review/pr-review.md +13 -2
- 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 +3 -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/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/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/changelog-guide/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
- 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/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 +2 -2
- package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
- package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
- package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
- package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
- 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/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/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-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/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/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/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/bdd-extraction.md +2 -1
- 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-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/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/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 +211 -3
- package/bundled/locales/zh-TW/README.md +3 -3
- package/bundled/locales/zh-TW/SECURITY.md +3 -1
- package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
- package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
- package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
- package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
- package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
- 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/adr-standards.md +2 -1
- package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
- package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
- 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/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/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 +36 -7
- package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
- package/bundled/locales/zh-TW/core/database-standards.md +2 -1
- package/bundled/locales/zh-TW/core/developer-memory.md +111 -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/error-code-standards.md +17 -6
- 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/frontend-design-standards.md +120 -8
- package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
- 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/file-placement-guide.md +86 -2
- package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
- 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/open-work-tracking.md +164 -9
- package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
- package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
- package/bundled/locales/zh-TW/core/project-context-memory.md +215 -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/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/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 +46 -13
- 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/AVAILABLE-STANDARDS.md +70 -0
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +11 -2
- package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +69 -33
- package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +32 -15
- package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
- package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
- package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
- 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 +46 -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/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/code-review/pr-review.md +13 -2
- 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 +3 -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/language-options.md +21 -18
- package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
- package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
- 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/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/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/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/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/README.md +1 -0
- package/bundled/skills/SKILL_NAMING.md +9 -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/bundled/skills/comprehension-ladder/SKILL.md +283 -0
- package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
- package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
- package/bundled/templates/gates/check-stubs.mjs +644 -0
- package/package.json +5 -3
- package/src/commands/audit.js +20 -2
- package/src/commands/check.js +155 -28
- package/src/commands/deps.js +31 -1
- package/src/commands/hitl.js +3 -0
- package/src/commands/init.js +173 -49
- package/src/commands/list.js +12 -3
- package/src/commands/mcp.js +2 -3
- package/src/commands/open-work.js +123 -0
- package/src/commands/quickstart.js +29 -13
- package/src/commands/release.js +102 -19
- package/src/commands/run-intent.js +10 -0
- package/src/commands/simulate.js +20 -8
- package/src/commands/skills.js +59 -33
- package/src/commands/spec-split.js +30 -17
- package/src/commands/spec.js +55 -21
- package/src/commands/uninstall.js +146 -32
- package/src/commands/update.js +471 -93
- package/src/core/install-records.js +192 -0
- package/src/core/manifest.js +12 -10
- package/src/core/marketplace-sentinel.js +5 -0
- package/src/core/open-work-config.js +122 -0
- package/src/core/project-config.js +92 -38
- package/src/flows/init-flow.js +10 -0
- package/src/hitl/manager.js +4 -2
- package/src/i18n/messages.js +413 -78
- package/src/installers/hooks-installer.js +320 -24
- package/src/installers/integration-installer.js +5 -1
- package/src/installers/skills-installer.js +3 -1
- package/src/installers/standards-installer.js +16 -23
- package/src/mcp/__tests__/server.test.js +0 -1
- package/src/mcp/server.js +16 -4
- package/src/prompts/init.js +148 -13
- package/src/reconciler/backup-locations.js +80 -0
- package/src/reconciler/backup-manager.js +451 -123
- package/src/reconciler/index.js +86 -10
- package/src/reconciler/install-roots.js +90 -0
- package/src/reconciler/plan-executor.js +37 -15
- package/src/uninstallers/hook-uninstaller.js +323 -33
- package/src/uninstallers/integration-uninstaller.js +35 -5
- package/src/uninstallers/skills-uninstaller.js +95 -16
- package/src/uninstallers/standards-uninstaller.js +56 -7
- package/src/utils/agents-installer.js +10 -17
- package/src/utils/available-standards-report.js +144 -0
- package/src/utils/available-standards.js +216 -0
- package/src/utils/command-hash-ownership.js +103 -0
- package/src/utils/commit-message-judge.js +155 -0
- package/src/utils/copier.js +80 -2
- package/src/utils/deps-applicability.js +25 -0
- package/src/utils/detector.js +46 -1
- package/src/utils/friction-detector.js +27 -0
- package/src/utils/gate-scripts.js +141 -0
- package/src/utils/git-hooks.js +139 -7
- package/src/utils/hasher.js +36 -0
- package/src/utils/health-scorer.js +10 -7
- package/src/utils/installed-names-ownership.js +114 -0
- package/src/utils/integration-generator.js +36 -24
- package/src/utils/legacy-hook-migration.js +112 -0
- package/src/utils/locale.js +19 -0
- package/src/utils/open-work-tracking.mjs +1754 -0
- package/src/utils/prompt-closed.js +18 -0
- package/src/utils/sdd-header.js +66 -0
- package/src/utils/skill-frontmatter.js +102 -0
- package/src/utils/skill-hash-ownership.js +64 -0
- package/src/utils/skill-name-collision.js +169 -0
- package/src/utils/skills-install-paths.js +114 -0
- package/src/utils/skills-installer.js +75 -106
- package/src/utils/standard-validator.js +98 -27
- package/src/utils/test-change-check.js +160 -0
- package/src/utils/test-policy.js +214 -0
- package/src/utils/transient-fs.js +113 -0
- package/src/utils/update-summary.js +29 -0
- package/src/vibe/micro-spec.js +15 -0
- package/standards-registry.json +48 -9
|
@@ -0,0 +1,644 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// SPDX-License-Identifier: MIT
|
|
3
|
+
//
|
|
4
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
5
|
+
// check-stubs —— 空殼與暫時實作掃描(UDS full-coverage-testing 的出貨閘門)
|
|
6
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
7
|
+
//
|
|
8
|
+
// What it finds, in the source files of any project:
|
|
9
|
+
// stub-marker a `// WARNING: STUB — Remove before UAT` marker (a declared placeholder:
|
|
10
|
+
// UDS's full-coverage-testing standard says it must be gone before UAT)
|
|
11
|
+
// not-implemented a body that says it is not implemented (raise NotImplementedError,
|
|
12
|
+
// todo!(), TODO(), throw new Error("not implemented") ...) with no
|
|
13
|
+
// STUB / COVERAGE_EXEMPT marker beside it — a SILENT placeholder
|
|
14
|
+
// empty-function a named function whose body is empty (or only `pass` / `...`) with no
|
|
15
|
+
// such marker — a silent empty shell
|
|
16
|
+
//
|
|
17
|
+
// Written into your project by `uds init` (XSPEC-444 R5). It is YOURS: edit it, or replace
|
|
18
|
+
// it. `uds update` never overwrites it. `uds check` (which your pre-commit hook runs) calls
|
|
19
|
+
// it and prints what it finds as a WARNING; it does not stop your commit unless you set
|
|
20
|
+
// "mode": "block" in .standards/test-policy.json. To make STUB markers stop a push to main or
|
|
21
|
+
// a deploy (the standard's deployment gates), run it yourself in that step:
|
|
22
|
+
// node scripts/check-stubs.mjs # exit 1 when anything is found
|
|
23
|
+
//
|
|
24
|
+
// Usage:
|
|
25
|
+
// node scripts/check-stubs.mjs scan the whole project
|
|
26
|
+
// node scripts/check-stubs.mjs --staged scan only the files staged for commit
|
|
27
|
+
// node scripts/check-stubs.mjs --json machine-readable result
|
|
28
|
+
//
|
|
29
|
+
// Exit codes: 0 nothing found | 1 findings | 2 could not judge (the scanner's own
|
|
30
|
+
// self-test failed, or git was unreadable in --staged mode). 2 is never a pass.
|
|
31
|
+
//
|
|
32
|
+
// Marker rule: a placeholder is DECLARED when the text `STUB` or `COVERAGE_EXEMPT` is on
|
|
33
|
+
// the same line or in the three lines above it. A declared placeholder is reported once, as
|
|
34
|
+
// its marker (stub-marker), not again as an empty function.
|
|
35
|
+
//
|
|
36
|
+
// Empty-function detection has rules for JavaScript/TypeScript, Python, Go, Rust, Ruby and
|
|
37
|
+
// PHP. In other languages only markers and "not implemented" bodies are found, and the
|
|
38
|
+
// summary says so — it does not pretend to have looked.
|
|
39
|
+
//
|
|
40
|
+
// Heuristic by nature: it reads text, it does not understand your program. An empty function
|
|
41
|
+
// that is intentional (an interface default, a hook point) belongs next to a
|
|
42
|
+
// `// COVERAGE_EXEMPT: <reason>` comment, which states why.
|
|
43
|
+
|
|
44
|
+
import { existsSync, readFileSync, readdirSync, lstatSync, realpathSync } from 'node:fs';
|
|
45
|
+
import { join } from 'node:path';
|
|
46
|
+
import { execFileSync } from 'node:child_process';
|
|
47
|
+
import { fileURLToPath } from 'node:url';
|
|
48
|
+
|
|
49
|
+
// ---- BEGIN SHARED POLICY (identical in templates/gates/check-anti-fake-tests.mjs and check-stubs.mjs; test-policy-drift.test.js compares them) ----
|
|
50
|
+
/** Where an adopter's policy lives (inside `.standards/`, beside release-config.yaml). */
|
|
51
|
+
export const POLICY_FILE = '.standards/test-policy.json';
|
|
52
|
+
|
|
53
|
+
export const DEFAULT_POLICY = Object.freeze({
|
|
54
|
+
mode: 'warn',
|
|
55
|
+
testDirs: Object.freeze(['test', 'tests', '__tests__', 'spec', 'e2e']),
|
|
56
|
+
testPatterns: Object.freeze([
|
|
57
|
+
'*.test.*', '*.spec.*', '*_test.*', '*_spec.*', 'test_*.*', 'conftest.py',
|
|
58
|
+
'*Test.*', '*Tests.*', '*Spec.scala', '*Spec.kt', '*Spec.groovy'
|
|
59
|
+
]),
|
|
60
|
+
sourceExtensions: Object.freeze([
|
|
61
|
+
'js', 'mjs', 'cjs', 'jsx', 'ts', 'tsx', 'mts', 'cts', 'vue', 'svelte', 'astro',
|
|
62
|
+
'py', 'pyi', 'java', 'kt', 'kts', 'scala', 'groovy', 'go', 'rs', 'rb', 'php', 'cs', 'fs', 'vb',
|
|
63
|
+
'swift', 'm', 'mm', 'dart', 'c', 'h', 'cc', 'cpp', 'cxx', 'hpp', 'hh',
|
|
64
|
+
'ex', 'exs', 'erl', 'hrl', 'lua', 'pl', 'pm', 'r', 'jl', 'clj', 'cljs', 'hs', 'ml', 'mli',
|
|
65
|
+
'sh', 'bash', 'zsh', 'ps1'
|
|
66
|
+
]),
|
|
67
|
+
nonCodeExtensions: Object.freeze([
|
|
68
|
+
'md', 'mdx', 'txt', 'rst', 'adoc', 'json', 'jsonc', 'json5', 'yaml', 'yml', 'toml', 'ini', 'cfg',
|
|
69
|
+
'conf', 'properties', 'env', 'lock', 'xml', 'csv', 'tsv', 'svg', 'png', 'jpg', 'jpeg', 'gif', 'ico',
|
|
70
|
+
'webp', 'avif', 'pdf', 'woff', 'woff2', 'ttf', 'otf', 'eot', 'map', 'html', 'htm', 'css', 'scss',
|
|
71
|
+
'sass', 'less', 'sql', 'gitignore', 'gitattributes', 'editorconfig', 'npmrc', 'nvmrc', 'license',
|
|
72
|
+
'log', 'snap'
|
|
73
|
+
]),
|
|
74
|
+
nonCodeNames: Object.freeze([
|
|
75
|
+
'LICENSE', 'README', 'CHANGELOG', 'NOTICE', 'AUTHORS', 'CODEOWNERS', 'Dockerfile', 'Makefile', 'Procfile'
|
|
76
|
+
]),
|
|
77
|
+
ignoreDirs: Object.freeze([
|
|
78
|
+
'node_modules', 'vendor', 'dist', 'build', 'coverage', '.git', '.standards', '.claude', '.husky',
|
|
79
|
+
'.github', 'docs', 'target', '__pycache__', '.venv', 'venv', '.next', '.nuxt', '.idea', '.vscode',
|
|
80
|
+
'.ruff_cache', '.pytest_cache', '.mypy_cache', '.tox', '.gradle', '.cache', '.turbo', '.svelte-kit',
|
|
81
|
+
'.parcel-cache', '.terraform', '.dart_tool', '.eggs'
|
|
82
|
+
]),
|
|
83
|
+
ignore: Object.freeze(['**/*.min.js', '**/*.min.css', '**/*.d.ts']),
|
|
84
|
+
exempt: Object.freeze([])
|
|
85
|
+
});
|
|
86
|
+
|
|
87
|
+
const norm = (p) => String(p).replace(/\\/g, '/').replace(/^\.\//, '');
|
|
88
|
+
|
|
89
|
+
/** Glob → RegExp. `*` stays inside a path segment, `**` crosses them, `?` is one non-slash character. */
|
|
90
|
+
export function globToRegex(glob) {
|
|
91
|
+
const g = norm(glob);
|
|
92
|
+
let re = '';
|
|
93
|
+
for (let i = 0; i < g.length; i++) {
|
|
94
|
+
const c = g[i];
|
|
95
|
+
if (c === '*') {
|
|
96
|
+
if (g[i + 1] === '*') {
|
|
97
|
+
if (g[i + 2] === '/') { re += '(?:.*/)?'; i += 2; } else { re += '.*'; i += 1; }
|
|
98
|
+
} else {
|
|
99
|
+
re += '[^/]*';
|
|
100
|
+
}
|
|
101
|
+
} else if (c === '?') {
|
|
102
|
+
re += '[^/]';
|
|
103
|
+
} else if ('\\^$+.()|{}[]'.includes(c)) {
|
|
104
|
+
re += '\\' + c;
|
|
105
|
+
} else {
|
|
106
|
+
re += c;
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
return new RegExp(`^${re}$`);
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
/** A glob with no slash is a file-name glob (matches the basename anywhere); otherwise it matches the whole path. */
|
|
113
|
+
function matchesGlob(relPath, glob) {
|
|
114
|
+
const p = norm(relPath);
|
|
115
|
+
const g = norm(glob);
|
|
116
|
+
const target = g.includes('/') ? p : p.split('/').pop();
|
|
117
|
+
return globToRegex(g).test(target);
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
const extOf = (relPath) => {
|
|
121
|
+
const base = norm(relPath).split('/').pop();
|
|
122
|
+
const i = base.lastIndexOf('.');
|
|
123
|
+
return i > 0 ? base.slice(i + 1).toLowerCase() : '';
|
|
124
|
+
};
|
|
125
|
+
|
|
126
|
+
/**
|
|
127
|
+
* Read `.standards/test-policy.json` and merge it over the defaults.
|
|
128
|
+
* @returns {{ policy: object, problems: string[], source: string|null }}
|
|
129
|
+
* `problems` is never swallowed: an unreadable file or a bad value is reported, and the
|
|
130
|
+
* defaults (mode "warn") are what runs.
|
|
131
|
+
*/
|
|
132
|
+
export function loadPolicy(projectPath) {
|
|
133
|
+
const problems = [];
|
|
134
|
+
const policy = {
|
|
135
|
+
mode: DEFAULT_POLICY.mode,
|
|
136
|
+
testDirs: [...DEFAULT_POLICY.testDirs],
|
|
137
|
+
testPatterns: [...DEFAULT_POLICY.testPatterns],
|
|
138
|
+
sourceExtensions: [...DEFAULT_POLICY.sourceExtensions],
|
|
139
|
+
nonCodeExtensions: [...DEFAULT_POLICY.nonCodeExtensions],
|
|
140
|
+
nonCodeNames: [...DEFAULT_POLICY.nonCodeNames],
|
|
141
|
+
ignoreDirs: [...DEFAULT_POLICY.ignoreDirs],
|
|
142
|
+
ignore: [...DEFAULT_POLICY.ignore],
|
|
143
|
+
exempt: []
|
|
144
|
+
};
|
|
145
|
+
const file = join(projectPath, POLICY_FILE);
|
|
146
|
+
if (!existsSync(file)) return { policy, problems, source: null };
|
|
147
|
+
|
|
148
|
+
let raw;
|
|
149
|
+
try {
|
|
150
|
+
raw = JSON.parse(readFileSync(file, 'utf-8').replace(/^\uFEFF/, ''));
|
|
151
|
+
} catch (e) {
|
|
152
|
+
problems.push(`${POLICY_FILE} cannot be read (${e.message}); defaults are in effect`);
|
|
153
|
+
return { policy, problems, source: POLICY_FILE };
|
|
154
|
+
}
|
|
155
|
+
if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
|
|
156
|
+
problems.push(`${POLICY_FILE} must be a JSON object; defaults are in effect`);
|
|
157
|
+
return { policy, problems, source: POLICY_FILE };
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
if (raw.mode !== undefined) {
|
|
161
|
+
if (raw.mode === 'warn' || raw.mode === 'block') policy.mode = raw.mode;
|
|
162
|
+
else problems.push(`${POLICY_FILE}: "mode" must be "warn" or "block", got ${JSON.stringify(raw.mode)}; "warn" is in effect`);
|
|
163
|
+
}
|
|
164
|
+
for (const key of ['testDirs', 'testPatterns', 'sourceExtensions', 'nonCodeExtensions', 'ignore']) {
|
|
165
|
+
if (raw[key] === undefined) continue;
|
|
166
|
+
if (!Array.isArray(raw[key]) || raw[key].some((v) => typeof v !== 'string' || !v)) {
|
|
167
|
+
problems.push(`${POLICY_FILE}: "${key}" must be an array of non-empty strings; it is ignored`);
|
|
168
|
+
continue;
|
|
169
|
+
}
|
|
170
|
+
const add = key === 'sourceExtensions' || key === 'nonCodeExtensions'
|
|
171
|
+
? raw[key].map((v) => v.replace(/^\./, '').toLowerCase())
|
|
172
|
+
: raw[key];
|
|
173
|
+
policy[key] = [...policy[key], ...add];
|
|
174
|
+
}
|
|
175
|
+
if (raw.exempt !== undefined) {
|
|
176
|
+
if (!Array.isArray(raw.exempt)) {
|
|
177
|
+
problems.push(`${POLICY_FILE}: "exempt" must be an array; it is ignored`);
|
|
178
|
+
} else {
|
|
179
|
+
raw.exempt.forEach((e, i) => {
|
|
180
|
+
const okPattern = e && typeof e.pattern === 'string' && e.pattern.trim();
|
|
181
|
+
const okReason = e && typeof e.reason === 'string' && e.reason.trim();
|
|
182
|
+
if (!okPattern) problems.push(`${POLICY_FILE}: exempt[${i}] has no "pattern"; it is ignored`);
|
|
183
|
+
else if (!okReason) problems.push(`${POLICY_FILE}: exempt[${i}] ("${e.pattern}") has no "reason" and is NOT honored — an exemption must say why`);
|
|
184
|
+
else policy.exempt.push({ pattern: e.pattern, reason: e.reason.trim() });
|
|
185
|
+
});
|
|
186
|
+
}
|
|
187
|
+
}
|
|
188
|
+
return { policy, problems, source: POLICY_FILE };
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
/**
|
|
192
|
+
* Classify one project-relative path.
|
|
193
|
+
* @returns {{ kind: 'ignored'|'noncode'|'test'|'source'|'unclassified', ext: string, exempt?: {pattern:string, reason:string} }}
|
|
194
|
+
*/
|
|
195
|
+
export function classifyPath(relPath, policy = DEFAULT_POLICY) {
|
|
196
|
+
const p = norm(relPath);
|
|
197
|
+
const segments = p.split('/');
|
|
198
|
+
const base = segments[segments.length - 1];
|
|
199
|
+
const dirs = segments.slice(0, -1);
|
|
200
|
+
const ext = extOf(p);
|
|
201
|
+
const sets = {
|
|
202
|
+
source: new Set(policy.sourceExtensions || DEFAULT_POLICY.sourceExtensions),
|
|
203
|
+
noncode: new Set(policy.nonCodeExtensions || DEFAULT_POLICY.nonCodeExtensions),
|
|
204
|
+
names: new Set(policy.nonCodeNames || DEFAULT_POLICY.nonCodeNames),
|
|
205
|
+
ignoreDirs: new Set(policy.ignoreDirs || DEFAULT_POLICY.ignoreDirs)
|
|
206
|
+
};
|
|
207
|
+
|
|
208
|
+
if (dirs.some((d) => sets.ignoreDirs.has(d))) return { kind: 'ignored', ext };
|
|
209
|
+
if ((policy.ignore || DEFAULT_POLICY.ignore).some((g) => matchesGlob(p, g))) return { kind: 'ignored', ext };
|
|
210
|
+
|
|
211
|
+
const docsLike = sets.noncode.has(ext) || sets.names.has(base) || sets.names.has(base.replace(/\.[^.]*$/, ''));
|
|
212
|
+
const inTestDir = dirs.some((d) => (policy.testDirs || DEFAULT_POLICY.testDirs).includes(d));
|
|
213
|
+
const testNamed = (policy.testPatterns || DEFAULT_POLICY.testPatterns).some((g) => matchesGlob(p, g));
|
|
214
|
+
|
|
215
|
+
// A test is a test even when its data is JSON; but a README inside tests/ is documentation.
|
|
216
|
+
if ((inTestDir || testNamed) && !['md', 'mdx', 'txt', 'rst', 'adoc'].includes(ext)) return { kind: 'test', ext };
|
|
217
|
+
// Dot-files (.prettierrc, .eslintrc.js, .env.local ...) are tool configuration, not product code.
|
|
218
|
+
if (docsLike || base.startsWith('.')) return { kind: 'noncode', ext };
|
|
219
|
+
if (sets.source.has(ext)) {
|
|
220
|
+
const exempt = (policy.exempt || []).find((e) => matchesGlob(p, e.pattern));
|
|
221
|
+
return exempt ? { kind: 'source', ext, exempt } : { kind: 'source', ext };
|
|
222
|
+
}
|
|
223
|
+
return { kind: 'unclassified', ext };
|
|
224
|
+
}
|
|
225
|
+
// ---- END SHARED POLICY ----
|
|
226
|
+
|
|
227
|
+
// ---- BEGIN SHARED ENGINE (identical in check-anti-fake-tests.mjs and check-stubs.mjs; test-policy-drift.test.js compares them) ----
|
|
228
|
+
|
|
229
|
+
/**
|
|
230
|
+
* Language families this script has rules for, keyed by file extension.
|
|
231
|
+
* An extension that is not here is UNSUPPORTED: the script says so by name. It never
|
|
232
|
+
* counts a file it cannot read as a file that passed.
|
|
233
|
+
*/
|
|
234
|
+
export const FAMILY_BY_EXT = Object.freeze({
|
|
235
|
+
js: 'js', mjs: 'js', cjs: 'js', jsx: 'js', ts: 'js', tsx: 'js', mts: 'js', cts: 'js', vue: 'js', svelte: 'js',
|
|
236
|
+
py: 'python', pyi: 'python',
|
|
237
|
+
java: 'jvm', kt: 'jvm', kts: 'jvm', scala: 'jvm', groovy: 'jvm', cs: 'jvm',
|
|
238
|
+
go: 'go', rs: 'rust', rb: 'ruby', ex: 'elixir', exs: 'elixir',
|
|
239
|
+
php: 'php', swift: 'swift', dart: 'dart', lua: 'lua',
|
|
240
|
+
c: 'cpp', h: 'cpp', cc: 'cpp', cpp: 'cpp', cxx: 'cpp', hpp: 'cpp', hh: 'cpp'
|
|
241
|
+
});
|
|
242
|
+
|
|
243
|
+
const LEX = {
|
|
244
|
+
js: { line: ['//'], block: [['/*', '*/']], quotes: ['\'', '"', '`'], triple: [], regex: true },
|
|
245
|
+
python: { line: ['#'], block: [], quotes: ['\'', '"'], triple: ['"""', '\'\'\''] },
|
|
246
|
+
jvm: { line: ['//'], block: [['/*', '*/']], quotes: ['\'', '"'], triple: ['"""'] },
|
|
247
|
+
go: { line: ['//'], block: [['/*', '*/']], quotes: ['\'', '"', '`'], triple: [] },
|
|
248
|
+
rust: { line: ['//'], block: [['/*', '*/']], quotes: ['"', '\''], triple: [], rustChar: true },
|
|
249
|
+
ruby: { line: ['#'], block: [], quotes: ['\'', '"'], triple: [] },
|
|
250
|
+
elixir: { line: ['#'], block: [], quotes: ['"', '\''], triple: ['"""'] },
|
|
251
|
+
php: { line: ['//', '#'], block: [['/*', '*/']], quotes: ['\'', '"'], triple: [], phpAttr: true },
|
|
252
|
+
swift: { line: ['//'], block: [['/*', '*/']], quotes: ['"'], triple: ['"""'] },
|
|
253
|
+
dart: { line: ['//'], block: [['/*', '*/']], quotes: ['\'', '"'], triple: ['"""', '\'\'\''] },
|
|
254
|
+
lua: { line: ['--'], block: [['--[[', ']]']], quotes: ['\'', '"'], triple: [] },
|
|
255
|
+
cpp: { line: ['//'], block: [['/*', '*/']], quotes: ['\'', '"'], triple: [] },
|
|
256
|
+
other: { line: ['//', '#'], block: [['/*', '*/']], quotes: ['\'', '"'], triple: [] }
|
|
257
|
+
};
|
|
258
|
+
|
|
259
|
+
/**
|
|
260
|
+
* Same-length copies of `text`: `noComments` (comments blanked) and `noStrings` (comments
|
|
261
|
+
* AND the inside of string literals blanked). Same length means an index found in one is
|
|
262
|
+
* the same place in the other and in the original — which is how names are read back.
|
|
263
|
+
*/
|
|
264
|
+
export function maskSource(text, family) {
|
|
265
|
+
const lex = LEX[family] || LEX.other;
|
|
266
|
+
const nc = text.split('');
|
|
267
|
+
const ns = text.split('');
|
|
268
|
+
const n = text.length;
|
|
269
|
+
const blank = (arr, from, to) => { for (let k = from; k < to; k++) if (arr[k] !== '\n') arr[k] = ' '; };
|
|
270
|
+
let i = 0;
|
|
271
|
+
while (i < n) {
|
|
272
|
+
let hit = false;
|
|
273
|
+
for (const [open, close] of lex.block) {
|
|
274
|
+
if (text.startsWith(open, i)) {
|
|
275
|
+
const end = text.indexOf(close, i + open.length);
|
|
276
|
+
const stop = end === -1 ? n : end + close.length;
|
|
277
|
+
blank(nc, i, stop); blank(ns, i, stop);
|
|
278
|
+
i = stop; hit = true; break;
|
|
279
|
+
}
|
|
280
|
+
}
|
|
281
|
+
if (hit) continue;
|
|
282
|
+
for (const lc of lex.line) {
|
|
283
|
+
if (text.startsWith(lc, i) && !(lex.phpAttr && lc === '#' && text[i + 1] === '[')) {
|
|
284
|
+
let end = text.indexOf('\n', i);
|
|
285
|
+
if (end === -1) end = n;
|
|
286
|
+
blank(nc, i, end); blank(ns, i, end);
|
|
287
|
+
i = end; hit = true; break;
|
|
288
|
+
}
|
|
289
|
+
}
|
|
290
|
+
if (hit) continue;
|
|
291
|
+
const triple = lex.triple.find((t) => text.startsWith(t, i));
|
|
292
|
+
if (triple) {
|
|
293
|
+
const end = text.indexOf(triple, i + 3);
|
|
294
|
+
// The delimiters go too: a closing `"""` left at column 0 would end an indented block early.
|
|
295
|
+
const stop = end === -1 ? n : end + 3;
|
|
296
|
+
blank(ns, i, stop);
|
|
297
|
+
i = stop;
|
|
298
|
+
continue;
|
|
299
|
+
}
|
|
300
|
+
const ch = text[i];
|
|
301
|
+
if (lex.regex && ch === '/') {
|
|
302
|
+
// A regex literal may hold a quote or a backtick; read it as one token so it cannot open a string.
|
|
303
|
+
let p = i - 1;
|
|
304
|
+
while (p >= 0 && /[ \t]/.test(text[p])) p--;
|
|
305
|
+
const before = p < 0 ? '' : text[p];
|
|
306
|
+
const word = /(?:^|[^\w$])(return|typeof|case|in|of|void|delete|throw|yield|await)$/.test(text.slice(Math.max(0, p - 9), p + 1));
|
|
307
|
+
if (p < 0 || '(,=:[!&|?{};+-*%<>~^\n'.includes(before) || word) {
|
|
308
|
+
let j = i + 1;
|
|
309
|
+
let inClass = false;
|
|
310
|
+
while (j < n) {
|
|
311
|
+
const c = text[j];
|
|
312
|
+
if (c === '\\') { j += 2; continue; }
|
|
313
|
+
if (c === '\n') { j = -1; break; }
|
|
314
|
+
if (c === '[') inClass = true;
|
|
315
|
+
else if (c === ']') inClass = false;
|
|
316
|
+
else if (c === '/' && !inClass) break;
|
|
317
|
+
j++;
|
|
318
|
+
}
|
|
319
|
+
if (j > i && j < n) { blank(ns, i + 1, j); i = j + 1; continue; }
|
|
320
|
+
}
|
|
321
|
+
}
|
|
322
|
+
if (lex.quotes.includes(ch)) {
|
|
323
|
+
if (lex.rustChar && ch === '\'') {
|
|
324
|
+
const isChar = text[i + 2] === '\'' || (text[i + 1] === '\\' && text[i + 3] === '\'');
|
|
325
|
+
if (!isChar) { i++; continue; }
|
|
326
|
+
}
|
|
327
|
+
const multiline = ch === '`';
|
|
328
|
+
let j = i + 1;
|
|
329
|
+
while (j < n) {
|
|
330
|
+
if (text[j] === '\\') { j += 2; continue; }
|
|
331
|
+
if (text[j] === ch) break;
|
|
332
|
+
if (text[j] === '\n' && !multiline) break;
|
|
333
|
+
j++;
|
|
334
|
+
}
|
|
335
|
+
blank(ns, i + 1, Math.min(j, n));
|
|
336
|
+
i = j + 1;
|
|
337
|
+
continue;
|
|
338
|
+
}
|
|
339
|
+
i++;
|
|
340
|
+
}
|
|
341
|
+
return { noComments: nc.join(''), noStrings: ns.join('') };
|
|
342
|
+
}
|
|
343
|
+
|
|
344
|
+
/** Index of the bracket that closes the one at `open` (counting only that bracket pair), or -1. */
|
|
345
|
+
export function matchClose(s, open) {
|
|
346
|
+
const pairs = { '(': ')', '{': '}', '[': ']' };
|
|
347
|
+
const o = s[open];
|
|
348
|
+
const c = pairs[o];
|
|
349
|
+
if (!c) return -1;
|
|
350
|
+
let depth = 0;
|
|
351
|
+
for (let i = open; i < s.length; i++) {
|
|
352
|
+
if (s[i] === o) depth++;
|
|
353
|
+
else if (s[i] === c && --depth === 0) return i;
|
|
354
|
+
}
|
|
355
|
+
return -1;
|
|
356
|
+
}
|
|
357
|
+
|
|
358
|
+
/** A function that maps a character index to its 1-based line number. */
|
|
359
|
+
export function lineIndex(text) {
|
|
360
|
+
const starts = [0];
|
|
361
|
+
for (let i = 0; i < text.length; i++) if (text[i] === '\n') starts.push(i + 1);
|
|
362
|
+
return (idx) => {
|
|
363
|
+
let lo = 0; let hi = starts.length - 1;
|
|
364
|
+
while (lo < hi) {
|
|
365
|
+
const mid = (lo + hi + 1) >> 1;
|
|
366
|
+
if (starts[mid] <= idx) lo = mid; else hi = mid - 1;
|
|
367
|
+
}
|
|
368
|
+
return lo + 1;
|
|
369
|
+
};
|
|
370
|
+
}
|
|
371
|
+
|
|
372
|
+
/** Every project-relative file under `root`, skipping the policy's ignored directories and symlinks. */
|
|
373
|
+
export function walkFiles(root, policy) {
|
|
374
|
+
const skip = new Set(policy.ignoreDirs);
|
|
375
|
+
const out = [];
|
|
376
|
+
const stack = [''];
|
|
377
|
+
while (stack.length > 0 && out.length < 200000) {
|
|
378
|
+
const rel = stack.pop();
|
|
379
|
+
let entries;
|
|
380
|
+
try { entries = readdirSync(join(root, rel), { withFileTypes: true }); } catch { continue; }
|
|
381
|
+
for (const e of entries) {
|
|
382
|
+
const r = rel ? `${rel}/${e.name}` : e.name;
|
|
383
|
+
if (e.isSymbolicLink()) continue;
|
|
384
|
+
if (e.isDirectory()) { if (!skip.has(e.name)) stack.push(r); } else if (e.isFile()) out.push(r);
|
|
385
|
+
}
|
|
386
|
+
}
|
|
387
|
+
return out.sort();
|
|
388
|
+
}
|
|
389
|
+
|
|
390
|
+
/** Files staged for the next commit (added, copied, modified, renamed), or `{ error }`. */
|
|
391
|
+
export function stagedFiles(root) {
|
|
392
|
+
try {
|
|
393
|
+
const out = execFileSync('git', ['-c', 'core.quotepath=off', 'diff', '--cached', '--name-only', '--diff-filter=ACMR', '-z'], {
|
|
394
|
+
cwd: root, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'], maxBuffer: 64 * 1024 * 1024
|
|
395
|
+
});
|
|
396
|
+
return { files: out.split('\0').filter(Boolean) };
|
|
397
|
+
} catch (e) {
|
|
398
|
+
return { error: String(e.stderr || e.message || 'git diff failed').trim().split('\n')[0] };
|
|
399
|
+
}
|
|
400
|
+
}
|
|
401
|
+
|
|
402
|
+
/** File text, or `{ skipped }` when it is binary or larger than 2 MB (said, never silently dropped). */
|
|
403
|
+
export function readText(abs) {
|
|
404
|
+
try {
|
|
405
|
+
if (lstatSync(abs).size > 2 * 1024 * 1024) return { skipped: 'larger than 2 MB' };
|
|
406
|
+
const buf = readFileSync(abs);
|
|
407
|
+
if (buf.subarray(0, 8000).includes(0)) return { skipped: 'binary', quiet: true };
|
|
408
|
+
return { text: buf.toString('utf8').replace(/^\uFEFF/, '') };
|
|
409
|
+
} catch (e) {
|
|
410
|
+
return { skipped: `unreadable (${e.code || e.message})` };
|
|
411
|
+
}
|
|
412
|
+
}
|
|
413
|
+
|
|
414
|
+
export function extOfPath(p) {
|
|
415
|
+
const base = String(p).replace(/\\/g, '/').split('/').pop();
|
|
416
|
+
const i = base.lastIndexOf('.');
|
|
417
|
+
return i > 0 ? base.slice(i + 1).toLowerCase() : '';
|
|
418
|
+
}
|
|
419
|
+
|
|
420
|
+
/** Is this module the one being run (not imported)? Resolves symlinks so `node scripts/x.mjs` and a symlinked path agree. */
|
|
421
|
+
export function isMain(metaUrl) {
|
|
422
|
+
try {
|
|
423
|
+
return realpathSync(process.argv[1]) === realpathSync(fileURLToPath(metaUrl));
|
|
424
|
+
} catch {
|
|
425
|
+
return false;
|
|
426
|
+
}
|
|
427
|
+
}
|
|
428
|
+
|
|
429
|
+
export const indentOf = (l) => l.match(/^[ \t]*/)[0].replace(/\t/g, ' ').length;
|
|
430
|
+
|
|
431
|
+
/** Indented block that follows line `startLine` (0-based index into `lines`): every following line that is blank or indented deeper than `indent`. */
|
|
432
|
+
export function indentBlock(lines, startLine, indent) {
|
|
433
|
+
let end = startLine + 1;
|
|
434
|
+
let lastBody = startLine;
|
|
435
|
+
while (end < lines.length) {
|
|
436
|
+
const l = lines[end];
|
|
437
|
+
if (l.trim() === '') { end++; continue; }
|
|
438
|
+
const ind = indentOf(l);
|
|
439
|
+
if (ind <= indent) break;
|
|
440
|
+
lastBody = end;
|
|
441
|
+
end++;
|
|
442
|
+
}
|
|
443
|
+
return { first: startLine + 1, last: lastBody };
|
|
444
|
+
}
|
|
445
|
+
// ---- END SHARED ENGINE ----
|
|
446
|
+
|
|
447
|
+
// ═══════════════════════════════════════════════════════════════════════════
|
|
448
|
+
// Stub rules
|
|
449
|
+
// ═══════════════════════════════════════════════════════════════════════════
|
|
450
|
+
|
|
451
|
+
const MARKER_RE = /WARNING:\s*STUB/;
|
|
452
|
+
const DECLARED_RE = /\bSTUB\b|COVERAGE_EXEMPT/;
|
|
453
|
+
|
|
454
|
+
const NOT_IMPLEMENTED = [
|
|
455
|
+
/\braise\s+NotImplementedError\b/g,
|
|
456
|
+
/\bthrow\s+new\s+\w*NotImplemented\w*/g,
|
|
457
|
+
/\bthrow\s+new\s+(?:Error|\w*Exception)\s*\(\s*['"`]\s*(?:not\s+(?:yet\s+)?implemented|todo|unimplemented)/gi,
|
|
458
|
+
/\b(?:todo|unimplemented)!\s*\(/g,
|
|
459
|
+
/\bTODO\s*\(\s*(?:"[^"\n]*")?\s*\)/g,
|
|
460
|
+
/\bpanic\(\s*"\s*(?:not\s+(?:yet\s+)?implemented|todo|unimplemented)/gi,
|
|
461
|
+
/\bfatalError\(\s*"\s*(?:not\s+(?:yet\s+)?implemented|todo)/gi
|
|
462
|
+
];
|
|
463
|
+
|
|
464
|
+
const EMPTY_FN = {
|
|
465
|
+
js: [
|
|
466
|
+
/\bfunction\s*\*?\s*(\w+)\s*\([^)]*\)\s*(?::\s*[^{;\n]+?)?\s*\{\s*\}/g,
|
|
467
|
+
/\b(?:const|let|var)\s+(\w+)\s*=\s*(?:async\s*)?(?:\([^)]*\)|\w+)\s*(?::\s*[^=\n]+?)?=>\s*\{\s*\}/g
|
|
468
|
+
],
|
|
469
|
+
php: [/\bfunction\s+(\w+)\s*\([^)]*\)\s*(?::\s*\??[\w\\]+\s*)?\{\s*\}/g],
|
|
470
|
+
go: [/\bfunc\s+(?:\([^)]*\)\s*)?(\w+)\s*\([^)]*\)\s*(?:\([^)]*\)|[\w.*[\]]+)?\s*\{\s*\}/g],
|
|
471
|
+
rust: [/\bfn\s+(\w+)\s*(?:<[^>]*>)?\s*\([^)]*\)\s*(?:->\s*[^{;]+?)?\s*\{\s*\}/g],
|
|
472
|
+
ruby: [/\bdef\s+(\w+[?!=]?)(?:\([^)]*\))?[ \t]*\n\s*end\b/g]
|
|
473
|
+
};
|
|
474
|
+
const IGNORED_NAMES = /^(?:noop|no_?op|_+|initialize)$/i;
|
|
475
|
+
|
|
476
|
+
const declaredNear = (lines, lineNo) => {
|
|
477
|
+
for (let k = Math.max(0, lineNo - 4); k <= lineNo - 1; k++) if (DECLARED_RE.test(lines[k] || '')) return true;
|
|
478
|
+
return false;
|
|
479
|
+
};
|
|
480
|
+
|
|
481
|
+
/**
|
|
482
|
+
* @returns {{ family: string|null, emptyRule: boolean, findings: { rule: string, line: number, name: string, detail: string }[] }}
|
|
483
|
+
*/
|
|
484
|
+
export function analyzeStubText(text, ext) {
|
|
485
|
+
const family = FAMILY_BY_EXT[ext] || null;
|
|
486
|
+
const { noComments, noStrings } = maskSource(text, family || 'other');
|
|
487
|
+
const lineOf = lineIndex(text);
|
|
488
|
+
const lines = text.split('\n');
|
|
489
|
+
const findings = [];
|
|
490
|
+
|
|
491
|
+
// 1. declared placeholders: the STUB marker itself
|
|
492
|
+
lines.forEach((l, i) => {
|
|
493
|
+
if (MARKER_RE.test(l)) {
|
|
494
|
+
findings.push({ rule: 'stub-marker', line: i + 1, name: l.trim().slice(0, 80), detail: 'placeholder marked STUB — must be removed before UAT/production' });
|
|
495
|
+
}
|
|
496
|
+
});
|
|
497
|
+
|
|
498
|
+
// 2. silent "not implemented" bodies
|
|
499
|
+
for (const re of NOT_IMPLEMENTED) {
|
|
500
|
+
const r = new RegExp(re.source, re.flags);
|
|
501
|
+
let m;
|
|
502
|
+
while ((m = r.exec(noComments)) !== null) {
|
|
503
|
+
const line = lineOf(m.index);
|
|
504
|
+
if (declaredNear(lines, line)) continue;
|
|
505
|
+
if (/@(?:abc\.)?abstractmethod\b|@overload\b/.test(lines.slice(Math.max(0, line - 4), line - 1).join('\n'))) continue;
|
|
506
|
+
findings.push({ rule: 'not-implemented', line, name: m[0].trim().slice(0, 60), detail: 'a body that says it is not implemented, with no STUB / COVERAGE_EXEMPT marker beside it' });
|
|
507
|
+
}
|
|
508
|
+
}
|
|
509
|
+
|
|
510
|
+
// 3. silent empty functions (languages with a rule)
|
|
511
|
+
const emptyRule = Boolean(family && (EMPTY_FN[family] || family === 'python'));
|
|
512
|
+
if (family && EMPTY_FN[family]) {
|
|
513
|
+
for (const re of EMPTY_FN[family]) {
|
|
514
|
+
const r = new RegExp(re.source, re.flags);
|
|
515
|
+
let m;
|
|
516
|
+
while ((m = r.exec(noStrings)) !== null) {
|
|
517
|
+
const line = lineOf(m.index);
|
|
518
|
+
if (IGNORED_NAMES.test(m[1]) || declaredNear(lines, line)) continue;
|
|
519
|
+
findings.push({ rule: 'empty-function', line, name: m[1], detail: 'the function body is empty, with no STUB / COVERAGE_EXEMPT marker beside it' });
|
|
520
|
+
}
|
|
521
|
+
}
|
|
522
|
+
}
|
|
523
|
+
if (family === 'python') {
|
|
524
|
+
const ns = noStrings.split('\n');
|
|
525
|
+
for (let li = 0; li < ns.length; li++) {
|
|
526
|
+
const m = /^([ \t]*)(?:async\s+)?def\s+(\w+)\s*\(/.exec(ns[li]);
|
|
527
|
+
if (!m || IGNORED_NAMES.test(m[2]) || /^__\w+__$/.test(m[2])) continue;
|
|
528
|
+
const indent = indentOf(m[1] + 'x') - 1;
|
|
529
|
+
// the signature may span lines; the body starts after the line that ends with ':'
|
|
530
|
+
let sig = li;
|
|
531
|
+
while (sig < ns.length - 1 && !/:\s*$/.test(ns[sig]) && !/:\s*\S/.test(ns[sig].slice(ns[sig].lastIndexOf(')')))) sig++;
|
|
532
|
+
const { first, last } = indentBlock(ns, sig, indent);
|
|
533
|
+
const inline = ns[sig].slice(ns[sig].lastIndexOf(')')).replace(/^\)[^:]*:/, '').trim();
|
|
534
|
+
const body = [inline, ...ns.slice(first, last + 1)].map((s) => s.trim()).filter(Boolean);
|
|
535
|
+
const empty = body.length === 0 || body.every((s) => s === 'pass' || s === '...');
|
|
536
|
+
if (!empty) continue;
|
|
537
|
+
if (declaredNear(lines, li + 1)) continue;
|
|
538
|
+
const decorators = lines.slice(Math.max(0, li - 4), li).join('\n');
|
|
539
|
+
if (/@(?:abc\.)?abstractmethod\b|@overload\b/.test(decorators)) continue;
|
|
540
|
+
findings.push({ rule: 'empty-function', line: li + 1, name: m[2], detail: 'the function body is empty (or only `pass` / `...`), with no STUB / COVERAGE_EXEMPT marker beside it' });
|
|
541
|
+
}
|
|
542
|
+
}
|
|
543
|
+
findings.sort((a, b) => a.line - b.line);
|
|
544
|
+
return { family, emptyRule, findings };
|
|
545
|
+
}
|
|
546
|
+
|
|
547
|
+
// ═══════════════════════════════════════════════════════════════════════════
|
|
548
|
+
// Self-test — runs on EVERY invocation, before a single project file is read.
|
|
549
|
+
// ═══════════════════════════════════════════════════════════════════════════
|
|
550
|
+
|
|
551
|
+
const SELF_TEST = [
|
|
552
|
+
{ ext: 'js', rules: ['empty-function'], text: 'function save(order) {}\n' },
|
|
553
|
+
{ ext: 'js', rules: ['empty-function'], text: 'const charge = async (card) => {\n}\n' },
|
|
554
|
+
{ ext: 'js', rules: [], text: 'function noop() {}\nfunction add(a, b) { return a + b; }\n' },
|
|
555
|
+
{ ext: 'js', rules: ['stub-marker'], text: '// WARNING: STUB — Remove before UAT\nasync function validatePayment(card) {}\n' },
|
|
556
|
+
{ ext: 'js', rules: [], text: '// COVERAGE_EXEMPT: hardware hook point, nothing to do on this platform\nfunction onTick() {}\n' },
|
|
557
|
+
{ ext: 'py', rules: ['not-implemented'], text: 'def charge(card):\n raise NotImplementedError\n' },
|
|
558
|
+
{ ext: 'py', rules: ['empty-function'], text: 'def save(order):\n pass\n' },
|
|
559
|
+
{ ext: 'py', rules: [], text: 'class A:\n @abstractmethod\n def run(self):\n raise NotImplementedError\n\n def __init__(self):\n pass\n\n\ndef add(a, b):\n return a + b\n' },
|
|
560
|
+
{ ext: 'go', rules: ['empty-function'], text: 'func Charge(card Card) error {}\n' },
|
|
561
|
+
{ ext: 'rs', rules: ['not-implemented'], text: 'fn charge() {\n todo!()\n}\n' },
|
|
562
|
+
{ ext: 'rs', rules: [], text: 'fn add(a: i32, b: i32) -> i32 {\n a + b\n}\n' },
|
|
563
|
+
{ ext: 'zig', rules: ['not-implemented'], text: 'fn charge() void {\n unimplemented!()\n}\n' }
|
|
564
|
+
];
|
|
565
|
+
|
|
566
|
+
/** @returns {string[]} what went wrong; empty = the scanner behaves on every known sample */
|
|
567
|
+
export function selfTest() {
|
|
568
|
+
const problems = [];
|
|
569
|
+
for (const [i, s] of SELF_TEST.entries()) {
|
|
570
|
+
const got = analyzeStubText(s.text, s.ext).findings.map((f) => f.rule).sort();
|
|
571
|
+
const want = [...s.rules].sort();
|
|
572
|
+
if (JSON.stringify(got) !== JSON.stringify(want)) {
|
|
573
|
+
problems.push(`self-test #${i} (.${s.ext}): expected [${want.join(', ')}], got [${got.join(', ')}]`);
|
|
574
|
+
}
|
|
575
|
+
}
|
|
576
|
+
return problems;
|
|
577
|
+
}
|
|
578
|
+
|
|
579
|
+
// ═══════════════════════════════════════════════════════════════════════════
|
|
580
|
+
// Run
|
|
581
|
+
// ═══════════════════════════════════════════════════════════════════════════
|
|
582
|
+
|
|
583
|
+
// This file spells out the very markers it looks for (in comments and in its self-test), so it
|
|
584
|
+
// must not scan itself.
|
|
585
|
+
const SELF = (() => { try { return realpathSync(fileURLToPath(import.meta.url)); } catch { return null; } })();
|
|
586
|
+
const isSelf = (abs) => { try { return SELF !== null && realpathSync(abs) === SELF; } catch { return false; } };
|
|
587
|
+
|
|
588
|
+
export function scan(root, { staged = false } = {}) {
|
|
589
|
+
const { policy, problems } = loadPolicy(root);
|
|
590
|
+
let files;
|
|
591
|
+
if (staged) {
|
|
592
|
+
const s = stagedFiles(root);
|
|
593
|
+
if (s.error) return { error: `cannot read the staged files: ${s.error}`, problems };
|
|
594
|
+
files = s.files;
|
|
595
|
+
} else {
|
|
596
|
+
files = walkFiles(root, policy);
|
|
597
|
+
}
|
|
598
|
+
const result = { mode: staged ? 'staged' : 'all', problems, files: 0, findings: [], noEmptyRule: new Set(), unreadable: [] };
|
|
599
|
+
for (const rel of files) {
|
|
600
|
+
const kind = classifyPath(rel, policy).kind;
|
|
601
|
+
if (kind !== 'source' && kind !== 'unclassified') continue;
|
|
602
|
+
if (isSelf(join(root, rel))) continue;
|
|
603
|
+
const ext = extOfPath(rel);
|
|
604
|
+
const r = readText(join(root, rel));
|
|
605
|
+
if (r.skipped) { if (!r.quiet) result.unreadable.push(`${rel} (${r.skipped})`); continue; }
|
|
606
|
+
const a = analyzeStubText(r.text, ext);
|
|
607
|
+
result.files++;
|
|
608
|
+
if (!a.emptyRule) result.noEmptyRule.add(ext ? `.${ext}` : '(no extension)');
|
|
609
|
+
for (const f of a.findings) result.findings.push({ file: rel, ...f });
|
|
610
|
+
}
|
|
611
|
+
result.noEmptyRule = [...result.noEmptyRule].sort();
|
|
612
|
+
return result;
|
|
613
|
+
}
|
|
614
|
+
|
|
615
|
+
function report(r) {
|
|
616
|
+
const out = [];
|
|
617
|
+
for (const p of r.problems) out.push(` ! ${p}`);
|
|
618
|
+
out.push(`check-stubs: scanned ${r.files} source file(s) (${r.mode === 'staged' ? 'staged files only' : 'whole project'})`);
|
|
619
|
+
for (const f of r.findings) out.push(` ✗ ${f.file}:${f.line} ${f.rule} ${f.name} — ${f.detail}`);
|
|
620
|
+
if (r.noEmptyRule.length > 0) {
|
|
621
|
+
out.push(` · empty-function scan has no rule for: ${r.noEmptyRule.join(' ')} (markers and "not implemented" bodies were still searched)`);
|
|
622
|
+
}
|
|
623
|
+
for (const u of r.unreadable) out.push(` · NOT scanned — ${u}`);
|
|
624
|
+
out.push(r.findings.length > 0 ? `RESULT: ${r.findings.length} finding(s)` : 'RESULT: no stubs found among the files scanned');
|
|
625
|
+
return out.join('\n');
|
|
626
|
+
}
|
|
627
|
+
|
|
628
|
+
export function main(argv, root = process.cwd()) {
|
|
629
|
+
const bad = selfTest();
|
|
630
|
+
if (bad.length > 0) {
|
|
631
|
+
console.error('check-stubs: the scanner failed its own self-test, so its result would mean nothing:');
|
|
632
|
+
for (const b of bad) console.error(` ${b}`);
|
|
633
|
+
return 2;
|
|
634
|
+
}
|
|
635
|
+
const r = scan(root, { staged: argv.includes('--staged') });
|
|
636
|
+
if (r.error) {
|
|
637
|
+
console.error(`check-stubs: ${r.error}`);
|
|
638
|
+
return 2;
|
|
639
|
+
}
|
|
640
|
+
console.log(argv.includes('--json') ? JSON.stringify(r, null, 2) : report(r));
|
|
641
|
+
return r.findings.length > 0 ? 1 : 0;
|
|
642
|
+
}
|
|
643
|
+
|
|
644
|
+
if (isMain(import.meta.url)) process.exitCode = main(process.argv.slice(2));
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "universal-dev-standards",
|
|
3
|
-
"version": "6.
|
|
3
|
+
"version": "6.14.0-beta.10",
|
|
4
4
|
"description": "CLI tool for adopting Universal Development Standards",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"documentation",
|
|
@@ -58,6 +58,8 @@
|
|
|
58
58
|
"check:bundle-parity": "node scripts/check-bundle-parity.mjs",
|
|
59
59
|
"prepack": "node scripts/prepack.mjs",
|
|
60
60
|
"check:reachability": "node scripts/check-module-reachability.mjs",
|
|
61
|
+
"check:orphan-matrix": "node scripts/check-standards-orphan-matrix.mjs",
|
|
62
|
+
"check:plugin-manifest": "node scripts/check-plugin-manifest.mjs",
|
|
61
63
|
"check:command-existence": "node scripts/check-command-existence.mjs",
|
|
62
64
|
"check:effect-boundary": "node scripts/check-effect-boundary.mjs",
|
|
63
65
|
"check:effect-boundary:self-test": "node scripts/check-effect-boundary.mjs --self-test"
|
|
@@ -73,8 +75,8 @@
|
|
|
73
75
|
"devDependencies": {
|
|
74
76
|
"@eslint/js": "^10.0.1",
|
|
75
77
|
"@vitest/coverage-v8": "^5.0.0",
|
|
76
|
-
"eslint": "10.
|
|
77
|
-
"globals": "17.
|
|
78
|
+
"eslint": "10.12.0",
|
|
79
|
+
"globals": "17.13.0",
|
|
78
80
|
"husky": "^9.1.7",
|
|
79
81
|
"lint-staged": "^17.0.3",
|
|
80
82
|
"vite": "^8.3.0",
|