The daily model sync rewrites synced provider TOMLs by parsing and
re-serializing them, which discards every comment except a leading header
block (the preservation added in f07ac11f only re-attaches the top-of-file
comment run). Any comment authored between sections was silently deleted on
every rewrite that touched the file — e.g. sync PR #3004 stripped Venice's
"# Live /models ..." citation from before [[reasoning_options]].
Rather than teach the serializer to track inline comments, move every
existing inline comment to the top of its file (a one-time data migration)
and document the rule in AGENTS.md. The existing leading-header
preservation then keeps them across rewrites.
Migrated 82 model files across Venice, Baseten, OVHcloud, and Cloudflare
Workers AI. Verified: every file parses to identical data before and after
(0 data mismatches), and round-tripping all 1000 synced files through the
existing formatToml + leadingComments preservation loses 0 comments.
No code change.
Aiden Cline