Merge pull request #42 from SQLoot/sync/common-v8-2026-02-22

PR: sync/common-v8 2026-02-22

Author: miccy

.ai/knowledge/common-v8-parity-plan-2026-02-16.md

@@ -25,6 +25,41 @@ Reach practical `upstream/common-v8` compatibility for architecture/API/behavior
 - `bun run verify:fast`
 - `SYNC_GUARD_MAIN_REF=miccy-dev bun run sync:guard:common-v8:strict`
 
+## Sync Wave 2026-02-22 (Latest)
+
+Source range:
+
+- `sync/common-v8-2026-02-22..upstream/common-v8`
+- 16 upstream commits (`2026-02-19` to `2026-02-21`)
+
+Resolution summary:
+
+| Upstream | Subject | Status | Local Note |
+|---|---|---|---|
+| `0ccedcf` | Add top-down code ordering guidance | `verified-equivalent` | Cherry-picked (`-x`). |
+| `c8d1bf9` | Bump pnpm to 10.30.0 in package.json | `intentional-divergence` | Bun-first fork (`packageManager: bun@...`). |
+| `01e588d` | Update pnpm-lock.yaml | `intentional-divergence` | Bun lockfile authoritative. |
+| `ae95d0e` | Make MicrotaskBatch disposable | `verified-equivalent` | Cherry-picked (`-x`). |
+| `e047437` | Wrap mutateBatch with stack.use and add test | `verified-equivalent` | Superseded by `21203bb` (same behavior present after refactor). |
+| `ebf0d31` | Bump pnpm packageManager to 10.30.1 | `intentional-divergence` | Bun-first fork. |
+| `1ab01ab` | Update pnpm-lock.yaml | `intentional-divergence` | Bun lockfile authoritative. |
+| `43ba3f2` | Add TODO: Example to Instances | `verified-equivalent` | Cherry-picked (`-x`). |
+| `5c163a9` | Add ExtractType utility and tests | `verified-equivalent` | Cherry-picked (`-x`) with import conflict resolution only. |
+| `cec27bc` | Clarify exhaustiveCheck docs and add example | `verified-equivalent` | Cherry-picked (`-x`). |
+| `ec8a83b` | Add ArrayBuffer external link in typedoc | `verified-equivalent` | Cherry-picked (`-x`). |
+| `121ee93` | Update pnpm-lock.yaml | `intentional-divergence` | Bun lockfile authoritative. |
+| `f81b896` | Update biome.json | `verified-equivalent` | Already covered by local Biome update (empty cherry-pick). |
+| `42dcbd5` | Ensure exported SQLite bytes use ArrayBuffer backing | `verified-equivalent` | Cherry-picked (`-x`) with Node test import conflict resolution only. |
+| `e6997a1` | Alias int factory; use TypeName for typed tags | `verified-equivalent` | Cherry-picked (`-x`). |
+| `21203bb` | Refactor DbWorker, storage, and messaging | `verified-equivalent` | Cherry-picked (`-x`), core runtime files aligned; `apps/web` hunk intentionally dropped (website docs live outside this repo). |
+
+Post-pick local compat fix:
+
+- `2cc68d85` (`fix(sync): adapt common-v8 worker logging to Task/Console APIs`)
+  - Adapts upstream subscription cleanup to local `Task` stack contract.
+  - Replays `ConsoleEntry` through local `Console` API (no `console.write` in fork interface).
+  - Fixes `Shared.test.ts` import path drift (`testName` from `Test.ts`).
+
 ## Upstream Commit Matrix (Current Snapshot)
 
 Source: `git cherry -v miccy-dev upstream/common-v8`

.github/copilot-instructions.md

@@ -62,6 +62,19 @@ Key directories:
 - **Organize code top-down** - public interfaces first, then implementation, then implementation details. If a helper must be defined before the public export that uses it (due to JavaScript hoisting), place it immediately before that export.
 - **Reference globals explicitly with `globalThis`** - when a name clashes with global APIs (e.g., `SharedWorker`, `Worker`), use `globalThis.SharedWorker` instead of aliasing imports
 
+### Order (top-down readability)
+
+Write code top-down: public API first (interfaces and types), then implementation, then implementation details.
+
+Evolu optimizes for reading, not writing. Source code is read far more often than it is written, so developer-facing contracts should appear before low-level helpers.
+
+Think from whole to detail:
+
+1. Public contract (`interface`, exported types)
+2. Supporting types
+3. Implementation
+4. Implementation details
+
 ```ts
 // Good
 import { bar, baz } from "Foo.ts";

.github/workflows/ci.yaml

@@ -8,6 +8,9 @@ on:
   merge_group:
   workflow_dispatch:
 
+permissions:
+  contents: read
+
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
@@ -31,6 +34,8 @@ jobs:
 
       - name: Setup Bun
         uses: oven-sh/setup-bun@4bc047ad259df6fc24a6c9b0f9a0cb08cf17fbe5 # v2.0.1
+        with:
+          bun-version: "1.3.9"
 
       - name: Install dependencies
         run: bun install
@@ -60,3 +65,39 @@ jobs:
               echo "- Bun test: not available"
             fi
           } >> "$GITHUB_STEP_SUMMARY"
+
+  relay-runtime-smoke:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [24]
+        runtime: [bun, node]
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+
+      - name: Using Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@39370e3970a6d050c480ffad4ff0ed4d3fdee5af # v4.1.0
+        with:
+          node-version: ${{ matrix.node-version }}
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@4bc047ad259df6fc24a6c9b0f9a0cb08cf17fbe5 # v2.0.1
+        with:
+          bun-version: "1.3.9"
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Relay smoke tests (Bun runtime)
+        if: matrix.runtime == 'bun'
+        run: >
+          bunx vitest run --project unit
+          packages/common/test/WebSocket.test.ts
+          packages/common/test/local-first/Relay.test.ts
+
+      - name: Relay smoke tests (Node runtime)
+        if: matrix.runtime == 'node'
+        run: >
+          node ./node_modules/vitest/vitest.mjs run --project unit
+          packages/common/test/WebSocket.test.ts
+          packages/common/test/local-first/Relay.test.ts

biome.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://biomejs.dev/schemas/2.4.2/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.4.4/schema.json",
   "vcs": {
     "enabled": true,
     "clientKind": "git",