@letpeoplework/lighthouse-mcp-core 1.5.0 → 1.6.0

package/dist/index.cjs

@@ -65,6 +65,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 +227,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 +240,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 +277,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.",
@@ -610,6 +691,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 +782,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(),
@@ -991,6 +1136,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) {

package/dist/index.d.cts

@@ -15,7 +15,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_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 +262,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;

package/dist/index.d.ts

@@ -15,7 +15,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_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 +262,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;

package/dist/index.js

@@ -39,6 +39,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 +201,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 +214,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 +251,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.",
@@ -584,6 +665,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 +756,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(),
@@ -965,6 +1110,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) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letpeoplework/lighthouse-mcp-core",
-  "version": "1.5.0",
+  "version": "1.6.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.7.0"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --clean",