@zaip-ai/cli 1.3.0 → 1.3.1

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-source-fingerprint.ts

@@ -0,0 +1,81 @@
+import { readdir, stat } from "node:fs/promises";
+import { join, relative, resolve } from "node:path";
+
+const textExtensions = new Set([".json", ".jsonl", ".md", ".yaml", ".yml", ".txt"]);
+
+function isDashboardCanonicalSource(source: string): boolean {
+  if (
+    [
+      ".agents/config/project.yaml",
+      ".agents/config/framework.lock.yaml",
+      ".agents/config/agents/catalog.yaml",
+      ".agents/config/clients.yaml",
+    ].includes(source)
+  )
+    return true;
+  if (source.startsWith(".agents/config/pricing/")) return true;
+  if (source.startsWith(".agents/records/runs/") && source.endsWith(".jsonl")) return true;
+  if (/^\.agents\/records\/(tasks|specs|prds)\/.*\.md$/.test(source)) return true;
+  if (/^\.agents\/records\/executions\/.*\/execution\.md$/.test(source)) return true;
+  if (
+    source.startsWith(".agents/records/lifecycle/historical-developer-attribution/") &&
+    source.endsWith(".json")
+  )
+    return true;
+  return /^\.agents\/records\/changes\/.*\/(change\.md|decisions\/.*\.md|artifacts\/(evidence|tests|validations)\/.*\.md)$/.test(
+    source,
+  );
+}
+
+export type SqliteReadModelSourceCandidate = {
+  path: string;
+  source: string;
+  mtimeMs: number;
+  size: number;
+};
+
+export async function sourceFingerprint(
+  workspaceRoot: string,
+): Promise<{ fingerprint: string; candidates: SqliteReadModelSourceCandidate[] }> {
+  const candidates = (
+    await Promise.all(
+      [".agents/records", ".agents/config"].map((root) => listFiles(resolve(workspaceRoot, root))),
+    )
+  )
+    .flat()
+    .filter(
+      (path) =>
+        textExtensions.has(path.slice(path.lastIndexOf(".")).toLowerCase()) &&
+        isDashboardCanonicalSource(relative(workspaceRoot, path).replaceAll("\\", "/")),
+    )
+    .sort();
+  const candidatesWithMetadata = await Promise.all(
+    candidates.map(async (candidate) => {
+      const metadata = await stat(candidate);
+      return {
+        path: candidate,
+        source: relative(workspaceRoot, candidate).replaceAll("\\", "/"),
+        mtimeMs: Math.trunc(metadata.mtimeMs),
+        size: metadata.size,
+      };
+    }),
+  );
+  return {
+    fingerprint: candidatesWithMetadata
+      .map((candidate) => `${candidate.source}:${candidate.mtimeMs}:${candidate.size}`)
+      .join("|"),
+    candidates: candidatesWithMetadata,
+  };
+}
+
+async function listFiles(directory: string): Promise<string[]> {
+  const entries = await readdir(directory, { withFileTypes: true }).catch(() => []);
+  return (
+    await Promise.all(
+      entries.map(async (entry) => {
+        const candidate = join(directory, entry.name);
+        return entry.isDirectory() ? listFiles(candidate) : entry.isFile() ? [candidate] : [];
+      }),
+    )
+  ).flat();
+}