feat: implement coroutine RunLoop and Scheduler

Add caller-thread FIFO scheduling, cross-thread wakeups, root result and exception handling, boundary tests, examples, documentation, and current mcpp configuration.

Author: helantianshen

.agents/skills/mcpp-index/SKILL.md

@@ -29,26 +29,25 @@ mcpp index list|add|remove|update   # manage registries
 Package identity is a pair: **`namespace` is a dotted hierarchical path, `name` is a single
 atomic segment** (`compat` + `zlib`, `mcpplibs.capi` + `lua` — never `mcpplibs` + `capi.lua`).
 
-A **bare** dependency name resolves in exactly three places, in order:
-
-1. `mcpplibs` — the default namespace
-2. `compat` — third-party C/C++ wrappers
-3. packages that declare no namespace at all
-
-Anything else must be spelled out — there is no index-wide fuzzy search by short name:
+A **bare** dependency name means the `mcpplibs` default namespace. The older fallback search
+through `compat` and packages without a namespace is deprecated in mcpp 2026.8 and removed in
+2026.9. Every other namespace must be spelled out; there is no index-wide fuzzy search by short
+name:
 
 ```toml
 [dependencies]
 "chriskohlhoff.asio" = "1.38.1"     # dotted selector
 
 [dependencies.chriskohlhoff]        # or a namespace sub-table
 asio = "1.38.1"
+
+[dependencies.compat]               # third-party wrapper
+zlib = "1.3.1"
 ```
 
-When resolution fails: read the error (it lists the namespaces searched), then check the
-spelling against the online index, and run `xlings update` — a release tarball bundles an
-index snapshot frozen at build time, which is the usual reason a fresh version "does not
-exist".
+When resolution fails: read the error, check the exact namespace and spelling against the online
+index, and run `xlings update` — a release tarball bundles an index snapshot frozen at build time,
+which is the usual reason a fresh version "does not exist".
 
 Mirrors: `mcpp self config --mirror CN` switches to the GitCode mirror; `GLOBAL` (upstream) is
 the default.

.agents/skills/mcpp-style-ref/SKILL.md

@@ -149,8 +149,10 @@ mcpp --version
 
 - `.xlings.json`：声明项目工具环境
 - `mcpp.toml`：声明 `[package]` 与测试依赖；简单库目标可由 mcpp 从 `src/*.cppm` 自动推断
-- `src/cmp.cppm`：库主模块接口，声明 `export module mcpplibs.cmp;`
-- `tests/cmp_test.cpp`：`mcpp test` 自动发现的 gtest 导入测试；不要定义 `main()`
+- `src/cmp.cppm`：库主模块接口，导出 `:task` 与 `:run_loop` 分区
+- `src/task.cppm`：`Task<T>` 与 `Task<void>` 分区
+- `src/run_loop.cppm`：`RunLoop` 与 `Scheduler` 分区
+- `tests/cmp_test.cpp`、`tests/run_loop_test.cpp`：`mcpp test` 自动发现的 gtest 测试；不要定义 `main()`
 - `examples/basic/`：独立 mcpp consumer 包，通过 path 依赖引用根库
 
 构建：

.agents/skills/mcpp/SKILL.md

@@ -9,7 +9,7 @@ The build and package tool this repository is built with. mcpp is module-first C
 `import std` works out of the box, toolchains install into an isolated sandbox, and
 dependencies resolve through a package index.
 
-Verified against **mcpp 2026.8.1.1**. mcpp is pre-1.0 and moves fast — when this skill and
+Verified against **mcpp 2026.8.11.2**. mcpp is pre-1.0 and moves fast — when this skill and
 the tool disagree, the tool wins. Check with `mcpp --help`, `mcpp <cmd> --help`, and the
 [upstream docs](https://github.com/mcpp-community/mcpp/tree/main/docs).
 
@@ -81,12 +81,12 @@ defines       = ["FOO=1"]     # bare names; reach every TU including module scan
 default-profile = "release"   # project default when no --profile/--release is passed
 
 [dependencies]                # runtime deps
-cmdline = "0.0.2"             # bare name: searched in mcpplibs, then compat, then no-namespace
+cmdline = "0.0.2"             # bare name: mcpplibs namespace
 
 [dependencies.mcpplibs]       # namespace sub-table (preferred for several from one org)
 tinyhttps = "0.2.3"
 
-[dev-dependencies]            # test-only; `mcpp build` ignores these
+[dev-dependencies.compat]     # test-only; `mcpp build` ignores these
 gtest = "1.15.2"
 
 [toolchain]
@@ -103,10 +103,10 @@ Dependency forms: `"1.2.3"` · `"^1.2"` · `"~1.2"` · `">=1.0, <2.0"` ·
 `{ path = "../mylib" }` · `{ git = "...", tag = "v1.0.0" }` ·
 `{ version = "0.0.3", features = ["docking"] }`.
 
-**Namespace rule:** a bare name resolves in exactly three places, in order — `mcpplibs`,
-`compat` (third-party C/C++ wrappers), then packages that declare no namespace. Any other
-namespace must be written out: `"chriskohlhoff.asio" = "1.38.1"` or a
-`[dependencies.chriskohlhoff]` sub-table.
+**Namespace rule:** a bare name means `mcpplibs`. Compatibility fallback to `compat` is deprecated
+in 2026.8 and removed in 2026.9, so third-party wrappers and every other namespace must be explicit:
+`[dependencies.compat]`, `"chriskohlhoff.asio" = "1.38.1"`, or the corresponding namespace
+sub-table.
 
 ## Modules
 

.agents/skills/more-details/SKILL.md

@@ -31,8 +31,11 @@ docs, and actual command output.
 - `docs/architecture.md` (`.zh.md`, `.zh.hant.md`) — current structure, mcpp conventions, runtime boundaries, CI.
 - `.xlings.json` — the project tool environment (which mcpp version builds this).
 - `mcpp.toml` — package metadata, dependencies, dev-dependencies.
-- `src/cmp.cppm` — the import-only CMP root module interface.
-- `tests/cmp_test.cpp` — the gtest import smoke test.
+- `src/cmp.cppm` — the CMP root module interface, re-exporting its public partitions.
+- `src/task.cppm` — lazy single-consumer Task implementation.
+- `src/run_loop.cppm` — caller-thread RunLoop, Scheduler, and root driver.
+- `tests/cmp_test.cpp` — Task contract and lifetime tests.
+- `tests/run_loop_test.cpp` — scheduling, threading, and invalid-use boundary tests.
 - `examples/basic/` — a standalone path-dependency consumer.
 - `.github/workflows/ci-{linux,macos,windows}.yml` — per-platform build, test, and example CI.
 
@@ -87,6 +90,6 @@ mcpp --version
 - **Confirm an `mcpp.toml` field** → `mcpp.toml`, the [`mcpp`](../mcpp/SKILL.md) skill, then upstream `docs/05-mcpp-toml.md`.
 - **Add a dependency** → the [`mcpp-index`](../mcpp-index/SKILL.md) skill, then `mcpplibs/cmdline` for a real example.
 - **Add a module API** → `mcpp-style-ref`, then edit `src/*.cppm`.
-- **Add a test** → follow `tests/cmp_test.cpp`, verify with `mcpp test`.
+- **Add a test** → follow the focused file under `tests/`, verify with `mcpp test`.
 - **Add an example** → follow `examples/basic/` — its own `mcpp.toml` with a path dependency.
 - **Publish the library** → the [`mcpp-index`](../mcpp-index/SKILL.md) skill.

.gitignore

@@ -10,6 +10,7 @@ compile_commands.json
 # Local tools and editor state
 .cache/
 /.clice/
+/.idea/
 /.rpiv/
 /.vscode/