release: v0.6.5-dev (#247)

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: genezhang

CHANGELOG.md

@@ -1,8 +1,39 @@
-## [0.6.4-dev] - 2026-03-14
+## [0.6.5-dev] - 2026-03-21
 
 ### 🚀 Features
 
-- **Hybrid remote query + local storage**: Execute Cypher queries against a remote ClickHouse cluster from embedded mode, then store results locally in chdb as a subgraph for fast re-querying. New `RemoteConfig` for `SystemConfig`, plus `Connection` methods: `query_remote()`, `query_remote_graph()`, `query_graph()`, `store_subgraph()`. New `GraphResult` structured output and `StoreStats` return type. Available in Rust, Python (UniFFI), and Go (UniFFI) bindings. `RoleConnectionPool::new_with_params()` enables programmatic pool creation without env vars.
+- **Hybrid remote query + local storage** (PR #240): Execute Cypher queries against a remote ClickHouse cluster from embedded mode, then store results locally in chdb as a subgraph for fast re-querying. New `RemoteConfig` for `SystemConfig`, plus `Connection` methods: `query_remote()`, `query_remote_graph()`, `query_graph()`, `store_subgraph()`. New `GraphResult` structured output and `StoreStats` return type. Available in Rust, Python (UniFFI), and Go (UniFFI) bindings.
+
+- **Embedded write API** (PR #236): `create_node()`, `create_edge()`, `upsert_node()`, `upsert_edge()` with batch variants (`create_nodes()`, `create_edges()`). `delete_nodes()`, `delete_edges()` for cleanup. `import_json()` and `import_json_file()` for bulk JSON import. Schema entries without `source:` get auto-created as `ReplacingMergeTree` tables. `property_types` field for type-aware DDL (PR #238).
+
+- **Multi-format file import** (PR #243): `import_csv_file()`, `import_parquet_file()`, `import_file()` (auto-detect from extension). Supports CSV, Parquet, TSV, JSON/NDJSON/JSONL formats.
+
+- **Richer Value types** (PR #244): `Value::Date("YYYY-MM-DD")`, `Value::Timestamp("YYYY-MM-DD HH:MM:SS")`, `Value::UUID("8-4-4-4-12")` auto-detected from ClickHouse JSON output. `to_sql_literal()` generates `toDate()`/`toDateTime()`/`toUUID()` wrappers. `Value::string()` constructor bypasses detection.
+
+- **Kuzu API parity** (PR #242): `Value::as_bool()`, query timing (`get_compiling_time()`/`get_execution_time()`), `Database::in_memory()`, `Connection::set_query_timeout()`, `QueryResult::get_column_data_types()`.
+
+- **DataFrame output** (PR #245): Python `QueryResult.get_as_df()` (Pandas), `get_as_arrow()` (PyArrow), `get_as_pl()` (Polars) with lazy imports.
+
+- **Python wrapper improvements** (PR #246): `result.compiling_time`/`execution_time`/`column_data_types` properties. `conn.create_node()`/`create_edge()`/`create_nodes()`/`import_file()`/`execute_sql()` accept plain Python dicts with auto-conversion to FFI Value types.
+
+### 📚 Documentation
+
+- **Tutorials and examples** (PR #246): 5 runnable Python scripts (`examples/embedded/`) covering quick start, DataFrames, write API, GraphRAG hybrid workflow, and export formats. Wiki tutorial page (`docs/wiki/Embedded-Tutorials.md`) with Python + Rust code, architecture diagrams, and API quick reference.
+
+### 🐛 Bug Fixes
+
+- **Edge extraction fallback** (PR #241): `extract_edge_from_row` falls back to `from_id`/`to_id` aliases when schema FK column names don't match SQL-generated column names.
+- **Security dep updates**: `lz4_flex` 0.11.5→0.11.6 (RUSTSEC-2026-0041), `rustls-webpki` 0.103.8→0.103.10 (RUSTSEC-2026-0049).
+
+### 🧹 Infrastructure
+
+- **CI**: `cargo audit` ignores unmaintained `rustls-pemfile` warning (transitive dep via chdb-rust).
+
+---
+
+## [0.6.4-dev] - 2026-03-14
+
+### 🚀 Features
 
 - **Denormalized & coupled schema support**: Full query support for schemas where node properties are embedded in edge tables via `from_node_properties`/`to_node_properties`. Includes property mapping, ORDER BY resolution, UNION aggregate column rewriting, and `id()` on virtual nodes (PRs #224-#228).
 

Cargo.lock

@@ -7,7 +7,7 @@ members = [
 
 [package]
 name = "clickgraph"
-version = "0.6.4-dev"
+version = "0.6.5-dev"
 edition = "2021"
 rust-version = "1.85"
 

Cargo.toml

@@ -4,29 +4,25 @@
 
 # ClickGraph
 
-#### ClickGraph - A high-performance, stateless, read-only graph query service for ClickHouse, written in Rust, with Neo4j ecosystem compatibility - Cypher and Bolt Protocol 5.8 support. Now supports embedded mode and exporting query results to external destinations, with Golang, Python bindings, in addition to native Rust.
+#### ClickGraph - A high-performance, stateless, read-only graph query service for ClickHouse, written in Rust, with Neo4j ecosystem compatibility - Cypher and Bolt Protocol 5.8 support. Now supports embedded mode with local writes, and exporting query results to external destinations, with Golang, Python bindings, in addition to native Rust.
 
 > **Note: ClickGraph dev release is at beta quality for view-based graph analytics applications. Kindly raise an issue if you encounter any problem.**
 
 ---
 ## Motivation and Rationale
-- Viewing ClickHouse databases (including external sources) as graph data with graph analytics capability brings another level of abstraction and boosts productivity with graph tools, and enables agentic GraphRAG support.
+- Viewing ClickHouse databases (including external sources) as graph data with graph analytics capability brings another level of abstraction and boosts productivity with graph tools, and enables agentic GraphRAG support with local writes.
 - Research shows relational analytics with columnar stores and vectorized execution engines like ClickHouse provide superior analytical performance and scalability to graph-native technologies, which usually leverage explicit adjacency representations and are more suitable for local-area graph traversals.
 - View-based graph analytics offer the benefits of zero-ETL without the hassle of data migration and duplicate cost, yet better performance and scalability than most of the native graph analytics options.
 - Neo4j Bolt protocol support gives access to the tools available based on the Bolt protocol.
 ---
-## What's New Under Development
+## What's New in v0.6.5-dev
 
 - **Hybrid remote query + local storage** — Execute Cypher queries against a remote ClickHouse cluster from embedded mode, then store results locally in chdb as a subgraph for fast re-querying. `query_remote()`, `query_remote_graph()`, `store_subgraph()` — ideal for GraphRAG context enrichment. Available in Rust, Python, and Go. See [Embedded Mode](docs/wiki/Embedded-Mode.md#hybrid-remote-query--local-storage).
-- **Embedded write API for GraphRAG** - `create_node()`, `create_edge()`, `upsert_node()` with batch variants. AI agents can extract entities from documents, store them as graph data, and query with Cypher — all in-process. See [Embedded Mode Write API](docs/wiki/Embedded-Mode.md#write-api-embedded-mode-only).
-
-## What's New in v0.6.4-dev
-
-- **Embedded mode** - Query Parquet/Iceberg/Delta/S3 directly — no ClickHouse server needed. Use as a Rust library (`clickgraph-embedded`) or run the server with `--embedded`. Use for agent's local tool.
-- **Golang and Python bindings** - for embedded ClickGraph in addition to Rust native interface.
-- **Export query results** - `CALL apoc.export.{csv|json|parquet}.query()` exports to files, S3, GCS, Azure, and HTTP destinations. Compatible commands with Kuzu and DuckDB are also provided.
-- **Denormalized & coupled schema fixes** - Corrected property mapping, OPTIONAL MATCH (was silently dropped), and VLP cycle prevention for schemas where node properties are embedded in edge tables.
-- **1,591 unit tests** - Up from 1,277, with comprehensive cross-schema pattern matrix tests.
+- **Embedded write API for GraphRAG** — `create_node()`, `create_edge()`, `upsert_node()` with batch variants. AI agents can extract entities from documents, store them as graph data, and query with Cypher — all in-process. See [Embedded Mode Write API](docs/wiki/Embedded-Mode.md#write-api-embedded-mode-only).
+- **Kuzu API parity** — `Value::Date/Timestamp/UUID` types, query timing (`compiling_time`/`execution_time`), `Database::in_memory()`, `Connection::set_query_timeout()`, column type metadata, multi-format file import (CSV/Parquet/JSON).
+- **DataFrame output** — `result.get_as_df()` (Pandas), `result.get_as_arrow()` (PyArrow), `result.get_as_pl()` (Polars) for Python data science workflows.
+- **Tutorials and examples** — 5 runnable Python examples covering quick start, DataFrames, write API, GraphRAG hybrid workflow, and export formats. See [`examples/embedded/`](examples/embedded/).
+- **1,599 unit tests** — Up from 1,591, with hybrid E2E tests and comprehensive Value type coverage.
 
 See [CHANGELOG.md](CHANGELOG.md) for complete release history.
 
@@ -46,7 +42,7 @@ See [CHANGELOG.md](CHANGELOG.md) for complete release history.
 - **GraphRAG structured output** - `format: "Graph"` returns deduplicated nodes, edges, and stats for graph visualization and RAG pipelines.
 - **Query Metrics** - Phase-by-phase timing via HTTP headers and structured logging
 - **ClickHouse cluster load balancing** - `CLICKHOUSE_CLUSTER` env var auto-discovers and balances queries across cluster nodes.
-- **Complex queries like LDBC SNB benchmark: 36/37 queries (97%)** - Near-complete Social Network Benchmark coverage. See [benchmark results](benchmarks/ldbc_snb/BENCHMARK_RESULTS.md) for performance data on sf0.003 and sf10 datasets.
+- **Complex queries like LDBC SNB benchmark: 36/37 queries (97%)** - Near-complete Social Network Benchmark coverage. See [benchmark results](benchmarks/ldbc_snb/BENCHMARK_RESULTS.md) for performance data on sf0.003, sf1 and sf10 datasets.
 
 ### Neo4j Ecosystem Compatibility
 - **Bolt Protocol v5.8** - Full Neo4j driver compatibility (cypher-shell, Neo4j Browser, graph-notebook)
@@ -226,7 +222,7 @@ RETURN friend.name
 
 ## Development Status
 
-**Current Version**: v0.6.4-dev
+**Current Version**: v0.6.5-dev
 
 ### Test Coverage
 - **Rust Unit Tests**: 1,588 passing (100%)

README.md

@@ -1,7 +1,7 @@
 # ClickGraph Roadmap
 
-**Last Updated**: March 14, 2026
-**Current Version**: v0.6.4-dev (Phase 3 Complete, Phase 4 In Progress)
+**Last Updated**: March 21, 2026
+**Current Version**: v0.6.5-dev (Phase 3 Complete, Phase 4 In Progress)
 
 This document outlines delivered features, current status, and planned enhancements for ClickGraph.
 

ROADMAP.md

@@ -1,15 +1,15 @@
 # ClickGraph Status
 
-*Updated: March 14, 2026*
+*Updated: March 21, 2026*
 
-## Current Version: v0.6.4-dev
+## Current Version: v0.6.5-dev
 
 Read-only Cypher-to-ClickHouse SQL query engine with Neo4j Browser compatibility.
 Supports both remote ClickHouse and embedded (in-process) mode via chdb.
 
-**Unit Tests**: 1,588 passing (100%)
+**Unit Tests**: 1,599 passing (100%)
 **Integration Tests**: 183 passing (100%)
-**Embedded Tests**: 31 passing (unit + e2e)
+**Embedded Tests**: 152 passing (unit + integration + e2e)
 **Go Binding Tests**: 14 passing (100%)
 **LDBC SNB**: 36/37 queries passing at sf0.003 and sf1 (97%) — bi-16 blocked by CALL subquery
 **Benchmark**: 14/14 queries (100%)

STATUS.md

@@ -1,6 +1,6 @@
 # LDBC SNB Benchmark Results
 
-**Updated**: March 2026 · ClickGraph v0.6.4-dev
+**Updated**: March 2026 · ClickGraph v0.6.5-dev
 
 ## Summary
 

benchmarks/ldbc_snb/BENCHMARK_RESULTS.md

@@ -55,7 +55,7 @@ services:
       - neo4j_demo_logs:/logs
 
   clickgraph:
-    image: genezhang/clickgraph:v0.6.4-dev
+    image: genezhang/clickgraph:v0.6.5-dev
     container_name: clickgraph-demo
     depends_on:
       clickhouse: