This directory contains GitHub Actions workflows that automatically refresh contribution statistics, activity feeds, and profile assets.
update_activity.yml: Runs on a 12-hour cron (0 */12 * * *) and onworkflow_dispatch. It executes inside apython:3.10-slimcontainer to keep the runtime pinned and reproducible.
This repo runs an unattended developโmaster pipeline, with no manual review step:
- Validate โ the job checks out
developand byte-compilesupdate_github_activity.py,download_badges.py, anddesign_tokens.py(python -m py_compile). If validation fails, the job stops here โ nothing is committed or promoted. - Generate + commit to
developโupdate_github_activity.pyregeneratesREADME.mdand theassets/stat-overview.svg/assets/stat-languages.svgbadges, and the changes are committed and pushed todevelop(notmaster) asgithub-actions[bot]. - Promote to
masterโ once thedevelopcommit lands, the same job fast-forwardsmasterto that commit (git merge --ff-only) and pushes it. This is a straight fast-forward, never a force-push; ifdevelopandmasterhave diverged such that a fast-forward isn't possible, the job fails loudly instead of overwriting history.
master is the branch that actually renders as the public github.com/knownassurajit profile page. develop is where the bot's generated commits land first and pass validation before being promoted.




