@taiga-ai/mcp-server 0.0.1-rc.70 → 0.0.1-rc.71

package/dist/client.d.ts

@@ -40,29 +40,6 @@ export declare class TaigaClient {
     }): Promise<{
         data: unknown;
     }>;
-    listTeamDocuments(teamId: string, opts?: {
-        limit?: number;
-    }): Promise<{
-        data: unknown[];
-        nextCursor: string | null;
-    }>;
-    getTeamDocument(teamId: string, type: string): Promise<{
-        data: unknown;
-    }>;
-    saveTeamDocumentDraft(teamId: string, type: string, body: {
-        data: Record<string, unknown>;
-    }): Promise<{
-        data: unknown;
-    }>;
-    listProjectDocuments(projectId: string, opts?: {
-        limit?: number;
-    }): Promise<{
-        data: unknown[];
-        nextCursor: string | null;
-    }>;
-    getProjectDocument(projectId: string, type: string): Promise<{
-        data: unknown;
-    }>;
     listSkills(opts?: {
         scope?: string;
         scopeId?: string;
@@ -74,19 +51,6 @@ export declare class TaigaClient {
     getSkill(id: string): Promise<{
         data: unknown;
     }>;
-    updateSkill(id: string, body: {
-        name?: string;
-        description?: string;
-        content?: string;
-    }): Promise<{
-        data: unknown;
-    }>;
-    /**
-     * Fetch the full context for a project in parallel: project metadata,
-     * team documents, project documents, and team skills.
-     * Returns a structured bundle optimized for coding agent consumption.
-     */
-    getProjectContext(projectId: string): Promise<Record<string, unknown>>;
     listBacklogItems(projectId: string, opts?: {
         limit?: number;
     }): Promise<{

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAoC;gBAE7C,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;YAKvC,OAAO;IA0Bf,UAAU,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAMhD,gBAAgB,IAAI,mBAAmB,GAAG,IAAI;IAI9C,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IASpC,YAAY,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;cAMhD,OAAO,EAAE;oBAAc,MAAM,GAAG,IAAI;;IAG5D,UAAU,CAAC,EAAE,EAAE,MAAM;cACG,OAAO;;IAO/B,mBAAmB,CAAC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;cAIrB,OAAO,EAAE;oBAAc,MAAM,GAAG,IAAI;;IAM5D,iBAAiB,CAAC,IAAI,EAAE,MAAM;cACN,OAAO;;IAG/B,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;cACrD,OAAO;;IAO/B,UAAU,CAAC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;cAM9C,OAAO,EAAE;oBAAc,MAAM,GAAG,IAAI;;IAG5D,QAAQ,CAAC,EAAE,EAAE,MAAM;cACK,OAAO;;IAO/B,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;cAIrC,OAAO,EAAE;oBAAc,MAAM,GAAG,IAAI;;IAM5D,cAAc,CAAC,MAAM,EAAE,MAAM;cACL,OAAO;;IAO/B,gBAAgB,CAAC,SAAS,EAAE,MAAM;cACV,OAAO,EAAE;;IAOjC,SAAS,CAAC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;cAIX,OAAO,EAAE;oBAAc,MAAM,GAAG,IAAI;;CAEnE"}

package/dist/client.js

@@ -78,35 +78,6 @@ export class TaigaClient {
         return this.request('PUT', `/tenants/current/documents/${type}/draft`, body);
     }
     // ---------------------------------------------------------------------------
-    // Team Documents
-    // ---------------------------------------------------------------------------
-    async listTeamDocuments(teamId, opts) {
-        const params = new URLSearchParams();
-        if (opts?.limit)
-            params.set('limit', String(opts.limit));
-        const qs = params.toString();
-        return this.request('GET', `/teams/${teamId}/documents${qs ? `?${qs}` : ''}`);
-    }
-    async getTeamDocument(teamId, type) {
-        return this.request('GET', `/teams/${teamId}/documents/${type}`);
-    }
-    async saveTeamDocumentDraft(teamId, type, body) {
-        return this.request('PUT', `/teams/${teamId}/documents/${type}/draft`, body);
-    }
-    // ---------------------------------------------------------------------------
-    // Project Documents
-    // ---------------------------------------------------------------------------
-    async listProjectDocuments(projectId, opts) {
-        const params = new URLSearchParams();
-        if (opts?.limit)
-            params.set('limit', String(opts.limit));
-        const qs = params.toString();
-        return this.request('GET', `/projects/${projectId}/documents${qs ? `?${qs}` : ''}`);
-    }
-    async getProjectDocument(projectId, type) {
-        return this.request('GET', `/projects/${projectId}/documents/${type}`);
-    }
-    // ---------------------------------------------------------------------------
     // Skills (agent skills)
     // ---------------------------------------------------------------------------
     async listSkills(opts) {
@@ -123,79 +94,6 @@ export class TaigaClient {
     async getSkill(id) {
         return this.request('GET', `/agent-skills/${id}`);
     }
-    async updateSkill(id, body) {
-        return this.request('PATCH', `/agent-skills/${id}`, body);
-    }
-    // ---------------------------------------------------------------------------
-    // Team Documents
-    // ---------------------------------------------------------------------------
-    /**
-     * Fetch the full context for a project in parallel: project metadata,
-     * team documents, project documents, and team skills.
-     * Returns a structured bundle optimized for coding agent consumption.
-     */
-    async getProjectContext(projectId) {
-        // First fetch the project to get the teamId
-        const project = await this.request('GET', `/projects/${projectId}`);
-        const teamId = project.data.teamId;
-        // Fetch everything in parallel
-        const [projectDocs, teamDocs, skills] = await Promise.all([
-            this.listProjectDocuments(projectId, { limit: 20 }).catch(() => ({ data: [] })),
-            teamId
-                ? this.listTeamDocuments(teamId, { limit: 20 }).catch(() => ({ data: [] }))
-                : Promise.resolve({ data: [] }),
-            this.listSkills({ limit: 100 }).catch(() => ({ data: [] })),
-        ]);
-        // Fetch full content for key documents (in parallel)
-        const keyProjectDocTypes = ['specification', 'architecture', 'technology_decisions'];
-        const keyTeamDocTypes = ['domain_context', 'tech_preferences', 'architecture_constraints'];
-        const docFetches = [];
-        for (const docType of keyProjectDocTypes) {
-            const exists = projectDocs.data.some((d) => d.type === docType && !d.isDraft);
-            if (exists) {
-                docFetches.push(this.getProjectDocument(projectId, docType)
-                    .then((r) => ({ type: docType, scope: 'project', data: r.data }))
-                    .catch(() => ({ type: docType, scope: 'project', data: null })));
-            }
-        }
-        if (teamId) {
-            for (const docType of keyTeamDocTypes) {
-                const exists = teamDocs.data.some((d) => d.type === docType && !d.isDraft);
-                if (exists) {
-                    docFetches.push(this.getTeamDocument(teamId, docType)
-                        .then((r) => ({ type: docType, scope: 'team', data: r.data }))
-                        .catch(() => ({ type: docType, scope: 'team', data: null })));
-                }
-            }
-        }
-        const fetchedDocs = await Promise.all(docFetches);
-        // Assemble context bundle
-        const context = {
-            project: project.data,
-            documents: {
-                project: Object.fromEntries(fetchedDocs.filter((d) => d.scope === 'project' && d.data).map((d) => [d.type, d.data])),
-                team: Object.fromEntries(fetchedDocs.filter((d) => d.scope === 'team' && d.data).map((d) => [d.type, d.data])),
-            },
-            available_documents: {
-                project: projectDocs.data.map((d) => ({
-                    type: d.type,
-                    name: d.name,
-                    version: d.version,
-                    isDraft: d.isDraft,
-                })),
-                team: teamDocs.data.map((d) => ({
-                    type: d.type,
-                    name: d.name,
-                    version: d.version,
-                    isDraft: d.isDraft,
-                })),
-            },
-            skills_summary: skills.data
-                .filter((s) => !s.teamId || s.teamId === teamId)
-                .map((s) => ({ id: s.id, name: s.name, slug: s.slug, description: s.description })),
-        };
-        return context;
-    }
     // ---------------------------------------------------------------------------
     // Backlog
     // ---------------------------------------------------------------------------

package/dist/index.js

@@ -20,39 +20,10 @@ async function main() {
         console.error('Check that your TAIGA_API_KEY is valid and not expired.');
         process.exit(1);
     });
-    // Create MCP server with dynamic tool registration and instructions
+    // Create MCP server with dynamic tool registration
     const server = new McpServer({
         name: 'taiga',
         version: '0.0.1',
-    }, {
-        instructions: [
-            'You have access to Taiga -- a policy-aware software development platform.',
-            "Taiga provides your organization's engineering knowledge base:",
-            '',
-            '**Company policies** (taiga_list_documents / taiga_get_document):',
-            'Security, data privacy, SDLC, architecture, and compliance rules that apply to all code.',
-            'Read the relevant policy BEFORE writing code that touches security, data handling, or infrastructure.',
-            '',
-            '**Team documents** (taiga_list_team_documents / taiga_get_team_document):',
-            'Domain context (ubiquitous language, entities, business rules), tech preferences (approved stack, patterns),',
-            'architecture constraints, and SLO targets. Read these to understand HOW this team builds software.',
-            '',
-            '**Project documents** (taiga_list_project_documents / taiga_get_project_document):',
-            "Specification (what to build), architecture (how it's designed), threat model (security risks),",
-            'technology decisions, and data flow. Read these to understand the specific project context.',
-            '',
-            '**Skills** (taiga_list_skills / taiga_get_skill):',
-            'Coding standards, security requirements, API design patterns, testing strategy, database patterns,',
-            'and more. These are detailed engineering guidelines with code examples.',
-            '',
-            "Workflow: Start with taiga_list_teams to find your team, then read the team's domain_context",
-            'and tech_preferences. For project-specific work, use taiga_list_projects to find the project,',
-            'then read its specification and architecture. Use skills for coding patterns.',
-            '',
-            'When you notice a policy, skill, or team document is outdated, use the update tools',
-            '(taiga_update_document, taiga_update_skill, taiga_update_team_document) to fix it.',
-            'This keeps the knowledge base accurate for everyone.',
-        ].join('\n'),
     });
     registerAllTools(server, client);
     const toolCount = introspection.capabilities.length;

package/dist/server.integration.test.js

@@ -17,19 +17,17 @@ const ALL_CAPABILITIES = [
 ];
 /** All tool names the server can register (sorted for deterministic comparison). */
 const ALL_TOOL_NAMES = [
+    'taiga_get_backlog_item',
     'taiga_get_document',
-    'taiga_get_project_document',
+    'taiga_get_project',
     'taiga_get_skill',
-    'taiga_get_team_document',
+    'taiga_list_backlog_items',
     'taiga_list_documents',
-    'taiga_list_project_documents',
+    'taiga_list_environments',
     'taiga_list_projects',
     'taiga_list_skills',
-    'taiga_list_team_documents',
     'taiga_list_teams',
     'taiga_update_document',
-    'taiga_update_skill',
-    'taiga_update_team_document',
 ];
 function makeFetchRouter(routes) {
     return vi.fn().mockImplementation(async (url, init) => {
@@ -112,7 +110,7 @@ describe('MCP server integration', () => {
     // the API key's capabilities. This is the primary security contract.
     // -------------------------------------------------------------------------
     describe('tool discovery', () => {
-        it('should expose all 13 tools when API key has full capabilities', async () => {
+        it('should expose all 11 tools when API key has full capabilities', async () => {
             const { client } = await bootMcpPair({ capabilities: ALL_CAPABILITIES });
             const { tools } = await client.listTools();
             expect(toolNames(tools)).toEqual(ALL_TOOL_NAMES);
@@ -124,15 +122,15 @@ describe('MCP server integration', () => {
             const { client } = await bootMcpPair({ capabilities: [] });
             await expect(client.listTools()).rejects.toThrow(/Method not found/);
         });
-        it('should expose only team tools for a teams:read-only key', async () => {
-            const { client } = await bootMcpPair({ capabilities: ['teams:read'] });
+        it('should expose only project tools for a projects:read-only key', async () => {
+            const { client } = await bootMcpPair({ capabilities: ['projects:read'] });
             const { tools } = await client.listTools();
             const names = toolNames(tools);
-            expect(names).toContain('taiga_list_teams');
-            expect(names).toContain('taiga_list_team_documents');
-            expect(names).toContain('taiga_get_team_document');
+            expect(names).toContain('taiga_list_projects');
+            expect(names).toContain('taiga_get_project');
+            expect(names).toContain('taiga_list_environments');
+            expect(names).not.toContain('taiga_list_teams');
             expect(names).not.toContain('taiga_list_documents');
-            expect(names).not.toContain('taiga_update_document');
         });
         it('should expose read-only document tools without write capability', async () => {
             const { client } = await bootMcpPair({ capabilities: ['tenant:documents:read'] });
@@ -144,39 +142,35 @@ describe('MCP server integration', () => {
             expect(names).toContain('taiga_get_skill');
             expect(names).not.toContain('taiga_update_document');
         });
-        it('should expose write tools when documents:write is also granted', async () => {
+        it('should expose update tool when documents:write is also granted', async () => {
             const { client } = await bootMcpPair({
                 capabilities: ['tenant:documents:read', 'tenant:documents:write'],
             });
             const { tools } = await client.listTools();
-            const names = toolNames(tools);
-            expect(names).toContain('taiga_update_document');
-            expect(names).toContain('taiga_update_skill');
+            expect(toolNames(tools)).toContain('taiga_update_document');
         });
-        it('should expose team document write when both teams:read and documents:write are granted', async () => {
-            const { client } = await bootMcpPair({
-                capabilities: ['teams:read', 'tenant:documents:write'],
-            });
+        it('should expose backlog tools only with backlog:read', async () => {
+            const { client } = await bootMcpPair({ capabilities: ['backlog:read'] });
             const { tools } = await client.listTools();
             const names = toolNames(tools);
-            expect(names).toContain('taiga_update_team_document');
-            expect(names).toContain('taiga_list_teams');
+            expect(names).toContain('taiga_list_backlog_items');
+            expect(names).toContain('taiga_get_backlog_item');
+            expect(names).not.toContain('taiga_list_environments');
         });
         it('should combine capabilities additively', async () => {
             const { client } = await bootMcpPair({
-                capabilities: ['teams:read', 'tenant:documents:read'],
+                capabilities: ['projects:read', 'backlog:read'],
             });
             const { tools } = await client.listTools();
             const names = toolNames(tools);
-            // teams:read tools present
-            expect(names).toContain('taiga_list_teams');
-            expect(names).toContain('taiga_list_team_documents');
-            // tenant:documents:read tools present
-            expect(names).toContain('taiga_list_documents');
-            expect(names).toContain('taiga_list_skills');
-            // write tools absent
-            expect(names).not.toContain('taiga_update_document');
-            expect(names).not.toContain('taiga_update_skill');
+            // projects:read tools present
+            expect(names).toContain('taiga_list_projects');
+            expect(names).toContain('taiga_list_environments');
+            // backlog:read tools present
+            expect(names).toContain('taiga_list_backlog_items');
+            // unrelated capabilities absent
+            expect(names).not.toContain('taiga_list_documents');
+            expect(names).not.toContain('taiga_list_teams');
         });
         it('should provide a description and input schema for every tool', async () => {
             const { client } = await bootMcpPair({ capabilities: ALL_CAPABILITIES });
@@ -195,10 +189,11 @@ describe('MCP server integration', () => {
     // -------------------------------------------------------------------------
     describe('capability-tool contract', () => {
         const CONTRACT = {
-            'projects:read': ['taiga_list_projects', 'taiga_list_project_documents', 'taiga_get_project_document'],
-            'teams:read': ['taiga_list_teams', 'taiga_list_team_documents', 'taiga_get_team_document'],
+            'projects:read': ['taiga_list_projects', 'taiga_get_project', 'taiga_list_environments'],
+            'teams:read': ['taiga_list_teams'],
             'tenant:documents:read': ['taiga_list_documents', 'taiga_get_document', 'taiga_list_skills', 'taiga_get_skill'],
-            'tenant:documents:write': ['taiga_update_document', 'taiga_update_skill'],
+            'tenant:documents:write': ['taiga_update_document'],
+            'backlog:read': ['taiga_list_backlog_items', 'taiga_get_backlog_item'],
         };
         for (const [capability, expectedTools] of Object.entries(CONTRACT)) {
             it(`${capability} should gate: ${expectedTools.join(', ')}`, async () => {
@@ -217,33 +212,31 @@ describe('MCP server integration', () => {
     // -> (mocked) API -> response back through MCP protocol.
     // -------------------------------------------------------------------------
     describe('tool execution', () => {
-        it('should return team list as JSON text content', async () => {
-            const teams = [
-                { id: 't1', name: 'Product' },
-                { id: 't2', name: 'Platform' },
+        it('should return project list as JSON text content', async () => {
+            const projects = [
+                { id: 'p1', name: 'Alpha' },
+                { id: 'p2', name: 'Beta' },
             ];
             const { client } = await bootMcpPair({
                 capabilities: ALL_CAPABILITIES,
-                routes: { 'GET /v1/teams': { data: teams, nextCursor: null } },
+                routes: { 'GET /v1/projects': { data: projects, nextCursor: null } },
             });
-            const result = await client.callTool({ name: 'taiga_list_teams', arguments: {} });
+            const result = await client.callTool({ name: 'taiga_list_projects', arguments: {} });
             expect(result.content).toHaveLength(1);
-            expect(parseToolResult(result)).toEqual(teams);
+            expect(parseToolResult(result)).toEqual(projects);
         });
-        it('should send PATCH when updating a skill', async () => {
-            const skillId = '00000000-0000-0000-0000-000000000001';
-            const updated = { id: skillId, name: 'Updated Skill', content: '# Updated' };
-            const { client, fetchSpy } = await bootMcpPair({
+        it('should pass project id through to the API', async () => {
+            const projectId = '00000000-0000-0000-0000-000000000001';
+            const project = { id: projectId, name: 'Alpha', status: 'active' };
+            const { client } = await bootMcpPair({
                 capabilities: ALL_CAPABILITIES,
-                routes: { [`PATCH /v1/agent-skills/${skillId}`]: { data: updated } },
+                routes: { [`GET /v1/projects/${projectId}`]: { data: project } },
             });
-            await client.callTool({
-                name: 'taiga_update_skill',
-                arguments: { id: skillId, content: '# Updated' },
+            const result = await client.callTool({
+                name: 'taiga_get_project',
+                arguments: { id: projectId },
             });
-            const patchCall = fetchSpy.mock.calls.find((c) => c[1]?.method === 'PATCH');
-            expect(patchCall).toBeDefined();
-            expect(patchCall[0]).toContain(`/v1/agent-skills/${skillId}`);
+            expect(parseToolResult(result)).toEqual(project);
         });
         it('should return document content through MCP protocol', async () => {
             const docs = [{ id: 'd1', title: 'Security Policy' }];
@@ -269,21 +262,18 @@ describe('MCP server integration', () => {
             expect(putCall).toBeDefined();
             expect(putCall[0]).toContain(`/v1/tenants/current/documents/${docType}/draft`);
         });
-        it('should send PUT when updating a team document draft', async () => {
-            const teamId = '00000000-0000-0000-0000-000000000001';
-            const docType = 'domain_context';
-            const updated = { type: docType, name: 'Domain Context' };
-            const { client, fetchSpy } = await bootMcpPair({
+        it('should pass projectId to backlog items endpoint', async () => {
+            const projectId = '00000000-0000-0000-0000-000000000001';
+            const items = [{ id: 'bi1', name: 'Feature X' }];
+            const { client } = await bootMcpPair({
                 capabilities: ALL_CAPABILITIES,
-                routes: { [`PUT /v1/teams/${teamId}/documents/${docType}/draft`]: { data: updated } },
+                routes: { [`GET /v1/projects/${projectId}/backlog`]: { data: items, nextCursor: null } },
             });
-            await client.callTool({
-                name: 'taiga_update_team_document',
-                arguments: { teamId, type: docType, data: { sections: { overview: 'Updated' } } },
+            const result = await client.callTool({
+                name: 'taiga_list_backlog_items',
+                arguments: { projectId },
             });
-            const putCall = fetchSpy.mock.calls.find((c) => c[1]?.method === 'PUT' && c[0].includes('/teams/'));
-            expect(putCall).toBeDefined();
-            expect(putCall[0]).toContain(`/v1/teams/${teamId}/documents/${docType}/draft`);
+            expect(parseToolResult(result)).toEqual(items);
         });
         it('should return skills through MCP protocol', async () => {
             const skills = [{ id: 's1', name: 'React Standards' }];

package/dist/tools/backlogs.d.ts

@@ -1,4 +1,4 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { TaigaClient } from '../client.js';
-export declare function registerBacklogTools(_server: McpServer, _client: TaigaClient): void;
+export declare function registerBacklogTools(server: McpServer, client: TaigaClient): void;
 //# sourceMappingURL=backlogs.d.ts.map

package/dist/tools/backlogs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backlogs.d.ts","sourceRoot":"","sources":["../../src/tools/backlogs.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,QAG5E"}
+{"version":3,"file":"backlogs.d.ts","sourceRoot":"","sources":["../../src/tools/backlogs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,QAgD1E"}

package/dist/tools/backlogs.js

@@ -1,6 +1,33 @@
-// Backlog tools are reserved for post-beta.
-// The beta MCP server focuses on the knowledge base (policies, skills, team docs).
-export function registerBacklogTools(_server, _client) {
-    // No backlog tools in beta -- will be added when the MCP server
-    // expands beyond the knowledge base use case.
+import { z } from 'zod';
+export function registerBacklogTools(server, client) {
+    if (client.hasCapability('backlog:read')) {
+        server.tool('taiga_list_backlog_items', 'List backlog items (features, tasks, stories) for a project. ' +
+            'Returns item name, status, planning status, and priority.', {
+            projectId: z.string().uuid().describe('Project ID'),
+            limit: z.number().min(1).max(100).optional().describe('Max results (default 25)'),
+        }, async (params) => {
+            const result = await client.listBacklogItems(params.projectId, { limit: params.limit });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }],
+            };
+        });
+        server.tool('taiga_get_backlog_item', 'Get detailed information about a specific backlog item, including its active plan and steps.', {
+            itemId: z.string().uuid().describe('Backlog item ID'),
+        }, async (params) => {
+            const result = await client.getBacklogItem(params.itemId);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }],
+            };
+        });
+    }
+    if (client.hasCapability('projects:read')) {
+        server.tool('taiga_list_environments', 'List deployment environments (dev, staging, production) for a project.', {
+            projectId: z.string().uuid().describe('Project ID'),
+        }, async (params) => {
+            const result = await client.listEnvironments(params.projectId);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }],
+            };
+        });
+    }
 }

package/dist/tools/documents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/tools/documents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,QA6I3E"}
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/tools/documents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,QAkD3E"}

package/dist/tools/documents.js

@@ -1,30 +1,19 @@
 import { z } from 'zod';
-import { summarizeList } from './summarize.js';
 export function registerDocumentTools(server, client) {
-    // ── Company-level policy documents ──────────────────────────────────
     if (client.hasCapability('tenant:documents:read')) {
-        server.tool('taiga_list_documents', 'List company-level policy documents (names and types only). ' +
-            'Policies define security, data privacy, SDLC, operations, architecture, and compliance rules ' +
-            'that apply across all teams and projects. ' +
-            'Use taiga_get_document with the document type to read the full policy content.', {
+        server.tool('taiga_list_documents', 'List company-level policy documents (security, data privacy, SDLC, etc). ' +
+            'These are the governance documents that guide all projects.', {
             limit: z.number().min(1).max(100).optional().describe('Max results (default 25)'),
-        }, { readOnlyHint: true, openWorldHint: false }, async (params) => {
+        }, async (params) => {
             const result = await client.listTenantDocuments(params);
-            const summaries = summarizeList(result.data);
             return {
-                content: [{ type: 'text', text: JSON.stringify(summaries, null, 2) }],
+                content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }],
             };
         });
-        server.tool('taiga_get_document', 'Get the full content of a company policy document. ' +
-            'Use this when you need to understand security requirements, data handling rules, ' +
-            'architecture standards, or compliance controls that apply to your code. ' +
-            'Types: policy_security, policy_data, policy_sdlc, policy_ops, policy_tic, ' +
-            'policy_risk, policy_architecture, policy_supply_chain, policy_acceptable_use, policy_ip.', {
-            type: z
-                .string()
-                .describe('Document type -- get available types from taiga_list_documents. ' +
-                'Common: policy_security, policy_data, policy_sdlc, policy_architecture'),
-        }, { readOnlyHint: true, openWorldHint: false }, async (params) => {
+        server.tool('taiga_get_document', 'Get the full content of a specific policy document by type. ' +
+            'Common types: security_policy, data_privacy_policy, sdlc_policy, architecture_standards.', {
+            type: z.string().describe('Document type (e.g. security_policy, sdlc_policy)'),
+        }, async (params) => {
             const result = await client.getTenantDocument(params.type);
             return {
                 content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }],
@@ -32,12 +21,10 @@ export function registerDocumentTools(server, client) {
         });
     }
     if (client.hasCapability('tenant:documents:write')) {
-        server.tool('taiga_update_document', 'Update the draft content of a company policy document. ' +
-            'Only updates the draft -- does not publish. Use this when you notice a policy ' +
-            'is outdated or needs corrections while reviewing code.', {
-            type: z.string().describe('Document type (e.g. policy_security, policy_sdlc)'),
-            data: z.record(z.string(), z.unknown()).describe('Document content to save as JSON'),
-        }, { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false }, async (params) => {
+        server.tool('taiga_update_document', 'Update the draft content of a policy document. Only updates the draft -- does not publish.', {
+            type: z.string().describe('Document type (e.g. security_policy)'),
+            data: z.record(z.string(), z.unknown()).describe('Document content to save'),
+        }, async (params) => {
             const { type, ...body } = params;
             const result = await client.saveTenantDocumentDraft(type, body);
             return {
@@ -45,53 +32,4 @@ export function registerDocumentTools(server, client) {
             };
         });
     }
-    // ── Team documents ──────────────────────────────────────────────────
-    if (client.hasCapability('teams:read')) {
-        server.tool('taiga_list_team_documents', 'List documents for a specific team (names and types only). ' +
-            'Team documents define how the team works: domain context (entities, ubiquitous language), ' +
-            'tech preferences (approved stack), architecture constraints, SLO targets, ' +
-            'definition of done, and team charter. ' +
-            'Use taiga_get_team_document to read the full content.', {
-            teamId: z.string().uuid().describe('Team ID -- get from taiga_list_teams'),
-            limit: z.number().min(1).max(100).optional().describe('Max results (default 25)'),
-        }, { readOnlyHint: true, openWorldHint: false }, async (params) => {
-            const result = await client.listTeamDocuments(params.teamId, { limit: params.limit });
-            const summaries = summarizeList(result.data);
-            return {
-                content: [{ type: 'text', text: JSON.stringify(summaries, null, 2) }],
-            };
-        });
-        server.tool('taiga_get_team_document', 'Get the full content of a specific team document. ' +
-            'Use this when you need the team domain context (ubiquitous language, entities, business rules), ' +
-            'tech preferences (approved stack, patterns), or architecture constraints. ' +
-            'Types: team_charter, definition_of_done, tech_preferences, ' +
-            'architecture_constraints, slo_targets, domain_context.', {
-            teamId: z.string().uuid().describe('Team ID -- get from taiga_list_teams'),
-            type: z
-                .string()
-                .describe('Document type -- get available types from taiga_list_team_documents. ' +
-                'Most useful: domain_context (entities, language), tech_preferences (stack, patterns)'),
-        }, { readOnlyHint: true, openWorldHint: false }, async (params) => {
-            const result = await client.getTeamDocument(params.teamId, params.type);
-            return {
-                content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }],
-            };
-        });
-    }
-    // Team document write requires both teams:read (to find the team) and tenant:documents:write
-    if (client.hasCapability('teams:read') && client.hasCapability('tenant:documents:write')) {
-        server.tool('taiga_update_team_document', 'Update the draft content of a team document. ' +
-            'Only updates the draft -- does not publish. Use this when you notice team conventions, ' +
-            'domain context, or tech preferences need updating while working on the codebase.', {
-            teamId: z.string().uuid().describe('Team ID -- get from taiga_list_teams'),
-            type: z.string().describe('Document type (e.g. domain_context, tech_preferences)'),
-            data: z.record(z.string(), z.unknown()).describe('Document content to save as JSON'),
-        }, { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false }, async (params) => {
-            const { teamId, type, ...body } = params;
-            const result = await client.saveTeamDocumentDraft(teamId, type, body);
-            return {
-                content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }],
-            };
-        });
-    }
 }

package/dist/tools/index.d.ts

@@ -4,9 +4,6 @@ import type { TaigaClient } from '../client.js';
  * Register all MCP tools based on the API key's effective capabilities.
  * Only tools matching the key's scopes are registered -- the AI assistant
  * never sees tools it can't use.
- *
- * Beta scope: Knowledge base access (policies, skills, team documents).
- * Post-beta: Projects, backlog items, environments, composite tools.
  */
 export declare function registerAllTools(server: McpServer, client: TaigaClient): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAMhD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAK7E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAMhD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAK7E"}

package/dist/tools/index.js

@@ -6,9 +6,6 @@ import { registerSkillTools } from './skills.js';
  * Register all MCP tools based on the API key's effective capabilities.
  * Only tools matching the key's scopes are registered -- the AI assistant
  * never sees tools it can't use.
- *
- * Beta scope: Knowledge base access (policies, skills, team documents).
- * Post-beta: Projects, backlog items, environments, composite tools.
  */
 export function registerAllTools(server, client) {
     registerProjectTools(server, client);

package/dist/tools/projects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/tools/projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,QA0F1E"}
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/tools/projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,QAgD1E"}