@letpeoplework/lighthouse-mcp-core 1.5.0 → 1.7.0

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 = () => ({
@@ -65,6 +66,31 @@ var throughputFilterViewProperty = {
     description: `Forecast-filter view (Lighthouse v26.5.24.10+). "filtered" applies the team's exclusion rule to throughput. Omit or "raw" returns unfiltered data.`
   }
 };
+var percentilesOverTimeProperties = {
+  metricType: {
+    type: "string",
+    enum: ["CycleTime", "WorkItemAge"],
+    description: 'Percentile family to read. Defaults to "CycleTime" when omitted.'
+  },
+  horizon: {
+    type: "number",
+    description: "Cycle-time horizon in days (30, 60 or 90). Ignored for WorkItemAge, which is always as-of-today and has no horizon dimension."
+  }
+};
+var processBehaviorOverTimeProperties = {
+  metricType: {
+    type: "string",
+    enum: [
+      "Throughput",
+      "WorkItemAge",
+      "Wip",
+      "CycleTime",
+      "Arrivals",
+      "FeatureSize"
+    ],
+    description: 'Process-behaviour family to read. Defaults to "Throughput" when omitted. "FeatureSize" is portfolio-only \u2014 a team never records it and returns an empty series.'
+  }
+};
 var cumulativeStateProperty = {
   state: {
     type: "string",
@@ -202,7 +228,7 @@ var toolDefinitions = [
   },
   {
     name: "lighthouse_team_metrics_workItemAgePercentiles",
-    description: "Get work-item age percentiles for a team by ID, optionally filtered by start and end dates.",
+    description: "Get work-item age percentiles for a team by ID, optionally filtered by start and end dates. Ages are measured as of the last day of the selected range, not as of today \u2014 a historical range reports how old the items were at the end of that period, so do not present the result as the team's current ages unless the range ends today.",
     inputSchema: {
       type: "object",
       properties: {
@@ -215,7 +241,7 @@ var toolDefinitions = [
   },
   {
     name: "lighthouse_portfolio_metrics_workItemAgePercentiles",
-    description: "Get work-item age percentiles for a portfolio by ID, optionally filtered by start and end dates.",
+    description: "Get work-item age percentiles for a portfolio by ID, optionally filtered by start and end dates. Ages are measured as of the last day of the selected range, not as of today \u2014 a historical range reports how old the items were at the end of that period, so do not present the result as the portfolio's current ages unless the range ends today.",
     inputSchema: {
       type: "object",
       properties: {
@@ -252,6 +278,62 @@ var toolDefinitions = [
       additionalProperties: false
     }
   },
+  {
+    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.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties,
+        ...percentilesOverTimeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    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.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties,
+        ...percentilesOverTimeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    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.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties,
+        ...processBehaviorOverTimeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    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.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties,
+        ...processBehaviorOverTimeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
   {
     name: "lighthouse_portfolio_metrics_throughput",
     description: "Get throughput run-chart data for a portfolio by ID, optionally filtered by start and end dates.",
@@ -351,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.",
@@ -610,6 +709,30 @@ var getThroughputFilterView = (argumentsPayload) => {
   const view = argumentsPayload.view;
   return view === "raw" || view === "filtered" ? view : void 0;
 };
+var percentilesOverTimeMetricTypes = ["CycleTime", "WorkItemAge"];
+var getPercentilesOverTimeMetricType = (argumentsPayload) => {
+  const raw = getStringArgument(argumentsPayload, "metricType");
+  return percentilesOverTimeMetricTypes.find((candidate) => candidate === raw);
+};
+var processBehaviorMetricTypes = [
+  "Throughput",
+  "WorkItemAge",
+  "Wip",
+  "CycleTime",
+  "Arrivals",
+  "FeatureSize"
+];
+var getProcessBehaviorMetricType = (argumentsPayload) => {
+  const raw = getStringArgument(argumentsPayload, "metricType");
+  return processBehaviorMetricTypes.find((candidate) => candidate === raw);
+};
+var getHorizonArgument = (argumentsPayload) => {
+  if (!isObjectRecord(argumentsPayload)) {
+    return void 0;
+  }
+  const horizon = argumentsPayload.horizon;
+  return typeof horizon === "number" && Number.isInteger(horizon) ? horizon : void 0;
+};
 var getApplyFilterOverride = (argumentsPayload) => {
   if (!isObjectRecord(argumentsPayload)) {
     return void 0;
@@ -677,6 +800,46 @@ var toolInputSchemas = {
     startDate: isoDateStringSchema.optional(),
     endDate: isoDateStringSchema.optional()
   }),
+  lighthouse_team_metrics_percentilesOverTime: import_zod.z.object({
+    id: import_zod.z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional(),
+    metricType: import_zod.z.enum(["CycleTime", "WorkItemAge"]).optional(),
+    horizon: import_zod.z.number().int().optional()
+  }),
+  lighthouse_portfolio_metrics_percentilesOverTime: import_zod.z.object({
+    id: import_zod.z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional(),
+    metricType: import_zod.z.enum(["CycleTime", "WorkItemAge"]).optional(),
+    horizon: import_zod.z.number().int().optional()
+  }),
+  lighthouse_team_metrics_processBehaviorOverTime: import_zod.z.object({
+    id: import_zod.z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional(),
+    metricType: import_zod.z.enum([
+      "Throughput",
+      "WorkItemAge",
+      "Wip",
+      "CycleTime",
+      "Arrivals",
+      "FeatureSize"
+    ]).optional()
+  }),
+  lighthouse_portfolio_metrics_processBehaviorOverTime: import_zod.z.object({
+    id: import_zod.z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional(),
+    metricType: import_zod.z.enum([
+      "Throughput",
+      "WorkItemAge",
+      "Wip",
+      "CycleTime",
+      "Arrivals",
+      "FeatureSize"
+    ]).optional()
+  }),
   lighthouse_team_metrics_workItemAge: import_zod.z.object({
     id: import_zod.z.number().int(),
     startDate: isoDateStringSchema.optional(),
@@ -744,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({
@@ -991,6 +1158,88 @@ var createMcpCoreRuntime = (dependencies) => ({
         `portfolio metrics: ${result.error.category} (${result.error.reason})`
       );
     }
+    if (name === "lighthouse_team_metrics_percentilesOverTime") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("team metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getTeamPercentilesOverTime(
+        id,
+        range,
+        getPercentilesOverTimeMetricType(argumentsPayload),
+        getHorizonArgument(argumentsPayload)
+      );
+      if (result.ok) {
+        return getSuccessToolResult(
+          `team percentilesOverTime: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `team metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_portfolio_metrics_percentilesOverTime") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("portfolio metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getPortfolioPercentilesOverTime(
+        id,
+        range,
+        getPercentilesOverTimeMetricType(argumentsPayload),
+        getHorizonArgument(argumentsPayload)
+      );
+      if (result.ok) {
+        return getSuccessToolResult(
+          `portfolio percentilesOverTime: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `portfolio metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_team_metrics_processBehaviorOverTime") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("team metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getTeamProcessBehaviorOverTime(
+        id,
+        range,
+        getProcessBehaviorMetricType(argumentsPayload)
+      );
+      if (result.ok) {
+        return getSuccessToolResult(
+          `team processBehaviorOverTime: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `team metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_portfolio_metrics_processBehaviorOverTime") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("portfolio metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getPortfolioProcessBehaviorOverTime(
+        id,
+        range,
+        getProcessBehaviorMetricType(argumentsPayload)
+      );
+      if (result.ok) {
+        return getSuccessToolResult(
+          `portfolio processBehaviorOverTime: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `portfolio metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
     if (name === "lighthouse_team_metrics_cumulativeStateTime") {
       const id = getNumericId(argumentsPayload);
       if (id === null) {
@@ -1262,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_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";
@@ -262,6 +263,58 @@ type McpRuntimeClient = {
             readonly reason: string;
         };
     }>;
+    readonly getTeamPercentilesOverTime: (id: number, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
+    }, metricType?: "CycleTime" | "WorkItemAge", horizon?: number) => Promise<{
+        readonly ok: true;
+        readonly value: readonly unknown[];
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getPortfolioPercentilesOverTime: (id: number, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
+    }, metricType?: "CycleTime" | "WorkItemAge", horizon?: number) => Promise<{
+        readonly ok: true;
+        readonly value: readonly unknown[];
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getTeamProcessBehaviorOverTime: (id: number, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
+    }, metricType?: "Throughput" | "WorkItemAge" | "Wip" | "CycleTime" | "Arrivals" | "FeatureSize") => Promise<{
+        readonly ok: true;
+        readonly value: readonly unknown[];
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getPortfolioProcessBehaviorOverTime: (id: number, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
+    }, metricType?: "Throughput" | "WorkItemAge" | "Wip" | "CycleTime" | "Arrivals" | "FeatureSize") => Promise<{
+        readonly ok: true;
+        readonly value: readonly unknown[];
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
     readonly getTeamCumulativeStateTime: (id: number, range?: {
         readonly startDate: string;
         readonly endDate: string;
@@ -380,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_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";
@@ -262,6 +263,58 @@ type McpRuntimeClient = {
             readonly reason: string;
         };
     }>;
+    readonly getTeamPercentilesOverTime: (id: number, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
+    }, metricType?: "CycleTime" | "WorkItemAge", horizon?: number) => Promise<{
+        readonly ok: true;
+        readonly value: readonly unknown[];
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getPortfolioPercentilesOverTime: (id: number, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
+    }, metricType?: "CycleTime" | "WorkItemAge", horizon?: number) => Promise<{
+        readonly ok: true;
+        readonly value: readonly unknown[];
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getTeamProcessBehaviorOverTime: (id: number, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
+    }, metricType?: "Throughput" | "WorkItemAge" | "Wip" | "CycleTime" | "Arrivals" | "FeatureSize") => Promise<{
+        readonly ok: true;
+        readonly value: readonly unknown[];
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getPortfolioProcessBehaviorOverTime: (id: number, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
+    }, metricType?: "Throughput" | "WorkItemAge" | "Wip" | "CycleTime" | "Arrivals" | "FeatureSize") => Promise<{
+        readonly ok: true;
+        readonly value: readonly unknown[];
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
     readonly getTeamCumulativeStateTime: (id: number, range?: {
         readonly startDate: string;
         readonly endDate: string;
@@ -380,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 = () => ({
@@ -39,6 +42,31 @@ var throughputFilterViewProperty = {
     description: `Forecast-filter view (Lighthouse v26.5.24.10+). "filtered" applies the team's exclusion rule to throughput. Omit or "raw" returns unfiltered data.`
   }
 };
+var percentilesOverTimeProperties = {
+  metricType: {
+    type: "string",
+    enum: ["CycleTime", "WorkItemAge"],
+    description: 'Percentile family to read. Defaults to "CycleTime" when omitted.'
+  },
+  horizon: {
+    type: "number",
+    description: "Cycle-time horizon in days (30, 60 or 90). Ignored for WorkItemAge, which is always as-of-today and has no horizon dimension."
+  }
+};
+var processBehaviorOverTimeProperties = {
+  metricType: {
+    type: "string",
+    enum: [
+      "Throughput",
+      "WorkItemAge",
+      "Wip",
+      "CycleTime",
+      "Arrivals",
+      "FeatureSize"
+    ],
+    description: 'Process-behaviour family to read. Defaults to "Throughput" when omitted. "FeatureSize" is portfolio-only \u2014 a team never records it and returns an empty series.'
+  }
+};
 var cumulativeStateProperty = {
   state: {
     type: "string",
@@ -176,7 +204,7 @@ var toolDefinitions = [
   },
   {
     name: "lighthouse_team_metrics_workItemAgePercentiles",
-    description: "Get work-item age percentiles for a team by ID, optionally filtered by start and end dates.",
+    description: "Get work-item age percentiles for a team by ID, optionally filtered by start and end dates. Ages are measured as of the last day of the selected range, not as of today \u2014 a historical range reports how old the items were at the end of that period, so do not present the result as the team's current ages unless the range ends today.",
     inputSchema: {
       type: "object",
       properties: {
@@ -189,7 +217,7 @@ var toolDefinitions = [
   },
   {
     name: "lighthouse_portfolio_metrics_workItemAgePercentiles",
-    description: "Get work-item age percentiles for a portfolio by ID, optionally filtered by start and end dates.",
+    description: "Get work-item age percentiles for a portfolio by ID, optionally filtered by start and end dates. Ages are measured as of the last day of the selected range, not as of today \u2014 a historical range reports how old the items were at the end of that period, so do not present the result as the portfolio's current ages unless the range ends today.",
     inputSchema: {
       type: "object",
       properties: {
@@ -226,6 +254,62 @@ var toolDefinitions = [
       additionalProperties: false
     }
   },
+  {
+    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.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties,
+        ...percentilesOverTimeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    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.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties,
+        ...percentilesOverTimeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    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.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties,
+        ...processBehaviorOverTimeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    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.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties,
+        ...processBehaviorOverTimeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
   {
     name: "lighthouse_portfolio_metrics_throughput",
     description: "Get throughput run-chart data for a portfolio by ID, optionally filtered by start and end dates.",
@@ -325,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.",
@@ -584,6 +685,30 @@ var getThroughputFilterView = (argumentsPayload) => {
   const view = argumentsPayload.view;
   return view === "raw" || view === "filtered" ? view : void 0;
 };
+var percentilesOverTimeMetricTypes = ["CycleTime", "WorkItemAge"];
+var getPercentilesOverTimeMetricType = (argumentsPayload) => {
+  const raw = getStringArgument(argumentsPayload, "metricType");
+  return percentilesOverTimeMetricTypes.find((candidate) => candidate === raw);
+};
+var processBehaviorMetricTypes = [
+  "Throughput",
+  "WorkItemAge",
+  "Wip",
+  "CycleTime",
+  "Arrivals",
+  "FeatureSize"
+];
+var getProcessBehaviorMetricType = (argumentsPayload) => {
+  const raw = getStringArgument(argumentsPayload, "metricType");
+  return processBehaviorMetricTypes.find((candidate) => candidate === raw);
+};
+var getHorizonArgument = (argumentsPayload) => {
+  if (!isObjectRecord(argumentsPayload)) {
+    return void 0;
+  }
+  const horizon = argumentsPayload.horizon;
+  return typeof horizon === "number" && Number.isInteger(horizon) ? horizon : void 0;
+};
 var getApplyFilterOverride = (argumentsPayload) => {
   if (!isObjectRecord(argumentsPayload)) {
     return void 0;
@@ -651,6 +776,46 @@ var toolInputSchemas = {
     startDate: isoDateStringSchema.optional(),
     endDate: isoDateStringSchema.optional()
   }),
+  lighthouse_team_metrics_percentilesOverTime: z.object({
+    id: z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional(),
+    metricType: z.enum(["CycleTime", "WorkItemAge"]).optional(),
+    horizon: z.number().int().optional()
+  }),
+  lighthouse_portfolio_metrics_percentilesOverTime: z.object({
+    id: z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional(),
+    metricType: z.enum(["CycleTime", "WorkItemAge"]).optional(),
+    horizon: z.number().int().optional()
+  }),
+  lighthouse_team_metrics_processBehaviorOverTime: z.object({
+    id: z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional(),
+    metricType: z.enum([
+      "Throughput",
+      "WorkItemAge",
+      "Wip",
+      "CycleTime",
+      "Arrivals",
+      "FeatureSize"
+    ]).optional()
+  }),
+  lighthouse_portfolio_metrics_processBehaviorOverTime: z.object({
+    id: z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional(),
+    metricType: z.enum([
+      "Throughput",
+      "WorkItemAge",
+      "Wip",
+      "CycleTime",
+      "Arrivals",
+      "FeatureSize"
+    ]).optional()
+  }),
   lighthouse_team_metrics_workItemAge: z.object({
     id: z.number().int(),
     startDate: isoDateStringSchema.optional(),
@@ -718,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({
@@ -965,6 +1134,88 @@ var createMcpCoreRuntime = (dependencies) => ({
         `portfolio metrics: ${result.error.category} (${result.error.reason})`
       );
     }
+    if (name === "lighthouse_team_metrics_percentilesOverTime") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("team metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getTeamPercentilesOverTime(
+        id,
+        range,
+        getPercentilesOverTimeMetricType(argumentsPayload),
+        getHorizonArgument(argumentsPayload)
+      );
+      if (result.ok) {
+        return getSuccessToolResult(
+          `team percentilesOverTime: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `team metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_portfolio_metrics_percentilesOverTime") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("portfolio metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getPortfolioPercentilesOverTime(
+        id,
+        range,
+        getPercentilesOverTimeMetricType(argumentsPayload),
+        getHorizonArgument(argumentsPayload)
+      );
+      if (result.ok) {
+        return getSuccessToolResult(
+          `portfolio percentilesOverTime: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `portfolio metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_team_metrics_processBehaviorOverTime") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("team metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getTeamProcessBehaviorOverTime(
+        id,
+        range,
+        getProcessBehaviorMetricType(argumentsPayload)
+      );
+      if (result.ok) {
+        return getSuccessToolResult(
+          `team processBehaviorOverTime: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `team metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_portfolio_metrics_processBehaviorOverTime") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("portfolio metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getPortfolioProcessBehaviorOverTime(
+        id,
+        range,
+        getProcessBehaviorMetricType(argumentsPayload)
+      );
+      if (result.ok) {
+        return getSuccessToolResult(
+          `portfolio processBehaviorOverTime: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `portfolio metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
     if (name === "lighthouse_team_metrics_cumulativeStateTime") {
       const id = getNumericId(argumentsPayload);
       if (id === null) {
@@ -1236,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.5.0",
+  "version": "1.7.0",
   "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.6.0"
+    "@letpeoplework/lighthouse-client": "1.8.0"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --clean",