@zaip-ai/cli 6.3.0 → 7.6.0

package/templates/.agents/dashboard/apps/frontend/src/use-app-cost-loaders.test.ts

@@ -8,6 +8,32 @@ import {
 } from "./use-app-cost-loaders.js";
 
 describe("daily Cost Monitor continuous pagination", () => {
+  it("keeps partial sums and factual zero distinct from unavailable cost", () => {
+    const page = adaptSqliteCompactLifecyclePage("tasks", {
+      data_source: "sqlite_read_model",
+      view: "cost_monitor_tasks",
+      offset: 0,
+      limit: 50,
+      total_count: 1,
+      has_more: false,
+      totals: { total_cost_brl: 0, total_cost_brl_known_count: 1, total_cost_brl_unknown_count: 2 },
+      rows: [
+        {
+          id: "T",
+          total_cost_brl: 0,
+          total_cost_brl_known_count: 1,
+          total_cost_brl_unknown_count: 2,
+        },
+      ],
+    });
+    expect(page.rows[0]?.metrics.cost).toEqual({
+      known_sum: 0,
+      unknown: 2,
+      complete: false,
+      coverage_ratio: 1 / 3,
+    });
+    expect(page.subtotal.metrics.cost_brl).toEqual(page.rows[0]?.metrics.cost);
+  });
   it("uses cost_monitor_daily as a 30-day direct pager across months and keeps full-filter totals", async () => {
     const calls: Array<{ view: string; range: unknown; page: Record<string, unknown> }> = [];
     const average = { tasks: 5, specs: 2, prds: 1, durationMs: 1000, tokens: 50, cost: 10 };
@@ -88,6 +114,7 @@ describe("daily Cost Monitor continuous pagination", () => {
     });
 
     expect(firstPage.period_averages).toEqual(periodAverages);
+    expect(firstPage.rows[0]?.conversation_count).toBeNull();
     expect(secondPage.period_averages).toEqual(periodAverages);
     expect(calls).toEqual([
       {
@@ -300,6 +327,7 @@ describe("adaptSqliteCompactLifecyclePage", () => {
       totals: {
         entity_count: 270,
         invocation_count: 270,
+        activity_count: 300,
         total_duration: 270_000,
         total_tokens: 540,
         total_cost_usd: 270,
@@ -308,6 +336,7 @@ describe("adaptSqliteCompactLifecyclePage", () => {
       rows: Array.from({ length: 50 }, (_, index) => ({
         task_id: `TASK-${index}`,
         invocation_count: 1,
+        activity_count: 2,
         total_duration: 1_000,
         total_tokens: 2,
         total_cost_brl: 5,
@@ -322,9 +351,15 @@ describe("adaptSqliteCompactLifecyclePage", () => {
       const page = adaptSqliteCompactLifecyclePage(kind, { ...sqlitePage, view });
       expect(page.rows).toHaveLength(50);
       expect(page.offset).toBe(50);
+      expect(page.rows[0]).toMatchObject({ run_count: 1, activity_count: 2 });
       expect(page.subtotal).toEqual({
         entity_count: 270,
         run_count: { known_sum: 270, unknown: 0, complete: true, coverage_ratio: 1 },
+        activity_count: { known_sum: 300, unknown: 0, complete: true, coverage_ratio: 1 },
+        unattributed_cost_brl: null,
+        unattributed_activity_count: null,
+        orphan_cost_brl: null,
+        orphan_activity_count: null,
         metrics: {
           duration: { known_sum: 270_000, unknown: 0, complete: true, coverage_ratio: 1 },
           total_tokens: { known_sum: 540, unknown: 0, complete: true, coverage_ratio: 1 },

package/templates/.agents/dashboard/apps/frontend/src/use-app-cost-loaders.ts

@@ -1,6 +1,5 @@
 import type { CostMonitorProjection } from "@zaip-ai/dashboard-cost-monitor/contracts";
 import type {
-  CompactLifecycleCostPage,
   LoadCompactCostPage,
   LoadCostMonitorDetail,
   LoadCostRunPage,
@@ -8,13 +7,12 @@ import type {
 import { useCallback } from "react";
 export type LoadCostGroupPage = import("@zaip-ai/dashboard-cost-monitor/react").LoadCostGroupPage;
 
-import type { DashboardApiClient, SqliteViewPage } from "./dashboard-api.js";
-import {
-  costGroupDuration,
-  legacyKnownMetric,
-  nullableSqlNumber,
-  requiredSqlNumber,
-} from "./sqlite-cost-adapters.js";
+import { adaptSqliteCompactLifecyclePage } from "./sqlite-compact-cost-adapter.js";
+
+export { adaptSqliteCompactLifecyclePage } from "./sqlite-compact-cost-adapter.js";
+
+import type { DashboardApiClient } from "./dashboard-api.js";
+import { costGroupDuration, nullableSqlNumber } from "./sqlite-cost-adapters.js";
 
 type CostGroupLoadRequest = Parameters<LoadCostGroupPage>[0];
 type CostRunLoadRequest = Parameters<LoadCostRunPage>[0];
@@ -51,7 +49,7 @@ function adaptSqliteCostGroup(row: Record<string, unknown>) {
     job: typeof row.job === "string" ? row.job : null,
     run_count: Number(row.total_run_count ?? row.invocation_count ?? 0),
     task_count: nullableSqlNumber(row.task_count),
-    conversation_count: Number(row.conversation_count ?? 0),
+    conversation_count: nullableSqlNumber(row.conversation_count),
     prd_count: nullableSqlNumber(row.prd_count),
     spec_count: nullableSqlNumber(row.spec_count),
     evidence_count: nullableSqlNumber(row.evidence_count),
@@ -85,6 +83,8 @@ export async function loadSqliteCostGroupPage(
       signal,
     );
     return {
+      snapshot_id: page.snapshot_id ?? null,
+      snapshot_updated_at: page.snapshot_updated_at ?? null,
       offset: page.offset,
       limit: page.limit,
       total_count: page.total_count,
@@ -110,6 +110,8 @@ export async function loadSqliteCostGroupPage(
     signal,
   );
   return {
+    snapshot_id: page.snapshot_id ?? null,
+    snapshot_updated_at: page.snapshot_updated_at ?? null,
     offset: page.offset,
     limit: page.limit,
     total_count: page.total_count,
@@ -263,84 +265,6 @@ export function adaptSqliteCostRun(
   };
 }
 
-export function adaptSqliteCompactLifecyclePage(
-  kind: CompactLifecycleCostPage["kind"],
-  page: SqliteViewPage,
-): CompactLifecycleCostPage {
-  const totals = page.totals;
-  const subtotalMetric = (key: string) => legacyKnownMetric(totals?.[key]);
-  return {
-    data_source: "lifecycle_daily_read_models",
-    snapshot_id: null,
-    source_latest_at: null,
-    kind,
-    offset: page.offset,
-    limit: page.limit,
-    total: page.total_count,
-    has_more: page.has_more,
-    next_cursor: null,
-    subtotal: {
-      entity_count:
-        typeof totals?.entity_count === "number" ? totals.entity_count : page.total_count,
-      run_count: subtotalMetric("invocation_count"),
-      metrics: {
-        duration: subtotalMetric("total_duration"),
-        total_tokens: subtotalMetric("total_tokens"),
-        cost_brl: subtotalMetric("total_cost_brl"),
-        cost_usd: subtotalMetric("total_cost_usd"),
-      },
-    },
-    rows: page.rows.map((row) => ({
-      id: String(
-        row.task_id ??
-          row.spec_id ??
-          row.prd_id ??
-          row.execution_id ??
-          row.conversation_id ??
-          row.id ??
-          "unavailable",
-      ),
-      title: String(
-        row.title ??
-          row.task_id ??
-          row.spec_id ??
-          row.prd_id ??
-          row.execution_id ??
-          row.conversation_id ??
-          "Unavailable",
-      ),
-      kind:
-        kind === "tasks"
-          ? "task"
-          : kind === "specs"
-            ? "spec"
-            : kind === "prds"
-              ? "prd"
-              : kind === "executions"
-                ? "execution"
-                : "conversation",
-      status: typeof row.status === "string" ? row.status : null,
-      risk: typeof row.risk === "string" ? row.risk : null,
-      occurred_at:
-        typeof row.occurred_at === "string"
-          ? row.occurred_at
-          : typeof row.started_at === "string"
-            ? row.started_at
-            : typeof row.last_day === "string"
-              ? `${row.last_day}T12:00:00.000Z`
-              : "",
-      parent_id: null,
-      run_count: Number(row.invocation_count ?? 0),
-      cost_currency: "BRL",
-      metrics: {
-        duration: legacyKnownMetric(row.total_duration),
-        total_tokens: legacyKnownMetric(row.total_tokens),
-        cost: legacyKnownMetric(row.total_cost_brl),
-      },
-    })),
-  };
-}
-
 export function useAppCostLoaders(api: DashboardApiClient) {
   const loadCostDetail = useCallback<LoadCostMonitorDetail>(async () => {
     throw new Error(

package/templates/.agents/dashboard/apps/frontend/src/use-app-effects.ts

@@ -7,7 +7,7 @@ import {
   useEffect,
   useRef,
 } from "react";
-import { pricingSetupPath, projectSetupPath } from "./AppSetupRoutes.js";
+import { costCalculationGuidePath, pricingSetupPath, projectSetupPath } from "./AppSetupRoutes.js";
 import { currencyKey, localeKey } from "./app-preferences.js";
 import type { DashboardView } from "./DashboardCapabilityNav.js";
 import type { DashboardApiClient, PricingCatalog } from "./dashboard-api.js";
@@ -16,86 +16,9 @@ import {
   shouldHydrateOperationsDetails,
 } from "./operations-detail-hydration.js";
 
-export const projectionRefreshDebounceMs = 5_000;
-export const snapshotReadyPollMs = 2_000;
-export const snapshotReadyPollAttempts = 90;
-export const snapshotRevisionVisiblePollMs = 5_000;
-export const snapshotRevisionHiddenPollMs = 10_000;
-export const snapshotRevisionHiddenFailurePollMs = 30_000;
-export const snapshotReadyPollExhaustedMessage =
-  "A atualização do snapshot não foi concluída. Os dados exibidos podem estar desatualizados.";
+import { shouldRefreshVisibleProjection, startSnapshotObserver } from "./snapshot-observer.js";
 
-export function shouldPollSnapshotReady(snapshotUpdating: boolean, attempts: number): boolean {
-  return snapshotUpdating && attempts < snapshotReadyPollAttempts;
-}
-
-export function snapshotRevisionPollDelay(
-  visibilityState: DocumentVisibilityState,
-  consecutiveFailures: number,
-): number {
-  if (visibilityState === "visible") return snapshotRevisionVisiblePollMs;
-  return consecutiveFailures > 0
-    ? snapshotRevisionHiddenFailurePollMs
-    : snapshotRevisionHiddenPollMs;
-}
-
-export function shouldRefreshForSnapshotRevision(
-  previousRevision: string | null,
-  nextRevision: string | undefined,
-): boolean {
-  return (
-    previousRevision !== null &&
-    typeof nextRevision === "string" &&
-    nextRevision.length > 0 &&
-    previousRevision !== nextRevision
-  );
-}
-
-export function isCommittedSnapshotRevision(
-  snapshotState: "current" | "updating" | undefined,
-  snapshotRevision: string | undefined,
-): snapshotRevision is string {
-  return (
-    (snapshotState === "current" || snapshotState === "updating") &&
-    typeof snapshotRevision === "string" &&
-    snapshotRevision.length > 0
-  );
-}
-
-/** A changed immutable revision is usable even while its successor is building. */
-export function settleSnapshotRevisionRefresh({
-  observedRevision,
-  pendingRevision,
-  requestedRevision,
-  succeeded,
-}: {
-  observedRevision: string | null;
-  pendingRevision: string | null;
-  requestedRevision: string;
-  succeeded: boolean;
-}): { observedRevision: string | null; pendingRevision: string | null } {
-  if (!succeeded) return { observedRevision, pendingRevision };
-  return {
-    observedRevision: requestedRevision,
-    pendingRevision: pendingRevision === requestedRevision ? null : pendingRevision,
-  };
-}
-
-export function shouldRefreshVisibleProjection({
-  inFlight,
-  lastRefreshAt,
-  now,
-  visibilityState,
-}: {
-  inFlight: boolean;
-  lastRefreshAt: number;
-  now: number;
-  visibilityState: DocumentVisibilityState;
-}): boolean {
-  return (
-    visibilityState === "visible" && !inFlight && now - lastRefreshAt >= projectionRefreshDebounceMs
-  );
-}
+export * from "./snapshot-observer.js";
 
 export function useAppEffects({
   api,
@@ -145,9 +68,8 @@ export function useAppEffects({
 }) {
   const projectionRefreshInFlight = useRef(false);
   const lastProjectionRefreshAt = useRef(0);
-  const observedSnapshotRevision = useRef<string | null>(null);
-  const snapshotRevisionRefreshInFlight = useRef(false);
-  const pendingSnapshotRevisionRefresh = useRef<string | null>(null);
+  const snapshotUpdatingRef = useRef(snapshotUpdating);
+  snapshotUpdatingRef.current = snapshotUpdating;
   useEffect(() => {
     void refresh();
     return () => {
@@ -195,121 +117,21 @@ export function useAppEffects({
     };
   }, [refresh]);
 
-  useEffect(() => {
-    if (!snapshotUpdating) return;
-    let cancelled = false;
-    let attempts = 0;
-    let timeout: number | null = null;
-    const pollReady = async () => {
-      if (cancelled || !shouldPollSnapshotReady(true, attempts)) return;
-      attempts += 1;
-      try {
-        const ready = await api.ready();
-        if (cancelled) return;
-        if (ready.snapshot_state === "current") {
+  useEffect(
+    () =>
+      startSnapshotObserver({
+        ready: () => api.ready(),
+        reload: () => refresh(false, false, false, true),
+        updating: () => snapshotUpdatingRef.current,
+        visibility: () => document.visibilityState,
+        settled: () => setSnapshotUpdating(false),
+        exhausted: (message) => {
           setSnapshotUpdating(false);
-          // Promotion produced a new immutable SQLite generation. Reload its
-          // Operations and Cost Monitor summaries by GET; never rebuild or
-          // reconcile as part of the readiness poll.
-          await refresh(false, false, false, true);
-          return;
-        }
-      } catch {
-        // Keep the validated stale seed visible within the bounded poll window.
-      }
-      if (cancelled) return;
-      if (shouldPollSnapshotReady(true, attempts)) {
-        timeout = window.setTimeout(() => void pollReady(), snapshotReadyPollMs);
-        return;
-      }
-      // Stop the progress indicator after the bounded window, while retaining
-      // an explicit visible warning that the stale snapshot remains on screen.
-      setSnapshotUpdating(false);
-      setError(snapshotReadyPollExhaustedMessage);
-    };
-    void pollReady();
-    return () => {
-      cancelled = true;
-      if (timeout !== null) window.clearTimeout(timeout);
-    };
-  }, [api, refresh, setError, setSnapshotUpdating, snapshotUpdating]);
-
-  useEffect(() => {
-    let cancelled = false;
-    let consecutiveFailures = 0;
-    let timeout: number | null = null;
-
-    const refreshChangedRevision = () => {
-      if (cancelled || snapshotRevisionRefreshInFlight.current) return;
-      const requestedRevision = pendingSnapshotRevisionRefresh.current;
-      if (requestedRevision === null) return;
-      snapshotRevisionRefreshInFlight.current = true;
-      // A committed revision is discovered by GET /ready. Its data reload
-      // remains GET-only: it must never start a projection rebuild or
-      // lifecycle reconciliation from a tab that happened to stay open.
-      void refresh(false, false, false, true)
-        .then((succeeded) => {
-          // Do not settle an updating banner merely because `/ready` observed
-          // a new hash. Settle it only after the tab has loaded that committed
-          // immutable generation successfully.
-          if (succeeded) setSnapshotUpdating(false);
-          const settled = settleSnapshotRevisionRefresh({
-            observedRevision: observedSnapshotRevision.current,
-            pendingRevision: pendingSnapshotRevisionRefresh.current,
-            requestedRevision,
-            succeeded,
-          });
-          // A failed GET leaves the exact revision pending. The following
-          // passive readiness poll retries it without changing the UI state.
-          observedSnapshotRevision.current = settled.observedRevision;
-          pendingSnapshotRevisionRefresh.current = settled.pendingRevision;
-        })
-        .finally(() => {
-          snapshotRevisionRefreshInFlight.current = false;
-          // A newer committed revision that arrived while this GET was in
-          // flight can run immediately; retrying the same rejected revision
-          // waits for the normal passive polling cadence.
-          if (pendingSnapshotRevisionRefresh.current !== requestedRevision) {
-            refreshChangedRevision();
-          }
-        });
-    };
-
-    const pollRevision = async () => {
-      try {
-        const ready = await api.ready();
-        if (cancelled) return;
-        consecutiveFailures = 0;
-        const previousRevision = observedSnapshotRevision.current;
-        if (isCommittedSnapshotRevision(ready.snapshot_state, ready.snapshot_revision)) {
-          if (previousRevision === null) {
-            observedSnapshotRevision.current = ready.snapshot_revision;
-          }
-          if (shouldRefreshForSnapshotRevision(previousRevision, ready.snapshot_revision)) {
-            // `updating` can describe a later rebuild. The revision in this
-            // response is already immutable; `refreshChangedRevision` settles
-            // the banner after its GET has loaded that generation.
-            pendingSnapshotRevisionRefresh.current = ready.snapshot_revision;
-            refreshChangedRevision();
-          }
-        }
-      } catch {
-        consecutiveFailures += 1;
-      }
-      if (!cancelled) {
-        timeout = window.setTimeout(
-          () => void pollRevision(),
-          snapshotRevisionPollDelay(document.visibilityState, consecutiveFailures),
-        );
-      }
-    };
-
-    void pollRevision();
-    return () => {
-      cancelled = true;
-      if (timeout !== null) window.clearTimeout(timeout);
-    };
-  }, [api, refresh, setSnapshotUpdating]);
+          setError(message);
+        },
+      }),
+    [api, refresh, setError, setSnapshotUpdating],
+  );
 
   useEffect(() => {
     if (
@@ -338,7 +160,11 @@ export function useAppEffects({
   useEffect(() => window.localStorage.setItem(currencyKey, currency), [currency]);
 
   useEffect(() => {
-    if (!["/", pricingSetupPath, projectSetupPath].includes(window.location.pathname)) {
+    if (
+      !["/", pricingSetupPath, projectSetupPath, costCalculationGuidePath].includes(
+        window.location.pathname,
+      )
+    ) {
       window.history.replaceState(null, "", `/${window.location.search}${window.location.hash}`);
       setPathname("/");
     }
@@ -351,7 +177,8 @@ export function useAppEffects({
   }, [setPathname]);
 
   useEffect(() => {
-    if (pathname !== pricingSetupPath || pricing !== null) return;
+    if (![pricingSetupPath, costCalculationGuidePath].includes(pathname) || pricing !== null)
+      return;
     void Promise.all([api.pricing(), api.fxRate()])
       .then(([catalog, rate]) => {
         setPricing(catalog);

package/templates/.agents/dashboard/apps/frontend/src/use-app-trace-documents.navigation.test.tsx

@@ -67,7 +67,7 @@ describe("macro trace navigation from a compact overview", () => {
         sourcefile: "macro-trace-navigation-harness.tsx",
       },
     });
-    const browser = await chromium.launch({ headless: true });
+    const browser = await chromium.launch({ headless: true, chromiumSandbox: true });
     try {
       const page = await browser.newPage();
       const pageErrors: string[] = [];

package/templates/.agents/dashboard/apps/frontend/src/use-app-work-board.test.ts

@@ -101,6 +101,71 @@ afterEach(() => {
 });
 
 describe("work board hydration generation", () => {
+  it("exports linked and standalone Tasks with the same kinds used by board filters", async () => {
+    const { operationsBoard, render } = setup();
+    operationsBoard.mockImplementation(async (_period, stage) => ({
+      ...boardPage(stage),
+      total: stage === "completed" ? 2 : 0,
+      tasks:
+        stage === "completed"
+          ? ([
+              { id: "LINKED", spec_id: "SPEC-1" },
+              { id: "INDEPENDENT", spec_id: null },
+            ] as never)
+          : [],
+    }));
+    const source = await render()
+      .boardExportSource({ query: "", status: "", risk: "", origin: "" })
+      .prepare();
+    const rows = [];
+    for await (const page of source.pages()) rows.push(...page);
+    expect(rows.map((row) => [row.id, row.kind])).toEqual([
+      ["LINKED", "task"],
+      ["INDEPENDENT", "standalone-task"],
+    ]);
+  });
+  it("exports the server distinct financial summary once, with exact filters and snapshot", async () => {
+    const { operationsBoard, render } = setup();
+    const summary = {
+      total_cost_brl: 100,
+      activity_count: 1,
+      semantics: "distinct_selected_work_activities",
+    };
+    operationsBoard.mockImplementation(async (_period, stage) => ({
+      ...boardPage(stage),
+      snapshot_id: "snapshot-1",
+      financial_summary: summary,
+    }));
+    const source = await render()
+      .boardExportSource({
+        query: "TASK-1",
+        status: "",
+        risk: "",
+        origin: "",
+      })
+      .prepare();
+    expect(source.financialSummary).toEqual(summary);
+    expect(source.metadata).toMatchObject({
+      snapshot_id: "snapshot-1",
+      filters: { query: "TASK-1" },
+    });
+    // Every stage receives the same filter; totals must never be summed over stages.
+    expect(operationsBoard.mock.calls.every((call) => call[3]?.query === "TASK-1")).toBe(true);
+  });
+
+  it("refuses a workbook assembled from different board generations", async () => {
+    const { operationsBoard, render } = setup();
+    operationsBoard.mockImplementation(async (_period, stage) => ({
+      ...boardPage(stage),
+      snapshot_id: stage === "definition" ? "old" : "new",
+    }));
+    await expect(
+      render()
+        .boardExportSource({ ...filters, origin: filters.origin ?? "" })
+        .prepare(),
+    ).rejects.toThrow("Os dados mudaram");
+  });
+
   it("hydrates the visible board when requestIdleCallback never runs", async () => {
     const requestIdleCallback = vi.fn(() => 1);
     vi.stubGlobal("window", {

package/templates/.agents/dashboard/apps/frontend/src/use-app-work-board.ts

@@ -14,6 +14,7 @@ import type {
   WorkBoardStage,
 } from "./dashboard-api.js";
 import { requestPeriodForOperations } from "./operations-period.js";
+import { assertSameExportSnapshot } from "./sqlite-page-export.js";
 
 export function useAppWorkBoard({
   api,
@@ -308,10 +309,24 @@ export function useAppWorkBoard({
           const rowsFor = (page: OperationsBoardPage) => [
             ...page.prds.map(({ kind: _kind, ...row }) => ({ kind: "prd", ...row })),
             ...page.specs.map(({ kind: _kind, ...row }) => ({ kind: "spec", ...row })),
-            ...page.tasks.map((row) => ({ kind: "task", ...row })),
+            ...page.tasks.map((row) => ({
+              ...row,
+              kind: row.spec_id === null ? "standalone-task" : "task",
+            })),
           ];
+          for (const page of firstPages) assertSameExportSnapshot(firstPages[0]!, page);
           return {
             totalRows: firstPages.reduce((sum, page) => sum + page.total, 0),
+            metadata: {
+              source: "operations_work_kanban",
+              snapshot_id: firstPages[0]?.snapshot_id ?? null,
+              snapshot_updated_at: firstPages[0]?.snapshot_updated_at ?? null,
+              filters,
+              period: period ?? "all",
+            },
+            ...(firstPages[0]?.financial_summary === undefined
+              ? {}
+              : { financialSummary: firstPages[0].financial_summary }),
             pages: async function* () {
               for (const firstPage of firstPages) {
                 let page = firstPage;
@@ -323,6 +338,7 @@ export function useAppWorkBoard({
                   yield rows;
                   if (offset >= page.total) break;
                   page = await api.operationsBoard(period, page.stage, offset, filters);
+                  assertSameExportSnapshot(firstPage, page);
                 }
               }
             },

package/templates/.agents/dashboard/apps/frontend/src/use-dashboard-app-model.tsx

@@ -136,8 +136,8 @@ export function useDashboardAppModel() {
   useEffect(() => {
     void api
       .captureTelemetry()
-      .then(() => api.ready())
-      .then((ready) => setSnapshotUpdating(ready.snapshot_state === "updating"))
+      // The shared observer owns readiness and acknowledgement of loaded data.
+      .then(() => setSnapshotUpdating(true))
       .catch(() => {});
   }, [api]);
   const [error, setError] = useState<string | null>(null);

package/templates/.agents/dashboard/apps/frontend/src/use-operations-detail-export.ts

@@ -63,6 +63,16 @@ export function useOperationsDetailExport({
           const firstPage = await api.sqliteViewPage(source, period, options(0));
           return {
             totalRows: firstPage.total_count,
+            metadata: {
+              source,
+              snapshot_id: firstPage.snapshot_id ?? null,
+              snapshot_updated_at: firstPage.snapshot_updated_at ?? null,
+              filters,
+              period: period ?? "all",
+            },
+            ...(firstPage.financial_summary === undefined
+              ? {}
+              : { financialSummary: firstPage.financial_summary }),
             pages: () =>
               allSqliteExportPages(firstPage, (offset) =>
                 api.sqliteViewPage(source, period, options(offset)),