phasegate 0.283.0 → 0.335.0

package/scripts/harness/ci-governance/presentation/handlers/templates-handler.ts

@@ -0,0 +1,103 @@
+// @unit ci-governance
+// @layer presentation
+// @work-item-id WI-367
+
+import type { ListTemplatesUseCase } from "../../application/usecases/list-templates-usecase.js";
+import type { ShowTemplateUseCase } from "../../application/usecases/show-template-usecase.js";
+
+export interface TemplatesHandlerResult {
+  readonly exitCode: number;
+  /** stdout に出す内容（空文字なら出力しない） */
+  readonly output: string;
+  /** stderr に出す内容（空文字なら出力しない） */
+  readonly errorOutput: string;
+}
+
+export interface TemplatesListArgs {
+  readonly format?: "human" | "json";
+}
+
+export interface TemplatesShowArgs {
+  readonly name?: string;
+}
+
+const USAGE = "Usage: phasegate templates <list|show <name>>";
+
+export class TemplatesHandler {
+  constructor(
+    private readonly listUseCase: ListTemplatesUseCase,
+    private readonly showUseCase: ShowTemplateUseCase,
+  ) {}
+
+  async list(args: TemplatesListArgs = {}): Promise<TemplatesHandlerResult> {
+    const result = await this.listUseCase.execute();
+
+    if (args.format === "json") {
+      return {
+        exitCode: 0,
+        output: JSON.stringify(result, null, 2),
+        errorOutput: "",
+      };
+    }
+
+    if (result.templates.length === 0) {
+      return {
+        exitCode: 0,
+        output: [
+          "Available templates (0):",
+          "",
+          `  テンプレートディレクトリが見つかりません: ${result.directoryPath}`,
+        ].join("\n"),
+        errorOutput: "",
+      };
+    }
+
+    const lines = [`Available templates (${result.templates.length}):`, ""];
+    for (const entry of result.templates) {
+      lines.push(`  ${entry.name}  (${entry.fileName})`);
+    }
+    lines.push("", "本文を表示: phasegate templates show <name>");
+
+    return { exitCode: 0, output: lines.join("\n"), errorOutput: "" };
+  }
+
+  async show(args: TemplatesShowArgs): Promise<TemplatesHandlerResult> {
+    const rawName = args.name ?? "";
+    if (rawName.length === 0) {
+      return {
+        exitCode: 2,
+        output: "",
+        errorOutput: "Usage: phasegate templates show <name>",
+      };
+    }
+
+    const result = await this.showUseCase.execute(rawName);
+
+    if (result.found) {
+      // テンプレート本文だけを stdout に出す。リダイレクトでそのまま文書として保存できる。
+      return { exitCode: 0, output: result.content, errorOutput: "" };
+    }
+
+    if (result.reason === "invalid-name") {
+      return {
+        exitCode: 2,
+        output: "",
+        errorOutput: [
+          `Invalid template name: ${rawName}`,
+          "テンプレート名は英小文字・数字・_ ・- のみで指定してください（パスは指定できません）。",
+          USAGE,
+        ].join("\n"),
+      };
+    }
+
+    return {
+      exitCode: 2,
+      output: "",
+      errorOutput: [`Template not found: ${rawName}`, `Available: ${result.availableNames.join(", ")}`].join("\n"),
+    };
+  }
+
+  usage(): TemplatesHandlerResult {
+    return { exitCode: 2, output: "", errorOutput: USAGE };
+  }
+}

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

@@ -99,6 +99,18 @@ export interface HarnessConfigResolvedDocument {
     allowedCategories: string[];
     maintainedLayers: string[];
     relaxedGates: string[];
+    // WI-377: JSON Schema (v2/v3) は当該キーを許容し preset 解決の deepMerge も
+    // 実行時には保持していたが、型宣言だけが欠けていた。preset 定義側は宣言しないため optional。
+    fullModeRequiredWhen?: {
+      mixedCategories?: boolean;
+      newDomainFile?: boolean;
+      apiContractChange?: boolean;
+    };
+    // WI-372: プロジェクト固有パスのカテゴリ割当（quick-mode unit が消費する）。
+    // preset には既定を持たせず、source config 側でのみ指定する任意項目。
+    // preset 解決の deepMerge は preset 側に無いキーを source からそのまま引き継ぐため、
+    // 明示宣言は WI-377 の preset 解決経路を通しても保持される。
+    categoryOverrides?: Record<string, string[]>;
   };
   phaseDependencies: {
     preset: PhaseDependenciesPresetId;

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

@@ -21,9 +21,9 @@
     }
   },
   "quickMode": {
-    "allowedCategories": ["bugfix"],
-    "maintainedLayers": ["L1", "L2"],
-    "relaxedGates": []
+    "allowedCategories": ["bugfix", "docs", "test", "config"],
+    "maintainedLayers": ["L1", "L2-002", "L2-003", "L2-014", "L3-001"],
+    "relaxedGates": ["L2-001", "L3-002", "L3-003", "L3-004", "L4"]
   },
   "phaseDependencies": {
     "preset": "default",

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

@@ -21,9 +21,9 @@
     }
   },
   "quickMode": {
-    "allowedCategories": ["bugfix"],
-    "maintainedLayers": ["L1", "L2"],
-    "relaxedGates": []
+    "allowedCategories": ["bugfix", "docs", "test", "config"],
+    "maintainedLayers": ["L1", "L2-002", "L2-003", "L2-014", "L3-001"],
+    "relaxedGates": ["L2-001", "L3-002", "L3-003", "L3-004", "L4"]
   },
   "phaseDependencies": {
     "preset": "default",

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

@@ -21,9 +21,9 @@
     }
   },
   "quickMode": {
-    "allowedCategories": ["bugfix"],
-    "maintainedLayers": ["L1", "L2"],
-    "relaxedGates": []
+    "allowedCategories": ["bugfix", "docs", "test", "config"],
+    "maintainedLayers": ["L1", "L2-002", "L2-003", "L2-014", "L3-001"],
+    "relaxedGates": ["L2-001", "L3-002", "L3-003", "L3-004", "L4"]
   },
   "phaseDependencies": {
     "preset": "default",

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

@@ -5,6 +5,20 @@
   "required": [
     "project"
   ],
+  "$defs": {
+    "changeCategory": {
+      "type": "string",
+      "enum": ["bugfix", "docs", "test", "config", "feature", "domain", "api"]
+    },
+    "categoryOverrideGlobs": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "uniqueItems": true
+    }
+  },
   "properties": {
     "project": {
       "type": "object",
@@ -160,9 +174,10 @@
       "additionalProperties": false,
       "properties": {
         "allowedCategories": {
+          "description": "Quick Mode を通過させる ChangeCategory。7 値の enum で、未知値は設定エラーとして拒否される。",
           "type": "array",
           "items": {
-            "type": "string"
+            "$ref": "#/$defs/changeCategory"
           },
           "uniqueItems": true
         },
@@ -194,6 +209,34 @@
               "type": "boolean"
             }
           }
+        },
+        "categoryOverrides": {
+          "description": "プロジェクト固有パスを任意の ChangeCategory へ割り当てる glob ルール。",
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "bugfix": {
+              "$ref": "#/$defs/categoryOverrideGlobs"
+            },
+            "docs": {
+              "$ref": "#/$defs/categoryOverrideGlobs"
+            },
+            "test": {
+              "$ref": "#/$defs/categoryOverrideGlobs"
+            },
+            "config": {
+              "$ref": "#/$defs/categoryOverrideGlobs"
+            },
+            "feature": {
+              "$ref": "#/$defs/categoryOverrideGlobs"
+            },
+            "domain": {
+              "$ref": "#/$defs/categoryOverrideGlobs"
+            },
+            "api": {
+              "$ref": "#/$defs/categoryOverrideGlobs"
+            }
+          }
         }
       }
     },

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

@@ -13,6 +13,18 @@
     "decisionSignal": {
       "type": "string",
       "enum": ["business-rule-branch", "validation-rule", "error-construction", "state-transition", "policy-selection"]
+    },
+    "changeCategory": {
+      "type": "string",
+      "enum": ["bugfix", "docs", "test", "config", "feature", "domain", "api"]
+    },
+    "categoryOverrideGlobs": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "uniqueItems": true
     }
   },
   "properties": {
@@ -170,9 +182,10 @@
       "additionalProperties": false,
       "properties": {
         "allowedCategories": {
+          "description": "Quick Mode を通過させる ChangeCategory。7 値の enum で、未知値は設定エラーとして拒否される。",
           "type": "array",
           "items": {
-            "type": "string"
+            "$ref": "#/$defs/changeCategory"
           },
           "uniqueItems": true
         },
@@ -204,6 +217,34 @@
               "type": "boolean"
             }
           }
+        },
+        "categoryOverrides": {
+          "description": "プロジェクト固有パスを任意の ChangeCategory へ割り当てる glob ルール。組み込み分類より先に評価されるが、組み込みが domain / api のファイルは降格できない。",
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "bugfix": {
+              "$ref": "#/$defs/categoryOverrideGlobs"
+            },
+            "docs": {
+              "$ref": "#/$defs/categoryOverrideGlobs"
+            },
+            "test": {
+              "$ref": "#/$defs/categoryOverrideGlobs"
+            },
+            "config": {
+              "$ref": "#/$defs/categoryOverrideGlobs"
+            },
+            "feature": {
+              "$ref": "#/$defs/categoryOverrideGlobs"
+            },
+            "domain": {
+              "$ref": "#/$defs/categoryOverrideGlobs"
+            },
+            "api": {
+              "$ref": "#/$defs/categoryOverrideGlobs"
+            }
+          }
         }
       }
     },

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

@@ -1,6 +1,6 @@
 // @layer domain
 // @unit harness-api
-// @work-item-id WI-108 / WI-114, WI-186, WI-318, WI-321, WI-328
+// @work-item-id WI-108 / WI-114, WI-186, WI-318, WI-321, WI-328, WI-339
 // command-dispatch-service.ts — CommandDispatchService Domain Service
 
 import type { ArtifactScannerPort } from "../ports/artifact-scanner-port.js";
@@ -10,7 +10,7 @@ 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 { CiCheckResult, type ValidatorCheckItem } 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 {
@@ -76,6 +76,15 @@ function summarizeLayerResults(
   return result;
 }
 
+/**
+ * WI-339: status の layer 集計へ渡す前に、ci-check / complete-check と同じ
+ * CiCheckResult 投影で raw passed を実効 passed に正規化する。
+ * failOnWarning は既存 harness-api 経路と同じ既定値 false を使用する。
+ */
+function toEffectiveValidatorResults(items: readonly ValidatorCheckItem[]): readonly ValidatorCheckItem[] {
+  return items.length === 0 ? items : CiCheckResult.fromResults(items).validatorResults;
+}
+
 function hasEnabledLiveFailure(
   enabledLayers: readonly LayerId[],
   liveValidationByLayer: Partial<Record<LayerId, LiveValidationState>>,
@@ -248,7 +257,7 @@ export class CommandDispatchService {
             this.ports.validatorExecutionPort.runAllValidators(),
           ]);
           liveValidationByLayer.L1 = lintResult.passed ? "pass" : "fail";
-          Object.assign(liveValidationByLayer, summarizeLayerResults(validatorResults));
+          Object.assign(liveValidationByLayer, summarizeLayerResults(toEffectiveValidatorResults(validatorResults)));
         } catch {
           liveValidationByLayer.L1 = liveValidationByLayer.L1 ?? "error";
         }

package/scripts/harness/harness-api/domain/value-objects/ci-check-result.ts

@@ -1,8 +1,10 @@
 // @layer domain
 // @unit harness-api
 // @work-item-id WI-307
+// @work-item-id WI-332
 // ci-check-result.ts — CiCheckResult Value Object
 
+import { isEffectivelyPassed } from "../../../validator-system/domain/services/effective-severity-policy.js";
 import type { HarnessError } from "./harness-api-response.js";
 
 export interface ValidatorCheckItem {
@@ -19,28 +21,6 @@ export interface CiCheckResultProps {
   failOnWarning?: boolean;
 }
 
-/**
- * WI-260 / ADR-017: validator 1件が「実質 pass」か判定する severity-aware ルール。
- * `validate` 経路の AggregateValidationResultsUseCase と同一の判定式を harness-api の
- * domain VO 側に持たせ、ci-check と validate の集約挙動を一致させる（レイヤー越境回避のため
- * usecase を直接 import せず判定ロジックを共有）。
- *
- * - skipped: 実質 pass
- * - passed=true: 実質 pass
- * - passed=false かつ error severity（!= warning）を含む: fail
- * - passed=false かつ errors=[]（severity 判定不能）: 安全側に倒して fail
- * - passed=false かつ warning のみ: failOnWarning=false（既定）で実質 pass、true で fail
- */
-function isEffectivelyPassed(item: ValidatorCheckItem, failOnWarning: boolean): boolean {
-  if (item.skipped || item.passed) return true;
-  const errors = item.errors ?? [];
-  const hasNonWarningError = errors.some((e) => e.severity !== "warning");
-  const hasWarnings = errors.some((e) => e.severity === "warning");
-  const isEmptyFail = errors.length === 0;
-  const hasFail = isEmptyFail || hasNonWarningError || (failOnWarning && hasWarnings);
-  return !hasFail;
-}
-
 /**
  * WI-307: public ci-check projection の `passed` を aggregate policy と一致させる。
  * skipped は独立した green state のため raw passed を維持し、warning-only failure だけを

package/scripts/harness/harness-api/domain/value-objects/known-harness-commands.ts

@@ -1,6 +1,6 @@
 // @unit harness-api
 // @layer domain
-// @work-item-id WI-250, WI-291, WI-296
+// @work-item-id WI-250, WI-291, WI-296, WI-367, WI-368
 // known-harness-commands.ts — CLI 実サーフェスの canonical 既知コマンド一覧
 //
 // main.ts の CLI dispatch（`switch (command)`）が受理する全トップレベルコマンド名の
@@ -70,6 +70,7 @@ export const KNOWN_HARNESS_COMMANDS: readonly string[] = Object.freeze([
   "regression:run-k14-k15",
   "render-errors",
   "scaffold-design",
+  "scaffold-inception",
   "scaffold-wi",
   "session",
   "setup:agent",
@@ -80,6 +81,7 @@ export const KNOWN_HARNESS_COMMANDS: readonly string[] = Object.freeze([
   "skill:validate-structure",
   "skills",
   "status",
+  "templates",
   "uninstall",
   "update-skills",
   "validate",

package/scripts/harness/harness-error/application/dto/create-harness-error-input.ts

@@ -8,11 +8,13 @@ export interface CreateHarnessErrorInput {
   readonly code: string;
   readonly message: string;
   readonly suggestion: string;
-  readonly severity?: 'error' | 'warning';
+  readonly severity?: "error" | "warning";
   readonly adrRef?: string;
   readonly fixExample?: string;
   readonly validatorId: string;
   readonly suggestedSkill?: string;
   readonly scaffoldCommand?: string;
   readonly templatePath?: string;
+  /** WI-335: 修復方式分類。省略時は ErrorDefinition の既定（未定義なら manual 扱い）。 */
+  readonly remediationType?: "mechanical" | "ai-assisted" | "manual";
 }

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

@@ -3,7 +3,7 @@
 
 export interface HarnessErrorContract {
   readonly code: string;
-  readonly severity: 'error' | 'warning';
+  readonly severity: "error" | "warning";
   readonly message: string;
   readonly suggestion: string;
   readonly adr_ref?: string;
@@ -11,4 +11,6 @@ export interface HarnessErrorContract {
   readonly suggested_skill?: string;
   readonly scaffold_command?: string;
   readonly template_path?: string;
+  /** WI-335: 修復方式分類（mechanical / ai-assisted / manual）。未設定は manual 扱い。 */
+  readonly remediation_type?: "mechanical" | "ai-assisted" | "manual";
 }

package/scripts/harness/harness-error/application/mappers/harness-error-contract-mapper.ts

@@ -4,8 +4,9 @@
  *
  * HarnessErrorContract への投影Mapper
  */
-import type { HarnessErrorContract } from '../dto/harness-error-contract.js';
-import type { HarnessError } from '../../domain/value-objects/harness-error.js';
+
+import type { HarnessError } from "../../domain/value-objects/harness-error.js";
+import type { HarnessErrorContract } from "../dto/harness-error-contract.js";
 
 export class HarnessErrorContractMapper {
   toReadonlyContract(harnessError: HarnessError): Readonly<HarnessErrorContract> {
@@ -14,21 +15,12 @@ export class HarnessErrorContractMapper {
       severity: harnessError.severity.toString(),
       message: harnessError.message,
       suggestion: harnessError.suggestion,
-      ...(harnessError.adrRef !== null
-        ? { adr_ref: harnessError.adrRef.toString() }
-        : {}),
-      ...(harnessError.fixExample !== null
-        ? { fix_example: harnessError.fixExample.toString() }
-        : {}),
-      ...(harnessError.suggestedSkill !== null
-        ? { suggested_skill: harnessError.suggestedSkill }
-        : {}),
-      ...(harnessError.scaffoldCommand !== null
-        ? { scaffold_command: harnessError.scaffoldCommand }
-        : {}),
-      ...(harnessError.templatePath !== null
-        ? { template_path: harnessError.templatePath }
-        : {}),
+      ...(harnessError.adrRef !== null ? { adr_ref: harnessError.adrRef.toString() } : {}),
+      ...(harnessError.fixExample !== null ? { fix_example: harnessError.fixExample.toString() } : {}),
+      ...(harnessError.suggestedSkill !== null ? { suggested_skill: harnessError.suggestedSkill } : {}),
+      ...(harnessError.scaffoldCommand !== null ? { scaffold_command: harnessError.scaffoldCommand } : {}),
+      ...(harnessError.templatePath !== null ? { template_path: harnessError.templatePath } : {}),
+      ...(harnessError.remediationType !== null ? { remediation_type: harnessError.remediationType } : {}),
     };
 
     return Object.freeze(contract);

package/scripts/harness/harness-error/application/usecases/create-harness-error-use-case.ts

@@ -4,10 +4,11 @@
  *
  * 単一draftを HarnessErrorContract へ変換するUseCase
  */
-import type { CreateHarnessErrorInput } from '../dto/create-harness-error-input.js';
-import type { HarnessErrorContract } from '../dto/harness-error-contract.js';
-import type { HarnessErrorContractMapper } from '../mappers/harness-error-contract-mapper.js';
-import type { HarnessErrorFactory } from '../../domain/services/harness-error-factory.js';
+
+import type { HarnessErrorFactory } from "../../domain/services/harness-error-factory.js";
+import type { CreateHarnessErrorInput } from "../dto/create-harness-error-input.js";
+import type { HarnessErrorContract } from "../dto/harness-error-contract.js";
+import type { HarnessErrorContractMapper } from "../mappers/harness-error-contract-mapper.js";
 
 export interface CreateHarnessErrorUseCaseDeps {
   readonly harnessErrorFactory: HarnessErrorFactory;
@@ -23,9 +24,7 @@ export class CreateHarnessErrorUseCase {
     this.contractMapper = deps.contractMapper;
   }
 
-  async execute(
-    input: CreateHarnessErrorInput
-  ): Promise<Readonly<HarnessErrorContract>> {
+  async execute(input: CreateHarnessErrorInput): Promise<Readonly<HarnessErrorContract>> {
     const harnessError = await this.harnessErrorFactory.create({
       code: input.code,
       message: input.message,
@@ -37,6 +36,7 @@ export class CreateHarnessErrorUseCase {
       suggestedSkill: input.suggestedSkill,
       scaffoldCommand: input.scaffoldCommand,
       templatePath: input.templatePath,
+      remediationType: input.remediationType,
     });
 
     return this.contractMapper.toReadonlyContract(harnessError);

package/scripts/harness/harness-error/domain/services/harness-error-factory.ts

@@ -5,33 +5,36 @@
  * HarnessErrorFactory ドメインサービス
  * ErrorDefinitionRegistry と Domain ポートを組み合わせて HarnessError を生成する唯一の入口
  */
-import { AdrReferenceNotFoundError } from '../errors/adr-reference-not-found-error.js';
-import { EmptyMessageError } from '../errors/empty-message-error.js';
-import { EmptySuggestionError } from '../errors/empty-suggestion-error.js';
-import { InvalidFixExampleError } from '../errors/invalid-fix-example-error.js';
-import { MissingAdrRefError } from '../errors/missing-adr-ref-error.js';
-import { MissingFixExampleError } from '../errors/missing-fix-example-error.js';
-import type { AdrExistenceCheckerPort } from '../ports/adr-existence-checker-port.js';
-import type { FixExampleValidatorPort } from '../ports/fix-example-validator-port.js';
-import { AdrRef } from '../value-objects/adr-ref.js';
-import { ErrorCode } from '../value-objects/error-code.js';
-import { FixExample } from '../value-objects/fix-example.js';
-import { HarnessError } from '../value-objects/harness-error.js';
-import { Severity } from '../value-objects/severity.js';
-import type { ErrorDefinitionRegistry } from './error-definition-registry.js';
-import type { SeverityContractEnforcer } from './severity-contract-enforcer.js';
+import { AdrReferenceNotFoundError } from "../errors/adr-reference-not-found-error.js";
+import { EmptyMessageError } from "../errors/empty-message-error.js";
+import { EmptySuggestionError } from "../errors/empty-suggestion-error.js";
+import { InvalidFixExampleError } from "../errors/invalid-fix-example-error.js";
+import { MissingAdrRefError } from "../errors/missing-adr-ref-error.js";
+import { MissingFixExampleError } from "../errors/missing-fix-example-error.js";
+import type { AdrExistenceCheckerPort } from "../ports/adr-existence-checker-port.js";
+import type { FixExampleValidatorPort } from "../ports/fix-example-validator-port.js";
+import { AdrRef } from "../value-objects/adr-ref.js";
+import { ErrorCode } from "../value-objects/error-code.js";
+import { FixExample } from "../value-objects/fix-example.js";
+import { HarnessError } from "../value-objects/harness-error.js";
+import type { RemediationType } from "../value-objects/remediation-type.js";
+import { Severity } from "../value-objects/severity.js";
+import type { ErrorDefinitionRegistry } from "./error-definition-registry.js";
+import type { SeverityContractEnforcer } from "./severity-contract-enforcer.js";
 
 export interface CreateHarnessErrorParams {
   readonly code: string;
   readonly message: string;
   readonly suggestion: string;
   readonly validatorId: string;
-  readonly requestedSeverity?: 'error' | 'warning';
+  readonly requestedSeverity?: "error" | "warning";
   readonly adrRef?: string | null;
   readonly fixExample?: string | null;
   readonly suggestedSkill?: string | null;
   readonly scaffoldCommand?: string | null;
   readonly templatePath?: string | null;
+  /** WI-335: suggestion の修復方式分類。省略時は ErrorDefinition の既定に従う。 */
+  readonly remediationType?: RemediationType | null;
 }
 
 export interface HarnessErrorFactoryDeps {
@@ -68,18 +71,14 @@ export class HarnessErrorFactory {
     const definition = this.registry.getDefinition(errorCode);
 
     // 3. severity 解決
-    const requestedSeverity = input.requestedSeverity
-      ? Severity.create(input.requestedSeverity)
-      : undefined;
-    const effectiveSeverity =
-      this.severityContractEnforcer.resolveEffectiveSeverity(
-        requestedSeverity,
-        definition.defaultSeverity
-      );
+    const requestedSeverity = input.requestedSeverity ? Severity.create(input.requestedSeverity) : undefined;
+    const effectiveSeverity = this.severityContractEnforcer.resolveEffectiveSeverity(
+      requestedSeverity,
+      definition.defaultSeverity,
+    );
 
     // 4. ADR 解決
-    const explicitAdrRef =
-      input.adrRef != null ? AdrRef.create(input.adrRef) : undefined;
+    const explicitAdrRef = input.adrRef != null ? AdrRef.create(input.adrRef) : undefined;
     const resolvedAdrRef = definition.resolveAdrRef(explicitAdrRef);
 
     // 5. ADR 必須チェック
@@ -96,12 +95,8 @@ export class HarnessErrorFactory {
     }
 
     // 7. fix_example 解決
-    const explicitFixExample =
-      input.fixExample != null
-        ? FixExample.create(input.fixExample)
-        : undefined;
-    const resolvedFixExample =
-      definition.resolveFixExample(explicitFixExample);
+    const explicitFixExample = input.fixExample != null ? FixExample.create(input.fixExample) : undefined;
+    const resolvedFixExample = definition.resolveFixExample(explicitFixExample);
 
     // 8. fix_example 必須チェック
     if (definition.requiresFixExample() && resolvedFixExample === null) {
@@ -117,7 +112,7 @@ export class HarnessErrorFactory {
       });
       if (!validationResult.passed) {
         throw new InvalidFixExampleError(
-          `fix_example の検証に失敗しました (code=${errorCode.toString()}): ${validationResult.reason}`
+          `fix_example の検証に失敗しました (code=${errorCode.toString()}): ${validationResult.reason}`,
         );
       }
     }
@@ -126,6 +121,7 @@ export class HarnessErrorFactory {
     const resolvedSuggestedSkill = definition.resolveSuggestedSkill(input.suggestedSkill);
     const resolvedScaffoldCommand = definition.resolveScaffoldCommand(input.scaffoldCommand);
     const resolvedTemplatePath = definition.resolveTemplatePath(input.templatePath);
+    const resolvedRemediationType = definition.resolveRemediationType(input.remediationType);
 
     // 11. HarnessError 生成と凍結
     const harnessError = new HarnessError({
@@ -138,6 +134,7 @@ export class HarnessErrorFactory {
       suggestedSkill: resolvedSuggestedSkill,
       scaffoldCommand: resolvedScaffoldCommand,
       templatePath: resolvedTemplatePath,
+      remediationType: resolvedRemediationType,
     });
 
     return Object.freeze(harnessError);