@letpeoplework/lighthouse-client 1.10.0 → 1.12.0

package/dist/index.js

@@ -36,6 +36,20 @@ const PROCESS_BEHAVIOR_CHART_ROUTES = {
 const isProcessBehaviorMetricType = (value) => Object.hasOwn(PROCESS_BEHAVIOR_CHART_ROUTES, value);
 //#endregion
 //#region src/usageData.ts
+const reportTemplateWeDisclose = { "then-and-now": "ThenAndNow" };
+/**
+* The opening of a report Lighthouse sent: its type and nothing else about it. A refused read, or a report of a
+* type this version does not know, counts nothing.
+*/
+const reportOpenedOccurrencesOf = (answered) => {
+	if (!answered.ok || !isRecord$1(answered.value)) return [];
+	const { templateKey } = answered.value;
+	const reportTemplate = Object.entries(reportTemplateWeDisclose).find(([key]) => key === templateKey)?.[1];
+	return reportTemplate === void 0 ? [] : [{
+		name: "ReportOpened",
+		reportTemplate
+	}];
+};
 /**
 * When a vote was cast, from Lighthouse's answer rather than this machine's clock: Lighthouse counts days in
 * the instance's time zone and knows which cadence days are blacked out. The web counts it the same way.
@@ -241,13 +255,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 +434,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 +448,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 +458,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 +495,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 +666,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 +678,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 +763,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 +866,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 +898,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 +1186,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 +1406,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 +1450,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.`] : []
 	];
 };
@@ -2117,6 +2178,114 @@ const readNameOfMyVote = async (client, teamId, workItem, voterKey) => {
 	return log.ok ? nameOfMyVote(log.value) : null;
 };
 //#endregion
+//#region src/reportWording.ts
+const readWindow = (value) => isRecord(value) && isDay(value.start) && isDay(value.end) ? {
+	start: value.start,
+	end: value.end
+} : null;
+/** The report's name and windows, or null when the answer does not carry all three. */
+const readReport = (value) => {
+	if (!isRecord(value) || !isRecord(value.thenAndNow)) return null;
+	const name = textOf(value.name);
+	const thenWindow = readWindow(value.thenAndNow.thenWindow);
+	const nowWindow = readWindow(value.thenAndNow.nowWindow);
+	if (name === void 0 || thenWindow === null || nowWindow === null) return null;
+	return {
+		name,
+		thenWindow,
+		nowWindow
+	};
+};
+const readReportListItem = (value) => {
+	if (!isRecord(value) || typeof value.id !== "number") return null;
+	const name = textOf(value.name);
+	if (name === void 0) return null;
+	return {
+		id: value.id,
+		name,
+		templateKey: textOf(value.templateKey),
+		createdOn: textOf(value.createdOn)
+	};
+};
+/**
+* Every report in the list, or null when the answer holds no list or any one report comes without its id or
+* name: a row that cannot say which report it is would misname the whole list.
+*/
+const readReportList = (value) => {
+	if (!isRecord(value) || !Array.isArray(value.reports)) return null;
+	const items = value.reports.map(readReportListItem);
+	return items.every((item) => item !== null) ? items : null;
+};
+const ownerTerm$1 = (kind, terms) => kind === "team" ? terms.team : terms.portfolio;
+/** The owner as the instance names it, "Team Lightspeed", or by its id when its name could not be read. */
+const describeReportOwner = (kind, id, owner, terms) => {
+	const term = ownerTerm$1(kind, terms);
+	const name = isRecord(owner) ? textOf(owner.name) : void 0;
+	return name === void 0 ? `${term} [id: ${id}]` : `${term} ${name}`;
+};
+const describeWindow = (label, window) => `${label} ${dayOf(window.start)} – ${dayOf(window.end)}`;
+/** The report's name, its owner and its two windows, one to a line. */
+const describeReportSummary = (report, owner) => [
+	report.name,
+	owner,
+	`${describeWindow("Then", report.thenWindow)} · ${describeWindow("Now", report.nowWindow)}`
+].join("\n");
+const describeReportCount = (count) => {
+	if (count === 0) return "No reports";
+	return count === 1 ? "1 report" : `${count} reports`;
+};
+const describeReportListItem = (item) => [
+	`${item.name} [id: ${item.id}]`,
+	item.templateKey,
+	item.createdOn === void 0 ? void 0 : `created ${dayOf(item.createdOn)}`
+].filter((part) => part !== void 0).join(" · ");
+/** How many reports the owner has, then each report's name, type and created day. */
+const describeReportListSummary = (reports, owner) => [`${owner} · ${describeReportCount(reports.length)}`, ...reports.map(describeReportListItem)].join("\n");
+const summariseReport = (value, owner) => {
+	const report = readReport(value);
+	return report === null ? null : describeReportSummary(report, owner);
+};
+const summariseReportList = (value, owner) => {
+	const reports = readReportList(value);
+	return reports === null ? null : describeReportListSummary(reports, owner);
+};
+const FORBIDDEN = 403;
+const NOT_FOUND = 404;
+const NOTHING_THERE = {
+	list: (owner) => `There is no such ${owner}.`,
+	report: (owner) => `There is no such report for that ${owner}.`
+};
+/**
+* Why a report or a list could not be read, in words the reader can act on: the web's sentence where it has
+* one. Any other refusal, the client's own "upgrade Lighthouse" among them, keeps its category and reason.
+*/
+const describeReportRefusal = (error, kind, read, terms) => {
+	if (error.statusCode === FORBIDDEN) return `You have no access to that ${ownerTerm$1(kind, terms)}'s reports.`;
+	if (error.problemCode === "template-not-supported") return "This report was made by a newer version of Lighthouse and can't be shown here.";
+	if (error.statusCode === NOT_FOUND) return NOTHING_THERE[read](ownerTerm$1(kind, terms));
+	return `${error.category}: ${error.reason}`;
+};
+/**
+* {@link describeReportRefusal} in the instance's own words. A refusal the client made before asking, as for a
+* Lighthouse too old for reports, asks that Lighthouse nothing more, not even its words.
+*/
+const readReportRefusal = async (source, error, kind, read) => describeReportRefusal(error, kind, read, error.statusCode === void 0 ? SEEDED_TERMS : await readTerms(source));
+//#endregion
+//#region src/reportReads.ts
+/** The owner's list of reports, exactly as Lighthouse answers it. */
+const readOwnersReports = (reads, owner) => owner.kind === "team" ? reads.getTeamReports(owner.id) : reads.getPortfolioReports(owner.id);
+/** One of the owner's reports, exactly as Lighthouse answers it. */
+const readOwnersReport = (reads, owner, reportId) => owner.kind === "team" ? reads.getTeamReport(owner.id, reportId) : reads.getPortfolioReport(owner.id, reportId);
+/**
+* {@link describeReportOwner} for an owner read from Lighthouse. Its name only labels a summary, so an owner that
+* cannot be read is named by its id instead, and this never fails.
+*/
+const readReportOwner = async (source, owner) => {
+	const read = owner.kind === "team" ? source.getTeam(owner.id) : source.getPortfolio(owner.id);
+	const [terms, named] = await Promise.all([readTerms(source), read.then((answer) => answer.ok ? answer.value : void 0, () => void 0)]);
+	return describeReportOwner(owner.kind, owner.id, named, terms);
+};
+//#endregion
 //#region src/usageDataReporter.ts
 /** A command's own answer never waits on usage data for longer than this, whatever Lighthouse does. */
 const USAGE_DATA_BUDGET_MS = 1e3;
@@ -3158,7 +3327,9 @@ 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",
+	reports: "v26.10.10.1"
 };
 /**
 * Parses a Lighthouse version string ("v26.5.24.10", "26.5.24") into numeric
@@ -3220,6 +3391,7 @@ const createLighthouseClient = (configuration, dependencies = {}) => {
 			}
 		};
 	};
+	const readReports = async (route) => await ensureServerSupports("reports") ?? requestJson(configuration, dependencies, route, { method: "GET" });
 	return {
 		checkConnectivity: async () => {
 			const fetchDependency = getFetchDependency(dependencies);
@@ -3296,6 +3468,10 @@ const createLighthouseClient = (configuration, dependencies = {}) => {
 				headers: voterKeyHeaders(options?.voterKey)
 			});
 		},
+		getTeamReports: async (teamId) => readReports(`/v1/teams/${teamId}/reports`),
+		getTeamReport: async (teamId, reportId) => readReports(`/v1/teams/${teamId}/reports/${reportId}`),
+		getPortfolioReports: async (portfolioId) => readReports(`/v1/portfolios/${portfolioId}/reports`),
+		getPortfolioReport: async (portfolioId, reportId) => readReports(`/v1/portfolios/${portfolioId}/reports/${reportId}`),
 		getTerminology: async () => requestJson(configuration, dependencies, "/v1/terminology/all", { method: "GET" }),
 		listPortfolios: async () => requestJson(configuration, dependencies, "/v1/portfolios", { method: "GET" }),
 		getPortfolio: async (portfolioId) => requestJson(configuration, dependencies, `/v1/portfolios/${portfolioId}`, { method: "GET" }),
@@ -3615,4 +3791,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, describeReportListSummary, describeReportOwner, describeReportRefusal, describeReportSummary, 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, readOwnersReport, readOwnersReports, readPercentilesOverTime, readPortfolio, readPortfolioDeliveries, readPredictabilityScore, readProcessBehaviorChart, readProcessBehaviorOverTime, readRefinementTerms, readRefinementWording, readReport, readReportList, readReportOwner, readReportRefusal, readRunChart, readServiceLevelExpectation, readSleRisk, readStoredUsageDataAnswer, readSystemWipLimit, readTeam, readTerms, readThroughput, readTimeInStateBar, readTimeInStateContributors, readTotalWorkItemAge, readUsageDataState, readVoteRefusal, readWip, readWorkItemAge, readWorkItemAgePercentiles, readWorkTrackingConnection, readWorkTrackingConnections, readWrittenBlackoutRule, readWrittenOwner, refinementDayVerdictOf, reportOpenedOccurrencesOf, resolveTerms, settleUsageDataStep, sizingMomentOf, startCliAuthSession, summariseDeliveryMetricsHistory, summariseReport, summariseReportList, switchUsageDataOn, timeInStateItemCount, usageDataStoreFor, validateLighthouseConnectivity, voterKeyStoreFor, withdrawUsageData, yearsBeyondHorizon };

package/package.json

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