@taiga-ai/mcp-server 0.25.0-dev.473 → 0.25.0-dev.475

package/dist/index.js

@@ -2256,6 +2256,11 @@ function emptyOriginNote(origin, product) {
 	}
 }
 /**
+* What finishing does, in every next step that ends at it (PRO-2857): it
+* starts paid planning, so a client must ask the person before calling it.
+*/
+const FINISH_DISCOVERY = "taiga_finish_discovery opens the product and starts planning its first initiatives (paid agent work: ask the person first).";
+/**
 * What a product in setup waits for, as the next call to make. Nothing on a
 * draft product says it otherwise: discoveryStep names the step and
 * importStatus the import, and the way on from each lives in tool
@@ -2266,17 +2271,17 @@ function setupNextStep(product) {
 	if (product?.status !== "draft") return null;
 	if (isImportedProduct(product)) switch (importStatusOf(product)) {
 		case "analyzing":
-		case "generating_docs": return "The import is running and derives the documents from the code (taiga_wait_for_job follows its job). Then review them, and taiga_finish_discovery opens the product.";
-		case "complete": return "The import is done: review the reality documents (taiga_get_product_document without type), then taiga_finish_discovery opens the product.";
+		case "generating_docs": return `The import is running and derives the documents from the code (taiga_wait_for_job follows its job). Then review them, and ${FINISH_DISCOVERY}`;
+		case "complete": return "The import is done: review the reality documents (taiga_get_product_document without type), then taiga_finish_discovery opens the product and starts planning its first initiatives (paid agent work: ask the person first).";
 		case "failed":
 		case "cancelled": return "The last import did not finish: taiga_start_import runs it again.";
 		default: return "Link its repository if it has none (taiga_list_linkable_repositories, taiga_link_repository), then taiga_start_import: the import derives the documents from the code and runs by itself.";
 	}
 	if (product.discoveryStep === void 0) return null;
 	switch (product.discoveryStep) {
-		case "documents": return "The specification is done; the other documents are generated from it (taiga_generate_product_documents starts the ones still missing). Once every required one is published, taiga_finish_discovery opens the product.";
-		case "checks": return "The documents are published; the checks are stamped in the web, then taiga_finish_discovery opens the product.";
-		default: return "Discovery is a conversation held in the web: the person describes the product there and the specification comes out of it. The other documents follow, then taiga_finish_discovery opens the product.";
+		case "documents": return `The specification is done; the other documents are generated from it (taiga_generate_product_documents starts the ones still missing). Once every required one is published, ${FINISH_DISCOVERY}`;
+		case "checks": return `The documents are published; the checks are stamped in the web, then ${FINISH_DISCOVERY}`;
+		default: return `Discovery is a conversation held in the web: the person describes the product there and the specification comes out of it. The other documents follow, then ${FINISH_DISCOVERY}`;
 	}
 }
 /** What discoveryStep says, for a description that shows it. */
@@ -2823,7 +2828,7 @@ async function setupReadiness(client, product, links) {
 	};
 }
 function nextStepFor(state) {
-	const finish = "taiga_finish_discovery opens the product and locks its documents (ask the person: it is their decision that the documents are right).";
+	const finish = "taiga_finish_discovery opens the product, locks its documents and starts planning the first initiatives (paid agent work; ask the person: it is their decision that the documents are right).";
 	if (state.imported) {
 		if (state.linked === false) return "Link its repository (taiga_list_linkable_repositories, then taiga_link_repository), then taiga_start_import.";
 		if (state.linked === null && state.importState === "not started") return setupNextStep(state.product);
@@ -21672,7 +21677,7 @@ function registerSetupTools(server, client) {
 	}, (params) => runTool(async () => toolResult((await client.refreshRealityDocuments(params.productId, params.docTypes)).data)));
 	server.registerTool("taiga_finish_discovery", {
 		title: "Finish Discovery",
-		description: "Finish a product's Discovery: it locks the documents and opens the rest of the product; for an imported product the first initiatives are planned. Refused (CONFLICT) with details.reason: documents_incomplete (details.missingDocuments lists them and how they are made), not_in_setup (already finished), or a required check not yet stamped (stamped in the web). A locked document changes only after taiga_reopen_discovery. The person decides the documents are right: ask first.",
+		description: "Finish a product's Discovery: it locks the documents, opens the rest of the product and starts planning the first initiatives (paid agent work; an imported product plans once its scan and policy assessment settle). Refused (CONFLICT) with details.reason: documents_incomplete (details.missingDocuments lists them and how they are made), not_in_setup (already finished), or a required check not yet stamped (stamped in the web). A locked document changes only after taiga_reopen_discovery. The person decides the documents are right: ask first.",
 		inputSchema: z.object({ productId }),
 		annotations: OPERATE
 	}, (params) => runTool(async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taiga-ai/mcp-server",
-  "version": "0.25.0-dev.473",
+  "version": "0.25.0-dev.475",
   "description": "MCP server for Taiga -- gives AI assistants access to documents and products",
   "type": "module",
   "main": "./dist/index.js",

package/src/tools/catalogue.ts

@@ -161,6 +161,13 @@ export function emptyOriginNote(
   }
 }
 
+/**
+ * What finishing does, in every next step that ends at it (PRO-2857): it
+ * starts paid planning, so a client must ask the person before calling it.
+ */
+const FINISH_DISCOVERY =
+  'taiga_finish_discovery opens the product and starts planning its first initiatives (paid agent work: ask the person first).';
+
 /**
  * What a product in setup waits for, as the next call to make. Nothing on a
  * draft product says it otherwise: discoveryStep names the step and
@@ -178,12 +185,12 @@ export function setupNextStep(
       case 'generating_docs':
         return (
           'The import is running and derives the documents from the code (taiga_wait_for_job follows its job). ' +
-          'Then review them, and taiga_finish_discovery opens the product.'
+          `Then review them, and ${FINISH_DISCOVERY}`
         );
       case 'complete':
         return (
           'The import is done: review the reality documents (taiga_get_product_document without type), then ' +
-          'taiga_finish_discovery opens the product.'
+          FINISH_DISCOVERY
         );
       case 'failed':
       case 'cancelled':
@@ -204,14 +211,14 @@ export function setupNextStep(
       return (
         'The specification is done; the other documents are generated from it ' +
         '(taiga_generate_product_documents starts the ones still missing). Once every required one is ' +
-        'published, taiga_finish_discovery opens the product.'
+        `published, ${FINISH_DISCOVERY}`
       );
     case 'checks':
-      return 'The documents are published; the checks are stamped in the web, then taiga_finish_discovery opens the product.';
+      return `The documents are published; the checks are stamped in the web, then ${FINISH_DISCOVERY}`;
     default:
       return (
         'Discovery is a conversation held in the web: the person describes the product there and the ' +
-        'specification comes out of it. The other documents follow, then taiga_finish_discovery opens the product.'
+        `specification comes out of it. The other documents follow, then ${FINISH_DISCOVERY}`
       );
   }
 }

package/src/tools/readiness.ts

@@ -127,8 +127,8 @@ function nextStepFor(state: {
   product: Row;
 }): string | null {
   const finish =
-    'taiga_finish_discovery opens the product and locks its documents (ask the person: it is their decision ' +
-    'that the documents are right).';
+    'taiga_finish_discovery opens the product, locks its documents and starts planning the first initiatives ' +
+    '(paid agent work; ask the person: it is their decision that the documents are right).';
   if (state.imported) {
     if (state.linked === false) {
       return 'Link its repository (taiga_list_linkable_repositories, then taiga_link_repository), then taiga_start_import.';

package/src/tools/setup.ts

@@ -386,8 +386,9 @@ export function registerSetupTools(server: McpServer, client: TaigaClient) {
     {
       title: 'Finish Discovery',
       description:
-        "Finish a product's Discovery: it locks the documents and opens the rest of the product; for an imported " +
-        'product the first initiatives are planned. Refused (CONFLICT) with details.reason: documents_incomplete ' +
+        "Finish a product's Discovery: it locks the documents, opens the rest of the product and starts planning " +
+        'the first initiatives (paid agent work; an imported product plans once its scan and policy assessment ' +
+        'settle). Refused (CONFLICT) with details.reason: documents_incomplete ' +
         '(details.missingDocuments lists them and how they are made), not_in_setup (already finished), or a ' +
         'required check not yet stamped (stamped in the web). A locked document changes only after ' +
         'taiga_reopen_discovery. The person decides the documents are right: ask first.',