feat: integrate public Helix embedded runtime#1993
Draft
Gand4lf wants to merge 12 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.
Gand4lf
force-pushed
the
agent/helix-v8-integration
branch
from
July 19, 2026 19:28
7aa6c9d to
17169c0
Compare
Gand4lf
changed the title
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
1 participant
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
Graphify-Labs/graphify@v8helix-db==0.2.0b3andhelix-db-embedded==0.2.0b3graphify-out/graph.helixthe sole runtime graph store--retain-rollbackretains exactly one previous generation--no-clustermultigraph semantics, including parallel/reverse edges and external endpoint stubsRuntime policy
Production code has no NetworkX/graspologic dependency, Python compatibility graph, topology loader, direct
helixdb_uniffiimport,ctypes/cffiloader,sys.pathmodification, SDK monkeypatch, Git Helix dependency, private wheel, or locally compiled runtime.Legacy
graph.jsonstores are ignored and never migrated or deleted; the user is told to rebuild from source. The only remaininggraph.jsonoutput is Obsidian's presentation configuration. GraphML remains a presentation export generated directly from a native snapshot.Windows
Native Windows x86_64 is a hard Graphify release requirement on CPython 3.10 and 3.12. There is no WSL, downloaded-DLL, MSYS, source-build, or compatibility-library fallback.
The exact public b3 embedded release currently has macOS universal2 and Linux x86_64/aarch64 wheels but no
win_amd64wheel. Windows therefore cannot be installed or qualified from the required public packages yet. This PR must remain draft until that public wheel is available and the native Windows matrix passes without core skips.Correctness and packaging validation
git diff --check, Bandit medium/high, and strict pip-audit: passedGitHub-hosted platform qualification is still outstanding: the upstream Actions run requires maintainer approval and the fork currently has no registered workflow runs for this branch.
Performance status
This candidate is not merge-ready and this PR is deliberately still a draft.
Synthetic 20k/60k results:
Report-style public ERPNext reproduction:
Public b3 logically deletes inactive generations, but does not reclaim enough physical embedded-store space after update. Graphify does not touch SST/WAL files or call private maintenance APIs.
The report's
comfywerk,agent,backend, andpassportcorpora, exact gold queries, harness scripts, and raw result file were not distributed with the report or found in the supplied repositories/artifacts. The exact five-corpus gold-recall table therefore cannot be reproduced or claimed passing. The public ERPNext and synthetic runs are not substitutes for those missing inputs.Full raw numbers and reproduction commands are in the benchmark results, with the release decision in the qualification report.
Draft exit criteria