@ferrtrack/mcp 10.13.2 → 10.13.3

package/dist/tools/__tests__/annotations.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=annotations.test.d.ts.map

package/dist/tools/__tests__/annotations.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/annotations.test.ts"],"names":[],"mappings":""}

package/dist/tools/__tests__/annotations.test.js

@@ -0,0 +1,56 @@
+import { describe, it, expect, vi } from 'vitest';
+process.env.FERRLABS_API_TOKEN = 'test-token';
+const annotations = new Map();
+const mockServer = {
+    tool: vi.fn((name, _desc, _schema, ...rest) => {
+        annotations.set(name, rest.length > 1 ? rest[0] : undefined);
+    }),
+};
+const DESTRUCTIVE = ['delete_issue_comment', 'delete_cycle', 'delete_milestone'];
+const READ_ONLY = [
+    'list_track_projects',
+    'get_project',
+    'list_track_issues',
+    'get_issue',
+    'list_issue_links',
+    'list_issue_comments',
+    'list_cycles',
+    'list_cycle_issues',
+    'list_milestones',
+    'list_track_users',
+    'search_track',
+];
+describe('tool annotations', async () => {
+    const { registerProjectTools } = await import('../projects.js');
+    const { registerIssueDetailsTool } = await import('../issue-details.js');
+    const { registerIssueTools } = await import('../issues.js');
+    const { registerCommentTools } = await import('../comments.js');
+    const { registerCycleTools } = await import('../cycles.js');
+    const { registerMilestoneTools } = await import('../milestones.js');
+    const { registerSearchTools } = await import('../search.js');
+    registerProjectTools(mockServer);
+    registerIssueDetailsTool(mockServer);
+    registerIssueTools(mockServer);
+    registerCommentTools(mockServer);
+    registerCycleTools(mockServer);
+    registerMilestoneTools(mockServer);
+    registerSearchTools(mockServer);
+    it.each(DESTRUCTIVE)('%s is marked destructive', (name) => {
+        expect(annotations.get(name)?.destructiveHint).toBe(true);
+    });
+    it.each(READ_ONLY)('%s is marked read-only', (name) => {
+        expect(annotations.get(name)?.readOnlyHint).toBe(true);
+    });
+    it('marks no other tool destructive or read-only', () => {
+        const flagged = new Set([...DESTRUCTIVE, ...READ_ONLY]);
+        for (const [name, a] of annotations) {
+            if (!flagged.has(name)) {
+                expect(a?.destructiveHint, name).toBeUndefined();
+                expect(a?.readOnlyHint, name).toBeUndefined();
+            }
+        }
+    });
+    it('covers every registered tool', () => {
+        expect(annotations.size).toBe(DESTRUCTIVE.length + READ_ONLY.length + 11);
+    });
+});

package/dist/tools/__tests__/writes.test.js

@@ -3,8 +3,8 @@ process.env.FERRLABS_API_TOKEN = 'test-token';
 const handlers = new Map();
 const schemas = new Map();
 const mockServer = {
-    tool: vi.fn((name, _desc, schema, handler) => {
-        handlers.set(name, handler);
+    tool: vi.fn((name, _desc, schema, ...rest) => {
+        handlers.set(name, rest[rest.length - 1]);
         schemas.set(name, schema);
     }),
 };
@@ -36,9 +36,11 @@ describe('ferrtrack write tools', () => {
         mockFetch.mockResolvedValue(ok());
         const { registerIssueTools } = await import('../issues.js');
         const { registerCycleTools } = await import('../cycles.js');
+        const { registerMilestoneTools } = await import('../milestones.js');
         const { registerCommentTools } = await import('../comments.js');
         registerIssueTools(mockServer);
         registerCycleTools(mockServer);
+        registerMilestoneTools(mockServer);
         registerCommentTools(mockServer);
     });
     it('negotiates the contract by date header, with no version left in the path', async () => {
@@ -98,4 +100,45 @@ describe('ferrtrack write tools', () => {
         expect(status.safeParse('closed').success).toBe(true);
         expect(status.safeParse('done').success).toBe(false);
     });
+    it('does not expose get tools for routes the API does not serve', () => {
+        expect(handlers.has('get_cycle')).toBe(false);
+        expect(handlers.has('get_milestone')).toBe(false);
+    });
+    it('create_cycle requires ISO datetimes, since the API rejects plain dates', () => {
+        const { starts_at, ends_at } = schemas.get('create_cycle');
+        expect(starts_at.safeParse('2026-01-05T00:00:00Z').success).toBe(true);
+        expect(starts_at.safeParse('2026-01-05T00:00:00+02:00').success).toBe(true);
+        expect(starts_at.safeParse('2026-01-05').success).toBe(false);
+        expect(ends_at.safeParse('2026-01-19').success).toBe(false);
+    });
+    it('update_cycle has no status field, since status is derived from dates', () => {
+        expect(schemas.get('update_cycle')).not.toHaveProperty('status');
+    });
+    it('create_milestone sends summary and target_date', async () => {
+        await handlers.get('create_milestone')({
+            project_slug: 'web',
+            name: 'v1',
+            summary: 'first release',
+            target_date: '2026-03-01',
+        });
+        const call = lastCall();
+        expect(call.url).toBe(`${TRACK}/projects/web/milestones`);
+        expect(call.body).toEqual({ name: 'v1', summary: 'first release', target_date: '2026-03-01' });
+    });
+    it('update_milestone patches summary and target_date and nothing else', async () => {
+        await handlers.get('update_milestone')({ milestone_id: 'm1', target_date: null });
+        const call = lastCall();
+        expect(call.url).toBe(`${TRACK}/milestones/m1`);
+        expect(call.method).toBe('PATCH');
+        expect(call.body).toEqual({ target_date: null });
+    });
+    it('update_milestone accepts the API status values only', () => {
+        const { status } = schemas.get('update_milestone');
+        for (const ok of ['planned', 'in_progress', 'shipped', 'canceled']) {
+            expect(status.safeParse(ok).success).toBe(true);
+        }
+        for (const bad of ['open', 'completed', 'cancelled']) {
+            expect(status.safeParse(bad).success).toBe(false);
+        }
+    });
 });

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

@@ -1 +1 @@
-{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../src/tools/comments.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,SAAS,EAAc,MAAM,oBAAoB,CAAC;AAY1E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,QA4ErD"}
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../src/tools/comments.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,SAAS,EAAc,MAAM,oBAAoB,CAAC;AAY1E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,QA8ErD"}

package/dist/tools/comments.js

@@ -4,7 +4,7 @@ import { trackRequest } from '../api-base.js';
 export function registerCommentTools(server) {
     server.tool('list_issue_comments', 'List all comments on a FerrTrack issue by its ref (e.g. "FT-12").', {
         issue_ref: z.string().min(1).describe('Issue ref, e.g. "FT-12"'),
-    }, async ({ issue_ref }) => {
+    }, { readOnlyHint: true }, async ({ issue_ref }) => {
         const token = await getToken();
         const comments = await trackRequest(`/issues/${encodeURIComponent(issue_ref)}/comments`, { token });
         return {
@@ -35,7 +35,7 @@ export function registerCommentTools(server) {
     server.tool('delete_issue_comment', 'Delete a comment you authored on a FerrTrack issue.', {
         issue_ref: z.string().min(1).describe('Issue ref, e.g. "FT-12"'),
         comment_id: z.string().min(1).describe('Comment id'),
-    }, async ({ issue_ref, comment_id }) => {
+    }, { destructiveHint: true }, async ({ issue_ref, comment_id }) => {
         const token = await getToken();
         await trackRequest(`/issues/${encodeURIComponent(issue_ref)}/comments/${encodeURIComponent(comment_id)}`, { token, method: 'DELETE' });
         return {

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

@@ -1 +1 @@
-{"version":3,"file":"cycles.d.ts","sourceRoot":"","sources":["../../src/tools/cycles.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,SAAS,EAAc,MAAM,oBAAoB,CAAC;AAuB1E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,QA2InD"}
+{"version":3,"file":"cycles.d.ts","sourceRoot":"","sources":["../../src/tools/cycles.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,SAAS,EAAc,MAAM,oBAAoB,CAAC;AAwB1E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,QA8HnD"}

package/dist/tools/cycles.js

@@ -2,18 +2,9 @@ import { z } from 'zod';
 import { getToken, toToolText } from '@ferrlabs/mcp-core';
 import { trackRequest } from '../api-base.js';
 export function registerCycleTools(server) {
-    server.tool('get_cycle', 'Get a single FerrTrack cycle by id.', {
-        cycle_id: z.string().min(1).describe('Cycle id'),
-    }, async ({ cycle_id }) => {
-        const token = await getToken();
-        const cycle = await trackRequest(`/cycles/${encodeURIComponent(cycle_id)}`, { token });
-        return {
-            content: [{ type: 'text', text: toToolText(cycle) }],
-        };
-    });
     server.tool('list_cycles', 'List cycles (sprints) for a FerrTrack project.', {
         project_slug: z.string().min(1).describe('Project slug'),
-    }, async ({ project_slug }) => {
+    }, { readOnlyHint: true }, async ({ project_slug }) => {
         const token = await getToken();
         const cycles = await trackRequest(`/projects/${encodeURIComponent(project_slug)}/cycles`, { token });
         return {
@@ -22,18 +13,18 @@ export function registerCycleTools(server) {
     });
     server.tool('list_cycle_issues', 'List the issues currently assigned to a FerrTrack cycle.', {
         cycle_id: z.string().min(1).describe('Cycle id'),
-    }, async ({ cycle_id }) => {
+    }, { readOnlyHint: true }, async ({ cycle_id }) => {
         const token = await getToken();
         const issues = await trackRequest(`/cycles/${encodeURIComponent(cycle_id)}/issues`, { token });
         return {
             content: [{ type: 'text', text: toToolText(issues) }],
         };
     });
-    server.tool('create_cycle', 'Create a new cycle in a project. Dates are ISO 8601 (YYYY-MM-DD).', {
+    server.tool('create_cycle', 'Create a new cycle in a project. Dates are ISO 8601 datetimes (e.g. 2026-01-05T00:00:00Z).', {
         project_slug: z.string().min(1).describe('Project slug'),
         name: z.string().min(1).max(100),
-        starts_at: z.string().describe('ISO date — cycle start.'),
-        ends_at: z.string().describe('ISO date — cycle end.'),
+        starts_at: z.iso.datetime({ offset: true }).describe('ISO datetime — cycle start.'),
+        ends_at: z.iso.datetime({ offset: true }).describe('ISO datetime — cycle end.'),
     }, async ({ project_slug, name, starts_at, ends_at }) => {
         const token = await getToken();
         const cycle = await trackRequest(`/projects/${encodeURIComponent(project_slug)}/cycles`, {
@@ -54,12 +45,11 @@ export function registerCycleTools(server) {
             content: [{ type: 'text', text: toToolText(cycle) }],
         };
     });
-    server.tool('update_cycle', 'Patch a cycle — rename it, shift dates, or close it. Only fields you pass are touched.', {
+    server.tool('update_cycle', 'Patch a cycle — rename it, or shift dates. Status is derived from the dates. Only fields you pass are touched.', {
         cycle_id: z.string().min(1).describe('Cycle id'),
         name: z.string().min(1).max(100).optional(),
-        starts_at: z.string().optional(),
-        ends_at: z.string().optional(),
-        status: z.enum(['planned', 'active', 'completed']).optional(),
+        starts_at: z.iso.datetime({ offset: true }).optional(),
+        ends_at: z.iso.datetime({ offset: true }).optional(),
     }, async ({ cycle_id, ...patch }) => {
         const token = await getToken();
         const body = {};
@@ -78,7 +68,7 @@ export function registerCycleTools(server) {
     });
     server.tool('delete_cycle', 'Delete a cycle. Issues that were on it become un-cycled.', {
         cycle_id: z.string().min(1).describe('Cycle id'),
-    }, async ({ cycle_id }) => {
+    }, { destructiveHint: true }, async ({ cycle_id }) => {
         const token = await getToken();
         await trackRequest(`/cycles/${encodeURIComponent(cycle_id)}`, {
             token,

package/dist/tools/issue-details.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"issue-details.d.ts","sourceRoot":"","sources":["../../src/tools/issue-details.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,SAAS,EAAc,MAAM,oBAAoB,CAAC;AAoB1E,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,QAiBzD"}
+{"version":3,"file":"issue-details.d.ts","sourceRoot":"","sources":["../../src/tools/issue-details.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,SAAS,EAAc,MAAM,oBAAoB,CAAC;AAoB1E,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,QAkBzD"}

package/dist/tools/issue-details.js

@@ -4,7 +4,7 @@ import { trackRequest } from '../api-base.js';
 export function registerIssueDetailsTool(server) {
     server.tool('get_issue', 'Get the full content of a FerrTrack issue by its ref (e.g. "FT-12") — title, body, status, kind, labels, assignee.', {
         issue_ref: z.string().min(1).describe('Issue ref, e.g. "FT-12"'),
-    }, async ({ issue_ref }) => {
+    }, { readOnlyHint: true }, async ({ issue_ref }) => {
         const token = await getToken();
         const issue = await trackRequest(`/issues/${encodeURIComponent(issue_ref)}`, {
             token,

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

@@ -1 +1 @@
-{"version":3,"file":"issues.d.ts","sourceRoot":"","sources":["../../src/tools/issues.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,SAAS,EAAc,MAAM,oBAAoB,CAAC;AAG1E,UAAU,KAAK;IACb,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,YAAY;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,KAAK,EAAE,CAAC,CAWlB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,QAqHnD"}
+{"version":3,"file":"issues.d.ts","sourceRoot":"","sources":["../../src/tools/issues.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,SAAS,EAAc,MAAM,oBAAoB,CAAC;AAG1E,UAAU,KAAK;IACb,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,YAAY;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,KAAK,EAAE,CAAC,CAWlB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,QAuHnD"}

package/dist/tools/issues.js

@@ -36,7 +36,7 @@ export function registerIssueTools(server) {
             .max(200)
             .optional()
             .describe('Max issues to return (default 50).'),
-    }, async ({ project_slug, status, kind, assignee_id, limit }) => {
+    }, { readOnlyHint: true }, async ({ project_slug, status, kind, assignee_id, limit }) => {
         const issues = await fetchProjectIssues(project_slug, { status, kind, assignee_id, limit });
         return {
             content: [{ type: 'text', text: toToolText(issues) }],
@@ -100,7 +100,7 @@ export function registerIssueTools(server) {
     });
     server.tool('list_issue_links', 'List GitHub PR ↔ FerrTrack issue links for one issue (created by the GitHub webhook on push).', {
         issue_ref: z.string().min(1).describe('Issue ref, e.g. "FT-12"'),
-    }, async ({ issue_ref }) => {
+    }, { readOnlyHint: true }, async ({ issue_ref }) => {
         const token = await getToken();
         const links = await trackRequest(`/issues/${encodeURIComponent(issue_ref)}/links`, {
             token,

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

@@ -1 +1 @@
-{"version":3,"file":"milestones.d.ts","sourceRoot":"","sources":["../../src/tools/milestones.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,SAAS,EAAc,MAAM,oBAAoB,CAAC;AAc1E,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QA6GvD"}
+{"version":3,"file":"milestones.d.ts","sourceRoot":"","sources":["../../src/tools/milestones.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,SAAS,EAAc,MAAM,oBAAoB,CAAC;AAc1E,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QA6FvD"}

package/dist/tools/milestones.js

@@ -2,50 +2,41 @@ import { z } from 'zod';
 import { getToken, toToolText } from '@ferrlabs/mcp-core';
 import { trackRequest } from '../api-base.js';
 export function registerMilestoneTools(server) {
-    server.tool('get_milestone', 'Get a single FerrTrack milestone by id.', {
-        milestone_id: z.string().min(1).describe('Milestone id'),
-    }, async ({ milestone_id }) => {
-        const token = await getToken();
-        const milestone = await trackRequest(`/milestones/${encodeURIComponent(milestone_id)}`, { token });
-        return {
-            content: [{ type: 'text', text: toToolText(milestone) }],
-        };
-    });
     server.tool('list_milestones', 'List milestones for a FerrTrack project.', {
         project_slug: z.string().min(1).describe('Project slug'),
-    }, async ({ project_slug }) => {
+    }, { readOnlyHint: true }, async ({ project_slug }) => {
         const token = await getToken();
         const milestones = await trackRequest(`/projects/${encodeURIComponent(project_slug)}/milestones`, { token });
         return {
             content: [{ type: 'text', text: toToolText(milestones) }],
         };
     });
-    server.tool('create_milestone', 'Create a milestone on a project. Due date is optional.', {
+    server.tool('create_milestone', 'Create a milestone on a project. Target date is optional.', {
         project_slug: z.string().min(1).describe('Project slug'),
         name: z.string().min(1).max(100),
-        description: z.string().max(2000).optional(),
-        due_at: z.string().optional().describe('ISO date.'),
-    }, async ({ project_slug, name, description, due_at }) => {
+        summary: z.string().max(2000).optional(),
+        target_date: z.iso.date().optional().describe('ISO date (YYYY-MM-DD).'),
+    }, async ({ project_slug, name, summary, target_date }) => {
         const token = await getToken();
         const milestone = await trackRequest(`/projects/${encodeURIComponent(project_slug)}/milestones`, {
             token,
             method: 'POST',
             body: {
                 name,
-                description: description ?? null,
-                due_at: due_at ?? null,
+                summary: summary ?? null,
+                target_date: target_date ?? null,
             },
         });
         return {
             content: [{ type: 'text', text: toToolText(milestone) }],
         };
     });
-    server.tool('update_milestone', 'Patch a milestone — rename, retitle description, shift due date, flip status.', {
+    server.tool('update_milestone', 'Patch a milestone — rename, edit summary, shift target date, flip status.', {
         milestone_id: z.string().min(1).describe('Milestone id'),
         name: z.string().min(1).max(100).optional(),
-        description: z.string().max(2000).nullable().optional(),
-        due_at: z.string().nullable().optional(),
-        status: z.enum(['open', 'completed', 'cancelled']).optional(),
+        summary: z.string().max(2000).nullable().optional(),
+        target_date: z.iso.date().nullable().optional(),
+        status: z.enum(['planned', 'in_progress', 'shipped', 'canceled']).optional(),
     }, async ({ milestone_id, ...patch }) => {
         const token = await getToken();
         const body = {};
@@ -60,7 +51,7 @@ export function registerMilestoneTools(server) {
     });
     server.tool('delete_milestone', 'Delete a milestone. Issues that were on it become un-milestoned.', {
         milestone_id: z.string().min(1).describe('Milestone id'),
-    }, async ({ milestone_id }) => {
+    }, { destructiveHint: true }, async ({ milestone_id }) => {
         const token = await getToken();
         await trackRequest(`/milestones/${encodeURIComponent(milestone_id)}`, {
             token,

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

@@ -1 +1 @@
-{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/tools/projects.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,SAAS,EAAc,MAAM,oBAAoB,CAAC;AAG1E,UAAU,OAAO;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAGxD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,QAqFrD"}
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/tools/projects.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,SAAS,EAAc,MAAM,oBAAoB,CAAC;AAG1E,UAAU,OAAO;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAGxD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,QAuFrD"}

package/dist/tools/projects.js

@@ -6,7 +6,7 @@ export async function fetchProjects() {
     return trackRequest('/projects', { token });
 }
 export function registerProjectTools(server) {
-    server.tool('list_track_projects', "List FerrTrack projects in the caller's active organization.", {}, async () => {
+    server.tool('list_track_projects', "List FerrTrack projects in the caller's active organization.", {}, { readOnlyHint: true }, async () => {
         const projects = await fetchProjects();
         return {
             content: [{ type: 'text', text: toToolText(projects) }],
@@ -14,7 +14,7 @@ export function registerProjectTools(server) {
     });
     server.tool('get_project', 'Get a FerrTrack project by slug.', {
         project_slug: z.string().min(1).describe('Project slug'),
-    }, async ({ project_slug }) => {
+    }, { readOnlyHint: true }, async ({ project_slug }) => {
         const token = await getToken();
         const project = await trackRequest(`/projects/${encodeURIComponent(project_slug)}`, {
             token,

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

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,SAAS,EAAc,MAAM,oBAAoB,CAAC;AAmB1E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,QAqCpD"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,SAAS,EAAc,MAAM,oBAAoB,CAAC;AAmB1E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,QAuCpD"}

package/dist/tools/search.js

@@ -11,7 +11,7 @@ export function registerSearchTools(server) {
             .max(100)
             .optional()
             .describe('Max hits to return (default 25).'),
-    }, async ({ q, limit }) => {
+    }, { readOnlyHint: true }, async ({ q, limit }) => {
         const token = await getToken();
         const params = new URLSearchParams({ q });
         if (limit !== undefined)
@@ -21,7 +21,7 @@ export function registerSearchTools(server) {
             content: [{ type: 'text', text: toToolText(hits) }],
         };
     });
-    server.tool('list_track_users', "List FerrTrack users in the caller's org — useful for resolving an `assignee_id` before calling create_issue or update_issue.", {}, async () => {
+    server.tool('list_track_users', "List FerrTrack users in the caller's org — useful for resolving an `assignee_id` before calling create_issue or update_issue.", {}, { readOnlyHint: true }, async () => {
         const token = await getToken();
         const users = await trackRequest('/users', { token });
         return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ferrtrack/mcp",
-  "version": "10.13.2",
+  "version": "10.13.3",
   "description": "Model Context Protocol server for FerrTrack: issues, labels, comments",
   "license": "MPL-2.0",
   "type": "module",