phasegate 0.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (875) hide show
  1. package/CHANGELOG.md +107 -0
  2. package/LICENSE +215 -0
  3. package/README.ja.md +888 -0
  4. package/README.md +254 -0
  5. package/bin/harness +18 -0
  6. package/docs/ADR/ADR-001-four-layer-defense-model.md +34 -0
  7. package/docs/ADR/ADR-002-pre-commit-validators.md +35 -0
  8. package/docs/ADR/ADR-003-ci-validators.md +36 -0
  9. package/docs/ADR/ADR-004-scheduled-validators.md +35 -0
  10. package/docs/ADR/ADR-005-hexagonal-architecture.md +39 -0
  11. package/docs/ADR/ADR-006-agent-independence.md +34 -0
  12. package/docs/ADR/ADR-007-harness-config-single-source.md +39 -0
  13. package/docs/ADR/ADR-008-quick-mode.md +46 -0
  14. package/docs/ADR/ADR-009-ddd-tactical-patterns.md +40 -0
  15. package/docs/ADR/ADR-010-harness-error-fix-example.md +42 -0
  16. package/docs/ADR/ADR-011-archgate-pattern.md +62 -0
  17. package/docs/ADR/ADR-012-two-phase-execution.md +38 -0
  18. package/docs/guide/cli-reference.md +122 -0
  19. package/docs/guide/configuration.md +199 -0
  20. package/docs/guide/hooks-integration.md +105 -0
  21. package/docs/guide/installation.md +84 -0
  22. package/docs/guide/layer-model.md +170 -0
  23. package/docs/guide/skills-overview.md +107 -0
  24. package/docs/principles/architecture-philosophy.md +64 -0
  25. package/docs/principles/model-routing.md +176 -0
  26. package/docs/principles/testing-rules.md +670 -0
  27. package/package.json +72 -0
  28. package/scripts/harness/adr-foundation/application/dto/adr-detail-dto.ts +30 -0
  29. package/scripts/harness/adr-foundation/application/dto/adr-list-item-dto.ts +12 -0
  30. package/scripts/harness/adr-foundation/application/dto/adr-list-summary-dto.ts +11 -0
  31. package/scripts/harness/adr-foundation/application/dto/adr-template-dto.ts +21 -0
  32. package/scripts/harness/adr-foundation/application/dto/adr-validation-result-dto.ts +27 -0
  33. package/scripts/harness/adr-foundation/application/dto/application-errors.ts +59 -0
  34. package/scripts/harness/adr-foundation/application/dto/archgate-search-result-dto.ts +11 -0
  35. package/scripts/harness/adr-foundation/application/dto/change-adr-status-command.ts +9 -0
  36. package/scripts/harness/adr-foundation/application/dto/seed-adr-definition.ts +21 -0
  37. package/scripts/harness/adr-foundation/application/mappers/adr-to-detail-dto-mapper.ts +41 -0
  38. package/scripts/harness/adr-foundation/application/mappers/adr-to-list-item-dto-mapper.ts +19 -0
  39. package/scripts/harness/adr-foundation/application/mappers/adr-validation-to-harness-error-mapper.ts +31 -0
  40. package/scripts/harness/adr-foundation/application/usecases/change-adr-status-use-case.ts +67 -0
  41. package/scripts/harness/adr-foundation/application/usecases/create-adr-template-use-case.ts +97 -0
  42. package/scripts/harness/adr-foundation/application/usecases/get-adr-by-ref-use-case.ts +26 -0
  43. package/scripts/harness/adr-foundation/application/usecases/list-adrs-use-case.ts +39 -0
  44. package/scripts/harness/adr-foundation/application/usecases/search-archgate-mappings-use-case.ts +55 -0
  45. package/scripts/harness/adr-foundation/application/usecases/seed-initial-adrs-use-case.ts +84 -0
  46. package/scripts/harness/adr-foundation/application/usecases/validate-adr-frontmatter-use-case.ts +86 -0
  47. package/scripts/harness/adr-foundation/application/usecases/validate-all-adrs-use-case.ts +47 -0
  48. package/scripts/harness/adr-foundation/composition-root.ts +47 -0
  49. package/scripts/harness/adr-foundation/domain/aggregates/adr.ts +177 -0
  50. package/scripts/harness/adr-foundation/domain/ports/adr-document-parser-port.ts +11 -0
  51. package/scripts/harness/adr-foundation/domain/ports/adr-frontmatter-parser-port.ts +6 -0
  52. package/scripts/harness/adr-foundation/domain/ports/adr-repository-port.ts +15 -0
  53. package/scripts/harness/adr-foundation/domain/services/adr-validation-service.ts +27 -0
  54. package/scripts/harness/adr-foundation/domain/value-objects/adr-body.ts +90 -0
  55. package/scripts/harness/adr-foundation/domain/value-objects/adr-file-path.ts +60 -0
  56. package/scripts/harness/adr-foundation/domain/value-objects/adr-frontmatter.ts +236 -0
  57. package/scripts/harness/adr-foundation/domain/value-objects/adr-id.ts +57 -0
  58. package/scripts/harness/adr-foundation/domain/value-objects/adr-status.ts +65 -0
  59. package/scripts/harness/adr-foundation/domain/value-objects/archgate-entry.ts +69 -0
  60. package/scripts/harness/adr-foundation/domain/value-objects/archgate-mapping.ts +94 -0
  61. package/scripts/harness/adr-foundation/domain/value-objects/superseded-by-ref.ts +26 -0
  62. package/scripts/harness/adr-foundation/index.ts +13 -0
  63. package/scripts/harness/adr-foundation/infrastructure/parsers/adr-markdown-document-parser.ts +121 -0
  64. package/scripts/harness/adr-foundation/infrastructure/parsers/regex-adr-frontmatter-parser.ts +147 -0
  65. package/scripts/harness/adr-foundation/infrastructure/repositories/file-system-adr-repository.ts +115 -0
  66. package/scripts/harness/adr-foundation/infrastructure/seeds/initial-adr-definitions.ts +161 -0
  67. package/scripts/harness/adr-foundation/infrastructure/serializers/adr-markdown-serializer.ts +41 -0
  68. package/scripts/harness/adr-foundation/presentation/cli/list-adrs-command-handler.ts +78 -0
  69. package/scripts/harness/adr-foundation/presentation/cli/validate-adr-command-handler.ts +113 -0
  70. package/scripts/harness/agent-integration/application/dto/handle-post-tool-use-dto.ts +24 -0
  71. package/scripts/harness/agent-integration/application/dto/handle-pre-tool-use-dto.ts +18 -0
  72. package/scripts/harness/agent-integration/application/dto/handle-stop-dto.ts +17 -0
  73. package/scripts/harness/agent-integration/application/dto/verify-fallback-capability-dto.ts +18 -0
  74. package/scripts/harness/agent-integration/application/usecases/handle-post-tool-use-usecase.ts +72 -0
  75. package/scripts/harness/agent-integration/application/usecases/handle-pre-tool-use-usecase.ts +164 -0
  76. package/scripts/harness/agent-integration/application/usecases/handle-stop-usecase.ts +81 -0
  77. package/scripts/harness/agent-integration/application/usecases/verify-fallback-capability-usecase.ts +52 -0
  78. package/scripts/harness/agent-integration/domain/entities/reentry-guard.ts +34 -0
  79. package/scripts/harness/agent-integration/domain/errors/project-paths-invariant-error.ts +10 -0
  80. package/scripts/harness/agent-integration/domain/errors/write-target-scope-invariant-error.ts +10 -0
  81. package/scripts/harness/agent-integration/domain/ports/cli-command-registry-port.ts +9 -0
  82. package/scripts/harness/agent-integration/domain/ports/config-query-port.ts +12 -0
  83. package/scripts/harness/agent-integration/domain/ports/import-analyzer-port.ts +13 -0
  84. package/scripts/harness/agent-integration/domain/ports/phase-gate-query-port.ts +9 -0
  85. package/scripts/harness/agent-integration/domain/ports/reentry-guard-state-port.ts +10 -0
  86. package/scripts/harness/agent-integration/domain/services/fallback-verification-service.ts +142 -0
  87. package/scripts/harness/agent-integration/domain/services/hook-to-cli-translator.ts +300 -0
  88. package/scripts/harness/agent-integration/domain/types/phase-gate-level.ts +4 -0
  89. package/scripts/harness/agent-integration/domain/value-objects/fallback-capability-spec.ts +53 -0
  90. package/scripts/harness/agent-integration/domain/value-objects/hook-event.ts +134 -0
  91. package/scripts/harness/agent-integration/domain/value-objects/hook-translation-result.ts +128 -0
  92. package/scripts/harness/agent-integration/domain/value-objects/phase-gate-query-result.ts +67 -0
  93. package/scripts/harness/agent-integration/domain/value-objects/project-paths.ts +53 -0
  94. package/scripts/harness/agent-integration/domain/value-objects/protected-file-list.ts +89 -0
  95. package/scripts/harness/agent-integration/domain/value-objects/write-target-scope.ts +148 -0
  96. package/scripts/harness/agent-integration/index.ts +42 -0
  97. package/scripts/harness/agent-integration/infrastructure/adapters/child-process-cli-executor-adapter.ts +92 -0
  98. package/scripts/harness/agent-integration/infrastructure/adapters/env-file-reentry-guard-state-adapter.ts +67 -0
  99. package/scripts/harness/agent-integration/infrastructure/adapters/harness-api-cli-command-registry-adapter.ts +35 -0
  100. package/scripts/harness/agent-integration/infrastructure/adapters/harness-config-config-query-adapter.ts +92 -0
  101. package/scripts/harness/agent-integration/infrastructure/adapters/phase-gate-query-adapter.ts +32 -0
  102. package/scripts/harness/agent-integration/infrastructure/adapters/regex-import-analyzer-adapter.ts +69 -0
  103. package/scripts/harness/agent-integration/infrastructure/ports/cli-executor-port.ts +29 -0
  104. package/scripts/harness/agent-integration/presentation/post-tool-use-hook.ts +104 -0
  105. package/scripts/harness/agent-integration/presentation/pre-tool-use-hook.ts +119 -0
  106. package/scripts/harness/agent-integration/presentation/stop-hook.ts +106 -0
  107. package/scripts/harness/biome-ast-engine/application/dto/analyze-import-graph-input.ts +8 -0
  108. package/scripts/harness/biome-ast-engine/application/dto/analyze-import-graph-output.ts +14 -0
  109. package/scripts/harness/biome-ast-engine/application/dto/build-harness-error-payload-input.ts +10 -0
  110. package/scripts/harness/biome-ast-engine/application/dto/build-harness-error-payload-output.ts +17 -0
  111. package/scripts/harness/biome-ast-engine/application/dto/execute-lint-input.ts +9 -0
  112. package/scripts/harness/biome-ast-engine/application/dto/execute-lint-output.ts +12 -0
  113. package/scripts/harness/biome-ast-engine/application/dto/register-rule-catalog-output.ts +10 -0
  114. package/scripts/harness/biome-ast-engine/application/dto/resolve-enabled-rules-input.ts +8 -0
  115. package/scripts/harness/biome-ast-engine/application/dto/resolve-enabled-rules-output.ts +12 -0
  116. package/scripts/harness/biome-ast-engine/application/dto/verify-eslint-removal-input.ts +8 -0
  117. package/scripts/harness/biome-ast-engine/application/dto/verify-eslint-removal-output.ts +10 -0
  118. package/scripts/harness/biome-ast-engine/application/mappers/analyze-import-graph-output-mapper.ts +20 -0
  119. package/scripts/harness/biome-ast-engine/application/mappers/build-harness-error-payload-output-mapper.ts +55 -0
  120. package/scripts/harness/biome-ast-engine/application/mappers/execute-lint-output-mapper.ts +17 -0
  121. package/scripts/harness/biome-ast-engine/application/mappers/register-rule-catalog-output-mapper.ts +14 -0
  122. package/scripts/harness/biome-ast-engine/application/mappers/resolve-enabled-rules-output-mapper.ts +17 -0
  123. package/scripts/harness/biome-ast-engine/application/mappers/verify-eslint-removal-output-mapper.ts +16 -0
  124. package/scripts/harness/biome-ast-engine/application/usecases/analyze-import-graph-usecase.ts +41 -0
  125. package/scripts/harness/biome-ast-engine/application/usecases/build-harness-error-payload-usecase.ts +51 -0
  126. package/scripts/harness/biome-ast-engine/application/usecases/execute-lint-usecase.ts +75 -0
  127. package/scripts/harness/biome-ast-engine/application/usecases/register-rule-catalog-usecase.ts +33 -0
  128. package/scripts/harness/biome-ast-engine/application/usecases/resolve-enabled-rules-usecase.ts +43 -0
  129. package/scripts/harness/biome-ast-engine/application/usecases/verify-eslint-removal-usecase.ts +49 -0
  130. package/scripts/harness/biome-ast-engine/composition-root.ts +91 -0
  131. package/scripts/harness/biome-ast-engine/domain/ports/biome-executor-port.ts +10 -0
  132. package/scripts/harness/biome-ast-engine/domain/ports/clock-port.ts +8 -0
  133. package/scripts/harness/biome-ast-engine/domain/ports/rule-config-provider-port.ts +11 -0
  134. package/scripts/harness/biome-ast-engine/domain/ports/source-module-analyzer-port.ts +11 -0
  135. package/scripts/harness/biome-ast-engine/domain/ports/violation-formatter-port.ts +19 -0
  136. package/scripts/harness/biome-ast-engine/domain/ports/workspace-file-port.ts +12 -0
  137. package/scripts/harness/biome-ast-engine/domain/ports/workspace-inventory-port.ts +11 -0
  138. package/scripts/harness/biome-ast-engine/domain/services/import-graph-builder.ts +37 -0
  139. package/scripts/harness/biome-ast-engine/domain/services/lint-runner.ts +266 -0
  140. package/scripts/harness/biome-ast-engine/domain/services/rule-definition-registry.ts +204 -0
  141. package/scripts/harness/biome-ast-engine/domain/value-objects/file-path.ts +101 -0
  142. package/scripts/harness/biome-ast-engine/domain/value-objects/import-cycle.ts +39 -0
  143. package/scripts/harness/biome-ast-engine/domain/value-objects/import-edge.ts +59 -0
  144. package/scripts/harness/biome-ast-engine/domain/value-objects/import-graph.ts +217 -0
  145. package/scripts/harness/biome-ast-engine/domain/value-objects/layer-boundary.ts +58 -0
  146. package/scripts/harness/biome-ast-engine/domain/value-objects/layer-name.ts +67 -0
  147. package/scripts/harness/biome-ast-engine/domain/value-objects/lint-report.ts +67 -0
  148. package/scripts/harness/biome-ast-engine/domain/value-objects/required-input.ts +48 -0
  149. package/scripts/harness/biome-ast-engine/domain/value-objects/rule-definition.ts +133 -0
  150. package/scripts/harness/biome-ast-engine/domain/value-objects/rule-name.ts +71 -0
  151. package/scripts/harness/biome-ast-engine/domain/value-objects/rule-type.ts +47 -0
  152. package/scripts/harness/biome-ast-engine/domain/value-objects/rule-violation.ts +118 -0
  153. package/scripts/harness/biome-ast-engine/domain/value-objects/source-module-snapshot.ts +133 -0
  154. package/scripts/harness/biome-ast-engine/index.ts +12 -0
  155. package/scripts/harness/biome-ast-engine/infrastructure/adapters/biome-cli-executor-adapter.ts +62 -0
  156. package/scripts/harness/biome-ast-engine/infrastructure/adapters/harness-config-provider-adapter.ts +38 -0
  157. package/scripts/harness/biome-ast-engine/infrastructure/adapters/harness-error-formatter-adapter.ts +67 -0
  158. package/scripts/harness/biome-ast-engine/infrastructure/adapters/node-workspace-file-adapter.ts +110 -0
  159. package/scripts/harness/biome-ast-engine/infrastructure/adapters/system-clock-adapter.ts +16 -0
  160. package/scripts/harness/biome-ast-engine/infrastructure/adapters/typescript-source-module-analyzer-adapter.ts +235 -0
  161. package/scripts/harness/biome-ast-engine/infrastructure/adapters/workspace-inventory-adapter.ts +98 -0
  162. package/scripts/harness/biome-ast-engine/infrastructure/mappers/rule-violation-code-mapper.ts +50 -0
  163. package/scripts/harness/biome-ast-engine/infrastructure/mappers/source-module-snapshot-mapper.ts +66 -0
  164. package/scripts/harness/biome-ast-engine/infrastructure/parsers/comment-density-parser.ts +109 -0
  165. package/scripts/harness/biome-ast-engine/infrastructure/parsers/layer-comment-parser.ts +26 -0
  166. package/scripts/harness/biome-ast-engine/infrastructure/parsers/unit-comment-parser.ts +26 -0
  167. package/scripts/harness/biome-ast-engine/presentation/cli/harness-lint-command-handler.ts +129 -0
  168. package/scripts/harness/biome-ast-engine/presentation/cli/lint-command-parser.ts +48 -0
  169. package/scripts/harness/ci-governance/application/dto/aggregate-lessons-input.ts +8 -0
  170. package/scripts/harness/ci-governance/application/dto/aggregate-lessons-output.ts +10 -0
  171. package/scripts/harness/ci-governance/application/dto/check-escalation-input.ts +8 -0
  172. package/scripts/harness/ci-governance/application/dto/check-escalation-output.ts +10 -0
  173. package/scripts/harness/ci-governance/application/dto/generate-ci-template-input.ts +11 -0
  174. package/scripts/harness/ci-governance/application/dto/generate-ci-template-output.ts +16 -0
  175. package/scripts/harness/ci-governance/application/dto/migrate-agents-md-input.ts +8 -0
  176. package/scripts/harness/ci-governance/application/dto/migrate-agents-md-output.ts +13 -0
  177. package/scripts/harness/ci-governance/application/dto/record-error-occurrence-input.ts +9 -0
  178. package/scripts/harness/ci-governance/application/dto/record-error-occurrence-output.ts +10 -0
  179. package/scripts/harness/ci-governance/application/dto/render-ci-template-input.ts +11 -0
  180. package/scripts/harness/ci-governance/application/dto/render-ci-template-output.ts +10 -0
  181. package/scripts/harness/ci-governance/application/dto/reset-repetition-input.ts +9 -0
  182. package/scripts/harness/ci-governance/application/dto/reset-repetition-output.ts +9 -0
  183. package/scripts/harness/ci-governance/application/dto/validate-pointers-input.ts +8 -0
  184. package/scripts/harness/ci-governance/application/dto/validate-pointers-output.ts +13 -0
  185. package/scripts/harness/ci-governance/application/usecases/aggregate-lessons-usecase.ts +52 -0
  186. package/scripts/harness/ci-governance/application/usecases/check-escalation-usecase.ts +34 -0
  187. package/scripts/harness/ci-governance/application/usecases/generate-ci-template-usecase.ts +60 -0
  188. package/scripts/harness/ci-governance/application/usecases/migrate-agents-md-usecase.ts +94 -0
  189. package/scripts/harness/ci-governance/application/usecases/record-error-occurrence-usecase.ts +42 -0
  190. package/scripts/harness/ci-governance/application/usecases/render-ci-template-usecase.ts +62 -0
  191. package/scripts/harness/ci-governance/application/usecases/reset-repetition-usecase.ts +64 -0
  192. package/scripts/harness/ci-governance/application/usecases/validate-pointers-usecase.ts +62 -0
  193. package/scripts/harness/ci-governance/composition-root.ts +100 -0
  194. package/scripts/harness/ci-governance/domain/aggregates/agents-md-pointer.ts +96 -0
  195. package/scripts/harness/ci-governance/domain/aggregates/ci-template.ts +75 -0
  196. package/scripts/harness/ci-governance/domain/aggregates/error-repetition.ts +138 -0
  197. package/scripts/harness/ci-governance/domain/errors/ci-governance-domain-error.ts +16 -0
  198. package/scripts/harness/ci-governance/domain/ports/adr-existence-port.ts +8 -0
  199. package/scripts/harness/ci-governance/domain/ports/agents-md-port.ts +16 -0
  200. package/scripts/harness/ci-governance/domain/ports/command-existence-port.ts +8 -0
  201. package/scripts/harness/ci-governance/domain/ports/error-repetition-repository-port.ts +11 -0
  202. package/scripts/harness/ci-governance/domain/ports/escalation-executor-port.ts +10 -0
  203. package/scripts/harness/ci-governance/domain/ports/file-existence-port.ts +8 -0
  204. package/scripts/harness/ci-governance/domain/ports/lesson-artifact-reader-port.ts +11 -0
  205. package/scripts/harness/ci-governance/domain/ports/preset-config-port.ts +12 -0
  206. package/scripts/harness/ci-governance/domain/ports/template-renderer-port.ts +15 -0
  207. package/scripts/harness/ci-governance/domain/ports/validator-id-registry-port.ts +8 -0
  208. package/scripts/harness/ci-governance/domain/result.ts +58 -0
  209. package/scripts/harness/ci-governance/domain/services/lesson-aggregator.ts +46 -0
  210. package/scripts/harness/ci-governance/domain/services/pointer-validator.ts +71 -0
  211. package/scripts/harness/ci-governance/domain/services/repetition-detector.ts +51 -0
  212. package/scripts/harness/ci-governance/domain/services/template-generator.ts +67 -0
  213. package/scripts/harness/ci-governance/domain/types/escalation-log-level.ts +17 -0
  214. package/scripts/harness/ci-governance/domain/types/lesson-artifact.ts +25 -0
  215. package/scripts/harness/ci-governance/domain/types/lesson-category.ts +8 -0
  216. package/scripts/harness/ci-governance/domain/types/pointer-type.ts +24 -0
  217. package/scripts/harness/ci-governance/domain/types/template-type.ts +18 -0
  218. package/scripts/harness/ci-governance/domain/types/trigger-condition.ts +18 -0
  219. package/scripts/harness/ci-governance/domain/value-objects/escalation-action.ts +44 -0
  220. package/scripts/harness/ci-governance/domain/value-objects/pointer-entry.ts +80 -0
  221. package/scripts/harness/ci-governance/domain/value-objects/repetition-reset-condition.ts +30 -0
  222. package/scripts/harness/ci-governance/domain/value-objects/template-config.ts +46 -0
  223. package/scripts/harness/ci-governance/infrastructure/adapters/adr-foundation-existence-adapter.ts +16 -0
  224. package/scripts/harness/ci-governance/infrastructure/adapters/agents-md-file-adapter.ts +109 -0
  225. package/scripts/harness/ci-governance/infrastructure/adapters/error-repetition-json-repository.ts +73 -0
  226. package/scripts/harness/ci-governance/infrastructure/adapters/escalation-log-executor-adapter.ts +20 -0
  227. package/scripts/harness/ci-governance/infrastructure/adapters/file-system-existence-adapter.ts +26 -0
  228. package/scripts/harness/ci-governance/infrastructure/adapters/harness-api-command-existence-adapter.ts +20 -0
  229. package/scripts/harness/ci-governance/infrastructure/adapters/lesson-artifact-file-reader-adapter.ts +48 -0
  230. package/scripts/harness/ci-governance/infrastructure/adapters/preset-config-adapter.ts +24 -0
  231. package/scripts/harness/ci-governance/infrastructure/adapters/validator-id-registry-adapter.ts +18 -0
  232. package/scripts/harness/ci-governance/infrastructure/adapters/yaml-template-renderer-adapter.ts +53 -0
  233. package/scripts/harness/ci-governance/infrastructure/schema/error-history-schema.ts +18 -0
  234. package/scripts/harness/ci-governance/presentation/dto/ci-governance-render-options.ts +9 -0
  235. package/scripts/harness/ci-governance/presentation/formatters/ci-template-formatter.ts +32 -0
  236. package/scripts/harness/ci-governance/presentation/formatters/error-repetition-formatter.ts +26 -0
  237. package/scripts/harness/ci-governance/presentation/handlers/check-repetition-handler.ts +68 -0
  238. package/scripts/harness/ci-governance/presentation/handlers/generate-ci-template-handler.ts +51 -0
  239. package/scripts/harness/ci-governance/presentation/handlers/migrate-agents-md-handler.ts +68 -0
  240. package/scripts/harness/config-foundation/application/dto/available-feature-item.ts +8 -0
  241. package/scripts/harness/config-foundation/application/dto/feature-toggle-result.ts +9 -0
  242. package/scripts/harness/config-foundation/application/dto/resolved-config-output.ts +10 -0
  243. package/scripts/harness/config-foundation/application/dto/validate-config-result.ts +10 -0
  244. package/scripts/harness/config-foundation/application/facades/load-config-facade.ts +28 -0
  245. package/scripts/harness/config-foundation/application/usecases/disable-feature-use-case.ts +71 -0
  246. package/scripts/harness/config-foundation/application/usecases/enable-feature-use-case.ts +71 -0
  247. package/scripts/harness/config-foundation/application/usecases/list-available-features-use-case.ts +61 -0
  248. package/scripts/harness/config-foundation/application/usecases/load-resolved-config-use-case.ts +131 -0
  249. package/scripts/harness/config-foundation/application/usecases/validate-config-use-case.ts +98 -0
  250. package/scripts/harness/config-foundation/composition-root.ts +76 -0
  251. package/scripts/harness/config-foundation/domain/errors/config-foundation-domain-error.ts +16 -0
  252. package/scripts/harness/config-foundation/domain/errors/config-validation-error.ts +14 -0
  253. package/scripts/harness/config-foundation/domain/errors/invalid-harnesses-config-error.ts +14 -0
  254. package/scripts/harness/config-foundation/domain/errors/invalid-preset-error.ts +17 -0
  255. package/scripts/harness/config-foundation/domain/errors/unsupported-feature-error.ts +14 -0
  256. package/scripts/harness/config-foundation/domain/harness-config.ts +373 -0
  257. package/scripts/harness/config-foundation/domain/ports/config-repository-port.ts +8 -0
  258. package/scripts/harness/config-foundation/domain/ports/config-schema-validator-port.ts +9 -0
  259. package/scripts/harness/config-foundation/domain/ports/feature-registry-port.ts +7 -0
  260. package/scripts/harness/config-foundation/domain/services/feature-registry.ts +42 -0
  261. package/scripts/harness/config-foundation/domain/services/preset-resolution-service.ts +197 -0
  262. package/scripts/harness/config-foundation/domain/value-objects/custom-phase-rule.ts +42 -0
  263. package/scripts/harness/config-foundation/domain/value-objects/feature-name.ts +39 -0
  264. package/scripts/harness/config-foundation/domain/value-objects/feature-toggle.ts +34 -0
  265. package/scripts/harness/config-foundation/domain/value-objects/harnesses-config.ts +113 -0
  266. package/scripts/harness/config-foundation/domain/value-objects/l1-config.ts +57 -0
  267. package/scripts/harness/config-foundation/domain/value-objects/l2-config.ts +46 -0
  268. package/scripts/harness/config-foundation/domain/value-objects/l3-config.ts +64 -0
  269. package/scripts/harness/config-foundation/domain/value-objects/l4-config.ts +55 -0
  270. package/scripts/harness/config-foundation/domain/value-objects/layers-config.ts +86 -0
  271. package/scripts/harness/config-foundation/domain/value-objects/paths-config.ts +50 -0
  272. package/scripts/harness/config-foundation/domain/value-objects/phase-dependencies-config.ts +46 -0
  273. package/scripts/harness/config-foundation/domain/value-objects/planning-mode-config.ts +65 -0
  274. package/scripts/harness/config-foundation/domain/value-objects/preset.ts +42 -0
  275. package/scripts/harness/config-foundation/domain/value-objects/project-config.ts +44 -0
  276. package/scripts/harness/config-foundation/domain/value-objects/quick-mode-config.ts +64 -0
  277. package/scripts/harness/config-foundation/domain/value-objects/reporting-config.ts +40 -0
  278. package/scripts/harness/config-foundation/index.ts +26 -0
  279. package/scripts/harness/config-foundation/infrastructure/preset-definition-store.ts +28 -0
  280. package/scripts/harness/config-foundation/infrastructure/presets/minimal.json +50 -0
  281. package/scripts/harness/config-foundation/infrastructure/presets/standard.json +50 -0
  282. package/scripts/harness/config-foundation/infrastructure/presets/strict.json +50 -0
  283. package/scripts/harness/config-foundation/infrastructure/registries/composite-feature-registry-adapter.ts +22 -0
  284. package/scripts/harness/config-foundation/infrastructure/registries/static-feature-registry-adapter.ts +18 -0
  285. package/scripts/harness/config-foundation/infrastructure/repositories/file-system-config-repository.ts +106 -0
  286. package/scripts/harness/config-foundation/infrastructure/schemas/harness-config-v2.schema.json +254 -0
  287. package/scripts/harness/config-foundation/infrastructure/validators/ajv-config-schema-validator.ts +114 -0
  288. package/scripts/harness/config-foundation/presentation/cli/disable-feature-command-handler.ts +93 -0
  289. package/scripts/harness/config-foundation/presentation/cli/enable-feature-command-handler.ts +93 -0
  290. package/scripts/harness/harness-api/application/dto/command-dispatch-input.ts +7 -0
  291. package/scripts/harness/harness-api/application/dto/command-dispatch-output.ts +9 -0
  292. package/scripts/harness/harness-api/application/dto/exit-code-decision-input.ts +8 -0
  293. package/scripts/harness/harness-api/application/dto/exit-code-decision-output.ts +8 -0
  294. package/scripts/harness/harness-api/application/dto/harness-api-response-contract.ts +10 -0
  295. package/scripts/harness/harness-api/application/dto/initialize-registry-input.ts +11 -0
  296. package/scripts/harness/harness-api/application/dto/registry-summary-output.ts +9 -0
  297. package/scripts/harness/harness-api/application/dto/status-derivation-input.ts +6 -0
  298. package/scripts/harness/harness-api/application/mappers/harness-api-response-mapper.ts +16 -0
  299. package/scripts/harness/harness-api/application/usecases/decide-exit-code-usecase.ts +27 -0
  300. package/scripts/harness/harness-api/application/usecases/derive-harness-status-usecase.ts +72 -0
  301. package/scripts/harness/harness-api/application/usecases/dispatch-command-usecase.ts +79 -0
  302. package/scripts/harness/harness-api/application/usecases/initialize-command-registry-usecase.ts +43 -0
  303. package/scripts/harness/harness-api/composition-root.ts +96 -0
  304. package/scripts/harness/harness-api/domain/ports/artifact-scanner-port.ts +7 -0
  305. package/scripts/harness/harness-api/domain/ports/biome-lint-port.ts +11 -0
  306. package/scripts/harness/harness-api/domain/ports/config-query-port.ts +9 -0
  307. package/scripts/harness/harness-api/domain/ports/impact-analysis-port.ts +12 -0
  308. package/scripts/harness/harness-api/domain/ports/phase-gate-query-port.ts +9 -0
  309. package/scripts/harness/harness-api/domain/ports/validator-execution-port.ts +10 -0
  310. package/scripts/harness/harness-api/domain/services/command-dispatch-service.ts +230 -0
  311. package/scripts/harness/harness-api/domain/services/command-registry.ts +44 -0
  312. package/scripts/harness/harness-api/domain/services/status-derivation-service.ts +121 -0
  313. package/scripts/harness/harness-api/domain/value-objects/artifact-scan-result.ts +35 -0
  314. package/scripts/harness/harness-api/domain/value-objects/check-ready-result.ts +42 -0
  315. package/scripts/harness/harness-api/domain/value-objects/ci-check-result.ts +56 -0
  316. package/scripts/harness/harness-api/domain/value-objects/cli-command-definition.ts +99 -0
  317. package/scripts/harness/harness-api/domain/value-objects/command-input-spec.ts +39 -0
  318. package/scripts/harness/harness-api/domain/value-objects/drift-report-summary.ts +46 -0
  319. package/scripts/harness/harness-api/domain/value-objects/exit-code-spec.ts +29 -0
  320. package/scripts/harness/harness-api/domain/value-objects/harness-api-response.ts +91 -0
  321. package/scripts/harness/harness-api/domain/value-objects/harness-status-summary.ts +73 -0
  322. package/scripts/harness/harness-api/domain/value-objects/layer-health.ts +44 -0
  323. package/scripts/harness/harness-api/domain/value-objects/phase-info.ts +37 -0
  324. package/scripts/harness/harness-api/index.ts +29 -0
  325. package/scripts/harness/harness-api/infrastructure/adapters/biome-ast-engine-lint-adapter.ts +84 -0
  326. package/scripts/harness/harness-api/infrastructure/adapters/file-system-artifact-scanner-adapter.ts +131 -0
  327. package/scripts/harness/harness-api/infrastructure/adapters/harness-config-query-adapter.ts +66 -0
  328. package/scripts/harness/harness-api/infrastructure/adapters/nyquist-validation-impact-analysis-adapter.ts +61 -0
  329. package/scripts/harness/harness-api/infrastructure/adapters/phase-dependency-model-query-adapter.ts +86 -0
  330. package/scripts/harness/harness-api/infrastructure/adapters/validator-system-execution-adapter.ts +74 -0
  331. package/scripts/harness/harness-api/presentation/dto/cli-output-options.ts +7 -0
  332. package/scripts/harness/harness-api/presentation/formatters/harness-api-json-formatter.ts +13 -0
  333. package/scripts/harness/harness-api/presentation/handlers/check-phase-handler.ts +42 -0
  334. package/scripts/harness/harness-api/presentation/handlers/check-ready-handler.ts +29 -0
  335. package/scripts/harness/harness-api/presentation/handlers/ci-check-handler.ts +29 -0
  336. package/scripts/harness/harness-api/presentation/handlers/complete-check-handler.ts +29 -0
  337. package/scripts/harness/harness-api/presentation/handlers/detect-drift-handler.ts +29 -0
  338. package/scripts/harness/harness-api/presentation/handlers/impact-analysis-handler.ts +45 -0
  339. package/scripts/harness/harness-api/presentation/handlers/lint-handler.ts +29 -0
  340. package/scripts/harness/harness-api/presentation/handlers/status-handler.ts +38 -0
  341. package/scripts/harness/harness-error/application/dto/create-harness-error-input.ts +15 -0
  342. package/scripts/harness/harness-error/application/dto/error-definition-summary.ts +15 -0
  343. package/scripts/harness/harness-error/application/dto/harness-error-contract.ts +14 -0
  344. package/scripts/harness/harness-error/application/dto/list-error-definitions-query.ts +11 -0
  345. package/scripts/harness/harness-error/application/dto/severity-contract-check-input.ts +10 -0
  346. package/scripts/harness/harness-error/application/dto/validate-fix-example-input.ts +10 -0
  347. package/scripts/harness/harness-error/application/dto/validate-fix-example-output.ts +12 -0
  348. package/scripts/harness/harness-error/application/dto/validator-issue-draft.ts +15 -0
  349. package/scripts/harness/harness-error/application/mappers/harness-error-contract-mapper.ts +27 -0
  350. package/scripts/harness/harness-error/application/usecases/assert-severity-contract-use-case.ts +51 -0
  351. package/scripts/harness/harness-error/application/usecases/create-harness-error-use-case.ts +41 -0
  352. package/scripts/harness/harness-error/application/usecases/list-error-definitions-use-case.ts +56 -0
  353. package/scripts/harness/harness-error/application/usecases/normalize-validator-errors-use-case.ts +62 -0
  354. package/scripts/harness/harness-error/application/usecases/validate-all-fix-examples-use-case.ts +83 -0
  355. package/scripts/harness/harness-error/application/usecases/validate-fix-example-use-case.ts +56 -0
  356. package/scripts/harness/harness-error/composition-root.ts +140 -0
  357. package/scripts/harness/harness-error/domain/errors/adr-reference-not-found-error.ts +16 -0
  358. package/scripts/harness/harness-error/domain/errors/duplicate-error-code-error.ts +16 -0
  359. package/scripts/harness/harness-error/domain/errors/empty-message-error.ts +14 -0
  360. package/scripts/harness/harness-error/domain/errors/empty-suggestion-error.ts +14 -0
  361. package/scripts/harness/harness-error/domain/errors/harness-error-domain-error.ts +13 -0
  362. package/scripts/harness/harness-error/domain/errors/invalid-adr-ref-error.ts +16 -0
  363. package/scripts/harness/harness-error/domain/errors/invalid-error-code-error.ts +16 -0
  364. package/scripts/harness/harness-error/domain/errors/invalid-error-definition-error.ts +14 -0
  365. package/scripts/harness/harness-error/domain/errors/invalid-fix-example-error.ts +14 -0
  366. package/scripts/harness/harness-error/domain/errors/invalid-fix-example-validation-result-error.ts +14 -0
  367. package/scripts/harness/harness-error/domain/errors/invalid-severity-error.ts +16 -0
  368. package/scripts/harness/harness-error/domain/errors/missing-adr-ref-error.ts +16 -0
  369. package/scripts/harness/harness-error/domain/errors/missing-fix-example-error.ts +16 -0
  370. package/scripts/harness/harness-error/domain/errors/severity-downgrade-violation-error.ts +16 -0
  371. package/scripts/harness/harness-error/domain/errors/unknown-error-definition-error.ts +16 -0
  372. package/scripts/harness/harness-error/domain/ports/adr-existence-checker-port.ts +12 -0
  373. package/scripts/harness/harness-error/domain/ports/fix-example-validator-port.ts +18 -0
  374. package/scripts/harness/harness-error/domain/services/error-definition-registry.ts +59 -0
  375. package/scripts/harness/harness-error/domain/services/harness-error-factory.ts +134 -0
  376. package/scripts/harness/harness-error/domain/services/severity-contract-enforcer.ts +37 -0
  377. package/scripts/harness/harness-error/domain/value-objects/adr-ref.ts +34 -0
  378. package/scripts/harness/harness-error/domain/value-objects/error-code.ts +41 -0
  379. package/scripts/harness/harness-error/domain/value-objects/error-definition.ts +128 -0
  380. package/scripts/harness/harness-error/domain/value-objects/fix-example-validation-result.ts +64 -0
  381. package/scripts/harness/harness-error/domain/value-objects/fix-example.ts +34 -0
  382. package/scripts/harness/harness-error/domain/value-objects/harness-error.ts +94 -0
  383. package/scripts/harness/harness-error/domain/value-objects/severity.ts +46 -0
  384. package/scripts/harness/harness-error/index.ts +16 -0
  385. package/scripts/harness/harness-error/infrastructure/adapters/file-system-adr-existence-checker-adapter.ts +46 -0
  386. package/scripts/harness/harness-error/infrastructure/adapters/legacy-error-reporter-adapter.ts +54 -0
  387. package/scripts/harness/harness-error/infrastructure/adapters/type-script-snippet-syntax-adapter.ts +59 -0
  388. package/scripts/harness/harness-error/infrastructure/adapters/validator-execution-fix-example-validator-adapter.ts +141 -0
  389. package/scripts/harness/harness-error/infrastructure/adapters/validator-registry-bridge-adapter.ts +101 -0
  390. package/scripts/harness/harness-error/infrastructure/registry/build-error-definition-registry.ts +40 -0
  391. package/scripts/harness/harness-error/infrastructure/registry/l1-error-definitions.ts +90 -0
  392. package/scripts/harness/harness-error/infrastructure/registry/l2-error-definitions.ts +56 -0
  393. package/scripts/harness/harness-error/infrastructure/registry/l3-error-definitions.ts +61 -0
  394. package/scripts/harness/harness-error/infrastructure/registry/l4-error-definitions.ts +53 -0
  395. package/scripts/harness/harness-error/presentation/formatters/agent-error-formatter.ts +54 -0
  396. package/scripts/harness/harness-error/presentation/formatters/ci-error-formatter.ts +27 -0
  397. package/scripts/harness/harness-error/presentation/formatters/human-error-formatter.ts +40 -0
  398. package/scripts/harness/harness-error/presentation/handlers/list-error-definitions-handler.ts +76 -0
  399. package/scripts/harness/harness-error/presentation/handlers/render-harness-errors-handler.ts +67 -0
  400. package/scripts/harness/harness-error/presentation/handlers/validate-fix-example-handler.ts +128 -0
  401. package/scripts/harness/integrations/pre-commit.ts +163 -0
  402. package/scripts/harness/main.ts +880 -0
  403. package/scripts/harness/nyquist-validation/application/dto/analyze-impact-input.ts +11 -0
  404. package/scripts/harness/nyquist-validation/application/dto/analyze-impact-output.ts +18 -0
  405. package/scripts/harness/nyquist-validation/application/dto/calculate-coverage-input.ts +11 -0
  406. package/scripts/harness/nyquist-validation/application/dto/calculate-coverage-output.ts +15 -0
  407. package/scripts/harness/nyquist-validation/application/dto/check-ac-coverage-gate-input.ts +10 -0
  408. package/scripts/harness/nyquist-validation/application/dto/check-ac-coverage-gate-output.ts +14 -0
  409. package/scripts/harness/nyquist-validation/application/dto/validate-matrix-input.ts +11 -0
  410. package/scripts/harness/nyquist-validation/application/dto/validate-matrix-output.ts +15 -0
  411. package/scripts/harness/nyquist-validation/application/mappers/coverage-result-mapper.ts +25 -0
  412. package/scripts/harness/nyquist-validation/application/mappers/impact-analysis-result-mapper.ts +22 -0
  413. package/scripts/harness/nyquist-validation/application/usecases/analyze-impact-usecase.ts +82 -0
  414. package/scripts/harness/nyquist-validation/application/usecases/calculate-coverage-usecase.ts +91 -0
  415. package/scripts/harness/nyquist-validation/application/usecases/check-ac-coverage-gate-usecase.ts +100 -0
  416. package/scripts/harness/nyquist-validation/application/usecases/validate-matrix-usecase.ts +69 -0
  417. package/scripts/harness/nyquist-validation/composition-root.ts +108 -0
  418. package/scripts/harness/nyquist-validation/domain/aggregates/requirement-test-matrix.ts +57 -0
  419. package/scripts/harness/nyquist-validation/domain/entities/story-mapping.ts +46 -0
  420. package/scripts/harness/nyquist-validation/domain/errors/duplicate-story-mapping-error.ts +14 -0
  421. package/scripts/harness/nyquist-validation/domain/errors/empty-file-path-error.ts +14 -0
  422. package/scripts/harness/nyquist-validation/domain/errors/invalid-ac-id-format-error.ts +14 -0
  423. package/scripts/harness/nyquist-validation/domain/errors/invalid-test-type-error.ts +14 -0
  424. package/scripts/harness/nyquist-validation/domain/errors/matrix-validation-failed-error.ts +14 -0
  425. package/scripts/harness/nyquist-validation/domain/errors/nyquist-domain-error.ts +14 -0
  426. package/scripts/harness/nyquist-validation/domain/errors/story-not-found-error.ts +14 -0
  427. package/scripts/harness/nyquist-validation/domain/ports/coverage-threshold-port.ts +16 -0
  428. package/scripts/harness/nyquist-validation/domain/ports/matrix-file-port.ts +11 -0
  429. package/scripts/harness/nyquist-validation/domain/ports/story-registry-port.ts +10 -0
  430. package/scripts/harness/nyquist-validation/domain/services/ac-coverage-gate-policy.ts +40 -0
  431. package/scripts/harness/nyquist-validation/domain/services/coverage-calculation-service.ts +37 -0
  432. package/scripts/harness/nyquist-validation/domain/services/impact-analysis-service.ts +27 -0
  433. package/scripts/harness/nyquist-validation/domain/services/matrix-validation-service.ts +71 -0
  434. package/scripts/harness/nyquist-validation/domain/value-objects/ac-mapping.ts +48 -0
  435. package/scripts/harness/nyquist-validation/domain/value-objects/coverage-result.ts +58 -0
  436. package/scripts/harness/nyquist-validation/domain/value-objects/impact-analysis-result.ts +48 -0
  437. package/scripts/harness/nyquist-validation/domain/value-objects/test-reference.ts +47 -0
  438. package/scripts/harness/nyquist-validation/index.ts +26 -0
  439. package/scripts/harness/nyquist-validation/infrastructure/adapters/ajv-json-schema-validator-adapter.ts +67 -0
  440. package/scripts/harness/nyquist-validation/infrastructure/adapters/config-foundation-coverage-threshold-adapter.ts +45 -0
  441. package/scripts/harness/nyquist-validation/infrastructure/adapters/file-system-matrix-file-adapter.ts +25 -0
  442. package/scripts/harness/nyquist-validation/infrastructure/adapters/traceability-model-story-registry-adapter.ts +25 -0
  443. package/scripts/harness/nyquist-validation/infrastructure/schema/matrix-schema-loader.ts +27 -0
  444. package/scripts/harness/nyquist-validation/presentation/dto/cli-render-options.ts +12 -0
  445. package/scripts/harness/nyquist-validation/presentation/formatters/agent-matrix-formatter.ts +84 -0
  446. package/scripts/harness/nyquist-validation/presentation/formatters/human-matrix-formatter.ts +69 -0
  447. package/scripts/harness/nyquist-validation/presentation/formatters/json-matrix-formatter.ts +28 -0
  448. package/scripts/harness/nyquist-validation/presentation/handlers/analyze-impact-handler.ts +58 -0
  449. package/scripts/harness/nyquist-validation/presentation/handlers/calculate-coverage-handler.ts +56 -0
  450. package/scripts/harness/nyquist-validation/presentation/handlers/check-ac-coverage-gate-handler.ts +56 -0
  451. package/scripts/harness/nyquist-validation/presentation/handlers/validate-matrix-handler.ts +58 -0
  452. package/scripts/harness/phase-dependency-model/application/dto/customization-validation-result-dto.ts +11 -0
  453. package/scripts/harness/phase-dependency-model/application/dto/phase-dependency-graph-dto.ts +22 -0
  454. package/scripts/harness/phase-dependency-model/application/dto/phase-gate-result-dto.ts +12 -0
  455. package/scripts/harness/phase-dependency-model/application/dto/phase-info-dto.ts +13 -0
  456. package/scripts/harness/phase-dependency-model/application/services/evidence-bundle-assembler.ts +71 -0
  457. package/scripts/harness/phase-dependency-model/application/services/phase-gate-result-mapper.ts +25 -0
  458. package/scripts/harness/phase-dependency-model/application/services/phase-info-resolver.ts +156 -0
  459. package/scripts/harness/phase-dependency-model/application/usecases/build-phase-dependency-graph-usecase.ts +55 -0
  460. package/scripts/harness/phase-dependency-model/application/usecases/check-phase-gate-usecase.ts +80 -0
  461. package/scripts/harness/phase-dependency-model/application/usecases/get-phase-info-usecase.ts +62 -0
  462. package/scripts/harness/phase-dependency-model/application/usecases/record-phase-override-audit-usecase.ts +53 -0
  463. package/scripts/harness/phase-dependency-model/application/usecases/validate-customization-policy-usecase.ts +62 -0
  464. package/scripts/harness/phase-dependency-model/composition-root.ts +76 -0
  465. package/scripts/harness/phase-dependency-model/domain/definitions/default-phase-dependencies.ts +48 -0
  466. package/scripts/harness/phase-dependency-model/domain/definitions/default-phase-nodes.ts +195 -0
  467. package/scripts/harness/phase-dependency-model/domain/models/phase-structure.ts +489 -0
  468. package/scripts/harness/phase-dependency-model/domain/ports/artifact-existence-checker-port.ts +13 -0
  469. package/scripts/harness/phase-dependency-model/domain/ports/phase-audit-logger-port.ts +14 -0
  470. package/scripts/harness/phase-dependency-model/domain/ports/phase-config-provider-port.ts +13 -0
  471. package/scripts/harness/phase-dependency-model/domain/ports/plan-document-reader-port.ts +16 -0
  472. package/scripts/harness/phase-dependency-model/domain/values/artifact.ts +89 -0
  473. package/scripts/harness/phase-dependency-model/domain/values/custom-rule.ts +64 -0
  474. package/scripts/harness/phase-dependency-model/domain/values/phase-customization-policy.ts +57 -0
  475. package/scripts/harness/phase-dependency-model/domain/values/phase-dependency.ts +62 -0
  476. package/scripts/harness/phase-dependency-model/domain/values/phase-gate-result.ts +71 -0
  477. package/scripts/harness/phase-dependency-model/domain/values/phase-level.ts +42 -0
  478. package/scripts/harness/phase-dependency-model/domain/values/phase-node.ts +72 -0
  479. package/scripts/harness/phase-dependency-model/domain/values/plan-evidence.ts +43 -0
  480. package/scripts/harness/phase-dependency-model/domain/values/planning-mode.ts +60 -0
  481. package/scripts/harness/phase-dependency-model/index.ts +13 -0
  482. package/scripts/harness/phase-dependency-model/infrastructure/config/harness-config-phase-config-provider.ts +98 -0
  483. package/scripts/harness/phase-dependency-model/infrastructure/filesystem/file-system-artifact-existence-checker.ts +54 -0
  484. package/scripts/harness/phase-dependency-model/infrastructure/filesystem/markdown-plan-document-reader.ts +134 -0
  485. package/scripts/harness/phase-dependency-model/infrastructure/logging/phase-override-audit-logger.ts +37 -0
  486. package/scripts/harness/phase-dependency-model/presentation/cli/check-phase-gate-command-handler.ts +95 -0
  487. package/scripts/harness/phase2-extensions/application/dto/check-doc-freshness-input.ts +9 -0
  488. package/scripts/harness/phase2-extensions/application/dto/check-doc-freshness-output.ts +17 -0
  489. package/scripts/harness/phase2-extensions/application/dto/generate-e2e-template-input.ts +9 -0
  490. package/scripts/harness/phase2-extensions/application/dto/generate-e2e-template-output.ts +13 -0
  491. package/scripts/harness/phase2-extensions/application/dto/validate-doc-pointers-input.ts +9 -0
  492. package/scripts/harness/phase2-extensions/application/dto/validate-doc-pointers-output.ts +25 -0
  493. package/scripts/harness/phase2-extensions/application/usecases/check-doc-freshness-usecase.ts +68 -0
  494. package/scripts/harness/phase2-extensions/application/usecases/generate-e2e-template-usecase.ts +39 -0
  495. package/scripts/harness/phase2-extensions/application/usecases/validate-doc-pointers-usecase.ts +98 -0
  496. package/scripts/harness/phase2-extensions/composition-root.ts +52 -0
  497. package/scripts/harness/phase2-extensions/domain/aggregates/doc-freshness-rule.ts +82 -0
  498. package/scripts/harness/phase2-extensions/domain/aggregates/pointer-rule.ts +38 -0
  499. package/scripts/harness/phase2-extensions/domain/errors/phase2-extensions-domain-error.ts +13 -0
  500. package/scripts/harness/phase2-extensions/domain/ports/document-age-port.ts +9 -0
  501. package/scripts/harness/phase2-extensions/domain/ports/document-scanner-port.ts +7 -0
  502. package/scripts/harness/phase2-extensions/domain/ports/freshness-config-port.ts +11 -0
  503. package/scripts/harness/phase2-extensions/domain/ports/pointer-extractor-port.ts +9 -0
  504. package/scripts/harness/phase2-extensions/domain/ports/pointer-resolver-port.ts +9 -0
  505. package/scripts/harness/phase2-extensions/domain/services/freshness-check-service.ts +46 -0
  506. package/scripts/harness/phase2-extensions/domain/services/pointer-resolution-service.ts +31 -0
  507. package/scripts/harness/phase2-extensions/domain/value-objects/document-age.ts +44 -0
  508. package/scripts/harness/phase2-extensions/domain/value-objects/e2e-strategy-template.ts +61 -0
  509. package/scripts/harness/phase2-extensions/domain/value-objects/freshness-threshold.ts +42 -0
  510. package/scripts/harness/phase2-extensions/domain/value-objects/pointer-validation-result.ts +52 -0
  511. package/scripts/harness/phase2-extensions/domain/value-objects/pointer.ts +47 -0
  512. package/scripts/harness/phase2-extensions/infrastructure/adapters/file-system-document-scanner-adapter.ts +77 -0
  513. package/scripts/harness/phase2-extensions/infrastructure/adapters/file-system-pointer-resolver-adapter.ts +25 -0
  514. package/scripts/harness/phase2-extensions/infrastructure/adapters/git-log-document-age-adapter.ts +47 -0
  515. package/scripts/harness/phase2-extensions/infrastructure/adapters/harness-config-freshness-adapter.ts +77 -0
  516. package/scripts/harness/phase2-extensions/infrastructure/adapters/playwright-template-generator-adapter.ts +154 -0
  517. package/scripts/harness/phase2-extensions/infrastructure/adapters/regex-pointer-extractor-adapter.ts +53 -0
  518. package/scripts/harness/phase2-extensions/presentation/formatters/freshness-result-formatter.ts +18 -0
  519. package/scripts/harness/phase2-extensions/presentation/formatters/pointer-result-formatter.ts +18 -0
  520. package/scripts/harness/phase2-extensions/presentation/handlers/check-freshness-handler.ts +37 -0
  521. package/scripts/harness/phase2-extensions/presentation/handlers/generate-e2e-template-handler.ts +43 -0
  522. package/scripts/harness/phase2-extensions/presentation/handlers/validate-pointers-handler.ts +33 -0
  523. package/scripts/harness/quick-mode/application/dto/build-relaxation-profile-input.ts +12 -0
  524. package/scripts/harness/quick-mode/application/dto/execute-quick-ci-check-input.ts +11 -0
  525. package/scripts/harness/quick-mode/application/dto/judge-quick-mode-eligibility-input.ts +10 -0
  526. package/scripts/harness/quick-mode/application/dto/quick-mode-decision-contract.ts +14 -0
  527. package/scripts/harness/quick-mode/application/dto/quick-mode-eligibility-contract.ts +13 -0
  528. package/scripts/harness/quick-mode/application/dto/validator-relaxation-profile-contract.ts +21 -0
  529. package/scripts/harness/quick-mode/application/mappers/quick-mode-decision-contract-mapper.ts +73 -0
  530. package/scripts/harness/quick-mode/application/ports/changed-files-port.ts +8 -0
  531. package/scripts/harness/quick-mode/application/ports/quick-mode-config-port.ts +13 -0
  532. package/scripts/harness/quick-mode/application/ports/validator-execution-port.ts +12 -0
  533. package/scripts/harness/quick-mode/application/ports/validator-id-registry-port.ts +11 -0
  534. package/scripts/harness/quick-mode/application/usecases/build-relaxation-profile-usecase.ts +76 -0
  535. package/scripts/harness/quick-mode/application/usecases/execute-quick-ci-check-usecase.ts +63 -0
  536. package/scripts/harness/quick-mode/application/usecases/judge-quick-mode-eligibility-usecase.ts +57 -0
  537. package/scripts/harness/quick-mode/composition-root.ts +74 -0
  538. package/scripts/harness/quick-mode/domain/ports/changed-files-port.ts +12 -0
  539. package/scripts/harness/quick-mode/domain/ports/quick-mode-config-port.ts +12 -0
  540. package/scripts/harness/quick-mode/domain/ports/validator-id-registry-port.ts +10 -0
  541. package/scripts/harness/quick-mode/domain/services/quick-mode-judgment-engine.ts +148 -0
  542. package/scripts/harness/quick-mode/domain/services/validator-relaxation-service.ts +47 -0
  543. package/scripts/harness/quick-mode/domain/types/change-kind.ts +14 -0
  544. package/scripts/harness/quick-mode/domain/types/rejection-rule.ts +8 -0
  545. package/scripts/harness/quick-mode/domain/value-objects/change-category.ts +60 -0
  546. package/scripts/harness/quick-mode/domain/value-objects/change-classification.ts +68 -0
  547. package/scripts/harness/quick-mode/domain/value-objects/changed-file.ts +56 -0
  548. package/scripts/harness/quick-mode/domain/value-objects/quick-mode-config.ts +69 -0
  549. package/scripts/harness/quick-mode/domain/value-objects/quick-mode-decision.ts +47 -0
  550. package/scripts/harness/quick-mode/domain/value-objects/quick-mode-eligibility.ts +62 -0
  551. package/scripts/harness/quick-mode/domain/value-objects/validator-relaxation-profile.ts +116 -0
  552. package/scripts/harness/quick-mode/index.ts +43 -0
  553. package/scripts/harness/quick-mode/infrastructure/adapters/git-diff-changed-files-adapter.ts +92 -0
  554. package/scripts/harness/quick-mode/infrastructure/adapters/harness-config-quick-mode-config-adapter.ts +75 -0
  555. package/scripts/harness/quick-mode/infrastructure/adapters/validator-system-validator-id-registry-adapter.ts +23 -0
  556. package/scripts/harness/quick-mode/presentation/dto/quick-mode-render-options.ts +14 -0
  557. package/scripts/harness/quick-mode/presentation/formatters/agent-quick-mode-formatter.ts +56 -0
  558. package/scripts/harness/quick-mode/presentation/formatters/human-quick-mode-formatter.ts +48 -0
  559. package/scripts/harness/quick-mode/presentation/formatters/json-quick-mode-formatter.ts +14 -0
  560. package/scripts/harness/quick-mode/presentation/handlers/ci-check-quick-mode-handler.ts +63 -0
  561. package/scripts/harness/regression-suite/application/dto/analyze-migration-input.ts +5 -0
  562. package/scripts/harness/regression-suite/application/dto/analyze-migration-output.ts +6 -0
  563. package/scripts/harness/regression-suite/application/dto/configure-ci-gate-input.ts +8 -0
  564. package/scripts/harness/regression-suite/application/dto/configure-ci-gate-output.ts +8 -0
  565. package/scripts/harness/regression-suite/application/dto/migrate-v0-tests-input.ts +5 -0
  566. package/scripts/harness/regression-suite/application/dto/migrate-v0-tests-output.ts +18 -0
  567. package/scripts/harness/regression-suite/application/dto/run-regression-suite-input.ts +7 -0
  568. package/scripts/harness/regression-suite/application/dto/run-regression-suite-output.ts +15 -0
  569. package/scripts/harness/regression-suite/application/mappers/migration-mapping-mapper.ts +23 -0
  570. package/scripts/harness/regression-suite/application/mappers/test-execution-summary-mapper.ts +25 -0
  571. package/scripts/harness/regression-suite/application/usecases/analyze-v0-migration-usecase.ts +38 -0
  572. package/scripts/harness/regression-suite/application/usecases/configure-ci-gate-usecase.ts +29 -0
  573. package/scripts/harness/regression-suite/application/usecases/migrate-v0-tests-usecase.ts +44 -0
  574. package/scripts/harness/regression-suite/application/usecases/run-agent-independence-guard-usecase.ts +66 -0
  575. package/scripts/harness/regression-suite/application/usecases/run-gng-gate-regression-usecase.ts +41 -0
  576. package/scripts/harness/regression-suite/application/usecases/run-k-requirements-regression-usecase.ts +59 -0
  577. package/scripts/harness/regression-suite/application/usecases/run-k14-k15-regression-usecase.ts +46 -0
  578. package/scripts/harness/regression-suite/composition-root.ts +98 -0
  579. package/scripts/harness/regression-suite/domain/aggregates/v0-test-migration.ts +94 -0
  580. package/scripts/harness/regression-suite/domain/ports/ci-gate-result-writer-port.ts +6 -0
  581. package/scripts/harness/regression-suite/domain/ports/config-query-port.ts +3 -0
  582. package/scripts/harness/regression-suite/domain/ports/import-analyzer-port.ts +3 -0
  583. package/scripts/harness/regression-suite/domain/ports/migration-mapping-repository-port.ts +9 -0
  584. package/scripts/harness/regression-suite/domain/ports/suite-registry-port.ts +6 -0
  585. package/scripts/harness/regression-suite/domain/ports/test-runner-port.ts +16 -0
  586. package/scripts/harness/regression-suite/domain/ports/v0-spec-reader-port.ts +5 -0
  587. package/scripts/harness/regression-suite/domain/services/import-guard-service.ts +38 -0
  588. package/scripts/harness/regression-suite/domain/services/migration-analyzer.ts +72 -0
  589. package/scripts/harness/regression-suite/domain/services/regression-runner.ts +90 -0
  590. package/scripts/harness/regression-suite/domain/value-objects/agent-independence-test.ts +35 -0
  591. package/scripts/harness/regression-suite/domain/value-objects/biome-modification-spec.ts +38 -0
  592. package/scripts/harness/regression-suite/domain/value-objects/ci-gate-config.ts +47 -0
  593. package/scripts/harness/regression-suite/domain/value-objects/coverage-rate.ts +27 -0
  594. package/scripts/harness/regression-suite/domain/value-objects/gng-condition-test.ts +41 -0
  595. package/scripts/harness/regression-suite/domain/value-objects/import-violation.ts +38 -0
  596. package/scripts/harness/regression-suite/domain/value-objects/k-requirement-test.ts +44 -0
  597. package/scripts/harness/regression-suite/domain/value-objects/migration-mapping.ts +37 -0
  598. package/scripts/harness/regression-suite/domain/value-objects/regression-suite-definition.ts +40 -0
  599. package/scripts/harness/regression-suite/domain/value-objects/suite-id.ts +32 -0
  600. package/scripts/harness/regression-suite/domain/value-objects/test-execution-summary.ts +55 -0
  601. package/scripts/harness/regression-suite/domain/value-objects/test-failure-detail.ts +32 -0
  602. package/scripts/harness/regression-suite/domain/value-objects/v0-test-id.ts +23 -0
  603. package/scripts/harness/regression-suite/domain/value-objects/v1-test-path.ts +23 -0
  604. package/scripts/harness/regression-suite/infrastructure/adapters/biome-ast-import-analyzer-adapter.ts +17 -0
  605. package/scripts/harness/regression-suite/infrastructure/adapters/file-system-v0-spec-reader-adapter.ts +20 -0
  606. package/scripts/harness/regression-suite/infrastructure/adapters/harness-config-query-adapter.ts +9 -0
  607. package/scripts/harness/regression-suite/infrastructure/adapters/json-ci-gate-result-writer-adapter.ts +30 -0
  608. package/scripts/harness/regression-suite/infrastructure/adapters/markdown-migration-mapping-repository-adapter.ts +40 -0
  609. package/scripts/harness/regression-suite/infrastructure/adapters/static-suite-registry-adapter.ts +24 -0
  610. package/scripts/harness/regression-suite/infrastructure/adapters/vitest-test-runner-adapter.ts +104 -0
  611. package/scripts/harness/regression-suite/infrastructure/registry/agent-independence-suite-definition.ts +31 -0
  612. package/scripts/harness/regression-suite/infrastructure/registry/gng-gate-suite-definition.ts +19 -0
  613. package/scripts/harness/regression-suite/infrastructure/registry/k-requirements-suite-definition.ts +32 -0
  614. package/scripts/harness/regression-suite/infrastructure/registry/v0-migration-suite-definition.ts +23 -0
  615. package/scripts/harness/setup/skill-deployer.ts +217 -0
  616. package/scripts/harness/shared-kernel/harness-api.ts +5 -0
  617. package/scripts/harness/shared-kernel/quick-mode.ts +15 -0
  618. package/scripts/harness/shared-kernel/validator-system.ts +14 -0
  619. package/scripts/harness/skill-quality/application/dto/apply-cascade-update-input.ts +8 -0
  620. package/scripts/harness/skill-quality/application/dto/apply-cascade-update-output.ts +9 -0
  621. package/scripts/harness/skill-quality/application/dto/check-coverage-input.ts +7 -0
  622. package/scripts/harness/skill-quality/application/dto/check-coverage-output.ts +12 -0
  623. package/scripts/harness/skill-quality/application/dto/collect-lessons-input.ts +7 -0
  624. package/scripts/harness/skill-quality/application/dto/collect-lessons-output.ts +11 -0
  625. package/scripts/harness/skill-quality/application/dto/execute-tdd-cycle-input.ts +11 -0
  626. package/scripts/harness/skill-quality/application/dto/execute-tdd-cycle-output.ts +11 -0
  627. package/scripts/harness/skill-quality/application/dto/run-plan-checker-loop-input.ts +8 -0
  628. package/scripts/harness/skill-quality/application/dto/run-plan-checker-loop-output.ts +12 -0
  629. package/scripts/harness/skill-quality/application/dto/validate-skill-structure-input.ts +7 -0
  630. package/scripts/harness/skill-quality/application/dto/validate-skill-structure-output.ts +9 -0
  631. package/scripts/harness/skill-quality/application/dto/write-lesson-artifact-input.ts +10 -0
  632. package/scripts/harness/skill-quality/application/dto/write-lesson-artifact-output.ts +8 -0
  633. package/scripts/harness/skill-quality/application/mappers/cascade-update-result-mapper.ts +16 -0
  634. package/scripts/harness/skill-quality/application/mappers/coverage-report-mapper.ts +37 -0
  635. package/scripts/harness/skill-quality/application/mappers/lesson-artifact-mapper.ts +11 -0
  636. package/scripts/harness/skill-quality/application/usecases/apply-cascade-update-usecase.ts +61 -0
  637. package/scripts/harness/skill-quality/application/usecases/check-coverage-usecase.ts +39 -0
  638. package/scripts/harness/skill-quality/application/usecases/collect-lessons-usecase.ts +34 -0
  639. package/scripts/harness/skill-quality/application/usecases/execute-tdd-cycle-usecase.ts +26 -0
  640. package/scripts/harness/skill-quality/application/usecases/run-plan-checker-loop-usecase.ts +38 -0
  641. package/scripts/harness/skill-quality/application/usecases/validate-skill-structure-usecase.ts +16 -0
  642. package/scripts/harness/skill-quality/application/usecases/write-lesson-artifact-usecase.ts +37 -0
  643. package/scripts/harness/skill-quality/composition-root.ts +120 -0
  644. package/scripts/harness/skill-quality/domain/aggregates/lesson-artifact.ts +59 -0
  645. package/scripts/harness/skill-quality/domain/aggregates/plan-checker-loop.ts +58 -0
  646. package/scripts/harness/skill-quality/domain/errors/skill-quality-error.ts +40 -0
  647. package/scripts/harness/skill-quality/domain/ports/commit-executor-port.ts +9 -0
  648. package/scripts/harness/skill-quality/domain/ports/config-query-port.ts +10 -0
  649. package/scripts/harness/skill-quality/domain/ports/coverage-runner-port.ts +9 -0
  650. package/scripts/harness/skill-quality/domain/ports/file-system-port.ts +10 -0
  651. package/scripts/harness/skill-quality/domain/ports/l1-validator-port.ts +10 -0
  652. package/scripts/harness/skill-quality/domain/ports/l2-validator-port.ts +10 -0
  653. package/scripts/harness/skill-quality/domain/ports/lesson-artifact-schema-port.ts +9 -0
  654. package/scripts/harness/skill-quality/domain/ports/lesson-artifact-writer-port.ts +9 -0
  655. package/scripts/harness/skill-quality/domain/ports/lesson-source-reader-port.ts +16 -0
  656. package/scripts/harness/skill-quality/domain/ports/plan-check-executor-port.ts +15 -0
  657. package/scripts/harness/skill-quality/domain/ports/requirement-test-matrix-port.ts +15 -0
  658. package/scripts/harness/skill-quality/domain/ports/skill-file-reader-port.ts +9 -0
  659. package/scripts/harness/skill-quality/domain/ports/validator-id-registry-port.ts +8 -0
  660. package/scripts/harness/skill-quality/domain/services/atomic-commit-service.ts +38 -0
  661. package/scripts/harness/skill-quality/domain/services/cascade-update-service.ts +36 -0
  662. package/scripts/harness/skill-quality/domain/services/lesson-collector.ts +26 -0
  663. package/scripts/harness/skill-quality/domain/services/lesson-deduplicator.ts +17 -0
  664. package/scripts/harness/skill-quality/domain/services/skill-structure-validator.ts +72 -0
  665. package/scripts/harness/skill-quality/domain/types/iso-date-string.ts +5 -0
  666. package/scripts/harness/skill-quality/domain/types/loop-status.ts +5 -0
  667. package/scripts/harness/skill-quality/domain/types/section-name.ts +5 -0
  668. package/scripts/harness/skill-quality/domain/types/tdd-phase.ts +5 -0
  669. package/scripts/harness/skill-quality/domain/types/unit-name.ts +5 -0
  670. package/scripts/harness/skill-quality/domain/types/validation-violation.ts +9 -0
  671. package/scripts/harness/skill-quality/domain/value-objects/cascade-update-result.ts +35 -0
  672. package/scripts/harness/skill-quality/domain/value-objects/cascade-update-target.ts +28 -0
  673. package/scripts/harness/skill-quality/domain/value-objects/code-coverage-result.ts +31 -0
  674. package/scripts/harness/skill-quality/domain/value-objects/commit-message.ts +33 -0
  675. package/scripts/harness/skill-quality/domain/value-objects/commit-readiness.ts +34 -0
  676. package/scripts/harness/skill-quality/domain/value-objects/coverage-report.ts +36 -0
  677. package/scripts/harness/skill-quality/domain/value-objects/lesson-fingerprint.ts +29 -0
  678. package/scripts/harness/skill-quality/domain/value-objects/lesson.ts +57 -0
  679. package/scripts/harness/skill-quality/domain/value-objects/loop-attempt.ts +38 -0
  680. package/scripts/harness/skill-quality/domain/value-objects/requirement-coverage-result.ts +29 -0
  681. package/scripts/harness/skill-quality/domain/value-objects/skill-structure.ts +36 -0
  682. package/scripts/harness/skill-quality/domain/value-objects/skill-validation-result.ts +38 -0
  683. package/scripts/harness/skill-quality/domain/value-objects/source-context.ts +25 -0
  684. package/scripts/harness/skill-quality/domain/value-objects/tdd-cycle.ts +28 -0
  685. package/scripts/harness/skill-quality/infrastructure/adapters/ajv-lesson-artifact-schema-adapter.ts +37 -0
  686. package/scripts/harness/skill-quality/infrastructure/adapters/file-system-lesson-artifact-writer-adapter.ts +19 -0
  687. package/scripts/harness/skill-quality/infrastructure/adapters/file-system-lesson-source-reader-adapter.ts +30 -0
  688. package/scripts/harness/skill-quality/infrastructure/adapters/file-system-requirement-test-matrix-adapter.ts +28 -0
  689. package/scripts/harness/skill-quality/infrastructure/adapters/file-system-skill-file-reader-adapter.ts +26 -0
  690. package/scripts/harness/skill-quality/infrastructure/adapters/git-commit-executor-adapter.ts +31 -0
  691. package/scripts/harness/skill-quality/infrastructure/adapters/harness-config-query-adapter.ts +19 -0
  692. package/scripts/harness/skill-quality/infrastructure/adapters/l1-biome-validator-adapter.ts +25 -0
  693. package/scripts/harness/skill-quality/infrastructure/adapters/l2-validator-system-adapter.ts +30 -0
  694. package/scripts/harness/skill-quality/infrastructure/adapters/validator-id-registry-bridge-adapter.ts +19 -0
  695. package/scripts/harness/skill-quality/infrastructure/adapters/vitest-coverage-runner-adapter.ts +70 -0
  696. package/scripts/harness/skill-quality/presentation/handlers/apply-cascade-update-handler.ts +32 -0
  697. package/scripts/harness/skill-quality/presentation/handlers/check-coverage-handler.ts +36 -0
  698. package/scripts/harness/skill-quality/presentation/handlers/collect-lessons-handler.ts +38 -0
  699. package/scripts/harness/skill-quality/presentation/handlers/execute-tdd-cycle-handler.ts +37 -0
  700. package/scripts/harness/skill-quality/presentation/handlers/run-plan-checker-loop-handler.ts +34 -0
  701. package/scripts/harness/skill-quality/presentation/handlers/validate-skill-structure-handler.ts +35 -0
  702. package/scripts/harness/traceability-model/application/dto/metadata-validation-input.ts +12 -0
  703. package/scripts/harness/traceability-model/application/dto/metadata-validation-output.ts +13 -0
  704. package/scripts/harness/traceability-model/application/dto/traceability-chain-output.ts +20 -0
  705. package/scripts/harness/traceability-model/application/dto/traceability-coverage-output.ts +14 -0
  706. package/scripts/harness/traceability-model/application/usecases/build-traceability-chain-usecase.ts +64 -0
  707. package/scripts/harness/traceability-model/application/usecases/resolve-legacy-story-id-usecase.ts +34 -0
  708. package/scripts/harness/traceability-model/application/usecases/validate-design-story-annotations-usecase.ts +83 -0
  709. package/scripts/harness/traceability-model/application/usecases/validate-implementation-metadata-usecase.ts +76 -0
  710. package/scripts/harness/traceability-model/application/usecases/validate-test-story-metadata-usecase.ts +76 -0
  711. package/scripts/harness/traceability-model/application/usecases/verify-traceability-coverage-usecase.ts +60 -0
  712. package/scripts/harness/traceability-model/composition-root.ts +61 -0
  713. package/scripts/harness/traceability-model/domain/constants/layer-names.ts +14 -0
  714. package/scripts/harness/traceability-model/domain/constants/metadata-tag-types.ts +14 -0
  715. package/scripts/harness/traceability-model/domain/constants/traceability-link-types.ts +14 -0
  716. package/scripts/harness/traceability-model/domain/ports/design-document-port.ts +24 -0
  717. package/scripts/harness/traceability-model/domain/ports/inception-plan-port.ts +16 -0
  718. package/scripts/harness/traceability-model/domain/ports/metadata-reader-port.ts +22 -0
  719. package/scripts/harness/traceability-model/domain/ports/story-catalog-port.ts +14 -0
  720. package/scripts/harness/traceability-model/domain/ports/unit-definition-port.ts +14 -0
  721. package/scripts/harness/traceability-model/domain/services/metadata-validator.ts +252 -0
  722. package/scripts/harness/traceability-model/domain/services/story-id-alias-resolver.ts +48 -0
  723. package/scripts/harness/traceability-model/domain/services/traceability-chain-builder.ts +293 -0
  724. package/scripts/harness/traceability-model/domain/value-objects/chain-link.ts +79 -0
  725. package/scripts/harness/traceability-model/domain/value-objects/design-document-flags.ts +40 -0
  726. package/scripts/harness/traceability-model/domain/value-objects/layer-reference.ts +41 -0
  727. package/scripts/harness/traceability-model/domain/value-objects/metadata-tag.ts +93 -0
  728. package/scripts/harness/traceability-model/domain/value-objects/metadata-validation-result.ts +97 -0
  729. package/scripts/harness/traceability-model/domain/value-objects/project-relative-path.ts +96 -0
  730. package/scripts/harness/traceability-model/domain/value-objects/story-id-annotation.ts +49 -0
  731. package/scripts/harness/traceability-model/domain/value-objects/story-id.ts +58 -0
  732. package/scripts/harness/traceability-model/domain/value-objects/story-reference.ts +40 -0
  733. package/scripts/harness/traceability-model/domain/value-objects/traceability-chain.ts +66 -0
  734. package/scripts/harness/traceability-model/domain/value-objects/unit-reference.ts +70 -0
  735. package/scripts/harness/traceability-model/index.ts +16 -0
  736. package/scripts/harness/traceability-model/infrastructure/gateways/file-system-inception-plan-gateway.ts +86 -0
  737. package/scripts/harness/traceability-model/infrastructure/gateways/file-system-metadata-reader.ts +101 -0
  738. package/scripts/harness/traceability-model/infrastructure/gateways/markdown-design-document-gateway.ts +122 -0
  739. package/scripts/harness/traceability-model/infrastructure/gateways/markdown-story-catalog-gateway.ts +98 -0
  740. package/scripts/harness/traceability-model/infrastructure/gateways/markdown-unit-definition-gateway.ts +95 -0
  741. package/scripts/harness/traceability-model/infrastructure/parsers/frontmatter-flag-parser.ts +52 -0
  742. package/scripts/harness/traceability-model/infrastructure/parsers/markdown-story-annotation-parser.ts +59 -0
  743. package/scripts/harness/traceability-model/infrastructure/parsers/source-metadata-parser.ts +103 -0
  744. package/scripts/harness/traceability-model/infrastructure/parsers/story-catalog-parser.ts +78 -0
  745. package/scripts/harness/traceability-model/presentation/cli/validate-metadata-command-handler.ts +87 -0
  746. package/scripts/harness/validator-system/application/dto/aggregate-results-input.ts +12 -0
  747. package/scripts/harness/validator-system/application/dto/aggregated-validation-report.ts +28 -0
  748. package/scripts/harness/validator-system/application/dto/run-full-validation-input.ts +16 -0
  749. package/scripts/harness/validator-system/application/dto/run-l0-validators-input.ts +9 -0
  750. package/scripts/harness/validator-system/application/dto/run-l1-validators-input.ts +12 -0
  751. package/scripts/harness/validator-system/application/dto/run-l2-validators-input.ts +12 -0
  752. package/scripts/harness/validator-system/application/dto/run-l3-validators-input.ts +12 -0
  753. package/scripts/harness/validator-system/application/dto/run-l4-validators-input.ts +11 -0
  754. package/scripts/harness/validator-system/application/dto/run-quick-mode-input.ts +14 -0
  755. package/scripts/harness/validator-system/application/dto/validation-result-contract.ts +21 -0
  756. package/scripts/harness/validator-system/application/dto/validator-relaxation-profile.ts +21 -0
  757. package/scripts/harness/validator-system/application/mappers/validation-result-contract-mapper.ts +29 -0
  758. package/scripts/harness/validator-system/application/use-cases/aggregate-validation-results-usecase.ts +87 -0
  759. package/scripts/harness/validator-system/application/use-cases/run-full-validation-usecase.ts +63 -0
  760. package/scripts/harness/validator-system/application/use-cases/run-l0-validators-usecase.ts +60 -0
  761. package/scripts/harness/validator-system/application/use-cases/run-l1-validators-usecase.ts +152 -0
  762. package/scripts/harness/validator-system/application/use-cases/run-l2-validators-usecase.ts +130 -0
  763. package/scripts/harness/validator-system/application/use-cases/run-l3-validators-usecase.ts +156 -0
  764. package/scripts/harness/validator-system/application/use-cases/run-l4-validators-usecase.ts +124 -0
  765. package/scripts/harness/validator-system/application/use-cases/run-quick-mode-usecase.ts +91 -0
  766. package/scripts/harness/validator-system/composition-root.ts +234 -0
  767. package/scripts/harness/validator-system/domain/ports/ac-coverage-policy-port.ts +14 -0
  768. package/scripts/harness/validator-system/domain/ports/adr-reference-port.ts +17 -0
  769. package/scripts/harness/validator-system/domain/ports/cli-command-registry-port.ts +15 -0
  770. package/scripts/harness/validator-system/domain/ports/coverage-report-port.ts +13 -0
  771. package/scripts/harness/validator-system/domain/ports/design-document-port.ts +27 -0
  772. package/scripts/harness/validator-system/domain/ports/e2e-test-file-registry-port.ts +15 -0
  773. package/scripts/harness/validator-system/domain/ports/it-test-file-analyzer-port.ts +21 -0
  774. package/scripts/harness/validator-system/domain/ports/metadata-policy-port.ts +17 -0
  775. package/scripts/harness/validator-system/domain/ports/performance-scanner-port.ts +14 -0
  776. package/scripts/harness/validator-system/domain/ports/phase-gate-policy-port.ts +14 -0
  777. package/scripts/harness/validator-system/domain/ports/security-pattern-scanner-port.ts +14 -0
  778. package/scripts/harness/validator-system/domain/ports/source-analysis-port.ts +18 -0
  779. package/scripts/harness/validator-system/domain/ports/source-code-analyzer-port.ts +19 -0
  780. package/scripts/harness/validator-system/domain/ports/source-file-text-scanner-port.ts +21 -0
  781. package/scripts/harness/validator-system/domain/ports/test-quality-analyzer-port.ts +17 -0
  782. package/scripts/harness/validator-system/domain/ports/validator-config-port.ts +11 -0
  783. package/scripts/harness/validator-system/domain/services/cli-e2e-test-existence-service.ts +27 -0
  784. package/scripts/harness/validator-system/domain/services/it-test-mock-detection-service.ts +44 -0
  785. package/scripts/harness/validator-system/domain/services/l4/consistency-check-service.ts +79 -0
  786. package/scripts/harness/validator-system/domain/services/l4/dead-code-detection-service.ts +49 -0
  787. package/scripts/harness/validator-system/domain/services/l4/drift-detection-service.ts +75 -0
  788. package/scripts/harness/validator-system/domain/services/stub-comment-detection-service.ts +25 -0
  789. package/scripts/harness/validator-system/domain/services/validator-execution-service.ts +153 -0
  790. package/scripts/harness/validator-system/domain/services/validator-registry.ts +62 -0
  791. package/scripts/harness/validator-system/domain/value-objects/cli-e2e-test-coverage-report.ts +45 -0
  792. package/scripts/harness/validator-system/domain/value-objects/consistency-report.ts +54 -0
  793. package/scripts/harness/validator-system/domain/value-objects/dead-code-report.ts +61 -0
  794. package/scripts/harness/validator-system/domain/value-objects/drift-report.ts +61 -0
  795. package/scripts/harness/validator-system/domain/value-objects/it-test-mock-violation-report.ts +43 -0
  796. package/scripts/harness/validator-system/domain/value-objects/layer-config.ts +61 -0
  797. package/scripts/harness/validator-system/domain/value-objects/stub-comment-report.ts +42 -0
  798. package/scripts/harness/validator-system/domain/value-objects/validation-result.ts +89 -0
  799. package/scripts/harness/validator-system/domain/value-objects/validation-rule.ts +48 -0
  800. package/scripts/harness/validator-system/domain/value-objects/validator-definition.ts +74 -0
  801. package/scripts/harness/validator-system/domain/value-objects/validator-id.ts +93 -0
  802. package/scripts/harness/validator-system/index.ts +51 -0
  803. package/scripts/harness/validator-system/infrastructure/adapters/adr-foundation-reference-adapter.ts +57 -0
  804. package/scripts/harness/validator-system/infrastructure/adapters/ast-performance-scanner-adapter.ts +140 -0
  805. package/scripts/harness/validator-system/infrastructure/adapters/biome-ast-source-code-analyzer-adapter.ts +142 -0
  806. package/scripts/harness/validator-system/infrastructure/adapters/biome-ast-test-quality-analyzer-adapter.ts +71 -0
  807. package/scripts/harness/validator-system/infrastructure/adapters/cli-command-registry-adapter.ts +26 -0
  808. package/scripts/harness/validator-system/infrastructure/adapters/e2e-test-file-registry-adapter.ts +48 -0
  809. package/scripts/harness/validator-system/infrastructure/adapters/file-system-security-pattern-scanner-adapter.ts +47 -0
  810. package/scripts/harness/validator-system/infrastructure/adapters/harness-config-validator-config-adapter.ts +73 -0
  811. package/scripts/harness/validator-system/infrastructure/adapters/import-graph-source-analysis-adapter.ts +71 -0
  812. package/scripts/harness/validator-system/infrastructure/adapters/it-test-file-analyzer-adapter.ts +85 -0
  813. package/scripts/harness/validator-system/infrastructure/adapters/json-coverage-report-adapter.ts +50 -0
  814. package/scripts/harness/validator-system/infrastructure/adapters/markdown-design-document-adapter.ts +75 -0
  815. package/scripts/harness/validator-system/infrastructure/adapters/nyquist-ac-coverage-policy-adapter.ts +41 -0
  816. package/scripts/harness/validator-system/infrastructure/adapters/phase-dependency-phase-gate-policy-adapter.ts +46 -0
  817. package/scripts/harness/validator-system/infrastructure/adapters/source-file-text-scanner-adapter.ts +90 -0
  818. package/scripts/harness/validator-system/infrastructure/adapters/traceability-metadata-policy-adapter.ts +42 -0
  819. package/scripts/harness/validator-system/presentation/formatters/agent-validation-result-formatter.ts +34 -0
  820. package/scripts/harness/validator-system/presentation/formatters/ci-validation-result-formatter.ts +21 -0
  821. package/scripts/harness/validator-system/presentation/formatters/human-validation-result-formatter.ts +28 -0
  822. package/scripts/harness/validator-system/presentation/handlers/report-validation-results-handler.ts +68 -0
  823. package/scripts/harness/validator-system/presentation/handlers/run-quick-mode-handler.ts +63 -0
  824. package/scripts/harness/validator-system/presentation/handlers/run-validators-handler.ts +137 -0
  825. package/skills/README.md +21 -0
  826. package/skills/cascade-updater/SKILL.md +127 -0
  827. package/skills/cascade-updater/references//345/261/244/345/210/245/345/210/244/345/256/232/343/202/254/343/202/244/343/203/211.md +58 -0
  828. package/skills/codebase-mapper/SKILL.md +151 -0
  829. package/skills/codex-delegator/SKILL.md +312 -0
  830. package/skills/codex-delegator/references/prompt-patterns.md +165 -0
  831. package/skills/codex-delegator/references/review-dimensions.md +116 -0
  832. package/skills/consistency-checker/SKILL.md +155 -0
  833. package/skills/consistency-checker/references//343/203/201/343/202/247/343/203/203/343/202/257/343/203/252/343/202/271/343/203/210.md +60 -0
  834. package/skills/doc-freshness-checker/SKILL.md +131 -0
  835. package/skills/domain-designer/SKILL.md +152 -0
  836. package/skills/engineering-perspective/SKILL.md +136 -0
  837. package/skills/engineering-perspective/references/domain-model.md +363 -0
  838. package/skills/engineering-perspective/references/glossary.md +261 -0
  839. package/skills/environment-designer/SKILL.md +187 -0
  840. package/skills/implementation-planner/SKILL.md +156 -0
  841. package/skills/implementation-planner/references/document-structure.md +116 -0
  842. package/skills/implementation-planner/references/plan-template.md +177 -0
  843. package/skills/implementation-planner/references/workflow.md +164 -0
  844. package/skills/implementation-readiness-checker/SKILL.md +250 -0
  845. package/skills/it-test-designer/SKILL.md +334 -0
  846. package/skills/it-test-logic-designer/SKILL.md +627 -0
  847. package/skills/logical-designer/SKILL.md +186 -0
  848. package/skills/mock-designer/SKILL.md +189 -0
  849. package/skills/pointer-validator/SKILL.md +96 -0
  850. package/skills/product-architect/SKILL.md +131 -0
  851. package/skills/quick-implementor/SKILL.md +103 -0
  852. package/skills/scenario-test-designer/SKILL.md +307 -0
  853. package/skills/scenario-test-logic-designer/SKILL.md +504 -0
  854. package/skills/skill-creator/SKILL.md +371 -0
  855. package/skills/skill-creator/license.txt +202 -0
  856. package/skills/skill-creator/scripts/__pycache__/quick_validate.cpython-312.pyc +0 -0
  857. package/skills/skill-creator/scripts/init_skill.py +378 -0
  858. package/skills/skill-creator/scripts/package_skill.py +111 -0
  859. package/skills/skill-creator/scripts/quick_validate.py +101 -0
  860. package/skills/story-implementor/SKILL.md +254 -0
  861. package/skills/story-mapper/SKILL.md +217 -0
  862. package/skills/story-writer/SKILL.md +142 -0
  863. package/skills/test-coverage-checker/SKILL.md +450 -0
  864. package/skills/uiux-designer/SKILL.md +292 -0
  865. package/skills/unit-designer/SKILL.md +183 -0
  866. package/skills/unit-test-designer/SKILL.md +326 -0
  867. package/skills/unit-test-logic-designer/SKILL.md +429 -0
  868. package/templates/.claude/scripts/analyze-errors-hook.sh +125 -0
  869. package/templates/.claude/scripts/deny-check.sh +55 -0
  870. package/templates/.claude/scripts/format-settings-hook.sh +36 -0
  871. package/templates/.claude/scripts/format-typescript-hook.sh +82 -0
  872. package/templates/.claude/scripts/hook-config.json +5 -0
  873. package/templates/.claude/settings.json +83 -0
  874. package/templates/.husky/pre-commit +2 -0
  875. package/templates/phasegate.config.json +30 -0
@@ -0,0 +1,44 @@
1
+ /**
2
+ * @layer domain
3
+ * @unit validator-system
4
+ *
5
+ * ItTestMockDetectionService — H08-07: ITテスト内部モック検出ドメインサービス
6
+ * ITテストファイルのvi.mock呼び出しで内部モジュールをモックしている箇所を検出する。
7
+ */
8
+ import type { ItTestMockCall } from '../ports/it-test-file-analyzer-port.js';
9
+ import { ItTestMockViolationReport, type ItTestMockViolationEntry } from '../value-objects/it-test-mock-violation-report.js';
10
+
11
+ /** 外部モジュール(node:, npm パッケージ)のパターン — これらはモック許可 */
12
+ const EXTERNAL_MODULE_PATTERNS = [
13
+ /^node:/,
14
+ /^vitest$/,
15
+ /^@vitest\//,
16
+ /^[^./]/, // node_modules (starts without . or /)
17
+ ];
18
+
19
+ function isExternalModule(modulePath: string): boolean {
20
+ return EXTERNAL_MODULE_PATTERNS.some((pattern) => pattern.test(modulePath));
21
+ }
22
+
23
+ export class ItTestMockDetectionService {
24
+ detect(mockCalls: readonly ItTestMockCall[]): ItTestMockViolationReport {
25
+ const internalMocks = mockCalls.filter((call) => !isExternalModule(call.mockedModule));
26
+
27
+ // Group by filePath
28
+ const byFile = new Map<string, string[]>();
29
+ for (const call of internalMocks) {
30
+ const existing = byFile.get(call.filePath) ?? [];
31
+ existing.push(call.mockedModule);
32
+ byFile.set(call.filePath, existing);
33
+ }
34
+
35
+ const entries: ItTestMockViolationEntry[] = Array.from(byFile.entries()).map(([filePath, mockedModules]) => ({
36
+ filePath,
37
+ mockedModules: Object.freeze(mockedModules),
38
+ }));
39
+
40
+ return ItTestMockViolationReport.create(entries);
41
+ }
42
+ }
43
+
44
+ // @story-id H08-07
@@ -0,0 +1,79 @@
1
+ /**
2
+ * @layer domain
3
+ * @unit validator-system
4
+ *
5
+ * ConsistencyCheckService ドメインサービス
6
+ * 設計文書間のレイヤー整合性検証(L4-002)
7
+ */
8
+ import { ConsistencyReport } from '../../value-objects/consistency-report.js';
9
+
10
+ export interface ConsistencyDesignDocumentPort {
11
+ getLayerAnnotations(targetDocs?: readonly string[]): Promise<Record<string, string>>;
12
+ }
13
+
14
+ export interface ConsistencyAdrReferencePort {
15
+ exists(adrRef: string): Promise<boolean>;
16
+ }
17
+
18
+ export interface ConsistencyCheckServiceDeps {
19
+ designDocumentPort: ConsistencyDesignDocumentPort;
20
+ adrReferencePort: ConsistencyAdrReferencePort;
21
+ }
22
+
23
+ export class ConsistencyCheckService {
24
+ private readonly designDocumentPort: ConsistencyDesignDocumentPort;
25
+ private readonly adrReferencePort: ConsistencyAdrReferencePort;
26
+
27
+ constructor(deps: ConsistencyCheckServiceDeps) {
28
+ this.designDocumentPort = deps.designDocumentPort;
29
+ this.adrReferencePort = deps.adrReferencePort;
30
+ }
31
+
32
+ async check(targetDocs?: readonly string[]): Promise<ConsistencyReport> {
33
+ const layerAnnotations = await this.designDocumentPort.getLayerAnnotations(targetDocs);
34
+
35
+ const mismatchPairs: { expected: string; actual: string; location: string }[] = [];
36
+ const checkTargets = Object.keys(layerAnnotations);
37
+
38
+ // レイヤー記述の整合性チェック(全ドキュメントが同じレイヤーを参照していることを確認)
39
+ const layerValues = Object.values(layerAnnotations);
40
+ if (layerValues.length > 1) {
41
+ const referenceLayer = layerValues[0];
42
+ for (const [docPath, layer] of Object.entries(layerAnnotations)) {
43
+ if (layer !== referenceLayer) {
44
+ mismatchPairs.push({
45
+ expected: referenceLayer,
46
+ actual: layer,
47
+ location: docPath,
48
+ });
49
+ }
50
+ }
51
+ }
52
+
53
+ // ADR実在性確認(ポートが存在する場合)
54
+ // adrReferencePort.exists を使って参照 ADR の実在を確認する
55
+ // DesignDocumentPort の layerAnnotations には ADR 参照が含まれないため、
56
+ // ADR 参照は別途取得する(ここではシンプル実装)
57
+ // ADR not found => mismatch として扱う
58
+ const knownAdrRefs = checkTargets
59
+ .filter((t) => t.startsWith('ADR-'))
60
+ .map((t) => t);
61
+
62
+ for (const adrRef of knownAdrRefs) {
63
+ const exists = await this.adrReferencePort.exists(adrRef);
64
+ if (!exists) {
65
+ mismatchPairs.push({
66
+ expected: 'ADR exists',
67
+ actual: 'ADR not found',
68
+ location: adrRef,
69
+ });
70
+ }
71
+ }
72
+
73
+ return ConsistencyReport.create({
74
+ mismatchPairs,
75
+ checkTargets,
76
+ checkedAt: new Date().toISOString(),
77
+ });
78
+ }
79
+ }
@@ -0,0 +1,49 @@
1
+ /**
2
+ * @layer domain
3
+ * @unit validator-system
4
+ *
5
+ * DeadCodeDetectionService ドメインサービス
6
+ * 未使用エクスポートおよび到達不能コードの検出(L4-003)
7
+ */
8
+ import { DeadCodeReport } from '../../value-objects/dead-code-report.js';
9
+
10
+ export interface DeadCodeSourceAnalysisPort {
11
+ getImportGraph(): Promise<{
12
+ nodes?: readonly { filePath: string; exports: readonly string[] }[];
13
+ edges?: readonly { from: string; to: string; importedNames: readonly string[] }[];
14
+ unusedExports?: readonly string[];
15
+ unreachableCode?: readonly { filePath: string; range: { startLine: number; endLine: number } }[];
16
+ }>;
17
+ }
18
+
19
+ export interface DeadCodeDetectionServiceDeps {
20
+ sourceAnalysisPort: DeadCodeSourceAnalysisPort;
21
+ }
22
+
23
+ export interface DeadCodeDetectOptions {
24
+ strictOnly: boolean;
25
+ }
26
+
27
+ export class DeadCodeDetectionService {
28
+ private readonly sourceAnalysisPort: DeadCodeSourceAnalysisPort;
29
+
30
+ constructor(deps: DeadCodeDetectionServiceDeps) {
31
+ this.sourceAnalysisPort = deps.sourceAnalysisPort;
32
+ }
33
+
34
+ async detect(options: DeadCodeDetectOptions): Promise<DeadCodeReport> {
35
+ const graph = await this.sourceAnalysisPort.getImportGraph();
36
+
37
+ const unusedExports = graph.unusedExports ? [...graph.unusedExports] : [];
38
+ const unreachableCode = graph.unreachableCode ? [...graph.unreachableCode] : [];
39
+
40
+ const hasDeadCode = unusedExports.length > 0 || unreachableCode.length > 0;
41
+ const gcRecommended = options.strictOnly && hasDeadCode;
42
+
43
+ return DeadCodeReport.create({
44
+ unusedExports,
45
+ unreachableCode,
46
+ gcRecommended,
47
+ });
48
+ }
49
+ }
@@ -0,0 +1,75 @@
1
+ /**
2
+ * @layer domain
3
+ * @unit validator-system
4
+ *
5
+ * DriftDetectionService ドメインサービス
6
+ * 設計文書(domain_model.md等)とソースコード実装の双方向乖離検出(L4-001)
7
+ */
8
+ import { DriftReport } from '../../value-objects/drift-report.js';
9
+
10
+ export interface DriftDetectionDesignDocumentPort {
11
+ getElements(targetUnits?: readonly string[]): Promise<string[]>;
12
+ }
13
+
14
+ export interface DriftDetectionSourceCodeAnalyzerPort {
15
+ getElements(targetUnits?: readonly string[]): Promise<string[]>;
16
+ }
17
+
18
+ export interface DriftDetectionServiceDeps {
19
+ designDocumentPort: DriftDetectionDesignDocumentPort;
20
+ sourceCodeAnalyzerPort: DriftDetectionSourceCodeAnalyzerPort;
21
+ }
22
+
23
+ export class DriftDetectionService {
24
+ private readonly designDocumentPort: DriftDetectionDesignDocumentPort;
25
+ private readonly sourceCodeAnalyzerPort: DriftDetectionSourceCodeAnalyzerPort;
26
+
27
+ constructor(deps: DriftDetectionServiceDeps) {
28
+ this.designDocumentPort = deps.designDocumentPort;
29
+ this.sourceCodeAnalyzerPort = deps.sourceCodeAnalyzerPort;
30
+ }
31
+
32
+ async detect(targetUnits?: readonly string[]): Promise<readonly DriftReport[]> {
33
+ const designElements = await this.designDocumentPort.getElements(targetUnits);
34
+ const codeElements = await this.sourceCodeAnalyzerPort.getElements(targetUnits);
35
+
36
+ const designSet = new Set(designElements);
37
+ const codeSet = new Set(codeElements);
38
+
39
+ const reports: DriftReport[] = [];
40
+
41
+ // 設計に存在するがコードに存在しない
42
+ for (const element of designElements) {
43
+ if (!codeSet.has(element)) {
44
+ reports.push(
45
+ DriftReport.create({
46
+ direction: 'design→code',
47
+ unitName: (targetUnits?.[0]) ?? 'unknown',
48
+ element,
49
+ description: `設計に存在するがコードに存在しない: ${element}`,
50
+ recommendation: `${element} をコードに実装してください`,
51
+ })
52
+ );
53
+ }
54
+ }
55
+
56
+ // コードに存在するが設計に存在しない
57
+ for (const element of codeElements) {
58
+ if (!designSet.has(element)) {
59
+ reports.push(
60
+ DriftReport.create({
61
+ direction: 'code→design',
62
+ unitName: (targetUnits?.[0]) ?? 'unknown',
63
+ element,
64
+ description: `コードに存在するが設計に存在しない: ${element}`,
65
+ recommendation: `${element} を設計文書に追記するか、コードから削除してください`,
66
+ })
67
+ );
68
+ }
69
+ }
70
+
71
+ return reports.sort((a, b) =>
72
+ a.direction.localeCompare(b.direction) || a.unitName.localeCompare(b.unitName)
73
+ );
74
+ }
75
+ }
@@ -0,0 +1,25 @@
1
+ /**
2
+ * @layer domain
3
+ * @unit validator-system
4
+ *
5
+ * StubCommentDetectionService — H08-08: スタブコメント残存検出ドメインサービス
6
+ * ソースファイル内の stub 実装コメントパターンを検出する。
7
+ */
8
+ import type { TextScanMatch } from '../ports/source-file-text-scanner-port.js';
9
+ import { StubCommentReport, type StubCommentEntry } from '../value-objects/stub-comment-report.js';
10
+
11
+ export class StubCommentDetectionService {
12
+ /** スタブコメント検出パターン */
13
+ static readonly STUB_COMMENT_PATTERN = /\/\/\s*(stub実装|Stub implementation|stub implementation|TODO.*stub|STUB)/i;
14
+
15
+ detect(matches: readonly TextScanMatch[]): StubCommentReport {
16
+ const entries: StubCommentEntry[] = matches.map((m) => ({
17
+ filePath: m.filePath,
18
+ lineNumber: m.lineNumber,
19
+ lineContent: m.lineContent,
20
+ }));
21
+ return StubCommentReport.create(entries);
22
+ }
23
+ }
24
+
25
+ // @story-id H08-07
@@ -0,0 +1,153 @@
1
+ /**
2
+ * @layer domain
3
+ * @unit validator-system
4
+ *
5
+ * ValidatorExecutionService ドメインサービス
6
+ * 指定されたValidatorDefinition[]を順次実行し、ValidationResult[]を集約
7
+ */
8
+ import { ValidatorDefinition } from '../value-objects/validator-definition.js';
9
+ import { ValidationResult, type HarnessErrorLike } from '../value-objects/validation-result.js';
10
+ import { LayerConfig } from '../value-objects/layer-config.js';
11
+ import type { PhaseGatePolicyPort } from '../ports/phase-gate-policy-port.js';
12
+
13
+ export class ValidatorExecutionError extends Error {
14
+ constructor(message: string, readonly cause?: unknown) {
15
+ super(message);
16
+ this.name = 'ValidatorExecutionError';
17
+ }
18
+ }
19
+
20
+ export interface ValidatorExecutionServiceDeps {
21
+ configPort?: {
22
+ getLayerConfig(layer: 'L0' | 'L2' | 'L3' | 'L4'): LayerConfig | Promise<LayerConfig>;
23
+ };
24
+ policyPort?: PhaseGatePolicyPort | { check: (...args: unknown[]) => unknown };
25
+ [key: string]: unknown;
26
+ }
27
+
28
+ /** 簡易緩和プロファイル(executeWithRelaxation用) */
29
+ export interface SimpleRelaxationProfile {
30
+ readonly excludedValidatorIds?: readonly string[];
31
+ readonly l2?: { maintained?: readonly string[]; skipped?: readonly string[] };
32
+ readonly l3?: { maintained?: readonly string[]; skipped?: readonly string[] };
33
+ readonly l4?: { all?: boolean };
34
+ readonly phaseExecution?: { twoPhaseRequired?: boolean };
35
+ }
36
+
37
+ export class ValidatorExecutionService {
38
+ private readonly deps: ValidatorExecutionServiceDeps;
39
+
40
+ constructor(deps: ValidatorExecutionServiceDeps) {
41
+ this.deps = deps;
42
+ }
43
+
44
+ execute(
45
+ definitions: readonly ValidatorDefinition[],
46
+ layerConfigs?: readonly LayerConfig[]
47
+ ): ValidationResult[] {
48
+ const results: ValidationResult[] = [];
49
+
50
+ for (const def of definitions) {
51
+ const layerConfig = layerConfigs
52
+ ? layerConfigs.find((c) => c.layer === def.layer)
53
+ : this._getLayerConfigSync(def.layer);
54
+
55
+ // スキップ判定: LayerConfig.enabled === false
56
+ if (layerConfig && !layerConfig.isValidatorEnabled(def.validatorId)) {
57
+ results.push(ValidationResult.skip(def.validatorId));
58
+ continue;
59
+ }
60
+
61
+ // スキップ判定: strictOnly かつ strictOnly=false
62
+ if (layerConfig && def.isStrictOnly() && !layerConfig.strictOnly) {
63
+ results.push(ValidationResult.skip(def.validatorId));
64
+ continue;
65
+ }
66
+
67
+ // 実行
68
+ const start = Date.now();
69
+ try {
70
+ const errors = this._executeValidator(def, layerConfig);
71
+ const durationMs = Date.now() - start;
72
+ if (errors.length > 0) {
73
+ results.push(ValidationResult.fail(def.validatorId, errors, durationMs));
74
+ } else {
75
+ results.push(ValidationResult.pass(def.validatorId, durationMs));
76
+ }
77
+ } catch (err) {
78
+ const durationMs = Date.now() - start;
79
+ const errorMsg = err instanceof Error ? err.message : String(err);
80
+ const failError: HarnessErrorLike = {
81
+ code: { value: def.validatorId.value, toString: () => def.validatorId.value },
82
+ severity: { value: 'error', toString: () => 'error' },
83
+ message: `Validator execution failed: ${errorMsg}`,
84
+ suggestion: 'Check the validator port implementation.',
85
+ };
86
+ results.push(ValidationResult.fail(def.validatorId, [failError], durationMs));
87
+ }
88
+ }
89
+
90
+ return results;
91
+ }
92
+
93
+ executeWithRelaxation(
94
+ definitions: readonly ValidatorDefinition[],
95
+ profileOrLayerConfigs: SimpleRelaxationProfile | readonly LayerConfig[],
96
+ profile?: SimpleRelaxationProfile
97
+ ): ValidationResult[] {
98
+ // overload handling
99
+ let relaxProfile: SimpleRelaxationProfile;
100
+ let layerConfigs: readonly LayerConfig[] | undefined;
101
+
102
+ if (Array.isArray(profileOrLayerConfigs)) {
103
+ layerConfigs = profileOrLayerConfigs as readonly LayerConfig[];
104
+ relaxProfile = profile ?? {};
105
+ } else {
106
+ relaxProfile = profileOrLayerConfigs as SimpleRelaxationProfile;
107
+ layerConfigs = undefined;
108
+ }
109
+
110
+ const excluded = new Set(relaxProfile.excludedValidatorIds ?? []);
111
+
112
+ const filteredDefs = definitions.filter((def) => {
113
+ if (excluded.has(def.validatorId.value)) return false;
114
+ return true;
115
+ });
116
+
117
+ const skippedDefs = definitions.filter((def) => excluded.has(def.validatorId.value));
118
+ const skippedResults = skippedDefs.map((def) => ValidationResult.skip(def.validatorId));
119
+
120
+ // 通常実行
121
+ const executedResults = this.execute(filteredDefs, layerConfigs);
122
+
123
+ // 元の定義順に並べ直す
124
+ const resultMap = new Map<string, ValidationResult>();
125
+ for (const r of [...skippedResults, ...executedResults]) {
126
+ resultMap.set(r.validatorId.value, r);
127
+ }
128
+
129
+ return definitions.map((def) => {
130
+ const r = resultMap.get(def.validatorId.value);
131
+ return r ?? ValidationResult.skip(def.validatorId);
132
+ });
133
+ }
134
+
135
+ private _getLayerConfigSync(layer: 'L0' | 'L2' | 'L3' | 'L4'): LayerConfig | undefined {
136
+ const port = this.deps.configPort;
137
+ if (!port) return undefined;
138
+ const result = port.getLayerConfig(layer);
139
+ // sync の場合はそのまま返す(Promiseは非対応)
140
+ if (result instanceof LayerConfig) return result;
141
+ return undefined;
142
+ }
143
+
144
+ private _executeValidator(def: ValidatorDefinition, _layerConfig?: LayerConfig): HarnessErrorLike[] {
145
+ // ポートを通じてバリデータを実行する
146
+ // テスト環境ではポートのモックを通じて動作する
147
+ const policyPort = this.deps.policyPort as { check?: (...args: unknown[]) => unknown } | undefined;
148
+ if (policyPort?.check) {
149
+ policyPort.check(def.validatorId.value);
150
+ }
151
+ return [];
152
+ }
153
+ }
@@ -0,0 +1,62 @@
1
+ /**
2
+ * @layer domain
3
+ * @unit validator-system
4
+ *
5
+ * ValidatorRegistry ドメインサービス
6
+ * 全10バリデータ定義のカタログ管理と選択実行インターフェース
7
+ */
8
+ import { ValidatorId } from '../value-objects/validator-id.js';
9
+ import { ValidatorDefinition } from '../value-objects/validator-definition.js';
10
+
11
+ export class UnknownValidatorError extends Error {
12
+ readonly validatorId: string;
13
+ constructor(validatorId: string) {
14
+ super(`Unknown validator: "${validatorId}". Not registered in ValidatorRegistry.`);
15
+ this.name = 'UnknownValidatorError';
16
+ this.validatorId = validatorId;
17
+ }
18
+ }
19
+
20
+ export class ValidatorRegistry {
21
+ private readonly definitionMap: Map<string, ValidatorDefinition>;
22
+ private readonly definitionList: readonly ValidatorDefinition[];
23
+
24
+ constructor(definitions: readonly ValidatorDefinition[]) {
25
+ const map = new Map<string, ValidatorDefinition>();
26
+ for (const def of definitions) {
27
+ const key = def.validatorId.value;
28
+ if (map.has(key)) {
29
+ throw new Error(`ValidatorRegistry: duplicate validatorId "${key}". Each validatorId must be unique.`);
30
+ }
31
+ map.set(key, def);
32
+ }
33
+ this.definitionMap = map;
34
+ this.definitionList = Object.freeze(
35
+ [...definitions].sort((a, b) => a.validatorId.value.localeCompare(b.validatorId.value))
36
+ );
37
+ }
38
+
39
+ getDefinition(validatorId: ValidatorId): ValidatorDefinition {
40
+ const def = this.definitionMap.get(validatorId.value);
41
+ if (!def) {
42
+ throw new UnknownValidatorError(validatorId.value);
43
+ }
44
+ return def;
45
+ }
46
+
47
+ getAllDefinitions(): readonly ValidatorDefinition[] {
48
+ return this.definitionList;
49
+ }
50
+
51
+ listByLayer(layer: 'L0' | 'L2' | 'L3' | 'L4'): readonly ValidatorDefinition[] {
52
+ return this.definitionList.filter((def) => def.layer === layer);
53
+ }
54
+
55
+ select(validatorIds: readonly ValidatorId[]): readonly ValidatorDefinition[] {
56
+ return validatorIds.map((id) => this.getDefinition(id));
57
+ }
58
+
59
+ hasDefinition(validatorId: ValidatorId): boolean {
60
+ return this.definitionMap.has(validatorId.value);
61
+ }
62
+ }
@@ -0,0 +1,45 @@
1
+ /**
2
+ * @layer domain
3
+ * @unit validator-system
4
+ *
5
+ * CliE2eTestCoverageReport 値オブジェクト
6
+ * CLIコマンド一覧とE2Eテストカバレッジ状況を表す不変値オブジェクト
7
+ */
8
+
9
+ export interface CliCommandCoverageEntry {
10
+ readonly commandName: string;
11
+ readonly hasE2eTest: boolean;
12
+ }
13
+
14
+ export class CliE2eTestCoverageReport {
15
+ readonly entries: readonly CliCommandCoverageEntry[];
16
+
17
+ private constructor(entries: readonly CliCommandCoverageEntry[]) {
18
+ this.entries = Object.freeze([...entries]);
19
+ Object.freeze(this);
20
+ }
21
+
22
+ static create(entries: readonly CliCommandCoverageEntry[]): CliE2eTestCoverageReport {
23
+ return new CliE2eTestCoverageReport(entries);
24
+ }
25
+
26
+ static empty(): CliE2eTestCoverageReport {
27
+ return new CliE2eTestCoverageReport([]);
28
+ }
29
+
30
+ uncoveredCommands(): readonly CliCommandCoverageEntry[] {
31
+ return this.entries.filter((e) => !e.hasE2eTest);
32
+ }
33
+
34
+ hasViolations(): boolean {
35
+ return this.uncoveredCommands().length > 0;
36
+ }
37
+
38
+ toMessages(): readonly string[] {
39
+ return this.uncoveredCommands().map(
40
+ (e) => `CLI command "${e.commandName}" has no corresponding E2E test`
41
+ );
42
+ }
43
+ }
44
+
45
+ // @story-id H08-07
@@ -0,0 +1,54 @@
1
+ /**
2
+ * @layer domain
3
+ * @unit validator-system
4
+ *
5
+ * ConsistencyReport 値オブジェクト
6
+ * 設計文書間のレイヤー整合性検証結果VO(L4-002専用)
7
+ */
8
+ import type { HarnessErrorLike } from './validation-result.js';
9
+
10
+ export interface MismatchPair {
11
+ readonly expected: string;
12
+ readonly actual: string;
13
+ readonly location: string;
14
+ }
15
+
16
+ export interface ConsistencyReportProps {
17
+ readonly mismatchPairs: readonly MismatchPair[];
18
+ readonly checkTargets: readonly string[];
19
+ readonly checkedAt?: string;
20
+ }
21
+
22
+ export class ConsistencyReport {
23
+ readonly mismatchPairs: readonly MismatchPair[];
24
+ readonly checkTargets: readonly string[];
25
+ readonly checkedAt: string;
26
+
27
+ private constructor(props: ConsistencyReportProps) {
28
+ this.mismatchPairs = Object.freeze([...props.mismatchPairs]);
29
+ this.checkTargets = Object.freeze([...props.checkTargets]);
30
+ this.checkedAt = props.checkedAt ?? new Date().toISOString();
31
+ Object.freeze(this);
32
+ }
33
+
34
+ static create(props: ConsistencyReportProps): ConsistencyReport {
35
+ return new ConsistencyReport(props);
36
+ }
37
+
38
+ hasMismatches(): boolean {
39
+ return this.mismatchPairs.length > 0;
40
+ }
41
+
42
+ mismatchCount(): number {
43
+ return this.mismatchPairs.length;
44
+ }
45
+
46
+ toHarnessErrors(): readonly HarnessErrorLike[] {
47
+ return this.mismatchPairs.map((pair) => ({
48
+ code: { value: 'L4-002', toString: () => 'L4-002' },
49
+ severity: { value: 'error', toString: () => 'error' },
50
+ message: `レイヤー整合性違反: expected "${pair.expected}" but got "${pair.actual}" at ${pair.location}`,
51
+ suggestion: '設計文書間のレイヤー依存方向を統一してください',
52
+ }));
53
+ }
54
+ }
@@ -0,0 +1,61 @@
1
+ /**
2
+ * @layer domain
3
+ * @unit validator-system
4
+ *
5
+ * DeadCodeReport 値オブジェクト
6
+ * 未使用エクスポートおよび到達不能コードの検出結果VO(L4-003専用)
7
+ */
8
+ import type { HarnessErrorLike } from './validation-result.js';
9
+
10
+ export interface UnreachableCodeLocation {
11
+ readonly filePath: string;
12
+ readonly range: { readonly startLine: number; readonly endLine: number };
13
+ }
14
+
15
+ export interface DeadCodeReportProps {
16
+ readonly unusedExports: readonly string[];
17
+ readonly unreachableCode: readonly UnreachableCodeLocation[];
18
+ readonly gcRecommended: boolean;
19
+ }
20
+
21
+ export class DeadCodeReport {
22
+ readonly unusedExports: readonly string[];
23
+ readonly unreachableCode: readonly UnreachableCodeLocation[];
24
+ readonly gcRecommended: boolean;
25
+
26
+ private constructor(props: DeadCodeReportProps) {
27
+ this.unusedExports = Object.freeze([...props.unusedExports]);
28
+ this.unreachableCode = Object.freeze([...props.unreachableCode]);
29
+ this.gcRecommended = props.gcRecommended;
30
+ Object.freeze(this);
31
+ }
32
+
33
+ static create(props: DeadCodeReportProps): DeadCodeReport {
34
+ return new DeadCodeReport(props);
35
+ }
36
+
37
+ hasDeadCode(): boolean {
38
+ return this.unusedExports.length > 0 || this.unreachableCode.length > 0;
39
+ }
40
+
41
+ toHarnessErrors(): readonly HarnessErrorLike[] {
42
+ const errors: HarnessErrorLike[] = [];
43
+ for (const exportId of this.unusedExports) {
44
+ errors.push({
45
+ code: { value: 'L4-003', toString: () => 'L4-003' },
46
+ severity: { value: 'error', toString: () => 'error' },
47
+ message: `未使用エクスポート: ${exportId}`,
48
+ suggestion: '未使用エクスポートを削除するか、他ファイルからimportしてください',
49
+ });
50
+ }
51
+ for (const loc of this.unreachableCode) {
52
+ errors.push({
53
+ code: { value: 'L4-003', toString: () => 'L4-003' },
54
+ severity: { value: 'error', toString: () => 'error' },
55
+ message: `到達不能コード: ${loc.filePath}:${loc.range.startLine}-${loc.range.endLine}`,
56
+ suggestion: '到達不能なコードブロックを削除してください',
57
+ });
58
+ }
59
+ return errors;
60
+ }
61
+ }