ci: add CI/CD pipeline, semantic versioning, and npm publishing

.github/workflows/ci.yml

@@ -0,0 +1,31 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - run: bun install --frozen-lockfile
+
+      - name: Lint
+        run: bunx biome check src/ tests/ scripts/
+
+      - name: Type check
+        run: bunx tsc --noEmit
+
+      - name: Test
+        run: bun test
+
+      - name: Build
+        run: bun run build

.github/workflows/release.yml

@@ -0,0 +1,40 @@
+name: Release
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+  id-token: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - run: bun install --frozen-lockfile
+
+      - name: Build
+        run: bun run build
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          registry-url: https://registry.npmjs.org
+
+      - name: Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: bunx semantic-release

.husky/commit-msg

@@ -0,0 +1 @@
+bunx --no -- commitlint --edit ${1}

.husky/pre-commit

@@ -0,0 +1 @@
+bun run lint && bun run typecheck && bun test

.releaserc.json

@@ -0,0 +1,17 @@
+{
+	"branches": ["main"],
+	"plugins": [
+		"@semantic-release/commit-analyzer",
+		"@semantic-release/release-notes-generator",
+		["@semantic-release/changelog", { "changelogFile": "CHANGELOG.md" }],
+		"@semantic-release/npm",
+		[
+			"@semantic-release/git",
+			{
+				"assets": ["CHANGELOG.md", "package.json"],
+				"message": "chore(release): ${nextRelease.version} [skip ci]"
+			}
+		],
+		"@semantic-release/github"
+	]
+}

CLAUDE.md

@@ -64,13 +64,47 @@ scripts/
 
 ## Commands
 
+- `bun run build` — Compile TypeScript to `dist/` (JS + declarations + source maps)
 - `bun test` — Run all tests (75 tests, ~1.3s)
+- `bun run lint` — Lint with Biome
+- `bun run lint:fix` — Auto-fix lint issues
+- `bun run typecheck` — Type check without emitting
 - `bun scripts/e2e-live.ts` — Live e2e against local vLLM (default)
 - `PROVIDER=openai OPENAI_API_KEY=... bun scripts/e2e-live.ts` — Against OpenAI
 - `PROVIDER=anthropic ANTHROPIC_API_KEY=... bun scripts/e2e-live.ts` — Against Anthropic
-- `bunx biome check src/ tests/ scripts/` — Lint
-- `bunx biome check --write src/ tests/ scripts/` — Auto-fix lint
-- `bunx tsc --noEmit` — Type check
+
+## Commit Conventions
+
+This project uses **Conventional Commits** enforced by commitlint. Every commit message must follow this format:
+
+```
+type(scope): description
+```
+
+**Types:** `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `revert`
+
+- `feat` — new feature (triggers minor version bump)
+- `fix` — bug fix (triggers patch version bump)
+- `feat!` or `fix!` or `BREAKING CHANGE:` in footer — triggers major version bump
+- All other types — no version bump
+
+**Rules:**
+- Type is required, scope is optional
+- Description must be lowercase, no period at end
+- Keep the subject line under 100 characters
+- Use the body for additional context when needed
+
+**Examples:**
+```
+feat: add openrouter provider support
+fix(anthropic): handle empty content blocks in response
+refactor: extract shared action parser from providers
+test: add budget enforcement edge cases
+chore(deps): bump openai sdk to v7
+feat!: remove deprecated setRules API
+```
+
+**Versioning:** Handled automatically by semantic-release on main. Never manually edit the version in package.json.
 
 ## Code Style
 

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cahaseler
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.