@cleocode/cant 2026.9.23 → 2026.9.25

package/README.md

@@ -17,10 +17,9 @@ typed frontmatter.
 pnpm add @cleocode/cant
 ```
 
-The package ships pre-built napi binaries via `optionalDependencies` for
-`x86_64-unknown-linux-gnu`. On other platforms `@cleocode/cant` falls back to
-typed errors at runtime — the TypeScript surface still loads but
-parser/validator/executor calls require a native binding present.
+The package bundles pre-built napi binaries for every supported platform, with
+a WebAssembly (WASI) fallback for the rest — see
+[Native binaries and the WebAssembly fallback](#native-binaries-and-the-webassembly-fallback).
 
 **`cant-core` is the single source of truth (SSoT) for all CANT parsing.**
 There is no JS-regex fallback parser in the routine code path. If the native
@@ -146,6 +145,12 @@ The published package bundles the cant-napi addon for every supported
 platform in `napi/` (T12382): native binaries for linux x64/arm64 (glibc and
 musl), darwin x64/arm64 and win32 x64/arm64, plus
 `cant.wasm32-wasi.wasm`, the same crate built for `wasm32-wasip1-threads`.
+
+**glibc floor on ARM64 Linux:** `linux-arm64-gnu` is built on GitHub's native
+`ubuntu-24.04-arm` runner, so it requires glibc ≥ 2.39 (Ubuntu 24.04+ /
+Debian 13+). Older ARM64 Linux loads the WebAssembly build instead (the
+fallback below), and the native worktree helper in `@cleocode/worktree` is
+unavailable there. musl (Alpine) ARM64 is unaffected.
 The napi-rs generated loader (`napi/index.cjs`) uses the native binary for
 the host and falls back to the WebAssembly build automatically when none
 matches. `NAPI_RS_FORCE_WASI=error` forces the WebAssembly build (tests use

package/dist/native-loader.d.ts

@@ -151,7 +151,8 @@ export declare function isNativeAvailable(): boolean;
 export declare function cantAddonBackend(): CantAddonBackend | null;
 /**
  * Return the source-revision stamp compiled into the loaded addon, e.g.
- * `"cant-napi-source-rev:<git sha>"` (`"…:unversioned"` for local builds).
+ * `"cant-napi-source-rev:<native source hash>"` (`"…:unversioned"` for local builds;
+ * the hash is `node scripts/native-source-hash.mjs cant`).
  *
  * @returns The stamp, or `null` when the addon could not be loaded.
  */

package/dist/native-loader.js

@@ -98,7 +98,8 @@ function cantAddonBackend() {
 }
 /**
  * Return the source-revision stamp compiled into the loaded addon, e.g.
- * `"cant-napi-source-rev:<git sha>"` (`"…:unversioned"` for local builds).
+ * `"cant-napi-source-rev:<native source hash>"` (`"…:unversioned"` for local builds;
+ * the hash is `node scripts/native-source-hash.mjs cant`).
  *
  * @returns The stamp, or `null` when the addon could not be loaded.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/cant",
-  "version": "2026.9.23",
+  "version": "2026.9.25",
   "description": "CANT DSL — cant-core (SSoT) parser, validator, and pipeline executor via napi-rs; agent identity, message parsing, and migration utilities",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -16,9 +16,9 @@
     "@emnapi/core": "1.11.3",
     "@emnapi/runtime": "1.11.3",
     "@napi-rs/wasm-runtime": "1.2.4",
-    "@cleocode/contracts": "2026.9.23",
-    "@cleocode/core": "2026.9.23",
-    "@cleocode/lafs": "2026.9.23"
+    "@cleocode/contracts": "2026.9.25",
+    "@cleocode/core": "2026.9.25",
+    "@cleocode/lafs": "2026.9.25"
   },
   "devDependencies": {
     "typescript": "^6.0.2",