@taiga-ai/mcp-server 0.36.0-dev.777 → 0.36.0-rc.776

package/dist/index.js

@@ -23814,6 +23814,14 @@ var TaigaClient = class {
 	async getActivePlan(itemId) {
 		return this.request("GET", `/backlog/${seg(itemId)}/plans/active`);
 	}
+	/** Every plan version of an initiative with the verdict it received, newest first unless `order` says otherwise. */
+	async listPlanHistory(itemId, order) {
+		return this.request("GET", `/backlog/${seg(itemId)}/plans/history${query$1({ order })}`);
+	}
+	/** One plan version with its steps, whether or not it is the active one. */
+	async getPlan(planId) {
+		return this.request("GET", `/plans/${seg(planId)}`);
+	}
 	async approvePlan(planId) {
 		return this.request("POST", `/plans/${seg(planId)}/approve`);
 	}
@@ -26588,6 +26596,7 @@ const TOOLSET_OF = {
 	taiga_list_initiatives: "core",
 	taiga_get_initiative: "core",
 	taiga_get_plan: "core",
+	taiga_list_plans: "core",
 	taiga_list_runs: "core",
 	taiga_get_run: "core",
 	taiga_get_line: "core",
@@ -26918,7 +26927,7 @@ const ITEM_ID_HINT = "taiga_list_initiatives lists a product's initiatives with
 const BY_ARGUMENT = {
 	initiativeId: ITEM_ID_HINT,
 	runId: "taiga_list_runs lists the runs, of one product or of every product the key can see.",
-	planId: "taiga_get_plan gives the initiative's active plan and its ID.",
+	planId: "taiga_get_plan gives the initiative's active plan and its ID; taiga_list_plans lists every version's ID.",
 	linkId: "taiga_list_product_repositories lists the product's repository links; a linkable repository id is not a link ID.",
 	replacesLinkId: "taiga_list_product_repositories lists the product's repository links.",
 	linkableRepositoryId: "taiga_list_linkable_repositories lists the repositories the GitHub and GitLab connections reach, with their ids.",
@@ -30553,27 +30562,57 @@ function registerBacklogReads(server, client) {
 	}));
 	server.registerTool("taiga_get_plan", {
 		title: "Get the active plan",
-		description: "Read an initiative's active plan, step by step: what each builds, the files it writes and reads, and what it depends on. Enough to approve or reject it; full: true adds each step's complete instructions (long). A plan a request for changes revised says so in revision: the steps it added, edited and dropped, and the committed steps it reverts. NOT_FOUND when there is no active plan, the initiative's situation says why.",
+		description: "Read an initiative's active plan, step by step: what each builds, the files it writes and reads, and what it depends on. Enough to approve or reject it; full: true adds each step's complete instructions (long). A plan a request for changes revised says so in revision: the steps it added, edited and dropped, and the committed steps it reverts. version reads an earlier version instead (taiga_list_plans lists them): the plan comes with its verdict, who gave it and the comment, and what it answers. NOT_FOUND when there is no active plan, the initiative's situation says why; with version, when the initiative has no such version, and the message names the ones it has.",
 		inputSchema: object({
 			initiativeId,
+			version: number$1().int().min(1).optional().describe("A plan version to read, such as 1 (default: the active plan); taiga_list_plans lists the versions"),
 			full: boolean().optional().describe("Carry each step's complete instructions (default false: a summary)")
 		}),
 		annotations: READ_ONLY
 	}, (params) => runTool(async () => {
-		const plan = (await client.getActivePlan(params.initiativeId)).data;
+		let plan;
+		let versionNote = {};
+		if (params.version === void 0) plan = (await client.getActivePlan(params.initiativeId)).data;
+		else {
+			const history = (await client.listPlanHistory(params.initiativeId, "oldest")).data;
+			const entry = history.find((candidate) => candidate.version === params.version);
+			if (!entry) {
+				const have = history.map((candidate) => candidate.version).sort((a, b) => a - b);
+				return toolError("NOT_FOUND", have.length > 0 ? `This initiative has no plan version ${params.version}; it has version${have.length > 1 ? "s" : ""} ${have.join(", ")}.` : `This initiative has no plan version ${params.version}: it has never been planned.`);
+			}
+			plan = (await client.getPlan(entry.planId)).data;
+			versionNote = {
+				verdict: entry.verdict,
+				answers: entry.answers
+			};
+		}
 		const revision = await planRevisionOf(client, params.initiativeId, plan.id);
 		const revised = revision ? { revision } : {};
 		if (params.full) return toolResult({
 			...plan,
+			...versionNote,
 			...revised
 		});
 		const steps = Array.isArray(plan.steps) ? plan.steps : [];
 		return toolResult({
 			...pickFields([plan], PLAN_SUMMARY_FIELDS)[0],
+			...versionNote,
 			...revised,
 			steps: pickFields(steps, PLAN_STEP_SUMMARY_FIELDS)
 		});
 	}));
+	server.registerTool("taiga_list_plans", {
+		title: "List plan versions and their verdicts",
+		description: "List every plan version of an initiative, newest first (order: 'oldest' reverses it). Each version has its status, its verdict (approved, rejected, changes_requested, awaiting_review, or none when none was recorded), who gave it by name, when and the comment, and the earlier version and comment it answers. taiga_get_plan with version reads one in full. An initiative never planned returns an empty list.",
+		inputSchema: object({
+			initiativeId,
+			order: _enum(["newest", "oldest"]).optional().describe("Order of the versions (default 'newest')")
+		}),
+		annotations: READ_ONLY
+	}, (params) => runTool(async () => {
+		const versions = (await client.listPlanHistory(params.initiativeId, params.order)).data;
+		return toolResult({ versions });
+	}));
 }
 function registerRequest(server, client) {
 	server.registerTool("taiga_request_initiatives", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taiga-ai/mcp-server",
-  "version": "0.36.0-dev.777",
+  "version": "0.36.0-rc.776",
   "description": "Taiga for AI coding assistants: read products, policies, initiatives and runs, and operate the line, over MCP",
   "mcpName": "ga.tai/mcp-server",
   "license": "UNLICENSED",