phasegate 0.83.0 → 0.107.0

package/CHANGELOG.md

@@ -7,6 +7,319 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.100.0] - 2026-04-23
+
+### Added
+
+- **ISSUE-014 Wave 6: preset 選定ガイド + `migrate` CLI + 呼称分離 + v0.86.0 未満警告** — Wave 5.5 までの実装を user 導線と docs に接続し ISSUE-014 を CLOSE する。
+  - **`docs/guide/preset-selection.md` 新設**: 7 preset（clean / strict-ddd / onion / hexagonal / layered / flat / custom）の早見表 + 選択フローチャート + 設定例 + override / custom の書式 + v2 → v3 移行手順。
+  - **README.md**: Presets 節を「Defense preset（`project.preset`）」「Architecture preset（`architecture.preset`）」の 2 テーブルに分け、preset-selection.md への導線を追加 + 呼称分離の補足。
+  - **CLAUDE.md**: 「防御プリセット（CI strict/lenient）」と「アーキプリセット（clean/onion/hex...）」の呼称分離ガイドを追記。issue / PR / チャットで「preset」とだけ書かず必ず種類を明示するルール化。
+  - **retrofit-adoption.md**: Step 1 に architecture preset 選定節を追加、`npx phasegate migrate --schema v3` の導線。
+  - **`phasegate migrate --schema v3` CLI 新設** (`scripts/harness/config-foundation/`): `MigrateSchemaUseCase` + `MigrateSchemaCommandHandler` + `main.ts` の switch-case `migrate` + ヘルプ追記。`phasegate.config.json` を読んで `architecture` キーが無ければ `{ preset: "clean" }` を追記して v3 化（idempotent）。
+  - **v0.86.0 未満警告**: `LoadResolvedConfigUseCase` が source document の `architecture` 有無で `schemaVersion: 'v2' | 'v3'` を判定して output DTO に追加。`main.ts` の `loadResolvedConfig()` が v2 検出時に `npx phasegate migrate --schema v3` の案内を **一度だけ** stderr に出力（同一プロセスで多重 load されても重複警告しない）。
+
+### Tests
+
+- 新規 `scripts/harness/__tests__/unit/config-foundation/migrate-schema-use-case.test.ts` で 6 テスト: v2→v3 変換 / v3 no-op / array document で InvalidConfigShapeError / null document / 未対応 targetVersion / configPath 透過。
+- 新規 `scripts/harness/__tests__/integration/config-foundation/migrate-schema-use-case.test.ts` で 2 テスト: tmp dir round-trip（v2 config → 永続化検証 / v3 config → mtime 不変で no-op 確認）。
+- 既存 `load-resolved-config-use-case.test.ts` と `load-config-facade.test.ts` の toEqual 期待値に `schemaVersion: 'v2'` を追加。
+- 全 3387 tests green（3368 unit/integration + 19 forks、+8 新規）、`npx phasegate lint` violations 0（1301 ファイル scan）。
+
+### Notes
+
+- これにより ISSUE-014（アーキテクチャスタイルの config 対応）は Wave 1〜6 完走 → **CLOSED**。v0.86.0〜v0.99.0 の 14 バージョンで段階的に構築: Wave 1 設計文書 → Wave 2 VO 注入 → Wave 3 schema v3 → Wave 4 flat preset + biome-ast-engine 配線 → Wave 5 pipeline 全体に spec 配線 → Wave 5.5 3 preset dogfood integration test → Wave 6 guide + migrate CLI + 警告。
+- `phasegate migrate --schema v3` は破壊的変更ではなく additive（既存フィールドは保持、`architecture` だけ追加）。本リポジトリ自身は Wave 3 時点で dogfood 済のため migrate 対象外。
+
+## [0.99.0] - 2026-04-23
+
+### Added
+
+- **ISSUE-014 Wave 5.5: 3 preset（onion / hexagonal / layered）dogfood を vitest integration test で自動化** — Wave 5 で pipeline 配線は完成したが、外部 PJ 相当の end-to-end 検証は pre-tool-use-hook の `/tmp/**/src/domain/**` blocking で deferred していた。本 Wave では `/tmp/` への Claude Write を諦め、**テストランタイムの `fs.writeFileSync`（hook 対象外）で `os.tmpdir()` に fixture 展開する方針**に切り替えて解消。
+  - `scripts/harness/__tests__/integration/biome-ast-engine/preset-dogfood.integration.test.ts` を新設（`@story ISSUE-014`）。
+  - 各 preset につき「許容方向 import → violation 0 件」と「違反方向 import → `no-layer-violation` で検出」の 2 テスト × 3 preset = 計 6 テストを `createBiomeAstEngineModule(rootDir, { architecture })` 経由で `ExecuteLintUseCase.execute({ targets: ['src'], includeBiomeNative: false })` を呼び出して検証。
+  - 検証内容: onion（interface→domain 許容 / domain→interface 検出）、hexagonal（adapters→core 許容 / core→adapters 検出）、layered（presentation→business→data 許容 / data→presentation 検出）。
+
+### Tests
+
+- 新規 `preset-dogfood.integration.test.ts` で 6 テスト追加（3354 → 3360）。
+- 全 3379 tests green（3360 unit/integration + 19 forks）、`npx phasegate lint` violations 0（1297 ファイル scan）。
+
+### Notes
+
+- 本 Wave は当初「`/tmp/phasegate-dogfood-*/` に実際のディレクトリを切って `npx phasegate lint` を走らせる外部検証」を想定していたが、pre-tool-use-hook が Claude の Write 経路で `/tmp/**/src/domain/**` を Full-mode 必須カテゴリと判定して blocking するため実行不能。hook の scope を narrow する修正は independent の refactoring スコープになるため、本 Wave では integration test ベースでの dogfood に切替（Claude が関与しない Node.js ランタイム書き込みは hook 対象外）。CLI 経由で phasegate.config.json を読み込む経路の検証は Wave 6 の `migrate` CLI テストで補完予定。
+- ISSUE-014 は Wave 5.5 まで完了。残り Wave 6（ガイド追記 + `migrate` CLI + 呼称分離）で CLOSE 予定。
+
+## [0.98.0] - 2026-04-23
+
+### Added
+
+- **ISSUE-014 Wave 5: `no-layer-violation` への `architecture.allowedDependencies` 注入 + pipeline 全体への spec 配線** — Wave 4 で flat preset 配線を作った後の、非 clean preset（onion / hexagonal / layered / strict-ddd / custom）を実際に lint 判定へ反映する改修。
+  - `ResolveEnabledRulesUseCase` 出力に `architectureSpec: ArchitectureSpec` を追加（DTO + mapper 拡張）。config-foundation の `preset / layers / allowedDependencies` を `freezeArchitectureSpec` で ArchitectureSpec に変換して下流へ伝播。
+  - `LintRunner.run(params)` の params に optional `architecture` を追加。`no-layer-violation` rule 内の `LayerBoundary.standardMatrix()` ハードコード呼び出しを `LayerBoundary.standardMatrix(architecture)` に置換（未指定時は `CLEAN_PRESET_SPEC` で後方互換）。
+  - `SourceModuleSnapshot.create(props, spec?)` で `@layer` tag の正規化が spec 経由になり、`core` / `interface` / `ports` 等の非 clean 層名が LayerName として認識可能に。
+  - `SourceModuleAnalyzerPort.analyzeMany(files, architecture?)` + `TypeScriptSourceModuleAnalyzerAdapter` + `source-module-snapshot-mapper.toSourceModuleSnapshot(raw, architecture?)` の 3 箇所に spec 伝播。
+  - `AnalyzeImportGraphUseCase` 入力 DTO に `architecture?` を追加、`ExecuteLintUseCase` が `resolvedRules.architectureSpec` を analyze/lintRunner の両方へ配線。
+
+### Tests
+
+- 新規 `lint-runner.test.ts` に onion preset 2 件（`domain → interface` 違反検出 / `interface → domain` 許容）を追加 — architecture 注入経路を end-to-end で検証。
+- 新規 `source-module-snapshot.test.ts` に hexagonal spec 正規化 2 件（`core` 値が LayerName として通る / spec 省略時は clean default で `null` に落ちる）を追加。
+- 新規 `resolve-enabled-rules-usecase.test.ts` に onion architecture の architectureSpec 透過 1 件を追加。
+- 既存 `analyze-import-graph-usecase.test.ts` / `execute-lint-usecase.test.ts` の mock 期待値を新シグネチャに更新。
+- 全 3373 tests green（3354 unit + 19 forks、+5）、`npx phasegate lint` violations 0。
+
+### Notes
+
+- 「外部 dogfood（`/tmp/phasegate-dogfood-onion` 等の 3 preset）」は pre-tool-use-hook が `/tmp/**/src/domain/**` への書き込みを quick-mode 外カテゴリとして blocking するため Wave 5.5 に延期。コード経路は unit test で end-to-end 検証済み。
+- Wave 6（ガイド追記 + `migrate` CLI + v0.86.0 境界警告）は本 Wave の範囲外。
+
+## [0.97.0] - 2026-04-23
+
+### Added
+
+- **ISSUE-014 Wave 4: `flat` preset auto-disable + user override 優先度 + architecture 配線** — Wave 3 で config-foundation がエクスポートした `architecture` を biome-ast-engine の L1 rule pipeline に接続した初回。
+  - `RuleConfigProviderPort` に `getArchitecture()` を追加し、`preset / layers / allowedDependencies` を供給。
+  - `HarnessConfigProviderAdapter` が architecture を保持・返却。未注入時は clean default に fallback。
+  - `createBiomeAstEngineModule` の `BiomeAstEngineModuleOptions` に `architecture?` を追加。
+  - `ResolveEnabledRulesUseCase` が `preset === 'flat'` 時に `require-unit-comment / require-layer-comment / no-layer-violation / enforce-folder-structure` を自動 `off` 扱い。**user 明示設定（rules or overrideRules）が存在する rule は preset 既定より優先**。
+  - `main.ts` が `resolvedConfig.architecture` を抽出し `createBiomeAstEngineModule` に渡す配線を追加。
+  - flat preset は `@layer` タグが残っていても L1-001/002/003/004 が skipped なので違反を発火しない（option A: 残存 tag は ignore）。
+
+### Tests
+
+- `unit/biome-ast-engine/resolve-enabled-rules-usecase.test.ts` に 4 件追加（flat preset 未指定時の 4 rule skipped / user `error` 明示優先 / user overrideRules `off` 明示 / clean preset は既定で auto-disable されない）。
+
+### Notes
+
+- Wave 5（`onion / hexagonal / layered / strict-ddd / custom` の実体活用 + dogfood）と Wave 6（ガイド追記 + migrate CLI）は別 Wave に送り、Wave 4 は flat 有効化のみに絞る。
+- 現状 `no-layer-violation` rule は `LayerBoundary.standardMatrix()` をハードコード呼び出し中（`LintRunner`）。Wave 5 で architecture.allowedDependencies を注入する改修を予定。
+
+## [0.96.0] - 2026-04-23
+
+### Added
+
+- **ISSUE-014 Wave 3: schema v3 + config-foundation による architecture preset のロード基盤** — Wave 2 で VO に注入口を用意した後の、config レイヤーでの実体化フェーズ。biome-ast-engine 側の配線は Wave 4 以降で担当する。
+  - 新規 `scripts/harness/config-foundation/infrastructure/schemas/harness-config-v3.schema.json` — v2 schema に `architecture` セクション（`preset` 必須、`custom` 時は `layers` + `allowedDependencies` 必須の `allOf/if/then`）を optional で追加。
+  - 新規 `domain/value-objects/architecture-config.ts` — `ArchitecturePresetId` / `ArchitectureConfigSource` / `ArchitectureConfigDocument` / `freezeArchitectureDocument` / `isArchitecturePresetId`。
+  - 新規 `domain/value-objects/architecture-preset-catalog.ts` — `clean / strict-ddd / onion / hexagonal / layered / flat` の 6 preset 定義（`custom` は source 側で明示）。
+  - 新規 `domain/services/architecture-resolution-service.ts` — preset 展開 + 明示 override マージ + semantic validation（C1 自己参照欠落は auto-fill + warn、C2 キー不整合は error、C3 値不整合は error、C4 layer 欠落は `{self}` auto-fill + warn、C5 循環依存は warn）+ layerDetection precedence（byPath=false+byTag=false は error）。
+  - `AjvConfigSchemaValidator` に構造検出（`architecture` キー有無）を追加し、v2/v3 schema を自動選択。
+  - `HarnessConfigResolvedDocument` に optional `architecture` を追加。`LoadResolvedConfigUseCase` が architecture を常時 resolve し、v2 config は `{ preset: "clean" }` 既定を synthesize。
+- **phasegate レポ自身の `phasegate.config.json` に `architecture: { preset: "clean" }` dogfood 明示追記** — Wave 2 から移送された項目。v3 schema + loader が揃った本 Wave で初めて安全に追記可能。
+
+### Changed
+
+- 既存 `load-resolved-config-use-case.test.ts` の `createMinimalResolvedDocument()` に clean デフォルトの architecture セクションを追加（新契約への追従）。
+
+### Tests
+
+- 新規 `unit/config-foundation/architecture-resolution-service.test.ts` — 17 件。7 preset 展開 / custom explicit 必須 / preset+override merge / C1〜C5 semantic validation / layerDetection precedence / metadataTags override。
+- 新規 `integration/config-foundation/ajv-config-schema-validator-v3.test.ts` — 5 件。v2 document / v3 document / 未知 preset / custom without layers のケース。
+- 全 3345 tests green（3323 → +22）、`npx phasegate lint` violations 0。
+
+## [0.95.0] - 2026-04-23
+
+### Changed
+
+- **ISSUE-014 Wave 2: `LayerName` / `LayerBoundary` VO を `ArchitectureSpec` 注入形式に改修** — Clean Architecture 固定値（`domain / application / infrastructure / presentation` と依存行列）を VO 内部から分離し、`ArchitectureSpec` 型 + `CLEAN_PRESET_SPEC` 定数として `scripts/harness/biome-ast-engine/domain/value-objects/architecture-spec.ts` に抽出。`LayerName.fromString` / `tryFromString` / `LayerBoundary.standardMatrix` が任意の spec を受け付けるようになった（default は `CLEAN_PRESET_SPEC` で既存挙動を維持）。
+- `LayerNameValue` を `string` に緩和（外部参照が無い前提での型緩和）、`canDependOn` はインスタンスが保持する spec の `allowedDependencies` を参照する形式へ変更。
+- 新規テスト 12 件追加（`architecture-spec.test.ts` 4 件 + `layer-name.test.ts` に onion preset 注入ケース 5 件 + `layer-boundary.test.ts` に onion 3×3 matrix ケース 3 件）。全 3323 テスト green、`npx phasegate lint` violations 0。
+
+### Plan re-sync
+
+- Wave 2 計画の小さな穴を是正: 当初「`phasegate.config.json` に `architecture: { preset: "clean" }` を dogfood 明示追記」を Wave 2 に含めていたが、現行 schema v2 が root レベルで `additionalProperties: false` を指定しているため `architecture` キー追加は validation error になる。v3 schema + loader が提供される Wave 3 まで dogfood 更新を**移送**。`wave1_schema_proposal.md` §4 と `issue_description.md` の Wave 表を同期更新。
+
+## [0.94.0] - 2026-04-23
+
+### Changed
+
+- **ISSUE-014 Wave 1 計画の再同期** — レビュー補修で追加された制約を Wave 分割計画に取り込み漏れがないか検証。以下 3 件を追加反映:
+  - Wave 3 に「§1.2 preset + 明示 override 解決ロジック」を明示追加（semantic validation とは別軸）
+  - Wave 6 に「防御プリセット / アーキプリセットの呼称分離ガイド」を明示追加（レビュー穴 #3 の plan 反映漏れ）
+  - 推定工数を再計算: Wave 3 は 1d → **1.5d**（preset override + semantic validation C1〜C5 + precedence を盛り込んだため）。合計 4.5d → **5d**
+- `wave1_schema_proposal.md` §4 の Wave 分割表と `issue_description.md` 推奨実装順表を同期更新
+
+## [0.93.0] - 2026-04-23
+
+### Changed
+
+- **ISSUE-014 Wave 1 レビュー補修** — v0.92.0 で起票した設計文書を批判的レビューにより 12 項目修正。詳細は v0.92.0 の "Review / Hardening" セクション参照（修正差分は v0.93.0 リリースで統合）。実装コード変更なし、設計文書のみ。
+
+## [0.92.0] - 2026-04-23
+
+### Added
+
+- **ISSUE-014 Wave 1: アーキテクチャ preset 化の設計着地** — PhaseGate を Clean Architecture 固定から preset 選択式に拡張するための Wave 1（設計・文書作成）を完了。実装コードは含まない。
+  - `docs/ADR/ADR-015-architecture-preset.md` を Accepted 状態で起票。preset **7 種**（`clean` / `strict-ddd` / `onion` / `hexagonal` / `layered` / `flat` / `custom`）を採択し、`flat` 時の L1-001〜004 自動無効化、`metadataTags` での `@layer` / `@unit` タグ差し替え、schema v3 への下位互換マイグレーション戦略を決定。
+  - `docs/inception/issues/ISSUE-014/wave1_schema_proposal.md` を追加。`architecture` セクションの JSON Schema 断片、各 preset の層・`allowedDependencies` 定義、Wave 2〜6 の実装順序（推定 4.5d）を明文化。
+  - `docs/inception/issues/ISSUE-014/issue_description.md` の状態を `IN PROGRESS` に更新し、Wave 2 以降の入り口を記述。
+
+### Review / Hardening（批判的レビューによる穴補修）
+
+Wave 1 成果物を批判的にレビューし、以下の穴を修正:
+
+- **カウント誤り**: `preset 6 種` → **7 種** に修正（`clean` + `strict-ddd` + `onion` + `hexagonal` + `layered` + `flat` + `custom`）
+- **schema 識別機構**: loader が v2 / v3 を判別する手段を構造検出（`architecture` キーの有無）に決定。明示的な `$schemaVersion` フィールドは追加しない方針を ADR-015 / §1.0 に明記
+- **`project.preset` vs `architecture.preset` の直交性**: 既存 `project.preset`（防御プリセット）と新設 `architecture.preset`（アーキプリセット）の概念を ADR-015 で分離説明。CLI メッセージ・ドキュメントで区別呼称する方針を Wave 6 ガイドに委譲
+- **semantic validation 穴**: `custom` preset の JSON Schema では validate できない制約（C1: 層名の自己参照、C2/C3: allowedDependencies キー/値の `layers` 配列整合、C4: 全 layer カバレッジ、C5: 循環依存警告）を §1.3 に列挙、Wave 3 実装に委譲
+- **preset override 規則**: `preset` + 明示 `layers` / `allowedDependencies` 併記時のルール（明示値 override、partial override 許容）を §1.2 に追加
+- **`layerDetection` precedence**: `byPath` / `byTag` の全組み合わせ（4 通り）の挙動を §3.4 の表に明示。`byPath: false, byTag: false` は schema error に
+- **`flat` preset の残存 `@layer` tag 扱い**: 案 A（無視）/ B（warn）/ C（error）を列挙、Wave 4 で案 A 採用を推奨
+- **preset vs user 個別設定の優先度**: `flat` preset が L1-001〜004 を無効化する場面で user の明示 `layers.L1.rules["L1-001"]: "error"` が上書きする規則を §2.8 に追加
+- **ADR-005 矛盾の解消**: PhaseGate 自身が `clean` preset を名乗ることと ADR-005（Hexagonal 採用）の両立を「`domain` が Hexagonal の `core` に相当する」という哲学的整合で ADR-015 に明記
+- **ADR-014 境界警告**: v0.86.0 未満から upgrade する user への「暗黙デフォルト変更」警告を Wave 6 ガイド + migrate CLI に入れる方針を明記
+- **`@story` タグのスコープ定義**: test ファイルで使われる `@story` タグが本 Wave の `metadataTags` で扱われない理由（traceability-model 管轄）を §3.3 に追加
+- **Wave 受け入れ基準の再設計**: 物理的な成果物存在と user レビュー完了を分離。物理 [x] / レビュー [ ] で Wave 1 完了判定の厳密性を確保
+
+### Scope notes
+
+- Wave 1 は **設計・文書のみ**。`scripts/harness/` 配下のコード改修は含まず、既存テストへの影響なし。`LayerName` / `LayerBoundary` の config 注入改修は Wave 2、schema v3 実装は Wave 3、dogfood 検証は Wave 4〜5、ガイド追記は Wave 6 で順次実施予定。
+
+## [0.91.0] - 2026-04-23
+
+### Fixed
+
+- **ISSUE-023: `StoryId` validator pattern が `HF\d+-\d{2}` を拒否する** — `HF2-XX` 形式（Phase 2 拡張 Epic）を正式サポート。
+  - `scripts/harness/traceability-model/domain/value-objects/story-id.ts`: `STORY_ID_PATTERN` を `/^H(?<epicNumber>F\d+|\d{2})-(?<storyNumber>\d{2})$/` に拡張。エラーメッセージも更新。
+  - `scripts/harness/traceability-model/domain/services/metadata-validator.ts:16`: `STORY_ID_PATTERN` を `/^H(?:F\d+|[0-9]{2})-[0-9]{2}$/` に同期。
+  - `scripts/harness/traceability-model/infrastructure/parsers/story-catalog-parser.ts`: `STORY_ID_LINE_PATTERN` と前後行コンテキスト形式の内部パターンを同期。`user_stories.md` から `HF2-XX` を StoryCatalog に収集可能に。
+  - `StoryId.getEpicNumber()` は `HF2-04` に対して `'F2'` を返す（従来の 2 桁数字は不変）。外部 API shape は維持。
+- **ISSUE-010 完全 CLOSE（副次効果）** — `validate-metadata` FAIL: 103 → **0 件**。`docs/product/construction/` 配下の全 105 設計文書が PASS。Wave 1 (v0.87.0) / Wave 2 (v0.88.0) / Wave 3 (v0.89.0) / fuse-hooks-engine 削除 (v0.90.0) / 本リリースで完結。
+
+### Tests
+
+- `scripts/harness/__tests__/unit/traceability-model/story-id.test.ts` に HF prefix ケース 3 件追加（3308 → 3311）:
+  - `HF2-04` を正常に parse できること
+  - `HF10-99` のような複数桁 F-prefix も受理すること
+  - `HF2-04` の `getEpicNumber()` が `'F2'` を返すこと
+
+### Lint / Metadata state
+
+- L1 violations: **0 件維持**（scanned 1289 files, no violations）
+- `validate-metadata` FAIL: 7 → **0 件** 🎉
+- 3311 件テスト全 green
+
+## [0.90.0] - 2026-04-23
+
+### Removed
+
+- **fuse-hooks-engine Unit の完全削除** — Unit 定義（`docs/product/units/fuse_hooks_engine_unit.md`）・設計文書（`docs/product/construction/fuse-hooks-engine/` 7 件）・inception プラン（`docs/inception/fuse-hooks-engine/` 配下 8 件）を削除。
+  - `scripts/harness/` 配下に実装コードは一切存在せず、他 Unit からの import / 参照もなかった（Future Phase / v1 スコープ外として設計段階で凍結されていた Unit）。
+  - `docs/product/user_stories.md` から HF1-01 〜 HF1-05 の 5 ストーリーセクションと `H-F1` Epic 行を削除。v1 合計を 54 維持、全体（Future 含む）を 62 → 57 に更新。
+  - `docs/product/units/integration_contract.md` の依存図・Wave 実行計画・Validator ID Registry / CLI Command Registry の `fuse-hooks-engine` 参照を削除。L0 拡張ポイント（6.1 / 6.3）は「OS-level enforcement」の抽象概念として残置。
+  - `docs/product/units/agent_integration_unit.md` Stop Hook Adapter 行の `fuse-hooks-engine（Future: FUSE完了ゲートの参照実装）` 参照を `—` に変更。
+  - `docs/product/construction/agent-integration/unit_test_design.md` UT-WTS-I021 のサンプルパスを `fuse-hooks-engine/HF1-06` → `some-unit/HF1-06` に変更（WORK_ITEM_ID_PATTERN 後方互換テストは維持）。
+
+### Fixed
+
+- **ISSUE-010 Wave 3 完全解消（fuse-hooks-engine 削除の副次効果）** — `validate-metadata` FAIL: 14 → **7**（fuse-hooks-engine 7 ファイル消失）。残 7 は `phase2-extensions` の `HF2-XX` 形式 StoryId で、validator `STORY_ID_PATTERN = /^H[0-9]{2}-[0-9]{2}$/` の拡張が別 issue 対象。
+
+### Lint / Metadata state
+
+- L1 violations: **0 件維持**（scanned 1289 files, no violations）
+- `validate-metadata` FAIL: 14 → **7**（-7）
+- 既存 3308 件テスト全 green（regression なし）
+
+## [0.89.0] - 2026-04-23
+
+### Fixed
+
+- **ISSUE-010 Wave 3（partial）** — 11 Unit × 7 設計文書 = 75 件に `@story-id` standalone 注釈を補填し PASS 化。
+  - `agent-integration` / `biome-ast-engine` / `ci-governance` / `harness-api` / `harness-error` / `nyquist-validation` / `phase-dependency-model` / `quick-mode` / `regression-suite` / `skill-quality` / `validator-system` の各 Unit の 7 ファイル（`coverage_report.md` / `domain_model.md` / `it_test_design.md` / `it_test_logic.md` / `logical_design.md` / `unit_test_design.md` / `unit_test_logic.md`）に H01-H15 系 StoryId を付与。
+  - 残 14 件（`fuse-hooks-engine` 7 + `phase2-extensions` 7）は `HF1-XX` / `HF2-XX` 形式の StoryId を必要とするが、`metadata-validator.STORY_ID_PATTERN = /^H[0-9]{2}-[0-9]{2}$/` が `HF` prefix 非対応のため PASS 化不可能。validator パターン拡張は別 issue 対象（ISSUE-019）として切り出し、本 Wave 3 は partial 完了。
+
+### Lint / Metadata state
+
+- L1 violations: **0 件維持**
+- `validate-metadata` FAIL: 89 → **14**（-75: 11 Unit × 7 ファイル解消）
+- 残 14 件は HF-prefix validator 制約による既知の限界（新規回帰ではない）
+- 既存 3308 件テスト全 green（regression なし）
+
+## [0.88.0] - 2026-04-23
+
+### Fixed
+
+- **ISSUE-010 Wave 2** — `adr-foundation` / `config-foundation` Unit の設計文書 11 件に `@story-id` 注釈を standalone 形式で補填。
+  - adr-foundation 6 件（`coverage_report.md` / `domain_model.md` / `it_test_design.md` / `it_test_logic.md` / `unit_test_design.md` / `unit_test_logic.md`）に `@story-id H05-01 / H05-02 / H05-03` を追加。
+  - config-foundation 5 件（`coverage_report.md` / `domain_model.md` / `it_test_logic.md` / `unit_test_design.md` / `unit_test_logic.md`）に `@story-id H04-01 / H04-02 / H04-03` を追加。
+  - これにより両 Unit とも全 7 ファイル PASS 達成。
+
+### Lint / Metadata state
+
+- L1 violations: **0 件維持**
+- `validate-metadata` FAIL: 100 → **89**（adr-foundation 6 件 + config-foundation 5 件解消）
+- 既存 3308 件テスト全 green（regression なし）
+
+## [0.87.0] - 2026-04-23
+
+### Fixed
+
+- **ISSUE-010 Wave 1 + ISSUE-006 formal CLOSE** — traceability-model Unit の `@story-id` 注釈補填と ISSUE-006 機能的完遂の CLOSE 化。
+  - ISSUE-010 Wave 1: `docs/product/construction/traceability-model/` 残 3 件（`coverage_report.md` / `domain_model.md` / `unit_test_logic.md`）に `@story-id H03-01 / H03-02 / H03-03` を standalone 注釈として補填。`validate-metadata` の FAIL 件数 103 → 100（traceability-model Unit は 0 件到達）。
+  - ISSUE-006 CLOSE: Story A（v0.63.0 / `fullModeRequiredWhen` 設定駆動化）/ Story B（v0.64.0 / pre-tool-use hook 統合）/ P2-3（v0.45.0 / `docs/guide/quick-vs-full-mode.md`）すべて着地済のため formal CLOSE。外部PJ再レビュー（welcome-but-not-blocking）のみ残。
+
+### Lint / Metadata state
+
+- L1 violations: **0 件維持**（v0.86.0 時点で完全解消済、本版で変更なし）
+- `validate-metadata` FAIL: 103 → **100**（traceability-model 3 件解消）
+- 既存 3308 件テスト全 green（regression なし）
+
+## [0.86.0] - 2026-04-23
+
+### Changed
+
+- **ISSUE-019 / ADR-014** — LayerBoundary の解釈を **Robert C. Martin 版 Clean Architecture** に切り替え、`presentation → domain` 直接依存を許容。
+  - 変更: `ALLOWED_DEPENDENCIES.presentation` に `'domain'` を追加（`scripts/harness/biome-ast-engine/domain/value-objects/layer-name.ts:15-20`）。
+  - 背景: 従来の厳格 DDD Layered 解釈では presenter / formatter / CLI handler が domain VO / type / policy を read-only で参照するだけで L1-003 違反となっていたが、これは CA では一般的実装。read-only で DIP の本質を侵さない限り許容する。
+  - 禁止は継続: `presentation → infrastructure`、`domain → 他層`、`application → presentation` 等の逆方向依存。
+  - 緩和策の opt-in 提供は ISSUE-014（アーキ config 化）で対応予定。厳格派は `preset: "strict-ddd"` で現行挙動を維持可能とする。
+  - 新規 ADR: `docs/ADR/ADR-014-presentation-domain-dependency.md`。
+  - 新規 test: `layer-boundary.test.ts` に presentation→domain allowed、presentation→infrastructure disallowed の 2 ケース追加。
+
+### Lint state
+
+- total: 8 → **0**（L1-003 presentation→domain 8 件解消、他 rule 増減無し）
+- 既存 3308 件テスト全 green（新規 2 ケース込み）
+
+## [0.85.0] - 2026-04-23
+
+### Fixed
+
+- **ISSUE-022** — Unit barrel (`**/index.ts`) が `no-layer-violation` で誤検知される問題を解消。
+  - 問題: ISSUE-017（v0.83.0）の `extractImports` 修正で `export ... from` 再帰走査が有効化された結果、`quick-mode/index.ts` の barrel 再エクスポート 7 件が `L1-003` で新規露出していた。Unit barrel は `main.ts` / `composition-root.ts` / `presentation/*-hook.ts` と同じ composition root / entry point の性質を持つが、`no-layer-violation.ignorePatterns` に含まれていなかった。
+  - 修正: `scripts/harness/biome-ast-engine/domain/services/rule-definition-registry.ts` の `no-layer-violation.ignorePatterns` に `'**/index.ts'` を追加。`scripts/harness/*/index.ts` の 11 件の Unit barrel が一括で除外される（sub-layer barrel は存在せず副作用リスク無）。
+  - 残 L1-003 8 件は全て `presentation → domain` パターン（ISSUE-019 の philosophical 案件スコープ）。
+
+### Lint state
+
+- total: 15 → **8**（L1-003 barrel 誤検知 7 件解消）
+- 残 L1-003: 8 件（全て ISSUE-019 スコープ: presentation → domain）
+- 既存 3306 件テスト全 green（regression なし）
+
+## [0.84.0] - 2026-04-23
+
+### Removed
+
+- **L1-006 解消** — `adr-foundation` の never-wired な seed 機能を削除。
+  - `scripts/harness/adr-foundation/infrastructure/seeds/initial-adr-definitions.ts` (11 件の seed 定義、docs/ADR/ 13 件の実 ADR と内容不一致で stale だった)
+  - `scripts/harness/adr-foundation/application/usecases/seed-initial-adrs-use-case.ts`
+  - `scripts/harness/adr-foundation/application/dto/seed-adr-definition.ts`
+  - `scripts/harness/__tests__/unit/adr-foundation/seed-initial-adrs-use-case.test.ts` (6 tests)
+  - `application-errors.ts` から未使用になった `SeedAdrDefinitionCountError` / `DuplicateAdrIdApplicationError` を削除
+  - `infrastructure/seeds/` ディレクトリ自体を削除
+  - composition-root に未配線・CLI 未公開だったため外部影響なし。実 ADR は `docs/ADR/` に直接 markdown として管理済み。
+
+### Fixed
+
+- **L1-007 解消** — `agent-integration/domain/ports/error-guidance-query-port.ts` の JSDoc コメント密度超過を修正。WHAT を説明する冗長コメントを削除（型名から自明）。
+
+### Lint state
+
+- total: 17 → **15**（L1-006: 1 → 0, L1-007: 1 → 0）
+- 残 L1-003: 15 件（全て ISSUE-019 スコープ: barrel 再エクスポート 7 件 + presentation→domain 8 件）
+- 既存 3312 件 - 6 件削除 = **3306 件** テスト全 green
+
 ## [0.83.0] - 2026-04-23
 
 ### Fixed

package/README.ja.md

@@ -56,7 +56,7 @@ npm install --save-dev phasegate
 npx phasegate init --name <プロジェクト名> --preset standard
 ```
 
-`.claude/skills/` に28スキルを展開し、設計原則ドキュメント（`docs/principles/*.md`・`docs/folder_management_rules.md`）を配置し、`phasegate.config.json` を生成します。
+`skills/` に28スキルを展開し、`.claude/skills` / `.codex/skills` などの agent 向け導線を作成し、設計原則ドキュメント（`docs/principles/*.md`・`docs/folder_management_rules.md`）を配置し、`phasegate.config.json` を生成します。
 
 `--preset` で初期構成を選択できます: `minimal`（プロトタイプ）/ `standard`（推奨）/ `strict`（本番）
 
@@ -606,15 +606,17 @@ Phasegate は [OpenAI Codex CLI](https://developers.openai.com/codex/cli) でも
 ### セットアップ（2 ステップ）
 
 ```bash
-# 1. Codex 向けに初期化（.codex/hooks.json を自動配置）
+# 1. Codex 向けにプロジェクトを初期化（.codex/hooks.json や .codex/skills など project 内ファイルを作成）
 npx phasegate init --name my-project --agent codex --with-husky
 
-# 2. Codex hooks フィーチャーフラグを有効化
+# 2. Codex CLI 側の feature flag を手動で有効化
 codex features enable codex_hooks
 ```
 
 Claude + Codex 両対応プロジェクトは `--agent both` を指定してください。
 
+`init` が担当するのは project 内のセットアップです。`codex_hooks` の有効化は Codex 本体のユーザー設定なので、明示的に手動実行します。
+
 ### カバレッジと既知の制約
 
 Codex のネイティブ `apply_patch` ツールは内部の `ApplyPatchHandler` 経由で実行され hook を発火しません（[openai/codex#16732](https://github.com/openai/codex/issues/16732)）。このため pre-edit hard block は Bash 経由の書き込みに限定され、ネイティブ `apply_patch` の違反は **pre-commit (L2)** で commit 時にブロックされます。
@@ -786,16 +788,22 @@ your-project/
 │   │   └── {unit}/{US-XXX}/     # Level 2/3（Unit・ストーリー単位）
 │   └── ADR/
 ├── src/                          # 実装コード（@unit/@layer 必須）
-└── .claude/
-    ├── settings.json             # Hooks 設定
-    └── skills/                   # npx phasegate init で展開
+├── .claude/
+│   ├── settings.json             # Hooks 設定
+│   └── skills/                   # ../skills への symlink
+├── .codex/
+│   ├── hooks.json               # Codex hooks 設定
+│   └── skills/                  # ../skills への symlink（Codex有効時）
+└── skills/                      # npx phasegate init で再生成可能
 ```
 
 ### 推奨 .gitignore
 
 ```
 node_modules/
-.claude/skills/    # npx phasegate init で再生成可能
+skills/            # npx phasegate init で再生成可能
+.claude/skills/    # skills/ への symlink
+.codex/skills/     # skills/ への symlink
 dist/
 reports/
 ```

package/README.md

@@ -49,7 +49,7 @@ npm install --save-dev phasegate
 npx phasegate init --name my-project
 ```
 
-This deploys 28 skills, design principles docs (`docs/principles/*.md`, `docs/folder_management_rules.md`), and generates `phasegate.config.json`.
+This deploys 28 skills to `skills/`, creates agent-specific links such as `.claude/skills` or `.codex/skills`, installs design principles docs (`docs/principles/*.md`, `docs/folder_management_rules.md`), and generates `phasegate.config.json`.
 
 Optional: add `--with-husky` to also install a `.husky/pre-commit` hook that runs L2 validators.
 
@@ -155,7 +155,9 @@ Skills cover the full **AIDLC (AI-Driven Development Life Cycle)**, enforcing ph
 
 ### Presets
 
-`project.preset` -- overall layer strictness:
+Phasegate has two orthogonal preset families — defense and architecture. See the note at the end of this section for naming conventions.
+
+**Defense preset** (`project.preset`) -- overall layer strictness:
 
 | Preset | Layers | Coverage | Use Case |
 |---|---|---|---|
@@ -163,6 +165,22 @@ Skills cover the full **AIDLC (AI-Driven Development Life Cycle)**, enforcing ph
 | `standard` | L1 - L3 | 90% | Production development (default) |
 | `strict` | L1 - L4 | 95% | Mission-critical systems |
 
+**Architecture preset** (`architecture.preset`) -- layer names and dependency directions used by L1-003 / L1-004:
+
+| Preset | Layers | Use Case |
+|---|---|---|
+| `clean` (default) | `domain / application / infrastructure / presentation` | Clean Architecture / AIDLC full harness |
+| `strict-ddd` | `clean` layers + stricter cycle detection | DDD-focused new projects |
+| `onion` | `domain / application / interface` | Onion Architecture |
+| `hexagonal` | `core / ports / adapters` | Hexagonal / Ports-and-Adapters |
+| `layered` | `presentation / business / data` | Classic 3-tier layered |
+| `flat` | No layers | Small scripts / CLI tools / retrofit start |
+| `custom` | User-defined `layers` + `allowedDependencies` | Any other shape |
+
+For selection guidance and config examples see [Preset Selection Guide](docs/guide/preset-selection.md).
+
+> **Naming convention**: "defense preset" refers to CI strictness (`strict` / `standard` / `minimal`). "architecture preset" refers to layer topology (`clean` / `onion` / `hexagonal` / `layered` / `flat` / `strict-ddd` / `custom`). They are set independently.
+
 `phaseDependencies.preset` -- phase-gate shape and storyReflection defaults (independent of `project.preset`):
 
 | Preset | Phase 3 gates | storyReflection default | Use Case |
@@ -274,15 +292,17 @@ Phasegate also integrates with [OpenAI Codex CLI](https://developers.openai.com/
 ### Quick setup
 
 ```bash
-# 1. Initialize with Codex agent support (auto-deploys .codex/hooks.json)
+# 1. Initialize the project for Codex (creates project-local files such as .codex/hooks.json and .codex/skills)
 npx phasegate init --name my-project --agent codex --with-husky
 
-# 2. Enable Codex hooks feature flag
+# 2. Enable the Codex CLI feature flag manually on your machine
 codex features enable codex_hooks
 ```
 
 For dual-agent projects (Claude + Codex), use `--agent both`.
 
+`init` sets up files inside the project. The Codex CLI user-level setting (`codex_hooks`) remains an explicit manual step.
+
 ### Coverage and known limitation
 
 Because Codex's native `apply_patch` tool is routed through an internal `ApplyPatchHandler` and does not emit hook events ([openai/codex#16732](https://github.com/openai/codex/issues/16732)), pre-edit hard-block coverage is limited to Bash-based writes. Native `apply_patch` violations are caught at commit time by the pre-commit layer.

package/docs/ADR/ADR-014-presentation-domain-dependency.md

@@ -0,0 +1,82 @@
+# ADR-014: presentation → domain 直接依存を許容する（Robert C. Martin 版 Clean Architecture 準拠）
+
+## Status
+
+Accepted — 2026-04-23
+
+## Context
+
+ADR-005 で採用した Hexagonal Architecture の派生で、phasegate の L1-003 `no-layer-violation` は当初 **presentation layer は presentation + application にしか依存できない**という厳格 DDD Layered 解釈を採用していた（`scripts/harness/biome-ast-engine/domain/value-objects/layer-name.ts:ALLOWED_DEPENDENCIES`）。
+
+しかしこの解釈では、Clean Architecture 実装として一般的な以下のパターンが全て L1-003 違反として flag される:
+
+- Presenter が Domain VO の値を読み取って表示用文字列に整形する
+- Formatter が Domain Service（policy 系）の判定を呼んで整形する
+- CLI handler が Domain Type（discriminated union 等）を switch して分岐する
+
+ISSUE-019 で監査した時点で 8 件の違反が存在し、いずれも「read-only で VO/type/policy を display/format する」パターンで、Dependency Inversion Principle の本質（domain が外部の詳細に依存しない）は侵していなかった。
+
+### 哲学的立場の整理
+
+| 派 | `presentation → domain` | 出典 |
+|---|---|---|
+| **Robert C. Martin 版 Clean Architecture** | ✅ 許容 | presenter は "Interface Adapters" ring にあり、Entity/VO は Enterprise Business Rules として全 ring から参照可能 |
+| **厳格 DDD Layered** | ❌ 禁止 | presentation は application 経由で DTO を受け取り、domain を直接触らない |
+| **phasegate 旧実装** | ❌ 禁止 | 厳格 DDD 派を採用（実装時の暗黙判断） |
+
+## Decision
+
+`ALLOWED_DEPENDENCIES.presentation` に `'domain'` を追加し、**Robert C. Martin 版 Clean Architecture の解釈を phasegate 標準とする**:
+
+```typescript
+const ALLOWED_DEPENDENCIES = {
+  domain:         ['domain'],
+  application:    ['application', 'domain'],
+  infrastructure: ['infrastructure', 'application', 'domain'],
+  presentation:   ['presentation', 'application', 'domain'],  // domain を追加
+};
+```
+
+### 許容される具体パターン
+
+- presenter/formatter が Domain VO を read-only で取得して表示用文字列に変換
+- CLI handler が Domain Type を参照して分岐
+- formatter が Domain Service の pure method（副作用なし）を呼んで判定
+
+### 依然として禁止されるパターン
+
+- presentation → infrastructure の直接依存（DB/CLI/FS 直叩き）
+- presentation から domain VO の mutation（domain は read-only で扱う）
+- domain → presentation / application / infrastructure の逆方向依存（Dependency Inversion の核）
+
+`infrastructure → domain` と `application → domain` の既存許容は維持。
+
+## Consequences
+
+### ポジティブ
+
+- 既存 8 件の false positive が解消（L1-003 が 8 → 0 件）
+- phasegate を他 PJ に導入したとき、Robert Martin 流 CA を採用している PJ で摩擦が激減
+- `domain VO の直接 read` を presentation で許容する CA 一般的実装が lint を通るようになる
+
+### ネガティブ / トレードオフ
+
+- 厳格 DDD 派（presentation → application → domain を強制したい PJ）では緩すぎる
+  - **緩和策**: ISSUE-014（アーキテクチャスタイル config 化）で `preset: "strict-ddd"` を選択肢として提供予定。厳格派は opt-in できる
+- presenter が domain mutation を行うリスクは残る
+  - **緩和策**: domain VO を immutable（`readonly` + `Object.freeze`）に保つ既存 ADR-009（DDD Tactical Patterns）の規約で抑止
+
+### スコープ外（本 ADR で扱わない）
+
+- application → presentation などの逆方向（Dependency Inversion 違反）の許容は検討対象外
+- domain から他層への依存の許容は検討対象外
+- preset による選択的緩和（`strict-ddd` / `classic-ca` / `custom` 等）は ISSUE-014 の範疇
+
+## 関連
+
+- `scripts/harness/biome-ast-engine/domain/value-objects/layer-name.ts:15-20` — ALLOWED_DEPENDENCIES 実体
+- `scripts/harness/biome-ast-engine/domain/value-objects/layer-boundary.ts:31-45` — standardMatrix
+- ADR-005 (Hexagonal Architecture 採用) — 本 ADR はその依存方向規則の一部緩和
+- ADR-009 (DDD Tactical Patterns) — domain immutability 規約で mutation リスクを抑止
+- ISSUE-019 (LayerBoundary 再評価) — 本 ADR で CLOSED
+- ISSUE-014 (architecture style config) — preset 化での opt-in 厳格派提供を予定