@letpeoplework/lighthouse-mcp-core 1.0.1 → 1.2.0

package/dist/index.cjs

@@ -58,6 +58,32 @@ var dateRangeProperties = {
     description: "Inclusive end date in ISO format (YYYY-MM-DD)."
   }
 };
+var throughputFilterViewProperty = {
+  view: {
+    type: "string",
+    enum: ["raw", "filtered"],
+    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",
+    description: "Override the team's forecast-filter setting (Lighthouse v26.5.24.10+). true = apply the team filter; false = skip the filter (raw); omit = respect the team setting."
+  }
+};
 var toolDefinitions = [
   {
     name: "lighthouse_health_check",
@@ -111,12 +137,13 @@ var toolDefinitions = [
   },
   {
     name: "lighthouse_team_metrics_throughput",
-    description: "Get throughput run-chart data for a team by ID, optionally filtered by start and end dates.",
+    description: `Get throughput run-chart data for a team by ID, optionally filtered by start and end dates. Pass view="filtered" to apply the team's forecast-exclusion rule (Lighthouse v26.5.24.10+); omit or "raw" returns unfiltered data.`,
     inputSchema: {
       type: "object",
       properties: {
         ...idInputSchema.properties,
-        ...dateRangeProperties
+        ...dateRangeProperties,
+        ...throughputFilterViewProperty
       },
       required: ["id"],
       additionalProperties: false
@@ -236,7 +263,7 @@ var toolDefinitions = [
   },
   {
     name: "lighthouse_forecast_manual",
-    description: "Run a manual forecast for a team by ID with optional remaining items and target date.",
+    description: "Run a manual forecast for a team by ID with optional remaining items and target date. Pass applyFilterOverride=true to apply the team's forecast filter, false to skip it, or omit to respect the team setting (Lighthouse v26.5.24.10+). The response includes filterApplied (boolean) and excludedSummary (string) when a filter was applied.",
     inputSchema: {
       type: "object",
       properties: {
@@ -248,7 +275,8 @@ var toolDefinitions = [
         targetDate: {
           type: "string",
           description: "Optional target date in ISO format (YYYY-MM-DD)."
-        }
+        },
+        ...forecastFilterOverrideProperty
       },
       required: ["id"],
       additionalProperties: false
@@ -256,7 +284,7 @@ var toolDefinitions = [
   },
   {
     name: "lighthouse_forecast_backtest",
-    description: "Run a forecast backtest for a team by ID using forecast and historical date ranges.",
+    description: "Run a forecast backtest for a team by ID using forecast and historical date ranges. Pass applyFilterOverride=true to apply the team's forecast filter, false to skip it, or omit to respect the team setting (Lighthouse v26.5.24.10+). The response includes filterApplied (boolean) and excludedSummary (string) when a filter was applied.",
     inputSchema: {
       type: "object",
       properties: {
@@ -276,7 +304,8 @@ var toolDefinitions = [
         historicalEndDate: {
           type: "string",
           description: "Historical sample end date in ISO format (YYYY-MM-DD)."
-        }
+        },
+        ...forecastFilterOverrideProperty
       },
       required: [
         "id",
@@ -287,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) => {
@@ -338,6 +451,40 @@ 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;
+  }
+  const view = argumentsPayload.view;
+  return view === "raw" || view === "filtered" ? view : void 0;
+};
+var getApplyFilterOverride = (argumentsPayload) => {
+  if (!isObjectRecord(argumentsPayload)) {
+    return void 0;
+  }
+  const value = argumentsPayload.applyFilterOverride;
+  return typeof value === "boolean" ? value : void 0;
+};
 var isoDateStringSchema = import_zod.z.string().regex(/^\d{4}-\d{2}-\d{2}$/u, "Expected ISO date in YYYY-MM-DD format.");
 var toolInputSchemas = {
   lighthouse_health_check: import_zod.z.object({}),
@@ -353,7 +500,8 @@ var toolInputSchemas = {
   lighthouse_team_metrics_throughput: import_zod.z.object({
     id: import_zod.z.number().int(),
     startDate: isoDateStringSchema.optional(),
-    endDate: isoDateStringSchema.optional()
+    endDate: isoDateStringSchema.optional(),
+    view: import_zod.z.enum(["raw", "filtered"]).optional()
   }),
   lighthouse_team_metrics_cycleTimePercentiles: import_zod.z.object({
     id: import_zod.z.number().int(),
@@ -385,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()
@@ -394,14 +578,16 @@ var toolInputSchemas = {
   lighthouse_forecast_manual: import_zod.z.object({
     id: import_zod.z.number().int(),
     remainingItems: import_zod.z.number().int().optional(),
-    targetDate: isoDateStringSchema.optional()
+    targetDate: isoDateStringSchema.optional(),
+    applyFilterOverride: import_zod.z.boolean().optional()
   }),
   lighthouse_forecast_backtest: import_zod.z.object({
     id: import_zod.z.number().int(),
     startDate: isoDateStringSchema,
     endDate: isoDateStringSchema,
     historicalStartDate: isoDateStringSchema,
-    historicalEndDate: isoDateStringSchema
+    historicalEndDate: isoDateStringSchema,
+    applyFilterOverride: import_zod.z.boolean().optional()
   })
 };
 var isReadOnlyTool = (toolName) => !toolName.endsWith("_refresh");
@@ -534,7 +720,8 @@ var createMcpCoreRuntime = (dependencies) => ({
         return getErrorToolResult("team metrics: invalid id");
       }
       const range = getDateRange(argumentsPayload);
-      const result = await client.getTeamThroughput(id, range);
+      const view = getThroughputFilterView(argumentsPayload);
+      const result = await client.getTeamThroughput(id, range, view);
       if (result.ok) {
         return getSuccessToolResult(
           `team throughput: ${encodePayload(result.value)}`
@@ -560,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) {
@@ -717,9 +1026,11 @@ var createMcpCoreRuntime = (dependencies) => ({
       const payload = isObjectRecord(argumentsPayload) ? argumentsPayload : {};
       const remainingItems = typeof payload.remainingItems === "number" ? payload.remainingItems : void 0;
       const targetDate = typeof payload.targetDate === "string" ? payload.targetDate : void 0;
+      const applyFilterOverride = getApplyFilterOverride(argumentsPayload);
       const result = await client.runManualForecast(id, {
         remainingItems,
-        targetDate
+        targetDate,
+        applyFilterOverride
       });
       if (result.ok) {
         return getSuccessToolResult(`forecast: ${encodePayload(result.value)}`);
@@ -743,11 +1054,13 @@ var createMcpCoreRuntime = (dependencies) => ({
           "backtest: startDate, endDate, historicalStartDate, and historicalEndDate are required"
         );
       }
+      const applyFilterOverride = getApplyFilterOverride(argumentsPayload);
       const result = await client.runBacktest(id, {
         startDate,
         endDate,
         historicalStartDate,
-        historicalEndDate
+        historicalEndDate,
+        applyFilterOverride
       });
       if (result.ok) {
         return getSuccessToolResult(`backtest: ${encodePayload(result.value)}`);

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";
@@ -122,7 +122,7 @@ type McpRuntimeClient = {
     readonly getTeamThroughput: (id: number, range?: {
         readonly startDate: string;
         readonly endDate: string;
-    }) => Promise<{
+    }, view?: "raw" | "filtered") => Promise<{
         readonly ok: true;
         readonly value: unknown;
     } | {
@@ -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[];
@@ -283,6 +361,7 @@ type McpRuntimeClient = {
     readonly runManualForecast: (teamId: number, payload: {
         readonly remainingItems?: number;
         readonly targetDate?: string;
+        readonly applyFilterOverride?: boolean;
     }) => Promise<{
         readonly ok: true;
         readonly value: unknown;
@@ -298,6 +377,7 @@ type McpRuntimeClient = {
         readonly endDate: string;
         readonly historicalStartDate: string;
         readonly historicalEndDate: string;
+        readonly applyFilterOverride?: boolean;
     }) => Promise<{
         readonly ok: true;
         readonly value: 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";
@@ -122,7 +122,7 @@ type McpRuntimeClient = {
     readonly getTeamThroughput: (id: number, range?: {
         readonly startDate: string;
         readonly endDate: string;
-    }) => Promise<{
+    }, view?: "raw" | "filtered") => Promise<{
         readonly ok: true;
         readonly value: unknown;
     } | {
@@ -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[];
@@ -283,6 +361,7 @@ type McpRuntimeClient = {
     readonly runManualForecast: (teamId: number, payload: {
         readonly remainingItems?: number;
         readonly targetDate?: string;
+        readonly applyFilterOverride?: boolean;
     }) => Promise<{
         readonly ok: true;
         readonly value: unknown;
@@ -298,6 +377,7 @@ type McpRuntimeClient = {
         readonly endDate: string;
         readonly historicalStartDate: string;
         readonly historicalEndDate: string;
+        readonly applyFilterOverride?: boolean;
     }) => Promise<{
         readonly ok: true;
         readonly value: unknown;

package/dist/index.js

@@ -32,6 +32,32 @@ var dateRangeProperties = {
     description: "Inclusive end date in ISO format (YYYY-MM-DD)."
   }
 };
+var throughputFilterViewProperty = {
+  view: {
+    type: "string",
+    enum: ["raw", "filtered"],
+    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",
+    description: "Override the team's forecast-filter setting (Lighthouse v26.5.24.10+). true = apply the team filter; false = skip the filter (raw); omit = respect the team setting."
+  }
+};
 var toolDefinitions = [
   {
     name: "lighthouse_health_check",
@@ -85,12 +111,13 @@ var toolDefinitions = [
   },
   {
     name: "lighthouse_team_metrics_throughput",
-    description: "Get throughput run-chart data for a team by ID, optionally filtered by start and end dates.",
+    description: `Get throughput run-chart data for a team by ID, optionally filtered by start and end dates. Pass view="filtered" to apply the team's forecast-exclusion rule (Lighthouse v26.5.24.10+); omit or "raw" returns unfiltered data.`,
     inputSchema: {
       type: "object",
       properties: {
         ...idInputSchema.properties,
-        ...dateRangeProperties
+        ...dateRangeProperties,
+        ...throughputFilterViewProperty
       },
       required: ["id"],
       additionalProperties: false
@@ -210,7 +237,7 @@ var toolDefinitions = [
   },
   {
     name: "lighthouse_forecast_manual",
-    description: "Run a manual forecast for a team by ID with optional remaining items and target date.",
+    description: "Run a manual forecast for a team by ID with optional remaining items and target date. Pass applyFilterOverride=true to apply the team's forecast filter, false to skip it, or omit to respect the team setting (Lighthouse v26.5.24.10+). The response includes filterApplied (boolean) and excludedSummary (string) when a filter was applied.",
     inputSchema: {
       type: "object",
       properties: {
@@ -222,7 +249,8 @@ var toolDefinitions = [
         targetDate: {
           type: "string",
           description: "Optional target date in ISO format (YYYY-MM-DD)."
-        }
+        },
+        ...forecastFilterOverrideProperty
       },
       required: ["id"],
       additionalProperties: false
@@ -230,7 +258,7 @@ var toolDefinitions = [
   },
   {
     name: "lighthouse_forecast_backtest",
-    description: "Run a forecast backtest for a team by ID using forecast and historical date ranges.",
+    description: "Run a forecast backtest for a team by ID using forecast and historical date ranges. Pass applyFilterOverride=true to apply the team's forecast filter, false to skip it, or omit to respect the team setting (Lighthouse v26.5.24.10+). The response includes filterApplied (boolean) and excludedSummary (string) when a filter was applied.",
     inputSchema: {
       type: "object",
       properties: {
@@ -250,7 +278,8 @@ var toolDefinitions = [
         historicalEndDate: {
           type: "string",
           description: "Historical sample end date in ISO format (YYYY-MM-DD)."
-        }
+        },
+        ...forecastFilterOverrideProperty
       },
       required: [
         "id",
@@ -261,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) => {
@@ -312,6 +425,40 @@ 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;
+  }
+  const view = argumentsPayload.view;
+  return view === "raw" || view === "filtered" ? view : void 0;
+};
+var getApplyFilterOverride = (argumentsPayload) => {
+  if (!isObjectRecord(argumentsPayload)) {
+    return void 0;
+  }
+  const value = argumentsPayload.applyFilterOverride;
+  return typeof value === "boolean" ? value : void 0;
+};
 var isoDateStringSchema = z.string().regex(/^\d{4}-\d{2}-\d{2}$/u, "Expected ISO date in YYYY-MM-DD format.");
 var toolInputSchemas = {
   lighthouse_health_check: z.object({}),
@@ -327,7 +474,8 @@ var toolInputSchemas = {
   lighthouse_team_metrics_throughput: z.object({
     id: z.number().int(),
     startDate: isoDateStringSchema.optional(),
-    endDate: isoDateStringSchema.optional()
+    endDate: isoDateStringSchema.optional(),
+    view: z.enum(["raw", "filtered"]).optional()
   }),
   lighthouse_team_metrics_cycleTimePercentiles: z.object({
     id: z.number().int(),
@@ -359,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()
@@ -368,14 +552,16 @@ var toolInputSchemas = {
   lighthouse_forecast_manual: z.object({
     id: z.number().int(),
     remainingItems: z.number().int().optional(),
-    targetDate: isoDateStringSchema.optional()
+    targetDate: isoDateStringSchema.optional(),
+    applyFilterOverride: z.boolean().optional()
   }),
   lighthouse_forecast_backtest: z.object({
     id: z.number().int(),
     startDate: isoDateStringSchema,
     endDate: isoDateStringSchema,
     historicalStartDate: isoDateStringSchema,
-    historicalEndDate: isoDateStringSchema
+    historicalEndDate: isoDateStringSchema,
+    applyFilterOverride: z.boolean().optional()
   })
 };
 var isReadOnlyTool = (toolName) => !toolName.endsWith("_refresh");
@@ -508,7 +694,8 @@ var createMcpCoreRuntime = (dependencies) => ({
         return getErrorToolResult("team metrics: invalid id");
       }
       const range = getDateRange(argumentsPayload);
-      const result = await client.getTeamThroughput(id, range);
+      const view = getThroughputFilterView(argumentsPayload);
+      const result = await client.getTeamThroughput(id, range, view);
       if (result.ok) {
         return getSuccessToolResult(
           `team throughput: ${encodePayload(result.value)}`
@@ -534,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) {
@@ -691,9 +1000,11 @@ var createMcpCoreRuntime = (dependencies) => ({
       const payload = isObjectRecord(argumentsPayload) ? argumentsPayload : {};
       const remainingItems = typeof payload.remainingItems === "number" ? payload.remainingItems : void 0;
       const targetDate = typeof payload.targetDate === "string" ? payload.targetDate : void 0;
+      const applyFilterOverride = getApplyFilterOverride(argumentsPayload);
       const result = await client.runManualForecast(id, {
         remainingItems,
-        targetDate
+        targetDate,
+        applyFilterOverride
       });
       if (result.ok) {
         return getSuccessToolResult(`forecast: ${encodePayload(result.value)}`);
@@ -717,11 +1028,13 @@ var createMcpCoreRuntime = (dependencies) => ({
           "backtest: startDate, endDate, historicalStartDate, and historicalEndDate are required"
         );
       }
+      const applyFilterOverride = getApplyFilterOverride(argumentsPayload);
       const result = await client.runBacktest(id, {
         startDate,
         endDate,
         historicalStartDate,
-        historicalEndDate
+        historicalEndDate,
+        applyFilterOverride
       });
       if (result.ok) {
         return getSuccessToolResult(`backtest: ${encodePayload(result.value)}`);

package/package.json

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