@devtrace-ai/cli 1.0.0

package/dist/card.js

@@ -0,0 +1,142 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCardSvg = buildCardSvg;
+exports.writeCardSvg = writeCardSvg;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const config_1 = require("./config");
+const html_report_1 = require("./html_report");
+const CARD_WIDTH = 800;
+const CARD_HEIGHT = 418;
+/** Truncates a display string to a max length, appending an ellipsis if cut. */
+function truncate(input, maxLen) {
+    if (input.length <= maxLen)
+        return input;
+    return `${input.slice(0, Math.max(0, maxLen - 1))}…`;
+}
+function weightedSurvivalRate(sessions) {
+    let totalInsertions = 0;
+    let totalSurviving = 0;
+    let anyKnown = false;
+    for (const s of sessions) {
+        if (!s.churn || s.diff.totalInsertions <= 0)
+            continue;
+        anyKnown = true;
+        totalInsertions += s.diff.totalInsertions;
+        totalSurviving += s.diff.totalInsertions * s.churn.survivalRate;
+    }
+    if (!anyKnown || totalInsertions === 0)
+        return null;
+    return totalSurviving / totalInsertions;
+}
+function weightedSurvival30d(sessions) {
+    const measured = sessions
+        .map(s => s.churn?.survival30d)
+        .filter((v) => v !== undefined && v.status === 'measured');
+    if (measured.length === 0)
+        return null;
+    const rate = measured.reduce((sum, v) => sum + v.rate, 0) / measured.length;
+    return { rate, n: measured.length };
+}
+/** Builds the shareable SVG scorecard content (dark theme, ~800x418 social-card ratio). */
+function buildCardSvg(sessions, projectDir) {
+    const repoName = truncate(path.basename(projectDir), 40);
+    const aiSessions = sessions.filter((s) => s.aiTool !== 'none');
+    const total = sessions.length;
+    const aiSharePct = total > 0 ? Math.round((aiSessions.length / total) * 100) : 0;
+    const headSurvival = weightedSurvivalRate(aiSessions);
+    const w30 = weightedSurvival30d(aiSessions);
+    let periodLabel = 'no commits recorded';
+    if (total > 0) {
+        const dates = sessions.map((s) => s.timestamp.substring(0, 10)).sort();
+        const first = dates[0];
+        const last = dates[dates.length - 1];
+        periodLabel = first === last ? first : `${first} → ${last}`;
+    }
+    const survivalHeadText = headSurvival === null ? 'unknown' : `${(headSurvival * 100).toFixed(0)}%`;
+    const survival30Text = w30 ? `${(w30.rate * 100).toFixed(0)}% (n=${w30.n})` : 'window open / unknown';
+    const esc = (s) => (0, html_report_1.escapeHtml)(s);
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="${CARD_WIDTH}" height="${CARD_HEIGHT}" viewBox="0 0 ${CARD_WIDTH} ${CARD_HEIGHT}" role="img" aria-label="DevTrace scorecard for ${esc(repoName)}">
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="#0f172a"/>
+      <stop offset="100%" stop-color="#1e1b4b"/>
+    </linearGradient>
+  </defs>
+  <rect width="${CARD_WIDTH}" height="${CARD_HEIGHT}" fill="url(#bg)"/>
+  <rect x="1" y="1" width="${CARD_WIDTH - 2}" height="${CARD_HEIGHT - 2}" fill="none" stroke="#334155" stroke-width="2" rx="16"/>
+
+  <text x="48" y="72" fill="#e2e8f0" font-family="-apple-system, Helvetica, Arial, sans-serif" font-size="30" font-weight="700">${esc(repoName)}</text>
+  <text x="48" y="100" fill="#94a3b8" font-family="-apple-system, Helvetica, Arial, sans-serif" font-size="16">${esc(periodLabel)}</text>
+
+  <g transform="translate(48, 140)">
+    <text x="0" y="0" fill="#64748b" font-family="-apple-system, Helvetica, Arial, sans-serif" font-size="13" letter-spacing="1">AI COMMIT SHARE</text>
+    <text x="0" y="52" fill="#22d3ee" font-family="-apple-system, Helvetica, Arial, sans-serif" font-size="48" font-weight="700">${aiSharePct}%</text>
+    <text x="0" y="76" fill="#64748b" font-family="-apple-system, Helvetica, Arial, sans-serif" font-size="13">${aiSessions.length} of ${total} commit(s)</text>
+  </g>
+
+  <g transform="translate(300, 140)">
+    <text x="0" y="0" fill="#64748b" font-family="-apple-system, Helvetica, Arial, sans-serif" font-size="13" letter-spacing="1">SURVIVAL (HEAD)</text>
+    <text x="0" y="52" fill="#a78bfa" font-family="-apple-system, Helvetica, Arial, sans-serif" font-size="48" font-weight="700">${esc(survivalHeadText)}</text>
+    <text x="0" y="76" fill="#64748b" font-family="-apple-system, Helvetica, Arial, sans-serif" font-size="13">AI-authored lines still present</text>
+  </g>
+
+  <g transform="translate(552, 140)">
+    <text x="0" y="0" fill="#64748b" font-family="-apple-system, Helvetica, Arial, sans-serif" font-size="13" letter-spacing="1">SURVIVAL (30D)</text>
+    <text x="0" y="52" fill="#34d399" font-family="-apple-system, Helvetica, Arial, sans-serif" font-size="30" font-weight="700">${esc(survival30Text)}</text>
+    <text x="0" y="76" fill="#64748b" font-family="-apple-system, Helvetica, Arial, sans-serif" font-size="13">windowed at commit+30d</text>
+  </g>
+
+  <line x1="48" y1="330" x2="${CARD_WIDTH - 48}" y2="330" stroke="#334155" stroke-width="1"/>
+  <text x="48" y="360" fill="#475569" font-family="-apple-system, Helvetica, Arial, sans-serif" font-size="13">measured from git history; heuristic detections are estimates</text>
+  <text x="48" y="384" fill="#334155" font-family="-apple-system, Helvetica, Arial, sans-serif" font-size="12">DevTrace</text>
+</svg>
+`;
+}
+/** Writes the SVG scorecard to disk and returns the absolute path. */
+function writeCardSvg(sessions, projectDir, outPath) {
+    const config = config_1.ConfigManager.loadConfig(projectDir);
+    const target = outPath
+        ? path.resolve(projectDir, outPath)
+        : path.join(projectDir, config.storageDir, 'card.svg');
+    const dir = path.dirname(target);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    const svg = buildCardSvg(sessions, projectDir);
+    fs.writeFileSync(target, svg, 'utf8');
+    return target;
+}

package/dist/chat.js

@@ -0,0 +1,266 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatLogParser = void 0;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const claude_1 = require("./capture/claude");
+class ChatLogParser {
+    /**
+     * Attempts to parse chat logs from a user-supplied file path.
+     */
+    static parseUserFile(filePath) {
+        if (!fs.existsSync(filePath)) {
+            return null;
+        }
+        try {
+            const content = fs.readFileSync(filePath, 'utf8').trim();
+            // Try JSON parsing
+            try {
+                const parsed = JSON.parse(content);
+                // Standard Claude Code conversation JSON format
+                if (parsed.events && Array.isArray(parsed.events)) {
+                    const conversation = [];
+                    let promptText = '';
+                    for (const event of parsed.events) {
+                        if (event.type === 'user_message') {
+                            const text = event.text || '';
+                            if (!promptText)
+                                promptText = text;
+                            conversation.push({ role: 'user', text });
+                        }
+                        else if (event.type === 'assistant_message') {
+                            conversation.push({ role: 'assistant', text: event.text || '' });
+                        }
+                    }
+                    return { promptText, conversation };
+                }
+            }
+            catch {
+                // Fall back to treating it as plain text prompt
+            }
+            return {
+                promptText: content,
+                conversation: [{ role: 'user', text: content }]
+            };
+        }
+        catch (error) {
+            console.warn(`[DevTrace] Failed to parse user chat log: ${error.message}`);
+            return null;
+        }
+    }
+    /**
+     * Automatically attempts to parse the latest Claude Code session transcript
+     * for the current repo. Delegates to ClaudeCaptureSource (src/capture/claude.ts),
+     * which reads the real transcript location: ~/.claude/projects/<slugified-cwd>/*.jsonl,
+     * correlated to `cwd` so unrelated projects' sessions never leak in here.
+     *
+     * `cwd` defaults to process.cwd() to preserve the previous call signature
+     * (index.ts calls this with no arguments).
+     */
+    static parseLatestClaudeCode(cwd = process.cwd()) {
+        try {
+            const source = new claude_1.ClaudeCaptureSource();
+            const result = source.getLatestPrompt(cwd);
+            if (!result)
+                return null;
+            return {
+                promptText: result.promptText,
+                conversation: [{ role: 'user', text: result.promptText }]
+            };
+        }
+        catch (error) {
+            console.warn(`[DevTrace] Failed to parse Claude Code chat logs: ${error.message}`);
+            return null;
+        }
+    }
+    /**
+     * Attempts to query Cursor's state database for recent chat panels using native sqlite3 client.
+     * If sqlite3 is not installed, falls back to raw binary/string scanning.
+     * Cross-platform compatible (handles macOS, Windows, Linux paths).
+     */
+    static parseLatestCursorChat(homeDir = process.env.HOME || process.env.USERPROFILE || '') {
+        if (!homeDir)
+            return null;
+        let dbPath = '';
+        if (process.platform === 'darwin') {
+            dbPath = path.join(homeDir, 'Library', 'Application Support', 'Cursor', 'User', 'globalStorage', 'state.vscdb');
+        }
+        else if (process.platform === 'win32') {
+            dbPath = path.join(process.env.APPDATA || path.join(homeDir, 'AppData', 'Roaming'), 'Cursor', 'User', 'globalStorage', 'state.vscdb');
+        }
+        else {
+            dbPath = path.join(homeDir, '.config', 'Cursor', 'User', 'globalStorage', 'state.vscdb');
+        }
+        if (!fs.existsSync(dbPath)) {
+            return null;
+        }
+        const uniqueId = `temp_cursor_state_${Date.now()}_${Math.random().toString(36).substring(7)}`;
+        const tempDbPath = path.join(os.tmpdir(), `${uniqueId}.vscdb`);
+        const tempWalPath = `${tempDbPath}-wal`;
+        const tempShmPath = `${tempDbPath}-shm`;
+        let chatState = null;
+        try {
+            // 1. Snapshot the database. Try executing sqlite3 CLI tool backup command first for atomic consistency.
+            let snapshotSuccess = false;
+            try {
+                const backupRes = (0, child_process_1.spawnSync)('sqlite3', [dbPath, `.backup '${tempDbPath}'`]);
+                if (backupRes.status === 0 && fs.existsSync(tempDbPath)) {
+                    snapshotSuccess = true;
+                }
+            }
+            catch { }
+            if (!snapshotSuccess) {
+                // Fallback: Copy the main database file directly (ignoring WAL/SHM sidecars to prevent lock/SHM issues)
+                fs.copyFileSync(dbPath, tempDbPath);
+            }
+            // 2. Try executing sqlite3 CLI tool first
+            const query = "SELECT value FROM ItemTable WHERE key = 'workbench.panel.chatSidebar';";
+            const result = (0, child_process_1.spawnSync)('sqlite3', [tempDbPath, query], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] });
+            const resultRaw = result.status === 0 ? result.stdout.trim() : '';
+            if (resultRaw) {
+                try {
+                    const parsed = JSON.parse(resultRaw);
+                    if (parsed && parsed.chatState) {
+                        chatState = parsed.chatState;
+                    }
+                }
+                catch { }
+            }
+            // 3. Fallback: Parse binary/string if sqlite3 is missing or failed
+            if (!chatState) {
+                const binaryContent = fs.readFileSync(tempDbPath, 'latin1');
+                chatState = this.extractChatStateFromBinary(binaryContent);
+            }
+            if (chatState && Array.isArray(chatState.chats)) {
+                const chats = chatState.chats;
+                if (chats.length === 0)
+                    return null;
+                const latestChat = chats[chats.length - 1];
+                if (latestChat && Array.isArray(latestChat.bubbles)) {
+                    const conversation = [];
+                    let promptText = '';
+                    for (const bubble of latestChat.bubbles) {
+                        const role = bubble.type === 'user' ? 'user' : 'assistant';
+                        const text = bubble.text || '';
+                        if (role === 'user' && !promptText)
+                            promptText = text;
+                        conversation.push({ role, text });
+                    }
+                    return { promptText, conversation };
+                }
+            }
+        }
+        catch (error) {
+            // Silent catch to prevent git hooks blocking
+        }
+        finally {
+            // Cleanup copied temp files
+            const toDelete = [tempDbPath, tempWalPath, tempShmPath];
+            for (const f of toDelete) {
+                if (fs.existsSync(f)) {
+                    try {
+                        fs.unlinkSync(f);
+                    }
+                    catch { }
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Scans a string (loaded with 'latin1' encoding) for JSON chatState structure.
+     * Useful when sqlite3 CLI is not available on user's system.
+     */
+    static extractChatStateFromBinary(content) {
+        const markers = ['{"chatState"', '{"chats"'];
+        for (const marker of markers) {
+            let searchStart = 0;
+            while (true) {
+                const matchIdx = content.indexOf(marker, searchStart);
+                if (matchIdx === -1)
+                    break;
+                let braceCount = 0;
+                let inString = false;
+                let escaped = false;
+                let endIdx = -1;
+                for (let i = matchIdx; i < content.length; i++) {
+                    const char = content[i];
+                    if (escaped) {
+                        escaped = false;
+                        continue;
+                    }
+                    if (char === '\\') {
+                        escaped = true;
+                        continue;
+                    }
+                    if (char === '"') {
+                        inString = !inString;
+                        continue;
+                    }
+                    if (!inString) {
+                        if (char === '{') {
+                            braceCount++;
+                        }
+                        else if (char === '}') {
+                            braceCount--;
+                            if (braceCount === 0) {
+                                endIdx = i;
+                                break;
+                            }
+                        }
+                    }
+                }
+                if (endIdx !== -1) {
+                    const jsonStr = content.substring(matchIdx, endIdx + 1);
+                    try {
+                        const parsed = JSON.parse(jsonStr);
+                        if (parsed && (parsed.chatState || parsed.chats)) {
+                            return parsed.chatState || parsed;
+                        }
+                    }
+                    catch {
+                        // Keep scanning if JSON parse failed
+                    }
+                }
+                searchStart = matchIdx + 1;
+            }
+        }
+        return null;
+    }
+}
+exports.ChatLogParser = ChatLogParser;

package/dist/claude-correlate.js

@@ -0,0 +1,150 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TIER2_CONFIDENCE = void 0;
+exports.correlateCommitWithLedger = correlateCommitWithLedger;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const claude_hooks_1 = require("./claude-hooks");
+/**
+ * Correlates a landed git commit against the Claude Code hook ledger
+ * (.devtrace/claude-ledger.jsonl) to upgrade detection to tier 2
+ * ("instrumented", tool claude-code, confidence 0.85) — but only when no
+ * tier-1 trailer already matched (trailers stay authoritative; see
+ * src/detector.ts). Ledger events are watermarked by timestamp so a given
+ * edit event is never counted toward more than one commit.
+ *
+ * See docs/plans/03b-sota-capture-research-completion.md Gap 1 / Gap 4
+ * (tier scheme) and plan 04 §2.4 (T1.4).
+ */
+exports.TIER2_CONFIDENCE = 0.85;
+const WATERMARK_FILENAME = 'claude-ledger.watermark';
+function getLedgerPath(cwd) {
+    return path.join(cwd, '.devtrace', claude_hooks_1.CLAUDE_LEDGER_FILENAME);
+}
+function getWatermarkPath(cwd) {
+    return path.join(cwd, '.devtrace', WATERMARK_FILENAME);
+}
+function readWatermark(cwd) {
+    try {
+        const raw = fs.readFileSync(getWatermarkPath(cwd), 'utf8').trim();
+        const ts = Date.parse(raw);
+        return Number.isNaN(ts) ? 0 : ts;
+    }
+    catch {
+        return 0;
+    }
+}
+function writeWatermark(cwd, isoTs) {
+    try {
+        fs.writeFileSync(getWatermarkPath(cwd), isoTs, 'utf8');
+    }
+    catch {
+        // Best-effort — a failed watermark write only risks double-counting a future
+        // commit's correlation, not data loss or a crash.
+    }
+}
+/** Reads and parses all ledger lines, tolerating malformed lines. */
+function readLedgerEvents(cwd) {
+    const ledgerPath = getLedgerPath(cwd);
+    if (!fs.existsSync(ledgerPath))
+        return [];
+    let raw;
+    try {
+        raw = fs.readFileSync(ledgerPath, 'utf8');
+    }
+    catch {
+        return [];
+    }
+    const events = [];
+    for (const line of raw.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (parsed && typeof parsed === 'object' && (parsed.kind === 'edit' || parsed.kind === 'session-start')) {
+                events.push(parsed);
+            }
+        }
+        catch {
+            // Skip malformed lines rather than aborting the whole file.
+        }
+    }
+    return events;
+}
+/**
+ * Determines whether the given commit's changed files were touched by
+ * unconsumed Claude Code hook ledger events (i.e. events with ts newer than
+ * the last-consumed watermark). Advances the watermark to the newest event
+ * timestamp seen in this call, whether or not it matched a file, so events
+ * are never double-counted across commits.
+ *
+ * `changedFiles` must be repo-relative paths (same convention the ledger
+ * uses — see resolveRelativeFilePath in src/claude-hooks.ts).
+ */
+function correlateCommitWithLedger(cwd, changedFiles) {
+    const events = readLedgerEvents(cwd);
+    if (events.length === 0) {
+        return { matched: false, matchedFiles: [], sessionIds: [] };
+    }
+    const watermark = readWatermark(cwd);
+    const changedSet = new Set(changedFiles);
+    let newestTs = watermark;
+    const matchedFiles = new Set();
+    const sessionIds = new Set();
+    for (const event of events) {
+        const ts = Date.parse(event.ts);
+        if (Number.isNaN(ts) || ts <= watermark)
+            continue;
+        if (ts > newestTs)
+            newestTs = ts;
+        if (event.kind === 'edit') {
+            const edit = event;
+            if (changedSet.has(edit.filePath)) {
+                matchedFiles.add(edit.filePath);
+                sessionIds.add(edit.sessionId);
+            }
+        }
+    }
+    if (newestTs > watermark) {
+        writeWatermark(cwd, new Date(newestTs).toISOString());
+    }
+    return {
+        matched: matchedFiles.size > 0,
+        matchedFiles: Array.from(matchedFiles),
+        sessionIds: Array.from(sessionIds)
+    };
+}