Skip to content

chore(workflows): consolidate deps-release-notes into rolling issues and add bot-issue janitor#1306

Merged
jamesadevine merged 1 commit into
mainfrom
chore/backlog-issue-cleanup-workflows
Jul 2, 2026
Merged

chore(workflows): consolidate deps-release-notes into rolling issues and add bot-issue janitor#1306
jamesadevine merged 1 commit into
mainfrom
chore/backlog-issue-cleanup-workflows

Conversation

@jamesadevine

Copy link
Copy Markdown
Collaborator

Summary

Our issue automation only grew the backlog — issue-triage labels and issue-arborist clusters into parent/sub-issue trees, but nothing pruned it. As a result the open backlog was dominated by self-superseding bot-authored issues: ~34 [deps-release-notes] issues (one per upstream release), repeated [aw] … failed / rate-limit failure reports, and superseded recompile-fixture chores.

This PR adds the missing cleanup and stops the churn at its source.

1. update-awf-version — single rolling issue per dependency (edit)

Previously filed a new [deps-release-notes] <token> v<version> action items issue for every upstream release. Now it maintains one canonical rolling issue per component (awf / mcpg / copilot-cli), titled:

[deps-release-notes] <token> — upstream release action items

and appends a comment per version bump (creating the canonical issue only if none exists). Adds add-comment to safe-outputs; keeps close-issue for strays. PR-body "Action Items" wording updated to point at the rolling issue.

2. deps-notes-consolidator — backlog backfill (new, weekly + workflow_dispatch)

Per component: picks the newest issue as canonical, rewrites its body into a consolidated earliest→latest history (preserving every action-item bullet and release link), retitles it to the stable versionless form, and closes the superseded per-release issues as not_planned. Collapses the current 34 → 3.

3. stale-bot-issue-janitor — duplicate/superseded closer (new, weekly + workflow_dispatch)

Closes, keeping only the most recent of each:

  • Exact-title [aw] … failure-report duplicates (e.g. Documentation Freshness Check failed, hit AI credits rate limit).
  • Superseded chore(workflows): recompile safe-output fixtures with ado-aw vX issues (keeps highest version).

Safety rails: candidate set is restricted to --author app/github-actions (can never touch a human issue), singletons are never closed, and there's a hard never-close protect-list for the healthy rolling aggregates [aw] No-Op Runs (#13) and [aw] Detection Runs (#793).

Test plan

  • CI=true gh aw compile <name> for all three workflows — 0 errors, 0 warnings each; .lock.yml files regenerated.
  • Verified compiled safe-output configs in the lock files:
    • update-awf-version: add_comment + close_issue (both target:"*", prefix [deps-release-notes] ).
    • deps-notes-consolidator: update_issue (title+body, target:"*") + close_issue (not_planned).
    • stale-bot-issue-janitor: close_issue (target:"*", not_planned, max 40).
  • Reverted incidental EOL-only churn in agentics-maintenance.yml (content-identical).
  • Post-merge: run the two new workflows via workflow_dispatch to perform the initial sweeps.

…nitor

Nothing was pruning the bot-authored issue backlog, so it filled with
self-superseding issues. This adds cleanup and stops the churn at source.

- update-awf-version: instead of opening a new [deps-release-notes] issue
  per upstream release, maintain a single canonical rolling issue per
  component (awf/mcpg/copilot-cli) titled
  "[deps-release-notes] <token> — upstream release action items" and append
  a comment per version bump.
- deps-notes-consolidator (new, weekly + dispatch): folds the existing
  per-release backlog into the newest issue per component (preserving all
  action-item history) and closes the superseded ones as not_planned.
- stale-bot-issue-janitor (new, weekly + dispatch): closes exact-title
  duplicate [aw] failure reports and superseded recompile-fixture chore
  issues, keeping only the most recent of each. Scoped to bot-authored
  issues with a hard protect-list for the [aw] No-Op Runs / Detection Runs
  rolling aggregates.

Co-authored-by: Copilot <[email protected]>
@jamesadevine jamesadevine merged commit 63ea238 into main Jul 2, 2026
13 checks passed
@jamesadevine jamesadevine deleted the chore/backlog-issue-cleanup-workflows branch July 2, 2026 12:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant