phasegate 0.160.21 → 0.162.0

package/scripts/harness/config-foundation/application/mappers/validator-system-config-mapper.ts

@@ -3,6 +3,7 @@
  * @unit config-foundation
  * @work-item-id WI-133 / WI-156
  * @work-item-id WI-217
+ * @work-item-id WI-212
  */
 import type { HarnessConfigV2 } from '../../domain/harness-config.js';
 
@@ -33,7 +34,10 @@ export function toValidatorSystemConfig(resolvedConfig: HarnessConfigV2 | undefi
     : l4Validators;
 
   return {
-    project: { preset: resolvedConfig.project.preset },
+    project: {
+      preset: resolvedConfig.project.preset,
+      languages: resolvedConfig.project.languages ?? ['typescript'],
+    },
     paths: {
       designDocs: resolvedConfig.paths.designDocs,
       inceptionDocs: resolvedConfig.paths.inceptionDocs,
@@ -44,6 +48,7 @@ export function toValidatorSystemConfig(resolvedConfig: HarnessConfigV2 | undefi
         enabled: resolvedConfig.layers.L3.enabled,
         validators: l3Validators.length > 0 ? l3Validators : ['L3-001', 'L3-002', 'L3-003', 'L3-004'],
         coverageThreshold: resolvedConfig.layers.L3.coverageThreshold,
+        requirementMatrixPath: resolvedConfig.layers.L3.requirementMatrixPath,
       },
       L4: {
         enabled: resolvedConfig.layers.L4.enabled,

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

@@ -2,6 +2,8 @@
  * @layer domain
  * @unit config-foundation
  * @work-item-id WI-012
+ * @work-item-id WI-212
+ * @work-item-id WI-219
  */
 import { ConfigFoundationDomainError } from './errors/config-foundation-domain-error.js';
 import { ConfigValidationError } from './errors/config-validation-error.js';
@@ -30,6 +32,7 @@ import type {
 export type LayerId = 'L1' | 'L2' | 'L3' | 'L4';
 export type PresetId = 'minimal' | 'standard' | 'strict';
 export type PlanningModeValue = 'interactive' | 'embedded-qa' | 'manual';
+export type ModelDelegationPolicy = 'delegate-sonnet' | 'none';
 export type { PhaseDependenciesPresetId };
 type DeepPartial<T> = {
   [K in keyof T]?: T[K] extends Array<infer TItem>
@@ -43,6 +46,7 @@ export interface HarnessConfigSourceDocument {
   project: {
     name: string;
     preset: PresetId;
+    languages?: string[];
   };
   layers: DeepPartial<HarnessConfigResolvedDocument['layers']>;
   quickMode: Partial<HarnessConfigResolvedDocument['quickMode']>;
@@ -54,6 +58,7 @@ export interface HarnessConfigSourceDocument {
   ci?: HarnessConfigResolvedDocument['ci'];
   validate?: HarnessConfigResolvedDocument['validate'];
   preCommit?: Partial<HarnessConfigResolvedDocument['preCommit']>;
+  modelRouting?: HarnessConfigResolvedDocument['modelRouting'];
   phase2Extensions?: HarnessConfigResolvedDocument['phase2Extensions'];
   architecture?: ArchitectureConfigSource;
 }
@@ -62,6 +67,7 @@ export interface HarnessConfigResolvedDocument {
   project: {
     name: string;
     preset: PresetId;
+    languages?: string[];
   };
   layers: {
     L1: {
@@ -76,6 +82,7 @@ export interface HarnessConfigResolvedDocument {
       enabled: boolean;
       validators: string[];
       coverageThreshold: number;
+      requirementMatrixPath?: string;
     };
     L4: {
       enabled: boolean;
@@ -125,6 +132,9 @@ export interface HarnessConfigResolvedDocument {
   preCommit?: {
     implementationExtensions: string[];
   };
+  modelRouting?: {
+    delegation: ModelDelegationPolicy;
+  };
   phase2Extensions?: {
     initialCreationExpirationRules?: Array<{
       ruleId: string;

package/scripts/harness/config-foundation/domain/services/preset-resolution-service.ts

@@ -1,6 +1,7 @@
 /**
  * @layer domain
  * @unit config-foundation
+ * @work-item-id WI-212
  */
 import { ConfigFoundationDomainError } from '../errors/config-foundation-domain-error.js';
 import type {
@@ -152,6 +153,7 @@ export class PresetResolutionService {
       project: {
         name: sourceDocument.project.name,
         preset: sourceDocument.project.preset,
+        languages: sourceDocument.project.languages ?? ['typescript'],
       },
       layers: deepMerge(presetDefinition.layers, sourceDocument.layers, 'layers'),
       quickMode: deepMerge(

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

@@ -10,12 +10,14 @@ interface L3ConfigProps {
   readonly enabled: boolean;
   readonly validators: string[];
   readonly coverageThreshold: number;
+  readonly requirementMatrixPath?: string;
 }
 
 export class L3Config {
   readonly enabled: boolean;
   readonly validators: readonly string[];
   readonly coverageThreshold: number;
+  readonly requirementMatrixPath?: string;
 
   constructor(props: L3ConfigProps) {
     if (props.coverageThreshold < 0) {
@@ -37,6 +39,7 @@ export class L3Config {
     this.enabled = props.enabled;
     this.validators = Object.freeze([...props.validators]);
     this.coverageThreshold = props.coverageThreshold;
+    this.requirementMatrixPath = props.requirementMatrixPath;
     Object.freeze(this);
   }
 
@@ -44,6 +47,7 @@ export class L3Config {
     enabled: boolean;
     validators: string[];
     coverageThreshold: number;
+    requirementMatrixPath?: string;
   }): L3Config {
     return new L3Config(raw);
   }

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

@@ -13,7 +13,7 @@ import { L4Config } from './l4-config.js';
 interface ResolvedLayersDocument {
   L1: { enabled: boolean; rules: Record<string, string> };
   L2: { enabled: boolean; validators: string[] };
-  L3: { enabled: boolean; validators: string[]; coverageThreshold: number };
+  L3: { enabled: boolean; validators: string[]; coverageThreshold: number; requirementMatrixPath?: string };
   L4: { enabled: boolean; validators: string[]; schedule: string };
 }
 

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

@@ -1,6 +1,7 @@
 /**
  * @layer domain
  * @unit config-foundation
+ * @work-item-id WI-212
  *
  * ProjectConfig値オブジェクト - プロジェクト名とPresetを保持する
  */
@@ -10,35 +11,49 @@ import { Preset } from './preset.js';
 interface ProjectConfigProps {
   readonly name: string;
   readonly preset: Preset;
+  readonly languages?: readonly string[];
 }
 
 export class ProjectConfig {
   readonly name: string;
   readonly preset: Preset;
+  readonly languages: readonly string[];
 
   constructor(props: ProjectConfigProps) {
     if (!props.name || props.name.trim() === '') {
       throw new ConfigValidationError('ProjectConfig: name must not be empty');
     }
+    const sourceLanguages = props.languages ?? ['typescript'];
+    if (sourceLanguages.length === 0) {
+      throw new ConfigValidationError('ProjectConfig: languages must not be empty');
+    }
+    const normalizedLanguages = sourceLanguages.map((language) => language.trim()).filter((language) => language.length > 0);
+    if (normalizedLanguages.length !== sourceLanguages.length) {
+      throw new ConfigValidationError('ProjectConfig: languages must contain non-empty strings');
+    }
     this.name = props.name;
     this.preset = props.preset;
+    this.languages = Object.freeze([...normalizedLanguages]);
     Object.freeze(this);
   }
 
-  static create(raw: { name: string; preset: string }): ProjectConfig {
+  static create(raw: { name: string; preset: string; languages?: readonly string[] }): ProjectConfig {
     const preset = Preset.create(raw.preset);
-    return new ProjectConfig({ name: raw.name, preset });
+    return new ProjectConfig({ name: raw.name, preset, languages: raw.languages ?? ['typescript'] });
   }
 
   rename(name: string): ProjectConfig {
-    return new ProjectConfig({ name, preset: this.preset });
+    return new ProjectConfig({ name, preset: this.preset, languages: this.languages });
   }
 
   changePreset(preset: Preset): ProjectConfig {
-    return new ProjectConfig({ name: this.name, preset });
+    return new ProjectConfig({ name: this.name, preset, languages: this.languages });
   }
 
   equals(other: ProjectConfig): boolean {
-    return this.name === other.name && this.preset.equals(other.preset);
+    return this.name === other.name
+      && this.preset.equals(other.preset)
+      && this.languages.length === other.languages.length
+      && this.languages.every((language, index) => language === other.languages[index]);
   }
 }

package/scripts/harness/config-foundation/infrastructure/presets/minimal.json

@@ -11,7 +11,8 @@
     "L3": {
       "enabled": false,
       "validators": ["consistency"],
-      "coverageThreshold": 0
+      "coverageThreshold": 0,
+      "requirementMatrixPath": ".harness/requirement-test-matrix.json"
     },
     "L4": {
       "enabled": false,

package/scripts/harness/config-foundation/infrastructure/presets/standard.json

@@ -11,7 +11,8 @@
     "L3": {
       "enabled": true,
       "validators": ["consistency", "test-quality"],
-      "coverageThreshold": 90
+      "coverageThreshold": 90,
+      "requirementMatrixPath": ".harness/requirement-test-matrix.json"
     },
     "L4": {
       "enabled": false,

package/scripts/harness/config-foundation/infrastructure/presets/strict.json

@@ -11,7 +11,8 @@
     "L3": {
       "enabled": true,
       "validators": ["consistency", "test-quality"],
-      "coverageThreshold": 95
+      "coverageThreshold": 95,
+      "requirementMatrixPath": ".harness/requirement-test-matrix.json"
     },
     "L4": {
       "enabled": true,

package/scripts/harness/config-foundation/infrastructure/schemas/harness-config-v2.schema.json

@@ -33,6 +33,15 @@
             "strict"
           ]
         },
+        "languages": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
         "paths": {
           "type": "object",
           "additionalProperties": false,
@@ -117,6 +126,10 @@
               "type": "number",
               "minimum": 0,
               "maximum": 100
+            },
+            "requirementMatrixPath": {
+              "type": "string",
+              "minLength": 1
             }
           }
         },
@@ -335,20 +348,21 @@
                 "type": "object",
                 "additionalProperties": false,
                 "required": [
-                  "unitId",
-                  "artifacts"
+                  "inception",
+                  "product",
+                  "required"
                 ],
                 "properties": {
-                  "unitId": {
+                  "inception": {
                     "type": "string",
                     "minLength": 1
                   },
-                  "artifacts": {
-                    "type": "array",
-                    "items": {
-                      "type": "string",
-                      "minLength": 1
-                    }
+                  "product": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "required": {
+                    "type": "boolean"
                   }
                 }
               }
@@ -474,6 +488,22 @@
         }
       }
     },
+    "modelRouting": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "delegation"
+      ],
+      "properties": {
+        "delegation": {
+          "type": "string",
+          "enum": [
+            "delegate-sonnet",
+            "none"
+          ]
+        }
+      }
+    },
     "protectedFiles": {
       "type": "object",
       "additionalProperties": false,

package/scripts/harness/config-foundation/infrastructure/schemas/harness-config-v3.schema.json

@@ -43,6 +43,15 @@
             "strict"
           ]
         },
+        "languages": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
         "paths": {
           "type": "object",
           "additionalProperties": false,
@@ -127,6 +136,10 @@
               "type": "number",
               "minimum": 0,
               "maximum": 100
+            },
+            "requirementMatrixPath": {
+              "type": "string",
+              "minLength": 1
             }
           }
         },
@@ -345,20 +358,21 @@
                 "type": "object",
                 "additionalProperties": false,
                 "required": [
-                  "unitId",
-                  "artifacts"
+                  "inception",
+                  "product",
+                  "required"
                 ],
                 "properties": {
-                  "unitId": {
+                  "inception": {
                     "type": "string",
                     "minLength": 1
                   },
-                  "artifacts": {
-                    "type": "array",
-                    "items": {
-                      "type": "string",
-                      "minLength": 1
-                    }
+                  "product": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "required": {
+                    "type": "boolean"
                   }
                 }
               }
@@ -492,6 +506,22 @@
         }
       }
     },
+    "modelRouting": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "delegation"
+      ],
+      "properties": {
+        "delegation": {
+          "type": "string",
+          "enum": [
+            "delegate-sonnet",
+            "none"
+          ]
+        }
+      }
+    },
     "protectedFiles": {
       "type": "object",
       "additionalProperties": false,

package/scripts/harness/harness-api/infrastructure/adapters/phase-dependency-model-query-adapter.ts

@@ -61,8 +61,15 @@ export class PhaseDependencyModelQueryAdapter implements PhaseGateQueryPort {
             }
           }
           return results;
-        } catch {
-          return [];
+        } catch (err) {
+          // Fail-closed: returning [] here would make CheckReadyResult.fromStories treat
+          // "no stories" as an unconditional pass. Surface the error so the dispatcher
+          // reports a non-passing (error) result instead of silently opening the gate.
+          const message = err instanceof Error ? err.message : String(err);
+          console.error(`[harness-api] queryAllStories failed to evaluate phase gates: ${message}`);
+          throw err instanceof Error
+            ? err
+            : new Error(`queryAllStories failed to evaluate phase gates: ${message}`);
         }
       },
 
@@ -91,8 +98,15 @@ export class PhaseDependencyModelQueryAdapter implements PhaseGateQueryPort {
             currentPhase: `PHASE-${result.targetLevel}`,
             completedGates: result.passed ? [`level-${result.targetLevel}`] : [],
           });
-        } catch {
-          return null;
+        } catch (err) {
+          // Fail-closed: returning null here conflates a genuine execution error with
+          // "unit not found" and hides the failure. Surface the error so the dispatcher
+          // reports a non-passing (error) result instead of masking it.
+          const message = err instanceof Error ? err.message : String(err);
+          console.error(`[harness-api] queryUnit failed to evaluate phase gate for '${unitId}': ${message}`);
+          throw err instanceof Error
+            ? err
+            : new Error(`queryUnit failed to evaluate phase gate for '${unitId}': ${message}`);
         }
       },
     };

package/scripts/harness/harness-api/infrastructure/adapters/validator-system-execution-adapter.ts

@@ -10,6 +10,19 @@ import type { DriftItem } from '../../domain/value-objects/drift-report-summary.
 import { toValidatorSystemConfig } from '../../../config-foundation/application/mappers/validator-system-config-mapper.js';
 import { ConfigNotFoundError } from '../../../config-foundation/infrastructure/repositories/file-system-config-repository.js';
 
+/**
+ * validator-system config（toValidatorSystemConfig の出力）から
+ * L3-004 用の requirement-test-matrix.json パスを取り出す。
+ * 未設定・config 不在時は undefined を返し、下流の AC coverage adapter が
+ * 既定値（.harness/requirement-test-matrix.json）へフォールバックする。
+ */
+function extractRequirementMatrixPath(config: object | undefined): string | undefined {
+  if (!config) return undefined;
+  const layers = (config as { layers?: { L3?: { requirementMatrixPath?: unknown } } }).layers;
+  const path = layers?.L3?.requirementMatrixPath;
+  return typeof path === 'string' && path.length > 0 ? path : undefined;
+}
+
 // Override interface preserved for testing
 export interface IValidatorSystemStub {
   runL3Validators(): Promise<ValidatorCheckItem[]>;
@@ -40,8 +53,12 @@ export class ValidatorSystemExecutionAdapter implements ValidatorExecutionPort {
     return {
       async runL3Validators(): Promise<ValidatorCheckItem[]> {
         const { createValidatorSystemModule } = await import('../../../validator-system/composition-root.js');
-        const mod = createValidatorSystemModule(await loadValidatorSystemConfig());
-        const results = await mod.runL3ValidatorsUseCase.execute({ targetPaths: [] });
+        const config = await loadValidatorSystemConfig();
+        const mod = createValidatorSystemModule(config);
+        const results = await mod.runL3ValidatorsUseCase.execute({
+          targetPaths: [],
+          requirementMatrixPath: extractRequirementMatrixPath(config),
+        });
         return results.map((r) => ({
           validatorId: r.validatorId,
           passed: r.passed,
@@ -52,8 +69,14 @@ export class ValidatorSystemExecutionAdapter implements ValidatorExecutionPort {
 
       async runAllValidators(): Promise<ValidatorCheckItem[]> {
         const { createValidatorSystemModule } = await import('../../../validator-system/composition-root.js');
-        const mod = createValidatorSystemModule(await loadValidatorSystemConfig());
-        const report = await mod.runFullValidationUseCase.execute({ targetPaths: [], unitName: '', currentPhase: '' });
+        const config = await loadValidatorSystemConfig();
+        const mod = createValidatorSystemModule(config);
+        const report = await mod.runFullValidationUseCase.execute({
+          targetPaths: [],
+          unitName: '',
+          currentPhase: '',
+          requirementMatrixPath: extractRequirementMatrixPath(config),
+        });
         return report.results.map((r) => ({
           validatorId: r.validatorId,
           passed: r.passed,

package/scripts/harness/installation/application/ports/model-delegation-port.ts

@@ -0,0 +1,10 @@
+// @unit installation
+// @layer application
+// @work-item-id WI-219
+
+export type ModelDelegationPolicy = "delegate-sonnet" | "none";
+
+export interface ModelDelegationPort {
+  readPolicy(projectRoot: string): Promise<ModelDelegationPolicy>;
+  renderSkill(content: string, policy: ModelDelegationPolicy): string;
+}