phasegate 0.16.0 → 0.31.0

package/scripts/harness/phase-dependency-model/domain/values/story-reflection-result.ts

@@ -0,0 +1,55 @@
+/**
+ * @layer domain
+ * @unit phase-dependency-model
+ */
+
+import type { StoryReflectionMapping } from './story-reflection-mapping.js';
+
+export interface StoryReflectionViolation {
+  readonly storyId: string;
+  readonly mapping: StoryReflectionMapping;
+  readonly inceptionPath: string;
+  readonly productPath: string;
+}
+
+interface StoryReflectionResultCreateArgs {
+  readonly passed: boolean;
+  readonly violations: readonly StoryReflectionViolation[];
+  readonly warnings: readonly StoryReflectionViolation[];
+}
+
+export class StoryReflectionResult {
+  readonly passed: boolean;
+  readonly violations: readonly StoryReflectionViolation[];
+  readonly warnings: readonly StoryReflectionViolation[];
+
+  private constructor(args: StoryReflectionResultCreateArgs) {
+    this.passed = args.passed;
+    this.violations = Object.freeze([...args.violations]);
+    this.warnings = Object.freeze([...args.warnings]);
+    Object.freeze(this);
+  }
+
+  static pass(): StoryReflectionResult {
+    return new StoryReflectionResult({
+      passed: true,
+      violations: [],
+      warnings: [],
+    });
+  }
+
+  static create(args: {
+    violations: readonly StoryReflectionViolation[];
+    warnings: readonly StoryReflectionViolation[];
+  }): StoryReflectionResult {
+    return new StoryReflectionResult({
+      passed: args.violations.length === 0,
+      violations: args.violations,
+      warnings: args.warnings,
+    });
+  }
+
+  isBlocked(): boolean {
+    return this.violations.length > 0;
+  }
+}

package/scripts/harness/phase-dependency-model/infrastructure/adapters/picomatch-glob-matcher.ts

@@ -0,0 +1,17 @@
+// @unit phase-dependency-model
+// @layer infrastructure
+
+import { createRequire } from 'node:module';
+import type { GlobMatcherPort } from '../../domain/ports/glob-matcher-port.js';
+
+const require = createRequire(import.meta.url);
+const picomatch = require('picomatch') as (
+  pattern: string,
+  options?: { readonly dot?: boolean },
+) => (path: string) => boolean;
+
+export class PicomatchGlobMatcher implements GlobMatcherPort {
+  match(pattern: string, path: string): boolean {
+    return picomatch(pattern, { dot: true })(path);
+  }
+}

package/scripts/harness/phase-dependency-model/infrastructure/adapters/story-annotation-verifier-adapter.ts

@@ -0,0 +1,46 @@
+// @unit phase-dependency-model
+// @layer infrastructure
+
+import type { StoryAnnotationVerifierPort } from '../../domain/ports/story-annotation-verifier-port.js';
+import { ProjectRelativePath } from '../../../traceability-model/domain/value-objects/project-relative-path.js';
+import type { MarkdownDesignDocumentGateway } from '../../../traceability-model/infrastructure/gateways/markdown-design-document-gateway.js';
+
+export interface StoryAnnotationVerifierAdapterDeps {
+  readonly designDocumentGateway: Pick<
+    MarkdownDesignDocumentGateway,
+    'readStoryAnnotations'
+  >;
+}
+
+export class StoryAnnotationVerifierAdapter
+  implements StoryAnnotationVerifierPort
+{
+  private readonly designDocumentGateway: StoryAnnotationVerifierAdapterDeps['designDocumentGateway'];
+
+  constructor(deps: StoryAnnotationVerifierAdapterDeps) {
+    this.designDocumentGateway = deps.designDocumentGateway;
+  }
+
+  async verify(targetFilePath: string, tag: string) {
+    if (tag.trim() !== '@story-id') {
+      return Object.freeze({
+        hasAnnotation: false,
+      });
+    }
+
+    const filePath = ProjectRelativePath.create(targetFilePath);
+    const annotations =
+      await this.designDocumentGateway.readStoryAnnotations(filePath);
+
+    if (annotations.length === 0) {
+      return Object.freeze({
+        hasAnnotation: false,
+      });
+    }
+
+    return Object.freeze({
+      hasAnnotation: true,
+      storyId: annotations[0]?.storyId.value,
+    });
+  }
+}

package/scripts/harness/phase-dependency-model/infrastructure/config/custom-gates-config-parser.ts

@@ -0,0 +1,22 @@
+// @unit phase-dependency-model
+// @layer infrastructure
+
+import { GateGraph } from '../../domain/services/gate-graph.js';
+import { GateDefinition } from '../../domain/values/gate-definition.js';
+
+export interface CustomGatesConfigParseResult {
+  readonly gates: readonly GateDefinition[];
+  readonly graph: GateGraph;
+}
+
+export class CustomGatesConfigParser {
+  parse(raw: readonly unknown[]): CustomGatesConfigParseResult {
+    const gates = Object.freeze(raw.map((entry) => GateDefinition.fromRaw(entry)));
+    const graph = GateGraph.build([...gates]);
+
+    return Object.freeze({
+      gates,
+      graph,
+    });
+  }
+}

package/scripts/harness/phase-dependency-model/infrastructure/config/harness-config-phase-config-provider.ts

@@ -5,8 +5,34 @@
 
 import type { PhaseConfigProviderPort } from '../../domain/ports/phase-config-provider-port.js';
 import { PlanningMode } from '../../domain/values/planning-mode.js';
-import { PhaseCustomizationPolicy } from '../../domain/values/phase-customization-policy.js';
+import {
+  PhaseCustomizationPolicy,
+  type PresetName,
+} from '../../domain/values/phase-customization-policy.js';
 import { CustomRule } from '../../domain/values/custom-rule.js';
+import { StoryReflectionConfig } from '../../domain/values/story-reflection-config.js';
+import { StoryReflectionMapping } from '../../domain/values/story-reflection-mapping.js';
+import { FULL_STORY_REFLECTION_DEFAULTS } from '../../domain/definitions/full-story-reflection-defaults.js';
+import { STANDARD_STORY_REFLECTION_DEFAULTS } from '../../domain/definitions/standard-story-reflection-defaults.js';
+import { MINIMAL_STORY_REFLECTION_DEFAULTS } from '../../domain/definitions/minimal-story-reflection-defaults.js';
+
+export interface StoryReflectionMappingInput {
+  readonly inception: string;
+  readonly product: string;
+  readonly required: boolean;
+}
+
+export interface StoryReflectionSectionInput {
+  readonly enabled?: boolean;
+  readonly mappings?: readonly StoryReflectionMappingInput[];
+}
+
+export type PhasePresetInput =
+  | 'default'
+  | 'full'
+  | 'standard'
+  | 'minimal'
+  | 'custom';
 
 export interface PhaseConfigSection {
   readonly planningMode?:
@@ -18,7 +44,7 @@ export interface PhaseConfigSection {
         readonly overrides?: Record<string, string>;
       };
   readonly customization?: {
-    readonly preset?: 'default' | 'custom';
+    readonly preset?: PhasePresetInput;
     readonly overrideEnabled?: boolean;
     readonly rules?: ReadonlyArray<{
       readonly targetPhase: string;
@@ -26,9 +52,22 @@ export interface PhaseConfigSection {
       readonly action: readonly string[];
     }>;
   };
+  readonly storyReflection?: StoryReflectionSectionInput;
   readonly reportingOutputDir?: string;
 }
 
+/**
+ * プリセットごとの storyReflection デフォルト定義。
+ * `default` は v1.0 で `full` に統合されたため同一値にエイリアスする。
+ */
+const PRESET_STORY_REFLECTION_DEFAULTS: Record<PresetName, StoryReflectionConfig> = {
+  full: FULL_STORY_REFLECTION_DEFAULTS,
+  standard: STANDARD_STORY_REFLECTION_DEFAULTS,
+  minimal: MINIMAL_STORY_REFLECTION_DEFAULTS,
+  // custom プリセットは明示設定を強制するためデフォルトは無効扱い
+  custom: StoryReflectionConfig.disabled(),
+};
+
 export interface HarnessConfigPhaseConfigProviderDeps {
   readonly config: PhaseConfigSection;
   readonly defaultOutputDir: string;
@@ -95,4 +134,41 @@ export class HarnessConfigPhaseConfigProvider
   async getReportingOutputDir(): Promise<string> {
     return this.config.reportingOutputDir ?? this.defaultOutputDir;
   }
+
+  async getStoryReflectionConfig(): Promise<StoryReflectionConfig> {
+    const policy = await this.getCustomizationPolicy();
+    const presetDefault = PRESET_STORY_REFLECTION_DEFAULTS[policy.preset];
+    const section = this.config.storyReflection;
+
+    if (section === undefined) {
+      return presetDefault;
+    }
+
+    // enabled 明示 false → disabled で即返す（mappings 無視）
+    if (section.enabled === false) {
+      return StoryReflectionConfig.disabled();
+    }
+
+    // enabled 省略時はプリセットの enabled を継承
+    const enabled = section.enabled ?? presetDefault.enabled;
+
+    // mappings 省略 → プリセットデフォルトの mappings を流用
+    const rawMappings = section.mappings;
+    if (rawMappings === undefined) {
+      return StoryReflectionConfig.create({
+        enabled,
+        mappings: presetDefault.mappings,
+      });
+    }
+
+    const mappings = rawMappings.map((m) =>
+      StoryReflectionMapping.create({
+        inception: m.inception,
+        product: m.product,
+        required: m.required,
+      }),
+    );
+
+    return StoryReflectionConfig.create({ enabled, mappings });
+  }
 }

package/scripts/harness/phase-dependency-model/infrastructure/filesystem/file-system-story-reflection-adapter.ts

@@ -0,0 +1,94 @@
+/**
+ * @layer infrastructure
+ * @unit phase-dependency-model
+ */
+
+import { readdir, readFile, access } from 'node:fs/promises';
+import path from 'node:path';
+import type { StoryReflectionFileSystemPort } from '../../domain/ports/story-reflection-file-system-port.js';
+
+export interface FileSystemStoryReflectionAdapterDeps {
+  readonly rootDir: string;
+  /** inception ディレクトリのルート（デフォルト: docs/inception） */
+  readonly inceptionRoot?: string;
+}
+
+/**
+ * ファイルシステム上の docs/inception ディレクトリ列挙と
+ * product 文書内 `@story-id` アノテーション検索を実装するアダプタ。
+ *
+ * 存在しないパス・読めないファイルは true/false に正規化し例外を投げない
+ * ことで、上位 (StoryReflectionChecker) の純粋性を保つ。
+ */
+export class FileSystemStoryReflectionAdapter
+  implements StoryReflectionFileSystemPort
+{
+  private readonly rootDir: string;
+  private readonly inceptionRoot: string;
+
+  constructor(deps: FileSystemStoryReflectionAdapterDeps) {
+    this.rootDir = deps.rootDir;
+    this.inceptionRoot = deps.inceptionRoot ?? 'docs/inception';
+  }
+
+  async listStoryDirectories(unitId: string): Promise<readonly string[]> {
+    const unitDir = path.join(this.rootDir, this.inceptionRoot, unitId);
+
+    let entries;
+    try {
+      entries = await readdir(unitDir, { withFileTypes: true });
+    } catch {
+      return [];
+    }
+
+    return entries
+      .filter((entry) => entry.isDirectory())
+      .map((entry) => entry.name)
+      .filter((name) => !name.startsWith('_') && !name.startsWith('.'))
+      .sort();
+  }
+
+  async fileExists(relativePath: string): Promise<boolean> {
+    const absolutePath = path.join(this.rootDir, relativePath);
+    try {
+      await access(absolutePath);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  async fileContainsStoryAnnotation(
+    productPath: string,
+    storyId: string,
+  ): Promise<boolean> {
+    const absolutePath = path.join(this.rootDir, productPath);
+
+    let content: string;
+    try {
+      content = await readFile(absolutePath, 'utf8');
+    } catch {
+      return false;
+    }
+
+    // `@story-id` の直後にカンマ/空白区切りで列挙される story ID を抽出。
+    // 例: `@story-id US-001`, `@story-id US-001, US-002`,
+    //     `<!-- @story-id US-001 -->`
+    // 行末または `-->` まで（story ID 自体の `-` は許容するため `-->` を明示終端に使う）。
+    const pattern = /@story-id[ \t]+([^\n\r]+)/g;
+    let match: RegExpExecArray | null;
+    while ((match = pattern.exec(content)) !== null) {
+      // `-->` 以降の HTML コメント閉じ記号を取り除く
+      const raw = match[1].replace(/-->.*$/, '');
+      const ids = raw
+        .split(/[\s,]+/)
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+      if (ids.includes(storyId)) {
+        return true;
+      }
+    }
+
+    return false;
+  }
+}

package/scripts/harness/phase-dependency-model/presentation/cli/check-phase-gate-command-handler.ts

@@ -3,13 +3,13 @@
  * @unit phase-dependency-model
  */
 
-import type { CheckPhaseGateUseCase, CheckPhaseGateInput } from '../../application/usecases/check-phase-gate-usecase.js';
 import type { PhaseGateResultDto } from '../../application/dto/phase-gate-result-dto.js';
 
 export interface CheckPhaseGateCommandInput {
   readonly targetLevel: number;
   readonly unitId?: string;
   readonly storyId?: string;
+  readonly targetFilePath?: string;
   readonly json?: boolean;
 }
 
@@ -20,11 +20,18 @@ export interface CheckPhaseGateCommandOutput {
 }
 
 export interface CheckPhaseGateCommandHandlerDeps {
-  readonly checkPhaseGateUseCase: Pick<CheckPhaseGateUseCase, 'execute'>;
+  readonly checkPhaseGateUseCase: {
+    execute(input: {
+      readonly targetLevel: 1 | 2 | 3;
+      readonly unitId?: string;
+      readonly storyId?: string;
+      readonly targetFilePath?: string;
+    }): Promise<PhaseGateResultDto>;
+  };
 }
 
 export class CheckPhaseGateCommandHandler {
-  private readonly useCase: Pick<CheckPhaseGateUseCase, 'execute'>;
+  private readonly useCase: CheckPhaseGateCommandHandlerDeps['checkPhaseGateUseCase'];
 
   constructor(deps: CheckPhaseGateCommandHandlerDeps) {
     this.useCase = deps.checkPhaseGateUseCase;
@@ -42,10 +49,11 @@ export class CheckPhaseGateCommandHandler {
     }
 
     try {
-      const useCaseInput: CheckPhaseGateInput = {
+      const useCaseInput = {
         targetLevel: input.targetLevel as 1 | 2 | 3,
         unitId: input.unitId,
         storyId: input.storyId,
+        targetFilePath: input.targetFilePath,
       };
 
       const result = await this.useCase.execute(useCaseInput);

package/scripts/harness/phase-dependency-model/presentation/cli/story-reflection-status-presenter.ts

@@ -0,0 +1,87 @@
+// @unit phase-dependency-model
+// @layer presentation
+/**
+ * StoryReflectionStatusPresenter
+ *
+ * CLI (`phasegate:status`, `phasegate validate --layer L2`) 用の
+ * storyReflection 状態整形を担うプレゼンター。
+ *
+ * 責務:
+ *   - status コマンド向けの 1 行サマリー生成（有効/無効・preset・mapping 数）
+ *   - validate --layer L2 向けの検証結果サマリー生成
+ *     （violations / warnings 件数と代表情報）
+ *
+ * 呼び出し元 (main.ts / presentation) で設定と CheckStoryReflectionUseCase の
+ * 実行結果を受け取り、人間可読な行を組み立てる。
+ */
+
+import type { StoryReflectionConfig } from '../../domain/values/story-reflection-config.js';
+import type { StoryReflectionResult } from '../../domain/values/story-reflection-result.js';
+import type { PresetName } from '../../domain/values/phase-customization-policy.js';
+
+export interface StoryReflectionStatusLineInput {
+  readonly config: StoryReflectionConfig;
+  readonly preset: PresetName;
+}
+
+export interface StoryReflectionValidationSummaryInput {
+  readonly config: StoryReflectionConfig;
+  readonly preset: PresetName;
+  readonly result: StoryReflectionResult;
+}
+
+export class StoryReflectionStatusPresenter {
+  formatStatusLine(input: StoryReflectionStatusLineInput): string {
+    const { config, preset } = input;
+    const state = config.enabled ? 'enabled' : 'disabled';
+    const required = config.mappings.filter((m) => m.required).length;
+    const optional = config.mappings.filter((m) => !m.required).length;
+
+    return [
+      'storyReflection:',
+      state,
+      `preset=${preset}`,
+      `mappings=${config.mappings.length}`,
+      `required=${required}`,
+      `optional=${optional}`,
+    ].join(' ');
+  }
+
+  formatValidationSummary(input: StoryReflectionValidationSummaryInput): string {
+    const { config, preset, result } = input;
+    const lines: string[] = [];
+
+    if (!config.enabled) {
+      lines.push(
+        `[L2-STORY-REFLECTION] disabled (preset=${preset}, violations=0, warnings=0)`,
+      );
+      return lines.join('\n');
+    }
+
+    const status = result.isBlocked() ? 'failed' : 'passed';
+    const violations = result.violations.length;
+    const warnings = result.warnings.length;
+
+    lines.push(
+      `[L2-STORY-REFLECTION] ${status} (preset=${preset}, mappings=${config.mappings.length}, violations=${violations}, warnings=${warnings})`,
+    );
+
+    if (result.isBlocked()) {
+      for (const violation of result.violations) {
+        lines.push(
+          `  - ${violation.storyId}: ${violation.productPath} に @story-id ${violation.storyId} が未反映 (inception: ${violation.inceptionPath})`,
+        );
+      }
+    }
+
+    if (warnings > 0) {
+      for (const warning of result.warnings) {
+        lines.push(
+          `  ! ${warning.storyId}: ${warning.productPath} に @story-id ${warning.storyId} が未反映 (optional)`,
+        );
+      }
+    }
+
+    return lines.join('\n');
+  }
+}

package/scripts/harness/regression-suite/application/dto/analyze-migration-input.ts

@@ -1,3 +1,4 @@
+// @layer application
 export interface AnalyzeMigrationInput {
   dryRun?: boolean;
   outOfScopePattern?: string[];

package/scripts/harness/regression-suite/application/dto/analyze-migration-output.ts

@@ -1,3 +1,4 @@
+// @layer application
 export interface AnalyzeMigrationOutput {
   totalCount: number;
   migratedCount: number;

package/scripts/harness/regression-suite/application/dto/configure-ci-gate-input.ts

@@ -1,3 +1,4 @@
+// @layer application
 import type { SuiteIdValue } from '../../domain/value-objects/suite-id.js';
 import type { ExecutionMode } from '../../domain/value-objects/ci-gate-config.js';
 

package/scripts/harness/regression-suite/application/dto/configure-ci-gate-output.ts

@@ -1,3 +1,4 @@
+// @layer application
 import type { SuiteIdValue } from '../../domain/value-objects/suite-id.js';
 import type { ExecutionMode } from '../../domain/value-objects/ci-gate-config.js';
 

package/scripts/harness/regression-suite/application/dto/migrate-v0-tests-input.ts

@@ -1,3 +1,4 @@
+// @layer application
 export interface MigrateV0TestsInput {
   confirmExecute?: boolean;
   outOfScopePattern?: string[];

package/scripts/harness/regression-suite/application/dto/migrate-v0-tests-output.ts

@@ -1,3 +1,4 @@
+// @layer application
 export interface MigrationMappingOutput {
   v0TestId: string;
   v1TestPath: string;

package/scripts/harness/regression-suite/application/dto/run-regression-suite-input.ts

@@ -1,3 +1,4 @@
+// @layer application
 import type { SuiteIdValue } from '../../domain/value-objects/suite-id.js';
 
 export interface RunRegressionSuiteInput {

package/scripts/harness/regression-suite/application/dto/run-regression-suite-output.ts

@@ -1,3 +1,4 @@
+// @layer application
 export interface TestFailureDetailOutput {
   testCaseId: string;
   errorMessage: string;

package/scripts/harness/regression-suite/application/mappers/migration-mapping-mapper.ts

@@ -1,3 +1,4 @@
+// @layer application
 import type { V0TestMigration } from '../../domain/aggregates/v0-test-migration.js';
 import type { MigrationMappingOutput } from '../dto/migrate-v0-tests-output.js';
 

package/scripts/harness/regression-suite/application/mappers/test-execution-summary-mapper.ts

@@ -1,3 +1,4 @@
+// @layer application
 import type { TestExecutionSummary } from '../../domain/value-objects/test-execution-summary.js';
 import type { RunRegressionSuiteOutput } from '../dto/run-regression-suite-output.js';
 

package/scripts/harness/regression-suite/application/usecases/analyze-v0-migration-usecase.ts

@@ -1,3 +1,4 @@
+// @layer application
 import { MigrationAnalyzer } from '../../domain/services/migration-analyzer.js';
 import type { V0SpecReaderPort } from '../../domain/ports/v0-spec-reader-port.js';
 import type { MigrationMappingRepositoryPort } from '../../domain/ports/migration-mapping-repository-port.js';

package/scripts/harness/regression-suite/application/usecases/configure-ci-gate-usecase.ts

@@ -1,3 +1,4 @@
+// @layer application
 import { SuiteId } from '../../domain/value-objects/suite-id.js';
 import { CiGateConfig } from '../../domain/value-objects/ci-gate-config.js';
 import type { ConfigQueryPort } from '../../domain/ports/config-query-port.js';

package/scripts/harness/regression-suite/application/usecases/migrate-v0-tests-usecase.ts

@@ -1,3 +1,4 @@
+// @layer application
 import { MigrationAnalyzer } from '../../domain/services/migration-analyzer.js';
 import type { V0SpecReaderPort } from '../../domain/ports/v0-spec-reader-port.js';
 import type { MigrationMappingRepositoryPort } from '../../domain/ports/migration-mapping-repository-port.js';

package/scripts/harness/regression-suite/application/usecases/run-agent-independence-guard-usecase.ts

@@ -1,3 +1,4 @@
+// @layer application
 import { SuiteId } from '../../domain/value-objects/suite-id.js';
 import { TestExecutionSummary } from '../../domain/value-objects/test-execution-summary.js';
 import { TestFailureDetail } from '../../domain/value-objects/test-failure-detail.js';

package/scripts/harness/regression-suite/application/usecases/run-gng-gate-regression-usecase.ts

@@ -1,3 +1,4 @@
+// @layer application
 import { SuiteId } from '../../domain/value-objects/suite-id.js';
 import { TestExecutionSummary } from '../../domain/value-objects/test-execution-summary.js';
 import type { SuiteRegistryPort } from '../../domain/ports/suite-registry-port.js';

package/scripts/harness/regression-suite/application/usecases/run-k-requirements-regression-usecase.ts

@@ -1,3 +1,4 @@
+// @layer application
 import { SuiteId } from '../../domain/value-objects/suite-id.js';
 import { TestExecutionSummary } from '../../domain/value-objects/test-execution-summary.js';
 import type { SuiteRegistryPort } from '../../domain/ports/suite-registry-port.js';

package/scripts/harness/regression-suite/application/usecases/run-k14-k15-regression-usecase.ts

@@ -1,3 +1,4 @@
+// @layer application
 import { SuiteId } from '../../domain/value-objects/suite-id.js';
 import { TestExecutionSummary } from '../../domain/value-objects/test-execution-summary.js';
 import type { SuiteRegistryPort } from '../../domain/ports/suite-registry-port.js';

package/scripts/harness/regression-suite/composition-root.ts

@@ -1,4 +1,5 @@
 /**
+ * @layer infrastructure
  * @unit regression-suite
  *
  * Composition Root - wires all dependencies together

package/scripts/harness/regression-suite/domain/aggregates/v0-test-migration.ts

@@ -1,3 +1,4 @@
+// @layer domain
 import type { V0TestId } from '../value-objects/v0-test-id.js';
 import type { V1TestPath } from '../value-objects/v1-test-path.js';
 import type { BiomeModificationSpec } from '../value-objects/biome-modification-spec.js';

package/scripts/harness/regression-suite/domain/ports/ci-gate-result-writer-port.ts

@@ -1,3 +1,4 @@
+// @layer domain
 import type { SuiteIdValue } from '../value-objects/suite-id.js';
 import type { TestExecutionSummary } from '../value-objects/test-execution-summary.js';
 

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

@@ -1,3 +1,4 @@
+// @layer domain
 export interface ConfigQueryPort {
   getCoverageThreshold(): Promise<number>;
 }

package/scripts/harness/regression-suite/domain/ports/import-analyzer-port.ts

@@ -1,3 +1,4 @@
+// @layer domain
 export interface ImportAnalyzerPort {
   analyzeImports(targetModule: string): Promise<string[]>;
 }

package/scripts/harness/regression-suite/domain/ports/migration-mapping-repository-port.ts

@@ -1,3 +1,4 @@
+// @layer domain
 import type { V0TestMigration } from '../aggregates/v0-test-migration.js';
 import type { V0TestId } from '../value-objects/v0-test-id.js';
 import type { MigrationMapping } from '../value-objects/migration-mapping.js';

package/scripts/harness/regression-suite/domain/ports/suite-registry-port.ts

@@ -1,3 +1,4 @@
+// @layer domain
 import type { SuiteId } from '../value-objects/suite-id.js';
 import type { RegressionSuiteDefinition } from '../value-objects/regression-suite-definition.js';
 

package/scripts/harness/regression-suite/domain/ports/test-runner-port.ts

@@ -1,3 +1,4 @@
+// @layer domain
 import type { TestCase } from '../value-objects/regression-suite-definition.js';
 import type { CoverageRate } from '../value-objects/coverage-rate.js';
 import type { TestFailureDetail } from '../value-objects/test-failure-detail.js';

package/scripts/harness/regression-suite/domain/ports/v0-spec-reader-port.ts

@@ -1,3 +1,4 @@
+// @layer domain
 import type { V0TestId } from '../value-objects/v0-test-id.js';
 
 export interface V0SpecReaderPort {

package/scripts/harness/regression-suite/domain/services/import-guard-service.ts

@@ -1,3 +1,4 @@
+// @layer domain
 import type { AgentIndependenceTest } from '../value-objects/agent-independence-test.js';
 import { ImportViolation } from '../value-objects/import-violation.js';
 import type { ImportAnalyzerPort } from '../ports/import-analyzer-port.js';

package/scripts/harness/regression-suite/domain/services/migration-analyzer.ts

@@ -1,3 +1,4 @@
+// @layer domain
 import { V0TestMigration } from '../aggregates/v0-test-migration.js';
 import { V1TestPath } from '../value-objects/v1-test-path.js';
 import { BiomeModificationSpec } from '../value-objects/biome-modification-spec.js';