@zackees/soldr 0.7.55 → 0.7.57

package/README.md

@@ -18,6 +18,15 @@ Third-party comparison (soldr vs Swatinem/rust-cache vs ...): published from `za
 [![Windows x64](https://github.com/zackees/soldr/actions/workflows/build-windows-x64.yml/badge.svg?branch=main)](https://github.com/zackees/soldr/actions/workflows/build-windows-x64.yml)
 [![Windows ARM64](https://github.com/zackees/soldr/actions/workflows/build-windows-arm64.yml/badge.svg?branch=main)](https://github.com/zackees/soldr/actions/workflows/build-windows-arm64.yml)
 
+## Performance
+
+[![soldr vs sccache vs bare cargo - Rust workload](https://raw.githubusercontent.com/zackees/soldr/benchmark-stats/benchmark-rust-only.jpg)](https://zackees.github.io/soldr/)
+[![soldr vs sccache vs bare cargo - Rust+C workload](https://raw.githubusercontent.com/zackees/soldr/benchmark-stats/benchmark-rust-c.jpg)](https://zackees.github.io/soldr/)
+
+*[performance details](https://zackees.github.io/soldr/)*
+
+Cold builds are a wash; warm and cross-worktree share are where soldr's wrapper architecture pays off. Full historical trend + interactive view: [zackees.github.io/soldr](https://zackees.github.io/soldr/). For the swatinem/rust-cache comparison (GHA target-dir caching, a different layer) see [PERF.md](PERF.md#readme-comparison-bars-issue-785).
+
 **Instant tools. Instant builds. One command.**
 
 soldr = [crgx](https://crgx.dev/) + [zccache](https://github.com/zackees/zccache) in a single tool.

package/contracts/zccache-integration-guardrails.v1.json

@@ -290,6 +290,22 @@
         "perf-matrix-worktree-touch"
       ]
     },
+    {
+      "id": "perf-build-then-check",
+      "axis": "performance",
+      "gate": "report-only",
+      "covers": [
+        "cross-verb cache reuse (build -> check)",
+        "rustc --emit canonicalization canary"
+      ],
+      "test_files": [
+        ".github/workflows/perf-matrix.yml",
+        "perf/scenarios/build-then-check/run.sh"
+      ],
+      "validation_command_ids": [
+        "perf-matrix-worktree-touch"
+      ]
+    },
     {
       "id": "native-cc-cache",
       "axis": "native C/C++ cache",

package/contracts/zccache-runtime.v1.json

@@ -18,7 +18,7 @@
     "linux_zccache_target_libc": "musl"
   },
   "zccache": {
-    "managed_version": "1.12.7",
+    "managed_version": "1.12.8",
     "local_dir_env": "SOLDR_ZCCACHE_LOCAL_DIR",
     "cache_dir_env": "ZCCACHE_CACHE_DIR",
     "required_binaries": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zackees/soldr",
-  "version": "0.7.55",
+  "version": "0.7.57",
   "description": "Instant Rust tools and builds from one command.",
   "license": "BSD-3-Clause",
   "homepage": "https://github.com/zackees/soldr",

package/scripts/install.js

@@ -284,6 +284,13 @@ async function install() {
         fs.chmodSync(dst, 0o755);
       }
     }
+    for (const entry of zccacheContract.soldrDebugInfoEntries(manifest)) {
+      const src = findExtractedBinary(extractDir, entry.name);
+      if (!src) {
+        throw new Error(`release archive ${filename} did not contain ${entry.name}`);
+      }
+      fs.copyFileSync(src, path.join(nativeDir, entry.name));
+    }
 
     // Drop manifest.json alongside the binaries so downstream tooling
     // (and humans reading `bin/native/`) can introspect provenance —

package/scripts/test-npm-package.js

@@ -135,6 +135,14 @@ assert.deepStrictEqual(zccacheContract.ZCCACHE_BUNDLED_BINARIES, [
 ]);
 assert.strictEqual(zccacheContract.CRGX_BUNDLED_BINARY, "crgx");
 assert.strictEqual(zccacheContract.CARGO_CHEF_BUNDLED_BINARY, "cargo-chef");
+assert.deepStrictEqual(
+  zccacheContract.soldrDebugInfoEntries({
+    soldr: {
+      debug_info: [{ name: "soldr.pdb", sha256: "0".repeat(64), format: "pdb" }],
+    },
+  }),
+  [{ name: "soldr.pdb", sha256: "0".repeat(64), format: "pdb" }],
+);
 assert.ok(
   fs.existsSync(path.join(root, "contracts", "zccache-integration-guardrails.v1.json")),
   "npm package must include the zccache integration guardrail contract",

package/scripts/zccache-contract.js

@@ -57,6 +57,13 @@ function collectManifestBinaries(manifest) {
   return binaries;
 }
 
+function soldrDebugInfoEntries(manifest) {
+  const entries = manifest.soldr && Array.isArray(manifest.soldr.debug_info)
+    ? manifest.soldr.debug_info
+    : [];
+  return entries.filter((entry) => entry && entry.name && entry.sha256);
+}
+
 function validateReleaseManifest(manifest, options) {
   const { soldrTarget, platform = process.platform, findFile } = options;
   if (!Number.isInteger(manifest.schema_version) || manifest.schema_version < MANIFEST_MIN_SCHEMA_VERSION) {
@@ -95,6 +102,28 @@ function validateReleaseManifest(manifest, options) {
       throw new Error(`release manifest sha256 mismatch for ${name}: expected ${expectedSha}, got ${actualSha}`);
     }
   }
+
+  const debugInfo = soldrDebugInfoEntries(manifest);
+  if (platform === "win32" && debugInfo.length === 0) {
+    throw new Error("release manifest is missing soldr debug_info PDB entry");
+  }
+  for (const entry of debugInfo) {
+    if (entry.format !== "pdb") {
+      throw new Error(`unsupported soldr debug_info format for ${entry.name}: ${entry.format}`);
+    }
+    if (!/\.pdb$/i.test(entry.name)) {
+      throw new Error(`soldr debug_info entry must name a .pdb file: ${entry.name}`);
+    }
+    const expectedSha = String(entry.sha256).toLowerCase();
+    if (!/^[0-9a-f]{64}$/.test(expectedSha)) {
+      throw new Error(`release manifest sha256 for ${entry.name} is not lowercase hex`);
+    }
+    const filePath = findFile(entry.name);
+    const actualSha = sha256File(filePath);
+    if (actualSha !== expectedSha) {
+      throw new Error(`release manifest sha256 mismatch for ${entry.name}: expected ${expectedSha}, got ${actualSha}`);
+    }
+  }
 }
 
 module.exports = {
@@ -108,6 +137,7 @@ module.exports = {
   ZCCACHE_BUNDLED_BINARIES,
   binaryName,
   releaseBinaryNames,
+  soldrDebugInfoEntries,
   validateReleaseManifest,
   zccacheTargetForSoldrTarget,
 };