Add script to close all open PRs with documentation

Co-authored-by: sam-byng <43856946+sam-byng@users.noreply.github.com>

Author: Copilot

CLOSE_PRS_README.md

@@ -0,0 +1,87 @@
+# Close Pull Requests Script
+
+This script closes all open pull requests in the `github/haikus-for-codespaces` repository with a comment explaining that this is a template repository maintained by the Codespaces team.
+
+## Prerequisites
+
+- Node.js installed
+- A GitHub Personal Access Token with `repo` permissions
+
+## How to Get a GitHub Token
+
+1. Go to https://github.com/settings/tokens
+2. Click "Generate new token" (classic)
+3. Give it a descriptive name like "Close PRs Script"
+4. Select the `repo` scope (full control of private repositories)
+5. Click "Generate token"
+6. **Copy the token immediately** (you won't be able to see it again)
+
+## Usage
+
+```bash
+# Set your GitHub token as an environment variable
+export GITHUB_TOKEN=your_github_token_here
+
+# Run the script
+node close-prs.js
+```
+
+Or in a single command:
+
+```bash
+GITHUB_TOKEN=your_github_token_here node close-prs.js
+```
+
+## What the Script Does
+
+1. Fetches all open pull requests in the repository
+2. For each open PR:
+   - Adds a comment: "This is a template repo, with changes owned by the Codespaces team."
+   - Closes the pull request
+3. Reports the status of each operation
+
+## Example Output
+
+```
+Fetching open PRs for github/haikus-for-codespaces...
+Found 8 open pull request(s).
+
+Processing PR #463: [WIP] Force close all open PRs in template repo
+  Adding comment...
+  Closing PR...
+  ✓ Successfully closed PR #463
+
+Processing PR #462: Create from wahyu to ania
+  Adding comment...
+  Closing PR...
+  ✓ Successfully closed PR #462
+
+...
+
+Done!
+```
+
+## Security Notes
+
+- Never commit your GitHub token to the repository
+- Use environment variables to pass sensitive credentials
+- The token should have minimal required permissions (repo scope)
+- Consider deleting the token after use
+
+## Alternative: Using GitHub CLI
+
+If you have `gh` (GitHub CLI) installed, you can also use it:
+
+```bash
+# List all open PRs
+gh pr list --repo github/haikus-for-codespaces --state open
+
+# Close each PR with a comment (manual approach)
+gh pr close <PR_NUMBER> --repo github/haikus-for-codespaces --comment "This is a template repo, with changes owned by the Codespaces team."
+```
+
+## Notes
+
+- This script uses the native Node.js `https` module (no external dependencies required)
+- The script will process all open PRs, including the one it was created from
+- Failed operations are logged but don't stop the script from processing remaining PRs

close-prs.js

@@ -0,0 +1,160 @@
+#!/usr/bin/env node
+
+/**
+ * Script to close all open Pull Requests in the repository
+ * with a specific comment explaining why they are being closed.
+ * 
+ * This repository is a template repo maintained by the Codespaces team.
+ * 
+ * Usage:
+ *   GITHUB_TOKEN=your_token node close-prs.js
+ * 
+ * Note: Requires a GitHub token with repo permissions
+ */
+
+const https = require('https');
+
+const OWNER = 'github';
+const REPO = 'haikus-for-codespaces';
+const COMMENT_MESSAGE = 'This is a template repo, with changes owned by the Codespaces team.';
+const GITHUB_TOKEN = process.env.GITHUB_TOKEN;
+
+if (!GITHUB_TOKEN) {
+  console.error('Error: GITHUB_TOKEN environment variable is required');
+  console.error('Usage: GITHUB_TOKEN=your_token node close-prs.js');
+  process.exit(1);
+}
+
+/**
+ * Make an HTTPS request to GitHub API
+ */
+function makeRequest(options, data = null) {
+  return new Promise((resolve, reject) => {
+    const req = https.request(options, (res) => {
+      let body = '';
+      
+      res.on('data', (chunk) => {
+        body += chunk;
+      });
+      
+      res.on('end', () => {
+        if (res.statusCode >= 200 && res.statusCode < 300) {
+          try {
+            resolve(JSON.parse(body || '{}'));
+          } catch (e) {
+            resolve(body);
+          }
+        } else {
+          reject(new Error(`Request failed with status ${res.statusCode}: ${body}`));
+        }
+      });
+    });
+    
+    req.on('error', reject);
+    
+    if (data) {
+      req.write(JSON.stringify(data));
+    }
+    
+    req.end();
+  });
+}
+
+/**
+ * Get all open pull requests
+ */
+async function getOpenPRs() {
+  const options = {
+    hostname: 'api.github.com',
+    path: `/repos/${OWNER}/${REPO}/pulls?state=open&per_page=100`,
+    method: 'GET',
+    headers: {
+      'User-Agent': 'close-prs-script',
+      'Authorization': `Bearer ${GITHUB_TOKEN}`,
+      'Accept': 'application/vnd.github.v3+json'
+    }
+  };
+  
+  return makeRequest(options);
+}
+
+/**
+ * Add a comment to a pull request
+ */
+async function addComment(prNumber, message) {
+  const options = {
+    hostname: 'api.github.com',
+    path: `/repos/${OWNER}/${REPO}/issues/${prNumber}/comments`,
+    method: 'POST',
+    headers: {
+      'User-Agent': 'close-prs-script',
+      'Authorization': `Bearer ${GITHUB_TOKEN}`,
+      'Accept': 'application/vnd.github.v3+json',
+      'Content-Type': 'application/json'
+    }
+  };
+  
+  return makeRequest(options, { body: message });
+}
+
+/**
+ * Close a pull request
+ */
+async function closePR(prNumber) {
+  const options = {
+    hostname: 'api.github.com',
+    path: `/repos/${OWNER}/${REPO}/pulls/${prNumber}`,
+    method: 'PATCH',
+    headers: {
+      'User-Agent': 'close-prs-script',
+      'Authorization': `Bearer ${GITHUB_TOKEN}`,
+      'Accept': 'application/vnd.github.v3+json',
+      'Content-Type': 'application/json'
+    }
+  };
+  
+  return makeRequest(options, { state: 'closed' });
+}
+
+/**
+ * Main function
+ */
+async function main() {
+  try {
+    console.log(`Fetching open PRs for ${OWNER}/${REPO}...`);
+    const prs = await getOpenPRs();
+    
+    if (prs.length === 0) {
+      console.log('No open pull requests found.');
+      return;
+    }
+    
+    console.log(`Found ${prs.length} open pull request(s).`);
+    
+    for (const pr of prs) {
+      console.log(`\nProcessing PR #${pr.number}: ${pr.title}`);
+      
+      try {
+        // Add comment
+        console.log(`  Adding comment...`);
+        await addComment(pr.number, COMMENT_MESSAGE);
+        
+        // Close the PR
+        console.log(`  Closing PR...`);
+        await closePR(pr.number);
+        
+        console.log(`  ✓ Successfully closed PR #${pr.number}`);
+      } catch (error) {
+        console.error(`  ✗ Failed to close PR #${pr.number}:`, error.message);
+      }
+    }
+    
+    console.log('\nDone!');
+  } catch (error) {
+    console.error('Error:', error.message);
+    process.exit(1);
+  }
+}
+
+// Run the script
+main();