docs: plan xlings compat packages

Author: Sunrisepeak

.agents/docs/2026-05-30-xlings-compat-packages-plan.md

@@ -0,0 +1,55 @@
+# mcpp-index: xlings Native Dependency Packages Plan
+
+> 状态: pending on mcpp core support
+> 分支: `codex/xlings-mcpp-compat-packages`
+> 目标: 把 xlings 当前本地 mcpp index 中的通用 C/C++ 依赖迁移到官方 mcpp-index，使 xlings 可以直接使用默认索引。
+
+## 待新增包
+
+- [ ] `compat.zlib`
+- [ ] `compat.bzip2`
+- [ ] `compat.lz4`
+- [ ] `compat.zstd`
+- [ ] `compat.xz`
+- [ ] `compat.libarchive`
+
+## 命名判断
+
+第三方兼容库应使用 `compat.*` 命名空间。`compact` 容易和 xlings 内部 `core.compact` 模块混淆，不适合作为官方第三方库命名空间。
+
+## 包迁移来源
+
+来源仓库:
+
+```text
+/home/speak/workspace/github/openxlings/xlings/mcpp/pkgs
+/home/speak/workspace/github/openxlings/xlings/mcpp/include
+```
+
+迁移时需要把配置头和包级 flags 变成包自身资产，而不是要求消费者项目提供。
+
+## 依赖关系
+
+```text
+compat.libarchive
+  -> compat.zlib
+  -> compat.bzip2
+  -> compat.lz4
+  -> compat.zstd
+  -> compat.xz
+```
+
+## 验证要求
+
+- [ ] `mcpp search libarchive` 能找到官方索引包。
+- [ ] 一个最小项目只声明 `libarchive`，无需根级第三方 C 库宏即可构建。
+- [ ] xlings 改用默认 mcpp-index 后 `mcpp build` 通过。
+- [ ] musl static target 通过。
+
+## Checkpoints
+
+- [ ] 文档 checkpoint commit。
+- [ ] 等 mcpp 支持 package-owned flags 后迁移包描述。
+- [ ] 增加官方 index smoke test。
+- [ ] PR draft 创建并等待 CI。
+