Stabilize incremental rebuild caching

Fix BMI cache staging, stabilize toolchain fingerprints, keep e2e toolchain tests within CI budget, and bump version to 0.0.15.

Author: Sunrisepeak

.agents/docs/2026-05-15-fingerprint-stability-and-fastpath-coherence.md

@@ -1,6 +1,6 @@
 [package]
 name        = "mcpp"
-version     = "0.0.14"
+version     = "0.0.15"
 description = "Modern C++ build & package management tool"
 license     = "Apache-2.0"
 authors     = ["mcpp-community"]

mcpp.toml

@@ -55,8 +55,9 @@ bool is_cached(const CacheKey& key);
 std::expected<DepArtifacts, std::string>
 read_manifest(const CacheKey& key);
 
-// Copy cached files into projectTarget/{gcm.cache,obj}, bumping mtime so
-// ninja sees them as up-to-date relative to the (untouched) source files.
+// Copy missing cached files into projectTarget/{gcm.cache,obj}. Existing
+// project outputs are left untouched: GCC BMIs may differ byte-for-byte between
+// equivalent builds, and overwriting them would dirty downstream modules.
 std::expected<DepArtifacts, std::string>
 stage_into(const CacheKey& key,
            const std::filesystem::path& projectTargetDir);
@@ -150,6 +151,11 @@ stage_into(const CacheKey& key,
     for (auto& g : arts->gcmFiles) {
         auto from = key.gcmDir() / g;
         auto to   = projectGcm   / g;
+        if (std::filesystem::exists(to, ec)) {
+            ec.clear();
+            continue;
+        }
+        ec.clear();
         if (!copy_one(from, to, ec)) {
             return std::unexpected(std::format(
                 "stage gcm '{}': {}", g, ec.message()));
@@ -159,6 +165,11 @@ stage_into(const CacheKey& key,
     for (auto& o : arts->objFiles) {
         auto from = key.objDir() / o;
         auto to   = projectObj   / o;
+        if (std::filesystem::exists(to, ec)) {
+            ec.clear();
+            continue;
+        }
+        ec.clear();
         if (!copy_one(from, to, ec)) {
             return std::unexpected(std::format(
                 "stage obj '{}': {}", o, ec.message()));

src/bmi_cache.cppm

@@ -47,6 +47,7 @@ detect(const std::filesystem::path& explicit_compiler) {
     if (!ver_r) return std::unexpected(ver_r.error());
 
     const auto& vstr = *ver_r;
+    tc.driverIdent = normalize_driver_output(vstr);
     auto head = first_line_of(vstr);
     auto headLower = lower_copy(head);
     auto fullLower = lower_copy(vstr);

src/toolchain/detect.cppm

@@ -2,7 +2,7 @@
 //
 // Per docs/06-toolchain-and-fingerprint.md, the fingerprint MUST cover:
 //   1.  compiler id           2.  compiler version
-//   3.  compiler binary hash  4.  target triple
+//   3.  compiler driver identity  4.  target triple
 //   5.  stdlib id+version     6.  C++ standard
 //   7.  compile flags hash    8.  mcpp version
 //   9.  dependency lock hash  10. std module BMI hash
@@ -18,7 +18,7 @@ import mcpp.toolchain.detect;
 
 export namespace mcpp::toolchain {
 
-inline constexpr std::string_view MCPP_VERSION = "0.0.14";
+inline constexpr std::string_view MCPP_VERSION = "0.0.15";
 
 struct FingerprintInputs {
     Toolchain                       toolchain;
@@ -93,7 +93,9 @@ Fingerprint compute_fingerprint(const FingerprintInputs& in) {
 
     fp.parts[0] = std::string(tc.compiler_name());
     fp.parts[1] = tc.version;
-    fp.parts[2] = tc.binaryPath.empty() ? "" : hash_file(tc.binaryPath);
+    fp.parts[2] = !tc.driverIdent.empty()
+        ? hash_string(tc.driverIdent)
+        : (tc.binaryPath.empty() ? "" : hash_file(tc.binaryPath));
     fp.parts[3] = tc.targetTriple;
     fp.parts[4] = std::format("{} {}", tc.stdlibId, tc.stdlibVersion);
     fp.parts[5] = in.cppStandard;

src/toolchain/fingerprint.cppm

@@ -12,6 +12,7 @@ struct Toolchain {
     CompilerId                          compiler        = CompilerId::Unknown;
     std::string                         version;            // "15.1.0"
     std::filesystem::path               binaryPath;
+    std::string                         driverIdent;        // normalized --version output
     std::string                         targetTriple;       // "x86_64-linux-gnu"
     std::string                         stdlibId;           // "libstdc++"
     std::string                         stdlibVersion;

src/toolchain/model.cppm

@@ -18,6 +18,7 @@ std::string extract_version(std::string_view s);
 std::string first_line_of(std::string_view s);
 std::string lower_copy(std::string_view s);
 std::string trim_line(std::string s);
+std::string normalize_driver_output(std::string_view s);
 
 std::vector<std::filesystem::path>
 discover_compiler_runtime_dirs(const std::filesystem::path& compilerBin);
@@ -128,6 +129,42 @@ std::string trim_line(std::string s) {
     return s;
 }
 
+std::string normalize_driver_output(std::string_view s) {
+    auto replace_local_paths = [](std::string line) {
+        static constexpr std::array<std::string_view, 3> prefixes{
+            "/home/", "/tmp/", "/var/"
+        };
+        for (auto prefix : prefixes) {
+            std::size_t pos = 0;
+            while ((pos = line.find(prefix, pos)) != std::string::npos) {
+                auto end = pos;
+                while (end < line.size()) {
+                    unsigned char c = static_cast<unsigned char>(line[end]);
+                    if (std::isspace(c) || line[end] == '\'' || line[end] == '"')
+                        break;
+                    ++end;
+                }
+                line.replace(pos, end - pos, "<PATH>");
+                pos += std::string_view("<PATH>").size();
+            }
+        }
+        return line;
+    };
+
+    std::string out;
+    std::istringstream is(std::string{s});
+    std::string line;
+    while (std::getline(is, line)) {
+        line = trim_line(std::move(line));
+        if (line.empty()) continue;
+        if (line.starts_with("PWD=")) continue;
+        line = replace_local_paths(std::move(line));
+        if (!out.empty()) out.push_back('\n');
+        out += line;
+    }
+    return out;
+}
+
 std::vector<std::filesystem::path>
 discover_compiler_runtime_dirs(const std::filesystem::path& compilerBin) {
     std::vector<std::filesystem::path> dirs;

src/toolchain/probe.cppm

@@ -9,6 +9,7 @@ TMP=$(mktemp -d)
 trap "rm -rf $TMP" EXIT
 
 export MCPP_HOME="$TMP/mcpp-home"
+source "$(dirname "$0")/_inherit_toolchain.sh"
 
 # ── 1. Sibling lib package (acme:util). Pure-modular C++23. ─────────────
 mkdir -p "$TMP/util-pkg"

tests/e2e/27_namespace_dependencies.sh

@@ -1,31 +1,39 @@
 #!/usr/bin/env bash
-# 29_toolchain_partial_versions.sh — `mcpp toolchain {install,default}` accept
-# partial versions and either positional or @-separated form, AND auto-install
-# the default toolchain on a first-run `mcpp build` with no toolchain configured.
+# 29_toolchain_partial_versions.sh — `mcpp toolchain default` accepts partial
+# versions in either positional or @-separated form, AND `mcpp build`
+# auto-installs the default toolchain on a first run with no toolchain
+# configured. The full install path is covered by 26_toolchain_management.sh.
 #
-# We isolate via MCPP_HOME so we don't touch the user's real ~/.mcpp sandbox.
+# We isolate config/default state via MCPP_HOME, while reusing already prepared
+# xlings payloads when available so CI does not redownload full toolchains.
 set -e
 
 TMP=$(mktemp -d)
 trap "rm -rf $TMP" EXIT
 
-# ─── Section 1: dual-form + partial-version toolchain commands ─────────
-export MCPP_HOME="$TMP/h1"
+inherit_payloads_only() {
+    MCPP_INHERIT_CONFIG=0 MCPP_INHERIT_SUBOS=0 source "$(dirname "$0")/_inherit_toolchain.sh"
+}
 
-# Pre-install both 15 and 16 with different invocation forms.
-"$MCPP" toolchain install gcc 15    > "$TMP/inst1.log" 2>&1 || {
-    cat "$TMP/inst1.log"; echo "install 'gcc 15' failed"; exit 1; }
-grep -q '15.1.0' "$TMP/inst1.log" || {
-    cat "$TMP/inst1.log"; echo "partial '15' didn't resolve to 15.1.0"; exit 1; }
+configure_e2e_mirror() {
+    if [[ -n "${MCPP_E2E_TOOLCHAIN_MIRROR:-}" ]]; then
+        "$MCPP" self config --mirror "$MCPP_E2E_TOOLCHAIN_MIRROR" > "$TMP/mirror.log" 2>&1 || {
+            cat "$TMP/mirror.log"
+            echo "failed to configure e2e mirror"
+            exit 1
+        }
+    fi
+}
 
-"$MCPP" toolchain install gcc@16   > "$TMP/inst2.log" 2>&1 || {
-    cat "$TMP/inst2.log"; echo "install 'gcc@16' failed"; exit 1; }
-grep -q '16.1.0' "$TMP/inst2.log" || {
-    cat "$TMP/inst2.log"; echo "partial '@16' didn't resolve to 16.1.0"; exit 1; }
+# ─── Section 1: dual-form + partial-version toolchain commands ─────────
+export MCPP_HOME="$TMP/h1"
+inherit_payloads_only
+configure_e2e_mirror
 
-# Both versions should appear in `list`.
+# Reuse the CI-prepared gcc payload. The full install path is covered by
+# 26_toolchain_management.sh; this test focuses on partial/default parsing
+# without redownloading large toolchain archives.
 out=$("$MCPP" toolchain list 2>&1)
-[[ "$out" == *"gcc"*"15.1.0"* ]] || { echo "gcc 15.1.0 missing from list:"; echo "$out"; exit 1; }
 [[ "$out" == *"gcc"*"16.1.0"* ]] || { echo "gcc 16.1.0 missing from list:"; echo "$out"; exit 1; }
 
 # `default gcc 16` (positional) should pick highest 16.x.y.
@@ -34,17 +42,18 @@ out=$("$MCPP" toolchain list 2>&1)
 grep -q 'gcc@16.1.0' "$TMP/def1.log" || {
     cat "$TMP/def1.log"; echo "default 'gcc 16' didn't resolve to 16.1.0"; exit 1; }
 
-# `default gcc@15` (@-form) should switch to 15.1.0.
-"$MCPP" toolchain default gcc@15   > "$TMP/def2.log" 2>&1 || {
-    cat "$TMP/def2.log"; echo "default 'gcc@15' failed"; exit 1; }
-grep -q 'gcc@15.1.0' "$TMP/def2.log" || {
-    cat "$TMP/def2.log"; echo "default 'gcc@15' didn't resolve to 15.1.0"; exit 1; }
+# `default gcc@16` (@-form) should also resolve to 16.1.0.
+"$MCPP" toolchain default gcc@16   > "$TMP/def2.log" 2>&1 || {
+    cat "$TMP/def2.log"; echo "default 'gcc@16' failed"; exit 1; }
+grep -q 'gcc@16.1.0' "$TMP/def2.log" || {
+    cat "$TMP/def2.log"; echo "default 'gcc@16' didn't resolve to 16.1.0"; exit 1; }
 
 # ─── Section 2: first-run auto-install ──────────────────────────────────
 # Brand-new MCPP_HOME, brand-new package with no [toolchain] declared —
 # `mcpp build` should auto-install the canonical default (musl-gcc 15.1
 # for portable static binaries) + use it. Output should be a static ELF.
 export MCPP_HOME="$TMP/h2"
+configure_e2e_mirror
 mkdir -p "$TMP/proj"
 cd "$TMP/proj"
 "$MCPP" new hello > /dev/null

tests/e2e/29_toolchain_partial_versions.sh

@@ -19,12 +19,22 @@ if [[ -d "$USER_MCPP/registry/data/xpkgs" ]]; then
     [[ -e "$MCPP_HOME/registry/data/xpkgs" ]] \
         || ln -sf "$USER_MCPP/registry/data/xpkgs" "$MCPP_HOME/registry/data/xpkgs"
 fi
-if [[ -d "$USER_MCPP/registry/subos" ]]; then
+if [[ -d "$USER_MCPP/registry/data/xim-pkgindex" ]]; then
+    mkdir -p "$MCPP_HOME/registry/data"
+    [[ -e "$MCPP_HOME/registry/data/xim-pkgindex" ]] \
+        || ln -sf "$USER_MCPP/registry/data/xim-pkgindex" "$MCPP_HOME/registry/data/xim-pkgindex"
+fi
+if [[ -d "$USER_MCPP/registry/data/xim-index-repos" ]]; then
+    mkdir -p "$MCPP_HOME/registry/data"
+    [[ -e "$MCPP_HOME/registry/data/xim-index-repos" ]] \
+        || ln -sf "$USER_MCPP/registry/data/xim-index-repos" "$MCPP_HOME/registry/data/xim-index-repos"
+fi
+if [[ "${MCPP_INHERIT_SUBOS:-1}" != "0" && -d "$USER_MCPP/registry/subos" ]]; then
     mkdir -p "$MCPP_HOME/registry"
     [[ -e "$MCPP_HOME/registry/subos" ]] \
         || ln -sf "$USER_MCPP/registry/subos" "$MCPP_HOME/registry/subos"
 fi
-if [[ -f "$USER_MCPP/config.toml" ]]; then
+if [[ "${MCPP_INHERIT_CONFIG:-1}" != "0" && -f "$USER_MCPP/config.toml" ]]; then
     cp -f "$USER_MCPP/config.toml" "$MCPP_HOME/config.toml" 2>/dev/null || true
 fi
 if [[ -d "$USER_MCPP/bin" ]]; then