phasegate 0.148.0 → 0.150.0

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.150.0] - 2026-05-12
+
+### Added
+
+- **G1 / WI-123 / WI-124 / WI-127 / WI-128 — Gate reliability and operational transparency** — `phasegate:status --json` now reports hook/baseline operational health, CI template validator IDs are derived from the live validator-system registry, L4 scheduled audit docs/templates use canonical L4 commands, and README/guide feature inventory matches the shipped 30 skills.
+
 ## [0.147.0] - 2026-05-12
 
 ### Added

package/README.ja.md

@@ -80,7 +80,7 @@ claude
 `init` は初期 bootstrap として以下を生成します:
 
 - `phasegate.config.json` — 品質設定の Single Source of Truth
-- `skills/` — 28 の AIDLC スキル一式
+- `skills/` — 30 の AIDLC スキル一式
 - `.claude/skills/` ・ `.codex/skills/` — agent 向けの skill symlink
 - `.claude/settings.json` — PreToolUse / PostToolUse / Stop hook
 - `.codex/hooks.json` — Codex CLI hooks 設定（`--agent codex|both` 時）
@@ -152,7 +152,7 @@ npx phasegate reconcile --apply
 |---|---|
 | **フェーズゲート** | 設計文書がないと実装ファイルへの Write/Edit/Bash をブロック。AIDLC 準拠 / カスタム gate の両方をサポート |
 | **5 層バリデーション (L0-L4)** | エディタ保存 → pre-commit → CI → 週次まで段階的に品質チェック |
-| **28 AIDLC スキル** | 要求定義 → ドメイン設計 → テスト設計 → TDD 実装をスキルとして提供 |
+| **30 AIDLC スキル** | 要求定義 → ドメイン設計 → テスト設計 → TDD 実装をスキルとして提供 |
 | **Quick Mode** | バグ修正・docs・テスト追加など軽微変更ではゲートを緩和して高速化 |
 | **Claude Code / Codex Hooks** | Write/Edit/Bash 時に自動でゲートチェック・lint を実行 |
 | **HarnessError 形式** | 全エラーに ADR 参照 + 修正例が含まれ、AI が自己修正できる |
@@ -198,13 +198,13 @@ npx phasegate reconcile --apply
 
 ---
 
-## 28 AIDLC スキル
+## 30 AIDLC スキル
 
 AIDLC (AI-Driven Development Life Cycle) は **要求定義 → 設計 → テスト設計 → TDD 実装** の順序を強制するプロセスです。各スキルは前のレベルの成果物を入力にします。
 
 **最初の一歩**: Claude Code / Codex 内で `/product-architect` を実行。
 
-### 5 グループ（28 スキル）
+### 6 グループ（30 スキル）
 
 | グループ | スキル |
 |---|---|
@@ -213,6 +213,7 @@ AIDLC (AI-Driven Development Life Cycle) は **要求定義 → 設計 → テ
 | **Test Engineering (7)** | `/unit-test-designer` `/it-test-designer` `/scenario-test-designer` `/unit-test-logic-designer` `/it-test-logic-designer` `/scenario-test-logic-designer` `/test-coverage-checker` |
 | **Implementation (4)** | `/story-implementor` `/quick-implementor` `/implementation-planner` `/implementation-readiness-checker` |
 | **Verification (8)** | `/consistency-checker` `/cascade-updater` `/codex-delegator` `/codebase-mapper` `/doc-freshness-checker` `/pointer-validator` `/engineering-perspective` `/skill-creator` |
+| **Operations (2)** | `/phasegate-config-doctor` `/phasegate-toolkit-guide` |
 
 各スキルの詳細・成果物・前提条件: [Skills Overview](docs/guide/skills-overview.md)
 
@@ -506,7 +507,7 @@ L3 Nyquist Validation の `requirement-test-matrix.json` 自動生成はまだ
 - [Installation](docs/guide/installation.md) — 詳細インストール手順
 - [Configuration](docs/guide/configuration.md) — `phasegate.config.json` 完全リファレンス
 - [CLI Reference](docs/guide/cli-reference.md) — 全 CLI コマンド・オプション
-- [Skills Overview](docs/guide/skills-overview.md) — 28 スキルの実行順序と成果物
+- [Skills Overview](docs/guide/skills-overview.md) — 30 スキルの実行順序と成果物
 - [5-Layer Defense Model](docs/guide/layer-model.md) — L0-L4 詳細・HarnessError 形式
 - [Hooks Integration](docs/guide/hooks-integration.md) — Claude Code Hooks 設定
 - [Codex Integration](docs/guide/codex-integration.md) — Codex CLI セットアップ・カバレッジ

package/README.md

@@ -81,7 +81,7 @@ claude
 `init` creates the initial project-local harness files:
 
 - `phasegate.config.json` as the quality settings source of truth
-- `skills/` with 28 AIDLC skills
+- `skills/` with 30 AIDLC skills
 - `.claude/skills` and/or `.codex/skills` links for agent use
 - `.claude/settings.json` and/or `.codex/hooks.json` hook configuration
 - `docs/principles/*.md` and `docs/folder_management_rules.md`
@@ -145,7 +145,7 @@ npx phasegate reconcile --apply
 |---|---|
 | **Phase gates** | Blocks implementation writes until required design documents exist and have been reflected into product docs |
 | **5-layer validation** | Runs checks from agent runtime and editor time through pre-commit, CI, and scheduled audits |
-| **28 AIDLC skills** | Guides AI agents through product architecture, story writing, domain design, test design, and TDD implementation |
+| **30 AIDLC skills** | Guides AI agents through product architecture, story writing, domain design, test design, and TDD implementation |
 | **Quick Mode** | Keeps bugfixes, docs, test-only changes, and config changes lightweight while preserving traceability |
 | **Claude Code / Codex hooks** | Runs checks around Write/Edit/Bash operations and session boundaries |
 | **Agent-readable HarnessError output** | Gives AI agents the reason, missing artifacts, references, and examples needed to self-correct |
@@ -177,7 +177,7 @@ npx phasegate reconcile --apply
 +------------------------------------------------------------------+
 |  L4  SCHEDULED             Validators (default off)              |
 |  drift-detection, consistency-check, dead-code analysis,         |
-|  phase2 freshness/pointer checks via standalone p2:* commands    |
+|  doc-freshness and pointer-validation via L4 + p2:* compatibility|
 +------------------------------------------------------------------+
 ```
 
@@ -191,7 +191,7 @@ npx phasegate reconcile --apply
 
 ---
 
-## 28 Skills
+## 30 Skills
 
 Skills cover the full **AIDLC (AI-Driven Development Life Cycle)**: product definition, design, test design, and TDD implementation. Each skill consumes the artifacts from the previous phase.
 
@@ -204,6 +204,7 @@ Skills cover the full **AIDLC (AI-Driven Development Life Cycle)**: product defi
 | **Test Engineering (7)** | `/unit-test-designer` `/it-test-designer` `/scenario-test-designer` `/unit-test-logic-designer` `/it-test-logic-designer` `/scenario-test-logic-designer` `/test-coverage-checker` |
 | **Implementation (4)** | `/story-implementor` `/quick-implementor` `/implementation-planner` `/implementation-readiness-checker` |
 | **Verification (8)** | `/consistency-checker` `/cascade-updater` `/codex-delegator` `/codebase-mapper` `/doc-freshness-checker` `/pointer-validator` `/engineering-perspective` `/skill-creator` |
+| **Operations (2)** | `/phasegate-config-doctor` `/phasegate-toolkit-guide` |
 
 Details, prerequisites, and generated artifacts: [Skills Overview](docs/guide/skills-overview.md)
 
@@ -535,7 +536,7 @@ Detailed guides are available under `docs/guide/`:
 - [Installation](docs/guide/installation.md) -- Detailed install and setup instructions
 - [Configuration](docs/guide/configuration.md) -- `phasegate.config.json` full reference
 - [CLI Reference](docs/guide/cli-reference.md) -- All CLI commands and options
-- [Skills Overview](docs/guide/skills-overview.md) -- 28 skills with AIDLC execution order
+- [Skills Overview](docs/guide/skills-overview.md) -- 30 skills with AIDLC execution order
 - [5-Layer Defense Model](docs/guide/layer-model.md) -- L0-L4 layer details and HarnessError format
 - [Hooks Integration](docs/guide/hooks-integration.md) -- Claude Code Hooks setup and behavior
 - [Codex Integration](docs/guide/codex-integration.md) -- Codex CLI setup, coverage matrix, and native `apply_patch` limitation

package/docs/guide/cli-reference.md

@@ -359,6 +359,6 @@ ISSUE-005 P3-10 で明確化された境界:
 
 | Command | Options | Description |
 |---|---|---|
-| `p2:check-freshness` | `--pattern <glob>` `--dry-run` `--format text\|json` | Design doc freshness check |
-| `p2:validate-pointers` | `--include-urls` `--format text\|json` | Validate file pointers in docs |
+| `p2:check-freshness` | `--pattern <glob>` `--dry-run` `--format text\|json` | Compatibility entry point for L4-004 doc freshness; canonical L4 execution is `validate --layer L4` |
+| `p2:validate-pointers` | `--include-urls` `--format text\|json` | Compatibility entry point for L4-005 pointer validation; canonical L4 execution is `validate --layer L4` |
 | `p2:generate-e2e-template` | `--phase <phase>` `--output <path>` | Generate E2E test template |

package/docs/guide/installation.md

@@ -36,7 +36,7 @@ npm install
 npx phasegate init --name <project-name>
 ```
 
-This deploys 28 skills to `skills/`, creates the agent-facing skill links (for example `.claude/skills/` or `.codex/skills/`), and generates `phasegate.config.json`.
+This deploys 30 skills to `skills/`, creates the agent-facing skill links (for example `.claude/skills/` or `.codex/skills/`), and generates `phasegate.config.json`.
 
 `init` is the legacy-compatible bootstrap path for new projects. Use `install` when the project may already have hooks, package scripts, or CI files that should be preserved.
 

package/docs/guide/layer-model.md

@@ -141,7 +141,7 @@ npx phasegate validate --layer L3
 
 L4 validators are designed to run on a weekly schedule and detect slow-moving drift that accumulates over time.
 
-> **Status**: L4 is **disabled by default** (`layers.L4.enabled: false` in `phasegate.config.json`). Projects opt in by flipping the flag and scheduling the command via CI cron (see `ci:generate-template --type consistency-check`). Implementation-wise the validators listed below are functional; the default-off state is a conservative rollout choice, not a missing feature.
+> **Status**: L4 is **disabled by default** (`layers.L4.enabled: false` in `phasegate.config.json`). Projects opt in by flipping the flag and scheduling the command via CI cron (see `ci:generate-template --type consistency-check --render`). Implementation-wise the validators listed below are functional; the default-off state is a conservative rollout choice, not a missing feature. @work-item-id WI-128
 
 | Validator | ID | Description |
 |-----------|-----|-------------|
@@ -152,7 +152,16 @@ L4 validators are designed to run on a weekly schedule and detect slow-moving dr
 | **pointer-validation** | L4-005 | Resolves and validates design document pointers. Also available through the `p2:validate-pointers` compatibility command. |
 
 <!-- @work-item-id WI-116 -->
-`doc-freshness` and `pointer-validation` are registered as L4-004/L4-005. The standalone `p2:check-freshness` and `p2:validate-pointers` commands remain as compatibility entry points; WI-033's remaining scope is operational rollout, not validator registration.
+`doc-freshness` and `pointer-validation` are registered as L4-004/L4-005. The standalone `p2:check-freshness` and `p2:validate-pointers` commands remain as compatibility entry points; canonical L4 execution is `validate --layer L4`. WI-033 remains closed as validator registration work; WI-128 tracks scheduling/default/policy rollout.
+
+Recommended weekly audit:
+
+```bash
+npx phasegate ci:generate-template --type consistency-check --render
+npx phasegate validate --layer L4
+```
+
+Use a weekly cron such as `0 9 * * 1` for the generated consistency-check workflow. Standard projects normally keep L4 default-off and run the scheduled audit as advisory. Strict projects may opt into `layers.L4.enabled: true` and `failOnWarning` behavior when L4 warnings should block promotion. @work-item-id WI-128
 
 ### Drift-detect design pointers
 

package/docs/guide/quick-vs-full-mode.md

@@ -165,7 +165,7 @@ No. `allowedCategories` is a fixed enum (`bugfix`, `docs`, `test`, `config`). If
 
 ## Related
 
-- [Skills Overview](skills-overview.md) — full catalogue of 28 skills
+- [Skills Overview](skills-overview.md) — full catalogue of 30 skills
 - [Layer Model](layer-model.md) — L0 through L4 defence layers
 - [Configuration](configuration.md) — `quickMode` configuration reference
 - `skills/quick-implementor/SKILL.md` — the Quick Mode skill definition

package/docs/guide/retrofit-adoption.md

@@ -44,7 +44,7 @@ Step 4: 新規 Unit / 構造変更は scaffold-design で設計文書を起こ
 npx phasegate init --name <project-name>
 ```
 
-- `skills/` に 28 スキルを配置し、有効な agent 用に `.claude/skills` / `.codex/skills` を作成
+- `skills/` に 30 スキルを配置し、有効な agent 用に `.claude/skills` / `.codex/skills` を作成
 - `phasegate.config.json` を生成
 - `phasegate.config.json` に `baseline` セクションが未記載でも、v0.71.0 以降は
   **`baseline.enabled` の default が `true`** のため grandfather は既定で有効

package/docs/guide/skills-overview.md

@@ -1,6 +1,6 @@
 # Skills Overview
 
-Phasegate provides 28 skills covering the full AIDLC (AI-Driven Development Life Cycle). `npx phasegate init` deploys the skill bodies to `skills/` and exposes them to enabled agents through `.claude/skills/` / `.codex/skills/` links.
+Phasegate provides 30 skills covering the full AIDLC (AI-Driven Development Life Cycle). `npx phasegate init` deploys the skill bodies to `skills/` and exposes them to enabled agents through `.claude/skills/` / `.codex/skills/` links.
 
 ## AIDLC Process — Skill Execution Order
 
@@ -105,3 +105,10 @@ Skills run per User Story:
 | `/pointer-validator` | Validate file pointers (relative path references) in design documents. Detects broken links. |
 | `/engineering-perspective` | Design review from Kent Beck, Martin Fowler, Uncle Bob, and Eric Evans perspectives. Multi-angle quality evaluation. |
 | `/skill-creator` | Create and update Agent Skills. Packaging, scripting, references, and asset management. |
+
+### Operations (2 skills)
+
+| Skill | Description |
+|---|---|
+| `/phasegate-config-doctor` | Diagnose and explain PhaseGate configuration, installation, and hook setup issues. |
+| `/phasegate-toolkit-guide` | Operator guide for PhaseGate toolkit usage, rollout choices, and command selection. |

package/docs/templates/ci/consistency-check.yml

@@ -5,8 +5,8 @@
 #
 # 実行タイミング: 毎週月曜 09:00 UTC（手動トリガーも可）
 # 実行内容:
-#   1. harness:detect-drift   — L4 設計⇔コード乖離検出（drift-detect）
-#   2. harness:complete-check — L4 全バリデータ（drift-detect / consistency-check / dead-code）
+#   1. phasegate:detect-drift — L4 設計⇔コード乖離検出（drift-detect）
+#   2. validate --layer L4 — L4 全バリデータ（drift-detect / consistency-check / dead-code / doc-freshness / pointer-validation）
 #   3. 乖離検出時: GitHub Issue を自動作成
 
 name: AIDLC Consistency Check (Weekly)
@@ -46,7 +46,7 @@ jobs:
         id: drift
         run: |
           set +e
-          RESULT=$(pnpm run harness harness:detect-drift --json 2>&1)
+          RESULT=$(npx phasegate phasegate:detect-drift --json 2>&1)
           EXIT_CODE=$?
           echo "result<<EOF" >> $GITHUB_OUTPUT
           echo "$RESULT" >> $GITHUB_OUTPUT
@@ -54,12 +54,12 @@ jobs:
           echo "exit_code=$EXIT_CODE" >> $GITHUB_OUTPUT
           exit 0   # Issue作成のため常に続行
 
-      # L4: 全バリデータ（drift-detect + consistency-check + dead-code）
+      # L4: 全バリデータ（drift-detect + consistency-check + dead-code + doc-freshness + pointer-validation）
       - name: L4 Complete Check
         id: complete
         run: |
           set +e
-          RESULT=$(pnpm run harness harness:complete-check --json 2>&1)
+          RESULT=$(npx phasegate validate --layer L4 --format ci 2>&1)
           EXIT_CODE=$?
           echo "result<<EOF" >> $GITHUB_OUTPUT
           echo "$RESULT" >> $GITHUB_OUTPUT
@@ -95,7 +95,7 @@ jobs:
             body += '### 対処方法\n';
             body += '1. 乖離の内容を確認し、設計文書またはコードのどちらを修正すべきか判断\n';
             body += '2. `cascade-updater` スキルで設計文書を更新、または実装を修正\n';
-            body += '3. `pnpm run harness harness:detect-drift` で再検証して乖離が解消されたことを確認\n';
+            body += '3. `npx phasegate validate --layer L4` で再検証して乖離が解消されたことを確認\n';
 
             github.rest.issues.create({
               owner: context.repo.owner,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phasegate",
-  "version": "0.148.0",
+  "version": "0.150.0",
   "packageManager": "pnpm@10.30.1",
   "description": "Phasegate — AI-agnostic quality defense toolkit. Enforces structural integrity between design intent and code.",
   "license": "MIT",

package/scripts/harness/agent-integration/presentation/hook-skip-event-recorder.ts

@@ -0,0 +1,31 @@
+// @layer presentation
+// @unit agent-integration
+// @work-item-id WI-123
+
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+
+export async function recordHookSkipEvent(input: {
+  readonly projectRoot: string;
+  readonly hookType: string;
+  readonly reason: string;
+  readonly targetPaths: readonly string[];
+}): Promise<void> {
+  try {
+    const phasegateDir = path.join(input.projectRoot, '.phasegate');
+    await fs.mkdir(phasegateDir, { recursive: true });
+    const record = {
+      hookType: input.hookType,
+      reason: input.reason,
+      targetPaths: [...input.targetPaths],
+      observedAt: new Date().toISOString(),
+    };
+    await fs.appendFile(
+      path.join(phasegateDir, 'hook-skip-events.jsonl'),
+      `${JSON.stringify(record)}\n`,
+      'utf-8',
+    );
+  } catch {
+    // Hook skip recording is best-effort and must not change hook semantics.
+  }
+}

package/scripts/harness/agent-integration/presentation/post-tool-use-hook.ts

@@ -10,6 +10,7 @@ import { HandlePostToolUseUseCase } from '../application/usecases/handle-post-to
 import { HarnessConfigConfigQueryAdapter } from '../infrastructure/adapters/harness-config-config-query-adapter.js';
 import { HarnessApiCliCommandRegistryAdapter } from '../infrastructure/adapters/harness-api-cli-command-registry-adapter.js';
 import { ChildProcessCliExecutorAdapter } from '../infrastructure/adapters/child-process-cli-executor-adapter.js';
+import { recordHookSkipEvent } from './hook-skip-event-recorder.js';
 import * as path from 'node:path';
 import * as fs from 'node:fs/promises';
 
@@ -80,6 +81,12 @@ async function main(): Promise<void> {
     const output = await useCase.execute({ toolName, affectedFilePaths: [] });
 
     if (output.skipReason) {
+      await recordHookSkipEvent({
+        projectRoot: path.dirname(configPath),
+        hookType: 'post-tool-use',
+        reason: output.skipReason,
+        targetPaths: [],
+      });
       process.stderr.write(`スキップ: ${output.skipReason}\n`);
       process.exit(0);
     }

package/scripts/harness/agent-integration/presentation/stop-hook.ts

@@ -11,6 +11,7 @@ import { EnvFileReentryGuardStateAdapter } from '../infrastructure/adapters/env-
 import { HarnessConfigConfigQueryAdapter } from '../infrastructure/adapters/harness-config-config-query-adapter.js';
 import { HarnessApiCliCommandRegistryAdapter } from '../infrastructure/adapters/harness-api-cli-command-registry-adapter.js';
 import { ChildProcessCliExecutorAdapter } from '../infrastructure/adapters/child-process-cli-executor-adapter.js';
+import { recordHookSkipEvent } from './hook-skip-event-recorder.js';
 import * as path from 'node:path';
 import * as fs from 'node:fs/promises';
 
@@ -82,6 +83,12 @@ async function main(): Promise<void> {
     const output = await useCase.execute({ sessionId });
 
     if (output.skipReason === 'REENTRY_DETECTED') {
+      await recordHookSkipEvent({
+        projectRoot: path.dirname(configPath),
+        hookType: 'stop',
+        reason: output.skipReason,
+        targetPaths: [],
+      });
       process.stderr.write('ReentryGuard: 再入検出によりスキップ\n');
       process.exit(0);
     }

package/scripts/harness/ci-governance/domain/ports/validator-id-registry-port.ts

@@ -5,4 +5,5 @@
 
 export interface ValidatorIdRegistryPort {
   listAll(): Promise<string[]>;
+  listForPreset?(presetId: string, templateType: string): Promise<string[]>;
 }

package/scripts/harness/ci-governance/domain/services/template-generator.ts

@@ -31,8 +31,9 @@ export class TemplateGenerator {
     templateType: TemplateType,
   ): Promise<Result<TemplateConfig, Array<{ code: string; message: string }>>> {
     try {
+      const listValidatorIds = this.validatorIdRegistryPort.listForPreset ?? this.validatorIdRegistryPort.listAll;
       const [validatorIds, presetConfig] = await Promise.all([
-        this.validatorIdRegistryPort.listAll(),
+        listValidatorIds.call(this.validatorIdRegistryPort, presetId, templateType),
         this.presetConfigPort.getPreset(presetId),
       ]);
 

package/scripts/harness/ci-governance/infrastructure/adapters/validator-id-registry-adapter.ts

@@ -1,14 +1,42 @@
 // @unit ci-governance
 // @layer infrastructure
+// @work-item-id WI-124
 
 import type { ValidatorIdRegistryPort } from '../../domain/ports/validator-id-registry-port.js';
+import { buildDefaultRegistry } from '../../../validator-system/composition-root.js';
+import type { ValidatorDefinition } from '../../../validator-system/domain/value-objects/validator-definition.js';
+
+type PresetId = 'minimal' | 'standard' | 'strict';
 
 export class ValidatorIdRegistryAdapter implements ValidatorIdRegistryPort {
   constructor(private readonly registryUrl?: string) {}
 
   async listAll(): Promise<string[]> {
-    // In a real implementation, would fetch from validator-system
-    // For now, returns a stub list
-    return ['L1-001', 'L2-001', 'L2-002', 'L3-001', 'L4-001'];
+    void this.registryUrl;
+    return buildDefaultRegistry().getAllDefinitions().map((definition) => definition.validatorId.value);
+  }
+
+  async listForPreset(presetId: string, templateType: string): Promise<string[]> {
+    const preset = normalizePreset(presetId);
+    const definitions = buildDefaultRegistry().getAllDefinitions();
+    return definitions
+      .filter((definition) => isIncludedForPreset(definition, preset, templateType))
+      .map((definition) => definition.validatorId.value);
+  }
+}
+
+function normalizePreset(presetId: string): PresetId {
+  return presetId === 'minimal' || presetId === 'strict' ? presetId : 'standard';
+}
+
+function isIncludedForPreset(definition: ValidatorDefinition, preset: PresetId, templateType: string): boolean {
+  if (preset === 'minimal') return false;
+  if (definition.layer === 'L4') {
+    if (templateType === 'consistency-check') return true;
+    if (preset !== 'strict') return false;
+  }
+  if (definition.enabledCondition === 'strictOnly') {
+    return preset === 'strict' || (definition.layer === 'L4' && templateType === 'consistency-check');
   }
+  return true;
 }

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
+// @work-item-id WI-108 / WI-114
 // command-dispatch-service.ts — CommandDispatchService Domain Service
 
 import { CommandRegistry } from './command-registry.js';
@@ -16,6 +16,7 @@ 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';
 
 export interface CommandDispatchPorts {
   validatorExecutionPort: ValidatorExecutionPort;
@@ -23,7 +24,13 @@ export interface CommandDispatchPorts {
   biomeLintPort: BiomeLintPort;
   impactAnalysisPort: ImpactAnalysisPort;
   artifactScannerPort: ArtifactScannerPort;
-  configQueryPort: { getConfig?: () => Promise<unknown>; getPresetInfo?: () => Promise<unknown>; getConfigSummary?: () => Promise<unknown> };
+  configQueryPort: {
+    getConfig?: () => Promise<unknown>;
+    getPresetInfo?: () => Promise<unknown>;
+    getConfigSummary?: () => Promise<unknown>;
+    getHookHealth?: () => Promise<HookHealth>;
+    getBaselineHealth?: () => Promise<BaselineHealth>;
+  };
 }
 
 export interface DispatchResult<T = unknown> {
@@ -61,6 +68,38 @@ function summarizeLayerResults(items: readonly { validatorId: string; passed: bo
   return result;
 }
 
+function buildOperationalWarnings(
+  hookHealth: HookHealth | undefined,
+  baselineHealth: BaselineHealth | undefined,
+): OperationalWarning[] {
+  const warnings: OperationalWarning[] = [];
+  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',
+      message: `Hook skip events observed: ${skipCount}`,
+      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',
+      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.',
+    });
+  }
+  if (baselineHealth !== undefined && baselineHealth.grandfatheredFileCount > 50 && baselineHealth.removalRate < 0.5) {
+    warnings.push({
+      code: 'BASELINE_DEBT_HIGH',
+      message: `Baseline grandfather debt remains high: ${baselineHealth.grandfatheredFileCount} files.`,
+      nextAction: 'Plan a retrofit cleanup batch and reduce the baseline snapshot.',
+    });
+  }
+  return warnings;
+}
+
 const KNOWN_COMMANDS = new Set([
   'phasegate:check-ready',
   'phasegate:check-phase',
@@ -203,12 +242,20 @@ export class CommandDispatchService {
         } else if (configPort.getConfig) {
           await configPort.getConfig();
         }
+        const [hookHealth, baselineHealth] = await Promise.all([
+          configPort.getHookHealth?.(),
+          configPort.getBaselineHealth?.(),
+        ]);
+        const operationalWarnings: OperationalWarning[] = buildOperationalWarnings(hookHealth, baselineHealth);
         const statusSummary = this.statusDerivationService.derive({
           scanResult,
           presetInfo,
           configSummary: { configPath: 'phasegate.config.json', lastModified: '', version: '2' },
           phaseGateSummary: { totalStories: 0, passedStories: 0, pendingStories: 0 },
           liveValidationByLayer,
+          hookHealth,
+          baselineHealth,
+          operationalWarnings,
         });
         const r = HarnessApiResponse.pass({ ...summary, passed: 1 }, statusSummary);
         return { status: 'pass', errors: [], summary: r.summary, data: statusSummary as unknown as T, exitCode: 0 };

package/scripts/harness/harness-api/domain/services/status-derivation-service.ts

@@ -1,9 +1,10 @@
 // @layer domain
 // @unit harness-api
+// @work-item-id WI-112
 // 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 } from '../value-objects/harness-status-summary.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'];
@@ -90,6 +91,9 @@ export class StatusDerivationService {
     configSummary: ConfigSummary;
     phaseGateSummary: PhaseGateSummary;
     liveValidationByLayer?: Partial<Record<LayerId, 'pass' | 'fail' | 'skipped' | 'not-run' | 'error'>>;
+    hookHealth?: HookHealth;
+    baselineHealth?: BaselineHealth;
+    operationalWarnings?: readonly OperationalWarning[];
   }): HarnessStatusSummary {
     const { scanResult, presetInfo, configSummary, phaseGateSummary, liveValidationByLayer } = input;
 
@@ -135,6 +139,9 @@ export class StatusDerivationService {
       phaseGateSummary,
       presetInfo,
       configSummary,
+      hookHealth: input.hookHealth,
+      baselineHealth: input.baselineHealth,
+      operationalWarnings: input.operationalWarnings,
     });
   }
 }

package/scripts/harness/harness-api/domain/value-objects/drift-report-summary.ts

@@ -1,5 +1,6 @@
 // @layer domain
 // @unit harness-api
+// @work-item-id WI-114
 // drift-report-summary.ts — DriftReportSummary Value Object
 
 export interface DriftItem {

package/scripts/harness/harness-api/domain/value-objects/harness-status-summary.ts

@@ -20,11 +20,48 @@ export interface ConfigSummary {
   version: string;
 }
 
+export interface HookSkipState {
+  hookType: string;
+  reason: 'HOOK_DISABLED' | 'TIMEOUT_EXCEEDED' | 'REENTRY_DETECTED' | string;
+  targetPaths: readonly string[];
+  observedAt: string;
+}
+
+export interface HookHealth {
+  enabled: boolean;
+  configuredHooks: readonly string[];
+  latestSkip: HookSkipState | null;
+  skipCountsByReason: Readonly<Record<string, number>>;
+  applyPatchBypass: {
+    nativeApplyPatchIntercepted: boolean;
+    backstop: 'pre-commit';
+    documentationUrl: string;
+  };
+}
+
+export interface BaselineHealth {
+  enabled: boolean;
+  path: string;
+  grandfatheredFileCount: number;
+  shaMismatchCount: number;
+  missingFileCount: number;
+  removalRate: number;
+}
+
+export interface OperationalWarning {
+  code: string;
+  message: string;
+  nextAction: string;
+}
+
 export interface HarnessStatusSummaryProps {
   layers: readonly LayerHealth[];
   phaseGateSummary: PhaseGateSummary;
   presetInfo: PresetInfo;
   configSummary: ConfigSummary;
+  hookHealth?: HookHealth;
+  baselineHealth?: BaselineHealth;
+  operationalWarnings?: readonly OperationalWarning[];
 }
 
 const REQUIRED_LAYER_IDS: readonly LayerId[] = ['L1', 'L2', 'L3', 'L4'];
@@ -34,12 +71,18 @@ export class HarnessStatusSummary {
   readonly phaseGateSummary: PhaseGateSummary;
   readonly presetInfo: PresetInfo;
   readonly configSummary: ConfigSummary;
+  readonly hookHealth: HookHealth | undefined;
+  readonly baselineHealth: BaselineHealth | undefined;
+  readonly operationalWarnings: readonly OperationalWarning[];
 
   private constructor(props: HarnessStatusSummaryProps) {
     this.layers = Object.freeze([...props.layers]);
     this.phaseGateSummary = props.phaseGateSummary;
     this.presetInfo = props.presetInfo;
     this.configSummary = props.configSummary;
+    this.hookHealth = props.hookHealth;
+    this.baselineHealth = props.baselineHealth;
+    this.operationalWarnings = Object.freeze([...(props.operationalWarnings ?? [])]);
     Object.freeze(this);
   }
 

package/scripts/harness/harness-api/domain/value-objects/layer-health.ts

@@ -1,5 +1,6 @@
 // @layer domain
 // @unit harness-api
+// @work-item-id WI-112
 // layer-health.ts — LayerHealth Value Object
 
 export type LayerId = 'L1' | 'L2' | 'L3' | 'L4';

package/scripts/harness/harness-api/infrastructure/adapters/harness-config-query-adapter.ts

@@ -1,10 +1,13 @@
 // @layer infrastructure
 // @unit harness-api
+// @work-item-id WI-123
 // harness-config-query-adapter.ts — HarnessConfigQueryAdapter
 
 import * as fs from 'node:fs/promises';
+import { createHash } from 'node:crypto';
+import { dirname, join, resolve } from 'node:path';
 import type { ConfigQueryPort } from '../../domain/ports/config-query-port.js';
-import type { PresetInfo, ConfigSummary, PhaseGateSummary } from '../../domain/value-objects/harness-status-summary.js';
+import type { PresetInfo, ConfigSummary, PhaseGateSummary, HookHealth, BaselineHealth } from '../../domain/value-objects/harness-status-summary.js';
 import type { LayerId } from '../../domain/value-objects/layer-health.js';
 
 interface HarnessConfigJson {
@@ -18,6 +21,10 @@ interface HarnessConfigJson {
     designDocs?: string;
     integrationTests?: string;
   };
+  baseline?: {
+    enabled?: boolean;
+    path?: string;
+  };
 }
 
 const PRESET_LAYERS: Record<string, LayerId[]> = {
@@ -77,4 +84,87 @@ export class HarnessConfigQueryAdapter implements ConfigQueryPort {
     // wave2-pending: integrate with phase-dependency-model
     return { totalStories: 0, passedStories: 0, pendingStories: 0 };
   }
+
+  async getHookHealth(): Promise<HookHealth> {
+    const rootDir = dirname(this.configPath);
+    const configuredHooks: string[] = [];
+    for (const hookPath of ['.claude/settings.json', '.codex/hooks.json', '.husky/pre-commit', '.husky/pre-push']) {
+      try {
+        await fs.access(join(rootDir, hookPath));
+        configuredHooks.push(hookPath);
+      } catch {
+        // Missing hook files are represented by absence from configuredHooks.
+      }
+    }
+
+    const skipEvents = await readHookSkipEvents(join(rootDir, '.phasegate/hook-skip-events.jsonl'));
+    const skipCountsByReason: Record<string, number> = {};
+    for (const event of skipEvents) {
+      skipCountsByReason[event.reason] = (skipCountsByReason[event.reason] ?? 0) + 1;
+    }
+
+    return {
+      enabled: configuredHooks.length > 0,
+      configuredHooks,
+      latestSkip: skipEvents.at(-1) ?? null,
+      skipCountsByReason,
+      applyPatchBypass: {
+        nativeApplyPatchIntercepted: false,
+        backstop: 'pre-commit',
+        documentationUrl: 'docs/guide/codex-integration.md',
+      },
+    };
+  }
+
+  async getBaselineHealth(): Promise<BaselineHealth> {
+    const config = await this.readConfig();
+    const rootDir = dirname(this.configPath);
+    const enabled = config.baseline?.enabled ?? true;
+    const relativePath = config.baseline?.path ?? '.phasegate/baseline.json';
+    const baselinePath = resolve(rootDir, relativePath);
+
+    if (!enabled) {
+      return { enabled: false, path: relativePath, grandfatheredFileCount: 0, shaMismatchCount: 0, missingFileCount: 0, removalRate: 0 };
+    }
+
+    let raw: string;
+    try {
+      raw = await fs.readFile(baselinePath, 'utf-8');
+    } catch {
+      return { enabled: true, path: relativePath, grandfatheredFileCount: 0, shaMismatchCount: 0, missingFileCount: 0, removalRate: 0 };
+    }
+
+    const parsed = JSON.parse(raw) as { files?: Array<{ path?: string; sha1?: string }>; entries?: Array<{ path?: string; sha1?: string }> };
+    const entries = parsed.files ?? parsed.entries ?? [];
+    let shaMismatchCount = 0;
+    let missingFileCount = 0;
+    for (const entry of entries) {
+      if (typeof entry.path !== 'string' || typeof entry.sha1 !== 'string') continue;
+      try {
+        const current = await fs.readFile(resolve(rootDir, entry.path));
+        const sha1 = createHash('sha1').update(current).digest('hex');
+        if (sha1 !== entry.sha1) shaMismatchCount += 1;
+      } catch {
+        missingFileCount += 1;
+      }
+    }
+    const grandfatheredFileCount = entries.length;
+    const removalRate = grandfatheredFileCount === 0
+      ? 1
+      : (shaMismatchCount + missingFileCount) / grandfatheredFileCount;
+    return { enabled: true, path: relativePath, grandfatheredFileCount, shaMismatchCount, missingFileCount, removalRate };
+  }
+}
+
+async function readHookSkipEvents(filePath: string): Promise<Array<NonNullable<HookHealth['latestSkip']>>> {
+  try {
+    const raw = await fs.readFile(filePath, 'utf-8');
+    return raw
+      .split('\n')
+      .filter((line) => line.trim().length > 0)
+      .map((line) => JSON.parse(line) as HookHealth['latestSkip'])
+      .filter((event): event is NonNullable<HookHealth['latestSkip']> => event !== null);
+  } catch {
+    return [];
+  }
 }

package/scripts/harness/main.ts

@@ -1,7 +1,7 @@
 /**
  * @unit harness-api
  * @layer presentation
- * @work-item-id WI-142
+ * @work-item-id WI-113 / WI-142
  *
  * Phasegate CLI エントリポイント。
  * 各Unitの Composition Root からハンドラーを取得し、コマンドに応じてディスパッチする。

package/scripts/harness/phase-dependency-model/infrastructure/filesystem/file-system-story-reflection-adapter.ts

@@ -1,6 +1,7 @@
 /**
  * @layer infrastructure
  * @unit phase-dependency-model
+ * @work-item-id WI-115
  */
 
 import type { Dirent } from "node:fs";

package/scripts/harness/validator-system/composition-root.ts

@@ -55,7 +55,7 @@ const DEFAULT_CONFIG = {
 };
 
 /** バリデータ定義カタログ */
-function buildDefaultRegistry(): ValidatorRegistry {
+export function buildDefaultRegistry(): ValidatorRegistry {
   const defaultRule = ValidationRule.create({
     ruleName: 'default-rule',
     errorTemplate: { code: 'L2-001', severity: 'error', messageTemplate: '{{message}}' },

package/scripts/harness/validator-system/domain/value-objects/validator-id.ts

@@ -1,6 +1,7 @@
 /**
  * @layer domain
  * @unit validator-system
+ * @work-item-id WI-116
  *
  * ValidatorId 値オブジェクト
  * L1-001〜L4-005 のバリデータを識別する不変値オブジェクト

package/scripts/harness/validator-system/presentation/handlers/run-validators-handler.ts

@@ -1,6 +1,7 @@
 /**
  * @layer presentation
  * @unit validator-system
+ * @work-item-id WI-113
  *
  * RunValidatorsHandler — バリデータ実行 CLIハンドラー
  */