@aci-metrics/score 0.0.1

package/aci-score.js

@@ -0,0 +1,861 @@
+#!/usr/bin/env node
+/**
+ * aci-score.js
+ *
+ * ACI Local Scorer - Tier 1
+ * Analyzes Claude Code transcripts and generates an ACI score preview.
+ *
+ * Usage:
+ *   node aci-score.js [project-path]
+ *   node aci-score.js ~/.claude/projects/my-project/
+ *   node aci-score.js   (scans default ~/.claude/projects/)
+ *
+ * Milestone 1: Deterministic analysis only (no AI inference)
+ */
+
+var fs = require('fs');
+var path = require('path');
+var os = require('os');
+var zlib = require('zlib');
+var readline = require('readline');
+
+// ============================================================================
+// CONFIGURATION
+// ============================================================================
+
+var DEFAULT_CLAUDE_PATH = path.join(os.homedir(), '.claude', 'projects');
+
+// ============================================================================
+// SECRET SCRUBBING (from clean-transcripts.js)
+// ============================================================================
+
+var SECRET_PATTERNS = [
+    { name: 'OpenAI API Key', pattern: /sk-[a-zA-Z0-9]{32,}/g },
+    { name: 'Anthropic API Key', pattern: /sk-ant-[a-zA-Z0-9\-_]{32,}/g },
+    { name: 'GitHub Token', pattern: /gh[pousr]_[a-zA-Z0-9]{36,}/g },
+    { name: 'GitHub Fine-Grained Token', pattern: /github_pat_[a-zA-Z0-9]{22}_[a-zA-Z0-9]{59}/g },
+    { name: 'AWS Access Key', pattern: /AKIA[A-Z0-9]{16}/g },
+    { name: 'AWS Secret Key', pattern: /(?:aws_secret_access_key|secret_access_key|aws_secret)[\s]*[=:][\s]*["']?([A-Za-z0-9\/+=]{40})["']?/gi },
+    { name: 'Google API Key', pattern: /AIza[a-zA-Z0-9\-_]{35}/g },
+    { name: 'Slack Token', pattern: /xox[baprs]-[a-zA-Z0-9\-]{10,}/g },
+    { name: 'Stripe Key', pattern: /sk_live_[a-zA-Z0-9]{24,}/g },
+    { name: 'Private Key', pattern: /-----BEGIN\s+(?:RSA\s+)?PRIVATE\s+KEY-----[\s\S]*?-----END\s+(?:RSA\s+)?PRIVATE\s+KEY-----/g },
+    { name: 'Bearer Token', pattern: /Bearer\s+[a-zA-Z0-9\-_\.]{20,}/gi },
+    { name: 'JWT Token', pattern: /eyJ[a-zA-Z0-9\-_]+\.eyJ[a-zA-Z0-9\-_]+\.[a-zA-Z0-9\-_]+/g },
+    { name: 'DB Connection String', pattern: /(?:mongodb|postgres|mysql|redis):\/\/[^:]+:[^@]+@[^\s]+/gi },
+];
+
+function scrubSecrets(text) {
+    if (typeof text !== 'string') return { text: text, count: 0 };
+    var count = 0;
+    var scrubbed = text;
+    for (var i = 0; i < SECRET_PATTERNS.length; i++) {
+        SECRET_PATTERNS[i].pattern.lastIndex = 0;
+        var matches = scrubbed.match(SECRET_PATTERNS[i].pattern);
+        if (matches) {
+            count += matches.length;
+            scrubbed = scrubbed.replace(SECRET_PATTERNS[i].pattern, '[REDACTED]');
+        }
+    }
+    return { text: scrubbed, count: count };
+}
+
+// ============================================================================
+// CLI OUTPUT HELPERS
+// ============================================================================
+
+var COLORS = {
+    reset: '\x1b[0m',
+    bright: '\x1b[1m',
+    dim: '\x1b[2m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    cyan: '\x1b[36m',
+    white: '\x1b[37m',
+};
+
+function log(msg) {
+    console.log(msg);
+}
+
+function status(msg) {
+    process.stdout.write(COLORS.cyan + '  → ' + COLORS.reset + msg + '\n');
+}
+
+function success(msg) {
+    process.stdout.write(COLORS.green + '  ✓ ' + COLORS.reset + msg + '\n');
+}
+
+function warn(msg) {
+    process.stdout.write(COLORS.yellow + '  ⚠ ' + COLORS.reset + msg + '\n');
+}
+
+function header(msg) {
+    log('');
+    log(COLORS.bright + msg + COLORS.reset);
+}
+
+// ============================================================================
+// USER INPUT PROMPTS
+// ============================================================================
+
+function askQuestion(question) {
+    var rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+    });
+
+    return new Promise(function(resolve) {
+        rl.question(question, function(answer) {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+
+function getTranscriptModTime(filepath) {
+    try {
+        var stat = fs.statSync(filepath);
+        return stat.mtime;
+    } catch (e) {
+        return new Date(0);
+    }
+}
+
+function filterTranscriptsBySelection(transcriptFiles, selection) {
+    // Sort by modification time (newest first)
+    var sorted = transcriptFiles.slice().sort(function(a, b) {
+        return getTranscriptModTime(b) - getTranscriptModTime(a);
+    });
+
+    switch (selection) {
+        case '1':
+            // All transcripts
+            return sorted;
+
+        case '2':
+            // Last 20
+            return sorted.slice(0, 20);
+
+        case '3':
+            // Last week
+            var oneWeekAgo = new Date();
+            oneWeekAgo.setDate(oneWeekAgo.getDate() - 7);
+            return sorted.filter(function(f) {
+                return getTranscriptModTime(f) >= oneWeekAgo;
+            });
+
+        case '4':
+            // Custom range - for now, same as all (will prompt separately)
+            return sorted;
+
+        default:
+            return sorted;
+    }
+}
+
+// ============================================================================
+// REPORT-ID GENERATION
+// ============================================================================
+
+function generateReportId() {
+    var chars = 'ABCDEFGHJKLMNPQRSTUVWXYZabcdefghjkmnpqrstuvwxyz23456789';
+    var segments = [];
+    for (var s = 0; s < 6; s++) {
+        var segment = '';
+        for (var c = 0; c < 4; c++) {
+            segment += chars.charAt(Math.floor(Math.random() * chars.length));
+        }
+        segments.push(segment);
+    }
+    return segments.join('-');
+}
+
+// ============================================================================
+// TRANSCRIPT DISCOVERY
+// ============================================================================
+
+function findProjects(basePath) {
+    var projects = [];
+
+    if (!fs.existsSync(basePath)) {
+        return projects;
+    }
+
+    var entries = fs.readdirSync(basePath);
+
+    for (var i = 0; i < entries.length; i++) {
+        var entry = entries[i];
+        var entryPath = path.join(basePath, entry);
+        var stat = fs.statSync(entryPath);
+
+        if (stat.isDirectory()) {
+            // Check for JSONL files in this directory
+            var files = fs.readdirSync(entryPath);
+            var jsonlFiles = files.filter(function(f) {
+                return f.endsWith('.jsonl');
+            });
+
+            if (jsonlFiles.length > 0) {
+                projects.push({
+                    name: entry,
+                    path: entryPath,
+                    files: jsonlFiles.map(function(f) {
+                        return path.join(entryPath, f);
+                    })
+                });
+            }
+        }
+    }
+
+    return projects;
+}
+
+function findTranscripts(inputPath) {
+    var stat;
+    try {
+        stat = fs.statSync(inputPath);
+    } catch (e) {
+        return [];
+    }
+
+    if (stat.isDirectory()) {
+        // Check if it's a project directory with JSONL files
+        var files = fs.readdirSync(inputPath);
+        var jsonlFiles = files.filter(function(f) {
+            return f.endsWith('.jsonl');
+        });
+
+        if (jsonlFiles.length > 0) {
+            return jsonlFiles.map(function(f) {
+                return path.join(inputPath, f);
+            });
+        }
+
+        // Otherwise, treat it as ~/.claude/projects/ and find all projects
+        var projects = findProjects(inputPath);
+        var allFiles = [];
+        for (var i = 0; i < projects.length; i++) {
+            allFiles = allFiles.concat(projects[i].files);
+        }
+        return allFiles;
+    } else if (inputPath.endsWith('.jsonl')) {
+        return [inputPath];
+    }
+
+    return [];
+}
+
+// ============================================================================
+// TRANSCRIPT PARSING
+// ============================================================================
+
+function parseTranscript(filepath) {
+    var messages = [];
+    var content = fs.readFileSync(filepath, 'utf8');
+    var lines = content.split('\n');
+    var secretsFound = 0;
+
+    for (var i = 0; i < lines.length; i++) {
+        var line = lines[i].trim();
+        if (!line) continue;
+
+        try {
+            var raw = JSON.parse(line);
+            var msg = {
+                type: raw.type || raw.role || 'unknown',
+                ts: raw.ts || raw.timestamp || raw.created_at || null,
+                contentLength: 0
+            };
+
+            // Calculate content length (for metrics)
+            var contentStr = '';
+            if (typeof raw.content === 'string') {
+                contentStr = raw.content;
+            } else if (raw.content) {
+                contentStr = JSON.stringify(raw.content);
+            } else if (raw.message) {
+                contentStr = typeof raw.message === 'string' ? raw.message : JSON.stringify(raw.message);
+            }
+
+            var scrubResult = scrubSecrets(contentStr);
+            secretsFound += scrubResult.count;
+            msg.contentLength = scrubResult.text.length;
+
+            if (msg.ts) {
+                messages.push(msg);
+            }
+        } catch (e) {
+            // Skip malformed lines
+        }
+    }
+
+    return { messages: messages, secretsFound: secretsFound };
+}
+
+// ============================================================================
+// METRICS CALCULATION (Deterministic Layer)
+// ============================================================================
+
+function calculateMetrics(transcriptFiles) {
+    var allMessages = [];
+    var totalSecretsFound = 0;
+    var sessionCount = transcriptFiles.length;
+
+    for (var i = 0; i < transcriptFiles.length; i++) {
+        var result = parseTranscript(transcriptFiles[i]);
+        allMessages = allMessages.concat(result.messages);
+        totalSecretsFound += result.secretsFound;
+    }
+
+    // Sort by timestamp
+    allMessages.sort(function(a, b) {
+        return new Date(a.ts) - new Date(b.ts);
+    });
+
+    // Calculate basic metrics
+    var userMessages = allMessages.filter(function(m) {
+        return m.type === 'user' || m.type === 'human';
+    });
+    var assistantMessages = allMessages.filter(function(m) {
+        return m.type === 'assistant' || m.type === 'ai';
+    });
+
+    // Time range
+    var firstTs = allMessages.length > 0 ? new Date(allMessages[0].ts) : null;
+    var lastTs = allMessages.length > 0 ? new Date(allMessages[allMessages.length - 1].ts) : null;
+
+    // Calculate total activity duration (rough estimate based on session gaps)
+    var totalActivityMinutes = 0;
+    if (allMessages.length > 1) {
+        var prevTs = firstTs;
+        for (var i = 1; i < allMessages.length; i++) {
+            var currTs = new Date(allMessages[i].ts);
+            var gapMinutes = (currTs - prevTs) / 1000 / 60;
+            // Only count gaps under 30 minutes as "active"
+            if (gapMinutes < 30) {
+                totalActivityMinutes += gapMinutes;
+            }
+            prevTs = currTs;
+        }
+    }
+
+    // Token estimation (rough: 4 chars per token)
+    var totalChars = allMessages.reduce(function(sum, m) {
+        return sum + m.contentLength;
+    }, 0);
+    var estimatedTokens = Math.round(totalChars / 4);
+
+    return {
+        sessionCount: sessionCount,
+        promptCount: userMessages.length,
+        responseCount: assistantMessages.length,
+        totalMessages: allMessages.length,
+        firstTimestamp: firstTs,
+        lastTimestamp: lastTs,
+        activityHours: Math.round(totalActivityMinutes / 60 * 10) / 10,
+        estimatedTokens: estimatedTokens,
+        secretsRedacted: totalSecretsFound
+    };
+}
+
+// ============================================================================
+// SUBMISSION FILE CREATION (gzipped JSON)
+// ============================================================================
+
+function createSubmissionFile(reportId, metrics, transcriptFiles, outputDir) {
+    // Parse all transcripts and collect sessions
+    var sessions = [];
+    var totalSecretsRedacted = 0;
+    var mergedToolCounts = {};
+
+    for (var i = 0; i < transcriptFiles.length; i++) {
+        var filepath = transcriptFiles[i];
+        var parsed = parseTranscriptForSubmission(filepath);
+
+        sessions.push(parsed.session);
+        totalSecretsRedacted += parsed.secretsRedacted;
+
+        // Merge tool counts
+        for (var tool in parsed.toolCounts) {
+            mergedToolCounts[tool] = (mergedToolCounts[tool] || 0) + parsed.toolCounts[tool];
+        }
+    }
+
+    // Calculate aggregate token metrics from sessions
+    var totalTokensIn = 0;
+    var totalTokensOut = 0;
+    var totalCacheRead = 0;
+    var promptCount = 0;
+    var responseCount = 0;
+
+    for (var i = 0; i < sessions.length; i++) {
+        var session = sessions[i];
+        for (var j = 0; j < session.messages.length; j++) {
+            var msg = session.messages[j];
+            if (msg.role === 'user') {
+                promptCount++;
+            } else if (msg.role === 'assistant') {
+                responseCount++;
+                if (msg.tokens) {
+                    totalTokensIn += msg.tokens.in || 0;
+                    totalTokensOut += msg.tokens.out || 0;
+                    totalCacheRead += msg.tokens.cacheRead || 0;
+                }
+            }
+        }
+    }
+
+    // Build submission payload
+    var submission = {
+        reportId: reportId,
+        version: '1.0.0',
+        generatedAt: new Date().toISOString(),
+
+        sessions: sessions,
+
+        metrics: {
+            sessionCount: sessions.length,
+            promptCount: promptCount,
+            responseCount: responseCount,
+            totalTokensIn: totalTokensIn,
+            totalTokensOut: totalTokensOut,
+            totalCacheRead: totalCacheRead,
+            toolCounts: mergedToolCounts,
+            activityMinutes: metrics.activityHours * 60,
+            secretsRedacted: totalSecretsRedacted,
+            firstTimestamp: metrics.firstTimestamp ? metrics.firstTimestamp.toISOString() : null,
+            lastTimestamp: metrics.lastTimestamp ? metrics.lastTimestamp.toISOString() : null
+        }
+    };
+
+    // Convert to JSON (pretty-printed) and compress with gzip
+    var jsonData = JSON.stringify(submission, null, 2);
+    var compressed = zlib.gzipSync(Buffer.from(jsonData, 'utf8'));
+
+    // Write compressed file
+    var outputPath = path.join(outputDir, reportId + '.aci.gz');
+    fs.writeFileSync(outputPath, compressed);
+
+    // Return path and stats
+    return {
+        path: outputPath,
+        uncompressedSize: jsonData.length,
+        compressedSize: compressed.length,
+        secretsRedacted: totalSecretsRedacted
+    };
+}
+
+/**
+ * Recursively scrub secrets from content (handles strings, arrays, objects)
+ */
+function scrubContentDeep(content) {
+    if (typeof content === 'string') {
+        return scrubSecrets(content);
+    }
+    if (Array.isArray(content)) {
+        var totalCount = 0;
+        var scrubbedArray = content.map(function(item) {
+            var result = scrubContentDeep(item);
+            totalCount += result.count;
+            return result.text;
+        });
+        return { text: scrubbedArray, count: totalCount };
+    }
+    if (content && typeof content === 'object') {
+        var totalCount = 0;
+        var scrubbedObj = {};
+        for (var key in content) {
+            if (content.hasOwnProperty(key)) {
+                var result = scrubContentDeep(content[key]);
+                scrubbedObj[key] = result.text;
+                totalCount += result.count;
+            }
+        }
+        return { text: scrubbedObj, count: totalCount };
+    }
+    return { text: content, count: 0 };
+}
+
+/**
+ * Parse a content block (text, thinking, tool_use, tool_result)
+ */
+function parseContentBlock(block, secretsCounter) {
+    if (!block || !block.type) return null;
+
+    if (block.type === 'text') {
+        var scrubbed = scrubSecrets(block.text || '');
+        secretsCounter.count += scrubbed.count;
+        return { type: 'text', text: scrubbed.text };
+    }
+
+    if (block.type === 'thinking') {
+        var scrubbed = scrubSecrets(block.thinking || '');
+        secretsCounter.count += scrubbed.count;
+        return {
+            type: 'thinking',
+            length: (block.thinking || '').length,
+            text: scrubbed.text
+        };
+    }
+
+    if (block.type === 'tool_use') {
+        var scrubbedInput = scrubContentDeep(block.input || {});
+        secretsCounter.count += scrubbedInput.count;
+        return {
+            type: 'tool_use',
+            name: block.name,
+            input: scrubbedInput.text
+        };
+    }
+
+    if (block.type === 'tool_result') {
+        var scrubbedContent = scrubContentDeep(block.content || '');
+        secretsCounter.count += scrubbedContent.count;
+        return {
+            type: 'tool_result',
+            success: !block.is_error,
+            content: scrubbedContent.text
+        };
+    }
+
+    return null;
+}
+
+/**
+ * Parse transcript for submission with full schema
+ */
+function parseTranscriptForSubmission(filepath) {
+    var fileContent = fs.readFileSync(filepath, 'utf8');
+    var lines = fileContent.split('\n');
+    var filename = path.basename(filepath);
+
+    // Session metadata (extracted from first relevant message)
+    var session = {
+        id: null,
+        slug: null,
+        start: null,
+        end: null,
+        cwd: null,
+        branch: null,
+        model: null,
+        clientVersion: null,
+        permissionMode: null,
+        messages: []
+    };
+
+    var secretsCounter = { count: 0 };
+    var lastUserTimestamp = null;
+    var toolCounts = {};
+
+    for (var i = 0; i < lines.length; i++) {
+        var line = lines[i].trim();
+        if (!line) continue;
+
+        try {
+            var raw = JSON.parse(line);
+
+            // Skip noise entries
+            if (raw.type === 'queue-operation' ||
+                raw.type === 'file-history-snapshot' ||
+                raw.type === 'progress') {
+                continue;
+            }
+
+            // Only process user/assistant messages
+            if (raw.type !== 'user' && raw.type !== 'assistant') {
+                continue;
+            }
+
+            var timestamp = raw.timestamp || raw.ts || null;
+            if (!timestamp) continue;
+
+            // Extract session metadata from first message
+            if (!session.id && raw.sessionId) {
+                session.id = raw.sessionId.split('-')[0]; // Short ID
+            }
+            if (!session.slug && raw.slug) {
+                session.slug = raw.slug;
+            }
+            if (!session.cwd && raw.cwd) {
+                session.cwd = raw.cwd;
+            }
+            if (!session.branch && raw.gitBranch) {
+                session.branch = raw.gitBranch;
+            }
+            if (!session.clientVersion && raw.version) {
+                session.clientVersion = raw.version;
+            }
+            if (!session.permissionMode && raw.permissionMode) {
+                session.permissionMode = raw.permissionMode;
+            }
+
+            // Track time range
+            if (!session.start) {
+                session.start = timestamp;
+            }
+            session.end = timestamp;
+
+            // Build message object
+            var msg = {
+                role: raw.type,
+                timestamp: timestamp
+            };
+
+            // For assistant messages, extract model and tokens
+            if (raw.type === 'assistant' && raw.message) {
+                if (!session.model && raw.message.model) {
+                    session.model = raw.message.model;
+                }
+
+                // Calculate response time from last user message
+                if (lastUserTimestamp) {
+                    var responseMs = new Date(timestamp) - new Date(lastUserTimestamp);
+                    msg.responseTime = Math.round(responseMs / 100) / 10; // seconds, 1 decimal
+                }
+
+                // Extract token usage
+                if (raw.message.usage) {
+                    msg.tokens = {
+                        in: raw.message.usage.input_tokens || 0,
+                        out: raw.message.usage.output_tokens || 0
+                    };
+                    if (raw.message.usage.cache_read_input_tokens) {
+                        msg.tokens.cacheRead = raw.message.usage.cache_read_input_tokens;
+                    }
+                }
+            }
+
+            // Track last user timestamp for responseTime calculation
+            if (raw.type === 'user') {
+                lastUserTimestamp = timestamp;
+            }
+
+            // Parse content blocks
+            var contentSource = raw.message ? raw.message.content : null;
+            if (Array.isArray(contentSource)) {
+                msg.content = [];
+                for (var j = 0; j < contentSource.length; j++) {
+                    var parsed = parseContentBlock(contentSource[j], secretsCounter);
+                    if (parsed) {
+                        msg.content.push(parsed);
+
+                        // Track tool usage
+                        if (parsed.type === 'tool_use' && parsed.name) {
+                            toolCounts[parsed.name] = (toolCounts[parsed.name] || 0) + 1;
+                        }
+                    }
+                }
+            }
+
+            session.messages.push(msg);
+
+        } catch (e) {
+            // Skip malformed lines
+        }
+    }
+
+    return {
+        filename: filename,
+        session: session,
+        secretsRedacted: secretsCounter.count,
+        toolCounts: toolCounts
+    };
+}
+
+// ============================================================================
+// CLI REPORT OUTPUT
+// ============================================================================
+
+function formatNumber(n) {
+    if (n >= 1000000000) return (n / 1000000000).toFixed(1) + ' B';
+    if (n >= 1000000) return (n / 1000000).toFixed(1) + ' M';
+    if (n >= 1000) return (n / 1000).toFixed(1) + ' k';
+    return String(n);
+}
+
+function formatBytes(bytes) {
+    if (bytes >= 1073741824) return (bytes / 1073741824).toFixed(1) + ' GB';
+    if (bytes >= 1048576) return (bytes / 1048576).toFixed(1) + ' MB';
+    if (bytes >= 1024) return (bytes / 1024).toFixed(1) + ' KB';
+    return bytes + ' B';
+}
+
+function formatDate(d) {
+    if (!d) return '--';
+    var months = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+    return months[d.getMonth()] + ' ' + d.getDate() + ', ' + d.getFullYear();
+}
+
+function progressBar(value, max, width) {
+    var filled = Math.round((value / max) * width);
+    var empty = width - filled;
+    return '█'.repeat(filled) + '░'.repeat(empty);
+}
+
+function printReport(reportId, metrics) {
+    var line = '═'.repeat(72);
+    var thinLine = '─'.repeat(72);
+
+    log('');
+    log(line);
+    log('   AI COLLABORATION INDEX (ACI) - Estimate');
+    log('');
+    log('   Report-ID: ' + reportId);
+    log('   Generated: ' + formatDate(new Date()));
+    log(line);
+    log('');
+
+    // Placeholder scores (will be calculated by AI layer later)
+    log('  ACI SCORE (estimate)    ' + COLORS.dim + '---   (AI analysis pending)' + COLORS.reset);
+    log('');
+    log('  Velocity                ' + COLORS.dim + '---   ' + progressBar(0, 160, 16) + COLORS.reset);
+    log('  Quality                 ' + COLORS.dim + '---   ' + progressBar(0, 160, 16) + COLORS.reset);
+    log('  Integration             ' + COLORS.dim + '---   ' + progressBar(0, 160, 16) + COLORS.reset);
+    log('  Literacy                ' + COLORS.dim + '---   ' + progressBar(0, 160, 16) + COLORS.reset);
+    log('');
+    log(thinLine);
+    log('  RAW METRICS');
+    log(thinLine);
+    log('');
+
+    var timeRange = formatDate(metrics.firstTimestamp) + ' – ' + formatDate(metrics.lastTimestamp);
+
+    log('  Timerange:              ' + timeRange);
+    log('  Activity:               ' + metrics.activityHours + ' h');
+    log('  Sessions:               ' + metrics.sessionCount);
+    log('  Prompts:                ' + formatNumber(metrics.promptCount));
+    log('  Responses:              ' + formatNumber(metrics.responseCount));
+    log('  Tokens (est):           ' + formatNumber(metrics.estimatedTokens));
+    log('');
+    log('  ' + COLORS.dim + 'Additional metrics require AI analysis' + COLORS.reset);
+    log('');
+    log(thinLine);
+    log('  DETECTED PATTERNS');
+    log(thinLine);
+    log('');
+    log('  ' + COLORS.dim + '(Pending AI analysis)' + COLORS.reset);
+    log('');
+    log(thinLine);
+    log('  TIPS & NEXT-STEPS');
+    log(thinLine);
+    log('');
+    log('  ' + COLORS.dim + '(Pending AI analysis)' + COLORS.reset);
+    log('');
+    log(line);
+    log('  © 2026 ACI Metrics  |  aci-metrics.com/terms');
+    log(line);
+}
+
+// ============================================================================
+// MAIN
+// ============================================================================
+
+async function main() {
+    var inputPath = process.argv[2] || DEFAULT_CLAUDE_PATH;
+
+    log('');
+    log(COLORS.bright + '  ACI Local Scorer v1.0.0' + COLORS.reset);
+    log(COLORS.dim + '  Milestone 1: Deterministic Analysis' + COLORS.reset);
+    log('');
+
+    // Step 1: Find transcripts
+    header('  SCANNING FOR TRANSCRIPTS');
+    status('Looking in: ' + inputPath);
+
+    var allTranscriptFiles = findTranscripts(inputPath);
+
+    if (allTranscriptFiles.length === 0) {
+        warn('No transcript files found');
+        log('');
+        log('  Expected location: ~/.claude/projects/<project-name>/*.jsonl');
+        log('  Or specify a path: node aci-score.js /path/to/transcripts');
+        log('');
+        process.exit(1);
+    }
+
+    success('Found ' + allTranscriptFiles.length + ' transcript file(s)');
+
+    // Step 2: Ask user which transcripts to include
+    log('');
+    log('  ' + COLORS.bright + 'Which transcripts would you like to analyze?' + COLORS.reset);
+    log('');
+    log('    1. All (' + allTranscriptFiles.length + ' files)');
+    log('    2. Last 20 files');
+    log('    3. Last 7 days');
+    log('    4. Custom date range');
+    log('');
+
+    var selection = await askQuestion('  Enter choice (1-4): ');
+
+    // Handle custom date range
+    var transcriptFiles;
+    if (selection === '4') {
+        log('');
+        var daysInput = await askQuestion('  How many days back? ');
+        var days = parseInt(daysInput, 10);
+        if (isNaN(days) || days < 1) {
+            warn('Invalid input, using all transcripts');
+            transcriptFiles = allTranscriptFiles;
+        } else {
+            var cutoffDate = new Date();
+            cutoffDate.setDate(cutoffDate.getDate() - days);
+            transcriptFiles = allTranscriptFiles.slice().sort(function(a, b) {
+                return getTranscriptModTime(b) - getTranscriptModTime(a);
+            }).filter(function(f) {
+                return getTranscriptModTime(f) >= cutoffDate;
+            });
+        }
+    } else {
+        transcriptFiles = filterTranscriptsBySelection(allTranscriptFiles, selection);
+    }
+
+    if (transcriptFiles.length === 0) {
+        warn('No transcripts match the selected criteria');
+        process.exit(1);
+    }
+
+    log('');
+    success('Selected ' + transcriptFiles.length + ' transcript(s) for analysis');
+
+    // Step 3: Parse and calculate metrics
+    header('  ANALYZING TRANSCRIPTS');
+    status('Parsing messages and scrubbing secrets...');
+
+    var metrics = calculateMetrics(transcriptFiles);
+
+    success('Processed ' + metrics.totalMessages + ' messages');
+    if (metrics.secretsRedacted > 0) {
+        warn('Redacted ' + metrics.secretsRedacted + ' potential secret(s)');
+    }
+
+    // Step 4: Generate Report ID
+    header('  GENERATING REPORT');
+    var reportId = generateReportId();
+    status('Report-ID: ' + reportId);
+
+    // Step 5: Create submission file (gzipped)
+    status('Creating compressed submission file...');
+    var outputDir = process.cwd();
+    var submission = createSubmissionFile(reportId, metrics, transcriptFiles, outputDir);
+    var compressionRatio = Math.round((1 - submission.compressedSize / submission.uncompressedSize) * 100);
+    success('Created: ' + path.basename(submission.path) + ' (' + formatBytes(submission.compressedSize) + ', ' + compressionRatio + '% smaller)');
+
+    // Step 6: Print CLI report
+    printReport(reportId, metrics);
+
+    log('');
+    log('  ● Generated submission file: ' + path.basename(submission.path));
+    log('    ' + COLORS.dim + 'Size: ' + formatBytes(submission.compressedSize) + ' (compressed from ' + formatBytes(submission.uncompressedSize) + ')' + COLORS.reset);
+    log('    ' + COLORS.dim + 'Upload to aci-metrics.com for full analysis' + COLORS.reset);
+    log('');
+    log('  ' + COLORS.dim + 'Note: AI-powered scoring requires model setup.' + COLORS.reset);
+    log('  ' + COLORS.dim + 'See: local-scorer/README.md' + COLORS.reset);
+    log('');
+}
+
+main().catch(function(err) {
+    console.error('Error:', err.message);
+    process.exit(1);
+});