@letpeoplework/lighthouse-mcp-core 0.1.0 → 0.3.1

package/dist/index.d.mts

@@ -13,7 +13,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";
+    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.portfolio.metrics.throughput" | "lighthouse.feature.get" | "lighthouse.feature.workitems" | "lighthouse.delivery.list" | "lighthouse.forecast.manual" | "lighthouse.forecast.backtest";
     readonly description: string;
     readonly inputSchema: {
         readonly type: "object";
@@ -116,6 +116,143 @@ type McpRuntimeClient = {
             readonly reason: string;
         };
     }>;
+    readonly getTeamThroughput: (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 getTeamCycleTimePercentiles: (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 getPortfolioThroughput: (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[];
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getFeaturesByReferences: (refs: readonly string[]) => Promise<{
+        readonly ok: true;
+        readonly value: readonly unknown[];
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getFeatureWorkItems: (featureId: number) => Promise<{
+        readonly ok: true;
+        readonly value: readonly unknown[];
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly listDeliveries: (portfolioId: number) => Promise<{
+        readonly ok: true;
+        readonly value: readonly unknown[];
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly createDelivery: (portfolioId: 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 updateDelivery: (deliveryId: 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 deleteDelivery: (deliveryId: 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;
+    }) => Promise<{
+        readonly ok: true;
+        readonly value: unknown;
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly runBacktest: (teamId: number, payload: {
+        readonly startDate: string;
+        readonly endDate: string;
+        readonly historicalStartDate: string;
+        readonly historicalEndDate: string;
+    }) => Promise<{
+        readonly ok: true;
+        readonly value: unknown;
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
 };
 type McpCoreRuntimeDependencies = {
     readonly createClient: () => McpRuntimeClient;

package/dist/index.d.ts

@@ -13,7 +13,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";
+    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.portfolio.metrics.throughput" | "lighthouse.feature.get" | "lighthouse.feature.workitems" | "lighthouse.delivery.list" | "lighthouse.forecast.manual" | "lighthouse.forecast.backtest";
     readonly description: string;
     readonly inputSchema: {
         readonly type: "object";
@@ -116,6 +116,143 @@ type McpRuntimeClient = {
             readonly reason: string;
         };
     }>;
+    readonly getTeamThroughput: (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 getTeamCycleTimePercentiles: (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 getPortfolioThroughput: (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[];
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getFeaturesByReferences: (refs: readonly string[]) => Promise<{
+        readonly ok: true;
+        readonly value: readonly unknown[];
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly getFeatureWorkItems: (featureId: number) => Promise<{
+        readonly ok: true;
+        readonly value: readonly unknown[];
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly listDeliveries: (portfolioId: number) => Promise<{
+        readonly ok: true;
+        readonly value: readonly unknown[];
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly createDelivery: (portfolioId: 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 updateDelivery: (deliveryId: 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 deleteDelivery: (deliveryId: 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;
+    }) => Promise<{
+        readonly ok: true;
+        readonly value: unknown;
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
+    readonly runBacktest: (teamId: number, payload: {
+        readonly startDate: string;
+        readonly endDate: string;
+        readonly historicalStartDate: string;
+        readonly historicalEndDate: string;
+    }) => Promise<{
+        readonly ok: true;
+        readonly value: unknown;
+    } | {
+        readonly ok: false;
+        readonly error: {
+            readonly category: string;
+            readonly reason: string;
+        };
+    }>;
 };
 type McpCoreRuntimeDependencies = {
     readonly createClient: () => McpRuntimeClient;

package/dist/index.js

@@ -119,6 +119,78 @@ var toolDefinitions = [
       properties: {},
       additionalProperties: false
     }
+  },
+  {
+    name: "lighthouse.team.metrics.throughput",
+    description: "Get throughput run-chart data for a team. Requires id. Optional startDate and endDate (ISO date strings, defaults to last 90 days).",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse.team.metrics.cycleTimePercentiles",
+    description: "Get cycle-time percentiles for a team. Requires id. Optional startDate and endDate (ISO date strings, defaults to last 90 days).",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse.portfolio.metrics.throughput",
+    description: "Get throughput run-chart data for a portfolio. Requires id. Optional startDate and endDate (ISO date strings, defaults to last 90 days).",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse.feature.get",
+    description: "Get features by ids (provide ids array) or by reference ids (provide refs array).",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse.feature.workitems",
+    description: "Get work items for a feature. Requires id.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse.delivery.list",
+    description: "List deliveries for a portfolio. Requires id (portfolio id).",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse.forecast.manual",
+    description: "Run a manual forecast for a team. Requires id (team id). Optional remainingItems and targetDate.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse.forecast.backtest",
+    description: "Run a backtest forecast for a team. Requires id, startDate, endDate, historicalStartDate, historicalEndDate.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    }
   }
 ];
 var getSuccessToolResult = (text) => ({
@@ -149,6 +221,20 @@ var getNumericId = (argumentsPayload) => {
   }
   return null;
 };
+var isObjectRecord = (value) => {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+};
+var getDateRange = (argumentsPayload) => {
+  if (!isObjectRecord(argumentsPayload)) {
+    return void 0;
+  }
+  const startDate = argumentsPayload.startDate;
+  const endDate = argumentsPayload.endDate;
+  if (typeof startDate === "string" && typeof endDate === "string") {
+    return { startDate, endDate };
+  }
+  return void 0;
+};
 var createMcpCoreRuntime = (dependencies) => ({
   listTools: () => toolDefinitions,
   callTool: async (name, argumentsPayload) => {
@@ -271,6 +357,171 @@ var createMcpCoreRuntime = (dependencies) => ({
         `portfolio refresh: ${result.error.category} (${result.error.reason})`
       );
     }
+    if (name === "lighthouse.team.metrics.throughput") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("team metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getTeamThroughput(id, range);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `team throughput: ${JSON.stringify(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `team metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse.team.metrics.cycleTimePercentiles") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("team metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getTeamCycleTimePercentiles(id, range);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `team cycleTimePercentiles: ${JSON.stringify(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `team metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse.portfolio.metrics.throughput") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("portfolio metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getPortfolioThroughput(id, range);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `portfolio throughput: ${JSON.stringify(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `portfolio metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse.feature.get") {
+      const payload = isObjectRecord(argumentsPayload) ? argumentsPayload : {};
+      const idsValue = payload.ids;
+      const refsValue = payload.refs;
+      if (Array.isArray(idsValue) && idsValue.length > 0) {
+        const ids = idsValue.filter((v) => typeof v === "number");
+        const result = await client.getFeaturesByIds(ids);
+        if (result.ok) {
+          return getSuccessToolResult(
+            `features: ${JSON.stringify(result.value)}`
+          );
+        }
+        return getErrorToolResult(
+          `features: ${result.error.category} (${result.error.reason})`
+        );
+      }
+      if (Array.isArray(refsValue) && refsValue.length > 0) {
+        const refs = refsValue.filter(
+          (v) => typeof v === "string"
+        );
+        const result = await client.getFeaturesByReferences(refs);
+        if (result.ok) {
+          return getSuccessToolResult(
+            `features: ${JSON.stringify(result.value)}`
+          );
+        }
+        return getErrorToolResult(
+          `features: ${result.error.category} (${result.error.reason})`
+        );
+      }
+      return getErrorToolResult(
+        "features: provide ids (array of numbers) or refs (array of strings)"
+      );
+    }
+    if (name === "lighthouse.feature.workitems") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("feature workitems: invalid id");
+      }
+      const result = await client.getFeatureWorkItems(id);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `feature workitems: ${JSON.stringify(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `feature workitems: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse.delivery.list") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult(
+          "delivery: invalid id (portfolio id required)"
+        );
+      }
+      const result = await client.listDeliveries(id);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `deliveries: ${JSON.stringify(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `delivery: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse.forecast.manual") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("forecast: invalid id (team id required)");
+      }
+      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 result = await client.runManualForecast(id, {
+        remainingItems,
+        targetDate
+      });
+      if (result.ok) {
+        return getSuccessToolResult(
+          `forecast: ${JSON.stringify(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `forecast: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse.forecast.backtest") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("backtest: invalid id (team id required)");
+      }
+      const payload = isObjectRecord(argumentsPayload) ? argumentsPayload : {};
+      const startDate = typeof payload.startDate === "string" ? payload.startDate : void 0;
+      const endDate = typeof payload.endDate === "string" ? payload.endDate : void 0;
+      const historicalStartDate = typeof payload.historicalStartDate === "string" ? payload.historicalStartDate : void 0;
+      const historicalEndDate = typeof payload.historicalEndDate === "string" ? payload.historicalEndDate : void 0;
+      if (!startDate || !endDate || !historicalStartDate || !historicalEndDate) {
+        return getErrorToolResult(
+          "backtest: startDate, endDate, historicalStartDate, and historicalEndDate are required"
+        );
+      }
+      const result = await client.runBacktest(id, {
+        startDate,
+        endDate,
+        historicalStartDate,
+        historicalEndDate
+      });
+      if (result.ok) {
+        return getSuccessToolResult(
+          `backtest: ${JSON.stringify(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `backtest: ${result.error.category} (${result.error.reason})`
+      );
+    }
     return getErrorToolResult(`Unknown tool: ${name}`);
   }
 });

package/dist/index.mjs

@@ -94,6 +94,78 @@ var toolDefinitions = [
       properties: {},
       additionalProperties: false
     }
+  },
+  {
+    name: "lighthouse.team.metrics.throughput",
+    description: "Get throughput run-chart data for a team. Requires id. Optional startDate and endDate (ISO date strings, defaults to last 90 days).",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse.team.metrics.cycleTimePercentiles",
+    description: "Get cycle-time percentiles for a team. Requires id. Optional startDate and endDate (ISO date strings, defaults to last 90 days).",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse.portfolio.metrics.throughput",
+    description: "Get throughput run-chart data for a portfolio. Requires id. Optional startDate and endDate (ISO date strings, defaults to last 90 days).",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse.feature.get",
+    description: "Get features by ids (provide ids array) or by reference ids (provide refs array).",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse.feature.workitems",
+    description: "Get work items for a feature. Requires id.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse.delivery.list",
+    description: "List deliveries for a portfolio. Requires id (portfolio id).",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse.forecast.manual",
+    description: "Run a manual forecast for a team. Requires id (team id). Optional remainingItems and targetDate.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse.forecast.backtest",
+    description: "Run a backtest forecast for a team. Requires id, startDate, endDate, historicalStartDate, historicalEndDate.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    }
   }
 ];
 var getSuccessToolResult = (text) => ({
@@ -124,6 +196,20 @@ var getNumericId = (argumentsPayload) => {
   }
   return null;
 };
+var isObjectRecord = (value) => {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+};
+var getDateRange = (argumentsPayload) => {
+  if (!isObjectRecord(argumentsPayload)) {
+    return void 0;
+  }
+  const startDate = argumentsPayload.startDate;
+  const endDate = argumentsPayload.endDate;
+  if (typeof startDate === "string" && typeof endDate === "string") {
+    return { startDate, endDate };
+  }
+  return void 0;
+};
 var createMcpCoreRuntime = (dependencies) => ({
   listTools: () => toolDefinitions,
   callTool: async (name, argumentsPayload) => {
@@ -246,6 +332,171 @@ var createMcpCoreRuntime = (dependencies) => ({
         `portfolio refresh: ${result.error.category} (${result.error.reason})`
       );
     }
+    if (name === "lighthouse.team.metrics.throughput") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("team metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getTeamThroughput(id, range);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `team throughput: ${JSON.stringify(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `team metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse.team.metrics.cycleTimePercentiles") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("team metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getTeamCycleTimePercentiles(id, range);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `team cycleTimePercentiles: ${JSON.stringify(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `team metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse.portfolio.metrics.throughput") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("portfolio metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getPortfolioThroughput(id, range);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `portfolio throughput: ${JSON.stringify(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `portfolio metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse.feature.get") {
+      const payload = isObjectRecord(argumentsPayload) ? argumentsPayload : {};
+      const idsValue = payload.ids;
+      const refsValue = payload.refs;
+      if (Array.isArray(idsValue) && idsValue.length > 0) {
+        const ids = idsValue.filter((v) => typeof v === "number");
+        const result = await client.getFeaturesByIds(ids);
+        if (result.ok) {
+          return getSuccessToolResult(
+            `features: ${JSON.stringify(result.value)}`
+          );
+        }
+        return getErrorToolResult(
+          `features: ${result.error.category} (${result.error.reason})`
+        );
+      }
+      if (Array.isArray(refsValue) && refsValue.length > 0) {
+        const refs = refsValue.filter(
+          (v) => typeof v === "string"
+        );
+        const result = await client.getFeaturesByReferences(refs);
+        if (result.ok) {
+          return getSuccessToolResult(
+            `features: ${JSON.stringify(result.value)}`
+          );
+        }
+        return getErrorToolResult(
+          `features: ${result.error.category} (${result.error.reason})`
+        );
+      }
+      return getErrorToolResult(
+        "features: provide ids (array of numbers) or refs (array of strings)"
+      );
+    }
+    if (name === "lighthouse.feature.workitems") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("feature workitems: invalid id");
+      }
+      const result = await client.getFeatureWorkItems(id);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `feature workitems: ${JSON.stringify(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `feature workitems: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse.delivery.list") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult(
+          "delivery: invalid id (portfolio id required)"
+        );
+      }
+      const result = await client.listDeliveries(id);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `deliveries: ${JSON.stringify(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `delivery: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse.forecast.manual") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("forecast: invalid id (team id required)");
+      }
+      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 result = await client.runManualForecast(id, {
+        remainingItems,
+        targetDate
+      });
+      if (result.ok) {
+        return getSuccessToolResult(
+          `forecast: ${JSON.stringify(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `forecast: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse.forecast.backtest") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("backtest: invalid id (team id required)");
+      }
+      const payload = isObjectRecord(argumentsPayload) ? argumentsPayload : {};
+      const startDate = typeof payload.startDate === "string" ? payload.startDate : void 0;
+      const endDate = typeof payload.endDate === "string" ? payload.endDate : void 0;
+      const historicalStartDate = typeof payload.historicalStartDate === "string" ? payload.historicalStartDate : void 0;
+      const historicalEndDate = typeof payload.historicalEndDate === "string" ? payload.historicalEndDate : void 0;
+      if (!startDate || !endDate || !historicalStartDate || !historicalEndDate) {
+        return getErrorToolResult(
+          "backtest: startDate, endDate, historicalStartDate, and historicalEndDate are required"
+        );
+      }
+      const result = await client.runBacktest(id, {
+        startDate,
+        endDate,
+        historicalStartDate,
+        historicalEndDate
+      });
+      if (result.ok) {
+        return getSuccessToolResult(
+          `backtest: ${JSON.stringify(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `backtest: ${result.error.category} (${result.error.reason})`
+      );
+    }
     return getErrorToolResult(`Unknown tool: ${name}`);
   }
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letpeoplework/lighthouse-mcp-core",
-  "version": "0.1.0",
+  "version": "0.3.1",
   "description": "Shared MCP semantics for Lighthouse",
   "repository": "https://github.com/LetPeopleWork/lighthouse-clients",
   "main": "dist/index.cjs",
@@ -17,10 +17,12 @@
     "dist"
   ],
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": true,
+    "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@letpeoplework/lighthouse-client": "0.1.0"
+    "@letpeoplework/lighthouse-client": "0.3.1"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --clean",