phasegate 0.15.0 → 0.31.0

package/scripts/harness/config-foundation/infrastructure/schemas/harness-config-v2.schema.json

@@ -16,7 +16,10 @@
     "project": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["name", "preset"],
+      "required": [
+        "name",
+        "preset"
+      ],
       "properties": {
         "name": {
           "type": "string",
@@ -24,7 +27,11 @@
         },
         "preset": {
           "type": "string",
-          "enum": ["minimal", "standard", "strict"]
+          "enum": [
+            "minimal",
+            "standard",
+            "strict"
+          ]
         }
       }
     },
@@ -152,11 +159,19 @@
     "phaseDependencies": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["preset", "override", "customRules"],
+      "required": [
+        "preset"
+      ],
       "properties": {
         "preset": {
           "type": "string",
-          "enum": ["default", "custom"]
+          "enum": [
+            "default",
+            "full",
+            "standard",
+            "minimal",
+            "custom"
+          ]
         },
         "override": {
           "type": "boolean"
@@ -166,7 +181,10 @@
           "items": {
             "type": "object",
             "additionalProperties": false,
-            "required": ["phase", "requires"],
+            "required": [
+              "phase",
+              "requires"
+            ],
             "properties": {
               "phase": {
                 "type": "string",
@@ -180,23 +198,160 @@
               }
             }
           }
+        },
+        "gates": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "name",
+              "level",
+              "requires",
+              "blocks",
+              "dependsOn"
+            ],
+            "properties": {
+              "name": {
+                "type": "string",
+                "pattern": "^[a-z][a-z0-9-]*$"
+              },
+              "level": {
+                "type": "integer",
+                "enum": [
+                  1,
+                  2,
+                  3
+                ]
+              },
+              "requires": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": [
+                    "path",
+                    "required"
+                  ],
+                  "properties": {
+                    "path": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "required": {
+                      "type": "boolean"
+                    }
+                  }
+                }
+              },
+              "blocks": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "dependsOn": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "pattern": "^[a-z][a-z0-9-]*$"
+                }
+              },
+              "storyAnnotation": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "required",
+                  "tag"
+                ],
+                "properties": {
+                  "required": {
+                    "type": "boolean"
+                  },
+                  "tag": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                }
+              }
+            },
+            "allOf": [
+              {
+                "if": {
+                  "required": [
+                    "storyAnnotation"
+                  ]
+                },
+                "then": {
+                  "properties": {
+                    "level": {
+                      "const": 3
+                    }
+                  }
+                }
+              }
+            ]
+          }
+        },
+        "storyReflection": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "type": "boolean"
+            },
+            "mappings": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "unitId",
+                  "artifacts"
+                ],
+                "properties": {
+                  "unitId": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "artifacts": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "minLength": 1
+                    }
+                  }
+                }
+              }
+            }
+          }
         }
       }
     },
     "planningMode": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["default", "perPhase"],
+      "required": [
+        "default",
+        "perPhase"
+      ],
       "properties": {
         "default": {
           "type": "string",
-          "enum": ["interactive", "embedded-qa"]
+          "enum": [
+            "interactive",
+            "embedded-qa"
+          ]
         },
         "perPhase": {
           "type": "object",
           "additionalProperties": {
             "type": "string",
-            "enum": ["interactive", "embedded-qa"]
+            "enum": [
+              "interactive",
+              "embedded-qa"
+            ]
           }
         }
       }
@@ -223,7 +378,10 @@
     "paths": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["designDocs", "inceptionDocs"],
+      "required": [
+        "designDocs",
+        "inceptionDocs"
+      ],
       "properties": {
         "designDocs": {
           "type": "string",
@@ -238,7 +396,10 @@
     "reporting": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["format", "outputDir"],
+      "required": [
+        "format",
+        "outputDir"
+      ],
       "properties": {
         "format": {
           "type": "string",
@@ -249,6 +410,20 @@
           "minLength": 1
         }
       }
+    },
+    "protectedFiles": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "exclude": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "uniqueItems": true
+        }
+      }
     }
   }
 }

package/scripts/harness/config-foundation/infrastructure/validators/ajv-config-schema-validator.ts

@@ -5,7 +5,8 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import Ajv, { type ErrorObject, type ValidateFunction } from 'ajv';
+import AjvModule, { type ErrorObject, type ValidateFunction } from 'ajv';
+const Ajv = AjvModule.default ?? AjvModule;
 import { HarnessError } from '../../../harness-error/domain/value-objects/harness-error.js';
 import { ErrorCode } from '../../../harness-error/domain/value-objects/error-code.js';
 import { Severity } from '../../../harness-error/domain/value-objects/severity.js';

package/scripts/harness/harness-api/application/dto/command-dispatch-input.ts

@@ -1,3 +1,4 @@
+// @layer application
 // command-dispatch-input.ts — CommandDispatchInput DTO
 
 export interface CommandDispatchInput {

package/scripts/harness/harness-api/application/dto/command-dispatch-output.ts

@@ -1,3 +1,4 @@
+// @layer application
 // command-dispatch-output.ts — CommandDispatchOutput DTO
 
 import type { ExitCode } from '../../domain/value-objects/harness-api-response.js';

package/scripts/harness/harness-api/application/dto/exit-code-decision-input.ts

@@ -1,3 +1,4 @@
+// @layer application
 // exit-code-decision-input.ts — ExitCodeDecisionInput DTO
 
 import type { ResponseStatus } from '../../domain/value-objects/harness-api-response.js';

package/scripts/harness/harness-api/application/dto/exit-code-decision-output.ts

@@ -1,3 +1,4 @@
+// @layer application
 // exit-code-decision-output.ts — ExitCodeDecisionOutput DTO
 
 import type { ExitCode } from '../../domain/value-objects/harness-api-response.js';

package/scripts/harness/harness-api/application/dto/harness-api-response-contract.ts

@@ -1,3 +1,4 @@
+// @layer application
 // harness-api-response-contract.ts — Cross-Unit Contract DTO
 
 import type { ResponseStatus, HarnessError, ResponseSummary } from '../../domain/value-objects/harness-api-response.js';

package/scripts/harness/harness-api/application/dto/initialize-registry-input.ts

@@ -1,3 +1,4 @@
+// @layer application
 // initialize-registry-input.ts — InitializeRegistryInput DTO
 
 export interface CliCommandDefinitionInput {

package/scripts/harness/harness-api/application/dto/registry-summary-output.ts

@@ -1,3 +1,4 @@
+// @layer application
 // registry-summary-output.ts — RegistrySummaryOutput DTO
 
 import type { CommandName } from '../../domain/value-objects/cli-command-definition.js';

package/scripts/harness/harness-api/application/dto/status-derivation-input.ts

@@ -1,3 +1,4 @@
+// @layer application
 // status-derivation-input.ts — StatusDerivationInput DTO
 
 // Currently no parameters — extensible for future filter conditions

package/scripts/harness/harness-api/application/mappers/harness-api-response-mapper.ts

@@ -1,3 +1,4 @@
+// @layer application
 // harness-api-response-mapper.ts — HarnessApiResponseMapper
 
 import type { HarnessApiResponse } from '../../domain/value-objects/harness-api-response.js';

package/scripts/harness/harness-api/application/usecases/decide-exit-code-usecase.ts

@@ -1,3 +1,4 @@
+// @layer application
 // decide-exit-code-usecase.ts — DecideExitCodeUseCase
 
 import type { ExitCodeDecisionInput } from '../dto/exit-code-decision-input.js';
@@ -8,11 +9,11 @@ export class DecideExitCodeUseCase {
   execute(input: ExitCodeDecisionInput): ExitCodeDecisionOutput {
     const { status, commandName } = input;
 
-    // D5ルール: harness:status は fail でも exitCode=0 を返す
-    if (commandName === 'harness:status' && status === 'fail') {
+    // D5ルール: phasegate:status は fail でも exitCode=0 を返す
+    if (commandName === 'phasegate:status' && status === 'fail') {
       return {
         exitCode: 0 as ExitCode,
-        reason: 'D5ルール適用: harness:statusコマンドはfailでもexitCode=0を返す（情報提供コマンドのため）',
+        reason: 'D5ルール適用: phasegate:statusコマンドはfailでもexitCode=0を返す（情報提供コマンドのため）',
       };
     }
 

package/scripts/harness/harness-api/application/usecases/derive-harness-status-usecase.ts

@@ -1,3 +1,4 @@
+// @layer application
 // derive-harness-status-usecase.ts — DeriveHarnessStatusUseCase
 
 import type { ArtifactScannerPort } from '../../domain/ports/artifact-scanner-port.js';

package/scripts/harness/harness-api/application/usecases/dispatch-command-usecase.ts

@@ -1,3 +1,4 @@
+// @layer application
 // dispatch-command-usecase.ts — DispatchCommandUseCase
 
 import { CommandRegistry } from '../../domain/services/command-registry.js';

package/scripts/harness/harness-api/application/usecases/initialize-command-registry-usecase.ts

@@ -1,3 +1,4 @@
+// @layer application
 // initialize-command-registry-usecase.ts — InitializeCommandRegistryUseCase
 
 import { CliCommandDefinition } from '../../domain/value-objects/cli-command-definition.js';

package/scripts/harness/harness-api/composition-root.ts

@@ -1,3 +1,4 @@
+// @layer infrastructure
 // composition-root.ts — harness-api Composition Root
 
 import { CommandRegistry } from './domain/services/command-registry.js';

package/scripts/harness/harness-api/domain/ports/artifact-scanner-port.ts

@@ -1,3 +1,4 @@
+// @layer domain
 // artifact-scanner-port.ts
 
 import type { ArtifactScanResult } from '../value-objects/artifact-scan-result.js';

package/scripts/harness/harness-api/domain/ports/biome-lint-port.ts

@@ -1,3 +1,4 @@
+// @layer domain
 // biome-lint-port.ts
 
 import type { HarnessError } from '../value-objects/harness-api-response.js';

package/scripts/harness/harness-api/domain/ports/config-query-port.ts

@@ -1,3 +1,4 @@
+// @layer domain
 // config-query-port.ts
 
 import type { PresetInfo, ConfigSummary, PhaseGateSummary } from '../value-objects/harness-status-summary.js';

package/scripts/harness/harness-api/domain/ports/impact-analysis-port.ts

@@ -1,3 +1,4 @@
+// @layer domain
 // impact-analysis-port.ts
 
 export interface ImpactAnalysisResult {

package/scripts/harness/harness-api/domain/ports/phase-gate-query-port.ts

@@ -1,3 +1,4 @@
+// @layer domain
 // phase-gate-query-port.ts
 
 import type { PhaseGateStoryResult } from '../value-objects/check-ready-result.js';

package/scripts/harness/harness-api/domain/ports/validator-execution-port.ts

@@ -1,3 +1,4 @@
+// @layer domain
 // validator-execution-port.ts
 
 import type { ValidatorCheckItem } from '../value-objects/ci-check-result.js';

package/scripts/harness/harness-api/domain/services/command-dispatch-service.ts

@@ -1,3 +1,4 @@
+// @layer domain
 // command-dispatch-service.ts — CommandDispatchService Domain Service
 
 import { CommandRegistry } from './command-registry.js';
@@ -35,14 +36,14 @@ function makeError(message: string): HarnessError {
 }
 
 const KNOWN_COMMANDS = new Set([
-  'harness:check-ready',
-  'harness:check-phase',
-  'harness:ci-check',
-  'harness:detect-drift',
-  'harness:status',
-  'harness:lint',
-  'harness:complete-check',
-  'harness:impact-analysis',
+  'phasegate:check-ready',
+  'phasegate:check-phase',
+  'phasegate:ci-check',
+  'phasegate:detect-drift',
+  'phasegate:status',
+  'phasegate:lint',
+  'phasegate:complete-check',
+  'phasegate:impact-analysis',
 ]);
 
 export class CommandDispatchService {
@@ -104,7 +105,7 @@ export class CommandDispatchService {
     summary: { totalChecks: number; passed: number; failed: number; warnings: number }
   ): Promise<DispatchResult<T>> {
     switch (commandName) {
-      case 'harness:check-ready': {
+      case 'phasegate:check-ready': {
         const stories = await this.ports.phaseGateQueryPort.queryAllStories();
         const result = CheckReadyResult.fromStories(stories);
         if (result.allPassed) {
@@ -117,7 +118,7 @@ export class CommandDispatchService {
         return { status: 'fail', errors: r.errors, summary: r.summary, data: result as unknown as T, exitCode: 1 };
       }
 
-      case 'harness:check-phase': {
+      case 'phasegate:check-phase': {
         const unitId = args.unit ?? '';
         const phaseInfo = await this.ports.phaseGateQueryPort.queryUnit(unitId);
         if (phaseInfo === null) {
@@ -129,7 +130,7 @@ export class CommandDispatchService {
         return { status: 'pass', errors: [], summary: r.summary, data: phaseInfo as unknown as T, exitCode: 0 };
       }
 
-      case 'harness:ci-check': {
+      case 'phasegate:ci-check': {
         const validatorResults = await this.ports.validatorExecutionPort.runL3Validators();
         const result = CiCheckResult.fromResults(validatorResults);
         if (result.allPassed) {
@@ -144,7 +145,7 @@ export class CommandDispatchService {
         return { status: 'fail', errors: r.errors, summary: r.summary, data: result as unknown as T, exitCode: 1 };
       }
 
-      case 'harness:detect-drift': {
+      case 'phasegate:detect-drift': {
         const drifts = await this.ports.validatorExecutionPort.runDriftDetection();
         const result = DriftReportSummary.fromDrifts(drifts);
         if (!result.hasDrift()) {
@@ -156,7 +157,7 @@ export class CommandDispatchService {
         return { status: 'fail', errors: r.errors, summary: r.summary, data: result as unknown as T, exitCode: 1 };
       }
 
-      case 'harness:status': {
+      case 'phasegate:status': {
         const scanResult = await this.ports.artifactScannerPort.scan();
         let presetInfo = { name: 'standard' as const, enabledLayers: ['L1', 'L2', 'L3'] as ('L1' | 'L2' | 'L3' | 'L4')[] };
         const configPort = this.ports.configQueryPort;
@@ -176,7 +177,7 @@ export class CommandDispatchService {
         return { status: 'pass', errors: [], summary: r.summary, data: statusSummary as unknown as T, exitCode: 0 };
       }
 
-      case 'harness:lint': {
+      case 'phasegate:lint': {
         const lintResult = await this.ports.biomeLintPort.runLint();
         if (lintResult.passed) {
           const r = HarnessApiResponse.pass({ ...summary, passed: 1 });
@@ -187,7 +188,7 @@ export class CommandDispatchService {
         return { status: 'fail', errors: r.errors, summary: r.summary, data: undefined, exitCode: 1 };
       }
 
-      case 'harness:complete-check': {
+      case 'phasegate:complete-check': {
         const [validatorResults, lintResult] = await Promise.all([
           this.ports.validatorExecutionPort.runAllValidators(),
           this.ports.biomeLintPort.runLint(),
@@ -211,7 +212,7 @@ export class CommandDispatchService {
         return { status: 'fail', errors: r.errors, summary: r.summary, data: undefined, exitCode: 1 };
       }
 
-      case 'harness:impact-analysis': {
+      case 'phasegate:impact-analysis': {
         const storyId = args.storyId ?? '';
         const result = await this.ports.impactAnalysisPort.analyze(storyId);
         if (result === null) {

package/scripts/harness/harness-api/domain/services/command-registry.ts

@@ -1,3 +1,4 @@
+// @layer domain
 // command-registry.ts — CommandRegistry Domain Service
 
 import { CliCommandDefinition, type CommandName } from '../value-objects/cli-command-definition.js';
@@ -6,12 +7,12 @@ export class CommandRegistry {
   private readonly commands: Map<string, CliCommandDefinition> = new Map();
 
   registerCommand(definition: CliCommandDefinition): void {
-    // INV-2: harness: プレフィックス必須
+    // INV-2: phasegate: プレフィックス必須
     if (!definition.commandName || definition.commandName.trim() === '') {
       throw new Error('HarnessApiDomainError: commandName must not be empty');
     }
-    if (!definition.commandName.startsWith('harness:')) {
-      throw new Error(`DuplicateCommandNameError: commandName must start with 'harness:': ${definition.commandName}`);
+    if (!definition.commandName.startsWith('phasegate:')) {
+      throw new Error(`DuplicateCommandNameError: commandName must start with 'phasegate:': ${definition.commandName}`);
     }
     // INV-1: 同一コマンド名の重複禁止
     if (this.commands.has(definition.commandName)) {

package/scripts/harness/harness-api/domain/services/status-derivation-service.ts

@@ -1,3 +1,4 @@
+// @layer domain
 // status-derivation-service.ts — StatusDerivationService Domain Service
 
 import { LayerHealth, type LayerId } from '../value-objects/layer-health.js';

package/scripts/harness/harness-api/domain/value-objects/artifact-scan-result.ts

@@ -1,3 +1,4 @@
+// @layer domain
 // artifact-scan-result.ts — ArtifactScanResult Value Object
 
 import type { LayerHealth, LayerId } from './layer-health.js';

package/scripts/harness/harness-api/domain/value-objects/check-ready-result.ts

@@ -1,3 +1,4 @@
+// @layer domain
 // check-ready-result.ts — CheckReadyResult Value Object
 
 export interface PhaseGateStoryResult {

package/scripts/harness/harness-api/domain/value-objects/ci-check-result.ts

@@ -1,3 +1,4 @@
+// @layer domain
 // ci-check-result.ts — CiCheckResult Value Object
 
 import type { HarnessError } from './harness-api-response.js';

package/scripts/harness/harness-api/domain/value-objects/cli-command-definition.ts

@@ -1,3 +1,4 @@
+// @layer domain
 // cli-command-definition.ts — CliCommandDefinition Value Object
 
 import { CommandInputSpec } from './command-input-spec.js';
@@ -15,17 +16,17 @@ export type CommandOutputType =
   | 'complete-check'
   | 'impact-analysis';
 
-const COMMAND_NAME_REGEX = /^harness:[a-z][a-z0-9-]*$/;
+const COMMAND_NAME_REGEX = /^phasegate:[a-z][a-z0-9-]*$/;
 
 const OUTPUT_TYPE_MAP: Record<string, CommandOutputType> = {
-  'harness:check-ready': 'check-ready',
-  'harness:check-phase': 'check-phase',
-  'harness:ci-check': 'ci-check',
-  'harness:detect-drift': 'detect-drift',
-  'harness:status': 'status',
-  'harness:lint': 'lint',
-  'harness:complete-check': 'complete-check',
-  'harness:impact-analysis': 'impact-analysis',
+  'phasegate:check-ready': 'check-ready',
+  'phasegate:check-phase': 'check-phase',
+  'phasegate:ci-check': 'ci-check',
+  'phasegate:detect-drift': 'detect-drift',
+  'phasegate:status': 'status',
+  'phasegate:lint': 'lint',
+  'phasegate:complete-check': 'complete-check',
+  'phasegate:impact-analysis': 'impact-analysis',
 };
 
 export interface CliCommandDefinitionProps {
@@ -68,7 +69,7 @@ export class CliCommandDefinition {
     }
   ): CliCommandDefinition {
     if (!commandName || !COMMAND_NAME_REGEX.test(commandName)) {
-      throw new Error(`InvalidCommandNameError: invalid command name '${commandName}'. Must match ^harness:[a-z][a-z0-9-]*$`);
+      throw new Error(`InvalidCommandNameError: invalid command name '${commandName}'. Must match ^phasegate:[a-z][a-z0-9-]*$`);
     }
 
     const outputType =

package/scripts/harness/harness-api/domain/value-objects/command-input-spec.ts

@@ -1,3 +1,4 @@
+// @layer domain
 // command-input-spec.ts — CommandInputSpec Value Object
 
 export interface ArgDef {

package/scripts/harness/harness-api/domain/value-objects/drift-report-summary.ts

@@ -1,3 +1,4 @@
+// @layer domain
 // drift-report-summary.ts — DriftReportSummary Value Object
 
 export interface DriftItem {

package/scripts/harness/harness-api/domain/value-objects/exit-code-spec.ts

@@ -1,3 +1,4 @@
+// @layer domain
 // exit-code-spec.ts — ExitCodeSpec Value Object
 
 export class ExitCodeSpec {

package/scripts/harness/harness-api/domain/value-objects/harness-api-response.ts

@@ -1,3 +1,4 @@
+// @layer domain
 // harness-api-response.ts — HarnessApiResponse<T> Value Object
 
 export type ResponseStatus = 'pass' | 'fail' | 'error';

package/scripts/harness/harness-api/domain/value-objects/harness-status-summary.ts

@@ -1,3 +1,4 @@
+// @layer domain
 // harness-status-summary.ts — HarnessStatusSummary Value Object
 
 import type { LayerHealth, LayerId } from './layer-health.js';

package/scripts/harness/harness-api/domain/value-objects/layer-health.ts

@@ -1,3 +1,4 @@
+// @layer domain
 // layer-health.ts — LayerHealth Value Object
 
 export type LayerId = 'L1' | 'L2' | 'L3' | 'L4';

package/scripts/harness/harness-api/domain/value-objects/phase-info.ts

@@ -1,3 +1,4 @@
+// @layer domain
 // phase-info.ts — PhaseInfo Value Object
 
 export interface PhaseInfoProps {

package/scripts/harness/harness-api/index.ts

@@ -1,3 +1,4 @@
+// @layer infrastructure
 // index.ts — harness-api public barrel export
 
 // Composition Root

package/scripts/harness/harness-api/infrastructure/adapters/biome-ast-engine-lint-adapter.ts

@@ -1,3 +1,4 @@
+// @layer infrastructure
 // biome-ast-engine-lint-adapter.ts — BiomeAstEngineLintAdapter
 // Wave 2完了後にリアル実装へ差し替え（旧: @stub: wave2-pending）