@zaip-ai/cli 1.0.8 → 1.3.1

package/templates/.agents/dashboard/packages/local-runtime/scripts/test-unix-launchers.mjs

@@ -32,10 +32,22 @@ for (const launcher of launchers) {
 const linuxLauncher = await readFile(resolve(workspaceRoot, launchers[0]), "utf8");
 assert.match(linuxLauncher, /command -v node/, "Linux launcher must resolve Node from PATH");
 assert.match(linuxLauncher, /ZAIP_NODE/, "Linux launcher must allow an explicit Node executable");
-assert.match(linuxLauncher, /Node\.js 22 ou superior/, "Linux launcher must report an actionable Node version failure");
+assert.match(
+  linuxLauncher,
+  /Node\.js 22 ou superior/,
+  "Linux launcher must report an actionable Node version failure",
+);
 assert.match(linuxLauncher, /node:sqlite/, "Linux launcher must verify node:sqlite");
-assert.match(linuxLauncher, /exec "\$node_bin" "\$runtime" "\$@"/, "Linux launcher must preserve arguments and runtime exit code");
+assert.match(
+  linuxLauncher,
+  /exec "\$node_bin" "\$runtime" "\$@"/,
+  "Linux launcher must preserve arguments and runtime exit code",
+);
 
 const macLauncher = await readFile(resolve(workspaceRoot, launchers[1]), "utf8");
-assert.match(macLauncher, /exec .*zaip-dashboard-linux\.sh.*"\$@"/, "macOS launcher must delegate and preserve arguments/exit code");
+assert.match(
+  macLauncher,
+  /exec .*zaip-dashboard-linux\.sh.*"\$@"/,
+  "macOS launcher must delegate and preserve arguments/exit code",
+);
 process.stdout.write("Unix dashboard launcher contract passed.\n");

package/templates/.agents/dashboard/packages/local-runtime/scripts/validate-sqlite-read-model.mjs

@@ -1,15 +1,18 @@
 import assert from "node:assert/strict";
-import { DatabaseSync } from "node:sqlite";
 import { resolve } from "node:path";
+import { DatabaseSync } from "node:sqlite";
 
 const workspaceRoot = resolve(import.meta.dirname, "../../../../..");
-const databasePath = process.env.ZAIP_SQLITE_DB_PATH ?? resolve(workspaceRoot, ".local/dashboard-sqlite/read-model.sqlite");
+const databasePath =
+  process.env.ZAIP_SQLITE_DB_PATH ??
+  resolve(workspaceRoot, ".local/dashboard-sqlite/read-model.sqlite");
 const runtime = await import("../dist/server.cjs");
 const schema = runtime.validateSqliteReadModelSchema(databasePath);
 const database = new DatabaseSync(databasePath, { readOnly: true });
 
 try {
-  const metrics = database.prepare(`
+  const metrics = database
+    .prepare(`
     SELECT
       COUNT(*) AS activity_count,
       COUNT(DISTINCT run_id) AS distinct_run_count,
@@ -17,6 +20,7 @@ try {
       SUM(total_tokens > 0) AS positive_token_count,
       SUM(total_tokens = 0) AS zero_token_count,
       SUM(total_tokens IS NULL) AS unknown_token_count,
+      SUM(activity_source_kind = 'agent_run' AND total_tokens IS NULL) AS unknown_agent_run_count,
       SUM(total_tokens > 0 AND duration_ms IS NULL) AS positive_token_unknown_duration_count,
       SUM(total_tokens > 0 AND duration_ms IS NULL AND duration_provenance IS NOT NULL) AS positive_token_unknown_duration_with_provenance_count,
       SUM(total_tokens IS NOT NULL AND (cost_usd IS NULL OR cost_brl IS NULL)) AS known_token_missing_cost_count,
@@ -26,16 +30,31 @@ try {
       SUM(activity_source_kind = 'unassisted_turn') AS unassisted_turn_count
     FROM zaip_aios_activities
     WHERE payload_type IS NULL
-  `).get();
-  const excluded = database.prepare(`
+  `)
+    .get();
+  const excluded = database
+    .prepare(`
     SELECT COUNT(*) AS count
     FROM zaip_vw_files
-    WHERE path LIKE '.agents/records/lifecycle/%'
+    WHERE (path LIKE '.agents/records/lifecycle/%'
+           AND path <> '.agents/records/lifecycle/historical-developer-attribution/HDA-2026-08-29-ZAIP-AI-C3D4.json')
        OR path LIKE '.agents/records/telemetry/%'
-  `).get();
-  const schemaObjects = new Map(database.prepare("SELECT name, type FROM sqlite_master WHERE type IN ('table', 'view')").all().map(({ name, type }) => [name, type]));
-  const metadata = Object.fromEntries(database.prepare("SELECT key, value FROM zaip_vw_read_model_metadata").all().map(({ key, value }) => [key, value]));
-  const invocationAudit = database.prepare(`
+  `)
+    .get();
+  const schemaObjects = new Map(
+    database
+      .prepare("SELECT name, type FROM sqlite_master WHERE type IN ('table', 'view')")
+      .all()
+      .map(({ name, type }) => [name, type]),
+  );
+  const metadata = Object.fromEntries(
+    database
+      .prepare("SELECT key, value FROM zaip_vw_read_model_metadata")
+      .all()
+      .map(({ key, value }) => [key, value]),
+  );
+  const invocationAudit = database
+    .prepare(`
     SELECT
       COUNT(*) AS invocation_count,
       SUM(invocation_kind = 'delegated') AS delegated_invocation_count,
@@ -51,30 +70,111 @@ try {
         COALESCE(calculated_cost_usd, 0)
       ) > 0.000002) AS component_mismatch_count
     FROM zaip_vw_operations_agent_invocations
-  `).get();
+  `)
+    .get();
 
-  assert.equal(metrics.activity_count, metrics.distinct_run_count, "A fato deve ter exatamente uma linha por run_id");
-  assert.equal(metrics.unknown_token_count, 0, "A fato não deve conter Runs com total_tokens desconhecido");
-  assert.equal(metrics.positive_token_unknown_duration_with_provenance_count, 0, "Duração ausente deve permanecer NULL, sem proveniência inventada");
-  assert.equal(metrics.known_token_missing_cost_count, 0, "Token conhecido exige custo conhecido ou estimado");
-  assert.equal(excluded.count, 0, "Lifecycle e telemetria agregada não podem entrar no snapshot");
-  assert.equal(Number(metadata.canonical_run_count), metrics.activity_count + Number(metadata.excluded_unknown_token_run_count), "A fato mais os Runs excluídos deve coincidir com a origem canônica");
-  assert.equal(Number(metadata.agent_run_count), metrics.agent_run_count, "agent_run_count deve coincidir com a fato");
-  assert.equal(Number(metadata.unassisted_turn_count), metrics.unassisted_turn_count, "unassisted_turn_count deve coincidir com a fato");
-  assert.equal(invocationAudit.invocation_count, metrics.agent_run_count, "A view de invocações deve preservar uma linha por Agent Run");
-  assert.equal(invocationAudit.missing_tokens_count, 0, "Toda invocação contabilizada deve expor tokens totais");
-  assert.equal(invocationAudit.missing_effective_cost_count, 0, "Toda invocação contabilizada deve expor custo efetivo USD e BRL");
-  assert.equal(invocationAudit.missing_calculated_cost_count, 0, "Toda invocação deve permitir reproduzir o custo pelo Guide");
-  assert.equal(invocationAudit.component_mismatch_count, 0, "As parcelas de custo devem somar o custo calculado");
+  assert.equal(
+    metrics.activity_count,
+    metrics.distinct_run_count,
+    "A fato deve ter exatamente uma linha por run_id",
+  );
+  assert.equal(
+    metrics.positive_token_unknown_duration_with_provenance_count,
+    0,
+    "Duração ausente deve permanecer NULL, sem proveniência inventada",
+  );
+  assert.equal(
+    metrics.known_token_missing_cost_count,
+    0,
+    "Token conhecido exige custo conhecido ou estimado",
+  );
+  assert.equal(
+    excluded.count,
+    0,
+    "Somente o manifesto histórico C3D4 pode entrar; lifecycle e telemetria agregada continuam excluídos",
+  );
+  assert.equal(
+    Number(metadata.canonical_run_count),
+    metrics.activity_count,
+    "Todo Run canônico deve permanecer na fato; telemetria desconhecida fica NULL",
+  );
+  assert.equal(
+    Number(metadata.excluded_unknown_token_run_count),
+    0,
+    "Runs com telemetria desconhecida não podem ser excluídos da fato",
+  );
+  assert.equal(
+    Number(metadata.agent_run_count),
+    metrics.agent_run_count,
+    "agent_run_count deve coincidir com a fato",
+  );
+  assert.equal(
+    Number(metadata.unassisted_turn_count),
+    metrics.unassisted_turn_count,
+    "unassisted_turn_count deve coincidir com a fato",
+  );
+  assert.equal(
+    invocationAudit.invocation_count,
+    metrics.agent_run_count,
+    "A view de invocações deve preservar uma linha por Agent Run",
+  );
+  assert.equal(
+    invocationAudit.missing_tokens_count,
+    metrics.unknown_agent_run_count,
+    "Tokens ausentes em invocações devem coincidir com a cobertura desconhecida da fato",
+  );
+  assert.equal(
+    invocationAudit.missing_effective_cost_count,
+    metrics.unknown_agent_run_count,
+    "Custo ausente só é permitido quando a cobertura de tokens é desconhecida",
+  );
+  assert.equal(
+    invocationAudit.missing_calculated_cost_count,
+    metrics.unknown_agent_run_count,
+    "Custo calculado ausente só é permitido quando a cobertura de tokens é desconhecida",
+  );
+  assert.equal(
+    invocationAudit.component_mismatch_count,
+    0,
+    "As parcelas de custo devem somar o custo calculado",
+  );
 
-  assert.equal(schemaObjects.get("canonical_artifacts"), undefined, "canonical_artifacts must not be a physical or unprefixed object");
-  assert.equal(schemaObjects.get("zaip_vw_canonical_artifacts"), "view", "canonical_artifacts must be a prefixed view");
+  assert.equal(
+    schemaObjects.get("canonical_artifacts"),
+    undefined,
+    "canonical_artifacts must not be a physical or unprefixed object",
+  );
+  assert.equal(
+    schemaObjects.get("zaip_vw_canonical_artifacts"),
+    "view",
+    "canonical_artifacts must be a prefixed view",
+  );
   assert.deepEqual(
-    [...schemaObjects].filter(([, type]) => type === "table").map(([name]) => name).sort(),
-    ["cost_invocation_dimension_facts", "zaip_aios_activities", "zaip_dim_llm_model", "zaip_dim_provider", "zaip_dim_zaip_agent"],
+    [...schemaObjects]
+      .filter(([, type]) => type === "table")
+      .map(([name]) => name)
+      .sort(),
+    [
+      "cost_group_daily_projection",
+      "cost_group_entity_projection",
+      "cost_invocation_dimension_facts",
+      "developer_cost_projection",
+      "operations_work_projection",
+      "zaip_aios_activities",
+      "zaip_dim_llm_model",
+      "zaip_dim_provider",
+      "zaip_dim_zaip_agent",
+    ],
     "the isolated candidate must persist exactly the fact, dimensions, and financial dimension fact",
   );
-  assert.equal([...schemaObjects].filter(([name, type]) => type === "view" && (!name.startsWith("zaip_vw_") || name.startsWith("zaip_vw_vw_"))).length, 0, "Each view must have exactly one zaip_vw_ prefix");
+  assert.equal(
+    [...schemaObjects].filter(
+      ([name, type]) =>
+        type === "view" && (!name.startsWith("zaip_vw_") || name.startsWith("zaip_vw_vw_")),
+    ).length,
+    0,
+    "Each view must have exactly one zaip_vw_ prefix",
+  );
 
   const costEntityViews = [
     ["zaip_vw_cost_monitor_tasks", "task_id"],
@@ -85,7 +185,8 @@ try {
   ];
   let invalidCostEntityRowCount = 0;
   for (const [view, id] of costEntityViews) {
-    const result = database.prepare(`
+    const result = database
+      .prepare(`
       SELECT COUNT(*) AS count
       FROM ${view}
       WHERE ${id} IS NULL
@@ -94,12 +195,19 @@ try {
          OR occurred_at IS NULL
          OR occurred_at LIKE '1969-%'
          OR occurred_at LIKE '1970-%'
-    `).get();
+    `)
+      .get();
     invalidCostEntityRowCount += Number(result.count);
   }
-  assert.equal(invalidCostEntityRowCount, 0, "Cost entity views require canonical IDs, titles, and non-epoch timestamps");
+  assert.equal(
+    invalidCostEntityRowCount,
+    0,
+    "Cost entity views require canonical IDs, titles, and non-epoch timestamps",
+  );
 
-  process.stdout.write(`${JSON.stringify({ database_path: databasePath, schema_version: metadata.schema_version, ...schema, ...metrics, ...invocationAudit, excluded_derived_source_count: excluded.count, invalid_cost_entity_row_count: invalidCostEntityRowCount })}\n`);
+  process.stdout.write(
+    `${JSON.stringify({ database_path: databasePath, schema_version: metadata.schema_version, ...schema, ...metrics, ...invocationAudit, excluded_derived_source_count: excluded.count, invalid_cost_entity_row_count: invalidCostEntityRowCount })}\n`,
+  );
 } finally {
   database.close();
 }