claude-roi 0.2.1 → 0.2.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Akshat Sahu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -151,36 +151,7 @@ Codelens-AI/
 
 ## Contributing
 
-Contributions welcome! Here's how to get started:
-
-```bash
-# 1. Fork the repo on GitHub
-
-# 2. Clone your fork
-git clone https://github.com/YOUR_USERNAME/Codelens-AI.git
-cd Codelens-AI
-
-# 3. Install dependencies
-npm install
-
-# 4. Run in dev mode (no auto-open browser)
-node src/index.js --no-open
-
-# 5. Make your changes and test
-node src/index.js --json | head -30   # verify JSON output
-node src/index.js --no-open           # test dashboard at localhost:3457
-
-# 6. Submit a pull request
-```
-
-### Ideas for contributions
-
-- Support for other AI coding tools (Copilot, Cursor, etc.)
-- Git blame-based line survival tracking (more accurate than the 24h heuristic)
-- Export dashboard as PDF/PNG
-- Historical trend tracking across multiple runs
-- Team/multi-user support
-- Custom pricing configuration via CLI flag or config file
+Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, guidelines, and ideas for contributions.
 
 ## Privacy
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-roi",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Correlate Claude Code token usage with git output to measure AI coding agent ROI",
   "type": "module",
   "bin": {
@@ -9,7 +9,8 @@
   "main": "./src/index.js",
   "scripts": {
     "start": "node src/index.js",
-    "dev": "node src/index.js --no-open"
+    "dev": "node src/index.js --no-open",
+    "test": "npx playwright test"
   },
   "keywords": [
     "claude",
@@ -21,17 +22,26 @@
     "git",
     "dashboard"
   ],
+  "author": "Akshat Sahu",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Akshat2634/Codelens-AI.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Akshat2634/Codelens-AI/issues"
+  },
+  "homepage": "https://github.com/Akshat2634/Codelens-AI#readme",
   "engines": {
     "node": ">=18.0.0"
   },
   "dependencies": {
     "commander": "^13.0.0",
     "express": "^5.0.0",
-    "open": "^10.0.0",
-    "playwright": "^1.58.2"
+    "open": "^10.0.0"
   },
   "devDependencies": {
-    "@playwright/test": "^1.56.1"
+    "@playwright/test": "^1.56.1",
+    "playwright": "^1.58.2"
   }
 }

package/src/correlator.js

@@ -14,67 +14,100 @@ function computeOverlappingLines(commits, sessionFiles) {
   return { linesAdded, linesDeleted };
 }
 
+/**
+ * Compute the temporal distance between a commit and a session.
+ * Returns the minimum absolute distance from the commit to the session's
+ * time range (0 if the commit falls within the session window).
+ */
+function temporalDistance(commitMs, sessionStartMs, sessionEndMs) {
+  if (commitMs >= sessionStartMs && commitMs <= sessionEndMs) return 0;
+  return Math.min(
+    Math.abs(commitMs - sessionStartMs),
+    Math.abs(commitMs - sessionEndMs)
+  );
+}
+
 /**
  * Correlate sessions to commits using file-based matching.
  *
+ * Uses a two-pass "nearest session wins" approach:
+ *   1. For each commit, find all candidate sessions (file overlap + time window)
+ *      and assign it to the temporally closest one.
+ *   2. Build correlated results from those assignments.
+ *
  * Primary: match commits whose changed files overlap with session.filesWritten.
- *   Time constraint: commit is on the same calendar day or the next day.
+ *   Time constraint: commit is within [sessionStart, sessionEnd + 2 hours].
  * Fallback: for sessions with no filesWritten (chat-only), use time window
  *   [sessionStart, sessionEnd + 2 hours].
  */
 export function correlateSessions(sessions, commitsByRepo) {
-  const result = [];
-  const claimedCommits = new Set();
-
-  // Sort sessions by end time so earlier sessions claim commits first
-  const sorted = [...sessions].sort(
-    (a, b) => new Date(a.endTime).getTime() - new Date(b.endTime).getTime()
-  );
+  // Phase 1: Build candidate map — for each commit, find the best session
+  // commitHash -> { session, hasFileOverlap }
+  const commitAssignment = new Map();
 
-  for (const session of sorted) {
+  for (const session of sessions) {
     const repoAnalysis = commitsByRepo[session.repoPath];
     const repoCommits = repoAnalysis?.commits || [];
 
-    const sessionStart = new Date(session.startTime).getTime();
-    const sessionEnd = new Date(session.endTime).getTime();
+    const sessionStartMs = new Date(session.startTime).getTime();
+    const sessionEndMs = new Date(session.endTime).getTime();
     const sessionFiles = new Set(session.filesWritten || []);
-
-    let matched;
-
-    if (sessionFiles.size > 0) {
-      // PRIMARY: File-based correlation
-      // Time window: same calendar day as session, or next calendar day
-      const sessionDay = new Date(session.startTime);
-      const dayStart = new Date(sessionDay.getFullYear(), sessionDay.getMonth(), sessionDay.getDate()).getTime();
-      const dayEnd = dayStart + 2 * 24 * 60 * 60 * 1000; // end of next calendar day
-
-      matched = repoCommits.filter(c => {
-        if (claimedCommits.has(c.hash)) return false;
-        if (c.timestampMs < dayStart || c.timestampMs >= dayEnd) return false;
-        // Check file overlap: any commit file matches a session file
-        return c.files.some(f => sessionFiles.has(f.path));
-      });
-    } else {
-      // FALLBACK: Time-based for chat-only sessions (no files written)
-      const windowEnd = sessionEnd + FALLBACK_BUFFER_MS;
-      matched = repoCommits.filter(c =>
-        c.timestampMs >= sessionStart &&
-        c.timestampMs <= windowEnd &&
-        !claimedCommits.has(c.hash)
-      );
+    const windowEnd = sessionEndMs + FALLBACK_BUFFER_MS;
+
+    for (const commit of repoCommits) {
+      // Time constraint: commit must fall within [sessionStart, sessionEnd + 2h]
+      if (commit.timestampMs < sessionStartMs || commit.timestampMs > windowEnd) continue;
+
+      const hasFileOverlap = sessionFiles.size > 0 &&
+        commit.files.some(f => sessionFiles.has(f.path));
+      const isChatOnly = sessionFiles.size === 0;
+
+      // Must have file overlap, or be a chat-only session (time-based fallback)
+      if (!hasFileOverlap && !isChatOnly) continue;
+
+      const distance = temporalDistance(commit.timestampMs, sessionStartMs, sessionEndMs);
+      const existing = commitAssignment.get(commit.hash);
+
+      if (!existing) {
+        commitAssignment.set(commit.hash, { session, hasFileOverlap, distance });
+      } else {
+        // Prefer file-based match over time-only match
+        if (hasFileOverlap && !existing.hasFileOverlap) {
+          commitAssignment.set(commit.hash, { session, hasFileOverlap, distance });
+        } else if (hasFileOverlap === existing.hasFileOverlap && distance < existing.distance) {
+          // Same match type — prefer temporally closer session
+          commitAssignment.set(commit.hash, { session, hasFileOverlap, distance });
+        }
+      }
     }
+  }
 
-    // Claim matched commits
-    for (const c of matched) {
-      claimedCommits.add(c.hash);
+  // Phase 2: Group commits by assigned session
+  const sessionCommits = new Map(); // sessionId -> commit[]
+  for (const [hash, { session }] of commitAssignment) {
+    if (!sessionCommits.has(session.sessionId)) {
+      sessionCommits.set(session.sessionId, []);
+    }
+    // Find the actual commit object from the repo
+    const repoAnalysis = commitsByRepo[session.repoPath];
+    const commit = repoAnalysis?.commits?.find(c => c.hash === hash);
+    if (commit) {
+      sessionCommits.get(session.sessionId).push(commit);
     }
+  }
+
+  // Phase 3: Build correlated results
+  const claimedCommits = new Set(commitAssignment.keys());
+  const result = [];
+
+  for (const session of sessions) {
+    const sessionFiles = new Set(session.filesWritten || []);
+    const matched = sessionCommits.get(session.sessionId) || [];
 
     let linesAdded, linesDeleted;
     if (sessionFiles.size > 0) {
-      // Only count lines from files Claude actually edited
       ({ linesAdded, linesDeleted } = computeOverlappingLines(matched, sessionFiles));
     } else {
-      // Fallback (chat-only): count all lines in matched commits
       linesAdded = matched.reduce((s, c) => s + c.totalAdded, 0);
       linesDeleted = matched.reduce((s, c) => s + c.totalDeleted, 0);
     }
@@ -87,7 +120,6 @@ export function correlateSessions(sessions, commitsByRepo) {
     const messageCount = session.userMessageCount + session.assistantMessageCount;
     const isOrphaned = messageCount > 10 && matched.length === 0;
 
-    // Calculate which session files were committed vs not
     const committedFiles = new Set(matched.flatMap(c => c.files.map(f => f.path)));
     const uncommittedFiles = [...sessionFiles].filter(f => !committedFiles.has(f));
 
@@ -119,7 +151,7 @@ export function correlateSessions(sessions, commitsByRepo) {
     }
   }
 
-  // Re-sort result by start time descending (most recent first for display)
+  // Sort result by start time descending (most recent first for display)
   result.sort((a, b) => new Date(b.startTime).getTime() - new Date(a.startTime).getTime());
 
   return { correlatedSessions: result, organicCommits };

package/src/index.js

@@ -9,8 +9,11 @@ import { correlateSessions } from './correlator.js';
 import { computeMetrics } from './metrics.js';
 import { loadCache, saveCache, deleteCache, getStaleFiles } from './cache.js';
 import { createServer } from './server.js';
+import { readFileSync } from 'node:fs';
 
-const VERSION = '0.1.1';
+const { version: VERSION } = JSON.parse(
+  readFileSync(new URL('../package.json', import.meta.url), 'utf8')
+);
 
 async function main() {
   const program = new Command();

package/playwright.config.js

@@ -1,9 +0,0 @@
-import { defineConfig } from '@playwright/test';
-
-export default defineConfig({
-  testDir: './tests',
-  timeout: 30000,
-  use: {
-    baseURL: 'http://localhost:3457',
-  },
-});