tq v0.28.2

tq v0.28.2

What's in 0.28.1-next.280

🐛 Bug fixes

• #363 Issue #363

📚 Documentation

• close CLI option parity ledger (Refs #363)
• define the toon binary contract (Refs #363)
• distinguish tq from the toon drop-in (Refs #363)
• announce the toon drop-in bins (Refs #363)

🧪 Tests

• pin zero CLI option divergences (Refs #363)

Full Changelog: v0.28.1...v0.28.1-next.280

---

TOON v4.1 checkpoint

This release closes the repository's v4.1 frontier at the official TOON v4.1.1
checkpoint: revision and reference implementation
revision . The TypeScript package, Rust crate, , and editor grammar
share that baseline and are validated against the vendored official corpus.

API cutovers

• TypeScript callers should use , , ,
  , and . and are deprecated aliases
  for the canonical codec; old path-expanding behavior lives at
  .
• Rust callers should use the suffix-free and functions and
  canonical model methods. Compatibility entry points are explicitly named
  .

Extension policy

Nested field groups and keyed tabular form are official v4.1 and are selected
automatically. TOONL, primitive-array columns, object-array columns, cyclic
discriminated arrays, depth guards, and truncation reports remain RedDB userland
features. Wire extensions are opt-in on encode and preserve a lossless canonical
fallback; they are never presented as official TOON syntax.

Migration

Replace legacy root imports and Rust legacy methods with the canonical APIs,
treat dotted keys literally, remove key-folding assumptions, and review inputs
that depended on lenient numeric or indentation recovery. The complete before/after
guide is at https://github.com/reddb-io/toon/blob/v0.28.2/docs/migration-v4.md.

Experimental upstream frontiers

The TypeScript reviver remains an experimental opt-in audited from
toon-format/toon#294; it is not part of the v4.1
contract. Mixed-columnar work in toon-format/spec#47
and toon-format/spec#48 remains draft evidence and
is not released syntax. The release-time upstream-drift report is attached to
this workflow run.

Installation

Installer script (Linux/macOS — detects your platform, verifies checksums, installs or updates in place):

curl -fsSL https://raw.githubusercontent.com/reddb-io/toon/main/install.sh | sh

Cargo:

cargo install reddb-io-tq   # installs the `tq` binary

VS Code extension (RedDB Toon — syntax highlighting for TOON and TOONL):

curl -fsSL https://github.com/reddb-io/toon/releases/download/v0.28.2/reddb-toon.vsix -o reddb-toon.vsix && code --install-extension reddb-toon.vsix

Prebuilt binaries:

Platform	Asset
Linux x86_64 (glibc)	tq-linux-x86_64
Linux x86_64 (static musl — runs on any Linux)	tq-linux-x86_64-static
Linux aarch64 (glibc)	tq-linux-aarch64
Linux aarch64 (static musl)	tq-linux-aarch64-static
macOS Intel	tq-macos-x86_64
macOS Apple Silicon	tq-macos-aarch64
Windows x86_64	tq-windows-x86_64.exe

Example for Linux x86_64:

curl -fsSLO https://github.com/reddb-io/toon/releases/download/v0.28.2/tq-linux-x86_64
chmod +x tq-linux-x86_64
./tq-linux-x86_64 --version

Crates (Rust)

Published in lockstep from this tag:

[dependencies]
reddb-io-toon = "0.28.2"   # TOON parser/serializer/lazy document model

Verification

curl -fsSL https://github.com/reddb-io/toon/releases/download/v0.28.2/SHA256SUMS -o SHA256SUMS
grep '  tq-linux-x86_64$' SHA256SUMS | sha256sum -c -

gh attestation verify tq-linux-x86_64 --repo reddb-io/toon

checksums.txt / SHA256SUMS carry the same aggregate SHA-256 manifest for every release binary.