@aixle/insights 0.1.1 → 0.2.1-staging

package/dist/readers/cursor.js

@@ -10,8 +10,8 @@ import { basename, dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { homedir } from "node:os";
 import { glob } from "glob";
-import Database from "better-sqlite3";
 import { scanText } from "../risk-scanner.js";
+import { openCursorSqliteReadonly } from "./cursor-sqlite.js";
 // ─── Reader: paths & SQLite ──────────────────────────────────────────────────
 export function cursorUserDir() {
     switch (process.platform) {
@@ -43,14 +43,19 @@ function logDbTables(db, dbPath, label) {
     console.log(`  tables: ${tables.join(", ") || "(none)"}`);
 }
 /** Smoke-test better-sqlite3 against the global Cursor state DB (CUR-V02 / verify scripts). */
-export function probeCursorGlobalStateDb(verbose = false) {
-    const dbPath = join(cursorUserDir(), "globalStorage", "state.vscdb");
+export function probeCursorGlobalStateDb(verbose = false, baseDir) {
+    const userDir = baseDir ?? cursorUserDir();
+    const dbPath = join(userDir, "globalStorage", "state.vscdb");
+    const opened = openCursorSqliteReadonly(dbPath, { rootDir: userDir });
+    if (!opened.ok) {
+        console.error(`  [probe] failed to read ${dbPath}: ${opened.message}`);
+        return false;
+    }
+    const db = opened.db;
     try {
-        const db = new Database(dbPath, { readonly: true });
         const row = db
             .prepare(`SELECT count(*) AS c FROM ${STATE_TABLE} WHERE key LIKE 'aiCodeTracking.dailyStats%'`)
             .get();
-        db.close();
         if (verbose) {
             console.log(`  [probe] global state.vscdb OK — ${row.c} dailyStats key(s)`);
         }
@@ -61,6 +66,9 @@ export function probeCursorGlobalStateDb(verbose = false) {
         console.error(`  [probe] failed to read ${dbPath}: ${msg}`);
         return false;
     }
+    finally {
+        db.close();
+    }
 }
 // ─── Legacy: cursor.db / CursorRequestFeedback ─────────────────────────────────
 export function findCursorDbs(baseDir) {
@@ -72,10 +80,13 @@ export function findCursorDbs(baseDir) {
         return [];
     }
 }
-function readLegacyFromDb(dbPath, since, workspacePath, verbose) {
+function readLegacyFromDb(dbPath, since, workspacePath, rootDir, verbose) {
     let db = null;
     try {
-        db = new Database(dbPath, { readonly: true });
+        const opened = openCursorSqliteReadonly(dbPath, { rootDir });
+        if (!opened.ok)
+            return [];
+        db = opened.db;
         if (verbose)
             logDbTables(db, dbPath, "cursor.db");
         if (!tableExists(db, LEGACY_TABLE))
@@ -105,13 +116,14 @@ function readLegacyFromDb(dbPath, since, workspacePath, verbose) {
     }
 }
 export function readLegacyEvents(since, baseDir, verbose = false) {
+    const rootDir = baseDir ?? cursorUserDir();
     const dbPaths = findCursorDbs(baseDir);
     if (verbose)
         console.log(`Found ${dbPaths.length} legacy cursor.db file(s)`);
     const results = [];
     for (const dbPath of dbPaths) {
         const workspacePath = dbPath.replace(/[\\/]cursor\.db$/, "");
-        for (const row of readLegacyFromDb(dbPath, since, workspacePath, verbose)) {
+        for (const row of readLegacyFromDb(dbPath, since, workspacePath, rootDir, verbose)) {
             results.push({ row, workspacePath });
         }
     }
@@ -239,10 +251,13 @@ export function findStateVscDbs(baseDir) {
     }
     return results;
 }
-function readDailyStatsFromDb(dbPath, since, verbose) {
+function readDailyStatsFromDb(dbPath, since, rootDir, verbose) {
     let db = null;
     try {
-        db = new Database(dbPath, { readonly: true });
+        const opened = openCursorSqliteReadonly(dbPath, { rootDir });
+        if (!opened.ok)
+            return [];
+        db = opened.db;
         if (verbose)
             logDbTables(db, dbPath, "state.vscdb");
         if (!tableExists(db, STATE_TABLE))
@@ -264,7 +279,7 @@ function readDailyStatsFromDb(dbPath, since, verbose) {
             if (!dateMatch)
                 continue;
             const date = dateMatch[1];
-            if (since && date <= since.toISOString().slice(0, 10))
+            if (since && date < since.toISOString().slice(0, 10))
                 continue;
             let parsed;
             try {
@@ -285,6 +300,7 @@ function readDailyStatsFromDb(dbPath, since, verbose) {
     }
 }
 function readDailyStatsRaw(since, baseDir, verbose) {
+    const rootDir = baseDir ?? cursorUserDir();
     const dbPaths = findStateVscDbs(baseDir);
     if (verbose) {
         console.log(`Searching: ${baseDir ?? cursorUserDir()}`);
@@ -292,7 +308,7 @@ function readDailyStatsRaw(since, baseDir, verbose) {
     }
     const raw = [];
     for (const dbPath of dbPaths) {
-        raw.push(...readDailyStatsFromDb(dbPath, since, verbose));
+        raw.push(...readDailyStatsFromDb(dbPath, since, rootDir, verbose));
     }
     return raw;
 }
@@ -339,10 +355,13 @@ function dedupeRecentCommitSnapshots(entries) {
     }
     return [...byKey.values()];
 }
-function readRecentCommitFromDb(dbPath, since, verbose) {
+function readRecentCommitFromDb(dbPath, since, rootDir, verbose) {
     let db = null;
     try {
-        db = new Database(dbPath, { readonly: true });
+        const opened = openCursorSqliteReadonly(dbPath, { rootDir });
+        if (!opened.ok)
+            return [];
+        db = opened.db;
         if (!tableExists(db, STATE_TABLE))
             return [];
         const row = db
@@ -384,13 +403,14 @@ function readRecentCommitFromDb(dbPath, since, verbose) {
     }
 }
 export function readRecentCommitSnapshots(since, baseDir, verbose = false) {
+    const rootDir = baseDir ?? cursorUserDir();
     const dbPaths = findStateVscDbs(baseDir);
     if (verbose) {
         console.log(`Searching recentCommit: ${baseDir ?? cursorUserDir()}`);
     }
     const found = [];
     for (const dbPath of dbPaths) {
-        found.push(...readRecentCommitFromDb(dbPath, since, verbose));
+        found.push(...readRecentCommitFromDb(dbPath, since, rootDir, verbose));
     }
     return dedupeRecentCommitSnapshots(found);
 }
@@ -427,12 +447,71 @@ function toIsoFromMs(value) {
     const date = new Date(value);
     return Number.isNaN(date.getTime()) ? null : date.toISOString();
 }
+/** Coerce epoch ms/seconds, numeric strings, or ISO-8601 into an ISO timestamp. */
+function coerceTranscriptTimestamp(value) {
+    if (value == null)
+        return null;
+    if (typeof value === "number")
+        return toIsoFromMs(value);
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim();
+    if (!trimmed)
+        return null;
+    const fromEpoch = toIsoString(trimmed);
+    if (fromEpoch)
+        return fromEpoch;
+    const ms = Date.parse(trimmed);
+    if (Number.isNaN(ms))
+        return null;
+    return new Date(ms).toISOString();
+}
+/** Prefer explicit per-line / per-message times when Cursor includes them. */
+function extractLineOccurredAt(entry) {
+    const candidates = [
+        entry.timestamp,
+        entry.createdAt,
+        entry.unixMs,
+        entry.message?.timestamp,
+        entry.message?.createdAt,
+    ];
+    for (const candidate of candidates) {
+        const iso = coerceTranscriptTimestamp(candidate);
+        if (iso)
+            return iso;
+    }
+    return null;
+}
+/**
+ * Spread turns across [start, end] when the JSONL has no per-message times.
+ * Prevents first-sync backfill from collapsing every turn onto lastUpdatedAt/mtime
+ * (DB90DV-605 weekly chart spike).
+ */
+function interpolateTurnOccurredAt(startIso, endIso, index, total, fallbackIso) {
+    if (total <= 0)
+        return fallbackIso;
+    // Single turn: prefer session end (lastUpdatedAt) — matches prior composer-header behavior.
+    if (total === 1)
+        return endIso ?? startIso ?? fallbackIso;
+    const startMs = startIso ? Date.parse(startIso) : NaN;
+    const endMs = endIso ? Date.parse(endIso) : NaN;
+    if (Number.isNaN(startMs) || Number.isNaN(endMs)) {
+        return startIso ?? endIso ?? fallbackIso;
+    }
+    if (endMs <= startMs)
+        return startIso ?? fallbackIso;
+    const ms = startMs + ((endMs - startMs) * index) / (total - 1);
+    return new Date(ms).toISOString();
+}
 function readComposerHeaders(baseDir) {
     const userDir = baseDir ?? cursorUserDir();
     const dbPath = join(userDir, "globalStorage", "state.vscdb");
     let db = null;
     try {
-        db = new Database(dbPath, { readonly: true });
+        const opened = openCursorSqliteReadonly(dbPath, { rootDir: userDir });
+        if (!opened.ok)
+            return new Map();
+        db = opened.db;
         if (!tableExists(db, STATE_TABLE))
             return new Map();
         const row = db
@@ -468,6 +547,7 @@ function readComposerHeaders(baseDir) {
                 composerId,
                 name: typeof composer.name === "string" ? composer.name : null,
                 workspacePath: typeof uri?.fsPath === "string" ? uri.fsPath : null,
+                createdAt: toIsoFromMs(composer.createdAt),
                 lastUpdatedAt: toIsoFromMs(composer.lastUpdatedAt),
             });
         }
@@ -540,11 +620,15 @@ function workspaceFromTranscriptFile(filePath) {
 const MAX_TRANSCRIPT_BYTES = 50 * 1024 * 1024; // 50 MB
 export async function parseCursorTranscriptFile(filePath, composerHeaders, verbose = false) {
     let fileSize = 0;
-    let occurredAt = new Date().toISOString();
+    let fileMtimeIso = new Date().toISOString();
+    let fileBirthIso = null;
     try {
         const stat = statSync(filePath);
         fileSize = stat.size;
-        occurredAt = stat.mtime.toISOString();
+        fileMtimeIso = stat.mtime.toISOString();
+        if (stat.birthtime && !Number.isNaN(stat.birthtime.getTime()) && stat.birthtime.getTime() > 0) {
+            fileBirthIso = stat.birthtime.toISOString();
+        }
     }
     catch {
         return [];
@@ -557,15 +641,25 @@ export async function parseCursorTranscriptFile(filePath, composerHeaders, verbo
     }
     const sessionId = basename(filePath, ".jsonl");
     const header = composerHeaders.get(sessionId);
-    if (header?.lastUpdatedAt)
-        occurredAt = header.lastUpdatedAt;
-    const turns = [];
+    const sessionFallback = header?.lastUpdatedAt ?? fileMtimeIso;
+    const sessionStart = header?.createdAt ?? fileBirthIso ?? sessionFallback;
+    const sessionEnd = header?.lastUpdatedAt ?? fileMtimeIso;
+    const drafts = [];
     let currentPromptParts = [];
     let currentAssistantParts = [];
+    let currentTurnOccurredAt = null;
     let turnIndex = 0;
     const hasher = createHash("sha256");
     const stream = createReadStream(filePath, { encoding: "utf-8" });
     const rl = createInterface({ input: stream, crlfDelay: Infinity });
+    const noteLineTime = (entry) => {
+        const lineAt = extractLineOccurredAt(entry);
+        if (!lineAt)
+            return;
+        // Prefer the first timestamp in the turn (usually the user message).
+        if (!currentTurnOccurredAt)
+            currentTurnOccurredAt = lineAt;
+    };
     const finalizeTurn = () => {
         const promptText = currentPromptParts.join("\n\n").trim();
         const assistantText = currentAssistantParts.join("\n\n").trim();
@@ -573,14 +667,14 @@ export async function parseCursorTranscriptFile(filePath, composerHeaders, verbo
             return;
         const risk = scanText(promptText);
         turnIndex += 1;
-        turns.push({
+        drafts.push({
             turnId: `${sessionId}:${turnIndex}`,
             sessionId,
             filePath,
             fileSize,
             workspacePath: header?.workspacePath ?? workspaceFromTranscriptFile(filePath),
             composerName: header?.name ?? null,
-            occurredAt,
+            turnOccurredAt: currentTurnOccurredAt,
             promptText,
             assistantText,
             tokensIn: estimateTokens(promptText),
@@ -589,6 +683,7 @@ export async function parseCursorTranscriptFile(filePath, composerHeaders, verbo
             riskScore: risk.risk_score,
             riskCategories: risk.risk_categories,
         });
+        currentTurnOccurredAt = null;
     };
     let lineNumber = 0;
     try {
@@ -617,9 +712,11 @@ export async function parseCursorTranscriptFile(filePath, composerHeaders, verbo
                     currentPromptParts = [];
                     currentAssistantParts = [];
                 }
+                noteLineTime(entry);
                 currentPromptParts.push(...texts.map(stripUserQueryWrapper).filter((text) => text.length > 0));
             }
             else if (entry.role === "assistant") {
+                noteLineTime(entry);
                 currentAssistantParts.push(...texts.map((text) => text.trim()).filter((text) => text.length > 0));
             }
         }
@@ -636,9 +733,16 @@ export async function parseCursorTranscriptFile(filePath, composerHeaders, verbo
     }
     finalizeTurn();
     const contentHash = hasher.digest("hex").slice(0, 32);
-    for (const t of turns)
-        t.contentHash = contentHash;
-    return turns;
+    const total = drafts.length;
+    return drafts.map((draft, index) => {
+        const { turnOccurredAt, ...rest } = draft;
+        return {
+            ...rest,
+            contentHash,
+            occurredAt: turnOccurredAt ??
+                interpolateTurnOccurredAt(sessionStart, sessionEnd, index, total, sessionFallback),
+        };
+    });
 }
 export async function readCursorTranscriptSessions(cursorUserBaseDir, transcriptProjectDirs, verbose = false) {
     const composerHeaders = readComposerHeaders(cursorUserBaseDir);
@@ -702,8 +806,12 @@ function pick(obj, ...keys) {
     }
     return typeof cur === "number" ? cur : null;
 }
+function dailyStatsSessionId(date, eventType, modelKey) {
+    const suffix = modelKey ? `${eventType}:${modelKey}` : eventType;
+    return `cursor:daily_stats:${date}:${suffix}`;
+}
 function buildPayload(opts) {
-    const { eventType, tokensIn, tokensOut, costUsd, occurredAt, dbPath, model = "unknown", projectId, costModel = LINE_COST_MODEL, } = opts;
+    const { eventType, tokensIn, tokensOut, costUsd, occurredAt, dbPath, date, model = "unknown", modelResolution, modelKey, projectId, costModel = LINE_COST_MODEL, } = opts;
     const payload = {
         tool_name: "cursor",
         event_type: eventType,
@@ -713,18 +821,20 @@ function buildPayload(opts) {
         cost_usd: costUsd,
         occurred_at: occurredAt,
         metadata: {
+            session_id: dailyStatsSessionId(date, eventType, modelKey),
             cursor_session_id: null,
             ...cursorWorkspaceMetadata(dbPath),
             cost_model: costModel,
             scannable: false,
             risk_level: "none",
+            ...(modelResolution !== undefined ? { model_resolution: modelResolution } : {}),
         },
     };
     if (projectId)
         payload.project_id = projectId;
     return payload;
 }
-export function mapDailyStats(entry, projectId, pricing = DEFAULT_CURSOR_PRICING, model) {
+export function mapDailyStats(entry, projectId, pricing = DEFAULT_CURSOR_PRICING, model, modelResolution) {
     const { date, value, dbPath } = entry;
     const occurredAt = `${date}T00:00:00.000Z`;
     const results = [];
@@ -740,10 +850,12 @@ export function mapDailyStats(entry, projectId, pricing = DEFAULT_CURSOR_PRICING
             eventType: "completion",
             tokensIn: tabSuggested,
             tokensOut: tabAccepted,
-            costUsd: computeLineCost("completion", tabSuggested, pricing),
+            costUsd: computeLineCost("completion", tabAccepted, pricing),
             occurredAt,
             dbPath,
+            date,
             model,
+            modelResolution,
             projectId,
         }));
     }
@@ -755,7 +867,9 @@ export function mapDailyStats(entry, projectId, pricing = DEFAULT_CURSOR_PRICING
             costUsd: computeLineCost("chat", composerSuggested, pricing),
             occurredAt,
             dbPath,
+            date,
             model,
+            modelResolution,
             projectId,
         }));
     }
@@ -776,7 +890,9 @@ export function mapDailyStats(entry, projectId, pricing = DEFAULT_CURSOR_PRICING
             costUsd: computeTokenCost("chat", tokensIn, tokensOut, pricing),
             occurredAt,
             dbPath,
+            date,
             model,
+            modelKey: model,
             projectId,
             costModel: TOKEN_COST_MODEL,
         }));
@@ -788,7 +904,7 @@ export function mapDailyStats(entry, projectId, pricing = DEFAULT_CURSOR_PRICING
  * Cursor only keeps one recent commit row (overwritten on each new commit).
  * Line-cost math still follows the chat-style line proxy (`computeLineCost("chat", …)`); only `event_type` differs.
  */
-export function mapRecentCommit(entry, projectId, pricing = DEFAULT_CURSOR_PRICING, model) {
+export function mapRecentCommit(entry, projectId, pricing = DEFAULT_CURSOR_PRICING, model, modelResolution) {
     const { value: obj, dbPath } = entry;
     const occurredAt = toIsoString(obj.timestamp);
     if (!occurredAt)
@@ -834,6 +950,7 @@ export function mapRecentCommit(entry, projectId, pricing = DEFAULT_CURSOR_PRICI
                     : undefined,
             scannable: false,
             risk_level: "none",
+            ...(modelResolution !== undefined ? { model_resolution: modelResolution } : {}),
         },
     };
     if (projectId)
@@ -870,7 +987,7 @@ export function mapEvent(row, workspacePath, projectId, pricing = DEFAULT_CURSOR
         payload.project_id = projectId;
     return payload;
 }
-export function mapTranscriptTurn(turn, projectId, pricing = DEFAULT_CURSOR_PRICING, model) {
+export function mapTranscriptTurn(turn, projectId, pricing = DEFAULT_CURSOR_PRICING, model, modelResolution) {
     const payload = {
         tool_name: "cursor",
         event_type: "chat",
@@ -892,6 +1009,7 @@ export function mapTranscriptTurn(turn, projectId, pricing = DEFAULT_CURSOR_PRIC
             composer_name: turn.composerName ?? undefined,
             prompt_text: turn.promptText || undefined,
             assistant_text: turn.assistantText || undefined,
+            ...(modelResolution !== undefined ? { model_resolution: modelResolution } : {}),
         },
     };
     if (projectId)

package/dist/server.d.ts

@@ -7,8 +7,25 @@ export declare const SYNC_NOW_INPUT_SCHEMA: z.ZodObject<{
         cursor: "cursor";
     }>>>;
 }, z.core.$strict>;
-/** Structured status for `db90_status` — tolerates missing/malformed credentials and state. */
-export declare function buildDb90StatusPayload(): Promise<Record<string, unknown>>;
+/**
+ * Whether a `credential_validation_failed` warning should mirror to stderr.
+ * Mirrors for one-shot/startup sources so an installed-but-uninitialized MCP is
+ * visible, but NOT for the recurring background `"interval"` tick — that fires
+ * every SYNC_INTERVAL_MS for the whole process lifetime and would spam the logs.
+ * The event is always written to mcp.log regardless of this return value.
+ */
+export declare function shouldMirrorMissingCredentials(source: string): boolean;
+/** Structured status for `aixle_insights_status` — tolerates missing/malformed credentials and state. */
+export declare function buildAixleInsightsStatusPayload(): Promise<Record<string, unknown>>;
 /** In-process MCP server instance (stdio not attached). */
-export declare function createDb90McpServer(): McpServer;
+export declare function createAixleInsightsMcpServer(): McpServer;
+/**
+ * Subscribes `shutdown` to the given stream's "end" and "close" events.
+ * Closing stdin is how the OS signals a stdio-transport MCP server that its
+ * parent process is gone — this fires even when the parent can't deliver a
+ * signal (e.g. it was itself SIGKILL'd, or the OS reparented this process
+ * without ever sending one). Exported standalone so it's testable with a
+ * plain EventEmitter instead of the real process.stdin.
+ */
+export declare function wireParentExitShutdown(stdin: Pick<NodeJS.ReadStream, "on">, shutdown: () => void): void;
 export declare function startServer(): Promise<void>;