phasegate 0.264.0 → 0.283.0

package/scripts/harness/harness-api/domain/services/status-derivation-service.ts

@@ -1,17 +1,27 @@
 // @layer domain
 // @unit harness-api
 // @work-item-id WI-112
+// @work-item-id WI-328
 // status-derivation-service.ts — StatusDerivationService Domain Service
 
-import { LayerHealth, type LayerId } from '../value-objects/layer-health.js';
-import { HarnessStatusSummary, type PresetInfo, type ConfigSummary, type PhaseGateSummary, type HookHealth, type BaselineHealth, type OperationalWarning } from '../value-objects/harness-status-summary.js';
-import type { ArtifactScanResult, ArtifactPresence } from '../value-objects/artifact-scan-result.js';
-
-const ALL_LAYER_IDS: readonly LayerId[] = ['L1', 'L2', 'L3', 'L4'];
+import type { ArtifactPresence, ArtifactScanResult } from "../value-objects/artifact-scan-result.js";
+import {
+  type BaselineHealth,
+  type ConfigSummary,
+  HarnessStatusSummary,
+  type HookHealth,
+  type LanguageInfo,
+  type OperationalWarning,
+  type PhaseGateSummary,
+  type PresetInfo,
+} from "../value-objects/harness-status-summary.js";
+import { LayerHealth, type LayerId } from "../value-objects/layer-health.js";
+
+const ALL_LAYER_IDS: readonly LayerId[] = ["L1", "L2", "L3", "L4"];
 
 function getLayerId(artifact: ArtifactPresence): LayerId | null {
   const id = artifact.layer ?? artifact.layerId;
-  if (id === 'L1' || id === 'L2' || id === 'L3' || id === 'L4') return id;
+  if (id === "L1" || id === "L2" || id === "L3" || id === "L4") return id;
   return null;
 }
 
@@ -22,7 +32,7 @@ export class StatusDerivationService {
   deriveLayerHealth(scanResult: ArtifactScanResult, layerId: LayerId): LayerHealth {
     const layerArtifacts = scanResult.foundArtifacts.filter((a) => getLayerId(a) === layerId);
     const hasPresent = layerArtifacts.some((a) => a.present === true);
-    const lastResult = hasPresent ? 'pass' : 'unknown';
+    const lastResult = hasPresent ? "pass" : "unknown";
     return LayerHealth.create({ layerId, enabled: true, lastResult });
   }
 
@@ -34,7 +44,7 @@ export class StatusDerivationService {
     config: { layers?: Record<string, { enabled: boolean }> },
     presetInfo?: PresetInfo,
     configSummary?: ConfigSummary,
-    phaseGateSummary?: PhaseGateSummary
+    phaseGateSummary?: PhaseGateSummary,
   ): HarnessStatusSummary {
     const derivedLayers = scanResult.derivedLayerHealth;
 
@@ -53,19 +63,19 @@ export class StatusDerivationService {
       // Derive from scan result
       const layerArtifacts = scanResult.foundArtifacts.filter((a) => getLayerId(a) === layerId);
       const hasPresent = layerArtifacts.some((a) => a.present === true);
-      const lastResult = enabled ? (hasPresent ? 'pass' : 'unknown') : undefined;
+      const lastResult = enabled ? (hasPresent ? "pass" : "unknown") : undefined;
       return LayerHealth.create({ layerId, enabled, lastResult });
     });
 
     const effectivePresetInfo: PresetInfo = presetInfo ?? {
-      name: 'standard',
-      enabledLayers: ['L1', 'L2', 'L3'],
+      name: "standard",
+      enabledLayers: ["L1", "L2", "L3"],
     };
 
     const effectiveConfigSummary: ConfigSummary = configSummary ?? {
-      configPath: 'phasegate.config.json',
+      configPath: "phasegate.config.json",
       lastModified: new Date().toISOString(),
-      version: '2',
+      version: "2",
     };
 
     const effectivePhaseGateSummary: PhaseGateSummary = phaseGateSummary ?? {
@@ -90,7 +100,8 @@ export class StatusDerivationService {
     presetInfo: PresetInfo;
     configSummary: ConfigSummary;
     phaseGateSummary: PhaseGateSummary;
-    liveValidationByLayer?: Partial<Record<LayerId, 'pass' | 'fail' | 'skipped' | 'not-run' | 'error'>>;
+    liveValidationByLayer?: Partial<Record<LayerId, "pass" | "fail" | "skipped" | "not-run" | "error">>;
+    languages?: LanguageInfo;
     hookHealth?: HookHealth;
     baselineHealth?: BaselineHealth;
     operationalWarnings?: readonly OperationalWarning[];
@@ -99,21 +110,19 @@ export class StatusDerivationService {
 
     const layers: LayerHealth[] = ALL_LAYER_IDS.map((layerId) => {
       const enabled = presetInfo.enabledLayers.includes(layerId);
-      const configurationState = enabled ? 'enabled' : 'disabled';
+      const configurationState = enabled ? "enabled" : "disabled";
 
       // Find from derivedLayerHealth
       const existing = scanResult.derivedLayerHealth.find((l) => l.layerId === layerId);
       const layerArtifacts = scanResult.foundArtifacts.filter((a) => getLayerId(a) === layerId);
       const hasPresent = layerArtifacts.some((a) => a.present === true);
-      const cachedArtifactState = hasPresent ? 'present' : 'missing';
-      const liveValidationState = liveValidationByLayer?.[layerId] ?? 'not-run';
+      const cachedArtifactState = hasPresent ? "present" : "missing";
+      const liveValidationState = liveValidationByLayer?.[layerId] ?? "not-run";
       const liveLastResult =
-        liveValidationState === 'pass' || liveValidationState === 'fail'
-          ? liveValidationState
-          : undefined;
+        liveValidationState === "pass" || liveValidationState === "fail" ? liveValidationState : undefined;
 
       if (enabled) {
-        const lastResult = liveLastResult ?? existing?.lastResult ?? (hasPresent ? 'pass' : 'unknown');
+        const lastResult = liveLastResult ?? existing?.lastResult ?? (hasPresent ? "pass" : "unknown");
         return LayerHealth.create({
           layerId,
           enabled,
@@ -139,6 +148,7 @@ export class StatusDerivationService {
       phaseGateSummary,
       presetInfo,
       configSummary,
+      languages: input.languages,
       hookHealth: input.hookHealth,
       baselineHealth: input.baselineHealth,
       operationalWarnings: input.operationalWarnings,

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 [];
   }