ci: add github workflows and commitlint

Author: vr16x

.github/actions/install-dependencies/action.yml

@@ -0,0 +1,13 @@
+name: Install Dependencies
+description: Setup Bun and install dependencies with frozen lockfile
+
+runs:
+  using: composite
+  steps:
+    - uses: oven-sh/setup-bun@v2
+      with:
+        bun-version: latest
+
+    - name: Install dependencies
+      shell: bash
+      run: bun install --frozen-lockfile

.github/workflows/build.yml

@@ -0,0 +1,25 @@
+name: Build
+
+on:
+  workflow_dispatch:
+  push:
+  pull_request:
+    types: [opened, reopened, synchronize, ready_for_review]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    name: TypeScript
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install dependencies
+        uses: ./.github/actions/install-dependencies
+
+      - name: Build
+        run: bun run build

.github/workflows/lint.yml

@@ -0,0 +1,25 @@
+name: Lint
+
+on:
+  workflow_dispatch:
+  push:
+  pull_request:
+    types: [opened, reopened, synchronize, ready_for_review]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Biome
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install dependencies
+        uses: ./.github/actions/install-dependencies
+
+      - name: Check
+        run: bun run check

.github/workflows/pr-lint.yml

@@ -0,0 +1,19 @@
+name: PR Lint
+
+on:
+  pull_request:
+    types: [opened, reopened, synchronize, ready_for_review, edited]
+
+jobs:
+  pr-lint:
+    name: Commitlint
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install dependencies
+        uses: ./.github/actions/install-dependencies
+
+      - name: Lint PR title
+        run: echo "${{ github.event.pull_request.title }}" | bun commitlint

.github/workflows/test.yml

@@ -0,0 +1,25 @@
+name: Test
+
+on:
+  workflow_dispatch:
+  push:
+  pull_request:
+    types: [opened, reopened, synchronize, ready_for_review]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: Vitest
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install dependencies
+        uses: ./.github/actions/install-dependencies
+
+      - name: Test
+        run: bun run test

CLAUDE.md

@@ -9,6 +9,28 @@ Default to using Bun instead of Node.js.
 - Bun automatically loads .env, so don't use dotenv.
 
 
+## Code Style
+
+Always refer to `biome.json` for coding style rules — indentation, quotes, semicolons, import order, and lint rules are all defined there. Do not deviate from them.
+
+After writing or modifying any code, always run:
+
+```bash
+bun run check
+```
+
+This formats and lints in one pass. Fix any errors before considering the task done.
+
+## Build
+
+After writing or modifying any code, always run:
+
+```bash
+bun run build
+```
+
+Resolve any TypeScript errors before finishing. Do not leave the build in a broken state.
+
 ## Documentation
 
 Always use Context7 (`mcp__context7__resolve-library-id` + `mcp__context7__query-docs`) for library/API documentation, code generation, and setup or configuration steps without waiting for an explicit ask.

bun.lock

@@ -0,0 +1,7 @@
+import type { UserConfig } from '@commitlint/types';
+
+const config: UserConfig = {
+  extends: ['@commitlint/config-conventional'],
+};
+
+export default config;

commitlint.config.ts

@@ -6,12 +6,16 @@
     "lint": "biome lint --write .",
     "format": "biome format --write .",
     "check": "biome check --write .",
+    "build": "tsc --noEmit",
+    "test": "vitest run",
     "release": "changeset publish",
     "version": "changeset version"
   },
   "devDependencies": {
     "@biomejs/biome": "2.4.9",
     "@changesets/cli": "2.30.0",
+    "@commitlint/cli": "^20.5.0",
+    "@commitlint/config-conventional": "^20.5.0",
     "@types/bun": "latest",
     "vitest": "^4.1.2"
   },