@guidemode/session-processing 0.1.43

package/dist/cjs/processors/canonical/metrics/usage.js

@@ -0,0 +1,327 @@
+"use strict";
+/**
+ * Unified Usage Metrics Processor
+ *
+ * Works for all providers using the canonical format.
+ * Measures Read/Write ratio and input clarity.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CanonicalUsageProcessor = void 0;
+const types_1 = require("@guidemode/types");
+const metric_processor_js_1 = require("../../base/metric-processor.js");
+class CanonicalUsageProcessor extends metric_processor_js_1.BaseMetricProcessor {
+    constructor() {
+        super(...arguments);
+        this.name = 'canonical-usage';
+        this.metricType = 'usage';
+        this.description = 'Measures Read/Write ratio and input clarity (unified for all providers)';
+    }
+    async process(session) {
+        const toolUses = this.extractToolUses(session);
+        const toolResults = this.extractToolResults(session);
+        const userMessages = session.messages.filter(m => m.type === 'user');
+        // Calculate Read/Write ratio
+        const readTools = ['Read', 'Grep', 'Glob', 'BashOutput'];
+        const writeTools = ['Write', 'Edit'];
+        const readCount = toolUses.filter(tool => readTools.includes(tool.name)).length;
+        const writeCount = toolUses.filter(tool => writeTools.includes(tool.name)).length;
+        const readWriteRatio = writeCount > 0 ? Number((readCount / writeCount).toFixed(2)) : readCount;
+        // Calculate input clarity score
+        const inputClarityScore = this.calculateInputClarityScore(userMessages);
+        // Calculate total lines read
+        const totalLinesRead = this.calculateLinesRead(toolUses, toolResults);
+        // Interpret Read/Write ratio (lower is better - AI knows where to go)
+        const ratioQuality = readWriteRatio <= 2 ? 'excellent' : readWriteRatio <= 5 ? 'acceptable' : 'poor';
+        return {
+            read_write_ratio: readWriteRatio,
+            input_clarity_score: inputClarityScore,
+            metadata: {
+                read_operations: readCount,
+                write_operations: writeCount,
+                total_user_messages: userMessages.length,
+                total_lines_read: totalLinesRead,
+                ratio_quality: ratioQuality, // 'excellent' | 'acceptable' | 'poor' (lower ratio is better)
+                improvement_tips: this.generateImprovementTips(readWriteRatio, inputClarityScore),
+            },
+        };
+    }
+    /**
+     * Extract tool uses from session
+     */
+    extractToolUses(session) {
+        const toolUses = [];
+        for (const message of session.messages) {
+            if ((0, types_1.isStructuredMessageContent)(message.content) && message.content.toolUse) {
+                toolUses.push(message.content.toolUse);
+            }
+        }
+        return toolUses;
+    }
+    /**
+     * Extract tool results from session
+     */
+    extractToolResults(session) {
+        const toolResults = [];
+        for (const message of session.messages) {
+            if ((0, types_1.isStructuredMessageContent)(message.content) && message.content.toolResult) {
+                toolResults.push(message.content.toolResult);
+            }
+        }
+        return toolResults;
+    }
+    /**
+     * Calculate input clarity score based on technical content
+     */
+    calculateInputClarityScore(userMessages) {
+        if (userMessages.length === 0)
+            return 0;
+        let totalScore = 0;
+        let totalWords = 0;
+        for (const message of userMessages) {
+            const content = this.extractTextContent(message);
+            const words = content.split(/\s+/).filter(word => word.length > 0);
+            totalWords += words.length;
+            // Count technical indicators
+            const technicalTerms = this.countTechnicalTerms(content);
+            const codeSnippets = this.countCodeSnippets(content);
+            const fileReferences = this.countFileReferences(content);
+            const specificityMarkers = this.countSpecificityMarkers(content);
+            const atReferences = this.countAtReferences(content);
+            const imageAttachments = this.countImageAttachments(message);
+            // Weighted score (reduced code snippet bias from ×2 to ×1.5)
+            const messageScore = technicalTerms +
+                codeSnippets * 1.5 +
+                fileReferences +
+                specificityMarkers * 2 +
+                atReferences * 2 +
+                imageAttachments * 3;
+            totalScore += messageScore;
+        }
+        // Return as percentage
+        const clarityScore = totalWords > 0 ? Math.round((totalScore / totalWords) * 100) : 0;
+        return Math.min(clarityScore, 100);
+    }
+    /**
+     * Extract text content from message
+     */
+    extractTextContent(message) {
+        if (typeof message.content === 'string') {
+            return message.content;
+        }
+        if (message.content.text) {
+            return message.content.text;
+        }
+        return '';
+    }
+    /**
+     * Count technical keywords in content
+     */
+    countTechnicalTerms(content) {
+        const technicalKeywords = [
+            // Programming concepts
+            'function',
+            'variable',
+            'class',
+            'method',
+            'api',
+            'interface',
+            'type',
+            'import',
+            'export',
+            'async',
+            'await',
+            'const',
+            'let',
+            'enum',
+            'struct',
+            'trait',
+            // Languages & frameworks
+            'typescript',
+            'javascript',
+            'python',
+            'rust',
+            'go',
+            'java',
+            'react',
+            'vue',
+            'svelte',
+            'angular',
+            'next.js',
+            'nextjs',
+            'astro',
+            'node',
+            'deno',
+            'bun',
+            // Database & backend
+            'database',
+            'query',
+            'schema',
+            'table',
+            'column',
+            'index',
+            'migration',
+            'sql',
+            'postgres',
+            'postgresql',
+            'mongodb',
+            'redis',
+            'drizzle',
+            'prisma',
+            // Frontend & styling
+            'component',
+            'tailwind',
+            'css',
+            'html',
+            'dom',
+            'jsx',
+            'tsx',
+            // Tools & packages
+            'npm',
+            'pnpm',
+            'yarn',
+            'package',
+            'build',
+            'test',
+            'lint',
+            'format',
+            'webpack',
+            'vite',
+            'esbuild',
+            // Architecture
+            'server',
+            'client',
+            'endpoint',
+            'route',
+            'middleware',
+            'hook',
+            'provider',
+            'context',
+            'state',
+        ];
+        const contentLower = content.toLowerCase();
+        return technicalKeywords.filter(keyword => contentLower.includes(keyword)).length;
+    }
+    /**
+     * Count code snippets in content
+     */
+    countCodeSnippets(content) {
+        const codeBlocks = (content.match(/```[\s\S]*?```/g) || []).length;
+        const inlineCode = (content.match(/`[^`\n]+`/g) || []).length;
+        return codeBlocks + inlineCode;
+    }
+    /**
+     * Count file references in content
+     */
+    countFileReferences(content) {
+        const fileExtensions = /\.\w{1,4}(\s|$|[^\w])/g;
+        const pathPatterns = /[\/\\][\w\-\.\/\\]+/g;
+        const extensions = (content.match(fileExtensions) || []).length;
+        const paths = (content.match(pathPatterns) || []).length;
+        return extensions + paths;
+    }
+    /**
+     * Count specificity markers: line numbers, function names, concrete examples
+     */
+    countSpecificityMarkers(content) {
+        let count = 0;
+        // Line number references (e.g., "file.ts:123", "line 45")
+        const lineNumberPatterns = [
+            /:\d+/g, // file.ts:123
+            /line\s+\d+/gi, // line 45
+            /lines?\s+\d+-\d+/gi, // lines 10-20
+        ];
+        for (const pattern of lineNumberPatterns) {
+            count += (content.match(pattern) || []).length;
+        }
+        // Function/method references (e.g., "calculateTotal()", "UserService.login")
+        const functionPatterns = [
+            /\w+\(\)/g, // functionName()
+            /\w+\.\w+\(/g, // object.method(
+        ];
+        for (const pattern of functionPatterns) {
+            count += (content.match(pattern) || []).length;
+        }
+        // Specific identifiers in camelCase or PascalCase
+        const identifierPattern = /\b[A-Z][a-z]+([A-Z][a-z]+)+\b/g; // PascalCase
+        count += (content.match(identifierPattern) || []).length;
+        return count;
+    }
+    /**
+     * Count @ file references (e.g., @src/file.ts, @components/Button.tsx)
+     */
+    countAtReferences(content) {
+        const atReferencePattern = /@[\w\-\.\/]+/g;
+        return (content.match(atReferencePattern) || []).length;
+    }
+    /**
+     * Count image attachments in message
+     */
+    countImageAttachments(message) {
+        let count = 0;
+        // Check for image content blocks in array content
+        if (typeof message.content !== 'string' && Array.isArray(message.content)) {
+            count += message.content.filter((block) => block.type === 'image').length;
+        }
+        // Check metadata for image attachments
+        if (message.metadata?.attachments) {
+            const attachments = Array.isArray(message.metadata.attachments)
+                ? message.metadata.attachments
+                : [message.metadata.attachments];
+            count += attachments.filter((att) => {
+                if (typeof att === 'string') {
+                    return att.toLowerCase().match(/\.(png|jpg|jpeg|gif|webp|svg)$/i);
+                }
+                return att?.type?.startsWith('image/');
+            }).length;
+        }
+        return count;
+    }
+    /**
+     * Calculate total lines read from tool results
+     */
+    calculateLinesRead(toolUses, toolResults) {
+        let total = 0;
+        // Map tool uses to results
+        const resultMap = new Map();
+        for (const result of toolResults) {
+            if (result.tool_use_id) {
+                resultMap.set(result.tool_use_id, result);
+            }
+        }
+        for (const tool of toolUses) {
+            const result = resultMap.get(tool.id);
+            if (!result || !result.content)
+                continue;
+            // Count lines for read operations
+            if (tool.name === 'Read' || tool.name === 'Grep' || tool.name === 'Glob') {
+                const content = typeof result.content === 'string' ? result.content : JSON.stringify(result.content);
+                const lines = content.split('\n').filter(l => l.trim()).length;
+                total += lines;
+            }
+        }
+        return total;
+    }
+    /**
+     * Generate improvement tips
+     */
+    generateImprovementTips(readWriteRatio, inputClarityScore) {
+        const tips = [];
+        if (readWriteRatio > 5) {
+            tips.push('High Read/Write ratio suggests AI is searching - provide specific file paths upfront');
+            tips.push('Include relevant code context in your requests to reduce exploration');
+        }
+        if (readWriteRatio <= 2) {
+            tips.push('Excellent efficiency! AI found and modified files quickly');
+        }
+        if (inputClarityScore < 20) {
+            tips.push('Low input clarity - try including more technical details and code examples');
+            tips.push('Specify exact file paths and function names for better results');
+        }
+        if (inputClarityScore > 50) {
+            tips.push('Great technical communication! Clear, specific inputs lead to better results');
+        }
+        return tips;
+    }
+}
+exports.CanonicalUsageProcessor = CanonicalUsageProcessor;
+//# sourceMappingURL=usage.js.map

package/dist/cjs/processors/canonical/metrics/usage.js.map

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

package/dist/cjs/processors/index.d.ts

@@ -0,0 +1,10 @@
+export * from './base/index.js';
+export { ProcessorRegistry, processorRegistry } from './registry.js';
+export { ClaudeCodeProcessor } from './providers/claude-code/index.js';
+export { CodexProcessor } from './providers/codex/index.js';
+export { CursorProcessor } from './providers/cursor/index.js';
+export { GitHubCopilotProcessor } from './providers/github-copilot/index.js';
+export { OpenCodeProcessor } from './providers/opencode/index.js';
+export { GeminiProcessor } from './providers/gemini/index.js';
+export { CanonicalSessionProcessor, CanonicalEngagementProcessor, CanonicalUsageProcessor, CanonicalQualityProcessor, CanonicalPerformanceProcessor, CanonicalErrorProcessor, CanonicalContextProcessor, } from './canonical/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/processors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/processors/index.ts"],"names":[],"mappings":"AACA,cAAc,iBAAiB,CAAA;AAG/B,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAGpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAA;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAG7D,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,uBAAuB,EACvB,yBAAyB,EACzB,6BAA6B,EAC7B,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,sBAAsB,CAAA"}

package/dist/cjs/processors/index.js

@@ -0,0 +1,46 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CanonicalContextProcessor = exports.CanonicalErrorProcessor = exports.CanonicalPerformanceProcessor = exports.CanonicalQualityProcessor = exports.CanonicalUsageProcessor = exports.CanonicalEngagementProcessor = exports.CanonicalSessionProcessor = exports.GeminiProcessor = exports.OpenCodeProcessor = exports.GitHubCopilotProcessor = exports.CursorProcessor = exports.CodexProcessor = exports.ClaudeCodeProcessor = exports.processorRegistry = exports.ProcessorRegistry = void 0;
+// Export base classes
+__exportStar(require("./base/index.js"), exports);
+// Export registry
+var registry_js_1 = require("./registry.js");
+Object.defineProperty(exports, "ProcessorRegistry", { enumerable: true, get: function () { return registry_js_1.ProcessorRegistry; } });
+Object.defineProperty(exports, "processorRegistry", { enumerable: true, get: function () { return registry_js_1.processorRegistry; } });
+// Export provider processors
+var index_js_1 = require("./providers/claude-code/index.js");
+Object.defineProperty(exports, "ClaudeCodeProcessor", { enumerable: true, get: function () { return index_js_1.ClaudeCodeProcessor; } });
+var index_js_2 = require("./providers/codex/index.js");
+Object.defineProperty(exports, "CodexProcessor", { enumerable: true, get: function () { return index_js_2.CodexProcessor; } });
+var index_js_3 = require("./providers/cursor/index.js");
+Object.defineProperty(exports, "CursorProcessor", { enumerable: true, get: function () { return index_js_3.CursorProcessor; } });
+var index_js_4 = require("./providers/github-copilot/index.js");
+Object.defineProperty(exports, "GitHubCopilotProcessor", { enumerable: true, get: function () { return index_js_4.GitHubCopilotProcessor; } });
+var index_js_5 = require("./providers/opencode/index.js");
+Object.defineProperty(exports, "OpenCodeProcessor", { enumerable: true, get: function () { return index_js_5.OpenCodeProcessor; } });
+var index_js_6 = require("./providers/gemini/index.js");
+Object.defineProperty(exports, "GeminiProcessor", { enumerable: true, get: function () { return index_js_6.GeminiProcessor; } });
+// Export canonical metrics processors
+var index_js_7 = require("./canonical/index.js");
+Object.defineProperty(exports, "CanonicalSessionProcessor", { enumerable: true, get: function () { return index_js_7.CanonicalSessionProcessor; } });
+Object.defineProperty(exports, "CanonicalEngagementProcessor", { enumerable: true, get: function () { return index_js_7.CanonicalEngagementProcessor; } });
+Object.defineProperty(exports, "CanonicalUsageProcessor", { enumerable: true, get: function () { return index_js_7.CanonicalUsageProcessor; } });
+Object.defineProperty(exports, "CanonicalQualityProcessor", { enumerable: true, get: function () { return index_js_7.CanonicalQualityProcessor; } });
+Object.defineProperty(exports, "CanonicalPerformanceProcessor", { enumerable: true, get: function () { return index_js_7.CanonicalPerformanceProcessor; } });
+Object.defineProperty(exports, "CanonicalErrorProcessor", { enumerable: true, get: function () { return index_js_7.CanonicalErrorProcessor; } });
+Object.defineProperty(exports, "CanonicalContextProcessor", { enumerable: true, get: function () { return index_js_7.CanonicalContextProcessor; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/processors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/processors/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,sBAAsB;AACtB,kDAA+B;AAE/B,kBAAkB;AAClB,6CAAoE;AAA3D,gHAAA,iBAAiB,OAAA;AAAE,gHAAA,iBAAiB,OAAA;AAE7C,6BAA6B;AAC7B,6DAAsE;AAA7D,+GAAA,mBAAmB,OAAA;AAC5B,uDAA2D;AAAlD,0GAAA,cAAc,OAAA;AACvB,wDAA6D;AAApD,2GAAA,eAAe,OAAA;AACxB,gEAA4E;AAAnE,kHAAA,sBAAsB,OAAA;AAC/B,0DAAiE;AAAxD,6GAAA,iBAAiB,OAAA;AAC1B,wDAA6D;AAApD,2GAAA,eAAe,OAAA;AAExB,sCAAsC;AACtC,iDAQ6B;AAP3B,qHAAA,yBAAyB,OAAA;AACzB,wHAAA,4BAA4B,OAAA;AAC5B,mHAAA,uBAAuB,OAAA;AACvB,qHAAA,yBAAyB,OAAA;AACzB,yHAAA,6BAA6B,OAAA;AAC7B,mHAAA,uBAAuB,OAAA;AACvB,qHAAA,yBAAyB,OAAA"}

package/dist/cjs/processors/providers/claude-code/index.d.ts

@@ -0,0 +1,39 @@
+import type { ProcessorContext, ProcessorResult } from '@guidemode/types';
+import { type BaseMetricProcessor, BaseProviderProcessor } from '../../base/index.js';
+export declare class ClaudeCodeProcessor extends BaseProviderProcessor {
+    readonly providerName = "claude-code";
+    readonly description = "Processes Claude Code session logs (uses canonical metrics)";
+    private parser;
+    private metricProcessors;
+    private gitDiffProcessor;
+    constructor();
+    parseSession(jsonlContent: string, _provider: string): import("../../../parsers/index.js").ParsedSession;
+    getMetricProcessors(): BaseMetricProcessor[];
+    /**
+     * Override to run git diff processor LAST with access to existing metrics
+     */
+    processMetrics(jsonlContent: string, context: ProcessorContext): Promise<ProcessorResult[]>;
+    canProcess(content: string): boolean;
+    /**
+     * Get processor information for debugging and monitoring
+     */
+    getProcessorInfo(): {
+        providerName: string;
+        description: string;
+        metricProcessors: {
+            name: string;
+            metricType: import("@guidemode/types").MetricType;
+            description: string;
+        }[];
+        version: string;
+    };
+    /**
+     * Validate Claude Code specific content format
+     */
+    protected validateClaudeCodeFormat(content: string): void;
+    /**
+     * Override parent validation to handle summary lines and include Claude Code specific checks
+     */
+    protected validateJsonlContent(content: string): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/processors/providers/claude-code/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/processors/providers/claude-code/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAEzE,OAAO,EACL,KAAK,mBAAmB,EACxB,qBAAqB,EAEtB,MAAM,qBAAqB,CAAA;AAU5B,qBAAa,mBAAoB,SAAQ,qBAAqB;IAC5D,QAAQ,CAAC,YAAY,iBAAgB;IACrC,QAAQ,CAAC,WAAW,iEAAgE;IAEpF,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,gBAAgB,CAA+B;;IAgBvD,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAOpD,mBAAmB,IAAI,mBAAmB,EAAE;IAI5C;;OAEG;IACG,cAAc,CAClB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,EAAE,CAAC;IAmD7B,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IA+BpC;;OAEG;IACH,gBAAgB;;;;;;;;;;IAahB;;OAEG;IACH,SAAS,CAAC,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAyCzD;;OAEG;IACH,SAAS,CAAC,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CA+BtD"}

package/dist/cjs/processors/providers/claude-code/index.js

@@ -0,0 +1,199 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClaudeCodeProcessor = void 0;
+const index_js_1 = require("../../../parsers/index.js");
+const index_js_2 = require("../../base/index.js");
+const index_js_3 = require("../../canonical/index.js");
+class ClaudeCodeProcessor extends index_js_2.BaseProviderProcessor {
+    constructor() {
+        super();
+        this.providerName = 'claude-code';
+        this.description = 'Processes Claude Code session logs (uses canonical metrics)';
+        this.parser = new index_js_1.CanonicalParser();
+        this.gitDiffProcessor = new index_js_2.GitDiffMetricProcessor();
+        // Use canonical metrics processors - no provider-specific logic needed
+        this.metricProcessors = [
+            new index_js_3.CanonicalPerformanceProcessor(),
+            new index_js_3.CanonicalEngagementProcessor(),
+            new index_js_3.CanonicalQualityProcessor(),
+            new index_js_3.CanonicalUsageProcessor(),
+            new index_js_3.CanonicalErrorProcessor(),
+            new index_js_3.CanonicalContextProcessor(),
+        ];
+    }
+    parseSession(jsonlContent, _provider) {
+        this.validateJsonlContent(jsonlContent);
+        const session = this.parser.parseSession(jsonlContent);
+        session.provider = this.providerName; // Override to keep real provider
+        return session;
+    }
+    getMetricProcessors() {
+        return this.metricProcessors;
+    }
+    /**
+     * Override to run git diff processor LAST with access to existing metrics
+     */
+    async processMetrics(jsonlContent, context) {
+        const session = this.parseSession(jsonlContent, context.provider);
+        // Attach git diff data from context if available (desktop only)
+        if (context.gitDiffData) {
+            session.metadata = {
+                ...session.metadata,
+                gitDiff: context.gitDiffData,
+            };
+        }
+        // Run standard metrics first
+        const results = await super.processMetrics(jsonlContent, context);
+        // Collect existing metrics for git diff processor
+        const existingMetrics = {};
+        for (const result of results) {
+            if (result.metricType === 'performance')
+                existingMetrics.performance = result.metrics;
+            if (result.metricType === 'usage')
+                existingMetrics.usage = result.metrics;
+            if (result.metricType === 'error')
+                existingMetrics.error = result.metrics;
+            if (result.metricType === 'engagement')
+                existingMetrics.engagement = result.metrics;
+            if (result.metricType === 'quality')
+                existingMetrics.quality = result.metrics;
+        }
+        // Run git diff processor LAST with existing metrics
+        try {
+            const gitDiffMetrics = await this.gitDiffProcessor.processWithExistingMetrics(session, existingMetrics);
+            // Only add if there's actual git data (total files > 0)
+            if (gitDiffMetrics && gitDiffMetrics.git_total_files_changed > 0) {
+                results.push({
+                    metricType: 'git-diff',
+                    metrics: gitDiffMetrics,
+                    processingTime: 0,
+                    metadata: {
+                        processor: 'git-diff',
+                        processingTime: 0,
+                        messageCount: session.messages.length,
+                        sessionDuration: session.duration,
+                    },
+                });
+            }
+        }
+        catch (error) {
+            console.warn('Git diff processor failed (expected for server sessions):', error);
+        }
+        return results;
+    }
+    canProcess(content) {
+        try {
+            // Basic validation
+            const lines = content.split('\n').filter(line => line.trim());
+            if (lines.length === 0)
+                return false;
+            // Check if it looks like Claude Code format by finding the first valid JSON line
+            for (const line of lines) {
+                try {
+                    const parsedLine = JSON.parse(line);
+                    // Claude Code messages should have these fields
+                    const hasClaudeFields = parsedLine.uuid &&
+                        parsedLine.timestamp &&
+                        parsedLine.type &&
+                        parsedLine.message &&
+                        (parsedLine.type === 'user' || parsedLine.type === 'assistant');
+                    if (hasClaudeFields) {
+                        return true;
+                    }
+                }
+                catch { }
+            }
+            return false;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get processor information for debugging and monitoring
+     */
+    getProcessorInfo() {
+        return {
+            providerName: this.providerName,
+            description: this.description,
+            metricProcessors: this.metricProcessors.map(processor => ({
+                name: processor.name,
+                metricType: processor.metricType,
+                description: processor.description,
+            })),
+            version: '1.0.0',
+        };
+    }
+    /**
+     * Validate Claude Code specific content format
+     */
+    validateClaudeCodeFormat(content) {
+        const lines = content.split('\n').filter(line => line.trim());
+        if (lines.length === 0) {
+            throw new Error('No content lines found');
+        }
+        // Find and validate a few actual message lines (skip summary lines)
+        let validMessageLines = 0;
+        const targetValidLines = Math.min(3, lines.length);
+        for (const line of lines) {
+            try {
+                const message = JSON.parse(line);
+                // Skip summary lines (they have type: "summary" and different structure)
+                if (message.type === 'summary') {
+                    continue;
+                }
+                // Check if this looks like a Claude Code message
+                if (message.uuid && message.timestamp && message.type && message.message) {
+                    if (['user', 'assistant'].includes(message.type)) {
+                        // Validate timestamp format
+                        const timestamp = new Date(message.timestamp);
+                        if (!Number.isNaN(timestamp.getTime())) {
+                            validMessageLines++;
+                            if (validMessageLines >= targetValidLines) {
+                                break;
+                            }
+                        }
+                    }
+                }
+            }
+            catch (_parseError) { }
+        }
+        if (validMessageLines === 0) {
+            throw new Error('No valid Claude Code message lines found');
+        }
+    }
+    /**
+     * Override parent validation to handle summary lines and include Claude Code specific checks
+     */
+    validateJsonlContent(content) {
+        if (!content || content.trim().length === 0) {
+            throw new Error('Content is empty');
+        }
+        const lines = content.split('\n').filter(line => line.trim());
+        if (lines.length === 0) {
+            throw new Error('No valid lines found in content');
+        }
+        // Find and validate at least a few JSON lines (skipping summary lines)
+        let validJsonLines = 0;
+        const targetValidLines = Math.min(3, lines.length);
+        for (const line of lines) {
+            try {
+                JSON.parse(line);
+                validJsonLines++;
+                if (validJsonLines >= targetValidLines) {
+                    break;
+                }
+            }
+            catch { }
+        }
+        if (validJsonLines === 0) {
+            throw new Error('No valid JSON lines found in content');
+        }
+        // Then run Claude Code specific validation
+        this.validateClaudeCodeFormat(content);
+    }
+}
+exports.ClaudeCodeProcessor = ClaudeCodeProcessor;
+// ClaudeCodeProcessor now uses canonical metrics
+// All metric processors are from the canonical implementation
+//# sourceMappingURL=index.js.map