feat(startup): implement phase2-4 delta rendering and cohort gates

Author: Jacobinwwey

docs/diataxis/en/explanation/startup-node-update-acceleration-plan.md

@@ -183,3 +183,16 @@ npm run perf:startup:matrix -- --root tmp/startup-logs --single-platform-label w
 - Data boundary:
   - `tmp/startup-logs-simulated` is synthetic and only valid for pipeline/gate/report flow verification.
   - Release-go performance decisions must be based on real same-device baseline/pilot cohorts.
+
+## 13) Phase 2-4 Execution Snapshot (March 31, 2026)
+
+- Phase 2 (delta protocol):
+  - Worker now emits `tickMode=full|delta` with `isDelta`.
+  - Delta payloads send changed nodes only (epsilon-controlled) with periodic full-sync fallback (`fullSyncEveryTicks`).
+  - Tick emission now adapts by alpha (`tickMaxFps` vs `lowAlphaTickMaxFps`).
+- Phase 3 (staged rendering):
+  - SVG startup stage now renders key-edge TopK first (priority by node centrality/degree).
+  - Full edges are restored automatically after startup window while keeping geometry delay guard.
+- Phase 4 (verification and rollout gate):
+  - Added `perf:startup:cohorts:verify` for three-cohort (`small/medium/large`) automatic gates.
+  - Supports session-floor gate (`--min-sessions-per-platform`) and strict CI exit (`--strict`).

docs/diataxis/en/reference/interfaces-and-runtime.md

@@ -35,9 +35,18 @@ This reference tracks canonical API/runtime contracts.
 - Worker startup profile is passed through `simulationWorker` init payload:
   - `startupProfile.id`
   - `startupProfile.tickMaxFps`
+  - `startupProfile.lowAlphaTickMaxFps`
+  - `startupProfile.lowAlphaThreshold`
   - `startupProfile.stableAlphaThreshold`
   - `startupProfile.stableHoldTicks`
   - `startupProfile.stableTimeoutMs`
+  - `startupProfile.deltaEnabled`
+  - `startupProfile.deltaEpsilonPx`
+  - `startupProfile.fullSyncEveryTicks`
+- Worker -> main-thread tick transport contract (Phase 2):
+  - `tickMode: 'full' | 'delta'`
+  - `isDelta: boolean`
+  - `nodes: [{ id, x, y }]` (delta mode only includes changed nodes)
 - Multi-platform startup pilot profiles:
   - `desktop_windows_pilot`: `26 FPS`, `400ms` edge delay, `1500ms` SVG cap window (`18000` links).
   - `desktop_macos_pilot`: `24 FPS`, `430ms` edge delay, `1700ms` SVG cap window (`15000` links).
@@ -73,6 +82,10 @@ This reference tracks canonical API/runtime contracts.
   - `npm run perf:startup:matrix:simulate -- --seed-root tmp/startup-logs --out-root tmp/startup-logs-simulated`
   - `npm run perf:startup:matrix -- --root tmp/startup-logs-simulated --out tmp/startup-logs-simulated/report-platform-matrix.md`
   - Note: `tmp/startup-logs-simulated` is synthetic data and must not be used for release-go performance decisions.
+- Three-cohort automatic regression and rollout gate (Phase 4):
+  - `npm run perf:startup:cohorts:verify -- --root <cohorts-root> --cohorts small,medium,large --out <report-path> --strict`
+  - Directory contract: `<cohorts-root>/<cohort>/<platform>/baseline|pilot`
+  - Session floor gate is configurable via `--min-sessions-per-platform <N>`
 
 ## Mermaid Canonical Baseline (Obsidian)
 

docs/diataxis/zh/explanation/startup-node-update-acceleration-plan.md

@@ -183,3 +183,16 @@ npm run perf:startup:matrix -- --root tmp/startup-logs --single-platform-label w
 - 数据边界：
   - `tmp/startup-logs-simulated` 全部为模拟数据，仅用于脚本链路、门禁规则与报表产物验证。
   - 发布级性能结论必须基于真实设备同设备双阶段样本（baseline/pilot）。
+
+## 13) Phase 2-4 收尾执行快照（2026-03-31）
+
+- Phase 2（增量协议）：
+  - Worker 支持 `tickMode=full|delta` 与 `isDelta` 标记。
+  - 按 `deltaEpsilonPx` 仅回传变化节点，并以 `fullSyncEveryTicks` 周期全量兜底。
+  - 根据 `alpha` 自动切换 `tickMaxFps` 与 `lowAlphaTickMaxFps`（低 alpha 降频）。
+- Phase 3（分层渲染）：
+  - SVG 启动阶段改为 key-edge TopK（按节点中心性/度优先）优先渲染。
+  - 启动窗口结束后自动补齐全边，保留边几何延迟策略。
+- Phase 4（验证与灰度）：
+  - 新增 `perf:startup:cohorts:verify`，支持 `small/medium/large` 三规模回归门禁。
+  - 支持样本量门禁（`--min-sessions-per-platform`）与 `--strict` 失败即退出。

docs/diataxis/zh/reference/interfaces-and-runtime.md

@@ -35,9 +35,18 @@
 - Worker 通过 `simulationWorker` 初始化载荷接收启动 profile：
   - `startupProfile.id`
   - `startupProfile.tickMaxFps`
+  - `startupProfile.lowAlphaTickMaxFps`
+  - `startupProfile.lowAlphaThreshold`
   - `startupProfile.stableAlphaThreshold`
   - `startupProfile.stableHoldTicks`
   - `startupProfile.stableTimeoutMs`
+  - `startupProfile.deltaEnabled`
+  - `startupProfile.deltaEpsilonPx`
+  - `startupProfile.fullSyncEveryTicks`
+- Worker -> 主线程 tick 传输契约（Phase 2）：
+  - `tickMode: 'full' | 'delta'`
+  - `isDelta: boolean`
+  - `nodes: [{ id, x, y }]`（delta 模式仅包含变化节点）
 - 多平台启动试点 profile：
   - `desktop_windows_pilot`：`26 FPS`、`400ms` 边延迟、`1500ms` SVG 窗口（`18000` 条边）。
   - `desktop_macos_pilot`：`24 FPS`、`430ms` 边延迟、`1700ms` SVG 窗口（`15000` 条边）。
@@ -73,6 +82,10 @@
   - `npm run perf:startup:matrix:simulate -- --seed-root tmp/startup-logs --out-root tmp/startup-logs-simulated`
   - `npm run perf:startup:matrix -- --root tmp/startup-logs-simulated --out tmp/startup-logs-simulated/report-platform-matrix.md`
   - 注意：`tmp/startup-logs-simulated` 为模拟数据，禁止用于 release-go 性能结论，仅用于脚本/门禁流程演练。
+- 三规模自动回归与灰度门禁（Phase 4）：
+  - `npm run perf:startup:cohorts:verify -- --root <cohorts-root> --cohorts small,medium,large --out <report-path> --strict`
+  - 目录约定：`<cohorts-root>/<cohort>/<platform>/baseline|pilot`
+  - 支持样本量门禁：`--min-sessions-per-platform <N>`
 
 ## Mermaid 标准兼容基线（Obsidian）
 

package.json

@@ -61,6 +61,7 @@
     "perf:startup:matrix": "node scripts/compare-startup-perf-matrix.js",
     "perf:startup:matrix:watch": "node scripts/watch-startup-perf-matrix.js",
     "perf:startup:matrix:simulate": "node scripts/simulate-startup-perf-platform-logs.js",
+    "perf:startup:cohorts:verify": "node scripts/verify-startup-perf-cohorts.js",
     "verify:pathbridge:strict": "node scripts/verify-pathbridge-strict-schema.js",
     "generate:sbom": "node scripts/generate-sbom.js",
     "generate:sbom:attestation": "node scripts/generate-sbom-attestation.js",