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

package/dist/client.d.ts

@@ -40,6 +40,29 @@ 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;
@@ -51,6 +74,19 @@ 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":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -78,6 +78,35 @@ 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) {
@@ -94,6 +123,79 @@ 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,10 +20,39 @@ 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
+    // Create MCP server with dynamic tool registration and instructions
     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,17 +17,19 @@ 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',
+    'taiga_get_project_document',
     'taiga_get_skill',
-    'taiga_list_backlog_items',
+    'taiga_get_team_document',
     'taiga_list_documents',
-    'taiga_list_environments',
+    'taiga_list_project_documents',
     '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) => {
@@ -110,7 +112,7 @@ describe('MCP server integration', () => {
     // the API key's capabilities. This is the primary security contract.
     // -------------------------------------------------------------------------
     describe('tool discovery', () => {
-        it('should expose all 11 tools when API key has full capabilities', async () => {
+        it('should expose all 13 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);
@@ -122,15 +124,15 @@ describe('MCP server integration', () => {
             const { client } = await bootMcpPair({ capabilities: [] });
             await expect(client.listTools()).rejects.toThrow(/Method not found/);
         });
-        it('should expose only project tools for a projects:read-only key', async () => {
-            const { client } = await bootMcpPair({ capabilities: ['projects:read'] });
+        it('should expose only team tools for a teams:read-only key', async () => {
+            const { client } = await bootMcpPair({ capabilities: ['teams:read'] });
             const { tools } = await client.listTools();
             const names = toolNames(tools);
-            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).toContain('taiga_list_teams');
+            expect(names).toContain('taiga_list_team_documents');
+            expect(names).toContain('taiga_get_team_document');
             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'] });
@@ -142,35 +144,39 @@ describe('MCP server integration', () => {
             expect(names).toContain('taiga_get_skill');
             expect(names).not.toContain('taiga_update_document');
         });
-        it('should expose update tool when documents:write is also granted', async () => {
+        it('should expose write tools when documents:write is also granted', async () => {
             const { client } = await bootMcpPair({
                 capabilities: ['tenant:documents:read', 'tenant:documents:write'],
             });
             const { tools } = await client.listTools();
-            expect(toolNames(tools)).toContain('taiga_update_document');
+            const names = toolNames(tools);
+            expect(names).toContain('taiga_update_document');
+            expect(names).toContain('taiga_update_skill');
         });
-        it('should expose backlog tools only with backlog:read', async () => {
-            const { client } = await bootMcpPair({ capabilities: ['backlog:read'] });
+        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'],
+            });
             const { tools } = await client.listTools();
             const names = toolNames(tools);
-            expect(names).toContain('taiga_list_backlog_items');
-            expect(names).toContain('taiga_get_backlog_item');
-            expect(names).not.toContain('taiga_list_environments');
+            expect(names).toContain('taiga_update_team_document');
+            expect(names).toContain('taiga_list_teams');
         });
         it('should combine capabilities additively', async () => {
             const { client } = await bootMcpPair({
-                capabilities: ['projects:read', 'backlog:read'],
+                capabilities: ['teams:read', 'tenant:documents:read'],
             });
             const { tools } = await client.listTools();
             const names = toolNames(tools);
-            // 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');
+            // 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');
         });
         it('should provide a description and input schema for every tool', async () => {
             const { client } = await bootMcpPair({ capabilities: ALL_CAPABILITIES });
@@ -189,11 +195,10 @@ describe('MCP server integration', () => {
     // -------------------------------------------------------------------------
     describe('capability-tool contract', () => {
         const CONTRACT = {
-            'projects:read': ['taiga_list_projects', 'taiga_get_project', 'taiga_list_environments'],
-            'teams:read': ['taiga_list_teams'],
+            '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'],
             'tenant:documents:read': ['taiga_list_documents', 'taiga_get_document', 'taiga_list_skills', 'taiga_get_skill'],
-            'tenant:documents:write': ['taiga_update_document'],
-            'backlog:read': ['taiga_list_backlog_items', 'taiga_get_backlog_item'],
+            'tenant:documents:write': ['taiga_update_document', 'taiga_update_skill'],
         };
         for (const [capability, expectedTools] of Object.entries(CONTRACT)) {
             it(`${capability} should gate: ${expectedTools.join(', ')}`, async () => {
@@ -212,31 +217,33 @@ describe('MCP server integration', () => {
     // -> (mocked) API -> response back through MCP protocol.
     // -------------------------------------------------------------------------
     describe('tool execution', () => {
-        it('should return project list as JSON text content', async () => {
-            const projects = [
-                { id: 'p1', name: 'Alpha' },
-                { id: 'p2', name: 'Beta' },
+        it('should return team list as JSON text content', async () => {
+            const teams = [
+                { id: 't1', name: 'Product' },
+                { id: 't2', name: 'Platform' },
             ];
             const { client } = await bootMcpPair({
                 capabilities: ALL_CAPABILITIES,
-                routes: { 'GET /v1/projects': { data: projects, nextCursor: null } },
+                routes: { 'GET /v1/teams': { data: teams, nextCursor: null } },
             });
-            const result = await client.callTool({ name: 'taiga_list_projects', arguments: {} });
+            const result = await client.callTool({ name: 'taiga_list_teams', arguments: {} });
             expect(result.content).toHaveLength(1);
-            expect(parseToolResult(result)).toEqual(projects);
+            expect(parseToolResult(result)).toEqual(teams);
         });
-        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({
+        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({
                 capabilities: ALL_CAPABILITIES,
-                routes: { [`GET /v1/projects/${projectId}`]: { data: project } },
+                routes: { [`PATCH /v1/agent-skills/${skillId}`]: { data: updated } },
             });
-            const result = await client.callTool({
-                name: 'taiga_get_project',
-                arguments: { id: projectId },
+            await client.callTool({
+                name: 'taiga_update_skill',
+                arguments: { id: skillId, content: '# Updated' },
             });
-            expect(parseToolResult(result)).toEqual(project);
+            const patchCall = fetchSpy.mock.calls.find((c) => c[1]?.method === 'PATCH');
+            expect(patchCall).toBeDefined();
+            expect(patchCall[0]).toContain(`/v1/agent-skills/${skillId}`);
         });
         it('should return document content through MCP protocol', async () => {
             const docs = [{ id: 'd1', title: 'Security Policy' }];
@@ -262,18 +269,21 @@ describe('MCP server integration', () => {
             expect(putCall).toBeDefined();
             expect(putCall[0]).toContain(`/v1/tenants/current/documents/${docType}/draft`);
         });
-        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({
+        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({
                 capabilities: ALL_CAPABILITIES,
-                routes: { [`GET /v1/projects/${projectId}/backlog`]: { data: items, nextCursor: null } },
+                routes: { [`PUT /v1/teams/${teamId}/documents/${docType}/draft`]: { data: updated } },
             });
-            const result = await client.callTool({
-                name: 'taiga_list_backlog_items',
-                arguments: { projectId },
+            await client.callTool({
+                name: 'taiga_update_team_document',
+                arguments: { teamId, type: docType, data: { sections: { overview: 'Updated' } } },
             });
-            expect(parseToolResult(result)).toEqual(items);
+            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`);
         });
         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":"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"}
+{"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"}

package/dist/tools/backlogs.js

@@ -1,33 +1,6 @@
-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) }],
-            };
-        });
-    }
+// 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.
 }

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;AAEhD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,QAkD3E"}
+{"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"}

package/dist/tools/documents.js

@@ -1,19 +1,30 @@
 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 (security, data privacy, SDLC, etc). ' +
-            'These are the governance documents that guide all projects.', {
+        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.', {
             limit: z.number().min(1).max(100).optional().describe('Max results (default 25)'),
-        }, async (params) => {
+        }, { readOnlyHint: true, openWorldHint: false }, async (params) => {
             const result = await client.listTenantDocuments(params);
+            const summaries = summarizeList(result.data);
             return {
-                content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }],
+                content: [{ type: 'text', text: JSON.stringify(summaries, null, 2) }],
             };
         });
-        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) => {
+        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) => {
             const result = await client.getTenantDocument(params.type);
             return {
                 content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }],
@@ -21,10 +32,12 @@ export function registerDocumentTools(server, client) {
         });
     }
     if (client.hasCapability('tenant:documents:write')) {
-        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) => {
+        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) => {
             const { type, ...body } = params;
             const result = await client.saveTenantDocumentDraft(type, body);
             return {
@@ -32,4 +45,53 @@ 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,6 +4,9 @@ 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;;;;GAIG;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;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAK7E"}

package/dist/tools/index.js

@@ -6,6 +6,9 @@ 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;AAEhD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,QAgD1E"}
+{"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"}