phasegate 0.254.0 → 0.283.0

package/scripts/harness/harness-api/domain/services/command-dispatch-service.ts

@@ -1,22 +1,27 @@
 // @layer domain
 // @unit harness-api
-// @work-item-id WI-108 / WI-114, WI-186
+// @work-item-id WI-108 / WI-114, WI-186, WI-318, WI-321, WI-328
 // command-dispatch-service.ts — CommandDispatchService Domain Service
 
-import { CommandRegistry } from './command-registry.js';
-import { StatusDerivationService } from './status-derivation-service.js';
-import { HarnessApiResponse, type ExitCode, type HarnessError } from '../value-objects/harness-api-response.js';
-import { CheckReadyResult } from '../value-objects/check-ready-result.js';
-import { CiCheckResult } from '../value-objects/ci-check-result.js';
-import { DriftReportSummary } from '../value-objects/drift-report-summary.js';
-import type { ValidatorExecutionPort } from '../ports/validator-execution-port.js';
-import type { PhaseGateQueryPort } from '../ports/phase-gate-query-port.js';
-import type { BiomeLintPort } from '../ports/biome-lint-port.js';
-import type { ImpactAnalysisPort } from '../ports/impact-analysis-port.js';
-import type { ArtifactScannerPort } from '../ports/artifact-scanner-port.js';
-import type { ConfigQueryPort } from '../ports/config-query-port.js';
-import type { LayerId } from '../value-objects/layer-health.js';
-import type { BaselineHealth, HookHealth, OperationalWarning } from '../value-objects/harness-status-summary.js';
+import type { ArtifactScannerPort } from "../ports/artifact-scanner-port.js";
+import type { BiomeLintPort } from "../ports/biome-lint-port.js";
+import type { ConfigQueryPort } from "../ports/config-query-port.js";
+import type { ImpactAnalysisPort } from "../ports/impact-analysis-port.js";
+import type { PhaseGateQueryPort } from "../ports/phase-gate-query-port.js";
+import type { ValidatorExecutionPort } from "../ports/validator-execution-port.js";
+import { CheckReadyResult } from "../value-objects/check-ready-result.js";
+import { CiCheckResult } from "../value-objects/ci-check-result.js";
+import { DriftReportSummary } from "../value-objects/drift-report-summary.js";
+import { type ExitCode, HarnessApiResponse, type HarnessError } from "../value-objects/harness-api-response.js";
+import type {
+  BaselineHealth,
+  HookHealth,
+  LanguageInfo,
+  OperationalWarning,
+} from "../value-objects/harness-status-summary.js";
+import type { LayerId } from "../value-objects/layer-health.js";
+import { CommandRegistry } from "./command-registry.js";
+import { StatusDerivationService } from "./status-derivation-service.js";
 
 export interface CommandDispatchPorts {
   validatorExecutionPort: ValidatorExecutionPort;
@@ -28,6 +33,7 @@ export interface CommandDispatchPorts {
     getConfig?: () => Promise<unknown>;
     getPresetInfo?: () => Promise<unknown>;
     getConfigSummary?: () => Promise<unknown>;
+    getLanguageInfo?: () => Promise<LanguageInfo>;
     getHookHealth?: () => Promise<HookHealth>;
     getBaselineHealth?: () => Promise<BaselineHealth>;
   };
@@ -42,27 +48,29 @@ export interface DispatchResult<T = unknown> {
 }
 
 function makeError(message: string): HarnessError {
-  return { code: 'HARNESS_ERROR', severity: 'error', message };
+  return { code: "HARNESS_ERROR", severity: "error", message };
 }
 
-type LiveValidationState = 'pass' | 'fail' | 'skipped' | 'not-run' | 'error';
+type LiveValidationState = "pass" | "fail" | "skipped" | "not-run" | "error";
 
 function layerIdFromValidatorId(validatorId: string): LayerId | null {
   const prefix = validatorId.slice(0, 2);
-  return prefix === 'L1' || prefix === 'L2' || prefix === 'L3' || prefix === 'L4' ? prefix : null;
+  return prefix === "L1" || prefix === "L2" || prefix === "L3" || prefix === "L4" ? prefix : null;
 }
 
-function summarizeLayerResults(items: readonly { validatorId: string; passed: boolean; skipped?: boolean }[]): Partial<Record<LayerId, LiveValidationState>> {
+function summarizeLayerResults(
+  items: readonly { validatorId: string; passed: boolean; skipped?: boolean }[],
+): Partial<Record<LayerId, LiveValidationState>> {
   const result: Partial<Record<LayerId, LiveValidationState>> = {};
-  for (const layerId of ['L2', 'L3', 'L4'] as const) {
+  for (const layerId of ["L2", "L3", "L4"] as const) {
     const layerItems = items.filter((item) => layerIdFromValidatorId(item.validatorId) === layerId);
     if (layerItems.length === 0) continue;
     if (layerItems.every((item) => item.skipped === true)) {
-      result[layerId] = 'skipped';
+      result[layerId] = "skipped";
     } else if (layerItems.some((item) => !item.passed && item.skipped !== true)) {
-      result[layerId] = 'fail';
+      result[layerId] = "fail";
     } else {
-      result[layerId] = 'pass';
+      result[layerId] = "pass";
     }
   }
   return result;
@@ -74,7 +82,7 @@ function hasEnabledLiveFailure(
 ): boolean {
   return enabledLayers.some((layerId) => {
     const liveState = liveValidationByLayer[layerId];
-    return liveState === 'fail' || liveState === 'error';
+    return liveState === "fail" || liveState === "error";
   });
 }
 
@@ -83,42 +91,41 @@ function buildOperationalWarnings(
   baselineHealth: BaselineHealth | undefined,
 ): OperationalWarning[] {
   const warnings: OperationalWarning[] = [];
-  const skipCount = hookHealth === undefined
-    ? 0
-    : Object.values(hookHealth.skipCountsByReason).reduce((sum, count) => sum + count, 0);
+  const skipCount =
+    hookHealth === undefined ? 0 : Object.values(hookHealth.skipCountsByReason).reduce((sum, count) => sum + count, 0);
   if (hookHealth !== undefined && skipCount > 0) {
     warnings.push({
-      code: 'HOOK_SKIP_OBSERVED',
+      code: "HOOK_SKIP_OBSERVED",
       message: `Hook skip events observed: ${skipCount}`,
-      nextAction: 'Inspect hookHealth.latestSkip and re-enable hooks or resolve reentry/timeout causes.',
+      nextAction: "Inspect hookHealth.latestSkip and re-enable hooks or resolve reentry/timeout causes.",
     });
   }
   if (baselineHealth !== undefined && baselineHealth.shaMismatchCount > 0) {
     warnings.push({
-      code: 'BASELINE_SHA_MISMATCH',
+      code: "BASELINE_SHA_MISMATCH",
       message: `${baselineHealth.shaMismatchCount} baseline files changed since the snapshot.`,
-      nextAction: 'Add or update design coverage for changed files and remove resolved entries from the baseline.',
+      nextAction: "Add or update design coverage for changed files and remove resolved entries from the baseline.",
     });
   }
   if (baselineHealth !== undefined && baselineHealth.grandfatheredFileCount > 50 && baselineHealth.removalRate < 0.5) {
     warnings.push({
-      code: 'BASELINE_DEBT_HIGH',
+      code: "BASELINE_DEBT_HIGH",
       message: `Baseline grandfather debt remains high: ${baselineHealth.grandfatheredFileCount} files.`,
-      nextAction: 'Plan a retrofit cleanup batch and reduce the baseline snapshot.',
+      nextAction: "Plan a retrofit cleanup batch and reduce the baseline snapshot.",
     });
   }
   return warnings;
 }
 
 const KNOWN_COMMANDS = new Set([
-  'phasegate:check-ready',
-  'phasegate:check-phase',
-  'phasegate:ci-check',
-  'phasegate:detect-drift',
-  'phasegate:status',
-  'phasegate:lint',
-  'phasegate:complete-check',
-  'phasegate:impact-analysis',
+  "phasegate:check-ready",
+  "phasegate:check-phase",
+  "phasegate:ci-check",
+  "phasegate:detect-drift",
+  "phasegate:status",
+  "phasegate:lint",
+  "phasegate:complete-check",
+  "phasegate:impact-analysis",
 ]);
 
 export class CommandDispatchService {
@@ -129,7 +136,7 @@ export class CommandDispatchService {
   constructor(
     registryOrPorts: CommandRegistry | CommandDispatchPorts,
     ports?: CommandDispatchPorts,
-    statusDerivationService?: StatusDerivationService
+    statusDerivationService?: StatusDerivationService,
   ) {
     if (registryOrPorts instanceof CommandRegistry) {
       this.registry = registryOrPorts;
@@ -164,7 +171,7 @@ export class CommandDispatchService {
       const message = err instanceof Error ? err.message : String(err);
       const response = HarnessApiResponse.error<T>([makeError(message)], { ...summary, failed: 1 });
       return {
-        status: 'error',
+        status: "error",
         errors: response.errors,
         summary: response.summary,
         data: undefined,
@@ -177,61 +184,62 @@ export class CommandDispatchService {
     commandName: string,
     args: Record<string, string>,
     _flags: Record<string, boolean | string>,
-    summary: { totalChecks: number; passed: number; failed: number; warnings: number }
+    summary: { totalChecks: number; passed: number; failed: number; warnings: number },
   ): Promise<DispatchResult<T>> {
     switch (commandName) {
-      case 'phasegate:check-ready': {
+      case "phasegate:check-ready": {
         const stories = await this.ports.phaseGateQueryPort.queryAllStories();
         const result = CheckReadyResult.fromStories(stories);
         if (result.allPassed) {
           const r = HarnessApiResponse.pass({ ...summary, passed: 1 }, result);
-          return { status: 'pass', errors: [], summary: r.summary, data: result as unknown as T, exitCode: 0 };
+          return { status: "pass", errors: [], summary: r.summary, data: result as unknown as T, exitCode: 0 };
         }
         const failed = result.getFailedStories();
         const errors = failed.map((s) => makeError(`Story ${s.storyId} failed Phase Gate`));
         const r = HarnessApiResponse.fail(errors, { ...summary, failed: 1 }, result);
-        return { status: 'fail', errors: r.errors, summary: r.summary, data: result as unknown as T, exitCode: 1 };
+        return { status: "fail", errors: r.errors, summary: r.summary, data: result as unknown as T, exitCode: 1 };
       }
 
-      case 'phasegate:check-phase': {
-        const unitId = args.unit ?? '';
+      case "phasegate:check-phase": {
+        const unitId = args.unit ?? "";
         const phaseInfo = await this.ports.phaseGateQueryPort.queryUnit(unitId);
         if (phaseInfo === null) {
           const errors = [makeError(`Unit '${unitId}' not found`)];
           const r = HarnessApiResponse.fail(errors, { ...summary, failed: 1 });
-          return { status: 'fail', errors: r.errors, summary: r.summary, data: undefined, exitCode: 1 };
+          return { status: "fail", errors: r.errors, summary: r.summary, data: undefined, exitCode: 1 };
         }
         const r = HarnessApiResponse.pass({ ...summary, passed: 1 }, phaseInfo);
-        return { status: 'pass', errors: [], summary: r.summary, data: phaseInfo as unknown as T, exitCode: 0 };
+        return { status: "pass", errors: [], summary: r.summary, data: phaseInfo as unknown as T, exitCode: 0 };
       }
 
-      case 'phasegate:ci-check': {
+      case "phasegate:ci-check": {
         const validatorResults = await this.ports.validatorExecutionPort.runAllValidators();
         const result = CiCheckResult.fromResults(validatorResults);
         if (result.allPassed) {
           const r = HarnessApiResponse.pass({ ...summary, passed: 1 }, result);
-          return { status: 'pass', errors: [], summary: r.summary, data: result as unknown as T, exitCode: 0 };
+          return { status: "pass", errors: [], summary: r.summary, data: result as unknown as T, exitCode: 0 };
         }
         const collected = result.collectAllErrors();
-        const errors = collected.length > 0
-          ? collected
-          : result.getFailedValidators().map((v) => makeError(`Validator ${v.validatorId} failed`));
+        const errors =
+          collected.length > 0
+            ? collected
+            : result.getFailedValidators().map((v) => makeError(`Validator ${v.validatorId} failed`));
         const r = HarnessApiResponse.fail(errors, { ...summary, failed: 1 }, result);
-        return { status: 'fail', errors: r.errors, summary: r.summary, data: result as unknown as T, exitCode: 1 };
+        return { status: "fail", errors: r.errors, summary: r.summary, data: result as unknown as T, exitCode: 1 };
       }
 
-      case 'phasegate:detect-drift': {
+      case "phasegate:detect-drift": {
         const drifts = await this.ports.validatorExecutionPort.runDriftDetection();
         const result = DriftReportSummary.fromDrifts(drifts);
         if (!result.hasDrift()) {
           const r = HarnessApiResponse.pass({ ...summary, passed: 1 }, result);
-          return { status: 'pass', errors: [], summary: r.summary, data: result as unknown as T, exitCode: 0 };
+          return { status: "pass", errors: [], summary: r.summary, data: result as unknown as T, exitCode: 0 };
         }
         const r = HarnessApiResponse.pass({ ...summary, passed: 1, warnings: drifts.length }, result);
-        return { status: 'pass', errors: [], summary: r.summary, data: result as unknown as T, exitCode: 0 };
+        return { status: "pass", errors: [], summary: r.summary, data: result as unknown as T, exitCode: 0 };
       }
 
-      case 'phasegate:status': {
+      case "phasegate:status": {
         const scanResult = await this.ports.artifactScannerPort.scan();
         const liveValidationByLayer: Partial<Record<LayerId, LiveValidationState>> = {};
         try {
@@ -239,12 +247,15 @@ export class CommandDispatchService {
             this.ports.biomeLintPort.runLint(),
             this.ports.validatorExecutionPort.runAllValidators(),
           ]);
-          liveValidationByLayer.L1 = lintResult.passed ? 'pass' : 'fail';
+          liveValidationByLayer.L1 = lintResult.passed ? "pass" : "fail";
           Object.assign(liveValidationByLayer, summarizeLayerResults(validatorResults));
         } catch {
-          liveValidationByLayer.L1 = liveValidationByLayer.L1 ?? 'error';
+          liveValidationByLayer.L1 = liveValidationByLayer.L1 ?? "error";
         }
-        let presetInfo = { name: 'standard' as const, enabledLayers: ['L1', 'L2', 'L3'] as ('L1' | 'L2' | 'L3' | 'L4')[] };
+        let presetInfo = {
+          name: "standard" as const,
+          enabledLayers: ["L1", "L2", "L3"] as ("L1" | "L2" | "L3" | "L4")[],
+        };
         const configPort = this.ports.configQueryPort;
         if (configPort.getPresetInfo) {
           const pi = await configPort.getPresetInfo();
@@ -252,15 +263,19 @@ export class CommandDispatchService {
         } else if (configPort.getConfig) {
           await configPort.getConfig();
         }
-        const [hookHealth, baselineHealth] = await Promise.all([
+        // WI-328 (github#39 残課題): 実効言語と出所を status に載せる。
+        // ポート未実装（後方互換）の場合は languages フィールドを出さない。
+        const [hookHealth, baselineHealth, languages] = await Promise.all([
           configPort.getHookHealth?.(),
           configPort.getBaselineHealth?.(),
+          configPort.getLanguageInfo?.(),
         ]);
         const operationalWarnings: OperationalWarning[] = buildOperationalWarnings(hookHealth, baselineHealth);
         const statusSummary = this.statusDerivationService.derive({
           scanResult,
           presetInfo,
-          configSummary: { configPath: 'phasegate.config.json', lastModified: '', version: '2' },
+          languages,
+          configSummary: { configPath: "phasegate.config.json", lastModified: "", version: "2" },
           phaseGateSummary: { totalStories: 0, passedStories: 0, pendingStories: 0 },
           liveValidationByLayer,
           hookHealth,
@@ -269,60 +284,84 @@ export class CommandDispatchService {
         });
         if (hasEnabledLiveFailure(presetInfo.enabledLayers, liveValidationByLayer)) {
           const errors = statusSummary.layers
-            .filter((layer) => layer.enabled && (layer.liveValidationState === 'fail' || layer.liveValidationState === 'error'))
+            .filter(
+              (layer) =>
+                layer.enabled && (layer.liveValidationState === "fail" || layer.liveValidationState === "error"),
+            )
             .map((layer) => makeError(`Layer ${layer.layerId} live validation ${layer.liveValidationState}`));
           const r = HarnessApiResponse.fail(errors, { ...summary, failed: 1 }, statusSummary);
-          return { status: 'fail', errors: r.errors, summary: r.summary, data: statusSummary as unknown as T, exitCode: 0 };
+          return {
+            status: "fail",
+            errors: r.errors,
+            summary: r.summary,
+            data: statusSummary as unknown as T,
+            exitCode: 0,
+          };
         }
         const r = HarnessApiResponse.pass({ ...summary, passed: 1 }, statusSummary);
-        return { status: 'pass', errors: [], summary: r.summary, data: statusSummary as unknown as T, exitCode: 0 };
+        return { status: "pass", errors: [], summary: r.summary, data: statusSummary as unknown as T, exitCode: 0 };
       }
 
-      case 'phasegate:lint': {
+      case "phasegate:lint": {
         const lintResult = await this.ports.biomeLintPort.runLint();
         if (lintResult.passed) {
           const r = HarnessApiResponse.pass({ ...summary, passed: 1 });
-          return { status: 'pass', errors: [], summary: r.summary, data: undefined, exitCode: 0 };
+          return { status: "pass", errors: [], summary: r.summary, data: undefined, exitCode: 0 };
         }
-        const errors = lintResult.errors.length > 0 ? lintResult.errors : [makeError('Lint failed')];
+        const errors = lintResult.errors.length > 0 ? lintResult.errors : [makeError("Lint failed")];
         const r = HarnessApiResponse.fail(errors, { ...summary, failed: 1 });
-        return { status: 'fail', errors: r.errors, summary: r.summary, data: undefined, exitCode: 1 };
+        return { status: "fail", errors: r.errors, summary: r.summary, data: undefined, exitCode: 1 };
       }
 
-      case 'phasegate:complete-check': {
+      case "phasegate:complete-check": {
         const [validatorResults, lintResult] = await Promise.all([
           this.ports.validatorExecutionPort.runAllValidators(),
           this.ports.biomeLintPort.runLint(),
         ]);
         const allErrors: HarnessError[] = [];
-        for (const v of validatorResults) {
-          if (!v.passed) {
-            const errs = v.errors && v.errors.length > 0 ? v.errors : [makeError(`Validator ${v.validatorId} failed`)];
+        let warningCount = 0;
+        // WI-318 (github#38): ci-check case と同一の CiCheckResult.fromResults() を通して
+        // ADR-017 / WI-260 の severity-aware 集約（isEffectivelyPassed）を適用する。
+        // これにより warning-only failure（例: L2-016 の ungated-legacy marker）が
+        // Stop hook の complete-check 経路でも validate --layer L2 / ci-check と同じく
+        // 実質 pass となる。lint 結果の合流（lint fail → exit 1）は従来どおり維持。
+        // WI-321 (github#38 残課題): warning が summary の件数のみで内容不明だったため、
+        // ci-check case と同じく CiCheckResult を data ペイロードとして pass/fail 双方で返す。
+        // validatorResults が空の場合のみ従来どおり data なし。
+        let result: CiCheckResult | undefined;
+        if (validatorResults.length > 0) {
+          result = CiCheckResult.fromResults(validatorResults);
+          warningCount = result.collectAllErrors().filter((e) => e.severity === "warning").length;
+          for (const v of result.getFailedValidators()) {
+            const errs =
+              v.errors !== undefined && v.errors.length > 0
+                ? v.errors
+                : [makeError(`Validator ${v.validatorId} failed`)];
             allErrors.push(...errs);
           }
         }
         if (!lintResult.passed) {
-          const errs = lintResult.errors.length > 0 ? lintResult.errors : [makeError('Lint failed')];
+          const errs = lintResult.errors.length > 0 ? lintResult.errors : [makeError("Lint failed")];
           allErrors.push(...errs);
         }
         if (allErrors.length === 0) {
-          const r = HarnessApiResponse.pass({ ...summary, passed: 1 });
-          return { status: 'pass', errors: [], summary: r.summary, data: undefined, exitCode: 0 };
+          const r = HarnessApiResponse.pass({ ...summary, passed: 1, warnings: warningCount }, result);
+          return { status: "pass", errors: [], summary: r.summary, data: result as unknown as T, exitCode: 0 };
         }
-        const r = HarnessApiResponse.fail(allErrors, { ...summary, failed: 1 });
-        return { status: 'fail', errors: r.errors, summary: r.summary, data: undefined, exitCode: 1 };
+        const r = HarnessApiResponse.fail(allErrors, { ...summary, failed: 1, warnings: warningCount }, result);
+        return { status: "fail", errors: r.errors, summary: r.summary, data: result as unknown as T, exitCode: 1 };
       }
 
-      case 'phasegate:impact-analysis': {
-        const storyId = args.storyId ?? '';
+      case "phasegate:impact-analysis": {
+        const storyId = args.storyId ?? "";
         const result = await this.ports.impactAnalysisPort.analyze(storyId);
         if (result === null) {
           const errors = [makeError(`Story '${storyId}' not found`)];
           const r = HarnessApiResponse.fail(errors, { ...summary, failed: 1 });
-          return { status: 'fail', errors: r.errors, summary: r.summary, data: undefined, exitCode: 1 };
+          return { status: "fail", errors: r.errors, summary: r.summary, data: undefined, exitCode: 1 };
         }
         const r = HarnessApiResponse.pass({ ...summary, passed: 1 }, result);
-        return { status: 'pass', errors: [], summary: r.summary, data: result as unknown as T, exitCode: 0 };
+        return { status: "pass", errors: [], summary: r.summary, data: result as unknown as T, exitCode: 0 };
       }
 
       default:

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/ci-check-result.ts

@@ -1,5 +1,6 @@
 // @layer domain
 // @unit harness-api
+// @work-item-id WI-307
 // ci-check-result.ts — CiCheckResult Value Object
 
 import type { HarnessError } from "./harness-api-response.js";
@@ -40,12 +41,25 @@ function isEffectivelyPassed(item: ValidatorCheckItem, failOnWarning: boolean):
   return !hasFail;
 }
 
+/**
+ * WI-307: public ci-check projection の `passed` を aggregate policy と一致させる。
+ * skipped は独立した green state のため raw passed を維持し、warning-only failure だけを
+ * failOnWarning=false のとき passed=true に射影する。diagnostic は lossless に保持する。
+ */
+function toPublicValidatorResult(item: ValidatorCheckItem, failOnWarning: boolean): ValidatorCheckItem {
+  return Object.freeze({
+    ...item,
+    passed: item.skipped ? item.passed : isEffectivelyPassed(item, failOnWarning),
+    errors: item.errors === undefined ? undefined : Object.freeze([...item.errors]),
+  });
+}
+
 export class CiCheckResult {
   readonly validatorResults: readonly ValidatorCheckItem[];
   readonly allPassed: boolean;
 
-  private constructor(validatorResults: readonly ValidatorCheckItem[], allPassed: boolean) {
-    this.validatorResults = Object.freeze([...validatorResults]);
+  private constructor(validatorResults: readonly ValidatorCheckItem[], allPassed: boolean, failOnWarning: boolean) {
+    this.validatorResults = Object.freeze(validatorResults.map((item) => toPublicValidatorResult(item, failOnWarning)));
     this.allPassed = allPassed;
     Object.freeze(this);
   }
@@ -63,7 +77,7 @@ export class CiCheckResult {
         `HarnessApiDomainError: allPassed=${props.allPassed} does not match validatorResults state (computed: ${computedAllPassed})`,
       );
     }
-    return new CiCheckResult(props.validatorResults, props.allPassed);
+    return new CiCheckResult(props.validatorResults, props.allPassed, failOnWarning);
   }
 
   static fromResults(validatorResults: readonly ValidatorCheckItem[], failOnWarning = false): CiCheckResult {
@@ -71,7 +85,7 @@ export class CiCheckResult {
       throw new Error("EmptyValidatorResultsError: validatorResults must have at least one item (INV-5)");
     }
     const allPassed = validatorResults.every((r) => isEffectivelyPassed(r, failOnWarning));
-    return new CiCheckResult(validatorResults, allPassed);
+    return new CiCheckResult(validatorResults, allPassed, failOnWarning);
   }
 
   getFailedValidators(): readonly ValidatorCheckItem[] {