Release v1.0.6: fix CI flaky test, add CLI commands, Python binding

Bug fixes:
- Encoder: deep-copy string/blob value data to prevent use-after-return
  when JSON encoder passes stack-allocated buffers (root cause of CI
  flaky test on ubuntu-latest/clang)
- JSON decoder: fix heap-buffer-overflow in segment dedup
- Bitstream: fix UB in zigzag encode (left-shift of negative int64_t)

New features:
- CLI tool: trp encode/decode/validate commands with stdin and -o support
- Native Python binding with 70 tests
- Complex JSON example (json_complex.c)
- 3 new C test files, expanded edge-case coverage (~400 total tests)
- README: CI/coverage/license badges, roadmap, updated bindings table

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: deftio

CHANGELOG.md

@@ -5,6 +5,76 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.6] - 2026-03-02
+
+### Fixed
+- Encoder: deep-copy string/blob value data to prevent use-after-return when
+  JSON encoder passes stack-allocated buffers (root cause of CI flaky test)
+- JSON decoder: fix heap-buffer-overflow in segment dedup that used entry index
+  as byte offset into key string
+- Bitstream: fix undefined behavior in zigzag encode (left-shift of negative
+  value); cast to uint64_t before shifting
+
+### Added
+- README: CI build, coverage, and BSD-2-Clause license badges
+- README: roadmap section with planned milestones for language bindings,
+  format enhancements, and tooling
+- CLI tool: `trp encode`, `trp decode`, `trp validate` commands with stdin
+  support and `-o`/`--pretty` flags
+
+### Changed
+- README: updated language bindings table (Python, JavaScript now implemented)
+- README: updated project status to v1.0.5 test counts
+- CLI tool: removed `trp json` command (replaced by `trp decode`)
+
+## [1.0.5] - 2026-03-02
+
+### Added
+- Native Python binding: pure-Python `.trp` encoder/decoder with byte-for-byte compatibility
+- Python test suite: 70 tests across 5 files (crc32, bitstream, varint, roundtrip, fixtures)
+- Complex JSON example (`json_complex.c`): nested objects, arrays, DOM lookups, pretty-print
+- Test data files: `common_words_10k.txt` (10K words) and `benchmark_100k.json` (202 KB)
+- Generator script: `tools/generate_benchmark_json.py`
+- 3 new C test files: `test_json_decode.c`, `test_core_internal.c`, `test_bitstream_errors.c`
+- Expanded existing test files with error-path and edge-case coverage
+
+### Changed
+- C test suite: 16 test programs -> 20 test programs, ~330 individual tests
+- Total tests across all languages: ~400 (C/C++ + Python)
+- Updated testing documentation (`docs/guide/testing.md`)
+- Updated bindings README: Python and JavaScript marked as implemented
+
+## [1.0.4] - 2026-03-02
+
+### Fixed
+- Bitstream guide: clarify signed bit-field extraction with worked example
+
+## [1.0.3] - 2026-03-02
+
+### Fixed
+- CSS: move stylesheet to `assets/main.scss` so minima theme loads correctly
+- Remove hardcoded top bar above nav, add whitespace around section dividers
+- Adjust version label size and color for readability
+
+## [1.0.2] - 2026-03-01
+
+### Added
+- Native JavaScript `.trp` implementation: pure-JS encoder/decoder
+- Cross-language fixture files (7 `.trp` files) for interop testing
+- Cross-language test (`test_cross_language.c`) validating fixture files
+
+### Fixed
+- 32-bit CI: enable Unity 64-bit type support, switch Pages to workflow build
+- Site margins: use 75% viewport width, fix `!important` overrides
+- clang-tidy: suppress `misc-no-recursion` false positive, fix dead store bug
+- GitHub Pages: fix lcov report overwriting docs site, fix broken links
+
+## [1.0.1] - 2026-03-01
+
+### Fixed
+- GitHub Pages deployment: docs site was showing lcov coverage report instead of Jekyll site
+- Fix broken navigation links on docs site
+
 ## [1.0.0] - 2026-02-28
 
 ### Added

CMakeLists.txt

@@ -1,5 +1,5 @@
 cmake_minimum_required(VERSION 3.16)
-project(triepack VERSION 1.0.0 LANGUAGES C CXX)
+project(triepack VERSION 1.0.6 LANGUAGES C CXX)
 
 # ── Options ──────────────────────────────────────────────────────────────
 option(BUILD_TESTS    "Build test suite"           ON)

README.md

@@ -1,5 +1,9 @@
 # triepack v1.0.0
 
+[![CI Build & Test](https://github.com/deftio/triepack/actions/workflows/ci.yml/badge.svg)](https://github.com/deftio/triepack/actions/workflows/ci.yml)
+[![Coverage Report](https://github.com/deftio/triepack/actions/workflows/coverage.yml/badge.svg)](https://github.com/deftio/triepack/actions/workflows/coverage.yml)
+[![License: BSD-2-Clause](https://img.shields.io/badge/License-BSD_2--Clause-blue.svg)](LICENSE.txt)
+
 A compressed trie-based dictionary format for fast, compact key-value storage.
 
 TriePack encodes dictionaries into a compact binary format (`.trp`) optimized for fast lookups, prefix search, and ROM-safe deployment. It uses prefix sharing and bit-level packing with configurable symbol encoding and full value type support.
@@ -94,16 +98,16 @@ Each layer can be used independently. `triepack_wrapper` provides C++11 RAII wra
 
 ## Language Bindings
 
-Native implementations (not FFI) are planned for:
+All bindings are native implementations that read/write the `.trp` format directly (no FFI).
 
 | Language | Status | Directory |
 |----------|--------|-----------|
-| Python | Scaffolded | `bindings/python/` |
-| TypeScript | Scaffolded | `bindings/typescript/` |
-| JavaScript | Scaffolded | `bindings/javascript/` |
-| Go | Scaffolded | `bindings/go/` |
-| Swift | Scaffolded | `bindings/swift/` |
-| Rust | Scaffolded | `bindings/rust/` |
+| Python | Implemented | `bindings/python/` |
+| JavaScript | Implemented | `bindings/javascript/` |
+| TypeScript | Not yet implemented | `bindings/typescript/` |
+| Go | Not yet implemented | `bindings/go/` |
+| Swift | Not yet implemented | `bindings/swift/` |
+| Rust | Not yet implemented | `bindings/rust/` |
 
 ## File Format
 
@@ -126,9 +130,28 @@ See `docs/internals/` for format details.
 
 ## Project Status
 
-**v1.0.0 released.** The bitstream library, trie codec, and JSON library are fully implemented. All 22 tests pass (16 unit test suites + 6 example integration tests). Run `compaction_benchmark` to see compression ratios on ~10k generated words.
+**v1.0.5 released.** Core C library (bitstream, trie codec, JSON), C++ wrappers, Python binding, and JavaScript binding are implemented. 27 test programs with ~400 individual tests across C, C++, and Python.
+
+## Roadmap
+
+### v1.1 — Client Libraries
+- [ ] TypeScript binding (native `.trp` reader/writer)
+- [ ] Go binding
+- [ ] Swift binding (with SPM package)
+- [ ] Rust binding (with crate on crates.io)
+- [ ] npm package for JavaScript/TypeScript
+- [ ] PyPI package for Python
+
+### v1.2 — Format Enhancements
+- [ ] Suffix table (shared ending compression)
+- [ ] Huffman symbol encoding (for large dictionaries)
+- [ ] Nested dict values (embed sub-dictionaries inline)
 
-Future work: suffix table, Huffman symbols, language bindings.
+### v1.3 — Tooling & Ecosystem
+- [ ] `trp` CLI: encode/decode/validate/inspect (in progress)
+- [ ] Fuzzy search (edit distance d<=2)
+- [ ] Performance benchmarks across languages
+- [ ] Language binding conformance test suite
 
 ## License
 

bindings/README.md

@@ -5,9 +5,9 @@ They do not use FFI or call into the C library.
 
 | Language   | Directory                  | Status              |
 |------------|----------------------------|---------------------|
-| Python     | [python/](./python/)       | Not yet implemented |
+| Python     | [python/](./python/)       | Implemented         |
 | TypeScript | [typescript/](./typescript/)| Not yet implemented |
-| JavaScript | [javascript/](./javascript/)| Not yet implemented |
+| JavaScript | [javascript/](./javascript/)| Implemented         |
 | Go         | [go/](./go/)               | Not yet implemented |
 | Swift      | [swift/](./swift/)         | Not yet implemented |
 | Rust       | [rust/](./rust/)           | Not yet implemented |

bindings/python/tests/test_bitstream.py

@@ -0,0 +1,120 @@
+# Copyright (c) 2026 M. A. Chatterjee, BSD-2-Clause.
+
+import pytest
+
+from triepack.bitstream import BitReader, BitWriter
+
+
+def test_write_read_bits():
+    w = BitWriter()
+    w.write_bits(0x07, 3)
+    w.write_bits(0xAB, 8)
+    w.write_bits(0x05, 5)
+
+    r = BitReader(w.to_bytes())
+    assert r.read_bits(3) == 0x07
+    assert r.read_bits(8) == 0xAB
+    assert r.read_bits(5) == 0x05
+
+
+def test_write_read_single_bit():
+    w = BitWriter()
+    w.write_bit(1)
+    w.write_bit(0)
+    w.write_bit(1)
+
+    r = BitReader(w.to_bytes())
+    assert r.read_bit() == 1
+    assert r.read_bit() == 0
+    assert r.read_bit() == 1
+
+
+def test_u8_roundtrip():
+    w = BitWriter()
+    w.write_u8(0x00)
+    w.write_u8(0xFF)
+    w.write_u8(0x42)
+
+    r = BitReader(w.to_bytes())
+    assert r.read_u8() == 0x00
+    assert r.read_u8() == 0xFF
+    assert r.read_u8() == 0x42
+
+
+def test_u16_roundtrip():
+    w = BitWriter()
+    w.write_u16(0xABCD)
+
+    r = BitReader(w.to_bytes())
+    assert r.read_u16() == 0xABCD
+
+
+def test_u32_roundtrip():
+    w = BitWriter()
+    w.write_u32(0xDEADBEEF)
+
+    r = BitReader(w.to_bytes())
+    assert r.read_u32() == 0xDEADBEEF
+
+
+def test_align_to_byte():
+    w = BitWriter()
+    w.write_bits(0x07, 3)
+    w.align_to_byte()
+    assert w.position == 8
+
+    w.write_u8(0x42)
+    r = BitReader(w.to_bytes())
+    r.read_bits(3)
+    r.align_to_byte()
+    assert r.read_u8() == 0x42
+
+
+def test_peek_bits():
+    w = BitWriter()
+    w.write_bits(0xAB, 8)
+
+    r = BitReader(w.to_bytes())
+    assert r.peek_bits(8) == 0xAB
+    assert r.position == 0  # didn't advance
+    assert r.read_bits(8) == 0xAB
+    assert r.position == 8
+
+
+def test_read_bytes():
+    w = BitWriter()
+    w.write_bytes(b"\xDE\xAD\xBE\xEF")
+
+    r = BitReader(w.to_bytes())
+    assert r.read_bytes(4) == b"\xDE\xAD\xBE\xEF"
+
+
+def test_eof_raises():
+    r = BitReader(b"\x00")
+    r.read_bits(8)
+    with pytest.raises(EOFError):
+        r.read_bits(1)
+
+
+def test_remaining():
+    r = BitReader(b"\x00\x00")
+    assert r.remaining == 16
+    r.read_bits(4)
+    assert r.remaining == 12
+
+
+def test_seek():
+    w = BitWriter()
+    w.write_u8(0xAA)
+    w.write_u8(0xBB)
+
+    r = BitReader(w.to_bytes())
+    r.seek(8)
+    assert r.read_u8() == 0xBB
+
+
+def test_is_aligned():
+    r = BitReader(b"\xFF")
+    assert r.is_aligned()
+    r.read_bit()
+    assert not r.is_aligned()

bindings/python/tests/test_crc32.py

@@ -0,0 +1,29 @@
+# Copyright (c) 2026 M. A. Chatterjee, BSD-2-Clause.
+
+from triepack.crc32 import crc32
+
+
+def test_known_answer_123456789():
+    """Standard CRC-32 known-answer test."""
+    data = b"123456789"
+    assert crc32(data) == 0xCBF43926
+
+
+def test_empty():
+    assert crc32(b"") == 0x00000000
+
+
+def test_single_byte():
+    result = crc32(b"\x00")
+    assert isinstance(result, int)
+    assert 0 <= result <= 0xFFFFFFFF
+
+
+def test_all_zeros():
+    result = crc32(b"\x00" * 256)
+    assert isinstance(result, int)
+
+
+def test_all_ff():
+    result = crc32(b"\xff" * 4)
+    assert isinstance(result, int)