phasegate 0.74.0 → 0.83.0

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

@@ -68,7 +68,18 @@ export class RuleDefinitionRegistry {
         'enforce-folder-structure',
         'L1-004',
         Object.freeze([REQUIRED_INPUT.sourceModuleSnapshots]),
-        Object.freeze({ rootDir: 'scripts/harness', allowTestFixtures: true }),
+        Object.freeze({
+          rootDir: 'scripts/harness',
+          allowTestFixtures: true,
+          ignorePatterns: Object.freeze([
+            '**/composition-root.ts',
+            '**/index.ts',
+            '**/main.ts',
+            '**/shared-kernel/**',
+            '**/integrations/**',
+            '**/setup/**',
+          ]),
+        }),
         'フォルダ構造がレイヤーと一致していることを検証する',
         '宣言レイヤーと配置ディレクトリを一致させる'
       ),
@@ -101,7 +112,14 @@ export class RuleDefinitionRegistry {
         'L1-007',
         Object.freeze([REQUIRED_INPUT.importGraph]),
         Object.freeze({
-          entryPointPatterns: Object.freeze(['**/index.ts', '**/cli/**/*.ts']),
+          entryPointPatterns: Object.freeze([
+            '**/index.ts',
+            '**/cli/**/*.ts',
+            '**/*.config*.ts',
+            '**/main.ts',
+            '**/composition-root.ts',
+            '**/presentation/*-hook.ts',
+          ]),
           ignorePatterns: Object.freeze(['**/*.test.ts', '**/*.spec.ts']),
         }),
         '未参照ファイルを検出する',
@@ -111,7 +129,14 @@ export class RuleDefinitionRegistry {
         'no-layer-violation',
         'L1-003',
         Object.freeze([REQUIRED_INPUT.sourceModuleSnapshots, REQUIRED_INPUT.importGraph]),
-        Object.freeze({ ignorePatterns: Object.freeze(['**/shared-kernel/**']) }),
+        Object.freeze({
+          ignorePatterns: Object.freeze([
+            '**/shared-kernel/**',
+            '**/composition-root.ts',
+            '**/main.ts',
+            '**/presentation/*-hook.ts',
+          ]),
+        }),
         'レイヤー違反を検出する',
         '依存方向をアーキテクチャ方針に合わせる'
       ),

package/scripts/harness/biome-ast-engine/domain/value-objects/import-graph.ts

@@ -62,7 +62,7 @@ const globToRegex = (pattern: string): RegExp => {
   return new RegExp(`^${output}$`);
 };
 
-const matchesPattern = (value: string, pattern: string): boolean => {
+export const matchesPattern = (value: string, pattern: string): boolean => {
   return globToRegex(pattern).test(value) || value.includes(pattern.replace(/\*/g, '').replace(/\//g, ''));
 };
 
@@ -169,11 +169,18 @@ export class ImportGraph {
 
   findLayerViolations(
     boundaries: readonly LayerBoundary[],
-    layerByFile: ReadonlyMap<string, LayerName>
+    layerByFile: ReadonlyMap<string, LayerName>,
+    ignorePatterns: readonly string[] = []
   ): readonly ImportEdge[] {
     return Object.freeze(
       this.edges.filter((edge) => {
-        const sourceLayer = layerByFile.get(edge.from.toString());
+        const fromStr = edge.from.toString();
+
+        if (ignorePatterns.some((pattern) => matchesPattern(fromStr, pattern))) {
+          return false;
+        }
+
+        const sourceLayer = layerByFile.get(fromStr);
         const targetLayer = layerByFile.get(edge.to.toString());
 
         if (sourceLayer === undefined || targetLayer === undefined) {
@@ -189,12 +196,21 @@ export class ImportGraph {
     );
   }
 
-  findGhostFiles(ignorePatterns: readonly string[]): readonly FilePath[] {
+  findGhostFiles(
+    ignorePatterns: readonly string[],
+    entryPointPatterns: readonly string[] = []
+  ): readonly FilePath[] {
     const rootNodeSet = new Set(this.rootNodes.map((node) => node.toString()));
 
     return Object.freeze(
       this.nodes.filter((node) => {
-        if (rootNodeSet.has(node.toString())) {
+        const nodeStr = node.toString();
+
+        if (rootNodeSet.has(nodeStr)) {
+          return false;
+        }
+
+        if (entryPointPatterns.some((pattern) => matchesPattern(nodeStr, pattern))) {
           return false;
         }
 
@@ -202,7 +218,7 @@ export class ImportGraph {
           return false;
         }
 
-        return !ignorePatterns.some((pattern) => matchesPattern(node.toString(), pattern));
+        return !ignorePatterns.some((pattern) => matchesPattern(nodeStr, pattern));
       })
     );
   }

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

@@ -84,37 +84,47 @@ export class TypeScriptSourceModuleAnalyzerAdapter implements SourceModuleAnalyz
 
   private extractImports(sourceFile: ts.SourceFile, fromFile: FilePath): ImportEdge[] {
     const edges: ImportEdge[] = [];
+    const fromDir = path.dirname(path.resolve(this.rootDir, fromFile.toString()));
 
-    ts.forEachChild(sourceFile, (node) => {
-      if (ts.isImportDeclaration(node) && ts.isStringLiteral(node.moduleSpecifier)) {
-        const specifier = node.moduleSpecifier.text;
+    const pushEdge = (specifier: string, importKind: 'value' | 'type' | 'dynamic'): void => {
+      if (!specifier.startsWith('.')) {
+        return;
+      }
 
-        if (!specifier.startsWith('.')) {
-          return;
-        }
+      const resolved = path.resolve(fromDir, specifier.replace(/\.js$/, '.ts'));
+      const relative = path.relative(this.rootDir, resolved);
 
-        const fromDir = path.dirname(path.resolve(this.rootDir, fromFile.toString()));
-        const resolved = path.resolve(fromDir, specifier.replace(/\.js$/, '.ts'));
-        const relative = path.relative(this.rootDir, resolved);
+      if (relative.startsWith('..')) {
+        return;
+      }
 
-        if (relative.startsWith('..')) {
-          return;
-        }
+      try {
+        edges.push(
+          ImportEdge.create({
+            from: fromFile,
+            to: FilePathVO.fromWorkspaceRelative(relative),
+            importKind,
+          })
+        );
+      } catch {
+        // invalid path — skip
+      }
+    };
 
+    const visit = (node: ts.Node): void => {
+      if (ts.isImportDeclaration(node) && ts.isStringLiteral(node.moduleSpecifier)) {
         const importKind =
           node.importClause?.isTypeOnly === true ? 'type' as const : 'value' as const;
+        pushEdge(node.moduleSpecifier.text, importKind);
+      }
 
-        try {
-          edges.push(
-            ImportEdge.create({
-              from: fromFile,
-              to: FilePathVO.fromWorkspaceRelative(relative),
-              importKind,
-            })
-          );
-        } catch {
-          // invalid path — skip
-        }
+      if (
+        ts.isExportDeclaration(node) &&
+        node.moduleSpecifier !== undefined &&
+        ts.isStringLiteral(node.moduleSpecifier)
+      ) {
+        const importKind = node.isTypeOnly === true ? 'type' as const : 'value' as const;
+        pushEdge(node.moduleSpecifier.text, importKind);
       }
 
       if (
@@ -123,33 +133,13 @@ export class TypeScriptSourceModuleAnalyzerAdapter implements SourceModuleAnalyz
         node.arguments.length > 0 &&
         ts.isStringLiteral(node.arguments[0])
       ) {
-        const specifier = node.arguments[0].text;
-
-        if (!specifier.startsWith('.')) {
-          return;
-        }
-
-        const fromDir = path.dirname(path.resolve(this.rootDir, fromFile.toString()));
-        const resolved = path.resolve(fromDir, specifier.replace(/\.js$/, '.ts'));
-        const relative = path.relative(this.rootDir, resolved);
+        pushEdge(node.arguments[0].text, 'dynamic');
+      }
 
-        if (relative.startsWith('..')) {
-          return;
-        }
+      ts.forEachChild(node, visit);
+    };
 
-        try {
-          edges.push(
-            ImportEdge.create({
-              from: fromFile,
-              to: FilePathVO.fromWorkspaceRelative(relative),
-              importKind: 'dynamic',
-            })
-          );
-        } catch {
-          // invalid path — skip
-        }
-      }
-    });
+    ts.forEachChild(sourceFile, visit);
 
     return edges;
   }

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

@@ -1,7 +1,5 @@
-/**
- * @layer infrastructure
- * @unit biome-ast-engine
- */
+// @unit biome-ast-engine
+// @layer infrastructure
 
 const LAYER_COMMENT_PATTERN = /^\s*(?:\/\/|\/\*\*?\s*|\*)\s*@layer\s+(\S+)/m;
 
@@ -9,10 +7,6 @@ export type LayerCommentResult = {
   readonly layerName: string | null;
 };
 
-/**
- * ソースコードから `// @layer {layer}` コメントを抽出する。
- * JSDoc (`/** @layer ... * /`) 形式にも対応する。
- */
 export const parseLayerComment = (sourceCode: string): LayerCommentResult => {
   const match = sourceCode.match(LAYER_COMMENT_PATTERN);
 

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

@@ -1,20 +1,13 @@
-/**
- * @layer infrastructure
- * @unit biome-ast-engine
- */
+// @unit biome-ast-engine
+// @layer infrastructure
 
+// カンマ区切り複数ユニット対応 + 複数行の @unit を収集、重複除去。
 const UNIT_COMMENT_PATTERN = /^\s*(?:\/\/|\/\*\*?\s*|\*)\s*@unit\s+(.+)/gm;
 
 export type UnitCommentResult = {
   readonly unitNames: readonly string[];
 };
 
-/**
- * ソースコードから `// @unit {unit}` コメントを抽出する。
- * JSDoc (`/** @unit ... * /`) 形式にも対応する。
- * カンマ区切りで複数ユニットを指定でき、複数行の @unit も収集する。
- * 結果は重複除去済み。
- */
 export const parseUnitComment = (sourceCode: string): UnitCommentResult => {
   const matches = sourceCode.matchAll(UNIT_COMMENT_PATTERN);
   const names: string[] = [];

package/scripts/harness/ci-governance/application/usecases/generate-ci-template-usecase.ts

@@ -9,7 +9,7 @@ import type { TemplateGenerator } from '../../domain/services/template-generator
 import type { GenerateCiTemplateInput } from '../dto/generate-ci-template-input.js';
 import type { GenerateCiTemplateOutput } from '../dto/generate-ci-template-output.js';
 import { CiTemplate } from '../../domain/aggregates/ci-template.js';
-import { isTemplateType, TEMPLATE_TYPES } from '../../domain/types/template-type.js';
+import { isTemplateType, TEMPLATE_TYPES, type TemplateType } from '../../domain/types/template-type.js';
 
 export class GenerateCiTemplateUseCase {
   constructor(private readonly templateGenerator: TemplateGenerator) {}
@@ -23,7 +23,7 @@ export class GenerateCiTemplateUseCase {
         ? ` (Hint: --type specifies the template purpose, not the CI platform. Use one of: ${validValues})`
         : ` (valid: ${validValues})`;
       return {
-        templateType: templateType as any,
+        templateType: templateType as TemplateType,
         presetRef: presetId,
         triggerCondition: 'pull_request',
         targetValidatorIds: [],

package/scripts/harness/ci-governance/domain/types/lesson-artifact.ts

@@ -1,11 +1,6 @@
-/**
- * @layer domain
- * @unit ci-governance
- *
- * LessonArtifact型定義（Cross-Unit Contract所有）
- * Schema Owner: ci-governance Unit
- * Cross-Unit Contract: docs/contracts/lesson-artifact.schema.json
- */
+// @unit ci-governance
+// @layer domain
+// Cross-Unit Contract: docs/contracts/lesson-artifact.schema.json
 
 import type { LessonCategory } from './lesson-category.js';
 
@@ -14,12 +9,9 @@ export type { LessonCategory };
 export interface LessonArtifact {
   /** UUID形式の一意識別子（INV-12: UUID形式必須） */
   readonly lessonId: string;
-  /** lesson artifactの出力元スキル名（例: 'story-implementor', 'domain-designer'） */
   readonly source: string;
-  /** AGENTS.mdに集約するlesson内容テキスト */
   readonly content: string;
-  /** lessonのカテゴリタグ（重複集約時はマージされる） */
   readonly tags: LessonCategory[];
-  /** artifact作成日時（ISO 8601形式） */
-  readonly timestamp: string; // ISO8601DateString
+  /** ISO 8601形式 */
+  readonly timestamp: string;
 }

package/scripts/harness/ci-governance/domain/types/template-type.ts

@@ -1,9 +1,5 @@
-/**
- * @layer domain
- * @unit ci-governance
- *
- * TemplateType補助型
- */
+// @unit ci-governance
+// @layer domain
 
 export type TemplateType = 'aidlc-gate' | 'consistency-check' | 'pre-commit';
 

package/scripts/harness/ci-governance/domain/types/trigger-condition.ts

@@ -1,9 +1,5 @@
-/**
- * @layer domain
- * @unit ci-governance
- *
- * TriggerCondition補助型
- */
+// @unit ci-governance
+// @layer domain
 
 export type TriggerCondition = 'pull_request' | 'schedule' | 'pre-commit';
 

package/scripts/harness/ci-governance/infrastructure/adapters/harness-api-command-existence-adapter.ts

@@ -1,9 +1,5 @@
-/**
- * @layer infrastructure
- * @unit ci-governance
- *
- * CommandExistencePort実装
- */
+// @unit ci-governance
+// @layer infrastructure
 
 import type { CommandExistencePort } from '../../domain/ports/command-existence-port.js';
 

package/scripts/harness/ci-governance/infrastructure/adapters/validator-id-registry-adapter.ts

@@ -1,9 +1,5 @@
-/**
- * @layer infrastructure
- * @unit ci-governance
- *
- * ValidatorIdRegistryPort実装
- */
+// @unit ci-governance
+// @layer infrastructure
 
 import type { ValidatorIdRegistryPort } from '../../domain/ports/validator-id-registry-port.js';
 

package/scripts/harness/ci-governance/infrastructure/schema/error-history-schema.ts

@@ -1,9 +1,5 @@
-/**
- * @layer infrastructure
- * @unit ci-governance
- *
- * .harness/error-history.json スキーマ定義
- */
+// @unit ci-governance
+// @layer infrastructure
 
 export interface ErrorHistoryEntry {
   readonly code: string;

package/scripts/harness/ci-governance/presentation/handlers/migrate-agents-md-handler.ts

@@ -36,7 +36,7 @@ export class MigrateAgentsMdHandler {
       }
       const lines = vResult.passed
         ? ['✓ All pointers are valid']
-        : ['❌ Dead pointers detected', ...vResult.errors.map((e: any) => `  [${e.code}] ${e.message}`)];
+        : ['❌ Dead pointers detected', ...vResult.errors.map((e) => `  [${e.code}] ${e.message}`)];
       return { exitCode: vResult.passed ? 0 : 1, output: lines.join('\n'), errors: vResult.errors };
     }
 

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

@@ -1,9 +1,6 @@
-/**
- * @layer domain
- * @unit config-foundation
- *
- * config-foundation ドメイン層の基底エラークラス
- */
+// @unit config-foundation
+// @layer domain
+
 export class ConfigFoundationDomainError extends Error {
   readonly errorCode: string;
 

package/scripts/harness/config-foundation/domain/errors/invalid-preset-error.ts

@@ -1,9 +1,6 @@
-/**
- * @layer domain
- * @unit config-foundation
- *
- * project.preset が許可列挙値に一致しない場合のエラー
- */
+// @unit config-foundation
+// @layer domain
+
 import { ConfigFoundationDomainError } from './config-foundation-domain-error.js';
 
 export class InvalidPresetError extends ConfigFoundationDomainError {

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

@@ -8,6 +8,7 @@ import { UnsupportedFeatureError } from './errors/unsupported-feature-error.js';
 import { LayersConfig } from './value-objects/layers-config.js';
 import { PathsConfig } from './value-objects/paths-config.js';
 import { PhaseDependenciesConfig } from './value-objects/phase-dependencies-config.js';
+import type { PhaseDependenciesPresetId } from './value-objects/phase-dependencies-config.js';
 import { PlanningModeConfig } from './value-objects/planning-mode-config.js';
 import { ProjectConfig } from './value-objects/project-config.js';
 import { QuickModeConfig } from './value-objects/quick-mode-config.js';
@@ -23,7 +24,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';
+export type { PhaseDependenciesPresetId };
 type DeepPartial<T> = {
   [K in keyof T]?: T[K] extends Array<infer TItem>
     ? Array<DeepPartial<TItem>>

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

@@ -7,7 +7,8 @@
  */
 import { CustomPhaseRule } from './custom-phase-rule.js';
 import type { CustomPhaseRuleProps } from './custom-phase-rule.js';
-import type { PhaseDependenciesPresetId } from '../harness-config.js';
+
+export type PhaseDependenciesPresetId = 'default' | 'full' | 'standard' | 'minimal' | 'custom';
 
 export interface PhaseDependenciesConfigProps {
   readonly preset: PhaseDependenciesPresetId;

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

@@ -1,26 +1,17 @@
-/**
- * @layer public-api
- * @unit config-foundation
- *
- * config-foundation ユニットのバレルエクスポート。
- */
+// @unit config-foundation
+// @layer public-api
 
-// Composition Root
 export { createConfigFoundationModule } from './composition-root.js';
 
-// Application — usecases
 export { LoadResolvedConfigUseCase } from './application/usecases/load-resolved-config-use-case.js';
 
-// Application — DTOs
 export type { ResolvedConfigOutput } from './application/dto/resolved-config-output.js';
 export type { FeatureToggleResult } from './application/dto/feature-toggle-result.js';
 export type { AvailableFeatureItem } from './application/dto/available-feature-item.js';
 
-// Presentation — CLI handlers
 export { EnableFeatureCommandHandler } from './presentation/cli/enable-feature-command-handler.js';
 export { DisableFeatureCommandHandler } from './presentation/cli/disable-feature-command-handler.js';
 
-// Domain — ports
 export type { ConfigRepositoryPort } from './domain/ports/config-repository-port.js';
 export type { ConfigSchemaValidatorPort } from './domain/ports/config-schema-validator-port.js';
 export type { FeatureRegistryPort } from './domain/ports/feature-registry-port.js';

package/scripts/harness/harness-error/application/dto/error-definition-summary.ts

@@ -1,9 +1,6 @@
-/**
- * @layer application
- * @unit harness-error
- *
- * ErrorDefinition の一覧投影DTO
- */
+// @unit harness-error
+// @layer application
+
 export interface ErrorDefinitionSummary {
   readonly code: string;
   readonly title: string;

package/scripts/harness/harness-error/application/dto/harness-error-contract.ts

@@ -1,9 +1,6 @@
-/**
- * @layer application
- * @unit harness-error
- *
- * HarnessError の公開契約DTO
- */
+// @unit harness-error
+// @layer application
+
 export interface HarnessErrorContract {
   readonly code: string;
   readonly severity: 'error' | 'warning';

package/scripts/harness/harness-error/application/dto/validator-issue-draft.ts

@@ -1,9 +1,6 @@
-/**
- * @layer application
- * @unit harness-error
- *
- * validator出力の正規化前DTO
- */
+// @unit harness-error
+// @layer application
+
 export interface ValidatorIssueDraft {
   readonly code: string;
   readonly message: string;

package/scripts/harness/harness-error/domain/errors/adr-reference-not-found-error.ts

@@ -1,9 +1,6 @@
-/**
- * @layer domain
- * @unit harness-error
- *
- * ADR参照先が実在しない場合に送出されるドメインエラー
- */
+// @unit harness-error
+// @layer domain
+
 import { HarnessErrorDomainError } from './harness-error-domain-error.js';
 
 export class AdrReferenceNotFoundError extends HarnessErrorDomainError {

package/scripts/harness/harness-error/domain/errors/duplicate-error-code-error.ts

@@ -1,9 +1,6 @@
-/**
- * @layer domain
- * @unit harness-error
- *
- * ErrorDefinitionRegistry に重複コードが登録された場合に送出されるドメインエラー
- */
+// @unit harness-error
+// @layer domain
+
 import { HarnessErrorDomainError } from './harness-error-domain-error.js';
 
 export class DuplicateErrorCodeError extends HarnessErrorDomainError {

package/scripts/harness/harness-error/domain/errors/invalid-adr-ref-error.ts

@@ -1,9 +1,6 @@
-/**
- * @layer domain
- * @unit harness-error
- *
- * AdrRef の形式不正時に送出されるドメインエラー
- */
+// @unit harness-error
+// @layer domain
+
 import { HarnessErrorDomainError } from './harness-error-domain-error.js';
 
 export class InvalidAdrRefError extends HarnessErrorDomainError {

package/scripts/harness/harness-error/domain/errors/invalid-error-code-error.ts

@@ -1,9 +1,6 @@
-/**
- * @layer domain
- * @unit harness-error
- *
- * ErrorCode の形式不正時に送出されるドメインエラー
- */
+// @unit harness-error
+// @layer domain
+
 import { HarnessErrorDomainError } from './harness-error-domain-error.js';
 
 export class InvalidErrorCodeError extends HarnessErrorDomainError {

package/scripts/harness/harness-error/domain/errors/invalid-severity-error.ts

@@ -1,9 +1,6 @@
-/**
- * @layer domain
- * @unit harness-error
- *
- * Severity の入力不正時に送出されるドメインエラー
- */
+// @unit harness-error
+// @layer domain
+
 import { HarnessErrorDomainError } from './harness-error-domain-error.js';
 
 export class InvalidSeverityError extends HarnessErrorDomainError {

package/scripts/harness/harness-error/domain/errors/missing-adr-ref-error.ts

@@ -1,9 +1,6 @@
-/**
- * @layer domain
- * @unit harness-error
- *
- * ADR参照が必須なのに未指定の場合に送出されるドメインエラー
- */
+// @unit harness-error
+// @layer domain
+
 import { HarnessErrorDomainError } from './harness-error-domain-error.js';
 
 export class MissingAdrRefError extends HarnessErrorDomainError {

package/scripts/harness/harness-error/domain/errors/missing-fix-example-error.ts

@@ -1,9 +1,6 @@
-/**
- * @layer domain
- * @unit harness-error
- *
- * fix_example が必須なのに未指定の場合に送出されるドメインエラー
- */
+// @unit harness-error
+// @layer domain
+
 import { HarnessErrorDomainError } from './harness-error-domain-error.js';
 
 export class MissingFixExampleError extends HarnessErrorDomainError {

package/scripts/harness/harness-error/domain/errors/severity-downgrade-violation-error.ts

@@ -1,9 +1,6 @@
-/**
- * @layer domain
- * @unit harness-error
- *
- * severity の格下げ（error -> warning）が試みられた場合に送出されるドメインエラー
- */
+// @unit harness-error
+// @layer domain
+
 import { HarnessErrorDomainError } from './harness-error-domain-error.js';
 
 export class SeverityDowngradeViolationError extends HarnessErrorDomainError {

package/scripts/harness/harness-error/domain/errors/unknown-error-definition-error.ts

@@ -1,9 +1,6 @@
-/**
- * @layer domain
- * @unit harness-error
- *
- * ErrorDefinitionRegistry に未登録のコードが指定された場合に送出されるドメインエラー
- */
+// @unit harness-error
+// @layer domain
+
 import { HarnessErrorDomainError } from './harness-error-domain-error.js';
 
 export class UnknownErrorDefinitionError extends HarnessErrorDomainError {