From 155a1e64e39605c7dcab78d6a139a89e551d0fe8 Mon Sep 17 00:00:00 2001
From: Primetra <fixes@primetra.ai>
Date: Mon, 19 Oct 2026 07:00:00 +0000
Subject: [PATCH] Primetra fix #1: Add a code example to your idempotency page (instructions)

SAMPLE: this is an illustration from a fictional company. It will not apply to your repository.

Adds PRIMETRA_FIXES.md: the exact text and the steps for a fix that are not a single file change.

  - Fix #1: Add a code example to your idempotency page (re-check on 2026-11-09)
---
 PRIMETRA_FIXES.md |  46 ++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+), 0 deletions(-)

diff --git a/PRIMETRA_FIXES.md b/PRIMETRA_FIXES.md
new file mode 100644
--- /dev/null
+++ b/PRIMETRA_FIXES.md
@@ -0,0 +1,46 @@
+# Primetra fixes to apply by hand
+
+> SAMPLE: this is an illustration from a fictional company. It will not apply to your repository.
+
+Relaykit: 1 fix that are not a single file change. Each has the exact text to use and where it goes.
+
+## Fix 1: Add a code example to your idempotency page
+
+_SAMPLE: this is an illustration from a fictional company. It will not apply to your repository._
+
+ChatGPT read the page but cited a competitor whose page shows the code.
+
+Steps:
+
+1. Open the idempotency page and put the drafted answer block directly under the title.
+2. Keep the curl example runnable; use a real header name and a realistic key.
+3. Add a visible last-updated date.
+4. Re-check in about three weeks; citation changes are slow to show.
+
+Change (`/docs/idempotency`):
+
+````md
+## How do I make email sends idempotent so retries never double-send?
+
+Pass an `Idempotency-Key` header on every `POST /v1/emails` request. Relaykit stores the key for 24 hours and returns the original response for any repeat request with the same key, so a retry never sends a second email.
+
+```bash
+curl https://api.relaykit.example/v1/emails \
+  -H "Authorization: Bearer $RELAYKIT_API_KEY" \
+  -H "Idempotency-Key: order-1042-receipt" \
+  -d '{"to":"ada@example.com","template":"receipt"}'
+```
+
+Use one key per business event (an order id, not a random value per attempt).
+````
+
+Put this directly under the page title, before the longer explanation. Last updated: add a visible date.
+
+_Why this is not a patch file: the page's file in your repository is not known to Primetra yet._
+
+Evidence:
+
+- ChatGPT read your page but cited another source: In answers to: How do I make email sends idempotent so retries never double-send?
+- Cited instead: sendwright.example
+
+Primetra re-checks this on 2026-11-09 (UTC).
-- 
primetra-patch-bundle 1