backlog-mcp-server 0.8.1 → 0.9.0

package/build/tools/deleteDocument.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import { DocumentItemSchema } from '../types/zod/backlogOutputDefinition.js';
+import { buildToolSchema } from '../types/tool.js';
+const deleteDocumentSchema = buildToolSchema((t) => ({
+    documentId: z
+        .string()
+        .describe(t('TOOL_DELETE_DOCUMENT_DOCUMENT_ID', 'Document ID')),
+}));
+export const deleteDocumentTool = (backlog, { t }) => {
+    return {
+        name: 'delete_document',
+        description: t('TOOL_DELETE_DOCUMENT_DESCRIPTION', 'Permanently deletes a document. This is irreversible (hard delete) and the document cannot be recovered. Unlike the Backlog UI trash feature, this operation does not move the document to trash.'),
+        schema: z.object(deleteDocumentSchema(t)),
+        outputSchema: DocumentItemSchema,
+        handler: async ({ documentId }) => {
+            return backlog.deleteDocument(documentId);
+        },
+    };
+};

package/build/tools/getUserRecentUpdates.js

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import { buildToolSchema } from '../types/tool.js';
+import { ActivitySchema, ActivityTypeSchema, } from '../types/zod/backlogOutputDefinition.js';
+const getUserRecentUpdatesSchema = buildToolSchema((t) => ({
+    userId: z
+        .number()
+        .describe(t('TOOL_GET_USER_RECENT_UPDATES_USER_ID', 'ID of the user to retrieve activities for')),
+    activityTypeId: z
+        .array(ActivityTypeSchema)
+        .optional()
+        .describe(t('TOOL_GET_USER_RECENT_UPDATES_ACTIVITY_TYPE_ID', 'Activity type IDs to filter by')),
+    minId: z
+        .number()
+        .optional()
+        .describe(t('TOOL_GET_USER_RECENT_UPDATES_MIN_ID', 'Minimum activity ID')),
+    maxId: z
+        .number()
+        .optional()
+        .describe(t('TOOL_GET_USER_RECENT_UPDATES_MAX_ID', 'Maximum activity ID')),
+    count: z
+        .number()
+        .min(1)
+        .max(100)
+        .default(20)
+        .optional()
+        .describe(t('TOOL_GET_USER_RECENT_UPDATES_COUNT', 'Number of activities to retrieve (1-100, default: 20)')),
+    order: z
+        .enum(['asc', 'desc'])
+        .default('desc')
+        .optional()
+        .describe(t('TOOL_GET_USER_RECENT_UPDATES_ORDER', 'Sort order ("asc" or "desc", default: "desc")')),
+}));
+export const getUserRecentUpdatesTool = (backlog, { t }) => {
+    return {
+        name: 'get_user_recent_updates',
+        description: t('TOOL_GET_USER_RECENT_UPDATES_DESCRIPTION', 'Returns recent updates (activities) for a specific user'),
+        schema: z.object(getUserRecentUpdatesSchema(t)),
+        outputSchema: ActivitySchema,
+        importantFields: ['id', 'type', 'content', 'created'],
+        handler: async ({ userId, activityTypeId, minId, maxId, count, order }) => backlog.getUserActivities(userId, {
+            activityTypeId,
+            minId,
+            maxId,
+            count,
+            order,
+        }),
+    };
+};

package/build/tools/getUserStarsCount.js

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import { buildToolSchema } from '../types/tool.js';
+import { StarCountSchema } from '../types/zod/backlogOutputDefinition.js';
+const getUserStarsCountSchema = buildToolSchema((t) => ({
+    userId: z
+        .number()
+        .describe(t('TOOL_GET_USER_STARS_COUNT_USER_ID', 'User ID')),
+    since: z
+        .string()
+        .optional()
+        .describe(t('TOOL_GET_USER_STARS_COUNT_SINCE', 'Count stars received after this date (yyyy-MM-dd)')),
+    until: z
+        .string()
+        .optional()
+        .describe(t('TOOL_GET_USER_STARS_COUNT_UNTIL', 'Count stars received before this date (yyyy-MM-dd)')),
+}));
+export const getUserStarsCountTool = (backlog, { t }) => {
+    return {
+        name: 'get_user_stars_count',
+        description: t('TOOL_GET_USER_STARS_COUNT_DESCRIPTION', 'Returns the count of stars received by a user'),
+        schema: z.object(getUserStarsCountSchema(t)),
+        outputSchema: StarCountSchema,
+        handler: async ({ userId, since, until }) => backlog.getUserStarsCount(userId, { since, until }),
+    };
+};

package/build/tools/tools.js

@@ -29,7 +29,9 @@ import { getPullRequestsCountTool } from './getPullRequestsCount.js';
 import { getResolutionsTool } from './getResolutions.js';
 import { getSpaceTool } from './getSpace.js';
 import { getSpaceActivitiesTool } from './getSpaceActivities.js';
+import { getUserStarsCountTool } from './getUserStarsCount.js';
 import { getUsersTool } from './getUsers.js';
+import { getUserRecentUpdatesTool } from './getUserRecentUpdates.js';
 import { getWatchingListCountTool } from './getWatchingListCount.js';
 import { getWatchingListItemsTool } from './getWatchingListItems.js';
 import { addWatchingTool } from './addWatching.js';
@@ -53,6 +55,7 @@ import { addVersionMilestoneTool } from './addVersionMilestone.js';
 import { updateVersionMilestoneTool } from './updateVersionMilestone.js';
 import { deleteVersionTool } from './deleteVersion.js';
 import { addDocumentTool } from './addDocument.js';
+import { deleteDocumentTool } from './deleteDocument.js';
 export const allTools = (backlog, helper) => {
     return {
         toolsets: [
@@ -64,7 +67,9 @@ export const allTools = (backlog, helper) => {
                     getSpaceTool(backlog, helper),
                     getSpaceActivitiesTool(backlog, helper),
                     getUsersTool(backlog, helper),
+                    getUserStarsCountTool(backlog, helper),
                     getMyselfTool(backlog, helper),
+                    getUserRecentUpdatesTool(backlog, helper),
                 ],
             },
             {
@@ -147,6 +152,7 @@ export const allTools = (backlog, helper) => {
                     getDocumentTreeTool(backlog, helper),
                     getDocumentTool(backlog, helper),
                     addDocumentTool(backlog, helper),
+                    deleteDocumentTool(backlog, helper),
                 ],
             },
             {

package/build/types/zod/backlogOutputDefinition.js

@@ -402,6 +402,9 @@ export const SpaceSchema = z.object({
 export const WatchingListCountSchema = z.object({
     count: z.number(),
 });
+export const StarCountSchema = z.object({
+    count: z.number(),
+});
 export const WikiListItemSchema = z.object({
     id: z.number(),
     projectId: z.number(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backlog-mcp-server",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "type": "module",
   "bin": {
     "backlog-mcp-server": "./build/index.js"