@arcbridge/core 0.1.0 → 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 };