@letpeoplework/lighthouse-mcp-core 1.2.0 → 1.4.0

package/dist/index.cjs

@@ -84,6 +84,40 @@ var forecastFilterOverrideProperty = {
     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 recurringBlackoutRuleProperties = {
+  weekdays: {
+    type: "array",
+    items: {
+      type: "string",
+      enum: [
+        "Sunday",
+        "Monday",
+        "Tuesday",
+        "Wednesday",
+        "Thursday",
+        "Friday",
+        "Saturday"
+      ]
+    },
+    description: "Weekdays the rule applies to."
+  },
+  intervalWeeks: {
+    type: "integer",
+    description: "Repeat every N weeks (1 = every week)."
+  },
+  start: {
+    type: "string",
+    description: "Rule start date in ISO format (YYYY-MM-DD)."
+  },
+  end: {
+    type: ["string", "null"],
+    description: "Optional end date in ISO format (YYYY-MM-DD), or null for an open end."
+  },
+  description: {
+    type: "string",
+    description: "Human-readable description of the rule."
+  }
+};
 var toolDefinitions = [
   {
     name: "lighthouse_health_check",
@@ -151,7 +185,37 @@ var toolDefinitions = [
   },
   {
     name: "lighthouse_team_metrics_cycleTimePercentiles",
-    description: "Get cycle-time percentiles for a team by ID, optionally filtered by start and end dates.",
+    description: "Get cycle-time percentiles for a team by ID, optionally filtered by start and end dates. Pass definitionId to get the percentiles for a named cycle time (premium) instead of the default cycle time.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties,
+        definitionId: {
+          type: "number",
+          description: "Optional named cycle time definition ID; omit for the default cycle time."
+        }
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_team_metrics_workItemAgePercentiles",
+    description: "Get work-item age percentiles for a team by ID, optionally filtered by start and end dates.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_portfolio_metrics_workItemAgePercentiles",
+    description: "Get work-item age percentiles for a portfolio by ID, optionally filtered by start and end dates.",
     inputSchema: {
       type: "object",
       properties: {
@@ -261,6 +325,41 @@ var toolDefinitions = [
     description: "List deliveries for a portfolio by portfolio ID.",
     inputSchema: idInputSchema
   },
+  {
+    name: "lighthouse_blackout_list",
+    description: "List the recurring blackout rules (recurring non-working days excluded from forecasts). Requires Lighthouse newer than v26.5.29.5.",
+    inputSchema: emptyInputSchema
+  },
+  {
+    name: "lighthouse_blackout_create",
+    description: "Create a recurring blackout rule (weekdays + every-N-weeks interval + start date + optional open end). Premium, system-admin only. Requires Lighthouse newer than v26.5.29.5.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...recurringBlackoutRuleProperties
+      },
+      required: ["weekdays", "intervalWeeks", "start", "description"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_blackout_update",
+    description: "Update a recurring blackout rule by ID. Premium, system-admin only. Requires Lighthouse newer than v26.5.29.5.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...recurringBlackoutRuleProperties
+      },
+      required: ["id", "weekdays", "intervalWeeks", "start", "description"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_blackout_delete",
+    description: "Delete a recurring blackout rule by ID. Premium, system-admin only. Requires Lighthouse newer than v26.5.29.5.",
+    inputSchema: idInputSchema
+  },
   {
     name: "lighthouse_forecast_manual",
     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.",
@@ -437,6 +536,13 @@ var getNumericId = (argumentsPayload) => {
   }
   return null;
 };
+var getDefinitionId = (argumentsPayload) => {
+  if (typeof argumentsPayload !== "object" || argumentsPayload === null || Array.isArray(argumentsPayload)) {
+    return void 0;
+  }
+  const value = argumentsPayload.definitionId;
+  return typeof value === "number" && Number.isInteger(value) ? value : void 0;
+};
 var isObjectRecord = (value) => {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 };
@@ -486,6 +592,22 @@ var getApplyFilterOverride = (argumentsPayload) => {
   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 weekdaySchema = import_zod.z.enum([
+  "Sunday",
+  "Monday",
+  "Tuesday",
+  "Wednesday",
+  "Thursday",
+  "Friday",
+  "Saturday"
+]);
+var recurringBlackoutRuleInputSchema = import_zod.z.object({
+  weekdays: import_zod.z.array(weekdaySchema),
+  intervalWeeks: import_zod.z.number().int(),
+  start: isoDateStringSchema,
+  end: isoDateStringSchema.nullable().optional(),
+  description: import_zod.z.string()
+});
 var toolInputSchemas = {
   lighthouse_health_check: import_zod.z.object({}),
   lighthouse_version_get: import_zod.z.object({}),
@@ -504,6 +626,17 @@ var toolInputSchemas = {
     view: import_zod.z.enum(["raw", "filtered"]).optional()
   }),
   lighthouse_team_metrics_cycleTimePercentiles: import_zod.z.object({
+    id: import_zod.z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional(),
+    definitionId: import_zod.z.number().int().optional()
+  }),
+  lighthouse_team_metrics_workItemAgePercentiles: import_zod.z.object({
+    id: import_zod.z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional()
+  }),
+  lighthouse_portfolio_metrics_workItemAgePercentiles: import_zod.z.object({
     id: import_zod.z.number().int(),
     startDate: isoDateStringSchema.optional(),
     endDate: isoDateStringSchema.optional()
@@ -575,6 +708,12 @@ var toolInputSchemas = {
   }),
   lighthouse_feature_workitems: import_zod.z.object({ id: import_zod.z.number().int() }),
   lighthouse_delivery_list: import_zod.z.object({ id: import_zod.z.number().int() }),
+  lighthouse_blackout_list: import_zod.z.object({}),
+  lighthouse_blackout_create: recurringBlackoutRuleInputSchema,
+  lighthouse_blackout_update: recurringBlackoutRuleInputSchema.extend({
+    id: import_zod.z.number().int()
+  }),
+  lighthouse_blackout_delete: import_zod.z.object({ id: import_zod.z.number().int() }),
   lighthouse_forecast_manual: import_zod.z.object({
     id: import_zod.z.number().int(),
     remainingItems: import_zod.z.number().int().optional(),
@@ -590,7 +729,7 @@ var toolInputSchemas = {
     applyFilterOverride: import_zod.z.boolean().optional()
   })
 };
-var isReadOnlyTool = (toolName) => !toolName.endsWith("_refresh");
+var isReadOnlyTool = (toolName) => !(toolName.endsWith("_refresh") || toolName.endsWith("_create") || toolName.endsWith("_update") || toolName.endsWith("_delete"));
 var createMcpCoreRuntime = (dependencies) => ({
   listTools: () => toolDefinitions,
   callTool: async (name, argumentsPayload) => {
@@ -737,7 +876,12 @@ var createMcpCoreRuntime = (dependencies) => ({
         return getErrorToolResult("team metrics: invalid id");
       }
       const range = getDateRange(argumentsPayload);
-      const result = await client.getTeamCycleTimePercentiles(id, range);
+      const definitionId = getDefinitionId(argumentsPayload);
+      const result = await client.getTeamCycleTimePercentiles(
+        id,
+        range,
+        definitionId
+      );
       if (result.ok) {
         return getSuccessToolResult(
           `team cycleTimePercentiles: ${encodePayload(result.value)}`
@@ -747,6 +891,38 @@ var createMcpCoreRuntime = (dependencies) => ({
         `team metrics: ${result.error.category} (${result.error.reason})`
       );
     }
+    if (name === "lighthouse_team_metrics_workItemAgePercentiles") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("team metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getTeamWorkItemAgePercentiles(id, range);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `team workItemAgePercentiles: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `team metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_portfolio_metrics_workItemAgePercentiles") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("portfolio metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getPortfolioWorkItemAgePercentiles(id, range);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `portfolio workItemAgePercentiles: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `portfolio metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
     if (name === "lighthouse_team_metrics_cumulativeStateTime") {
       const id = getNumericId(argumentsPayload);
       if (id === null) {
@@ -1018,6 +1194,59 @@ var createMcpCoreRuntime = (dependencies) => ({
         `delivery: ${result.error.category} (${result.error.reason})`
       );
     }
+    if (name === "lighthouse_blackout_list") {
+      const result = await client.getRecurringBlackoutRules();
+      if (result.ok) {
+        return getSuccessToolResult(
+          `recurringBlackoutRules: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `blackout: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_blackout_create") {
+      const payload = isObjectRecord(argumentsPayload) ? argumentsPayload : {};
+      const result = await client.createRecurringBlackoutRule(payload);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `recurringBlackoutRule: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `blackout: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_blackout_update") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("blackout: invalid id (rule id required)");
+      }
+      const payload = isObjectRecord(argumentsPayload) ? argumentsPayload : {};
+      const { id: _ignoredId, ...rulePayload } = payload;
+      const result = await client.updateRecurringBlackoutRule(id, rulePayload);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `recurringBlackoutRule: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `blackout: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_blackout_delete") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("blackout: invalid id (rule id required)");
+      }
+      const result = await client.deleteRecurringBlackoutRule(id);
+      if (result.ok) {
+        return getSuccessToolResult(`recurringBlackoutRule deleted: ${id}`);
+      }
+      return getErrorToolResult(
+        `blackout: ${result.error.category} (${result.error.reason})`
+      );
+    }
     if (name === "lighthouse_forecast_manual") {
       const id = getNumericId(argumentsPayload);
       if (id === null) {

package/dist/index.d.cts

@@ -15,7 +15,7 @@ type McpToolResult = {
     readonly content: readonly McpToolContent[];
 };
 type McpToolDefinition = {
-    readonly name: "lighthouse_health_check" | "lighthouse_version_get" | "lighthouse_worktracking_list" | "lighthouse_worktracking_get" | "lighthouse_team_list" | "lighthouse_team_get" | "lighthouse_team_refresh" | "lighthouse_portfolio_list" | "lighthouse_portfolio_get" | "lighthouse_portfolio_refresh" | "lighthouse_team_metrics_throughput" | "lighthouse_team_metrics_cycleTimePercentiles" | "lighthouse_team_metrics_workItemAge" | "lighthouse_team_metrics_totalWorkItemAge" | "lighthouse_portfolio_metrics_throughput" | "lighthouse_portfolio_metrics_workItemAge" | "lighthouse_portfolio_metrics_totalWorkItemAge" | "lighthouse_team_metrics_cumulativeStateTime" | "lighthouse_team_metrics_cumulativeStateTimeItems" | "lighthouse_team_metrics_cumulativeStateTimeCandidates" | "lighthouse_portfolio_metrics_cumulativeStateTime" | "lighthouse_portfolio_metrics_cumulativeStateTimeItems" | "lighthouse_portfolio_metrics_cumulativeStateTimeCandidates" | "lighthouse_feature_get" | "lighthouse_feature_workitems" | "lighthouse_delivery_list" | "lighthouse_forecast_manual" | "lighthouse_forecast_backtest";
+    readonly name: "lighthouse_health_check" | "lighthouse_version_get" | "lighthouse_worktracking_list" | "lighthouse_worktracking_get" | "lighthouse_team_list" | "lighthouse_team_get" | "lighthouse_team_refresh" | "lighthouse_portfolio_list" | "lighthouse_portfolio_get" | "lighthouse_portfolio_refresh" | "lighthouse_team_metrics_throughput" | "lighthouse_team_metrics_cycleTimePercentiles" | "lighthouse_team_metrics_workItemAgePercentiles" | "lighthouse_portfolio_metrics_workItemAgePercentiles" | "lighthouse_team_metrics_workItemAge" | "lighthouse_team_metrics_totalWorkItemAge" | "lighthouse_portfolio_metrics_throughput" | "lighthouse_portfolio_metrics_workItemAge" | "lighthouse_portfolio_metrics_totalWorkItemAge" | "lighthouse_team_metrics_cumulativeStateTime" | "lighthouse_team_metrics_cumulativeStateTimeItems" | "lighthouse_team_metrics_cumulativeStateTimeCandidates" | "lighthouse_portfolio_metrics_cumulativeStateTime" | "lighthouse_portfolio_metrics_cumulativeStateTimeItems" | "lighthouse_portfolio_metrics_cumulativeStateTimeCandidates" | "lighthouse_feature_get" | "lighthouse_feature_workitems" | "lighthouse_delivery_list" | "lighthouse_blackout_list" | "lighthouse_blackout_create" | "lighthouse_blackout_update" | "lighthouse_blackout_delete" | "lighthouse_forecast_manual" | "lighthouse_forecast_backtest";
     readonly description: string;
     readonly inputSchema: {
         readonly type: "object";
@@ -26,7 +26,7 @@ type McpToolDefinition = {
 };
 type McpRuntimeClient = {
     readonly checkConnectivity: () => Promise<{
-        readonly category: "success" | "unreachable" | "misconfigured" | "unauthorized" | "dependency-failure" | "unexpected";
+        readonly category: "success" | "unreachable" | "misconfigured" | "unauthorized" | "dependency-failure" | "concurrency-conflict" | "unexpected";
         readonly reason?: string;
     }>;
     readonly getVersion: () => Promise<{
@@ -135,6 +135,32 @@ type McpRuntimeClient = {
     readonly getTeamCycleTimePercentiles: (id: number, range?: {
         readonly startDate: string;
         readonly endDate: string;
+    }, definitionId?: number) => Promise<{
+        readonly ok: true;
+        readonly value: readonly unknown[];
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getTeamWorkItemAgePercentiles: (id: number, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
+    }) => Promise<{
+        readonly ok: true;
+        readonly value: readonly unknown[];
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getPortfolioWorkItemAgePercentiles: (id: number, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
     }) => Promise<{
         readonly ok: true;
         readonly value: readonly unknown[];
@@ -358,6 +384,46 @@ type McpRuntimeClient = {
             readonly reason: string;
         };
     }>;
+    readonly getRecurringBlackoutRules: () => Promise<{
+        readonly ok: true;
+        readonly value: readonly unknown[];
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly createRecurringBlackoutRule: (payload: Readonly<Record<string, unknown>>) => Promise<{
+        readonly ok: true;
+        readonly value: unknown;
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly updateRecurringBlackoutRule: (id: number, payload: Readonly<Record<string, unknown>>) => Promise<{
+        readonly ok: true;
+        readonly value: unknown;
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly deleteRecurringBlackoutRule: (id: number) => Promise<{
+        readonly ok: true;
+        readonly value: undefined;
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
     readonly runManualForecast: (teamId: number, payload: {
         readonly remainingItems?: number;
         readonly targetDate?: string;

package/dist/index.d.ts

@@ -15,7 +15,7 @@ type McpToolResult = {
     readonly content: readonly McpToolContent[];
 };
 type McpToolDefinition = {
-    readonly name: "lighthouse_health_check" | "lighthouse_version_get" | "lighthouse_worktracking_list" | "lighthouse_worktracking_get" | "lighthouse_team_list" | "lighthouse_team_get" | "lighthouse_team_refresh" | "lighthouse_portfolio_list" | "lighthouse_portfolio_get" | "lighthouse_portfolio_refresh" | "lighthouse_team_metrics_throughput" | "lighthouse_team_metrics_cycleTimePercentiles" | "lighthouse_team_metrics_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 name: "lighthouse_health_check" | "lighthouse_version_get" | "lighthouse_worktracking_list" | "lighthouse_worktracking_get" | "lighthouse_team_list" | "lighthouse_team_get" | "lighthouse_team_refresh" | "lighthouse_portfolio_list" | "lighthouse_portfolio_get" | "lighthouse_portfolio_refresh" | "lighthouse_team_metrics_throughput" | "lighthouse_team_metrics_cycleTimePercentiles" | "lighthouse_team_metrics_workItemAgePercentiles" | "lighthouse_portfolio_metrics_workItemAgePercentiles" | "lighthouse_team_metrics_workItemAge" | "lighthouse_team_metrics_totalWorkItemAge" | "lighthouse_portfolio_metrics_throughput" | "lighthouse_portfolio_metrics_workItemAge" | "lighthouse_portfolio_metrics_totalWorkItemAge" | "lighthouse_team_metrics_cumulativeStateTime" | "lighthouse_team_metrics_cumulativeStateTimeItems" | "lighthouse_team_metrics_cumulativeStateTimeCandidates" | "lighthouse_portfolio_metrics_cumulativeStateTime" | "lighthouse_portfolio_metrics_cumulativeStateTimeItems" | "lighthouse_portfolio_metrics_cumulativeStateTimeCandidates" | "lighthouse_feature_get" | "lighthouse_feature_workitems" | "lighthouse_delivery_list" | "lighthouse_blackout_list" | "lighthouse_blackout_create" | "lighthouse_blackout_update" | "lighthouse_blackout_delete" | "lighthouse_forecast_manual" | "lighthouse_forecast_backtest";
     readonly description: string;
     readonly inputSchema: {
         readonly type: "object";
@@ -26,7 +26,7 @@ type McpToolDefinition = {
 };
 type McpRuntimeClient = {
     readonly checkConnectivity: () => Promise<{
-        readonly category: "success" | "unreachable" | "misconfigured" | "unauthorized" | "dependency-failure" | "unexpected";
+        readonly category: "success" | "unreachable" | "misconfigured" | "unauthorized" | "dependency-failure" | "concurrency-conflict" | "unexpected";
         readonly reason?: string;
     }>;
     readonly getVersion: () => Promise<{
@@ -135,6 +135,32 @@ type McpRuntimeClient = {
     readonly getTeamCycleTimePercentiles: (id: number, range?: {
         readonly startDate: string;
         readonly endDate: string;
+    }, definitionId?: number) => Promise<{
+        readonly ok: true;
+        readonly value: readonly unknown[];
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getTeamWorkItemAgePercentiles: (id: number, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
+    }) => Promise<{
+        readonly ok: true;
+        readonly value: readonly unknown[];
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getPortfolioWorkItemAgePercentiles: (id: number, range?: {
+        readonly startDate: string;
+        readonly endDate: string;
     }) => Promise<{
         readonly ok: true;
         readonly value: readonly unknown[];
@@ -358,6 +384,46 @@ type McpRuntimeClient = {
             readonly reason: string;
         };
     }>;
+    readonly getRecurringBlackoutRules: () => Promise<{
+        readonly ok: true;
+        readonly value: readonly unknown[];
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly createRecurringBlackoutRule: (payload: Readonly<Record<string, unknown>>) => Promise<{
+        readonly ok: true;
+        readonly value: unknown;
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly updateRecurringBlackoutRule: (id: number, payload: Readonly<Record<string, unknown>>) => Promise<{
+        readonly ok: true;
+        readonly value: unknown;
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly deleteRecurringBlackoutRule: (id: number) => Promise<{
+        readonly ok: true;
+        readonly value: undefined;
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
     readonly runManualForecast: (teamId: number, payload: {
         readonly remainingItems?: number;
         readonly targetDate?: string;

package/dist/index.js

@@ -58,6 +58,40 @@ var forecastFilterOverrideProperty = {
     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 recurringBlackoutRuleProperties = {
+  weekdays: {
+    type: "array",
+    items: {
+      type: "string",
+      enum: [
+        "Sunday",
+        "Monday",
+        "Tuesday",
+        "Wednesday",
+        "Thursday",
+        "Friday",
+        "Saturday"
+      ]
+    },
+    description: "Weekdays the rule applies to."
+  },
+  intervalWeeks: {
+    type: "integer",
+    description: "Repeat every N weeks (1 = every week)."
+  },
+  start: {
+    type: "string",
+    description: "Rule start date in ISO format (YYYY-MM-DD)."
+  },
+  end: {
+    type: ["string", "null"],
+    description: "Optional end date in ISO format (YYYY-MM-DD), or null for an open end."
+  },
+  description: {
+    type: "string",
+    description: "Human-readable description of the rule."
+  }
+};
 var toolDefinitions = [
   {
     name: "lighthouse_health_check",
@@ -125,7 +159,37 @@ var toolDefinitions = [
   },
   {
     name: "lighthouse_team_metrics_cycleTimePercentiles",
-    description: "Get cycle-time percentiles for a team by ID, optionally filtered by start and end dates.",
+    description: "Get cycle-time percentiles for a team by ID, optionally filtered by start and end dates. Pass definitionId to get the percentiles for a named cycle time (premium) instead of the default cycle time.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties,
+        definitionId: {
+          type: "number",
+          description: "Optional named cycle time definition ID; omit for the default cycle time."
+        }
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_team_metrics_workItemAgePercentiles",
+    description: "Get work-item age percentiles for a team by ID, optionally filtered by start and end dates.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_portfolio_metrics_workItemAgePercentiles",
+    description: "Get work-item age percentiles for a portfolio by ID, optionally filtered by start and end dates.",
     inputSchema: {
       type: "object",
       properties: {
@@ -235,6 +299,41 @@ var toolDefinitions = [
     description: "List deliveries for a portfolio by portfolio ID.",
     inputSchema: idInputSchema
   },
+  {
+    name: "lighthouse_blackout_list",
+    description: "List the recurring blackout rules (recurring non-working days excluded from forecasts). Requires Lighthouse newer than v26.5.29.5.",
+    inputSchema: emptyInputSchema
+  },
+  {
+    name: "lighthouse_blackout_create",
+    description: "Create a recurring blackout rule (weekdays + every-N-weeks interval + start date + optional open end). Premium, system-admin only. Requires Lighthouse newer than v26.5.29.5.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...recurringBlackoutRuleProperties
+      },
+      required: ["weekdays", "intervalWeeks", "start", "description"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_blackout_update",
+    description: "Update a recurring blackout rule by ID. Premium, system-admin only. Requires Lighthouse newer than v26.5.29.5.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...recurringBlackoutRuleProperties
+      },
+      required: ["id", "weekdays", "intervalWeeks", "start", "description"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_blackout_delete",
+    description: "Delete a recurring blackout rule by ID. Premium, system-admin only. Requires Lighthouse newer than v26.5.29.5.",
+    inputSchema: idInputSchema
+  },
   {
     name: "lighthouse_forecast_manual",
     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.",
@@ -411,6 +510,13 @@ var getNumericId = (argumentsPayload) => {
   }
   return null;
 };
+var getDefinitionId = (argumentsPayload) => {
+  if (typeof argumentsPayload !== "object" || argumentsPayload === null || Array.isArray(argumentsPayload)) {
+    return void 0;
+  }
+  const value = argumentsPayload.definitionId;
+  return typeof value === "number" && Number.isInteger(value) ? value : void 0;
+};
 var isObjectRecord = (value) => {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 };
@@ -460,6 +566,22 @@ var getApplyFilterOverride = (argumentsPayload) => {
   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 weekdaySchema = z.enum([
+  "Sunday",
+  "Monday",
+  "Tuesday",
+  "Wednesday",
+  "Thursday",
+  "Friday",
+  "Saturday"
+]);
+var recurringBlackoutRuleInputSchema = z.object({
+  weekdays: z.array(weekdaySchema),
+  intervalWeeks: z.number().int(),
+  start: isoDateStringSchema,
+  end: isoDateStringSchema.nullable().optional(),
+  description: z.string()
+});
 var toolInputSchemas = {
   lighthouse_health_check: z.object({}),
   lighthouse_version_get: z.object({}),
@@ -478,6 +600,17 @@ var toolInputSchemas = {
     view: z.enum(["raw", "filtered"]).optional()
   }),
   lighthouse_team_metrics_cycleTimePercentiles: z.object({
+    id: z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional(),
+    definitionId: z.number().int().optional()
+  }),
+  lighthouse_team_metrics_workItemAgePercentiles: z.object({
+    id: z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional()
+  }),
+  lighthouse_portfolio_metrics_workItemAgePercentiles: z.object({
     id: z.number().int(),
     startDate: isoDateStringSchema.optional(),
     endDate: isoDateStringSchema.optional()
@@ -549,6 +682,12 @@ var toolInputSchemas = {
   }),
   lighthouse_feature_workitems: z.object({ id: z.number().int() }),
   lighthouse_delivery_list: z.object({ id: z.number().int() }),
+  lighthouse_blackout_list: z.object({}),
+  lighthouse_blackout_create: recurringBlackoutRuleInputSchema,
+  lighthouse_blackout_update: recurringBlackoutRuleInputSchema.extend({
+    id: z.number().int()
+  }),
+  lighthouse_blackout_delete: z.object({ id: z.number().int() }),
   lighthouse_forecast_manual: z.object({
     id: z.number().int(),
     remainingItems: z.number().int().optional(),
@@ -564,7 +703,7 @@ var toolInputSchemas = {
     applyFilterOverride: z.boolean().optional()
   })
 };
-var isReadOnlyTool = (toolName) => !toolName.endsWith("_refresh");
+var isReadOnlyTool = (toolName) => !(toolName.endsWith("_refresh") || toolName.endsWith("_create") || toolName.endsWith("_update") || toolName.endsWith("_delete"));
 var createMcpCoreRuntime = (dependencies) => ({
   listTools: () => toolDefinitions,
   callTool: async (name, argumentsPayload) => {
@@ -711,7 +850,12 @@ var createMcpCoreRuntime = (dependencies) => ({
         return getErrorToolResult("team metrics: invalid id");
       }
       const range = getDateRange(argumentsPayload);
-      const result = await client.getTeamCycleTimePercentiles(id, range);
+      const definitionId = getDefinitionId(argumentsPayload);
+      const result = await client.getTeamCycleTimePercentiles(
+        id,
+        range,
+        definitionId
+      );
       if (result.ok) {
         return getSuccessToolResult(
           `team cycleTimePercentiles: ${encodePayload(result.value)}`
@@ -721,6 +865,38 @@ var createMcpCoreRuntime = (dependencies) => ({
         `team metrics: ${result.error.category} (${result.error.reason})`
       );
     }
+    if (name === "lighthouse_team_metrics_workItemAgePercentiles") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("team metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getTeamWorkItemAgePercentiles(id, range);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `team workItemAgePercentiles: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `team metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_portfolio_metrics_workItemAgePercentiles") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("portfolio metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getPortfolioWorkItemAgePercentiles(id, range);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `portfolio workItemAgePercentiles: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `portfolio metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
     if (name === "lighthouse_team_metrics_cumulativeStateTime") {
       const id = getNumericId(argumentsPayload);
       if (id === null) {
@@ -992,6 +1168,59 @@ var createMcpCoreRuntime = (dependencies) => ({
         `delivery: ${result.error.category} (${result.error.reason})`
       );
     }
+    if (name === "lighthouse_blackout_list") {
+      const result = await client.getRecurringBlackoutRules();
+      if (result.ok) {
+        return getSuccessToolResult(
+          `recurringBlackoutRules: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `blackout: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_blackout_create") {
+      const payload = isObjectRecord(argumentsPayload) ? argumentsPayload : {};
+      const result = await client.createRecurringBlackoutRule(payload);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `recurringBlackoutRule: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `blackout: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_blackout_update") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("blackout: invalid id (rule id required)");
+      }
+      const payload = isObjectRecord(argumentsPayload) ? argumentsPayload : {};
+      const { id: _ignoredId, ...rulePayload } = payload;
+      const result = await client.updateRecurringBlackoutRule(id, rulePayload);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `recurringBlackoutRule: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `blackout: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_blackout_delete") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("blackout: invalid id (rule id required)");
+      }
+      const result = await client.deleteRecurringBlackoutRule(id);
+      if (result.ok) {
+        return getSuccessToolResult(`recurringBlackoutRule deleted: ${id}`);
+      }
+      return getErrorToolResult(
+        `blackout: ${result.error.category} (${result.error.reason})`
+      );
+    }
     if (name === "lighthouse_forecast_manual") {
       const id = getNumericId(argumentsPayload);
       if (id === null) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letpeoplework/lighthouse-mcp-core",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Shared MCP semantics for Lighthouse",
   "repository": "https://github.com/LetPeopleWork/lighthouse-clients",
   "type": "module",
@@ -26,7 +26,7 @@
     "@modelcontextprotocol/sdk": "^1.26.0",
     "@toon-format/toon": "^2.1.0",
     "zod": "^3.24.1",
-    "@letpeoplework/lighthouse-client": "1.2.0"
+    "@letpeoplework/lighthouse-client": "1.4.0"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --clean",