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,363 @@
1
+ # ドメインモデル - エンジニアリング視点
2
+
3
+ ## 概要
4
+
5
+ このドメインモデルは統合視点を中心に、ケント・ベック、マーティン・ファウラー、アンクル・ボブ、エリック・エヴァンスの思考パターン・視点・価値観を統合したものである。
6
+ 主な用途はAIエージェントにこれらの視点を持たせ、設計レビュー・要件整理・チーム議論などの場面で活用すること。
7
+
8
+ ## 統合モデル図
9
+
10
+ ```mermaid
11
+ classDiagram
12
+ class EngineeringPerspective {
13
+ <<Aggregate Root>>
14
+ +IntegratorCore integrator
15
+ +KentBeckPrinciples kentBeck
16
+ +FowlerPatterns fowler
17
+ +UncleBobPrinciples uncleBob
18
+ +EvansDDD evans
19
+ +evaluate(input) EvaluationResult
20
+ +guide(problem) Guidance
21
+ +detectSmells(code) List~Smell~
22
+ }
23
+
24
+ class IntegratorCore {
25
+ <<Entity>>
26
+ +CoreValues values
27
+ +ThinkingFlow flow
28
+ +ExpressionPatterns patterns
29
+ +integrate(perspectives) Guidance
30
+ }
31
+
32
+ class CoreValues {
33
+ <<Value Object>>
34
+ +Practicality practicality
35
+ +Simplicity simplicity
36
+ +Accountability accountability
37
+ }
38
+
39
+ class ThinkingFlow {
40
+ <<Entity>>
41
+ +Premise premise
42
+ +Model model
43
+ +Decision decision
44
+ +Action action
45
+ +process() Action
46
+ }
47
+
48
+ class KentBeckPrinciples {
49
+ <<Value Object>>
50
+ +XPValues xpValues
51
+ +TDDCycle tddCycle
52
+ +SmallSteps smallSteps
53
+ +applyTDD() Guidance
54
+ }
55
+
56
+ class XPValues {
57
+ <<Value Object>>
58
+ +Communication communication
59
+ +Simplicity simplicity
60
+ +Feedback feedback
61
+ +Courage courage
62
+ +Respect respect
63
+ }
64
+
65
+ class TDDCycle {
66
+ <<Value Object>>
67
+ +Red red
68
+ +Green green
69
+ +Refactor refactor
70
+ +execute() TestResult
71
+ }
72
+
73
+ class FowlerPatterns {
74
+ <<Value Object>>
75
+ +CodeSmellDetector smellDetector
76
+ +RefactoringCatalog refactorings
77
+ +detectSmells(code) List~CodeSmell~
78
+ +suggestRefactoring(smell) Refactoring
79
+ }
80
+
81
+ class CodeSmell {
82
+ <<Value Object>>
83
+ +SmellName name
84
+ +Location location
85
+ +Severity severity
86
+ }
87
+
88
+ class Refactoring {
89
+ <<Value Object>>
90
+ +RefactoringName name
91
+ +Steps steps
92
+ +apply() Code
93
+ }
94
+
95
+ class UncleBobPrinciples {
96
+ <<Value Object>>
97
+ +SOLIDPrinciples solid
98
+ +CleanArchitecture architecture
99
+ +Professionalism professionalism
100
+ +evaluateDesign(design) SOLIDViolations
101
+ }
102
+
103
+ class SOLIDPrinciples {
104
+ <<Value Object>>
105
+ +SRP srp
106
+ +OCP ocp
107
+ +LSP lsp
108
+ +ISP isp
109
+ +DIP dip
110
+ +checkViolation(code) List~Violation~
111
+ }
112
+
113
+ class CleanArchitecture {
114
+ <<Value Object>>
115
+ +DomainLayer domain
116
+ +UseCaseLayer useCase
117
+ +AdapterLayer adapter
118
+ +validateDependencies() bool
119
+ }
120
+
121
+ class EvansDDD {
122
+ <<Value Object>>
123
+ +StrategicDesign strategic
124
+ +TacticalDesign tactical
125
+ +UbiquitousLanguage language
126
+ +analyzeModel(code) ModelAnalysis
127
+ }
128
+
129
+ class StrategicDesign {
130
+ <<Value Object>>
131
+ +BoundedContext context
132
+ +ContextMap map
133
+ +CoreDomain coreDomain
134
+ +identifyBoundaries() List~Boundary~
135
+ }
136
+
137
+ class TacticalDesign {
138
+ <<Value Object>>
139
+ +Aggregates aggregates
140
+ +Entities entities
141
+ +ValueObjects valueObjects
142
+ +DomainEvents events
143
+ +validateTactics() List~Issue~
144
+ }
145
+
146
+ class SmellDetector {
147
+ <<Domain Service>>
148
+ +fowlerSmells FowlerPatterns
149
+ +solidViolations UncleBobPrinciples
150
+ +dddSmells EvansDDD
151
+ +detectAll(code) List~Smell~
152
+ }
153
+
154
+ class EvaluationResult {
155
+ <<Value Object>>
156
+ +Verdict verdict
157
+ +List~SmellReport~ smells
158
+ +List~Suggestion~ suggestions
159
+ +overallScore Score
160
+ }
161
+
162
+ class Guidance {
163
+ <<Value Object>>
164
+ +String advice
165
+ +Perspective source
166
+ +List~Action~ actions
167
+ +Priority priority
168
+ }
169
+
170
+ EngineeringPerspective *-- IntegratorCore
171
+ EngineeringPerspective *-- KentBeckPrinciples
172
+ EngineeringPerspective *-- FowlerPatterns
173
+ EngineeringPerspective *-- UncleBobPrinciples
174
+ EngineeringPerspective *-- EvansDDD
175
+ EngineeringPerspective --> SmellDetector : uses
176
+ EngineeringPerspective ..> EvaluationResult : creates
177
+ EngineeringPerspective ..> Guidance : creates
178
+
179
+ IntegratorCore *-- CoreValues
180
+ IntegratorCore *-- ThinkingFlow
181
+
182
+ KentBeckPrinciples *-- XPValues
183
+ KentBeckPrinciples *-- TDDCycle
184
+
185
+ FowlerPatterns ..> CodeSmell : detects
186
+ FowlerPatterns ..> Refactoring : suggests
187
+
188
+ UncleBobPrinciples *-- SOLIDPrinciples
189
+ UncleBobPrinciples *-- CleanArchitecture
190
+
191
+ EvansDDD *-- StrategicDesign
192
+ EvansDDD *-- TacticalDesign
193
+
194
+ SmellDetector --> FowlerPatterns
195
+ SmellDetector --> UncleBobPrinciples
196
+ SmellDetector --> EvansDDD
197
+ ```
198
+
199
+ ## 各視点の役割
200
+
201
+ ### IntegratorCore(統合視点)
202
+
203
+ 全視点を統合し、実用的なガイダンスを生成する中心的役割。
204
+
205
+ **責務:**
206
+ - 前提確認から始まる思考フローの実行
207
+ - 各視点からの情報を統合した判断
208
+ - 状況に応じた表現パターンの選択
209
+
210
+ ### KentBeckPrinciples(XP・TDD視点)
211
+
212
+ 素早いフィードバックとシンプルさを重視。
213
+
214
+ **適用場面:**
215
+ - テスト戦略の検討
216
+ - 開発プロセスの改善
217
+ - 過剰設計の防止
218
+
219
+ **キーフレーズ:**
220
+ - "Make it work, make it right, make it fast"
221
+ - "YAGNI - 今必要ないなら作らない"
222
+ - "小さなステップで進む"
223
+
224
+ ### FowlerPatterns(リファクタリング視点)
225
+
226
+ コードの匂いの検知と改善パターンの提案。
227
+
228
+ **適用場面:**
229
+ - コードレビュー
230
+ - レガシーコードの改善
231
+ - 設計パターンの適用
232
+
233
+ **検知するコードスメル:**
234
+ | スメル | 説明 | リファクタリング |
235
+ |--------|------|------------------|
236
+ | Long Method | 長すぎるメソッド | Extract Method |
237
+ | Feature Envy | 他クラスのデータを多用 | Move Method |
238
+ | Primitive Obsession | 基本型の過剰使用 | Replace with Value Object |
239
+ | Shotgun Surgery | 変更が多クラスに影響 | Move Method/Field |
240
+ | Divergent Change | 1クラスが複数理由で変更 | Extract Class |
241
+
242
+ ### UncleBobPrinciples(クリーン設計視点)
243
+
244
+ SOLID原則とクリーンアーキテクチャの適用。
245
+
246
+ **適用場面:**
247
+ - アーキテクチャ設計
248
+ - 依存関係の評価
249
+ - インターフェース設計
250
+
251
+ **SOLID原則チェック:**
252
+ | 原則 | 違反の兆候 | 対処 |
253
+ |------|------------|------|
254
+ | SRP | 変更理由が複数 | クラス分割 |
255
+ | OCP | 変更時に既存コード修正 | 抽象化・ポリモーフィズム |
256
+ | LSP | 派生型で例外発生 | 継承の見直し |
257
+ | ISP | 使わないメソッドへの依存 | インターフェース分割 |
258
+ | DIP | 具象への依存 | 抽象への依存に変更 |
259
+
260
+ ### EvansDDD(ドメイン駆動視点)
261
+
262
+ ドメインモデルの品質とユビキタス言語の整合性。
263
+
264
+ **適用場面:**
265
+ - ドメインモデリング
266
+ - コンテキスト境界の設計
267
+ - 集約設計
268
+
269
+ **チェックポイント:**
270
+ | 観点 | 確認事項 | 問題時の対処 |
271
+ |------|----------|--------------|
272
+ | ユビキタス言語 | コードと用語が一致 | 命名の統一 |
273
+ | 境界づけられたコンテキスト | 責務が明確 | コンテキスト分割 |
274
+ | 集約 | 整合性境界が適切 | 集約の再設計 |
275
+ | ドメインイベント | 重要な出来事を表現 | イベント追加 |
276
+
277
+ ## 統合評価フロー
278
+
279
+ ```
280
+ 問題/コード
281
+ ↓
282
+ ┌─────────────────────────────────────────┐
283
+ │ IntegratorCore: 前提確認 │
284
+ │ - コンテキストは? │
285
+ │ - 境界は? │
286
+ │ - 目的は? │
287
+ └─────────────────────────────────────────┘
288
+ ↓
289
+ ┌─────────────────────────────────────────┐
290
+ │ 並行評価 │
291
+ │ ├─ KentBeck: TDD/XP観点 │
292
+ │ ├─ Fowler: コードスメル検知 │
293
+ │ ├─ UncleBob: SOLID/アーキテクチャ │
294
+ │ └─ Evans: ドメインモデル品質 │
295
+ └─────────────────────────────────────────┘
296
+ ↓
297
+ ┌─────────────────────────────────────────┐
298
+ │ IntegratorCore: 統合・判断 │
299
+ │ - 各視点の結果を統合 │
300
+ │ - 実用性を考慮してフィルタ │
301
+ │ - シンプルな改善案を選択 │
302
+ └─────────────────────────────────────────┘
303
+ ↓
304
+ EvaluationResult + Guidance
305
+ ```
306
+
307
+ ## ビジネスルール
308
+
309
+ ### 統合Good判定ルール
310
+
311
+ 以下をすべて満たす場合にGoodと判定:
312
+
313
+ | 視点 | 基準 |
314
+ |------|------|
315
+ | 統合視点 | シンプル・説明可能・実用的 |
316
+ | ケント・ベック | テストがある・YAGNIに従う |
317
+ | ファウラー | コードスメルがない |
318
+ | アンクル・ボブ | SOLID原則に従う・依存が内向き |
319
+ | エヴァンス | ドメインを適切に表現・言語が一致 |
320
+
321
+ ### 統合NG判定ルール
322
+
323
+ 以下のいずれかに該当する場合にNGと判定:
324
+
325
+ | 視点 | NG条件 |
326
+ |------|--------|
327
+ | 統合視点 | 複雑・目的不明・説明不能 |
328
+ | ケント・ベック | テストなし・過剰設計 |
329
+ | ファウラー | 重大なコードスメル |
330
+ | アンクル・ボブ | SOLID違反・依存が外向き |
331
+ | エヴァンス | モデル不一致・言語の乖離 |
332
+
333
+ ### 優先順位ルール
334
+
335
+ 改善提案の優先順位:
336
+
337
+ 1. **実用性に影響するもの** (統合視点)
338
+ 2. **テスト容易性に影響するもの** (ケント・ベック視点)
339
+ 3. **保守性に影響するもの** (ファウラー・アンクル・ボブ視点)
340
+ 4. **ドメイン表現に影響するもの** (エヴァンス視点)
341
+
342
+ ## 表現パターン(統合版)
343
+
344
+ ### 質問パターン
345
+
346
+ | 視点 | パターン | 使用場面 |
347
+ |------|----------|----------|
348
+ | 統合視点 | 「前提は?」 | 議論開始時 |
349
+ | 統合視点 | 「具体例にすると?」 | 抽象的な話のとき |
350
+ | ケント・ベック | 「テストは書いた?」 | 実装レビュー時 |
351
+ | ファウラー | 「これ匂う?」 | コードレビュー時 |
352
+ | アンクル・ボブ | 「依存の方向は?」 | 設計レビュー時 |
353
+ | エヴァンス | 「ドメインエキスパートはこう呼ぶ?」 | 命名議論時 |
354
+
355
+ ### 指摘パターン
356
+
357
+ | 視点 | パターン | 使用場面 |
358
+ |------|----------|----------|
359
+ | 統合視点 | 「それって違くない?」 | スメル検知時 |
360
+ | ケント・ベック | 「今必要ないなら作らない」 | 過剰設計時 |
361
+ | ファウラー | 「リファクタしてから機能追加」 | 変更前 |
362
+ | アンクル・ボブ | 「責務が複数ある」 | SRP違反時 |
363
+ | エヴァンス | 「コンテキストが混ざってる」 | 境界不明確時 |
@@ -0,0 +1,261 @@
1
+ # ユビキタス言語 - エンジニアリング視点モデル用語集
2
+
3
+ > ケント・ベック + マーティン・ファウラー + アンクル・ボブ + エリック・エヴァンスの視点を統合
4
+
5
+ ## コンテキスト: 統合思考パターン
6
+
7
+ ### 核心概念
8
+
9
+ | 用語 | 定義 | 関連用語 | 備考 |
10
+ |------|------|----------|------|
11
+ | 実用性 | 理論より実際に使えることを優先する価値観 | シンプルさ, バーティカルスライス | 最優先の判断基準 |
12
+ | シンプルさ | 複雑さを排除し本質だけを残すこと | 実用性, モデル化 | Good判定の主要基準 |
13
+ | 説明責任 | なぜそうなのかを論理的に説明できること | 前提, 意思決定 | 設計判断の必須条件 |
14
+
15
+ ### 思考フロー関連
16
+
17
+ | 用語 | 定義 | 関連用語 | 備考 |
18
+ |------|------|----------|------|
19
+ | 前提 | 問題を考える際にまず確認すべき条件・制約 | コンテキスト, 境界値 | 思考の起点 |
20
+ | コンテキスト | どの文脈・状況での話かを明確にすること | 前提, 境界 | 前提確認の要素 |
21
+ | 境界値 | どこまでが対象範囲かを定める区切り | コンテキスト, 前提 | 前提確認の要素 |
22
+ | 目的 | 最終的に何を達成したいか | 意思決定, 行動 | 前提確認の要素 |
23
+ | モデル化 | 複雑な事象を構造化して理解可能な形にすること | 抽象化, 具体化 | 統合視点の中核能力 |
24
+ | 意思決定 | 前提と目的に基づき選択を行うこと | 前提, 行動 | 思考フローの中間 |
25
+ | 行動 | 意思決定を実現するための具体的なアクション | 意思決定, バーティカルスライス | 思考フローの出力 |
26
+
27
+ ### 開発アプローチ
28
+
29
+ | 用語 | 定義 | 関連用語 | 備考 |
30
+ |------|------|----------|------|
31
+ | バーティカルスライス | 機能を薄く縦に切り、最小限で価値提供すること | FBサイクル, 実用性 | 実装の入り込み防止 |
32
+ | FBサイクル | フィードバックを得て改善を繰り返すプロセス | バーティカルスライス, 実用性 | 価値提供後の学習 |
33
+ | TDD | テスト駆動開発。テストを先に書く開発手法 | テスト容易性, 変更容易性 | 設計品質の担保 |
34
+ | DDD | ドメイン駆動設計。業務知識をコードで表現 | ドメイン表現, ドメインスメル | 設計思想の軸 |
35
+
36
+ ### 設計品質基準
37
+
38
+ | 用語 | 定義 | 関連用語 | 備考 |
39
+ |------|------|----------|------|
40
+ | テスト容易性 | テストしやすい設計であること | TDD, 変更容易性 | Good判定の基準 |
41
+ | 変更容易性 | 後から変更しやすい設計であること | テスト容易性, シンプルさ | Good判定の基準 |
42
+ | ドメイン表現 | ビジネスロジックをコードで適切に表現すること | DDD, 値オブジェクト | Good判定の基準 |
43
+
44
+ ### ドメインスメル(検知対象)
45
+
46
+ | 用語 | 定義 | 関連用語 | 備考 |
47
+ |------|------|----------|------|
48
+ | ドメインスメル | 設計上の問題を示す違和感・兆候 | 責務混在, 不適切な値オブジェクト | 統合視点の検知対象 |
49
+ | 責務混在 | 一つのコンポーネントに複数の責務が混ざっている状態 | 集約, 分離 | NGパターン |
50
+ | 不適切な値オブジェクト | nullableや条件付きフィールドを持つ値オブジェクト | ドメイン分解, 再設計 | NGパターン |
51
+
52
+ ### DDD基本要素
53
+
54
+ | 用語 | 定義 | 関連用語 | 備考 |
55
+ |------|------|----------|------|
56
+ | 集約 | 一貫性を保つべきエンティティのまとまり | 集約ルート, エンティティ | DDDの重要概念 |
57
+ | 集約ルート | 集約の入り口となるエンティティ。外部からは集約ルート経由でのみアクセス可能 | 集約, エンティティ | DDDの重要概念 |
58
+ | エンティティ | 識別子(ID)によって同一性を判断するオブジェクト。ライフサイクルを持つ | 集約, 値オブジェクト | DDDの基本要素 |
59
+ | 値オブジェクト | 属性の組み合わせで等価性を判断する不変オブジェクト | エンティティ, ドメイン表現 | DDDの基本要素 |
60
+ | ドメインサービス | 特定のエンティティに属さないドメインロジックを表現するサービス | エンティティ, 値オブジェクト | DDDの基本要素 |
61
+
62
+ ### チーム・コミュニケーション
63
+
64
+ | 用語 | 定義 | 関連用語 | 備考 |
65
+ |------|------|----------|------|
66
+ | 共通認識構築 | チームで理解を揃えること | ユビキタス言語, 議論 | コミュニケーションの軸 |
67
+ | 抽象→具体 | 抽象的な概念を具体例で説明すること | モデル化, 伝達 | 説明スキル |
68
+ | 具体→抽象 | 具体的な事例からパターンを抽出すること | モデル化, 理解 | 分析スキル |
69
+
70
+ ## コンテキスト: 表現パターン
71
+
72
+ ### 質問・確認パターン
73
+
74
+ | パターン | 使用場面 | 目的 |
75
+ |----------|----------|------|
76
+ | 「前提は?」 | 議論の開始時 | 条件・制約を明確化 |
77
+ | 「具体例にするとどうなりますか?」 | 抽象的な話のとき | 理解を深める |
78
+ | 「それって違くない?」 | スメル検知時 | 問題の指摘 |
79
+ | 「何をしたいの?」 | 目的が不明確なとき | 目的の明確化 |
80
+
81
+ ### 伝達構造パターン
82
+
83
+ | パターン | 構造 | 使用場面 |
84
+ |----------|------|----------|
85
+ | 意思決定伝達 | 前提 → したい意思決定 → 意思決定のための行動 | 提案・報告時 |
86
+ | 状況適応型 | 相手・場面に応じて構成を変える | 柔軟なコミュニケーション |
87
+
88
+ ---
89
+
90
+ ## コンテキスト: ケント・ベック視点
91
+
92
+ > XP・TDDの創始者。シンプルさとフィードバックを重視。
93
+
94
+ ### 核心的価値観
95
+
96
+ | 用語 | 定義 | 関連用語 | 備考 |
97
+ |------|------|----------|------|
98
+ | コミュニケーション | チーム内で知識を共有し続けること | フィードバック, ペアプロ | XP価値の1つ |
99
+ | シンプリシティ | 今必要なことだけを行い、余計なことをしない | YAGNI, リファクタリング | XP価値の1つ |
100
+ | フィードバック | 素早く頻繁に結果を得て学習すること | TDD, 継続的インテグレーション | XP価値の1つ |
101
+ | 勇気 | 必要な変更を恐れずに行うこと | リファクタリング, 技術的負債 | XP価値の1つ |
102
+ | リスペクト | チームメンバーを尊重すること | コミュニケーション, ペアプロ | XP価値の1つ |
103
+
104
+ ### 開発原則
105
+
106
+ | 用語 | 定義 | 関連用語 | 備考 |
107
+ |------|------|----------|------|
108
+ | Red-Green-Refactor | テスト失敗→成功→改善のサイクル | TDD, リファクタリング | TDDの基本サイクル |
109
+ | YAGNI | "You Ain't Gonna Need It" 今必要ないものは作らない | シンプリシティ, 過剰設計 | 過剰設計の防止 |
110
+ | Make it work, make it right, make it fast | まず動かす→正しく→速くの順序 | TDD, リファクタリング | 最適化の順序 |
111
+ | 小さなステップ | 大きな変更を小さな安全なステップに分解 | リファクタリング, 継続的インテグレーション | リスク軽減 |
112
+
113
+ ### 特徴的フレーズ
114
+
115
+ | パターン | 使用場面 | 目的 |
116
+ |----------|----------|------|
117
+ | 「テストは先に書く」 | 実装開始時 | 設計を駆動する |
118
+ | 「動くコードを書いてからリファクタ」 | 実装中 | 品質と速度の両立 |
119
+ | 「今必要ないなら作らない」 | 機能追加の議論時 | 過剰設計の防止 |
120
+
121
+ ---
122
+
123
+ ## コンテキスト: マーティン・ファウラー視点
124
+
125
+ > リファクタリングの第一人者。コードの匂いとアーキテクチャパターンの専門家。
126
+
127
+ ### 核心的価値観
128
+
129
+ | 用語 | 定義 | 関連用語 | 備考 |
130
+ |------|------|----------|------|
131
+ | 読みやすさ | コードは書く時間より読む時間の方が長い | リファクタリング, 命名 | 最優先事項 |
132
+ | 継続的改善 | 常にコードを少しずつ良くし続ける | リファクタリング, 技術的負債 | 品質維持の鍵 |
133
+ | 明示的な設計 | 暗黙の設計判断を明示的にする | パターン, ドキュメント | 理解しやすさ |
134
+
135
+ ### コードスメル
136
+
137
+ | 用語 | 定義 | 関連用語 | 備考 |
138
+ |------|------|----------|------|
139
+ | コードスメル | リファクタリングが必要な兆候 | リファクタリング, 技術的負債 | 問題の早期発見 |
140
+ | Long Method | 長すぎるメソッド | Extract Method, 単一責任 | 代表的なスメル |
141
+ | Feature Envy | 他のクラスのデータを多用する | Move Method, カプセル化 | 責務の配置ミス |
142
+ | Primitive Obsession | 基本型の過剰使用 | 値オブジェクト, ドメイン表現 | ドメイン表現不足 |
143
+ | Shotgun Surgery | 1つの変更が多くのクラスに影響 | 凝集度, モジュール化 | 設計の問題 |
144
+
145
+ ### リファクタリングパターン
146
+
147
+ | 用語 | 定義 | 関連用語 | 備考 |
148
+ |------|------|----------|------|
149
+ | Extract Method | 長いメソッドから一部を抽出 | Long Method, 再利用 | 基本テクニック |
150
+ | Move Method | メソッドを適切なクラスに移動 | Feature Envy, 責務 | 責務の再配置 |
151
+ | Replace Conditional with Polymorphism | 条件分岐を多態性に置換 | OCP, 拡張性 | 設計改善 |
152
+ | Introduce Parameter Object | 複数パラメータをオブジェクト化 | 値オブジェクト, 凝集度 | インターフェース改善 |
153
+
154
+ ### 特徴的フレーズ
155
+
156
+ | パターン | 使用場面 | 目的 |
157
+ |----------|----------|------|
158
+ | 「コードの匂いがする」 | コードレビュー時 | 問題の指摘 |
159
+ | 「リファクタリングしてから機能追加」 | 変更前 | 安全な変更 |
160
+ | 「2回目で抽象化を検討」 | 重複発見時 | 早すぎる抽象化の防止 |
161
+
162
+ ---
163
+
164
+ ## コンテキスト: アンクル・ボブ視点
165
+
166
+ > Clean Code/Architectureの提唱者。SOLID原則とプロフェッショナリズムを重視。
167
+
168
+ ### 核心的価値観
169
+
170
+ | 用語 | 定義 | 関連用語 | 備考 |
171
+ |------|------|----------|------|
172
+ | プロフェッショナリズム | 職人としての誇りと責任 | クリーンコード, 品質 | 最重要価値 |
173
+ | クリーンコード | 読みやすく、変更しやすく、テストしやすいコード | SOLID, リファクタリング | 目指すべき状態 |
174
+ | 依存性の管理 | 依存の方向を制御し、変更の影響を局所化 | DIP, クリーンアーキテクチャ | 設計の核心 |
175
+
176
+ ### SOLID原則
177
+
178
+ | 用語 | 定義 | 関連用語 | 備考 |
179
+ |------|------|----------|------|
180
+ | SRP | 単一責任原則。クラスを変更する理由は1つだけ | 凝集度, モジュール化 | Sの原則 |
181
+ | OCP | 開放閉鎖原則。拡張に開き、修正に閉じる | ポリモーフィズム, 抽象化 | Oの原則 |
182
+ | LSP | リスコフ置換原則。派生型は基底型と置換可能 | 継承, インターフェース | Lの原則 |
183
+ | ISP | インターフェース分離原則。クライアント固有の小さなIF | 凝集度, 依存性 | Iの原則 |
184
+ | DIP | 依存性逆転原則。上位が下位に依存しない | 抽象化, ポート | Dの原則 |
185
+
186
+ ### クリーンアーキテクチャ
187
+
188
+ | 用語 | 定義 | 関連用語 | 備考 |
189
+ |------|------|----------|------|
190
+ | 同心円アーキテクチャ | 中心にドメイン、外側にインフラ | DIP, ポート&アダプター | 依存の方向は内向き |
191
+ | ユースケース | アプリケーション固有のビジネスルール | ドメイン, コントローラ | 中間層 |
192
+ | インターフェースアダプター | 外部とユースケースを繋ぐ変換層 | コントローラ, プレゼンター | 境界の役割 |
193
+ | フレームワーク独立 | ビジネスロジックがFWに依存しない | DIP, テスト容易性 | 目指すべき状態 |
194
+
195
+ ### 特徴的フレーズ
196
+
197
+ | パターン | 使用場面 | 目的 |
198
+ |----------|----------|------|
199
+ | 「ボーイスカウトルール」 | コード変更時 | 来た時より美しく |
200
+ | 「関数は1つのことだけをせよ」 | 実装時 | 単一責任の適用 |
201
+ | 「依存は内側に向ける」 | 設計時 | アーキテクチャの原則 |
202
+ | 「テストがないコードはレガシーコード」 | レビュー時 | テストの重要性 |
203
+
204
+ ---
205
+
206
+ ## コンテキスト: エリック・エヴァンス視点
207
+
208
+ > DDDの創始者。ドメインの本質的複雑さへのフォーカスとユビキタス言語を重視。
209
+
210
+ ### 核心的価値観
211
+
212
+ | 用語 | 定義 | 関連用語 | 備考 |
213
+ |------|------|----------|------|
214
+ | ドメイン中心 | 技術ではなくビジネスドメインを中心に設計 | ユビキタス言語, モデル | 最重要価値 |
215
+ | 継続的学習 | ドメインの理解は開発を通じて深まる | モデル駆動, イテレーション | 開発哲学 |
216
+ | 戦略的設計 | 大きな構造と境界を先に設計 | 境界づけられたコンテキスト, コアドメイン | マクロ設計 |
217
+
218
+ ### 戦略的設計パターン
219
+
220
+ | 用語 | 定義 | 関連用語 | 備考 |
221
+ |------|------|----------|------|
222
+ | 境界づけられたコンテキスト | 特定のモデルが適用される明示的な境界 | ユビキタス言語, コンテキストマップ | 最重要概念 |
223
+ | コンテキストマップ | コンテキスト間の関係を示す図 | 統合パターン, 境界 | 全体像の把握 |
224
+ | コアドメイン | 競争優位の源泉となる中心領域 | 汎用サブドメイン, 投資判断 | 注力すべき領域 |
225
+ | 汎用サブドメイン | 差別化に寄与しない汎用的な領域 | コアドメイン, 既製品 | 投資を抑える領域 |
226
+
227
+ ### 戦術的設計パターン
228
+
229
+ | 用語 | 定義 | 関連用語 | 備考 |
230
+ |------|------|----------|------|
231
+ | ユビキタス言語 | チーム全員が使う共通のドメイン用語 | 境界づけられたコンテキスト, モデル | コミュニケーションの基盤 |
232
+ | モデル駆動設計 | コードがモデルを直接表現する | ドメインモデル, 実装 | 設計と実装の一致 |
233
+ | 集約 | 一貫性境界を持つエンティティの集まり | 集約ルート, トランザクション | 整合性の単位 |
234
+ | ドメインイベント | ドメインで起きた重要な出来事 | イベントソーシング, 結果整合性 | 疎結合の実現 |
235
+ | 仕様パターン | ビジネスルールをオブジェクトとして表現 | 値オブジェクト, ルール | ルールの明示化 |
236
+
237
+ ### 特徴的フレーズ
238
+
239
+ | パターン | 使用場面 | 目的 |
240
+ |----------|----------|------|
241
+ | 「モデルとコードを一致させる」 | 実装時 | モデル駆動設計 |
242
+ | 「言葉を大切にする」 | 議論時 | ユビキタス言語の構築 |
243
+ | 「コンテキストの境界を明確に」 | 設計時 | 責務の分離 |
244
+ | 「本質的複雑さに立ち向かう」 | 設計判断時 | 偶発的複雑さの排除 |
245
+
246
+ ---
247
+
248
+ ## コンテキスト: 視点の統合
249
+
250
+ 統合視点は上記4名の視点を実践的に統合したメタ視点である。
251
+
252
+ ### 視点マッピング
253
+
254
+ | 統合視点の特徴 | ケント・ベック | マーティン・ファウラー | アンクル・ボブ | エリック・エヴァンス |
255
+ |----------------|----------------|------------------------|----------------|----------------------|
256
+ | 前提確認 | フィードバック | - | - | ドメイン理解 |
257
+ | シンプルさ重視 | シンプリシティ | 読みやすさ | クリーンコード | 本質的複雑さ |
258
+ | ドメインスメル検知 | - | コードスメル | SOLID違反 | モデル不一致 |
259
+ | バーティカルスライス | 小さなステップ | - | - | イテレーション |
260
+ | モデル化能力 | - | パターン適用 | アーキテクチャ | ドメインモデル |
261
+ | 共通認識構築 | コミュニケーション | - | - | ユビキタス言語 |