@zaip-ai/cli 1.3.6 → 1.3.8

package/templates/.agents/dashboard/packages/local-runtime/src/project-settings.test.ts

@@ -424,4 +424,157 @@ describe("project settings persistence", () => {
       "growth_strategy",
     ]);
   });
+
+  it("reports the project-local installed version separately from configured stack versions", async () => {
+    const { filesystem } = await fixtureProject();
+    const current = await readProjectSettings(filesystem);
+    await filesystem.writeTextAtomic(
+      PROJECT_CONFIG_PATH,
+      serializeYaml({
+        ...current,
+        stack: {
+          ...current.stack,
+          overrides: {
+            ...current.stack.overrides,
+            components: { backend_api: { name: "Hono", version: "4.12.34" } },
+          },
+        },
+      }),
+    );
+    await filesystem.writeTextAtomic(
+      ".agents/dashboard/stack-dependencies.json",
+      JSON.stringify({
+        schema_version: 1,
+        node: "22.16.0",
+        packages: [
+          { name: "typescript", version: "7.0.2", development: true },
+          { name: "redis", version: "6.2.1", development: false },
+          { name: "hono", version: "4.12.33", development: false },
+        ],
+      }),
+    );
+    await mkdir(join(filesystem.root, "node_modules", "hono"), { recursive: true });
+    await writeFile(
+      join(filesystem.root, "node_modules", "hono", "package.json"),
+      JSON.stringify({ name: "hono", version: "4.12.35", main: "index.js" }),
+      "utf8",
+    );
+    await writeFile(
+      join(filesystem.root, "node_modules", "hono", "index.js"),
+      "export {};",
+      "utf8",
+    );
+
+    const overview = await readProjectOverview(filesystem);
+
+    expect(overview.stack_components).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({
+          name: "Hono",
+          version: "4.12.35",
+          configured_version: "4.12.34",
+          source: "node_modules/hono/package.json",
+          installation: "installed",
+          verification: "exact",
+        }),
+        expect.objectContaining({
+          name: "TypeScript",
+          version: null,
+          configured_version: "7.0.2",
+          installation: "missing",
+          verification: "unavailable",
+        }),
+        expect.objectContaining({
+          name: "Redis",
+          version: null,
+          configured_version: "6.2.1",
+          installation: "missing",
+          verification: "unavailable",
+        }),
+      ]),
+    );
+  });
+
+  it("only reports Hono and React as bundled when their dashboard artifacts exist", async () => {
+    const { filesystem } = await fixtureProject();
+    await filesystem.writeTextAtomic(
+      ".agents/dashboard/stack-dependencies.json",
+      JSON.stringify({
+        schema_version: 1,
+        node: "22.16.0",
+        packages: [
+          { name: "hono", version: "4.12.34", development: false },
+          { name: "react", version: "19.2.7", development: false },
+        ],
+      }),
+    );
+    const absent = await readProjectOverview(filesystem);
+    expect(absent.stack_components).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({ name: "Hono", installation: "missing", version: null }),
+        expect.objectContaining({ name: "React", installation: "missing", version: null }),
+      ]),
+    );
+
+    await filesystem.writeTextAtomic(
+      ".agents/dashboard/packages/local-runtime/server.mjs",
+      "/* bundled runtime */",
+    );
+    await filesystem.writeTextAtomic(
+      ".agents/dashboard/apps/frontend/dist/assets/index.js",
+      "/* bundled frontend */",
+    );
+    const bundled = await readProjectOverview(filesystem);
+    expect(bundled.stack_components).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({
+          name: "Hono",
+          version: null,
+          configured_version: "4.12.34",
+          installation: "bundled",
+          source: ".agents/dashboard/packages/local-runtime/server.mjs",
+        }),
+        expect.objectContaining({
+          name: "React",
+          version: null,
+          configured_version: "19.2.7",
+          installation: "bundled",
+          source: ".agents/dashboard/apps/frontend/dist",
+        }),
+      ]),
+    );
+  });
+
+  it("does not accept a local package without its matching identity and entrypoint", async () => {
+    const { filesystem } = await fixtureProject();
+    await mkdir(join(filesystem.root, "node_modules", "hono"), { recursive: true });
+    await writeFile(
+      join(filesystem.root, "node_modules", "hono", "package.json"),
+      JSON.stringify({ name: "not-hono", version: "4.12.35", main: "index.js" }),
+      "utf8",
+    );
+    await writeFile(
+      join(filesystem.root, "node_modules", "hono", "index.js"),
+      "export {};",
+      "utf8",
+    );
+
+    const mismatched = await readProjectOverview(filesystem);
+    expect(mismatched.stack_components).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({ name: "Hono", installation: "missing", version: null }),
+      ]),
+    );
+
+    await filesystem.writeTextAtomic(
+      "node_modules/hono/package.json",
+      JSON.stringify({ name: "hono", version: "4.12.35", main: "missing.js" }),
+    );
+    const incomplete = await readProjectOverview(filesystem);
+    expect(incomplete.stack_components).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({ name: "Hono", installation: "missing", version: null }),
+      ]),
+    );
+  });
 });

package/templates/.agents/dashboard/packages/local-runtime/src/project-settings.ts

@@ -12,6 +12,7 @@ const AGENT_CATALOG_PATH = ".agents/config/agents/catalog.yaml";
 const CODEX_CONFIG_PATH = ".codex/config.toml";
 const FRAMEWORK_LOCK_PATH = ".agents/config/framework.lock.yaml";
 const SQLITE_READ_MODEL_PATH = ".local/dashboard-sqlite/read-model.sqlite";
+const DASHBOARD_STACK_DEPENDENCIES_PATH = ".agents/dashboard/stack-dependencies.json";
 export const SOFTWARE_ARCHITECTURE_PATH = ".agents/architecture/software-architecture.md";
 
 export type ProjectOverview = {
@@ -24,8 +25,10 @@ export type ProjectOverview = {
   stack_components: Array<{
     name: string;
     version: string | null;
+    configured_version: string | null;
     source: string | null;
     verification: "exact" | "constraint" | "unavailable";
+    installation: "runtime" | "installed" | "missing" | "bundled";
   }>;
   areas: Array<{
     id:
@@ -142,63 +145,181 @@ async function countCodexHookEvents(filesystem: WorkspaceFileSystem): Promise<nu
 async function readVerifiedStackComponents(
   filesystem: WorkspaceFileSystem,
 ): Promise<ProjectOverview["stack_components"]> {
-  const [rootPackage, dashboardRuntime, dashboardFrontend] = await Promise.all([
-    readPackageJson(filesystem, "package.json"),
-    readPackageJson(filesystem, ".agents/dashboard/packages/local-runtime/package.json"),
-    readPackageJson(filesystem, ".agents/dashboard/apps/frontend/package.json"),
+  const [project, fallback, bundledRuntime, bundledFrontend] = await Promise.all([
+    readProjectSettings(filesystem),
+    readDashboardStackDependencies(filesystem),
+    hasNonEmptyFile(filesystem, ".agents/dashboard/packages/local-runtime/server.mjs"),
+    hasBundledDashboardFrontend(filesystem),
   ]);
-  return [
-    component("Node.js", process.versions.node, `Runtime observado: ${process.execPath}`, "exact"),
-    component("TypeScript", packageVersion(rootPackage, "typescript"), "package.json", "exact"),
-    component("Vite", packageVersion(rootPackage, "vite"), "package.json", "exact"),
-    component("Astro", packageVersion(rootPackage, "astro"), "package.json", "exact"),
-    component("Redis", packageVersion(rootPackage, "redis"), "package.json", "exact"),
-    component("BullMQ", packageVersion(rootPackage, "bullmq"), "package.json", "exact"),
-    component(
-      "Hono",
-      packageVersion(dashboardRuntime, "hono"),
-      ".agents/dashboard/packages/local-runtime/package.json",
-      "exact",
-    ),
-    component(
-      "React",
-      packageVersion(dashboardFrontend, "react"),
-      ".agents/dashboard/apps/frontend/package.json",
-      "exact",
+  const configured = configuredStackVersions(project, fallback);
+  const packages = await Promise.all(
+    ["typescript", "vite", "astro", "redis", "bullmq", "hono", "react"].map((name) =>
+      readInstalledPackageVersion(filesystem, name),
     ),
+  );
+  const installed = new Map(packages.map((item) => [item.name, item]));
+  return [
+    runtimeComponent("Node.js", process.versions.node, configured.get("node")),
+    packageComponent("TypeScript", "typescript", configured.get("typescript"), installed),
+    packageComponent("Vite", "vite", configured.get("vite"), installed),
+    packageComponent("Astro", "astro", configured.get("astro"), installed),
+    packageComponent("Redis", "redis", configured.get("redis"), installed),
+    packageComponent("BullMQ", "bullmq", configured.get("bullmq"), installed),
+    packageComponent("Hono", "hono", configured.get("hono"), installed, bundledRuntime),
+    packageComponent("React", "react", configured.get("react"), installed, bundledFrontend),
   ];
 }
 
-type PackageJson = {
-  dependencies?: Record<string, string>;
-  devDependencies?: Record<string, string>;
-};
+type InstalledPackage = { name: string; version: string | null };
+type DashboardStackDependencies = { node: string | null; packages: Map<string, string> };
 
-async function readPackageJson(
+async function readInstalledPackageVersion(
   filesystem: WorkspaceFileSystem,
-  path: string,
-): Promise<PackageJson> {
+  name: string,
+): Promise<InstalledPackage> {
   try {
-    const value = JSON.parse(await filesystem.readText(path)) as unknown;
-    return typeof value === "object" && value !== null ? (value as PackageJson) : {};
+    const value = recordValue(
+      JSON.parse(await filesystem.readText(`node_modules/${name}/package.json`)),
+    );
+    const version = stringValue(value.version);
+    const entrypoint = packageEntrypoint(value);
+    if (
+      value.name !== name ||
+      version === null ||
+      !/^\d+\.\d+\.\d+(?:-[\w.-]+)?(?:\+[\w.-]+)?$/.test(version) ||
+      entrypoint === null
+    )
+      return { name, version: null };
+    await filesystem.readText(`node_modules/${name}/${entrypoint}`);
+    return { name, version };
   } catch {
-    return {};
+    return { name, version: null };
   }
 }
 
-function packageVersion(pkg: PackageJson, name: string): string | null {
-  return pkg.dependencies?.[name] ?? pkg.devDependencies?.[name] ?? null;
+async function readDashboardStackDependencies(
+  filesystem: WorkspaceFileSystem,
+): Promise<DashboardStackDependencies> {
+  try {
+    const source = recordValue(
+      JSON.parse(await filesystem.readText(DASHBOARD_STACK_DEPENDENCIES_PATH)),
+    );
+    const packages = new Map<string, string>();
+    for (const item of Array.isArray(source.packages) ? source.packages : []) {
+      const definition = recordValue(item);
+      const name = stringValue(definition.name);
+      const version = stringValue(definition.version);
+      if (name !== null && version !== null) packages.set(name, version);
+    }
+    return { node: stringValue(source.node), packages };
+  } catch {
+    return { node: null, packages: new Map() };
+  }
+}
+
+function configuredStackVersions(
+  project: ProjectConfig,
+  fallback: DashboardStackDependencies,
+): Map<string, string> {
+  const components = recordValue(recordValue(project.stack.overrides).components);
+  const configured = new Map(fallback.packages);
+  if (fallback.node !== null) configured.set("node", fallback.node);
+  for (const [component, packageName] of Object.entries({
+    backend_runtime: "node",
+    primary_language: "typescript",
+    web_language: "typescript",
+    web_build: "vite",
+    site_framework: "astro",
+    cache_messaging: "redis",
+    async_queue: "bullmq",
+    backend_api: "hono",
+    web_framework: "react",
+  })) {
+    const version = stringValue(recordValue(components[component]).version);
+    if (version !== null) configured.set(packageName, version);
+  }
+  return configured;
 }
 
-function component(
+async function hasBundledDashboardFrontend(filesystem: WorkspaceFileSystem): Promise<boolean> {
+  try {
+    return (await filesystem.listFiles(".agents/dashboard/apps/frontend/dist", ".js")).length > 0;
+  } catch {
+    return false;
+  }
+}
+
+async function hasNonEmptyFile(filesystem: WorkspaceFileSystem, path: string): Promise<boolean> {
+  try {
+    return (await filesystem.readText(path)).trim().length > 0;
+  } catch {
+    return false;
+  }
+}
+
+function runtimeComponent(
   name: string,
   version: string | null,
-  source: string,
-  verification: "exact" | "constraint",
+  configuredVersion: string | undefined,
+): ProjectOverview["stack_components"][number] {
+  return {
+    name,
+    version,
+    configured_version: configuredVersion ?? null,
+    source: `Runtime do Dashboard: ${process.execPath}`,
+    verification: "exact",
+    installation: "runtime",
+  };
+}
+
+function packageComponent(
+  name: string,
+  packageName: string,
+  configuredVersion: string | undefined,
+  installed: ReadonlyMap<string, InstalledPackage>,
+  bundled = false,
 ): ProjectOverview["stack_components"][number] {
-  return version === null
-    ? { name, version: null, source: null, verification: "unavailable" }
-    : { name, version, source, verification };
+  const actual = installed.get(packageName)?.version ?? null;
+  if (actual !== null)
+    return {
+      name,
+      version: actual,
+      configured_version: configuredVersion ?? null,
+      source: `node_modules/${packageName}/package.json`,
+      verification: "exact",
+      installation: "installed",
+    };
+  if (bundled)
+    return {
+      name,
+      version: null,
+      configured_version: configuredVersion ?? null,
+      source:
+        packageName === "hono"
+          ? ".agents/dashboard/packages/local-runtime/server.mjs"
+          : ".agents/dashboard/apps/frontend/dist",
+      verification: configuredVersion === undefined ? "unavailable" : "constraint",
+      installation: "bundled",
+    };
+  return {
+    name,
+    version: null,
+    configured_version: configuredVersion ?? null,
+    source: null,
+    verification: "unavailable",
+    installation: "missing",
+  };
+}
+
+function stringValue(value: unknown): string | null {
+  return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+
+function packageEntrypoint(pkg: Record<string, unknown>): string | null {
+  if (typeof pkg.bin === "string") return pkg.bin;
+  const bin = Object.values(recordValue(pkg.bin)).find((value) => typeof value === "string");
+  if (typeof bin === "string") return bin;
+  return stringValue(pkg.main);
 }
 
 export async function persistProjectSettings(

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

@@ -19,22 +19,22 @@ export async function ensureDashboardRecordsDirectory(root) {
 }
 
 export async function assertDashboardPrerequisites(workspaceRoot) {
-  const major = Number.parseInt(process.versions.node.split(".")[0] ?? "", 10);
-  if (!Number.isInteger(major) || major < 22)
+  const [major, minor] = process.versions.node.split(".").map(Number);
+  if (!Number.isInteger(major) || major < 22 || (major === 22 && minor < 16))
     throw new Error(
-      `O Dashboard SQLite requer Node.js 22 ou superior; a versão encontrada foi ${process.versions.node}. Instale o Node.js 22 e tente novamente.`,
+      `O Dashboard SQLite requer Node.js 22.16.0 ou superior; a versão encontrada foi ${process.versions.node}. Atualize o Node.js e tente novamente.`,
     );
   try {
     await import("node:sqlite");
   } catch {
     throw new Error(
-      "O Node.js instalado não disponibiliza node:sqlite. Reinstale uma versão suportada do Node.js 22 ou superior.",
+      "O Node.js instalado não disponibiliza node:sqlite. Reinstale o Node.js 22.16.0 ou superior com suporte a SQLite.",
     );
   }
   await ensureDashboardRecordsDirectory(workspaceRoot);
   const required = resolve(workspaceRoot, ".agents/config");
   if (!(await exists(required)))
     throw new Error(
-      `Pré-requisito do Dashboard SQLite ausente: ${relative(workspaceRoot, required) || required}. Execute corepack pnpm install na raiz do ZAIP-AIOS e tente novamente.`,
+      `Pré-requisito do Dashboard SQLite ausente: ${relative(workspaceRoot, required) || required}. Execute npx @zaip-ai/cli@latest init na raiz do projeto e tente novamente.`,
     );
 }

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

@@ -35,4 +35,12 @@ describe("dashboard SQLite prerequisites", () => {
     await expect(assertDashboardPrerequisites(root)).resolves.toBeUndefined();
     await expect(access(join(root, ".agents", "records"))).resolves.toBeUndefined();
   });
+
+  it("directs incomplete consumers to init instead of a development install", async () => {
+    const root = await mkdtemp(join(tmpdir(), "zaip-dashboard-missing-config-"));
+    temporaryDirectories.push(root);
+    await expect(assertDashboardPrerequisites(root)).rejects.toThrow(
+      "npx @zaip-ai/cli@latest init",
+    );
+  });
 });

package/templates/.agents/dashboard/stack-dependencies.json

@@ -0,0 +1,14 @@
+{
+  "schema_version": 1,
+  "node": "22.16.0",
+  "packages": [
+    { "name": "typescript", "version": "7.0.2", "development": true },
+    { "name": "vite", "version": "8.1.4", "development": true },
+    { "name": "astro", "version": "7.2.4", "development": true },
+    { "name": "redis", "version": "6.2.1", "development": false },
+    { "name": "bullmq", "version": "6.2.0", "development": false },
+    { "name": "hono", "version": "4.12.34", "development": false },
+    { "name": "react", "version": "19.2.7", "development": false },
+    { "name": "react-dom", "version": "19.2.7", "development": false }
+  ]
+}

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.3.6"
+source_release: "1.3.8"
 ---
 
 # Garantia adaptativa e execução autônoma

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.3.6"
+source_release: "1.3.8"
 ---
 
 # 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.3.6"
+source_release: "1.3.8"
 ---
 
 # 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.3.6"
+source_release: "1.3.8"
 ---
 
 # 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.3.6"
+source_release: "1.3.8"
 ---
 
 # 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.3.6"
+source_release: "1.3.8"
 ---
 
 # 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.3.6"
+source_release: "1.3.8"
 ---
 
 # 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.3.6"
+source_release: "1.3.8"
 ---
 
 # 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.3.6"
+source_release: "1.3.8"
 ---
 
 # 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.3.6"
+source_release: "1.3.8"
 ---
 
 # 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.3.6"
+source_release: "1.3.8"
 ---
 
 # 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.3.6"
+source_release: "1.3.8"
 ---
 
 # 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.3.6"
+source_release: "1.3.8"
 ---
 
 # 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.3.6"
+source_release: "1.3.8"
 ---
 
 # 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.3.6"
+source_release: "1.3.8"
 ---
 
 # Evidências, custo por Task e autonomia por SPEC

package/templates/README.md

@@ -55,7 +55,7 @@ A atualização documental não aprova uma release. Consulte o [registro de limi
 
 ## Instalação em um comando
 
-Com Git e uma versão compatível de Node.js, a instalação acontece na raiz do repositório que receberá o ZAIP-AIOS. O pacote declara Node.js 22+; para o Dashboard com `node:sqlite`, use uma versão que disponibilize esse módulo (o ambiente de referência deste checkout usa 22.16.0), não qualquer versão inicial da série 22:
+Com Node.js 22.16.0 ou superior e npm, execute a instalação na raiz do projeto que receberá o ZAIP-AIOS. O `init` instala automaticamente as dependências ausentes da stack (TypeScript, Vite, Astro, cliente Redis, BullMQ, Hono, React e React DOM), verifica os runtimes distribuídos e prepara e valida o SQLite local. Um projeto novo recebe `package.json` e lockfile; versões locais existentes são preservadas e o retorno informa a versão encontrada e a configurada no ZAIP-AIOS. Não é necessário um driver SQLite separado:
 
 ```bash
 npx @zaip-ai/cli@latest init