@plune-ai/cli 0.12.0 → 0.13.0

package/README.md

@@ -100,7 +100,7 @@ provider API key is read from the environment based on `provider.type`:
 | `plune report` | Re-render the most recent run. Flags: `--format`, `-o`. |
 | `plune diff <baseline> <current>` | Compare two `plune run --format json` outputs and report pass→fail regressions. Flags: `--fail-on-regression`, `--format`, `-o`. |
 | `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` → Settings → API tokens. Flags: `--token <token>` (omit to paste it or pipe it via stdin), `--skip-verify` (save without checking, for offline setup). |
+| `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` → Settings → 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. |
 | `plune run import <file>` | Turn a **JUnit XML** or **Playwright JSON** report into a run in Plune. Needs no provider key — nothing is generated. Flags: `--format junit\|playwright-json` (detected from the file when omitted), `--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. |
@@ -112,6 +112,7 @@ provider API key is read from the environment based on `provider.type`:
 | `plune ingest [dir]` | Record a [Cairn](https://github.com/plune-ai/cairn) run in Plune. Omit `[dir]` for the newest run under `./runs`, or name the directory holding `report.json`. Generated cases arrive as **review proposals** — nothing is created until a person approves it. |
 | `plune pull [file]` | Write the project's test cases as **one Markdown document** — Testomat's classical format, plus Plune's own columns — to `plune/cases.md` (or `[file]`). Refuses to overwrite a file git sees as modified; `--force` overrides, `--suite <id>` takes one suite or folder and what is under it. |
 | `plune push [file] [--dry-run]` | Send the document back. Cases are matched by `id`; a block without one becomes a draft; an unknown id is refused by line; **nothing is deleted**. Prints the report — created, updated, unchanged, refused, warnings — and with `--dry-run` writes nothing. Exit `4` when anything was refused. |
+| `plune plan grep <id>` | Print a [test plan](https://docs.plune.ai/platform/plans/) as **one `--grep` pattern** — `npx playwright test --grep "$(plune plan grep <id>)"` or `npx vitest run -t "$(plune plan grep <id>)"` runs exactly what the plan collects. Each case contributes its title path from the `path-title` key the reporter wrote (the file left out, `[ >#]+` between the segments — a space for Playwright, jest, mocha and vitest ≤ 4, ` > ` for vitest 5), escaped, joined with `\|`; a case without one goes in by title. The pattern is all that reaches stdout; the summary — how many cases, how many keyed — goes to stderr. An empty plan prints `(?!)`, which matches nothing, because an empty `--grep` would run everything. |
 
 Global flags: `-c, --config <path>` · `-v, --verbose` · `--no-color`.
 
@@ -124,7 +125,7 @@ suite, there is nothing to generate — the results exist and only have to arriv
 costs nothing beyond a Plune token.
 
 ```bash
-plune login
+plune login                           # once, on your machine; in CI export PLUNE_TOKEN instead
 plune run import ./junit.xml          # Jest, Vitest, pytest, PHPUnit, Surefire, Cypress, …
 plune run import ./playwright.json    # or Playwright's own JSON report
 ```

package/dist/cli.cjs

@@ -2159,6 +2159,8 @@ function saveToken(token) {
   return file;
 }
 function loadToken() {
+  const fromEnv = process.env["PLUNE_TOKEN"]?.trim();
+  if (fromEnv !== void 0 && fromEnv !== "") return fromEnv;
   try {
     const parsed = JSON.parse((0, import_node_fs.readFileSync)(credentialsFile(), "utf-8"));
     return typeof parsed.token === "string" && parsed.token.length > 0 ? parsed.token : null;
@@ -4029,7 +4031,7 @@ var init_sync = __esm({
     init_credentials();
     NotLoggedInError = class extends Error {
       constructor() {
-        super('Not logged in. Run "plune login" first to save your API token.');
+        super('Not logged in. Run "plune login" first, or set PLUNE_TOKEN.');
         this.name = "NotLoggedInError";
       }
     };
@@ -4306,7 +4308,7 @@ var init_ingest = __esm({
     init_cairn_artifact();
     IngestNotLoggedInError = class extends Error {
       constructor() {
-        super('Not logged in. Run "plune login" first to save your API token.');
+        super('Not logged in. Run "plune login" first, or set PLUNE_TOKEN.');
         this.name = "IngestNotLoggedInError";
       }
     };
@@ -4472,6 +4474,68 @@ var init_cases = __esm({
   }
 });
 
+// src/cli/commands/plan.ts
+var plan_exports = {};
+__export(plan_exports, {
+  formatGrep: () => formatGrep,
+  grepFragment: () => grepFragment,
+  handlePlanGrep: () => handlePlanGrep
+});
+function grepFragment(c) {
+  const pathTitle = c.externalKeys.find((k) => k.kind === "path-title")?.value;
+  const segments = pathTitle?.split("#") ?? [c.title];
+  return (segments.length > 1 ? segments.slice(1) : segments).flatMap((s) => s.split(/ [>›] /)).map(escape).join(BOUNDARY);
+}
+function formatGrep(cases) {
+  if (cases.length === 0) return "(?!)";
+  return cases.map(grepFragment).join("|");
+}
+async function safeErrorDetail4(res) {
+  try {
+    const body = await res.json();
+    return typeof body.error === "string" ? body.error : "";
+  } catch {
+    return "";
+  }
+}
+async function handlePlanGrep(deps) {
+  const apiUrl = resolveApiUrl(deps.apiUrl);
+  const token = (deps.loadToken ?? loadToken)();
+  if (token === null) throw new NotLoggedInError();
+  const doFetch = deps.fetchImpl ?? fetch;
+  let res;
+  try {
+    res = await doFetch(`${apiUrl}/v1/plans/${encodeURIComponent(deps.planId)}/cases`, {
+      headers: { authorization: `Bearer ${token}` }
+    });
+  } catch {
+    throw new SyncNetworkError(apiUrl);
+  }
+  if (!res.ok) {
+    const detail = await safeErrorDetail4(res);
+    if (res.status === 401) throw new TokenRejectedError2();
+    throw new SyncHttpError(res.status, detail);
+  }
+  const { cases } = await res.json();
+  return {
+    pattern: formatGrep(cases),
+    cases: cases.length,
+    keyed: cases.filter((c) => c.externalKeys.some((k) => k.kind === "path-title")).length
+  };
+}
+var escape, BOUNDARY;
+var init_plan = __esm({
+  "src/cli/commands/plan.ts"() {
+    "use strict";
+    init_cjs_shims();
+    init_api_url();
+    init_credentials();
+    init_sync();
+    escape = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    BOUNDARY = "[ >#]+";
+  }
+});
+
 // src/cli.ts
 var cli_exports = {};
 __export(cli_exports, {
@@ -4905,6 +4969,30 @@ function createProgram() {
       failUnexpected(err, verbose);
     }
   });
+  const planCommand = program.command("plan").description("Test plans on the platform \u2014 what a plan collects, as something a runner can take");
+  planCommand.command("grep").argument("<id>", "The plan").description(
+    "Print the plan's cases as one --grep pattern for the runner (GET /v1/plans/:id/cases)"
+  ).action(async (id, _options, command) => {
+    const verbose = command.optsWithGlobals().verbose === true;
+    const { handlePlanGrep: handlePlanGrep2 } = await Promise.resolve().then(() => (init_plan(), plan_exports));
+    const { reportCasesFailure: reportCasesFailure2 } = await Promise.resolve().then(() => (init_cases(), cases_exports));
+    try {
+      const out = await handlePlanGrep2({ planId: id });
+      process.stdout.write(out.pattern + "\n");
+      process.stderr.write(
+        out.cases === 0 ? "plune: the plan matches no case \u2014 the pattern matches nothing.\n" : `plune: ${out.cases} case(s) in the plan, ${out.keyed} with a test key; the rest by title.
+`
+      );
+    } catch (err) {
+      const code = reportCasesFailure2(err, (s) => process.stderr.write(s));
+      if (code !== null) {
+        maybeStack(err, verbose);
+        process.exitCode = code;
+        return;
+      }
+      failUnexpected(err, verbose);
+    }
+  });
   program.on("command:*", (operands) => {
     process.stderr.write(`Unknown command: ${operands.join(" ")}
 `);

package/dist/index.cjs

@@ -1595,6 +1595,8 @@ function credentialsFile() {
   return (0, import_node_path.join)(base, "plune", "credentials.json");
 }
 function loadToken() {
+  const fromEnv = process.env["PLUNE_TOKEN"]?.trim();
+  if (fromEnv !== void 0 && fromEnv !== "") return fromEnv;
   try {
     const parsed = JSON.parse((0, import_node_fs.readFileSync)(credentialsFile(), "utf-8"));
     return typeof parsed.token === "string" && parsed.token.length > 0 ? parsed.token : null;
@@ -1606,7 +1608,7 @@ function loadToken() {
 // src/cli/commands/sync.ts
 var NotLoggedInError = class extends Error {
   constructor() {
-    super('Not logged in. Run "plune login" first to save your API token.');
+    super('Not logged in. Run "plune login" first, or set PLUNE_TOKEN.');
     this.name = "NotLoggedInError";
   }
 };
@@ -1862,7 +1864,7 @@ async function readCairnRun(dir, deps = {}) {
 // src/cli/commands/ingest.ts
 var IngestNotLoggedInError = class extends Error {
   constructor() {
-    super('Not logged in. Run "plune login" first to save your API token.');
+    super('Not logged in. Run "plune login" first, or set PLUNE_TOKEN.');
     this.name = "IngestNotLoggedInError";
   }
 };

package/dist/index.js

@@ -1542,6 +1542,8 @@ function credentialsFile() {
   return join3(base, "plune", "credentials.json");
 }
 function loadToken() {
+  const fromEnv = process.env["PLUNE_TOKEN"]?.trim();
+  if (fromEnv !== void 0 && fromEnv !== "") return fromEnv;
   try {
     const parsed = JSON.parse(readFileSync3(credentialsFile(), "utf-8"));
     return typeof parsed.token === "string" && parsed.token.length > 0 ? parsed.token : null;
@@ -1553,7 +1555,7 @@ function loadToken() {
 // src/cli/commands/sync.ts
 var NotLoggedInError = class extends Error {
   constructor() {
-    super('Not logged in. Run "plune login" first to save your API token.');
+    super('Not logged in. Run "plune login" first, or set PLUNE_TOKEN.');
     this.name = "NotLoggedInError";
   }
 };
@@ -1809,7 +1811,7 @@ async function readCairnRun(dir, deps = {}) {
 // src/cli/commands/ingest.ts
 var IngestNotLoggedInError = class extends Error {
   constructor() {
-    super('Not logged in. Run "plune login" first to save your API token.');
+    super('Not logged in. Run "plune login" first, or set PLUNE_TOKEN.');
     this.name = "IngestNotLoggedInError";
   }
 };

package/dist/reporter-core.cjs

@@ -60,6 +60,8 @@ function credentialsFile() {
   return (0, import_node_path.join)(base, "plune", "credentials.json");
 }
 function loadToken() {
+  const fromEnv = process.env["PLUNE_TOKEN"]?.trim();
+  if (fromEnv !== void 0 && fromEnv !== "") return fromEnv;
   try {
     const parsed = JSON.parse((0, import_node_fs.readFileSync)(credentialsFile(), "utf-8"));
     return typeof parsed.token === "string" && parsed.token.length > 0 ? parsed.token : null;

package/dist/reporter-core.js

@@ -17,6 +17,8 @@ function credentialsFile() {
   return join(base, "plune", "credentials.json");
 }
 function loadToken() {
+  const fromEnv = process.env["PLUNE_TOKEN"]?.trim();
+  if (fromEnv !== void 0 && fromEnv !== "") return fromEnv;
   try {
     const parsed = JSON.parse(readFileSync(credentialsFile(), "utf-8"));
     return typeof parsed.token === "string" && parsed.token.length > 0 ? parsed.token : null;

package/package.json

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