@letpeoplework/lighthouse-mcp-core 1.9.0 → 1.10.0

package/dist/index.cjs

@@ -426,6 +426,119 @@ const REFINEMENT_TOOLS = /* @__PURE__ */ new Map([
 /** The handler of a refinement tool, or undefined for a tool that is not one. */
 const findRefinementTool = (name) => REFINEMENT_TOOLS.get(name);
 //#endregion
+//#region src/reportTools.ts
+const HOW_LIGHTHOUSE_SHOWS_IT = "Read the lighthouse-reports skill for how Lighthouse shows these values, and quote them as they come.";
+const HOW_THE_ANSWER_READS = "The first block is Lighthouse's answer, unchanged; a second text block, `summary`,";
+const LIST_LABEL = "reports";
+const GET_LABEL = "report";
+const NEEDS_A_SERVER = "Needs a Lighthouse newer than v26.10.10.1.";
+const ownerIdProperty = (kind) => ({
+	type: "integer",
+	description: `The ${kind}'s numeric id.`
+});
+const reportIdProperty = {
+	type: "integer",
+	description: "The report's id, as its owner's report list names it under reports[].id."
+};
+const listInputSchema = (kind) => ({
+	type: "object",
+	properties: { id: ownerIdProperty(kind) },
+	required: ["id"],
+	additionalProperties: false
+});
+const getInputSchema = (kind) => ({
+	type: "object",
+	properties: {
+		id: ownerIdProperty(kind),
+		reportId: reportIdProperty
+	},
+	required: ["id", "reportId"],
+	additionalProperties: false
+});
+const listDescription = (kind) => `List the reports a ${kind} holds by ${kind} ID: each report's id, name, type (templateKey) and when it was created. ${HOW_THE_ANSWER_READS} names the ${kind} and counts its reports in the instance's terminology. ${HOW_LIGHTHOUSE_SHOWS_IT} ${NEEDS_A_SERVER}`;
+const getDescription = (kind) => `Get one of a ${kind}'s reports by ${kind} ID and reportId, exactly as Lighthouse answers it: its Then side as Lighthouse froze it, its Now side read afresh up to today, and every value, a missing value with its reason. ${HOW_LIGHTHOUSE_SHOWS_IT} ${HOW_THE_ANSWER_READS} names the report, its ${kind} and its Then and Now windows. ${NEEDS_A_SERVER}`;
+const reportToolDefinitions = [
+	{
+		name: "lighthouse_team_report_list",
+		description: listDescription("team"),
+		inputSchema: listInputSchema("team")
+	},
+	{
+		name: "lighthouse_team_report_get",
+		description: getDescription("team"),
+		inputSchema: getInputSchema("team")
+	},
+	{
+		name: "lighthouse_portfolio_report_list",
+		description: listDescription("portfolio"),
+		inputSchema: listInputSchema("portfolio")
+	},
+	{
+		name: "lighthouse_portfolio_report_get",
+		description: getDescription("portfolio"),
+		inputSchema: getInputSchema("portfolio")
+	}
+];
+const listSchema = zod.z.object({ id: zod.z.number().int() });
+const getSchema = zod.z.object({
+	id: zod.z.number().int(),
+	reportId: zod.z.number().int()
+});
+const reportInputSchemas = {
+	lighthouse_team_report_list: listSchema,
+	lighthouse_team_report_get: getSchema,
+	lighthouse_portfolio_report_list: listSchema,
+	lighthouse_portfolio_report_get: getSchema
+};
+const getReportId = (argumentsPayload) => {
+	const reportId = typeof argumentsPayload === "object" && argumentsPayload !== null ? argumentsPayload.reportId : void 0;
+	return typeof reportId === "number" && Number.isInteger(reportId) ? reportId : null;
+};
+const answerReportRead = async (client, owner, result, answer) => {
+	if (!result.ok) return getErrorToolResult(`${answer.label}: ${await (0, _letpeoplework_lighthouse_client.readReportRefusal)(client, result.error, owner.kind, answer.read)}`);
+	const ownerName = await (0, _letpeoplework_lighthouse_client.readReportOwner)(client, owner);
+	return withSummaryBlock(`${answer.label}: ${encodePayload(result.value)}`, answer.summarise(result.value, ownerName));
+};
+const invalid = (label, what) => getErrorToolResult(`${label}: invalid ${what}`);
+const reportList = (kind) => async (argumentsPayload, client) => {
+	const id = getNumericId(argumentsPayload);
+	if (id === null) return invalid(LIST_LABEL, "id");
+	const owner = {
+		kind,
+		id
+	};
+	return answerReportRead(client, owner, await (0, _letpeoplework_lighthouse_client.readOwnersReports)(client, owner), {
+		label: LIST_LABEL,
+		read: "list",
+		summarise: _letpeoplework_lighthouse_client.summariseReportList
+	});
+};
+const reportGet = (kind) => async (argumentsPayload, client) => {
+	const id = getNumericId(argumentsPayload);
+	if (id === null) return invalid(GET_LABEL, "id");
+	const reportId = getReportId(argumentsPayload);
+	if (reportId === null) return invalid(GET_LABEL, "reportId");
+	const owner = {
+		kind,
+		id
+	};
+	const result = await (0, _letpeoplework_lighthouse_client.readOwnersReport)(client, owner, reportId);
+	const answered = await answerReportRead(client, owner, result, {
+		label: GET_LABEL,
+		read: "report",
+		summarise: _letpeoplework_lighthouse_client.summariseReport
+	});
+	return countedToolResult(answered, (0, _letpeoplework_lighthouse_client.reportOpenedOccurrencesOf)(result));
+};
+const REPORT_TOOLS = /* @__PURE__ */ new Map([
+	["lighthouse_team_report_list", reportList("team")],
+	["lighthouse_team_report_get", reportGet("team")],
+	["lighthouse_portfolio_report_list", reportList("portfolio")],
+	["lighthouse_portfolio_report_get", reportGet("portfolio")]
+]);
+/** The handler of one of the report tools, or undefined for any other tool. */
+const findReportTool = (name) => REPORT_TOOLS.get(name);
+//#endregion
 //#region src/index.ts
 const getMcpCorePackageContract = () => ({
 	name: "@letpeoplework/lighthouse-mcp-core",
@@ -1076,7 +1189,8 @@ const toolDefinitions = [
 		name: "lighthouse_portfolio_metrics_processBehaviorChart",
 		description: "Get one Process Behaviour Chart of a portfolio by ID, as Lighthouse computes it: its status (and statusReason when it is not Ready), the average and natural process limits, whether a baseline is configured, and every point (xValue, yValue) with the signals Lighthouse found on it (specialCauses: LargeChange, ModerateChange, ModerateShift, SmallShift; None means no signal) and whether it falls on a blackout day (isBlackout). metricType picks the chart: Throughput, Arrivals, Wip, WorkItemAge (the Total Work Item Age chart), CycleTime or FeatureSize. A point is a day, except on CycleTime, which has one point per finished work item, and FeatureSize, which has one per finished feature, each dated when it finished, so several can share a day. Use it for \"is something unusual going on\" and \"did our process change\"; never work a signal out yourself. Optionally filtered by start and end dates. A second text block, `summary: …`, states the answer as lh does, in the instance's terminology: the heading, the chart's title, and each signal with the days it fired, or that there are no signals; the facts are unchanged.",
 		inputSchema: chartInputSchema(processBehaviorMetricTypes)
-	}
+	},
+	...reportToolDefinitions
 ];
 const getDefinitionId = (argumentsPayload) => {
 	if (typeof argumentsPayload !== "object" || argumentsPayload === null || Array.isArray(argumentsPayload)) return;
@@ -1363,6 +1477,7 @@ const toolInputSchemas = {
 	lighthouse_team_refresh: zod.z.object({ id: zod.z.number().int() }),
 	lighthouse_team_refinement_get: zod.z.object({ id: zod.z.number().int() }),
 	...refinementWriteInputSchemas,
+	...reportInputSchemas,
 	lighthouse_portfolio_list: zod.z.object({}),
 	lighthouse_portfolio_get: zod.z.object({ id: zod.z.number().int() }),
 	lighthouse_portfolio_refresh: zod.z.object({ id: zod.z.number().int() }),
@@ -1589,6 +1704,8 @@ const answerToolCall = (dependencies) => async (name, argumentsPayload) => {
 	}
 	const refinementTool = findRefinementTool(name);
 	if (refinementTool !== void 0) return refinementTool(argumentsPayload, client, dependencies);
+	const reportTool = findReportTool(name);
+	if (reportTool !== void 0) return reportTool(argumentsPayload, client);
 	if (name === "lighthouse_portfolio_list") return answerOwnerList("portfolio", "portfolios", client.listPortfolios(), client);
 	if (name === "lighthouse_portfolio_get") {
 		const id = getNumericId(argumentsPayload);

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { DeliveryMetricsHistory, LighthouseApiResult, LighthouseClient, LighthouseVoterKeyStore, PortfolioDeliveries, RefinementMomentFacts, RefinementWordingSource, TeamRefinement, UsageDataOccurrence, UsageDataQuestionAnswer, UsageDataStep, VotedRow } from "@letpeoplework/lighthouse-client";
+import { DeliveryMetricsHistory, LighthouseApiResult, LighthouseClient, LighthouseVoterKeyStore, PortfolioDeliveries, RefinementMomentFacts, RefinementWordingSource, ReportOwnerSource, ReportReads, TeamRefinement, UsageDataOccurrence, UsageDataQuestionAnswer, UsageDataStep, VotedRow } from "@letpeoplework/lighthouse-client";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import "zod";
 import { ElicitRequestFormParams, ElicitResult } from "@modelcontextprotocol/sdk/types.js";
@@ -75,6 +75,9 @@ type ToolError = {
 };
 type RefinementToolClient = RefinementWordingSource<ToolError> & Pick<LighthouseClient, "getTeamRefinement" | "castRefinementVote" | "addRefinementComment" | "takeBackRefinementVote" | "getRefinementLog" | "getTerminology">;
 //#endregion
+//#region src/reportTools.d.ts
+type ReportToolClient = ReportReads & ReportOwnerSource;
+//#endregion
 //#region src/index.d.ts
 export type McpCorePackageContract = {
   readonly name: "@letpeoplework/lighthouse-mcp-core";
@@ -83,7 +86,7 @@ export type McpCorePackageContract = {
 };
 export declare const getMcpCorePackageContract: () => McpCorePackageContract;
 export 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_team_refinement_get" | "lighthouse_team_refinement_vote" | "lighthouse_team_refinement_comment" | "lighthouse_team_refinement_voteTakeBack" | "lighthouse_portfolio_list" | "lighthouse_portfolio_get" | "lighthouse_portfolio_refresh" | "lighthouse_team_metrics_throughput" | "lighthouse_team_metrics_cycleTimePercentiles" | "lighthouse_team_metrics_workItemAgePercentiles" | "lighthouse_portfolio_metrics_workItemAgePercentiles" | "lighthouse_team_metrics_workItemAge" | "lighthouse_team_metrics_totalWorkItemAge" | "lighthouse_portfolio_metrics_throughput" | "lighthouse_portfolio_metrics_workItemAge" | "lighthouse_portfolio_metrics_totalWorkItemAge" | "lighthouse_team_metrics_blockedCountHistory" | "lighthouse_portfolio_metrics_blockedCountHistory" | "lighthouse_team_metrics_wip" | "lighthouse_team_metrics_sleRisk" | "lighthouse_team_metrics_processBehaviorChart" | "lighthouse_portfolio_metrics_processBehaviorChart" | "lighthouse_team_metrics_percentilesOverTime" | "lighthouse_portfolio_metrics_percentilesOverTime" | "lighthouse_team_metrics_processBehaviorOverTime" | "lighthouse_portfolio_metrics_processBehaviorOverTime" | "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_delivery_metrics" | "lighthouse_blackout_list" | "lighthouse_blackout_create" | "lighthouse_blackout_update" | "lighthouse_blackout_delete" | "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_team_refinement_get" | "lighthouse_team_refinement_vote" | "lighthouse_team_refinement_comment" | "lighthouse_team_refinement_voteTakeBack" | "lighthouse_portfolio_list" | "lighthouse_portfolio_get" | "lighthouse_portfolio_refresh" | "lighthouse_team_metrics_throughput" | "lighthouse_team_metrics_cycleTimePercentiles" | "lighthouse_team_metrics_workItemAgePercentiles" | "lighthouse_portfolio_metrics_workItemAgePercentiles" | "lighthouse_team_metrics_workItemAge" | "lighthouse_team_metrics_totalWorkItemAge" | "lighthouse_portfolio_metrics_throughput" | "lighthouse_portfolio_metrics_workItemAge" | "lighthouse_portfolio_metrics_totalWorkItemAge" | "lighthouse_team_metrics_blockedCountHistory" | "lighthouse_portfolio_metrics_blockedCountHistory" | "lighthouse_team_metrics_wip" | "lighthouse_team_metrics_sleRisk" | "lighthouse_team_metrics_processBehaviorChart" | "lighthouse_portfolio_metrics_processBehaviorChart" | "lighthouse_team_metrics_percentilesOverTime" | "lighthouse_portfolio_metrics_percentilesOverTime" | "lighthouse_team_metrics_processBehaviorOverTime" | "lighthouse_portfolio_metrics_processBehaviorOverTime" | "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_delivery_metrics" | "lighthouse_blackout_list" | "lighthouse_blackout_create" | "lighthouse_blackout_update" | "lighthouse_blackout_delete" | "lighthouse_forecast_manual" | "lighthouse_forecast_backtest" | "lighthouse_team_report_list" | "lighthouse_team_report_get" | "lighthouse_portfolio_report_list" | "lighthouse_portfolio_report_get";
   readonly description: string;
   readonly inputSchema: {
     readonly type: "object";
@@ -669,7 +672,7 @@ type McpRuntimeClient = {
       readonly reason: string;
     };
   }>;
-} & Omit<RefinementToolClient, "getTeam">;
+} & Omit<RefinementToolClient, "getTeam"> & Omit<ReportToolClient, "getTeam" | "getPortfolio">;
 export type McpCoreRuntimeDependencies = {
   readonly createClient: () => McpRuntimeClient;
   /** Where usage data goes; without it a tool call does exactly what it always did. */

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { DeliveryMetricsHistory, LighthouseApiResult, LighthouseClient, LighthouseVoterKeyStore, PortfolioDeliveries, RefinementMomentFacts, RefinementWordingSource, TeamRefinement, UsageDataOccurrence, UsageDataQuestionAnswer, UsageDataStep, VotedRow } from "@letpeoplework/lighthouse-client";
+import { DeliveryMetricsHistory, LighthouseApiResult, LighthouseClient, LighthouseVoterKeyStore, PortfolioDeliveries, RefinementMomentFacts, RefinementWordingSource, ReportOwnerSource, ReportReads, TeamRefinement, UsageDataOccurrence, UsageDataQuestionAnswer, UsageDataStep, VotedRow } from "@letpeoplework/lighthouse-client";
 import { ElicitRequestFormParams, ElicitResult } from "@modelcontextprotocol/sdk/types.js";
 import { z } from "zod";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -75,6 +75,9 @@ type ToolError = {
 };
 type RefinementToolClient = RefinementWordingSource<ToolError> & Pick<LighthouseClient, "getTeamRefinement" | "castRefinementVote" | "addRefinementComment" | "takeBackRefinementVote" | "getRefinementLog" | "getTerminology">;
 //#endregion
+//#region src/reportTools.d.ts
+type ReportToolClient = ReportReads & ReportOwnerSource;
+//#endregion
 //#region src/index.d.ts
 export type McpCorePackageContract = {
   readonly name: "@letpeoplework/lighthouse-mcp-core";
@@ -83,7 +86,7 @@ export type McpCorePackageContract = {
 };
 export declare const getMcpCorePackageContract: () => McpCorePackageContract;
 export 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_team_refinement_get" | "lighthouse_team_refinement_vote" | "lighthouse_team_refinement_comment" | "lighthouse_team_refinement_voteTakeBack" | "lighthouse_portfolio_list" | "lighthouse_portfolio_get" | "lighthouse_portfolio_refresh" | "lighthouse_team_metrics_throughput" | "lighthouse_team_metrics_cycleTimePercentiles" | "lighthouse_team_metrics_workItemAgePercentiles" | "lighthouse_portfolio_metrics_workItemAgePercentiles" | "lighthouse_team_metrics_workItemAge" | "lighthouse_team_metrics_totalWorkItemAge" | "lighthouse_portfolio_metrics_throughput" | "lighthouse_portfolio_metrics_workItemAge" | "lighthouse_portfolio_metrics_totalWorkItemAge" | "lighthouse_team_metrics_blockedCountHistory" | "lighthouse_portfolio_metrics_blockedCountHistory" | "lighthouse_team_metrics_wip" | "lighthouse_team_metrics_sleRisk" | "lighthouse_team_metrics_processBehaviorChart" | "lighthouse_portfolio_metrics_processBehaviorChart" | "lighthouse_team_metrics_percentilesOverTime" | "lighthouse_portfolio_metrics_percentilesOverTime" | "lighthouse_team_metrics_processBehaviorOverTime" | "lighthouse_portfolio_metrics_processBehaviorOverTime" | "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_delivery_metrics" | "lighthouse_blackout_list" | "lighthouse_blackout_create" | "lighthouse_blackout_update" | "lighthouse_blackout_delete" | "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_team_refinement_get" | "lighthouse_team_refinement_vote" | "lighthouse_team_refinement_comment" | "lighthouse_team_refinement_voteTakeBack" | "lighthouse_portfolio_list" | "lighthouse_portfolio_get" | "lighthouse_portfolio_refresh" | "lighthouse_team_metrics_throughput" | "lighthouse_team_metrics_cycleTimePercentiles" | "lighthouse_team_metrics_workItemAgePercentiles" | "lighthouse_portfolio_metrics_workItemAgePercentiles" | "lighthouse_team_metrics_workItemAge" | "lighthouse_team_metrics_totalWorkItemAge" | "lighthouse_portfolio_metrics_throughput" | "lighthouse_portfolio_metrics_workItemAge" | "lighthouse_portfolio_metrics_totalWorkItemAge" | "lighthouse_team_metrics_blockedCountHistory" | "lighthouse_portfolio_metrics_blockedCountHistory" | "lighthouse_team_metrics_wip" | "lighthouse_team_metrics_sleRisk" | "lighthouse_team_metrics_processBehaviorChart" | "lighthouse_portfolio_metrics_processBehaviorChart" | "lighthouse_team_metrics_percentilesOverTime" | "lighthouse_portfolio_metrics_percentilesOverTime" | "lighthouse_team_metrics_processBehaviorOverTime" | "lighthouse_portfolio_metrics_processBehaviorOverTime" | "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_delivery_metrics" | "lighthouse_blackout_list" | "lighthouse_blackout_create" | "lighthouse_blackout_update" | "lighthouse_blackout_delete" | "lighthouse_forecast_manual" | "lighthouse_forecast_backtest" | "lighthouse_team_report_list" | "lighthouse_team_report_get" | "lighthouse_portfolio_report_list" | "lighthouse_portfolio_report_get";
   readonly description: string;
   readonly inputSchema: {
     readonly type: "object";
@@ -669,7 +672,7 @@ type McpRuntimeClient = {
       readonly reason: string;
     };
   }>;
-} & Omit<RefinementToolClient, "getTeam">;
+} & Omit<RefinementToolClient, "getTeam"> & Omit<ReportToolClient, "getTeam" | "getPortfolio">;
 export type McpCoreRuntimeDependencies = {
   readonly createClient: () => McpRuntimeClient;
   /** Where usage data goes; without it a tool call does exactly what it always did. */

package/dist/index.js

@@ -1,4 +1,4 @@
-import { LIGHTHOUSE_IS_REACHABLE, REFINEMENT_ANSWERS, describeAsOfHeading, describeBacktestActual, describeBacktestPeriod, describeBacktestSummary, describeBlackoutRuleCount, describeBlackoutRuleWriteConfirmation, describeBlockedDays, describeBlockedNow, describeConnectionSummary, describeCycleTimeDays, describeDeliveryCount, describeDeliveryMetricsHeading, describeFeatureListCount, describeFeatureWorkItemsHeading, describeInProgressNow, describeManualForecastLikelihood, describeManualForecastSummary, describeMetricSummary, describeMetricsHeading, describeMissingCondition, describeNothingToTakeBack, describeOwnerCount, describePercentilesOverTimeDays, describePortfolioSummary, describeProcessBehaviorChart, describeProcessBehaviorOverTimeDays, describeRecordedComment, describeRecordedVote, describeRefinementSummary, describeRefreshConfirmation, describeSleRiskNow, describeStaleNow, describeTakenBack, describeTeamSummary, describeThroughputDays, describeTimeInStateContributorDays, describeTimeInStateDays, describeTotalWorkItemAgeDays, describeVersion, describeWhatWipLeavesUnsaid, describeWorkItemAgeDays, describeWorkItemAgePercentiles, describeWorkTrackingSystemCount, getDefaultMetricsDateRange, isMissingItsCondition, isRefinementAnswer, keepVoterKey, myVoteOn, readAnswerWording, readBacktest, readBlackoutRules, readBlocked, readCycleTimeDefinitionName, readCycleTimePercentiles, readDeliveryMetricsHistory, readFeatureList, readFeatureWording, readFeatureWorkItems, readInProgressItems, readManualForecast, readNameOfMyVote, readOwnerList, readPercentilesOverTime, readPortfolio, readPortfolioDeliveries, readProcessBehaviorChart, readProcessBehaviorOverTime, readRefinementWording, readRunChart, readServiceLevelExpectation, readSleRisk, readSystemWipLimit, readTeam, readTerms, readTimeInStateBar, readTimeInStateContributors, readTotalWorkItemAge, readVoteRefusal, readWorkItemAge, readWorkItemAgePercentiles, readWorkTrackingConnections, readWrittenBlackoutRule, refinementDayVerdictOf, sizingMomentOf, summariseDeliveryMetricsHistory } from "@letpeoplework/lighthouse-client";
+import { LIGHTHOUSE_IS_REACHABLE, REFINEMENT_ANSWERS, describeAsOfHeading, describeBacktestActual, describeBacktestPeriod, describeBacktestSummary, describeBlackoutRuleCount, describeBlackoutRuleWriteConfirmation, describeBlockedDays, describeBlockedNow, describeConnectionSummary, describeCycleTimeDays, describeDeliveryCount, describeDeliveryMetricsHeading, describeFeatureListCount, describeFeatureWorkItemsHeading, describeInProgressNow, describeManualForecastLikelihood, describeManualForecastSummary, describeMetricSummary, describeMetricsHeading, describeMissingCondition, describeNothingToTakeBack, describeOwnerCount, describePercentilesOverTimeDays, describePortfolioSummary, describeProcessBehaviorChart, describeProcessBehaviorOverTimeDays, describeRecordedComment, describeRecordedVote, describeRefinementSummary, describeRefreshConfirmation, describeSleRiskNow, describeStaleNow, describeTakenBack, describeTeamSummary, describeThroughputDays, describeTimeInStateContributorDays, describeTimeInStateDays, describeTotalWorkItemAgeDays, describeVersion, describeWhatWipLeavesUnsaid, describeWorkItemAgeDays, describeWorkItemAgePercentiles, describeWorkTrackingSystemCount, getDefaultMetricsDateRange, isMissingItsCondition, isRefinementAnswer, keepVoterKey, myVoteOn, readAnswerWording, readBacktest, readBlackoutRules, readBlocked, readCycleTimeDefinitionName, readCycleTimePercentiles, readDeliveryMetricsHistory, readFeatureList, readFeatureWording, readFeatureWorkItems, readInProgressItems, readManualForecast, readNameOfMyVote, readOwnerList, readOwnersReport, readOwnersReports, readPercentilesOverTime, readPortfolio, readPortfolioDeliveries, readProcessBehaviorChart, readProcessBehaviorOverTime, readRefinementWording, readReportOwner, readReportRefusal, readRunChart, readServiceLevelExpectation, readSleRisk, readSystemWipLimit, readTeam, readTerms, readTimeInStateBar, readTimeInStateContributors, readTotalWorkItemAge, readVoteRefusal, readWorkItemAge, readWorkItemAgePercentiles, readWorkTrackingConnections, readWrittenBlackoutRule, refinementDayVerdictOf, reportOpenedOccurrencesOf, sizingMomentOf, summariseDeliveryMetricsHistory, summariseReport, summariseReportList } from "@letpeoplework/lighthouse-client";
 import { ElicitResultSchema } from "@modelcontextprotocol/sdk/types.js";
 import { z } from "zod";
 import { encode } from "@toon-format/toon";
@@ -425,6 +425,119 @@ const REFINEMENT_TOOLS = /* @__PURE__ */ new Map([
 /** The handler of a refinement tool, or undefined for a tool that is not one. */
 const findRefinementTool = (name) => REFINEMENT_TOOLS.get(name);
 //#endregion
+//#region src/reportTools.ts
+const HOW_LIGHTHOUSE_SHOWS_IT = "Read the lighthouse-reports skill for how Lighthouse shows these values, and quote them as they come.";
+const HOW_THE_ANSWER_READS = "The first block is Lighthouse's answer, unchanged; a second text block, `summary`,";
+const LIST_LABEL = "reports";
+const GET_LABEL = "report";
+const NEEDS_A_SERVER = "Needs a Lighthouse newer than v26.10.10.1.";
+const ownerIdProperty = (kind) => ({
+	type: "integer",
+	description: `The ${kind}'s numeric id.`
+});
+const reportIdProperty = {
+	type: "integer",
+	description: "The report's id, as its owner's report list names it under reports[].id."
+};
+const listInputSchema = (kind) => ({
+	type: "object",
+	properties: { id: ownerIdProperty(kind) },
+	required: ["id"],
+	additionalProperties: false
+});
+const getInputSchema = (kind) => ({
+	type: "object",
+	properties: {
+		id: ownerIdProperty(kind),
+		reportId: reportIdProperty
+	},
+	required: ["id", "reportId"],
+	additionalProperties: false
+});
+const listDescription = (kind) => `List the reports a ${kind} holds by ${kind} ID: each report's id, name, type (templateKey) and when it was created. ${HOW_THE_ANSWER_READS} names the ${kind} and counts its reports in the instance's terminology. ${HOW_LIGHTHOUSE_SHOWS_IT} ${NEEDS_A_SERVER}`;
+const getDescription = (kind) => `Get one of a ${kind}'s reports by ${kind} ID and reportId, exactly as Lighthouse answers it: its Then side as Lighthouse froze it, its Now side read afresh up to today, and every value, a missing value with its reason. ${HOW_LIGHTHOUSE_SHOWS_IT} ${HOW_THE_ANSWER_READS} names the report, its ${kind} and its Then and Now windows. ${NEEDS_A_SERVER}`;
+const reportToolDefinitions = [
+	{
+		name: "lighthouse_team_report_list",
+		description: listDescription("team"),
+		inputSchema: listInputSchema("team")
+	},
+	{
+		name: "lighthouse_team_report_get",
+		description: getDescription("team"),
+		inputSchema: getInputSchema("team")
+	},
+	{
+		name: "lighthouse_portfolio_report_list",
+		description: listDescription("portfolio"),
+		inputSchema: listInputSchema("portfolio")
+	},
+	{
+		name: "lighthouse_portfolio_report_get",
+		description: getDescription("portfolio"),
+		inputSchema: getInputSchema("portfolio")
+	}
+];
+const listSchema = z.object({ id: z.number().int() });
+const getSchema = z.object({
+	id: z.number().int(),
+	reportId: z.number().int()
+});
+const reportInputSchemas = {
+	lighthouse_team_report_list: listSchema,
+	lighthouse_team_report_get: getSchema,
+	lighthouse_portfolio_report_list: listSchema,
+	lighthouse_portfolio_report_get: getSchema
+};
+const getReportId = (argumentsPayload) => {
+	const reportId = typeof argumentsPayload === "object" && argumentsPayload !== null ? argumentsPayload.reportId : void 0;
+	return typeof reportId === "number" && Number.isInteger(reportId) ? reportId : null;
+};
+const answerReportRead = async (client, owner, result, answer) => {
+	if (!result.ok) return getErrorToolResult(`${answer.label}: ${await readReportRefusal(client, result.error, owner.kind, answer.read)}`);
+	const ownerName = await readReportOwner(client, owner);
+	return withSummaryBlock(`${answer.label}: ${encodePayload(result.value)}`, answer.summarise(result.value, ownerName));
+};
+const invalid = (label, what) => getErrorToolResult(`${label}: invalid ${what}`);
+const reportList = (kind) => async (argumentsPayload, client) => {
+	const id = getNumericId(argumentsPayload);
+	if (id === null) return invalid(LIST_LABEL, "id");
+	const owner = {
+		kind,
+		id
+	};
+	return answerReportRead(client, owner, await readOwnersReports(client, owner), {
+		label: LIST_LABEL,
+		read: "list",
+		summarise: summariseReportList
+	});
+};
+const reportGet = (kind) => async (argumentsPayload, client) => {
+	const id = getNumericId(argumentsPayload);
+	if (id === null) return invalid(GET_LABEL, "id");
+	const reportId = getReportId(argumentsPayload);
+	if (reportId === null) return invalid(GET_LABEL, "reportId");
+	const owner = {
+		kind,
+		id
+	};
+	const result = await readOwnersReport(client, owner, reportId);
+	const answered = await answerReportRead(client, owner, result, {
+		label: GET_LABEL,
+		read: "report",
+		summarise: summariseReport
+	});
+	return countedToolResult(answered, reportOpenedOccurrencesOf(result));
+};
+const REPORT_TOOLS = /* @__PURE__ */ new Map([
+	["lighthouse_team_report_list", reportList("team")],
+	["lighthouse_team_report_get", reportGet("team")],
+	["lighthouse_portfolio_report_list", reportList("portfolio")],
+	["lighthouse_portfolio_report_get", reportGet("portfolio")]
+]);
+/** The handler of one of the report tools, or undefined for any other tool. */
+const findReportTool = (name) => REPORT_TOOLS.get(name);
+//#endregion
 //#region src/index.ts
 const getMcpCorePackageContract = () => ({
 	name: "@letpeoplework/lighthouse-mcp-core",
@@ -1075,7 +1188,8 @@ const toolDefinitions = [
 		name: "lighthouse_portfolio_metrics_processBehaviorChart",
 		description: "Get one Process Behaviour Chart of a portfolio by ID, as Lighthouse computes it: its status (and statusReason when it is not Ready), the average and natural process limits, whether a baseline is configured, and every point (xValue, yValue) with the signals Lighthouse found on it (specialCauses: LargeChange, ModerateChange, ModerateShift, SmallShift; None means no signal) and whether it falls on a blackout day (isBlackout). metricType picks the chart: Throughput, Arrivals, Wip, WorkItemAge (the Total Work Item Age chart), CycleTime or FeatureSize. A point is a day, except on CycleTime, which has one point per finished work item, and FeatureSize, which has one per finished feature, each dated when it finished, so several can share a day. Use it for \"is something unusual going on\" and \"did our process change\"; never work a signal out yourself. Optionally filtered by start and end dates. A second text block, `summary: …`, states the answer as lh does, in the instance's terminology: the heading, the chart's title, and each signal with the days it fired, or that there are no signals; the facts are unchanged.",
 		inputSchema: chartInputSchema(processBehaviorMetricTypes)
-	}
+	},
+	...reportToolDefinitions
 ];
 const getDefinitionId = (argumentsPayload) => {
 	if (typeof argumentsPayload !== "object" || argumentsPayload === null || Array.isArray(argumentsPayload)) return;
@@ -1362,6 +1476,7 @@ const toolInputSchemas = {
 	lighthouse_team_refresh: z.object({ id: z.number().int() }),
 	lighthouse_team_refinement_get: z.object({ id: z.number().int() }),
 	...refinementWriteInputSchemas,
+	...reportInputSchemas,
 	lighthouse_portfolio_list: z.object({}),
 	lighthouse_portfolio_get: z.object({ id: z.number().int() }),
 	lighthouse_portfolio_refresh: z.object({ id: z.number().int() }),
@@ -1588,6 +1703,8 @@ const answerToolCall = (dependencies) => async (name, argumentsPayload) => {
 	}
 	const refinementTool = findRefinementTool(name);
 	if (refinementTool !== void 0) return refinementTool(argumentsPayload, client, dependencies);
+	const reportTool = findReportTool(name);
+	if (reportTool !== void 0) return reportTool(argumentsPayload, client);
 	if (name === "lighthouse_portfolio_list") return answerOwnerList("portfolio", "portfolios", client.listPortfolios(), client);
 	if (name === "lighthouse_portfolio_get") {
 		const id = getNumericId(argumentsPayload);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letpeoplework/lighthouse-mcp-core",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "Shared MCP semantics for Lighthouse",
   "repository": {
     "type": "git",
@@ -26,7 +26,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@letpeoplework/lighthouse-client": "1.11.0",
+    "@letpeoplework/lighthouse-client": "1.12.0",
     "@modelcontextprotocol/sdk": "^1.26.0",
     "@toon-format/toon": "^4.0.0",
     "zod": "^4.0.0"