feat(history): add local query insights

[sophiathedev]

Summary

• add a Starter-gated Insights mode to Query History for the current connection
• surface most-run, slowest, and week-over-week regressed queries from the local SQLite history store
• add native master-detail UI with copy and load-in-editor actions
• document the feature and include a full-window macOS preview

Behavior

• Most Run counts successful and failed executions
• Slowest uses only valid successful durations
• Slower Than Last Week compares two half-open seven-day windows
• regressions require at least three samples per window, a 25% increase, and a 50 ms absolute increase
• switching connections clears stale results while the new scope loads

Security and edge cases

• all aggregation stays on-device
• SQL uses bound parameters for connection and time scope
• blank queries, future entries, invalid dates, negative or non-finite durations, oversized limits, and extreme ratios are handled
• results are scoped by exact connection, database, and query

Testing

• 55 focused app tests across Query History, storage, licensing, selection, and date filtering
• 10 deeper insight tests after edge-case fixes
• 181 TableProCore package tests
• Debug build
• strict SwiftLint: 0 violations across 1,345 files
• full-window macOS preview capture
• UI automation execution locally: AppleSystemPolicy blocks ad-hoc UI test runners without development signing; the signed UI test is included for CI
• full TableProTests run: 9,338 tests executed with 79 failures outside Query History

Preview

Related

Follow-up to #2103.

Closes #2107

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a9ac7ef321

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Preserve selection using the insight's stable identity

When the selected query is executed again, the history notification reloads this snapshot, but QueryHistoryInsightSelection hashes the entire insight, including counts, timings, and lastExecutedAt. The refreshed value therefore never matches the existing selection even if the same query remains in the same category, so this branch clears the selection and closes the detail pane after the run. Match by category plus insight.id, then replace the selection with the refreshed insight so its metrics update without losing the user's context.

Useful? React with 👍 / 👎.

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.