Checkpoint 390 — Efficiency & control depth (3.90)¶
Status: planned — opens after tranche 10 waves (3.34…3.82) land
Scope: Sign-off for kit cold start, memory, silent runtime, control depth, and package slim — no default UX / switch-latency regressions
Roadmap: ROADMAP.md
Prerequisite for: checkpoint-400 (4.00)
Cold start wave: green — signed off 2026-08-27 at QWINUI3_VERSION 3.40 (S10–S17).
Memory wave: green — signed off 2026-08-27 at QWINUI3_VERSION 3.48 (H10–H17).
Silent runtime wave: green — signed off 2026-08-27 at QWINUI3_VERSION 3.55 (C20–C26). Depth / package rows remain open until their waves land.
Hard rules (must stay green)¶
| Rule | Pass |
|---|---|
| Default UX unchanged | No appearance/motion duration change without upgrade-notes row |
| Switch latency | NavigationView / page / Gallery switch p50 ≤ 3.33 baseline (same Release machine) |
| Additive APIs | New APIs default off or behavior-compatible |
| Measure | Startup ms · working-set/RSS · switch budget recorded |
Wave checklist¶
| Wave | Slices | IDs | Status |
|---|---|---|---|
| Cold start | 3.34…3.40 | S10–S17 | Shipped — see Cold start sign-off |
| Memory | 3.41…3.48 | H10–H17 | Shipped — see Memory sign-off |
| Silent runtime | 3.49…3.55 | C20–C26 | Shipped — see Silent runtime sign-off |
| Control depth | 3.56…3.72 | D30–D54 | 3.56 D30–D32 shipped · rest Planned |
| Platform + package | 3.73…3.82 | P10–P12 · K10–K16 | Planned |
| Friction buffer | 3.83…3.89 | friction-log only | Planned |
Exit criteria (tag v3.90)¶
- [x] Startup budget met on CI Win Release (
--startup-log/ smokemain=) — 3.39 S16 gate + 3.40 sign-off below - [ ] Working-set / RSS table filled; Gallery idle RSS ↓ vs 3.33 baseline — table filled at 3.48 (post-wave); ↓ vs 3.33 still unverified (3.33 never captured)
- [x] Switch p50 recorded — 3.55 warm Gallery
openPagep50 ≈ 146 ms (modenone); 3.33 pre-wave never captured — see Silent runtime sign-off - [ ] D30–D54 shipped or deferred with friction-log link
- [ ] K10–K14 presets + size table published
- [x] performance.md updated with budgets — 3.39 absolute CI table
- [ ] No 4.00 breaking changes bundled into 3.90
Out: L1–L5 micro-interaction wave · changing default page-transition timings · new public control types without friction proof
Cold start sign-off (S10–S17 · 3.40)¶
| ID | Slice | Deliverable | Verdict |
|---|---|---|---|
| S10 | 3.34 | Bootstrap minimal path — no optional host probes before first frame | Shipped |
| S11 | 3.34 | Defer Style / Theme work not needed for first paint | Shipped |
| S12 | 3.35 | Defer Charts / OSK / WebView2 QML registration until first import | Shipped |
| S13 | 3.36 | Gallery / examples default shell import set | Shipped |
| S14 | 3.37 | Gallery ControlCatalog lazy (Home hot index) | Shipped |
| S15 | 3.38 | WebView2 probe / Keyman / FrameStats on demand | Shipped |
| S16 | 3.39 | Absolute main= / app= CI budgets in smoke_gallery.py |
Shipped |
| S17 | 3.40 | This section — wave sign-off | Signed off |
Interactive shell measurements¶
python scripts/smoke_gallery.py --check-startup-budget (Release qwinui3_gallery, Qt 6.8). Field main= = wall ms through Main.qml (interactive shell).
| Machine | Date | app avg |
main avg (n) |
Budget | Pass |
|---|---|---|---|---|---|
| Win Release (dev, this audit) | 2026-08-27 | ~13 ms | ~335 ms (n=5, min 330 / max 352) | Win main ≤ 1500 · app ≤ 800 |
Yes |
| CI Win Release | (GHA smoke.yml) |
— | enforced every push | same absolute table | Gate on |
| CI Linux offscreen | (GHA smoke.yml) |
— | enforced every push | main ≤ 2000 · app ≤ 1000 |
Gate on |
Pre-wave contract: 3.33 / S5 used an advisory main < 1500 ms without an absolute CI fail. 3.39 promoted that number to a hard gate (performance.md). Local 3.40 main ≈ 335 ms is well under the ceiling (~78% headroom vs 1500).
Smoke: python scripts/smoke_gallery.py --check-startup-budget → OK (2026-08-27).
Out of cold-start wave: Gallery idle RSS · nav switch p50 · kit zip size — later waves (H / C / K).
Memory sign-off (H10–H17 · 3.48)¶
| ID | Slice | Deliverable | Verdict |
|---|---|---|---|
| H10 | 3.41 | FluentIcons / glyph path — shared PreferNoHinting QFont cache |
Shipped |
| H11 | 3.42 | Theme singleton — lazy Text/Display stacks; density formula-only | Shipped |
| H12 | 3.43 | List/Tree reuseItems + mild cacheBuffer; NavigationView pane later drops pooling (variable-height groups) |
Shipped |
| H13 | 3.44 | DataTable lean ListView roles + hidden-column filter discipline | Shipped |
| H14 | 3.45 | Chart series ring caps documented + opt-in capacity / trimRing |
Shipped |
| H15 | 3.46 | Gallery page Component unload (pageCacheLimit: 8 + pins) |
Shipped |
| H16 | 3.47 | Pixmap / shadow cache caps; ElevatedChrome FBO hygiene | Shipped |
| H17 | 3.48 | This section — wave sign-off + working-set table | Signed off |
Gallery idle working-set measurements¶
Method: Release qwinui3_gallery.exe (no --smoke), wait 5 s after launch (Home settled), sample process WorkingSet64 / PrivateMemorySize64, then quit. Repeat cold starts n=5. Machine: Win Release (dev, this audit), Qt 6.8, 2026-08-27.
| Metric | Avg | Min | Max | n |
|---|---|---|---|---|
| WorkingSet (MB) | 136.2 | 133.8 | 138.5 | 5 |
| Private bytes (MB) | 162.7 | 159.4 | 165.6 | 5 |
Honesty: 3.33 pre-wave idle RSS was never recorded, so “↓ vs 3.33” cannot be claimed at H17. Post-wave idle WS is the baseline for later 3.90 / CI comparisons. No CI RSS gate yet (same posture as S17 documenting startup before inventing new infra).
Recipes: performance.md H10–H16 rows (icon fonts, Theme trim, list overscan, DataTable lean roles, chart rings, Gallery page cache, pixmap/shadow caps).
Out of memory wave: Nav switch p50 · kit zip size · silent-runtime paint coalesce (C20+).
Silent runtime sign-off (C20–C26 · 3.55)¶
| ID | Slice | Deliverable | Verdict |
|---|---|---|---|
| C20 | 3.49 | Remaining experimental chart paint coalesce | Shipped |
| C21 | 3.50 | Binding churn / Gallery incremental nav sync | Shipped |
| C22 | 3.51 | ItemsView / ListDetailsView filter + cacheBufferPx |
Shipped |
| C23 | 3.52 | DataTable / TreeDataGrid row-height cache + skip | Shipped |
| C24 | 3.53 | NavigationView pane rebuild costs | Shipped |
| C25 | 3.54 | Stable-six chart coalesce inventory | Shipped |
| C26 | 3.55 | This section — wave sign-off + switch p50 | Signed off |
Gallery warm page-switch measurements¶
Method: Release qwinui3_gallery.exe, full nav model ready, warm NavigationView.openPage among cached Components with pageTransition: none (framework switch cost — excludes default slide animation). Sample wall ms from openPage to next event-loop turn after StackView replace. Pages: HomePage · ButtonPage · SettingsPage · DataTablePage · NavigationViewPage · PerformancePage. n=24 warm switches. Machine: Win Release (dev, this audit), Qt 6.8, 2026-08-27.
| Metric | Value | n |
|---|---|---|
| Switch p50 (ms) | 146 | 24 |
| Switch p95 (ms) | 215 | 24 |
| Switch avg (ms) | 135 | 24 |
Honesty: 3.33 pre-wave nav switch ms was never recorded, so “≤ 3.33 baseline” cannot be numerically proven at C26. Post-wave p50 ≈ 146 ms (mode none) is the frozen baseline for later 3.90 comparisons. Default Gallery pageTransition: slide still uses Theme motion (~motionSlow enter) on top of this framework cost — silent-runtime slices did not shorten transitions. No CI switch-p50 gate yet (same posture as H17).
Smoke: python scripts/smoke_gallery.py --check-startup-budget still OK at sign-off.
Recipes: performance.md C20–C25 rows (chart coalesce, binding churn, list/table defaults, Nav pane, stable-six inventory).
Out of silent-runtime wave: Control depth (D30+) · kit zip size · CI switch gate.
Baseline capture (fill as waves land)¶
| Metric | Machine | 3.33 / pre-wave | 3.40 cold start | 3.48 memory | 3.55 runtime | 3.90 result |
|---|---|---|---|---|---|---|
Interactive shell ms (main=) |
Win Release (dev) | advisory < 1500 (no CI fail) | ~335 (n=5) | — | — | |
| Interactive shell ms | CI Win Release | advisory < 1500 | ≤ 1500 absolute gate (S16) | — | — | |
| Gallery idle WorkingSet (MB) | Win Release (dev) | not captured | — | ~136 (n=5) | — | |
| Gallery idle RSS (MB) | CI Win Release | TBD | — | — | — | |
| Nav page switch p50 (ms) | Win Release (dev) | not captured | — | — | ~146 (n=24, mode none) |
|
Kit zip shell (MB) |
Release package | TBD | — | — | — | |
| PyPI default wheel (MB) | Release | TBD | — | — | — |