improve: add CI workflow and expand README with API docs

Author: mikecovlee

.github/workflows/ci.yml

@@ -0,0 +1,52 @@
+name: CI
+
+on:
+  push:
+    branches: [master, main, improve/*]
+  pull_request:
+    branches: [master, main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    name: "${{ matrix.os }}"
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-24.04, macos-15, windows-2022]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+        with:
+          submodules: recursive
+
+      - name: Set platform
+        id: platform
+        shell: bash
+        run: |
+          case "${{ runner.os }}" in
+            Linux)   echo "os=ubuntu" >> $GITHUB_OUTPUT; echo "arch=x86_64" >> $GITHUB_OUTPUT ;;
+            macOS)   echo "os=macos" >> $GITHUB_OUTPUT; echo "arch=arm64" >> $GITHUB_OUTPUT ;;
+            Windows) echo "os=windows" >> $GITHUB_OUTPUT; echo "arch=x86_64" >> $GITHUB_OUTPUT ;;
+          esac
+
+      - name: Download CovScript SDK
+        shell: bash
+        run: |
+          OS="${{ steps.platform.outputs.os }}"
+          ARCH="${{ steps.platform.outputs.arch }}"
+          URL="https://github.com/covscript/csbuild/releases/download/${OS}-schedule/covscript-${OS}-${ARCH}.7z"
+          curl -fsSL "$URL" -o sdk.7z
+          7z x sdk.7z -y
+          echo "CS_DEV_PATH=$(pwd)/build" >> $GITHUB_ENV
+
+      - name: Configure
+        run: cmake -S . -B cmake-build
+
+      - name: Build
+        run: cmake --build cmake-build

README.md

@@ -1,2 +1,40 @@
 # covscript-sqlite
-Covariant Script SQLite Extension
+
+SQLite3 database bindings for Covariant Script.
+
+## Dependencies
+
+- [Covariant Script](https://github.com/covscript/covscript)
+- SQLite3 (bundled as amalgamation)
+
+## Build
+
+```bash
+mkdir build && cd build
+cmake ..
+cmake --build .
+```
+
+## API
+
+### sqlite::database
+
+| Method | Description |
+|--------|-------------|
+| `open(path)` | Open or create a SQLite database file |
+| `close()` | Close the database connection |
+| `exec(sql)` | Execute a SQL statement |
+
+### sqlite::statement
+
+| Method | Description |
+|--------|-------------|
+| `prepare(db, sql)` | Prepare a SQL statement |
+| `bind(index, value)` | Bind a value to a parameter |
+| `step()` | Execute one step |
+| `reset()` | Reset the prepared statement |
+| `finalize()` | Finalize the statement |
+
+## License
+
+Apache License 2.0 — see [LICENSE](./LICENSE)