Expose a public finite registry or safe codec for native effect graphs

Open
#674 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
30/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
python
Domain
api

Research direction

Read the Varcode effect JSON graph schema and compare it with Vaxrank's finite-registry native artifact decoder; the issue points to openvax/vaxrank#750 and openvax/varcode#671. Done means consumers can use a documented finite registry or safe typed graph encoder/decoder without arbitrary class imports, with existing validation, cycle handling, and evidence preserved; tests cover ordinary, phased, and structural graphs and reject unknown class or function metadata.

Written by the indexing model from the issue text.

Description

Varcode 11 consumers now need to persist ordinary realized-candidate graphs. Vaxrank's native artifact decoder intentionally uses a finite class registry and does not import classes named by an input file. Varcode effect JSON has standalone class metadata in graph nodes and uses private _EffectReference and _AssembledAllele records.

Vaxrank's migration can register the reviewed classes explicitly, but this duplicates the codec's class inventory and requires private imports. Please expose a documented finite registry or a safe typed graph decoder/encoder so consumers can reuse the native schema without allowing arbitrary class imports. Preserve existing graph validation, cycle handling, and availability/baseline/hypothesis evidence. Tests should cover ordinary, phased and structural graphs plus rejection of unknown class/function metadata.

Related: openvax/vaxrank#750 and openvax/varcode#671. This API request does not require delaying the bounded candidate-traversal release.

Dominant language
Python
Stars
88
Forks
28
Avg merge
3h 17m
Merged PRs (30d)
52

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from openvax/varcode

All issues in openvax/varcode

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.