phasegate 0.315.0 → 0.340.0

package/scripts/harness/quick-mode/infrastructure/adapters/harness-config-quick-mode-config-adapter.ts

@@ -2,81 +2,132 @@
  * @layer infrastructure
  * @unit quick-mode
  * @work-item-id WI-140
+ * @work-item-id WI-372
+ * @work-item-id WI-377
  *
  * phasegate.config.json から QuickModeConfig を取得する Adapter
+ *
+ * ADR-040: 実効値は config-foundation の防御プリセット解決を経由して決定する。
+ * preset 定義（presets/*.json の quickMode）が実効値の所在であり、
+ * 下の DEFAULT_QUICK_MODE_CONFIG は preset 解決不能時の fail-open 用フォールバックである。
  */
 
-import * as fs from 'node:fs/promises';
-import * as path from 'node:path';
-import { QuickModeConfig } from '../../domain/value-objects/quick-mode-config.js';
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import type {
+  HarnessConfigResolvedDocument,
+  HarnessConfigSourceDocument,
+  PresetId,
+} from "../../../config-foundation/domain/harness-config.js";
+import { PresetResolutionService } from "../../../config-foundation/domain/services/preset-resolution-service.js";
+import { PresetDefinitionStore } from "../../../config-foundation/infrastructure/preset-definition-store.js";
+import { QuickModeConfig } from "../../domain/value-objects/quick-mode-config.js";
 
 export class HarnessConfigNotFoundError extends Error {
   constructor(filePath: string) {
     super(`phasegate.config.json not found: ${filePath}`);
-    this.name = 'HarnessConfigNotFoundError';
+    this.name = "HarnessConfigNotFoundError";
   }
 }
 
 export class HarnessConfigParseError extends Error {
   constructor(message: string) {
     super(`Failed to parse phasegate.config.json: ${message}`);
-    this.name = 'HarnessConfigParseError';
+    this.name = "HarnessConfigParseError";
   }
 }
 
+/**
+ * preset 解決が使えない config（未知 preset / project 欠落 / 他セクション不正）でも
+ * Quick Mode 判定を止めないためのフォールバック。ADR-038 §3-1 の fail-open 原則に従い、
+ * preset 解決の導入によって新たな遮断経路を作らない。
+ */
 const DEFAULT_QUICK_MODE_CONFIG = {
-  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'],
+  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"],
 };
 
+const PRESET_IDS: readonly PresetId[] = ["minimal", "standard", "strict"];
+
+type RawQuickMode = HarnessConfigResolvedDocument["quickMode"];
+
+function isPresetId(value: unknown): value is PresetId {
+  return typeof value === "string" && PRESET_IDS.includes(value as PresetId);
+}
+
 export class HarnessConfigQuickModeConfigAdapter {
   private readonly configPath: string;
+  private readonly presetDefinitionStore: PresetDefinitionStore;
+  private readonly presetResolutionService: PresetResolutionService;
 
   constructor(configPath?: string) {
-    this.configPath = configPath ?? path.resolve(process.cwd(), 'phasegate.config.json');
+    this.configPath = configPath ?? path.resolve(process.cwd(), "phasegate.config.json");
+    this.presetDefinitionStore = new PresetDefinitionStore();
+    this.presetResolutionService = new PresetResolutionService();
   }
 
   async getQuickModeConfig(): Promise<QuickModeConfig> {
+    const parsed = await this.readSourceDocument();
+    const quickMode = this.resolveQuickMode(parsed);
+
+    return QuickModeConfig.create({
+      allowedCategories: quickMode?.allowedCategories ?? DEFAULT_QUICK_MODE_CONFIG.allowedCategories,
+      maintainedLayers: quickMode?.maintainedLayers ?? DEFAULT_QUICK_MODE_CONFIG.maintainedLayers,
+      relaxedGates: quickMode?.relaxedGates ?? DEFAULT_QUICK_MODE_CONFIG.relaxedGates,
+      fullModeRequiredWhen: quickMode?.fullModeRequiredWhen,
+      // WI-372 × WI-377 合流点: categoryOverrides は preset 解決経路と raw 縮退経路の
+      // 双方が返す `quickMode` から一様に読む。preset 定義は当該キーを宣言しないため
+      // deepMerge は source の宣言をそのまま引き継ぎ（base 側 undefined → override を clone）、
+      // preset 解決が例外で縮退した場合も raw の宣言がそのまま渡る。未設定時は空ルール
+      // = 現行分類のまま。enum 違反は QuickModeConfig.create が QuickModeConfigError を
+      // 投げ、この try/catch の外側なので fail-closed 経路へ表面化する。
+      categoryOverrides: quickMode?.categoryOverrides,
+    });
+  }
+
+  private async readSourceDocument(): Promise<Record<string, unknown>> {
     let content: string;
 
     try {
-      content = await fs.readFile(this.configPath, 'utf8') as string;
+      content = (await fs.readFile(this.configPath, "utf8")) as string;
     } catch (err) {
       const error = err as NodeJS.ErrnoException;
-      if (error.code === 'ENOENT') {
+      if (error.code === "ENOENT") {
         throw new HarnessConfigNotFoundError(this.configPath);
       }
       throw err;
     }
 
-    let parsed: Record<string, unknown>;
     try {
-      parsed = JSON.parse(content) as Record<string, unknown>;
+      return JSON.parse(content) as Record<string, unknown>;
     } catch (err) {
       throw new HarnessConfigParseError(err instanceof Error ? err.message : String(err));
     }
+  }
+
+  /**
+   * 防御プリセット解決を経由した quickMode を返す。
+   * preset が特定できない、または解決が失敗する config では raw の quickMode に縮退し、
+   * 未宣言キーは呼び出し側で DEFAULT_QUICK_MODE_CONFIG に補完される。
+   */
+  private resolveQuickMode(parsed: Record<string, unknown>): Partial<RawQuickMode> | undefined {
+    const rawQuickMode = parsed["quickMode"] as Partial<RawQuickMode> | undefined;
+    const preset = (parsed["project"] as { preset?: unknown } | undefined)?.preset;
 
-    const quickMode = parsed['quickMode'] as {
-      allowedCategories?: string[];
-      maintainedLayers?: string[];
-      relaxedGates?: string[];
-      fullModeRequiredWhen?: {
-        mixedCategories?: boolean;
-        newDomainFile?: boolean;
-        apiContractChange?: boolean;
-      };
-    } | undefined;
-
-    if (!quickMode) {
-      return QuickModeConfig.create(DEFAULT_QUICK_MODE_CONFIG);
+    if (!isPresetId(preset)) {
+      return rawQuickMode;
     }
 
-    return QuickModeConfig.create({
-      allowedCategories: quickMode.allowedCategories ?? DEFAULT_QUICK_MODE_CONFIG.allowedCategories,
-      maintainedLayers: quickMode.maintainedLayers ?? DEFAULT_QUICK_MODE_CONFIG.maintainedLayers,
-      relaxedGates: quickMode.relaxedGates ?? DEFAULT_QUICK_MODE_CONFIG.relaxedGates,
-      fullModeRequiredWhen: quickMode.fullModeRequiredWhen,
-    });
+    try {
+      const presetDefinitions = this.presetDefinitionStore.load();
+      const resolved = this.presetResolutionService.resolve(
+        parsed as unknown as HarnessConfigSourceDocument,
+        presetDefinitions[preset],
+      );
+      return resolved.quickMode;
+    } catch {
+      return rawQuickMode;
+    }
   }
 }

package/scripts/harness/regression-suite/infrastructure/adapters/vitest-test-runner-adapter.ts

@@ -1,7 +1,10 @@
 // @layer infrastructure
-import { execSync } from 'node:child_process';
+// @unit regression-suite
+// @work-item-id WI-384
+import { execFileSync } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
+import { execPath } from 'node:process';
 import { KRequirementTest } from '../../domain/value-objects/k-requirement-test.js';
 import { GngConditionTest } from '../../domain/value-objects/gng-condition-test.js';
 import { AgentIndependenceTest } from '../../domain/value-objects/agent-independence-test.js';
@@ -65,8 +68,15 @@ export class VitestTestRunnerAdapter implements TestRunnerPort {
 
       const testPattern = hasUnitTests ? unitTestDir : unitIntegrationDir;
       try {
-        execSync(
-          `npx tsx node_modules/vitest/vitest.mjs run --config scripts/harness/__tests__/vitest.config.ts "${testPattern}"`,
+        execFileSync(
+          execPath,
+          [
+            'node_modules/vitest/vitest.mjs',
+            'run',
+            '--config',
+            'scripts/harness/__tests__/vitest.config.ts',
+            testPattern,
+          ],
           { cwd: this.rootDir, stdio: 'pipe', timeout: 60_000 },
         );
         unitResults.set(unit, true);

package/skills/product-architect/SKILL.md

@@ -35,6 +35,18 @@ languages: [typescript]
 ### 出力ファイル
 `docs/inception/_shared/product_overview_plan.md`
 
+> **テンプレート実体の取得（正本）**: 下の構成ブロックは読み取り用の要約であり、
+> 実体は `templates/product_overview_plan.template.md` にある。
+> node_modules を Read せずに取得・生成するには次を使う:
+>
+> ```bash
+> phasegate templates show product_overview_plan          # 本文を stdout に出力
+> phasegate scaffold-inception --kind product-overview-plan --apply  # 実ファイルを生成
+> ```
+>
+> scaffold した文書は無編集で Level-1 フェーズゲート（`interactive` モード）を通る。
+> `[Answer]` は **人間が記入する**。AI が埋めると承認証跡の偽造になる。
+
 ### 計画ファイルの構成
 
 ```markdown
@@ -93,6 +105,13 @@ languages: [typescript]
 |------|--------|
 | 成果物 | `docs/product/product_overview.md` |
 
+> **テンプレート実体の取得（正本）**: 実体は `templates/product_overview.template.md` にある。
+>
+> ```bash
+> phasegate templates show product_overview
+> phasegate scaffold-inception --kind product-overview --apply
+> ```
+
 ### product_overview.md の構成
 
 ```markdown

package/skills/story-mapper/SKILL.md

@@ -81,6 +81,17 @@ MVPスコープの方針・分類基準・不明点を整理し、人間の承
 ### 出力ファイル
 `docs/inception/_shared/story_mapping_plan.md`
 
+> **テンプレート実体の取得（正本）**: 下の構成ブロックは読み取り用の要約であり、
+> 実体は `templates/story_mapping_plan.template.md` にある。
+> node_modules を Read せずに取得・生成するには次を使う:
+>
+> ```bash
+> phasegate templates show story_mapping_plan
+> phasegate scaffold-inception --kind story-mapping-plan --apply
+> ```
+>
+> `[Answer]` は **人間が記入する**。AI が埋めると承認証跡の偽造になる。
+
 ### 計画ファイルの構成
 
 ```markdown

package/skills/story-writer/SKILL.md

@@ -45,6 +45,17 @@ If not, halt and ask the user to create the WI first, or offer to run `phasegate
 ### 出力ファイル
 `docs/inception/_shared/story_writer_plan.md`
 
+> **テンプレート実体の取得（正本）**: 下の構成ブロックは読み取り用の要約であり、
+> 実体は `templates/story_writer_plan.template.md` にある。
+> node_modules を Read せずに取得・生成するには次を使う:
+>
+> ```bash
+> phasegate templates show story_writer_plan
+> phasegate scaffold-inception --kind story-writer-plan --apply
+> ```
+>
+> `[Answer]` は **人間が記入する**。AI が埋めると承認証跡の偽造になる。
+
 ### 計画ファイルの構成
 
 ```markdown

package/skills/unit-designer/SKILL.md

@@ -84,6 +84,17 @@ Unit分割の方針・グルーピングの根拠・不明点を整理し、人
 
 > **パス注記**: 本スキルが扱う設計文書パス（`docs/inception/...` / `docs/product/units/...`）は既定値であり、consumer が `phasegate.config.json` の `paths` 設定で上書きしている場合はそちらが優先される。
 
+> **テンプレート実体の取得（正本）**: 下の構成ブロックは読み取り用の要約であり、
+> 実体は `templates/unit_design_plan.template.md` にある。
+> node_modules を Read せずに取得・生成するには次を使う:
+>
+> ```bash
+> phasegate templates show unit_design_plan
+> phasegate scaffold-inception --kind unit-design-plan --apply
+> ```
+>
+> `[Answer]` は **人間が記入する**。AI が埋めると承認証跡の偽造になる。
+
 ### 計画ファイルの構成
 
 ```markdown

package/templates/.agents/hooks.json

@@ -0,0 +1,16 @@
+{
+  "phasegate-gate": {
+    "PreToolUse": [
+      {
+        "matcher": "^(write_to_file|replace_file_content|multi_replace_file_content|run_command)$",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx phasegate hook pre-tool-use",
+            "timeout": 30
+          }
+        ]
+      }
+    ]
+  }
+}

package/templates/.claude/scripts/analyze-errors-hook.sh

@@ -96,10 +96,10 @@ if command -v npx >/dev/null 2>&1; then
     fi
 fi
 
-# Biome lint check
+# PhaseGate lint check (uses the target project's PhaseGate/Biome configuration)
 LINT_OUTPUT=""
 if command -v npx >/dev/null 2>&1; then
-    LINT_RAW=$(npx @biomejs/biome lint "$LOCAL_PATH" 2>&1)
+    LINT_RAW=$(npx phasegate lint --json --skip-eslint-removal-check 2>&1)
     if [ $? -ne 0 ] && [ -n "$LINT_RAW" ]; then
         LINT_OUTPUT=$(echo "$LINT_RAW" | head -5)
     fi

package/templates/.claude/settings.json

@@ -2,7 +2,7 @@
   "hooks": {
     "PreToolUse": [
       {
-        "matcher": "Bash",
+        "matcher": "Bash|apply_patch",
         "hooks": [
           {
             "type": "command",
@@ -10,7 +10,8 @@
           },
           {
             "type": "command",
-            "command": "npx phasegate hook pre-tool-use"
+            "command": "npx phasegate hook pre-tool-use",
+            "timeout": 30
           }
         ]
       },
@@ -19,7 +20,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx phasegate hook pre-tool-use"
+            "command": "npx phasegate hook pre-tool-use",
+            "timeout": 30
           }
         ]
       }

package/templates/.codex/hooks.json

@@ -25,7 +25,7 @@
     ],
     "PreToolUse": [
       {
-        "matcher": "Bash",
+        "matcher": "Bash|apply_patch",
         "hooks": [
           {
             "type": "command",
@@ -37,7 +37,7 @@
     ],
     "PostToolUse": [
       {
-        "matcher": "Bash",
+        "matcher": "Bash|apply_patch",
         "hooks": [
           {
             "type": "command",

package/templates/product_overview.template.md

@@ -0,0 +1,85 @@
+# <プロダクト名>
+
+> **スキル**: `product-architect` Phase 2（実行）
+> **入力**: `docs/inception/_shared/product_overview_plan.md`（承認済み）
+> **作成日**: <YYYY-MM-DD>
+
+このファイルは `phasegate scaffold-inception --kind product-overview --apply`
+が生成した雛形です。TODO を実体で埋めてください。
+このドキュメントは全スキルの**前提**として参照されます。
+
+---
+
+## 1. プロダクト定義
+
+### 1.1 根本思想
+
+TODO: このプロダクトが何を信条として作られるかを 2〜3 行で記述
+
+### 1.2 解決する問題
+
+TODO: 現状の痛みと、それが放置された場合のコスト
+
+### 1.3 対象ユーザー
+
+TODO: 主ターゲットと、明示的に対象外とするユーザー
+
+## 2. コアドメイン
+
+### 2.1 主要概念（ユビキタス言語）
+
+| 概念 | 定義 | 例 |
+|------|------|-----|
+| TODO | TODO | TODO |
+
+### 2.2 概念間の関係図
+
+```mermaid
+graph TD
+  A[TODO] --> B[TODO]
+```
+
+## 3. アーキテクチャ仕様
+
+### 3.1 全体構造（レイヤー図）
+
+```
+TODO: レイヤー構成
+```
+
+### 3.2 技術スタック
+
+| レイヤー | 技術 | 選定理由 |
+|---------|------|---------|
+| TODO | TODO | TODO |
+
+### 3.3 分離方針
+
+TODO: 認証/認可、同期/非同期 等の分離方針
+
+## 4. ADR Summary（技術決定記録）
+
+| # | 決定事項 | 選択肢 | 決定 | 理由 |
+|---|---------|-------|------|------|
+| 1 | TODO | TODO | TODO | TODO |
+
+## 5. 制約
+
+### 5.1 運用上の制約
+
+TODO
+
+### 5.2 実装上の制約
+
+TODO
+
+### 5.3 パフォーマンス要件
+
+TODO
+
+---
+
+## 注意事項
+
+- ユビキタス言語はプロジェクト全体で一貫して使用する
+- 技術選定の「なぜ」を必ず ADR Summary に記録する

package/templates/product_overview_plan.template.md

@@ -0,0 +1,55 @@
+# プロダクト設計計画
+
+> **スキル**: `product-architect` Phase 1（計画）
+> **成果物**: `docs/product/product_overview.md`（Phase 2 で作成）
+> **作成日**: <YYYY-MM-DD>
+
+このファイルは `phasegate scaffold-inception --kind product-overview-plan --apply`
+が生成した雛形です。TODO を実体で埋めてください。
+**QA セクションの `[Answer]` は人間が記入するもので、AI が埋めてはいけません。**
+
+---
+
+## 1. スコープ
+
+- TODO: プロダクトの目的と対象ユーザー概要
+- TODO: 設計対象セクション一覧
+
+## 2. ドメイン分析（ドラフト）
+
+- TODO: 特定されたコアドメイン
+- TODO: 主要業務概念の候補一覧（ユビキタス言語の種）
+
+## 3. アーキテクチャ方針（ドラフト）
+
+- TODO: 想定されるアーキテクチャスタイル
+- TODO: 技術スタック候補
+
+## 4. QA（不明点・確認事項）
+
+### [Question] Q1: <質問タイトル>
+
+<質問の詳細と背景>
+
+**推奨案:** <AI の推奨案>
+
+> 下の `[Answer]` 行の直後に **人間が** 回答を記入してください。
+> 空欄のままだと `planningMode: "embedded-qa"` のフェーズゲートは通りません（意図した挙動です）。
+
+[Answer]
+
+## 5. 前提条件・リスク
+
+- TODO: 前提条件
+- TODO: リスクと対応方針
+
+---
+
+## フェーズゲートとの関係
+
+- `planningMode.default: "interactive"`（既定）では、`## 4. QA（不明点・確認事項）`
+  という **QA セクション見出しの存在** が Level-1 ゲート通過条件です。
+  見出しは `## QA` / `## Q&A` / `## 4. QA（...）` のいずれの表記でも構いません。
+- `planningMode.default: "embedded-qa"` では、`[Question]` と `[Answer]` の
+  **個数一致かつ [Answer] に本文があること** が追加で要求されます。
+  この雛形のままではゲートを通りません（人間の回答が必要）。これは意図した挙動です。

package/templates/story_mapping_plan.template.md

@@ -0,0 +1,61 @@
+# ストーリーマッピング計画
+
+> **スキル**: `story-mapper` Phase 1（計画）
+> **成果物**: `docs/product/user_story_mapping.md`（Phase 2 で作成）
+> **入力**: `docs/product/user_stories.md`
+> **作成日**: <YYYY-MM-DD>
+
+このファイルは `phasegate scaffold-inception --kind story-mapping-plan --apply`
+が生成した雛形です。TODO を実体で埋めてください。
+**QA セクションの `[Answer]` は人間が記入するもので、AI が埋めてはいけません。**
+
+---
+
+## 1. スコープ
+
+- TODO: 全ストーリー数
+- TODO: MVP 選定の対象業務プロセス
+
+## 2. MVP選定基準
+
+- TODO: 基盤 MVP と業務プロセス MVP の分類基準
+- TODO: MVP / Post-MVP 判定の考え方
+
+## 3. MVPシナリオ（ドラフト）
+
+- TODO: 想定されるメインユーザーフロー
+- TODO: 最小限の業務プロセス単位
+
+## 4. ストーリー分類（ドラフト）
+
+| ストーリーID | 概要 | MVP候補 | 分類理由 |
+|------------|------|---------|---------|
+| TODO | TODO | TODO | TODO |
+
+## 5. QA（不明点・確認事項）
+
+### [Question] Q1: <質問タイトル>
+
+<質問の詳細と背景>
+
+**推奨案:** <AI の推奨案>
+
+> 下の `[Answer]` 行の直後に **人間が** 回答を記入してください。
+> 空欄のままだと `planningMode: "embedded-qa"` のフェーズゲートは通りません（意図した挙動です）。
+
+[Answer]
+
+## 6. 前提条件・リスク
+
+- TODO: 前提条件
+- TODO: リスクと対応方針
+
+---
+
+## フェーズゲートとの関係
+
+- `planningMode.default: "interactive"`（既定）では、`## 5. QA（不明点・確認事項）`
+  という **QA セクション見出しの存在** が Level-1 ゲート通過条件です。
+- `planningMode.default: "embedded-qa"` では、`[Question]` と `[Answer]` の
+  **個数一致かつ [Answer] に本文があること** が追加で要求されます。
+  この雛形のままではゲートを通りません（人間の回答が必要）。これは意図した挙動です。

package/templates/story_writer_plan.template.md

@@ -0,0 +1,61 @@
+# ユーザーストーリー作成計画
+
+> **スキル**: `story-writer` Phase 1（計画）
+> **成果物**: `docs/product/user_stories.md`（Phase 2 で作成）
+> **入力**: `docs/product/product_overview.md`
+> **作成日**: <YYYY-MM-DD>
+
+このファイルは `phasegate scaffold-inception --kind story-writer-plan --apply`
+が生成した雛形です。TODO を実体で埋めてください。
+**QA セクションの `[Answer]` は人間が記入するもので、AI が埋めてはいけません。**
+
+---
+
+## 1. スコープ
+
+- TODO: 対象の要求文書
+- TODO: 想定される Epic 一覧
+
+## 2. アクター分析
+
+- TODO: 特定されたアクター（ロール）一覧
+
+## 3. ストーリー作成方針
+
+- TODO: ストーリーの粒度方針
+
+## 4. ストーリー一覧（ドラフト）
+
+Epic 別のストーリー ID・概要の一覧（本文はまだ書かない）。
+
+| Epic | ストーリーID | 概要 |
+|------|------------|------|
+| TODO | TODO | TODO |
+
+## 5. QA（不明点・確認事項）
+
+### [Question] Q1: <質問タイトル>
+
+<質問の詳細と背景>
+
+**推奨案:** <AI の推奨案>
+
+> 下の `[Answer]` 行の直後に **人間が** 回答を記入してください。
+> 空欄のままだと `planningMode: "embedded-qa"` のフェーズゲートは通りません（意図した挙動です）。
+
+[Answer]
+
+## 6. 前提条件・リスク
+
+- TODO: 前提条件
+- TODO: リスクと対応方針
+
+---
+
+## フェーズゲートとの関係
+
+- `planningMode.default: "interactive"`（既定）では、`## 5. QA（不明点・確認事項）`
+  という **QA セクション見出しの存在** が Level-1 ゲート通過条件です。
+- `planningMode.default: "embedded-qa"` では、`[Question]` と `[Answer]` の
+  **個数一致かつ [Answer] に本文があること** が追加で要求されます。
+  この雛形のままではゲートを通りません（人間の回答が必要）。これは意図した挙動です。