@letpeoplework/lighthouse-mcp-core 1.8.1 → 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",
@@ -561,6 +674,7 @@ const recurringBlackoutRuleProperties = {
 		description: "Human-readable description of the rule."
 	}
 };
+const BEYOND_HORIZON_NOTE = "A forecast percentile with beyondHorizon true lies beyond Lighthouse's simulation horizon of horizonYears years: its expectedDate is only a stand-in, not a forecast, so say \"More than <horizonYears> years\" and never that date. Both fields are absent on an older Lighthouse, whose dates stand as sent.";
 const toolDefinitions = [
 	{
 		name: "lighthouse_health_check",
@@ -690,7 +804,7 @@ const toolDefinitions = [
 	},
 	{
 		name: "lighthouse_portfolio_metrics_blockedCountHistory",
-		description: "Get the blocked-items-over-time trend for a portfolio by ID: how many work items were blocked on each captured day, optionally filtered by start and end dates. No tool reads what is blocked right now for a portfolio: name the command `lh metrics portfolio --metrics wip --id <id>`, whose items each carry isBlocked and, when blocked, a blockedSince timestamp. A second text block, `summary: …`, states the answer as the dashboard does, in the instance's terminology: the heading and its sentence; the first block is the facts, unchanged.",
+		description: "Get the blocked-items-over-time trend for a portfolio by ID: how many work items were blocked on each captured day, optionally filtered by start and end dates. No tool reads what is blocked right now for a portfolio: name the command `lh metrics portfolio --metrics wip --id <id>`, whose items each carry isBlocked and, when blocked, a blockedSince timestamp, and whether Lighthouse marks it stale (isStale) and why (staleReasons), both absent on an older Lighthouse. A second text block, `summary: …`, states the answer as the dashboard does, in the instance's terminology: the heading and its sentence; the first block is the facts, unchanged.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -824,7 +938,7 @@ const toolDefinitions = [
 	},
 	{
 		name: "lighthouse_feature_get",
-		description: "Get feature details by numeric IDs or external reference IDs. A second text block, `summary`, counts them in the instance's terminology; the first block is the facts, unchanged.",
+		description: "Get feature details by numeric IDs or external reference IDs. A second text block, `summary`, counts them in the instance's terminology; the first block is the facts, unchanged. " + BEYOND_HORIZON_NOTE,
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -849,12 +963,12 @@ const toolDefinitions = [
 	},
 	{
 		name: "lighthouse_delivery_list",
-		description: "List deliveries for a portfolio by portfolio ID. The answer holds the running deliveries under `active` and the archived ones under `archived`; a `summary` field counts the running ones in the instance's terminology.",
+		description: "List deliveries for a portfolio by portfolio ID. The answer holds the running deliveries under `active` and the archived ones under `archived`; a `summary` field counts the running ones in the instance's terminology. " + BEYOND_HORIZON_NOTE,
 		inputSchema: idInputSchema
 	},
 	{
 		name: "lighthouse_delivery_metrics",
-		description: "Get a delivery's recorded trend by delivery ID: one row per day with total, done and remaining work, the epic count and the likelihood. Set detail to \"epics\" for the per-epic breakdown and the forecast distribution, which are far larger. Forward-only, so it starts at the first recorded snapshot. `summary` states the delivery and its date as lh heads them, in the instance's terminology: a second text block beside the rows, a field of the detailed payload. Requires Lighthouse newer than v26.5.29.5.",
+		description: "Get a delivery's recorded trend by delivery ID: one row per day with total, done and remaining work, the epic count and the likelihood. Set detail to \"epics\" for the per-epic breakdown and the forecast distribution, which are far larger. Forward-only, so it starts at the first recorded snapshot. `summary` states the delivery and its date as lh heads them, in the instance's terminology: a second text block beside the rows, a field of the detailed payload. Requires Lighthouse newer than v26.5.29.5. " + BEYOND_HORIZON_NOTE,
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -918,7 +1032,7 @@ const toolDefinitions = [
 	},
 	{
 		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. `summary` states the answer as the web does, in the instance's terminology: the heading, then the likelihood sentence when both remaining items and a target date were given.",
+		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. `summary` states the answer as the web does, in the instance's terminology: the heading, then the likelihood sentence when both remaining items and a target date were given. " + BEYOND_HORIZON_NOTE,
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -1058,7 +1172,7 @@ const toolDefinitions = [
 	},
 	{
 		name: "lighthouse_team_metrics_wip",
-		description: "Get what a team has in progress right now by ID: each work item in progress today with its age (workItemAge), state, whether it is blocked (isBlocked) and since when (blockedSince), and its link (url). Use it for what is blocked or aging today; for how many were blocked on past days use lighthouse_team_metrics_blockedCountHistory. A second text block, `summary: …`, states the answer as lh does, in the instance's terminology: the heading, how many are in progress against the System WIP Limit, and how many are blocked; the first block is the facts, unchanged.",
+		description: "Get what a team has in progress right now by ID: each work item in progress today with its age (workItemAge), state, whether it is blocked (isBlocked) and since when (blockedSince), whether Lighthouse marks it stale (isStale) and why (staleReasons: each a kind, TimeInState, BlockedDuration or TimeInStateWhileBlocked, with its days, and the state's stateName on the two time-in-state kinds), and its link (url). isStale and staleReasons are absent on an older Lighthouse, which does not say which work items are stale; never work staleness out yourself. Use it for what is blocked, stale or aging today; for how many were blocked on past days use lighthouse_team_metrics_blockedCountHistory. A second text block, `summary: …`, states the answer as lh does, in the instance's terminology: the heading, how many are in progress against the System WIP Limit, how many are blocked and how many are stale; the first block is the facts, unchanged.",
 		inputSchema: idInputSchema
 	},
 	{
@@ -1075,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;
@@ -1197,7 +1312,8 @@ const summariseCurrentWip = (today) => (facts, known) => {
 	if (now === null) return null;
 	const { terms } = known.wording;
 	const blocked = (0, _letpeoplework_lighthouse_client.describeBlockedNow)(now, "team", terms);
-	return linesOf((0, _letpeoplework_lighthouse_client.describeAsOfHeading)({ endDate: today }, known.wording), sentenceOf((0, _letpeoplework_lighthouse_client.describeInProgressNow)(now, "team", terms, known.systemWipLimit ?? void 0)), blocked === null ? null : sentenceOf(blocked), ...(0, _letpeoplework_lighthouse_client.describeWhatWipLeavesUnsaid)(now, "team", terms, known.systemWipLimit));
+	const stale = (0, _letpeoplework_lighthouse_client.describeStaleNow)(now, "team", terms);
+	return linesOf((0, _letpeoplework_lighthouse_client.describeAsOfHeading)({ endDate: today }, known.wording), sentenceOf((0, _letpeoplework_lighthouse_client.describeInProgressNow)(now, "team", terms, known.systemWipLimit ?? void 0)), blocked === null ? null : sentenceOf(blocked), stale === null ? null : sentenceOf(stale), ...(0, _letpeoplework_lighthouse_client.describeWhatWipLeavesUnsaid)(now, "team", terms, known.systemWipLimit));
 };
 const readTeamForSummary = async (client, teamId) => {
 	const team = client.getTeam(teamId);
@@ -1361,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() }),
@@ -1587,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, 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",
@@ -560,6 +673,7 @@ const recurringBlackoutRuleProperties = {
 		description: "Human-readable description of the rule."
 	}
 };
+const BEYOND_HORIZON_NOTE = "A forecast percentile with beyondHorizon true lies beyond Lighthouse's simulation horizon of horizonYears years: its expectedDate is only a stand-in, not a forecast, so say \"More than <horizonYears> years\" and never that date. Both fields are absent on an older Lighthouse, whose dates stand as sent.";
 const toolDefinitions = [
 	{
 		name: "lighthouse_health_check",
@@ -689,7 +803,7 @@ const toolDefinitions = [
 	},
 	{
 		name: "lighthouse_portfolio_metrics_blockedCountHistory",
-		description: "Get the blocked-items-over-time trend for a portfolio by ID: how many work items were blocked on each captured day, optionally filtered by start and end dates. No tool reads what is blocked right now for a portfolio: name the command `lh metrics portfolio --metrics wip --id <id>`, whose items each carry isBlocked and, when blocked, a blockedSince timestamp. A second text block, `summary: …`, states the answer as the dashboard does, in the instance's terminology: the heading and its sentence; the first block is the facts, unchanged.",
+		description: "Get the blocked-items-over-time trend for a portfolio by ID: how many work items were blocked on each captured day, optionally filtered by start and end dates. No tool reads what is blocked right now for a portfolio: name the command `lh metrics portfolio --metrics wip --id <id>`, whose items each carry isBlocked and, when blocked, a blockedSince timestamp, and whether Lighthouse marks it stale (isStale) and why (staleReasons), both absent on an older Lighthouse. A second text block, `summary: …`, states the answer as the dashboard does, in the instance's terminology: the heading and its sentence; the first block is the facts, unchanged.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -823,7 +937,7 @@ const toolDefinitions = [
 	},
 	{
 		name: "lighthouse_feature_get",
-		description: "Get feature details by numeric IDs or external reference IDs. A second text block, `summary`, counts them in the instance's terminology; the first block is the facts, unchanged.",
+		description: "Get feature details by numeric IDs or external reference IDs. A second text block, `summary`, counts them in the instance's terminology; the first block is the facts, unchanged. " + BEYOND_HORIZON_NOTE,
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -848,12 +962,12 @@ const toolDefinitions = [
 	},
 	{
 		name: "lighthouse_delivery_list",
-		description: "List deliveries for a portfolio by portfolio ID. The answer holds the running deliveries under `active` and the archived ones under `archived`; a `summary` field counts the running ones in the instance's terminology.",
+		description: "List deliveries for a portfolio by portfolio ID. The answer holds the running deliveries under `active` and the archived ones under `archived`; a `summary` field counts the running ones in the instance's terminology. " + BEYOND_HORIZON_NOTE,
 		inputSchema: idInputSchema
 	},
 	{
 		name: "lighthouse_delivery_metrics",
-		description: "Get a delivery's recorded trend by delivery ID: one row per day with total, done and remaining work, the epic count and the likelihood. Set detail to \"epics\" for the per-epic breakdown and the forecast distribution, which are far larger. Forward-only, so it starts at the first recorded snapshot. `summary` states the delivery and its date as lh heads them, in the instance's terminology: a second text block beside the rows, a field of the detailed payload. Requires Lighthouse newer than v26.5.29.5.",
+		description: "Get a delivery's recorded trend by delivery ID: one row per day with total, done and remaining work, the epic count and the likelihood. Set detail to \"epics\" for the per-epic breakdown and the forecast distribution, which are far larger. Forward-only, so it starts at the first recorded snapshot. `summary` states the delivery and its date as lh heads them, in the instance's terminology: a second text block beside the rows, a field of the detailed payload. Requires Lighthouse newer than v26.5.29.5. " + BEYOND_HORIZON_NOTE,
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -917,7 +1031,7 @@ const toolDefinitions = [
 	},
 	{
 		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. `summary` states the answer as the web does, in the instance's terminology: the heading, then the likelihood sentence when both remaining items and a target date were given.",
+		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. `summary` states the answer as the web does, in the instance's terminology: the heading, then the likelihood sentence when both remaining items and a target date were given. " + BEYOND_HORIZON_NOTE,
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -1057,7 +1171,7 @@ const toolDefinitions = [
 	},
 	{
 		name: "lighthouse_team_metrics_wip",
-		description: "Get what a team has in progress right now by ID: each work item in progress today with its age (workItemAge), state, whether it is blocked (isBlocked) and since when (blockedSince), and its link (url). Use it for what is blocked or aging today; for how many were blocked on past days use lighthouse_team_metrics_blockedCountHistory. A second text block, `summary: …`, states the answer as lh does, in the instance's terminology: the heading, how many are in progress against the System WIP Limit, and how many are blocked; the first block is the facts, unchanged.",
+		description: "Get what a team has in progress right now by ID: each work item in progress today with its age (workItemAge), state, whether it is blocked (isBlocked) and since when (blockedSince), whether Lighthouse marks it stale (isStale) and why (staleReasons: each a kind, TimeInState, BlockedDuration or TimeInStateWhileBlocked, with its days, and the state's stateName on the two time-in-state kinds), and its link (url). isStale and staleReasons are absent on an older Lighthouse, which does not say which work items are stale; never work staleness out yourself. Use it for what is blocked, stale or aging today; for how many were blocked on past days use lighthouse_team_metrics_blockedCountHistory. A second text block, `summary: …`, states the answer as lh does, in the instance's terminology: the heading, how many are in progress against the System WIP Limit, how many are blocked and how many are stale; the first block is the facts, unchanged.",
 		inputSchema: idInputSchema
 	},
 	{
@@ -1074,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;
@@ -1196,7 +1311,8 @@ const summariseCurrentWip = (today) => (facts, known) => {
 	if (now === null) return null;
 	const { terms } = known.wording;
 	const blocked = describeBlockedNow(now, "team", terms);
-	return linesOf(describeAsOfHeading({ endDate: today }, known.wording), sentenceOf(describeInProgressNow(now, "team", terms, known.systemWipLimit ?? void 0)), blocked === null ? null : sentenceOf(blocked), ...describeWhatWipLeavesUnsaid(now, "team", terms, known.systemWipLimit));
+	const stale = describeStaleNow(now, "team", terms);
+	return linesOf(describeAsOfHeading({ endDate: today }, known.wording), sentenceOf(describeInProgressNow(now, "team", terms, known.systemWipLimit ?? void 0)), blocked === null ? null : sentenceOf(blocked), stale === null ? null : sentenceOf(stale), ...describeWhatWipLeavesUnsaid(now, "team", terms, known.systemWipLimit));
 };
 const readTeamForSummary = async (client, teamId) => {
 	const team = client.getTeam(teamId);
@@ -1360,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() }),
@@ -1586,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.8.1",
+  "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.10.0",
+    "@letpeoplework/lighthouse-client": "1.12.0",
     "@modelcontextprotocol/sdk": "^1.26.0",
     "@toon-format/toon": "^4.0.0",
     "zod": "^4.0.0"