Skip to content

feat: integrate Helix-only graph runtime#1993

Draft
Gand4lf wants to merge 6 commits into
Graphify-Labs:v8from
HelixDB:agent/helix-v8-integration
Draft

feat: integrate Helix-only graph runtime#1993
Gand4lf wants to merge 6 commits into
Graphify-Labs:v8from
HelixDB:agent/helix-v8-integration

Conversation

@Gand4lf

@Gand4lf Gand4lf commented Jul 18, 2026

Copy link
Copy Markdown

Summary

  • replace the production NetworkX/graph.json graph runtime with embedded Helix generations
  • persist topology, analysis, extraction state, hashes, learning state, and generation metadata in graphify-out/graph.helix
  • remove production NetworkX/graspologic dependencies, JSON graph loading, and legacy Python migration loaders
  • preserve v8 commands, MCP, exports, incremental builds, global aggregation, and diagnostics on native snapshots
  • include reproducible Helix-vs-v8 baseline performance data and qualification results

Compatibility

Existing graph.json files 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

  • prior clean Python 3.10 matrix: 2798 passed, 3 skipped
  • prior Python 3.12 matrix: 2761 passed, 30 skipped
  • final commit: focused Helix/global tests, Ruff, compile, and git diff --check pass in a fresh Python 3.12 environment
  • benchmark qualification data is committed under benchmarks/; all 18 gates passed in the recorded run

Follow-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.

George Curtis and others added 6 commits July 18, 2026 00:13
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.
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