Skip to content

Commit df145c0

Browse files
committed
docs(asio): keep contribution scope focused
1 parent 4dcdefb commit df145c0

2 files changed

Lines changed: 6 additions & 7 deletions

File tree

.agents/docs/2026-07-17-add-asio-plan.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -114,14 +114,13 @@ The tests do not include or exercise the separate native module adapter.
114114
The active workflow pins mcpp 0.0.94. Before opening the replacement PR, the
115115
branch must provide fresh evidence for all locally available checks:
116116

117-
1. run the descriptor syntax and mirror lint with Lua 5.4;
117+
1. run the descriptor syntax and mirror lint with the available local Lua 5.5;
118118
2. parse `pkgs/c/compat.asio.lua` with mcpp 0.0.94;
119119
3. run the targeted Asio consumer tests from isolated build state with
120120
`MCPP_INDEX_MIRROR=GLOBAL`;
121121
4. inspect the generated compile commands for all three public defines;
122122
5. exercise `mcpp add compat:asio@1.38.1` in an isolated consumer project;
123-
6. run `mcpp test --workspace` on the local host;
124-
7. run `git diff --check` and confirm README is identical to `origin/main`.
123+
6. run `git diff --check` and confirm README is identical to `origin/main`.
125124

126125
The replacement PR must then pass every check instantiated by the live
127126
workflow, including the Linux, macOS, and Windows workspace matrix. Local macOS
@@ -144,10 +143,10 @@ The replacement PR is limited to:
144143
## 8. Acceptance criteria
145144

146145
- upstream version, license, layout, and repeated archive digest are recorded;
147-
- descriptor grammar and exact Lua 5.4 lint pass;
146+
- local descriptor lint passes with Lua 5.5, and the workflow's Lua 5.4 lint
147+
passes in GitHub Actions;
148148
- the CLI dependency token is verified through an isolated `mcpp add`;
149149
- the six targeted consumer tests pass from isolated build state;
150-
- the local workspace test passes;
151150
- README has no diff;
152151
- the replacement PR contains no native module adaptation;
153152
- all required GitHub Actions jobs pass before maintainer merge;

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,15 +26,15 @@ mcpp self config --mirror CN # 切换至国内镜像,默认使用 GLOBAL 上
2626
用户基于 mcpp 开发并登记进索引的库(如 `tensorvia-cpu`)。其上游通常自带 `mcpp.toml`,描述文件(Form A)只声明
2727
元数据与下载地址。
2828
- **第三方 C/C++ 库(`compat`)**:其上游不提供 mcpp 支持,描述文件(Form B)内联构建信息。该类库存在
29-
header-only、纯 C 源码、C++23 module wrapper 等形态,可选组件经 `features` 门控;具备镜像资产的包同时提供 GitCode CN 镜像。
29+
header-only、纯 C 源码、C++23 module wrapper 等形态,可选组件经 `features` 门控,并配备 GitCode CN 镜像。
3030

3131
### 参考示例(`.lua` 描述符)
3232

3333
| 形态 | 示例 |
3434
|------|------|
3535
| 原生模块库(Form A) | [`mcpplibs.xpkg`](pkgs/x/xpkg.lua) · [`mcpplibs.tinyhttps`](pkgs/t/tinyhttps.lua) · [`tensorvia-cpu`](pkgs/t/tensorvia-cpu.lua) |
3636
| C 源码 compat(含 `features`) | [`compat.cjson`](pkgs/c/compat.cjson.lua) · [`compat.zlib`](pkgs/c/compat.zlib.lua) |
37-
| header-only(含 public 配置/系统链接) | [`compat.eigen`](pkgs/c/compat.eigen.lua) · [`compat.asio`](pkgs/c/compat.asio.lua) |
37+
| header-only(含 `features`) | [`compat.eigen`](pkgs/c/compat.eigen.lua) |
3838
| 外部构建系统(`install()` 从源码构建) | [`compat.openblas`](pkgs/c/compat.openblas.lua)(Make) · [`compat.opencv`](pkgs/c/compat.opencv.lua)(CMake) |
3939
| C++23 module wrapper | [`nlohmann.json`](pkgs/n/nlohmann.json.lua) · [`marzer.tomlplusplus`](pkgs/m/marzer.tomlplusplus.lua) |
4040

0 commit comments

Comments
 (0)