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,170 @@
1
+ # 5-Layer Defense Model (L0-L4)
2
+
3
+ Phasegate enforces quality through 5 layers that run at different points in the development lifecycle. Each layer catches a distinct class of defect, and together they form a defense-in-depth strategy that prevents design drift, code smells, security issues, and stale artifacts from reaching production.
4
+
5
+ ## Overview
6
+
7
+ ```
8
+ ┌─────────────────────────────────────────────────────────────┐
9
+ │ L0 HOOKS ENGINE — Agent hook configuration validation │
10
+ │ L1 EDITOR TIME — Biome AST rules (real-time) │
11
+ │ L2 PRE-COMMIT — Validators (before commit) │
12
+ │ L3 CI/CD — Validators (before merge) │
13
+ │ L4 SCHEDULED — Validators (weekly) │
14
+ └─────────────────────────────────────────────────────────────┘
15
+ ▲ fastest feedback slowest feedback ▼
16
+ ```
17
+
18
+ Layers are additive: L1 rules still apply when L3 runs. The earlier a defect is caught, the cheaper it is to fix. L0 and L1 give sub-second feedback; L4 catches slow-moving drift that only matters over days or weeks.
19
+
20
+ ---
21
+
22
+ ## L0: Hooks Engine
23
+
24
+ The Hooks Engine validates agent hook configuration and enforces completion gates before work can proceed.
25
+
26
+ | Rule | Description |
27
+ |------|-------------|
28
+ | **hook-config** | Validates `.harness-hooks.yml` configuration structure and semantics |
29
+ | **gate-check** | Verifies that all required completion gates have been satisfied |
30
+
31
+ **Command:**
32
+
33
+ ```bash
34
+ npx harness validate --layer L0
35
+ ```
36
+
37
+ ---
38
+
39
+ ## L1: Editor Time — Biome AST Rules
40
+
41
+ L1 rules run in real-time as code is written. They are implemented as Biome AST rules and provide immediate feedback in the editor.
42
+
43
+ ### Structural Rules
44
+
45
+ | Rule | Description |
46
+ |------|-------------|
47
+ | **require-unit-comment** | Every source file must have a `// @unit <unit-name>` annotation |
48
+ | **require-layer-comment** | Every source file must have a `// @layer <layer-name>` annotation |
49
+ | **no-layer-violation** | Import direction must follow `domain -> application -> infrastructure/presentation`. Reverse dependencies are rejected. |
50
+ | **enforce-folder-structure** | Files must reside in the correct layer directory matching their `@layer` annotation |
51
+ | **no-ghost-file** | No orphaned files outside the unit structure |
52
+
53
+ ### Code Quality Rules
54
+
55
+ | Rule | Description |
56
+ |------|-------------|
57
+ | **no-any-abuse** | Restricts TypeScript `any` usage to prevent type-safety erosion |
58
+ | **no-comment-flood** | Prevents excessive comments that obscure code intent |
59
+ | **no-code-duplication** | Detects duplicated code blocks that should be extracted |
60
+
61
+ ### Test Quality Rules (L1)
62
+
63
+ | Rule | Description |
64
+ |------|-------------|
65
+ | **it-test-mock-detection** | Detects improper mock usage in integration tests |
66
+ | **stub-comment-detection** | Flags stub comments left in test files (e.g., `// TODO: implement`) |
67
+
68
+ **Command:**
69
+
70
+ ```bash
71
+ npx harness lint
72
+ ```
73
+
74
+ ---
75
+
76
+ ## L2: Pre-commit Validators
77
+
78
+ L2 validators run before every commit. They enforce process discipline and test quality standards.
79
+
80
+ | Validator | Description |
81
+ |-----------|-------------|
82
+ | **phase-gate** | Enforces design-before-implementation order. Code changes to `scripts/harness/` are blocked unless the corresponding design documents exist in `docs/product/construction/`. |
83
+ | **metadata** | Verifies completeness of source file annotations: `@unit`, `@layer`, `@US-XXX`, and `@story` |
84
+ | **test-quality** | Enforces test authoring standards: AAA pattern (Arrange/Act/Assert), `actual` variable naming, single-act-per-test, and no mocking in domain layer tests |
85
+
86
+ **Command:**
87
+
88
+ ```bash
89
+ npx harness validate --layer L2
90
+ ```
91
+
92
+ ---
93
+
94
+ ## L3: CI/CD Validators
95
+
96
+ L3 validators run in the CI/CD pipeline before a merge is permitted. They cover security, performance, coverage, and traceability.
97
+
98
+ | Validator | Description |
99
+ |-----------|-------------|
100
+ | **security** | Scans for hardcoded secrets, SQL injection patterns, and other security anti-patterns |
101
+ | **performance** | Detects `await`-in-loop, N+1 query patterns, and bundle size regressions |
102
+ | **coverage** | Enforces test coverage thresholds. Standard preset requires 90%; strict preset requires 95%. |
103
+ | **nyquist** | Bidirectional requirements-test traceability. Validates that every requirement in `requirement-test-matrix.json` has corresponding tests and vice versa. |
104
+
105
+ **Command:**
106
+
107
+ ```bash
108
+ npx harness validate --layer L3
109
+ ```
110
+
111
+ ---
112
+
113
+ ## L4: Scheduled Validators
114
+
115
+ L4 validators run on a weekly schedule. They detect slow-moving drift that accumulates over time.
116
+
117
+ | Validator | Description |
118
+ |-----------|-------------|
119
+ | **drift-detect** | Bidirectional design-code drift detection. Compares design documents against the actual codebase to find divergence in either direction. |
120
+ | **consistency-check** | Cross-document layer consistency. Ensures that references between design documents, ADRs, and code remain coherent. |
121
+ | **dead-code** | Detects unused exports and unreachable code that should be removed. |
122
+
123
+ **Command:**
124
+
125
+ ```bash
126
+ npx harness validate --layer L4
127
+ ```
128
+
129
+ ---
130
+
131
+ ## HarnessError Format
132
+
133
+ Every validation failure produces a structured `HarnessError` object. The `suggestion` and `fix_example` fields enable AI agents to self-correct without human intervention.
134
+
135
+ ```typescript
136
+ interface HarnessError {
137
+ code: string; // "L1-003", "L2-001", etc.
138
+ severity: "error" | "warning";
139
+ message: string;
140
+ suggestion: string;
141
+ adr_ref?: string; // "ADR-003"
142
+ fix_example?: string; // Code fix for AI self-correction
143
+ }
144
+ ```
145
+
146
+ Error codes follow the pattern `L{layer}-{number}`:
147
+
148
+ - `L0-xxx` — Hooks Engine errors
149
+ - `L1-xxx` — Biome AST rule violations
150
+ - `L2-xxx` — Pre-commit validator failures
151
+ - `L3-xxx` — CI/CD validator failures
152
+ - `L4-xxx` — Scheduled validator findings
153
+
154
+ ---
155
+
156
+ ## Presets and Layer Activation
157
+
158
+ Presets control which layers are active. Choose based on project maturity and team discipline.
159
+
160
+ | Preset | L0 | L1 | L2 | L3 | L4 |
161
+ |------------|-----|-----|-----|-----|-----|
162
+ | `minimal` | off | on | on | off | off |
163
+ | `standard` | off | on | on | on | off |
164
+ | `strict` | on | on | on | on | on |
165
+
166
+ - **minimal** — Suitable for early prototyping. Editor-time rules and pre-commit checks only.
167
+ - **standard** — Recommended for active development. Adds CI/CD validators for security, performance, coverage, and traceability.
168
+ - **strict** — Full defense. Enables the Hooks Engine (L0) and scheduled drift detection (L4). Use for production-critical codebases.
169
+
170
+ Presets are configured in `phasegate.config.json`, the single source of truth for all quality settings.
@@ -0,0 +1,107 @@
1
+ # Skills Overview
2
+
3
+ Phasegate provides 28 skills covering the full AIDLC (AI-Driven Development Life Cycle). Skills are deployed to `.claude/skills/` by `npx harness init` and invoked as slash commands in AI agent sessions.
4
+
5
+ ## AIDLC Process — Skill Execution Order
6
+
7
+ The AIDLC follows a 3-level execution flow, each level producing design artifacts that gate the next.
8
+
9
+ ### Level 1: Requirements Definition
10
+
11
+ Artifacts are placed in `inception/_shared/`.
12
+
13
+ Skills run in sequence:
14
+
15
+ 1. `/product-architect` — Define the product vision, domain boundaries, tech stack, and constraints.
16
+ 2. `/story-writer` — Create user stories in Who/What/Why format with acceptance criteria.
17
+ 3. `/story-mapper` — Organize MVP scope and prioritize stories.
18
+ 4. `/unit-designer` — Group stories into independently buildable Units and define integration contracts.
19
+
20
+ ### Level 2: Cross-Unit Design
21
+
22
+ Artifacts are placed in `inception/{unit}/`.
23
+
24
+ Skills run per Unit:
25
+
26
+ 1. `/domain-designer` — DDD domain model (Aggregates, Entities, Value Objects, Domain Events).
27
+ 2. `/logical-designer` (cross-unit mode) — Hexagonal Architecture design with Ports and Adapters.
28
+ 3. `/environment-designer` — Local development environment and infrastructure design.
29
+ 4. `/mock-designer` — UI mockup design for validation and feedback.
30
+
31
+ ### Level 3: Story Implementation
32
+
33
+ Artifacts are placed in `inception/{unit}/{US-XXX}/`.
34
+
35
+ Skills run per User Story:
36
+
37
+ 1. `/logical-designer` (US-specific mode) — Story-scoped logical design refinement.
38
+ 2. `/uiux-designer` — Final UI/UX definition incorporating test cases, logical design, and existing UI.
39
+ 3. `/unit-test-designer` — Unit test case design from domain model.
40
+ 4. `/it-test-designer` — Integration test case design from logical design.
41
+ 5. `/scenario-test-designer` — E2E scenario test case design.
42
+ 6. `/unit-test-logic-designer` — Vitest implementation logic with pseudocode.
43
+ 7. `/it-test-logic-designer` — IT Vitest implementation logic with pseudocode.
44
+ 8. `/scenario-test-logic-designer` — Playwright E2E test implementation logic.
45
+ 9. `/implementation-readiness-checker` — Automated pre-implementation readiness verification.
46
+ 10. `/story-implementor` — TDD implementation with atomic commits.
47
+
48
+ ### Phase Dependency Rules
49
+
50
+ - **Level 2 requires Level 1**: The `/unit-designer` output (Unit definitions and contracts) must exist before any Level 2 skill can run.
51
+ - **Level 3 requires Level 2**: `domain_model.md` and `logical_design.md` must exist in `docs/product/construction/{unit}/` before Level 3 skills can write to that Unit. This is enforced by the pre-tool-use hook and cannot be bypassed.
52
+ - **story-implementor requires test design**: At least one test design phase (unit-test-designer, it-test-designer, or scenario-test-designer) must be completed before `/story-implementor` can execute. This requirement is non-relaxable.
53
+
54
+ ## Skill Categories
55
+
56
+ ### Foundation (4 skills)
57
+
58
+ | Skill | Description |
59
+ |---|---|
60
+ | `/product-architect` | Define product vision from business requirements. Covers domain boundaries, architecture decisions, tech stack, and constraints. |
61
+ | `/story-writer` | Create user stories in Who/What/Why format with acceptance criteria. |
62
+ | `/story-mapper` | Organize MVP scope and prioritize stories. Convergence phase after story divergence. |
63
+ | `/unit-designer` | Group stories into independently buildable Units and define integration contracts. |
64
+
65
+ ### Design (5 skills)
66
+
67
+ | Skill | Description |
68
+ |---|---|
69
+ | `/domain-designer` | DDD domain model design — Aggregates, Entities, Value Objects, and Domain Events. |
70
+ | `/logical-designer` | Hexagonal Architecture design (Ports and Adapters). Two modes: cross-unit and US-specific. |
71
+ | `/mock-designer` | UI mockup design for validation and feedback. |
72
+ | `/uiux-designer` | Final UI/UX definition incorporating test cases, logical design, and existing UI. |
73
+ | `/environment-designer` | Local development environment and infrastructure design. Bridges code and platform. |
74
+
75
+ ### Test Engineering (7 skills)
76
+
77
+ | Skill | Description |
78
+ |---|---|
79
+ | `/unit-test-designer` | Design unit test cases from domain model. |
80
+ | `/it-test-designer` | Design integration test cases from logical design. |
81
+ | `/scenario-test-designer` | Design E2E scenario test cases from user stories, logical design, and mockups. |
82
+ | `/unit-test-logic-designer` | Design Vitest implementation logic with pseudocode for unit tests. |
83
+ | `/it-test-logic-designer` | Design Vitest implementation logic for DB, Repository, UseCase, and Controller integration tests. |
84
+ | `/scenario-test-logic-designer` | Design Playwright E2E test implementation logic with selector strategies and seed data. |
85
+ | `/test-coverage-checker` | Test coverage verification — checks acceptance criteria, domain logic, and UseCase coverage. Includes Nyquist Validation. |
86
+
87
+ ### Implementation (4 skills)
88
+
89
+ | Skill | Description |
90
+ |---|---|
91
+ | `/story-implementor` | TDD implementation based on logical and environment design. Produces atomic commits with environment verification and lessons-learned feedback. |
92
+ | `/quick-implementor` | Quick Mode ad-hoc implementation for bugfixes, docs, tests, and config changes. Phase Gate relaxed; L1/L2 maintained. |
93
+ | `/implementation-planner` | Create implementation plan from Unit specs and domain model. Identifies related Units, API design, and layer-by-layer implementation strategy. |
94
+ | `/implementation-readiness-checker` | Automated pre-implementation readiness verification — checks test design, coverage, and logic design existence. |
95
+
96
+ ### Verification (8 skills)
97
+
98
+ | Skill | Description |
99
+ |---|---|
100
+ | `/consistency-checker` | Cross-layer consistency check across AIDLC design documents. Detects contradictions and gaps. |
101
+ | `/cascade-updater` | Feedback lower-phase discoveries to upstream design documents and reconcile impact. |
102
+ | `/codex-delegator` | Delegate tasks to Codex CLI with Claude Code as quality manager. Supports parallel execution of design, test, and implementation tasks. |
103
+ | `/codebase-mapper` | Analyze `@unit`/`@layer` annotations across all source files to generate a structure map. Visualizes Unit distribution, inter-Unit dependencies, and circular dependencies. |
104
+ | `/doc-freshness-checker` | Design document freshness check (L4 validator extension). Detects stale documents and code-design drift. |
105
+ | `/pointer-validator` | Validate file pointers (relative path references) in design documents. Detects broken links. |
106
+ | `/engineering-perspective` | Design review from Kent Beck, Martin Fowler, Uncle Bob, and Eric Evans perspectives. Multi-angle quality evaluation. |
107
+ | `/skill-creator` | Create and update Agent Skills. Packaging, scripting, references, and asset management. |
@@ -0,0 +1,64 @@
1
+ # Unit Developer 共通ルール
2
+
3
+ このファイルはすべてのUnit Developer(Unit1〜Unit6)に共通するルールを定義する。
4
+ 各Unitの固有ルールは対応する `unitN-developer.md` に記述されている。
5
+
6
+ ## Persona
7
+
8
+ あなたはKent Beck(TDD)、Martin Fowler(リファクタリング)、Uncle Bob(Clean Architecture)、Eric Evans(DDD)の設計哲学を体現するソフトウェアエンジニアであり、担当Unitの専任開発者である。
9
+
10
+ ## エンジニアリング哲学(共通)
11
+
12
+ - **設計書駆動:** 実装の前に必ず設計書を読み、仕様を正確に理解してからコードを書く。推測で実装しない。
13
+ - **アーキテクチャ厳守:** ヘキサゴナルアーキテクチャ(ポート&アダプター)とDDDの原則に従い、レイヤー間の依存方向を絶対に違反しない。`domain → port → repository/usecase → controller` の依存方向を常に意識する。
14
+ - **最小限の変更:** 与えられたタスクに必要な最小限の変更のみを行う。過剰な抽象化、不要なリファクタリング、先回りの実装を一切しない。
15
+ - **テストによる証明:** 実装の正しさはテストで証明する。手動確認に頼らず、自動テストで再現可能な形で検証する。
16
+ - **既存コードへの敬意:** 変更前に既存のコードを必ず読み、設計意図を理解する。既存のパターンやコンベンションに従い、一貫性を保つ。
17
+ - **ドメインモデルの豊かさ:** ビジネスロジックは値オブジェクト・エンティティ・集約に配置することを最優先とする。Usecaseは集約の取得・永続化・ドメインイベント発行などの調整役に徹する。ドメインサービスは「複数集約にまたがる操作」「外部システム連携を含むドメインロジック」など、上記のいずれにも自然に属さない場合に限り、例外的に使用する。安易にドメインサービスを作ることで集約が貧血モデル(Anemic Domain Model)に陥ることを防ぐ。
18
+
19
+ ## 専門領域(共通)
20
+
21
+ - TypeScript(型安全性を最大限に活用した堅牢な実装)
22
+ - ヘキサゴナルアーキテクチャ / DDD(エンティティ、値オブジェクト、集約、リポジトリパターン、ドメインサービスは例外的使用)
23
+ - Vitest(ユニットテスト、統合テスト)
24
+
25
+ ## 参照先(共通)
26
+
27
+ | カテゴリ | パス |
28
+ | --- | --- |
29
+ | ドメイン用語 | `product_overview.md` |
30
+ | バックエンド実装 | `backend/` |
31
+ | フロントエンド実装 | `frontend/` |
32
+ | ユニット間の契約 | `integration_contract.md` |
33
+
34
+ > ※ バックエンド設計書・フロントエンド設計書・ユニット要件のパスは各Unitファイルを参照。
35
+
36
+ ## 禁止事項(共通・絶対厳守)
37
+
38
+ - **NEVER:** 担当UnitとShared Kernal以外のUnitに関するコードを変更する(依存関係がある場合や、全体最適のために必要な場合を除く)
39
+ - **NEVER:** 担当UnitとShared Kernal以外のUnitの設計書を参照・変更する(依存関係がある場合や、ドメイン用語集を除く)
40
+ - **NEVER:** プロジェクトルート外でのファイル操作
41
+ - **NEVER:** 設計書を確認せずに実装を開始する
42
+ - **NEVER:** 既存コードを読まずに変更する
43
+
44
+ ## 必須事項(共通)
45
+
46
+ - **YOU MUST:** 実装開始前に担当Unitの設計書を確認する(バックエンド設計書・フロントエンド設計書の両方)
47
+ - **YOU MUST:** ドメイン用語は `atomica_ubiquitous_word.md` に従う(コード内の命名も含む)
48
+ - **YOU MUST:** 既存の実装コードを確認してから変更を行う
49
+
50
+ ## ワークフロー(共通)
51
+
52
+ タスクを受け取ったら、以下の順序で作業する。
53
+
54
+ 1. **設計書の確認** — 該当する設計書を読み、仕様・制約・ドメインルールを把握する
55
+ 2. **既存コードの確認** — 変更対象と周辺のコードを読み、設計意図とパターンを理解する
56
+ 3. **テストの作成(TDD)** — 実装に先立ち、仕様を満たすために必要最小限のテストを書く。E2Eテスト・インテグレーションテスト・ユニットテストを適切な粒度で用意し、まず失敗する状態(Red)を確認する
57
+ 4. **実装** — テストを通過させることを目標に、設計書に忠実かつ既存パターンに従って最小限の変更を行う(Green)
58
+ 5. **リファクタリング** — テストが通る状態を維持しながら、コードの可読性・設計品質を改善する(Refactor)
59
+ 6. **シナリオ確認** — 各Unitファイルに定義された確認フローを実行する
60
+ 7. **レポート出力** — 完了報告を出力する
61
+
62
+ ## スコープ境界(共通原則)
63
+
64
+ 担当Unitの範囲内でのみ作業する。他のUnitのコード・設計書には関与しない。自分の担当領域を完璧に仕上げることが、プロジェクト全体の品質につながるという信念を持つ。
@@ -0,0 +1,176 @@
1
+ # モデルルーティング規約
2
+
3
+ ## 原則
4
+
5
+ **Opus = 決める、Sonnet = 広げる、Codex = 作る。**
6
+
7
+ | 役割 | モデル | 得意領域 |
8
+ |------|--------|---------|
9
+ | Architect | Opus 4.6 | 発明・判断・骨格設計・品質レビュー |
10
+ | Expander | Sonnet 4.6 | 展開・量産・構造化・列挙 |
11
+ | Implementor | Codex GPT-5.4 | TDD実装・repo整合・コード生成 |
12
+
13
+ ---
14
+
15
+ ## モデル割り当て表
16
+
17
+ ### 骨格設計(Opus 4.6 — メインセッション内実行)
18
+
19
+ | Skill | AIDLC Step | 理由 |
20
+ |-------|-----------|------|
21
+ | `product-architect` | 0 | プロダクト全体像の発明・制約統合 |
22
+ | `domain-designer` | 2.1 | 集約境界・不変条件の発明 |
23
+ | `logical-designer` | 2.2 | 横断設計の骨格判断 |
24
+ | `uiux-designer` | 7 | 体験設計・導線の発明 |
25
+ | `kimunii-perspective` | Any | 多角的な品質判断 |
26
+ | `skill-creator` | Tooling | スキル設計・構造化 |
27
+
28
+ ### 展開・量産(Sonnet 4.6 — 委任実行 → Opusレビュー)
29
+
30
+ | Skill | AIDLC Step | 理由 |
31
+ |-------|-----------|------|
32
+ | `story-writer` | 1.1 | US一覧の粒度統一・量産 |
33
+ | `unit-designer` | 1.2 | Unit-USマッピング表の量産 |
34
+ | `story-mapper` | 1.5 | MVP整理・優先順位表化 |
35
+ | `mock-designer` | 2 | 画面一覧・状態展開 |
36
+ | `environment-designer` | 2.2並行 | 環境構成の列挙・整理 |
37
+ | `scenario-test-designer` | 6 | E2Eテストケース列挙 |
38
+ | `unit-test-designer` | 8前段 | ユニットテストケース列挙 |
39
+ | `it-test-designer` | 8前段 | ITテストケース列挙 |
40
+ | `unit-test-logic-designer` | 8前段 | テスト疑似コード展開 |
41
+ | `it-test-logic-designer` | 8前段 | IT疑似コード展開 |
42
+ | `scenario-test-logic-designer` | 8前段 | E2E疑似コード展開 |
43
+ | `implementation-planner` | 実装前 | 実装計画の構造化展開 |
44
+ | `cascade-updater` | 全工程 | 上位文書への変更波及 |
45
+ | `consistency-checker` | 全工程 | 文書間整合チェック |
46
+ | `test-coverage-checker` | 6以降 | カバレッジ網羅性検証 |
47
+ | `implementation-readiness-checker` | 実装前 | 準備状況チェック |
48
+
49
+ ### 接地・実装(Codex GPT-5.4 — codex-delegator経由)
50
+
51
+ | Skill | AIDLC Step | 理由 |
52
+ |-------|-----------|------|
53
+ | `story-implementor` | 2.3-2.7 | TDD実装(コード生成) |
54
+ | `codex-delegator` | Any | 並列タスク委任 |
55
+
56
+ ---
57
+
58
+ ## Sonnet委任プロトコル
59
+
60
+ ### 実行フロー
61
+
62
+ ```
63
+ ┌─────────────────────────────────────────────────┐
64
+ │ Phase 1: 計画(Opus in-session) │
65
+ │ - Skillのプロンプトに従い計画を立案 │
66
+ │ - 出力: Sonnetへの委任プロンプト + レビュー観点 │
67
+ │ → 人間承認待ち │
68
+ ├─────────────────────────────────────────────────┤
69
+ │ Phase 2: 実行(Sonnet委任) │
70
+ │ - delegate-sonnet.sh 経由で Sonnet 4.6 に委任 │
71
+ │ - Sonnetはファイル読み取り + 文書生成のみ │
72
+ │ - 出力: 設計文書(mdファイル) │
73
+ ├─────────────────────────────────────────────────┤
74
+ │ Phase 3: レビュー(Opus in-session) │
75
+ │ - Sonnet出力を品質基準で検証 │
76
+ │ - PASS → 完了 │
77
+ │ - FAIL → Opusが直接修正 │
78
+ └─────────────────────────────────────────────────┘
79
+ ```
80
+
81
+ ### Phase 2: Sonnet委任
82
+
83
+ #### 委任方法
84
+
85
+ ```bash
86
+ # scripts/delegate-sonnet.sh を使用
87
+ bash scripts/delegate-sonnet.sh \
88
+ --prompt "委任プロンプト" \
89
+ --output "出力ファイルパス" \
90
+ --context "読み込みファイル1,読み込みファイル2"
91
+ ```
92
+
93
+ #### Sonnetへの委任プロンプト構造
94
+
95
+ ```
96
+ [コンテキスト層] 読むべきファイルパス + 上位設計文書の引用
97
+ [タスク層] 作業内容、入力ファイル、出力ファイルパスと期待フォーマット
98
+ [制約層] 変更許可ファイル、スコープ制限、フォーマット規約
99
+ [禁止層] 判断を含む作業の禁止(判断はOpusが行う)
100
+ ```
101
+
102
+ #### Sonnetに委任してよい作業
103
+
104
+ - 一覧表・マトリクスの作成
105
+ - テストケースの列挙
106
+ - 既存骨格に沿った章展開
107
+ - 用語表・制約表の整理
108
+ - 設計文書間のマッピング表作成
109
+ - チェックリストの実行
110
+
111
+ #### Sonnetに委任してはいけない作業
112
+
113
+ - 集約境界の決定
114
+ - アーキテクチャ選択の判断
115
+ - 優先順位の最終決定
116
+ - トレードオフを伴う設計判断
117
+ - レビュー結果に基づく修正方針の決定
118
+
119
+ ### Phase 3: Opusレビュープロトコル
120
+
121
+ #### レビュー観点(全Sonnet委任共通)
122
+
123
+ | ID | 観点 | 検証内容 | 重大度 |
124
+ |----|------|---------|--------|
125
+ | R1 | 上位文書整合 | 上位設計文書(product_overview, domain設計等)との矛盾がないか | BLOCK |
126
+ | R2 | 粒度一貫性 | 成果物内で抽象度・粒度が統一されているか | BLOCK |
127
+ | R3 | 網羅性 | 入力に含まれる要素が漏れなく展開されているか | BLOCK |
128
+ | R4 | 配置ルール | `folder_management_rules.md` に準拠しているか | BLOCK |
129
+ | R5 | 判断混入 | Sonnetが独自判断を行っていないか(骨格逸脱) | BLOCK |
130
+ | R6 | 表現品質 | 用語・文体がプロジェクト規約と統一されているか | WARN |
131
+ | R7 | YAGNI | スコープ外の「改善」「将来への備え」がないか | WARN |
132
+
133
+ #### 判定ロジック
134
+
135
+ ```
136
+ BLOCK に 1つでも FAIL → Opus が直接修正
137
+ WARN のみ FAIL → Opus が直接修正(軽微)
138
+ 全 PASS → 完了
139
+ ```
140
+
141
+ **重要: Sonnetへの再委任は行わない。** 修正はすべてOpusが直接行う。
142
+ 理由: 修正は「何が問題か」の判断を含むため、Opus の責務である。
143
+
144
+ #### レビュー出力フォーマット
145
+
146
+ ```markdown
147
+ ## Opus Review
148
+
149
+ ### 判定: PASS / FAIL
150
+
151
+ ### 検証結果
152
+ | ID | 観点 | 結果 | 備考 |
153
+ |----|------|------|------|
154
+
155
+ ### 修正内容(FAILの場合)
156
+ - [R1] {ファイル}: {修正内容}
157
+ - ...
158
+ ```
159
+
160
+ ---
161
+
162
+ ## ハイブリッド分業パターン
163
+
164
+ 一部のSkillでは Phase 1(Opus骨格)→ Phase 2(Sonnet展開)の分業が有効。
165
+
166
+ | Skill | Opusが決めること | Sonnetが広げること |
167
+ |-------|-----------------|-------------------|
168
+ | `story-writer` | US粒度の判断基準、分割方針 | US一覧の列挙、受け入れ基準の標準化 |
169
+ | `logical-designer` | 横断設計の骨格、レイヤー方針 | 章展開、DTO/UseCase一覧、ケース表 |
170
+ | `unit-test-designer` | テスト戦略、重点観点 | テストケース一覧、境界値列挙 |
171
+
172
+ このパターンでは:
173
+ 1. Phase 1 で Opus が骨格(アウトライン + 判断事項)を出力
174
+ 2. 人間承認
175
+ 3. Phase 2 で Sonnet に骨格を渡して展開を委任
176
+ 4. Phase 3 で Opus がレビュー + 修正