phasegate 0.91.0 → 0.107.0

package/scripts/harness/biome-ast-engine/application/usecases/execute-lint-usecase.ts

@@ -45,6 +45,7 @@ export class ExecuteLintUseCase {
     const resolvedRules = await this.resolveEnabledRulesUseCase.execute();
     const analyzed = await this.analyzeImportGraphUseCase.execute({
       targets: input.targets,
+      architecture: resolvedRules.architectureSpec,
     });
 
     if (input.includeBiomeNative !== false) {
@@ -58,6 +59,7 @@ export class ExecuteLintUseCase {
       snapshots: analyzed.snapshots,
       importGraph: analyzed.importGraph,
       durationMs,
+      architecture: resolvedRules.architectureSpec,
     });
     const report = LintReport.create({
       violations: baseReport.violations,

package/scripts/harness/biome-ast-engine/application/usecases/resolve-enabled-rules-usecase.ts

@@ -5,6 +5,7 @@
 
 import type { RuleConfigProviderPort } from '../../domain/ports/rule-config-provider-port.js';
 import type { RuleDefinitionRegistry } from '../../domain/services/rule-definition-registry.js';
+import { freezeArchitectureSpec } from '../../domain/value-objects/architecture-spec.js';
 import type { ResolveEnabledRulesInput } from '../dto/resolve-enabled-rules-input.js';
 import type { ResolveEnabledRulesOutput } from '../dto/resolve-enabled-rules-output.js';
 import { toResolveEnabledRulesOutput } from '../mappers/resolve-enabled-rules-output-mapper.js';
@@ -16,6 +17,13 @@ export interface ResolveEnabledRulesUseCaseDeps {
   readonly ruleDefinitionRegistry: RuleDefinitionResolver;
 }
 
+const FLAT_AUTO_DISABLED_RULES = Object.freeze([
+  'require-unit-comment',
+  'require-layer-comment',
+  'no-layer-violation',
+  'enforce-folder-structure',
+] as const);
+
 export class ResolveEnabledRulesUseCase {
   private readonly ruleConfigProviderPort: RuleConfigProviderPort;
   private readonly ruleDefinitionRegistry: RuleDefinitionResolver;
@@ -29,15 +37,35 @@ export class ResolveEnabledRulesUseCase {
     input: ResolveEnabledRulesInput = {}
   ): Promise<Readonly<ResolveEnabledRulesOutput>> {
     const config = await this.ruleConfigProviderPort.getL1Config();
-    const mergedRules = {
+    const architecture = await this.ruleConfigProviderPort.getArchitecture();
+    const overrideRules = input.overrideRules ?? {};
+    const mergedRules: Record<string, 'error' | 'warning' | 'off'> = {
       ...config.rules,
-      ...(input.overrideRules ?? {}),
+      ...overrideRules,
     };
+
+    if (architecture.preset === 'flat') {
+      for (const ruleName of FLAT_AUTO_DISABLED_RULES) {
+        if (!(ruleName in mergedRules)) {
+          mergedRules[ruleName] = 'off';
+        }
+      }
+    }
+
     const resolved = this.ruleDefinitionRegistry.resolveEnabled({
       l1Enabled: config.enabled,
       rules: mergedRules,
     });
 
-    return toResolveEnabledRulesOutput(resolved.enabledRules, resolved.skippedRules);
+    const architectureSpec = freezeArchitectureSpec({
+      layers: architecture.layers,
+      allowedDependencies: architecture.allowedDependencies,
+    });
+
+    return toResolveEnabledRulesOutput(
+      resolved.enabledRules,
+      resolved.skippedRules,
+      architectureSpec
+    );
   }
 }

package/scripts/harness/biome-ast-engine/composition-root.ts

@@ -2,7 +2,11 @@
 // @layer composition
 
 import { SystemClockAdapter } from './infrastructure/adapters/system-clock-adapter.js';
-import { HarnessConfigProviderAdapter, type L1ConfigInput } from './infrastructure/adapters/harness-config-provider-adapter.js';
+import {
+  HarnessConfigProviderAdapter,
+  type ArchitectureConfigInput,
+  type L1ConfigInput,
+} from './infrastructure/adapters/harness-config-provider-adapter.js';
 import { HarnessErrorFormatterAdapter } from './infrastructure/adapters/harness-error-formatter-adapter.js';
 import { NodeWorkspaceFileAdapter } from './infrastructure/adapters/node-workspace-file-adapter.js';
 import { TypeScriptSourceModuleAnalyzerAdapter } from './infrastructure/adapters/typescript-source-module-analyzer-adapter.js';
@@ -20,6 +24,7 @@ import { HarnessLintCommandHandler } from './presentation/cli/harness-lint-comma
 
 export interface BiomeAstEngineModuleOptions {
   readonly l1Config?: L1ConfigInput;
+  readonly architecture?: ArchitectureConfigInput;
 }
 
 export function createBiomeAstEngineModule(
@@ -27,7 +32,10 @@ export function createBiomeAstEngineModule(
   options?: BiomeAstEngineModuleOptions,
 ) {
   const clockPort = new SystemClockAdapter();
-  const ruleConfigProviderPort = new HarnessConfigProviderAdapter(options?.l1Config);
+  const ruleConfigProviderPort = new HarnessConfigProviderAdapter(
+    options?.l1Config,
+    options?.architecture,
+  );
   const violationFormatterPort = new HarnessErrorFormatterAdapter();
   const workspaceFilePort = new NodeWorkspaceFileAdapter({ rootDir });
   const sourceModuleAnalyzerPort = new TypeScriptSourceModuleAnalyzerAdapter({ rootDir });

package/scripts/harness/biome-ast-engine/domain/ports/rule-config-provider-port.ts

@@ -3,9 +3,25 @@
  * @unit biome-ast-engine
  */
 
+export type ArchitecturePresetIdValue =
+  | 'clean'
+  | 'strict-ddd'
+  | 'onion'
+  | 'hexagonal'
+  | 'layered'
+  | 'flat'
+  | 'custom';
+
+export interface ArchitectureProviderInfo {
+  readonly preset: ArchitecturePresetIdValue;
+  readonly layers: readonly string[];
+  readonly allowedDependencies: Readonly<Record<string, readonly string[]>>;
+}
+
 export interface RuleConfigProviderPort {
   getL1Config(): Promise<{
     enabled: boolean;
     rules: Record<string, 'error' | 'warning' | 'off'>;
   }>;
+  getArchitecture(): Promise<ArchitectureProviderInfo>;
 }

package/scripts/harness/biome-ast-engine/domain/ports/source-module-analyzer-port.ts

@@ -3,9 +3,13 @@
  * @unit biome-ast-engine
  */
 
+import type { ArchitectureSpec } from '../value-objects/architecture-spec.js';
 import { FilePath } from '../value-objects/file-path.js';
 import { SourceModuleSnapshot } from '../value-objects/source-module-snapshot.js';
 
 export interface SourceModuleAnalyzerPort {
-  analyzeMany(files: readonly FilePath[]): Promise<readonly SourceModuleSnapshot[]>;
+  analyzeMany(
+    files: readonly FilePath[],
+    architecture?: ArchitectureSpec
+  ): Promise<readonly SourceModuleSnapshot[]>;
 }

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

@@ -4,6 +4,7 @@
  */
 
 import { RuleDefinitionRegistry } from './rule-definition-registry.js';
+import { CLEAN_PRESET_SPEC, type ArchitectureSpec } from '../value-objects/architecture-spec.js';
 import { ImportGraph, matchesPattern } from '../value-objects/import-graph.js';
 import { LayerBoundary } from '../value-objects/layer-boundary.js';
 import { LintReport } from '../value-objects/lint-report.js';
@@ -16,6 +17,7 @@ type LintRunnerParams = {
   readonly snapshots: readonly SourceModuleSnapshot[];
   readonly importGraph: ImportGraph;
   readonly durationMs: number;
+  readonly architecture?: ArchitectureSpec;
 };
 
 const toNumber = (value: unknown, fallback: number): number =>
@@ -37,6 +39,8 @@ export class LintRunner {
   }
 
   run(params: LintRunnerParams): LintReport {
+    const architecture = params.architecture ?? CLEAN_PRESET_SPEC;
+
     for (const rule of params.rules) {
       this.ruleDefinitionRegistry.getByName(rule.name);
     }
@@ -100,7 +104,7 @@ export class LintRunner {
           const ignorePatterns = toStringArray(rule.config.ignorePatterns, Object.freeze([]));
 
           for (const edge of params.importGraph.findLayerViolations(
-            LayerBoundary.standardMatrix(),
+            LayerBoundary.standardMatrix(architecture),
             layerByFile,
             ignorePatterns
           )) {

package/scripts/harness/biome-ast-engine/domain/value-objects/architecture-spec.ts

@@ -0,0 +1,38 @@
+/**
+ * @layer domain
+ * @unit biome-ast-engine
+ */
+
+export type ArchitectureSpec = {
+  readonly layers: readonly string[];
+  readonly allowedDependencies: Readonly<Record<string, readonly string[]>>;
+};
+
+const freezeDependencyMap = (
+  map: Record<string, readonly string[]>
+): Readonly<Record<string, readonly string[]>> => {
+  const frozen: Record<string, readonly string[]> = {};
+
+  for (const [key, value] of Object.entries(map)) {
+    frozen[key] = Object.freeze([...value]);
+  }
+
+  return Object.freeze(frozen);
+};
+
+export const freezeArchitectureSpec = (spec: ArchitectureSpec): ArchitectureSpec => {
+  return Object.freeze({
+    layers: Object.freeze([...spec.layers]),
+    allowedDependencies: freezeDependencyMap({ ...spec.allowedDependencies }),
+  });
+};
+
+export const CLEAN_PRESET_SPEC: ArchitectureSpec = freezeArchitectureSpec({
+  layers: ['domain', 'application', 'infrastructure', 'presentation'],
+  allowedDependencies: {
+    domain: ['domain'],
+    application: ['application', 'domain'],
+    infrastructure: ['infrastructure', 'application', 'domain'],
+    presentation: ['presentation', 'application', 'domain'],
+  },
+});

package/scripts/harness/biome-ast-engine/domain/value-objects/layer-boundary.ts

@@ -3,6 +3,7 @@
  * @unit biome-ast-engine
  */
 
+import { CLEAN_PRESET_SPEC, type ArchitectureSpec } from './architecture-spec.js';
 import { LayerName } from './layer-name.js';
 
 type LayerBoundaryProps = {
@@ -11,8 +12,6 @@ type LayerBoundaryProps = {
   readonly allowed: boolean;
 };
 
-const LAYER_NAMES = Object.freeze(['domain', 'application', 'infrastructure', 'presentation'] as const);
-
 export class LayerBoundary {
   readonly sourceLayer: LayerName;
   readonly targetLayer: LayerName;
@@ -28,16 +27,16 @@ export class LayerBoundary {
     return Object.freeze(new LayerBoundary(props));
   }
 
-  static standardMatrix(): readonly LayerBoundary[] {
+  static standardMatrix(spec: ArchitectureSpec = CLEAN_PRESET_SPEC): readonly LayerBoundary[] {
     return Object.freeze(
-      LAYER_NAMES.flatMap((source) => {
-        const sourceLayer = LayerName.fromString(source);
+      spec.layers.flatMap((source) => {
+        const sourceLayer = LayerName.fromString(source, spec);
 
-        return LAYER_NAMES.map((target) =>
+        return spec.layers.map((target) =>
           LayerBoundary.create({
             sourceLayer,
-            targetLayer: LayerName.fromString(target),
-            allowed: sourceLayer.canDependOn(LayerName.fromString(target)),
+            targetLayer: LayerName.fromString(target, spec),
+            allowed: sourceLayer.canDependOn(LayerName.fromString(target, spec)),
           })
         );
       })

package/scripts/harness/biome-ast-engine/domain/value-objects/layer-name.ts

@@ -3,50 +3,40 @@
  * @unit biome-ast-engine
  */
 
-export type LayerNameValue = 'domain' | 'application' | 'infrastructure' | 'presentation';
+import { type ArchitectureSpec, CLEAN_PRESET_SPEC } from "./architecture-spec.js";
 
-const VALID_LAYER_NAMES = new Set<LayerNameValue>([
-  'domain',
-  'application',
-  'infrastructure',
-  'presentation',
-]);
-
-const ALLOWED_DEPENDENCIES: Readonly<Record<LayerNameValue, readonly LayerNameValue[]>> = {
-  domain: Object.freeze(['domain']),
-  application: Object.freeze(['application', 'domain']),
-  infrastructure: Object.freeze(['infrastructure', 'application', 'domain']),
-  presentation: Object.freeze(['presentation', 'application', 'domain']),
-};
+export type LayerNameValue = string;
 
 export class InvalidLayerNameError extends Error {
   constructor(value: string) {
     super(`Invalid LayerName: ${value}`);
-    this.name = 'InvalidLayerNameError';
+    this.name = "InvalidLayerNameError";
   }
 }
 
 export class LayerName {
   readonly value: LayerNameValue;
+  private readonly spec: ArchitectureSpec;
 
-  private constructor(value: LayerNameValue) {
+  private constructor(value: LayerNameValue, spec: ArchitectureSpec) {
     this.value = value;
+    this.spec = spec;
   }
 
-  static fromString(value: string): LayerName {
-    if (!VALID_LAYER_NAMES.has(value as LayerNameValue)) {
+  static fromString(value: string, spec: ArchitectureSpec = CLEAN_PRESET_SPEC): LayerName {
+    if (!spec.layers.includes(value)) {
       throw new InvalidLayerNameError(value);
     }
 
-    return Object.freeze(new LayerName(value as LayerNameValue));
+    return Object.freeze(new LayerName(value, spec)) as LayerName;
   }
 
-  static tryFromString(value: string): LayerName | null {
-    if (!VALID_LAYER_NAMES.has(value as LayerNameValue)) {
+  static tryFromString(value: string, spec: ArchitectureSpec = CLEAN_PRESET_SPEC): LayerName | null {
+    if (!spec.layers.includes(value)) {
       return null;
     }
 
-    return Object.freeze(new LayerName(value as LayerNameValue));
+    return Object.freeze(new LayerName(value, spec)) as LayerName;
   }
 
   equals(other: LayerName): boolean {
@@ -54,7 +44,9 @@ export class LayerName {
   }
 
   canDependOn(target: LayerName): boolean {
-    return ALLOWED_DEPENDENCIES[this.value].includes(target.value);
+    const allowed = this.spec.allowedDependencies[this.value] ?? [];
+
+    return allowed.includes(target.value);
   }
 
   toPathSegment(): string {

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

@@ -3,6 +3,7 @@
  * @unit biome-ast-engine
  */
 
+import { CLEAN_PRESET_SPEC, type ArchitectureSpec } from './architecture-spec.js';
 import { FilePath } from './file-path.js';
 import { ImportEdge } from './import-edge.js';
 import { LayerName } from './layer-name.js';
@@ -30,7 +31,10 @@ const ensureNonNegative = (value: number, label: string): number => {
   return value;
 };
 
-const normalizeDeclaredLayer = (value: LayerName | string | null): LayerName | null => {
+const normalizeDeclaredLayer = (
+  value: LayerName | string | null,
+  spec: ArchitectureSpec
+): LayerName | null => {
   if (value === null) {
     return null;
   }
@@ -40,7 +44,7 @@ const normalizeDeclaredLayer = (value: LayerName | string | null): LayerName | n
   }
 
   if (typeof value === 'string') {
-    return LayerName.tryFromString(value);
+    return LayerName.tryFromString(value, spec);
   }
 
   return null;
@@ -77,8 +81,11 @@ export class SourceModuleSnapshot {
     this.hasRawLayerAnnotation = props.hasRawLayerAnnotation;
   }
 
-  static create(props: SourceModuleSnapshotProps): SourceModuleSnapshot {
-    const declaredLayer = normalizeDeclaredLayer(props.declaredLayer);
+  static create(
+    props: SourceModuleSnapshotProps,
+    spec: ArchitectureSpec = CLEAN_PRESET_SPEC
+  ): SourceModuleSnapshot {
+    const declaredLayer = normalizeDeclaredLayer(props.declaredLayer, spec);
 
     return Object.freeze(
       new SourceModuleSnapshot({

package/scripts/harness/biome-ast-engine/infrastructure/adapters/harness-config-provider-adapter.ts

@@ -3,27 +3,49 @@
  * @unit biome-ast-engine
  */
 
-import type { RuleConfigProviderPort } from '../../domain/ports/rule-config-provider-port.js';
+import type {
+  ArchitectureProviderInfo,
+  RuleConfigProviderPort,
+} from '../../domain/ports/rule-config-provider-port.js';
 
 export interface L1ConfigInput {
   readonly enabled: boolean;
   readonly rules: Record<string, 'error' | 'warning' | 'off'>;
 }
 
+export type ArchitectureConfigInput = ArchitectureProviderInfo;
+
 const DEFAULT_L1_CONFIG: L1ConfigInput = {
   enabled: true,
   rules: {},
 };
 
+const DEFAULT_ARCHITECTURE: ArchitectureConfigInput = Object.freeze({
+  preset: 'clean',
+  layers: Object.freeze(['domain', 'application', 'infrastructure', 'presentation']),
+  allowedDependencies: Object.freeze({
+    domain: Object.freeze(['domain']),
+    application: Object.freeze(['application', 'domain']),
+    infrastructure: Object.freeze(['infrastructure', 'application', 'domain']),
+    presentation: Object.freeze(['presentation', 'application', 'domain']),
+  }),
+});
+
 /**
  * RuleConfigProviderPort の実装。
- * 外部から L1 設定を注入可能。未指定時はデフォルト（enabled: true, rules: {} — 全ルールデフォルト有効）。
+ * 外部から L1 設定と architecture 情報を注入可能。未指定時はデフォルト
+ * （L1: enabled=true, rules={}、architecture: clean preset）。
  */
 export class HarnessConfigProviderAdapter implements RuleConfigProviderPort {
   private readonly l1Config: L1ConfigInput;
+  private readonly architecture: ArchitectureConfigInput;
 
-  constructor(injectedL1Config?: L1ConfigInput) {
+  constructor(
+    injectedL1Config?: L1ConfigInput,
+    injectedArchitecture?: ArchitectureConfigInput,
+  ) {
     this.l1Config = injectedL1Config ?? DEFAULT_L1_CONFIG;
+    this.architecture = injectedArchitecture ?? DEFAULT_ARCHITECTURE;
   }
 
   async getL1Config(): Promise<{
@@ -35,4 +57,8 @@ export class HarnessConfigProviderAdapter implements RuleConfigProviderPort {
       rules: { ...this.l1Config.rules },
     };
   }
+
+  async getArchitecture(): Promise<ArchitectureProviderInfo> {
+    return this.architecture;
+  }
 }

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

@@ -7,6 +7,7 @@ import * as ts from 'typescript';
 import * as path from 'node:path';
 import type { FilePath } from '../../domain/value-objects/file-path.js';
 import type { SourceModuleAnalyzerPort } from '../../domain/ports/source-module-analyzer-port.js';
+import type { ArchitectureSpec } from '../../domain/value-objects/architecture-spec.js';
 import { SourceModuleSnapshot } from '../../domain/value-objects/source-module-snapshot.js';
 import { ImportEdge } from '../../domain/value-objects/import-edge.js';
 import { FilePath as FilePathVO } from '../../domain/value-objects/file-path.js';
@@ -30,7 +31,10 @@ export class TypeScriptSourceModuleAnalyzerAdapter implements SourceModuleAnalyz
     this.rootDir = deps.rootDir;
   }
 
-  async analyzeMany(files: readonly FilePath[]): Promise<readonly SourceModuleSnapshot[]> {
+  async analyzeMany(
+    files: readonly FilePath[],
+    architecture?: ArchitectureSpec
+  ): Promise<readonly SourceModuleSnapshot[]> {
     const absolutePaths = files.map((f) => path.resolve(this.rootDir, f.toString()));
 
     const program = ts.createProgram(absolutePaths, {
@@ -62,20 +66,23 @@ export class TypeScriptSourceModuleAnalyzerAdapter implements SourceModuleAnalyz
       const isEntrypoint = this.isEntrypointCandidate(filePath);
 
       snapshots.push(
-        SourceModuleSnapshot.create({
-          filePath,
-          declaredUnit: unitResult.unitNames[0],
-          declaredLayer: layerResult.layerName,
-          imports,
-          anyTypeCount: anyCount,
-          typedNodeCount: typedCount,
-          commentLineCount: densityResult.commentLineCount,
-          logicalLineCount: densityResult.logicalLineCount,
-          repeatedCommentBlocks: densityResult.repeatedCommentBlocks,
-          duplicationFingerprints: [],
-          exportedSymbols: exports,
-          isEntrypointCandidate: isEntrypoint,
-        })
+        SourceModuleSnapshot.create(
+          {
+            filePath,
+            declaredUnit: unitResult.unitNames[0],
+            declaredLayer: layerResult.layerName,
+            imports,
+            anyTypeCount: anyCount,
+            typedNodeCount: typedCount,
+            commentLineCount: densityResult.commentLineCount,
+            logicalLineCount: densityResult.logicalLineCount,
+            repeatedCommentBlocks: densityResult.repeatedCommentBlocks,
+            duplicationFingerprints: [],
+            exportedSymbols: exports,
+            isEntrypointCandidate: isEntrypoint,
+          },
+          architecture
+        )
       );
     }
 

package/scripts/harness/biome-ast-engine/infrastructure/mappers/source-module-snapshot-mapper.ts

@@ -3,6 +3,7 @@
  * @unit biome-ast-engine
  */
 
+import type { ArchitectureSpec } from '../../domain/value-objects/architecture-spec.js';
 import { FilePath } from '../../domain/value-objects/file-path.js';
 import { ImportEdge } from '../../domain/value-objects/import-edge.js';
 import { SourceModuleSnapshot } from '../../domain/value-objects/source-module-snapshot.js';
@@ -31,7 +32,10 @@ export type RawModuleData = {
 /**
  * AST解析結果の生データを SourceModuleSnapshot 値オブジェクトへ変換する。
  */
-export const toSourceModuleSnapshot = (raw: RawModuleData): SourceModuleSnapshot => {
+export const toSourceModuleSnapshot = (
+  raw: RawModuleData,
+  architecture?: ArchitectureSpec
+): SourceModuleSnapshot => {
   const filePath = FilePath.fromWorkspaceRelative(raw.filePath);
 
   const imports = raw.imports.map((edge) =>
@@ -42,25 +46,30 @@ export const toSourceModuleSnapshot = (raw: RawModuleData): SourceModuleSnapshot
     })
   );
 
-  return SourceModuleSnapshot.create({
-    filePath,
-    declaredUnit: raw.declaredUnit,
-    declaredLayer: raw.declaredLayer,
-    imports,
-    anyTypeCount: raw.anyTypeCount,
-    typedNodeCount: raw.typedNodeCount,
-    commentLineCount: raw.commentLineCount,
-    logicalLineCount: raw.logicalLineCount,
-    repeatedCommentBlocks: raw.repeatedCommentBlocks,
-    duplicationFingerprints: raw.duplicationFingerprints,
-    exportedSymbols: raw.exportedSymbols,
-    isEntrypointCandidate: raw.isEntrypointCandidate,
-  });
+  return SourceModuleSnapshot.create(
+    {
+      filePath,
+      declaredUnit: raw.declaredUnit,
+      declaredLayer: raw.declaredLayer,
+      imports,
+      anyTypeCount: raw.anyTypeCount,
+      typedNodeCount: raw.typedNodeCount,
+      commentLineCount: raw.commentLineCount,
+      logicalLineCount: raw.logicalLineCount,
+      repeatedCommentBlocks: raw.repeatedCommentBlocks,
+      duplicationFingerprints: raw.duplicationFingerprints,
+      exportedSymbols: raw.exportedSymbols,
+      isEntrypointCandidate: raw.isEntrypointCandidate,
+    },
+    architecture
+  );
 };
 
 /**
  * 複数の生データを一括変換する。
  */
 export const toSourceModuleSnapshots = (
-  rawList: readonly RawModuleData[]
-): readonly SourceModuleSnapshot[] => rawList.map(toSourceModuleSnapshot);
+  rawList: readonly RawModuleData[],
+  architecture?: ArchitectureSpec
+): readonly SourceModuleSnapshot[] =>
+  rawList.map((raw) => toSourceModuleSnapshot(raw, architecture));

package/scripts/harness/config-foundation/application/dto/resolved-config-output.ts

@@ -7,4 +7,5 @@ import type { HarnessConfigV2 } from '../../domain/harness-config.js';
 export interface ResolvedConfigOutput {
   readonly config: HarnessConfigV2;
   readonly sourcePath: string;
+  readonly schemaVersion: 'v2' | 'v3';
 }