@zaip-ai/cli 1.0.8 → 1.3.1

package/templates/.agents/dashboard/modules/operations/src/react/OperationsOverviewTopPanel.tsx

@@ -0,0 +1,127 @@
+import {
+  formatCompactNumber,
+  formatCurrency,
+  formatDurationMs,
+  formatPercent,
+} from "@zaip-ai/dashboard-ui";
+import type { EntityMetric } from "./OperationsOverview.helpers.js";
+import type { OperationsLocale } from "./status-labels.js";
+
+type OverviewView = "tasks" | "specs" | "prds";
+
+const duration = (value: number | null, locale: OperationsLocale) =>
+  value === null
+    ? locale === "pt-BR"
+      ? "Indisponível"
+      : "Unavailable"
+    : formatDurationMs(value, locale);
+
+export function OperationsOverviewTopPanel({
+  copy,
+  currency,
+  locale,
+  maxDuration,
+  onOpenTask,
+  summary,
+  text,
+  topCost,
+  topEntities,
+  view,
+}: {
+  copy: { empty: string; hint: string; title: string };
+  currency: "BRL" | "USD";
+  locale: OperationsLocale;
+  maxDuration: number;
+  onOpenTask: (taskId: string) => Promise<boolean>;
+  summary: {
+    durationMs: number | null;
+    durationShare: number;
+    runCount: number;
+    tokens: number | null;
+  };
+  text: {
+    accumulatedTime: string;
+    associatedRuns: string;
+    concentration: string;
+    totalMeasuredTime: string;
+    topFiveCost: string;
+    tokensUnavailable: string;
+  };
+  topCost: number | null;
+  topEntities: readonly EntityMetric[];
+  view: OverviewView;
+}) {
+  const entityKind = view === "specs" ? "SPEC" : "PRD";
+  return (
+    <article className="operations-panel">
+      <header className="operations-panel-header">
+        <div className="operations-panel-header-title">
+          <h2>{copy.title}</h2>
+        </div>
+        <small>{copy.hint}</small>
+      </header>
+      {topEntities.length === 0 ? (
+        <p className="operations-empty">{copy.empty}</p>
+      ) : (
+        <>
+          <div className="operations-run-bars">
+            {topEntities.map((entity, index) => {
+              const measuredDuration = duration(entity.durationMs, locale);
+              const label =
+                view === "tasks"
+                  ? `${locale === "pt-BR" ? "Abrir detalhes da tarefa" : "Open task details for"} ${entity.title}: ${measuredDuration}`
+                  : `${entityKind} ${entity.title}: ${measuredDuration}`;
+              return (
+                <button
+                  aria-label={label}
+                  className={`operations-run-bar${entity.durationMs === null ? " is-duration-unavailable" : ""}`}
+                  disabled={view !== "tasks"}
+                  key={entity.id}
+                  onClick={() => void onOpenTask(entity.id)}
+                  title={`${entity.title}: ${measuredDuration}`}
+                  type="button"
+                >
+                  <strong>{measuredDuration}</strong>
+                  <i
+                    style={{
+                      height:
+                        entity.durationMs === null
+                          ? "0%"
+                          : `${Math.max(8, (entity.durationMs / maxDuration) * 100)}%`,
+                    }}
+                  />
+                  <span>{`#${index + 1} ${entity.id.slice(-4)}`}</span>
+                </button>
+              );
+            })}
+          </div>
+          <div className="operations-top-task-metrics">
+            <div>
+              <span>{text.accumulatedTime}</span>
+              <strong>{duration(summary.durationMs, locale)}</strong>
+              <small>{`${summary.runCount} ${text.associatedRuns}`}</small>
+            </div>
+            <div>
+              <span>{text.concentration}</span>
+              <strong>{formatPercent(summary.durationShare, locale)}</strong>
+              <small>{text.totalMeasuredTime}</small>
+            </div>
+            <div>
+              <span>{text.topFiveCost}</span>
+              <strong>
+                {topCost === null
+                  ? duration(null, locale)
+                  : formatCurrency(topCost, currency, locale)}
+              </strong>
+              <small>
+                {summary.tokens === null
+                  ? text.tokensUnavailable
+                  : `${formatCompactNumber(summary.tokens, locale)} tokens`}
+              </small>
+            </div>
+          </div>
+        </>
+      )}
+    </article>
+  );
+}

package/templates/.agents/dashboard/modules/operations/src/react/OperationsPage.tsx

@@ -32,18 +32,20 @@ import {
   type OperationDatePreset,
   type OperationDateRange,
 } from "./operation-date-range.js";
-import {
-  filterStatusLabel,
-  type OperationsView,
-  statusesForView,
-} from "./operations-page-filters.js";
+import type { OperationsView } from "./operations-page-filters.js";
 import { macrosWithPeriodActivity } from "./operations-period-scope.js";
 import { matchesQuery } from "./operations-query.js";
 import { viewLabels } from "./operations-view-labels.js";
-import { aggregateManifestPeriodSummary, aggregatePeriodSummary } from "./period-summary.js";
+import { applyFactualPeriodCosts, applyFactualPeriodDurations } from "./PeriodSummaryTable.js";
+import {
+  aggregateManifestPeriodSummary,
+  aggregatePeriodSummary,
+  type PeriodGranularity,
+  type PeriodSummaryRow,
+} from "./period-summary.js";
 import { periodSummaryPopulation } from "./period-summary-population.js";
 import { scopeRunsToEntities } from "./run-scope.js";
-import { type OperationsLocale, riskLabel } from "./status-labels.js";
+import { riskLabel } from "./status-labels.js";
 import {
   matchesTaskOrigin,
   type TaskOrigin,
@@ -63,12 +65,24 @@ import "./operations-date-filters.css";
 import "./operations-filter-panel.css";
 import "./operations-responsive.css";
 
+/** Applies Cost Monitor duration facts only to the Operations period exports that share them. */
+export function factualDurationRowsForExport(
+  granularity: PeriodGranularity,
+  rows: readonly PeriodSummaryRow[],
+  factualRows?: readonly { key: string; duration_ms: number | null }[],
+): PeriodSummaryRow[] {
+  return granularity === "month" || granularity === "year"
+    ? applyFactualPeriodDurations(rows, factualRows)
+    : [...rows];
+}
+
 export function OperationsPage({
   alternateContent,
   boardTotals,
   boardKindTotals,
   boardStates,
   boardExportSource,
+  detailExportSource,
   capabilityNavigation,
   currency,
   data,
@@ -80,7 +94,7 @@ export function OperationsPage({
   onOpenDocument,
   onOpenTask,
   onPriorityChange,
-  onDetailDataRequest,
+  onLoadMacroMetrics,
   entityPage,
   onEntityPageChange,
   onEntityFiltersChange,
@@ -88,6 +102,8 @@ export function OperationsPage({
   onWorkListFiltersChange,
   onBoardTypeChange,
   onWorkListTypeChange,
+  onWorkListPageChange,
+  workListPage,
   onLoadMoreBoard,
   onLoadStatusPage,
   statusPage,
@@ -172,24 +188,6 @@ export function OperationsPage({
     showFilterLoading();
     const nextWorkListType = workListTypeOnViewChange(nextView);
     if (nextWorkListType !== null) onWorkListTypeChange?.(nextWorkListType);
-    // Calendar reports are served by the compact canonical daily summary;
-    // they must not hydrate entity detail merely to render month/year rolls.
-    if (
-      ![
-        "work-kanban",
-        "work-list",
-        "daily",
-        "monthly",
-        "yearly",
-        "runs",
-        "conversations",
-        "executions",
-        "changes",
-        "decisions",
-      ].includes(nextView)
-    ) {
-      onDetailDataRequest?.(nextView);
-    }
     setView(nextView);
     setStatusFilter("");
     setRiskFilter("");
@@ -232,10 +230,6 @@ export function OperationsPage({
     statusFilter,
     view,
   ]);
-  const availableStatuses = statusesForView(data, view);
-  const supportsStatus = !["decisions", "daily", "monthly", "yearly"].includes(view);
-  const supportsRisk = view === "work-kanban" || view === "work-list" || view === "changes";
-  const supportsOrigin = view === "work-kanban" || view === "work-list";
   // Only work views interpret a status option as a canonical work stage.
   // Runs, Changes and Executions use their respective persisted statuses.
   const hasEntityStageStatus =
@@ -383,8 +377,25 @@ export function OperationsPage({
               ),
               granularity,
             );
+      // Export the exact period facts shown in the report. In particular, the
+      // compact Operations summary can carry a stale/missing cost while Cost
+      // Monitor has the factual selected-currency amount for the same key.
+      // Keep null when neither source has a factual value.
+      const costRows = applyFactualPeriodCosts(
+        periodRows,
+        currency,
+        factualCostPeriods?.[granularity],
+      );
+      // The monthly and annual Cost Monitor groups carry the factual duration
+      // for the same snapshot. Only fill an unavailable Operations value;
+      // never derive time or overwrite a known period duration.
+      const displayedRows = factualDurationRowsForExport(
+        granularity,
+        costRows,
+        factualCostPeriods?.[granularity],
+      );
       // Keep the period XLSX contract identical to Cost Monitor.
-      return periodRows.map((row) => ({
+      return displayedRows.map((row) => ({
         key: row.key,
         prds: row.prds,
         specs: row.specs,
@@ -414,6 +425,7 @@ export function OperationsPage({
     conversationRuns,
     decisions,
     executions,
+    factualCostPeriods,
     prds,
     resolveRunCost,
     runs,
@@ -425,6 +437,7 @@ export function OperationsPage({
     data.filters,
     dailyPeriods,
     matchesSelectedDate,
+    currency,
   ]);
   const isLoading = loading || filterLoading;
   useEffect(() => onLoadingChange?.(isLoading), [isLoading, onLoadingChange]);
@@ -636,8 +649,6 @@ export function OperationsPage({
           <OperationsPageLoading locale={locale} />
         ) : (
           <>
-            {/* <OperationsOverview runs={runs} tasks={tasks} specs={specs} prds={prds} /> */}
-            {/* <section className="dashboard-global-controls"></section> */}
             <OperationsPageOverview
               capabilityNavigation={capabilityNavigation}
               currency={currency}
@@ -664,6 +675,7 @@ export function OperationsPage({
               onLoadStatusPage={onLoadStatusPage}
               classificationPage={classificationPage}
               onLoadClassificationPage={onLoadClassificationPage}
+              onLoadMacroMetrics={onLoadMacroMetrics}
               updatePeriod={updatePeriod}
             />
 
@@ -690,7 +702,17 @@ export function OperationsPage({
                               risk: riskFilter,
                               origin: originFilter,
                             })
-                          : undefined
+                          : detailExportSource?.(view, {
+                              query,
+                              status: statusFilter,
+                              risk: riskFilter,
+                              origin: originFilter,
+                              ...(view === "work-list" &&
+                              workListPage !== undefined &&
+                              workListPage.typeFilter !== "all"
+                                ? { kind: workListPage.typeFilter }
+                                : {}),
+                            })
                       }
                       view={`operations-${view}`}
                     />
@@ -713,8 +735,9 @@ export function OperationsPage({
                   locale={locale}
                   onBoardTypeChange={onBoardTypeChange}
                   onEntityPageChange={onEntityPageChange}
-        onLoadMoreBoard={onLoadMoreBoard}
-        onWorkListTypeChange={onWorkListTypeChange}
+                  onLoadMoreBoard={onLoadMoreBoard}
+                  onWorkListTypeChange={onWorkListTypeChange}
+                  onWorkListPageChange={onWorkListPageChange}
                   onOpenDocument={onOpenDocument}
                   onOpenTask={onOpenTask}
                   onPriorityChange={onPriorityChange}
@@ -724,6 +747,7 @@ export function OperationsPage({
                   specs={specs}
                   summaryPopulation={summaryPopulation}
                   tasks={tasks}
+                  workListPage={workListPage}
                   view={view}
                 />
               </>
@@ -739,18 +763,3 @@ export function OperationsPage({
 export function shouldRenderOperationsContent(loading: boolean): boolean {
   return !loading;
 }
-
-function _OperationsPageLoading({ locale }: { locale: OperationsLocale }) {
-  return (
-    <section
-      aria-busy="true"
-      aria-live="polite"
-      className="operations-content-skeleton"
-      role="status"
-    >
-      <span>
-        {locale === "pt-BR" ? "Carregando o período selecionado…" : "Loading selected period…"}
-      </span>
-    </section>
-  );
-}

package/templates/.agents/dashboard/modules/operations/src/react/OperationsPageNavigation.tsx

@@ -11,10 +11,7 @@ export function OperationsViewTabs({
   onChange: (view: OperationsView) => void;
   view: OperationsView;
 }) {
-  const views = [
-    "work-kanban",
-    "work-list",
-  ] as const;
+  const views = ["work-kanban", "work-list"] as const;
   return (
     <nav aria-label="Entidades do ciclo de trabalho">
       {views.map((key) => (

package/templates/.agents/dashboard/modules/operations/src/react/OperationsPageOverview.tsx

@@ -28,6 +28,7 @@ export function OperationsPageOverview({
   onLoadStatusPage,
   classificationPage,
   onLoadClassificationPage,
+  onLoadMacroMetrics,
   prds,
   query,
   resolveRunCost,
@@ -55,6 +56,7 @@ export function OperationsPageOverview({
   onLoadStatusPage: OverviewProps["onLoadStatusPage"];
   classificationPage: OverviewProps["classificationPage"];
   onLoadClassificationPage: OverviewProps["onLoadClassificationPage"];
+  onLoadMacroMetrics: OverviewProps["onLoadMacroMetrics"];
   prds: NonNullable<OverviewProps["prds"]>;
   query: string;
   resolveRunCost: OverviewProps["resolveRunCost"];
@@ -93,6 +95,7 @@ export function OperationsPageOverview({
         onLoadStatusPage={onLoadStatusPage}
         classificationPage={classificationPage}
         onLoadClassificationPage={onLoadClassificationPage}
+        onLoadMacroMetrics={onLoadMacroMetrics}
         prds={prds}
         runs={runs}
         resolveRunCost={resolveRunCost}

package/templates/.agents/dashboard/modules/operations/src/react/PagedWorkList.test.tsx

@@ -0,0 +1,43 @@
+import { createElement } from "react";
+import { renderToStaticMarkup } from "react-dom/server";
+import { describe, expect, it } from "vitest";
+import { PagedWorkList } from "./PagedWorkList.js";
+
+describe("PagedWorkList", () => {
+  it("renders the factual developer column without object coercion", () => {
+    const markup = renderToStaticMarkup(
+      createElement(PagedWorkList, {
+        loading: false,
+        locale: "pt-BR",
+        onPageChange: () => undefined,
+        onTypeChange: () => undefined,
+        page: {
+          error: null,
+          hasMore: false,
+          limit: 10,
+          loading: false,
+          offset: 0,
+          rows: [
+            {
+              developers: [
+                { account_id: "199126185", login_snapshot: "zaip-ai" },
+                { account_id: "200", login_snapshot: null },
+              ],
+              id: "TASK-1",
+              kind: "task",
+              risk: "standard",
+              status: "executing",
+              title: "List developer identities",
+            },
+          ],
+          total: 1,
+          typeFilter: "all",
+        },
+      }),
+    );
+
+    expect(markup).toContain("Desenvolvedor");
+    expect(markup).toContain("zaip-ai (199126185); 200");
+    expect(markup).not.toContain("[object Object]");
+  });
+});

package/templates/.agents/dashboard/modules/operations/src/react/PagedWorkList.tsx

@@ -0,0 +1,181 @@
+import { DataTable, formatCompactNumber, formatCurrency } from "@zaip-ai/dashboard-ui";
+import { formatDeveloperIdentities } from "./developer-identities.js";
+import { formatRoundedDuration } from "./format-rounded-duration.js";
+import type { OperationsLocale } from "./status-labels.js";
+import { WorkTypeFilters } from "./UnifiedWorkBoard.js";
+import type { WorkTypeFilter } from "./work-board-model.js";
+
+export type PagedWorkListRow = Record<string, unknown>;
+export type PagedWorkListPage = {
+  offset: number;
+  limit: number;
+  total: number | null;
+  hasMore: boolean;
+  typeFilter: WorkTypeFilter;
+  rows: readonly PagedWorkListRow[];
+  loading: boolean;
+  error: string | null;
+};
+
+function text(value: unknown, fallback = "—") {
+  return typeof value === "string" && value.length > 0 ? value : fallback;
+}
+
+function number(value: unknown): number | null {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+
+function workKindLabel(value: unknown, locale: OperationsLocale) {
+  const kind = text(value, "");
+  const labels =
+    locale === "pt-BR"
+      ? { task: "Tarefas", "standalone-task": "Tarefa Avulsa", prd: "PRD", spec: "SPEC" }
+      : { task: "Tasks", "standalone-task": "Standalone Task", prd: "PRD", spec: "SPEC" };
+  return kind === "task" || kind === "standalone-task" || kind === "prd" || kind === "spec"
+    ? labels[kind]
+    : text(value);
+}
+
+/**
+ * Bounded list projection. It intentionally does not reuse UnifiedWorkList:
+ * that component requires all PRD/SPEC/Task relations in memory and therefore
+ * turns a visual tab into an unbounded collection request.
+ */
+export function PagedWorkList({
+  loading,
+  locale,
+  onPageChange,
+  onTypeChange,
+  page,
+}: {
+  loading: boolean;
+  locale: OperationsLocale;
+  onPageChange: (offset: number) => void;
+  onTypeChange: (kind: WorkTypeFilter) => void;
+  page: PagedWorkListPage;
+}) {
+  return (
+    <section
+      aria-busy={loading || undefined}
+      className="operations-unified-work operations-work-list"
+    >
+      <WorkTypeFilters locale={locale} onChange={onTypeChange} value={page.typeFilter} />
+      <div className="operations-work-list-table">
+        <DataTable
+          columns={[
+            {
+              key: "item",
+              label: locale === "pt-BR" ? "Item" : "Item",
+              render: (row) => (
+                <span className="operations-work-list-identity">
+                  <strong>{text(row.title, text(row.id))}</strong>
+                  <small>{text(row.id)}</small>
+                </span>
+              ),
+              sortValue: (row) => text(row.title, text(row.id)),
+            },
+            {
+              key: "status",
+              label: "Status",
+              render: (row) => text(row.status),
+              sortValue: (row) => text(row.status),
+            },
+            {
+              key: "type",
+              label: locale === "pt-BR" ? "Tipo" : "Type",
+              render: (row) => workKindLabel(row.kind ?? row.entity_kind, locale),
+              sortValue: (row) => text(row.kind ?? row.entity_kind),
+            },
+            {
+              key: "risk",
+              label: locale === "pt-BR" ? "Risco" : "Risk",
+              render: (row) => text(row.risk),
+              sortValue: (row) => text(row.risk),
+            },
+            {
+              key: "developers",
+              label: locale === "pt-BR" ? "Desenvolvedor" : "Developer",
+              render: (row) => formatDeveloperIdentities(row.developers),
+              sortValue: (row) => formatDeveloperIdentities(row.developers),
+            },
+            {
+              key: "time",
+              label: locale === "pt-BR" ? "Tempo" : "Time",
+              render: (row) => {
+                const duration = number(row.total_duration);
+                return duration === null ? "—" : formatRoundedDuration(duration);
+              },
+              sortValue: (row) => number(row.total_duration),
+              align: "right",
+            },
+            {
+              key: "tokens",
+              label: "Tokens",
+              render: (row) => {
+                const tokens = number(row.total_tokens);
+                return tokens === null ? "—" : formatCompactNumber(tokens);
+              },
+              sortValue: (row) => number(row.total_tokens),
+              align: "right",
+            },
+            {
+              key: "cost",
+              label: locale === "pt-BR" ? "Custo" : "Cost",
+              render: (row) => {
+                const cost = number(row.total_cost_brl);
+                return cost === null ? "—" : formatCurrency(cost, "BRL");
+              },
+              sortValue: (row) => number(row.total_cost_brl),
+              align: "right",
+            },
+          ]}
+          defaultSort={{ key: "item", direction: "asc" }}
+          emptyMessage={
+            loading
+              ? locale === "pt-BR"
+                ? "Carregando itens…"
+                : "Loading items…"
+              : locale === "pt-BR"
+                ? "Nenhum item de trabalho encontrado."
+                : "No work items found."
+          }
+          locale={locale}
+          rowKey={(row) => text(row.id)}
+          rows={page.rows}
+          scrollLabel={
+            locale === "pt-BR" ? "Lista paginada de itens de trabalho." : "Paged work item list."
+          }
+          sortable
+        />
+      </div>
+      <nav
+        aria-label={locale === "pt-BR" ? "Paginação da lista de trabalho" : "Work list pagination"}
+        className="ui-table-pagination"
+      >
+        {page.error ? <span role="alert">{page.error}</span> : null}
+        {loading ? (
+          <span role="status">{locale === "pt-BR" ? "Atualizando…" : "Updating…"}</span>
+        ) : null}
+        <button
+          disabled={loading || page.offset === 0}
+          onClick={() => onPageChange(Math.max(0, page.offset - page.limit))}
+          type="button"
+        >
+          {locale === "pt-BR" ? "Anterior" : "Previous"}
+        </button>
+        <output aria-live="polite">
+          {page.total === null
+            ? "…"
+            : `${page.offset + (page.rows.length === 0 ? 0 : 1)}–${Math.min(page.offset + page.limit, page.total)} ${locale === "pt-BR" ? "de" : "of"} ${page.total}`}
+        </output>
+        <button
+          disabled={loading || !page.hasMore}
+          onClick={() => onPageChange(page.offset + page.limit)}
+          type="button"
+        >
+          {locale === "pt-BR" ? "Próxima" : "Next"}
+        </button>
+      </nav>
+    </section>
+  );
+}

package/templates/.agents/dashboard/modules/operations/src/react/PeriodSummaryTable.tsx

@@ -43,20 +43,17 @@ export function PeriodSummaryTable({
     Record<string, import("./period-summary.js").ManifestDailyPeriod>
   >;
   factualCostPeriods?: Partial<
-    Record<PeriodGranularity, readonly { key: string; estimated_usd: number | null; estimated_brl: number | null }[]>
+    Record<
+      PeriodGranularity,
+      readonly { key: string; estimated_usd: number | null; estimated_brl: number | null }[]
+    >
   >;
 }) {
   const calculatedRows =
     // Persisted Operations periods carry BRL-only aggregates. USD must be
     // rebuilt from the selected-currency per-Run resolver or remain null.
     manifestDailyPeriods === undefined || currency === "USD"
-      ? aggregatePeriodSummary(
-          data,
-          granularity,
-          resolveRunCost,
-          includeLegacyEffort,
-          legacyRange,
-        )
+      ? aggregatePeriodSummary(data, granularity, resolveRunCost, includeLegacyEffort, legacyRange)
       : aggregateManifestPeriodSummary(manifestDailyPeriods, granularity);
   const rows = applyFactualPeriodCosts(calculatedRows, currency, factualCostPeriods?.[granularity]);
   const summarizedTotal = summarizePeriodRows(rows);
@@ -197,17 +194,42 @@ export function PeriodSummaryTable({
 export function applyFactualPeriodCosts<T extends { key: string; costBrl: number | null }>(
   rows: readonly T[],
   currency: "BRL" | "USD",
-  factualRows?: readonly { key: string; estimated_usd: number | null; estimated_brl: number | null }[],
+  factualRows?: readonly {
+    key: string;
+    estimated_usd: number | null;
+    estimated_brl: number | null;
+  }[],
 ): T[] {
   if (factualRows === undefined) return [...rows];
   const costByKey = new Map(
-    factualRows.map((row) => [row.key, currency === "USD" ? row.estimated_usd : row.estimated_brl] as const),
+    factualRows.map(
+      (row) => [row.key, currency === "USD" ? row.estimated_usd : row.estimated_brl] as const,
+    ),
   );
   return rows.map((row) =>
     costByKey.has(row.key) ? { ...row, costBrl: costByKey.get(row.key) ?? null } : row,
   );
 }
 
+/**
+ * Fills an unavailable Operations duration only when Cost Monitor has an
+ * observed period fact. A missing/null Cost Monitor value remains unavailable.
+ */
+export function applyFactualPeriodDurations<T extends { key: string; durationMs: number | null }>(
+  rows: readonly T[],
+  factualRows?: readonly { key: string; duration_ms: number | null }[],
+): T[] {
+  if (factualRows === undefined) return [...rows];
+  const durationByKey = new Map(factualRows.map((row) => [row.key, row.duration_ms] as const));
+  return rows.map((row) => {
+    if (row.durationMs !== null) return row;
+    const factualDuration = durationByKey.get(row.key);
+    return factualDuration === undefined || factualDuration === null
+      ? row
+      : { ...row, durationMs: factualDuration };
+  });
+}
+
 /** Empty period totals display zero without inventing duration for any Run. */
 export function periodTotalDurationMs(
   durationMs: number | null,