Repository navigation
feat: add monthly org profile README rotation - #37
Merged
Merged
Conversation
Add a scheduled workflow that refreshes the public repo catalog and renders profile/README.md with six featured repositories per month, following the nemo-org-profile mock-up. Rotation order is seeded from the agreed schedule and kept in rotation/state.json. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Signed-off-by: Charlie Truong <chtruong@nvidia.com>
chtruong814
requested review from
a team,
bernardwin,
ericharper,
euronymous-aithal and
snowmanwwg
as code owners
November 3, 2026 02:22
Fill template placeholders in a single pass so braces in repo descriptions cannot abort the run. Run the workflow in dry-run mode on pull requests that touch it, and only commit on schedule or non-dry-run manual dispatch. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Signed-off-by: Charlie Truong <chtruong@nvidia.com>
Advance the cursor by a fixed batch size instead of past the last pick, and fill any shortfall from positions after the window without moving the cursor. A replacement no longer shifts later months' batches. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Signed-off-by: Charlie Truong <chtruong@nvidia.com>
Mint a GitHub App token for scheduled and manual non-dry-run runs and use it for checkout and push so the bot's branch protection bypass applies. Reduce the workflow GITHUB_TOKEN to contents: read. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Signed-off-by: Charlie Truong <chtruong@nvidia.com>
Remove the banner, intro, Explore libraries and For agents sections from the template so the profile shows only the monthly featured repositories. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Signed-off-by: Charlie Truong <chtruong@nvidia.com>
Add CODEOWNERS entries for scripts/ and rotation/ so changes to the code and state that run with the bot token need a review from @NVIDIA-NeMo/automation. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Signed-off-by: Charlie Truong <chtruong@nvidia.com>
Reject non-dry-run --date values outside the current UTC month, fail instead of publishing an empty README or crashing on an empty order, only push from main (other refs and PRs run in dry-run mode), and retry the push with a rebase. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Signed-off-by: Charlie Truong <chtruong@nvidia.com>
Scheduled runs always use today's date and real runs reject other months, so the manual date input only added risk. The script keeps --date for local testing. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Signed-off-by: Charlie Truong <chtruong@nvidia.com>
Add DFM to the explicit exclusions, set excluded_from_featured when a repo is excluded by the topic or by rotation/config.json, and add license_overrides for repos whose LICENSE files declare Apache-2.0 but which GitHub reports as NOASSERTION. Overrides only fill gaps and are marked as manual in the catalog. Refresh the catalog. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Signed-off-by: Charlie Truong <chtruong@nvidia.com>
Add the NVIDIA SPDX copyright and Apache-2.0 header to the rotation script and workflow, matching the header used in other NeMo repos. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Signed-off-by: Charlie Truong <chtruong@nvidia.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a GitHub Action that regenerates the org profile README (
profile/README.md) on a schedule and pushes it to this repo, following the design in the internalnemo-org-profilemock-up.scripts/rotate_readme.py(stdlib only): fetches public org repos, picks six featured repos per month, fillsprofile/README.template.md, validates, and refreshesprofile/repositories.json. Failure leaves the last good README in place.rotation/state.json: rotation order, cursor and per-month history, seeded from the agreed schedule (Nov 2026 starts with Safe-Synthesizer, Switchyard, eval-author, labs-molt, Lens, Nemotron). Reruns in the same month reuse the selection.rotation/config.json: exclusions (infra repos, excluded by request, inactive) and display-name overrides..github/workflows/rotate-profile-readme.yml: runs Mondays 14:00 UTC (first Monday of the month starts the rotation; other runs refresh descriptions and the catalog) plusworkflow_dispatch. Uses onlyGITHUB_TOKENwithcontents: write; actions pinned by SHA.Notes
nemo-*topics. None are applied yet, so cards show no chips until repo admins add them.rotation/config.jsononce final copy is available.main; branch protection may need a bypass for the bot, or a PR-based variant.workflow_dispatchis not usable until this is onmain, so the workflow has not run on GitHub. The script was tested locally against the live API, including an 8-month simulation matching the planned schedule.assets/...image paths in the profile README should be verified on the live org page.Test plan
profile/README.mdagainst the mock-updry_run, then once for realmainsucceeds under branch protection🤖 Generated with Claude Code