@plune-ai/cli 0.10.0 → 0.11.0

package/README.md

@@ -158,6 +158,14 @@ job closes the run instead of the explicit `finish`.
 `plune run exec` sets it for you — anything reporting inside it, this command included, joins
 without closing.
 
+### What the run is called
+
+A run nobody named is called after the directory, the minute it started and where it ran —
+`plune · 2026-09-15 15:26 · ci` — so a row in the list reads without being opened. The clock is the
+reporting machine's own; `ci` comes from the `CI` variable every hosted runner sets. To call it
+something else, set `PLUNE_RUN_TITLE`; `PLUNE_ENV` and `PLUNE_LABELS` mark where it ran and how, and
+those stay marks rather than becoming part of the name.
+
 ## Optional: keep a history
 
 Everything above works with no account, no network, and no token — that does not change. `run`,

package/dist/cli.cjs

@@ -2210,7 +2210,7 @@ function createClient(opts) {
   const wait = opts.wait ?? sleep;
   const base = opts.apiUrl.replace(/\/+$/, "");
   const scrub = (text2) => opts.token === "" ? text2 : text2.split(opts.token).join("***");
-  async function send(method, path12, body) {
+  async function send(method, path13, body) {
     let last = {
       kind: "unavailable",
       status: null,
@@ -2219,7 +2219,7 @@ function createClient(opts) {
     for (let attempt = 0; attempt <= RETRY_DELAYS_MS.length; attempt += 1) {
       let res;
       try {
-        res = await doFetch(`${base}${path12}`, {
+        res = await doFetch(`${base}${path13}`, {
           method,
           headers: { "content-type": "application/json", authorization: `Bearer ${opts.token}` },
           // A DELETE carries none. Sending `"undefined"` as a body is what a naive
@@ -2247,8 +2247,8 @@ function createClient(opts) {
     return { ok: false, ...last };
   }
   return {
-    post: (path12, body) => send("POST", path12, body),
-    del: (path12) => send("DELETE", path12)
+    post: (path13, body) => send("POST", path13, body),
+    del: (path13) => send("DELETE", path13)
   };
 }
 var RETRY_DELAYS_MS, sleep;
@@ -2313,18 +2313,25 @@ function readEnv(env = process.env) {
     ignored: UNSUPPORTED_VARS.filter((name) => value(env, name) !== void 0)
   };
 }
-var UNSUPPORTED_VARS;
+function defaultRunTitle(env = process.env, now = /* @__PURE__ */ new Date(), cwd = process.cwd()) {
+  const two = (n) => String(n).padStart(2, "0");
+  const stamp = `${now.getFullYear()}-${two(now.getMonth() + 1)}-${two(now.getDate())} ${two(now.getHours())}:${two(now.getMinutes())}`;
+  const where = flag(env, "CI") || flag(env, "GITHUB_ACTIONS") ? "ci" : "local";
+  return `${path6.basename(cwd)} \xB7 ${stamp} \xB7 ${where}`;
+}
+var path6, UNSUPPORTED_VARS;
 var init_env2 = __esm({
   "src/reporter-core/env.ts"() {
     "use strict";
     init_cjs_shims();
+    path6 = __toESM(require("path"), 1);
     UNSUPPORTED_VARS = ["PLUNE_GROUP"];
   }
 });
 
 // src/reporter-core/fallback.ts
 function appendBatch(file, batch) {
-  fs6.mkdirSync(path6.dirname(file), { recursive: true });
+  fs6.mkdirSync(path7.dirname(file), { recursive: true });
   const line = {
     ts: (/* @__PURE__ */ new Date()).toISOString(),
     runId: batch.runId,
@@ -2334,14 +2341,14 @@ function appendBatch(file, batch) {
   fs6.appendFileSync(file, `${JSON.stringify(line)}
 `, "utf8");
 }
-var fs6, path6, DEFAULT_FALLBACK_PATH;
+var fs6, path7, DEFAULT_FALLBACK_PATH;
 var init_fallback = __esm({
   "src/reporter-core/fallback.ts"() {
     "use strict";
     init_cjs_shims();
     fs6 = __toESM(require("fs"), 1);
-    path6 = __toESM(require("path"), 1);
-    DEFAULT_FALLBACK_PATH = path6.join(".plune", "pending-results.jsonl");
+    path7 = __toESM(require("path"), 1);
+    DEFAULT_FALLBACK_PATH = path7.join(".plune", "pending-results.jsonl");
   }
 });
 
@@ -2468,6 +2475,10 @@ async function startRun(passed, declared) {
       ...externalKey !== null ? { externalKey } : {},
       ...cfg.meta !== void 0 ? { meta: cfg.meta } : {},
       ...configuration !== void 0 ? { configuration } : {},
+      // 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.
+      title: defaultRunTitle(),
       ...described
     });
     if (start.ok) {
@@ -2689,7 +2700,9 @@ async function handleRunStart(options = {}) {
   const out = await client.post("/v1/runs", {
     schemaVersion: 2,
     kind: options.kind ?? "automated",
-    externalKey
+    externalKey,
+    // The same name the reporter would give it; `PLUNE_RUN_TITLE` replaces it, as everywhere.
+    title: env.config.title ?? defaultRunTitle()
   });
   if (!out.ok) throw new RunCommandError(`Could not start the run \u2014 ${out.detail || out.kind}.`);
   const result = {
@@ -3351,7 +3364,7 @@ function isRunResult(v) {
 }
 function handleReport(opts = {}) {
   const cwd = opts.cwd ?? process.cwd();
-  const file = path7.join(cwd, ".plune", "last-run.json");
+  const file = path8.join(cwd, ".plune", "last-run.json");
   let raw;
   try {
     raw = fs9.readFileSync(file, "utf8");
@@ -3369,13 +3382,13 @@ function handleReport(opts = {}) {
   }
   return parsed;
 }
-var fs9, path7, ReportNotFoundError;
+var fs9, path8, ReportNotFoundError;
 var init_report = __esm({
   "src/cli/commands/report.ts"() {
     "use strict";
     init_cjs_shims();
     fs9 = __toESM(require("fs"), 1);
-    path7 = __toESM(require("path"), 1);
+    path8 = __toESM(require("path"), 1);
     ReportNotFoundError = class extends Error {
       code = "NO_SAVED_RUN";
       constructor(message) {
@@ -3599,7 +3612,7 @@ async function runInitWizard(cwd) {
     process.exit(1);
     return;
   }
-  const outputPath = path8.join(cwd, "plune.yaml");
+  const outputPath = path9.join(cwd, "plune.yaml");
   if (fs11.existsSync(outputPath)) {
     const overwrite = await clack.confirm({
       message: "plune.yaml already exists. Overwrite?"
@@ -3643,14 +3656,14 @@ async function runInitWizard(cwd) {
   spin.stop("plune.yaml created!");
   clack.outro("plune.yaml is ready.");
 }
-var clack, fs11, path8, import_yaml2;
+var clack, fs11, path9, import_yaml2;
 var init_wizard = __esm({
   "src/config/init/wizard.ts"() {
     "use strict";
     init_cjs_shims();
     clack = __toESM(require("@clack/prompts"), 1);
     fs11 = __toESM(require("fs"), 1);
-    path8 = __toESM(require("path"), 1);
+    path9 = __toESM(require("path"), 1);
     import_yaml2 = require("yaml");
     init_errors();
   }
@@ -3658,21 +3671,21 @@ var init_wizard = __esm({
 
 // src/cli/templates/index.ts
 function writeTemplateFile(cwd, rel, content, force) {
-  const target = path9.join(cwd, rel);
+  const target = path10.join(cwd, rel);
   if (!force && fs12.existsSync(target)) {
     return "skipped";
   }
-  fs12.mkdirSync(path9.dirname(target), { recursive: true });
+  fs12.mkdirSync(path10.dirname(target), { recursive: true });
   fs12.writeFileSync(target, content, "utf8");
   return "written";
 }
-var fs12, path9, ENV_EXAMPLE_TPL, EXAMPLE_JSONL_TPL, PLUNE_YAML_TPL;
+var fs12, path10, ENV_EXAMPLE_TPL, EXAMPLE_JSONL_TPL, PLUNE_YAML_TPL;
 var init_templates = __esm({
   "src/cli/templates/index.ts"() {
     "use strict";
     init_cjs_shims();
     fs12 = __toESM(require("fs"), 1);
-    path9 = __toESM(require("path"), 1);
+    path10 = __toESM(require("path"), 1);
     ENV_EXAMPLE_TPL = `# Copy this file to .env and replace the placeholders with your real keys.
 # .env is gitignored; .env.example is safe to commit.
 # Plune reads whichever key matches your configured provider.
@@ -3928,7 +3941,7 @@ __export(sync_exports, {
   reportSyncFailure: () => reportSyncFailure
 });
 function readRun(cwd, file) {
-  const target = file !== void 0 ? path10.resolve(cwd, file) : path10.join(cwd, ".plune", "last-run.json");
+  const target = file !== void 0 ? path11.resolve(cwd, file) : path11.join(cwd, ".plune", "last-run.json");
   let raw;
   try {
     raw = fs13.readFileSync(target, "utf8");
@@ -3995,13 +4008,13 @@ function reportSyncFailure(err, write) {
   }
   return null;
 }
-var fs13, path10, NotLoggedInError, TokenRejectedError2, SyncFileError, SyncNetworkError, SyncHttpError;
+var fs13, path11, NotLoggedInError, TokenRejectedError2, SyncFileError, SyncNetworkError, SyncHttpError;
 var init_sync = __esm({
   "src/cli/commands/sync.ts"() {
     "use strict";
     init_cjs_shims();
     fs13 = __toESM(require("fs"), 1);
-    path10 = __toESM(require("path"), 1);
+    path11 = __toESM(require("path"), 1);
     init_run_result_schema();
     init_api_url();
     init_credentials();
@@ -4051,9 +4064,9 @@ async function findLatestCairnRun(runsDir = "runs") {
   let newest;
   for (const entry of entries) {
     if (!entry.isDirectory()) continue;
-    const dir = path11.join(runsDir, entry.name);
+    const dir = path12.join(runsDir, entry.name);
     try {
-      const report = await fs14.lstat(path11.join(dir, "report.json"));
+      const report = await fs14.lstat(path12.join(dir, "report.json"));
       if (!report.isFile()) continue;
       if (newest === void 0 || report.mtimeMs > newest.at) {
         newest = { dir, at: report.mtimeMs };
@@ -4072,7 +4085,7 @@ async function readJson(file) {
   }
 }
 async function defaultReadEvidence(dir) {
-  const raw = await readJson(path11.join(dir, "api-evidence.json"));
+  const raw = await readJson(path12.join(dir, "api-evidence.json"));
   if (!Array.isArray(raw)) return void 0;
   return raw.map((r) => {
     const rec = asRecord(r);
@@ -4114,7 +4127,7 @@ function casesFromApi(report, verdicts) {
   });
 }
 async function readCairnRun(dir, deps = {}) {
-  const raw = await readJson(path11.join(dir, "report.json"));
+  const raw = await readJson(path12.join(dir, "report.json"));
   if (raw === void 0) throw new CairnRunNotFoundError(dir);
   const report = asRecord(raw);
   if (report["schemaVersion"] !== SUPPORTED_ARTIFACT_VERSION) {
@@ -4144,20 +4157,20 @@ async function readCairnRun(dir, deps = {}) {
   return {
     schemaVersion: INGEST_SCHEMA_VERSION,
     run: {
-      runId: str(report["runId"], path11.basename(dir)),
+      runId: str(report["runId"], path12.basename(dir)),
       mode,
       target: str(report["url"], "unknown")
     },
     cases
   };
 }
-var fs14, path11, SUPPORTED_ARTIFACT_VERSION, INGEST_SCHEMA_VERSION, NoCairnRunsError, CairnRunNotFoundError, CairnRunVersionError, CairnRunPartialError, CairnEvidenceAmbiguousError, asRecord, str;
+var fs14, path12, SUPPORTED_ARTIFACT_VERSION, INGEST_SCHEMA_VERSION, NoCairnRunsError, CairnRunNotFoundError, CairnRunVersionError, CairnRunPartialError, CairnEvidenceAmbiguousError, asRecord, str;
 var init_cairn_artifact = __esm({
   "src/cli/commands/cairn-artifact.ts"() {
     "use strict";
     init_cjs_shims();
     fs14 = __toESM(require("fs/promises"), 1);
-    path11 = __toESM(require("path"), 1);
+    path12 = __toESM(require("path"), 1);
     SUPPORTED_ARTIFACT_VERSION = 1;
     INGEST_SCHEMA_VERSION = 1;
     NoCairnRunsError = class extends Error {
@@ -4613,10 +4626,10 @@ function createProgram() {
     const { handleLogin: handleLogin2, reportLoginFailure: reportLoginFailure2 } = await Promise.resolve().then(() => (init_login(), login_exports));
     try {
       const token = options.token ?? await readTokenFromStdin();
-      const { path: path12, verified } = await handleLogin2({ token, skipVerify: options.skipVerify });
+      const { path: path13, verified } = await handleLogin2({ token, skipVerify: options.skipVerify });
       process.stdout.write(
-        verified ? `Logged in. Token checked against the API and saved to ${path12}
-` : `Token saved to ${path12} WITHOUT being checked (--skip-verify).
+        verified ? `Logged in. Token checked against the API and saved to ${path13}
+` : `Token saved to ${path13} WITHOUT being checked (--skip-verify).
 `
       );
     } catch (err) {
@@ -4633,9 +4646,9 @@ function createProgram() {
     const verbose = command.optsWithGlobals().verbose === true;
     const { handleLogout: handleLogout2 } = await Promise.resolve().then(() => (init_logout(), logout_exports));
     try {
-      const { removed, path: path12 } = handleLogout2();
+      const { removed, path: path13 } = handleLogout2();
       process.stdout.write(
-        removed ? `Logged out. Removed ${path12}
+        removed ? `Logged out. Removed ${path13}
 ` : "Not logged in \u2014 nothing to remove.\n"
       );
     } catch (err) {

package/dist/reporter-core.cjs

@@ -97,7 +97,7 @@ function createClient(opts) {
   const wait = opts.wait ?? sleep;
   const base = opts.apiUrl.replace(/\/+$/, "");
   const scrub = (text) => opts.token === "" ? text : text.split(opts.token).join("***");
-  async function send(method, path2, body) {
+  async function send(method, path3, body) {
     let last = {
       kind: "unavailable",
       status: null,
@@ -106,7 +106,7 @@ function createClient(opts) {
     for (let attempt = 0; attempt <= RETRY_DELAYS_MS.length; attempt += 1) {
       let res;
       try {
-        res = await doFetch(`${base}${path2}`, {
+        res = await doFetch(`${base}${path3}`, {
           method,
           headers: { "content-type": "application/json", authorization: `Bearer ${opts.token}` },
           // A DELETE carries none. Sending `"undefined"` as a body is what a naive
@@ -134,12 +134,13 @@ function createClient(opts) {
     return { ok: false, ...last };
   }
   return {
-    post: (path2, body) => send("POST", path2, body),
-    del: (path2) => send("DELETE", path2)
+    post: (path3, body) => send("POST", path3, body),
+    del: (path3) => send("DELETE", path3)
   };
 }
 
 // src/reporter-core/env.ts
+var path = __toESM(require("path"), 1);
 var UNSUPPORTED_VARS = ["PLUNE_GROUP"];
 function value(env, name) {
   const raw = env[name]?.trim();
@@ -192,13 +193,19 @@ function readEnv(env = process.env) {
     ignored: UNSUPPORTED_VARS.filter((name) => value(env, name) !== void 0)
   };
 }
+function defaultRunTitle(env = process.env, now = /* @__PURE__ */ new Date(), cwd = process.cwd()) {
+  const two = (n) => String(n).padStart(2, "0");
+  const stamp = `${now.getFullYear()}-${two(now.getMonth() + 1)}-${two(now.getDate())} ${two(now.getHours())}:${two(now.getMinutes())}`;
+  const where = flag(env, "CI") || flag(env, "GITHUB_ACTIONS") ? "ci" : "local";
+  return `${path.basename(cwd)} \xB7 ${stamp} \xB7 ${where}`;
+}
 
 // src/reporter-core/fallback.ts
 var fs = __toESM(require("fs"), 1);
-var path = __toESM(require("path"), 1);
-var DEFAULT_FALLBACK_PATH = path.join(".plune", "pending-results.jsonl");
+var path2 = __toESM(require("path"), 1);
+var DEFAULT_FALLBACK_PATH = path2.join(".plune", "pending-results.jsonl");
 function appendBatch(file, batch) {
-  fs.mkdirSync(path.dirname(file), { recursive: true });
+  fs.mkdirSync(path2.dirname(file), { recursive: true });
   const line = {
     ts: (/* @__PURE__ */ new Date()).toISOString(),
     runId: batch.runId,
@@ -339,6 +346,10 @@ async function startRun(passed, declared) {
       ...externalKey !== null ? { externalKey } : {},
       ...cfg.meta !== void 0 ? { meta: cfg.meta } : {},
       ...configuration !== void 0 ? { configuration } : {},
+      // 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.
+      title: defaultRunTitle(),
       ...described
     });
     if (start.ok) {

package/dist/reporter-core.js

@@ -54,7 +54,7 @@ function createClient(opts) {
   const wait = opts.wait ?? sleep;
   const base = opts.apiUrl.replace(/\/+$/, "");
   const scrub = (text) => opts.token === "" ? text : text.split(opts.token).join("***");
-  async function send(method, path2, body) {
+  async function send(method, path3, body) {
     let last = {
       kind: "unavailable",
       status: null,
@@ -63,7 +63,7 @@ function createClient(opts) {
     for (let attempt = 0; attempt <= RETRY_DELAYS_MS.length; attempt += 1) {
       let res;
       try {
-        res = await doFetch(`${base}${path2}`, {
+        res = await doFetch(`${base}${path3}`, {
           method,
           headers: { "content-type": "application/json", authorization: `Bearer ${opts.token}` },
           // A DELETE carries none. Sending `"undefined"` as a body is what a naive
@@ -91,12 +91,13 @@ function createClient(opts) {
     return { ok: false, ...last };
   }
   return {
-    post: (path2, body) => send("POST", path2, body),
-    del: (path2) => send("DELETE", path2)
+    post: (path3, body) => send("POST", path3, body),
+    del: (path3) => send("DELETE", path3)
   };
 }
 
 // src/reporter-core/env.ts
+import * as path from "path";
 var UNSUPPORTED_VARS = ["PLUNE_GROUP"];
 function value(env, name) {
   const raw = env[name]?.trim();
@@ -149,13 +150,19 @@ function readEnv(env = process.env) {
     ignored: UNSUPPORTED_VARS.filter((name) => value(env, name) !== void 0)
   };
 }
+function defaultRunTitle(env = process.env, now = /* @__PURE__ */ new Date(), cwd = process.cwd()) {
+  const two = (n) => String(n).padStart(2, "0");
+  const stamp = `${now.getFullYear()}-${two(now.getMonth() + 1)}-${two(now.getDate())} ${two(now.getHours())}:${two(now.getMinutes())}`;
+  const where = flag(env, "CI") || flag(env, "GITHUB_ACTIONS") ? "ci" : "local";
+  return `${path.basename(cwd)} \xB7 ${stamp} \xB7 ${where}`;
+}
 
 // src/reporter-core/fallback.ts
 import * as fs from "fs";
-import * as path from "path";
-var DEFAULT_FALLBACK_PATH = path.join(".plune", "pending-results.jsonl");
+import * as path2 from "path";
+var DEFAULT_FALLBACK_PATH = path2.join(".plune", "pending-results.jsonl");
 function appendBatch(file, batch) {
-  fs.mkdirSync(path.dirname(file), { recursive: true });
+  fs.mkdirSync(path2.dirname(file), { recursive: true });
   const line = {
     ts: (/* @__PURE__ */ new Date()).toISOString(),
     runId: batch.runId,
@@ -296,6 +303,10 @@ async function startRun(passed, declared) {
       ...externalKey !== null ? { externalKey } : {},
       ...cfg.meta !== void 0 ? { meta: cfg.meta } : {},
       ...configuration !== void 0 ? { configuration } : {},
+      // 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.
+      title: defaultRunTitle(),
       ...described
     });
     if (start.ok) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plune-ai/cli",
-  "version": "0.10.0",
+  "version": "0.11.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",