release: @ocas/cli@0.3.1

Fixes #70, #71, #72, #73

.cards/cli.md

@@ -17,7 +17,7 @@ The `ocas` CLI is the primary interface for interacting with an OCAS [[Store]].
 | 2 | `OCAS_HOME` env var | `export OCAS_HOME=/data/ocas` |
 | 3 | Default | `~/.ocas` |
 
-The variable database lives at `<home>/variables.db` by default, overridable with `--var-db <path>`.
+The SQLite database lives at `<home>/_store.db`.
 
 ## Commands
 

.cards/store.md

@@ -53,7 +53,7 @@ In-memory `Map<Hash, CasNode>`. Used in tests and for ephemeral computation (e.g
 
 ### FsStore (`@ocas/fs`)
 
-Filesystem-backed store. Nodes are serialized as CBOR files under a content-addressed directory tree. Created via `openStore(path)`, which:
+Filesystem-backed store. CAS nodes are stored as CBOR files; variables and tags use SQLite (`node:sqlite`). Created via `openStore(path)`, which:
 
 1. Creates the directory if it doesn't exist
 2. Runs [[Bootstrap]] automatically

CLAUDE.md

@@ -20,7 +20,7 @@ Monorepo with 3 packages under `packages/`:
 - **Test:** Vitest (`npx vitest run`)
 - **Package Manager:** pnpm (workspace)
 - **Lint/Format:** Biome (`biome check .` / `biome format --write .`)
-- **Publish:** Changesets + `pnpm publish` → npmjs (`@ocas/*`)
+- **Publish:** @shazhou/proman (`proman bump` + `proman publish`)
 
 ## Commands
 
@@ -98,10 +98,7 @@ This is resolved to real version numbers only during publishing (see below).
 
 ## Release Process
 
-Releases use a **release branch** workflow with three phases: prepare → candidate → finalize.
+Uses `@shazhou/proman` for releases. No release branches needed.
-
-`main` always keeps `workspace:*` for internal deps; release branches fix them to real versions.
-Changeset files are **only consumed once** during finalize — prerelease (rc) never touches them.
 
 ### Adding a Changeset
 
@@ -110,7 +107,7 @@ Add changesets alongside feature PRs on `main`:
 ```markdown
 <!-- .changeset/my-change.md -->
 ---
-"@ocas/cli": patch
+"@ocas/fs": minor
 ---
 
 Description of the change
@@ -119,44 +116,15 @@ Description of the change
 Changesets live in `.changeset/` as markdown files. Bump types: `patch` / `minor` / `major`.
 One changeset can cover multiple packages.
 
-### Phase 1: Prepare (cut release branch)
+### Release Steps
 
-- **Precondition:** on `main`, clean tree, `.changeset/` has pending changesets
+1. `proman bump` — consume changesets and bump versions
-- **Steps:**
+2. `proman publish` — build → test → check → publish → changelog → tag → push
-  1. Determine target version (from changeset bump types or manually)
-  2. `git checkout -b release/<version>`
-  3. Fix `workspace:*` → real version numbers in all `package.json`
-  4. Commit
-- **Does NOT** run `changeset version`, does NOT write CHANGELOG
 
-### Phase 2: Candidate (publish rc for validation)
+The publish command handles everything: workspace dependency resolution, npm publish order (core → fs → cli), changelog generation, git tagging, and pushing.
-
-- **Precondition:** on `release/*` branch
-- **Steps:**
-  1. Set version to `<version>-rc.N` (first time rc.1, increment on subsequent runs)
-  2. `pnpm install && pnpm run build && pnpm run test && pnpm run check`
-  3. Publish: `pnpm publish --tag rc` (order: core → fs → cli)
-  4. Commit + push
-- **Repeatable:** fix bugs → add new changesets on the release branch → rc.N+1
-- **Does NOT** consume changesets, does NOT write CHANGELOG
-- Install for testing: `pnpm add -g @ocas/cli@rc`
-
-### Phase 3: Finalize (official release)
-
-- **Precondition:** on `release/*` branch, rc validated
-- **Steps:**
-  1. Consume all `.changeset/*.md` → write CHANGELOG entries (use `changeset version` or manual)
-  2. Set final version `<version>` (remove `-rc.N`)
-  3. `pnpm install && pnpm run build && pnpm run test && pnpm run check`
-  4. Publish: `pnpm publish --tag latest` (order: core → fs → cli)
-  5. Git tag `v<version>`
-  6. Merge back to `main` (CHANGELOG comes along)
-  7. Restore `workspace:*` on `main`
-  8. Delete release branch
 
 ### Key Rules
 
 - **Publish order** is always `@ocas/core` → `@ocas/fs` → `@ocas/cli`
-- **`workspace:*`** must be fixed before any publish — `pnpm publish` does NOT auto-replace them
+- **`workspace:*`** is auto-resolved by pnpm during publish
-- **CHANGELOG** only contains official releases, never rc entries
+- **CHANGELOG** only contains official releases
-- **Changesets added on release branch** (bug fixes during rc) are consumed together at finalize

README.md

@@ -7,11 +7,13 @@ Every node has a typed payload: its `type` field is the hash of a JSON Schema th
 ## Install
 
 ```bash
-bun add -g @ocas/cli
+pnpm add -g @ocas/cli
 ```
 
 The store is auto-created and bootstrapped on first use — no `init` command needed.
 
+> Requires Node.js >= 22.5.0 (uses built-in node:sqlite)
+
 ## Quick Start
 
 ```bash
@@ -190,8 +192,8 @@ Nodes reachable from any variable binding are kept; everything else is swept.
 ## Using as a Library
 
 ```bash
-bun add @ocas/core              # in-memory store
+pnpm add @ocas/core              # in-memory store
-bun add @ocas/core @ocas/fs     # + filesystem persistence
+pnpm add @ocas/core @ocas/fs     # + filesystem persistence
 ```
 
 ```typescript
@@ -214,9 +216,9 @@ const node = store.get(hash);
 For filesystem persistence, use `@ocas/fs`:
 
 ```typescript
-import { openStoreAndVarStore } from "@ocas/fs";
+import { openStore } from "@ocas/fs";
 
-const { store, varStore } = await openStoreAndVarStore("/path/to/store");
+const store = await openStore("/path/to/store");
 ```
 
 See individual package READMEs for full API docs:
@@ -228,11 +230,11 @@ See individual package READMEs for full API docs:
 
 ```bash
 git clone <repo-url> && cd ocas
-bun install --no-cache
+pnpm install
-bun run build     # tsc --build
+pnpm run build     # tsc --build
-bun test          # run all tests
+pnpm test          # run all tests
-bun run check     # biome lint
+pnpm run check     # biome lint
-bun run format    # biome format
+pnpm run format    # biome format
 ```
 
 ## License

docs/sync-readme.md

@@ -17,8 +17,8 @@ The root README should have these sections in order:
 4. **Packages** — table with ALL packages from packages/ directory, columns: Package, Description, Type (cli/lib)
 5. **Quick Start** — install, build, basic usage
 6. **CLI Reference** — brief command list, detailed usage in cli README
-7. **Development** — bun install / build / check / test
+7. **Development** — pnpm install / build / check / test
-8. **Publishing** — changeset workflow (bun run release)
+8. **Publishing** — `proman bump` + `proman publish`
 
 ## Per-Package README Structure
 
@@ -27,7 +27,7 @@ Each package README should have:
 1. **Title** — package name
 2. **One-line description** — matching package.json
 3. **Overview** — what it does, where it sits in the architecture, dependencies
-4. **Installation** — bun add (for libs) or "included as binary" (for cli)
+4. **Installation** — pnpm add (for libs) or "included as binary" (for cli)
 5. **API** (lib packages) — all exports from src/index.ts with type signatures, grouped by category, minimal usage examples
 6. **CLI Usage** (cli packages) — command reference with examples
 7. **Internal Structure** — brief src/ file organization
@@ -57,7 +57,7 @@ For each package read:
 - All relative links work
 - Package names match package.json
 - No references to removed/renamed packages
-- bun run build still passes
+- pnpm run build still passes
 
 ## Guidelines
 

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",
+      "esbuild"
-      "better-sqlite3"
+    ],
-    ]
+    "overrides": {}
   }
 }

packages/cli/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @ocas/cli
 
+## 0.3.1
+
+### Patch Changes
+
+- Fix prompt docs: `bun` → `pnpm` install instructions, remove stale `--var-db` flag from usage docs.
+
 ## 0.2.0
 
 ### Breaking Changes

packages/cli/README.md

@@ -15,17 +15,17 @@ The store is **auto-created and bootstrapped** on first use, so there is no `ini
 Published as an npm package with a binary entry:
 
 ```bash
-bun add -g @ocas/cli
+pnpm add -g @ocas/cli
 # or from the monorepo workspace:
-bun link
+pnpm link
 ```
 
-**Binary name:** `ocas` (points to `src/index.ts`, run with Bun).
+**Binary name:** `ocas` (points to `dist/index.js`, run with Node).
 
 In development:
 
 ```bash
-bun packages/cli-ocas/src/index.ts <command> [args]
+node packages/cli/dist/index.js <command> [args]
 ```
 
 ## CLI Usage

packages/cli/package.json

@@ -1,6 +1,15 @@
 {
   "name": "@ocas/cli",
-  "version": "0.2.2",
+  "version": "0.3.1",
+  "description": "CLI for OCAS content-addressed store",
+  "keywords": [
+    "cas",
+    "cli",
+    "content-addressing"
+  ],
+  "engines": {
+    "node": ">=22.5.0"
+  },
   "type": "module",
   "bin": {
     "ocas": "dist/index.js"

packages/cli/prompts/setup.md

@@ -9,7 +9,7 @@ so that you know how to use the `ocas` CLI.
    ```bash
    ocas --help
    ```
-   If not installed: `bun add -g @ocas/cli`
+   If not installed: `pnpm add -g @ocas/cli`
 
 2. **Clean up old versions of the skill** (if any exist):
    - Look for any existing OCAS/ocas skill files in your skill directories

packages/cli/prompts/usage.md

@@ -6,7 +6,7 @@ OCAS is a self-describing content-addressable store for typed JSON data. Every n
 
 All commands output `{ type, value }` JSON envelopes, making them composable via pipes.
 
-**Install:** `bun add -g @ocas/cli`
+**Install:** `pnpm add -g @ocas/cli`
 
 **Packages:** `@ocas/core` (engine) · `@ocas/fs` (filesystem store) · `@ocas/cli` (CLI)
 
@@ -138,7 +138,6 @@ ocas gc | ocas render -p   # human-readable stats
 | Flag | Description |
 |------|-------------|
 | `--home <path>` | Store directory (default: `$OCAS_HOME` or `~/.ocas`) |
-| `--var-db <path>` | Variable database path |
 | `--json` | Compact JSON output |
 | `-p`, `--pipe` | Read from stdin |
 | `-r`, `--render` | Render output inline |

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/README.md

@@ -6,14 +6,14 @@ Core CAS engine — hashing, schema, store, verify, bootstrap.
 
 `@ocas/core` is the foundation of the ocas monorepo. It defines content-addressed nodes (`CasNode`), the `Store` interface, XXH64-based hashing with deterministic CBOR, JSON Schema registration and validation (including `cas_ref` links between nodes), bootstrap seeding, and integrity verification.
 
-Other packages build on this layer: `ocas-fs` provides persistence, and `cli-ocas` exposes store operations on the command line.
+Other packages build on this layer: `@ocas/fs` provides persistence, and `@ocas/cli` exposes store operations on the command line.
 
-**Dependencies:** `ajv`, `cborg`, `xxhash-wasm`
+**Dependencies:** `ajv`, `cborg`, `liquidjs`, `xxhash-wasm`
 
 ## Installation
 
 ```bash
-bun add @ocas/core
+pnpm add @ocas/core
 ```
 
 ## API
@@ -32,12 +32,7 @@ type CasNode<T = unknown> = {
   timestamp: number; // Unix epoch ms
 };
 
-type Store = {
+type Store = { cas: CasStore; var: VarStore; tag: TagStore; };
-  put(typeHash: Hash, payload: unknown): Promise<Hash>;
-  get(hash: Hash): CasNode | null;
-  has(hash: Hash): boolean;
-  listByType(typeHash: Hash): Hash[];
-};
 
 type JSONSchema = Record<string, unknown>;
 

packages/core/package.json

@@ -1,6 +1,16 @@
 {
   "name": "@ocas/core",
-  "version": "0.2.2",
+  "version": "0.3.0",
+  "description": "Core CAS engine — hashing, schema, store, verify, bootstrap",
+  "keywords": [
+    "cas",
+    "content-addressing",
+    "json-schema",
+    "typescript"
+  ],
+  "engines": {
+    "node": ">=22.5.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/README.md

@@ -4,7 +4,7 @@ Filesystem-backed CAS store.
 
 ## Overview
 
-`@ocas/fs` implements a persistent `Store` on disk. Each node is stored as `<hash>.bin` (CBOR-encoded `CasNode`). A `_index/` directory maps type hashes to content hashes for `listByType`. Stores support bootstrap via the same `BOOTSTRAP_STORE` symbol as the in-memory implementation.
+`@ocas/fs` implements a persistent `Store` backed by `node:sqlite` (`DatabaseSync`). Nodes are stored as CBOR blobs in SQLite tables. Stores support bootstrap via the same `BOOTSTRAP_STORE` symbol as the in-memory implementation.
 
 Depends on `@ocas/core` for hashing, CBOR encoding, and types.
 
@@ -13,7 +13,7 @@ Depends on `@ocas/core` for hashing, CBOR encoding, and types.
 ## Installation
 
 ```bash
-bun add @ocas/fs
+pnpm add @ocas/fs
 ```
 
 ## API
@@ -21,19 +21,18 @@ bun add @ocas/fs
 Exported from `src/index.ts`:
 
 ```typescript
-function createFsStore(dir: string): BootstrapCapableStore;
+function openStore(path: string): Promise<Store>;
 ```
 
-Returns a `BootstrapCapableStore` from `@ocas/core`. The store loads existing `.bin` files on open and migrates or builds the type index on first use.
+Returns a unified `Store` with `cas`, `var`, and `tag` sub-stores, backed by SQLite. Bootstraps automatically on open.
 
 ### Example
 
 ```typescript
-import { bootstrap, putSchema } from "@ocas/core";
+import { putSchema } from "@ocas/core";
-import { createFsStore } from "@ocas/fs";
+import { openStore } from "@ocas/fs";
 
-const store = createFsStore("./my-cas-store");
+const store = await openStore("./my-cas-store");
-await bootstrap(store);
 
 const typeHash = await putSchema(store, {
   type: "object",
@@ -46,18 +45,6 @@ const hash = await store.put(typeHash, { id: "item-1" });
 console.log(store.has(hash)); // true after restart if same dir
 ```
 
-### On-disk layout
-
-```
-my-cas-store/
-├── <hash>.bin          # CBOR CasNode
-├── _index/
-│   └── <typeHash>      # newline-separated content hashes
-└── ...
-```
-
-Writes use atomic rename (`<hash>.tmp` → `<hash>.bin`).
-
 ## Internal Structure
 
 | File | Purpose |

packages/fs/package.json

@@ -1,6 +1,16 @@
 {
   "name": "@ocas/fs",
-  "version": "0.2.2",
+  "version": "0.3.0",
+  "description": "Filesystem-backed CAS store with SQLite",
+  "keywords": [
+    "cas",
+    "filesystem",
+    "sqlite",
+    "storage"
+  ],
+  "engines": {
+    "node": ">=22.5.0"
+  },
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -16,7 +26,6 @@
   ],
   "dependencies": {
     "@ocas/core": "workspace:*",
-    "better-sqlite3": "^12.10.0",
     "cborg": "^4.2.3"
   },
   "repository": {
@@ -29,7 +38,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));
+  const db = new DatabaseSync(join(dir, DB_FILE));
-  db.pragma("journal_mode = WAL");
+  db.exec("PRAGMA journal_mode = WAL");
-  db.pragma("foreign_keys = ON");
+  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(
+function migrateJsonlVars(db: DatabaseSync, dir: string, _cas: CasStore): void {
-  db: Database.Database,
-  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(
+  function txnSetVar(
-    (
+    name: string,
-      name: string,
+    schema: Hash,
-      schema: Hash,
+    hash: Hash,
-      hash: Hash,
+    now: number,
-      now: number,
+    tagsJson: string,
-      tagsJson: string,
+    labelsJson: string,
-      labelsJson: string,
+    isNew: boolean,
-      isNew: boolean,
+    valueChanged: 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(
+  function txnTagOps(target: Hash, operations: TagOp[], now: number): void {
-    (target: Hash, operations: TagOp[], now: number) => {
+    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[]) => {
+  function txnUntag(target: Hash, keys: string[]): void {
-    for (const k of keys) {
+    transaction(db, () => {
-      stmtDeleteTag.run(target, k);
+      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");