@letpeoplework/lighthouse-client 1.10.0 → 1.11.0

package/dist/index.cjs

@@ -242,13 +242,26 @@ const textOf = (value) => typeof value === "string" && value.length > 0 ? value
 const isDay = (value) => isText(value) && formatCalendarDay(value) !== null;
 /** The calendar day as a person reads it, or the text exactly as sent when it is not one. */
 const dayOf = (wire) => formatCalendarDay(wire) ?? wire;
-/** The date a list of chances gives for one probability, or undefined when it holds none for it. */
-const expectedDateAt = (chances, probability) => {
+/** The chance a list gives for one probability, or undefined when it holds none for it. */
+const chanceAt = (chances, probability) => {
 	if (!Array.isArray(chances)) return;
 	const chance = chances.find((entry) => isRecord(entry) && entry.probability === probability);
-	return isRecord(chance) ? textOf(chance.expectedDate) : void 0;
+	return isRecord(chance) ? chance : void 0;
 };
 //#endregion
+//#region src/forecastPercentileText.ts
+/**
+* The years of the horizon a percentile lies beyond, or undefined when its date is the forecast. Keyed on
+* the flag itself, never on the server's version: an older Lighthouse never sends it.
+*/
+const yearsBeyondHorizon = (percentile) => isRecord(percentile) && percentile.beyondHorizon === true && isNumber(percentile.horizonYears) ? percentile.horizonYears : void 0;
+/** The words shown in place of a date for a percentile too few simulated runs reached. */
+const moreThanYearsText = (horizonYears) => `More than ${horizonYears} years`;
+/** A percentile's day as a person reads it, or "More than 5 years" when it lies beyond that horizon. */
+const describePercentileDay = (expectedDate, horizonYearsBeyond) => horizonYearsBeyond === void 0 ? dayOf(expectedDate) : moreThanYearsText(horizonYearsBeyond);
+/** One percentile as text: its day, or the words when it lies beyond the horizon. */
+const describePercentileDate = (percentile) => describePercentileDay(percentile.expectedDate, yearsBeyondHorizon(percentile));
+//#endregion
 //#region src/ownerWording.ts
 /** A mark for a cell Lighthouse sent nothing for. */
 const NOT_SENT = "—";
@@ -408,9 +421,11 @@ const startOf = (value) => {
 		observedOn: void 0,
 		likelyBy: void 0
 	};
+	const chance = chanceAt(value.percentiles, LISTED_CHANCE$1);
 	return {
 		observedOn: value.source === "Observed" ? textOf(value.observedDate) : void 0,
-		likelyBy: expectedDateAt(value.percentiles, LISTED_CHANCE$1)
+		likelyBy: textOf(chance?.expectedDate),
+		likelyByBeyondHorizonYears: yearsBeyondHorizon(chance)
 	};
 };
 const readFeatureListItem = (value) => {
@@ -420,6 +435,7 @@ const readFeatureListItem = (value) => {
 	const state = textOf(value.state);
 	const totalWork = workOf(value.totalWork);
 	const remainingWork = workOf(value.remainingWork);
+	const completion = chanceAt(value.forecasts, LISTED_CHANCE$1);
 	if (referenceId === void 0 || name === void 0 || state === void 0 || totalWork === null || remainingWork === null) return null;
 	return {
 		referenceId,
@@ -429,7 +445,8 @@ const readFeatureListItem = (value) => {
 		remainingWork,
 		cannotBeForecast: Array.isArray(value.teamsWithoutForecast) && value.teamsWithoutForecast.length > 0,
 		start: startOf(value.startForecast),
-		likelyBy: expectedDateAt(value.forecasts, LISTED_CHANCE$1)
+		likelyBy: textOf(completion?.expectedDate),
+		likelyByBeyondHorizonYears: yearsBeyondHorizon(completion)
 	};
 };
 /**
@@ -465,12 +482,15 @@ const describeFeatureProgress = (feature, terms) => `${feature.totalWork - featu
 const describeFeatureStart = (feature) => {
 	if (feature.start.observedOn !== void 0) return dayOf(feature.start.observedOn);
 	if (feature.cannotBeForecast) return CANNOT_FORECAST_SHORT;
-	return feature.start.likelyBy === void 0 ? "—" : dayOf(feature.start.likelyBy);
+	return feature.start.likelyBy === void 0 ? "—" : describePercentileDay(feature.start.likelyBy, feature.start.likelyByBeyondHorizonYears);
 };
-/** The day the Feature is 85% likely to be done by, "Cannot forecast", or the mark when none was sent. */
+/**
+* The day the Feature is 85% likely to be done by, "More than 5 years" when that lies beyond the simulation
+* horizon, "Cannot forecast", or the mark when none was sent.
+*/
 const describeFeatureCompletion = (feature) => {
 	if (feature.cannotBeForecast) return CANNOT_FORECAST_SHORT;
-	return feature.likelyBy === void 0 ? "—" : dayOf(feature.likelyBy);
+	return feature.likelyBy === void 0 ? "—" : describePercentileDay(feature.likelyBy, feature.likelyByBeyondHorizonYears);
 };
 /** One Feature as a row of the list, in the order of its headings. */
 const describeFeatureRow = (feature, terms) => [
@@ -633,6 +653,7 @@ const readDeliveryListItem = (value) => {
 	const name = textOf(value.name);
 	const date = textOf(value.date);
 	if (name === void 0 || date === void 0) return null;
+	const likely = chanceAt(value.completionDates, LISTED_CHANCE);
 	return {
 		id: value.id,
 		name,
@@ -644,7 +665,8 @@ const readDeliveryListItem = (value) => {
 		cannotBeForecast: teamsWithoutForecastIn(value),
 		hasSufficientData: flagOf(value.hasSufficientData),
 		isOverdue: flagOf(value.isOverdue),
-		likelyBy: expectedDateAt(value.completionDates, LISTED_CHANCE)
+		likelyBy: textOf(likely?.expectedDate),
+		likelyByBeyondHorizonYears: yearsBeyondHorizon(likely)
 	};
 };
 /**
@@ -728,7 +750,7 @@ const describeDeliveryRow = (delivery, terms) => [
 	delivery.featureCount === void 0 ? "—" : String(delivery.featureCount),
 	describeDeliveryDone(delivery, terms),
 	describeDeliveryLikelihood(delivery),
-	delivery.likelyBy === void 0 ? "—" : dayOf(delivery.likelyBy)
+	delivery.likelyBy === void 0 ? "—" : describePercentileDay(delivery.likelyBy, delivery.likelyByBeyondHorizonYears)
 ];
 /** What heads the archived Deliveries, below the active ones: "Archived Deliveries". */
 const describeArchivedDeliveriesTitle = (terms) => `Archived ${terms.deliveries}`;
@@ -831,18 +853,23 @@ const describeDeliveryFeatureRow = (feature) => [
 ];
 /** The forecast distribution's column headings. */
 const describeDeliveryChanceHeadings = () => ["Chance", "Done by"];
-/** One chance of the day's forecast: "85%" and the day it is that likely to be done by. */
-const describeDeliveryChanceRow = (chance) => [`${chance.probability}%`, dayOf(chance.expectedDate)];
+/** One chance of the day's forecast: "85%" and the day it is that likely to be done by, or "More than 5 years". */
+const describeDeliveryChanceRow = (chance) => [`${chance.probability}%`, describePercentileDate(chance)];
 //#endregion
 //#region src/forecastWording.ts
-const optionalBoolean = (value) => {
+const optionalBoolean$1 = (value) => {
 	if (value === void 0 || typeof value === "boolean") return value;
 	return null;
 };
-const readChanceByDay = (value) => isRecord(value) && isNumber(value.probability) && isDay(value.expectedDate) ? {
-	probability: value.probability,
-	expectedDate: value.expectedDate
-} : null;
+const readChanceByDay = (value) => {
+	if (!isRecord(value) || !isNumber(value.probability) || !isDay(value.expectedDate)) return null;
+	return {
+		probability: value.probability,
+		expectedDate: value.expectedDate,
+		...typeof value.beyondHorizon === "boolean" ? { beyondHorizon: value.beyondHorizon } : {},
+		...isNumber(value.horizonYears) ? { horizonYears: value.horizonYears } : {}
+	};
+};
 const readChanceOfCount = (value) => isRecord(value) && isNumber(value.probability) && isNumber(value.value) ? {
 	probability: value.probability,
 	value: value.value
@@ -858,8 +885,8 @@ const readManualForecast = (value) => {
 	const { remainingItems, targetDate, likelihood } = value;
 	const whenForecasts = readEvery$1(value.whenForecasts, readChanceByDay);
 	const howManyForecasts = readEvery$1(value.howManyForecasts, readChanceOfCount);
-	const filterApplied = optionalBoolean(value.filterApplied);
-	const hasSufficientData = optionalBoolean(value.hasSufficientData);
+	const filterApplied = optionalBoolean$1(value.filterApplied);
+	const hasSufficientData = optionalBoolean$1(value.hasSufficientData);
 	if (!isNumber(remainingItems) || !(targetDate === null || isDay(targetDate)) || !(likelihood === null || isNumber(likelihood)) || whenForecasts === null || howManyForecasts === null || filterApplied === null || hasSufficientData === null) return null;
 	return {
 		remainingItems,
@@ -1146,13 +1173,28 @@ const readRunChart = (value, range) => {
 const optionalText = (value) => isText(value) ? value : void 0;
 const optionalNumber = (value) => isNumber(value) ? value : void 0;
 const optionalDay = (value) => isDay(value) ? value : void 0;
+const optionalBoolean = (value) => typeof value === "boolean" ? value : void 0;
+const STALE_REASON_KINDS = [
+	"TimeInState",
+	"BlockedDuration",
+	"TimeInStateWhileBlocked"
+];
+const isStaleReasonKind = (value) => STALE_REASON_KINDS.some((kind) => kind === value);
+const readStaleReason = (value) => isRecord(value) && isStaleReasonKind(value.kind) && isNumber(value.days) ? {
+	kind: value.kind,
+	days: value.days,
+	stateName: optionalText(value.stateName)
+} : null;
+const optionalStaleReasons = (value) => Array.isArray(value) ? value.map(readStaleReason).filter((reason) => reason !== null) : void 0;
 const readInProgressItem = (value) => isRecord(value) && (value.isBlocked === void 0 || typeof value.isBlocked === "boolean") ? {
 	isBlocked: value.isBlocked,
 	referenceId: optionalText(value.referenceId),
 	name: optionalText(value.name),
 	state: optionalText(value.state),
 	workItemAge: optionalNumber(value.workItemAge),
-	blockedSince: optionalDay(value.blockedSince)
+	blockedSince: optionalDay(value.blockedSince),
+	isStale: optionalBoolean(value.isStale),
+	staleReasons: optionalStaleReasons(value.staleReasons)
 } : null;
 const readInProgressNow = (value) => {
 	if (!isRecord(value) || !isDay(value.asOfDate) || !isNumber(value.count)) return null;
@@ -1351,6 +1393,7 @@ const metricsHeadlineLabel = (part, scope, terms) => {
 		throughput: `Total ${terms.throughput}`,
 		arrivals: "Total Arrivals",
 		blocked: `${terms.blocked} ${counted.many}`,
+		stale: `Stale ${counted.many}`,
 		totalWorkItemAge: `Total ${terms.workItemAge}`,
 		predictabilityScore: "Predictability Score",
 		cycleTimePercentiles: `${terms.cycleTime} percentiles`,
@@ -1394,27 +1437,31 @@ const describeInProgressNow = (now, scope, terms, systemWipLimit) => ({
 	value: String(now.count),
 	detail: systemWipLimit === void 0 ? "" : wipLimitOf(systemWipLimit, scope, terms)
 });
+const blockedFlag = (item) => item.isBlocked;
+const staleFlag = (item) => item.isStale;
+const saysWhichAre = (now, flag) => now.items.some((item) => flag(item) !== void 0);
+const countFlaggedNow = (part, flag, now, scope, terms) => saysWhichAre(now, flag) ? {
+	label: metricsHeadlineLabel(part, scope, terms),
+	value: String(now.items.filter((item) => flag(item) === true).length),
+	detail: ""
+} : null;
 /** "Blocked Work Items  2", or null when Lighthouse does not say which items are blocked. */
-const describeBlockedNow = (now, scope, terms) => {
-	if (!now.items.some((item) => item.isBlocked !== void 0)) return null;
-	const blocked = now.items.filter((item) => item.isBlocked === true).length;
-	return {
-		label: metricsHeadlineLabel("blocked", scope, terms),
-		value: String(blocked),
-		detail: ""
-	};
-};
+const describeBlockedNow = (now, scope, terms) => countFlaggedNow("blocked", blockedFlag, now, scope, terms);
+/** "Stale Work Items  2", or null when Lighthouse does not say which items are stale. */
+const describeStaleNow = (now, scope, terms) => countFlaggedNow("stale", staleFlag, now, scope, terms);
 /**
 * The sentences that stand in for what a WIP answer cannot show: no System WIP Limit, a Lighthouse that does
-* not say which Work Items are Blocked (which is not the same as none being Blocked), and nothing in progress.
-* A limit of null means the Team or Portfolio could not be read; it may well have one, so nothing is said.
+* not say which Work Items are Blocked or Stale (which is not the same as none being so), and nothing in
+* progress. A limit of null means the Team or Portfolio could not be read; it may well have one, so nothing
+* is said.
 */
 const describeWhatWipLeavesUnsaid = (now, scope, terms, systemWipLimit) => {
 	const counted = countedOf(scope, terms);
-	const blockedUnknown = now.items.length > 0 && now.items.every((item) => item.isBlocked === void 0);
+	const silentOn = (flag) => now.items.length > 0 && !saysWhichAre(now, flag);
 	return [
 		...systemWipLimit === void 0 ? [`No System ${terms.wip} Limit is set.`] : [],
-		...blockedUnknown ? [`Lighthouse does not say which ${counted.many} are ${terms.blocked}.`] : [],
+		...silentOn(blockedFlag) ? [`Lighthouse does not say which ${counted.many} are ${terms.blocked}.`] : [],
+		...silentOn(staleFlag) ? [`Lighthouse does not say which ${counted.many} are Stale.`] : [],
 		...now.items.length === 0 ? [`No ${counted.many} are in progress.`] : []
 	];
 };
@@ -3159,7 +3206,8 @@ const FEATURE_REQUIRES_SERVER_NEWER_THAN = {
 	deliveryMetricsHistory: "v26.5.29.5",
 	sleRisk: "v26.9.19.10",
 	teamRefinement: "v26.10.3.6",
-	refinementVotes: "v26.10.3.6"
+	refinementVotes: "v26.10.3.6",
+	staleness: "v26.10.16.6"
 };
 /**
 * Parses a Lighthouse version string ("v26.5.24.10", "26.5.24") into numeric
@@ -3706,6 +3754,8 @@ exports.describeOwnerListHeadings = describeOwnerListHeadings;
 exports.describeOwnerListTitle = describeOwnerListTitle;
 exports.describeOwnerName = describeOwnerName;
 exports.describeOwnerWriteConfirmation = describeOwnerWriteConfirmation;
+exports.describePercentileDate = describePercentileDate;
+exports.describePercentileDay = describePercentileDay;
 exports.describePercentileRows = describePercentileRows;
 exports.describePercentilesOverTime = describePercentilesOverTime;
 exports.describePercentilesOverTimeDays = describePercentilesOverTimeDays;
@@ -3726,6 +3776,7 @@ exports.describeRefinementSummary = describeRefinementSummary;
 exports.describeRefreshConfirmation = describeRefreshConfirmation;
 exports.describeRefusedMetric = describeRefusedMetric;
 exports.describeSleRiskNow = describeSleRiskNow;
+exports.describeStaleNow = describeStaleNow;
 exports.describeTags = describeTags;
 exports.describeTakenBack = describeTakenBack;
 exports.describeTeamSummary = describeTeamSummary;
@@ -3774,6 +3825,7 @@ exports.likelihoodAnswer = likelihoodAnswer;
 exports.loadStandaloneDiscoveryContract = loadStandaloneDiscoveryContract;
 exports.metricsHeadlineLabel = metricsHeadlineLabel;
 exports.mintVoterKey = mintVoterKey;
+exports.moreThanYearsText = moreThanYearsText;
 exports.myVoteOn = myVoteOn;
 exports.nameOrFallback = nameOrFallback;
 exports.ordinalOf = ordinalOf;
@@ -3845,3 +3897,4 @@ exports.usageDataStoreFor = usageDataStoreFor;
 exports.validateLighthouseConnectivity = validateLighthouseConnectivity;
 exports.voterKeyStoreFor = voterKeyStoreFor;
 exports.withdrawUsageData = withdrawUsageData;
+exports.yearsBeyondHorizon = yearsBeyondHorizon;

package/dist/index.d.cts

@@ -195,6 +195,7 @@ export type DeliveryListItem = {
   readonly hasSufficientData: boolean | undefined;
   readonly isOverdue: boolean | undefined;
   readonly likelyBy: string | undefined;
+  readonly likelyByBeyondHorizonYears?: number;
 };
 /** The Portfolio whose Deliveries are listed; its name stays undefined when it could not be read. */
 export type DeliveryListOwner = {
@@ -269,7 +270,7 @@ export declare const describeDeliveryFeatureHeadings: (terms: Terms) => string[]
 export declare const describeDeliveryFeatureRow: (feature: DeliveryFeatureMetric) => string[];
 /** The forecast distribution's column headings. */
 export declare const describeDeliveryChanceHeadings: () => string[];
-/** One chance of the day's forecast: "85%" and the day it is that likely to be done by. */
+/** One chance of the day's forecast: "85%" and the day it is that likely to be done by, or "More than 5 years". */
 export declare const describeDeliveryChanceRow: (chance: DeliveryWhenDistributionPoint) => string[];
 //#endregion
 //#region src/featureWording.d.ts
@@ -277,6 +278,7 @@ export declare const describeDeliveryChanceRow: (chance: DeliveryWhenDistributio
 export type FeatureStart = {
   readonly observedOn: string | undefined;
   readonly likelyBy: string | undefined;
+  readonly likelyByBeyondHorizonYears?: number;
 };
 /** One Feature as a row of the Feature list states it. */
 export type FeatureListItem = {
@@ -288,6 +290,7 @@ export type FeatureListItem = {
   readonly cannotBeForecast: boolean;
   readonly start: FeatureStart;
   readonly likelyBy: string | undefined;
+  readonly likelyByBeyondHorizonYears?: number;
 };
 /**
  * Every Feature in the answer, or null when it is not a list or any one of them comes without its
@@ -305,8 +308,11 @@ export declare const describeFeatureProgress: (feature: Pick<FeatureListItem, "t
  * Team without history; that Team only stops anyone saying when work will begin.
  */
 export declare const describeFeatureStart: (feature: Pick<FeatureListItem, "start" | "cannotBeForecast">) => string;
-/** The day the Feature is 85% likely to be done by, "Cannot forecast", or the mark when none was sent. */
-export declare const describeFeatureCompletion: (feature: Pick<FeatureListItem, "likelyBy" | "cannotBeForecast">) => string;
+/**
+ * The day the Feature is 85% likely to be done by, "More than 5 years" when that lies beyond the simulation
+ * horizon, "Cannot forecast", or the mark when none was sent.
+ */
+export declare const describeFeatureCompletion: (feature: Pick<FeatureListItem, "likelyBy" | "likelyByBeyondHorizonYears" | "cannotBeForecast">) => string;
 /** One Feature as a row of the list, in the order of its headings. */
 export declare const describeFeatureRow: (feature: FeatureListItem, terms: Terms) => string[];
 /** One Work Item of a Feature as the Feature's Work Items list states it. */
@@ -357,11 +363,33 @@ export declare const deliveryLikelihoodAnswer: (facts: Parameters<typeof likelih
   readonly isOverdue?: boolean;
 }) => string;
 //#endregion
+//#region src/forecastPercentileText.d.ts
+/**
+ * A forecast percentile as Lighthouse sends it. A percentile too few simulated runs reached carries
+ * `beyondHorizon` and the horizon's length in `horizonYears`; its `expectedDate` is then only a stand-in
+ * that nothing forecast, kept so an older client still reads a date. An older Lighthouse sends neither.
+ */
+export type ForecastPercentileDate = {
+  readonly expectedDate: string;
+  readonly beyondHorizon?: boolean;
+  readonly horizonYears?: number | null;
+};
+/**
+ * The years of the horizon a percentile lies beyond, or undefined when its date is the forecast. Keyed on
+ * the flag itself, never on the server's version: an older Lighthouse never sends it.
+ */
+export declare const yearsBeyondHorizon: (percentile: unknown) => number | undefined;
+/** The words shown in place of a date for a percentile too few simulated runs reached. */
+export declare const moreThanYearsText: (horizonYears: number) => string;
+/** A percentile's day as a person reads it, or "More than 5 years" when it lies beyond that horizon. */
+export declare const describePercentileDay: (expectedDate: string, horizonYearsBeyond: number | undefined) => string;
+/** One percentile as text: its day, or the words when it lies beyond the horizon. */
+export declare const describePercentileDate: (percentile: ForecastPercentileDate) => string;
+//#endregion
 //#region src/forecastWording.d.ts
 /** One row of the When table: the chance of being done by a calendar day. */
-export type ForecastChanceByDay = {
+export type ForecastChanceByDay = ForecastPercentileDate & {
   readonly probability: number;
-  readonly expectedDate: string;
 };
 /** One row of the How Many table: the chance of getting this many done. */
 export type ForecastChanceOfCount = {
@@ -532,7 +560,15 @@ export declare const readArrivals: typeof readDailyCountChart;
  * range's first day, read as the total and the count of each day. Without a total the days are summed.
  */
 export declare const readRunChart: (value: unknown, range: MetricsDateRange) => DailyCountChartView | null;
-/** A Work Item in progress; an older Lighthouse does not say whether it is blocked. */
+declare const STALE_REASON_KINDS: readonly ["TimeInState", "BlockedDuration", "TimeInStateWhileBlocked"];
+type StaleReasonKind = (typeof STALE_REASON_KINDS)[number];
+/** Why Lighthouse marks a Work Item stale, in whole days on the instance's calendar. */
+export type StaleReason = {
+  readonly kind: StaleReasonKind;
+  readonly days: number;
+  readonly stateName?: string;
+};
+/** A Work Item in progress; an older Lighthouse does not say whether it is blocked, or stale. */
 export type InProgressItem = {
   readonly isBlocked: boolean | undefined;
   readonly referenceId?: string;
@@ -540,6 +576,8 @@ export type InProgressItem = {
   readonly state?: string;
   readonly workItemAge?: number;
   readonly blockedSince?: string;
+  readonly isStale?: boolean;
+  readonly staleReasons?: readonly StaleReason[];
 };
 export type InProgressNowView = {
   readonly asOfDate: string;
@@ -621,7 +659,7 @@ export declare const PREDICTABILITY_SCORE_EXPLANATION = "The predictability scor
 /** What an empty over-time chart says on the web. */
 export declare const OVER_TIME_EMPTY_SENTENCE = "Nothing to show for the selected range. Days appear here as Lighthouse records them.";
 /** Every part of the headline that can be refused or unreadable on its own. */
-export type MetricsHeadlinePart = "wip" | "throughput" | "arrivals" | "blocked" | "totalWorkItemAge" | "predictabilityScore" | "cycleTimePercentiles" | "workItemAgePercentiles" | "workItemAge" | "cumulativeStateTime" | "percentilesOverTime" | "processBehaviorOverTime";
+export type MetricsHeadlinePart = "wip" | "throughput" | "arrivals" | "blocked" | "stale" | "totalWorkItemAge" | "predictabilityScore" | "cycleTimePercentiles" | "workItemAgePercentiles" | "workItemAge" | "cumulativeStateTime" | "percentilesOverTime" | "processBehaviorOverTime";
 /** "1 day", "12 days". */
 export declare const describeDays: (days: number) => string;
 /** The label each part of the headline goes by, in the instance's words. */
@@ -640,10 +678,13 @@ export declare const describeAsOfHeading: (subject: Pick<MetricsSubject, "endDat
 export declare const describeInProgressNow: (now: InProgressNowView, scope: MetricsScope, terms: Terms, systemWipLimit: number | undefined) => MetricLine;
 /** "Blocked Work Items  2", or null when Lighthouse does not say which items are blocked. */
 export declare const describeBlockedNow: (now: InProgressNowView, scope: MetricsScope, terms: Terms) => MetricLine | null;
+/** "Stale Work Items  2", or null when Lighthouse does not say which items are stale. */
+export declare const describeStaleNow: (now: InProgressNowView, scope: MetricsScope, terms: Terms) => MetricLine | null;
 /**
  * The sentences that stand in for what a WIP answer cannot show: no System WIP Limit, a Lighthouse that does
- * not say which Work Items are Blocked (which is not the same as none being Blocked), and nothing in progress.
- * A limit of null means the Team or Portfolio could not be read; it may well have one, so nothing is said.
+ * not say which Work Items are Blocked or Stale (which is not the same as none being so), and nothing in
+ * progress. A limit of null means the Team or Portfolio could not be read; it may well have one, so nothing
+ * is said.
  */
 export declare const describeWhatWipLeavesUnsaid: (now: InProgressNowView, scope: MetricsScope, terms: Terms, systemWipLimit: number | undefined | null) => readonly string[];
 /** "Total Throughput  31  1.0 / day". */
@@ -1431,6 +1472,10 @@ export type DeliveryFeatureMetric = {
 export type DeliveryWhenDistributionPoint = {
   readonly probability: number;
   readonly expectedDate: string;
+  /** True when too few simulated runs reached this chance: `expectedDate` is then only a stand-in. Absent on an older Lighthouse. */
+  readonly beyondHorizon?: boolean;
+  /** The simulation horizon, in years, this chance was forecast with. Absent on an older Lighthouse and on days recorded before it. */
+  readonly horizonYears?: number | null;
 };
 /** A delivery as it stood on one recorded day. Dates are ISO strings. */
 export type DeliveryMetricsHistoryPoint = {
@@ -1851,6 +1896,7 @@ export declare const FEATURE_REQUIRES_SERVER_NEWER_THAN: {
   readonly sleRisk: "v26.9.19.10";
   readonly teamRefinement: "v26.10.3.6";
   readonly refinementVotes: "v26.10.3.6";
+  readonly staleness: "v26.10.16.6";
 };
 /**
  * Returns true when `candidate` is strictly newer than `baseline`, false when
@@ -1861,4 +1907,5 @@ export declare const isServerVersionNewerThan: (candidate: string, baseline: str
 /** The header a client sends its voter key in, so Lighthouse can tell its votes from anyone else's. */
 export declare const VOTER_KEY_HEADER = "X-Lighthouse-Voter-Key";
 export declare const createLighthouseClient: (configuration: LighthouseClientConfiguration, dependencies?: LighthouseClientDependencies) => LighthouseClient;
-//#endregion
+//#endregion
+export {};

package/dist/index.d.ts

@@ -195,6 +195,7 @@ export type DeliveryListItem = {
   readonly hasSufficientData: boolean | undefined;
   readonly isOverdue: boolean | undefined;
   readonly likelyBy: string | undefined;
+  readonly likelyByBeyondHorizonYears?: number;
 };
 /** The Portfolio whose Deliveries are listed; its name stays undefined when it could not be read. */
 export type DeliveryListOwner = {
@@ -269,7 +270,7 @@ export declare const describeDeliveryFeatureHeadings: (terms: Terms) => string[]
 export declare const describeDeliveryFeatureRow: (feature: DeliveryFeatureMetric) => string[];
 /** The forecast distribution's column headings. */
 export declare const describeDeliveryChanceHeadings: () => string[];
-/** One chance of the day's forecast: "85%" and the day it is that likely to be done by. */
+/** One chance of the day's forecast: "85%" and the day it is that likely to be done by, or "More than 5 years". */
 export declare const describeDeliveryChanceRow: (chance: DeliveryWhenDistributionPoint) => string[];
 //#endregion
 //#region src/featureWording.d.ts
@@ -277,6 +278,7 @@ export declare const describeDeliveryChanceRow: (chance: DeliveryWhenDistributio
 export type FeatureStart = {
   readonly observedOn: string | undefined;
   readonly likelyBy: string | undefined;
+  readonly likelyByBeyondHorizonYears?: number;
 };
 /** One Feature as a row of the Feature list states it. */
 export type FeatureListItem = {
@@ -288,6 +290,7 @@ export type FeatureListItem = {
   readonly cannotBeForecast: boolean;
   readonly start: FeatureStart;
   readonly likelyBy: string | undefined;
+  readonly likelyByBeyondHorizonYears?: number;
 };
 /**
  * Every Feature in the answer, or null when it is not a list or any one of them comes without its
@@ -305,8 +308,11 @@ export declare const describeFeatureProgress: (feature: Pick<FeatureListItem, "t
  * Team without history; that Team only stops anyone saying when work will begin.
  */
 export declare const describeFeatureStart: (feature: Pick<FeatureListItem, "start" | "cannotBeForecast">) => string;
-/** The day the Feature is 85% likely to be done by, "Cannot forecast", or the mark when none was sent. */
-export declare const describeFeatureCompletion: (feature: Pick<FeatureListItem, "likelyBy" | "cannotBeForecast">) => string;
+/**
+ * The day the Feature is 85% likely to be done by, "More than 5 years" when that lies beyond the simulation
+ * horizon, "Cannot forecast", or the mark when none was sent.
+ */
+export declare const describeFeatureCompletion: (feature: Pick<FeatureListItem, "likelyBy" | "likelyByBeyondHorizonYears" | "cannotBeForecast">) => string;
 /** One Feature as a row of the list, in the order of its headings. */
 export declare const describeFeatureRow: (feature: FeatureListItem, terms: Terms) => string[];
 /** One Work Item of a Feature as the Feature's Work Items list states it. */
@@ -357,11 +363,33 @@ export declare const deliveryLikelihoodAnswer: (facts: Parameters<typeof likelih
   readonly isOverdue?: boolean;
 }) => string;
 //#endregion
+//#region src/forecastPercentileText.d.ts
+/**
+ * A forecast percentile as Lighthouse sends it. A percentile too few simulated runs reached carries
+ * `beyondHorizon` and the horizon's length in `horizonYears`; its `expectedDate` is then only a stand-in
+ * that nothing forecast, kept so an older client still reads a date. An older Lighthouse sends neither.
+ */
+export type ForecastPercentileDate = {
+  readonly expectedDate: string;
+  readonly beyondHorizon?: boolean;
+  readonly horizonYears?: number | null;
+};
+/**
+ * The years of the horizon a percentile lies beyond, or undefined when its date is the forecast. Keyed on
+ * the flag itself, never on the server's version: an older Lighthouse never sends it.
+ */
+export declare const yearsBeyondHorizon: (percentile: unknown) => number | undefined;
+/** The words shown in place of a date for a percentile too few simulated runs reached. */
+export declare const moreThanYearsText: (horizonYears: number) => string;
+/** A percentile's day as a person reads it, or "More than 5 years" when it lies beyond that horizon. */
+export declare const describePercentileDay: (expectedDate: string, horizonYearsBeyond: number | undefined) => string;
+/** One percentile as text: its day, or the words when it lies beyond the horizon. */
+export declare const describePercentileDate: (percentile: ForecastPercentileDate) => string;
+//#endregion
 //#region src/forecastWording.d.ts
 /** One row of the When table: the chance of being done by a calendar day. */
-export type ForecastChanceByDay = {
+export type ForecastChanceByDay = ForecastPercentileDate & {
   readonly probability: number;
-  readonly expectedDate: string;
 };
 /** One row of the How Many table: the chance of getting this many done. */
 export type ForecastChanceOfCount = {
@@ -532,7 +560,15 @@ export declare const readArrivals: typeof readDailyCountChart;
  * range's first day, read as the total and the count of each day. Without a total the days are summed.
  */
 export declare const readRunChart: (value: unknown, range: MetricsDateRange) => DailyCountChartView | null;
-/** A Work Item in progress; an older Lighthouse does not say whether it is blocked. */
+declare const STALE_REASON_KINDS: readonly ["TimeInState", "BlockedDuration", "TimeInStateWhileBlocked"];
+type StaleReasonKind = (typeof STALE_REASON_KINDS)[number];
+/** Why Lighthouse marks a Work Item stale, in whole days on the instance's calendar. */
+export type StaleReason = {
+  readonly kind: StaleReasonKind;
+  readonly days: number;
+  readonly stateName?: string;
+};
+/** A Work Item in progress; an older Lighthouse does not say whether it is blocked, or stale. */
 export type InProgressItem = {
   readonly isBlocked: boolean | undefined;
   readonly referenceId?: string;
@@ -540,6 +576,8 @@ export type InProgressItem = {
   readonly state?: string;
   readonly workItemAge?: number;
   readonly blockedSince?: string;
+  readonly isStale?: boolean;
+  readonly staleReasons?: readonly StaleReason[];
 };
 export type InProgressNowView = {
   readonly asOfDate: string;
@@ -621,7 +659,7 @@ export declare const PREDICTABILITY_SCORE_EXPLANATION = "The predictability scor
 /** What an empty over-time chart says on the web. */
 export declare const OVER_TIME_EMPTY_SENTENCE = "Nothing to show for the selected range. Days appear here as Lighthouse records them.";
 /** Every part of the headline that can be refused or unreadable on its own. */
-export type MetricsHeadlinePart = "wip" | "throughput" | "arrivals" | "blocked" | "totalWorkItemAge" | "predictabilityScore" | "cycleTimePercentiles" | "workItemAgePercentiles" | "workItemAge" | "cumulativeStateTime" | "percentilesOverTime" | "processBehaviorOverTime";
+export type MetricsHeadlinePart = "wip" | "throughput" | "arrivals" | "blocked" | "stale" | "totalWorkItemAge" | "predictabilityScore" | "cycleTimePercentiles" | "workItemAgePercentiles" | "workItemAge" | "cumulativeStateTime" | "percentilesOverTime" | "processBehaviorOverTime";
 /** "1 day", "12 days". */
 export declare const describeDays: (days: number) => string;
 /** The label each part of the headline goes by, in the instance's words. */
@@ -640,10 +678,13 @@ export declare const describeAsOfHeading: (subject: Pick<MetricsSubject, "endDat
 export declare const describeInProgressNow: (now: InProgressNowView, scope: MetricsScope, terms: Terms, systemWipLimit: number | undefined) => MetricLine;
 /** "Blocked Work Items  2", or null when Lighthouse does not say which items are blocked. */
 export declare const describeBlockedNow: (now: InProgressNowView, scope: MetricsScope, terms: Terms) => MetricLine | null;
+/** "Stale Work Items  2", or null when Lighthouse does not say which items are stale. */
+export declare const describeStaleNow: (now: InProgressNowView, scope: MetricsScope, terms: Terms) => MetricLine | null;
 /**
  * The sentences that stand in for what a WIP answer cannot show: no System WIP Limit, a Lighthouse that does
- * not say which Work Items are Blocked (which is not the same as none being Blocked), and nothing in progress.
- * A limit of null means the Team or Portfolio could not be read; it may well have one, so nothing is said.
+ * not say which Work Items are Blocked or Stale (which is not the same as none being so), and nothing in
+ * progress. A limit of null means the Team or Portfolio could not be read; it may well have one, so nothing
+ * is said.
  */
 export declare const describeWhatWipLeavesUnsaid: (now: InProgressNowView, scope: MetricsScope, terms: Terms, systemWipLimit: number | undefined | null) => readonly string[];
 /** "Total Throughput  31  1.0 / day". */
@@ -1431,6 +1472,10 @@ export type DeliveryFeatureMetric = {
 export type DeliveryWhenDistributionPoint = {
   readonly probability: number;
   readonly expectedDate: string;
+  /** True when too few simulated runs reached this chance: `expectedDate` is then only a stand-in. Absent on an older Lighthouse. */
+  readonly beyondHorizon?: boolean;
+  /** The simulation horizon, in years, this chance was forecast with. Absent on an older Lighthouse and on days recorded before it. */
+  readonly horizonYears?: number | null;
 };
 /** A delivery as it stood on one recorded day. Dates are ISO strings. */
 export type DeliveryMetricsHistoryPoint = {
@@ -1851,6 +1896,7 @@ export declare const FEATURE_REQUIRES_SERVER_NEWER_THAN: {
   readonly sleRisk: "v26.9.19.10";
   readonly teamRefinement: "v26.10.3.6";
   readonly refinementVotes: "v26.10.3.6";
+  readonly staleness: "v26.10.16.6";
 };
 /**
  * Returns true when `candidate` is strictly newer than `baseline`, false when
@@ -1861,4 +1907,5 @@ export declare const isServerVersionNewerThan: (candidate: string, baseline: str
 /** The header a client sends its voter key in, so Lighthouse can tell its votes from anyone else's. */
 export declare const VOTER_KEY_HEADER = "X-Lighthouse-Voter-Key";
 export declare const createLighthouseClient: (configuration: LighthouseClientConfiguration, dependencies?: LighthouseClientDependencies) => LighthouseClient;
-//#endregion
+//#endregion
+export {};

package/dist/index.js

@@ -241,13 +241,26 @@ const textOf = (value) => typeof value === "string" && value.length > 0 ? value
 const isDay = (value) => isText(value) && formatCalendarDay(value) !== null;
 /** The calendar day as a person reads it, or the text exactly as sent when it is not one. */
 const dayOf = (wire) => formatCalendarDay(wire) ?? wire;
-/** The date a list of chances gives for one probability, or undefined when it holds none for it. */
-const expectedDateAt = (chances, probability) => {
+/** The chance a list gives for one probability, or undefined when it holds none for it. */
+const chanceAt = (chances, probability) => {
 	if (!Array.isArray(chances)) return;
 	const chance = chances.find((entry) => isRecord(entry) && entry.probability === probability);
-	return isRecord(chance) ? textOf(chance.expectedDate) : void 0;
+	return isRecord(chance) ? chance : void 0;
 };
 //#endregion
+//#region src/forecastPercentileText.ts
+/**
+* The years of the horizon a percentile lies beyond, or undefined when its date is the forecast. Keyed on
+* the flag itself, never on the server's version: an older Lighthouse never sends it.
+*/
+const yearsBeyondHorizon = (percentile) => isRecord(percentile) && percentile.beyondHorizon === true && isNumber(percentile.horizonYears) ? percentile.horizonYears : void 0;
+/** The words shown in place of a date for a percentile too few simulated runs reached. */
+const moreThanYearsText = (horizonYears) => `More than ${horizonYears} years`;
+/** A percentile's day as a person reads it, or "More than 5 years" when it lies beyond that horizon. */
+const describePercentileDay = (expectedDate, horizonYearsBeyond) => horizonYearsBeyond === void 0 ? dayOf(expectedDate) : moreThanYearsText(horizonYearsBeyond);
+/** One percentile as text: its day, or the words when it lies beyond the horizon. */
+const describePercentileDate = (percentile) => describePercentileDay(percentile.expectedDate, yearsBeyondHorizon(percentile));
+//#endregion
 //#region src/ownerWording.ts
 /** A mark for a cell Lighthouse sent nothing for. */
 const NOT_SENT = "—";
@@ -407,9 +420,11 @@ const startOf = (value) => {
 		observedOn: void 0,
 		likelyBy: void 0
 	};
+	const chance = chanceAt(value.percentiles, LISTED_CHANCE$1);
 	return {
 		observedOn: value.source === "Observed" ? textOf(value.observedDate) : void 0,
-		likelyBy: expectedDateAt(value.percentiles, LISTED_CHANCE$1)
+		likelyBy: textOf(chance?.expectedDate),
+		likelyByBeyondHorizonYears: yearsBeyondHorizon(chance)
 	};
 };
 const readFeatureListItem = (value) => {
@@ -419,6 +434,7 @@ const readFeatureListItem = (value) => {
 	const state = textOf(value.state);
 	const totalWork = workOf(value.totalWork);
 	const remainingWork = workOf(value.remainingWork);
+	const completion = chanceAt(value.forecasts, LISTED_CHANCE$1);
 	if (referenceId === void 0 || name === void 0 || state === void 0 || totalWork === null || remainingWork === null) return null;
 	return {
 		referenceId,
@@ -428,7 +444,8 @@ const readFeatureListItem = (value) => {
 		remainingWork,
 		cannotBeForecast: Array.isArray(value.teamsWithoutForecast) && value.teamsWithoutForecast.length > 0,
 		start: startOf(value.startForecast),
-		likelyBy: expectedDateAt(value.forecasts, LISTED_CHANCE$1)
+		likelyBy: textOf(completion?.expectedDate),
+		likelyByBeyondHorizonYears: yearsBeyondHorizon(completion)
 	};
 };
 /**
@@ -464,12 +481,15 @@ const describeFeatureProgress = (feature, terms) => `${feature.totalWork - featu
 const describeFeatureStart = (feature) => {
 	if (feature.start.observedOn !== void 0) return dayOf(feature.start.observedOn);
 	if (feature.cannotBeForecast) return CANNOT_FORECAST_SHORT;
-	return feature.start.likelyBy === void 0 ? "—" : dayOf(feature.start.likelyBy);
+	return feature.start.likelyBy === void 0 ? "—" : describePercentileDay(feature.start.likelyBy, feature.start.likelyByBeyondHorizonYears);
 };
-/** The day the Feature is 85% likely to be done by, "Cannot forecast", or the mark when none was sent. */
+/**
+* The day the Feature is 85% likely to be done by, "More than 5 years" when that lies beyond the simulation
+* horizon, "Cannot forecast", or the mark when none was sent.
+*/
 const describeFeatureCompletion = (feature) => {
 	if (feature.cannotBeForecast) return CANNOT_FORECAST_SHORT;
-	return feature.likelyBy === void 0 ? "—" : dayOf(feature.likelyBy);
+	return feature.likelyBy === void 0 ? "—" : describePercentileDay(feature.likelyBy, feature.likelyByBeyondHorizonYears);
 };
 /** One Feature as a row of the list, in the order of its headings. */
 const describeFeatureRow = (feature, terms) => [
@@ -632,6 +652,7 @@ const readDeliveryListItem = (value) => {
 	const name = textOf(value.name);
 	const date = textOf(value.date);
 	if (name === void 0 || date === void 0) return null;
+	const likely = chanceAt(value.completionDates, LISTED_CHANCE);
 	return {
 		id: value.id,
 		name,
@@ -643,7 +664,8 @@ const readDeliveryListItem = (value) => {
 		cannotBeForecast: teamsWithoutForecastIn(value),
 		hasSufficientData: flagOf(value.hasSufficientData),
 		isOverdue: flagOf(value.isOverdue),
-		likelyBy: expectedDateAt(value.completionDates, LISTED_CHANCE)
+		likelyBy: textOf(likely?.expectedDate),
+		likelyByBeyondHorizonYears: yearsBeyondHorizon(likely)
 	};
 };
 /**
@@ -727,7 +749,7 @@ const describeDeliveryRow = (delivery, terms) => [
 	delivery.featureCount === void 0 ? "—" : String(delivery.featureCount),
 	describeDeliveryDone(delivery, terms),
 	describeDeliveryLikelihood(delivery),
-	delivery.likelyBy === void 0 ? "—" : dayOf(delivery.likelyBy)
+	delivery.likelyBy === void 0 ? "—" : describePercentileDay(delivery.likelyBy, delivery.likelyByBeyondHorizonYears)
 ];
 /** What heads the archived Deliveries, below the active ones: "Archived Deliveries". */
 const describeArchivedDeliveriesTitle = (terms) => `Archived ${terms.deliveries}`;
@@ -830,18 +852,23 @@ const describeDeliveryFeatureRow = (feature) => [
 ];
 /** The forecast distribution's column headings. */
 const describeDeliveryChanceHeadings = () => ["Chance", "Done by"];
-/** One chance of the day's forecast: "85%" and the day it is that likely to be done by. */
-const describeDeliveryChanceRow = (chance) => [`${chance.probability}%`, dayOf(chance.expectedDate)];
+/** One chance of the day's forecast: "85%" and the day it is that likely to be done by, or "More than 5 years". */
+const describeDeliveryChanceRow = (chance) => [`${chance.probability}%`, describePercentileDate(chance)];
 //#endregion
 //#region src/forecastWording.ts
-const optionalBoolean = (value) => {
+const optionalBoolean$1 = (value) => {
 	if (value === void 0 || typeof value === "boolean") return value;
 	return null;
 };
-const readChanceByDay = (value) => isRecord(value) && isNumber(value.probability) && isDay(value.expectedDate) ? {
-	probability: value.probability,
-	expectedDate: value.expectedDate
-} : null;
+const readChanceByDay = (value) => {
+	if (!isRecord(value) || !isNumber(value.probability) || !isDay(value.expectedDate)) return null;
+	return {
+		probability: value.probability,
+		expectedDate: value.expectedDate,
+		...typeof value.beyondHorizon === "boolean" ? { beyondHorizon: value.beyondHorizon } : {},
+		...isNumber(value.horizonYears) ? { horizonYears: value.horizonYears } : {}
+	};
+};
 const readChanceOfCount = (value) => isRecord(value) && isNumber(value.probability) && isNumber(value.value) ? {
 	probability: value.probability,
 	value: value.value
@@ -857,8 +884,8 @@ const readManualForecast = (value) => {
 	const { remainingItems, targetDate, likelihood } = value;
 	const whenForecasts = readEvery$1(value.whenForecasts, readChanceByDay);
 	const howManyForecasts = readEvery$1(value.howManyForecasts, readChanceOfCount);
-	const filterApplied = optionalBoolean(value.filterApplied);
-	const hasSufficientData = optionalBoolean(value.hasSufficientData);
+	const filterApplied = optionalBoolean$1(value.filterApplied);
+	const hasSufficientData = optionalBoolean$1(value.hasSufficientData);
 	if (!isNumber(remainingItems) || !(targetDate === null || isDay(targetDate)) || !(likelihood === null || isNumber(likelihood)) || whenForecasts === null || howManyForecasts === null || filterApplied === null || hasSufficientData === null) return null;
 	return {
 		remainingItems,
@@ -1145,13 +1172,28 @@ const readRunChart = (value, range) => {
 const optionalText = (value) => isText(value) ? value : void 0;
 const optionalNumber = (value) => isNumber(value) ? value : void 0;
 const optionalDay = (value) => isDay(value) ? value : void 0;
+const optionalBoolean = (value) => typeof value === "boolean" ? value : void 0;
+const STALE_REASON_KINDS = [
+	"TimeInState",
+	"BlockedDuration",
+	"TimeInStateWhileBlocked"
+];
+const isStaleReasonKind = (value) => STALE_REASON_KINDS.some((kind) => kind === value);
+const readStaleReason = (value) => isRecord(value) && isStaleReasonKind(value.kind) && isNumber(value.days) ? {
+	kind: value.kind,
+	days: value.days,
+	stateName: optionalText(value.stateName)
+} : null;
+const optionalStaleReasons = (value) => Array.isArray(value) ? value.map(readStaleReason).filter((reason) => reason !== null) : void 0;
 const readInProgressItem = (value) => isRecord(value) && (value.isBlocked === void 0 || typeof value.isBlocked === "boolean") ? {
 	isBlocked: value.isBlocked,
 	referenceId: optionalText(value.referenceId),
 	name: optionalText(value.name),
 	state: optionalText(value.state),
 	workItemAge: optionalNumber(value.workItemAge),
-	blockedSince: optionalDay(value.blockedSince)
+	blockedSince: optionalDay(value.blockedSince),
+	isStale: optionalBoolean(value.isStale),
+	staleReasons: optionalStaleReasons(value.staleReasons)
 } : null;
 const readInProgressNow = (value) => {
 	if (!isRecord(value) || !isDay(value.asOfDate) || !isNumber(value.count)) return null;
@@ -1350,6 +1392,7 @@ const metricsHeadlineLabel = (part, scope, terms) => {
 		throughput: `Total ${terms.throughput}`,
 		arrivals: "Total Arrivals",
 		blocked: `${terms.blocked} ${counted.many}`,
+		stale: `Stale ${counted.many}`,
 		totalWorkItemAge: `Total ${terms.workItemAge}`,
 		predictabilityScore: "Predictability Score",
 		cycleTimePercentiles: `${terms.cycleTime} percentiles`,
@@ -1393,27 +1436,31 @@ const describeInProgressNow = (now, scope, terms, systemWipLimit) => ({
 	value: String(now.count),
 	detail: systemWipLimit === void 0 ? "" : wipLimitOf(systemWipLimit, scope, terms)
 });
+const blockedFlag = (item) => item.isBlocked;
+const staleFlag = (item) => item.isStale;
+const saysWhichAre = (now, flag) => now.items.some((item) => flag(item) !== void 0);
+const countFlaggedNow = (part, flag, now, scope, terms) => saysWhichAre(now, flag) ? {
+	label: metricsHeadlineLabel(part, scope, terms),
+	value: String(now.items.filter((item) => flag(item) === true).length),
+	detail: ""
+} : null;
 /** "Blocked Work Items  2", or null when Lighthouse does not say which items are blocked. */
-const describeBlockedNow = (now, scope, terms) => {
-	if (!now.items.some((item) => item.isBlocked !== void 0)) return null;
-	const blocked = now.items.filter((item) => item.isBlocked === true).length;
-	return {
-		label: metricsHeadlineLabel("blocked", scope, terms),
-		value: String(blocked),
-		detail: ""
-	};
-};
+const describeBlockedNow = (now, scope, terms) => countFlaggedNow("blocked", blockedFlag, now, scope, terms);
+/** "Stale Work Items  2", or null when Lighthouse does not say which items are stale. */
+const describeStaleNow = (now, scope, terms) => countFlaggedNow("stale", staleFlag, now, scope, terms);
 /**
 * The sentences that stand in for what a WIP answer cannot show: no System WIP Limit, a Lighthouse that does
-* not say which Work Items are Blocked (which is not the same as none being Blocked), and nothing in progress.
-* A limit of null means the Team or Portfolio could not be read; it may well have one, so nothing is said.
+* not say which Work Items are Blocked or Stale (which is not the same as none being so), and nothing in
+* progress. A limit of null means the Team or Portfolio could not be read; it may well have one, so nothing
+* is said.
 */
 const describeWhatWipLeavesUnsaid = (now, scope, terms, systemWipLimit) => {
 	const counted = countedOf(scope, terms);
-	const blockedUnknown = now.items.length > 0 && now.items.every((item) => item.isBlocked === void 0);
+	const silentOn = (flag) => now.items.length > 0 && !saysWhichAre(now, flag);
 	return [
 		...systemWipLimit === void 0 ? [`No System ${terms.wip} Limit is set.`] : [],
-		...blockedUnknown ? [`Lighthouse does not say which ${counted.many} are ${terms.blocked}.`] : [],
+		...silentOn(blockedFlag) ? [`Lighthouse does not say which ${counted.many} are ${terms.blocked}.`] : [],
+		...silentOn(staleFlag) ? [`Lighthouse does not say which ${counted.many} are Stale.`] : [],
 		...now.items.length === 0 ? [`No ${counted.many} are in progress.`] : []
 	];
 };
@@ -3158,7 +3205,8 @@ const FEATURE_REQUIRES_SERVER_NEWER_THAN = {
 	deliveryMetricsHistory: "v26.5.29.5",
 	sleRisk: "v26.9.19.10",
 	teamRefinement: "v26.10.3.6",
-	refinementVotes: "v26.10.3.6"
+	refinementVotes: "v26.10.3.6",
+	staleness: "v26.10.16.6"
 };
 /**
 * Parses a Lighthouse version string ("v26.5.24.10", "26.5.24") into numeric
@@ -3615,4 +3663,4 @@ const usageDataCalls = (configuration, dependencies) => {
 	};
 };
 //#endregion
-export { BLACKOUT_RULE_LIST_HEADINGS, BLACKOUT_RULE_LIST_TITLE, CANNOT_FORECAST_SHORT, FEATURE_REQUIRES_SERVER_NEWER_THAN, INSUFFICIENT_FORECAST_DATA_SENTENCE, INSUFFICIENT_FORECAST_DATA_SHORT, LIGHTHOUSE_IS_REACHABLE, NOT_SENT, NOT_SET, NO_DATA_YET, OVERDUE_SHORT, OVER_TIME_EMPTY_SENTENCE, PREDICTABILITY_SCORE_EXPLANATION, REFINEMENT_ANSWERS, SECRET_NOT_SHOWN, SEEDED_TERMS, SLE_RISK_AT_RISK_FROM, STANDALONE_VOTER_KEY_SCOPE, UNKNOWN_SHAPE_NOTE, USAGE_DATA_BUDGET_MS, VOTER_KEY_HEADER, WORK_TRACKING_CONNECTION_LIST_HEADINGS, WORK_TRACKING_OPTION_HEADINGS, countNumberedRows, createFileUsageDataStore, createFileVoterKeyStore, createLighthouseAuthContext, createLighthouseClient, daysInRange, deliveryLikelihoodAnswer, describeAnswer, describeArchivedDeliveriesTitle, describeArchivedDeliveryHeadings, describeArchivedDeliveryRow, describeArrivalsDays, describeAsOfHeading, describeBacktestActual, describeBacktestPeriod, describeBacktestSummary, describeBlackoutRuleCount, describeBlackoutRuleSchedule, describeBlackoutRuleWriteConfirmation, describeBlockedDays, describeBlockedNow, describeBlockedOverTime, describeConnectionName, describeConnectionSummary, describeConnectionType, describeCycleTimeDays, describeDays, describeDeliveryChanceHeadings, describeDeliveryChanceRow, describeDeliveryCount, describeDeliveryDone, describeDeliveryFeatureHeadings, describeDeliveryFeatureRow, describeDeliveryLikelihood, describeDeliveryListHeadings, describeDeliveryListTitle, describeDeliveryMetricsHeading, describeDeliveryRow, describeFeatureCompletion, describeFeatureCount, describeFeatureListCount, describeFeatureListHeadings, describeFeatureProgress, describeFeatureRow, describeFeatureStart, describeFeatureTitle, describeFeatureWorkItemHeadings, describeFeatureWorkItemRow, describeFeatureWorkItemsHeading, describeHowManyTitle, describeInProgressNow, describeLastUpdated, describeManualForecastLikelihood, describeManualForecastSummary, describeMetricSummary, describeMetricsHeading, describeMissingCondition, describeNoBlackoutRules, describeNoDeliveries, describeNothingToTakeBack, describeOptionValue, describeOverTimeHeading, describeOwnerCount, describeOwnerListHeadings, describeOwnerListTitle, describeOwnerName, describeOwnerWriteConfirmation, describePercentileRows, describePercentilesOverTime, describePercentilesOverTimeDays, describePortfolioSummary, describePredictabilityScore, describePredictabilityScoreDays, describeProcessBehaviorChart, describeProcessBehaviorOverTime, describeProcessBehaviorOverTimeDays, describeReachable, describeReadiness, describeRecordedComment, describeRecordedDayHeadings, describeRecordedDayRow, describeRecordedDayTitle, describeRecordedVote, describeRefinementSummary, describeRefreshConfirmation, describeRefusedMetric, describeSleRiskNow, describeTags, describeTakenBack, describeTeamSummary, describeThroughputDays, describeTimeInState, describeTimeInStateContributorDays, describeTimeInStateDays, describeTotalArrivals, describeTotalThroughput, describeTotalWorkItemAge, describeTotalWorkItemAgeDays, describeUnknownMetric, describeVersion, describeVoteRefusal, describeVotes, describeWarnings, describeWhatWipLeavesUnsaid, describeWhenTitle, describeWipDays, describeWorkItemAgeDays, describeWorkItemAgePercentiles, describeWorkTrackingSystemCount, formatCalendarDay, formatLikelihood, formatTimestamp, getClientPackageContract, getDefaultMetricsDateRange, getStandaloneDiscoveryLockfilePath, getUsageDataStorePath, getVoterKeyScope, getVoterKeyStorePath, hideConnectionSecrets, isAPersonAtTheTerminal, isAtRiskOfMissingTheSle, isCalendarDay, isDoNotTrackSet, isMetricRefusal, isMissingItsCondition, isProcessBehaviorMetricType, isRefinementAnswer, isServerVersionNewerThan, keepVoterKey, latestRecordedDay, levelOf, likelihoodAnswer, loadStandaloneDiscoveryContract, metricsHeadlineLabel, mintVoterKey, myVoteOn, nameOrFallback, ordinalOf, parseStandaloneDiscoveryContract, placeActualAmongPercentiles, placeEnoughForLine, planUsageDataStep, pollCliAuthSession, processBehaviorChartTitle, queryServerAuthMode, readAnswerWording, readArchivedDeliveryItem, readArrivals, readBacktest, readBlackoutRules, readBlocked, readCumulativeStateTime, readCycleTime, readCycleTimeDefinitionName, readCycleTimePercentiles, readDeliveryList, readDeliveryMetricsHistory, readFeatureList, readFeatureWording, readFeatureWorkItems, readInProgressItems, readManualForecast, readMetricAnswer, readMetricsSubject, readNameOfMyVote, readOwnerList, readPercentilesOverTime, readPortfolio, readPortfolioDeliveries, readPredictabilityScore, readProcessBehaviorChart, readProcessBehaviorOverTime, readRefinementTerms, readRefinementWording, readRunChart, readServiceLevelExpectation, readSleRisk, readStoredUsageDataAnswer, readSystemWipLimit, readTeam, readTerms, readThroughput, readTimeInStateBar, readTimeInStateContributors, readTotalWorkItemAge, readUsageDataState, readVoteRefusal, readWip, readWorkItemAge, readWorkItemAgePercentiles, readWorkTrackingConnection, readWorkTrackingConnections, readWrittenBlackoutRule, readWrittenOwner, refinementDayVerdictOf, resolveTerms, settleUsageDataStep, sizingMomentOf, startCliAuthSession, summariseDeliveryMetricsHistory, switchUsageDataOn, timeInStateItemCount, usageDataStoreFor, validateLighthouseConnectivity, voterKeyStoreFor, withdrawUsageData };
+export { BLACKOUT_RULE_LIST_HEADINGS, BLACKOUT_RULE_LIST_TITLE, CANNOT_FORECAST_SHORT, FEATURE_REQUIRES_SERVER_NEWER_THAN, INSUFFICIENT_FORECAST_DATA_SENTENCE, INSUFFICIENT_FORECAST_DATA_SHORT, LIGHTHOUSE_IS_REACHABLE, NOT_SENT, NOT_SET, NO_DATA_YET, OVERDUE_SHORT, OVER_TIME_EMPTY_SENTENCE, PREDICTABILITY_SCORE_EXPLANATION, REFINEMENT_ANSWERS, SECRET_NOT_SHOWN, SEEDED_TERMS, SLE_RISK_AT_RISK_FROM, STANDALONE_VOTER_KEY_SCOPE, UNKNOWN_SHAPE_NOTE, USAGE_DATA_BUDGET_MS, VOTER_KEY_HEADER, WORK_TRACKING_CONNECTION_LIST_HEADINGS, WORK_TRACKING_OPTION_HEADINGS, countNumberedRows, createFileUsageDataStore, createFileVoterKeyStore, createLighthouseAuthContext, createLighthouseClient, daysInRange, deliveryLikelihoodAnswer, describeAnswer, describeArchivedDeliveriesTitle, describeArchivedDeliveryHeadings, describeArchivedDeliveryRow, describeArrivalsDays, describeAsOfHeading, describeBacktestActual, describeBacktestPeriod, describeBacktestSummary, describeBlackoutRuleCount, describeBlackoutRuleSchedule, describeBlackoutRuleWriteConfirmation, describeBlockedDays, describeBlockedNow, describeBlockedOverTime, describeConnectionName, describeConnectionSummary, describeConnectionType, describeCycleTimeDays, describeDays, describeDeliveryChanceHeadings, describeDeliveryChanceRow, describeDeliveryCount, describeDeliveryDone, describeDeliveryFeatureHeadings, describeDeliveryFeatureRow, describeDeliveryLikelihood, describeDeliveryListHeadings, describeDeliveryListTitle, describeDeliveryMetricsHeading, describeDeliveryRow, describeFeatureCompletion, describeFeatureCount, describeFeatureListCount, describeFeatureListHeadings, describeFeatureProgress, describeFeatureRow, describeFeatureStart, describeFeatureTitle, describeFeatureWorkItemHeadings, describeFeatureWorkItemRow, describeFeatureWorkItemsHeading, describeHowManyTitle, describeInProgressNow, describeLastUpdated, describeManualForecastLikelihood, describeManualForecastSummary, describeMetricSummary, describeMetricsHeading, describeMissingCondition, describeNoBlackoutRules, describeNoDeliveries, describeNothingToTakeBack, describeOptionValue, describeOverTimeHeading, describeOwnerCount, describeOwnerListHeadings, describeOwnerListTitle, describeOwnerName, describeOwnerWriteConfirmation, describePercentileDate, describePercentileDay, describePercentileRows, describePercentilesOverTime, describePercentilesOverTimeDays, describePortfolioSummary, describePredictabilityScore, describePredictabilityScoreDays, describeProcessBehaviorChart, describeProcessBehaviorOverTime, describeProcessBehaviorOverTimeDays, describeReachable, describeReadiness, describeRecordedComment, describeRecordedDayHeadings, describeRecordedDayRow, describeRecordedDayTitle, describeRecordedVote, describeRefinementSummary, describeRefreshConfirmation, describeRefusedMetric, describeSleRiskNow, describeStaleNow, describeTags, describeTakenBack, describeTeamSummary, describeThroughputDays, describeTimeInState, describeTimeInStateContributorDays, describeTimeInStateDays, describeTotalArrivals, describeTotalThroughput, describeTotalWorkItemAge, describeTotalWorkItemAgeDays, describeUnknownMetric, describeVersion, describeVoteRefusal, describeVotes, describeWarnings, describeWhatWipLeavesUnsaid, describeWhenTitle, describeWipDays, describeWorkItemAgeDays, describeWorkItemAgePercentiles, describeWorkTrackingSystemCount, formatCalendarDay, formatLikelihood, formatTimestamp, getClientPackageContract, getDefaultMetricsDateRange, getStandaloneDiscoveryLockfilePath, getUsageDataStorePath, getVoterKeyScope, getVoterKeyStorePath, hideConnectionSecrets, isAPersonAtTheTerminal, isAtRiskOfMissingTheSle, isCalendarDay, isDoNotTrackSet, isMetricRefusal, isMissingItsCondition, isProcessBehaviorMetricType, isRefinementAnswer, isServerVersionNewerThan, keepVoterKey, latestRecordedDay, levelOf, likelihoodAnswer, loadStandaloneDiscoveryContract, metricsHeadlineLabel, mintVoterKey, moreThanYearsText, myVoteOn, nameOrFallback, ordinalOf, parseStandaloneDiscoveryContract, placeActualAmongPercentiles, placeEnoughForLine, planUsageDataStep, pollCliAuthSession, processBehaviorChartTitle, queryServerAuthMode, readAnswerWording, readArchivedDeliveryItem, readArrivals, readBacktest, readBlackoutRules, readBlocked, readCumulativeStateTime, readCycleTime, readCycleTimeDefinitionName, readCycleTimePercentiles, readDeliveryList, readDeliveryMetricsHistory, readFeatureList, readFeatureWording, readFeatureWorkItems, readInProgressItems, readManualForecast, readMetricAnswer, readMetricsSubject, readNameOfMyVote, readOwnerList, readPercentilesOverTime, readPortfolio, readPortfolioDeliveries, readPredictabilityScore, readProcessBehaviorChart, readProcessBehaviorOverTime, readRefinementTerms, readRefinementWording, readRunChart, readServiceLevelExpectation, readSleRisk, readStoredUsageDataAnswer, readSystemWipLimit, readTeam, readTerms, readThroughput, readTimeInStateBar, readTimeInStateContributors, readTotalWorkItemAge, readUsageDataState, readVoteRefusal, readWip, readWorkItemAge, readWorkItemAgePercentiles, readWorkTrackingConnection, readWorkTrackingConnections, readWrittenBlackoutRule, readWrittenOwner, refinementDayVerdictOf, resolveTerms, settleUsageDataStep, sizingMomentOf, startCliAuthSession, summariseDeliveryMetricsHistory, switchUsageDataOn, timeInStateItemCount, usageDataStoreFor, validateLighthouseConnectivity, voterKeyStoreFor, withdrawUsageData, yearsBeyondHorizon };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letpeoplework/lighthouse-client",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "description": "Shared Lighthouse API client contracts",
   "repository": {
     "type": "git",