feat: bun first-class support

Adds first-class Bun support, rebuilt cleanly on top of latest main so it
carries only Bun-related changes (the earlier branch had accumulated unrelated
changesets, docs, and a stale db-codegen snapshot already superseded in main).

- @pikku/bun-server: Bun HTTP + WebSocket runtime with health checks and
  graceful shutdown.
- @pikku/kysely-bun-sqlite: Bun-native SQLite Kysely adapter + coercion plugin.
- templates/bun + verifiers/bun-server: Bun starter template and verifier.
- CI: Bun added to the template matrix; setup-bun + dist .d.ts in the build
  artifact for Bun file: deps.
- create: --skip-install so the CI harness can patch deps before installing.
- test-template.sh: Bun package-manager path. Its file: patch now scans
  templates/ too, forces every @pikku/* to the in-repo copy via bun overrides,
  and de-duplicates deps across dependency types (a package in both
  dependencies and devDependencies made bun emit a broken self-referential
  symlink, breaking tsc/runtime resolution).
- tsconfig/skipLibCheck and node:test-mock shims so non-Bun verifiers and core
  tests tolerate bun-types / Bun's node:test.

Also untracks .claude/scheduled_tasks.lock and gitignores it.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: yasserf

.changeset/bun-first-class-support.md

@@ -0,0 +1,6 @@
+---
+'@pikku/bun-server': patch
+'@pikku/kysely-bun-sqlite': patch
+---
+
+feat: bun first-class support — new `@pikku/bun-server` runtime and `@pikku/kysely-bun-sqlite` dialect, bun template, CI matrix with `package-manager: [yarn, bun]`, and bun verifier.

.claude/scheduled_tasks.lock

@@ -82,10 +82,10 @@ runs:
       with:
         name: build-output
         path: |
-          packages/**/dist
-          packages/**/bin
-          templates/**/.pikku
-          templates/**/dist
+          packages/**/dist/**
+          packages/**/bin/**
+          templates/**/.pikku/**
+          templates/**/dist/**
         include-hidden-files: true
         retention-days: 1
 

.github/actions/build/action.yml

@@ -18,6 +18,9 @@ runs:
       with:
         node-version: ${{ inputs.node-version }}
         cache: yarn
+    - uses: oven-sh/setup-bun@v2
+      with:
+        bun-version: latest
     - name: Download build output
       if: ${{ inputs.download-build == 'true' }}
       uses: actions/download-artifact@v4

.github/actions/setup/action.yml

@@ -63,7 +63,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: Install native build tools
-        run: apt-get update && apt-get install -y build-essential python3
+        run: apt-get update && apt-get install -y build-essential python3 unzip
       - uses: ./.github/actions/setup
       - uses: ./.github/actions/e2e-codegen
       - name: Run e2e tests
@@ -225,16 +225,32 @@ jobs:
             remote-rpc-pg,
             remote-rpc-redis,
             ai-postgres,
+            bun,
           ]
-        package-manager: [yarn]
+        package-manager: [yarn, bun]
+        exclude:
+          - package-manager: bun
+            template: uws
+          - package-manager: bun
+            template: aws-lambda
+          - package-manager: bun
+            template: aws-lambda-websocket
+          - package-manager: bun
+            template: cloudflare-workers
+          - package-manager: bun
+            template: cloudflare-websocket
+          - package-manager: bun
+            template: nextjs
+          - package-manager: bun
+            template: nextjs-full
     steps:
       - uses: actions/checkout@v4
       - uses: ./.github/actions/setup
         with:
           node-version: ${{ matrix.version }}
       - name: Test template
         timeout-minutes: 2
-        run: ./scripts/test-template.sh ${{ matrix.template }} ${{ github.ref_name }}
+        run: ./scripts/test-template.sh ${{ matrix.template }} ${{ github.ref_name }} ${{ matrix.package-manager }}
         env:
           TEMPLATE_V8_COVERAGE_DIR: ${{ runner.temp }}/template-coverage/${{ matrix.template }}/raw
       - name: Generate template coverage report

.github/workflows/develop.yml

@@ -139,6 +139,11 @@ typings/
 
 # Claude Code worktrees
 .claude/worktrees/
+.claude/scheduled_tasks.lock
+
+# Bun lockfile — repo is yarn-based; bun is only used to run `bun test` against
+# the yarn-installed node_modules, so its lockfile is not tracked.
+bun.lock
 
 # Bun build cache
 *.bun-build

.gitignore

@@ -45,6 +45,7 @@
     "test:e2e:ai": "yarn workspace @pikku/e2e test:ai",
     "test": "yarn workspaces foreach -A --exclude '@pikku/templates-*' --exclude '@pikku/verifiers-*' --exclude '@pikku/addon-console' --exclude '@pikku/console' --exclude '@pikku/e2e' run test",
     "test:coverage": "yarn workspaces foreach -A run test:coverage",
+    "test:bun": "bun test packages/core/src packages/openapi-parser/src packages/openapi-to-zod-schema/src packages/pikku/src packages/runtimes/cloudflare/src packages/schedule/src packages/services/kysely-bun-sqlite/src",
     "lint": "npx --yes oxlint@latest",
     "prettier": "npx --yes prettier . --write --log-level warn",
     "typedoc": "npx --yes typedoc --tsconfig tsconfig.typedoc.json",

package.json

@@ -20,8 +20,26 @@ trap 'rm -rf "$_bootstrap_dir"' EXIT
 # module load, so it must be installed alongside it. This stays @pikku/auth-js
 # until a CLI release that imports @pikku/better-auth is published, after which
 # this should flip to "@pikku/better-auth".
-npm install --prefix "$_bootstrap_dir" --no-save --no-package-lock \
-  "@pikku/cli@${PIKKU_CLI_VERSION}" "@pikku/auth-js"
+#
+# The `overrides` neutralises an unconverted `workspace:*` specifier that can
+# leak into a published @pikku/cli manifest (e.g. @pikku/cli@0.12.36 shipped
+# `@pikku/better-auth: workspace:*`, which npm cannot resolve). Declaring the
+# bootstrap deps in a package.json is what lets the override apply during
+# resolution — npm ignores `overrides` for packages passed as install args.
+cat > "$_bootstrap_dir/package.json" <<JSON
+{
+  "name": "pikku-bootstrap",
+  "private": true,
+  "dependencies": {
+    "@pikku/cli": "${PIKKU_CLI_VERSION}",
+    "@pikku/auth-js": "latest"
+  },
+  "overrides": {
+    "@pikku/better-auth": "latest"
+  }
+}
+JSON
+(cd "$_bootstrap_dir" && npm install --no-save --no-package-lock)
 "$_bootstrap_dir/node_modules/.bin/pikku"
 rm -rf "$_bootstrap_dir"
 
@@ -84,7 +102,12 @@ yarn tsc -b
 
 # Copy schema file
 echo "Copying schema file..."
-cp .pikku/schemas/schemas/PikkuCLIConfig.schema.json cli.schema.json
+schema_src=$(find .pikku/schemas -maxdepth 2 -name "PikkuCLIConfig.schema.json" | head -1)
+if [ -n "$schema_src" ]; then
+  cp "$schema_src" cli.schema.json
+else
+  echo "Warning: PikkuCLIConfig.schema.json not found, skipping schema copy"
+fi
 
 echo "Copying console app..."
 rm -rf console-app

packages/cli/build.sh

@@ -60,6 +60,7 @@
     "picoquery": "^2.5.0"
   },
   "devDependencies": {
+    "@types/json-schema": "^7.0.15",
     "@types/node": "^24.11.0",
     "tsx": "^4.21.0",
     "typescript": "^5.9"

packages/core/package.json

@@ -32,6 +32,11 @@ const ensureRecursiveWatchAvailable = async (
   t: TestContext,
   dir: string
 ): Promise<boolean> => {
+  if ('bun' in process.versions) {
+    t.skip('tsx esm dynamic reload not supported under bun')
+    return false
+  }
+
   if (process.platform === 'darwin') {
     t.skip('recursive fs.watch is unreliable on darwin')
     return false