@zaip-ai/cli 1.4.1 → 1.4.3

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

@@ -0,0 +1,36 @@
+import { readFile, stat } from "node:fs/promises";
+import { resolve } from "node:path";
+
+async function exists(path) {
+  return stat(path).then(
+    () => true,
+    () => false,
+  );
+}
+
+export async function isDashboardSourceWorkspace(root) {
+  if (!(await exists(resolve(root, "pnpm-workspace.yaml")))) return false;
+  try {
+    return (
+      JSON.parse(await readFile(resolve(root, "package.json"), "utf8"))?.name === "@zaip-ai/aios"
+    );
+  } catch {
+    return false;
+  }
+}
+
+export async function dashboardServerPathForWorkspace({ root, sourcePath, installedPath }) {
+  return (await isDashboardSourceWorkspace(root)) && (await exists(sourcePath))
+    ? sourcePath
+    : installedPath;
+}
+
+export async function assertInstalledDashboardArtifacts(paths) {
+  const missing = (
+    await Promise.all(paths.map(async (path) => ((await exists(path)) ? null : path)))
+  ).filter(Boolean);
+  if (missing.length > 0)
+    throw new Error(
+      "Dashboard package artifacts are missing; reinstall ZAIP-AIOS to restore the bundled dashboard.",
+    );
+}

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

@@ -0,0 +1,63 @@
+import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+import { dashboardServerPathForWorkspace, isDashboardSourceWorkspace } from "./start-dashboard.mjs";
+import { assertInstalledDashboardArtifacts } from "./start-dashboard-runtime-selection.mjs";
+
+const roots = [];
+
+afterEach(async () => {
+  await Promise.all(roots.splice(0).map((root) => rm(root, { recursive: true, force: true })));
+});
+
+describe("installed dashboard runtime selection", () => {
+  it("uses the installed runtime for a consumer with partial build tooling", async () => {
+    const root = await mkdtemp(join(tmpdir(), "zaip-dashboard-consumer-"));
+    roots.push(root);
+    const sourcePath = join(root, ".agents/dashboard/packages/local-runtime/dist/server.cjs");
+    const installedPath = join(root, ".agents/dashboard/packages/local-runtime/server.mjs");
+    await Promise.all([
+      mkdir(join(root, ".agents/dashboard/apps/frontend/dist"), { recursive: true }),
+      mkdir(join(root, ".agents/dashboard/packages/local-runtime/dist"), { recursive: true }),
+    ]);
+    await Promise.all([
+      mkdir(join(root, "node_modules/esbuild"), { recursive: true }),
+      mkdir(join(root, "node_modules/vite"), { recursive: true }),
+      writeFile(join(root, "package.json"), '{"name":"consumer-project"}\n'),
+      writeFile(join(root, "pnpm-workspace.yaml"), "packages: []\n"),
+      writeFile(join(root, ".agents/dashboard/apps/frontend/dist/index.html"), "bundle\n"),
+      writeFile(sourcePath, "source\n"),
+      writeFile(installedPath, "installed\n"),
+    ]);
+
+    expect(await isDashboardSourceWorkspace(root)).toBe(false);
+    await expect(
+      dashboardServerPathForWorkspace({ root, sourcePath, installedPath }),
+    ).resolves.toBe(installedPath);
+  });
+
+  it("selects source only for the explicit ZAIP workspace identity", async () => {
+    const root = await mkdtemp(join(tmpdir(), "zaip-dashboard-source-"));
+    roots.push(root);
+    const sourcePath = join(root, "server.cjs");
+    const installedPath = join(root, "server.mjs");
+    await Promise.all([
+      writeFile(join(root, "package.json"), '{"name":"@zaip-ai/aios"}\n'),
+      writeFile(join(root, "pnpm-workspace.yaml"), "packages: []\n"),
+      writeFile(sourcePath, "source\n"),
+      writeFile(installedPath, "installed\n"),
+    ]);
+
+    expect(await isDashboardSourceWorkspace(root)).toBe(true);
+    await expect(
+      dashboardServerPathForWorkspace({ root, sourcePath, installedPath }),
+    ).resolves.toBe(sourcePath);
+  });
+
+  it("rejects an incomplete consumer bundle without attempting a source build", async () => {
+    await expect(
+      assertInstalledDashboardArtifacts(["missing-server.mjs", "missing-index.html"]),
+    ).rejects.toThrow("reinstall ZAIP-AIOS");
+  });
+});

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

@@ -22,6 +22,11 @@ import {
   stopProcessTree,
   teardownWarning,
 } from "./start-dashboard-processes.mjs";
+import {
+  assertInstalledDashboardArtifacts,
+  isDashboardSourceWorkspace as hasDashboardSourceWorkspace,
+  dashboardServerPathForWorkspace as selectDashboardServerPath,
+} from "./start-dashboard-runtime-selection.mjs";
 import {
   isPortFree,
   startDashboardServer as launchDashboardServer,
@@ -557,31 +562,22 @@ export async function refreshDashboardBuildTargets({
   return { artifacts: Object.values(targets).flatMap((target) => target.artifacts), builtTargets };
 }
 async function ensureFreshDashboardBuild(onProgress = () => {}) {
-  // npm consumers receive a ready-to-run server and frontend bundle. They do
-  // not receive development-only esbuild, so never turn the first dashboard
-  // click into a pnpm-install requirement when that packaged runtime exists.
-  const buildTool = resolve(workspaceRoot, "node_modules/esbuild");
-  if (!(await exists(buildTool))) {
+  if (!(await hasDashboardSourceWorkspace(workspaceRoot))) {
     const packagedArtifacts = [installedServer, resolve(frontendRoot, "index.html")];
-    if (
-      await Promise.all(packagedArtifacts.map((path) => exists(path))).then((entries) =>
-        entries.every(Boolean),
-      )
-    ) {
-      buildProgress(
-        onProgress,
-        39,
-        "Usando runtime empacotado",
-        "O pacote npm já inclui o dashboard pronto; nenhuma instalação de desenvolvimento é necessária.",
-      );
-      const signature = await Promise.all(
-        [...packagedArtifacts, resolve(packageRoot, "start-dashboard.mjs")].map(async (path) => {
-          const details = await stat(path);
-          return `${path}:${details.size}:${details.mtimeMs}`;
-        }),
-      );
-      return createHash("sha256").update(signature.join("|")).digest("hex");
-    }
+    await assertInstalledDashboardArtifacts(packagedArtifacts);
+    buildProgress(
+      onProgress,
+      39,
+      "Usando runtime empacotado",
+      "O pacote npm já inclui o dashboard pronto; nenhuma instalação de desenvolvimento é necessária.",
+    );
+    const signature = await Promise.all(
+      [...packagedArtifacts, resolve(packageRoot, "start-dashboard.mjs")].map(async (path) => {
+        const details = await stat(path);
+        return `${path}:${details.size}:${details.mtimeMs}`;
+      }),
+    );
+    return createHash("sha256").update(signature.join("|")).digest("hex");
   }
   const { artifacts } = await refreshDashboardBuildTargets({ onProgress });
   const artifactFingerprint = await Promise.all(
@@ -592,6 +588,16 @@ async function ensureFreshDashboardBuild(onProgress = () => {}) {
   );
   return createHash("sha256").update(artifactFingerprint.join("|")).digest("hex");
 }
+export async function isDashboardSourceWorkspace(root = workspaceRoot) {
+  return hasDashboardSourceWorkspace(root);
+}
+export async function dashboardServerPathForWorkspace({
+  root = workspaceRoot,
+  sourcePath = sourceServer,
+  installedPath = installedServer,
+} = {}) {
+  return selectDashboardServerPath({ root, sourcePath, installedPath });
+}
 export async function withLauncherLock(
   action,
   {
@@ -766,10 +772,7 @@ async function redirectLaunchPage(launchPage, target) {
   launchPage.closeAfterHandoffGrace();
 }
 async function assertRuntimeReady() {
-  const serverPath =
-    (await exists(resolve(workspaceRoot, "node_modules/esbuild"))) && (await exists(sourceServer))
-      ? sourceServer
-      : installedServer;
+  const serverPath = await dashboardServerPathForWorkspace();
   if (!(await exists(serverPath))) {
     throw new Error(
       "Dashboard server bundle is missing; run the ZAIP release build or reinstall ZAIP-AIOS",

package/templates/.agents/requirements/autonomous-assurance.md

@@ -6,7 +6,7 @@ title: Garantia adaptativa e execução autônoma
 status: active
 version: 3
 source_change: null
-source_release: "1.4.1"
+source_release: "1.4.3"
 ---
 
 # Garantia adaptativa e execução autônoma

package/templates/.agents/requirements/cloud-hostinger-autonomy.md

@@ -6,7 +6,7 @@ title: Autonomia delimitada para Cloudflare e Hostinger
 status: proposed
 version: 1
 source_change: null
-source_release: "1.4.1"
+source_release: "1.4.3"
 ---
 
 # Cloudflare e Hostinger (proposta de requisito)

package/templates/.agents/requirements/comparative-audit.md

@@ -6,7 +6,7 @@ title: Auditoria comparativa e plano de evolução
 status: active
 version: 1
 source_change: null
-source_release: "1.4.1"
+source_release: "1.4.3"
 ---
 
 # Auditoria comparativa e plano de evolução

package/templates/.agents/requirements/context-engine.md

@@ -6,7 +6,7 @@ title: Contexto mínimo, seguro e navegável
 status: active
 version: 8
 source_change: null
-source_release: "1.4.1"
+source_release: "1.4.3"
 ---
 
 # Context engine

package/templates/.agents/requirements/cost-observability.md

@@ -6,7 +6,7 @@ title: Tokens, custos e cobertura
 status: active
 version: 10
 source_change: null
-source_release: "1.4.1"
+source_release: "1.4.3"
 ---
 
 # Cost observability

package/templates/.agents/requirements/dashboard-launch.md

@@ -6,7 +6,7 @@ title: Inicialização e hidratação confiável do dashboard
 status: active
 version: 1
 source_change: null
-source_release: "1.4.1"
+source_release: "1.4.3"
 ---
 
 # Inicialização e hidratação confiável do dashboard

package/templates/.agents/requirements/data-export.md

@@ -6,7 +6,7 @@ title: Exportação contextual de dados para Excel
 status: proposed
 version: 2
 source_change: null
-source_release: "1.4.1"
+source_release: "1.4.3"
 ---
 
 # Exportação contextual de dados

package/templates/.agents/requirements/design-system.md

@@ -6,7 +6,7 @@ title: Contrato visual e catálogo executável
 status: active
 version: 3
 source_change: null
-source_release: "1.4.1"
+source_release: "1.4.3"
 ---
 
 # Design system

package/templates/.agents/requirements/execution-engine.md

@@ -6,7 +6,7 @@ title: Preparação, materialização e DAG
 status: active
 version: 11
 source_change: null
-source_release: "1.4.1"
+source_release: "1.4.3"
 ---
 
 # Execution engine

package/templates/.agents/requirements/kanban-dashboard.md

@@ -6,7 +6,7 @@ title: Projeções operacionais e analíticas
 status: active
 version: 14
 source_change: null
-source_release: "1.4.1"
+source_release: "1.4.3"
 ---
 
 # Kanban and dashboard

package/templates/.agents/requirements/model-orchestration.md

@@ -6,7 +6,7 @@ title: Seleção automática e observável de modelo e effort
 status: active
 version: 7
 source_change: null
-source_release: "1.4.1"
+source_release: "1.4.3"
 ---
 
 # Orquestração de modelos

package/templates/.agents/requirements/public-distribution.md

@@ -6,7 +6,7 @@ title: Distribuição pública e ativação
 status: active
 version: 3
 source_change: null
-source_release: "1.4.1"
+source_release: "1.4.3"
 ---
 
 # Distribuição pública e ativação

package/templates/.agents/requirements/software-architecture.md

@@ -6,7 +6,7 @@ title: Layout modular e limites de código-fonte
 status: active
 version: 5
 source_change: null
-source_release: "1.4.1"
+source_release: "1.4.3"
 ---
 
 # Software architecture

package/templates/.agents/requirements/strategic-improvements.md

@@ -6,7 +6,7 @@ title: Melhorias estratégicas de custo, qualidade e resiliência
 status: active
 version: 1
 source_change: null
-source_release: "1.4.1"
+source_release: "1.4.3"
 ---
 
 # Melhorias estratégicas de custo, qualidade e resiliência

package/templates/.agents/requirements/work-lifecycle.md

@@ -6,7 +6,7 @@ title: Ciclo de vida do trabalho
 status: active
 version: 24
 source_change: null
-source_release: "1.4.1"
+source_release: "1.4.3"
 ---
 
 # Work lifecycle

package/templates/.agents/requirements/zaip-strategic-95.md

@@ -6,7 +6,7 @@ title: Evidências, custo por Task e autonomia por SPEC
 status: active
 version: 1
 source_change: null
-source_release: "1.4.1"
+source_release: "1.4.3"
 ---
 
 # Evidências, custo por Task e autonomia por SPEC