From ef2697e7f23e26cd9f28b0106e95cd6b62e11e1b Mon Sep 17 00:00:00 2001
From: Aditya8369 <mahajan2005aditya@gmail.com>
Date: Thu, 6 Aug 2026 16:31:39 +0530
Subject: [PATCH] feat: Similar Profiles suggestions

---
 .../api/similar-profiles/[username]/route.ts  |  61 +++
 src/app/globals.css                           |   5 +
 src/components/profile/ProfileView.tsx        |  15 +
 src/components/profile/SimilarProfiles.tsx    | 436 ++++++++++++++++++
 src/lib/db.ts                                 |  38 ++
 ...260806000000_add_find_similar_profiles.sql | 198 ++++++++
 6 files changed, 753 insertions(+)
 create mode 100644 src/app/api/similar-profiles/[username]/route.ts
 create mode 100644 src/components/profile/SimilarProfiles.tsx
 create mode 100644 supabase/migrations/20260806000000_add_find_similar_profiles.sql

diff --git a/src/app/api/similar-profiles/[username]/route.ts b/src/app/api/similar-profiles/[username]/route.ts
new file mode 100644
index 000000000..3739abd5e
--- /dev/null
+++ b/src/app/api/similar-profiles/[username]/route.ts
@@ -0,0 +1,61 @@
+import { type NextRequest, NextResponse } from "next/server";
+import { findSimilarProfiles } from "@/lib/db";
+
+// Runtime managed by @opennextjs/cloudflare
+
+interface RouteParams {
+  params: Promise<{ username: string }>;
+}
+
+/**
+ * GET /api/similar-profiles/[username]
+ *
+ * Returns up to 6 public OSSfolio profiles that are similar to [username],
+ * ranked by shared top languages (+2 pts) and shared GitHub orgs (+3 pts).
+ *
+ * Always returns `{ profiles: [] }` on any error so the profile page degrades
+ * gracefully — it never breaks because the RPC is absent or returns an error.
+ *
+ * Cached at the CDN edge for 5 minutes (s-maxage=300). Similarity is derived
+ * from profile data that is refreshed on a similar cadence, so 5 min is fine.
+ */
+export async function GET(
+  _req: NextRequest,
+  { params }: RouteParams,
+): Promise<NextResponse> {
+  const { username } = await params;
+
+  if (!username || typeof username !== "string") {
+    return NextResponse.json({ profiles: [] }, { status: 400 });
+  }
+
+  const { data, error } = await findSimilarProfiles(username);
+
+  if (error || !Array.isArray(data)) {
+    // Graceful degradation — log but never surface an error to the caller.
+    if (error) {
+      console.error(
+        `[similar-profiles] RPC error for "${username}":`,
+        error.message,
+      );
+    }
+    return NextResponse.json(
+      { profiles: [] },
+      {
+        status: 200,
+        headers: {
+          "Cache-Control": "public, s-maxage=300, stale-while-revalidate=60",
+        },
+      },
+    );
+  }
+
+  return NextResponse.json(
+    { profiles: data },
+    {
+      headers: {
+        "Cache-Control": "public, s-maxage=300, stale-while-revalidate=60",
+      },
+    },
+  );
+}
diff --git a/src/app/globals.css b/src/app/globals.css
index 2cb722202..f00f09530 100644
--- a/src/app/globals.css
+++ b/src/app/globals.css
@@ -185,6 +185,11 @@ dialog::backdrop {
   outline-offset: 2px;
   box-shadow: 0 0 0 3px var(--color-primary);
 }
+.similar-profile-card:hover {
+  border-color: var(--color-primary);
+  box-shadow: 0 6px 20px rgba(62, 207, 142, 0.08);
+  transform: translateY(-2px);
+}
 .footer-social-link {
   transition: color 0.2s ease;
 }
diff --git a/src/components/profile/ProfileView.tsx b/src/components/profile/ProfileView.tsx
index d10b8f113..750b8ab53 100644
--- a/src/components/profile/ProfileView.tsx
+++ b/src/components/profile/ProfileView.tsx
@@ -86,6 +86,18 @@ const ImpactNetwork = dynamic(
   },
 );
 
+const SimilarProfiles = dynamic(
+  () =>
+    import("@/components/profile/SimilarProfiles").then(
+      (mod) => mod.SimilarProfiles,
+    ),
+  {
+    ssr: false,
+    // SimilarProfiles has its own skeleton state, so no external fallback needed.
+    loading: () => null,
+  },
+);
+
 interface GitHubUser {
   login: string;
   name: string | null;
@@ -2647,6 +2659,9 @@ export function ProfileView({
       {/* Multi-Platform Integrations */}
       <ProviderIntegrations username={user.login} isOwner={isOwner} />
 
+      {/* Similar profiles — "You might also like..." */}
+      <SimilarProfiles username={user.login} currentUserScore={score} />
+
       {/* Contribution heatmap with year navigation */}
       <HeatmapWithYearNav
         username={user.login}
diff --git a/src/components/profile/SimilarProfiles.tsx b/src/components/profile/SimilarProfiles.tsx
new file mode 100644
index 000000000..8ff1076d7
--- /dev/null
+++ b/src/components/profile/SimilarProfiles.tsx
@@ -0,0 +1,436 @@
+"use client";
+
+import { useEffect, useState } from "react";
+import { motion, AnimatePresence } from "framer-motion";
+import Image from "next/image";
+import Link from "next/link";
+import type { SimilarProfile } from "@/lib/db";
+import { LANG_COLORS } from "@/lib/languages";
+
+interface SimilarProfilesProps {
+  username: string;
+  currentUserScore: number;
+}
+
+// ─── Skeleton placeholder card ────────────────────────────────────────────────
+function SimilarProfileSkeleton() {
+  return (
+    <div
+      style={{
+        display: "flex",
+        flexDirection: "column",
+        gap: "12px",
+        padding: "20px",
+        borderRadius: "12px",
+        border: "1px solid var(--color-hairline)",
+        backgroundColor: "var(--color-canvas-soft)",
+        minWidth: "180px",
+        flex: "0 0 auto",
+      }}
+      aria-hidden="true"
+    >
+      {/* Avatar skeleton */}
+      <div
+        style={{
+          width: "48px",
+          height: "48px",
+          borderRadius: "50%",
+          backgroundColor: "var(--color-hairline)",
+          animation: "pulse 1.5s ease-in-out infinite",
+        }}
+      />
+      {/* Name skeleton */}
+      <div style={{ display: "flex", flexDirection: "column", gap: "6px" }}>
+        <div
+          style={{
+            height: "14px",
+            width: "80%",
+            borderRadius: "6px",
+            backgroundColor: "var(--color-hairline)",
+            animation: "pulse 1.5s ease-in-out infinite",
+          }}
+        />
+        <div
+          style={{
+            height: "11px",
+            width: "55%",
+            borderRadius: "6px",
+            backgroundColor: "var(--color-hairline)",
+            animation: "pulse 1.5s ease-in-out infinite",
+          }}
+        />
+      </div>
+      {/* Tags skeleton */}
+      <div style={{ display: "flex", gap: "4px", flexWrap: "wrap" }}>
+        {[50, 40, 55].map((w) => (
+          <div
+            key={w}
+            style={{
+              height: "18px",
+              width: `${w}px`,
+              borderRadius: "99px",
+              backgroundColor: "var(--color-hairline)",
+              animation: "pulse 1.5s ease-in-out infinite",
+            }}
+          />
+        ))}
+      </div>
+    </div>
+  );
+}
+
+// ─── Individual profile card ───────────────────────────────────────────────────
+function SimilarProfileCard({
+  profile,
+  index,
+}: {
+  profile: SimilarProfile;
+  index: number;
+}) {
+  const displayName = profile.name || profile.username;
+  const displayLanguages = (profile.top_languages ?? []).slice(0, 3);
+
+  return (
+    <motion.div
+      initial={{ opacity: 0, y: 18 }}
+      animate={{ opacity: 1, y: 0 }}
+      transition={{ duration: 0.35, delay: index * 0.07, ease: "easeOut" }}
+    >
+      <Link
+        href={`/${profile.username}`}
+        style={{ textDecoration: "none", display: "block" }}
+        aria-label={`View ${displayName}'s profile`}
+      >
+        <div
+          className="similar-profile-card"
+          style={{
+            display: "flex",
+            flexDirection: "column",
+            gap: "12px",
+            padding: "20px",
+            borderRadius: "12px",
+            border: "1px solid var(--color-hairline)",
+            backgroundColor: "var(--color-canvas-soft)",
+            minWidth: "180px",
+            maxWidth: "220px",
+            flex: "0 0 auto",
+            cursor: "pointer",
+            transition:
+              "border-color 0.2s ease, box-shadow 0.2s ease, transform 0.2s ease",
+            position: "relative",
+            overflow: "hidden",
+          }}
+        >
+          {/* Subtle top accent line */}
+          <div
+            aria-hidden="true"
+            style={{
+              position: "absolute",
+              top: 0,
+              left: 0,
+              right: 0,
+              height: "2px",
+              background:
+                "linear-gradient(90deg, var(--color-primary) 0%, transparent 100%)",
+              opacity: 0.6,
+            }}
+          />
+
+          {/* Avatar + Score badge */}
+          <div
+            style={{
+              display: "flex",
+              alignItems: "flex-start",
+              justifyContent: "space-between",
+            }}
+          >
+            <Image
+              src={
+                profile.avatar_url ||
+                `https://avatars.githubusercontent.com/${profile.username}`
+              }
+              alt={displayName}
+              width={44}
+              height={44}
+              unoptimized
+              style={{
+                width: "44px",
+                height: "44px",
+                borderRadius: "50%",
+                border: "2px solid var(--color-hairline)",
+                objectFit: "cover",
+              }}
+            />
+
+            <span
+              style={{
+                fontSize: "11px",
+                fontWeight: 700,
+                color: "var(--color-primary)",
+                backgroundColor: "rgba(62, 207, 142, 0.1)",
+                border: "1px solid rgba(62, 207, 142, 0.2)",
+                borderRadius: "99px",
+                padding: "2px 8px",
+                letterSpacing: "0.3px",
+                whiteSpace: "nowrap",
+              }}
+            >
+              {profile.score.toLocaleString("en-US")}
+            </span>
+          </div>
+
+          {/* Name + handle */}
+          <div>
+            <div
+              style={{
+                fontSize: "14px",
+                fontWeight: 600,
+                color: "var(--color-ink)",
+                lineHeight: 1.3,
+                overflow: "hidden",
+                textOverflow: "ellipsis",
+                whiteSpace: "nowrap",
+              }}
+            >
+              {displayName}
+            </div>
+            <div
+              style={{
+                fontSize: "12px",
+                color: "var(--color-ink-mute)",
+                marginTop: "2px",
+                overflow: "hidden",
+                textOverflow: "ellipsis",
+                whiteSpace: "nowrap",
+              }}
+            >
+              @{profile.username}
+            </div>
+          </div>
+
+          {/* Shared language pills */}
+          {displayLanguages.length > 0 && (
+            <div
+              style={{ display: "flex", gap: "4px", flexWrap: "wrap" }}
+              aria-label={`Languages: ${displayLanguages.join(", ")}`}
+            >
+              {displayLanguages.map((lang) => {
+                const dot = (LANG_COLORS as Record<string, string>)[lang] ?? "#8b8b8b";
+                return (
+                  <span
+                    key={lang}
+                    style={{
+                      display: "inline-flex",
+                      alignItems: "center",
+                      gap: "4px",
+                      fontSize: "10px",
+                      fontWeight: 500,
+                      color: "var(--color-ink-mute)",
+                      backgroundColor: "var(--color-canvas)",
+                      border: "1px solid var(--color-hairline)",
+                      borderRadius: "99px",
+                      padding: "2px 7px",
+                    }}
+                  >
+                    <span
+                      aria-hidden="true"
+                      style={{
+                        width: "6px",
+                        height: "6px",
+                        borderRadius: "50%",
+                        backgroundColor: dot,
+                        flexShrink: 0,
+                      }}
+                    />
+                    {lang}
+                  </span>
+                );
+              })}
+            </div>
+          )}
+
+          {/* Match reason chip */}
+          {(profile.shared_org_count > 0 ||
+            profile.shared_language_count > 0) && (
+            <div
+              style={{
+                fontSize: "10px",
+                color: "var(--color-ink-mute)",
+                display: "flex",
+                alignItems: "center",
+                gap: "4px",
+              }}
+            >
+              <svg
+                width="10"
+                height="10"
+                viewBox="0 0 24 24"
+                fill="none"
+                stroke="currentColor"
+                strokeWidth="2.5"
+                strokeLinecap="round"
+                strokeLinejoin="round"
+                aria-hidden="true"
+                style={{ flexShrink: 0, color: "var(--color-primary)" }}
+              >
+                <path d="M17 21v-2a4 4 0 0 0-4-4H5a4 4 0 0 0-4 4v2" />
+                <circle cx="9" cy="7" r="4" />
+                <path d="M23 21v-2a4 4 0 0 0-3-3.87" />
+                <path d="M16 3.13a4 4 0 0 1 0 7.75" />
+              </svg>
+              {profile.shared_org_count > 0
+                ? `${profile.shared_org_count} shared org${profile.shared_org_count > 1 ? "s" : ""}`
+                : `${profile.shared_language_count} shared lang${profile.shared_language_count > 1 ? "s" : ""}`}
+            </div>
+          )}
+        </div>
+      </Link>
+    </motion.div>
+  );
+}
+
+// ─── Main exported component ───────────────────────────────────────────────────
+export function SimilarProfiles({ username }: SimilarProfilesProps) {
+  const [profiles, setProfiles] = useState<SimilarProfile[]>([]);
+  const [isLoading, setIsLoading] = useState(true);
+
+  useEffect(() => {
+    let cancelled = false;
+
+    async function load() {
+      try {
+        const res = await fetch(`/api/similar-profiles/${username}`);
+        if (cancelled) return;
+        if (!res.ok) {
+          setIsLoading(false);
+          return;
+        }
+        const json = await res.json();
+        if (!cancelled && Array.isArray(json.profiles)) {
+          setProfiles(json.profiles);
+        }
+      } catch {
+        // Silent fail — the section simply won't appear.
+      } finally {
+        if (!cancelled) setIsLoading(false);
+      }
+    }
+
+    load();
+    return () => {
+      cancelled = true;
+    };
+  }, [username]);
+
+  // Show skeletons while loading.
+  if (isLoading) {
+    return (
+      <section
+        aria-label="Similar profiles loading"
+        style={{ marginTop: "44px" }}
+      >
+        <div
+          style={{
+            display: "flex",
+            alignItems: "center",
+            gap: "8px",
+            marginBottom: "16px",
+          }}
+        >
+          <div
+            style={{
+              height: "16px",
+              width: "160px",
+              borderRadius: "6px",
+              backgroundColor: "var(--color-hairline)",
+              animation: "pulse 1.5s ease-in-out infinite",
+            }}
+            aria-hidden="true"
+          />
+        </div>
+        <div style={{ display: "flex", gap: "12px", overflowX: "auto", paddingBottom: "4px" }}>
+          {[0, 1, 2].map((i) => (
+            <SimilarProfileSkeleton key={i} />
+          ))}
+        </div>
+      </section>
+    );
+  }
+
+  // Render nothing if no results (don't pollute the page with an empty section).
+  if (profiles.length === 0) return null;
+
+  return (
+    <section
+      aria-label="Similar profiles — you might also like"
+      style={{ marginTop: "44px" }}
+    >
+      {/* Section header */}
+      <div
+        style={{
+          display: "flex",
+          alignItems: "center",
+          gap: "8px",
+          marginBottom: "16px",
+        }}
+      >
+        <svg
+          width="16"
+          height="16"
+          viewBox="0 0 24 24"
+          fill="none"
+          stroke="var(--color-primary)"
+          strokeWidth="2"
+          strokeLinecap="round"
+          strokeLinejoin="round"
+          aria-hidden="true"
+          style={{ flexShrink: 0 }}
+        >
+          <path d="M17 21v-2a4 4 0 0 0-4-4H5a4 4 0 0 0-4 4v2" />
+          <circle cx="9" cy="7" r="4" />
+          <path d="M23 21v-2a4 4 0 0 0-3-3.87" />
+          <path d="M16 3.13a4 4 0 0 1 0 7.75" />
+        </svg>
+        <h2
+          style={{
+            fontSize: "15px",
+            fontWeight: 600,
+            color: "var(--color-ink)",
+            margin: 0,
+          }}
+        >
+          You might also like
+          <span
+            style={{
+              fontSize: "12px",
+              fontWeight: 400,
+              color: "var(--color-ink-mute)",
+              marginLeft: "8px",
+            }}
+          >
+            similar contributors
+          </span>
+        </h2>
+      </div>
+
+      {/* Horizontally scrollable card row */}
+      <div
+        style={{
+          display: "flex",
+          gap: "12px",
+          overflowX: "auto",
+          paddingBottom: "8px",
+          // Hide scrollbar visually but keep it functional.
+          scrollbarWidth: "none",
+          msOverflowStyle: "none",
+        }}
+      >
+        <AnimatePresence>
+          {profiles.map((profile, i) => (
+            <SimilarProfileCard key={profile.username} profile={profile} index={i} />
+          ))}
+        </AnimatePresence>
+      </div>
+    </section>
+  );
+}
diff --git a/src/lib/db.ts b/src/lib/db.ts
index c321a9d95..154e8dd05 100644
--- a/src/lib/db.ts
+++ b/src/lib/db.ts
@@ -237,3 +237,41 @@ export async function fetchExploreOrganizations(opts: {
     return { data: null, error: err as PostgrestError };
   }
 }
+
+/**
+ * A single row returned by the `find_similar_profiles` Postgres RPC.
+ * Fields mirror the RETURNS TABLE definition in the migration.
+ */
+export interface SimilarProfile {
+  username: string;
+  name: string | null;
+  avatar_url: string | null;
+  score: number;
+  top_languages: string[];
+  shared_language_count: number;
+  shared_org_count: number;
+  similarity_score: number;
+}
+
+/**
+ * Call the `find_similar_profiles` Postgres RPC.
+ *
+ * Returns up to 6 public profiles whose top languages or GitHub orgs overlap
+ * with the target's, ordered by weighted similarity score (languages +2,
+ * orgs +3) then by OSSfolio score descending.
+ *
+ * Returns `{ data, error }` so callers keep their existing fail-closed /
+ * graceful-degradation checks — the same convention as `searchProfiles`.
+ */
+export async function findSimilarProfiles(
+  username: string,
+): Promise<QueryResult<SimilarProfile[]>> {
+  try {
+    const { data, error } = await supabase.rpc("find_similar_profiles", {
+      p_username: username.toLowerCase(),
+    });
+    return { data: (data as SimilarProfile[]) ?? null, error };
+  } catch (err) {
+    return { data: null, error: err as PostgrestError };
+  }
+}
diff --git a/supabase/migrations/20260806000000_add_find_similar_profiles.sql b/supabase/migrations/20260806000000_add_find_similar_profiles.sql
new file mode 100644
index 000000000..5a2b7bcd1
--- /dev/null
+++ b/supabase/migrations/20260806000000_add_find_similar_profiles.sql
@@ -0,0 +1,198 @@
+-- Migration: add_find_similar_profiles
+-- Creates a `security definer` RPC that returns up to 6 public profiles whose
+-- top_languages or GitHub orgs overlap with the target user's profile, ranked
+-- by a weighted similarity score.
+--
+-- Scoring weights:
+--   +2 pts per shared top language  (from profiles.top_languages text[])
+--   +3 pts per shared org slug      (from profile_snapshots.snapshot->'orgs')
+--
+-- The function enforces visibility = 'public' internally (it is security definer
+-- so RLS on profiles is bypassed — the filter must live here, exactly as in
+-- search_profiles). Only profiles with a positive similarity score are returned.
+-- The caller (anon / authenticated) receives at most 6 rows.
+
+create or replace function public.find_similar_profiles(p_username text)
+returns table (
+  username             text,
+  name                 text,
+  avatar_url           text,
+  score                integer,
+  top_languages        text[],
+  shared_language_count integer,
+  shared_org_count      integer,
+  similarity_score      integer
+)
+language plpgsql
+security definer
+set search_path = public
+as $$
+declare
+  v_target_languages text[];
+  v_target_orgs      text[];
+begin
+  -- ── 1. Resolve the normalised username ───────────────────────────────────
+  -- All callers normalise to lower-case before calling, but enforce it here
+  -- so the function is robust even if a caller forgets.
+  p_username := lower(p_username);
+
+  -- ── 2. Fetch the target's top languages ──────────────────────────────────
+  select p.top_languages
+    into v_target_languages
+    from public.profiles p
+   where lower(p.username) = p_username
+     and p.visibility = 'public';
+
+  -- If the target is not a public registered user, return an empty result set.
+  if not found then
+    return;
+  end if;
+
+  -- Default to an empty array so the language overlap expression is safe.
+  v_target_languages := coalesce(v_target_languages, '{}');
+
+  -- ── 3. Fetch the target's org slugs from their latest snapshot ───────────
+  -- The orgs array in the snapshot has the shape:
+  --   [{"login": "...", "name": "...", "avatarUrl": "...", "url": "..."}, ...]
+  -- We extract the "login" field as the canonical identifier.
+  select coalesce(
+    array(
+      select lower(org_elem->>'login')
+        from public.profile_snapshots ps,
+             jsonb_array_elements(
+               case
+                 when jsonb_typeof(ps.snapshot->'orgs') = 'array'
+                 then ps.snapshot->'orgs'
+                 else '[]'::jsonb
+               end
+             ) as org_elem
+       where ps.username = p_username
+         and (org_elem->>'login') is not null
+    ),
+    '{}'::text[]
+  ) into v_target_orgs;
+
+  -- ── 4. Score and return the best-matching public profiles ─────────────────
+  return query
+    select
+      p.username,
+      p.name,
+      p.avatar_url,
+      p.score,
+      p.top_languages,
+
+      -- Shared-language count: number of elements common to both arrays.
+      -- `array_length(...) - array_length(... \ ...)` is the standard PG trick
+      -- for set intersection cardinality without an unnest join.
+      coalesce(
+        (
+          select count(*)::integer
+            from unnest(p.top_languages) as lang
+           where lang = any(v_target_languages)
+        ),
+        0
+      ) as shared_language_count,
+
+      -- Shared-org count: extract this profile's org slugs from its snapshot
+      -- and count how many appear in v_target_orgs.
+      coalesce(
+        (
+          select count(*)::integer
+            from jsonb_array_elements(
+                   case
+                     when jsonb_typeof(ps_cand.snapshot->'orgs') = 'array'
+                     then ps_cand.snapshot->'orgs'
+                     else '[]'::jsonb
+                   end
+                 ) as cand_org
+           where lower(cand_org->>'login') = any(v_target_orgs)
+        ),
+        0
+      ) as shared_org_count,
+
+      -- Weighted similarity score
+      (
+        coalesce(
+          (
+            select count(*)::integer
+              from unnest(p.top_languages) as lang
+             where lang = any(v_target_languages)
+          ),
+          0
+        ) * 2
+        +
+        coalesce(
+          (
+            select count(*)::integer
+              from jsonb_array_elements(
+                     case
+                       when jsonb_typeof(ps_cand.snapshot->'orgs') = 'array'
+                       then ps_cand.snapshot->'orgs'
+                       else '[]'::jsonb
+                     end
+                   ) as cand_org
+             where lower(cand_org->>'login') = any(v_target_orgs)
+          ),
+          0
+        ) * 3
+      ) as similarity_score
+
+    from public.profiles p
+    -- Outer join so profiles without a snapshot still appear (language-only match).
+    left join public.profile_snapshots ps_cand
+           on ps_cand.username = lower(p.username)
+
+    where
+      -- Never return the target themselves.
+      lower(p.username) <> p_username
+      -- Only surface public profiles (enforced manually — security definer
+      -- bypasses RLS, so this must live here just as in search_profiles).
+      and p.visibility = 'public'
+
+    having
+      -- Filter out zero-overlap profiles after scoring.
+      (
+        coalesce(
+          (
+            select count(*)::integer
+              from unnest(p.top_languages) as lang
+             where lang = any(v_target_languages)
+          ),
+          0
+        ) * 2
+        +
+        coalesce(
+          (
+            select count(*)::integer
+              from jsonb_array_elements(
+                     case
+                       when jsonb_typeof(ps_cand.snapshot->'orgs') = 'array'
+                       then ps_cand.snapshot->'orgs'
+                       else '[]'::jsonb
+                     end
+                   ) as cand_org
+             where lower(cand_org->>'login') = any(v_target_orgs)
+          ),
+          0
+        ) * 3
+      ) > 0
+
+    group by
+      p.username, p.name, p.avatar_url, p.score, p.top_languages,
+      ps_cand.snapshot
+
+    order by similarity_score desc, p.score desc
+    limit 6;
+end;
+$$;
+
+comment on function public.find_similar_profiles(text) is
+  'Returns up to 6 public profiles similar to p_username, ranked by shared '
+  'top_languages (+2 pts each) and shared GitHub orgs (+3 pts each). '
+  'Only public profiles with at least one overlap are returned.';
+
+-- Grant execute to client roles (matches the pattern in
+-- increment_profile_view_count). The function already enforces
+-- visibility = ''public'' internally, so anon access is safe.
+grant execute on function public.find_similar_profiles(text)
+  to anon, authenticated, service_role;