| name | alias-resolution |
| description | SOP for detecting and resolving concept aliases — merge duplicate pages, redirect edges. |
| execution | sop |
| used-by | concept-extraction, ontology-refinement |
Alias Resolution
Detect when two concept pages refer to the same thing under different names. Merge into canonical page.
Tool
vault_search + CC file operations + vault_add_edge
Protocol
- Search vault for the concept name and common synonyms
- If multiple pages cover the same concept: choose canonical name
- Merge content from duplicate into canonical page
- Redirect all edges from duplicate to canonical
- Inline wikilinks: After edge redirection, ensure the canonical page body contains
[[dir/slug]] for all targets (dir/slug = target path minus .md). Place inline at semantically relevant locations. Skip if already present.
- Delete duplicate page
- Update index
HARD-GATE
Before merging, verify the pages truly refer to the same concept (not related but distinct concepts).
Yield
Returns: { merged: boolean, canonical: string, aliases_resolved: string[] }