cloudflare-to-claude-fix 1.0.1

package/README.md

@@ -0,0 +1,153 @@
+<p align="center">
+    <img width="400px" src="https://i.imgur.com/RQP3lma.png" />
+</p>
+
+A Cloudflare Workers **Queue consumer** that fires a **Claude Code routine** whenever a Workers build fails. Required Workers Paid and Claude Pro.
+
+---
+
+## Setup
+
+### 1. Clone / copy this project
+
+```bash
+git clone <your-repo>
+cd cloudflare-to-claude-fix
+npm install
+```
+
+### 2. Create the Cloudflare Queue
+
+```bash
+# Main queue
+wrangler queues create workers-build-events
+
+# Dead-letter queue (catches messages that fail all 3 retries)
+wrangler queues create workers-build-events-dlq
+```
+
+### 3. Enable Event Subscriptions on your target Worker
+
+In the Cloudflare dashboard:
+
+1. Open **Workers & Pages** → select the Worker you want to monitor
+2. Go to **Settings** → **Event Subscriptions**
+3. Set the queue to `workers-build-events`
+4. Enable: **Build started**, **Build succeeded**, **Build failed**, **Build cancelled**
+
+This Worker only acts on `status === "failed"` events; the rest are acknowledged and discarded.
+
+### 4. Create a Claude Code routine
+
+1. Go to [claude.ai/code/routines](https://claude.ai/code/routines)
+2. Click **New routine**
+3. Configure:
+   - **Prompt:** e.g. *"A Cloudflare Workers build has failed. The build ID, branch, commit, author and error log are below. Investigate the error, identify the root cause, and push a fix to the branch. Summarise what you changed."*
+   - **Repository:** the repo that this Worker is deployed from
+4. Under **Select a trigger** → **Add another trigger** → choose **API**
+5. Click **Generate token** — copy the token (shown **once**)
+6. Copy the full fire URL shown in the modal (format: `https://api.anthropic.com/v1/claude_code/routines/trig_<id>/fire`)
+
+### 5. Store secrets in Wrangler
+
+```bash
+# Required
+wrangler secret put ROUTINE_FIRE_URL
+# paste: https://api.anthropic.com/v1/claude_code/routines/trig_<id>/fire
+
+wrangler secret put ROUTINE_FIRE_TOKEN
+# paste: sk-ant-oat01-...
+
+# Optional — post session link to Slack or Discord
+wrangler secret put NOTIFY_WEBHOOK_URL
+# paste: https://hooks.slack.com/services/... (Slack)
+#    or: https://discord.com/api/webhooks/...  (Discord)
+```
+
+> **Never** commit secrets to source control or paste them in plaintext anywhere.
+
+### 6. Deploy
+
+```bash
+wrangler deploy
+```
+
+---
+
+## How it works
+
+1. Cloudflare Builds publishes a `BuildEvent` message to `workers-build-events` when a build status changes.
+2. This consumer Worker receives the batch. Non-failure messages are `ack()`-ed immediately.
+3. For `status === "failed"` messages the Worker:
+   - Formats the `build_id`, `worker_name`, `branch`, `commit_hash`, `author`, `timestamp`, and `error_messages` into a single plaintext block (≤ 65,536 chars).
+   - POSTs that block to the Claude Code routine `/fire` endpoint.
+   - If `NOTIFY_WEBHOOK_URL` is set, posts the resulting `claude_code_session_url` to Slack/Discord so your team can watch the live debugging session.
+4. If the fire request fails, the message is `retry()`-ed up to 3 times (configured in `wrangler.toml`). After 3 failures the message lands in `workers-build-events-dlq`.
+
+---
+
+## Claude Code routine `/fire` API quick-reference
+
+```
+POST https://api.anthropic.com/v1/claude_code/routines/{routine_id}/fire
+Authorization: Bearer sk-ant-oat01-...
+anthropic-version: 2023-06-01
+anthropic-beta: experimental-cc-routine-2026-04-01
+Content-Type: application/json
+
+{ "text": "<up to 65,536 chars of context>" }
+```
+
+**Response:**
+
+```json
+{
+  "type": "routine_fire",
+  "claude_code_session_id": "session_01...",
+  "claude_code_session_url": "https://claude.ai/code/session_01..."
+}
+```
+
+| Status  | Cause                                                          |
+| ------- | -------------------------------------------------------------- |
+| `400` | Missing beta header, text > 65 536 chars, or routine is paused |
+| `401` | Wrong or missing bearer token                                  |
+| `403` | Account doesn't have Claude Code on the web                    |
+| `404` | Routine ID not found                                           |
+| `429` | Daily run allowance exhausted                                  |
+
+---
+
+## Revoking / rotating the routine token
+
+1. Open [claude.ai/code/routines](https://claude.ai/code/routines) → edit the routine
+2. Click the API trigger → **Generate token** (this immediately revokes the old one)
+3. Update the secret: `wrangler secret put ROUTINE_FIRE_TOKEN`
+
+---
+
+## Local testing
+
+Send a synthetic failed-build message to the queue:
+
+```bash
+wrangler queues publish workers-build-events \
+  --message '{
+    "build_id": "build_test001",
+    "status": "failed",
+    "worker_name": "my-api",
+    "branch": "feat/new-endpoint",
+    "commit_hash": "abc1234",
+    "author": "alex@example.com",
+    "error_messages": ["Error: Cannot find module '\''./utils'\''", "    at Object.<anonymous> (src/index.ts:3:1)"],
+    "timestamp": "2026-05-01T19:00:00Z"
+  }'
+```
+
+Then tail logs to verify:
+
+```bash
+wrangler tail cloudflare-to-claude-fix
+```
+
+---

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "cloudflare-to-claude-fix",
+  "version": "1.0.1",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/OpenSourceAGI/appdemo-dev-tools/tree/master/packages/cloudflare-to-claude-fix"
+  },
+  "homepage": "https://github.com/OpenSourceAGI/appdemo-dev-tools/tree/master/packages/cloudflare-to-claude-fix",
+  "scripts": {
+    "deploy": "wrangler deploy",
+    "dev": "wrangler dev",
+    "tail": "wrangler tail"
+  },
+  "devDependencies": {
+    "wrangler": "^3.x"
+  }
+}

package/src/index.js

@@ -0,0 +1,116 @@
+/**
+ * Cloudflare Workers Queue Consumer
+ * Fires a Claude Code routine when a Workers build fails.
+ *
+ * Event flow:
+ *   CF Workers Builds → Queue → this Worker → Claude Code /fire endpoint
+ */
+
+const MAX_TEXT_BYTES = 65_536;
+
+function truncate(s) {
+  if (s.length <= MAX_TEXT_BYTES) return s;
+  return (
+    s.slice(0, MAX_TEXT_BYTES - 200) +
+    "\n\n[... log truncated to fit 65,536-char limit ...]"
+  );
+}
+
+function buildPayloadText(evt) {
+  const lines = [
+    `⚠️ Cloudflare Workers build FAILED`,
+    `Worker : ${evt.worker_name}`,
+    `Build  : ${evt.build_id}`,
+    `Branch : ${evt.branch ?? "(unknown)"}`,
+    `Commit : ${evt.commit_hash ?? "(unknown)"}`,
+    `Author : ${evt.author ?? "(unknown)"}`,
+    `Time   : ${evt.timestamp}`,
+    ``,
+    `=== Error log ===`,
+  ];
+
+  if (evt.error_messages && evt.error_messages.length > 0) {
+    lines.push(...evt.error_messages);
+  } else {
+    lines.push(
+      "(no structured error messages in event; check Logpush for full output)",
+    );
+  }
+
+  return truncate(lines.join("\n"));
+}
+
+async function fireRoutine(text, env) {
+  const res = await fetch(env.ROUTINE_FIRE_URL, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${env.ROUTINE_FIRE_TOKEN}`,
+      "anthropic-version": "2023-06-01",
+      "anthropic-beta": "experimental-cc-routine-2026-04-01",
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({ text }),
+  });
+
+  if (!res.ok) {
+    const body = await res.text();
+    throw new Error(`Routine fire failed (${res.status}): ${body}`);
+  }
+
+  return res.json();
+}
+
+async function notifyWebhook(evt, sessionUrl, webhookUrl) {
+  const text =
+    `🤖 Claude Code is investigating the failed \`${evt.worker_name}\` build ` +
+    `(branch: \`${evt.branch ?? "?"}\`, commit: \`${evt.commit_hash?.slice(0, 7) ?? "?"}\`).\n` +
+    `👉 Live session: ${sessionUrl}`;
+
+  await fetch(webhookUrl, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ text, content: text }), // works for both Slack and Discord
+  });
+}
+
+export default {
+  async queue(batch, env) {
+    for (const message of batch.messages) {
+      const evt = message.body;
+
+      if (evt.status !== "failed") {
+        message.ack();
+        continue;
+      }
+
+      try {
+        console.log(
+          `[cloudflare-to-claude-fix] Build ${evt.build_id} for worker "${evt.worker_name}" failed — firing routine.`,
+        );
+
+        const text = buildPayloadText(evt);
+        const { claude_code_session_url } = await fireRoutine(text, env);
+
+        console.log(
+          `[cloudflare-to-claude-fix] Routine fired. Session: ${claude_code_session_url}`,
+        );
+
+        if (env.NOTIFY_WEBHOOK_URL) {
+          await notifyWebhook(
+            evt,
+            claude_code_session_url,
+            env.NOTIFY_WEBHOOK_URL,
+          );
+        }
+
+        message.ack();
+      } catch (err) {
+        console.error(
+          `[cloudflare-to-claude-fix] Error processing build ${evt.build_id}:`,
+          err,
+        );
+        message.retry();
+      }
+    }
+  },
+};

package/wrangler.jsonc

@@ -0,0 +1,34 @@
+{
+  // ── Core ────────────────────────────────────────────────────────────────────
+  "name": "cloudflare-to-claude-fix",
+  "main": "src/index.js",
+  "compatibility_date": "2025-11-01",
+
+  // ── Queue consumer ──────────────────────────────────────────────────────────
+  // Create the queues first:
+  //   wrangler queues create workers-build-events
+  //   wrangler queues create workers-build-events-dlq
+  "queues": {
+    "consumers": [
+      {
+        "queue": "workers-build-events",
+        // Max messages pulled per invocation
+        "max_batch_size": 10,
+        // Seconds to wait to fill a batch before invoking early
+        "max_batch_timeout": 30,
+        // Per-message retry attempts before routing to DLQ
+        "max_retries": 3,
+        // Catches messages that exhaust all retries
+        "dead_letter_queue": "workers-build-events-dlq",
+      },
+    ],
+  },
+
+  // ── Secrets ─────────────────────────────────────────────────────────────────
+  // Set these with `wrangler secret put <NAME>` — never hardcode values here.
+  //
+  // ROUTINE_FIRE_URL   — https://api.anthropic.com/v1/claude_code/routines/trig_<id>/fire
+  // ROUTINE_FIRE_TOKEN — sk-ant-oat01-... (from Claude Code routine API trigger)
+  // NOTIFY_WEBHOOK_URL — (optional) Slack or Discord incoming webhook URL
+  "vars": {},
+}