Skip to content

fix(deps): upgrade vitest 2→4, resolve all npm audit findings#63

Open
flyingrobots wants to merge 17 commits intomainfrom
fixups
Open

fix(deps): upgrade vitest 2→4, resolve all npm audit findings#63
flyingrobots wants to merge 17 commits intomainfrom
fixups

Conversation

@flyingrobots
Copy link
Member

@flyingrobots flyingrobots commented Mar 4, 2026

Summary

  • Upgrade vitest 2.1.9 → 4.0.18, resolving the remaining 5 moderate-severity npm audit advisories (esbuild, vite, @vitest/mocker, vite-node, vitest)
  • Migrate deprecated test(name, fn, { timeout }) signatures to Vitest 4's test(name, { timeout }, fn) form across 7 test files
  • Fix vi.fn().mockImplementation(() => ...) constructor mocks to use function expressions per Vitest 4 requirements

Combined with v13.0.1 (which fixed the 4 high-severity findings), the repo now has 0 npm audit vulnerabilities.

Test plan

  • Full unit suite passes locally (252 files, 4619 tests)
  • ESLint clean
  • tsc --noEmit clean
  • IRONCLAD policy gates pass
  • npm audit returns 0 vulnerabilities
  • CI passes on this PR

Summary by CodeRabbit

  • New Features

    • Added a WASM fallback for bitmap indexes (roaring-wasm) to improve compatibility with Bun/Deno.
  • Tests

    • Upgraded Vitest to v4, standardized suite-level timeouts, and adjusted mocks/config for compatibility.
    • Excluded native addon from test server bundles to stabilize test runs.
  • Chores

    • Updated dependencies (including dev tooling).
  • Documentation

    • Added Unreleased changelog and README notes describing the fallback and test changes.

Vitest 4 removed the deprecated test(name, fn, { options }) signature.
Migrate all per-test timeouts to the new test(name, { timeout }, fn)
form, or lift uniform timeouts to the describe level.

Also fix vi.fn().mockImplementation(() => ...) constructor mocks to
use function expressions per Vitest 4 requirements (SyncController,
HealthCheckService mocks).

Resolves all 5 remaining moderate-severity npm audit advisories
(esbuild, vite, @vitest/mocker, vite-node, vitest).
@coderabbitai
Copy link

coderabbitai bot commented Mar 4, 2026

Important

Review skipped

This PR was authored by the user configured for CodeRabbit reviews. CodeRabbit does not review PRs authored by this user. It's recommended to use a dedicated user account to post CodeRabbit review feedback.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: afe1440e-80cb-41a3-85a3-3ac78aece6a1

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

Add a three-tier Roaring loader (native ESM → CJS require → wasm fallback), bump Vitest and adjust test timeout placements across many suites, mark roaring as external in Vitest/Vite, add roaring-wasm dependency and docs/changelog updates, plus small Docker and test mock tweaks.

Changes

Cohort / File(s) Summary
Package / deps
package.json
Add roaring-wasm@^1.1.0 and bump devDependency vitest to ^4.0.18.
Roaring loader
src/domain/utils/roaring.js
Introduce tiered init: try dynamic ESM import('roaring'), then CJS require via createRequire, then roaring-wasm fallback; add shims/unwrapping and adapt WASM API.
Vitest / Vite externals
vitest.config.js
Exclude roaring from SSR/Vitest transforms (ssr.external and server.deps.external).
Tests — timeouts & mocks
test/unit/domain/.../WarpGraph.*.test.js, test/unit/domain/services/*.test.js, test/unit/cli/doctor.test.js, test/unit/domain/services/SyncController.test.js
Centralize suite-level timeouts or add per-test timeout options; remove per-test wrapper syntax; convert several mock factories from arrow-return to function declarations.
CHANGELOG / README
CHANGELOG.md, README.md
Add Unreleased section describing Roaring WASM fallback, Vitest upgrade, and related notes; update architecture dependency entry.
Docker / compose notes
docker/Dockerfile.bun, docker-compose.test.yml
Remove some build deps in Bun Dockerfile, add comments about WASM fallback and Bun incompatibility; adjust Bun test command to string form in docker-compose.
Other tests
test/unit/... (multiple files)
Apply Vitest 4-compatible signature and timeout adjustments across numerous unit tests and mocks.

Sequence Diagram(s)

mermaid
sequenceDiagram
participant App as App/Init
participant ESM as Native ESM Module
participant CJS as Native CJS Module
participant WASM as roaring-wasm
App->>ESM: try dynamic import('roaring')
alt import succeeds
ESM-->>App: exported module
else import fails
App->>CJS: try require(...) via createRequire
alt require succeeds
CJS-->>App: module export
else require fails
App->>WASM: load roaring-wasm fallback
WASM-->>App: WASM adapter (shimmed)
end
end
App->>App: unwrap default / adapt API and return roaring instance

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~45 minutes

Poem

🐇 I nibbled through loaders, hopped past import snags,
I tried ESM, then CJS, then a wasm bag.
Vitest got louder, timeouts found new homes,
Docker and changelog got tidy little tomes.
Tiny paws, big fixes — the rabbit hums and hops.

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Description check ❓ Inconclusive The description covers the summary and test plan sections, but is missing the ADR checks section required by the template. Add the ADR checks section from the template with relevant checkboxes to complete the description.
✅ Passed checks (2 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately summarizes the main changes: upgrading vitest and resolving npm audit findings, which align with the primary objectives of this pull request.
Docstring Coverage ✅ Passed Docstring coverage is 87.50% which is sufficient. The required threshold is 80.00%.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


Comment @coderabbitai help to get the list of available commands and usage tips.

@github-actions
Copy link

github-actions bot commented Mar 4, 2026

Release Preflight

  • package version: 13.0.1
  • prerelease: false
  • npm dist-tag on release: latest
  • npm pack dry-run: passed
  • jsr publish dry-run: passed

If you tag this commit as v13.0.1, release workflow will publish.

1 similar comment
@github-actions
Copy link

github-actions bot commented Mar 4, 2026

Release Preflight

  • package version: 13.0.1
  • prerelease: false
  • npm dist-tag on release: latest
  • npm pack dry-run: passed
  • jsr publish dry-run: passed

If you tag this commit as v13.0.1, release workflow will publish.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@package.json`:
- Line 125: package.json's dev dependency upgrade to "vitest": "^4.0.18"
requires locking its toolchain dependency vite-node in the lockfile; add or
update the package-lock entry for vite-node to a compatible version (matching
the vitest/vite toolchain, e.g., the version used by vitest 4.x) and run npm
install/npm audit-fix to regenerate package-lock.json so vite-node appears with
a resolved version; ensure the dependency is present and resolved alongside
vitest, vite, `@vitest/mocker`, and esbuild to complete the upgrade.

ℹ️ Review info
Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: fee3feeb-2ff9-4fce-a73d-bd9e7498dc94

📥 Commits

Reviewing files that changed from the base of the PR and between f33569a and 7fa2b32.

⛔ Files ignored due to path filters (1)
  • package-lock.json is excluded by !**/package-lock.json
📒 Files selected for processing (10)
  • package.json
  • test/unit/cli/doctor.test.js
  • test/unit/domain/WarpGraph.cascadeDelete.test.js
  • test/unit/domain/WarpGraph.deleteGuardEnforce.test.js
  • test/unit/domain/WarpGraph.noCoordination.test.js
  • test/unit/domain/WarpGraph.patchMany.test.js
  • test/unit/domain/WarpGraph.syncMaterialize.test.js
  • test/unit/domain/services/BisectService.test.js
  • test/unit/domain/services/IndexRebuildService.deep.test.js
  • test/unit/domain/services/SyncController.test.js

"typescript": "^5.9.3",
"typescript-eslint": "^8.54.0",
"vitest": "^2.1.8"
"vitest": "^4.0.18"
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail

fd '^package-lock\.json$' -a

python - <<'PY'
import json, os

lock_path = "package-lock.json"
if not os.path.exists(lock_path):
    print("RESULT: package-lock.json not found in this PR branch")
    raise SystemExit(0)

with open(lock_path, "r", encoding="utf-8") as f:
    lock = json.load(f)

pkgs = lock.get("packages", {})
root = pkgs.get("", {})
print("root.devDependencies.vitest =", root.get("devDependencies", {}).get("vitest"))

for dep in ["vitest", "vite", "vite-node", "@vitest/mocker", "esbuild"]:
    key = f"node_modules/{dep}"
    print(f"{dep} locked version =", pkgs.get(key, {}).get("version"))
PY

Repository: git-stunts/git-warp

Length of output: 299


Lockfile is missing resolved version for vite-node.

The package-lock.json has been updated with most Vitest toolchain dependencies (vitest → 4.0.18, vite → 7.3.1, @vitest/mocker → 4.0.18, esbuild → 0.27.3), but vite-node is not present in the resolved lockfile. Ensure vite-node is also locked to a compatible version to complete the Vitest upgrade.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@package.json` at line 125, package.json's dev dependency upgrade to "vitest":
"^4.0.18" requires locking its toolchain dependency vite-node in the lockfile;
add or update the package-lock entry for vite-node to a compatible version
(matching the vitest/vite toolchain, e.g., the version used by vitest 4.x) and
run npm install/npm audit-fix to regenerate package-lock.json so vite-node
appears with a resolved version; ensure the dependency is present and resolved
alongside vitest, vite, `@vitest/mocker`, and esbuild to complete the upgrade.

Vite 7 (pulled in by vitest 4) attempts to transform all imports
through its pipeline, which breaks native C++ addons like roaring.
Add server.deps.external to skip transformation of the roaring
package, restoring Bun integration test compatibility.
@github-actions
Copy link

github-actions bot commented Mar 4, 2026

Release Preflight

  • package version: 13.0.1
  • prerelease: false
  • npm dist-tag on release: latest
  • npm pack dry-run: passed
  • jsr publish dry-run: passed

If you tag this commit as v13.0.1, release workflow will publish.

The external config was placed at the top-level server key instead of
under test.server.deps.external where Vitest 4 reads it.
Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@vitest.config.js`:
- Around line 4-9: The deps.external setting for the native addon 'roaring' is
placed under server.deps (Vite dev server) but needs to be applied to Vitest;
move the external: ['roaring'] entry from server.deps to test.server.deps so
Vitest's runner sees it (i.e., remove it from server.deps and add it under the
test object as test.server.deps.external). Ensure you keep the same array value
and configuration structure so Vitest will not transform the native C++ addon.

ℹ️ Review info
Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: c2e48fc4-707a-46b5-a504-a04ff235e746

📥 Commits

Reviewing files that changed from the base of the PR and between 63dd929 and cbd1b01.

📒 Files selected for processing (1)
  • vitest.config.js

@github-actions
Copy link

github-actions bot commented Mar 4, 2026

Release Preflight

  • package version: 13.0.1
  • prerelease: false
  • npm dist-tag on release: latest
  • npm pack dry-run: passed
  • jsr publish dry-run: passed

If you tag this commit as v13.0.1, release workflow will publish.

Vitest 4 (Vite 7) intercepts dynamic import('roaring') through its
SSR transform pipeline, preventing the native .node binary from
loading under Bun. Add both ssr.external and test.server.deps.external
(regex pattern) to ensure the roaring package bypasses Vite's
transform and resolution phases entirely.
@github-actions
Copy link

github-actions bot commented Mar 4, 2026

Release Preflight

  • package version: 13.0.1
  • prerelease: false
  • npm dist-tag on release: latest
  • npm pack dry-run: passed
  • jsr publish dry-run: passed

If you tag this commit as v13.0.1, release workflow will publish.

… Bun/Vite

Vite 7's module runner intercepts dynamic import() calls and fails to
transform native C++ addons (.node binaries). initRoaring() now catches
the import failure and falls back to createRequire() which loads native
modules directly, bypassing the module runner.
@github-actions
Copy link

github-actions bot commented Mar 4, 2026

Release Preflight

  • package version: 13.0.1
  • prerelease: false
  • npm dist-tag on release: latest
  • npm pack dry-run: passed
  • jsr publish dry-run: passed

If you tag this commit as v13.0.1, release workflow will publish.

bun install blocks lifecycle scripts by default, so roaring's node-pre-gyp
install never runs, leaving the .node binary missing. Bun also reports a
fictional Node ABI (v137) that has no prebuilt binaries available.

Fix: install nodejs, python3, and ca-certificates in the Bun Dockerfile,
then run node-pre-gyp under real Node.js after bun install. This downloads
the correct prebuilt binary (or compiles from source as fallback). Bun
loads the binary via roaring's MODULE_NOT_FOUND fallback path
(build/Release/roaring.node).

The root cause was Docker layer cache invalidation from the Vitest 4
upgrade — previous CI runs reused a cached layer that happened to have
the binary from an earlier build.
@github-actions
Copy link

github-actions bot commented Mar 4, 2026

Release Preflight

  • package version: 13.0.1
  • prerelease: false
  • npm dist-tag on release: latest
  • npm pack dry-run: passed
  • jsr publish dry-run: passed

If you tag this commit as v13.0.1, release workflow will publish.

The single-stage approach installed nodejs in the Bun container, which
caused Vitest 4 to use node instead of bun for running tests, breaking
globalThis.crypto (and all 64 integration tests).

Switch to a multi-stage build:
- Stage 1 (node:18-slim): npm install + node-pre-gyp to download or
  compile the roaring native binary with the correct Node ABI
- Stage 2 (oven/bun:1.2-slim): bun install + COPY the compiled binary
  from stage 1, keeping the runtime image Node-free
@github-actions
Copy link

github-actions bot commented Mar 4, 2026

Release Preflight

  • package version: 13.0.1
  • prerelease: false
  • npm dist-tag on release: latest
  • npm pack dry-run: passed
  • jsr publish dry-run: passed

If you tag this commit as v13.0.1, release workflow will publish.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (2)
src/domain/utils/roaring.js (1)

117-124: Preserve both load failures for actionable diagnostics.

At Line 117, the original import('roaring') error is dropped. If Line 123 also fails, you lose the first root cause and debugging gets harder.

Proposed fix
-    } catch {
+    } catch (importErr) {
       // Dynamic import() can fail when a module runner (e.g. Vite 7)
       // intercepts the call and cannot transform native C++ addons.
       // Fall back to CJS require() which loads .node binaries directly.
-      const { createRequire } = await import('node:module');
-      const req = createRequire(import.meta.url);
-      roaringModule = /** `@type` {RoaringModule} */ (req('roaring'));
+      try {
+        const { createRequire } = await import('node:module');
+        const req = createRequire(import.meta.url);
+        roaringModule = /** `@type` {RoaringModule} */ (req('roaring'));
+      } catch (requireErr) {
+        throw new AggregateError(
+          [importErr, requireErr],
+          'Failed to load roaring via both import() and require()'
+        );
+      }
     }
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@src/domain/utils/roaring.js` around lines 117 - 124, The dynamic import
fallback currently swallows the original import('roaring') failure; change the
catch to capture the first error (e.g., errImport) then attempt the CJS require
fallback (using createRequire/import.meta.url and req('roaring')), and if the
require also fails, throw or log a new Error that includes both the original
import error and the require error (or attach them as properties) so both
failure causes are preserved; target the try/catch around the import('roaring')
and the fallback require where roaringModule is assigned.
docker/Dockerfile.bun (1)

15-15: Use lockfile-strict install in the builder stage.

At Line 15, switching to npm ci --ignore-scripts will make roaring native build inputs deterministic across CI runs.

Proposed fix
-RUN npm install --ignore-scripts
+RUN npm ci --ignore-scripts
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docker/Dockerfile.bun` at line 15, Replace the non-deterministic install in
the builder stage: find the Dockerfile instruction "RUN npm install
--ignore-scripts" and change it to use the lockfile-strict command "npm ci
--ignore-scripts" so native build inputs are deterministic across CI runs;
ensure the builder stage still has package-lock.json present in the image
context so npm ci can run successfully.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@CHANGELOG.md`:
- Line 12: Update the release note sentence that currently states the Bun
Dockerfile installs `nodejs`, `python3`, and `ca-certificates` so it accurately
describes the multi-stage Docker build and the use of a separate Node builder
image; e.g., change the wording around the sentence mentioning those packages to
note that native binary build/dependencies are provided in a Node builder stage
(or separate builder image) which supplies `node`, `python3`, and certs for
node-pre-gyp rather than being installed in the final Bun runtime image.

---

Nitpick comments:
In `@docker/Dockerfile.bun`:
- Line 15: Replace the non-deterministic install in the builder stage: find the
Dockerfile instruction "RUN npm install --ignore-scripts" and change it to use
the lockfile-strict command "npm ci --ignore-scripts" so native build inputs are
deterministic across CI runs; ensure the builder stage still has
package-lock.json present in the image context so npm ci can run successfully.

In `@src/domain/utils/roaring.js`:
- Around line 117-124: The dynamic import fallback currently swallows the
original import('roaring') failure; change the catch to capture the first error
(e.g., errImport) then attempt the CJS require fallback (using
createRequire/import.meta.url and req('roaring')), and if the require also
fails, throw or log a new Error that includes both the original import error and
the require error (or attach them as properties) so both failure causes are
preserved; target the try/catch around the import('roaring') and the fallback
require where roaringModule is assigned.

ℹ️ Review info
Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 40bb41c0-4645-4199-8a78-91011f98aa7b

📥 Commits

Reviewing files that changed from the base of the PR and between cbd1b01 and 3c525b7.

📒 Files selected for processing (4)
  • CHANGELOG.md
  • docker/Dockerfile.bun
  • src/domain/utils/roaring.js
  • vitest.config.js

CHANGELOG.md Outdated

### Fixed

- **Roaring native module loading under Bun** — `initRoaring()` now catches dynamic `import('roaring')` failures and falls back to `createRequire()` for direct `.node` binary loading. Bun Dockerfile updated to install `nodejs`, `python3`, and `ca-certificates` so that `node-pre-gyp` can download or compile the roaring native binary (Bun reports a fictional Node ABI v137 with no prebuilt available). Fixes `test-bun` CI failures caused by missing native binary after Vitest 4 upgrade invalidated Docker layer cache.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Update release note wording to match the current Docker implementation.

Line 12 says the Bun Dockerfile installs nodejs, python3, and ca-certificates, but the current approach is a multi-stage build with a separate Node builder image. The note should reflect that to avoid operator confusion.

Proposed fix
-- **Roaring native module loading under Bun** — `initRoaring()` now catches dynamic `import('roaring')` failures and falls back to `createRequire()` for direct `.node` binary loading. Bun Dockerfile updated to install `nodejs`, `python3`, and `ca-certificates` so that `node-pre-gyp` can download or compile the roaring native binary (Bun reports a fictional Node ABI v137 with no prebuilt available). Fixes `test-bun` CI failures caused by missing native binary after Vitest 4 upgrade invalidated Docker layer cache.
+- **Roaring native module loading under Bun** — `initRoaring()` now catches dynamic `import('roaring')` failures and falls back to `createRequire()` for direct `.node` binary loading. Bun Dockerfile now uses a Node.js builder stage to run `node-pre-gyp` and then copies roaring native artifacts into the Bun runtime image (Bun reports a fictional Node ABI v137 with no prebuilt available). Fixes `test-bun` CI failures caused by missing native binary after Vitest 4 upgrade invalidated Docker layer cache.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
- **Roaring native module loading under Bun**`initRoaring()` now catches dynamic `import('roaring')` failures and falls back to `createRequire()` for direct `.node` binary loading. Bun Dockerfile updated to install `nodejs`, `python3`, and `ca-certificates` so that `node-pre-gyp` can download or compile the roaring native binary (Bun reports a fictional Node ABI v137 with no prebuilt available). Fixes `test-bun` CI failures caused by missing native binary after Vitest 4 upgrade invalidated Docker layer cache.
- **Roaring native module loading under Bun**`initRoaring()` now catches dynamic `import('roaring')` failures and falls back to `createRequire()` for direct `.node` binary loading. Bun Dockerfile now uses a Node.js builder stage to run `node-pre-gyp` and then copies roaring native artifacts into the Bun runtime image (Bun reports a fictional Node ABI v137 with no prebuilt available). Fixes `test-bun` CI failures caused by missing native binary after Vitest 4 upgrade invalidated Docker layer cache.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@CHANGELOG.md` at line 12, Update the release note sentence that currently
states the Bun Dockerfile installs `nodejs`, `python3`, and `ca-certificates` so
it accurately describes the multi-stage Docker build and the use of a separate
Node builder image; e.g., change the wording around the sentence mentioning
those packages to note that native binary build/dependencies are provided in a
Node builder stage (or separate builder image) which supplies `node`, `python3`,
and certs for node-pre-gyp rather than being installed in the final Bun runtime
image.

…ity)

The roaring npm package uses V8 C++ API (#include <node.h>), not
Node-API/NAPI. Bun uses JavaScriptCore, not V8, so the native .node
binary can never load — 'napi_register_module_v1' symbol not found.

Bitmap index tests (materializedView, checkpointIndex.notStale) are
excluded from the Bun test suite. This is not a regression — these
tests only passed historically due to Docker layer cache luck. The
bitmap index system already handles this gracefully via _buildView()'s
catch block, degrading to linear scan when roaring is unavailable.

Reverts the multi-stage Docker build (unnecessary since the binary
can't work regardless of how it's compiled). Simplifies Dockerfile
back to git + bun install.
@github-actions
Copy link

github-actions bot commented Mar 4, 2026

Release Preflight

  • package version: 13.0.1
  • prerelease: false
  • npm dist-tag on release: latest
  • npm pack dry-run: passed
  • jsr publish dry-run: passed

If you tag this commit as v13.0.1, release workflow will publish.

When both import('roaring') and createRequire('roaring') fail, throw
an AggregateError containing both root causes instead of silently
dropping the original import error. Also update vitest.config.js
comment to be accurate (roaring uses V8 C++ API, not NAPI).
@github-actions
Copy link

github-actions bot commented Mar 4, 2026

Release Preflight

  • package version: 13.0.1
  • prerelease: false
  • npm dist-tag on release: latest
  • npm pack dry-run: passed
  • jsr publish dry-run: passed

If you tag this commit as v13.0.1, release workflow will publish.

initRoaring() now has a three-tier fallback chain:
  Tier 1: import('roaring')      — ESM native V8 bindings
  Tier 2: createRequire('roaring') — CJS native (Vite workaround)
  Tier 3: import('roaring-wasm') — WASM portable fallback

The WASM tier activates automatically when native V8 C++ bindings are
unavailable (Bun's JavaScriptCore, Deno). Serialization formats are
wire-compatible — portable bitmaps from native and WASM are byte-identical.

Bitmap index tests (materializedView, checkpointIndex.notStale) are no
longer excluded from the Bun test suite.

Refactored initRoaring() into per-tier helper functions (tryNativeImport,
tryCjsRequire, tryWasmFallback, unwrapDefault) to satisfy ESLint
complexity/depth/line-count limits.
- README.md: add roaring-wasm to dependency table, add WASM fallback
  bullet to What's New in v13.0.1
- CLAUDE.md: add roaring-wasm to dependency table
@github-actions
Copy link

github-actions bot commented Mar 4, 2026

Release Preflight

  • package version: 13.0.1
  • prerelease: false
  • npm dist-tag on release: latest
  • npm pack dry-run: passed
  • jsr publish dry-run: passed

If you tag this commit as v13.0.1, release workflow will publish.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
src/domain/utils/roaring.js (1)

190-197: ⚠️ Potential issue | 🟡 Minor

Reset native availability cache when reinitializing the module.

initRoaring(mod) can swap module implementations, but cached nativeAvailability is left untouched. Subsequent getNativeRoaringAvailable() calls can return stale data from a previous module load.

🔧 Proposed fix
 export async function initRoaring(mod) {
   if (mod) {
-    roaringModule = mod;
+    roaringModule = unwrapDefault(mod);
+    nativeAvailability = NOT_CHECKED;
     initError = null;
     return;
   }
   if (roaringModule) {
     return;
   }
-  roaringModule =
+  const loaded =
     (await tryNativeImport()) ??
     (await tryCjsRequire()) ??
     (await tryWasmFallback());
-  if (!roaringModule) {
+  if (!loaded) {
     throw new Error(
       'Failed to load roaring via import(), require(), and roaring-wasm',
     );
   }
-  roaringModule = unwrapDefault(roaringModule);
+  roaringModule = unwrapDefault(loaded);
+  nativeAvailability = NOT_CHECKED;
+  initError = null;
 }

Also applies to: 207-207

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@src/domain/utils/roaring.js` around lines 190 - 197, When reinitializing the
roaring module in initRoaring(mod), the cached nativeAvailability must be
cleared so later calls to getNativeRoaringAvailable() don't return stale values;
update initRoaring to reset nativeAvailability (and keep initError handling)
whenever roaringModule is replaced or a new mod is assigned (e.g., where
roaringModule = mod and on other code paths that swap implementations around the
initError/roaringModule logic) so the availability cache is recomputed for the
new module.
🧹 Nitpick comments (1)
src/domain/utils/roaring.js (1)

121-127: Preserve per-tier load failures for actionable diagnostics.

Each tier currently swallows errors, so the final throw loses root causes. Keeping the caught exceptions and throwing an AggregateError makes production/runtime failures much easier to debug.

🧭 Proposed refactor
-async function tryNativeImport() {
+async function tryNativeImport(errors) {
   try {
     return /** `@type` {RoaringModule} */ (await import('roaring'));
-  } catch {
+  } catch (err) {
+    errors.push(err);
     return null;
   }
 }

-async function tryCjsRequire() {
+async function tryCjsRequire(errors) {
   try {
     const { createRequire } = await import('node:module');
     const req = createRequire(import.meta.url);
     return /** `@type` {RoaringModule} */ (req('roaring'));
-  } catch {
+  } catch (err) {
+    errors.push(err);
     return null;
   }
 }

-async function tryWasmFallback() {
+async function tryWasmFallback(errors) {
   try {
     const wasmMod = await import('roaring-wasm');
     if (typeof wasmMod.roaringLibraryInitialize === 'function') {
       await wasmMod.roaringLibraryInitialize();
     }
     return adaptWasmApi(/** `@type` {RoaringModule} */ (wasmMod));
-  } catch {
+  } catch (err) {
+    errors.push(err);
     return null;
   }
 }

 export async function initRoaring(mod) {
   ...
+  const loadErrors = [];
   const loaded =
-    (await tryNativeImport()) ??
-    (await tryCjsRequire()) ??
-    (await tryWasmFallback());
+    (await tryNativeImport(loadErrors)) ??
+    (await tryCjsRequire(loadErrors)) ??
+    (await tryWasmFallback(loadErrors));
   if (!loaded) {
-    throw new Error(
-      'Failed to load roaring via import(), require(), and roaring-wasm',
-    );
+    throw new AggregateError(
+      loadErrors,
+      'Failed to load roaring via import(), require(), and roaring-wasm',
+    );
   }
   ...
 }

Also applies to: 135-142, 150-159, 203-205

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@src/domain/utils/roaring.js` around lines 121 - 127, The import helpers
currently swallow exceptions, losing root causes; update each tier function
(e.g., tryNativeImport and the other try*Import functions around the other
ranges) to capture the caught Error into a shared errors array instead of simply
returning null, and in the final loader (the function that attempts each tier in
sequence) throw a single AggregateError(errors, "Failed to load Roaring module")
when all tiers fail; keep the existing return types (module or null) for each
try*Import but ensure every catch pushes the error into errors so diagnostics
are preserved and the final failure surfaces all collected causes.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@README.md`:
- Around line 13-14: The release label in the README ("What's New in v13.0.1")
is inconsistent with the unreleased entry in CHANGELOG.md; update either the
README heading "What's New in v13.0.1" to "Unreleased" (or the correct release
tag) or move the described items from README into the release section in
CHANGELOG.md so both documents reference the same release state; ensure the two
items ("roaring-wasm WASM fallback for Bun/Deno bitmap indexes" and "Dev
dependency security updates") are listed under the identical release heading in
README and CHANGELOG.md.

---

Outside diff comments:
In `@src/domain/utils/roaring.js`:
- Around line 190-197: When reinitializing the roaring module in
initRoaring(mod), the cached nativeAvailability must be cleared so later calls
to getNativeRoaringAvailable() don't return stale values; update initRoaring to
reset nativeAvailability (and keep initError handling) whenever roaringModule is
replaced or a new mod is assigned (e.g., where roaringModule = mod and on other
code paths that swap implementations around the initError/roaringModule logic)
so the availability cache is recomputed for the new module.

---

Nitpick comments:
In `@src/domain/utils/roaring.js`:
- Around line 121-127: The import helpers currently swallow exceptions, losing
root causes; update each tier function (e.g., tryNativeImport and the other
try*Import functions around the other ranges) to capture the caught Error into a
shared errors array instead of simply returning null, and in the final loader
(the function that attempts each tier in sequence) throw a single
AggregateError(errors, "Failed to load Roaring module") when all tiers fail;
keep the existing return types (module or null) for each try*Import but ensure
every catch pushes the error into errors so diagnostics are preserved and the
final failure surfaces all collected causes.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: f54b7e5a-2de4-444e-a1d1-925125eb1802

📥 Commits

Reviewing files that changed from the base of the PR and between 3c525b7 and 5bdfe64.

⛔ Files ignored due to path filters (1)
  • package-lock.json is excluded by !**/package-lock.json
📒 Files selected for processing (7)
  • CHANGELOG.md
  • README.md
  • docker-compose.test.yml
  • docker/Dockerfile.bun
  • package.json
  • src/domain/utils/roaring.js
  • vitest.config.js
🚧 Files skipped from review as they are similar to previous changes (3)
  • docker/Dockerfile.bun
  • vitest.config.js
  • package.json

Comment on lines +13 to 14
- **`roaring-wasm` WASM fallback for Bun/Deno bitmap indexes** — bitmap indexes now work on Bun (JSC) and Deno via a three-tier fallback: native V8 bindings → CJS require → WASM. Wire-compatible, byte-identical serialization.
- **Dev dependency security updates** — resolved 4 high-severity advisories (`tar`, `rollup`, `minimatch`, `@isaacs/brace-expansion`). No runtime dependencies affected.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Align the release label with the changelog scope.

This change is listed under “What's New in v13.0.1”, but the same work is documented as unreleased in CHANGELOG.md (Line [8]+). That can mislead users about what is already shipped.

📝 Suggested doc fix
-## What's New in v13.0.1
+## What's New in Unreleased
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` around lines 13 - 14, The release label in the README ("What's New
in v13.0.1") is inconsistent with the unreleased entry in CHANGELOG.md; update
either the README heading "What's New in v13.0.1" to "Unreleased" (or the
correct release tag) or move the described items from README into the release
section in CHANGELOG.md so both documents reference the same release state;
ensure the two items ("roaring-wasm WASM fallback for Bun/Deno bitmap indexes"
and "Dev dependency security updates") are listed under the identical release
heading in README and CHANGELOG.md.

…rs to GraphTraversal

Five new graph algorithms in GraphTraversal, all backed by
NeighborProviderPort for memory-efficient traversal:

- levels(): longest-path level assignment for DAGs (O(V+E))
- transitiveReduction(): minimal edge set preserving reachability (DAGs)
- transitiveClosure(): all implied reachability edges with maxEdges safety
- rootAncestors(): find all in-degree-0 ancestors via backward BFS
- BFS reverse reachability verification (direction: 'in')

Includes LogicalTraversal facade methods, index.d.ts types,
cross-provider equivalence tests, 4 new fixtures (F15-F18),
and dedicated test files (47 new test cases).
@github-actions
Copy link

github-actions bot commented Mar 4, 2026

Release Preflight

  • package version: 13.0.1
  • prerelease: false
  • npm dist-tag on release: latest
  • npm pack dry-run: passed
  • jsr publish dry-run: passed

If you tag this commit as v13.0.1, release workflow will publish.

Three items for making new graph algorithms memory-efficient on
large graphs:

- B149: levels() two-pass streaming (O(V+E) → O(V) memory)
- B150: transitiveReduction() on-demand neighbor fetch
- B151: transitiveClosure() async iterator output
…ff items

- B152: async generator traversal API (generalized streaming)
- B153: topologicalSort lightweight mode (O(V) memory)
- B154: transitiveReduction redundant adjList copy fix
- B155: levels() as lightweight --view layout (skip ELK)
- B156: structural diff via transitive reduction comparison
…execution order

- Restructure Standalone Lane from flat Near-Term table + separate pack
  sections into 8 priority-grouped sub-tables (P0 Quick Wins through P6
  Documentation, plus Uncategorized/Platform)
- Replace Standalone Priority Sequence with 6 execution waves mapping
  concrete implementation order
- Add Dependency Chains section with ASCII graph showing B97→B85→B57,
  B153→B149/B150, B154→B150, B151→B152, B36→test velocity chains
- Add effort estimates (XS/S/M/L) and dependency annotations to all items
- Mark all milestones complete (M10–M14); update Final Command section
- Fix inventory count: 43→45 standalone, 131→133 total tracked
- Archive B44, B124, B125, B146, B148 to COMPLETED.md
@github-actions
Copy link

github-actions bot commented Mar 4, 2026

Release Preflight

  • package version: 13.0.1
  • prerelease: false
  • npm dist-tag on release: latest
  • npm pack dry-run: passed
  • jsr publish dry-run: passed

If you tag this commit as v13.0.1, release workflow will publish.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant