Install workflow: Add Update Label Weekly - ATO by hfla-workflow-rollout[bot] · Pull Request #3066 · hackforla/tdm-calculator

hfla-workflow-rollout · 2026-03-26T21:12:27Z

Automated Workflow Setup

This PR adds the "Add Update Label Weekly" GitHub Actions workflow to your project.

Files installed by this PR

Workflow file:
- .github/workflows/add-update-label-weekly.yml
Configuration files:
- github-actions/workflow-configs/add-update-label-weekly-config.yml
- github-actions/workflow-configs/templates/add-update-instructions-template.md

What this workflow does

Monitors open, assigned issues with the default status "In progress (actively working)"
Checks for recent update comments from assignees
Posts reminders for devs to provide issue progress updates
Labels issues that need updates as well as issues that are considered inactive

Security

Uses organization-managed, secure GitHub App with just-in-time token
Starts in dry-run mode (safe testing)
No project-specific tokens or secrets needed

How to use

Review configurations and make changes to the respective files attached to this PR:
- github-actions/workflows/add-update-label-weekly.yml
  - Adjust the cron schedule as needed for your project (https://crontab.cronhub.io/).
  - Current cron is scheduled to run Fridays at 0700 UTC, every week except in July and December.
- github-actions/workflow-configs/add-update-label-weekly-config.yml
  - This configuration file lists all workflow variables that can be customized to match the specific conditions of your project.
  - Each variable has been assigned a default value. Before you run the workflow, carefully review each variable and edit the provided value so that it matches the value used in your repository, or in the case of the "Time thresholds", to set the behavior you want.
  - Configure the values only as specified. Do not edit the variable keys or change the file formatting, otherwise the workflow may crash or behave unexpectedly.
  - "Labels and label placeholders used by this workflow"
    - The labels: section includes different categories of labels. Each label name appears in "double quotes" and must match an existing label in your repository exactly.
      - The required: section lists label placeholder keys that are essential to the workflow. Each key must map- exactly- to an actual label in your project.
      - The filtering: section specifies labels that exclude certain issues from update checks. If an issue has any of these labels, the workflow will skip that issue and not process it.
      - See the config.yml for additional instructions.
  - "Time thresholds (in days)"
    - The timeframes: section defines placeholder keys that represent time thresholds, measured in days. Each issue’s update status is determined by comparing the assignee’s most recent activity timestamp against these defined thresholds.
    - Default values are provided and can be used as-is without modifications. See the config.yml for detailed explanations and, only if needed, for instructions for customizing these values.
  - "Project Board status-column configuration"
    - The projectBoard: section defines placeholder keys representing Project Board status-column names. Similar to the required labels, each placeholder status-column key must map exactly to a status-column on your Project Board.
    - Change the values as needed for an exact match, and ensure the status-column value is in double quotes.
  - "Bot configuration"
    - This section should not need any edits.
  - "Bot comment template"
    - For the optional variable teamSlackChannel: Add your team's Slack Channel (once again in "double quotes") if you want this info on the Bot comment template.
- github-actions/workflow-configs/templates/add-update-instructions-template.md
  - We recommend keeping this version. If needed, edit using markdown syntax.
Test in dry-run mode
- Go to Actions tab → "Add Update Label Weekly"
- Click "Run workflow" → Keep dry-run = true
- Review logs to see which issues would be flagged and whether this is what you expected.
Live mode
- When you have set up the configurations, the automation will run at the next scheduled time.
- You can also manually trigger with dry-run = false if needed.

Auto-generated by Rollout Workflow to Project workflow.

hfla-workflow-rollout · 2026-03-26T21:12:39Z

Label & Project Board Suggestions

This PR includes a configuration file with variables — specifically labels and Project Board status-columns — that must be updated to match values already used in your project before the installed workflow will run correctly. Referring to the tables:

The "Key value" is the reference variable used by the workflow- do not change this.
The "Default value" is what is currently written in the config file. It is a placeholder meant to show you the format and type of information expected.

Review each default value and make sure it matches exactly what you use in your own repo or Project Board. To make this easier:

The "Suggested value" is the value that the automation found in your repo which seems to be the closest or an exact match.
The "Other suggestions" values are additional possible matches if there is no close match or if the suggested value is not correct.

Please review the defaults and suggestions, select the correct value from your repo, and update the attached configuration file before committing this PR.

Required label(s)

Key value (Do not change)	Default value (in config file)	Suggested value (from your repo)	Other suggestions
statusUpdated:	"status: updated"	"status: updated"	"system update", "NIA status: crafting"
statusInactive1:	"status: to update!"	"status: to update!"	"system update", "feature: issue template"
statusInactive2:	"status: 2 weeks inactive"	"status: 2 weeks inactive"	"time sensitive", "feature: team instructions"
statusHelpWanted:	"status: help wanted"	"status: help wanted"	"system update", "feature: decision record"

Filtering label(s)

Key value (N/A)	Default value (in config file)	Suggested value (from your repo)	Other suggestions
---	"draft"	"draft"	—
---	"er"	no match found	"User Test #2", "p-feature: Footer"
---	"epic"	"epic"	"epic: UX R1 feature improvement", "duplicate"
---	"dependency"	"dependency"	"dependencies", "level: easy"

Project Board status-columns

Key value (Do not change)	Default value (value in config file)	Suggested value (from your repo)	Other suggestions
targetStatus:	"In progress (actively working)"	"In progress (actively working)"	"Prioritized Backlog"
questionsStatus:	"Questions / In Review"	no match found	"Questions/Clarifications", "Technical Review"

ExperimentsInHonesty · 2026-03-26T21:24:02Z

Please ignore this PR, Will and I are working on creating a global automation deployment for managing github issues. TDM is the test project

t-will-gillis · 2026-03-31T19:15:42Z

+        description: 'Run in dry-run mode to preview changes: will not update labels or comments.'
+        type: boolean
+        default: true
+


Revised rollout defines default permissions here:

permissions:
contents: read

These should address the warning.

t-will-gillis

The informational warning is addressed in the latest rollout.
- In Website, we are already adding the default permission statements for all workflows- it is a best practice suggestion rather than any failure.
- Regardless, this has been addressed for the rollout workflow YML.
The two other failing checks were not related to this PR rollout. There is an issue in TDM that addresses a recurring error - ref: PR #3075 fixes #2814. I.e. next time we try the rollout these two errors should not occur.

We are OK to try again on April 2nd.

t-will-gillis · 2026-03-31T21:52:39Z

Additional notes:

Revised initial ATO instructions
Revised commentary in the PR body. See below
Revised behavior of the pattern matching tables: if an exact or near-exact match, will not show "Other suggestions"

hfla-workflow-rollout · 2026-03-31T22:11:00Z

Label & Project Board Suggestions

This PR includes a configuration file with variables — specifically labels and Project Board status-columns — that must be updated to match values already used in your project before the installed workflow will run correctly. Referring to the tables:

The "Key value" is the reference variable used by the workflow- do not change this.
The "Default value" is what is currently written in the config file. It is a placeholder meant to show you the format and type of information expected.

Review each default value and make sure it matches exactly what you use in your own repo or Project Board. To make this easier:

The "Suggested value" is the value that the automation found in your repo which seems to be the closest or an exact match.
The "Other suggestions" values are additional possible matches if there is no close match or if the suggested value is not correct.

Please review the defaults and suggestions, select the correct value from your repo, and update the attached configuration file before committing this PR.

Required label(s)

Key value (Do not change)	Default value (in config file)	Suggested value (from your repo)	Other suggestions
statusUpdated:	"status: updated"	"status: updated"	—
statusInactive1:	"status: to update!"	"status: to update!"	—
statusInactive2:	"status: 2 weeks inactive"	"status: 2 weeks inactive"	—
statusHelpWanted:	"status: help wanted"	"status: help wanted"	—

Filtering label(s)

Key value (N/A)	Default value (in config file)	Suggested value (from your repo)	Other suggestions
---	"draft"	"draft"	—
---	"er"	no match found	"User Test #2", "p-feature: Footer"
---	"epic"	"epic"	—
---	"dependency"	"dependency"	—

Project Board status-columns

Key value (Do not change)	Default value (value in config file)	Suggested value (from your repo)	Other suggestions
targetStatus:	"In progress (actively working)"	"In progress (actively working)"	—
questionsStatus:	"Questions / In Review"	no match found	"Questions/Clarifications", "Technical Review"

t-will-gillis · 2026-03-31T22:14:02Z

PR body preview:

Automated Workflow Setup

This PR adds the "Add Update Label Weekly" GitHub Actions workflow to your project.

Files installed by this PR

Workflow file:
- .github/workflows/add-update-label-weekly.yml
Configuration files:
- github-actions/workflow-configs/add-update-label-weekly-config.yml
- github-actions/workflow-configs/templates/add-update-instructions-template.md

What this workflow does

Monitors open, assigned issues with the default status "In progress (actively working)"
Checks for recent update comments from assignees
Posts reminders for devs to provide issue progress updates
Labels issues that need updates as well as issues that are considered inactive

Security

Uses organization-managed, secure GitHub App with just-in-time token
Starts in dry-run mode (safe testing)
No project-specific tokens or secrets needed

How to use

Review configurations and make changes to the respective files attached to this PR:
- github-actions/workflows/add-update-label-weekly.yml
  - Adjust the cron schedule as needed for your project (https://crontab.cronhub.io/).
  - Current cron is scheduled to run Fridays at 0700 UTC, every week except in July and December.
- github-actions/workflow-configs/add-update-label-weekly-config.yml
  - This configuration file lists all workflow variables that can be customized to match the specific conditions of your project.
  - Each variable has been assigned a default value. Before you run the workflow, carefully review each variable and edit the provided value so that it matches the value used in your repository, or in the case of the "Time thresholds", to set the behavior you want.
  - Configure the values only as specified. Do not edit the variable keys or change the file formatting, otherwise the workflow may crash or behave unexpectedly.
  - "Labels and label placeholders used by this workflow"
    - The labels: section includes different categories of labels. Each label name appears in "double quotes" and must match an existing label in your repository exactly.
      - The required: section lists label placeholder keys that are essential to the workflow. Each key must map- exactly- to an actual label in your project.
      - The filtering: section specifies labels that exclude certain issues from update checks. If an issue has any of these labels, the workflow will skip that issue and not process it.
      - See the config.yml for additional instructions.
  - "Time thresholds (in days)"
    - The timeframes: section defines placeholder keys that represent time thresholds, measured in days. Each issue’s update status is determined by comparing the assignee’s most recent activity timestamp against these defined thresholds.
    - Default values are provided and can be used as-is without modifications. See the config.yml for detailed explanations and, only if needed, for instructions for customizing these values.
  - "Project Board status-column configuration"
    - The projectBoard: section defines placeholder keys representing Project Board status-column names. Similar to the required labels, each placeholder status-column key must map exactly to a status-column on your Project Board.
    - Change the values as needed for an exact match, and ensure the status-column value is in double quotes.
  - "Bot configuration"
    - This section should not need any edits.
  - "Bot comment template"
    - For the optional variable teamSlackChannel: Add your team's Slack Channel (once again in "double quotes") if you want this info on the Bot comment template.
- github-actions/workflow-configs/templates/add-update-instructions-template.md
  - We recommend keeping this version. If needed, edit using markdown syntax.
After configuring and committing the PR
- Test in dry-run preview mode (optional)
  - After you have configured the variables and committed the PR, you can preview the expected behavior by manually triggering the workflow in dry-run preview mode.
  - Go to the "Actions" tab on your main repo page, then scroll down and select "Add Update Label Weekly - ATO" on the left. On the right, click "Run workflow". Select "Check to run in dry-run preview mode..." and then "Run workflow".
  - You may need to refresh the page until you see that the workflow is started. When the run completes successfully, select the most recent "Add-Update-Label-Weekly", then "Run workflow".
  - Review the logs to see which issues would be flagged and how labels would be applied, and check whether this is what you expected or whether you need to change any of the configuration variables.
  - If the workflow ends with an error or if you have questions about any of the configuration variables, contact the team at ATO.
- Live mode
  - Live mode is automatically triggered by the cron job; the automation will run at the next scheduled time.
  - You can also manually trigger a live run outside of the scheduled time: follow the above notes about testing in dry-run preview mode, except when you see the checkbox for "Check to run in dry-run preview mode...", uncheck the box. When you click the final "Run workflow", the workflow will run immediately in live mode.

Auto-generated by Rollout Workflow to Project workflow.

t-will-gillis · 2026-03-31T22:14:17Z

PR comment preview:

Label & Project Board Suggestions

This PR includes a configuration file with variables — specifically labels and Project Board status-columns — that must be updated to match values already used in your project before the installed workflow will run correctly. Referring to the tables:

The "Key value" is the reference variable used by the workflow- do not change this.
The "Default value" is what is currently written in the config file. It is a placeholder meant to show you the format and type of information expected.

Review each default value and make sure it matches exactly what you use in your own repo or Project Board. To make this easier:

The "Suggested value" is the value that the automation found in your repo which seems to be the closest or an exact match.
The "Other suggestions" values are additional possible matches if there is no close match or if the suggested value is not correct.

Please review the defaults and suggestions, select the correct value from your repo, and update the attached configuration file before committing this PR.

Required label(s)

Key value (Do not change)	Default value (in config file)	Suggested value (from your repo)	Other suggestions
statusUpdated:	"status: updated"	"status: updated"	—
statusInactive1:	"status: to update!"	"status: to update!"	—
statusInactive2:	"status: 2 weeks inactive"	"status: 2 weeks inactive"	—
statusHelpWanted:	"status: help wanted"	"status: help wanted"	—

Filtering label(s)

Key value (N/A)	Default value (in config file)	Suggested value (from your repo)	Other suggestions
---	"draft"	"draft"	—
---	"er"	no match found	"User Test #2", "p-feature: Footer"
---	"epic"	"epic"	—
---	"dependency"	"dependency"	—

Project Board status-columns

Key value (Do not change)	Default value (value in config file)	Suggested value (from your repo)	Other suggestions
targetStatus:	"In progress (actively working)"	"In progress (actively working)"	—
questionsStatus:	"Questions / In Review"	no match found	"Questions/Clarifications", "Technical Review"

ExperimentsInHonesty · 2026-04-02T21:15:21Z

We are having trouble getting it to rerun the checks on the new files, so we are going to resubmit the PR

Install Add Update Label Weekly - ATO and project-specific files

fa6f349

github-advanced-security AI found potential problems Mar 26, 2026

View reviewed changes

Comment thread .github/workflows/add-update-label-weekly.yml

ExperimentsInHonesty requested review from ExperimentsInHonesty and t-will-gillis March 26, 2026 21:19

ExperimentsInHonesty marked this pull request as draft March 26, 2026 21:23

t-will-gillis reviewed Mar 31, 2026

View reviewed changes

t-will-gillis self-requested a review March 31, 2026 20:10

t-will-gillis reviewed Mar 31, 2026

View reviewed changes

ExperimentsInHonesty marked this pull request as ready for review April 2, 2026 21:13

ExperimentsInHonesty closed this Apr 2, 2026

t-will-gillis deleted the automation/rollout-central-workflow branch April 2, 2026 21:20

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Install workflow: Add Update Label Weekly - ATO#3066

Install workflow: Add Update Label Weekly - ATO#3066
hfla-workflow-rollout[bot] wants to merge 1 commit intodevelopfrom
automation/rollout-central-workflow

hfla-workflow-rollout bot commented Mar 26, 2026

Uh oh!

hfla-workflow-rollout bot commented Mar 26, 2026

Uh oh!

Uh oh!

ExperimentsInHonesty commented Mar 26, 2026

Uh oh!

t-will-gillis Mar 31, 2026

Uh oh!

t-will-gillis left a comment •

edited

Loading

Uh oh!

t-will-gillis commented Mar 31, 2026

Uh oh!

hfla-workflow-rollout bot commented Mar 31, 2026

Uh oh!

t-will-gillis commented Mar 31, 2026 •

edited

Loading

Uh oh!

t-will-gillis commented Mar 31, 2026

Uh oh!

ExperimentsInHonesty commented Apr 2, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

hfla-workflow-rollout bot commented Mar 26, 2026

Automated Workflow Setup

Files installed by this PR

What this workflow does

Security

How to use

Uh oh!

hfla-workflow-rollout bot commented Mar 26, 2026

Label & Project Board Suggestions

Required label(s)

Filtering label(s)

Project Board status-columns

Uh oh!

Uh oh!

ExperimentsInHonesty commented Mar 26, 2026

Uh oh!

t-will-gillis Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

t-will-gillis left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

t-will-gillis commented Mar 31, 2026

Uh oh!

hfla-workflow-rollout bot commented Mar 31, 2026

Label & Project Board Suggestions

Required label(s)

Filtering label(s)

Project Board status-columns

Uh oh!

t-will-gillis commented Mar 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

PR body preview:

Automated Workflow Setup

Files installed by this PR

What this workflow does

Security

How to use

Uh oh!

t-will-gillis commented Mar 31, 2026

PR comment preview:

Label & Project Board Suggestions

Required label(s)

Filtering label(s)

Project Board status-columns

Uh oh!

ExperimentsInHonesty commented Apr 2, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

t-will-gillis left a comment •

edited

Loading

t-will-gillis commented Mar 31, 2026 •

edited

Loading