release: v0.3.0

- Use NODE_NO_WARNINGS=1 in execFileSync env instead of --no-warnings flag
- Remove overly broad process.removeAllListeners('warning') from CLI entry
- Add engines field requiring Node >=22.5.0 (node:sqlite availability)
- Update proman to 0.4.2

package.json

@@ -2,9 +2,11 @@
   "name": "@ocas/workspace",
   "private": true,
   "devDependencies": {
-    "@shazhou/proman": "0.2.2",
+    "@biomejs/biome": "^2.4.16",
+    "@shazhou/proman": "0.4.2",
     "@types/node": "^25.9.1",
     "tsx": "^4.22.4",
+    "typescript": "^6.0.3",
     "ulidx": "^2.4.1",
     "vite": "^8.0.16",
     "vitest": "^4.1.8"
@@ -20,13 +22,16 @@
     "url": "https://github.com/shazhou-ww/ocas.git"
   },
   "homepage": "https://github.com/shazhou-ww/ocas",
+  "engines": {
+    "node": ">=22.5.0"
+  },
   "bugs": {
     "url": "https://github.com/shazhou-ww/ocas/issues"
   },
   "pnpm": {
     "onlyBuiltDependencies": [
-      "esbuild",
-      "better-sqlite3"
-    ]
+      "esbuild"
+    ],
+    "overrides": {}
   }
 }

packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ocas/cli",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "type": "module",
   "bin": {
     "ocas": "dist/index.js"

packages/cli/src/index.ts

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
 
 import { existsSync, readFileSync } from "node:fs";
-import { fileURLToPath } from "node:url";
 import { homedir } from "node:os";
 import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
+
 import type { Hash, ListEntry, ListOptions, Store, TagOp } from "@ocas/core";
 import {
   applyListOptions,

packages/cli/tests/__snapshots__/edge-cases.test.ts.snap

@@ -466,5 +466,5 @@ Flags:
   --epsilon <n>       Cutoff threshold for render (default: 0.01)
   --pipe, -p          Read from stdin (put/hash: raw JSON payload; render: { type, value } envelope)
 
-Agent: If you have not installed the ocas skill for this version (0.2.2), run \`ocas prompt setup\` and follow the instructions."
+Agent: If you have not installed the ocas skill for this version (0.3.0), run \`ocas prompt setup\` and follow the instructions."
 `;

packages/cli/tests/alias.test.ts

@@ -1,8 +1,8 @@
-import { afterEach, beforeEach, describe, expect, test } from "vitest";
-import { mkdirSync, rmSync, writeFileSync } from "node:fs";
 import { execFileSync } from "node:child_process";
+import { mkdirSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
+import { afterEach, beforeEach, describe, expect, test } from "vitest";
 
 // ---- @ Alias Resolution Tests ----
 

packages/cli/tests/edge-cases.test.ts

@@ -1,8 +1,8 @@
-import { afterAll, beforeAll, describe, expect, test } from "vitest";
-import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { execFileSync } from "node:child_process";
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join, resolve } from "node:path";
+import { afterAll, beforeAll, describe, expect, test } from "vitest";
 import { envValue, stripVolatile } from "./helpers";
 
 const entrypoint = resolve(import.meta.dirname, "../dist/index.js");

packages/cli/tests/gc.test.ts

@@ -1,8 +1,8 @@
-import { afterAll, beforeAll, describe, expect, test } from "vitest";
-import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { execFileSync } from "node:child_process";
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join, resolve } from "node:path";
+import { afterAll, beforeAll, describe, expect, test } from "vitest";
 import { envValue } from "./helpers";
 
 const entrypoint = resolve(import.meta.dirname, "../dist/index.js");

packages/cli/tests/get-tag-info.test.ts

@@ -1,11 +1,11 @@
-import { afterEach, beforeEach, describe, expect, test } from "vitest";
-import { mkdirSync, rmSync } from "node:fs";
 import { execFileSync } from "node:child_process";
+import { mkdirSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import type { Hash } from "@ocas/core";
 import { bootstrap, validate } from "@ocas/core";
 import { openStore as openFsStore } from "@ocas/fs";
+import { afterEach, beforeEach, describe, expect, test } from "vitest";
 
 let testDir: string;
 let storePath: string;

packages/cli/tests/helpers.ts

@@ -1,3 +1,4 @@
+import { execFileSync } from "node:child_process";
 import {
   mkdirSync,
   mkdtempSync,
@@ -5,7 +6,6 @@ import {
   rmSync,
   writeFileSync,
 } from "node:fs";
-import { execFileSync } from "node:child_process";
 import { tmpdir } from "node:os";
 import { join, resolve } from "node:path";
 import type { JSONSchema } from "@ocas/core";
@@ -47,6 +47,8 @@ export async function putSchemaFile(
   return hash;
 }
 
+const quietEnv = { ...process.env, NODE_NO_WARNINGS: "1" };
+
 /**
  * Run CLI command. Accepts either a string[] or ...string[] (rest args).
  * If first arg is an array, uses that as args. Otherwise treats all args as the command.
@@ -62,6 +64,7 @@ export function runCli(
     const stdout = execFileSync("node", finalArgs, {
       encoding: "utf-8",
       timeout: 10000,
+      env: quietEnv,
     });
     return { stdout, stderr: "", exitCode: 0 };
   } catch (e: unknown) {
@@ -85,6 +88,7 @@ export function runCliWithStdin(
       input: stdin,
       encoding: "utf-8",
       timeout: 10000,
+      env: quietEnv,
     });
     return { stdout, stderr: "", exitCode: 0 };
   } catch (e: unknown) {

packages/cli/tests/list-meta-schema.test.ts

@@ -1,9 +1,9 @@
-import { afterEach, beforeEach, describe, expect, test } from "vitest";
 import { mkdirSync, mkdtempSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { BOOTSTRAP_STORE } from "@ocas/core";
 import { openStore as openFsStore } from "@ocas/fs";
+import { afterEach, beforeEach, describe, expect, test } from "vitest";
 import { envValue, runCli } from "./helpers.js";
 
 let storePath: string;

packages/cli/tests/list-pagination.test.ts

@@ -1,8 +1,8 @@
-import { afterEach, beforeEach, describe, expect, test } from "vitest";
-import { mkdirSync, mkdtempSync, rmSync } from "node:fs";
 import { execFileSync } from "node:child_process";
+import { mkdirSync, mkdtempSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
+import { afterEach, beforeEach, describe, expect, test } from "vitest";
 import { envValue, runCli } from "./helpers.js";
 
 const HASH_RE = /^[0-9A-HJKMNP-TV-Z]{13}$/;

packages/cli/tests/list-tag-filter.test.ts

@@ -1,8 +1,8 @@
-import { afterEach, beforeEach, describe, expect, test } from "vitest";
-import { mkdirSync, rmSync } from "node:fs";
 import { execFileSync } from "node:child_process";
+import { mkdirSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
+import { afterEach, beforeEach, describe, expect, test } from "vitest";
 
 let testDir: string;
 let storePath: string;

packages/cli/tests/pipe.test.ts

@@ -1,8 +1,8 @@
-import { afterAll, beforeAll, describe, expect, test } from "vitest";
-import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { execFileSync } from "node:child_process";
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join, resolve } from "node:path";
+import { afterAll, beforeAll, describe, expect, test } from "vitest";
 import { envValue } from "./helpers";
 
 const entrypoint = resolve(import.meta.dirname, "../dist/index.js");

packages/cli/tests/put-get-has.test.ts

@@ -1,8 +1,8 @@
-import { afterAll, beforeAll, describe, expect, test } from "vitest";
-import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { execFileSync } from "node:child_process";
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join, resolve } from "node:path";
+import { afterAll, beforeAll, describe, expect, test } from "vitest";
 import { envValue, stripVolatile } from "./helpers";
 
 const entrypoint = resolve(import.meta.dirname, "../dist/index.js");

packages/cli/tests/render.test.ts

@@ -1,10 +1,10 @@
-import { afterAll, beforeAll, describe, expect, test } from "vitest";
-import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { execFileSync } from "node:child_process";
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join, resolve } from "node:path";
 import { bootstrap } from "@ocas/core";
 import { openStore as openFsStore } from "@ocas/fs";
+import { afterAll, beforeAll, describe, expect, test } from "vitest";
 import { envValue, putSchemaFile, runCli, runCliWithStdin } from "./helpers";
 
 const entrypoint = resolve(import.meta.dirname, "../dist/index.js");

packages/cli/tests/schema-validation.test.ts

@@ -1,8 +1,8 @@
-import { afterAll, beforeAll, describe, expect, test } from "vitest";
-import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { execFileSync } from "node:child_process";
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join, resolve } from "node:path";
+import { afterAll, beforeAll, describe, expect, test } from "vitest";
 import { envValue, putSchemaFile, runCli } from "./helpers";
 
 // ---- Issue #50: Schema Validation in put Command ----

packages/cli/tests/tag-untag.test.ts

@@ -1,11 +1,11 @@
-import { afterEach, beforeEach, describe, expect, test } from "vitest";
-import { mkdirSync, rmSync } from "node:fs";
 import { execFileSync } from "node:child_process";
+import { mkdirSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import type { Hash } from "@ocas/core";
 import { bootstrap } from "@ocas/core";
 import { openStore as openFsStore } from "@ocas/fs";
+import { afterEach, beforeEach, describe, expect, test } from "vitest";
 
 let testDir: string;
 let storePath: string;

packages/cli/tests/template.test.ts

@@ -1,11 +1,11 @@
-import { afterEach, beforeEach, describe, expect, test } from "vitest";
-import { mkdirSync, rmSync, writeFileSync } from "node:fs";
 import { execFileSync } from "node:child_process";
+import { mkdirSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import type { Hash, Store } from "@ocas/core";
 import { bootstrap } from "@ocas/core";
 import { openStore as openFsStore } from "@ocas/fs";
+import { afterEach, beforeEach, describe, expect, test } from "vitest";
 
 // ---- Test helpers ----
 

packages/cli/tests/usage-doc.test.ts

@@ -1,6 +1,6 @@
-import { describe, expect, test } from "vitest";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
+import { describe, expect, test } from "vitest";
 
 const usagePath = join(import.meta.dirname, "..", "prompts", "usage.md");
 

packages/cli/tests/variable-history.test.ts

@@ -1,11 +1,11 @@
-import { afterEach, beforeEach, describe, expect, test } from "vitest";
-import { mkdirSync, rmSync } from "node:fs";
 import { execFileSync } from "node:child_process";
+import { mkdirSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import type { Hash, Store } from "@ocas/core";
 import { bootstrap } from "@ocas/core";
 import { openStore as openFsStore } from "@ocas/fs";
+import { afterEach, beforeEach, describe, expect, test } from "vitest";
 
 let testDir: string;
 let storePath: string;

packages/cli/tests/variable.test.ts

@@ -1,11 +1,11 @@
-import { afterEach, beforeEach, describe, expect, test } from "vitest";
-import { mkdirSync, rmSync } from "node:fs";
 import { execFileSync } from "node:child_process";
+import { mkdirSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import type { Hash, Store } from "@ocas/core";
 import { bootstrap, putSchema } from "@ocas/core";
 import { openStore as openFsStore } from "@ocas/fs";
+import { afterEach, beforeEach, describe, expect, test } from "vitest";
 
 // ---- Test helpers ----
 

packages/cli/tests/verify-refs-walk.test.ts

@@ -1,8 +1,8 @@
-import { afterAll, beforeAll, describe, expect, test } from "vitest";
-import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { execFileSync } from "node:child_process";
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join, resolve } from "node:path";
+import { afterAll, beforeAll, describe, expect, test } from "vitest";
 import { envValue, stripVolatile } from "./helpers";
 
 const entrypoint = resolve(import.meta.dirname, "../dist/index.js");

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ocas/core",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

packages/core/src/no-sqlite.test.ts

@@ -1,6 +1,6 @@
-import { describe, expect, test } from "vitest";
 import { readdirSync, readFileSync, statSync } from "node:fs";
 import { join } from "node:path";
+import { describe, expect, test } from "vitest";
 
 function* walk(dir: string): Generator<string> {
   for (const name of readdirSync(dir)) {

packages/core/src/types-store.test.ts

@@ -1,6 +1,6 @@
-import { describe, expect, test } from "vitest";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
+import { describe, expect, test } from "vitest";
 import type {
   CasNode,
   CasStore,

packages/fs/CHANGELOG.md

@@ -1,5 +1,9 @@
 # @ocas/fs
 
+## 0.3.0 — 2026-06-03
+
+- Migrate from better-sqlite3 to built-in node:sqlite — zero native addon dependencies, no more NODE_MODULE_VERSION mismatch across Node upgrades.
+
 ## 0.2.0
 
 ### Breaking Changes

packages/fs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ocas/fs",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -16,7 +16,6 @@
   ],
   "dependencies": {
     "@ocas/core": "workspace:*",
-    "better-sqlite3": "^12.10.0",
     "cborg": "^4.2.3"
   },
   "repository": {
@@ -29,7 +28,6 @@
     "url": "https://github.com/shazhou-ww/ocas/issues"
   },
   "devDependencies": {
-    "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^25.9.1"
   }
 }

packages/fs/src/index.ts

@@ -1,2 +1,2 @@
-export { createFsStore, openStore, prepareStore } from "./store.js";
 export { createSqliteVarStore } from "./sqlite-store.js";
+export { createFsStore, openStore, prepareStore } from "./store.js";

packages/fs/src/sqlite-store.ts

@@ -1,6 +1,6 @@
 import { existsSync, mkdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
-import Database from "better-sqlite3";
+import { DatabaseSync } from "node:sqlite";
 import type {
   CasStore,
   Hash,
@@ -27,19 +27,31 @@ import {
   varKey,
 } from "@ocas/core";
 
+function transaction<T>(db: DatabaseSync, fn: () => T): T {
+  db.exec("BEGIN");
+  try {
+    const r = fn();
+    db.exec("COMMIT");
+    return r;
+  } catch (e) {
+    db.exec("ROLLBACK");
+    throw e;
+  }
+}
+
 const DB_FILE = "_store.db";
 const VARS_FILE = "_vars.jsonl";
 const TAGS_FILE = "_tags.jsonl";
 
-function openDb(dir: string): Database.Database {
+function openDb(dir: string): DatabaseSync {
   mkdirSync(dir, { recursive: true });
-  const db = new Database(join(dir, DB_FILE));
-  db.pragma("journal_mode = WAL");
-  db.pragma("foreign_keys = ON");
+  const db = new DatabaseSync(join(dir, DB_FILE));
+  db.exec("PRAGMA journal_mode = WAL");
+  db.exec("PRAGMA foreign_keys = ON");
   return db;
 }
 
-function initVarTables(db: Database.Database): void {
+function initVarTables(db: DatabaseSync): void {
   db.exec(`
     CREATE TABLE IF NOT EXISTS vars (
       name     TEXT NOT NULL,
@@ -67,7 +79,7 @@ function initVarTables(db: Database.Database): void {
   `);
 }
 
-function initTagTables(db: Database.Database): void {
+function initTagTables(db: DatabaseSync): void {
   db.exec(`
     CREATE TABLE IF NOT EXISTS tags (
       target   TEXT NOT NULL,
@@ -90,11 +102,7 @@ type StoredTag = {
   created: number;
 };
 
-function migrateJsonlVars(
-  db: Database.Database,
-  dir: string,
-  _cas: CasStore,
-): void {
+function migrateJsonlVars(db: DatabaseSync, dir: string, _cas: CasStore): void {
   const path = join(dir, VARS_FILE);
   if (!existsSync(path)) return;
 
@@ -131,7 +139,7 @@ function migrateJsonlVars(
     VALUES (?, ?, ?, ?, ?)
   `);
 
-  const migrate = db.transaction(() => {
+  transaction(db, () => {
     for (const rec of records.values()) {
       insertVar.run(
         rec.name,
@@ -147,10 +155,9 @@ function migrateJsonlVars(
       }
     }
   });
-  migrate();
 }
 
-function migrateJsonlTags(db: Database.Database, dir: string): void {
+function migrateJsonlTags(db: DatabaseSync, dir: string): void {
   const path = join(dir, TAGS_FILE);
   if (!existsSync(path)) return;
 
@@ -196,14 +203,13 @@ function migrateJsonlTags(db: Database.Database, dir: string): void {
     VALUES (?, ?, ?, ?)
   `);
 
-  const migrate = db.transaction(() => {
+  transaction(db, () => {
     for (const tm of byTarget.values()) {
       for (const tag of tm.values()) {
         insertTag.run(tag.target, tag.key, tag.value, tag.created);
       }
     }
   });
-  migrate();
 }
 
 // ── Row helpers ──
@@ -304,17 +310,17 @@ export function createSqliteVarStore(
 
   // ── Transactional helpers ──
 
-  const txnSetVar = db.transaction(
-    (
-      name: string,
-      schema: Hash,
-      hash: Hash,
-      now: number,
-      tagsJson: string,
-      labelsJson: string,
-      isNew: boolean,
-      valueChanged: boolean,
-    ) => {
+  function txnSetVar(
+    name: string,
+    schema: Hash,
+    hash: Hash,
+    now: number,
+    tagsJson: string,
+    labelsJson: string,
+    isNew: boolean,
+    valueChanged: boolean,
+  ): void {
+    transaction(db, () => {
       if (isNew) {
         stmtInsertVar.run(name, schema, hash, now, now, tagsJson, labelsJson);
         stmtInsertHistory.run(name, schema, hash, 0, now);
@@ -329,11 +335,11 @@ export function createSqliteVarStore(
       } else {
         stmtUpdateVar.run(hash, now, tagsJson, labelsJson, name, schema);
       }
-    },
-  );
+    });
+  }
 
-  const txnTagOps = db.transaction(
-    (target: Hash, operations: TagOp[], now: number) => {
+  function txnTagOps(target: Hash, operations: TagOp[], now: number): void {
+    transaction(db, () => {
       for (const op of operations) {
         if (op.op === "set") {
           // Use ON CONFLICT to preserve created time — but we need existing created
@@ -346,14 +352,16 @@ export function createSqliteVarStore(
           stmtDeleteTag.run(target, op.key);
         }
       }
-    },
-  );
+    });
+  }
 
-  const txnUntag = db.transaction((target: Hash, keys: string[]) => {
-    for (const k of keys) {
-      stmtDeleteTag.run(target, k);
-    }
-  });
+  function txnUntag(target: Hash, keys: string[]): void {
+    transaction(db, () => {
+      for (const k of keys) {
+        stmtDeleteTag.run(target, k);
+      }
+    });
+  }
 
   // ── VarStore implementation ──
   const varStore: VarStore = {
@@ -516,7 +524,7 @@ export function createSqliteVarStore(
 
       // Build dynamic query
       const conditions: string[] = [];
-      const params: unknown[] = [];
+      const params: (string | number | null)[] = [];
 
       if (options?.exactName !== undefined) {
         conditions.push("name = ?");
@@ -650,7 +658,7 @@ export function createSqliteVarStore(
       const limit = options?.limit;
 
       let sql: string;
-      const params: unknown[] = [key];
+      const params: (string | number | null)[] = [key];
       if (value !== undefined) {
         sql = `SELECT target FROM tags WHERE key = ? AND value = ? ORDER BY ${sortCol} ${sortDir}`;
         params.push(value);

packages/fs/src/store.test.ts

@@ -1,4 +1,3 @@
-import { afterEach, beforeEach, describe, expect, test } from "vitest";
 import {
   existsSync,
   mkdtempSync,
@@ -17,6 +16,7 @@ import {
   computeSelfHash,
   verify,
 } from "@ocas/core";
+import { afterEach, beforeEach, describe, expect, test } from "vitest";
 
 import { createFsStore, openStore } from "./store.js";
 

packages/fs/src/tag-store.test.ts

@@ -1,7 +1,7 @@
-import { afterEach, beforeEach, describe, expect, test } from "vitest";
 import { existsSync, mkdtempSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
+import { afterEach, beforeEach, describe, expect, test } from "vitest";
 import { openStore } from "./store.js";
 
 const T1 = "AAAAAAAAAAAAA";

packages/fs/src/var-store.test.ts

@@ -1,4 +1,3 @@
-import { afterEach, beforeEach, describe, expect, test } from "vitest";
 import { existsSync, mkdtempSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
@@ -11,6 +10,7 @@ import {
   TagLabelConflictError,
   VariableNotFoundError,
 } from "@ocas/core";
+import { afterEach, beforeEach, describe, expect, test } from "vitest";
 import { openStore } from "./store.js";
 
 const META_TYPE_KEY = Symbol.for("@ocas/core/bootstrap-store");