@zaip-ai/cli 1.4.1 → 1.4.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/cli",
-  "version": "1.4.1",
+  "version": "1.4.2",
   "description": "CLI oficial para instalar e configurar o ZAIP-AIOS em qualquer repositório",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",

package/templates/.agents/dashboard/.zaip-managed.json

@@ -1954,13 +1954,21 @@
       "path": "packages/local-runtime/start-dashboard-refresh.mjs",
       "sha256": "1f95c6e8f97dccae997adbe6bce0761966adc3f4e61f57f9bc13d6b7608ce711"
     },
+    {
+      "path": "packages/local-runtime/start-dashboard-runtime-selection.mjs",
+      "sha256": "1d246e878b43623f3776d16ef10a04c05b9814f52af19330e35f6e80ad8973e4"
+    },
+    {
+      "path": "packages/local-runtime/start-dashboard-runtime-selection.test.mjs",
+      "sha256": "d6b5f5f2906764b44b831a033ed424e2bc7631fb93a75ff7eeb95b3e9bbe377e"
+    },
     {
       "path": "packages/local-runtime/start-dashboard-server.mjs",
       "sha256": "bd048c19fa6686e9de81d3b25626baf1d54c7fba1033d43418d12dd0c691dc93"
     },
     {
       "path": "packages/local-runtime/start-dashboard.mjs",
-      "sha256": "6de1d96848c5b00cad236469893c277ca7660da4d79215abb1917ce5ed1543a3"
+      "sha256": "b1748ab59a760004fbe33c8ea6e07486818b9eb638ed164bc5b3bcdb311ed350"
     },
     {
       "path": "packages/local-runtime/start-dashboard.test.mjs",

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.2"
 ---
 
 # 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.2"
 ---
 
 # 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.2"
 ---
 
 # 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.2"
 ---
 
 # 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.2"
 ---
 
 # 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.2"
 ---
 
 # 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.2"
 ---
 
 # 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.2"
 ---
 
 # 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.2"
 ---
 
 # 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.2"
 ---
 
 # 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.2"
 ---
 
 # 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.2"
 ---
 
 # 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.2"
 ---
 
 # 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.2"
 ---
 
 # 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.2"
 ---
 
 # 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.2"
 ---
 
 # Evidências, custo por Task e autonomia por SPEC

package/templates/template-manifest.json

@@ -1,9 +1,9 @@
 {
   "schemaVersion": 1,
-  "templateVersion": "1.4.1",
-  "minimumCliVersion": "1.4.1",
+  "templateVersion": "1.4.2",
+  "minimumCliVersion": "1.4.2",
   "source": "portable projection of ZAIP Rules, Requirements, skills, design catalog and dashboard runtime",
-  "sourceFilesSha256": "c418748029ab4c1de1d34e2552ef813059e618eec9085fe91125d100f58b9d76",
+  "sourceFilesSha256": "c79a9bfd298939a0c3b0277472a565907730dfacc6762fe3527f11a0c3a10272",
   "files": [
     {
       "path": ".agents/.env.example",
@@ -140,7 +140,7 @@
     },
     {
       "path": ".agents/dashboard/.zaip-managed.json",
-      "sha256": "082dc6db9853ab29f12a1e5e0ef84f0b698596626699a4aae7f9a4f36863d265"
+      "sha256": "0deb177f3ca88065b87877d3d395d433de70622b38543d9e234e47e77bd99d3f"
     },
     {
       "path": ".agents/dashboard/apps/frontend/dist/assets/cost-monitor-DbaLbU2q.js",
@@ -2096,13 +2096,21 @@
       "path": ".agents/dashboard/packages/local-runtime/start-dashboard-refresh.mjs",
       "sha256": "1f95c6e8f97dccae997adbe6bce0761966adc3f4e61f57f9bc13d6b7608ce711"
     },
+    {
+      "path": ".agents/dashboard/packages/local-runtime/start-dashboard-runtime-selection.mjs",
+      "sha256": "1d246e878b43623f3776d16ef10a04c05b9814f52af19330e35f6e80ad8973e4"
+    },
+    {
+      "path": ".agents/dashboard/packages/local-runtime/start-dashboard-runtime-selection.test.mjs",
+      "sha256": "d6b5f5f2906764b44b831a033ed424e2bc7631fb93a75ff7eeb95b3e9bbe377e"
+    },
     {
       "path": ".agents/dashboard/packages/local-runtime/start-dashboard-server.mjs",
       "sha256": "bd048c19fa6686e9de81d3b25626baf1d54c7fba1033d43418d12dd0c691dc93"
     },
     {
       "path": ".agents/dashboard/packages/local-runtime/start-dashboard.mjs",
-      "sha256": "6de1d96848c5b00cad236469893c277ca7660da4d79215abb1917ce5ed1543a3"
+      "sha256": "b1748ab59a760004fbe33c8ea6e07486818b9eb638ed164bc5b3bcdb311ed350"
     },
     {
       "path": ".agents/dashboard/packages/local-runtime/start-dashboard.test.mjs",
@@ -2640,67 +2648,67 @@
     },
     {
       "path": ".agents/requirements/autonomous-assurance.md",
-      "sha256": "50421746860aaf3679fca1e5944920388927ca2a2977082d1b3f274800e5f8f0"
+      "sha256": "6c08ece5c3148496aaee4f0eb488eac603212921409be9776d26765691f7ef22"
     },
     {
       "path": ".agents/requirements/cloud-hostinger-autonomy.md",
-      "sha256": "22a1497b7a9bcadf2783504ec0189f0e61c05052ede36f5d15680d8fae8a5a73"
+      "sha256": "96cafa73250d8c5151a47f842936c26f53c8204b7f97cecaca9640dae59ca91b"
     },
     {
       "path": ".agents/requirements/comparative-audit.md",
-      "sha256": "33785706dc62e3bd102876ac2aaf1f61549bb92e46d7a905ffa70509d9b1328b"
+      "sha256": "a878b01d5eaa162050f76543229d32e3c2b6f0530beeba5b041544af983c3f9f"
     },
     {
       "path": ".agents/requirements/context-engine.md",
-      "sha256": "daffcfe105135462a94d1577ff2eb0334ffd035e56791b44a98cd46e595a644e"
+      "sha256": "839decc31deeb88b42a270cd759bd4ab359c196e471d3224593fe16f252ab8cb"
     },
     {
       "path": ".agents/requirements/cost-observability.md",
-      "sha256": "4f3844eae8f6cf7094e3f084711f72e06362186ec940ade18347b6f792110e5e"
+      "sha256": "d402dfadbe7f3d3bd6ef4d2a39def8fd8f70fa54ae4c46824343329fd431b9c8"
     },
     {
       "path": ".agents/requirements/dashboard-launch.md",
-      "sha256": "fd5f768f165a84f1a9684894e6e4e2f492f7f3d32d931daf68ef9e6c25c05c55"
+      "sha256": "5f8dc0b033a3691a9d84b533d287a75bdf1f0103f17e6715b68b6dd870447448"
     },
     {
       "path": ".agents/requirements/data-export.md",
-      "sha256": "eaa633ef73caa7de8605fb2ed2a0a30908005ea7980b9d602f241ee4a845b14c"
+      "sha256": "b40818e323e9cf661c5fb35a3ece64985ea5edcd7ccf7f32c5ec2e3fda3fa5d1"
     },
     {
       "path": ".agents/requirements/design-system.md",
-      "sha256": "0fc194f6d5ee22542971142a210e64e83fe14cb1636709e4be4ff176d4cc047b"
+      "sha256": "ce288b06809338f0a439f0d52eb1aa93c64e880330e49e9ab4a5a6fd55a3e321"
     },
     {
       "path": ".agents/requirements/execution-engine.md",
-      "sha256": "5ce2b0d24647eee5b7691cc70a0b84de46538c1c69a224e07126465086f3b7a1"
+      "sha256": "990eab8f2a28de01c92041d9a0ee767cf68becc58957520400242dbd8b0d8099"
     },
     {
       "path": ".agents/requirements/kanban-dashboard.md",
-      "sha256": "334fe12ba9e80a30a2b5bea1aaa8381f5ad0252022f8849a55a4d76d19243b3b"
+      "sha256": "5538c829bb59978bd2a6a3bc503f15357036e9012dc8d363b15c2f3602fe21cf"
     },
     {
       "path": ".agents/requirements/model-orchestration.md",
-      "sha256": "7a6b6a0711910d748df937ea2558a382763de6127de259c6a29e92b02f60ab8c"
+      "sha256": "570f5ff3d98046fa018dd8f01718ead94db2f26bb24f62989b5b2e8e302344a7"
     },
     {
       "path": ".agents/requirements/public-distribution.md",
-      "sha256": "cdb3bc921966ce748b28ff3a576e5a530763030e000705f4529f33358b5e31aa"
+      "sha256": "90440a969629112b1256f67bd03c7aa0cc360b9958e247d90346a81b719c38cd"
     },
     {
       "path": ".agents/requirements/software-architecture.md",
-      "sha256": "951fe42a07845f4368f843ad5b8772eb0ebf2b24d1519dc80d2158e05a81db53"
+      "sha256": "d62766424eae80e3b930c2339b9f6f3572a74a542931cd44d7e0f1e2540e3801"
     },
     {
       "path": ".agents/requirements/strategic-improvements.md",
-      "sha256": "90dddf17f0c3b700762150f9137d228a32c71885085bceeb0fedc2966b1d7a94"
+      "sha256": "ff7ee8f67f802c06de6aeed10ec84b1a22a71183b732b13d240a095f607209a8"
     },
     {
       "path": ".agents/requirements/work-lifecycle.md",
-      "sha256": "56b67bfcaba3d7116c695f7c1687f6ee5cc23f1d1edfc1f7b5690abd8d57d574"
+      "sha256": "8c364f8c217513bd9916b9dd7658ae280e6b653425ba0e7d6ee6db7dd5cc7717"
     },
     {
       "path": ".agents/requirements/zaip-strategic-95.md",
-      "sha256": "236944193197c9588a9253ead9e3e91c05e3c14ce695beb756cf2c7a4509164a"
+      "sha256": "7ac30271194e4a3830f65d88f858ff4dea1e126daa7a50e024444f1d5db12b5c"
     },
     {
       "path": ".agents/rules/architecture.md",