@zaip-ai/cli 5.0.0 → 5.2.0

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

@@ -25,6 +25,7 @@ export function OperationsPageOverview({
   locale,
   onOpenTask,
   onOpenDocument,
+  onOpenMacro,
   onLoadStatus,
   statusPage,
   onLoadStatusPage,
@@ -55,6 +56,7 @@ export function OperationsPageOverview({
   locale: OperationsLocale;
   onOpenTask: OverviewProps["onOpenTask"];
   onOpenDocument: OverviewProps["onOpenDocument"];
+  onOpenMacro: OverviewProps["onOpenMacro"];
   onLoadStatus: OverviewProps["onLoadStatus"];
   statusPage: OverviewProps["statusPage"];
   onLoadStatusPage: OverviewProps["onLoadStatusPage"];
@@ -96,6 +98,7 @@ export function OperationsPageOverview({
         }}
         onOpenTask={onOpenTask}
         onOpenDocument={onOpenDocument}
+        onOpenMacro={onOpenMacro}
         onLoadStatus={onLoadStatus}
         statusPage={statusPage}
         onLoadStatusPage={onLoadStatusPage}

package/templates/.agents/dashboard/modules/operations/src/react/operations-overview-contract.ts

@@ -0,0 +1,51 @@
+import type { OperationsProjection } from "../contracts.js";
+import type { OperationDatePreset, OperationDateRange } from "./operation-date-range.js";
+import type {
+  FactualCostFact,
+  OverviewClassification,
+  OverviewClassificationPage,
+  OverviewStatusKind,
+  OverviewStatusPage,
+} from "./operations-page-contract.js";
+import type { OperationsLocale } from "./status-labels.js";
+import type { WorkStage } from "./work-board-model.js";
+export interface OperationsOverviewProps {
+  currency: "BRL" | "USD";
+  data: OperationsProjection;
+  /** App-controlled range paired with datePreset; retained by Page while loading. */
+  dateRange?: OperationDateRange;
+  datePreset: OperationDatePreset;
+  locale: OperationsLocale;
+  onDatePresetChange: (preset: OperationDatePreset) => void;
+  onOpenTask: (taskId: string) => Promise<boolean>;
+  onOpenDocument: (kind: "prd" | "spec", id: string) => void;
+  onOpenMacro: (kind: "prd" | "spec", id: string) => void;
+  onLoadStatus?: ((stage: WorkStage, kind: OverviewStatusKind, offset: number) => void) | undefined;
+  statusPage?:
+    | ((stage: WorkStage, kind: OverviewStatusKind) => OverviewStatusPage | undefined)
+    | undefined;
+  onLoadStatusPage?:
+    | ((stage: WorkStage, kind: OverviewStatusKind, offset: number) => void)
+    | undefined;
+  classificationPage?:
+    | ((
+        kind: OverviewStatusKind,
+        classification: OverviewClassification,
+      ) => OverviewClassificationPage | undefined)
+    | undefined;
+  onLoadClassificationPage?:
+    | ((kind: OverviewStatusKind, classification: OverviewClassification, offset: number) => void)
+    | undefined;
+  onLoadMacroMetrics?: (() => void) | undefined;
+  prds?: OperationsProjection["prds"];
+  runs?: OperationsProjection["runs"];
+  specs?: OperationsProjection["specs"];
+  tasks?: OperationsProjection["tasks"];
+  /** Factual Cost Monitor snapshot total for the selected locale/currency. */
+  factualCostTotal?: number | null | undefined;
+  /** Measurement completeness for the matching Cost Monitor snapshot. */
+  factualCostFact?: FactualCostFact | undefined;
+  costLoading?: boolean | undefined;
+  resolveRunCost?: ((runId: string) => number | null) | undefined;
+  includeLegacyEffort?: boolean;
+}

package/templates/.agents/dashboard/modules/operations/src/react/operations-overview-period-filter.test.ts

@@ -118,7 +118,11 @@ describe("overview period filter", () => {
     const periods = readFileSync(new URL("PeriodSummaryTable.tsx", import.meta.url), "utf8");
     const costCard = readFileSync(new URL("OverviewCostKpi.tsx", import.meta.url), "utf8");
 
-    expect(source).toContain('currency: "BRL" | "USD"');
+    const contract = readFileSync(
+      new URL("operations-overview-contract.ts", import.meta.url),
+      "utf8",
+    );
+    expect(contract).toContain('currency: "BRL" | "USD"');
     expect(source).toContain("const selectedCurrencyCost =");
     expect(source).toContain("formatCurrency(value, currency, locale)");
     expect(source).toContain("<OverviewCostKpi");

package/templates/.agents/dashboard/modules/operations/src/react/operations-page-contract.ts

@@ -103,6 +103,7 @@ export interface OperationsPageProps {
   locale: OperationsLocale;
   onLocaleChange: (locale: OperationsLocale) => void;
   onOpenDocument: (kind: "prd" | "spec", id: string) => void;
+  onOpenMacro: (kind: "prd" | "spec", id: string) => void;
   onOpenTask: (taskId: string) => Promise<boolean>;
   onPriorityChange: (itemIds: readonly string[]) => Promise<void>;
   onDetailDataRequest?: (view: OperationsView) => void;

package/templates/.agents/dashboard/modules/operations/src/react/use-operations-default-range.ts

@@ -0,0 +1,16 @@
+import { useMemo } from "react";
+import { factualCostDateRange, initialOperationsDateRange } from "./operation-date-range.js";
+import type { OperationsPageProps } from "./operations-page-contract.js";
+export function useOperationsDefaultRange(
+  data: OperationsPageProps["data"],
+  factualCostPeriods: OperationsPageProps["factualCostPeriods"],
+) {
+  const defaultDateRange = useMemo(() => {
+    const operationsRange = initialOperationsDateRange(
+      data.tasks,
+      Object.keys(data.summary.periods?.daily ?? {}),
+    );
+    return factualCostDateRange(factualCostPeriods?.day, operationsRange);
+  }, [data.summary.periods, data.tasks, factualCostPeriods?.day]);
+  return defaultDateRange;
+}

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

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

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

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

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

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

package/templates/.agents/dashboard/packages/local-runtime/dashboard-build-fingerprint.mjs

@@ -0,0 +1,87 @@
+import { createHash } from "node:crypto";
+import { mkdir, readdir, readFile, rename, stat, writeFile } from "node:fs/promises";
+import { dirname, join, relative, resolve } from "node:path";
+import { dashboardBuildTargets, workspaceRoot } from "./start-dashboard-paths.mjs";
+
+export async function contentFingerprint(paths, excluded = [], root = workspaceRoot) {
+  const entries = new Map();
+  async function visit(path) {
+    const key = relative(root, path).replaceAll("\\", "/");
+    const name = path.replaceAll("\\", "/").split("/").at(-1);
+    if (
+      ["node_modules", ".turbo"].includes(name) ||
+      /\.(test|spec)\./.test(name) ||
+      excluded.some((part) => `/${key}/`.includes(part))
+    )
+      return;
+    const details = await stat(path).catch((error) => {
+      if (error.code === "ENOENT") return null;
+      throw error;
+    });
+    if (!details) {
+      entries.set(key, "missing");
+      return;
+    }
+    if (details.isDirectory()) {
+      entries.set(`${key}/`, "directory");
+      for (const entry of await readdir(path)) await visit(join(path, entry));
+    } else
+      entries.set(
+        key,
+        createHash("sha256")
+          .update(await readFile(path))
+          .digest("hex"),
+      );
+  }
+  for (const path of paths) await visit(path);
+  return createHash("sha256")
+    .update(JSON.stringify([...entries].sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))))
+    .digest("hex");
+}
+
+const receiptPath = (name, root) => resolve(root, ".local/dashboard-build", `${name}.json`);
+export const sourceFingerprint = (target, root = workspaceRoot) =>
+  contentFingerprint(target.sourceRoots, ["/dist/", ...target.excludedSourcePaths], root);
+const outputFingerprint = (target, root) =>
+  contentFingerprint(target.outputRoots ?? target.artifacts, [], root);
+
+export async function inspectBuildFingerprint(name, target, root = workspaceRoot) {
+  const receipt = await readFile(receiptPath(name, root), "utf8")
+    .then(JSON.parse)
+    .catch(() => null);
+  if (receipt?.version !== 1) return false;
+  return (
+    receipt.source === (await sourceFingerprint(target, root)) &&
+    receipt.output === (await outputFingerprint(target, root))
+  );
+}
+
+export async function recordDashboardBuild(
+  name,
+  before,
+  target = dashboardBuildTargets[name],
+  root = workspaceRoot,
+) {
+  const source = await sourceFingerprint(target, root);
+  if (source !== before)
+    throw new Error(
+      `Dashboard ${name} inputs changed during build; no reusable receipt was recorded`,
+    );
+  for (const path of target.artifacts) await stat(path);
+  const receipt = { version: 1, source, output: await outputFingerprint(target, root) };
+  const path = receiptPath(name, root);
+  await mkdir(dirname(path), { recursive: true });
+  const temporary = `${path}.${process.pid}.tmp`;
+  await writeFile(temporary, `${JSON.stringify(receipt)}\n`);
+  await rename(temporary, path);
+}
+
+export async function dashboardReleaseFrozen(root = workspaceRoot) {
+  const text = await readFile(resolve(root, ".agents/config/release-cycle.json"), "utf8").catch(
+    (error) => {
+      if (error.code === "ENOENT") return null;
+      throw error;
+    },
+  );
+  return text !== null && JSON.parse(text).state === "frozen";
+}

package/templates/.agents/dashboard/packages/local-runtime/dashboard-build-fingerprint.test.mjs

@@ -0,0 +1,48 @@
+import assert from "node:assert/strict";
+import { mkdir, mkdtemp, rm, utimes, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { test } from "vitest";
+import {
+  inspectBuildFingerprint,
+  recordDashboardBuild,
+  sourceFingerprint,
+} from "./dashboard-build-fingerprint.mjs";
+import { refreshDashboardBuildTargets } from "./start-dashboard-build.mjs";
+
+test("build reuse follows bytes, includes missing/deleted inputs, and freezes without mutation", async (context) => {
+  const root = await mkdtemp(join(tmpdir(), "zaip-build-fingerprint-"));
+  context.onTestFinished(() => rm(root, { recursive: true, force: true }));
+  await mkdir(join(root, "src"));
+  const source = join(root, "src/readme.md"),
+    output = join(root, "bundle.js");
+  await writeFile(source, "help");
+  await writeFile(output, "bundle");
+  const target = { sourceRoots: [join(root, "src")], excludedSourcePaths: [], artifacts: [output] };
+  await recordDashboardBuild("fixture", await sourceFingerprint(target, root), target, root);
+  await utimes(source, new Date(), new Date(Date.now() + 60_000));
+  assert.equal(await inspectBuildFingerprint("fixture", target, root), true);
+  await writeFile(source, "new help");
+  assert.equal(await inspectBuildFingerprint("fixture", target, root), false);
+  const before = await sourceFingerprint(target, root);
+  await rm(source);
+  await assert.rejects(
+    recordDashboardBuild("fixture", before, target, root),
+    /changed during build/,
+  );
+  let builds = 0;
+  await assert.rejects(
+    refreshDashboardBuildTargets({
+      targets: { fixture: target },
+      frozen: true,
+      inspectTarget: async () => ({
+        missingArtifacts: [],
+        artifactsModifiedAt: 1,
+        sourcesModifiedAt: 2,
+      }),
+      runBuild: async () => builds++,
+    }),
+    /release is frozen/,
+  );
+  assert.equal(builds, 0);
+});