Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
30 commits
Select commit Hold shift + click to select a range
69a544d
Design record: the rules behind mcpp#931 and #952 to #960, their five…
Sunrisepeak Nov 19, 2026
0ca2a18
A descriptor's mcpp field has two forms, read by one function; publis…
Sunrisepeak Nov 19, 2026
42d99cc
The version group's constraint enters the merge; a package's tables a…
Sunrisepeak Nov 19, 2026
cfc595c
Whether an artifact runs here is one predicate with no branch before …
Sunrisepeak Nov 19, 2026
70a386b
tests: the published member's descriptor points at its manifest, whic…
Sunrisepeak Nov 19, 2026
21febba
A link's inputs are the files its words name and the files its linker…
Sunrisepeak Nov 19, 2026
087f457
A row a member inherits from its workspace is the root's statement, a…
Sunrisepeak Nov 19, 2026
c650a37
An action reads a link unit's objects from the engine, and a plugin's…
Sunrisepeak Nov 19, 2026
e0c4637
A package instance has a directory of its own, and a build keeps ever…
Sunrisepeak Nov 19, 2026
4e96031
A build interrupted in another process space continues, and a start r…
Sunrisepeak Nov 19, 2026
7313dee
A compile writes only its own attempt, and the executor publishes wha…
Sunrisepeak Nov 19, 2026
174e064
A project that names its own link dependency file keeps it, and the b…
Sunrisepeak Nov 19, 2026
039d350
A published output survives a transient hold on Windows, and a query …
Sunrisepeak Nov 19, 2026
8143468
The default platform is openkal-platform 0.31.0, and the tests run un…
Sunrisepeak Nov 19, 2026
6cffb87
cl.exe's record names what a compile read, and the text of every prog…
Sunrisepeak Nov 19, 2026
d31db6b
mcpp 2026.11.19.1
Sunrisepeak Nov 19, 2026
737441d
The pack launchers build on the mcpplibs.os release mcpp builds on
Sunrisepeak Nov 19, 2026
57c02a1
The launchers build on the os the platform's build program links; cl.…
Sunrisepeak Nov 19, 2026
400ec91
The Windows bare-metal llvm rows build; 663 reads the std record its …
Sunrisepeak Nov 19, 2026
cd4ce3c
A path or git dependency's build is cached under the name of its sour…
Sunrisepeak Nov 19, 2026
42b7f09
A base's C++ layer and the graph's layers reach a clang driver with n…
Sunrisepeak Nov 19, 2026
fe72481
A row the platform column misses is an index miss, refreshed as a dep…
Sunrisepeak Nov 19, 2026
3525899
Each build program resolves its own build dependencies; a platform se…
Sunrisepeak Nov 19, 2026
7583fc7
A workspace member is the project's own tree whichever members a comm…
Sunrisepeak Nov 19, 2026
7db5904
A cache fill completes under the goals a command names
Sunrisepeak Nov 19, 2026
0f5a9ee
SPEC-001 states every workspace member as the project's own tree; the…
Sunrisepeak Nov 19, 2026
7b3f707
Build programs resolve after the target and keep the versions they ho…
Sunrisepeak Nov 19, 2026
e9dc218
CHANGELOG: the per-program resolution entry reflowed; no blank line i…
Sunrisepeak Nov 19, 2026
515de9d
CHANGELOG: mcpp builds against mcpplibs.os 0.4.6, which keeps the ope…
Sunrisepeak Nov 19, 2026
3aa38fd
ci-fresh-install: the arch leg upgrades the image fully (pacman -Syu)
Sunrisepeak Nov 19, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
246 changes: 246 additions & 0 deletions .agents/docs/2026-11-19-ecosystem-rule-convergence-design-repro.sh

Large diffs are not rendered by default.

1,209 changes: 1,209 additions & 0 deletions .agents/docs/2026-11-19-ecosystem-rule-convergence-design.md

Large diffs are not rendered by default.

4 changes: 3 additions & 1 deletion .agents/docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ superseded_by: 2026-09-07-....md # when status is superseded
---
```

365 records.
366 records.

## By subject

Expand Down Expand Up @@ -90,6 +90,7 @@ Records that declare one. Everything else is listed by date below.

### ecosystem

- [生态规则收敛方案:2026.11.18.1 之后十个 issue 的五类成因、七项决定与实施范围](2026-11-19-ecosystem-rule-convergence-design.md) — landed
- [生态架构优化方案:四个平面的收敛、已合入项的纠正与新系统的准入(mcpp × openkal × xlings)](2026-11-12-ecosystem-architecture-optimization-design.md) — active
- [测试与依赖解析补充方案:mcpp、mcpp test、mtest、mcpp-ide](2026-11-10-test-and-resolution-supplement-design.md) — active
- [生态顶层方案:#885 收尾之后的工作流、原则与依赖](2026-11-08-ecosystem-top-level-design.md) — active
Expand Down Expand Up @@ -204,6 +205,7 @@ Records that declare one. Everything else is listed by date below.

### 2026-11

- [生态规则收敛方案:2026.11.18.1 之后十个 issue 的五类成因、七项决定与实施范围](2026-11-19-ecosystem-rule-convergence-design.md) — landed
- [第二部分之后的补充方案:带修正的 ninja、模块重编译的级联、工作区发布与本轮遗留项](2026-11-17-ninja-cascade-publish-supplement-design.md) — active
- [生态缺口补充方案(第二部分):文件的角色、运行文件、清单书写与第一部分的遗留项](2026-11-16-ecosystem-gap-supplement-part2-design.md) — active
- [生态缺口补充方案:一个 C 程序走遍全部目标所暴露的通用问题](2026-11-15-ecosystem-gap-supplement-design.md) — active
Expand Down
9 changes: 7 additions & 2 deletions .github/tools/check_system_names.py
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,11 @@
`modules/*/src/`, without `modules/platform/` and without tests and data --
in the two forms a branch on a system takes: the word as a string literal
(`"freebsd"`), and the host predicates of mcpplibs.os (`is_linux`,
`is_windows`, `is_macos`). Comments are not counted.
`is_windows`, `is_macos`) and the system predicates of a triple (`is_apple`,
`is_ios`, `is_android` and their like). Comments are not counted. The triple's
predicates were not in the vocabulary until a branch on `is_apple()` was found
standing before the one predicate that decides whether an artifact runs here
(mcpp#957).

THE RATCHET

Expand All @@ -39,7 +43,8 @@

LITERALS = ["linux", "macos", "windows", "freebsd", "android", "emscripten", "ios",
"darwin", "netbsd", "openbsd", "haiku", "dos", "uefi"]
PREDICATES = ["is_linux", "is_windows", "is_macos"]
PREDICATES = ["is_linux", "is_windows", "is_macos",
"is_apple", "is_ios", "is_ios_simulator", "is_android", "is_openkal", "is_windows_gnu"]

SOURCE_SUFFIXES = {".cppm", ".cpp", ".mcpp"}

Expand Down
22 changes: 20 additions & 2 deletions .github/tools/check_version_pins.sh
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
#
# Version / pin drift guard.
#
# Two invariants that used to live only in a comment:
# Three invariants that used to live only in a comment:
#
# 1. Every xlings version pinned anywhere in .github/ equals
# `pinned::kXlingsVersion` in src/provider/xlings/xlings.cppm — which is the version
Expand All @@ -11,6 +11,8 @@
#
# 2. mcpp's own version is identical in all four places that carry it.
#
# 3. The launchers a pack builds use mcpp's own mcpplibs.os release.
#
# Why this exists: src/provider/xlings/xlings.cppm used to say "keep in lock-step with the
# XLINGS_VERSION pins in release.yml / cross-build-test.yml / ci-linux-e2e.yml"
# and that list was ALREADY incomplete — it omitted both composite actions,
Expand Down Expand Up @@ -173,7 +175,23 @@ if [ -n "$v_xl" ] && [ -n "$v_toml" ] && [ "$v_xl" != "$v_toml" ]; then
|| bad "bootstrap pin '$v_xl' is NEWER than the version being built ('$v_toml') — CI would try to install an unreleased mcpp"
fi

# ── 3. The launchers' OS library is mcpp's own ────────────────────────────
#
# A pack's launchers build on one release of mcpplibs.os (src/pack/
# distribution.cppm, kLauncherOs), and mcpp builds on one (mcpp.toml). The
# platform's plugin resolves its build dependencies apart from a launcher
# (design 2026-11-19 §21 A6), so nothing outside mcpp chooses the launchers'
# release, and two releases of one library in one repository is drift.
os_toml=$(awk -F '"' '/^mcpplibs\.os[[:space:]]*=/{print $2; exit}' mcpp.toml)
os_launcher=$(grep -oE 'kLauncherOs[[:space:]]*=[[:space:]]*"[^"]+"' src/pack/distribution.cppm \
| grep -oE '"[^"]+"' | tr -d '"' | head -1)
if [ -z "$os_toml" ] || [ -z "$os_launcher" ]; then
bad "could not read mcpplibs.os from mcpp.toml ('$os_toml') or kLauncherOs from src/pack/distribution.cppm ('$os_launcher')"
elif [ "$os_toml" != "$os_launcher" ]; then
bad "src/pack/distribution.cppm builds the launchers on mcpplibs.os '$os_launcher', mcpp.toml builds mcpp on '$os_toml'"
fi

if [ "$fail" = 0 ]; then
echo "OK: xlings pins all at $XLINGS_EXPECTED; building mcpp $v_toml, bootstrapping from $v_xl" >&2
echo "OK: xlings pins all at $XLINGS_EXPECTED; building mcpp $v_toml, bootstrapping from $v_xl; launchers on mcpplibs.os $os_launcher" >&2
fi
exit "$fail"
8 changes: 7 additions & 1 deletion .github/tools/system-names.baseline
Original file line number Diff line number Diff line change
Expand Up @@ -15,4 +15,10 @@ dos 0
uefi 0
is_linux 26
is_windows 126
is_macos 32
is_macos 31
is_apple 5
is_ios 7
is_ios_simulator 6
is_android 9
is_openkal 3
is_windows_gnu 2
10 changes: 6 additions & 4 deletions .github/tools/upgrade_lane.sh
Original file line number Diff line number Diff line change
Expand Up @@ -256,13 +256,15 @@ fi
if [ "$VARIANT" = modules ]; then
# A BMI of another spelling is not read: the dependency is rebuilt once (its
# cache key carries the spelling), then served from the cache. The spelling
# moved in 2026.10.26.2 (the module map's `$root`); a previous release from
# then on spells as this one, and its entry is served at once.
# moved in 2026.10.26.2 (the module map's `$root`) and in 2026.11.19.1 (a
# package instance's directory, mcpp#953); a previous release from the last
# move on spells as this one, and its entry is served at once.
spelled_since=2026.11.19.1
old_version=$("$OLD" --version | grep -Eo '[0-9]{4}\.[0-9]+\.[0-9]+\.[0-9]+' | head -1)
same_spelling=$(printf '%s\n2026.10.26.2\n' "$old_version" | sort -t. -k1,1n -k2,2n -k3,3n -k4,4n | head -1)
same_spelling=$(printf '%s\n%s\n' "$old_version" "$spelled_since" | sort -t. -k1,1n -k2,2n -k3,3n -k4,4n | head -1)
modules_project m-new1
run new-modules1 "$W/m-new1" "$NEW" build -v || fail "the module project does not build over the previous release's cache"
if [ "$same_spelling" = 2026.10.26.2 ]; then
if [ "$same_spelling" = "$spelled_since" ]; then
grep -q "STAGE gcm.cache/mcpplibs.openkal/" "$W/new-modules1.log" \
|| fail "a dependency BMI of the same spelling ($old_version) was not served from the cache"
else
Expand Down
4 changes: 2 additions & 2 deletions .github/versions.env
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# The engines CI pins, read by the composite actions (.github/actions/mtest).
# mtest: an xlings package (xim:mtest) whose sha256 the index states; the release
# bundle's sha256 checks the fallback download.
MTEST_VERSION=0.8.0
MTEST_SHA256=06555eb8dbdebdf978dc2f074a3efe8521bf71bb51844976216ec21d7fb4be94
MTEST_VERSION=0.10.0
MTEST_SHA256=c7187e6211ea15cff23f622c449247508f6f661f0d3b45dcd031f91104b8f499
6 changes: 5 additions & 1 deletion .github/workflows/ci-fresh-install.yml
Original file line number Diff line number Diff line change
Expand Up @@ -282,9 +282,13 @@ jobs:
- distro: fedora-latest
image: fedora:latest
setup: dnf -y install curl bash tar gzip xz git findutils binutils file glibc-langpack-en
# A full upgrade, as Arch supports: a partial one (`-Sy`) installed
# OpenSSL 4 beside packages built against libcrypto.so.3 and was
# refused (`breaks dependency 'libcrypto.so=3-64'`, every run since
# 2026-11-07, mcpp#953).
- distro: arch
image: archlinux:latest
setup: pacman -Sy --noconfirm curl bash tar gzip xz git findutils binutils file
setup: pacman -Syu --noconfirm curl bash tar gzip xz git findutils binutils file
- distro: tumbleweed
image: opensuse/tumbleweed:latest
setup: zypper -n install curl bash tar gzip xz git findutils binutils file
Expand Down
Loading
Loading