@newrelic/preflight 0.0.1-pre.1 → 1.0.0

package/dist/metrics/claudemd-tracker.js

@@ -0,0 +1,337 @@
+/**
+ * CLAUDE.md Change Impact Tracking — detects modifications to CLAUDE.md
+ * and `.claude/` configuration files, computes before/after metric deltas
+ * from stored sessions, estimates token context costs, and emits NR metrics.
+ *
+ * Change detection:
+ *   - Within a session: Write/Edit tool calls targeting CLAUDE.md or .claude/
+ *   - Between sessions: SHA-256 hash comparison of CLAUDE.md content
+ *
+ * Impact analysis:
+ *   - Partitions sessions into before/after windows around a change timestamp
+ *   - Compares efficiency, cost, correction rate, tool calls per task, and
+ *     task success rate across the two windows
+ *   - Generates a verdict string: "Positive impact", "Negative impact", or
+ *     "Mixed impact" with the top changed metrics
+ */
+import { createHash } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import { createLogger } from '../shared/index.js';
+import { percentChange } from './trend-analyzer.js';
+const logger = createLogger('claudemd-tracker');
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Rough heuristic: 1 char ≈ 0.25 tokens for English text. */
+const TOKENS_PER_CHAR = 0.25;
+/** Baseline input cost: Sonnet 4's $3 per million input tokens. */
+const DEFAULT_INPUT_COST_PER_MTOK = 3;
+/** Average turns per session — used for per-session cost estimation. */
+const AVG_TURNS_PER_SESSION = 10;
+/** Regex matching CLAUDE.md files and .claude/ directory contents. */
+const CLAUDEMD_PATTERN = /(?:^|\/)CLAUDE\.md$|(?:^|\/)\.claude\//;
+const MAX_CHANGES = 1_000;
+// ---------------------------------------------------------------------------
+// ClaudeMdTracker
+// ---------------------------------------------------------------------------
+export class ClaudeMdTracker {
+    sessionStore;
+    changes = [];
+    lastEmittedIndex = 0;
+    cachedImpact = null;
+    constructor(options) {
+        this.sessionStore = options.sessionStore;
+    }
+    /**
+     * Examine a tool call record and detect if it modifies a CLAUDE.md or
+     * `.claude/` file. Returns the change event if detected, null otherwise.
+     */
+    detectChange(toolCall) {
+        if (toolCall.toolName !== 'Write' && toolCall.toolName !== 'Edit') {
+            return null;
+        }
+        const rec = toolCall;
+        const filePath = typeof rec.filePath === 'string' ? rec.filePath : null;
+        if (!filePath || !CLAUDEMD_PATTERN.test(filePath)) {
+            return null;
+        }
+        let changeType;
+        let linesAdded = 0;
+        let linesRemoved = 0;
+        if (toolCall.toolName === 'Write') {
+            changeType = 'created';
+            linesAdded = typeof rec.lineCount === 'number' ? rec.lineCount : 0;
+        }
+        else {
+            // Edit tool
+            if (rec.isDelete === true) {
+                changeType = 'deleted';
+            }
+            else {
+                changeType = 'modified';
+            }
+            linesAdded = typeof rec.newLineCount === 'number' ? rec.newLineCount : 0;
+            linesRemoved = typeof rec.oldLineCount === 'number' ? rec.oldLineCount : 0;
+        }
+        const diffSummary = `${changeType} ${filePath}: +${linesAdded}/-${linesRemoved} lines`;
+        const change = {
+            timestamp: toolCall.timestamp,
+            sessionId: toolCall.sessionId ?? 'unknown',
+            filePath,
+            changeType,
+            diffSummary,
+            linesAdded,
+            linesRemoved,
+        };
+        this.appendChange(change);
+        this.cachedImpact = null;
+        logger.debug('CLAUDE.md change detected', { filePath, changeType });
+        return change;
+    }
+    /** Returns all detected changes in this tracker's lifetime. */
+    getChanges() {
+        return [...this.changes];
+    }
+    /**
+     * Compute SHA-256 hash of a file's content.
+     * Throws if the file does not exist.
+     */
+    static computeFileHash(filePath) {
+        const content = readFileSync(filePath, 'utf-8');
+        return createHash('sha256').update(content).digest('hex');
+    }
+    /**
+     * Detect whether CLAUDE.md changed between sessions by comparing hashes.
+     * Returns true if hashes differ. Returns false when previousHash is null
+     * (first session ever — no prior state to compare against, so no change).
+     */
+    static detectBetweenSessionChange(previousHash, currentHash) {
+        if (previousHash === null)
+            return false;
+        return previousHash !== currentHash;
+    }
+    /**
+     * Compare metrics in the N days before vs N days after a change timestamp.
+     * Returns a full impact report with deltas, context cost estimate, and verdict.
+     */
+    computeImpact(changeTimestamp, windowDays = 7) {
+        const windowMs = windowDays * 86_400_000;
+        const allSessions = this.sessionStore.loadAllSessions();
+        const beforeSessions = allSessions.filter((s) => s.startTime >= changeTimestamp - windowMs && s.startTime < changeTimestamp);
+        const afterSessions = allSessions.filter((s) => s.startTime >= changeTimestamp && s.startTime < changeTimestamp + windowMs);
+        const beforeMetrics = aggregateSessions(beforeSessions);
+        const afterMetrics = aggregateSessions(afterSessions);
+        const deltas = {
+            efficiencyScore: beforeMetrics.avgEfficiencyScore !== null && afterMetrics.avgEfficiencyScore !== null
+                ? computeDelta(beforeMetrics.avgEfficiencyScore, afterMetrics.avgEfficiencyScore, true)
+                : null,
+            cost: computeDelta(beforeMetrics.avgCostUsd, afterMetrics.avgCostUsd, false),
+            correctionRate: computeDelta(beforeMetrics.avgCorrectionRate, afterMetrics.avgCorrectionRate, false),
+            toolCallsPerTask: computeDelta(beforeMetrics.avgToolCallsPerTask, afterMetrics.avgToolCallsPerTask, false),
+            taskSuccessRate: beforeMetrics.avgTaskSuccessRate !== null && afterMetrics.avgTaskSuccessRate !== null
+                ? computeDelta(beforeMetrics.avgTaskSuccessRate, afterMetrics.avgTaskSuccessRate, true)
+                : null,
+        };
+        // Estimate context tokens from the actual file size
+        let contextTokensForClaudeMd = 0;
+        const latestChange = [...this.changes].reverse().find((c) => c.changeType !== 'deleted');
+        if (latestChange) {
+            try {
+                const cost = ClaudeMdTracker.estimateContextCost(latestChange.filePath);
+                contextTokensForClaudeMd = cost.estimatedTokens;
+            }
+            catch (err) {
+                if (err.code === 'ENOENT') {
+                    contextTokensForClaudeMd = null;
+                }
+                else {
+                    logger.warn('Failed to estimate CLAUDE.md context cost', { error: String(err) });
+                    contextTokensForClaudeMd = 0;
+                }
+            }
+        }
+        // Generate verdict
+        const verdict = generateVerdict(deltas);
+        // Build change description
+        const lastChange = this.changes[this.changes.length - 1];
+        const changeDescription = lastChange?.diffSummary ?? 'Unknown change';
+        return {
+            changeDescription,
+            beforeMetrics,
+            afterMetrics,
+            deltas,
+            contextTokensForClaudeMd,
+            verdict,
+        };
+    }
+    appendChange(change) {
+        this.changes.push(change);
+        if (this.changes.length > MAX_CHANGES) {
+            const dropped = this.changes.length - MAX_CHANGES;
+            this.changes.splice(0, dropped);
+            this.lastEmittedIndex = Math.max(0, this.lastEmittedIndex - dropped);
+        }
+    }
+    getCachedImpact(timestamp) {
+        if (!this.cachedImpact || this.cachedImpact.timestamp !== timestamp) {
+            this.cachedImpact = { timestamp, report: this.computeImpact(timestamp) };
+        }
+        return this.cachedImpact.report;
+    }
+    /**
+     * Estimate the per-session and per-turn cost of loading a CLAUDE.md file
+     * into context. Reads the file and computes token estimate.
+     */
+    static estimateContextCost(claudeMdPath) {
+        const content = readFileSync(claudeMdPath, 'utf-8');
+        const charCount = content.length;
+        const estimatedTokens = Math.round(charCount * TOKENS_PER_CHAR);
+        const perTurnCostUsd = round((estimatedTokens / 1_000_000) * DEFAULT_INPUT_COST_PER_MTOK, 6);
+        const perSessionCostUsd = round(perTurnCostUsd * AVG_TURNS_PER_SESSION, 6);
+        return {
+            filePath: claudeMdPath,
+            charCount,
+            estimatedTokens,
+            perSessionCostUsd,
+            perTurnCostUsd,
+        };
+    }
+    /**
+     * Emit custom events and delta metrics for newly detected changes only.
+     * Impact report is cached and only recomputed when a new change arrives.
+     */
+    emitMetrics(aggregator) {
+        for (let i = this.lastEmittedIndex; i < this.changes.length; i++) {
+            const change = this.changes[i];
+            aggregator.record('ai.claudemd.change', 1, {
+                filePath: change.filePath,
+                changeType: change.changeType,
+                linesAdded: change.linesAdded,
+                linesRemoved: change.linesRemoved,
+            });
+        }
+        this.lastEmittedIndex = this.changes.length;
+        // Emit impact deltas for the latest change if we have one
+        if (this.changes.length > 0) {
+            const latest = this.changes[this.changes.length - 1];
+            const report = this.getCachedImpact(latest.timestamp);
+            if (report.deltas.efficiencyScore !== null) {
+                aggregator.record('ai.claudemd.post_change_efficiency_delta', report.deltas.efficiencyScore.value, { filePath: latest.filePath, changeType: latest.changeType });
+            }
+            aggregator.record('ai.claudemd.post_change_cost_delta', report.deltas.cost.value, {
+                filePath: latest.filePath,
+                changeType: latest.changeType,
+            });
+        }
+        logger.debug('CLAUDE.md change metrics emitted', { changeCount: this.changes.length });
+    }
+    reset() {
+        this.changes.length = 0;
+        this.lastEmittedIndex = 0;
+        this.cachedImpact = null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Session aggregation
+// ---------------------------------------------------------------------------
+function aggregateSessions(sessions) {
+    if (sessions.length === 0) {
+        return {
+            avgEfficiencyScore: null,
+            avgCostUsd: 0,
+            avgCorrectionRate: 0,
+            avgToolCallsPerTask: 0,
+            avgTaskSuccessRate: null,
+            sessionCount: 0,
+        };
+    }
+    let efficiencySum = 0;
+    let efficiencyCount = 0;
+    let totalCost = 0;
+    let totalCorrections = 0;
+    let totalUserMessages = 0;
+    let totalToolCalls = 0;
+    let totalTasks = 0;
+    let taskSuccessSum = 0;
+    for (const s of sessions) {
+        if (s.efficiencyScore !== null) {
+            efficiencySum += s.efficiencyScore;
+            efficiencyCount++;
+        }
+        totalCost += s.estimatedCostUsd ?? 0;
+        totalCorrections += s.userCorrections;
+        totalUserMessages += s.userMessages;
+        totalToolCalls += s.toolCallCount;
+        totalTasks += s.taskCount;
+        if (s.taskSuccessRate !== null) {
+            taskSuccessSum += s.taskSuccessRate * s.taskCount;
+        }
+    }
+    return {
+        avgEfficiencyScore: efficiencyCount > 0 ? round(efficiencySum / efficiencyCount, 3) : null,
+        avgCostUsd: round(totalCost / sessions.length, 4),
+        avgCorrectionRate: totalUserMessages > 0 ? round(totalCorrections / totalUserMessages, 3) : 0,
+        avgToolCallsPerTask: totalTasks > 0 ? round(totalToolCalls / totalTasks, 1) : 0,
+        avgTaskSuccessRate: totalTasks > 0 ? round(taskSuccessSum / totalTasks, 3) : null,
+        sessionCount: sessions.length,
+    };
+}
+// ---------------------------------------------------------------------------
+// Delta computation
+// ---------------------------------------------------------------------------
+function computeDelta(beforeValue, afterValue, higherIsBetter) {
+    const value = round(afterValue - beforeValue, 4);
+    const pct = percentChange(beforeValue, afterValue);
+    const improved = higherIsBetter ? value > 0 : value < 0;
+    return { value, percentChange: pct, improved };
+}
+// ---------------------------------------------------------------------------
+// Verdict generation
+// ---------------------------------------------------------------------------
+function generateVerdict(deltas) {
+    const entries = [
+        ...(deltas.efficiencyScore !== null
+            ? [{ name: 'efficiency', delta: deltas.efficiencyScore }]
+            : []),
+        { name: 'cost', delta: deltas.cost },
+        { name: 'corrections', delta: deltas.correctionRate },
+        { name: 'tool calls/task', delta: deltas.toolCallsPerTask },
+        ...(deltas.taskSuccessRate !== null
+            ? [{ name: 'task success', delta: deltas.taskSuccessRate }]
+            : []),
+    ];
+    const improved = entries.filter((e) => e.delta.improved);
+    const degraded = entries.filter((e) => !e.delta.improved && e.delta.value !== 0);
+    const formatMetric = (e) => {
+        if (e.delta.percentChange === null)
+            return `${e.name} ${e.delta.value > 0 ? '+' : ''}${e.delta.value}`;
+        const sign = e.delta.percentChange >= 0 ? '+' : '';
+        return `${e.name} ${sign}${e.delta.percentChange}%`;
+    };
+    // Sort by absolute percent change for most significant first (null treated as 0)
+    const sortByImpact = (a, b) => Math.abs(b.delta.percentChange ?? 0) - Math.abs(a.delta.percentChange ?? 0);
+    if (improved.length >= 3) {
+        const top = improved.sort(sortByImpact).slice(0, 2).map(formatMetric);
+        return `Positive impact: ${top.join(', ')}`;
+    }
+    if (degraded.length >= 3) {
+        const top = degraded.sort(sortByImpact).slice(0, 2).map(formatMetric);
+        return `Negative impact: ${top.join(', ')}`;
+    }
+    const parts = [];
+    if (improved.length > 0) {
+        parts.push(improved.sort(sortByImpact).slice(0, 1).map(formatMetric).join(''));
+    }
+    if (degraded.length > 0) {
+        parts.push(degraded.sort(sortByImpact).slice(0, 1).map(formatMetric).join(''));
+    }
+    return parts.length > 0 ? `Mixed impact: ${parts.join(', ')}` : 'No significant change';
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function round(value, decimals) {
+    const factor = Math.pow(10, decimals);
+    return Math.round(value * factor) / factor;
+}
+//# sourceMappingURL=claudemd-tracker.js.map

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

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

package/dist/metrics/collaboration-profile.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Developer Collaboration Profile — computes four profile dimensions from
+ * historical session data to characterize how a developer works with AI.
+ *
+ * Dimensions (each normalized to 0–1):
+ *   1. Specificity — how detailed are the developer's prompts?
+ *   2. Autonomy — how independently does the AI work?
+ *   3. Correction Rate — how rarely does the developer redirect the AI? (inverted)
+ *   4. Task Complexity — how complex are the tasks given to the AI?
+ *
+ * Classifications based on dimension thresholds:
+ *   - "Power User": high specificity + high autonomy
+ *   - "Delegator": low specificity + high autonomy
+ *   - "Learning": low specificity + frequent corrections
+ *   - "Collaborative": everything else
+ */
+import type { MetricAggregator } from '../shared/index.js';
+import type { SessionStore } from '../storage/session-store.js';
+export interface ProfileDimensions {
+    readonly specificity: number;
+    readonly autonomy: number;
+    readonly correctionRate: number;
+    readonly taskComplexity: number;
+}
+export interface WeeklyProfile {
+    readonly week: string;
+    readonly dimensions: ProfileDimensions;
+}
+export interface DeveloperProfile {
+    readonly developer: string;
+    readonly dimensions: ProfileDimensions;
+    readonly weeklyProfiles: WeeklyProfile[];
+    readonly classification: string;
+    readonly sessionCount: number;
+}
+export interface TeamBaseline {
+    readonly dimensions: ProfileDimensions;
+    readonly developerCount: number;
+    readonly sessionCount: number;
+}
+export interface TeamComparison {
+    readonly developer: string;
+    readonly developerDimensions: ProfileDimensions;
+    readonly teamDimensions: ProfileDimensions;
+    readonly deltas: ProfileDimensions;
+}
+export declare class CollaborationProfiler {
+    private readonly sessionStore;
+    constructor(options: {
+        sessionStore: SessionStore;
+    });
+    computeProfile(developer: string, options?: {
+        since?: Date;
+    }): DeveloperProfile;
+    computeTeamBaseline(options?: {
+        since?: Date;
+    }): TeamBaseline;
+    compareToTeam(developer: string, options?: {
+        since?: Date;
+    }): TeamComparison;
+    emitMetrics(aggregator: MetricAggregator, options?: {
+        since?: Date;
+    }): void;
+}
+//# sourceMappingURL=collaboration-profile.d.ts.map

package/dist/metrics/collaboration-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collaboration-profile.d.ts","sourceRoot":"","sources":["../../src/metrics/collaboration-profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAQhE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,cAAc,EAAE,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,mBAAmB,EAAE,iBAAiB,CAAC;IAChD,QAAQ,CAAC,cAAc,EAAE,iBAAiB,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACpC;AAMD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;gBAEhC,OAAO,EAAE;QAAE,YAAY,EAAE,YAAY,CAAA;KAAE;IAInD,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,IAAI,CAAA;KAAE,GAAG,gBAAgB;IAmB/E,mBAAmB,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,IAAI,CAAA;KAAE,GAAG,YAAY;IA8C7D,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,IAAI,CAAA;KAAE,GAAG,cAAc;IAuB5E,WAAW,CAAC,UAAU,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,IAAI,CAAA;KAAE,GAAG,IAAI;CAoB5E"}

package/dist/metrics/collaboration-profile.js

@@ -0,0 +1,231 @@
+/**
+ * Developer Collaboration Profile — computes four profile dimensions from
+ * historical session data to characterize how a developer works with AI.
+ *
+ * Dimensions (each normalized to 0–1):
+ *   1. Specificity — how detailed are the developer's prompts?
+ *   2. Autonomy — how independently does the AI work?
+ *   3. Correction Rate — how rarely does the developer redirect the AI? (inverted)
+ *   4. Task Complexity — how complex are the tasks given to the AI?
+ *
+ * Classifications based on dimension thresholds:
+ *   - "Power User": high specificity + high autonomy
+ *   - "Delegator": low specificity + high autonomy
+ *   - "Learning": low specificity + frequent corrections
+ *   - "Collaborative": everything else
+ */
+import { getIsoWeekId } from '../storage/weekly-summary.js';
+// ---------------------------------------------------------------------------
+// CollaborationProfiler
+// ---------------------------------------------------------------------------
+export class CollaborationProfiler {
+    sessionStore;
+    constructor(options) {
+        this.sessionStore = options.sessionStore;
+    }
+    computeProfile(developer, options) {
+        const sessions = this.sessionStore.loadAllSessions({
+            since: options?.since,
+            developer,
+        });
+        const dimensions = computeDimensions(sessions);
+        const weeklyProfiles = computeWeeklyProfiles(sessions);
+        const classification = classify(dimensions);
+        return {
+            developer,
+            dimensions,
+            weeklyProfiles,
+            classification,
+            sessionCount: sessions.length,
+        };
+    }
+    computeTeamBaseline(options) {
+        const allSessions = this.sessionStore.loadAllSessions({ since: options?.since });
+        // Group by developer and compute per-developer dimensions
+        const byDeveloper = new Map();
+        for (const s of allSessions) {
+            const list = byDeveloper.get(s.developer) ?? [];
+            list.push(s);
+            byDeveloper.set(s.developer, list);
+        }
+        if (byDeveloper.size === 0) {
+            return {
+                dimensions: { specificity: 0, autonomy: 0, correctionRate: 0, taskComplexity: 0 },
+                developerCount: 0,
+                sessionCount: 0,
+            };
+        }
+        let totalSpecificity = 0;
+        let totalAutonomy = 0;
+        let totalCorrectionRate = 0;
+        let totalTaskComplexity = 0;
+        for (const [, devSessions] of byDeveloper) {
+            const dims = computeDimensions(devSessions);
+            totalSpecificity += dims.specificity;
+            totalAutonomy += dims.autonomy;
+            totalCorrectionRate += dims.correctionRate;
+            totalTaskComplexity += dims.taskComplexity;
+        }
+        const n = byDeveloper.size;
+        return {
+            dimensions: {
+                specificity: round(totalSpecificity / n, 3),
+                autonomy: round(totalAutonomy / n, 3),
+                correctionRate: round(totalCorrectionRate / n, 3),
+                taskComplexity: round(totalTaskComplexity / n, 3),
+            },
+            developerCount: n,
+            sessionCount: allSessions.length,
+        };
+    }
+    compareToTeam(developer, options) {
+        const profile = this.computeProfile(developer, options);
+        const baseline = this.computeTeamBaseline(options);
+        return {
+            developer,
+            developerDimensions: profile.dimensions,
+            teamDimensions: baseline.dimensions,
+            deltas: {
+                specificity: round(profile.dimensions.specificity - baseline.dimensions.specificity, 3),
+                autonomy: round(profile.dimensions.autonomy - baseline.dimensions.autonomy, 3),
+                correctionRate: round(profile.dimensions.correctionRate - baseline.dimensions.correctionRate, 3),
+                taskComplexity: round(profile.dimensions.taskComplexity - baseline.dimensions.taskComplexity, 3),
+            },
+        };
+    }
+    emitMetrics(aggregator, options) {
+        const allSessions = this.sessionStore.loadAllSessions({ since: options?.since });
+        const byDeveloper = new Map();
+        for (const s of allSessions) {
+            const list = byDeveloper.get(s.developer) ?? [];
+            list.push(s);
+            byDeveloper.set(s.developer, list);
+        }
+        for (const [developer, devSessions] of byDeveloper) {
+            const dims = computeDimensions(devSessions);
+            const attrs = { developer };
+            aggregator.record('ai.collaboration.specificity', dims.specificity, attrs);
+            aggregator.record('ai.collaboration.autonomy', dims.autonomy, attrs);
+            aggregator.record('ai.collaboration.correction_rate', dims.correctionRate, attrs);
+            aggregator.record('ai.collaboration.task_complexity', dims.taskComplexity, attrs);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Dimension computation
+// ---------------------------------------------------------------------------
+function computeDimensions(sessions) {
+    if (sessions.length === 0) {
+        return { specificity: 0, autonomy: 0, correctionRate: 0, taskComplexity: 0 };
+    }
+    let totalToolCalls = 0;
+    let totalUserMessages = 0;
+    let totalAssistantMessages = 0;
+    let totalUserCorrections = 0;
+    let totalFiles = 0;
+    let totalTasks = 0;
+    let totalAgentSpawns = 0;
+    for (const s of sessions) {
+        totalToolCalls += s.toolCallCount;
+        totalUserMessages += s.userMessages;
+        totalAssistantMessages += s.assistantMessages;
+        totalUserCorrections += s.userCorrections;
+        totalFiles += s.filesRead.length + s.filesModified.length;
+        totalTasks += s.taskCount;
+        totalAgentSpawns += s.agentSpawns;
+    }
+    return {
+        specificity: computeSpecificity(totalToolCalls, totalUserMessages),
+        autonomy: computeAutonomy(totalToolCalls, totalAssistantMessages),
+        correctionRate: computeCorrectionRate(totalUserCorrections, totalUserMessages),
+        taskComplexity: computeTaskComplexity(totalFiles, totalToolCalls, totalAgentSpawns, totalTasks),
+    };
+}
+/**
+ * Specificity: ratio of tool calls to user messages, normalized so 10:1 = 1.0.
+ * When userMessages is 0, falls back to 0.5 (unknown).
+ */
+function computeSpecificity(toolCalls, userMessages) {
+    if (userMessages === 0)
+        return 0.5;
+    const ratio = toolCalls / userMessages;
+    return clamp(round(ratio / 10, 3), 0, 1);
+}
+/**
+ * Autonomy: tool calls per assistant message, normalized so 5 tool calls/turn = 1.0.
+ * Measures how much multi-step work the AI does independently per turn.
+ * When assistantMessages is 0, falls back to 0.5 (neutral/unknown).
+ */
+function computeAutonomy(toolCalls, assistantMessages) {
+    if (assistantMessages === 0)
+        return 0.5;
+    const ratio = toolCalls / assistantMessages;
+    return clamp(round(ratio / 5, 3), 0, 1);
+}
+/**
+ * Correction rate (inverted): 1 - (corrections / messages). 1.0 = no corrections.
+ * When userMessages is 0, falls back to 1.0 (no corrections observed).
+ */
+function computeCorrectionRate(corrections, userMessages) {
+    if (userMessages === 0)
+        return 1;
+    return clamp(round(1 - corrections / userMessages, 3), 0, 1);
+}
+/**
+ * Task complexity: composite of avg files per task, avg tool calls per task,
+ * and avg agent spawns per task, each normalized against reasonable baselines.
+ */
+function computeTaskComplexity(totalFiles, totalToolCalls, totalAgentSpawns, totalTasks) {
+    if (totalTasks === 0)
+        return 0;
+    const avgFiles = totalFiles / totalTasks;
+    const avgToolCalls = totalToolCalls / totalTasks;
+    const avgAgents = totalAgentSpawns / totalTasks;
+    // Normalize each component against reasonable baselines
+    const filesComponent = avgFiles / 20; // 20 files per task = max
+    const toolCallsComponent = avgToolCalls / 50; // 50 tool calls per task = max
+    const agentsComponent = avgAgents / 3; // 3 agents per task = max
+    const composite = (filesComponent + toolCallsComponent + agentsComponent) / 3;
+    return clamp(round(composite, 3), 0, 1);
+}
+// ---------------------------------------------------------------------------
+// Classification
+// ---------------------------------------------------------------------------
+function classify(dimensions) {
+    const { specificity, autonomy, correctionRate } = dimensions;
+    if (specificity >= 0.6 && autonomy >= 0.6)
+        return 'Power User';
+    if (specificity < 0.6 && autonomy >= 0.6)
+        return 'Delegator';
+    if (specificity < 0.6 && autonomy < 0.6 && correctionRate < 0.6)
+        return 'Learning';
+    return 'Collaborative';
+}
+// ---------------------------------------------------------------------------
+// Weekly profiles
+// ---------------------------------------------------------------------------
+function computeWeeklyProfiles(sessions) {
+    const byWeek = new Map();
+    for (const s of sessions) {
+        const week = getIsoWeekId(new Date(s.startTime));
+        const list = byWeek.get(week) ?? [];
+        list.push(s);
+        byWeek.set(week, list);
+    }
+    const profiles = [];
+    for (const [week, weekSessions] of byWeek) {
+        profiles.push({ week, dimensions: computeDimensions(weekSessions) });
+    }
+    return profiles.sort((a, b) => a.week.localeCompare(b.week));
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function clamp(value, min, max) {
+    return Math.min(max, Math.max(min, value));
+}
+function round(value, decimals) {
+    const factor = Math.pow(10, decimals);
+    return Math.round(value * factor) / factor;
+}
+//# sourceMappingURL=collaboration-profile.js.map