@plune-ai/cli 0.34.0 → 0.34.2

package/README.md

@@ -117,7 +117,7 @@ the last resort, used only when `PLUNE_TOKEN` is set nowhere else. Nothing write
 | ------- | ------- |
 | `plune run` | Run the suite. Flags: `--dry-run` (price the run from the model's rates — no provider key, no network), `--only <id\|tag>` (repeatable), `--bail`, `--no-cache`, `--cache-strict`, `--cache-max-age <duration>`, `--concurrency <n>`, `--format console\|json\|markdown`, `-o, --output <file>`. |
 | `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 diff <baseline> <current>` | Compare two `plune run --format json` outputs and report pass→fail regressions. Flags: `--fail-on-regression` (exit `1` on a regression, `3` when none but an eval was not measured), `--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` → 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. |
@@ -631,6 +631,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

@@ -2010,7 +2010,8 @@ async function runOrchestration(config, options, deps) {
       limit,
       (row) => runRow({
         template,
-        assertions: ev.assertions,
+        // `defaults.assertions` apply to every eval, ahead of its own (#2415).
+        assertions: [...config.defaults?.assertions ?? [], ...ev.assertions],
         row,
         providerConfig,
         provider,
@@ -2887,13 +2888,13 @@ var init_fallback = __esm({
 function failureOf(attempt, home = (0, import_node_os2.homedir)()) {
   const error = chosen(attempt);
   const line = error === void 0 ? void 0 : firstLine(machineless(error.text, attempt.repoRoot, home));
-  const headline = line !== void 0 && jsonBytes(line) <= HEADLINE_LIMIT ? line : void 0;
+  const headline2 = line !== void 0 && jsonBytes(line) <= HEADLINE_LIMIT ? line : void 0;
   const steps = chainOf(attempt.steps);
   const location = error === void 0 ? void 0 : fromRoot(placeOf(error, attempt.testFile), attempt.repoRoot);
   const artifacts = attempt.attachments.filter((a) => a.path !== void 0 && !a.name.startsWith("_") && a.contentType !== METADATA_TYPE).map(({ name, contentType }) => ({ name: fileNameOf(name), ...contentType ? { contentType } : {} })).filter((a) => a.name !== "");
   const ciUrl = webLink(attempt.buildHref);
   const failure = {
-    ...headline !== void 0 ? { headline } : {},
+    ...headline2 !== void 0 ? { headline: headline2 } : {},
     ...steps.length > 0 ? { steps } : {},
     ...location !== void 0 ? { location } : {},
     ...artifacts.length > 0 ? { artifacts } : {},
@@ -6241,7 +6242,8 @@ function classify2(baseline, current) {
   if (baseline === "absent") return current === "passed" ? "new-pass" : "new-fail";
   if (current === "absent") return "removed";
   if (baseline === "passed") return current === "passed" ? "stable-pass" : "regression";
-  return current === "passed" ? "improvement" : "pre-existing-fail";
+  if (current === "passed") return "improvement";
+  return baseline === "errored" ? "unmeasured" : "pre-existing-fail";
 }
 function diffRuns(baseline, current) {
   const baseMap = new Map(baseline.evals.map((e) => [e.id, evalStatus(e)]));
@@ -6262,6 +6264,7 @@ function diffRuns(baseline, current) {
     stablePasses: count2("stable-pass"),
     errored: count2("errored"),
     removed: count2("removed"),
+    unmeasured: count2("errored") + count2("unmeasured"),
     hasRegression: count2("regression") > 0
   };
   return { evals, summary };
@@ -6332,6 +6335,11 @@ __export(diff_exports2, {
   renderDiff: () => renderDiff,
   renderDiffMarkdown: () => renderDiffMarkdown
 });
+function headline(d) {
+  if (d.summary.hasRegression) return { mark: "\u274C", text: `${d.summary.regressions} regression(s)` };
+  if (d.summary.unmeasured > 0) return { mark: "\u26A0\uFE0F", text: `${d.summary.unmeasured} eval(s) not measured` };
+  return null;
+}
 function summaryLine(d) {
   const s = d.summary;
   return [
@@ -6341,14 +6349,14 @@ function summaryLine(d) {
     `${s.preExistingFails} pre-existing-fail`,
     `${s.errored} errored`,
     `${s.removed} removed`,
+    `${s.unmeasured} not measured`,
     `${s.stablePasses} stable`
   ].join(" \xB7 ");
 }
 function renderDiffMarkdown(d) {
   const out = [STICKY_MARKER, "## Plune eval diff", ""];
-  out.push(
-    d.summary.hasRegression ? `### \u274C ${d.summary.regressions} regression(s)` : "### \u2705 No regressions"
-  );
+  const head = headline(d);
+  out.push(head ? `### ${head.mark} ${head.text}` : "### \u2705 No regressions");
   out.push("");
   const notable = d.evals.filter((e) => e.status !== "stable-pass");
   if (notable.length > 0) {
@@ -6363,9 +6371,8 @@ function renderDiffMarkdown(d) {
   return out.join("\n");
 }
 function renderDiffConsole(d) {
-  const out = [
-    d.summary.hasRegression ? `Plune eval diff: ${d.summary.regressions} regression(s)` : "Plune eval diff: no regressions"
-  ];
+  const head = headline(d);
+  const out = [`Plune eval diff: ${head ? head.text : "no regressions"}`];
   for (const e of d.evals) {
     if (e.status === "stable-pass") continue;
     out.push(`  ${e.id}: ${e.baseline} -> ${e.current} [${e.status}]`);
@@ -6395,6 +6402,7 @@ var init_diff3 = __esm({
       "new-pass": "\u{1F7E2} new pass",
       "stable-pass": "\u2705 stable",
       errored: "\u26A0\uFE0F errored",
+      unmeasured: "\u26A0\uFE0F not measured (baseline errored)",
       removed: "\u2796 removed"
     };
   }
@@ -6690,7 +6698,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";
@@ -6820,6 +6828,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),
@@ -6882,7 +6905,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";
@@ -6896,6 +6919,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",
@@ -6991,6 +7015,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",
@@ -7356,10 +7400,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 },
@@ -7428,6 +7472,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);
@@ -7571,7 +7627,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";
@@ -7582,6 +7638,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,
@@ -7696,13 +7753,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" } : {}
   });
 }
@@ -8127,7 +8184,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) {
@@ -8138,7 +8195,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:
@@ -8168,15 +8225,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) {
@@ -8332,15 +8389,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) {
@@ -9014,7 +9071,11 @@ ${missed.map((m) => `  - ${m}`).join("\n")}
       failUnexpected(err, globals.verbose === true);
     }
   });
-  program.command("diff").description("Compare two `plune run --format json` outputs and report regressions").argument("<baseline>", "Path to the baseline run JSON (e.g. from main)").argument("<current>", "Path to the current run JSON (e.g. from the PR)").option("--format <fmt>", "console | json | markdown", "console").option("--fail-on-regression", "Exit 1 when a pass\u2192fail regression is detected", false).option("-o, --output <path>", "Write the diff to a file instead of stdout").action(
+  program.command("diff").description("Compare two `plune run --format json` outputs and report regressions").argument("<baseline>", "Path to the baseline run JSON (e.g. from main)").argument("<current>", "Path to the current run JSON (e.g. from the PR)").option("--format <fmt>", "console | json | markdown", "console").option(
+    "--fail-on-regression",
+    "Exit 1 when a pass\u2192fail regression is detected, 3 when none is but an eval was not measured",
+    false
+  ).option("-o, --output <path>", "Write the diff to a file instead of stdout").action(
     async (baseline, current, options, command) => {
       const verbose = command.optsWithGlobals().verbose === true;
       const [{ handleDiff: handleDiff2, DiffInputError: DiffInputError2 }, { renderDiff: renderDiff2 }] = await Promise.all([
@@ -9024,7 +9085,9 @@ ${missed.map((m) => `  - ${m}`).join("\n")}
       try {
         const diff = handleDiff2({ baselinePath: baseline, currentPath: current });
         writeReport(renderDiff2(diff, toFormat(options.format)), options.output);
-        process.exitCode = options.failOnRegression && diff.summary.hasRegression ? 1 : 0;
+        process.exitCode = 0;
+        if (options.failOnRegression && diff.summary.hasRegression) process.exitCode = 1;
+        else if (options.failOnRegression && diff.summary.unmeasured > 0) process.exitCode = 3;
       } catch (err) {
         if (err instanceof DiffInputError2) {
           process.stderr.write(err.message + "\n");

package/dist/index.cjs

@@ -1647,7 +1647,8 @@ async function runOrchestration(config, options, deps) {
       limit,
       (row) => runRow({
         template,
-        assertions: ev.assertions,
+        // `defaults.assertions` apply to every eval, ahead of its own (#2415).
+        assertions: [...config.defaults?.assertions ?? [], ...ev.assertions],
         row,
         providerConfig,
         provider,

package/dist/index.js

@@ -1587,7 +1587,8 @@ async function runOrchestration(config, options, deps) {
       limit,
       (row) => runRow({
         template,
-        assertions: ev.assertions,
+        // `defaults.assertions` apply to every eval, ahead of its own (#2415).
+        assertions: [...config.defaults?.assertions ?? [], ...ev.assertions],
         row,
         providerConfig,
         provider,

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",
@@ -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",
@@ -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.0",
+  "version": "0.34.2",
   "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",