@letpeoplework/lighthouse-mcp-core 1.0.1 → 1.1.0

package/dist/index.cjs

@@ -58,6 +58,19 @@ 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 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 +124,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 +250,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 +262,8 @@ var toolDefinitions = [
         targetDate: {
           type: "string",
           description: "Optional target date in ISO format (YYYY-MM-DD)."
-        }
+        },
+        ...forecastFilterOverrideProperty
       },
       required: ["id"],
       additionalProperties: false
@@ -256,7 +271,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 +291,8 @@ var toolDefinitions = [
         historicalEndDate: {
           type: "string",
           description: "Historical sample end date in ISO format (YYYY-MM-DD)."
-        }
+        },
+        ...forecastFilterOverrideProperty
       },
       required: [
         "id",
@@ -338,6 +354,20 @@ var getDateRange = (argumentsPayload) => {
   }
   return 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 +383,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(),
@@ -394,14 +425,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 +567,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)}`
@@ -717,9 +751,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 +779,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

@@ -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;
     } | {
@@ -283,6 +283,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 +299,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

@@ -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;
     } | {
@@ -283,6 +283,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 +299,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,19 @@ 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 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 +98,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 +224,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 +236,8 @@ var toolDefinitions = [
         targetDate: {
           type: "string",
           description: "Optional target date in ISO format (YYYY-MM-DD)."
-        }
+        },
+        ...forecastFilterOverrideProperty
       },
       required: ["id"],
       additionalProperties: false
@@ -230,7 +245,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 +265,8 @@ var toolDefinitions = [
         historicalEndDate: {
           type: "string",
           description: "Historical sample end date in ISO format (YYYY-MM-DD)."
-        }
+        },
+        ...forecastFilterOverrideProperty
       },
       required: [
         "id",
@@ -312,6 +328,20 @@ var getDateRange = (argumentsPayload) => {
   }
   return 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 +357,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(),
@@ -368,14 +399,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 +541,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)}`
@@ -691,9 +725,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 +753,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.1.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.1.0"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --clean",