mappings_diff

Overview ¶

Reports drift between the freshly-extracted allowlists (*.gen.json) and the hand-edited mapping inputs (go_to_sqlite.json, sqlite_skip.json, sqlcipher_codec.json). Designed as the first step after a regen — surfaces what needs human triage before build_mappings is run with its strict checks.

Run from the repo root, after extract_funcs + extract_codec_blocks:

go run ./docs/btree/mappings/scripts/extract_funcs
go run ./docs/btree/mappings/scripts/extract_codec_blocks
go run ./docs/btree/mappings/scripts/mappings_diff
go run ./docs/btree/mappings/scripts/build_mappings

Reports six buckets:

• go new Go funcs that need a row in go_to_sqlite.json
• go rows in go_to_sqlite.json whose Go func no longer exists
• c new SQLite funcs (in neither go_to_sqlite cites nor sqlite_skip)
• c SQLite funcs cited or skipped that no longer exist upstream
• codec new SQLCipher codec blocks that need a row in sqlcipher_codec.json
• codec rows in sqlcipher_codec.json whose block no longer exists upstream

Always exits 0; intended for triage, not gating.