ci: establish development tooling and CI baseline (issue #17)

Author: thundermiracle

.github/workflows/ci.yml

@@ -7,7 +7,7 @@ on:
       - main
 
 jobs:
-  test:
+  web-quality:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
@@ -27,5 +27,42 @@ jobs:
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
 
-      - name: Run unit tests
-        run: pnpm test
+      - name: Run lint + test + build (web)
+        run: pnpm run ci:web
+
+  rust-quality:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10.30.3
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Setup Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+
+      - name: Install Linux dependencies for Tauri
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y \
+            libwebkit2gtk-4.1-dev \
+            libappindicator3-dev \
+            librsvg2-dev \
+            patchelf
+
+      - name: Run fmt + lint + test (rust)
+        run: pnpm run ci:rust

README.md

@@ -17,9 +17,14 @@ Tauri 2 + React/TypeScript desktop foundation for managing MCP and Skills across
 - Desktop production build: `pnpm tauri:build`
 - TypeScript lint + typecheck: `pnpm run lint:ts`
 - Rust lint: `pnpm run lint:rust`
+- Rust format check: `pnpm run fmt:rust`
+- Rust unit tests: `pnpm run test:rust`
 - Full lint checks: `pnpm run lint`
 - Pre-commit verification (lint + unit tests): `pnpm check`
 - Unit tests: `pnpm test`
+- CI-equivalent web gate: `pnpm run ci:web`
+- CI-equivalent rust gate: `pnpm run ci:rust`
+- Full CI-equivalent gate: `pnpm run ci`
 
 ## Project Structure
 
@@ -40,5 +45,6 @@ Tauri 2 + React/TypeScript desktop foundation for managing MCP and Skills across
 - The frontend command runner calls typed placeholder backend commands: `detect_clients`, `list_resources`, and `mutate_resource`.
 - Command responses use a shared envelope (`ok`, `data`, `error`, `meta`) with lifecycle and operation metadata.
 - Backend commands are thin boundaries and delegate to `AdapterService` through `AdapterRegistry`.
+- CI runs separate `web-quality` and `rust-quality` jobs on pull requests and pushes to `main`.
 - `src-tauri/tauri.conf.json` is configured to use `pnpm` for both dev and build hooks.
 - `scripts/ensure-tauri-icon.mjs` generates the required Tauri icon in clean environments.

package.json

@@ -12,10 +12,15 @@
     "pretauri:dev": "pnpm run ensure:tauri-icon && pnpm dev",
     "pretauri:build": "pnpm run ensure:tauri-icon && pnpm build",
     "typecheck": "tsc --noEmit",
+    "fmt:rust": "cargo fmt --manifest-path src-tauri/Cargo.toml -- --check",
+    "test:rust": "cargo test --manifest-path src-tauri/Cargo.toml",
     "lint:ts": "pnpm run typecheck && biome check .",
     "lint:rust": "pnpm run ensure:tauri-icon && cargo clippy --workspace --all-targets --manifest-path src-tauri/Cargo.toml -- -D warnings",
     "lint": "pnpm run lint:ts && pnpm run lint:rust",
     "check": "pnpm run lint && pnpm test",
+    "ci:web": "pnpm run lint:ts && pnpm test && pnpm run build",
+    "ci:rust": "pnpm run ensure:tauri-icon && pnpm run fmt:rust && pnpm run lint:rust && pnpm run test:rust",
+    "ci": "pnpm run ci:web && pnpm run ci:rust",
     "dev": "vite",
     "build": "pnpm run typecheck && vite build",
     "preview": "vite preview",

rust-toolchain.toml

@@ -0,0 +1,4 @@
+[toolchain]
+channel = "stable"
+profile = "minimal"
+components = ["clippy", "rustfmt"]

tests/ci-baseline.test.mjs

@@ -0,0 +1,31 @@
+import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
+import test from "node:test";
+
+const ciWorkflow = readFileSync(new URL("../.github/workflows/ci.yml", import.meta.url), "utf8");
+const packageJson = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+const rustToolchain = readFileSync(new URL("../rust-toolchain.toml", import.meta.url), "utf8");
+
+test("ci workflow defines separate web and rust quality jobs", () => {
+  assert.match(ciWorkflow, /^\s{2}web-quality:/m);
+  assert.match(ciWorkflow, /^\s{2}rust-quality:/m);
+  assert.match(ciWorkflow, /run: pnpm run ci:web/);
+  assert.match(ciWorkflow, /run: pnpm run ci:rust/);
+});
+
+test("ci workflow installs node and rust toolchains deterministically", () => {
+  assert.match(ciWorkflow, /node-version: 24/);
+  assert.match(ciWorkflow, /uses: dtolnay\/rust-toolchain@stable/);
+  assert.match(ciWorkflow, /components: rustfmt, clippy/);
+});
+
+test("package scripts expose ci entry points for local reproduction", () => {
+  assert.equal(typeof packageJson.scripts["ci:web"], "string");
+  assert.equal(typeof packageJson.scripts["ci:rust"], "string");
+  assert.equal(typeof packageJson.scripts.ci, "string");
+});
+
+test("rust toolchain file pins baseline channel and required components", () => {
+  assert.match(rustToolchain, /^channel = "stable"$/m);
+  assert.match(rustToolchain, /^components = \["clippy", "rustfmt"\]$/m);
+});

tests/tauri-bootstrap.test.mjs

@@ -24,10 +24,15 @@ test("package scripts expose desktop and frontend bootstrap commands", () => {
   assert.equal(typeof packageJson.scripts["pretauri:dev"], "string");
   assert.equal(typeof packageJson.scripts["pretauri:build"], "string");
   assert.equal(typeof packageJson.scripts.typecheck, "string");
+  assert.equal(typeof packageJson.scripts["fmt:rust"], "string");
+  assert.equal(typeof packageJson.scripts["test:rust"], "string");
   assert.equal(typeof packageJson.scripts["lint:ts"], "string");
   assert.equal(typeof packageJson.scripts["lint:rust"], "string");
   assert.equal(typeof packageJson.scripts.lint, "string");
   assert.equal(typeof packageJson.scripts.check, "string");
+  assert.equal(typeof packageJson.scripts["ci:web"], "string");
+  assert.equal(typeof packageJson.scripts["ci:rust"], "string");
+  assert.equal(typeof packageJson.scripts.ci, "string");
   assert.ok(packageJson.scripts["lint:ts"].includes("biome check ."));
   assert.ok(packageJson.scripts["lint:rust"].includes("ensure:tauri-icon"));
 });