@newrelic/preflight 0.0.1-pre.1 → 1.0.0

package/dist/metrics/efficiency-score.js

@@ -0,0 +1,219 @@
+/**
+ * AI Coding Efficiency Score — computes a composite score for completed tasks.
+ *
+ * The score is a weighted average of four components, each in [0, 1]:
+ *   1. Speed:                linesChanged / taskDuration, normalized to 1 line/s = 1.0
+ *   2. Correctness:          test pass rate during the task (0.5 default if no tests)
+ *   3. Autonomy:             1 - (userQuestions / toolCalls)
+ *   4. First-attempt quality: 1 - (thrashIterations / 3), floored at 0
+ *
+ * Final score = weighted average, clamped to [0, 1].
+ */
+// ---------------------------------------------------------------------------
+// Defaults
+// ---------------------------------------------------------------------------
+const DEFAULT_SPEED_WEIGHT = 0.25;
+const DEFAULT_CORRECTNESS_WEIGHT = 0.25;
+const DEFAULT_AUTONOMY_WEIGHT = 0.25;
+const DEFAULT_FIRST_ATTEMPT_QUALITY_WEIGHT = 0.25;
+const DEFAULT_SPEED_BASELINE_LPS = 1; // 1 line per second = perfect speed
+const MAX_SCORES = 1_000;
+// ---------------------------------------------------------------------------
+// EfficiencyScorer
+// ---------------------------------------------------------------------------
+export class EfficiencyScorer {
+    speedWeight;
+    correctnessWeight;
+    autonomyWeight;
+    firstAttemptQualityWeight;
+    speedBaselineLps;
+    scores = [];
+    lastEmittedIndex = 0;
+    constructor(options) {
+        this.speedWeight = options?.speedWeight ?? DEFAULT_SPEED_WEIGHT;
+        this.correctnessWeight = options?.correctnessWeight ?? DEFAULT_CORRECTNESS_WEIGHT;
+        this.autonomyWeight = options?.autonomyWeight ?? DEFAULT_AUTONOMY_WEIGHT;
+        this.firstAttemptQualityWeight =
+            options?.firstAttemptQualityWeight ?? DEFAULT_FIRST_ATTEMPT_QUALITY_WEIGHT;
+        this.speedBaselineLps = options?.speedBaselineLinesPerSecond ?? DEFAULT_SPEED_BASELINE_LPS;
+    }
+    /**
+     * Compute the efficiency score for a completed task.
+     * Anti-patterns are optional — if not provided, first-attempt quality defaults to 1.0.
+     */
+    computeScore(task, antiPatterns) {
+        const components = this.computeComponents(task, antiPatterns);
+        const raw = components.speed * this.speedWeight +
+            components.correctness * this.correctnessWeight +
+            components.autonomy * this.autonomyWeight +
+            components.firstAttemptQuality * this.firstAttemptQualityWeight;
+        const score = clamp(Math.round(raw * 1000) / 1000, 0, 1);
+        const result = {
+            score,
+            components,
+            taskId: task.taskId,
+            timestamp: task.endTime,
+        };
+        const idx = this.scores.findIndex((s) => s.taskId === task.taskId);
+        if (idx >= 0) {
+            this.scores[idx] = result;
+        }
+        else {
+            this.appendScore(result);
+        }
+        return result;
+    }
+    /**
+     * Session-wide rolling average across all scored tasks.
+     */
+    getSessionAverage() {
+        if (this.scores.length === 0)
+            return null;
+        let totalScore = 0;
+        let totalSpeed = 0;
+        let totalCorrectness = 0;
+        let totalAutonomy = 0;
+        let totalFirstAttempt = 0;
+        for (const s of this.scores) {
+            totalScore += s.score;
+            totalSpeed += s.components.speed;
+            totalCorrectness += s.components.correctness;
+            totalAutonomy += s.components.autonomy;
+            totalFirstAttempt += s.components.firstAttemptQuality;
+        }
+        const n = this.scores.length;
+        return {
+            score: Math.round((totalScore / n) * 1000) / 1000,
+            components: {
+                speed: Math.round((totalSpeed / n) * 1000) / 1000,
+                correctness: Math.round((totalCorrectness / n) * 1000) / 1000,
+                autonomy: Math.round((totalAutonomy / n) * 1000) / 1000,
+                firstAttemptQuality: Math.round((totalFirstAttempt / n) * 1000) / 1000,
+            },
+            taskId: 'session-average',
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Recompute and replace the score for a task that may have changed (e.g., active task).
+     */
+    updateScore(task, antiPatterns) {
+        const idx = this.scores.findIndex((s) => s.taskId === task.taskId);
+        const components = this.computeComponents(task, antiPatterns);
+        const raw = components.speed * this.speedWeight +
+            components.correctness * this.correctnessWeight +
+            components.autonomy * this.autonomyWeight +
+            components.firstAttemptQuality * this.firstAttemptQualityWeight;
+        const score = clamp(Math.round(raw * 1000) / 1000, 0, 1);
+        const result = {
+            score,
+            components,
+            taskId: task.taskId,
+            timestamp: task.endTime,
+        };
+        if (idx >= 0) {
+            this.scores[idx] = result;
+            // Reset emit pointer so the updated score gets re-emitted on the next
+            // emitMetrics() call — previously it was silently dropped if already emitted.
+            if (idx < this.lastEmittedIndex) {
+                this.lastEmittedIndex = idx;
+            }
+        }
+        else {
+            this.appendScore(result);
+        }
+        return result;
+    }
+    getScores() {
+        return [...this.scores];
+    }
+    emitMetrics(aggregator) {
+        for (let i = this.lastEmittedIndex; i < this.scores.length; i++) {
+            const s = this.scores[i];
+            aggregator.record('ai.efficiency.score', s.score);
+            aggregator.record('ai.efficiency.speed', s.components.speed);
+            aggregator.record('ai.efficiency.correctness', s.components.correctness);
+            aggregator.record('ai.efficiency.autonomy', s.components.autonomy);
+            aggregator.record('ai.efficiency.first_attempt_quality', s.components.firstAttemptQuality);
+        }
+        this.lastEmittedIndex = this.scores.length;
+    }
+    reset() {
+        this.scores.length = 0;
+        this.lastEmittedIndex = 0;
+    }
+    // ---------------------------------------------------------------------------
+    // Private
+    // ---------------------------------------------------------------------------
+    computeComponents(task, antiPatterns) {
+        return {
+            speed: this.computeSpeed(task),
+            correctness: this.computeCorrectness(task),
+            autonomy: this.computeAutonomy(task),
+            firstAttemptQuality: this.computeFirstAttemptQuality(antiPatterns),
+        };
+    }
+    /**
+     * Speed: linesChanged / durationSeconds, normalized to baseline.
+     * 0 lines → 0 speed. 0 duration → clamp to 1.0.
+     */
+    computeSpeed(task) {
+        if (task.linesChanged === 0)
+            return 0;
+        if (task.durationMs <= 0)
+            return 1;
+        const durationSeconds = task.durationMs / 1000;
+        const linesPerSecond = task.linesChanged / durationSeconds;
+        return clamp(linesPerSecond / this.speedBaselineLps, 0, 1);
+    }
+    /**
+     * Correctness: test pass rate. Default 0.5 if no tests were run.
+     */
+    computeCorrectness(task) {
+        if (task.testsRun === 0)
+            return 0.5;
+        return clamp(task.testsPassed / task.testsRun, 0, 1);
+    }
+    /**
+     * Autonomy: 1 - (userQuestions / toolCalls). 1.0 if no questions asked.
+     */
+    computeAutonomy(task) {
+        if (task.toolCallCount === 0)
+            return 1;
+        if (task.askedUserQuestions === 0)
+            return 1;
+        return clamp(1 - task.askedUserQuestions / task.toolCallCount, 0, 1);
+    }
+    /**
+     * First-attempt quality: 1 - (maxThrashIterations / 3), floored at 0.
+     * If no anti-patterns provided or no thrashing, score is 1.0.
+     */
+    computeFirstAttemptQuality(antiPatterns) {
+        if (!antiPatterns || antiPatterns.length === 0)
+            return 1;
+        let maxIterations = 0;
+        for (const pattern of antiPatterns) {
+            if (pattern.type === 'thrashing' && pattern.iterations != null) {
+                maxIterations = Math.max(maxIterations, pattern.iterations);
+            }
+        }
+        if (maxIterations === 0)
+            return 1;
+        return clamp(1 - maxIterations / 3, 0, 1);
+    }
+    appendScore(score) {
+        this.scores.push(score);
+        if (this.scores.length > MAX_SCORES) {
+            const dropped = this.scores.length - MAX_SCORES;
+            this.scores.splice(0, dropped);
+            this.lastEmittedIndex = Math.max(0, this.lastEmittedIndex - dropped);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function clamp(value, min, max) {
+    return Math.min(max, Math.max(min, value));
+}
+//# sourceMappingURL=efficiency-score.js.map

package/dist/metrics/efficiency-score.js.map

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

package/dist/metrics/git-efficiency-tracker.d.ts

@@ -0,0 +1,165 @@
+import type { ToolCallRecord, ReplayTimelineEntry } from '../storage/types.js';
+export interface GitEvent {
+    readonly timestamp: number;
+    readonly type: GitEventType;
+    readonly command?: string;
+    readonly success: boolean;
+    readonly durationMs: number | null;
+}
+export type GitEventType = 'merge_conflict' | 'rebase_conflict' | 'merge_abort' | 'rebase_abort' | 'cherry_pick_abort' | 'force_push' | 'force_push_lease' | 'reset_hard' | 'discard_changes' | 'pull' | 'fetch' | 'push' | 'push_rejected' | 'merge' | 'rebase' | 'stash' | 'branch' | 'commit' | 'status' | 'diff' | 'log' | 'worktree' | 'other_git';
+export interface MergeConflictRecord {
+    readonly timestamp: number;
+    readonly resolution: 'resolved' | 'aborted' | 'pending';
+    readonly resolutionTimeMs: number | null;
+    readonly command: string;
+    readonly files: readonly string[];
+}
+export interface GitEfficiencyMetrics {
+    readonly totalGitCommands: number;
+    readonly mergeConflicts: number;
+    readonly rebaseConflicts: number;
+    readonly abortedOperations: number;
+    readonly forcePushes: number;
+    readonly resetHards: number;
+    readonly discardedChanges: number;
+    readonly pullCount: number;
+    readonly pushCount: number;
+    readonly commitCount: number;
+    readonly branchOperations: number;
+    readonly conflictResolutionRate: number | null;
+    readonly avgConflictResolutionMs: number | null;
+    readonly staleBranchPulls: number;
+    readonly gitCommandTimeline: readonly GitEvent[];
+    readonly conflictHistory: readonly MergeConflictRecord[];
+    readonly suggestions: readonly GitSuggestion[];
+    readonly bestPractices: readonly BestPractice[];
+    readonly preventionScore: number | null;
+    readonly efficiencyScore: number | null;
+    readonly riskIndicators: RiskIndicators;
+    readonly velocityMetrics: VelocityMetrics;
+    readonly conflictResolutionStrategy: ConflictResolutionStrategy;
+    readonly prMetrics: PullRequestMetrics;
+    readonly repoContext: RepoContext;
+}
+export interface RepoContext {
+    readonly repoName: string | null;
+    readonly branch: string | null;
+    readonly remoteName: string | null;
+    readonly defaultBranch: string | null;
+}
+export interface PullRequestMetrics {
+    readonly created: number;
+    readonly merged: number;
+    readonly checksViewed: number;
+    readonly prsUpdated: number;
+    readonly prActivity: readonly PrEvent[];
+    readonly avgTimeToCreateMs: number | null;
+}
+export interface PrEvent {
+    readonly timestamp: number;
+    readonly action: 'create' | 'merge' | 'view' | 'edit' | 'ready' | 'checks';
+    readonly prNumber: string | null;
+}
+export interface VelocityMetrics {
+    readonly avgTimeBetweenCommitsMs: number | null;
+    readonly commitBurstCount: number;
+    readonly longestGapMs: number | null;
+    readonly worktreeCount: number;
+    readonly buildBeforePush: boolean | null;
+    readonly testBeforePush: boolean | null;
+}
+export interface ConflictResolutionStrategy {
+    readonly oursCount: number;
+    readonly theirsCount: number;
+    readonly manualMergeCount: number;
+    readonly cherryPickCount: number;
+    readonly totalResolutions: number;
+}
+export interface GitSuggestion {
+    readonly severity: 'info' | 'warning' | 'critical';
+    readonly category: string;
+    readonly message: string;
+    readonly evidence: string;
+}
+export interface BestPractice {
+    readonly id: string;
+    readonly label: string;
+    readonly status: 'pass' | 'fail' | 'warn' | 'unknown';
+    readonly detail: string;
+}
+export interface RiskIndicators {
+    readonly syncedBeforeEditing: boolean | null;
+    readonly timeSinceLastSyncMs: number | null;
+    readonly commitsSinceLastSync: number;
+    readonly pushRejections: number;
+    readonly forceAfterReject: number;
+    readonly hotFiles: readonly string[];
+    readonly usesWorktrees: boolean;
+    readonly usesForceWithLease: boolean;
+    readonly avgCommitsBetweenSyncs: number | null;
+    readonly commitsAheadOfMain: number | null;
+    readonly commitsBehindMain: number | null;
+    readonly sessionDurationMs: number | null;
+    readonly quickConflictResolutions: number;
+}
+export declare class GitEfficiencyTracker {
+    private events;
+    private conflictRecords;
+    private pendingConflictTimestamp;
+    private pendingConflictCommand;
+    private pendingConflictFiles;
+    private lastSyncTimestamp;
+    private pullsSinceLastConflict;
+    private consecutiveFailedPushes;
+    private statusChecksSinceLastAction;
+    private firstEditTimestamp;
+    private firstSyncTimestamp;
+    private commitsSinceLastSync;
+    private syncIntervalCommitCounts;
+    private pushRejections;
+    private forceAfterReject;
+    private lastPushRejectedTimestamp;
+    private conflictedFiles;
+    private editedFiles;
+    private hasUsedWorktree;
+    private hasUsedForceWithLease;
+    private totalToolCalls;
+    private sessionStartTimestamp;
+    private commitTimestamps;
+    private worktreeCommands;
+    private oursCount;
+    private theirsCount;
+    private cherryPickCount;
+    private lastBuildOrTestTimestamp;
+    private lastPushTimestamp;
+    private buildBeforePush;
+    private commitsAheadOfMain;
+    private commitsBehindMain;
+    private quickConflictResolutions;
+    private prEvents;
+    private firstCommitTimestamp;
+    private repoContext;
+    recordToolCall(record: ToolCallRecord): void;
+    hydrateBranchDivergence(ahead: number, behind: number): void;
+    hydrateRepoContext(ctx: RepoContext): void;
+    private processGhCommand;
+    private computePrMetrics;
+    hydrateGitLog(commits: readonly {
+        timestamp: number;
+        hash: string;
+    }[]): void;
+    replayTimeline(entries: readonly ReplayTimelineEntry[]): void;
+    getMetrics(): GitEfficiencyMetrics;
+    reset(_sessionId: string): void;
+    private classifyGitCommand;
+    private processEvent;
+    private countStaleBranchPulls;
+    private computeRiskIndicators;
+    private evaluateBestPractices;
+    private computePreventionScore;
+    private generateSuggestions;
+    private computeScore;
+    private computeVelocityMetrics;
+    private computeConflictStrategy;
+}
+//# sourceMappingURL=git-efficiency-tracker.d.ts.map

package/dist/metrics/git-efficiency-tracker.d.ts.map

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