Merge branch 'main' into cm/reduce-persisted-entities-transfer-size

Author: CiaranMn

.claude/skills/testing-hashql/SKILL.md

@@ -180,6 +180,12 @@ For testing MIR transformation and analysis passes directly with programmaticall
 - Edge cases requiring specific MIR structures hard to produce from source
 - Benchmarking pass performance
 
+**Key features:**
+
+- Transform passes return `Changed` enum (`Yes`, `No`, `Unknown`) to indicate modifications
+- Test harness captures and includes `Changed` value in snapshots for verification
+- Snapshot format: before MIR → `Changed: Yes/No/Unknown` separator → after MIR
+
 **Quick Example:**
 
 ```rust
@@ -201,10 +207,10 @@ builder
 let body = builder.finish(0, TypeBuilder::synthetic(&env).integer());
 ```
 
-📖 **Full Guide:** [resources/mir-builder-guide.md](resources/mir-builder-guide.md)
+📖 **Full Guide:** [references/mir-builder-guide.md](references/mir-builder-guide.md)
 
 ## References
 
-- [compiletest Guide](resources/compiletest-guide.md) - Detailed UI test documentation
-- [Testing Strategies](resources/testing-strategies.md) - Choosing the right approach
-- [MIR Builder Guide](resources/mir-builder-guide.md) - Programmatic MIR construction for tests
+- [compiletest Guide](references/compiletest-guide.md) - Detailed UI test documentation
+- [Testing Strategies](references/testing-strategies.md) - Choosing the right approach
+- [MIR Builder Guide](references/mir-builder-guide.md) - Programmatic MIR construction for tests

.claude/skills/testing-hashql/references/mir-builder-guide.md

@@ -228,10 +228,11 @@ builder.build_block(bb_merge).ret(x);  // x receives value from param
 
 ## Test Harness Pattern
 
-Standard pattern used across transform pass tests:
+Standard pattern used across transform pass tests. The harness captures and displays
+the `Changed` return value to verify pass behavior:
 
 ```rust
-use std::path::PathBuf;
+use std::{io::Write as _, path::PathBuf};
 use bstr::ByteVec as _;
 use hashql_core::{
     pretty::Formatter,
@@ -274,12 +275,16 @@ fn assert_pass<'heap>(
         .format(DefIdSlice::from_raw(&bodies), &[])
         .expect("should be able to write bodies");
 
-    text_format
-        .writer
-        .extend(b"\n\n------------------------------------\n\n");
-
-    // Run the pass
-    YourPass::new().run(context, &mut bodies[0]);
+    // Run the pass and capture change status
+    let changed = YourPass::new().run(context, &mut bodies[0]);
+    
+    // Include Changed value in snapshot for verification
+    write!(
+        text_format.writer,
+        "\n\n{:=^50}\n\n",
+        format!(" Changed: {changed:?} ")
+    )
+    .expect("infallible");
 
     // Format after
     text_format

.config/mise/config.toml

@@ -18,6 +18,7 @@ protoc            = "32.1"
 
 # CLI tools
 biome                  = "1.9.5-nightly.ff02a0b"
+"cargo:cargo-codspeed" = "4.1.0"
 "cargo:cargo-hack"     = "0.6.37"
 "cargo:cargo-insta"    = "1.43.1"
 "cargo:cargo-llvm-cov" = "0.6.18"

.github/workflows/codspeed.yml

@@ -0,0 +1,80 @@
+name: CodSpeed Benchmarks
+
+on:
+  push:
+    branches:
+      - "main"
+  pull_request:
+  # `workflow_dispatch` allows CodSpeed to trigger backtest
+  # performance analysis in order to generate initial data.
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  setup:
+    runs-on: ubuntu-24.04
+    permissions:
+      id-token: write
+    outputs:
+      packages: ${{ steps.packages.outputs.packages }}
+    steps:
+      - name: Checkout source code
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        with:
+          fetch-depth: 2
+
+      - name: Install tools
+        uses: ./.github/actions/install-tools
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          vault_address: ${{ secrets.VAULT_ADDR }}
+          rust: false
+
+      - name: Determine changed packages that have codspeed
+        id: packages
+        run: |
+          PACKAGES_QUERY='query { affectedPackages(base: "HEAD^" filter: {has: {field: "TASK_NAME", value: "build:codspeed"}}) {items {name path}}}'
+          PACKAGES=$(turbo query "$PACKAGES_QUERY" \
+            | jq --compact-output '.data.affectedPackages.items | [(.[] | select(.name != "//"))] | { name: [.[].name], include: . }')
+
+          echo "packages=$PACKAGES" | tee -a $GITHUB_OUTPUT
+
+  benchmarks:
+    name: Run benchmarks
+    needs: [setup]
+    runs-on: ubuntu-24.04
+    strategy:
+      matrix: ${{ fromJSON(needs.setup.outputs.packages) }}
+      fail-fast: false
+    if: needs.setup.outputs.packages != '{"name":[],"include":[]}'
+    steps:
+      - name: Checkout
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        with:
+          fetch-depth: 2
+
+      - name: Clean up disk
+        uses: ./.github/actions/clean-up-disk
+
+      - name: Install tools
+        uses: ./.github/actions/install-tools
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          vault_address: ${{ secrets.VAULT_ADDR }}
+
+      - name: Prune repository
+        uses: ./.github/actions/prune-repository
+        with:
+          scope: ${{ matrix.name }}
+
+      - name: Build the benchmark target
+        run: turbo run build:codspeed --filter=${{ matrix.name }}
+
+      - name: Run the benchmark
+        uses: CodSpeedHQ/action@346a2d8a8d9d38909abd0bc3d23f773110f076ad # v4.4.1
+        with:
+          mode: simulation
+          run: turbo run test:codspeed --filter=${{ matrix.name }}

.github/workflows/release.yml

@@ -31,7 +31,7 @@ jobs:
         uses: changesets/action@e0145edc7d9d8679003495b11f87bd8ef63c0cba # v1.5.3
         with:
           publish: yarn changeset publish
-          version: yarn changeset version && yarn
+          version: yarn changeset:version
         env:
           GITHUB_TOKEN: ${{ secrets.MACHINE_USER_TOKEN }}
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -85,6 +85,9 @@ blocks/**/.env
 # next.js build output
 **/.next
 
+# next.js build output – once upgraded to Next.js 16, this can be removed, as it will be generated in the dist/ directory instead
+**/next-env.d.ts
+
 # build files
 **/dist
 **/build