@arcbridge/core 0.1.0 → 0.1.2

package/dist/index.js

@@ -32,7 +32,7 @@ var ArcBridgeConfigSchema = z.object({
     exclude: z.array(z.string()).default(["node_modules", "dist", ".next", "coverage"]),
     default_mode: z.enum(["fast", "deep"]).default("fast"),
     csharp_indexer: z.enum(["auto", "roslyn", "tree-sitter"]).default("auto").describe(
-      "C# indexer backend: 'auto' uses Roslyn if available, otherwise tree-sitter. 'tree-sitter' works without .NET SDK. 'roslyn' requires .NET SDK + global tool."
+      "C# indexer backend: 'auto' prefers the arcbridge-dotnet-indexer global tool, falls back to monorepo source if dotnet CLI is available, else tree-sitter. 'tree-sitter' works without .NET SDK. 'roslyn' requires global tool or monorepo source + .NET SDK."
     )
   }).default({}),
   testing: z.object({
@@ -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"),
@@ -217,7 +222,7 @@ function openMemoryDatabase() {
 }
 
 // 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 +388,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 +433,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;
@@ -450,6 +520,7 @@ function configTemplate(input) {
     drift: {
       ignore_paths: []
     },
+    metrics: { auto_record: false },
     sync: {
       auto_detect_drift: true,
       drift_severity_threshold: "warning",
@@ -487,6 +558,7 @@ function configTemplate2(input) {
     drift: {
       ignore_paths: []
     },
+    metrics: { auto_record: false },
     sync: {
       auto_detect_drift: true,
       drift_severity_threshold: "warning",
@@ -524,6 +596,7 @@ function configTemplate3(input) {
     drift: {
       ignore_paths: []
     },
+    metrics: { auto_record: false },
     sync: {
       auto_detect_drift: true,
       drift_severity_threshold: "warning",
@@ -559,6 +632,7 @@ function configTemplate4(input) {
     drift: {
       ignore_paths: []
     },
+    metrics: { auto_record: false },
     sync: {
       auto_detect_drift: true,
       drift_severity_threshold: "warning",
@@ -3204,6 +3278,8 @@ function refreshFromDocs(db, targetDir) {
   const refresh = db.transaction(() => {
     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();
@@ -4315,7 +4391,7 @@ function writeDependencies(db, dependencies) {
 // src/indexer/dotnet-indexer.ts
 import { execFileSync } from "child_process";
 import { resolve, join as join9, dirname, relative as relative4, basename } from "path";
-import { readdirSync as readdirSync3, readFileSync as readFileSync3, existsSync as existsSync4 } from "fs";
+import { readdirSync as readdirSync3, readFileSync as readFileSync3, existsSync as existsSync4, accessSync, constants } from "fs";
 import { fileURLToPath } from "url";
 function findDotnetProject(projectRoot) {
   try {
@@ -4366,6 +4442,24 @@ function discoverDotnetServices(projectRoot) {
   }
   return parseSolutionProjects(slnPath);
 }
+function hasGlobalTool() {
+  const pathEnv = process.env.PATH ?? "";
+  const dirs = pathEnv.split(process.platform === "win32" ? ";" : ":");
+  const name = "arcbridge-dotnet-indexer";
+  const extensions = process.platform === "win32" ? (process.env.PATHEXT ?? ".COM;.EXE;.BAT;.CMD").split(";") : [""];
+  for (const dir of dirs) {
+    if (!dir) continue;
+    for (const ext of extensions) {
+      try {
+        accessSync(join9(dir, `${name}${ext}`), constants.X_OK);
+        return true;
+      } catch {
+        continue;
+      }
+    }
+  }
+  return false;
+}
 function resolveIndexerProject() {
   const currentDir2 = dirname(fileURLToPath(import.meta.url));
   const candidates = [
@@ -4376,71 +4470,70 @@ function resolveIndexerProject() {
   for (const candidate of candidates) {
     if (existsSync4(candidate)) return candidate;
   }
-  throw new Error(
-    "Could not find ArcBridge.DotnetIndexer.csproj. Ensure the dotnet-indexer package is present in the monorepo."
-  );
+  return null;
 }
-function indexDotnetProjectRoslyn(db, options) {
-  const start = Date.now();
-  const service = options.service ?? "main";
-  const projectRoot = resolve(options.projectRoot);
-  const dotnetProject = options.csprojPath ?? findDotnetProject(projectRoot);
-  if (!dotnetProject) {
-    throw new Error(
-      "No .sln or .csproj file found in project root. The .NET indexer requires a project or solution file."
-    );
+function hasIndexerProject() {
+  return resolveIndexerProject() !== null;
+}
+var EXEC_OPTIONS = {
+  encoding: "utf-8",
+  maxBuffer: 50 * 1024 * 1024,
+  // 50MB for large projects
+  timeout: 3e5
+  // 5 minutes
+};
+function runDotnetIndexer(dotnetProject, hashesJson, cwd) {
+  const args = [dotnetProject, "--existing-hashes", hashesJson];
+  const preferSource = process.env.ARCBRIDGE_PREFER_SOURCE === "1";
+  let globalToolError = null;
+  if (!preferSource && hasGlobalTool()) {
+    try {
+      return execFileSync("arcbridge-dotnet-indexer", args, { ...EXEC_OPTIONS, cwd });
+    } catch (err) {
+      globalToolError = err;
+    }
   }
-  const existingHashes = getExistingHashes(db, service);
-  const hashesJson = JSON.stringify(Object.fromEntries(existingHashes));
   const indexerProject = resolveIndexerProject();
-  let stdout;
+  if (!indexerProject) {
+    const base = "Roslyn C# indexer not available. Either install the global tool (`dotnet tool install -g arcbridge-dotnet-indexer`) or run from the ArcBridge monorepo.";
+    if (globalToolError) {
+      const msg = globalToolError instanceof Error ? globalToolError.message : String(globalToolError);
+      throw new Error(`${base} Global tool was found but failed: ${msg}`, { cause: globalToolError });
+    }
+    throw new Error(base);
+  }
   try {
-    stdout = execFileSync(
+    return execFileSync(
       "dotnet",
-      [
-        "run",
-        "--project",
-        indexerProject,
-        "--no-build",
-        "--",
-        dotnetProject,
-        "--existing-hashes",
-        hashesJson
-      ],
-      {
-        encoding: "utf-8",
-        maxBuffer: 50 * 1024 * 1024,
-        // 50MB for large projects
-        timeout: 3e5,
-        // 5 minutes
-        cwd: projectRoot
-      }
+      ["run", "--project", indexerProject, "--no-build", "--", ...args],
+      { ...EXEC_OPTIONS, cwd }
     );
   } catch {
     try {
-      stdout = execFileSync(
+      return execFileSync(
         "dotnet",
-        [
-          "run",
-          "--project",
-          indexerProject,
-          "--",
-          dotnetProject,
-          "--existing-hashes",
-          hashesJson
-        ],
-        {
-          encoding: "utf-8",
-          maxBuffer: 50 * 1024 * 1024,
-          timeout: 3e5,
-          cwd: projectRoot
-        }
+        ["run", "--project", indexerProject, "--", ...args],
+        { ...EXEC_OPTIONS, cwd }
       );
     } catch (retryErr) {
       const message = retryErr instanceof Error ? retryErr.message : String(retryErr);
       throw new Error(`.NET indexer failed: ${message}`, { cause: retryErr });
     }
   }
+}
+function indexDotnetProjectRoslyn(db, options) {
+  const start = Date.now();
+  const service = options.service ?? "main";
+  const projectRoot = resolve(options.projectRoot);
+  const dotnetProject = options.csprojPath ?? findDotnetProject(projectRoot);
+  if (!dotnetProject) {
+    throw new Error(
+      "No .sln or .csproj file found in project root. The .NET indexer requires a project or solution file."
+    );
+  }
+  const existingHashes = getExistingHashes(db, service);
+  const hashesJson = JSON.stringify(Object.fromEntries(existingHashes));
+  const stdout = runDotnetIndexer(dotnetProject, hashesJson, projectRoot);
   const lines = stdout.trim().split("\n");
   const jsonLine = lines.reverse().find((l) => l.startsWith("{"));
   if (!jsonLine) {
@@ -4522,7 +4615,7 @@ import { join as join10 } from "path";
 import { globbySync } from "globby";
 
 // src/indexer/csharp/parser.ts
-import { accessSync, constants } from "fs";
+import { accessSync as accessSync2, constants as constants2 } from "fs";
 import { dirname as dirname2, resolve as resolve2 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import "web-tree-sitter";
@@ -4538,7 +4631,7 @@ function resolveGrammarPath() {
   ];
   for (const candidate of candidates) {
     try {
-      accessSync(candidate, constants.R_OK);
+      accessSync2(candidate, constants2.R_OK);
       return candidate;
     } catch {
       continue;
@@ -5597,15 +5690,20 @@ function resolveCSharpBackend(projectRoot) {
   if (setting === "roslyn" || setting === "tree-sitter") {
     return setting;
   }
-  try {
-    execFileSync2("dotnet", ["--version"], {
-      encoding: "utf-8",
-      timeout: 5e3
-    });
+  if (hasGlobalTool()) {
     return "roslyn";
-  } catch {
-    return "tree-sitter";
   }
+  if (hasIndexerProject()) {
+    try {
+      execFileSync2("dotnet", ["--version"], {
+        encoding: "utf-8",
+        timeout: 5e3
+      });
+      return "roslyn";
+    } catch {
+    }
+  }
+  return "tree-sitter";
 }
 function indexTypeScriptProject(db, options) {
   const start = Date.now();
@@ -6351,6 +6449,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) {
@@ -6557,10 +6978,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;
@@ -6570,7 +6991,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);
@@ -6597,7 +7018,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);
@@ -6639,6 +7060,7 @@ export {
   detectDrift,
   detectProjectLanguage,
   discoverDotnetServices,
+  exportMetrics,
   generateAgentRoles,
   generateArc42,
   generateConfig,
@@ -6647,17 +7069,20 @@ export {
   generateSyncFiles,
   getChangedFiles,
   getHeadSha,
+  getSessionTotals,
   getUncommittedChanges,
   indexPackageDependencies,
   indexProject,
   inferTaskStatuses,
   initializeSchema,
+  insertActivity,
   loadConfig,
   loadRole,
   loadRoles,
   migrate,
   openDatabase,
   openMemoryDatabase,
+  queryMetrics,
   refreshFromDocs,
   resolveRef,
   setSyncCommit,