A desktop coding agent with free access to frontier models.
TypeScript
feat(capture): describe bounded reproducibility evidence
Task Builder984d4a953c3c
diff --git a/apps/server/src/session-uploader.ts b/apps/server/src/session-uploader.tsindex d33c339f..3bdb971d 100644--- a/apps/server/src/session-uploader.ts+++ b/apps/server/src/session-uploader.ts@@ -231,8 +231,34 @@ export type UploadEnvironment = {git_version: string | null;/** Exact toolchain versions of the session's project (toolchain.ts); absent on older clients. */toolchain?: UploadToolchain;+ /** What is and is not covered by this capture, without adding capture work. */+ reproducibility?: UploadReproducibility;};+/**+ * Compact evidence about what the uploader already captured. Building this+ * object is synchronous and performs no file reads, commands, or uploads.+ */+export type UploadReproducibility = {+ schema: 1;+ capture: "bounded_existing_data";+ workspace: "archive_and_turn_diffs";+ dependencies: {+ manifests: string[];+ lockfiles: string[];+ toolchain_recorded: boolean;+ };+ external: "metadata_only";+ replay: "not_verified";+ performance: {+ extra_scans: 0;+ extra_commands: 0;+ extra_uploads: 0;+ };+ limitations: string[];+};++type TraceEvent = {at: string;type: string;@@ -4032,6 +4058,30 @@ async function gitSkippedField(): Promise<{ git_skipped?: string }> {return reason ? { git_skipped: reason } : {};}+function reproducibilityEvidence(toolchain: UploadToolchain | null): UploadReproducibility {+ return {+ schema: 1,+ capture: "bounded_existing_data",+ workspace: "archive_and_turn_diffs",+ dependencies: {+ manifests: toolchain?.manifests.slice(0, 64) ?? [],+ lockfiles: toolchain?.lockfiles.slice(0, 64) ?? [],+ toolchain_recorded: Boolean(toolchain),+ },+ external: "metadata_only",+ replay: "not_verified",+ performance: {+ extra_scans: 0,+ extra_commands: 0,+ extra_uploads: 0,+ },+ limitations: [+ "external services and network state are metadata-only",+ "replay verification is not performed during capture",+ ],+ };+}+function uploadEnvironment(appVersion: string | undefined, engineVersion: string | undefined, gitVersion: string | null): UploadEnvironment {let locale: string | null = null;let timezone: string | null = null;@@ -4457,7 +4507,11 @@ export class SessionUploader {private async sessionEnvironment(root: string, waitMs?: number): Promise<UploadEnvironment> {const environment = await this.environment();const toolchain = this.toolchains ? await this.toolchains.get(root, waitMs).catch(() => null) : null;- return toolchain ? { ...environment, toolchain } : environment;+ return {+ ...environment,+ ...(toolchain ? { toolchain } : {}),+ reproducibility: reproducibilityEvidence(toolchain),+ };}private negotiatedTraceSchema(force = false): Promise<2 | 3> {diff --git a/apps/server/src/toolchain.test.ts b/apps/server/src/toolchain.test.tsindex a4fd096d..7762b70c 100644--- a/apps/server/src/toolchain.test.ts+++ b/apps/server/src/toolchain.test.ts@@ -317,6 +317,9 @@ test.skipIf(!hasZstd)("the upload envelope carries environment.toolchain, scrubbassert.deepEqual(environment.toolchain.pip_freeze, ["attrs==24.2.0", "secretpkg @ url"]);assert.deepEqual(environment.toolchain.manifests, ["package.json", "requirements.txt"]);assert.equal(environment.toolchain.python_executable_kind, "system");+ assert.deepEqual(environment.reproducibility.dependencies.manifests, ["package.json", "requirements.txt"]);+ assert.equal(environment.reproducibility.dependencies.toolchain_recorded, true);+ assert.equal(environment.reproducibility.performance.extra_scans, 0);assert.ok(!JSON.stringify(environment.toolchain).includes("hunter2"));for (const envelope of envelopes) {if (envelope.environment.toolchain) assert.deepEqual(envelope.environment.toolchain, environment.toolchain);@@ -328,6 +331,12 @@ test.skipIf(!hasZstd)("toolchain: false sends the environment block as before",assert.ok(envelopes.length >= 1);assert.equal("toolchain" in envelopes[0].environment, false);assert.equal(typeof envelopes[0].environment.os, "string");+ assert.equal(envelopes[0].environment.reproducibility.dependencies.toolchain_recorded, false);+ assert.deepEqual(envelopes[0].environment.reproducibility.performance, {+ extra_scans: 0,+ extra_commands: 0,+ extra_uploads: 0,+ });});test.skipIf(!hasZstd)("an upload never waits for a slow collection: the start envelope goes without it, a later one carries it", async () => {