up

docs/contracts/richgraph-v1.md

@@ -32,6 +32,8 @@ This contract defines the canonical `richgraph-v1` schema used for function-leve
       "kind": "method",
       "display": "com.example.Foo.bar(String)",
       "code_id": "code:java:base64url...",
+      "code_block_hash": "sha256:deadbeef...",
+      "symbol": { "mangled": "_Z15ssl3_read_bytes", "demangled": "ssl3_read_bytes", "source": "DWARF", "confidence": 0.98 },
       "purl": "pkg:maven/com.example/foo@1.0.0",
       "build_id": "gnu-build-id:...",
       "symbol_digest": "sha256:...",
@@ -71,9 +73,11 @@ This contract defines the canonical `richgraph-v1` schema used for function-leve
 | `kind` | string | Yes | Symbol kind: `method`, `function`, `class`, `module`, `trait`, `struct` |
 | `display` | string | No | Human-readable demangled name |
 | `code_id` | string | No | CodeID for name-less symbols (format: `code:{lang}:{base64url-sha256}`) |
+| `code_block_hash` | string | No | Hash of the code block for stripped/heuristic nodes (algorithm-prefixed hex) |
 | `purl` | string | No | Package URL of containing package |
 | `build_id` | string | No | GNU build-id, PE GUID, or Mach-O UUID |
 | `symbol_digest` | string | No | SHA-256 of the symbol_id (format: `sha256:{hex}`) |
+| `symbol` | object | No | Symbol metadata `{mangled?, demangled?, source?, confidence?}` with `source ∈ {DWARF,PDB,SYM,NONE}` and confidence in [0,1] |
 | `evidence` | string[] | No | Evidence sources (sorted): `import`, `reloc`, `disasm`, `runtime` |
 | `attributes` | object | No | Additional key-value metadata (sorted by key) |