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,56 @@
1
+ /**
2
+ * @layer domain
3
+ * @unit quick-mode
4
+ *
5
+ * 変更ファイル1件を表す値オブジェクト
6
+ */
7
+
8
+ import { type ChangeKind, isChangeKind } from '../types/change-kind.js';
9
+
10
+ export class ChangedFile {
11
+ readonly filePath: string;
12
+ readonly changeKind: ChangeKind;
13
+
14
+ private constructor(filePath: string, changeKind: ChangeKind) {
15
+ this.filePath = filePath;
16
+ this.changeKind = changeKind;
17
+ }
18
+
19
+ static create(params: { filePath: string; changeKind: string }): ChangedFile {
20
+ const { filePath, changeKind } = params;
21
+
22
+ if (!filePath) {
23
+ throw new Error('filePath must not be empty');
24
+ }
25
+ if (filePath.endsWith('/')) {
26
+ throw new Error('filePath must not end with a slash');
27
+ }
28
+ if (!isChangeKind(changeKind)) {
29
+ throw new Error(`changeKind must be one of 'CREATE', 'MODIFY', 'DELETE'. Got: "${changeKind}"`);
30
+ }
31
+
32
+ return new ChangedFile(filePath, changeKind);
33
+ }
34
+
35
+ isUnder(directoryPrefix: string): boolean {
36
+ return this.filePath.startsWith(directoryPrefix);
37
+ }
38
+
39
+ hasExtension(ext: string): boolean {
40
+ return this.filePath.endsWith(ext);
41
+ }
42
+
43
+ matchesPattern(pattern: string): boolean {
44
+ // Glob/suffix パターンマッチング
45
+ // '*' はワイルドカードとして扱う
46
+ if (pattern.startsWith('*')) {
47
+ const suffix = pattern.slice(1);
48
+ return this.filePath.endsWith(suffix);
49
+ }
50
+ return this.filePath === pattern;
51
+ }
52
+
53
+ equals(other: ChangedFile): boolean {
54
+ return this.filePath === other.filePath && this.changeKind === other.changeKind;
55
+ }
56
+ }
@@ -0,0 +1,69 @@
1
+ /**
2
+ * @layer domain
3
+ * @unit quick-mode
4
+ *
5
+ * Quick Mode設定を表す値オブジェクト
6
+ */
7
+
8
+ export class QuickModeConfigError extends Error {
9
+ constructor(message: string) {
10
+ super(message);
11
+ this.name = 'QuickModeConfigError';
12
+ }
13
+ }
14
+
15
+
16
+ export class QuickModeConfig {
17
+ readonly allowedCategories: readonly string[];
18
+ readonly maintainedLayers: readonly string[];
19
+ readonly relaxedGates: readonly string[];
20
+
21
+ private constructor(
22
+ allowedCategories: readonly string[],
23
+ maintainedLayers: readonly string[],
24
+ relaxedGates: readonly string[]
25
+ ) {
26
+ this.allowedCategories = allowedCategories;
27
+ this.maintainedLayers = maintainedLayers;
28
+ this.relaxedGates = relaxedGates;
29
+ Object.freeze(this);
30
+ }
31
+
32
+ static create(raw: {
33
+ allowedCategories: string[];
34
+ maintainedLayers: string[];
35
+ relaxedGates: string[];
36
+ }): QuickModeConfig {
37
+ const { allowedCategories, maintainedLayers, relaxedGates } = raw;
38
+
39
+ if (allowedCategories.length === 0) {
40
+ throw new QuickModeConfigError('allowedCategories must not be empty');
41
+ }
42
+
43
+ return new QuickModeConfig(
44
+ Object.freeze([...allowedCategories]),
45
+ Object.freeze([...maintainedLayers]),
46
+ Object.freeze([...relaxedGates])
47
+ );
48
+ }
49
+
50
+ isAllowed(category: string): boolean {
51
+ return this.allowedCategories.includes(category);
52
+ }
53
+
54
+ isMaintained(validatorId: string): boolean {
55
+ return this.maintainedLayers.includes(validatorId);
56
+ }
57
+
58
+ isRelaxed(validatorId: string): boolean {
59
+ return this.relaxedGates.includes(validatorId);
60
+ }
61
+
62
+ equals(other: QuickModeConfig): boolean {
63
+ return (
64
+ JSON.stringify(this.allowedCategories) === JSON.stringify(other.allowedCategories) &&
65
+ JSON.stringify(this.maintainedLayers) === JSON.stringify(other.maintainedLayers) &&
66
+ JSON.stringify(this.relaxedGates) === JSON.stringify(other.relaxedGates)
67
+ );
68
+ }
69
+ }
@@ -0,0 +1,47 @@
1
+ /**
2
+ * @layer domain
3
+ * @unit quick-mode
4
+ *
5
+ * Quick Mode最終判定の複合値オブジェクト
6
+ */
7
+
8
+ import type { QuickModeEligibility } from './quick-mode-eligibility.js';
9
+ import type { ValidatorRelaxationProfile } from './validator-relaxation-profile.js';
10
+
11
+ export class QuickModeDecision {
12
+ readonly eligibility: QuickModeEligibility;
13
+ readonly relaxationProfile: ValidatorRelaxationProfile | undefined;
14
+
15
+ private constructor(
16
+ eligibility: QuickModeEligibility,
17
+ relaxationProfile: ValidatorRelaxationProfile | undefined
18
+ ) {
19
+ this.eligibility = eligibility;
20
+ this.relaxationProfile = relaxationProfile;
21
+ }
22
+
23
+ static approved(
24
+ eligibility: QuickModeEligibility,
25
+ profile: ValidatorRelaxationProfile
26
+ ): QuickModeDecision {
27
+ if (!eligibility.isEligible()) {
28
+ throw new Error('Cannot create approved QuickModeDecision with ineligible eligibility (INV-D2)');
29
+ }
30
+ return new QuickModeDecision(eligibility, profile);
31
+ }
32
+
33
+ static rejected(eligibility: QuickModeEligibility): QuickModeDecision {
34
+ return new QuickModeDecision(eligibility, undefined);
35
+ }
36
+
37
+ isApproved(): boolean {
38
+ return this.eligibility.isEligible();
39
+ }
40
+
41
+ equals(other: QuickModeDecision): boolean {
42
+ if (!this.eligibility.equals(other.eligibility)) return false;
43
+ if (this.relaxationProfile === undefined && other.relaxationProfile === undefined) return true;
44
+ if (this.relaxationProfile === undefined || other.relaxationProfile === undefined) return false;
45
+ return this.relaxationProfile.equals(other.relaxationProfile);
46
+ }
47
+ }
@@ -0,0 +1,62 @@
1
+ /**
2
+ * @layer domain
3
+ * @unit quick-mode
4
+ *
5
+ * Quick Mode適用可否の判定結果を表す値オブジェクト
6
+ */
7
+
8
+ import type { RejectionRule } from '../types/rejection-rule.js';
9
+ import type { ChangedFile } from './changed-file.js';
10
+
11
+ export class QuickModeEligibility {
12
+ readonly eligible: boolean;
13
+ readonly reason: string;
14
+ readonly rejectionRule: RejectionRule | undefined;
15
+ readonly rejectedFiles: readonly ChangedFile[] | undefined;
16
+
17
+ private constructor(
18
+ eligible: boolean,
19
+ reason: string,
20
+ rejectionRule: RejectionRule | undefined,
21
+ rejectedFiles: readonly ChangedFile[] | undefined
22
+ ) {
23
+ this.eligible = eligible;
24
+ this.reason = reason;
25
+ this.rejectionRule = rejectionRule;
26
+ this.rejectedFiles = rejectedFiles;
27
+ Object.freeze(this);
28
+ }
29
+
30
+ static eligible(reason: string): QuickModeEligibility {
31
+ if (!reason) {
32
+ throw new Error('reason must not be empty (INV-E3)');
33
+ }
34
+ return new QuickModeEligibility(true, reason, undefined, undefined);
35
+ }
36
+
37
+ static rejected(
38
+ rule: RejectionRule,
39
+ rejectedFiles: readonly ChangedFile[],
40
+ reason: string
41
+ ): QuickModeEligibility {
42
+ if (rejectedFiles.length === 0) {
43
+ throw new Error('rejectedFiles must not be empty when eligible=false (INV-E2)');
44
+ }
45
+ if (!reason) {
46
+ throw new Error('reason must not be empty (INV-E3)');
47
+ }
48
+ return new QuickModeEligibility(false, reason, rule, Object.freeze([...rejectedFiles]));
49
+ }
50
+
51
+ isEligible(): boolean {
52
+ return this.eligible;
53
+ }
54
+
55
+ equals(other: QuickModeEligibility): boolean {
56
+ return (
57
+ this.eligible === other.eligible &&
58
+ this.reason === other.reason &&
59
+ this.rejectionRule === other.rejectionRule
60
+ );
61
+ }
62
+ }
@@ -0,0 +1,116 @@
1
+ /**
2
+ * @layer domain
3
+ * @unit quick-mode
4
+ *
5
+ * Quick Mode時のバリデータ実行構成を表す値オブジェクト
6
+ */
7
+
8
+ const L2_IDS = ['L2-001', 'L2-002', 'L2-003'] as const;
9
+ const L3_IDS = ['L3-001', 'L3-002', 'L3-003', 'L3-004'] as const;
10
+
11
+ type L2Id = (typeof L2_IDS)[number];
12
+ type L3Id = (typeof L3_IDS)[number];
13
+
14
+ export interface ValidatorRelaxationProfileParams {
15
+ levelDependencyRelaxed: false;
16
+ l1: { all: true };
17
+ l2: { maintained: string[]; skipped: string[] };
18
+ l3: { maintained: string[]; skipped: string[] };
19
+ l4: { all: false };
20
+ phaseExecution: { twoPhaseRequired: false };
21
+ }
22
+
23
+ export class ValidatorRelaxationProfile {
24
+ readonly levelDependencyRelaxed: false;
25
+ readonly l1: { readonly all: true };
26
+ readonly l2: { readonly maintained: readonly string[]; readonly skipped: readonly string[] };
27
+ readonly l3: { readonly maintained: readonly string[]; readonly skipped: readonly string[] };
28
+ readonly l4: { readonly all: false };
29
+ readonly phaseExecution: { readonly twoPhaseRequired: false };
30
+
31
+ private constructor(params: ValidatorRelaxationProfileParams) {
32
+ this.levelDependencyRelaxed = false;
33
+ this.l1 = Object.freeze({ all: true as const });
34
+ this.l2 = Object.freeze({
35
+ maintained: Object.freeze([...params.l2.maintained]),
36
+ skipped: Object.freeze([...params.l2.skipped]),
37
+ });
38
+ this.l3 = Object.freeze({
39
+ maintained: Object.freeze([...params.l3.maintained]),
40
+ skipped: Object.freeze([...params.l3.skipped]),
41
+ });
42
+ this.l4 = Object.freeze({ all: false as const });
43
+ this.phaseExecution = Object.freeze({ twoPhaseRequired: false as const });
44
+ Object.freeze(this);
45
+ }
46
+
47
+ static createDefault(): ValidatorRelaxationProfile {
48
+ return new ValidatorRelaxationProfile({
49
+ levelDependencyRelaxed: false,
50
+ l1: { all: true },
51
+ l2: { maintained: ['L2-002', 'L2-003'], skipped: ['L2-001'] },
52
+ l3: { maintained: ['L3-001'], skipped: ['L3-002', 'L3-003', 'L3-004'] },
53
+ l4: { all: false },
54
+ phaseExecution: { twoPhaseRequired: false },
55
+ });
56
+ }
57
+
58
+ static create(params: {
59
+ levelDependencyRelaxed?: false;
60
+ l1?: { all: true };
61
+ l2: { maintained: string[]; skipped: string[] };
62
+ l3: { maintained: string[]; skipped: string[] };
63
+ l4?: { all: false };
64
+ phaseExecution?: { twoPhaseRequired: false };
65
+ }): ValidatorRelaxationProfile {
66
+ const { l2, l3 } = params;
67
+
68
+ // INV-P5: l2.maintained ∪ l2.skipped = {L2-001, L2-002, L2-003}
69
+ const l2Union = [...l2.maintained, ...l2.skipped].sort();
70
+ const l2Expected = [...L2_IDS].sort();
71
+ if (JSON.stringify(l2Union) !== JSON.stringify(l2Expected)) {
72
+ throw new Error(
73
+ `INV-P5 violated: l2.maintained ∪ l2.skipped must equal {${L2_IDS.join(', ')}}. Got: {${l2Union.join(', ')}}`
74
+ );
75
+ }
76
+
77
+ // INV-P6: l3.maintained ∪ l3.skipped = {L3-001, L3-002, L3-003, L3-004}
78
+ const l3Union = [...l3.maintained, ...l3.skipped].sort();
79
+ const l3Expected = [...L3_IDS].sort();
80
+ if (JSON.stringify(l3Union) !== JSON.stringify(l3Expected)) {
81
+ throw new Error(
82
+ `INV-P6 violated: l3.maintained ∪ l3.skipped must equal {${L3_IDS.join(', ')}}. Got: {${l3Union.join(', ')}}`
83
+ );
84
+ }
85
+
86
+ return new ValidatorRelaxationProfile({
87
+ levelDependencyRelaxed: false,
88
+ l1: { all: true },
89
+ l2,
90
+ l3,
91
+ l4: { all: false },
92
+ phaseExecution: { twoPhaseRequired: false },
93
+ });
94
+ }
95
+
96
+ isMaintained(validatorId: string): boolean {
97
+ return (
98
+ this.l2.maintained.includes(validatorId) || this.l3.maintained.includes(validatorId)
99
+ );
100
+ }
101
+
102
+ isSkipped(validatorId: string): boolean {
103
+ return (
104
+ this.l2.skipped.includes(validatorId) || this.l3.skipped.includes(validatorId)
105
+ );
106
+ }
107
+
108
+ equals(other: ValidatorRelaxationProfile): boolean {
109
+ return (
110
+ JSON.stringify(this.l2.maintained) === JSON.stringify(other.l2.maintained) &&
111
+ JSON.stringify(this.l2.skipped) === JSON.stringify(other.l2.skipped) &&
112
+ JSON.stringify(this.l3.maintained) === JSON.stringify(other.l3.maintained) &&
113
+ JSON.stringify(this.l3.skipped) === JSON.stringify(other.l3.skipped)
114
+ );
115
+ }
116
+ }
@@ -0,0 +1,43 @@
1
+ /**
2
+ * @layer application
3
+ * @unit quick-mode
4
+ *
5
+ * quick-mode ユニットの公開エントリポイント
6
+ */
7
+
8
+ // Domain Value Objects
9
+ export { ChangeCategory, UnknownChangeCategoryError } from './domain/value-objects/change-category.js';
10
+ export { ChangedFile } from './domain/value-objects/changed-file.js';
11
+ export { ChangeClassification } from './domain/value-objects/change-classification.js';
12
+ export { QuickModeConfig, QuickModeConfigError } from './domain/value-objects/quick-mode-config.js';
13
+ export { QuickModeDecision } from './domain/value-objects/quick-mode-decision.js';
14
+ export { QuickModeEligibility } from './domain/value-objects/quick-mode-eligibility.js';
15
+ export { ValidatorRelaxationProfile } from './domain/value-objects/validator-relaxation-profile.js';
16
+
17
+ // Domain Services
18
+ export { QuickModeJudgmentEngine } from './domain/services/quick-mode-judgment-engine.js';
19
+ export { ValidatorRelaxationService } from './domain/services/validator-relaxation-service.js';
20
+
21
+ // Application DTOs
22
+ export type { QuickModeDecisionContract } from './application/dto/quick-mode-decision-contract.js';
23
+ export type { QuickModeEligibilityContract } from './application/dto/quick-mode-eligibility-contract.js';
24
+ export type { ValidatorRelaxationProfileContract } from './application/dto/validator-relaxation-profile-contract.js';
25
+
26
+ // Application UseCases
27
+ export { JudgeQuickModeEligibilityUseCase } from './application/usecases/judge-quick-mode-eligibility-usecase.js';
28
+ export { BuildRelaxationProfileUseCase, QuickModeNotEligibleError } from './application/usecases/build-relaxation-profile-usecase.js';
29
+ export { ExecuteQuickCiCheckUseCase } from './application/usecases/execute-quick-ci-check-usecase.js';
30
+
31
+ // Application Mappers
32
+ export { QuickModeDecisionContractMapper } from './application/mappers/quick-mode-decision-contract-mapper.js';
33
+
34
+ // Infrastructure Adapters
35
+ export { GitDiffChangedFilesAdapter, GitNotAvailableError, GitCommandError } from './infrastructure/adapters/git-diff-changed-files-adapter.js';
36
+ export { HarnessConfigQuickModeConfigAdapter, HarnessConfigNotFoundError, HarnessConfigParseError } from './infrastructure/adapters/harness-config-quick-mode-config-adapter.js';
37
+ export { ValidatorSystemValidatorIdRegistryAdapter } from './infrastructure/adapters/validator-system-validator-id-registry-adapter.js';
38
+
39
+ // Presentation
40
+ export { CiCheckQuickModeHandler } from './presentation/handlers/ci-check-quick-mode-handler.js';
41
+ export { HumanQuickModeFormatter } from './presentation/formatters/human-quick-mode-formatter.js';
42
+ export { AgentQuickModeFormatter } from './presentation/formatters/agent-quick-mode-formatter.js';
43
+ export { JsonQuickModeFormatter } from './presentation/formatters/json-quick-mode-formatter.js';
@@ -0,0 +1,92 @@
1
+ /**
2
+ * @layer infrastructure
3
+ * @unit quick-mode
4
+ *
5
+ * git diff から ChangedFile[] を取得する Adapter
6
+ */
7
+
8
+ import * as childProcess from 'node:child_process';
9
+ import * as path from 'node:path';
10
+ import { ChangedFile } from '../../domain/value-objects/changed-file.js';
11
+ import type { ChangeKind } from '../../domain/types/change-kind.js';
12
+
13
+ export class GitNotAvailableError extends Error {
14
+ constructor(message: string) {
15
+ super(`Git is not available: ${message}`);
16
+ this.name = 'GitNotAvailableError';
17
+ }
18
+ }
19
+
20
+ export class GitCommandError extends Error {
21
+ constructor(message: string) {
22
+ super(`Git command failed: ${message}`);
23
+ this.name = 'GitCommandError';
24
+ }
25
+ }
26
+
27
+ function mapGitStatus(status: string): ChangeKind {
28
+ if (status === 'A') return 'CREATE';
29
+ if (status === 'D') return 'DELETE';
30
+ if (status.startsWith('R')) return 'MODIFY';
31
+ return 'MODIFY'; // M and others
32
+ }
33
+
34
+ function normalizePath(filePath: string): string {
35
+ // path.normalize で ./ や ../ を解決し、先頭の ./ を除去
36
+ const normalized = path.normalize(filePath);
37
+ // Windows対応のため / に統一
38
+ return normalized.replace(/\\/g, '/').replace(/^\.\//, '');
39
+ }
40
+
41
+ export class GitDiffChangedFilesAdapter {
42
+ getChangedFiles(): readonly ChangedFile[] {
43
+ let output: string;
44
+
45
+ try {
46
+ output = childProcess.execSync('git diff --name-status --cached HEAD', {
47
+ encoding: 'utf8',
48
+ }) as string;
49
+ } catch (err) {
50
+ const message = err instanceof Error ? err.message : String(err);
51
+ if (
52
+ message.includes('git: command not found') ||
53
+ message.includes('not a git repository') ||
54
+ message.includes('not found')
55
+ ) {
56
+ throw new GitNotAvailableError(message);
57
+ }
58
+ throw new GitCommandError(message);
59
+ }
60
+
61
+ if (!output || !output.trim()) {
62
+ return [];
63
+ }
64
+
65
+ const lines = output.trim().split('\n');
66
+ const files: ChangedFile[] = [];
67
+
68
+ for (const line of lines) {
69
+ if (!line.trim()) continue;
70
+
71
+ const parts = line.split('\t');
72
+ const status = parts[0];
73
+
74
+ let filePath: string;
75
+ if (status.startsWith('R') && parts.length >= 3) {
76
+ // Rename: R100\told.ts\tnew.ts → 移動先を使用
77
+ filePath = parts[2];
78
+ } else {
79
+ filePath = parts[1];
80
+ }
81
+
82
+ if (!filePath) continue;
83
+
84
+ const changeKind = mapGitStatus(status);
85
+ const normalizedPath = normalizePath(filePath);
86
+
87
+ files.push(ChangedFile.create({ filePath: normalizedPath, changeKind }));
88
+ }
89
+
90
+ return Object.freeze(files);
91
+ }
92
+ }
@@ -0,0 +1,75 @@
1
+ /**
2
+ * @layer infrastructure
3
+ * @unit quick-mode
4
+ *
5
+ * phasegate.config.json から QuickModeConfig を取得する Adapter
6
+ */
7
+
8
+ import * as fs from 'node:fs/promises';
9
+ import * as path from 'node:path';
10
+ import { QuickModeConfig } from '../../domain/value-objects/quick-mode-config.js';
11
+
12
+ export class HarnessConfigNotFoundError extends Error {
13
+ constructor(filePath: string) {
14
+ super(`phasegate.config.json not found: ${filePath}`);
15
+ this.name = 'HarnessConfigNotFoundError';
16
+ }
17
+ }
18
+
19
+ export class HarnessConfigParseError extends Error {
20
+ constructor(message: string) {
21
+ super(`Failed to parse phasegate.config.json: ${message}`);
22
+ this.name = 'HarnessConfigParseError';
23
+ }
24
+ }
25
+
26
+ const DEFAULT_QUICK_MODE_CONFIG = {
27
+ allowedCategories: ['bugfix', 'docs', 'test', 'config'],
28
+ maintainedLayers: ['L1', 'L2-002', 'L2-003', 'L3-001'],
29
+ relaxedGates: ['L2-001', 'L3-002', 'L3-003', 'L3-004', 'L4'],
30
+ };
31
+
32
+ export class HarnessConfigQuickModeConfigAdapter {
33
+ private readonly configPath: string;
34
+
35
+ constructor(configPath?: string) {
36
+ this.configPath = configPath ?? path.resolve(process.cwd(), 'phasegate.config.json');
37
+ }
38
+
39
+ async getQuickModeConfig(): Promise<QuickModeConfig> {
40
+ let content: string;
41
+
42
+ try {
43
+ content = await fs.readFile(this.configPath, 'utf8') as string;
44
+ } catch (err) {
45
+ const error = err as NodeJS.ErrnoException;
46
+ if (error.code === 'ENOENT') {
47
+ throw new HarnessConfigNotFoundError(this.configPath);
48
+ }
49
+ throw err;
50
+ }
51
+
52
+ let parsed: Record<string, unknown>;
53
+ try {
54
+ parsed = JSON.parse(content) as Record<string, unknown>;
55
+ } catch (err) {
56
+ throw new HarnessConfigParseError(err instanceof Error ? err.message : String(err));
57
+ }
58
+
59
+ const quickMode = parsed['quickMode'] as {
60
+ allowedCategories?: string[];
61
+ maintainedLayers?: string[];
62
+ relaxedGates?: string[];
63
+ } | undefined;
64
+
65
+ if (!quickMode) {
66
+ return QuickModeConfig.create(DEFAULT_QUICK_MODE_CONFIG);
67
+ }
68
+
69
+ return QuickModeConfig.create({
70
+ allowedCategories: quickMode.allowedCategories ?? DEFAULT_QUICK_MODE_CONFIG.allowedCategories,
71
+ maintainedLayers: quickMode.maintainedLayers ?? DEFAULT_QUICK_MODE_CONFIG.maintainedLayers,
72
+ relaxedGates: quickMode.relaxedGates ?? DEFAULT_QUICK_MODE_CONFIG.relaxedGates,
73
+ });
74
+ }
75
+ }
@@ -0,0 +1,23 @@
1
+ /**
2
+ * @layer infrastructure
3
+ * @unit quick-mode
4
+ *
5
+ * integration_contract.md §9 の確定ID一覧を静的定義で保持する ValidatorIdRegistry Adapter
6
+ */
7
+
8
+ const STATIC_VALIDATOR_IDS: readonly string[] = Object.freeze([
9
+ 'L1-001', 'L1-002', 'L1-003', 'L1-004', 'L1-005', 'L1-006', 'L1-007', 'L1-008',
10
+ 'L2-001', 'L2-002', 'L2-003',
11
+ 'L3-001', 'L3-002', 'L3-003', 'L3-004',
12
+ 'L4-001', 'L4-002', 'L4-003',
13
+ ]);
14
+
15
+ export class ValidatorSystemValidatorIdRegistryAdapter {
16
+ getAllValidatorIds(): readonly string[] {
17
+ return STATIC_VALIDATOR_IDS;
18
+ }
19
+
20
+ async getAllIds(): Promise<readonly string[]> {
21
+ return STATIC_VALIDATOR_IDS;
22
+ }
23
+ }
@@ -0,0 +1,14 @@
1
+ /**
2
+ * @layer presentation
3
+ * @unit quick-mode
4
+ *
5
+ * Quick Mode表示オプション DTO
6
+ */
7
+
8
+ export interface QuickModeRenderOptions {
9
+ readonly quick: boolean;
10
+ readonly files?: string;
11
+ readonly dryRun?: boolean;
12
+ readonly format?: 'human' | 'agent' | 'json';
13
+ readonly failOnReject?: boolean;
14
+ }
@@ -0,0 +1,56 @@
1
+ /**
2
+ * @layer presentation
3
+ * @unit quick-mode
4
+ *
5
+ * AIエージェント向け詳細テキストフォーマッター
6
+ */
7
+
8
+ import type { QuickModeDecisionContract } from '../../application/dto/quick-mode-decision-contract.js';
9
+
10
+ export class AgentQuickModeFormatter {
11
+ format(decision: QuickModeDecisionContract): string {
12
+ const { eligibility, relaxationProfile } = decision;
13
+ const lines: string[] = [];
14
+
15
+ lines.push(`## Quick Mode Decision`);
16
+ lines.push(`eligible: ${eligibility.eligible}`);
17
+ lines.push(`reason: ${eligibility.reason}`);
18
+
19
+ if (!eligibility.eligible) {
20
+ lines.push(`rejectionRule: ${eligibility.rejectionRule ?? ''}`);
21
+
22
+ if (eligibility.rejectedFiles && eligibility.rejectedFiles.length > 0) {
23
+ lines.push('');
24
+ lines.push('### Rejected Files');
25
+ for (const file of eligibility.rejectedFiles) {
26
+ lines.push(`- ${file.filePath} [${file.changeKind}]`);
27
+ }
28
+ }
29
+ } else if (relaxationProfile) {
30
+ lines.push('');
31
+ lines.push('### Relaxation Profile');
32
+ lines.push(`levelDependencyRelaxed: ${relaxationProfile.levelDependencyRelaxed}`);
33
+ lines.push(`L1: all=${relaxationProfile.l1.all}`);
34
+
35
+ lines.push('');
36
+ lines.push('#### L2 Validators');
37
+ lines.push(`Maintained: ${[...relaxationProfile.l2.maintained].join(', ')}`);
38
+ lines.push(`Skipped: ${[...relaxationProfile.l2.skipped].join(', ')}`);
39
+
40
+ lines.push('');
41
+ lines.push('#### L3 Validators');
42
+ lines.push(`Maintained: ${[...relaxationProfile.l3.maintained].join(', ')}`);
43
+ lines.push(`Skipped: ${[...relaxationProfile.l3.skipped].join(', ')}`);
44
+
45
+ lines.push('');
46
+ lines.push('#### L4 Validators');
47
+ lines.push(`all: ${relaxationProfile.l4.all} (all skipped)`);
48
+
49
+ lines.push('');
50
+ lines.push('#### Phase Execution');
51
+ lines.push(`twoPhaseRequired: ${relaxationProfile.phaseExecution.twoPhaseRequired}`);
52
+ }
53
+
54
+ return lines.join('\n') + '\n';
55
+ }
56
+ }