| name | edge-batch-creation |
| description | SOP for creating multiple edges in a batch — efficient bulk relationship creation. |
| execution | sop |
| used-by | relation-typing, hierarchy-construction, concept-decomposition |
Edge Batch Creation
Create multiple edges efficiently. Used when a set of relationships has been identified and needs to be committed to the graph.
Tool
vault_add_edge (called multiple times)
Protocol
- Receive list of (source, target, edge_type) triples
- Validate all paths exist
- Call vault_add_edge for each triple
- Report successes and failures (duplicates are expected, not errors)
- Inline wikilinks: For each successfully created edge, ensure the source page contains
[[dir/slug]] pointing to the target (dir/slug = target path minus .md). Place inline at semantically relevant location; if none, append at end. Skip if already present.
HARD-GATE
All source and target paths must exist before batch creation begins.
Validate the full batch upfront, not one-by-one.
Yield
Returns: { attempted: number, created: number, duplicates_skipped: number }