From a0fe41b11f3a9df159410cffff6cc4680531a995 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20G=C3=B3rny?= <mgorny@quansight.com>
Date: Mon, 23 Mar 2026 17:44:04 +0100
Subject: [PATCH 1/2] Automatically file archive issue
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add a `reason` field that can be used to file the archiving issue on the
feedstock automatically.

Fixes #1324

Signed-off-by: Michał Górny <mgorny@quansight.com>
---
 .github/PULL_REQUEST_TEMPLATE/archive.md        |  3 +--
 conda_forge_admin_requests/archive_feedstock.py | 16 ++++++++++++++--
 examples/example-archive.yml                    |  4 ++++
 3 files changed, 19 insertions(+), 4 deletions(-)

diff --git a/.github/PULL_REQUEST_TEMPLATE/archive.md b/.github/PULL_REQUEST_TEMPLATE/archive.md
index a93438adf..57fb5ebf5 100644
--- a/.github/PULL_REQUEST_TEMPLATE/archive.md
+++ b/.github/PULL_REQUEST_TEMPLATE/archive.md
@@ -13,8 +13,7 @@ Cheers and thank you for contributing to conda-forge!
 
 * [x] I want to archive a feedstock:
   * [ ] Pinged the team for that feedstock for their input.
-  * [ ] Make sure you have opened an issue on the feedstock explaining why it was archived.
-  * [ ] Linked that issue in this PR description.
+  * [ ] Specified the reason for archiving the feedstock in the request.
   * [ ] Added links to any other relevant issues/PRs in the PR description.
 
 <!--
diff --git a/conda_forge_admin_requests/archive_feedstock.py b/conda_forge_admin_requests/archive_feedstock.py
index b44361b22..652fb8b53 100644
--- a/conda_forge_admin_requests/archive_feedstock.py
+++ b/conda_forge_admin_requests/archive_feedstock.py
@@ -5,7 +5,7 @@
 from .utils import GH_ORG, get_gh_headers, raise_json_for_status
 
 
-def process_repo(repo, task):
+def process_repo(repo, task, reason=None):
     owner = GH_ORG
     headers = get_gh_headers()
 
@@ -29,6 +29,18 @@ def process_repo(repo, task):
         print(f"feedstock {repo} is already {target_status}", flush=True)
         return
 
+    if task == "archive" and reason is not None:
+        r = requests.post(
+            f"https://api.github.com/repos/{owner}/{repo}/issues",
+            headers=headers,
+            json={
+                "title": "Archive the feedstock",
+                "body": reason,
+            },
+        )
+        raise_json_for_status(r)
+        print(f"archival issue created: {r.json()['html_url']}", flush=True)
+
     r = requests.patch(
         f"https://api.github.com/repos/{owner}/{repo}",
         headers=headers,
@@ -46,7 +58,7 @@ def run(request):
     pkgs_to_do_again = []
     for feedstock in feedstocks:
         try:
-            process_repo(f"{feedstock}-feedstock", task)
+            process_repo(f"{feedstock}-feedstock", task, reason=request.get("reason"))
         except Exception as e:
             print(f"failed to {task} '{feedstock}': {e!r}", flush=True)
             pkgs_to_do_again.append(feedstock)
diff --git a/examples/example-archive.yml b/examples/example-archive.yml
index 1e3c16296..d52c6a26e 100644
--- a/examples/example-archive.yml
+++ b/examples/example-archive.yml
@@ -1,3 +1,7 @@
 action: archive
+# The reason will be used to create the archival issue on the feedstock.
+# If one is already present, remove it.
+reason: >
+  The project has been archived upstream.
 feedstocks:
   - cf-autotick-bot-test-package

From 023daa940c4c996c69df729e4bdf6cb246d669a7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20G=C3=B3rny?= <mgorny@quansight.com>
Date: Wed, 8 Apr 2026 15:00:19 +0200
Subject: [PATCH 2/2] Clarify the YAML comment
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Michał Górny <mgorny@quansight.com>
---
 examples/example-archive.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/examples/example-archive.yml b/examples/example-archive.yml
index d52c6a26e..9afeab20a 100644
--- a/examples/example-archive.yml
+++ b/examples/example-archive.yml
@@ -1,6 +1,6 @@
 action: archive
 # The reason will be used to create the archival issue on the feedstock.
-# If one is already present, remove it.
+# If one is already present, remove the "reason:" key to disable creating a new issue.
 reason: >
   The project has been archived upstream.
 feedstocks: