@codyswann/lisa 4.81.9 → 4.82.1

package/dist/cli/lisa-test-run.js

@@ -1,9 +1,15 @@
 #!/usr/bin/env node
 /** Public entrypoint for birth-bound test supervision and scratch cleanup. */
+import * as os from "node:os";
+import * as path from "node:path";
+import { env } from "node:process";
 // @ts-expect-error -- the shipped JavaScript helper carries the same checked JSDoc signature
 import { invokedAsScript } from "../../scripts/lib/invoked-as-script.mjs";
 import { worktreeDependencyProblem } from "../../all/copy-overwrite/scripts/lib/worktree-dependencies.mjs";
 import { resolveScratchRouteProfile, } from "../configs/vitest/scratch-route-profile.js";
+import { socketSafeTempBase } from "../configs/vitest/socket-safe-temp-base.js";
+import { mergeJestShards } from "./lisa-test-run-jest-merge.js";
+import { gatherVitestBlobs, readShardReceipts, SHARD_ENV_NAMES, shardArgv, shardPlanFrom, shardRunnerOf, vitestMergeArgv, writeShardReceipt, } from "./lisa-test-run-shard.js";
 import { superviseTestRun, } from "./lisa-test-run-supervisor.js";
 export { assertTestRunPlatform } from "./lisa-test-run-process-group.js";
 /** Dedicated operational-failure exit status. */
@@ -43,6 +49,48 @@ function invocationOrExit() {
         return undefined;
     }
 }
+/**
+ * Apply the shard plan `quality.yml` put in the environment, if any.
+ *
+ * The variables are removed before the payload starts. Lisa's own suites spawn
+ * `lisa-test-run` as a fixture, and an inherited shard plan would make every
+ * one of those nested runs shard itself.
+ * @param argv - Payload argv as parsed
+ * @returns The argv to supervise, or an exit code when no test run is needed
+ */
+function applyShardPlan(argv) {
+    const plan = shardPlanFrom(env);
+    for (const name of SHARD_ENV_NAMES)
+        delete env[name];
+    if (plan.kind === "none")
+        return argv;
+    const runner = shardRunnerOf(argv);
+    if (plan.kind === "shard") {
+        writeShardReceipt(plan, runner, argv);
+        return shardArgv(argv, runner, plan);
+    }
+    const receipts = readShardReceipts(plan.directory, plan.total);
+    if (receipts[0]?.runner !== runner) {
+        throw new Error(`the shards ran ${receipts[0]?.runner}, but this merge would run ${runner}.`);
+    }
+    if (runner === "jest")
+        return mergeJestShards(argv, receipts);
+    const blobs = path.join(plan.directory, ".lisa-vitest-blobs");
+    gatherVitestBlobs(receipts, blobs);
+    return vitestMergeArgv(argv, blobs);
+}
+/**
+ * Move the run off a temp base too long for native Unix socket fixtures,
+ * before any scratch authority is pinned to it.
+ */
+function selectSocketSafeTempBase() {
+    const current = os.tmpdir();
+    const replacement = socketSafeTempBase(current);
+    if (replacement === undefined)
+        return;
+    env.TMPDIR = replacement;
+    process.stderr.write(`lisa-test-run: TMPDIR ${current} is too long for native Unix socket fixtures; using ${replacement}.\n`);
+}
 /** Run the public CLI and preserve the child result only after cleanup. */
 async function main() {
     const invocation = invocationOrExit();
@@ -52,7 +100,11 @@ async function main() {
         const dependencyProblem = worktreeDependencyProblem();
         if (dependencyProblem)
             throw new Error(dependencyProblem);
-        const outcome = await superviseTestRun(invocation.argv, invocation.profile, invocation.adapter);
+        selectSocketSafeTempBase();
+        const payload = applyShardPlan(invocation.argv);
+        if (typeof payload === "number")
+            process.exit(payload);
+        const outcome = await superviseTestRun(payload, invocation.profile, invocation.adapter);
         if (outcome.signal !== null) {
             process.removeAllListeners(outcome.signal);
             process.kill(process.pid, outcome.signal);

package/dist/cli/lisa-test-run.js.map

@@ -1 +1 @@
-{"version":3,"file":"lisa-test-run.js","sourceRoot":"","sources":["../../src/cli/lisa-test-run.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"lisa-test-run.js","sourceRoot":"","sources":["../../src/cli/lisa-test-run.ts"],"names":[],"mappings":"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"}

package/dist/configs/vitest/socket-safe-temp-base.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Pick a temp base short enough for supervised native Unix socket fixtures.
+ *
+ * macOS gives each user a TMPDIR under `/var/folders/…` of about 48 bytes.
+ * Supervised fixtures bind sockets at
+ * `<base>/lisa-scratch/run-<pid>-<epoch>-<suffix>/u-XXXXXX/<socket>`, and a
+ * Unix socket path over 103 bytes cannot be bound, so on a stock Mac those
+ * tests failed before asserting anything unless the developer happened to
+ * export a short TMPDIR. Linux CI runners use `/tmp` and never reach this.
+ *
+ * Only that stock macOS default is replaced. Any other TMPDIR was chosen on
+ * purpose (a nested run's scratch root, an operator's override) and is kept
+ * even when long; the fixture then reports the length itself.
+ * @module configs/vitest/socket-safe-temp-base
+ */
+import * as fs from "node:fs";
+/** Longest Unix socket path every supported platform can bind. */
+export declare const UNIX_SOCKET_PATH_LIMIT = 103;
+/** Longest temp base that still fits a fixture socket. */
+export declare const MAX_SOCKET_SAFE_TEMP_BASE_BYTES: number;
+/** Filesystem seam for tests. */
+export interface TempBaseFs {
+    readonly realpathSync: (target: string) => string;
+    readonly lstatSync: (target: string) => fs.Stats;
+    readonly accessSync: (target: string, mode: number) => void;
+}
+/**
+ * A short, real, writable replacement for macOS's stock temp dir when it is
+ * too long, else undefined (keep `current`). Never returns a symlink:
+ * the scratch namespace refuses a symlinked base, so `/tmp` is resolved to its
+ * physical directory (`/private/tmp` on macOS) first.
+ * @param current - The temp base the run would otherwise use
+ * @param platform - Platform to decide for
+ * @param seam - Filesystem seam
+ * @returns Replacement base, or undefined to keep `current`
+ */
+export declare function socketSafeTempBase(current: string, platform?: NodeJS.Platform, seam?: TempBaseFs): string | undefined;
+//# sourceMappingURL=socket-safe-temp-base.d.ts.map

package/dist/configs/vitest/socket-safe-temp-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-safe-temp-base.d.ts","sourceRoot":"","sources":["../../../src/configs/vitest/socket-safe-temp-base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAG9B,kEAAkE;AAClE,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAU1C,0DAA0D;AAC1D,eAAO,MAAM,+BAA+B,QACG,CAAC;AAKhD,iCAAiC;AACjC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,EAAE,CAAC,KAAK,CAAC;IACjD,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7D;AAQD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,IAAI,GAAE,UAAoB,GACzB,MAAM,GAAG,SAAS,CAkBpB"}

package/dist/configs/vitest/socket-safe-temp-base.js

@@ -0,0 +1,65 @@
+/**
+ * Pick a temp base short enough for supervised native Unix socket fixtures.
+ *
+ * macOS gives each user a TMPDIR under `/var/folders/…` of about 48 bytes.
+ * Supervised fixtures bind sockets at
+ * `<base>/lisa-scratch/run-<pid>-<epoch>-<suffix>/u-XXXXXX/<socket>`, and a
+ * Unix socket path over 103 bytes cannot be bound, so on a stock Mac those
+ * tests failed before asserting anything unless the developer happened to
+ * export a short TMPDIR. Linux CI runners use `/tmp` and never reach this.
+ *
+ * Only that stock macOS default is replaced. Any other TMPDIR was chosen on
+ * purpose (a nested run's scratch root, an operator's override) and is kept
+ * even when long; the fixture then reports the length itself.
+ * @module configs/vitest/socket-safe-temp-base
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+/** Longest Unix socket path every supported platform can bind. */
+export const UNIX_SOCKET_PATH_LIMIT = 103;
+/**
+ * Bytes a supervised fixture adds below the base, at the longest pid (7
+ * digits), a 13-digit epoch and the longest socket name in use.
+ */
+const FIXTURE_SUFFIX_BYTES = Buffer.byteLength("/lisa-scratch/run-4194304-1792777528381-b0e12b9d/u-XXXXXX/hook-reader.sock");
+/** Longest temp base that still fits a fixture socket. */
+export const MAX_SOCKET_SAFE_TEMP_BASE_BYTES = UNIX_SOCKET_PATH_LIMIT - FIXTURE_SUFFIX_BYTES;
+/** macOS's per-user default temp dir (`confstr(_CS_DARWIN_USER_TEMP_DIR)`). */
+const DARWIN_DEFAULT_TEMP = /^\/(?:private\/)?var\/folders\//;
+const NODE_FS = {
+    realpathSync: target => fs.realpathSync(target),
+    lstatSync: target => fs.lstatSync(target),
+    accessSync: (target, mode) => fs.accessSync(target, mode),
+};
+/**
+ * A short, real, writable replacement for macOS's stock temp dir when it is
+ * too long, else undefined (keep `current`). Never returns a symlink:
+ * the scratch namespace refuses a symlinked base, so `/tmp` is resolved to its
+ * physical directory (`/private/tmp` on macOS) first.
+ * @param current - The temp base the run would otherwise use
+ * @param platform - Platform to decide for
+ * @param seam - Filesystem seam
+ * @returns Replacement base, or undefined to keep `current`
+ */
+export function socketSafeTempBase(current, platform = process.platform, seam = NODE_FS) {
+    if (platform !== "darwin" || !DARWIN_DEFAULT_TEMP.test(current)) {
+        return undefined;
+    }
+    if (Buffer.byteLength(current) <= MAX_SOCKET_SAFE_TEMP_BASE_BYTES) {
+        return undefined;
+    }
+    try {
+        const candidate = seam.realpathSync(`${path.sep}tmp`);
+        const stat = seam.lstatSync(candidate);
+        if (stat.isSymbolicLink() || !stat.isDirectory())
+            return undefined;
+        seam.accessSync(candidate, fs.constants.W_OK);
+        return Buffer.byteLength(candidate) <= MAX_SOCKET_SAFE_TEMP_BASE_BYTES
+            ? candidate
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=socket-safe-temp-base.js.map

package/dist/configs/vitest/socket-safe-temp-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-safe-temp-base.js","sourceRoot":"","sources":["../../../src/configs/vitest/socket-safe-temp-base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,kEAAkE;AAClE,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAE1C;;;GAGG;AACH,MAAM,oBAAoB,GAAG,MAAM,CAAC,UAAU,CAC5C,4EAA4E,CAC7E,CAAC;AAEF,0DAA0D;AAC1D,MAAM,CAAC,MAAM,+BAA+B,GAC1C,sBAAsB,GAAG,oBAAoB,CAAC;AAEhD,+EAA+E;AAC/E,MAAM,mBAAmB,GAAG,iCAAiC,CAAC;AAS9D,MAAM,OAAO,GAAe;IAC1B,YAAY,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC;IAC/C,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC;IACzC,UAAU,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC;CAC1D,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAe,EACf,WAA4B,OAAO,CAAC,QAAQ,EAC5C,OAAmB,OAAO;IAE1B,IAAI,QAAQ,KAAK,QAAQ,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAChE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,+BAA+B,EAAE,CAAC;QAClE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;YAAE,OAAO,SAAS,CAAC;QACnE,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9C,OAAO,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,+BAA+B;YACpE,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,SAAS,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/core/nightly-e2e-guard-behavior-certificate.js

@@ -41,9 +41,9 @@ export const NIGHTLY_E2E_GUARD_BEHAVIOR_CERTIFICATES = Object.freeze({
     }),
     d1b26caeaf65950e3b60ff41964d234c032c50470072e7643310b1f6722e34e6: Object.freeze({
         contractVersion: "1.9.0",
-        packageVersions: Object.freeze(["4.81.9"]),
+        packageVersions: Object.freeze(["4.82.1"]),
         provenances: Object.freeze([
-            "workspace package @codyswann/lisa@4.81.9 (typescript/copy-overwrite/scripts/check-nightly-e2e-health.mjs)",
+            "workspace package @codyswann/lisa@4.82.1 (typescript/copy-overwrite/scripts/check-nightly-e2e-health.mjs)",
         ]),
     }),
     dfd2fef680de5ef03e63075e8a61c62ca4d95cdfdff6201939b79c748d3397f6: Object.freeze({

package/dist/core/upstream-evidence-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upstream-evidence-manifest.d.ts","sourceRoot":"","sources":["../../src/core/upstream-evidence-manifest.ts"],"names":[],"mappings":"AACA,iFAAiF;AACjF,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAo4FpE,CAAC;AAEL,4EAA4E;AAC5E,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAw/TjE,CAAC;AAEL,sFAAsF;AACtF,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAk6I/D,CAAC"}
+{"version":3,"file":"upstream-evidence-manifest.d.ts","sourceRoot":"","sources":["../../src/core/upstream-evidence-manifest.ts"],"names":[],"mappings":"AACA,iFAAiF;AACjF,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAo4FpE,CAAC;AAEL,4EAA4E;AAC5E,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAugUjE,CAAC;AAEL,sFAAsF;AACtF,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAk6I/D,CAAC"}

package/dist/core/upstream-evidence-manifest.js

@@ -1381,7 +1381,7 @@ export const UPSTREAM_EVIDENCE_MANIFEST = Object.freeze({
     "scripts/run-artifact-checks.mjs": "2992d673bb3c1ebfa50bda9ed323b8410afdab2ffc925eee6eab19fcab312a90",
     "scripts/setup-deploy-key.sh": "2bed19346810b7af18a5225fd463c4d553a7bcc7b2f11a21bd47b93e6b5e1719",
     "scripts/test-intent-routing.sh": "97b9dc86cbd805df8a7fdb8c99ffab9b8c5e751ba2e84c05420b2a124f80635d",
-    "scripts/two-channel-couplings.json": "26d274f7cc3334e17eaedfc088cdf0550355cc0b40b1410f09ba181a17a006ac",
+    "scripts/two-channel-couplings.json": "e515abdd6d812feba4c2144b17193e8dec436a46e581b7424d572aa31dcaf70a",
     "scripts/update-node-version.ts": "9d37599ef73d5d624751f862cda330a867f6774392c1ab045b4fc885132582e4",
     "scripts/update-test-skill-paths.mjs": "e26a3ac716c33013e22bf5223a58457452f5af2038218a0e3a51c244eab5ddc9",
     "scripts/verify-health-agentic-built.mjs": "4b0d20b2c94390ff6f5af881fc50c5c225215a282891db0b3e3d84a7e6455367",
@@ -8858,9 +8858,11 @@ export const UPSTREAM_SURFACE_MANIFEST = Object.freeze({
     "src/cli/learnings-overflow-cmd.ts": true,
     "src/cli/lisa-test-run-bootstrap.ts": true,
     "src/cli/lisa-test-run-ipc.ts": true,
+    "src/cli/lisa-test-run-jest-merge.ts": true,
     "src/cli/lisa-test-run-process-group.ts": true,
     "src/cli/lisa-test-run-reaper.ts": true,
     "src/cli/lisa-test-run-runtime.ts": true,
+    "src/cli/lisa-test-run-shard.ts": true,
     "src/cli/lisa-test-run-supervisor.ts": true,
     "src/cli/lisa-test-run.ts": true,
     "src/cli/merge-learnings-cmd.ts": true,
@@ -9014,6 +9016,7 @@ export const UPSTREAM_SURFACE_MANIFEST = Object.freeze({
     "src/configs/vitest/scratch-sweep.ts": true,
     "src/configs/vitest/scratch-tmpdir-trust.ts": true,
     "src/configs/vitest/scratch.ts": true,
+    "src/configs/vitest/socket-safe-temp-base.ts": true,
     "src/configs/vitest/synthesis-scratch-reclaim.ts": true,
     "src/configs/vitest/typescript.ts": true,
     "src/configs/worktrees.ts": true,
@@ -9603,7 +9606,9 @@ export const UPSTREAM_SURFACE_MANIFEST = Object.freeze({
     "tests/integration/jest-expo-haste-pruning.test.ts": true,
     "tests/integration/jira-shell-auth-destinations.test.ts": true,
     "tests/integration/job-names-name-properties.test.ts": true,
+    "tests/integration/lisa-test-run-jest-shards.test.ts": true,
     "tests/integration/lisa-test-run-packed-bin.test.ts": true,
+    "tests/integration/lisa-test-run-shard-cli.test.ts": true,
     "tests/integration/lisa.test.ts": true,
     "tests/integration/maestro-build-reuse.test.ts": true,
     "tests/integration/maestro-caller-template.test.ts": true,
@@ -9703,6 +9708,10 @@ export const UPSTREAM_SURFACE_MANIFEST = Object.freeze({
     "tests/integration/quality-shared-web-export.test.ts": true,
     "tests/integration/quality-ungated-jobs.test.ts": true,
     "tests/integration/quality-unit-progress.test.ts": true,
+    "tests/integration/quality-unit-test-shards-aggregate.test.ts": true,
+    "tests/integration/quality-unit-test-shards-env-scope.test.ts": true,
+    "tests/integration/quality-unit-test-shards-fixture.ts": true,
+    "tests/integration/quality-unit-test-shards.test.ts": true,
     "tests/integration/quality-verification-coverage-collapse.test.ts": true,
     "tests/integration/quality-workflow-size.test.ts": true,
     "tests/integration/quality-workflow.test.ts": true,
@@ -9744,6 +9753,7 @@ export const UPSTREAM_SURFACE_MANIFEST = Object.freeze({
     "tests/integration/standards-proof-tamper.test.ts": true,
     "tests/integration/standards-proof-timeout.test.ts": true,
     "tests/integration/standards-proof-typescript.test.ts": true,
+    "tests/integration/support/bun-free-node-bin.ts": true,
     "tests/integration/support/cdk-ci-role-selection-harness.ts": true,
     "tests/integration/support/maestro-android-retry-fixtures.ts": true,
     "tests/integration/support/maestro-android-retry-harness.ts": true,
@@ -9777,6 +9787,7 @@ export const UPSTREAM_SURFACE_MANIFEST = Object.freeze({
     "tests/platform/process-tree-runner.test.mjs": true,
     "tests/platform/windows-missing-handles.ps1": true,
     "tests/platform/windows-process-fixture.mjs": true,
+    "tests/support/ci-runtime.ts": true,
     "tests/support/codex-compatibility-candidate.mjs": true,
     "tests/support/codex-compatibility-proof.mjs": true,
     "tests/support/codex-compatibility-seed.mjs": true,
@@ -9900,6 +9911,7 @@ export const UPSTREAM_SURFACE_MANIFEST = Object.freeze({
     "tests/unit/cli/learnings-overflow-cmd.test.ts": true,
     "tests/unit/cli/lisa-test-run-process-group.test.ts": true,
     "tests/unit/cli/lisa-test-run-protocol-state.test.ts": true,
+    "tests/unit/cli/lisa-test-run-shard.test.ts": true,
     "tests/unit/cli/merge-learnings-cmd.test.ts": true,
     "tests/unit/cli/override-load-diagnostic.test.ts": true,
     "tests/unit/cli/parse-refresh-templates.test.ts": true,
@@ -10093,6 +10105,7 @@ export const UPSTREAM_SURFACE_MANIFEST = Object.freeze({
     "tests/unit/config/scratch-tmpdir-trust.test.ts": true,
     "tests/unit/config/security-pin-floors.test.ts": true,
     "tests/unit/config/shipped-mjs-roster.test.ts": true,
+    "tests/unit/config/socket-safe-temp-base.test.ts": true,
     "tests/unit/config/sonar-coverage-handoff.test.ts": true,
     "tests/unit/config/stale-deploy-guard.test.ts": true,
     "tests/unit/config/synthesis-scratch-reclaim.test.ts": true,
@@ -10133,6 +10146,7 @@ export const UPSTREAM_SURFACE_MANIFEST = Object.freeze({
     "tests/unit/core/apply-receipt-deletion-record.test.ts": true,
     "tests/unit/core/bootstrap-environment.test.ts": true,
     "tests/unit/core/cdk-preset-adoption.test.ts": true,
+    "tests/unit/core/ci-runtime-deferral.test.ts": true,
     "tests/unit/core/deletion-basis.test.ts": true,
     "tests/unit/core/deploy-release-dependence.test.ts": true,
     "tests/unit/core/effectiveness-store.test.ts": true,
@@ -10246,6 +10260,7 @@ export const UPSTREAM_SURFACE_MANIFEST = Object.freeze({
     "tests/unit/devin/plugin-installer.test.ts": true,
     "tests/unit/docs/onboarding-walkthrough.test.ts": true,
     "tests/unit/fixtures/shared-runtime-native-deadline.test.ts": true,
+    "tests/unit/fixtures/shared-runtime-patched-floors.test.ts": true,
     "tests/unit/governance-contracts.test.ts": true,
     "tests/unit/health/agentic.test.ts": true,
     "tests/unit/health/consumer.test.ts": true,