zephyr-enterprise-tools 1.2.1 → 1.2.3

package/README.md

@@ -73,50 +73,46 @@ Use zephyr-enterprise-tools as an MCP (Model Context Protocol) server with your
 | `search_test_cases` | Search test cases by query |
 | `user_activity` | Get user activity metrics |
 
-### VS Code with GitHub Copilot
+### Claude Desktop
 
-Create or edit `.vscode/mcp.json` in your workspace:
+Edit your `claude_desktop_config.json` file:
 
 ```json
 {
-  "servers": {
-    "zephyr-enterprise": {
-      "type": "stdio",
+  "mcpServers": {
+    "zephyr": {
       "command": "npx",
-      "args": ["-y", "zephyr-enterprise-tools@latest", "mcp"],
+      "args": [
+        "-y",
+        "--package",
+        "zephyr-enterprise-tools@latest",
+        "zephyr-mcp"
+      ],
       "env": {
-        "ZEPHYR_BASE_URL": "${input:zephyr_base_url}",
-        "ZEPHYR_TOKEN": "${input:zephyr_token}"
+        "ZEPHYR_BASE_URL": "https://your-zephyr.com/flex/services/rest/latest",
+        "ZEPHYR_TOKEN": "your-api-token"
       }
     }
-  },
-  "inputs": [
-    {
-      "id": "zephyr_base_url",
-      "type": "promptString",
-      "description": "Zephyr Enterprise API Base URL (e.g. https://your-zephyr.com/flex/services/rest/latest)",
-      "password": false
-    },
-    {
-      "id": "zephyr_token",
-      "type": "promptString",
-      "description": "Zephyr Enterprise API Token",
-      "password": true
-    }
-  ]
+  }
 }
 ```
 
-### Cursor
+### VS Code with GitHub Copilot
 
-Add to your `mcp.json` configuration:
+Create or edit `.vscode/mcp.json` in your workspace:
 
 ```json
 {
-  "mcpServers": {
-    "zephyr-enterprise": {
+  "servers": {
+    "zephyr": {
+      "type": "stdio",
       "command": "npx",
-      "args": ["-y", "zephyr-enterprise-tools@latest", "mcp"],
+      "args": [
+        "-y",
+        "--package",
+        "zephyr-enterprise-tools",
+        "zephyr-mcp"
+      ],
       "env": {
         "ZEPHYR_BASE_URL": "https://your-zephyr.com/flex/services/rest/latest",
         "ZEPHYR_TOKEN": "your-api-token"
@@ -126,9 +122,9 @@ Add to your `mcp.json` configuration:
 }
 ```
 
-### Claude Desktop
+### Cursor
 
-Edit your `claude_desktop_config.json` file:
+Add to your `mcp.json` configuration:
 
 ```json
 {

package/mcp-server.js

@@ -167,6 +167,23 @@ const TOOLS = [
       required: ['projectId', 'releaseId'],
     },
   },
+  {
+    name: 'user_trend',
+    description: 'Get full audit log activity for a user — every action they performed across the system. Filter by date range and optionally by entity type (project or release).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        userName:  { type: 'string', description: 'Username to look up (e.g. "dylan.garcia")' },
+        fromDate:  { type: 'string', description: 'Start date YYYY-MM-DD (e.g. "2026-08-01")' },
+        toDate:    { type: 'string', description: 'End date YYYY-MM-DD (e.g. "2026-08-18")' },
+        entity:    { type: 'string', description: 'Filter by entity type: "project", "release", or "" for all', enum: ['project', 'release', ''] },
+        operation: { type: 'string', description: 'Filter by operation (e.g. "CREATE", "UPDATE"). Omit for all.' },
+        offset:    { type: 'number', description: 'Pagination offset (default 0)' },
+        pageSize:  { type: 'number', description: 'Records per page (default 25)' },
+      },
+      required: ['userName'],
+    },
+  },
   {
     name: 'list_projects',
     description: 'List all available Zephyr projects.',
@@ -282,6 +299,18 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       case 'user_activity':
         result = await tools.getUserActivity(projectId, releaseId, { days: args.days || 30 });
         break;
+
+      case 'user_trend':
+        result = await tools.getUserTrend({
+          userName:  args.userName,
+          fromDate:  args.fromDate  || null,
+          toDate:    args.toDate    || null,
+          entity:    args.entity    || '',
+          operation: args.operation || null,
+          offset:    args.offset    || 0,
+          pageSize:  args.pageSize  || 25,
+        });
+        break;
         
       case 'list_projects':
         const projects = await tools.GET('/project');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zephyr-enterprise-tools",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "Comprehensive Zephyr Enterprise Tools - Release Readiness, Project Health, Test Analytics & More",
   "main": "zephyr-enterprise-tools.js",
   "types": "zephyr-enterprise-tools.d.ts",

package/zephyr-enterprise-tools.js

@@ -1285,6 +1285,99 @@ export class QualityGates {
       topExecutors: executors.slice(0, 5),
     };
   }
+
+  // ─── User Trend (Audit Logs) ─────────────────────────────────────────────────
+
+  async getUserTrend(options = {}) {
+    const {
+      userName = "",
+      fromDate = null,   // "YYYY-MM-DD"
+      toDate = null,     // "YYYY-MM-DD"
+      entity = "",       // "project", "release", or "" for all
+      operation = null,  // specific operation or null for all
+      offset = 0,
+      pageSize = 25,
+    } = options;
+
+    const v3BaseUrl = this.baseUrl.replace('/latest', '/v3');
+    const url = new URL(`${v3BaseUrl}/ui/auditLogs`);
+    url.searchParams.set("offset", String(offset));
+    url.searchParams.set("pagesize", String(pageSize));
+    url.searchParams.set("isascorder", "false");
+    url.searchParams.set("order", "id");
+    url.searchParams.set("isExport", "false");
+
+    const body = { entity, operation, userName };
+
+    if (fromDate) {
+      body.fromDate = fromDate;
+      body.fromDateVal = `${fromDate}T00:00:00.000Z`;
+    }
+    if (toDate) {
+      body.toDate = toDate;
+      body.toDateVal = `${toDate}T00:00:00.000Z`;
+    }
+
+    const res = await fetch(url.toString(), {
+      method: "POST",
+      headers: {
+        Accept: "application/json",
+        "Content-Type": "application/json",
+        ...this.authHeader(),
+      },
+      body: JSON.stringify(body),
+    });
+
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      throw new Error(`Zephyr audit logs API ${res.status}: ${text}`);
+    }
+
+    const data = await res.json();
+    const logs = data.results || data || [];
+
+    // Summarise by operation and entity type
+    const byOperation = {};
+    const byEntity = {};
+    for (const log of logs) {
+      const op  = log.operation || "Unknown";
+      const ent = log.entity    || "Unknown";
+      byOperation[op]  = (byOperation[op]  || 0) + 1;
+      byEntity[ent]    = (byEntity[ent]    || 0) + 1;
+    }
+
+    return {
+      tool: "User Trend",
+      userName,
+      dateRange: { from: fromDate || "all", to: toDate || "all" },
+      entity: entity || "all",
+      timestamp: new Date().toISOString(),
+      totalRecords: data.totalCount ?? logs.length,
+      offset,
+      pageSize,
+      operationSummary: Object.entries(byOperation)
+        .map(([operation, count]) => ({ operation, count }))
+        .sort((a, b) => b.count - a.count),
+      entitySummary: Object.entries(byEntity)
+        .map(([entity, count]) => ({ entity, count }))
+        .sort((a, b) => b.count - a.count),
+      auditLogs: logs.map(log => ({
+        id:          log.id,
+        userName:    log.userName,
+        entity:      log.entity,
+        entityName:  log.entityName,
+        operation:   log.operation,
+        description: log.description,
+        detail:      log.detail,
+        projectId:   log.projectId,
+        projectName: log.projectName,
+        releaseId:   log.releaseId,
+        releaseName: log.releaseName,
+        createdOn:   log.createdOn,
+        ipAddress:   log.ipAddress,
+      })),
+    };
+  }
 }
 
 // Export with both names for backward compatibility