@letpeoplework/lighthouse-mcp-core 0.7.0 → 1.0.0

package/dist/index.cjs

@@ -148,6 +148,58 @@ var toolDefinitions = [
       additionalProperties: false
     }
   },
+  {
+    name: "lighthouse_team_metrics_workItemAge",
+    description: "Get per-item work item age over time for a team by ID. Returns daily snapshots with each in-progress item's age in days derived from its startedDate. Items without a startedDate are omitted.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_team_metrics_totalWorkItemAge",
+    description: "Get the total (summed) work item age over time for a team by ID. Returns daily totals of all in-progress item ages derived from startedDate. Items without a startedDate are not counted.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_portfolio_metrics_workItemAge",
+    description: "Get per-item work item age over time for a portfolio by ID. Returns daily snapshots with each in-progress item's age in days derived from its startedDate. Items without a startedDate are omitted.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_portfolio_metrics_totalWorkItemAge",
+    description: "Get the total (summed) work item age over time for a portfolio by ID. Returns daily totals of all in-progress item ages derived from startedDate. Items without a startedDate are not counted.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
   {
     name: "lighthouse_feature_get",
     description: "Get feature details by numeric IDs or external reference IDs.",
@@ -308,11 +360,31 @@ var toolInputSchemas = {
     startDate: isoDateStringSchema.optional(),
     endDate: isoDateStringSchema.optional()
   }),
+  lighthouse_team_metrics_workItemAge: import_zod.z.object({
+    id: import_zod.z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional()
+  }),
+  lighthouse_team_metrics_totalWorkItemAge: import_zod.z.object({
+    id: import_zod.z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional()
+  }),
   lighthouse_portfolio_metrics_throughput: import_zod.z.object({
     id: import_zod.z.number().int(),
     startDate: isoDateStringSchema.optional(),
     endDate: isoDateStringSchema.optional()
   }),
+  lighthouse_portfolio_metrics_workItemAge: import_zod.z.object({
+    id: import_zod.z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional()
+  }),
+  lighthouse_portfolio_metrics_totalWorkItemAge: 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()
@@ -504,6 +576,73 @@ var createMcpCoreRuntime = (dependencies) => ({
         `portfolio metrics: ${result.error.category} (${result.error.reason})`
       );
     }
+    if (name === "lighthouse_team_metrics_workItemAge") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("team metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getTeamWorkItemAgeOverTime(id, range);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `team workItemAge: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `team metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_team_metrics_totalWorkItemAge") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("team metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getTeamTotalWorkItemAgeOverTime(id, range);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `team totalWorkItemAge: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `team metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_portfolio_metrics_workItemAge") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("portfolio metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getPortfolioWorkItemAgeOverTime(id, range);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `portfolio workItemAge: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `portfolio metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_portfolio_metrics_totalWorkItemAge") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("portfolio metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getPortfolioTotalWorkItemAgeOverTime(
+        id,
+        range
+      );
+      if (result.ok) {
+        return getSuccessToolResult(
+          `portfolio totalWorkItemAge: ${encodePayload(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;

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_portfolio_metrics_throughput" | "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_feature_get" | "lighthouse_feature_workitems" | "lighthouse_delivery_list" | "lighthouse_forecast_manual" | "lighthouse_forecast_backtest";
     readonly description: string;
     readonly inputSchema: {
         readonly type: "object";
@@ -158,6 +158,58 @@ type McpRuntimeClient = {
             readonly reason: string;
         };
     }>;
+    readonly getTeamWorkItemAgeOverTime: (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 getTeamTotalWorkItemAgeOverTime: (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 getPortfolioWorkItemAgeOverTime: (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 getPortfolioTotalWorkItemAgeOverTime: (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[];

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_portfolio_metrics_throughput" | "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_feature_get" | "lighthouse_feature_workitems" | "lighthouse_delivery_list" | "lighthouse_forecast_manual" | "lighthouse_forecast_backtest";
     readonly description: string;
     readonly inputSchema: {
         readonly type: "object";
@@ -158,6 +158,58 @@ type McpRuntimeClient = {
             readonly reason: string;
         };
     }>;
+    readonly getTeamWorkItemAgeOverTime: (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 getTeamTotalWorkItemAgeOverTime: (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 getPortfolioWorkItemAgeOverTime: (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 getPortfolioTotalWorkItemAgeOverTime: (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[];

package/dist/index.js

@@ -122,6 +122,58 @@ var toolDefinitions = [
       additionalProperties: false
     }
   },
+  {
+    name: "lighthouse_team_metrics_workItemAge",
+    description: "Get per-item work item age over time for a team by ID. Returns daily snapshots with each in-progress item's age in days derived from its startedDate. Items without a startedDate are omitted.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_team_metrics_totalWorkItemAge",
+    description: "Get the total (summed) work item age over time for a team by ID. Returns daily totals of all in-progress item ages derived from startedDate. Items without a startedDate are not counted.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_portfolio_metrics_workItemAge",
+    description: "Get per-item work item age over time for a portfolio by ID. Returns daily snapshots with each in-progress item's age in days derived from its startedDate. Items without a startedDate are omitted.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "lighthouse_portfolio_metrics_totalWorkItemAge",
+    description: "Get the total (summed) work item age over time for a portfolio by ID. Returns daily totals of all in-progress item ages derived from startedDate. Items without a startedDate are not counted.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...idInputSchema.properties,
+        ...dateRangeProperties
+      },
+      required: ["id"],
+      additionalProperties: false
+    }
+  },
   {
     name: "lighthouse_feature_get",
     description: "Get feature details by numeric IDs or external reference IDs.",
@@ -282,11 +334,31 @@ var toolInputSchemas = {
     startDate: isoDateStringSchema.optional(),
     endDate: isoDateStringSchema.optional()
   }),
+  lighthouse_team_metrics_workItemAge: z.object({
+    id: z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional()
+  }),
+  lighthouse_team_metrics_totalWorkItemAge: z.object({
+    id: z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional()
+  }),
   lighthouse_portfolio_metrics_throughput: z.object({
     id: z.number().int(),
     startDate: isoDateStringSchema.optional(),
     endDate: isoDateStringSchema.optional()
   }),
+  lighthouse_portfolio_metrics_workItemAge: z.object({
+    id: z.number().int(),
+    startDate: isoDateStringSchema.optional(),
+    endDate: isoDateStringSchema.optional()
+  }),
+  lighthouse_portfolio_metrics_totalWorkItemAge: 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()
@@ -478,6 +550,73 @@ var createMcpCoreRuntime = (dependencies) => ({
         `portfolio metrics: ${result.error.category} (${result.error.reason})`
       );
     }
+    if (name === "lighthouse_team_metrics_workItemAge") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("team metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getTeamWorkItemAgeOverTime(id, range);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `team workItemAge: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `team metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_team_metrics_totalWorkItemAge") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("team metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getTeamTotalWorkItemAgeOverTime(id, range);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `team totalWorkItemAge: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `team metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_portfolio_metrics_workItemAge") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("portfolio metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getPortfolioWorkItemAgeOverTime(id, range);
+      if (result.ok) {
+        return getSuccessToolResult(
+          `portfolio workItemAge: ${encodePayload(result.value)}`
+        );
+      }
+      return getErrorToolResult(
+        `portfolio metrics: ${result.error.category} (${result.error.reason})`
+      );
+    }
+    if (name === "lighthouse_portfolio_metrics_totalWorkItemAge") {
+      const id = getNumericId(argumentsPayload);
+      if (id === null) {
+        return getErrorToolResult("portfolio metrics: invalid id");
+      }
+      const range = getDateRange(argumentsPayload);
+      const result = await client.getPortfolioTotalWorkItemAgeOverTime(
+        id,
+        range
+      );
+      if (result.ok) {
+        return getSuccessToolResult(
+          `portfolio totalWorkItemAge: ${encodePayload(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;

package/package.json

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