Add expires support for create-pull-request safe-outputs (#12344)

* Initial plan

* Add expires field support for pull-request safe-outputs

- Added close_expired_pull_requests.cjs script following same pattern as issues/discussions
- Updated maintenance_workflow.go to include pull requests in expires checking
- Added pull-requests: write permission to maintenance job
- Added step to close expired pull requests in maintenance workflow
- Updated documentation in maintenance workflow comments

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

* Add tests for close_expired_pull_requests

- Created comprehensive test suite for close_expired_pull_requests.cjs
- Tests cover: no PRs found, expired PRs, not expired PRs, error handling, pagination
- All 5 tests passing
- Follows same testing pattern as close_expired_discussions

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

* Add expires field to pull request safe-outputs config generation

- Updated generatePullRequestConfig to include expires parameter
- Updated function call to pass CreatePullRequests.Expires
- Config now properly includes expires field in generated workflows
- Verified with test workflow compilation

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

* Complete: Add expires field support for pull-request safe-outputs

All requirements implemented and tested:
- Expires field on create-pull-request configuration ✓
- XML comment marker for PR expiration ✓
- AI footer with expiration date ✓
- Maintenance job step to close expired PRs ✓
- Full test coverage ✓
- All workflows recompiled successfully ✓

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

* Use lowercase identifier in gh-aw-expires-type XML comment

Changed "Pull Request" to "pull-request" in XML comment for searchability as requested by @pelikhan

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

* Add 7d expires to daily workflows with create-pull-request

Added expires: 7d to create-pull-request configurations in:
- daily-doc-updater.md
- daily-workflow-updater.md

This ensures PRs from daily automation workflows are automatically closed after 7 days if not merged.

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

* Add changeset [skip-ci]

* Update dev workflow to create PR with poem and 2h expiration

Modified dev.md workflow to:
- Add single line poem to poems.txt
- Create pull request with expires: 2h
- Set as draft PR with [dev] prefix
- Updated description and requirements

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

* Merge main, format, and lint

- Merged main branch into feature branch
- Resolved merge conflict in dev.lock.yml by keeping dev version
- Ran make fmt - all files formatted successfully
- Ran make lint - all validations passed
- All 141 workflows recompiled successfully

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: Peli de Halleux <pelikhan@users.noreply.github.com>

Author: 3 people

.changeset/patch-add-pr-expires.md

@@ -26,7 +26,7 @@
 # ./gh-aw compile --validate --verbose
 # 
 # The workflow is generated when any workflow uses the 'expires' field
-# in create-discussions or create-issues safe-outputs configuration.
+# in create-discussions, create-issues, or create-pull-request safe-outputs configuration.
 # Schedule frequency is automatically determined by the shortest expiration time.
 #
 name: Agentic Maintenance
@@ -44,6 +44,7 @@ jobs:
     permissions:
       discussions: write
       issues: write
+      pull-requests: write
     steps:
       - name: Checkout actions folder
         uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
@@ -75,6 +76,15 @@ jobs:
             const { main } = require('/opt/gh-aw/actions/close_expired_issues.cjs');
             await main();
 
+      - name: Close expired pull requests
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
+        with:
+          script: |
+            const { setupGlobals } = require('/opt/gh-aw/actions/setup_globals.cjs');
+            setupGlobals(core, github, context, exec, io);
+            const { main } = require('/opt/gh-aw/actions/close_expired_pull_requests.cjs');
+            await main();
+
   compile-workflows:
     runs-on: ubuntu-slim
     permissions:

.github/workflows/agentics-maintenance.yml

@@ -23,6 +23,7 @@ network:
 
 safe-outputs:
   create-pull-request:
+    expires: 7d
     title-prefix: "[docs] "
     labels: [documentation, automation]
     reviewers: [copilot]

.github/workflows/ci-coach.lock.yml

@@ -23,6 +23,7 @@ network:
 
 safe-outputs:
   create-pull-request:
+    expires: 7d
     title-prefix: "[actions] "
     labels: [dependencies, automation]
     draft: false