Skip to content

feat: v0.4.0 developer confidence release#12

Merged
emremy merged 1 commit into
mainfrom
v0.4.0
May 3, 2026
Merged

feat: v0.4.0 developer confidence release#12
emremy merged 1 commit into
mainfrom
v0.4.0

Conversation

@emremy
Copy link
Copy Markdown
Owner

@emremy emremy commented May 3, 2026

v0.4.0 – Developer Confidence Release

This PR introduces a major milestone focused on trust, observability, and real-world usability.

Highlights

🔍 Query Diagnostics

  • Added query.explain() public API
  • Non-executing query planning insights
  • Stable QueryExplainPlan and reasonCode

🧪 Confidence Scenario Suite

  • New tests/scenarios/ structure
  • API-like real-world test flows
  • Covers mutations, indexing, serialization, and consistency

📊 Real-world Benchmark

  • Session analytics benchmark
  • Dirty index lifecycle visibility
  • JSON + scalable dataset support

🧩 Flagship Example

  • examples/session-analytics.ts
  • Demonstrates real backend-like usage

📚 Documentation

  • Decision guide (ColQL vs Array vs SQLite vs DuckDB)
  • When NOT to use ColQL
  • Serialization & index lifecycle
  • Benchmark usage

Notes

  • No new query features added
  • Focus is on stability, predictability, and transparency
  • Prepares groundwork for v1.0.0

Validation

  • build: ✅
  • tests: ✅ (223 tests)
  • benchmark: ✅

- add public query.explain() diagnostics API with stable reason codes
- introduce comprehensive scenario test suite (tests/scenarios) covering
  real-world API-like flows
- add flagship session analytics example demonstrating practical usage
- add real-world benchmark suite with session analytics workload
- improve documentation: explain(), decision guide, limitations,
  serialization lifecycle, benchmarks
- strengthen type safety and public API surface
- ensure package cleanliness and consistent export surface

This release focuses on trust, debuggability, and real-world usability
without expanding the query feature set.
@emremy emremy self-assigned this May 3, 2026
@emremy emremy added the release label May 3, 2026
@emremy emremy merged commit e9cc0eb into main May 3, 2026
2 checks passed
@emremy emremy deleted the v0.4.0 branch May 3, 2026 23:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant