phasegate 0.16.0 → 0.32.0

package/scripts/harness/biome-ast-engine/domain/services/lint-runner.ts

@@ -26,6 +26,9 @@ const toStringArray = (value: unknown, fallback: readonly string[]): readonly st
     ? Object.freeze([...value])
     : fallback;
 
+const isTestFile = (snapshot: SourceModuleSnapshot): boolean =>
+  snapshot.filePath.toString().includes('__tests__/');
+
 export class LintRunner {
   private readonly ruleDefinitionRegistry: RuleDefinitionRegistry;
 
@@ -98,6 +101,10 @@ export class LintRunner {
             LayerBoundary.standardMatrix(),
             layerByFile
           )) {
+            const fromSnapshot = snapshotByPath.get(edge.from.toString());
+            if (fromSnapshot && isTestFile(fromSnapshot)) {
+              continue;
+            }
             ruleViolations.push(
               RuleViolation.create({
                 filePath: edge.from,
@@ -112,6 +119,10 @@ export class LintRunner {
 
           for (const cycle of params.importGraph.detectCycles()) {
             const firstPath = cycle.path[0];
+            const firstSnapshot = snapshotByPath.get(firstPath.toString());
+            if (firstSnapshot && isTestFile(firstSnapshot)) {
+              continue;
+            }
             ruleViolations.push(
               RuleViolation.create({
                 filePath: firstPath,
@@ -127,6 +138,9 @@ export class LintRunner {
         }
         case 'enforce-folder-structure': {
           for (const snapshot of params.snapshots) {
+            if (isTestFile(snapshot)) {
+              continue;
+            }
             if (snapshot.declaredLayer !== null && !snapshot.belongsToLayerDirectory()) {
               ruleViolations.push(
                 RuleViolation.create({
@@ -147,6 +161,9 @@ export class LintRunner {
           const maxAnyRatio = toNumber(rule.config.maxAnyRatio, 0.05);
 
           for (const snapshot of params.snapshots) {
+            if (isTestFile(snapshot)) {
+              continue;
+            }
             if (
               snapshot.anyTypeCount > maxAnyCount ||
               snapshot.anyRatio() > maxAnyRatio
@@ -223,8 +240,15 @@ export class LintRunner {
         case 'no-comment-flood': {
           const maxCommentRatio = toNumber(rule.config.maxCommentRatio, 0.35);
           const maxRepeatedBlocks = toNumber(rule.config.maxRepeatedBlocks, 1);
+          const minLogicalLines = toNumber(rule.config.minLogicalLines, 15);
 
           for (const snapshot of params.snapshots) {
+            if (isTestFile(snapshot)) {
+              continue;
+            }
+            if (snapshot.logicalLineCount < minLogicalLines) {
+              continue;
+            }
             if (
               snapshot.commentDensity() > maxCommentRatio ||
               snapshot.repeatedCommentBlocks > maxRepeatedBlocks

package/scripts/harness/biome-ast-engine/domain/services/rule-definition-registry.ts

@@ -92,7 +92,7 @@ export class RuleDefinitionRegistry {
         'no-comment-flood',
         'L1-008',
         Object.freeze([REQUIRED_INPUT.sourceModuleSnapshots]),
-        Object.freeze({ maxCommentRatio: 0.35, maxRepeatedBlocks: 1 }),
+        Object.freeze({ maxCommentRatio: 0.35, maxRepeatedBlocks: 1, minLogicalLines: 15 }),
         'コメント過多を検出する',
         '不要なコメントを整理し自己説明的なコードへ改善する'
       ),

package/scripts/harness/biome-ast-engine/domain/value-objects/source-module-snapshot.ts

@@ -59,8 +59,9 @@ export class SourceModuleSnapshot {
   readonly duplicationFingerprints: readonly string[];
   readonly exportedSymbols: readonly string[];
   readonly isEntrypointCandidate: boolean;
+  readonly hasRawLayerAnnotation: boolean;
 
-  private constructor(props: Omit<SourceModuleSnapshotProps, 'declaredLayer'> & { declaredLayer: LayerName | null }) {
+  private constructor(props: Omit<SourceModuleSnapshotProps, 'declaredLayer'> & { declaredLayer: LayerName | null; hasRawLayerAnnotation: boolean }) {
     this.filePath = props.filePath;
     this.declaredUnit = props.declaredUnit;
     this.declaredLayer = props.declaredLayer;
@@ -73,6 +74,7 @@ export class SourceModuleSnapshot {
     this.duplicationFingerprints = props.duplicationFingerprints;
     this.exportedSymbols = props.exportedSymbols;
     this.isEntrypointCandidate = props.isEntrypointCandidate;
+    this.hasRawLayerAnnotation = props.hasRawLayerAnnotation;
   }
 
   static create(props: SourceModuleSnapshotProps): SourceModuleSnapshot {
@@ -83,6 +85,7 @@ export class SourceModuleSnapshot {
         filePath: props.filePath,
         declaredUnit: props.declaredUnit,
         declaredLayer,
+        hasRawLayerAnnotation: props.declaredLayer !== null,
         imports: Object.freeze([...props.imports]),
         anyTypeCount: ensureNonNegative(props.anyTypeCount, 'anyTypeCount'),
         typedNodeCount: ensureNonNegative(props.typedNodeCount, 'typedNodeCount'),
@@ -104,7 +107,7 @@ export class SourceModuleSnapshot {
   }
 
   hasLayerComment(): boolean {
-    return this.declaredLayer !== null;
+    return this.hasRawLayerAnnotation;
   }
 
   anyRatio(): number {

package/scripts/harness/biome-ast-engine/infrastructure/adapters/node-workspace-file-adapter.ts

@@ -11,7 +11,7 @@ import { FilePath as FilePathVO } from '../../domain/value-objects/file-path.js'
 import type { WorkspaceFilePort } from '../../domain/ports/workspace-file-port.js';
 
 const SOURCE_EXTENSIONS = new Set(['.ts', '.tsx', '.mts', '.cts']);
-const EXCLUDED_DIRS = new Set(['node_modules', 'dist', 'coverage', '__fixtures__']);
+const EXCLUDED_DIRS = new Set(['node_modules', 'dist', 'coverage', '__fixtures__', 'fixtures']);
 
 export interface NodeWorkspaceFileAdapterDeps {
   readonly rootDir: string;

package/scripts/harness/biome-ast-engine/infrastructure/adapters/typescript-source-module-analyzer-adapter.ts

@@ -64,7 +64,7 @@ export class TypeScriptSourceModuleAnalyzerAdapter implements SourceModuleAnalyz
       snapshots.push(
         SourceModuleSnapshot.create({
           filePath,
-          declaredUnit: unitResult.unitName,
+          declaredUnit: unitResult.unitNames[0],
           declaredLayer: layerResult.layerName,
           imports,
           anyTypeCount: anyCount,

package/scripts/harness/biome-ast-engine/infrastructure/parsers/unit-comment-parser.ts

@@ -3,24 +3,29 @@
  * @unit biome-ast-engine
  */
 
-const UNIT_COMMENT_PATTERN = /^\s*(?:\/\/|\/\*\*?\s*|\*)\s*@unit\s+(\S+)/m;
+const UNIT_COMMENT_PATTERN = /^\s*(?:\/\/|\/\*\*?\s*|\*)\s*@unit\s+(.+)/gm;
 
 export type UnitCommentResult = {
-  readonly unitName: string | null;
+  readonly unitNames: readonly string[];
 };
 
 /**
  * ソースコードから `// @unit {unit}` コメントを抽出する。
  * JSDoc (`/** @unit ... * /`) 形式にも対応する。
+ * カンマ区切りで複数ユニットを指定でき、複数行の @unit も収集する。
+ * 結果は重複除去済み。
  */
 export const parseUnitComment = (sourceCode: string): UnitCommentResult => {
-  const match = sourceCode.match(UNIT_COMMENT_PATTERN);
+  const matches = sourceCode.matchAll(UNIT_COMMENT_PATTERN);
+  const names: string[] = [];
 
-  if (!match) {
-    return { unitName: null };
+  for (const match of matches) {
+    const raw = match[1].replace(/\s*\*\/$/, '').trim();
+    const parts = raw.split(',').map((s) => s.trim()).filter((s) => s.length > 0);
+    names.push(...parts);
   }
 
-  const raw = match[1].replace(/\s*\*\/$/, '');
+  const deduplicated = [...new Set(names)];
 
-  return { unitName: raw };
+  return { unitNames: Object.freeze(deduplicated) };
 };

package/scripts/harness/ci-governance/composition-root.ts

@@ -1,4 +1,5 @@
 /**
+ * @layer infrastructure
  * @unit ci-governance
  *
  * Composition Root - 依存性の組み立て

package/scripts/harness/config-foundation/application/mappers/phase-config-section-mapper.ts

@@ -0,0 +1,44 @@
+/**
+ * @layer application
+ * @unit config-foundation
+ */
+import type { HarnessConfigV2 } from '../../domain/harness-config.js';
+
+function toPhasePreset(
+  value: string,
+): 'default' | 'full' | 'standard' | 'minimal' | 'custom' {
+  if (
+    value === 'default'
+    || value === 'full'
+    || value === 'standard'
+    || value === 'minimal'
+    || value === 'custom'
+  ) {
+    return value;
+  }
+
+  return 'default';
+}
+
+type PhaseDependenciesWithGates = HarnessConfigV2['phaseDependencies'] & {
+  readonly gates?: readonly unknown[];
+};
+
+export function toPhaseConfigSection(resolvedConfig: HarnessConfigV2) {
+  const phaseDependencies = resolvedConfig.phaseDependencies as PhaseDependenciesWithGates;
+
+  return {
+    planningMode: resolvedConfig.planningMode,
+    customization: {
+      preset: toPhasePreset(phaseDependencies.preset),
+      overrideEnabled: phaseDependencies.override,
+      rules: phaseDependencies.customRules.map((rule) => ({
+        targetPhase: rule.phase,
+        condition: 'requires' as const,
+        action: rule.requires,
+      })),
+      gates: phaseDependencies.gates ?? [],
+    },
+    reportingOutputDir: resolvedConfig.reporting.outputDir,
+  };
+}

package/scripts/harness/config-foundation/application/usecases/load-resolved-config-use-case.ts

@@ -42,7 +42,26 @@ function formatHarnessErrors(errors: readonly HarnessError[]): string {
 }
 
 function toSourceDocument(document: unknown): HarnessConfigSourceDocument {
-  return document as HarnessConfigSourceDocument;
+  const sourceDocument = document as HarnessConfigSourceDocument & {
+    readonly phaseDependencies?: HarnessConfigSourceDocument['phaseDependencies'] & {
+      readonly gates?: readonly unknown[];
+    };
+  };
+
+  if (
+    sourceDocument.phaseDependencies === undefined
+    || sourceDocument.phaseDependencies.gates === undefined
+  ) {
+    return sourceDocument;
+  }
+
+  return {
+    ...sourceDocument,
+    phaseDependencies: {
+      ...sourceDocument.phaseDependencies,
+      gates: sourceDocument.phaseDependencies.gates ?? [],
+    },
+  } as HarnessConfigSourceDocument;
 }
 
 export function validateDocumentOrThrow(

package/scripts/harness/config-foundation/domain/harness-config.ts

@@ -23,6 +23,7 @@ import type { L4Config } from './value-objects/l4-config.js';
 export type LayerId = 'L1' | 'L2' | 'L3' | 'L4';
 export type PresetId = 'minimal' | 'standard' | 'strict';
 export type PlanningModeValue = 'interactive' | 'embedded-qa';
+export type PhaseDependenciesPresetId = 'default' | 'full' | 'standard' | 'minimal' | 'custom';
 type DeepPartial<T> = {
   [K in keyof T]?: T[K] extends Array<infer TItem>
     ? Array<DeepPartial<TItem>>
@@ -76,7 +77,7 @@ export interface HarnessConfigResolvedDocument {
     relaxedGates: string[];
   };
   phaseDependencies: {
-    preset: 'default' | 'custom';
+    preset: PhaseDependenciesPresetId;
     override: boolean;
     customRules: Array<{
       phase: string;

package/scripts/harness/config-foundation/domain/value-objects/phase-dependencies-config.ts

@@ -7,17 +7,20 @@
  */
 import { CustomPhaseRule } from './custom-phase-rule.js';
 import type { CustomPhaseRuleProps } from './custom-phase-rule.js';
+import type { PhaseDependenciesPresetId } from '../harness-config.js';
 
 export interface PhaseDependenciesConfigProps {
-  readonly preset: 'default' | 'custom';
+  readonly preset: PhaseDependenciesPresetId;
   readonly override: boolean;
   readonly customRules: readonly CustomPhaseRuleProps[];
+  readonly gates?: readonly unknown[];
 }
 
 export class PhaseDependenciesConfig {
-  readonly preset: 'default' | 'custom';
+  readonly preset: PhaseDependenciesPresetId;
   readonly override: boolean;
   readonly customRules: readonly CustomPhaseRule[];
+  readonly gates: readonly unknown[];
 
   constructor(props: PhaseDependenciesConfigProps) {
     this.preset = props.preset;
@@ -25,6 +28,7 @@ export class PhaseDependenciesConfig {
     this.customRules = props.customRules.map(
       (rule) => new CustomPhaseRule(rule)
     );
+    this.gates = Object.freeze([...(props.gates ?? [])]);
   }
 
   static create(raw: PhaseDependenciesConfigProps): PhaseDependenciesConfig {
@@ -35,12 +39,22 @@ export class PhaseDependenciesConfig {
     return this.customRules.length > 0;
   }
 
+  hasCustomGates(): boolean {
+    return this.gates.length > 0;
+  }
+
   equals(other: PhaseDependenciesConfig): boolean {
     if (this.preset !== other.preset) return false;
     if (this.override !== other.override) return false;
     if (this.customRules.length !== other.customRules.length) return false;
-    return this.customRules.every((rule, idx) =>
+    if (
+      !this.customRules.every((rule, idx) =>
       rule.equals(other.customRules[idx])
-    );
+      )
+    ) {
+      return false;
+    }
+
+    return JSON.stringify(this.gates) === JSON.stringify(other.gates);
   }
 }

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';

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';