@zaip-ai/cli 4.8.0 → 5.0.0

package/templates/.agents/dashboard/modules/operations/src/contracts.ts

@@ -355,11 +355,18 @@ export interface RunProjection {
   artifact_path: string;
   status: "running" | "completed" | "failed" | "cancelled";
   phase: string;
-  entrypoint: "conversation" | "task" | "spec" | "prd";
+  entrypoint: "observation" | "conversation" | "task" | "spec" | "prd";
   work_type: "new" | "rework";
   run_role: "intake" | "orchestrator" | "subagent";
   run_kind: "run" | "subrun";
-  run_purpose: "intake" | "orchestration" | "execution" | "review" | "audit" | "finalization";
+  run_purpose:
+    | "observation"
+    | "intake"
+    | "orchestration"
+    | "execution"
+    | "review"
+    | "audit"
+    | "finalization";
   requires_finalizer: boolean;
   parent_run_id: string | null;
   client: string;
@@ -378,7 +385,7 @@ export interface RunProjection {
   terminal_call_count: number | null;
   failed_call_count: number | null;
   cancelled_call_count: number | null;
-  conversation_id: string;
+  conversation_id: string | null;
   client_thread_id?: string | null;
   client_turn_id?: string | null;
   is_active?: boolean;
@@ -600,16 +607,4 @@ export interface TaskDetailProjection {
   artifact_path: string;
 }
 
-export interface PrdDetailProjection {
-  id: string;
-  title: string;
-  body: string;
-  artifact_path: string;
-}
-
-export interface SpecDetailProjection {
-  id: string;
-  title: string;
-  body: string;
-  artifact_path: string;
-}
+export type { PrdDetailProjection, SpecDetailProjection } from "./planning-contracts.js";

package/templates/.agents/dashboard/modules/operations/src/planning-contracts.ts

@@ -0,0 +1,14 @@
+/** Canonical detail payloads for PRD and SPEC drilldowns. */
+export interface PrdDetailProjection {
+  id: string;
+  title: string;
+  body: string;
+  artifact_path: string;
+}
+
+export interface SpecDetailProjection {
+  id: string;
+  title: string;
+  body: string;
+  artifact_path: string;
+}

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

@@ -0,0 +1,65 @@
+import { DataTable, formatDateTime } from "@zaip-ai/dashboard-ui";
+import { useState } from "react";
+import type { DecisionProjection } from "../contracts.js";
+import { EntityDetailsDialog } from "./EntityDetailsDialog.js";
+import { DecisionOriginBadge, DecisionStageBadge } from "./EntityTableBadges.js";
+import type { OperationsLocale } from "./status-labels.js";
+import { sortByDateDesc } from "./table-order.js";
+
+export function DecisionTable({
+  rows,
+  locale,
+}: {
+  rows: readonly DecisionProjection[];
+  locale: OperationsLocale;
+}) {
+  const [selected, setSelected] = useState<DecisionProjection | null>(null);
+  const orderedRows = sortByDateDesc(rows, (row) => row.created_at);
+  return (
+    <>
+      <DataTable
+        columns={[
+          {
+            key: "date",
+            label: "Data de criação",
+            render: (row) => formatDateTime(row.created_at),
+          },
+          {
+            key: "title",
+            label: "Decisão",
+            render: (row) => (
+              <>
+                <strong>{row.title}</strong>
+                <small>{row.id}</small>
+              </>
+            ),
+          },
+          {
+            key: "origin",
+            label: "Origem",
+            render: (row) => <DecisionOriginBadge origin={row.origin} />,
+          },
+          {
+            key: "stage",
+            label: "Fase",
+            render: (row) => <DecisionStageBadge scopeType={row.scope_type} />,
+          },
+          { key: "scope", label: "Escopo", render: (row) => `${row.scope_type}: ${row.scope_id}` },
+        ]}
+        locale={locale}
+        rowKey={(row) => row.id}
+        onRowClick={setSelected}
+        rows={orderedRows}
+        showColumnInfo
+        sortable
+      />
+      {selected ? (
+        <EntityDetailsDialog
+          details={{ kind: "decision", row: selected }}
+          locale={locale}
+          onClose={() => setSelected(null)}
+        />
+      ) : null}
+    </>
+  );
+}

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

@@ -5,12 +5,7 @@ import {
   formatDateTime,
 } from "@zaip-ai/dashboard-ui";
 import { useState } from "react";
-import type {
-  ChangeProjection,
-  DecisionProjection,
-  ExecutionProjection,
-  RunProjection,
-} from "../contracts.js";
+import type { ChangeProjection, ExecutionProjection, RunProjection } from "../contracts.js";
 import { buildConversationRows } from "./conversation-rows.js";
 import { EntityDetailsDialog } from "./EntityDetailsDialog.js";
 import { displayedDuration, formatDisplayedDuration } from "./operation-duration.js";
@@ -569,6 +564,7 @@ function runPurposeLabel(purpose: RunProjection["run_purpose"], locale: Operatio
     review: "Revisão",
     audit: "Auditoria",
     finalization: "Finalização",
+    observation: "Observação",
   }[purpose];
 }
 
@@ -701,7 +697,7 @@ export function canBuildCanonicalConversationRows(
         } => execution.kind === "interaction" && execution.origin.type === "interaction",
       )
       .every((execution) => execution.origin.conversation_id.trim().length > 0) &&
-    rows.every((row) => row.id.trim().length > 0 && row.conversation_id.trim().length > 0)
+    rows.every((row) => row.id.trim().length > 0 && (row.conversation_id?.trim().length ?? 0) > 0)
   );
 }
 
@@ -721,68 +717,6 @@ function CanonicalEntityLoadingState({
   );
 }
 
-export function DecisionTable({
-  rows,
-  locale,
-}: {
-  rows: readonly DecisionProjection[];
-  locale: OperationsLocale;
-}) {
-  const [selected, setSelected] = useState<DecisionProjection | null>(null);
-  const orderedRows = sortByDateDesc(rows, (row) => row.created_at);
-  return (
-    <>
-      <DataTable
-        columns={[
-          {
-            key: "date",
-            label: "Data de criação",
-            render: (row) => formatDateTime(row.created_at),
-          },
-          {
-            key: "title",
-            label: "Decisão",
-            render: (row) => (
-              <>
-                <strong>{row.title}</strong>
-                <small>{row.id}</small>
-              </>
-            ),
-          },
-          {
-            key: "origin",
-            label: "Origem",
-            render: (row) => <DecisionOriginBadge origin={row.origin} />,
-          },
-          {
-            key: "stage",
-            label: "Fase",
-            render: (row) => <DecisionStageBadge scopeType={row.scope_type} />,
-          },
-          { key: "scope", label: "Escopo", render: (row) => `${row.scope_type}: ${row.scope_id}` },
-        ]}
-        locale={locale}
-        rowKey={(row) => row.id}
-        onRowClick={setSelected}
-        rows={orderedRows}
-        showColumnInfo
-        sortable
-      />
-      {selected ? (
-        <EntityDetailsDialog
-          details={{ kind: "decision", row: selected }}
-          locale={locale}
-          onClose={() => setSelected(null)}
-        />
-      ) : null}
-    </>
-  );
-}
+export { DecisionTable } from "./DecisionTable.js";
 
-import {
-  DecisionOriginBadge,
-  DecisionStageBadge,
-  EntryBadge,
-  RiskBadge,
-  StatusBadge,
-} from "./EntityTableBadges.js";
+import { EntryBadge, RiskBadge, StatusBadge } from "./EntityTableBadges.js";

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

@@ -20,6 +20,7 @@ import {
   workListTypeOnViewChange,
 } from "./operations-page-contract.js";
 import { useOperationFilterFeedback } from "./use-operation-filter-feedback.js";
+import { useOperationsFilterSync } from "./use-operations-filter-sync.js";
 
 export {
   type DashboardGlobalFilters,
@@ -179,43 +180,17 @@ export function OperationsPage({
     setRiskFilter("");
     setOriginFilter("");
   };
-  useEffect(() => {
-    // The parent replaces the aggregate snapshot while a period transition is
-    // loading. Defer paged entity hydration until that replacement is stable,
-    // otherwise the aggregate response can overwrite a newer entity page.
-    if (loading) return;
-    if (view === "work-kanban" || view === "work-list") {
-      const timeout = window.setTimeout(() => {
-        const filters = {
-          query,
-          status: statusFilter,
-          risk: riskFilter,
-          origin: originFilter,
-        };
-        if (view === "work-kanban") onBoardFiltersChange?.(filters);
-        else onWorkListFiltersChange?.(filters);
-      }, 180);
-      return () => window.clearTimeout(timeout);
-    }
-    if (!["runs", "conversations", "executions", "changes", "decisions"].includes(view)) return;
-    const timeout = window.setTimeout(() => {
-      onEntityFiltersChange?.(
-        view as "runs" | "conversations" | "executions" | "changes" | "decisions",
-        { query, status: statusFilter, risk: riskFilter },
-      );
-    }, 180);
-    return () => window.clearTimeout(timeout);
-  }, [
-    onBoardFiltersChange,
-    onWorkListFiltersChange,
-    onEntityFiltersChange,
+  useOperationsFilterSync({
     loading,
-    originFilter,
+    view,
     query,
-    riskFilter,
     statusFilter,
-    view,
-  ]);
+    riskFilter,
+    originFilter,
+    onBoardFiltersChange,
+    onWorkListFiltersChange,
+    onEntityFiltersChange,
+  });
   // Only work views interpret a status option as a canonical work stage.
   // Runs, Changes and Executions use their respective persisted statuses.
   const hasEntityStageStatus =
@@ -329,6 +304,7 @@ export function OperationsPage({
     (row) =>
       row.entrypoint === "conversation" &&
       row.task_id === null &&
+      row.conversation_id !== null &&
       conversationIds.has(row.conversation_id),
   );
   const decisions = data.decisions.filter(
@@ -756,5 +732,3 @@ export function OperationsPage({
     </main>
   );
 }
-
-/** Loading is never a valid zero-valued Operations projection. */

package/templates/.agents/dashboard/modules/operations/src/react/operations-overview-period-filter.test.ts

@@ -188,13 +188,18 @@ describe("overview period filter", () => {
 
   it("resets the real List navigation callback on re-entry without changing Kanban routing", () => {
     const source = readFileSync(new URL("OperationsPage.tsx", import.meta.url), "utf8");
+    const filterSync = readFileSync(
+      new URL("use-operations-filter-sync.ts", import.meta.url),
+      "utf8",
+    );
 
     expect(workListTypeOnViewChange("work-list")).toBe("all");
     expect(workListTypeOnViewChange("work-kanban")).toBeNull();
     expect(source).toContain("const nextWorkListType = workListTypeOnViewChange(nextView)");
     expect(source).toContain("onWorkListTypeChange?.(nextWorkListType)");
-    expect(source).toContain('if (view === "work-kanban") onBoardFiltersChange?.(filters)');
-    expect(source).toContain("else onWorkListFiltersChange?.(filters)");
+    expect(source).toContain("useOperationsFilterSync({");
+    expect(filterSync).toContain('if (view === "work-kanban") onBoardFiltersChange?.(filters)');
+    expect(filterSync).toContain("else onWorkListFiltersChange?.(filters)");
   });
 
   it("scopes task and macro metrics to the active overview entity kind", () => {

package/templates/.agents/dashboard/modules/operations/src/react/use-operations-filter-sync.ts

@@ -0,0 +1,66 @@
+import { useEffect } from "react";
+import type { OperationsPageProps } from "./operations-page-contract.js";
+import type { OperationsView } from "./operations-page-filters.js";
+import type { TaskOrigin } from "./task-origin.js";
+
+interface OperationsFilterSyncInput {
+  loading: boolean;
+  view: OperationsView;
+  query: string;
+  statusFilter: string;
+  riskFilter: string;
+  originFilter: TaskOrigin | "";
+  onBoardFiltersChange: OperationsPageProps["onBoardFiltersChange"];
+  onWorkListFiltersChange: OperationsPageProps["onWorkListFiltersChange"];
+  onEntityFiltersChange: OperationsPageProps["onEntityFiltersChange"];
+}
+
+export function useOperationsFilterSync({
+  loading,
+  view,
+  query,
+  statusFilter,
+  riskFilter,
+  originFilter,
+  onBoardFiltersChange,
+  onWorkListFiltersChange,
+  onEntityFiltersChange,
+}: OperationsFilterSyncInput): void {
+  useEffect(() => {
+    // The parent replaces the aggregate snapshot while a period transition is
+    // loading. Defer paged entity hydration until that replacement is stable,
+    // otherwise the aggregate response can overwrite a newer entity page.
+    if (loading) return;
+    if (view === "work-kanban" || view === "work-list") {
+      const timeout = window.setTimeout(() => {
+        const filters = {
+          query,
+          status: statusFilter,
+          risk: riskFilter,
+          origin: originFilter,
+        };
+        if (view === "work-kanban") onBoardFiltersChange?.(filters);
+        else onWorkListFiltersChange?.(filters);
+      }, 180);
+      return () => window.clearTimeout(timeout);
+    }
+    if (!["runs", "conversations", "executions", "changes", "decisions"].includes(view)) return;
+    const timeout = window.setTimeout(() => {
+      onEntityFiltersChange?.(
+        view as "runs" | "conversations" | "executions" | "changes" | "decisions",
+        { query, status: statusFilter, risk: riskFilter },
+      );
+    }, 180);
+    return () => window.clearTimeout(timeout);
+  }, [
+    onBoardFiltersChange,
+    onWorkListFiltersChange,
+    onEntityFiltersChange,
+    loading,
+    originFilter,
+    query,
+    riskFilter,
+    statusFilter,
+    view,
+  ]);
+}

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

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/dashboard-traceability",
-  "version": "4.8.0",
+  "version": "5.0.0",
   "private": true,
   "type": "module",
   "exports": {

package/templates/.agents/dashboard/packages/branding/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/dashboard-branding",
-  "version": "4.8.0",
+  "version": "5.0.0",
   "private": true,
   "type": "module",
   "exports": {

package/templates/.agents/dashboard/packages/contracts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/dashboard-contracts",
-  "version": "4.8.0",
+  "version": "5.0.0",
   "private": true,
   "type": "module",
   "exports": {

package/templates/.agents/dashboard/packages/data-export/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/dashboard-data-export",
-  "version": "4.8.0",
+  "version": "5.0.0",
   "private": true,
   "type": "module",
   "exports": {