@newrelic/preflight 0.0.1-pre.1 → 1.0.1

package/dist/metrics/session-tracker.js

@@ -0,0 +1,249 @@
+/**
+ * Session Metrics Aggregation — maintains running aggregates for a coding session.
+ *
+ * Tracks tool call counts, durations, success rates, file access patterns,
+ * and provides both a plain snapshot (for MCP tool responses) and metric
+ * emission (for NR ingestion via MetricAggregator).
+ */
+import { basename } from 'node:path';
+import { computePercentile } from './percentile.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const MAX_TIMELINE_ENTRIES = 10_000;
+export function computeP95(values) {
+    if (values.length === 0)
+        return 0;
+    const sorted = [...values].sort((a, b) => a - b);
+    return computePercentile(sorted, 0.95) ?? 0;
+}
+export function computeDurationStats(durations) {
+    if (durations.length === 0) {
+        return { count: 0, sum: 0, min: 0, max: 0, p95: 0 };
+    }
+    let sum = 0;
+    let min = Infinity;
+    let max = -Infinity;
+    for (const d of durations) {
+        sum += d;
+        if (d < min)
+            min = d;
+        if (d > max)
+            max = d;
+    }
+    return {
+        count: durations.length,
+        sum,
+        min,
+        max,
+        p95: computeP95(durations),
+    };
+}
+// ---------------------------------------------------------------------------
+// SessionTracker
+// ---------------------------------------------------------------------------
+export class SessionTracker {
+    sessionId;
+    sessionName = null;
+    sessionStartTime;
+    toolCallCount = 0;
+    toolErrorCount = 0;
+    successCount = 0;
+    bashCommandsRun = 0;
+    searchQueries = 0;
+    toolCallCountByTool = new Map();
+    toolDurationsByTool = new Map();
+    toolSuccessByTool = new Map();
+    toolErrorsByType = new Map();
+    filesRead = new Set();
+    filesWritten = new Set();
+    bashExitCodes = new Map();
+    bashCallsByCategory = new Map();
+    timeline = [];
+    timelineEntryCount = 0;
+    constructor(sessionId) {
+        if (typeof sessionId !== 'string' || sessionId.length === 0) {
+            // Fix 3: the MCP no longer fabricates session_ids. Callers must pass
+            // the resolved Claude Code session_id (or a real UUID for tests).
+            throw new Error('SessionTracker requires a non-empty sessionId');
+        }
+        this.sessionId = sessionId;
+        this.sessionStartTime = Date.now();
+    }
+    recordToolCall(record) {
+        this.toolCallCount++;
+        // Derive session name from cwd; prefer a later, more meaningful name if the
+        // current one is a degenerate system directory (tmp, var, usr, etc.).
+        const DEGENERATE_NAMES = new Set(['tmp', 'temp', 'var', 'usr', 'opt', 'home', '.', '..', '']);
+        if (typeof record.cwd === 'string' && record.cwd.length > 0) {
+            const name = basename(record.cwd);
+            if (name.length > 0 && name !== '.' && name !== '..') {
+                if (this.sessionName === null || DEGENERATE_NAMES.has(this.sessionName.toLowerCase())) {
+                    this.sessionName = name;
+                }
+            }
+        }
+        // Per-tool count
+        const tool = record.toolName;
+        this.toolCallCountByTool.set(tool, (this.toolCallCountByTool.get(tool) ?? 0) + 1);
+        // Duration tracking
+        if (record.durationMs !== null && record.durationMs !== undefined) {
+            const durations = this.toolDurationsByTool.get(tool);
+            if (durations) {
+                if (durations.length < 500)
+                    durations.push(record.durationMs);
+            }
+            else {
+                this.toolDurationsByTool.set(tool, [record.durationMs]);
+            }
+        }
+        // Success/failure tracking
+        const successEntry = this.toolSuccessByTool.get(tool) ?? { success: 0, total: 0 };
+        successEntry.total++;
+        if (record.success) {
+            successEntry.success++;
+            this.successCount++;
+        }
+        else {
+            this.toolErrorCount++;
+            if (record.errorType) {
+                this.toolErrorsByType.set(record.errorType, (this.toolErrorsByType.get(record.errorType) ?? 0) + 1);
+            }
+        }
+        this.toolSuccessByTool.set(tool, successEntry);
+        // File tracking (uses tool-specific fields from parsers)
+        const filePath = record.filePath;
+        if (filePath) {
+            if (tool === 'Read') {
+                this.filesRead.add(filePath);
+            }
+            else if (tool === 'Write' || tool === 'Edit') {
+                this.filesWritten.add(filePath);
+            }
+        }
+        // Bash tracking
+        if (tool === 'Bash') {
+            this.bashCommandsRun++;
+            const exitCode = record.exitCode;
+            if (exitCode != null) {
+                this.bashExitCodes.set(exitCode, (this.bashExitCodes.get(exitCode) ?? 0) + 1);
+            }
+            const category = record.bashCategory;
+            if (typeof category === 'string' && category.length > 0) {
+                this.bashCallsByCategory.set(category, (this.bashCallsByCategory.get(category) ?? 0) + 1);
+            }
+        }
+        // Search tracking
+        if (tool === 'Grep' || tool === 'Glob') {
+            this.searchQueries++;
+        }
+        // Timeline (capped); always increment the lifetime counter.
+        this.timelineEntryCount++;
+        if (this.timeline.length < MAX_TIMELINE_ENTRIES) {
+            this.timeline.push({
+                timestamp: record.timestamp,
+                toolName: tool,
+                durationMs: record.durationMs,
+                success: record.success,
+            });
+        }
+    }
+    getMetrics() {
+        // Convert Maps to plain objects
+        const toolCallCountByTool = {};
+        for (const [tool, count] of this.toolCallCountByTool) {
+            toolCallCountByTool[tool] = count;
+        }
+        const toolDurationMsByTool = {};
+        for (const [tool, durations] of this.toolDurationsByTool) {
+            toolDurationMsByTool[tool] = computeDurationStats(durations);
+        }
+        const toolSuccessRateByTool = {};
+        for (const [tool, entry] of this.toolSuccessByTool) {
+            toolSuccessRateByTool[tool] = entry.total > 0 ? entry.success / entry.total : 1;
+        }
+        const toolErrorsByType = {};
+        for (const [type, count] of this.toolErrorsByType) {
+            toolErrorsByType[type] = count;
+        }
+        const bashExitCodes = {};
+        for (const [code, count] of this.bashExitCodes) {
+            bashExitCodes[String(code)] = count;
+        }
+        const bashCallsByCategory = {};
+        for (const [category, count] of this.bashCallsByCategory) {
+            bashCallsByCategory[category] = count;
+        }
+        const overallSuccessRate = this.toolCallCount > 0 ? this.successCount / this.toolCallCount : null;
+        return {
+            sessionId: this.sessionId,
+            sessionName: this.sessionName,
+            sessionStartTime: this.sessionStartTime,
+            sessionDurationMs: Date.now() - this.sessionStartTime,
+            toolCallCount: this.toolCallCount,
+            toolCallCountByTool,
+            toolDurationMsByTool,
+            toolSuccessRate: overallSuccessRate,
+            toolSuccessRateByTool,
+            toolErrorCount: this.toolErrorCount,
+            toolErrorsByType,
+            uniqueFilesRead: this.filesRead.size,
+            uniqueFilesWritten: this.filesWritten.size,
+            bashCommandsRun: this.bashCommandsRun,
+            bashExitCodes,
+            bashCallsByCategory,
+            searchQueries: this.searchQueries,
+            toolCallTimeline: [...this.timeline],
+            timelineTruncated: this.timelineEntryCount > this.timeline.length,
+            timelineEntryCount: this.timelineEntryCount,
+        };
+    }
+    emitMetrics(aggregator) {
+        // Per-tool metrics
+        for (const [tool, count] of this.toolCallCountByTool) {
+            aggregator.record('ai.tool.call_count', count, { tool });
+        }
+        for (const [tool, durations] of this.toolDurationsByTool) {
+            for (const d of durations) {
+                aggregator.record('ai.tool.duration_ms', d, { tool });
+            }
+        }
+        for (const [tool, entry] of this.toolSuccessByTool) {
+            const rate = entry.total > 0 ? entry.success / entry.total : 1;
+            aggregator.record('ai.tool.success_rate', rate, { tool });
+        }
+        // Per-bash-category breakdown — emitted separately from generic tool
+        // counts so dashboards can split git vs test-runner vs build vs ...
+        for (const [category, count] of this.bashCallsByCategory) {
+            aggregator.record('ai.bash.call_count', count, { category });
+        }
+        // Session-level metrics
+        aggregator.record('ai.session.duration_ms', Date.now() - this.sessionStartTime);
+        aggregator.record('ai.session.unique_files_read', this.filesRead.size);
+        aggregator.record('ai.session.unique_files_written', this.filesWritten.size);
+    }
+    reset(sessionId) {
+        if (typeof sessionId !== 'string' || sessionId.length === 0) {
+            throw new Error('SessionTracker.reset() requires a non-empty sessionId');
+        }
+        this.sessionId = sessionId;
+        this.sessionName = null;
+        this.sessionStartTime = Date.now();
+        this.toolCallCount = 0;
+        this.toolErrorCount = 0;
+        this.successCount = 0;
+        this.bashCommandsRun = 0;
+        this.searchQueries = 0;
+        this.toolCallCountByTool.clear();
+        this.toolDurationsByTool.clear();
+        this.toolSuccessByTool.clear();
+        this.toolErrorsByType.clear();
+        this.filesRead.clear();
+        this.filesWritten.clear();
+        this.bashExitCodes.clear();
+        this.bashCallsByCategory.clear();
+        this.timeline = [];
+        this.timelineEntryCount = 0;
+    }
+}
+//# sourceMappingURL=session-tracker.js.map

package/dist/metrics/session-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-tracker.js","sourceRoot":"","sources":["../../src/metrics/session-tracker.ts"],"names":[],"mappings":"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"}

package/dist/metrics/task-completion-tracker.d.ts

@@ -0,0 +1,15 @@
+import type { AiCodingTask } from './task-detector.js';
+import type { ToolCallRecord } from '../storage/types.js';
+export interface TaskCompletionMetrics {
+    readonly completedTasks: number;
+    readonly avgTaskDurationMs: number | null;
+    readonly avgToolCallsPerTask: number | null;
+}
+export declare class TaskCompletionTracker {
+    private completed;
+    recordToolCall(_record: ToolCallRecord): void;
+    recordTask(task: AiCodingTask): void;
+    getMetrics(): TaskCompletionMetrics;
+    reset(): void;
+}
+//# sourceMappingURL=task-completion-tracker.d.ts.map

package/dist/metrics/task-completion-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-completion-tracker.d.ts","sourceRoot":"","sources":["../../src/metrics/task-completion-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAO1D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,SAAS,CAAqB;IAItC,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAE7C,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAIpC,UAAU,IAAI,qBAAqB;IAoBnC,KAAK,IAAI,IAAI;CAGd"}

package/dist/metrics/task-completion-tracker.js

@@ -0,0 +1,27 @@
+export class TaskCompletionTracker {
+    completed = [];
+    // No-op: this tracker is fed via recordTask() called by TaskDetector.
+    // recordToolCall exists for compatibility with the standard tracker pattern.
+    recordToolCall(_record) { }
+    recordTask(task) {
+        this.completed.push({ durationMs: task.durationMs, toolCallCount: task.toolCallCount });
+    }
+    getMetrics() {
+        const completedCount = this.completed.length;
+        const avgTaskDurationMs = completedCount > 0
+            ? this.completed.reduce((s, t) => s + t.durationMs, 0) / completedCount
+            : null;
+        const avgToolCallsPerTask = completedCount > 0
+            ? this.completed.reduce((s, t) => s + t.toolCallCount, 0) / completedCount
+            : null;
+        return {
+            completedTasks: completedCount,
+            avgTaskDurationMs,
+            avgToolCallsPerTask,
+        };
+    }
+    reset() {
+        this.completed = [];
+    }
+}
+//# sourceMappingURL=task-completion-tracker.js.map

package/dist/metrics/task-completion-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-completion-tracker.js","sourceRoot":"","sources":["../../src/metrics/task-completion-tracker.ts"],"names":[],"mappings":"AAcA,MAAM,OAAO,qBAAqB;IACxB,SAAS,GAAkB,EAAE,CAAC;IAEtC,sEAAsE;IACtE,6EAA6E;IAC7E,cAAc,CAAC,OAAuB,IAAS,CAAC;IAEhD,UAAU,CAAC,IAAkB;QAC3B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED,UAAU;QACR,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;QAE7C,MAAM,iBAAiB,GACrB,cAAc,GAAG,CAAC;YAChB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,GAAG,cAAc;YACvE,CAAC,CAAC,IAAI,CAAC;QAEX,MAAM,mBAAmB,GACvB,cAAc,GAAG,CAAC;YAChB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,GAAG,cAAc;YAC1E,CAAC,CAAC,IAAI,CAAC;QAEX,OAAO;YACL,cAAc,EAAE,cAAc;YAC9B,iBAAiB;YACjB,mBAAmB;SACpB,CAAC;IACJ,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;IACtB,CAAC;CACF"}

package/dist/metrics/task-detector.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Task Boundary Detection — heuristically detects discrete "tasks" from
+ * the stream of tool calls.
+ *
+ * A task is the work Claude does between user messages: the user gives an
+ * instruction, Claude executes a series of tool calls, and eventually responds.
+ *
+ * Detection signals:
+ *   1. Idle gap > threshold (configurable, default 30s) → task complete
+ *   2. AskUserQuestion tool call → task complete (Claude is asking for direction)
+ *   3. TaskUpdate with status=completed → explicit task completion
+ */
+import type { MetricAggregator } from '../shared/index.js';
+import type { ToolCallRecord } from '../storage/types.js';
+import type { CostTracker } from './cost-tracker.js';
+export interface AiCodingTask {
+    readonly taskId: string;
+    readonly startTime: number;
+    readonly endTime: number;
+    readonly durationMs: number;
+    readonly toolCallCount: number;
+    readonly toolCallsByType: Record<string, number>;
+    readonly filesRead: string[];
+    readonly filesModified: string[];
+    readonly linesChanged: number;
+    readonly linesAdded: number;
+    readonly linesRemoved: number;
+    readonly bashCommandsRun: number;
+    readonly testsRun: number;
+    readonly testsPassed: number;
+    readonly buildRun: number;
+    readonly buildPassed: number;
+    readonly estimatedCostUsd: number | null;
+    readonly tokensUsed: number;
+    readonly askedUserQuestions: number;
+    readonly subAgentsSpawned: number;
+    readonly toolCalls: ToolCallRecord[];
+}
+export interface TaskMetrics {
+    readonly totalTasksCompleted: number;
+    readonly currentTaskActive: boolean;
+    readonly currentTaskToolCalls: number;
+    readonly averageTaskDurationMs: number | null;
+    readonly averageToolCallsPerTask: number | null;
+    readonly completedTasks: AiCodingTask[];
+}
+export interface TaskDetectorOptions {
+    readonly idleTimeoutMs?: number;
+    readonly costTracker?: CostTracker;
+    readonly maxCompletedTasks?: number;
+}
+export declare class TaskDetector {
+    private readonly idleTimeoutMs;
+    private readonly costTracker;
+    private readonly maxCompletedTasks;
+    private activeTask;
+    private completedTasks;
+    private pendingEmission;
+    private lifetimeCompletedCount;
+    private idleTimer;
+    private costAtTaskStart;
+    private tokensAtTaskStart;
+    constructor(options?: TaskDetectorOptions);
+    recordToolCall(record: ToolCallRecord): void;
+    getCurrentTask(): AiCodingTask | null;
+    getCompletedTasks(): AiCodingTask[];
+    /**
+     * Returns tasks completed since the last drain and clears the emission queue.
+     * Safe to call on every poll cycle — each task is returned exactly once.
+     */
+    drainNewlyCompletedTasks(): AiCodingTask[];
+    getActiveTaskId(): string | null;
+    getMetrics(): TaskMetrics;
+    emitMetrics(aggregator: MetricAggregator): void;
+    reset(): void;
+    dispose(): void;
+    private startNewTask;
+    private closeCurrentTask;
+    private snapshotCostState;
+    private computeCostDelta;
+    private resetIdleTimer;
+    private clearIdleTimer;
+}
+//# sourceMappingURL=task-detector.d.ts.map

package/dist/metrics/task-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-detector.d.ts","sourceRoot":"","sources":["../../src/metrics/task-detector.ts"],"names":[],"mappings":"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"}