@plune-ai/cli 0.29.0 → 0.30.0

package/README.md

@@ -121,7 +121,7 @@ the last resort, used only when `PLUNE_TOKEN` is set nowhere else. Nothing write
 | `plune init` | Scaffold `plune.yaml`, a sample dataset, and `.env.example`. Flags: `--yes` (non-interactive), `--force`. |
 | `plune login` | Save a [Plune platform](https://plune.ai/platform) API token so `sync` and `ingest` can reach it. The token is **checked against the API before it is saved**, so a wrong one fails here rather than two commands later. Get one at `https://beta.plune.ai` → Account → API tokens. Flags: `--token <token>` (omit to paste it or pipe it via stdin), `--skip-verify` (save without checking, for offline setup). In CI, skip this step: every platform command reads `PLUNE_TOKEN` from the environment first, and the saved login only when it is not set. |
 | `plune logout` | Remove the saved token. |
-| `plune sync` | Upload the latest local run to the platform. Flags: `--file <path>` to send a specific run JSON, `--fail-on-failures` to read the run's summary back once after the upload and exit with [the gate](#a-release-gate---fail-on-failures)'s code. Each upload carries an `Idempotency-Key` (SHA-256 of the body), so sending the same run again returns the same run rather than creating a second one. |
+| `plune sync` | Upload the latest local run to the platform. Flags: `--file <path>` to send a specific run JSON, `--fail-on-failures` to read the run's summary back once after the upload and exit with [the gate](#a-release-gate---fail-on-failures)'s code. Each upload carries an `Idempotency-Key` (SHA-256 of the body), so sending the same run again returns the same run rather than creating a second one. Against a platform with `POST /v1/jobs` the upload is also reported as a job (kind `cli-sync`) that ends failed with the error text if the sync fails; an older platform without the route is not told, and a job report never fails the sync. |
 | `plune run import <file>` | Turn a **JUnit XML** or **Playwright JSON** report, or an **Allure `allure-results` folder**, into a run in Plune. Needs no provider key — nothing is generated. Flags: `--format junit\|playwright-json\|allure` (detected from the file when omitted; a folder is Allure), `--name <text>` to call the run something other than the [folder-based default](#what-the-run-is-called), `--key <externalKey>` to land several reports in one run (with `PLUNE_SHARED_RUN=1` — see below), `--create` to offer unmatched tests to the review queue, `--fail-on-missing-attachments` to exit 1 when a file a JUnit report names with `[[ATTACHMENT\|path]]`, or an Allure result names as a `source`, is not there (the results are sent either way), `--upload-concurrency <n>` for files uploaded at once ([1 to 32, default 16](#many-screenshots-upload-concurrency-and-retries)), `--fail-on-failures` to exit with [the gate](#a-release-gate---fail-on-failures)'s code on the summary the platform froze when this import finished the run. |
 | `plune run start` | Open a platform run — or join the one already carrying `--key` — and print its id. Flags: `--key <externalKey>` (generated when absent), `--name <text>` to call the run something other than the [default](#what-the-run-is-called), `--json` for one machine-readable line. |
 | `plune run finish <id>` | Close a platform run. This is what the reporter tells you to do for a run it had to leave open. Flags: `--terminate` to record it as cut short, `--reason <text>`, `--fail-on-failures` to exit with [the gate](#a-release-gate---fail-on-failures)'s code on the summary the platform froze. |

package/dist/cli.cjs

@@ -4367,30 +4367,46 @@ async function handleSync(deps = {}) {
   const endpoint = `${apiUrl}/v1/runs`;
   const payload = JSON.stringify(run);
   const idempotencyKey = (0, import_node_crypto4.createHash)("sha256").update(payload).digest("hex");
-  let res;
+  const bearer = token;
+  const job = new JobReporter(doFetch, apiUrl, bearer);
+  await job.open(path9.basename(deps.file !== void 0 ? path9.resolve(cwd, deps.file) : cwd));
   try {
-    res = await doFetch(endpoint, {
-      method: "POST",
-      headers: {
-        "content-type": "application/json",
-        authorization: `Bearer ${token}`,
-        "idempotency-key": idempotencyKey
-      },
-      body: payload
-    });
-  } catch {
-    throw new SyncNetworkError(apiUrl);
+    const result = await upload();
+    await job.finish({ ok: true });
+    return result;
+  } catch (err) {
+    await job.finish({ ok: false, reason: err instanceof Error ? err.message : "Sync failed." });
+    throw err;
   }
-  if (!res.ok) {
-    const detail = await safeErrorDetail(res);
-    if (res.status === 401) throw new TokenRejectedError();
-    throw new SyncHttpError(res.status, detail);
+  async function upload() {
+    let res;
+    try {
+      res = await doFetch(endpoint, {
+        method: "POST",
+        headers: {
+          "content-type": "application/json",
+          authorization: `Bearer ${bearer}`,
+          "idempotency-key": idempotencyKey
+        },
+        body: payload
+      });
+    } catch {
+      throw new SyncNetworkError(apiUrl);
+    }
+    if (!res.ok) {
+      const detail = await safeErrorDetail(res);
+      if (res.status === 401) throw new TokenRejectedError();
+      throw new SyncHttpError(res.status, detail);
+    }
+    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);
+    if (deps.failOnFailures === true) {
+      result.gate = gateExit(await readVerdict(doFetch, `${endpoint}/${id}/summary`, bearer));
+    }
+    return result;
   }
-  const body = await res.json().catch(() => ({}));
-  const id = typeof body.id === "string" ? body.id : "";
-  const result = { id, url: `${endpoint}/${id}` };
-  if (deps.failOnFailures === true) result.gate = gateExit(await readVerdict(doFetch, `${endpoint}/${id}/summary`, token));
-  return result;
 }
 async function readVerdict(doFetch, url, token) {
   try {
@@ -4412,7 +4428,7 @@ function reportSyncFailure(err, write) {
   }
   return null;
 }
-var import_node_crypto4, fs8, path9, NotLoggedInError, TokenRejectedError, SyncFileError, SyncNetworkError, SyncHttpError;
+var import_node_crypto4, fs8, path9, NotLoggedInError, TokenRejectedError, SyncFileError, SyncNetworkError, SyncHttpError, JOB_KIND, JOB_TIMEOUT_MS, JobReporter;
 var init_sync = __esm({
   "src/cli/commands/sync.ts"() {
     "use strict";
@@ -4460,6 +4476,58 @@ var init_sync = __esm({
       }
       status;
     };
+    JOB_KIND = "cli-sync";
+    JOB_TIMEOUT_MS = 5e3;
+    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 }
+        );
+      }
+    };
   }
 });
 

package/dist/index.cjs

@@ -1892,6 +1892,58 @@ 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;
@@ -1932,30 +1984,46 @@ async function handleSync(deps = {}) {
   const endpoint = `${apiUrl}/v1/runs`;
   const payload = JSON.stringify(run);
   const idempotencyKey = (0, import_node_crypto2.createHash)("sha256").update(payload).digest("hex");
-  let res;
+  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));
   try {
-    res = await doFetch(endpoint, {
-      method: "POST",
-      headers: {
-        "content-type": "application/json",
-        authorization: `Bearer ${token}`,
-        "idempotency-key": idempotencyKey
-      },
-      body: payload
-    });
-  } catch {
-    throw new SyncNetworkError(apiUrl);
+    const result = await upload();
+    await job.finish({ ok: true });
+    return result;
+  } catch (err) {
+    await job.finish({ ok: false, reason: err instanceof Error ? err.message : "Sync failed." });
+    throw err;
   }
-  if (!res.ok) {
-    const detail = await safeErrorDetail(res);
-    if (res.status === 401) throw new TokenRejectedError();
-    throw new SyncHttpError(res.status, detail);
+  async function upload() {
+    let res;
+    try {
+      res = await doFetch(endpoint, {
+        method: "POST",
+        headers: {
+          "content-type": "application/json",
+          authorization: `Bearer ${bearer}`,
+          "idempotency-key": idempotencyKey
+        },
+        body: payload
+      });
+    } catch {
+      throw new SyncNetworkError(apiUrl);
+    }
+    if (!res.ok) {
+      const detail = await safeErrorDetail(res);
+      if (res.status === 401) throw new TokenRejectedError();
+      throw new SyncHttpError(res.status, detail);
+    }
+    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);
+    if (deps.failOnFailures === true) {
+      result.gate = gateExit(await readVerdict(doFetch, `${endpoint}/${id}/summary`, bearer));
+    }
+    return result;
   }
-  const body = await res.json().catch(() => ({}));
-  const id = typeof body.id === "string" ? body.id : "";
-  const result = { id, url: `${endpoint}/${id}` };
-  if (deps.failOnFailures === true) result.gate = gateExit(await readVerdict(doFetch, `${endpoint}/${id}/summary`, token));
-  return result;
 }
 async function readVerdict(doFetch, url, token) {
   try {

package/dist/index.js

@@ -1832,6 +1832,58 @@ 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;
@@ -1872,30 +1924,46 @@ async function handleSync(deps = {}) {
   const endpoint = `${apiUrl}/v1/runs`;
   const payload = JSON.stringify(run);
   const idempotencyKey = createHash2("sha256").update(payload).digest("hex");
-  let res;
+  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));
   try {
-    res = await doFetch(endpoint, {
-      method: "POST",
-      headers: {
-        "content-type": "application/json",
-        authorization: `Bearer ${token}`,
-        "idempotency-key": idempotencyKey
-      },
-      body: payload
-    });
-  } catch {
-    throw new SyncNetworkError(apiUrl);
+    const result = await upload();
+    await job.finish({ ok: true });
+    return result;
+  } catch (err) {
+    await job.finish({ ok: false, reason: err instanceof Error ? err.message : "Sync failed." });
+    throw err;
   }
-  if (!res.ok) {
-    const detail = await safeErrorDetail(res);
-    if (res.status === 401) throw new TokenRejectedError();
-    throw new SyncHttpError(res.status, detail);
+  async function upload() {
+    let res;
+    try {
+      res = await doFetch(endpoint, {
+        method: "POST",
+        headers: {
+          "content-type": "application/json",
+          authorization: `Bearer ${bearer}`,
+          "idempotency-key": idempotencyKey
+        },
+        body: payload
+      });
+    } catch {
+      throw new SyncNetworkError(apiUrl);
+    }
+    if (!res.ok) {
+      const detail = await safeErrorDetail(res);
+      if (res.status === 401) throw new TokenRejectedError();
+      throw new SyncHttpError(res.status, detail);
+    }
+    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);
+    if (deps.failOnFailures === true) {
+      result.gate = gateExit(await readVerdict(doFetch, `${endpoint}/${id}/summary`, bearer));
+    }
+    return result;
   }
-  const body = await res.json().catch(() => ({}));
-  const id = typeof body.id === "string" ? body.id : "";
-  const result = { id, url: `${endpoint}/${id}` };
-  if (deps.failOnFailures === true) result.gate = gateExit(await readVerdict(doFetch, `${endpoint}/${id}/summary`, token));
-  return result;
 }
 async function readVerdict(doFetch, url, token) {
   try {

package/package.json

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