@plune-ai/cli 0.34.1 → 0.34.3

package/README.md

@@ -70,8 +70,10 @@ evals:
         value: "Paris"
 ```
 
-Datasets are JSONL, one row per line, shaped `{ "vars": { ... }, "expected"?: "..." }`. The
-provider API key is read from the environment based on `provider.type`:
+Datasets are JSONL, one row per line, shaped `{ "vars": { ... }, "expected"?: "..." }`. A line that
+is not valid JSON or not a row (no `vars`, or `vars` that is not an object) stops the run before
+any model call with `<file>:<line>` and what is wrong, exit code `2`, like any other configuration
+error. The provider API key is read from the environment based on `provider.type`:
 
 | Provider   | `provider.type` | Environment variable |
 | ---------- | --------------- | -------------------- |
@@ -631,6 +633,16 @@ once; the rest it finds with `plune_discover_tools`. Every write tool takes `dry
 100 items, and the agent is held to the platform's agent rules: a proposed case lands in the review
 queue, a bulk decision needs a confirm, and nothing is deleted through MCP.
 
+`plune_cases_generate` asks the project's AI for case proposals from pasted text (a requirement, a
+story, a ticket's text; 20 words to 12 000 characters, up to 12 proposals, 8 by default). It spends the
+project's AI budget, and its proposals wait in the review queue like any other until a person approves
+them. The run is queued: the tool answers with its id, and `plune_cases_generation_get` reads where it
+stands, what it produced and what it cost. A Jira ticket by its key is not taken over MCP: paste its
+text. The platform's refusals (409 `duplicate_source` until `confirmDuplicates: true`, 422 for text
+too short or too long, 429 limits, 503 / 409 when the project's AI is not set up) come back with
+their `code` as the platform sent them. Both tools work in the server's `--project` unless the call
+names a `projectId`.
+
 Claude Code:
 
 ```bash

package/dist/cli.cjs

@@ -2096,7 +2096,31 @@ function loadDataset(ref, baseDir) {
     return ref.examples;
   }
   const content = fs4.readFileSync(path4.resolve(baseDir, ref), "utf8");
-  return content.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0).map((line) => JSON.parse(line));
+  const rows = [];
+  content.split(/\r?\n/).forEach((line, i) => {
+    if (line.trim().length === 0) return;
+    let row;
+    try {
+      row = JSON.parse(line.trim());
+    } catch (err) {
+      throw new RunConfigError(`${ref}:${i + 1}: not valid JSON (${err.message})`);
+    }
+    const vars = isObject(row) ? row["vars"] : void 0;
+    if (!isObject(vars)) {
+      const why = isObject(row) && "vars" in row ? `vars: Invalid input: expected record, received ${typeName(vars)}` : 'this row has no "vars"';
+      throw new RunConfigError(
+        `${ref}:${i + 1}: a dataset row must be { "vars": { ... } }; ${why}`
+      );
+    }
+    rows.push(row);
+  });
+  return rows;
+}
+function isObject(value2) {
+  return typeof value2 === "object" && value2 !== null && !Array.isArray(value2);
+}
+function typeName(value2) {
+  return value2 === null ? "null" : Array.isArray(value2) ? "array" : typeof value2;
 }
 var fs4, path4;
 var init_dataset = __esm({
@@ -2105,6 +2129,7 @@ var init_dataset = __esm({
     init_cjs_shims();
     fs4 = __toESM(require("fs"), 1);
     path4 = __toESM(require("path"), 1);
+    init_run();
   }
 });
 
@@ -5662,21 +5687,21 @@ var init_playwright_json = __esm({
 });
 
 // src/importers/k6.ts
-function isObject(value2) {
+function isObject2(value2) {
   return typeof value2 === "object" && value2 !== null && !Array.isArray(value2);
 }
 function isK6Summary(parsed) {
-  if (!isObject(parsed) || !isObject(parsed["metrics"])) return false;
-  if (isObject(parsed["root_group"])) return true;
-  return Object.values(parsed["metrics"]).some((m) => isObject(m) && (typeof m["type"] === "string" || isObject(m["thresholds"])));
+  if (!isObject2(parsed) || !isObject2(parsed["metrics"])) return false;
+  if (isObject2(parsed["root_group"])) return true;
+  return Object.values(parsed["metrics"]).some((m) => isObject2(m) && (typeof m["type"] === "string" || isObject2(m["thresholds"])));
 }
 function passedOf(verdict) {
-  if (isObject(verdict) && typeof verdict["ok"] === "boolean") return verdict["ok"];
+  if (isObject2(verdict) && typeof verdict["ok"] === "boolean") return verdict["ok"];
   if (typeof verdict === "boolean") return !verdict;
   return void 0;
 }
 function measuredOf(metric) {
-  const values = isObject(metric.values) ? metric.values : metric;
+  const values = isObject2(metric.values) ? metric.values : metric;
   const unit = metric.contains === "time" ? " ms" : "";
   return Object.entries(values).filter(([name, v]) => name !== "thresholds" && typeof v === "number").map(([name, v]) => `${name}=${Math.round(v * 100) / 100}${unit}`).join(", ");
 }
@@ -5687,13 +5712,13 @@ function readK6(source, file) {
   } catch (err) {
     throw new JsonReportError(file, `not JSON \u2014 ${printable(err instanceof Error ? err.message : String(err))}`);
   }
-  if (!isObject(parsed) || !isObject(parsed["metrics"])) {
+  if (!isObject2(parsed) || !isObject2(parsed["metrics"])) {
     throw new JsonReportError(file, 'no "metrics" object \u2014 is this a k6 summary (k6 run --summary-export, or the data handleSummary receives)?');
   }
   const specRef = path13.basename(file);
   const out = [];
   for (const [name, raw] of Object.entries(parsed["metrics"])) {
-    if (!isObject(raw) || !isObject(raw["thresholds"])) continue;
+    if (!isObject2(raw) || !isObject2(raw["thresholds"])) continue;
     const metric = raw;
     const measured = measuredOf(metric);
     for (const [expression, verdict] of Object.entries(metric.thresholds)) {
@@ -5734,11 +5759,11 @@ var init_k6 = __esm({
 });
 
 // src/importers/lighthouse.ts
-function isObject2(value2) {
+function isObject3(value2) {
   return typeof value2 === "object" && value2 !== null && !Array.isArray(value2);
 }
 function isLighthouseReport(parsed) {
-  return isObject2(parsed) && typeof parsed["lighthouseVersion"] === "string" && isObject2(parsed["categories"]);
+  return isObject3(parsed) && typeof parsed["lighthouseVersion"] === "string" && isObject3(parsed["categories"]);
 }
 function idOf(key, category) {
   return typeof category.id === "string" && category.id !== "" ? category.id : key;
@@ -5747,7 +5772,7 @@ function executionOf2(report) {
   const started = typeof report["fetchTime"] === "string" ? new Date(report["fetchTime"]) : void 0;
   if (started === void 0 || Number.isNaN(started.getTime())) return void 0;
   const timing = report["timing"];
-  const total = isObject2(timing) && typeof timing["total"] === "number" && timing["total"] >= 0 ? Math.round(timing["total"]) : 0;
+  const total = isObject3(timing) && typeof timing["total"] === "number" && timing["total"] >= 0 ? Math.round(timing["total"]) : 0;
   return {
     startedAt: started.toISOString(),
     finishedAt: new Date(started.getTime() + total).toISOString(),
@@ -5757,7 +5782,7 @@ function executionOf2(report) {
 }
 function runtimeErrorOf(report) {
   const err = report["runtimeError"];
-  if (!isObject2(err)) return void 0;
+  if (!isObject3(err)) return void 0;
   const code = typeof err["code"] === "string" ? err["code"] : void 0;
   if (code === "NO_ERROR") return void 0;
   const message = typeof err["message"] === "string" ? err["message"] : void 0;
@@ -5778,11 +5803,11 @@ function readLighthouse(source, file, minScores = {}) {
   const categories = report["categories"];
   const url = ["requestedUrl", "finalDisplayedUrl", "finalUrl"].map((k) => report[k]).find((u) => typeof u === "string" && u !== "");
   const settings = report["configSettings"];
-  const formFactor = isObject2(settings) && typeof settings["formFactor"] === "string" && settings["formFactor"] !== "" ? settings["formFactor"] : void 0;
+  const formFactor = isObject3(settings) && typeof settings["formFactor"] === "string" && settings["formFactor"] !== "" ? settings["formFactor"] : void 0;
   const runtimeError = runtimeErrorOf(report);
   const execution = executionOf2(report);
   const specRef = path14.basename(file);
-  const known = Object.entries(categories).filter(([, raw]) => isObject2(raw)).map(([key, raw]) => idOf(key, raw));
+  const known = Object.entries(categories).filter(([, raw]) => isObject3(raw)).map(([key, raw]) => idOf(key, raw));
   if (known.length > 0) {
     for (const [id2, score] of Object.entries(minScores)) {
       if (!known.includes(id2)) {
@@ -5809,7 +5834,7 @@ function readLighthouse(source, file, minScores = {}) {
     });
   };
   for (const [key, raw] of Object.entries(categories)) {
-    if (!isObject2(raw)) continue;
+    if (!isObject3(raw)) continue;
     const category = raw;
     const id2 = idOf(key, category);
     const name = typeof category.title === "string" && category.title !== "" ? category.title : id2;
@@ -6698,7 +6723,7 @@ var init_logout = __esm({
 });
 
 // src/mcp-tools/schemas.ts
-var import_zod4, BATCH_MAX2, isHttp, httpLink, id, dryRun, MISSION_STATES, MISSION_DOCUMENTATION, MISSION_LINK_KINDS, missionName, missionSummary, missionUrl, missionFields, sourceTitle, sourceVersion, linkSource, fileSource, ACCESS_KINDS, questionText, questionInput, STRATEGY_SOURCE_KINDS, TEST_LEVELS, QUALITY_CHARACTERISTICS, TEST_TECHNIQUES, RISK_SCALE, itemFields, strategyItem, items, unique, linkIds, share, strategyContent, SOURCE_REF_KINDS, proposedCase, API_METHODS, proposedEndpoint, REVIEW_STATES, REVIEW_KINDS, REJECTION_CATEGORIES, entity, plannedRequest, writeOutput, batchOutput, bulkPreview;
+var import_zod4, BATCH_MAX2, isHttp, httpLink, id, dryRun, MISSION_STATES, MISSION_DOCUMENTATION, MISSION_LINK_KINDS, missionName, missionSummary, missionUrl, missionFields, sourceTitle, sourceVersion, linkSource, fileSource, ACCESS_KINDS, questionText, questionInput, STRATEGY_SOURCE_KINDS, TEST_LEVELS, QUALITY_CHARACTERISTICS, TEST_TECHNIQUES, RISK_SCALE, itemFields, strategyItem, items, unique, linkIds, share, strategyContent, SOURCE_REF_KINDS, proposedCase, CASE_GENERATION_TITLE_MAX, CASE_GENERATION_MAX_CASES, CASE_GENERATION_DEFAULT_CASES, CASE_GENERATION_MIN_WORDS, CASE_GENERATION_TEXT_MAX, caseGenerationBody, API_METHODS, proposedEndpoint, REVIEW_STATES, REVIEW_KINDS, REJECTION_CATEGORIES, entity, plannedRequest, writeOutput, batchOutput, bulkPreview;
 var init_schemas = __esm({
   "src/mcp-tools/schemas.ts"() {
     "use strict";
@@ -6828,6 +6853,21 @@ var init_schemas = __esm({
       source: import_zod4.z.strictObject({ kind: import_zod4.z.enum(SOURCE_REF_KINDS), value: import_zod4.z.string().min(1).max(100) }).optional().describe("What you read to design it"),
       rationale: import_zod4.z.string().min(1).max(400).optional().describe("Why the case is worth having")
     });
+    CASE_GENERATION_TITLE_MAX = 300;
+    CASE_GENERATION_MAX_CASES = 12;
+    CASE_GENERATION_DEFAULT_CASES = 8;
+    CASE_GENERATION_MIN_WORDS = 20;
+    CASE_GENERATION_TEXT_MAX = 12e3;
+    caseGenerationBody = {
+      input: import_zod4.z.strictObject({
+        kind: import_zod4.z.literal("pasted-text"),
+        text: import_zod4.z.string().describe(`The requirement, story or ticket text, at least ${CASE_GENERATION_MIN_WORDS} words and at most ${CASE_GENERATION_TEXT_MAX} characters`),
+        title: import_zod4.z.string().trim().max(CASE_GENERATION_TITLE_MAX).optional()
+      }),
+      maxCases: import_zod4.z.number().int().min(1).max(CASE_GENERATION_MAX_CASES).optional().describe(`How many proposals at most; ${CASE_GENERATION_DEFAULT_CASES} when left out`),
+      language: import_zod4.z.string().trim().min(2).max(35).optional().describe("The cases' language; the project's AI language when left out"),
+      confirmDuplicates: import_zod4.z.boolean().optional().describe("true: go ahead although cases or proposals from this text exist (the platform answers 409 duplicate_source first)")
+    };
     API_METHODS = ["GET", "PUT", "POST", "DELETE", "OPTIONS", "HEAD", "PATCH", "TRACE"];
     proposedEndpoint = import_zod4.z.strictObject({
       method: import_zod4.z.enum(API_METHODS),
@@ -6890,7 +6930,7 @@ function isPluneToolName(name) {
 function defaultVisibleTools(scope) {
   return PLUNE_TOOLS.filter((t) => t.visibility === "core" && !(scope === "read" && t.write)).map((t) => t.name);
 }
-var import_zod5, MAX_VISIBLE_TOOLS, define, listPage, missionId, PLUNE_TOOLS, PLUNE_TOOL_NAMES, BY_NAME;
+var import_zod5, MAX_VISIBLE_TOOLS, define, listPage, missionId, projectId, PLUNE_TOOLS, PLUNE_TOOL_NAMES, BY_NAME;
 var init_contract = __esm({
   "src/mcp-tools/contract.ts"() {
     "use strict";
@@ -6904,6 +6944,7 @@ var init_contract = __esm({
       cursor: import_zod5.z.string().min(1).optional().describe("nextCursor of the previous page")
     };
     missionId = id("The mission id");
+    projectId = import_zod5.z.string().min(1).optional().describe("The project; the one the server was started with when left out");
     PLUNE_TOOLS = [
       define({
         name: "plune_project_context",
@@ -6967,7 +7008,7 @@ var init_contract = __esm({
       define({
         name: "plune_review_decide",
         title: "Decide queue entries",
-        description: "Approve or reject up to 100 review queue entries in one decision. The first call changes nothing and returns a preview with a confirm value; repeat the same call with confirm to apply it.",
+        description: "Approve or reject up to 100 review queue entries in one decision. The first call changes nothing and returns a preview with a confirm value; repeat the same call with confirm to apply it. An entry skipped as policy_refused was refused by the review policy of the project (for example, the person who proposed it cannot approve it): do not retry it \u2014 it needs another reviewer; its detail says why.",
         input: import_zod5.z.strictObject({
           itemIds: import_zod5.z.array(import_zod5.z.string().min(1)).min(1).max(BATCH_MAX2).refine((a) => new Set(a).size === a.length, { message: "an id is named once" }),
           verdict: import_zod5.z.enum(["approved", "rejected"]),
@@ -6999,6 +7040,26 @@ var init_contract = __esm({
         visibility: "core",
         endpoints: ["POST /v1/ingest/cairn"]
       }),
+      define({
+        name: "plune_cases_generate",
+        title: "Generate cases from pasted text",
+        description: "Generate test case proposals from pasted text \u2014 a requirement, a user story, the text of a ticket \u2014 with the project's AI. It spends the project's AI budget. The proposals land in the review queue and nothing becomes a case until a person approves it. The run is queued: keep its id and poll it with plune_cases_generation_get until it is done. A Jira ticket by its key is not taken here: paste its text.",
+        input: import_zod5.z.strictObject({ projectId, ...caseGenerationBody, dry_run: dryRun }),
+        output: writeOutput,
+        write: true,
+        visibility: "core",
+        endpoints: ["POST /v1/projects/:id/case-generations"]
+      }),
+      define({
+        name: "plune_cases_generation_get",
+        title: "Read a case generation",
+        description: "Check where a run of cases from pasted text stands \u2014 queued, running, done, failed or cancelled \u2014 with how many proposals it made, how many it skipped, and what it cost.",
+        input: import_zod5.z.strictObject({ projectId, generationId: id("The id the start answered with") }),
+        output: import_zod5.z.object({ generation: entity }),
+        write: false,
+        visibility: "core",
+        endpoints: ["GET /v1/projects/:id/case-generations/:generationId"]
+      }),
       define({
         name: "plune_mission_create",
         title: "Create a mission",
@@ -7364,10 +7425,10 @@ function createPluneToolExecutor(opts) {
       ]);
       const projectList = asArray(asRecord(projects.body)["projects"]);
       const only = projectList.length === 1 ? asRecord(projectList[0])["id"] : void 0;
-      const projectId = opts.projectId ?? (typeof only === "string" ? only : null);
+      const projectId2 = opts.projectId ?? (typeof only === "string" ? only : null);
       const total = asRecord(cases.body)["total"];
       return {
-        projectId,
+        projectId: projectId2,
         projects: projectList,
         suites: asArray(asRecord(suites.body)["suites"]),
         cases: { total: typeof total === "number" ? total : 0 },
@@ -7436,6 +7497,18 @@ function createPluneToolExecutor(opts) {
       const proposed = summary["proposed"];
       return { dryRun: false, requested: cases.length, applied: typeof proposed === "number" ? proposed : 0, report: summary };
     },
+    async plune_cases_generate(i) {
+      const { dry_run, projectId: projectId2, ...body } = i;
+      const project = projectId2 ?? opts.projectId;
+      if (project === void 0) return fail("invalid_input", NO_PROJECT);
+      return write({ method: "POST", path: path19("/v1/projects/:id/case-generations", project), body: withoutUndefined(body) }, dry_run);
+    },
+    async plune_cases_generation_get(i) {
+      const project = i["projectId"] ?? opts.projectId;
+      if (project === void 0) return fail("invalid_input", NO_PROJECT);
+      const res = await call({ method: "GET", path: path19("/v1/projects/:id/case-generations/:generationId", project, str2(i["generationId"])) });
+      return { generation: asRecord(res.body) };
+    },
     async plune_mission_create(i) {
       const { dry_run, ...body } = i;
       return write({ method: "POST", path: "/v1/missions", body: withoutUndefined(body) }, dry_run);
@@ -7579,7 +7652,7 @@ function createPluneToolExecutor(opts) {
     }
   };
 }
-var import_node_crypto5, CONFIRM_TTL_MS, READ_ONLY_REFUSAL, readScopeMessage, fail, zodMessage, path19, withoutUndefined, asRecord, asArray, cursorOf, rawWrites;
+var import_node_crypto5, CONFIRM_TTL_MS, READ_ONLY_REFUSAL, NO_PROJECT, readScopeMessage, fail, zodMessage, path19, withoutUndefined, asRecord, asArray, cursorOf, rawWrites;
 var init_execute = __esm({
   "src/mcp-tools/execute.ts"() {
     "use strict";
@@ -7590,6 +7663,7 @@ var init_execute = __esm({
     init_schemas();
     CONFIRM_TTL_MS = 5 * 60 * 1e3;
     READ_ONLY_REFUSAL = "read-only token";
+    NO_PROJECT = "projectId is needed: the server was started without a project (--project or PLUNE_PROJECT). plune_project_context lists the projects.";
     readScopeMessage = (what) => `This token has the read scope, so ${what}. Use a token with the write scope (Plune \u2192 Account \u2192 API tokens) and restart the server.`;
     fail = (code, message, extra = {}) => ({
       ok: false,
@@ -7704,13 +7778,13 @@ async function handleMcpServe(flags, deps) {
   const token = (deps.loadToken ?? loadToken)();
   if (token === null) throw new NotLoggedInError();
   const apiUrl = resolveApiUrl(deps.apiUrl);
-  const projectId = flags.project?.trim() || process.env["PLUNE_PROJECT"]?.trim() || void 0;
+  const projectId2 = flags.project?.trim() || process.env["PLUNE_PROJECT"]?.trim() || void 0;
   const serve = deps.serve ?? (await Promise.resolve().then(() => (init_server(), server_exports))).serveStdio;
   await serve({
     token,
     apiUrl,
     version: deps.version,
-    ...projectId !== void 0 ? { projectId } : {},
+    ...projectId2 !== void 0 ? { projectId: projectId2 } : {},
     ...flags.readOnly === true ? { scope: "read" } : {}
   });
 }
@@ -8135,7 +8209,7 @@ function readMarkdown(cwd, file) {
   if (text2.trim() === "") usage(`${target} is empty.`);
   return text2;
 }
-function refusal(out, apiUrl, projectId) {
+function refusal(out, apiUrl, projectId2) {
   const d = out.detail;
   const said = d === "" ? "" : ` (${d})`;
   switch (out.status) {
@@ -8146,7 +8220,7 @@ function refusal(out, apiUrl, projectId) {
     case 403:
       return new RequirementsImportError(`The platform refused: ${d || "read-only member"}. Importing needs an owner or a member of the project.`, 1);
     case 404:
-      return /^project '.*' not found$/.test(d) ? new RequirementsImportError(`Project ${projectId} was not found for this token. A token only works in the project it was minted in; pass --project <id> or use a token from that project.`, 1) : new RequirementsImportError(SUPPORT, 1);
+      return /^project '.*' not found$/.test(d) ? new RequirementsImportError(`Project ${projectId2} was not found for this token. A token only works in the project it was minted in; pass --project <id> or use a token from that project.`, 1) : new RequirementsImportError(SUPPORT, 1);
     case 409:
       return new RequirementsImportError(`A requirement key was taken by another change while the import ran. Nothing was written; run it again${said}.`, 1);
     case 413:
@@ -8176,15 +8250,15 @@ async function handleRequirementsImport(deps) {
   const token = (deps.loadToken ?? loadToken)();
   if (token === null) throw new RequirementsImportError('Not logged in. Run "plune login" first, or set PLUNE_TOKEN.', 2);
   const client = createClient({ apiUrl, token, ...deps.fetchImpl !== void 0 ? { fetchImpl: deps.fetchImpl } : {} });
-  const projectId = await resolveProject(client, deps.project, apiUrl);
-  const base = `/v1/projects/${encodeURIComponent(projectId)}/requirements/import`;
+  const projectId2 = await resolveProject(client, deps.project, apiUrl);
+  const base = `/v1/projects/${encodeURIComponent(projectId2)}/requirements/import`;
   if (mapping === null) {
     const out2 = await client.post(`${base}/discover`, { markdown });
-    if (!out2.ok) throw refusal(out2, apiUrl, projectId);
+    if (!out2.ok) throw refusal(out2, apiUrl, projectId2);
     return { step: "discover", result: out2.body };
   }
   const out = await client.post(base, { markdown, dryRun: deps.yes !== true, ...mapping });
-  if (!out.ok) throw refusal(out, apiUrl, projectId);
+  if (!out.ok) throw refusal(out, apiUrl, projectId2);
   return { step: "import", report: out.body };
 }
 function formatDiscover(file, r) {
@@ -8340,15 +8414,15 @@ async function handleRequirementsLinks(deps) {
   const token = (deps.loadToken ?? loadToken)();
   if (token === null) throw new RequirementsImportError('Not logged in. Run "plune login" first, or set PLUNE_TOKEN.', 2);
   const client = createClient({ apiUrl, token, ...deps.fetchImpl !== void 0 ? { fetchImpl: deps.fetchImpl } : {} });
-  const projectId = await resolveProject(client, deps.project, apiUrl);
-  const base = `/v1/projects/${encodeURIComponent(projectId)}/requirements/import`;
+  const projectId2 = await resolveProject(client, deps.project, apiUrl);
+  const base = `/v1/projects/${encodeURIComponent(projectId2)}/requirements/import`;
   if (mapping === null) {
     const out2 = await client.post(`${base}/discover`, { markdown });
-    if (!out2.ok) throw refusal(out2, apiUrl, projectId);
+    if (!out2.ok) throw refusal(out2, apiUrl, projectId2);
     return { step: "discover", result: out2.body };
   }
   const out = await client.post(`${base}/links`, { markdown, dryRun: deps.yes !== true, ...mapping });
-  if (!out.ok) throw refusal(out, apiUrl, projectId);
+  if (!out.ok) throw refusal(out, apiUrl, projectId2);
   return { step: "links", report: out.body };
 }
 function formatLinksDiscover(file, r) {

package/dist/index.cjs

@@ -1686,7 +1686,31 @@ function loadDataset(ref, baseDir) {
     return ref.examples;
   }
   const content = fs4.readFileSync(path3.resolve(baseDir, ref), "utf8");
-  return content.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0).map((line) => JSON.parse(line));
+  const rows = [];
+  content.split(/\r?\n/).forEach((line, i) => {
+    if (line.trim().length === 0) return;
+    let row;
+    try {
+      row = JSON.parse(line.trim());
+    } catch (err) {
+      throw new RunConfigError(`${ref}:${i + 1}: not valid JSON (${err.message})`);
+    }
+    const vars = isObject(row) ? row["vars"] : void 0;
+    if (!isObject(vars)) {
+      const why = isObject(row) && "vars" in row ? `vars: Invalid input: expected record, received ${typeName(vars)}` : 'this row has no "vars"';
+      throw new RunConfigError(
+        `${ref}:${i + 1}: a dataset row must be { "vars": { ... } }; ${why}`
+      );
+    }
+    rows.push(row);
+  });
+  return rows;
+}
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function typeName(value) {
+  return value === null ? "null" : Array.isArray(value) ? "array" : typeof value;
 }
 
 // src/cli/commands/run.ts

package/dist/index.js

@@ -1626,7 +1626,31 @@ function loadDataset(ref, baseDir) {
     return ref.examples;
   }
   const content = fs4.readFileSync(path3.resolve(baseDir, ref), "utf8");
-  return content.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0).map((line) => JSON.parse(line));
+  const rows = [];
+  content.split(/\r?\n/).forEach((line, i) => {
+    if (line.trim().length === 0) return;
+    let row;
+    try {
+      row = JSON.parse(line.trim());
+    } catch (err) {
+      throw new RunConfigError(`${ref}:${i + 1}: not valid JSON (${err.message})`);
+    }
+    const vars = isObject(row) ? row["vars"] : void 0;
+    if (!isObject(vars)) {
+      const why = isObject(row) && "vars" in row ? `vars: Invalid input: expected record, received ${typeName(vars)}` : 'this row has no "vars"';
+      throw new RunConfigError(
+        `${ref}:${i + 1}: a dataset row must be { "vars": { ... } }; ${why}`
+      );
+    }
+    rows.push(row);
+  });
+  return rows;
+}
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function typeName(value) {
+  return value === null ? "null" : Array.isArray(value) ? "array" : typeof value;
 }
 
 // src/cli/commands/run.ts

package/dist/mcp-tools.cjs

@@ -163,6 +163,21 @@ var proposedCase = import_zod.z.strictObject({
   source: import_zod.z.strictObject({ kind: import_zod.z.enum(SOURCE_REF_KINDS), value: import_zod.z.string().min(1).max(100) }).optional().describe("What you read to design it"),
   rationale: import_zod.z.string().min(1).max(400).optional().describe("Why the case is worth having")
 });
+var CASE_GENERATION_TITLE_MAX = 300;
+var CASE_GENERATION_MAX_CASES = 12;
+var CASE_GENERATION_DEFAULT_CASES = 8;
+var CASE_GENERATION_MIN_WORDS = 20;
+var CASE_GENERATION_TEXT_MAX = 12e3;
+var caseGenerationBody = {
+  input: import_zod.z.strictObject({
+    kind: import_zod.z.literal("pasted-text"),
+    text: import_zod.z.string().describe(`The requirement, story or ticket text, at least ${CASE_GENERATION_MIN_WORDS} words and at most ${CASE_GENERATION_TEXT_MAX} characters`),
+    title: import_zod.z.string().trim().max(CASE_GENERATION_TITLE_MAX).optional()
+  }),
+  maxCases: import_zod.z.number().int().min(1).max(CASE_GENERATION_MAX_CASES).optional().describe(`How many proposals at most; ${CASE_GENERATION_DEFAULT_CASES} when left out`),
+  language: import_zod.z.string().trim().min(2).max(35).optional().describe("The cases' language; the project's AI language when left out"),
+  confirmDuplicates: import_zod.z.boolean().optional().describe("true: go ahead although cases or proposals from this text exist (the platform answers 409 duplicate_source first)")
+};
 var API_METHODS = ["GET", "PUT", "POST", "DELETE", "OPTIONS", "HEAD", "PATCH", "TRACE"];
 var proposedEndpoint = import_zod.z.strictObject({
   method: import_zod.z.enum(API_METHODS),
@@ -219,6 +234,7 @@ var listPage = {
   cursor: import_zod2.z.string().min(1).optional().describe("nextCursor of the previous page")
 };
 var missionId = id("The mission id");
+var projectId = import_zod2.z.string().min(1).optional().describe("The project; the one the server was started with when left out");
 var PLUNE_TOOLS = [
   define({
     name: "plune_project_context",
@@ -282,7 +298,7 @@ var PLUNE_TOOLS = [
   define({
     name: "plune_review_decide",
     title: "Decide queue entries",
-    description: "Approve or reject up to 100 review queue entries in one decision. The first call changes nothing and returns a preview with a confirm value; repeat the same call with confirm to apply it.",
+    description: "Approve or reject up to 100 review queue entries in one decision. The first call changes nothing and returns a preview with a confirm value; repeat the same call with confirm to apply it. An entry skipped as policy_refused was refused by the review policy of the project (for example, the person who proposed it cannot approve it): do not retry it \u2014 it needs another reviewer; its detail says why.",
     input: import_zod2.z.strictObject({
       itemIds: import_zod2.z.array(import_zod2.z.string().min(1)).min(1).max(BATCH_MAX).refine((a) => new Set(a).size === a.length, { message: "an id is named once" }),
       verdict: import_zod2.z.enum(["approved", "rejected"]),
@@ -314,6 +330,26 @@ var PLUNE_TOOLS = [
     visibility: "core",
     endpoints: ["POST /v1/ingest/cairn"]
   }),
+  define({
+    name: "plune_cases_generate",
+    title: "Generate cases from pasted text",
+    description: "Generate test case proposals from pasted text \u2014 a requirement, a user story, the text of a ticket \u2014 with the project's AI. It spends the project's AI budget. The proposals land in the review queue and nothing becomes a case until a person approves it. The run is queued: keep its id and poll it with plune_cases_generation_get until it is done. A Jira ticket by its key is not taken here: paste its text.",
+    input: import_zod2.z.strictObject({ projectId, ...caseGenerationBody, dry_run: dryRun }),
+    output: writeOutput,
+    write: true,
+    visibility: "core",
+    endpoints: ["POST /v1/projects/:id/case-generations"]
+  }),
+  define({
+    name: "plune_cases_generation_get",
+    title: "Read a case generation",
+    description: "Check where a run of cases from pasted text stands \u2014 queued, running, done, failed or cancelled \u2014 with how many proposals it made, how many it skipped, and what it cost.",
+    input: import_zod2.z.strictObject({ projectId, generationId: id("The id the start answered with") }),
+    output: import_zod2.z.object({ generation: entity }),
+    write: false,
+    visibility: "core",
+    endpoints: ["GET /v1/projects/:id/case-generations/:generationId"]
+  }),
   define({
     name: "plune_mission_create",
     title: "Create a mission",
@@ -607,6 +643,7 @@ function createPluneApi(opts) {
 // src/mcp-tools/execute.ts
 var CONFIRM_TTL_MS = 5 * 60 * 1e3;
 var READ_ONLY_REFUSAL = "read-only token";
+var NO_PROJECT = "projectId is needed: the server was started without a project (--project or PLUNE_PROJECT). plune_project_context lists the projects.";
 var readScopeMessage = (what) => `This token has the read scope, so ${what}. Use a token with the write scope (Plune \u2192 Account \u2192 API tokens) and restart the server.`;
 var fail = (code, message, extra = {}) => ({
   ok: false,
@@ -701,10 +738,10 @@ function createPluneToolExecutor(opts) {
       ]);
       const projectList = asArray(asRecord(projects.body)["projects"]);
       const only = projectList.length === 1 ? asRecord(projectList[0])["id"] : void 0;
-      const projectId = opts.projectId ?? (typeof only === "string" ? only : null);
+      const projectId2 = opts.projectId ?? (typeof only === "string" ? only : null);
       const total = asRecord(cases.body)["total"];
       return {
-        projectId,
+        projectId: projectId2,
         projects: projectList,
         suites: asArray(asRecord(suites.body)["suites"]),
         cases: { total: typeof total === "number" ? total : 0 },
@@ -773,6 +810,18 @@ function createPluneToolExecutor(opts) {
       const proposed = summary["proposed"];
       return { dryRun: false, requested: cases.length, applied: typeof proposed === "number" ? proposed : 0, report: summary };
     },
+    async plune_cases_generate(i) {
+      const { dry_run, projectId: projectId2, ...body } = i;
+      const project = projectId2 ?? opts.projectId;
+      if (project === void 0) return fail("invalid_input", NO_PROJECT);
+      return write({ method: "POST", path: path("/v1/projects/:id/case-generations", project), body: withoutUndefined(body) }, dry_run);
+    },
+    async plune_cases_generation_get(i) {
+      const project = i["projectId"] ?? opts.projectId;
+      if (project === void 0) return fail("invalid_input", NO_PROJECT);
+      const res = await call({ method: "GET", path: path("/v1/projects/:id/case-generations/:generationId", project, str(i["generationId"])) });
+      return { generation: asRecord(res.body) };
+    },
     async plune_mission_create(i) {
       const { dry_run, ...body } = i;
       return write({ method: "POST", path: "/v1/missions", body: withoutUndefined(body) }, dry_run);

package/dist/mcp-tools.d.cts

@@ -208,6 +208,53 @@ declare const PLUNE_TOOLS: readonly [{
     write: true;
     visibility: "core";
     endpoints: string[];
+}, {
+    name: string;
+    title: string;
+    description: string;
+    input: z.ZodObject<{
+        dry_run: z.ZodOptional<z.ZodBoolean>;
+        input: z.ZodObject<{
+            kind: z.ZodLiteral<"pasted-text">;
+            text: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        maxCases: z.ZodOptional<z.ZodNumber>;
+        language: z.ZodOptional<z.ZodString>;
+        confirmDuplicates: z.ZodOptional<z.ZodBoolean>;
+        projectId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    output: z.ZodObject<{
+        dryRun: z.ZodBoolean;
+        request: z.ZodOptional<z.ZodObject<{
+            method: z.ZodString;
+            path: z.ZodString;
+            query: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            body: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$strip>>;
+        result: z.ZodOptional<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+    }, z.core.$strip>;
+    write: true;
+    visibility: "core";
+    endpoints: string[];
+}, {
+    name: string;
+    title: string;
+    description: string;
+    input: z.ZodObject<{
+        projectId: z.ZodOptional<z.ZodString>;
+        generationId: z.ZodString;
+    }, z.core.$strict>;
+    output: z.ZodObject<{
+        generation: z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+    }, z.core.$strip>;
+    write: false;
+    visibility: "core";
+    endpoints: string[];
 }, {
     name: string;
     title: string;

package/dist/mcp-tools.d.ts

@@ -208,6 +208,53 @@ declare const PLUNE_TOOLS: readonly [{
     write: true;
     visibility: "core";
     endpoints: string[];
+}, {
+    name: string;
+    title: string;
+    description: string;
+    input: z.ZodObject<{
+        dry_run: z.ZodOptional<z.ZodBoolean>;
+        input: z.ZodObject<{
+            kind: z.ZodLiteral<"pasted-text">;
+            text: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        maxCases: z.ZodOptional<z.ZodNumber>;
+        language: z.ZodOptional<z.ZodString>;
+        confirmDuplicates: z.ZodOptional<z.ZodBoolean>;
+        projectId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    output: z.ZodObject<{
+        dryRun: z.ZodBoolean;
+        request: z.ZodOptional<z.ZodObject<{
+            method: z.ZodString;
+            path: z.ZodString;
+            query: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            body: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$strip>>;
+        result: z.ZodOptional<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+    }, z.core.$strip>;
+    write: true;
+    visibility: "core";
+    endpoints: string[];
+}, {
+    name: string;
+    title: string;
+    description: string;
+    input: z.ZodObject<{
+        projectId: z.ZodOptional<z.ZodString>;
+        generationId: z.ZodString;
+    }, z.core.$strict>;
+    output: z.ZodObject<{
+        generation: z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+    }, z.core.$strip>;
+    write: false;
+    visibility: "core";
+    endpoints: string[];
 }, {
     name: string;
     title: string;

package/dist/mcp-tools.js

@@ -127,6 +127,21 @@ var proposedCase = z.strictObject({
   source: z.strictObject({ kind: z.enum(SOURCE_REF_KINDS), value: z.string().min(1).max(100) }).optional().describe("What you read to design it"),
   rationale: z.string().min(1).max(400).optional().describe("Why the case is worth having")
 });
+var CASE_GENERATION_TITLE_MAX = 300;
+var CASE_GENERATION_MAX_CASES = 12;
+var CASE_GENERATION_DEFAULT_CASES = 8;
+var CASE_GENERATION_MIN_WORDS = 20;
+var CASE_GENERATION_TEXT_MAX = 12e3;
+var caseGenerationBody = {
+  input: z.strictObject({
+    kind: z.literal("pasted-text"),
+    text: z.string().describe(`The requirement, story or ticket text, at least ${CASE_GENERATION_MIN_WORDS} words and at most ${CASE_GENERATION_TEXT_MAX} characters`),
+    title: z.string().trim().max(CASE_GENERATION_TITLE_MAX).optional()
+  }),
+  maxCases: z.number().int().min(1).max(CASE_GENERATION_MAX_CASES).optional().describe(`How many proposals at most; ${CASE_GENERATION_DEFAULT_CASES} when left out`),
+  language: z.string().trim().min(2).max(35).optional().describe("The cases' language; the project's AI language when left out"),
+  confirmDuplicates: z.boolean().optional().describe("true: go ahead although cases or proposals from this text exist (the platform answers 409 duplicate_source first)")
+};
 var API_METHODS = ["GET", "PUT", "POST", "DELETE", "OPTIONS", "HEAD", "PATCH", "TRACE"];
 var proposedEndpoint = z.strictObject({
   method: z.enum(API_METHODS),
@@ -183,6 +198,7 @@ var listPage = {
   cursor: z2.string().min(1).optional().describe("nextCursor of the previous page")
 };
 var missionId = id("The mission id");
+var projectId = z2.string().min(1).optional().describe("The project; the one the server was started with when left out");
 var PLUNE_TOOLS = [
   define({
     name: "plune_project_context",
@@ -246,7 +262,7 @@ var PLUNE_TOOLS = [
   define({
     name: "plune_review_decide",
     title: "Decide queue entries",
-    description: "Approve or reject up to 100 review queue entries in one decision. The first call changes nothing and returns a preview with a confirm value; repeat the same call with confirm to apply it.",
+    description: "Approve or reject up to 100 review queue entries in one decision. The first call changes nothing and returns a preview with a confirm value; repeat the same call with confirm to apply it. An entry skipped as policy_refused was refused by the review policy of the project (for example, the person who proposed it cannot approve it): do not retry it \u2014 it needs another reviewer; its detail says why.",
     input: z2.strictObject({
       itemIds: z2.array(z2.string().min(1)).min(1).max(BATCH_MAX).refine((a) => new Set(a).size === a.length, { message: "an id is named once" }),
       verdict: z2.enum(["approved", "rejected"]),
@@ -278,6 +294,26 @@ var PLUNE_TOOLS = [
     visibility: "core",
     endpoints: ["POST /v1/ingest/cairn"]
   }),
+  define({
+    name: "plune_cases_generate",
+    title: "Generate cases from pasted text",
+    description: "Generate test case proposals from pasted text \u2014 a requirement, a user story, the text of a ticket \u2014 with the project's AI. It spends the project's AI budget. The proposals land in the review queue and nothing becomes a case until a person approves it. The run is queued: keep its id and poll it with plune_cases_generation_get until it is done. A Jira ticket by its key is not taken here: paste its text.",
+    input: z2.strictObject({ projectId, ...caseGenerationBody, dry_run: dryRun }),
+    output: writeOutput,
+    write: true,
+    visibility: "core",
+    endpoints: ["POST /v1/projects/:id/case-generations"]
+  }),
+  define({
+    name: "plune_cases_generation_get",
+    title: "Read a case generation",
+    description: "Check where a run of cases from pasted text stands \u2014 queued, running, done, failed or cancelled \u2014 with how many proposals it made, how many it skipped, and what it cost.",
+    input: z2.strictObject({ projectId, generationId: id("The id the start answered with") }),
+    output: z2.object({ generation: entity }),
+    write: false,
+    visibility: "core",
+    endpoints: ["GET /v1/projects/:id/case-generations/:generationId"]
+  }),
   define({
     name: "plune_mission_create",
     title: "Create a mission",
@@ -571,6 +607,7 @@ function createPluneApi(opts) {
 // src/mcp-tools/execute.ts
 var CONFIRM_TTL_MS = 5 * 60 * 1e3;
 var READ_ONLY_REFUSAL = "read-only token";
+var NO_PROJECT = "projectId is needed: the server was started without a project (--project or PLUNE_PROJECT). plune_project_context lists the projects.";
 var readScopeMessage = (what) => `This token has the read scope, so ${what}. Use a token with the write scope (Plune \u2192 Account \u2192 API tokens) and restart the server.`;
 var fail = (code, message, extra = {}) => ({
   ok: false,
@@ -665,10 +702,10 @@ function createPluneToolExecutor(opts) {
       ]);
       const projectList = asArray(asRecord(projects.body)["projects"]);
       const only = projectList.length === 1 ? asRecord(projectList[0])["id"] : void 0;
-      const projectId = opts.projectId ?? (typeof only === "string" ? only : null);
+      const projectId2 = opts.projectId ?? (typeof only === "string" ? only : null);
       const total = asRecord(cases.body)["total"];
       return {
-        projectId,
+        projectId: projectId2,
         projects: projectList,
         suites: asArray(asRecord(suites.body)["suites"]),
         cases: { total: typeof total === "number" ? total : 0 },
@@ -737,6 +774,18 @@ function createPluneToolExecutor(opts) {
       const proposed = summary["proposed"];
       return { dryRun: false, requested: cases.length, applied: typeof proposed === "number" ? proposed : 0, report: summary };
     },
+    async plune_cases_generate(i) {
+      const { dry_run, projectId: projectId2, ...body } = i;
+      const project = projectId2 ?? opts.projectId;
+      if (project === void 0) return fail("invalid_input", NO_PROJECT);
+      return write({ method: "POST", path: path("/v1/projects/:id/case-generations", project), body: withoutUndefined(body) }, dry_run);
+    },
+    async plune_cases_generation_get(i) {
+      const project = i["projectId"] ?? opts.projectId;
+      if (project === void 0) return fail("invalid_input", NO_PROJECT);
+      const res = await call({ method: "GET", path: path("/v1/projects/:id/case-generations/:generationId", project, str(i["generationId"])) });
+      return { generation: asRecord(res.body) };
+    },
     async plune_mission_create(i) {
       const { dry_run, ...body } = i;
       return write({ method: "POST", path: "/v1/missions", body: withoutUndefined(body) }, dry_run);

package/package.json

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