Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
221 commits
Select commit Hold shift + click to select a range
f034ecd
fix(skills): ship a variant's own reference folder in its bundle
Silthus Oct 22, 2026
177e741
refactor(skills): share the email sender setup as a partial
Silthus Oct 22, 2026
8169d7e
feat(skills): add the migrate-email skill with a Resend variant
Silthus Oct 22, 2026
5e019aa
fix(skills): keep migrate-email's summary values bare and define a site
Silthus Oct 22, 2026
6e902dc
fix(skills): point migrate-email at the transactional email docs and …
Silthus Oct 31, 2026
0286e23
fix(skills): check migrate-email's API access with the real tools and…
Silthus Nov 1, 2026
0920218
refactor(skills): share the posthog-node client setup as a partial
Silthus Oct 22, 2026
64a2397
feat(skills): move Resend sends to posthog-node in migrate-email
Silthus Oct 22, 2026
ad4b0c7
fix(skills): keep migrate-email from splitting sends or faking the ol…
Silthus Oct 22, 2026
b2965cc
fix(skills): handle suppressed recipients and dynamic subjects in mig…
Silthus Oct 22, 2026
f8f4fea
fix(skills): keep a suppressed copy address from passing as a sent email
Silthus Oct 22, 2026
8dcd459
fix(skills): warn that retrying a send with a suppressed copy address…
Silthus Oct 22, 2026
154e8f5
fix(skills): leave migratedFrom off the posthog-node client in migrat…
Silthus Oct 31, 2026
9cd85f5
fix(skills): check that posthog-node has the code form before migrate…
Silthus Nov 1, 2026
41ca66a
fix(skills): detect resend over smtp, stop without sends, and record …
Silthus Nov 1, 2026
0e526b9
refactor(scripts): ship variant references through the local referenc…
Silthus Nov 1, 2026
e51df39
merge: feat/migrate-email-resend into feat/migrate-email-resend-cutover
Silthus Nov 1, 2026
8c841cd
fix(skills): tie migrate-email's test send to its own events and repo…
Silthus Nov 1, 2026
4ad8c6e
fix(skills): let migrate-email move on when DNS waits and read templa…
Silthus Nov 1, 2026
020b877
merge: feat/migrate-email-resend into feat/migrate-email-resend-cutover
Silthus Nov 1, 2026
8452a82
fix(skills): pin migrate-email's test start to the database clock and…
Silthus Nov 1, 2026
53a190c
fix(skills): keep migrate-email's test clock uncached and report depe…
Silthus Nov 1, 2026
50b5f27
fix(skills): keep migrate-email's chain query uncached on its rerun
Silthus Nov 1, 2026
8f77354
fix(skills): keep cc, bcc, headers, tags and attachments sites on Res…
Silthus Nov 2, 2026
d871b8e
Merge feat/migrate-email-resend into feat/migrate-email-resend-cutover
Silthus Nov 2, 2026
b9d785e
Drop local templates and parked fields from the cutover steps
Silthus Nov 2, 2026
5edeb92
feat(migrate-email): set migratedFrom on the posthog-node client
Silthus Nov 2, 2026
64cf8ef
fix(migrate-email): ask for the PostHog template ID before a template…
Silthus Nov 2, 2026
85f6096
fix(migrate-email): check each PostHog template and its sender before…
Silthus Nov 2, 2026
a759ff4
fix(migrate-email): ask about a repeat import and test a send that na…
Silthus Nov 2, 2026
5c8a34b
fix(migrate-email): ask for the PostHog template ID and sender before…
Silthus Nov 2, 2026
e053dab
Merge feat/migrate-email-resend into feat/migrate-email-resend-cutover
Silthus Nov 2, 2026
efa4933
fix(skills): read Dirent.path when parentPath is missing in the migra…
Silthus Nov 2, 2026
5e40f2a
Merge feat/migrate-email-resend into feat/migrate-email-resend-cutover
Silthus Nov 2, 2026
2c36853
fix(migrate-email): match account.md's template-content rule to Step 3
Silthus Nov 2, 2026
8dcf6e7
fix(migrate-email): keep a site on Resend when its idempotency key do…
Silthus Nov 2, 2026
07dbf3a
fix(migrate-email): name PostHog's idempotency key rule exactly
Silthus Nov 2, 2026
a1376c0
Merge feat/migrate-email-resend into feat/migrate-email-resend-cutover
Silthus Nov 2, 2026
21f683e
fix(migrate-email): end Step 8's email check when the person declines…
Silthus Nov 2, 2026
d157859
docs(migrate-email): say where a send without distinctId lands
Silthus Nov 3, 2026
5dcdd21
docs(migrate-email): test Step 8 on a site that passes distinctId
Silthus Nov 3, 2026
4fc8d41
docs(migrate-email): say why cc, bcc and attachments stay on Resend
Silthus Nov 4, 2026
9664659
docs(migrate-email): name the real reason a field stays on Resend
Silthus Nov 4, 2026
4e5a672
docs(migrate-email): give scheduled sends and topics a reason too
Silthus Nov 4, 2026
8d88206
fix(migrate-email): keep a site on Resend when its key length is unbo…
Silthus Nov 4, 2026
5863a99
fix(migrate-email): quote Resend fallbacks with single quotes only
Silthus Nov 4, 2026
eed16c6
fix(migrate-email): record the PostHog key as set only after a check …
Silthus Nov 4, 2026
2d91936
fix(migrate-email): accept spaces around = in the key check
Silthus Nov 4, 2026
074130e
fix(migrate-email): check the last assignment of the PostHog key
Silthus Nov 4, 2026
5c92245
docs(migrate-email): ask for the transactional_email:write scope
Silthus Nov 5, 2026
f5080a7
Merge remote-tracking branch 'origin/feat/migrate-email-resend' into …
Silthus Nov 5, 2026
254dbb9
fix(migrate-email): name the transactional email scope in the preflight
Silthus Nov 5, 2026
464644f
Merge branch 'feat/migrate-email-resend' into feat/migrate-email-rese…
Silthus Nov 5, 2026
4b0f257
feat(migrate-email): move Resend sends in every PostHog SDK's language
Silthus Nov 5, 2026
c4ed38c
fix(migrate-email): keep the app booting and check the whole project …
Silthus Nov 5, 2026
a658c75
fix(migrate-email): use the one Rust client the app's features build
Silthus Nov 5, 2026
cffc009
feat(migrate-email): carry posthog-sdks.md's rules into the rewrite f…
Silthus Nov 5, 2026
6ab1cc2
Merge the migration lane's per-SDK rules into feat/migrate-email-all-…
Silthus Nov 5, 2026
f6b6af8
fix(migrate-email): check the merged SDK rules against the SDK heads
Silthus Nov 5, 2026
ef2c2e9
fix(migrate-email): give Elixir email its own instance when the app u…
Silthus Nov 5, 2026
fbd1e83
fix(migrate-email): never pass nil for Elixir's host or token
Silthus Nov 5, 2026
78d56ce
fix(migrate-email): fall back past a nil :posthog host in Elixir
Silthus Nov 5, 2026
bb711c5
fix(migrate-email): list the error names once and state reply-to per SDK
Silthus Nov 5, 2026
5398fd9
fix(migrate-email): give email its own client behind a reverse proxy
Silthus Nov 5, 2026
6924d48
test(migrate-email): pin keeping the secret key off the proxied client
Silthus Nov 5, 2026
2ebcce0
feat(migrate-email): bring Resend templates into the code
Silthus Nov 5, 2026
5d29690
feat(migrate-email): map turned-off open and click tracking to track_…
Silthus Nov 9, 2026
ec3783e
feat(migrate-email): map only turned-off open tracking to track_opens…
Silthus Nov 9, 2026
4ce6c2d
docs(migrate-email): record engagement events only when engagement ca…
Silthus Nov 9, 2026
dc66635
feat(migrate-email): map turned-off open tracking to the tracking option
Silthus Nov 10, 2026
a90c30a
fix(migrate-email): use SDK tracking names and skip tracking on templ…
Silthus Nov 10, 2026
07c4c06
feat(migrate-email): map a provider's sensitive or no-track setting t…
Silthus Nov 11, 2026
553a223
fix(migrate-email): mark every migrated code send sensitive
Silthus Nov 11, 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
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
487262b
fix(skills): close the migrate-email preparation gaps the QA swarm found
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
0158aef
fix(migrate-email): keep sites that branch on one kind of network fai…
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
7ccc0ee
fix(migrate-email): keep a Python whole-request limit on the provider
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
a66e15b
fix(migrate-email): upgrade mocked send tests to the HTTP boundary
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
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
cff58f5
fix(migrate-email): route a network failure the way Resend's code did
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
bad56da
Merge branch 'feat/migrate-email-all-sdks' into feat/migrate-email-tr…
Silthus Nov 12, 2026
c6f7e9a
fix(migrate-email): move untracked-open sites with opens off, no ask
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
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
952dc2b
fix(migrate-email): name the engagement switch and say why code sends…
Silthus Nov 13, 2026
8c4d1b2
Merge feat/migrate-email-all-sdks into feat/migrate-email-track-opens…
Silthus Nov 13, 2026
322370a
fix(migrate-email): name the project's engagement setting and the cli…
Silthus Nov 13, 2026
cf0cca5
fix(migrate-email): keep a click-handler template site with opens off…
Silthus Nov 13, 2026
51a6543
fix(migrate-email): keep an open-handler site with unknown tracking o…
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
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
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
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
808f61d
fix(migrate-email): name each SDK's sensitive flag; list the moved keys
Silthus Nov 13, 2026
b6eb5b0
Merge feat/migrate-email-all-sdks into feat/migrate-email-track-opens…
Silthus Nov 13, 2026
fd58f93
fix(migrate-email): move the template keys to after cutover; edge reason
Silthus Nov 13, 2026
7dcc992
fix(migrate-email): fold #472's secret-only sensitive rule into every…
Silthus Nov 13, 2026
b46e4bc
Merge feat/migrate-email-all-sdks into feat/migrate-email-track-opens…
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
de31adb
Merge feat/migrate-email-all-sdks into feat/migrate-email-track-opens…
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
b9d6110
Merge feat/migrate-email-all-sdks into feat/migrate-email-track-opens…
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
4bffa25
Merge feat/migrate-email-all-sdks into feat/migrate-email-track-opens…
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
37c0020
Merge feat/migrate-email-all-sdks (#472 final head) into feat/migrate…
Silthus Nov 13, 2026
2a15cac
Merge main into feat/migrate-email-track-opens-and-clicks
Silthus Nov 13, 2026
7f3e6b8
Merge main into feat/migrate-email-track-opens-and-clicks
Silthus Nov 17, 2026
ad76d77
fix(migrate-email): answer panel round 3 on tracking text
Silthus Nov 17, 2026
c54a7db
fix(migrate-email): act on the shared-template opens note in Step 9
Silthus Nov 17, 2026
bb9d947
fix(migrate-email): skip an unconfirmed opens-off template in Step 8'…
Silthus Nov 18, 2026
0f39f57
Merge main into feat/migrate-email-track-opens-and-clicks
Silthus Nov 18, 2026
4d6e759
fix(migrate-email): keep an opens-off site on its provider when a tra…
Silthus Nov 18, 2026
61fdf91
Merge main into feat/migrate-email-track-opens-and-clicks
Silthus Nov 18, 2026
d40f3fa
docs(migrate-email): ask Resend click tracking with opens, tighten tr…
Silthus Nov 18, 2026
71e6fe2
docs(migrate-email): move opens-off sites into code, never to a PostH…
Silthus Nov 18, 2026
c6a9d89
docs(migrate-email): check opens before asking for a PostHog template
Silthus Nov 18, 2026
5b0b757
docs(migrate-email): pick the code form for opens-off sites before te…
Silthus Nov 18, 2026
f4680f1
Revert "docs(migrate-email): pick the code form for opens-off sites b…
Silthus Nov 18, 2026
bc4bec7
docs(migrate-email): keep tracked-sensitive sites off PostHog templates
Silthus Nov 18, 2026
b5c3854
docs(migrate-email): turn clicks on only for emails with links safe t…
Silthus Nov 18, 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
26 changes: 16 additions & 10 deletions context/skills/migrate-email/references/3-inventory.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,8 +56,6 @@ A field set to an empty value, such as `""`, `[]`, `{}`, or `null`, or to its of

When the code passes a value you can't read, such as a list of recipients built at run time, follow it to its callers. When it comes from an environment variable or a config value, read it from the config, or ask the person once what it holds in production. An example env file names the variable, but its value is often a placeholder: trust it only when it is clearly the deployed value. When you still can't tell, the site stays, and the reason says what you could not check.

For a template the person asks to make in PostHog, a value that the provider template tests or loops over, which `mapping.md` needs to be a boolean or a list, must have that type at run time: the code builds it, such as a literal or a value it computes, or checks it, such as with a schema or a parse. A type the code only declares, such as a TypeScript type or a cast, checks nothing at run time. When the value comes from request input, a file, or another service without such a check, such as `req.body`, the site stays, and the reason is `<value> is not checked to be a <boolean|list>`: the provider's template and Liquid can render a value such as `0` or `""` differently.

A site stays when no sender can be verified for its `from`: an address on a free mail domain, such as `gmail.com` or `outlook.com`, on the provider's shared or sandbox domain, on a domain whose DNS records the person can't publish, such as a school's or another company's, or taken from a user, a customer, or a tenant at run time. The reason names the address or where it comes from. When a site that is not a `template` site sets no `from`, the provider sent from the account's default sender: ask the person for that address once, and the site stays when they can't name it.

Unless the provider's `account.md` says it keeps no suppression list, ask the person once, for the sites the checks above leave moving, which of them they rely on that list to stop mailing an address someone added to it, by hand in the provider's dashboard or with a call the app makes, such as an unsubscribe handler. PostHog blocks a moved send only to an address that hard-bounced, so a moved send reaches such an address, whenever it was added. Each site they name stays, and the reason is `relies on <provider name>'s suppression list`. When they can't tell or don't answer, every such site stays with that reason. Write `to move: the app keeps its own record of those addresses, the ones added before included, and skips them before the send` in the note of each site that stays with that reason, under the sites table, for the report.
Expand All @@ -68,17 +66,25 @@ Ask the person once, listing every other template the sites send, with the plan

Each template that moves needs its content to be checked. Read the provider's `account.md`, and ask the person once for every such template: copies from the dashboard that they save in files outside the repository and tell you where, or a read through the API, where `account.md` says the API returns the content. Check each one as `template-to-code.md` says under "Check", with the provider's `mapping.md` under "Templates". When the person can't give the content, the site stays, and the reason is `template content not checked`. A template whose check fails stays, and the reason names the part that keeps it. Write the site's `from` column with the address the send uses: the call's own `from` when it sets one, and the template's sender otherwise, so Step 4 sets up a sender for its domain, and classify that address as any other `from`.

### A template in PostHog, when the person asks for one
### Opens the provider didn't track

A template the person asks to make in PostHog moves in the template form, by its template ID, and the person makes that template: never make one yourself. Its content needs the same check, against the part of `mapping.md` on templates made in PostHog. Ask them once, for every such template, to make it in PostHog from the provider's template and give you its template ID and the address it sends from, usually the provider template's sender. PostHog makes a template transactional only once a verified sender covers its address: ask them to make it transactional now when the project has one, and otherwise once Step 4 verifies the sender. When the email carries a login code, a reset link, or another secret, ask them to mark the template sensitive, as `mapping.md` says. Ask them the same when the provider didn't track the site's clicks, or nobody knows whether it did, as the provider's `account.md` says: PostHog sends each link of a template that is not marked sensitive through its click redirect, which those links never went through. Tell them that a sensitive template keeps no copy of each sent email's body or filled-in subject. When they don't mark it, the site stays, and the reason is `click tracking off`, or `click tracking not checked` when nobody knows. The report lists both before cutover either way. For a template that must be marked sensitive, for a secret in the email or for its clicks, write `must be marked sensitive: <a secret in the email|click tracking off|click tracking not checked>` in its note under the sites table, so the report's "Before cutover" list checks it. Tell them how its placeholders change, as that part of `mapping.md` says. Quote every Liquid string with single quotes, such as `default: 'there'`: PostHog's email builder saves the template as JSON, which escapes double quotes, and the template then fails with a `TokenizationError`. A fallback or a compared value that holds a `'` keeps the template on the provider. Record each template ID with its site under the sites table, and write the address in the site's `from` column. A template without an ID stays, and the reason is `PostHog template not made yet`.
PostHog adds its open pixel to every email it sends unless the send turns its `opens` switch off, as Step 7 says. Once you know each site's sender, check for each site that nothing else keeps on the provider whether the provider tracked the opens of its emails, with an open pixel in each one, as the provider's `account.md` says. Never ask the person whether PostHog may add its pixel: the site moves either way.

### Opens the provider didn't track
- When a site's emails had no open pixel, because the provider never tracks opens, or open tracking was off or never set up, the site moves with opens off. Write `opens off: <provider name> didn't track its opens` in its note under the sites table.
Comment thread
Silthus marked this conversation as resolved.
Resolved
- When nobody can tell whether the provider tracked a site's opens, the site moves with opens off too, so PostHog adds no pixel the old emails may not have had. Write `opens off: open tracking not checked` in its note. A site whose emails a webhook handler acts on for the provider's open event, such as `email.opened` in Resend or `open` in SendGrid, stays instead, and the reason is `open tracking not checked`: with opens off, PostHog sends no opened events in place of the provider's.
- When the provider tracked the site's opens, the site moves with nothing to note.

A send by template ID can't set tracking, so a site where tracking matters never moves to a template made in PostHog, even when the person asked for one:

- A site with opens off moves into the code, where `tracking` turns `opens` off, as Step 7 says. When it can't, it stays, and the reason is `opens off needs a code send`.
- A site whose open tracking changes from send to send, such as SendGrid's `openTracking` with `enable: !recipient.optedOut`, stays, and the reason is `open tracking set at run time`.
- A site whose emails a webhook handler acts on for the provider's click event stays, and the reason is `its clicks feed a webhook handler`: Step 7 never tracks a code send's clicks.

### A template in PostHog, when the person asks for one

PostHog adds its open pixel to every email it sends, in the code form and from a template made in PostHog alike. Check this for each site that nothing else keeps on the provider, as the provider's `account.md` says: whether the provider tracked the opens of its emails, with an open pixel in each one.
The checks under "Opens the provider didn't track" come first. A template the person asks to make in PostHog moves in the template form, by its template ID, and the person makes that template: never make one yourself. Its content needs the same check, against the part of `mapping.md` on templates made in PostHog. Ask them once, for every such template, to make it in PostHog from the provider's template and give you its template ID and the address it sends from, usually the provider template's sender. PostHog makes a template transactional only once a verified sender covers its address: ask them to make it transactional now when the project has one, and otherwise once Step 4 verifies the sender. When the email carries a login code, a reset link, or another secret, ask them to mark the template sensitive, as `mapping.md` says. Ask them the same when the provider didn't track the site's clicks, or nobody knows whether it did, as the provider's `account.md` says: PostHog sends each link of a template that is not marked sensitive through its click redirect, which those links never went through. Tell them that a sensitive template keeps no copy of each sent email's body or filled-in subject. When they don't mark it, the site stays, and the reason is `click tracking off`, or `click tracking not checked` when nobody knows. The report lists both before cutover either way. For a template that must be marked sensitive, for a secret in the email or for its clicks, write `must be marked sensitive: <a secret in the email|click tracking off|click tracking not checked>` in its note under the sites table, so the report's "Before cutover" list checks it. Tell them how its placeholders change, as that part of `mapping.md` says. Quote every Liquid string with single quotes, such as `default: 'there'`: PostHog's email builder saves the template as JSON, which escapes double quotes, and the template then fails with a `TokenizationError`. A fallback or a compared value that holds a `'` keeps the template on the provider. Record each template ID with its site under the sites table, and write the address in the site's `from` column. A template without an ID stays, and the reason is `PostHog template not made yet`.

- When a site's emails had no open pixel, because the provider never tracks opens, or open tracking was off or never set up, ask the person once, for all such sites together, whether PostHog may add its open pixel to emails that never had one. Yes: those sites move, and the report says that PostHog now counts their opens. No, or no answer: they stay, and the reason is `open tracking off`.
- When nobody can tell whether the provider tracked a site's opens, the site stays, and the reason is `open tracking not checked`.
- For each site that moves with the person's yes, write `open pixel added: the person agreed` in its note under the sites table, so the report names it.
A value that the provider template tests or loops over, which `mapping.md` needs to be a boolean or a list, must have that type at run time: the code builds it, such as a literal or a value it computes, or checks it, such as with a schema or a parse. A type the code only declares, such as a TypeScript type or a cast, checks nothing at run time. When the value comes from request input, a file, or another service without such a check, such as `req.body`, the site stays, and the reason is `<value> is not checked to be a <boolean|list>`: the provider's template and Liquid can render a value such as `0` or `""` differently.

## Write the plan file

Expand Down Expand Up @@ -106,7 +112,7 @@ A sites table, one row per site, in source tree order:

`moves` is `yes` or `no`. `reason` is empty when the site moves.

Under the table, for each `template` site that moves, note its provider template's ID or name, whether it moves into the code or to a template made in PostHog, and where its content is: the person's copy, or the temporary file of the API answer. For a template made in PostHog, add its template ID, and `must be marked sensitive: <reason>` when Step 3 says it must be. For any site that moves with an open pixel its emails never had, note `open pixel added: the person agreed`, as Step 3 says under "Opens the provider didn't track". For each site that stays because it relies on the provider's suppression list, note what would let it move, as Step 3 says after the sender check.
Under the table, for each `template` site that moves, note its provider template's ID or name, whether it moves into the code or to a template made in PostHog, and where its content is: the person's copy, or the temporary file of the API answer. For a template made in PostHog, add its template ID, and `must be marked sensitive: <reason>` when Step 3 says it must be. For any site that moves with opens off, note `opens off: <reason>`, as Step 3 says under "Opens the provider didn't track". For each site that stays because it relies on the provider's suppression list, note what would let it move, as Step 3 says after the sender check.

In any step, when the provider's `mapping.md` or `account.md`, or a rewrite file, says to note something for the report's "Before cutover" list, write it under the table as a note that starts with `before cutover:`, such as `before cutover: enable ext-curl where the app runs`. When a later step undoes what a note is about, such as an SDK install that Step 7 undoes under "Set up the SDK", it deletes the note. Step 9 lists each note left.

Expand Down
Loading
Loading