feat: migrate to explicit namespace fields (mcpp 0.0.6) (#11)

All 10 package descriptors now carry an explicit `namespace` field
per the namespace design doc (mcpp .agents/docs/2026-05-11):

  mcpplibs       — modular C++23 libraries (cmdline, tinyhttps,
                   llmapi, xpkg, templates)
  mcpplibs.capi  — C API module wrappers (lua)
  compat         — non-modular C/C++ libraries (gtest, mbedtls,
                   lua upstream, ftxui)

File naming convention:
  compat packages  → compat.<name>.lua
  mcpplibs packages → <name>.lua
  mcpplibs.capi    → capi.<name>.lua

Directories reorganised by first letter of the file name.

README updated to document namespaces + new mcpp.toml dependency
syntax (`[dependencies.mcpplibs]`, `[dependencies.compat]`).

Author: Sunrisepeak

README.md

@@ -7,24 +7,43 @@
 ## 快速使用
 
 ```bash
-mcpp add ftxui@6.1.9       # 添加依赖到 mcpp.toml
-mcpp build                  # 自动拉取源码 + 构建
+mcpp add mcpplibs:cmdline@0.0.2    # 模块化库
+mcpp add compat:ftxui@6.1.9       # 非模块化兼容库
+mcpp build                         # 自动拉取源码 + 构建
 ```
 
+## 命名空间
+
+mcpp 0.0.6+ 使用显式 `namespace` 字段区分包的类别:
+
+| namespace | 含义 | 鼓励使用 |
+|---|---|---|
+| `mcpplibs` | 模块化 C++23 库(mcpplibs 生态) | ✅ 推荐 |
+| `mcpplibs.capi` | C API 的 C++23 模块封装 | ✅ 推荐 |
+| `compat` | 非模块化 C/C++ 库(兼容性支持) | ⚠️ 建议优先使用模块化替代 |
+
 ## 已收录的包
 
-### mcpplibs 模块化库
+### `mcpplibs` — 模块化库
+
+| 包名 | 版本 | 简介 | 仓库 |
+|------|------|------|------|
+| `cmdline` | 0.0.2 | 命令行解析框架 — `import mcpplibs.cmdline;` | [mcpplibs/cmdline](https://github.com/mcpplibs/cmdline) |
+| `tinyhttps` | 0.2.2 | 轻量 HTTP/HTTPS 客户端(SSE 流式) — `import mcpplibs.tinyhttps;` | [mcpplibs/tinyhttps](https://github.com/mcpplibs/tinyhttps) |
+| `llmapi` | 0.2.5 | 大语言模型 API 客户端(OpenAI/Anthropic 兼容) — `import mcpplibs.llmapi;` | [mcpplibs/llmapi](https://github.com/mcpplibs/llmapi) |
+| `xpkg` | 0.0.39 | xpkg V1 规范的 C++23 参考实现 — `import mcpplibs.xpkg;` | [openxlings/libxpkg](https://github.com/openxlings/libxpkg) |
+| `templates` | 0.0.1 | 最小化模块库模板 — `import mcpplibs.templates;` | [mcpplibs/templates](https://github.com/mcpplibs/templates) |
+
+### `mcpplibs.capi` — C API 封装
 
 | 包名 | 版本 | 简介 | 仓库 |
 |------|------|------|------|
-| `mcpplibs.cmdline` | 0.0.2 | 命令行解析框架 — `import mcpplibs.cmdline;` | [mcpplibs/cmdline](https://github.com/mcpplibs/cmdline) |
-| `mcpplibs.tinyhttps` | 0.2.2 | 轻量 HTTP/HTTPS 客户端(SSE 流式) — `import mcpplibs.tinyhttps;` | [mcpplibs/tinyhttps](https://github.com/mcpplibs/tinyhttps) |
-| `mcpplibs.llmapi` | 0.2.5 | 大语言模型 API 客户端(OpenAI/Anthropic 兼容) — `import mcpplibs.llmapi;` | [mcpplibs/llmapi](https://github.com/mcpplibs/llmapi) |
-| `mcpplibs.capi.lua` | 0.0.3 | Lua 5.4 C API 的 C++23 模块封装 — `import mcpplibs.capi.lua;` | [mcpplibs/lua](https://github.com/mcpplibs/lua) |
-| `mcpplibs.xpkg` | 0.0.39 | xpkg V1 规范的 C++23 参考实现 — `import mcpplibs.xpkg;` | [openxlings/libxpkg](https://github.com/openxlings/libxpkg) |
-| `mcpplibs.templates` | 0.0.1 | 最小化模块库模板 — `import mcpplibs.templates;` | [mcpplibs/templates](https://github.com/mcpplibs/templates) |
+| `lua` | 0.0.3 | Lua 5.4 C API 的 C++23 模块封装 — `import mcpplibs.capi.lua;` | [mcpplibs/lua](https://github.com/mcpplibs/lua) |
+
+### `compat` — 非模块化兼容库
 
-### 第三方 C/C++ 库
+> 这些库的上游没有 C++23 模块化支持,mcpp 通过 Form B 描述文件提供兼容性构建。
+> 建议优先使用对应的模块化封装(如 `mcpplibs.capi.lua` 替代 `compat.lua`)。
 
 | 包名 | 版本 | 简介 |
 |------|------|------|
@@ -36,13 +55,13 @@ mcpp build                  # 自动拉取源码 + 构建
 ### 依赖关系链
 
 ```
-mcpplibs.llmapi
-  └── mcpplibs.tinyhttps
-        └── mbedtls              ← mcpp 自动传递,无需手动声明
+mcpplibs:llmapi
+  └── mcpplibs:tinyhttps
+        └── compat:mbedtls       ← mcpp 自动传递,无需手动声明
 
-mcpplibs.xpkg
-  └── mcpplibs.capi.lua
-        └── lua                  ← 同上
+mcpplibs:xpkg
+  └── mcpplibs.capi:lua
+        └── compat:lua           ← 同上
 ```
 
 mcpp 0.0.3+ 的 transitive walker 自动沿链路传播头文件和依赖,消费者只需声明直接依赖。

pkgs/m/mcpplibs.capi.lua.lua pkgs/c/capi.lua.luapkgs/m/mcpplibs.capi.lua.lua renamed to pkgs/c/capi.lua.lua

@@ -3,7 +3,8 @@
 -- finds <verdir>/lua-<tag>/mcpp.toml inside the GitHub tarball wrap.
 package = {
     spec        = "1",
-    name        = "mcpplibs.capi.lua",
+    namespace = "mcpplibs.capi",
+    name      = "lua",
     description = "C++23 module wrapping the Lua 5.4 C API — `import mcpplibs.capi.lua;`",
     licenses    = {"Apache-2.0"},
     repo        = "https://github.com/mcpplibs/lua",

pkgs/m/mcpplibs.cmdline.lua pkgs/c/cmdline.luapkgs/m/mcpplibs.cmdline.lua renamed to pkgs/c/cmdline.lua

@@ -10,7 +10,8 @@
 -- `cmdline-<tag>/` wrap layer.
 package = {
     spec        = "1",
-    name        = "mcpplibs.cmdline",
+    namespace = "mcpplibs",
+    name      = "cmdline",
     description = "A simple command-line parsing library/framework for modern C++",
     licenses    = {"Apache-2.0"},
     repo        = "https://github.com/mcpplibs/cmdline",

pkgs/f/ftxui.lua pkgs/c/compat.ftxui.luapkgs/f/ftxui.lua renamed to pkgs/c/compat.ftxui.lua

@@ -10,7 +10,8 @@
 
 package = {
     spec        = "1",
-    name        = "ftxui",
+    namespace = "compat",
+    name      = "ftxui",
     description = "C++ Functional Terminal User Interface (screen + dom + component)",
     licenses    = {"MIT"},
     repo        = "https://github.com/ArthurSonzogni/FTXUI",

pkgs/g/gtest.lua pkgs/c/compat.gtest.luapkgs/g/gtest.lua renamed to pkgs/c/compat.gtest.lua

@@ -5,7 +5,8 @@
 
 package = {
     spec        = "1",
-    name        = "gtest",
+    namespace = "compat",
+    name      = "gtest",
     description = "Google's C++ test framework",
     licenses    = {"BSD-3-Clause"},
     repo        = "https://github.com/google/googletest",

pkgs/l/lua.lua pkgs/c/compat.lua.luapkgs/l/lua.lua renamed to pkgs/c/compat.lua.lua

@@ -11,7 +11,8 @@
 
 package = {
     spec        = "1",
-    name        = "lua",
+    namespace = "compat",
+    name      = "lua",
     description = "A powerful, efficient, lightweight, embeddable scripting language",
     licenses    = {"MIT"},
     repo        = "https://www.lua.org",

pkgs/m/mbedtls.lua pkgs/c/compat.mbedtls.luapkgs/m/mbedtls.lua renamed to pkgs/c/compat.mbedtls.lua

@@ -8,7 +8,8 @@
 
 package = {
     spec        = "1",
-    name        = "mbedtls",
+    namespace = "compat",
+    name      = "mbedtls",
     description = "An open source, portable, easy to use, readable and flexible TLS library, and reference implementation of the PSA Cryptography API",
     licenses    = {"Apache-2.0"},
     repo        = "https://github.com/Mbed-TLS/mbedtls",

pkgs/m/mcpplibs.llmapi.lua pkgs/l/llmapi.luapkgs/m/mcpplibs.llmapi.lua renamed to pkgs/l/llmapi.lua

@@ -3,7 +3,8 @@
 -- wrap (`llmapi-<tag>/mcpp.toml`) automatically.
 package = {
     spec        = "1",
-    name        = "mcpplibs.llmapi",
+    namespace = "mcpplibs",
+    name      = "llmapi",
     description = "Modern C++ LLM API client with openai-compatible support",
     licenses    = {"Apache-2.0"},
     repo        = "https://github.com/mcpplibs/llmapi",

pkgs/m/mcpplibs.templates.lua pkgs/t/templates.luapkgs/m/mcpplibs.templates.lua renamed to pkgs/t/templates.lua

@@ -5,7 +5,8 @@
 -- default lookup is ambiguous or wrong for your tarball.
 package = {
     spec        = "1",
-    name        = "mcpplibs.templates",
+    namespace = "mcpplibs",
+    name      = "templates",
     description = "Minimal C++23 modular hello library",
     licenses    = {"Apache-2.0"},
     repo        = "https://github.com/mcpp-community/templates",

pkgs/m/mcpplibs.tinyhttps.lua pkgs/t/tinyhttps.luapkgs/m/mcpplibs.tinyhttps.lua renamed to pkgs/t/tinyhttps.lua

@@ -3,7 +3,8 @@
 -- finds <verdir>/<repo-tag>/mcpp.toml inside the GitHub tarball wrap.
 package = {
     spec        = "1",
-    name        = "mcpplibs.tinyhttps",
+    namespace = "mcpplibs",
+    name      = "tinyhttps",
     description = "Minimal C++23 HTTP/HTTPS client with SSE streaming support",
     licenses    = {"Apache-2.0"},
     repo        = "https://github.com/mcpplibs/tinyhttps",