Skip to content

AGENTS.md

Latest commit

 

History

History
23 lines (21 loc) · 3.15 KB

AGENTS.md

File metadata and controls

23 lines (21 loc) · 3.15 KB
Raw

Repository Memory

  • This repo hosts the OpenHands Champions contributor directory as a lightweight Next.js app for Vercel.

  • Canonical public data files:

    • data/contributors.generated.json for generated merged-PR contributor data
    • data/contributors.overrides.json for contributor-supplied name/note/hidden overrides
    • data/excluded-logins.json for manually excluded employee/service-account logins

  • Sync command: npm run sync:contributors (requires GITHUB_TOKEN).

  • Daily sync is handled by .github/workflows/sync-contributors.yml and rewrites README.md as a teaser plus updates generated data.

  • automation/ contains the separate OpenHands Cloud welcome-comment automation (python automation/main.py, cron 0 12 * * *) that scans recent merged PRs, skips denylisted/bot/service-account authors via data/excluded-logins.json, and posts the first-time contributor welcome comment.

  • README regeneration preserves any content between <!-- BEGIN MANUAL --> and <!-- END MANUAL --> markers (intended for manual Hackers/Testers lists).

  • Contributor avatar wall is rendered via the Next.js route app/api/contributor-wall (served at /api/contributor-wall) using the synced contributor dataset and omitting hidden contributors.

  • UI reads local JSON at build time and provides client-side search/sort across merged PR contributors.

  • Visual styling intentionally mirrors OpenHands/company-website: cream background, dark brown feature surfaces, yellow accent, and rounded card system.

  • Generated contributor data now also includes a recentMergedPrs feed for the Fresh Merges ticker; newest contributors are derived from each contributor's firstMergedPr timestamp.

  • data/contributors.generated.json now stores contributionYears plus a yearly map per contributor so the PR Champions view can treat each calendar year as its own champion season.

  • Primary UI is now a sortable expandable table with a contributor-year season filter, season-scoped ticker rails, expanded-row year tags, and a floating accessibility control for motion/contrast.

  • Contributor self-serve PR flows live in .github/PULL_REQUEST_TEMPLATE/ with separate templates for profile enrichment and hide/remove requests.

  • Issue champions are now tracked separately from merged-PR champions via data/issues.generated.json, produced by npm run sync:issues (or npm run sync:all) from GitHub issues + issue comments over a rolling 365-day window.

  • The new /issues route mirrors the main directory UX with shared search/sort/pagination/ticker/accessibility patterns and uses the same data/contributors.overrides.json file for display-name and hide overrides.

  • .github/workflows/sync-contributors.yml now syncs both contributor and issue datasets in one run and commits data/issues.generated.json alongside the existing contributor assets.

  • The public detailed merged-PR query view now lives at /detailed; /internal and /interal permanently redirect there. The route is intentionally not linked from the top nav. The detailed page includes hidden contributors as fully anonymized rows appended after visible matches, while the main public directory continues to omit hidden contributors entirely.