@zaip-ai/cli 2.6.0 → 3.1.0

package/templates/.agents/dashboard/apps/frontend/src/project-settings.test.ts

@@ -34,6 +34,18 @@ const config: ProjectConfigSettings = {
 };
 
 describe("project settings form mapping", () => {
+  it.each([
+    "essential",
+    "balanced",
+    "persistent",
+  ] as const)("preserves autonomy %s without rewriting execution or assurance", (preset) => {
+    const source = { ...config, autonomy: { version: 1 as const, preset } };
+    const draft = projectSettingsDraft(source);
+    const payload = buildProjectSettingsPayload(source, draft.components, draft.otherOverrides);
+    expect(payload.autonomy).toEqual(source.autonomy);
+    expect(payload.execution).toEqual(source.execution);
+    expect(payload.assurance).toEqual(source.assurance);
+  });
   it("renders a canonical framework SemVer as a short major.minor label", () => {
     expect(shortFrameworkVersion("2.5.0")).toBe("v2.5");
     expect(shortFrameworkVersion("v2.5.0")).toBe("v2.5");

package/templates/.agents/dashboard/apps/frontend/src/snapshot-coherence.test.ts

@@ -277,7 +277,7 @@ describe("atomic Cost snapshot loading", () => {
       periodChange.lastIndexOf("setOperationsPeriod(nextPeriod);"),
     );
     expect(periodChange).toContain(
-      "isAllTimeDisplayRangeChange(operationsPeriodRef.current, nextPeriod)",
+      "isSameOperationsRequestPeriod(operationsPeriodRef.current, nextPeriod)",
     );
     expect(periodChange).toContain("setOperationsLoading(true);");
     expect(periodChange).toContain('setLoadingArea("operations");');

package/templates/.agents/dashboard/apps/frontend/src/traceability-task-pagination.ts

@@ -1,5 +1,4 @@
 import type { OperationsProjection } from "@zaip-ai/dashboard-operations/contracts";
-import type { OperationsBoardPage } from "./dashboard-api.js";
 
 /** The selector is a navigation aid, not a full task export. */
 export const traceabilityTaskPageSize = 10;
@@ -12,7 +11,7 @@ export function appendTraceabilityTaskPage({
   tasks,
 }: {
   cursor: TraceabilityTaskCursor;
-  page: OperationsBoardPage;
+  page: { tasks: OperationsProjection["tasks"]; total: number };
   tasks: OperationsProjection["tasks"];
 }): { cursor: TraceabilityTaskCursor; tasks: OperationsProjection["tasks"] } {
   const tasksById = new Map(tasks.map((task) => [task.id, task]));

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

@@ -10,12 +10,15 @@ import {
 describe("daily Cost Monitor continuous pagination", () => {
   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 };
+    const periodAverages = { BRL: average, USD: { ...average, cost: 2 } };
     const api = {
       sqliteViewPage: async (view: string, range: unknown, page: Record<string, unknown>) => {
         calls.push({ view, range, page });
         if (page.offset === 0) {
           return {
             offset: 0,
+            period_averages: periodAverages,
             limit: 30,
             total_count: 35,
             has_more: true,
@@ -34,6 +37,7 @@ describe("daily Cost Monitor continuous pagination", () => {
         }
         return {
           offset: 30,
+          period_averages: periodAverages,
           limit: 30,
           total_count: 35,
           has_more: false,
@@ -83,6 +87,8 @@ describe("daily Cost Monitor continuous pagination", () => {
       filters,
     });
 
+    expect(firstPage.period_averages).toEqual(periodAverages);
+    expect(secondPage.period_averages).toEqual(periodAverages);
     expect(calls).toEqual([
       {
         view: "cost_monitor_daily",

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

@@ -90,6 +90,7 @@ export async function loadSqliteCostGroupPage(
       total_count: page.total_count,
       has_more: page.has_more,
       rows: page.rows.map(adaptSqliteCostGroup),
+      ...(page.period_averages === undefined ? {} : { period_averages: page.period_averages }),
       ...(page.totals === undefined ? {} : { totals: adaptSqliteCostGroup(page.totals) }),
     };
   }
@@ -114,6 +115,7 @@ export async function loadSqliteCostGroupPage(
     total_count: page.total_count,
     has_more: page.has_more,
     rows: page.rows.map(adaptSqliteCostGroup),
+    ...(page.period_averages === undefined ? {} : { period_averages: page.period_averages }),
     ...(page.totals === undefined ? {} : { totals: adaptSqliteCostGroup(page.totals) }),
   };
 }

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

@@ -65,7 +65,9 @@ export function useAppTraceDocuments({
         task_title: cardTask?.title || loadedTrace.task_title || taskId,
         task_risk: cardTask?.risk || loadedTrace.task_risk || null,
         task_created_at: cardTask?.created_at || loadedTrace.task_created_at || null,
-        task_progress: cardTask?.progress ?? loadedTrace.task_progress ?? 0,
+        // The detail response is authoritative; an earlier quick card may still
+        // carry a partial/default progress value during hydration.
+        task_progress: loadedTrace.task_progress ?? cardTask?.progress ?? 0,
       });
       return true;
     } catch (cause) {

package/templates/.agents/dashboard/apps/frontend/src/use-app-trace-task-pagination.ts

@@ -7,7 +7,6 @@ import {
   useRef,
   useState,
 } from "react";
-import { traceTaskSearchStages } from "./AppWorkBoard.js";
 import type { DashboardApiClient } from "./dashboard-api.js";
 import {
   appendTraceabilityTaskPage,
@@ -35,24 +34,14 @@ export function useAppTraceTaskPagination(
         setTraceTasks([]);
         setTraceTasksHasMore(true);
       }
-      if (traceTaskCursorRef.current.stageIndex >= traceTaskSearchStages.length)
-        return traceTasksRef.current;
+      if (traceTaskCursorRef.current.stageIndex >= 1) return traceTasksRef.current;
 
       traceTasksLoadingRef.current = true;
       setTraceTasksLoading(true);
       try {
         do {
           const cursor = traceTaskCursorRef.current;
-          const stage = traceTaskSearchStages[cursor.stageIndex];
-          if (stage === undefined) break;
-          const page = await api.operationsBoard(
-            { from: null, to: null },
-            stage,
-            cursor.offset,
-            { kind: "all-tasks" },
-            undefined,
-            traceabilityTaskPageSize,
-          );
+          const page = await api.traceabilityTasks(cursor.offset, traceabilityTaskPageSize);
           const updated = appendTraceabilityTaskPage({
             cursor,
             page,
@@ -62,8 +51,8 @@ export function useAppTraceTaskPagination(
           setTraceTasks(traceTasksRef.current);
           traceTaskCursorRef.current = updated.cursor;
           if (page.tasks.length > 0 && !loadAll) break;
-        } while (traceTaskCursorRef.current.stageIndex < traceTaskSearchStages.length);
-        setTraceTasksHasMore(traceTaskCursorRef.current.stageIndex < traceTaskSearchStages.length);
+        } while (traceTaskCursorRef.current.stageIndex < 1);
+        setTraceTasksHasMore(traceTaskCursorRef.current.stageIndex < 1);
         return traceTasksRef.current;
       } finally {
         traceTasksLoadingRef.current = false;

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

@@ -620,7 +620,7 @@ export function useDashboardAppModel() {
     setTraceLoadingTaskId,
   });
   const currentCostByRun = buildCurrentCostByRun(costs, displayedCosts, currency);
-  const { total: factualCostTotal, periods: factualCostPeriods } = factualCostFacts(
+  const { fact: factualCostFact, periods: factualCostPeriods } = factualCostFacts(
     costs,
     displayedCosts,
     currency,
@@ -724,7 +724,7 @@ export function useDashboardAppModel() {
     entityPage,
     dashboardIdentity,
     operationsLoading,
-    factualCostTotal,
+    factualCostFact,
     factualCostPeriods,
     setOperationsSurfaceLoading,
     currentCostByRun,

package/templates/.agents/dashboard/modules/cost-monitor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/dashboard-cost-monitor",
-  "version": "2.6.0",
+  "version": "3.1.0",
   "private": true,
   "type": "module",
   "exports": {

package/templates/.agents/dashboard/modules/cost-monitor/src/complete-cost-average.test.ts

@@ -0,0 +1,73 @@
+import type { OperationsProjection } from "@zaip-ai/dashboard-operations/contracts";
+import { describe, expect, it } from "vitest";
+import { averageCompleteCost } from "./contracts.js";
+import { buildCostSummaryProjection } from "./server/build-cost-summary-projection.js";
+
+describe("population cost averages", () => {
+  it.each([
+    { unknown: 1, total: 10, expected: null },
+    { unknown: 1, total: 0, expected: null },
+    { unknown: 0, total: 0, expected: 0 },
+    { unknown: 0, total: 10, expected: 5 },
+  ])("summary retains subtotal but not diluted mean: $unknown/$total", ({
+    unknown,
+    total,
+    expected,
+  }) => {
+    const operations = {
+      schema_version: 2,
+      layout_version: 3,
+      readonly: true,
+      source: ".agents/records",
+      filters: { from: null, to: null },
+      summary: { task_count: 1, overview_metrics: {}, usage: {} },
+      prds: [],
+      specs: [],
+      runs: [],
+    } as unknown as OperationsProjection;
+    const cost = {
+      known_sum: total,
+      unknown,
+      complete: unknown === 0,
+      coverage_ratio: (2 - unknown) / 2,
+      currency: "BRL",
+    };
+    const projection = buildCostSummaryProjection(
+      {
+        periods: {
+          daily: {
+            "2026-08-19": {
+              prds: 0,
+              specs: 0,
+              tasks: 1,
+              validations: 0,
+              evidences: 0,
+              runs: 2,
+              usage: {
+                total_tokens: { known_sum: 100, unknown: 0, complete: true, coverage_ratio: 1 },
+                cost,
+              },
+            },
+          },
+        },
+        cost_monitor_daily_duration: {},
+        daily_rows: [{ key: "2026-08-19", total_cost_usd: total, total_cost_brl: total }],
+      },
+      operations,
+      "BRL",
+      null,
+    );
+    expect(projection.overview.estimated_brl).toBe(total);
+    expect(projection.overview.average_run_cost_brl).toBe(expected);
+  });
+  it.each([
+    { values: [], expected: null },
+    { values: [null], expected: null },
+    { values: [10, null], expected: null },
+    { values: [0, null], expected: null },
+    { values: [0, 0], expected: 0 },
+    { values: [10, 20], expected: 15 },
+  ])("preserves completeness: $values", ({ values, expected }) => {
+    expect(averageCompleteCost(values)).toBe(expected);
+  });
+});

package/templates/.agents/dashboard/modules/cost-monitor/src/contracts.ts

@@ -1,4 +1,7 @@
 import type { ReadonlyV2Projection } from "@zaip-ai/dashboard-contracts";
+
+export type { CostPeriodAverages } from "./period-averages.js";
+
 import type {
   MacroProjection,
   ProjectionTimeFilter,
@@ -22,6 +25,12 @@ export interface DurationCoverage {
 export type DurationAggregationScope = "root_execution" | "all_execution" | "all_invocations";
 
 /** Returns the sum of reported values; missing telemetry does not erase known usage. */
+/** A population average must not treat missing Run costs as observed zero. */
+export function averageCompleteCost(values: readonly (number | null)[]): number | null {
+  if (values.length === 0 || values.some((value) => value === null)) return null;
+  return values.reduce<number>((total, value) => total + (value ?? 0), 0) / values.length;
+}
+
 export function sumKnown(values: readonly (number | null)[]): number | null {
   const known = values.filter((value): value is number => value !== null);
   return known.length === 0 ? null : known.reduce((sum, value) => sum + value, 0);

package/templates/.agents/dashboard/modules/cost-monitor/src/period-averages.ts

@@ -0,0 +1,60 @@
+import type { CostGroupRow } from "./contracts.js";
+
+export interface CostPeriodAverages {
+  tasks: number | null;
+  specs: number | null;
+  prds: number | null;
+  durationMs: number | null;
+  tokens: number | null;
+  cost: number | null;
+}
+
+export function summarizeCostPeriodAverages(
+  rows: readonly Pick<
+    CostGroupRow,
+    | "task_count"
+    | "spec_count"
+    | "prd_count"
+    | "duration_ms"
+    | "total_tokens"
+    | "estimated_usd"
+    | "estimated_brl"
+  >[],
+  currency: "BRL" | "USD",
+): CostPeriodAverages {
+  const divisor = rows.length;
+  return {
+    tasks: averagePerPeriod(
+      rows.map((row) => row.task_count),
+      divisor,
+    ),
+    specs: averagePerPeriod(
+      rows.map((row) => row.spec_count),
+      divisor,
+    ),
+    prds: averagePerPeriod(
+      rows.map((row) => row.prd_count),
+      divisor,
+    ),
+    durationMs: averagePerPeriod(
+      rows.map((row) => row.duration_ms),
+      divisor,
+    ),
+    tokens: averageObserved(rows.map((row) => row.total_tokens)),
+    cost: averageObserved(
+      rows.map((row) => (currency === "BRL" ? row.estimated_brl : row.estimated_usd)),
+    ),
+  };
+}
+
+function averageObserved(values: readonly (number | null)[]): number | null {
+  const present = values.filter((value): value is number => value !== null);
+  return present.length === 0
+    ? null
+    : present.reduce((sum, value) => sum + value, 0) / present.length;
+}
+
+function averagePerPeriod(values: readonly (number | null)[], periodCount: number): number | null {
+  if (periodCount === 0 || values.every((value) => value === null)) return null;
+  return values.reduce<number>((sum, value) => sum + (value ?? 0), 0) / periodCount;
+}

package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostMonitorContent.tsx

@@ -11,9 +11,9 @@ import type { CostCurrency, CostLocale } from "./cost-monitor-copy.js";
 import type { CostView } from "./cost-monitor-views.js";
 import { MacroCostTable } from "./MacroCostTable.js";
 import {
+  type CostGroupPage,
   type CostGroupTotals,
   costGroupPageLabel,
-  reconcileCostGroupTotalsWithCards,
 } from "./use-cost-group-page.js";
 
 type CostRunRows = ComponentProps<typeof CostRunsTable>["rows"];
@@ -90,13 +90,7 @@ export function CostMonitorContent({
     providers: CostGroupRows;
     tasks: CostGroupRows;
   };
-  groupPage: {
-    offset: number;
-    limit: number;
-    total_count: number;
-    has_more: boolean;
-    totals?: CostGroupTotals;
-  } | null;
+  groupPage: Omit<CostGroupPage, "rows"> | null;
   groupPageLoading: boolean;
   groupPageOffset: number;
   locale: CostLocale;
@@ -290,15 +284,7 @@ export function CostMonitorContent({
               locale={locale}
               loading={groupPageLoading}
               rows={groups[key]}
-              {...(key === "models"
-                ? groupPage?.totals === undefined
-                  ? {}
-                  : { totals: groupPage.totals }
-                : key === "providers"
-                  ? { totals: summaryTotals }
-                  : groupPage?.totals === undefined
-                    ? {}
-                    : { totals: groupPage.totals })}
+              {...(groupPage?.totals === undefined ? {} : { totals: groupPage.totals })}
               {...(key === "agents"
                 ? { showDateTime: false, showAgentIdentity: true }
                 : key === "models"
@@ -316,6 +302,10 @@ export function CostMonitorContent({
           <CostPeriodAverageCards
             currency={currency}
             locale={locale}
+            loading={groupPageLoading}
+            {...(groupPage === null
+              ? {}
+              : { average: groupPage.period_averages?.[currency] ?? null })}
             period={view}
             rows={groups[view]}
           />
@@ -326,11 +316,7 @@ export function CostMonitorContent({
             period={view}
             rows={groups[view]}
             showDateTime={false}
-            totals={
-              groupPage?.totals === undefined
-                ? summaryTotals
-                : reconcileCostGroupTotalsWithCards(groupPage.totals, summaryTotals)
-            }
+            totals={groupPage?.totals ?? summaryTotals}
           />
           {groupPager}
         </>

package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostMonitorPage.tsx

@@ -491,9 +491,8 @@ export function CostMonitorPage({
     (total, row) => total + row.duration.known_sum,
     0,
   );
-  // Model/provider rows intentionally omit untrusted dimensions. Their footer
-  // remains the canonical card population for the same filters, never the
-  // visible subset or its paginated SQLite total.
+  // Card totals are a fallback for local, non-paged data only. Remote tables
+  // retain the full filtered totals returned alongside their paginated rows.
   const cardMetrics = operations?.summary.overview_metrics;
   const cardDurationTotal = cardMetrics ? cardMetrics.duration_ms : canonicalDurationTotal;
   const summaryTotals = {

package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostPeriodAverageCards.tsx

@@ -5,49 +5,73 @@ import {
   formatNumber,
   PeriodAverageCards,
 } from "@zaip-ai/dashboard-ui";
-import type { CostGroupRow } from "../contracts.js";
+import type { CostGroupRow, CostPeriodAverages } from "../contracts.js";
 import type { CostCurrency, CostLocale } from "./cost-monitor-copy.js";
 import { type CostPeriodGranularity, summarizeCostPeriodAverages } from "./period-cost-groups.js";
 
 export function CostPeriodAverageCards({
   currency,
   locale,
+  loading = false,
+  average: suppliedAverage,
   period,
   rows,
 }: {
   currency: CostCurrency;
   locale: CostLocale;
+  loading?: boolean;
+  average?: CostPeriodAverages | null;
   period: CostPeriodGranularity;
   rows: readonly CostGroupRow[];
 }) {
-  const average = summarizeCostPeriodAverages(rows, currency);
+  if (loading) {
+    return <p role="status">{locale === "pt-BR" ? "Carregando médias…" : "Loading averages…"}</p>;
+  }
+  // A server page without full-population averages is unavailable, never a page-only average.
+  const average =
+    suppliedAverage === undefined
+      ? summarizeCostPeriodAverages(rows, currency)
+      : (suppliedAverage ?? {
+          tasks: null,
+          specs: null,
+          prds: null,
+          durationMs: null,
+          tokens: null,
+          cost: null,
+        });
+  const unavailable = locale === "pt-BR" ? "Indisponível" : "Unavailable";
   return (
     <PeriodAverageCards
       ariaLabel={periodAverageAriaLabel(period, locale)}
       metrics={[
         {
           label: periodAverageMetricLabel(locale === "pt-BR" ? "Tarefas" : "Tasks", period, locale),
-          value: formatNumber(average.tasks, locale, 1),
+          value: average.tasks === null ? unavailable : formatNumber(average.tasks, locale, 1),
         },
         {
           label: periodAverageMetricLabel("SPECs", period, locale),
-          value: formatNumber(average.specs, locale, 1),
+          value: average.specs === null ? unavailable : formatNumber(average.specs, locale, 1),
         },
         {
           label: periodAverageMetricLabel("PRDs", period, locale),
-          value: formatNumber(average.prds, locale, 1),
+          value: average.prds === null ? unavailable : formatNumber(average.prds, locale, 1),
         },
         {
           label: periodAverageMetricLabel(locale === "pt-BR" ? "Tempo" : "Time", period, locale),
-          value: formatAverageDurationMs(average.durationMs, locale),
+          value:
+            average.durationMs === null
+              ? unavailable
+              : formatAverageDurationMs(average.durationMs, locale),
         },
         {
           label: periodAverageMetricLabel("Tokens", period, locale),
-          value: formatCompactNumber(average.tokens, locale),
+          value:
+            average.tokens === null ? unavailable : formatCompactNumber(average.tokens, locale),
         },
         {
           label: periodAverageMetricLabel(locale === "pt-BR" ? "Custo" : "Cost", period, locale),
-          value: formatCurrency(average.cost, currency, locale),
+          value:
+            average.cost === null ? unavailable : formatCurrency(average.cost, currency, locale),
         },
       ]}
     />

package/templates/.agents/dashboard/modules/cost-monitor/src/react/cost-monitor-summary.ts

@@ -5,6 +5,7 @@ import {
 } from "@zaip-ai/dashboard-operations/contracts";
 import {
   aggregateDurationCoverage,
+  averageCompleteCost,
   type CostGroupRow,
   type CostMonitorProjection,
   type CostRunRow,
@@ -120,8 +121,8 @@ export function summarizeCostRows(
     estimated_brl: sumKnown(rows.map((row) => row.estimated_brl)),
     recorded_usd: sumKnown(rows.map((row) => row.recorded_usd)),
     recorded_brl: sumKnown(rows.map((row) => row.recorded_brl)),
-    average_run_cost_usd: average(rows.map((row) => row.estimated_usd)),
-    average_run_cost_brl: average(rows.map((row) => row.estimated_brl)),
+    average_run_cost_usd: averageCompleteCost(rows.map((row) => row.estimated_usd)),
+    average_run_cost_brl: averageCompleteCost(rows.map((row) => row.estimated_brl)),
     average_run_duration_ms: average(durationContributors(rows).map((row) => row.duration_ms)),
     known_tokens_per_cycle: knownCycles === 0 ? null : knownTokens / knownCycles,
     top_10_token_share: knownTokens === 0 ? null : top10Tokens / knownTokens,

package/templates/.agents/dashboard/modules/cost-monitor/src/react/period-cost-groups.ts

@@ -3,14 +3,7 @@ import type { CostGroupRow } from "../contracts.js";
 
 export type CostPeriodGranularity = "daily" | "monthly" | "annual";
 
-export interface CostPeriodAverages {
-  tasks: number | null;
-  specs: number | null;
-  prds: number | null;
-  durationMs: number | null;
-  tokens: number | null;
-  cost: number | null;
-}
+export { type CostPeriodAverages, summarizeCostPeriodAverages } from "../period-averages.js";
 
 interface PeriodEntities {
   prds: readonly { created_at: string | null }[];
@@ -122,40 +115,6 @@ export function enrichPeriodCostGroups(
   return [...rows.values()].sort((left, right) => right.key.localeCompare(left.key));
 }
 
-export function summarizeCostPeriodAverages(
-  rows: readonly CostGroupRow[],
-  currency: "BRL" | "USD",
-): CostPeriodAverages {
-  const divisor = rows.length;
-  return {
-    tasks:
-      divisor === 0 ? null : rows.reduce((sum, row) => sum + (row.task_count ?? 0), 0) / divisor,
-    specs:
-      divisor === 0 ? null : rows.reduce((sum, row) => sum + (row.spec_count ?? 0), 0) / divisor,
-    prds: divisor === 0 ? null : rows.reduce((sum, row) => sum + (row.prd_count ?? 0), 0) / divisor,
-    durationMs: averagePerPeriod(
-      rows.map((row) => row.duration_ms),
-      divisor,
-    ),
-    tokens: averageObserved(rows.map((row) => row.total_tokens)),
-    cost: averageObserved(
-      rows.map((row) => (currency === "BRL" ? row.estimated_brl : row.estimated_usd)),
-    ),
-  };
-}
-
-function averageObserved(values: readonly (number | null)[]): number | null {
-  const present = values.filter((value): value is number => value !== null);
-  return present.length === 0
-    ? null
-    : present.reduce((sum, value) => sum + value, 0) / present.length;
-}
-
-function averagePerPeriod(values: readonly (number | null)[], periodCount: number): number | null {
-  if (periodCount === 0) return null;
-  return values.reduce<number>((sum, value) => sum + (value ?? 0), 0) / periodCount;
-}
-
 function periodKey(value: string | null, granularity: CostPeriodGranularity): string | null {
   return saoPauloPeriodKey(
     value,

package/templates/.agents/dashboard/modules/cost-monitor/src/react/use-cost-group-page.ts

@@ -1,5 +1,5 @@
 import { useEffect, useRef, useState } from "react";
-import type { CostGroupRow } from "../contracts.js";
+import type { CostGroupRow, CostPeriodAverages } from "../contracts.js";
 import type { CostFilterState } from "./CostFilters.js";
 import type { CostLocale } from "./cost-monitor-copy.js";
 
@@ -26,6 +26,7 @@ export type CostGroupPage = {
   has_more: boolean;
   rows: readonly CostGroupRow[];
   totals?: CostGroupTotals;
+  period_averages?: Record<"BRL" | "USD", CostPeriodAverages>;
 };
 export type CostGroupFilters = CostFilterState;
 export type LoadCostGroupPage = (request: {

package/templates/.agents/dashboard/modules/cost-monitor/src/server/build-cost-monitor-projection.ts

@@ -15,6 +15,7 @@ import type {
 import { LEGACY_EFFORT_SNAPSHOT, saoPauloPeriodKey } from "@zaip-ai/dashboard-operations/contracts";
 import { includeConfiguredAgentGroups } from "../agent-groups.js";
 import {
+  averageCompleteCost,
   type CostMonitorProjection,
   type CostRunRow,
   durationAggregationRows,
@@ -215,8 +216,8 @@ export function buildCostMonitorProjection(
       recorded_brl: availableCurrencySum(
         tableRuns.map((run) => recordedRunsById.get(run.id)?.usage.total.cost.brl ?? null),
       ),
-      average_run_cost_usd: averageAvailable(rows.map((row) => row.estimated_usd)),
-      average_run_cost_brl: averageAvailable(rows.map((row) => row.estimated_brl)),
+      average_run_cost_usd: averageCompleteCost(rows.map((row) => row.estimated_usd)),
+      average_run_cost_brl: averageCompleteCost(rows.map((row) => row.estimated_brl)),
       average_run_duration_ms: averageAvailable(
         durationAggregationRows(rows).map((row) => row.duration_ms),
       ),

package/templates/.agents/dashboard/modules/cost-monitor/src/server/build-cost-summary-projection.ts

@@ -183,8 +183,14 @@ export function buildCostSummaryProjection(
       estimated_brl: brlTotal,
       recorded_usd: null,
       recorded_brl: null,
-      average_run_cost_usd: runCount === 0 || usdTotal === null ? null : usdTotal / runCount,
-      average_run_cost_brl: runCount === 0 || brlTotal === null ? null : brlTotal / runCount,
+      average_run_cost_usd:
+        runCount === 0 || usdTotal === null || coverage.usd !== runCount
+          ? null
+          : usdTotal / runCount,
+      average_run_cost_brl:
+        runCount === 0 || brlTotal === null || coverage.brl !== runCount
+          ? null
+          : brlTotal / runCount,
       // Legacy effort has no individual Run cardinality, so it is not a
       // legitimate contributor to an average per Run.
       average_run_duration_ms: observedDurationAverage,

package/templates/.agents/dashboard/modules/cost-monitor/src/server/index.ts

@@ -1,3 +1,4 @@
+export { summarizeCostPeriodAverages } from "../period-averages.js";
 export * from "./build-cost-monitor-projection.js";
 export * from "./build-cost-summary-projection.js";
 export * from "./run-telemetry.js";

package/templates/.agents/dashboard/modules/operations/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/dashboard-operations",
-  "version": "2.6.0",
+  "version": "3.1.0",
   "private": true,
   "type": "module",
   "exports": {