phasegate 0.139.0 → 0.140.0

package/CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.140.0] - 2026-05-09
+
+### Added
+
+- **WI-024 — configurable L1 metadata tag names** — `architecture.metadataTags.unit` / `architecture.metadataTags.layer` を biome-ast-engine の L1 parser / analyzer / runner に反映し、`@module` / `@tier` などのプロジェクト語彙を単一の有効タグ名として使えるようにした。
+  - 既定値は従来通り `@unit` / `@layer`。
+  - カスタムタグ設定時は旧タグを alias として扱わず、欠落メッセージも設定タグ名を表示する。
+
 ## [0.139.0] - 2026-05-09
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phasegate",
-  "version": "0.139.0",
+  "version": "0.140.0",
   "packageManager": "pnpm@10.30.1",
   "description": "Phasegate — AI-agnostic quality defense toolkit. Enforces structural integrity between design intent and code.",
   "license": "MIT",

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

@@ -60,6 +60,7 @@ export class ResolveEnabledRulesUseCase {
     const architectureSpec = freezeArchitectureSpec({
       layers: architecture.layers,
       allowedDependencies: architecture.allowedDependencies,
+      metadataTags: architecture.metadataTags,
     });
 
     return toResolveEnabledRulesOutput(

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

@@ -16,6 +16,10 @@ export interface ArchitectureProviderInfo {
   readonly preset: ArchitecturePresetIdValue;
   readonly layers: readonly string[];
   readonly allowedDependencies: Readonly<Record<string, readonly string[]>>;
+  readonly metadataTags?: {
+    readonly unit?: string;
+    readonly layer?: string;
+  };
 }
 
 export interface RuleConfigProviderPort {

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

@@ -75,7 +75,7 @@ export class LintRunner {
                   line: 1,
                   column: 1,
                   ruleName: rule.name,
-                  message: '@unitコメントが必要です',
+                  message: `${architecture.metadataTags.unit}コメントが必要です`,
                   severity: rule.severity,
                 })
               );
@@ -92,7 +92,7 @@ export class LintRunner {
                   line: 1,
                   column: 1,
                   ruleName: rule.name,
-                  message: '@layerコメントが必要です',
+                  message: `${architecture.metadataTags.layer}コメントが必要です`,
                   severity: rule.severity,
                 })
               );

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

@@ -6,8 +6,25 @@
 export type ArchitectureSpec = {
   readonly layers: readonly string[];
   readonly allowedDependencies: Readonly<Record<string, readonly string[]>>;
+  readonly metadataTags: ArchitectureMetadataTags;
 };
 
+export type ArchitectureMetadataTags = {
+  readonly unit: string;
+  readonly layer: string;
+};
+
+export type ArchitectureSpecInput = {
+  readonly layers: readonly string[];
+  readonly allowedDependencies: Readonly<Record<string, readonly string[]>>;
+  readonly metadataTags?: Partial<ArchitectureMetadataTags>;
+};
+
+export const DEFAULT_METADATA_TAGS: ArchitectureMetadataTags = Object.freeze({
+  unit: '@unit',
+  layer: '@layer',
+});
+
 const freezeDependencyMap = (
   map: Record<string, readonly string[]>
 ): Readonly<Record<string, readonly string[]>> => {
@@ -20,10 +37,14 @@ const freezeDependencyMap = (
   return Object.freeze(frozen);
 };
 
-export const freezeArchitectureSpec = (spec: ArchitectureSpec): ArchitectureSpec => {
+export const freezeArchitectureSpec = (spec: ArchitectureSpecInput): ArchitectureSpec => {
   return Object.freeze({
     layers: Object.freeze([...spec.layers]),
     allowedDependencies: freezeDependencyMap({ ...spec.allowedDependencies }),
+    metadataTags: Object.freeze({
+      ...DEFAULT_METADATA_TAGS,
+      ...spec.metadataTags,
+    }),
   });
 };
 

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

@@ -29,6 +29,10 @@ const DEFAULT_ARCHITECTURE: ArchitectureConfigInput = Object.freeze({
     infrastructure: Object.freeze(['infrastructure', 'application', 'domain']),
     presentation: Object.freeze(['presentation', 'application', 'domain']),
   }),
+  metadataTags: Object.freeze({
+    unit: '@unit',
+    layer: '@layer',
+  }),
 });
 
 /**

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

@@ -56,8 +56,8 @@ export class TypeScriptSourceModuleAnalyzerAdapter implements SourceModuleAnalyz
       }
 
       const sourceText = sourceFile.getFullText();
-      const unitResult = parseUnitComment(sourceText);
-      const layerResult = parseLayerComment(sourceText);
+      const unitResult = parseUnitComment(sourceText, architecture?.metadataTags.unit);
+      const layerResult = parseLayerComment(sourceText, architecture?.metadataTags.layer);
       const densityResult = parseCommentDensity(sourceText);
       const imports = this.extractImports(sourceFile, filePath);
       const anyCount = this.countAnyTypes(sourceFile);
@@ -69,7 +69,7 @@ export class TypeScriptSourceModuleAnalyzerAdapter implements SourceModuleAnalyz
         SourceModuleSnapshot.create(
           {
             filePath,
-            declaredUnit: unitResult.unitNames[0],
+            declaredUnit: unitResult.unitNames[0] ?? null,
             declaredLayer: layerResult.layerName,
             imports,
             anyTypeCount: anyCount,

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

@@ -1,14 +1,22 @@
 // @unit biome-ast-engine
 // @layer infrastructure
 
-const LAYER_COMMENT_PATTERN = /^\s*(?:\/\/|\/\*\*?\s*|\*)\s*@layer\s+(\S+)/m;
+const DEFAULT_LAYER_TAG = '@layer';
+
+const escapeRegExp = (value: string): string => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+
+const createLayerCommentPattern = (tagName: string): RegExp =>
+  new RegExp(`^\\s*(?:\\/\\/|\\/\\*\\*?\\s*|\\*)\\s*${escapeRegExp(tagName)}\\s+(\\S+)`, 'm');
 
 export type LayerCommentResult = {
   readonly layerName: string | null;
 };
 
-export const parseLayerComment = (sourceCode: string): LayerCommentResult => {
-  const match = sourceCode.match(LAYER_COMMENT_PATTERN);
+export const parseLayerComment = (
+  sourceCode: string,
+  tagName: string = DEFAULT_LAYER_TAG
+): LayerCommentResult => {
+  const match = sourceCode.match(createLayerCommentPattern(tagName));
 
   if (!match) {
     return { layerName: null };

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

@@ -1,15 +1,23 @@
 // @unit biome-ast-engine
 // @layer infrastructure
 
-// カンマ区切り複数ユニット対応 + 複数行の @unit を収集、重複除去。
-const UNIT_COMMENT_PATTERN = /^\s*(?:\/\/|\/\*\*?\s*|\*)\s*@unit\s+(.+)/gm;
+// カンマ区切り複数ユニット対応 + 複数行の metadata unit tag を収集、重複除去。
+const DEFAULT_UNIT_TAG = '@unit';
+
+const escapeRegExp = (value: string): string => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+
+const createUnitCommentPattern = (tagName: string): RegExp =>
+  new RegExp(`^\\s*(?:\\/\\/|\\/\\*\\*?\\s*|\\*)\\s*${escapeRegExp(tagName)}\\s+(.+)`, 'gm');
 
 export type UnitCommentResult = {
   readonly unitNames: readonly string[];
 };
 
-export const parseUnitComment = (sourceCode: string): UnitCommentResult => {
-  const matches = sourceCode.matchAll(UNIT_COMMENT_PATTERN);
+export const parseUnitComment = (
+  sourceCode: string,
+  tagName: string = DEFAULT_UNIT_TAG
+): UnitCommentResult => {
+  const matches = sourceCode.matchAll(createUnitCommentPattern(tagName));
   const names: string[] = [];
 
   for (const match of matches) {

package/scripts/harness/main.ts

@@ -490,6 +490,7 @@ function toArchitectureInput(resolvedConfig: HarnessConfigV2) {
     preset: resolvedConfig.architecture.preset,
     layers: resolvedConfig.architecture.layers,
     allowedDependencies: resolvedConfig.architecture.allowedDependencies,
+    metadataTags: resolvedConfig.architecture.metadataTags,
   };
 }