Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
769 commits
Select commit Hold shift + click to select a range
a8d0023
Merge #472 at 6924d48 (proxy test also checks the app client keeps no…
Silthus Nov 5, 2026
fdb4671
Merge #472 at 6924d48 into feat/migrate-email-postmark
Silthus Nov 5, 2026
9f1773e
Merge #472 at 6924d48 into feat/migrate-email-mailgun
Silthus Nov 5, 2026
f26a129
Merge #472 at 6924d48 into feat/migrate-email-amazon-ses
Silthus Nov 5, 2026
b02e1b0
Merge #472 at 6924d48 into feat/migrate-email-loops
Silthus Nov 5, 2026
3e93eac
Merge #472 at 6924d48 into feat/migrate-email-smtp
Silthus Nov 5, 2026
1c1d3a9
Merge #472 at 6924d48 into feat/migrate-email-brevo
Silthus Nov 5, 2026
ee9e706
Merge #472 at 6924d48 into feat/migrate-email-sparkpost
Silthus Nov 5, 2026
e1a4d44
Merge #472 at 6924d48 into feat/migrate-email-mandrill
Silthus Nov 5, 2026
bba2c48
Merge #472 at 6924d48 into feat/migrate-email-mailjet
Silthus Nov 5, 2026
4b15d2e
feat(migrate-email): bring stored templates into the code
Silthus Nov 5, 2026
7a4c994
Merge #459 at 4b15d2e (stored templates move into the code) into feat…
Silthus Nov 5, 2026
f5c5217
Merge #459 at 7a4c994 (stored templates move into the code) into feat…
Silthus Nov 5, 2026
0a27965
Merge #459 at dae9b70 (stored templates move into the code) into feat…
Silthus Nov 5, 2026
c24df79
Merge #459 at f5c5217 (stored templates move into the code) into feat…
Silthus Nov 5, 2026
dae9b70
Merge #459 at c24df79 (stored templates move into the code) into feat…
Silthus Nov 5, 2026
2698b4e
Merge #459 at 0a27965 (stored templates move into the code) into feat…
Silthus Nov 5, 2026
85ec11b
Merge #459 at 1fd77cd (stored templates move into the code) into feat…
Silthus Nov 5, 2026
1fd77cd
Merge #459 at 13daad9 (stored templates move into the code) into feat…
Silthus Nov 5, 2026
13daad9
Merge #459 at 2698b4e (stored templates move into the code) into feat…
Silthus Nov 5, 2026
735bd63
feat(migrate-email): fill SendGrid substitutions in the code
Silthus Nov 5, 2026
7989fd7
Merge sendgrid at 735bd63a (SendGrid substitutions in the code) into …
Silthus Nov 5, 2026
c4fe6dc
Merge postmark at 7989fd7a (SendGrid substitutions in the code) into …
Silthus Nov 5, 2026
807bea0
Merge smtp at a421e606 (SendGrid substitutions in the code) into feat…
Silthus Nov 5, 2026
10917bf
Merge mailgun at c4fe6dca (SendGrid substitutions in the code) into f…
Silthus Nov 5, 2026
47ec5d0
Merge amazon-ses at 807bea0f (SendGrid substitutions in the code) int…
Silthus Nov 5, 2026
a421e60
Merge loops at 10917bf2 (SendGrid substitutions in the code) into fea…
Silthus Nov 5, 2026
5ee7e3b
Merge mandrill at a9e76839 (SendGrid substitutions in the code) into …
Silthus Nov 5, 2026
a9e7683
Merge mailjet at dd9e64c8 (SendGrid substitutions in the code) into f…
Silthus Nov 5, 2026
dd9e64c
Merge brevo at 47ec5d0c (SendGrid substitutions in the code) into fea…
Silthus Nov 5, 2026
54a6b78
feat(migrate-email): bring Postmark templates into the code
Silthus Nov 5, 2026
caab467
feat(migrate-email): bring Mailgun templates into the code
Silthus Nov 5, 2026
885c554
feat(migrate-email): bring Amazon SES templates into the code
Silthus Nov 5, 2026
06f7a81
feat(migrate-email): bring Loops emails into the code
Silthus Nov 5, 2026
a2c134e
feat(migrate-email): bring SparkPost templates into the code
Silthus Nov 5, 2026
79c76e2
feat(migrate-email): bring Brevo templates into the code
Silthus Nov 5, 2026
32f01fc
feat(migrate-email): bring Mailchimp Transactional templates into the…
Silthus Nov 5, 2026
418d293
feat(migrate-email): bring Mailjet templates into the code
Silthus Nov 5, 2026
275cd58
Merge postmark at 54a6b784 (templates into the code) into feat/migrat…
Silthus Nov 5, 2026
a07c14a
Merge mailgun at 275cd581 (templates into the code) into feat/migrate…
Silthus Nov 5, 2026
4dd168e
Merge loops at a07c14a6 (templates into the code) into feat/migrate-e…
Silthus Nov 5, 2026
2b7e6f6
Merge smtp at 4dd168ed (templates into the code) into feat/migrate-em…
Silthus Nov 5, 2026
60dae38
Merge amazon-ses at 2b7e6f64 (templates into the code) into feat/migr…
Silthus Nov 5, 2026
702d68c
Merge brevo at 60dae385 (templates into the code) into feat/migrate-e…
Silthus Nov 5, 2026
67588ec
Merge mailjet at 702d68c2 (templates into the code) into feat/migrate…
Silthus Nov 5, 2026
b1f0935
Merge mandrill at 67588ec4 (templates into the code) into feat/migrat…
Silthus Nov 5, 2026
2ebcce0
feat(migrate-email): bring Resend templates into the code
Silthus Nov 5, 2026
4ce6c2d
docs(migrate-email): record engagement events only when engagement ca…
Silthus Nov 9, 2026
62d1116
fix(migrate-email): keep SendGrid sites with opens untracked instead …
Silthus Nov 9, 2026
2ad4e9c
fix(migrate-email): keep Postmark sites with opens untracked instead …
Silthus Nov 9, 2026
2e786d2
Merge branch 'feat/migrate-email-sendgrid' into feat/migrate-email-po…
Silthus Nov 9, 2026
62d96d1
fix(migrate-email): keep Mailgun sites with opens untracked instead o…
Silthus Nov 9, 2026
ad32d65
Merge branch 'feat/migrate-email-postmark' into feat/migrate-email-ma…
Silthus Nov 9, 2026
49cf3a6
docs(migrate-email): record Loops events only when engagement capture…
Silthus Nov 9, 2026
7c84b75
Merge branch 'feat/migrate-email-mailgun' into feat/migrate-email-loops
Silthus Nov 9, 2026
cf8f7b9
fix(migrate-email): keep SMTP sites with opens untracked instead of t…
Silthus Nov 9, 2026
7f1af3f
Merge branch 'feat/migrate-email-loops' into feat/migrate-email-smtp
Silthus Nov 9, 2026
c025198
fix(migrate-email): keep Amazon SES sites with opens untracked instea…
Silthus Nov 9, 2026
c87266a
Merge branch 'feat/migrate-email-smtp' into feat/migrate-email-amazon…
Silthus Nov 9, 2026
d94d728
fix(migrate-email): keep Brevo sites with opens untracked instead of …
Silthus Nov 9, 2026
042b064
Merge branch 'feat/migrate-email-amazon-ses' into feat/migrate-email-…
Silthus Nov 9, 2026
f9fde3b
fix(migrate-email): keep Mailjet sites with opens untracked instead o…
Silthus Nov 9, 2026
70dab1d
Merge branch 'feat/migrate-email-brevo' into feat/migrate-email-mailjet
Silthus Nov 9, 2026
0709579
fix(migrate-email): keep Mailchimp Transactional sites with opens unt…
Silthus Nov 9, 2026
5fb36f2
Merge branch 'feat/migrate-email-mailjet' into feat/migrate-email-man…
Silthus Nov 9, 2026
6df0912
fix(migrate-email): keep SparkPost sites with opens untracked instead…
Silthus Nov 9, 2026
95691b1
Merge branch 'feat/migrate-email-mandrill' into feat/migrate-email-sp…
Silthus Nov 9, 2026
7761f99
fix(migrate-email): list no PostHog click event for SendGrid clicks, …
Silthus Nov 9, 2026
43ae9bd
fix(migrate-email): list no PostHog click event for Postmark clicks
Silthus Nov 9, 2026
54a1c10
Merge branch 'feat/migrate-email-sendgrid' into feat/migrate-email-po…
Silthus Nov 9, 2026
0d64b18
fix(migrate-email): name the conflicting Mailgun open tracking reason…
Silthus Nov 9, 2026
280cd8d
Merge branch 'feat/migrate-email-postmark' into feat/migrate-email-ma…
Silthus Nov 9, 2026
1886e47
fix(migrate-email): ask once before Loops sends move with PostHog's o…
Silthus Nov 9, 2026
dd7cd0b
Merge branch 'feat/migrate-email-mailgun' into feat/migrate-email-loops
Silthus Nov 9, 2026
15972d0
fix(migrate-email): ask once before sends through a host that can't t…
Silthus Nov 9, 2026
ee5ffdb
Merge branch 'feat/migrate-email-loops' into feat/migrate-email-smtp
Silthus Nov 9, 2026
9e05f9f
fix(migrate-email): list no PostHog click event for Amazon SES clicks
Silthus Nov 9, 2026
ee1611b
Merge branch 'feat/migrate-email-smtp' into feat/migrate-email-amazon…
Silthus Nov 9, 2026
c6ccf67
fix(migrate-email): list no PostHog click event for Brevo clicks
Silthus Nov 9, 2026
9a836df
Merge branch 'feat/migrate-email-amazon-ses' into feat/migrate-email-…
Silthus Nov 9, 2026
6094f72
fix(migrate-email): list no PostHog click event for Mailjet clicks
Silthus Nov 9, 2026
db6ec64
Merge branch 'feat/migrate-email-brevo' into feat/migrate-email-mailjet
Silthus Nov 9, 2026
ac1ef09
fix(migrate-email): drop Mailchimp Transactional's tracking domain, a…
Silthus Nov 9, 2026
f8275b9
Merge branch 'feat/migrate-email-mailjet' into feat/migrate-email-man…
Silthus Nov 9, 2026
c2ff929
fix(migrate-email): apply SparkPost's tracking order, keep revoked co…
Silthus Nov 9, 2026
414ae71
Merge branch 'feat/migrate-email-mandrill' into feat/migrate-email-sp…
Silthus Nov 9, 2026
0192a3d
fix(migrate-email): keep an app's PostHog key, and a Resend HTTP call…
Silthus Nov 12, 2026
d2e2848
Merge #451 at 0192a3d (keep an app's PostHog key, and an HTTP call's …
Silthus Nov 12, 2026
5c996de
fix(migrate-email): keep email off a disabled client, and pass numeri…
Silthus Nov 12, 2026
20036d6
Merge #451 at 5c996de (no email on a disabled client, numeric IDs as …
Silthus Nov 12, 2026
dddd616
fix(migrate-email): keep undeadlined HTTP sites on Resend and keep im…
Silthus Nov 12, 2026
8234d71
fix(migrate-email): record the send's own sender, replace markers in …
Silthus Nov 12, 2026
e9953c0
fix(migrate-email): map Go's other Resend error checks and keep Outlo…
Silthus Nov 12, 2026
ecd0366
fix(migrate-email): render variables in Go's Outlook blocks and scope…
Silthus Nov 12, 2026
7e5a468
fix(migrate-email): keep encoded URL values as they are in Go templates
Silthus Nov 12, 2026
e22fa6c
Merge branch 'main' into feat/migrate-email-resend
Silthus Nov 12, 2026
7afab6e
Merge branch 'feat/migrate-email-resend-cutover' into feat/migrate-em…
Silthus Nov 12, 2026
ae88e6e
Merge branch 'feat/migrate-email-resend' into feat/migrate-email-rese…
Silthus Nov 12, 2026
6b41f33
feat(migrate-email): move the shared step changes from the SendGrid l…
Silthus Nov 12, 2026
74b03bc
Merge the core skill into feat/migrate-email-sparkpost, keeping only …
Silthus Nov 12, 2026
a366b71
fix(migrate-email): list Resend webhook handlers, keep ignored argume…
Silthus Nov 12, 2026
f279e43
fix(migrate-email): keep provider content inert in code literals, and…
Silthus Nov 12, 2026
57d3f73
Merge remote-tracking branch 'origin/feat/migrate-email-all-sdks' int…
Silthus Nov 12, 2026
6d13262
fix(migrate-email): keep SparkPost sends that would change idempotenc…
Silthus Nov 12, 2026
487262b
fix(skills): close the migrate-email preparation gaps the QA swarm found
Silthus Nov 12, 2026
93130dd
fix(migrate-email): ask before a non-transactional SparkPost send mov…
Silthus Nov 12, 2026
832fbe3
fix(migrate-email): apply SparkPost overrides to inline sends, keep r…
Silthus Nov 12, 2026
9f97de8
fix(migrate-email): give each SparkPost HTTP deadline its own email c…
Silthus Nov 12, 2026
4429efc
fix(migrate-email): keep SparkPost's unsubscribe header, read subacco…
Silthus Nov 12, 2026
00b9aa3
fix(skills): tighten the migrate-email key check and template rules
Silthus Nov 12, 2026
bde5bb6
Merge branch 'feat/migrate-email-resend' into feat/migrate-email-rese…
Silthus Nov 12, 2026
708f7f1
fix(migrate-email): keep each site's own HTTP deadline
Silthus Nov 12, 2026
56158d1
fix(migrate-email): keep marketing sends on the provider
Silthus Nov 12, 2026
04e7c84
fix(migrate-email): read the provider's report notes without the impo…
Silthus Nov 12, 2026
7c388d1
Merge branch 'feat/migrate-email-resend' into feat/migrate-email-rese…
Silthus Nov 12, 2026
0186ee2
fix(migrate-email): answer the round 1 review of the rewrite and veri…
Silthus Nov 12, 2026
30f3873
fix(migrate-email): match baseline typecheck errors without their line
Silthus Nov 12, 2026
dc18f5d
fix(migrate-email): count each baseline typecheck error
Silthus Nov 12, 2026
c33bf45
Merge branch 'feat/migrate-email-resend-cutover' into feat/migrate-em…
Silthus Nov 12, 2026
a2994e9
fix(migrate-email): keep a named recipient on Resend
Silthus Nov 12, 2026
bde40bc
Merge remote-tracking branch 'origin/feat/migrate-email-resend' into …
Silthus Nov 12, 2026
e4221d8
Merge remote-tracking branch 'origin/feat/migrate-email-resend-cutove…
Silthus Nov 12, 2026
82d6ebf
fix(migrate-email): settle deadlines, attribute quoting, and suppress…
Silthus Nov 12, 2026
497d017
fix(migrate-email): keep a site on Resend when it needs a suppressed …
Silthus Nov 12, 2026
69edcdd
fix(migrate-email): keep a Resend SDK send with an abortable signal o…
Silthus Nov 12, 2026
22df812
Merge remote-tracking branch 'origin/feat/migrate-email-resend-cutove…
Silthus Nov 12, 2026
e36fd64
fix(migrate-email): own email clients, long deadlines, clicks and tem…
Silthus Nov 12, 2026
08c9d15
test(migrate-email): drop the tests that match the skill's own wording
Silthus Nov 12, 2026
bb14da9
fix(migrate-email): blank .NET host, long .NET deadlines, shared temp…
Silthus Nov 12, 2026
eeeb620
fix(migrate-email): keep a Go site whose template fills CSS from a value
Silthus Nov 12, 2026
64bb2a2
fix(migrate-email): count brought-in templates as code content, stop …
Silthus Nov 12, 2026
8ead8e1
fix(migrate-email): keep enable_local_evaluation off the Python async…
Silthus Nov 12, 2026
cc02b7e
Merge feat/migrate-email-all-sdks into feat/migrate-email-sparkpost
Silthus Nov 12, 2026
ffa6bd1
fix(migrate-email): converge the SparkPost folder with the finished core
Silthus Nov 12, 2026
b5bcb55
fix(migrate-email): keep only whole-request deadlines, and limit no-c…
Silthus Nov 12, 2026
0158aef
fix(migrate-email): keep sites that branch on one kind of network fai…
Silthus Nov 12, 2026
4ea4d6e
fix(migrate-email): keep any SparkPost site with a per-stage HTTP lim…
Silthus Nov 12, 2026
f6978e7
fix(migrate-email): keep separate connect limits, require ext-curl fo…
Silthus Nov 12, 2026
ad23a92
fix(migrate-email): keep a Go request's transport limits
Silthus Nov 12, 2026
115ec8c
fix(migrate-email): treat ky's timeout as a header-stage limit, and c…
Silthus Nov 12, 2026
7ccc0ee
fix(migrate-email): keep a Python whole-request limit on the provider
Silthus Nov 12, 2026
a8d2b65
fix(migrate-email): keep SparkPost sites that send PHP promises concu…
Silthus Nov 12, 2026
f8ec4b5
Merge feat/migrate-email-all-sdks into feat/migrate-email-sparkpost
Silthus Nov 12, 2026
f4b4060
fix(migrate-email): follow the core's deadline rule for SparkPost HTT…
Silthus Nov 12, 2026
dd60f9f
fix(migrate-email): name SparkPost-era limits under the core's deadli…
Silthus Nov 12, 2026
aaa2cee
fix(migrate-email): treat equal Net::HTTP limits as a deadline, keep …
Silthus Nov 12, 2026
9c1f9e5
fix(migrate-email): ask the person whether PostHog's id fits a limite…
Silthus Nov 12, 2026
efe881b
fix(migrate-email): ask about a service that expects SparkPost's id too
Silthus Nov 12, 2026
eef1481
fix(migrate-email): settle untracked clicks, timeout kinds, and the m…
Silthus Nov 12, 2026
efb8451
fix(migrate-email): read Faraday's timeout by its adapter
Silthus Nov 12, 2026
f658354
fix(migrate-email): keep a site whose handler needs an event PostHog …
Silthus Nov 12, 2026
1078496
Merge feat/migrate-email-all-sdks into feat/migrate-email-sparkpost
Silthus Nov 12, 2026
8e6f94f
Reconcile SparkPost with the core's deadline, id and click rules
Silthus Nov 12, 2026
a66e15b
fix(migrate-email): upgrade mocked send tests to the HTTP boundary
Silthus Nov 12, 2026
2e3f38a
Fix final read 13: template click order, Ruby per-stage timeouts
Silthus Nov 12, 2026
18ab351
fix(migrate-email): fake fetch instead of keeping a send mock
Silthus Nov 12, 2026
ced460c
Merge commit '18ab3510a0b5cb457fab6a6b3d6079d8078bbc2d' into HEAD
Silthus Nov 12, 2026
e14c1fc
fix(migrate-email): keep a Ruby site with a partial Net::HTTP timeout
Silthus Nov 12, 2026
a943460
fix(migrate-email): note a must-be-sensitive template in its plan row
Silthus Nov 12, 2026
c7f3aea
Fix final read 14: Faraday timeouts on other adapters keep the site
Silthus Nov 12, 2026
45c5716
fix(migrate-email): keep network failures off Resend's 503 branch
Silthus Nov 12, 2026
d51979c
fix(migrate-email): allow a loopback app host in Go and .NET tests
Silthus Nov 12, 2026
17c6ca1
feat(migrate-email): ask before adding an open pixel to untracked email
Silthus Nov 12, 2026
3e17847
Merge feat/migrate-email-all-sdks into feat/migrate-email-sparkpost
Silthus Nov 12, 2026
5be2192
Reconcile SparkPost with the core's opens, webhook and Ruby rules
Silthus Nov 12, 2026
a27cfdc
Fix final read 16: note lost clicks for every moved site
Silthus Nov 12, 2026
cff58f5
fix(migrate-email): route a network failure the way Resend's code did
Silthus Nov 12, 2026
a19e6a3
Fix final read 17: note clicks nobody can check on moved sites
Silthus Nov 12, 2026
96e10a2
Merge commit 'cff58f516b33b2fe5eb3c0a5d2704f874f7c3d85' into HEAD
Silthus Nov 12, 2026
6f7abcb
fix(migrate-email): test with a standard-library server, never a mock…
Silthus Nov 12, 2026
8776c81
fix(migrate-email): ask about a test dependency only where one is needed
Silthus Nov 12, 2026
63c3dfe
fix(migrate-email): ask before adding any test tool, in every language
Silthus Nov 12, 2026
21e1d27
feat(migrate-email): re-import the suppression list weekly while site…
Silthus Nov 12, 2026
a65bb90
fix(migrate-email): check the project before a suppression re-import
Silthus Nov 12, 2026
b28e13b
fix(migrate-email): write the re-import's project check out in Step 5
Silthus Nov 12, 2026
b2dfe53
fix(migrate-email): confirm the production project before a re-import
Silthus Nov 12, 2026
731b092
fix(migrate-email): read the project token with project-get
Silthus Nov 12, 2026
8929f93
fix(migrate-email): switch the MCP back after a re-import
Silthus Nov 12, 2026
e5735c8
fix(migrate-email): name the production project in a by-hand re-import
Silthus Nov 12, 2026
8b9757e
fix(migrate-email): let a re-import without the tool say so
Silthus Nov 12, 2026
349a407
fix(migrate-email): let a re-import say why it got no list
Silthus Nov 12, 2026
2df1f26
fix(migrate-email): read the project token with project-get
Silthus Nov 12, 2026
090ac92
Merge #451 (feat/migrate-email-resend-cutover) into feat/migrate-emai…
Silthus Nov 12, 2026
b87374f
Merge feat/migrate-email-all-sdks into feat/migrate-email-sparkpost
Silthus Nov 12, 2026
d8dd2d4
fix(migrate-email): ask for re-imports only when the provider keeps a…
Silthus Nov 12, 2026
94d44d3
fix(migrate-email): record a provider with no list before the tool check
Silthus Nov 13, 2026
2b8d0d6
fix(migrate-email): end a re-import early when the provider keeps no …
Silthus Nov 13, 2026
5e0607f
fix(migrate-email): keep sites a Resend webhook handler acts on, and …
Silthus Nov 13, 2026
cdd83b0
Fix ReviewHog round 5: consent checks and PHP success callbacks
Silthus Nov 13, 2026
eeed7cb
fix(migrate-email): check every error in a rewritten line against its…
Silthus Nov 13, 2026
5f5debd
fix(migrate-email): check for a provider without a suppression list b…
Silthus Nov 13, 2026
cb26a5f
Merge #451 (feat/migrate-email-resend-cutover) into feat/migrate-emai…
Silthus Nov 13, 2026
77b680b
fix(migrate-email): give Step 8 one rule for which typecheck errors a…
Silthus Nov 13, 2026
e7a7f3f
Merge #451 (feat/migrate-email-resend-cutover) into feat/migrate-emai…
Silthus Nov 13, 2026
d7f308f
Fix final read 20: revoke links in mail already delivered
Silthus Nov 13, 2026
967cc94
Fix final read 21: give old revoke links a way to move
Silthus Nov 13, 2026
1d85155
fix(migrate-email): tie the kept Resend error names to posthog-node, …
Silthus Nov 13, 2026
013a98e
Merge #450 (feat/migrate-email-resend) into feat/migrate-email-resend…
Silthus Nov 13, 2026
19b1b90
fix(migrate-email): mark secret emails sensitive, check template keys…
Silthus Nov 13, 2026
fdea2d3
fix(migrate-email): send sensitive only with rendered content, and on…
Silthus Nov 13, 2026
2184cff
Fix final read 22: old revoke links keep the site, as the consent rul…
Silthus Nov 13, 2026
2fe8430
fix(migrate-email): check the app's Node version and count removed er…
Silthus Nov 13, 2026
6c45e23
Merge remote-tracking branch 'origin/feat/migrate-email-resend-cutove…
Silthus Nov 13, 2026
4087e6c
fix(migrate-email): carry the key, sensitive and Node checks; count r…
Silthus Nov 13, 2026
51148ce
Fix PostHog Review round 6: keep templates whose snippet the app changes
Silthus Nov 13, 2026
808f61d
fix(migrate-email): name each SDK's sensitive flag; list the moved keys
Silthus Nov 13, 2026
5ef962b
Fix PostHog Review round 7: from names, 409 conflicts, untyped deletes
Silthus Nov 13, 2026
fd58f93
fix(migrate-email): move the template keys to after cutover; edge reason
Silthus Nov 13, 2026
f1ba031
fix(migrate-email): scope the runtime check to where each site runs
Silthus Nov 13, 2026
a0b01bc
fix(migrate-email): check every server that shares the SDK's manifest
Silthus Nov 13, 2026
8f51a57
fix(migrate-email): keep every site on a manifest an unsupported serv…
Silthus Nov 13, 2026
6b0083e
fix(migrate-email): count workspace and root lockfile installs in the…
Silthus Nov 13, 2026
ef71e1f
fix(migrate-email): keep a site whose HTTP client retries a request w…
Silthus Nov 13, 2026
6fdfdf7
fix(migrate-email): count only a retry setup that covers the POST
Silthus Nov 13, 2026
6d4801f
fix(migrate-email): name the retry setups as examples, not a full list
Silthus Nov 13, 2026
caff403
fix(migrate-email): read the retry setup's options before counting it
Silthus Nov 13, 2026
7aad014
fix(migrate-email): count a requests adapter whose max_retries is a n…
Silthus Nov 13, 2026
a090b5b
chore: merge main after #450 landed
Silthus Nov 13, 2026
66dc2b2
Merge branch 'feat/migrate-email-resend-cutover' into feat/migrate-em…
Silthus Nov 13, 2026
6d3d8b0
fix(migrate-email): keep a site that reads Resend's response headers
Silthus Nov 13, 2026
610e703
fix(migrate-email): name each SDK's retry delay in its rewrite file
Silthus Nov 13, 2026
d186900
fix(migrate-email): keep a send that turns Resend's plain-text part off
Silthus Nov 13, 2026
088f35b
fix(migrate-email): cover react and run-time empty text, word the tem…
Silthus Nov 13, 2026
3b204b7
fix(migrate-email): check the text-part rule in Step 3, count Go's em…
Silthus Nov 13, 2026
f3bb668
fix(migrate-email): ask whether a copied Resend template turns its pl…
Silthus Nov 13, 2026
355df95
fix(migrate-email): offer the full-access key for the plain-text ques…
Silthus Nov 13, 2026
74040e5
fix(migrate-email): note every template's plain text, offer the key o…
Silthus Nov 13, 2026
b99cea5
fix(migrate-email): sync suppression calls on the reasons PostHog stores
Silthus Nov 13, 2026
9eb4180
fix(migrate-email): report suppression-list calls instead of syncing …
Silthus Nov 13, 2026
1bcc53c
fix(migrate-email): say only hard bounces block a moved send
Silthus Nov 13, 2026
daf563e
fix(migrate-email): give the add item a check the app can make
Silthus Nov 13, 2026
d00e808
fix(migrate-email): ask in Step 3 which sites rely on a suppression add
Silthus Nov 13, 2026
2fe5090
fix(migrate-email): ask about hand-added suppressions too
Silthus Nov 13, 2026
b006c9b
fix(migrate-email): keep the sites when nobody can say who relies on …
Silthus Nov 13, 2026
cd9e38a
fix(migrate-email): ask about the suppression list before the templat…
Silthus Nov 13, 2026
4db6763
fix(migrate-email): list the suppression note in the plan file rules
Silthus Nov 13, 2026
0a6ae00
fix(migrate-email): keep Rust sites on runtimes other than Tokio
Silthus Nov 13, 2026
f98eb3b
fix(migrate-email): require Tokio's timers for the Rust async client
Silthus Nov 13, 2026
418cc5a
chore: merge main after #451 landed
Silthus Nov 13, 2026
423a7fa
Merge remote-tracking branch 'origin/feat/migrate-email-all-sdks' int…
Silthus Nov 13, 2026
da49317
chore: merge main after #472 landed
Silthus Nov 13, 2026
d6f261c
fix(migrate-email): adapt SparkPost suppressions to #472's shared steps
Silthus Nov 13, 2026
9459b57
fix(migrate-email): keep SparkPost response-header reads and read Rub…
Silthus Nov 13, 2026
7df2c7d
fix(migrate-email): carry PostHog's retry delay on the error Node.js …
Silthus Nov 13, 2026
eebfe4e
fix(migrate-email): read SparkPost PHP error answers from the install…
Silthus Nov 13, 2026
40c9742
fix(migrate-email): check SparkPost's plain-text part before an html-…
Silthus Nov 13, 2026
c77373c
fix(migrate-email): keep a SparkPost site's own text and check an ema…
Silthus Nov 13, 2026
90bd64a
fix(migrate-email): keep SparkPost sites whose account settings the a…
Silthus Nov 13, 2026
5852c15
fix(migrate-email): keep the list shape of SparkPost's errors when a …
Silthus Nov 13, 2026
f8204a9
fix(migrate-email): keep SparkPost sites that hand error entries past…
Silthus Nov 13, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -95,6 +95,7 @@ longer exist — only some keep an alias.
|---|---|
| `wizard migrate statsig` | `migrate-statsig` |
| `wizard migrate resend` | `migrate-email-resend` |
| `wizard migrate sparkpost` | `migrate-email-sparkpost` |

**Commands vs. skills:** those audit subcommands **are** skills, promoted to
commands via `cli: role: command`. A `role: skill` skill is reachable only via
Expand Down
3 changes: 3 additions & 0 deletions context/skills/migrate-email/config.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -16,3 +16,6 @@ variants:
- id: resend
display_name: Resend
tags: [resend]
- id: sparkpost
display_name: SparkPost
tags: [sparkpost]
94 changes: 94 additions & 0 deletions context/skills/migrate-email/references/sparkpost/account.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,94 @@
# SparkPost account

What the migration needs from the person's SparkPost account. The agent never changes the account: it reads what the person exports or allows.

An account lives in one region: `app.sparkpost.com` with `api.sparkpost.com`, or `app.eu.sparkpost.com` with `api.eu.sparkpost.com`.

**EU accounts.** An app on an EU account names `api.eu.sparkpost.com`, or sets the client's host to it by a setting, as `sdk-reference.md` says under "EU accounts". For such an app, use `api.eu.sparkpost.com` in every request of this file instead of `api.sparkpost.com`.

## DNS records

A domain set up at SparkPost carries these records. Keep all of them until the cutover is done. The SparkPost app shows the exact names and values under Domains, then the domain.

| Record | Name | What it does |
|---|---|---|
| `TXT` (DKIM) | `<selector>._domainkey`, with a selector SparkPost makes, such as `scph0820` | Signs SparkPost's mail |
| `CNAME` | The bounce domain: a subdomain such as `bounce`, or the sending domain itself, pointing to `sparkpostmail.com` (`eu.sparkpostmail.com` in the EU) | Return path for SparkPost's bounces, and its SPF alignment |
| `CNAME` | A subdomain pointing to `spgo.io`, `v2.spgo.io`, `eu.spgo.io`, or `eu.v2.spgo.io` | A custom tracking domain, only when it is set up |
| `TXT` (DMARC) | `_dmarc` | Optional, shared by every provider on the domain |

- An Enterprise account points its bounce CNAME at `<tenant>.mail.e.sparkpost.com` and its tracking CNAME at `<tenant>.et.e.sparkpost.com`, and can verify a domain with `MX` records.
- PostHog's sender uses its own label for its MAIL FROM, `feedback` by default. Never give PostHog a label SparkPost uses for its bounce or tracking domain.
- PostHog's DKIM records have their own names, so they sit next to SparkPost's `_domainkey` record.
- When the sending domain itself is SparkPost's bounce domain, it holds a `CNAME`, and DNS allows no other record on that name. A PostHog record for that exact name, such as an SPF `TXT` record, cannot be added. Tell the person: they can move SparkPost's bounce domain to a subdomain such as `bounce` first, in SparkPost and in DNS, or send from PostHog on another domain. Record the domain as not verified until then.
- Keep the one `_dmarc` record. Never add a second one.
- A domain whose `v=spf1` record names SparkPost keeps it. Merge PostHog's include into that record.

## Read-only key

The app's own SparkPost key usually has only the permissions to send, and it can't read templates or suppressions. When the person chooses the API over the dashboard, ask them to create an API key in SparkPost (Configuration, then API Keys) with only the permissions to read the account, subaccounts, templates, and the suppression list, store it in `SPARKPOST_READ_API_KEY` in the git-ignored env file, and write it into the plan as Step 3's plan layout says. Its last use is the suppression import in Step 5. At the end of Step 5, on every way out of it, ask the person to delete the key in SparkPost and remove its variable from the env file, and note in the plan whether they did. The report reminds them when they didn't. Never print the key, and never write it into another file.

The steps call this key the full-access provider key.

## Tracking settings

A site that sets no open or click tracking, in its recipients' `options`, its own `options`, or its template's, sends with the account's settings, as `mapping.md` says under "Tracking". A subaccount can also turn off open tracking for every send of its own. Every site that tracked opens, including one that sets its own tracking, also needs whether the account or subaccount it sends from minimizes open events: that setting wins over the send's own value.

**Ask the person.** In SparkPost's account settings: whether engagement tracking is on by default for API sends, whether click tracking is turned off, whether open events are minimized, whether sends are transactional by default, and whether a `List-Unsubscribe` header is added to transactional mail. For each subaccount the moved sites send from: whether open tracking is turned off for it, and whether its open events are minimized.

**Read from the API.** `GET https://api.sparkpost.com/api/v1/account` with `Authorization: $SPARKPOST_READ_API_KEY`. The answer holds `results.options` with `rest_tracking_default`, `click_tracking`, `enable_minimized_event_passthrough`, `transactional_default`, and `transactional_unsub`. A missing `rest_tracking_default` means `true`, a missing `click_tracking` turns nothing off, and a missing `enable_minimized_event_passthrough`, `transactional_default`, or `transactional_unsub` means `false`. The account's `enable_minimized_event_passthrough` applies to the primary account's sends, and to a subaccount's sends when the subaccount sets none of its own. A subaccount has no setting of its own for the others. For a subaccount, `GET https://api.sparkpost.com/api/v1/subaccounts/{subaccount_id}` holds `results.options.open_tracking_disabled`, `false` when missing, and `results.options.enable_minimized_event_passthrough`. A subaccount without its own `enable_minimized_event_passthrough` takes the account's, and its own value wins when it sets one.

**Opens.** When neither the site's recipients' or transmission's `options` nor its template's set open tracking, in the order "Tracking" in `mapping.md` gives, the account's `rest_tracking_default` decides whether SparkPost put an open pixel in the site's emails: `false` means they had none. A subaccount with `open_tracking_disabled: true` put none in its sends, whatever they set. When the person can't say how these are set and the API isn't read, nobody can tell whether the site's emails had one, as Step 3 under "Opens the provider didn't track" says.

**Clicks.** When neither the site's recipients' or transmission's `options` nor its template's set click tracking, in the order "Tracking" in `mapping.md` gives, the account's `rest_tracking_default` and `click_tracking` decide whether SparkPost tracked its clicks. When the person can't say how they are set and the API isn't read, nobody knows whether SparkPost tracked the site's clicks, as Step 3 says under "A template in PostHog".

## Template content

A site whose template moves needs the content of the version it sends: Step 3 checks it, and Step 7 brings it into the code, or the person makes a template in PostHog from it when they ask for one. The API returns the content as SparkPost stores it, in its template language, and so does the dashboard. A site sends the published version, or the draft when it sets `use_draft_template: true`.

**Copy from the dashboard.** In SparkPost: Content, then Templates, then the template, then the version the site sends. Ask the person for the template's id, its subject, its from address, its reply-to address when it has one, its HTML, and its plain text when it has one. Also ask whether the version has an AMP part or custom headers, and how its open tracking, click tracking, and transactional settings are set: `mapping.md` keeps a template for its open tracking and transactional settings, and notes its click tracking in the plan row. For each snippet the content renders with `render_snippet`, ask for its id, its HTML, and its text.

**Read from the API.** `GET https://api.sparkpost.com/api/v1/templates/{template_id}?draft=false`, or `?draft=true` for a site that sends the draft, with `Authorization: $SPARKPOST_READ_API_KEY`, the key alone with no `Bearer`. The answer holds `results.id`, `results.published`, `results.options` with `open_tracking`, `click_tracking`, and `transactional`, and `results.content`, with `subject`, `from`, `reply_to`, `html`, `text`, `amp_html`, and `headers`, or `email_rfc822` alone. A snippet reads from `GET https://api.sparkpost.com/api/labs/snippets/{snippet_id}`, whose `results.content` holds `html`, `text`, and `amp_html`. SparkPost's docs don't name the key permission that reads snippets: when the read is refused, ask the person for copies. A site that sends from a subaccount reads its template and snippets with the header `X-MSYS-SUBACCOUNT: <subaccount id>`, as `mapping.md` says under "Subaccounts", and a site of the primary account with `X-MSYS-SUBACCOUNT: 0` when the account has subaccounts: a primary key reads the primary account's templates and snippets when the header is missing. A subaccount's send can also use a template or snippet of the primary account whose `shared_with_subaccounts` is `true`. When the subaccount's read finds none, read it with `X-MSYS-SUBACCOUNT: 0`, and use it only when `results.shared_with_subaccounts` is `true`. Otherwise ask the person for copies.

Read the person's copies where they saved them. An API answer goes only into the temporary file Step 3 writes, which is deleted as `template-to-code.md` says. Never write the content into the plan or the report.

## Suppression list

SparkPost keeps one suppression list per account, and one per subaccount. Each entry has a `recipient`, a `type` (`transactional`, `non_transactional`, or `open_tracking`), a `source`, and a `description`, and some carry a `list_id` for one mailing list. SparkPost skips an address with a `transactional` entry on transactional sends, and one with a `non_transactional` entry on the others. It also keeps a global suppression list that no API can read.

**Export from the dashboard.** In SparkPost: Recipients, then Suppressions. SparkPost's docs describe no file export there, so ask the person whether they already have an export file, such as from their own tooling, and where they saved it. Read the header row to find the address, type, and source columns. Without a file, read the list from the API.

**Read from the API.** With `Authorization: $SPARKPOST_READ_API_KEY`, on `api.eu.sparkpost.com` for an EU account (see the top of this file):

```
GET https://api.sparkpost.com/api/v1/suppression-list?cursor=initial&per_page=10000&types=transactional,non_transactional,open_tracking
```

The request takes every source and every type, so the agent can import some entries and count the others. Without `types`, SparkPost leaves out `open_tracking` entries.

The answer holds `results`, a list of `{ recipient, type, source, description, list_id, created, updated }`, `total_count`, and `links`. Follow the `href` of the link whose `rel` is `next` until no such link comes back or `results` is empty. Wait 1 to 5 seconds and retry on `429`. An account with subaccounts: read the list of each account the moved sites send from, as `mapping.md` says under "Subaccounts", on its own, with the header `X-MSYS-SUBACCOUNT: 0` for the primary account and the subaccount's ID for a subaccount. A search without the header covers every list at once, and SparkPost says such a search can be up to 20 minutes out of date. An account without subaccounts needs no header. When the moved sites send from more than one account, count the import as complete only when the list of every one is in.

**Map each entry.**

| SparkPost `source` | Entries to take | PostHog `reason` |
|---|---|---|
| `Bounce Rule` | Every type | `bounce` |
| `Spam Complaint` | Every type | `complaint` |
| `Manually Added` | `transactional` only | `manual` |
| `Compliance` | `transactional` only | `manual` |

An address can come back once per type. Repeating it in the import is safe. PostHog blocks a moved send only to an address imported as `bounce`, as Step 5 says: a `complaint` or `manual` entry blocks only PostHog's marketing email. Step 3 asks which sites rely on the entries someone added, as `mapping.md` says under "Suppression list".

**Leave out the other entries.**

- **`List Unsubscribe` and `Unsubscribe Link`** are unsubscribes from non-transactional mail, and so are `Manually Added` and `Compliance` entries of type `non_transactional`, and entries with a `list_id`. They are marketing preferences, and PostHog's opt-outs apply to marketing messages only. SparkPost skipped these addresses on every send it sent as non-transactional. A site that SparkPost sent as non-transactional moves only as `mapping.md` says under `options.transactional`, and every send that moves sends as transactional.
- **`Tracking Consent Revoked`** entries, of type `open_tracking`, block no send: they only turn off open tracking for the address. Step 3 asks about them first, as `mapping.md` says under "Tracking".

## For the report

When the list was read, from the API or an export file, count from it:

- the entries left out as unsubscribes from non-transactional mail, as "Leave out the other entries" says;
- the `Tracking Consent Revoked` entries.

When the list wasn't read, write `not counted` for each.
Loading
Loading