phasegate 0.15.0

package/scripts/harness/validator-system/application/use-cases/run-quick-mode-usecase.ts

@@ -0,0 +1,91 @@
+/**
+ * @layer application
+ * @unit validator-system
+ *
+ * RunQuickModeUseCase — H08-04: Quickモード緩和実行
+ */
+import { ValidatorId } from '../../domain/value-objects/validator-id.js';
+import { ValidatorRegistry } from '../../domain/services/validator-registry.js';
+import { ValidatorExecutionService, ValidatorExecutionError } from '../../domain/services/validator-execution-service.js';
+import { ValidationResultContractMapper } from '../mappers/validation-result-contract-mapper.js';
+import type { ValidationResultContract } from '../dto/validation-result-contract.js';
+import type { RunQuickModeInput } from '../dto/run-quick-mode-input.js';
+import type { ValidatorConfigPort } from '../../domain/ports/validator-config-port.js';
+
+export class InvalidRelaxationProfileError extends Error {
+  constructor(message: string) {
+    super(`Invalid relaxation profile: ${message}`);
+    this.name = 'InvalidRelaxationProfileError';
+  }
+}
+
+export interface RunQuickModeUseCaseDeps {
+  validatorRegistry: ValidatorRegistry;
+  validatorExecutionService: ValidatorExecutionService;
+  validatorConfigPort: ValidatorConfigPort;
+  contractMapper: ValidationResultContractMapper;
+}
+
+export class RunQuickModeUseCase {
+  private readonly registry: ValidatorRegistry;
+  private readonly executionService: ValidatorExecutionService;
+  private readonly configPort: ValidatorConfigPort;
+  private readonly mapper: ValidationResultContractMapper;
+
+  constructor(deps: RunQuickModeUseCaseDeps) {
+    this.registry = deps.validatorRegistry;
+    this.executionService = deps.validatorExecutionService;
+    this.configPort = deps.validatorConfigPort;
+    this.mapper = deps.contractMapper;
+  }
+
+  async execute(input: RunQuickModeInput): Promise<readonly ValidationResultContract[]> {
+    const { relaxationProfile } = input;
+
+    // L4は常にスキップの不変条件チェック
+    if (relaxationProfile.l4.all !== false) {
+      throw new InvalidRelaxationProfileError('l4.all must be false in quick mode');
+    }
+
+    const l2Ids = relaxationProfile.l2.maintained.map((id) => ValidatorId.create(id));
+    const l3Ids = relaxationProfile.l3.maintained.map((id) => ValidatorId.create(id));
+    const allIds = [...l2Ids, ...l3Ids];
+
+    const definitions = this.registry.select(allIds);
+
+    // L2・L3 LayerConfig取得
+    let l2Config, l3Config;
+    try {
+      [l2Config, l3Config] = await Promise.all([
+        this.configPort.getLayerConfig('L2'),
+        this.configPort.getLayerConfig('L3'),
+      ]);
+    } catch (err) {
+      throw new ValidatorExecutionError(`Failed to get LayerConfig: ${err instanceof Error ? err.message : String(err)}`, err);
+    }
+
+    const results = this.executionService.execute(definitions, [l2Config, l3Config]);
+
+    // skipped バリデータの結果を追加
+    const skippedL2 = relaxationProfile.l2.skipped;
+    const skippedL3 = relaxationProfile.l3.skipped;
+    const skippedContracts: ValidationResultContract[] = [];
+
+    for (const id of [...skippedL2, ...skippedL3]) {
+      try {
+        const vid = ValidatorId.create(id);
+        skippedContracts.push({
+          validatorId: vid.value,
+          passed: true,
+          errors: [],
+          durationMs: 0,
+          skipped: true,
+        });
+      } catch {
+        // 無効IDはスキップ
+      }
+    }
+
+    return [...this.mapper.toContracts(results), ...skippedContracts];
+  }
+}

package/scripts/harness/validator-system/composition-root.ts

@@ -0,0 +1,234 @@
+/**
+ * @layer composition-root
+ * @unit validator-system
+ *
+ * DI 組み立て — validator-system の全依存関係を構築する
+ */
+import { ValidatorId } from './domain/value-objects/validator-id.js';
+import { ValidatorDefinition } from './domain/value-objects/validator-definition.js';
+import { ValidationRule } from './domain/value-objects/validation-rule.js';
+import { ValidatorRegistry } from './domain/services/validator-registry.js';
+import { ValidatorExecutionService } from './domain/services/validator-execution-service.js';
+import { ValidationResultContractMapper } from './application/mappers/validation-result-contract-mapper.js';
+import { RunL0ValidatorsUseCase } from './application/use-cases/run-l0-validators-usecase.js';
+import { RunL2ValidatorsUseCase } from './application/use-cases/run-l2-validators-usecase.js';
+import { RunL3ValidatorsUseCase } from './application/use-cases/run-l3-validators-usecase.js';
+import { RunL4ValidatorsUseCase } from './application/use-cases/run-l4-validators-usecase.js';
+import { RunL1ValidatorsUseCase } from './application/use-cases/run-l1-validators-usecase.js';
+import { RunQuickModeUseCase } from './application/use-cases/run-quick-mode-usecase.js';
+import { AggregateValidationResultsUseCase } from './application/use-cases/aggregate-validation-results-usecase.js';
+import { RunFullValidationUseCase } from './application/use-cases/run-full-validation-usecase.js';
+import { HarnessConfigValidatorConfigAdapter } from './infrastructure/adapters/harness-config-validator-config-adapter.js';
+import { ItTestFileAnalyzerAdapter } from './infrastructure/adapters/it-test-file-analyzer-adapter.js';
+import { SourceFileTextScannerAdapter } from './infrastructure/adapters/source-file-text-scanner-adapter.js';
+import { E2eTestFileRegistryAdapter } from './infrastructure/adapters/e2e-test-file-registry-adapter.js';
+import { CliCommandRegistryAdapter } from './infrastructure/adapters/cli-command-registry-adapter.js';
+import { PhaseDependencyPhaseGatePolicyAdapter } from './infrastructure/adapters/phase-dependency-phase-gate-policy-adapter.js';
+import { TraceabilityMetadataPolicyAdapter } from './infrastructure/adapters/traceability-metadata-policy-adapter.js';
+import { NyquistAcCoveragePolicyAdapter } from './infrastructure/adapters/nyquist-ac-coverage-policy-adapter.js';
+import { BiomeAstTestQualityAnalyzerAdapter } from './infrastructure/adapters/biome-ast-test-quality-analyzer-adapter.js';
+import { FileSystemSecurityPatternScannerAdapter } from './infrastructure/adapters/file-system-security-pattern-scanner-adapter.js';
+import { AstPerformanceScannerAdapter } from './infrastructure/adapters/ast-performance-scanner-adapter.js';
+import { MarkdownDesignDocumentAdapter } from './infrastructure/adapters/markdown-design-document-adapter.js';
+import { BiomeAstSourceCodeAnalyzerAdapter } from './infrastructure/adapters/biome-ast-source-code-analyzer-adapter.js';
+import { AdrFoundationReferenceAdapter } from './infrastructure/adapters/adr-foundation-reference-adapter.js';
+import { ImportGraphSourceAnalysisAdapter } from './infrastructure/adapters/import-graph-source-analysis-adapter.js';
+import { DriftDetectionService } from './domain/services/l4/drift-detection-service.js';
+import { ConsistencyCheckService } from './domain/services/l4/consistency-check-service.js';
+import { DeadCodeDetectionService } from './domain/services/l4/dead-code-detection-service.js';
+import { RunValidatorsHandler } from './presentation/handlers/run-validators-handler.js';
+import { RunQuickModeHandler } from './presentation/handlers/run-quick-mode-handler.js';
+import { ReportValidationResultsHandler } from './presentation/handlers/report-validation-results-handler.js';
+import { join } from 'node:path';
+
+/** デフォルト設定（ハードコード fallback） */
+const DEFAULT_CONFIG = {
+  preset: 'standard' as const,
+  layers: {
+    L0: { enabled: true, validators: ['L0-001', 'L0-002'] },
+    L2: { enabled: true, validators: ['L2-001', 'L2-002', 'L2-003'] },
+    L3: { enabled: true, validators: ['L3-001', 'L3-002', 'L3-003', 'L3-004'], coverageThreshold: 90, bundleSizeLimit: 512000 },
+    L4: { enabled: true, validators: ['L4-001', 'L4-002', 'L4-003'] },
+  },
+};
+
+/** バリデータ定義カタログ（全10件） */
+function buildDefaultRegistry(): ValidatorRegistry {
+  const defaultRule = ValidationRule.create({
+    ruleName: 'default-rule',
+    errorTemplate: { code: 'L2-001', severity: 'error', messageTemplate: '{{message}}' },
+    fixExample: null,
+  });
+
+  const createDef = (id: string, layer: 'L0' | 'L2' | 'L3' | 'L4', enabledCondition: 'always' | 'strictOnly' = 'always', externalPolicyRef: string | null = null) =>
+    ValidatorDefinition.create({
+      validatorId: ValidatorId.create(id),
+      layer,
+      rules: [ValidationRule.create({
+        ruleName: `${id}-rule`,
+        errorTemplate: { code: id, severity: 'error', messageTemplate: '{{message}}' },
+        fixExample: null,
+      })],
+      enabledCondition,
+      externalPolicyRef,
+    });
+
+  const definitions = [
+    createDef('L0-001', 'L0', 'always'),
+    createDef('L2-001', 'L2', 'always', 'PhaseGatePolicyPort'),
+    createDef('L2-002', 'L2', 'always', 'MetadataPolicyPort'),
+    createDef('L2-003', 'L2', 'always'),
+    createDef('L3-001', 'L3', 'always'),
+    createDef('L3-002', 'L3', 'strictOnly'),
+    createDef('L3-003', 'L3', 'always'),
+    createDef('L3-004', 'L3', 'always', 'AcCoveragePolicyPort'),
+    createDef('L4-001', 'L4', 'always'),
+    createDef('L4-002', 'L4', 'always'),
+    createDef('L4-003', 'L4', 'strictOnly'),
+  ];
+
+  return new ValidatorRegistry(definitions);
+}
+
+export interface ValidatorSystemModule {
+  registry: ValidatorRegistry;
+  runL0ValidatorsUseCase: RunL0ValidatorsUseCase;
+  runL1ValidatorsUseCase: RunL1ValidatorsUseCase;
+  runL2ValidatorsUseCase: RunL2ValidatorsUseCase;
+  runL3ValidatorsUseCase: RunL3ValidatorsUseCase;
+  runL4ValidatorsUseCase: RunL4ValidatorsUseCase;
+  runQuickModeUseCase: RunQuickModeUseCase;
+  aggregateValidationResultsUseCase: AggregateValidationResultsUseCase;
+  runFullValidationUseCase: RunFullValidationUseCase;
+  handlers: {
+    runValidators: RunValidatorsHandler;
+    runQuickMode: RunQuickModeHandler;
+    reportValidationResults: ReportValidationResultsHandler;
+  };
+}
+
+export function createValidatorSystemModule(config?: object): ValidatorSystemModule {
+  const configData = (config ?? DEFAULT_CONFIG) as typeof DEFAULT_CONFIG;
+  const configPort = new HarnessConfigValidatorConfigAdapter(configData);
+  const registry = buildDefaultRegistry();
+  const executionService = new ValidatorExecutionService({ configPort });
+  const contractMapper = new ValidationResultContractMapper();
+  const phaseGatePolicyPort = new PhaseDependencyPhaseGatePolicyAdapter();
+  const metadataPolicyPort = new TraceabilityMetadataPolicyAdapter();
+  const acCoveragePolicyPort = new NyquistAcCoveragePolicyAdapter();
+  const testQualityAnalyzerPort = new BiomeAstTestQualityAnalyzerAdapter();
+  const securityScannerPort = new FileSystemSecurityPatternScannerAdapter();
+  const performanceScannerPort = new AstPerformanceScannerAdapter();
+
+  const runL0ValidatorsUseCase = new RunL0ValidatorsUseCase({
+    validatorRegistry: registry,
+    validatorExecutionService: executionService,
+    validatorConfigPort: configPort,
+    contractMapper,
+  });
+
+  const runL2ValidatorsUseCase = new RunL2ValidatorsUseCase({
+    validatorRegistry: registry,
+    validatorExecutionService: executionService,
+    validatorConfigPort: configPort,
+    contractMapper,
+    phaseGatePolicyPort,
+    metadataPolicyPort,
+    testQualityAnalyzerPort,
+  });
+
+  const runL3ValidatorsUseCase = new RunL3ValidatorsUseCase({
+    validatorRegistry: registry,
+    validatorExecutionService: executionService,
+    validatorConfigPort: configPort,
+    contractMapper,
+    acCoveragePolicyPort,
+    securityScannerPort,
+    performanceScannerPort,
+  });
+
+  const docsRoot = join(process.cwd(), 'docs/product/construction');
+  const markdownDesignDocumentPort = new MarkdownDesignDocumentAdapter(docsRoot);
+  const sourceCodeAnalyzerAdapter = new BiomeAstSourceCodeAnalyzerAdapter();
+  const adrReferencePort = new AdrFoundationReferenceAdapter();
+  const sourceAnalysisPort = new ImportGraphSourceAnalysisAdapter();
+
+  const driftDetectionService = new DriftDetectionService({
+    designDocumentPort: markdownDesignDocumentPort,
+    sourceCodeAnalyzerPort: sourceCodeAnalyzerAdapter,
+  });
+  const consistencyCheckService = new ConsistencyCheckService({
+    designDocumentPort: markdownDesignDocumentPort,
+    adrReferencePort,
+  });
+  const deadCodeDetectionService = new DeadCodeDetectionService({
+    sourceAnalysisPort,
+  });
+
+  const runL4ValidatorsUseCase = new RunL4ValidatorsUseCase({
+    validatorRegistry: registry,
+    validatorExecutionService: executionService,
+    validatorConfigPort: configPort,
+    contractMapper,
+    driftDetectionService,
+    consistencyCheckService,
+    deadCodeDetectionService,
+  });
+
+  const runQuickModeUseCase = new RunQuickModeUseCase({
+    validatorRegistry: registry,
+    validatorExecutionService: executionService,
+    validatorConfigPort: configPort,
+    contractMapper,
+  });
+
+  const aggregateValidationResultsUseCase = new AggregateValidationResultsUseCase();
+  const KNOWN_CLI_COMMANDS = [
+    'validate', 'lint', 'ci-check', 'detect-drift',
+    'harness:check-ready', 'harness:check-phase', 'harness:ci-check',
+    'harness:detect-drift', 'harness:lint', 'harness:complete-check',
+    'harness:impact-analysis', 'harness:status',
+  ];
+  const cwd = process.cwd();
+  const itTestFileAnalyzerPort = new ItTestFileAnalyzerAdapter({
+    itTestRoot: join(cwd, 'scripts/harness/__tests__/integration'),
+    // アダプター自体のテストファイルは vi.mock() を使用しているため誤検知防止で除外
+    excludePattern: /it-test-file-analyzer-adapter\.test\.ts$/,
+  });
+  const sourceFileTextScannerPort = new SourceFileTextScannerAdapter({ sourceRoot: join(cwd, 'scripts/harness') });
+  const e2eTestFileRegistryPort = new E2eTestFileRegistryAdapter({ e2eTestRoot: join(cwd, 'scripts/harness/__tests__/e2e') });
+  const cliCommandRegistryPort = new CliCommandRegistryAdapter({ commands: KNOWN_CLI_COMMANDS });
+  const runL1ValidatorsUseCase = new RunL1ValidatorsUseCase({
+    itTestFileAnalyzerPort,
+    sourceFileTextScannerPort,
+    e2eTestFileRegistryPort,
+    cliCommandRegistryPort,
+    contractMapper,
+  });
+
+  const runFullValidationUseCase = new RunFullValidationUseCase({
+    runL2ValidatorsUseCase,
+    runL3ValidatorsUseCase,
+    runL4ValidatorsUseCase,
+    aggregateValidationResultsUseCase,
+  });
+
+  const handlers = {
+    runValidators: new RunValidatorsHandler({ runFullValidationUseCase, runL0ValidatorsUseCase, runL1ValidatorsUseCase }),
+    runQuickMode: new RunQuickModeHandler({ runQuickModeUseCase }),
+    reportValidationResults: new ReportValidationResultsHandler(),
+  };
+
+  return {
+    registry,
+    runL0ValidatorsUseCase,
+    runL1ValidatorsUseCase,
+    runL2ValidatorsUseCase,
+    runL3ValidatorsUseCase,
+    runL4ValidatorsUseCase,
+    runQuickModeUseCase,
+    aggregateValidationResultsUseCase,
+    runFullValidationUseCase,
+    handlers,
+  };
+}

package/scripts/harness/validator-system/domain/ports/ac-coverage-policy-port.ts

@@ -0,0 +1,14 @@
+/**
+ * @layer domain
+ * @unit validator-system
+ *
+ * AcCoveragePolicyPort — nyquist-validation AcCoverageGatePolicy（L3-004）
+ */
+import type { HarnessErrorLike } from '../value-objects/validation-result.js';
+
+export interface AcCoveragePolicyPort {
+  checkCoverage(context: { matrixFilePath?: string }): Promise<{
+    passed: boolean;
+    errors: readonly HarnessErrorLike[];
+  }>;
+}

package/scripts/harness/validator-system/domain/ports/adr-reference-port.ts

@@ -0,0 +1,17 @@
+/**
+ * @layer domain
+ * @unit validator-system
+ *
+ * AdrReferencePort — adr-foundation ADR実在性確認（L4-002）
+ */
+
+export interface AdrMetadata {
+  readonly adrId: string;
+  readonly title: string;
+  readonly status: 'Proposed' | 'Accepted' | 'Deprecated' | 'Superseded';
+}
+
+export interface AdrReferencePort {
+  exists(adrRef: string): Promise<boolean>;
+  getMetadata(adrRef: string): Promise<AdrMetadata | null>;
+}

package/scripts/harness/validator-system/domain/ports/cli-command-registry-port.ts

@@ -0,0 +1,15 @@
+/**
+ * @layer domain
+ * @unit validator-system
+ *
+ * CliCommandRegistryPort — 登録済みCLIコマンド一覧取得ポート
+ */
+
+export interface CliCommandRegistryPort {
+  /**
+   * 登録済みCLIコマンド名の一覧を返す。
+   */
+  getRegisteredCommands(): Promise<readonly string[]>;
+}
+
+// @story-id H08-07

package/scripts/harness/validator-system/domain/ports/coverage-report-port.ts

@@ -0,0 +1,13 @@
+/**
+ * @layer domain
+ * @unit validator-system
+ *
+ * CoverageReportPort — テストカバレッジレポート取得（L3-003）
+ */
+
+export interface CoverageReportPort {
+  getCoverage(): Promise<{
+    overallCoverage: number;
+    perFileCoverage: readonly { filePath: string; coverage: number }[];
+  }>;
+}

package/scripts/harness/validator-system/domain/ports/design-document-port.ts

@@ -0,0 +1,27 @@
+/**
+ * @layer domain
+ * @unit validator-system
+ *
+ * DesignDocumentPort — 設計文書構造化データ読み取り（L4-001, L4-002）
+ */
+
+export interface DesignDocumentConcept {
+  readonly name: string;
+  readonly type: 'class' | 'interface' | 'type' | 'value-object' | 'service';
+}
+
+export interface StructuredDesignDoc {
+  readonly unitName: string;
+  readonly docPath: string;
+  readonly concepts: readonly DesignDocumentConcept[];
+  readonly layerDependencies: readonly { from: string; to: string }[];
+  readonly adrRefs: readonly string[];
+}
+
+export interface DesignDocumentPort {
+  loadDesignDocuments(targetUnits?: readonly string[]): Promise<readonly StructuredDesignDoc[]>;
+  /** ConsistencyCheckService用: 文書のレイヤーアノテーション取得 */
+  getLayerAnnotations?(targetDocs?: readonly string[]): Promise<Record<string, string>>;
+  /** DriftDetectionService用: 要素名一覧取得 */
+  getElements?(targetUnits?: readonly string[]): Promise<string[]>;
+}

package/scripts/harness/validator-system/domain/ports/e2e-test-file-registry-port.ts

@@ -0,0 +1,15 @@
+/**
+ * @layer domain
+ * @unit validator-system
+ *
+ * E2eTestFileRegistryPort — E2Eテストファイル一覧取得ポート
+ */
+
+export interface E2eTestFileRegistryPort {
+  /**
+   * E2Eテストファイルのパス一覧を返す。
+   */
+  getE2eTestFiles(): Promise<readonly string[]>;
+}
+
+// @story-id H08-07

package/scripts/harness/validator-system/domain/ports/it-test-file-analyzer-port.ts

@@ -0,0 +1,21 @@
+/**
+ * @layer domain
+ * @unit validator-system
+ *
+ * ItTestFileAnalyzerPort — ITテストファイルのvi.mock解析ポート
+ */
+
+export interface ItTestMockCall {
+  readonly filePath: string;
+  readonly mockedModule: string;
+}
+
+export interface ItTestFileAnalyzerPort {
+  /**
+   * 指定ファイル群のITテストファイルをスキャンし、vi.mockで内部モジュールを
+   * モックしている箇所を返す。
+   */
+  findMockCallsInItTests(targetPaths?: readonly string[]): Promise<readonly ItTestMockCall[]>;
+}
+
+// @story-id H08-07

package/scripts/harness/validator-system/domain/ports/metadata-policy-port.ts

@@ -0,0 +1,17 @@
+/**
+ * @layer domain
+ * @unit validator-system
+ *
+ * MetadataPolicyPort — traceability-model メタデータ検証仕様
+ */
+import type { HarnessErrorLike } from '../value-objects/validation-result.js';
+
+export interface MetadataPolicyPort {
+  validateMetadata(context: {
+    filePath: string;
+    fileContent: string;
+  }): Promise<{
+    passed: boolean;
+    errors: readonly HarnessErrorLike[];
+  }>;
+}

package/scripts/harness/validator-system/domain/ports/performance-scanner-port.ts

@@ -0,0 +1,14 @@
+/**
+ * @layer domain
+ * @unit validator-system
+ *
+ * PerformanceScannerPort — パフォーマンス問題検出（L3-002）
+ */
+import type { HarnessErrorLike } from '../value-objects/validation-result.js';
+
+export interface PerformanceScannerPort {
+  scan(targetPaths: readonly string[], thresholds: Record<string, number>): Promise<{
+    passed: boolean;
+    findings: readonly HarnessErrorLike[];
+  }>;
+}

package/scripts/harness/validator-system/domain/ports/phase-gate-policy-port.ts

@@ -0,0 +1,14 @@
+/**
+ * @layer domain
+ * @unit validator-system
+ *
+ * PhaseGatePolicyPort — phase-dependency-model Phase Gate前提条件
+ */
+import type { HarnessErrorLike } from '../value-objects/validation-result.js';
+
+export interface PhaseGatePolicyPort {
+  checkPrerequisites(context: { unitName: string; currentPhase: string }): Promise<{
+    satisfied: boolean;
+    violations: readonly HarnessErrorLike[];
+  }>;
+}

package/scripts/harness/validator-system/domain/ports/security-pattern-scanner-port.ts

@@ -0,0 +1,14 @@
+/**
+ * @layer domain
+ * @unit validator-system
+ *
+ * SecurityPatternScannerPort — セキュリティパターン検出（L3-001）
+ */
+import type { HarnessErrorLike } from '../value-objects/validation-result.js';
+
+export interface SecurityPatternScannerPort {
+  scan(targetPaths: readonly string[]): Promise<{
+    passed: boolean;
+    findings: readonly HarnessErrorLike[];
+  }>;
+}

package/scripts/harness/validator-system/domain/ports/source-analysis-port.ts

@@ -0,0 +1,18 @@
+/**
+ * @layer domain
+ * @unit validator-system
+ *
+ * SourceAnalysisPort — biome-ast-engine ImportGraph相当データ（L4-003）
+ */
+
+export interface ImportGraphData {
+  readonly nodes: readonly { filePath: string; exports: readonly string[] }[];
+  readonly edges: readonly { from: string; to: string; importedNames: readonly string[] }[];
+  /** DeadCodeDetectionService用: 未使用エクスポート・到達不能コード */
+  readonly unusedExports?: readonly string[];
+  readonly unreachableCode?: readonly { filePath: string; range: { startLine: number; endLine: number } }[];
+}
+
+export interface SourceAnalysisPort {
+  getImportGraph(): Promise<ImportGraphData>;
+}

package/scripts/harness/validator-system/domain/ports/source-code-analyzer-port.ts

@@ -0,0 +1,19 @@
+/**
+ * @layer domain
+ * @unit validator-system
+ *
+ * SourceCodeAnalyzerPort — AST解析結果取得（L4-001, L4-003）
+ */
+
+export interface SourceAnalysisResult {
+  readonly unitName: string;
+  readonly filePath: string;
+  readonly exports: readonly { name: string; type: 'class' | 'interface' | 'type' | 'function' | 'const' }[];
+  readonly imports: readonly { source: string; name: string }[];
+}
+
+export interface SourceCodeAnalyzerPort {
+  analyzeExports(targetUnits?: readonly string[]): Promise<readonly SourceAnalysisResult[]>;
+  /** DriftDetectionService用: 要素名一覧取得 */
+  getElements?(targetUnits?: readonly string[]): Promise<string[]>;
+}

package/scripts/harness/validator-system/domain/ports/source-file-text-scanner-port.ts

@@ -0,0 +1,21 @@
+/**
+ * @layer domain
+ * @unit validator-system
+ *
+ * SourceFileTextScannerPort — ソースファイルテキストスキャンポート
+ */
+
+export interface TextScanMatch {
+  readonly filePath: string;
+  readonly lineNumber: number;
+  readonly lineContent: string;
+}
+
+export interface SourceFileTextScannerPort {
+  /**
+   * 指定ファイル群のソースファイルをスキャンし、パターンに一致する行を返す。
+   */
+  scanForPattern(pattern: RegExp, targetPaths?: readonly string[]): Promise<readonly TextScanMatch[]>;
+}
+
+// @story-id H08-07

package/scripts/harness/validator-system/domain/ports/test-quality-analyzer-port.ts

@@ -0,0 +1,17 @@
+/**
+ * @layer domain
+ * @unit validator-system
+ *
+ * TestQualityAnalyzerPort — AAAパターン・命名規約解析（L2-003）
+ */
+import type { HarnessErrorLike } from '../value-objects/validation-result.js';
+
+export interface TestQualityAnalyzerPort {
+  analyzeTestFiles(targetPaths: readonly string[]): Promise<{
+    results: readonly {
+      filePath: string;
+      passed: boolean;
+      violations: readonly HarnessErrorLike[];
+    }[];
+  }>;
+}

package/scripts/harness/validator-system/domain/ports/validator-config-port.ts

@@ -0,0 +1,11 @@
+/**
+ * @layer domain
+ * @unit validator-system
+ *
+ * ValidatorConfigPort — HarnessConfigV2からLayerConfig取得
+ */
+import type { LayerConfig } from '../value-objects/layer-config.js';
+
+export interface ValidatorConfigPort {
+  getLayerConfig(layer: 'L0' | 'L2' | 'L3' | 'L4'): Promise<LayerConfig>;
+}

package/scripts/harness/validator-system/domain/services/cli-e2e-test-existence-service.ts

@@ -0,0 +1,27 @@
+/**
+ * @layer domain
+ * @unit validator-system
+ *
+ * CliE2eTestExistenceService — H08-09: CLIコマンドE2Eテスト存在チェックドメインサービス
+ * CLIハンドラー定義とE2Eテストファイルの突合検証を行う。
+ */
+import { CliE2eTestCoverageReport, type CliCommandCoverageEntry } from '../value-objects/cli-e2e-test-coverage-report.js';
+
+export class CliE2eTestExistenceService {
+  /**
+   * 登録済みCLIコマンドとE2Eテストファイル一覧を突合し、カバレッジレポートを生成する。
+   * E2Eテストファイルのパスまたは内容にコマンド名が含まれていればカバー済みとみなす。
+   */
+  check(commands: readonly string[], e2eTestFiles: readonly string[]): CliE2eTestCoverageReport {
+    const e2eContent = e2eTestFiles.join('\n').toLowerCase();
+
+    const entries: CliCommandCoverageEntry[] = commands.map((commandName) => ({
+      commandName,
+      hasE2eTest: e2eContent.includes(commandName.toLowerCase()),
+    }));
+
+    return CliE2eTestCoverageReport.create(entries);
+  }
+}
+
+// @story-id H08-07