Skip to content

Release history

Every published version of the SDK, newest first. A release candidate (X.Y.Z-rc.N) is a pre-release: no installer picks it unless you ask for it.

Language Install a release Install a release candidate
Python pip install semq==X.Y.Z pip install semq==X.Y.ZrcN
Rust cargo add semq@X.Y.Z cargo add semq@=X.Y.Z-rc.N
Go go get github.com/The-SEMQ-Group/semq/bindings/go@vX.Y.Z go get github.com/The-SEMQ-Group/semq/bindings/go@vX.Y.Z-rc.N
TypeScript npm install @semq/sdk@X.Y.Z npm install @semq/sdk@next

See Compatibility and migration for what each version guarantees.

Version Date Type
1.1.0 2026-10-12 Release
1.1.0-rc.1 2026-10-12 Release candidate
1.0.0 2026-10-05 Release

1.1.0 - 2026-10-12

Added

  • Diff.evaluate(floor, options), a verdict that names every failed check (reasons) instead of a single boolean. With no options it agrees with within. Options are off by default, so a new one never changes an existing verdict. Python diff.evaluate(floor, per_row=...), Rust diff.evaluate(&floor, &GateOptions::new().per_row(...)), Go d.Evaluate(f, semq.GateOptions{PerRow: ...}), TypeScript diff.evaluate(floor, { perRow }); C semq_diff_evaluate(diff, floor, checks, ...) with semq_check_t flags and semq_verdict_t. An unknown flag is InvalidInput.
  • Per-row check. per_row also fails the verdict when any changed row has a hamming distance above the floor's max_hamming, the largest of any changed row of any null, and lists those rows. The p99 check ignores the most changed 1% of rows; this one ignores none. semq diff --floor F --per-row applies it from the command line.
  • Floors with per-row data. Floor.measure(nulls, per_row=True) (Rust Floor::measure_for, Go MeasureFloorFor, TypeScript Floor.measure(nulls, { perRow: true }), C semq_floor_measure_for, CLI semq floor --per-row) also records max_hamming and distinct_nulls, the number of distinct null states (two nulls are the same when their candidates have the same content_digest). Both are optional keys of the floor JSON, with accessors in every binding (C semq_floor_max_hamming, semq_floor_distinct_nulls). measure and the constructors record neither.
  • The floor JSON is written and read by the core (semq_floor_save, semq_floor_load), so every binding applies the same rules. Rust Floor::to_json and Floor::from_json, Go json.Marshal(floor) and semq.LoadFloor, TypeScript floor.toJson() and Floor.fromJson; Python save, load, as_dict and from_dict now call the core.
  • semq diff --per-row warns on stderr when the floor's nulls were not all the same state and there are fewer than 20 of them. With N such nulls, each check can reject an unchanged rebuild with probability up to 1/(N+1); the warning does not change the exit code. The gate guide explains the bound.

Changed

  • Reading floor JSON ignores keys it does not know, at the top level and inside config, so a floor saved by a later version with an added key still reads. Known keys stay strict, and 18446744073709551615 is reserved in max_hamming and distinct_nulls. version remains semq-floor/1; it changes only when the meaning of a key changes. A floor from measure carries only the keys SEMQ 1.0 knows, so every version reads it. SEMQ 1.0 rejects a floor that carries max_hamming or distinct_nulls: upgrade the readers before writing floors with per_row.
  • Every binding writes the floor JSON in the core's compact form, with no whitespace. Python 1.0 wrote spaces after : and ,, so a floor saved again from Python differs in bytes, not in content.
  • semq diff --floor --json keeps within as the result of Diff.within; with --per-row, the full verdict is in verdict.passed, and the text output adds a passed: line.
  • Go *Floor implements UnmarshalJSON through the core, so a Floor field survives an encoding/json round trip.
  • In Rust and TypeScript, Verdict.passed reads the core's reason flags, so a reason this version does not name still fails the verdict.
  • Go FloorReport.UnmarshalJSON and FloorFromReport read through the core, and so check every value, not only the shape. FloorReport keeps its 1.0 fields and drops the per-row data; read a floor with per-row data with LoadFloor (Rust Floor::from_json).
  • semq diff --floor --json adds a verdict object next to within.

1.1.0-rc.1 - 2026-10-12

Release candidate of 1.1.0; its changes are listed under 1.1.0.

1.0.0 - 2026-10-05

First public release.

Added

  • A core built around states with an identity. The C library owns every rule that determines bytes or verdicts, and the Python, Rust, Go and TypeScript/WebAssembly bindings are thin wrappers over its 67-function ABI. Five types and one service: CodecConfig (quant(dim, bins), phase(dim, sectors), orbit(dim, scale), a 13-byte canonical form), Codec (encode, decode, unpack), Encoding (sorted u64 or utf8 ids, canonical rows, a manifest, content_digest and state_id; save/load, concat, diff), Diff (added, removed, changed with hamming distances, manifest_changes, units, within, as_dict), Floor (measure from null diffs; bound to the config, id kind and reference it was measured against, with the number of nulls, a versioned schema for floor.json, and a verdict that fails on a changed encoder or encoder_revision) and BuildInfo. Six errors cover every failure: InvalidInput, Incompatible, FormatError, IntegrityError, Unsupported, Native.
  • Direct constructors in every binding: Codec.quant(dim, bins), phase and orbit (Rust Codec::quant, Go NewQuantCodec, TypeScript await Codec.quant) build the codec and its config in one call; CodecConfig remains for files and floors. In TypeScript they load the wasm module first, so they need no prior await load().
  • A one-line, human-readable form of Encoding, Diff and Floor, identical in every binding: Python str(), Rust Display, Go String(), TypeScript toString(). A Diff reads 1 of 3 rows changed: doc-3 (hamming 3). 0 added, 0 removed. Encodings compare by state_id: Python ==, Rust PartialEq, TypeScript Encoding.equals(other).
  • The .semq file format, version 2: config, ids, rows, manifest and two SHA-256 identities, validated in a fixed order before any allocation proportional to a declared size.
  • The input contract: unit-norm finite float32 rows with subnormals canonicalized to zero, so the bytes do not depend on the flush-to-zero state; the round-to-nearest mode is required.
  • Three operators. quant uses the derived range 2 / sqrt(dim). phase packs nibbles when sectors <= 16, and its angle polynomial stays within 0.04° of atan, keeping neighbouring inputs in order across the 45° diagonal. orbit fixes its alphabet at 19, with scale in [1, 2^30].
  • SIMD kernels: AVX2 and AVX-512 are selected only when the CPU and the operating system both support them, and every backend produces the same bytes as the scalar kernel.
  • A known-answer self-test: before creating a codec, the core checks the selected kernel against the scalar kernel's bytes for fixed rows, and SHA-256 against a known digest, and refuses to create the codec if either differs.
  • The semq command: show, diff [--floor], floor [--min-nulls N] (three null rebuilds by default), version, with exit codes 0/1/2.
  • Conformance vectors under tests/conformance/, generated by the core's test binary, cross-checked by an independent pure-Python reference for the non-kernel contracts, executed by every host, and gated in CI on every architecture (tools/conformance.py).
  • Two reference pages that state the contracts exactly: the core contracts (input rows, operator rules, diff, floor and the two report schemas) and the file format byte by byte.
  • Packaging: the static archive needs only libc and libm; the Rust crates bundle the core sources for static linking; the Go module carries the core too and cgo compiles it, so go get needs only a C compiler; the Python package ships one wheel per platform for Python 3.11 and newer, is tested on 3.11 to 3.14, and depends only on cffi and numpy.
  • Reader fuzzing, allocation-failure cleanup tests, compiled ABI and layout checks, and artifact consumers that install the packages without a checkout.
  • Licensing: the SDK is licensed under the PolyForm Noncommercial License 1.0.0. Every package ships LICENSE.md and NOTICE, and the npm package also ships THIRD_PARTY_LICENSES for the Emscripten runtime it bundles.