@zaip-ai/cli 3.4.0 → 3.6.0

package/templates/.agents/dashboard/apps/frontend/src/WorkspaceStatus.test.tsx

@@ -4,30 +4,48 @@ import { describe, expect, it } from "vitest";
 import { WorkspaceStatus } from "./WorkspaceStatus.js";
 
 describe("workspace diagnostics", () => {
+  it("does not render a global workspace banner when the runtime is healthy", () => {
+    const html = renderToStaticMarkup(
+      createElement(WorkspaceStatus, {
+        status: {
+          workspace: "C:/projects/zaip-growth",
+          workspace_name: "zaip-growth",
+          workspaceKey: "growth",
+          status: "ok",
+          lifecycle_manifest_state: "initialized",
+        },
+      }),
+    );
+    expect(html).toBe("");
+  });
+
   it.each([
-    "initialized",
     "missing",
     "invalid",
-  ] as const)("identifies the served path with %s lifecycle", (state) => {
+  ] as const)("keeps the %s lifecycle warning without exposing the served path", (state) => {
     const html = renderToStaticMarkup(
       createElement(WorkspaceStatus, {
         status: {
           workspace: "C:/projects/zaip-growth",
           workspace_name: "zaip-growth",
           workspaceKey: "growth",
-          status: state === "initialized" ? "ok" : "degraded",
+          status: "degraded",
           lifecycle_manifest_state: state,
         },
       }),
     );
-    expect(html).toContain("C:/projects/zaip-growth");
+    expect(html).not.toContain("C:/projects/zaip-growth");
+    expect(html).not.toContain("zaip-growth");
     if (state === "missing") expect(html).toContain("Lifecycle não inicializado");
     if (state === "invalid") expect(html).toContain("Manifesto do lifecycle inválido");
-    if (state !== "initialized") expect(html).toContain("manifest rebuild --confirm-full-scan");
+    expect(html).toContain("manifest rebuild --confirm-full-scan");
   });
+
   it("keeps unknown health explicit", () => {
-    expect(
-      renderToStaticMarkup(createElement(WorkspaceStatus, { status: null, unavailable: true })),
-    ).toContain("Workspace indisponível");
+    const html = renderToStaticMarkup(
+      createElement(WorkspaceStatus, { status: null, unavailable: true }),
+    );
+    expect(html).toContain("Não foi possível consultar a saúde do Dashboard");
+    expect(html).not.toContain("Workspace indisponível");
   });
 });

package/templates/.agents/dashboard/apps/frontend/src/WorkspaceStatus.tsx

@@ -1,4 +1,3 @@
-import { useLayoutEffect, useRef } from "react";
 import type { DashboardRuntimeStatus } from "./dashboard-runtime-status.js";
 import "./workspace-status.css";
 
@@ -10,32 +9,10 @@ export function WorkspaceStatus({
   unavailable?: boolean;
 }) {
   const manifest = status?.lifecycle_manifest_state;
-  const banner = useRef<HTMLElement>(null);
-  useLayoutEffect(() => {
-    const element = banner.current;
-    if (!element) return;
-    const update = () =>
-      document.documentElement.style.setProperty(
-        "--dashboard-workspace-height",
-        `${element.getBoundingClientRect().height}px`,
-      );
-    update();
-    const observer = new ResizeObserver(update);
-    observer.observe(element);
-    return () => {
-      observer.disconnect();
-      document.documentElement.style.removeProperty("--dashboard-workspace-height");
-    };
-  }, []);
+  if (manifest === "initialized" && status?.status === "ok" && !unavailable) return null;
+
   return (
-    <aside ref={banner} className="workspace-status" aria-label="Workspace do Dashboard">
-      <div className="workspace-status__identity">
-        <strong>{status?.workspace_name ?? "Dashboard"}</strong>
-        <span>
-          {status?.workspace ??
-            (unavailable ? "Workspace indisponível" : "Identificando workspace…")}
-        </span>
-      </div>
+    <aside className="workspace-status" aria-label="Saúde do Dashboard">
       {manifest === "missing" || manifest === "invalid" ? (
         <div className="workspace-status__warning" role="alert">
           <strong>
@@ -43,7 +20,7 @@ export function WorkspaceStatus({
               ? "Lifecycle não inicializado"
               : "Manifesto do lifecycle inválido"}
           </strong>
-          <p>Os dados deste workspace estão indisponíveis. Na pasta indicada, execute:</p>
+          <p>Os dados deste workspace estão indisponíveis. Na pasta do projeto, execute:</p>
           <code>node .agents/runtime/bin/zaip.mjs manifest rebuild --confirm-full-scan</code>
         </div>
       ) : status?.status === "degraded" || unavailable ? (
@@ -52,7 +29,11 @@ export function WorkspaceStatus({
             ? "Não foi possível consultar a saúde do Dashboard. Tentando novamente…"
             : "Dashboard degradado: a atualização dos dados ou da telemetria requer atenção."}
         </p>
-      ) : null}
+      ) : (
+        <p className="workspace-status__warning" role="status">
+          Identificando a saúde do Dashboard…
+        </p>
+      )}
     </aside>
   );
 }

package/templates/.agents/dashboard/apps/frontend/src/cost-calculation-guide.css

@@ -212,7 +212,7 @@
 .cost-guide-unavailable,
 .cost-guide-unavailable-combination {
   padding: 16px;
-  color: #fcd34d !important;
+  color: #fcd34d;
   background: #2a210b66;
   border: 1px solid #8a6b22;
   border-radius: 12px;

package/templates/.agents/dashboard/apps/frontend/src/dashboard-help-dialog.css

@@ -100,7 +100,7 @@
   border-radius: 11px;
   background: rgba(5, 12, 23, 0.58);
 }
-.dashboard-help-document-header button {
+.dashboard-help .dashboard-help-document-header button {
   min-height: 32px;
   border: 1px solid transparent;
   border-radius: 8px;
@@ -109,7 +109,7 @@
   color: #7f91aa;
   font-size: 0.7rem;
 }
-.dashboard-help-document-header button.is-active {
+.dashboard-help .dashboard-help-document-header button.is-active {
   border-color: rgba(56, 189, 248, 0.24);
   background: rgba(14, 165, 233, 0.11);
   color: #bae6fd;

package/templates/.agents/dashboard/apps/frontend/src/operations-entity-page-projection.ts

@@ -142,7 +142,10 @@ export function projectEntityPage(
     executions:
       kind === "executions" || kind === "conversations"
         ? (page.rows.map((row, index) => {
-            const run = runs[index]!;
+            const run = runs[index];
+            if (run === undefined) {
+              throw new Error("Operations entity page must have a projected run for every row.");
+            }
             const id = run.execution_id ?? run.conversation_id;
             const status = row.status ?? "unavailable";
             return {

package/templates/.agents/dashboard/apps/frontend/src/operations-period-contract.test.ts

@@ -1,3 +1,4 @@
+import type { OperationsProjection } from "@zaip-ai/dashboard-operations/contracts";
 import { describe, expect, it } from "vitest";
 import {
   isCurrentOperationsPageRequest,
@@ -5,6 +6,7 @@ import {
   isCurrentPeriodTransition,
   mergeBoardPages,
 } from "./App.js";
+import type { OperationsBoardPage } from "./dashboard-api.js";
 import { requestPeriodForOperations } from "./operations-period.js";
 
 describe("Operations period request contract", () => {
@@ -90,14 +92,18 @@ describe("Operations period request contract", () => {
     const pending = [a, b, c].map(() => Promise.withResolvers<void>());
     const applied: string[] = [];
     const reply = async (version: number, period: typeof a, label: string, slot: number) => {
-      await pending[slot]!.promise;
+      const deferred = pending[slot];
+      if (deferred === undefined) throw new Error(`Missing deferred reply for slot ${slot}.`);
+      await deferred.promise;
       if (isCurrentOperationsPeriodRequest(version, 3, period, c)) applied.push(label);
     };
     const requests = [reply(1, a, "A", 0), reply(2, b, "B", 1), reply(3, c, "C", 2)];
 
-    pending[2]!.resolve();
-    pending[1]!.resolve();
-    pending[0]!.resolve();
+    for (const slot of [2, 1, 0]) {
+      const deferred = pending[slot];
+      if (deferred === undefined) throw new Error(`Missing deferred reply for slot ${slot}.`);
+      deferred.resolve();
+    }
     await Promise.all(requests);
 
     expect(applied).toEqual(["C"]);
@@ -114,7 +120,9 @@ describe("Operations period request contract", () => {
       controller: AbortController,
       slot: number,
     ) => {
-      await pending[slot]!.promise;
+      const deferred = pending[slot];
+      if (deferred === undefined) throw new Error(`Missing deferred reply for slot ${slot}.`);
+      await deferred.promise;
       if (isCurrentOperationsPageRequest(version, 2, controller.signal)) applied.push(label);
     };
     const requests = [
@@ -123,8 +131,11 @@ describe("Operations period request contract", () => {
     ];
 
     oldRequest.abort();
-    pending[1]!.resolve();
-    pending[0]!.resolve();
+    for (const slot of [1, 0]) {
+      const deferred = pending[slot];
+      if (deferred === undefined) throw new Error(`Missing deferred reply for slot ${slot}.`);
+      deferred.resolve();
+    }
     await Promise.all(requests);
 
     expect(applied).toEqual(["new-filter-page"]);
@@ -137,14 +148,14 @@ describe("Operations period request contract", () => {
       tasks: [],
       changes: [],
       summary: { overview_metrics: { partial: false, total_tasks: 5 } },
-    } as any;
+    } as unknown as OperationsProjection;
     const board = {
       prds: [],
       specs: [],
       tasks: [{ id: "TASK-1" }],
       changes: [],
       overview_metrics: { partial: false, total_tasks: 999 },
-    } as any;
+    } as unknown as OperationsBoardPage;
     expect(mergeBoardPages(quick, [board]).summary.overview_metrics).toEqual(
       quick.summary.overview_metrics,
     );

package/templates/.agents/dashboard/apps/frontend/src/pricing-settings-dialog.css

@@ -30,6 +30,9 @@
 .pricing-dialog > header > div {
   max-width: 820px;
 }
+.pricing-dialog small {
+  color: #8391a7;
+}
 .pricing-dialog > header small {
   color: #77bff2;
   font-size: 11px;
@@ -46,9 +49,6 @@
   color: #94a3b8;
   line-height: 1.55;
 }
-.pricing-dialog small {
-  color: #8391a7;
-}
 .pricing-dialog button {
   border: 1px solid #34445e;
   border-radius: 11px;
@@ -103,8 +103,8 @@
   color: #edf5ff;
   font-size: 15px;
 }
-.pricing-fx-copy p,
-.pricing-table-heading p {
+.pricing-dialog .pricing-fx-copy p,
+.pricing-dialog .pricing-table-heading p {
   margin: 7px 0 0;
   color: #8e9bb1;
   font-size: 13px;

package/templates/.agents/dashboard/apps/frontend/src/project-settings-copy.ts

@@ -15,6 +15,10 @@ export const projectSettingsCopy = {
     framework: "Framework ZAIP-AIOS",
     frameworkHint: "Ativa ou desativa o framework para este projeto.",
     identity: "Identidade do projeto",
+    workspacePath: "Caminho do projeto",
+    workspacePathHint: "Pasta local usada por esta instância do Dashboard.",
+    workspacePathLoading: "Identificando caminho…",
+    workspacePathUnavailable: "Caminho indisponível",
     stack: "Stack e linguagens",
     execution: "Execução",
     assurance: "Assurance",
@@ -57,8 +61,9 @@ export const projectSettingsCopy = {
     available: "Criado",
     artifactUnavailable: "Ainda não criado",
     componentGuide:
-      "Preencha cada responsabilidade separadamente. A versão fica sem prefixos (^, ~, >=) e a referência identifica o pacote, imagem ou serviço.",
-    versionHint: "Versão exata: 22.16.0 ou 17.6. Deixe vazio para serviços sem versão fixada.",
+      "Preencha cada responsabilidade separadamente. Use a versão exata do software e, para serviços em nuvem ou hospedagem, informe Serviço em nuvem.",
+    versionHint:
+      "Software: 22.16.0 ou 17.6, sem prefixos (^, ~, >=). Serviço gerenciado: Serviço em nuvem. Hospedagem: Serviço em nuvem.",
     referenceHint:
       "Ex.: npm:hono, docker:node:22.16.0-bookworm-slim, service:supabase ou provider:cloudflare-pages.",
     overrides: "Opções avançadas (JSON)",
@@ -103,6 +108,10 @@ export const projectSettingsCopy = {
     framework: "ZAIP-AIOS framework",
     frameworkHint: "Enable or disable the framework for this project.",
     identity: "Project identity",
+    workspacePath: "Project path",
+    workspacePathHint: "Local folder used by this Dashboard instance.",
+    workspacePathLoading: "Identifying path…",
+    workspacePathUnavailable: "Path unavailable",
     stack: "Stack and languages",
     execution: "Execution",
     assurance: "Assurance",
@@ -145,9 +154,9 @@ export const projectSettingsCopy = {
     available: "Created",
     artifactUnavailable: "Not created yet",
     componentGuide:
-      "Fill each responsibility separately. Versions have no prefixes (^, ~, >=), and the reference identifies the package, image, or service.",
+      "Fill each responsibility separately. Use an exact software version and, for cloud services or hosting, enter Cloud service.",
     versionHint:
-      "Exact version: 22.16.0 or 17.6. Leave blank for services without a pinned version.",
+      "Software: 22.16.0 or 17.6, without prefixes (^, ~, >=). Managed service: Cloud service. Hosting: Cloud service.",
     referenceHint:
       "E.g. npm:hono, docker:node:22.16.0-bookworm-slim, service:supabase, or provider:cloudflare-pages.",
     overrides: "Advanced options (JSON)",

package/templates/.agents/dashboard/apps/frontend/src/project-settings-model.ts

@@ -34,6 +34,18 @@ export type StackComponentId = (typeof stackComponentDefinitions)[number]["id"];
 export type StackComponentDraft = { name: string; version: string; reference: string };
 export type StackComponentsDraft = Record<StackComponentId, StackComponentDraft>;
 
+const descriptiveVersionComponentIds = new Set<StackComponentId>([
+  "database",
+  "auth_storage",
+  "backend_hosting",
+  "frontend_hosting",
+  "site_hosting",
+]);
+
+export function acceptsDescriptiveVersion(id: StackComponentId): boolean {
+  return descriptiveVersionComponentIds.has(id);
+}
+
 export function projectSettingsDraft(config: ProjectConfigSettings): {
   components: StackComponentsDraft;
   otherOverrides: string;
@@ -110,11 +122,23 @@ export function buildProjectSettingsPayload(
   } = parsed;
   for (const definition of stackComponentDefinitions) {
     const version = components[definition.id].version.trim();
-    if (version !== "" && !/^\d+\.\d+(?:\.\d+)?(?:[-+][0-9A-Za-z.-]+)?$/.test(version)) {
+    if (
+      version !== "" &&
+      !acceptsDescriptiveVersion(definition.id) &&
+      !/^\d+\.\d+(?:\.\d+)?(?:[-+][0-9A-Za-z.-]+)?$/.test(version)
+    ) {
       throw new Error(
         `A versão de ${components[definition.id].name || definition.defaultName} deve ser exata, como 22.16.0 ou 17.6, sem ^, ~, >= ou latest.`,
       );
     }
+    if (
+      acceptsDescriptiveVersion(definition.id) &&
+      (version.length > 120 || /[\r\n]/.test(version))
+    ) {
+      throw new Error(
+        `A referência de ${components[definition.id].name || definition.defaultName} deve ter uma única linha com até 120 caracteres.`,
+      );
+    }
   }
   const normalized = Object.fromEntries(
     stackComponentDefinitions.map((definition) => [

package/templates/.agents/dashboard/apps/frontend/src/project-settings-workspace.css

@@ -0,0 +1,28 @@
+.project-settings-workspace-path {
+  display: block;
+  min-width: 0;
+  padding: 10px 12px;
+  border: 1px solid #cbd7e5;
+  border-radius: 12px;
+  background: #f8fafc;
+  overflow-wrap: anywhere;
+  color: #0f172a;
+}
+
+.project-settings-workspace-field {
+  grid-column: 1 / -1;
+}
+
+.project-stack-row input.is-reference-value {
+  border-color: #9edcf2;
+  background-color: #effaff;
+  color: #075985;
+  font-weight: 650;
+  -webkit-text-fill-color: #075985;
+}
+
+.project-stack-row input.is-reference-value:hover,
+.project-stack-row input.is-reference-value:focus-visible {
+  border-color: #00b0f0;
+  background-color: #f5fcff;
+}

package/templates/.agents/dashboard/apps/frontend/src/project-settings.test.ts

@@ -111,6 +111,45 @@ describe("project settings form mapping", () => {
     ).toThrow("deve ser exata");
   });
 
+  it("accepts descriptive references only for managed services and hosting", () => {
+    const components = projectSettingsDraft(config).components;
+    const payload = buildProjectSettingsPayload(
+      config,
+      {
+        ...components,
+        database: { ...components.database, version: "Serviço em nuvem" },
+        auth_storage: { ...components.auth_storage, version: "Serviço em nuvem" },
+        backend_hosting: {
+          ...components.backend_hosting,
+          version: "Serviço em nuvem",
+        },
+        frontend_hosting: { ...components.frontend_hosting, version: "Serviço em nuvem" },
+        site_hosting: { ...components.site_hosting, version: "Serviço em nuvem" },
+      },
+      "{}",
+    );
+
+    expect(payload.stack.overrides.components).toMatchObject({
+      database: { version: "Serviço em nuvem" },
+      auth_storage: { version: "Serviço em nuvem" },
+      backend_hosting: {
+        version: "Serviço em nuvem",
+      },
+      frontend_hosting: { version: "Serviço em nuvem" },
+      site_hosting: { version: "Serviço em nuvem" },
+    });
+    expect(() =>
+      buildProjectSettingsPayload(
+        config,
+        {
+          ...components,
+          backend_api: { ...components.backend_api, version: "Serviço em nuvem" },
+        },
+        "{}",
+      ),
+    ).toThrow("deve ser exata");
+  });
+
   it("keeps observability and on-demand testing tools editable with pinned-or-empty versions", () => {
     const configured = {
       ...config,

package/templates/.agents/dashboard/apps/frontend/src/use-app-work-board.test.ts

@@ -1,5 +1,5 @@
-import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import type { OperationsProjection } from "@zaip-ai/dashboard-operations/contracts";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import type { DashboardApiClient, OperationsPageFilters, WorkBoardStage } from "./dashboard-api.js";
 import type { OperationsPeriodState } from "./operations-period.js";
 import { useAppWorkBoard } from "./use-app-work-board.js";

package/templates/.agents/dashboard/apps/frontend/src/workspace-status.css

@@ -8,21 +8,8 @@
   border-bottom: 1px solid var(--border, rgba(255, 255, 255, 0.12));
   font-size: 12px;
 }
-.dashboard-header {
-  top: var(--dashboard-workspace-height, 0px);
-}
-.workspace-status__identity {
-  display: flex;
-  flex-wrap: wrap;
-  gap: 4px 16px;
-  align-items: baseline;
-}
-.workspace-status__identity span {
-  overflow-wrap: anywhere;
-  min-width: 0;
-}
 .workspace-status__warning {
-  margin: 8px 0;
+  margin: 0;
   color: var(--error-text, #fecaca);
 }
 .workspace-status__warning p {

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

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/dashboard-cost-monitor",
-  "version": "3.4.0",
+  "version": "3.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": "3.4.0",
+  "version": "3.6.0",
   "private": true,
   "type": "module",
   "exports": {

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

@@ -1,6 +1,6 @@
 import type { OperationsLocale } from "./status-labels.js";
 import { riskLabel } from "./status-labels.js";
-import { taskOriginLabel, taskOriginOptions, type TaskOrigin } from "./task-origin.js";
+import { type TaskOrigin, taskOriginLabel, taskOriginOptions } from "./task-origin.js";
 import { workStageLabel, workStages } from "./work-board-model.js";
 
 /** Work filters belong to the visible shared header, not the retired hero. */

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

@@ -4,10 +4,10 @@ import { formatRoundedDuration } from "./format-rounded-duration.js";
 import type { OperationsLocale } from "./status-labels.js";
 import { WorkTypeFilters } from "./UnifiedWorkBoard.js";
 import {
-  workStageLabel,
-  workStages,
   type WorkStage,
   type WorkTypeFilter,
+  workStageLabel,
+  workStages,
 } from "./work-board-model.js";
 
 export type PagedWorkListRow = Record<string, unknown>;

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

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

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

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/dashboard-branding",
-  "version": "3.4.0",
+  "version": "3.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": "3.4.0",
+  "version": "3.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": "3.4.0",
+  "version": "3.6.0",
   "private": true,
   "type": "module",
   "exports": {