phasegate 0.132.0 → 0.134.0

package/CHANGELOG.md

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.134.0] - 2026-05-08
+
+### Changed
+
+- **WI-034: L0 legacy validator (`L0-001` / `L0-002`) の撤去** — `validator-system` から FUSE 時代の未実装 validator 定義と `RunL0ValidatorsUseCase` を削除し、config schema / `phasegate.config.json` から `layers.L0` を撤去。`list-errors --layer L0` は空のままになり、`validate --layer L0` は runtime L0 が agent-integration hooks と Husky hooks で提供される旨の案内を表示して exit 0 で終了する。
+  - **Migration guide**: CI で `phasegate validate --layer L0` を実行していた場合、そのジョブは削除してください。L0 相当の防御は `.claude/settings.json` / `.codex/hooks.json` の runtime hook と `.husky/pre-commit` / `.husky/commit-msg` で有効化し、CI 側は `phasegate validate --layer L2` / `--layer L3` / `--layer L4` または `--layer all` に移行します。
+
+## [0.133.0] - 2026-05-08
+
+### Added
+
+- **WI-095 — L4-001 drift-detect の design pointers 対応** — 設計見出し直下の `<!-- pointers: ... -->` / `<pointers>` block で実装ファイルpathを明示できるようにし、設計名とcode export名が異なる移行中ケースのfalse positiveを抑制。ADR-018でsyntaxとORセマンティクスを定義。
+  - **post-publish dogfood**: `/private/tmp/phasegate-dogfood-0.133.0` で `npx phasegate@0.133.0 phasegate:detect-drift --json` を実行。設計見出し `UserProfile` に `<!-- pointers: scripts/harness/sample-unit/domain/user-profile.ts -->` を付け、コード側は `export class UserProfileV2 {}` とした状態で `drifts: [] / totalCount: 0` を確認。
+
+### Fixed
+
+- **WI-096 — `phasegate:status` が `layers.L?.enabled` user override を表示に反映しない問題を修正** — status表示用のenabledLayersをpreset値と明示overrideから合成し、`strict + L4.enabled:false` / `minimal + L4.enabled:true` の双方に対応。
+  - **post-publish dogfood**: `npx phasegate@0.133.0 phasegate:status --json` で `project.preset: "minimal" + layers.L4.enabled: true` の L4 `enabled: true`、および `project.preset: "strict" + layers.L4.enabled: false` の L4 `enabled: false` を確認。
+
 ## [0.132.0] - 2026-05-08
 
 ### Fixed

package/README.ja.md

@@ -161,8 +161,6 @@ npx phasegate update-skills   # スキルを最新版に再デプロイ
 
 エラーは `HarnessError` 形式（理由 / ADR 参照 / 修正例）で返されるため、AI agent が自己修正できます。
 
-> `--layer L0` の `L0-001` / `L0-002` は legacy validator で `enabled: false`。実体の L0 は agent-integration の hook と Husky です。
-
 詳細: [5-Layer Defense Model](docs/guide/layer-model.md)
 
 ---
@@ -238,7 +236,7 @@ L2-STORY-REFLECTION バリデータがこのアノテーションを検出し、
   "project":   { "name": "my-project", "preset": "standard" },
   "architecture": { "preset": "clean" },
   "layers": {
-    "L0": { "enabled": false }, "L1": { "enabled": true },
+    "L1": { "enabled": true },
     "L2": { "enabled": true  }, "L3": { "enabled": true  },
     "L4": { "enabled": false }
   },
@@ -456,7 +454,6 @@ reports/
 | **[WI-031](docs/inception/_cross/WI-031/description.md)** | CI template の二系統統一 + `phasegate init --with-ci` |
 | **[WI-032](docs/inception/_cross/WI-032/description.md)** | AGENTS.md / CLAUDE.md auto-refresh パイプライン |
 | **[WI-033](docs/inception/_cross/WI-033/description.md)** | `doc-freshness` / `pointer-validation` を L4 validator に昇格 |
-| **[WI-034](docs/inception/_cross/WI-034/description.md)** | L0 legacy validator (`L0-001` / `L0-002`) の撤去 |
 
 L3 Nyquist Validation の `requirement-test-matrix.json` 自動生成はまだ未自動化です。現時点では手動セットアップで利用できます。
 

package/README.md

@@ -157,8 +157,6 @@ npx phasegate update-skills
 | L3 | CI/CD pipeline | Security, performance, coverage (90%/95%), requirements traceability |
 | L4 | Scheduled (weekly). Currently `layers.L4.enabled: false` by default — opt-in per project | Design-code drift, cross-document consistency, dead code, doc freshness, pointer validation |
 
-> The `L0-001` / `L0-002` validators that appear in `list-errors --layer L0` output are legacy definitions from an earlier design and are disabled by default (`layers.L0.enabled: false`). The runtime L0 enforcement happens via the agent-integration hook scripts and Husky git hooks listed above, not via those validators.
-
 ---
 
 ## 28 Skills
@@ -339,7 +337,6 @@ For selection guidance and config examples see [Preset Selection Guide](docs/gui
 {
   "project": { "name": "my-project", "preset": "standard" },
   "layers": {
-    "L0": { "enabled": false },
     "L1": { "enabled": true },
     "L2": { "enabled": true },
     "L3": { "enabled": true },
@@ -468,7 +465,7 @@ npx phasegate <command> [options]
 |---|---|
 | `init --name <name>` | Initialize project, deploy skills, generate config |
 | `lint` | Run L1 Biome AST checks |
-| `validate --layer <L1-L4\|all>` | Run validators for specified layer |
+| `validate --layer <L2-L4\|all>` | Run validators for specified layer (`--layer L0` prints runtime hook guidance) |
 | `ci-check` | Full CI check (L2-L4) |
 | `update-skills` | Update skills to latest version |
 | `phasegate:status` | Display overall harness health summary |
@@ -518,7 +515,6 @@ The main path is ready for project use, but a few documented behaviors still req
 | **[WI-031](docs/inception/_cross/WI-031/description.md)** | CI template unification + `phasegate init --with-ci` | Today the bundled YAML and the `ci:generate-template` output diverge (different cron schedule, only the bundled one creates GitHub Issues). `phasegate init` does not deploy the workflow, so L4 only runs after the user manually copies the file. WI-031 unifies the two paths and adds an opt-in deploy flag. |
 | **[WI-032](docs/inception/_cross/WI-032/description.md)** | AGENTS.md / CLAUDE.md auto-refresh pipeline | `ci:migrate-agents-md` exists as a one-shot CLI but there is no scheduled job, and CLAUDE.md is fully hand-maintained. WI-032 adds an `auto-refresh-agent-context` workflow plus a template-driven CLAUDE.md regenerator that preserves user-owned sections. |
 | **[WI-033](docs/inception/_cross/WI-033/description.md)** | Promote `doc-freshness` / `pointer-validation` to L4 validators | Both capabilities exist as `p2:check-freshness` / `p2:validate-pointers` CLI commands but are not registered as L4 validators, so `validate --layer L4` skips them. WI-033 plumbs them through `validator-system` so they run via the standard L4 path and presets. |
-| **[WI-034](docs/inception/_cross/WI-034/description.md)** | Retire legacy L0 validators (`L0-001` / `L0-002`) | The `fuse-hook-config` / `fuse-mount-status` validator IDs are leftovers from an earlier FUSE-based design. They are disabled by default and have no actual implementation behind them. WI-034 removes them and lets the agent-integration runtime hooks be the sole L0 surface. |
 
 `requirement-test-matrix.json` auto-generation for L3 Nyquist Validation is not automated yet; see the L3 guide for the current manual setup.
 

package/docs/ADR/ADR-018-drift-detect-pointers.md

@@ -0,0 +1,47 @@
+# ADR-018: drift-detect の design pointers 仕様
+
+## Status
+
+Accepted — 2026-05-08
+
+## Context
+
+L4-001 `drift-detect` は設計文書の `##` / `###` 見出しから抽出した要素名と、TypeScript source の export 名を双方向に比較する。WI-091 で括弧 qualifier の normalize は導入済みだが、次のようなケースでは依然として false positive が起きる。
+
+- 設計名と実装 export 名が移行期間中だけ異なる
+- 設計文書では業務概念名、コードではより具体的な型名を使う
+- 同名・類似名の要素が複数 unit に存在し、ファイル path で対応を示したい
+- 実装ファイル名は安定しているが export 名を変更している
+
+GitHub Issue #4 の follow-up として WI-095 を起票した。
+
+## Decision
+
+設計見出し単位で、対応する実装ファイル path を明示できる `pointers` を導入する。初期実装では以下の2形式を正式に受け付ける。
+
+```markdown
+## UserProfile
+<!-- pointers: scripts/harness/user/domain/user-profile.ts -->
+```
+
+```markdown
+## UserProfile
+<pointers>
+  - scripts/harness/user/domain/user-profile.ts
+  - scripts/harness/user/domain/user-profile-types.ts
+</pointers>
+```
+
+セマンティクスは以下とする。
+
+- pointers がない要素は従来通り、設計要素名と code export 名の完全一致で判定する
+- pointers がある設計要素は、いずれか1つの pointer が code export の定義ファイル path と一致すれば、設計→コード drift とみなさない
+- pointer で対応付けられた code export は、名前が設計要素名と異なっていても code→design drift とみなさない
+- 複数 pointer は OR として扱う
+- path 比較は POSIX separator に正規化し、絶対 path の末尾が pointer と一致する場合も一致とする
+
+## Consequences
+
+`DesignDocumentPort` は後方互換のため既存 `getElements()` を維持し、optional な `getElementPointers()` を追加する。`SourceCodeAnalyzerPort` も optional な `getElementFilePathMap()` を追加する。両 optional port が未実装の場合、`DriftDetectionService` は従来挙動のまま動作する。
+
+YAML fenced metadata は今回採用しない。Markdown本文の構造と混ざりやすく、既存のコードブロック抽出や設計例との衝突リスクが高いため、必要になった時点で別ADRで拡張する。

package/docs/guide/configuration.md

@@ -15,7 +15,6 @@ This file is the **Single Source of Truth** for all quality configuration in a P
     "preset": "standard"       // "minimal" | "standard" | "strict"
   },
   "layers": {
-    "L0": { "enabled": false },
     "L1": { "enabled": true },
     "L2": { "enabled": true },
     "L3": { "enabled": true },

package/docs/guide/layer-model.md

@@ -52,13 +52,13 @@ Deployed by `phasegate init --with-husky` into `.husky/`.
 | **.husky/pre-commit** | `npx phasegate pre-commit` | Runs L2 validators (phase-gate / metadata / story-reflection / test-quality) on staged files. Fails the commit on violation. |
 | **.husky/commit-msg** | `npx phasegate commit-msg $1` | Enforces the `Work-Item: WI-XXX` trailer when WI directories or their contents are staged. Ensures every commit is traceable to a work item. |
 
-### About the `validate --layer L0` CLI
+### About `validate --layer L0`
 
 ```bash
 npx phasegate validate --layer L0
 ```
 
-`list-errors --layer L0` surfaces `L0-001 fuse-hook-config` / `L0-002 fuse-mount-status` — these are **legacy validator definitions** from an earlier design and are disabled by default (`layers.L0.enabled: false`). The **runtime L0 enforcement happens via the agent-runtime hooks and Husky git hooks above**, not via those validators.
+`validate --layer L0` is kept as a compatibility alias that prints guidance and exits successfully. Runtime L0 enforcement happens via the agent-runtime hooks and Husky git hooks above. `list-errors --layer L0` returns no validator definitions.
 
 ---
 
@@ -150,6 +150,27 @@ L4 validators are designed to run on a weekly schedule and detect slow-moving dr
 
 > **Note (2026-04-25)**: `doc-freshness` and `pointer-validation` capabilities exist as standalone CLI commands `p2:check-freshness` and `p2:validate-pointers` (implemented in the `phase2-extensions` unit), **not as L4 validators yet**. Promoting them to L4-004 / L4-005 is tracked as **WI-033**. Until that lands, run them explicitly via `npx phasegate p2:check-freshness` / `p2:validate-pointers`.
 
+### Drift-detect design pointers
+
+L4-001 normally matches design headings to code exports by name. When a heading intentionally maps to a differently named implementation file, add a pointer directly under the heading:
+
+```markdown
+## UserProfile
+<!-- pointers: scripts/harness/user/domain/user-profile.ts -->
+```
+
+For multiple files:
+
+```markdown
+## UserProfile
+<pointers>
+  - scripts/harness/user/domain/user-profile.ts
+  - scripts/harness/user/domain/user-profile-types.ts
+</pointers>
+```
+
+Pointers are optional and backward compatible. If any listed path matches the file defining a code export, drift-detect treats that design heading and export as corresponding even when their names differ.
+
 **Command:**
 
 ```bash
@@ -206,14 +227,14 @@ History: prior to v0.131.0, the aggregator's `failOnWarning` flag was effectivel
 
 Presets control which layers are active. Choose based on project maturity and team discipline.
 
-| Preset     | L0  | L1  | L2  | L3  | L4  |
+| Preset     | L0 hooks | L1  | L2  | L3  | L4  |
 |------------|-----|-----|-----|-----|-----|
-| `minimal`  | off | on  | on  | off | off |
-| `standard` | off | on  | on  | on  | off |
-| `strict`   | on  | on  | on  | on  | on  |
+| `minimal`  | installed separately | on  | on  | off | off |
+| `standard` | installed separately | on  | on  | on  | off |
+| `strict`   | installed separately | on  | on  | on  | on  |
 
 - **minimal** — Suitable for early prototyping. Editor-time rules and pre-commit checks only.
 - **standard** — Recommended for active development. Adds CI/CD validators for security, performance, coverage, and traceability.
-- **strict** — Full defense. Enables the Hooks Engine (L0) and scheduled drift detection (L4). Use for production-critical codebases.
+- **strict** — Full defense. Enables scheduled drift detection (L4). Runtime L0 hooks are configured through the agent and Husky hook files, not through validator presets.
 
 Presets are configured in `phasegate.config.json`, the single source of truth for all quality settings.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phasegate",
-  "version": "0.132.0",
+  "version": "0.134.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/config-foundation/infrastructure/schemas/harness-config-v2.schema.json

@@ -68,22 +68,6 @@
       "type": "object",
       "additionalProperties": false,
       "properties": {
-        "L0": {
-          "type": "object",
-          "additionalProperties": false,
-          "properties": {
-            "enabled": {
-              "type": "boolean"
-            },
-            "validators": {
-              "type": "array",
-              "items": {
-                "type": "string"
-              },
-              "uniqueItems": true
-            }
-          }
-        },
         "L1": {
           "type": "object",
           "additionalProperties": false,

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

@@ -68,22 +68,6 @@
       "type": "object",
       "additionalProperties": false,
       "properties": {
-        "L0": {
-          "type": "object",
-          "additionalProperties": false,
-          "properties": {
-            "enabled": {
-              "type": "boolean"
-            },
-            "validators": {
-              "type": "array",
-              "items": {
-                "type": "string"
-              },
-              "uniqueItems": true
-            }
-          }
-        },
         "L1": {
           "type": "object",
           "additionalProperties": false,

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

@@ -1,4 +1,5 @@
 // @layer infrastructure
+// @unit harness-api
 // harness-config-query-adapter.ts — HarnessConfigQueryAdapter
 
 import * as fs from 'node:fs/promises';
@@ -12,6 +13,7 @@ interface HarnessConfigJson {
     name: string;
     preset: 'minimal' | 'standard' | 'strict';
   };
+  layers?: Partial<Record<LayerId, { enabled?: boolean }>>;
   paths?: {
     designDocs?: string;
     integrationTests?: string;
@@ -46,7 +48,18 @@ export class HarnessConfigQueryAdapter implements ConfigQueryPort {
   async getPresetInfo(): Promise<PresetInfo> {
     const config = await this.readConfig();
     const preset = config.project.preset;
-    const enabledLayers = PRESET_LAYERS[preset] ?? ['L1', 'L2', 'L3'];
+    const presetLayers = PRESET_LAYERS[preset] ?? ['L1', 'L2', 'L3'];
+    const enabledLayerSet = new Set<LayerId>(presetLayers);
+
+    for (const [layerId, layerConfig] of Object.entries(config.layers ?? {}) as [LayerId, { enabled?: boolean }][]) {
+      if (layerConfig.enabled === true) {
+        enabledLayerSet.add(layerId);
+      } else if (layerConfig.enabled === false) {
+        enabledLayerSet.delete(layerId);
+      }
+    }
+
+    const enabledLayers = (['L1', 'L2', 'L3', 'L4'] as const).filter((layerId) => enabledLayerSet.has(layerId));
     return { name: preset, enabledLayers };
   }
 

package/scripts/harness/main.ts

@@ -110,7 +110,7 @@ Commands:
 
   lint                         Run lint checks (--json, --target <path>)
 
-  validate                     Run validators (--layer L0|L2|L3|L4|all, --unit, --format human|agent|ci)
+  validate                     Run validators (--layer L2|L3|L4|all; L0 prints runtime hook info, --unit, --format human|agent|ci)
   ci-check                     CI check (--quick for quick mode, --fail-on-reject, --dry-run, --files)
 
   phasegate:check-ready         Check ready status (--json)
@@ -263,10 +263,10 @@ Options:
   --help, -h                      Show this help`,
   validate: `Usage: phasegate validate [options]
 
-Run validators against the project. Without --layer, runs all enabled layers (L0/L2/L3/L4).
+Run validators against the project. Without --layer, runs all enabled validator layers (L2/L3/L4).
 
 Options:
-  --layer <L0|L2|L3|L4>           Run only the specified layer
+  --layer <L0|L2|L3|L4>           Run only the specified validator layer; L0 prints runtime hook info
   --json                          Output machine-readable JSON
   --help, -h                      Show this help`,
   lint: `Usage: phasegate lint [options]

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

@@ -10,7 +10,6 @@ import { ValidationRule } from './domain/value-objects/validation-rule.js';
 import { ValidatorRegistry } from './domain/services/validator-registry.js';
 import { ValidatorExecutionService } from './domain/services/validator-execution-service.js';
 import { ValidationResultContractMapper } from './application/mappers/validation-result-contract-mapper.js';
-import { RunL0ValidatorsUseCase } from './application/use-cases/run-l0-validators-usecase.js';
 import { RunL2ValidatorsUseCase } from './application/use-cases/run-l2-validators-usecase.js';
 import { RunL3ValidatorsUseCase } from './application/use-cases/run-l3-validators-usecase.js';
 import { RunL4ValidatorsUseCase } from './application/use-cases/run-l4-validators-usecase.js';
@@ -45,7 +44,6 @@ import { join } from 'node:path';
 const DEFAULT_CONFIG = {
   preset: 'standard' as const,
   layers: {
-    L0: { enabled: true, validators: ['L0-001', 'L0-002'] },
     L2: { enabled: true, validators: ['L2-001', 'L2-002', 'L2-003'] },
     L3: { enabled: true, validators: ['L3-001', 'L3-002', 'L3-003', 'L3-004'], coverageThreshold: 90, bundleSizeLimit: 512000 },
     L4: { enabled: true, validators: ['L4-001', 'L4-002', 'L4-003'] },
@@ -61,7 +59,7 @@ function buildDefaultRegistry(): ValidatorRegistry {
     fixExample: null,
   });
 
-  const createDef = (id: string, layer: 'L0' | 'L2' | 'L3' | 'L4', enabledCondition: 'always' | 'strictOnly' = 'always', externalPolicyRef: string | null = null) =>
+  const createDef = (id: string, layer: 'L2' | 'L3' | 'L4', enabledCondition: 'always' | 'strictOnly' = 'always', externalPolicyRef: string | null = null) =>
     ValidatorDefinition.create({
       validatorId: ValidatorId.create(id),
       layer,
@@ -75,7 +73,6 @@ function buildDefaultRegistry(): ValidatorRegistry {
     });
 
   const definitions = [
-    createDef('L0-001', 'L0', 'always'),
     createDef('L2-001', 'L2', 'always', 'PhaseGatePolicyPort'),
     createDef('L2-002', 'L2', 'always', 'MetadataPolicyPort'),
     createDef('L2-003', 'L2', 'always'),
@@ -93,7 +90,6 @@ function buildDefaultRegistry(): ValidatorRegistry {
 
 export interface ValidatorSystemModule {
   registry: ValidatorRegistry;
-  runL0ValidatorsUseCase: RunL0ValidatorsUseCase;
   runL1ValidatorsUseCase: RunL1ValidatorsUseCase;
   runL2ValidatorsUseCase: RunL2ValidatorsUseCase;
   runL3ValidatorsUseCase: RunL3ValidatorsUseCase;
@@ -124,13 +120,6 @@ export function createValidatorSystemModule(config?: object): ValidatorSystemMod
   const securityScannerPort = new FileSystemSecurityPatternScannerAdapter();
   const performanceScannerPort = new AstPerformanceScannerAdapter();
 
-  const runL0ValidatorsUseCase = new RunL0ValidatorsUseCase({
-    validatorRegistry: registry,
-    validatorExecutionService: executionService,
-    validatorConfigPort: configPort,
-    contractMapper,
-  });
-
   const runL2ValidatorsUseCase = new RunL2ValidatorsUseCase({
     validatorRegistry: registry,
     validatorExecutionService: executionService,
@@ -220,7 +209,6 @@ export function createValidatorSystemModule(config?: object): ValidatorSystemMod
   const handlers = {
     runValidators: new RunValidatorsHandler({
       runFullValidationUseCase,
-      runL0ValidatorsUseCase,
       runL1ValidatorsUseCase,
       defaultFailOnWarning,
     }),
@@ -230,7 +218,6 @@ export function createValidatorSystemModule(config?: object): ValidatorSystemMod
 
   return {
     registry,
-    runL0ValidatorsUseCase,
     runL1ValidatorsUseCase,
     runL2ValidatorsUseCase,
     runL3ValidatorsUseCase,

package/scripts/harness/validator-system/domain/ports/design-document-port.ts

@@ -8,6 +8,7 @@
 export interface DesignDocumentConcept {
   readonly name: string;
   readonly type: 'class' | 'interface' | 'type' | 'value-object' | 'service';
+  readonly pointers?: readonly string[];
 }
 
 export interface StructuredDesignDoc {
@@ -24,4 +25,6 @@ export interface DesignDocumentPort {
   getLayerAnnotations?(targetDocs?: readonly string[]): Promise<Record<string, string>>;
   /** DriftDetectionService用: 要素名一覧取得 */
   getElements?(targetUnits?: readonly string[]): Promise<string[]>;
+  /** DriftDetectionService用: 設計要素から対応する実装ファイルへの明示ポインタ */
+  getElementPointers?(targetUnits?: readonly string[]): Promise<Record<string, readonly string[]>>;
 }

package/scripts/harness/validator-system/domain/ports/source-code-analyzer-port.ts

@@ -11,4 +11,5 @@ export interface SourceAnalysisResult {
 export interface SourceCodeAnalyzerPort {
   analyzeExports(targetUnits?: readonly string[]): Promise<readonly SourceAnalysisResult[]>;
   getElements?(targetUnits?: readonly string[]): Promise<string[]>;
+  getElementFilePathMap?(targetUnits?: readonly string[]): Promise<Record<string, readonly string[]>>;
 }

package/scripts/harness/validator-system/domain/ports/validator-config-port.ts

@@ -7,5 +7,5 @@
 import type { LayerConfig } from '../value-objects/layer-config.js';
 
 export interface ValidatorConfigPort {
-  getLayerConfig(layer: 'L0' | 'L2' | 'L3' | 'L4'): Promise<LayerConfig>;
+  getLayerConfig(layer: 'L2' | 'L3' | 'L4'): Promise<LayerConfig>;
 }

package/scripts/harness/validator-system/domain/services/l4/drift-detection-service.ts

@@ -9,6 +9,11 @@ import { DriftReport } from '../../value-objects/drift-report.js';
 
 export interface DriftDetectionDesignDocumentPort {
   getElements(targetUnits?: readonly string[]): Promise<string[]>;
+  /**
+   * WI-095: 設計要素 → 実装ファイル path の明示対応。
+   * 実装されていれば element 名完全一致に加えて drift 判定に使う。
+   */
+  getElementPointers?(targetUnits?: readonly string[]): Promise<Record<string, readonly string[]>>;
   /**
    * ISSUE-005 P3-9: element → unit 名のマップ。
    * 実装されていれば DriftReport.unitName の解決に使われる (fallback: 'unknown')。
@@ -18,6 +23,11 @@ export interface DriftDetectionDesignDocumentPort {
 
 export interface DriftDetectionSourceCodeAnalyzerPort {
   getElements(targetUnits?: readonly string[]): Promise<string[]>;
+  /**
+   * WI-095: export element → 定義ファイル path のマップ。
+   * 実装されていれば design pointer と照合する。
+   */
+  getElementFilePathMap?(targetUnits?: readonly string[]): Promise<Record<string, readonly string[]>>;
   /**
    * ISSUE-005 P3-9: element → unit 名のマップ。
    * 実装されていれば DriftReport.unitName の解決に使われる (fallback: 'unknown')。
@@ -42,6 +52,12 @@ export class DriftDetectionService {
   async detect(targetUnits?: readonly string[]): Promise<readonly DriftReport[]> {
     const designElements = await this.designDocumentPort.getElements(targetUnits);
     const codeElements = await this.sourceCodeAnalyzerPort.getElements(targetUnits);
+    const designPointers = this.designDocumentPort.getElementPointers
+      ? await this.designDocumentPort.getElementPointers(targetUnits)
+      : {};
+    const codeFilePathMap = this.sourceCodeAnalyzerPort.getElementFilePathMap
+      ? await this.sourceCodeAnalyzerPort.getElementFilePathMap(targetUnits)
+      : {};
 
     // ISSUE-005 P3-9: element → unit のマップを取得し、DriftReport.unitName の解決に使う
     const designUnitMap = this.designDocumentPort.getElementUnitMap
@@ -62,12 +78,28 @@ export class DriftDetectionService {
 
     const designSet = new Set(designElements);
     const codeSet = new Set(codeElements);
+    const pointerMatchedDesignElements = new Set<string>();
+    const pointerMatchedCodeElements = new Set<string>();
+
+    for (const element of designElements) {
+      const pointers = designPointers[element] ?? [];
+      if (pointers.length === 0) continue;
+      const matchedCodeElements = codeElements.filter((codeElement) =>
+        (codeFilePathMap[codeElement] ?? []).some((filePath) => pointers.some((pointer) => isSameOrNestedPath(filePath, pointer)))
+      );
+      if (matchedCodeElements.length > 0) {
+        pointerMatchedDesignElements.add(element);
+        for (const codeElement of matchedCodeElements) {
+          pointerMatchedCodeElements.add(codeElement);
+        }
+      }
+    }
 
     const reports: DriftReport[] = [];
 
     // 設計に存在するがコードに存在しない
     for (const element of designElements) {
-      if (!codeSet.has(element)) {
+      if (!codeSet.has(element) && !pointerMatchedDesignElements.has(element)) {
         reports.push(
           DriftReport.create({
             direction: 'design→code',
@@ -82,7 +114,7 @@ export class DriftDetectionService {
 
     // コードに存在するが設計に存在しない
     for (const element of codeElements) {
-      if (!designSet.has(element)) {
+      if (!designSet.has(element) && !pointerMatchedCodeElements.has(element)) {
         reports.push(
           DriftReport.create({
             direction: 'code→design',
@@ -100,3 +132,13 @@ export class DriftDetectionService {
     );
   }
 }
+
+function normalizePath(path: string): string {
+  return path.replace(/\\/g, '/').replace(/^\.\//, '');
+}
+
+function isSameOrNestedPath(actualPath: string, pointerPath: string): boolean {
+  const actual = normalizePath(actualPath);
+  const pointer = normalizePath(pointerPath);
+  return actual === pointer || actual.endsWith(`/${pointer}`);
+}

package/scripts/harness/validator-system/domain/services/validator-execution-service.ts

@@ -19,7 +19,7 @@ export class ValidatorExecutionError extends Error {
 
 export interface ValidatorExecutionServiceDeps {
   configPort?: {
-    getLayerConfig(layer: 'L0' | 'L2' | 'L3' | 'L4'): LayerConfig | Promise<LayerConfig>;
+    getLayerConfig(layer: 'L2' | 'L3' | 'L4'): LayerConfig | Promise<LayerConfig>;
   };
   policyPort?: PhaseGatePolicyPort | { check: (...args: unknown[]) => unknown };
   [key: string]: unknown;
@@ -132,7 +132,7 @@ export class ValidatorExecutionService {
     });
   }
 
-  private _getLayerConfigSync(layer: 'L0' | 'L2' | 'L3' | 'L4'): LayerConfig | undefined {
+  private _getLayerConfigSync(layer: 'L2' | 'L3' | 'L4'): LayerConfig | undefined {
     const port = this.deps.configPort;
     if (!port) return undefined;
     const result = port.getLayerConfig(layer);

package/scripts/harness/validator-system/domain/services/validator-registry.ts

@@ -3,7 +3,7 @@
  * @unit validator-system
  *
  * ValidatorRegistry ドメインサービス
- * 全10バリデータ定義のカタログ管理と選択実行インターフェース
+ * L2-L4バリデータ定義のカタログ管理と選択実行インターフェース
  */
 import { ValidatorId } from '../value-objects/validator-id.js';
 import { ValidatorDefinition } from '../value-objects/validator-definition.js';
@@ -48,7 +48,7 @@ export class ValidatorRegistry {
     return this.definitionList;
   }
 
-  listByLayer(layer: 'L0' | 'L2' | 'L3' | 'L4'): readonly ValidatorDefinition[] {
+  listByLayer(layer: 'L2' | 'L3' | 'L4'): readonly ValidatorDefinition[] {
     return this.definitionList.filter((def) => def.layer === layer);
   }
 

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

@@ -8,7 +8,7 @@
 import { ValidatorId } from './validator-id.js';
 
 export interface LayerConfigProps {
-  readonly layer: 'L0' | 'L2' | 'L3' | 'L4';
+  readonly layer: 'L2' | 'L3' | 'L4';
   readonly enabled: boolean;
   readonly validatorIds: readonly string[];
   readonly thresholds: Record<string, number>;
@@ -17,7 +17,7 @@ export interface LayerConfigProps {
 }
 
 export class LayerConfig {
-  readonly layer: 'L0' | 'L2' | 'L3' | 'L4';
+  readonly layer: 'L2' | 'L3' | 'L4';
   readonly enabled: boolean;
   readonly validatorIds: readonly string[];
   readonly thresholds: Readonly<Record<string, number>>;

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

@@ -10,17 +10,16 @@ import { ValidationRule } from './validation-rule.js';
 
 export interface ValidatorDefinitionProps {
   readonly validatorId: ValidatorId;
-  readonly layer: 'L0' | 'L2' | 'L3' | 'L4';
+  readonly layer: 'L2' | 'L3' | 'L4';
   readonly name?: string;
   readonly description?: string;
   readonly rules: readonly ValidationRule[];
   readonly enabledCondition: 'always' | 'layerEnabled' | 'strictOnly';
   readonly externalPolicyRef: string | null;
-  readonly executionPhase?: 'fuse-hook' | 'pre-commit' | 'ci' | 'scheduled';
+  readonly executionPhase?: 'pre-commit' | 'ci' | 'scheduled';
 }
 
-const LAYER_TO_PHASE: Record<'L0' | 'L2' | 'L3' | 'L4', 'fuse-hook' | 'fuse-hook' | 'pre-commit' | 'ci' | 'scheduled'> = {
-  L0: 'fuse-hook',
+const LAYER_TO_PHASE: Record<'L2' | 'L3' | 'L4', 'pre-commit' | 'ci' | 'scheduled'> = {
   L2: 'pre-commit',
   L3: 'ci',
   L4: 'scheduled',
@@ -28,13 +27,13 @@ const LAYER_TO_PHASE: Record<'L0' | 'L2' | 'L3' | 'L4', 'fuse-hook' | 'fuse-hook
 
 export class ValidatorDefinition {
   readonly validatorId: ValidatorId;
-  readonly layer: 'L0' | 'L2' | 'L3' | 'L4';
+  readonly layer: 'L2' | 'L3' | 'L4';
   readonly name: string;
   readonly description: string;
   readonly rules: readonly ValidationRule[];
   readonly enabledCondition: 'always' | 'layerEnabled' | 'strictOnly';
   readonly externalPolicyRef: string | null;
-  readonly executionPhase: 'fuse-hook' | 'pre-commit' | 'ci' | 'scheduled';
+  readonly executionPhase: 'pre-commit' | 'ci' | 'scheduled';
 
   private constructor(props: ValidatorDefinitionProps) {
     this.validatorId = props.validatorId;

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

@@ -20,8 +20,6 @@ const VALIDATOR_ID_PATTERN = /^L[0-4]-\d{3}$/;
 
 /** バリデータID -> バリデータ名のマップ */
 const VALIDATOR_NAME_MAP: Record<string, string> = {
-  'L0-001': 'fuse-hook-config',
-  'L0-002': 'fuse-mount-status',
   'L1-017': 'it-test-mock-detection',
   'L1-018': 'stub-comment-detection',
   'L2-001': 'phase-gate',

package/scripts/harness/validator-system/infrastructure/adapters/biome-ast-source-code-analyzer-adapter.ts

@@ -61,6 +61,17 @@ export class BiomeAstSourceCodeAnalyzerAdapter implements SourceCodeAnalyzerPort
     }
     return map;
   }
+
+  async getElementFilePathMap(targetUnits?: readonly string[]): Promise<Record<string, readonly string[]>> {
+    const results = await this.analyzeExports(targetUnits);
+    const map: Record<string, string[]> = {};
+    for (const result of results) {
+      for (const entry of result.exports) {
+        map[entry.name] = [...(map[entry.name] ?? []), result.filePath];
+      }
+    }
+    return map;
+  }
 }
 
 type ExportType = SourceAnalysisResult['exports'][number]['type'];

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

@@ -9,7 +9,6 @@ import { LayerConfig } from '../../domain/value-objects/layer-config.js';
 import type { ValidatorConfigPort } from '../../domain/ports/validator-config-port.js';
 
 export interface HarnessConfigLayers {
-  L0?: { enabled?: boolean; validators?: string[]; strictOnly?: boolean; preset?: string };
   L2?: { enabled?: boolean; validators?: string[]; strictOnly?: boolean; preset?: string };
   L3?: { enabled?: boolean; validators?: string[]; strictOnly?: boolean; preset?: string; coverageThreshold?: number; bundleSizeLimit?: number };
   L4?: { enabled?: boolean; validators?: string[]; strictOnly?: boolean; preset?: string; deadCodeGC?: boolean };
@@ -32,13 +31,12 @@ export class HarnessConfigValidatorConfigAdapter implements ValidatorConfigPort
     this.config = config;
   }
 
-  async getLayerConfig(layer: 'L0' | 'L2' | 'L3' | 'L4'): Promise<LayerConfig> {
+  async getLayerConfig(layer: 'L2' | 'L3' | 'L4'): Promise<LayerConfig> {
     const preset = (this.config.project?.preset ?? this.config.preset ?? 'standard') as 'minimal' | 'standard' | 'strict';
     const strictOnly = preset === 'strict';
     const layerData = this.config.layers?.[layer] ?? {};
 
     const defaultValidators: Record<string, string[]> = {
-      L0: ['L0-001', 'L0-002'],
       L2: ['L2-001', 'L2-002', 'L2-003'],
       L3: ['L3-001', 'L3-002', 'L3-003', 'L3-004'],
       L4: ['L4-001', 'L4-002', 'L4-003'],

package/scripts/harness/validator-system/infrastructure/adapters/markdown-design-document-adapter.ts

@@ -30,9 +30,39 @@ function isMetaHeading(name: string): boolean {
   return DEFAULT_META_HEADING_PATTERNS.some((p) => p.test(name));
 }
 
-function extractConceptNames(markdown: string): string[] {
+function extractPointerLines(lines: readonly string[], startIndex: number, headingRegex: RegExp): string[] {
+  const pointers: string[] = [];
+  for (let i = startIndex + 1; i < lines.length; i++) {
+    const line = lines[i];
+    if (headingRegex.test(line)) break;
+
+    const commentMatch = /<!--\s*pointers?\s*:\s*(.+?)\s*-->/i.exec(line);
+    if (commentMatch) {
+      pointers.push(...commentMatch[1].split(',').map((p) => p.trim()).filter(Boolean));
+      continue;
+    }
+
+    const blockStartMatch = /^<pointers>\s*$/i.exec(line.trim());
+    if (blockStartMatch) {
+      for (let j = i + 1; j < lines.length; j++) {
+        const blockLine = lines[j].trim();
+        if (/^<\/pointers>\s*$/i.test(blockLine)) {
+          i = j;
+          break;
+        }
+        const itemMatch = /^-\s+(.+?)\s*$/.exec(blockLine);
+        if (itemMatch) pointers.push(itemMatch[1].trim());
+      }
+      continue;
+    }
+  }
+
+  return Array.from(new Set(pointers));
+}
+
+function extractConcepts(markdown: string): Array<{ name: string; pointers?: readonly string[] }> {
   const lines = markdown.split(/\r?\n/);
-  const headings: string[] = [];
+  const concepts: Array<{ name: string; pointers?: readonly string[] }> = [];
   const headingRegex = /^(#{2,3})\s+(.+?)\s*$/;
   for (let i = 0; i < lines.length; i++) {
     const m = headingRegex.exec(lines[i]);
@@ -59,10 +89,11 @@ function extractConceptNames(markdown: string): string[] {
       .replace(/[（(][^）)]*[）)]/g, '')
       .trim();
     if (stripped.length > 0) {
-      headings.push(stripped);
+      const pointers = extractPointerLines(lines, i, headingRegex);
+      concepts.push(pointers.length > 0 ? { name: stripped, pointers } : { name: stripped });
     }
   }
-  return headings;
+  return concepts;
 }
 
 export class MarkdownDesignDocumentAdapter implements DesignDocumentPort {
@@ -92,7 +123,7 @@ export class MarkdownDesignDocumentAdapter implements DesignDocumentPort {
         const doc: StructuredDesignDoc = {
           unitName,
           docPath,
-          concepts: extractConceptNames(markdown).map((name) => ({ name, type: 'class' })),
+          concepts: extractConcepts(markdown).map((concept) => ({ ...concept, type: 'class' })),
           layerDependencies: [],
           adrRefs: Array.from(new Set(markdown.match(ADR_PATTERN) ?? [])),
         };
@@ -115,6 +146,19 @@ export class MarkdownDesignDocumentAdapter implements DesignDocumentPort {
     return docs.flatMap((doc) => doc.concepts.map((concept) => concept.name));
   }
 
+  async getElementPointers(targetUnits?: readonly string[]): Promise<Record<string, readonly string[]>> {
+    const docs = await this.loadDesignDocuments(targetUnits);
+    const map: Record<string, readonly string[]> = {};
+    for (const doc of docs) {
+      for (const concept of doc.concepts) {
+        if (concept.pointers && concept.pointers.length > 0) {
+          map[concept.name] = concept.pointers;
+        }
+      }
+    }
+    return map;
+  }
+
   /**
    * ISSUE-005 P3-9: element 名から unit 名を引けるマップを返す。
    * 同名 element が複数 unit に存在する場合は最初に見つかった unit を採用する。

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

@@ -5,7 +5,6 @@
  * RunValidatorsHandler — バリデータ実行 CLIハンドラー
  */
 import type { RunFullValidationUseCase } from '../../application/use-cases/run-full-validation-usecase.js';
-import type { RunL0ValidatorsUseCase } from '../../application/use-cases/run-l0-validators-usecase.js';
 import type { RunL1ValidatorsUseCase } from '../../application/use-cases/run-l1-validators-usecase.js';
 import type { AggregatedValidationReport } from '../../application/dto/aggregated-validation-report.js';
 import { HumanValidationResultFormatter } from '../formatters/human-validation-result-formatter.js';
@@ -25,7 +24,6 @@ export interface RunValidatorsHandlerArgs {
 
 export interface RunValidatorsHandlerDeps {
   runFullValidationUseCase: RunFullValidationUseCase;
-  runL0ValidatorsUseCase?: RunL0ValidatorsUseCase;
   runL1ValidatorsUseCase?: RunL1ValidatorsUseCase;
   /** WI-094 / ADR-017: config 由来の failOnWarning デフォルト。args.failOnWarning が undefined の場合に適用 */
   defaultFailOnWarning?: boolean;
@@ -33,13 +31,11 @@ export interface RunValidatorsHandlerDeps {
 
 export class RunValidatorsHandler {
   private readonly useCase: RunFullValidationUseCase;
-  private readonly l0UseCase: RunL0ValidatorsUseCase | undefined;
   private readonly l1UseCase: RunL1ValidatorsUseCase | undefined;
   private readonly defaultFailOnWarning: boolean;
 
   constructor(deps: RunValidatorsHandlerDeps) {
     this.useCase = deps.runFullValidationUseCase;
-    this.l0UseCase = deps.runL0ValidatorsUseCase;
     this.l1UseCase = deps.runL1ValidatorsUseCase;
     this.defaultFailOnWarning = deps.defaultFailOnWarning ?? false;
   }
@@ -47,37 +43,12 @@ export class RunValidatorsHandler {
   async execute(args: RunValidatorsHandlerArgs): Promise<{ output: string; exitCode: number }> {
     try {
       if (args.layer === 'L0') {
-        const l0UseCase = this.l0UseCase;
-        if (!l0UseCase) {
-          return { output: 'L0 validators not configured', exitCode: 1 };
-        }
-        const l0Results = await l0UseCase.execute({
-          validatorIds: args.validatorIds,
-        });
-        const l0Report: AggregatedValidationReport = {
-          overallPassed: l0Results.every((r) => r.passed || r.skipped),
-          totalValidators: l0Results.length,
-          passedValidators: l0Results.filter((r) => r.passed).length,
-          failedValidators: l0Results.filter((r) => !r.passed && !r.skipped).length,
-          skippedValidators: l0Results.filter((r) => r.skipped).length,
-          allErrors: l0Results.flatMap((r) => r.errors),
-          summary: {
-            totalErrors: l0Results.flatMap((r) => r.errors).filter((e) => e.severity === 'error').length,
-            totalWarnings: l0Results.flatMap((r) => r.errors).filter((e) => e.severity === 'warning').length,
-            errorsByLayer: { L2: 0, L3: 0, L4: 0 },
-          },
-          results: l0Results,
-        };
-        const format = args.format ?? 'human';
-        let output: string;
-        if (format === 'agent') {
-          output = new AgentValidationResultFormatter().format(l0Report);
-        } else if (format === 'ci') {
-          output = new CiValidationResultFormatter().format(l0Report);
-        } else {
-          output = new HumanValidationResultFormatter().format(l0Report);
-        }
-        return { output, exitCode: l0Report.overallPassed ? 0 : 1 };
+        const output = [
+          'L0 validator execution has been retired.',
+          'Runtime L0 enforcement is provided by agent-integration hooks and Husky git hooks.',
+          'Use the configured PreToolUse/PostToolUse/Stop/SessionStart/UserPromptSubmit hooks and .husky/pre-commit / .husky/commit-msg instead of validate --layer L0.',
+        ].join('\n');
+        return { output, exitCode: 0 };
       }
 
       if (args.layer === 'L1') {

package/scripts/harness/validator-system/application/dto/run-l0-validators-input.ts

@@ -1,9 +0,0 @@
-/**
- * @layer application
- * @unit validator-system
- *
- * RunL0ValidatorsInput — L0バリデータ実行 UseCase入力DTO
- */
-export interface RunL0ValidatorsInput {
-  readonly validatorIds?: readonly string[];
-}

package/scripts/harness/validator-system/application/use-cases/run-l0-validators-usecase.ts

@@ -1,60 +0,0 @@
-/**
- * @layer application
- * @unit validator-system
- *
- * RunL0ValidatorsUseCase — L0 バリデータ実行
- */
-import { ValidatorId } from '../../domain/value-objects/validator-id.js';
-import { ValidationResult } from '../../domain/value-objects/validation-result.js';
-import { ValidatorRegistry } from '../../domain/services/validator-registry.js';
-import { ValidatorExecutionService } from '../../domain/services/validator-execution-service.js';
-import { ValidationResultContractMapper } from '../mappers/validation-result-contract-mapper.js';
-import type { ValidationResultContract } from '../dto/validation-result-contract.js';
-import type { RunL0ValidatorsInput } from '../dto/run-l0-validators-input.js';
-import type { ValidatorConfigPort } from '../../domain/ports/validator-config-port.js';
-
-export interface RunL0ValidatorsUseCaseDeps {
-  validatorRegistry: ValidatorRegistry;
-  validatorExecutionService: ValidatorExecutionService;
-  validatorConfigPort: ValidatorConfigPort;
-  contractMapper: ValidationResultContractMapper;
-}
-
-export class RunL0ValidatorsUseCase {
-  private readonly registry: ValidatorRegistry;
-  private readonly executionService: ValidatorExecutionService;
-  private readonly configPort: ValidatorConfigPort;
-  private readonly mapper: ValidationResultContractMapper;
-
-  constructor(deps: RunL0ValidatorsUseCaseDeps) {
-    this.registry = deps.validatorRegistry;
-    this.executionService = deps.validatorExecutionService;
-    this.configPort = deps.validatorConfigPort;
-    this.mapper = deps.contractMapper;
-  }
-
-  async execute(input: RunL0ValidatorsInput): Promise<readonly ValidationResultContract[]> {
-    let validatorIds: readonly ValidatorId[];
-    if (input.validatorIds && input.validatorIds.length > 0) {
-      validatorIds = input.validatorIds.map((id) => ValidatorId.create(id));
-    } else {
-      validatorIds = this.registry.listByLayer('L0').map((d) => d.validatorId);
-    }
-
-    const definitions = this.registry.select(validatorIds);
-
-    const layerConfig = await this.configPort.getLayerConfig('L0');
-    if (!layerConfig.enabled) {
-      return [];
-    }
-
-    const results = this.executionService.execute(definitions, [layerConfig]);
-    const finalResults = definitions.map(
-      (definition) => {
-        const result = results.find((r) => r.validatorId.value === definition.validatorId.value);
-        return result ?? ValidationResult.skip(definition.validatorId);
-      },
-    );
-    return this.mapper.toContracts(finalResults);
-  }
-}