@zaip-ai/cli 4.5.0 → 4.7.0

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-summary.ts

@@ -1,6 +1,10 @@
 import type { CostSummarySource } from "@zaip-ai/dashboard-cost-monitor/server";
 import { artifactStructuralRowsSql } from "./sqlite-artifact-counts.js";
 import { buildCostSummaryDetails } from "./sqlite-cost-summary-details.js";
+import {
+  costSummaryElapsedByDay,
+  filteredCostSummaryElapsedByDay,
+} from "./sqlite-cost-summary-elapsed.js";
 import type { SqliteQueryContext } from "./sqlite-query-context.js";
 import { costMonitorFilterDay } from "./sqlite-read-model-canonical.js";
 import type { SqliteReadModelFileSystem } from "./sqlite-read-model-filesystem.js";
@@ -11,21 +15,8 @@ export function queryCostMonitorSummaryAggregate(
   const { from, to, providers = [], models = [] } = filter;
   const sourceFrom = costMonitorFilterDay(from);
   const sourceTo = costMonitorFilterDay(to);
-  const cacheKey = JSON.stringify({ ...filter, from: sourceFrom, to: sourceTo });
-  const generationCached = context.costMonitorSummaryCache.get(cacheKey);
-  if (generationCached !== undefined) return structuredClone(generationCached);
-  const remember = (value: CostSummarySource) => {
-    if (context.costMonitorSummaryCache.size >= 64) {
-      const oldest = context.costMonitorSummaryCache.keys().next().value as string | undefined;
-      if (oldest !== undefined) context.costMonitorSummaryCache.delete(oldest);
-    }
-    context.costMonitorSummaryCache.set(cacheKey, structuredClone(value));
-    return structuredClone(value);
-  };
-  const unfilteredAllTime =
+  const noDimensionFilters =
     !filter.query &&
-    sourceFrom === null &&
-    sourceTo === null &&
     [
       providers,
       models,
@@ -41,7 +32,19 @@ export function queryCostMonitorSummaryAggregate(
       filter.risks,
       filter.origins,
       filter.workTypes,
-    ].every((values) => values === undefined || values.length === 0);
+    ].every((items) => items === undefined || items.length === 0);
+  const cacheKey = JSON.stringify({ ...filter, from: sourceFrom, to: sourceTo });
+  const generationCached = context.costMonitorSummaryCache.get(cacheKey);
+  if (generationCached !== undefined) return structuredClone(generationCached);
+  const remember = (value: CostSummarySource) => {
+    if (context.costMonitorSummaryCache.size >= 64) {
+      const oldest = context.costMonitorSummaryCache.keys().next().value as string | undefined;
+      if (oldest !== undefined) context.costMonitorSummaryCache.delete(oldest);
+    }
+    context.costMonitorSummaryCache.set(cacheKey, structuredClone(value));
+    return structuredClone(value);
+  };
+  const unfilteredAllTime = noDimensionFilters && sourceFrom === null && sourceTo === null;
   if (unfilteredAllTime) {
     const cached = context.database
       .prepare(
@@ -55,27 +58,7 @@ export function queryCostMonitorSummaryAggregate(
       if (summary.filters_available !== undefined) return remember(summary);
     }
   }
-  if (
-    !filter.query &&
-    sourceFrom !== null &&
-    sourceTo !== null &&
-    [
-      providers,
-      models,
-      filter.agents,
-      filter.phases,
-      filter.statuses,
-      filter.tasks,
-      filter.specs,
-      filter.prds,
-      filter.executions,
-      filter.changes,
-      filter.priorities,
-      filter.risks,
-      filter.origins,
-      filter.workTypes,
-    ].every((values) => values === undefined || values.length === 0)
-  ) {
+  if (noDimensionFilters && sourceFrom !== null && sourceTo !== null) {
     const cached = context.database
       .prepare(
         "SELECT payload_json FROM zaip_aios_activities WHERE payload_type='cost_monitor_summary_month_cache' ORDER BY recorded_at DESC LIMIT 1",
@@ -384,12 +367,25 @@ export function queryCostMonitorSummaryAggregate(
   );
   const financialByDay = new Map(dailyRows.map((row) => [String(row.key), row]));
   const structuralByDay = new Map(structuralRows.map((row) => [String(row.day), row]));
-  const days = [...new Set([...financialByDay.keys(), ...structuralByDay.keys()])].sort();
+  // Financial events belong to their source start day. Elapsed wall time
+  // belongs to every local day actually crossed by its observed interval.
+  const elapsedByDay = noDimensionFilters
+    ? costSummaryElapsedByDay(context.database, sourceFrom, sourceTo)
+    : filteredCostSummaryElapsedByDay(
+        context.database,
+        sourceFrom,
+        sourceTo,
+        clauses.slice(2),
+        values.slice(4),
+      );
+  const days = [
+    ...new Set([...financialByDay.keys(), ...structuralByDay.keys(), ...elapsedByDay.keys()]),
+  ].sort();
   const compactDailyRows = days.map((day) => {
     const financial = financialByDay.get(day);
     const structural = structuralByDay.get(day);
     const eligible = number(financial?.eligible_runs);
-    const knownDuration = number(financial?.duration_known);
+    const elapsed = elapsedByDay.get(day);
     return {
       key: day,
       prd_count: number(structural?.prd_count),
@@ -398,9 +394,12 @@ export function queryCostMonitorSummaryAggregate(
       validation_count: number(structural?.validation_count),
       evidence_count: number(structural?.evidence_count),
       total_run_count: eligible,
-      total_duration: nullable(financial?.duration_ms),
-      duration_known: number(financial?.duration_ms),
-      duration_unknown: Math.max(0, eligible - knownDuration),
+      total_duration: elapsed?.known_runs ? elapsed.known_sum : null,
+      duration_known: elapsed?.known_sum ?? 0,
+      duration_unknown: Math.max(
+        0,
+        (elapsed?.eligible_runs ?? eligible) - (elapsed?.known_runs ?? 0),
+      ),
       total_tokens: nullable(financial?.total_tokens),
       total_cost_usd: nullable(financial?.cost_usd),
       total_cost_brl: nullable(financial?.cost_brl),
@@ -447,19 +446,7 @@ export function queryCostMonitorSummaryAggregate(
       ];
     }),
   );
-  const durations = Object.fromEntries(
-    dailyRows.map((row) => {
-      const value = metric(row);
-      return [
-        String(row.key),
-        {
-          known_sum: number(row.duration_ms),
-          eligible_runs: value._duration_population.eligible_runs,
-          known_runs: value._duration_population.known_runs,
-        },
-      ];
-    }),
-  );
+  const durations = Object.fromEntries(elapsedByDay);
   const { model_groups, filters_available } = buildCostSummaryDetails(
     context,
     selected,

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-view-page.ts

@@ -4,6 +4,7 @@ import {
   operationsWorkListPayloadPage,
   operationsWorkListSqlPage,
 } from "./sqlite-operations-work-list.js";
+import { hasVisibleProviderMetrics } from "./sqlite-provider-visibility.js";
 import { readAgentDimension } from "./sqlite-query-agent-dimension.js";
 import {
   readCachedCostViewPage,
@@ -13,6 +14,7 @@ import type { SqliteQueryContext, SqliteViewPage } from "./sqlite-query-context.
 import { readEntityGroup } from "./sqlite-query-entity-group.js";
 import { readFilteredDimension } from "./sqlite-query-filtered-dimension.js";
 import { readModelDimension } from "./sqlite-query-model-dimension.js";
+import { attachOperationsDuration } from "./sqlite-query-operations-duration.js";
 import { readProviderDimension } from "./sqlite-query-provider-dimension.js";
 import { readTemporalDimension } from "./sqlite-query-temporal-dimension.js";
 import { costMonitorFilterDay } from "./sqlite-read-model-canonical.js";
@@ -239,7 +241,7 @@ export function queryUncachedViewPage(
     const visiblePayloadRows =
       dimension === "model"
         ? payloadRows.filter((row) => row.key !== "unavailable" && row.key !== null)
-        : payloadRows;
+        : payloadRows.filter(hasVisibleProviderMetrics);
     const limit = Math.min(200, Math.max(1, input.limit ?? 50));
     const offset = Math.max(0, input.offset ?? 0);
     const rows = visiblePayloadRows.slice(offset, offset + limit);
@@ -268,9 +270,11 @@ export function queryUncachedViewPage(
         for (const field of modelNumericFields)
           row[field] = typeof row[field] === "number" ? row[field] : 0;
     }
+    // Provider visibility must not change factual totals or known-zero coverage.
+    const totalRows = dimension === "provider" ? payloadRows : visiblePayloadRows;
     const nullableSum = (field: string) =>
-      visiblePayloadRows.some((row) => typeof row[field] === "number")
-        ? visiblePayloadRows.reduce(
+      totalRows.some((row) => typeof row[field] === "number")
+        ? totalRows.reduce(
             (sum, row) => sum + (typeof row[field] === "number" ? Number(row[field]) : 0),
             0,
           )
@@ -284,7 +288,7 @@ export function queryUncachedViewPage(
         total_count: visiblePayloadRows.length,
         has_more: offset + rows.length < visiblePayloadRows.length,
         totals: {
-          invocation_count: visiblePayloadRows.reduce(
+          invocation_count: totalRows.reduce(
             (sum, row) => sum + Number(row.invocation_count ?? 0),
             0,
           ),
@@ -490,60 +494,7 @@ export function queryUncachedViewPage(
   const rows = context.database
     .prepare(`SELECT * FROM ${view}${where} ORDER BY ${meta.order} LIMIT ? OFFSET ?`)
     .all(...values, limit, offset) as Array<Record<string, unknown>>;
-  if (
-    view === "operations_daily" ||
-    view === "operations_monthly" ||
-    view === "operations_annual"
-  ) {
-    // A partial date interval intersects a coarse month/year row but does
-    // not make its all-time additive metrics applicable. Recompose it from
-    // the same daily facts used by Operations cards.
-    const partialCoarse = view !== "operations_daily" && (input.from || input.to);
-    const partialFromDay = input.from?.slice(0, 10) ?? null;
-    const partialToDay = input.to?.slice(0, 10) ?? null;
-    const dailyRows = partialCoarse
-      ? (context.database
-          .prepare(
-            `SELECT * FROM operations_daily WHERE (? IS NULL OR day >= ?) AND (? IS NULL OR day <= ?)`,
-          )
-          .all(partialFromDay, partialFromDay, partialToDay, partialToDay) as Array<
-          Record<string, unknown>
-        >)
-      : [];
-    const daily = context.executionDurationByDay({
-      from: input.from ?? null,
-      to: input.to ?? null,
-    });
-    for (const row of rows) {
-      const key = String(row.day ?? row.period_key);
-      if (partialCoarse) {
-        const matching = dailyRows.filter((day) => String(day.day).startsWith(key));
-        const matchingDays = matching.map((day) => String(day.day)).sort();
-        row.start_day = matchingDays[0] ?? null;
-        row.end_day = matchingDays.at(-1) ?? null;
-        for (const column of [
-          "prd_count",
-          "spec_count",
-          "task_count",
-          "validation_count",
-          "evidence_count",
-          "total_run_count",
-          "invocation_count",
-          "llm_call_count",
-          "total_tokens",
-          "total_cost_usd",
-          "total_cost_brl",
-        ] as const)
-          row[column] = matching.reduce(
-            (sum, day) => sum + (typeof day[column] === "number" ? Number(day[column]) : 0),
-            0,
-          );
-      }
-      row.operations_total_duration = [...daily]
-        .filter(([day]) => (view === "operations_daily" ? day === key : day.startsWith(key)))
-        .reduce((sum, [, duration]) => sum + duration, 0);
-    }
-  }
+  attachOperationsDuration(context, view, input, rows);
   return {
     data_source: "sqlite_read_model" as const,
     view,

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

@@ -26,11 +26,13 @@ import {
 } from "@zaip-ai/costs";
 import type { RunV2Fold, UsageRecordedV2 } from "../../../../../packages/decisions/src/index.js";
 import { saoPauloDay } from "./sqlite-calendar.js";
+import {
+  MAX_RECONCILED_RUN_INTERVAL_MS,
+  MAX_SOURCE_INTERVAL_MS,
+} from "./sqlite-read-model-schema.js";
 
 export { saoPauloDay } from "./sqlite-calendar.js";
 
-const MAX_RECONCILED_RUN_INTERVAL_MS = 2 * 3_600_000;
-
 export function saoPauloCurrentMonth(): { from: string; to: string } {
   const parts = new Intl.DateTimeFormat("en-CA", {
     timeZone: "America/Sao_Paulo",
@@ -362,9 +364,7 @@ export function factualDuration(record: UsageRecordedV2): boolean {
 export type ResolvedSourceInterval = { start: string; end: string; duration: number };
 
 /**
- * Reconciled usage is the closest canonical observation of when model work
- * happened.  It wins over Run finalization elapsed time, which may include
- * orchestration/capture lag or be recorded much later.
+ * Observed source boundaries outrank delayed administrative Run finalization.
  */
 export function resolvedSourceInterval(
   records: readonly UsageRecordedV2[],
@@ -379,7 +379,7 @@ export function resolvedSourceInterval(
       Number.isFinite(startMs) &&
       Number.isFinite(endMs) &&
       endMs > startMs &&
-      endMs - startMs <= MAX_RECONCILED_RUN_INTERVAL_MS
+      endMs - startMs <= MAX_SOURCE_INTERVAL_MS
       ? [{ start, end, startMs, endMs }]
       : [];
   });
@@ -390,7 +390,7 @@ export function resolvedSourceInterval(
   const end = intervals.reduce((latest, interval) =>
     interval.endMs > latest.endMs ? interval : latest,
   );
-  return end.endMs - start.startMs <= MAX_RECONCILED_RUN_INTERVAL_MS
+  return end.endMs - start.startMs <= MAX_SOURCE_INTERVAL_MS
     ? { start: start.start, end: end.end, duration: end.endMs - start.startMs }
     : null;
 }

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-counts-every-root-execution-day-returns.test.ts

@@ -49,7 +49,7 @@ describe("SQLite dashboard read model", () => {
       expect.objectContaining({
         id: "SPEC-B",
         invocation_count: 2,
-        total_duration: 1_800_000,
+        total_duration: 2_400_000,
         total_tokens: 4,
         total_cost_brl: 10,
       }),
@@ -189,13 +189,13 @@ describe("SQLite dashboard read model", () => {
       status_counts: { planning: 3 },
       classification_counts: { structured: 2 },
       total_run_count: 3,
-      total_duration_ms: 2_400_000,
+      total_duration_ms: 3_000_000,
       total_tokens: 6,
       total_cost_brl: 15,
-      average_duration_ms: 800_000,
+      average_duration_ms: 1_000_000,
     });
     expect(allTime.macro_metrics.specs.top_entities.slice(0, 2)).toMatchObject([
-      { rank: 1, entity_id: "SPEC-B", total_duration_ms: 1_800_000 },
+      { rank: 1, entity_id: "SPEC-B", total_duration_ms: 2_400_000 },
       { rank: 2, entity_id: "SPEC-A", total_duration_ms: 600_000 },
     ]);
     expect(allTime.macro_metrics.prds).toMatchObject({
@@ -314,7 +314,7 @@ describe("SQLite dashboard read model", () => {
     expect(pagedDailyCostPage.totals).toMatchObject({
       total_tokens: dailyCostRows.reduce((sum, row) => sum + Number(row.total_tokens ?? 0), 0),
       total_cost_brl: dailyCostRows.reduce((sum, row) => sum + Number(row.total_cost_brl ?? 0), 0),
-      total_duration: dailyCostRows.reduce((sum, row) => sum + Number(row.total_duration ?? 0), 0),
+      total_duration: null,
     });
     expect(annualCostPage).toMatchObject({
       total_count: 1,

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-multi-provider.test.ts

@@ -130,10 +130,10 @@ describe("SQLite dashboard read model multi-provider", () => {
     expect(
       allAgentGroups.rows.reduce((total, row) => total + Number(row.total_cost_usd ?? 0), 0),
     ).toBe(allCostTotals.total_cost_usd);
-    // Shared Cost Tempo is factual at the activity grain. It remains available
-    // in the agent-table total even where a multi-dimension invocation cannot
-    // be assigned to an individual Agent row.
-    expect(allCostTotals.cost_monitor_total_duration).toBe(120_000);
+    // The calendar overview uses three observed one-minute source intervals.
+    // The agent table reports 120 seconds attributable to token-active facts;
+    // it does not assign the remaining source elapsed minute to an Agent.
+    expect(allCostTotals.cost_monitor_total_duration).toBe(180_000);
     expect(allAgentGroups.totals).toMatchObject({
       invocation_count: allCostTotals.total_run_count,
       total_duration: 120_000,

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

@@ -42,16 +42,10 @@ export async function rebuildSqliteReadModel(
   options: SqliteRebuildOptions = {},
 ): Promise<SqliteRebuildResult> {
   const path = sqliteReadModelPath(workspaceRoot);
-  // Reuse only when schema and canonical fingerprint still match; otherwise rebuild.
+  // Startup serves a validated generation; the worker verifies canonical freshness.
   if (options.preferExisting && !options.forceCanonical) {
     try {
-      validateSqliteReadModelSchema(path);
-      const fingerprintStartedAt = performance.now();
-      const sourceSnapshot = await sourceFingerprint(
-        workspaceRoot,
-        rebuildFingerprintOptions(path, options),
-      );
-      const fingerprint = `${sourceSnapshot.fingerprint}\ncurrent_day=${saoPauloDay(new Date().toISOString())}`;
+      validateSqliteReadModelSchema(path, { integrity: "quick" });
       const database = new DatabaseSync(path, { readOnly: true });
       try {
         if (hasReusableSnapshotPayloads(database)) {
@@ -60,38 +54,18 @@ export async function rebuildSqliteReadModel(
               "SELECT value FROM zaip_vw_read_model_metadata WHERE key = 'source_file_count'",
             )
             .get() as { value: string };
-          const files = readSnapshotFileCount(
-            path,
-            fingerprint,
-            readModelSchemaVersion,
-            hasReusableSnapshotPayloads,
-          );
-          if (files !== null) {
-            return {
-              files,
-              path,
-              cache: "generation",
-              fingerprint_ms: Math.round(performance.now() - fingerprintStartedAt),
-              materialize_ms: 0,
-              refresh: {
-                reused_sources: sourceSnapshot.reusedFiles,
-                processed_sources: sourceSnapshot.hashedFiles,
-                added_sources: 0,
-                changed_sources: 0,
-                removed_sources: 0,
-                canonical_runs_refolded: 0,
-              },
-            };
-          }
+          const files = Number(row?.value);
+          if (!Number.isSafeInteger(files) || files < 0)
+            throw new Error("Invalid snapshot file count");
           return {
-            files: Number(row.value),
+            files,
             path,
             cache: "stale_seed",
-            fingerprint_ms: Math.round(performance.now() - fingerprintStartedAt),
+            fingerprint_ms: 0,
             materialize_ms: 0,
             refresh: {
-              reused_sources: sourceSnapshot.reusedFiles,
-              processed_sources: sourceSnapshot.hashedFiles,
+              reused_sources: 0,
+              processed_sources: 0,
               added_sources: 0,
               changed_sources: 0,
               removed_sources: 0,

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

@@ -7,7 +7,7 @@ export const dbRelativePath = ".local/sqlite/zaip-aios-dashboard.sqlite";
 // Schema 83 adds canonical priority, Run work type and reconciled macro stages.
 // Old snapshots must rebuild even when their canonical hashes still match.
 // Refresh persisted first-fold summaries after factual duration/coverage semantics change.
-export const readModelSchemaVersion = "84";
+export const readModelSchemaVersion = "85";
 export const requiredPersistedTables = [
   "zaip_aios_activities",
   "zaip_dim_llm_model",
@@ -51,6 +51,8 @@ export const requiredViews = [
   "zaip_vw_operations_agent_invocations",
 ] as const;
 export const MAX_RECONCILED_RUN_INTERVAL_MS = 2 * 3_600_000;
+/** Explicit source observations can span a workday; inferred Run pairs cannot. */
+export const MAX_SOURCE_INTERVAL_MS = 48 * 3_600_000;
 export function sqliteReadModelPath(workspaceRoot: string): string {
   return resolve(process.env.ZAIP_SQLITE_DB_PATH ?? resolve(workspaceRoot, dbRelativePath));
 }
@@ -122,7 +124,10 @@ export function persistedSourceCheckpoint(
  * is intentionally independent of source fingerprints: a matching cache key
  * is not evidence that a partially copied or old-schema file is safe.
  */
-export function validateSqliteReadModelSchema(path: string): {
+export function validateSqliteReadModelSchema(
+  path: string,
+  options: { integrity?: "full" | "quick" } = {},
+): {
   schemaVersion: string;
   tableCount: number;
   viewCount: number;
@@ -130,13 +135,12 @@ export function validateSqliteReadModelSchema(path: string): {
 } {
   const database = new DatabaseSync(path, { readOnly: true });
   try {
-    const integrity = database.prepare("PRAGMA integrity_check").get() as {
-      integrity_check?: string;
-    };
-    if (integrity.integrity_check !== "ok")
-      throw new Error(
-        `SQLite integrity check failed for ${path}: ${integrity.integrity_check ?? "unknown"}`,
-      );
+    // Only startup opts into quick_check. Workers and qualification retain the
+    // full cross-index integrity check, independently of source cache reuse.
+    const pragma = options.integrity === "quick" ? "quick_check" : "integrity_check";
+    const integrity = database.prepare(`PRAGMA ${pragma}`).get() as Record<string, unknown>;
+    if (integrity[pragma] !== "ok")
+      throw new Error(`SQLite ${pragma} failed for ${path}: ${integrity[pragma] ?? "unknown"}`);
     const objects = database
       .prepare("SELECT name, type FROM sqlite_master WHERE type IN ('table', 'view', 'index')")
       .all() as Array<{ name: string; type: "table" | "view" | "index" }>;

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

@@ -3,6 +3,7 @@ import { createHash } from "node:crypto";
 import { readdir, readFile, stat } from "node:fs/promises";
 import { join, relative, resolve } from "node:path";
 import { promisify } from "node:util";
+import { CanonicalSourceRevisionCache } from "./canonical-source-revision-cache.js";
 
 const execFileAsync = promisify(execFile);
 
@@ -87,23 +88,9 @@ export function isCodexManagedWorktreeRoot(root: string): boolean {
   return /[\\/]\.codex[\\/]worktrees(?:[\\/][^\\/]+){1,2}$/iu.test(root);
 }
 
-function canonicalRevision(content: string, source: string): [string, number, number] {
-  if (source.endsWith(".jsonl")) {
-    const dates = [...content.matchAll(/"occurred_at"\s*:\s*"([^"]+)"/gu)];
-    return [
-      dates.reduce((latest, match) => ((match[1] ?? "") > latest ? (match[1] ?? "") : latest), ""),
-      dates.length,
-      content.length,
-    ];
-  }
-  const updated = /^updated_at:\s*([^\r\n]+)/mu.exec(content)?.[1]?.trim() ?? "";
-  const created = /^created_at:\s*([^\r\n]+)/mu.exec(content)?.[1]?.trim() ?? "";
-  const revision = Number(/^revision:\s*(\d+)/mu.exec(content)?.[1] ?? 0);
-  return [updated || created, revision, content.length];
-}
-
 async function selectCanonicalSources(
   roots: readonly string[],
+  cache: CanonicalSourceRevisionCache,
 ): Promise<Array<{ path: string; source: string }>> {
   const locations = new Map<string, string[]>();
   for (const [index, root] of roots.entries()) {
@@ -149,36 +136,37 @@ async function selectCanonicalSources(
   const entries = [...locations.entries()];
   for (let offset = 0; offset < entries.length; offset += 32) {
     selected.push(
-      ...(await Promise.all(
-        entries.slice(offset, offset + 32).map(async ([source, paths]) => {
-          const firstPath = paths[0];
-          if (firstPath === undefined) throw new Error(`No canonical source for ${source}`);
-          if (paths.length === 1) return { source, path: firstPath };
-          // Worktree checkout mtimes do not represent canonical record recency.
-          // Compare embedded revision timestamps and prefer the first registered
-          // source on an exact tie, so repeated scans remain deterministic.
-          const revisions = await Promise.all(
-            paths.map(async (path) => canonicalRevision(await readFile(path, "utf8"), source)),
-          );
-          let winner = 0;
-          for (let index = 1; index < paths.length; index += 1) {
-            const left = revisions[index];
-            const right = revisions[winner];
-            if (left === undefined || right === undefined)
-              throw new Error(`Incomplete canonical revisions for ${source}`);
-            if (
-              left[0] > right[0] ||
-              (left[0] === right[0] &&
-                (left[1] > right[1] || (left[1] === right[1] && left[2] > right[2])))
-            )
-              winner = index;
-          }
-          const selectedPath = paths[winner];
-          if (selectedPath === undefined)
-            throw new Error(`No selected canonical source for ${source}`);
-          return { source, path: selectedPath };
-        }),
-      )),
+      ...(
+        await Promise.all(
+          entries.slice(offset, offset + 32).map(async ([source, paths]) => {
+            const firstPath = paths[0];
+            if (firstPath === undefined) throw new Error(`No canonical source for ${source}`);
+            if (paths.length === 1) return { source, path: firstPath };
+            // Worktree checkout mtimes do not represent canonical record recency.
+            // Compare embedded revision timestamps and prefer the first registered
+            // source on an exact tie, so repeated scans remain deterministic.
+            const revisions = await Promise.all(paths.map((path) => cache.read(path, source)));
+            let winner = revisions.findIndex((item) => item !== null);
+            if (winner < 0) return null;
+            for (let index = 1; index < paths.length; index += 1) {
+              const left = revisions[index]?.entry.revision;
+              const right = revisions[winner]?.entry.revision;
+              if (!left) continue;
+              if (!right) throw new Error(`Incomplete canonical revisions for ${source}`);
+              if (
+                left[0] > right[0] ||
+                (left[0] === right[0] &&
+                  (left[1] > right[1] || (left[1] === right[1] && left[2] > right[2])))
+              )
+                winner = index;
+            }
+            const selectedPath = paths[winner];
+            if (selectedPath === undefined)
+              throw new Error(`No selected canonical source for ${source}`);
+            return { source, path: selectedPath };
+          }),
+        )
+      ).filter((item): item is { source: string; path: string } => item !== null),
     );
   }
   return selected.sort((left, right) => left.source.localeCompare(right.source));
@@ -192,9 +180,16 @@ export async function sourceFingerprint(
   candidates: SqliteReadModelSourceCandidate[];
   hashedFiles: number;
   reusedFiles: number;
+  duplicateReads: number;
+  duplicateReused: number;
 }> {
+  const revisionCache = await CanonicalSourceRevisionCache.open(
+    workspaceRoot,
+    options.verifyContent,
+  );
   const candidates = await selectCanonicalSources(
     options.sourceRoots ?? (await dashboardCanonicalSourceRoots(workspaceRoot)),
+    revisionCache,
   );
   const candidatesWithMetadata: SqliteReadModelSourceCandidate[] = [];
   let hashedFiles = 0;
@@ -261,6 +256,7 @@ export async function sourceFingerprint(
       ).filter((candidate): candidate is SqliteReadModelSourceCandidate => candidate !== null),
     );
   }
+  await revisionCache.persist();
   return {
     fingerprint: candidatesWithMetadata
       .map(
@@ -271,6 +267,8 @@ export async function sourceFingerprint(
     candidates: candidatesWithMetadata,
     hashedFiles,
     reusedFiles,
+    duplicateReads: revisionCache.reads,
+    duplicateReused: revisionCache.reused,
   };
 }
 

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

@@ -23,13 +23,7 @@ async function createSqliteTestRoot(): Promise<string> {
 afterEach(async () => {
   vi.useRealTimers();
   vi.restoreAllMocks();
-  await Promise.all(
-    roots
-      .splice(0)
-      .map((root) =>
-        import("node:fs/promises").then(({ rm }) => rm(root, { recursive: true, force: true })),
-      ),
-  );
+  await Promise.all(roots.splice(0).map((root) => rm(root, { recursive: true, force: true })));
 });
 describe("SQLite dashboard read model", () => {
   it("materializes a fresh workspace without opening a nonexistent checkpoint database", async () => {
@@ -87,7 +81,7 @@ describe("SQLite dashboard read model", () => {
       filesystem.close();
     }
   });
-  it("reuses an unchanged verified fingerprint as the current generation", async () => {
+  it("serves an unchanged validated snapshot as a stale seed pending canonical verification", async () => {
     const root = await createSqliteTestRoot();
     roots.push(root);
     await mkdir(join(root, ".agents/config"), { recursive: true });
@@ -95,7 +89,9 @@ describe("SQLite dashboard read model", () => {
     vi.spyOn(Date, "now").mockReturnValue(Date.now() + 5_000);
     await rebuildSqliteReadModel(root);
     await expect(rebuildSqliteReadModel(root, { preferExisting: true })).resolves.toMatchObject({
-      cache: "generation",
+      cache: "stale_seed",
+      fingerprint_ms: 0,
+      materialize_ms: 0,
     });
   });
   it("rolls back a failed refresh including first-fold payloads while a reader remains open", async () => {

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

@@ -9,7 +9,11 @@ export type {
   SqliteFirstFoldMonthlyQuick,
 } from "./sqlite-read-model-first-fold-types.js";
 export { rebuildSqliteReadModel } from "./sqlite-read-model-rebuild.js";
-export { sqliteReadModelPath, validateSqliteReadModelSchema } from "./sqlite-read-model-schema.js";
+export {
+  hasReusableSnapshotPayloads,
+  sqliteReadModelPath,
+  validateSqliteReadModelSchema,
+} from "./sqlite-read-model-schema.js";
 export {
   type SqliteReadModelSourceCandidate,
   sourceFingerprint,