@letpeoplework/lighthouse-mcp-core 1.6.0 → 1.7.1

package/dist/index.cjs

@@ -25,6 +25,7 @@ __export(index_exports, {
   registerMcpTools: () => registerMcpTools
 });
 module.exports = __toCommonJS(index_exports);
+var import_lighthouse_client = require("@letpeoplework/lighthouse-client");
 var import_toon = require("@toon-format/toon");
 var import_zod = require("zod");
 var getMcpCorePackageContract = () => ({
@@ -279,7 +280,7 @@ var toolDefinitions = [
   },
   {
     name: "lighthouse_team_metrics_percentilesOverTime",
-    description: "Get the percentiles-over-time trend for a team by ID: the p50/p70/p85/p95 quartet recorded on each captured day, optionally filtered by start and end dates. Recording is forward-only \u2014 Lighthouse never backfills days it did not observe, so a recently upgraded server returns an empty series until it has recorded some. Use metricType to pick the family and horizon to pick the cycle-time window.",
+    description: "Get the percentiles-over-time trend for a team by ID: the p50/p70/p85/p95 quartet recorded on each captured day, optionally filtered by start and end dates. By default Lighthouse only returns days it recorded, so a recently upgraded server returns an empty series until it has recorded some; where a System Admin has switched on filling in past days (a Preview), the read starts filling missing days in the background and a later call may return more. Use metricType to pick the family and horizon to pick the cycle-time window.",
     inputSchema: {
       type: "object",
       properties: {
@@ -293,7 +294,7 @@ var toolDefinitions = [
   },
   {
     name: "lighthouse_portfolio_metrics_percentilesOverTime",
-    description: "Get the percentiles-over-time trend for a portfolio by ID: the p50/p70/p85/p95 quartet recorded on each captured day, optionally filtered by start and end dates. Recording is forward-only \u2014 Lighthouse never backfills days it did not observe, so a recently upgraded server returns an empty series until it has recorded some. Use metricType to pick the family and horizon to pick the cycle-time window.",
+    description: "Get the percentiles-over-time trend for a portfolio by ID: the p50/p70/p85/p95 quartet recorded on each captured day, optionally filtered by start and end dates. By default Lighthouse only returns days it recorded, so a recently upgraded server returns an empty series until it has recorded some; where a System Admin has switched on filling in past days (a Preview), the read starts filling missing days in the background and a later call may return more. Use metricType to pick the family and horizon to pick the cycle-time window.",
     inputSchema: {
       type: "object",
       properties: {
@@ -307,7 +308,7 @@ var toolDefinitions = [
   },
   {
     name: "lighthouse_team_metrics_processBehaviorOverTime",
-    description: "Get the process-behaviour-limits-over-time trend for a team by ID: the upper limit, average and lower limit (UNPL/Average/LNPL) recorded on each captured day, optionally filtered by start and end dates. Recording is forward-only, and days without a usable baseline are absent rather than zeroed \u2014 an empty series means nothing was recorded, never a process pinned at zero.",
+    description: "Get the process-behaviour-limits-over-time trend for a team by ID: the upper limit, average and lower limit (UNPL/Average/LNPL) recorded on each captured day, optionally filtered by start and end dates. Days are recorded on refresh (and, where a System Admin has switched on filling in past days, filled in the background after a read), and days without a usable baseline are absent rather than zeroed \u2014 an empty series means nothing was recorded, never a process pinned at zero.",
     inputSchema: {
       type: "object",
       properties: {
@@ -321,7 +322,7 @@ var toolDefinitions = [
   },
   {
     name: "lighthouse_portfolio_metrics_processBehaviorOverTime",
-    description: "Get the process-behaviour-limits-over-time trend for a portfolio by ID: the upper limit, average and lower limit (UNPL/Average/LNPL) recorded on each captured day, optionally filtered by start and end dates. Recording is forward-only, and days without a usable baseline are absent rather than zeroed \u2014 an empty series means nothing was recorded, never a process pinned at zero. FeatureSize is available here and not on teams.",
+    description: "Get the process-behaviour-limits-over-time trend for a portfolio by ID: the upper limit, average and lower limit (UNPL/Average/LNPL) recorded on each captured day, optionally filtered by start and end dates. Days are recorded on refresh (and, where a System Admin has switched on filling in past days, filled in the background after a read), and days without a usable baseline are absent rather than zeroed \u2014 an empty series means nothing was recorded, never a process pinned at zero. FeatureSize is available here and not on teams.",
     inputSchema: {
       type: "object",
       properties: {
@@ -432,6 +433,23 @@ var toolDefinitions = [
     description: "List deliveries for a portfolio by portfolio ID.",
     inputSchema: idInputSchema
   },
+  {
+    name: "lighthouse_delivery_metrics",
+    description: `Get a delivery's recorded trend by delivery ID: one row per day with total, done and remaining work, the epic count and the likelihood. Set detail to "epics" for the per-epic breakdown and the forecast distribution, which are far larger. Forward-only, so it starts at the first recorded snapshot. Requires Lighthouse newer than v26.5.29.5.`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "number", description: "Delivery ID." },
+        detail: {
+          type: "string",
+          enum: ["epics"],
+          description: 'Omit for one row per day. "epics" returns the whole recorded payload.'
+        }
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
   {
     name: "lighthouse_blackout_list",
     description: "List the recurring blackout rules (recurring non-working days excluded from forecasts). Requires Lighthouse newer than v26.5.29.5.",
@@ -889,6 +907,10 @@ var toolInputSchemas = {
   }),
   lighthouse_feature_workitems: import_zod.z.object({ id: import_zod.z.number().int() }),
   lighthouse_delivery_list: import_zod.z.object({ id: import_zod.z.number().int() }),
+  lighthouse_delivery_metrics: import_zod.z.object({
+    id: import_zod.z.number().int(),
+    detail: import_zod.z.literal("epics").optional()
+  }),
   lighthouse_blackout_list: import_zod.z.object({}),
   lighthouse_blackout_create: recurringBlackoutRuleInputSchema,
   lighthouse_blackout_update: recurringBlackoutRuleInputSchema.extend({
@@ -1489,6 +1511,25 @@ var createMcpCoreRuntime = (dependencies) => ({
         `delivery: ${result.error.category} (${result.error.reason})`
       );
     }
+    if (name === "lighthouse_delivery_metrics") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult(
+          "delivery metrics: invalid id (delivery id required)"
+        );
+      }
+      const wantsEpics = argumentsPayload?.detail === "epics";
+      const result = await client.getDeliveryMetricsHistory(id);
+      if (!result.ok) {
+        return getErrorToolResult(
+          `delivery metrics: ${result.error.category} (${result.error.reason})`
+        );
+      }
+      const payload = wantsEpics ? result.value : (0, import_lighthouse_client.summariseDeliveryMetricsHistory)(result.value);
+      return getSuccessToolResult(
+        `delivery metrics: ${encodePayload(payload)}`
+      );
+    }
     if (name === "lighthouse_blackout_list") {
       const result = await client.getRecurringBlackoutRules();
       if (result.ok) {

package/dist/index.d.cts

@@ -1,3 +1,4 @@
+import { DeliveryMetricsHistory } from '@letpeoplework/lighthouse-client';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 
 type McpCorePackageContract = {
@@ -15,7 +16,7 @@ type McpToolResult = {
     readonly content: readonly McpToolContent[];
 };
 type McpToolDefinition = {
-    readonly name: "lighthouse_health_check" | "lighthouse_version_get" | "lighthouse_worktracking_list" | "lighthouse_worktracking_get" | "lighthouse_team_list" | "lighthouse_team_get" | "lighthouse_team_refresh" | "lighthouse_portfolio_list" | "lighthouse_portfolio_get" | "lighthouse_portfolio_refresh" | "lighthouse_team_metrics_throughput" | "lighthouse_team_metrics_cycleTimePercentiles" | "lighthouse_team_metrics_workItemAgePercentiles" | "lighthouse_portfolio_metrics_workItemAgePercentiles" | "lighthouse_team_metrics_workItemAge" | "lighthouse_team_metrics_totalWorkItemAge" | "lighthouse_portfolio_metrics_throughput" | "lighthouse_portfolio_metrics_workItemAge" | "lighthouse_portfolio_metrics_totalWorkItemAge" | "lighthouse_team_metrics_blockedCountHistory" | "lighthouse_portfolio_metrics_blockedCountHistory" | "lighthouse_team_metrics_percentilesOverTime" | "lighthouse_portfolio_metrics_percentilesOverTime" | "lighthouse_team_metrics_processBehaviorOverTime" | "lighthouse_portfolio_metrics_processBehaviorOverTime" | "lighthouse_team_metrics_cumulativeStateTime" | "lighthouse_team_metrics_cumulativeStateTimeItems" | "lighthouse_team_metrics_cumulativeStateTimeCandidates" | "lighthouse_portfolio_metrics_cumulativeStateTime" | "lighthouse_portfolio_metrics_cumulativeStateTimeItems" | "lighthouse_portfolio_metrics_cumulativeStateTimeCandidates" | "lighthouse_feature_get" | "lighthouse_feature_workitems" | "lighthouse_delivery_list" | "lighthouse_blackout_list" | "lighthouse_blackout_create" | "lighthouse_blackout_update" | "lighthouse_blackout_delete" | "lighthouse_forecast_manual" | "lighthouse_forecast_backtest";
+    readonly name: "lighthouse_health_check" | "lighthouse_version_get" | "lighthouse_worktracking_list" | "lighthouse_worktracking_get" | "lighthouse_team_list" | "lighthouse_team_get" | "lighthouse_team_refresh" | "lighthouse_portfolio_list" | "lighthouse_portfolio_get" | "lighthouse_portfolio_refresh" | "lighthouse_team_metrics_throughput" | "lighthouse_team_metrics_cycleTimePercentiles" | "lighthouse_team_metrics_workItemAgePercentiles" | "lighthouse_portfolio_metrics_workItemAgePercentiles" | "lighthouse_team_metrics_workItemAge" | "lighthouse_team_metrics_totalWorkItemAge" | "lighthouse_portfolio_metrics_throughput" | "lighthouse_portfolio_metrics_workItemAge" | "lighthouse_portfolio_metrics_totalWorkItemAge" | "lighthouse_team_metrics_blockedCountHistory" | "lighthouse_portfolio_metrics_blockedCountHistory" | "lighthouse_team_metrics_percentilesOverTime" | "lighthouse_portfolio_metrics_percentilesOverTime" | "lighthouse_team_metrics_processBehaviorOverTime" | "lighthouse_portfolio_metrics_processBehaviorOverTime" | "lighthouse_team_metrics_cumulativeStateTime" | "lighthouse_team_metrics_cumulativeStateTimeItems" | "lighthouse_team_metrics_cumulativeStateTimeCandidates" | "lighthouse_portfolio_metrics_cumulativeStateTime" | "lighthouse_portfolio_metrics_cumulativeStateTimeItems" | "lighthouse_portfolio_metrics_cumulativeStateTimeCandidates" | "lighthouse_feature_get" | "lighthouse_feature_workitems" | "lighthouse_delivery_list" | "lighthouse_delivery_metrics" | "lighthouse_blackout_list" | "lighthouse_blackout_create" | "lighthouse_blackout_update" | "lighthouse_blackout_delete" | "lighthouse_forecast_manual" | "lighthouse_forecast_backtest";
     readonly description: string;
     readonly inputSchema: {
         readonly type: "object";
@@ -432,6 +433,16 @@ type McpRuntimeClient = {
             readonly reason: string;
         };
     }>;
+    readonly getDeliveryMetricsHistory: (deliveryId: number) => Promise<{
+        readonly ok: true;
+        readonly value: DeliveryMetricsHistory;
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
     readonly createDelivery: (portfolioId: number, payload: Readonly<Record<string, unknown>>) => Promise<{
         readonly ok: true;
         readonly value: unknown;

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { DeliveryMetricsHistory } from '@letpeoplework/lighthouse-client';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 
 type McpCorePackageContract = {
@@ -15,7 +16,7 @@ type McpToolResult = {
     readonly content: readonly McpToolContent[];
 };
 type McpToolDefinition = {
-    readonly name: "lighthouse_health_check" | "lighthouse_version_get" | "lighthouse_worktracking_list" | "lighthouse_worktracking_get" | "lighthouse_team_list" | "lighthouse_team_get" | "lighthouse_team_refresh" | "lighthouse_portfolio_list" | "lighthouse_portfolio_get" | "lighthouse_portfolio_refresh" | "lighthouse_team_metrics_throughput" | "lighthouse_team_metrics_cycleTimePercentiles" | "lighthouse_team_metrics_workItemAgePercentiles" | "lighthouse_portfolio_metrics_workItemAgePercentiles" | "lighthouse_team_metrics_workItemAge" | "lighthouse_team_metrics_totalWorkItemAge" | "lighthouse_portfolio_metrics_throughput" | "lighthouse_portfolio_metrics_workItemAge" | "lighthouse_portfolio_metrics_totalWorkItemAge" | "lighthouse_team_metrics_blockedCountHistory" | "lighthouse_portfolio_metrics_blockedCountHistory" | "lighthouse_team_metrics_percentilesOverTime" | "lighthouse_portfolio_metrics_percentilesOverTime" | "lighthouse_team_metrics_processBehaviorOverTime" | "lighthouse_portfolio_metrics_processBehaviorOverTime" | "lighthouse_team_metrics_cumulativeStateTime" | "lighthouse_team_metrics_cumulativeStateTimeItems" | "lighthouse_team_metrics_cumulativeStateTimeCandidates" | "lighthouse_portfolio_metrics_cumulativeStateTime" | "lighthouse_portfolio_metrics_cumulativeStateTimeItems" | "lighthouse_portfolio_metrics_cumulativeStateTimeCandidates" | "lighthouse_feature_get" | "lighthouse_feature_workitems" | "lighthouse_delivery_list" | "lighthouse_blackout_list" | "lighthouse_blackout_create" | "lighthouse_blackout_update" | "lighthouse_blackout_delete" | "lighthouse_forecast_manual" | "lighthouse_forecast_backtest";
+    readonly name: "lighthouse_health_check" | "lighthouse_version_get" | "lighthouse_worktracking_list" | "lighthouse_worktracking_get" | "lighthouse_team_list" | "lighthouse_team_get" | "lighthouse_team_refresh" | "lighthouse_portfolio_list" | "lighthouse_portfolio_get" | "lighthouse_portfolio_refresh" | "lighthouse_team_metrics_throughput" | "lighthouse_team_metrics_cycleTimePercentiles" | "lighthouse_team_metrics_workItemAgePercentiles" | "lighthouse_portfolio_metrics_workItemAgePercentiles" | "lighthouse_team_metrics_workItemAge" | "lighthouse_team_metrics_totalWorkItemAge" | "lighthouse_portfolio_metrics_throughput" | "lighthouse_portfolio_metrics_workItemAge" | "lighthouse_portfolio_metrics_totalWorkItemAge" | "lighthouse_team_metrics_blockedCountHistory" | "lighthouse_portfolio_metrics_blockedCountHistory" | "lighthouse_team_metrics_percentilesOverTime" | "lighthouse_portfolio_metrics_percentilesOverTime" | "lighthouse_team_metrics_processBehaviorOverTime" | "lighthouse_portfolio_metrics_processBehaviorOverTime" | "lighthouse_team_metrics_cumulativeStateTime" | "lighthouse_team_metrics_cumulativeStateTimeItems" | "lighthouse_team_metrics_cumulativeStateTimeCandidates" | "lighthouse_portfolio_metrics_cumulativeStateTime" | "lighthouse_portfolio_metrics_cumulativeStateTimeItems" | "lighthouse_portfolio_metrics_cumulativeStateTimeCandidates" | "lighthouse_feature_get" | "lighthouse_feature_workitems" | "lighthouse_delivery_list" | "lighthouse_delivery_metrics" | "lighthouse_blackout_list" | "lighthouse_blackout_create" | "lighthouse_blackout_update" | "lighthouse_blackout_delete" | "lighthouse_forecast_manual" | "lighthouse_forecast_backtest";
     readonly description: string;
     readonly inputSchema: {
         readonly type: "object";
@@ -432,6 +433,16 @@ type McpRuntimeClient = {
             readonly reason: string;
         };
     }>;
+    readonly getDeliveryMetricsHistory: (deliveryId: number) => Promise<{
+        readonly ok: true;
+        readonly value: DeliveryMetricsHistory;
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
     readonly createDelivery: (portfolioId: number, payload: Readonly<Record<string, unknown>>) => Promise<{
         readonly ok: true;
         readonly value: unknown;

package/dist/index.js

@@ -1,4 +1,7 @@
 // src/index.ts
+import {
+  summariseDeliveryMetricsHistory
+} from "@letpeoplework/lighthouse-client";
 import { encode } from "@toon-format/toon";
 import { z } from "zod";
 var getMcpCorePackageContract = () => ({
@@ -253,7 +256,7 @@ var toolDefinitions = [
   },
   {
     name: "lighthouse_team_metrics_percentilesOverTime",
-    description: "Get the percentiles-over-time trend for a team by ID: the p50/p70/p85/p95 quartet recorded on each captured day, optionally filtered by start and end dates. Recording is forward-only \u2014 Lighthouse never backfills days it did not observe, so a recently upgraded server returns an empty series until it has recorded some. Use metricType to pick the family and horizon to pick the cycle-time window.",
+    description: "Get the percentiles-over-time trend for a team by ID: the p50/p70/p85/p95 quartet recorded on each captured day, optionally filtered by start and end dates. By default Lighthouse only returns days it recorded, so a recently upgraded server returns an empty series until it has recorded some; where a System Admin has switched on filling in past days (a Preview), the read starts filling missing days in the background and a later call may return more. Use metricType to pick the family and horizon to pick the cycle-time window.",
     inputSchema: {
       type: "object",
       properties: {
@@ -267,7 +270,7 @@ var toolDefinitions = [
   },
   {
     name: "lighthouse_portfolio_metrics_percentilesOverTime",
-    description: "Get the percentiles-over-time trend for a portfolio by ID: the p50/p70/p85/p95 quartet recorded on each captured day, optionally filtered by start and end dates. Recording is forward-only \u2014 Lighthouse never backfills days it did not observe, so a recently upgraded server returns an empty series until it has recorded some. Use metricType to pick the family and horizon to pick the cycle-time window.",
+    description: "Get the percentiles-over-time trend for a portfolio by ID: the p50/p70/p85/p95 quartet recorded on each captured day, optionally filtered by start and end dates. By default Lighthouse only returns days it recorded, so a recently upgraded server returns an empty series until it has recorded some; where a System Admin has switched on filling in past days (a Preview), the read starts filling missing days in the background and a later call may return more. Use metricType to pick the family and horizon to pick the cycle-time window.",
     inputSchema: {
       type: "object",
       properties: {
@@ -281,7 +284,7 @@ var toolDefinitions = [
   },
   {
     name: "lighthouse_team_metrics_processBehaviorOverTime",
-    description: "Get the process-behaviour-limits-over-time trend for a team by ID: the upper limit, average and lower limit (UNPL/Average/LNPL) recorded on each captured day, optionally filtered by start and end dates. Recording is forward-only, and days without a usable baseline are absent rather than zeroed \u2014 an empty series means nothing was recorded, never a process pinned at zero.",
+    description: "Get the process-behaviour-limits-over-time trend for a team by ID: the upper limit, average and lower limit (UNPL/Average/LNPL) recorded on each captured day, optionally filtered by start and end dates. Days are recorded on refresh (and, where a System Admin has switched on filling in past days, filled in the background after a read), and days without a usable baseline are absent rather than zeroed \u2014 an empty series means nothing was recorded, never a process pinned at zero.",
     inputSchema: {
       type: "object",
       properties: {
@@ -295,7 +298,7 @@ var toolDefinitions = [
   },
   {
     name: "lighthouse_portfolio_metrics_processBehaviorOverTime",
-    description: "Get the process-behaviour-limits-over-time trend for a portfolio by ID: the upper limit, average and lower limit (UNPL/Average/LNPL) recorded on each captured day, optionally filtered by start and end dates. Recording is forward-only, and days without a usable baseline are absent rather than zeroed \u2014 an empty series means nothing was recorded, never a process pinned at zero. FeatureSize is available here and not on teams.",
+    description: "Get the process-behaviour-limits-over-time trend for a portfolio by ID: the upper limit, average and lower limit (UNPL/Average/LNPL) recorded on each captured day, optionally filtered by start and end dates. Days are recorded on refresh (and, where a System Admin has switched on filling in past days, filled in the background after a read), and days without a usable baseline are absent rather than zeroed \u2014 an empty series means nothing was recorded, never a process pinned at zero. FeatureSize is available here and not on teams.",
     inputSchema: {
       type: "object",
       properties: {
@@ -406,6 +409,23 @@ var toolDefinitions = [
     description: "List deliveries for a portfolio by portfolio ID.",
     inputSchema: idInputSchema
   },
+  {
+    name: "lighthouse_delivery_metrics",
+    description: `Get a delivery's recorded trend by delivery ID: one row per day with total, done and remaining work, the epic count and the likelihood. Set detail to "epics" for the per-epic breakdown and the forecast distribution, which are far larger. Forward-only, so it starts at the first recorded snapshot. Requires Lighthouse newer than v26.5.29.5.`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "number", description: "Delivery ID." },
+        detail: {
+          type: "string",
+          enum: ["epics"],
+          description: 'Omit for one row per day. "epics" returns the whole recorded payload.'
+        }
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
   {
     name: "lighthouse_blackout_list",
     description: "List the recurring blackout rules (recurring non-working days excluded from forecasts). Requires Lighthouse newer than v26.5.29.5.",
@@ -863,6 +883,10 @@ var toolInputSchemas = {
   }),
   lighthouse_feature_workitems: z.object({ id: z.number().int() }),
   lighthouse_delivery_list: z.object({ id: z.number().int() }),
+  lighthouse_delivery_metrics: z.object({
+    id: z.number().int(),
+    detail: z.literal("epics").optional()
+  }),
   lighthouse_blackout_list: z.object({}),
   lighthouse_blackout_create: recurringBlackoutRuleInputSchema,
   lighthouse_blackout_update: recurringBlackoutRuleInputSchema.extend({
@@ -1463,6 +1487,25 @@ var createMcpCoreRuntime = (dependencies) => ({
         `delivery: ${result.error.category} (${result.error.reason})`
       );
     }
+    if (name === "lighthouse_delivery_metrics") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult(
+          "delivery metrics: invalid id (delivery id required)"
+        );
+      }
+      const wantsEpics = argumentsPayload?.detail === "epics";
+      const result = await client.getDeliveryMetricsHistory(id);
+      if (!result.ok) {
+        return getErrorToolResult(
+          `delivery metrics: ${result.error.category} (${result.error.reason})`
+        );
+      }
+      const payload = wantsEpics ? result.value : summariseDeliveryMetricsHistory(result.value);
+      return getSuccessToolResult(
+        `delivery metrics: ${encodePayload(payload)}`
+      );
+    }
     if (name === "lighthouse_blackout_list") {
       const result = await client.getRecurringBlackoutRules();
       if (result.ok) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letpeoplework/lighthouse-mcp-core",
-  "version": "1.6.0",
+  "version": "1.7.1",
   "description": "Shared MCP semantics for Lighthouse",
   "repository": "https://github.com/LetPeopleWork/lighthouse-clients",
   "type": "module",
@@ -26,7 +26,7 @@
     "@modelcontextprotocol/sdk": "^1.26.0",
     "@toon-format/toon": "^2.1.0",
     "zod": "^3.24.1",
-    "@letpeoplework/lighthouse-client": "1.7.0"
+    "@letpeoplework/lighthouse-client": "1.8.1"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --clean",