@zaip-ai/cli 3.3.0 → 3.4.0

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

@@ -1,11 +1,14 @@
 import { isDateOnlyCostPage, readDateOnlyCostDimensionPage } from "./sqlite-cost-agent-page.js";
-import { filterCostInvocationProjection } from "./sqlite-cost-invocation-page.js";
 import {
   attachOperationsWorkListDevelopers,
   operationsWorkListPayloadPage,
   operationsWorkListSqlPage,
 } from "./sqlite-operations-work-list.js";
 import { readAgentDimension } from "./sqlite-query-agent-dimension.js";
+import {
+  readCachedCostViewPage,
+  type SqliteViewPageInput,
+} from "./sqlite-query-cached-cost-page.js";
 import type { SqliteQueryContext, SqliteViewPage } from "./sqlite-query-context.js";
 import { readEntityGroup } from "./sqlite-query-entity-group.js";
 import { readFilteredDimension } from "./sqlite-query-filtered-dimension.js";
@@ -17,164 +20,10 @@ import { type SqliteViewName, sqliteViewMetadata } from "./sqlite-read-model-typ
 export function queryUncachedViewPage(
   context: SqliteQueryContext,
   view: SqliteViewName,
-  input: {
-    from?: string | null;
-    to?: string | null;
-    query?: string;
-    status?: string;
-    risk?: string;
-    provider?: string;
-    model?: string;
-    agent?: string;
-    phase?: string;
-    origin?: string;
-    workType?: string;
-    priority?: string;
-    kind?: "all" | "all-tasks" | "task" | "standalone-task" | "prd" | "spec";
-    offset?: number;
-    limit?: number;
-  },
+  input: SqliteViewPageInput,
 ): SqliteViewPage {
-  const isUnfilteredAllTimeCostPage =
-    !input.from &&
-    !input.to &&
-    !input.query &&
-    !input.status &&
-    !input.risk &&
-    !input.provider &&
-    !input.model &&
-    !input.agent &&
-    !input.phase &&
-    !input.origin &&
-    !input.workType &&
-    !input.priority;
-  const isDateOnlyCostInvocationPage =
-    view === "cost_monitor_agent_invocations" &&
-    !input.query &&
-    !input.status &&
-    !input.risk &&
-    !input.provider &&
-    !input.model &&
-    !input.agent &&
-    !input.phase &&
-    !input.origin &&
-    !input.workType &&
-    !input.priority;
-  if (isDateOnlyCostInvocationPage) {
-    const projection = filterCostInvocationProjection(
-      context.technicalPayloadRows("cost_agent_invocation_projection_v1"),
-      input,
-    );
-    if (projection.length > 0) {
-      const limit = Math.min(200, Math.max(1, input.limit ?? 100));
-      const offset = Math.max(0, input.offset ?? 0);
-      const rows = projection.slice(offset, offset + limit);
-      return {
-        data_source: "sqlite_read_model" as const,
-        view,
-        offset,
-        limit,
-        total_count: projection.length,
-        has_more: offset + rows.length < projection.length,
-        rows,
-      };
-    }
-  }
-  const remoteAggregateDimensions: Partial<Record<SqliteViewName, string>> = {
-    cost_monitor_zaip_agents: "agent",
-    cost_monitor_executions: "execution",
-    cost_monitor_tasks: "task",
-    cost_monitor_conversations: "conversation",
-  };
-  const remoteAggregateDimension = remoteAggregateDimensions[view];
-  if (isUnfilteredAllTimeCostPage && remoteAggregateDimension !== undefined) {
-    const projection = context
-      .technicalPayloadRows("cost_dimension_aggregate_v1")
-      .filter((row) => row.dimension === remoteAggregateDimension);
-    const rows = projection
-      .filter((row) => row.row_kind === "row")
-      .map((row) =>
-        view === "cost_monitor_zaip_agents"
-          ? {
-              key: row.key,
-              label: row.label,
-              persona: row.persona,
-              job: row.job,
-              latest_started_at: row.latest_started_at,
-              invocation_count: row.invocation_count,
-              task_count: row.task_count,
-              total_duration: row.total_duration,
-              duration_unknown: row.duration_unknown,
-              duration_known: row.duration_known,
-              source_event_count: row.source_event_count,
-              total_tokens: row.total_tokens,
-              total_cost_usd: row.total_cost_usd,
-              total_cost_brl: row.total_cost_brl,
-            }
-          : {
-              id: row.id,
-              key: row.key,
-              title: row.title,
-              status: row.status,
-              risk: row.risk,
-              first_day: row.first_day,
-              last_day: row.last_day,
-              occurred_at: row.occurred_at,
-              invocation_count: row.invocation_count,
-              llm_call_count: row.llm_call_count,
-              total_duration: row.total_duration,
-              total_input_tokens: row.total_input_tokens,
-              total_cached_input_tokens: row.total_cached_input_tokens,
-              total_output_tokens: row.total_output_tokens,
-              total_reasoning_tokens: row.total_reasoning_tokens,
-              total_tokens: row.total_tokens,
-              total_cost_usd: row.total_cost_usd,
-              total_cost_brl: row.total_cost_brl,
-            },
-      )
-      .sort(
-        (left, right) =>
-          Number(right.total_cost_brl ?? -1) - Number(left.total_cost_brl ?? -1) ||
-          String(left.key ?? "").localeCompare(String(right.key ?? "")),
-      ) as Array<Record<string, unknown>>;
-    const totals = projection.find((row) => row.row_kind === "totals");
-    if (rows.length > 0 && totals !== undefined) {
-      const limit = Math.min(200, Math.max(1, input.limit ?? 50));
-      const offset = Math.max(0, input.offset ?? 0);
-      const page = rows.slice(offset, offset + limit);
-      const publicTotals =
-        view !== "cost_monitor_zaip_agents"
-          ? {
-              entity_count: totals.entity_count,
-              invocation_count: totals.invocation_count,
-              total_duration: totals.total_duration,
-              total_tokens: totals.total_tokens,
-              total_cost_usd: totals.total_cost_usd,
-              total_cost_brl: totals.total_cost_brl,
-            }
-          : {
-              invocation_count: totals.invocation_count,
-              task_count: totals.task_count,
-              total_duration: totals.total_duration,
-              duration_unknown: totals.duration_unknown,
-              duration_known: totals.duration_known,
-              source_event_count: totals.source_event_count,
-              total_tokens: totals.total_tokens,
-              total_cost_usd: totals.total_cost_usd,
-              total_cost_brl: totals.total_cost_brl,
-            };
-      return {
-        data_source: "sqlite_read_model" as const,
-        view,
-        offset,
-        limit,
-        total_count: rows.length,
-        has_more: offset + page.length < rows.length,
-        totals: publicTotals,
-        rows: page,
-      };
-    }
-  }
+  const cachedCostPage = readCachedCostViewPage(context, view, input);
+  if (cachedCostPage !== null) return cachedCostPage;
   const cacheableUnfilteredViews: readonly SqliteViewName[] = [
     "operations_work_kanban",
     "operations_executions",
@@ -239,7 +88,20 @@ export function queryUncachedViewPage(
     };
     exact("i.zaip_agent", input.agent);
     exact("i.phase", input.phase);
-    exact("i.status", input.status);
+    exact("COALESCE(t.status, i.status)", input.status);
+    exact("t.priority", input.priority);
+    exact("t.risk", input.risk);
+    exact("i.work_type", input.workType);
+    if (input.origin)
+      clauses.push(
+        input.origin === "prd"
+          ? "i.prd_id IS NOT NULL"
+          : input.origin === "spec"
+            ? "i.prd_id IS NULL AND i.spec_id IS NOT NULL"
+            : input.origin === "task"
+              ? "i.prd_id IS NULL AND i.spec_id IS NULL AND i.task_id IS NOT NULL"
+              : "i.prd_id IS NULL AND i.spec_id IS NULL AND i.task_id IS NULL",
+      );
     const usageSegmentClauses: string[] = [];
     if (input.provider) {
       if (input.provider === "unavailable") {
@@ -275,13 +137,15 @@ export function queryUncachedViewPage(
     const total_count = Number(
       (
         context.database
-          .prepare(`SELECT COUNT(*) AS count FROM cost_monitor_agent_invocations i WHERE ${where}`)
+          .prepare(
+            `SELECT COUNT(*) AS count FROM cost_monitor_agent_invocations i LEFT JOIN tasks t ON t.id=i.task_id WHERE ${where}`,
+          )
           .get(...values) as { count: number }
       ).count,
     );
     const rows = context.database
       .prepare(
-        `SELECT i.* FROM cost_monitor_agent_invocations i WHERE ${where} ORDER BY i.occurred_at DESC, i.agent_invocation_id DESC LIMIT ? OFFSET ?`,
+        `SELECT i.*, t.priority, t.risk, t.status AS task_status, t.title AS task_title FROM cost_monitor_agent_invocations i LEFT JOIN tasks t ON t.id=i.task_id WHERE ${where} ORDER BY i.occurred_at DESC, i.agent_invocation_id DESC LIMIT ? OFFSET ?`,
       )
       .all(...values, limit, offset) as Array<Record<string, unknown>>;
     return {

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

@@ -1,3 +1,4 @@
+import { taskWorkStage } from "@zaip-ai/dashboard-operations/work-board-model";
 import {
   consolidatedValue,
   frontMatterRecord,
@@ -57,7 +58,9 @@ export type CanonicalEntity = {
   status: string | null;
   stage: string | null;
   risk: string | null;
+  priority: string | null;
   specId: string | null;
+  prdId: string | null;
   changeId: string | null;
   occurredAt: string | null;
   creationRunId: string | null;
@@ -233,9 +236,19 @@ export function readCanonicalEntities(
       id,
       title: scalar("title"),
       status: scalar("status"),
-      stage: scalar("stage"),
+      stage:
+        kind === "task"
+          ? taskWorkStage({
+              status: scalar("status") as Parameters<typeof taskWorkStage>[0]["status"],
+              spec_id: scalar("spec_id"),
+              started_at: scalar("started_at"),
+              attempt_count: Number(scalar("attempt_count") ?? 0),
+            })
+          : scalar("stage"),
       risk: scalar("risk"),
+      priority: scalar("priority"),
       specId: scalar("spec_id"),
+      prdId: scalar("prd_id"),
       changeId: scalar("change_id"),
       occurredAt: scalar("created_at") ?? scalar("started_at") ?? scalar("recorded_at"),
       creationRunId: scalar("creation_run_id"),
@@ -694,50 +707,10 @@ export function usagePricingAudit(
   };
 }
 
-export type TemporalInterval = { activityRowId: string; startMs: number; endMs: number };
-
-/**
- * Splits every observed interval at every activity boundary and São Paulo day
- * boundary. Each elementary segment is divided equally among the token-active
- * activities covering it, making the materialized fact additive by activity,
- * day, and every parent dimension.
- */
-export function allocateAttributedTokenActiveMs(intervals: readonly TemporalInterval[]) {
-  const boundaries = new Set<number>();
-  for (const interval of intervals) {
-    boundaries.add(interval.startMs);
-    boundaries.add(interval.endMs);
-    for (let cursor = interval.startMs; cursor < interval.endMs; ) {
-      const nextDay =
-        Date.parse(`${saoPauloDay(new Date(cursor).toISOString())}T03:00:00.000Z`) + 86_400_000;
-      if (nextDay >= interval.endMs) break;
-      boundaries.add(nextDay);
-      cursor = nextDay;
-    }
-  }
-  const points = [...boundaries].sort((left, right) => left - right);
-  const allocated = new Map<string, { activityRowId: string; day: string; value: number }>();
-  for (let index = 0; index < points.length - 1; index += 1) {
-    const startMs = points[index]!;
-    const endMs = points[index + 1]!;
-    const active = intervals.filter(
-      (interval) => interval.startMs < endMs && interval.endMs > startMs,
-    );
-    if (active.length === 0 || endMs <= startMs) continue;
-    const share = (endMs - startMs) / active.length;
-    const day = saoPauloDay(new Date(startMs).toISOString());
-    for (const interval of active) {
-      const key = `${interval.activityRowId}:${day}`;
-      const previous = allocated.get(key);
-      allocated.set(key, {
-        activityRowId: interval.activityRowId,
-        day,
-        value: (previous?.value ?? 0) + share,
-      });
-    }
-  }
-  return [...allocated.values()];
-}
+export {
+  allocateAttributedTokenActiveMs,
+  type TemporalInterval,
+} from "./sqlite-token-active-allocation.js";
 
 /** A dashboard API boundary can be a date or an ISO instant. Normalize both
  * to the same Sao Paulo calendar key used by Cost Monitor SQL buckets. */

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

@@ -662,8 +662,8 @@ describe("SQLite dashboard read model", () => {
       });
     }
     expect(filesystem.viewPage("cost_monitor_tasks", { workType: "new", limit: 1 })).toMatchObject({
-      total_count: 0,
-      rows: [],
+      total_count: 2,
+      rows: [expect.objectContaining({ id: "TASK-B", total_tokens: 4 })],
     });
     expect(filesystem.firstFoldAllTime()).toBe(allTime);
     filesystem.close();

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

@@ -5,6 +5,7 @@ import { attachAgentProductivity } from "./sqlite-agent-productivity.js";
 import {
   readFirstFoldAllTime,
   readFirstFoldBoardAllTime,
+  readFirstFoldMacroMetrics,
   readFirstFoldMonthlyQuick,
   readFirstFoldTopTasksAllTime,
   readFirstFoldViewport,
@@ -45,6 +46,7 @@ import {
   sqliteViewMetadata,
 } from "./sqlite-read-model-types.js";
 import { installLegacyViewAliases } from "./sqlite-snapshot-cache.js";
+import { encodeSummaryCursor, parseSummaryCursor } from "./sqlite-summary-cursor.js";
 export class SqliteReadModelFileSystem extends WorkspaceFileSystem {
   private readonly executionDurationCache = new Map<string, Map<string, number>>();
   private dailyAggregateRowsCache: Array<Record<string, number | string | null>> | null = null;
@@ -305,6 +307,10 @@ export class SqliteReadModelFileSystem extends WorkspaceFileSystem {
     return this.firstFoldAllTimeCache;
   }
 
+  firstFoldMacroMetrics(): SqliteFirstFoldAllTime["macro_metrics"] {
+    return this.firstFoldAllTimeCache?.macro_metrics ?? readFirstFoldMacroMetrics(this.database);
+  }
+
   firstFoldBoardAllTime(): SqliteFirstFoldAllTimeBoard {
     if (this.firstFoldAllTimeBoardCache !== null) return this.firstFoldAllTimeBoardCache;
     this.firstFoldAllTimeBoardCache = readFirstFoldBoardAllTime(this.database, () => {
@@ -438,6 +444,7 @@ export class SqliteReadModelFileSystem extends WorkspaceFileSystem {
   }
 
   invocationCostRows(filter: {
+    query?: string;
     from: string | null;
     to: string | null;
     providers?: readonly string[];
@@ -450,6 +457,10 @@ export class SqliteReadModelFileSystem extends WorkspaceFileSystem {
     prds?: readonly string[];
     executions?: readonly string[];
     changes?: readonly string[];
+    priorities?: readonly string[];
+    risks?: readonly string[];
+    origins?: readonly string[];
+    workTypes?: readonly string[];
   }) {
     return queryInvocationCostRows(this.queryContext(), filter);
   }
@@ -471,6 +482,7 @@ export class SqliteReadModelFileSystem extends WorkspaceFileSystem {
 
   /** Complete canonical Run population for global Cost Monitor aggregates. */
   activityCostRows(filter: {
+    query?: string;
     from: string | null;
     to: string | null;
     providers?: readonly string[];
@@ -483,6 +495,10 @@ export class SqliteReadModelFileSystem extends WorkspaceFileSystem {
     prds?: readonly string[];
     executions?: readonly string[];
     changes?: readonly string[];
+    priorities?: readonly string[];
+    risks?: readonly string[];
+    origins?: readonly string[];
+    workTypes?: readonly string[];
   }) {
     return queryActivityCostRows(this.queryContext(), filter);
   }
@@ -744,19 +760,3 @@ export class SqliteReadModelFileSystem extends WorkspaceFileSystem {
     };
   }
 }
-
-function encodeSummaryCursor(occurredAt: string, id: string): string {
-  return encodeURIComponent(JSON.stringify([occurredAt, id]));
-}
-
-function parseSummaryCursor(cursor: string | null): [string, string] | null {
-  if (cursor === null) return null;
-  try {
-    const parsed = JSON.parse(decodeURIComponent(cursor));
-    return Array.isArray(parsed) && typeof parsed[0] === "string" && typeof parsed[1] === "string"
-      ? [parsed[0], parsed[1]]
-      : null;
-  } catch {
-    return null;
-  }
-}

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

@@ -247,7 +247,7 @@ describe("SQLite dashboard read model multi-provider", () => {
         validation_count: null,
         evidence_count: null,
       });
-      expect(filesystem.viewPage(view, { workType: "new" }).total_count).toBe(0);
+      expect(filesystem.viewPage(view, { workType: "new" }).total_count).toBeGreaterThan(0);
     }
     expect(filesystem.viewPage("cost_monitor_zaip_agents", { priority: "high" })).toMatchObject({
       total_count: 0,

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

@@ -30,31 +30,25 @@ import {
   validateSqliteReadModelSchema,
 } from "./sqlite-read-model-schema.js";
 import { sourceFingerprint } from "./sqlite-read-model-source-fingerprint.js";
+import type { SqliteRebuildResult } from "./sqlite-rebuild-result.js";
 import { readSnapshotFileCount } from "./sqlite-snapshot-cache.js";
+import { deriveCanonicalWorkStages } from "./sqlite-work-stages.js";
 export async function rebuildSqliteReadModel(
   workspaceRoot: string,
   options: { forceCanonical?: boolean; preferExisting?: boolean } = {},
-): Promise<{
-  files: number;
-  path: string;
-  cache: "generation" | "seed" | "stale_seed" | "rebuilt";
-  fingerprint_ms: number;
-  materialize_ms: number;
-  refresh: {
-    reused_sources: number;
-    processed_sources: number;
-    added_sources: number;
-    changed_sources: number;
-    removed_sources: number;
-    canonical_runs_refolded: number;
-  };
-}> {
+): Promise<SqliteRebuildResult> {
   const path = sqliteReadModelPath(workspaceRoot);
-  // Bind immediately from the last complete transaction. The serving process
-  // checks canonical freshness in its worker before declaring this current.
+  // A reusable snapshot still has to match its canonical fingerprint. This
+  // avoids advertising every launch as stale while preserving the stale seed
+  // path for a changed source or an incompatible database.
   if (options.preferExisting && !options.forceCanonical) {
     try {
       validateSqliteReadModelSchema(path);
+      const fingerprintStartedAt = performance.now();
+      const sourceSnapshot = await sourceFingerprint(workspaceRoot, {
+        previous: persistedSourceCheckpoint(path),
+      });
+      const fingerprint = `${sourceSnapshot.fingerprint}\ncurrent_day=${saoPauloDay(new Date().toISOString())}`;
       const database = new DatabaseSync(path, { readOnly: true });
       try {
         if (hasReusableSnapshotPayloads(database)) {
@@ -63,15 +57,38 @@ 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,
+              },
+            };
+          }
           return {
             files: Number(row.value),
             path,
             cache: "stale_seed",
-            fingerprint_ms: 0,
+            fingerprint_ms: Math.round(performance.now() - fingerprintStartedAt),
             materialize_ms: 0,
             refresh: {
-              reused_sources: 0,
-              processed_sources: 0,
+              reused_sources: sourceSnapshot.reusedFiles,
+              processed_sources: sourceSnapshot.hashedFiles,
               added_sources: 0,
               changed_sources: 0,
               removed_sources: 0,
@@ -397,7 +414,7 @@ export async function rebuildSqliteReadModel(
         CREATE TEMP TABLE files (path TEXT PRIMARY KEY, content TEXT NOT NULL, mtime_ms REAL NOT NULL, size_bytes INTEGER NOT NULL, content_sha256 TEXT NOT NULL, artifact_kind TEXT, artifact_id TEXT, artifact_occurred_at TEXT, artifact_occurred_day_sp TEXT, artifact_task_id TEXT, artifact_change_id TEXT, artifact_run_id TEXT);
         CREATE TEMP TABLE read_model_source_state (source_path TEXT PRIMARY KEY, source_hash TEXT NOT NULL, mtime_ms TEXT NOT NULL, ctime_ms TEXT NOT NULL, size_bytes INTEGER NOT NULL, file_identity TEXT NOT NULL, source_kind TEXT NOT NULL, last_processed_at TEXT NOT NULL);
         CREATE TEMP TABLE read_model_metadata (key TEXT PRIMARY KEY, value TEXT NOT NULL);
-        CREATE TEMP TABLE canonical_work_items (entity_kind TEXT NOT NULL, id TEXT NOT NULL, title TEXT, status TEXT, stage TEXT, risk TEXT, spec_id TEXT, change_id TEXT, creation_run_id TEXT, completed_run_id TEXT, occurred_at TEXT NOT NULL, occurred_day_sp TEXT NOT NULL, PRIMARY KEY(entity_kind, id));
+        CREATE TEMP TABLE canonical_work_items (entity_kind TEXT NOT NULL, id TEXT NOT NULL, title TEXT, status TEXT, stage TEXT, risk TEXT, priority TEXT, spec_id TEXT, prd_id TEXT, change_id TEXT, creation_run_id TEXT, completed_run_id TEXT, occurred_at TEXT NOT NULL, occurred_day_sp TEXT NOT NULL, PRIMARY KEY(entity_kind, id));
         CREATE TEMP TABLE canonical_executions (id TEXT PRIMARY KEY, status TEXT, kind TEXT, origin_type TEXT, origin_id TEXT, created_at TEXT NOT NULL, occurred_day_sp TEXT NOT NULL, finished_at TEXT, source_path TEXT NOT NULL);
         CREATE TEMP TABLE canonical_changes (id TEXT PRIMARY KEY, title TEXT NOT NULL, status TEXT NOT NULL, risk TEXT NOT NULL, source_type TEXT NOT NULL, source_id TEXT NOT NULL, source_spec_id TEXT, source_prd_id TEXT, requirement_ids_json TEXT NOT NULL, acceptance_ids_json TEXT NOT NULL, task_ids_json TEXT NOT NULL, result TEXT, created_at TEXT NOT NULL, occurred_day_sp TEXT NOT NULL, source_path TEXT NOT NULL);
         CREATE TEMP TABLE canonical_decisions (id TEXT PRIMARY KEY, title TEXT NOT NULL, origin TEXT NOT NULL, scope_type TEXT NOT NULL, scope_id TEXT NOT NULL, created_at TEXT NOT NULL, occurred_day_sp TEXT NOT NULL, source_path TEXT NOT NULL);
@@ -599,7 +616,7 @@ export async function rebuildSqliteReadModel(
             if (entity.creationRunId) changedCreationRunIds.add(entity.creationRunId);
       reportLaunchProgress("projection_entities", 75, "Entidades canônicas interpretadas.");
       const insertCanonicalWorkItem = database.prepare(
-        "INSERT INTO canonical_work_items(entity_kind, id, title, status, stage, risk, spec_id, change_id, creation_run_id, completed_run_id, occurred_at, occurred_day_sp) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)",
+        "INSERT INTO canonical_work_items(entity_kind, id, title, status, stage, risk, priority, spec_id, prd_id, change_id, creation_run_id, completed_run_id, occurred_at, occurred_day_sp) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)",
       );
       for (const entity of canonicalEntities.values()) {
         if (
@@ -615,7 +632,9 @@ export async function rebuildSqliteReadModel(
           entity.status,
           entity.stage,
           entity.risk,
+          entity.priority,
           entity.specId,
+          entity.prdId,
           entity.changeId,
           entity.creationRunId,
           entity.completedRunId,
@@ -700,6 +719,12 @@ export async function rebuildSqliteReadModel(
           entity.sourcePath,
         );
       reportLaunchProgress("projection_runs_started", 77, "Construindo fatos das invocações.");
+      deriveCanonicalWorkStages(canonicalEntities, canonicalLifecycle.changes);
+      const updateWorkStage = database.prepare(
+        "UPDATE canonical_work_items SET stage=? WHERE entity_kind=? AND id=?",
+      );
+      for (const entity of canonicalEntities.values())
+        updateWorkStage.run(entity.stage, entity.kind, entity.id);
       const runMaterialization = materializeCanonicalRuns({
         database,
         previousActivities,

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

@@ -4,9 +4,10 @@ import { DatabaseSync } from "node:sqlite";
 import { hasRequiredFirstFoldPayloads } from "./sqlite-first-fold-persistence.js";
 import type { SqliteReadModelSourceCheckpoint } from "./sqlite-read-model-source-fingerprint.js";
 export const dbRelativePath = ".local/sqlite/zaip-aios-dashboard.sqlite";
-// Schema 80 requires the persisted macro classification fields used by period views.
+// Schema 83 adds canonical priority, Run work type and reconciled macro stages.
 // Old snapshots must rebuild even when their canonical hashes still match.
-export const readModelSchemaVersion = "80";
+// Refresh persisted first-fold summaries after factual duration/coverage semantics change.
+export const readModelSchemaVersion = "84";
 export const requiredPersistedTables = [
   "zaip_aios_activities",
   "zaip_dim_llm_model",

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

@@ -87,6 +87,17 @@ describe("SQLite dashboard read model", () => {
       filesystem.close();
     }
   });
+  it("reuses an unchanged verified fingerprint as the current generation", async () => {
+    const root = await createSqliteTestRoot();
+    roots.push(root);
+    await mkdir(join(root, ".agents/config"), { recursive: true });
+    await writeFile(join(root, ".agents/config/project.yaml"), "zaip:\n  enabled: true\n");
+    vi.spyOn(Date, "now").mockReturnValue(Date.now() + 5_000);
+    await rebuildSqliteReadModel(root);
+    await expect(rebuildSqliteReadModel(root, { preferExisting: true })).resolves.toMatchObject({
+      cache: "generation",
+    });
+  });
   it("rolls back a failed refresh including first-fold payloads while a reader remains open", async () => {
     const root = await createSqliteTestRoot();
     roots.push(root);

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

@@ -0,0 +1,15 @@
+export type SqliteRebuildResult = {
+  files: number;
+  path: string;
+  cache: "generation" | "seed" | "stale_seed" | "rebuilt";
+  fingerprint_ms: number;
+  materialize_ms: number;
+  refresh: {
+    reused_sources: number;
+    processed_sources: number;
+    added_sources: number;
+    changed_sources: number;
+    removed_sources: number;
+    canonical_runs_refolded: number;
+  };
+};

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-schema-base-views.ts

@@ -25,7 +25,7 @@ export const baseViewSql = `
         CREATE VIEW files AS SELECT json_extract(payload_json, '$.path') AS path, json_extract(payload_json, '$.content') AS content, json_extract(payload_json, '$.mtime_ms') AS mtime_ms, json_extract(payload_json, '$.size_bytes') AS size_bytes, json_extract(payload_json, '$.content_sha256') AS content_sha256, json_extract(payload_json, '$.artifact_kind') AS artifact_kind, json_extract(payload_json, '$.artifact_id') AS artifact_id, json_extract(payload_json, '$.artifact_occurred_at') AS artifact_occurred_at, json_extract(payload_json, '$.artifact_occurred_day_sp') AS artifact_occurred_day_sp, json_extract(payload_json, '$.artifact_task_id') AS artifact_task_id, json_extract(payload_json, '$.artifact_change_id') AS artifact_change_id, json_extract(payload_json, '$.artifact_run_id') AS artifact_run_id FROM zaip_aios_activities INDEXED BY zaip_activities_file_path WHERE payload_type='file';
         CREATE VIEW read_model_source_state AS SELECT json_extract(payload_json, '$.source_path') AS source_path, json_extract(payload_json, '$.source_hash') AS source_hash, json_extract(payload_json, '$.mtime_ms') AS mtime_ms, json_extract(payload_json, '$.ctime_ms') AS ctime_ms, json_extract(payload_json, '$.size_bytes') AS size_bytes, json_extract(payload_json, '$.file_identity') AS file_identity, json_extract(payload_json, '$.source_kind') AS source_kind, json_extract(payload_json, '$.last_processed_at') AS last_processed_at FROM zaip_aios_activities WHERE payload_type='source_state';
         CREATE VIEW read_model_metadata AS SELECT json_extract(payload_json, '$.key') AS key, json_extract(payload_json, '$.value') AS value FROM zaip_aios_activities WHERE payload_type='metadata';
-        CREATE VIEW canonical_work_items AS SELECT json_extract(payload_json, '$.entity_kind') AS entity_kind, json_extract(payload_json, '$.id') AS id, json_extract(payload_json, '$.title') AS title, json_extract(payload_json, '$.status') AS status, json_extract(payload_json, '$.stage') AS stage, json_extract(payload_json, '$.risk') AS risk, json_extract(payload_json, '$.spec_id') AS spec_id, json_extract(payload_json, '$.change_id') AS change_id, json_extract(payload_json, '$.creation_run_id') AS creation_run_id, json_extract(payload_json, '$.completed_run_id') AS completed_run_id, json_extract(payload_json, '$.occurred_at') AS occurred_at, json_extract(payload_json, '$.occurred_day_sp') AS occurred_day_sp FROM zaip_aios_activities WHERE payload_type='work_item';
+        CREATE VIEW canonical_work_items AS SELECT json_extract(payload_json, '$.entity_kind') AS entity_kind, json_extract(payload_json, '$.id') AS id, json_extract(payload_json, '$.title') AS title, json_extract(payload_json, '$.status') AS status, json_extract(payload_json, '$.stage') AS stage, json_extract(payload_json, '$.risk') AS risk, json_extract(payload_json, '$.priority') AS priority, json_extract(payload_json, '$.spec_id') AS spec_id, json_extract(payload_json, '$.prd_id') AS prd_id, json_extract(payload_json, '$.change_id') AS change_id, json_extract(payload_json, '$.creation_run_id') AS creation_run_id, json_extract(payload_json, '$.completed_run_id') AS completed_run_id, json_extract(payload_json, '$.occurred_at') AS occurred_at, json_extract(payload_json, '$.occurred_day_sp') AS occurred_day_sp FROM zaip_aios_activities WHERE payload_type='work_item';
         CREATE VIEW canonical_executions AS SELECT json_extract(payload_json, '$.id') AS id, json_extract(payload_json, '$.status') AS status, json_extract(payload_json, '$.kind') AS kind, json_extract(payload_json, '$.origin_type') AS origin_type, json_extract(payload_json, '$.origin_id') AS origin_id, json_extract(payload_json, '$.created_at') AS created_at, json_extract(payload_json, '$.occurred_day_sp') AS occurred_day_sp, json_extract(payload_json, '$.finished_at') AS finished_at, json_extract(payload_json, '$.source_path') AS source_path FROM zaip_aios_activities WHERE payload_type='execution';
         CREATE VIEW canonical_changes AS SELECT json_extract(payload_json, '$.id') AS id, json_extract(payload_json, '$.title') AS title, json_extract(payload_json, '$.status') AS status, json_extract(payload_json, '$.risk') AS risk, json_extract(payload_json, '$.source_type') AS source_type, json_extract(payload_json, '$.source_id') AS source_id, json_extract(payload_json, '$.source_spec_id') AS source_spec_id, json_extract(payload_json, '$.source_prd_id') AS source_prd_id, json_extract(payload_json, '$.requirement_ids_json') AS requirement_ids_json, json_extract(payload_json, '$.acceptance_ids_json') AS acceptance_ids_json, json_extract(payload_json, '$.task_ids_json') AS task_ids_json, json_extract(payload_json, '$.result') AS result, json_extract(payload_json, '$.created_at') AS created_at, json_extract(payload_json, '$.occurred_day_sp') AS occurred_day_sp, json_extract(payload_json, '$.source_path') AS source_path FROM zaip_aios_activities WHERE payload_type='change';
         CREATE VIEW canonical_decisions AS SELECT json_extract(payload_json, '$.id') AS id, json_extract(payload_json, '$.title') AS title, json_extract(payload_json, '$.origin') AS origin, json_extract(payload_json, '$.scope_type') AS scope_type, json_extract(payload_json, '$.scope_id') AS scope_id, json_extract(payload_json, '$.created_at') AS created_at, json_extract(payload_json, '$.occurred_day_sp') AS occurred_day_sp, json_extract(payload_json, '$.source_path') AS source_path FROM zaip_aios_activities WHERE payload_type='decision';
@@ -63,10 +63,10 @@ export const baseViewSql = `
         CREATE VIEW agent_runs AS SELECT * FROM activities WHERE activity_source_kind = 'agent_run';
         CREATE VIEW root_runs AS SELECT * FROM activities WHERE run_role = 'root';
         CREATE VIEW sub_runs AS SELECT * FROM activities WHERE run_role = 'subrun';
-        CREATE VIEW invocations AS SELECT activity_row_id, activity_key, version_activity_id, source_occurred_at, root_agent_run_id AS root_agent_invocation_id, parent_agent_run_id AS parent_agent_invocation_id, execution_id, task_id, spec_id, prd_id, change_id, conversation_id, run_id, occurred_at, occurred_day_sp, invocation_kind, delegation_depth, zaip_agent, zaip_agent_persona, zaip_agent_job, zaip_agent_role, client, provider, model, phase, purpose, status, source_started_at, source_finished_at, attributed_token_active_ms, attributed_token_active_ms AS duration_ms, CASE WHEN attributed_token_active_ms IS NOT NULL THEN 'observed' ELSE 'unavailable' END AS duration_provenance, CASE WHEN attributed_token_active_ms IS NOT NULL THEN 'attributed_token_active' ELSE NULL END AS duration_fact_provenance, input_tokens, cached_input_tokens, output_tokens, reasoning_tokens, total_tokens, token_source, cost_usd, cost_brl, cost_method, pricing_model, pricing_source, fx_rate, service_tier, reasoning_effort, source_event_count, usage_event_count, llm_call_count, agent_run_id AS agent_invocation_id FROM agent_runs;
+        CREATE VIEW invocations AS SELECT activity_row_id, activity_key, version_activity_id, source_occurred_at, root_agent_run_id AS root_agent_invocation_id, parent_agent_run_id AS parent_agent_invocation_id, execution_id, task_id, spec_id, prd_id, change_id, conversation_id, run_id, occurred_at, occurred_day_sp, invocation_kind, delegation_depth, zaip_agent, zaip_agent_persona, zaip_agent_job, zaip_agent_role, client, provider, model, work_type, phase, purpose, status, source_started_at, source_finished_at, attributed_token_active_ms, attributed_token_active_ms AS duration_ms, CASE WHEN attributed_token_active_ms IS NOT NULL THEN 'observed' ELSE 'unavailable' END AS duration_provenance, CASE WHEN attributed_token_active_ms IS NOT NULL THEN 'attributed_token_active' ELSE NULL END AS duration_fact_provenance, input_tokens, cached_input_tokens, output_tokens, reasoning_tokens, total_tokens, token_source, cost_usd, cost_brl, cost_method, pricing_model, pricing_source, fx_rate, service_tier, reasoning_effort, source_event_count, usage_event_count, llm_call_count, agent_run_id AS agent_invocation_id FROM agent_runs;
         CREATE VIEW invocation_usage AS SELECT agent_invocation_id, agent_invocation_id AS usage_index, provider, model, service_tier, reasoning_effort, input_tokens, cached_input_tokens, uncached_input_tokens, output_tokens, reasoning_tokens, visible_output_tokens, total_tokens, input_rate_usd_per_million, cached_input_rate_usd_per_million, output_rate_usd_per_million, reasoning_rate_usd_per_million, context_input_multiplier, context_output_multiplier, speed_cost_multiplier, pricing_scenario, standard_cost_usd, speed_uplift_usd, input_cost_usd, cached_input_cost_usd, output_cost_usd, reasoning_cost_usd, calculated_cost_usd, recorded_cost_usd, cost_variance_usd, cost_usd, cost_brl, cost_method, pricing_model, pricing_source, fx_rate FROM invocation_usage_segments;
-        CREATE VIEW work_items AS SELECT entity_kind, id, title, status, risk, occurred_at, occurred_day_sp FROM canonical_work_items UNION ALL SELECT 'task', task_id, COALESCE(MAX(title), task_id), MAX(work_item_status), MAX(risk), MIN(occurred_at), MIN(occurred_day_sp) FROM activities WHERE task_id IS NOT NULL AND NOT EXISTS (SELECT 1 FROM canonical_work_items c WHERE c.entity_kind='task' AND c.id=activities.task_id) GROUP BY task_id UNION ALL SELECT 'spec', spec_id, COALESCE(MAX(title), spec_id), MAX(work_item_status), MAX(risk), MIN(occurred_at), MIN(occurred_day_sp) FROM activities WHERE spec_id IS NOT NULL AND NOT EXISTS (SELECT 1 FROM canonical_work_items c WHERE c.entity_kind='spec' AND c.id=activities.spec_id) GROUP BY spec_id UNION ALL SELECT 'prd', prd_id, COALESCE(MAX(title), prd_id), MAX(work_item_status), MAX(risk), MIN(occurred_at), MIN(occurred_day_sp) FROM activities WHERE prd_id IS NOT NULL AND NOT EXISTS (SELECT 1 FROM canonical_work_items c WHERE c.entity_kind='prd' AND c.id=activities.prd_id) GROUP BY prd_id;
-        CREATE VIEW tasks AS SELECT id, title, status, risk, occurred_at, occurred_day_sp FROM work_items WHERE entity_kind = 'task';
+        CREATE VIEW work_items AS SELECT entity_kind, id, title, status, risk, priority, occurred_at, occurred_day_sp FROM canonical_work_items UNION ALL SELECT 'task', task_id, COALESCE(MAX(title), task_id), MAX(work_item_status), MAX(risk), NULL, MIN(occurred_at), MIN(occurred_day_sp) FROM activities WHERE task_id IS NOT NULL AND NOT EXISTS (SELECT 1 FROM canonical_work_items c WHERE c.entity_kind='task' AND c.id=activities.task_id) GROUP BY task_id UNION ALL SELECT 'spec', spec_id, COALESCE(MAX(title), spec_id), MAX(work_item_status), MAX(risk), NULL, MIN(occurred_at), MIN(occurred_day_sp) FROM activities WHERE spec_id IS NOT NULL AND NOT EXISTS (SELECT 1 FROM canonical_work_items c WHERE c.entity_kind='spec' AND c.id=activities.spec_id) GROUP BY spec_id UNION ALL SELECT 'prd', prd_id, COALESCE(MAX(title), prd_id), MAX(work_item_status), MAX(risk), NULL, MIN(occurred_at), MIN(occurred_day_sp) FROM activities WHERE prd_id IS NOT NULL AND NOT EXISTS (SELECT 1 FROM canonical_work_items c WHERE c.entity_kind='prd' AND c.id=activities.prd_id) GROUP BY prd_id;
+        CREATE VIEW tasks AS SELECT id, title, status, risk, priority, occurred_at, occurred_day_sp FROM work_items WHERE entity_kind = 'task';
         CREATE VIEW specs AS SELECT id, title, status, risk, occurred_at, occurred_day_sp FROM work_items WHERE entity_kind = 'spec';
         CREATE VIEW prds AS SELECT id, title, status, risk, occurred_at, occurred_day_sp FROM work_items WHERE entity_kind = 'prd';
         CREATE VIEW executions AS