Surface verified-work repos + summed stars on skills (skill-side reputation), reusing the work_link index

[zo-sol]

Status: Planned / not yet implemented. Deferred from the current VSCode parity pass because it does not exist on mobile either (net-new feature for both surfaces).

Summary

Skills are already tied to GitHub stars through verified-work, but only agents surface that today (it drives agent tier). The skill view should also list the repos that used a skill and show a summed star count, and let the market sort skills by stars. This reuses the existing indexer — no on-chain change or new data source needed.

What already exists (verified — agentnet-nft-indexer)

• work_link table links, per skill: skill_mint, repo_url, wallet, stars (GitHub stars, periodically refreshed).
• GET /items/:mint/repos (reposForSkill()) already returns a skill's repos ordered by stars DESC.
• starsByWallet() sums stars per wallet (deduped by repo) — this is the agent tier/reputation source today.
• A skill record (IndexedItem) only carries supply as a ranking signal — no stars on the skill itself yet.

So the per-skill data is already indexed; only a skill-level aggregation + UI is missing.

Proposed (low backend effort)

1. Indexer: add starsBySkill() — mirror starsByWallet() but GROUP BY skill_mint (dedupe by repo). Expose via an endpoint or fold into the item payload.
2. Skill detail / card: show the repos that used this skill (like the agent's verified-repos list) + a summed star figure.
3. Market: add a sort-by-stars option alongside the existing supply sort.

Scope

indexer query + contract field + UI (skill card stars, repo list, sort). Both mobile + VSCode. Shares the same source (work_link) as agent-tier stars, so the two stay consistent.

Relation

Sibling to agent tier (verified-work stars). This is the skill-side view of the same reputation graph.

[Jonas-Augustinus-Linus]

#89 스펙 잘 봤습니다. 정리해보니 이미 work_link 테이블(skill_mint 키)·reposForSkill(GET /work-links?skill=, stars DESC)·starsByWallet까지 다 깔려 있고, 남은 건 starsBySkill()(GROUP BY skill_mint) + skill 카드 별점/repo 리스트 + market sort-by-stars 정도로 이해했습니다. 결국 wallet-side에 이미 있는 걸 skill-side로 미러하는 일이라, 새 방향 없이 클라이언트(host) 쪽 배관 조각만 기존 코드 패턴 그대로 맞춰봤습니다. aggregation route와 UI 렌더는 이미 스펙 잡아두셨을 테니 그쪽에 맡기고, 아래는 그 사이를 잇는 read-side 배관까지만입니다.

#87 close 때 남기신 말 그대로

나중에 검증된 작업 기반 스킬 평판 기능을 실제로 만들고, 그때는 마커값을 에이전트가 자유서술 말고 런타임이 실제 장착 skill mint를 자동기록하는 게 맞다

이게 정확히 #89라고 봅니다. 그래서 이번 조각은 marker/verifiedWork write contract는 한 글자도 안 건드리고(buildMarker 그대로), 대신 링크를 저장하기 전에 registerWorkRepo가 지갑이 실제로 보유한 skill mint로만 좁히도록 했습니다. 그래야 starsBySkill 집계가 자유서술 입력이 아니라 실보유에 기반하게 됩니다.

1) 공유 contract — 전부 optional 추가 (marketMessages.ts)

AgentProfile.verifiedRepos?를 optional로 붙였던 것과 똑같은 방식입니다:

export interface SkillCard {
  // ...
  requiredSkills?: string[];
  stars?: number; // #89: 이 skill의 verified-work 별점 합, display-only
}
export interface SkillDetail {
  // ...
  notes?: Note[];
  repos?: VerifiedRepo[]; // #89: stars DESC, 안 채우면 detail이 섹션 숨김
}

구버전 host는 안 채우고 구버전 UI는 무시합니다. protocol.ts는 SkillCard/SkillDetail을 core에서 re-export만 하니 여기 손 안 대도 webview까지 그대로 흐릅니다.

2) skill-keyed indexer reader 2개 (env.ts) — wallet-side와 대칭

fetchStarsByWallet(:86)의 skill-side 쌍둥이입니다. 형태를 그대로 맞춰서, non-OK면 throw → caller가 빈 맵으로 degrade:

async function fetchStarsBySkill(mints: string[]): Promise<Record<string, number>> {
  const qs = mints.length ? `?skills=${encodeURIComponent(mints.join(","))}` : "";
  const res = await fetch(`${INDEXER_URL}/work-links/stars-by-skill${qs}`);
  if (!res.ok) throw new Error(`stars-by-skill ${res.status}`);
  return ((await res.json()) as { stars?: Record<string, number> }).stars ?? {};
}

fetchReposForSkill(mint)은 이미 있는 ?skill= route를 fetchVerifiedRepos(:58) 모양 그대로 감싸서 stars DESC로 반환, non-OK면 [].

• searchSkills: toCard 뒤에 한 번의 집계 호출 → listAgents(:483)의 try-aggregate/catch-degrade와 똑같이, 실패하면 별점 없이 그냥 넘어갑니다.
• getSkillDetail: 기존 Promise.all에 fetchReposForSkill(mint) 한 줄 추가하고 ...(repos.length ? { repos } : {})로 hide-if-undefined. 추가 라운드트립은 이 work-links 읽기 하나뿐입니다.

라우트 이름 /work-links/stars-by-skill은 /work-links/stars(GROUP BY wallet)의 형제로 붙여본 것뿐이고, 실제 경로는 인덱서 레포(별도) 결정입니다. 없는 route면 404 → 빈 맵 → 카드에 별점 배지 안 뜨는 것뿐, 에러는 안 납니다. detail의 repos는 지금 있는 ?skill=만으로 오늘 바로 됩니다.

3) registerWorkRepo owned-mint 게이트 (localhost + vscode 두 surface)

const owned = new Set(Object.values(await market.ownedSkillMints())); // env.ts:436, 지갑이 실제 보유한 skill mint
const skillMints = requested.filter((mint) => owned.has(mint));
if (skillMints.length === 0) throw new Error("Pick at least one skill this wallet owns.");

두 surface 다 이미 ownedSkillMints()가 scope에 있어서 새 fetch·의존성이 없습니다. 그래서 저장되는 링크가 항상 지갑이 실제 보유한 skill에만 묶입니다(정상 UI 픽커는 이미 owned mint만 노출하므로 사용자 흐름은 그대로).

정직한 한계

이걸로 GitHub 별점 자체를 부풀리는 조작(가짜 star 등)까지 막지는 못합니다. 다만 링크를 실보유 skill로만 소싱하면, skill-side 별점을 올리려면 그 skill을 실제로 보유한 상태에서 GitHub 별점까지 조작해야 하니, 조작 비용이 최소한 별점 조작 수준으로 올라갑니다. 그 위(예: star 정당성 검증)는 인덱서/별도 논의 몫으로 남깁니다.

전부 additive·하위호환입니다: 새 필드 다 optional, 함수 시그니처 변화 없음(헬퍼만 신규), 인덱서에 GROUP BY route 없으면 별점 0으로 조용히 degrade. UI(카드 배지·detail repo 리스트·sort-by-stars)는 재작업 몫이라 안 건드렸습니다. 필요하시면 이 diff를 브랜치로 정리해 올리겠습니다.