cJSON 版本锚定（等价于 fork 哪个 commit）

[Pavel-liu]

Question

行为等价必须锚定 cJSON 的具体版本。Pavel-liu/cJSON fork 相对上游 DaveGamble/cJSON 有无自定义改动？应锚定哪个 commit 作为行为基准？现有测试集（unity + json-patch-tests）对应哪个版本？查 git log / 与上游对比。

Part of #1 (cjson-rs 迁移地图)

[Pavel-liu]

Resolution

决策：锚定 commit fb16e5cf358798aabb049655975cde8427101056（= 上游 DaveGamble/cJSON master HEAD，版本口径「1.7.19 + 5 commits，2026-04-09」）。Pavel-liu fork 与上游零差异，无需维护 fork-specific diff。

Findings

推荐锚定的版本/commit

• 锚定 commit：fb16e5cf358798aabb049655975cde8427101056（fork HEAD = 上游 master HEAD，git ls-remote 实测完全一致）
• 版本标签为 1.7.19（CMakeLists.txt:5 + cJSON.h:82-84），但实际领先 1.7.19 发布 commit 5 个提交，含发布后的安全/缺陷修复
• fork 无任何 git tag，唯一稳定基线即此 commit

Pavel-liu fork 与上游差异：零差异

• 全部 1112 个 commit 作者均为上游 cJSON 贡献者，无任何 "Pavel"/"liu" 自定义提交
• 1.7.19 后 5 个 commit 全部引用上游 PR（Upgrade version of cmake_minimum_required to 3.5 DaveGamble/cJSON#986/Fix: add depth check to prevent stack overflow in cJSON_Print DaveGamble/cJSON#984/docs: fix outdated CMake version requirement in README DaveGamble/cJSON#990/fix: prevent NULL pointer dereference in cJSON_SetNumberHelper DaveGamble/cJSON#991/Fix: Type Confusion vulnerability in cJSONUtils_ApplyPatches DaveGamble/cJSON#1006）
• 行为等价只需对照上游 DaveGamble/cJSON，无需维护 fork diff

HEAD 相对 1.7.19 的 5 个增量 commit（3 个影响行为）

commit	PR	行为影响
5cc0e39	DaveGamble#984	cJSON_Print 增加深度检查（防栈溢出，改变深嵌套行为）
b2890c8	DaveGamble#991	cJSON_SetNumberHelper 防 NULL 解引用（改变边界行为）
fb16e5c	DaveGamble#1006	cJSON_Utils 类型混淆修复（改变 Utils 行为）

→ 锚定 fb16e5c 而非 1.7.19 release commit c859b25，以覆盖这 3 个影响行为的修复。

测试集版本：全部上游同源。Unity（tests/unity/）、JSON Patch v1.1.0（tests/json-patch-tests/）、parse/print/misc 单元测试均与 HEAD 同源，即行为等价的验证基准。

[Pavel-liu]

Research 完成：锚定 fb16e5c（fork=上游零差异）。决策记入地图。