@letpeoplework/lighthouse-client 1.11.0 → 1.12.0

package/dist/index.cjs

@@ -37,6 +37,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.
@@ -2165,6 +2179,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;
@@ -3207,7 +3329,8 @@ const FEATURE_REQUIRES_SERVER_NEWER_THAN = {
 	sleRisk: "v26.9.19.10",
 	teamRefinement: "v26.10.3.6",
 	refinementVotes: "v26.10.3.6",
-	staleness: "v26.10.16.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
@@ -3269,6 +3392,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);
@@ -3345,6 +3469,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" }),
@@ -3775,6 +3903,10 @@ exports.describeRecordedVote = describeRecordedVote;
 exports.describeRefinementSummary = describeRefinementSummary;
 exports.describeRefreshConfirmation = describeRefreshConfirmation;
 exports.describeRefusedMetric = describeRefusedMetric;
+exports.describeReportListSummary = describeReportListSummary;
+exports.describeReportOwner = describeReportOwner;
+exports.describeReportRefusal = describeReportRefusal;
+exports.describeReportSummary = describeReportSummary;
 exports.describeSleRiskNow = describeSleRiskNow;
 exports.describeStaleNow = describeStaleNow;
 exports.describeTags = describeTags;
@@ -3857,6 +3989,8 @@ exports.readMetricAnswer = readMetricAnswer;
 exports.readMetricsSubject = readMetricsSubject;
 exports.readNameOfMyVote = readNameOfMyVote;
 exports.readOwnerList = readOwnerList;
+exports.readOwnersReport = readOwnersReport;
+exports.readOwnersReports = readOwnersReports;
 exports.readPercentilesOverTime = readPercentilesOverTime;
 exports.readPortfolio = readPortfolio;
 exports.readPortfolioDeliveries = readPortfolioDeliveries;
@@ -3865,6 +3999,10 @@ exports.readProcessBehaviorChart = readProcessBehaviorChart;
 exports.readProcessBehaviorOverTime = readProcessBehaviorOverTime;
 exports.readRefinementTerms = readRefinementTerms;
 exports.readRefinementWording = readRefinementWording;
+exports.readReport = readReport;
+exports.readReportList = readReportList;
+exports.readReportOwner = readReportOwner;
+exports.readReportRefusal = readReportRefusal;
 exports.readRunChart = readRunChart;
 exports.readServiceLevelExpectation = readServiceLevelExpectation;
 exports.readSleRisk = readSleRisk;
@@ -3886,11 +4024,14 @@ exports.readWorkTrackingConnections = readWorkTrackingConnections;
 exports.readWrittenBlackoutRule = readWrittenBlackoutRule;
 exports.readWrittenOwner = readWrittenOwner;
 exports.refinementDayVerdictOf = refinementDayVerdictOf;
+exports.reportOpenedOccurrencesOf = reportOpenedOccurrencesOf;
 exports.resolveTerms = resolveTerms;
 exports.settleUsageDataStep = settleUsageDataStep;
 exports.sizingMomentOf = sizingMomentOf;
 exports.startCliAuthSession = startCliAuthSession;
 exports.summariseDeliveryMetricsHistory = summariseDeliveryMetricsHistory;
+exports.summariseReport = summariseReport;
+exports.summariseReportList = summariseReportList;
 exports.switchUsageDataOn = switchUsageDataOn;
 exports.timeInStateItemCount = timeInStateItemCount;
 exports.usageDataStoreFor = usageDataStoreFor;

package/dist/index.d.cts

@@ -8,8 +8,10 @@ export type PlainUsageDataEventName = "TeamCreated" | "TeamDeleted" | "Portfolio
 export type SizingUsageDataEventName = "TeamSizingVoteCast" | "TeamSizingReadinessReached";
 /** The usage event that says which verdict a Team's Refinement showed on its Refinement day. */
 export type VerdictUsageDataEventName = "TeamRefinementDayVerdictShown";
+/** The usage event that says a report was read, and of which type. */
+export type ReportUsageDataEventName = "ReportOpened";
 /** The usage events a client reports, by the names Lighthouse already counts for the web. */
-export type UsageDataEventName = PlainUsageDataEventName | SizingUsageDataEventName | VerdictUsageDataEventName;
+export type UsageDataEventName = PlainUsageDataEventName | SizingUsageDataEventName | VerdictUsageDataEventName | ReportUsageDataEventName;
 /** Fewer Work Items ready than needed, enough, more than enough, or no number at all. */
 export type UsageDataRefinementVerdict = "Below" | "In" | "Above" | "None";
 export type UsageDataSizingMoment = "NoCadence" | "OnRefinementDay" | "OnOtherDay";
@@ -22,7 +24,19 @@ export type UsageDataOccurrence = {
 } | {
   readonly name: VerdictUsageDataEventName;
   readonly refinementVerdict: UsageDataRefinementVerdict;
+} | {
+  readonly name: ReportUsageDataEventName;
+  readonly reportTemplate: UsageDataReportTemplate;
 };
+/** A report's type as Lighthouse names it when it sends the report. */
+export type ReportTemplateKey = "then-and-now";
+/** A report's type in the words usage data publishes, the same the web uses. */
+export type UsageDataReportTemplate = "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.
+ */
+export declare const reportOpenedOccurrencesOf: (answered: LighthouseApiResult<unknown>) => readonly UsageDataOccurrence[];
 /** What Lighthouse's answer about a Team's Refinement says about today. */
 export type RefinementMomentFacts = {
   readonly nextRefinementDate: string | null;
@@ -1051,6 +1065,86 @@ export declare const myVoteOn: (refinement: Pick<TeamRefinement, "workItems">, w
 /** {@link nameOfMyVote}, read from Lighthouse; null when the log cannot be read either. */
 export declare const readNameOfMyVote: (client: Pick<LighthouseClient, "getRefinementLog">, teamId: number, workItem: string, voterKey: string | undefined) => Promise<string | null>;
 //#endregion
+//#region src/reportWording.d.ts
+/** Who a report belongs to: a Team or a Portfolio. */
+export type ReportOwnerKind = "team" | "portfolio";
+/** The Team or Portfolio whose reports are read, by its id. */
+export type ReportOwner = {
+  readonly kind: ReportOwnerKind;
+  readonly id: number;
+};
+/** A window of days as Lighthouse sends it: its first and its last day. */
+export type ReportWindow = {
+  readonly start: string;
+  readonly end: string;
+};
+/** What a report's summary says: its name and its two windows. */
+export type ReportView = {
+  readonly name: string;
+  readonly thenWindow: ReportWindow;
+  readonly nowWindow: ReportWindow;
+};
+/** One report as a list row shows it. Fields Lighthouse did not send stay undefined. */
+export type ReportListItem = {
+  readonly id: number;
+  readonly name: string;
+  readonly templateKey: string | undefined;
+  readonly createdOn: string | undefined;
+};
+/** The report's name and windows, or null when the answer does not carry all three. */
+export declare const readReport: (value: unknown) => ReportView | null;
+/**
+ * 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.
+ */
+export declare const readReportList: (value: unknown) => ReportListItem[] | null;
+/** The owner as the instance names it, "Team Lightspeed", or by its id when its name could not be read. */
+export declare const describeReportOwner: (kind: ReportOwnerKind, id: number, owner: unknown, terms: Terms) => string;
+/** The report's name, its owner and its two windows, one to a line. */
+export declare const describeReportSummary: (report: ReportView, owner: string) => string;
+/** How many reports the owner has, then each report's name, type and created day. */
+export declare const describeReportListSummary: (reports: readonly ReportListItem[], owner: string) => string;
+/** A summary of Lighthouse's answer, said of its owner; null when the answer is not one the summary can read. */
+export type ReportSummariser = (value: unknown, owner: string) => string | null;
+export declare const summariseReport: ReportSummariser;
+export declare const summariseReportList: ReportSummariser;
+/** What was read: the owner's list of reports, or one report. */
+export type ReportRead = "list" | "report";
+/**
+ * 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.
+ */
+export declare const describeReportRefusal: (error: LighthouseApiError, kind: ReportOwnerKind, read: ReportRead, terms: Terms) => string;
+/**
+ * {@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.
+ */
+export declare const readReportRefusal: (source: TermsSource, error: LighthouseApiError, kind: ReportOwnerKind, read: ReportRead) => Promise<string>;
+//#endregion
+//#region src/reportReads.d.ts
+/** The four report reads, a Team's and a Portfolio's list and one report of each. */
+export type ReportReads = Pick<LighthouseClient, "getTeamReports" | "getTeamReport" | "getPortfolioReports" | "getPortfolioReport">;
+/** The owner's list of reports, exactly as Lighthouse answers it. */
+export declare const readOwnersReports: (reads: ReportReads, owner: ReportOwner) => Promise<LighthouseApiResult<unknown>>;
+/** One of the owner's reports, exactly as Lighthouse answers it. */
+export declare const readOwnersReport: (reads: ReportReads, owner: ReportOwner, reportId: number) => Promise<LighthouseApiResult<unknown>>;
+type OwnerRead = (id: number) => Promise<{
+  readonly ok: true;
+  readonly value: unknown;
+} | {
+  readonly ok: false;
+}>;
+/** Where the owner's name and the instance's words are read from. */
+export type ReportOwnerSource = TermsSource & {
+  readonly getTeam: OwnerRead;
+  readonly getPortfolio: OwnerRead;
+};
+/**
+ * {@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.
+ */
+export declare const readReportOwner: (source: ReportOwnerSource, owner: ReportOwner) => Promise<string>;
+//#endregion
 //#region src/usageDataStore.d.ts
 /** The answer kept for a Lighthouse, undefined when never asked there, or "unreadable" when the file is not ours. */
 export type UsageDataStoreReading = StoredUsageDataAnswer | undefined | "unreadable";
@@ -1799,6 +1893,11 @@ export type LighthouseClient = {
   readonly addRefinementComment: (teamId: number, workItem: string, comment: RefinementCommentInput) => Promise<LighthouseApiResult<VotedRow>>;
   readonly takeBackRefinementVote: (teamId: number, workItem: string, takeBack: RefinementTakeBackInput) => Promise<LighthouseApiResult<VotedRow>>;
   readonly getRefinementLog: (teamId: number, workItem: string, options?: RefinementReadOptions) => Promise<LighthouseApiResult<SizingLog>>;
+  /** A report list or a report exactly as Lighthouse answers it, so nothing on the way rounds or judges a value. */
+  readonly getTeamReports: (teamId: number) => Promise<LighthouseApiResult<unknown>>;
+  readonly getTeamReport: (teamId: number, reportId: number) => Promise<LighthouseApiResult<unknown>>;
+  readonly getPortfolioReports: (portfolioId: number) => Promise<LighthouseApiResult<unknown>>;
+  readonly getPortfolioReport: (portfolioId: number, reportId: number) => Promise<LighthouseApiResult<unknown>>;
   readonly getTerminology: () => Promise<LighthouseApiResult<readonly TerminologyEntry[]>>;
   readonly listPortfolios: () => Promise<LighthouseApiResult<readonly unknown[]>>;
   readonly getPortfolio: (portfolioId: number) => Promise<LighthouseApiResult<unknown>>;
@@ -1897,6 +1996,7 @@ export declare const FEATURE_REQUIRES_SERVER_NEWER_THAN: {
   readonly teamRefinement: "v26.10.3.6";
   readonly refinementVotes: "v26.10.3.6";
   readonly staleness: "v26.10.16.6";
+  readonly reports: "v26.10.10.1";
 };
 /**
  * Returns true when `candidate` is strictly newer than `baseline`, false when

package/dist/index.d.ts

@@ -8,8 +8,10 @@ export type PlainUsageDataEventName = "TeamCreated" | "TeamDeleted" | "Portfolio
 export type SizingUsageDataEventName = "TeamSizingVoteCast" | "TeamSizingReadinessReached";
 /** The usage event that says which verdict a Team's Refinement showed on its Refinement day. */
 export type VerdictUsageDataEventName = "TeamRefinementDayVerdictShown";
+/** The usage event that says a report was read, and of which type. */
+export type ReportUsageDataEventName = "ReportOpened";
 /** The usage events a client reports, by the names Lighthouse already counts for the web. */
-export type UsageDataEventName = PlainUsageDataEventName | SizingUsageDataEventName | VerdictUsageDataEventName;
+export type UsageDataEventName = PlainUsageDataEventName | SizingUsageDataEventName | VerdictUsageDataEventName | ReportUsageDataEventName;
 /** Fewer Work Items ready than needed, enough, more than enough, or no number at all. */
 export type UsageDataRefinementVerdict = "Below" | "In" | "Above" | "None";
 export type UsageDataSizingMoment = "NoCadence" | "OnRefinementDay" | "OnOtherDay";
@@ -22,7 +24,19 @@ export type UsageDataOccurrence = {
 } | {
   readonly name: VerdictUsageDataEventName;
   readonly refinementVerdict: UsageDataRefinementVerdict;
+} | {
+  readonly name: ReportUsageDataEventName;
+  readonly reportTemplate: UsageDataReportTemplate;
 };
+/** A report's type as Lighthouse names it when it sends the report. */
+export type ReportTemplateKey = "then-and-now";
+/** A report's type in the words usage data publishes, the same the web uses. */
+export type UsageDataReportTemplate = "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.
+ */
+export declare const reportOpenedOccurrencesOf: (answered: LighthouseApiResult<unknown>) => readonly UsageDataOccurrence[];
 /** What Lighthouse's answer about a Team's Refinement says about today. */
 export type RefinementMomentFacts = {
   readonly nextRefinementDate: string | null;
@@ -1051,6 +1065,86 @@ export declare const myVoteOn: (refinement: Pick<TeamRefinement, "workItems">, w
 /** {@link nameOfMyVote}, read from Lighthouse; null when the log cannot be read either. */
 export declare const readNameOfMyVote: (client: Pick<LighthouseClient, "getRefinementLog">, teamId: number, workItem: string, voterKey: string | undefined) => Promise<string | null>;
 //#endregion
+//#region src/reportWording.d.ts
+/** Who a report belongs to: a Team or a Portfolio. */
+export type ReportOwnerKind = "team" | "portfolio";
+/** The Team or Portfolio whose reports are read, by its id. */
+export type ReportOwner = {
+  readonly kind: ReportOwnerKind;
+  readonly id: number;
+};
+/** A window of days as Lighthouse sends it: its first and its last day. */
+export type ReportWindow = {
+  readonly start: string;
+  readonly end: string;
+};
+/** What a report's summary says: its name and its two windows. */
+export type ReportView = {
+  readonly name: string;
+  readonly thenWindow: ReportWindow;
+  readonly nowWindow: ReportWindow;
+};
+/** One report as a list row shows it. Fields Lighthouse did not send stay undefined. */
+export type ReportListItem = {
+  readonly id: number;
+  readonly name: string;
+  readonly templateKey: string | undefined;
+  readonly createdOn: string | undefined;
+};
+/** The report's name and windows, or null when the answer does not carry all three. */
+export declare const readReport: (value: unknown) => ReportView | null;
+/**
+ * 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.
+ */
+export declare const readReportList: (value: unknown) => ReportListItem[] | null;
+/** The owner as the instance names it, "Team Lightspeed", or by its id when its name could not be read. */
+export declare const describeReportOwner: (kind: ReportOwnerKind, id: number, owner: unknown, terms: Terms) => string;
+/** The report's name, its owner and its two windows, one to a line. */
+export declare const describeReportSummary: (report: ReportView, owner: string) => string;
+/** How many reports the owner has, then each report's name, type and created day. */
+export declare const describeReportListSummary: (reports: readonly ReportListItem[], owner: string) => string;
+/** A summary of Lighthouse's answer, said of its owner; null when the answer is not one the summary can read. */
+export type ReportSummariser = (value: unknown, owner: string) => string | null;
+export declare const summariseReport: ReportSummariser;
+export declare const summariseReportList: ReportSummariser;
+/** What was read: the owner's list of reports, or one report. */
+export type ReportRead = "list" | "report";
+/**
+ * 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.
+ */
+export declare const describeReportRefusal: (error: LighthouseApiError, kind: ReportOwnerKind, read: ReportRead, terms: Terms) => string;
+/**
+ * {@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.
+ */
+export declare const readReportRefusal: (source: TermsSource, error: LighthouseApiError, kind: ReportOwnerKind, read: ReportRead) => Promise<string>;
+//#endregion
+//#region src/reportReads.d.ts
+/** The four report reads, a Team's and a Portfolio's list and one report of each. */
+export type ReportReads = Pick<LighthouseClient, "getTeamReports" | "getTeamReport" | "getPortfolioReports" | "getPortfolioReport">;
+/** The owner's list of reports, exactly as Lighthouse answers it. */
+export declare const readOwnersReports: (reads: ReportReads, owner: ReportOwner) => Promise<LighthouseApiResult<unknown>>;
+/** One of the owner's reports, exactly as Lighthouse answers it. */
+export declare const readOwnersReport: (reads: ReportReads, owner: ReportOwner, reportId: number) => Promise<LighthouseApiResult<unknown>>;
+type OwnerRead = (id: number) => Promise<{
+  readonly ok: true;
+  readonly value: unknown;
+} | {
+  readonly ok: false;
+}>;
+/** Where the owner's name and the instance's words are read from. */
+export type ReportOwnerSource = TermsSource & {
+  readonly getTeam: OwnerRead;
+  readonly getPortfolio: OwnerRead;
+};
+/**
+ * {@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.
+ */
+export declare const readReportOwner: (source: ReportOwnerSource, owner: ReportOwner) => Promise<string>;
+//#endregion
 //#region src/usageDataStore.d.ts
 /** The answer kept for a Lighthouse, undefined when never asked there, or "unreadable" when the file is not ours. */
 export type UsageDataStoreReading = StoredUsageDataAnswer | undefined | "unreadable";
@@ -1799,6 +1893,11 @@ export type LighthouseClient = {
   readonly addRefinementComment: (teamId: number, workItem: string, comment: RefinementCommentInput) => Promise<LighthouseApiResult<VotedRow>>;
   readonly takeBackRefinementVote: (teamId: number, workItem: string, takeBack: RefinementTakeBackInput) => Promise<LighthouseApiResult<VotedRow>>;
   readonly getRefinementLog: (teamId: number, workItem: string, options?: RefinementReadOptions) => Promise<LighthouseApiResult<SizingLog>>;
+  /** A report list or a report exactly as Lighthouse answers it, so nothing on the way rounds or judges a value. */
+  readonly getTeamReports: (teamId: number) => Promise<LighthouseApiResult<unknown>>;
+  readonly getTeamReport: (teamId: number, reportId: number) => Promise<LighthouseApiResult<unknown>>;
+  readonly getPortfolioReports: (portfolioId: number) => Promise<LighthouseApiResult<unknown>>;
+  readonly getPortfolioReport: (portfolioId: number, reportId: number) => Promise<LighthouseApiResult<unknown>>;
   readonly getTerminology: () => Promise<LighthouseApiResult<readonly TerminologyEntry[]>>;
   readonly listPortfolios: () => Promise<LighthouseApiResult<readonly unknown[]>>;
   readonly getPortfolio: (portfolioId: number) => Promise<LighthouseApiResult<unknown>>;
@@ -1897,6 +1996,7 @@ export declare const FEATURE_REQUIRES_SERVER_NEWER_THAN: {
   readonly teamRefinement: "v26.10.3.6";
   readonly refinementVotes: "v26.10.3.6";
   readonly staleness: "v26.10.16.6";
+  readonly reports: "v26.10.10.1";
 };
 /**
  * Returns true when `candidate` is strictly newer than `baseline`, false when

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.
@@ -2164,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;
@@ -3206,7 +3328,8 @@ const FEATURE_REQUIRES_SERVER_NEWER_THAN = {
 	sleRisk: "v26.9.19.10",
 	teamRefinement: "v26.10.3.6",
 	refinementVotes: "v26.10.3.6",
-	staleness: "v26.10.16.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
@@ -3268,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);
@@ -3344,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" }),
@@ -3663,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, 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 };
+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.11.0",
+  "version": "1.12.0",
   "description": "Shared Lighthouse API client contracts",
   "repository": {
     "type": "git",