From d771fb7bd8f773f37d471df4c39c8f58f2983eca Mon Sep 17 00:00:00 2001 From: Ngo Quoc Dat Date: Sat, 14 Nov 2026 20:07:24 +0700 Subject: [PATCH 1/2] docs(roadmap): reconcile the roadmap and the Linux features list with main --- ROADMAP.md | 102 +++++++++++++++++++++-------------------- linux/docs/features.md | 63 +++++++++++++++++-------- 2 files changed, 97 insertions(+), 68 deletions(-) diff --git a/ROADMAP.md b/ROADMAP.md index 55a4831458..c7467839e4 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -2,7 +2,7 @@ The work that makes the Linux and Windows apps complete daily-use clients, the core work under them, and the sync service and features every platform still lacks. The bar is the macOS app plus what the market expects from a daily-use client. -Written 2026-11-11 against main `8581bd6c7`, from code inventories of the macOS, Linux and Windows apps and the Rust core, and a survey of 20 other clients ([Sources](#sources)). The maintainer's answers of 2026-11-13 are under [Decisions](#decisions). What the Linux app does today is in [linux/docs/features.md](linux/docs/features.md). +Written 2026-11-11 against main `8581bd6c7`, from code inventories of the macOS, Linux and Windows apps and the Rust core, and a survey of 20 other clients ([Sources](#sources)). Reconciled on 2026-11-14 against main `8758a2b56`. The maintainer's answers of 2026-11-13 are under [Decisions](#decisions). What the Linux app does today is in [linux/docs/features.md](linux/docs/features.md). ## How to track @@ -29,26 +29,26 @@ awk '/^## /{p=$0} /^ *- \[[ x]\]/{t[p]++} /^ *- \[x\]/{d[p]++} END{for(k in t) p | Section | Boxes | Done | |---|---|---| -| Phase 0: Release blockers | 16 | 0 | -| Phase 1: Core enablers | 23 | 0 | -| Phase 2: Windows daily use | 62 | 0 | -| Phase 3: Standard features both apps lack | 116 | 0 | -| Phase 4: Advanced tier | 60 | 0 | +| Phase 0: Release blockers | 16 | 2 | +| Phase 1: Core enablers | 23 | 2 | +| Phase 2: Windows daily use | 62 | 2 | +| Phase 3: Standard features both apps lack | 118 | 0 | +| Phase 4: Advanced tier | 57 | 0 | | Phase 5: Engines | 27 | 0 | | Phase 6: Quality bars | 8 | 0 | | Phase 7: Sync and teams | 15 | 0 | | Phase 8: Beyond the market | 40 | 0 | -| Total | 367 | 0 | +| Total | 366 | 6 | ## Where each app stands **macOS**, the reference: 48 engine types (5 bundled driver plugins, 31 in the registry), and every survey tier up to ADV. Compare & Sync, Server Dashboard, Table Health, Query Insights, Data Rewind, EXPLAIN diagrams, charts, map mode, routine debugger, users and roles, backup and restore, an agent-mode AI with 15 providers, an MCP server with 47 tools, iCloud sync and Team features. -**Linux**, 0.1.0-beta.3: 9 engines from the core. Covers most of the CORE tier: connections with SSH, TLS and sockets, filters, editing with undo, completion, formatter, snippets, Vim, history, saved queries, structure editing, ER diagram, 7 export formats, dump and SQL import, AI chat, MCP with 11 tools, a CLI. Missing: all of admin and monitoring, query parameters, drawn plans, charts, schema compare, data transfer, backup through native tools, SOCKS, cloud IAM, users and roles, view and routine editing, the 10 paid features. 0.1.0 waits on [release criteria](linux/docs/releasing.md#release-criteria) 8 and 10. +**Linux**, 0.1.0-beta.3: 9 engines from the core. Covers most of the CORE tier: connections with SSH, TLS and sockets, filters, editing with undo, completion, formatter, snippets, Vim, history, saved queries, structure editing, ER diagram, 7 export formats, dump and SQL import, AI chat, MCP with 11 tools and client setup, a CLI, share links. Missing: all of admin and monitoring, query parameters, drawn plans, charts, schema compare, data transfer, backup through native tools, SOCKS, cloud IAM, users and roles, view and routine editing, the 10 paid features. 0.1.0 waits on [release criteria](linux/docs/releasing.md#release-criteria) 8 and 10. -**Windows**, unreleased: 9 engines through the FFI. Has the connection library (groups, tags, favourites), in-process SSH, TLS with remedies, paging and sort, table-row editing with SQL review, a Direct2D editor with highlighting and multiple cursors, run statement, selection or script with transactions, Safe Mode (3 levels), tab tear-out, session restore, an MSIX build. Missing most of the CORE tier past that: filters, value viewers, row details, FK navigation, copy formats, completion, formatter, history, saved queries, .sql files, export, import, structure, sidebar actions, undo of edits. +**Windows**, unreleased: 9 engines through the FFI. Has the connection library (groups, tags, favourites), in-process SSH, TLS with remedies, paging, sort and filters, a row estimate before an optional count, table-row editing with SQL review, read-only structure and routine, trigger and sequence definitions, export to 7 formats, query history with search, a Direct2D editor with highlighting and multiple cursors, run statement, selection or script with transactions, Safe Mode (3 levels), tab tear-out, session restore, account sign-in, share links, and an MSIX build whose release dry run passes. Missing most of the CORE tier past that: value viewers, row details, FK navigation, copy formats, completion, formatter, saved queries, .sql files, import, structure editing, a database switcher, Truncate and Drop in the sidebar, undo of edits. -**Core**: the logic mostly exists, the FFI does not. `ddl`, `export`, `import`, `dump`, `filter`, history, saved queries, `ai`, `mcp`, `cli`, `account` and `foreign-import` are core code the FFI does not expose. The formatter, completion scope, script runner, key-based change tracker, copy renderer, highlight rules, Open Quickly and ER layout sit in `linux/crates/app`, GTK-free. Phase 1 moves both down so Windows builds on the code Linux already runs. +**Core**: the FFI exposes filters, table structure and object definitions, export, query history, the account and share links. `ddl` drafts and plans, `import`, `dump`, saved queries, `ai`, `mcp`, `cli` and `foreign-import` are core code the FFI does not expose yet. The formatter, completion scope, script runner, key-based change tracker, copy renderer, highlight rules, Open Quickly and ER layout sit in `linux/crates/app`, GTK-free. Phase 1 moves both down so Windows builds on the code Linux already runs. ## What the market expects @@ -70,11 +70,11 @@ awk '/^## /{p=$0} /^ *- \[[ x]\]/{t[p]++} /^ *- \[x\]/{d[p]++} END{for(k in t) p ### Windows first public release -- [ ] **R-01** RUSTSEC-2026-0459 (bundled SQLite before 3.54.0): `deny.toml` blocks a Windows release until sqlx allows libsqlite3-sys 0.39 and the pin is raised +- [ ] **R-01** RUSTSEC-2026-0459 (bundled SQLite before 3.54.0): `deny.toml` blocks a Windows release until sqlx allows libsqlite3-sys 0.39 and the pin is raised (#4166) - [ ] **R-02** Maintainer setup, `windows/RELEASING.md` steps 1-6: tag rulesets, Artifact Signing with a Public Trust profile, the OIDC app registration, the `windows-release` secrets, `WINDOWS_SIGNING_*` and `WINDOWS_PUBLISHER` (permanent after the first release), the `windows-winget` environment -- [ ] **R-03** Dry run of `release-windows.yml` from main: the x64 package, the bundle, install-and-start tests and winget validation, all unverified (ADR 0005) +- [x] **R-03** Dry run of `release-windows.yml` from main: the x64 and Arm64 packages, the bundle, install-and-start tests and winget validation, unsigned (ADR 0005): [run 43164825446](https://github.com/TableProApp/TablePro/actions/runs/43164825446) - [ ] **R-04** Real hardware: Windows 10 build 17763, Native AOT, Mica on a GPU, TabView in the title bar on Windows 10, loading from a signed MSIX (ADR 0001, 0004) -- [ ] **R-05** Drop the Windows App SDK metapackage once Community Toolkit 8.3 is stable (41.8 MB of unused ONNX and DirectML per architecture) +- [x] **R-05** Drop the Windows App SDK metapackage (41.8 MB of unused ONNX and DirectML per architecture): the app takes the WinUI component and prunes the metapackage the Community Toolkit names (ADR 0005): #4232 - [ ] **R-06** Updates: an App Installer file or the Store, an in-app update check, stable and beta channels - [ ] **R-07** Live-server Windows tests for the 7 engines no Windows suite connects to: MySQL, SQL Server, DuckDB, ClickHouse, Cassandra, MongoDB, Redis - [ ] **R-08** Windows user guide on docs.tablepro.app and the download page @@ -86,20 +86,20 @@ awk '/^## /{p=$0} /^ *- \[[ x]\]/{t[p]++} /^ *- \[x\]/{d[p]++} END{for(k in t) p - [ ] **R-11** Release criterion 10: a dated week of daily use - [ ] **R-12** Bring [linux/docs/features.md](linux/docs/features.md) up to date: about 40 features from #4108 to #4159, #4145 and #4147 are missing, and the Saved queries, Sidebar, Preferences, Connections import, MCP Tools and Copy rows are stale - [ ] **R-13** The display-scale pass on a real GPU and a HiDPI screen, and a hand install on Ubuntu 26.04 -- [ ] **R-14** #4099 (KDE Wallet prompt opens behind the window) and #4101 (`flatpak list` shows "Usage data") -- [ ] **R-15** After 0.1.0: the Flathub manifest and exception request, by the maintainer, under [Flathub's requirements](linux/docs/decisions/0041-beta-repositories-and-release-packages.md#context) -- [ ] **R-16** After 0.1.0: an AUR PKGBUILD, kept by the community +- [ ] **R-14** Not a 0.1.0 blocker: #4099 (KDE Wallet prompt opens behind the window) and #4101 (`flatpak list` shows "Usage data") are fixed upstream in [xdg-desktop-portal#2203](https://github.com/flatpak/xdg-desktop-portal/pull/2203) and [flatpak#6965](https://github.com/flatpak/flatpak/pull/6965), in no release yet, and are known issues in 0.1.0's notes. Once an xdg-desktop-portal release has #2203, pass `parent_window` and `activation_token` to RetrieveSecret; ksecretd's side is [KDE bug 528518](https://bugs.kde.org/show_bug.cgi?id=528518) +- [ ] **R-15** After 0.1.0: the Flathub manifest and exception request, by the maintainer, under [Flathub's requirements](linux/docs/decisions/0041-beta-repositories-and-release-packages.md#context) (#3640) +- [ ] **R-16** After 0.1.0: an AUR PKGBUILD, kept by the community (#3639) ## Phase 1: Core enablers Each item ends in an FFI surface Windows needs. Linux paths are under `linux/crates/app/src/`. -- [ ] **C-01** Filters through the FFI: `table_query` takes a `FilterSet` (always `FilterSet::default()` in `core/crates/ffi/src/session.rs` today) and `operators_for` -- [ ] **C-02** Export through the FFI: `core::export` encoders (CSV, TSV, JSON, JSON Lines, HTML, Markdown, SQL INSERT, XML, XLSX) as a streaming job with progress and Stop; the sinks and ledger in `ui/export/` move down +- [x] **C-01** Filters through the FFI: table pages and counts take a filter, and `filter_choices` gives each column's operators: #4213 +- [ ] **C-02** Export through the FFI: `core::export` encoders (CSV, TSV, JSON, JSON Lines, HTML, Markdown, SQL INSERT, XML, XLSX) as a streaming job with progress and Stop; the sinks and ledger in `ui/export/` move down · partly #4213: TSV, JSON Lines, CSV options, progress and the move of the sinks and ledger are left - [ ] **C-03** CSV import and pasted rows through the FFI: `core::import::{csv_import, plan_import, PastedRows}` - [ ] **C-04** SQL dump and SQL file import through the FFI: `core::dump`, `SqlFileReader`, with the orchestration in `ui/export/dump_job.rs` and `services/import_file.rs` moved down -- [ ] **C-05** Structure through the FFI: the table definition (columns, indexes, keys, comments), CREATE statements, `core::ddl` drafts, `diff_table`, plans and catalog operations (core ADR 0013); the logic in `services/pending_structure.rs` moves down -- [ ] **C-06** Storage through the FFI: `QueryHistory` (FTS5, retention, export), `SavedQueries` with folders and keywords, `Favourites`, `DraftStore` (deferred by core ADR 0017) +- [ ] **C-05** Structure through the FFI: the table definition (columns, indexes, keys, comments), CREATE statements, `core::ddl` drafts, `diff_table`, plans and catalog operations (core ADR 0013); the logic in `services/pending_structure.rs` moves down · partly #4213: `core::ddl` drafts, `diff_table`, plans, catalog operations and the move of `services/pending_structure.rs` are left +- [ ] **C-06** Storage through the FFI: `QueryHistory` (FTS5, retention, export), `SavedQueries` with folders and keywords, `Favourites`, `DraftStore` (deferred by core ADR 0017) · partly #4213: history pins, retention and export, `SavedQueries`, `Favourites` and `DraftStore` are left - [ ] **C-07** SQL formatter into core: `ui/editor/format_plan.rs` and `significant_tokens.rs` - [ ] **C-08** Completion context into core: `completion/completion_scope.rs`, `catalog_read.rs` and the fuzzy ranking; proposal objects stay per app - [ ] **C-09** Script runner into core: `script_runner.rs` and `run_log.rs` with `BatchErrorPolicy` (the FFI's `QueryEditor::run` takes one statement or one `GO` batch) @@ -112,7 +112,7 @@ Each item ends in an FFI surface Windows needs. Linux paths are under `linux/cra - [ ] **C-16** Foreign import through the FFI: a Windows `ForeignHost` and `ForeignAppDirs`, passwords into Credential Manager, DPAPI-held passwords read (core ADR 0008) - [ ] **C-17** AI through the FFI: providers, prompts, schema context, streamed replies - [ ] **C-18** MCP server through the FFI, with a Windows host -- [ ] **C-19** Account through the FFI: the Windows `AppClient` once registered with tablepro-cloud, and the entitlement gate that every paid feature on Windows needs (core ADR 0016, D-02) +- [x] **C-19** Account through the FFI: the Windows `AppClient`, registered with tablepro-cloud, and the entitlement gate that every paid feature on Windows needs (core ADR 0016 and 0026, D-02): #4253 - [ ] **C-20** CLI on Windows: a `Host`, MCP dispatch, peer verification on the pipe, PowerShell completion (core ADR 0018) - [ ] **C-21** Query-result editing through the FFI (core ADR 0015, after ADR 0019) - [ ] **C-22** Connection library through the FFI: export to JSON, duplicate with secrets @@ -135,23 +135,23 @@ The first public Windows release waits for every CORE item here and the Windows ### Sidebar -- [ ] **W-09** Object context menu: Open, Open in New Tab, Copy Name, Show CREATE, Truncate, Drop, through Safe Mode · CORE · needs C-05 +- [ ] **W-09** Object context menu: Open, Open in New Tab, Copy Name, Show CREATE, Truncate, Drop, through Safe Mode · CORE · needs C-05 · partly #4213: Open in New Tab, Show CREATE for a table, Truncate and Drop are left - [ ] **W-10** Create and drop databases and schemas · CORE · needs C-05 - [ ] **W-11** Database switcher per connection and per query tab · CORE -- [ ] **W-12** Open a routine, trigger or sequence: its definition read-only, with Copy and Open in Editor · STD +- [x] **W-12** Open a routine, trigger or sequence: its definition read-only, with Copy and Open in Editor · STD: #4213 - [ ] **W-13** Columns, indexes and keys under a table node · STD · needs C-05 - [ ] **W-14** Table info: rows, size, comment · STD ### Grid -- [ ] **W-15** Filters: per-column operators, raw WHERE, match any or all, kept per table · CORE · needs C-01 +- [ ] **W-15** Filters: per-column operators, raw WHERE, match any or all, kept per table · CORE · needs C-01 · partly #4213: the filter is kept with its tab; keeping it for the table when it opens again is left - [ ] **W-16** Filter by a cell's value, or exclude it · CORE · needs C-01 - [ ] **W-17** Value viewers for long text, JSON, binary (hex) and images; a tooltip on a cut cell · CORE - [ ] **W-18** Row details pane with editing · STD - [ ] **W-19** Follow a foreign key to the referenced row, and show referencing rows · CORE - [ ] **W-20** Copy as CSV or TSV with headers, JSON, Markdown, INSERT, IN clause · CORE · needs C-11 - [ ] **W-21** Reorder, hide and freeze columns, kept per table (the control has frozen columns) · STD -- [ ] **W-22** Context menu on query-result grids · CORE +- [ ] **W-22** Context menu on query-result grids · CORE · partly #4253: the menu has Copy and Share Result; Copy As, filter by value and Export in it are left - [ ] **W-23** Selection summary: count, sum, average, min, max · STD - [ ] **W-24** Find in the grid · STD · needs C-12 - [ ] **W-25** Grid display settings: NULL text, date format, grid font, row height, stripes · STD · needs C-11 @@ -161,16 +161,16 @@ The first public Windows release waits for every CORE item here and the Windows - [ ] **W-27** Undo and redo of pending edits · CORE · needs C-10 - [ ] **W-28** Paste rows from the clipboard · STD · needs C-03, C-10 -- [ ] **W-29** Edit query results that read one keyed table · STD · needs C-21 +- [ ] **W-29** Edit query results that read one keyed table · STD · needs C-21 (#4275) - [ ] **W-30** Type editors: date and time picker, enum menu, JSON check, boolean toggle · STD ### SQL editor -- [ ] **W-31** Completion: tables, columns, aliases, schemas, functions, keywords · CORE · needs C-08 +- [ ] **W-31** Completion: tables, columns, aliases, schemas, functions, keywords · CORE · needs C-08 (#4275) - [ ] **W-32** Formatter · CORE · needs C-07 - [ ] **W-33** Replace, and regular expressions in Find · CORE - [ ] **W-34** Open and save .sql files, drop a file on the editor, recent files · CORE -- [ ] **W-35** Query history with search, pins and retention · CORE · needs C-06 +- [ ] **W-35** Query history with search, pins and retention · CORE · needs C-06 · partly #4213: pins and retention are left - [ ] **W-36** Saved queries in folders · CORE · needs C-06 - [ ] **W-37** Snippets with tab stops · STD · needs C-15 - [ ] **W-38** Run a whole script with an error policy, one entry per result · CORE · needs C-09 @@ -180,13 +180,13 @@ The first public Windows release waits for every CORE item here and the Windows ### Structure -- [ ] **W-42** Structure view: columns, indexes, foreign keys, comments, the CREATE statement · CORE · needs C-05 +- [x] **W-42** Structure view: columns, indexes, foreign keys, comments, the CREATE statement · CORE · needs C-05: #4213 - [ ] **W-43** Table designer: create and alter columns, indexes and foreign keys, with the SQL reviewed · CORE · needs C-05 - [ ] **W-44** ER diagram · STD · needs C-14 ### Import and export -- [ ] **W-45** Export a table or a result to CSV, JSON, XLSX, SQL INSERT, Markdown, HTML and XML, with progress and Stop · CORE · needs C-02 +- [ ] **W-45** Export a table or a result to CSV, JSON, XLSX, SQL INSERT, Markdown, HTML and XML, with progress and Stop · CORE · needs C-02 · partly #4213: SQL INSERT from a query result, and the rows written so far shown while it runs, are left - [ ] **W-46** CSV import into a table with a column mapping · CORE · needs C-03 - [ ] **W-47** Import SQL File and Export Database · CORE · needs C-04 @@ -209,10 +209,10 @@ The first public Windows release waits for every CORE item here and the Windows - [ ] **W-57** AI assistant: providers, chat with schema context, Explain, Review, Optimize, Fix, AI policy per connection · STD · needs C-17 - [ ] **W-58** MCP server with an External Clients level per connection · ADV · needs C-18 -- [ ] **W-59** Account page, license ask, and the paid-feature gate on the macOS license (D-02) · STD · needs C-19 -- [ ] **W-60** `tablepro://` and database URL links · STD +- [ ] **W-59** Account page, license ask, and the paid-feature gate on the macOS license (D-02) · STD · needs C-19 · partly #4253: the license ask and the gate on paid features are left +- [ ] **W-60** `tablepro://` and database URL links · STD · partly #4253: connection links and database URLs are left - [ ] **W-61** File associations for .sql, SQLite and DuckDB files · STD -- [ ] **W-62** Launch arguments and the `tablepro` CLI (the execution alias ignores arguments today) · STD · needs C-20 +- [ ] **W-62** Launch arguments and the `tablepro` CLI (the execution alias reads only a share link today) · STD · needs C-20 ## Phase 3: Standard features both apps lack @@ -287,14 +287,14 @@ The Windows box assumes its Phase 2 base. Linux-only items have no Windows box. - [ ] core: parameter scan in `sql_syntax`, binding per driver - [ ] Linux - [ ] Windows -- **S-17** EXPLAIN as a tree and a diagram, with EXPLAIN ANALYZE where the engine has it · STD · macOS: yes +- **S-17** EXPLAIN as a tree and a diagram, with EXPLAIN ANALYZE where the engine has it · STD · macOS: yes (#3655) - [ ] core: a plan model parsed per engine - [ ] Linux - [ ] Windows - **S-18** Result tabs: keep earlier results, pin one, compare two · STD · macOS: yes - [ ] Linux - [ ] Windows -- **S-19** Split editor or tab groups · STD · macOS: no +- **S-19** Split editor or tab groups · STD · macOS: no (#4276) - [ ] Linux - [ ] Windows - **S-20** Inline diagnostics: syntax errors, unknown tables and columns · ADV · macOS: partly @@ -360,7 +360,7 @@ The Windows box assumes its Phase 2 base. Linux-only items have no Windows box. - [ ] core - [ ] Linux - [ ] Windows -- **S-35** Backup and restore through the engines' tools (pg_dump and pg_restore, mysqldump, mongodump). Flatpak needs `flatpak-spawn --host` or bundled tools; MSIX needs them on PATH · STD · macOS: yes +- **S-35** Backup and restore through the engines' tools (pg_dump and pg_restore, mysqldump, mongodump). Flatpak needs `flatpak-spawn --host` or bundled tools; MSIX needs them on PATH · STD · macOS: yes (#3654) - [ ] core - [ ] Linux - [ ] Windows @@ -404,16 +404,19 @@ The Windows box assumes its Phase 2 base. Linux-only items have no Windows box. - [ ] Windows - **S-44** GNOME Shell search provider for connections · STD - [ ] Linux +- **S-45** Every database on the server in the sidebar for PostgreSQL and SQL Server: the connection's own expanded and marked active, others opened on expand, system and template databases hidden behind a filter · STD · macOS: yes (#4261) + - [ ] Linux + - [ ] Windows ## Phase 4: Advanced tier -macOS has every item here, most as paid features, and the same license gates them on Linux and Windows (D-02). Linux and Windows have none; Linux's account page lists all 10 paid features as absent. +macOS has every item here, most as paid features, and the same license gates them on Linux and Windows (D-02). Linux and Windows have none of them whole; #4211 brought MCP client setup (A-09). A-12 is not taken on Linux and Windows (D-08). Linux's account page lists all 10 paid features as absent. -- **A-01** Compare & Sync: schema diff and row diff between connections, a sync script, saved comparisons · paid +- **A-01** Compare & Sync: schema diff and row diff between connections, a sync script, saved comparisons · paid (#3656) - [ ] core - [ ] Linux - [ ] Windows -- **A-02** Server Dashboard: sessions, metrics, slow queries, locks and blocking chains, replication status, saved-query tiles +- **A-02** Server Dashboard: sessions, metrics, slow queries, locks and blocking chains, replication status, saved-query tiles (#3657) - [ ] core - [ ] Linux - [ ] Windows @@ -442,8 +445,8 @@ macOS has every item here, most as paid features, and the same license gates the - [ ] Linux - [ ] Windows - **A-09** MCP server parity: 47 tools, resources, prompts, subscriptions, scoped tokens, pairing, an activity log, client setup snippets (Linux has 11 tools and one token) - - [ ] core - - [ ] Linux + - [ ] core · partly #4211: everything but the client setup catalog is left + - [ ] Linux · partly #4211: everything but client setup is left - [ ] Windows - **A-10** Linked SQL folders with Git status, commit, pull and push · paid - [ ] core @@ -453,10 +456,7 @@ macOS has every item here, most as paid features, and the same license gates the - [ ] core - [ ] Linux - [ ] Windows -- **A-12** Masking rules across the grid, copies, exports, AI and MCP - - [ ] core - - [ ] Linux - - [ ] Windows +- **A-12** Not taken on Linux and Windows (D-08): masking rules across the grid, copies, exports, AI and MCP. Masking there is in share links only (#4253) - **A-13** Generate test rows: up to 1M, foreign-key aware, seeded - [ ] core - [ ] Linux @@ -586,17 +586,17 @@ A TablePro sync service on every platform (D-01). macOS keeps iCloud beside it, Survey features no client covers on every platform, and the macOS app lacks them too, so each has a macOS box. All but G-06 and G-12 were taken (D-05). -- **G-01** SQL notebooks: SQL and Markdown cells with results (only VS Code mssql since Azure Data Studio retired) +- **G-01** SQL notebooks: SQL and Markdown cells with results (only VS Code mssql since Azure Data Studio retired) (#3618) - [ ] core - [ ] Linux - [ ] Windows - [ ] macOS -- **G-02** Scheduled jobs: export, backup or run SQL on a schedule, with a notification (Navicat, DBeaver PRO, TablePlus 27.2) +- **G-02** Scheduled jobs: export, backup or run SQL on a schedule, with a notification (Navicat, DBeaver PRO, TablePlus 27.2) (#3621) - [ ] core - [ ] Linux - [ ] Windows - [ ] macOS -- **G-03** Go to definition, find usages and rename in SQL (DataGrip, Navicat 18, dbForge) +- **G-03** Go to definition, find usages and rename in SQL (DataGrip, Navicat 18, dbForge) (#4276) - [ ] core - [ ] Linux - [ ] Windows @@ -612,7 +612,7 @@ Survey features no client covers on every platform, and the macOS app lacks them - [ ] Windows - [ ] macOS - **G-06** Not taken (D-05): a visual MongoDB aggregation pipeline builder (Navicat) -- **G-07** Column profiling: nulls, distinct values, distribution (Navicat 17) +- **G-07** Column profiling: nulls, distinct values, distribution (Navicat 17) (#4276) - [ ] core - [ ] Linux - [ ] Windows @@ -641,7 +641,7 @@ Survey features no client covers on every platform, and the macOS app lacks them ## Decisions -Answered by the maintainer on 2026-11-13. +Answered by the maintainer on 2026-11-13, D-08 on 2026-11-14. | ID | Question | Decision | |---|---|---| @@ -652,6 +652,7 @@ Answered by the maintainer on 2026-11-13. | D-05 | Which survey gaps to take | All but G-06 and G-12 ([Phase 8](#phase-8-beyond-the-market)) | | D-06 | Which comes first | Linux 0.1.0, then Phase 1 and Windows ([Order](#order)) | | D-07 | An Android app | Not now | +| D-08 | Masking on Linux and Windows | In share links only: no rules per connection, and no masking in the grid, exports, MCP or the assistant ([core ADR 0028](core/docs/decisions/0028-data-masking.md)) | ## Out of scope @@ -661,6 +662,7 @@ Answered by the maintainer on 2026-11-13. - KDE-native styling: the Linux app runs with the Adwaita style everywhere - An Android app, for now (D-07) - G-06 and G-12 (D-05) +- A-12 on Linux and Windows (D-08) ## Sources diff --git a/linux/docs/features.md b/linux/docs/features.md index aeae818bd0..1318dc988b 100644 --- a/linux/docs/features.md +++ b/linux/docs/features.md @@ -1,6 +1,6 @@ # Features -What the Linux app does, recorded on 2026-11-08. [0.1.0-beta.3](https://github.com/TableProApp/TablePro/releases/tag/linux-v0.1.0-beta.3) is published on GitHub Releases, the beta PPA, the beta COPR project and the beta Flatpak repository ([README](../README.md#betas)). beta.2 was tagged but never published: [release run 42382067978](https://github.com/TableProApp/TablePro/actions/runs/42382067978) failed before publishing, and [#4093](https://github.com/TableProApp/TablePro/pull/4093) fixed the failure for beta.3. +What the Linux app does, checked against main `8758a2b56` on 2026-11-14. [0.1.0-beta.3](https://github.com/TableProApp/TablePro/releases/tag/linux-v0.1.0-beta.3) is published on GitHub Releases, the beta PPA, the beta COPR project and the beta Flatpak repository ([README](../README.md#betas)). beta.2 was tagged but never published: [release run 42382067978](https://github.com/TableProApp/TablePro/actions/runs/42382067978) failed before publishing, and [#4093](https://github.com/TableProApp/TablePro/pull/4093) fixed the failure for beta.3. The work left and its order are in the repository's [ROADMAP.md](../../ROADMAP.md), and what 0.1.0 needs in the [release criteria](releasing.md#release-criteria). @@ -16,11 +16,13 @@ The app runs on GNOME 50 ([ADR 0015](decisions/0015-gnome-50-platform-floor.md)) | Tags and icons | Several named tags per connection, each with a colour, from the row's menu or the connect dialog, shown after the name and read with the row's description; Manage Tags renames, recolours and deletes them. An icon from a fixed set shows in the row and beside the window title | | Search | The connection list's search (Ctrl+F, or start typing) matches the name, host, database, user, driver, the names on the group's path and tag names | | Import and export | A JSON file with no secrets in it, tags and icons included. On import, an entry with the same id and the same settings updates its name, colour, group, tags and icon; any other is added as a new connection. Tags are matched by id, then by name, so a second import adds none | +| Import from another app | Import from Another App in the main menu reads the connections of TablePlus, DBeaver, DataGrip, Beekeeper Studio and DBX found on this computer, or a Navicat `.ncx` export, and reviews each against the saved ones: Add, Add as Copy, Replace, or Keep Existing and add its queries. Passwords come along where the app keeps them in its own files, or in DataGrip's password file; one in the system keyring is entered at connect. DBeaver and DBX scripts and DataGrip consoles come along as saved queries; TablePlus and Beekeeper Studio keep theirs apart from any connection, so they are not imported | | Connection URLs | A URL pasted at the top of a new connection fills the form: the engine, host, port, user, database and TLS mode, the authentication database, a DNS seed list and a replica set's hosts, and the password, kept in the Secret Service with Remember Password on. libpq, MySQL, MongoDB, Redis and Valkey, ClickHouse and Cassandra URLs, SQL Server's JDBC form and SQLite and DuckDB file URLs are read ([core `connection_url`](../../core/crates/core/src/connection_url/mod.rs)) | +| Database links | The desktop file registers the PostgreSQL, MySQL, MariaDB, SQL Server, ClickHouse, Cassandra, ScyllaDB, Redis, Valkey, MongoDB, SQLite and DuckDB URL schemes. A link for a saved connection asks before opening it; any other fills the connect dialog and waits for Connect, and the connection is saved once it connects ([man page](../data/tablepro.1)) | | Unix sockets | PostgreSQL, MySQL and MariaDB on this computer through the server's socket, for peer, `auth_socket` and `unix_socket` logins: a folder for PostgreSQL, the socket file for MySQL, found in the distribution's usual place. The Flatpak sees the sockets under `/run/postgresql` and `/run/mysqld` ([ADR 0035](decisions/0035-flatpak-local-database-sockets.md)) | | Test before saving | Test connects once and reports, then disconnects | | Passwords | Kept in the Secret Service; a prompt asks when one is missing or refused, with Remember Password | -| Safe Mode | A level per connection, set in the connect dialog or the main menu while connected and saved back to the connection. Off asks before DROP, TRUNCATE, and DELETE or UPDATE without WHERE. Confirm Writes also asks before every other write from the editor, a grid save, a structure save, a CSV import, a SQL file import, or a drop, truncate or create from the sidebar, showing the SQL, or the file, and the connection, with Cancel the default. Read-Only refuses every editor statement that does not read, and opens the connection read-only: SQLite, DuckDB and ClickHouse refuse writes at the engine, PostgreSQL and MySQL run in read-only transactions, SQL Server relies on the login, with the app's own reads in a rolled-back transaction, and Cassandra and ScyllaDB rely on the login. A statement is a read only when its engine's grammar shows it reads, each statement of a script on its own. Moving to or from Read-Only reconnects the window | +| Safe Mode | A level per connection, set in the connect dialog, or while connected from the header's Safe Mode button or the session menu, and saved back to the connection. Off asks before DROP, TRUNCATE, and DELETE or UPDATE without WHERE. Confirm Writes also asks before every other write from the editor, a grid save, a structure save, a CSV import, a SQL file import, or a drop, truncate or create from the sidebar, showing the SQL, or the file, and the connection, with Cancel the default. Read-Only refuses every editor statement that does not read, and opens the connection read-only: SQLite, DuckDB and ClickHouse refuse writes at the engine, PostgreSQL and MySQL run in read-only transactions, SQL Server relies on the login, with the app's own reads in a rolled-back transaction, and Cassandra and ScyllaDB rely on the login. A statement is a read only when its engine's grammar shows it reads, each statement of a script on its own. Moving to or from Read-Only reconnects the window | | Query timeout per connection | Custom Query Timeout in the connect dialog sets the editor's timeout for that connection in place of the one in Preferences, from the next connect; 0 turns it off. The app's own calls keep their fixed limits: 15 seconds for metadata, 60 for a page or a count, 120 for a row save or a CSV import, none for a schema change or an export, and on the server 60 for a table-tab statement and 10 for a lock wait | | Database files | SQLite and DuckDB: choose a file, create a new one, open one from Files or a terminal, where the file's header picks the engine, find a moved one with Locate, and choose read-only or read-write for one on a network or FUSE filesystem | | Kerberos for SQL Server | From the ticket cache, in the Flatpak through the KCM socket | @@ -48,19 +50,25 @@ The app runs on GNOME 50 ([ADR 0015](decisions/0015-gnome-50-platform-floor.md)) | Capability | Detail | |---|---| -| Data grid | A virtualized `GtkColumnView` with keyboard-focusable cells, pages of 100 to 10,000 rows, and a pager with an exact or estimated row count; a table of about 100,000 rows or fewer is counted on its own, a larger one offers Count Rows | -| Filters | Per-column operators, a raw WHERE fragment checked as one expression, match any or all; binary columns compare to `0x` hex. Kept per table, and per tab across a restart or a reopen. On Cassandra and ScyllaDB only the operators the server evaluates, matched all, with `ALLOW FILTERING` | -| Sorting | A header click sorts tables on the server and query results in the grid, one column at a time. A Cassandra or ScyllaDB table keeps the server's order, and pages by its paging state | +| Data grid | A virtualized `GtkColumnView` with keyboard-focusable cells, pages of 100 to 10,000 rows, and a pager with an exact or estimated row count and the time the page took; a table of about 100,000 rows or fewer is counted on its own, a larger one offers Count Rows. Row numbers stay in view when the columns scroll sideways | +| Filters | Per-column operators, a raw WHERE fragment checked as one expression, match any or all; binary columns compare to `0x` hex. Filter by Value and Exclude Value in a cell's menu add a rule. Kept per table, and per tab across a restart or a reopen. On Cassandra and ScyllaDB only the operators the server evaluates, matched all, with `ALLOW FILTERING` | +| Sorting | A header click sorts tables on the server and query results in the grid, one column at a time. Preferences can sort a table by its primary key or first column when it opens, ascending or descending. A Cassandra or ScyllaDB table keeps the server's order, and pages by its paging state | | Cell editing | Editors by column kind: inline text, a multi-line editor, a calendar for dates and, in Row Details, a clock for times, a toggle for booleans, JSON checked before saving; values are edited from their exact text, never from what the cell displays. Tables with a primary key, in a table tab or as a query result that reads one table with its whole key ([ADR 0036](decisions/0036-editing-query-results.md)); key, generated and auto-increment columns, and binary, spatial, array and composite values, are read-only | -| Rows | Insert, duplicate and delete; Paste (Ctrl+V) adds tab-separated rows from the clipboard, filling the columns from the focused one or by a header's names, or edits the focused cell with one value, and asks first above 1,000 rows, up to 100,000; Set NULL and Empty, and DEFAULT on a new row; undo and redo; save or discard pending changes, and stop a save. On ClickHouse, Cassandra and ScyllaDB a save is not atomic, and Stop takes effect between statements | +| Rows | Insert, duplicate and delete; Paste (Ctrl+V) adds tab-separated rows from the clipboard, filling the columns from the focused one or by a header's names, or edits the focused cell with one value, and asks first above 1,000 rows, up to 100,000; Set NULL, Empty, DEFAULT or a server expression on every selected row in one undo step; undo and redo; save or discard pending changes, and stop a save. On ClickHouse, Cassandra and ScyllaDB a save is not atomic, and Stop takes effect between statements | | Server-computed values | A date, time or timestamp cell takes the engine's own `NOW()`, `CURRENT_TIMESTAMP`, `CURRENT_DATE` and the like, typed in any letter case or picked from the cell menu, and a saved row's cell takes DEFAULT where the engine has `SET c = DEFAULT` (PostgreSQL, MySQL and MariaDB, SQL Server, DuckDB). Only each engine's own list is offered, which on DuckDB is `now()` alone, since the bundled build has no ICU extension; the save writes the expression into the statement, so the Confirm Writes review and the history show it as written | | Bulk delete | Deleting 10 rows or more asks first, unless Confirm Before Deleting Rows is off in Preferences | -| Copy | Copy; Copy As rows, with headers, CSV with or without headers, JSON, JSON Lines, Markdown, a text table, IN clause or one row of SQL values, and INSERT with or without generated keys in an editable table tab; Copy Column Name; Show Row as JSON | +| Copy | Copy; Copy As rows, with headers, CSV with or without headers, JSON, JSON Lines, Markdown, a text table, IN clause or one row of SQL values, and INSERT with or without generated keys in an editable table tab; Copy Column Name; Show Row as JSON. Preferences sets what Copy writes for several rows: TSV or CSV with or without headers, JSON or Markdown | | Foreign keys | Open Referenced Row (Ctrl+J) on a key cell opens the table it points at in a new tab, filtered on every column of the key; Show Referencing Rows on a saved row opens a table whose key points at it. A tab already showing those rows comes to the front | +| Table views | Data, Structure and JSON share a table tab and its bottom bar, and switching keeps each view's unsaved changes. JSON shows the rows on screen; Columns in the bottom bar opens the column chooser | +| Row Details | Each field is edited in its own row, with a button that copies its whole value and a menu that sets it to Empty, NULL or DEFAULT or copies it. Primary keys, foreign keys and unsaved edits are marked and read out to screen readers. Search names or values, or show edited fields only. Preferences can open it whenever a row is selected | +| Grid display | The grid draws in the editor scheme's colours. Preferences set a cell font, row numbers, row height, alternate rows, the text for NULL, and dates as ISO, US or EU, with or without the time. Zero-width, control and special space characters are marked in cells and value fields unless turned off | +| Find in results | Ctrl+F in a query result or a Redis key's values finds the cells whose text holds the search, ignoring case, and Ctrl+G and Shift+Ctrl+G step through them; in a table tab Ctrl+F opens the filter | +| Selection summary | A readout in the bottom bar for the focused column of the selected rows: the count, how many are numbers, empty or not numbers, and the sum, average, minimum and maximum, each with Copy | +| Highlight rules | Highlight Rules in the bottom bar colour the rows or cells that meet a condition, kept per table across restarts, for database files and other open databases too | | Column layout | Order, hidden columns and widths kept per table; a column added since goes last and a dropped one keeps its place. A header drag, or Move Column Left and Move Column Right in the cell menu (Alt+Left and Alt+Right), reorders them; Widen Column and Narrow Column (Shift+Alt+Right and Shift+Alt+Left) resize them; Reset Columns in the Columns dialog goes back to the table's own order | | CSV import | Into an existing table, with a column mapping, in one write batch (one transaction where the engine has them), up to 64 MiB | -| Sidebar | Tables (partitioned ones included), views, materialized views and foreign tables by schema, with search and Refresh, read again after the editor runs DDL, Open in New Tab and Show CREATE TABLE; Edit Structure, Import CSV, Truncate Table and Drop Table for tables, Delete All Documents for collections; New and Drop Schema, and New and Drop Database (Keyspace on Cassandra), on every engine that has them, never offered for a system object or the session's own database; empty schemas listed | -| Routines and triggers | Functions, procedures and sequences in the sidebar after each schema's tables, and triggers with the table each fires on, on every engine that has them. Opening one shows its definition read-only, with Copy and Open in Editor; every overload of a PostgreSQL function name is shown | +| Sidebar | Tables (partitioned ones included) by schema, with views, materialized views, foreign tables, sequences, procedures, functions and triggers each in a group above them; empty schemas listed. Search and Refresh sit in the sidebar's header, and the list is read again after the editor runs DDL. Open in New Tab and Show CREATE TABLE; Edit Structure, Import CSV, Truncate Table and Drop Table for tables, Delete All Documents for collections; New and Drop Schema, and New and Drop Database (Keyspace on Cassandra), on every engine that has them, never offered for a system object or the session's own database. Open Database on a connection opens another database of the server beside it. The bottom bar has an Add menu for a new table, schema or database, and Schemas, which picks the schemas listed and is kept per connection. Tables and Favorites switch what the sidebar lists. Dragging its edge, or the arrow keys on it, sets a width every window keeps | +| Routines and triggers | Functions, procedures, sequences and triggers, each trigger with the table it fires on, on every engine that has them. Opening one shows its definition read-only, with Copy and Open in Editor; every overload of a PostgreSQL function name is shown | | ER diagram | Show ER Diagram in a table's menu or on a schema's heading opens the schema's tables as cards and their foreign keys as lines in crow's foot notation, read two tables at a time with Stop. Pan, zoom, Best Fit, drag tables, Reset Layout, and PNG and SVG export. Each table is a list item the keyboard and a screen reader reach: Tab and the arrow keys move between tables, Enter opens one, Alt+arrows move it, and its description names its columns and the tables it joins | ## Structure @@ -86,7 +94,7 @@ The app runs on GNOME 50 ([ADR 0015](decisions/0015-gnome-50-platform-floor.md)) | Capability | Detail | |---|---| | Connecting | A MongoDB connection reaches one host directly, a replica set from its hosts and name, a replica set or cluster through its DNS seed list (`mongodb+srv://`), or one host through SSH, with an optional authentication database | -| Collections | Databases list their collections and views. A collection opens in a table tab: its top-level fields as columns, `_id` first, nested documents and arrays as JSON. Paging, filters, the raw filter as a query document, sorting, editing a field, inserting and deleting run as mongosh calls with bound values, shown in the history and the Safe Mode review ([mongodb.md](drivers/mongodb.md)) | +| Collections | Databases list their collections and views. A collection opens in a table tab: its top-level fields as columns, `_id` first, nested documents and arrays as JSON. Paging, filters, the raw filter as a query document, sorting, editing a field, inserting and deleting run as mongosh calls with bound values, shown in the history and the Safe Mode review; Set to DEFAULT on a saved document removes the field ([mongodb.md](drivers/mongodb.md)) | | Statements | The editor takes mongosh statements (`find`, `aggregate`, the writes, `runCommand`, `use`, `show`) and shows documents one per row. A running statement stops with `killSessions`. Read-Only refuses every statement that is not a read, `$out` and `$merge` included, before it is sent | ## SQL editor @@ -100,7 +108,7 @@ The app runs on GNOME 50 ([ADR 0015](decisions/0015-gnome-50-platform-floor.md)) | Scripts | Split per dialect (`DELIMITER`, `GO` and `GO n`, routine and trigger bodies) and sent a statement at a time, or a batch at a time on SQL Server; each result set, row count, notice or error is its own entry, and a failure stops the script except on SQL Server. Run Selection, and run the statement at the cursor | | Find and replace | Ctrl+F and Ctrl+H, with case, whole word and regular expressions | | Files | Open a .sql file into the editor (Ctrl+O) or drop one on it, and save to it (Ctrl+S, or Save As with Ctrl+Shift+S) | -| Results | Several result sets per run, a limit of 10,000 rows per result and 100,000 per run with a banner and Export All, and Go to Error | +| Results | Several result sets per run, a limit of 10,000 rows per result, 100,000 rows and 256 MB of values per run, with a banner and Export All, and Go to Error | | Drafts | Each editor tab's text is kept, and a connection's tabs (table tabs with page and sort, structure and editor tabs) reopen when it opens | | Multiple cursors | Ctrl+D for the next match, Ctrl+Shift+L for every match, Shift+Alt+Up and Down for the lines above and below, Ctrl+click; typing, deleting, pasting and moves at every cursor, one undo for all of them ([README](../README.md#multiple-cursors)) | | Vim mode | GtkSourceView's Vim emulation, off by default, with the mode and pending command under the text; `:w`, `:e`, `:q`, `:wq` and `:x` act on the tab, and the editor's Ctrl shortcuts work in every mode ([README](../README.md#vim-keybindings)) | @@ -112,7 +120,7 @@ The app runs on GNOME 50 ([ADR 0015](decisions/0015-gnome-50-platform-floor.md)) | Query history | A SQLite database with full-text search, filters by connection, time and status, pins, export as SQL or CSV, and a retention period | | What is recorded | Editor runs, and the SQL the app runs for grid saves, structure saves and successful imports; a run that can carry a password or connection secret, or whose text does not tokenize, is not recorded, and recording can be turned off | | Show in Files | For the history database, from the history dialog and Preferences | -| Saved queries | Saved from the editor against a connection, listed by connection with the active one first, and opened in a new tab or the current one | +| Saved queries | Save Query keeps an editor tab's SQL under a name, for its connection. Favorites in the sidebar lists the saved queries of the connection in front, in folders and subfolders: a click opens one in a new editor tab, and its menu, F2 and Delete rename, delete, move it to a folder or share it. Deleting a folder asks first and keeps its queries. Saved Queries in the session menu lists every connection's, the active one first, with search, Open in New Tab, Replace Current Tab, Copy SQL, Rename and Delete. Saving over a saved query keeps its folder, keyword and place | ## Export @@ -121,13 +129,13 @@ The app runs on GNOME 50 ([ADR 0015](decisions/0015-gnome-50-platform-floor.md)) | Formats | CSV with its options, JSON, Markdown, HTML, XML, Excel, and SQL INSERT from a table tab | | Scope | From a table tab, the current page with its pending edits, or every saved row under the filter and sort. From the editor, the rows shown, or every row by running the statement again on a separate read-only connection without the tab's USE or SET; a statement that writes is refused | | Running | Off the GTK thread with progress and Stop; closing or quitting asks about a running export | -| Database | Export Database in the main menu writes a whole database or one schema to a `.sql` or `.sql.gz` file: tables, views, routines and triggers, and every table's rows as multi-row INSERTs, in the order `pg_dump` and `mysqldump` use, so `psql`, `mysql`, `sqlcmd`, `sqlite3` and `clickhouse-client` load it as well as Import SQL File does. Read in process from the connection, not by calling those tools ([core ADR 0011](../../core/docs/decisions/0011-sql-dump-and-import-in-process.md)); not offered on Redis, MongoDB, Cassandra and ScyllaDB ([README](../README.md#export-a-database-and-import-a-sql-file)) | +| Database | Export Database in the session menu writes a whole database or one schema to a `.sql` or `.sql.gz` file: tables, views, routines and triggers, and every table's rows as multi-row INSERTs, in the order `pg_dump` and `mysqldump` use, so `psql`, `mysql`, `sqlcmd`, `sqlite3` and `clickhouse-client` load it as well as Import SQL File does. Read in process from the connection, not by calling those tools ([core ADR 0011](../../core/docs/decisions/0011-sql-dump-and-import-in-process.md)); not offered on Redis, MongoDB, Cassandra and ScyllaDB ([README](../README.md#export-a-database-and-import-a-sql-file)) | ## Import | Capability | Detail | |---|---| -| SQL files | Import SQL File in the main menu runs a `.sql` or `.sql.gz` file of any size on an editor session of its own, split as the engine's client splits it (`DELIMITER`, `GO n`, routine bodies, dollar quotes), with progress, Stop and a summary of what failed and where. pg_dump's `COPY ... FROM stdin` rows load through the copy protocol, text or CSV, and its `\restrict` lines are passed over | +| SQL files | Import SQL File in the session menu runs a `.sql` or `.sql.gz` file of any size on an editor session of its own, split as the engine's client splits it (`DELIMITER`, `GO n`, routine bodies, dollar quotes), with progress, Stop and a summary of what failed and where. pg_dump's `COPY ... FROM stdin` rows load through the copy protocol, text or CSV, and its `\restrict` lines are passed over | | Errors and transactions | Stop at First Error, or run the rest and list each failure with its line. On PostgreSQL, SQL Server, SQLite and DuckDB the file can run as one transaction, so a failure or Stop undoes it all; MySQL, MariaDB and ClickHouse commit each statement as it runs. Safe Mode Read-Only offers neither import, and the import dialog is the one question Confirm Writes asks for the whole file | ## Windows and sessions @@ -140,7 +148,9 @@ The app runs on GNOME 50 ([ADR 0015](decisions/0015-gnome-50-platform-floor.md)) | Session restore | The windows of saved connections and database files open at quit open again at launch (Restore Session, on by default), also after New Window or a quit during the restore | | Closing safely | Unsaved edits, a save in flight or of unknown outcome, an open editor transaction, or a running export ask before a window closes or the app quits; logout waits while any of those holds, and suspend while a save runs or an export writes | | Notifications | Work that finishes in a tab you are not looking at sends a notification | -| Preferences | Restore session, page size, the bulk delete confirmation, query history, editor font and scheme, Vim keybindings, query timeout, the AI assistant, the MCP server | +| Preferences | General: Restore Session, query history (on or off, retention, Clear, its location) and usage data. Data Grid: page size, alternate rows, row numbers, row height, Row Details on selection, invisible characters, date format, default sort, what Copy writes for several rows, NULL text, cell font and the bulk delete confirmation. Editor: font, scheme, Vim keybindings, the snippets folder and the query timeout. AI, MCP and Account | +| Workspace controls | The header has the sidebar toggle, Save Changes for table edits, structure and editable results, Refresh Tab, New Query, the tab overview, the assistant, and a lock that shows the Safe Mode level and changes it. Main Menu holds the app's commands; Session Menu holds the connection in front's: Open Quickly, Query History, Saved Queries, Export Database, Import SQL File, Disconnect and Safe Mode | +| Open Quickly | Ctrl+Shift+O finds tables and views across the connection's schemas, saved queries by name and successful past queries by their SQL; a query opens in a new editor tab | | Shortcuts and About | A shortcuts dialog, and About from the metainfo with third-party licenses and debug info | ## AI assistant @@ -156,9 +166,18 @@ The app runs on GNOME 50 ([ADR 0015](decisions/0015-gnome-50-platform-floor.md)) | Capability | Detail | |---|---| -| Server | Streamable HTTP on `127.0.0.1` only, off until turned on in Preferences, with a port preference and a bearer token kept in the keyring ([ADR 0022](decisions/0022-ai-assistant-and-mcp-server.md)) | +| Server | Streamable HTTP on `127.0.0.1` only, off until turned on in Preferences, with a port preference and a bearer token kept in the keyring; it answers only programs running as the same user ([ADR 0022](decisions/0022-ai-assistant-and-mcp-server.md)) | | External Clients | A level per connection: Blocked hides it, Read Only (the default) lets clients read, Read & Write lets them write after the user approves each statement in Safe Mode's dialog. Safe Mode Read-Only refuses every client write | -| Tools | List connections, open one in a window, list schemas and tables, describe a table and show its DDL, browse and count rows with filters, and run one statement; runs go into the query history | +| Tools | 11 tools: list connections, open one in a window, list databases, schemas and tables, describe a table and show its DDL, browse and count rows with filters, run one statement, and export up to 20 tables as CSV, JSON or SQL INSERT in the answer, 100 rows a table unless asked for up to 1,000, within about 4 MB for the whole answer. Runs go into the query history | +| Client setup | Preferences > MCP lists the AI clients TablePro knows, found ones first, and whether each reaches TablePro. Install and Update write TablePro's entry into the client's own configuration and keep the rest, with a backup beside it; Claude Code is set up through `claude mcp add`, which the Flatpak copies instead of running. Copy gives a client's setup to paste and Remove takes it out; Copy Address, Copy Authorization Header and Regenerate Access Token work with the server on or off. A toast says when a client connects ([core ADR 0023](../../core/docs/decisions/0023-mcp-client-setup-from-one-catalog.md)) | + +## Command line + +| Capability | Detail | +|---|---| +| Opening | `tablepro` with files or links opens them in the running app, or starts it: a SQL file in an editor tab without running it, a SQLite or DuckDB file as a session, a database link as above | +| Commands | `query` runs one statement, or one SQL Server batch, from an argument, a file or standard input; `connections`, `databases`, `schemas` and `tables` list; `describe` prints columns, indexes and foreign keys, or the DDL; `export` prints 1 to 20 tables as CSV, JSON or SQL INSERT; `status` reports the app and its server; `completion` prints a bash, zsh or fish script, which the .deb and .rpm install. Rows print as CSV, TSV, JSON, JSON Lines or an aligned table, up to 1,000 per result ([man page](../data/tablepro.1)) | +| Access | A command that reads a database goes through the running app's MCP server, with its token from the keyring, and each connection's External Clients level; it opens a closed connection only from a terminal, and any prompt is answered in the app ([core ADR 0018](../../core/docs/decisions/0018-command-line.md)) | ## TablePro account @@ -169,13 +188,21 @@ The app runs on GNOME 50 ([ADR 0015](decisions/0015-gnome-50-platform-floor.md)) | License ask | From the 30th day of use without a license, a toast asks whether you would buy one, then at most every 90 days | | Usage data | On by default, as on macOS: the clients.md events go to PostHog until Preferences > General > Privacy turns it off ([ADR 0039](decisions/0039-usage-data.md)) | +## Share links + +| Capability | Detail | +|---|---| +| Share | Share Query and Share Result in the editor's menu, Share Result in a cell's menu and Share on a saved query make a public link through the TablePro account, with a title, note, expiry and Hide SQL, and on Pro a password, no expiry, downloads off and a team to share as. The sheet previews the rows sent ([core ADR 0027](../../core/docs/decisions/0027-share-links.md)) | +| Sensitive columns | Each column is kept, masked (Full, Last 4 Characters, Email, Stable Hash or NULL) or removed. A column that looks sensitive by name or by value starts masked, and the masking runs on this computer before anything is sent ([core ADR 0028](../../core/docs/decisions/0028-data-masking.md)) | +| Opening links | A `tablepro://share` link opens the shared SQL in a new editor tab of the connection in front and never runs it. Manage Shared Links in the main menu opens the account's list in the browser | + ## Packaging and platform | Capability | Detail | |---|---| | Flatpak | The Devel manifest builds on GNOME 51 for x86_64 and aarch64 with every Meson suite in the sandbox, and is linted, in the nightly Linux run; the release manifest builds the Flatpak a release signs into `flatpak.tablepro.app` and bundles for GitHub, offline from the release tarballs; CI tests it, signs it into test repositories, then installs, starts, updates and switches branches on Ubuntu 22.04, 24.04 and 26.04 ([ADR 0041](decisions/0041-beta-repositories-and-release-packages.md)) | | .deb and .rpm | Ubuntu 26.04 and 26.10 and Fedora 44 and 45, built offline in CI the way Launchpad and COPR build them, linted, then installed and started in fresh containers; a `linux-v*` tag publishes them on GitHub Releases, uploads to the PPA and starts the COPR build, a beta tag to the beta ones ([ADR 0018](decisions/0018-ppa-copr-and-flathub-later.md), [ADR 0041](decisions/0041-beta-repositories-and-release-packages.md)) | -| Desktop integration | Desktop file with Open With for SQLite files, D-Bus activation, a man page, metainfo with screenshots, and SVG icons | +| Desktop integration | Desktop file with Open With for SQLite and SQL files, the database URL schemes and `tablepro://`, D-Bus activation, a man page, metainfo with screenshots, and SVG icons | | Translations | Vietnamese ships. The app's own strings go through gettext, and CI fails when `POTFILES.in` is stale or a translation loses a placeholder. CI builds the template with gettext 1.0 and publishes it from main and with each release; translators send pull requests against `po/*.po` ([po/README.md](../po/README.md#where-translators-work)) | | Logs | stderr, which the session journals, with JSON lines on request. A panic also writes a crash report under `$XDG_STATE_HOME`, offered with Show Report on the next launch | | Tests | Unit, gtk (with an accessibility audit of the picker, the connect pages, the workspace, the connect dialog and every preferences page), data and packaging suites; connection, DDL and TLS conformance, a CSV and SQL INSERT export round trip, a copy and paste round trip, and a database dump loaded back through Import SQL File and dumped again to the same file, on every SQL engine, keyspace and TLS conformance on Redis, and document and TLS conformance on MongoDB; Docker jobs for PostgreSQL with PgBouncer, MySQL and MariaDB, SQL Server, ClickHouse, Cassandra and ScyllaDB, Redis, MongoDB, SSH, the session and the grid save ([testing.md](testing.md)); every critical audit finding has named guards ([regression-tests.md](regression-tests.md)) | From 8f33676247802f35e8d2c55f08bf48b4e508ccc6 Mon Sep 17 00:00:00 2001 From: Ngo Quoc Dat Date: Sat, 14 Nov 2026 20:07:49 +0700 Subject: [PATCH 2/2] docs(roadmap): tick R-12 with #4281 --- ROADMAP.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/ROADMAP.md b/ROADMAP.md index c7467839e4..5911e4773a 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -29,7 +29,7 @@ awk '/^## /{p=$0} /^ *- \[[ x]\]/{t[p]++} /^ *- \[x\]/{d[p]++} END{for(k in t) p | Section | Boxes | Done | |---|---|---| -| Phase 0: Release blockers | 16 | 2 | +| Phase 0: Release blockers | 16 | 3 | | Phase 1: Core enablers | 23 | 2 | | Phase 2: Windows daily use | 62 | 2 | | Phase 3: Standard features both apps lack | 118 | 0 | @@ -38,7 +38,7 @@ awk '/^## /{p=$0} /^ *- \[[ x]\]/{t[p]++} /^ *- \[x\]/{d[p]++} END{for(k in t) p | Phase 6: Quality bars | 8 | 0 | | Phase 7: Sync and teams | 15 | 0 | | Phase 8: Beyond the market | 40 | 0 | -| Total | 366 | 6 | +| Total | 366 | 7 | ## Where each app stands @@ -84,7 +84,7 @@ awk '/^## /{p=$0} /^ *- \[[ x]\]/{t[p]++} /^ *- \[x\]/{d[p]++} END{for(k in t) p - [ ] **R-10** [Release criterion](linux/docs/releasing.md#release-criteria) 8: the manual pass with Orca, the keyboard alone, High Contrast, 1.5x text and a right-to-left locale - [ ] **R-11** Release criterion 10: a dated week of daily use -- [ ] **R-12** Bring [linux/docs/features.md](linux/docs/features.md) up to date: about 40 features from #4108 to #4159, #4145 and #4147 are missing, and the Saved queries, Sidebar, Preferences, Connections import, MCP Tools and Copy rows are stale +- [x] **R-12** Bring [linux/docs/features.md](linux/docs/features.md) up to date: about 40 features from #4108 to #4159, #4145 and #4147 are missing, and the Saved queries, Sidebar, Preferences, Connections import, MCP Tools and Copy rows are stale: #4281 - [ ] **R-13** The display-scale pass on a real GPU and a HiDPI screen, and a hand install on Ubuntu 26.04 - [ ] **R-14** Not a 0.1.0 blocker: #4099 (KDE Wallet prompt opens behind the window) and #4101 (`flatpak list` shows "Usage data") are fixed upstream in [xdg-desktop-portal#2203](https://github.com/flatpak/xdg-desktop-portal/pull/2203) and [flatpak#6965](https://github.com/flatpak/flatpak/pull/6965), in no release yet, and are known issues in 0.1.0's notes. Once an xdg-desktop-portal release has #2203, pass `parent_window` and `activation_token` to RetrieveSecret; ksecretd's side is [KDE bug 528518](https://bugs.kde.org/show_bug.cgi?id=528518) - [ ] **R-15** After 0.1.0: the Flathub manifest and exception request, by the maintainer, under [Flathub's requirements](linux/docs/decisions/0041-beta-repositories-and-release-packages.md#context) (#3640)