chore: upgrade Node 24.16.0 + Bun 1.3.14, better-sqlite3 12.10.1, clarify Docker registry strategy (#65)

* docs: add session summary for platform integration fixes

Documents root causes, solutions, and lessons learned from the
studio↔platform integration debugging session (2026-03-27).

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

* chore(deps): update Node.js version to 24.16.0

* chore(deps): update better-sqlite3 to version 12.10.1 and change Node.js base image to 24.16.0-trixie-slim

* chore(docs): update Node.js version in CONTRIBUTING.md to 24

* chore(docs): update Node.js/Bun version in bug report template to 1.3.14 and 24.16.0

* chore(docs): update Bun version in test plans to 1.3.14

* chore(docs): clarify primary Docker image registry and update related documentation

* chore(docs): add enterprise features roadmap and Kubernetes Helm chart setup documentation

* docs: consolidate overlapping docs and archive shipped plans

- Merge STORAGE_ARCHITECTURE.md + STORAGE_QUICK_SETUP.md → STORAGE.md (setup-first, then architecture)
- Merge OIDC_SETUP.md + OIDC_ARCH.md → OIDC.md (setup-first, then architecture)
- Merge orphaned adding-a-new-database-provider.md into DATABASE_PROVIDERS.md
- Archive shipped implementation plans: AI_PLAN.md, POSTGRES_METRICS.md → docs/archived/
- Update README OIDC links to the consolidated OIDC.md

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

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: cevheri

.github/ISSUE_TEMPLATE/bug_report.md

@@ -30,7 +30,7 @@ Please provide the following information:
 - **LibreDB Studio Version**: (e.g., 0.5.4)
 - **Browser**: (e.g., Chrome 120, Firefox 121, Safari 17)
 - **OS**: (e.g., macOS 14, Windows 11, Ubuntu 22.04)
-- **Node.js/Bun Version**: (e.g., Bun 1.0.0, Node.js 20.10.0)
+- **Node.js/Bun Version**: (e.g., Bun 1.3.14, Node.js 24.16.0)
 - **Database Type**: (e.g., PostgreSQL 15, MySQL 8.0, SQLite 3.42, MongoDB 7.0)
 - **Database Version**: (e.g., PostgreSQL 15.3)
 

.github/workflows/ci.yml

@@ -24,7 +24,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@0c5077e51419868618aeaa5fe8019c62421857d6 # v2
         with:
-          bun-version: "1.3.9"
+          bun-version: "1.3.14"
 
       - name: Install dependencies
         run: bun install --frozen-lockfile
@@ -56,7 +56,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@0c5077e51419868618aeaa5fe8019c62421857d6 # v2
         with:
-          bun-version: "1.3.9"
+          bun-version: "1.3.14"
 
       - name: Install dependencies
         run: bun install --frozen-lockfile
@@ -88,7 +88,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@0c5077e51419868618aeaa5fe8019c62421857d6 # v2
         with:
-          bun-version: "1.3.9"
+          bun-version: "1.3.14"
 
       - name: Install dependencies
         run: bun install --frozen-lockfile

.github/workflows/docker-build-push.yml

@@ -42,7 +42,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@0c5077e51419868618aeaa5fe8019c62421857d6 # v2
         with:
-          bun-version: latest
+          bun-version: "1.3.14"
 
       - name: Install dependencies
         run: bun install --frozen-lockfile

.github/workflows/integration-check.yml

@@ -21,7 +21,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@0c5077e51419868618aeaa5fe8019c62421857d6 # v2
         with:
-          bun-version: "1.3.9"
+          bun-version: "1.3.14"
 
       - name: Install dependencies
         run: bun install --frozen-lockfile

.github/workflows/npm-publish.yml

@@ -30,7 +30,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@0c5077e51419868618aeaa5fe8019c62421857d6 # v2
         with:
-          bun-version: "1.3.9"
+          bun-version: "1.3.14"
 
       - name: Install dependencies
         run: bun install --frozen-lockfile
@@ -65,12 +65,12 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@0c5077e51419868618aeaa5fe8019c62421857d6 # v2
         with:
-          bun-version: "1.3.9"
+          bun-version: "1.3.14"
 
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '22'
+          node-version: '24.16.0'
           registry-url: 'https://registry.npmjs.org'
 
       - name: Install dependencies

.nvmrc

@@ -0,0 +1 @@
+24.16.0

CLAUDE.md

@@ -14,8 +14,9 @@ LibreDB Studio is a web-based SQL IDE for cloud-native teams. It supports Postgr
 
 ## Github
 * Repository: https://github.com/libredb/libredb-studio
-* Container Registry: https://github.com/libredb/libredb-studio/pkgs/container/libredb-studio
-* Docker Image: ghcr.io/libredb/libredb-studio:latest
+* Container Registry (primary): https://github.com/libredb/libredb-studio/pkgs/container/libredb-studio
+* Docker Image (primary): ghcr.io/libredb/libredb-studio:latest — no pull rate limits, use in all copy-paste examples
+* Docker Hub (mirror): https://hub.docker.com/r/libredb/libredb-studio — `libredb/libredb-studio` (convenience/discoverability only; GHCR stays canonical)
 * Helm Chart: https://artifacthub.io/packages/helm/libredb-studio/libredb-studio
 * Helm Repo: https://libredb.org/libredb-studio/
 * Helm OCI: oci://ghcr.io/libredb/charts/libredb-studio

CONTRIBUTING.md

@@ -39,7 +39,7 @@ Feature suggestions are welcome! Please provide:
 
 ### Prerequisites
 
-- [Bun](https://bun.sh/) (recommended) or Node.js 20+
+- [Bun](https://bun.sh/) (recommended) or Node.js 24+
 - Git
 
 ### Getting Started

DOCKERHUB.md

@@ -79,7 +79,7 @@ A ready-to-use, fully-commented compose file is in the repo: [`docker-compose.ex
 | `sha-<commit>` | every build | Exact immutable commit |
 
 - **Architectures:** `linux/amd64`, `linux/arm64` (multi-arch manifest).
-- **Also on GHCR:** `ghcr.io/libredb/libredb-studio` (canonical mirror, no pull rate limits — preferred for Kubernetes).
+- **Primary registry:** `ghcr.io/libredb/libredb-studio` (GitHub Container Registry — no pull rate limits, preferred for Kubernetes/CI). This Docker Hub repository is a convenience mirror for discoverability; both registries serve the identical multi-arch image.
 
 ---
 

Dockerfile

@@ -6,14 +6,16 @@
 # Bun for fast dependency installation, Node.js for build
 # Bun's JIT compiler segfaults under QEMU emulation (ARM64 cross-build),
 # so we use Node.js for the Next.js build step.
-FROM oven/bun:1 AS deps
+FROM oven/bun:1.3.14 AS deps
 WORKDIR /usr/src/app
 RUN apt-get update && apt-get install -y python3 make g++ --no-install-recommends && rm -rf /var/lib/apt/lists/*
 COPY package.json bun.lock ./
 RUN bun install --frozen-lockfile
 
 # Build with Node.js to avoid Bun/QEMU segfaults on ARM64
-FROM node:20-slim AS builder
+# trixie-slim: must match the oven/bun deps stage glibc (Debian 13 / glibc 2.41),
+# otherwise native modules (better-sqlite3) compiled in deps fail to load here.
+FROM node:24.16.0-trixie-slim AS builder
 WORKDIR /usr/src/app
 COPY --from=deps /usr/src/app/node_modules ./node_modules
 COPY . .
@@ -31,7 +33,8 @@ ENV USER_PASSWORD=$USER_PASSWORD_BUILD
 RUN npx next build
 
 # Production image - use Node.js slim for lower memory footprint
-FROM node:20-slim AS runner
+# trixie-slim: glibc must match the stage where native modules were built (see builder).
+FROM node:24.16.0-trixie-slim AS runner
 WORKDIR /app
 
 ENV NODE_ENV=production