Skip to content

1.0.0: bring all six ports level and close the review gaps - #1

Merged
maheshvaikri-code merged 15 commits into
mainfrom
feature/parity-and-gaps
Nov 16, 2026
Merged

maheshvaikri-code merged 15 commits into
mainfrom
feature/parity-and-gaps

Conversation

@maheshvaikri-code

Copy link
Copy Markdown
Contributor

Summary

Brings all six ports (Python, C#, TypeScript, JavaScript, Rust, C++) to the same 1.0.0 feature level and closes the gaps from the capability review.

Parity across ports

  • Node filtering (node_filter, node_types, strict_filter), edge weighting (weight_field), connected subgraphs (connect, connect_max_hops).
  • Model lifecycle: encoder model/version, per-record model, models(), stale(), reembed_stale(), on_model_mismatch.
  • Atomic graph save with a portable graph_digest sidecar; load verifies it (on_mismatch = error | warn | reembed). Golden fixture tests/fixtures/graph_digest_golden.json is reproduced by every port.
  • Standalone SQLite store model lifecycle in TS, JS, Rust and C++.

Correctness

  • Python update_node re-embeds when an embed field changes; semantic_path considers every seed.
  • The update_node bypass is closed in C# (Graph is a read-only view), C++ (const graph()) and Rust (graph_mut() removed; add_edge/remove_edge added).

Performance and new features

  • Python exact search vectorised (1M vectors: 664 ms -> 52 ms) with an incrementally patched cache.
  • Opt-in IVF approximate search in Python (ann="ivf"). Pays off from about 1M vectors.
  • HttpEncoder in all six ports (OpenAI and Ollama response shapes), with API key redaction and no redirects.
  • Retrieval-quality, scale and ANN benchmarks under benchmarks/.

CI

  • The cross-port job now writes and reads graph files across all six ports and checks the digest (72 checks).

Breaking changes

  • C#: SemanticGraph.Graph is IReadOnlyGraph and returns copies.
  • C++: graph() is const only; clear() keeps the dimension by default; addNode/updateNode return const Node&.
  • Rust: graph_mut() removed; new EmbeddingError variants; models()/stale() on the SQLite store return Result; struct literals gained fields.

Test plan

Run locally on Windows at each commit:

  • Python 203, TypeScript 194, JavaScript 193, C# 222
  • Rust 122 lib + 22 SQLite (124 / 18 encoder with http-encoder)
  • C++ 167 + 37 (MSVC)
  • Cross-port graph-file matrix 72/72
  • check_versions.py: 9 sources agree on 1.0.0
  • CI on Linux runners (the new cross-port steps have only run on Windows)

Known limits

  • C++ libcurl transport is off by default and has never been built against real libcurl.
  • ANN recall is measured on synthetic data only and only exists in Python.
  • JS/TS HttpEncoder serves prefetched texts because the encoder interface there is synchronous.
  • Distributed and multi-tenant retrieval are not built; they need a separate service layer.

Review hot spots

C++ JSON parser rewrite, Python store cache, Python IVF index, and Cargo.lock (about 490 added lines for the optional HTTP dependency).

🤖 Generated with Claude Code

maheshvaikri-code and others added 15 commits November 15, 2026 17:48
…, atomic save with graph digest, and a vectorised exact search

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…graph digest

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…aph digest

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…Node-only graph save/load

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…ors, and add an HTTP embedding encoder

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…edits cannot leave stale vectors, and add an optional HTTP encoder

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…n HTTP embedding encoder

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…its cannot leave stale vectors, and an HTTP embedding encoder

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@maheshvaikri-code
maheshvaikri-code merged commit 2ed2c1a into main Nov 16, 2026
28 checks passed
@maheshvaikri-code
maheshvaikri-code deleted the feature/parity-and-gaps branch November 16, 2026 02:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant