@zaip-ai/cli 1.0.8 → 1.3.1

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

@@ -0,0 +1,54 @@
+import { readFileSync } from "node:fs";
+import { createElement } from "react";
+import { renderToStaticMarkup } from "react-dom/server";
+import { describe, expect, it } from "vitest";
+import {
+  type DeveloperAttributionRow,
+  DeveloperAttributionTable,
+} from "./DeveloperAttributionPanel.js";
+
+const row = (account_id: string): DeveloperAttributionRow => ({
+  account_id,
+  login_snapshot: `developer-${account_id}`,
+  status_counts: { executing: 1 },
+  type_counts: { task: 1 },
+  risk_counts: { standard: 1 },
+  task_count: 1,
+  completed_task_count: 0,
+  total_duration_ms: 1,
+  total_tokens: 1,
+  total_cost_brl: 1,
+});
+
+describe("DeveloperAttributionPanel", () => {
+  it("renders the canonical ui-table and its pagination for more than ten developers", () => {
+    const rows = Array.from({ length: 11 }, (_, index) => row(String(index + 1)));
+    const markup = renderToStaticMarkup(
+      createElement(DeveloperAttributionTable, { locale: "pt-BR", rows }),
+    );
+
+    expect(markup).toContain('class="ui-table"');
+    expect(markup).toContain('class="ui-table-pagination"');
+    expect(markup).toContain("Página 1 / 2");
+    expect(markup).toContain("Desenvolvedor");
+    expect(markup).toContain("Tarefas Concluídas");
+    expect(markup).toContain("Status");
+    expect(markup).toContain("Tipo");
+    expect(markup).toContain("Risco");
+    expect(markup).not.toContain("Origem");
+    expect(markup).not.toContain("Cobertura");
+  });
+
+  it("keeps one accessible shared table with factual columns and explicit states", () => {
+    const panel = readFileSync(new URL("./DeveloperAttributionPanel.tsx", import.meta.url), "utf8");
+
+    expect(panel).toContain("/api/v2/operations/developers");
+    expect(panel).toContain("<DataTable");
+    expect(panel).toContain("pageSize={10}");
+    expect(panel).toContain('role="status"');
+    expect(panel).toContain('role="alert"');
+    expect(panel).toContain("scrollLabel={copy.caption}");
+    expect(panel).toContain("status_counts");
+    expect(panel).toContain("completed_task_count");
+  });
+});

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

@@ -0,0 +1,247 @@
+import { DataTable, formatCompactNumber, formatCurrency } from "@zaip-ai/dashboard-ui";
+import { useEffect, useState } from "react";
+import { formatOperationDuration } from "./operation-duration.js";
+
+export type DeveloperAttributionRow = {
+  account_id: string;
+  login_snapshot: string | null;
+  status_counts: Record<string, number> | null;
+  type_counts: Record<string, number> | null;
+  risk_counts: Record<string, number> | null;
+  task_count: number;
+  completed_task_count: number;
+  total_duration_ms: number | null;
+  total_tokens: number | null;
+  total_cost_brl: number | null;
+};
+
+type DeveloperCopy = {
+  caption: string;
+  status: string;
+  type: string;
+  risk: string;
+  loading: string;
+  empty: string;
+  error: string;
+  developer: string;
+  cost: string;
+  tasks: string;
+  completedTasks: string;
+  duration: string;
+  tokens: string;
+};
+
+function developerCopy(locale: "pt-BR" | "en-US"): DeveloperCopy {
+  return locale === "pt-BR"
+    ? {
+        caption: "Custos e entregas por desenvolvedor",
+        loading: "Carregando desenvolvedores…",
+        empty: "Nenhum dado disponível.",
+        error: "Não foi possível carregar desenvolvedores.",
+        developer: "Desenvolvedor",
+        status: "Status",
+        type: "Tipo",
+        risk: "Risco",
+        tasks: "Tarefas",
+        completedTasks: "Tarefas Concluídas",
+        duration: "Tempo",
+        tokens: "Tokens",
+        cost: "Custo",
+      }
+    : {
+        caption: "Cost and delivery by developer",
+        loading: "Loading developers…",
+        empty: "No data available.",
+        error: "Could not load developers.",
+        developer: "Developer",
+        status: "Status",
+        type: "Type",
+        risk: "Risk",
+        tasks: "Tasks",
+        completedTasks: "Completed Tasks",
+        duration: "Time",
+        tokens: "Tokens",
+        cost: "Cost",
+      };
+}
+
+function distributionLabel(value: Record<string, number> | null, locale: "pt-BR" | "en-US") {
+  if (value === null || Object.keys(value).length === 0)
+    return locale === "pt-BR" ? "Indisponível" : "Unavailable";
+  const labels: Record<string, string> =
+    locale === "pt-BR"
+      ? {
+          task: "Tarefa",
+          "standalone-task": "Tarefa avulsa",
+          standard: "Padrão",
+          critical: "Crítico",
+          lite: "Leve",
+        }
+      : {
+          task: "Task",
+          "standalone-task": "Standalone task",
+          standard: "Standard",
+          critical: "Critical",
+          lite: "Lite",
+        };
+  return Object.entries(value)
+    .map(([key, count]) => `${labels[key] ?? key}: ${count}`)
+    .join(" · ");
+}
+
+/** Operations-only table. Distributions are canonical work-item facts, never defaults. */
+export function DeveloperAttributionTable({
+  locale,
+  rows,
+}: {
+  locale: "pt-BR" | "en-US";
+  rows: readonly DeveloperAttributionRow[];
+}) {
+  const copy = developerCopy(locale);
+  return (
+    <div className="developer-attribution-table">
+      <DataTable
+        columns={[
+          {
+            key: "developer",
+            label: copy.developer,
+            render: (row) => (
+              <>
+                <strong>{row.login_snapshot ?? row.account_id}</strong>
+                <br />
+                <small>#{row.account_id}</small>
+              </>
+            ),
+            sortValue: (row) => row.login_snapshot ?? row.account_id,
+          },
+          {
+            key: "status",
+            label: copy.status,
+            render: (row) => distributionLabel(row.status_counts, locale),
+            sortValue: (row) => distributionLabel(row.status_counts, locale),
+          },
+          {
+            key: "type",
+            label: copy.type,
+            render: (row) => distributionLabel(row.type_counts, locale),
+            sortValue: (row) => distributionLabel(row.type_counts, locale),
+          },
+          {
+            key: "risk",
+            label: copy.risk,
+            render: (row) => distributionLabel(row.risk_counts, locale),
+            sortValue: (row) => distributionLabel(row.risk_counts, locale),
+          },
+          {
+            key: "tasks",
+            label: copy.tasks,
+            align: "right",
+            render: (row) => row.task_count,
+            sortValue: (row) => row.task_count,
+          },
+          {
+            key: "completed-tasks",
+            label: copy.completedTasks,
+            align: "right",
+            render: (row) => row.completed_task_count,
+            sortValue: (row) => row.completed_task_count,
+          },
+          {
+            key: "duration",
+            label: copy.duration,
+            align: "right",
+            render: (row) => formatOperationDuration(row.total_duration_ms, locale),
+            sortValue: (row) => row.total_duration_ms,
+          },
+          {
+            key: "tokens",
+            label: copy.tokens,
+            align: "right",
+            render: (row) =>
+              row.total_tokens === null
+                ? locale === "pt-BR"
+                  ? "Indisponível"
+                  : "Unavailable"
+                : formatCompactNumber(row.total_tokens, locale),
+            sortValue: (row) => row.total_tokens,
+          },
+          {
+            key: "cost",
+            label: copy.cost,
+            align: "right",
+            render: (row) =>
+              row.total_cost_brl === null
+                ? locale === "pt-BR"
+                  ? "Indisponível"
+                  : "Unavailable"
+                : formatCurrency(row.total_cost_brl, "BRL", locale),
+            sortValue: (row) => row.total_cost_brl,
+          },
+        ]}
+        defaultSort={{ key: "cost", direction: "desc" }}
+        emptyMessage={copy.empty}
+        locale={locale}
+        pageSize={10}
+        rowKey={(row) => row.account_id}
+        rows={rows}
+        scrollLabel={copy.caption}
+        sortable
+      />
+    </div>
+  );
+}
+
+export function DeveloperAttributionPanel({
+  from,
+  to,
+  locale,
+}: {
+  from?: string | undefined;
+  to?: string | undefined;
+  locale: "pt-BR" | "en-US";
+}) {
+  const [state, setState] = useState<{
+    loading: boolean;
+    error: string | null;
+    rows: readonly DeveloperAttributionRow[];
+  }>({ loading: true, error: null, rows: [] });
+  useEffect(() => {
+    const controller = new AbortController();
+    const params = new URLSearchParams();
+    if (from) params.set("from", from);
+    if (to) params.set("to", to);
+    setState((previous) => ({ ...previous, loading: true, error: null }));
+    fetch(`/api/v2/operations/developers${params.size ? `?${params}` : ""}`, {
+      signal: controller.signal,
+    })
+      .then(async (response) => {
+        if (!response.ok) throw new Error(`HTTP ${response.status}`);
+        return response.json() as Promise<{ rows?: DeveloperAttributionRow[] }>;
+      })
+      .then((payload) => setState({ loading: false, error: null, rows: payload.rows ?? [] }))
+      .catch((error: unknown) => {
+        if ((error as { name?: string }).name !== "AbortError") {
+          setState({
+            loading: false,
+            error: error instanceof Error ? error.message : "unknown",
+            rows: [],
+          });
+        }
+      });
+    return () => controller.abort();
+  }, [from, to]);
+  const copy = developerCopy(locale);
+  if (state.loading)
+    return (
+      <p className="operations-empty" role="status">
+        {copy.loading}
+      </p>
+    );
+  if (state.error)
+    return (
+      <p className="operations-empty" role="alert">
+        {copy.error} {state.error}
+      </p>
+    );
+  return <DeveloperAttributionTable locale={locale} rows={state.rows} />;
+}

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

@@ -143,7 +143,9 @@ export function ExecutionTable({
                   {
                     durationMs: row.duration_ms,
                     provenance:
-                      row.duration_ms === null && row.status === "running" ? "in_progress" : "factual",
+                      row.duration_ms === null && row.status === "running"
+                        ? "in_progress"
+                        : "factual",
                   },
                   locale,
                 ),
@@ -282,13 +284,21 @@ export function RunTable({
     value === null || value === undefined ? "—" : formatCurrency(value, "USD", locale);
   const provenance = (value: RunProjection["duration_provenance"]) =>
     value === "observed"
-      ? locale === "pt-BR" ? "Observada" : "Observed"
+      ? locale === "pt-BR"
+        ? "Observada"
+        : "Observed"
       : value === "reconciled"
-        ? locale === "pt-BR" ? "Reconciliada" : "Reconciled"
+        ? locale === "pt-BR"
+          ? "Reconciliada"
+          : "Reconciled"
         : value === "estimated"
-          ? locale === "pt-BR" ? "Estimada por tokens" : "Token-estimated"
+          ? locale === "pt-BR"
+            ? "Estimada por tokens"
+            : "Token-estimated"
           : value === "legacy_inferred"
-            ? locale === "pt-BR" ? "Inferida histórica" : "Legacy inferred"
+            ? locale === "pt-BR"
+              ? "Inferida histórica"
+              : "Legacy inferred"
             : "—";
   return (
     <>
@@ -351,7 +361,9 @@ export function RunTable({
             render: (row) => (
               <>
                 <strong>{displayedRunAgent(row)}</strong>
-                <small>{[row.agent_persona, row.agent_job].filter(Boolean).join(" · ") || "—"}</small>
+                <small>
+                  {[row.agent_persona, row.agent_job].filter(Boolean).join(" · ") || "—"}
+                </small>
               </>
             ),
           },
@@ -384,7 +396,7 @@ export function RunTable({
                   ? locale === "pt-BR"
                     ? "Em andamento"
                     : "In progress"
-                : provenance(row.duration_provenance);
+                  : provenance(row.duration_provenance);
             },
           },
           {
@@ -462,7 +474,8 @@ export function RunTable({
           {
             key: "context_multiplier",
             label: locale === "pt-BR" ? "Mult. contexto E/S" : "Context mult. I/O",
-            render: (row) => `${multiplier(row.context_input_multiplier)} / ${multiplier(row.context_output_multiplier)}`,
+            render: (row) =>
+              `${multiplier(row.context_input_multiplier)} / ${multiplier(row.context_output_multiplier)}`,
           },
           {
             key: "speed_multiplier",
@@ -477,7 +490,7 @@ export function RunTable({
                 ? locale === "pt-BR"
                   ? "Standard (contexto longo)"
                   : "Standard (long context)"
-                : row.pricing_scenario ?? "—",
+                : (row.pricing_scenario ?? "—"),
           },
           {
             key: "input_cost",
@@ -521,7 +534,12 @@ export function RunTable({
             render: (row) => usd(row.cost_variance_usd),
             align: "right",
           },
-          { key: "fx_rate", label: "USD/BRL", render: (row) => number(row.fx_rate), align: "right" },
+          {
+            key: "fx_rate",
+            label: "USD/BRL",
+            render: (row) => number(row.fx_rate),
+            align: "right",
+          },
           {
             key: "cost",
             label: locale === "pt-BR" ? "Custo total BRL" : "Total cost BRL",
@@ -608,7 +626,9 @@ export function ConversationTable({
               {
                 durationMs: row.duration_ms,
                 provenance:
-                  row.duration_ms === null && row.status === "running" ? "in_progress" : row.duration_provenance,
+                  row.duration_ms === null && row.status === "running"
+                    ? "in_progress"
+                    : row.duration_provenance,
               },
               locale,
             ),

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

@@ -9,6 +9,7 @@ import {
 } from "./EntityTables.js";
 import { OperationsEntityPager } from "./OperationsPageNavigation.js";
 import type { OperationsView } from "./operations-page-filters.js";
+import { PagedWorkList, type PagedWorkListRow } from "./PagedWorkList.js";
 import { PeriodSummaryTable } from "./PeriodSummaryTable.js";
 import type { OperationsLocale } from "./status-labels.js";
 import { UnifiedWorkBoard } from "./UnifiedWorkBoard.js";
@@ -43,6 +44,7 @@ export interface OperationsMainContentProps {
   onEntityPageChange?: ((offset: number) => void) | undefined;
   onLoadMoreBoard?: ((stage: WorkStage) => void) | undefined;
   onWorkListTypeChange?: ((kind: WorkTypeFilter) => void) | undefined;
+  onWorkListPageChange?: ((offset: number) => void) | undefined;
   onOpenDocument: WorkBoardProps["onOpenDocument"];
   onOpenTask: WorkBoardProps["onOpenTask"];
   onPriorityChange: WorkBoardProps["onPriorityChange"];
@@ -52,6 +54,18 @@ export interface OperationsMainContentProps {
   specs: WorkBoardProps["specs"];
   summaryPopulation: ComponentProps<typeof PeriodSummaryTable>["data"];
   tasks: WorkBoardProps["tasks"];
+  workListPage?:
+    | {
+        offset: number;
+        limit: number;
+        total: number | null;
+        hasMore: boolean;
+        typeFilter: WorkTypeFilter;
+        rows: readonly PagedWorkListRow[];
+        loading: boolean;
+        error: string | null;
+      }
+    | undefined;
   view: OperationsView;
 }
 
@@ -73,6 +87,7 @@ export function OperationsMainContent({
   onEntityPageChange,
   onLoadMoreBoard,
   onWorkListTypeChange,
+  onWorkListPageChange,
   onOpenDocument,
   onOpenTask,
   onPriorityChange,
@@ -82,6 +97,7 @@ export function OperationsMainContent({
   specs,
   summaryPopulation,
   tasks,
+  workListPage,
   view,
 }: OperationsMainContentProps) {
   return (
@@ -108,19 +124,29 @@ export function OperationsMainContent({
         />
       ) : null}
       {view === "work-list" ? (
-        <UnifiedWorkList
-          allSpecs={data.specs}
-          allTasks={data.tasks}
-          changes={data.changes}
-          locale={locale}
-          onOpenDocument={onOpenDocument}
-          onOpenTask={onOpenTask}
-          prds={prds}
-          runs={data.runs}
-          specs={specs}
-          tasks={tasks}
-          onTypeChange={onWorkListTypeChange}
-        />
+        workListPage ? (
+          <PagedWorkList
+            loading={workListPage.loading}
+            locale={locale}
+            onPageChange={(offset) => onWorkListPageChange?.(offset)}
+            onTypeChange={(kind) => onWorkListTypeChange?.(kind)}
+            page={workListPage}
+          />
+        ) : (
+          <UnifiedWorkList
+            allSpecs={data.specs}
+            allTasks={data.tasks}
+            changes={data.changes}
+            locale={locale}
+            onOpenDocument={onOpenDocument}
+            onOpenTask={onOpenTask}
+            prds={prds}
+            runs={data.runs}
+            specs={specs}
+            tasks={tasks}
+            onTypeChange={onWorkListTypeChange}
+          />
+        )
       ) : null}
       {view === "changes" ? <ChangeTable locale={locale} rows={changes} /> : null}
       {view === "executions" ? (

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

@@ -36,6 +36,13 @@ export function averageObserved(values: readonly (number | null)[]): number | nu
     : observed.reduce((total, value) => total + value, 0) / observed.length;
 }
 
+export function sumKnownOverviewMetric(values: readonly (number | null)[]): number | null {
+  return values.reduce<number | null>(
+    (total, value) => (value === null ? total : (total ?? 0) + value),
+    null,
+  );
+}
+
 export function overviewMetricAverages(
   totals: { durationMs: number | null; tokens: number | null; costBrl: number | null },
   selectedCount: number | null,
@@ -50,6 +57,13 @@ export function overviewMetricAverages(
   };
 }
 
+export function taskMetricAverages(
+  totals: { durationMs: number | null; tokens: number | null; costBrl: number | null },
+  taskCount: number | null,
+) {
+  return overviewMetricAverages(totals, taskCount);
+}
+
 export function findLatestTaskCreatedAt(
   tasks: readonly Pick<OperationsProjection["tasks"][number], "created_at">[],
 ): string | null {
@@ -298,7 +312,13 @@ export interface EntityMetric {
   id: string;
   title: string;
   durationMs: number | null;
-  durationProvenance?: "observed" | "reconciled" | "legacy_inferred" | "estimated" | "unavailable";
+  durationProvenance?:
+    | "observed"
+    | "reconciled"
+    | "legacy_inferred"
+    | "shared_creation_allocation"
+    | "estimated"
+    | "unavailable";
   durationEligible?: number | null;
   durationKnown?: number | null;
   tokens: number | null;
@@ -306,6 +326,90 @@ export interface EntityMetric {
   runCount: number;
 }
 
+type OverviewView = "tasks" | "specs" | "prds";
+
+export function selectedOverviewCount(
+  view: OverviewView,
+  overviewMetrics: OperationsProjection["summary"]["overview_metrics"] | undefined,
+  fallback: number,
+): number | null {
+  if (view === "specs") return overviewMetrics?.selected_counts?.specs ?? fallback;
+  if (view === "prds") return overviewMetrics?.selected_counts?.prds ?? fallback;
+  return overviewMetrics?.task_count ?? fallback;
+}
+
+export function selectedMacroMetricTotals(entityMetrics: readonly EntityMetric[]) {
+  return {
+    durationMs: sumKnownOverviewMetric(entityMetrics.map((entity) => entity.durationMs)),
+    tokens: sumKnownOverviewMetric(entityMetrics.map((entity) => entity.tokens)),
+    costBrl: sumKnownOverviewMetric(entityMetrics.map((entity) => entity.costBrl)),
+  };
+}
+
+export function scopedOverviewMetric(
+  view: OverviewView,
+  macroValue: number | null | undefined,
+  taskValue: number | null,
+): number | null {
+  return view === "tasks" ? taskValue : (macroValue ?? null);
+}
+
+export function canonicalMacroMetric(
+  hasCanonicalAggregate: boolean,
+  canonicalValue: number | null | undefined,
+  fallbackValue: number | null,
+): number | null {
+  return hasCanonicalAggregate ? (canonicalValue ?? null) : fallbackValue;
+}
+
+/** Selects currency totals without treating Operations' BRL aggregate as USD. */
+export function resolveOverviewCostTotal({
+  currency,
+  factualSnapshotTotal,
+  macroCostTotal,
+  overviewView,
+  resolvedRunTotal,
+  operationsBrlTotal,
+}: {
+  currency: "BRL" | "USD";
+  factualSnapshotTotal: number | null | undefined;
+  macroCostTotal?: number | null | undefined;
+  overviewView?: OverviewView;
+  resolvedRunTotal: number | null;
+  operationsBrlTotal: number | null;
+}): number | null {
+  if (overviewView !== undefined && overviewView !== "tasks") return macroCostTotal ?? null;
+  if (factualSnapshotTotal !== null && factualSnapshotTotal !== undefined)
+    return factualSnapshotTotal;
+  if (resolvedRunTotal !== null) return resolvedRunTotal;
+  return currency === "BRL" ? operationsBrlTotal : null;
+}
+
+export function partialOverviewMetrics(data: OperationsProjection) {
+  return data.summary.overview_metrics;
+}
+
+export function runsForOverviewView(
+  view: OverviewView,
+  tasks: OperationsProjection["tasks"],
+  macros: OperationsProjection["specs"] | OperationsProjection["prds"],
+  runs: OperationsProjection["runs"],
+): OperationsProjection["runs"] {
+  if (view === "tasks") {
+    const taskIds = new Set(tasks.map((task) => task.id));
+    return runs.filter((run) => run.task_id !== null && taskIds.has(run.task_id));
+  }
+  const macroIds = new Set(macros.map((macro) => macro.id));
+  const declaredRunIds = new Set(macros.flatMap((macro) => macro.run_ids));
+  return runs.filter(
+    (run) =>
+      declaredRunIds.has(run.id) ||
+      (view === "specs"
+        ? run.spec_id !== null && macroIds.has(run.spec_id)
+        : run.prd_id !== null && macroIds.has(run.prd_id)),
+  );
+}
+
 export function summarizeTopTaskMetrics(
   topTasks: readonly { id: string; durationMs: number | null }[],
   runs: readonly {
@@ -416,9 +520,10 @@ export function overviewText(locale: OperationsLocale) {
   } as const;
 }
 
-export function countExecutionDays(runs: readonly { started_at: string }[]): number {
+export function countExecutionDays(runs: readonly { started_at?: string }[]): number {
   const days = new Set<string>();
   for (const run of runs) {
+    if (run.started_at === undefined) continue;
     const date = new Date(run.started_at);
     if (Number.isNaN(date.getTime())) continue;
     days.add(`${date.getFullYear()}-${date.getMonth()}-${date.getDate()}`);