Cortext v1.2.4

Cortext v1.2.4

Ships the packaging work from PR #8 for binding installers and on-device defaults.

Highlights

• Shared release assets — multi-arch natives + Git-friendly AIST model shards as cortext-assets-1.2.4.tar.gz (built by the release-assets workflow).
• Default model embed — AIST q8_0 shards are linked into libcortext and assembled at first load (no download / path required). Opt out with -DCORTEXT_EMBED_AIST_MODEL=OFF.
• In-repo shards under models/AIST-87M-GGUF/chunks/ (no LFS).

Assets

The Release assets workflow attaches:

• cortext-assets-1.2.4.tar.gz
• cortext-assets-1.2.4.tar.gz.sha256

Source

• Tag: v1.2.4 @ c6a0d8e1
• Baseline merge: PR #8 / 170d866a

Cortext v1.2.3

Cortext v1.2.3 Release Artifact

This tracked artifact accompanies the v1.2.3 tag.

Release State

• Version: 1.2.3
• Merged feature baseline before release metadata: 2353640ed3b71b1d57074a54ee348d018cb2bacf
• Release source: the integrated commit addressed by the annotated v1.2.3
  tag; the GitHub release and registry artifacts are rebuilt from that exact
  commit.
• Product surface: C++ facade, C ABI, Python, JavaScript/TypeScript, Dart,
  Go, WASM, CLI, and Hermes provider integration.

Highlights

• Keeps Natural and Durable ingestion on one SQLite-authoritative operation
  path; Durable adds only its post-commit flush/checkpoint barrier.
• Cuts the existing SQLite HNSW route over to an F/S/T-derived bounded
  retrieval sawtooth with a separately bounded consolidation activation
  snapshot.
• Rearms consolidation hints after material cumulative throughput drawdown
  while keeping stable jitter quiet.
• Preserves exact SQL fallback when sparse candidate generation underfills
  after eligibility or family filtering, and repairs restart, eviction,
  suppression, supersession, and canonical-entry edge cases.
• Keeps all routing and work-budget behavior modality- and opaque
  source_id-agnostic without changing the public API or C API.

Verification

• Pull request #6 merged at
  2353640ed3b71b1d57074a54ee348d018cb2bacf with all review discussions
  resolved and cross-platform native, AIST, WASM, Zig, Windows CLI, and
  Linux sanitizer validation owned by exact-head GitHub checks.
• The exact Debug LLVM 21 media-enabled suite passed 39,305 assertions in 712
  cases across four disjoint shards at fixed seed 424242; Python passed 159
  tests plus 55 subtests.
• The production-shaped nine-point matrix passed 4,608/4,608 exact top-1
  controls with recall@16 and semantic coverage of 1.0, deterministic ties,
  zero clustered misses, and source/modality invariance.
• The 30,380-packet mature run passed 511/512 exact top-1, recall@16
  0.999265, semantic coverage 0.998571, deterministic ties, 19/20 material
  cycle resets, and no retrieval work-bound violations.
• Paper traceability passed 70/70 and the manuscript records every algorithm
  and experiment change.
• These results do not claim whole-engine raw-time reset, bounded whole-engine
  restart, Durable plateau, or production-wide boundedness.

Packaging

• PyPI and npm artifacts contain six native targets each.
• Registry packages retain on-demand model bootstrap and do not embed the
  AIST model payload.

Version Surfaces

The release surfaces report 1.2.3:

• CMakeLists.txt
• build.zig and build.zig.zon
• bindings/python/pyproject.toml
• bindings/javascript/package.json
• bindings/dart/pubspec.yaml

Publish Targets

• GitHub release: v1.2.3
• PyPI: augmem.cortext==1.2.3
• npm: @augmem/cortext@1.2.3

Cortext v1.2.2

Cortext v1.2.2 Release Artifact

This tracked artifact accompanies the v1.2.2 tag.

Release State

• Version: 1.2.2
• Merged feature baseline before release metadata: 0298ce679876b27ed42925cbdfe4adc7d7c55279
• Reviewed source tree: ffdc8abdde25741103c4ee0fa6148f73d5879ee9
• Product surface: C++ facade, C ABI, Python, JavaScript/TypeScript, Dart,
  Go, WASM, CLI, and Hermes provider integration.

Highlights

• Replaces ambiguous consolidation booleans with one explicit consolidation
  state while preserving knob-derived behavior.
• Makes consolidation recommendations edge-triggered from persisted
  throughput state and F/S/T, without arbitrary count or elapsed-time
  triggers.
• Routes forced consolidation through maintenance-only processing so it does
  not create searchable input or perturb normal throughput observations.
• Keeps unchanged consolidation idempotent and protects original semantic
  long-term candidates from association and graph crowding.
• Repairs long-term retrieval recovery so SQL fallback paging preserves
  semantic-vector families and current reconstruction surfaces.
• Carries retrieval relevance through maintained bindings and keeps ephemeral
  queries durably non-mutating.

Verification

• Pull requests #3 and
  #4 merged with all twelve
  exact-head GitHub checks successful and all review discussions resolved.
• The exact 1,915-message matched replay remained 2/7 top-12 needle hits in
  both control and recommendation-driven treatment; treatment made one
  throughput-derived consolidation call and preserved all 1,915 long-term
  memories and current embeddings with zero ephemeral durable delta.
• The registered 18-pair normal-path artifact passed all eight zero-margin
  latency, throughput, RSS, and database-size gates.
• Direct failed-cache retrieval improved materially at the measured 1,915-row
  and 8,000-row populations. These measurements do not claim production
  latency, seven-of-seven recall, or unbounded high-cardinality scaling.

Packaging

• PyPI and npm artifacts contain six native targets each.
• Registry packages retain on-demand model bootstrap and do not embed the
  AIST model payload.

Version Surfaces

The release surfaces report 1.2.2:

• CMakeLists.txt
• build.zig and build.zig.zon
• bindings/python/pyproject.toml
• bindings/javascript/package.json
• bindings/dart/pubspec.yaml

Publish Targets

• GitHub release: v1.2.2
• PyPI: augmem.cortext==1.2.2
• npm: @augmem/cortext@1.2.2

Cortext v1.2.1

Cortext v1.2.1

This patch release hardens runtime and storage correctness and improves durable-ingestion latency without changing the public API.

Highlights

• fixes Go native-handle lifetime and zero-value configuration behavior
• validates image buffers across bindings and corrects retention compatibility for legacy/media paths
• fixes working-memory decay and flush rollback, out-of-order timestamp arithmetic, emotion-cascade timing, SQLite bind error handling, graph-cache invalidation, and eviction-owned embedding cleanup
• includes the passive working-memory decay repair
• reduces durable-ingestion search work through coherent exact-result caches, indexed candidate selection, and SQL fallbacks
• audits every paper section, preserves shipped-versus-experimental distinctions, and regenerates the manuscript

Behavior and performance evidence

The merged change passed all 12 exact-head GitHub checks. An exact 500-event comparison preserved the event-behavior digest, canonical logical-database digest, and association/memory/signal counts while reducing mean engine processing latency from 47.846 ms to 9.492 ms and mean sequential end-to-end latency from 55.919 ms to 17.297 ms.

These measurements prove a material improvement on that workload. They do not prove flat storage cost, actual eviction behavior, or post-eviction throughput; the documented eviction frontier remains a planning extrapolation.

Packaging

PyPI and npm artifacts contain six native targets each and retain the existing on-demand model bootstrap rather than embedding model payloads in the registry packages.

Full change and review history: PR #2.

Cortext v1.2.0

Highlights

• Adds Natural, Durable, Boundary, and Ephemeral retention policies across core APIs and maintained bindings.
• Adds Hermes turn, tool-result, and multimodal memory provider integration.
• Keeps Ephemeral retrieval probes isolated from accumulator, pacing, interrupt, and episode-finalization state.
• Ships cross-platform native artifacts for PyPI and npm.

Verification

GitHub Actions passed native, sanitizer, AIST, WASM, and all Zig CLI target jobs. PyPI artifacts passed Twine validation.

cortext v1.1.10

Patch release for public no-storage recall and package artifacts.

Fixes:

• Retention::Ephemeral now forces an input boundary across public text, audio, image, media, and replay ingress paths, so no-storage queries still run retrieval and hydrate Context::retrieved_memory.
• Durable write permission remains off for ephemeral calls, so CLI/package recall does not store the query as a new memory.
• Adds a public memory-eval runner plus packet, Codex, Grok, and AGY judge adapters.

Packages:

• PyPI: augmem.cortext==1.1.10, with six cross-platform native libraries and verified q8_0 model bootstrap. The model downloads to the user cache on first use to stay under PyPI's 100 MB file limit.
• npm: @augmem/cortext@1.1.10, with six N-API prebuilds and bundled q8_0 model/vocab assets.
• CLI: Zig-built archives for Linux x86_64/aarch64, macOS x86_64/aarch64, and Windows x86_64/aarch64.

Validation:

• cmake -S . -B build -DCORTEXT_BUILD_TOOLS=ON -DCMAKE_BUILD_TYPE=Debug
• cmake --build build --target cortext_cli cortext_memory_eval_runner cortext_tests -j
• ctest --test-dir build -R cortext_tests --output-on-failure passed in 492.62s.
• CLI smoke: stored The garage door code is 8841., ephemeral recall "garage door code" retrieved it at rel 0.96, and memory/signal counts stayed 2/2 before and after recall.
• Memory-eval smoke: 6 public ephemeral queries, 66 aggregate retrieved candidates, zero empty retrieval packets. Packet answer accuracy 0.0; Codex/Grok/AGY each 0.2 over five scored queries.
• Final PyPI wheel import returned 1.1.10; final npm package load returned 1.1.10.

cortext v1.1.9

Patch release for package documentation.

• Python and npm README examples now show real OpenAI Chat Completions SDK calls.
• Retrieved Cortext memories are passed as developer context messages rather than assembled into an ad hoc prompt string.
• Package/native versions are bumped to 1.1.9.

Published to PyPI as augmem.cortext==1.1.9 and npm as @augmem/cortext@1.1.9.

cortext v1.1.8

Patch release for PyPI/npm registry packaging.

• PyPI and npm packages now ship cross-platform native libraries/addons without embedding the large AIST GGUF model.
• Python and Node wrappers resolve a bundled/local model when present, otherwise download and checksum-verify q8_0 into the user cache on first engine creation.
• Package READMEs document install, first-use model cache behavior, LLM usage, durable-write behavior, and troubleshooting.
• Python package builder now clears stale egg-info/build metadata before wheel creation.
• Includes Zig-built cortext_cli archives for Linux, macOS, and Windows x64/aarch64.

cortext v1.1.7

v1.1.7

Patch release for the model-asset cutover and package readiness.

Highlights

• Removes the stale public models_dir API from C++, C API, and bindings.
• Uses bundled package model assets by default for Python and Node installs.
• Builds cross-architecture Zig native libraries for Python and Node packages.
• Builds installable Zig CLI artifacts for Linux, macOS, and Windows on x64 and arm64.
• Moves tools from the examples switch to the tools build path.
• Refreshes Python and npm READMEs with install, quickstart, LLM usage, runtime asset, and troubleshooting guidance.

Verification

• ctest --test-dir build-codex-clean -R cortext_tests --output-on-failure --timeout 900
• Python wheel smoke: import augmem.cortext, create Cortext(':memory:'), embed_text(...) returns 1280-dim unit vector.
• npm tarball smoke: install @augmem/cortext, create new Cortext(':memory:'), embedText(...) returns 1280-dim unit vector.
• Native Linux CLI artifact smoke: cortext_cli --help.

Notes

The Python wheel and npm tarball include the default AIST GGUF asset, so they are large. If a registry rejects the upload due file-size policy, use the GitHub release artifact while the registry limit is adjusted.

Cortext v1.1.6

Cortext v1.1.6

Patch release for the installable public CLI.

Highlights:

• cortext_cli builds under CORTEXT_BUILD_TOOLS=ON, separate from examples.
• Zig installs cortext_cli with -Dcli=true for Linux, Windows, and macOS targets.
• Ephemeral recall and default-knob stale-fact supersession evals remain passing.

Assets:

• cortext-v1.1.6-linux-x86_64.tar.gz
• cortext-v1.1.6-windows-x86_64.zip
• cortext-v1.1.6-macos-x86_64.tar.gz
• cortext-v1.1.6-macos-aarch64.tar.gz
• SHA256SUMS.txt

The CLI binary is packaged without model assets; pass --models or set CORTEXT_MODELS_DIR to a directory containing the runtime models. macOS binaries are unsigned.

Verification summary:

• CMake cortext_cli and cortext_tests rebuilt successfully.
• Focused eval/regression probes passed for ephemeral recall, supersession edge writing, stale-memory demotion, and streaming pacing.
• Zig ReleaseFast CLI artifacts built for Linux x86_64, Windows x86_64, macOS x86_64, and macOS aarch64.

Checksums:

2180e651075352beeb503a19bf538aa779fe14b3438d61df9add508921323193  cortext-v1.1.6-linux-x86_64.tar.gz
3aee486e9c5719fd1982898172a6ce66e6a7bf5501664023f913b8741a7c013f  cortext-v1.1.6-macos-aarch64.tar.gz
bc1d7aa27c6c0fa4745cef21a74d848ae423a065c6e73fec949102342ed0c4f6  cortext-v1.1.6-macos-x86_64.tar.gz
0f87cbd6eeb77ec781717c4a022da43013b6b11dd67fa168e3b1cbc49082922f  cortext-v1.1.6-windows-x86_64.zip