@plune-ai/cli 0.15.0 → 0.16.0

package/dist/index.cjs

@@ -414,11 +414,25 @@ async function withRetry(fn, options) {
 
 // src/providers/prices.ts
 var PRICE_TABLE = {
-  // Anthropic
+  // Anthropic, current models. Source: platform.claude.com/docs/en/about-claude/pricing — base
+  // input and output tokens per million, read on 2026-09-29, kept here per thousand.
+  "claude-fable-5-1": { input_per_1k_usd: 0.01, output_per_1k_usd: 0.05 },
+  "claude-opus-5-5": { input_per_1k_usd: 4e-3, output_per_1k_usd: 0.02 },
+  "claude-sonnet-5-5": { input_per_1k_usd: 2e-3, output_per_1k_usd: 0.01 },
+  "claude-haiku-4-5": { input_per_1k_usd: 1e-3, output_per_1k_usd: 5e-3 },
+  // The dated id of the same model; a config may name either.
+  "claude-haiku-4-5-20251001": { input_per_1k_usd: 1e-3, output_per_1k_usd: 5e-3 },
+  // Anthropic, older ids: unchanged, so a config that still names one prices as it did. Anthropic has
+  // retired these models — a new project should not start on them.
   "claude-3-5-haiku-latest": { input_per_1k_usd: 8e-4, output_per_1k_usd: 4e-3 },
   "claude-3-5-sonnet-latest": { input_per_1k_usd: 3e-3, output_per_1k_usd: 0.015 },
   "claude-3-opus-latest": { input_per_1k_usd: 0.015, output_per_1k_usd: 0.075 },
-  // OpenAI
+  // OpenAI, current models. Source: developers.openai.com/api/docs/pricing — standard tier, the
+  // short-context rates (a long-context request costs more), read on 2026-09-29.
+  "gpt-6-astra": { input_per_1k_usd: 0.01, output_per_1k_usd: 0.05 },
+  "gpt-6.1-sol": { input_per_1k_usd: 2e-3, output_per_1k_usd: 0.01 },
+  "gpt-6-luna": { input_per_1k_usd: 1e-4, output_per_1k_usd: 5e-4 },
+  // OpenAI, older ids: unchanged (the same rates the page above still lists for both).
   "gpt-4o": { input_per_1k_usd: 25e-4, output_per_1k_usd: 0.01 },
   "gpt-4o-mini": { input_per_1k_usd: 15e-5, output_per_1k_usd: 6e-4 },
   // OpenAI via OpenRouter (namespaced ids). OpenRouter passes OpenAI list price through for
@@ -607,6 +621,18 @@ function getProvider(config, env, pricing) {
   return createDefaultRegistry().resolve(config.type, config, env, pricing);
 }
 
+// src/providers/estimate.ts
+function makeEstimateProvider(config, pricing) {
+  return {
+    complete: () => Promise.reject(
+      new Error("The --dry-run provider only estimates cost; it never calls a model.")
+    ),
+    estimateCost: (usage, reportedCostUsd) => ({
+      cost_usd: resolveCost(usage, config.model, reportedCostUsd, pricing)
+    })
+  };
+}
+
 // src/providers/mock.ts
 function makeMockProvider() {
   return {
@@ -1473,11 +1499,16 @@ var NOOP_CACHE = { get: () => void 0, set: () => {
 function isMockMode(env) {
   return env["PLUNE_MOCK_PROVIDER"] === "1";
 }
+function resolveProviderFor(config, dryRun) {
+  if (isMockMode(process.env)) return () => makeMockProvider();
+  if (dryRun) return (cfg) => makeEstimateProvider(cfg, config.pricing);
+  return (cfg) => getProvider(cfg, process.env, config.pricing);
+}
 function buildRealDeps(config, baseDir, dryRun) {
   const dir = path4.join(baseDir, ".plune");
   fs5.mkdirSync(dir, { recursive: true });
   return {
-    resolveProvider: isMockMode(process.env) ? () => makeMockProvider() : (cfg) => getProvider(cfg, process.env, config.pricing),
+    resolveProvider: resolveProviderFor(config, dryRun),
     embedder: getDefaultEmbedder(),
     cache: dryRun ? NOOP_CACHE : openCache(path4.join(dir, "cache.db")),
     now: Date.now,

package/dist/index.js

@@ -361,11 +361,25 @@ async function withRetry(fn, options) {
 
 // src/providers/prices.ts
 var PRICE_TABLE = {
-  // Anthropic
+  // Anthropic, current models. Source: platform.claude.com/docs/en/about-claude/pricing — base
+  // input and output tokens per million, read on 2026-09-29, kept here per thousand.
+  "claude-fable-5-1": { input_per_1k_usd: 0.01, output_per_1k_usd: 0.05 },
+  "claude-opus-5-5": { input_per_1k_usd: 4e-3, output_per_1k_usd: 0.02 },
+  "claude-sonnet-5-5": { input_per_1k_usd: 2e-3, output_per_1k_usd: 0.01 },
+  "claude-haiku-4-5": { input_per_1k_usd: 1e-3, output_per_1k_usd: 5e-3 },
+  // The dated id of the same model; a config may name either.
+  "claude-haiku-4-5-20251001": { input_per_1k_usd: 1e-3, output_per_1k_usd: 5e-3 },
+  // Anthropic, older ids: unchanged, so a config that still names one prices as it did. Anthropic has
+  // retired these models — a new project should not start on them.
   "claude-3-5-haiku-latest": { input_per_1k_usd: 8e-4, output_per_1k_usd: 4e-3 },
   "claude-3-5-sonnet-latest": { input_per_1k_usd: 3e-3, output_per_1k_usd: 0.015 },
   "claude-3-opus-latest": { input_per_1k_usd: 0.015, output_per_1k_usd: 0.075 },
-  // OpenAI
+  // OpenAI, current models. Source: developers.openai.com/api/docs/pricing — standard tier, the
+  // short-context rates (a long-context request costs more), read on 2026-09-29.
+  "gpt-6-astra": { input_per_1k_usd: 0.01, output_per_1k_usd: 0.05 },
+  "gpt-6.1-sol": { input_per_1k_usd: 2e-3, output_per_1k_usd: 0.01 },
+  "gpt-6-luna": { input_per_1k_usd: 1e-4, output_per_1k_usd: 5e-4 },
+  // OpenAI, older ids: unchanged (the same rates the page above still lists for both).
   "gpt-4o": { input_per_1k_usd: 25e-4, output_per_1k_usd: 0.01 },
   "gpt-4o-mini": { input_per_1k_usd: 15e-5, output_per_1k_usd: 6e-4 },
   // OpenAI via OpenRouter (namespaced ids). OpenRouter passes OpenAI list price through for
@@ -554,6 +568,18 @@ function getProvider(config, env, pricing) {
   return createDefaultRegistry().resolve(config.type, config, env, pricing);
 }
 
+// src/providers/estimate.ts
+function makeEstimateProvider(config, pricing) {
+  return {
+    complete: () => Promise.reject(
+      new Error("The --dry-run provider only estimates cost; it never calls a model.")
+    ),
+    estimateCost: (usage, reportedCostUsd) => ({
+      cost_usd: resolveCost(usage, config.model, reportedCostUsd, pricing)
+    })
+  };
+}
+
 // src/providers/mock.ts
 function makeMockProvider() {
   return {
@@ -1420,11 +1446,16 @@ var NOOP_CACHE = { get: () => void 0, set: () => {
 function isMockMode(env) {
   return env["PLUNE_MOCK_PROVIDER"] === "1";
 }
+function resolveProviderFor(config, dryRun) {
+  if (isMockMode(process.env)) return () => makeMockProvider();
+  if (dryRun) return (cfg) => makeEstimateProvider(cfg, config.pricing);
+  return (cfg) => getProvider(cfg, process.env, config.pricing);
+}
 function buildRealDeps(config, baseDir, dryRun) {
   const dir = path4.join(baseDir, ".plune");
   fs5.mkdirSync(dir, { recursive: true });
   return {
-    resolveProvider: isMockMode(process.env) ? () => makeMockProvider() : (cfg) => getProvider(cfg, process.env, config.pricing),
+    resolveProvider: resolveProviderFor(config, dryRun),
     embedder: getDefaultEmbedder(),
     cache: dryRun ? NOOP_CACHE : openCache(path4.join(dir, "cache.db")),
     now: Date.now,

package/dist/reporter-core.cjs

@@ -34,6 +34,7 @@ __export(reporter_core_exports, {
   RESULT_KEY_MAX: () => RESULT_KEY_MAX,
   UNSUPPORTED_VARS: () => UNSUPPORTED_VARS,
   appendBatch: () => appendBatch,
+  ciCommit: () => ciCommit,
   createClient: () => createClient,
   errorContextOf: () => errorContextOf,
   failureOf: () => failureOf,
@@ -247,6 +248,28 @@ function defaultRunTitle(env = process.env, now = /* @__PURE__ */ new Date(), cw
   const where = flag(env, "CI") || flag(env, "GITHUB_ACTIONS") ? "ci" : "local";
   return `${path.basename(cwd)} \xB7 ${stamp} \xB7 ${where}`;
 }
+var PROVIDERS = [
+  { is: "GITHUB_ACTIONS", sha: "GITHUB_SHA", branch: ["GITHUB_HEAD_REF", "GITHUB_REF_NAME"] },
+  { is: "GITLAB_CI", sha: "CI_COMMIT_SHA", branch: ["CI_COMMIT_REF_NAME"] },
+  { is: "JENKINS_URL", sha: "GIT_COMMIT", branch: ["GIT_BRANCH"] }
+];
+function ciCommit(reported, env = process.env) {
+  const said = typeof reported === "object" && reported !== null ? reported : {};
+  const text = (raw) => typeof raw === "string" && raw.trim() !== "" ? raw.trim() : void 0;
+  const provider = PROVIDERS.find((p) => value(env, p.is) !== void 0);
+  const job = {
+    sha: provider === void 0 ? void 0 : value(env, provider.sha),
+    branch: provider?.branch.map((name) => value(env, name)).find((v) => v !== void 0)
+  };
+  const sha = text(said["commitHash"]);
+  const sameCommit = sha === void 0 || sha === job.sha;
+  const commit = sha ?? job.sha;
+  const branch = text(said["branch"]) ?? (sameCommit ? job.branch : void 0);
+  return {
+    ...commit !== void 0 ? { sha: commit } : {},
+    ...branch !== void 0 ? { branch } : {}
+  };
+}
 
 // src/reporter-core/fallback.ts
 var fs = __toESM(require("fs"), 1);
@@ -258,6 +281,8 @@ function appendBatch(file, batch) {
     ts: (/* @__PURE__ */ new Date()).toISOString(),
     runId: batch.runId,
     externalKey: batch.externalKey,
+    ...batch.session !== void 0 ? { session: batch.session } : {},
+    ...batch.meta !== void 0 ? { meta: batch.meta } : {},
     results: batch.results
   };
   fs.appendFileSync(file, `${JSON.stringify(line)}
@@ -311,6 +336,12 @@ function boundKey(key) {
   if (/[\uD800-\uDBFF]$/.test(head)) head = head.slice(0, -1);
   return { ...key, value: `${head}#${digest}` };
 }
+function whyUnoffered(out) {
+  if (out.ok || out.status !== 429) return "other";
+  if (/review queue quota reached/i.test(out.detail)) return "queue";
+  if (/test case quota reached/i.test(out.detail)) return "cases";
+  return "other";
+}
 function boundTitle(title) {
   return title.length <= TITLE_MAX ? title : `${title.slice(0, TITLE_MAX - 1)}\u2026`;
 }
@@ -354,6 +385,7 @@ async function startRun(passed, declared) {
 `));
   const fallbackPath = cfg.fallbackPath ?? DEFAULT_FALLBACK_PATH;
   const externalKey = cfg.externalKey ?? null;
+  const sessionMarker = (0, import_node_crypto.randomUUID)();
   const batchSize = Math.min(cfg.batchSize ?? BATCH_DEFAULT, BATCH_MAX);
   const offerDiscovered = cfg.offerDiscovered ?? false;
   const token = cfg.token ?? loadToken() ?? "";
@@ -405,7 +437,13 @@ async function startRun(passed, declared) {
     log(`plune: ignoring ${env.ignored.join(", ")} \u2014 a run has nowhere to store them yet.`);
   }
   function defer(results) {
-    appendBatch(fallbackPath, { runId, externalKey, results });
+    appendBatch(fallbackPath, {
+      runId,
+      externalKey,
+      session: sessionMarker,
+      ...cfg.meta !== void 0 ? { meta: cfg.meta } : {},
+      results
+    });
     stats.deferred += results.length;
   }
   async function resolveKeys(values) {
@@ -502,6 +540,7 @@ async function startRun(passed, declared) {
       });
       if (!out.ok || !Array.isArray(out.body?.results)) {
         stats.unoffered = batches.slice(index).reduce((n, rest) => n + rest.length, 0);
+        stats.unofferedWhy = whyUnoffered(out);
         log(
           `plune: could not offer ${stats.unoffered} unknown test(s) for review (${out.ok ? "the answer had no results" : out.detail || out.kind}).`
         );
@@ -844,6 +883,7 @@ function webLink(href) {
   RESULT_KEY_MAX,
   UNSUPPORTED_VARS,
   appendBatch,
+  ciCommit,
   createClient,
   errorContextOf,
   failureOf,

package/dist/reporter-core.d.cts

@@ -200,6 +200,12 @@ interface ExpectedEntry {
     testCaseId?: string;
     externalKey?: KeyRef;
 }
+/**
+ * Why the platform would not take the tests offered to it (plune-ai/cli#71): its review queue is at its
+ * ceiling, the project is at its case limit, or anything else — a throttle, an outage, a run that is not
+ * there. What a person does next depends on which, and only the first two have advice of their own.
+ */
+type UnofferedWhy = 'queue' | 'cases' | 'other';
 /** The run as the platform answers with it. Only `id` is load-bearing for the client. */
 interface RunRecord {
     id: string;
@@ -240,6 +246,12 @@ interface RunStats extends SubmitCounts {
      * queue at capacity means "empty it and import again"; nothing else here means that.
      */
     unoffered: number;
+    /**
+     * Why they were not, said by the platform's own words and present only when `unoffered` is not zero:
+     * that is what carries the reason the paragraph above says a subtraction cannot. The platform's line
+     * about it is printed with the failure; this is what a command turns into the advice that fits.
+     */
+    unofferedWhy?: UnofferedWhy;
     /**
      * Results not delivered, written to the fallback file instead of the platform (#790): a batch
      * refused for any reason — its size, the network, the token, a closed run — or a result whose keys
@@ -375,6 +387,20 @@ interface EnvSettings {
     ignored: string[];
 }
 declare function readEnv(env?: NodeJS.ProcessEnv): EnvSettings;
+/**
+ * The commit and the branch a run belongs to (plune-ai/plune#927), for `meta.sha` and `meta.branch`.
+ *
+ * `reported` is what the runner said about its CI — Playwright's `metadata.ci`, or the copy of it in
+ * its JSON report — and outranks the job's variables: it is a project's own word where the CI is one
+ * Playwright does not know, and it is where the tests ran when another job imports the report. So a
+ * report naming a commit other than this job's gets that commit and no branch of this job's: half of
+ * each would be a commit on a branch it is not on. Playwright gives no branch on GitHub at all, which
+ * is why the job's variables are read there.
+ *
+ * Each field is present only when something said it: outside a CI there is nothing to say, and nothing
+ * is guessed.
+ */
+declare function ciCommit(reported?: unknown, env?: NodeJS.ProcessEnv): Pick<RunMeta, 'sha' | 'branch'>;
 
 /**
  * What ends up in a deferred batch.
@@ -397,10 +423,21 @@ declare const DEFAULT_FALLBACK_PATH: string;
  *
  * `runId: null` is a real state, not a missing value — the platform was unreachable when the run
  * was supposed to be created, so these results have no run yet and replay has to make one.
+ *
+ * `meta` is where that run came from — the commit and branch, the CI run, the runner (plune-ai/plune#927).
+ * Recorded so the run replay makes is the run the reporter would have made; replay reads it and nothing
+ * else about the machine it runs on. A line written before the field existed has none.
+ *
+ * `session` marks the reporter session that wrote the line, made once by that session (plune-ai/cli#45).
+ * 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.
  */
 interface DeferredBatch {
     runId: string | null;
     externalKey: string | null;
+    session?: string;
+    meta?: RunMeta;
     results: DeferredResult[];
 }
 /**
@@ -496,4 +533,4 @@ interface PlatformClient {
 }
 declare function createClient(opts: ClientOptions): PlatformClient;
 
-export { type AssertionRecord, type Attachment, type AttemptError, type ClientFailureKind, type ClientOptions, type ClientOutcome, DEFAULT_FALLBACK_PATH, type DeclaredStep, type DeferredBatch, type DeferredResult, type EnvSettings, type Execution, type ExpectedEntry, type ExternalKeyKind, type FailedAttempt, type FailureDetail, type KeyRef, type PendingResult, type PlatformClient, RESULT_KEY_MAX, type ReporterConfig, type ResultFile, type ResultStatus, type ResultSubmission, type RunKind, type RunMeta, type RunRecord, type RunSession, type RunStats, type RunnerLocation, type SubmitCounts, UNSUPPORTED_VARS, appendBatch, createClient, errorContextOf, failureOf, filesOf, readEnv, repoRootOf, resultKey, startRun, webLink };
+export { type AssertionRecord, type Attachment, type AttemptError, type ClientFailureKind, type ClientOptions, type ClientOutcome, DEFAULT_FALLBACK_PATH, type DeclaredStep, type DeferredBatch, type DeferredResult, type EnvSettings, type Execution, type ExpectedEntry, type ExternalKeyKind, type FailedAttempt, type FailureDetail, type KeyRef, type PendingResult, type PlatformClient, RESULT_KEY_MAX, type ReporterConfig, type ResultFile, type ResultStatus, type ResultSubmission, type RunKind, type RunMeta, type RunRecord, type RunSession, type RunStats, type RunnerLocation, type SubmitCounts, UNSUPPORTED_VARS, type UnofferedWhy, appendBatch, ciCommit, createClient, errorContextOf, failureOf, filesOf, readEnv, repoRootOf, resultKey, startRun, webLink };

package/dist/reporter-core.d.ts

@@ -200,6 +200,12 @@ interface ExpectedEntry {
     testCaseId?: string;
     externalKey?: KeyRef;
 }
+/**
+ * Why the platform would not take the tests offered to it (plune-ai/cli#71): its review queue is at its
+ * ceiling, the project is at its case limit, or anything else — a throttle, an outage, a run that is not
+ * there. What a person does next depends on which, and only the first two have advice of their own.
+ */
+type UnofferedWhy = 'queue' | 'cases' | 'other';
 /** The run as the platform answers with it. Only `id` is load-bearing for the client. */
 interface RunRecord {
     id: string;
@@ -240,6 +246,12 @@ interface RunStats extends SubmitCounts {
      * queue at capacity means "empty it and import again"; nothing else here means that.
      */
     unoffered: number;
+    /**
+     * Why they were not, said by the platform's own words and present only when `unoffered` is not zero:
+     * that is what carries the reason the paragraph above says a subtraction cannot. The platform's line
+     * about it is printed with the failure; this is what a command turns into the advice that fits.
+     */
+    unofferedWhy?: UnofferedWhy;
     /**
      * Results not delivered, written to the fallback file instead of the platform (#790): a batch
      * refused for any reason — its size, the network, the token, a closed run — or a result whose keys
@@ -375,6 +387,20 @@ interface EnvSettings {
     ignored: string[];
 }
 declare function readEnv(env?: NodeJS.ProcessEnv): EnvSettings;
+/**
+ * The commit and the branch a run belongs to (plune-ai/plune#927), for `meta.sha` and `meta.branch`.
+ *
+ * `reported` is what the runner said about its CI — Playwright's `metadata.ci`, or the copy of it in
+ * its JSON report — and outranks the job's variables: it is a project's own word where the CI is one
+ * Playwright does not know, and it is where the tests ran when another job imports the report. So a
+ * report naming a commit other than this job's gets that commit and no branch of this job's: half of
+ * each would be a commit on a branch it is not on. Playwright gives no branch on GitHub at all, which
+ * is why the job's variables are read there.
+ *
+ * Each field is present only when something said it: outside a CI there is nothing to say, and nothing
+ * is guessed.
+ */
+declare function ciCommit(reported?: unknown, env?: NodeJS.ProcessEnv): Pick<RunMeta, 'sha' | 'branch'>;
 
 /**
  * What ends up in a deferred batch.
@@ -397,10 +423,21 @@ declare const DEFAULT_FALLBACK_PATH: string;
  *
  * `runId: null` is a real state, not a missing value — the platform was unreachable when the run
  * was supposed to be created, so these results have no run yet and replay has to make one.
+ *
+ * `meta` is where that run came from — the commit and branch, the CI run, the runner (plune-ai/plune#927).
+ * Recorded so the run replay makes is the run the reporter would have made; replay reads it and nothing
+ * else about the machine it runs on. A line written before the field existed has none.
+ *
+ * `session` marks the reporter session that wrote the line, made once by that session (plune-ai/cli#45).
+ * 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.
  */
 interface DeferredBatch {
     runId: string | null;
     externalKey: string | null;
+    session?: string;
+    meta?: RunMeta;
     results: DeferredResult[];
 }
 /**
@@ -496,4 +533,4 @@ interface PlatformClient {
 }
 declare function createClient(opts: ClientOptions): PlatformClient;
 
-export { type AssertionRecord, type Attachment, type AttemptError, type ClientFailureKind, type ClientOptions, type ClientOutcome, DEFAULT_FALLBACK_PATH, type DeclaredStep, type DeferredBatch, type DeferredResult, type EnvSettings, type Execution, type ExpectedEntry, type ExternalKeyKind, type FailedAttempt, type FailureDetail, type KeyRef, type PendingResult, type PlatformClient, RESULT_KEY_MAX, type ReporterConfig, type ResultFile, type ResultStatus, type ResultSubmission, type RunKind, type RunMeta, type RunRecord, type RunSession, type RunStats, type RunnerLocation, type SubmitCounts, UNSUPPORTED_VARS, appendBatch, createClient, errorContextOf, failureOf, filesOf, readEnv, repoRootOf, resultKey, startRun, webLink };
+export { type AssertionRecord, type Attachment, type AttemptError, type ClientFailureKind, type ClientOptions, type ClientOutcome, DEFAULT_FALLBACK_PATH, type DeclaredStep, type DeferredBatch, type DeferredResult, type EnvSettings, type Execution, type ExpectedEntry, type ExternalKeyKind, type FailedAttempt, type FailureDetail, type KeyRef, type PendingResult, type PlatformClient, RESULT_KEY_MAX, type ReporterConfig, type ResultFile, type ResultStatus, type ResultSubmission, type RunKind, type RunMeta, type RunRecord, type RunSession, type RunStats, type RunnerLocation, type SubmitCounts, UNSUPPORTED_VARS, type UnofferedWhy, appendBatch, ciCommit, createClient, errorContextOf, failureOf, filesOf, readEnv, repoRootOf, resultKey, startRun, webLink };

package/dist/reporter-core.js

@@ -1,5 +1,5 @@
 // src/reporter-core/session.ts
-import { createHash } from "crypto";
+import { createHash, randomUUID } from "crypto";
 import { promises as disk } from "fs";
 import { basename as basename2, extname } from "path";
 
@@ -199,6 +199,28 @@ function defaultRunTitle(env = process.env, now = /* @__PURE__ */ new Date(), cw
   const where = flag(env, "CI") || flag(env, "GITHUB_ACTIONS") ? "ci" : "local";
   return `${path.basename(cwd)} \xB7 ${stamp} \xB7 ${where}`;
 }
+var PROVIDERS = [
+  { is: "GITHUB_ACTIONS", sha: "GITHUB_SHA", branch: ["GITHUB_HEAD_REF", "GITHUB_REF_NAME"] },
+  { is: "GITLAB_CI", sha: "CI_COMMIT_SHA", branch: ["CI_COMMIT_REF_NAME"] },
+  { is: "JENKINS_URL", sha: "GIT_COMMIT", branch: ["GIT_BRANCH"] }
+];
+function ciCommit(reported, env = process.env) {
+  const said = typeof reported === "object" && reported !== null ? reported : {};
+  const text = (raw) => typeof raw === "string" && raw.trim() !== "" ? raw.trim() : void 0;
+  const provider = PROVIDERS.find((p) => value(env, p.is) !== void 0);
+  const job = {
+    sha: provider === void 0 ? void 0 : value(env, provider.sha),
+    branch: provider?.branch.map((name) => value(env, name)).find((v) => v !== void 0)
+  };
+  const sha = text(said["commitHash"]);
+  const sameCommit = sha === void 0 || sha === job.sha;
+  const commit = sha ?? job.sha;
+  const branch = text(said["branch"]) ?? (sameCommit ? job.branch : void 0);
+  return {
+    ...commit !== void 0 ? { sha: commit } : {},
+    ...branch !== void 0 ? { branch } : {}
+  };
+}
 
 // src/reporter-core/fallback.ts
 import * as fs from "fs";
@@ -210,6 +232,8 @@ function appendBatch(file, batch) {
     ts: (/* @__PURE__ */ new Date()).toISOString(),
     runId: batch.runId,
     externalKey: batch.externalKey,
+    ...batch.session !== void 0 ? { session: batch.session } : {},
+    ...batch.meta !== void 0 ? { meta: batch.meta } : {},
     results: batch.results
   };
   fs.appendFileSync(file, `${JSON.stringify(line)}
@@ -263,6 +287,12 @@ function boundKey(key) {
   if (/[\uD800-\uDBFF]$/.test(head)) head = head.slice(0, -1);
   return { ...key, value: `${head}#${digest}` };
 }
+function whyUnoffered(out) {
+  if (out.ok || out.status !== 429) return "other";
+  if (/review queue quota reached/i.test(out.detail)) return "queue";
+  if (/test case quota reached/i.test(out.detail)) return "cases";
+  return "other";
+}
 function boundTitle(title) {
   return title.length <= TITLE_MAX ? title : `${title.slice(0, TITLE_MAX - 1)}\u2026`;
 }
@@ -306,6 +336,7 @@ async function startRun(passed, declared) {
 `));
   const fallbackPath = cfg.fallbackPath ?? DEFAULT_FALLBACK_PATH;
   const externalKey = cfg.externalKey ?? null;
+  const sessionMarker = randomUUID();
   const batchSize = Math.min(cfg.batchSize ?? BATCH_DEFAULT, BATCH_MAX);
   const offerDiscovered = cfg.offerDiscovered ?? false;
   const token = cfg.token ?? loadToken() ?? "";
@@ -357,7 +388,13 @@ async function startRun(passed, declared) {
     log(`plune: ignoring ${env.ignored.join(", ")} \u2014 a run has nowhere to store them yet.`);
   }
   function defer(results) {
-    appendBatch(fallbackPath, { runId, externalKey, results });
+    appendBatch(fallbackPath, {
+      runId,
+      externalKey,
+      session: sessionMarker,
+      ...cfg.meta !== void 0 ? { meta: cfg.meta } : {},
+      results
+    });
     stats.deferred += results.length;
   }
   async function resolveKeys(values) {
@@ -454,6 +491,7 @@ async function startRun(passed, declared) {
       });
       if (!out.ok || !Array.isArray(out.body?.results)) {
         stats.unoffered = batches.slice(index).reduce((n, rest) => n + rest.length, 0);
+        stats.unofferedWhy = whyUnoffered(out);
         log(
           `plune: could not offer ${stats.unoffered} unknown test(s) for review (${out.ok ? "the answer had no results" : out.detail || out.kind}).`
         );
@@ -795,6 +833,7 @@ export {
   RESULT_KEY_MAX,
   UNSUPPORTED_VARS,
   appendBatch,
+  ciCommit,
   createClient,
   errorContextOf,
   failureOf,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plune-ai/cli",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "AI-powered assertion testing for LLM apps — write assertions, run them against any provider, get a pass/fail report (local, CI, or diff).",
   "keywords": [
     "ai",