@taiga-ai/mcp-server 0.26.0-dev.516 → 0.26.0-dev.518

package/dist/index.js

@@ -4221,6 +4221,20 @@ const RUN_OUTCOME_FIELDS = [
 * stalled in the hardening pass after the steps and the retry continues it.
 * Null for a run still going or that finished.
 */
+/**
+* The line of a failed step's error that says why (PRO-2941): a review found the reason buried in a
+* 2,000-character dump of git and lint output, behind runtime warnings. The first line that reads as an error,
+* else the first line; capped. Null when no step failed with an error.
+*/
+function failureCause(steps) {
+	const failed = steps.find((step) => step["status"] === "failed" && typeof step["error"] === "string");
+	if (!failed) return null;
+	const lines = String(failed["error"]).split("\n").map((line) => line.trim()).filter((line) => line && !/^\(node:\d+\)|^\(Use `node|^[⋯✔↓]/u.test(line));
+	const telling = lines.find((line) => /\berror\b|cannot|not found|denied|refused|no such/iu.test(line)) ?? lines.find((line) => /fail|✖/iu.test(line)) ?? lines[0];
+	if (!telling) return null;
+	const said = telling.length > 200 ? `${telling.slice(0, 197)}...` : telling;
+	return `step ${String(failed["stepOrder"])}: ${said}`;
+}
 function stoppedIn(run, steps) {
 	if (run.prMerged === true || run.status !== "failed" && run.status !== "stopped") return null;
 	if (!steps.some((step) => step.status !== "planned")) return "before the first step started, while setting up the run (cloning, preparing the workspace)";
@@ -4625,7 +4639,7 @@ function registerBuildTools(server, client) {
 	}));
 	server.registerTool("taiga_get_run", {
 		title: "Get run",
-		description: "Read one coding-agent run: status and outcome (one sentence), pull request, hardening, and each step with its status, commit, files, verification and headline. scanCoverage names security scanners that did not run, and why. verification is Taiga's check after a step (tests, lint, build); verificationNote says when one failed throughout. A failed or stopped run has stoppedIn and failedReasonMeans. full: true adds the complete instructions and reports. To resume: taiga_resume_initiative; to stop: move the initiative out of Build. A maintenance run has no initiative and is retried from its finding.",
+		description: "Read one coding-agent run: status and outcome (one sentence), pull request, hardening, and each step with its status, commit, files, verification and headline. scanCoverage names security scanners that did not run, and why. verification is Taiga's check after a step (tests, lint, build); verificationNote says when one failed throughout. A failed or stopped run has stoppedIn, failedReasonMeans and cause (the line of the failed step's error that says why). full: true adds the complete instructions and reports. To resume: taiga_resume_initiative; to stop: move the initiative out of Build. A maintenance run has no initiative and is retried from its finding.",
 		inputSchema: z.object({
 			runId,
 			full: z.boolean().optional().describe("Carry each step's complete instructions and report (default false: a summary)")
@@ -4636,7 +4650,11 @@ function registerBuildTools(server, client) {
 		const runRow = run.data;
 		const rows = steps.data.map((step) => neverStarted(step));
 		const where = stoppedIn(runRow, rows);
-		const stop = where ? { stoppedIn: where } : {};
+		const cause = failureCause(rows);
+		const stop = {
+			...where ? { stoppedIn: where } : {},
+			...cause ? { cause } : {}
+		};
 		const states = await initiativeStates(client, [runRow]);
 		const readable = withInitiativeState(readableRun(runRow), states);
 		const note = verificationNote(rows);
@@ -4818,7 +4836,7 @@ async function queueView(client, product, options = { name: "all" }) {
 	return {
 		linePaused: paused === null ? null : typeof paused === "string",
 		entries: rows.map(({ lifecycle: _lifecycle, runId: _runId, ...row }) => row),
-		waitingOn: line ?? waitingOn(rows, idle ? station : null),
+		waitingOn: line ?? waitingOn(rows, idle ? station : null) ?? (rows.length === 0 && "offTheLine" in offLine ? `Nothing is queued. ${offLine.offTheLine}` : null),
 		...offLine,
 		...note ? { note } : {}
 	};
@@ -5484,12 +5502,31 @@ function groupKey(row) {
 	const rule = typeof location?.ruleId === "string" ? location.ruleId : null;
 	return rule ? `${String(row["kind"])}|${String(row["severity"])}|${status}|${link}|${rule}` : null;
 }
-/** Where one finding is, in a few characters: its path and line, or its package. */
+/**
+* Where one finding is, in a few characters: its file and line (and the resource a scanner names), or its package.
+* A review read seven "CKV_GHA_7" where the location keeps no path: the file is in sourcePaths.
+*/
 function whereOf(row) {
 	const location = row["location"];
-	if (typeof location?.path === "string") return location.line ? `${location.path}:${String(location.line)}` : location.path;
+	const paths = Array.isArray(row["sourcePaths"]) ? row["sourcePaths"] : [];
+	const file = typeof location?.path === "string" ? location.path : typeof paths[0] === "string" ? paths[0] : null;
+	if (file) {
+		const at = location?.line ? `${file}:${String(location.line)}` : file;
+		return typeof location?.resource === "string" ? `${at} ${location.resource}` : at;
+	}
 	return [row["packageName"], row["currentVersion"]].filter(Boolean).join(" ") || String(row["id"]);
 }
+/** The words every member's title opens with, at a word boundary; empty when they share fewer than 20 characters. */
+function sharedTitle(titles) {
+	let prefix = titles[0] ?? "";
+	for (const title of titles.slice(1)) {
+		let at = 0;
+		while (at < prefix.length && prefix[at] === title[at]) at += 1;
+		prefix = prefix.slice(0, at);
+	}
+	const cut = (prefix.length === (titles[0] ?? "").length ? prefix : prefix.slice(0, Math.max(0, prefix.lastIndexOf(" ")))).trim().replace(/[\s,(:;-]+$/, "");
+	return cut.length >= 20 ? cut : "";
+}
 /**
 * Findings of one rule or license verdict on a page, folded into one row (PRO-2941): a review read seven
 * CKV_GHA_7 rows and fifteen sharp license rows, identical but for where. The first stands for them, with
@@ -5517,12 +5554,14 @@ function grouped(rows, fold) {
 		if (members.length === 1) return members[0];
 		const where = members.map(whereOf);
 		const first = members[0];
-		const shared = Object.fromEntries(Object.entries(first).filter(([key, value]) => key !== "id" && members.every((member) => JSON.stringify(member[key]) === JSON.stringify(value))));
+		const shared = Object.fromEntries(Object.entries(first).filter(([key, value]) => key !== "id" && key !== "title" && members.every((member) => JSON.stringify(member[key]) === JSON.stringify(value))));
 		const location = first["location"];
-		const said = first["kind"] === "license_violation" ? licenseVerdict(first) : typeof location?.ruleId === "string" ? location.ruleId : String(first["title"]);
+		const words = sharedTitle(members.map((member) => String(member["title"] ?? "")));
+		const rule = typeof location?.ruleId === "string" ? location.ruleId : null;
+		const said = first["kind"] === "license_violation" ? licenseVerdict(first) : words ? rule && !words.includes(rule) ? `${rule}: ${words}` : words : rule ?? String(first["title"]);
 		return {
 			...shared,
-			...shared["title"] === void 0 ? { title: said } : {},
+			title: said,
 			count: members.length,
 			findingIds: members.map((member) => member["id"]),
 			where: where.slice(0, GROUP_WHERE),
@@ -5661,8 +5700,11 @@ function standingSummary(standing) {
 		bySeverity[severity] = (bySeverity[severity] ?? 0) + 1;
 	}
 	const stated = (state) => controls.filter((c) => c["state"] === state).length;
+	const withAny = (key) => controls.filter((control) => Number(control[key] ?? 0) > 0).length;
 	return {
-		controls: listed.length,
+		controlsWithViolations: listed.length,
+		controlsBreached: withAny("findingCount"),
+		controlsDiverged: withAny("divergenceCount"),
 		controlsInPolicies: controls.length,
 		controlsMet: stated("met"),
 		controlsNotApplicable: stated("not_applicable"),
@@ -6148,6 +6190,8 @@ function isDue(row, now) {
 }
 /** Pages read for the summary; past this it says it counted only those. */
 const SUMMARY_PAGE = 100;
+/** Rows an org-wide first page carries when the caller names no limit: the summary answers the rest. */
+const ORG_WIDE_ROWS = 10;
 /** Pages the summary reads before it says it stopped: 1,000 items. */
 const SUMMARY_PAGES = 10;
 /** Every item the summary counts, up to SUMMARY_PAGES pages; nextCursor set when it stopped short. Null on failure. */
@@ -6269,8 +6313,10 @@ function registerInboxTools(server, client) {
 			...resolved ? { resolved: true } : {}
 		};
 		const first = params.cursor === void 0;
+		const limit = params.limit ?? (params.productId ? void 0 : ORG_WIDE_ROWS);
 		const result = await client.listInbox({
 			...query,
+			...limit !== void 0 ? { limit } : {},
 			...first ? { withTotal: true } : {}
 		});
 		const overview = !first || resolved ? null : !result.nextCursor ? result : await everyItem(client, query);
@@ -6309,7 +6355,7 @@ function registerInboxTools(server, client) {
 			...checked.unchecked > 0 ? (() => {
 				const onPage = due.filter((row) => checked.uncheckedIds.has(String(row["id"]))).length;
 				const beyond = checked.unchecked - onPage;
-				return { staleNote: `${[...onPage > 0 ? [`${onPage} review${onPage === 1 ? "" : "s"} on this page could not be checked for whether the subject moved on: those rows say staleChecked: false, and their readWith read tells`] : [], ...beyond > 0 ? [`${beyond} review${beyond === 1 ? "" : "s"} counted in the summary but not on this page could not be checked either, so the summary counts them open`] : []].join("; ")}.` };
+				return { staleNote: `${[...onPage > 0 ? [`${onPage} review${onPage === 1 ? "" : "s"} on this page could not be checked for whether the subject moved on: those rows say staleChecked: false, and their readWith read tells`] : [], ...beyond > 0 ? [`${beyond} review${beyond === 1 ? "" : "s"} past this page could not be checked, so the summary counts them as open`] : []].join("; ")}.` };
 			})() : {}
 		});
 	}));
@@ -6700,13 +6746,12 @@ async function standingPart(client, productId) {
 	const standing = (await client.getPolicyStanding(productId)).data;
 	const summary = standingSummary(standing);
 	const state = standing.assessment?.state;
-	const controls = Array.isArray(standing.controls) ? standing.controls : [];
-	const withAny = (key) => controls.filter((control) => Number(control[key] ?? 0) > 0).length;
 	return {
 		openViolations: summary.violations,
 		bySeverity: summary.bySeverity,
-		controlsBreached: withAny("findingCount"),
-		controlsDiverged: withAny("divergenceCount"),
+		controlsWithViolations: summary.controlsWithViolations,
+		controlsBreached: summary.controlsBreached,
+		controlsDiverged: summary.controlsDiverged,
 		controlsMet: summary.controlsMet,
 		controlsNotApplicable: summary.controlsNotApplicable,
 		...state === "never" || state === "failed" ? { note: `The assessment ${state === "never" ? "has never run" : "failed"}: no violations here is not an all-clear.` } : {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taiga-ai/mcp-server",
-  "version": "0.26.0-dev.516",
+  "version": "0.26.0-dev.518",
   "description": "Taiga for AI coding assistants: read products, policies, initiatives and runs, and operate the line, over MCP",
   "mcpName": "ga.tai/mcp-server",
   "type": "module",