@zaip-ai/cli 5.0.0 → 5.1.0

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

@@ -25,6 +25,7 @@ export function OperationsPageOverview({
   locale,
   onOpenTask,
   onOpenDocument,
+  onOpenMacro,
   onLoadStatus,
   statusPage,
   onLoadStatusPage,
@@ -55,6 +56,7 @@ export function OperationsPageOverview({
   locale: OperationsLocale;
   onOpenTask: OverviewProps["onOpenTask"];
   onOpenDocument: OverviewProps["onOpenDocument"];
+  onOpenMacro: OverviewProps["onOpenMacro"];
   onLoadStatus: OverviewProps["onLoadStatus"];
   statusPage: OverviewProps["statusPage"];
   onLoadStatusPage: OverviewProps["onLoadStatusPage"];
@@ -96,6 +98,7 @@ export function OperationsPageOverview({
         }}
         onOpenTask={onOpenTask}
         onOpenDocument={onOpenDocument}
+        onOpenMacro={onOpenMacro}
         onLoadStatus={onLoadStatus}
         statusPage={statusPage}
         onLoadStatusPage={onLoadStatusPage}

package/templates/.agents/dashboard/modules/operations/src/react/operations-overview-contract.ts

@@ -0,0 +1,51 @@
+import type { OperationsProjection } from "../contracts.js";
+import type { OperationDatePreset, OperationDateRange } from "./operation-date-range.js";
+import type {
+  FactualCostFact,
+  OverviewClassification,
+  OverviewClassificationPage,
+  OverviewStatusKind,
+  OverviewStatusPage,
+} from "./operations-page-contract.js";
+import type { OperationsLocale } from "./status-labels.js";
+import type { WorkStage } from "./work-board-model.js";
+export interface OperationsOverviewProps {
+  currency: "BRL" | "USD";
+  data: OperationsProjection;
+  /** App-controlled range paired with datePreset; retained by Page while loading. */
+  dateRange?: OperationDateRange;
+  datePreset: OperationDatePreset;
+  locale: OperationsLocale;
+  onDatePresetChange: (preset: OperationDatePreset) => void;
+  onOpenTask: (taskId: string) => Promise<boolean>;
+  onOpenDocument: (kind: "prd" | "spec", id: string) => void;
+  onOpenMacro: (kind: "prd" | "spec", id: string) => void;
+  onLoadStatus?: ((stage: WorkStage, kind: OverviewStatusKind, offset: number) => void) | undefined;
+  statusPage?:
+    | ((stage: WorkStage, kind: OverviewStatusKind) => OverviewStatusPage | undefined)
+    | undefined;
+  onLoadStatusPage?:
+    | ((stage: WorkStage, kind: OverviewStatusKind, offset: number) => void)
+    | undefined;
+  classificationPage?:
+    | ((
+        kind: OverviewStatusKind,
+        classification: OverviewClassification,
+      ) => OverviewClassificationPage | undefined)
+    | undefined;
+  onLoadClassificationPage?:
+    | ((kind: OverviewStatusKind, classification: OverviewClassification, offset: number) => void)
+    | undefined;
+  onLoadMacroMetrics?: (() => void) | undefined;
+  prds?: OperationsProjection["prds"];
+  runs?: OperationsProjection["runs"];
+  specs?: OperationsProjection["specs"];
+  tasks?: OperationsProjection["tasks"];
+  /** Factual Cost Monitor snapshot total for the selected locale/currency. */
+  factualCostTotal?: number | null | undefined;
+  /** Measurement completeness for the matching Cost Monitor snapshot. */
+  factualCostFact?: FactualCostFact | undefined;
+  costLoading?: boolean | undefined;
+  resolveRunCost?: ((runId: string) => number | null) | undefined;
+  includeLegacyEffort?: boolean;
+}

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

@@ -118,7 +118,11 @@ describe("overview period filter", () => {
     const periods = readFileSync(new URL("PeriodSummaryTable.tsx", import.meta.url), "utf8");
     const costCard = readFileSync(new URL("OverviewCostKpi.tsx", import.meta.url), "utf8");
 
-    expect(source).toContain('currency: "BRL" | "USD"');
+    const contract = readFileSync(
+      new URL("operations-overview-contract.ts", import.meta.url),
+      "utf8",
+    );
+    expect(contract).toContain('currency: "BRL" | "USD"');
     expect(source).toContain("const selectedCurrencyCost =");
     expect(source).toContain("formatCurrency(value, currency, locale)");
     expect(source).toContain("<OverviewCostKpi");

package/templates/.agents/dashboard/modules/operations/src/react/operations-page-contract.ts

@@ -103,6 +103,7 @@ export interface OperationsPageProps {
   locale: OperationsLocale;
   onLocaleChange: (locale: OperationsLocale) => void;
   onOpenDocument: (kind: "prd" | "spec", id: string) => void;
+  onOpenMacro: (kind: "prd" | "spec", id: string) => void;
   onOpenTask: (taskId: string) => Promise<boolean>;
   onPriorityChange: (itemIds: readonly string[]) => Promise<void>;
   onDetailDataRequest?: (view: OperationsView) => void;

package/templates/.agents/dashboard/modules/operations/src/react/use-operations-default-range.ts

@@ -0,0 +1,16 @@
+import { useMemo } from "react";
+import { factualCostDateRange, initialOperationsDateRange } from "./operation-date-range.js";
+import type { OperationsPageProps } from "./operations-page-contract.js";
+export function useOperationsDefaultRange(
+  data: OperationsPageProps["data"],
+  factualCostPeriods: OperationsPageProps["factualCostPeriods"],
+) {
+  const defaultDateRange = useMemo(() => {
+    const operationsRange = initialOperationsDateRange(
+      data.tasks,
+      Object.keys(data.summary.periods?.daily ?? {}),
+    );
+    return factualCostDateRange(factualCostPeriods?.day, operationsRange);
+  }, [data.summary.periods, data.tasks, factualCostPeriods?.day]);
+  return defaultDateRange;
+}

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

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

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

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

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

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/dashboard-contracts",
-  "version": "5.0.0",
+  "version": "5.1.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": "5.0.0",
+  "version": "5.1.0",
   "private": true,
   "type": "module",
   "exports": {

package/templates/.agents/dashboard/packages/local-runtime/dashboard-build-fingerprint.mjs

@@ -0,0 +1,87 @@
+import { createHash } from "node:crypto";
+import { mkdir, readdir, readFile, rename, stat, writeFile } from "node:fs/promises";
+import { dirname, join, relative, resolve } from "node:path";
+import { dashboardBuildTargets, workspaceRoot } from "./start-dashboard-paths.mjs";
+
+export async function contentFingerprint(paths, excluded = [], root = workspaceRoot) {
+  const entries = new Map();
+  async function visit(path) {
+    const key = relative(root, path).replaceAll("\\", "/");
+    const name = path.replaceAll("\\", "/").split("/").at(-1);
+    if (
+      ["node_modules", ".turbo"].includes(name) ||
+      /\.(test|spec)\./.test(name) ||
+      excluded.some((part) => `/${key}/`.includes(part))
+    )
+      return;
+    const details = await stat(path).catch((error) => {
+      if (error.code === "ENOENT") return null;
+      throw error;
+    });
+    if (!details) {
+      entries.set(key, "missing");
+      return;
+    }
+    if (details.isDirectory()) {
+      entries.set(`${key}/`, "directory");
+      for (const entry of await readdir(path)) await visit(join(path, entry));
+    } else
+      entries.set(
+        key,
+        createHash("sha256")
+          .update(await readFile(path))
+          .digest("hex"),
+      );
+  }
+  for (const path of paths) await visit(path);
+  return createHash("sha256")
+    .update(JSON.stringify([...entries].sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))))
+    .digest("hex");
+}
+
+const receiptPath = (name, root) => resolve(root, ".local/dashboard-build", `${name}.json`);
+export const sourceFingerprint = (target, root = workspaceRoot) =>
+  contentFingerprint(target.sourceRoots, ["/dist/", ...target.excludedSourcePaths], root);
+const outputFingerprint = (target, root) =>
+  contentFingerprint(target.outputRoots ?? target.artifacts, [], root);
+
+export async function inspectBuildFingerprint(name, target, root = workspaceRoot) {
+  const receipt = await readFile(receiptPath(name, root), "utf8")
+    .then(JSON.parse)
+    .catch(() => null);
+  if (receipt?.version !== 1) return false;
+  return (
+    receipt.source === (await sourceFingerprint(target, root)) &&
+    receipt.output === (await outputFingerprint(target, root))
+  );
+}
+
+export async function recordDashboardBuild(
+  name,
+  before,
+  target = dashboardBuildTargets[name],
+  root = workspaceRoot,
+) {
+  const source = await sourceFingerprint(target, root);
+  if (source !== before)
+    throw new Error(
+      `Dashboard ${name} inputs changed during build; no reusable receipt was recorded`,
+    );
+  for (const path of target.artifacts) await stat(path);
+  const receipt = { version: 1, source, output: await outputFingerprint(target, root) };
+  const path = receiptPath(name, root);
+  await mkdir(dirname(path), { recursive: true });
+  const temporary = `${path}.${process.pid}.tmp`;
+  await writeFile(temporary, `${JSON.stringify(receipt)}\n`);
+  await rename(temporary, path);
+}
+
+export async function dashboardReleaseFrozen(root = workspaceRoot) {
+  const text = await readFile(resolve(root, ".agents/config/release-cycle.json"), "utf8").catch(
+    (error) => {
+      if (error.code === "ENOENT") return null;
+      throw error;
+    },
+  );
+  return text !== null && JSON.parse(text).state === "frozen";
+}

package/templates/.agents/dashboard/packages/local-runtime/dashboard-build-fingerprint.test.mjs

@@ -0,0 +1,48 @@
+import assert from "node:assert/strict";
+import { mkdir, mkdtemp, rm, utimes, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { test } from "vitest";
+import {
+  inspectBuildFingerprint,
+  recordDashboardBuild,
+  sourceFingerprint,
+} from "./dashboard-build-fingerprint.mjs";
+import { refreshDashboardBuildTargets } from "./start-dashboard-build.mjs";
+
+test("build reuse follows bytes, includes missing/deleted inputs, and freezes without mutation", async (context) => {
+  const root = await mkdtemp(join(tmpdir(), "zaip-build-fingerprint-"));
+  context.onTestFinished(() => rm(root, { recursive: true, force: true }));
+  await mkdir(join(root, "src"));
+  const source = join(root, "src/readme.md"),
+    output = join(root, "bundle.js");
+  await writeFile(source, "help");
+  await writeFile(output, "bundle");
+  const target = { sourceRoots: [join(root, "src")], excludedSourcePaths: [], artifacts: [output] };
+  await recordDashboardBuild("fixture", await sourceFingerprint(target, root), target, root);
+  await utimes(source, new Date(), new Date(Date.now() + 60_000));
+  assert.equal(await inspectBuildFingerprint("fixture", target, root), true);
+  await writeFile(source, "new help");
+  assert.equal(await inspectBuildFingerprint("fixture", target, root), false);
+  const before = await sourceFingerprint(target, root);
+  await rm(source);
+  await assert.rejects(
+    recordDashboardBuild("fixture", before, target, root),
+    /changed during build/,
+  );
+  let builds = 0;
+  await assert.rejects(
+    refreshDashboardBuildTargets({
+      targets: { fixture: target },
+      frozen: true,
+      inspectTarget: async () => ({
+        missingArtifacts: [],
+        artifactsModifiedAt: 1,
+        sourcesModifiedAt: 2,
+      }),
+      runBuild: async () => builds++,
+    }),
+    /release is frozen/,
+  );
+  assert.equal(builds, 0);
+});

package/templates/.agents/dashboard/packages/local-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/dashboard-local-runtime",
-  "version": "5.0.0",
+  "version": "5.1.0",
   "private": true,
   "type": "module",
   "scripts": {

package/templates/.agents/dashboard/packages/local-runtime/scripts/build-frontend.mjs

@@ -0,0 +1,29 @@
+import { spawnSync } from "node:child_process";
+import { resolve } from "node:path";
+import { recordDashboardBuild, sourceFingerprint } from "../dashboard-build-fingerprint.mjs";
+import { dashboardBuildTargets, workspaceRoot } from "../start-dashboard-paths.mjs";
+
+const before = await sourceFingerprint(dashboardBuildTargets.frontend);
+const result = spawnSync(
+  process.execPath,
+  [resolve(workspaceRoot, "node_modules/vite/bin/vite.js"), "build"],
+  {
+    cwd: resolve(workspaceRoot, ".agents/dashboard/apps/frontend"),
+    windowsHide: true,
+    stdio: "inherit",
+  },
+);
+if (result.error) throw result.error;
+if (result.status !== 0) process.exit(result.status ?? 1);
+const normalized = spawnSync(
+  process.execPath,
+  [resolve(workspaceRoot, "scripts/normalize-generated-text.mjs"), "dist"],
+  {
+    cwd: resolve(workspaceRoot, ".agents/dashboard/apps/frontend"),
+    windowsHide: true,
+    stdio: "inherit",
+  },
+);
+if (normalized.error) throw normalized.error;
+if (normalized.status !== 0) process.exit(normalized.status ?? 1);
+await recordDashboardBuild("frontend", before);

package/templates/.agents/dashboard/packages/local-runtime/scripts/build-sqlite-runtime.mjs

@@ -2,6 +2,10 @@ import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
 import { createRequire } from "node:module";
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
+import { recordDashboardBuild, sourceFingerprint } from "../dashboard-build-fingerprint.mjs";
+import { dashboardBuildTargets } from "../start-dashboard-paths.mjs";
+
+const inputsBeforeBuild = await sourceFingerprint(dashboardBuildTargets.runtime);
 
 const root = resolve(import.meta.dirname, "../../../../..");
 const packageRoot = resolve(root, ".agents/dashboard/packages/local-runtime");
@@ -117,4 +121,5 @@ if (process.env.ZAIP_RUNTIME_METAFILE === "1") {
     "utf8",
   );
 }
+await recordDashboardBuild("runtime", inputsBeforeBuild);
 process.stdout.write("SQLite dashboard runtime rebuilt.\n");

package/templates/.agents/dashboard/packages/local-runtime/start-dashboard-build.mjs

@@ -3,6 +3,7 @@ import { createHash } from "node:crypto";
 import { readdir, stat } from "node:fs/promises";
 import { join, resolve } from "node:path";
 import process from "node:process";
+import { dashboardReleaseFrozen, inspectBuildFingerprint } from "./dashboard-build-fingerprint.mjs";
 import { formatLauncherError } from "./start-dashboard-logging.mjs";
 import {
   dashboardBuildTargets,
@@ -55,7 +56,7 @@ export async function runSqliteBuild(target) {
   const frontend = target === "frontend";
   const command = process.execPath;
   const args = frontend
-    ? [resolve(workspaceRoot, "node_modules/vite/bin/vite.js"), "build"]
+    ? [resolve(packageRoot, "scripts/build-frontend.mjs")]
     : [
         resolve(
           workspaceRoot,
@@ -110,6 +111,7 @@ export async function refreshDashboardBuildTargets({
   forceRebuild = process.env.ZAIP_DASHBOARD_FORCE_REBUILD === "1",
   inspectTarget = inspectDashboardBuildTarget,
   runBuild = runSqliteBuild,
+  frozen = undefined,
   onProgress = () => {},
 } = {}) {
   const builtTargets = [];
@@ -121,10 +123,11 @@ export async function refreshDashboardBuildTargets({
       "Conferindo somente as dependências que geram este artefato.",
     );
     const state = await inspectTarget(target);
-    const needsBuild =
-      forceRebuild ||
-      state.missingArtifacts.length > 0 ||
-      state.artifactsModifiedAt < state.sourcesModifiedAt;
+    const contentFresh =
+      inspectTarget === inspectDashboardBuildTarget
+        ? await inspectBuildFingerprint(name, target)
+        : state.artifactsModifiedAt >= state.sourcesModifiedAt;
+    const needsBuild = forceRebuild || state.missingArtifacts.length > 0 || !contentFresh;
     if (!needsBuild) {
       buildProgress(
         onProgress,
@@ -134,6 +137,10 @@ export async function refreshDashboardBuildTargets({
       );
       continue;
     }
+    if (frozen ?? (await dashboardReleaseFrozen()))
+      throw new Error(
+        `Dashboard ${name} needs an explicit build, but the release is frozen. Reopen the release before changing candidate artifacts.`,
+      );
     const reason = forceRebuild
       ? "A atualização foi solicitada explicitamente."
       : state.missingArtifacts.length > 0

package/templates/.agents/dashboard/packages/local-runtime/start-dashboard-paths.mjs

@@ -36,6 +36,7 @@ export const maxPortHistory = 50;
 export const dashboardBuildTargets = {
   frontend: {
     artifacts: [resolve(frontendRoot, "index.html")],
+    outputRoots: [frontendRoot],
     sourceRoots: [
       resolve(workspaceRoot, ".agents/dashboard/apps/frontend/src"),
       resolve(workspaceRoot, ".agents/dashboard/apps/frontend/public"),
@@ -54,6 +55,11 @@ export const dashboardBuildTargets = {
       resolve(workspaceRoot, "tsconfig.base.json"),
       resolve(workspaceRoot, "pnpm-lock.yaml"),
       resolve(workspaceRoot, "README.md"),
+      resolve(workspaceRoot, "README-ENG.md"),
+      resolve(workspaceRoot, ".agents/zaip-aios/guides"),
+      resolve(packageRoot, "scripts/build-frontend.mjs"),
+      resolve(packageRoot, "dashboard-build-fingerprint.mjs"),
+      resolve(packageRoot, "start-dashboard-paths.mjs"),
     ],
     excludedSourcePaths: ["/server/"],
   },
@@ -67,6 +73,8 @@ export const dashboardBuildTargets = {
     sourceRoots: [
       resolve(packageRoot, "src"),
       resolve(packageRoot, "scripts"),
+      resolve(packageRoot, "dashboard-build-fingerprint.mjs"),
+      resolve(packageRoot, "start-dashboard-paths.mjs"),
       resolve(packageRoot, "package.json"),
       resolve(packageRoot, "tsconfig.json"),
       resolve(workspaceRoot, ".agents/dashboard/modules/operations/src"),

package/templates/.agents/dashboard/packages/local-runtime/start-dashboard.test.mjs

@@ -198,6 +198,7 @@ describe("dashboard executable session", () => {
       const progress = [];
       const result = await refreshDashboardBuildTargets({
         targets,
+        frozen: false,
         forceRebuild,
         inspectTarget: async (target) => states[target.artifacts[0]],
         runBuild: async (target) => calls.push(target),

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

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

package/templates/.agents/dashboard/tests/e2e/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/dashboard-e2e",
-  "version": "5.0.0",
+  "version": "5.1.0",
   "private": true,
   "type": "module",
   "scripts": {

package/templates/.agents/dashboard/tests/e2e/qualify-top-five-trace.mjs

@@ -0,0 +1,53 @@
+import assert from "node:assert/strict";
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+
+const root = resolve(import.meta.dirname, "../../../..");
+assert.equal(resolve(process.cwd()), root);
+const mode = process.argv[2];
+assert.ok(["test", "check"].includes(mode));
+function run(args) {
+  const result = spawnSync(process.execPath, args, {
+    cwd: root,
+    windowsHide: true,
+    encoding: "utf8",
+    timeout: 240_000,
+    maxBuffer: 8 * 1024 * 1024,
+    env: { ...process.env, CI: "true" },
+  });
+  process.stdout.write(result.stdout ?? "");
+  process.stderr.write(result.stderr ?? "");
+  assert.equal(result.status, 0, result.error?.message);
+}
+if (!existsSync(join(root, "node_modules/.modules.yaml"))) {
+  const branch = spawnSync("git", ["symbolic-ref", "-q", "HEAD"], {
+    cwd: root,
+    windowsHide: true,
+    encoding: "utf8",
+    timeout: 10000,
+  });
+  assert.equal(branch.status, 1, "Only prepare dependencies in detached candidate");
+  const manager = join(dirname(process.execPath), "node_modules/corepack/dist/pnpm.js");
+  assert.ok(existsSync(manager));
+  run([manager, "install", "--offline", "--frozen-lockfile", "--ignore-scripts"]);
+}
+if (mode === "test") {
+  run([
+    "node_modules/vitest/vitest.mjs",
+    "run",
+    "--maxWorkers=1",
+    ".agents/dashboard/modules/operations/src/react/OperationsOverviewTopPanel.navigation.test.tsx",
+    ".agents/dashboard/modules/operations/src/react/OperationsOverview.test.ts",
+    ".agents/dashboard/modules/operations/src/react/OperationsOverview.macro-metrics.test.ts",
+    ".agents/dashboard/apps/frontend/src/use-app-trace-documents.navigation.test.tsx",
+    ".agents/dashboard/apps/frontend/src/operations-period-render.test.ts",
+  ]);
+} else {
+  for (const project of [
+    ".agents/dashboard/modules/operations/tsconfig.json",
+    ".agents/dashboard/apps/frontend/tsconfig.json",
+    ".agents/design/apps/catalog/tsconfig.json",
+  ])
+    run(["node_modules/typescript/bin/tsc", "--noEmit", "--project", project]);
+}

package/templates/.agents/dashboard/tests/e2e/verify-top-five-served.mjs

@@ -0,0 +1,78 @@
+import assert from "node:assert/strict";
+import { mkdir, writeFile } from "node:fs/promises";
+import { chromium, expect } from "@playwright/test";
+
+const baseUrl = process.env.ZAIP_TOP_FIVE_URL ?? "http://127.0.0.1:4417";
+assert.equal(new URL(baseUrl).hostname, "127.0.0.1", "Local dashboard only");
+const output = ".local/top-five-served";
+await mkdir(output, { recursive: true });
+const browser = await chromium.launch({ headless: true });
+try {
+  const page = await browser.newPage({ viewport: { width: 1440, height: 1000 } });
+  page.setDefaultTimeout(60_000);
+  const errors = [];
+  const responses = [];
+  page.on("pageerror", (error) => errors.push(error.message));
+  page.on("response", (response) => {
+    if (response.url().includes("/api/v2/operations") || response.url().includes("/trace"))
+      responses.push({ path: new URL(response.url()).pathname, status: response.status() });
+  });
+  await page.goto(baseUrl, { waitUntil: "domcontentloaded" });
+  await page.getByRole("heading", { name: "Top 5 tarefas", exact: true }).waitFor();
+  const bundles = await page
+    .locator('script[src],link[rel="modulepreload"]')
+    .evaluateAll((nodes) =>
+      nodes.map((node) => node.getAttribute("src") ?? node.getAttribute("href")),
+    );
+  const cases = [];
+  for (const [kind, buttonName, heading, index] of [
+    ["spec", /^SPECs/, "Top 5 SPECs", 0],
+    ["prd", /^PRDs/, "Top 5 PRDs", 0],
+    ["task", /^Tarefas/, "Top 5 tarefas", 0],
+    ["spec", /^SPECs/, "Top 5 SPECs", 1],
+  ]) {
+    await page.getByRole("button", { name: buttonName }).first().click();
+    const panel = page
+      .locator("article")
+      .filter({ has: page.getByRole("heading", { name: heading, exact: true }) });
+    await panel.waitFor();
+    const bar = panel.locator(".operations-run-bar").nth(index);
+    await expect(bar).toBeEnabled();
+    const accessibleName = await bar.getAttribute("aria-label");
+    const title = (await bar.getAttribute("title")).replace(/: [^:]+$/, "");
+    if (index === 1) {
+      await bar.focus();
+      await bar.press("Enter");
+    } else await bar.click();
+    const dialog = page.getByRole("dialog").last();
+    await dialog.waitFor();
+    await expect(dialog).toContainText(title);
+    const text = await dialog.innerText();
+    const id = text.match(new RegExp(`\\b${kind.toUpperCase()}-[A-Z0-9-]+`))?.[0];
+    assert.ok(id, `Selected ${kind} identity is visible`);
+    await page.screenshot({ path: `${output}/${kind}-${index}.png` });
+    cases.push({ kind, index, title, id, accessibleName, observedAt: new Date().toISOString() });
+    await dialog.getByRole("button", { name: "Fechar", exact: true }).click();
+    await expect(dialog).not.toBeVisible();
+  }
+  assert.deepEqual(errors, []);
+  assert.equal(
+    responses.some((response) => response.status >= 400),
+    false,
+  );
+  const report = {
+    result: "passed",
+    baseUrl,
+    viewport: "1440x1000",
+    browser: browser.version(),
+    candidate: process.argv[2] ?? null,
+    bundles,
+    cases,
+    responses,
+    errors,
+  };
+  await writeFile(`${output}/report.json`, JSON.stringify(report, null, 2));
+  console.log(JSON.stringify(report, null, 2));
+} finally {
+  await browser.close();
+}

package/templates/.agents/design/.zaip-managed.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "version": "5.0.0",
+  "version": "5.1.0",
   "files": [
     {
       "path": "DESIGN.md",
@@ -26,6 +26,10 @@
       "path": "apps/catalog/dist/assets/index-32GZO95T.js",
       "sha256": "12695d7255f03bf97d35c63efcff5b1ed52319ab36cbeacbf32de815a85cb03a"
     },
+    {
+      "path": "apps/catalog/dist/assets/index-BGxXxXTo.js",
+      "sha256": "e6b716d44fd773a3735d97d3bf3fd1959b2241696ff699e684ffd9889f941663"
+    },
     {
       "path": "apps/catalog/dist/assets/index-BP8IxOxt.js",
       "sha256": "972731afbaa1a1de2666477d46df0f7af55bfe698cb74bae919bac2718e1fbc8"
@@ -60,7 +64,7 @@
     },
     {
       "path": "apps/catalog/dist/index.html",
-      "sha256": "9692409f65f5eff07c696c8cbf636266846c25d5173e3730f0a5aa152be76666"
+      "sha256": "4b3d44098eabcf0c06da564cefab001010523b9f5152d7d647caa6112224f432"
     },
     {
       "path": "apps/catalog/dist/logo_novo_azul.png",
@@ -276,7 +280,7 @@
     },
     {
       "path": "apps/catalog/package.json",
-      "sha256": "dcd0c6a84e8c1cdc34fafca8ce9089ea55db196d82ac8ef9e8bb9234168dd3c2"
+      "sha256": "90285448c2f5d279607059952aa7233329049613882cc623f68da9305fded44f"
     },
     {
       "path": "apps/catalog/public/logo_novo_azul.png",
@@ -322,6 +326,10 @@
       "path": "apps/catalog/src/components/StackVersionFieldSpecimen.tsx",
       "sha256": "b33c5f2d78c34f8b2484be09d50244b8d67f1ce38d958c06306ecd742895284b"
     },
+    {
+      "path": "apps/catalog/src/components/TopEntitiesSpecimen.tsx",
+      "sha256": "2c3855f3d7d7f2c8570d7dc4ebf457b1d83dbeacc991dc4d8a4fc010155dc6c5"
+    },
     {
       "path": "apps/catalog/src/components/WorkspaceStatusSpecimen.tsx",
       "sha256": "6275e010e85452df87079176f79f30e6778ab72d1c463541bf19ac5ec72efb76"
@@ -344,7 +352,7 @@
     },
     {
       "path": "apps/catalog/src/pages/ComponentsPage.tsx",
-      "sha256": "7ac73f7f9f02035b90e9d179706c9beab0f836afb9002d1516d05d09d4f8b8c0"
+      "sha256": "73a60ec9c86e94ed1b8ebe9064d65e4bb6c20551a2f652ce639b35642f81b0dc"
     },
     {
       "path": "apps/catalog/src/pages/DesignSystemPage.tsx",
@@ -360,7 +368,7 @@
     },
     {
       "path": "apps/catalog/src/stories/Components.stories.tsx",
-      "sha256": "bc3044d7c0826656dd49d81f4128a8c2a5c271192f31ec7428445923676af832"
+      "sha256": "2a854431eb13a393de6d9475bf3308db20f7ccbdcb84d3983694cfe09b962ab7"
     },
     {
       "path": "apps/catalog/src/stories/DashboardFilters.stories.tsx",
@@ -408,7 +416,7 @@
     },
     {
       "path": "packages/local-runtime/package.json",
-      "sha256": "74dea06fa11afb30713fd1c286bc38833fe60ab782d5f9ed83ff380d9c032606"
+      "sha256": "0e6f81da73ac2ce53dce5ea41197cab4939e784976420a2bf0c3aeccd45573e1"
     },
     {
       "path": "packages/local-runtime/runtime.mjs",