@arcbridge/core 0.1.1 → 0.1.3

package/dist/index.js

@@ -44,6 +44,11 @@ var ArcBridgeConfigSchema = z.object({
       "File paths or prefixes to ignore in undocumented_module drift checks. Framework files (e.g. next.config.ts, root layout/page) are auto-ignored for known project types."
     )
   }).default({}),
+  metrics: z.object({
+    auto_record: z.boolean().default(false).describe(
+      "Automatically record agent activity (tool name, duration, quality snapshot) when key MCP tools are invoked. Token/model info is optional and caller-provided."
+    )
+  }).default({}),
   sync: z.object({
     auto_detect_drift: z.boolean().default(true),
     drift_severity_threshold: z.enum(["info", "warning", "error"]).default("warning"),
@@ -205,19 +210,97 @@ var AgentRoleSchema = z6.object({
 });
 
 // src/db/connection.ts
-import Database from "better-sqlite3";
+import { DatabaseSync } from "node:sqlite";
+var suppressed = false;
+function suppressSqliteWarning() {
+  if (suppressed) return;
+  suppressed = true;
+  const origEmit = process.emit;
+  process.emit = function(event, ...args) {
+    if (event === "warning" && args[0]?.name === "ExperimentalWarning" && typeof args[0]?.message === "string" && args[0].message.includes("SQLite")) {
+      return true;
+    }
+    return origEmit.apply(process, [event, ...args]);
+  };
+}
+function sanitizeParams(params) {
+  return params.map((p) => p === void 0 ? null : p);
+}
 function openDatabase(dbPath) {
-  const db = new Database(dbPath);
-  db.pragma("journal_mode = WAL");
-  db.pragma("foreign_keys = ON");
+  const db = new DatabaseSync(dbPath);
+  db.exec("PRAGMA journal_mode = WAL");
+  db.exec("PRAGMA foreign_keys = ON");
+  patchPrepare(db);
   return db;
 }
 function openMemoryDatabase() {
-  return openDatabase(":memory:");
+  const db = new DatabaseSync(":memory:");
+  db.exec("PRAGMA foreign_keys = ON");
+  patchPrepare(db);
+  return db;
+}
+function patchPrepare(db) {
+  const originalPrepare = db.prepare.bind(db);
+  db.prepare = (sql) => {
+    const stmt = originalPrepare(sql);
+    const origRun = stmt.run.bind(stmt);
+    const origGet = stmt.get.bind(stmt);
+    const origAll = stmt.all.bind(stmt);
+    stmt.run = (...params) => origRun(...sanitizeParams(params));
+    stmt.get = (...params) => origGet(...sanitizeParams(params));
+    stmt.all = (...params) => origAll(...sanitizeParams(params));
+    return stmt;
+  };
+}
+function rejectAsync(fn) {
+  if (fn.constructor.name === "AsyncFunction") {
+    throw new Error(
+      "transaction() received an async function. Use a synchronous function \u2014 node:sqlite is synchronous and the transaction would commit before the async work completes."
+    );
+  }
+}
+var txDepth = /* @__PURE__ */ new WeakMap();
+function transaction(db, fn) {
+  rejectAsync(fn);
+  const depth = txDepth.get(db) ?? 0;
+  if (depth === 0) {
+    db.exec("BEGIN");
+    txDepth.set(db, 1);
+    try {
+      const result = fn();
+      db.exec("COMMIT");
+      return result;
+    } catch (err) {
+      try {
+        db.exec("ROLLBACK");
+      } catch {
+      }
+      throw err;
+    } finally {
+      txDepth.set(db, 0);
+    }
+  }
+  const name = `sp_${depth}`;
+  db.exec(`SAVEPOINT ${name}`);
+  txDepth.set(db, depth + 1);
+  try {
+    const result = fn();
+    db.exec(`RELEASE ${name}`);
+    return result;
+  } catch (err) {
+    try {
+      db.exec(`ROLLBACK TO ${name}`);
+      db.exec(`RELEASE ${name}`);
+    } catch {
+    }
+    throw err;
+  } finally {
+    txDepth.set(db, depth);
+  }
 }
 
 // src/db/schema.ts
-var CURRENT_SCHEMA_VERSION = 1;
+var CURRENT_SCHEMA_VERSION = 2;
 var SCHEMA_SQL = `
 -- Metadata
 CREATE TABLE IF NOT EXISTS arcbridge_meta (
@@ -383,6 +466,36 @@ CREATE TABLE IF NOT EXISTS drift_log (
   resolution TEXT CHECK(resolution IN ('accepted','fixed','deferred') OR resolution IS NULL),
   resolved_at TEXT
 );
+
+-- Agent Activity Metrics (operational telemetry, not rebuilt by refreshFromDocs)
+CREATE TABLE IF NOT EXISTS agent_activity (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  tool_name TEXT NOT NULL,
+  action TEXT,
+  model TEXT,
+  agent_role TEXT,
+  task_id TEXT,
+  phase_id TEXT,
+  input_tokens INTEGER,
+  output_tokens INTEGER,
+  total_tokens INTEGER,
+  cost_usd REAL,
+  duration_ms INTEGER,
+  drift_count INTEGER,
+  drift_errors INTEGER,
+  test_pass_count INTEGER,
+  test_fail_count INTEGER,
+  lint_clean INTEGER,
+  typecheck_clean INTEGER,
+  notes TEXT,
+  metadata TEXT NOT NULL DEFAULT '{}',
+  recorded_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_activity_recorded_at ON agent_activity(recorded_at);
+CREATE INDEX IF NOT EXISTS idx_activity_model ON agent_activity(model);
+CREATE INDEX IF NOT EXISTS idx_activity_task ON agent_activity(task_id);
+CREATE INDEX IF NOT EXISTS idx_activity_phase ON agent_activity(phase_id);
 `;
 function initializeSchema(db) {
   db.exec(SCHEMA_SQL);
@@ -398,7 +511,42 @@ function initializeSchema(db) {
 }
 
 // src/db/migrations.ts
-var migrations = [];
+var migrations = [
+  {
+    version: 2,
+    up: (db) => {
+      db.exec(`
+        CREATE TABLE IF NOT EXISTS agent_activity (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          tool_name TEXT NOT NULL,
+          action TEXT,
+          model TEXT,
+          agent_role TEXT,
+          task_id TEXT,
+          phase_id TEXT,
+          input_tokens INTEGER,
+          output_tokens INTEGER,
+          total_tokens INTEGER,
+          cost_usd REAL,
+          duration_ms INTEGER,
+          drift_count INTEGER,
+          drift_errors INTEGER,
+          test_pass_count INTEGER,
+          test_fail_count INTEGER,
+          lint_clean INTEGER,
+          typecheck_clean INTEGER,
+          notes TEXT,
+          metadata TEXT NOT NULL DEFAULT '{}',
+          recorded_at TEXT NOT NULL
+        );
+        CREATE INDEX IF NOT EXISTS idx_activity_recorded_at ON agent_activity(recorded_at);
+        CREATE INDEX IF NOT EXISTS idx_activity_model ON agent_activity(model);
+        CREATE INDEX IF NOT EXISTS idx_activity_task ON agent_activity(task_id);
+        CREATE INDEX IF NOT EXISTS idx_activity_phase ON agent_activity(phase_id);
+      `);
+    }
+  }
+];
 function migrate(db) {
   const row = db.prepare("SELECT value FROM arcbridge_meta WHERE key = 'schema_version'").get();
   const currentVersion = row ? Number(row.value) : 0;
@@ -407,12 +555,12 @@ function migrate(db) {
   }
   const pending = migrations.filter((m) => m.version > currentVersion).sort((a, b) => a.version - b.version);
   for (const migration of pending) {
-    db.transaction(() => {
+    transaction(db, () => {
       migration.up(db);
       db.prepare(
         "UPDATE arcbridge_meta SET value = ? WHERE key = 'schema_version'"
       ).run(String(migration.version));
-    })();
+    });
   }
 }
 
@@ -450,6 +598,7 @@ function configTemplate(input) {
     drift: {
       ignore_paths: []
     },
+    metrics: { auto_record: false },
     sync: {
       auto_detect_drift: true,
       drift_severity_threshold: "warning",
@@ -487,6 +636,7 @@ function configTemplate2(input) {
     drift: {
       ignore_paths: []
     },
+    metrics: { auto_record: false },
     sync: {
       auto_detect_drift: true,
       drift_severity_threshold: "warning",
@@ -524,6 +674,7 @@ function configTemplate3(input) {
     drift: {
       ignore_paths: []
     },
+    metrics: { auto_record: false },
     sync: {
       auto_detect_drift: true,
       drift_severity_threshold: "warning",
@@ -559,6 +710,7 @@ function configTemplate4(input) {
     drift: {
       ignore_paths: []
     },
+    metrics: { auto_record: false },
     sync: {
       auto_detect_drift: true,
       drift_severity_threshold: "warning",
@@ -3201,9 +3353,11 @@ function refreshFromDocs(db, targetDir) {
   const scenarioStatusMap = new Map(
     existingScenarios.map((s) => [s.id, s.status])
   );
-  const refresh = db.transaction(() => {
+  const refresh = () => transaction(db, () => {
     db.prepare("DELETE FROM tasks").run();
     db.prepare("DELETE FROM phases").run();
+    db.prepare("UPDATE contracts SET building_block = NULL").run();
+    db.prepare("UPDATE building_blocks SET parent_id = NULL").run();
     db.prepare("DELETE FROM building_blocks").run();
     db.prepare("DELETE FROM quality_scenarios").run();
     db.prepare("DELETE FROM adrs").run();
@@ -3250,12 +3404,12 @@ function generateDatabase(targetDir, input) {
   upsert.run("project_name", input.name);
   upsert.run("project_type", input.template);
   upsert.run("last_full_index", (/* @__PURE__ */ new Date()).toISOString());
-  db.transaction(() => {
+  transaction(db, () => {
     allWarnings.push(...populateBuildingBlocks(db, targetDir));
     allWarnings.push(...populateQualityScenarios(db, targetDir));
     allWarnings.push(...populatePhases(db, targetDir));
     allWarnings.push(...populateAdrs(db, targetDir));
-  })();
+  });
   ensureGitignore(targetDir);
   return { db, warnings: allWarnings };
 }
@@ -4054,7 +4208,7 @@ function writeComponents(db, components) {
   const existingIds = new Set(
     db.prepare("SELECT id FROM symbols").all().map((r) => r.id)
   );
-  const run = db.transaction(() => {
+  transaction(db, () => {
     for (const c of components) {
       if (!existingIds.has(c.symbolId)) continue;
       insert.run(
@@ -4068,7 +4222,6 @@ function writeComponents(db, components) {
       );
     }
   });
-  run();
 }
 
 // src/indexer/route-analyzer.ts
@@ -4197,7 +4350,7 @@ function writeRoutes(db, routes) {
       id, route_path, kind, http_methods, has_auth, parent_layout, service
     ) VALUES (?, ?, ?, ?, ?, ?, ?)
   `);
-  const run = db.transaction(() => {
+  transaction(db, () => {
     for (const r of routes) {
       insert.run(
         r.id,
@@ -4210,7 +4363,6 @@ function writeRoutes(db, routes) {
       );
     }
   });
-  run();
 }
 
 // src/indexer/content-hash.ts
@@ -4244,7 +4396,7 @@ function removeSymbolsForFiles(db, filePaths) {
   const deleteComponents = db.prepare(
     "DELETE FROM components WHERE symbol_id IN (SELECT id FROM symbols WHERE file_path = ?)"
   );
-  const run = db.transaction(() => {
+  transaction(db, () => {
     for (const fp of filePaths) {
       deleteDepsSource.run(fp);
       deleteDepsTarget.run(fp);
@@ -4252,7 +4404,6 @@ function removeSymbolsForFiles(db, filePaths) {
       deleteSymbols.run(fp);
     }
   });
-  run();
 }
 function writeSymbols(db, symbols, service, language = "typescript") {
   if (symbols.length === 0) return;
@@ -4272,7 +4423,7 @@ function writeSymbols(db, symbols, service, language = "typescript") {
     )
   `);
   const now = (/* @__PURE__ */ new Date()).toISOString();
-  const run = db.transaction(() => {
+  transaction(db, () => {
     for (const s of symbols) {
       insert.run(
         s.id,
@@ -4296,7 +4447,6 @@ function writeSymbols(db, symbols, service, language = "typescript") {
       );
     }
   });
-  run();
 }
 function writeDependencies(db, dependencies) {
   if (dependencies.length === 0) return;
@@ -4304,12 +4454,11 @@ function writeDependencies(db, dependencies) {
     INSERT OR IGNORE INTO dependencies (source_symbol, target_symbol, kind)
     VALUES (?, ?, ?)
   `);
-  const run = db.transaction(() => {
+  transaction(db, () => {
     for (const dep of dependencies) {
       insert.run(dep.sourceSymbolId, dep.targetSymbolId, dep.kind);
     }
   });
-  run();
 }
 
 // src/indexer/dotnet-indexer.ts
@@ -4506,7 +4655,7 @@ function indexDotnetProjectRoslyn(db, options) {
       INSERT OR REPLACE INTO routes (id, route_path, kind, http_methods, has_auth, service)
       VALUES (?, ?, ?, ?, ?, ?)
     `);
-    const runRoutes = db.transaction(() => {
+    transaction(db, () => {
       for (const route of output.routes) {
         insertRoute.run(
           route.id,
@@ -4518,7 +4667,6 @@ function indexDotnetProjectRoslyn(db, options) {
         );
       }
     });
-    runRoutes();
   }
   return {
     symbolsIndexed: output.symbols.length,
@@ -5437,7 +5585,7 @@ async function indexCSharpTreeSitter(db, options) {
       INSERT OR REPLACE INTO routes (id, route_path, kind, http_methods, has_auth, service)
       VALUES (?, ?, ?, ?, ?, ?)
     `);
-    const runRoutes = db.transaction(() => {
+    transaction(db, () => {
       for (const route of allRoutes) {
         insertRoute.run(
           route.id,
@@ -5449,7 +5597,6 @@ async function indexCSharpTreeSitter(db, options) {
         );
       }
     });
-    runRoutes();
   }
   return {
     symbolsIndexed: allNewSymbols.length,
@@ -5481,12 +5628,11 @@ function indexPackageDependencies(db, projectRoot, service = "main") {
   const insert = db.prepare(
     "INSERT OR IGNORE INTO package_dependencies (name, version, source, service) VALUES (?, ?, ?, ?)"
   );
-  const run = db.transaction(() => {
+  transaction(db, () => {
     for (const dep of deps) {
       insert.run(dep.name, dep.version, dep.source, service);
     }
   });
-  run();
   return deps.length;
 }
 function parsePackageJson(filePath) {
@@ -5739,12 +5885,11 @@ function writeDriftLog(db, entries) {
     VALUES (?, ?, ?, ?, ?, ?)
   `);
   const now = (/* @__PURE__ */ new Date()).toISOString();
-  const run = db.transaction(() => {
+  transaction(db, () => {
     for (const e of entries) {
       insert.run(now, e.kind, e.severity, e.description, e.affectedBlock, e.affectedFile);
     }
   });
-  run();
 }
 function detectUndocumentedModules(db, entries, ignorePaths = []) {
   const blocks = db.prepare("SELECT id, name, code_paths FROM building_blocks").all();
@@ -6063,12 +6208,11 @@ function applyInferences(db, inferences, projectRoot) {
     "UPDATE tasks SET status = ?, completed_at = CASE WHEN ? = 'done' THEN ? ELSE completed_at END WHERE id = ?"
   );
   const now = (/* @__PURE__ */ new Date()).toISOString();
-  const run = db.transaction(() => {
+  transaction(db, () => {
     for (const inf of inferences) {
       update.run(inf.inferredStatus, inf.inferredStatus, now, inf.taskId);
     }
   });
-  run();
   for (const inf of inferences) {
     const task = db.prepare("SELECT phase_id FROM tasks WHERE id = ?").get(inf.taskId);
     if (task) {
@@ -6373,6 +6517,329 @@ function generateSyncFiles(targetDir, config) {
   return generated;
 }
 
+// src/metrics/activity.ts
+import { writeFileSync as writeFileSync7, mkdirSync as mkdirSync7 } from "fs";
+import { join as join16 } from "path";
+function insertActivity(db, params) {
+  const totalTokens = params.totalTokens ?? (params.inputTokens != null && params.outputTokens != null ? params.inputTokens + params.outputTokens : null);
+  const stmt = db.prepare(`
+    INSERT INTO agent_activity (
+      tool_name, action, model, agent_role,
+      task_id, phase_id,
+      input_tokens, output_tokens, total_tokens, cost_usd, duration_ms,
+      drift_count, drift_errors, test_pass_count, test_fail_count,
+      lint_clean, typecheck_clean,
+      notes, metadata, recorded_at
+    ) VALUES (
+      ?, ?, ?, ?,
+      ?, ?,
+      ?, ?, ?, ?, ?,
+      ?, ?, ?, ?,
+      ?, ?,
+      ?, ?, ?
+    )
+  `);
+  const result = stmt.run(
+    params.toolName,
+    params.action ?? null,
+    params.model ?? null,
+    params.agentRole ?? null,
+    params.taskId ?? null,
+    params.phaseId ?? null,
+    params.inputTokens ?? null,
+    params.outputTokens ?? null,
+    totalTokens,
+    params.costUsd ?? null,
+    params.durationMs ?? null,
+    params.driftCount ?? null,
+    params.driftErrors ?? null,
+    params.testPassCount ?? null,
+    params.testFailCount ?? null,
+    params.lintClean != null ? params.lintClean ? 1 : 0 : null,
+    params.typecheckClean != null ? params.typecheckClean ? 1 : 0 : null,
+    params.notes ?? null,
+    JSON.stringify(params.metadata ?? {}),
+    (/* @__PURE__ */ new Date()).toISOString()
+  );
+  return Number(result.lastInsertRowid);
+}
+function getSessionTotals(db, since, model) {
+  const conditions = [];
+  const values = [];
+  if (since) {
+    conditions.push("recorded_at >= ?");
+    values.push(since);
+  }
+  if (model) {
+    conditions.push("model = ?");
+    values.push(model);
+  }
+  const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  const row = db.prepare(
+    `SELECT
+        COALESCE(SUM(cost_usd), 0) as total_cost,
+        COALESCE(SUM(total_tokens), 0) as total_tokens,
+        COUNT(*) as activity_count
+      FROM agent_activity ${where}`
+  ).get(...values);
+  return {
+    totalCost: row.total_cost,
+    totalTokens: row.total_tokens,
+    activityCount: row.activity_count
+  };
+}
+function queryMetrics(db, params) {
+  const conditions = [];
+  const values = [];
+  if (params.taskId) {
+    conditions.push("task_id = ?");
+    values.push(params.taskId);
+  }
+  if (params.phaseId) {
+    conditions.push("phase_id = ?");
+    values.push(params.phaseId);
+  }
+  if (params.model) {
+    conditions.push("model = ?");
+    values.push(params.model);
+  }
+  if (params.agentRole) {
+    conditions.push("agent_role = ?");
+    values.push(params.agentRole);
+  }
+  if (params.toolName) {
+    conditions.push("tool_name = ?");
+    values.push(params.toolName);
+  }
+  if (params.since) {
+    conditions.push("recorded_at >= ?");
+    values.push(params.since);
+  }
+  if (params.until) {
+    conditions.push("recorded_at <= ?");
+    values.push(params.until);
+  }
+  const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  const qualitySnapshot = getLatestQualitySnapshot(db, where, values);
+  const totalsRow = db.prepare(
+    `SELECT
+        COALESCE(SUM(cost_usd), 0) as total_cost,
+        COALESCE(SUM(total_tokens), 0) as total_tokens,
+        COUNT(*) as activity_count,
+        MIN(recorded_at) as first_at,
+        MAX(recorded_at) as last_at
+      FROM agent_activity ${where}`
+  ).get(...values);
+  const totals = {
+    totalCost: totalsRow.total_cost,
+    totalTokens: totalsRow.total_tokens,
+    activityCount: totalsRow.activity_count
+  };
+  const timeSpan = totalsRow.first_at && totalsRow.last_at ? { first: totalsRow.first_at, last: totalsRow.last_at } : null;
+  if (params.groupBy === "none") {
+    const rows2 = db.prepare(
+      `SELECT * FROM agent_activity ${where} ORDER BY recorded_at DESC LIMIT ?`
+    ).all(...values, params.limit);
+    return { rows: rows2, grouped: false, qualitySnapshot, totals, timeSpan };
+  }
+  const groupColumn = getGroupColumn(params.groupBy);
+  const rows = db.prepare(
+    `SELECT
+        ${groupColumn} as group_key,
+        COUNT(*) as activity_count,
+        SUM(total_tokens) as sum_tokens,
+        ROUND(AVG(total_tokens)) as avg_tokens,
+        ROUND(SUM(cost_usd), 4) as sum_cost,
+        ROUND(AVG(duration_ms)) as avg_duration,
+        MIN(recorded_at) as first_activity,
+        MAX(recorded_at) as last_activity
+      FROM agent_activity ${where}
+      GROUP BY ${groupColumn}
+      ORDER BY sum_cost DESC`
+  ).all(...values);
+  const aggregated = rows.map((r) => ({
+    groupKey: r.group_key ?? "(none)",
+    activityCount: r.activity_count,
+    sumTokens: r.sum_tokens,
+    avgTokens: r.avg_tokens,
+    sumCost: r.sum_cost,
+    avgDuration: r.avg_duration,
+    firstActivity: r.first_activity,
+    lastActivity: r.last_activity
+  }));
+  return { rows: aggregated, grouped: true, qualitySnapshot, totals, timeSpan };
+}
+function exportMetrics(db, projectRoot, format, params, maxRows = 1e5) {
+  const result = queryMetrics(db, {
+    ...params,
+    groupBy: "none",
+    limit: maxRows
+  });
+  const rows = result.rows;
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, 19);
+  const dir = join16(projectRoot, ".arcbridge", "metrics");
+  mkdirSync7(dir, { recursive: true });
+  let content;
+  let filename;
+  switch (format) {
+    case "json": {
+      filename = `activity-${timestamp}.json`;
+      content = JSON.stringify(
+        {
+          exported_at: (/* @__PURE__ */ new Date()).toISOString(),
+          totals: result.totals,
+          quality_snapshot: result.qualitySnapshot,
+          activities: rows.map((r) => ({
+            ...r,
+            metadata: safeParseJson3(r.metadata)
+          }))
+        },
+        null,
+        2
+      );
+      break;
+    }
+    case "csv": {
+      filename = `activity-${timestamp}.csv`;
+      const headers = [
+        "id",
+        "recorded_at",
+        "tool_name",
+        "action",
+        "model",
+        "agent_role",
+        "task_id",
+        "phase_id",
+        "input_tokens",
+        "output_tokens",
+        "total_tokens",
+        "cost_usd",
+        "duration_ms",
+        "drift_count",
+        "drift_errors",
+        "test_pass_count",
+        "test_fail_count",
+        "lint_clean",
+        "typecheck_clean",
+        "notes"
+      ];
+      const csvRows = rows.map(
+        (r) => headers.map((h) => {
+          const val = r[h];
+          if (val == null) return "";
+          const str = String(val);
+          return str.includes(",") || str.includes('"') || str.includes("\n") || str.includes("\r") ? `"${str.replace(/"/g, '""')}"` : str;
+        }).join(",")
+      );
+      content = [headers.join(","), ...csvRows].join("\n");
+      break;
+    }
+    case "markdown": {
+      filename = `activity-${timestamp}.md`;
+      const lines = [
+        `# Agent Activity Report`,
+        "",
+        `**Exported:** ${(/* @__PURE__ */ new Date()).toISOString()}`,
+        `**Activities:** ${result.totals.activityCount}`,
+        `**Total cost:** $${result.totals.totalCost.toFixed(4)}`,
+        `**Total tokens:** ${result.totals.totalTokens.toLocaleString()}`,
+        ""
+      ];
+      if (result.qualitySnapshot.capturedAt) {
+        const q = result.qualitySnapshot;
+        lines.push(
+          "## Latest Quality Snapshot",
+          "",
+          `| Metric | Value |`,
+          `|--------|-------|`
+        );
+        if (q.driftCount != null) lines.push(`| Drift issues | ${q.driftCount} (${q.driftErrors ?? 0} errors) |`);
+        if (q.testPassCount != null) lines.push(`| Tests | ${q.testPassCount} pass / ${q.testFailCount ?? 0} fail |`);
+        if (q.lintClean != null) lines.push(`| Lint | ${q.lintClean ? "clean" : "errors"} |`);
+        if (q.typecheckClean != null) lines.push(`| Typecheck | ${q.typecheckClean ? "clean" : "errors"} |`);
+        lines.push("");
+      }
+      lines.push(
+        "## Activities",
+        "",
+        "| Time | Tool | Action | Model | Tokens | Cost | Duration |",
+        "|------|------|--------|-------|--------|------|----------|"
+      );
+      for (const r of rows) {
+        lines.push(
+          `| ${r.recorded_at.slice(0, 19)} | ${esc(r.tool_name)} | ${esc(r.action)} | ${esc(r.model)} | ${r.total_tokens ?? ""} | ${r.cost_usd != null ? "$" + r.cost_usd.toFixed(4) : ""} | ${r.duration_ms != null ? r.duration_ms + "ms" : ""} |`
+        );
+      }
+      content = lines.join("\n") + "\n";
+      break;
+    }
+  }
+  const filePath = join16(dir, filename);
+  writeFileSync7(filePath, content, "utf-8");
+  return filePath;
+}
+function getGroupColumn(groupBy) {
+  switch (groupBy) {
+    case "model":
+      return "model";
+    case "task":
+      return "task_id";
+    case "phase":
+      return "phase_id";
+    case "tool":
+      return "tool_name";
+    case "day":
+      return "DATE(recorded_at)";
+    default:
+      return "model";
+  }
+}
+function getLatestQualitySnapshot(db, where, values) {
+  const row = db.prepare(
+    `SELECT
+        drift_count, drift_errors,
+        test_pass_count, test_fail_count,
+        lint_clean, typecheck_clean,
+        recorded_at
+      FROM agent_activity
+      ${where ? where + " AND" : "WHERE"}
+        (drift_count IS NOT NULL OR test_pass_count IS NOT NULL OR lint_clean IS NOT NULL OR typecheck_clean IS NOT NULL)
+      ORDER BY recorded_at DESC
+      LIMIT 1`
+  ).get(...values);
+  if (!row) {
+    return {
+      driftCount: null,
+      driftErrors: null,
+      testPassCount: null,
+      testFailCount: null,
+      lintClean: null,
+      typecheckClean: null,
+      capturedAt: null
+    };
+  }
+  return {
+    driftCount: row.drift_count,
+    driftErrors: row.drift_errors,
+    testPassCount: row.test_pass_count,
+    testFailCount: row.test_fail_count,
+    lintClean: row.lint_clean != null ? row.lint_clean === 1 : null,
+    typecheckClean: row.typecheck_clean != null ? row.typecheck_clean === 1 : null,
+    capturedAt: row.recorded_at
+  };
+}
+function safeParseJson3(raw) {
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+function esc(val) {
+  if (val == null) return "";
+  return val.replace(/\|/g, "\\|").replace(/\r?\n|\r/g, " ");
+}
+
 // src/git/helpers.ts
 import { execFileSync as execFileSync3 } from "child_process";
 function resolveRef(projectRoot, since, db) {
@@ -6579,10 +7046,10 @@ ${output}`;
 
 // src/roles/loader.ts
 import { readdirSync as readdirSync5, readFileSync as readFileSync9 } from "fs";
-import { join as join16 } from "path";
+import { join as join17 } from "path";
 import matter4 from "gray-matter";
 function loadRoles(projectRoot) {
-  const agentsDir = join16(projectRoot, ".arcbridge", "agents");
+  const agentsDir = join17(projectRoot, ".arcbridge", "agents");
   const roles = [];
   const errors = [];
   let files;
@@ -6592,7 +7059,7 @@ function loadRoles(projectRoot) {
     return { roles: [], errors: [`Agent directory not found: ${agentsDir}`] };
   }
   for (const file of files) {
-    const filePath = join16(agentsDir, file);
+    const filePath = join17(agentsDir, file);
     try {
       const raw = readFileSync9(filePath, "utf-8");
       const parsed = matter4(raw);
@@ -6619,7 +7086,7 @@ function loadRole(projectRoot, roleId) {
   if (!/^[a-z0-9-]+$/.test(roleId)) {
     return { role: null, error: `Invalid role ID: "${roleId}" (must be kebab-case)` };
   }
-  const filePath = join16(projectRoot, ".arcbridge", "agents", `${roleId}.md`);
+  const filePath = join17(projectRoot, ".arcbridge", "agents", `${roleId}.md`);
   try {
     const raw = readFileSync9(filePath, "utf-8");
     const parsed = matter4(raw);
@@ -6661,6 +7128,7 @@ export {
   detectDrift,
   detectProjectLanguage,
   discoverDotnetServices,
+  exportMetrics,
   generateAgentRoles,
   generateArc42,
   generateConfig,
@@ -6669,23 +7137,28 @@ export {
   generateSyncFiles,
   getChangedFiles,
   getHeadSha,
+  getSessionTotals,
   getUncommittedChanges,
   indexPackageDependencies,
   indexProject,
   inferTaskStatuses,
   initializeSchema,
+  insertActivity,
   loadConfig,
   loadRole,
   loadRoles,
   migrate,
   openDatabase,
   openMemoryDatabase,
+  queryMetrics,
   refreshFromDocs,
   resolveRef,
   setSyncCommit,
+  suppressSqliteWarning,
   syncPhaseToYaml,
   syncScenarioToYaml,
   syncTaskToYaml,
+  transaction,
   verifyScenarios,
   writeDriftLog
 };