npm - claude-cli-analytics - Versions diffs - 0.0.1 → 0.0.4 - Mend

claude-cli-analytics 0.0.1 → 0.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/README.md +148 -60
package/bin/cli.cjs +168 -0
package/bin/sanity.mjs +3 -0
package/dist/client/assets/index-Cb1zGdUJ.js +48 -0
package/dist/client/index.html +1 -1
package/dist/server/analyzer.js +175 -12
package/package.json +2 -2
package/bin/cli.js +0 -44
package/dist/client/assets/index-CXwfzzf8.js +0 -48

package/dist/client/index.html CHANGED Viewed

@@ -5,7 +5,7 @@
     <link rel="icon" type="image/svg+xml" href="/vite.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>claude-analytics</title>
-    <script type="module" crossorigin src="/assets/index-CXwfzzf8.js"></script>
+    <script type="module" crossorigin src="/assets/index-Cb1zGdUJ.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-BkOIudNK.css">
   </head>
   <body>

package/dist/server/analyzer.js CHANGED Viewed

@@ -125,7 +125,7 @@ export function getSessionsList(projectsDir, projectPath, startDate, endDate) {
             let postSpecReadTotal = 0, postSpecReadErrors = 0;
             let recordIndex = 0;
             let toolResultCount = 0, toolErrorCount = 0;
-            let humanTurns = 0, autoTurns = 0;
+            let humanTurns = 0, autoTurns = 0, commandTurns = 0;
             for (const record of records) {
                 if (record.type === 'assistant' && record.message?.usage) {
                     const usage = record.message.usage;
@@ -179,8 +179,7 @@ export function getSessionsList(projectsDir, projectPath, startDate, endDate) {
                     if (fp.includes('.claude/') || fp.includes('CLAUDE.md'))
                         specFilesRead.push(fp);
                 }
-                // Human vs auto turn detection
-                // Human vs auto turn detection
+                // Human vs auto vs command turn detection
                 if (record.type === 'user') {
                     const hasTUR = !!record.toolUseResult;
                     const isMeta = !!record.isMeta;
@@ -192,15 +191,29 @@ export function getSessionsList(projectsDir, projectPath, startDate, endDate) {
                         // skip
                     }
                     else if (typeof msgContent === 'string' && msgContent.trim().length > 0) {
-                        humanTurns++;
+                        const raw = msgContent.trim();
+                        // Slash commands (/feature, /init, etc.) are skill triggers, not user interventions
+                        if (raw.includes('<command-name>') || raw.startsWith('This session is being continued')) {
+                            commandTurns++;
+                        }
+                        else if (raw.startsWith('<local-command-stdout>') || raw.startsWith('<local-command-caveat>')) {
+                            autoTurns++;
+                        }
+                        else {
+                            humanTurns++;
+                        }
                     }
                     else if (Array.isArray(msgContent)) {
-                        const hasText = msgContent.some(b => b.type === 'text' && b.text?.trim().length);
-                        const hasOnlyToolResults = msgContent.every(b => b.type === 'tool_result');
-                        if (hasOnlyToolResults)
+                        const hasToolResults = msgContent.some(b => b.type === 'tool_result');
+                        // Tool results (even with contextual text) are automatic, not user interventions
+                        if (hasToolResults) {
                             autoTurns++;
-                        else if (hasText)
-                            humanTurns++;
+                        }
+                        else {
+                            const hasText = msgContent.some(b => b.type === 'text' && b.text?.trim().length);
+                            if (hasText)
+                                humanTurns++;
+                        }
                     }
                 }
                 recordIndex++;
@@ -238,6 +251,47 @@ export function getSessionsList(projectsDir, projectPath, startDate, endDate) {
                     durationMinutes = 0;
             }
             const specCount = new Set(specFilesRead).size;
+            const specTriggerRate = specCount > 0 ? 100 : 0;
+            // Command turns are skill triggers (automatic), include them in auto side for autonomy calculation
+            const effectiveAutoTurns = autoTurns + commandTurns;
+            const autonomyRate = (effectiveAutoTurns + humanTurns) > 0
+                ? Math.round((effectiveAutoTurns / (effectiveAutoTurns + humanTurns)) * 1000) / 10 : 0;
+            const totalToolCalls = readCount + editCount;
+            const anthropicMetrics = {
+                skill_trigger: {
+                    cache_hit_rate: Math.round(cacheHitRate * 10) / 10,
+                    spec_trigger_rate: specTriggerRate,
+                    danger_level: dangerLevel,
+                    limit_impact: limitImpact,
+                },
+                tool_efficiency: {
+                    read_edit_ratio: readEditRatio,
+                    tokens_per_edit: tokensPerEdit,
+                    duplicate_read_rate: duplicateReadRate,
+                    repeated_edit_rate: repeatedEditRate,
+                    total_tool_calls: totalToolCalls,
+                },
+                api_reliability: {
+                    tool_error_rate: toolErrorRate,
+                    tool_error_count: toolErrorCount,
+                    session_exit: sessionExit,
+                },
+                user_intervention: {
+                    human_turns: humanTurns,
+                    auto_turns: effectiveAutoTurns,
+                    autonomy_rate: autonomyRate,
+                    ht_per_edit: editCount > 0 ? Math.round((humanTurns / editCount) * 10) / 10 : 0,
+                },
+                workflow_autonomy: {
+                    repeated_edit_rate: repeatedEditRate,
+                    efficiency_score: efficiencyScore,
+                    sei,
+                },
+                session_consistency: {
+                    grade: grade.letter,
+                    grade_breakdown: grade.breakdown,
+                },
+            };
             sessions.push({
                 session_id: file.replace('.jsonl', ''),
                 project: project.name,
@@ -262,10 +316,12 @@ export function getSessionsList(projectsDir, projectPath, startDate, endDate) {
                 spec_files_count: specCount,
                 has_spec_context: specCount > 0,
                 human_turns: humanTurns,
-                auto_turns: autoTurns,
+                auto_turns: effectiveAutoTurns,
+                command_turns: commandTurns,
                 human_turns_per_edit: editCount > 0 ? Math.round((humanTurns / editCount) * 10) / 10 : 0,
                 spec_efficiency: sei,
-                grade_breakdown: grade.breakdown
+                grade_breakdown: grade.breakdown,
+                anthropic_metrics: anthropicMetrics,
             });
         }
     }
@@ -323,6 +379,8 @@ export function getSessionDetail(projectsDir, sessionId, projectPath) {
     let recordIndex = 0;
     const toolIdMap = new Map();
     const errorMap = new Map();
+    // Track pending questions from interactive tools (AskFollowupQuestion etc.)
+    const pendingQuestions = new Map();
     // Track which files were read by the assistant via tool_use
     // so we can deduplicate them from user's "context load" display
     let lastAssistantReadFiles = new Set();
@@ -391,6 +449,18 @@ export function getSessionDetail(projectsDir, sessionId, projectPath) {
                 for (const block of msgContent) {
                     if (block?.type === 'tool_result') {
                         toolResultCount++;
+                        // Link answer back to pending interactive tool question
+                        const resultToolId = block.tool_use_id;
+                        if (resultToolId && pendingQuestions.has(resultToolId)) {
+                            let answerText = '';
+                            if (typeof block.content === 'string')
+                                answerText = block.content;
+                            else if (Array.isArray(block.content))
+                                answerText = block.content.map(c => c.text || '').join(' ');
+                            const pending = pendingQuestions.get(resultToolId);
+                            pending.answer = answerText || undefined;
+                            pendingQuestions.delete(resultToolId);
+                        }
                         if (block.is_error) {
                             toolErrorCount++;
                             if (firstSpecReadIndex !== -1 && recordIndex > firstSpecReadIndex)
@@ -507,6 +577,36 @@ export function getSessionDetail(projectsDir, sessionId, projectPath) {
                         else if (nameLower === 'tasklist') {
                             detail = '';
                         }
+                        else if (nameLower.includes('ask') || nameLower.includes('question') || nameLower.includes('followup') || nameLower === 'attempt_completion') {
+                            // Interactive tools: capture the question/message
+                            // AskUserQuestion format: input.questions[{question, header, options[{label, description}]}]
+                            let question = '';
+                            const questions = input.questions;
+                            if (Array.isArray(questions) && questions.length > 0) {
+                                const parts = [];
+                                for (const q of questions) {
+                                    let qText = '';
+                                    if (q.header)
+                                        qText += `[${q.header}] `;
+                                    if (q.question)
+                                        qText += q.question;
+                                    if (q.options && q.options.length > 0) {
+                                        qText += '\n' + q.options.map((o, idx) => `  ${idx + 1}. ${o.label || ''}${o.description ? ` - ${o.description}` : ''}`).join('\n');
+                                    }
+                                    parts.push(qText);
+                                }
+                                question = parts.join('\n\n');
+                            }
+                            else {
+                                question = input.question || input.message || input.result || input.text || '';
+                            }
+                            detail = question.length > 100 ? question.substring(0, 100) + '...' : question;
+                            const toolEntry = { name: toolName, detail: detail || undefined, question: question || undefined };
+                            toolUses.push(toolEntry);
+                            if (toolId)
+                                pendingQuestions.set(toolId, toolEntry);
+                            continue; // skip the generic push below
+                        }
                         else {
                             detail = input.file_path || input.filePath || input.command || input.description || '';
                             if (nameLower.includes('read') || nameLower.includes('view') || nameLower.includes('grep') || nameLower.includes('glob') || nameLower.includes('list')) {
@@ -620,7 +720,53 @@ export function getSessionDetail(projectsDir, sessionId, projectPath) {
             },
             spec_efficiency: sei,
             grade_breakdown: grade.breakdown
-        }
+        },
+        anthropic_metrics: (() => {
+            const humanTurns = messages.filter(m => m.type === 'user' && m.subtype === 'human').length;
+            const commandTurnsDetail = messages.filter(m => m.type === 'user' && (m.subtype === 'command' || m.subtype === 'continuation')).length;
+            const autoTurns = messages.filter(m => m.type === 'user' && (m.subtype === 'tool_result' || m.subtype === '')).length + commandTurnsDetail;
+            const autonomyRate = (autoTurns + humanTurns) > 0
+                ? Math.round((autoTurns / (autoTurns + humanTurns)) * 1000) / 10 : 0;
+            const specFilesInSession = allReadFiles.filter(f => f.includes('.claude/') || f.includes('CLAUDE.md'));
+            const specTriggerRate = specFilesInSession.length > 0 ? 100 : 0;
+            const totalToolCalls = readCount + editCount;
+            return {
+                skill_trigger: {
+                    cache_hit_rate: Math.round(cacheHitRate * 10) / 10,
+                    spec_trigger_rate: specTriggerRate,
+                    danger_level: dangerLevel,
+                    limit_impact: limitImpact,
+                },
+                tool_efficiency: {
+                    read_edit_ratio: readEditRatio,
+                    tokens_per_edit: tokensPerEdit,
+                    duplicate_read_rate: duplicateReadRate,
+                    repeated_edit_rate: repeatedEditRate,
+                    total_tool_calls: totalToolCalls,
+                },
+                api_reliability: {
+                    tool_error_rate: Math.round(toolErrorRate * 10) / 10,
+                    tool_error_count: toolErrorCount,
+                    session_exit: sessionExit,
+                    error_details: errorDetails,
+                },
+                user_intervention: {
+                    human_turns: humanTurns,
+                    auto_turns: autoTurns,
+                    autonomy_rate: autonomyRate,
+                    ht_per_edit: editCount > 0 ? Math.round((humanTurns / editCount) * 10) / 10 : 0,
+                },
+                workflow_autonomy: {
+                    repeated_edit_rate: repeatedEditRate,
+                    efficiency_score: Math.round(efficiencyScore),
+                    sei,
+                },
+                session_consistency: {
+                    grade: grade.letter,
+                    grade_breakdown: grade.breakdown,
+                },
+            };
+        })(),
     };
 }
 /**
@@ -703,6 +849,23 @@ export function getAnalytics(projectsDir, projectPath, startDate, endDate) {
                 avg_duration_without_spec: avg(withoutSpec, s => s.duration_minutes),
                 sessions_with_spec: withSpec.length,
                 sessions_without_spec: withoutSpec.length
+            },
+            anthropic_aggregate: {
+                avg_skill_trigger_rate: sessions.length > 0
+                    ? Math.round(sessions.reduce((sum, s) => sum + s.anthropic_metrics.skill_trigger.cache_hit_rate, 0) / sessions.length * 10) / 10 : 0,
+                avg_spec_trigger_rate: sessions.length > 0
+                    ? Math.round(sessions.filter(s => s.has_spec_context).length / sessions.length * 1000) / 10 : 0,
+                avg_tool_calls_per_session: sessions.length > 0
+                    ? Math.round(sessions.reduce((sum, s) => sum + s.anthropic_metrics.tool_efficiency.total_tool_calls, 0) / sessions.length * 10) / 10 : 0,
+                total_tool_errors: sessions.reduce((sum, s) => sum + s.anthropic_metrics.api_reliability.tool_error_count, 0),
+                avg_autonomy_rate: sessions.length > 0
+                    ? Math.round(sessions.reduce((sum, s) => sum + s.anthropic_metrics.user_intervention.autonomy_rate, 0) / sessions.length * 10) / 10 : 0,
+                avg_ht_per_edit: sessions.length > 0
+                    ? Math.round(sessions.reduce((sum, s) => sum + s.anthropic_metrics.user_intervention.ht_per_edit, 0) / sessions.length * 10) / 10 : 0,
+                workflow_completion_rate: sessions.length > 0
+                    ? Math.round(sessions.filter(s => s.anthropic_metrics.workflow_autonomy.efficiency_score >= 60).length / sessions.length * 1000) / 10 : 0,
+                grade_consistency: sessions.length > 0
+                    ? Math.round(sessions.filter(s => s.anthropic_metrics.session_consistency.grade === 'S' || s.anthropic_metrics.session_consistency.grade === 'A').length / sessions.length * 1000) / 10 : 0,
             }
         },
         projects,

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "claude-cli-analytics",
-  "version": "0.0.1",
+  "version": "0.0.4",
   "description": "Claude CLI Analytics Dashboard - Efficiency insights for Claude Pro users",
   "keywords": [
     "claude",
@@ -25,7 +25,7 @@
   "main": "dist/server/index.js",
   "type": "module",
   "bin": {
-    "claude-cli-analytics": "./bin/cli.js"
+    "claude-cli-analytics": "./bin/cli.cjs"
   },
   "files": [
     "dist",

package/bin/cli.js DELETED Viewed

@@ -1,44 +0,0 @@
-#!/usr/bin/env node
-// ── Claude Analytics CLI ──
-// Supports: --port <number>, --path <dir>, --help
-const args = process.argv.slice(2);
-// Handle --help
-if (args.includes('--help') || args.includes('-h')) {
-    console.log(`
-  Claude Analytics Dashboard
-  Usage: claude-cli-analytics [options]
-  Options:
-    --port <number>   Server port (default: 3001)
-    --path <dir>      Claude projects directory (overrides auto-detection)
-    --help, -h        Show this help message
-  Auto-detection:
-    Automatically finds Claude Code data at ~/.claude/projects
-    Works with all installation methods (homebrew, npm, direct install)
-  Environment variables:
-    CLAUDE_PROJECTS_DIR   Override projects directory path
-    PORT                  Override server port
-`);
-    process.exit(0);
-}
-// Parse --port
-const portIdx = args.indexOf('--port');
-if (portIdx !== -1 && args[portIdx + 1]) {
-    process.env.PORT = args[portIdx + 1];
-}
-// Parse --path
-const pathIdx = args.indexOf('--path');
-if (pathIdx !== -1 && args[pathIdx + 1]) {
-    process.env.CLAUDE_PROJECTS_DIR = args[pathIdx + 1];
-}
-// Start the server
-import('../dist/server/index.js');