From c9b9befdea079308046899a23323b2a908d91ac7 Mon Sep 17 00:00:00 2001 From: gabewillen Date: Fri, 7 Aug 2026 02:29:27 -0500 Subject: [PATCH 1/2] chore: prepare Cortext v1.3.2 metadata --- CMakeLists.txt | 2 +- README.md | 2 +- RELEASE.md | 42 +++++++++++++++++++++++++++--------------- build.zig | 4 ++-- build.zig.zon | 2 +- models/manifest.json | 2 +- 6 files changed, 33 insertions(+), 21 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index b342ae0d..8d6023b9 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,5 +1,5 @@ cmake_minimum_required(VERSION 3.16) -project(cortext VERSION 1.3.1 LANGUAGES C CXX) +project(cortext VERSION 1.3.2 LANGUAGES C CXX) set(CORTEXT_TARGET_IOS OFF) if(IOS OR CMAKE_SYSTEM_NAME STREQUAL "iOS" OR CMAKE_OSX_SYSROOT MATCHES "iphone") diff --git a/README.md b/README.md index fe4b238a..270fd7bd 100644 --- a/README.md +++ b/README.md @@ -425,7 +425,7 @@ env var — use the paths the runtime and bindings already read (`CORTEXT_LIBRARY_PATH`, `CORTEXT_AIST_MODEL_PATH`): ```bash -ASSETS_VERSION=1.3.1 # or the release you want +ASSETS_VERSION=1.3.2 # or the release you want ASSETS="$HOME/.cache/augmem/cortext/assets" curl -fsSL -o cortext-assets.tgz \ "https://github.com/augmem/cortext.cpp/releases/download/v${ASSETS_VERSION}/cortext-assets-${ASSETS_VERSION}.tar.gz" diff --git a/RELEASE.md b/RELEASE.md index db3e91d6..f22419c6 100644 --- a/RELEASE.md +++ b/RELEASE.md @@ -1,15 +1,15 @@ -# Cortext v1.3.1 Release Artifact +# Cortext v1.3.2 Release Artifact -This tracked artifact prepares the `v1.3.1` release metadata. It does not create +This tracked artifact prepares the `v1.3.2` release metadata. It does not create the tag or publish the release. ## Release State -- Version: `1.3.1` +- Version: `1.3.2` - Merged feature baseline before release metadata: - `b26bc30ab76bd50731382a15a503c7891d12612a` (PR #13 — Node text-media - N-API bridge). -- Release source: the integrated commit addressed by the annotated `v1.3.1` + `aa59e38e93f2b74798f2877132ebb56817fdde8c` (PR #17 — ARM `sqlite-vec` + NEON portability; includes PR #16's Windows ARM clang-cl fix). +- Release source: the integrated commit addressed by the annotated `v1.3.2` tag; the GitHub release and shared native assets are rebuilt from that exact commit. - Product surface: C++ facade, stable C ABI, optional N-API/`ffi/node` addon, @@ -19,6 +19,11 @@ the tag or publish the release. ## Highlights +- Includes the Windows ARM clang-cl portability fix: Clang-based ARM builds can + embed the AIST model without being rejected by the MSVC-only embed guard. +- Includes the ARM `sqlite-vec` NEON portability fix: signed int8 L1 absolute + differences are reinterpreted before widening so large lane differences are + accumulated correctly without sign extension. - Adds the Node-API `processTextWithMediaJson` bridge for text processing with optional binary media, MIME type, and process options. The bridge consumes the merged C/C++ text-media API without adding a second native implementation. @@ -39,6 +44,12 @@ the tag or publish the release. ## Verification +- Pull request [#16](https://github.com/augmem/cortext.cpp/pull/16) is merged + at `8ac8fbc17b910b3cf1211916bfa5e9f7cc75fe28`, allowing clang-cl for ARM GGML + embedding. +- Pull request [#17](https://github.com/augmem/cortext.cpp/pull/17) is merged + at `aa59e38e93f2b74798f2877132ebb56817fdde8c`, preserving signed NEON + `sqlite-vec` L1 differences on ARM. - Pull request [#11](https://github.com/augmem/cortext.cpp/pull/11) merged at `b6709817959b81e4fbbd4b0eb9be0a8102d80eb1` with exact-head GitHub Actions CI green: native, architecture-native, AIST embed, WASM browser, sanitizers, @@ -53,21 +64,22 @@ the tag or publish the release. ## Packaging -- GitHub Release includes `cortext-assets-1.3.1.tar.gz` and its `.sha256`, - built by `.github/workflows/release-assets.yml` from the tagged tree. +- Release assets remain core-owned: the GitHub Release includes + `cortext-assets-1.3.2.tar.gz` and its `.sha256`, built by + `.github/workflows/release-assets.yml` from the tagged tree. - Default native libraries embed the shipping AIST q8_0 shards; the release asset tree also carries model shards for thin/embed-off consumers. -- Node prebuilds are built by the standalone `augmem/cortext.ts` release - pipeline from this exact `v1.3.1` tag. That pipeline configures CMake with - `CORTEXT_BUILD_NODE_BINDINGS=ON`, builds `cortext_node` on its host matrix, - and publishes the resulting `cortext.node` artifacts; this repository does - not publish Node prebuilds. +- TypeScript/Node prebuilds consume this exact `v1.3.2` tag through the + standalone `augmem/cortext.ts` release pipeline. That pipeline configures + CMake with `CORTEXT_BUILD_NODE_BINDINGS=ON`, builds + `cortext_node` on its host matrix, and publishes the resulting + `cortext.node` artifacts; this repository does not publish Node prebuilds. - Language package versions and registry publishing remain owned by the standalone sibling repositories, not this engine repository. ## Version Surfaces -The engine release surfaces report `1.3.1`: +The engine release surfaces report `1.3.2`: - `CMakeLists.txt` project version - `build.zig` `cortext_version` and library package version @@ -78,7 +90,7 @@ Language package versions are owned by their standalone sibling repositories. ## Publish Targets -- GitHub release tag: `v1.3.1` (engine + `cortext-assets-1.3.1.tar.gz`) +- GitHub release tag: `v1.3.2` (engine + `cortext-assets-1.3.2.tar.gz`) - Language packages: see sibling `augmem/cortext.py`, `augmem/cortext.ts`, `augmem/cortext.go`, `augmem/cortext.dart`, and `augmem/cortext.wasm` repositories. diff --git a/build.zig b/build.zig index b3742b68..13cbb39c 100644 --- a/build.zig +++ b/build.zig @@ -1,6 +1,6 @@ const std = @import("std"); -const cortext_version = "1.3.1"; +const cortext_version = "1.3.2"; const sqlite_header_template = @embedFile("third_party/sqlite/src/sqlite.h.in"); @@ -320,7 +320,7 @@ pub fn build(b: *std.Build) void { .name = "cortext", .linkage = if (shared) .dynamic else .static, .root_module = mod, - .version = .{ .major = 1, .minor = 3, .patch = 1 }, + .version = .{ .major = 1, .minor = 3, .patch = 2 }, }); // Keep Zig consumers on the same pinned hnswlib safety contract as the diff --git a/build.zig.zon b/build.zig.zon index 9aff2e27..a4ef8fa5 100644 --- a/build.zig.zon +++ b/build.zig.zon @@ -1,6 +1,6 @@ .{ .name = .cortext, - .version = "1.3.1", + .version = "1.3.2", .fingerprint = 0x474dfffd9e64ddfb, // Changing this has security and trust implications. .minimum_zig_version = "0.15.2", .dependencies = .{ diff --git a/models/manifest.json b/models/manifest.json index b06f1d4b..0375a208 100644 --- a/models/manifest.json +++ b/models/manifest.json @@ -1,6 +1,6 @@ { "schema": "augmem.cortext.models.v1", - "cortext_version": "1.3.1", + "cortext_version": "1.3.2", "note": "AIST model is Git-chunked under 100 MiB so it can live in ordinary Git without LFS. Language bindings reassemble and checksum on first use; do not re-shard in binding repos \u2014 copy this tree from cortext.", "assets": [ { From 89531f67302d973ffd0ab51ef6c4b4f7e1056251 Mon Sep 17 00:00:00 2001 From: gabewillen Date: Fri, 7 Aug 2026 02:35:56 -0500 Subject: [PATCH 2/2] docs: record PR18 ARM release baseline --- RELEASE.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/RELEASE.md b/RELEASE.md index f22419c6..73aa05ed 100644 --- a/RELEASE.md +++ b/RELEASE.md @@ -7,8 +7,9 @@ the tag or publish the release. - Version: `1.3.2` - Merged feature baseline before release metadata: - `aa59e38e93f2b74798f2877132ebb56817fdde8c` (PR #17 — ARM `sqlite-vec` - NEON portability; includes PR #16's Windows ARM clang-cl fix). + `35629cd8e50bd32a9e85dc4a8557bc3467ec73f8` (PR #18 — final ARM + `sqlite-vec` NEON portability helper; includes PR #17 and PR #16's Windows + ARM clang-cl fix). - Release source: the integrated commit addressed by the annotated `v1.3.2` tag; the GitHub release and shared native assets are rebuilt from that exact commit. @@ -50,6 +51,10 @@ the tag or publish the release. - Pull request [#17](https://github.com/augmem/cortext.cpp/pull/17) is merged at `aa59e38e93f2b74798f2877132ebb56817fdde8c`, preserving signed NEON `sqlite-vec` L1 differences on ARM. +- Pull request [#18](https://github.com/augmem/cortext.cpp/pull/18) is merged + at `35629cd8e50bd32a9e85dc4a8557bc3467ec73f8`; final helper commit `c9a0a93c` + corresponds to feature head `ad3b7750` and keeps signed/unsigned NEON lanes + portable across Apple Clang and GCC ARM builds. - Pull request [#11](https://github.com/augmem/cortext.cpp/pull/11) merged at `b6709817959b81e4fbbd4b0eb9be0a8102d80eb1` with exact-head GitHub Actions CI green: native, architecture-native, AIST embed, WASM browser, sanitizers,