feat: integrate Helix-only graph runtime#1993
Draft
Gand4lf wants to merge 6 commits into
Draft
Conversation
Forward-port the Helix implementation onto v8 with native immutable snapshots, atomic generations, rollback, durable state, locking, incremental updates, exports, MCP, global graphs, and query operations. Ported-from: HelixDB/graphify@3cf658f242a18d19c64dc96c54f61ff833d4516a Co-authored-by: George Curtis <george@macbookpro.home> Co-authored-by: xav-db <xav@helix-db.com>
Preserve the upstream README structure while updating obsolete storage, NetworkX, command, and Windows guidance. Regenerate every host skill against the native graph.helix contract.
Port the v8 suite to native storage, add generation/concurrency/state regressions, commit isolated NetworkX parity and raw benchmark results, and enforce the Linux/macOS CI, quality, security, package, and benchmark gates.
Move reverse impact traversal into Helix, eliminate topology rewrites for analysis-only operations, revision durable state by category, and reuse native snapshots through rebuild, search, clustering, global, and presentation workflows. Add atomic rollback and large chunked-state regressions.
Record the full macOS 5k/15k and 20k/60k comparison after the native-state optimization and update the qualification tables. All 18 release gates pass.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
graph.jsongraph runtime with embedded Helix generationsgraphify-out/graph.helixCompatibility
Existing
graph.jsonfiles are deliberately ignored and produce a concise rebuild-from-source warning. Older Helix schemas are rejected with the same rebuild instruction; production readers never deserialize an old graph into Python to migrate it.Validation
git diff --checkpass in a fresh Python 3.12 environmentbenchmarks/; all 18 gates passed in the recorded runFollow-up CI verification
The final full macOS test invocation in this local environment terminates around 23% without a Python failure report. This draft intentionally leaves CI as the authority for the final full matrix before review/merge.