On a parent's page (typically a PLAN with many child TASKs), the
"Mentioned in" panel was dominated by child tasks that wiki-link
back to their parent. Those children are already listed in the
Children section directly above the panel, so the same items
appeared twice on screen and buried genuine cross-references
(sibling plans, retro docs, etc.). Symmetric problem on a child's
page: the parent shows up in "Mentioned in" even though it's
already in the "Parent: …" header.
Suppression is server-side in two parts, modeled on the existing
self-link filter in GetBacklinks (s.id != targetItemID):
1. Children-suppression — always-on. Source rows where
s.parent_id = targetItemID are dropped. Uses the existing
targetItemID parameter; no API change. NULL-safe form so
orphan items still surface (raw `s.parent_id != ?` would
silently drop NULL parent_id rows under SQL three-valued logic).
2. Parent-suppression — opt-in. New TargetParentID *string field
on BacklinksVisibility (zero value = nil = no parent
suppression, keeping the ~50 existing test callsites valid).
When set, the source row whose id == TargetParentID is dropped.
The handler passes item.ParentID from the resolved target.
Both apply to CountBacklinks identically so the
handlers_backlinks.go same-ws/cross-ws pagination math
(which depends on count-vs-fetch agreeing) stays correct.
GetCrossWorkspaceBacklinks is unaffected — parent_id is
workspace-scoped, so a cross-ws source can't be the target's
parent or child by construction. Doc comment added noting this.
Tests:
- ChildMentionOfParentSuppressed: headline case
- ParentMentionOnChildPageSuppressed: symmetric case with/without
TargetParentID
- SiblingMentionsNotSuppressed: control — siblings of a shared
parent that wiki-link each other still surface
- OrphanBacklinksUnaffected: regression for the NULL-safe form
- PaginationStableAfterSuppression: page 1 + page 2 hit all
filtered rows exactly once with no duplicates
Promoted from IDEA-1601. Follow-up to [[PLAN-1593]] (which
shipped the original wiki-link backlinks reverse index).
xarmian
4aff8c70a0