@zaip-ai/cli 3.2.0 → 3.4.0

package/templates/.agents/dashboard/modules/cost-monitor/src/server/cost-summary-duration.test.ts

@@ -0,0 +1,189 @@
+import type { OperationsProjection } from "@zaip-ai/dashboard-operations/contracts";
+import { describe, expect, it } from "vitest";
+import {
+  buildCostSummaryProjection,
+  type CostSummarySource,
+} from "./build-cost-summary-projection.js";
+
+describe("Factual duration and cost", () => {
+  it("keeps tokenized compact Runs without factual timing unavailable", () => {
+    const summary: CostSummarySource = {
+      periods: {
+        daily: {
+          "2026-08-07": {
+            prds: 0,
+            specs: 0,
+            tasks: 0,
+            validations: 0,
+            evidences: 0,
+            runs: 1,
+            usage: {
+              total_tokens: { known_sum: 4_000_000, unknown: 0, complete: true, coverage_ratio: 1 },
+              cost: {
+                known_sum: 1,
+                unknown: 0,
+                complete: true,
+                coverage_ratio: 1,
+                currency: "BRL",
+              },
+            },
+          },
+        },
+      },
+      run_metrics: [
+        {
+          id: "TOKEN-ONLY",
+          started_at: "2026-08-07T12:00:00.000Z",
+          finished_at: null,
+          task_id: null,
+          phase: "execution",
+          parent_run_id: null,
+          status: null,
+          duration_ms: null,
+          total_tokens: 4_000_000,
+          cost: 1,
+          currency: "BRL",
+          events: 1,
+        },
+      ],
+    };
+    const operations = {
+      filters: { from: "2026-08-07", to: "2026-08-07" },
+      summary: { task_count: 0 },
+      prds: [],
+      specs: [],
+    } as unknown as OperationsProjection;
+    const projection = buildCostSummaryProjection(summary, operations, "BRL", null);
+    expect(projection.groups.daily[0]?.duration).toMatchObject({
+      known_sum: 0,
+      unknown: 1,
+      complete: false,
+    });
+    expect(projection.groups.daily[0]?.duration_ms).toBeNull();
+  });
+
+  it("keeps a tokenized legacy period without factual duration unavailable", () => {
+    const summary: CostSummarySource = {
+      periods: {
+        daily: {
+          "2026-08-07": {
+            prds: 0,
+            specs: 0,
+            tasks: 0,
+            validations: 0,
+            evidences: 0,
+            runs: 1,
+            usage: {
+              total_tokens: { known_sum: 4_000_000, unknown: 0, complete: true, coverage_ratio: 1 },
+              cost: {
+                known_sum: 1,
+                unknown: 0,
+                complete: true,
+                coverage_ratio: 1,
+                currency: "BRL",
+              },
+            },
+          },
+        },
+      },
+    };
+    const operations = {
+      filters: { from: "2026-08-07", to: "2026-08-07" },
+      summary: { task_count: 0 },
+      prds: [],
+      specs: [],
+    } as unknown as OperationsProjection;
+    const projection = buildCostSummaryProjection(summary, operations, "BRL", null);
+    expect(projection.groups.daily[0]).toMatchObject({
+      total_tokens: 4_000_000,
+      duration_ms: null,
+      duration: { known_sum: 0, unknown: 1, complete: false },
+    });
+  });
+
+  it("uses the canonical root duration and excludes child and conversation duration", () => {
+    const summary: CostSummarySource = {
+      periods: {
+        daily: {
+          "2026-07-24": {
+            prds: 0,
+            specs: 0,
+            tasks: 0,
+            validations: 0,
+            evidences: 0,
+            runs: 3,
+            usage: {
+              total_tokens: { known_sum: 3, unknown: 0, complete: true, coverage_ratio: 1 },
+              cost: {
+                known_sum: 3,
+                unknown: 0,
+                complete: true,
+                coverage_ratio: 1,
+                currency: "BRL",
+              },
+            },
+            duration: { known_sum: 60_109_200, unknown: 0, complete: true, coverage_ratio: 1 },
+          },
+        },
+      },
+      run_metrics: [
+        {
+          id: "ROOT",
+          started_at: "2026-07-24T20:00:00.000Z",
+          finished_at: null,
+          task_id: null,
+          phase: "execution",
+          parent_run_id: null,
+          status: null,
+          duration_ms: 23_241_600,
+          total_tokens: 1,
+          cost: 1,
+          currency: "BRL",
+          events: 1,
+        },
+        {
+          id: "CHILD",
+          started_at: "2026-07-24T20:01:00.000Z",
+          finished_at: null,
+          task_id: null,
+          phase: "execution",
+          parent_run_id: "ROOT",
+          status: null,
+          duration_ms: 36_867_600,
+          total_tokens: 1,
+          cost: 1,
+          currency: "BRL",
+          events: 1,
+        },
+        {
+          id: "CONVERSATION",
+          started_at: "2026-07-24T20:02:00.000Z",
+          finished_at: null,
+          task_id: null,
+          phase: "conversation",
+          parent_run_id: null,
+          status: null,
+          duration_ms: 1_000,
+          total_tokens: 1,
+          cost: 1,
+          currency: "BRL",
+          events: 1,
+        },
+      ],
+      canonical_daily_duration_ms: { "2026-07-24": 23_241_600 },
+    };
+    const operations = {
+      filters: { from: null, to: null },
+      summary: { task_count: 0 },
+      prds: [],
+      specs: [],
+    } as unknown as OperationsProjection;
+    const row = buildCostSummaryProjection(summary, operations, "BRL", null).groups.daily.find(
+      (value) => value.key === "2026-07-24",
+    )!;
+
+    expect(row.duration.known_sum).toBe(23_241_600);
+    expect(row.duration.coverage_ratio).toBe(1);
+    expect(row.run_count).toBe(3);
+  });
+});

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

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

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

@@ -0,0 +1,82 @@
+import type { OperationsLocale } from "./status-labels.js";
+import { riskLabel } from "./status-labels.js";
+import { taskOriginLabel, taskOriginOptions, type TaskOrigin } from "./task-origin.js";
+import { workStageLabel, workStages } from "./work-board-model.js";
+
+/** Work filters belong to the visible shared header, not the retired hero. */
+export function OperationsEntityFilters({
+  locale,
+  query,
+  status,
+  risk,
+  origin,
+  onQuery,
+  onStatus,
+  onRisk,
+  onOrigin,
+}: {
+  locale: OperationsLocale;
+  query: string;
+  status: string;
+  risk: string;
+  origin: TaskOrigin | "";
+  onQuery: (value: string) => void;
+  onStatus: (value: string) => void;
+  onRisk: (value: string) => void;
+  onOrigin: (value: TaskOrigin | "") => void;
+}) {
+  const all = locale === "pt-BR" ? "Todos" : "All";
+  return (
+    <div className="operations-entity-filters">
+      <label>
+        <span>{locale === "pt-BR" ? "Busca" : "Search"}</span>
+        <input
+          aria-label={locale === "pt-BR" ? "Busca" : "Search"}
+          value={query}
+          onChange={(e) => onQuery(e.target.value)}
+        />
+      </label>
+      <label>
+        <span>Status</span>
+        <select aria-label="Status" value={status} onChange={(e) => onStatus(e.target.value)}>
+          <option value="">{all}</option>
+          {workStages.map((stage) => (
+            <option key={stage} value={stage}>
+              {workStageLabel(stage, locale)}
+            </option>
+          ))}
+        </select>
+      </label>
+      <label>
+        <span>{locale === "pt-BR" ? "Risco" : "Risk"}</span>
+        <select
+          aria-label={locale === "pt-BR" ? "Risco" : "Risk"}
+          value={risk}
+          onChange={(e) => onRisk(e.target.value)}
+        >
+          <option value="">{all}</option>
+          {["lite", "standard", "critical"].map((value) => (
+            <option key={value} value={value}>
+              {riskLabel(value, locale)}
+            </option>
+          ))}
+        </select>
+      </label>
+      <label>
+        <span>{locale === "pt-BR" ? "Origem" : "Origin"}</span>
+        <select
+          aria-label={locale === "pt-BR" ? "Origem" : "Origin"}
+          value={origin}
+          onChange={(e) => onOrigin(e.target.value as TaskOrigin | "")}
+        >
+          <option value="">{all}</option>
+          {taskOriginOptions.map((value) => (
+            <option key={value} value={value}>
+              {taskOriginLabel(value)}
+            </option>
+          ))}
+        </select>
+      </label>
+    </div>
+  );
+}

package/templates/.agents/dashboard/modules/operations/src/react/OperationsOverview.helpers.tsx

@@ -601,12 +601,15 @@ export function formatExecutionAverageHint(
   locale: OperationsLocale,
 ): string {
   if (totalTasks <= 0) return "0";
-  if (totalDurationMs <= 0 || totalDays <= 0) {
+  if (totalDurationMs <= 0) {
     return locale === "pt-BR"
       ? "Médias de execução indisponíveis"
       : "Execution averages unavailable";
   }
   const averagePerTask = formatRoundedDuration(totalDurationMs / totalTasks, locale);
+  // Macro aggregates can provide duration and population without individual
+  // execution days. Keep the known per-item average available in that case.
+  if (totalDays <= 0) return `${averagePerTask} / item`;
   const averagePerDay = formatDurationInHours(totalDurationMs / totalDays);
   const totalDaysLabel =
     locale === "pt-BR" ? `${totalDays} dias` : `${totalDays} ${totalDays === 1 ? "day" : "days"}`;

package/templates/.agents/dashboard/modules/operations/src/react/OperationsOverview.test.ts

@@ -357,6 +357,11 @@ describe("execution average summary", () => {
       "20 min / tarefa (6 h / dia) (6 dias)",
     );
   });
+  it("keeps the known macro average when execution days are unavailable", () => {
+    expect(formatExecutionAverageHint(3_600_000, 3, 0, "pt-BR")).toBe("20 min / item");
+    expect(formatExecutionAverageHint(3_600_000, 3, 0, "en-US")).toBe("20 min / item");
+    expect(formatExecutionAverageHint(0, 3, 0, "pt-BR")).toBe("Médias de execução indisponíveis");
+  });
   it("localizes English and shows zero for an empty population", () => {
     expect(formatExecutionAverageHint(3_600_000, 3, 1, "en-US")).toBe(
       "20 min / task (1 h / day) (1 day)",

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

@@ -2,6 +2,7 @@ import { DashboardHeader } from "@zaip-ai/dashboard-ui";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { ExcelExportAction } from "./export/ExcelExportAction.js";
 import { OperationDateFilters } from "./OperationDateFilters.js";
+import { OperationsEntityFilters } from "./OperationsEntityFilters.js";
 import {
   ChevronDownIcon,
   FilterIcon,
@@ -17,6 +18,7 @@ import {
   resolveOperationsPeriodControl,
   workListTypeOnViewChange,
 } from "./operations-page-contract.js";
+import { useOperationFilterFeedback } from "./use-operation-filter-feedback.js";
 
 export {
   type DashboardGlobalFilters,
@@ -33,17 +35,16 @@ import {
   type OperationDatePreset,
   type OperationDateRange,
 } from "./operation-date-range.js";
+import { factualDurationRowsForExport } from "./operations-export-duration.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 { applyFactualPeriodCosts, applyFactualPeriodDurations } from "./PeriodSummaryTable.js";
-import {
-  aggregateManifestPeriodSummary,
-  aggregatePeriodSummary,
-  type PeriodGranularity,
-  type PeriodSummaryRow,
-} from "./period-summary.js";
+import { applyFactualPeriodCosts } from "./PeriodSummaryTable.js";
+
+export { factualDurationRowsForExport } from "./operations-export-duration.js";
+
+import { aggregateManifestPeriodSummary, aggregatePeriodSummary } from "./period-summary.js";
 import { periodSummaryPopulation } from "./period-summary-population.js";
 import { scopeRunsToEntities } from "./run-scope.js";
 import { riskLabel } from "./status-labels.js";
@@ -66,17 +67,6 @@ 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,
@@ -130,8 +120,7 @@ export function OperationsPage({
   const [statusFilter, setStatusFilter] = useState("");
   const [riskFilter, setRiskFilter] = useState("");
   const [originFilter, setOriginFilter] = useState<TaskOrigin | "">("");
-  const [filterLoading, setFilterLoading] = useState(false);
-  const filterLoadingTimer = useRef<number | null>(null);
+  const { filterLoading, showFilterLoading } = useOperationFilterFeedback();
   const searchInputRef = useRef<HTMLInputElement>(null);
   const defaultDateRange = useMemo(() => {
     const operationsRange = initialOperationsDateRange(
@@ -165,17 +154,6 @@ export function OperationsPage({
   );
   // Coverage is derived display data, not a user selection. Never feed it
   // back through onDateChange: a delayed effect can overwrite a newer period.
-  const showFilterLoading = useCallback(() => {
-    setFilterLoading(true);
-    if (filterLoadingTimer.current !== null) window.clearTimeout(filterLoadingTimer.current);
-    filterLoadingTimer.current = window.setTimeout(() => setFilterLoading(false), 220);
-  }, []);
-  useEffect(
-    () => () => {
-      if (filterLoadingTimer.current !== null) window.clearTimeout(filterLoadingTimer.current);
-    },
-    [],
-  );
   const renderedAlternateContent =
     typeof alternateContent === "function"
       ? alternateContent({ query, datePreset, ...(datePreset === "all" ? {} : { dateRange }) })
@@ -467,6 +445,19 @@ export function OperationsPage({
                 </span>
               ) : null}
             </div>
+            {!renderedAlternateContent ? (
+              <OperationsEntityFilters
+                locale={locale}
+                query={query}
+                status={statusFilter}
+                risk={riskFilter}
+                origin={originFilter}
+                onQuery={setQuery}
+                onStatus={setStatusFilter}
+                onRisk={setRiskFilter}
+                onOrigin={setOriginFilter}
+              />
+            ) : null}
             <OperationDateFilters
               ariaLabelSuffix={locale === "pt-BR" ? " nos filtros" : " in filters"}
               dateRange={dateRange}

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

@@ -1,9 +1,21 @@
 import { createElement } from "react";
 import { renderToStaticMarkup } from "react-dom/server";
 import { describe, expect, it } from "vitest";
-import { PagedWorkList } from "./PagedWorkList.js";
+import { PagedWorkList, pagedWorkStatusLabel } from "./PagedWorkList.js";
 
 describe("PagedWorkList", () => {
+  it("displays the reconciled macro stage while preserving draft Task semantics", () => {
+    expect(pagedWorkStatusLabel({ status: "active", stage: "verifying" }, "pt-BR")).toBe(
+      "Verificação",
+    );
+    expect(pagedWorkStatusLabel({ status: "draft", stage: "planning" }, "pt-BR")).toBe(
+      "Planejamento (SPEC + Change)",
+    );
+    expect(pagedWorkStatusLabel({ status: "draft", stage: null }, "pt-BR")).toBe("Rascunho");
+    expect(pagedWorkStatusLabel({ status: "delivered", stage: "completed" }, "en-US")).toBe(
+      "Completed",
+    );
+  });
   it("renders the factual developer column without object coercion", () => {
     const markup = renderToStaticMarkup(
       createElement(PagedWorkList, {

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

@@ -3,7 +3,12 @@ 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";
+import {
+  workStageLabel,
+  workStages,
+  type WorkStage,
+  type WorkTypeFilter,
+} from "./work-board-model.js";
 
 export type PagedWorkListRow = Record<string, unknown>;
 export type PagedWorkListPage = {
@@ -25,6 +30,14 @@ function number(value: unknown): number | null {
   return typeof value === "number" && Number.isFinite(value) ? value : null;
 }
 
+export function pagedWorkStatusLabel(row: PagedWorkListRow, locale: OperationsLocale): string {
+  const stage = row.stage ?? row.status;
+  if (stage === "draft") return locale === "pt-BR" ? "Rascunho" : "Draft";
+  return workStages.includes(stage as WorkStage)
+    ? workStageLabel(stage as WorkStage, locale)
+    : text(stage);
+}
+
 function workKindLabel(value: unknown, locale: OperationsLocale) {
   const kind = text(value, "");
   const labels =
@@ -77,8 +90,8 @@ export function PagedWorkList({
             {
               key: "status",
               label: "Status",
-              render: (row) => text(row.status),
-              sortValue: (row) => text(row.status),
+              render: (row) => pagedWorkStatusLabel(row, locale),
+              sortValue: (row) => pagedWorkStatusLabel(row, locale),
             },
             {
               key: "type",

package/templates/.agents/dashboard/modules/operations/src/react/export/ExcelExportAction.test.ts

@@ -9,7 +9,6 @@ import {
   EXPORT_SUCCESS_TOAST_MS,
   exportAgentInvocationRows,
   exportCompactLifecycleRows,
-  exportCostAgentRows,
   exportCostGroupRows,
   exportDeveloperRows,
   exportExecutionRows,
@@ -466,6 +465,17 @@ it("exports compact Task, SPEC, PRD, and Conversation rows with entity columns",
   ]);
 });
 
+it("preserves unavailable compact timing and cost while exporting known tokens and real zero", () => {
+  const missing = { known_sum: 0, unknown: 1, complete: false, coverage_ratio: 0 };
+  const zero = { known_sum: 0, unknown: 0, complete: true, coverage_ratio: 1 };
+  const rows = exportCompactLifecycleRows([
+    { metrics: { duration: missing, cost: missing, total_tokens: { ...zero, known_sum: 15 } } },
+    { metrics: { duration: zero, cost: zero, total_tokens: zero } },
+  ]);
+  expect(rows[0]).toMatchObject({ duration_hours: null, cost_brl: null, tokens: 15 });
+  expect(rows[1]).toMatchObject({ duration_hours: 0, cost_brl: 0, tokens: 0 });
+});
+
 it("keeps cost-executions headers and exported row keys in the compact lifecycle schema", () => {
   const source = {
     id: "RUN-42",
@@ -579,29 +589,3 @@ it("exports model analysis in table order with explicit numeric zeroes", () => {
 it("clears pending success when a new export starts", () => {
   expect("running").not.toBe("completed");
 });
-
-it("exports Agent tasks as participations and fills every missing numeric cell with zero", () => {
-  expect(COST_AGENT_EXPORT_COLUMNS).toEqual([
-    "Persona",
-    "Cargo",
-    "Zaip Agentes",
-    "PRDs",
-    "SPECs",
-    "Tarefas",
-    "Runs",
-    "Testes",
-    "Evidências",
-    "Tempo",
-    "Tokens",
-    "Custos",
-  ]);
-  const rows = exportCostAgentRows([
-    { key: "dave", task_count: 2 },
-    { key: "leo", task_count: 2 },
-    {},
-  ]);
-  expect(rows[0]?.Tarefas).toBe(2);
-  expect(rows[1]?.Tarefas).toBe(2);
-  for (const key of COST_AGENT_EXPORT_COLUMNS.slice(3)) expect(rows[2]?.[key]).toBe(0);
-  expect(rows[0]).not.toHaveProperty("tasks_created");
-});