@zaip-ai/cli 4.9.0 → 5.1.0

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-cost-invocation-page.test.ts

@@ -1,7 +1,56 @@
 import { describe, expect, it } from "vitest";
 import { filterCostInvocationProjection } from "./sqlite-cost-invocation-page.js";
+import { readCachedCostViewPage } from "./sqlite-query-cached-cost-page.js";
+import type { SqliteQueryContext } from "./sqlite-query-context.js";
 
 describe("cost invocation projection page", () => {
+  it("searches the immutable projection before pagination, preserving nulls and empty results", () => {
+    const context = {
+      technicalPayloadRows: () => [
+        {
+          agent_invocation_id: "AINV-OTHER",
+          task_id: null,
+          occurred_at: "2026-08-01T12:00:00Z",
+          total_tokens: 20,
+        },
+        {
+          agent_invocation_id: "AINV-TARGET-1",
+          task_id: null,
+          occurred_at: "2026-08-01T11:00:00Z",
+          total_tokens: 12,
+        },
+        {
+          agent_invocation_id: "AINV-TARGET-2",
+          task_id: null,
+          occurred_at: "2026-08-01T10:00:00Z",
+          total_tokens: null,
+        },
+      ],
+    } as unknown as SqliteQueryContext;
+    expect(
+      readCachedCostViewPage(context, "cost_monitor_agent_invocations", {
+        query: "target",
+        offset: 1,
+        limit: 1,
+      }),
+    ).toMatchObject({
+      total_count: 2,
+      has_more: false,
+      rows: [{ agent_invocation_id: "AINV-TARGET-2", total_tokens: null }],
+    });
+    expect(
+      readCachedCostViewPage(context, "cost_monitor_agent_invocations", { query: "absent" }),
+    ).toMatchObject({ total_count: 0, rows: [] });
+    expect(
+      readCachedCostViewPage(context, "cost_monitor_agent_invocations", { query: "TARGET%" }),
+    ).toBeNull();
+    expect(
+      readCachedCostViewPage(context, "cost_monitor_agent_invocations", {
+        query: "target",
+        provider: "openai",
+      }),
+    ).toBeNull();
+  });
   it("uses the Sao Paulo source day for the fast date-only page", () => {
     const rows = [
       { agent_invocation_id: "before", source_started_at: "2026-08-01T02:30:00.000Z" },

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-cost-invocation-page.ts

@@ -1,4 +1,6 @@
-type CostInvocationDateFilter = { from?: string | null; to?: string | null };
+import type { DatabaseSync } from "node:sqlite";
+
+type CostInvocationDateFilter = { from?: string | null; to?: string | null; query?: string };
 
 function costDay(value: string | null | undefined): string | null {
   if (!value) return null;
@@ -21,9 +23,50 @@ export function filterCostInvocationProjection(
 ) {
   const from = costDay(input.from);
   const to = costDay(input.to);
+  // SQLite LIKE folds ASCII only. Wildcard queries remain on the SQL reader.
+  const fold = (value: string) => value.replace(/[A-Z]/g, (letter) => letter.toLowerCase());
+  const query = input.query ? fold(input.query) : null;
   return rows.filter((row) => {
+    if (
+      query !== null &&
+      ![row.agent_invocation_id, row.task_id, row.execution_id].some(
+        (value) => typeof value === "string" && fold(value).includes(query),
+      )
+    )
+      return false;
     const timestamp = row.source_started_at ?? row.source_occurred_at ?? row.occurred_at;
     const day = typeof timestamp === "string" ? costDay(timestamp) : null;
     return day !== null && (from === null || day >= from) && (to === null || day <= to);
   });
 }
+
+/** Enrich only the selected page, matching the original SQL left join. */
+export function enrichCostInvocationPage(
+  database: DatabaseSync,
+  rows: Array<Record<string, unknown>>,
+) {
+  const ids = [
+    ...new Set(rows.flatMap((row) => (typeof row.task_id === "string" ? [row.task_id] : []))),
+  ];
+  const tasks =
+    ids.length === 0
+      ? []
+      : (database
+          .prepare(
+            "SELECT id, priority, risk, status AS task_status, title AS task_title FROM tasks WHERE id IN (" +
+              ids.map(() => "?").join(",") +
+              ")",
+          )
+          .all(...ids) as Array<Record<string, unknown>>);
+  const byId = new Map(tasks.map((task) => [task.id, task]));
+  return rows.map((row) => {
+    const task = byId.get(row.task_id);
+    return {
+      ...row,
+      priority: task?.priority ?? null,
+      risk: task?.risk ?? null,
+      task_status: task?.task_status ?? null,
+      task_title: task?.task_title ?? null,
+    };
+  });
+}

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-cached-cost-page.ts

@@ -1,4 +1,7 @@
-import { filterCostInvocationProjection } from "./sqlite-cost-invocation-page.js";
+import {
+  enrichCostInvocationPage,
+  filterCostInvocationProjection,
+} from "./sqlite-cost-invocation-page.js";
 import type { SqliteQueryContext, SqliteViewPage } from "./sqlite-query-context.js";
 import type { SqliteViewName } from "./sqlite-read-model-types.js";
 
@@ -38,9 +41,9 @@ export function readCachedCostViewPage(
     !input.origin &&
     !input.workType &&
     !input.priority;
-  const isDateOnlyCostInvocationPage =
+  const isCompactCostInvocationPage =
     view === "cost_monitor_agent_invocations" &&
-    !input.query &&
+    !/[\0%_]/.test(input.query ?? "") &&
     !input.status &&
     !input.risk &&
     !input.provider &&
@@ -50,12 +53,10 @@ export function readCachedCostViewPage(
     !input.origin &&
     !input.workType &&
     !input.priority;
-  if (isDateOnlyCostInvocationPage) {
-    const projection = filterCostInvocationProjection(
-      context.technicalPayloadRows("cost_agent_invocation_projection_v1"),
-      input,
-    );
-    if (projection.length > 0) {
+  if (isCompactCostInvocationPage) {
+    const cachedRows = context.technicalPayloadRows("cost_agent_invocation_projection_v1");
+    const projection = filterCostInvocationProjection(cachedRows, input);
+    if (cachedRows.length > 0) {
       const limit = Math.min(200, Math.max(1, input.limit ?? 100));
       const offset = Math.max(0, input.offset ?? 0);
       const rows = projection.slice(offset, offset + limit);
@@ -66,7 +67,7 @@ export function readCachedCostViewPage(
         limit,
         total_count: projection.length,
         has_more: offset + rows.length < projection.length,
-        rows,
+        rows: input.query ? enrichCostInvocationPage(context.database, rows) : rows,
       };
     }
   }

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-summary.ts

@@ -110,7 +110,7 @@ export function queryCostMonitorSummaryAggregate(
   add("work_type", filter.workTypes);
   if (filter.query) {
     clauses.push(
-      "(a.task_id LIKE ? OR a.spec_id LIKE ? OR a.prd_id LIKE ? OR a.execution_id LIKE ? OR a.conversation_id LIKE ? OR a.zaip_agent LIKE ? OR a.model LIKE ? OR a.run_id LIKE ? OR a.agent_run_id LIKE ? OR EXISTS (SELECT 1 FROM canonical_work_items task WHERE task.id=a.task_id AND task.title LIKE ?))",
+      "(a.task_id LIKE ? OR a.spec_id LIKE ? OR a.prd_id LIKE ? OR a.execution_id LIKE ? OR a.conversation_id LIKE ? OR a.zaip_agent LIKE ? OR a.model LIKE ? OR a.run_id LIKE ? OR a.agent_run_id LIKE ? OR EXISTS (SELECT 1 FROM canonical_work_items task WHERE task.entity_kind='task' AND task.id=a.task_id AND task.title LIKE ?))",
     );
     values.push(...Array(10).fill(`%${filter.query}%`));
   }

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-work-item-index.test.ts

@@ -2,7 +2,7 @@ import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { DatabaseSync } from "node:sqlite";
-import { afterEach, describe, expect, it } from "vitest";
+import { afterEach, describe, expect, it, vi } from "vitest";
 import { rebuildSqliteReadModel, SqliteReadModelFileSystem } from "./sqlite-read-model.js";
 
 const roots: string[] = [];
@@ -35,6 +35,23 @@ describe("SQLite work-item identity index", () => {
       ).toContain("TASK-INDEXED");
       const database = new DatabaseSync(process.env.ZAIP_SQLITE_DB_PATH, { readOnly: true });
       try {
+        const reader = new SqliteReadModelFileSystem(root, database);
+        const prepared = vi.spyOn(database, "prepare");
+        reader.costMonitorSummaryAggregate({ from: null, to: null, query: "Indexed" });
+        const searchSql = prepared.mock.calls
+          .map(([sql]) => sql)
+          .find(
+            (sql) =>
+              sql.startsWith("WITH selected AS MATERIALIZED") && sql.includes("task.title LIKE"),
+          );
+        prepared.mockRestore();
+        expect(searchSql).toBeDefined();
+        const searchPlan = database
+          .prepare(`EXPLAIN QUERY PLAN ${searchSql}`)
+          .all(null, null, null, null, ...Array(10).fill("%Indexed%")) as Array<{ detail: string }>;
+        expect(searchPlan.map((row) => row.detail).join("\n")).toContain(
+          "zaip_activities_work_item_identity",
+        );
         const plan = database
           .prepare(`EXPLAIN QUERY PLAN
           SELECT a.task_id FROM zaip_vw_activities a WHERE a.task_id IS NOT NULL

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": "4.9.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": "4.9.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": "4.9.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": "51e5b590cefb6e579380f6bd25aefacecdaae63e0334452d802cfed620ff8626"
+      "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": "36000642ad5ec75354a48998989c41030e3fc1990998d521ac417bed51595d85"
+      "sha256": "0e6f81da73ac2ce53dce5ea41197cab4939e784976420a2bf0c3aeccd45573e1"
     },
     {
       "path": "packages/local-runtime/runtime.mjs",