@letpeoplework/lighthouse-mcp-core 1.1.0 → 1.3.0

package/dist/index.cjs

@@ -65,12 +65,59 @@ var throughputFilterViewProperty = {
     description: `Forecast-filter view (Lighthouse v26.5.24.10+). "filtered" applies the team's exclusion rule to throughput. Omit or "raw" returns unfiltered data.`
   }
 };
+var cumulativeStateProperty = {
+  state: {
+    type: "string",
+    description: "Workflow state name to drill into (must match a bar's state from the cumulativeStateTime response)."
+  }
+};
+var itemIdsProperty = {
+  itemIds: {
+    type: "array",
+    items: { type: "integer" },
+    description: "Optional work-item IDs to narrow the computation to a selected subset; omit for all in-scope items."
+  }
+};
 var forecastFilterOverrideProperty = {
   applyFilterOverride: {
     type: "boolean",
     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",
@@ -248,6 +295,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.",
@@ -303,6 +385,90 @@ var toolDefinitions = [
       ],
       additionalProperties: false
     }
+  },
+  {
+    name: "lighthouse_team_metrics_cumulativeStateTime",
+    description: "Get cumulative time-per-state bar data for a team by ID: one entry per Doing-category workflow state with total/completed/ongoing contribution days and item counts. Optionally filter by date range and a subset of work-item IDs.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties,
+        ...itemIdsProperty
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_team_metrics_cumulativeStateTimeItems",
+    description: "Get the per-item drill-down for ONE state of a team's cumulative time-per-state chart: the work items that contributed to that state, with days contributed. Requires the state name.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...cumulativeStateProperty,
+        ...dateRangeProperties,
+        ...itemIdsProperty
+      },
+      required: ["id", "state"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_team_metrics_cumulativeStateTimeCandidates",
+    description: "List the work items selectable in a team's cumulative time-per-state item picker for the window (the in-scope candidate set). Search keys are referenceId and title.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_portfolio_metrics_cumulativeStateTime",
+    description: "Get cumulative time-per-state bar data for a portfolio by ID: one entry per Doing-category workflow state with total/completed/ongoing contribution days and item counts. Optionally filter by date range and a subset of work-item IDs.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties,
+        ...itemIdsProperty
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_portfolio_metrics_cumulativeStateTimeItems",
+    description: "Get the per-item drill-down for ONE state of a portfolio's cumulative time-per-state chart: the work items that contributed to that state, with days contributed. Requires the state name.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...cumulativeStateProperty,
+        ...dateRangeProperties,
+        ...itemIdsProperty
+      },
+      required: ["id", "state"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_portfolio_metrics_cumulativeStateTimeCandidates",
+    description: "List the work items selectable in a portfolio's cumulative time-per-state item picker for the window (the in-scope candidate set). Search keys are referenceId and title.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
   }
 ];
 var encodePayload = (value) => {
@@ -354,6 +520,26 @@ var getDateRange = (argumentsPayload) => {
   }
   return void 0;
 };
+var getStringArgument = (argumentsPayload, key) => {
+  if (!isObjectRecord(argumentsPayload)) {
+    return void 0;
+  }
+  const value = argumentsPayload[key];
+  return typeof value === "string" ? value : void 0;
+};
+var getItemIdsArgument = (argumentsPayload) => {
+  if (!isObjectRecord(argumentsPayload)) {
+    return void 0;
+  }
+  const value = argumentsPayload.itemIds;
+  if (!Array.isArray(value)) {
+    return void 0;
+  }
+  const ids = value.filter(
+    (entry) => typeof entry === "number" && Number.isInteger(entry)
+  );
+  return ids.length > 0 ? ids : void 0;
+};
 var getThroughputFilterView = (argumentsPayload) => {
   if (!isObjectRecord(argumentsPayload)) {
     return void 0;
@@ -369,6 +555,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({}),
@@ -416,12 +618,54 @@ 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()
   }),
   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(),
@@ -437,7 +681,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) => {
@@ -594,6 +838,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) {
@@ -743,6 +1109,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_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_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<{
@@ -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[];
@@ -280,6 +358,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_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_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<{
@@ -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[];
@@ -280,6 +358,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

@@ -39,12 +39,59 @@ var throughputFilterViewProperty = {
     description: `Forecast-filter view (Lighthouse v26.5.24.10+). "filtered" applies the team's exclusion rule to throughput. Omit or "raw" returns unfiltered data.`
   }
 };
+var cumulativeStateProperty = {
+  state: {
+    type: "string",
+    description: "Workflow state name to drill into (must match a bar's state from the cumulativeStateTime response)."
+  }
+};
+var itemIdsProperty = {
+  itemIds: {
+    type: "array",
+    items: { type: "integer" },
+    description: "Optional work-item IDs to narrow the computation to a selected subset; omit for all in-scope items."
+  }
+};
 var forecastFilterOverrideProperty = {
   applyFilterOverride: {
     type: "boolean",
     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",
@@ -222,6 +269,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.",
@@ -277,6 +359,90 @@ var toolDefinitions = [
       ],
       additionalProperties: false
     }
+  },
+  {
+    name: "lighthouse_team_metrics_cumulativeStateTime",
+    description: "Get cumulative time-per-state bar data for a team by ID: one entry per Doing-category workflow state with total/completed/ongoing contribution days and item counts. Optionally filter by date range and a subset of work-item IDs.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties,
+        ...itemIdsProperty
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_team_metrics_cumulativeStateTimeItems",
+    description: "Get the per-item drill-down for ONE state of a team's cumulative time-per-state chart: the work items that contributed to that state, with days contributed. Requires the state name.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...cumulativeStateProperty,
+        ...dateRangeProperties,
+        ...itemIdsProperty
+      },
+      required: ["id", "state"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_team_metrics_cumulativeStateTimeCandidates",
+    description: "List the work items selectable in a team's cumulative time-per-state item picker for the window (the in-scope candidate set). Search keys are referenceId and title.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_portfolio_metrics_cumulativeStateTime",
+    description: "Get cumulative time-per-state bar data for a portfolio by ID: one entry per Doing-category workflow state with total/completed/ongoing contribution days and item counts. Optionally filter by date range and a subset of work-item IDs.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties,
+        ...itemIdsProperty
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_portfolio_metrics_cumulativeStateTimeItems",
+    description: "Get the per-item drill-down for ONE state of a portfolio's cumulative time-per-state chart: the work items that contributed to that state, with days contributed. Requires the state name.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...cumulativeStateProperty,
+        ...dateRangeProperties,
+        ...itemIdsProperty
+      },
+      required: ["id", "state"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_portfolio_metrics_cumulativeStateTimeCandidates",
+    description: "List the work items selectable in a portfolio's cumulative time-per-state item picker for the window (the in-scope candidate set). Search keys are referenceId and title.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
   }
 ];
 var encodePayload = (value) => {
@@ -328,6 +494,26 @@ var getDateRange = (argumentsPayload) => {
   }
   return void 0;
 };
+var getStringArgument = (argumentsPayload, key) => {
+  if (!isObjectRecord(argumentsPayload)) {
+    return void 0;
+  }
+  const value = argumentsPayload[key];
+  return typeof value === "string" ? value : void 0;
+};
+var getItemIdsArgument = (argumentsPayload) => {
+  if (!isObjectRecord(argumentsPayload)) {
+    return void 0;
+  }
+  const value = argumentsPayload.itemIds;
+  if (!Array.isArray(value)) {
+    return void 0;
+  }
+  const ids = value.filter(
+    (entry) => typeof entry === "number" && Number.isInteger(entry)
+  );
+  return ids.length > 0 ? ids : void 0;
+};
 var getThroughputFilterView = (argumentsPayload) => {
   if (!isObjectRecord(argumentsPayload)) {
     return void 0;
@@ -343,6 +529,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({}),
@@ -390,12 +592,54 @@ 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()
   }),
   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(),
@@ -411,7 +655,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) => {
@@ -568,6 +812,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,6 +1083,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.1.0",
+  "version": "1.3.0",
   "description": "Shared MCP semantics for Lighthouse",
   "repository": "https://github.com/LetPeopleWork/lighthouse-clients",
   "type": "module",
@@ -26,7 +26,7 @@
     "@modelcontextprotocol/sdk": "^1.26.0",
     "@toon-format/toon": "^2.1.0",
     "zod": "^3.24.1",
-    "@letpeoplework/lighthouse-client": "1.1.0"
+    "@letpeoplework/lighthouse-client": "1.3.0"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --clean",