zephyr-enterprise-tools 1.2.2 → 1.2.4

package/README.md

@@ -25,6 +25,7 @@ Comprehensive tools for Zephyr Enterprise - Release Readiness, Project Health, T
 | `test-trends` | Test execution trends over time |
 | `search-tests` | Search test cases by query |
 | `user-activity` | User activity and productivity metrics |
+| `execution-burndown` | Day-by-day execution burndown (remaining vs ideal) |
 
 ---
 
@@ -72,51 +73,48 @@ Use zephyr-enterprise-tools as an MCP (Model Context Protocol) server with your
 | `test_trends` | Get execution trends over time |
 | `search_test_cases` | Search test cases by query |
 | `user_activity` | Get user activity metrics |
+| `execution_burndown` | Day-by-day execution burndown chart data (remaining vs ideal) |
 
-### 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 +124,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,20 @@ const TOOLS = [
       required: ['projectId', 'releaseId'],
     },
   },
+  {
+    name: 'execution_burndown',
+    description: 'Generate a day-by-day execution burndown chart for a release. Returns daily remaining vs ideal counts so an AI or chart tool can visualise test execution progress over time.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        projectId: { type: 'number', description: 'Zephyr project ID' },
+        releaseId: { type: 'number', description: 'Zephyr release ID' },
+        startDate: { type: 'string', description: 'Burndown start date YYYY-MM-DD (default: earliest execution date)' },
+        endDate:   { type: 'string', description: 'Burndown end date YYYY-MM-DD (default: today)' },
+      },
+      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).',
@@ -300,6 +314,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         result = await tools.getUserActivity(projectId, releaseId, { days: args.days || 30 });
         break;
 
+      case 'execution_burndown':
+        result = await tools.getExecutionBurndown(projectId, releaseId, {
+          startDate: args.startDate || null,
+          endDate:   args.endDate   || null,
+        });
+        break;
+
       case 'user_trend':
         result = await tools.getUserTrend({
           userName:  args.userName,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zephyr-enterprise-tools",
-  "version": "1.2.2",
+  "version": "1.2.4",
   "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

@@ -1286,6 +1286,111 @@ export class QualityGates {
     };
   }
 
+  // ─── Execution Burndown Chart ────────────────────────────────────────────────
+
+  async getExecutionBurndown(projectId, releaseId, options = {}) {
+    const { startDate = null, endDate = null } = options;
+
+    // Fetch all executions for the release
+    const executionData = await this.GET('/execution', {
+      projectId,
+      releaseId,
+      maxResults: 10000,
+    });
+    const executions = executionData.results || executionData || [];
+    const total = executions.length;
+
+    if (total === 0) {
+      return {
+        tool: 'Execution Burndown',
+        projectId,
+        releaseId,
+        timestamp: new Date().toISOString(),
+        total: 0,
+        message: 'No executions found for this release.',
+        dailyBurndown: [],
+      };
+    }
+
+    // Determine date range
+    const allDates = executions
+      .map(e => e.lastModifiedOn || e.createDatetime)
+      .filter(Boolean)
+      .map(d => new Date(d).toISOString().split('T')[0]);
+
+    const rangeStart = startDate || allDates.reduce((a, b) => (a < b ? a : b));
+    const rangeEnd   = endDate   || new Date().toISOString().split('T')[0];
+
+    // Build a map of date → how many tests were executed (status changed from unexecuted) on that day
+    const executedByDate = {};
+    for (const exec of executions) {
+      const rawDate = exec.lastModifiedOn || exec.createDatetime;
+      if (!rawDate) continue;
+      const dateKey = new Date(rawDate).toISOString().split('T')[0];
+      if (dateKey < rangeStart || dateKey > rangeEnd) continue;
+      const status = String(exec.lastTestResult?.executionStatus || exec.status || exec.executionStatus || '0');
+      // Count as "executed" if not unexecuted (status 0)
+      if (status !== '0') {
+        executedByDate[dateKey] = (executedByDate[dateKey] || 0) + 1;
+      }
+    }
+
+    // Build daily burndown series — remaining = total unexecuted tests at end of each day
+    const days = [];
+    let current = new Date(rangeStart);
+    const end = new Date(rangeEnd);
+    let cumulativeExecuted = 0;
+
+    while (current <= end) {
+      const dateKey = current.toISOString().split('T')[0];
+      const executedToday = executedByDate[dateKey] || 0;
+      cumulativeExecuted += executedToday;
+      const remaining = Math.max(0, total - cumulativeExecuted);
+
+      days.push({
+        date: dateKey,
+        executedToday,
+        cumulativeExecuted,
+        remaining,
+        completionPct: Math.round((cumulativeExecuted / total) * 100),
+      });
+
+      current.setDate(current.getDate() + 1);
+    }
+
+    // Ideal burndown line (linear from total → 0)
+    const totalDays = days.length;
+    const idealDailyBurn = totalDays > 1 ? total / (totalDays - 1) : total;
+    const dailyBurndown = days.map((day, i) => ({
+      ...day,
+      ideal: Math.max(0, Math.round(total - idealDailyBurn * i)),
+    }));
+
+    const lastDay = dailyBurndown[dailyBurndown.length - 1];
+    const behindBy = lastDay.remaining - lastDay.ideal;
+
+    return {
+      tool: 'Execution Burndown',
+      projectId,
+      releaseId,
+      timestamp: new Date().toISOString(),
+      dateRange: { from: rangeStart, to: rangeEnd },
+      total,
+      summary: {
+        totalExecutions: total,
+        executed: lastDay.cumulativeExecuted,
+        remaining: lastDay.remaining,
+        completionPct: lastDay.completionPct,
+        status: behindBy > 0
+          ? `⚠️ Behind ideal by ${behindBy} tests`
+          : behindBy < 0
+            ? `✅ Ahead of schedule by ${Math.abs(behindBy)} tests`
+            : '✅ On track',
+      },
+      dailyBurndown,
+    };
+  }
+
   // ─── User Trend (Audit Logs) ─────────────────────────────────────────────────
 
   async getUserTrend(options = {}) {