feat(build): support package-owned build metadata

Adds package-owned compile flags and generated files, fixes namespaced local path index lookup, quiets internal xlings update output, and bumps mcpp to 0.0.35.

Author: Sunrisepeak

.agents/docs/2026-05-30-package-owned-build-flags-plan.md

@@ -0,0 +1,77 @@
+# mcpp 0.0.35: Package-Owned Build Metadata Plan
+
+> 状态: in progress
+> 分支: `codex/package-owned-build-flags`
+> 目标: 让依赖包在官方 mcpp-index 中携带自己的 C/C++ 编译 flags、include 优先级和配置头，从而让 xlings 不再把第三方 C 库的 configure 结果写在项目根 `mcpp.toml`。
+
+## 背景
+
+xlings 现在可以用 `mcpp 0.0.34` 构建，但工程文件里有大量 C 库宏:
+
+- zlib/lua 的平台配置头。
+- zstd 的 `ZSTD_DISABLE_ASM`。
+- xz/liblzma 的 `HAVE_*`、encoder/decoder/check 配置。
+- libarchive 的压缩后端和平台 API 配置。
+
+这些宏本质上是 zlib、xz、zstd、libarchive 等包自己的 configure 结果。它们放在 xlings 根 manifest 中会导致:
+
+- 任何消费者都要重复维护同一批宏。
+- 包索引无法表达完整构建语义。
+- 后续把依赖迁移到官方 mcpp-index 后，仍然删不掉根级 `build.cflags`。
+
+## 设计目标
+
+- [x] 依赖包描述中的 `mcpp.cflags` / `mcpp.cxxflags` 能作用到该包自己的 compile units。
+- [x] 包级 include dirs 在编译该包源码时优先于全局 include dirs。
+- [x] build fingerprint / cache key 包含包级 flags，避免 flags 变化后误用缓存。
+- [x] Form B 描述支持 `generated_files`，让官方索引包可以生成少量包私有配置头。
+- [x] 本地 `path` 索引读取使用命名空间候选，支持 `pkgs/c/compat.foo.lua` 这类官方索引布局。
+- [x] 保持现有项目级 flags 兼容，不破坏已有 manifest。
+- [x] 用 xlings 当前项目验证 `mcpp build` 和 `mcpp build --target x86_64-linux-musl`。
+
+## 预计修改点
+
+- `src/manifest.cppm`
+  - 保持现有解析入口。
+  - 若缺少字段，不改变默认行为。
+  - 解析 `mcpp.generated_files = { ["path"] = "content" }`。
+- `src/build/plan*.cppm` 或当前 build plan 生成位置
+  - 在 compile unit 上记录 origin package 或直接保存 package-owned flags。
+- `src/build/flags.cppm`
+  - 生成编译命令时合并 per-unit package flags。
+  - 合并顺序建议: package local include dirs -> project include dirs -> dependency propagated include dirs -> toolchain/sysroot。
+- `src/build/fingerprint*.cppm` 或现有 fingerprint 生成位置
+  - 加入 package build metadata hash。
+- `tests/*`
+  - 增加一个最小包级 cflags 测试: 依赖包源码必须依赖包内宏才能编译通过，主项目不声明该宏。
+  - 增加一个最小 Form B `generated_files` 测试: 依赖包源码包含生成头，消费者不声明该头。
+
+## 验证命令
+
+```bash
+mcpp test
+```
+
+```bash
+cd /home/speak/workspace/github/openxlings/xlings
+/home/speak/workspace/github/mcpp-community/mcpp/target/x86_64-linux-gnu/*/bin/mcpp build
+/home/speak/workspace/github/mcpp-community/mcpp/target/x86_64-linux-gnu/*/bin/mcpp build --target x86_64-linux-musl
+```
+
+## Checkpoints
+
+- [x] 文档 checkpoint commit: `9047604`.
+- [x] failing test added: `tests/e2e/50_package_owned_build_flags.sh`.
+- [x] package-owned flags implementation.
+- [x] package-owned generated support files implementation:
+  - `tests/unit/test_manifest.cpp` 覆盖 Form B `generated_files` 解析。
+  - `tests/e2e/51_package_generated_files.sh` 覆盖生成文件参与依赖包编译。
+- [x] local path index namespace lookup:
+  - `tests/e2e/52_local_path_namespaced_index.sh` 覆盖 `compat` 命名空间文件名候选。
+- [x] xlings local validation:
+  - `mcpp build` -> `target/x86_64-linux-gnu/ff952c89919589bb/bin/xlings --version` = `xlings 0.4.45`.
+  - `mcpp build --target x86_64-linux-musl` -> `target/x86_64-linux-musl/7e48a312cd4dbb49/bin/xlings` static ELF.
+- [x] PR draft 创建: https://github.com/mcpp-community/mcpp/pull/88
+- [x] 版本 bump 到 `0.0.35`,并补充 `CHANGELOG.md` 发布说明。
+- [ ] CI 每 120s 检查一次直到完成。
+- [ ] CI 通过后发布 `0.0.35`。

CHANGELOG.md

@@ -3,6 +3,22 @@
 > 本文件追踪 `mcpp-community/mcpp` 公开仓的版本演进。
 > 格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)。
 
+## [0.0.35] — 2026-05-30
+
+### 新增
+
+- 支持包描述拥有自己的 `cflags` / `cxxflags`,依赖包源码编译时会继承所属包
+  的构建宏,消费方项目不再需要集中声明第三方 C 库的私有宏。
+- 支持 Form B `mcpp.generated_files`,官方索引包可以在包目录下生成少量配置头,
+  用于承载平台兼容宏或库私有配置。
+
+### 修复
+
+- 修复本地 `path` 索引读取命名空间包时没有匹配
+  `pkgs/<prefix>/<namespace>.<name>.lua` 的问题。
+- 自定义索引首次同步时保留 mcpp 的 `Fetching custom index repos`
+  状态提示,但静默 xlings update 的内部逐项输出。
+
 ## [0.0.33] — 2026-05-30
 
 ### 改进

mcpp.toml

@@ -1,6 +1,6 @@
 [package]
 name        = "mcpp"
-version     = "0.0.34"
+version     = "0.0.35"
 description = "Modern C++ build & package management tool"
 license     = "Apache-2.0"
 authors     = ["mcpp-community"]

src/build/compile_commands.cppm

@@ -90,15 +90,26 @@ std::vector<std::string> local_include_args(const CompileUnit& cu) {
     return args;
 }
 
+std::vector<std::string> package_flag_args(const CompileUnit& cu, bool isCSource) {
+    std::string joined;
+    auto const& flags = isCSource ? cu.packageCflags : cu.packageCxxflags;
+    for (auto const& flag : flags) {
+        joined += ' ';
+        joined += flag;
+    }
+    return split_flags(joined);
+}
+
 }  // namespace
 
 std::string emit_compile_commands(const BuildPlan& plan, const CompileFlags& flags) {
     nlohmann::json entries = nlohmann::json::array();
 
     for (auto& cu : plan.compileUnits) {
         // Pick compiler + flags based on source type.
-        const auto& compiler = is_c_source(cu.source) ? flags.ccBinary : flags.cxxBinary;
-        const auto& flagStr = is_c_source(cu.source) ? flags.cc : flags.cxx;
+        const bool isCSource = is_c_source(cu.source);
+        const auto& compiler = isCSource ? flags.ccBinary : flags.cxxBinary;
+        const auto& flagStr = isCSource ? flags.cc : flags.cxx;
 
         auto output_path = (plan.outputDir / cu.object).string();
 
@@ -109,6 +120,8 @@ std::string emit_compile_commands(const BuildPlan& plan, const CompileFlags& fla
             args.push_back(std::move(f));
         for (auto& f : split_flags(flagStr))
             args.push_back(std::move(f));
+        for (auto& f : package_flag_args(cu, isCSource))
+            args.push_back(std::move(f));
         args.push_back("-c");
         args.push_back(cu.source.string());
         args.push_back("-o");

src/build/ninja_backend.cppm

@@ -93,6 +93,15 @@ std::string local_include_flags(const CompileUnit& cu) {
     return flags;
 }
 
+std::string join_flags(const std::vector<std::string>& flags) {
+    std::string out;
+    for (auto const& flag : flags) {
+        out += ' ';
+        out += flag;
+    }
+    return out;
+}
+
 void write_file(const std::filesystem::path& p, std::string_view content) {
     std::filesystem::create_directories(p.parent_path());
     std::ofstream os(p);
@@ -315,13 +324,13 @@ std::string emit_ninja_string(const BuildPlan& plan) {
     if constexpr (mcpp::platform::is_windows) {
         // Windows: skip BMI restat optimization (requires POSIX shell).
         append(std::format("  command = "
-               "$cxx $local_includes $cxxflags{} -c $in -o $out\n", module_output_flag));
+               "$cxx $local_includes $cxxflags $unit_cxxflags{} -c $in -o $out\n", module_output_flag));
     } else {
         append(std::format("  command = "
                "if [ -n \"$bmi_out\" ] && [ -f \"$bmi_out\" ]; then "
                  "cp -p \"$bmi_out\" \"$bmi_out.bak\"; "
                "fi && "
-               "$cxx $local_includes $cxxflags{} -c $in -o $out && "
+               "$cxx $local_includes $cxxflags $unit_cxxflags{} -c $in -o $out && "
                "if [ -n \"$bmi_out\" ] && [ -f \"$bmi_out.bak\" ] && "
                   "cmp -s \"$bmi_out\" \"$bmi_out.bak\"; then "
                  "mv \"$bmi_out.bak\" \"$bmi_out\"; "
@@ -335,15 +344,15 @@ std::string emit_ninja_string(const BuildPlan& plan) {
     append("\n");
 
     append("rule cxx_object\n");
-    append("  command = $cxx $local_includes $cxxflags -c $in -o $out\n");
+    append("  command = $cxx $local_includes $cxxflags $unit_cxxflags -c $in -o $out\n");
     append("  description = OBJ $out\n");
     if (dyndep)
         append("  restat = 1\n");
     append("\n");
 
     if (need_c_rule) {
         append("rule c_object\n");
-        append("  command = $cc $local_includes $cflags -c $in -o $out\n");
+        append("  command = $cc $local_includes $cflags $unit_cflags -c $in -o $out\n");
         append("  description = CC $out\n");
         if (dyndep)
             append("  restat = 1\n");
@@ -370,6 +379,7 @@ std::string emit_ninja_string(const BuildPlan& plan) {
         if (plan.scanDepsPath.empty()) {
             // GCC path: compiler-integrated P1689 scanning.
             append("  command = $cxx $local_includes $cxxflags -fmodules "
+                   "$unit_cxxflags "
                    "-fdeps-format=p1689r5 "
                    "-fdeps-file=$out -fdeps-target=$compile_target "
                    "-M -MM -MF $out.dep -E $in -o $compile_target\n");
@@ -379,10 +389,10 @@ std::string emit_ninja_string(const BuildPlan& plan) {
                 // Wrap in cmd /c for shell redirection (ninja on Windows uses
                 // CreateProcess which doesn't interpret > as redirect).
                 append("  command = cmd /c \"$scan_deps -format=p1689 -- "
-                       "$cxx $local_includes $cxxflags -c $in -o $compile_target > $out\"\n");
+                       "$cxx $local_includes $cxxflags $unit_cxxflags -c $in -o $compile_target > $out\"\n");
             } else {
                 append("  command = $scan_deps -format=p1689 -- "
-                       "$cxx $local_includes $cxxflags -c $in -o $compile_target > $out\n");
+                       "$cxx $local_includes $cxxflags $unit_cxxflags -c $in -o $compile_target > $out\n");
             }
         }
         append("  description = SCAN $out\n\n");
@@ -461,6 +471,8 @@ std::string emit_ninja_string(const BuildPlan& plan) {
             append(std::format("  compile_target = {}\n", escape_ninja_path(cu.object)));
             if (auto includes = local_include_flags(cu); !includes.empty())
                 append(std::format("  local_includes ={}\n", includes));
+            if (auto flags = join_flags(cu.packageCxxflags); !flags.empty())
+                append(std::format("  unit_cxxflags ={}\n", flags));
         }
         append("\n");
 
@@ -506,6 +518,13 @@ std::string emit_ninja_string(const BuildPlan& plan) {
             }
             if (auto includes = local_include_flags(cu); !includes.empty())
                 out_line += "  local_includes =" + includes + "\n";
+            if (is_c_source(cu.source)) {
+                if (auto flags = join_flags(cu.packageCflags); !flags.empty())
+                    out_line += "  unit_cflags =" + flags + "\n";
+            } else {
+                if (auto flags = join_flags(cu.packageCxxflags); !flags.empty())
+                    out_line += "  unit_cxxflags =" + flags + "\n";
+            }
             append(std::move(out_line));
         }
         append("\n");
@@ -546,6 +565,13 @@ std::string emit_ninja_string(const BuildPlan& plan) {
             out_line += "\n";
             if (auto includes = local_include_flags(cu); !includes.empty())
                 out_line += "  local_includes =" + includes + "\n";
+            if (is_c_source(cu.source)) {
+                if (auto flags = join_flags(cu.packageCflags); !flags.empty())
+                    out_line += "  unit_cflags =" + flags + "\n";
+            } else {
+                if (auto flags = join_flags(cu.packageCxxflags); !flags.empty())
+                    out_line += "  unit_cxxflags =" + flags + "\n";
+            }
             // Clang needs $bmi_out to emit -fmodule-output=$bmi_out
             if (cu.providesModule) {
                 out_line += "  bmi_out = " + bmi_path(*cu.providesModule) + "\n";

src/build/plan.cppm

@@ -18,6 +18,8 @@ struct CompileUnit {
     std::filesystem::path           source;
     std::filesystem::path           object;            // relative to plan.outputDir
     std::vector<std::filesystem::path> localIncludeDirs;
+    std::vector<std::string>        packageCflags;
+    std::vector<std::string>        packageCxxflags;
     std::optional<std::string>      providesModule;   // logical name, if .cppm export
     std::vector<std::string>        imports;           // logical names imported
 };
@@ -121,6 +123,8 @@ BuildPlan make_plan(const mcpp::manifest::Manifest&         manifest,
         CompileUnit cu;
         cu.source = u.path;
         cu.localIncludeDirs = u.localIncludeDirs;
+        cu.packageCflags = u.packageCflags;
+        cu.packageCxxflags = u.packageCxxflags;
         const auto fname = object_filename_for(u.path);
         if (basenameCount[fname] > 1) {
             // Use <sanitized-pkg>/<parent-dir-name> as prefix to handle