@plune-ai/cli 0.34.1 → 0.34.2

package/README.md

@@ -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

@@ -6698,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";
@@ -6828,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),
@@ -6890,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";
@@ -6904,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",
@@ -6999,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",
@@ -7364,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 },
@@ -7436,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);
@@ -7579,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";
@@ -7590,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,
@@ -7704,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" } : {}
   });
 }
@@ -8135,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) {
@@ -8146,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:
@@ -8176,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) {
@@ -8340,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) {

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.1",
+  "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",