@taiga-ai/mcp-server 0.4.0-dev.305 → 0.4.0-dev.307

package/dist/index.js

@@ -106,7 +106,7 @@ var TaigaClient = class {
 			"architecture",
 			"technology_decisions"
 		];
-		const keyFactoryDocTypes = ["team_instructions"];
+		const keyFactoryDocTypes = ["factory_instructions"];
 		const docFetches = [];
 		for (const docType of keyProductDocTypes) if (productDocs.data.some((d) => d.type === docType && !d.isDraft)) docFetches.push(this.getProductDocument(productId, docType).then((r) => ({
 			type: docType,
@@ -197,7 +197,7 @@ function summarizeList(items) {
 //#endregion
 //#region src/tools/products.ts
 function registerProductTools(server, client) {
-	if (client.hasCapability("teams:read")) server.tool("taiga_list_factories", "List all factories in the organization. A factory is the group that owns a set of products. Use this to find factory IDs for reading factory instructions. Factory instructions carry the factory's standing guidance: domain context, tech preferences, and the conventions its products follow.", { limit: z.number().min(1).max(100).optional().describe("Max results (default 25)") }, {
+	if (client.hasCapability("factories:read")) server.tool("taiga_list_factories", "List all factories in the organization. A factory is the group that owns a set of products. Use this to find factory IDs for reading factory instructions. Factory instructions carry the factory's standing guidance: domain context, tech preferences, and the conventions its products follow.", { limit: z.number().min(1).max(100).optional().describe("Max results (default 25)") }, {
 		readOnlyHint: true,
 		openWorldHint: false
 	}, async (params) => {
@@ -207,7 +207,7 @@ function registerProductTools(server, client) {
 			text: JSON.stringify(result.data, null, 2)
 		}] };
 	});
-	if (client.hasCapability("projects:read")) {
+	if (client.hasCapability("products:read")) {
 		server.tool("taiga_list_products", "List products in the organization. Use this to find the product you are working on so you can read its specification, architecture, and threat model. Can filter by factory; a status filter also exists but no longer distinguishes anything (see its description).", {
 			factoryId: z.string().uuid().optional().describe("Filter by factory ID -- get factory IDs from taiga_list_factories"),
 			status: z.enum([
@@ -239,7 +239,7 @@ function registerProductTools(server, client) {
 				text: JSON.stringify(summaries, null, 2)
 			}] };
 		});
-		server.tool("taiga_get_product_document", "Get the full content of a specific product document. Use this when you need to understand what to build (specification), how the system is designed (architecture), what security risks exist (threat model), or what technology choices were made (technology_decisions). Types: specification, architecture, technology_decisions, data_flow, privacy_assessment, threat_model, risk_register, user_flow, service_blueprint, ui_direction, codebase_snapshot. The product instructions document is `project_instructions` (its stored type keeps the old name).", {
+		server.tool("taiga_get_product_document", "Get the full content of a specific product document. Use this when you need to understand what to build (specification), how the system is designed (architecture), what security risks exist (threat model), or what technology choices were made (technology_decisions). Types: specification, architecture, technology_decisions, data_flow, privacy_assessment, threat_model, risk_register, user_flow, service_blueprint, ui_direction, codebase_snapshot, and product_instructions (the product's standing instructions).", {
 			productId: z.string().uuid().describe("Product ID -- get from taiga_list_products"),
 			type: z.string().describe("Document type -- get available types from taiga_list_product_documents. Common: specification, architecture, threat_model, technology_decisions")
 		}, {
@@ -295,7 +295,7 @@ function registerDocumentTools(server, client) {
 			text: JSON.stringify(result.data, null, 2)
 		}] };
 	});
-	if (client.hasCapability("teams:read")) {
+	if (client.hasCapability("factories:read")) {
 		server.tool("taiga_list_factory_documents", "List documents for a specific factory (names and types only). A factory has one document: its instructions, the factory's free-form standing guidance (domain context, tech preferences, conventions) that applies to every product it owns. Use taiga_get_factory_document to read the full content.", {
 			factoryId: z.string().uuid().describe("Factory ID -- get from taiga_list_factories"),
 			limit: z.number().min(1).max(100).optional().describe("Max results (default 25)")
@@ -311,7 +311,7 @@ function registerDocumentTools(server, client) {
 		});
 		server.tool("taiga_get_factory_document", "Get the full content of a factory's instructions. Use this when you need the domain context, tech preferences, or conventions the factory expects every product it owns to follow.", {
 			factoryId: z.string().uuid().describe("Factory ID -- get from taiga_list_factories"),
-			type: z.string().describe("Document type -- get available types from taiga_list_factory_documents. The factory instructions document is `team_instructions` (its stored type keeps the old name).")
+			type: z.string().describe("Document type -- get available types from taiga_list_factory_documents. The factory instructions document is `factory_instructions`.")
 		}, {
 			readOnlyHint: true,
 			openWorldHint: false
@@ -323,9 +323,9 @@ function registerDocumentTools(server, client) {
 			}] };
 		});
 	}
-	if (client.hasCapability("teams:read") && client.hasCapability("tenant:documents:write")) server.tool("taiga_update_factory_document", "Update the draft of a factory's instructions. Only updates the draft -- does not publish. Use this when you notice the factory conventions, domain context, or tech preferences need updating while working on the codebase.", {
+	if (client.hasCapability("factories:read") && client.hasCapability("tenant:documents:write")) server.tool("taiga_update_factory_document", "Update the draft of a factory's instructions. Only updates the draft -- does not publish. Use this when you notice the factory conventions, domain context, or tech preferences need updating while working on the codebase.", {
 		factoryId: z.string().uuid().describe("Factory ID -- get from taiga_list_factories"),
-		type: z.string().describe("Document type (`team_instructions`)"),
+		type: z.string().describe("Document type (`factory_instructions`)"),
 		data: z.record(z.string(), z.unknown()).describe("Document content to save as JSON")
 	}, {
 		readOnlyHint: false,

package/package.json

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

package/src/client.test.ts

@@ -165,7 +165,7 @@ describe('TaigaClient', () => {
         tenantId: 't1',
         email: 'test@example.com',
         role: 'member',
-        capabilities: ['projects:read', 'teams:read'],
+        capabilities: ['products:read', 'factories:read'],
       };
       stubFetch(200, { data: expected });
       const client = makeClient();
@@ -181,14 +181,14 @@ describe('TaigaClient', () => {
     it('should report no capabilities before introspect is called', () => {
       const client = makeClient();
 
-      expect(client.hasCapability('projects:read')).toBe(false);
+      expect(client.hasCapability('products:read')).toBe(false);
     });
 
     it('should correctly report granted vs missing capabilities', async () => {
-      const client = await clientWithCapabilities(['projects:read', 'teams:read']);
+      const client = await clientWithCapabilities(['products:read', 'factories:read']);
 
-      expect(client.hasCapability('projects:read')).toBe(true);
-      expect(client.hasCapability('teams:read')).toBe(true);
+      expect(client.hasCapability('products:read')).toBe(true);
+      expect(client.hasCapability('factories:read')).toBe(true);
       expect(client.hasCapability('backlog:read')).toBe(false);
       expect(client.hasCapability('tenant:documents:write')).toBe(false);
     });
@@ -196,7 +196,7 @@ describe('TaigaClient', () => {
     it('should report no capabilities when key has empty scope', async () => {
       const client = await clientWithCapabilities([]);
 
-      expect(client.hasCapability('projects:read')).toBe(false);
+      expect(client.hasCapability('products:read')).toBe(false);
     });
   });
 

package/src/client.ts

@@ -159,8 +159,8 @@ export class TaigaClient {
 
     // Fetch full content for key documents (in parallel)
     const keyProductDocTypes = ['specification', 'architecture', 'technology_decisions'];
-    // The factory instructions document; its stored type keeps the old name until PRO-1671.
-    const keyFactoryDocTypes = ['team_instructions'];
+    // The factory instructions document.
+    const keyFactoryDocTypes = ['factory_instructions'];
 
     const docFetches: Promise<{ type: string; scope: string; data: unknown }>[] = [];
 

package/src/server.integration.test.ts

@@ -11,8 +11,8 @@ import { registerAllTools } from './tools/index.js';
 
 /** All capabilities the MCP server understands. */
 const ALL_CAPABILITIES = [
-  'projects:read',
-  'teams:read',
+  'products:read',
+  'factories:read',
   'tenant:documents:read',
   'tenant:documents:write',
   'backlog:read',
@@ -147,7 +147,7 @@ describe('MCP server integration', () => {
     });
 
     it('should expose only factory tools for a teams:read-only key', async () => {
-      const { client } = await bootMcpPair({ capabilities: ['teams:read'] });
+      const { client } = await bootMcpPair({ capabilities: ['factories:read'] });
 
       const { tools } = await client.listTools();
       const names = toolNames(tools);
@@ -183,7 +183,7 @@ describe('MCP server integration', () => {
 
     it('should expose factory document write when both teams:read and documents:write are granted', async () => {
       const { client } = await bootMcpPair({
-        capabilities: ['teams:read', 'tenant:documents:write'],
+        capabilities: ['factories:read', 'tenant:documents:write'],
       });
 
       const { tools } = await client.listTools();
@@ -195,7 +195,7 @@ describe('MCP server integration', () => {
 
     it('should combine capabilities additively', async () => {
       const { client } = await bootMcpPair({
-        capabilities: ['teams:read', 'tenant:documents:read'],
+        capabilities: ['factories:read', 'tenant:documents:read'],
       });
 
       const { tools } = await client.listTools();
@@ -231,8 +231,8 @@ describe('MCP server integration', () => {
 
   describe('capability-tool contract', () => {
     const CONTRACT: Record<string, string[]> = {
-      'projects:read': ['taiga_list_products', 'taiga_list_product_documents', 'taiga_get_product_document'],
-      'teams:read': ['taiga_list_factories', 'taiga_list_factory_documents', 'taiga_get_factory_document'],
+      'products:read': ['taiga_list_products', 'taiga_list_product_documents', 'taiga_get_product_document'],
+      'factories:read': ['taiga_list_factories', 'taiga_list_factory_documents', 'taiga_get_factory_document'],
       'tenant:documents:read': ['taiga_list_documents', 'taiga_get_document'],
       'tenant:documents:write': ['taiga_update_document'],
     };

package/src/tools/documents.ts

@@ -73,9 +73,8 @@ export function registerDocumentTools(server: McpServer, client: TaigaClient) {
   }
 
   // ── Factory instructions ────────────────────────────────────────────
-  // Capability strings still say teams until the database rename (PRO-1671).
 
-  if (client.hasCapability('teams:read')) {
+  if (client.hasCapability('factories:read')) {
     server.tool(
       'taiga_list_factory_documents',
       'List documents for a specific factory (names and types only). ' +
@@ -107,7 +106,7 @@ export function registerDocumentTools(server: McpServer, client: TaigaClient) {
           .string()
           .describe(
             'Document type -- get available types from taiga_list_factory_documents. ' +
-              'The factory instructions document is `team_instructions` (its stored type keeps the old name).'
+              'The factory instructions document is `factory_instructions`.'
           ),
       },
       { readOnlyHint: true, openWorldHint: false },
@@ -121,7 +120,7 @@ export function registerDocumentTools(server: McpServer, client: TaigaClient) {
   }
 
   // Factory document write requires both teams:read (to find the factory) and tenant:documents:write
-  if (client.hasCapability('teams:read') && client.hasCapability('tenant:documents:write')) {
+  if (client.hasCapability('factories:read') && client.hasCapability('tenant:documents:write')) {
     server.tool(
       'taiga_update_factory_document',
       "Update the draft of a factory's instructions. " +
@@ -129,7 +128,7 @@ export function registerDocumentTools(server: McpServer, client: TaigaClient) {
         'domain context, or tech preferences need updating while working on the codebase.',
       {
         factoryId: z.string().uuid().describe('Factory ID -- get from taiga_list_factories'),
-        type: z.string().describe('Document type (`team_instructions`)'),
+        type: z.string().describe('Document type (`factory_instructions`)'),
         data: z.record(z.string(), z.unknown()).describe('Document content to save as JSON'),
       },
       { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },

package/src/tools/products.ts

@@ -3,9 +3,8 @@ import { z } from 'zod';
 import type { TaigaClient } from '../client.js';
 import { summarizeList } from './summarize.js';
 
-// Capability strings still say teams/projects until the database rename (PRO-1671).
 export function registerProductTools(server: McpServer, client: TaigaClient) {
-  if (client.hasCapability('teams:read')) {
+  if (client.hasCapability('factories:read')) {
     server.tool(
       'taiga_list_factories',
       'List all factories in the organization. A factory is the group that owns a set of products. ' +
@@ -25,7 +24,7 @@ export function registerProductTools(server: McpServer, client: TaigaClient) {
     );
   }
 
-  if (client.hasCapability('projects:read')) {
+  if (client.hasCapability('products:read')) {
     server.tool(
       'taiga_list_products',
       'List products in the organization. Use this to find the product you are working on ' +
@@ -85,8 +84,7 @@ export function registerProductTools(server: McpServer, client: TaigaClient) {
         'or what technology choices were made (technology_decisions). ' +
         'Types: specification, architecture, technology_decisions, data_flow, ' +
         'privacy_assessment, threat_model, risk_register, user_flow, service_blueprint, ' +
-        'ui_direction, codebase_snapshot. The product instructions document is ' +
-        '`project_instructions` (its stored type keeps the old name).',
+        "ui_direction, codebase_snapshot, and product_instructions (the product's standing instructions).",
       {
         productId: z.string().uuid().describe('Product ID -- get from taiga_list_products'),
         type: z