Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
66 commits
Select commit Hold shift + click to select a range
114c40a
docs: add working agreement and project readme
jeffreyaven Nov 17, 2026
324d4a4
chore: ignore build output and engine logs, record MIT licence
jeffreyaven Nov 17, 2026
510973c
feat: scaffold Tauri 2 app with React, TypeScript and Vite
jeffreyaven Nov 17, 2026
704cd89
docs: pg wire spike against stackql v1.0.888
jeffreyaven Nov 17, 2026
a29ecbc
feat(host): engine discovery, port selection and process supervisor
jeffreyaven Nov 17, 2026
3a6b9f8
feat(host): connection trait, pg wire query service and typed IPC
jeffreyaven Nov 17, 2026
581258d
feat(ui): explorer, editor, results grid, status bar and settings
jeffreyaven Nov 17, 2026
d56407e
feat: host clipboard command, content-sized grid columns and CI workflow
jeffreyaven Nov 17, 2026
4089e50
fix(host): POSIX kill form in the Unix watchdog, and M0 docs
jeffreyaven Nov 17, 2026
b009401
feat: provider favicons in the explorer and the StackQL app icon
jeffreyaven Nov 17, 2026
30c155d
feat(ui): show the StackQL icon for providers built into the engine
jeffreyaven Nov 17, 2026
f2c0d16
fix(host): rename icon lookup helper to satisfy clippy
jeffreyaven Nov 17, 2026
b6de43d
feat(agent): MCP client, approvals, agent loop and three inference ba…
jeffreyaven Nov 17, 2026
b5bf4ca
feat(ui): chat pane, approval card, activity pane and chat settings
jeffreyaven Nov 17, 2026
da11d98
docs: record the chat milestone, the MCP findings and current status
jeffreyaven Nov 17, 2026
d1d615d
feat(engine): keep the data folder beside the app, with a setting to …
jeffreyaven Nov 18, 2026
19a5863
feat(explorer): group a method's fields into Inputs and Outputs
jeffreyaven Nov 18, 2026
90922bd
fix(engine): give a child that cannot join the shared job a job of it…
jeffreyaven Nov 18, 2026
4ebaebb
feat(agent): GitHub Copilot CLI as a delegated backend over ACP
jeffreyaven Nov 18, 2026
61f215f
feat(ui): chat-first layout with a side menu, menus and formatted rep…
jeffreyaven Nov 18, 2026
8a19f14
fix(explorer): count every field that is not an input as an output
jeffreyaven Nov 18, 2026
06753d4
fix(agent): keep the Copilot MCP configuration in one file per safety…
jeffreyaven Nov 18, 2026
fc481e0
feat(explorer): leave the built-in stackql_preview provider out of th…
jeffreyaven Nov 18, 2026
3d641bb
fix: stop calling a provider's answer a failure, and tell the model h…
jeffreyaven Nov 18, 2026
07b9437
fix(agent): take provider error handling back out of this app
jeffreyaven Nov 18, 2026
1be3a8b
docs: record that one MCP server runs tool calls at the same time
jeffreyaven Nov 18, 2026
d2539a6
feat(agent): run the independent tool calls of one reply at the same …
jeffreyaven Nov 18, 2026
9e5258f
feat(agent): let the Copilot CLI split independent lookups across sub…
jeffreyaven Nov 18, 2026
cebe60e
fix(agent): tell the Copilot agent which kind of subagent can do the …
jeffreyaven Nov 18, 2026
7e8eabf
fix(agent): make Copilot subagents opt-in, and stop a turn when one n…
jeffreyaven Nov 18, 2026
4b658c5
feat(ui): mode wording, chat placeholder, and the engine binary in a …
jeffreyaven Nov 18, 2026
36a5df3
feat(editor): tabs
jeffreyaven Nov 18, 2026
54f80a7
feat(chat): equivalent SQL on metadata cards, session chips, no resta…
jeffreyaven Nov 18, 2026
3af1e64
feat(explorer): filter, jump box, verb pills, statement templates, re…
jeffreyaven Nov 18, 2026
48dec74
feat(editor): completion, history, export and a CLI command for a sta…
jeffreyaven Nov 18, 2026
c022ebc
feat(shell): activity columns and filters, address copy, Query, Provi…
jeffreyaven Nov 18, 2026
fa39580
feat(ui): wordmark, Classic Blue as the primary colour, neutral statu…
jeffreyaven Nov 18, 2026
0567588
feat(library): a query library view, and chat suggestions taken from it
jeffreyaven Nov 18, 2026
602dddf
docs: remove the UX work order, and record what was run
jeffreyaven Nov 18, 2026
c63f81e
test(supervisor): wait on a process handle to see a child end
jeffreyaven Nov 18, 2026
21f09ec
fix(ui): make the wordmark larger
jeffreyaven Nov 18, 2026
bc28257
ci: build a universal macOS disk image as a test artifact
jeffreyaven Nov 19, 2026
27451dc
ci: check out LF on Windows, and install the release engine on macOS
jeffreyaven Nov 19, 2026
1ff59d5
docs: record what the first CI runs showed on macOS
jeffreyaven Nov 19, 2026
7553222
feat(results): sort a result set by a click on a column
jeffreyaven Nov 19, 2026
ce837cf
feat(host): keep an app log, and write failed tool calls to it
jeffreyaven Nov 19, 2026
4296ab1
feat(agent): tell a model how its work is shown, and mark calls by step
jeffreyaven Nov 19, 2026
2f9360b
feat(charts): read a chart block and work out what to draw
jeffreyaven Nov 19, 2026
c7e94a6
feat(chat): show a turn as its answer, with steps, tables and charts
jeffreyaven Nov 19, 2026
e34753f
docs: record how a turn is shown, the chart block and the app log
jeffreyaven Nov 19, 2026
b66a592
docs: say what the two real turns through the Copilot CLI showed
jeffreyaven Nov 19, 2026
bfa71dd
feat(agent): count cached input and thinking in what a turn used
jeffreyaven Nov 19, 2026
647a732
feat(chat): say what a turn used, in tokens
jeffreyaven Nov 19, 2026
cf7f595
docs: record the token counts and what the Copilot CLI reports
jeffreyaven Nov 19, 2026
eaaded3
feat(engine): default to the engine installed with the app
jeffreyaven Nov 19, 2026
30bd5e1
docs: record which engine an installed app uses
jeffreyaven Nov 19, 2026
1b8c4bf
ci: keep what the MSI and the PKG are built from
jeffreyaven Nov 19, 2026
ca45eec
build(windows): link the whole C runtime into the executable
jeffreyaven Nov 19, 2026
8272b77
feat(host): use a page renderer shipped beside the app
jeffreyaven Nov 19, 2026
fd1abde
fix(engine): start again on a fresh port when the engine exits at once
jeffreyaven Nov 19, 2026
c1b5565
docs: record what the binaries need from the system
jeffreyaven Nov 19, 2026
e0789f1
docs: the installers do not ship the page renderer
jeffreyaven Nov 19, 2026
1a9472f
build(macos): need macOS 13 or later
jeffreyaven Nov 19, 2026
e78462b
ci: build and test for Windows on Arm
jeffreyaven Nov 19, 2026
48ececc
docs: record what ran on Windows on Arm
jeffreyaven Nov 19, 2026
4a569ee
updates
jeffreyaven Nov 20, 2026
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
3 changes: 3 additions & 0 deletions .gitattributes
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Check out text files with LF on every platform. Prettier checks for LF, and
# a Windows checkout would otherwise convert them to CRLF.
* text=auto eol=lf
298 changes: 298 additions & 0 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,298 @@
name: CI

on:
push:
branches: [main]
pull_request:
workflow_dispatch:

permissions:
contents: read

concurrency:
group: ci-${{ github.ref }}
cancel-in-progress: true

jobs:
check:
name: Check (${{ matrix.os }})
runs-on: ${{ matrix.os }}
timeout-minutes: 45
strategy:
fail-fast: false
matrix:
os: [windows-latest, windows-11-arm, macos-latest]

steps:
- uses: actions/checkout@v7

- uses: actions/setup-node@v7
with:
node-version: 24
cache: npm

- uses: dtolnay/rust-toolchain@stable
with:
components: rustfmt, clippy

- uses: Swatinem/rust-cache@v2
with:
workspaces: src-tauri

# Puts stackql on PATH so the integration tests run instead of being
# skipped. They use metadata statements and the built-in provider only:
# no credentials and no provider downloads.
- uses: stackql/setup-stackql@v2
if: matrix.os == 'windows-latest'

# The MSI for Arm ships the engine built for Arm. The tests run against
# that one, from the release archive, and not against the x64 engine
# under emulation.
- name: Install stackql from the release archive (Windows on Arm)
if: matrix.os == 'windows-11-arm'
shell: pwsh
working-directory: ${{ runner.temp }}
run: |
$base = 'https://github.com/stackql/stackql/releases/latest/download'
curl.exe -fsSL -O "$base/stackql_windows_arm64.zip"
curl.exe -fsSL -O "$base/stackql_windows_arm64.zip.sha256"
$want = ((Get-Content stackql_windows_arm64.zip.sha256) -split '\s+')[0].ToLower()
$have = (Get-FileHash stackql_windows_arm64.zip -Algorithm SHA256).Hash.ToLower()
if ($want -ne $have) { throw 'The archive does not match its checksum.' }
Expand-Archive stackql_windows_arm64.zip -DestinationPath stackql-arm64
$folder = (Resolve-Path stackql-arm64).Path
Get-ChildItem $folder | Format-Table Name, Length
Add-Content -Path $env:GITHUB_PATH -Value $folder

# On macOS the setup action installs with Homebrew, which has v0.12.824.
# The tests rely on the current release, so the release package is
# installed instead. It puts stackql in /usr/local/bin.
- name: Install stackql from the release package (macOS)
if: runner.os == 'macOS'
working-directory: ${{ runner.temp }}
run: |
base=https://github.com/stackql/stackql/releases/latest/download
curl -fsSL -O "$base/stackql_darwin_multiarch.pkg"
curl -fsSL -O "$base/stackql_darwin_multiarch.pkg.sha256"
shasum -a 256 -c stackql_darwin_multiarch.pkg.sha256
sudo installer -pkg stackql_darwin_multiarch.pkg -target /

- name: Tool versions
shell: bash
run: |
node --version
node -p "'node is built for ' + process.arch"
npm --version
rustc -vV
cargo --version
stackql --version

- name: Install webview dependencies
run: npm ci

- name: Lint and format check (webview)
run: npm run lint

- name: Typecheck (webview)
run: npm run typecheck

- name: Test (webview)
run: npm test

- name: Format check (host)
working-directory: src-tauri
run: cargo fmt --check

- name: Lint (host)
working-directory: src-tauri
run: cargo clippy --all-targets -- -D warnings

- name: Test (host)
working-directory: src-tauri
run: cargo test

# Builds the webview bundle and the host together, without installers.
- name: Debug build
run: npm run tauri build -- --debug --no-bundle

# A test build for a Mac, kept as a workflow artifact. It is not a release:
# the signature is ad hoc, with no Developer ID, and nothing is notarised.
# It does not wait for the checks, so a failing test still leaves a build.
bundle-macos:
name: Bundle (macOS, universal)
runs-on: macos-latest
timeout-minutes: 60

steps:
- uses: actions/checkout@v7

- uses: actions/setup-node@v7
with:
node-version: 24
cache: npm

# A universal build needs the standard library for both architectures.
- uses: dtolnay/rust-toolchain@stable
with:
targets: aarch64-apple-darwin,x86_64-apple-darwin

- uses: Swatinem/rust-cache@v2
with:
workspaces: src-tauri

- name: Install webview dependencies
run: npm ci

# An Apple Silicon Mac runs no code without a signature. "-" asks for an
# ad hoc one, which needs no certificate.
- name: Build the app and the disk image
env:
APPLE_SIGNING_IDENTITY: '-'
run: npm run tauri build -- --target universal-apple-darwin --bundles app,dmg

- name: Check the bundle
shell: bash
run: |
bundle=src-tauri/target/universal-apple-darwin/release/bundle
app=$(ls -d "$bundle"/macos/*.app)
archs=$(lipo -archs "$app/Contents/MacOS/stackql-workbench")
echo "Architectures: $archs"
[[ "$archs" == *arm64* && "$archs" == *x86_64* ]]
codesign --verify --deep --strict --verbose=2 "$app"
codesign --display --verbose=2 "$app"
ls -l "$bundle"/dmg

# The app must stand on its own too. Everything it links to has to be
# part of macOS: a system framework, or a library under /usr/lib. The
# page renderer is one of those frameworks, so there is nothing to ship
# with the app as there is on Windows.
- name: Check what the app asks the system for
shell: bash
run: |
bundle=src-tauri/target/universal-apple-darwin/release/bundle
app=$(ls -d "$bundle"/macos/*.app)
needed=$(otool -L "$app/Contents/MacOS/stackql-workbench" \
| grep -E '^[[:space:]]' | awk '{print $1}' | sort -u)
echo "$needed"
foreign=$(echo "$needed" | grep -v -E '^(/System/Library/|/usr/lib/)' || true)
if [ -n "$foreign" ]; then
echo "Not part of macOS:"
echo "$foreign"
exit 1
fi
# Nothing else is carried in the bundle that would have to be signed.
find "$app/Contents" -type f \( -name '*.dylib' -o -name '*.so' \) -print

# The pages need a renderer of a certain age, and on a Mac the renderer
# is the one that macOS has. The bundle names the oldest macOS it runs
# on, so an older one refuses to open it. Both halves of the executable
# must be built for that version as well.
- name: Check the oldest macOS the app runs on
shell: bash
run: |
bundle=src-tauri/target/universal-apple-darwin/release/bundle
app=$(ls -d "$bundle"/macos/*.app)
want=$(node -p "require('./src-tauri/tauri.conf.json').bundle.macOS.minimumSystemVersion")
declared=$(/usr/libexec/PlistBuddy -c 'Print :LSMinimumSystemVersion' "$app/Contents/Info.plist")
echo "Wanted: $want"
echo "Declared in Info.plist: $declared"
[ "$declared" = "$want" ]
built=$(otool -l "$app/Contents/MacOS/stackql-workbench" \
| awk '$1 == "minos" {print $2}' | sort -u)
echo "Built for: $built"
[ "$built" = "$want" ]

- uses: actions/upload-artifact@v7
with:
name: stackql-workbench-macos-universal
path: src-tauri/target/universal-apple-darwin/release/bundle/dmg/*.dmg
if-no-files-found: error

# The app on its own, for the StackQL PKG, which installs it beside the
# stackql command and signs what it ships. It is packed with tar because
# a bundle holds links and permissions that a zip of loose files loses.
- name: Pack the app for the installer
shell: bash
run: |
bundle=src-tauri/target/universal-apple-darwin/release/bundle
app=$(ls -d "$bundle"/macos/*.app)
mkdir -p installer-input
tar -czf installer-input/stackql-workbench-macos-universal.app.tar.gz \
-C "$(dirname "$app")" "$(basename "$app")"
cd installer-input
shasum -a 256 stackql-workbench-macos-universal.app.tar.gz \
> stackql-workbench-macos-universal.app.tar.gz.sha256
cat stackql-workbench-macos-universal.app.tar.gz.sha256
tar -tzf stackql-workbench-macos-universal.app.tar.gz | head -n 12

- uses: actions/upload-artifact@v7
with:
name: stackql-workbench-macos-universal-app
path: installer-input/*
if-no-files-found: error

# The executable the StackQL MSI installs beside stackql.exe. It is the
# optimised build, with no installer of its own, and it is not signed here:
# the StackQL release signs what it ships. Like the Mac build it does not
# wait for the checks.
#
# The MSI comes for x64 and for arm64, so there is one build for each, made
# on a runner of that processor. Nothing is built across.
build-windows:
name: Build (Windows, ${{ matrix.arch }})
runs-on: ${{ matrix.os }}
timeout-minutes: 60
strategy:
fail-fast: false
matrix:
include:
- arch: x64
os: windows-latest
- arch: arm64
os: windows-11-arm

steps:
- uses: actions/checkout@v7

- uses: actions/setup-node@v7
with:
node-version: 24
cache: npm

- uses: dtolnay/rust-toolchain@stable

# Kept apart from the cache of the checks, which hold a debug build.
- uses: Swatinem/rust-cache@v2
with:
workspaces: src-tauri
key: release

- name: Install webview dependencies
run: npm ci

- name: Build the executable
run: npm run tauri build -- --no-bundle

# The executable must stand on its own in the installer's folder. It
# carries its C runtime inside it, so what it asks the system for is
# Windows itself. This reads its import tables and fails on a runtime.
# It also fails when the executable is not built for this processor.
- name: Check what the executable asks the system for
run: node scripts/check-exe-imports.js src-tauri/target/release/stackql-workbench.exe ${{ matrix.arch }}

- name: Pack the executable for the installer
shell: pwsh
run: |
$exe = 'src-tauri/target/release/stackql-workbench.exe'
New-Item -ItemType Directory -Force installer-input | Out-Null
Copy-Item $exe installer-input/
$hash = (Get-FileHash installer-input/stackql-workbench.exe -Algorithm SHA256).Hash.ToLower()
"$hash stackql-workbench.exe" | Set-Content installer-input/stackql-workbench.exe.sha256
Get-Item installer-input/stackql-workbench.exe | Format-List Name, Length
Get-Content installer-input/stackql-workbench.exe.sha256

- uses: actions/upload-artifact@v7
with:
name: stackql-workbench-windows-${{ matrix.arch }}
path: installer-input/*
if-no-files-found: error
45 changes: 27 additions & 18 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,24 +1,33 @@
# Generated by Cargo
# will have compiled files and executables
debug
target
# Webview build output and dependencies
node_modules/
dist/
*.tsbuildinfo
.vitest/
coverage/

# These are backup files generated by rustfmt
# Host build output
target/
**/*.rs.bk

# MSVC Windows builds of rustc generate these, which store debugging information
*.pdb
rustc-ice-*.txt
src-tauri/gen/schemas/

# Generated by cargo mutants
# Contains mutation testing data
**/mutants.out*/
# Engine working files. The engine writes its cache under --approot and the
# MCP server writes logs to its working directory unless told otherwise.
.stackql/
.stackqlrc
stackql_mcp_server_*.log
logs/
*.log

# rustc will dump stack traces when hitting an internal compiler error to PWD
rustc-ice-*.txt
# Secrets and local environment. Never commit these.
.env
.env.*
!.env.example

# RustRover
# JetBrains specific template is maintained in a separate JetBrains.gitignore that can
# be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
# and can be added to the global gitignore or merged into this file. For a more nuclear
# option (not recommended) you can uncomment the following to ignore the entire idea folder.
#.idea/
# Editors and OS
.idea/
.vscode/*
!.vscode/extensions.json
.DS_Store
Thumbs.db
11 changes: 11 additions & 0 deletions .prettierignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
dist/
coverage/
node_modules/
package-lock.json
src-tauri/target/
src-tauri/gen/
src-tauri/icons/
# Authored docs keep their own layout.
*.md
# A verbatim copy of an upstream file.
src-tauri/src/icons/providers.snapshot.json
4 changes: 4 additions & 0 deletions .prettierrc.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
{
"singleQuote": true,
"printWidth": 100
}
Loading
Loading