Merge pull request #640 from Azure/canary

Canary

Author: likamrat

.github/policies/resourceManagement.yml

@@ -70,6 +70,7 @@ configuration:
           # Add Needs-Triage label to new issues
           - addLabel:
               label: Needs-Triage
+          # Apply project-specific labels based on issue title keywords
           - if:
               # Identifiy if the issue title contains the word "arcbox"
               - titleContains:
@@ -133,6 +134,7 @@ configuration:
       # Handles issue closing, reopening, and duplicate detection
       # ---------------------------------------------------------------------------
       - description: Clear labels when an issue is closed
+        # Auto-cleanup - removes working labels and adds resolution label
         triggerOnOwnActions: false
         if:
         - payloadType: Issues
@@ -154,6 +156,7 @@ configuration:
                 We've closed this issue because it has been addressed. If you believe further discussion is needed, please add a comment "`/unresolve`" to reopen the issue.    
 
       - description: Reopen unresolved issues
+        # Triggered by the keyword "/unresolve" in comments
         triggerOnOwnActions: false
         if:
         - payloadType: Issue_Comment
@@ -179,16 +182,19 @@ configuration:
         - reopenIssue
 
       - description: Add needs attention label to reopened issues
+        # Ensures reopened issues get proper attention from maintainers
         triggerOnOwnActions: false
         if:
         - payloadType: Issues
         - isAction:
             action: Reopened
         then:
+        # Clear resolution labels when an issue is reopened
         - removeLabel:
             label: Issue-Addressed
         - removeLabel:
             label: Resolution-Duplicate            
+        # Mark for team attention
         - addLabel:
             label: Needs-Attention
         - addReply:
@@ -197,11 +203,16 @@ configuration:
 
                 We've reopened this issue because we need more information from you or we identified it is not completely resolved.
 
+      # ---------------------------------------------------------------------------
+      # DUPLICATE ISSUE HANDLING
+      # Manages issues identified as duplicates in comments
+      # ---------------------------------------------------------------------------
       - description: Add Resolution-Duplicate label to issues or PRs that are identified as duplicates
         triggerOnOwnActions: false
         if:
         - payloadType: Issue_Comment
         - and:
+            # Look for various forms of "duplicate" in comments
             - commentContains:
                 pattern: "(?i)duplicat(e|ed|ing)?"
                 isRegex: True
@@ -213,6 +224,7 @@ configuration:
                 We've identified this as a duplicate of another issue or PR that already exists. This specific instance is being closed in favor of the linked issue. Please add your 👍 to the other issue to raise its priority. Thanks for your contribution!
 
         - closeIssue
+        # Remove all working labels
         - removeLabel:
             label: Needs-Triage
         - removeLabel:
@@ -221,71 +233,92 @@ configuration:
             label: Needs-Feedback-Hub
         - removeLabel:
             label: Needs-Author-Feedback
+        # Add resolution label
         - addLabel:
             label: Resolution-Duplicate
 
     # ===========================================================================
     # SCHEDULED SEARCHES
-    # Periodic tasks that run on defined schedules
+    # Periodic tasks that run on defined schedules to maintain repository hygiene
     # ===========================================================================
     scheduledSearches:
-    - description: Close stale issues
+    # ---------------------------------------------------------------------------
+    # STALE ISSUE MANAGEMENT
+    # Automatically closes issues that need feedback but have no activity
+    # ---------------------------------------------------------------------------
+    - description: Close stale issues. Issues that have not had any activity for 7 days and are labeled with Needs-Author-Feedback and No-Recent-Activity will be closed.
       frequencies:
-      - daily:
-          time: 1:0      # Runs at 1:00 AM daily
+      - hourly:
+          hour: 6
       filters:
+      # Only target issues that are open and need author feedback
+      # Exclude issues that are labeled with Feature-Request or Upstream-Bug-Issue    
       - isIssue
       - isOpen
       - hasLabel:
           label: Needs-Author-Feedback
       - hasLabel:
           label: No-Recent-Activity
+      # Exclude issues that may need longer response times
+      - isNotLabeledWith:
+          label: Feature-Request
+      - isNotLabeledWith:
+          label: Upstream-Bug-Issue             
       - noActivitySince:
-          days: 21       # 3 weeks of inactivity
+          days: 7
       actions:
       - closeIssue
-      
-    - description: Add no recent activity label to issues
+      # Add closure label for tracking
+      - addLabel:
+          label: Close-Stale
+      # Remove triage label as it's no longer needed
+      - removeLabel:
+          label: Needs-Triage
+
+    - description: Add No-Recent-Activity label to issues that have not had any activity for 7 days
+      # First warning stage before closing stale issues
       frequencies:
       - hourly:
-          hour: 6        # Runs at 6:00 every hour
+          hour: 6
       filters:
       - isIssue
       - isOpen
       - hasLabel:
           label: Needs-Author-Feedback
       - noActivitySince:
-          days: 7        # 1 week of inactivity
+          days: 7
       - isNotLabeledWith:
           label: No-Recent-Activity
       actions:
+      # Mark as inactive
       - addLabel:
           label: No-Recent-Activity
+      # Notify author with clear timeline for resolution
       - addReply:
           reply: >-
-            Hello @${issueAuthor}, 
-            
-            We're sending this friendly reminder because we haven't heard back from you in a while and we need more information about this issue to help address it. Please be sure to give us your input within the next **7 days**. If we don't hear back from you within **14 days** of this comment the issue will be automatically closed. Thank you!
-          
-    - description: '[Resolve Workflow] Close Addressed Issues'
+                Hello @${issueAuthor},
+
+                we're sending this friendly reminder because we haven't heard back from you in a while and we need more information about this issue to help address it. Please be sure to give us your input within the next **7 days**. If we don't hear back from you within **7 days** of this comment the issue will be automatically closed. Thank you!
+
+    - description: Close issues that have not had any activity for 7 days and are labeled with Issue-Addressed
+      # Auto-close resolved issues after waiting period for any objections
       frequencies:
       - hourly:
-          hour: 6        # Runs at 6:00 every hour
+          hour: 6
       filters:
       - isIssue
       - isOpen
       - hasLabel:
           label: Issue-Addressed
       - noActivitySince:
-          days: 7        # 1 week of inactivity
+          days: 7
       actions:
-      - addReply: 
+      # Final notification before closure
+      - addReply:
           reply: >-
-          
-            Hello @${issueAuthor}, 
-            
-            Since you haven't asked that we "`/unresolve`" the issue, we'll close this out. If you believe further discussion is needed, please add a comment "`/unresolve`" to reopen the issue.
+                Hello @${issueAuthor}, since you haven’t asked that we “`/unresolve`” the issue, we’ll close this out. If you believe further discussion is needed, please add a comment “`/unresolve`” to reopen the issue.
 
+      # Close the issue after waiting period
       - closeIssue
 
 # Configuration for handling failures or success events