@arcbridge/core 0.1.1 → 0.1.2

package/dist/index.d.ts

@@ -78,6 +78,13 @@ declare const ArcBridgeConfigSchema: z.ZodObject<{
     }, {
         ignore_paths?: string[] | undefined;
     }>>;
+    metrics: z.ZodDefault<z.ZodObject<{
+        auto_record: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        auto_record: boolean;
+    }, {
+        auto_record?: boolean | undefined;
+    }>>;
     sync: z.ZodDefault<z.ZodObject<{
         auto_detect_drift: z.ZodDefault<z.ZodBoolean>;
         drift_severity_threshold: z.ZodDefault<z.ZodEnum<["info", "warning", "error"]>>;
@@ -117,6 +124,9 @@ declare const ArcBridgeConfigSchema: z.ZodObject<{
     drift: {
         ignore_paths: string[];
     };
+    metrics: {
+        auto_record: boolean;
+    };
     sync: {
         auto_detect_drift: boolean;
         drift_severity_threshold: "info" | "warning" | "error";
@@ -148,6 +158,9 @@ declare const ArcBridgeConfigSchema: z.ZodObject<{
     drift?: {
         ignore_paths?: string[] | undefined;
     } | undefined;
+    metrics?: {
+        auto_record?: boolean | undefined;
+    } | undefined;
     sync?: {
         auto_detect_drift?: boolean | undefined;
         drift_severity_threshold?: "info" | "warning" | "error" | undefined;
@@ -710,7 +723,7 @@ type AgentRole = z.infer<typeof AgentRoleSchema>;
 declare function openDatabase(dbPath: string): Database.Database;
 declare function openMemoryDatabase(): Database.Database;
 
-declare const CURRENT_SCHEMA_VERSION = 1;
+declare const CURRENT_SCHEMA_VERSION = 2;
 declare function initializeSchema(db: Database.Database): void;
 
 declare function migrate(db: Database.Database): void;
@@ -894,6 +907,102 @@ declare function syncScenarioToYaml(projectRoot: string, scenarioId: string, sta
  */
 declare function generateSyncFiles(targetDir: string, config: ArcBridgeConfig): string[];
 
+interface InsertActivityParams {
+    toolName: string;
+    action?: string;
+    model?: string;
+    agentRole?: string;
+    taskId?: string;
+    phaseId?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    costUsd?: number;
+    durationMs?: number;
+    driftCount?: number;
+    driftErrors?: number;
+    testPassCount?: number;
+    testFailCount?: number;
+    lintClean?: boolean;
+    typecheckClean?: boolean;
+    notes?: string;
+    metadata?: Record<string, unknown>;
+}
+interface QueryMetricsParams {
+    taskId?: string;
+    phaseId?: string;
+    model?: string;
+    agentRole?: string;
+    toolName?: string;
+    since?: string;
+    until?: string;
+    groupBy: "model" | "task" | "phase" | "tool" | "day" | "none";
+    limit: number;
+}
+interface ActivityRow {
+    id: number;
+    tool_name: string;
+    action: string | null;
+    model: string | null;
+    agent_role: string | null;
+    task_id: string | null;
+    phase_id: string | null;
+    input_tokens: number | null;
+    output_tokens: number | null;
+    total_tokens: number | null;
+    cost_usd: number | null;
+    duration_ms: number | null;
+    drift_count: number | null;
+    drift_errors: number | null;
+    test_pass_count: number | null;
+    test_fail_count: number | null;
+    lint_clean: number | null;
+    typecheck_clean: number | null;
+    notes: string | null;
+    metadata: string;
+    recorded_at: string;
+}
+interface AggregatedRow {
+    groupKey: string;
+    activityCount: number;
+    sumTokens: number | null;
+    avgTokens: number | null;
+    sumCost: number | null;
+    avgDuration: number | null;
+    firstActivity: string;
+    lastActivity: string;
+}
+interface LatestQualitySnapshot {
+    driftCount: number | null;
+    driftErrors: number | null;
+    testPassCount: number | null;
+    testFailCount: number | null;
+    lintClean: boolean | null;
+    typecheckClean: boolean | null;
+    capturedAt: string | null;
+}
+interface SessionTotals {
+    totalCost: number;
+    totalTokens: number;
+    activityCount: number;
+}
+interface MetricsResult {
+    rows: ActivityRow[] | AggregatedRow[];
+    grouped: boolean;
+    qualitySnapshot: LatestQualitySnapshot;
+    totals: SessionTotals;
+    timeSpan: {
+        first: string;
+        last: string;
+    } | null;
+}
+type ExportFormat = "json" | "csv" | "markdown";
+
+declare function insertActivity(db: Database.Database, params: InsertActivityParams): number;
+declare function getSessionTotals(db: Database.Database, since?: string, model?: string): SessionTotals;
+declare function queryMetrics(db: Database.Database, params: QueryMetricsParams): MetricsResult;
+declare function exportMetrics(db: Database.Database, projectRoot: string, format: ExportFormat, params: Omit<QueryMetricsParams, "groupBy" | "limit">, maxRows?: number): string;
+
 interface ChangedFile {
     status: "added" | "modified" | "deleted" | "renamed";
     path: string;
@@ -988,4 +1097,4 @@ declare function loadConfig(projectRoot: string): {
     error: string | null;
 };
 
-export { type AdrFrontmatter, AdrFrontmatterSchema, type AgentRole, AgentRoleSchema, type ArcBridgeConfig, ArcBridgeConfigSchema, type BuildingBlock, BuildingBlockSchema, type BuildingBlocksFrontmatter, BuildingBlocksFrontmatterSchema, CURRENT_SCHEMA_VERSION, type ChangedFile, type DotnetProjectInfo, type DriftEntry, type DriftKind, type DriftOptions, type DriftSeverity, type ExtractedSymbol, type GenerateDatabaseResult, type GitRef, type IndexResult, type IndexerOptions, type InitProjectInput, type LoadRolesResult, type Phase, PhaseSchema, type PhasesFile, PhasesFileSchema, type ProjectLanguage, QualityCategorySchema, QualityPrioritySchema, type QualityScenario, QualityScenarioSchema, QualityScenarioStatusSchema, type QualityScenariosFile, QualityScenariosFileSchema, type ScenarioTestResult, type Service, type SymbolKind, type Task, type TaskFile, TaskFileSchema, type TaskInferenceResult, TaskSchema, type TestOutcome, type VerifyResult, addTaskToYaml, applyInferences, detectDrift, detectProjectLanguage, discoverDotnetServices, generateAgentRoles, generateArc42, generateConfig, generateDatabase, generatePlan, generateSyncFiles, getChangedFiles, getHeadSha, getUncommittedChanges, indexPackageDependencies, indexProject, inferTaskStatuses, initializeSchema, loadConfig, loadRole, loadRoles, migrate, openDatabase, openMemoryDatabase, refreshFromDocs, resolveRef, setSyncCommit, syncPhaseToYaml, syncScenarioToYaml, syncTaskToYaml, verifyScenarios, writeDriftLog };
+export { type ActivityRow, type AdrFrontmatter, AdrFrontmatterSchema, type AgentRole, AgentRoleSchema, type AggregatedRow, type ArcBridgeConfig, ArcBridgeConfigSchema, type BuildingBlock, BuildingBlockSchema, type BuildingBlocksFrontmatter, BuildingBlocksFrontmatterSchema, CURRENT_SCHEMA_VERSION, type ChangedFile, type DotnetProjectInfo, type DriftEntry, type DriftKind, type DriftOptions, type DriftSeverity, type ExportFormat, type ExtractedSymbol, type GenerateDatabaseResult, type GitRef, type IndexResult, type IndexerOptions, type InitProjectInput, type InsertActivityParams, type LatestQualitySnapshot, type LoadRolesResult, type MetricsResult, type Phase, PhaseSchema, type PhasesFile, PhasesFileSchema, type ProjectLanguage, QualityCategorySchema, QualityPrioritySchema, type QualityScenario, QualityScenarioSchema, QualityScenarioStatusSchema, type QualityScenariosFile, QualityScenariosFileSchema, type QueryMetricsParams, type ScenarioTestResult, type Service, type SessionTotals, type SymbolKind, type Task, type TaskFile, TaskFileSchema, type TaskInferenceResult, TaskSchema, type TestOutcome, type VerifyResult, addTaskToYaml, applyInferences, detectDrift, detectProjectLanguage, discoverDotnetServices, exportMetrics, generateAgentRoles, generateArc42, generateConfig, generateDatabase, generatePlan, generateSyncFiles, getChangedFiles, getHeadSha, getSessionTotals, getUncommittedChanges, indexPackageDependencies, indexProject, inferTaskStatuses, initializeSchema, insertActivity, loadConfig, loadRole, loadRoles, migrate, openDatabase, openMemoryDatabase, queryMetrics, refreshFromDocs, resolveRef, setSyncCommit, syncPhaseToYaml, syncScenarioToYaml, syncTaskToYaml, verifyScenarios, writeDriftLog };

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"),
@@ -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();
@@ -6373,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) {
@@ -6579,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;
@@ -6592,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);
@@ -6619,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);
@@ -6661,6 +7060,7 @@ export {
   detectDrift,
   detectProjectLanguage,
   discoverDotnetServices,
+  exportMetrics,
   generateAgentRoles,
   generateArc42,
   generateConfig,
@@ -6669,17 +7069,20 @@ export {
   generateSyncFiles,
   getChangedFiles,
   getHeadSha,
+  getSessionTotals,
   getUncommittedChanges,
   indexPackageDependencies,
   indexProject,
   inferTaskStatuses,
   initializeSchema,
+  insertActivity,
   loadConfig,
   loadRole,
   loadRoles,
   migrate,
   openDatabase,
   openMemoryDatabase,
+  queryMetrics,
   refreshFromDocs,
   resolveRef,
   setSyncCommit,