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,155 @@
1
+ ---
2
+ name: consistency-checker
3
+ description: AIDLC設計文書群のレイヤー間整合性チェック・矛盾/漏れ検出
4
+ model: sonnet
5
+ review: opus
6
+ ---
7
+
8
+ # Consistency Checker
9
+
10
+ AIDLCプロセスの全レイヤー設計文書を横断的に検証し、矛盾・漏れ・不整合を検出するスキル。
11
+
12
+ ## 前提条件チェック
13
+
14
+ ### 必須インプット
15
+ - **チェック対象の設計文書群** — 存在するレイヤーのみチェック。存在しないレイヤーはスキップ
16
+
17
+ ---
18
+
19
+ ## ⚠️ 3フェーズ実行ルール
20
+
21
+ **このスキルは3フェーズで実行する。**
22
+ - **Phase 1(計画)**: Opus がスコープ・方針・不明点を整理し、人間の承認を得る
23
+ - **Phase 2(実行)**: Sonnet 4.6 に委任して成果物を生成する(`scripts/delegate-sonnet.sh` 経由)
24
+ - **Phase 3(レビュー)**: Opus が成果物を検証し、問題があれば直接修正する
25
+
26
+ **Phase 1/2/3を同時に実行してはならない。モデルルーティングの詳細は `docs/principles/model-routing.md` を参照。**
27
+
28
+ ---
29
+
30
+ ## Phase 1: チェック計画(plan)
31
+
32
+ ### 目的
33
+ チェック対象・範囲を確認し、人間の承認を得る。
34
+
35
+ ### 出力
36
+ 会話内で以下を報告する:
37
+
38
+ ```markdown
39
+ # 整合性チェック計画
40
+
41
+ ## 1. チェック対象ファイル一覧
42
+ | # | レイヤー | ファイルパス | 存在 |
43
+ |---|---------|-----------|------|
44
+
45
+ ## 2. 実行するチェック項目
46
+ (存在するレイヤーのみ対象)
47
+ - [ ] ストーリー↔Unit
48
+ - [ ] Unit↔Domain
49
+ - [ ] ...
50
+
51
+ ## 3. スキップするチェック項目
52
+ (文書が存在しないため)
53
+ - ...
54
+
55
+ ## 4. QA(不明点・確認事項)
56
+
57
+ ### [Question] Q1: {質問タイトル}
58
+ {質問の詳細と背景}
59
+ **推奨案:** {AIの推奨案}
60
+
61
+ [Answer]
62
+ (人間が回答を記入)
63
+ ```
64
+
65
+ ### Phase 1 完了条件
66
+ - チェック計画を報告した
67
+ - 不明点がある場合は`[Question]`セクションに記載した
68
+ - **人間にボールを渡した**
69
+ - **チェック結果はまだ報告していない**
70
+
71
+ ---
72
+
73
+ ## Phase 2: 実行(execution)
74
+
75
+ ### 開始条件
76
+ - 人間がPhase 1のチェック計画を承認した
77
+
78
+ ### チェック項目
79
+
80
+ 以下を上位→下位の順で検証する。各チェックの具体的な検証手法は [references/チェックリスト.md](references/チェックリスト.md) を参照。
81
+
82
+ 1. **ストーリー↔Unit** — 全ストーリーがいずれかのUnitに所属しているか
83
+ 2. **Unit↔Domain** — 全Unitの業務概念がドメインモデルに定義されているか
84
+ 3. **Domain↔論理設計** — 全集約/リポジトリに対応するコンポーネントがあるか
85
+ 4. **論理設計↔環境設計** — 全サービス/DB変更が環境設計に列挙されているか
86
+ 5. **環境設計↔実装** — 環境設計の制約が実装に反映されているか
87
+ 6. **マイグレーション台帳↔実ファイル** — 台帳のエントリと実ファイルが一致しているか
88
+ 7. **制約集↔実装** — フレームワーク制約集のルールがコードで遵守されているか
89
+
90
+ ### Phase 2 最低出力基準(Sonnet委任時の品質制約)
91
+
92
+ 以下の基準を満たさない出力は不完全とみなし、Phase 3レビューでBLOCKとする。
93
+
94
+ | 基準 | 最低要件 |
95
+ |------|---------|
96
+ | チェック項目網羅 | Phase 1で計画した全チェック項目が実行されていること |
97
+ | 具体的な不整合記述 | 検出された不整合に具体的なファイル名・行・内容が記載されていること |
98
+ | 重要度判定 | 各不整合に重要度(高/中/低)が付与されていること |
99
+ | 推奨アクション | 各不整合に対する具体的な修正アクションが提案されていること |
100
+ | スキップ理由 | スキップしたチェック項目にスキップ理由が記載されていること |
101
+
102
+ ### 出力フォーマット
103
+
104
+ ```markdown
105
+ # 整合性チェック結果
106
+
107
+ ## 検出された不整合
108
+
109
+ | # | レイヤー間 | 不整合内容 | 重要度 | 推奨アクション |
110
+ |---|----------|----------|--------|-------------|
111
+
112
+ ## チェック対象外(スキップ)
113
+ - ...
114
+
115
+ ## サマリー
116
+ - チェック対象レイヤー数: N
117
+ - 不整合件数: N
118
+ ```
119
+
120
+ ---
121
+
122
+ ---
123
+
124
+ ## Phase 3: レビュー(Opus review)
125
+
126
+ ### 実行主体
127
+ メインセッション(Opus 4.6)が実行する。Sonnetへの再委任は行わない。
128
+
129
+ ### レビュー手順
130
+ 1. Sonnetが出力したファイルを読み込む
131
+ 2. `docs/principles/model-routing.md` のレビュー観点 R1〜R7 に沿って検証する
132
+ 3. **スキル固有レビュー観点**を検証する
133
+ 4. 判定結果を出力する
134
+
135
+ ### スキル固有レビュー観点(BLOCK基準)
136
+ - [ ] Phase 1で計画した全チェック項目が実行されているか
137
+ - [ ] 不整合の記述が具体的か(曖昧な「不一致あり」だけでないか)
138
+ - [ ] 重要度の判定基準が一貫しているか
139
+ - [ ] 推奨アクションが実行可能か(対応スキル名が明記されているか)
140
+ - [ ] 偽陰性がないか(明らかな不整合を見逃していないか)
141
+
142
+ ### engineering-perspective レビュー観点(WARN基準)
143
+ - [ ] ドメインスメル(責務混在・言語の乖離・境界不明確)がレイヤー横断で検出されているか
144
+ - [ ] SOLID違反(SRP・DIP)が設計レイヤー間で見逃されていないか
145
+ - [ ] コードスメル(Shotgun Surgery等)の兆候が設計変更の波及パターンから検出されているか
146
+
147
+ ### 判定と修正
148
+ - **BLOCK項目にFAIL** → Opusが直接修正してから完了とする
149
+ - **WARNのみFAIL** → Opusが直接修正してから完了とする
150
+ - **全PASS** → 完了
151
+
152
+ ## 注意事項
153
+
154
+ - 不整合の修正は行わず、検出と推奨アクションの提示に徹する
155
+ - 技術スタック固有の用語は使わず、汎用的な表現でチェックする
@@ -0,0 +1,60 @@
1
+ # 整合性チェック 検証手法ガイド
2
+
3
+ 各チェック項目の汎用的な検証手法。技術スタックに依存しない。
4
+
5
+ ## 1. ストーリー ↔ Unit
6
+
7
+ **手法:** ストーリーIDの全数マッチング
8
+
9
+ 1. ストーリー一覧からストーリーIDを全て抽出する
10
+ 2. 各Unit定義ファイルからストーリーID参照を全て抽出する
11
+ 3. ストーリー一覧にあるがUnit定義に無いID = 孤立ストーリー
12
+
13
+ ## 2. Unit ↔ Domain
14
+
15
+ **手法:** 業務概念のクロスリファレンス
16
+
17
+ 1. 各Unit定義から主要な業務名詞(エンティティ候補)を抽出する
18
+ 2. ドメインモデルの集約・エンティティ・値オブジェクト名と照合する
19
+ 3. Unit定義に登場するがドメインモデルに未定義の業務名詞 = 漏れ
20
+
21
+ ## 3. Domain ↔ 論理設計
22
+
23
+ **手法:** 集約→コンポーネント対応表の照合
24
+
25
+ 1. ドメインモデルから集約名・リポジトリインターフェース名を抽出する
26
+ 2. 論理設計からコンポーネント名(コントローラ、ユースケース、リポジトリ実装等)を抽出する
27
+ 3. ドメインモデルの集約に対応するコンポーネントが論理設計に無い = 漏れ
28
+
29
+ ## 4. 論理設計 ↔ 環境設計
30
+
31
+ **手法:** インフラ要件の突合
32
+
33
+ 1. 論理設計から以下を抽出する:
34
+ - 新規サービス/関数の定義
35
+ - 新規テーブル/ビュー/マイグレーションの定義
36
+ - 外部連携・認証に関する記述
37
+ 2. 環境設計の各セクションと突合する:
38
+ - サービス構成マニフェストに全サービスが列挙されているか
39
+ - マイグレーション台帳に全DB変更が記載されているか
40
+
41
+ ## 5. 環境設計 ↔ 実装
42
+
43
+ **手法:** 設定ファイルとコードの機械的照合
44
+
45
+ 1. 環境設計のマイグレーション台帳からファイル名を抽出 → 実ファイルの存在確認
46
+ 2. 環境設計のサービス構成から設定項目を抽出 → 設定ファイルとの照合
47
+ 3. 環境設計のフレームワーク制約集からルールを抽出 → コード内のパターン検索
48
+
49
+ ## 汎用検索パターン例
50
+
51
+ ```
52
+ # ストーリーID抽出(マークダウンテーブルから)
53
+ grep -oE 'US-[0-9]+|US-DEV-[0-9]+' docs/product/user_stories.md
54
+
55
+ # Unit内のストーリー参照抽出
56
+ grep -oE 'US-[0-9]+|US-DEV-[0-9]+' docs/product/units/*.md
57
+
58
+ # ドメインモデルの集約名抽出
59
+ grep -E '^### .+集約|Aggregate' docs/product/construction/*/domain_model.md
60
+ ```
@@ -0,0 +1,131 @@
1
+ ---
2
+ name: doc-freshness-checker
3
+ description: 設計文書の鮮度チェック(L4バリデータ拡張)。`p2:check-freshness` CLIを使い、設計文書の最終更新日が閾値を超えていないか、コード変更と設計文書の乖離がないかを検出する。使用タイミング: 「設計文書が古くなっていないか確認して」「ドキュメントの鮮度チェックを実行して」「L4 freshness チェック」「設計とコードの乖離を調べて」など。
4
+ model: sonnet
5
+ review: opus
6
+ ---
7
+
8
+ # Doc Freshness Checker
9
+
10
+ 設計文書の鮮度(freshness)を検証し、古くなった文書や対応コードとの乖離を検出するスキル。
11
+ `phase2-extensions` Unit の `p2:check-freshness` CLIをラップし、結果を解釈・対処する。
12
+
13
+ ## 前提条件
14
+
15
+ - `phasegate.config.json` に `docFreshnessThresholds` が設定されていること(未設定時はデフォルト値使用)
16
+ - git リポジトリ内で実行すること(最終更新日は `git log` で判定)
17
+
18
+ ---
19
+
20
+ ## ⚠️ 2フェーズ実行ルール
21
+
22
+ - **Phase 1(計画)**: チェック対象スコープを確認し、人間の承認を得る
23
+ - **Phase 2(実行)**: CLIを実行し、結果を解釈してアクションを提案する
24
+
25
+ **Phase 1/2を同時に実行してはならない。**
26
+
27
+ ---
28
+
29
+ ## Phase 1: チェック計画(plan)
30
+
31
+ ### 出力(会話内のみ)
32
+
33
+ ```markdown
34
+ # Doc Freshness チェック計画
35
+
36
+ ## チェック対象スコープ
37
+ - ディレクトリ: {デフォルト: docs/product/construction/}
38
+ - 閾値: {phasegate.config.json の値 or デフォルト 30日}
39
+
40
+ ## 実行コマンド
41
+ pnpm run p2:check-freshness [--dir {path}] [--threshold {days}]
42
+
43
+ ## QA
44
+ [Question] Q1: ...
45
+ [Answer]
46
+ ```
47
+
48
+ ### Phase 1 完了条件
49
+ - スコープを報告した
50
+ - 人間にボールを渡した
51
+ - **CLIはまだ実行していない**
52
+
53
+ ---
54
+
55
+ ## Phase 2: 実行(execution)
56
+
57
+ ### Step 1: CLIの実行
58
+
59
+ ```bash
60
+ pnpm run p2:check-freshness
61
+ ```
62
+
63
+ オプション:
64
+ - `--dir <path>` — チェック対象ディレクトリ(デフォルト: `docs/product/construction/`)
65
+ - `--threshold <days>` — 警告閾値(日数)
66
+
67
+ ### Step 2: 結果の解釈
68
+
69
+ `CheckDocFreshnessOutput` の構造:
70
+
71
+ | フィールド | 意味 |
72
+ |-----------|------|
73
+ | `results[].status` | `ok` / `warn` / `error` |
74
+ | `results[].documentPath` | チェック対象ファイルパス |
75
+ | `results[].daysSinceUpdate` | 最終更新からの日数 |
76
+ | `results[].threshold` | 設定閾値 |
77
+ | `summary.error` | エラー件数(即対応必要) |
78
+ | `summary.warn` | 警告件数(確認推奨) |
79
+
80
+ ### Step 3: アクションの提案
81
+
82
+ | 状態 | 推奨アクション |
83
+ |------|--------------|
84
+ | `error`(閾値超過) | cascade-updater で上位設計文書を更新 |
85
+ | `warn`(閾値近接) | 設計文書の内容確認・必要に応じて更新 |
86
+ | `ok` | 対応不要 |
87
+
88
+ ### 出力フォーマット
89
+
90
+ ```markdown
91
+ # Doc Freshness チェック結果
92
+
93
+ ## サマリー
94
+ - 総ドキュメント数: N
95
+ - ok: N / warn: N / error: N
96
+
97
+ ## 要対応(error)
98
+ | ファイル | 最終更新 | 閾値超過日数 | 推奨アクション |
99
+ |---------|---------|------------|--------------|
100
+
101
+ ## 要確認(warn)
102
+ | ファイル | 最終更新 | 残り日数 |
103
+ |---------|---------|---------|
104
+
105
+ ## 次のアクション
106
+ (errorがある場合は `cascade-updater` の実行を提案)
107
+ ```
108
+
109
+ ---
110
+
111
+ ## phasegate.config.json 設定例
112
+
113
+ ```json
114
+ {
115
+ "docFreshnessThresholds": {
116
+ "domain_model.md": 90,
117
+ "logical_design.md": 60,
118
+ "unit_test_design.md": 30,
119
+ "default": 30
120
+ }
121
+ }
122
+ ```
123
+
124
+ ---
125
+
126
+ ## 関連スキル
127
+
128
+ | スキル | 用途 |
129
+ |-------|------|
130
+ | `cascade-updater` | errorが検出された設計文書の更新 |
131
+ | `consistency-checker` | 文書間整合性の検証(freshness修正後の確認) |
@@ -0,0 +1,152 @@
1
+ ---
2
+ name: domain-designer
3
+ description: DDD戦術パターンでドメインモデル(集約・エンティティ・VO・イベント)を設計(AIDLC Step 2.1)
4
+ model: opus
5
+ ---
6
+
7
+ # Domain Designer
8
+
9
+ DDD戦術パターンを用いてドメインモデルを設計するスキル。AIDLCプロセスのStep 2.1に対応。
10
+
11
+ ## 前提条件チェック
12
+
13
+ ### 必須インプット(存在しなければ`[Question]`で提供を要求)
14
+ - **Unit定義** — 対象Unitの担当ストーリー・機能要件
15
+ - **統合契約** — Unit間のAPI仕様
16
+
17
+ ### 任意インプット(あれば参照)
18
+ - **既存ドメインモデル** — 既にある場合はフォーマットに準拠する
19
+ - **プロダクト概要** — ユビキタス言語やコアドメインの理解
20
+ - **Shared Kernel** — 複数Unitが共有するドメインモデル
21
+
22
+ ---
23
+
24
+ ## ⚠️ 上位レイヤー存在チェック
25
+
26
+ **このスキルは AIDLC Step 4「Domainの設計」に対応します。実行前に上位設計の存在を確認してください。**
27
+
28
+ ### 依存する上位設計文書
29
+
30
+ | ファイル | 必須 | チェック方法 |
31
+ |---------|------|------------|
32
+ | `docs/product/units/{対象unit}.md` | ✅ 必須 | 対象Unitのファイル存在を確認 |
33
+ | `docs/product/units/integration_contract.md` | ✅ 必須 | ファイルの存在を確認 |
34
+
35
+ ### 上位設計が存在しない場合のアクション
36
+
37
+ 上位設計文書が存在しない場合、**設計を開始せず**、以下を行う:
38
+
39
+ 1. **状況報告** — ユーザーに不足している設計文書を明示
40
+ 2. **選択肢提示** — 以下の選択肢を提示
41
+ - 上位設計(unit-designer)を先に実行する
42
+ - 上位設計をスキップして進める(非推奨)
43
+ 3. **ユーザー指示待ち** — 独自判断で設計を開始しない
44
+
45
+ **報告テンプレート:**
46
+ ```markdown
47
+ ## ⚠️ 上位レイヤー設計が見つかりません
48
+
49
+ 以下の設計文書が存在しないため、ドメイン設計を開始できません:
50
+ - `docs/product/units/{unit}.md` ❌ 未作成
51
+ - `docs/product/units/integration_contract.md` ❌ 未作成
52
+
53
+ ### 推奨アクション
54
+ `unit-designer` スキルを使用してUnit設計を作成してください。
55
+
56
+ ### 選択肢
57
+ 1. **unit-designerを先に実行する**(推奨)
58
+ 2. **このまま進める**(上位設計なしで進める場合、整合性リスクあり)
59
+
60
+ どちらを選択しますか?
61
+ ```
62
+
63
+ ---
64
+
65
+ ## ⚠️ 2フェーズ実行ルール
66
+
67
+ **このスキルは必ず2フェーズに分けて実行する。Phase 1で計画を作成し、人間の承認を得てからPhase 2で成果物を作成する。Phase 1とPhase 2を同時に実行してはならない。**
68
+
69
+ ---
70
+
71
+ ## Phase 1: 計画(plan)
72
+
73
+ ### 目的
74
+ ドメインモデリングの方針・集約の特定方針・不明点を整理し、人間の承認を得る。
75
+
76
+ ### 出力ファイル
77
+ `docs/inception/{unit}/domain_model_plan.md`
78
+
79
+ ### 計画ファイルの構成
80
+
81
+ ```markdown
82
+ # ドメインモデル設計計画: {Unit名}
83
+
84
+ ## 1. スコープ
85
+ - 対象Unitと担当ストーリー
86
+ - 他Unitとの境界
87
+
88
+ ## 2. 集約候補の分析
89
+ - ストーリーから抽出した業務名詞一覧
90
+ - 集約候補とその根拠
91
+
92
+ ## 3. 設計方針
93
+ - 集約の粒度方針
94
+ - 値オブジェクト vs エンティティの判断基準
95
+ - Shared Kernelとの関係
96
+
97
+ ## 4. QA(不明点・確認事項)
98
+
99
+ ### [Question] Q1: {質問タイトル}
100
+ {質問の詳細と背景}
101
+ **推奨案:** {AIの推奨案}
102
+
103
+ [Answer]
104
+ (人間が回答を記入)
105
+
106
+ ## 5. 前提条件・リスク
107
+ - ...
108
+ ```
109
+
110
+ ### Phase 1 完了条件
111
+ - 計画ファイルを出力した
112
+ - 不明点がある場合は`[Question]`セクションに記載した
113
+ - **人間にボールを渡した**
114
+ - **成果物(ドメインモデル本体)はまだ作成していない**
115
+
116
+ ---
117
+
118
+ ## Phase 2: 実行(execution)
119
+
120
+ ### 開始条件
121
+ - 人間がPhase 1の計画を承認した
122
+ - QAセクションの全[Question]に[Answer]が記入されている(QAがある場合)
123
+
124
+ ### ワークフロー
125
+
126
+ 1. **集約の特定** — ライフサイクルが一致する業務名詞を集約にまとめ、集約ルートを決定
127
+ 2. **エンティティ・値オブジェクトの設計** — 各集約内部の構造、メソッド、設計ルールに沿った配置
128
+ 3. **不変条件の定義** — 各集約のビジネスルール制約を列挙
129
+ 4. **状態遷移の定義** — 状態遷移表の作成
130
+ 5. **ドメインイベントの定義** — 集約が発行するイベントを列挙
131
+ 6. **クラス図の作成** — Mermaid形式で関係を図示
132
+ 7. **品質評価(engineering-perspective)** — 設計完了後、以下の観点で自己評価し、問題があれば修正してから成果物を確定する
133
+ - **ドメインスメル**: 責務混在・不適切なVO・言語の乖離・境界不明確がないか
134
+ - **SOLID**: 集約がSRPに従っているか、集約間の依存方向が正しいか
135
+ - **シンプルさ**: 過度に複雑なモデルになっていないか、各集約を簡潔に説明できるか
136
+
137
+ ### 出力ファイル
138
+
139
+ | 種別 | 配置先 |
140
+ |------|--------|
141
+ | 成果物 | `docs/product/construction/{unit}/domain_model.md` |
142
+
143
+ ---
144
+
145
+ ## 注意事項
146
+
147
+ - **ファイル配置は `docs/folder_management_rules.md` に従うこと**
148
+ - **コードスニペットは生成しない**(設計文書のみ)
149
+ - ユビキタス言語がある場合、命名はそれに準拠する
150
+ - 既存のShared Kernelがある場合は、共有モデルとの整合性を保つ
151
+ - ビジネスロジックは集約・エンティティ・値オブジェクトに配置する(ユースケースは調整役に徹する)
152
+ - 集約間の参照はIDのみ(直接参照禁止)
@@ -0,0 +1,136 @@
1
+ ---
2
+ name: engineering-perspective
3
+ description: |
4
+ ケント・ベック + マーティン・ファウラー + アンクル・ボブ + エリック・エヴァンスの視点を統合したエンジニアリング思考フレームワーク。
5
+ 以下の場面で使用:
6
+ (1) 設計・コードレビュー時に品質を多角的に評価したい
7
+ (2) 要件や仕様を整理・明確化したい
8
+ (3) コードスメル・SOLID違反・ドメインスメルを検知したい
9
+ (4) TDD/リファクタリング/DDDのベストプラクティスを適用したい
10
+ (5) チーム議論で共通認識を構築したい
11
+ トリガー例: 「レビューして」「これどう思う?」「設計見て」「SOLID的にどう?」「リファクタ必要?」「ドメイン的に正しい?」
12
+ ---
13
+
14
+ # Engineering Perspective
15
+
16
+ 4人の巨匠の視点を統合し、実用性・シンプルさ・説明責任の観点でレビュー・設計・議論を行う。
17
+
18
+ ## 視点一覧
19
+
20
+ | 視点 | 専門 | キーワード |
21
+ |------|------|------------|
22
+ | **統合視点** | 統合・実用性 | 前提確認, シンプルさ, 説明責任 |
23
+ | **ケント・ベック** | XP・TDD | Red-Green-Refactor, YAGNI, 小さなステップ |
24
+ | **マーティン・ファウラー** | リファクタリング | コードスメル, Extract Method, 読みやすさ |
25
+ | **アンクル・ボブ** | Clean Code | SOLID, 依存性逆転, プロフェッショナリズム |
26
+ | **エリック・エヴァンス** | DDD | ユビキタス言語, 境界づけられたコンテキスト, 集約 |
27
+
28
+ ## 統合思考フロー
29
+
30
+ ```
31
+ 問題 → 前提確認(統合視点) → 並行評価(4視点) → 統合判断(統合視点) → ガイダンス
32
+ ```
33
+
34
+ ### 1. 前提確認(統合視点)
35
+
36
+ まず確認:
37
+ - **コンテキスト**: どの文脈での話か
38
+ - **境界**: どこまでが対象範囲か
39
+ - **目的**: 何を達成したいのか
40
+
41
+ ### 2. 並行評価(4視点)
42
+
43
+ | 視点 | 評価観点 |
44
+ |------|----------|
45
+ | ケント・ベック | テストある? YAGNI守ってる? |
46
+ | ファウラー | コードスメルない? リファクタ必要? |
47
+ | アンクル・ボブ | SOLID守ってる? 依存の方向正しい? |
48
+ | エヴァンス | ドメイン表現してる? 言語一致してる? |
49
+
50
+ ### 3. 統合判断(統合視点)
51
+
52
+ 各視点の結果を統合し、実用性を考慮してシンプルな改善案を選択。
53
+
54
+ ## スメル検知
55
+
56
+ ### コードスメル(ファウラー視点)
57
+
58
+ | スメル | 兆候 | 対処 |
59
+ |--------|------|------|
60
+ | Long Method | メソッドが長い | Extract Method |
61
+ | Feature Envy | 他クラスのデータ多用 | Move Method |
62
+ | Primitive Obsession | 基本型の過剰使用 | Value Objectに置換 |
63
+ | Shotgun Surgery | 変更が多クラスに波及 | Move Method/Field |
64
+
65
+ ### SOLID違反(アンクル・ボブ視点)
66
+
67
+ | 原則 | 違反の兆候 | 対処 |
68
+ |------|------------|------|
69
+ | SRP | 変更理由が複数 | クラス分割 |
70
+ | OCP | 変更時に既存コード修正 | 抽象化 |
71
+ | LSP | 派生型で例外発生 | 継承の見直し |
72
+ | ISP | 使わないメソッドに依存 | IF分割 |
73
+ | DIP | 具象に依存 | 抽象に依存 |
74
+
75
+ ### ドメインスメル(エヴァンス + 統合視点)
76
+
77
+ | スメル | 兆候 | 対処 |
78
+ |--------|------|------|
79
+ | 責務混在 | 集約に複数責務 | 概念を分離 |
80
+ | 不適切なVO | nullable値オブジェクト | ドメイン的に分解 |
81
+ | 言語の乖離 | コードと用語が不一致 | 命名統一 |
82
+ | 境界不明確 | コンテキストが混在 | 境界を明確化 |
83
+
84
+ ## 評価基準
85
+
86
+ ### Good判定(すべて満たす)
87
+
88
+ - [ ] シンプル・説明可能・実用的(統合視点)
89
+ - [ ] テストがある・YAGNIに従う(ケント・ベック)
90
+ - [ ] コードスメルがない(ファウラー)
91
+ - [ ] SOLID原則に従う・依存が内向き(アンクル・ボブ)
92
+ - [ ] ドメインを適切に表現・言語が一致(エヴァンス)
93
+
94
+ ### NG判定(いずれかに該当)
95
+
96
+ - [ ] 複雑・目的不明・説明不能
97
+ - [ ] テストなし・過剰設計
98
+ - [ ] 重大なコードスメル
99
+ - [ ] SOLID違反・依存が外向き
100
+ - [ ] モデル不一致・言語の乖離
101
+
102
+ ## 表現パターン
103
+
104
+ ### 質問
105
+
106
+ | 視点 | パターン | 場面 |
107
+ |------|----------|------|
108
+ | 統合視点 | 「前提は?」 | 議論開始時 |
109
+ | 統合視点 | 「具体例にすると?」 | 抽象的な話 |
110
+ | ケント・ベック | 「テストは書いた?」 | 実装レビュー |
111
+ | ファウラー | 「これ匂う?」 | コードレビュー |
112
+ | アンクル・ボブ | 「依存の方向は?」 | 設計レビュー |
113
+ | エヴァンス | 「ドメインエキスパートはこう呼ぶ?」 | 命名議論 |
114
+
115
+ ### 指摘
116
+
117
+ | 視点 | パターン | 場面 |
118
+ |------|----------|------|
119
+ | 統合視点 | 「それって違くない?」 | スメル検知 |
120
+ | ケント・ベック | 「今必要ないなら作らない」 | 過剰設計 |
121
+ | ファウラー | 「リファクタしてから機能追加」 | 変更前 |
122
+ | アンクル・ボブ | 「責務が複数ある」 | SRP違反 |
123
+ | エヴァンス | 「コンテキストが混ざってる」 | 境界不明確 |
124
+
125
+ ### 開発アプローチ
126
+
127
+ - 「バーティカルスライスでまず価値提供」(統合視点)
128
+ - 「Make it work, make it right, make it fast」(ケント・ベック)
129
+ - 「2回目で抽象化を検討」(ファウラー)
130
+ - 「ボーイスカウトルール: 来た時より美しく」(アンクル・ボブ)
131
+ - 「モデルとコードを一致させる」(エヴァンス)
132
+
133
+ ## 参照ドキュメント
134
+
135
+ - **統合モデル**: [references/domain-model.md](references/domain-model.md) - 完全なドメインモデル図
136
+ - **用語集**: [references/glossary.md](references/glossary.md) - 各視点のユビキタス言語