release: v0.39.0

Author: datlechin

CHANGELOG.md

@@ -7,91 +7,68 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-### Fixed
-
-- New tab via Cmd+T no longer flashes focus back to the previous tab in the same window group
-- Cmd+X with no selection cuts the current line, matching VS Code, Sublime, and Xcode (#1075)
-- Cmd+A on a query ending with a newline now highlights every line, not just the first (#1075)
-- Editor windows now remember their size, position, and zoom state across launches, instead of always opening at 1200x800
-- iOS: data browser and query result lists no longer crash with "Index out of range" when rows shrink during a SwiftUI update pass
-- iOS: connecting to MySQL, PostgreSQL, or Redis with an out-of-range port now reports a readable error instead of crashing on integer overflow
-
-### Added
-
-- AI Chat: tool calling support for the GitHub Copilot provider. Copilot can now invoke the same database tools (list_tables, describe_table, execute_query, etc.) the other providers do, gated by chat mode and the per-card approval flow. Older Copilot language servers without the `conversation/registerTools` API gracefully degrade to chat-only.
-- AI Chat: per-card tool approval. Write and destructive AI tool calls now show inline `Run`, `Always for this connection`, and `Cancel` buttons on the tool card instead of interrupting with a modal dialog. "Always for this connection" persists the tool name on the connection so future calls run without prompting. Cancel ends only that tool call; the assistant sees an error result and continues the conversation. Read-only tools auto-run; Read-only safe mode still blocks writes outright.
-- AI Chat: panel layout redesign. The right inspector has a Details / AI Chat segmented picker at the top, with conversation history and new-conversation actions trailing on the same row. The chat tab is composer-focused: composer is a rounded multi-line input with an Apple Intelligence focus glow, and a single-row footer (mention, slash commands, mode picker, model picker, send). The mode picker (Ask / Edit / Agent) is saved to settings but does not yet change provider behavior.
-- AI Chat: inline model picker in the composer with per-turn model attribution. Switch between configured providers and any of their available models without leaving the chat. The model that produced each assistant turn is shown in the message footer.
-- AI Chat: slash commands `/explain`, `/optimize`, `/fix`, and `/help`. Type the command in the composer or pick from the slash menu next to the model picker. `/explain`, `/optimize`, and `/fix` operate on the current query in the active editor. `/help` lists the commands inline.
-- AI Chat: attach context to a message via the `@` menu next to the slash menu, or by typing `@` directly in the composer.
-  - Pick Schema, a specific Table, the Current Query, or recent Query Results.
-  - Typing `@` opens a caret-anchored picker that filters as you type. Up/Down navigates, Return or Tab inserts, Escape dismisses.
-  - Attachments render as chips above the input and inside the user message bubble.
-  - Editing a sent message restores its typed text and chips so you can adjust both before resending.
-- AI Chat: tool calling. The AI can look up your database on demand instead of relying on context you attached up front.
-  - Read-only tools: `list_connections`, `get_connection_status`, `list_databases`, `list_schemas`, `list_tables`, `describe_table`, `get_table_ddl`.
-  - Tool calls and their results render as expandable pills in the assistant's reply.
-  - Supported providers: Anthropic, OpenAI, OpenRouter, Gemini, Ollama (model-dependent), GitHub Copilot, and custom OpenAI-compatible endpoints.
-- AI Chat: attach a saved query as a chip via `@`. Type `@` and pick a saved SQL query to send its name and body to the AI alongside your message.
-- AI Chat: user-defined slash commands. Create your own commands in Settings -> AI -> Custom Slash Commands. Templates support `{{query}}`, `{{schema}}`, `{{database}}`, and `{{body}}` placeholders that get substituted at send time.
-- AI Chat: tool calling can now run write queries (`execute_query`) and destructive DDL (`confirm_destructive_operation` after the AI passes the verbatim phrase). The connection's safe mode policy still gates execution, so the user remains the final approver.
-- AI Chat: per-connection rules. Add custom guidance (table conventions, PII columns, naming) in the connection's AI Rules tab; the AI sees it on every chat turn for that connection.
-
-### Changed
-
-- AI Chat: new installations default to opt-in context. Schema, current query, and query results no longer auto-include in every prompt; attach them via the `@` menu when you want them. Existing users keep their current Settings -> AI -> "Include schema/current query/query results" choices unchanged.
-- AI Chat: the Ask / Edit / Agent mode picker now changes which tools the provider sees. Ask exposes read-only schema lookups. Edit adds `execute_query` for SELECT/INSERT/UPDATE/DELETE. Agent adds destructive DDL via `confirm_destructive_operation`. The connection's safe mode policy still gates execution.
-
-### Fixed
-
-- New tab via Cmd+T no longer flashes focus back to the previous tab in the same window group
-- AI Chat Retry button no longer appears for errors retry can't fix (authentication failure, deprecated model, invalid endpoint). The error message stays so the user can act on it.
-- AI Chat code blocks render with syntax highlighting and the Insert button even when the AI omits the language tag, by detecting SQL/JavaScript heuristically from the code content.
-- AI Chat Insert button stays enabled when the chat panel itself has focus instead of the editor, by falling back to `CommandActionsRegistry` when `@FocusedValue` returns nil.
-
-## [0.39.0] - 2026-05-07
+## [0.39.0] - 2026-05-08
 
 ### Added
 
+- AI Chat: tool calling with per-card approval, Ask / Edit / Agent modes, and 7 providers (Anthropic, OpenAI, OpenRouter, Gemini, Ollama, GitHub Copilot, custom OpenAI-compatible)
+- AI Chat: `@` mentions for Schema, Table, Current Query, Query Results, and saved queries
+- AI Chat: slash commands (`/explain`, `/optimize`, `/fix`, `/help`) plus user-defined commands
+- AI Chat: inline model picker with per-turn model attribution
+- AI Chat: per-connection rules for the assistant
 - Linked SQL Folders: two-way sync between Favorites and a folder of `.sql` files
-- Database type chooser sheet for new connections, grouped by category with search
-- Connection URL import moved into the database type chooser
+- Database type chooser sheet for new connections
+- Connection URL import in the database type chooser
 
 ### Changed
 
-- iOS: streaming data layer; large queries no longer buffer the full result set
-- Toolbar leads with a tinted engine icon to distinguish multiple windows on the same database (#1044)
-- XLSX export is free for everyone
-- Safe Mode (Touch ID, Full, Read Only) is free for everyone
-- Favorites sidebar is connection-scoped; opening a second tab no longer reloads
-- Connection Form rebuilt with sidebar navigation and native window-toolbar actions
+- iOS: streaming data layer for large queries
+- Toolbar shows a tinted engine icon to distinguish windows on the same database (#1044)
+- XLSX export is free
+- Safe Mode is free
+- Favorites sidebar is connection-scoped
+- Connection Form: sidebar navigation with native toolbar actions
 - "Read-Only" / "Read-Write" renamed to "Read Only" / "Read & Write"
 - ER diagram nodes scale with system text size
-- Hero icons, list views, search fields, and form sheets aligned with macOS HIG
-- Welcome, Connection Form, and Integrations Activity windows use SwiftUI scenes
+- Welcome, Connection Form, and Integrations Activity use SwiftUI scenes
 
 ### Fixed
 
-- New connection chooser falsely prompted "MariaDB plugin is not installed" for built-in lazy drivers
-- Schema selection from Cmd+K Quick Switcher silently ignored on SQL Server and Oracle
+- "MariaDB plugin not installed" prompt for built-in lazy drivers
+- Cmd+K Quick Switcher schema selection on SQL Server and Oracle
 - iOS: crash opening some MySQL tables
-- iOS: connections to `.local` and local-network addresses timed out silently
-- Data grid column headers misaligned with result-cell horizontal inset
-- Toolbar connection status lost its left inset when no connection tag was shown
-- SQL editor jumped to end after committing IME-marked words like "测试" (#1012)
-- External-contributor builds failed on personal Apple Developer teams (#1020)
-- SSH auth-failure alerts mislabelled the cause when the verification code was wrong (#1005)
-- TOTP codes that crossed a 30-second rotation boundary were rejected
-- SSH Auth Method = Password failed against keyboard-interactive-only servers (#1005)
-- SSH connections requiring Google Authenticator failed with Password + TOTP (#1005)
-- Up arrow on first line and Down on last line failed at end-of-document caret
-- Caret at end of query lost its line-number color in the gutter
-- Cmd+Left/Right at the end of a line with no trailing newline did nothing (#1007)
+- iOS: silent timeout on `.local` and local-network addresses
+- iOS: row list "Index out of range" crash on shrink (#1094)
+- iOS: out-of-range port crash on MySQL, PostgreSQL, Redis (#1094)
+- IME editor jump after committing words like "测试" (#1012)
+- Cmd+T tab focus flash
+- Cmd+X with no selection now cuts the line (#1075)
+- Cmd+A on a query with a trailing newline (#1075)
+- Editor window size, position, and zoom across launches
+- Personal Apple Developer team builds (#1020)
+- SSH auth-failure alerts labelled the wrong cause (#1005)
+- TOTP codes rejected across rotation boundary
+- SSH Password against keyboard-interactive-only servers (#1005)
+- SSH Password + Google Authenticator (#1005)
+- Up/Down arrow at end-of-document caret
+- Caret line-number color in the gutter
+- Cmd+Left/Right at end of a line without a trailing newline (#1007)
 - Multi-window tab persistence dropped all but one tab on relaunch
-- Filter value autocomplete popover stole focus on Full Keyboard Access
-- Toolbar database name was empty after relaunch with a restored last-used database
-- Cmd+K database switch reverted in Cmd+T, query history, AI prompts, and tab-creation paths (#1043)
-- AI provider settings showed `unsupported URL` while editing a draft endpoint
+- Filter autocomplete focus on Full Keyboard Access
+- Toolbar database name on relaunch
+- Cmd+K database switch reverted in Cmd+T and other paths (#1043)
+- AI provider Test Connection showed `unsupported URL` on draft endpoint
+- Connection Form coordinator rebuilt on every parent re-render (#1102)
+- MongoDB SRV connection strings include the port (#1101)
+- AI Chat composer: IME, scroll bar, Shift+Return (#1100)
+- AI Chat tool roundtrip limit raised 5 → 10 (#1096)
+- AI Chat per-connection rules CloudKit sync (#1098)
+- AI Chat Retry button on non-recoverable errors
+- AI Chat code blocks without a language tag
+- AI Chat Insert button focus
+- MCP errors surface readable messages (#1095)
+- Data grid column header inset
+- Toolbar connection status left inset
 
 ## [0.38.0] - 2026-05-04
 

TablePro.xcodeproj/project.pbxproj

@@ -2286,7 +2286,7 @@
 				CODE_SIGN_IDENTITY = "Apple Development";
 				"CODE_SIGN_IDENTITY[sdk=macosx*]" = "Apple Development";
 				CODE_SIGN_STYLE = Automatic;
-				CURRENT_PROJECT_VERSION = 77;
+				CURRENT_PROJECT_VERSION = 78;
 				DEAD_CODE_STRIPPING = YES;
 				DEVELOPMENT_TEAM = D7HJ5TFYCU;
 				ENABLE_APP_SANDBOX = NO;
@@ -2318,7 +2318,7 @@
 				);
 				LIBRARY_SEARCH_PATHS = "$(PROJECT_DIR)/Libs/dylibs";
 				MACOSX_DEPLOYMENT_TARGET = 14.0;
-				MARKETING_VERSION = 0.38.0;
+				MARKETING_VERSION = 0.39.0;
 				OTHER_LDFLAGS = (
 					"-Wl,-w",
 					"-force_load",
@@ -2363,7 +2363,7 @@
 				"CODE_SIGN_IDENTITY[sdk=macosx*]" = "Apple Development";
 				CODE_SIGN_STYLE = Automatic;
 				COPY_PHASE_STRIP = YES;
-				CURRENT_PROJECT_VERSION = 77;
+				CURRENT_PROJECT_VERSION = 78;
 				DEAD_CODE_STRIPPING = YES;
 				DEPLOYMENT_POSTPROCESSING = YES;
 				DEVELOPMENT_TEAM = D7HJ5TFYCU;
@@ -2396,7 +2396,7 @@
 				);
 				LIBRARY_SEARCH_PATHS = "$(PROJECT_DIR)/Libs/dylibs";
 				MACOSX_DEPLOYMENT_TARGET = 14.0;
-				MARKETING_VERSION = 0.38.0;
+				MARKETING_VERSION = 0.39.0;
 				OTHER_LDFLAGS = (
 					"-Wl,-w",
 					"-force_load",

docs/changelog.mdx

@@ -4,11 +4,16 @@ description: "Product updates and announcements for TablePro"
 rss: true
 ---
 
-<Update label="May 7, 2026" description="v0.39.0">
+<Update label="May 8, 2026" description="v0.39.0">
   ### New Features
 
-  - **Linked SQL Folders**: Point TablePro at a folder of `.sql` files for two-way sync with Favorites. Edit in TablePro or your editor; changes flow both ways. Frontmatter sets `@name`, `@keyword`, and `@description`; save-time conflicts show a side-by-side diff. Free.
-  - **Database Type Chooser**: New Connection now opens a categorised, searchable sheet listing every supported driver (Relational, Document, Key-Value, Analytical, Wide-Column, Cloud Native, Coordination & Config). Editing an existing connection skips the chooser
+  - **AI Chat Tool Calling**: The assistant can look up your database on demand. Read-only tools (`list_tables`, `describe_table`, `get_table_ddl`, etc.) auto-run; write and destructive ops show inline approval pills (Run / Always for this connection / Cancel). Works with Anthropic, OpenAI, OpenRouter, Gemini, Ollama, GitHub Copilot, and custom OpenAI-compatible endpoints. Ask / Edit / Agent mode picker controls which tools the model sees. Safe mode still gates execution
+  - **AI Chat `@` Mentions**: Attach Schema, a Table, the Current Query, recent Query Results, or a saved SQL query as chips. Type `@` in the composer or pick from the menu
+  - **AI Chat Slash Commands**: Built-in `/explain`, `/optimize`, `/fix`, `/help`, plus user-defined commands in Settings -> AI -> Custom Slash Commands with `{{query}}`, `{{schema}}`, `{{database}}`, `{{body}}` placeholders
+  - **AI Chat Per-Connection Rules**: Add custom guidance about table conventions, PII columns, and naming in the connection's AI Rules tab; the assistant sees it on every chat turn
+  - **AI Chat Panel Redesign**: Composer-focused chat tab with inline model picker and per-turn model attribution
+  - **Linked SQL Folders**: Point TablePro at a folder of `.sql` files for two-way sync with Favorites. Edit in TablePro or your editor; changes flow both ways. Frontmatter sets `@name`, `@keyword`, and `@description`; save-time conflicts show a side-by-side diff. Free
+  - **Database Type Chooser**: New Connection opens a categorised, searchable sheet listing every supported driver (Relational, Document, Key-Value, Analytical, Wide-Column, Cloud Native, Coordination & Config)
   - **Free XLSX Export**: Excel export no longer requires Pro
   - **Free Safe Mode**: Touch ID, Full, and Read Only Safe Mode levels no longer require Pro
 
@@ -19,7 +24,8 @@ rss: true
   - **Connection-Scoped Favorites**: Opening a second tab on the same connection no longer reloads the favorites tree or flashes a spinner. Selection persists across windows
   - **Connection Form Redesign**: Rebuilt around macOS HIG sidebar navigation (General, SSH Tunnel, SSL/TLS, Customization, Advanced). Cancel, Save, and Save & Connect live in the native window toolbar; Test Connection inline
   - **Connection URL Import**: Moved into the database type chooser; paste a URL there instead of inside the form
-  - **HIG Polish**: Hero icons scale with system text size, search fields use native `NSSearchField`, validation banners use the standard warning convention, and form sheets switch to grouped Form layouts
+  - **AI Chat Opt-In Context**: New installs no longer auto-include schema, current query, and query results in every prompt; attach via `@` when you want them. Existing users keep their current settings
+  - **HIG Polish**: Hero icons scale with system text size, search fields use native `NSSearchField`, validation banners use the standard warning convention, form sheets switch to grouped Form layouts
   - **Native Windows**: Welcome, Connection Form, and Integrations Activity now use SwiftUI scenes, fixing an assertion crash and restoring Integrations Activity at next launch
   - **ER Diagram Accessibility**: Diagram nodes scale with system text size
   - **Terminology**: "Read-Only" / "Read-Write" renamed to "Read Only" / "Read & Write" to match macOS HIG
@@ -29,8 +35,15 @@ rss: true
   - **Schema Switching on SQL Server / Oracle**: Cmd+K Quick Switcher schema selection no longer silently ignored
   - **iOS MySQL Crash**: Fixed `EXC_BREAKPOINT` when opening some MySQL tables
   - **iOS Local Network**: Connections to `.local` hostnames and local-network addresses (10.x, 192.168.x, link-local, IPv6 ULA) no longer time out silently
+  - **iOS Row List Crash**: Data browser and query result lists no longer crash with "Index out of range" when rows shrink mid-update (#1094)
+  - **iOS Port Validation**: Out-of-range port for MySQL, PostgreSQL, or Redis reports a readable error instead of crashing (#1094)
   - **MariaDB Install Prompt**: New connection chooser no longer falsely prompts to install built-in lazy drivers
   - **IME Editor Jump**: SQL editor no longer jumps to the end after committing Chinese, Japanese, or Korean words like "测试" (#1012)
+  - **MongoDB SRV Port**: Connection strings strip the port from the host per the URI spec (#1101)
+  - **Cmd+T Focus Flash**: New tabs no longer flash focus back to the previous tab
+  - **Cmd+X No Selection**: Cuts the current line, matching VS Code, Sublime, and Xcode (#1075)
+  - **Cmd+A Trailing Newline**: Selecting all on a query ending with a newline highlights every line (#1075)
+  - **Editor Window State**: Windows remember size, position, and zoom across launches
   - **Personal Team Builds**: External-contributor builds on personal Apple Developer teams now work without an iCloud entitlement (#1020)
   - **SSH Auth Errors**: Auth-failure alerts now point at the actual cause (wrong password, wrong verification code, rejected key) (#1005)
   - **TOTP Rotation**: Codes that crossed a 30-second rotation boundary are no longer rejected
@@ -43,7 +56,15 @@ rss: true
   - **Toolbar Database Name**: No longer empty after relaunch when the last-used database is restored
   - **Cmd+K Database Switch**: Switching databases no longer reverts in Cmd+T, query history, AI prompts, or several tab-creation paths (#1043)
   - **AI Provider Test**: No longer shows `unsupported URL` while editing a draft endpoint
-  - **Data Grid Header Inset**: Column headers now align with result-cell horizontal inset
+  - **Connection Form Coordinator**: No longer rebuilds on every parent re-render (#1102)
+  - **AI Chat Composer**: IME safety, visible scroll bar, and Shift+Return for newline (#1100)
+  - **AI Chat Tool Limit**: Roundtrip limit raised from 5 to 10 (#1096)
+  - **AI Chat Rules Persistence**: Per-connection rules persist through `StoredConnection` and CloudKit sync (#1098)
+  - **AI Chat Retry Button**: Hidden for non-recoverable errors (auth failure, deprecated model, invalid endpoint)
+  - **AI Chat Code Blocks**: Render with syntax highlighting and Insert even when the language tag is missing
+  - **AI Chat Insert**: Stays enabled when the chat panel has focus instead of the editor
+  - **MCP Errors**: Surface a readable message via `LocalizedError` (#1095)
+  - **Data Grid Header Inset**: Column headers align with result-cell horizontal inset
   - **Toolbar Status Inset**: Connection status keeps its left inset when no connection tag is shown
 </Update>