phasegate 0.254.0 → 0.283.0

package/scripts/harness/harness-api/domain/value-objects/harness-status-summary.ts

@@ -2,7 +2,7 @@
 // @unit harness-api
 // harness-status-summary.ts — HarnessStatusSummary Value Object
 
-import type { LayerHealth, LayerId } from './layer-health.js';
+import type { LayerHealth, LayerId } from "./layer-health.js";
 
 export interface PhaseGateSummary {
   totalStories: number;
@@ -11,7 +11,7 @@ export interface PhaseGateSummary {
 }
 
 export interface PresetInfo {
-  name: 'minimal' | 'standard' | 'strict';
+  name: "minimal" | "standard" | "strict";
   enabledLayers: LayerId[];
 }
 
@@ -21,9 +21,21 @@ export interface ConfigSummary {
   version: string;
 }
 
+/**
+ * WI-328 (github#39 残課題): 実効言語リストとその出所。
+ * source:
+ * - 'declared' — config の project.languages 宣言
+ * - 'detected' — ファイルシステムマーカーからの自動検出（WI-319）
+ * - 'fallback' — 検出ゼロで typescript フォールバック
+ */
+export interface LanguageInfo {
+  effective: readonly string[];
+  source: "declared" | "detected" | "fallback";
+}
+
 export interface HookSkipState {
   hookType: string;
-  reason: 'HOOK_DISABLED' | 'TIMEOUT_EXCEEDED' | 'REENTRY_DETECTED' | string;
+  reason: "HOOK_DISABLED" | "TIMEOUT_EXCEEDED" | "REENTRY_DETECTED" | string;
   targetPaths: readonly string[];
   observedAt: string;
 }
@@ -35,7 +47,7 @@ export interface HookHealth {
   skipCountsByReason: Readonly<Record<string, number>>;
   applyPatchBypass: {
     nativeApplyPatchIntercepted: boolean;
-    backstop: 'pre-commit';
+    backstop: "pre-commit";
     documentationUrl: string;
   };
 }
@@ -60,18 +72,20 @@ export interface HarnessStatusSummaryProps {
   phaseGateSummary: PhaseGateSummary;
   presetInfo: PresetInfo;
   configSummary: ConfigSummary;
+  languages?: LanguageInfo;
   hookHealth?: HookHealth;
   baselineHealth?: BaselineHealth;
   operationalWarnings?: readonly OperationalWarning[];
 }
 
-const REQUIRED_LAYER_IDS: readonly LayerId[] = ['L1', 'L2', 'L3', 'L4'];
+const REQUIRED_LAYER_IDS: readonly LayerId[] = ["L1", "L2", "L3", "L4"];
 
 export class HarnessStatusSummary {
   readonly layers: readonly LayerHealth[];
   readonly phaseGateSummary: PhaseGateSummary;
   readonly presetInfo: PresetInfo;
   readonly configSummary: ConfigSummary;
+  readonly languages: LanguageInfo | undefined;
   readonly hookHealth: HookHealth | undefined;
   readonly baselineHealth: BaselineHealth | undefined;
   readonly operationalWarnings: readonly OperationalWarning[];
@@ -81,6 +95,7 @@ export class HarnessStatusSummary {
     this.phaseGateSummary = props.phaseGateSummary;
     this.presetInfo = props.presetInfo;
     this.configSummary = props.configSummary;
+    this.languages = props.languages;
     this.hookHealth = props.hookHealth;
     this.baselineHealth = props.baselineHealth;
     this.operationalWarnings = Object.freeze([...(props.operationalWarnings ?? [])]);
@@ -91,13 +106,13 @@ export class HarnessStatusSummary {
     // INV: 4レイヤー必須
     if (props.layers.length !== 4) {
       throw new Error(
-        `HarnessApiDomainError: HarnessStatusSummary requires exactly 4 layers (L1-L4), got ${props.layers.length}`
+        `HarnessApiDomainError: HarnessStatusSummary requires exactly 4 layers (L1-L4), got ${props.layers.length}`,
       );
     }
     // 重複チェック
     const ids = props.layers.map((l) => l.layerId);
     if (new Set(ids).size !== ids.length) {
-      throw new Error('HarnessApiDomainError: HarnessStatusSummary has duplicate layerIds');
+      throw new Error("HarnessApiDomainError: HarnessStatusSummary has duplicate layerIds");
     }
     // L1-L4 必須チェック
     for (const required of REQUIRED_LAYER_IDS) {
@@ -113,6 +128,6 @@ export class HarnessStatusSummary {
   }
 
   isAllLayersHealthy(): boolean {
-    return this.layers.every((l) => !l.enabled || l.lastResult === 'pass');
+    return this.layers.every((l) => !l.enabled || l.lastResult === "pass");
   }
 }

package/scripts/harness/harness-api/infrastructure/adapters/biome-ast-engine-lint-adapter.ts

@@ -1,6 +1,7 @@
 // @layer infrastructure
 // biome-ast-engine-lint-adapter.ts — BiomeAstEngineLintAdapter
 // Wave 2完了後にリアル実装へ差し替え（旧: @stub: wave2-pending）
+// @work-item-id WI-311
 
 import type { BiomeLintPort } from '../../domain/ports/biome-lint-port.js';
 import type { HarnessError } from '../../domain/value-objects/harness-api-response.js';
@@ -36,12 +37,11 @@ function violationToHarnessError(v: RuleViolation): HarnessError {
 export class BiomeAstEngineLintAdapter implements BiomeLintPort {
   private readonly stub: IBiomeAstEngineStub;
 
-  constructor(stub?: IBiomeAstEngineStub) {
-    this.stub = stub ?? BiomeAstEngineLintAdapter.createRealImpl();
+  constructor(stub?: IBiomeAstEngineStub, rootDir = process.cwd()) {
+    this.stub = stub ?? BiomeAstEngineLintAdapter.createRealImpl(rootDir);
   }
 
-  private static createRealImpl(): IBiomeAstEngineStub {
-    const rootDir = process.cwd();
+  private static createRealImpl(rootDir: string): IBiomeAstEngineStub {
     return {
       async runLint(): Promise<BiomeAstEngineResult> {
         const { createBiomeAstEngineModule } = await import('../../../biome-ast-engine/composition-root.js');

package/scripts/harness/harness-api/infrastructure/adapters/harness-config-query-adapter.ts

@@ -2,20 +2,30 @@
 // @unit harness-api
 // @work-item-id WI-123
 // @work-item-id WI-096
+// @work-item-id WI-328
 // harness-config-query-adapter.ts — HarnessConfigQueryAdapter
 
-import * as fs from 'node:fs/promises';
-import { createHash } from 'node:crypto';
-import { dirname, join, resolve } from 'node:path';
-import type { ConfigQueryPort } from '../../domain/ports/config-query-port.js';
-import type { PresetInfo, ConfigSummary, PhaseGateSummary, HookHealth, BaselineHealth } from '../../domain/value-objects/harness-status-summary.js';
-import type { LayerId } from '../../domain/value-objects/layer-health.js';
+import { createHash } from "node:crypto";
+import * as fs from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { resolveProjectLanguages } from "../../../validator-system/infrastructure/adapters/harness-config-validator-config-adapter.js";
+import type { ConfigQueryPort } from "../../domain/ports/config-query-port.js";
+import type {
+  BaselineHealth,
+  ConfigSummary,
+  HookHealth,
+  LanguageInfo,
+  PhaseGateSummary,
+  PresetInfo,
+} from "../../domain/value-objects/harness-status-summary.js";
+import type { LayerId } from "../../domain/value-objects/layer-health.js";
 
 interface HarnessConfigJson {
   version: number;
   project: {
     name: string;
-    preset: 'minimal' | 'standard' | 'strict';
+    preset: "minimal" | "standard" | "strict";
+    languages?: string[];
   };
   layers?: Partial<Record<LayerId, { enabled?: boolean }>>;
   paths?: {
@@ -29,9 +39,9 @@ interface HarnessConfigJson {
 }
 
 const PRESET_LAYERS: Record<string, LayerId[]> = {
-  minimal: ['L1'],
-  standard: ['L1', 'L2', 'L3'],
-  strict: ['L1', 'L2', 'L3', 'L4'],
+  minimal: ["L1"],
+  standard: ["L1", "L2", "L3"],
+  strict: ["L1", "L2", "L3", "L4"],
 };
 
 export interface HarnessConfigQueryAdapterOptions {
@@ -48,7 +58,7 @@ export class HarnessConfigQueryAdapter implements ConfigQueryPort {
 
   private async readConfig(): Promise<HarnessConfigJson> {
     if (this.cachedConfig !== null) return this.cachedConfig;
-    const content = await fs.readFile(this.configPath, 'utf-8');
+    const content = await fs.readFile(this.configPath, "utf-8");
     this.cachedConfig = JSON.parse(content) as HarnessConfigJson;
     return this.cachedConfig;
   }
@@ -56,7 +66,7 @@ export class HarnessConfigQueryAdapter implements ConfigQueryPort {
   async getPresetInfo(): Promise<PresetInfo> {
     const config = await this.readConfig();
     const preset = config.project.preset;
-    const presetLayers = PRESET_LAYERS[preset] ?? ['L1', 'L2', 'L3'];
+    const presetLayers = PRESET_LAYERS[preset] ?? ["L1", "L2", "L3"];
     const enabledLayerSet = new Set<LayerId>(presetLayers);
 
     for (const [layerId, layerConfig] of Object.entries(config.layers ?? {}) as [LayerId, { enabled?: boolean }][]) {
@@ -67,17 +77,29 @@ export class HarnessConfigQueryAdapter implements ConfigQueryPort {
       }
     }
 
-    const enabledLayers = (['L1', 'L2', 'L3', 'L4'] as const).filter((layerId) => enabledLayerSet.has(layerId));
+    const enabledLayers = (["L1", "L2", "L3", "L4"] as const).filter((layerId) => enabledLayerSet.has(layerId));
     return { name: preset, enabledLayers };
   }
 
+  /**
+   * WI-328 (github#39 残課題): 実効言語リストと出所を返す。
+   * 解決ロジックは validator-system の resolveProjectLanguages()（WI-319 の
+   * 検出テーブル）を再利用し、validator の有効/SKIP 判定と同じ結果を表示する。
+   */
+  async getLanguageInfo(): Promise<LanguageInfo> {
+    const config = await this.readConfig();
+    const rootDir = dirname(resolve(this.configPath));
+    const resolved = resolveProjectLanguages(config.project?.languages, rootDir);
+    return { effective: resolved.languages, source: resolved.source };
+  }
+
   async getConfigSummary(): Promise<ConfigSummary> {
     await this.readConfig();
     const stat = await fs.stat(this.configPath);
     return {
       configPath: this.configPath,
       lastModified: stat.mtime.toISOString(),
-      version: '2',
+      version: "2",
     };
   }
 
@@ -89,7 +111,7 @@ export class HarnessConfigQueryAdapter implements ConfigQueryPort {
   async getHookHealth(): Promise<HookHealth> {
     const rootDir = dirname(this.configPath);
     const configuredHooks: string[] = [];
-    for (const hookPath of ['.claude/settings.json', '.codex/hooks.json', '.husky/pre-commit', '.husky/pre-push']) {
+    for (const hookPath of [".claude/settings.json", ".codex/hooks.json", ".husky/pre-commit", ".husky/pre-push"]) {
       try {
         await fs.access(join(rootDir, hookPath));
         configuredHooks.push(hookPath);
@@ -98,7 +120,7 @@ export class HarnessConfigQueryAdapter implements ConfigQueryPort {
       }
     }
 
-    const skipEvents = await readHookSkipEvents(join(rootDir, '.phasegate/hook-skip-events.jsonl'));
+    const skipEvents = await readHookSkipEvents(join(rootDir, ".phasegate/hook-skip-events.jsonl"));
     const skipCountsByReason: Record<string, number> = {};
     for (const event of skipEvents) {
       skipCountsByReason[event.reason] = (skipCountsByReason[event.reason] ?? 0) + 1;
@@ -111,8 +133,8 @@ export class HarnessConfigQueryAdapter implements ConfigQueryPort {
       skipCountsByReason,
       applyPatchBypass: {
         nativeApplyPatchIntercepted: false,
-        backstop: 'pre-commit',
-        documentationUrl: 'docs/guide/codex-integration.md',
+        backstop: "pre-commit",
+        documentationUrl: "docs/guide/codex-integration.md",
       },
     };
   }
@@ -121,50 +143,73 @@ export class HarnessConfigQueryAdapter implements ConfigQueryPort {
     const config = await this.readConfig();
     const rootDir = dirname(this.configPath);
     const enabled = config.baseline?.enabled ?? true;
-    const relativePath = config.baseline?.path ?? '.phasegate/baseline.json';
+    const relativePath = config.baseline?.path ?? ".phasegate/baseline.json";
     const baselinePath = resolve(rootDir, relativePath);
 
     if (!enabled) {
-      return { enabled: false, path: relativePath, grandfatheredFileCount: 0, shaMismatchCount: 0, missingFileCount: 0, removalRate: 0 };
+      return {
+        enabled: false,
+        path: relativePath,
+        grandfatheredFileCount: 0,
+        shaMismatchCount: 0,
+        missingFileCount: 0,
+        removalRate: 0,
+      };
     }
 
     let raw: string;
     try {
-      raw = await fs.readFile(baselinePath, 'utf-8');
+      raw = await fs.readFile(baselinePath, "utf-8");
     } catch {
-      return { enabled: true, path: relativePath, grandfatheredFileCount: 0, shaMismatchCount: 0, missingFileCount: 0, removalRate: 0 };
+      return {
+        enabled: true,
+        path: relativePath,
+        grandfatheredFileCount: 0,
+        shaMismatchCount: 0,
+        missingFileCount: 0,
+        removalRate: 0,
+      };
     }
 
-    const parsed = JSON.parse(raw) as { files?: Array<{ path?: string; sha1?: string }>; entries?: Array<{ path?: string; sha1?: string }> };
+    const parsed = JSON.parse(raw) as {
+      files?: Array<{ path?: string; sha1?: string }>;
+      entries?: Array<{ path?: string; sha1?: string }>;
+    };
     const entries = parsed.files ?? parsed.entries ?? [];
     let shaMismatchCount = 0;
     let missingFileCount = 0;
     for (const entry of entries) {
-      if (typeof entry.path !== 'string' || typeof entry.sha1 !== 'string') continue;
+      if (typeof entry.path !== "string" || typeof entry.sha1 !== "string") continue;
       try {
         const current = await fs.readFile(resolve(rootDir, entry.path));
-        const sha1 = createHash('sha1').update(current).digest('hex');
+        const sha1 = createHash("sha1").update(current).digest("hex");
         if (sha1 !== entry.sha1) shaMismatchCount += 1;
       } catch {
         missingFileCount += 1;
       }
     }
     const grandfatheredFileCount = entries.length;
-    const removalRate = grandfatheredFileCount === 0
-      ? 1
-      : (shaMismatchCount + missingFileCount) / grandfatheredFileCount;
-    return { enabled: true, path: relativePath, grandfatheredFileCount, shaMismatchCount, missingFileCount, removalRate };
+    const removalRate =
+      grandfatheredFileCount === 0 ? 1 : (shaMismatchCount + missingFileCount) / grandfatheredFileCount;
+    return {
+      enabled: true,
+      path: relativePath,
+      grandfatheredFileCount,
+      shaMismatchCount,
+      missingFileCount,
+      removalRate,
+    };
   }
 }
 
-async function readHookSkipEvents(filePath: string): Promise<Array<NonNullable<HookHealth['latestSkip']>>> {
+async function readHookSkipEvents(filePath: string): Promise<Array<NonNullable<HookHealth["latestSkip"]>>> {
   try {
-    const raw = await fs.readFile(filePath, 'utf-8');
+    const raw = await fs.readFile(filePath, "utf-8");
     return raw
-      .split('\n')
+      .split("\n")
       .filter((line) => line.trim().length > 0)
-      .map((line) => JSON.parse(line) as HookHealth['latestSkip'])
-      .filter((event): event is NonNullable<HookHealth['latestSkip']> => event !== null);
+      .map((line) => JSON.parse(line) as HookHealth["latestSkip"])
+      .filter((event): event is NonNullable<HookHealth["latestSkip"]> => event !== null);
   } catch {
     return [];
   }