phasegate 0.109.0 → 0.110.0

package/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.110.0] - 2026-04-25
+
+### Documentation
+
+- **WI-030: README / layer-model 主張と実装の乖離訂正** — README.ja.md と docs/guide/layer-model.md の audit で発見した不整合を訂正。
+  - **README.ja.md L180**: 「毎週月曜 09:00 UTC + GitHub Issue 自動作成」の記述を実態に合わせて訂正。bundled template (`scripts/harness/templates/.github/workflows/consistency-check.yml`) は月曜 04:00 UTC + issue 自動化、CLI 生成 (`ci:generate-template --type consistency-check`) は毎日 02:00 UTC + issue 化なし、と二系統あることを明示。`phasegate init` が workflow を自動配置しない点も補足。
+  - **README.ja.md L408**: feature flag disclaimer 「ランタイム動作未実装」を削除し、`agentLessonCollection` / `cascadeUpdate` / `bundleSizeLimit` / `deadCodeGC` の各 runtime 動作実装箇所を表に追記。
+  - **docs/guide/layer-model.md L4 セクション**: WI-029 で誤って追加した `doc-freshness` / `pointer-validation` を L4 validators 一覧から削除し、これらは `phase2-extensions` unit の `p2:check-freshness` / `p2:validate-pointers` CLI として実装されている旨を注記（L4-004 / L4-005 への昇格は WI-033 に分離）。
+- **README.md / README.ja.md に Roadmap 節を新設** — partial 実装 / user-side wiring 依存の機能を 4 件の Work Item として明示:
+  - WI-031: CI template 二系統統一 + `phasegate init --with-ci`
+  - WI-032: AGENTS.md / CLAUDE.md auto-refresh パイプライン
+  - WI-033: `doc-freshness` / `pointer-validation` を L4 validator に昇格
+  - WI-034: L0 legacy validator (`L0-001` / `L0-002`) の撤去
+
+Source code 改変なし。次のリリースで上記 Roadmap WI が順次対応される予定。
+
 ## [0.109.0] - 2026-04-25
 
 ### Documentation

package/README.ja.md

@@ -177,7 +177,11 @@ L4 は CI の cron スケジュールで週次実行します。`consistency-che
 npx phasegate ci:generate-template --type consistency-check --render > .github/workflows/consistency-check.yml
 ```
 
-デフォルトは毎週月曜 09:00 UTC に実行。乖離やデッドコードが検出されると GitHub Issue が自動作成されます。手動で実行する場合は `npx phasegate validate --layer L4` を使います。
+**bundled template (`scripts/harness/templates/.github/workflows/consistency-check.yml`) を user 側で `.github/workflows/` にコピー**する場合は、月曜 04:00 UTC に走り、検出時に `github.rest.issues.create` で GitHub Issue を自動作成します。
+
+一方、`ci:generate-template --type consistency-check --render` で **CLI 生成した YAML** は現状 `cron: "0 2 * * *"` (毎日 02:00 UTC) で出力され、issue 自動作成 logic は含まれていません（両経路の統一は **WI-031** で予定）。
+
+手動実行は `npx phasegate validate --layer L4` を使います。なお `phasegate init` は workflow を自動配置しないため、L4 を CI で動かすには user 側で workflow を `.github/workflows/` 配下に commit する必要があります（自動配置は WI-031 `--with-ci` フラグで予定）。
 
 ---
 
@@ -400,14 +404,14 @@ npx phasegate <command> [options]
 
 利用可能な Feature flags:
 
-| Feature | 説明 | デフォルト |
-|---|---|---|
-| `agentLessonCollection` | AI エージェントの学習ログを収集 | off (`strict` で on) |
-| `cascadeUpdate` | 下位フェーズの変更を上位設計に自動反映 | off |
-| `bundleSizeLimit` | バンドルサイズ制限チェック (KB) | off (`strict` で 500KB) |
-| `deadCodeGC` | デッドコード検出・削除 | off (`strict` で on) |
+| Feature | 説明 | デフォルト | ランタイム動作 |
+|---|---|---|---|
+| `agentLessonCollection` | AI エージェントの学習ログを収集 | off (`strict` で on) | ✅ 実装済（agent-integration unit の `harness-config-config-query-adapter.ts:86` で参照、pre-tool-use hook 経路で機能） |
+| `cascadeUpdate` | 下位フェーズの変更を上位設計に反映 | off | ✅ 実装済（`CascadeUpdateService` 経由で `skill:apply-cascade-update` CLI / cascade-updater skill が動作） |
+| `bundleSizeLimit` | バンドルサイズ制限チェック (`number`、単位は KB) | `0` (off) / `strict` で `500` | ✅ 実装済（L3-002 performance validator が threshold として参照） |
+| `deadCodeGC` | デッドコード検出 | off (`strict` で on) | ✅ 実装済（L4 `dead-code-detection-service` が threshold 経由で受領） |
 
-> **注意**: Feature flags は config への保存・読み出しは動作しますが、フラグに応じたランタイム動作は未実装です（将来バージョンで対応予定）。
+> **補足**: 過去のバージョンでは「Feature flags のランタイム動作未実装」と記載していましたが、`v0.110.0` 時点では上表のとおり 4 機能とも実 runtime で動作します。
 
 ### 品質チェック
 
@@ -814,10 +818,25 @@ reports/
 
 ---
 
+## 今後の実装予定 (Roadmap)
+
+README/docs 上で言及があるが、現状 partial 実装か user 側 wiring に依存しているもの。それぞれ Work Item として `docs/inception/_cross/WI-XXX/description.md` 配下に起票済み。
+
+| Work Item | タイトル | 概要 |
+|---|---|---|
+| **[WI-031](docs/inception/_cross/WI-031/description.md)** | CI template の二系統統一 + `phasegate init --with-ci` | bundled template と `ci:generate-template` 出力が cron / GitHub Issue 自動化ロジックで乖離。さらに `phasegate init` は workflow を自動配置しないため L4 が user 配置に依存している。両方を解消する。|
+| **[WI-032](docs/inception/_cross/WI-032/description.md)** | AGENTS.md / CLAUDE.md auto-refresh パイプライン | `ci:migrate-agents-md` の一回限り CLI は存在するが定期実行機構が無く、CLAUDE.md は完全な手動メンテ。週次 workflow + CLAUDE.md template-driven 再生成（user 編集領域を保護）を追加する。|
+| **[WI-033](docs/inception/_cross/WI-033/description.md)** | `doc-freshness` / `pointer-validation` を L4 validator に昇格 | 機能は `p2:check-freshness` / `p2:validate-pointers` CLI として実装済みだが、L4 validator として登録されておらず `validate --layer L4` で走らない。validator-system に編入する。|
+| **[WI-034](docs/inception/_cross/WI-034/description.md)** | L0 legacy validator (`L0-001` / `L0-002`) の撤去 | FUSE 構想の名残として残存している `fuse-hook-config` / `fuse-mount-status` の definition を削除。実態の L0 は agent-integration の runtime hook + Husky として既に確立しているため、誤解を招く legacy を整理する。|
+
+L3 Nyquist Validation の `requirement-test-matrix.json` 自動生成パイプラインも依然未完成であり、§5層防御モデル の L3 Nyquist 節を参照のこと。
+
+---
+
 ## 開発者向けドキュメント
 
 phasegate 自体の開発（内部アーキテクチャ、回帰テスト、リリース手順等）については [DEVELOPMENT.ja.md](DEVELOPMENT.ja.md) を参照してください。
 
 ---
 
-*Last updated: 2026-04-22 -- v0.66.0*
+*Last updated: 2026-04-25 -- v0.110.0*

package/README.md

@@ -376,6 +376,21 @@ Additional resources:
 
 ---
 
+## Roadmap (Planned but not yet implemented)
+
+The following are documented behaviors that are partially implemented or rely on user-side wiring. Each is tracked as a Work Item and will land in a future minor release. Inception docs live under `docs/inception/_cross/WI-XXX/description.md`.
+
+| Work Item | Title | Why it matters |
+|---|---|---|
+| **[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 also a known gap; see the L3 section above.
+
+---
+
 ## Contributing
 
 Contributions are welcome. See [DEVELOPMENT.md](DEVELOPMENT.md) for internal architecture, regression tests, and release procedures.

package/docs/guide/layer-model.md

@@ -142,13 +142,13 @@ L4 validators are designed to run on a weekly schedule and detect slow-moving dr
 
 > **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.
 
-| Validator | Description |
-|-----------|-------------|
-| **drift-detect** | Bidirectional design-code drift detection. Compares design documents against the actual codebase to find divergence in either direction. |
-| **consistency-check** | Cross-document layer consistency. Ensures that references between design documents, ADRs, and code remain coherent. |
-| **dead-code** | Detects unused exports and unreachable code that should be removed. |
-| **doc-freshness** | Flags design documents whose last update is older than a configured threshold while the corresponding code has diverged. |
-| **pointer-validation** | Verifies that relative-path pointers inside design docs resolve to files that actually exist. |
+| Validator | ID | Description |
+|-----------|-----|-------------|
+| **drift-detect** | L4-001 | Bidirectional design-code drift detection. Compares design documents against the actual codebase to find divergence in either direction. |
+| **consistency-check** | L4-002 | Cross-document layer consistency. Ensures that references between design documents, ADRs, and code remain coherent. |
+| **dead-code** | L4-003 | Detects unused exports and unreachable code that should be removed. |
+
+> **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`.
 
 **Command:**
 

package/package.json

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