@zaip-ai/cli 5.0.0 → 5.2.0

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

@@ -79,7 +79,6 @@ describe("dashboard executable session", () => {
     expect(source).toContain("const previousSessions = await previousDashboardSessions();");
     expect(source).toContain("await stopOwnedDashboard(previous);");
     expect(source).not.toContain("const reusable = await findReusableDashboardSession({");
-    expect(source).toContain("const previousSessions = await previousDashboardSessions();");
     const excludedPorts = source.slice(
       source.indexOf("const excludedPorts = new Set(["),
       source.indexOf("const serverPath = await assertRuntimeReady();"),
@@ -198,6 +197,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.2.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.2.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.2.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": "95d8f0cec831f1dd3fb8194385059f50dce761b24f08615dc4b98f89aab9e418"
     },
     {
       "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": "9d3e41b71ec10b176050916e7a0a5bff74bc18832fb557af6b00da426ba65dd3"
     },
     {
       "path": "packages/local-runtime/runtime.mjs",