Skip to content

mcpplibs.mwrap.recastnavigation: name compat.recastnavigation in the plan and changelog, and why the wrapper vendors #789

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Sunrisepeak merged 1 commit into from
Nov 14, 2026
Merged

mcpplibs.mwrap.recastnavigation: name compat.recastnavigation in the plan and changelog, and why the wrapper vendors #789

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
11 changes: 7 additions & 4 deletions .agents/docs/2026-11-15-add-recastnavigation-mwrap-plan.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,10 +8,13 @@
package `mcpplibs.mwrap.recastnavigation`, version 1.6.0 (the first indexed release of the identity), tag `mwrap-1.6.0`;
release asset `recastnavigation-m-1.6.0.tar.gz` (`13382f6c…daa05`), CN mirror `gitcode.com/mcpp-res/mwrap-recastnavigation`
with identical bytes.
- Implementation ownership: the library has no compat package in this index, so the wrapper vendors the four libraries
(Recast, Detour, DetourCrowd, DetourTileCache: `Include/` and `Source/`) from the release archive (checksums of every
file in `upstream/documents.json`) and builds them with `-ffp-contract=off` and no fast math, with `NDEBUG` in every
profile (upstream declares its assert hooks only without it). DebugUtils, the demo and upstream's tests are not
- Implementation ownership: this index has `compat.recastnavigation` 1.6.0 (the same release). The wrapper does not
depend on it: what it is for is the same mesh bytes and crowd places on every platform and in every profile, which
needs the library itself compiled with `-ffp-contract=off`, no fast math and `NDEBUG` in every profile (upstream
declares its assert hooks only without it), flags a dependency's build does not take from its consumer. It vendors
the four libraries (Recast, Detour, DetourCrowd, DetourTileCache: `Include/` and `Source/`) from the release archive
(checksums of every file in `upstream/documents.json`) and builds them so. A program links one of the two, not both
(docs/mwrap.md: one owner of an implementation in a program). DebugUtils, the demo and upstream's tests are not
vendored. It deploys upstream's README and License.txt with its own LICENSE/NOTICE (`runtime.deploy`).

## Module
Expand Down
2 changes: 1 addition & 1 deletion CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@
带障碍物的分块网格）的 C++23 模块，以 `export using` 在全局命名空间导出 Recast、Detour、DetourCrowd、DetourTileCache 头文件的
全部公开名字（99 个类型、75 个无作用域枚举的枚举项、170 个函数）；52 个内部链接的 `static const` 常量（`DT_VERTS_PER_POLYGON`、
`DT_SUCCESS`、`RC_WALKABLE_AREA`、`RC_PI` 等）以原名、原类型和原值位于 `mcpplibs::mwrap::recastnavigation`。导出清单由 clang 读头文件
推出并在 CI 中审计。封装仓库从上游 1.6.0 发布包取源码，以 `-ffp-contract=off`、不用快速数学构建，`NDEBUG` 使各配置相同：同一
推出并在 CI 中审计。封装仓库从上游 1.6.0 发布包取源码（不依赖 `compat.recastnavigation`：确定性要求库本身以 `-ffp-contract=off`、不用快速数学、各配置都定义 `NDEBUG` 编译，依赖的构建不接受消费者的这些标志；一个程序只链接两者之一），以这些标志构建：同一
组三角形与群体在 Linux x86-64 与 arm64、macOS、Windows、wasm32 上，dev 与 release，网格字节与群体位置的哈希相同（钉住）。不含
DebugUtils 与演示程序。消费者测试 `tests/mwrap/recastnavigation-path`，安装后模板检查带 `--deploy`。GLOBAL 为 GitHub 发布资产，
CN 为 GitCode `mcpp-res/mwrap-recastnavigation` 镜像，sha256 相同。
Expand Down