phasegate 0.16.0 → 0.31.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 (215) hide show
  1. package/README.ja.md +71 -39
  2. package/README.md +69 -9
  3. package/docs/ADR/ADR-013-story-reflection-gate.md +100 -0
  4. package/docs/guide/configuration.md +244 -7
  5. package/package.json +4 -2
  6. package/scripts/harness/adr-foundation/domain/ports/adr-document-parser-port.ts +1 -0
  7. package/scripts/harness/adr-foundation/domain/ports/adr-frontmatter-parser-port.ts +1 -0
  8. package/scripts/harness/adr-foundation/domain/ports/adr-repository-port.ts +1 -0
  9. package/scripts/harness/adr-foundation/domain/value-objects/adr-status.ts +6 -6
  10. package/scripts/harness/agent-integration/application/dto/handle-pre-tool-use-dto.ts +3 -1
  11. package/scripts/harness/agent-integration/application/usecases/handle-pre-tool-use-usecase.ts +108 -2
  12. package/scripts/harness/agent-integration/domain/ports/config-query-port.ts +2 -0
  13. package/scripts/harness/agent-integration/domain/ports/phase-gate-query-port.ts +1 -1
  14. package/scripts/harness/agent-integration/domain/ports/story-reflection-query-port.ts +8 -0
  15. package/scripts/harness/agent-integration/domain/services/bash-write-target-extractor.ts +258 -0
  16. package/scripts/harness/agent-integration/domain/services/hook-to-cli-translator.ts +21 -4
  17. package/scripts/harness/agent-integration/domain/value-objects/protected-file-list.ts +20 -0
  18. package/scripts/harness/agent-integration/domain/value-objects/story-reflection-query-result.ts +63 -0
  19. package/scripts/harness/agent-integration/infrastructure/adapters/file-system-story-reflection-query-adapter.ts +122 -0
  20. package/scripts/harness/agent-integration/infrastructure/adapters/harness-config-config-query-adapter.ts +20 -0
  21. package/scripts/harness/agent-integration/infrastructure/adapters/phase-gate-query-adapter.ts +17 -3
  22. package/scripts/harness/agent-integration/presentation/pre-tool-use-hook.ts +29 -2
  23. package/scripts/harness/biome-ast-engine/domain/services/lint-runner.ts +24 -0
  24. package/scripts/harness/biome-ast-engine/domain/services/rule-definition-registry.ts +1 -1
  25. package/scripts/harness/biome-ast-engine/domain/value-objects/source-module-snapshot.ts +5 -2
  26. package/scripts/harness/biome-ast-engine/infrastructure/adapters/node-workspace-file-adapter.ts +1 -1
  27. package/scripts/harness/biome-ast-engine/infrastructure/adapters/typescript-source-module-analyzer-adapter.ts +1 -1
  28. package/scripts/harness/biome-ast-engine/infrastructure/parsers/unit-comment-parser.ts +12 -7
  29. package/scripts/harness/ci-governance/composition-root.ts +1 -0
  30. package/scripts/harness/config-foundation/application/mappers/phase-config-section-mapper.ts +44 -0
  31. package/scripts/harness/config-foundation/application/usecases/load-resolved-config-use-case.ts +20 -1
  32. package/scripts/harness/config-foundation/domain/harness-config.ts +2 -1
  33. package/scripts/harness/config-foundation/domain/value-objects/phase-dependencies-config.ts +18 -4
  34. package/scripts/harness/config-foundation/infrastructure/schemas/harness-config-v2.schema.json +185 -10
  35. package/scripts/harness/config-foundation/infrastructure/validators/ajv-config-schema-validator.ts +2 -1
  36. package/scripts/harness/harness-api/application/dto/command-dispatch-input.ts +1 -0
  37. package/scripts/harness/harness-api/application/dto/command-dispatch-output.ts +1 -0
  38. package/scripts/harness/harness-api/application/dto/exit-code-decision-input.ts +1 -0
  39. package/scripts/harness/harness-api/application/dto/exit-code-decision-output.ts +1 -0
  40. package/scripts/harness/harness-api/application/dto/harness-api-response-contract.ts +1 -0
  41. package/scripts/harness/harness-api/application/dto/initialize-registry-input.ts +1 -0
  42. package/scripts/harness/harness-api/application/dto/registry-summary-output.ts +1 -0
  43. package/scripts/harness/harness-api/application/dto/status-derivation-input.ts +1 -0
  44. package/scripts/harness/harness-api/application/mappers/harness-api-response-mapper.ts +1 -0
  45. package/scripts/harness/harness-api/application/usecases/decide-exit-code-usecase.ts +1 -0
  46. package/scripts/harness/harness-api/application/usecases/derive-harness-status-usecase.ts +1 -0
  47. package/scripts/harness/harness-api/application/usecases/dispatch-command-usecase.ts +1 -0
  48. package/scripts/harness/harness-api/application/usecases/initialize-command-registry-usecase.ts +1 -0
  49. package/scripts/harness/harness-api/composition-root.ts +1 -0
  50. package/scripts/harness/harness-api/domain/ports/artifact-scanner-port.ts +1 -0
  51. package/scripts/harness/harness-api/domain/ports/biome-lint-port.ts +1 -0
  52. package/scripts/harness/harness-api/domain/ports/config-query-port.ts +1 -0
  53. package/scripts/harness/harness-api/domain/ports/impact-analysis-port.ts +1 -0
  54. package/scripts/harness/harness-api/domain/ports/phase-gate-query-port.ts +1 -0
  55. package/scripts/harness/harness-api/domain/ports/validator-execution-port.ts +1 -0
  56. package/scripts/harness/harness-api/domain/services/command-dispatch-service.ts +1 -0
  57. package/scripts/harness/harness-api/domain/services/command-registry.ts +1 -0
  58. package/scripts/harness/harness-api/domain/services/status-derivation-service.ts +1 -0
  59. package/scripts/harness/harness-api/domain/value-objects/artifact-scan-result.ts +1 -0
  60. package/scripts/harness/harness-api/domain/value-objects/check-ready-result.ts +1 -0
  61. package/scripts/harness/harness-api/domain/value-objects/ci-check-result.ts +1 -0
  62. package/scripts/harness/harness-api/domain/value-objects/cli-command-definition.ts +1 -0
  63. package/scripts/harness/harness-api/domain/value-objects/command-input-spec.ts +1 -0
  64. package/scripts/harness/harness-api/domain/value-objects/drift-report-summary.ts +1 -0
  65. package/scripts/harness/harness-api/domain/value-objects/exit-code-spec.ts +1 -0
  66. package/scripts/harness/harness-api/domain/value-objects/harness-api-response.ts +1 -0
  67. package/scripts/harness/harness-api/domain/value-objects/harness-status-summary.ts +1 -0
  68. package/scripts/harness/harness-api/domain/value-objects/layer-health.ts +1 -0
  69. package/scripts/harness/harness-api/domain/value-objects/phase-info.ts +1 -0
  70. package/scripts/harness/harness-api/index.ts +1 -0
  71. package/scripts/harness/harness-api/infrastructure/adapters/biome-ast-engine-lint-adapter.ts +1 -0
  72. package/scripts/harness/harness-api/infrastructure/adapters/file-system-artifact-scanner-adapter.ts +1 -0
  73. package/scripts/harness/harness-api/infrastructure/adapters/harness-config-query-adapter.ts +1 -0
  74. package/scripts/harness/harness-api/infrastructure/adapters/nyquist-validation-impact-analysis-adapter.ts +1 -0
  75. package/scripts/harness/harness-api/infrastructure/adapters/phase-dependency-model-query-adapter.ts +1 -0
  76. package/scripts/harness/harness-api/infrastructure/adapters/validator-system-execution-adapter.ts +1 -0
  77. package/scripts/harness/harness-api/presentation/dto/cli-output-options.ts +1 -0
  78. package/scripts/harness/harness-api/presentation/formatters/harness-api-json-formatter.ts +1 -0
  79. package/scripts/harness/harness-api/presentation/handlers/check-phase-handler.ts +1 -0
  80. package/scripts/harness/harness-api/presentation/handlers/check-ready-handler.ts +1 -0
  81. package/scripts/harness/harness-api/presentation/handlers/ci-check-handler.ts +1 -0
  82. package/scripts/harness/harness-api/presentation/handlers/complete-check-handler.ts +1 -0
  83. package/scripts/harness/harness-api/presentation/handlers/detect-drift-handler.ts +1 -0
  84. package/scripts/harness/harness-api/presentation/handlers/impact-analysis-handler.ts +1 -0
  85. package/scripts/harness/harness-api/presentation/handlers/lint-handler.ts +1 -0
  86. package/scripts/harness/harness-api/presentation/handlers/status-handler.ts +1 -0
  87. package/scripts/harness/harness-error/infrastructure/adapters/legacy-error-reporter-adapter.ts +7 -1
  88. package/scripts/harness/integrations/pre-commit.ts +1 -0
  89. package/scripts/harness/main.ts +154 -34
  90. package/scripts/harness/phase-dependency-model/application/dto/resolve-gate-result-dto.ts +14 -0
  91. package/scripts/harness/phase-dependency-model/application/services/phase-gate-result-mapper.ts +20 -0
  92. package/scripts/harness/phase-dependency-model/application/usecases/check-story-reflection-usecase.ts +42 -0
  93. package/scripts/harness/phase-dependency-model/application/usecases/resolve-gate-usecase.ts +161 -0
  94. package/scripts/harness/phase-dependency-model/composition-root.ts +57 -1
  95. package/scripts/harness/phase-dependency-model/domain/definitions/{default-phase-dependencies.ts → full-phase-dependencies.ts} +3 -3
  96. package/scripts/harness/phase-dependency-model/domain/definitions/{default-phase-nodes.ts → full-phase-nodes.ts} +1 -1
  97. package/scripts/harness/phase-dependency-model/domain/definitions/full-story-reflection-defaults.ts +28 -0
  98. package/scripts/harness/phase-dependency-model/domain/definitions/minimal-phase-dependencies.ts +32 -0
  99. package/scripts/harness/phase-dependency-model/domain/definitions/minimal-phase-nodes.ts +50 -0
  100. package/scripts/harness/phase-dependency-model/domain/definitions/minimal-story-reflection-defaults.ts +8 -0
  101. package/scripts/harness/phase-dependency-model/domain/definitions/standard-phase-dependencies.ts +39 -0
  102. package/scripts/harness/phase-dependency-model/domain/definitions/standard-phase-nodes.ts +118 -0
  103. package/scripts/harness/phase-dependency-model/domain/definitions/standard-story-reflection-defaults.ts +23 -0
  104. package/scripts/harness/phase-dependency-model/domain/models/phase-structure.ts +95 -23
  105. package/scripts/harness/phase-dependency-model/domain/ports/glob-matcher-port.ts +8 -0
  106. package/scripts/harness/phase-dependency-model/domain/ports/phase-config-provider-port.ts +2 -0
  107. package/scripts/harness/phase-dependency-model/domain/ports/story-annotation-verifier-port.ts +14 -0
  108. package/scripts/harness/phase-dependency-model/domain/ports/story-reflection-file-system-port.ts +16 -0
  109. package/scripts/harness/phase-dependency-model/domain/services/gate-graph.ts +223 -0
  110. package/scripts/harness/phase-dependency-model/domain/services/story-reflection-checker.ts +66 -0
  111. package/scripts/harness/phase-dependency-model/domain/values/gate-definition.ts +127 -0
  112. package/scripts/harness/phase-dependency-model/domain/values/gate-name.ts +40 -0
  113. package/scripts/harness/phase-dependency-model/domain/values/gate-story-annotation.ts +39 -0
  114. package/scripts/harness/phase-dependency-model/domain/values/phase-customization-policy.ts +16 -4
  115. package/scripts/harness/phase-dependency-model/domain/values/story-reflection-config.ts +44 -0
  116. package/scripts/harness/phase-dependency-model/domain/values/story-reflection-mapping.ts +91 -0
  117. package/scripts/harness/phase-dependency-model/domain/values/story-reflection-result.ts +55 -0
  118. package/scripts/harness/phase-dependency-model/infrastructure/adapters/picomatch-glob-matcher.ts +17 -0
  119. package/scripts/harness/phase-dependency-model/infrastructure/adapters/story-annotation-verifier-adapter.ts +46 -0
  120. package/scripts/harness/phase-dependency-model/infrastructure/config/custom-gates-config-parser.ts +22 -0
  121. package/scripts/harness/phase-dependency-model/infrastructure/config/harness-config-phase-config-provider.ts +78 -2
  122. package/scripts/harness/phase-dependency-model/infrastructure/filesystem/file-system-story-reflection-adapter.ts +94 -0
  123. package/scripts/harness/phase-dependency-model/presentation/cli/check-phase-gate-command-handler.ts +12 -4
  124. package/scripts/harness/phase-dependency-model/presentation/cli/story-reflection-status-presenter.ts +87 -0
  125. package/scripts/harness/regression-suite/application/dto/analyze-migration-input.ts +1 -0
  126. package/scripts/harness/regression-suite/application/dto/analyze-migration-output.ts +1 -0
  127. package/scripts/harness/regression-suite/application/dto/configure-ci-gate-input.ts +1 -0
  128. package/scripts/harness/regression-suite/application/dto/configure-ci-gate-output.ts +1 -0
  129. package/scripts/harness/regression-suite/application/dto/migrate-v0-tests-input.ts +1 -0
  130. package/scripts/harness/regression-suite/application/dto/migrate-v0-tests-output.ts +1 -0
  131. package/scripts/harness/regression-suite/application/dto/run-regression-suite-input.ts +1 -0
  132. package/scripts/harness/regression-suite/application/dto/run-regression-suite-output.ts +1 -0
  133. package/scripts/harness/regression-suite/application/mappers/migration-mapping-mapper.ts +1 -0
  134. package/scripts/harness/regression-suite/application/mappers/test-execution-summary-mapper.ts +1 -0
  135. package/scripts/harness/regression-suite/application/usecases/analyze-v0-migration-usecase.ts +1 -0
  136. package/scripts/harness/regression-suite/application/usecases/configure-ci-gate-usecase.ts +1 -0
  137. package/scripts/harness/regression-suite/application/usecases/migrate-v0-tests-usecase.ts +1 -0
  138. package/scripts/harness/regression-suite/application/usecases/run-agent-independence-guard-usecase.ts +1 -0
  139. package/scripts/harness/regression-suite/application/usecases/run-gng-gate-regression-usecase.ts +1 -0
  140. package/scripts/harness/regression-suite/application/usecases/run-k-requirements-regression-usecase.ts +1 -0
  141. package/scripts/harness/regression-suite/application/usecases/run-k14-k15-regression-usecase.ts +1 -0
  142. package/scripts/harness/regression-suite/composition-root.ts +1 -0
  143. package/scripts/harness/regression-suite/domain/aggregates/v0-test-migration.ts +1 -0
  144. package/scripts/harness/regression-suite/domain/ports/ci-gate-result-writer-port.ts +1 -0
  145. package/scripts/harness/regression-suite/domain/ports/config-query-port.ts +1 -0
  146. package/scripts/harness/regression-suite/domain/ports/import-analyzer-port.ts +1 -0
  147. package/scripts/harness/regression-suite/domain/ports/migration-mapping-repository-port.ts +1 -0
  148. package/scripts/harness/regression-suite/domain/ports/suite-registry-port.ts +1 -0
  149. package/scripts/harness/regression-suite/domain/ports/test-runner-port.ts +1 -0
  150. package/scripts/harness/regression-suite/domain/ports/v0-spec-reader-port.ts +1 -0
  151. package/scripts/harness/regression-suite/domain/services/import-guard-service.ts +1 -0
  152. package/scripts/harness/regression-suite/domain/services/migration-analyzer.ts +1 -0
  153. package/scripts/harness/regression-suite/domain/services/regression-runner.ts +1 -0
  154. package/scripts/harness/regression-suite/domain/value-objects/agent-independence-test.ts +1 -0
  155. package/scripts/harness/regression-suite/domain/value-objects/biome-modification-spec.ts +1 -0
  156. package/scripts/harness/regression-suite/domain/value-objects/ci-gate-config.ts +1 -0
  157. package/scripts/harness/regression-suite/domain/value-objects/coverage-rate.ts +1 -0
  158. package/scripts/harness/regression-suite/domain/value-objects/gng-condition-test.ts +1 -0
  159. package/scripts/harness/regression-suite/domain/value-objects/import-violation.ts +1 -0
  160. package/scripts/harness/regression-suite/domain/value-objects/k-requirement-test.ts +1 -0
  161. package/scripts/harness/regression-suite/domain/value-objects/migration-mapping.ts +1 -0
  162. package/scripts/harness/regression-suite/domain/value-objects/regression-suite-definition.ts +1 -0
  163. package/scripts/harness/regression-suite/domain/value-objects/suite-id.ts +1 -0
  164. package/scripts/harness/regression-suite/domain/value-objects/test-execution-summary.ts +1 -0
  165. package/scripts/harness/regression-suite/domain/value-objects/test-failure-detail.ts +1 -0
  166. package/scripts/harness/regression-suite/domain/value-objects/v0-test-id.ts +1 -0
  167. package/scripts/harness/regression-suite/domain/value-objects/v1-test-path.ts +1 -0
  168. package/scripts/harness/regression-suite/infrastructure/adapters/biome-ast-import-analyzer-adapter.ts +1 -0
  169. package/scripts/harness/regression-suite/infrastructure/adapters/file-system-v0-spec-reader-adapter.ts +1 -0
  170. package/scripts/harness/regression-suite/infrastructure/adapters/harness-config-query-adapter.ts +1 -0
  171. package/scripts/harness/regression-suite/infrastructure/adapters/json-ci-gate-result-writer-adapter.ts +1 -0
  172. package/scripts/harness/regression-suite/infrastructure/adapters/markdown-migration-mapping-repository-adapter.ts +1 -0
  173. package/scripts/harness/regression-suite/infrastructure/adapters/static-suite-registry-adapter.ts +1 -0
  174. package/scripts/harness/regression-suite/infrastructure/adapters/vitest-test-runner-adapter.ts +1 -0
  175. package/scripts/harness/regression-suite/infrastructure/registry/agent-independence-suite-definition.ts +1 -0
  176. package/scripts/harness/regression-suite/infrastructure/registry/gng-gate-suite-definition.ts +1 -0
  177. package/scripts/harness/regression-suite/infrastructure/registry/k-requirements-suite-definition.ts +1 -0
  178. package/scripts/harness/regression-suite/infrastructure/registry/v0-migration-suite-definition.ts +1 -0
  179. package/scripts/harness/setup/skill-deployer.ts +82 -5
  180. package/scripts/harness/shared-kernel/harness-api.ts +1 -0
  181. package/scripts/harness/skill-quality/composition-root.ts +1 -0
  182. package/scripts/harness/skill-quality/infrastructure/adapters/ajv-lesson-artifact-schema-adapter.ts +5 -4
  183. package/scripts/harness/traceability-model/domain/services/metadata-validator.ts +12 -10
  184. package/scripts/harness/traceability-model/infrastructure/parsers/source-metadata-parser.ts +16 -2
  185. package/skills/cascade-updater/SKILL.md +16 -3
  186. package/skills/codebase-mapper/SKILL.md +9 -9
  187. package/skills/codex-delegator/SKILL.md +5 -56
  188. package/skills/consistency-checker/SKILL.md +5 -9
  189. 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 +6 -3
  190. package/skills/doc-freshness-checker/SKILL.md +6 -6
  191. package/skills/engineering-perspective/SKILL.md +2 -58
  192. package/skills/engineering-perspective/references/domain-model.md +4 -135
  193. package/skills/implementation-readiness-checker/SKILL.md +18 -72
  194. package/skills/it-test-designer/SKILL.md +25 -161
  195. package/skills/it-test-designer/references/it-test-design-template.md +131 -0
  196. package/skills/it-test-logic-designer/SKILL.md +13 -388
  197. package/skills/it-test-logic-designer/references/controller-test-patterns.md +100 -0
  198. package/skills/it-test-logic-designer/references/repository-test-patterns.md +206 -0
  199. package/skills/it-test-logic-designer/references/usecase-test-patterns.md +87 -0
  200. package/skills/pointer-validator/SKILL.md +4 -4
  201. package/skills/scenario-test-designer/SKILL.md +4 -68
  202. package/skills/scenario-test-designer/references/scenario-test-design-template.md +41 -0
  203. package/skills/scenario-test-designer/references/scenario-test-plan-template.md +35 -0
  204. package/skills/scenario-test-logic-designer/SKILL.md +21 -304
  205. package/skills/scenario-test-logic-designer/references/msw-patterns.md +36 -0
  206. package/skills/scenario-test-logic-designer/references/playwright-patterns.md +237 -0
  207. package/skills/test-coverage-checker/SKILL.md +39 -121
  208. package/skills/test-coverage-checker/references/coverage-report-template.md +99 -0
  209. package/skills/uiux-designer/SKILL.md +27 -92
  210. package/skills/uiux-designer/references/data-testid-convention.md +38 -0
  211. package/skills/uiux-designer/references/uiux-design-template.md +105 -0
  212. package/skills/unit-test-designer/SKILL.md +5 -106
  213. package/skills/unit-test-designer/references/unit-test-design-template.md +127 -0
  214. package/skills/unit-test-logic-designer/SKILL.md +28 -250
  215. package/skills/unit-test-logic-designer/references/test-patterns.md +207 -0
@@ -16,7 +16,10 @@
16
16
  "project": {
17
17
  "type": "object",
18
18
  "additionalProperties": false,
19
- "required": ["name", "preset"],
19
+ "required": [
20
+ "name",
21
+ "preset"
22
+ ],
20
23
  "properties": {
21
24
  "name": {
22
25
  "type": "string",
@@ -24,7 +27,11 @@
24
27
  },
25
28
  "preset": {
26
29
  "type": "string",
27
- "enum": ["minimal", "standard", "strict"]
30
+ "enum": [
31
+ "minimal",
32
+ "standard",
33
+ "strict"
34
+ ]
28
35
  }
29
36
  }
30
37
  },
@@ -152,11 +159,19 @@
152
159
  "phaseDependencies": {
153
160
  "type": "object",
154
161
  "additionalProperties": false,
155
- "required": ["preset", "override", "customRules"],
162
+ "required": [
163
+ "preset"
164
+ ],
156
165
  "properties": {
157
166
  "preset": {
158
167
  "type": "string",
159
- "enum": ["default", "custom"]
168
+ "enum": [
169
+ "default",
170
+ "full",
171
+ "standard",
172
+ "minimal",
173
+ "custom"
174
+ ]
160
175
  },
161
176
  "override": {
162
177
  "type": "boolean"
@@ -166,7 +181,10 @@
166
181
  "items": {
167
182
  "type": "object",
168
183
  "additionalProperties": false,
169
- "required": ["phase", "requires"],
184
+ "required": [
185
+ "phase",
186
+ "requires"
187
+ ],
170
188
  "properties": {
171
189
  "phase": {
172
190
  "type": "string",
@@ -180,23 +198,160 @@
180
198
  }
181
199
  }
182
200
  }
201
+ },
202
+ "gates": {
203
+ "type": "array",
204
+ "items": {
205
+ "type": "object",
206
+ "additionalProperties": false,
207
+ "required": [
208
+ "name",
209
+ "level",
210
+ "requires",
211
+ "blocks",
212
+ "dependsOn"
213
+ ],
214
+ "properties": {
215
+ "name": {
216
+ "type": "string",
217
+ "pattern": "^[a-z][a-z0-9-]*$"
218
+ },
219
+ "level": {
220
+ "type": "integer",
221
+ "enum": [
222
+ 1,
223
+ 2,
224
+ 3
225
+ ]
226
+ },
227
+ "requires": {
228
+ "type": "array",
229
+ "items": {
230
+ "type": "object",
231
+ "additionalProperties": false,
232
+ "required": [
233
+ "path",
234
+ "required"
235
+ ],
236
+ "properties": {
237
+ "path": {
238
+ "type": "string",
239
+ "minLength": 1
240
+ },
241
+ "required": {
242
+ "type": "boolean"
243
+ }
244
+ }
245
+ }
246
+ },
247
+ "blocks": {
248
+ "type": "array",
249
+ "items": {
250
+ "type": "string",
251
+ "minLength": 1
252
+ }
253
+ },
254
+ "dependsOn": {
255
+ "type": "array",
256
+ "items": {
257
+ "type": "string",
258
+ "pattern": "^[a-z][a-z0-9-]*$"
259
+ }
260
+ },
261
+ "storyAnnotation": {
262
+ "type": "object",
263
+ "additionalProperties": false,
264
+ "required": [
265
+ "required",
266
+ "tag"
267
+ ],
268
+ "properties": {
269
+ "required": {
270
+ "type": "boolean"
271
+ },
272
+ "tag": {
273
+ "type": "string",
274
+ "minLength": 1
275
+ }
276
+ }
277
+ }
278
+ },
279
+ "allOf": [
280
+ {
281
+ "if": {
282
+ "required": [
283
+ "storyAnnotation"
284
+ ]
285
+ },
286
+ "then": {
287
+ "properties": {
288
+ "level": {
289
+ "const": 3
290
+ }
291
+ }
292
+ }
293
+ }
294
+ ]
295
+ }
296
+ },
297
+ "storyReflection": {
298
+ "type": "object",
299
+ "additionalProperties": false,
300
+ "properties": {
301
+ "enabled": {
302
+ "type": "boolean"
303
+ },
304
+ "mappings": {
305
+ "type": "array",
306
+ "items": {
307
+ "type": "object",
308
+ "additionalProperties": false,
309
+ "required": [
310
+ "unitId",
311
+ "artifacts"
312
+ ],
313
+ "properties": {
314
+ "unitId": {
315
+ "type": "string",
316
+ "minLength": 1
317
+ },
318
+ "artifacts": {
319
+ "type": "array",
320
+ "items": {
321
+ "type": "string",
322
+ "minLength": 1
323
+ }
324
+ }
325
+ }
326
+ }
327
+ }
328
+ }
183
329
  }
184
330
  }
185
331
  },
186
332
  "planningMode": {
187
333
  "type": "object",
188
334
  "additionalProperties": false,
189
- "required": ["default", "perPhase"],
335
+ "required": [
336
+ "default",
337
+ "perPhase"
338
+ ],
190
339
  "properties": {
191
340
  "default": {
192
341
  "type": "string",
193
- "enum": ["interactive", "embedded-qa"]
342
+ "enum": [
343
+ "interactive",
344
+ "embedded-qa"
345
+ ]
194
346
  },
195
347
  "perPhase": {
196
348
  "type": "object",
197
349
  "additionalProperties": {
198
350
  "type": "string",
199
- "enum": ["interactive", "embedded-qa"]
351
+ "enum": [
352
+ "interactive",
353
+ "embedded-qa"
354
+ ]
200
355
  }
201
356
  }
202
357
  }
@@ -223,7 +378,10 @@
223
378
  "paths": {
224
379
  "type": "object",
225
380
  "additionalProperties": false,
226
- "required": ["designDocs", "inceptionDocs"],
381
+ "required": [
382
+ "designDocs",
383
+ "inceptionDocs"
384
+ ],
227
385
  "properties": {
228
386
  "designDocs": {
229
387
  "type": "string",
@@ -238,7 +396,10 @@
238
396
  "reporting": {
239
397
  "type": "object",
240
398
  "additionalProperties": false,
241
- "required": ["format", "outputDir"],
399
+ "required": [
400
+ "format",
401
+ "outputDir"
402
+ ],
242
403
  "properties": {
243
404
  "format": {
244
405
  "type": "string",
@@ -249,6 +410,20 @@
249
410
  "minLength": 1
250
411
  }
251
412
  }
413
+ },
414
+ "protectedFiles": {
415
+ "type": "object",
416
+ "additionalProperties": false,
417
+ "properties": {
418
+ "exclude": {
419
+ "type": "array",
420
+ "items": {
421
+ "type": "string",
422
+ "minLength": 1
423
+ },
424
+ "uniqueItems": true
425
+ }
426
+ }
252
427
  }
253
428
  }
254
429
  }
@@ -5,7 +5,8 @@
5
5
  import fs from 'node:fs';
6
6
  import path from 'node:path';
7
7
  import { fileURLToPath } from 'node:url';
8
- import Ajv, { type ErrorObject, type ValidateFunction } from 'ajv';
8
+ import AjvModule, { type ErrorObject, type ValidateFunction } from 'ajv';
9
+ const Ajv = AjvModule.default ?? AjvModule;
9
10
  import { HarnessError } from '../../../harness-error/domain/value-objects/harness-error.js';
10
11
  import { ErrorCode } from '../../../harness-error/domain/value-objects/error-code.js';
11
12
  import { Severity } from '../../../harness-error/domain/value-objects/severity.js';
@@ -1,3 +1,4 @@
1
+ // @layer application
1
2
  // command-dispatch-input.ts — CommandDispatchInput DTO
2
3
 
3
4
  export interface CommandDispatchInput {
@@ -1,3 +1,4 @@
1
+ // @layer application
1
2
  // command-dispatch-output.ts — CommandDispatchOutput DTO
2
3
 
3
4
  import type { ExitCode } from '../../domain/value-objects/harness-api-response.js';
@@ -1,3 +1,4 @@
1
+ // @layer application
1
2
  // exit-code-decision-input.ts — ExitCodeDecisionInput DTO
2
3
 
3
4
  import type { ResponseStatus } from '../../domain/value-objects/harness-api-response.js';
@@ -1,3 +1,4 @@
1
+ // @layer application
1
2
  // exit-code-decision-output.ts — ExitCodeDecisionOutput DTO
2
3
 
3
4
  import type { ExitCode } from '../../domain/value-objects/harness-api-response.js';
@@ -1,3 +1,4 @@
1
+ // @layer application
1
2
  // harness-api-response-contract.ts — Cross-Unit Contract DTO
2
3
 
3
4
  import type { ResponseStatus, HarnessError, ResponseSummary } from '../../domain/value-objects/harness-api-response.js';
@@ -1,3 +1,4 @@
1
+ // @layer application
1
2
  // initialize-registry-input.ts — InitializeRegistryInput DTO
2
3
 
3
4
  export interface CliCommandDefinitionInput {
@@ -1,3 +1,4 @@
1
+ // @layer application
1
2
  // registry-summary-output.ts — RegistrySummaryOutput DTO
2
3
 
3
4
  import type { CommandName } from '../../domain/value-objects/cli-command-definition.js';
@@ -1,3 +1,4 @@
1
+ // @layer application
1
2
  // status-derivation-input.ts — StatusDerivationInput DTO
2
3
 
3
4
  // Currently no parameters — extensible for future filter conditions
@@ -1,3 +1,4 @@
1
+ // @layer application
1
2
  // harness-api-response-mapper.ts — HarnessApiResponseMapper
2
3
 
3
4
  import type { HarnessApiResponse } from '../../domain/value-objects/harness-api-response.js';
@@ -1,3 +1,4 @@
1
+ // @layer application
1
2
  // decide-exit-code-usecase.ts — DecideExitCodeUseCase
2
3
 
3
4
  import type { ExitCodeDecisionInput } from '../dto/exit-code-decision-input.js';
@@ -1,3 +1,4 @@
1
+ // @layer application
1
2
  // derive-harness-status-usecase.ts — DeriveHarnessStatusUseCase
2
3
 
3
4
  import type { ArtifactScannerPort } from '../../domain/ports/artifact-scanner-port.js';
@@ -1,3 +1,4 @@
1
+ // @layer application
1
2
  // dispatch-command-usecase.ts — DispatchCommandUseCase
2
3
 
3
4
  import { CommandRegistry } from '../../domain/services/command-registry.js';
@@ -1,3 +1,4 @@
1
+ // @layer application
1
2
  // initialize-command-registry-usecase.ts — InitializeCommandRegistryUseCase
2
3
 
3
4
  import { CliCommandDefinition } from '../../domain/value-objects/cli-command-definition.js';
@@ -1,3 +1,4 @@
1
+ // @layer infrastructure
1
2
  // composition-root.ts — harness-api Composition Root
2
3
 
3
4
  import { CommandRegistry } from './domain/services/command-registry.js';
@@ -1,3 +1,4 @@
1
+ // @layer domain
1
2
  // artifact-scanner-port.ts
2
3
 
3
4
  import type { ArtifactScanResult } from '../value-objects/artifact-scan-result.js';
@@ -1,3 +1,4 @@
1
+ // @layer domain
1
2
  // biome-lint-port.ts
2
3
 
3
4
  import type { HarnessError } from '../value-objects/harness-api-response.js';
@@ -1,3 +1,4 @@
1
+ // @layer domain
1
2
  // config-query-port.ts
2
3
 
3
4
  import type { PresetInfo, ConfigSummary, PhaseGateSummary } from '../value-objects/harness-status-summary.js';
@@ -1,3 +1,4 @@
1
+ // @layer domain
1
2
  // impact-analysis-port.ts
2
3
 
3
4
  export interface ImpactAnalysisResult {
@@ -1,3 +1,4 @@
1
+ // @layer domain
1
2
  // phase-gate-query-port.ts
2
3
 
3
4
  import type { PhaseGateStoryResult } from '../value-objects/check-ready-result.js';
@@ -1,3 +1,4 @@
1
+ // @layer domain
1
2
  // validator-execution-port.ts
2
3
 
3
4
  import type { ValidatorCheckItem } from '../value-objects/ci-check-result.js';
@@ -1,3 +1,4 @@
1
+ // @layer domain
1
2
  // command-dispatch-service.ts — CommandDispatchService Domain Service
2
3
 
3
4
  import { CommandRegistry } from './command-registry.js';
@@ -1,3 +1,4 @@
1
+ // @layer domain
1
2
  // command-registry.ts — CommandRegistry Domain Service
2
3
 
3
4
  import { CliCommandDefinition, type CommandName } from '../value-objects/cli-command-definition.js';
@@ -1,3 +1,4 @@
1
+ // @layer domain
1
2
  // status-derivation-service.ts — StatusDerivationService Domain Service
2
3
 
3
4
  import { LayerHealth, type LayerId } from '../value-objects/layer-health.js';
@@ -1,3 +1,4 @@
1
+ // @layer domain
1
2
  // artifact-scan-result.ts — ArtifactScanResult Value Object
2
3
 
3
4
  import type { LayerHealth, LayerId } from './layer-health.js';
@@ -1,3 +1,4 @@
1
+ // @layer domain
1
2
  // check-ready-result.ts — CheckReadyResult Value Object
2
3
 
3
4
  export interface PhaseGateStoryResult {
@@ -1,3 +1,4 @@
1
+ // @layer domain
1
2
  // ci-check-result.ts — CiCheckResult Value Object
2
3
 
3
4
  import type { HarnessError } from './harness-api-response.js';
@@ -1,3 +1,4 @@
1
+ // @layer domain
1
2
  // cli-command-definition.ts — CliCommandDefinition Value Object
2
3
 
3
4
  import { CommandInputSpec } from './command-input-spec.js';
@@ -1,3 +1,4 @@
1
+ // @layer domain
1
2
  // command-input-spec.ts — CommandInputSpec Value Object
2
3
 
3
4
  export interface ArgDef {
@@ -1,3 +1,4 @@
1
+ // @layer domain
1
2
  // drift-report-summary.ts — DriftReportSummary Value Object
2
3
 
3
4
  export interface DriftItem {
@@ -1,3 +1,4 @@
1
+ // @layer domain
1
2
  // exit-code-spec.ts — ExitCodeSpec Value Object
2
3
 
3
4
  export class ExitCodeSpec {
@@ -1,3 +1,4 @@
1
+ // @layer domain
1
2
  // harness-api-response.ts — HarnessApiResponse<T> Value Object
2
3
 
3
4
  export type ResponseStatus = 'pass' | 'fail' | 'error';
@@ -1,3 +1,4 @@
1
+ // @layer domain
1
2
  // harness-status-summary.ts — HarnessStatusSummary Value Object
2
3
 
3
4
  import type { LayerHealth, LayerId } from './layer-health.js';
@@ -1,3 +1,4 @@
1
+ // @layer domain
1
2
  // layer-health.ts — LayerHealth Value Object
2
3
 
3
4
  export type LayerId = 'L1' | 'L2' | 'L3' | 'L4';
@@ -1,3 +1,4 @@
1
+ // @layer domain
1
2
  // phase-info.ts — PhaseInfo Value Object
2
3
 
3
4
  export interface PhaseInfoProps {
@@ -1,3 +1,4 @@
1
+ // @layer infrastructure
1
2
  // index.ts — harness-api public barrel export
2
3
 
3
4
  // Composition Root
@@ -1,3 +1,4 @@
1
+ // @layer infrastructure
1
2
  // biome-ast-engine-lint-adapter.ts — BiomeAstEngineLintAdapter
2
3
  // Wave 2完了後にリアル実装へ差し替え(旧: @stub: wave2-pending)
3
4
 
@@ -1,3 +1,4 @@
1
+ // @layer infrastructure
1
2
  // file-system-artifact-scanner-adapter.ts — FileSystemArtifactScannerAdapter
2
3
 
3
4
  import * as fs from 'node:fs/promises';
@@ -1,3 +1,4 @@
1
+ // @layer infrastructure
1
2
  // harness-config-query-adapter.ts — HarnessConfigQueryAdapter
2
3
 
3
4
  import * as fs from 'node:fs/promises';
@@ -1,3 +1,4 @@
1
+ // @layer infrastructure
1
2
  // nyquist-validation-impact-analysis-adapter.ts — NyquistValidationImpactAnalysisAdapter
2
3
  // Wave 2完了後にリアル実装へ差し替え(旧: @stub: wave2-pending)
3
4
 
@@ -1,3 +1,4 @@
1
+ // @layer infrastructure
1
2
  // phase-dependency-model-query-adapter.ts — PhaseDependencyModelQueryAdapter
2
3
  // Wave 2完了後にリアル実装へ差し替え(旧: @stub: wave2-pending)
3
4
 
@@ -1,3 +1,4 @@
1
+ // @layer infrastructure
1
2
  // validator-system-execution-adapter.ts — ValidatorSystemExecutionAdapter
2
3
  // Wave 2完了後にリアル実装へ差し替え(旧: @stub: wave2-pending)
3
4
 
@@ -1,3 +1,4 @@
1
+ // @layer presentation
1
2
  // cli-output-options.ts — CLIOutputOptions DTO
2
3
 
3
4
  export interface CLIOutputOptions {
@@ -1,3 +1,4 @@
1
+ // @layer presentation
1
2
  // harness-api-json-formatter.ts — HarnessApiJsonFormatter
2
3
 
3
4
  import type { HarnessApiResponseContract } from '../../application/dto/harness-api-response-contract.js';
@@ -1,3 +1,4 @@
1
+ // @layer presentation
1
2
  // check-phase-handler.ts — CheckPhaseHandler
2
3
 
3
4
  import type { DispatchCommandUseCase } from '../../application/usecases/dispatch-command-usecase.js';
@@ -1,3 +1,4 @@
1
+ // @layer presentation
1
2
  // check-ready-handler.ts — CheckReadyHandler
2
3
 
3
4
  import type { DispatchCommandUseCase } from '../../application/usecases/dispatch-command-usecase.js';
@@ -1,3 +1,4 @@
1
+ // @layer presentation
1
2
  // ci-check-handler.ts — CiCheckHandler
2
3
 
3
4
  import type { DispatchCommandUseCase } from '../../application/usecases/dispatch-command-usecase.js';
@@ -1,3 +1,4 @@
1
+ // @layer presentation
1
2
  // complete-check-handler.ts — CompleteCheckHandler
2
3
 
3
4
  import type { DispatchCommandUseCase } from '../../application/usecases/dispatch-command-usecase.js';
@@ -1,3 +1,4 @@
1
+ // @layer presentation
1
2
  // detect-drift-handler.ts — DetectDriftHandler
2
3
 
3
4
  import type { DispatchCommandUseCase } from '../../application/usecases/dispatch-command-usecase.js';
@@ -1,3 +1,4 @@
1
+ // @layer presentation
1
2
  // impact-analysis-handler.ts — ImpactAnalysisHandler
2
3
 
3
4
  import type { DispatchCommandUseCase } from '../../application/usecases/dispatch-command-usecase.js';
@@ -1,3 +1,4 @@
1
+ // @layer presentation
1
2
  // lint-handler.ts — LintHandler
2
3
 
3
4
  import type { DispatchCommandUseCase } from '../../application/usecases/dispatch-command-usecase.js';
@@ -1,3 +1,4 @@
1
+ // @layer presentation
1
2
  // status-handler.ts — StatusHandler
2
3
 
3
4
  import type { DispatchCommandUseCase } from '../../application/usecases/dispatch-command-usecase.js';
@@ -2,7 +2,13 @@
2
2
  * @layer infrastructure
3
3
  * @unit harness-error
4
4
  */
5
- import type { HarnessError } from '../../../core/error-reporter.js';
5
+ interface HarnessError {
6
+ code: string;
7
+ severity: string;
8
+ message: { short: string; detailed: string; agentInstruction: string };
9
+ resolution: { fixSuggestion: string; docLinks: string[]; relatedFiles: string[] };
10
+ metadata: { timestamp: string; validator: string; layer: string };
11
+ }
6
12
  import type { ValidatorIssueDraft } from '../../application/dto/validator-issue-draft.js';
7
13
 
8
14
  function compressSuggestion(error: HarnessError): string {
@@ -1,3 +1,4 @@
1
+ // @layer infrastructure
1
2
  /**
2
3
  * Harness Engineering - Pre-commit Integration
3
4
  *