Script Name: block_retired.py
📁 Proposed Location: package/lifecycle
🔄 Alternative: misc or removed
🎯 Purpose: No (it is used to block retired package for specific tags on koji)
🔗 Dependencies:
- External repos: https://docs.fedoraproject.org/en-US/infra/releng_misc_guide/sop_package_blocking/ it mentioned in doc
- Other releng scripts: build-functions.sh, find_tagged_retired_epel_builds.py
- External services: PDC, Koji
- Special permissions: Koji Permission to block package on tag.
💭 Additional Notes: 
Script is still using PDC endpoint to get retired packages, probably we not using it and should remove it.
Breaking changes: Since it uses PDC we probably didn't use this script since PDC decomition

ansible
ci-resultsdb-listener
compose-tracker
compose-utils
container-blacklist
distgit-bugzilla-sync
failed-composes
fedora-atomic
fedora-comps
fedora-infrastructure
fedora-kickstarts
fedora-kiwi-descriptions
fedora-lorax-templates
fedora-modular-repos
fedora-module-defaults
fedora-packager
fedora-release
fedora-repos
fedora-scm-requests
fedpkg-minimal
flr
forgejo-deployment
generate_changelog
howtos
infra-docs
infra-docs-fpo
ipsilon-fedora
koji-fedmsg-plugin
koji-shadow-configs
koji-site
mailman-stack-maint
mark-atomic-bad
mash
multiboot-media-creator
pagure
pagure-dist-git
pungi
pungi-fedora
python-multilib
python-munch
releng-automation
review_stats
rpmautospec
tag2distrepo
toddlers
workstation-ostree-config
zuul

Script Name: check_epel_deps.py
📁 Proposed Location: packages/epel/
🔄 Alternative: misc
🎯 Purpose: No (Identify Epel packages with broken dependencies and notify maintainers through email)
🔗 Dependencies:
- External repos: None
- Other releng scripts: check_epel_deps.sh
- External services: None
- Special permissions: None
💭 Additional Notes: 
It generates a config header only for "epel-6" tree name. 

Script Name:  check_epel_deps.sh
📁 Proposed Location: packages/epel
🔄 Alternative: misc
🎯 Purpose:  No (It's a wrapper that calls check_epel_deps.py for specific use case with treename=epel-6 )
🔗 Dependencies:
- External repos: None
- Other releng scripts: None
- External services: None
- Special permissions: None
💭 Additional Notes: 
It won't work without check_epel_deps.py, because it's just a wrapper.
Breaking changes: [describe potential issues]

Script Name: check-latest-build.py
📁 Proposed Location: builds/koji
🔄 Alternative: utilities/
🎯 Purpose: Yes (Find packages where latest and highest NVR are different in a tag.)
🔗 Dependencies:
- External repos: None
- Other releng scripts: None
- External services: Koji
- Special permissions: Kerberos auth
💭 Additional Notes: 
Should be renamed to use underscores instead of hyphens
Breaking changes: Renaming or moving won't break anything

Script Name: check-testing-pre-GA.py
📁 Proposed Location: builds/koji
🔄 Alternative: utilities/
🎯 Purpose: Yes (Find builds tagged in both fX-updates-testign and fX tags)
🔗 Dependencies:
- External repos: None
- Other releng scripts: None
- External services: Koji
- Special permissions: None (working with kojihub api)
💭 Additional Notes: 
Need to be renamed
Breaking changes: Everything will be fine

Script Name: check-upgrade-paths.py
📁 Proposed Location: builds/koji
🔄 Alternative: utilities or remove
🎯 Purpose: Yes (A utility to examine a set of tags to verify upgrade paths for all the packages)
🔗 Dependencies:
- External repos: None
- Other releng scripts: None
- External services: Koji
- Special permissions: None (kerberos)
💭 Additional Notes: 
Need to be renamed. Also seems to be outdated, the functionality is close to check-latest-build.
Breaking changes: Nothing

Script Name: clean-amis.py
📁 Proposed Location: infrastructure/
🔄 Alternative: utilities/
🎯 Purpose: Yes (A utility to remove the nightly AMIs every 5 days.)
🔗 Dependencies:
- External repos: infra-docs-fpo, also mentioned that script is running as a cron job in fedora infrastructure, but I didn't find where
- Other releng scripts: None
- External services: Datagrepper, Pagure, AWS, fedfind
- Special permissions: Pagure access token, aws secret access key
💭 Additional Notes: 
Should be renamed, also it says that it runs as a cron job within Fedora Infra
Breaking changes: Potential cron job failure
UPD:
This script can be removed, now it handled by cloud-image-uploader

Script Name: clean-overrides.py
📁 Proposed Location: builds/koji
🔄 Alternative: utilities/
🎯 Purpose: Yes (A utility to examine a buildroot override tag and compare contents to an updates tag.)
🔗 Dependencies:
- External repos: None
- Other releng scripts: None
- External services: Koji
- Special permissions: None (kerberos)
💭 Additional Notes: 
Need to be renamed
Breaking changes: Nothing

Script Name: close-old-ftbfs-bugz.sh
📁 Proposed Location: misc/
🔄 Alternative: utilities/
🎯 Purpose: No (It closes bugzilla tickets with status NEW, if package in ticket has latest build date later that ticket creation)
🔗 Dependencies:
- External repos: None
- Other releng scripts: None
- External services: Koji, Bugzilla
- Special permissions: Need access to modify bugzilla tickets
💭 Additional Notes: 
need to be renamed
Breaking changes: Nothing

Script Name: critpath.py
📁 Proposed Location: quality-assurance/critpath
🔄 Alternative: 
🎯 Purpose: No (Identify which packages are part of Fedora critpath and generate output with different options)
🔗 Dependencies:
- External repos: ansible, pungi-fedora, infra-docs-fpo
- Other releng scripts: build-functions.sh
- External services: Bodhi, DL fedora, coreOS, dnf
- Special permissions: None
💭 Additional Notes: 
This is an important script, so refactoring must be carefull
Breaking changes: Cron job path and pungi-fedora/nightly.sh path needs to be updated

Script Name: distgit-branch-unused.py
📁 Proposed Location: packages/distgit/
🔄 Alternative: packages/maintenance/, misc/, 
🎯 Purpose: Yes (This script checks if a branch may be deleted.)
🔗 Dependencies:
- External repos: infra-docs-fpo, howtos
- Other releng scripts: None
- External services: Koji, Bodhi
- Special permissions: None
💭 Additional Notes: 
Needs to be renamed. 
Breaking changes: requires updating the path in the doc

Script Name: fedmsg-functions.sh (can be removed since fedora-messaging.sh is implementing the same functionality, but with the modern fedora-messaging module)
📁 Proposed Location: infrastructure/messaging/
🔄 Alternative: utilities
🎯 Purpose: Yes (This is a bash shell script that is meant to be sourced by other scripts and aims to deliver functions common to sending messages to fedmsg[0] in rel-eng shell scripts.)
🔗 Dependencies:
- External repos: pungi-fedora
- Other releng scripts: build-functions.sh, fedora-messaging-logger
- External services: fedmsg
- Special permissions: None
💭 Additional Notes: 
Needs to be renamed. Last time was updated 9 years ago, and it uses fedmsg so it might be outdated.
Breaking changes: Paths in pungi-fedora and some other releng scripts need to be changed.

Script Name: fedora-messaging-logger
📁 Proposed Location: infrastructure/messaging/
🔄 Alternative: utilities/
🎯 Purpose: Yes (fedora-messaging replacement for fedmsg-logger)
🔗 Dependencies:
- External repos: ansible
- Other releng scripts: fedora-messaging.sh
- External services: fedora-messaging
- Special permissions: None (might be the ability to send messages to the message bus, but the script itself does not require anything in terms of permissions)
💭 Additional Notes: 
Needs to be added file extension, in that case .py. It's a Fedora messaging compatibility wrapper
Breaking changes: Paths need to be changed.

Script Name: fedora-messaging.sh
📁 Proposed Location: infrastructure/messaging/
🔄 Alternative: utilities/
🎯 Purpose: Yes (This is a bash shell script that is meant to be sourced by other scripts
and aims to deliver functions common to sending messages to fedora-messaging[0] in rel-eng shell scripts.)
🔗 Dependencies:
- External repos: pungi-fedora
- Other releng scripts: None
- External services: fedora-messaging
- Special permissions: None
💭 Additional Notes: 
Needs to be renamed. It's a copy of fedmsg-functions.sh, but it uses fedora-messaging-logger  as a logger instead of fedmsg-logger
Breaking changes: Paths need to be changed in pungi-fedora

Script Name: fedora-torrent-ini.py
📁 Proposed Location: release_process/torrents/
🔄 Alternative: misc/
🎯 Purpose: No (Torrent metadata generator for Fedora)
🔗 Dependencies:
- External repos: infra-docs-fpo
- Other releng scripts: None
- External services: None
- Special permissions: None
💭 Additional Notes: 
Needs to be renamed. It runs on a torrent server to generate torrent metadata
Breaking changes: Nothing, but need to fix typo https://pagure.io/infra-docs-fpo/blob/master/f/modules/release_guide/pages/sop_torrent_releases.adoc#_91

Script Name: find_failures.py
📁 Proposed Location: release_process/mass_rebuilds/
🔄 Alternative: None
🎯 Purpose: Yes (A utility to discover failed builds in a given tag)
🔗 Dependencies:
- External repos: infra-docs-fpo
- Other releng scripts: mass_rebuild_file_bugs.py
- External services: Koji
- Special permissions: None
💭 Additional Notes: 
Breaking changes: Paths change within releng repo

Script Name: find_FTBFS.py
📁 Proposed Location: utilities/
🔄 Alternative: builds/koji/
🎯 Purpose: Yes (Find FTBFS packages)
🔗 Dependencies:
- External repos: None
- Other releng scripts: None
- External services: Koji
- Special permissions: None (kerberos)
💭 Additional Notes: 
Just a script to find FTBFS packages
Breaking changes: Nothing

Script Name: find_tagged_retired_epel_builds.py
📁 Proposed Location: utilities/
🔄 Alternative: misc or removed since it uses block_retired.py functionality, which using PDC 
🎯 Purpose: Yes (Check if there are EPEL builds from retired packages still in the buildroot.)
🔗 Dependencies:
- External repos: None
- Other releng scripts: None
- External services: Koji
- Special permissions: None
💭 Additional Notes: 
It might be outdated, last update 7 years ago, and it is still using block_retired.py functions that use PDC.
Breaking changes: Nothing

Script Name: find_unblocked_orphans
📁 Proposed Location: packages/orphaned/
🔄 Alternative: release_process/mass_branching because it is mentioned in mass branching SOP and requires adoption
🎯 Purpose: Yes (A utility to find orphaned packages in pagure that are unblocked in koji and to show what may require those orphans)
🔗 Dependencies:
- External repos: infra-docs-fpo
- Other releng scripts: everything inside orphaned-package-process dir
- External services: Koji, dnf
- Special permissions: Kerberos, but this script is part of bigger dir, where is also retire.py script which requires 
💭 Additional Notes: 
Now in the releng repo, this script is a link to the script which is placed in a different location, so it should definitely be fixed.
Breaking changes: Needs to move the whole dir

Script Name: find-bad-builds.py
📁 Proposed Location: builds/koji/utils
🔄 Alternative: utilities
🎯 Purpose: Yes (template for finding builds that meet some time/buildroot component critera. Edit to suit.) Needs to fix typo in description.
🔗 Dependencies:
- External repos: None
- Other releng scripts: None
- External services: Koji
- Special permissions: None (kerberos)
💭 Additional Notes: 
Needs to be renamed. It's a template to get builds by specific criteria. Not sure if it's used or not, last update was 2 years ago, but it's just adding gssapi_login as a part of koji authentication.
Breaking changes: Nothing

Script Name: find-hidden-packages.py
📁 Proposed Location: builds/koji
🔄 Alternative: utilities/
🎯 Purpose: No (The name does not say much about this script, but basically it checks the difference in package versions between builds in parent and child tags)
🔗 Dependencies:
- External repos: None
- Other releng scripts: None
- External services: Koji, rpm
- Special permissions: None (Kerberos)
💭 Additional Notes: 
Needs to be renamed. We have a lot of scripts that are doing close enough functionality, so I guess part of them can be grouped up inside 1 script with different behavior based on arguments. Otherwise, it is difficult to follow all the scripts with close functionality, especially when most of them are not used anywhere else and are not even mentioned in the documentation.
Breaking changes: Nothing

Script Name: ftbfs_weekly_reminder.py
📁 Proposed Location: utilities/
🔄 Alternative: misc/
🎯 Purpose: No (Identify Bugzilla FYBFS bugs and notify maintainers as a part of cron job)
🔗 Dependencies:
- External repos: ansible
- Other releng scripts: None
- External services: Bugzilla
- Special permissions: Bugzilla API key
💭 Additional Notes: 
This script is running on the server as a cron job, so moving it won't break anything.
Breaking changes: Nothing.

Script Name: get_retired_packages.sh
📁 Proposed Location: packages/
🔄 Alternative: utilities/
🎯 Purpose: No (But name saying exactly what it does.)
🔗 Dependencies:
- External repos: ansible, infra-docs-fpo
- Other releng scripts: None
- External services: pkgs machine
- Special permissions: access to the packages machine since it is fetching packages from /stv/git/rpms
💭 Additional Notes: 
Breaking changes: Paths need to be modified in the cron job and in the documentation for the final freeze

Script Name: isolate-tag.py
📁 Proposed Location: builds/koji/
🔄 Alternative: utilities/
🎯 Purpose: Yes  (A utility to tag all inherited builds into a specific koji tag)
🔗 Dependencies:
- External repos: None
- Other releng scripts: None
- External services: Koji
- Special permissions: kerberos
💭 Additional Notes: 
Needs to be renamed.
Breaking changes: Nothing

Script Name: mass-tag.py
📁 Proposed Location: builds/koji
🔄 Alternative: utilities/
🎯 Purpose: Yes (A utility to tag rebuilt packages)
🔗 Dependencies:
- External repos: infra-docs-fpo
- Other releng scripts: None
- External services: Koji, rmp
- Special permissions: koji admin permissions
💭 Additional Notes: 
Needs to be renamed.
Breaking changes: Nothing, maybe update in mass rebuild doc

Script Name: need-rebuild.py
📁 Proposed Location: release_process/mass_rebuilds/
🔄 Alternative: 
🎯 Purpose: Yes (A utility to discover packages that need a rebuild)
🔗 Dependencies:
- External repos: infra-docs-fpo
- Other releng scripts: None
- External services: Koji
- Special permissions: None (kerberos)
💭 Additional Notes: 
Needs to be renamed. 
Breaking changes: Change paths in mass rebuild doc

Script Name: prune-tag.py
📁 Proposed Location: builds/koji/
🔄 Alternative: utilities/
🎯 Purpose: Yes (A utility to prune all but the latest build in a given tag)
🔗 Dependencies:
- External repos: None
- Other releng scripts: None
- External services: Koji
- Special permissions: Kerberos
💭 Additional Notes: 
Needs to be renamed.
Breaking changes: Nothing

Script Name: secondary-mash-updates
📁 Proposed Location: builds/compose
🔄 Alternative: sync/secondary/
🎯 Purpose: No (Creation and synchronization of update repositories for non-x86 architectures.)
🔗 Dependencies:
- External repos: fedora-comps
- Other releng scripts: None
- External services: Koji
- Special permissions: Access to the Koji compose machine.
💭 Additional Notes: 
Miss file extension, in that case .sh
Breaking changes: Nothing

Script Name: secondary-sync.py
📁 Proposed Location: sync/secondary/
🔄 Alternative: [alternative path if unsure]
🎯 Purpose: Yes (A command line tool to sync all fedora secondary arches  from the hubs to a central mirror)
🔗 Dependencies:
- External repos: None
- Other releng scripts: None
- External services: Koji, fedmsg, rpm
- Special permissions: Access to the compose machine
💭 Additional Notes: 
Needs to be renamed. Also it uses fedmsg for notifying so it seems to be outdated. Not sure what permissions it requires.
Breaking changes: Nothing

Script Name: srpm-excluded-arch.py
📁 Proposed Location: utilities/
🔄 Alternative: packages/
🎯 Purpose: Yes (is a tool to give you a list of package names that are excluded on the given arches.  access to a srpm tree is needed)
🔗 Dependencies:
- External repos: None
- Other releng scripts: build-functions.sh, build-current.py
- External services: rpm
- Special permissions: access to pkgs machine
💭 Additional Notes: 
Needs to be renamed.
Breaking changes: Needs to modify path in build-functions.sh script

Script Name: sync-blocked-primary.py
📁 Proposed Location: sync/secondary/
🔄 Alternative: sync/primary/
🎯 Purpose: Yes (A utility to sync blocked packages in primary koji to a secondary arch for a given tag)
🔗 Dependencies:
- External repos: None
- Other releng scripts: None
- External services: Koji
- Special permissions: Koji admin rights to block unblock pacakges.
💭 Additional Notes: 
Needs to be renamed.
Breaking changes: Nothing

Script Name: sync-tagged-primary.py
📁 Proposed Location: sync/secondary/
🔄 Alternative: sync/primary
🎯 Purpose: Yes (A utility to sync tagged packages in primary koji to a secondary arch)
🔗 Dependencies:
- External repos: None
- Other releng scripts: sync-tagged-primary (bash script that runs this script with specific options)
- External services: Koji, rpm
- Special permissions: Koji admin (kerberos)
💭 Additional Notes: 
Needs to be renamed.
Breaking changes: Nothing.

Script Name: sync-tagged-primary
📁 Proposed Location: sync/secondary
🔄 Alternative: sync/primary
🎯 Purpose: No (It's a outdated wrapper for sync-tagged-primary.py script)
🔗 Dependencies:
- External repos: None
- Other releng scripts: None
- External services: None
- Special permissions: same as Python script
💭 Additional Notes: 
Needs to be renamed. File extension needs to be added.
Breaking changes: Nothing needs to be updated if it is still in use.

Script Name: distgit/give-package.py
📁 Proposed Location: packages/distgit
🔄 Alternative: 
🎯 Purpose: Yes (Give a package in pagure-on-dist-git from one user to another)
🔗 Dependencies:
- External repos: None
- Other releng scripts: None
- External services: pagure distgit
- Special permissions: pagure api token
💭 Additional Notes: 
Needs to be renamed.
Breaking changes: When move should be moved with distgit/utilities.py

Script Name: distgit/orphan-all-packages.py
📁 Proposed Location: packages/distgit/
🔄 Alternative: 
🎯 Purpose: Yes (Orphan all packages of a given set of users.)
🔗 Dependencies:
- External repos: None
- Other releng scripts: None
- External services: Pagure distgit
- Special permissions: Pagure api token
💭 Additional Notes: 
Needs to be renamed.
Breaking changes: When move should be moved with distgit/utilities.py. It will be rewritten during the forge move.

Script Name: distgit/orphan-listed-packages.py
📁 Proposed Location: packages/distgit/
🔄 Alternative: 
🎯 Purpose: Yes (This script is useful to bulk orphan listed packages.)
🔗 Dependencies:
- External repos: None
- Other releng scripts: None
- External services: Pagure distgit
- Special permissions: Pagure API token
💭 Additional Notes: 
Needs to be renamed.
Breaking changes: It will be rewritten during the forge move since it works with pagure.

Script Name: distgit/retire_packagers.py
📁 Proposed Location: packages/distgit/
🔄 Alternative:
🎯 Purpose: Yes (This script queries dist-git for all the packages a given packager maintains,
has commit or watches.)
🔗 Dependencies:
- External repos: None
- Other releng scripts: None
- External services: Pagure distgit
- Special permissions: Pagure api token
💭 Additional Notes: 
Breaking changes: Might be rewritten during the forge move.

Script Name: distgit/utilities.py
📁 Proposed Location: packages/distgit/
🔄 Alternative: 
🎯 Purpose: Yes (Utilities for manipulating dist-git (pagure).)
🔗 Dependencies:
- External repos: None
- Other releng scripts: distgit/give-package.py, distgit/orphan-all-packages.py
- External services: Pagure distgit
- Special permissions: pagure api token
💭 Additional Notes: 
It's a utility module, which does not run as a script but is imported into other scripts instead.
Breaking changes: needs to be in the same directory with other distgit scripts.

Script Name: fesco/sig-policy/sig_policy.py
📁 Proposed Location: infrastructure/fesco/sig-policy/
🔄 Alternative:
🎯 Purpose: Yes (This script enacts the FESCo SIG Policy as documented here: https://docs.fedoraproject.org/en-US/fesco/SIG_policy/)
🔗 Dependencies:
- External repos: ansible, infra-docs-fpo
- Other releng scripts: None
- External services: fedpq, pagure
- Special permissions: pagure api token
💭 Additional Notes: 
I'm not sure if the directory name should follow the same convention as a Python script name.
Breaking changes: Paths in Ansible repos need to be adjusted.

Script Name: ftbfs-fti/follow-policy.py
📁 Proposed Location: packages/maintenance/ftbfs-fti/
🔄 Alternative: infrastructure/ftbfs-fti/
🎯 Purpose: No (Automatically detects packages with installation issues, creates Bugzilla tickets, and follows FESCo's policy for handling unmaintained packages.)
🔗 Dependencies:
- External repos: None
- Other releng scripts: None
- External services: Bugzilla
- Special permissions: bugzilla token
💭 Additional Notes: 
Needs to be renamed.
Breaking changes: It uses Jinja templates that are in same folder and should be moved with the script.

Script Name: misc/failed_composes_cleanup
📁 Proposed Location: misc/
🔄 Alternative: utilities/
🎯 Purpose: Yes (A utility to clean all the older issues in the releng/failed-compose tracker.)
🔗 Dependencies:
- External repos: infra-docs=fpo
- Other releng scripts: None
- External services: Pagure
- Special permissions: Pagure API token.
💭 Additional Notes: 
Breaking changes: Paths in SOP doc need to be modified.

Script Name: misc/ga-cleanup
📁 Proposed Location: misc/
🔄 Alternative: builds/koji/
🎯 Purpose: Yes (script to print builds that are tagged both into the GA tag and updates-testing)
🔗 Dependencies:
- External repos: None
- Other releng scripts: None
- External services: Koji
- Special permissions: None
💭 Additional Notes: 
File extension needs to be added, in that case .sh. Needs to be renamed.
Breaking changes: Nothing

Script Name: misc/rebuild
📁 Proposed Location: misc/
🔄 Alternative: builds/koji
🎯 Purpose: Yes (Script to build re-bootstrap pkgs for eg. glibc ABI changes and prepare substitution list for koji-shadow)
🔗 Dependencies:
- External repos: None
- Other releng scripts: None
- External services: Koji, rpm, fedpkg
- Special permissions: build permission
💭 Additional Notes: 
File extension needs to be added, in that case .sh. Not sure if it's still in use
Breaking changes: Nothing

Script Name: odcs/odcs-private-copose.py
📁 Proposed Location: builds/compose/odcs/
🔄 Alternative: infrastructure/odcs/
🎯 Purpose: Yes (This is used to generate private composes using ODCS)
🔗 Dependencies:
- External repos: None
- Other releng scripts: None
- External services: ODCS
- Special permissions: odcs token, sigkey
💭 Additional Notes: 
Needs to be renamed.
Breaking changes: Nothing.
UPD:
should be removed

Script Name: odcs/odcs-token.py
📁 Proposed Location: builds/compose/odcs/
🔄 Alternative: infrastructure/odcs/
🎯 Purpose: Yes (This is used to generate a token needed to run odcs composes )
🔗 Dependencies:
- External repos: None
- Other releng scripts: None
- External services: openidc
- Special permissions: None
💭 Additional Notes: 
Needs to be renamed.
Breaking changes: It'd be better to put it in the same directory as the previous script.
UPD:
Should be removed

Script Name: orphaned-packages-process/all_files
📁 Proposed Location: packages/lifecycle/orphaned-packages-process/
🔄 Alternative: packages/orphaned/orphaned-packages-process/
🎯 Purpose: No (All scripts and files inside this dir is a part of one SOP, which identifies orphaned packages and retires them afterward.)
🔗 Dependencies:
- External repos: infra-docs-fpo
- Other releng scripts: all inside orphaned-packages-process dir
- External services: bugzilla, koji, dnf
- Special permissions: access to the machine where koji and python-fedora are installed. Also need access to modify bugzilla tickets.
💭 Additional Notes: 
This dir should be moved as it is under a new dir. Also this functionality can be implemented as a toddler plugin, so it triggers automatically.
Breaking changes: Paths in documentation.