fix(ci): require self-contained helpers for llamacpp

Author: wellwei

.github/workflows/validate.yml

@@ -14,6 +14,10 @@ on:
   workflow_dispatch:
 
 env:
+  # 2026.7.28.2: mcpp#298 makes build.mcpp host helpers self-contained for
+  # musl and MinGW toolchains. This is required for ggml-org.llamacpp's
+  # Linux aarch64 source build, whose helper otherwise requires a missing
+  # musl dynamic loader on a glibc host.
   # 0.0.109: a bare dependency's wire address takes BOTH halves from the
   # descriptor the identity gate accepted (mcpp#286). This is the client-side
   # other half of the SPEC-001 migration below: mcpp used to take the NAME from
@@ -75,7 +79,7 @@ env:
   # 0.0.94 fixed feature-gated `sources` under `mcpp test` (mcpp#218); 0.0.91
   # added standard = "c++fly" to the resolver grammar, so c++fly descriptors
   # get the lint WARN below, not a hard grammar-parse rejection.
-  MCPP_VERSION: "0.0.109"
+  MCPP_VERSION: "2026.7.28.2"
 
 jobs:
   lint:
@@ -258,21 +262,21 @@ jobs:
             ext: tar.gz
             mcpp: bin/mcpp
             xlings: registry/bin/xlings
-            mcpp_version: "0.0.109"   # keep in sync with env.MCPP_VERSION
+            mcpp_version: "2026.7.28.2"   # keep in sync with env.MCPP_VERSION
           - platform: macos
             os: macos-15
             suffix: macosx-arm64
             ext: tar.gz
             mcpp: bin/mcpp
             xlings: registry/bin/xlings
-            mcpp_version: "0.0.109"   # keep in sync with env.MCPP_VERSION
+            mcpp_version: "2026.7.28.2"   # keep in sync with env.MCPP_VERSION
           - platform: windows
             os: windows-latest
             suffix: windows-x86_64
             ext: zip
             mcpp: bin/mcpp.exe
             xlings: registry/bin/xlings.exe
-            mcpp_version: "0.0.109"   # keep in sync with env.MCPP_VERSION
+            mcpp_version: "2026.7.28.2"   # keep in sync with env.MCPP_VERSION
     env:
       MCPP_EFFECTIVE: ${{ matrix.mcpp_version }}
     steps:
@@ -398,7 +402,7 @@ jobs:
       - name: Cold-start llama.cpp package
         shell: bash
         run: |
-          package_store="ggml-org-x-ggml-org.llamacpp"
+          package_store="ggml-org-x-llamacpp"
           rm -rf "$HOME/.mcpp/registry/data/xpkgs/$package_store"
           rm -rf ".mcpp/.xlings/data/xpkgs/$package_store"
           members="$MEMBERS"

index.toml

@@ -7,5 +7,5 @@
 # "floor first, new grammar after" rollout rule mechanically.
 [index]
 spec        = "1"
-min_mcpp    = "0.0.109"
-latest_mcpp = "0.0.109"
+min_mcpp    = "2026.7.28.2"
+latest_mcpp = "2026.7.28.2"

tests/test_llamacpp_package_contract.py

@@ -8,7 +8,9 @@
 
 ROOT = pathlib.Path(__file__).resolve().parents[1]
 DESCRIPTOR = ROOT / "pkgs/g/ggml-org.llamacpp.lua"
+INDEX = ROOT / "index.toml"
 WORKFLOW = ROOT / ".github/workflows/validate.yml"
+REQUIRED_MCPP = "2026.7.28.2"
 CONSUMERS = (
     ROOT / "tests/examples/llamacpp-internal-cpu/mcpp.toml",
     ROOT / "tests/examples/llamacpp-internal-metal/mcpp.toml",
@@ -115,9 +117,23 @@ def test_workflow_dependency_match_is_exact(self):
 
     def test_workflow_forces_cold_llamacpp_materialization(self):
         workflow = WORKFLOW.read_text()
-        self.assertIn("ggml-org-x-ggml-org.llamacpp", workflow)
+        self.assertIn('package_store="ggml-org-x-llamacpp"', workflow)
+        self.assertNotIn("ggml-org-x-ggml-org.llamacpp", workflow)
         self.assertIn("Cold-start llama.cpp package", workflow)
 
+    def test_linux_arm64_requires_the_self_contained_helper_release(self):
+        index = tomllib.loads(INDEX.read_text())["index"]
+        self.assertEqual(index["min_mcpp"], REQUIRED_MCPP)
+        self.assertEqual(index["latest_mcpp"], REQUIRED_MCPP)
+
+        workflow = WORKFLOW.read_text()
+        self.assertIn(f'MCPP_VERSION: "{REQUIRED_MCPP}"', workflow)
+        self.assertEqual(
+            workflow.count(f'mcpp_version: "{REQUIRED_MCPP}"'),
+            3,
+            "all active workspace matrix pins must match the index floor",
+        )
+
 
 if __name__ == "__main__":
     unittest.main()