¬ just serendipity 🍀 (not just serendipity)

some of my blog posts e.g. https://perrotta.dev/2026/07/anki-archive-a-deck/ have
"connections"

this is great, but it includes _only_ direct links

I wanted to expand connections to include a couple of posts that share tags too

They should be visually distinct from direct links (direct links should stand out better)

*Devise a plan*

[...]

Current Connections graph reads only backlinks and outlinks. Existing related
data mixes links, tags, categories, and title words. It cannot guarantee two
tag-based results.

 Plan:

 1. Precompute tag connections
     - Add tag_related to ci/precompute_links.py.
     - Select up to two posts with shared tags.
     - Exclude current post, backlinks, and outlinks.
     - Rank by shared-tag count, then newest date.
     - Store post IDs in data/links.json.

 2. Extend mini graph
     - Read tag_related in layouts/partials/mini-graph.html.
     - Keep incoming links on left.
     - Keep outgoing links on right.
     - Place tag connections below current post.
     - Use no arrows because tag relationships have no direction.
     - Include shared tag names in each SVG <title>.

[...]

 6. Verify
     - Add focused tests for ranking, direct-link exclusion, deduplication, and
       fewer-than-two matches.
     - Regenerate data/links.json.
     - Run hugo.
     - Inspect /2026/07/anki-archive-a-deck/ on desktop and mobile.
     - Confirm direct Anki workflow link stands out.
     - Confirm two non-direct Anki/tag posts appear as muted tag connections.
     - Confirm posts without tags or direct links still render correctly.