From c353525a5152f3c7d9d7eda7bd93a15e398e1076 Mon Sep 17 00:00:00 2001 From: ZhuchkaTriplesix Date: Sun, 26 Jul 2026 23:46:41 +0300 Subject: [PATCH] =?UTF-8?q?docs:=20sync=20roadmap=20and=20checklist=20for?= =?UTF-8?q?=20shipped=200.4.7=E2=80=930.4.10=20and=200.4.11?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Mark planned-0.4.4/7/8 as shipped, retarget release-checklist to 0.4.11, and align roadmap with Latest Release 0.4.10 + packaging 0.4.11. Closes #343 Co-authored-by: Cursor --- docs/planned-0.4.4.md | 7 ++++--- docs/planned-0.4.7.md | 2 ++ docs/planned-0.4.8.md | 2 ++ docs/release-checklist.md | 36 +++++++++++++++++++++++++----------- docs/roadmap.md | 21 +++++++++++++++------ 5 files changed, 48 insertions(+), 20 deletions(-) diff --git a/docs/planned-0.4.4.md b/docs/planned-0.4.4.md index 2d1773c4..b4bd599f 100644 --- a/docs/planned-0.4.4.md +++ b/docs/planned-0.4.4.md @@ -1,9 +1,10 @@ # Planned release 0.4.4 — UI motion polish and high refresh rate -**Status:** planning (GitHub milestone [**0.4.4**](https://github.com/QueryaHub/Querya-Desktop/milestone/3), epic **#170**). -**Depends on:** **0.4.3** theme follow-ups (shipped). -**Design doc:** [motion-and-high-refresh.md](motion-and-high-refresh.md) — research, current-state audit, and per-platform Hz behavior. +**Status:** ✅ **shipped** (GitHub milestone [**0.4.4**](https://github.com/QueryaHub/Querya-Desktop/milestone/3), epic **#170**). +**Depends on:** **0.4.3** theme follow-ups (shipped). +**Design doc:** [motion-and-high-refresh.md](motion-and-high-refresh.md) — research, current-state audit, and per-platform Hz behavior. +**Follow-up on `dev`:** Fluid morphing wave (#342) + perf audit (#356) land in **0.4.11**. Theme: make every animation **smooth and pleasant** through one motion system, and make the app render at the display's **native refresh rate (90/120/144 Hz)** on Linux, Windows, and macOS instead of being capped at 60. diff --git a/docs/planned-0.4.7.md b/docs/planned-0.4.7.md index 9ddf0a37..97ba76fa 100644 --- a/docs/planned-0.4.7.md +++ b/docs/planned-0.4.7.md @@ -1,5 +1,7 @@ # Milestone 0.4.7: Local Extension Discovery & Manifests +**Status:** ✅ **shipped** (Git tag / release **0.4.7**). + **Theme**: Подготовка фундамента для расширений с фокусом на "локальное обнаружение". Мы создаем базовые модели `ExtensionManifest`, папку `~/.querya/extensions/` и мигрируем существующие локальные темы так, чтобы приложение видело их как полноценные "расширения". Сетевых запросов и RPC пока нет. | ID | Scope | Summary | diff --git a/docs/planned-0.4.8.md b/docs/planned-0.4.8.md index 96898554..365cd361 100644 --- a/docs/planned-0.4.8.md +++ b/docs/planned-0.4.8.md @@ -1,5 +1,7 @@ # Milestone 0.4.8: Extension Manager UI +**Status:** ✅ **shipped** (Git tag / release **0.4.8**). Live Marketplace API remains **0.5.0**. + **Theme**: Разработка пользовательского интерфейса менеджера расширений (Marketplace Client). Мы создаем вкладку в настройках или отдельное окно, где пользователь сможет просматривать установленные расширения, искать новые в маркетплейсе, скачивать, обновлять и удалять их. Бэкенд маркетплейса пока будет замокан или использоваться статический JSON для тестов. | ID | Scope | Summary | diff --git a/docs/release-checklist.md b/docs/release-checklist.md index 9b38f319..b782ba7f 100644 --- a/docs/release-checklist.md +++ b/docs/release-checklist.md @@ -1,9 +1,23 @@ -# Pre-release checklist (release **0.4.4**) +# Pre-release checklist (release **0.4.11**) -Use this before tagging **`0.4.4`** or running the **Release** workflow. -See [tags-and-releases.md](tags-and-releases.md) and [CHANGELOG.md](../CHANGELOG.md). +Use this before tagging **`0.4.11`** or running the **Release** workflow. +See [tags-and-releases.md](tags-and-releases.md), [CHANGELOG.md](../CHANGELOG.md), and epic [#341](https://github.com/QueryaHub/Querya-Desktop/issues/341). +Detailed QA track: issue [#344](https://github.com/QueryaHub/Querya-Desktop/issues/344). -## Product smoke (manual) +## Product smoke (manual) — 0.4.11 + +- [ ] Fresh profile / empty state: create one connection per supported type (PostgreSQL, MySQL, Redis, MongoDB, SQLite). +- [ ] Reopen the app: connections still appear; **connect** succeeds (secrets migrated or loaded from secure store). +- [ ] Remove a connection: it disappears and reconnect is impossible without re-entering credentials. +- [ ] **Connection → New Database Connection** from the menu saves and shows in the tree. +- [ ] **Driver Manager** lists built-in drivers + installed sandboxed drivers (no misleading JDBC requirement). +- [ ] **Empty workspace hero** — quick-start actions + recent connections; connect morphs into workspace without hard-cut jank. +- [ ] **Export** — CSV / JSON / Markdown / SQL dump from ResultsTab on a small result set. +- [ ] **Extension table view** — open a sandboxed driver table (or fixture); toolbar filter + export present. +- [ ] **Updater** — Check for Updates / badge sees Latest Release channel correctly after tag. +- [ ] **Fluid shell** — tab strip sliding pill; dialog/dropdown fade-slide; Motion Off snaps (see also [perf-baseline.md](perf-baseline.md) Fluid §). + +## Regression smoke (prior releases) - [ ] Fresh profile / empty state: create one connection per supported type (PostgreSQL, MySQL, Redis, MongoDB). - [ ] Reopen the app: connections still appear; **connect** succeeds (secrets migrated or loaded from secure store). @@ -41,8 +55,8 @@ Verify the 0.4.4 motion tokens, smooth animations, and high refresh rate support - [ ] **Motion Reduced** — set to **Reduced**, check that animations are visibly faster (durations cut in half). - [ ] **Motion Off** — set to **Off**, check that animations complete instantly (0 ms). - [ ] **OS Reduced Motion** — enable reduced motion in OS settings. The app should automatically disable animations (acting as Off) regardless of in-app Full/Reduced settings (OS setting wins). -- [ ] **Hz diagnostics** — start the app with `--dart-define=QUERYA_REFRESH_OVERLAY=true`. The overlay should display the correct target refresh rate of the monitor. -- [ ] **High refresh rate smoothness** — verify dialog fade+scale, dropdown show, and tree expand/collapse look extremely smooth at high-Hz (90/120/144 Hz) without jank. +- [ ] **Hz diagnostics** — start the app with `--dart-define=QUERYA_REFRESH_OVERLAY=true`. The overlay should display the monitor refresh rate (**Linux: query-only** — compositor decides Hz; see [motion-and-high-refresh.md](motion-and-high-refresh.md)). +- [ ] **High refresh rate smoothness** — verify dialog fade-slide, dropdown show, and tree expand/collapse look smooth at high-Hz (90/120/144 Hz) without jank. ## Automated @@ -52,14 +66,14 @@ Verify the 0.4.4 motion tokens, smooth animations, and high refresh rate support ## Versioning and release -- [ ] `pubspec.yaml` on **`dev`** is **`0.4.1+7`** before merging to `main` (auto version-bump sets **`0.4.4+8`** on `main`). -- [ ] After merge, confirm GitHub Action **Auto Version Bump** committed **`0.4.4+…`** on `main`. -- [ ] **Tag** is placed on the **commit that includes all fixes** you want in binaries (a tag does not auto-include later commits; see [CONTRIBUTING.md](../CONTRIBUTING.md)). +- [ ] `pubspec.yaml` on the release branch is **`0.4.11+N`** (currently **`0.4.11+1`** on `dev` after #346). +- [ ] After merge to `main`, confirm any **Auto Version Bump** still yields a **0.4.11+…** product version (do not ship as 0.4.12). +- [ ] **Tag** `0.4.11` is placed on the **commit that includes all fixes** you want in binaries (a tag does not auto-include later commits; see [CONTRIBUTING.md](../CONTRIBUTING.md)). - [ ] Run the **Release** workflow from GitHub Actions (see [tags-and-releases.md](tags-and-releases.md)). - [ ] Verify **Linux** and **Windows** zip artifacts and `SHA256SUMS.txt` on the GitHub Release. ## Docs -- [ ] [CHANGELOG.md](../CHANGELOG.md) has a **`## [X.Y.Z]`** section for the release version (CI copies it into the GitHub Release body). +- [ ] [CHANGELOG.md](../CHANGELOG.md) has a dated **`## [0.4.11]`** section for the release (CI copies it into the GitHub Release body). - [ ] [security.md](security.md) still matches behavior if storage changed. -- [ ] [roadmap.md](roadmap.md) updated if you are communicating upcoming themes externally. +- [ ] [roadmap.md](roadmap.md) marks 0.4.7–0.4.10 shipped and 0.4.11 as the packaging/next release. diff --git a/docs/roadmap.md b/docs/roadmap.md index 419d5fff..bc99fd6b 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -2,6 +2,9 @@ Living document for planned work. Not a commitment order; adjust as priorities change. +**GitHub Latest Release:** [0.4.10](https://github.com/QueryaHub/Querya-Desktop/releases/tag/0.4.10) (2026-07-11). +**Next product release:** **0.4.11** — packaging on `dev` (`pubspec` `0.4.11+1`, draft [CHANGELOG](../CHANGELOG.md) `[0.4.11]`). Epic [#341](https://github.com/QueryaHub/Querya-Desktop/issues/341). + ## Theme system - **Shipped in 0.4.0 (epic #37):** runtime themes, VS Code `colors` + `tokenColors` import, SQL/JSON @@ -10,14 +13,20 @@ Living document for planned work. Not a commitment order; adjust as priorities c - **Shipped in 0.4.2 (TP-01–TP-30, #96–#125):** custom theme registry — `querya.theme.v1` + VS Code JSON/JSONC scan, Theme picker (50+), import/refresh, built-in Cyberpunk Neon asset, startup fallback, window chrome sync — [theme-custom-json.md](theme-custom-json.md), [theme-import.md](theme-import.md). - **Shipped in 0.4.3 (TP-F1–TP-F4, #159–#163):** theme folder watcher, marketplace metadata on manifests, visual theme editor with export, HTTPS remote install with checksum — [planned-0.4.3.md](planned-0.4.3.md). - **Shipped in 0.4.4:** UI motion polish + high refresh rate (90/120/144 Hz), memory and security fixes — [planned-0.4.4.md](planned-0.4.4.md), [motion-and-high-refresh.md](motion-and-high-refresh.md), epic [#170](https://github.com/QueryaHub/Querya-Desktop/issues/170), milestone [0.4.4](https://github.com/QueryaHub/Querya-Desktop/milestone/3). -- **Shipped in 0.4.6:** SQLite Database Connector — [planned-0.4.6.md](planned-0.4.6.md), milestone [0.4.6](https://github.com/QueryaHub/Querya-Desktop/milestones). -- **Planned 0.4.7:** Local Extension Discovery — `ExtensionManifest`, сканирование локальных папок и миграция тем на формат расширений ([planned-0.4.7.md](planned-0.4.7.md)). -- **Shipped in 0.4.10:** Sandboxed extension runtime (Block E), Plugin RPC bridge (Block C), SDUI form/tree builders, local `.zip`/`.qext` install, and Registration/Activation for external database drivers (e.g. ClickHouse) — see [CHANGELOG.md](../CHANGELOG.md). -- **Planned 0.5.0:** Marketplace Launch — Запуск Маркетплейса (клиентская часть). Скачивание, валидация `sha256` и установка тем из сети. База под другие расширения (ДБ драйверы) полностью готова! -- **Optional:** Preferences → **Animate theme changes** (off by default). +- **Optional:** Preferences → **Animate theme changes** (off by default; rebuild cost documented in [motion-and-high-refresh.md](motion-and-high-refresh.md) § Theme morph). - **Later:** P2 Mongo/Redis token colors; `re_editor` if perf gap; LSP epic per [archive/code-forge-evaluation.md](archive/code-forge-evaluation.md) (**NO-GO** on `code_forge` for 0.3). +## Desktop releases (0.4.6+) + +- **Shipped in 0.4.6:** SQLite Database Connector — [planned-0.4.6.md](planned-0.4.6.md). +- **Shipped in 0.4.7:** Local Extension Discovery — `ExtensionManifest`, local folder scan, theme migration to extension format — [planned-0.4.7.md](planned-0.4.7.md). +- **Shipped in 0.4.8:** Extension Manager UI (+ mock Marketplace) — [planned-0.4.8.md](planned-0.4.8.md). +- **Shipped in 0.4.9:** PostgreSQL SSL & connection reliability — see [CHANGELOG.md](../CHANGELOG.md). +- **Shipped in 0.4.10 (Latest):** Sandboxed extension runtime (Block E), Plugin RPC bridge (Block C), SDUI form/tree builders, local `.zip`/`.qext` install, Registration/Activation for external database drivers (e.g. ClickHouse), in-app updater — see [CHANGELOG.md](../CHANGELOG.md). +- **In packaging — 0.4.11:** Universal UI / SDUI RPC expand, ExtensionTableView, universal export, MySQL/SQLite parity, shell UX (#339), Fluid QueryaMotion (#342) + perf follow-ups (#356), grid/pool/timeout fixes — draft notes in [CHANGELOG.md](../CHANGELOG.md) `[0.4.11]`. Checklist: [release-checklist.md](release-checklist.md). Epic [#341](https://github.com/QueryaHub/Querya-Desktop/issues/341). +- **Planned 0.5.0:** Marketplace Launch — live download, `sha256` validation, install themes (and later DB drivers) from the network. + ## Query history and favorites - **Done:** `sql_query_history` in SQLite + record/list APIs; **History** in PostgreSQL / MySQL toolbars; **Preferences → Query history limit** ([`AppSettings.getSqlHistoryMaxEntries`](lib/core/storage/app_settings.dart)). @@ -26,7 +35,7 @@ Living document for planned work. Not a commitment order; adjust as priorities c ## Result export -- **Done (small steps):** CSV and JSON from the Data Output grid — copy to clipboard and **Save…** (system dialog): [`ResultsTab`](lib/features/main_screen/results_tab.dart), [`lib/core/csv/`](lib/core/csv/), [`lib/core/json/`](lib/core/json/). +- **Done:** CSV, JSON, Markdown, and SQL dump from ResultsTab / table toolbars (0.4.11 candidate, #326) — [`ResultsTab`](lib/features/main_screen/results_tab.dart), [`lib/shared/services/data_export_service.dart`](lib/shared/services/data_export_service.dart). - **Later:** alignment with `AppSettings` max rows for very large grids (warn or truncate before export). ## SSH and advanced networking