@letpeoplework/lighthouse-mcp-core 1.1.0 → 1.2.0

package/dist/index.cjs

@@ -65,6 +65,19 @@ 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 cumulativeStateProperty = {
+  state: {
+    type: "string",
+    description: "Workflow state name to drill into (must match a bar's state from the cumulativeStateTime response)."
+  }
+};
+var itemIdsProperty = {
+  itemIds: {
+    type: "array",
+    items: { type: "integer" },
+    description: "Optional work-item IDs to narrow the computation to a selected subset; omit for all in-scope items."
+  }
+};
 var forecastFilterOverrideProperty = {
   applyFilterOverride: {
     type: "boolean",
@@ -303,6 +316,90 @@ var toolDefinitions = [
       ],
       additionalProperties: false
     }
+  },
+  {
+    name: "lighthouse_team_metrics_cumulativeStateTime",
+    description: "Get cumulative time-per-state bar data for a team by ID: one entry per Doing-category workflow state with total/completed/ongoing contribution days and item counts. Optionally filter by date range and a subset of work-item IDs.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties,
+        ...itemIdsProperty
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_team_metrics_cumulativeStateTimeItems",
+    description: "Get the per-item drill-down for ONE state of a team's cumulative time-per-state chart: the work items that contributed to that state, with days contributed. Requires the state name.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...cumulativeStateProperty,
+        ...dateRangeProperties,
+        ...itemIdsProperty
+      },
+      required: ["id", "state"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_team_metrics_cumulativeStateTimeCandidates",
+    description: "List the work items selectable in a team's cumulative time-per-state item picker for the window (the in-scope candidate set). Search keys are referenceId and title.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_portfolio_metrics_cumulativeStateTime",
+    description: "Get cumulative time-per-state bar data for a portfolio by ID: one entry per Doing-category workflow state with total/completed/ongoing contribution days and item counts. Optionally filter by date range and a subset of work-item IDs.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties,
+        ...itemIdsProperty
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_portfolio_metrics_cumulativeStateTimeItems",
+    description: "Get the per-item drill-down for ONE state of a portfolio's cumulative time-per-state chart: the work items that contributed to that state, with days contributed. Requires the state name.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...cumulativeStateProperty,
+        ...dateRangeProperties,
+        ...itemIdsProperty
+      },
+      required: ["id", "state"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_portfolio_metrics_cumulativeStateTimeCandidates",
+    description: "List the work items selectable in a portfolio's cumulative time-per-state item picker for the window (the in-scope candidate set). Search keys are referenceId and title.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
   }
 ];
 var encodePayload = (value) => {
@@ -354,6 +451,26 @@ var getDateRange = (argumentsPayload) => {
   }
   return void 0;
 };
+var getStringArgument = (argumentsPayload, key) => {
+  if (!isObjectRecord(argumentsPayload)) {
+    return void 0;
+  }
+  const value = argumentsPayload[key];
+  return typeof value === "string" ? value : void 0;
+};
+var getItemIdsArgument = (argumentsPayload) => {
+  if (!isObjectRecord(argumentsPayload)) {
+    return void 0;
+  }
+  const value = argumentsPayload.itemIds;
+  if (!Array.isArray(value)) {
+    return void 0;
+  }
+  const ids = value.filter(
+    (entry) => typeof entry === "number" && Number.isInteger(entry)
+  );
+  return ids.length > 0 ? ids : void 0;
+};
 var getThroughputFilterView = (argumentsPayload) => {
   if (!isObjectRecord(argumentsPayload)) {
     return void 0;
@@ -416,6 +533,42 @@ var toolInputSchemas = {
     startDate: isoDateStringSchema.optional(),
     endDate: isoDateStringSchema.optional()
   }),
+  lighthouse_team_metrics_cumulativeStateTime: import_zod.z.object({
+    id: import_zod.z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional(),
+    itemIds: import_zod.z.array(import_zod.z.number().int()).optional()
+  }),
+  lighthouse_team_metrics_cumulativeStateTimeItems: import_zod.z.object({
+    id: import_zod.z.number().int(),
+    state: import_zod.z.string(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional(),
+    itemIds: import_zod.z.array(import_zod.z.number().int()).optional()
+  }),
+  lighthouse_team_metrics_cumulativeStateTimeCandidates: import_zod.z.object({
+    id: import_zod.z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional()
+  }),
+  lighthouse_portfolio_metrics_cumulativeStateTime: import_zod.z.object({
+    id: import_zod.z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional(),
+    itemIds: import_zod.z.array(import_zod.z.number().int()).optional()
+  }),
+  lighthouse_portfolio_metrics_cumulativeStateTimeItems: import_zod.z.object({
+    id: import_zod.z.number().int(),
+    state: import_zod.z.string(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional(),
+    itemIds: import_zod.z.array(import_zod.z.number().int()).optional()
+  }),
+  lighthouse_portfolio_metrics_cumulativeStateTimeCandidates: import_zod.z.object({
+    id: import_zod.z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional()
+  }),
   lighthouse_feature_get: import_zod.z.object({
     ids: import_zod.z.array(import_zod.z.number().int()).optional(),
     refs: import_zod.z.array(import_zod.z.string()).optional()
@@ -594,6 +747,128 @@ var createMcpCoreRuntime = (dependencies) => ({
         `team metrics: ${result.error.category} (${result.error.reason})`
       );
     }
+    if (name === "lighthouse_team_metrics_cumulativeStateTime") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("team metrics: invalid id");
+      }
+      const result = await client.getTeamCumulativeStateTime(
+        id,
+        getDateRange(argumentsPayload),
+        getItemIdsArgument(argumentsPayload)
+      );
+      if (result.ok) {
+        return getSuccessToolResult(
+          `team cumulativeStateTime: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `team metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_team_metrics_cumulativeStateTimeItems") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("team metrics: invalid id");
+      }
+      const state = getStringArgument(argumentsPayload, "state");
+      if (state === void 0) {
+        return getErrorToolResult("team metrics: missing state");
+      }
+      const result = await client.getTeamCumulativeStateTimeItems(
+        id,
+        state,
+        getDateRange(argumentsPayload),
+        getItemIdsArgument(argumentsPayload)
+      );
+      if (result.ok) {
+        return getSuccessToolResult(
+          `team cumulativeStateTimeItems: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `team metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_team_metrics_cumulativeStateTimeCandidates") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("team metrics: invalid id");
+      }
+      const result = await client.getTeamCumulativeStateTimeCandidates(
+        id,
+        getDateRange(argumentsPayload)
+      );
+      if (result.ok) {
+        return getSuccessToolResult(
+          `team cumulativeStateTimeCandidates: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `team metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_portfolio_metrics_cumulativeStateTime") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("portfolio metrics: invalid id");
+      }
+      const result = await client.getPortfolioCumulativeStateTime(
+        id,
+        getDateRange(argumentsPayload),
+        getItemIdsArgument(argumentsPayload)
+      );
+      if (result.ok) {
+        return getSuccessToolResult(
+          `portfolio cumulativeStateTime: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `portfolio metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_portfolio_metrics_cumulativeStateTimeItems") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("portfolio metrics: invalid id");
+      }
+      const state = getStringArgument(argumentsPayload, "state");
+      if (state === void 0) {
+        return getErrorToolResult("portfolio metrics: missing state");
+      }
+      const result = await client.getPortfolioCumulativeStateTimeItems(
+        id,
+        state,
+        getDateRange(argumentsPayload),
+        getItemIdsArgument(argumentsPayload)
+      );
+      if (result.ok) {
+        return getSuccessToolResult(
+          `portfolio cumulativeStateTimeItems: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `portfolio metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_portfolio_metrics_cumulativeStateTimeCandidates") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("portfolio metrics: invalid id");
+      }
+      const result = await client.getPortfolioCumulativeStateTimeCandidates(
+        id,
+        getDateRange(argumentsPayload)
+      );
+      if (result.ok) {
+        return getSuccessToolResult(
+          `portfolio cumulativeStateTimeCandidates: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `portfolio metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
     if (name === "lighthouse_portfolio_metrics_throughput") {
       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_feature_get" | "lighthouse_feature_workitems" | "lighthouse_delivery_list" | "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_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_forecast_manual" | "lighthouse_forecast_backtest";
     readonly description: string;
     readonly inputSchema: {
         readonly type: "object";
@@ -210,6 +210,84 @@ type McpRuntimeClient = {
             readonly reason: string;
         };
     }>;
+    readonly getTeamCumulativeStateTime: (id: number, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
+    }, itemIds?: readonly number[]) => Promise<{
+        readonly ok: true;
+        readonly value: unknown;
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getTeamCumulativeStateTimeItems: (id: number, state: string, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
+    }, itemIds?: readonly number[]) => Promise<{
+        readonly ok: true;
+        readonly value: unknown;
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getTeamCumulativeStateTimeCandidates: (id: number, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
+    }) => Promise<{
+        readonly ok: true;
+        readonly value: unknown;
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getPortfolioCumulativeStateTime: (id: number, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
+    }, itemIds?: readonly number[]) => Promise<{
+        readonly ok: true;
+        readonly value: unknown;
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getPortfolioCumulativeStateTimeItems: (id: number, state: string, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
+    }, itemIds?: readonly number[]) => Promise<{
+        readonly ok: true;
+        readonly value: unknown;
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getPortfolioCumulativeStateTimeCandidates: (id: number, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
+    }) => Promise<{
+        readonly ok: true;
+        readonly value: unknown;
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
     readonly getFeaturesByIds: (ids: readonly number[]) => 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_feature_get" | "lighthouse_feature_workitems" | "lighthouse_delivery_list" | "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_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_forecast_manual" | "lighthouse_forecast_backtest";
     readonly description: string;
     readonly inputSchema: {
         readonly type: "object";
@@ -210,6 +210,84 @@ type McpRuntimeClient = {
             readonly reason: string;
         };
     }>;
+    readonly getTeamCumulativeStateTime: (id: number, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
+    }, itemIds?: readonly number[]) => Promise<{
+        readonly ok: true;
+        readonly value: unknown;
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getTeamCumulativeStateTimeItems: (id: number, state: string, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
+    }, itemIds?: readonly number[]) => Promise<{
+        readonly ok: true;
+        readonly value: unknown;
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getTeamCumulativeStateTimeCandidates: (id: number, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
+    }) => Promise<{
+        readonly ok: true;
+        readonly value: unknown;
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getPortfolioCumulativeStateTime: (id: number, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
+    }, itemIds?: readonly number[]) => Promise<{
+        readonly ok: true;
+        readonly value: unknown;
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getPortfolioCumulativeStateTimeItems: (id: number, state: string, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
+    }, itemIds?: readonly number[]) => Promise<{
+        readonly ok: true;
+        readonly value: unknown;
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getPortfolioCumulativeStateTimeCandidates: (id: number, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
+    }) => Promise<{
+        readonly ok: true;
+        readonly value: unknown;
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
     readonly getFeaturesByIds: (ids: readonly number[]) => Promise<{
         readonly ok: true;
         readonly value: readonly unknown[];

package/dist/index.js

@@ -39,6 +39,19 @@ 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 cumulativeStateProperty = {
+  state: {
+    type: "string",
+    description: "Workflow state name to drill into (must match a bar's state from the cumulativeStateTime response)."
+  }
+};
+var itemIdsProperty = {
+  itemIds: {
+    type: "array",
+    items: { type: "integer" },
+    description: "Optional work-item IDs to narrow the computation to a selected subset; omit for all in-scope items."
+  }
+};
 var forecastFilterOverrideProperty = {
   applyFilterOverride: {
     type: "boolean",
@@ -277,6 +290,90 @@ var toolDefinitions = [
       ],
       additionalProperties: false
     }
+  },
+  {
+    name: "lighthouse_team_metrics_cumulativeStateTime",
+    description: "Get cumulative time-per-state bar data for a team by ID: one entry per Doing-category workflow state with total/completed/ongoing contribution days and item counts. Optionally filter by date range and a subset of work-item IDs.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties,
+        ...itemIdsProperty
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_team_metrics_cumulativeStateTimeItems",
+    description: "Get the per-item drill-down for ONE state of a team's cumulative time-per-state chart: the work items that contributed to that state, with days contributed. Requires the state name.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...cumulativeStateProperty,
+        ...dateRangeProperties,
+        ...itemIdsProperty
+      },
+      required: ["id", "state"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_team_metrics_cumulativeStateTimeCandidates",
+    description: "List the work items selectable in a team's cumulative time-per-state item picker for the window (the in-scope candidate set). Search keys are referenceId and title.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_portfolio_metrics_cumulativeStateTime",
+    description: "Get cumulative time-per-state bar data for a portfolio by ID: one entry per Doing-category workflow state with total/completed/ongoing contribution days and item counts. Optionally filter by date range and a subset of work-item IDs.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties,
+        ...itemIdsProperty
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_portfolio_metrics_cumulativeStateTimeItems",
+    description: "Get the per-item drill-down for ONE state of a portfolio's cumulative time-per-state chart: the work items that contributed to that state, with days contributed. Requires the state name.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...cumulativeStateProperty,
+        ...dateRangeProperties,
+        ...itemIdsProperty
+      },
+      required: ["id", "state"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_portfolio_metrics_cumulativeStateTimeCandidates",
+    description: "List the work items selectable in a portfolio's cumulative time-per-state item picker for the window (the in-scope candidate set). Search keys are referenceId and title.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
   }
 ];
 var encodePayload = (value) => {
@@ -328,6 +425,26 @@ var getDateRange = (argumentsPayload) => {
   }
   return void 0;
 };
+var getStringArgument = (argumentsPayload, key) => {
+  if (!isObjectRecord(argumentsPayload)) {
+    return void 0;
+  }
+  const value = argumentsPayload[key];
+  return typeof value === "string" ? value : void 0;
+};
+var getItemIdsArgument = (argumentsPayload) => {
+  if (!isObjectRecord(argumentsPayload)) {
+    return void 0;
+  }
+  const value = argumentsPayload.itemIds;
+  if (!Array.isArray(value)) {
+    return void 0;
+  }
+  const ids = value.filter(
+    (entry) => typeof entry === "number" && Number.isInteger(entry)
+  );
+  return ids.length > 0 ? ids : void 0;
+};
 var getThroughputFilterView = (argumentsPayload) => {
   if (!isObjectRecord(argumentsPayload)) {
     return void 0;
@@ -390,6 +507,42 @@ var toolInputSchemas = {
     startDate: isoDateStringSchema.optional(),
     endDate: isoDateStringSchema.optional()
   }),
+  lighthouse_team_metrics_cumulativeStateTime: z.object({
+    id: z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional(),
+    itemIds: z.array(z.number().int()).optional()
+  }),
+  lighthouse_team_metrics_cumulativeStateTimeItems: z.object({
+    id: z.number().int(),
+    state: z.string(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional(),
+    itemIds: z.array(z.number().int()).optional()
+  }),
+  lighthouse_team_metrics_cumulativeStateTimeCandidates: z.object({
+    id: z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional()
+  }),
+  lighthouse_portfolio_metrics_cumulativeStateTime: z.object({
+    id: z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional(),
+    itemIds: z.array(z.number().int()).optional()
+  }),
+  lighthouse_portfolio_metrics_cumulativeStateTimeItems: z.object({
+    id: z.number().int(),
+    state: z.string(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional(),
+    itemIds: z.array(z.number().int()).optional()
+  }),
+  lighthouse_portfolio_metrics_cumulativeStateTimeCandidates: z.object({
+    id: z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional()
+  }),
   lighthouse_feature_get: z.object({
     ids: z.array(z.number().int()).optional(),
     refs: z.array(z.string()).optional()
@@ -568,6 +721,128 @@ var createMcpCoreRuntime = (dependencies) => ({
         `team metrics: ${result.error.category} (${result.error.reason})`
       );
     }
+    if (name === "lighthouse_team_metrics_cumulativeStateTime") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("team metrics: invalid id");
+      }
+      const result = await client.getTeamCumulativeStateTime(
+        id,
+        getDateRange(argumentsPayload),
+        getItemIdsArgument(argumentsPayload)
+      );
+      if (result.ok) {
+        return getSuccessToolResult(
+          `team cumulativeStateTime: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `team metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_team_metrics_cumulativeStateTimeItems") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("team metrics: invalid id");
+      }
+      const state = getStringArgument(argumentsPayload, "state");
+      if (state === void 0) {
+        return getErrorToolResult("team metrics: missing state");
+      }
+      const result = await client.getTeamCumulativeStateTimeItems(
+        id,
+        state,
+        getDateRange(argumentsPayload),
+        getItemIdsArgument(argumentsPayload)
+      );
+      if (result.ok) {
+        return getSuccessToolResult(
+          `team cumulativeStateTimeItems: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `team metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_team_metrics_cumulativeStateTimeCandidates") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("team metrics: invalid id");
+      }
+      const result = await client.getTeamCumulativeStateTimeCandidates(
+        id,
+        getDateRange(argumentsPayload)
+      );
+      if (result.ok) {
+        return getSuccessToolResult(
+          `team cumulativeStateTimeCandidates: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `team metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_portfolio_metrics_cumulativeStateTime") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("portfolio metrics: invalid id");
+      }
+      const result = await client.getPortfolioCumulativeStateTime(
+        id,
+        getDateRange(argumentsPayload),
+        getItemIdsArgument(argumentsPayload)
+      );
+      if (result.ok) {
+        return getSuccessToolResult(
+          `portfolio cumulativeStateTime: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `portfolio metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_portfolio_metrics_cumulativeStateTimeItems") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("portfolio metrics: invalid id");
+      }
+      const state = getStringArgument(argumentsPayload, "state");
+      if (state === void 0) {
+        return getErrorToolResult("portfolio metrics: missing state");
+      }
+      const result = await client.getPortfolioCumulativeStateTimeItems(
+        id,
+        state,
+        getDateRange(argumentsPayload),
+        getItemIdsArgument(argumentsPayload)
+      );
+      if (result.ok) {
+        return getSuccessToolResult(
+          `portfolio cumulativeStateTimeItems: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `portfolio metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_portfolio_metrics_cumulativeStateTimeCandidates") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("portfolio metrics: invalid id");
+      }
+      const result = await client.getPortfolioCumulativeStateTimeCandidates(
+        id,
+        getDateRange(argumentsPayload)
+      );
+      if (result.ok) {
+        return getSuccessToolResult(
+          `portfolio cumulativeStateTimeCandidates: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `portfolio metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
     if (name === "lighthouse_portfolio_metrics_throughput") {
       const id = getNumericId(argumentsPayload);
       if (id === null) {

package/package.json

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