phasegate 0.315.0 → 0.340.0

package/scripts/harness/phase-dependency-model/domain/ports/plan-document-reader-port.ts

@@ -1,16 +1,28 @@
 /**
  * @layer domain
  * @unit phase-dependency-model
+ * @work-item-id WI-369
  */
 
+import type { PathRoots } from '../values/artifact.js';
 import type { PhaseNode } from '../values/phase-node.js';
 import type { PlanEvidence } from '../values/plan-evidence.js';
 import type { PlanningMode } from '../values/planning-mode.js';
 
 export interface PlanDocumentReaderPort {
+  /**
+   * plan 文書の存在と QA evidence を読む。
+   *
+   * `pathRoots` は `phasegate.config.json` の `paths` を解決したもの。
+   * 省略時は既定ルート（`docs/inception` / `docs/product/construction`）を使う。
+   * WI-369: これを渡さないと `paths.inceptionDocs` を移設した PJ で
+   * plan 文書だけが既定パスから探され、成果物検査と plan evidence の
+   * 探索先がズレる（成果物は在るのに「plan文書が不足」で落ちる）。
+   */
   readEvidence(
     node: PhaseNode,
     scope: { unitId?: string; storyId?: string },
     expectedMode: PlanningMode,
+    pathRoots?: PathRoots,
   ): Promise<PlanEvidence>;
 }

package/scripts/harness/phase-dependency-model/infrastructure/filesystem/markdown-plan-document-reader.ts

@@ -1,11 +1,13 @@
 /**
  * @layer infrastructure
  * @unit phase-dependency-model
+ * @work-item-id WI-369
  */
 
 import { readFile } from "node:fs/promises";
 import * as path from "node:path";
 import type { PlanDocumentReaderPort } from "../../domain/ports/plan-document-reader-port.js";
+import { DEFAULT_PATH_ROOTS, type PathRoots } from "../../domain/values/artifact.js";
 import type { PhaseNode } from "../../domain/values/phase-node.js";
 import { PlanEvidence } from "../../domain/values/plan-evidence.js";
 import type { PlanningMode } from "../../domain/values/planning-mode.js";
@@ -41,6 +43,7 @@ export class MarkdownPlanDocumentReader implements PlanDocumentReaderPort {
     node: PhaseNode,
     scope: { unitId?: string; storyId?: string },
     expectedMode: PlanningMode,
+    pathRoots: PathRoots = DEFAULT_PATH_ROOTS,
   ): Promise<PlanEvidence> {
     const planArtifacts = node.planArtifacts();
 
@@ -55,7 +58,7 @@ export class MarkdownPlanDocumentReader implements PlanDocumentReaderPort {
     const artifact = planArtifacts[0];
     let resolvedPath: string;
     try {
-      resolvedPath = artifact.resolve(scope);
+      resolvedPath = artifact.resolve(scope, pathRoots);
     } catch {
       return PlanEvidence.create({
         exists: false,

package/scripts/harness/quick-mode/application/dto/change-category-classification-contract.ts

@@ -11,6 +11,6 @@ export interface ChangeCategoryClassificationContract {
   readonly dominantCategory: string | null;
   readonly perFile: readonly ChangeCategoryPerFile[];
   readonly fullModeRequired: boolean;
-  readonly rejectionRule?: 'MIXED_CHANGES' | 'NEW_DOMAIN' | 'API_CONTRACT';
+  readonly rejectionRule?: 'CATEGORY_NOT_ALLOWED' | 'MIXED_CHANGES' | 'NEW_DOMAIN' | 'API_CONTRACT';
   readonly rejectionReason?: string;
 }

package/scripts/harness/quick-mode/application/dto/quick-mode-eligibility-contract.ts

@@ -8,6 +8,6 @@
 export interface QuickModeEligibilityContract {
   readonly eligible: boolean;
   readonly reason: string;
-  readonly rejectionRule?: 'MIXED_CHANGES' | 'NEW_DOMAIN' | 'API_CONTRACT';
+  readonly rejectionRule?: 'CATEGORY_NOT_ALLOWED' | 'MIXED_CHANGES' | 'NEW_DOMAIN' | 'API_CONTRACT';
   readonly rejectedFiles?: readonly { filePath: string; changeKind: string }[];
 }

package/scripts/harness/quick-mode/application/usecases/classify-change-category-usecase.ts

@@ -2,6 +2,7 @@
  * @layer application
  * @unit quick-mode
  * @story H10-05
+ * @work-item-id WI-384
  *
  * paths から変更カテゴリを分類し fullModeRequired 判定と理由を返す UseCase
  */
@@ -20,6 +21,7 @@ export interface ClassifyChangeCategoryUseCaseInput {
   readonly paths: readonly string[];
   readonly targetChanges?: readonly {
     readonly filePath: string;
+    readonly changeKind?: ChangeKind;
     readonly beforeContent?: string | null;
     readonly afterContent?: string | null;
   }[];
@@ -94,7 +96,7 @@ export class ClassifyChangeCategoryUseCase {
           // 変更前の内容が無く変更後の内容がある場合は新規作成 (CREATE) とみなす。
           // 以前は無条件で MODIFY 固定だったため、新規 domain/ ファイルが
           // NEW_DOMAIN 判定を回避して quick mode をすり抜けていた。
-          changeKind: beforeContent === null && afterContent !== null ? "CREATE" : "MODIFY",
+          changeKind: targetChange?.changeKind ?? (beforeContent === null && afterContent !== null ? "CREATE" : "MODIFY"),
           beforeContent,
           afterContent,
         });

package/scripts/harness/quick-mode/domain/errors/quick-mode-config-error.ts

@@ -0,0 +1,19 @@
+/**
+ * @layer domain
+ * @unit quick-mode
+ * @work-item-id WI-372
+ *
+ * QuickMode 設定の不変条件違反を表すエラー。
+ *
+ * `quick-mode-config.ts` と `category-override-rules.ts` の双方から参照されるため、
+ * 循環 import を避ける目的で独立ファイルに切り出している。
+ * 後方互換のため `quick-mode-config.ts` からも re-export される。
+ */
+
+export class QuickModeConfigError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = 'QuickModeConfigError';
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+}

package/scripts/harness/quick-mode/domain/services/quick-mode-judgment-engine.ts

@@ -4,10 +4,13 @@
  * @work-item-id WI-204
  * @work-item-id WI-349
  * @work-item-id WI-352
+ * @work-item-id WI-372
+ * @work-item-id WI-390
  *
  * ChangedFile[]をChangeClassificationに変換し、3拒否ルールを評価してQuickModeEligibilityを返すドメインサービス
  */
 
+import { CategoryOverrideRules } from "../value-objects/category-override-rules.js";
 import { ChangeCategory } from "../value-objects/change-category.js";
 import { ChangeClassification } from "../value-objects/change-classification.js";
 import type { ChangedFile } from "../value-objects/changed-file.js";
@@ -15,17 +18,6 @@ import type { QuickModeConfig } from "../value-objects/quick-mode-config.js";
 import { QuickModeEligibility } from "../value-objects/quick-mode-eligibility.js";
 import { isCommentOnlyDiff } from "./comment-only-diff-detector.js";
 
-// リスク順優先度（api > domain > feature > bugfix > test > config > docs）
-const RISK_PRIORITY: Record<string, number> = {
-  api: 6,
-  domain: 5,
-  feature: 4,
-  bugfix: 3,
-  test: 2,
-  config: 1,
-  docs: 0,
-};
-
 // config: リポジトリ直下の bootstrap 設定ファイル（列挙型 allowlist）。
 // これらは unit を持たず、CREATE だと feature に落ちて allowedCategories に
 // 入れる手段がないため greenfield な初期セットアップが恒久的にブロックされていた。
@@ -57,7 +49,7 @@ function isRootBootstrapConfigFile(filePath: string): boolean {
   return filePath.startsWith(HUSKY_DIRECTORY_PREFIX) && filePath.slice(HUSKY_DIRECTORY_PREFIX.length).length > 0;
 }
 
-function categorizeFile(file: ChangedFile): ChangeCategory {
+function categorizeFileByBuiltInRules(file: ChangedFile): ChangeCategory {
   const { filePath, changeKind } = file;
 
   // Config files must stay config even when Edit payload snippets look like
@@ -101,6 +93,15 @@ function categorizeFile(file: ChangedFile): ChangeCategory {
     return ChangeCategory.fromString("test");
   }
 
+  // Markdown は配置場所にかかわらず文書として扱う。config / API / test の
+  // 明示ルールは優先しつつ、domain ディレクトリや CREATE フォールバックより
+  // 前に評価して README.md / *.mdx の新規作成を feature/domain に誤分類しない。
+  // 信頼境界となる root agent instructions は protected-file 側で別途保護する。
+  // @work-item-id WI-390
+  if (filePath.endsWith(".md") || filePath.endsWith(".mdx")) {
+    return ChangeCategory.fromString("docs");
+  }
+
   // domain: domain/ 配下
   if (filePath.includes("/domain/") || filePath.startsWith("domain/")) {
     return ChangeCategory.fromString("domain");
@@ -130,6 +131,43 @@ function categorizeFile(file: ChangedFile): ChangeCategory {
   return ChangeCategory.fromString("bugfix");
 }
 
+// 組み込み判定が構造的に高リスク（domain / api）のカテゴリは override で降格できない。
+// @work-item-id WI-372
+const NON_DOWNGRADABLE_BUILT_IN_CATEGORIES: ReadonlySet<string> = new Set(["domain", "api"]);
+
+/**
+ * WI-372: `quickMode.categoryOverrides` を反映したカテゴリ判定。
+ *
+ * override は「このパスはこの種類の変更である」という利用者の明示宣言なので、
+ * 組み込みルールより **先** に評価する（DD-1）。組み込みの後段に置くと
+ * `notes/x.config.json` のような偶発的な組み込みマッチに常に負け、
+ * 「設定したのに効かない」不可解な挙動になるため。
+ *
+ * ただし組み込み判定が `domain` / `api` のファイルは override で降格できない（DD-2）。
+ * `judge()` の NEW_DOMAIN は CREATE のみ、API_CONTRACT は port/adapter のみを見るため、
+ * ガードが無いと domain ファイルの MODIFY が `docs` として素通りしてしまう。
+ * 降格は禁じるが昇格（domain → api 等）は許す。
+ *
+ * override 未設定時は組み込み分類と完全に一致する（後方互換）。
+ */
+function categorizeFile(file: ChangedFile, overrides: CategoryOverrideRules): ChangeCategory {
+  const builtIn = categorizeFileByBuiltInRules(file);
+  if (overrides.isEmpty()) {
+    return builtIn;
+  }
+
+  const override = overrides.resolve(file.filePath);
+  if (override === null) {
+    return builtIn;
+  }
+
+  if (NON_DOWNGRADABLE_BUILT_IN_CATEGORIES.has(builtIn.toString())) {
+    return override.riskPriority() > builtIn.riskPriority() ? override : builtIn;
+  }
+
+  return override;
+}
+
 /**
  * WI-349: 遮断理由に判定根拠（分類カテゴリと変更種別）を含める。
  *
@@ -142,17 +180,18 @@ function describeChangedFile(file: ChangedFile, category: string): string {
 }
 
 export class QuickModeJudgmentEngine {
-  classify(changedFiles: readonly ChangedFile[], _config?: QuickModeConfig): ChangeClassification {
+  classify(changedFiles: readonly ChangedFile[], config?: QuickModeConfig): ChangeClassification {
     if (changedFiles.length === 0) {
       return new ChangeClassification(null, new Map(), 0);
     }
 
+    const overrides = config?.categoryOverrides ?? CategoryOverrideRules.empty();
     const categorizedMap = new Map<string, ChangedFile[]>();
     let dominantCategory: ChangeCategory | null = null;
     let dominantPriority = -1;
 
     for (const file of changedFiles) {
-      const category = categorizeFile(file);
+      const category = categorizeFile(file, overrides);
       const key = category.toString();
 
       if (!categorizedMap.has(key)) {
@@ -160,7 +199,7 @@ export class QuickModeJudgmentEngine {
       }
       categorizedMap.get(key)!.push(file);
 
-      const priority = RISK_PRIORITY[key] ?? 0;
+      const priority = category.riskPriority();
       if (priority > dominantPriority) {
         dominantPriority = priority;
         dominantCategory = category;
@@ -173,7 +212,7 @@ export class QuickModeJudgmentEngine {
   judge(changedFiles: readonly ChangedFile[], config: QuickModeConfig): QuickModeEligibility {
     const classification = this.classify(changedFiles, config);
 
-    // 1. MIXED_CHANGES評価: allowedCategories 外のカテゴリが含まれる場合
+    // 1. カテゴリ評価: 不許可カテゴリを含む単一カテゴリ変更と、複数カテゴリ変更を区別する。
     if (config.isFullModeRequiredFor("mixedCategories")) {
       const notAllowedFiles: ChangedFile[] = [];
       const notAllowedDescriptions: string[] = [];
@@ -187,8 +226,9 @@ export class QuickModeJudgmentEngine {
       });
 
       if (notAllowedFiles.length > 0) {
+        const rejectionRule = classification.categorizedFiles.size >= 2 ? "MIXED_CHANGES" : "CATEGORY_NOT_ALLOWED";
         return QuickModeEligibility.rejected(
-          "MIXED_CHANGES",
+          rejectionRule,
           notAllowedFiles,
           `allowedCategories外のファイルが含まれています: ${notAllowedDescriptions.join(", ")}`,
         );
@@ -206,7 +246,7 @@ export class QuickModeJudgmentEngine {
           "NEW_DOMAIN",
           newDomainFiles,
           `domain/配下に新規ファイルが追加されています: ${newDomainFiles
-            .map((f) => describeChangedFile(f, categorizeFile(f).toString()))
+            .map((f) => describeChangedFile(f, categorizeFile(f, config.categoryOverrides).toString()))
             .join(", ")}`,
         );
       }
@@ -223,7 +263,7 @@ export class QuickModeJudgmentEngine {
           "API_CONTRACT",
           apiContractFiles,
           `Port/Adapterインターフェースファイルの変更が含まれています: ${apiContractFiles
-            .map((f) => describeChangedFile(f, categorizeFile(f).toString()))
+            .map((f) => describeChangedFile(f, categorizeFile(f, config.categoryOverrides).toString()))
             .join(", ")}`,
         );
       }

package/scripts/harness/quick-mode/domain/types/rejection-rule.ts

@@ -5,4 +5,4 @@
  * Quick Mode拒否ルール識別子
  */
 
-export type RejectionRule = 'MIXED_CHANGES' | 'NEW_DOMAIN' | 'API_CONTRACT';
+export type RejectionRule = 'CATEGORY_NOT_ALLOWED' | 'MIXED_CHANGES' | 'NEW_DOMAIN' | 'API_CONTRACT';

package/scripts/harness/quick-mode/domain/value-objects/category-override-rules.ts

@@ -0,0 +1,147 @@
+/**
+ * @layer domain
+ * @unit quick-mode
+ * @work-item-id WI-372
+ *
+ * `quickMode.categoryOverrides` を表す値オブジェクト。
+ * ChangeCategory 7 値をキー、glob パターン列を値とする写像で、
+ * プロジェクト固有パス（`results/**` 等）を任意カテゴリへ割り当てる。
+ */
+
+import { QuickModeConfigError } from '../errors/quick-mode-config-error.js';
+import {
+  CHANGE_CATEGORY_VALUES,
+  ChangeCategory,
+  type ChangeCategoryValue,
+  isChangeCategoryValue,
+} from './change-category.js';
+
+/**
+ * glob → 正規表現の変換。
+ *
+ * domain 層は repo 全体で外部 npm パッケージを import していないため
+ * （picomatch は infrastructure adapter 専用）、
+ * `agent-integration/domain/value-objects/protected-file-list.ts` と同型の
+ * 純正規表現実装を採る（logical_design.md LD-10）。
+ *
+ * サポートする記法:
+ * - `**` … `/` を含む任意の文字列
+ * - `*`  … `/` を含まない任意の文字列
+ * - `?`  … `/` 以外の 1 文字
+ * - その他はリテラル（正規表現メタ文字はエスケープ）
+ */
+function globToRegExp(pattern: string): RegExp {
+  const regexSource = pattern
+    .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+    .replace(/\*\*/g, '__DOUBLE_STAR__')
+    .replace(/\*/g, '[^/]*')
+    .replace(/__DOUBLE_STAR__/g, '.*')
+    .replace(/\?/g, '[^/]');
+  return new RegExp(`^${regexSource}$`);
+}
+
+export type CategoryOverrideRulesInput = Readonly<Record<string, readonly string[]>>;
+
+export class CategoryOverrideRules {
+  private readonly patterns: ReadonlyMap<ChangeCategoryValue, readonly string[]>;
+  private readonly matchers: ReadonlyMap<ChangeCategoryValue, readonly RegExp[]>;
+
+  private constructor(
+    patterns: ReadonlyMap<ChangeCategoryValue, readonly string[]>,
+    matchers: ReadonlyMap<ChangeCategoryValue, readonly RegExp[]>,
+  ) {
+    this.patterns = patterns;
+    this.matchers = matchers;
+    Object.freeze(this);
+  }
+
+  static empty(): CategoryOverrideRules {
+    return new CategoryOverrideRules(new Map(), new Map());
+  }
+
+  static create(raw: CategoryOverrideRulesInput | undefined | null): CategoryOverrideRules {
+    if (raw === undefined || raw === null) {
+      return CategoryOverrideRules.empty();
+    }
+    if (typeof raw !== 'object' || Array.isArray(raw)) {
+      throw new QuickModeConfigError('categoryOverrides must be an object keyed by change category');
+    }
+
+    const patterns = new Map<ChangeCategoryValue, readonly string[]>();
+    const matchers = new Map<ChangeCategoryValue, readonly RegExp[]>();
+
+    for (const [key, value] of Object.entries(raw)) {
+      if (!isChangeCategoryValue(key)) {
+        throw new QuickModeConfigError(
+          `categoryOverrides contains unknown category "${key}". Valid values: ${CHANGE_CATEGORY_VALUES.join(', ')}`,
+        );
+      }
+      if (!Array.isArray(value)) {
+        throw new QuickModeConfigError(`categoryOverrides.${key} must be an array of glob patterns`);
+      }
+      for (const pattern of value) {
+        if (typeof pattern !== 'string' || pattern.length === 0) {
+          throw new QuickModeConfigError(
+            `categoryOverrides.${key} must not contain an empty or non-string glob pattern`,
+          );
+        }
+      }
+      if (value.length === 0) {
+        continue;
+      }
+      patterns.set(key, Object.freeze([...value]));
+      matchers.set(key, Object.freeze(value.map(globToRegExp)));
+    }
+
+    return new CategoryOverrideRules(patterns, matchers);
+  }
+
+  isEmpty(): boolean {
+    return this.matchers.size === 0;
+  }
+
+  /**
+   * パスに対応する override カテゴリを返す。
+   * 一致が無ければ null（組み込み分類へ委譲）。
+   * 複数カテゴリに一致した場合はリスク優先度が最も高いカテゴリを返すため、
+   * JSON のキー列挙順に依存しない決定的な結果になる（domain_model.md DD-4）。
+   */
+  resolve(filePath: string): ChangeCategory | null {
+    if (filePath === '' || this.matchers.size === 0) {
+      return null;
+    }
+
+    let resolved: ChangeCategory | null = null;
+    let resolvedPriority = -1;
+
+    for (const [category, regexps] of this.matchers) {
+      if (!regexps.some((regexp) => regexp.test(filePath))) {
+        continue;
+      }
+      const candidate = ChangeCategory.fromString(category);
+      const priority = candidate.riskPriority();
+      if (priority > resolvedPriority) {
+        resolvedPriority = priority;
+        resolved = candidate;
+      }
+    }
+
+    return resolved;
+  }
+
+  /** キーは ChangeCategory 語彙順に正規化する（equals をキー順に依存させないため） */
+  toRecord(): Readonly<Record<string, readonly string[]>> {
+    const record: Record<string, readonly string[]> = {};
+    for (const category of CHANGE_CATEGORY_VALUES) {
+      const globs = this.patterns.get(category);
+      if (globs !== undefined) {
+        record[category] = globs;
+      }
+    }
+    return Object.freeze(record);
+  }
+
+  equals(other: CategoryOverrideRules): boolean {
+    return JSON.stringify(this.toRecord()) === JSON.stringify(other.toRecord());
+  }
+}

package/scripts/harness/quick-mode/domain/value-objects/change-category.ts

@@ -24,6 +24,31 @@ const VALID_CATEGORIES: readonly ChangeCategoryValue[] = [
   'api',
 ] as const;
 
+/**
+ * ChangeCategory の語彙。config の enum 検証や categoryOverrides の
+ * キー検証はこの定義を唯一の権威として参照する。
+ * @work-item-id WI-372
+ */
+export const CHANGE_CATEGORY_VALUES: readonly ChangeCategoryValue[] = VALID_CATEGORIES;
+
+/** 与えられた文字列が ChangeCategory の語彙に含まれるか（正規化はしない） */
+export function isChangeCategoryValue(raw: string): raw is ChangeCategoryValue {
+  return VALID_CATEGORIES.includes(raw as ChangeCategoryValue);
+}
+
+// リスク順優先度（api > domain > feature > bugfix > test > config > docs）。
+// 複数の分類条件に一致した場合に、より高リスク側へ倒すための順序定義。
+// @work-item-id WI-372
+const RISK_PRIORITY: Record<ChangeCategoryValue, number> = {
+  api: 6,
+  domain: 5,
+  feature: 4,
+  bugfix: 3,
+  test: 2,
+  config: 1,
+  docs: 0,
+};
+
 export class UnknownChangeCategoryError extends Error {
   constructor(raw: string) {
     super(`Unknown change category: "${raw}". Valid values: ${VALID_CATEGORIES.join(', ')}`);
@@ -50,6 +75,14 @@ export class ChangeCategory {
     return this.value === 'domain' || this.value === 'feature' || this.value === 'api';
   }
 
+  /**
+   * リスク優先度。値が大きいほど高リスク（api=6 ... docs=0）。
+   * @work-item-id WI-372
+   */
+  riskPriority(): number {
+    return RISK_PRIORITY[this.value];
+  }
+
   toString(): string {
     return this.value;
   }

package/scripts/harness/quick-mode/domain/value-objects/quick-mode-config.ts

@@ -5,12 +5,14 @@
  * Quick Mode設定を表す値オブジェクト
  */
 
-export class QuickModeConfigError extends Error {
-  constructor(message: string) {
-    super(message);
-    this.name = 'QuickModeConfigError';
-  }
-}
+import { QuickModeConfigError } from '../errors/quick-mode-config-error.js';
+import {
+  CategoryOverrideRules,
+  type CategoryOverrideRulesInput,
+} from './category-override-rules.js';
+import { CHANGE_CATEGORY_VALUES, isChangeCategoryValue } from './change-category.js';
+
+export { QuickModeConfigError };
 
 export type FullModeRequiredRuleId = 'mixedCategories' | 'newDomainFile' | 'apiContractChange';
 
@@ -32,17 +34,21 @@ export class QuickModeConfig {
   readonly maintainedLayers: readonly string[];
   readonly relaxedGates: readonly string[];
   readonly fullModeRequiredWhen: FullModeRequiredRules;
+  /** @work-item-id WI-372 プロジェクト固有パスのカテゴリ割当ルール（未設定時は空） */
+  readonly categoryOverrides: CategoryOverrideRules;
 
   private constructor(
     allowedCategories: readonly string[],
     maintainedLayers: readonly string[],
     relaxedGates: readonly string[],
-    fullModeRequiredWhen: FullModeRequiredRules
+    fullModeRequiredWhen: FullModeRequiredRules,
+    categoryOverrides: CategoryOverrideRules
   ) {
     this.allowedCategories = allowedCategories;
     this.maintainedLayers = maintainedLayers;
     this.relaxedGates = relaxedGates;
     this.fullModeRequiredWhen = fullModeRequiredWhen;
+    this.categoryOverrides = categoryOverrides;
     Object.freeze(this);
   }
 
@@ -51,13 +57,26 @@ export class QuickModeConfig {
     maintainedLayers: string[];
     relaxedGates: string[];
     fullModeRequiredWhen?: Partial<FullModeRequiredRules>;
+    categoryOverrides?: CategoryOverrideRulesInput;
   }): QuickModeConfig {
-    const { allowedCategories, maintainedLayers, relaxedGates, fullModeRequiredWhen } = raw;
+    const { allowedCategories, maintainedLayers, relaxedGates, fullModeRequiredWhen, categoryOverrides } = raw;
 
     if (allowedCategories.length === 0) {
       throw new QuickModeConfigError('allowedCategories must not be empty');
     }
 
+    // WI-373: allowedCategories は ChangeCategory 7 値の enum。
+    // 従来は非空チェックのみだったため "typoo" のような未知値が黙って通り、
+    // 「設定したのに効かない」状態になっていた。分類結果のキーは常に小文字なので
+    // 大文字小文字の正規化はせず厳密一致で拒否する（正規化は効かない設定の黙認になる）。
+    for (const category of allowedCategories) {
+      if (!isChangeCategoryValue(category)) {
+        throw new QuickModeConfigError(
+          `allowedCategories contains unknown category "${category}". Valid values: ${CHANGE_CATEGORY_VALUES.join(', ')}`
+        );
+      }
+    }
+
     const mergedRules: FullModeRequiredRules = Object.freeze({
       mixedCategories: fullModeRequiredWhen?.mixedCategories ?? DEFAULT_FULL_MODE_REQUIRED_WHEN.mixedCategories,
       newDomainFile: fullModeRequiredWhen?.newDomainFile ?? DEFAULT_FULL_MODE_REQUIRED_WHEN.newDomainFile,
@@ -68,7 +87,8 @@ export class QuickModeConfig {
       Object.freeze([...allowedCategories]),
       Object.freeze([...maintainedLayers]),
       Object.freeze([...relaxedGates]),
-      mergedRules
+      mergedRules,
+      CategoryOverrideRules.create(categoryOverrides)
     );
   }
 
@@ -100,7 +120,8 @@ export class QuickModeConfig {
       JSON.stringify(this.relaxedGates) === JSON.stringify(other.relaxedGates) &&
       this.fullModeRequiredWhen.mixedCategories === other.fullModeRequiredWhen.mixedCategories &&
       this.fullModeRequiredWhen.newDomainFile === other.fullModeRequiredWhen.newDomainFile &&
-      this.fullModeRequiredWhen.apiContractChange === other.fullModeRequiredWhen.apiContractChange
+      this.fullModeRequiredWhen.apiContractChange === other.fullModeRequiredWhen.apiContractChange &&
+      this.categoryOverrides.equals(other.categoryOverrides)
     );
   }
 }

package/scripts/harness/quick-mode/index.ts

@@ -1,7 +1,13 @@
 // @unit quick-mode
 // @layer application
 
-export { ChangeCategory, UnknownChangeCategoryError } from './domain/value-objects/change-category.js';
+export {
+  CHANGE_CATEGORY_VALUES,
+  ChangeCategory,
+  isChangeCategoryValue,
+  UnknownChangeCategoryError,
+} from './domain/value-objects/change-category.js';
+export { CategoryOverrideRules } from './domain/value-objects/category-override-rules.js';
 export { ChangedFile } from './domain/value-objects/changed-file.js';
 export { ChangeClassification } from './domain/value-objects/change-classification.js';
 export { QuickModeConfig, QuickModeConfigError } from './domain/value-objects/quick-mode-config.js';