@guidemode/session-processing 0.1.43

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

@@ -0,0 +1,283 @@
+"use strict";
+/**
+ * Unified Quality Metrics Processor
+ *
+ * Works for all providers using the canonical format.
+ * Measures task success rate, iteration count, and process quality.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CanonicalQualityProcessor = void 0;
+const types_1 = require("@guidemode/types");
+const metric_processor_js_1 = require("../../base/metric-processor.js");
+class CanonicalQualityProcessor extends metric_processor_js_1.BaseMetricProcessor {
+    constructor() {
+        super(...arguments);
+        this.name = 'canonical-quality';
+        this.metricType = 'quality';
+        this.description = 'Measures task success rate, iteration count, and process quality (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 task success rate
+        const successfulOperations = toolResults.filter(result => !result.is_error).length;
+        const totalOperations = toolResults.length;
+        const taskSuccessRate = totalOperations > 0 ? Math.round((successfulOperations / totalOperations) * 100) : 0;
+        // Calculate iteration count
+        const iterationCount = this.calculateIterations(userMessages, session);
+        // Detect plan mode and todo tracking usage
+        const planModeUsage = this.detectPlanModeUsage(toolUses);
+        const todoTrackingUsage = this.detectTodoTrackingUsage(toolUses);
+        // Detect over-the-top affirmations
+        const overTopAffirmations = this.detectOverTopAffirmations(session);
+        // Calculate process quality score
+        const processQualityScore = this.calculateProcessQuality(toolUses, session, planModeUsage.used, todoTrackingUsage.used);
+        return {
+            task_success_rate: taskSuccessRate,
+            iteration_count: iterationCount,
+            process_quality_score: processQualityScore,
+            used_plan_mode: planModeUsage.used,
+            used_todo_tracking: todoTrackingUsage.used,
+            over_top_affirmations: overTopAffirmations.count,
+            metadata: {
+                successful_operations: successfulOperations,
+                total_operations: totalOperations,
+                exit_plan_mode_count: planModeUsage.count,
+                todo_write_count: todoTrackingUsage.count,
+                over_top_affirmations_phrases: overTopAffirmations.phrases,
+                improvement_tips: this.generateImprovementTips(taskSuccessRate, iterationCount, processQualityScore, planModeUsage.used, todoTrackingUsage.used),
+            },
+        };
+    }
+    /**
+     * 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 iteration count (refinement cycles)
+     */
+    calculateIterations(_userMessages, session) {
+        let iterations = 0;
+        for (let i = 0; i < session.messages.length; i++) {
+            const message = session.messages[i];
+            // Only check user messages
+            if (message.type !== 'user')
+                continue;
+            // Check if this user message follows an assistant response
+            const prevMessage = i > 0 ? session.messages[i - 1] : null;
+            if (!prevMessage || prevMessage.type !== 'assistant')
+                continue;
+            const content = this.extractTextContent(message).toLowerCase();
+            // Refinement patterns
+            const refinementPatterns = [
+                'actually,',
+                'instead,',
+                'wait,',
+                'no,',
+                'correction:',
+                'change that',
+                'modify that',
+                'update that',
+                'fix that',
+                'make it',
+                "let's change",
+                'can you change',
+                'different approach',
+                'try a different',
+                "let's try",
+                "that's not",
+                "that won't work",
+                "that's wrong",
+                'rather than',
+                'instead of',
+                'better to',
+            ];
+            if (refinementPatterns.some(pattern => content.includes(pattern))) {
+                iterations++;
+            }
+        }
+        return iterations;
+    }
+    /**
+     * Detect plan mode usage
+     */
+    detectPlanModeUsage(toolUses) {
+        const exitPlanModeTools = toolUses.filter(tool => tool.name === 'ExitPlanMode');
+        return {
+            used: exitPlanModeTools.length > 0,
+            count: exitPlanModeTools.length,
+        };
+    }
+    /**
+     * Detect todo tracking usage
+     */
+    detectTodoTrackingUsage(toolUses) {
+        const todoWriteTools = toolUses.filter(tool => tool.name === 'TodoWrite');
+        return {
+            used: todoWriteTools.length > 0,
+            count: todoWriteTools.length,
+        };
+    }
+    /**
+     * Calculate process quality score
+     */
+    calculateProcessQuality(toolUses, _session, usedPlanMode, usedTodoTracking) {
+        let score = 0;
+        const maxScore = 100;
+        // Plan mode usage (highest priority)
+        if (usedPlanMode) {
+            score += 30;
+        }
+        // Todo tracking usage
+        if (usedTodoTracking) {
+            score += 20;
+        }
+        // Read before write pattern
+        const readTools = ['Read', 'Grep', 'Glob'];
+        const writeTools = ['Write', 'Edit'];
+        const reads = toolUses.filter(tool => readTools.includes(tool.name));
+        const writes = toolUses.filter(tool => writeTools.includes(tool.name));
+        if (reads.length > 0 && writes.length > 0) {
+            score += 25;
+        }
+        // Testing/checking patterns
+        const testingTools = ['Bash', 'BashOutput'];
+        const testing = toolUses.filter(tool => testingTools.includes(tool.name));
+        if (testing.length > 0 && writes.length > 0) {
+            score += 15;
+        }
+        // Incremental approach
+        if (writes.length > 1 && writes.length <= 5) {
+            score += 10;
+        }
+        // Penalize excessive searching
+        const searchRatio = reads.length / (writes.length || 1);
+        if (searchRatio > 2) {
+            score -= 10;
+        }
+        return Math.max(0, Math.min(score, maxScore));
+    }
+    /**
+     * Detect over-the-top affirmations
+     */
+    detectOverTopAffirmations(session) {
+        const affirmationPatterns = [
+            /\byou'?re\s+right\b/i,
+            /\byou'?re\s+absolutely\s+right\b/i,
+            /\byou'?re\s+completely\s+right\b/i,
+            /\byou'?re\s+totally\s+right\b/i,
+            /\byou'?re\s+100%\s+right\b/i,
+            /\byou'?re\s+spot\s+on\b/i,
+            /\byou'?re\s+exactly\s+right\b/i,
+            /\bexactly!?\s*$/i,
+            /\babsolutely!?\s*$/i,
+            /\bperfect!?\s*$/i,
+            /\bbrilliant!?\s*$/i,
+            /\bexcellent!?\s*$/i,
+            /\bthat'?s\s+absolutely\s+right\b/i,
+            /\bthat'?s\s+completely\s+correct\b/i,
+            /\bthat'?s\s+exactly\s+right\b/i,
+            /\bthat'?s\s+spot\s+on\b/i,
+            /\bthat'?s\s+perfect\b/i,
+            /\byes!+\s*$/i,
+            /\bawesome!+\s*$/i,
+            /\bfantastic!+\s*$/i,
+            /\bwonderful!+\s*$/i,
+        ];
+        let totalCount = 0;
+        const foundPhrases = [];
+        const assistantMessages = session.messages.filter(m => m.type === 'assistant');
+        for (const message of assistantMessages) {
+            const content = this.extractTextContent(message).toLowerCase();
+            for (const pattern of affirmationPatterns) {
+                const matches = content.match(pattern);
+                if (matches) {
+                    totalCount++;
+                    foundPhrases.push(matches[0]);
+                }
+            }
+        }
+        return {
+            count: totalCount,
+            phrases: Array.from(new Set(foundPhrases)),
+        };
+    }
+    /**
+     * Extract text content from message
+     */
+    extractTextContent(message) {
+        if (typeof message.content === 'string') {
+            return message.content;
+        }
+        if (message.content.text) {
+            return message.content.text;
+        }
+        return '';
+    }
+    /**
+     * Generate improvement tips
+     */
+    generateImprovementTips(taskSuccessRate, iterationCount, processQuality, usedPlanMode, usedTodoTracking) {
+        const tips = [];
+        const hasQualityIssues = taskSuccessRate < 70 || iterationCount > 10 || processQuality < 50;
+        // Plan mode and todo tracking tips
+        if (hasQualityIssues || processQuality < 60) {
+            if (!usedPlanMode && !usedTodoTracking) {
+                tips.push('For complex tasks, use plan mode to organize your approach upfront');
+                tips.push('Consider using TodoWrite to track progress on multi-step tasks');
+            }
+            else if (!usedPlanMode) {
+                tips.push('Try using plan mode to outline your approach before starting complex tasks');
+            }
+            else if (!usedTodoTracking) {
+                tips.push('Consider using TodoWrite to track progress and ensure all steps are completed');
+            }
+        }
+        // Task success and iteration tips
+        if (taskSuccessRate < 70) {
+            tips.push('Low success rate - ensure comprehensive upfront context (file paths, specs, code examples)');
+            tips.push('Consider improving documentation to reduce AI exploration');
+        }
+        if (iterationCount > 10) {
+            tips.push('Many iterations - consider whether initial prompt provided enough technical detail and context');
+        }
+        // Excellence recognition
+        if (usedPlanMode &&
+            usedTodoTracking &&
+            taskSuccessRate > 80 &&
+            iterationCount <= 5 &&
+            processQuality > 80) {
+            tips.push('Outstanding! Excellent process discipline with plan mode, todo tracking, and clear context');
+        }
+        else if ((usedPlanMode || usedTodoTracking) && taskSuccessRate > 75 && processQuality > 70) {
+            tips.push('Great collaboration! Your use of planning tools shows excellent AI process discipline');
+        }
+        else if (taskSuccessRate > 80 && iterationCount <= 5 && processQuality > 70) {
+            tips.push('Excellent! Effective context and steering led to efficient execution');
+        }
+        return tips;
+    }
+}
+exports.CanonicalQualityProcessor = CanonicalQualityProcessor;
+//# sourceMappingURL=quality.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"quality.js","sourceRoot":"","sources":["../../../../../src/processors/canonical/metrics/quality.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,4CAA6D;AAE7D,wEAAoE;AAEpE,MAAa,yBAA0B,SAAQ,yCAAmB;IAAlE;;QACW,SAAI,GAAG,mBAAmB,CAAA;QAC1B,eAAU,GAAG,SAAkB,CAAA;QAC/B,gBAAW,GAClB,8FAA8F,CAAA;IAoVlG,CAAC;IAlVC,KAAK,CAAC,OAAO,CAAC,OAAsB;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;QAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAA;QACpD,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAA;QAEpE,8BAA8B;QAC9B,MAAM,oBAAoB,GAAG,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAA;QAClF,MAAM,eAAe,GAAG,WAAW,CAAC,MAAM,CAAA;QAC1C,MAAM,eAAe,GACnB,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,oBAAoB,GAAG,eAAe,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAEtF,4BAA4B;QAC5B,MAAM,cAAc,GAAG,IAAI,CAAC,mBAAmB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;QAEtE,2CAA2C;QAC3C,MAAM,aAAa,GAAG,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAA;QACxD,MAAM,iBAAiB,GAAG,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAA;QAEhE,mCAAmC;QACnC,MAAM,mBAAmB,GAAG,IAAI,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAA;QAEnE,kCAAkC;QAClC,MAAM,mBAAmB,GAAG,IAAI,CAAC,uBAAuB,CACtD,QAAQ,EACR,OAAO,EACP,aAAa,CAAC,IAAI,EAClB,iBAAiB,CAAC,IAAI,CACvB,CAAA;QAED,OAAO;YACL,iBAAiB,EAAE,eAAe;YAClC,eAAe,EAAE,cAAc;YAC/B,qBAAqB,EAAE,mBAAmB;YAC1C,cAAc,EAAE,aAAa,CAAC,IAAI;YAClC,kBAAkB,EAAE,iBAAiB,CAAC,IAAI;YAC1C,qBAAqB,EAAE,mBAAmB,CAAC,KAAK;YAChD,QAAQ,EAAE;gBACR,qBAAqB,EAAE,oBAAoB;gBAC3C,gBAAgB,EAAE,eAAe;gBACjC,oBAAoB,EAAE,aAAa,CAAC,KAAK;gBACzC,gBAAgB,EAAE,iBAAiB,CAAC,KAAK;gBACzC,6BAA6B,EAAE,mBAAmB,CAAC,OAAO;gBAC1D,gBAAgB,EAAE,IAAI,CAAC,uBAAuB,CAC5C,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,aAAa,CAAC,IAAI,EAClB,iBAAiB,CAAC,IAAI,CACvB;aACF;SACF,CAAA;IACH,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,OAAsB;QAC5C,MAAM,QAAQ,GAAqB,EAAE,CAAA;QAErC,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACvC,IAAI,IAAA,kCAA0B,EAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;gBAC3E,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;YACxC,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,OAAsB;QAC/C,MAAM,WAAW,GAAwB,EAAE,CAAA;QAE3C,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACvC,IAAI,IAAA,kCAA0B,EAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;gBAC9E,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;YAC9C,CAAC;QACH,CAAC;QAED,OAAO,WAAW,CAAA;IACpB,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,aAA8B,EAAE,OAAsB;QAChF,IAAI,UAAU,GAAG,CAAC,CAAA;QAElB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACjD,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;YAEnC,2BAA2B;YAC3B,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;gBAAE,SAAQ;YAErC,2DAA2D;YAC3D,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;YAC1D,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,IAAI,KAAK,WAAW;gBAAE,SAAQ;YAE9D,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAA;YAE9D,sBAAsB;YACtB,MAAM,kBAAkB,GAAG;gBACzB,WAAW;gBACX,UAAU;gBACV,OAAO;gBACP,KAAK;gBACL,aAAa;gBACb,aAAa;gBACb,aAAa;gBACb,aAAa;gBACb,UAAU;gBACV,SAAS;gBACT,cAAc;gBACd,gBAAgB;gBAChB,oBAAoB;gBACpB,iBAAiB;gBACjB,WAAW;gBACX,YAAY;gBACZ,iBAAiB;gBACjB,cAAc;gBACd,aAAa;gBACb,YAAY;gBACZ,WAAW;aACZ,CAAA;YAED,IAAI,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;gBAClE,UAAU,EAAE,CAAA;YACd,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAA;IACnB,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,QAA0B;QACpD,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,CAAA;QAC/E,OAAO;YACL,IAAI,EAAE,iBAAiB,CAAC,MAAM,GAAG,CAAC;YAClC,KAAK,EAAE,iBAAiB,CAAC,MAAM;SAChC,CAAA;IACH,CAAC;IAED;;OAEG;IACK,uBAAuB,CAAC,QAA0B;QACxD,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,CAAA;QACzE,OAAO;YACL,IAAI,EAAE,cAAc,CAAC,MAAM,GAAG,CAAC;YAC/B,KAAK,EAAE,cAAc,CAAC,MAAM;SAC7B,CAAA;IACH,CAAC;IAED;;OAEG;IACK,uBAAuB,CAC7B,QAA0B,EAC1B,QAAuB,EACvB,YAAqB,EACrB,gBAAyB;QAEzB,IAAI,KAAK,GAAG,CAAC,CAAA;QACb,MAAM,QAAQ,GAAG,GAAG,CAAA;QAEpB,qCAAqC;QACrC,IAAI,YAAY,EAAE,CAAC;YACjB,KAAK,IAAI,EAAE,CAAA;QACb,CAAC;QAED,sBAAsB;QACtB,IAAI,gBAAgB,EAAE,CAAC;YACrB,KAAK,IAAI,EAAE,CAAA;QACb,CAAC;QAED,4BAA4B;QAC5B,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;QAC1C,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QAEpC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QACpE,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QAEtE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,KAAK,IAAI,EAAE,CAAA;QACb,CAAC;QAED,4BAA4B;QAC5B,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;QAC3C,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QAEzE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,KAAK,IAAI,EAAE,CAAA;QACb,CAAC;QAED,uBAAuB;QACvB,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YAC5C,KAAK,IAAI,EAAE,CAAA;QACb,CAAC;QAED,+BAA+B;QAC/B,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAA;QACvD,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YACpB,KAAK,IAAI,EAAE,CAAA;QACb,CAAC;QAED,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAA;IAC/C,CAAC;IAED;;OAEG;IACK,yBAAyB,CAAC,OAAsB;QACtD,MAAM,mBAAmB,GAAG;YAC1B,sBAAsB;YACtB,mCAAmC;YACnC,mCAAmC;YACnC,gCAAgC;YAChC,6BAA6B;YAC7B,0BAA0B;YAC1B,gCAAgC;YAChC,kBAAkB;YAClB,qBAAqB;YACrB,kBAAkB;YAClB,oBAAoB;YACpB,oBAAoB;YACpB,mCAAmC;YACnC,qCAAqC;YACrC,gCAAgC;YAChC,0BAA0B;YAC1B,wBAAwB;YACxB,cAAc;YACd,kBAAkB;YAClB,oBAAoB;YACpB,oBAAoB;SACrB,CAAA;QAED,IAAI,UAAU,GAAG,CAAC,CAAA;QAClB,MAAM,YAAY,GAAa,EAAE,CAAA;QAEjC,MAAM,iBAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAA;QAE9E,KAAK,MAAM,OAAO,IAAI,iBAAiB,EAAE,CAAC;YACxC,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAA;YAE9D,KAAK,MAAM,OAAO,IAAI,mBAAmB,EAAE,CAAC;gBAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;gBACtC,IAAI,OAAO,EAAE,CAAC;oBACZ,UAAU,EAAE,CAAA;oBACZ,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;gBAC/B,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,KAAK,EAAE,UAAU;YACjB,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;SAC3C,CAAA;IACH,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,OAAsB;QAC/C,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACxC,OAAO,OAAO,CAAC,OAAO,CAAA;QACxB,CAAC;QAED,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACzB,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAA;QAC7B,CAAC;QAED,OAAO,EAAE,CAAA;IACX,CAAC;IAED;;OAEG;IACK,uBAAuB,CAC7B,eAAuB,EACvB,cAAsB,EACtB,cAAsB,EACtB,YAAqB,EACrB,gBAAyB;QAEzB,MAAM,IAAI,GAAa,EAAE,CAAA;QAEzB,MAAM,gBAAgB,GAAG,eAAe,GAAG,EAAE,IAAI,cAAc,GAAG,EAAE,IAAI,cAAc,GAAG,EAAE,CAAA;QAE3F,mCAAmC;QACnC,IAAI,gBAAgB,IAAI,cAAc,GAAG,EAAE,EAAE,CAAC;YAC5C,IAAI,CAAC,YAAY,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACvC,IAAI,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAA;gBAC/E,IAAI,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAA;YAC7E,CAAC;iBAAM,IAAI,CAAC,YAAY,EAAE,CAAC;gBACzB,IAAI,CAAC,IAAI,CAAC,4EAA4E,CAAC,CAAA;YACzF,CAAC;iBAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBAC7B,IAAI,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAA;YAC5F,CAAC;QACH,CAAC;QAED,kCAAkC;QAClC,IAAI,eAAe,GAAG,EAAE,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CACP,4FAA4F,CAC7F,CAAA;YACD,IAAI,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAA;QACxE,CAAC;QAED,IAAI,cAAc,GAAG,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,IAAI,CACP,gGAAgG,CACjG,CAAA;QACH,CAAC;QAED,yBAAyB;QACzB,IACE,YAAY;YACZ,gBAAgB;YAChB,eAAe,GAAG,EAAE;YACpB,cAAc,IAAI,CAAC;YACnB,cAAc,GAAG,EAAE,EACnB,CAAC;YACD,IAAI,CAAC,IAAI,CACP,4FAA4F,CAC7F,CAAA;QACH,CAAC;aAAM,IAAI,CAAC,YAAY,IAAI,gBAAgB,CAAC,IAAI,eAAe,GAAG,EAAE,IAAI,cAAc,GAAG,EAAE,EAAE,CAAC;YAC7F,IAAI,CAAC,IAAI,CACP,uFAAuF,CACxF,CAAA;QACH,CAAC;aAAM,IAAI,eAAe,GAAG,EAAE,IAAI,cAAc,IAAI,CAAC,IAAI,cAAc,GAAG,EAAE,EAAE,CAAC;YAC9E,IAAI,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAA;QACnF,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAxVD,8DAwVC"}

package/dist/cjs/processors/canonical/metrics/usage.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Unified Usage Metrics Processor
+ *
+ * Works for all providers using the canonical format.
+ * Measures Read/Write ratio and input clarity.
+ */
+import type { UsageMetrics } from '@guidemode/types';
+import type { ParsedSession } from '../../../parsers/base/types.js';
+import { BaseMetricProcessor } from '../../base/metric-processor.js';
+export declare class CanonicalUsageProcessor extends BaseMetricProcessor {
+    readonly name = "canonical-usage";
+    readonly metricType: "usage";
+    readonly description = "Measures Read/Write ratio and input clarity (unified for all providers)";
+    process(session: ParsedSession): Promise<UsageMetrics>;
+    /**
+     * Extract tool uses from session
+     */
+    private extractToolUses;
+    /**
+     * Extract tool results from session
+     */
+    private extractToolResults;
+    /**
+     * Calculate input clarity score based on technical content
+     */
+    private calculateInputClarityScore;
+    /**
+     * Extract text content from message
+     */
+    private extractTextContent;
+    /**
+     * Count technical keywords in content
+     */
+    private countTechnicalTerms;
+    /**
+     * Count code snippets in content
+     */
+    private countCodeSnippets;
+    /**
+     * Count file references in content
+     */
+    private countFileReferences;
+    /**
+     * Count specificity markers: line numbers, function names, concrete examples
+     */
+    private countSpecificityMarkers;
+    /**
+     * Count @ file references (e.g., @src/file.ts, @components/Button.tsx)
+     */
+    private countAtReferences;
+    /**
+     * Count image attachments in message
+     */
+    private countImageAttachments;
+    /**
+     * Calculate total lines read from tool results
+     */
+    private calculateLinesRead;
+    /**
+     * Generate improvement tips
+     */
+    private generateImprovementTips;
+}
+//# sourceMappingURL=usage.d.ts.map

package/dist/cjs/processors/canonical/metrics/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../../../src/processors/canonical/metrics/usage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAqC,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEvF,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAClF,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AAEpE,qBAAa,uBAAwB,SAAQ,mBAAmB;IAC9D,QAAQ,CAAC,IAAI,qBAAoB;IACjC,QAAQ,CAAC,UAAU,EAAG,OAAO,CAAS;IACtC,QAAQ,CAAC,WAAW,6EAA4E;IAE1F,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAsC5D;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAmClC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAuF3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAU3B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA6B/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAyB7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA2B1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAyBhC"}