diff --git a/README.md b/README.md
index 660808a2e..6c631c187 100644
--- a/README.md
+++ b/README.md
@@ -447,9 +447,15 @@ AI/vibe-coded PRs welcome! 🤖
Thanks to all clawtributors:
- 
- 
- 
- 
- 
+ 
+
+
+ 
+ 
+ 
+ 
+ 
+ 
+
+
diff --git a/assets/avatar-placeholder.svg b/assets/avatar-placeholder.svg
new file mode 100644
index 000000000..d0a6999ab
--- /dev/null
+++ b/assets/avatar-placeholder.svg
@@ -0,0 +1,19 @@
+
diff --git a/scripts/clawtributors-map.json b/scripts/clawtributors-map.json
index 657de666c..feda1d56c 100644
--- a/scripts/clawtributors-map.json
+++ b/scripts/clawtributors-map.json
@@ -3,6 +3,8 @@
"jdrhyne",
"manmal"
],
+ "seedCommit": "d6863f87",
+ "placeholderAvatar": "assets/avatar-placeholder.svg",
"displayName": {
"jdrhyne": "Jonathan D. Rhyne (DJ-D)"
},
diff --git a/scripts/update-clawtributors.ts b/scripts/update-clawtributors.ts
index e49b68ac9..ccb4413fd 100644
--- a/scripts/update-clawtributors.ts
+++ b/scripts/update-clawtributors.ts
@@ -10,6 +10,17 @@ type MapConfig = {
displayName?: Record;
nameToLogin?: Record;
emailToLogin?: Record;
+ placeholderAvatar?: string;
+ seedCommit?: string;
+};
+
+type ApiContributor = {
+ login?: string;
+ html_url?: string;
+ avatar_url?: string;
+ name?: string;
+ email?: string;
+ contributions?: number;
};
type User = {
@@ -19,7 +30,8 @@ type User = {
};
type Entry = {
- login: string;
+ key: string;
+ login?: string;
display: string;
html_url: string;
avatar_url: string;
@@ -34,14 +46,22 @@ const nameToLogin = normalizeMap(mapConfig.nameToLogin ?? {});
const emailToLogin = normalizeMap(mapConfig.emailToLogin ?? {});
const ensureLogins = (mapConfig.ensureLogins ?? []).map((login) => login.toLowerCase());
+const readmePath = resolve("README.md");
+const placeholderAvatar = mapConfig.placeholderAvatar ?? "assets/avatar-placeholder.svg";
+const seedCommit = mapConfig.seedCommit ?? null;
+const seedEntries = seedCommit ? parseReadmeEntries(run(`git show ${seedCommit}:README.md`)) : [];
const raw = run(`gh api "repos/${REPO}/contributors?per_page=100&anon=1" --paginate`);
-const contributors = parsePaginatedJson(raw);
+const contributors = parsePaginatedJson(raw) as ApiContributor[];
const apiByLogin = new Map();
+const contributionsByLogin = new Map();
for (const item of contributors) {
if (!item?.login || !item?.html_url || !item?.avatar_url) {
continue;
}
+ if (typeof item.contributions === "number") {
+ contributionsByLogin.set(item.login.toLowerCase(), item.contributions);
+ }
apiByLogin.set(item.login.toLowerCase(), {
login: item.login,
html_url: item.html_url,
@@ -107,25 +127,117 @@ for (const login of ensureLogins) {
}
}
-const entries: Entry[] = [];
+const entriesByKey = new Map();
+
+for (const seed of seedEntries) {
+ const login = loginFromUrl(seed.html_url);
+ const key = login ? login.toLowerCase() : `name:${normalizeName(seed.display)}`;
+ if (entriesByKey.has(key)) {
+ continue;
+ }
+ const avatar = seed.avatar_url && !isGhostAvatar(seed.avatar_url)
+ ? normalizeAvatar(seed.avatar_url)
+ : placeholderAvatar;
+ entriesByKey.set(key, {
+ key,
+ login: login ?? undefined,
+ display: seed.display,
+ html_url: seed.html_url,
+ avatar_url: avatar,
+ lines: 0,
+ });
+}
+
+for (const item of contributors) {
+ const baseName = item.name?.trim() || item.email?.trim() || item.login?.trim();
+ if (!baseName) {
+ continue;
+ }
+
+ const resolvedLogin = item.login
+ ? item.login
+ : resolveLogin(baseName, item.email ?? null, apiByLogin, nameToLogin, emailToLogin);
+
+ if (resolvedLogin) {
+ const key = resolvedLogin.toLowerCase();
+ const existing = entriesByKey.get(key);
+ if (!existing) {
+ let user = apiByLogin.get(key) ?? fetchUser(resolvedLogin);
+ if (user) {
+ const lines = linesByLogin.get(key) ?? 0;
+ const contributions = contributionsByLogin.get(key) ?? 0;
+ entriesByKey.set(key, {
+ key,
+ login: user.login,
+ display: pickDisplay(baseName, user.login, existing?.display),
+ html_url: user.html_url,
+ avatar_url: normalizeAvatar(user.avatar_url),
+ lines: lines > 0 ? lines : contributions,
+ });
+ }
+ } else if (existing) {
+ existing.login = existing.login ?? resolvedLogin;
+ existing.display = pickDisplay(baseName, existing.login, existing.display);
+ if (existing.avatar_url === placeholderAvatar || !existing.avatar_url) {
+ const user = apiByLogin.get(key) ?? fetchUser(resolvedLogin);
+ if (user) {
+ existing.html_url = user.html_url;
+ existing.avatar_url = normalizeAvatar(user.avatar_url);
+ }
+ }
+ const lines = linesByLogin.get(key) ?? 0;
+ const contributions = contributionsByLogin.get(key) ?? 0;
+ existing.lines = Math.max(existing.lines, lines > 0 ? lines : contributions);
+ }
+ continue;
+ }
+
+ const anonKey = `name:${normalizeName(baseName)}`;
+ const existingAnon = entriesByKey.get(anonKey);
+ if (!existingAnon) {
+ entriesByKey.set(anonKey, {
+ key: anonKey,
+ display: baseName,
+ html_url: fallbackHref(baseName),
+ avatar_url: placeholderAvatar,
+ lines: item.contributions ?? 0,
+ });
+ } else {
+ existingAnon.lines = Math.max(existingAnon.lines, item.contributions ?? 0);
+ }
+}
+
for (const [login, lines] of linesByLogin.entries()) {
+ if (entriesByKey.has(login)) {
+ continue;
+ }
let user = apiByLogin.get(login);
if (!user) {
user = fetchUser(login);
}
- if (!user || !user.avatar_url) {
- continue;
+ if (user) {
+ const contributions = contributionsByLogin.get(login) ?? 0;
+ entriesByKey.set(login, {
+ key: login,
+ login: user.login,
+ display: displayName[user.login.toLowerCase()] ?? user.login,
+ html_url: user.html_url,
+ avatar_url: normalizeAvatar(user.avatar_url),
+ lines: lines > 0 ? lines : contributions,
+ });
+ } else {
+ entriesByKey.set(login, {
+ key: login,
+ display: login,
+ html_url: fallbackHref(login),
+ avatar_url: placeholderAvatar,
+ lines,
+ });
}
-
- entries.push({
- login: user.login,
- display: displayName[user.login.toLowerCase()] ?? user.login,
- html_url: user.html_url,
- avatar_url: normalizeAvatar(user.avatar_url),
- lines,
- });
}
+const entries = Array.from(entriesByKey.values());
+
entries.sort((a, b) => {
if (b.lines !== a.lines) {
return b.lines - a.lines;
@@ -143,7 +255,6 @@ for (let i = 0; i < entries.length; i += PER_LINE) {
}
const block = `${lines.join("\n")}\n`;
-const readmePath = resolve("README.md");
const readme = readFileSync(readmePath, "utf8");
const start = readme.indexOf('');
const end = readme.indexOf("
", start);
@@ -198,6 +309,9 @@ function parseCount(value: string): number {
}
function normalizeAvatar(url: string): string {
+ if (!/^https?:/i.test(url)) {
+ return url;
+ }
const lower = url.toLowerCase();
if (lower.includes("s=") || lower.includes("size=")) {
return url;
@@ -206,6 +320,10 @@ function normalizeAvatar(url: string): string {
return `${url}${sep}s=48`;
}
+function isGhostAvatar(url: string): boolean {
+ return url.toLowerCase().includes("ghost.png");
+}
+
function fetchUser(login: string): User | null {
try {
const data = execSync(`gh api users/${login}`, {
@@ -270,3 +388,66 @@ function resolveLogin(
return null;
}
+
+function parseReadmeEntries(
+ content: string
+): Array<{ display: string; html_url: string; avatar_url: string }> {
+ const start = content.indexOf('');
+ const end = content.indexOf("
", start);
+ if (start === -1 || end === -1) {
+ return [];
+ }
+ const block = content.slice(start, end);
+ const entries: Array<{ display: string; html_url: string; avatar_url: string }> = [];
+ const linked = /![](\"([^\"]+)\"[^)
]*alt=\"([^\"]+)\"[^>]*>/g;
+ for (const match of block.matchAll(linked)) {
+ const [, href, src, alt] = match;
+ if (!href || !src || !alt) {
+ continue;
+ }
+ entries.push({ html_url: href, avatar_url: src, display: alt });
+ }
+ const standalone = /]*alt=\"([^\"]+)\"[^>]*>/g;
+ for (const match of block.matchAll(standalone)) {
+ const [, src, alt] = match;
+ if (!src || !alt) {
+ continue;
+ }
+ if (entries.some((entry) => entry.display === alt && entry.avatar_url === src)) {
+ continue;
+ }
+ entries.push({ html_url: fallbackHref(alt), avatar_url: src, display: alt });
+ }
+ return entries;
+}
+
+function loginFromUrl(url: string): string | null {
+ const match = /^https?:\/\/github\.com\/([^\/?#]+)/i.exec(url);
+ if (!match) {
+ return null;
+ }
+ const login = match[1];
+ if (!login || login.toLowerCase() === "search") {
+ return null;
+ }
+ return login;
+}
+
+function fallbackHref(value: string): string {
+ const encoded = encodeURIComponent(value.trim());
+ return encoded ? `https://github.com/search?q=${encoded}` : "https://github.com";
+}
+
+function pickDisplay(baseName: string | null | undefined, login: string, existing?: string): string {
+ const key = login.toLowerCase();
+ if (displayName[key]) {
+ return displayName[key];
+ }
+ if (existing) {
+ return existing;
+ }
+ if (baseName) {
+ return baseName;
+ }
+ return login;
+}