Document 是源码材料，Symbol 是代码声明，Namespace 是组织名称与成员的语言单元。 Symbol 与 Namespace 是允许重叠的逻辑概念，Class 自身也组织成员；图中只使用具体的 Document、Package、Module、Class、Function 等 Kind，不增加 Symbol 标签或互斥三分类字段。 具体 Namespace Kind 留给语言显式声明的 namespace。
declares 从 Document 指向它声明或构成的节点，保留源码贡献位置。encloses 从 Document
或声明指向同文件内直接嵌套的已保留声明，表达文件的源码结构。contains 从语义所有者
指向直接成员，支持 Namespace 任意层级嵌套；祖先关系通过有界路径查询获得。
in_namespace 从 Document 指向语言确定的组织根，与 declares 的源码贡献分开。
根既可以是合成组织，也可以是有源码位置的声明；位置是否存在不决定归属。
Document: src/app/__init__.py ─declares→ Package: app
│ contains
Document: src/app/api/__init__.py ─declares→ Package: app.api
│ contains
Document: src/app/api/user.py ────declares→ Module: app.api.user
│ │ contains
├───────────declares→ Class: User
│ │ contains
└───────────declares→ Method: save
源码来源与语义归属可以跨文件。Go 一个 Package 可以有多份 Document 贡献，接收者方法的 Document 可以与类型不同。方法通过 contains 归属接收者类型，通过 encloses 保持文件顶层位置；包级成员归属 Package。找不到接收者时保留 局部诊断和源码贡献，不假定方法是包级函数。再导出产生导入绑定关系，不改写原声明归属。
语言 Organizer 解释源码和 document path，给出实体、Document 的语义根以及组织关系。 公共构图层把语义根发布为 in_namespace，全部实体登记后形成成员视图， Binder 补充跨文件接收者归属。组织与 Class 共用成员查询入口，源码贡献从 declares 读取。 成员索引和已绑定的 extends 供后续引用与调用解析使用，阶段接口见 语言构建流程。
encloses 负责声明的源码嵌套，词法 Scope/Binding 负责可见性与遮蔽，contains 负责成员归属；职责划分见 内核设计。
Go imports 指向 Package，每条导入语句对一个包只建立一条边。Python imports 指向 Module / Package，具名导入另保留最终声明目标；模块名称引用也指向相应组织节点。调用与声明引用仍直接 连接实际目标。JS/TS 文件以 Module 组织顶层成员，模块导入及模块名称引用指向 Module； 显式 Namespace/Class 按声明嵌套在其中。Document 保留材料身份及源码贡献。
Extract、GetDocument 和 FindAsync 提供单文件声明事实，不提前承诺跨材料组织结果。
Wait 后通过 Cypher 或 Node、RelationsFrom、RelationsTo 查询组织与贡献：
MATCH (:Document {path:$path})-[:in_namespace]->(owner)
RETURN ownerMATCH (:Package {name:$name})-[:contains*1..8]->(member)
RETURN member组织 ID 使用语言、具体类别和源码锚点，不使用首个成员、成员列表或加载顺序：
- Go Package 由逻辑目录和 package 名锚定；不同目录以及
p/p_test不合并。 - Go Module 由调用方提供的 module 根与 import path 锚定；只为已接纳 Go 源码涉及的 module 建点。
- Python Module 由文件路径锚定，普通 Package 由初始化文件所在目录及源码/类型桩形式锚定。
- JS/TS 文件 Module 由语言与源码路径锚定，限定名使用去扩展名的逻辑路径。
.py/.pyi是不同来源候选，不通过同名自动合并；导入存在多个来源时保留 scoped。- Python 限定名只拼接已证明的普通包祖先。补入父包可以丰富显示名，既有节点 ID 不变。
快照根目录的初始化文件没有已知包名时，以
.表达源码锚点，不猜测运行时导入名。
没有单一源码发生位置的合成组织节点，其 Node.Location 为 nil；JSON 省略 location，
Cypher 不提供虚构的 path/line 等源码属性。源码组织通过入向 declares 读取贡献及位置；
上下文提供的 Go Module 没有源码 declares，其 contains 边以 module_context 记录模块归属依据，
位置指向所归属 Package 的源码贡献。普通声明和 Document 继续保留位置；
Find 只按具体源码位置查声明。返回值包含独立的位置副本，修改查询结果不会污染图。
Document 使用材料路径身份；声明及合成实体统一使用 node: 身份前缀，其稳定键分别来自声明位置
和语言锚点。ID 不承载 Symbol/Namespace 逻辑角色，也不使用图引擎内部数字 ID。
新组织节点、来源与嵌套边都计入构图预算，失败或取消不会发布半个组织层级。
同一条路径 a/b/c/d.xx 的组织意义由语言决定，公共层不把每段路径展开成统一节点树：
| 语言 | 文件及路径的解释 | 已有组织层级 |
|---|---|---|
| Go | a/b/c 与源码 package 名确定 Package |
提供模块上下文时 Module 包含 Package；中间目录不自动成为父包 |
| Python | d.py 是文件 Module；已加载初始化文件建立普通 Package |
Package 可以包含子 Package 和 Module |
| JS/TS | 文件形成 Module，路径用于身份及相对导入 | 文件内显式 Namespace、Class 等按语言规则组织；目录不成为父 Module |
Go 同目录同 package 名的已加载文件共同贡献 Package；测试文件不成为生产 import 的目标。
调用方通过 ModulePath 或 ResolutionContext.GoModules 提供模块边界时，构造
Module ─contains→ Package，多个 Package 可由此找到共同模块。ModulePath 作为根映射的简写，与 GoModules 统一后用于组织和导入解析；显式 . 映射优先。
最具体的 module 根决定归属，
嵌套 module 相互独立；Go 目录层次不产生父子 Package。没有 module 上下文时保留 Package 根。
Module 表达模块内的包组织，文件词法作用域与同包绑定仍由 Package 及 Scope/Binding 决定。
CodeGraph 不读取 go.mod，也不根据路径前缀虚构 module 或仓库根。
Python 根据已加载的 __init__.py / __init__.pyi 建立普通包与直接子包、子模块的 contains。
目录向上收敛，组织层级无环。没有初始化材料时保留文件 Module，不把普通目录猜成 Package；
namespace package 的跨来源合并和动态搜索路径未解析。绝对导入仍保留 scoped。
JS/TS 文件 Module 表达所提供源码单元的静态组织，不证明 ESM/CommonJS 加载模式，也不合并 脚本的运行时全局名称。扩展名候选、导出与再导出仍遵循语言绑定策略；同名不同路径不合并。
明确的源码贡献与直接归属使用 exact；多个包/模块候选使用 scoped。exact 表达已加载范围的 源码证据，不证明运行时导入配置或包成员完整性。缺少导入目标保留局部诊断，不虚构外部依赖节点。 组织关系用于查询代码事实，是否沿它扩大影响范围由消费者决定。
契约测试与固定仓库测量见统一实体模型验证。
NamespaceAncestors 从节点沿语义归属查询祖先，CommonNamespaces 求多个节点的共同祖先。
Document 通过 in_namespace 找到语言确定的组织根，再沿入向 contains 向上；
普通声明沿 contains 向上，Reference、Import、Export 经 occurs_in 找到源码所在上下文。
Class 等 namespace 类别及图中实际拥有成员的节点都可返回，例如包含局部声明的函数；
namespace 自身位于深度零。查询不规定 Module、Package、Namespace 的排列顺序。
这些查询只读 Node + Relation，不按文件路径猜父级，也不沿 aliases 转移到目标的 namespace。
默认只使用 exact 关系，可用 MinConfidence 纳入 scoped 等候选。Kinds 只筛选返回类别， 不阻断中间的 Class 等成员所有者。结果按最短关系距离排序；共同祖先按各输入距离的最大值排序， 同距离按节点 ID 排序。所有共同祖先都会返回，由消费方选择分组边界。
每个结果的 Paths 按去重后的输入顺序保留一条最短有效路径，节点按遍历顺序排列，关系保留 存储方向、confidence 与 evidence。同长度路径优先选择证据更强的路径，再按稳定身份裁决。 结果 Confidence 是这些已返回路径中最弱的关系精度，零跳身份路径为 exact；它不代表所有 更长路径的最强精度。需要只接受强证据时提高 MinConfidence。
邻接索引由不可变 Graph 缓存，查询条件在遍历时应用；补料发布的新 Graph 拥有独立索引。 路径及证据全部返回独立副本，并计入查询结果预算。
局部图可有多个根，没有共同归属时返回空；未知输入也返回空，不忽略某个输入后求交集。 执行取消、超时与预算超限返回 error，不将截断结果当成完整祖先集合。查询遵守 Graph 的 MaxQueryHops、MaxResultRows、MaxResultBytes 与 QueryTimeout。