@plune-ai/cli 0.30.1 → 0.31.0

package/dist/index.cjs

@@ -375,7 +375,7 @@ function normalizeProviderError(err, secret, envVar) {
 }
 
 // src/providers/retry.ts
-var defaultSleep = (ms) => new Promise((resolve5) => setTimeout(resolve5, ms));
+var defaultSleep = (ms) => new Promise((resolve6) => setTimeout(resolve6, ms));
 function retryAfterMs(err) {
   if (typeof err !== "object" || err === null || !("headers" in err)) return void 0;
   const raw = readHeader(err.headers, "retry-after");
@@ -1855,6 +1855,78 @@ function gateExit(verdict, runnerCode) {
   return n("failed") + n("broken") > 0 || notRun > 0 ? { code: 1, line: `plune: gate failed \u2014 ${said}` } : { code: 0, line: `plune: gate passed \u2014 ${said}` };
 }
 
+// src/cli/commands/job-reporter.ts
+var JOB_TIMEOUT_MS = 5e3;
+var JOB_SUBJECT_NAME_MAX = 200;
+var JOB_REASON_MAX = 2e3;
+var JobReporter = class {
+  constructor(doFetch, base, token, kind) {
+    this.doFetch = doFetch;
+    this.base = base;
+    this.token = token;
+    this.kind = kind;
+  }
+  doFetch;
+  base;
+  token;
+  kind;
+  id;
+  /** The upload's rows, the job's `total`; `null` while there are none to count. */
+  size = null;
+  /** The first report the platform did not take, for the CLI to say once. */
+  problem;
+  async send(method, route, body) {
+    try {
+      const res = await this.doFetch(`${this.base}/v1/jobs${route}`, {
+        method,
+        headers: { "content-type": "application/json", authorization: `Bearer ${this.token}` },
+        body: JSON.stringify(body),
+        signal: AbortSignal.timeout(JOB_TIMEOUT_MS)
+      });
+      const json = await res.json().catch(() => void 0);
+      if (res.ok) return json ?? {};
+      if (route === "" && (res.status === 404 || res.status === 405)) return void 0;
+      this.problem ??= `HTTP ${res.status}${typeof json?.error === "string" ? ` \u2014 ${json.error}` : ""}`;
+    } catch (err) {
+      this.problem ??= err instanceof Error ? err.message : String(err);
+    }
+    return void 0;
+  }
+  async open(subjectName, rows) {
+    this.size = Number.isInteger(rows) && rows > 0 ? rows : null;
+    const name = subjectName.trim().slice(0, JOB_SUBJECT_NAME_MAX);
+    const body = await this.send("POST", "", {
+      kind: this.kind,
+      ...name !== "" ? { subjectName: name } : {},
+      ...this.size !== null ? { progress: { done: 0, total: this.size } } : {}
+    });
+    if (typeof body?.id === "string") this.id = body.id;
+  }
+  /**
+   * The upload is in: every row is on the platform. `subjectId` is what the job works on, learnt from the upload's
+   * answer (the run an ingest landed in): the platform takes it while the job names none (#1279).
+   */
+  async uploaded(at) {
+    if (this.id === void 0) return;
+    await this.send("PATCH", `/${encodeURIComponent(this.id)}/progress`, {
+      done: this.size,
+      total: this.size,
+      ...at.cursor !== void 0 ? { cursor: at.cursor } : {},
+      ...at.subjectId !== void 0 ? { subjectId: at.subjectId } : {}
+    });
+  }
+  async finish(outcome) {
+    if (this.id === void 0) return;
+    const id = this.id;
+    this.id = void 0;
+    await this.send(
+      "PATCH",
+      `/${encodeURIComponent(id)}/state`,
+      outcome.ok ? { state: "completed" } : { state: "failed", reason: outcome.reason.slice(0, JOB_REASON_MAX) }
+    );
+  }
+};
+
 // src/cli/commands/sync.ts
 var NotLoggedInError = class extends Error {
   constructor() {
@@ -1892,58 +1964,6 @@ var SyncHttpError = class extends Error {
   }
   status;
 };
-var JOB_KIND = "cli-sync";
-var JOB_TIMEOUT_MS = 5e3;
-var JobReporter = class {
-  constructor(doFetch, base, token) {
-    this.doFetch = doFetch;
-    this.base = base;
-    this.token = token;
-  }
-  doFetch;
-  base;
-  token;
-  id;
-  async send(method, url, body) {
-    try {
-      const res = await this.doFetch(url, {
-        method,
-        headers: { "content-type": "application/json", authorization: `Bearer ${this.token}` },
-        body: JSON.stringify(body),
-        signal: AbortSignal.timeout(JOB_TIMEOUT_MS)
-      });
-      const json = await res.json().catch(() => void 0);
-      return res.ok ? json ?? {} : void 0;
-    } catch {
-      return void 0;
-    }
-  }
-  async open(subjectName) {
-    const body = await this.send("POST", `${this.base}/v1/jobs`, {
-      kind: JOB_KIND,
-      subjectName,
-      progress: 0
-    });
-    if (typeof body?.id === "string") this.id = body.id;
-  }
-  async report(progress, cursor) {
-    if (this.id === void 0) return;
-    await this.send("PATCH", `${this.base}/v1/jobs/${encodeURIComponent(this.id)}`, {
-      progress,
-      ...cursor !== void 0 ? { cursor } : {}
-    });
-  }
-  async finish(outcome) {
-    if (this.id === void 0) return;
-    const id = this.id;
-    this.id = void 0;
-    await this.send(
-      "PATCH",
-      `${this.base}/v1/jobs/${encodeURIComponent(id)}`,
-      outcome.ok ? { status: "succeeded", progress: 100 } : { status: "failed", reason: outcome.reason }
-    );
-  }
-};
 function readRun(cwd, file) {
   const target = file !== void 0 ? path5.resolve(cwd, file) : path5.join(cwd, ".plune", "last-run.json");
   let raw;
@@ -1985,11 +2005,12 @@ async function handleSync(deps = {}) {
   const payload = JSON.stringify(run);
   const idempotencyKey = (0, import_node_crypto2.createHash)("sha256").update(payload).digest("hex");
   const bearer = token;
-  const job = new JobReporter(doFetch, apiUrl, bearer);
-  await job.open(path5.basename(deps.file !== void 0 ? path5.resolve(cwd, deps.file) : cwd));
+  const job = new JobReporter(doFetch, apiUrl, bearer, "sync");
+  await job.open(path5.basename(deps.file !== void 0 ? path5.resolve(cwd, deps.file) : cwd), run.summary.total);
   try {
     const result = await upload();
     await job.finish({ ok: true });
+    if (job.problem !== void 0) result.jobProblem = job.problem;
     return result;
   } catch (err) {
     await job.finish({ ok: false, reason: err instanceof Error ? err.message : "Sync failed." });
@@ -2018,7 +2039,7 @@ async function handleSync(deps = {}) {
     const body = await res.json().catch(() => ({}));
     const id = typeof body.id === "string" ? body.id : "";
     const result = { id, url: `${endpoint}/${id}` };
-    await job.report(deps.failOnFailures === true ? 80 : 95, id || void 0);
+    await job.uploaded({ cursor: id || void 0 });
     if (deps.failOnFailures === true) {
       result.gate = gateExit(await readVerdict(doFetch, `${endpoint}/${id}/summary`, bearer));
     }
@@ -2046,6 +2067,9 @@ function reportSyncFailure(err, write) {
   return null;
 }
 
+// src/cli/commands/ingest.ts
+var path7 = __toESM(require("path"), 1);
+
 // src/cli/commands/cairn-artifact.ts
 var fs7 = __toESM(require("fs/promises"), 1);
 var path6 = __toESM(require("path"), 1);
@@ -2240,28 +2264,42 @@ async function handleIngest(deps) {
   const payload = await readCairnRun(dir);
   const doFetch = deps.fetchImpl ?? fetch;
   const endpoint = `${apiUrl}/v1/ingest/cairn`;
-  let res;
+  const job = new JobReporter(doFetch, apiUrl, token, "ingest");
+  await job.open(path7.basename(path7.resolve(dir)), payload.cases.length);
   try {
-    res = await doFetch(endpoint, {
-      method: "POST",
-      headers: { "content-type": "application/json", authorization: `Bearer ${token}` },
-      body: JSON.stringify(payload)
-    });
-  } catch {
-    throw new IngestNetworkError(apiUrl);
+    const result = await upload();
+    await job.uploaded({ subjectId: result.runId || void 0 });
+    await job.finish({ ok: true });
+    if (job.problem !== void 0) result.jobProblem = job.problem;
+    return result;
+  } catch (err) {
+    await job.finish({ ok: false, reason: err instanceof Error && err.message.trim() || "Ingest failed." });
+    throw err;
   }
-  if (!res.ok) {
-    const detail = await safeErrorDetail2(res);
-    if (res.status === 401) throw new IngestTokenRejectedError();
-    throw new IngestHttpError(res.status, detail);
+  async function upload() {
+    let res;
+    try {
+      res = await doFetch(endpoint, {
+        method: "POST",
+        headers: { "content-type": "application/json", authorization: `Bearer ${token}` },
+        body: JSON.stringify(payload)
+      });
+    } catch {
+      throw new IngestNetworkError(apiUrl);
+    }
+    if (!res.ok) {
+      const detail = await safeErrorDetail2(res);
+      if (res.status === 401) throw new IngestTokenRejectedError();
+      throw new IngestHttpError(res.status, detail);
+    }
+    const body = await res.json().catch(() => ({}));
+    return {
+      runId: typeof body.runId === "string" ? body.runId : "",
+      linked: typeof body.linked === "number" ? body.linked : 0,
+      proposed: typeof body.proposed === "number" ? body.proposed : 0,
+      skipped: typeof body.skipped === "number" ? body.skipped : 0
+    };
   }
-  const body = await res.json().catch(() => ({}));
-  return {
-    runId: typeof body.runId === "string" ? body.runId : "",
-    linked: typeof body.linked === "number" ? body.linked : 0,
-    proposed: typeof body.proposed === "number" ? body.proposed : 0,
-    skipped: typeof body.skipped === "number" ? body.skipped : 0
-  };
 }
 function reportIngestFailure(err, write) {
   if (err instanceof IngestNotLoggedInError || err instanceof IngestTokenRejectedError || err instanceof CairnRunNotFoundError || err instanceof NoCairnRunsError || err instanceof CairnRunVersionError || err instanceof CairnRunPartialError || err instanceof CairnEvidenceAmbiguousError) {

package/dist/index.d.cts

@@ -364,6 +364,8 @@ interface SyncResult {
         code: number;
         line: string;
     };
+    /** Why the platform's job queue did not take this sync's report: the first refusal or error. The upload went in. */
+    jobProblem?: string;
 }
 /**
  * Upload the latest (or `--file`) local run to `POST {apiUrl}/v1/runs` with the stored Bearer token.
@@ -688,6 +690,8 @@ interface IngestResult {
     linked: number;
     proposed: number;
     skipped: number;
+    /** Why the platform's job queue did not take this ingest's report: the first refusal or error. The run is recorded. */
+    jobProblem?: string;
 }
 declare function handleIngest(deps: IngestDeps): Promise<IngestResult>;
 /**

package/dist/index.d.ts

@@ -364,6 +364,8 @@ interface SyncResult {
         code: number;
         line: string;
     };
+    /** Why the platform's job queue did not take this sync's report: the first refusal or error. The upload went in. */
+    jobProblem?: string;
 }
 /**
  * Upload the latest (or `--file`) local run to `POST {apiUrl}/v1/runs` with the stored Bearer token.
@@ -688,6 +690,8 @@ interface IngestResult {
     linked: number;
     proposed: number;
     skipped: number;
+    /** Why the platform's job queue did not take this ingest's report: the first refusal or error. The run is recorded. */
+    jobProblem?: string;
 }
 declare function handleIngest(deps: IngestDeps): Promise<IngestResult>;
 /**

package/dist/index.js

@@ -315,7 +315,7 @@ function normalizeProviderError(err, secret, envVar) {
 }
 
 // src/providers/retry.ts
-var defaultSleep = (ms) => new Promise((resolve5) => setTimeout(resolve5, ms));
+var defaultSleep = (ms) => new Promise((resolve6) => setTimeout(resolve6, ms));
 function retryAfterMs(err) {
   if (typeof err !== "object" || err === null || !("headers" in err)) return void 0;
   const raw = readHeader(err.headers, "retry-after");
@@ -1795,6 +1795,78 @@ function gateExit(verdict, runnerCode) {
   return n("failed") + n("broken") > 0 || notRun > 0 ? { code: 1, line: `plune: gate failed \u2014 ${said}` } : { code: 0, line: `plune: gate passed \u2014 ${said}` };
 }
 
+// src/cli/commands/job-reporter.ts
+var JOB_TIMEOUT_MS = 5e3;
+var JOB_SUBJECT_NAME_MAX = 200;
+var JOB_REASON_MAX = 2e3;
+var JobReporter = class {
+  constructor(doFetch, base, token, kind) {
+    this.doFetch = doFetch;
+    this.base = base;
+    this.token = token;
+    this.kind = kind;
+  }
+  doFetch;
+  base;
+  token;
+  kind;
+  id;
+  /** The upload's rows, the job's `total`; `null` while there are none to count. */
+  size = null;
+  /** The first report the platform did not take, for the CLI to say once. */
+  problem;
+  async send(method, route, body) {
+    try {
+      const res = await this.doFetch(`${this.base}/v1/jobs${route}`, {
+        method,
+        headers: { "content-type": "application/json", authorization: `Bearer ${this.token}` },
+        body: JSON.stringify(body),
+        signal: AbortSignal.timeout(JOB_TIMEOUT_MS)
+      });
+      const json = await res.json().catch(() => void 0);
+      if (res.ok) return json ?? {};
+      if (route === "" && (res.status === 404 || res.status === 405)) return void 0;
+      this.problem ??= `HTTP ${res.status}${typeof json?.error === "string" ? ` \u2014 ${json.error}` : ""}`;
+    } catch (err) {
+      this.problem ??= err instanceof Error ? err.message : String(err);
+    }
+    return void 0;
+  }
+  async open(subjectName, rows) {
+    this.size = Number.isInteger(rows) && rows > 0 ? rows : null;
+    const name = subjectName.trim().slice(0, JOB_SUBJECT_NAME_MAX);
+    const body = await this.send("POST", "", {
+      kind: this.kind,
+      ...name !== "" ? { subjectName: name } : {},
+      ...this.size !== null ? { progress: { done: 0, total: this.size } } : {}
+    });
+    if (typeof body?.id === "string") this.id = body.id;
+  }
+  /**
+   * The upload is in: every row is on the platform. `subjectId` is what the job works on, learnt from the upload's
+   * answer (the run an ingest landed in): the platform takes it while the job names none (#1279).
+   */
+  async uploaded(at) {
+    if (this.id === void 0) return;
+    await this.send("PATCH", `/${encodeURIComponent(this.id)}/progress`, {
+      done: this.size,
+      total: this.size,
+      ...at.cursor !== void 0 ? { cursor: at.cursor } : {},
+      ...at.subjectId !== void 0 ? { subjectId: at.subjectId } : {}
+    });
+  }
+  async finish(outcome) {
+    if (this.id === void 0) return;
+    const id = this.id;
+    this.id = void 0;
+    await this.send(
+      "PATCH",
+      `/${encodeURIComponent(id)}/state`,
+      outcome.ok ? { state: "completed" } : { state: "failed", reason: outcome.reason.slice(0, JOB_REASON_MAX) }
+    );
+  }
+};
+
 // src/cli/commands/sync.ts
 var NotLoggedInError = class extends Error {
   constructor() {
@@ -1832,58 +1904,6 @@ var SyncHttpError = class extends Error {
   }
   status;
 };
-var JOB_KIND = "cli-sync";
-var JOB_TIMEOUT_MS = 5e3;
-var JobReporter = class {
-  constructor(doFetch, base, token) {
-    this.doFetch = doFetch;
-    this.base = base;
-    this.token = token;
-  }
-  doFetch;
-  base;
-  token;
-  id;
-  async send(method, url, body) {
-    try {
-      const res = await this.doFetch(url, {
-        method,
-        headers: { "content-type": "application/json", authorization: `Bearer ${this.token}` },
-        body: JSON.stringify(body),
-        signal: AbortSignal.timeout(JOB_TIMEOUT_MS)
-      });
-      const json = await res.json().catch(() => void 0);
-      return res.ok ? json ?? {} : void 0;
-    } catch {
-      return void 0;
-    }
-  }
-  async open(subjectName) {
-    const body = await this.send("POST", `${this.base}/v1/jobs`, {
-      kind: JOB_KIND,
-      subjectName,
-      progress: 0
-    });
-    if (typeof body?.id === "string") this.id = body.id;
-  }
-  async report(progress, cursor) {
-    if (this.id === void 0) return;
-    await this.send("PATCH", `${this.base}/v1/jobs/${encodeURIComponent(this.id)}`, {
-      progress,
-      ...cursor !== void 0 ? { cursor } : {}
-    });
-  }
-  async finish(outcome) {
-    if (this.id === void 0) return;
-    const id = this.id;
-    this.id = void 0;
-    await this.send(
-      "PATCH",
-      `${this.base}/v1/jobs/${encodeURIComponent(id)}`,
-      outcome.ok ? { status: "succeeded", progress: 100 } : { status: "failed", reason: outcome.reason }
-    );
-  }
-};
 function readRun(cwd, file) {
   const target = file !== void 0 ? path5.resolve(cwd, file) : path5.join(cwd, ".plune", "last-run.json");
   let raw;
@@ -1925,11 +1945,12 @@ async function handleSync(deps = {}) {
   const payload = JSON.stringify(run);
   const idempotencyKey = createHash2("sha256").update(payload).digest("hex");
   const bearer = token;
-  const job = new JobReporter(doFetch, apiUrl, bearer);
-  await job.open(path5.basename(deps.file !== void 0 ? path5.resolve(cwd, deps.file) : cwd));
+  const job = new JobReporter(doFetch, apiUrl, bearer, "sync");
+  await job.open(path5.basename(deps.file !== void 0 ? path5.resolve(cwd, deps.file) : cwd), run.summary.total);
   try {
     const result = await upload();
     await job.finish({ ok: true });
+    if (job.problem !== void 0) result.jobProblem = job.problem;
     return result;
   } catch (err) {
     await job.finish({ ok: false, reason: err instanceof Error ? err.message : "Sync failed." });
@@ -1958,7 +1979,7 @@ async function handleSync(deps = {}) {
     const body = await res.json().catch(() => ({}));
     const id = typeof body.id === "string" ? body.id : "";
     const result = { id, url: `${endpoint}/${id}` };
-    await job.report(deps.failOnFailures === true ? 80 : 95, id || void 0);
+    await job.uploaded({ cursor: id || void 0 });
     if (deps.failOnFailures === true) {
       result.gate = gateExit(await readVerdict(doFetch, `${endpoint}/${id}/summary`, bearer));
     }
@@ -1986,6 +2007,9 @@ function reportSyncFailure(err, write) {
   return null;
 }
 
+// src/cli/commands/ingest.ts
+import * as path7 from "path";
+
 // src/cli/commands/cairn-artifact.ts
 import * as fs7 from "fs/promises";
 import * as path6 from "path";
@@ -2180,28 +2204,42 @@ async function handleIngest(deps) {
   const payload = await readCairnRun(dir);
   const doFetch = deps.fetchImpl ?? fetch;
   const endpoint = `${apiUrl}/v1/ingest/cairn`;
-  let res;
+  const job = new JobReporter(doFetch, apiUrl, token, "ingest");
+  await job.open(path7.basename(path7.resolve(dir)), payload.cases.length);
   try {
-    res = await doFetch(endpoint, {
-      method: "POST",
-      headers: { "content-type": "application/json", authorization: `Bearer ${token}` },
-      body: JSON.stringify(payload)
-    });
-  } catch {
-    throw new IngestNetworkError(apiUrl);
+    const result = await upload();
+    await job.uploaded({ subjectId: result.runId || void 0 });
+    await job.finish({ ok: true });
+    if (job.problem !== void 0) result.jobProblem = job.problem;
+    return result;
+  } catch (err) {
+    await job.finish({ ok: false, reason: err instanceof Error && err.message.trim() || "Ingest failed." });
+    throw err;
   }
-  if (!res.ok) {
-    const detail = await safeErrorDetail2(res);
-    if (res.status === 401) throw new IngestTokenRejectedError();
-    throw new IngestHttpError(res.status, detail);
+  async function upload() {
+    let res;
+    try {
+      res = await doFetch(endpoint, {
+        method: "POST",
+        headers: { "content-type": "application/json", authorization: `Bearer ${token}` },
+        body: JSON.stringify(payload)
+      });
+    } catch {
+      throw new IngestNetworkError(apiUrl);
+    }
+    if (!res.ok) {
+      const detail = await safeErrorDetail2(res);
+      if (res.status === 401) throw new IngestTokenRejectedError();
+      throw new IngestHttpError(res.status, detail);
+    }
+    const body = await res.json().catch(() => ({}));
+    return {
+      runId: typeof body.runId === "string" ? body.runId : "",
+      linked: typeof body.linked === "number" ? body.linked : 0,
+      proposed: typeof body.proposed === "number" ? body.proposed : 0,
+      skipped: typeof body.skipped === "number" ? body.skipped : 0
+    };
   }
-  const body = await res.json().catch(() => ({}));
-  return {
-    runId: typeof body.runId === "string" ? body.runId : "",
-    linked: typeof body.linked === "number" ? body.linked : 0,
-    proposed: typeof body.proposed === "number" ? body.proposed : 0,
-    skipped: typeof body.skipped === "number" ? body.skipped : 0
-  };
 }
 function reportIngestFailure(err, write) {
   if (err instanceof IngestNotLoggedInError || err instanceof IngestTokenRejectedError || err instanceof CairnRunNotFoundError || err instanceof NoCairnRunsError || err instanceof CairnRunVersionError || err instanceof CairnRunPartialError || err instanceof CairnEvidenceAmbiguousError) {

package/dist/reporter-core.cjs

@@ -315,6 +315,25 @@ function shardOf(env) {
     error: `PLUNE_SHARD=${JSON.stringify(raw.slice(0, 40))} is not "k/N" with 1 <= k <= N <= ${SHARDS_MAX} (for example 2/4) - nothing was sent.`
   };
 }
+function configurationOf(env) {
+  const raw = value(env, "PLUNE_CONFIGURATION");
+  if (raw === void 0) return {};
+  const pairs = [];
+  for (const pair of raw.split(";").map((s) => s.trim()).filter((s) => s !== "")) {
+    const at = pair.indexOf("=");
+    const name = at < 0 ? "" : pair.slice(0, at).trim();
+    const label = at < 0 ? "" : pair.slice(at + 1).trim();
+    const twice = pairs.find(([seen]) => seen.toLowerCase() === name.toLowerCase());
+    const why = at < 0 ? 'has no "="' : name === "" ? "has no group name" : label === "" ? "has no value" : twice !== void 0 ? `names the group ${JSON.stringify(twice[0])} a second time` : void 0;
+    if (why !== void 0) {
+      return {
+        error: `PLUNE_CONFIGURATION: ${JSON.stringify(pair.slice(0, 40))} ${why} - write it as "Group=Value;Group=Value" (for example "Browser=Chrome;Operating system=Windows") - nothing was sent.`
+      };
+    }
+    pairs.push([name, label]);
+  }
+  return pairs.length === 0 ? {} : { configuration: Object.fromEntries(pairs) };
+}
 var UPLOAD_CONCURRENCY = { min: 1, max: 32, default: 16 };
 var UPLOAD_RETRIES = { min: 0, max: 20, default: 6 };
 var IMPORT_TIMEOUT = { min: 0, max: 86400, default: 600 };
@@ -362,6 +381,7 @@ function readEnv(env = process.env) {
   const offerDiscovered = flag(env, "PLUNE_CREATE");
   const full = flag(env, "PLUNE_FULL_RUN");
   const { shard, error: shardError } = shardOf(env);
+  const { configuration, error: configurationError } = configurationOf(env);
   return {
     config: {
       ...externalKey !== void 0 ? { externalKey } : {},
@@ -374,6 +394,7 @@ function readEnv(env = process.env) {
       ...title !== void 0 ? { title } : {},
       ...environment !== void 0 ? { environment } : {},
       ...labels !== void 0 ? { labels } : {},
+      ...configuration !== void 0 ? { configuration } : {},
       // Only when set: `false` here would outrank a config file that asked for it, and an unset
       // variable is not an instruction.
       ...offerDiscovered ? { offerDiscovered } : {},
@@ -387,6 +408,7 @@ function readEnv(env = process.env) {
     keepOpen: flag(env, "PLUNE_SHARED_RUN") || flag(env, "PLUNE_PROCEED") || shard !== void 0 || shardError !== void 0,
     ...shard !== void 0 ? { shard } : {},
     ...shardError !== void 0 ? { shardError } : {},
+    ...configurationError !== void 0 ? { configurationError } : {},
     ...importTimeout !== void 0 ? { importTimeout } : {},
     ignored: UNSUPPORTED_VARS.filter((name) => value(env, name) !== void 0),
     warnings
@@ -597,6 +619,7 @@ function appendBatch(file, batch) {
     externalKey: batch.externalKey,
     ...batch.session !== void 0 ? { session: batch.session } : {},
     ...batch.meta !== void 0 ? { meta: batch.meta } : {},
+    ...batch.configuration !== void 0 ? { configuration: batch.configuration } : {},
     results: batch.results
   };
   fs.appendFileSync(file, `${JSON.stringify(line)}
@@ -747,8 +770,10 @@ function warnIfDropped(sent, run, log) {
 async function startRun(passed, declared) {
   const env = readEnv();
   if (env.shardError !== void 0) throw new Error(env.shardError);
+  if (env.configurationError !== void 0 && passed.configuration === void 0) throw new Error(env.configurationError);
   const stated = Object.fromEntries(Object.entries(passed).filter(([, v]) => v !== void 0));
   const cfg = { ...env.config, ...stated };
+  const configuration = cfg.configuration !== void 0 && Object.keys(cfg.configuration).length > 0 ? cfg.configuration : void 0;
   const log = cfg.log ?? ((line) => void process.stderr.write(`${line}
 `));
   const fallbackPath = cfg.fallbackPath ?? DEFAULT_FALLBACK_PATH;
@@ -832,6 +857,7 @@ async function startRun(passed, declared) {
       externalKey,
       session: sessionMarker,
       ...cfg.meta !== void 0 ? { meta: cfg.meta } : {},
+      ...configuration !== void 0 ? { configuration } : {},
       results: results.map(onDisk)
     });
     stats.deferred += results.length;
@@ -856,7 +882,7 @@ async function startRun(passed, declared) {
   if (!offline) {
     if (expected !== void 0) await resolveKeys(expected.flat());
     const stated2 = expected?.slice(0, EXPECTED_MAX) ?? [];
-    const configuration = stated2.length === 0 ? void 0 : {
+    const configuration2 = stated2.length === 0 ? void 0 : {
       expected: stated2.flatMap((keys) => {
         const hit = keys.map((k) => resolved.get(k.value)).find((v) => typeof v === "string");
         if (typeof hit === "string") return [{ testCaseId: hit }];
@@ -880,7 +906,7 @@ async function startRun(passed, declared) {
       kind: cfg.kind ?? "automated",
       ...externalKey !== null ? { externalKey } : {},
       ...cfg.meta !== void 0 ? { meta: cfg.meta } : {},
-      ...configuration !== void 0 ? { configuration } : {},
+      ...configuration2 !== void 0 ? { configuration: configuration2 } : {},
       // Named even when nobody named it — the list has to read without opening a row. Only what
       // the caller DESCRIBED goes to `warnIfDropped` below: a title this side invented is not one
       // a person will miss, and a deployment older than the field must not be nagged on every run.
@@ -888,7 +914,7 @@ async function startRun(passed, declared) {
       ...described
     };
     let start = await client.post("/v1/runs", request);
-    if (!start.ok && start.status === 413 && configuration !== void 0) {
+    if (!start.ok && start.status === 413 && configuration2 !== void 0) {
       log(
         `plune: the platform refused the run's list of expected tests as too large (${start.detail || start.kind}) \u2014 starting without it: the results still land, but this run counts no tests that did not run, and claims no full run.`
       );
@@ -1434,7 +1460,8 @@ async function startRun(passed, declared) {
       }
       const out = await client.post(
         `/v1/runs/${runId}/results`,
-        { results: part }
+        // The job's combination on every batch (plune-ai/plune#1251); a refusal of it is a 422 said below as it came.
+        { results: part, ...configuration !== void 0 ? { configuration } : {} }
       );
       const counts = out.ok ? out.body?.counts : void 0;
       const told = COUNTED.filter((k) => typeof counts?.[k] === "number");

package/dist/reporter-core.d.cts

@@ -324,6 +324,12 @@ interface ReporterConfig {
     environment?: string;
     /** How the run is marked — smoke, nightly, a team. */
     labels?: string[];
+    /**
+     * The combination this job runs, group name → value label (`PLUNE_CONFIGURATION`, plune-ai/plune#1251):
+     * sent as `configuration` on every results batch. Not the run's own `configuration` (what it expects).
+     * Stated, it is all there is: the variable is not read, and `{}` sends none (what a replay passes for a line that recorded none).
+     */
+    configuration?: Record<string, string>;
     /** Results per request. The platform's ceiling is 500. */
     batchSize?: number;
     /** Files in flight at once (`PLUNE_UPLOAD_CONCURRENCY`, 1 to 32, default 16). */
@@ -445,6 +451,8 @@ interface EnvSettings {
     shard?: ShardOf;
     /** `PLUNE_SHARD` was set to something that is not `k/N`. A configuration error: the caller refuses to start. */
     shardError?: string;
+    /** `PLUNE_CONFIGURATION` was set to something that is not `Group=Value;…`. Refused the same way. */
+    configurationError?: string;
     /** `PLUNE_IMPORT_TIMEOUT` in seconds, when set and usable. */
     importTimeout?: number;
     /** Variables that were set and have nowhere to land. The caller says so once. */
@@ -498,12 +506,17 @@ declare const DEFAULT_FALLBACK_PATH: string;
  * A run of 24 tests at a batch of 10 is three lines, and replay opens one run for the lines that share a
  * marker rather than one for each. A line written before the field existed has none, and is one run's
  * worth by itself — nothing in it says otherwise.
+ *
+ * `configuration` is the combination the job named (`PLUNE_CONFIGURATION`, plune-ai/plune#1251), recorded for
+ * the same reason as `meta`: replay sends the batch into the combination it ran in, whatever the machine that
+ * replays it has set. A line without it was written by a job that named none, or before the field existed.
  */
 interface DeferredBatch {
     runId: string | null;
     externalKey: string | null;
     session?: string;
     meta?: RunMeta;
+    configuration?: Record<string, string>;
     results: DeferredResult[];
 }
 /**