refactor: rebrand sqlopt → dbopt (closes #6) + installers, gates, repo hygiene

Brand the whole product dbopt — no more sqlopt:
- Binaries: dbopt, dbopt-backend, dbopt-sentinel, dbopt-eval.
- Env vars SQLOPT_* → DBOPT_*; data dir ~/.sqlopt → ~/.dbopt; localStorage
  namespace sqlopt.* → dbopt.*. Non-breaking migration shims for the two that
  hold live data: localStorage reads through to the old keys once; the sentinel
  data dir falls back to ~/.sqlopt if ~/.dbopt doesn't exist yet.

Installers (closes part of #7):
- One-line install.sh (Linux + macOS Apple Silicon) and install.ps1 (Windows),
  served from dbopt.org. README/landing lead with downloads (.msi/.dmg/.AppImage),
  not git clone. Dropped Intel macOS (untested). Best-effort Windows MSI in CI.

CI gates: added `cargo test --workspace` alongside the eval F1 ≥ 0.95 gate.

Repo hygiene: removed committed binaries (release tarball + staging/) and added
a .gitignore so build/release artifacts are never committed again.

Docs: new docs/USAGE.md (detailed how-to). Verified end-to-end: web + cargo
build, cargo test, eval F1 = 1.000, backend boots on :3690, and the data-dir
shim keeps the existing ~/.sqlopt monitoring data.

Author: sqlopt

.github/workflows/ci.yml

@@ -21,8 +21,10 @@ jobs:
         continue-on-error: true
       - name: build
         run: cargo build --workspace --release
-      - name: eval (target F1 ≥ 0.95)
-        run: ./target/release/sqlopt-eval --target 0.95
+      - name: test (unit + HTTP integration) · gate
+        run: cargo test --workspace --release
+      - name: eval (F1 ≥ 0.95) · gate
+        run: ./target/release/dbopt-eval --target 0.95
 
   web:
     runs-on: ubuntu-latest

.github/workflows/release.yml

@@ -49,7 +49,6 @@ jobs:
       matrix:
         include:
           - { label: linux-x86_64, os: ubuntu-latest,  target: x86_64-unknown-linux-gnu,  archive: tar.gz,  binsuffix: ''     }
-          - { label: macos-x86_64, os: macos-13,       target: x86_64-apple-darwin,       archive: tar.gz,  binsuffix: ''     }
           - { label: macos-arm64,  os: macos-latest,   target: aarch64-apple-darwin,      archive: tar.gz,  binsuffix: ''     }
           - { label: windows-x86_64, os: windows-latest, target: x86_64-pc-windows-msvc,  archive: zip,     binsuffix: '.exe' }
     steps:
@@ -69,82 +68,84 @@ jobs:
         shell: bash
         run: |
           mkdir -p staging
-          cp target/${{ matrix.target }}/release/sqlopt-backend${{ matrix.binsuffix }} staging/sqlopt${{ matrix.binsuffix }}
+          cp target/${{ matrix.target }}/release/dbopt-backend${{ matrix.binsuffix }} staging/dbopt${{ matrix.binsuffix }}
           cp README.md staging/ 2>/dev/null || true
           cp samples/bad.sql staging/sample.sql 2>/dev/null || true
       - name: archive
         shell: bash
         run: |
           cd staging
           if [ "${{ matrix.archive }}" = "zip" ]; then
-            7z a ../sqlopt-${{ matrix.label }}.zip ./*
+            7z a ../dbopt-${{ matrix.label }}.zip ./*
           else
-            tar czf ../sqlopt-${{ matrix.label }}.tar.gz ./*
+            tar czf ../dbopt-${{ matrix.label }}.tar.gz ./*
           fi
       - name: macos dmg
         if: startsWith(matrix.label, 'macos-')
         run: |
           VER="${{ github.event.inputs.tag || github.ref_name }}"
           VER="${VER#v}"          # strip leading v from e.g. v0.2.0
           VER="${VER:-0.0.0}"     # fall back if somehow empty
-          mkdir -p sqlopt-${{ matrix.label }}-app/sqlopt.app/Contents/MacOS
-          cp staging/sqlopt sqlopt-${{ matrix.label }}-app/sqlopt.app/Contents/MacOS/sqlopt
-          chmod +x sqlopt-${{ matrix.label }}-app/sqlopt.app/Contents/MacOS/sqlopt
-          cat > sqlopt-${{ matrix.label }}-app/sqlopt.app/Contents/Info.plist <<EOF
+          mkdir -p dbopt-${{ matrix.label }}-app/dbopt.app/Contents/MacOS
+          cp staging/dbopt dbopt-${{ matrix.label }}-app/dbopt.app/Contents/MacOS/dbopt
+          chmod +x dbopt-${{ matrix.label }}-app/dbopt.app/Contents/MacOS/dbopt
+          cat > dbopt-${{ matrix.label }}-app/dbopt.app/Contents/Info.plist <<EOF
           <?xml version="1.0" encoding="UTF-8"?>
           <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
           <plist version="1.0"><dict>
-            <key>CFBundleExecutable</key><string>sqlopt</string>
-            <key>CFBundleIdentifier</key><string>dev.sqlopt.observatory</string>
-            <key>CFBundleName</key><string>sqlopt</string>
+            <key>CFBundleExecutable</key><string>dbopt</string>
+            <key>CFBundleIdentifier</key><string>dev.dbopt.observatory</string>
+            <key>CFBundleName</key><string>dbopt</string>
             <key>CFBundlePackageType</key><string>APPL</string>
             <key>CFBundleShortVersionString</key><string>${VER}</string>
             <key>CFBundleVersion</key><string>1</string>
             <key>NSHighResolutionCapable</key><true/>
           </dict></plist>
           EOF
-          hdiutil create -volname sqlopt -srcfolder sqlopt-${{ matrix.label }}-app -ov -format UDZO sqlopt-${{ matrix.label }}.dmg
-      - name: windows installer (NSIS-free zip)
+          hdiutil create -volname dbopt -srcfolder dbopt-${{ matrix.label }}-app -ov -format UDZO dbopt-${{ matrix.label }}.dmg
+      - name: windows MSI (best-effort)
         if: matrix.label == 'windows-x86_64'
-        shell: bash
+        continue-on-error: true
+        shell: pwsh
         run: |
-          # The .exe IS the installer: double-click runs the server + opens the browser.
-          # No actual installation step needed because there are no extra files.
-          echo "windows artifact is the zipped portable .exe"
+          cargo install cargo-wix --locked
+          cargo wix init -p backend --force
+          cargo wix -p backend --no-build --target ${{ matrix.target }} --nocapture --output dbopt-windows-x86_64.msi
       - name: linux AppImage (best-effort)
         if: matrix.label == 'linux-x86_64'
         run: |
-          mkdir -p sqlopt.AppDir/usr/bin
-          cp staging/sqlopt sqlopt.AppDir/usr/bin/sqlopt
-          chmod +x sqlopt.AppDir/usr/bin/sqlopt
-          cat > sqlopt.AppDir/sqlopt.desktop <<EOF
+          mkdir -p dbopt.AppDir/usr/bin
+          cp staging/dbopt dbopt.AppDir/usr/bin/dbopt
+          chmod +x dbopt.AppDir/usr/bin/dbopt
+          cat > dbopt.AppDir/dbopt.desktop <<EOF
           [Desktop Entry]
           Type=Application
-          Name=sqlopt
-          Exec=sqlopt
-          Icon=sqlopt
+          Name=dbopt
+          Exec=dbopt
+          Icon=dbopt
           Categories=Development;Database;
           Terminal=true
           EOF
-          touch sqlopt.AppDir/sqlopt.png
-          cat > sqlopt.AppDir/AppRun <<'EOF'
+          touch dbopt.AppDir/dbopt.png
+          cat > dbopt.AppDir/AppRun <<'EOF'
           #!/bin/sh
           HERE="$(dirname "$(readlink -f "${0}")")"
-          exec "${HERE}/usr/bin/sqlopt" "$@"
+          exec "${HERE}/usr/bin/dbopt" "$@"
           EOF
-          chmod +x sqlopt.AppDir/AppRun
+          chmod +x dbopt.AppDir/AppRun
           curl -L -o appimagetool https://github.com/AppImage/AppImageKit/releases/download/continuous/appimagetool-x86_64.AppImage || true
           chmod +x appimagetool || true
-          ARCH=x86_64 ./appimagetool sqlopt.AppDir sqlopt-linux-x86_64.AppImage || \
+          ARCH=x86_64 ./appimagetool dbopt.AppDir dbopt-linux-x86_64.AppImage || \
             echo "AppImage build skipped (appimagetool unavailable)"
       - uses: actions/upload-artifact@v4
         with:
-          name: sqlopt-${{ matrix.label }}
+          name: dbopt-${{ matrix.label }}
           path: |
-            sqlopt-${{ matrix.label }}.tar.gz
-            sqlopt-${{ matrix.label }}.zip
-            sqlopt-${{ matrix.label }}.dmg
-            sqlopt-linux-x86_64.AppImage
+            dbopt-${{ matrix.label }}.tar.gz
+            dbopt-${{ matrix.label }}.zip
+            dbopt-${{ matrix.label }}.dmg
+            dbopt-windows-x86_64.msi
+            dbopt-linux-x86_64.AppImage
           if-no-files-found: ignore
 
   release:
@@ -159,7 +160,7 @@ jobs:
       - name: stage flat
         run: |
           mkdir -p out
-          find artifacts -type f \( -name '*.tar.gz' -o -name '*.zip' -o -name '*.dmg' -o -name '*.AppImage' \) -exec cp {} out/ \;
+          find artifacts -type f \( -name '*.tar.gz' -o -name '*.zip' -o -name '*.dmg' -o -name '*.msi' -o -name '*.AppImage' \) -exec cp {} out/ \;
           (cd out && sha256sum * > SHA256SUMS)
           ls -la out
       - name: gh release

.gitignore

@@ -1,11 +1,25 @@
-target/
+# Rust
+/target/
+
+# Node / web
 node_modules/
-dist/
+web/dist/
 web/src/wasm/
-*.log
-.env
+
+# Build & release artifacts — publish via GitHub Releases, never commit
+*.tar.gz
+*.zip
+*.dmg
+*.AppImage
+*.msi
+
+# Local scratch / render previews
+web/_*.mjs
+web/_*.png
+web/public/_*
+
+# OS / editor
 .DS_Store
 
-# Local Claude Code session data
-.claude/
-web/tsconfig.tsbuildinfo
+# TS build cache
+*.tsbuildinfo

CONTRIBUTING.md

@@ -84,6 +84,6 @@ positive and a negative scenario.
 
 - Keep new code in the style of the surrounding file (the analyzer is
   deliberately dependency-light and token-level).
-- Commits in this repo use a PII-free signature (`sqlopt <sqlopt@localhost>`).
+- Commits in this repo use a PII-free signature (`dbopt <dbopt@localhost>`).
 - See `docs/ROADMAP.md` for the multi-engine direction before adding
   engine-specific work.

README.md

@@ -19,8 +19,9 @@
 
 <p align="center">
   <a href="https://dbopt.org"><b>dbopt.org</b></a>
+  &nbsp;·&nbsp; <a href="docs/USAGE.md">Usage guide</a>
   &nbsp;·&nbsp; <a href="docs/WHO-IS-DBOPT-FOR.md">Who it's for</a>
-  &nbsp;·&nbsp; <a href="docs/ACCESS.md">Access &amp; permissions</a>
+  &nbsp;·&nbsp; <a href="docs/ACCESS.md">Access</a>
   &nbsp;·&nbsp; <a href="docs/ROADMAP-TO-COMPLETE.md">Roadmap</a>
 </p>
 
@@ -43,16 +44,26 @@ cloud model.
 
 ## Download
 
-Prebuilt — **no toolchain needed**. Grab the installer for your OS:
+**Install in one line** (no toolchain needed):
+
+```bash
+# Linux & macOS (Apple Silicon)
+curl -fsSL https://dbopt.org/install.sh | sh
+```
+```powershell
+# Windows (PowerShell)
+irm https://dbopt.org/install.ps1 | iex
+```
+
+…or grab an installer directly:
 
 | Platform | Download |
 |---|---|
-| **Windows** (x64) | **[portable `.zip`](https://github.com/singhpratech/dbopt/releases/latest/download/sqlopt-windows-x86_64.zip)** |
-| **macOS** (Apple Silicon) | **[`.dmg`](https://github.com/singhpratech/dbopt/releases/latest/download/sqlopt-macos-arm64.dmg)** |
-| **macOS** (Intel) | **[`.dmg`](https://github.com/singhpratech/dbopt/releases/latest/download/sqlopt-macos-x86_64.dmg)** |
-| **Linux** (x64) | **[`.AppImage`](https://github.com/singhpratech/dbopt/releases/latest/download/sqlopt-linux-x86_64.AppImage)** · [`.tar.gz`](https://github.com/singhpratech/dbopt/releases/latest/download/sqlopt-linux-x86_64.tar.gz) |
+| **Windows** (x64) | **[`.msi`](https://github.com/singhpratech/dbopt/releases/latest/download/dbopt-windows-x86_64.msi)** · [portable `.zip`](https://github.com/singhpratech/dbopt/releases/latest/download/dbopt-windows-x86_64.zip) |
+| **macOS** (Apple Silicon) | **[`.dmg`](https://github.com/singhpratech/dbopt/releases/latest/download/dbopt-macos-arm64.dmg)** |
+| **Linux** (x64) | **[`.AppImage`](https://github.com/singhpratech/dbopt/releases/latest/download/dbopt-linux-x86_64.AppImage)** · [`.tar.gz`](https://github.com/singhpratech/dbopt/releases/latest/download/dbopt-linux-x86_64.tar.gz) |
 
-Each is a **single self-contained binary** (the web UI is embedded) — run it, then open `http://127.0.0.1:3690`. Checksums and all builds on the [releases page](https://github.com/singhpratech/dbopt/releases).
+Each is a **single self-contained binary** (the web UI is embedded) — run it, then open `http://127.0.0.1:3690`. New to dbopt? See the **[Usage guide](docs/USAGE.md)**. Checksums and all builds are on the [releases page](https://github.com/singhpratech/dbopt/releases).
 
 ## Why it exists
 
@@ -114,14 +125,14 @@ cd web && npm install && npm run build && cd ..
 cargo build --release
 
 # 1) Analyze a script statically — no DB connection needed
-./target/release/sqlopt path/to/query.sql
+./target/release/dbopt path/to/query.sql
 
 # 2) Run the web observatory (UI + API on :3690)
-./target/release/sqlopt-backend          # then open http://127.0.0.1:3690
+./target/release/dbopt-backend          # then open http://127.0.0.1:3690
 
 # 3) Continuous monitoring (SQL auth via env)
-SQLOPT_SERVER="host,1433" SQLOPT_USER="..." SQLOPT_PASSWORD="..." \
-  ./target/release/sqlopt-sentinel run
+DBOPT_SERVER="host,1433" DBOPT_USER="..." DBOPT_PASSWORD="..." \
+  ./target/release/dbopt-sentinel run
 ```
 
 For UI development: `cd web && npm install && npm run dev` (proxies the API to the backend on :3690).
@@ -147,13 +158,13 @@ A Rust workspace plus a React / Vite / TypeScript front end:
 |---|---|
 | `analyzer-core` | the rule engine + tokenizer + plan/DMV models |
 | `analyzer-wasm` | WebAssembly bindings for in-browser analysis |
-| `analyzer-cli`  | `sqlopt` — analyze a `.sql` / `.sqlplan` / bundle from the shell |
-| `backend`       | `sqlopt-backend` — axum API + embedded web UI, LLM proxy, durable logs |
-| `sentinel`      | `sqlopt-sentinel` — continuous DMV poller → SQLite → pain report |
+| `analyzer-cli`  | `dbopt` — analyze a `.sql` / `.sqlplan` / bundle from the shell |
+| `backend`       | `dbopt-backend` — axum API + embedded web UI, LLM proxy, durable logs |
+| `sentinel`      | `dbopt-sentinel` — continuous DMV poller → SQLite → pain report |
 | `eval`          | the rule-quality harness (precision / recall / F1 + HTML report) |
 | `web/`          | the "observatory" UI (analysis, plans, charts, AI, monitoring) |
 
-Storage and config live under `~/.sqlopt/` (override with `SQLOPT_DATA_DIR`). No external services required.
+Storage and config live under `~/.dbopt/` (override with `DBOPT_DATA_DIR`). No external services required.
 
 ## Roadmap — one brand, every engine
 

crates/analyzer-cli/Cargo.toml

@@ -5,7 +5,7 @@ edition.workspace = true
 license.workspace = true
 
 [[bin]]
-name = "sqlopt"
+name = "dbopt"
 path = "src/main.rs"
 
 [dependencies]

crates/analyzer-cli/src/main.rs

@@ -20,7 +20,7 @@ fn main() -> anyhow::Result<()> {
             input.sql = Some(body);
         }
     } else {
-        eprintln!("usage: sqlopt <file.sql | file.sqlplan | bundle.json> | sqlopt --stdin");
+        eprintln!("usage: dbopt <file.sql | file.sqlplan | bundle.json> | dbopt --stdin");
         std::process::exit(2);
     }
 

crates/backend/Cargo.toml

@@ -5,7 +5,7 @@ edition.workspace = true
 license.workspace = true
 
 [[bin]]
-name = "sqlopt-backend"
+name = "dbopt-backend"
 path = "src/main.rs"
 
 [dependencies]

crates/backend/src/logs.rs

@@ -1,7 +1,7 @@
 //! Durable log endpoints (AI interactions + analysis history).
 //!
 //! Storage shares the same SQLite file the sentinel daemon writes to
-//! (`~/.sqlopt/sentinel.db`), so logs survive backend restarts and browser
+//! (`~/.dbopt/sentinel.db`), so logs survive backend restarts and browser
 //! cache clears. The schema lives in sentinel/migrations/0003_logs.sql.
 
 use axum::{extract::Query, http::StatusCode, response::IntoResponse, Json};

crates/backend/src/main.rs

@@ -51,7 +51,7 @@ async fn main() -> anyhow::Result<()> {
 
     // Open the user's browser (best effort) once the listener is ready.
     let url_for_open = url.clone();
-    let no_open = std::env::var("SQLOPT_NO_OPEN").is_ok();
+    let no_open = std::env::var("DBOPT_NO_OPEN").is_ok();
     tokio::spawn(async move {
         // Tiny delay so axum is definitely accepting before we hand the URL to the browser.
         tokio::time::sleep(std::time::Duration::from_millis(250)).await;
@@ -80,12 +80,12 @@ fn print_banner(url: &str, port: u16) {
     let green = "\x1b[38;2;212;255;78m";
     let reset = "\x1b[0m";
     eprintln!();
-    eprintln!("{green}{bold}▣ sqlopt{reset} {dim}/ observatory{reset}");
+    eprintln!("{green}{bold}▣ dbopt{reset} {dim}/ observatory{reset}");
     eprintln!("{dim}  SQL Server static + plan + DMV analyzer · Rust + WASM{reset}");
     eprintln!();
     eprintln!("  {bold}{green}  →  {url}  {reset}");
     eprintln!();
-    eprintln!("{dim}  port {port}  ·  set SQLOPT_NO_OPEN=1 to skip auto-browser{reset}");
+    eprintln!("{dim}  port {port}  ·  set DBOPT_NO_OPEN=1 to skip auto-browser{reset}");
     eprintln!("{dim}  press ctrl-c to stop{reset}");
     eprintln!();
 }