From 5ad7a9cc75ef1f6dc2fa2ac163f20948419b9e36 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 1 Jul 2026 17:03:23 +0000
Subject: [PATCH] CI: run typecheck, lint & Vitest suites on pull requests

Add a CI workflow that runs the quality gates on pull requests and on
pushes to main. Separate jobs (typecheck, lint, test-web, test-cli) run
in parallel so failures are isolated, each performing the common setup
(checkout, pnpm, Node from .nvmrc, frozen install) then its one command.

The lint job is guarded: the repo currently ships no ESLint config, so
`next lint` would prompt interactively and hang CI. When no config is
present the job emits a warning and passes instead of hanging; it lints
normally once an ESLint config and deps are added.

Closes #33

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01T9z5V7UM3FhqomggQ3XTVG
---
 .github/workflows/ci.yml | 106 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 106 insertions(+)
 create mode 100644 .github/workflows/ci.yml

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 0000000..5856c36
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,106 @@
+name: CI
+
+on:
+  pull_request:
+    paths-ignore:
+      - '**/*.md'
+      - 'docs/**'
+  push:
+    branches: [main]
+    paths-ignore:
+      - '**/*.md'
+      - 'docs/**'
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  typecheck:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: '.nvmrc'
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Typecheck
+        run: pnpm typecheck
+
+  lint:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: '.nvmrc'
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      # `next lint` prompts interactively to configure ESLint when no ESLint
+      # config or eslint deps are present in the repo, which would hang CI.
+      # The repo currently ships no ESLint config, so guard the lint step:
+      # run it only when a config exists, otherwise emit a warning and pass
+      # (rather than hang, or fail every PR over a pre-existing gap that is
+      # out of scope for this workflow). Once an ESLint config + the eslint /
+      # eslint-config-next devDependencies are added, this job lints normally.
+      - name: Lint
+        run: |
+          if ls .eslintrc* eslint.config.* >/dev/null 2>&1; then
+            echo "ESLint config found; running lint."
+            pnpm lint
+          else
+            echo "::warning title=Lint skipped::No ESLint config found (.eslintrc* / eslint.config.*). \`next lint\` would prompt interactively to set up ESLint. Add an ESLint config and the eslint / eslint-config-next devDependencies to enable this gate."
+          fi
+
+  test-web:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: '.nvmrc'
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Run web test suite
+        run: pnpm test:web
+
+  test-cli:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: '.nvmrc'
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Run CLI test suite
+        run: pnpm test:cli