From 3cf1875721a7e2dda255961afd82fa35c0c0372b Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 08:04:34 +0100 Subject: [PATCH 01/54] feat: add a wrapped stats endpoint --- apps/api/src/hackproof/agents.py | 10 +++ apps/api/src/hackproof/queries.py | 123 ++++++++++++++++++++++++++++++ apps/api/src/hackproof/routes.py | 6 ++ apps/api/src/hackproof/schemas.py | 32 ++++++++ apps/api/tests/test_api.py | 18 +++++ 5 files changed, 189 insertions(+) create mode 100644 apps/api/src/hackproof/agents.py diff --git a/apps/api/src/hackproof/agents.py b/apps/api/src/hackproof/agents.py new file mode 100644 index 0000000..f537982 --- /dev/null +++ b/apps/api/src/hackproof/agents.py @@ -0,0 +1,10 @@ +AI_AGENT_LOGINS = ( + "claude", + "claude[bot]", + "cursoragent", + "codex", + "copilot", + "copilot-swe-agent[bot]", + "devin-ai-integration[bot]", + "google-labs-jules[bot]", +) diff --git a/apps/api/src/hackproof/queries.py b/apps/api/src/hackproof/queries.py index 92c98ff..ab6a74e 100644 --- a/apps/api/src/hackproof/queries.py +++ b/apps/api/src/hackproof/queries.py @@ -1,6 +1,7 @@ from datetime import datetime from typing import Any, Literal +from hackproof.agents import AI_AGENT_LOGINS from hackproof.db import pool from hackproof.hackathon import get_hackathon, places from hackproof.integrations.catalog import get_catalog @@ -187,6 +188,91 @@ LIMIT $1 """ +SHIPPED = "p.tier IN ('verified', 'likely')" +HUMAN = "lower(c.login) <> ALL({agents}::text[]) AND c.login NOT LIKE '%[bot]'" + +STACK_PACKAGES = ( + ("Stellar JS SDK", "@stellar/stellar-sdk"), + ("Soroban Rust SDK", "soroban-sdk"), + ("Freighter API", "@stellar/freighter-api"), + ("Wallets Kit", "@creit.tech/stellar-wallets-kit"), +) + +WRAPPED_TOTALS_SQL = f""" +SELECT + (SELECT count(*) FROM projects p WHERE {SHIPPED}) AS projects, + (SELECT count(*) FROM projects WHERE tier = 'verified') AS verified_projects, + (SELECT count(DISTINCT c.login) FROM repo_contributors c + JOIN projects p ON p.full_name = c.full_name + WHERE {SHIPPED} AND {HUMAN.format(agents="$3")}) AS builders, + (SELECT coalesce(sum(r.window_commits), 0) FROM projects p + JOIN repos r ON r.full_name = p.full_name WHERE {SHIPPED}) AS commits, + (SELECT count(*) FROM contracts WHERE deployed_at BETWEEN $1 AND $2) AS contracts, + (SELECT count(DISTINCT deployer) FROM contracts + WHERE deployed_at BETWEEN $1 AND $2) AS deployers, + (SELECT count(*) FROM accounts WHERE funded_at BETWEEN $1 AND $2) AS accounts_funded, + (SELECT count(*) FROM classic_ops WHERE occurred_at BETWEEN $1 AND $2) AS operations, + (SELECT count(*) FROM failed_txs WHERE created_at BETWEEN $1 AND $2) AS failed_txs, + (SELECT coalesce(max(n), 0) FROM ( + SELECT count(*) AS n FROM contracts WHERE deployed_at BETWEEN $1 AND $2 + GROUP BY wasm_hash) shared) AS largest_wasm_contracts, + (SELECT count(*) FROM projects p JOIN repos r ON r.full_name = p.full_name + WHERE {SHIPPED} AND r.dependencies -> 'packages' <> '{{}}'::jsonb) AS readable_projects, + (SELECT count(*) FROM projects p JOIN repos r ON r.full_name = p.full_name + WHERE {SHIPPED} AND r.created_at >= $1) AS new_projects, + (SELECT count(*) FROM ( + SELECT c.login FROM repo_contributors c JOIN projects p ON p.full_name = c.full_name + WHERE {SHIPPED} AND {HUMAN.format(agents="$3")} + GROUP BY c.login HAVING count(DISTINCT c.full_name) > 1) multi) AS multi_team_builders, + (SELECT count(DISTINCT c.full_name) FROM repo_contributors c + JOIN projects p ON p.full_name = c.full_name + WHERE {SHIPPED} AND lower(c.login) = ANY($3::text[])) AS ai_agent_projects +""" + +WRAPPED_OPERATIONS_SQL = """ +SELECT op_type AS label, count(*) AS value +FROM classic_ops +WHERE occurred_at BETWEEN $1 AND $2 +GROUP BY op_type +ORDER BY value DESC, op_type +LIMIT 5 +""" + +WRAPPED_LANGUAGES_SQL = f""" +SELECT coalesce(r.language, 'Other') AS label, count(*) AS value +FROM projects p JOIN repos r ON r.full_name = p.full_name +WHERE {SHIPPED} +GROUP BY 1 +ORDER BY value DESC, label +""" + +WRAPPED_STACK_SQL = f""" +SELECT u.label, count(*) AS value +FROM unnest($1::text[], $2::text[]) AS u(package, label) +JOIN repos r ON r.dependencies -> 'packages' ? u.package +JOIN projects p ON p.full_name = r.full_name AND {SHIPPED} +GROUP BY u.label +""" + +WRAPPED_TEAMS_SQL = f""" +SELECT least(n, 5)::text AS label, count(*) AS value +FROM ( + SELECT c.full_name, count(*) AS n + FROM repo_contributors c JOIN projects p ON p.full_name = c.full_name + WHERE {SHIPPED} AND {HUMAN.format(agents="$1")} + GROUP BY c.full_name) teams +GROUP BY 1 +ORDER BY 1 +""" + +WRAPPED_TRACKS_SQL = f""" +SELECT coalesce(r.declared_track, 'genesis') AS label, count(*) AS value +FROM projects p JOIN repos r ON r.full_name = p.full_name +WHERE {SHIPPED} +GROUP BY 1 +ORDER BY value DESC +""" + RESOURCE_SQL = { "projects": PROJECTS_SQL, "contracts": CONTRACTS_SQL, @@ -292,3 +378,40 @@ async def fetch_integrations() -> list[dict[str, Any]]: async def fetch_countries(limit: int = 12) -> list[dict[str, Any]]: async with pool().acquire() as connection: return [dict(row) for row in await connection.fetch(COUNTRIES_SQL, limit)] + + +async def fetch_wrapped() -> dict[str, Any]: + start, end = window() + agents = list(AI_AGENT_LOGINS) + packages = [package for _, package in STACK_PACKAGES] + labels = [label for label, _ in STACK_PACKAGES] + async with pool().acquire() as connection: + totals = dict(await connection.fetchrow(WRAPPED_TOTALS_SQL, start, end, agents)) + operations = await connection.fetch(WRAPPED_OPERATIONS_SQL, start, end) + languages = await connection.fetch(WRAPPED_LANGUAGES_SQL) + stack = await connection.fetch(WRAPPED_STACK_SQL, packages, labels) + teams = await connection.fetch(WRAPPED_TEAMS_SQL, agents) + tracks = await connection.fetch(WRAPPED_TRACKS_SQL) + partners = sorted( + [ + {"label": row["name"], "value": row["projects"]} + for row in [*await fetch_integrations(), *await fetch_tools()] + if row["projects"] + ], + key=lambda row: (-row["value"], row["label"]), + ) + top_languages = [dict(row) for row in languages[:4]] + other = sum(row["value"] for row in languages[4:]) + return { + **totals, + "window_start": start, + "window_end": end, + "countries": (await fetch_stats())["countries"], + "timeline": await fetch_timeline(), + "operations_by_type": [dict(row) for row in operations], + "languages": [*top_languages, *([{"label": "Other", "value": other}] if other else [])], + "stack": sorted((dict(row) for row in stack), key=lambda row: -row["value"]), + "partners": partners[:8], + "team_sizes": [dict(row) for row in teams], + "tracks": [dict(row) for row in tracks], + } diff --git a/apps/api/src/hackproof/routes.py b/apps/api/src/hackproof/routes.py index 84bd0c8..c5e874a 100644 --- a/apps/api/src/hackproof/routes.py +++ b/apps/api/src/hackproof/routes.py @@ -17,6 +17,7 @@ Tier, TimelinePoint, WasmUpload, + Wrapped, ) router = APIRouter() @@ -38,6 +39,11 @@ async def _page(resource: queries.Resource, q: str | None, limit: int, offset: i return Page(items=items, total=total) +@router.get("/wrapped") +async def wrapped() -> Wrapped: + return Wrapped(**await queries.fetch_wrapped()) + + @router.get("/timeline") async def timeline() -> list[TimelinePoint]: return [TimelinePoint(**point) for point in await queries.fetch_timeline()] diff --git a/apps/api/src/hackproof/schemas.py b/apps/api/src/hackproof/schemas.py index 764eb7a..96379f1 100644 --- a/apps/api/src/hackproof/schemas.py +++ b/apps/api/src/hackproof/schemas.py @@ -155,6 +155,38 @@ class CountryCount(BaseModel): contributors: int +class Count(BaseModel): + label: str + value: int + + +class Wrapped(BaseModel): + window_start: datetime + window_end: datetime + projects: int + verified_projects: int + builders: int + commits: int + countries: int + contracts: int + deployers: int + accounts_funded: int + operations: int + failed_txs: int + largest_wasm_contracts: int + readable_projects: int + new_projects: int + multi_team_builders: int + ai_agent_projects: int + timeline: list[TimelinePoint] + operations_by_type: list[Count] + languages: list[Count] + stack: list[Count] + partners: list[Count] + team_sizes: list[Count] + tracks: list[Count] + + class Page[T](BaseModel): items: list[T] total: int diff --git a/apps/api/tests/test_api.py b/apps/api/tests/test_api.py index aeb1370..4af7d12 100644 --- a/apps/api/tests/test_api.py +++ b/apps/api/tests/test_api.py @@ -92,3 +92,21 @@ def test_a_project_page_lists_where_each_integration_was_found(): detail = client.get(f"/api/projects/{first['project_id']}").json() assert used["slug"] in {use["slug"] for use in detail["integration_uses"]} assert {use["method"] for use in detail["integration_uses"]} <= {"package", "endpoint"} + + +def test_wrapped_buckets_add_up_to_the_projects(): + with TestClient(app) as client: + body = client.get("/api/wrapped").json() + assert sum(item["value"] for item in body["languages"]) == body["projects"] + assert sum(item["value"] for item in body["tracks"]) == body["projects"] + assert sum(item["value"] for item in body["team_sizes"]) <= body["projects"] + assert body["new_projects"] <= body["projects"] + assert body["verified_projects"] <= body["projects"] + + +def test_wrapped_stack_is_bounded_by_the_readable_projects(): + with TestClient(app) as client: + body = client.get("/api/wrapped").json() + assert all(item["value"] <= body["readable_projects"] for item in body["stack"]) + assert body["ai_agent_projects"] <= body["projects"] + assert len(body["timeline"]) == 27 From b6bdc166628d71f231da6d380031e877b4b134e8 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 08:05:20 +0100 Subject: [PATCH 02/54] feat: add the wrapped data hook --- apps/web/src/hooks/use-wrapped.ts | 8 ++++++++ apps/web/src/lib/types.ts | 32 +++++++++++++++++++++++++++++++ 2 files changed, 40 insertions(+) create mode 100644 apps/web/src/hooks/use-wrapped.ts diff --git a/apps/web/src/hooks/use-wrapped.ts b/apps/web/src/hooks/use-wrapped.ts new file mode 100644 index 0000000..9177ef9 --- /dev/null +++ b/apps/web/src/hooks/use-wrapped.ts @@ -0,0 +1,8 @@ +import { useQuery } from '@tanstack/react-query' + +import { apiGet } from '@/lib/api' +import type { Wrapped } from '@/lib/types' + +export function useWrapped() { + return useQuery({ queryKey: ['wrapped'], queryFn: () => apiGet('/wrapped') }) +} diff --git a/apps/web/src/lib/types.ts b/apps/web/src/lib/types.ts index 8c0f6c6..0a504ae 100644 --- a/apps/web/src/lib/types.ts +++ b/apps/web/src/lib/types.ts @@ -163,3 +163,35 @@ export interface CountryCount { country: string contributors: number } + +export interface Count { + label: string + value: number +} + +export interface Wrapped { + window_start: string + window_end: string + projects: number + verified_projects: number + builders: number + commits: number + countries: number + contracts: number + deployers: number + accounts_funded: number + operations: number + failed_txs: number + largest_wasm_contracts: number + readable_projects: number + new_projects: number + multi_team_builders: number + ai_agent_projects: number + timeline: TimelinePoint[] + operations_by_type: Count[] + languages: Count[] + stack: Count[] + partners: Count[] + team_sizes: Count[] + tracks: Count[] +} From a3e0b69dbe8cf00d85d33b051a71eea2c8767ef3 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 08:05:20 +0100 Subject: [PATCH 03/54] feat: add a fixed size stage for the wrapped poster --- apps/web/src/components/wrapped/stage.tsx | 45 +++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 apps/web/src/components/wrapped/stage.tsx diff --git a/apps/web/src/components/wrapped/stage.tsx b/apps/web/src/components/wrapped/stage.tsx new file mode 100644 index 0000000..e0c2bcd --- /dev/null +++ b/apps/web/src/components/wrapped/stage.tsx @@ -0,0 +1,45 @@ +import { type ReactNode, createContext, useContext, useLayoutEffect, useRef, useState } from 'react' + +export const STAGE_WIDTH = 1600 +export const STAGE_HEIGHT = 900 + +const StillContext = createContext(false) + +export function useStill() { + return useContext(StillContext) +} + +function fitScale() { + return Math.min(window.innerWidth / STAGE_WIDTH, window.innerHeight / STAGE_HEIGHT) +} + +export function Stage({ still, children }: { still: boolean; children: ReactNode }) { + const [scale, setScale] = useState(fitScale) + const frame = useRef(null) + + useLayoutEffect(() => { + const resize = () => setScale(fitScale()) + window.addEventListener('resize', resize) + return () => window.removeEventListener('resize', resize) + }, []) + + return ( + +
+
+ {children} +
+
+
+ ) +} From 9353bed0b4614ac43642c61ee051048ac2a0fdae Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 08:10:51 +0100 Subject: [PATCH 04/54] feat: add ai coding agents to the integration catalog --- .../api/src/hackproof/integrations/catalog.py | 9 +++ apps/api/src/hackproof/integrations/detect.py | 32 +++++++++- apps/api/src/hackproof/integrations/models.py | 12 ++++ apps/api/tests/test_integrations.py | 45 +++++++++++++- data/integrations.yaml | 60 +++++++++++++++++++ 5 files changed, 153 insertions(+), 5 deletions(-) diff --git a/apps/api/src/hackproof/integrations/catalog.py b/apps/api/src/hackproof/integrations/catalog.py index 66050eb..12b9488 100644 --- a/apps/api/src/hackproof/integrations/catalog.py +++ b/apps/api/src/hackproof/integrations/catalog.py @@ -23,9 +23,18 @@ class Tool(Product): pass +class Agent(BaseModel): + slug: str + name: str + site: str + files: list[str] = Field(default_factory=list) + authors: list[str] = Field(default_factory=list) + + class Catalog(BaseModel): partners: list[Partner] tools: list[Tool] = Field(default_factory=list) + agents: list[Agent] = Field(default_factory=list) def partner(self, slug: str) -> Partner: return next(partner for partner in self.partners if partner.slug == slug) diff --git a/apps/api/src/hackproof/integrations/detect.py b/apps/api/src/hackproof/integrations/detect.py index 8369313..8fe000e 100644 --- a/apps/api/src/hackproof/integrations/detect.py +++ b/apps/api/src/hackproof/integrations/detect.py @@ -1,10 +1,11 @@ import re -from collections.abc import Sequence +from collections.abc import Iterable, Sequence +from fnmatch import fnmatchcase from pathlib import PurePosixPath -from hackproof.github.dependencies import ECOSYSTEM, PARSERS +from hackproof.github.dependencies import ECOSYSTEM, PARSERS, SKIP_DIRECTORIES from hackproof.integrations.catalog import Catalog, Product -from hackproof.integrations.models import Detection, Method +from hackproof.integrations.models import AgentDetection, Detection, Method PROSE_SUFFIXES = {".md", ".txt"} @@ -72,3 +73,28 @@ def _detect(files: dict[str, str], products: Sequence[Product], owner: str) -> l Detection(slug=partner.slug, method="endpoint", evidence=host, path=path), ) return list(found.values()) + + +def _matches(path: str, pattern: str) -> bool: + return fnmatchcase(path, pattern) or fnmatchcase(path, f"*/{pattern}") + + +def detect_agents( + paths: Iterable[str], logins: Iterable[str], catalog: Catalog +) -> list[AgentDetection]: + tracked = [path for path in paths if not SKIP_DIRECTORIES & set(PurePosixPath(path).parts[:-1])] + people = {login.lower() for login in logins} + found: list[AgentDetection] = [] + for agent in catalog.agents: + for pattern in agent.files: + match = next((path for path in tracked if _matches(path, pattern)), None) + if match: + found.append( + AgentDetection(slug=agent.slug, method="file", evidence=pattern, path=match) + ) + found.extend( + AgentDetection(slug=agent.slug, method="author", evidence=login, path="") + for login in agent.authors + if login.lower() in people + ) + return found diff --git a/apps/api/src/hackproof/integrations/models.py b/apps/api/src/hackproof/integrations/models.py index 3f70cf3..f1dc475 100644 --- a/apps/api/src/hackproof/integrations/models.py +++ b/apps/api/src/hackproof/integrations/models.py @@ -12,3 +12,15 @@ class Detection(BaseModel): method: Method evidence: str path: str + + +AgentMethod = Literal["file", "author"] + + +class AgentDetection(BaseModel): + model_config = ConfigDict(frozen=True) + + slug: str + method: AgentMethod + evidence: str + path: str diff --git a/apps/api/tests/test_integrations.py b/apps/api/tests/test_integrations.py index efde5d4..ebf1909 100644 --- a/apps/api/tests/test_integrations.py +++ b/apps/api/tests/test_integrations.py @@ -1,7 +1,7 @@ import json -from hackproof.integrations.catalog import Catalog, Partner, Tool, get_catalog -from hackproof.integrations.detect import detect, detect_tools +from hackproof.integrations.catalog import Agent, Catalog, Partner, Tool, get_catalog +from hackproof.integrations.detect import detect, detect_agents, detect_tools from hackproof.integrations.models import Detection CATALOG = Catalog( @@ -119,3 +119,44 @@ def test_tools_are_found_apart_from_partners(): assert {d.slug for d in detect_tools(files, catalog, "team")} == {"scaffold"} assert {d.slug for d in detect(files, catalog, "team")} == {"acme"} + + +AGENT_CATALOG = Catalog( + partners=[], + agents=[ + Agent( + slug="cursor", + name="Cursor", + site="https://cursor.example", + files=[".cursor/*", ".cursorrules"], + authors=["cursoragent"], + ), + Agent(slug="claude", name="Claude", site="https://claude.example", files=["CLAUDE.md"]), + ], +) + + +def test_agents_are_found_by_file_and_by_commit_author(): + paths = ["src/app.ts", "CLAUDE.md", ".cursor/rules/style.mdc", "apps/web/.cursorrules"] + + found = detect_agents(paths, ["Someone", "CursorAgent"], AGENT_CATALOG) + + assert {(d.slug, d.method, d.evidence, d.path) for d in found} == { + ("cursor", "file", ".cursor/*", ".cursor/rules/style.mdc"), + ("cursor", "file", ".cursorrules", "apps/web/.cursorrules"), + ("cursor", "author", "cursoragent", ""), + ("claude", "file", "CLAUDE.md", "CLAUDE.md"), + } + + +def test_agent_files_inside_dependencies_are_ignored(): + paths = ["node_modules/pkg/CLAUDE.md", "vendor/.cursor/rules.mdc"] + + assert detect_agents(paths, [], AGENT_CATALOG) == [] + + +def test_the_shipped_catalog_lists_unique_agents(): + agents = get_catalog().agents + + assert {"claude-code", "cursor", "codex", "github-copilot"} <= {agent.slug for agent in agents} + assert len({agent.slug for agent in agents}) == len(agents) diff --git a/data/integrations.yaml b/data/integrations.yaml index cfc6833..4e9f0f5 100644 --- a/data/integrations.yaml +++ b/data/integrations.yaml @@ -145,3 +145,63 @@ tools: stellar-registry-name, ] github_owners: [stellar-registry, theahaco] + +agents: + - slug: claude-code + name: Claude Code + site: https://claude.com/product/claude-code + files: [CLAUDE.md, ".claude/*"] + authors: [claude, "claude[bot]"] + + - slug: cursor + name: Cursor + site: https://cursor.com + files: [".cursor/*", .cursorrules, .cursorignore] + authors: [cursoragent] + + - slug: codex + name: OpenAI Codex + site: https://openai.com/codex + files: [".codex/*"] + authors: [codex] + + - slug: github-copilot + name: GitHub Copilot + site: https://github.com/features/copilot + files: [".github/copilot-instructions.md", ".github/instructions/*", ".github/agents/*"] + authors: [copilot, "copilot-swe-agent[bot]"] + + - slug: windsurf + name: Windsurf + site: https://windsurf.com + files: [.windsurfrules, ".windsurf/*"] + + - slug: gemini-cli + name: Gemini CLI + site: https://github.com/google-gemini/gemini-cli + files: [GEMINI.md, ".gemini/*"] + + - slug: cline + name: Cline + site: https://cline.bot + files: [.clinerules, ".clinerules/*", ".cline/*"] + + - slug: kiro + name: Kiro + site: https://kiro.dev + files: [".kiro/*"] + + - slug: devin + name: Devin + site: https://devin.ai + authors: ["devin-ai-integration[bot]"] + + - slug: jules + name: Jules + site: https://jules.google + authors: ["google-labs-jules[bot]"] + + - slug: agents-md + name: AGENTS.md + site: https://agents.md + files: [AGENTS.md] From 90b568fb6553159c8af2d0cf0f2d945d10ffa30c Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 08:13:32 +0100 Subject: [PATCH 05/54] feat: record the ai agents each repo uses --- apps/api/src/hackproof/db.py | 10 +++++++++ apps/api/src/hackproof/github/models.py | 3 ++- apps/api/src/hackproof/github/scan.py | 15 +++++++++++-- apps/api/tests/test_scan.py | 28 ++++++++++++++++++++++++- 4 files changed, 52 insertions(+), 4 deletions(-) diff --git a/apps/api/src/hackproof/db.py b/apps/api/src/hackproof/db.py index a42afb5..51ffc87 100644 --- a/apps/api/src/hackproof/db.py +++ b/apps/api/src/hackproof/db.py @@ -138,6 +138,16 @@ ); CREATE INDEX IF NOT EXISTS repo_tools_tool ON repo_tools (tool); +CREATE TABLE IF NOT EXISTS repo_agents ( + full_name TEXT NOT NULL, + agent TEXT NOT NULL, + method TEXT NOT NULL, + evidence TEXT NOT NULL, + path TEXT NOT NULL, + PRIMARY KEY (full_name, agent, method, evidence) +); +CREATE INDEX IF NOT EXISTS repo_agents_agent ON repo_agents (agent); + CREATE TABLE IF NOT EXISTS links ( full_name TEXT NOT NULL, subject_kind TEXT NOT NULL, diff --git a/apps/api/src/hackproof/github/models.py b/apps/api/src/hackproof/github/models.py index c05676a..f67e1c4 100644 --- a/apps/api/src/hackproof/github/models.py +++ b/apps/api/src/hackproof/github/models.py @@ -4,7 +4,7 @@ from pydantic import BaseModel, ConfigDict, Field from hackproof.github.track import Track -from hackproof.integrations.models import Detection +from hackproof.integrations.models import AgentDetection, Detection RefKind = Literal["contract", "account", "asset", "wasm", "network"] @@ -60,4 +60,5 @@ class RepoScan(BaseModel): stellar_added_in_window: bool | None integrations: list[Detection] tools: list[Detection] = Field(default_factory=list) + agents: list[AgentDetection] = Field(default_factory=list) contributors: list[Contributor] diff --git a/apps/api/src/hackproof/github/scan.py b/apps/api/src/hackproof/github/scan.py index ed251ae..f69fe4f 100644 --- a/apps/api/src/hackproof/github/scan.py +++ b/apps/api/src/hackproof/github/scan.py @@ -16,7 +16,7 @@ from hackproof.github.track import declared_track from hackproof.hackathon import Discovery, Window from hackproof.integrations.catalog import Catalog, get_catalog -from hackproof.integrations.detect import detect, detect_tools +from hackproof.integrations.detect import detect, detect_agents, detect_tools TEXT_SUFFIXES = { ".rs", ".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".py", ".go", ".toml", ".json", @@ -124,6 +124,7 @@ async def scan(self, repo: Candidate) -> RepoScan | None: if dependencies.packages else None ) + contributors = contributors_from(people) return RepoScan( full_name=repo.full_name, declared_track=declared_track(files), @@ -132,7 +133,12 @@ async def scan(self, repo: Candidate) -> RepoScan | None: stellar_added_in_window=added, integrations=detect(files, self._catalog, repo.owner), tools=detect_tools(files, self._catalog, repo.owner), - contributors=contributors_from(people), + agents=detect_agents( + (entry["path"] for entry in tree["tree"]), + (item["login"] for item in people or []), + self._catalog, + ), + contributors=contributors, ) @@ -182,6 +188,11 @@ async def store_scan(connection: asyncpg.Connection, scan: RepoScan) -> None: "INSERT INTO repo_tools VALUES ($1, $2, $3, $4, $5)", [(scan.full_name, t.slug, t.method, t.evidence, t.path) for t in scan.tools], ) + await connection.execute("DELETE FROM repo_agents WHERE full_name = $1", scan.full_name) + await connection.executemany( + "INSERT INTO repo_agents VALUES ($1, $2, $3, $4, $5)", + [(scan.full_name, a.slug, a.method, a.evidence, a.path) for a in scan.agents], + ) await connection.execute( """ UPDATE repos SET dependencies = $2, stellar_added_in_window = $3, diff --git a/apps/api/tests/test_scan.py b/apps/api/tests/test_scan.py index 7639814..b1cf7f3 100644 --- a/apps/api/tests/test_scan.py +++ b/apps/api/tests/test_scan.py @@ -1,7 +1,7 @@ from hackproof.github.demo import is_public_http from hackproof.github.models import DependencyFingerprint, RepoScan from hackproof.github.scan import DEMO_URL, contributors_from, select_files, store_scan -from hackproof.integrations.models import Detection +from hackproof.integrations.models import AgentDetection, Detection from tests.helpers import add_repo @@ -86,3 +86,29 @@ def scan(*found: Detection) -> RepoScan: await store_scan(db, scan()) assert await db.fetchval("SELECT count(*) FROM repo_integrations") == 0 + + +async def test_a_rescan_replaces_the_stored_agents(scratch_db): + db = scratch_db + await add_repo(db, "team/app") + detection = AgentDetection( + slug="cursor", method="file", evidence=".cursorrules", path=".cursorrules" + ) + + def scan(*found: AgentDetection) -> RepoScan: + return RepoScan( + full_name="team/app", + refs=[], + dependencies=DependencyFingerprint(), + stellar_added_in_window=None, + integrations=[], + agents=list(found), + contributors=[], + ) + + await store_scan(db, scan(detection)) + await store_scan(db, scan(detection)) + assert await db.fetchval("SELECT count(*) FROM repo_agents") == 1 + + await store_scan(db, scan()) + assert await db.fetchval("SELECT count(*) FROM repo_agents") == 0 From 543fb9a9c4b2c803046fb08a307bf3008fd12ca1 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 08:13:32 +0100 Subject: [PATCH 06/54] feat: catalog stellar raven, stellar skills and the agents seen in the repos --- apps/api/tests/test_integrations.py | 11 +++++++++++ data/integrations.yaml | 19 ++++++++++++++++++- 2 files changed, 29 insertions(+), 1 deletion(-) diff --git a/apps/api/tests/test_integrations.py b/apps/api/tests/test_integrations.py index ebf1909..638e349 100644 --- a/apps/api/tests/test_integrations.py +++ b/apps/api/tests/test_integrations.py @@ -160,3 +160,14 @@ def test_the_shipped_catalog_lists_unique_agents(): assert {"claude-code", "cursor", "codex", "github-copilot"} <= {agent.slug for agent in agents} assert len({agent.slug for agent in agents}) == len(agents) + + +def test_stellar_raven_and_skills_are_found_in_agent_config_files(): + files = { + ".mcp.json": '{"mcpServers": {"stellar-raven": {"url": "https://raven.stellar.org/mcp"}}}', + "skills-lock.json": '{"skills": {"dapp": {"source": "stellar/stellar-dev-skill"}}}', + } + + found = {(d.slug, d.path) for d in detect_tools(files, get_catalog(), "team")} + + assert found == {("stellar-raven", ".mcp.json"), ("stellar-skills", "skills-lock.json")} diff --git a/data/integrations.yaml b/data/integrations.yaml index 4e9f0f5..e2bba7f 100644 --- a/data/integrations.yaml +++ b/data/integrations.yaml @@ -146,11 +146,23 @@ tools: ] github_owners: [stellar-registry, theahaco] + - slug: stellar-raven + name: Stellar Raven + site: https://raven.stellar.org + endpoints: [raven.stellar.org, raven.stellar.buzz] + github_owners: [stellar] + + - slug: stellar-skills + name: Stellar Skills + site: https://skills.stellar.org + endpoints: [skills.stellar.org, stellar/stellar-dev-skill] + github_owners: [stellar] + agents: - slug: claude-code name: Claude Code site: https://claude.com/product/claude-code - files: [CLAUDE.md, ".claude/*"] + files: [CLAUDE.md, ".claude/*", ".claude-plugin/*"] authors: [claude, "claude[bot]"] - slug: cursor @@ -191,6 +203,11 @@ agents: site: https://kiro.dev files: [".kiro/*"] + - slug: lovable + name: Lovable + site: https://lovable.dev + files: [".lovable/*"] + - slug: devin name: Devin site: https://devin.ai From ec48128e03321158f51d7675f0d3f83ff3122ac9 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 08:14:07 +0100 Subject: [PATCH 07/54] feat: expose ai agents on projects and an agents endpoint --- apps/api/src/hackproof/queries.py | 21 +++++++++++++++++++++ apps/api/src/hackproof/routes.py | 6 ++++++ apps/api/src/hackproof/schemas.py | 8 ++++++++ apps/api/tests/test_api.py | 9 +++++++++ 4 files changed, 44 insertions(+) diff --git a/apps/api/src/hackproof/queries.py b/apps/api/src/hackproof/queries.py index ab6a74e..7da2673 100644 --- a/apps/api/src/hackproof/queries.py +++ b/apps/api/src/hackproof/queries.py @@ -18,6 +18,8 @@ GROUP BY i.partner ORDER BY i.partner) AS integrations, ARRAY(SELECT t.tool FROM repo_tools t WHERE t.full_name = p.full_name GROUP BY t.tool ORDER BY t.tool) AS tools, + ARRAY(SELECT a.agent FROM repo_agents a WHERE a.full_name = p.full_name + GROUP BY a.agent ORDER BY a.agent) AS agents, count(*) OVER () AS total FROM projects p LEFT JOIN repos r ON r.full_name = p.full_name @@ -170,6 +172,13 @@ GROUP BY t.tool """ +AGENTS_SQL = """ +SELECT a.agent AS slug, count(DISTINCT a.full_name) AS projects +FROM repo_agents a +JOIN projects p ON p.full_name = a.full_name AND p.tier IN ('verified', 'likely') +GROUP BY a.agent +""" + TOOL_USES_SQL = """ SELECT tool AS slug, method, evidence, path FROM repo_tools @@ -415,3 +424,15 @@ async def fetch_wrapped() -> dict[str, Any]: "team_sizes": [dict(row) for row in teams], "tracks": [dict(row) for row in tracks], } + + +async def fetch_agents() -> list[dict[str, Any]]: + async with pool().acquire() as connection: + counts = {row["slug"]: row["projects"] for row in await connection.fetch(AGENTS_SQL)} + return [ + { + **agent.model_dump(include={"slug", "name", "site"}), + "projects": counts.get(agent.slug, 0), + } + for agent in get_catalog().agents + ] diff --git a/apps/api/src/hackproof/routes.py b/apps/api/src/hackproof/routes.py index c5e874a..4871480 100644 --- a/apps/api/src/hackproof/routes.py +++ b/apps/api/src/hackproof/routes.py @@ -4,6 +4,7 @@ from hackproof import queries from hackproof.schemas import ( + AiAgent, Builder, Contract, CountryCount, @@ -64,6 +65,11 @@ async def tools() -> list[EcosystemTool]: return [EcosystemTool(**row) for row in await queries.fetch_tools()] +@router.get("/agents") +async def agents() -> list[AiAgent]: + return [AiAgent(**row) for row in await queries.fetch_agents()] + + @router.get("/projects") async def projects( q: Search = None, diff --git a/apps/api/src/hackproof/schemas.py b/apps/api/src/hackproof/schemas.py index 96379f1..6b0ecfb 100644 --- a/apps/api/src/hackproof/schemas.py +++ b/apps/api/src/hackproof/schemas.py @@ -55,6 +55,7 @@ class Project(BaseModel): track: Literal["genesis", "scale"] | None = None integrations: list[str] = [] tools: list[str] = [] + agents: list[str] = [] award: Place | None = None @@ -150,6 +151,13 @@ class EcosystemTool(BaseModel): projects: int +class AiAgent(BaseModel): + slug: str + name: str + site: str + projects: int + + class CountryCount(BaseModel): country: str contributors: int diff --git a/apps/api/tests/test_api.py b/apps/api/tests/test_api.py index 4af7d12..576d85a 100644 --- a/apps/api/tests/test_api.py +++ b/apps/api/tests/test_api.py @@ -110,3 +110,12 @@ def test_wrapped_stack_is_bounded_by_the_readable_projects(): assert all(item["value"] <= body["readable_projects"] for item in body["stack"]) assert body["ai_agent_projects"] <= body["projects"] assert len(body["timeline"]) == 27 + + +def test_agents_list_every_catalog_agent_with_a_project_count(): + with TestClient(app) as client: + body = client.get("/api/agents").json() + projects = client.get("/api/projects", params={"limit": 5}).json()["items"] + assert {"claude-code", "cursor", "codex"} <= {row["slug"] for row in body} + assert all(row["projects"] >= 0 for row in body) + assert all(isinstance(item["agents"], list) for item in projects) From 75fa64f97b830b0fa6a25029d10aa942aaf0b12e Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 08:19:02 +0100 Subject: [PATCH 08/54] refactor: keep only the new numbers in the wrapped endpoint --- apps/api/src/hackproof/agents.py | 10 --- apps/api/src/hackproof/queries.py | 105 +++++++----------------------- apps/api/src/hackproof/schemas.py | 28 +++----- apps/api/tests/test_api.py | 19 +++--- 4 files changed, 44 insertions(+), 118 deletions(-) delete mode 100644 apps/api/src/hackproof/agents.py diff --git a/apps/api/src/hackproof/agents.py b/apps/api/src/hackproof/agents.py deleted file mode 100644 index f537982..0000000 --- a/apps/api/src/hackproof/agents.py +++ /dev/null @@ -1,10 +0,0 @@ -AI_AGENT_LOGINS = ( - "claude", - "claude[bot]", - "cursoragent", - "codex", - "copilot", - "copilot-swe-agent[bot]", - "devin-ai-integration[bot]", - "google-labs-jules[bot]", -) diff --git a/apps/api/src/hackproof/queries.py b/apps/api/src/hackproof/queries.py index 7da2673..b22c347 100644 --- a/apps/api/src/hackproof/queries.py +++ b/apps/api/src/hackproof/queries.py @@ -1,7 +1,6 @@ from datetime import datetime from typing import Any, Literal -from hackproof.agents import AI_AGENT_LOGINS from hackproof.db import pool from hackproof.hackathon import get_hackathon, places from hackproof.integrations.catalog import get_catalog @@ -198,44 +197,22 @@ """ SHIPPED = "p.tier IN ('verified', 'likely')" -HUMAN = "lower(c.login) <> ALL({agents}::text[]) AND c.login NOT LIKE '%[bot]'" - -STACK_PACKAGES = ( - ("Stellar JS SDK", "@stellar/stellar-sdk"), - ("Soroban Rust SDK", "soroban-sdk"), - ("Freighter API", "@stellar/freighter-api"), - ("Wallets Kit", "@creit.tech/stellar-wallets-kit"), -) +HUMAN = "lower(c.login) <> ALL($1::text[]) AND c.login NOT LIKE '%[bot]'" +TOP_BUILDERS = 12 +MAX_BUILDERS = 1_000 WRAPPED_TOTALS_SQL = f""" SELECT - (SELECT count(*) FROM projects p WHERE {SHIPPED}) AS projects, - (SELECT count(*) FROM projects WHERE tier = 'verified') AS verified_projects, (SELECT count(DISTINCT c.login) FROM repo_contributors c JOIN projects p ON p.full_name = c.full_name - WHERE {SHIPPED} AND {HUMAN.format(agents="$3")}) AS builders, - (SELECT coalesce(sum(r.window_commits), 0) FROM projects p - JOIN repos r ON r.full_name = p.full_name WHERE {SHIPPED}) AS commits, - (SELECT count(*) FROM contracts WHERE deployed_at BETWEEN $1 AND $2) AS contracts, + WHERE {SHIPPED} AND {HUMAN}) AS builders, + (SELECT count(*) FROM accounts WHERE funded_at BETWEEN $2 AND $3) AS accounts_funded, (SELECT count(DISTINCT deployer) FROM contracts - WHERE deployed_at BETWEEN $1 AND $2) AS deployers, - (SELECT count(*) FROM accounts WHERE funded_at BETWEEN $1 AND $2) AS accounts_funded, - (SELECT count(*) FROM classic_ops WHERE occurred_at BETWEEN $1 AND $2) AS operations, - (SELECT count(*) FROM failed_txs WHERE created_at BETWEEN $1 AND $2) AS failed_txs, + WHERE deployed_at BETWEEN $2 AND $3) AS deployers, + (SELECT count(*) FROM classic_ops WHERE occurred_at BETWEEN $2 AND $3) AS operations, (SELECT coalesce(max(n), 0) FROM ( - SELECT count(*) AS n FROM contracts WHERE deployed_at BETWEEN $1 AND $2 - GROUP BY wasm_hash) shared) AS largest_wasm_contracts, - (SELECT count(*) FROM projects p JOIN repos r ON r.full_name = p.full_name - WHERE {SHIPPED} AND r.dependencies -> 'packages' <> '{{}}'::jsonb) AS readable_projects, - (SELECT count(*) FROM projects p JOIN repos r ON r.full_name = p.full_name - WHERE {SHIPPED} AND r.created_at >= $1) AS new_projects, - (SELECT count(*) FROM ( - SELECT c.login FROM repo_contributors c JOIN projects p ON p.full_name = c.full_name - WHERE {SHIPPED} AND {HUMAN.format(agents="$3")} - GROUP BY c.login HAVING count(DISTINCT c.full_name) > 1) multi) AS multi_team_builders, - (SELECT count(DISTINCT c.full_name) FROM repo_contributors c - JOIN projects p ON p.full_name = c.full_name - WHERE {SHIPPED} AND lower(c.login) = ANY($3::text[])) AS ai_agent_projects + SELECT count(*) AS n FROM contracts WHERE deployed_at BETWEEN $2 AND $3 + GROUP BY wasm_hash) shared) AS largest_wasm_contracts """ WRAPPED_OPERATIONS_SQL = """ @@ -247,39 +224,26 @@ LIMIT 5 """ -WRAPPED_LANGUAGES_SQL = f""" -SELECT coalesce(r.language, 'Other') AS label, count(*) AS value -FROM projects p JOIN repos r ON r.full_name = p.full_name -WHERE {SHIPPED} -GROUP BY 1 -ORDER BY value DESC, label -""" - -WRAPPED_STACK_SQL = f""" -SELECT u.label, count(*) AS value -FROM unnest($1::text[], $2::text[]) AS u(package, label) -JOIN repos r ON r.dependencies -> 'packages' ? u.package -JOIN projects p ON p.full_name = r.full_name AND {SHIPPED} -GROUP BY u.label -""" - WRAPPED_TEAMS_SQL = f""" SELECT least(n, 5)::text AS label, count(*) AS value FROM ( SELECT c.full_name, count(*) AS n FROM repo_contributors c JOIN projects p ON p.full_name = c.full_name - WHERE {SHIPPED} AND {HUMAN.format(agents="$1")} + WHERE {SHIPPED} AND {HUMAN} GROUP BY c.full_name) teams GROUP BY 1 ORDER BY 1 """ -WRAPPED_TRACKS_SQL = f""" -SELECT coalesce(r.declared_track, 'genesis') AS label, count(*) AS value -FROM projects p JOIN repos r ON r.full_name = p.full_name -WHERE {SHIPPED} -GROUP BY 1 -ORDER BY value DESC +WRAPPED_BUILDERS_SQL = f""" +SELECT c.login, max(c.avatar_url) AS avatar_url, + count(DISTINCT c.full_name) AS projects, sum(c.contributions)::int AS contributions +FROM repo_contributors c JOIN projects p ON p.full_name = c.full_name +WHERE {SHIPPED} AND {HUMAN} +GROUP BY c.login +HAVING count(DISTINCT c.full_name) >= $2 +ORDER BY projects DESC, contributions DESC, c.login +LIMIT $3 """ RESOURCE_SQL = { @@ -391,38 +355,19 @@ async def fetch_countries(limit: int = 12) -> list[dict[str, Any]]: async def fetch_wrapped() -> dict[str, Any]: start, end = window() - agents = list(AI_AGENT_LOGINS) - packages = [package for _, package in STACK_PACKAGES] - labels = [label for label, _ in STACK_PACKAGES] + agents = [login.lower() for agent in get_catalog().agents for login in agent.authors] async with pool().acquire() as connection: - totals = dict(await connection.fetchrow(WRAPPED_TOTALS_SQL, start, end, agents)) + totals = dict(await connection.fetchrow(WRAPPED_TOTALS_SQL, agents, start, end)) operations = await connection.fetch(WRAPPED_OPERATIONS_SQL, start, end) - languages = await connection.fetch(WRAPPED_LANGUAGES_SQL) - stack = await connection.fetch(WRAPPED_STACK_SQL, packages, labels) teams = await connection.fetch(WRAPPED_TEAMS_SQL, agents) - tracks = await connection.fetch(WRAPPED_TRACKS_SQL) - partners = sorted( - [ - {"label": row["name"], "value": row["projects"]} - for row in [*await fetch_integrations(), *await fetch_tools()] - if row["projects"] - ], - key=lambda row: (-row["value"], row["label"]), - ) - top_languages = [dict(row) for row in languages[:4]] - other = sum(row["value"] for row in languages[4:]) + multi_team = await connection.fetch(WRAPPED_BUILDERS_SQL, agents, 2, MAX_BUILDERS) + top = await connection.fetch(WRAPPED_BUILDERS_SQL, agents, 1, TOP_BUILDERS) return { **totals, - "window_start": start, - "window_end": end, - "countries": (await fetch_stats())["countries"], - "timeline": await fetch_timeline(), "operations_by_type": [dict(row) for row in operations], - "languages": [*top_languages, *([{"label": "Other", "value": other}] if other else [])], - "stack": sorted((dict(row) for row in stack), key=lambda row: -row["value"]), - "partners": partners[:8], "team_sizes": [dict(row) for row in teams], - "tracks": [dict(row) for row in tracks], + "multi_team_builders": [dict(row) for row in multi_team], + "top_builders": [dict(row) for row in sorted(top, key=lambda row: -row["contributions"])], } diff --git a/apps/api/src/hackproof/schemas.py b/apps/api/src/hackproof/schemas.py index 6b0ecfb..049b9b4 100644 --- a/apps/api/src/hackproof/schemas.py +++ b/apps/api/src/hackproof/schemas.py @@ -168,31 +168,23 @@ class Count(BaseModel): value: int -class Wrapped(BaseModel): - window_start: datetime - window_end: datetime +class WrappedBuilder(BaseModel): + login: str + avatar_url: str | None projects: int - verified_projects: int + contributions: int + + +class Wrapped(BaseModel): builders: int - commits: int - countries: int - contracts: int - deployers: int accounts_funded: int + deployers: int operations: int - failed_txs: int largest_wasm_contracts: int - readable_projects: int - new_projects: int - multi_team_builders: int - ai_agent_projects: int - timeline: list[TimelinePoint] operations_by_type: list[Count] - languages: list[Count] - stack: list[Count] - partners: list[Count] team_sizes: list[Count] - tracks: list[Count] + multi_team_builders: list[WrappedBuilder] + top_builders: list[WrappedBuilder] class Page[T](BaseModel): diff --git a/apps/api/tests/test_api.py b/apps/api/tests/test_api.py index 576d85a..f9f7ea7 100644 --- a/apps/api/tests/test_api.py +++ b/apps/api/tests/test_api.py @@ -94,22 +94,21 @@ def test_a_project_page_lists_where_each_integration_was_found(): assert {use["method"] for use in detail["integration_uses"]} <= {"package", "endpoint"} -def test_wrapped_buckets_add_up_to_the_projects(): +def test_wrapped_team_sizes_fit_inside_the_projects(): with TestClient(app) as client: body = client.get("/api/wrapped").json() - assert sum(item["value"] for item in body["languages"]) == body["projects"] - assert sum(item["value"] for item in body["tracks"]) == body["projects"] - assert sum(item["value"] for item in body["team_sizes"]) <= body["projects"] - assert body["new_projects"] <= body["projects"] - assert body["verified_projects"] <= body["projects"] + stats = client.get("/api/stats").json() + assert sum(item["value"] for item in body["team_sizes"]) <= stats["projects"] + assert {item["label"] for item in body["team_sizes"]} <= {"1", "2", "3", "4", "5"} -def test_wrapped_stack_is_bounded_by_the_readable_projects(): +def test_wrapped_builders_are_ranked_and_multi_team_means_two_or_more_projects(): with TestClient(app) as client: body = client.get("/api/wrapped").json() - assert all(item["value"] <= body["readable_projects"] for item in body["stack"]) - assert body["ai_agent_projects"] <= body["projects"] - assert len(body["timeline"]) == 27 + commits = [builder["contributions"] for builder in body["top_builders"]] + assert commits == sorted(commits, reverse=True) + assert all(builder["projects"] >= 2 for builder in body["multi_team_builders"]) + assert not {"cursoragent", "codex"} & {b["login"] for b in body["multi_team_builders"]} def test_agents_list_every_catalog_agent_with_a_project_count(): From ff98afb014cb89c69c9f56040135799adf71b2d5 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 08:23:43 +0100 Subject: [PATCH 09/54] feat: add design tokens for the wrapped poster --- apps/web/src/index.css | 80 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 80 insertions(+) diff --git a/apps/web/src/index.css b/apps/web/src/index.css index 0821bfd..82ae925 100644 --- a/apps/web/src/index.css +++ b/apps/web/src/index.css @@ -63,6 +63,39 @@ --tracking-wide: calc(var(--tracking-normal) + 0.025em); --tracking-wider: calc(var(--tracking-normal) + 0.05em); --tracking-widest: calc(var(--tracking-normal) + 0.1em); + + --color-poster: var(--poster); + --color-tile: var(--tile); + --color-tile-border: var(--tile-border); + --color-track: var(--track); + --color-axis: var(--axis); + --color-gridline: var(--gridline); + --color-glow-primary: var(--glow-primary); + --color-glow-secondary: var(--glow-secondary); +} + +@theme { + --text-eyebrow: 0.6875rem; + --text-eyebrow--line-height: 1; + --text-stat: 1.625rem; + --text-stat--line-height: 1; + --text-figure: 2.5rem; + --text-figure--line-height: 1; + --text-figure-lg: 3.5rem; + --text-figure-lg--line-height: 1; + --text-headline: 2.875rem; + --text-headline--line-height: 1; + --text-display: 9.375rem; + --text-display--line-height: 0.82; + --tracking-eyebrow: 0.2em; + --spacing-chart-sm: 8rem; + --spacing-chart-md: 12.25rem; + --spacing-chart-lg: 13.625rem; + --spacing-glow: 47.5rem; + --spacing-glow-lg: 56.25rem; + --blur-glow: 8.125rem; + --blur-glow-lg: 9.375rem; + --shadow-tile: inset 0 1px 0 var(--tile-border); } :root { @@ -99,6 +132,18 @@ --sidebar-border: #d6d2c4; --sidebar-ring: #fdda24; --radius: 0.5rem; + --poster: #070707; + --tile: rgb(255 255 255 / 3.5%); + --tile-border: rgb(255 255 255 / 10%); + --track: rgb(255 255 255 / 5%); + --axis: rgb(255 255 255 / 50%); + --gridline: rgb(255 255 255 / 7%); + --glow-primary: rgb(253 218 36 / 13%); + --glow-secondary: rgb(183 172 232 / 13%); + --dot: rgb(255 255 255 / 5%); + --dot-gap: 1.75rem; + --lens-label-width: 7.5rem; + --lens-count-width: 2.5rem; --shadow-2xs: 0 0.25rem 0.5rem 0 hsl(222.2 47.4% 11.2% / 0.05); --shadow-xs: 0 0.25rem 0.5rem 0 hsl(222.2 47.4% 11.2% / 0.05); --shadow-sm: @@ -162,6 +207,41 @@ --skeleton-glint: color-mix(in oklab, var(--primary) 17%, var(--card)); } +@utility poster-dots { + background-image: radial-gradient(var(--dot) 1px, transparent 1px); + background-size: var(--dot-gap) var(--dot-gap); +} + +@utility lens-row { + display: grid; + grid-template-columns: var(--lens-label-width) 1fr var(--lens-count-width); +} + +@utility poster-grid { + display: grid; + grid-template-columns: 26.25rem 1fr 23.5rem; +} + +@utility poster-chart { + & .recharts-cartesian-axis-tick-value { + fill: var(--axis); + font-size: var(--text-eyebrow); + } + + & .recharts-label-list .recharts-text, + & .recharts-reference-dot .recharts-text, + & .recharts-reference-area .recharts-text { + fill: var(--foreground); + font-size: var(--text-xs); + font-weight: 600; + } + + & .recharts-yAxis .recharts-cartesian-axis-tick-value { + fill: var(--foreground); + font-size: var(--text-sm); + } +} + @keyframes skeleton-shimmer { from { background-position: 160% 0; From 3e97c0bd37d82d6a5bc482c3ea01b031bb1673a7 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 08:23:43 +0100 Subject: [PATCH 10/54] feat: add ai agents to the web types and hooks --- apps/web/src/hooks/use-projects.ts | 10 ++++++++- apps/web/src/lib/types.ts | 36 +++++++++++++++--------------- 2 files changed, 27 insertions(+), 19 deletions(-) diff --git a/apps/web/src/hooks/use-projects.ts b/apps/web/src/hooks/use-projects.ts index a7f70f5..0a54db9 100644 --- a/apps/web/src/hooks/use-projects.ts +++ b/apps/web/src/hooks/use-projects.ts @@ -2,7 +2,7 @@ import { useQuery } from '@tanstack/react-query' import { apiGet } from '@/lib/api' import { STRICT_TIERS } from '@/lib/format' -import type { EcosystemTool, Integration, Page, Project } from '@/lib/types' +import type { AiAgent, EcosystemTool, Integration, Page, Project } from '@/lib/types' const EVERYTHING = 200 @@ -31,3 +31,11 @@ export function useIntegrations() { staleTime: Infinity, }) } + +export function useAgents() { + return useQuery({ + queryKey: ['agents'], + queryFn: () => apiGet('/agents'), + staleTime: Infinity, + }) +} diff --git a/apps/web/src/lib/types.ts b/apps/web/src/lib/types.ts index 0a504ae..ff26ed1 100644 --- a/apps/web/src/lib/types.ts +++ b/apps/web/src/lib/types.ts @@ -65,6 +65,14 @@ export interface Project { track: Track | null integrations: string[] tools: string[] + agents: string[] +} + +export interface AiAgent { + slug: string + name: string + site: string + projects: number } export interface EcosystemTool { @@ -169,29 +177,21 @@ export interface Count { value: number } -export interface Wrapped { - window_start: string - window_end: string +export interface WrappedBuilder { + login: string + avatar_url: string | null projects: number - verified_projects: number + contributions: number +} + +export interface Wrapped { builders: number - commits: number - countries: number - contracts: number - deployers: number accounts_funded: number + deployers: number operations: number - failed_txs: number largest_wasm_contracts: number - readable_projects: number - new_projects: number - multi_team_builders: number - ai_agent_projects: number - timeline: TimelinePoint[] operations_by_type: Count[] - languages: Count[] - stack: Count[] - partners: Count[] team_sizes: Count[] - tracks: Count[] + multi_team_builders: WrappedBuilder[] + top_builders: WrappedBuilder[] } From 9e4be1311f5b1c2a5496afc9e04d1fa9ce01fc79 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 08:23:43 +0100 Subject: [PATCH 11/54] feat: add lens helpers for the wrapped poster --- apps/web/src/lib/wrapped.ts | 52 +++++++++++++++++++++++++++++++++++++ 1 file changed, 52 insertions(+) create mode 100644 apps/web/src/lib/wrapped.ts diff --git a/apps/web/src/lib/wrapped.ts b/apps/web/src/lib/wrapped.ts new file mode 100644 index 0000000..8611896 --- /dev/null +++ b/apps/web/src/lib/wrapped.ts @@ -0,0 +1,52 @@ +import type { Project, TimelinePoint } from '@/lib/types' + +export const EASE_OUT = [0.22, 1, 0.36, 1] as const +export const EASE_SPRING = [0.34, 1.56, 0.64, 1] as const +export const EASE_SETTLE = [0.16, 1, 0.3, 1] as const + +export type LensKind = 'tier' | 'agent' | 'tool' | 'integration' | 'language' + +export interface Lens { + kind: LensKind + value: string +} + +const KINDS: readonly LensKind[] = ['tier', 'agent', 'tool', 'integration', 'language'] + +const matchers: Record boolean> = { + tier: (project, value) => project.tier === value, + agent: (project, value) => project.agents.includes(value), + tool: (project, value) => project.tools.includes(value), + integration: (project, value) => project.integrations.includes(value), + language: (project, value) => project.language === value, +} + +export function parseLens(raw: string | null): Lens | null { + const [kind, ...rest] = (raw ?? '').split(':') + const value = rest.join(':') + return KINDS.includes(kind as LensKind) && value ? { kind: kind as LensKind, value } : null +} + +export function formatLens(lens: Lens) { + return `${lens.kind}:${lens.value}` +} + +export function isSameLens(first: Lens | null, second: Lens) { + return first?.kind === second.kind && first.value === second.value +} + +export function matchesLens(project: Project, lens: Lens) { + return matchers[lens.kind](project, lens.value) +} + +export function percent(value: number, total: number) { + return Math.round((value / total) * 100) +} + +const RUSH_HOURS = 2 + +export function timelineHighlights(timeline: TimelinePoint[]) { + const peak = timeline.reduce((best, point) => (point.contracts > best.contracts ? point : best)) + const rush = timeline.slice(-RUSH_HOURS) + return { peak, rush, rushTotal: rush.reduce((sum, point) => sum + point.contracts, 0) } +} From 911af39eaa6ffd2a2249ec79006a304b84366ff9 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 08:23:43 +0100 Subject: [PATCH 12/54] refactor: move the still context into its own file --- apps/web/src/components/wrapped/stage.tsx | 22 +++++--------------- apps/web/src/components/wrapped/use-still.ts | 7 +++++++ 2 files changed, 12 insertions(+), 17 deletions(-) create mode 100644 apps/web/src/components/wrapped/use-still.ts diff --git a/apps/web/src/components/wrapped/stage.tsx b/apps/web/src/components/wrapped/stage.tsx index e0c2bcd..2e835d4 100644 --- a/apps/web/src/components/wrapped/stage.tsx +++ b/apps/web/src/components/wrapped/stage.tsx @@ -1,21 +1,16 @@ -import { type ReactNode, createContext, useContext, useLayoutEffect, useRef, useState } from 'react' +import { type ReactNode, useLayoutEffect, useState } from 'react' + +import { StillContext } from '@/components/wrapped/use-still' export const STAGE_WIDTH = 1600 export const STAGE_HEIGHT = 900 -const StillContext = createContext(false) - -export function useStill() { - return useContext(StillContext) -} - function fitScale() { return Math.min(window.innerWidth / STAGE_WIDTH, window.innerHeight / STAGE_HEIGHT) } export function Stage({ still, children }: { still: boolean; children: ReactNode }) { const [scale, setScale] = useState(fitScale) - const frame = useRef(null) useLayoutEffect(() => { const resize = () => setScale(fitScale()) @@ -25,17 +20,10 @@ export function Stage({ still, children }: { still: boolean; children: ReactNode return ( -
+
{children}
diff --git a/apps/web/src/components/wrapped/use-still.ts b/apps/web/src/components/wrapped/use-still.ts new file mode 100644 index 0000000..bb1758c --- /dev/null +++ b/apps/web/src/components/wrapped/use-still.ts @@ -0,0 +1,7 @@ +import { createContext, useContext } from 'react' + +export const StillContext = createContext(false) + +export function useStill() { + return useContext(StillContext) +} From df0da880023f4314d47e9bbcbdd03bf6b68a8e7e Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 08:23:43 +0100 Subject: [PATCH 13/54] feat: add the wrapped tile and animated figure --- apps/web/src/components/wrapped/figure.tsx | 26 ++++++++++++++ apps/web/src/components/wrapped/tile.tsx | 40 ++++++++++++++++++++++ 2 files changed, 66 insertions(+) create mode 100644 apps/web/src/components/wrapped/figure.tsx create mode 100644 apps/web/src/components/wrapped/tile.tsx diff --git a/apps/web/src/components/wrapped/figure.tsx b/apps/web/src/components/wrapped/figure.tsx new file mode 100644 index 0000000..c625718 --- /dev/null +++ b/apps/web/src/components/wrapped/figure.tsx @@ -0,0 +1,26 @@ +import { animate, motion, useMotionValue, useTransform } from 'motion/react' +import { useEffect } from 'react' + +import { useStill } from '@/components/wrapped/use-still' +import { formatNumber } from '@/lib/format' +import { EASE_SETTLE } from '@/lib/wrapped' + +interface FigureProps { + value: number + delay?: number + className?: string +} + +export function Figure({ value, delay = 0, className }: FigureProps) { + const still = useStill() + const count = useMotionValue(still ? value : 0) + const text = useTransform(count, (latest) => formatNumber(Math.round(latest))) + + useEffect(() => { + if (still) return + const controls = animate(count, value, { duration: 1.6, delay, ease: EASE_SETTLE }) + return controls.stop + }, [count, value, delay, still]) + + return {text} +} diff --git a/apps/web/src/components/wrapped/tile.tsx b/apps/web/src/components/wrapped/tile.tsx new file mode 100644 index 0000000..32a824d --- /dev/null +++ b/apps/web/src/components/wrapped/tile.tsx @@ -0,0 +1,40 @@ +import { motion } from 'motion/react' +import type { ReactNode } from 'react' + +import { useStill } from '@/components/wrapped/use-still' +import { cn } from '@/lib/utils' +import { EASE_OUT } from '@/lib/wrapped' + +interface TileProps { + title: string + note?: ReactNode + delay?: number + grow?: number + className?: string + children: ReactNode +} + +export function Tile({ title, note, delay = 0, grow, className, children }: TileProps) { + const still = useStill() + + return ( + +
+

+ {title} +

+ {note && {note}} +
+ {children} +
+ ) +} From 82d27502070ca33f012283c94e4a152d41ef6828 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 08:23:43 +0100 Subject: [PATCH 14/54] feat: add a hoverable project waffle --- apps/web/src/components/wrapped/waffle.tsx | 73 ++++++++++++++++++++++ 1 file changed, 73 insertions(+) create mode 100644 apps/web/src/components/wrapped/waffle.tsx diff --git a/apps/web/src/components/wrapped/waffle.tsx b/apps/web/src/components/wrapped/waffle.tsx new file mode 100644 index 0000000..122b10a --- /dev/null +++ b/apps/web/src/components/wrapped/waffle.tsx @@ -0,0 +1,73 @@ +import { motion } from 'motion/react' + +import { Avatar, AvatarFallback, AvatarImage } from '@/components/ui/avatar' +import { Tooltip, TooltipContent, TooltipTrigger } from '@/components/ui/tooltip' +import { useStill } from '@/components/wrapped/use-still' +import { projectName, tierLabel } from '@/lib/format' +import { EASE_SPRING, matchesLens, type Lens } from '@/lib/wrapped' +import type { Project } from '@/lib/types' +import { cn } from '@/lib/utils' + +interface WaffleProps { + projects: Project[] + lens: Lens | null + columns: number + delay?: number +} + +export function Waffle({ projects, lens, columns, delay = 0 }: WaffleProps) { + const still = useStill() + + return ( +
+ {projects.map((project, index) => { + const name = projectName(project.project_id) + const dimmed = lens !== null && !matchesLens(project, lens) + + return ( + + + } + > + + + + + {project.owner_avatar && } + {name.slice(0, 2).toUpperCase()} + + {name} + + {tierLabel[project.tier]} + {project.language && ` · ${project.language}`} + + + + ) + })} +
+ ) +} From 68da38e5332446f653b6062dd02d570d1eb721b2 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 08:23:43 +0100 Subject: [PATCH 15/54] feat: add the lens list and segmented bar --- apps/web/src/components/wrapped/lens-list.tsx | 74 +++++++++++++++++++ .../src/components/wrapped/segmented-bar.tsx | 56 ++++++++++++++ 2 files changed, 130 insertions(+) create mode 100644 apps/web/src/components/wrapped/lens-list.tsx create mode 100644 apps/web/src/components/wrapped/segmented-bar.tsx diff --git a/apps/web/src/components/wrapped/lens-list.tsx b/apps/web/src/components/wrapped/lens-list.tsx new file mode 100644 index 0000000..a5c1168 --- /dev/null +++ b/apps/web/src/components/wrapped/lens-list.tsx @@ -0,0 +1,74 @@ +import { motion } from 'motion/react' + +import { useStill } from '@/components/wrapped/use-still' +import { formatNumber } from '@/lib/format' +import { EASE_OUT, isSameLens, percent, type Lens } from '@/lib/wrapped' +import { cn } from '@/lib/utils' + +export interface LensRow { + label: string + value: number + lens: Lens +} + +interface LensListProps { + rows: LensRow[] + total: number + active: Lens | null + onSelect: (lens: Lens) => void + delay?: number +} + +export function LensList({ rows, total, active, onSelect, delay = 0 }: LensListProps) { + const still = useStill() + + return ( +
    + {rows.map((row, index) => { + const selected = isSameLens(active, row.lens) + + return ( +
  • + +
  • + ) + })} +
+ ) +} diff --git a/apps/web/src/components/wrapped/segmented-bar.tsx b/apps/web/src/components/wrapped/segmented-bar.tsx new file mode 100644 index 0000000..b4e87d2 --- /dev/null +++ b/apps/web/src/components/wrapped/segmented-bar.tsx @@ -0,0 +1,56 @@ +import { motion } from 'motion/react' + +import { useStill } from '@/components/wrapped/use-still' +import { EASE_OUT, isSameLens, percent, type Lens } from '@/lib/wrapped' +import type { Count } from '@/lib/types' +import { cn } from '@/lib/utils' + +const SEGMENTS = ['bg-primary', 'bg-secondary', 'bg-chart-2', 'bg-chart-4', 'bg-muted-foreground'] + +interface SegmentedBarProps { + data: Count[] + active: Lens | null + onSelect: (lens: Lens) => void + delay?: number +} + +export function SegmentedBar({ data, active, onSelect, delay = 0 }: SegmentedBarProps) { + const still = useStill() + const total = data.reduce((sum, item) => sum + item.value, 0) + const lensOf = (label: string): Lens => ({ kind: 'language', value: label }) + + return ( +
+
+ {data.map((item, index) => ( + onSelect(lensOf(item.label))} + aria-label={item.label} + initial={still ? false : { scaleX: 0 }} + animate={{ scaleX: 1 }} + transition={{ delay: delay + index * 0.12, duration: 0.9, ease: EASE_OUT }} + style={{ width: `${percent(item.value, total)}%`, originX: 0 }} + className={cn( + 'rounded-sm transition-opacity hover:opacity-80', + SEGMENTS[index], + active?.kind === 'language' && + !isSameLens(active, lensOf(item.label)) && + 'opacity-30', + )} + /> + ))} +
+
    + {data.map((item, index) => ( +
  • + + {item.label} + {percent(item.value, total)}% +
  • + ))} +
+
+ ) +} From a4918f68b17ce88f2373ff4baea5b325cca49d9a Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 08:23:43 +0100 Subject: [PATCH 16/54] feat: add the wrapped charts --- .../src/components/wrapped/ranked-bars.tsx | 52 ++++++++++++ apps/web/src/components/wrapped/team-bars.tsx | 32 ++++++++ .../src/components/wrapped/timeline-chart.tsx | 79 +++++++++++++++++++ 3 files changed, 163 insertions(+) create mode 100644 apps/web/src/components/wrapped/ranked-bars.tsx create mode 100644 apps/web/src/components/wrapped/team-bars.tsx create mode 100644 apps/web/src/components/wrapped/timeline-chart.tsx diff --git a/apps/web/src/components/wrapped/ranked-bars.tsx b/apps/web/src/components/wrapped/ranked-bars.tsx new file mode 100644 index 0000000..f978a4e --- /dev/null +++ b/apps/web/src/components/wrapped/ranked-bars.tsx @@ -0,0 +1,52 @@ +import { Bar, BarChart, Cell, LabelList, XAxis, YAxis } from 'recharts' + +import { type ChartConfig, ChartContainer } from '@/components/ui/chart' +import { useStill } from '@/components/wrapped/use-still' +import { formatNumber } from '@/lib/format' +import type { Count } from '@/lib/types' +import { cn } from '@/lib/utils' + +const config = { value: { label: 'Count', color: 'var(--primary)' } } satisfies ChartConfig + +const LABEL_WIDTH = 112 + +export function RankedBars({ data, className }: { data: Count[]; className?: string }) { + const still = useStill() + + return ( + + + + + + {data.map((row, index) => ( + + ))} + formatNumber(Number(value))} + /> + + + + ) +} diff --git a/apps/web/src/components/wrapped/team-bars.tsx b/apps/web/src/components/wrapped/team-bars.tsx new file mode 100644 index 0000000..c9150fc --- /dev/null +++ b/apps/web/src/components/wrapped/team-bars.tsx @@ -0,0 +1,32 @@ +import { Bar, BarChart, Cell, LabelList, XAxis } from 'recharts' + +import { type ChartConfig, ChartContainer } from '@/components/ui/chart' +import { useStill } from '@/components/wrapped/use-still' +import type { Count } from '@/lib/types' +import { cn } from '@/lib/utils' + +const config = { value: { label: 'Projects', color: 'var(--primary)' } } satisfies ChartConfig + +export function TeamBars({ data, className }: { data: Count[]; className?: string }) { + const still = useStill() + + return ( + + + + + {data.map((row, index) => ( + + ))} + + + + + ) +} diff --git a/apps/web/src/components/wrapped/timeline-chart.tsx b/apps/web/src/components/wrapped/timeline-chart.tsx new file mode 100644 index 0000000..b3c6c2c --- /dev/null +++ b/apps/web/src/components/wrapped/timeline-chart.tsx @@ -0,0 +1,79 @@ +import { Area, AreaChart, CartesianGrid, ReferenceArea, ReferenceDot, XAxis, YAxis } from 'recharts' + +import { type ChartConfig, ChartContainer } from '@/components/ui/chart' +import { useStill } from '@/components/wrapped/use-still' +import { formatHour } from '@/lib/format' +import type { TimelinePoint } from '@/lib/types' +import { cn } from '@/lib/utils' + +const day = new Intl.DateTimeFormat('en', { month: 'short', day: 'numeric', timeZone: 'UTC' }) + +function tickLabel(iso: string) { + const hour = formatHour(iso) + return hour === '00:00' ? day.format(new Date(iso)) : hour +} + +const config = { + contracts: { label: 'Contracts deployed', color: 'var(--primary)' }, +} satisfies ChartConfig + +interface TimelineChartProps { + data: TimelinePoint[] + peak: TimelinePoint + rush: TimelinePoint[] + className?: string +} + +export function TimelineChart({ data, peak, rush, className }: TimelineChartProps) { + const still = useStill() + + return ( + + + + + + + + + + + + + + + + + ) +} From 94c570db4be2c87105c2e4efeb0079d7cd83e519 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 08:23:43 +0100 Subject: [PATCH 17/54] feat: add builder avatars --- .../components/wrapped/builder-avatars.tsx | 57 +++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 apps/web/src/components/wrapped/builder-avatars.tsx diff --git a/apps/web/src/components/wrapped/builder-avatars.tsx b/apps/web/src/components/wrapped/builder-avatars.tsx new file mode 100644 index 0000000..3a869af --- /dev/null +++ b/apps/web/src/components/wrapped/builder-avatars.tsx @@ -0,0 +1,57 @@ +import { motion } from 'motion/react' + +import { Avatar, AvatarFallback, AvatarImage } from '@/components/ui/avatar' +import { Tooltip, TooltipContent, TooltipTrigger } from '@/components/ui/tooltip' +import { useStill } from '@/components/wrapped/use-still' +import { formatNumber } from '@/lib/format' +import type { WrappedBuilder } from '@/lib/types' +import { EASE_SPRING } from '@/lib/wrapped' + +interface BuilderAvatarsProps { + builders: WrappedBuilder[] + size?: 'default' | 'sm' | 'lg' + delay?: number +} + +export function BuilderAvatars({ builders, size = 'default', delay = 0 }: BuilderAvatarsProps) { + const still = useStill() + + return ( +
    + {builders.map((builder, index) => ( + + + + } + > + + {builder.avatar_url && } + {builder.login.slice(0, 2).toUpperCase()} + + + + {builder.login} + + {formatNumber(builder.contributions)} commits · {builder.projects}{' '} + {builder.projects === 1 ? 'project' : 'projects'} + + + + + ))} +
+ ) +} From 4f57b20acb0f4797b803ec115c2f10cb00d6c2d7 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 08:23:43 +0100 Subject: [PATCH 18/54] feat: add the wrapped page --- apps/web/src/app.tsx | 15 +- apps/web/src/lib/format.ts | 5 + apps/web/src/pages/wrapped.tsx | 428 +++++++++++++++++++++++++++++++++ 3 files changed, 445 insertions(+), 3 deletions(-) create mode 100644 apps/web/src/pages/wrapped.tsx diff --git a/apps/web/src/app.tsx b/apps/web/src/app.tsx index 7971383..7dca7d8 100644 --- a/apps/web/src/app.tsx +++ b/apps/web/src/app.tsx @@ -9,6 +9,7 @@ import { SiteHeader } from '@/components/layout/site-header' import { BuilderPage } from '@/pages/builder' import { HomePage } from '@/pages/home' import { ProjectPage } from '@/pages/project' +import { WrappedPage } from '@/pages/wrapped' function Shell() { const { view } = useChatPanel() @@ -37,8 +38,16 @@ function Shell() { export function App() { return ( - - - + + } /> + + + + } + /> + ) } diff --git a/apps/web/src/lib/format.ts b/apps/web/src/lib/format.ts index d2bc0e1..e51e744 100644 --- a/apps/web/src/lib/format.ts +++ b/apps/web/src/lib/format.ts @@ -84,3 +84,8 @@ export const footprintLabel = { export function formatLastActivity(iso: string | null) { return iso ? formatDateTime(iso) : 'none' } + +export function humanize(slug: string) { + const text = slug.replaceAll('_', ' ') + return text.charAt(0).toUpperCase() + text.slice(1) +} diff --git a/apps/web/src/pages/wrapped.tsx b/apps/web/src/pages/wrapped.tsx new file mode 100644 index 0000000..85cee36 --- /dev/null +++ b/apps/web/src/pages/wrapped.tsx @@ -0,0 +1,428 @@ +import { motion } from 'motion/react' +import { useSearchParams } from 'react-router' + +import { BuilderAvatars } from '@/components/wrapped/builder-avatars' +import { Figure } from '@/components/wrapped/figure' +import { LensList, type LensRow } from '@/components/wrapped/lens-list' +import { RankedBars } from '@/components/wrapped/ranked-bars' +import { SegmentedBar } from '@/components/wrapped/segmented-bar' +import { Stage } from '@/components/wrapped/stage' +import { TeamBars } from '@/components/wrapped/team-bars' +import { Tile } from '@/components/wrapped/tile' +import { TimelineChart } from '@/components/wrapped/timeline-chart' +import { useStill } from '@/components/wrapped/use-still' +import { Waffle } from '@/components/wrapped/waffle' +import { useHackWindow } from '@/hooks/use-hack-window' +import { useAgents, useIntegrations, useProjects, useTools } from '@/hooks/use-projects' +import { useStats } from '@/hooks/use-stats' +import { useTimeline } from '@/hooks/use-timeline' +import { useWrapped } from '@/hooks/use-wrapped' +import { formatHour, formatNumber, humanize, tierLabel } from '@/lib/format' +import type { + AiAgent, + EcosystemTool, + HackWindow, + Integration, + Project, + Stats, + TimelinePoint, + Wrapped, +} from '@/lib/types' +import { + EASE_OUT, + formatLens, + isSameLens, + matchesLens, + parseLens, + timelineHighlights, + type Lens, +} from '@/lib/wrapped' + +const WAFFLE_COLUMNS = 15 +const LANGUAGES_SHOWN = 4 +const AGENT_ROWS = 6 +const INTEGRATION_ROWS = 5 +const SOLO_TEAM = '1' +const LARGEST_TEAM = '5' +const TOP_BUILDERS = 5 +const MULTI_TEAM_BUILDERS = 8 + +interface PosterData { + wrapped: Wrapped + stats: Stats + timeline: TimelinePoint[] + projects: Project[] + integrations: Integration[] + tools: EcosystemTool[] + agents: AiAgent[] + window: HackWindow +} + +interface SectionProps { + data: PosterData + lens: Lens | null + onSelect: (lens: Lens) => void +} + +const day = new Intl.DateTimeFormat('en', { month: 'short', day: 'numeric', timeZone: 'UTC' }) + +function windowLabel({ start, end }: HackWindow) { + const hours = Math.round((new Date(end).getTime() - new Date(start).getTime()) / 3_600_000) + return `${day.format(new Date(start))} to ${day.format(new Date(end))} · ${hours} hours · Stellar testnet` +} + +function ranked( + items: T[], + kind: Lens['kind'], + limit: number, +): LensRow[] { + return items + .filter((item) => item.projects > 0) + .sort((a, b) => b.projects - a.projects || a.name.localeCompare(b.name)) + .slice(0, limit) + .map((item) => ({ label: item.name, value: item.projects, lens: { kind, value: item.slug } })) +} + +function Backdrop() { + return ( +
+
+
+
+
+ ) +} + +function Header({ window }: { window: HackWindow }) { + const still = useStill() + + return ( + +

+ HackMeridian 2026 Wrapped +

+

{windowLabel(window)}

+
+ ) +} + +function languageCounts(projects: Project[]) { + const counts = new Map() + projects.forEach((project) => { + const language = project.language ?? 'Other' + counts.set(language, (counts.get(language) ?? 0) + 1) + }) + const sorted = [...counts].sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0])) + const rest = sorted.slice(LANGUAGES_SHOWN).reduce((sum, [, value]) => sum + value, 0) + return [ + ...sorted.slice(0, LANGUAGES_SHOWN).map(([label, value]) => ({ label, value })), + ...(rest ? [{ label: 'Other', value: rest }] : []), + ] +} + +function lensSummary(lens: Lens, data: PosterData) { + const matched = data.projects.filter((project) => matchesLens(project, lens)).length + const names: Record = { + tier: tierLabel[lens.value as keyof typeof tierLabel], + agent: data.agents.find((item) => item.slug === lens.value)?.name, + tool: data.tools.find((item) => item.slug === lens.value)?.name, + integration: data.integrations.find((item) => item.slug === lens.value)?.name, + language: lens.value, + } + return { matched, name: names[lens.kind] ?? lens.value } +} + +function Hero({ data, lens, onSelect }: SectionProps) { + const { stats, projects } = data + const commits = projects.reduce((sum, project) => sum + (project.window_commits ?? 0), 0) + const summary = lens && lensSummary(lens, data) + const tiers: { tier: 'verified' | 'likely'; swatch: string }[] = [ + { tier: 'verified', swatch: 'bg-primary' }, + { tier: 'likely', swatch: 'bg-secondary' }, + ] + + return ( + +
+
+

+ projects +
+ shipped +

+
+
+ +
+ {summary ? ( + + {summary.matched} of {projects.length}{' '} + projects: {summary.name} + + ) : ( + tiers.map(({ tier, swatch }) => ( + + )) + )} +
+
+ +
+
+
+ {[ + ['GitHub builders', data.wrapped.builders], + ['Commits', commits], + ['Countries', stats.countries], + ].map(([label, value], index) => ( +
+
{label}
+
+
+
+
+ ))} +
+
+ ) +} + +function Chain({ data }: { data: PosterData }) { + const { peak, rush, rushTotal } = timelineHighlights(data.timeline) + const figures = [ + ['contracts deployed', data.stats.contracts], + ['deployers', data.wrapped.deployers], + ['accounts funded', data.wrapped.accounts_funded], + ['operations', data.wrapped.operations], + ] + + return ( + +
+ {figures.map(([label, value], index) => ( +
+
+
+
+
{label}
+
+ ))} +
+ + {formatNumber(peak.contracts)} in one hour at{' '} + {formatHour(peak.hour)} UTC + + + {formatNumber(rushTotal)} in the last {rush.length}h + +
+
+ +
+ ) +} + +function Operations({ wrapped }: { wrapped: Wrapped }) { + const rows = wrapped.operations_by_type.map((row) => ({ ...row, label: humanize(row.label) })) + + return ( + + + + ) +} + +function Builders({ wrapped }: { wrapped: Wrapped }) { + const teams = wrapped.team_sizes.map((row) => ({ + ...row, + label: + row.label === SOLO_TEAM ? 'Solo' : row.label === LARGEST_TEAM ? `${row.label}+` : row.label, + })) + const hidden = wrapped.multi_team_builders.length - MULTI_TEAM_BUILDERS + + return ( + + +
+ + {wrapped.multi_team_builders.length} + + shipped with 2+ teams +
+
+ + {hidden > 0 && +{hidden}} +
+

+ Most commits +

+
+ +
+
+ ) +} + +function Agents({ data, lens, onSelect }: SectionProps) { + const rows = ranked(data.agents, 'agent', AGENT_ROWS) + + return ( + + + + ) +} + +function Tooling({ data, lens, onSelect }: SectionProps) { + const rows = ranked(data.tools, 'tool', data.tools.length) + + return ( + + + + ) +} + +function BuiltWith({ data, lens, onSelect }: SectionProps) { + const rows = ranked(data.integrations, 'integration', INTEGRATION_ROWS) + + return ( + + + + ) +} + +function Footer() { + return ( +

+ + Rebuilt from the Stellar testnet and GitHub. Every project links to its on chain evidence. + + hackproof-six.vercel.app +

+ ) +} + +function usePosterData(): PosterData | undefined { + const { data: wrapped } = useWrapped() + const { data: stats } = useStats() + const { data: timeline } = useTimeline() + const { data: projects } = useProjects() + const { data: integrations } = useIntegrations() + const { data: tools } = useTools() + const { data: agents } = useAgents() + const { data: window } = useHackWindow() + + if ( + !wrapped || + !stats || + !timeline || + !projects || + !integrations || + !tools || + !agents || + !window + ) { + return undefined + } + return { wrapped, stats, timeline, projects, integrations, tools, agents, window } +} + +export function WrappedPage() { + const [params, setParams] = useSearchParams() + const data = usePosterData() + const lens = parseLens(params.get('lens')) + + const select = (next: Lens) => { + const updated = new URLSearchParams(params) + if (isSameLens(lens, next)) updated.delete('lens') + else updated.set('lens', formatLens(next)) + setParams(updated, { replace: true }) + } + + return ( + + + {data ? ( +
+
+
+ +
+ +
+ + +
+
+
+ + + +
+
+
+
+ ) : ( +
+ Counting… +
+ )} +
+ ) +} From 011f303303d3c2e7225e37ea1ce9108cf2184184 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 08:53:54 +0100 Subject: [PATCH 19/54] feat: export the ai agents each project uses --- apps/api/src/hackproof/export/build.py | 29 +++++++++++++++++++++++++ apps/api/src/hackproof/export/files.py | 29 +++++++++++++++++++++++++ apps/api/src/hackproof/export/models.py | 23 ++++++++++++++++++++ 3 files changed, 81 insertions(+) diff --git a/apps/api/src/hackproof/export/build.py b/apps/api/src/hackproof/export/build.py index d98a570..2e79c49 100644 --- a/apps/api/src/hackproof/export/build.py +++ b/apps/api/src/hackproof/export/build.py @@ -6,6 +6,8 @@ from hackproof.export.models import ( Account, + AgentEvidence, + AiAgent, Chain, Contract, Contributor, @@ -98,6 +100,14 @@ """ +AGENTS_SQL = """ +SELECT full_name, agent, method, evidence, path +FROM repo_agents +WHERE full_name = ANY($1) +ORDER BY agent, method, evidence +""" + + def _evidence_url(kind: str, subject: str) -> str | None: match kind: case "contract": @@ -132,6 +142,23 @@ def _found( return found +def _agents(catalog: Catalog, rows: list[asyncpg.Record], repo_url: str) -> list[AiAgent]: + found: dict[str, list[AgentEvidence]] = defaultdict(list) + for row in rows: + found[row["agent"]].append( + AgentEvidence( + method=row["method"], + detail=row["evidence"], + repo_file_url=repo_file_url(repo_url, row["path"]) if row["path"] else None, + ) + ) + return [ + AiAgent(slug=agent.slug, name=agent.name, website=agent.site, evidence=found[agent.slug]) + for agent in catalog.agents + if agent.slug in found + ] + + def _tools(catalog: Catalog, rows: list[asyncpg.Record], repo_url: str) -> list[EcosystemTool]: found = _found(rows, "tool", repo_url) return [ @@ -173,6 +200,7 @@ async def build_export( evidence = _group(await connection.fetch(EVIDENCE_SQL, names)) integrations = _group(await connection.fetch(INTEGRATIONS_SQL, names)) tools = _group(await connection.fetch(TOOLS_SQL, names)) + agents = _group(await connection.fetch(AGENTS_SQL, names)) catalog = get_catalog() awards = {award.project_id: award.place for award in hackathon.awards} @@ -200,6 +228,7 @@ async def build_export( track_declared=row["declared_track"] is not None, integration_partners=_partners(catalog, integrations[row["full_name"]], row["url"]), ecosystem_tools=_tools(catalog, tools[row["full_name"]], row["url"]), + ai_agents=_agents(catalog, agents[row["full_name"]], row["url"]), owner=Owner(login=row["owner"], avatar_url=row["owner_avatar"], country=row["country"]), contributors=[ Contributor( diff --git a/apps/api/src/hackproof/export/files.py b/apps/api/src/hackproof/export/files.py index fb1f2d7..7801da9 100644 --- a/apps/api/src/hackproof/export/files.py +++ b/apps/api/src/hackproof/export/files.py @@ -54,6 +54,18 @@ class FileIntegration(FileModel): evidence: list[FileIntegrationEvidence] +class FileAgentEvidence(FileModel): + method: Literal["file", "author"] + detail: str + file_url: str | None = None + + +class FileAgent(FileModel): + slug: str + name: str + evidence: list[FileAgentEvidence] + + class FileContributor(FileModel): login: str contributions: int @@ -96,6 +108,10 @@ class ProjectFile(FileModel): tools: list[FileIntegration] = Field( default_factory=list, description="Stellar developer tools the repo builds with" ) + agents: list[FileAgent] = Field( + default_factory=list, + description="AI coding agents the repo shows traces of, in config files or commits", + ) chain: FileChain contributors: list[FileContributor] @@ -193,6 +209,19 @@ def project_file(event: str, project: Project) -> ProjectFile: ) for tool in project.ecosystem_tools ], + agents=[ + FileAgent( + slug=agent.slug, + name=agent.name, + evidence=[ + FileAgentEvidence( + method=item.method, detail=item.detail, file_url=item.repo_file_url + ) + for item in agent.evidence + ], + ) + for agent in project.ai_agents + ], chain=FileChain( contracts=chain.contract_count, wasm_uploads=chain.wasm_upload_count, diff --git a/apps/api/src/hackproof/export/models.py b/apps/api/src/hackproof/export/models.py index 92d6ce6..06abc99 100644 --- a/apps/api/src/hackproof/export/models.py +++ b/apps/api/src/hackproof/export/models.py @@ -101,6 +101,26 @@ class IntegrationEvidence(Model): repo_file_url: str = Field(description="GitHub file where it was found") +class AgentEvidence(Model): + method: Literal["file", "author"] = Field( + description=( + "How the agent was found. file: one of its config files is in the repo. author: it " + "appears as a commit author. Using a tool that leaves no trace is not counted." + ) + ) + detail: str = Field(description="The matched file pattern or commit author login") + repo_file_url: str | None = Field( + description="GitHub file where it was found; null for a commit author" + ) + + +class AiAgent(Model): + slug: str = Field(description="Stable agent id, listed in data/integrations.yaml") + name: str = Field(description="Agent name") + website: str = Field(description="Agent website") + evidence: list[AgentEvidence] = Field(description="Where the agent was found") + + class EcosystemTool(Model): slug: str = Field(description="Stable tool id, listed in data/integrations.yaml") name: str = Field(description="Tool name") @@ -162,6 +182,9 @@ class Project(Model): ecosystem_tools: list[EcosystemTool] = Field( description="Stellar developer tools the repo builds with, such as Scaffold Stellar" ) + ai_agents: list[AiAgent] = Field( + description="AI coding agents the repo shows traces of, such as Claude Code or Cursor" + ) owner: Owner contributors: list[Contributor] chain: Chain From 2f8a0b0a26ce64c0004e493f67c37c8abf7082d2 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 08:53:55 +0100 Subject: [PATCH 20/54] feat: add ai agents and the new stellar tools to the project files --- data/2026/402scope-trust.yml | 6 +++ data/2026/4ward.yml | 7 +++ data/2026/acta-gate-meridian.yml | 7 +++ data/2026/agent-wallet-sdk.yml | 17 +++++++ data/2026/agentspacialeconomy.yml | 33 +++++++++++++ data/2026/alloy-stellar.yml | 7 +++ data/2026/ancora.yml | 7 +++ data/2026/arqueo.yml | 22 +++++++++ data/2026/artifex-contracts.yml | 7 +++ data/2026/arturshirokov-hackmeridian.yml | 14 ++++++ data/2026/astros.yml | 40 +++++++++++++++ data/2026/atahanyild-koul.yml | 13 +++++ data/2026/bind.yml | 7 +++ data/2026/blnt-v3-migration.yml | 7 +++ data/2026/breakwater.yml | 17 +++++++ data/2026/caravel.yml | 15 ++++++ data/2026/card-place-stellar.yml | 7 +++ data/2026/cdp-clear.yml | 13 +++++ data/2026/chama.yml | 7 +++ data/2026/cherrypay-wallet.yml | 7 +++ data/2026/cityofzion-hackmeridian.yml | 16 ++++++ data/2026/citypass.yml | 7 +++ data/2026/clippay.yml | 7 +++ data/2026/cmi-hackthon-meridian.yml | 16 ++++++ data/2026/cuotia.yml | 13 +++++ data/2026/devfest-harambeeone.yml | 7 +++ data/2026/diversify.yml | 18 +++++++ data/2026/drainmywallet.yml | 7 +++ data/2026/dvdnd.yml | 7 +++ data/2026/enza.yml | 7 +++ data/2026/enza3-mvmnt1.yml | 7 +++ data/2026/explorador-agent-loan-stellar.yml | 13 +++++ data/2026/fermento.yml | 7 +++ data/2026/fiavel-hack-lisbon.yml | 12 +++++ data/2026/flowpay.yml | 7 +++ data/2026/forepay.yml | 13 +++++ data/2026/gamelock.yml | 13 +++++ data/2026/ghost-proof.yml | 7 +++ data/2026/greenledger.yml | 6 +++ data/2026/hack-meridian-2026.yml | 38 ++++++++++++++ data/2026/hackathons-landing.yml | 7 +++ data/2026/hackmeridian-stellar-hackathon.yml | 22 +++++++++ data/2026/hackmeridian2026.yml | 16 ++++++ data/2026/human-bond.yml | 13 +++++ data/2026/indexify-mvp.yml | 7 +++ data/2026/kado-hackmeridian.yml | 29 +++++++++++ data/2026/keystone.yml | 7 +++ data/2026/kotizi-stellar-meridian.yml | 7 +++ data/2026/koul-me-koul.yml | 13 +++++ data/2026/kovan.yml | 40 +++++++++++++++ data/2026/latch.yml | 7 +++ data/2026/lendara-shield.yml | 13 +++++ data/2026/loot.yml | 7 +++ data/2026/lotus-stellar.yml | 13 +++++ data/2026/merit.yml | 15 ++++++ data/2026/microvault.yml | 7 +++ data/2026/middlemate.yml | 13 +++++ data/2026/mohamedkhellaf-hackmeridian.yml | 20 ++++++++ data/2026/monolith.yml | 15 ++++++ data/2026/nata-stellar.yml | 7 +++ data/2026/nema.yml | 7 +++ data/2026/nest.yml | 20 ++++++++ data/2026/nicolecarolina-hackmeridian.yml | 7 +++ data/2026/nilo.yml | 6 +++ data/2026/nirium-watch.yml | 7 +++ data/2026/orloj-stellar.yml | 13 +++++ data/2026/oz-policy-builder.yml | 7 +++ data/2026/peaje-zbe.yml | 7 +++ data/2026/pelamandarinas-project.yml | 7 +++ data/2026/phonedo.yml | 7 +++ data/2026/plan4her-stellar.yml | 6 +++ data/2026/pledge.yml | 16 ++++++ data/2026/polai-frontend.yml | 7 +++ data/2026/poolfi-build-1.yml | 7 +++ data/2026/portus.yml | 7 +++ data/2026/presign-guard.yml | 7 +++ data/2026/private-yield.yml | 13 +++++ data/2026/qafila.yml | 10 ++++ data/2026/redevice.yml | 6 +++ data/2026/sansara.yml | 6 +++ data/2026/scaffold-stellar-agentic.yml | 40 +++++++++++++++ data/2026/secretspay-stellar-daap.yml | 6 +++ data/2026/sendabussines.yml | 7 +++ data/2026/seyf-p.yml | 23 +++++++++ data/2026/shake.yml | 9 ++++ data/2026/slasettle-vault.yml | 7 +++ data/2026/soroprove.yml | 7 +++ data/2026/starpocket.yml | 7 +++ data/2026/stellar-confidential-token-demo.yml | 7 +++ data/2026/stellar-forge.yml | 6 +++ data/2026/stellar-p30-check.yml | 18 +++++++ data/2026/stellar-quickpass.yml | 12 +++++ data/2026/stellar-rtgs.yml | 13 +++++ data/2026/stellar-split.yml | 19 +++++++ data/2026/stellar2bitcoin.yml | 13 +++++ data/2026/toolport.yml | 7 +++ data/2026/trust-meridian.yml | 6 +++ data/2026/turbolong.yml | 7 +++ data/2026/usagepay.yml | 17 +++++++ data/2026/writz.yml | 19 +++++++ data/2026/yield-bearing-rental-deposit.yml | 7 +++ data/2026/zkross.yml | 7 +++ data/schema-hackathon-project.yml | 49 +++++++++++++++++++ 103 files changed, 1252 insertions(+) diff --git a/data/2026/402scope-trust.yml b/data/2026/402scope-trust.yml index 8a63cb4..3769c8a 100644 --- a/data/2026/402scope-trust.yml +++ b/data/2026/402scope-trust.yml @@ -16,6 +16,12 @@ stack: stellar-sdk: '13.1' stellar-strkey: 0.0.16 '@stellar/stellar-sdk': ^16.3.1 +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: author + detail: claude chain: contracts: 0 wasm_uploads: 8 diff --git a/data/2026/4ward.yml b/data/2026/4ward.yml index a61bad7..2d1ca16 100644 --- a/data/2026/4ward.yml +++ b/data/2026/4ward.yml @@ -24,6 +24,13 @@ integrations: - method: package detail: '@creit.tech/stellar-wallets-kit' file_url: https://github.com/ygk94/4ward/blob/HEAD/front/package.json +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/ygk94/4ward/blob/HEAD/AGENTS.md chain: contracts: 18 wasm_uploads: 10 diff --git a/data/2026/acta-gate-meridian.yml b/data/2026/acta-gate-meridian.yml index 001c6a3..ecc5c5f 100644 --- a/data/2026/acta-gate-meridian.yml +++ b/data/2026/acta-gate-meridian.yml @@ -15,6 +15,13 @@ commits_in_window: 44 stack: soroban-sdk: 23.4.0 '@stellar/stellar-sdk': ^16.3.1 +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/ACTA-Team/acta-gate-meridian/blob/HEAD/apps/web/AGENTS.md chain: contracts: 22 wasm_uploads: 9 diff --git a/data/2026/agent-wallet-sdk.yml b/data/2026/agent-wallet-sdk.yml index 5b5b6e0..ad09cdb 100644 --- a/data/2026/agent-wallet-sdk.yml +++ b/data/2026/agent-wallet-sdk.yml @@ -22,6 +22,23 @@ evidence_tier: likely commits_in_window: 31 stack: '@stellar/stellar-sdk': '>=14.0.0' +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: author + detail: claude +- slug: cursor + name: Cursor + evidence: + - method: author + detail: cursoragent +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/up2itnow0822/agent-wallet-sdk/blob/HEAD/.github/AGENTS.md chain: contracts: 0 wasm_uploads: 0 diff --git a/data/2026/agentspacialeconomy.yml b/data/2026/agentspacialeconomy.yml index 2ed8e79..889ddc7 100644 --- a/data/2026/agentspacialeconomy.yml +++ b/data/2026/agentspacialeconomy.yml @@ -13,6 +13,39 @@ commits_in_window: 88 stack: soroban-sdk: =25.3.1 '@stellar/stellar-sdk': latest +tools: +- slug: stellar-raven + name: Stellar Raven + evidence: + - method: endpoint + detail: raven.stellar.org + file_url: https://github.com/CaBsCrypto/AgentSpacialEconomy/blob/HEAD/.mcp.json +- slug: stellar-skills + name: Stellar Skills + evidence: + - method: endpoint + detail: stellar/stellar-dev-skill + file_url: https://github.com/CaBsCrypto/AgentSpacialEconomy/blob/HEAD/agent/services.mjs +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: author + detail: claude + - method: file + detail: CLAUDE.md + file_url: https://github.com/CaBsCrypto/AgentSpacialEconomy/blob/HEAD/CLAUDE.md +- slug: codex + name: OpenAI Codex + evidence: + - method: author + detail: codex +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/CaBsCrypto/AgentSpacialEconomy/blob/HEAD/AGENTS.md chain: contracts: 5 wasm_uploads: 1 diff --git a/data/2026/alloy-stellar.yml b/data/2026/alloy-stellar.yml index 0f65aa3..7f75d8c 100644 --- a/data/2026/alloy-stellar.yml +++ b/data/2026/alloy-stellar.yml @@ -26,6 +26,13 @@ integrations: - method: package detail: '@creit.tech/stellar-wallets-kit' file_url: https://github.com/0xDanomite/alloy-stellar/blob/HEAD/app/package.json +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/0xDanomite/alloy-stellar/blob/HEAD/AGENTS.md chain: contracts: 3 wasm_uploads: 7 diff --git a/data/2026/ancora.yml b/data/2026/ancora.yml index 904807a..3e03b6f 100644 --- a/data/2026/ancora.yml +++ b/data/2026/ancora.yml @@ -24,6 +24,13 @@ integrations: - method: package detail: '@creit.tech/stellar-wallets-kit' file_url: https://github.com/raglibol-re/ancora/blob/HEAD/app/package.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: CLAUDE.md + file_url: https://github.com/raglibol-re/ancora/blob/HEAD/CLAUDE.md chain: contracts: 41 wasm_uploads: 14 diff --git a/data/2026/arqueo.yml b/data/2026/arqueo.yml index 540bfe3..db6f215 100644 --- a/data/2026/arqueo.yml +++ b/data/2026/arqueo.yml @@ -37,6 +37,28 @@ tools: - method: package detail: stellar-registry file_url: https://github.com/Dabuca/arqueo/blob/HEAD/Cargo.toml +- slug: stellar-skills + name: Stellar Skills + evidence: + - method: endpoint + detail: stellar/stellar-dev-skill + file_url: https://github.com/Dabuca/arqueo/blob/HEAD/skills-lock.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: .claude/* + file_url: https://github.com/Dabuca/arqueo/blob/HEAD/.claude/skills + - method: file + detail: CLAUDE.md + file_url: https://github.com/Dabuca/arqueo/blob/HEAD/app/CLAUDE.md +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/Dabuca/arqueo/blob/HEAD/AGENTS.md chain: contracts: 3 wasm_uploads: 2 diff --git a/data/2026/artifex-contracts.yml b/data/2026/artifex-contracts.yml index 79f23e7..4330471 100644 --- a/data/2026/artifex-contracts.yml +++ b/data/2026/artifex-contracts.yml @@ -13,6 +13,13 @@ evidence_tier: verified commits_in_window: 14 stack: soroban-sdk: null +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/0xVeraHQ/artifex-contracts/blob/HEAD/AGENTS.md chain: contracts: 76 wasm_uploads: 10 diff --git a/data/2026/arturshirokov-hackmeridian.yml b/data/2026/arturshirokov-hackmeridian.yml index 88c767e..e5fed93 100644 --- a/data/2026/arturshirokov-hackmeridian.yml +++ b/data/2026/arturshirokov-hackmeridian.yml @@ -19,6 +19,20 @@ integrations: - method: endpoint detail: dev.api.trustlesswork.com file_url: https://github.com/ArturShirokov/hackmeridian/blob/HEAD/src/ledger/trustless-work.ts +tools: +- slug: stellar-raven + name: Stellar Raven + evidence: + - method: endpoint + detail: raven.stellar.org + file_url: https://github.com/ArturShirokov/hackmeridian/blob/HEAD/.mcp.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: CLAUDE.md + file_url: https://github.com/ArturShirokov/hackmeridian/blob/HEAD/CLAUDE.md chain: contracts: 0 wasm_uploads: 0 diff --git a/data/2026/astros.yml b/data/2026/astros.yml index c6703b8..4ea60b5 100644 --- a/data/2026/astros.yml +++ b/data/2026/astros.yml @@ -30,6 +30,46 @@ tools: - method: package detail: '@stellar-scaffold/app-lib' file_url: https://github.com/Eco-RV/AstrOS/blob/HEAD/app/package.json +- slug: stellar-raven + name: Stellar Raven + evidence: + - method: endpoint + detail: raven.stellar.org + file_url: https://github.com/Eco-RV/AstrOS/blob/HEAD/.mcp.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: .claude/* + file_url: https://github.com/Eco-RV/AstrOS/blob/HEAD/.claude/launch.json + - method: file + detail: CLAUDE.md + file_url: https://github.com/Eco-RV/AstrOS/blob/HEAD/CLAUDE.md +- slug: cursor + name: Cursor + evidence: + - method: file + detail: .cursor/* + file_url: https://github.com/Eco-RV/AstrOS/blob/HEAD/.cursor/mcp.json +- slug: codex + name: OpenAI Codex + evidence: + - method: file + detail: .codex/* + file_url: https://github.com/Eco-RV/AstrOS/blob/HEAD/.codex/config.toml +- slug: gemini-cli + name: Gemini CLI + evidence: + - method: file + detail: .gemini/* + file_url: https://github.com/Eco-RV/AstrOS/blob/HEAD/.gemini/settings.json +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/Eco-RV/AstrOS/blob/HEAD/AGENTS.md chain: contracts: 0 wasm_uploads: 1 diff --git a/data/2026/atahanyild-koul.yml b/data/2026/atahanyild-koul.yml index 6469adf..0e03302 100644 --- a/data/2026/atahanyild-koul.yml +++ b/data/2026/atahanyild-koul.yml @@ -17,6 +17,19 @@ commits_in_window: 2 stack: soroban-sdk: null '@stellar/stellar-sdk': 16.0.1 +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: CLAUDE.md + file_url: https://github.com/atahanyild/koul/blob/HEAD/CLAUDE.md +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/atahanyild/koul/blob/HEAD/web/AGENTS.md chain: contracts: 15 wasm_uploads: 2 diff --git a/data/2026/bind.yml b/data/2026/bind.yml index 562a056..fc2d9a6 100644 --- a/data/2026/bind.yml +++ b/data/2026/bind.yml @@ -29,6 +29,13 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/wrever/bind/blob/HEAD/package.json +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/wrever/bind/blob/HEAD/AGENTS.md chain: contracts: 1 wasm_uploads: 1 diff --git a/data/2026/blnt-v3-migration.yml b/data/2026/blnt-v3-migration.yml index 920af46..00eb19a 100644 --- a/data/2026/blnt-v3-migration.yml +++ b/data/2026/blnt-v3-migration.yml @@ -14,6 +14,13 @@ evidence_tier: verified commits_in_window: 23 stack: soroban-sdk: null +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/BLNT-Protocol/blnt-v3-migration/blob/HEAD/AGENTS.md chain: contracts: 6 wasm_uploads: 5 diff --git a/data/2026/breakwater.yml b/data/2026/breakwater.yml index a5c4755..deb289e 100644 --- a/data/2026/breakwater.yml +++ b/data/2026/breakwater.yml @@ -24,6 +24,23 @@ evidence_tier: verified commits_in_window: 29 stack: soroban-sdk: null +tools: +- slug: stellar-raven + name: Stellar Raven + evidence: + - method: endpoint + detail: raven.stellar.org + file_url: https://github.com/Belvast-Innovation/Breakwater/blob/HEAD/.mcp.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: .claude/* + file_url: https://github.com/Belvast-Innovation/Breakwater/blob/HEAD/.claude/settings.json + - method: file + detail: CLAUDE.md + file_url: https://github.com/Belvast-Innovation/Breakwater/blob/HEAD/CLAUDE.md chain: contracts: 6 wasm_uploads: 5 diff --git a/data/2026/caravel.yml b/data/2026/caravel.yml index fd9571e..bac6252 100644 --- a/data/2026/caravel.yml +++ b/data/2026/caravel.yml @@ -23,6 +23,21 @@ integrations: - method: package detail: '@creit.tech/stellar-wallets-kit' file_url: https://github.com/rcusans-code/Caravel/blob/HEAD/app/package.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: author + detail: claude + - method: file + detail: CLAUDE.md + file_url: https://github.com/rcusans-code/Caravel/blob/HEAD/CLAUDE.md +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/rcusans-code/Caravel/blob/HEAD/AGENTS.md chain: contracts: 35 wasm_uploads: 20 diff --git a/data/2026/card-place-stellar.yml b/data/2026/card-place-stellar.yml index 7264d52..c019f7a 100644 --- a/data/2026/card-place-stellar.yml +++ b/data/2026/card-place-stellar.yml @@ -15,6 +15,13 @@ commits_in_window: 19 stack: soroban-sdk: null '@stellar/stellar-sdk': ^17.2.1 +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/Lothinnt/card-place-stellar/blob/HEAD/AGENTS.md chain: contracts: 4 wasm_uploads: 4 diff --git a/data/2026/cdp-clear.yml b/data/2026/cdp-clear.yml index fce043c..fc2c516 100644 --- a/data/2026/cdp-clear.yml +++ b/data/2026/cdp-clear.yml @@ -20,6 +20,19 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/PhilipLewellen/cdp-clear/blob/HEAD/package.json +agents: +- slug: lovable + name: Lovable + evidence: + - method: file + detail: .lovable/* + file_url: https://github.com/PhilipLewellen/cdp-clear/blob/HEAD/.lovable/plan +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/PhilipLewellen/cdp-clear/blob/HEAD/AGENTS.md chain: contracts: 0 wasm_uploads: 0 diff --git a/data/2026/chama.yml b/data/2026/chama.yml index 2b8dd67..4db3c0d 100644 --- a/data/2026/chama.yml +++ b/data/2026/chama.yml @@ -21,6 +21,13 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/lmstewart88/chama/blob/HEAD/web/package.json +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/lmstewart88/chama/blob/HEAD/AGENTS.md chain: contracts: 5 wasm_uploads: 1 diff --git a/data/2026/cherrypay-wallet.yml b/data/2026/cherrypay-wallet.yml index a79ec18..ed1d3cd 100644 --- a/data/2026/cherrypay-wallet.yml +++ b/data/2026/cherrypay-wallet.yml @@ -13,6 +13,13 @@ evidence_tier: likely commits_in_window: 350 stack: '@stellar/stellar-sdk': ^14.0.0 +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/sohamtech-uk/cherrypay-wallet/blob/HEAD/AGENTS.md chain: contracts: 0 wasm_uploads: 0 diff --git a/data/2026/cityofzion-hackmeridian.yml b/data/2026/cityofzion-hackmeridian.yml index 88f8b27..d8bf778 100644 --- a/data/2026/cityofzion-hackmeridian.yml +++ b/data/2026/cityofzion-hackmeridian.yml @@ -13,6 +13,22 @@ commits_in_window: 13 stack: soroban-sdk: =28.0.0 '@stellar/stellar-sdk': 16.4.1 +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: .claude/* + file_url: https://github.com/CityOfZion/hackmeridian/blob/HEAD/.claude/settings.json + - method: file + detail: CLAUDE.md + file_url: https://github.com/CityOfZion/hackmeridian/blob/HEAD/CLAUDE.md +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/CityOfZion/hackmeridian/blob/HEAD/AGENTS.md chain: contracts: 0 wasm_uploads: 0 diff --git a/data/2026/citypass.yml b/data/2026/citypass.yml index 53612a7..1388a43 100644 --- a/data/2026/citypass.yml +++ b/data/2026/citypass.yml @@ -16,6 +16,13 @@ commits_in_window: 8 stack: soroban-sdk: =29.0.1 '@stellar/stellar-sdk': 17.2.1 +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/Bran18/citypass/blob/HEAD/AGENTS.md chain: contracts: 5 wasm_uploads: 3 diff --git a/data/2026/clippay.yml b/data/2026/clippay.yml index 49dadd0..eda9466 100644 --- a/data/2026/clippay.yml +++ b/data/2026/clippay.yml @@ -23,6 +23,13 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/fdddf/clippay/blob/HEAD/web/package.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: .claude/* + file_url: https://github.com/fdddf/clippay/blob/HEAD/.claude/launch.json chain: contracts: 24 wasm_uploads: 5 diff --git a/data/2026/cmi-hackthon-meridian.yml b/data/2026/cmi-hackthon-meridian.yml index 2603b49..372d062 100644 --- a/data/2026/cmi-hackthon-meridian.yml +++ b/data/2026/cmi-hackthon-meridian.yml @@ -21,6 +21,22 @@ integrations: - method: package detail: '@creit.tech/stellar-wallets-kit' file_url: https://github.com/devfelipenunes/CMI-hackthon-meridian/blob/HEAD/web/app/package.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: .claude/* + file_url: https://github.com/devfelipenunes/CMI-hackthon-meridian/blob/HEAD/sdk/.claude/skills + - method: file + detail: CLAUDE.md + file_url: https://github.com/devfelipenunes/CMI-hackthon-meridian/blob/HEAD/web/CLAUDE.md +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/devfelipenunes/CMI-hackthon-meridian/blob/HEAD/specs/AGENTS.md chain: contracts: 0 wasm_uploads: 0 diff --git a/data/2026/cuotia.yml b/data/2026/cuotia.yml index 9f91c83..eaa637b 100644 --- a/data/2026/cuotia.yml +++ b/data/2026/cuotia.yml @@ -25,6 +25,19 @@ integrations: - method: package detail: '@creit.tech/stellar-wallets-kit' file_url: https://github.com/fredericjasmin/cuotia/blob/HEAD/package.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: CLAUDE.md + file_url: https://github.com/fredericjasmin/cuotia/blob/HEAD/CLAUDE.md +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/fredericjasmin/cuotia/blob/HEAD/AGENTS.md chain: contracts: 1 wasm_uploads: 1 diff --git a/data/2026/devfest-harambeeone.yml b/data/2026/devfest-harambeeone.yml index 73a18b9..0588661 100644 --- a/data/2026/devfest-harambeeone.yml +++ b/data/2026/devfest-harambeeone.yml @@ -15,6 +15,13 @@ commits_in_window: 16 stack: soroban-sdk: =22.0.0 stellar-sdk: 16.1.1 +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/RockieRaheem/Devfest_HarambeeOne/blob/HEAD/AGENTS.md chain: contracts: 0 wasm_uploads: 0 diff --git a/data/2026/diversify.yml b/data/2026/diversify.yml index 86bbca1..91c3044 100644 --- a/data/2026/diversify.yml +++ b/data/2026/diversify.yml @@ -45,6 +45,24 @@ integrations: - method: endpoint detail: api.circle.com file_url: https://github.com/thisyearnofear/diversify/blob/HEAD/apps/web/config/index.ts +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: CLAUDE.md + file_url: https://github.com/thisyearnofear/diversify/blob/HEAD/apps/web/rive/assay-shield/CLAUDE.md +- slug: devin + name: Devin + evidence: + - method: author + detail: devin-ai-integration[bot] +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/thisyearnofear/diversify/blob/HEAD/AGENTS.md chain: contracts: 3 wasm_uploads: 1 diff --git a/data/2026/drainmywallet.yml b/data/2026/drainmywallet.yml index e28d224..2089a37 100644 --- a/data/2026/drainmywallet.yml +++ b/data/2026/drainmywallet.yml @@ -36,6 +36,13 @@ tools: - method: package detail: stellar-registry file_url: https://github.com/bilfrux/DrainMyWallet/blob/HEAD/Cargo.toml +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: CLAUDE.md + file_url: https://github.com/bilfrux/DrainMyWallet/blob/HEAD/app/CLAUDE.md chain: contracts: 7 wasm_uploads: 13 diff --git a/data/2026/dvdnd.yml b/data/2026/dvdnd.yml index 32c5952..484f468 100644 --- a/data/2026/dvdnd.yml +++ b/data/2026/dvdnd.yml @@ -32,6 +32,13 @@ integrations: - method: package detail: '@creit.tech/stellar-wallets-kit' file_url: https://github.com/forever8896/dvdnd/blob/HEAD/app/package.json +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/forever8896/dvdnd/blob/HEAD/contracts/AGENTS.md chain: contracts: 14 wasm_uploads: 13 diff --git a/data/2026/enza.yml b/data/2026/enza.yml index 5b84330..0f17756 100644 --- a/data/2026/enza.yml +++ b/data/2026/enza.yml @@ -12,6 +12,13 @@ evidence_tier: verified commits_in_window: 14 stack: '@stellar/stellar-sdk': ^16.0.0 +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/infoenzastore-cmd/enza/blob/HEAD/AGENTS.md chain: contracts: 0 wasm_uploads: 0 diff --git a/data/2026/enza3-mvmnt1.yml b/data/2026/enza3-mvmnt1.yml index d0787f3..e96f8d1 100644 --- a/data/2026/enza3-mvmnt1.yml +++ b/data/2026/enza3-mvmnt1.yml @@ -12,6 +12,13 @@ evidence_tier: likely commits_in_window: 34 stack: '@stellar/stellar-sdk': ^16.0.0 +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/infoenzastore-cmd/enza3.mvmnt1/blob/HEAD/AGENTS.md chain: contracts: 0 wasm_uploads: 0 diff --git a/data/2026/explorador-agent-loan-stellar.yml b/data/2026/explorador-agent-loan-stellar.yml index b82fca8..434877f 100644 --- a/data/2026/explorador-agent-loan-stellar.yml +++ b/data/2026/explorador-agent-loan-stellar.yml @@ -24,6 +24,19 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/joaointech/explorador-agent-loan-stellar/blob/HEAD/apps/web/package.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: CLAUDE.md + file_url: https://github.com/joaointech/explorador-agent-loan-stellar/blob/HEAD/CLAUDE.md +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/joaointech/explorador-agent-loan-stellar/blob/HEAD/apps/web/AGENTS.md chain: contracts: 30 wasm_uploads: 3 diff --git a/data/2026/fermento.yml b/data/2026/fermento.yml index 0f8ad1d..2b256a3 100644 --- a/data/2026/fermento.yml +++ b/data/2026/fermento.yml @@ -15,6 +15,13 @@ commits_in_window: 41 stack: soroban-sdk: null '@stellar/stellar-sdk': ^16.0.1 +tools: +- slug: stellar-skills + name: Stellar Skills + evidence: + - method: endpoint + detail: skills.stellar.org + file_url: https://github.com/the-axmc/Fermento/blob/HEAD/scripts/producer-api.ts chain: contracts: 15 wasm_uploads: 23 diff --git a/data/2026/fiavel-hack-lisbon.yml b/data/2026/fiavel-hack-lisbon.yml index 818b4bb..139648f 100644 --- a/data/2026/fiavel-hack-lisbon.yml +++ b/data/2026/fiavel-hack-lisbon.yml @@ -15,6 +15,18 @@ commits_in_window: 48 stack: soroban-sdk: null '@stellar/stellar-sdk': ^16.0.1 +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: author + detail: claude +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/Rjk3d/Fiavel_Hack_Lisbon/blob/HEAD/AGENTS.md chain: contracts: 9 wasm_uploads: 7 diff --git a/data/2026/flowpay.yml b/data/2026/flowpay.yml index 371a788..7c2054c 100644 --- a/data/2026/flowpay.yml +++ b/data/2026/flowpay.yml @@ -15,6 +15,13 @@ commits_in_window: 6 stack: soroban-sdk: null '@stellar/stellar-sdk': 17.2.1 +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/flowpay-bmoni/flowpay/blob/HEAD/AGENTS.md chain: contracts: 0 wasm_uploads: 0 diff --git a/data/2026/forepay.yml b/data/2026/forepay.yml index b9b68fb..810e48c 100644 --- a/data/2026/forepay.yml +++ b/data/2026/forepay.yml @@ -23,6 +23,19 @@ integrations: - method: package detail: '@creit.tech/stellar-wallets-kit' file_url: https://github.com/forepay-stellar/forepay/blob/HEAD/fe/package.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: CLAUDE.md + file_url: https://github.com/forepay-stellar/forepay/blob/HEAD/CLAUDE.md +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/forepay-stellar/forepay/blob/HEAD/fe/AGENTS.md chain: contracts: 0 wasm_uploads: 1 diff --git a/data/2026/gamelock.yml b/data/2026/gamelock.yml index 6bdba66..8b79108 100644 --- a/data/2026/gamelock.yml +++ b/data/2026/gamelock.yml @@ -28,6 +28,19 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/Innokeshka1/gamelock/blob/HEAD/package.json +agents: +- slug: lovable + name: Lovable + evidence: + - method: file + detail: .lovable/* + file_url: https://github.com/Innokeshka1/gamelock/blob/HEAD/.lovable/project.json +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/Innokeshka1/gamelock/blob/HEAD/AGENTS.md chain: contracts: 0 wasm_uploads: 0 diff --git a/data/2026/ghost-proof.yml b/data/2026/ghost-proof.yml index 8b53e54..3f4c990 100644 --- a/data/2026/ghost-proof.yml +++ b/data/2026/ghost-proof.yml @@ -36,6 +36,13 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/siwakadrianna-byte/ghost-proof/blob/HEAD/package.json +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/siwakadrianna-byte/ghost-proof/blob/HEAD/AGENTS.md chain: contracts: 0 wasm_uploads: 0 diff --git a/data/2026/greenledger.yml b/data/2026/greenledger.yml index bec5105..c58c2d0 100644 --- a/data/2026/greenledger.yml +++ b/data/2026/greenledger.yml @@ -14,6 +14,12 @@ evidence_tier: verified commits_in_window: 1 stack: soroban-sdk: 22.0.0 +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: author + detail: claude chain: contracts: 1 wasm_uploads: 0 diff --git a/data/2026/hack-meridian-2026.yml b/data/2026/hack-meridian-2026.yml index e4dd771..4e7b1b7 100644 --- a/data/2026/hack-meridian-2026.yml +++ b/data/2026/hack-meridian-2026.yml @@ -22,6 +22,44 @@ integrations: - method: endpoint detail: 1click.chaindefuser.com file_url: https://github.com/grmkris/hack-meridian-2026/blob/HEAD/evidence/topup/dry-quote-2026-10-25T22-07-19-789Z.json +tools: +- slug: stellar-raven + name: Stellar Raven + evidence: + - method: endpoint + detail: raven.stellar.buzz + file_url: https://github.com/grmkris/hack-meridian-2026/blob/HEAD/.mcp.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: .claude-plugin/* + file_url: https://github.com/grmkris/hack-meridian-2026/blob/HEAD/.agents/skills/humanizer/.claude-plugin/marketplace.json + - method: file + detail: .claude/* + file_url: https://github.com/grmkris/hack-meridian-2026/blob/HEAD/.claude/settings.json + - method: file + detail: CLAUDE.md + file_url: https://github.com/grmkris/hack-meridian-2026/blob/HEAD/.agents/skills/humanizer/CLAUDE.md +- slug: cursor + name: Cursor + evidence: + - method: file + detail: .cursor/* + file_url: https://github.com/grmkris/hack-meridian-2026/blob/HEAD/.cursor/mcp.json +- slug: codex + name: OpenAI Codex + evidence: + - method: file + detail: .codex/* + file_url: https://github.com/grmkris/hack-meridian-2026/blob/HEAD/.codex/config.toml +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/grmkris/hack-meridian-2026/blob/HEAD/.agents/skills/humanizer/AGENTS.md chain: contracts: 91 wasm_uploads: 4 diff --git a/data/2026/hackathons-landing.yml b/data/2026/hackathons-landing.yml index 4290274..331cdbf 100644 --- a/data/2026/hackathons-landing.yml +++ b/data/2026/hackathons-landing.yml @@ -12,6 +12,13 @@ track: genesis track_declared: false evidence_tier: verified commits_in_window: 3 +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: CLAUDE.md + file_url: https://github.com/defindex-io/hackathons-landing/blob/HEAD/CLAUDE.md chain: contracts: 5 wasm_uploads: 0 diff --git a/data/2026/hackmeridian-stellar-hackathon.yml b/data/2026/hackmeridian-stellar-hackathon.yml index 893db5b..a0ecf90 100644 --- a/data/2026/hackmeridian-stellar-hackathon.yml +++ b/data/2026/hackmeridian-stellar-hackathon.yml @@ -38,6 +38,28 @@ tools: - method: package detail: stellar-registry file_url: https://github.com/MohamedDataX/HackMeridian-stellar-Hackathon/blob/HEAD/Cargo.toml +- slug: stellar-skills + name: Stellar Skills + evidence: + - method: endpoint + detail: stellar/stellar-dev-skill + file_url: https://github.com/MohamedDataX/HackMeridian-stellar-Hackathon/blob/HEAD/.claude/settings.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: .claude/* + file_url: https://github.com/MohamedDataX/HackMeridian-stellar-Hackathon/blob/HEAD/.claude/settings.json + - method: file + detail: CLAUDE.md + file_url: https://github.com/MohamedDataX/HackMeridian-stellar-Hackathon/blob/HEAD/app/CLAUDE.md +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/MohamedDataX/HackMeridian-stellar-Hackathon/blob/HEAD/video/AGENTS.md chain: contracts: 11 wasm_uploads: 7 diff --git a/data/2026/hackmeridian2026.yml b/data/2026/hackmeridian2026.yml index f5d8c07..925ffc2 100644 --- a/data/2026/hackmeridian2026.yml +++ b/data/2026/hackmeridian2026.yml @@ -31,6 +31,22 @@ integrations: - method: package detail: '@creit.tech/stellar-wallets-kit' file_url: https://github.com/Team-hackmeridian-2026/Hackmeridian2026/blob/HEAD/frontend/package.json +tools: +- slug: stellar-raven + name: Stellar Raven + evidence: + - method: endpoint + detail: raven.stellar.org + file_url: https://github.com/Team-hackmeridian-2026/Hackmeridian2026/blob/HEAD/.mcp.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: author + detail: claude + - method: file + detail: CLAUDE.md + file_url: https://github.com/Team-hackmeridian-2026/Hackmeridian2026/blob/HEAD/CLAUDE.md chain: contracts: 9 wasm_uploads: 3 diff --git a/data/2026/human-bond.yml b/data/2026/human-bond.yml index 7ab4985..e77c294 100644 --- a/data/2026/human-bond.yml +++ b/data/2026/human-bond.yml @@ -32,6 +32,19 @@ integrations: - method: package detail: '@creit.tech/stellar-wallets-kit' file_url: https://github.com/herbstephens/Human-Bond/blob/HEAD/miniapp/package.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: CLAUDE.md + file_url: https://github.com/herbstephens/Human-Bond/blob/HEAD/CLAUDE.md +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/herbstephens/Human-Bond/blob/HEAD/AGENTS.md chain: contracts: 3 wasm_uploads: 0 diff --git a/data/2026/indexify-mvp.yml b/data/2026/indexify-mvp.yml index 0671b7c..166b776 100644 --- a/data/2026/indexify-mvp.yml +++ b/data/2026/indexify-mvp.yml @@ -21,6 +21,13 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/recentlyhatched/indexify-mvp/blob/HEAD/web/package.json +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/recentlyhatched/indexify-mvp/blob/HEAD/web/AGENTS.md chain: contracts: 1 wasm_uploads: 1 diff --git a/data/2026/kado-hackmeridian.yml b/data/2026/kado-hackmeridian.yml index 86fa080..15e2355 100644 --- a/data/2026/kado-hackmeridian.yml +++ b/data/2026/kado-hackmeridian.yml @@ -12,6 +12,35 @@ evidence_tier: verified commits_in_window: 32 stack: '@stellar/stellar-sdk': 17.2.1 +tools: +- slug: stellar-raven + name: Stellar Raven + evidence: + - method: endpoint + detail: raven.stellar.org + file_url: https://github.com/eduruizhipolito/kado-hackmeridian/blob/HEAD/.mcp.json +- slug: stellar-skills + name: Stellar Skills + evidence: + - method: endpoint + detail: stellar/stellar-dev-skill + file_url: https://github.com/eduruizhipolito/kado-hackmeridian/blob/HEAD/skills-lock.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: .claude/* + file_url: https://github.com/eduruizhipolito/kado-hackmeridian/blob/HEAD/.claude/launch.json + - method: file + detail: CLAUDE.md + file_url: https://github.com/eduruizhipolito/kado-hackmeridian/blob/HEAD/CLAUDE.md +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/eduruizhipolito/kado-hackmeridian/blob/HEAD/AGENTS.md chain: contracts: 0 wasm_uploads: 0 diff --git a/data/2026/keystone.yml b/data/2026/keystone.yml index f391670..4fa3315 100644 --- a/data/2026/keystone.yml +++ b/data/2026/keystone.yml @@ -30,6 +30,13 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/Lagouze/keystone/blob/HEAD/app/package.json +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/Lagouze/keystone/blob/HEAD/AGENTS.md chain: contracts: 20 wasm_uploads: 2 diff --git a/data/2026/kotizi-stellar-meridian.yml b/data/2026/kotizi-stellar-meridian.yml index 0409012..49c35ca 100644 --- a/data/2026/kotizi-stellar-meridian.yml +++ b/data/2026/kotizi-stellar-meridian.yml @@ -30,6 +30,13 @@ integrations: - method: package detail: '@privy-io/react-auth' file_url: https://github.com/kotizi/kotizi-stellar-meridian/blob/HEAD/frontend/package.json +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/kotizi/kotizi-stellar-meridian/blob/HEAD/frontend/AGENTS.md chain: contracts: 6 wasm_uploads: 5 diff --git a/data/2026/koul-me-koul.yml b/data/2026/koul-me-koul.yml index 1bffbc4..dc81b48 100644 --- a/data/2026/koul-me-koul.yml +++ b/data/2026/koul-me-koul.yml @@ -17,6 +17,19 @@ commits_in_window: 36 stack: soroban-sdk: null '@stellar/stellar-sdk': 16.0.1 +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: CLAUDE.md + file_url: https://github.com/koul-me/koul/blob/HEAD/CLAUDE.md +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/koul-me/koul/blob/HEAD/web/AGENTS.md chain: contracts: 2 wasm_uploads: 1 diff --git a/data/2026/kovan.yml b/data/2026/kovan.yml index 4699bb8..48ccb83 100644 --- a/data/2026/kovan.yml +++ b/data/2026/kovan.yml @@ -22,6 +22,46 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/kovan-protocol/kovan/blob/HEAD/dashboard/package.json +tools: +- slug: stellar-raven + name: Stellar Raven + evidence: + - method: endpoint + detail: raven.stellar.org + file_url: https://github.com/kovan-protocol/kovan/blob/HEAD/.mcp.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: .claude-plugin/* + file_url: https://github.com/kovan-protocol/kovan/blob/HEAD/.claude-plugin/marketplace.json + - method: file + detail: .claude/* + file_url: https://github.com/kovan-protocol/kovan/blob/HEAD/.claude/skills +- slug: cursor + name: Cursor + evidence: + - method: author + detail: cursoragent +- slug: codex + name: OpenAI Codex + evidence: + - method: file + detail: .codex/* + file_url: https://github.com/kovan-protocol/kovan/blob/HEAD/.codex/config.toml +- slug: gemini-cli + name: Gemini CLI + evidence: + - method: file + detail: .gemini/* + file_url: https://github.com/kovan-protocol/kovan/blob/HEAD/.gemini/settings.json +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/kovan-protocol/kovan/blob/HEAD/dashboard/AGENTS.md chain: contracts: 32 wasm_uploads: 14 diff --git a/data/2026/latch.yml b/data/2026/latch.yml index f036bb7..d5e389a 100644 --- a/data/2026/latch.yml +++ b/data/2026/latch.yml @@ -24,6 +24,13 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/karagozemin/LATCH/blob/HEAD/sites/latch-demo/package.json +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/karagozemin/LATCH/blob/HEAD/AGENTS.md chain: contracts: 1 wasm_uploads: 0 diff --git a/data/2026/lendara-shield.yml b/data/2026/lendara-shield.yml index 50965a9..c7cc930 100644 --- a/data/2026/lendara-shield.yml +++ b/data/2026/lendara-shield.yml @@ -22,6 +22,19 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/Lendara-Org/lendara-shield/blob/HEAD/apps/web/package.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: CLAUDE.md + file_url: https://github.com/Lendara-Org/lendara-shield/blob/HEAD/CLAUDE.md +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/Lendara-Org/lendara-shield/blob/HEAD/AGENTS.md chain: contracts: 10 wasm_uploads: 2 diff --git a/data/2026/loot.yml b/data/2026/loot.yml index 843c754..32c1b86 100644 --- a/data/2026/loot.yml +++ b/data/2026/loot.yml @@ -29,6 +29,13 @@ integrations: - method: package detail: passkey-kit file_url: https://github.com/Klorenn/LOOT/blob/HEAD/app/package.json +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/Klorenn/LOOT/blob/HEAD/app/AGENTS.md chain: contracts: 111 wasm_uploads: 10 diff --git a/data/2026/lotus-stellar.yml b/data/2026/lotus-stellar.yml index 79c9242..b631265 100644 --- a/data/2026/lotus-stellar.yml +++ b/data/2026/lotus-stellar.yml @@ -23,6 +23,19 @@ integrations: - method: package detail: '@creit.tech/stellar-wallets-kit' file_url: https://github.com/skar8848/lotus-stellar/blob/HEAD/web/package.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: CLAUDE.md + file_url: https://github.com/skar8848/lotus-stellar/blob/HEAD/CLAUDE.md +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/skar8848/lotus-stellar/blob/HEAD/AGENTS.md chain: contracts: 6 wasm_uploads: 5 diff --git a/data/2026/merit.yml b/data/2026/merit.yml index 9461899..138fc35 100644 --- a/data/2026/merit.yml +++ b/data/2026/merit.yml @@ -14,6 +14,21 @@ commits_in_window: 53 stack: soroban-sdk: null '@stellar/stellar-sdk': ^16.0.1 +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: author + detail: claude + - method: file + detail: .claude/* + file_url: https://github.com/don-radman/merit/blob/HEAD/.claude/launch.json +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/don-radman/merit/blob/HEAD/AGENTS.md chain: contracts: 30 wasm_uploads: 8 diff --git a/data/2026/microvault.yml b/data/2026/microvault.yml index 20adf3d..8015b0b 100644 --- a/data/2026/microvault.yml +++ b/data/2026/microvault.yml @@ -22,6 +22,13 @@ commits_in_window: 6 stack: soroban-sdk: null '@stellar/stellar-sdk': ^17.2.1 +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: .claude/* + file_url: https://github.com/Shamba-Records-Limited/microvault/blob/HEAD/.claude/settings.local.json chain: contracts: 0 wasm_uploads: 1 diff --git a/data/2026/middlemate.yml b/data/2026/middlemate.yml index 174eb51..7066a27 100644 --- a/data/2026/middlemate.yml +++ b/data/2026/middlemate.yml @@ -23,6 +23,19 @@ integrations: - method: package detail: '@creit.tech/stellar-wallets-kit' file_url: https://github.com/curtismoncoq/Middlemate/blob/HEAD/apps/web/package.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: CLAUDE.md + file_url: https://github.com/curtismoncoq/Middlemate/blob/HEAD/CLAUDE.md +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/curtismoncoq/Middlemate/blob/HEAD/AGENTS.md chain: contracts: 3 wasm_uploads: 3 diff --git a/data/2026/mohamedkhellaf-hackmeridian.yml b/data/2026/mohamedkhellaf-hackmeridian.yml index 887252f..aec4674 100644 --- a/data/2026/mohamedkhellaf-hackmeridian.yml +++ b/data/2026/mohamedkhellaf-hackmeridian.yml @@ -22,6 +22,26 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/mohamedkhellaf/hackmeridian/blob/HEAD/frontend/package.json +tools: +- slug: stellar-raven + name: Stellar Raven + evidence: + - method: endpoint + detail: raven.stellar.org + file_url: https://github.com/mohamedkhellaf/hackmeridian/blob/HEAD/.mcp.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: CLAUDE.md + file_url: https://github.com/mohamedkhellaf/hackmeridian/blob/HEAD/CLAUDE.md +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/mohamedkhellaf/hackmeridian/blob/HEAD/AGENTS.md chain: contracts: 11 wasm_uploads: 9 diff --git a/data/2026/monolith.yml b/data/2026/monolith.yml index 06b8894..1b7c784 100644 --- a/data/2026/monolith.yml +++ b/data/2026/monolith.yml @@ -21,6 +21,21 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/Rushyard/Monolith/blob/HEAD/app/package.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: author + detail: claude + - method: file + detail: CLAUDE.md + file_url: https://github.com/Rushyard/Monolith/blob/HEAD/packages/ct-sdk/CLAUDE.md +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/Rushyard/Monolith/blob/HEAD/app/AGENTS.md chain: contracts: 4 wasm_uploads: 3 diff --git a/data/2026/nata-stellar.yml b/data/2026/nata-stellar.yml index 30fd7b3..4c7ca6a 100644 --- a/data/2026/nata-stellar.yml +++ b/data/2026/nata-stellar.yml @@ -21,6 +21,13 @@ integrations: - method: package detail: passkey-kit file_url: https://github.com/developerfred/nata-stellar/blob/HEAD/apps/web/package.json +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/developerfred/nata-stellar/blob/HEAD/apps/web/AGENTS.md chain: contracts: 1 wasm_uploads: 1 diff --git a/data/2026/nema.yml b/data/2026/nema.yml index 8ec09e7..0023768 100644 --- a/data/2026/nema.yml +++ b/data/2026/nema.yml @@ -21,6 +21,13 @@ integrations: - method: package detail: '@creit.tech/stellar-wallets-kit' file_url: https://github.com/emirykl/nema/blob/HEAD/frontend/package.json +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/emirykl/nema/blob/HEAD/frontend/AGENTS.md chain: contracts: 0 wasm_uploads: 0 diff --git a/data/2026/nest.yml b/data/2026/nest.yml index f5c38fc..d4d4d31 100644 --- a/data/2026/nest.yml +++ b/data/2026/nest.yml @@ -40,6 +40,26 @@ integrations: - method: package detail: '@blend-capital/blend-sdk' file_url: https://github.com/ethan-r13n/nest/blob/HEAD/packages/adapters/package.json +tools: +- slug: stellar-raven + name: Stellar Raven + evidence: + - method: endpoint + detail: raven.stellar.org + file_url: https://github.com/ethan-r13n/nest/blob/HEAD/design/nest/index.html +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: CLAUDE.md + file_url: https://github.com/ethan-r13n/nest/blob/HEAD/CLAUDE.md +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/ethan-r13n/nest/blob/HEAD/AGENTS.md chain: contracts: 0 wasm_uploads: 0 diff --git a/data/2026/nicolecarolina-hackmeridian.yml b/data/2026/nicolecarolina-hackmeridian.yml index baceffa..61b1ecf 100644 --- a/data/2026/nicolecarolina-hackmeridian.yml +++ b/data/2026/nicolecarolina-hackmeridian.yml @@ -36,6 +36,13 @@ tools: - method: package detail: stellar-registry file_url: https://github.com/NicoleCarolina/HackMeridian/blob/HEAD/Cargo.toml +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: CLAUDE.md + file_url: https://github.com/NicoleCarolina/HackMeridian/blob/HEAD/app/CLAUDE.md chain: contracts: 1 wasm_uploads: 1 diff --git a/data/2026/nilo.yml b/data/2026/nilo.yml index 1b7388d..ba8991e 100644 --- a/data/2026/nilo.yml +++ b/data/2026/nilo.yml @@ -14,6 +14,12 @@ commits_in_window: 64 stack: soroban-sdk: null '@stellar/stellar-sdk': ^17.3.0 +agents: +- slug: cursor + name: Cursor + evidence: + - method: author + detail: cursoragent chain: contracts: 4 wasm_uploads: 4 diff --git a/data/2026/nirium-watch.yml b/data/2026/nirium-watch.yml index f0b292c..94f52fe 100644 --- a/data/2026/nirium-watch.yml +++ b/data/2026/nirium-watch.yml @@ -14,6 +14,13 @@ evidence_tier: verified commits_in_window: 53 stack: '@stellar/stellar-sdk': ^16.0.1 +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/Eras256/nirium-watch/blob/HEAD/AGENTS.md chain: contracts: 0 wasm_uploads: 0 diff --git a/data/2026/orloj-stellar.yml b/data/2026/orloj-stellar.yml index 7b94c21..5fc5a87 100644 --- a/data/2026/orloj-stellar.yml +++ b/data/2026/orloj-stellar.yml @@ -28,6 +28,19 @@ integrations: - method: endpoint detail: api.defindex.io file_url: https://github.com/Deivitto/orloj-stellar/blob/HEAD/packages/stellar-registry/demo-contract/top10-audit/mcp-mainnet-remediation-results.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: CLAUDE.md + file_url: https://github.com/Deivitto/orloj-stellar/blob/HEAD/CLAUDE.md +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/Deivitto/orloj-stellar/blob/HEAD/AGENTS.md chain: contracts: 0 wasm_uploads: 0 diff --git a/data/2026/oz-policy-builder.yml b/data/2026/oz-policy-builder.yml index 5281879..455f75c 100644 --- a/data/2026/oz-policy-builder.yml +++ b/data/2026/oz-policy-builder.yml @@ -25,6 +25,13 @@ commits_in_window: 13 stack: soroban-sdk: =28.0.0 '@stellar/stellar-sdk': ^14.4.0 +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: .claude/* + file_url: https://github.com/untangledfinance/oz-policy-builder/blob/HEAD/.claude/skills chain: contracts: 17 wasm_uploads: 7 diff --git a/data/2026/peaje-zbe.yml b/data/2026/peaje-zbe.yml index e95cf5c..42840c6 100644 --- a/data/2026/peaje-zbe.yml +++ b/data/2026/peaje-zbe.yml @@ -36,6 +36,13 @@ tools: - method: package detail: stellar-registry file_url: https://github.com/marcocpp/peaje-zbe/blob/HEAD/Cargo.toml +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: CLAUDE.md + file_url: https://github.com/marcocpp/peaje-zbe/blob/HEAD/CLAUDE.md chain: contracts: 10 wasm_uploads: 2 diff --git a/data/2026/pelamandarinas-project.yml b/data/2026/pelamandarinas-project.yml index a06f53d..ed20cdc 100644 --- a/data/2026/pelamandarinas-project.yml +++ b/data/2026/pelamandarinas-project.yml @@ -21,6 +21,13 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/beaguzman/pelamandarinas_project/blob/HEAD/frontend/package.json +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/beaguzman/pelamandarinas_project/blob/HEAD/AGENTS.md chain: contracts: 3 wasm_uploads: 1 diff --git a/data/2026/phonedo.yml b/data/2026/phonedo.yml index c7f4345..3c96453 100644 --- a/data/2026/phonedo.yml +++ b/data/2026/phonedo.yml @@ -13,6 +13,13 @@ evidence_tier: verified commits_in_window: 84 stack: soroban-sdk: null +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/ParriCode/phonedo/blob/HEAD/AGENTS.md chain: contracts: 13 wasm_uploads: 4 diff --git a/data/2026/plan4her-stellar.yml b/data/2026/plan4her-stellar.yml index 95fc3be..f1e90b9 100644 --- a/data/2026/plan4her-stellar.yml +++ b/data/2026/plan4her-stellar.yml @@ -22,6 +22,12 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/Paolag93/plan4her-stellar/blob/HEAD/package.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: author + detail: claude chain: contracts: 0 wasm_uploads: 0 diff --git a/data/2026/pledge.yml b/data/2026/pledge.yml index 18a22cf..1a11327 100644 --- a/data/2026/pledge.yml +++ b/data/2026/pledge.yml @@ -13,6 +13,22 @@ commits_in_window: 66 stack: soroban-sdk: null '@stellar/stellar-sdk': 16.4.1 +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: .claude/* + file_url: https://github.com/jzelada97/Pledge/blob/HEAD/.claude/commands + - method: file + detail: CLAUDE.md + file_url: https://github.com/jzelada97/Pledge/blob/HEAD/CLAUDE.md +- slug: kiro + name: Kiro + evidence: + - method: file + detail: .kiro/* + file_url: https://github.com/jzelada97/Pledge/blob/HEAD/.kiro/pipeline chain: contracts: 10 wasm_uploads: 5 diff --git a/data/2026/polai-frontend.yml b/data/2026/polai-frontend.yml index cfcb62e..6b8e1d2 100644 --- a/data/2026/polai-frontend.yml +++ b/data/2026/polai-frontend.yml @@ -32,6 +32,13 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/polaiLabs/polai-frontend/blob/HEAD/package.json +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/polaiLabs/polai-frontend/blob/HEAD/AGENTS.md chain: contracts: 0 wasm_uploads: 0 diff --git a/data/2026/poolfi-build-1.yml b/data/2026/poolfi-build-1.yml index 31a36c7..1827759 100644 --- a/data/2026/poolfi-build-1.yml +++ b/data/2026/poolfi-build-1.yml @@ -15,6 +15,13 @@ commits_in_window: 1 stack: soroban-sdk: null '@stellar/stellar-sdk': ^17.2.1 +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: .claude/* + file_url: https://github.com/PoolFi-LTD/PoolFi-Build-1/blob/HEAD/.claude/launch.json chain: contracts: 0 wasm_uploads: 1 diff --git a/data/2026/portus.yml b/data/2026/portus.yml index 2654948..1d8288c 100644 --- a/data/2026/portus.yml +++ b/data/2026/portus.yml @@ -22,6 +22,13 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/AzrielTheHellrazor/portus/blob/HEAD/package.json +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/AzrielTheHellrazor/portus/blob/HEAD/AGENTS.md chain: contracts: 2 wasm_uploads: 2 diff --git a/data/2026/presign-guard.yml b/data/2026/presign-guard.yml index 02418ad..cb18a81 100644 --- a/data/2026/presign-guard.yml +++ b/data/2026/presign-guard.yml @@ -13,6 +13,13 @@ evidence_tier: likely commits_in_window: 5 stack: '@stellar/stellar-sdk': ^16.4.1 +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: .claude/* + file_url: https://github.com/Fizzl13/presign-guard/blob/HEAD/.claude/hooks chain: contracts: 0 wasm_uploads: 0 diff --git a/data/2026/private-yield.yml b/data/2026/private-yield.yml index b83aa73..74a3a17 100644 --- a/data/2026/private-yield.yml +++ b/data/2026/private-yield.yml @@ -24,6 +24,19 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/troqpay/private-yield/blob/HEAD/package.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: CLAUDE.md + file_url: https://github.com/troqpay/private-yield/blob/HEAD/CLAUDE.md +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/troqpay/private-yield/blob/HEAD/AGENTS.md chain: contracts: 12 wasm_uploads: 0 diff --git a/data/2026/qafila.yml b/data/2026/qafila.yml index 38207c5..5937288 100644 --- a/data/2026/qafila.yml +++ b/data/2026/qafila.yml @@ -31,6 +31,16 @@ integrations: - method: package detail: '@creit.tech/stellar-wallets-kit' file_url: https://github.com/Ilyes-Ali-Jeridi/qafila/blob/HEAD/apps/web/package.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: .claude/* + file_url: https://github.com/Ilyes-Ali-Jeridi/qafila/blob/HEAD/.claude/skills + - method: file + detail: CLAUDE.md + file_url: https://github.com/Ilyes-Ali-Jeridi/qafila/blob/HEAD/CLAUDE.md chain: contracts: 47 wasm_uploads: 6 diff --git a/data/2026/redevice.yml b/data/2026/redevice.yml index 0656553..ec00b31 100644 --- a/data/2026/redevice.yml +++ b/data/2026/redevice.yml @@ -21,6 +21,12 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/Ihlasthetics/redevice/blob/HEAD/web/package.json +agents: +- slug: codex + name: OpenAI Codex + evidence: + - method: author + detail: codex chain: contracts: 20 wasm_uploads: 3 diff --git a/data/2026/sansara.yml b/data/2026/sansara.yml index 3117385..ccb1032 100644 --- a/data/2026/sansara.yml +++ b/data/2026/sansara.yml @@ -13,6 +13,12 @@ commits_in_window: 25 stack: soroban-sdk: null '@stellar/stellar-sdk': ^14.6.1 +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: author + detail: claude chain: contracts: 3 wasm_uploads: 3 diff --git a/data/2026/scaffold-stellar-agentic.yml b/data/2026/scaffold-stellar-agentic.yml index 15b896c..b8dfa38 100644 --- a/data/2026/scaffold-stellar-agentic.yml +++ b/data/2026/scaffold-stellar-agentic.yml @@ -56,6 +56,46 @@ tools: - method: package detail: '@stellar-scaffold/app-lib' file_url: https://github.com/bitfalt/scaffold-stellar-agentic/blob/HEAD/app/package.json +- slug: stellar-raven + name: Stellar Raven + evidence: + - method: endpoint + detail: raven.stellar.org + file_url: https://github.com/bitfalt/scaffold-stellar-agentic/blob/HEAD/.mcp.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: .claude/* + file_url: https://github.com/bitfalt/scaffold-stellar-agentic/blob/HEAD/.claude/settings.json + - method: file + detail: CLAUDE.md + file_url: https://github.com/bitfalt/scaffold-stellar-agentic/blob/HEAD/CLAUDE.md +- slug: cursor + name: Cursor + evidence: + - method: file + detail: .cursor/* + file_url: https://github.com/bitfalt/scaffold-stellar-agentic/blob/HEAD/.cursor/mcp.json +- slug: codex + name: OpenAI Codex + evidence: + - method: file + detail: .codex/* + file_url: https://github.com/bitfalt/scaffold-stellar-agentic/blob/HEAD/.codex/config.toml +- slug: gemini-cli + name: Gemini CLI + evidence: + - method: file + detail: .gemini/* + file_url: https://github.com/bitfalt/scaffold-stellar-agentic/blob/HEAD/.gemini/settings.json +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/bitfalt/scaffold-stellar-agentic/blob/HEAD/AGENTS.md chain: contracts: 0 wasm_uploads: 1 diff --git a/data/2026/secretspay-stellar-daap.yml b/data/2026/secretspay-stellar-daap.yml index 76f8c5f..c090c9f 100644 --- a/data/2026/secretspay-stellar-daap.yml +++ b/data/2026/secretspay-stellar-daap.yml @@ -22,6 +22,12 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/Isaac2399/Secretspay-stellar-daap/blob/HEAD/package.json +agents: +- slug: cursor + name: Cursor + evidence: + - method: author + detail: cursoragent chain: contracts: 2 wasm_uploads: 2 diff --git a/data/2026/sendabussines.yml b/data/2026/sendabussines.yml index 1200dbd..53efce9 100644 --- a/data/2026/sendabussines.yml +++ b/data/2026/sendabussines.yml @@ -31,6 +31,13 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/SendaLabs/SendaBussines/blob/HEAD/apps/web/package.json +agents: +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/SendaLabs/SendaBussines/blob/HEAD/AGENTS.md chain: contracts: 0 wasm_uploads: 0 diff --git a/data/2026/seyf-p.yml b/data/2026/seyf-p.yml index 5586fc3..fe4c369 100644 --- a/data/2026/seyf-p.yml +++ b/data/2026/seyf-p.yml @@ -39,6 +39,29 @@ integrations: - method: package detail: '@defindex/sdk' file_url: https://github.com/Seyfert-Labs/SEYF-P/blob/HEAD/package.json +tools: +- slug: stellar-skills + name: Stellar Skills + evidence: + - method: endpoint + detail: skills.stellar.org + file_url: https://github.com/Seyfert-Labs/SEYF-P/blob/HEAD/scripts/install-stellar-skills.sh + - method: endpoint + detail: stellar/stellar-dev-skill + file_url: https://github.com/Seyfert-Labs/SEYF-P/blob/HEAD/scripts/install-stellar-skills.sh +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: CLAUDE.md + file_url: https://github.com/Seyfert-Labs/SEYF-P/blob/HEAD/CLAUDE.md +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/Seyfert-Labs/SEYF-P/blob/HEAD/AGENTS.md chain: contracts: 5 wasm_uploads: 5 diff --git a/data/2026/shake.yml b/data/2026/shake.yml index b9237b3..a92c436 100644 --- a/data/2026/shake.yml +++ b/data/2026/shake.yml @@ -14,6 +14,15 @@ commits_in_window: 102 stack: soroban-sdk: 29.0.1 '@stellar/stellar-sdk': ^16.3.1 +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: author + detail: claude + - method: file + detail: CLAUDE.md + file_url: https://github.com/franciscogfsm/shake/blob/HEAD/CLAUDE.md chain: contracts: 5 wasm_uploads: 5 diff --git a/data/2026/slasettle-vault.yml b/data/2026/slasettle-vault.yml index 2414441..7d3bdca 100644 --- a/data/2026/slasettle-vault.yml +++ b/data/2026/slasettle-vault.yml @@ -27,6 +27,13 @@ evidence_tier: verified commits_in_window: 1 stack: soroban-sdk: null +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: CLAUDE.md + file_url: https://github.com/SLASettleHQ/slasettle-vault/blob/HEAD/CLAUDE.md chain: contracts: 2 wasm_uploads: 2 diff --git a/data/2026/soroprove.yml b/data/2026/soroprove.yml index 7ed6eb8..060218d 100644 --- a/data/2026/soroprove.yml +++ b/data/2026/soroprove.yml @@ -15,6 +15,13 @@ commits_in_window: 61 stack: soroban-sdk: '25' stellar-xdr: =30.0.0 +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: .claude/* + file_url: https://github.com/drank40/soroprove/blob/HEAD/lifter/.claude/worktrees chain: contracts: 0 wasm_uploads: 0 diff --git a/data/2026/starpocket.yml b/data/2026/starpocket.yml index 1c1d435..99c5fe4 100644 --- a/data/2026/starpocket.yml +++ b/data/2026/starpocket.yml @@ -13,6 +13,13 @@ evidence_tier: likely commits_in_window: 10 stack: '@stellar/stellar-sdk': ^17.4.0 +tools: +- slug: stellar-raven + name: Stellar Raven + evidence: + - method: endpoint + detail: raven.stellar.buzz + file_url: https://github.com/mizukuhiiragi/starpocket/blob/HEAD/.agents/mcp_config.json chain: contracts: 0 wasm_uploads: 0 diff --git a/data/2026/stellar-confidential-token-demo.yml b/data/2026/stellar-confidential-token-demo.yml index 185ab68..1a3ae53 100644 --- a/data/2026/stellar-confidential-token-demo.yml +++ b/data/2026/stellar-confidential-token-demo.yml @@ -24,6 +24,13 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/brozorec/stellar-confidential-token-demo/blob/HEAD/packages/app/package.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: CLAUDE.md + file_url: https://github.com/brozorec/stellar-confidential-token-demo/blob/HEAD/CLAUDE.md chain: contracts: 0 wasm_uploads: 1 diff --git a/data/2026/stellar-forge.yml b/data/2026/stellar-forge.yml index d2d5c4c..2903848 100644 --- a/data/2026/stellar-forge.yml +++ b/data/2026/stellar-forge.yml @@ -15,6 +15,12 @@ commits_in_window: 46 stack: soroban-sdk: '28' '@stellar/stellar-sdk': ^17.2.0 +agents: +- slug: cursor + name: Cursor + evidence: + - method: author + detail: cursoragent chain: contracts: 2 wasm_uploads: 0 diff --git a/data/2026/stellar-p30-check.yml b/data/2026/stellar-p30-check.yml index 9038f7e..6fdbfde 100644 --- a/data/2026/stellar-p30-check.yml +++ b/data/2026/stellar-p30-check.yml @@ -30,6 +30,24 @@ stack: '@stellar/stellar-sdk': ^16.0.0 '@stellar/stellar-base': 15.0.0 github.com/stellar/go: v0.0.0-20251210100531-aab2ea4aca88 +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: author + detail: claude +- slug: codex + name: OpenAI Codex + evidence: + - method: file + detail: .codex/* + file_url: https://github.com/Protocol-30/stellar-p30-check/blob/HEAD/.codex/config.toml +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/Protocol-30/stellar-p30-check/blob/HEAD/AGENTS.md chain: contracts: 0 wasm_uploads: 0 diff --git a/data/2026/stellar-quickpass.yml b/data/2026/stellar-quickpass.yml index 4e09c4a..f92c022 100644 --- a/data/2026/stellar-quickpass.yml +++ b/data/2026/stellar-quickpass.yml @@ -15,6 +15,18 @@ commits_in_window: 57 stack: soroban-sdk: '22' '@stellar/stellar-sdk': ^16.4.1 +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: author + detail: claude +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/jxsu404/stellar-quickpass/blob/HEAD/AGENTS.md chain: contracts: 9 wasm_uploads: 1 diff --git a/data/2026/stellar-rtgs.yml b/data/2026/stellar-rtgs.yml index e21e01f..f651029 100644 --- a/data/2026/stellar-rtgs.yml +++ b/data/2026/stellar-rtgs.yml @@ -21,6 +21,19 @@ integrations: - method: package detail: '@creit.tech/stellar-wallets-kit' file_url: https://github.com/rodrodros/stellar-rtgs/blob/HEAD/frontend-web/packages/core/package.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: CLAUDE.md + file_url: https://github.com/rodrodros/stellar-rtgs/blob/HEAD/backend-soroban/CLAUDE.md +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/rodrodros/stellar-rtgs/blob/HEAD/backend-soroban/AGENTS.md chain: contracts: 1 wasm_uploads: 1 diff --git a/data/2026/stellar-split.yml b/data/2026/stellar-split.yml index 4f6ac2f..e260938 100644 --- a/data/2026/stellar-split.yml +++ b/data/2026/stellar-split.yml @@ -24,6 +24,25 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/Michella-stack/Stellar-Split/blob/HEAD/apps/web/package.json +tools: +- slug: stellar-raven + name: Stellar Raven + evidence: + - method: endpoint + detail: raven.stellar.org + file_url: https://github.com/Michella-stack/Stellar-Split/blob/HEAD/.mcp.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: author + detail: claude +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/Michella-stack/Stellar-Split/blob/HEAD/docs/AGENTS.md chain: contracts: 1 wasm_uploads: 0 diff --git a/data/2026/stellar2bitcoin.yml b/data/2026/stellar2bitcoin.yml index 55ad8e5..4e4ae10 100644 --- a/data/2026/stellar2bitcoin.yml +++ b/data/2026/stellar2bitcoin.yml @@ -20,6 +20,19 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/CryptoValencia/stellar2bitcoin/blob/HEAD/package.json +agents: +- slug: lovable + name: Lovable + evidence: + - method: file + detail: .lovable/* + file_url: https://github.com/CryptoValencia/stellar2bitcoin/blob/HEAD/.lovable/project.json +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/CryptoValencia/stellar2bitcoin/blob/HEAD/AGENTS.md chain: contracts: 0 wasm_uploads: 0 diff --git a/data/2026/toolport.yml b/data/2026/toolport.yml index 815c60e..c52e79b 100644 --- a/data/2026/toolport.yml +++ b/data/2026/toolport.yml @@ -21,6 +21,13 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/HackatonWinnners/toolport/blob/HEAD/apps/web/package.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: .claude-plugin/* + file_url: https://github.com/HackatonWinnners/toolport/blob/HEAD/.claude-plugin/marketplace.json chain: contracts: 0 wasm_uploads: 0 diff --git a/data/2026/trust-meridian.yml b/data/2026/trust-meridian.yml index 1834765..dd0a89f 100644 --- a/data/2026/trust-meridian.yml +++ b/data/2026/trust-meridian.yml @@ -33,6 +33,12 @@ integrations: - method: endpoint detail: api.defindex.io file_url: https://github.com/Wilivms/trust-meridian/blob/HEAD/scripts/probe.sh +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: author + detail: claude chain: contracts: 16 wasm_uploads: 8 diff --git a/data/2026/turbolong.yml b/data/2026/turbolong.yml index d14e386..88c9180 100644 --- a/data/2026/turbolong.yml +++ b/data/2026/turbolong.yml @@ -31,6 +31,13 @@ integrations: - method: package detail: '@stellar-broker/client' file_url: https://github.com/Dgetsylver/TurboLong/blob/HEAD/frontend/package.json +agents: +- slug: kiro + name: Kiro + evidence: + - method: file + detail: .kiro/* + file_url: https://github.com/Dgetsylver/TurboLong/blob/HEAD/.kiro/specs chain: contracts: 1 wasm_uploads: 1 diff --git a/data/2026/usagepay.yml b/data/2026/usagepay.yml index 564e273..5502b15 100644 --- a/data/2026/usagepay.yml +++ b/data/2026/usagepay.yml @@ -15,6 +15,23 @@ commits_in_window: 79 stack: '@stellar/stellar-sdk': 15.1.0 '@stellar/stellar-base': 15.0.0 +tools: +- slug: stellar-skills + name: Stellar Skills + evidence: + - method: endpoint + detail: stellar/stellar-dev-skill + file_url: https://github.com/skopolabs/usagepay/blob/HEAD/implementation-versions.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: .claude/* + file_url: https://github.com/skopolabs/usagepay/blob/HEAD/.claude/settings.json + - method: file + detail: CLAUDE.md + file_url: https://github.com/skopolabs/usagepay/blob/HEAD/CLAUDE.md chain: contracts: 5 wasm_uploads: 0 diff --git a/data/2026/writz.yml b/data/2026/writz.yml index 9c15672..762d43f 100644 --- a/data/2026/writz.yml +++ b/data/2026/writz.yml @@ -41,6 +41,25 @@ integrations: - method: package detail: '@defindex/sdk' file_url: https://github.com/WritzProtocol/writz/blob/HEAD/relayer/package.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: .claude/* + file_url: https://github.com/WritzProtocol/writz/blob/HEAD/.claude/skills +- slug: codex + name: OpenAI Codex + evidence: + - method: file + detail: .codex/* + file_url: https://github.com/WritzProtocol/writz/blob/HEAD/.codex/hooks.json +- slug: agents-md + name: AGENTS.md + evidence: + - method: file + detail: AGENTS.md + file_url: https://github.com/WritzProtocol/writz/blob/HEAD/AGENTS.md chain: contracts: 3 wasm_uploads: 3 diff --git a/data/2026/yield-bearing-rental-deposit.yml b/data/2026/yield-bearing-rental-deposit.yml index 80445f6..95140f3 100644 --- a/data/2026/yield-bearing-rental-deposit.yml +++ b/data/2026/yield-bearing-rental-deposit.yml @@ -38,6 +38,13 @@ tools: - method: package detail: stellar-registry file_url: https://github.com/ddortabencomo/yield-bearing-rental-deposit/blob/HEAD/Cargo.toml +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: CLAUDE.md + file_url: https://github.com/ddortabencomo/yield-bearing-rental-deposit/blob/HEAD/app/CLAUDE.md chain: contracts: 18 wasm_uploads: 12 diff --git a/data/2026/zkross.yml b/data/2026/zkross.yml index 01bcb4b..5d42ac7 100644 --- a/data/2026/zkross.yml +++ b/data/2026/zkross.yml @@ -25,6 +25,13 @@ integrations: - method: package detail: '@stellar/freighter-api' file_url: https://github.com/enzoblain/ZKross/blob/HEAD/apps/frontend/package.json +agents: +- slug: claude-code + name: Claude Code + evidence: + - method: file + detail: CLAUDE.md + file_url: https://github.com/enzoblain/ZKross/blob/HEAD/CLAUDE.md chain: contracts: 6 wasm_uploads: 4 diff --git a/data/schema-hackathon-project.yml b/data/schema-hackathon-project.yml index 62de02f..d7cc4c0 100644 --- a/data/schema-hackathon-project.yml +++ b/data/schema-hackathon-project.yml @@ -1,5 +1,48 @@ $schema: https://json-schema.org/draft/2020-12/schema $defs: + FileAgent: + additionalProperties: false + properties: + slug: + title: Slug + type: string + name: + title: Name + type: string + evidence: + items: + $ref: '#/$defs/FileAgentEvidence' + title: Evidence + type: array + required: + - slug + - name + - evidence + title: FileAgent + type: object + FileAgentEvidence: + additionalProperties: false + properties: + method: + enum: + - file + - author + title: Method + type: string + detail: + title: Detail + type: string + file_url: + anyOf: + - type: string + - type: 'null' + default: null + title: File Url + required: + - method + - detail + title: FileAgentEvidence + type: object FileChain: additionalProperties: false properties: @@ -244,6 +287,12 @@ properties: $ref: '#/$defs/FileIntegration' title: Tools type: array + agents: + description: AI coding agents the repo shows traces of, in config files or commits + items: + $ref: '#/$defs/FileAgent' + title: Agents + type: array chain: $ref: '#/$defs/FileChain' contributors: From 17b1ace8834db25d5494d3e20feb2b12607c3fef Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 08:53:55 +0100 Subject: [PATCH 21/54] docs: describe the tools and agents fields --- data/README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/data/README.md b/data/README.md index ba6ba8e..a12bbdf 100644 --- a/data/README.md +++ b/data/README.md @@ -7,7 +7,7 @@ The HackProof dataset: one YAML file per project, plus the config that produces ``` data/ hackmeridian-2026.yaml event config: window, awards, discovery queries - integrations.yaml Stellar integration partners and how each is detected + integrations.yaml Partners, Stellar tools and AI agents, and how each is detected schema-hackathon-project.yml JSON Schema for every project file, generated schema-event.yml JSON Schema for the event manifest, generated 2026/_event.yml event manifest: slug, name, network, window @@ -68,6 +68,8 @@ its owner as a prefix, `-`. A clash left after that stops the expor | `commits_in_window` | Commits made during the event window | | `stack` | Stellar package to declared version, `null` when the manifest gives none | | `integrations` | Ecosystem partners found, each with `evidence` (`method` is `package` or `endpoint`, `detail`, `file_url`) | +| `tools` | Stellar developer tools found (Scaffold Stellar, Stellar Registry, Stellar Raven, Stellar Skills), same `evidence` shape as `integrations` | +| `agents` | AI coding agents the repo shows traces of, each with `evidence` (`method` is `file` for a config file such as `CLAUDE.md` or `.cursor/`, or `author` for a commit author, `detail`, `file_url`). A tool that leaves no trace is not counted, so this is a lower bound | | `chain` | Testnet counts, the attributed `accounts` and the `evidence` behind the tier. Both lists are always present | | `contributors` | Public GitHub `login` and `contributions`. Always present | From 1121ec8b6996444f2bb4d6fa5456ac8a005f14be Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 08:54:37 +0100 Subject: [PATCH 22/54] fix: hide a wrapped list tile that has nothing to show --- apps/web/src/pages/wrapped.tsx | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/apps/web/src/pages/wrapped.tsx b/apps/web/src/pages/wrapped.tsx index 85cee36..4b9e8c7 100644 --- a/apps/web/src/pages/wrapped.tsx +++ b/apps/web/src/pages/wrapped.tsx @@ -297,6 +297,8 @@ function Builders({ wrapped }: { wrapped: Wrapped }) { function Agents({ data, lens, onSelect }: SectionProps) { const rows = ranked(data.agents, 'agent', AGENT_ROWS) + if (rows.length === 0) return null + return ( Date: Sun, 15 Nov 2026 08:55:52 +0100 Subject: [PATCH 23/54] feat: filter the explorer by ai coding agent --- .../src/components/explorer/filter-panel.tsx | 28 +++++++++++-------- apps/web/src/components/explorer/filters.ts | 2 ++ .../components/explorer/project-explorer.tsx | 4 ++- 3 files changed, 22 insertions(+), 12 deletions(-) diff --git a/apps/web/src/components/explorer/filter-panel.tsx b/apps/web/src/components/explorer/filter-panel.tsx index ed8385b..958331c 100644 --- a/apps/web/src/components/explorer/filter-panel.tsx +++ b/apps/web/src/components/explorer/filter-panel.tsx @@ -3,7 +3,7 @@ import { useState } from 'react' import { Button } from '@/components/ui/button' import { Checkbox } from '@/components/ui/checkbox' import { countryName, flagEmoji, placeLabel, tierLabel, trackLabel } from '@/lib/format' -import type { EcosystemTool, Integration, Project } from '@/lib/types' +import type { AiAgent, EcosystemTool, Integration, Project } from '@/lib/types' import { countValues, type FilterKey, type Selection, selectedCount } from './filters' @@ -20,6 +20,7 @@ interface FilterPanelProps { projects: Project[] integrations: Integration[] tools: EcosystemTool[] + agents: AiAgent[] selection: Selection onToggle: (key: FilterKey, value: string) => void onClear: () => void @@ -49,6 +50,7 @@ function options( projects: Project[], integrations: Integration[], tools: EcosystemTool[], + agents: AiAgent[], selection: Selection, ): Option[] { const counts = countValues(projects, selection, key) @@ -60,16 +62,18 @@ function options( ? integrations.map((item) => [item.slug, item.name, item.category]) : key === 'tool' ? tools.map((item) => [item.slug, item.name]) - : [ - ...new Set( - projects.flatMap( - (project) => (key === 'language' ? project.language : project.country) ?? [], + : key === 'agent' + ? agents.map((item) => [item.slug, item.name]) + : [ + ...new Set( + projects.flatMap( + (project) => (key === 'language' ? project.language : project.country) ?? [], + ), ), - ), - ].map((value) => [ - value, - key === 'country' ? `${flagEmoji(value)} ${countryName(value)}` : value, - ]) + ].map((value) => [ + value, + key === 'country' ? `${flagEmoji(value)} ${countryName(value)}` : value, + ]) return labelled .map(([value, label, hint]) => ({ value, label, hint, count: counts.get(value) ?? 0 })) .filter((option) => option.count > 0 || chosen.has(option.value)) @@ -126,6 +130,7 @@ const GROUPS: { key: FilterKey; title: string; collapsible: boolean }[] = [ { key: 'track', title: 'Track', collapsible: false }, { key: 'partner', title: 'Integrations', collapsible: true }, { key: 'tool', title: 'Ecosystem tooling', collapsible: false }, + { key: 'agent', title: 'AI coding agents', collapsible: false }, { key: 'activity', title: 'On-chain activity', collapsible: false }, { key: 'language', title: 'Language', collapsible: true }, { key: 'country', title: 'Country', collapsible: true }, @@ -135,6 +140,7 @@ export function FilterPanel({ projects, integrations, tools, + agents, selection, onToggle, onClear, @@ -155,7 +161,7 @@ export function FilterPanel({ onToggle(key, value)} collapsible={collapsible} diff --git a/apps/web/src/components/explorer/filters.ts b/apps/web/src/components/explorer/filters.ts index b70be3d..3cb39ec 100644 --- a/apps/web/src/components/explorer/filters.ts +++ b/apps/web/src/components/explorer/filters.ts @@ -6,6 +6,7 @@ export const FILTER_KEYS = [ 'track', 'partner', 'tool', + 'agent', 'activity', 'language', 'country', @@ -19,6 +20,7 @@ const VALUES: Record string[]> = { track: (project) => (project.track ? [project.track] : []), partner: (project) => project.integrations ?? [], tool: (project) => project.tools ?? [], + agent: (project) => project.agents ?? [], activity: (project) => [ ...(project.contracts > 0 ? ['contracts'] : []), ...(project.failed_txs > 0 ? ['failed'] : []), diff --git a/apps/web/src/components/explorer/project-explorer.tsx b/apps/web/src/components/explorer/project-explorer.tsx index 8fb4f5f..48ec09e 100644 --- a/apps/web/src/components/explorer/project-explorer.tsx +++ b/apps/web/src/components/explorer/project-explorer.tsx @@ -11,7 +11,7 @@ import { Sheet, SheetContent, SheetHeader, SheetTitle, SheetTrigger } from '@/co import { Tabs, TabsList, TabsTrigger } from '@/components/ui/tabs' import { PAGE_SIZE } from '@/hooks/use-paged-list' import { usePaginationMode } from '@/hooks/use-pagination-mode' -import { useIntegrations, useProjects, useTools } from '@/hooks/use-projects' +import { useAgents, useIntegrations, useProjects, useTools } from '@/hooks/use-projects' import { posthog } from '@/lib/analytics' import { formatNumber } from '@/lib/format' @@ -30,6 +30,7 @@ export function ProjectExplorer({ search }: { search: string }) { const { data: projects, isPending, isError } = useProjects() const { data: integrations = [] } = useIntegrations() const { data: tools = [] } = useTools() + const { data: agents = [] } = useAgents() const view = params.get('view') === 'table' ? 'table' : 'cards' const selection = useMemo(() => readSelection(params), [params]) const active = selectedCount(selection) @@ -109,6 +110,7 @@ export function ProjectExplorer({ search }: { search: string }) { projects={projects ?? []} integrations={integrations} tools={tools} + agents={agents} selection={selection} onToggle={toggle} onClear={clear} From c7ca14934bf91feeed9248190409a1cfa9583d10 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 08:58:16 +0100 Subject: [PATCH 24/54] feat: link the wrapped categories to the explorer --- apps/web/src/components/wrapped/lens-list.tsx | 27 ++++--- .../src/components/wrapped/segmented-bar.tsx | 75 ++++++++++++------- apps/web/src/lib/wrapped.ts | 16 +++- apps/web/src/pages/wrapped.tsx | 63 ++++++++-------- 4 files changed, 104 insertions(+), 77 deletions(-) diff --git a/apps/web/src/components/wrapped/lens-list.tsx b/apps/web/src/components/wrapped/lens-list.tsx index a5c1168..82e4a96 100644 --- a/apps/web/src/components/wrapped/lens-list.tsx +++ b/apps/web/src/components/wrapped/lens-list.tsx @@ -1,8 +1,9 @@ import { motion } from 'motion/react' +import { Link } from 'react-router' import { useStill } from '@/components/wrapped/use-still' import { formatNumber } from '@/lib/format' -import { EASE_OUT, isSameLens, percent, type Lens } from '@/lib/wrapped' +import { EASE_OUT, type Lens, explorerPath, isSameLens, percent } from '@/lib/wrapped' import { cn } from '@/lib/utils' export interface LensRow { @@ -15,11 +16,11 @@ interface LensListProps { rows: LensRow[] total: number active: Lens | null - onSelect: (lens: Lens) => void + onPreview: (lens: Lens | null) => void delay?: number } -export function LensList({ rows, total, active, onSelect, delay = 0 }: LensListProps) { +export function LensList({ rows, total, active, onPreview, delay = 0 }: LensListProps) { const still = useStill() return ( @@ -29,12 +30,14 @@ export function LensList({ rows, total, active, onSelect, delay = 0 }: LensListP return (
  • - +
  • ) })} diff --git a/apps/web/src/components/wrapped/segmented-bar.tsx b/apps/web/src/components/wrapped/segmented-bar.tsx index b4e87d2..0371820 100644 --- a/apps/web/src/components/wrapped/segmented-bar.tsx +++ b/apps/web/src/components/wrapped/segmented-bar.tsx @@ -1,51 +1,72 @@ import { motion } from 'motion/react' +import { Link } from 'react-router' import { useStill } from '@/components/wrapped/use-still' -import { EASE_OUT, isSameLens, percent, type Lens } from '@/lib/wrapped' -import type { Count } from '@/lib/types' +import { EASE_OUT, type Lens, explorerPath, isSameLens, percent } from '@/lib/wrapped' import { cn } from '@/lib/utils' -const SEGMENTS = ['bg-primary', 'bg-secondary', 'bg-chart-2', 'bg-chart-4', 'bg-muted-foreground'] +const COLORS = ['bg-primary', 'bg-secondary', 'bg-chart-2', 'bg-chart-4', 'bg-muted-foreground'] + +export interface Segment { + label: string + value: number + lens?: Lens +} interface SegmentedBarProps { - data: Count[] + data: Segment[] active: Lens | null - onSelect: (lens: Lens) => void + onPreview: (lens: Lens | null) => void delay?: number } -export function SegmentedBar({ data, active, onSelect, delay = 0 }: SegmentedBarProps) { +export function SegmentedBar({ data, active, onPreview, delay = 0 }: SegmentedBarProps) { const still = useStill() const total = data.reduce((sum, item) => sum + item.value, 0) - const lensOf = (label: string): Lens => ({ kind: 'language', value: label }) + const dimmed = (item: Segment) => + active?.kind === 'language' && !(item.lens && isSameLens(active, item.lens)) return (
    - {data.map((item, index) => ( - onSelect(lensOf(item.label))} - aria-label={item.label} - initial={still ? false : { scaleX: 0 }} - animate={{ scaleX: 1 }} - transition={{ delay: delay + index * 0.12, duration: 0.9, ease: EASE_OUT }} - style={{ width: `${percent(item.value, total)}%`, originX: 0 }} - className={cn( - 'rounded-sm transition-opacity hover:opacity-80', - SEGMENTS[index], - active?.kind === 'language' && - !isSameLens(active, lensOf(item.label)) && - 'opacity-30', - )} - /> - ))} + {data.map((item, index) => { + const segment = ( + + ) + + return ( + + {item.lens ? ( + onPreview(item.lens ?? null)} + onMouseLeave={() => onPreview(null)} + className="block size-full hover:opacity-80" + > + {segment} + + ) : ( + segment + )} + + ) + })}
      {data.map((item, index) => (
    • - + {item.label} {percent(item.value, total)}%
    • diff --git a/apps/web/src/lib/wrapped.ts b/apps/web/src/lib/wrapped.ts index 8611896..0b9f380 100644 --- a/apps/web/src/lib/wrapped.ts +++ b/apps/web/src/lib/wrapped.ts @@ -21,16 +21,24 @@ const matchers: Record boolean> = language: (project, value) => project.language === value, } +const EXPLORER_FILTER: Record = { + tier: 'tier', + agent: 'agent', + tool: 'tool', + integration: 'partner', + language: 'language', +} + +export function explorerPath(lens: Lens) { + return `/?${EXPLORER_FILTER[lens.kind]}=${encodeURIComponent(lens.value)}` +} + export function parseLens(raw: string | null): Lens | null { const [kind, ...rest] = (raw ?? '').split(':') const value = rest.join(':') return KINDS.includes(kind as LensKind) && value ? { kind: kind as LensKind, value } : null } -export function formatLens(lens: Lens) { - return `${lens.kind}:${lens.value}` -} - export function isSameLens(first: Lens | null, second: Lens) { return first?.kind === second.kind && first.value === second.value } diff --git a/apps/web/src/pages/wrapped.tsx b/apps/web/src/pages/wrapped.tsx index 4b9e8c7..b73cb44 100644 --- a/apps/web/src/pages/wrapped.tsx +++ b/apps/web/src/pages/wrapped.tsx @@ -1,11 +1,12 @@ import { motion } from 'motion/react' -import { useSearchParams } from 'react-router' +import { useState } from 'react' +import { Link, useSearchParams } from 'react-router' import { BuilderAvatars } from '@/components/wrapped/builder-avatars' import { Figure } from '@/components/wrapped/figure' import { LensList, type LensRow } from '@/components/wrapped/lens-list' import { RankedBars } from '@/components/wrapped/ranked-bars' -import { SegmentedBar } from '@/components/wrapped/segmented-bar' +import { type Segment, SegmentedBar } from '@/components/wrapped/segmented-bar' import { Stage } from '@/components/wrapped/stage' import { TeamBars } from '@/components/wrapped/team-bars' import { Tile } from '@/components/wrapped/tile' @@ -30,8 +31,7 @@ import type { } from '@/lib/types' import { EASE_OUT, - formatLens, - isSameLens, + explorerPath, matchesLens, parseLens, timelineHighlights, @@ -61,7 +61,7 @@ interface PosterData { interface SectionProps { data: PosterData lens: Lens | null - onSelect: (lens: Lens) => void + onPreview: (lens: Lens | null) => void } const day = new Intl.DateTimeFormat('en', { month: 'short', day: 'numeric', timeZone: 'UTC' }) @@ -111,7 +111,7 @@ function Header({ window }: { window: HackWindow }) { ) } -function languageCounts(projects: Project[]) { +function languageCounts(projects: Project[]): Segment[] { const counts = new Map() projects.forEach((project) => { const language = project.language ?? 'Other' @@ -120,7 +120,11 @@ function languageCounts(projects: Project[]) { const sorted = [...counts].sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0])) const rest = sorted.slice(LANGUAGES_SHOWN).reduce((sum, [, value]) => sum + value, 0) return [ - ...sorted.slice(0, LANGUAGES_SHOWN).map(([label, value]) => ({ label, value })), + ...sorted.slice(0, LANGUAGES_SHOWN).map(([label, value]) => ({ + label, + value, + lens: { kind: 'language' as const, value: label }, + })), ...(rest ? [{ label: 'Other', value: rest }] : []), ] } @@ -137,7 +141,7 @@ function lensSummary(lens: Lens, data: PosterData) { return { matched, name: names[lens.kind] ?? lens.value } } -function Hero({ data, lens, onSelect }: SectionProps) { +function Hero({ data, lens, onPreview }: SectionProps) { const { stats, projects } = data const commits = projects.reduce((sum, project) => sum + (project.window_commits ?? 0), 0) const summary = lens && lensSummary(lens, data) @@ -170,16 +174,17 @@ function Hero({ data, lens, onSelect }: SectionProps) { ) : ( tiers.map(({ tier, swatch }) => ( - + )) )}
    @@ -187,7 +192,7 @@ function Hero({ data, lens, onSelect }: SectionProps) {
    @@ -294,7 +299,7 @@ function Builders({ wrapped }: { wrapped: Wrapped }) { ) } -function Agents({ data, lens, onSelect }: SectionProps) { +function Agents({ data, lens, onPreview }: SectionProps) { const rows = ranked(data.agents, 'agent', AGENT_ROWS) if (rows.length === 0) return null @@ -310,14 +315,14 @@ function Agents({ data, lens, onSelect }: SectionProps) { rows={rows} total={data.projects.length} active={lens} - onSelect={onSelect} + onPreview={onPreview} delay={0.9} /> ) } -function Tooling({ data, lens, onSelect }: SectionProps) { +function Tooling({ data, lens, onPreview }: SectionProps) { const rows = ranked(data.tools, 'tool', data.tools.length) if (rows.length === 0) return null @@ -328,14 +333,14 @@ function Tooling({ data, lens, onSelect }: SectionProps) { rows={rows} total={data.projects.length} active={lens} - onSelect={onSelect} + onPreview={onPreview} delay={1} /> ) } -function BuiltWith({ data, lens, onSelect }: SectionProps) { +function BuiltWith({ data, lens, onPreview }: SectionProps) { const rows = ranked(data.integrations, 'integration', INTEGRATION_ROWS) if (rows.length === 0) return null @@ -346,7 +351,7 @@ function BuiltWith({ data, lens, onSelect }: SectionProps) { rows={rows} total={data.projects.length} active={lens} - onSelect={onSelect} + onPreview={onPreview} delay={1.1} /> @@ -390,16 +395,10 @@ function usePosterData(): PosterData | undefined { } export function WrappedPage() { - const [params, setParams] = useSearchParams() + const [params] = useSearchParams() + const [preview, setPreview] = useState(null) const data = usePosterData() - const lens = parseLens(params.get('lens')) - - const select = (next: Lens) => { - const updated = new URLSearchParams(params) - if (isSameLens(lens, next)) updated.delete('lens') - else updated.set('lens', formatLens(next)) - setParams(updated, { replace: true }) - } + const lens = preview ?? parseLens(params.get('lens')) return ( @@ -408,7 +407,7 @@ export function WrappedPage() {
    - +
    @@ -417,9 +416,9 @@ export function WrappedPage() {
    - - - + + +
    From 0e344cc82c699b981668baae8c11004a8378c87f Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 15:40:51 +0100 Subject: [PATCH 25/54] fix: teach the class merger the poster font sizes --- apps/web/src/lib/utils.ts | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/apps/web/src/lib/utils.ts b/apps/web/src/lib/utils.ts index ae9e5a7..45efc22 100644 --- a/apps/web/src/lib/utils.ts +++ b/apps/web/src/lib/utils.ts @@ -1 +1,7 @@ -export { cn } from 'cn' +import { createCn } from 'cn/config' + +const POSTER_TEXT_SIZES = ['eyebrow', 'stat', 'figure', 'figure-lg', 'headline', 'display'] + +export const cn = createCn({ + extend: { classGroups: { 'font-size': [{ text: POSTER_TEXT_SIZES }] } }, +}) From 34d023a7d3a82adfea2176aaffb3e3f73b6dbb3f Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 15:40:51 +0100 Subject: [PATCH 26/54] fix: size animated numbers by their final value --- apps/web/src/components/wrapped/figure.tsx | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/apps/web/src/components/wrapped/figure.tsx b/apps/web/src/components/wrapped/figure.tsx index c625718..170e77c 100644 --- a/apps/web/src/components/wrapped/figure.tsx +++ b/apps/web/src/components/wrapped/figure.tsx @@ -4,6 +4,7 @@ import { useEffect } from 'react' import { useStill } from '@/components/wrapped/use-still' import { formatNumber } from '@/lib/format' import { EASE_SETTLE } from '@/lib/wrapped' +import { cn } from '@/lib/utils' interface FigureProps { value: number @@ -22,5 +23,12 @@ export function Figure({ value, delay = 0, className }: FigureProps) { return controls.stop }, [count, value, delay, still]) - return {text} + return ( + + {formatNumber(value)} + + {text} + + + ) } From 986e497d42f4ae900a860a0a0d507326f76fcd34 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 15:40:51 +0100 Subject: [PATCH 27/54] fix: show the chart markers after the line is drawn --- .../src/components/wrapped/timeline-chart.tsx | 41 +++++++++++-------- 1 file changed, 24 insertions(+), 17 deletions(-) diff --git a/apps/web/src/components/wrapped/timeline-chart.tsx b/apps/web/src/components/wrapped/timeline-chart.tsx index b3c6c2c..4458a77 100644 --- a/apps/web/src/components/wrapped/timeline-chart.tsx +++ b/apps/web/src/components/wrapped/timeline-chart.tsx @@ -1,3 +1,4 @@ +import { useState } from 'react' import { Area, AreaChart, CartesianGrid, ReferenceArea, ReferenceDot, XAxis, YAxis } from 'recharts' import { type ChartConfig, ChartContainer } from '@/components/ui/chart' @@ -26,6 +27,7 @@ interface TimelineChartProps { export function TimelineChart({ data, peak, rush, className }: TimelineChartProps) { const still = useStill() + const [drawn, setDrawn] = useState(still) return ( @@ -45,15 +47,17 @@ export function TimelineChart({ data, peak, rush, className }: TimelineChartProp axisLine={false} /> - + {drawn && ( + + )} setDrawn(true)} /> - + {drawn && ( + + )} ) From d1b05520ee9ed9618f957b9778c6ae48d89e96bd Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 15:43:03 +0100 Subject: [PATCH 28/54] fix: center the wrapped stage on any screen size --- apps/web/src/components/wrapped/stage.tsx | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/apps/web/src/components/wrapped/stage.tsx b/apps/web/src/components/wrapped/stage.tsx index 2e835d4..e0faf7a 100644 --- a/apps/web/src/components/wrapped/stage.tsx +++ b/apps/web/src/components/wrapped/stage.tsx @@ -20,10 +20,14 @@ export function Stage({ still, children }: { still: boolean; children: ReactNode return ( -
    +
    {children}
    From c13cdbfefcf61e0e914ba900be55cfdacd5e81f2 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 15:46:31 +0100 Subject: [PATCH 29/54] feat: add a media query hook --- apps/web/src/hooks/use-media-query.ts | 13 +++++++++++++ 1 file changed, 13 insertions(+) create mode 100644 apps/web/src/hooks/use-media-query.ts diff --git a/apps/web/src/hooks/use-media-query.ts b/apps/web/src/hooks/use-media-query.ts new file mode 100644 index 0000000..44d30ac --- /dev/null +++ b/apps/web/src/hooks/use-media-query.ts @@ -0,0 +1,13 @@ +import { useSyncExternalStore } from 'react' + +export function useMediaQuery(query: string) { + return useSyncExternalStore( + (notify) => { + const list = window.matchMedia(query) + list.addEventListener('change', notify) + return () => list.removeEventListener('change', notify) + }, + () => window.matchMedia(query).matches, + () => false, + ) +} From 017a27a7cb31611a7a840c6a42f4d8a04adfc111 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 15:46:31 +0100 Subject: [PATCH 30/54] fix: space the timeline ticks by screen size --- apps/web/src/components/wrapped/timeline-chart.tsx | 10 +++++++++- apps/web/src/lib/wrapped.ts | 2 ++ 2 files changed, 11 insertions(+), 1 deletion(-) diff --git a/apps/web/src/components/wrapped/timeline-chart.tsx b/apps/web/src/components/wrapped/timeline-chart.tsx index 4458a77..3a71638 100644 --- a/apps/web/src/components/wrapped/timeline-chart.tsx +++ b/apps/web/src/components/wrapped/timeline-chart.tsx @@ -3,8 +3,10 @@ import { Area, AreaChart, CartesianGrid, ReferenceArea, ReferenceDot, XAxis, YAx import { type ChartConfig, ChartContainer } from '@/components/ui/chart' import { useStill } from '@/components/wrapped/use-still' +import { useMediaQuery } from '@/hooks/use-media-query' import { formatHour } from '@/lib/format' import type { TimelinePoint } from '@/lib/types' +import { POSTER_MEDIA } from '@/lib/wrapped' import { cn } from '@/lib/utils' const day = new Intl.DateTimeFormat('en', { month: 'short', day: 'numeric', timeZone: 'UTC' }) @@ -14,6 +16,9 @@ function tickLabel(iso: string) { return hour === '00:00' ? day.format(new Date(iso)) : hour } +const WIDE_TICK_HOURS = 3 +const NARROW_TICK_HOURS = 6 + const config = { contracts: { label: 'Contracts deployed', color: 'var(--primary)' }, } satisfies ChartConfig @@ -27,6 +32,9 @@ interface TimelineChartProps { export function TimelineChart({ data, peak, rush, className }: TimelineChartProps) { const still = useStill() + const wide = useMediaQuery(POSTER_MEDIA) + const step = wide ? WIDE_TICK_HOURS : NARROW_TICK_HOURS + const ticks = data.filter((_, index) => index % step === 0).map((point) => point.hour) const [drawn, setDrawn] = useState(still) return ( @@ -42,7 +50,7 @@ export function TimelineChart({ data, peak, rush, className }: TimelineChartProp diff --git a/apps/web/src/lib/wrapped.ts b/apps/web/src/lib/wrapped.ts index 0b9f380..f57cf90 100644 --- a/apps/web/src/lib/wrapped.ts +++ b/apps/web/src/lib/wrapped.ts @@ -1,5 +1,7 @@ import type { Project, TimelinePoint } from '@/lib/types' +export const POSTER_MEDIA = '(min-width: 64rem)' + export const EASE_OUT = [0.22, 1, 0.36, 1] as const export const EASE_SPRING = [0.34, 1.56, 0.64, 1] as const export const EASE_SETTLE = [0.16, 1, 0.3, 1] as const From 08ffc98f2c51468b00594d89a7fb7fe2a499af21 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 15:46:31 +0100 Subject: [PATCH 31/54] feat: add a scrolling layout of the wrapped page for small screens --- apps/web/src/pages/wrapped.tsx | 161 +++++++++++++++++++++++---------- 1 file changed, 112 insertions(+), 49 deletions(-) diff --git a/apps/web/src/pages/wrapped.tsx b/apps/web/src/pages/wrapped.tsx index b73cb44..53c9488 100644 --- a/apps/web/src/pages/wrapped.tsx +++ b/apps/web/src/pages/wrapped.tsx @@ -11,9 +11,10 @@ import { Stage } from '@/components/wrapped/stage' import { TeamBars } from '@/components/wrapped/team-bars' import { Tile } from '@/components/wrapped/tile' import { TimelineChart } from '@/components/wrapped/timeline-chart' -import { useStill } from '@/components/wrapped/use-still' +import { StillContext, useStill } from '@/components/wrapped/use-still' import { Waffle } from '@/components/wrapped/waffle' import { useHackWindow } from '@/hooks/use-hack-window' +import { useMediaQuery } from '@/hooks/use-media-query' import { useAgents, useIntegrations, useProjects, useTools } from '@/hooks/use-projects' import { useStats } from '@/hooks/use-stats' import { useTimeline } from '@/hooks/use-timeline' @@ -34,6 +35,7 @@ import { explorerPath, matchesLens, parseLens, + POSTER_MEDIA, timelineHighlights, type Lens, } from '@/lib/wrapped' @@ -101,7 +103,7 @@ function Header({ window }: { window: HackWindow }) { initial={still ? false : { opacity: 0, y: -14 }} animate={{ opacity: 1, y: 0 }} transition={{ duration: 0.7, ease: EASE_OUT }} - className="flex items-end justify-between" + className="flex flex-col gap-1 lg:flex-row lg:items-end lg:justify-between" >

    HackMeridian 2026 Wrapped @@ -226,7 +228,7 @@ function Chain({ data }: { data: PosterData }) { return ( -
    +
    {figures.map(([label, value], index) => (
    @@ -235,7 +237,7 @@ function Chain({ data }: { data: PosterData }) {
    {label}
    ))} -
    +
    {formatNumber(peak.contracts)} in one hour at{' '} {formatHour(peak.hour)} UTC @@ -254,8 +256,14 @@ function Operations({ wrapped }: { wrapped: Wrapped }) { const rows = wrapped.operations_by_type.map((row) => ({ ...row, label: humanize(row.label) })) return ( - - + + ) } @@ -269,8 +277,8 @@ function Builders({ wrapped }: { wrapped: Wrapped }) { const hidden = wrapped.multi_team_builders.length - MULTI_TEAM_BUILDERS return ( - - + +
    {wrapped.multi_team_builders.length} @@ -360,7 +368,7 @@ function BuiltWith({ data, lens, onPreview }: SectionProps) { function Footer() { return ( -

    +

    Rebuilt from the Stellar testnet and GitHub. Every project links to its on chain evidence. @@ -369,15 +377,22 @@ function Footer() { ) } -function usePosterData(): PosterData | undefined { - const { data: wrapped } = useWrapped() - const { data: stats } = useStats() - const { data: timeline } = useTimeline() - const { data: projects } = useProjects() - const { data: integrations } = useIntegrations() - const { data: tools } = useTools() - const { data: agents } = useAgents() - const { data: window } = useHackWindow() +function usePosterData(): { data: PosterData | undefined; failed: boolean } { + const queries = { + wrapped: useWrapped(), + stats: useStats(), + timeline: useTimeline(), + projects: useProjects(), + integrations: useIntegrations(), + tools: useTools(), + agents: useAgents(), + window: useHackWindow(), + } + const failed = Object.values(queries).some((query) => query.isError) + const { wrapped, stats, timeline, projects, integrations, tools, agents, window } = + Object.fromEntries(Object.entries(queries).map(([key, query]) => [key, query.data])) as { + [K in keyof typeof queries]: (typeof queries)[K]['data'] + } if ( !wrapped || @@ -389,45 +404,93 @@ function usePosterData(): PosterData | undefined { !agents || !window ) { - return undefined + return { data: undefined, failed } + } + return { + data: { wrapped, stats, timeline, projects, integrations, tools, agents, window }, + failed, } - return { wrapped, stats, timeline, projects, integrations, tools, agents, window } +} + +function Notice({ failed, className }: { failed: boolean; className: string }) { + return ( +

    + {failed ? 'Could not load the numbers. Try again in a moment.' : 'Counting…'} +
    + ) +} + +function Poster({ data, lens, onPreview }: SectionProps) { + return ( +
    +
    +
    + +
    + +
    + + +
    +
    +
    + + + +
    +
    +
    +
    + ) +} + +function Feed({ data, lens, onPreview }: SectionProps) { + return ( +
    +
    + + + + + + + +
    +
    + ) } export function WrappedPage() { const [params] = useSearchParams() const [preview, setPreview] = useState(null) - const data = usePosterData() + const { data, failed } = usePosterData() + const isPoster = useMediaQuery(POSTER_MEDIA) + const still = params.has('still') const lens = preview ?? parseLens(params.get('lens')) + if (isPoster) { + return ( + + + {data ? ( + + ) : ( + + )} + + ) + } + return ( - - - {data ? ( -
    -
    -
    - -
    - -
    - - -
    -
    -
    - - - -
    -
    -
    -
    - ) : ( -
    - Counting… -
    - )} -
    + +
    + + {data ? ( + + ) : ( + + )} +
    +
    ) } From 4aaa64d6740a0fdbd9192dc4e13b39f994817259 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 15:49:02 +0100 Subject: [PATCH 32/54] feat: add a contributor profile endpoint --- apps/api/src/hackproof/queries.py | 42 ++++++++++++++++++++++++++++++- apps/api/src/hackproof/routes.py | 9 +++++++ apps/api/src/hackproof/schemas.py | 14 +++++++++++ apps/api/tests/test_api.py | 18 +++++++++++++ 4 files changed, 82 insertions(+), 1 deletion(-) diff --git a/apps/api/src/hackproof/queries.py b/apps/api/src/hackproof/queries.py index b22c347..9c7ac2c 100644 --- a/apps/api/src/hackproof/queries.py +++ b/apps/api/src/hackproof/queries.py @@ -133,6 +133,14 @@ ORDER BY {METHOD_RANK_SQL}, l.subject_kind, l.subject """ +PERSON_SQL = """ +SELECT c.login, c.url, c.avatar_url, c.contributions, c.full_name, u.country +FROM repo_contributors c +LEFT JOIN github_users u ON u.login = c.login +WHERE lower(c.login) = lower($1) +ORDER BY c.contributions DESC, c.full_name +""" + CONTRIBUTORS_SQL = """ SELECT c.login, c.url, c.avatar_url, c.contributions, u.country FROM repo_contributors c @@ -271,12 +279,13 @@ async def list_page( track: str | None = None, integrations: list[str] | None = None, tools: list[str] | None = None, + project_ids: list[str] | None = None, winners: bool = False, limit: int = 50, offset: int = 0, ) -> tuple[list[dict[str, Any]], int]: awards = places() - winner_ids = list(awards) if winners else None + winner_ids = project_ids or (list(awards) if winners else None) args = ( (q, account, project_id, tiers, limit, offset, track, integrations, winner_ids, tools) if resource == "projects" @@ -381,3 +390,34 @@ async def fetch_agents() -> list[dict[str, Any]]: } for agent in get_catalog().agents ] + + +async def fetch_person(login: str) -> dict[str, Any] | None: + async with pool().acquire() as connection: + rows = [dict(row) for row in await connection.fetch(PERSON_SQL, login)] + if not rows: + return None + commits = {f"repo:{row['full_name']}": row["contributions"] for row in rows} + projects, _ = await list_page( + "projects", + tiers=["verified", "likely"], + project_ids=list(commits), + limit=len(commits), + ) + if not projects: + return None + first = rows[0] + return { + "login": first["login"], + "url": first["url"], + "avatar_url": first["avatar_url"], + "country": first["country"], + "contributions": sum(commits[project["project_id"]] for project in projects), + "projects": sorted( + ( + {"project": project, "contributions": commits[project["project_id"]]} + for project in projects + ), + key=lambda item: (-item["contributions"], item["project"]["project_id"]), + ), + } diff --git a/apps/api/src/hackproof/routes.py b/apps/api/src/hackproof/routes.py index 4871480..b7fb50e 100644 --- a/apps/api/src/hackproof/routes.py +++ b/apps/api/src/hackproof/routes.py @@ -12,6 +12,7 @@ FailedTx, Integration, Page, + Person, Project, ProjectDetail, Stats, @@ -138,6 +139,14 @@ async def project(project_id: str) -> ProjectDetail: ) +@router.get("/contributors/{login}") +async def contributor(login: str) -> Person: + person = await queries.fetch_person(login) + if person is None: + raise HTTPException(status_code=404, detail="no hackathon project for this contributor") + return Person(**person) + + @router.get("/builders/{address}") async def builder(address: str) -> Builder: result = Builder( diff --git a/apps/api/src/hackproof/schemas.py b/apps/api/src/hackproof/schemas.py index 049b9b4..cda9461 100644 --- a/apps/api/src/hackproof/schemas.py +++ b/apps/api/src/hackproof/schemas.py @@ -67,6 +67,20 @@ class Contributor(BaseModel): country: str | None +class PersonProject(BaseModel): + project: Project + contributions: int + + +class Person(BaseModel): + login: str + url: str + avatar_url: str | None + country: str | None + contributions: int + projects: list[PersonProject] + + class Link(BaseModel): subject_kind: str subject: str diff --git a/apps/api/tests/test_api.py b/apps/api/tests/test_api.py index f9f7ea7..b96bc93 100644 --- a/apps/api/tests/test_api.py +++ b/apps/api/tests/test_api.py @@ -118,3 +118,21 @@ def test_agents_list_every_catalog_agent_with_a_project_count(): assert {"claude-code", "cursor", "codex"} <= {row["slug"] for row in body} assert all(row["projects"] >= 0 for row in body) assert all(isinstance(item["agents"], list) for item in projects) + + +def test_an_unknown_contributor_is_not_found(): + with TestClient(app) as client: + assert client.get("/api/contributors/nobody-here-0000").status_code == 404 + + +def test_a_contributor_lists_their_projects_with_their_commits(): + with TestClient(app) as client: + top = client.get("/api/wrapped").json()["top_builders"] + if not top: + return + person = client.get(f"/api/contributors/{top[0]['login'].upper()}").json() + assert person["login"] == top[0]["login"] + assert person["contributions"] == sum(item["contributions"] for item in person["projects"]) + assert len(person["projects"]) == top[0]["projects"] + commits = [item["contributions"] for item in person["projects"]] + assert commits == sorted(commits, reverse=True) From 963aa390a35a05958164f88e4a46ad7e7f721b5e Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 15:50:44 +0100 Subject: [PATCH 33/54] refactor: move the filter options out of the panel --- .../src/components/explorer/filter-options.ts | 77 +++++++++++++++++++ .../src/components/explorer/filter-panel.tsx | 77 +------------------ 2 files changed, 79 insertions(+), 75 deletions(-) create mode 100644 apps/web/src/components/explorer/filter-options.ts diff --git a/apps/web/src/components/explorer/filter-options.ts b/apps/web/src/components/explorer/filter-options.ts new file mode 100644 index 0000000..336a8d3 --- /dev/null +++ b/apps/web/src/components/explorer/filter-options.ts @@ -0,0 +1,77 @@ +import { countryName, flagEmoji, placeLabel, tierLabel, trackLabel } from '@/lib/format' +import type { AiAgent, EcosystemTool, Integration, Project } from '@/lib/types' + +import { countValues, type FilterKey, type Selection } from './filters' + +export interface Option { + value: string + label: string + count: number + hint?: string +} + +const FIXED: Record<'award' | 'tier' | 'track' | 'activity', [string, string][]> = { + award: [ + ['first', placeLabel.first], + ['runner-up', placeLabel['runner-up']], + ], + tier: [ + ['verified', tierLabel.verified], + ['likely', tierLabel.likely], + ], + track: [ + ['genesis', trackLabel.genesis], + ['scale', trackLabel.scale], + ], + activity: [ + ['contracts', 'Deployed contracts'], + ['failed', 'Failed transactions'], + ], +} + +export function options( + key: FilterKey, + projects: Project[], + integrations: Integration[], + tools: EcosystemTool[], + agents: AiAgent[], + selection: Selection, +): Option[] { + const counts = countValues(projects, selection, key) + const chosen = new Set(selection[key]) + const labelled: [string, string, string?][] = + key === 'award' || key === 'tier' || key === 'track' || key === 'activity' + ? FIXED[key].map(([value, label]) => [value, label]) + : key === 'partner' + ? integrations.map((item) => [item.slug, item.name, item.category]) + : key === 'tool' + ? tools.map((item) => [item.slug, item.name]) + : key === 'agent' + ? agents.map((item) => [item.slug, item.name]) + : [ + ...new Set( + projects.flatMap( + (project) => (key === 'language' ? project.language : project.country) ?? [], + ), + ), + ].map((value) => [ + value, + key === 'country' ? `${flagEmoji(value)} ${countryName(value)}` : value, + ]) + return labelled + .map(([value, label, hint]) => ({ value, label, hint, count: counts.get(value) ?? 0 })) + .filter((option) => option.count > 0 || chosen.has(option.value)) + .sort((a, b) => (key in FIXED ? 0 : b.count - a.count || a.label.localeCompare(b.label))) +} + +export const GROUPS: { key: FilterKey; title: string; collapsible: boolean }[] = [ + { key: 'award', title: 'Awards', collapsible: false }, + { key: 'tier', title: 'Evidence', collapsible: false }, + { key: 'track', title: 'Track', collapsible: false }, + { key: 'partner', title: 'Integrations', collapsible: true }, + { key: 'tool', title: 'Ecosystem tooling', collapsible: false }, + { key: 'agent', title: 'AI coding agents', collapsible: false }, + { key: 'activity', title: 'On-chain activity', collapsible: false }, + { key: 'language', title: 'Language', collapsible: true }, + { key: 'country', title: 'Country', collapsible: true }, +] diff --git a/apps/web/src/components/explorer/filter-panel.tsx b/apps/web/src/components/explorer/filter-panel.tsx index 958331c..899a385 100644 --- a/apps/web/src/components/explorer/filter-panel.tsx +++ b/apps/web/src/components/explorer/filter-panel.tsx @@ -2,20 +2,13 @@ import { useState } from 'react' import { Button } from '@/components/ui/button' import { Checkbox } from '@/components/ui/checkbox' -import { countryName, flagEmoji, placeLabel, tierLabel, trackLabel } from '@/lib/format' import type { AiAgent, EcosystemTool, Integration, Project } from '@/lib/types' -import { countValues, type FilterKey, type Selection, selectedCount } from './filters' +import { GROUPS, type Option, options } from './filter-options' +import { type FilterKey, type Selection, selectedCount } from './filters' const VISIBLE = 8 -interface Option { - value: string - label: string - count: number - hint?: string -} - interface FilterPanelProps { projects: Project[] integrations: Integration[] @@ -26,60 +19,6 @@ interface FilterPanelProps { onClear: () => void } -const FIXED: Record<'award' | 'tier' | 'track' | 'activity', [string, string][]> = { - award: [ - ['first', placeLabel.first], - ['runner-up', placeLabel['runner-up']], - ], - tier: [ - ['verified', tierLabel.verified], - ['likely', tierLabel.likely], - ], - track: [ - ['genesis', trackLabel.genesis], - ['scale', trackLabel.scale], - ], - activity: [ - ['contracts', 'Deployed contracts'], - ['failed', 'Failed transactions'], - ], -} - -function options( - key: FilterKey, - projects: Project[], - integrations: Integration[], - tools: EcosystemTool[], - agents: AiAgent[], - selection: Selection, -): Option[] { - const counts = countValues(projects, selection, key) - const chosen = new Set(selection[key]) - const labelled: [string, string, string?][] = - key === 'award' || key === 'tier' || key === 'track' || key === 'activity' - ? FIXED[key].map(([value, label]) => [value, label]) - : key === 'partner' - ? integrations.map((item) => [item.slug, item.name, item.category]) - : key === 'tool' - ? tools.map((item) => [item.slug, item.name]) - : key === 'agent' - ? agents.map((item) => [item.slug, item.name]) - : [ - ...new Set( - projects.flatMap( - (project) => (key === 'language' ? project.language : project.country) ?? [], - ), - ), - ].map((value) => [ - value, - key === 'country' ? `${flagEmoji(value)} ${countryName(value)}` : value, - ]) - return labelled - .map(([value, label, hint]) => ({ value, label, hint, count: counts.get(value) ?? 0 })) - .filter((option) => option.count > 0 || chosen.has(option.value)) - .sort((a, b) => (key in FIXED ? 0 : b.count - a.count || a.label.localeCompare(b.label))) -} - function Group({ title, items, @@ -124,18 +63,6 @@ function Group({ ) } -const GROUPS: { key: FilterKey; title: string; collapsible: boolean }[] = [ - { key: 'award', title: 'Awards', collapsible: false }, - { key: 'tier', title: 'Evidence', collapsible: false }, - { key: 'track', title: 'Track', collapsible: false }, - { key: 'partner', title: 'Integrations', collapsible: true }, - { key: 'tool', title: 'Ecosystem tooling', collapsible: false }, - { key: 'agent', title: 'AI coding agents', collapsible: false }, - { key: 'activity', title: 'On-chain activity', collapsible: false }, - { key: 'language', title: 'Language', collapsible: true }, - { key: 'country', title: 'Country', collapsible: true }, -] - export function FilterPanel({ projects, integrations, From 66b892230854b90a1afa43c665da0124c752b822 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 15:51:09 +0100 Subject: [PATCH 34/54] feat: link the wrapped page from the site header --- apps/web/src/components/layout/site-header.tsx | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/apps/web/src/components/layout/site-header.tsx b/apps/web/src/components/layout/site-header.tsx index bc54eb7..49ff825 100644 --- a/apps/web/src/components/layout/site-header.tsx +++ b/apps/web/src/components/layout/site-header.tsx @@ -1,4 +1,4 @@ -import { CrownIcon, ExternalLinkIcon, MoonIcon, SunIcon } from 'lucide-react' +import { CrownIcon, ExternalLinkIcon, MoonIcon, SparklesIcon, SunIcon } from 'lucide-react' import { useTheme } from 'next-themes' import { Link } from 'react-router' @@ -21,6 +21,12 @@ export function SiteHeader() { > Winners + + Wrapped + Date: Sun, 15 Nov 2026 15:52:11 +0100 Subject: [PATCH 35/54] feat: title the filtered projects page and add a back button --- .../components/explorer/filter-heading.tsx | 60 +++++++++++++++++++ apps/web/src/pages/home.tsx | 14 +++++ 2 files changed, 74 insertions(+) create mode 100644 apps/web/src/components/explorer/filter-heading.tsx diff --git a/apps/web/src/components/explorer/filter-heading.tsx b/apps/web/src/components/explorer/filter-heading.tsx new file mode 100644 index 0000000..ed23b34 --- /dev/null +++ b/apps/web/src/components/explorer/filter-heading.tsx @@ -0,0 +1,60 @@ +import { ArrowLeftIcon } from 'lucide-react' +import { useMemo } from 'react' +import { Link, useLocation, useNavigate, useSearchParams } from 'react-router' + +import { Button } from '@/components/ui/button' +import { useAgents, useIntegrations, useProjects, useTools } from '@/hooks/use-projects' +import { formatNumber } from '@/lib/format' + +import { GROUPS, options } from './filter-options' +import { matches, readSelection } from './filters' + +export function FilterHeading() { + const [params] = useSearchParams() + const location = useLocation() + const navigate = useNavigate() + const { data: projects = [] } = useProjects() + const { data: integrations = [] } = useIntegrations() + const { data: tools = [] } = useTools() + const { data: agents = [] } = useAgents() + const selection = useMemo(() => readSelection(params), [params]) + + const groups = GROUPS.filter(({ key }) => selection[key].length > 0).map(({ key, title }) => { + const known = options(key, projects, integrations, tools, agents, selection) + return { + key, + title, + labels: selection[key].map( + (value) => known.find((option) => option.value === value)?.label ?? value, + ), + } + }) + const count = projects.filter((project) => matches(project, selection)).length + const canGoBack = location.key !== 'default' + + return ( +
    + {canGoBack ? ( + + ) : ( + + )} +

    + {groups.map((group, index) => ( + + {index > 0 && · } + {group.title}: + {group.labels.join(', ')} + + ))} +

    +

    + {formatNumber(count)} {count === 1 ? 'project matches' : 'projects match'} +

    +
    + ) +} diff --git a/apps/web/src/pages/home.tsx b/apps/web/src/pages/home.tsx index 56d2fc9..8b18d74 100644 --- a/apps/web/src/pages/home.tsx +++ b/apps/web/src/pages/home.tsx @@ -1,6 +1,10 @@ +import { useSearchParams } from 'react-router' + import { suggestionsFor } from '@/components/chat/page' import { useChatPanel } from '@/components/chat/use-chat-panel' import { Explorer } from '@/components/explorer/explorer' +import { FilterHeading } from '@/components/explorer/filter-heading' +import { readSelection, selectedCount } from '@/components/explorer/filters' import { Overview } from '@/components/overview' import { Button } from '@/components/ui/button' import { Skeleton } from '@/components/ui/skeleton' @@ -10,6 +14,16 @@ import { formatDateTime } from '@/lib/format' export function HomePage() { const { data } = useHackWindow() const { startChat } = useChatPanel() + const [params] = useSearchParams() + + if (selectedCount(readSelection(params)) > 0) { + return ( +
    + + +
    + ) + } return (
    From e1dfb6fef3f694e930b51269b0f4e0f0938c052b Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 15:55:12 +0100 Subject: [PATCH 36/54] feat: show a contributor's commits on a project card --- apps/web/src/components/explorer/project-card.tsx | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/apps/web/src/components/explorer/project-card.tsx b/apps/web/src/components/explorer/project-card.tsx index 40eb52d..a64eaf1 100644 --- a/apps/web/src/components/explorer/project-card.tsx +++ b/apps/web/src/components/explorer/project-card.tsx @@ -13,7 +13,7 @@ import type { Project } from '@/lib/types' const VISIBLE_TOPICS = 3 -export function ProjectCard({ project }: { project: Project }) { +export function ProjectCard({ project, commits }: { project: Project; commits?: number }) { const name = projectName(project.project_id) const topics = (project.topics ?? []).slice(0, VISIBLE_TOPICS) const { data: integrations = [] } = useIntegrations() @@ -65,6 +65,11 @@ export function ProjectCard({ project }: { project: Project }) { {project.description ?? 'No description'}

    + {commits !== undefined && ( + + {formatNumber(commits)} {commits === 1 ? 'commit' : 'commits'} + + )} {project.language && {project.language}} {project.stars !== null && project.stars > 0 && ( From 5c3e8e6d0011f666e9193564c5686621f2081396 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 15:55:12 +0100 Subject: [PATCH 37/54] feat: add the contributor profile page --- apps/web/src/app.tsx | 2 + apps/web/src/hooks/use-person.ts | 11 ++++ apps/web/src/lib/types.ts | 14 +++++ apps/web/src/pages/person.tsx | 97 ++++++++++++++++++++++++++++++++ 4 files changed, 124 insertions(+) create mode 100644 apps/web/src/hooks/use-person.ts create mode 100644 apps/web/src/pages/person.tsx diff --git a/apps/web/src/app.tsx b/apps/web/src/app.tsx index 7dca7d8..00ce521 100644 --- a/apps/web/src/app.tsx +++ b/apps/web/src/app.tsx @@ -8,6 +8,7 @@ import { SiteFooter } from '@/components/layout/site-footer' import { SiteHeader } from '@/components/layout/site-header' import { BuilderPage } from '@/pages/builder' import { HomePage } from '@/pages/home' +import { PersonPage } from '@/pages/person' import { ProjectPage } from '@/pages/project' import { WrappedPage } from '@/pages/wrapped' @@ -26,6 +27,7 @@ function Shell() { } /> } /> } /> + } /> diff --git a/apps/web/src/hooks/use-person.ts b/apps/web/src/hooks/use-person.ts new file mode 100644 index 0000000..fc70326 --- /dev/null +++ b/apps/web/src/hooks/use-person.ts @@ -0,0 +1,11 @@ +import { useQuery } from '@tanstack/react-query' + +import { apiGet } from '@/lib/api' +import type { Person } from '@/lib/types' + +export function usePerson(login: string) { + return useQuery({ + queryKey: ['person', login], + queryFn: () => apiGet(`/contributors/${encodeURIComponent(login)}`), + }) +} diff --git a/apps/web/src/lib/types.ts b/apps/web/src/lib/types.ts index ff26ed1..90d1c33 100644 --- a/apps/web/src/lib/types.ts +++ b/apps/web/src/lib/types.ts @@ -177,6 +177,20 @@ export interface Count { value: number } +export interface PersonProject { + project: Project + contributions: number +} + +export interface Person { + login: string + url: string + avatar_url: string | null + country: string | null + contributions: number + projects: PersonProject[] +} + export interface WrappedBuilder { login: string avatar_url: string | null diff --git a/apps/web/src/pages/person.tsx b/apps/web/src/pages/person.tsx new file mode 100644 index 0000000..cd6721f --- /dev/null +++ b/apps/web/src/pages/person.tsx @@ -0,0 +1,97 @@ +import { ArrowLeftIcon, ExternalLinkIcon } from 'lucide-react' +import { Link, useLocation, useNavigate, useParams } from 'react-router' + +import { ProjectCard } from '@/components/explorer/project-card' +import { DetailError } from '@/components/query-state' +import { Avatar, AvatarFallback, AvatarImage } from '@/components/ui/avatar' +import { Badge } from '@/components/ui/badge' +import { Button } from '@/components/ui/button' +import { Skeleton } from '@/components/ui/skeleton' +import { usePerson } from '@/hooks/use-person' +import { countryName, flagEmoji, formatNumber } from '@/lib/format' + +function PersonSkeleton() { + return ( +
    +
    + +
    + + +
    +
    +
    + + +
    +
    + ) +} + +export function PersonPage() { + const login = useParams().login ?? '' + const location = useLocation() + const navigate = useNavigate() + const { data, isPending, error } = usePerson(login) + + if (isPending) return + if (error) return + + const teams = data.projects.length + + return ( +
    +
    + {location.key !== 'default' ? ( + + ) : ( + + )} + +

    + + {formatNumber(data.contributions)} {data.contributions === 1 ? 'commit' : 'commits'} on{' '} + {teams} {teams === 1 ? 'project' : 'projects'} at HackMeridian 2026 + + {teams > 1 && On {teams} teams} +

    +
    +
    + {data.projects.map((item) => ( + + ))} +
    +
    + ) +} From 64592d4a037da47048cdbe2d52acea9812d4f8e7 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 15:55:12 +0100 Subject: [PATCH 38/54] feat: link builder avatars to their contributor profile --- apps/web/src/components/contributors.tsx | 7 ++++++- apps/web/src/components/wrapped/builder-avatars.tsx | 7 +++---- 2 files changed, 9 insertions(+), 5 deletions(-) diff --git a/apps/web/src/components/contributors.tsx b/apps/web/src/components/contributors.tsx index 148ca38..e259fe7 100644 --- a/apps/web/src/components/contributors.tsx +++ b/apps/web/src/components/contributors.tsx @@ -1,3 +1,5 @@ +import { Link } from 'react-router' + import { Avatar, AvatarFallback, AvatarImage } from '@/components/ui/avatar' import { Tooltip, TooltipContent, TooltipTrigger } from '@/components/ui/tooltip' import { flagEmoji } from '@/lib/format' @@ -14,7 +16,10 @@ export function Contributors({ contributors }: { contributors: Contributor[] }) + } > diff --git a/apps/web/src/components/wrapped/builder-avatars.tsx b/apps/web/src/components/wrapped/builder-avatars.tsx index 3a869af..0fa07d0 100644 --- a/apps/web/src/components/wrapped/builder-avatars.tsx +++ b/apps/web/src/components/wrapped/builder-avatars.tsx @@ -1,4 +1,5 @@ import { motion } from 'motion/react' +import { Link } from 'react-router' import { Avatar, AvatarFallback, AvatarImage } from '@/components/ui/avatar' import { Tooltip, TooltipContent, TooltipTrigger } from '@/components/ui/tooltip' @@ -28,10 +29,8 @@ export function BuilderAvatars({ builders, size = 'default', delay = 0 }: Builde From 056e55b7a1ba41a07e16d6136904483619eb649b Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 15:57:20 +0100 Subject: [PATCH 39/54] feat: filter projects by agent, language, country, activity and award --- apps/api/src/hackproof/queries.py | 38 +++++++++++++++++++++++++++---- 1 file changed, 34 insertions(+), 4 deletions(-) diff --git a/apps/api/src/hackproof/queries.py b/apps/api/src/hackproof/queries.py index 9c7ac2c..5f434a2 100644 --- a/apps/api/src/hackproof/queries.py +++ b/apps/api/src/hackproof/queries.py @@ -38,6 +38,14 @@ AND ($10::text[] IS NULL OR EXISTS ( SELECT 1 FROM repo_tools t WHERE t.full_name = p.full_name AND t.tool = ANY($10))) + AND ($11::text[] IS NULL OR EXISTS ( + SELECT 1 FROM repo_agents a + WHERE a.full_name = p.full_name AND a.agent = ANY($11))) + AND ($12::text[] IS NULL OR r.language = ANY($12)) + AND ($13::text[] IS NULL OR r.country = ANY($13)) + AND ($14::text[] IS NULL + OR ('contracts' = ANY($14) AND p.contracts > 0) + OR ('failed' = ANY($14) AND p.failed_txs > 0)) ORDER BY array_position( ARRAY['verified', 'likely', 'possible', 'unattributed'], p.tier), p.contracts DESC, p.classic_ops DESC, r.stars DESC NULLS LAST, p.last_activity DESC @@ -279,15 +287,37 @@ async def list_page( track: str | None = None, integrations: list[str] | None = None, tools: list[str] | None = None, + agents: list[str] | None = None, + languages: list[str] | None = None, + countries: list[str] | None = None, + activity: list[str] | None = None, + awards: list[str] | None = None, project_ids: list[str] | None = None, winners: bool = False, limit: int = 50, offset: int = 0, ) -> tuple[list[dict[str, Any]], int]: - awards = places() - winner_ids = project_ids or (list(awards) if winners else None) + placed = places() + wanted = project_ids + if wanted is None and (winners or awards): + wanted = [pid for pid, place in placed.items() if awards is None or place in awards] args = ( - (q, account, project_id, tiers, limit, offset, track, integrations, winner_ids, tools) + ( + q, + account, + project_id, + tiers, + limit, + offset, + track, + integrations, + wanted, + tools, + agents, + languages, + countries, + activity, + ) if resource == "projects" else (*window(), q, account, project_id, limit, offset) ) @@ -296,7 +326,7 @@ async def list_page( total = rows[0]["total"] if rows else 0 items = [{k: v for k, v in dict(row).items() if k != "total"} for row in rows] if resource == "projects": - items = [{**item, "award": awards.get(item["project_id"])} for item in items] + items = [{**item, "award": placed.get(item["project_id"])} for item in items] return items, total From c77829ee5b8188d2931e1784fd68bd9fb625898b Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 15:57:20 +0100 Subject: [PATCH 40/54] feat: give the chat the filtered view and every explorer filter --- apps/api/src/hackproof/chat/briefs.py | 131 ++++++++++++++++++- apps/api/src/hackproof/chat/system-prompt.md | 11 ++ apps/api/src/hackproof/chat/tools.py | 97 ++++---------- apps/api/tests/test_chat.py | 42 +++++- 4 files changed, 206 insertions(+), 75 deletions(-) diff --git a/apps/api/src/hackproof/chat/briefs.py b/apps/api/src/hackproof/chat/briefs.py index c96a277..7ca0416 100644 --- a/apps/api/src/hackproof/chat/briefs.py +++ b/apps/api/src/hackproof/chat/briefs.py @@ -1,21 +1,88 @@ import json +from collections import Counter from typing import Any, Literal -from pydantic import BaseModel +from pydantic import BaseModel, Field from pydantic_core import to_jsonable_python from hackproof import queries from hackproof.chat.prompts import prompt +from hackproof.hackathon import Place +from hackproof.schemas import Tier HEAVY_FIELDS = {"dependencies", "owner_avatar"} SAMPLE = 8 +STRICT: list[Tier] = ["verified", "likely"] -PageKind = Literal["home", "project", "builder"] +PageKind = Literal["home", "project", "builder", "filter"] +Track = Literal["genesis", "scale"] class Page(BaseModel): kind: PageKind id: str | None = None + filters: dict[str, list[str]] | None = None + + +class ProjectFilters(BaseModel): + tiers: list[Tier] | None = Field( + default=None, description="Evidence tiers to include; null means verified and likely" + ) + track: Track | None = Field( + default=None, + description="genesis (repo created inside the window) or scale (older repo); null for both", + ) + integrations: list[str] | None = Field( + default=None, + description="Partner slugs from get_integrations; keeps projects using any of them", + ) + tools: list[str] | None = Field( + default=None, + description="Stellar tooling slugs from get_tools; keeps projects using any of them", + ) + agents: list[str] | None = Field( + default=None, + description="AI coding agent slugs from get_agents; keeps projects showing any of them", + ) + languages: list[str] | None = Field( + default=None, description="Primary repo languages, such as TypeScript or Rust" + ) + countries: list[str] | None = Field( + default=None, description="ISO 3166-1 alpha-2 codes of the repo owner's country" + ) + activity: list[Literal["contracts", "failed"]] | None = Field( + default=None, + description="contracts keeps projects that deployed contracts; failed keeps projects " + "with failed transactions", + ) + awards: list[Place] | None = Field( + default=None, description="first or runner-up keeps projects that won that award" + ) + + def list_args(self) -> dict[str, Any]: + return { + "tiers": self.tiers or STRICT, + "track": self.track, + "integrations": self.integrations, + "tools": self.tools, + "agents": self.agents, + "languages": self.languages, + "countries": self.countries, + "activity": self.activity, + "awards": self.awards, + } + + +PAGE_FILTERS = { + "tier": "tiers", + "partner": "integrations", + "tool": "tools", + "agent": "agents", + "language": "languages", + "country": "countries", + "activity": "activity", + "award": "awards", +} def slim(items: list[dict[str, Any]]) -> list[dict[str, Any]]: @@ -78,11 +145,71 @@ async def builder_brief(address: str) -> dict[str, Any] | None: ) +def _top(counter: Counter[str], size: int) -> list[dict[str, Any]]: + return [{"name": name, "projects": count} for name, count in counter.most_common(size)] + + +async def summarize_view(filters: ProjectFilters) -> dict[str, Any]: + items, total = await queries.list_page("projects", **filters.list_args(), limit=10_000) + topics: Counter[str] = Counter() + stack: Counter[str] = Counter() + partners: Counter[str] = Counter() + tooling: Counter[str] = Counter() + agents: Counter[str] = Counter() + for item in items: + topics.update(topic.lower() for topic in item["topics"] or []) + stack.update(list((item["dependencies"] or {}).get("packages", {}))) + partners.update(item["integrations"]) + tooling.update(item["tools"]) + agents.update(item["agents"]) + return { + "total": total, + "by_tier": dict(Counter(item["tier"] for item in items)), + "by_track": dict(Counter(item["track"] for item in items)), + "contracts": sum(item["contracts"] for item in items), + "wasm_uploads": sum(item["wasm_uploads"] for item in items), + "languages": _top(Counter(item["language"] for item in items if item["language"]), 10), + "topics": _top(topics, 20), + "stellar_packages": _top(stack, 15), + "integrations": _top(partners, 15), + "stellar_tooling": _top(tooling, 10), + "ai_agents": _top(agents, 10), + "countries": _top(Counter(item["country"] for item in items if item["country"]), 10), + "descriptions": [ + {"project_id": item["project_id"], "description": item["description"][:140]} + for item in items + if item["description"] + ][:25], + } + + +def view_filters(selected: dict[str, list[str]]) -> ProjectFilters: + known = { + PAGE_FILTERS[key]: values[:20] for key, values in selected.items() if key in PAGE_FILTERS + } + tracks = selected.get("track", []) + return ProjectFilters.model_validate( + {**known, "track": tracks[0] if len(tracks) == 1 else None} + ) + + +async def filter_brief(selected: dict[str, list[str]]) -> str: + filters = view_filters(selected) + summary = await summarize_view(filters) + return prompt( + "page-filter", + filters=json.dumps(selected), + data=json.dumps(to_jsonable_python(summary), default=str), + ) + + async def describe_page(page: Page | None) -> str: if page is None: return "" if page.kind == "home": return prompt("page-home") + if page.kind == "filter": + return await filter_brief(page.filters or {}) if not page.id: return "" diff --git a/apps/api/src/hackproof/chat/system-prompt.md b/apps/api/src/hackproof/chat/system-prompt.md index d1b0dbb..7cd776b 100644 --- a/apps/api/src/hackproof/chat/system-prompt.md +++ b/apps/api/src/hackproof/chat/system-prompt.md @@ -38,6 +38,10 @@ Track is inferred, not declared. A project is genesis when its repo was created Integrations: each project has integrations, the slugs of Stellar ecosystem partners from the SCF integration list that its code uses. A partner is detected from a package in a dependency manifest in any language, or from the partner's API host in source or config. These are evidence of use, not of a working integration. +Stellar tooling: each project has tools, the slugs of Stellar developer tools it uses: Scaffold Stellar, Stellar Registry, Stellar Raven (Stellar's own assistant, detected from its MCP endpoint in agent config) and Stellar Skills. Detection reads manifests and hosts in code and config. + +AI agents: each project has agents, the slugs of AI coding agents it shows traces of. Detection reads agent config files in the repo, such as CLAUDE.md, .cursor or .codex, and commit authors such as the claude or cursoragent accounts. AGENTS.md is a convention several tools share, so it is not one tool. This is a lower bound: a team that used an agent without leaving a trace is not counted, so never say how many teams did not use AI. + Other fields: contracts, wasm_uploads, failed_txs and classic_ops count on chain activity inside the window. builders is the number of deploy accounts. window_commits and total_commits come from GitHub. stack lists the Stellar packages the repo declares. topics are the GitHub topics the team chose. country comes from the owner's public GitHub location and is often missing. ### How to work @@ -45,6 +49,7 @@ Other fields: contracts, wasm_uploads, failed_txs and classic_ops count on chain - Use the tools for every fact and number. Never guess, and never estimate a count by counting rows yourself. Use the total returned by a tool. - For questions about what projects are about, how many there are, or any breakdown by track, tier, language, topic or stack, call summarize_projects first. It aggregates over every matching project. Then call query_projects to show examples. - For questions about which projects use a partner such as Trustless Work, Privy, Soroswap or Stellar Wallets Kit, call get_integrations for the slugs and counts, then query_projects with integrations set. Say that detection reads dependency manifests and API hosts in code, so a project that only mentions a partner in prose is not counted. +- For questions about Stellar tools, call get_tools for the slugs and counts. For questions about AI agents, call get_agents. Then pass the slugs as tools or agents to query_projects or summarize_projects. Both tools also filter by languages, countries, activity and awards. - For one project call get_project. For one deploy account call get_builder. For counts and the headline numbers call get_stats. For activity over time call get_timeline. For geography call get_countries. - Searching with q matches project ids and descriptions only. It is not a way to filter by track or tier. Use the track and tiers arguments. - Several independent tool calls can go in one turn. Do that instead of one at a time. @@ -75,3 +80,9 @@ The user is on the page for {subject}. Read "{pronoun}", "it" and "here" as this ## page-empty The user is on the page for {subject}, which has no data inside the hack window. + +## page-filter + +The user is on the home page, looking at the explorer filtered by {filters}. The keys are the site's filter names: tier, track, award, partner (the integrations argument), tool, agent, language, country and activity. Read "these projects", "this view", "they" and "them" as the projects matching exactly those filters, and keep every tool call inside them by passing the same filters. A summary of the matching set is already loaded below, so do not fetch it again for basic questions. + +{data} diff --git a/apps/api/src/hackproof/chat/tools.py b/apps/api/src/hackproof/chat/tools.py index 532ef81..d6ce2e9 100644 --- a/apps/api/src/hackproof/chat/tools.py +++ b/apps/api/src/hackproof/chat/tools.py @@ -1,15 +1,11 @@ -from collections import Counter -from typing import Annotated, Any, Literal +from typing import Annotated, Any from pydantic import BaseModel, Field from pydantic_core import to_jsonable_python from hackproof import queries -from hackproof.chat.briefs import builder_brief, project_brief, slim -from hackproof.schemas import Tier +from hackproof.chat.briefs import ProjectFilters, builder_brief, project_brief, slim, summarize_view -Track = Literal["genesis", "scale"] -STRICT = ["verified", "likely"] WEB_SEARCH = {"type": "web_search_20250305", "name": "web_search", "max_uses": 3} Limit = Annotated[int, Field(ge=1, le=25, description="Rows to return")] @@ -19,22 +15,11 @@ ] -class QueryProjects(BaseModel): +class QueryProjects(ProjectFilters): """Find HackMeridian projects. Ordered by evidence strength, then on-chain activity. Each project has an award field: first, runner-up, or null.""" q: Search = None - tiers: list[Tier] | None = Field( - default=None, description="Evidence tiers to include; null means verified and likely" - ) - track: Track | None = Field( - default=None, - description="genesis (repo created inside the window) or scale (older repo); null for both", - ) - integrations: list[str] | None = Field( - default=None, - description="Partner slugs from get_integrations; keeps projects using any of them", - ) winners: bool = Field( default=False, description="True keeps only the HackMeridian award winners: first place and runner-ups", @@ -71,19 +56,10 @@ class QueryFailed(BaseModel): offset: Offset = 0 -class SummarizeProjects(BaseModel): +class SummarizeProjects(ProjectFilters): """Aggregate every matching project: counts by tier and track, on chain totals, top - languages, topics, Stellar packages and countries, plus a sample of descriptions. Use this - for any breakdown or "what are they building" question.""" - - tiers: list[Tier] | None = Field( - default=None, description="Evidence tiers to include; null means verified and likely" - ) - track: Track | None = Field(default=None, description="genesis, scale, or null for both") - integrations: list[str] | None = Field( - default=None, - description="Partner slugs from get_integrations; keeps projects using any of them", - ) + languages, topics, Stellar packages, integrations, tooling, AI agents and countries, plus a + sample of descriptions. Use this for any breakdown or "what are they building" question.""" class GetProject(BaseModel): @@ -104,6 +80,17 @@ class GetIntegrations(BaseModel): hosts in code, not from READMEs.""" +class GetTools(BaseModel): + """List the Stellar developer tools we detect (such as Scaffold Stellar, Stellar Registry, + Stellar Raven and Stellar Skills) with how many verified and likely projects use each.""" + + +class GetAgents(BaseModel): + """List the AI coding agents we detect (slug, name) with how many verified and likely projects + show each. Detection reads agent config files such as CLAUDE.md or .cursor and commit authors, + so it is a lower bound: a tool that leaves no trace is not counted.""" + + class GetStats(BaseModel): """Headline counts: projects by tier, contracts, builders, contributors, countries.""" @@ -125,6 +112,8 @@ class GetCountries(BaseModel): "get_project": GetProject, "get_builder": GetBuilder, "get_integrations": GetIntegrations, + "get_tools": GetTools, + "get_agents": GetAgents, "get_stats": GetStats, "get_timeline": GetTimeline, "get_countries": GetCountries, @@ -140,54 +129,14 @@ class GetCountries(BaseModel): ] -def _top(counter: Counter[str], size: int) -> list[dict[str, Any]]: - return [{"name": name, "projects": count} for name, count in counter.most_common(size)] - - -async def summarize(args: SummarizeProjects) -> dict[str, Any]: - items, total = await queries.list_page( - "projects", - tiers=args.tiers or STRICT, - track=args.track, - integrations=args.integrations, - limit=10_000, - ) - topics: Counter[str] = Counter() - stack: Counter[str] = Counter() - partners: Counter[str] = Counter() - for item in items: - topics.update(topic.lower() for topic in item["topics"] or []) - stack.update(list((item["dependencies"] or {}).get("packages", {}))) - partners.update(item["integrations"]) - return { - "total": total, - "by_tier": dict(Counter(item["tier"] for item in items)), - "by_track": dict(Counter(item["track"] for item in items)), - "contracts": sum(item["contracts"] for item in items), - "wasm_uploads": sum(item["wasm_uploads"] for item in items), - "languages": _top(Counter(item["language"] for item in items if item["language"]), 10), - "topics": _top(topics, 20), - "stellar_packages": _top(stack, 15), - "integrations": _top(partners, 15), - "countries": _top(Counter(item["country"] for item in items if item["country"]), 10), - "descriptions": [ - {"project_id": item["project_id"], "description": item["description"][:140]} - for item in items - if item["description"] - ][:25], - } - - async def run_tool(name: str, raw: dict[str, Any]) -> Any: args = TOOLS[name].model_validate(raw) match args: case QueryProjects(): items, total = await queries.list_page( "projects", + **args.list_args(), q=args.q, - tiers=args.tiers or STRICT, - track=args.track, - integrations=args.integrations, winners=args.winners, limit=args.limit, offset=args.offset, @@ -210,13 +159,17 @@ async def run_tool(name: str, raw: dict[str, Any]) -> Any: "failed", q=args.q, account=args.account, limit=args.limit, offset=args.offset ) case SummarizeProjects(): - return to_jsonable_python(await summarize(args)) + return to_jsonable_python(await summarize_view(args)) case GetProject(): return await project_brief(args.project_id) or {"error": "project not found"} case GetBuilder(): return await builder_brief(args.address) or {"error": "no activity in the hack window"} case GetIntegrations(): return to_jsonable_python(await queries.fetch_integrations()) + case GetTools(): + return to_jsonable_python(await queries.fetch_tools()) + case GetAgents(): + return to_jsonable_python(await queries.fetch_agents()) case GetStats(): return to_jsonable_python(await queries.fetch_stats()) case GetTimeline(): diff --git a/apps/api/tests/test_chat.py b/apps/api/tests/test_chat.py index f6bcbbf..a7106ae 100644 --- a/apps/api/tests/test_chat.py +++ b/apps/api/tests/test_chat.py @@ -4,11 +4,14 @@ import pytest from fastapi.testclient import TestClient +from hackproof import queries from hackproof.chat import routes, stream +from hackproof.chat.briefs import Page, describe_page, view_filters from hackproof.chat.prompts import prompt, sections from hackproof.chat.ratelimit import RateLimiter from hackproof.chat.stream import Message, Part, stream_reply, to_anthropic, web_search_events from hackproof.chat.tools import TOOL_SPECS, run_tool +from hackproof.db import close_pool, open_pool from hackproof.main import app @@ -169,7 +172,7 @@ async def fake_stream(client, model, messages, page=""): def test_prompt_file_has_every_section(): - assert set(sections()) == {"system", "page-home", "page-entity", "page-empty"} + assert set(sections()) == {"system", "page-home", "page-entity", "page-empty", "page-filter"} text = prompt("system", start="A", end="B", page="ON THE HOME PAGE") assert "A to B UTC" in text and text.endswith("ON THE HOME PAGE") assert "{" not in text @@ -190,3 +193,40 @@ def test_project_tools_can_filter_by_integration_partner(): assert "get_integrations" in specs for name in ("query_projects", "summarize_projects"): assert "integrations" in specs[name]["input_schema"]["properties"] + + +def test_project_tools_filter_by_every_explorer_filter(): + specs = {spec["name"]: spec for spec in TOOL_SPECS} + + assert {"get_tools", "get_agents"} <= set(specs) + for name in ("query_projects", "summarize_projects"): + properties = specs[name]["input_schema"]["properties"] + assert {"tools", "agents", "languages", "countries", "activity", "awards"} <= set( + properties + ) + + +def test_explorer_filters_map_onto_the_project_filters(): + filters = view_filters( + {"agent": ["cursor"], "partner": ["freighter"], "track": ["scale"], "tier": ["verified"]} + ) + + assert filters.agents == ["cursor"] + assert filters.integrations == ["freighter"] + assert filters.track == "scale" + assert filters.list_args()["tiers"] == ["verified"] + assert view_filters({"track": ["genesis", "scale"]}).track is None + assert view_filters({"nonsense": ["x"]}).list_args()["tiers"] == ["verified", "likely"] + + +async def test_the_filter_page_brief_counts_the_matching_projects(): + await open_pool() + try: + brief = await describe_page(Page(kind="filter", filters={"agent": ["cursor"]})) + agents = await queries.fetch_agents() + finally: + await close_pool() + + expected = next(agent for agent in agents if agent["slug"] == "cursor")["projects"] + assert f'"total": {expected},' in brief + assert '{"agent": ["cursor"]}' in brief From 4baa94637fb9e4d564711c9376482cb74b15ed5b Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 16:00:17 +0100 Subject: [PATCH 41/54] feat: give each filter a list of suggested questions --- .../src/components/explorer/filter-options.ts | 171 +++++++++++++++++- .../explorer/use-selected-groups.ts | 22 +++ 2 files changed, 183 insertions(+), 10 deletions(-) create mode 100644 apps/web/src/components/explorer/use-selected-groups.ts diff --git a/apps/web/src/components/explorer/filter-options.ts b/apps/web/src/components/explorer/filter-options.ts index 336a8d3..33b8cbd 100644 --- a/apps/web/src/components/explorer/filter-options.ts +++ b/apps/web/src/components/explorer/filter-options.ts @@ -64,14 +64,165 @@ export function options( .sort((a, b) => (key in FIXED ? 0 : b.count - a.count || a.label.localeCompare(b.label))) } -export const GROUPS: { key: FilterKey; title: string; collapsible: boolean }[] = [ - { key: 'award', title: 'Awards', collapsible: false }, - { key: 'tier', title: 'Evidence', collapsible: false }, - { key: 'track', title: 'Track', collapsible: false }, - { key: 'partner', title: 'Integrations', collapsible: true }, - { key: 'tool', title: 'Ecosystem tooling', collapsible: false }, - { key: 'agent', title: 'AI coding agents', collapsible: false }, - { key: 'activity', title: 'On-chain activity', collapsible: false }, - { key: 'language', title: 'Language', collapsible: true }, - { key: 'country', title: 'Country', collapsible: true }, +export interface FilterGroup { + key: FilterKey + title: string + collapsible: boolean + questions: string[] +} + +export const GROUPS: FilterGroup[] = [ + { + key: 'award', + title: 'Awards', + collapsible: false, + questions: [ + 'What did the projects awarded {label} build?', + 'What do the {label} winners have in common?', + 'How did the {label} winners compare with everyone else on chain?', + 'Which Stellar tools and partners did the {label} winners use?', + ], + }, + { + key: 'tier', + title: 'Evidence', + collapsible: false, + questions: [ + 'What are the projects with {label} evidence building?', + 'What separates the {label} projects from the rest?', + 'Which partners and tools show up most among the {label} projects?', + 'How many contracts did the {label} projects deploy?', + ], + }, + { + key: 'track', + title: 'Track', + collapsible: false, + questions: [ + 'What did the {label} projects build?', + 'How do the {label} projects compare with the other track on chain?', + 'Which {label} projects stand out, and why?', + 'What stack do the {label} projects use?', + ], + }, + { + key: 'partner', + title: 'Integrations', + collapsible: true, + questions: [ + 'What did the teams using {label} build?', + 'How did these projects use {label}? Show the evidence.', + 'Which other partners and tools do they combine with {label}?', + 'Did the {label} projects deploy more contracts than the rest?', + ], + }, + { + key: 'tool', + title: 'Ecosystem tooling', + collapsible: false, + questions: [ + 'What did the teams using {label} build?', + 'How did these projects use {label}?', + 'Which partners do the {label} projects pair it with?', + 'How many of the {label} projects won an award?', + ], + }, + { + key: 'agent', + title: 'AI coding agents', + collapsible: false, + questions: [ + 'What did the teams using {label} build?', + 'Which {label} projects deployed the most contracts?', + 'Did the {label} projects do better than the rest?', + 'How do we detect {label} in a repo, and what does that miss?', + ], + }, + { + key: 'activity', + title: 'On-chain activity', + collapsible: false, + questions: [ + 'What do the projects with {label} build?', + 'Which projects had the most {label}?', + 'Do projects with {label} win more often?', + ], + }, + { + key: 'language', + title: 'Language', + collapsible: true, + questions: [ + 'What did the {label} projects build?', + 'Which Stellar SDKs and tools do the {label} projects use?', + 'How do the {label} projects compare with the other languages?', + 'Which {label} projects deployed the most contracts?', + ], + }, + { + key: 'country', + title: 'Country', + collapsible: true, + questions: [ + 'What did builders in {label} build?', + 'Which Stellar tools did the teams from {label} use?', + 'How many contracts did the projects from {label} deploy?', + 'Did any projects from {label} win an award?', + ], + }, ] + +export const VIEW_QUESTIONS = [ + 'Summarize the projects in this view', + 'Which of these projects stand out, and why?', + 'What do these projects have in common?', +] + +const SUGGESTION_LIMIT = 5 + +const FLAG = /^\p{Regional_Indicator}+\s*/u + +export function joinLabels(labels: string[]) { + const plain = labels.map((label) => label.replace(FLAG, '')) + if (plain.length < 2) return plain.join('') + return `${plain.slice(0, -1).join(', ')} or ${plain[plain.length - 1]}` +} + +export interface SelectedGroup { + key: FilterKey + title: string + labels: string[] + questions: string[] +} + +export function selectedGroups( + selection: Selection, + projects: Project[], + integrations: Integration[], + tools: EcosystemTool[], + agents: AiAgent[], +): SelectedGroup[] { + return GROUPS.filter(({ key }) => selection[key].length > 0).map(({ key, title, questions }) => { + const known = options(key, projects, integrations, tools, agents, selection) + return { + key, + title, + questions, + labels: selection[key].map( + (value) => known.find((option) => option.value === value)?.label ?? value, + ), + } + }) +} + +export function filterQuestions(groups: SelectedGroup[]) { + const fill = (group: SelectedGroup, question: string) => + question.replaceAll('{label}', joinLabels(group.labels)) + const firsts = groups.map((group) => fill(group, group.questions[0])) + const rest = groups.flatMap((group) => group.questions.slice(1).map((q) => fill(group, q))) + const [summary, ...more] = VIEW_QUESTIONS + const ordered = + groups.length > 1 ? [summary, ...firsts, ...rest, ...more] : [...firsts, ...rest, summary] + + return [...new Set(ordered)].slice(0, SUGGESTION_LIMIT) +} diff --git a/apps/web/src/components/explorer/use-selected-groups.ts b/apps/web/src/components/explorer/use-selected-groups.ts new file mode 100644 index 0000000..9b2befb --- /dev/null +++ b/apps/web/src/components/explorer/use-selected-groups.ts @@ -0,0 +1,22 @@ +import { useMemo } from 'react' +import { useSearchParams } from 'react-router' + +import { useAgents, useIntegrations, useProjects, useTools } from '@/hooks/use-projects' + +import { selectedGroups } from './filter-options' +import { readSelection } from './filters' + +export function useSelectedGroups() { + const [params] = useSearchParams() + const { data: projects = [] } = useProjects() + const { data: integrations = [] } = useIntegrations() + const { data: tools = [] } = useTools() + const { data: agents = [] } = useAgents() + const selection = useMemo(() => readSelection(params), [params]) + + return { + selection, + projects, + groups: selectedGroups(selection, projects, integrations, tools, agents), + } +} From 0416df7ce846f2ad61d359b0ea71f28bbd7422fc Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 16:00:17 +0100 Subject: [PATCH 42/54] feat: suggest questions on the filtered projects page --- .../components/explorer/filter-heading.tsx | 42 +++++++++---------- 1 file changed, 20 insertions(+), 22 deletions(-) diff --git a/apps/web/src/components/explorer/filter-heading.tsx b/apps/web/src/components/explorer/filter-heading.tsx index ed23b34..5cc5718 100644 --- a/apps/web/src/components/explorer/filter-heading.tsx +++ b/apps/web/src/components/explorer/filter-heading.tsx @@ -1,34 +1,19 @@ import { ArrowLeftIcon } from 'lucide-react' -import { useMemo } from 'react' -import { Link, useLocation, useNavigate, useSearchParams } from 'react-router' +import { Link, useLocation, useNavigate } from 'react-router' +import { useChatPanel } from '@/components/chat/use-chat-panel' import { Button } from '@/components/ui/button' -import { useAgents, useIntegrations, useProjects, useTools } from '@/hooks/use-projects' import { formatNumber } from '@/lib/format' -import { GROUPS, options } from './filter-options' -import { matches, readSelection } from './filters' +import { filterQuestions } from './filter-options' +import { matches } from './filters' +import { useSelectedGroups } from './use-selected-groups' export function FilterHeading() { - const [params] = useSearchParams() const location = useLocation() const navigate = useNavigate() - const { data: projects = [] } = useProjects() - const { data: integrations = [] } = useIntegrations() - const { data: tools = [] } = useTools() - const { data: agents = [] } = useAgents() - const selection = useMemo(() => readSelection(params), [params]) - - const groups = GROUPS.filter(({ key }) => selection[key].length > 0).map(({ key, title }) => { - const known = options(key, projects, integrations, tools, agents, selection) - return { - key, - title, - labels: selection[key].map( - (value) => known.find((option) => option.value === value)?.label ?? value, - ), - } - }) + const { startChat } = useChatPanel() + const { selection, projects, groups } = useSelectedGroups() const count = projects.filter((project) => matches(project, selection)).length const canGoBack = location.key !== 'default' @@ -55,6 +40,19 @@ export function FilterHeading() {

    {formatNumber(count)} {count === 1 ? 'project matches' : 'projects match'}

    +
    + {filterQuestions(groups).map((question) => ( + + ))} +

    ) } From 7cf338a36aa860698766d30b06066b83f66e4224 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 16:00:17 +0100 Subject: [PATCH 43/54] feat: send the active filters to the chat and suggest questions for them --- apps/web/src/components/chat/chat-thread.tsx | 6 ++++-- apps/web/src/components/chat/page.ts | 20 +++++++++++++++---- .../src/components/chat/use-suggestions.ts | 13 ++++++++++++ 3 files changed, 33 insertions(+), 6 deletions(-) create mode 100644 apps/web/src/components/chat/use-suggestions.ts diff --git a/apps/web/src/components/chat/chat-thread.tsx b/apps/web/src/components/chat/chat-thread.tsx index 2f8ad63..4de45ef 100644 --- a/apps/web/src/components/chat/chat-thread.tsx +++ b/apps/web/src/components/chat/chat-thread.tsx @@ -5,12 +5,14 @@ import { ChatError } from '@/components/chat/chat-error' import { ChatMessages } from '@/components/chat/chat-messages' import { PromptBox } from '@/components/chat/prompt-box' import { sessionTitle } from '@/components/chat/session' -import { currentPage, suggestionsFor } from '@/components/chat/page' import { RateLimitError, transport } from '@/components/chat/transport' +import { useSuggestions } from '@/components/chat/use-suggestions' import { useChatPanel } from '@/components/chat/use-chat-panel' import { Button } from '@/components/ui/button' function EmptyThread({ onPick }: { onPick: (text: string) => void }) { + const suggestions = useSuggestions() + return (
    @@ -22,7 +24,7 @@ function EmptyThread({ onPick }: { onPick: (text: string) => void }) {

    - {suggestionsFor(currentPage().kind).map((suggestion) => ( + {suggestions.map((suggestion) => ( )}

    - {groups.map((group, index) => ( - - {index > 0 && · } - {group.title}: - {group.labels.join(', ')} + {EVENT_NAME} projects + {clauses.map((clause, index) => ( + + + {separator(index, clauses.length)} + {clause.before} + + {clause.label} + {clause.after} ))}

    - {formatNumber(count)} {count === 1 ? 'project matches' : 'projects match'} + {formatNumber(count)} of {formatNumber(projects.length)} projects match

    {filterQuestions(groups).map((question) => ( From 9c8583cd7f15b8dbcc1d38254368a7fa7e9b3dd8 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 16:05:04 +0100 Subject: [PATCH 47/54] feat: name the event on the builder page --- apps/web/src/pages/person.tsx | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/apps/web/src/pages/person.tsx b/apps/web/src/pages/person.tsx index cd6721f..af63dd9 100644 --- a/apps/web/src/pages/person.tsx +++ b/apps/web/src/pages/person.tsx @@ -8,6 +8,7 @@ import { Badge } from '@/components/ui/badge' import { Button } from '@/components/ui/button' import { Skeleton } from '@/components/ui/skeleton' import { usePerson } from '@/hooks/use-person' +import { EVENT_NAME } from '@/lib/config' import { countryName, flagEmoji, formatNumber } from '@/lib/format' function PersonSkeleton() { @@ -57,6 +58,9 @@ export function PersonPage() { {data.login.slice(0, 2).toUpperCase()}
    +

    + {EVENT_NAME} builder +

    {data.login}

    {data.country && ( @@ -78,7 +82,7 @@ export function PersonPage() {

    {formatNumber(data.contributions)} {data.contributions === 1 ? 'commit' : 'commits'} on{' '} - {teams} {teams === 1 ? 'project' : 'projects'} at HackMeridian 2026 + {teams} {teams === 1 ? 'project' : 'projects'} at {EVENT_NAME} {teams > 1 && On {teams} teams}

    From 0711a03bf4d7d96d17847dd51af0fa58fe488a2c Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 16:05:37 +0100 Subject: [PATCH 48/54] feat: show the contributors first and open on the project page --- apps/web/src/pages/project.tsx | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/apps/web/src/pages/project.tsx b/apps/web/src/pages/project.tsx index b3a9ef9..751fea6 100644 --- a/apps/web/src/pages/project.tsx +++ b/apps/web/src/pages/project.tsx @@ -144,7 +144,12 @@ export function ProjectPage() {
    )} - + + {contributors.length > 0 && ( +
    + +
    + )} {integration_uses.length > 0 && (
    )} - {contributors.length > 0 && ( -
    - -
    - )} {direct.length > 0 && (
    Date: Sun, 15 Nov 2026 16:08:06 +0100 Subject: [PATCH 49/54] feat: add a command that checks the database against the committed data files --- apps/api/src/hackproof/cli.py | 7 +++++- apps/api/src/hackproof/export/check.py | 14 +++++++++++ apps/api/src/hackproof/export/jobs.py | 34 +++++++++++++++++++++++++- apps/api/tests/test_export_check.py | 28 +++++++++++++++++++++ 4 files changed, 81 insertions(+), 2 deletions(-) create mode 100644 apps/api/src/hackproof/export/check.py create mode 100644 apps/api/tests/test_export_check.py diff --git a/apps/api/src/hackproof/cli.py b/apps/api/src/hackproof/cli.py index 2afb2dd..1ab4ed8 100644 --- a/apps/api/src/hackproof/cli.py +++ b/apps/api/src/hackproof/cli.py @@ -2,7 +2,7 @@ import asyncio import logging -from hackproof.export.jobs import run_export +from hackproof.export.jobs import run_check, run_export from hackproof.github.jobs import run_discover, run_scan from hackproof.indexer.sync import run_sync from hackproof.linking.reconcile import run_reconcile @@ -23,6 +23,9 @@ def main() -> None: ) commands.add_parser("reconcile", help="link chain activity to repos and build projects") commands.add_parser("export", help="write one yaml file per project into data and its schema") + commands.add_parser( + "check", help="check, read-only, that the database matches the committed data files" + ) args = parser.parse_args() logging.basicConfig(level=logging.INFO, format="%(asctime)s %(message)s") @@ -38,3 +41,5 @@ def main() -> None: asyncio.run(run_reconcile()) case "export": asyncio.run(run_export()) + case "check": + raise SystemExit(asyncio.run(run_check())) diff --git a/apps/api/src/hackproof/export/check.py b/apps/api/src/hackproof/export/check.py new file mode 100644 index 0000000..d498586 --- /dev/null +++ b/apps/api/src/hackproof/export/check.py @@ -0,0 +1,14 @@ +from pathlib import Path + + +def drift(generated: Path, committed: Path) -> list[str]: + ours = {path.relative_to(generated) for path in generated.rglob("*.yml")} + theirs = {path.relative_to(committed) for path in committed.rglob("*.yml")} + found = [f"only in the files: {name}" for name in sorted(theirs - ours)] + found += [f"only in the database: {name}" for name in sorted(ours - theirs)] + found += [ + f"differs: {name}" + for name in sorted(ours & theirs) + if (generated / name).read_bytes() != (committed / name).read_bytes() + ] + return found diff --git a/apps/api/src/hackproof/export/jobs.py b/apps/api/src/hackproof/export/jobs.py index 7e543f6..f5c4cb4 100644 --- a/apps/api/src/hackproof/export/jobs.py +++ b/apps/api/src/hackproof/export/jobs.py @@ -1,8 +1,14 @@ +import json import logging +from pathlib import Path +from tempfile import TemporaryDirectory -from hackproof.config import ROOT +import asyncpg + +from hackproof.config import ROOT, get_settings from hackproof.db import open_pool, pool from hackproof.export.build import build_export +from hackproof.export.check import drift from hackproof.export.files import write_project_files from hackproof.hackathon import get_hackathon @@ -19,3 +25,29 @@ async def run_export() -> None: count = write_project_files(export, DATA) log.info("wrote %s project files to %s", count, DATA / str(export.hackathon.starts_at.year)) + + +async def run_check() -> int: + hackathon = get_hackathon() + connection = await asyncpg.connect( + get_settings().database_url, server_settings={"default_transaction_read_only": "on"} + ) + await connection.set_type_codec( + "jsonb", encoder=json.dumps, decoder=json.loads, schema="pg_catalog" + ) + try: + export = await build_export(connection, hackathon) + finally: + await connection.close() + + with TemporaryDirectory() as directory: + write_project_files(export, Path(directory)) + found = drift(Path(directory), DATA) + + for line in found: + log.warning(line) + if found: + log.warning("%s files differ from the database", len(found)) + else: + log.info("in sync: the database matches all %s project files", len(export.projects)) + return 1 if found else 0 diff --git a/apps/api/tests/test_export_check.py b/apps/api/tests/test_export_check.py new file mode 100644 index 0000000..02723a5 --- /dev/null +++ b/apps/api/tests/test_export_check.py @@ -0,0 +1,28 @@ +from pathlib import Path + +from hackproof.export.check import drift + + +def write(root: Path, files: dict[str, str]) -> Path: + for name, text in files.items(): + path = root / name + path.parent.mkdir(parents=True, exist_ok=True) + path.write_text(text) + return root + + +def test_identical_files_have_no_drift(tmp_path): + files = {"2026/a.yml": "x: 1\n", "schema.yml": "y: 2\n"} + + assert drift(write(tmp_path / "db", files), write(tmp_path / "repo", files)) == [] + + +def test_drift_names_missing_extra_and_changed_files(tmp_path): + database = write(tmp_path / "db", {"2026/a.yml": "x: 1\n", "2026/new.yml": "n: 1\n"}) + committed = write(tmp_path / "repo", {"2026/a.yml": "x: 2\n", "2026/old.yml": "o: 1\n"}) + + assert drift(database, committed) == [ + "only in the files: 2026/old.yml", + "only in the database: 2026/new.yml", + "differs: 2026/a.yml", + ] From 038212cddcf3e8728e89ed29606aabbbe3074674 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 16:08:06 +0100 Subject: [PATCH 50/54] docs: describe the check command --- data/README.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/data/README.md b/data/README.md index a12bbdf..1755b9c 100644 --- a/data/README.md +++ b/data/README.md @@ -88,6 +88,13 @@ often or are personal. `true` only when the team states its track in its own docs, and `track` is then that value. `false` means the team did not say, and `track` is the default `genesis`, an assumption and not a fact. +## Keeping the files in sync + +The files are written from the database with `uv run hackproof export` in `apps/api`. To check that +a database still matches the committed files, run `uv run hackproof check`. It rebuilds every file in +a read-only session and lists the ones that differ, and it exits with `1` when any do. Point +`DATABASE_URL` at another database to check that one instead. + ## Privacy Public GitHub handles and public repo facts only. No emails, avatars, locations or other personal From 5563a97c9885c44324517c06e55e25d4acda46d0 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 16:09:37 +0100 Subject: [PATCH 51/54] feat: list the projects of each wrapped builder --- apps/api/src/hackproof/queries.py | 3 ++- apps/api/src/hackproof/schemas.py | 1 + apps/api/tests/test_api.py | 4 ++++ 3 files changed, 7 insertions(+), 1 deletion(-) diff --git a/apps/api/src/hackproof/queries.py b/apps/api/src/hackproof/queries.py index 5f434a2..30b6cac 100644 --- a/apps/api/src/hackproof/queries.py +++ b/apps/api/src/hackproof/queries.py @@ -253,7 +253,8 @@ WRAPPED_BUILDERS_SQL = f""" SELECT c.login, max(c.avatar_url) AS avatar_url, - count(DISTINCT c.full_name) AS projects, sum(c.contributions)::int AS contributions + count(DISTINCT c.full_name) AS projects, sum(c.contributions)::int AS contributions, + array_agg(DISTINCT c.full_name ORDER BY c.full_name) AS project_names FROM repo_contributors c JOIN projects p ON p.full_name = c.full_name WHERE {SHIPPED} AND {HUMAN} GROUP BY c.login diff --git a/apps/api/src/hackproof/schemas.py b/apps/api/src/hackproof/schemas.py index cda9461..b474258 100644 --- a/apps/api/src/hackproof/schemas.py +++ b/apps/api/src/hackproof/schemas.py @@ -187,6 +187,7 @@ class WrappedBuilder(BaseModel): avatar_url: str | None projects: int contributions: int + project_names: list[str] class Wrapped(BaseModel): diff --git a/apps/api/tests/test_api.py b/apps/api/tests/test_api.py index b96bc93..b04bdae 100644 --- a/apps/api/tests/test_api.py +++ b/apps/api/tests/test_api.py @@ -108,6 +108,10 @@ def test_wrapped_builders_are_ranked_and_multi_team_means_two_or_more_projects() commits = [builder["contributions"] for builder in body["top_builders"]] assert commits == sorted(commits, reverse=True) assert all(builder["projects"] >= 2 for builder in body["multi_team_builders"]) + assert all( + len(builder["project_names"]) == builder["projects"] + for builder in body["multi_team_builders"] + ) assert not {"cursoragent", "codex"} & {b["login"] for b in body["multi_team_builders"]} From 2e32ab76fff27250e5b8cd59602402b282872b84 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 16:09:52 +0100 Subject: [PATCH 52/54] refactor: share the back button --- apps/web/src/components/back-button.tsx | 22 +++++++++++++++++++ .../components/explorer/filter-heading.tsx | 17 ++------------ apps/web/src/pages/person.tsx | 18 ++++----------- 3 files changed, 28 insertions(+), 29 deletions(-) create mode 100644 apps/web/src/components/back-button.tsx diff --git a/apps/web/src/components/back-button.tsx b/apps/web/src/components/back-button.tsx new file mode 100644 index 0000000..4a62f4f --- /dev/null +++ b/apps/web/src/components/back-button.tsx @@ -0,0 +1,22 @@ +import { ArrowLeftIcon } from 'lucide-react' +import { Link, useLocation, useNavigate } from 'react-router' + +import { Button } from '@/components/ui/button' + +export function BackButton() { + const location = useLocation() + const navigate = useNavigate() + + if (location.key !== 'default') { + return ( + + ) + } + return ( + + ) +} diff --git a/apps/web/src/components/explorer/filter-heading.tsx b/apps/web/src/components/explorer/filter-heading.tsx index 25d2fda..3ec552a 100644 --- a/apps/web/src/components/explorer/filter-heading.tsx +++ b/apps/web/src/components/explorer/filter-heading.tsx @@ -1,6 +1,4 @@ -import { ArrowLeftIcon } from 'lucide-react' -import { Link, useLocation, useNavigate } from 'react-router' - +import { BackButton } from '@/components/back-button' import { useChatPanel } from '@/components/chat/use-chat-panel' import { Button } from '@/components/ui/button' import { EVENT_NAME } from '@/lib/config' @@ -26,25 +24,14 @@ function separator(index: number, total: number) { } export function FilterHeading() { - const location = useLocation() - const navigate = useNavigate() const { startChat } = useChatPanel() const { selection, projects, groups } = useSelectedGroups() const count = projects.filter((project) => matches(project, selection)).length - const canGoBack = location.key !== 'default' const clauses = groups.map(clauseOf) return (
    - {canGoBack ? ( - - ) : ( - - )} +

    {EVENT_NAME} projects {clauses.map((clause, index) => ( diff --git a/apps/web/src/pages/person.tsx b/apps/web/src/pages/person.tsx index af63dd9..2cd22a1 100644 --- a/apps/web/src/pages/person.tsx +++ b/apps/web/src/pages/person.tsx @@ -1,11 +1,11 @@ -import { ArrowLeftIcon, ExternalLinkIcon } from 'lucide-react' -import { Link, useLocation, useNavigate, useParams } from 'react-router' +import { ExternalLinkIcon } from 'lucide-react' +import { useParams } from 'react-router' +import { BackButton } from '@/components/back-button' import { ProjectCard } from '@/components/explorer/project-card' import { DetailError } from '@/components/query-state' import { Avatar, AvatarFallback, AvatarImage } from '@/components/ui/avatar' import { Badge } from '@/components/ui/badge' -import { Button } from '@/components/ui/button' import { Skeleton } from '@/components/ui/skeleton' import { usePerson } from '@/hooks/use-person' import { EVENT_NAME } from '@/lib/config' @@ -31,8 +31,6 @@ function PersonSkeleton() { export function PersonPage() { const login = useParams().login ?? '' - const location = useLocation() - const navigate = useNavigate() const { data, isPending, error } = usePerson(login) if (isPending) return @@ -43,15 +41,7 @@ export function PersonPage() { return (
    - {location.key !== 'default' ? ( - - ) : ( - - )} +
    {data.avatar_url && } From fe2c8a3624d05987b86dc7be5abd4325accfc608 Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 16:10:33 +0100 Subject: [PATCH 53/54] feat: add a page that lists the builders on two or more teams --- apps/web/src/app.tsx | 2 + apps/web/src/lib/types.ts | 1 + apps/web/src/pages/contributors.tsx | 77 +++++++++++++++++++++++++++++ 3 files changed, 80 insertions(+) create mode 100644 apps/web/src/pages/contributors.tsx diff --git a/apps/web/src/app.tsx b/apps/web/src/app.tsx index 00ce521..f100791 100644 --- a/apps/web/src/app.tsx +++ b/apps/web/src/app.tsx @@ -8,6 +8,7 @@ import { SiteFooter } from '@/components/layout/site-footer' import { SiteHeader } from '@/components/layout/site-header' import { BuilderPage } from '@/pages/builder' import { HomePage } from '@/pages/home' +import { ContributorsPage } from '@/pages/contributors' import { PersonPage } from '@/pages/person' import { ProjectPage } from '@/pages/project' import { WrappedPage } from '@/pages/wrapped' @@ -27,6 +28,7 @@ function Shell() { } /> } /> } /> + } /> } /> diff --git a/apps/web/src/lib/types.ts b/apps/web/src/lib/types.ts index 90d1c33..0eff6a2 100644 --- a/apps/web/src/lib/types.ts +++ b/apps/web/src/lib/types.ts @@ -196,6 +196,7 @@ export interface WrappedBuilder { avatar_url: string | null projects: number contributions: number + project_names: string[] } export interface Wrapped { diff --git a/apps/web/src/pages/contributors.tsx b/apps/web/src/pages/contributors.tsx new file mode 100644 index 0000000..d819bd2 --- /dev/null +++ b/apps/web/src/pages/contributors.tsx @@ -0,0 +1,77 @@ +import { Link } from 'react-router' + +import { BackButton } from '@/components/back-button' +import { Alert, AlertDescription, AlertTitle } from '@/components/ui/alert' +import { Avatar, AvatarFallback, AvatarImage } from '@/components/ui/avatar' +import { Badge } from '@/components/ui/badge' +import { Skeleton } from '@/components/ui/skeleton' +import { useWrapped } from '@/hooks/use-wrapped' +import { EVENT_NAME } from '@/lib/config' +import { formatNumber, projectName } from '@/lib/format' + +export function ContributorsPage() { + const { data, isPending, isError } = useWrapped() + + if (isError) { + return ( + + Could not load builders + The API is unreachable. Try again in a moment. + + ) + } + + const builders = data?.multi_team_builders ?? [] + + return ( +
    +
    + +

    + {EVENT_NAME} builders on 2 or more teams +

    +

    + {isPending + ? 'Counting…' + : `${builders.length} builders committed to more than one project, by commits to the default branch.`} +

    +
    +
      + {isPending + ? Array.from({ length: 6 }, (_, index) => ( +
    • + +
    • + )) + : builders.map((builder) => ( +
    • + +
      + + {builder.avatar_url && } + {builder.login.slice(0, 2).toUpperCase()} + +
      + {builder.login} + + {builder.projects} projects · {formatNumber(builder.contributions)} commits + +
      +
      +
      + {builder.project_names.map((name) => ( + + {projectName(`repo:${name}`)} + + ))} +
      + +
    • + ))} +
    +
    + ) +} From d9cff090b370a228bdac0b81c32ab23b371ad93c Mon Sep 17 00:00:00 2001 From: Emmanuel Odii Date: Sun, 15 Nov 2026 16:10:33 +0100 Subject: [PATCH 54/54] feat: link the builders overflow count to the full list --- apps/web/src/pages/wrapped.tsx | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/apps/web/src/pages/wrapped.tsx b/apps/web/src/pages/wrapped.tsx index 5e4c209..3740a62 100644 --- a/apps/web/src/pages/wrapped.tsx +++ b/apps/web/src/pages/wrapped.tsx @@ -292,7 +292,15 @@ function Builders({ wrapped }: { wrapped: Wrapped }) { size="sm" delay={1} /> - {hidden > 0 && +{hidden}} + {hidden > 0 && ( + + +{hidden} + + )}

    Most commits