neograph-dev-codebase-nav

Neograph Codebase Navigation

Provides the import map, layer discipline, and module ownership rules for the neograph declarative LLM graph compiler. Prevents the most common agent mistake: importing from the wrong internal module.

The Golden Rule

Never guess import paths. Always grep first:

grep -rn "def function_name" src/neograph/
grep -rn "class ClassName" src/neograph/

Public API Imports

All public symbols re-exported from neograph/__init__.py:

# Core
from neograph import Node, Construct, compile, run, configure_llm
from neograph import Each, Oracle, Operator, Loop, ModifierSet
from neograph import Tool, ToolInteraction, tool
from neograph import FromInput, FromConfig, ExcludeFromOutput
from neograph import LintIssue, lint, describe_type, describe_value

# Decorators
from neograph import node, merge_fn, construct_from_functions, construct_from_module

# Registration (also available from neograph directly)
from neograph.factory import register_scripted, register_tool_factory, register_condition

# Renderers
from neograph import Renderer, XmlRenderer, DelimitedRenderer, JsonRenderer
from neograph.renderers import render_input

# Errors
from neograph import CompileError, ConstructError, ConfigurationError, ExecutionError

Frequent Import Mistakes

Wrong	Right	Why
from neograph._sidecar import register_scripted	from neograph.factory import register_scripted	_sidecar has accessors, not registration
from neograph.tool import register_tool_factory	from neograph.factory import register_tool_factory	Factory at factory.py:107
from neograph._llm import describe_value (deferred)	Top-level in _llm.py now	Was promoted, stale deferred imports may exist
from neograph._construct_validation import X in decorators.py	Import in _construct_builder.py instead	Layer discipline: decorators -> builder -> validation

Layer Discipline

User code
   |
@node / ForwardConstruct / runtime Node|Modifier    <- DX layer (decorators.py)
   |
Construct(nodes=[...])                               <- IR layer (construct.py, validation)
   |
compile()                                            <- Compiler (compiler.py, state.py)
   |
factory._make_*_wrapper                              <- Runtime dispatch (factory.py, _dispatch.py)
   |
LangGraph StateGraph