@bitfab/sdk 0.69.0 → 0.71.0

package/dist/replayCli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as runRegistryMain, c as runSeedCli, i as runIfEntrypoint, n as parseRegistryCommandArgs, o as checkReplayCliArgs, r as resolveRegistry, s as runReplayCli, t as importRegistry } from "./registryCommand-CWxt6kPp.js";
+import { a as runRegistryMain, c as runSeedCli, i as runIfEntrypoint, n as parseRegistryCommandArgs, o as checkReplayCliArgs, r as resolveRegistry, s as runReplayCli, t as importRegistry } from "./registryCommand-jPTSRgL9.js";
 //#region src/cloudReplayCli.ts
 const CLOUD_REPLAY_HINT = "Add --cloud to run the same replay on GitHub Actions; bitfab-replay --cloud --help explains it.";
 function isCloudReplayCommand(argv) {
@@ -38,7 +38,7 @@ async function runCloudReplayCommand(argv, helper) {
 //#endregion
 //#region src/replayCli.ts
 const CHECK_ARGUMENTS_FLAG = "--check-arguments";
-const USAGE = `Usage: bitfab-replay --registry <path> <pipeline> [options]\n       bitfab-replay --registry <path> <pipeline> --resume <experimentId>\n       bitfab-replay --registry <path> <pipeline> --seed <cases.jsonl> [--run]\nRun bitfab-replay --registry <path> --help to list replay options.\n${CLOUD_REPLAY_HINT}`;
+const USAGE = `Usage: bitfab-replay --registry <path> <pipeline> --code-change <type> [options]\n       bitfab-replay --registry <path> <pipeline> --code-change <type> --resume <experimentId>\n       bitfab-replay --registry <path> <pipeline> --seed <cases.jsonl> [--run]\nRun bitfab-replay --registry <path> --help to list replay options.\n${CLOUD_REPLAY_HINT}`;
 async function runReplayCommand(argv, io = {}, importer = importRegistry) {
 	const { registryPath, commandArgs } = await parseRegistryCommandArgs(argv, USAGE);
 	const registry = resolveRegistry(await importer(registryPath), registryPath);

package/dist/replayCli.js.map

@@ -1 +1 @@
-{"version":3,"file":"replayCli.js","names":[],"sources":["../src/cloudReplayCli.ts","../src/replayCli.ts"],"sourcesContent":["export const CLOUD_REPLAY_HINT =\n  \"Add --cloud to run the same replay on GitHub Actions; bitfab-replay --cloud --help explains it.\"\n\nexport function isCloudReplayCommand(argv: readonly string[]): boolean {\n  return argv.some((arg) => arg === \"--cloud\" || arg.startsWith(\"--cloud-\"))\n}\n\nexport async function runCloudReplayCommand(\n  argv: readonly string[],\n  helper?: string,\n): Promise<number> {\n  const [{ spawn }, { fileURLToPath }] = await Promise.all([\n    import(\"node:child_process\"),\n    import(\"node:url\"),\n  ])\n  const script =\n    helper ?? fileURLToPath(new URL(\"../cloudReplay.py\", import.meta.url))\n  const replayCommand = [\n    process.execPath,\n    ...process.execArgv.filter((flag) => !/^--(inspect|debug)/.test(flag)),\n    fileURLToPath(new URL(\"./replayCli.js\", import.meta.url)),\n  ]\n  const keepWaiting = () => {}\n  process.on(\"SIGINT\", keepWaiting)\n  try {\n    return await new Promise<number>((resolve) => {\n      const child = spawn(\"python3\", [script, ...argv], {\n        stdio: \"inherit\",\n        env: {\n          ...process.env,\n          BITFAB_REPLAY_COMMAND: JSON.stringify(replayCommand),\n          BITFAB_SDK_LANGUAGE: \"typescript\",\n        },\n      })\n      child.on(\"error\", () => {\n        process.stderr.write(\n          \"Cloud replay needs Python 3.10+ on PATH as python3\\n\",\n        )\n        resolve(1)\n      })\n      child.on(\"close\", (code, signal) =>\n        resolve(code ?? (signal === \"SIGINT\" ? 130 : 1)),\n      )\n    })\n  } finally {\n    process.off(\"SIGINT\", keepWaiting)\n  }\n}\n","#!/usr/bin/env node\n\nimport {\n  CLOUD_REPLAY_HINT,\n  isCloudReplayCommand,\n  runCloudReplayCommand,\n} from \"./cloudReplayCli.js\"\nimport {\n  importRegistry,\n  parseRegistryCommandArgs,\n  type RegistryImporter,\n  resolveRegistry,\n  runIfEntrypoint,\n  runRegistryMain,\n} from \"./registryCommand.js\"\nimport type { ReplayResult } from \"./replay.js\"\nimport {\n  checkReplayCliArgs,\n  type ReplayCliIo,\n  type ReseedRegistryResult,\n  runReplayCli,\n  runSeedCli,\n  type SeedResult,\n} from \"./replayRegistry.js\"\n\nconst CHECK_ARGUMENTS_FLAG = \"--check-arguments\"\n\nconst USAGE = `Usage: bitfab-replay --registry <path> <pipeline> [options]\\n       bitfab-replay --registry <path> <pipeline> --resume <experimentId>\\n       bitfab-replay --registry <path> <pipeline> --seed <cases.jsonl> [--run]\\nRun bitfab-replay --registry <path> --help to list replay options.\\n${CLOUD_REPLAY_HINT}`\n\nexport async function runReplayCommand(\n  argv: readonly string[],\n  io: ReplayCliIo = {},\n  importer: RegistryImporter = importRegistry,\n): Promise<ReplayResult<unknown> | SeedResult | ReseedRegistryResult | null> {\n  const { registryPath, commandArgs } = await parseRegistryCommandArgs(\n    argv,\n    USAGE,\n  )\n  const registry = resolveRegistry(await importer(registryPath), registryPath)\n  if (commandArgs.includes(\"--seed\")) {\n    return runSeedCli(registry, commandArgs, io)\n  }\n  return runReplayCli(registry, commandArgs, io, registryPath)\n}\n\nexport async function runReplayMain(\n  argv: readonly string[],\n  io: ReplayCliIo = {},\n): Promise<number> {\n  if (argv[0] === CHECK_ARGUMENTS_FLAG) {\n    return runRegistryMain(async () => {\n      const { commandArgs } = await parseRegistryCommandArgs(\n        argv.slice(1),\n        USAGE,\n      )\n      checkReplayCliArgs(commandArgs)\n    }, io)\n  }\n  if (isCloudReplayCommand(argv)) {\n    return runCloudReplayCommand(argv)\n  }\n  return runRegistryMain(() => runReplayCommand(argv, io), io)\n}\n\nrunIfEntrypoint(import.meta.url, () => runReplayMain(process.argv.slice(2)))\n"],"mappings":";;;AAAA,MAAa,oBACX;AAEF,SAAgB,qBAAqB,MAAkC;CACrE,OAAO,KAAK,MAAM,QAAQ,QAAQ,aAAa,IAAI,WAAW,UAAU,CAAC;AAC3E;AAEA,eAAsB,sBACpB,MACA,QACiB;CACjB,MAAM,CAAC,EAAE,SAAS,EAAE,mBAAmB,MAAM,QAAQ,IAAI,CACvD,OAAO,kBACP,OAAO,MACT,CAAC;CACD,MAAM,SACJ,UAAU,cAAc,IAAI,IAAI,qBAAqB,YAAY,GAAG,CAAC;CACvE,MAAM,gBAAgB;EACpB,QAAQ;EACR,GAAG,QAAQ,SAAS,QAAQ,SAAS,CAAC,qBAAqB,KAAK,IAAI,CAAC;EACrE,cAAc,IAAI,IAAI,kBAAkB,YAAY,GAAG,CAAC;CAC1D;CACA,MAAM,oBAAoB,CAAC;CAC3B,QAAQ,GAAG,UAAU,WAAW;CAChC,IAAI;EACF,OAAO,MAAM,IAAI,SAAiB,YAAY;GAC5C,MAAM,QAAQ,MAAM,WAAW,CAAC,QAAQ,GAAG,IAAI,GAAG;IAChD,OAAO;IACP,KAAK;KACH,GAAG,QAAQ;KACX,uBAAuB,KAAK,UAAU,aAAa;KACnD,qBAAqB;IACvB;GACF,CAAC;GACD,MAAM,GAAG,eAAe;IACtB,QAAQ,OAAO,MACb,sDACF;IACA,QAAQ,CAAC;GACX,CAAC;GACD,MAAM,GAAG,UAAU,MAAM,WACvB,QAAQ,SAAS,WAAW,WAAW,MAAM,EAAE,CACjD;EACF,CAAC;CACH,UAAU;EACR,QAAQ,IAAI,UAAU,WAAW;CACnC;AACF;;;ACtBA,MAAM,uBAAuB;AAE7B,MAAM,QAAQ,+RAA+R;AAE7S,eAAsB,iBACpB,MACA,KAAkB,CAAC,GACnB,WAA6B,gBAC8C;CAC3E,MAAM,EAAE,cAAc,gBAAgB,MAAM,yBAC1C,MACA,KACF;CACA,MAAM,WAAW,gBAAgB,MAAM,SAAS,YAAY,GAAG,YAAY;CAC3E,IAAI,YAAY,SAAS,QAAQ,GAC/B,OAAO,WAAW,UAAU,aAAa,EAAE;CAE7C,OAAO,aAAa,UAAU,aAAa,IAAI,YAAY;AAC7D;AAEA,eAAsB,cACpB,MACA,KAAkB,CAAC,GACF;CACjB,IAAI,KAAK,OAAO,sBACd,OAAO,gBAAgB,YAAY;EACjC,MAAM,EAAE,gBAAgB,MAAM,yBAC5B,KAAK,MAAM,CAAC,GACZ,KACF;EACA,mBAAmB,WAAW;CAChC,GAAG,EAAE;CAEP,IAAI,qBAAqB,IAAI,GAC3B,OAAO,sBAAsB,IAAI;CAEnC,OAAO,sBAAsB,iBAAiB,MAAM,EAAE,GAAG,EAAE;AAC7D;AAEA,gBAAgB,YAAY,WAAW,cAAc,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC"}
+{"version":3,"file":"replayCli.js","names":[],"sources":["../src/cloudReplayCli.ts","../src/replayCli.ts"],"sourcesContent":["export const CLOUD_REPLAY_HINT =\n  \"Add --cloud to run the same replay on GitHub Actions; bitfab-replay --cloud --help explains it.\"\n\nexport function isCloudReplayCommand(argv: readonly string[]): boolean {\n  return argv.some((arg) => arg === \"--cloud\" || arg.startsWith(\"--cloud-\"))\n}\n\nexport async function runCloudReplayCommand(\n  argv: readonly string[],\n  helper?: string,\n): Promise<number> {\n  const [{ spawn }, { fileURLToPath }] = await Promise.all([\n    import(\"node:child_process\"),\n    import(\"node:url\"),\n  ])\n  const script =\n    helper ?? fileURLToPath(new URL(\"../cloudReplay.py\", import.meta.url))\n  const replayCommand = [\n    process.execPath,\n    ...process.execArgv.filter((flag) => !/^--(inspect|debug)/.test(flag)),\n    fileURLToPath(new URL(\"./replayCli.js\", import.meta.url)),\n  ]\n  const keepWaiting = () => {}\n  process.on(\"SIGINT\", keepWaiting)\n  try {\n    return await new Promise<number>((resolve) => {\n      const child = spawn(\"python3\", [script, ...argv], {\n        stdio: \"inherit\",\n        env: {\n          ...process.env,\n          BITFAB_REPLAY_COMMAND: JSON.stringify(replayCommand),\n          BITFAB_SDK_LANGUAGE: \"typescript\",\n        },\n      })\n      child.on(\"error\", () => {\n        process.stderr.write(\n          \"Cloud replay needs Python 3.10+ on PATH as python3\\n\",\n        )\n        resolve(1)\n      })\n      child.on(\"close\", (code, signal) =>\n        resolve(code ?? (signal === \"SIGINT\" ? 130 : 1)),\n      )\n    })\n  } finally {\n    process.off(\"SIGINT\", keepWaiting)\n  }\n}\n","#!/usr/bin/env node\n\nimport {\n  CLOUD_REPLAY_HINT,\n  isCloudReplayCommand,\n  runCloudReplayCommand,\n} from \"./cloudReplayCli.js\"\nimport {\n  importRegistry,\n  parseRegistryCommandArgs,\n  type RegistryImporter,\n  resolveRegistry,\n  runIfEntrypoint,\n  runRegistryMain,\n} from \"./registryCommand.js\"\nimport type { ReplayResult } from \"./replay.js\"\nimport {\n  checkReplayCliArgs,\n  type ReplayCliIo,\n  type ReseedRegistryResult,\n  runReplayCli,\n  runSeedCli,\n  type SeedResult,\n} from \"./replayRegistry.js\"\n\nconst CHECK_ARGUMENTS_FLAG = \"--check-arguments\"\n\nconst USAGE = `Usage: bitfab-replay --registry <path> <pipeline> --code-change <type> [options]\\n       bitfab-replay --registry <path> <pipeline> --code-change <type> --resume <experimentId>\\n       bitfab-replay --registry <path> <pipeline> --seed <cases.jsonl> [--run]\\nRun bitfab-replay --registry <path> --help to list replay options.\\n${CLOUD_REPLAY_HINT}`\n\nexport async function runReplayCommand(\n  argv: readonly string[],\n  io: ReplayCliIo = {},\n  importer: RegistryImporter = importRegistry,\n): Promise<ReplayResult<unknown> | SeedResult | ReseedRegistryResult | null> {\n  const { registryPath, commandArgs } = await parseRegistryCommandArgs(\n    argv,\n    USAGE,\n  )\n  const registry = resolveRegistry(await importer(registryPath), registryPath)\n  if (commandArgs.includes(\"--seed\")) {\n    return runSeedCli(registry, commandArgs, io)\n  }\n  return runReplayCli(registry, commandArgs, io, registryPath)\n}\n\nexport async function runReplayMain(\n  argv: readonly string[],\n  io: ReplayCliIo = {},\n): Promise<number> {\n  if (argv[0] === CHECK_ARGUMENTS_FLAG) {\n    return runRegistryMain(async () => {\n      const { commandArgs } = await parseRegistryCommandArgs(\n        argv.slice(1),\n        USAGE,\n      )\n      checkReplayCliArgs(commandArgs)\n    }, io)\n  }\n  if (isCloudReplayCommand(argv)) {\n    return runCloudReplayCommand(argv)\n  }\n  return runRegistryMain(() => runReplayCommand(argv, io), io)\n}\n\nrunIfEntrypoint(import.meta.url, () => runReplayMain(process.argv.slice(2)))\n"],"mappings":";;;AAAA,MAAa,oBACX;AAEF,SAAgB,qBAAqB,MAAkC;CACrE,OAAO,KAAK,MAAM,QAAQ,QAAQ,aAAa,IAAI,WAAW,UAAU,CAAC;AAC3E;AAEA,eAAsB,sBACpB,MACA,QACiB;CACjB,MAAM,CAAC,EAAE,SAAS,EAAE,mBAAmB,MAAM,QAAQ,IAAI,CACvD,OAAO,kBACP,OAAO,MACT,CAAC;CACD,MAAM,SACJ,UAAU,cAAc,IAAI,IAAI,qBAAqB,YAAY,GAAG,CAAC;CACvE,MAAM,gBAAgB;EACpB,QAAQ;EACR,GAAG,QAAQ,SAAS,QAAQ,SAAS,CAAC,qBAAqB,KAAK,IAAI,CAAC;EACrE,cAAc,IAAI,IAAI,kBAAkB,YAAY,GAAG,CAAC;CAC1D;CACA,MAAM,oBAAoB,CAAC;CAC3B,QAAQ,GAAG,UAAU,WAAW;CAChC,IAAI;EACF,OAAO,MAAM,IAAI,SAAiB,YAAY;GAC5C,MAAM,QAAQ,MAAM,WAAW,CAAC,QAAQ,GAAG,IAAI,GAAG;IAChD,OAAO;IACP,KAAK;KACH,GAAG,QAAQ;KACX,uBAAuB,KAAK,UAAU,aAAa;KACnD,qBAAqB;IACvB;GACF,CAAC;GACD,MAAM,GAAG,eAAe;IACtB,QAAQ,OAAO,MACb,sDACF;IACA,QAAQ,CAAC;GACX,CAAC;GACD,MAAM,GAAG,UAAU,MAAM,WACvB,QAAQ,SAAS,WAAW,WAAW,MAAM,EAAE,CACjD;EACF,CAAC;CACH,UAAU;EACR,QAAQ,IAAI,UAAU,WAAW;CACnC;AACF;;;ACtBA,MAAM,uBAAuB;AAE7B,MAAM,QAAQ,yUAAyU;AAEvV,eAAsB,iBACpB,MACA,KAAkB,CAAC,GACnB,WAA6B,gBAC8C;CAC3E,MAAM,EAAE,cAAc,gBAAgB,MAAM,yBAC1C,MACA,KACF;CACA,MAAM,WAAW,gBAAgB,MAAM,SAAS,YAAY,GAAG,YAAY;CAC3E,IAAI,YAAY,SAAS,QAAQ,GAC/B,OAAO,WAAW,UAAU,aAAa,EAAE;CAE7C,OAAO,aAAa,UAAU,aAAa,IAAI,YAAY;AAC7D;AAEA,eAAsB,cACpB,MACA,KAAkB,CAAC,GACF;CACjB,IAAI,KAAK,OAAO,sBACd,OAAO,gBAAgB,YAAY;EACjC,MAAM,EAAE,gBAAgB,MAAM,yBAC5B,KAAK,MAAM,CAAC,GACZ,KACF;EACA,mBAAmB,WAAW;CAChC,GAAG,EAAE;CAEP,IAAI,qBAAqB,IAAI,GAC3B,OAAO,sBAAsB,IAAI;CAEnC,OAAO,sBAAsB,iBAAiB,MAAM,EAAE,GAAG,EAAE;AAC7D;AAEA,gBAAgB,YAAY,WAAW,cAAc,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC"}

package/dist/seedCli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as runRegistryMain, c as runSeedCli, i as runIfEntrypoint, n as parseRegistryCommandArgs, r as resolveRegistry, t as importRegistry } from "./registryCommand-CWxt6kPp.js";
+import { a as runRegistryMain, c as runSeedCli, i as runIfEntrypoint, n as parseRegistryCommandArgs, r as resolveRegistry, t as importRegistry } from "./registryCommand-jPTSRgL9.js";
 //#region src/seedCli.ts
 const USAGE = "Usage: bitfab-seed --registry <path> <pipeline> --from-trace <id>[,<id>...]\n       bitfab-seed --registry <path> <pipeline> --cases <cases.jsonl> [--run]\nRun bitfab-seed --registry <path> <pipeline> --help for details.";
 async function runSeedCommand(argv, io = {}, importer = importRegistry) {

package/dist/{src-4VpSvoAt.cjs → src-C2OX1CHX.cjs}

@@ -1,5 +1,5 @@
 const require_bamlPeer = require("./bamlPeer-5Ohpq8q9.cjs");
-const require_http = require("./http-C9icRaA3.cjs");
+const require_http = require("./http-D2Rgpq7_.cjs");
 const require_autoTrace = require("./autoTrace-DPWV1Xzr.cjs");
 const require_optionalPeer = require("./optionalPeer-CUH756lt.cjs");
 let superjson = require("superjson");
@@ -3006,17 +3006,57 @@ var BitfabPiIntegration = class {
 };
 //#endregion
 //#region src/codeChange.ts
+const CODE_CHANGE_TYPES = [
+	"working-tree",
+	"last-branch",
+	"default-branch",
+	"skip",
+	"manual"
+];
+const CODE_CHANGE_CHOICES = "\"working-tree\" (uncommitted changes vs HEAD), \"last-branch\" (the diff against the branch this one was cut from), \"default-branch\" (the diff against the default branch), \"skip\" (no code change), or \"manual\" (pass the files yourself)";
+function isCodeChangeType(value) {
+	return CODE_CHANGE_TYPES.includes(value);
+}
+function validateCodeChange(request) {
+	const { codeChange, codeChangeDescription, codeChangeFiles } = request;
+	if (codeChange === void 0 || codeChange === null) throw new require_http.BitfabError(`replay needs a codeChange naming the code this run tests: ${CODE_CHANGE_CHOICES}.`);
+	if (!isCodeChangeType(codeChange)) throw new require_http.BitfabError(`Unknown codeChange ${JSON.stringify(codeChange)}. Pass ${CODE_CHANGE_CHOICES}.`);
+	const hasFiles = codeChangeFiles !== void 0 && codeChangeFiles !== null;
+	if (codeChange === "manual" && !hasFiles) throw new require_http.BitfabError("codeChange \"manual\" needs codeChangeFiles: the path and before/after contents of each edited file.");
+	if (codeChange !== "manual" && hasFiles) throw new require_http.BitfabError(`codeChangeFiles only applies with codeChange "manual" (got "${codeChange}").`);
+	if (codeChange === "skip" && codeChangeDescription !== void 0 && codeChangeDescription !== null) throw new require_http.BitfabError("codeChange \"skip\" attaches no code change, so it cannot take a codeChangeDescription.");
+	return codeChange;
+}
+async function resolveCodeChange(request, label) {
+	const codeChange = validateCodeChange(request);
+	const description = request.codeChangeDescription ?? void 0;
+	if (codeChange === "skip") return {};
+	if (codeChange === "manual") return {
+		description,
+		files: request.codeChangeFiles ?? []
+	};
+	const captured = await captureCodeChange(codeChange, label);
+	if (captured?.files === void 0 || captured.files.length === 0) {
+		try {
+			console.warn(`Bitfab: codeChange "${codeChange}" found no changed files, so this replay has no code change attached.`);
+		} catch {}
+		return { description };
+	}
+	return {
+		description: description ?? captured.description,
+		files: captured.files
+	};
+}
 const MAX_FILES = 60;
 const MAX_FILE_BYTES = 5e5;
 const MAX_TOTAL_BYTES = 2e6;
 const MAX_BRANCH_WALK = 1e3;
 const NUL = String.fromCharCode(0);
-async function resolveAutoCodeChange(label) {
+async function captureCodeChange(type, label) {
 	if (typeof process === "undefined") return null;
-	if (process.env?.BITFAB_DISABLE_CODE_CHANGE_CAPTURE) return null;
 	const fromEnv = await readCodeChangeFile();
 	if (fromEnv) return fromEnv;
-	return captureCodeChangeFromGit(process.cwd?.() ?? ".", label);
+	return captureCodeChangeFromGit(process.cwd?.() ?? ".", type, label);
 }
 async function readCodeChangeFile() {
 	const path = process.env?.BITFAB_CODE_CHANGE_PATH;
@@ -3035,7 +3075,7 @@ async function readCodeChangeFile() {
 		return null;
 	}
 }
-async function captureCodeChangeFromGit(cwd, label) {
+async function captureCodeChangeFromGit(cwd, type, label) {
 	let readFile;
 	try {
 		({readFile} = await import("fs/promises"));
@@ -3051,16 +3091,9 @@ async function captureCodeChangeFromGit(cwd, label) {
 	try {
 		const root = (await git(cwd, ["rev-parse", "--show-toplevel"]))?.trim();
 		if (!root) return null;
-		let resolved = await resolveBase(git, root);
+		const resolved = await resolveBase(git, root, type);
 		if (!resolved) return null;
-		let entries = await listChanges(git, root, resolved.base);
-		if (entries.length === 0 && resolved.base === "HEAD") {
-			const branchPoint = await resolveBranchPoint(git, root);
-			if (branchPoint) {
-				resolved = branchPoint;
-				entries = await listChanges(git, root, branchPoint.base);
-			}
-		}
+		const entries = await listChanges(git, root, resolved.base);
 		if (entries.length === 0) return null;
 		const { base, against } = resolved;
 		const blobBytes = async (ref, path) => {
@@ -3239,23 +3272,22 @@ async function resolveBranchPoint(git, root) {
 		against: `vs ${defaultBranch}`
 	} : null;
 }
-async function resolveBase(git, root) {
-	const forced = process.env?.BITFAB_CODE_CHANGE_BASE;
-	if (forced && await refExists(git, root, forced)) {
-		const base = (await git(root, [
-			"merge-base",
-			"HEAD",
-			forced
-		]))?.trim() || (await git(root, [
-			"rev-parse",
-			"--verify",
-			forced
-		]))?.trim() || null;
-		return base ? {
-			base,
-			against: `vs ${forced}`
-		} : null;
-	}
+async function resolveDefaultBranchPoint(git, root) {
+	const defaultBranch = await resolveDefaultBranch(git, root);
+	if (!defaultBranch) return null;
+	const base = (await git(root, [
+		"merge-base",
+		"HEAD",
+		defaultBranch
+	]))?.trim();
+	return base ? {
+		base,
+		against: `vs ${defaultBranch}`
+	} : null;
+}
+async function resolveBase(git, root, type) {
+	if (type === "last-branch") return resolveBranchPoint(git, root);
+	if (type === "default-branch") return resolveDefaultBranchPoint(git, root);
 	return await refExists(git, root, "HEAD") ? {
 		base: "HEAD",
 		against: "uncommitted (vs HEAD)"
@@ -3777,6 +3809,7 @@ const REPLAY_OPTION_NAMES = [
 	"notes",
 	"metadata",
 	"maxConcurrency",
+	"codeChange",
 	"codeChangeDescription",
 	"codeChangeFiles",
 	"mock",
@@ -4144,6 +4177,7 @@ function warnJudgeAssertionsDeprecated(write = console.warn) {
 	require_autoTrace.writeOnce("judgeAssertions-deprecated", JUDGE_ASSERTIONS_DEPRECATION_WARNING, write);
 }
 async function replay(httpClient, serviceUrl, traceFunctionKey, fn, options, registeredOverrides = []) {
+	const codeChangeType = validateCodeChange(options ?? {});
 	if (options?.judgeAssertions !== void 0) warnJudgeAssertionsDeprecated();
 	if (options?.resume !== void 0) validateResume(options.resume, options);
 	else if (options?.force === true) throw new require_http.BitfabError("force only applies when resuming an experiment. Pass it together with resume.");
@@ -4164,19 +4198,11 @@ async function replay(httpClient, serviceUrl, traceFunctionKey, fn, options, reg
 	const maxConcurrency = options?.maxConcurrency ?? 10;
 	if (!Number.isInteger(maxConcurrency) || maxConcurrency < 1) throw new require_http.BitfabError(`maxConcurrency must be a positive integer (got ${maxConcurrency}).`);
 	await require_http.replayContextReady;
-	let codeChangeDescription = options?.codeChangeDescription;
-	let codeChangeFiles = options?.codeChangeFiles;
-	if (codeChangeFiles === void 0) {
-		const captured = await resolveAutoCodeChange(options?.name);
-		if (captured) {
-			codeChangeFiles = captured.files;
-			if (codeChangeDescription === void 0) codeChangeDescription = captured.description;
-		}
-	}
+	const { description: codeChangeDescription, files: codeChangeFiles } = await resolveCodeChange(options, options.name);
 	const includeDbBranchLease = dbBranchEnabled(options?.dbBranch) && options?.dryRun !== true;
 	let session;
 	if (options?.resume === void 0) {
-		const started = await httpClient.startReplay(traceFunctionKey, options?.traceIds ? void 0 : options?.limit ?? 5, options?.traceIds, options?.name, codeChangeDescription, codeChangeFiles, includeDbBranchLease, options?.experimentGroupId, datasetIds, options?.graderIds, resolveDbBranchSettings(options?.dbBranch), requestedAttempts, options?.adaptInputs !== void 0, options?.onlyWithAssertions, options?.skipAssertionJudging === true || options?.judgeAssertions === false, options?.experimentalSelectiveReplay, options?.notes, options?.metadata, options?.dryRun === true, options?.experimentGroupName, safeReplayInvocation(() => buildReplayInvocation(Object.entries(cliFlags(options) ?? explicitReplayOptions(options)))));
+		const started = await httpClient.startReplay(traceFunctionKey, options?.traceIds ? void 0 : options?.limit ?? 5, options?.traceIds, options?.name, codeChangeDescription, codeChangeFiles, includeDbBranchLease, options?.experimentGroupId, datasetIds, options?.graderIds, resolveDbBranchSettings(options?.dbBranch), requestedAttempts, options?.adaptInputs !== void 0, options?.onlyWithAssertions, options?.skipAssertionJudging === true || options?.judgeAssertions === false, options?.experimentalSelectiveReplay, options?.notes, options?.metadata, options?.dryRun === true, options?.experimentGroupName, safeReplayInvocation(() => buildReplayInvocation(Object.entries(cliFlags(options) ?? explicitReplayOptions(options)))), codeChangeType);
 		if (started.items.length === 0) try {
 			console.warn(`Bitfab: no traces matched "${traceFunctionKey}", so this replay ran nothing. Capture a trace, or seed one with seedTrace, before replaying.`);
 		} catch {}
@@ -7012,7 +7038,7 @@ var Bitfab = class {
 			await runWithSeedContext({ traceId }, async () => target(...args));
 		} finally {
 			try {
-				const { flushTraces } = await Promise.resolve().then(() => require("./http-C9icRaA3.cjs")).then((n) => n.http_exports);
+				const { flushTraces } = await Promise.resolve().then(() => require("./http-D2Rgpq7_.cjs")).then((n) => n.http_exports);
 				await flushTraces(3e4);
 			} finally {
 				unrecorded = activeTraceStates.delete(traceId);
@@ -7218,7 +7244,7 @@ async function seedFromRegistry(registry, pipeline, cases, options = {}) {
 		metadata: seedCase.metadata,
 		sessionId: seedCase.sessionId
 	}));
-	const { flushTraces } = await Promise.resolve().then(() => require("./http-C9icRaA3.cjs")).then((n) => n.http_exports);
+	const { flushTraces } = await Promise.resolve().then(() => require("./http-D2Rgpq7_.cjs")).then((n) => n.http_exports);
 	await flushTraces(3e4);
 	return {
 		pipeline,
@@ -7468,4 +7494,4 @@ Object.defineProperty(exports, "serializeReplayResult", {
 	}
 });
 
-//# sourceMappingURL=src-4VpSvoAt.cjs.map
+//# sourceMappingURL=src-C2OX1CHX.cjs.map