@letpeoplework/lighthouse-mcp-core 1.3.0 → 1.4.0

package/dist/index.cjs

@@ -185,7 +185,37 @@ var toolDefinitions = [
   },
   {
     name: "lighthouse_team_metrics_cycleTimePercentiles",
-    description: "Get cycle-time percentiles for a team by ID, optionally filtered by start and end dates.",
+    description: "Get cycle-time percentiles for a team by ID, optionally filtered by start and end dates. Pass definitionId to get the percentiles for a named cycle time (premium) instead of the default cycle time.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties,
+        definitionId: {
+          type: "number",
+          description: "Optional named cycle time definition ID; omit for the default cycle time."
+        }
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_team_metrics_workItemAgePercentiles",
+    description: "Get work-item age percentiles for a team by ID, optionally filtered by start and end dates.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_portfolio_metrics_workItemAgePercentiles",
+    description: "Get work-item age percentiles for a portfolio by ID, optionally filtered by start and end dates.",
     inputSchema: {
       type: "object",
       properties: {
@@ -506,6 +536,13 @@ var getNumericId = (argumentsPayload) => {
   }
   return null;
 };
+var getDefinitionId = (argumentsPayload) => {
+  if (typeof argumentsPayload !== "object" || argumentsPayload === null || Array.isArray(argumentsPayload)) {
+    return void 0;
+  }
+  const value = argumentsPayload.definitionId;
+  return typeof value === "number" && Number.isInteger(value) ? value : void 0;
+};
 var isObjectRecord = (value) => {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 };
@@ -589,6 +626,17 @@ var toolInputSchemas = {
     view: import_zod.z.enum(["raw", "filtered"]).optional()
   }),
   lighthouse_team_metrics_cycleTimePercentiles: import_zod.z.object({
+    id: import_zod.z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional(),
+    definitionId: import_zod.z.number().int().optional()
+  }),
+  lighthouse_team_metrics_workItemAgePercentiles: import_zod.z.object({
+    id: import_zod.z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional()
+  }),
+  lighthouse_portfolio_metrics_workItemAgePercentiles: import_zod.z.object({
     id: import_zod.z.number().int(),
     startDate: isoDateStringSchema.optional(),
     endDate: isoDateStringSchema.optional()
@@ -828,7 +876,12 @@ var createMcpCoreRuntime = (dependencies) => ({
         return getErrorToolResult("team metrics: invalid id");
       }
       const range = getDateRange(argumentsPayload);
-      const result = await client.getTeamCycleTimePercentiles(id, range);
+      const definitionId = getDefinitionId(argumentsPayload);
+      const result = await client.getTeamCycleTimePercentiles(
+        id,
+        range,
+        definitionId
+      );
       if (result.ok) {
         return getSuccessToolResult(
           `team cycleTimePercentiles: ${encodePayload(result.value)}`
@@ -838,6 +891,38 @@ var createMcpCoreRuntime = (dependencies) => ({
         `team metrics: ${result.error.category} (${result.error.reason})`
       );
     }
+    if (name === "lighthouse_team_metrics_workItemAgePercentiles") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("team metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getTeamWorkItemAgePercentiles(id, range);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `team workItemAgePercentiles: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `team metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_portfolio_metrics_workItemAgePercentiles") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("portfolio metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getPortfolioWorkItemAgePercentiles(id, range);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `portfolio workItemAgePercentiles: ${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_workItemAge" | "lighthouse_team_metrics_totalWorkItemAge" | "lighthouse_portfolio_metrics_throughput" | "lighthouse_portfolio_metrics_workItemAge" | "lighthouse_portfolio_metrics_totalWorkItemAge" | "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_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";
@@ -135,6 +135,32 @@ type McpRuntimeClient = {
     readonly getTeamCycleTimePercentiles: (id: number, range?: {
         readonly startDate: string;
         readonly endDate: string;
+    }, definitionId?: number) => Promise<{
+        readonly ok: true;
+        readonly value: readonly unknown[];
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getTeamWorkItemAgePercentiles: (id: number, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
+    }) => Promise<{
+        readonly ok: true;
+        readonly value: readonly unknown[];
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getPortfolioWorkItemAgePercentiles: (id: number, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
     }) => Promise<{
         readonly ok: true;
         readonly value: readonly unknown[];

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_workItemAge" | "lighthouse_team_metrics_totalWorkItemAge" | "lighthouse_portfolio_metrics_throughput" | "lighthouse_portfolio_metrics_workItemAge" | "lighthouse_portfolio_metrics_totalWorkItemAge" | "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_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";
@@ -135,6 +135,32 @@ type McpRuntimeClient = {
     readonly getTeamCycleTimePercentiles: (id: number, range?: {
         readonly startDate: string;
         readonly endDate: string;
+    }, definitionId?: number) => Promise<{
+        readonly ok: true;
+        readonly value: readonly unknown[];
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getTeamWorkItemAgePercentiles: (id: number, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
+    }) => Promise<{
+        readonly ok: true;
+        readonly value: readonly unknown[];
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getPortfolioWorkItemAgePercentiles: (id: number, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
     }) => Promise<{
         readonly ok: true;
         readonly value: readonly unknown[];

package/dist/index.js

@@ -159,7 +159,37 @@ var toolDefinitions = [
   },
   {
     name: "lighthouse_team_metrics_cycleTimePercentiles",
-    description: "Get cycle-time percentiles for a team by ID, optionally filtered by start and end dates.",
+    description: "Get cycle-time percentiles for a team by ID, optionally filtered by start and end dates. Pass definitionId to get the percentiles for a named cycle time (premium) instead of the default cycle time.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties,
+        definitionId: {
+          type: "number",
+          description: "Optional named cycle time definition ID; omit for the default cycle time."
+        }
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_team_metrics_workItemAgePercentiles",
+    description: "Get work-item age percentiles for a team by ID, optionally filtered by start and end dates.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_portfolio_metrics_workItemAgePercentiles",
+    description: "Get work-item age percentiles for a portfolio by ID, optionally filtered by start and end dates.",
     inputSchema: {
       type: "object",
       properties: {
@@ -480,6 +510,13 @@ var getNumericId = (argumentsPayload) => {
   }
   return null;
 };
+var getDefinitionId = (argumentsPayload) => {
+  if (typeof argumentsPayload !== "object" || argumentsPayload === null || Array.isArray(argumentsPayload)) {
+    return void 0;
+  }
+  const value = argumentsPayload.definitionId;
+  return typeof value === "number" && Number.isInteger(value) ? value : void 0;
+};
 var isObjectRecord = (value) => {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 };
@@ -563,6 +600,17 @@ var toolInputSchemas = {
     view: z.enum(["raw", "filtered"]).optional()
   }),
   lighthouse_team_metrics_cycleTimePercentiles: z.object({
+    id: z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional(),
+    definitionId: z.number().int().optional()
+  }),
+  lighthouse_team_metrics_workItemAgePercentiles: z.object({
+    id: z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional()
+  }),
+  lighthouse_portfolio_metrics_workItemAgePercentiles: z.object({
     id: z.number().int(),
     startDate: isoDateStringSchema.optional(),
     endDate: isoDateStringSchema.optional()
@@ -802,7 +850,12 @@ var createMcpCoreRuntime = (dependencies) => ({
         return getErrorToolResult("team metrics: invalid id");
       }
       const range = getDateRange(argumentsPayload);
-      const result = await client.getTeamCycleTimePercentiles(id, range);
+      const definitionId = getDefinitionId(argumentsPayload);
+      const result = await client.getTeamCycleTimePercentiles(
+        id,
+        range,
+        definitionId
+      );
       if (result.ok) {
         return getSuccessToolResult(
           `team cycleTimePercentiles: ${encodePayload(result.value)}`
@@ -812,6 +865,38 @@ var createMcpCoreRuntime = (dependencies) => ({
         `team metrics: ${result.error.category} (${result.error.reason})`
       );
     }
+    if (name === "lighthouse_team_metrics_workItemAgePercentiles") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("team metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getTeamWorkItemAgePercentiles(id, range);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `team workItemAgePercentiles: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `team metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_portfolio_metrics_workItemAgePercentiles") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("portfolio metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getPortfolioWorkItemAgePercentiles(id, range);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `portfolio workItemAgePercentiles: ${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.3.0",
+  "version": "1.4.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.3.0"
+    "@letpeoplework/lighthouse-client": "1.4.0"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --clean",