feat: attribute top comments with u/ and @ handles in evidence lines (#292)

Reddit, TikTok, YouTube, Instagram, Bluesky, X and Threads top comments
now render as u/author or @handle in the evidence block, instead of the
generic "Comment (...)" label. The enrichment adapters already captured
author; only the render layer was dropping it.

Also fixes the TikTok adapter to prefer user.unique_id (the @handle) over
user.nickname (display name) so attribution round-trips to a profile URL.

Legacy "Comment (...)" shape is preserved when author is empty, [deleted],
or [removed].

Bumps to 3.0.10.

Co-authored-by: Matt Van Horn <455140+mvanhorn@users.noreply.github.com>

scripts/lib/render.py

@@ -462,7 +462,8 @@ def render_full(report: schema.Report) -> str:
                 for tc in top_comments[:3]:
                     excerpt = tc.get("excerpt", tc.get("text", ""))[:200]
                     tc_score = tc.get("score", "")
-                    lines.append(f"  Top comment ({tc_score} {vote_label}): {excerpt}")
+                    attribution = _comment_attribution(item.source, tc.get("author"))
+                    lines.append(f"  Top comment {attribution} ({tc_score} {vote_label}): {excerpt}")
             # Comment insights for Reddit
             insights = item.metadata.get("comment_insights", [])
             if insights:
@@ -581,7 +582,9 @@ def _render_candidate(candidate: schema.Candidate, prefix: str) -> list[str]:
         excerpt = tc.get("excerpt") or tc.get("text") or ""
         score = tc.get("score", "")
         vote_label = _vote_label_for(primary.source) if primary else "upvotes"
-        lines.append(f"   - Comment ({score} {vote_label}): {_truncate(excerpt.strip(), 240)}")
+        source = primary.source if primary else None
+        attribution = _comment_attribution(source, tc.get("author"))
+        lines.append(f"   - {attribution} ({score} {vote_label}): {_truncate(excerpt.strip(), 240)}")
     insight = _comment_insight(primary)
     if insight:
         lines.append(f"   - Insight: {_truncate(insight, 220)}")
@@ -1232,6 +1235,33 @@ def _vote_label_for(source: str) -> str:
     return _TOP_COMMENT_VOTE_LABEL.get(source, "votes")
 
 
+# Handle prefixes for commenter attribution. Reddit uses `u/`; everyone else
+# uses `@`. Missing source or unknown platform falls back to plain-text so
+# we never emit `u/` or `@` with no handle attached.
+_HANDLE_PREFIX: dict[str, str] = {
+    "reddit": "u/",
+    "tiktok": "@",
+    "youtube": "@",
+    "instagram": "@",
+    "bluesky": "@",
+    "x": "@",
+    "threads": "@",
+}
+
+
+def _comment_attribution(source: str | None, author: str | None) -> str:
+    """Build the attribution prefix for a top comment line.
+
+    Returns a string like ``u/Cyrisaurus`` or ``@moosanoormahomed`` when an
+    author is captured, or the legacy ``Comment`` marker when the author is
+    missing, empty, deleted, or removed.
+    """
+    if not author or author in ("[deleted]", "[removed]"):
+        return "Comment"
+    prefix = _HANDLE_PREFIX.get(source or "", "")
+    return f"{prefix}{author}" if prefix else author
+
+
 def _top_comments_list(item: schema.SourceItem | None, limit: int = 3, min_score: int | None = None) -> list[dict]:
     """Return up to `limit` top comments with score at or above the source's minimum.
 

scripts/lib/tiktok.py

@@ -658,7 +658,9 @@ def _fetch_post_comments(
         if not text:
             continue
         user = c.get("user") if isinstance(c.get("user"), dict) else {}
-        author = user.get("nickname") or user.get("unique_id") or ""
+        # Prefer unique_id (the @handle) over nickname (display name) so
+        # downstream render can cite @handle consistently across platforms.
+        author = user.get("unique_id") or user.get("nickname") or ""
         create_time = c.get("create_time")
         date_str = ""
         if create_time: