Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 4 additions & 3 deletions docs/planned-0.4.4.md
Original file line number Diff line number Diff line change
@@ -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.

Expand Down
2 changes: 2 additions & 0 deletions docs/planned-0.4.7.md
Original file line number Diff line number Diff line change
@@ -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 |
Expand Down
2 changes: 2 additions & 0 deletions docs/planned-0.4.8.md
Original file line number Diff line number Diff line change
@@ -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 |
Expand Down
36 changes: 25 additions & 11 deletions docs/release-checklist.md
Original file line number Diff line number Diff line change
@@ -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).
Expand Down Expand Up @@ -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

Expand All @@ -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.
21 changes: 15 additions & 6 deletions docs/roadmap.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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)).
Expand All @@ -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
Expand Down
Loading