docs(2meet-data-optimizer): 1.2.0 release notes
- Bump to 1.2.0; CHANGELOG / readme entries for PR-066–080, with the post-upgrade ops commands - ADR-004 Release 2.2 design (scope, drift check / fix / router / resync) and CONTEXT.md drift paragraph - Verify: composer test, integration, phpcs 0 - PR: PR-086
This commit is contained in:
@@ -7,6 +7,80 @@ Versioning follows [Semantic Versioning](https://semver.org/).
|
||||
|
||||
---
|
||||
|
||||
## [1.2.0] — 2026-09-27 — 漂移偵測、範圍收斂、CLI 與診斷（hardening 2.2）
|
||||
|
||||
**性質**：功能 + 資料正確性修正。無 schema 變更。延續 ADR-004 的搜尋索引模式；搭配
|
||||
HivePress AddOn 0.3.0、WooCommerce AddOn 0.2.0。
|
||||
|
||||
### Added
|
||||
|
||||
- **`wp tmdo drift-check <entity> [--group] [--sample=<n>] [--format]`**（`TMDO_Drift_Check`）：
|
||||
逐 key 比對扁平表與原生 meta 的值（第一筆原生 row → 安全 unserialize →
|
||||
`Type_Caster::to_db`），回報 miss / diff / extra。序列化 vs JSON、`50` vs `50.000000`
|
||||
不算漂移；超過 255 字元存 NULL 的 text 不算 miss。結果寫入 `wpdo_drift_status`。（PR-070）
|
||||
- **`drift-check --fix`**：刪除已刪實體與非本 group post type 的扁平列，其餘漂移列經
|
||||
`TMDO_Entity_Migration_Engine::migrate_entity()` 從原生重建，清除列快取後再檢查一次。
|
||||
不寫原生；aeav_only（扁平才是真實資料）一律拒絕。（PR-071、PR-073b）
|
||||
- **每日抽樣**：`wpdo_daily_health_check` 對 dual_write 以上、非 aeav_only 的 entity 每個
|
||||
group 抽 500 筆，結果取代既有紀錄。（PR-073）
|
||||
- **Hook Bus 關閉期間的寫入補回**：entity 從 disabled 進入 dual_write / shadow_read，或
|
||||
Hook Bus flag 由關轉開時，60 秒後以單次 WP-Cron `tmdo_drift_resync` 執行全量
|
||||
`drift-check --fix`（不做 `post_modified_gmt` 增量：WooCommerce 直接 SQL 改庫存不會更新
|
||||
post_modified）。停用 / 解除安裝時清除排程。（PR-074）
|
||||
- **`wp tmdo bridge-mode <entity> <mode>`**：經 `TMDO_Mode_Manager::set()`，受
|
||||
Promotion Guard 約束；被拒時 exit 1、模式不變。（PR-069）
|
||||
- **`wp tmdo member-backfill --all`**：回填所有已註冊的 user group。（PR-068）
|
||||
- **`wp tmdo cleanup-hp-transients --options [--dry-run|--confirm] [--batch=<n>]`**：
|
||||
刪除 HivePress AddOn 0.3.0 之前寫進 wp_options 的 `_transient_wpdo_hp_pm_*`（含 timeout），
|
||||
分批刪除（預設 5000），AddOn 未啟用也可執行。dev36 有 2,314,750 列。（PR-080）
|
||||
|
||||
### Changed
|
||||
|
||||
- **Post query router 避開漂移中的 group**：上次 drift-check 有 miss / diff / extra 的
|
||||
group 不路由，整個查詢維持原生（全有或全無）；從未檢查的 group 照常路由；aeav_only
|
||||
不受影響。（PR-072、PR-073b）
|
||||
- **純排序搜尋 flat-first**：沒有路由篩選的 HivePress `_sort` 搜尋，在該 post type 每篇都有
|
||||
扁平列時改由扁平表驅動（`STRAIGHT_JOIN` + INNER JOIN）；Router 在 `wp_insert_post`
|
||||
替新文章建空列，覆蓋率以 anti-join 檢查並快取 15 分鐘（隨 post 模式變更失效）。
|
||||
flat-first 且扁平表是唯一 JOIN 時拿掉 WordPress 為 tax query 加的 `GROUP BY posts.ID`。
|
||||
dev36 `rating__desc`：原生約 3.3 s、1.1.0 約 1.5–1.9 s、現在約 0.51–0.85 s。（PR-079）
|
||||
- **Auto-promoter** 的第三個條件改為 `TMDO_Drift_Check::clean_since()`：2 天內每個 group 都
|
||||
檢查過（抽樣或全量）且沒有漂移；沒有紀錄就不升級。（PR-075）
|
||||
- **shadow_read diff 節流**：每個 entity type + key 每小時最多記 20 列（疊加既有的
|
||||
每物件 5 分鐘視窗）。（PR-075）
|
||||
- **回填 group 改讀 registry**：admin「全部回填」、`post-migrate-group`、`member-backfill`、
|
||||
`member-audit` 取所有已註冊 group（排除已還原的孤兒 group），不再是寫死清單；含 json
|
||||
欄位的 group（attachment、nav_menu_item）逐列經 migration engine。（PR-067、PR-068）
|
||||
- **不再註冊 `post/wc_product`**：WooCommerce 直接讀 product meta、以 SQL 寫庫存，扁平副本
|
||||
必然漂移（ADR-004 決策 2）。既有的 `wp_wpdo_post_wc_product` 表保留，以
|
||||
`wp tmdo bridge-restore-native post --group=wc_product --retire` 封存；解除安裝仍會刪除。（PR-077）
|
||||
- `member-sso-sync`、`member-force-logout` 標示為 deprecated（`sso` group 已不註冊）。（PR-069）
|
||||
|
||||
### Fixed
|
||||
|
||||
- Entity 回填替沒有原生 row 的 key 寫入 DDL 預設值（`session_count` / `account_flags` = 0），
|
||||
每個 user 都被捏造出 0；現在寫 NULL，required NOT NULL 欄位保留預設值。（PR-066）
|
||||
- `member-cutover` 在轉換被拒時 fatal（把 `WP_Error` 當陣列）。（PR-068）
|
||||
- `doctor` 依 registry 檢查 entity 表（不再因從未註冊的 `sso` 表而每站失敗），並顯示
|
||||
Promotion Guard 違規與 drift 狀態；`term-comment-diagnose` 依各 filter 的 `is_enabled()`
|
||||
顯示狀態；`bridge-status` 只計有值的扁平列、eav_ids 限定 group 的 post type
|
||||
（dev36 wp_core 15306% → 100%）。（PR-076）
|
||||
- 2.1 稽核：公開 REST route 註明公開理由；admin 23 處三元 echo 依情境 `esc_attr` /
|
||||
`esc_html`；migration engine 與 health cron 的例外改記 `TMDO_Logger`。（PR-078）
|
||||
|
||||
### Docs
|
||||
|
||||
- ADR-004「設計（Release 2.2）」、`CONTEXT.md` Entity Bridge 的漂移段落。（PR-086）
|
||||
|
||||
### 升級後
|
||||
|
||||
- HivePress 站：部署 AddOn 0.3.0 後執行 `wp tmdo cleanup-hp-transients --options --confirm`。
|
||||
- 曾註冊 wc_product 的站：`wp tmdo bridge-restore-native post --group=wc_product --retire`。
|
||||
- 已進入 dual_write 以上的站：`wp tmdo drift-check <entity>` 建立第一筆紀錄（未檢查的
|
||||
group 照常路由）。
|
||||
|
||||
---
|
||||
|
||||
## [1.1.1] — 2026-09-26 — Security：公開 REST 不再回傳私有欄位
|
||||
|
||||
**性質**：安全修正（Critical）。1.0.x 起即存在；1.1.0 zip 已撤回（`dist/withdrawn/`）。
|
||||
|
||||
Reference in New Issue
Block a user