@zaip-ai/cli 7.5.0 → 7.6.0

package/templates/.agents/dashboard/apps/frontend/src/use-runtime-status.dom.test.ts

@@ -2,7 +2,7 @@ import { createRequire } from "node:module";
 import { fileURLToPath } from "node:url";
 import { expect, it } from "vitest";
 
-it("checks health once, ignores pending capture, and reports real loading errors until reload", async () => {
+it("recovers transient health failures and preserves terminal identity errors", async () => {
   const require = createRequire(
     fileURLToPath(new URL("../../../tests/e2e/package.json", import.meta.url)),
   );
@@ -43,11 +43,20 @@ it("checks health once, ignores pending capture, and reports real loading errors
       "**/api/v2/health",
       async (route: { abort: () => Promise<void>; fulfill: (value: object) => Promise<void> }) => {
         requests++;
-        if (mode === "network") return route.abort();
+        if (mode === "timeout" && requests === 1) return;
+        if (mode === "network" || (mode === "network-once" && requests === 1)) return route.abort();
+        const status =
+          mode === "http" || (mode === "http-once" && requests === 1)
+            ? 503
+            : mode === "unauthorized"
+              ? 401
+              : mode === "forbidden"
+                ? 403
+                : 200;
         await route.fulfill({
-          status: mode === "http" ? 503 : 200,
+          status,
           json: {
-            kind: "zaip-dashboard-sqlite-runtime",
+            kind: mode === "wrong-runtime" ? "other-runtime" : "zaip-dashboard-sqlite-runtime",
             workspace: "fixture",
             workspace_name: "ready",
             workspaceKey: "fixture",
@@ -69,17 +78,30 @@ it("checks health once, ignores pending capture, and reports real loading errors
     await page.reload();
     await page.getByText("ready", { exact: true }).waitFor();
     expect(await page.getByRole("alert").count()).toBe(0);
-    for (const failure of ["http", "network"]) {
+    for (const failure of ["timeout", "http-once", "network-once"]) {
       mode = failure;
+      requests = 0;
+      await page.reload();
+      await expect.poll(() => requests).toBe(1);
+      if (failure === "timeout") await page.clock.fastForward(4001);
+      await page.getByText("ready", { exact: true }).waitFor();
+      expect(requests).toBe(2);
+      expect(await page.getByRole("alert").count()).toBe(0);
+    }
+    for (const failure of ["http", "network", "unauthorized", "forbidden", "wrong-runtime"]) {
+      mode = failure;
+      requests = 0;
       await page.reload();
       await page.getByRole("alert").waitFor();
       expect(await page.getByRole("alert").innerText()).toContain("abra novamente o executável");
+      await page.clock.fastForward(30_000);
+      expect(requests).toBe(["http", "network"].includes(failure) ? 3 : 1);
     }
     mode = "healthy";
     await page.getByRole("button", { name: "Atualizar página" }).click();
     await page.getByText("ready", { exact: true }).waitFor();
     expect(await page.getByRole("alert").count()).toBe(0);
-    expect(requests).toBe(5);
+    expect(requests).toBe(2);
   } finally {
     await browser.close();
   }

package/templates/.agents/dashboard/apps/frontend/src/use-runtime-status.ts

@@ -2,6 +2,7 @@ import { useEffect, useState } from "react";
 import {
   type DashboardRuntimeStatus,
   readDashboardRuntimeStatus,
+  TransientHealthError,
 } from "./dashboard-runtime-status.js";
 
 export function useRuntimeStatus() {
@@ -10,26 +11,36 @@ export function useRuntimeStatus() {
   useEffect(() => {
     let disposed = false;
     let controller: AbortController;
-    // Identity is checked on page load. New telemetry is not a connection failure;
-    // users can reload the page or reopen the launcher for a fresh snapshot.
-    async function load() {
+    const deadlines = [4000, 8000, 16000];
+    let retry: ReturnType<typeof setTimeout>;
+    async function load(attempt: number) {
       controller = new AbortController();
-      const timeout = setTimeout(() => controller.abort(), 4000);
+      const timeout = setTimeout(() => controller.abort(), deadlines[attempt]);
       try {
         const next = await readDashboardRuntimeStatus(controller.signal);
         if (!disposed) {
           setStatus(next);
           setUnavailable(false);
         }
-      } catch {
-        if (!disposed) setUnavailable(true);
+      } catch (error) {
+        if (disposed) return;
+        const transient =
+          controller.signal.aborted ||
+          error instanceof TypeError ||
+          error instanceof TransientHealthError;
+        if (transient && attempt + 1 < deadlines.length) {
+          retry = setTimeout(() => void load(attempt + 1), 250 * (attempt + 1));
+        } else {
+          setUnavailable(true);
+        }
       } finally {
         clearTimeout(timeout);
       }
     }
-    void load();
+    void load(0);
     return () => {
       disposed = true;
+      clearTimeout(retry);
       controller?.abort();
     };
   }, []);

package/templates/.agents/dashboard/modules/cost-monitor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/dashboard-cost-monitor",
-  "version": "7.5.0",
+  "version": "7.6.0",
   "private": true,
   "type": "module",
   "exports": {

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

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/dashboard-operations",
-  "version": "7.5.0",
+  "version": "7.6.0",
   "private": true,
   "type": "module",
   "exports": {

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

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

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

@@ -45,7 +45,18 @@ export interface TraceObservedMetric {
   coverage_ratio: number;
 }
 
+export interface ReleaseDeliveryProjection {
+  publication: "verified" | "unverified";
+  receipt_path: string | null;
+  task_status: string;
+  change_status: string | null;
+  execution_status: string | null;
+  blocker: string | null;
+  next_action: string | null;
+}
+
 export interface TaskTrace {
+  release_delivery?: ReleaseDeliveryProjection;
   schema_version: 2;
   layout_version: 2 | 3;
   readonly: true;

package/templates/.agents/dashboard/modules/traceability/src/react/ReleaseDeliveryPanel.tsx

@@ -0,0 +1,60 @@
+import type { ReleaseDeliveryProjection } from "../contracts.js";
+import "./release-delivery-panel.css";
+
+export function ReleaseDeliveryPanel({
+  delivery,
+  locale,
+}: {
+  delivery: ReleaseDeliveryProjection;
+  locale: "pt-BR" | "en-US";
+}) {
+  const pt = locale === "pt-BR";
+  const statuses = [
+    ["Task", delivery.task_status],
+    ["Change", delivery.change_status],
+    ["Execution", delivery.execution_status],
+  ] as const;
+  const closed = statuses.every(([, status]) => status === "completed");
+  const published = delivery.publication === "verified";
+  return (
+    <section
+      className="trace-release-delivery"
+      aria-label={pt ? "Entrega da versão" : "Release delivery"}
+    >
+      <h3>{pt ? "Entrega da versão" : "Release delivery"}</h3>
+      <dl>
+        <div>
+          <dt>{pt ? "Publicação" : "Publication"}</dt>
+          <dd>
+            {published ? (pt ? "Confirmada" : "Verified") : pt ? "Sem confirmação" : "Unverified"}
+          </dd>
+        </div>
+        <div>
+          <dt>{pt ? "Fechamento no ZAIP" : "ZAIP closure"}</dt>
+          <dd>{closed ? (pt ? "Concluído" : "Completed") : pt ? "Pendente" : "Pending"}</dd>
+        </div>
+        {statuses.map(([label, status]) => (
+          <div key={label}>
+            <dt>{label}</dt>
+            <dd>{status ?? (pt ? "Sem registro" : "Unrecorded")}</dd>
+          </div>
+        ))}
+      </dl>
+      {delivery.blocker && (
+        <p>
+          <strong>{pt ? "Bloqueio" : "Blocker"}</strong> · {delivery.blocker}
+        </p>
+      )}
+      {delivery.next_action && (
+        <p>
+          <strong>{pt ? "Próxima ação" : "Next action"}</strong> · {delivery.next_action}
+        </p>
+      )}
+      {delivery.receipt_path && (
+        <p>
+          <strong>{pt ? "Comprovante" : "Receipt"}</strong> · <code>{delivery.receipt_path}</code>
+        </p>
+      )}
+    </section>
+  );
+}

package/templates/.agents/dashboard/modules/traceability/src/react/TaskTracePanel.tsx

@@ -24,24 +24,22 @@ import {
 } from "lucide-react";
 import { useMemo, useState } from "react";
 import type { TaskTrace, TraceDocument, TraceStage } from "../contracts.js";
+import { formatTraceCreatedAt, formatTraceElapsed } from "./trace-date-format.js";
 import "./traceability-navigation.css";
 import "./traceability-embedded.css";
 import "./traceability-usage.css";
 import "./traceability.css";
 import "./traceability-stage-detail.css";
 import "./traceability-stage-dialog.css";
+import { ReleaseDeliveryPanel } from "./ReleaseDeliveryPanel.js";
 import { TraceDocumentDialog } from "./TraceDocumentDialog.js";
 import { TraceStageDetail } from "./TraceStageDetail.js";
 import { TraceStageDialog } from "./TraceStageDialog.js";
 
-export const traceStages: readonly TraceStage[] = [
-  "definition",
-  "planning",
-  "execution",
-  "decisions",
-  "verification",
-  "evidence",
-];
+import { traceStageArtifactsEn, traceStageArtifactsPt, traceStages } from "./trace-stage-labels.js";
+
+export { traceStageArtifactsEn, traceStageArtifactsPt, traceStages } from "./trace-stage-labels.js";
+
 const loadingIdentifierKeys = ["task", "change", "spec", "prd"] as const;
 const loadingMetricKeys = ["coverage", "documents", "evidence", "links"] as const;
 const riskLabels = {
@@ -56,22 +54,6 @@ const stageIcons: Record<TraceStage, LucideIcon> = {
   verification: ShieldCheck,
   evidence: FileCheck2,
 };
-export const traceStageArtifactsPt: Record<TraceStage, string> = {
-  definition: "PRD · Requisitos",
-  planning: "SPEC · Change",
-  execution: "Tarefas · DAG · Runs · arquivos",
-  decisions: "Decisões do planejamento e da execução",
-  verification: "Testes · revisões · evals · checks",
-  evidence: "Evidências · resultados · rastreabilidade",
-};
-export const traceStageArtifactsEn: Record<TraceStage, string> = {
-  definition: "PRD · Requirements",
-  planning: "SPEC · Change",
-  execution: "Tasks · DAG · Runs · files",
-  decisions: "Planning and execution decisions",
-  verification: "Tests · reviews · evals · checks",
-  evidence: "Evidence · results · traceability",
-};
 export const traceStageArtifacts = traceStageArtifactsPt;
 export type TraceLocale = "pt-BR" | "en-US";
 
@@ -404,6 +386,9 @@ export function TaskTracePanel({
             </div>
           </article>
         </section>
+        {trace.release_delivery && (
+          <ReleaseDeliveryPanel delivery={trace.release_delivery} locale={locale} />
+        )}
         <section
           className="trace-overview trace-lineage"
           aria-label={locale === "pt-BR" ? "Identificadores vinculados" : "Linked identifiers"}
@@ -646,36 +631,3 @@ function TraceUsageStrip({
 function formatTraceDuration(durationMs: number | null, locale: TraceLocale): string {
   return durationMs === null ? "—" : formatDurationMs(durationMs, locale);
 }
-
-function formatTraceCreatedAt(value: string | null, locale: TraceLocale): string {
-  if (value === null) return "—";
-  const date = new Date(value);
-  if (Number.isNaN(date.getTime())) return "—";
-  return new Intl.DateTimeFormat(locale, {
-    dateStyle: "short",
-    timeStyle: "short",
-  }).format(date);
-}
-
-function formatTraceElapsed(value: string | null, locale: TraceLocale): string {
-  if (value === null) return "—";
-  const createdAt = Date.parse(value);
-  if (!Number.isFinite(createdAt)) return "—";
-  const elapsedMs = Math.max(0, Date.now() - createdAt);
-  const minutes = Math.max(1, Math.round(elapsedMs / 60_000));
-  let unit: string;
-  if (minutes < 60) unit = `${minutes}m`;
-  else {
-    const hours = Math.round(minutes / 60);
-    if (hours < 24) unit = `${hours}h`;
-    else {
-      const days = Math.round(hours / 24);
-      if (days < 7) unit = `${days}d`;
-      else {
-        const weeks = Math.round(days / 7);
-        unit = locale === "pt-BR" ? `${weeks}sem` : `${weeks}w`;
-      }
-    }
-  }
-  return locale === "pt-BR" ? `Há ${unit}` : `${unit} ago`;
-}

package/templates/.agents/dashboard/modules/traceability/src/react/release-delivery-panel.css

@@ -0,0 +1,26 @@
+.trace-release-delivery {
+  margin-block: 1.25rem;
+  padding: 1rem;
+  border: 1px solid var(--line);
+  border-radius: 12px;
+  overflow-wrap: anywhere;
+}
+
+.trace-release-delivery h3,
+.trace-release-delivery dd {
+  margin: 0;
+}
+
+.trace-release-delivery dl {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(min(100%, 9rem), 1fr));
+  gap: 0.75rem;
+}
+
+.trace-release-delivery dt {
+  color: var(--muted);
+}
+
+.trace-release-delivery p {
+  margin: 0.5rem 0 0;
+}

package/templates/.agents/dashboard/modules/traceability/src/react/trace-date-format.ts

@@ -0,0 +1,33 @@
+import type { TraceLocale } from "./TaskTracePanel.js";
+export function formatTraceCreatedAt(value: string | null, locale: TraceLocale): string {
+  if (value === null) return "—";
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) return "—";
+  return new Intl.DateTimeFormat(locale, {
+    dateStyle: "short",
+    timeStyle: "short",
+  }).format(date);
+}
+
+export function formatTraceElapsed(value: string | null, locale: TraceLocale): string {
+  if (value === null) return "—";
+  const createdAt = Date.parse(value);
+  if (!Number.isFinite(createdAt)) return "—";
+  const elapsedMs = Math.max(0, Date.now() - createdAt);
+  const minutes = Math.max(1, Math.round(elapsedMs / 60_000));
+  let unit: string;
+  if (minutes < 60) unit = `${minutes}m`;
+  else {
+    const hours = Math.round(minutes / 60);
+    if (hours < 24) unit = `${hours}h`;
+    else {
+      const days = Math.round(hours / 24);
+      if (days < 7) unit = `${days}d`;
+      else {
+        const weeks = Math.round(days / 7);
+        unit = locale === "pt-BR" ? `${weeks}sem` : `${weeks}w`;
+      }
+    }
+  }
+  return locale === "pt-BR" ? `Há ${unit}` : `${unit} ago`;
+}

package/templates/.agents/dashboard/modules/traceability/src/react/trace-stage-labels.ts

@@ -0,0 +1,28 @@
+import type { TraceStage } from "../contracts.js";
+
+export const traceStages: readonly TraceStage[] = [
+  "definition",
+  "planning",
+  "execution",
+  "decisions",
+  "verification",
+  "evidence",
+];
+
+export const traceStageArtifactsPt: Record<TraceStage, string> = {
+  definition: "PRD · Requisitos",
+  planning: "SPEC · Change",
+  execution: "Tarefas · DAG · Runs · arquivos",
+  decisions: "Decisões do planejamento e da execução",
+  verification: "Testes · revisões · evals · checks",
+  evidence: "Evidências · resultados · rastreabilidade",
+};
+
+export const traceStageArtifactsEn: Record<TraceStage, string> = {
+  definition: "PRD · Requirements",
+  planning: "SPEC · Change",
+  execution: "Tasks · DAG · Runs · files",
+  decisions: "Planning and execution decisions",
+  verification: "Tests · reviews · evals · checks",
+  evidence: "Evidence · results · traceability",
+};

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

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

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

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