From 986bcd521f9c30c3262bf0d065f9673e668f6488 Mon Sep 17 00:00:00 2001
From: Andy Kenward <4893048+andykenward@users.noreply.github.com>
Date: Sun, 3 May 2026 18:05:45 +0000
Subject: [PATCH 1/4] docs: custom agent

---
 .github/agents/cf-pages-feature.agent.md | 94 ++++++++++++++++++++++++
 1 file changed, 94 insertions(+)
 create mode 100644 .github/agents/cf-pages-feature.agent.md

diff --git a/.github/agents/cf-pages-feature.agent.md b/.github/agents/cf-pages-feature.agent.md
new file mode 100644
index 00000000..68b24f64
--- /dev/null
+++ b/.github/agents/cf-pages-feature.agent.md
@@ -0,0 +1,94 @@
+---
+description: "Use when adding a new feature, input, GitHub API operation, or Cloudflare API change to this dual-mode GitHub Actions project (deploy + delete actions for Cloudflare Pages). Triggers on: add input, new action input, new GraphQL mutation/query/fragment, new Cloudflare API endpoint, add feature to deploy action, add feature to delete action."
+name: "CF Pages Feature Agent"
+tools: [read, edit, search, execute, todo]
+argument-hint: "Describe the feature, input, or operation you want to add (e.g. 'add a new optional input to skip SSL verification' or 'add a GraphQL mutation to update a deployment status')"
+---
+
+You are a specialist for adding new features to this dual-mode GitHub Actions project that deploys to Cloudflare Pages. You have deep knowledge of the project's conventions and multi-file synchronization requirements.
+
+## Project Architecture
+
+- **Deploy action**: `src/deploy/` → bundled to `dist/deploy/index.js` → consumed by `action.yml`
+- **Delete action**: `src/delete/` → bundled to `dist/delete/index.js` → consumed by `delete/action.yml`
+- **Shared logic**: `src/common/` (GitHub API, Cloudflare API, batch ops, utilities)
+- **Path aliases**: All imports use `@/` prefix (e.g. `@/common/utils.js`). Keep `tsconfig.json` paths in sync with `vitest.config.ts` `resolve.alias`.
+
+## Strict Conventions
+
+### Logging
+- **NEVER use `console.log`** — use `@actions/core` methods only: `core.info()`, `core.debug()`, `core.warning()`, `core.error()`, `core.setFailed()`
+
+### Error Handling
+- Use `raise()` from `src/common/utils.ts` for inline errors with type narrowing:
+  ```typescript
+  const {name} = (await checkEnvironment()) ?? raise('Environment required')
+  ```
+
+### GraphQL
+- Prefix mutations: `MutationCreateGitHubDeployment`
+- Prefix fragments: `EnvironmentFragment`
+- Always use the tagged template: `graphql(/* GraphQL */ \`...\`)`
+- Place shared fragments in `src/common/github/fragments.ts`
+- **Run `pnpm run codegen` after any GraphQL change** to regenerate `__generated__/gql/`
+
+### Testing
+- Mock `@actions/core` via `vi.mock(import('@actions/core'))` — auto-loads `__mocks__/@actions/core.ts`
+- Mock HTTP with undici `MockAgent` pattern (see `__tests__/helpers/api.ts`)
+- Use `stubRequiredInputEnv()` from `__tests__/helpers/inputs.ts` for action input env vars
+- Use `stubTestEnvVars()` from `__tests__/helpers/env.ts` for GitHub context env vars
+- Always assert `mockApi.mockAgent.assertNoPendingInterceptors()` to catch unmatched HTTP calls
+- Use `describe(functionName)` with actual function reference for IDE navigation
+
+## Feature Addition Workflow
+
+Work through these steps in order, using the todo list to track progress.
+
+### Step 1 — Understand the Request
+Read the relevant existing files to understand current patterns before making changes. Search for similar existing inputs/operations as reference.
+
+### Step 2 — Update Action Manifest
+Depending on whether this affects the deploy action, delete action, or both:
+- **Deploy**: Edit `action.yml` — add input under `inputs:` with `description`, `required`, and optional `default`
+- **Delete**: Edit `delete/action.yml` — same structure
+- If the input key is new, add `INPUT_KEY_*` constant to `input-keys.ts` and add to `INPUT_KEYS_REQUIRED` if mandatory
+
+### Step 3 — Implement in Source
+- Add input reading logic to `src/deploy/inputs.ts` or `src/delete/inputs.ts` (or both)
+- For shared logic, add to `src/common/inputs.ts`
+- Wire up the new input/operation in the relevant `main.ts`
+
+### Step 4 — Add GraphQL (if applicable)
+- Write the query/mutation/fragment in the appropriate file
+- Use the `graphql(/* GraphQL */ \`...\`)` tag
+- Run `pnpm run codegen` to generate types
+
+### Step 5 — Add Cloudflare API Types (if applicable)
+- Update types in `src/common/cloudflare/types.ts`
+- Add response fixtures to `__generated__/responses/api.cloudflare.com/` if needed
+
+### Step 6 — Update Test Stubs
+- Add the new input to `__tests__/helpers/inputs.ts` `stubRequiredInputEnv()` if it's required
+- Add fixtures to `__generated__/responses/` if new API responses are needed
+
+### Step 7 — Write Tests
+- Create or update the relevant `.test.ts` file under `__tests__/` mirroring the `src/` structure
+- Cover happy path, error path, and edge cases
+- Assert no pending interceptors after HTTP calls
+
+### Step 8 — Validate
+Run the full validation suite:
+```bash
+pnpm run all
+```
+This runs: knip → codegen → tsc → format → lint → test → build
+
+Fix any errors before considering the task complete.
+
+## Output
+
+After completing all steps, summarize:
+1. Which files were changed and why
+2. Any codegen commands that were run
+3. Test results
+4. Any follow-up actions the user should take (e.g. updating GitHub Environment permissions)

From a66edf3160368ce29b36671bf910be9ae3f91b6d Mon Sep 17 00:00:00 2001
From: Andy Kenward <4893048+andykenward@users.noreply.github.com>
Date: Sun, 3 May 2026 18:17:06 +0000
Subject: [PATCH 2/4] docs: payloads

---
 __generated__/payloads/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/__generated__/payloads/README.md b/__generated__/payloads/README.md
index 4926b79b..31d4f701 100644
--- a/__generated__/payloads/README.md
+++ b/__generated__/payloads/README.md
@@ -10,4 +10,4 @@ You can update these example files by running the below command.
 pnpm run download
 ```
 
-See [../bin/download/payloads](../bin/download/payloads)
\ No newline at end of file
+See [../bin/download](../bin/download/payloads/downloads/index.ts)
\ No newline at end of file

From 986c52b3fb86041106f98d8b74f5c8df2ff3ab99 Mon Sep 17 00:00:00 2001
From: Andy Kenward <4893048+andykenward@users.noreply.github.com>
Date: Sun, 3 May 2026 18:17:46 +0000
Subject: [PATCH 3/4] chore: add payloads pull_request_target

---
 bin/download/payloads/github-webhooks-payload-examples.ts | 1 +
 1 file changed, 1 insertion(+)

diff --git a/bin/download/payloads/github-webhooks-payload-examples.ts b/bin/download/payloads/github-webhooks-payload-examples.ts
index d406b2ff..736963a8 100644
--- a/bin/download/payloads/github-webhooks-payload-examples.ts
+++ b/bin/download/payloads/github-webhooks-payload-examples.ts
@@ -120,6 +120,7 @@ const run = async (folder: string) => {
 }
 
 void run('pull_request')
+void run('pull_request_target')
 void run('push')
 void run('workflow_run')
 void run('workflow_dispatch')

From 20136e9b5000b29f6ee8234e57d44ea3e27f4629 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Sun, 3 May 2026 18:20:19 +0000
Subject: [PATCH 4/4] chore: update types

---
 .github/agents/cf-pages-feature.agent.md | 20 ++++++++++++++++++--
 1 file changed, 18 insertions(+), 2 deletions(-)

diff --git a/.github/agents/cf-pages-feature.agent.md b/.github/agents/cf-pages-feature.agent.md
index 68b24f64..6ebc617b 100644
--- a/.github/agents/cf-pages-feature.agent.md
+++ b/.github/agents/cf-pages-feature.agent.md
@@ -1,6 +1,6 @@
 ---
-description: "Use when adding a new feature, input, GitHub API operation, or Cloudflare API change to this dual-mode GitHub Actions project (deploy + delete actions for Cloudflare Pages). Triggers on: add input, new action input, new GraphQL mutation/query/fragment, new Cloudflare API endpoint, add feature to deploy action, add feature to delete action."
-name: "CF Pages Feature Agent"
+description: 'Use when adding a new feature, input, GitHub API operation, or Cloudflare API change to this dual-mode GitHub Actions project (deploy + delete actions for Cloudflare Pages). Triggers on: add input, new action input, new GraphQL mutation/query/fragment, new Cloudflare API endpoint, add feature to deploy action, add feature to delete action.'
+name: 'CF Pages Feature Agent'
 tools: [read, edit, search, execute, todo]
 argument-hint: "Describe the feature, input, or operation you want to add (e.g. 'add a new optional input to skip SSL verification' or 'add a GraphQL mutation to update a deployment status')"
 ---
@@ -17,15 +17,18 @@ You are a specialist for adding new features to this dual-mode GitHub Actions pr
 ## Strict Conventions
 
 ### Logging
+
 - **NEVER use `console.log`** — use `@actions/core` methods only: `core.info()`, `core.debug()`, `core.warning()`, `core.error()`, `core.setFailed()`
 
 ### Error Handling
+
 - Use `raise()` from `src/common/utils.ts` for inline errors with type narrowing:
   ```typescript
   const {name} = (await checkEnvironment()) ?? raise('Environment required')
   ```
 
 ### GraphQL
+
 - Prefix mutations: `MutationCreateGitHubDeployment`
 - Prefix fragments: `EnvironmentFragment`
 - Always use the tagged template: `graphql(/* GraphQL */ \`...\`)`
@@ -33,6 +36,7 @@ You are a specialist for adding new features to this dual-mode GitHub Actions pr
 - **Run `pnpm run codegen` after any GraphQL change** to regenerate `__generated__/gql/`
 
 ### Testing
+
 - Mock `@actions/core` via `vi.mock(import('@actions/core'))` — auto-loads `__mocks__/@actions/core.ts`
 - Mock HTTP with undici `MockAgent` pattern (see `__tests__/helpers/api.ts`)
 - Use `stubRequiredInputEnv()` from `__tests__/helpers/inputs.ts` for action input env vars
@@ -45,42 +49,53 @@ You are a specialist for adding new features to this dual-mode GitHub Actions pr
 Work through these steps in order, using the todo list to track progress.
 
 ### Step 1 — Understand the Request
+
 Read the relevant existing files to understand current patterns before making changes. Search for similar existing inputs/operations as reference.
 
 ### Step 2 — Update Action Manifest
+
 Depending on whether this affects the deploy action, delete action, or both:
+
 - **Deploy**: Edit `action.yml` — add input under `inputs:` with `description`, `required`, and optional `default`
 - **Delete**: Edit `delete/action.yml` — same structure
 - If the input key is new, add `INPUT_KEY_*` constant to `input-keys.ts` and add to `INPUT_KEYS_REQUIRED` if mandatory
 
 ### Step 3 — Implement in Source
+
 - Add input reading logic to `src/deploy/inputs.ts` or `src/delete/inputs.ts` (or both)
 - For shared logic, add to `src/common/inputs.ts`
 - Wire up the new input/operation in the relevant `main.ts`
 
 ### Step 4 — Add GraphQL (if applicable)
+
 - Write the query/mutation/fragment in the appropriate file
 - Use the `graphql(/* GraphQL */ \`...\`)` tag
 - Run `pnpm run codegen` to generate types
 
 ### Step 5 — Add Cloudflare API Types (if applicable)
+
 - Update types in `src/common/cloudflare/types.ts`
 - Add response fixtures to `__generated__/responses/api.cloudflare.com/` if needed
 
 ### Step 6 — Update Test Stubs
+
 - Add the new input to `__tests__/helpers/inputs.ts` `stubRequiredInputEnv()` if it's required
 - Add fixtures to `__generated__/responses/` if new API responses are needed
 
 ### Step 7 — Write Tests
+
 - Create or update the relevant `.test.ts` file under `__tests__/` mirroring the `src/` structure
 - Cover happy path, error path, and edge cases
 - Assert no pending interceptors after HTTP calls
 
 ### Step 8 — Validate
+
 Run the full validation suite:
+
 ```bash
 pnpm run all
 ```
+
 This runs: knip → codegen → tsc → format → lint → test → build
 
 Fix any errors before considering the task complete.
@@ -88,6 +103,7 @@ Fix any errors before considering the task complete.
 ## Output
 
 After completing all steps, summarize:
+
 1. Which files were changed and why
 2. Any codegen commands that were run
 3. Test results