@taiga-ai/mcp-server 0.18.0-dev.447 → 0.18.0-dev.448

package/dist/index.js

@@ -2169,8 +2169,9 @@ const DISCOVERY_STEP_MEANING = "discoveryStep is where a product in setup is: co
 * hears only that guesses another ID, or a name. Each ID a tool takes names
 * the tool that lists the right ones; the tool's arguments say which apply.
 */
+const ITEM_ID_HINT = "taiga_list_backlog_items lists a product's initiatives with their IDs; a run or plan ID is not one.";
 const BY_ARGUMENT = {
-	itemId: "taiga_list_backlog_items lists a product's initiatives with their IDs; a run or plan ID is not one.",
+	itemId: ITEM_ID_HINT,
 	backlogItemId: "taiga_list_backlog_items lists a product's initiatives with their IDs.",
 	buildId: "taiga_list_builds 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.",
@@ -2189,7 +2190,7 @@ const BY_ARGUMENT = {
 /** Where an argument means something else on one tool, or the tool's 404 needs its own word. */
 const BY_TOOL = {
 	taiga_resolve_action: () => "taiga_list_action_required lists the items with their IDs.",
-	taiga_get_plan: (said) => /\bplan\b/i.test(said) ? "taiga_get_backlog_item says whether one is being generated (planningStatus planning) or failed, and taiga_plan_again asks for a new one." : BY_ARGUMENT.itemId
+	taiga_get_plan: (said) => /\bplan\b/i.test(said) ? "taiga_get_backlog_item says whether one is being generated (planningStatus planning) or failed, and taiga_plan_again asks for a new one." : ITEM_ID_HINT
 };
 /** The hint for a 404 from one tool call: the tool's own, else one per ID it was given. */
 function notFoundHint(tool, args) {
@@ -2366,6 +2367,10 @@ function webOrigin(url) {
 function isRecord(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+/** A section stored as an object rather than a bare string. */
+function isSectionObject(value) {
+	return isRecord(value);
+}
 /** The `sections` map of a document, or null when the document is not section-shaped. */
 function sectionsOf(data) {
 	return isRecord(data.sections) ? data.sections : null;
@@ -2375,7 +2380,7 @@ function sectionContent(sections, sectionId) {
 	const section = sections[sectionId];
 	if (section === void 0 || section === null) return null;
 	if (typeof section === "string") return section;
-	return isRecord(section) && typeof section.content === "string" ? section.content : "";
+	return isSectionObject(section) && typeof section.content === "string" ? section.content : "";
 }
 /** The map with one section's text replaced (or the section added); every other section untouched. */
 function applySectionEdit(sections, sectionId, content) {
@@ -2397,8 +2402,9 @@ function applySectionEdit(sections, sectionId, content) {
 */
 function stripProvenance(doc) {
 	const { derivedFrom: _derivedFrom, outdated: _outdated, ...rest } = doc;
-	if (!isRecord(rest.data)) return rest;
-	const sections = sectionsOf(rest.data);
+	const { data } = doc;
+	if (!isRecord(data)) return rest;
+	const sections = sectionsOf(data);
 	if (!sections) return rest;
 	const stripped = Object.fromEntries(Object.entries(sections).map(([id, section]) => {
 		if (!isRecord(section)) return [id, section];
@@ -2408,7 +2414,7 @@ function stripProvenance(doc) {
 	return {
 		...rest,
 		data: {
-			...rest.data,
+			...data,
 			sections: stripped
 		}
 	};
@@ -2421,7 +2427,7 @@ function stripProvenance(doc) {
 function instructionsText(sections) {
 	const parts = [];
 	for (const section of Object.values(sections)) {
-		const content = isRecord(section) ? section.content : void 0;
+		const content = isSectionObject(section) ? section.content : void 0;
 		if (typeof content === "string" && content.trim()) parts.push(content.trim());
 	}
 	return parts.join("\n\n").trim() || null;
@@ -2650,9 +2656,8 @@ async function linkedProducts(client, repository, repositoryHost) {
 }
 /** A document list row as the model sees it: the summary fields plus a display name and the staleness fact. */
 function documentSummaries(rows) {
-	const typed = rows;
-	return pickFields(typed, DOCUMENT_SUMMARY_FIELDS$1).map((picked, index) => {
-		const outdated = typed[index].outdated;
+	return pickFields(rows, DOCUMENT_SUMMARY_FIELDS$1).map((picked, index) => {
+		const outdated = rows[index].outdated;
 		const fact = picked.isDraft !== false ? void 0 : outdated === null ? false : Array.isArray(outdated?.sources) ? outdated.sources.length > 0 : void 0;
 		return {
 			type: picked.type,
@@ -3279,7 +3284,7 @@ async function queueView(client, product, options = { name: "all" }) {
 	const canName = client.hasCapability("backlog:read");
 	const blocking = blockingIndex(entries, (entry) => entry.state);
 	const toName = !canName ? [] : options.name === "all" ? entries.slice(0, NAMED_ENTRIES).map((_, index) => index) : blocking >= 0 ? [blocking] : [];
-	const settled = await Promise.allSettled(toName.map((index) => client.getBacklogItem(String(entries[index].backlogItemId))));
+	const settled = await Promise.allSettled(toName.map((index) => client.getBacklogItem(entries[index].backlogItemId)));
 	const reads = new Map(toName.map((index, at) => [index, settled[at]]));
 	let unnamed = options.name === "all" ? entries.length - toName.length : 0;
 	const rows = entries.map((entry, index) => {
@@ -3475,13 +3480,10 @@ const PLAN_STEP_SUMMARY_FIELDS = [
 	"createsResources"
 ];
 /** The outcome fields of an initiative, with how many of its criteria are met. */
-const outcomeOf = (item) => {
-	const row = item;
-	return {
-		...pickFields([row], ITEM_OUTCOME_FIELDS)[0],
-		criteria: criteriaCounts(row)
-	};
-};
+const outcomeOf = (item) => ({
+	...pickFields([item], ITEM_OUTCOME_FIELDS)[0],
+	criteria: criteriaCounts(item)
+});
 const outcome = (item) => toolResult(outcomeOf(item));
 /**
 * Each tool is registered under the capability its route requires, so a
@@ -3566,7 +3568,8 @@ function registerBacklogReads(server, client) {
 	}, (params) => runTool(async () => {
 		const item = (await client.getBacklogItem(params.itemId)).data;
 		if (item.planningStatus !== "failed") return toolResult(item);
-		const planFailure = await planFailureOf(client, params.itemId, item.planFailureCause);
+		const ownCause = item.planFailureCause;
+		const planFailure = await planFailureOf(client, params.itemId, ownCause);
 		return toolResult(planFailure ? {
 			...item,
 			planFailure
@@ -3659,7 +3662,7 @@ const isApiFailure$2 = (error) => error instanceof TaigaApiError || isNetworkFai
 async function reviewGate(client, item) {
 	const own = typeof item.autoBuild === "boolean" ? item.autoBuild : null;
 	try {
-		const product = own === null ? (await client.getProduct(String(item.productId))).data : {};
+		const product = own === null ? (await client.getProduct(item.productId)).data : {};
 		const builds = resolveAutoBuild({
 			initiative: own,
 			product: typeof product.autoBuild === "boolean" ? product.autoBuild : true
@@ -3677,7 +3680,7 @@ async function reviewGate(client, item) {
 /** Where a queued initiative stands in its product's line; null, and the outcome says so, when the queue cannot be read. */
 async function placeInQueue(client, item) {
 	try {
-		const view = await queueView(client, String(item.productId), { name: "blocking" });
+		const view = await queueView(client, item.productId, { name: "blocking" });
 		return {
 			position: view.entries.find((row) => row.backlogItemId === item.id)?.position ?? null,
 			of: view.entries.length,
@@ -3853,7 +3856,7 @@ async function activityRows(client, opts) {
 		throw error;
 	})]);
 	const nameById = /* @__PURE__ */ new Map();
-	for (const product of products?.data ?? []) nameById.set(String(product.id), {
+	for (const product of products?.data ?? []) nameById.set(product.id, {
 		name: product.name,
 		slug: product.slug
 	});
@@ -4081,7 +4084,7 @@ async function factoryPart(client, factoryId) {
 * asked. Null, with a note, where unpublished.
 */
 async function documentsPart(client, product, depth) {
-	const productId = String(product.id);
+	const productId = product.id;
 	const origin = defaultOriginFor(product);
 	const reads = await Promise.allSettled(CONTEXT_DOCUMENT_TYPES.map((type) => client.getProductDocument(productId, type, origin)));
 	const out = { origin };
@@ -4206,7 +4209,7 @@ async function buildsPart(client, productId) {
 	return pickFields(rows, CONTEXT_BUILD_FIELDS);
 }
 async function productContext(client, product, options) {
-	const productId = String(product.id);
+	const productId = product.id;
 	const granted = (part) => client.hasCapability(PARTS[part]);
 	const notGranted = Object.keys(PARTS).filter((part) => !granted(part));
 	const fetchers = {
@@ -4276,6 +4279,14 @@ function registerContextTools(server, client) {
 }
 //#endregion
 //#region src/tools/autonomy.ts
+/**
+* Autonomy (docs.tai.ga, Deliver: Initiatives, Auto-merge): whether a landed
+* plan is built without a review, and whether a pull request merges on its
+* own. The organization and its factories are ceilings for merging, set by
+* an administrator in the web; a product sets defaults; an initiative's own
+* switch is the final word within the ceilings. The initiative's build gate
+* is taiga_set_auto_build.
+*/
 function registerAutonomyTools(server, client) {
 	if (client.hasCapability("products:write")) server.registerTool("taiga_set_product_autonomy", {
 		title: "Set a product's autonomy defaults",
@@ -4322,6 +4333,13 @@ function registerAutonomyTools(server, client) {
 }
 //#endregion
 //#region src/tools/inbox.ts
+/**
+* Action Required (docs.tai.ga, Deliver): where work comes back to a person.
+* Things to review (a plan, a pull request, findings, policy violations) and
+* things to set up that only a person can (a secret, an account, a cloud
+* permission). The inbox is the team's: resolving an item clears it for
+* everybody, so these tools say what they clear.
+*/
 const ITEM_FIELDS = [
 	"id",
 	"productId",
@@ -4433,6 +4451,14 @@ function registerInboxTools(server, client) {
 }
 //#endregion
 //#region src/tools/knowledge.ts
+/**
+* Knowledge (docs.tai.ga, Context): reference material agents search when
+* the work calls for it, at the organization, a factory or a product, and
+* narrowing as it comes down. Not instructions: a rule belongs in
+* instructions, a forty-page integration guide here. Members manage it on
+* their factories and products; organization knowledge takes an owner or
+* admin, which the API enforces.
+*/
 const KNOWLEDGE_FIELDS = [
 	"id",
 	"factoryId",
@@ -4608,6 +4634,13 @@ function registerKnowledgeTools(server, client) {
 }
 //#endregion
 //#region src/tools/maintenance.ts
+/**
+* Maintaining (docs.tai.ga, Operate): what the sweeps found in a product's
+* repository and where it stands against the organization's own policies,
+* and the two things a person does with a finding, Ignore and Fix. Sweeps run
+* themselves and nothing is marked fixed by hand: a finding resolves when the
+* next sweep no longer detects it, so there is no tool for either.
+*/
 /** A finding as a list row: enough to decide whether to open, fix or ignore it. */
 const FINDING_ROW_FIELDS = [
 	"id",
@@ -4814,6 +4847,13 @@ function registerMaintenanceTools(server, client) {
 }
 //#endregion
 //#region src/tools/observe.ts
+/**
+* What runs where and how it is doing (docs.tai.ga, Deliver: Deployments;
+* Operate: Monitoring). Taiga observes deployments, it does not perform them:
+* the history is mirrored from the provider, so these tools read and never
+* deploy, approve or cancel. Importing history reaches into the connected
+* provider and is an administrator's action in the web.
+*/
 /** A deployment as a line of history: what shipped where, how it ended, and who shipped it. */
 const DEPLOYMENT_FIELDS = [
 	"id",
@@ -4849,7 +4889,7 @@ const ENVIRONMENT_FIELDS = [
 */
 function deploymentLines(rows) {
 	return rows.map((row) => {
-		const repository = row.metadata?.repositoryFullName;
+		const repository = row.metadata?.["repositoryFullName"];
 		return {
 			...pickFields([row], DEPLOYMENT_FIELDS)[0],
 			repository: typeof repository === "string" ? repository : null
@@ -5045,7 +5085,7 @@ function registerProductDocumentWrites(server, client) {
 	const canRead = client.hasCapability("products:read");
 	const productScope = (product, type) => ({
 		getDraft: () => client.getProductDocumentDraft(product, type),
-		getPublished: async () => await client.getProductDocument(product, type, "plan"),
+		getPublished: () => client.getProductDocument(product, type, "plan"),
 		saveDraft: (data) => client.saveProductDocumentDraft(product, type, { data }),
 		publish: () => client.publishProductDocument(product, type)
 	});
@@ -19554,7 +19594,7 @@ function renderDocument(doc) {
 	].filter((key) => doc[key] !== void 0 && doc[key] !== null).map((key) => `${key}: ${String(doc[key])}`);
 	const core = Object.keys(sections).filter((id) => {
 		const section = sections[id];
-		return isRecord(section) && section.priority === "core";
+		return isSectionObject(section) && section.priority === "core";
 	});
 	if (core.length > 0) facts.push(`core sections: ${core.join(", ")}`);
 	if (facts.length > 0) lines.push("", facts.join(" | "));
@@ -19650,7 +19690,7 @@ function atxOf(depth, children) {
 }
 /** The section's title when it carries one, else its id. */
 function sectionTitle(section, id) {
-	return isRecord(section) && typeof section.title === "string" && section.title.trim() ? section.title.trim() : id;
+	return isSectionObject(section) && typeof section.title === "string" && section.title.trim() ? section.title.trim() : id;
 }
 /** The mime type a read will answer with, for a list entry that must not disagree with it. */
 function mimeTypeOf(doc) {
@@ -19817,6 +19857,14 @@ var NotGranted = class extends Error {
 };
 //#endregion
 //#region src/tools/repositories.ts
+/**
+* A product's repository (docs.tai.ga, Administration: Integrations and
+* environments, Source control). A linked repository is the prerequisite for
+* most of what Taiga does: planning reads the code, runs work on a branch of
+* it, sweeps scan it and the as-built documents are derived from it. GitHub is
+* connected once for the organization, in the web; linking one of the
+* repositories it can reach to a product is a separate act, per product.
+*/
 const LINK_FIELDS = [
 	"id",
 	"provider",
@@ -20038,7 +20086,7 @@ function registerResources(server, client) {
 			title: "Organization document",
 			description: "A published organization document: a policy, the business goals, the design or brand standards, the tone of voice or the standing instructions. Sections rendered as headings."
 		}, async (uri, variables) => {
-			const type = requireOneOf("Document type", String(variables.type), TENANT_DOCUMENT_TYPES);
+			const type = requireOneOf("Document type", String(variables["type"]), TENANT_DOCUMENT_TYPES);
 			try {
 				return contents(uri.href, (await client.getTenantDocument(type)).data);
 			} catch (error) {
@@ -20055,7 +20103,7 @@ function registerResources(server, client) {
 		title: "Factory instructions",
 		description: "A factory's published standing guidance; taiga_list_factories gives the factory ID. Markdown for a section map, JSON otherwise (the read says which)."
 	}, async (uri, variables) => {
-		const factoryId = requireId("Factory ID", String(variables.factoryId));
+		const factoryId = requireId("Factory ID", String(variables["factoryId"]));
 		const doc = await served(client.getFactoryDocument(factoryId, FACTORY_DOCUMENT_TYPES[0]), "This factory has not published instructions, or the key cannot see the factory");
 		return contents(uri.href, doc.data);
 	});
@@ -20075,17 +20123,17 @@ function registerResources(server, client) {
 			title: "Product document on a timeline",
 			description: "A product document from the named timeline: origin=plan (discovery) or origin=reality (derived from the code). Markdown for a section map, JSON otherwise (the read says which)."
 		}, async (uri, variables) => {
-			const productId = requireId("Product ID", String(variables.productId));
-			const type = documentType(String(variables.type));
-			const origin = requireOneOf("Origin", String(variables.origin), PRODUCT_DOCUMENT_ORIGINS);
+			const productId = requireId("Product ID", String(variables["productId"]));
+			const type = documentType(String(variables["type"]));
+			const origin = requireOneOf("Origin", String(variables["origin"]), PRODUCT_DOCUMENT_ORIGINS);
 			return read(uri, productId, type, origin);
 		});
 		server.registerResource("product-document", new ResourceTemplate("taiga://products/{productId}/documents/{type}", { list: void 0 }), {
 			title: "Product document",
 			description: "A product document from the product's own timeline (reality for an imported product, plan otherwise; the documents a person writes are always on the plan side). taiga_list_product_documents shows what exists; add ?origin=plan or ?origin=reality to read the other side. Markdown for a section map, JSON otherwise (the read says which)."
 		}, async (uri, variables) => {
-			const productId = requireId("Product ID", String(variables.productId));
-			const type = documentType(String(variables.type));
+			const productId = requireId("Product ID", String(variables["productId"]));
+			const type = documentType(String(variables["type"]));
 			const product = (await served(client.getProduct(productId), "No product with that ID the key can see; taiga_list_products shows them")).data;
 			return read(uri, productId, type, defaultOriginFor(product, type));
 		});
@@ -20095,7 +20143,7 @@ function registerResources(server, client) {
 		description: "An initiative in full: description, acceptance criteria, technical context. taiga_list_backlog_items gives the item ID.",
 		mimeType: "application/json"
 	}, async (uri, variables) => {
-		const itemId = requireId("Backlog item ID", String(variables.itemId));
+		const itemId = requireId("Backlog item ID", String(variables["itemId"]));
 		const item = (await served(client.getBacklogItem(itemId), "No backlog item with that ID the key can see; taiga_list_backlog_items shows what exists")).data;
 		return { contents: [{
 			uri: uri.href,
@@ -20106,6 +20154,14 @@ function registerResources(server, client) {
 }
 //#endregion
 //#region src/tools/setup.ts
+/**
+* Setting a product up (docs.tai.ga, Start: Your first product, Learn: Import
+* an existing codebase, Organizations, factories and products): factories to
+* put products in, a product started from scratch or from an imported
+* codebase, what Taiga builds for it, the import, and finishing or reopening
+* Discovery. Who may reach a factory (its members) and deleting a factory or
+* a product stay in the web.
+*/
 const PRODUCT_FIELDS = [
 	"id",
 	"name",
@@ -20290,7 +20346,7 @@ function registerSetupTools(server, client) {
 		try {
 			return toolResult(await productRow(client, (await client.completeSetup(params.productId)).data));
 		} catch (error) {
-			if (!(error instanceof TaigaApiError) || error.details?.reason !== "documents_incomplete") throw error;
+			if (!(error instanceof TaigaApiError) || error.details?.["reason"] !== "documents_incomplete") throw error;
 			return toolError(error.code ?? "CONFLICT", `${withStop(error.apiMessage ?? "Required documents are not published yet")} ${MISSING_DOCUMENTS_HOW}`, error.details);
 		}
 	}));

package/package.json

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

package/src/client.test.ts

@@ -154,9 +154,9 @@ describe('TaigaClient', () => {
     it('drops tenantId at every depth and keeps an own __proto__ key as data', () => {
       const parsed = JSON.parse(
         '{"__proto__": {"x": 1}, "tenantId": "t", "a": {"tenantId": "t", "b": [{"tenantId": "t", "c": 1}, 2, null]}, "d": "s"}'
-      ) as Record<string, unknown>;
+      ) as { tenantId: string; a: unknown; d: string };
 
-      const out = withoutTenant(parsed) as Record<string, unknown>;
+      const out = withoutTenant(parsed);
 
       expect(JSON.stringify(out)).not.toContain('tenantId');
       expect(out.a).toEqual({ b: [{ c: 1 }, 2, null] });