spect8-mcp 0.1.0

package/dist/hooks/shared.js

@@ -0,0 +1,132 @@
+import { readFileSync, readdirSync, statSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { randomUUID } from "node:crypto";
+import { loadConfig } from "../config.js";
+import { createLogger } from "../logger.js";
+import { IngestClient } from "../transport/ingest_client.js";
+import { OfflineQueue } from "../transport/offline_queue.js";
+import { Batcher } from "../transport/batcher.js";
+import { resolveDeveloperId } from "../session/developer_id.js";
+import { getOrCreateSessionId } from "../session/session_id.js";
+/**
+ * Bootstraps the same transport stack used by the long-lived MCP server so
+ * hook scripts can share the offline queue and HMAC key.
+ */
+export function setupHookRuntime() {
+    const config = loadConfig();
+    const logger = createLogger(config.logLevel);
+    const developerId = resolveDeveloperId(config.developerId);
+    const client = new IngestClient(config.ingestUrl, config.ingestHmacKey, developerId, logger);
+    const queue = new OfflineQueue(config.offlineQueuePath, logger);
+    const batcher = new Batcher({
+        intervalMs: config.batchIntervalMs,
+        maxEvents: config.batchMaxEvents,
+        client,
+        queue,
+        logger,
+    });
+    return {
+        sessionId: getOrCreateSessionId(config.sessionFilePath),
+        developerId: resolveDeveloperId(config.developerId),
+        ideName: config.ideName,
+        batcher,
+        client,
+        queue,
+        projectsRoot: config.claudeProjectsRoot,
+    };
+}
+export function makeToolEvent(bundle, tool, extra = {}) {
+    return {
+        event_id: randomUUID(),
+        session_id: bundle.sessionId,
+        task_id: null,
+        developer_id: bundle.developerId,
+        tool_name: tool,
+        timestamp_ms: Date.now(),
+        ide_name: bundle.ideName,
+        ...extra,
+    };
+}
+/**
+ * Scan every `*.jsonl` under the Claude projects root and emit a
+ * `TokenEvent` for every assistant message carrying a `message.usage`. Very
+ * tolerant of shape drift - unknown entries are skipped rather than thrown.
+ */
+export function collectTokenEventsFromClaudeJsonl(bundle, since_ms) {
+    if (!existsSync(bundle.projectsRoot))
+        return [];
+    const results = [];
+    for (const file of walkJsonlFiles(bundle.projectsRoot)) {
+        try {
+            const stat = statSync(file);
+            if (stat.mtimeMs < since_ms)
+                continue;
+            const text = readFileSync(file, "utf8");
+            for (const raw of text.split("\n")) {
+                const line = raw.trim();
+                if (!line)
+                    continue;
+                let parsed;
+                try {
+                    parsed = JSON.parse(line);
+                }
+                catch {
+                    continue;
+                }
+                const msg = parsed?.message;
+                const usage = msg?.usage;
+                if (!msg?.id || !usage)
+                    continue;
+                const input = Number(usage.input_tokens ?? 0);
+                const output = Number(usage.output_tokens ?? 0);
+                if (!(input + output > 0))
+                    continue;
+                results.push({
+                    request_id: String(msg.id),
+                    session_id: parsed.sessionId
+                        ? String(parsed.sessionId)
+                        : bundle.sessionId,
+                    developer_id: bundle.developerId,
+                    timestamp_ms: parsed.timestamp
+                        ? Date.parse(parsed.timestamp)
+                        : stat.mtimeMs,
+                    ide_name: "claude_code",
+                    model_name: msg.model ?? null,
+                    input_tokens: input,
+                    output_tokens: output,
+                    cache_read_input_tokens: usage.cache_read_input_tokens ?? null,
+                    cache_creation_input_tokens: usage.cache_creation_input_tokens ?? null,
+                });
+            }
+        }
+        catch {
+            // per-file errors are non-fatal
+        }
+    }
+    return results;
+}
+function* walkJsonlFiles(root) {
+    try {
+        for (const entry of readdirSync(root, { withFileTypes: true })) {
+            const p = join(root, entry.name);
+            if (entry.isDirectory()) {
+                yield* walkJsonlFiles(p);
+            }
+            else if (entry.isFile() && entry.name.endsWith(".jsonl")) {
+                yield p;
+            }
+        }
+    }
+    catch {
+        // permission denied or missing - treat as empty
+    }
+}
+export async function finaliseHook(bundle) {
+    try {
+        await bundle.batcher.flush();
+    }
+    finally {
+        bundle.queue.close();
+    }
+}
+//# sourceMappingURL=shared.js.map

package/dist/hooks/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/hooks/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAahE;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE7C,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,IAAI,YAAY,CAC7B,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,aAAa,EACpB,WAAW,EACX,MAAM,CACP,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC;QAC1B,UAAU,EAAE,MAAM,CAAC,eAAe;QAClC,SAAS,EAAE,MAAM,CAAC,cAAc;QAChC,MAAM;QACN,KAAK;QACL,MAAM;KACP,CAAC,CAAC;IAEH,OAAO;QACL,SAAS,EAAE,oBAAoB,CAAC,MAAM,CAAC,eAAe,CAAC;QACvD,WAAW,EAAE,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC;QACnD,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO;QACP,MAAM;QACN,KAAK;QACL,YAAY,EAAE,MAAM,CAAC,kBAAkB;KACxC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,MAAkB,EAClB,IAA4B,EAC5B,QAA4B,EAAE;IAE9B,OAAO;QACL,QAAQ,EAAE,UAAU,EAAE;QACtB,UAAU,EAAE,MAAM,CAAC,SAAS;QAC5B,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,MAAM,CAAC,WAAW;QAChC,SAAS,EAAE,IAAI;QACf,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;QACxB,QAAQ,EAAE,MAAM,CAAC,OAAO;QACxB,GAAG,KAAK;KACT,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iCAAiC,CAC/C,MAAkB,EAClB,QAAgB;IAEhB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhD,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,cAAc,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,IAAI,CAAC,OAAO,GAAG,QAAQ;gBAAE,SAAS;YACtC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACxC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;gBACxB,IAAI,CAAC,IAAI;oBAAE,SAAS;gBACpB,IAAI,MAAW,CAAC;gBAChB,IAAI,CAAC;oBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC5B,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS;gBACX,CAAC;gBACD,MAAM,GAAG,GAAG,MAAM,EAAE,OAAO,CAAC;gBAC5B,MAAM,KAAK,GAAG,GAAG,EAAE,KAAK,CAAC;gBACzB,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,KAAK;oBAAE,SAAS;gBACjC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC;gBAC9C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC;gBAChD,IAAI,CAAC,CAAC,KAAK,GAAG,MAAM,GAAG,CAAC,CAAC;oBAAE,SAAS;gBAEpC,OAAO,CAAC,IAAI,CAAC;oBACX,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC1B,UAAU,EAAE,MAAM,CAAC,SAAS;wBAC1B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;wBAC1B,CAAC,CAAC,MAAM,CAAC,SAAS;oBACpB,YAAY,EAAE,MAAM,CAAC,WAAW;oBAChC,YAAY,EAAE,MAAM,CAAC,SAAS;wBAC5B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC;wBAC9B,CAAC,CAAC,IAAI,CAAC,OAAO;oBAChB,QAAQ,EAAE,aAAa;oBACvB,UAAU,EAAE,GAAG,CAAC,KAAK,IAAI,IAAI;oBAC7B,YAAY,EAAE,KAAK;oBACnB,aAAa,EAAE,MAAM;oBACrB,uBAAuB,EAAE,KAAK,CAAC,uBAAuB,IAAI,IAAI;oBAC9D,2BAA2B,EACzB,KAAK,CAAC,2BAA2B,IAAI,IAAI;iBAC5C,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,gCAAgC;QAClC,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,QAAQ,CAAC,CAAC,cAAc,CAAC,IAAY;IACnC,IAAI,CAAC;QACH,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAC/D,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACjC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,KAAK,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;YAC3B,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC3D,MAAM,CAAC,CAAC;YACV,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,gDAAgD;IAClD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAkB;IACnD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/interceptors/context.d.ts

@@ -0,0 +1,11 @@
+import type { Batcher } from "../transport/batcher.js";
+import type { ToolEvent, ToolName } from "../types.js";
+export interface InterceptorCtx {
+    batcher: Batcher;
+    developerId: string;
+    ideName: string;
+    getSessionId: () => string;
+    getTaskId: () => string | null;
+}
+export declare function baseEvent(ctx: InterceptorCtx, tool: ToolName): ToolEvent;
+//# sourceMappingURL=context.d.ts.map

package/dist/interceptors/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/interceptors/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,wBAAgB,SAAS,CACvB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,QAAQ,GACb,SAAS,CAUX"}

package/dist/interceptors/context.js

@@ -0,0 +1,13 @@
+import { randomUUID } from "node:crypto";
+export function baseEvent(ctx, tool) {
+    return {
+        event_id: randomUUID(),
+        session_id: ctx.getSessionId(),
+        task_id: ctx.getTaskId(),
+        developer_id: ctx.developerId,
+        tool_name: tool,
+        timestamp_ms: Date.now(),
+        ide_name: ctx.ideName,
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/interceptors/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/interceptors/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAYzC,MAAM,UAAU,SAAS,CACvB,GAAmB,EACnB,IAAc;IAEd,OAAO;QACL,QAAQ,EAAE,UAAU,EAAE;QACtB,UAAU,EAAE,GAAG,CAAC,YAAY,EAAE;QAC9B,OAAO,EAAE,GAAG,CAAC,SAAS,EAAE;QACxB,YAAY,EAAE,GAAG,CAAC,WAAW;QAC7B,SAAS,EAAE,IAAI;QACf,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;QACxB,QAAQ,EAAE,GAAG,CAAC,OAAO;KACtB,CAAC;AACJ,CAAC"}

package/dist/interceptors/file_ops.d.ts

@@ -0,0 +1,5 @@
+import type { ToolEvent } from "../types.js";
+import { type InterceptorCtx } from "./context.js";
+export declare function recordReadFile(ctx: InterceptorCtx, filePath: string): ToolEvent;
+export declare function recordWriteFile(ctx: InterceptorCtx, filePath: string): ToolEvent;
+//# sourceMappingURL=file_ops.d.ts.map

package/dist/interceptors/file_ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file_ops.d.ts","sourceRoot":"","sources":["../../src/interceptors/file_ops.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9D,wBAAgB,cAAc,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAQ/E;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAQhF"}

package/dist/interceptors/file_ops.js

@@ -0,0 +1,21 @@
+import { collectFsMetrics } from "../collectors/fs_metrics.js";
+import { baseEvent } from "./context.js";
+export function recordReadFile(ctx, filePath) {
+    const metrics = collectFsMetrics(filePath);
+    return {
+        ...baseEvent(ctx, "read_file"),
+        file_path: filePath,
+        file_size_bytes: metrics.file_size_bytes,
+        lines_count: metrics.lines_count,
+    };
+}
+export function recordWriteFile(ctx, filePath) {
+    const metrics = collectFsMetrics(filePath);
+    return {
+        ...baseEvent(ctx, "write_file"),
+        file_path: filePath,
+        file_size_bytes: metrics.file_size_bytes,
+        lines_count: metrics.lines_count,
+    };
+}
+//# sourceMappingURL=file_ops.js.map

package/dist/interceptors/file_ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file_ops.js","sourceRoot":"","sources":["../../src/interceptors/file_ops.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,EAAE,SAAS,EAAuB,MAAM,cAAc,CAAC;AAE9D,MAAM,UAAU,cAAc,CAAC,GAAmB,EAAE,QAAgB;IAClE,MAAM,OAAO,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC3C,OAAO;QACL,GAAG,SAAS,CAAC,GAAG,EAAE,WAAW,CAAC;QAC9B,SAAS,EAAE,QAAQ;QACnB,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,WAAW,EAAE,OAAO,CAAC,WAAW;KACjC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAmB,EAAE,QAAgB;IACnE,MAAM,OAAO,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC3C,OAAO;QACL,GAAG,SAAS,CAAC,GAAG,EAAE,YAAY,CAAC;QAC/B,SAAS,EAAE,QAAQ;QACnB,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,WAAW,EAAE,OAAO,CAAC,WAAW;KACjC,CAAC;AACJ,CAAC"}

package/dist/interceptors/git_diff.d.ts

@@ -0,0 +1,4 @@
+import type { ToolEvent } from "../types.js";
+import { type InterceptorCtx } from "./context.js";
+export declare function recordGitDiff(ctx: InterceptorCtx, cwd?: string): ToolEvent;
+//# sourceMappingURL=git_diff.d.ts.map

package/dist/interceptors/git_diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git_diff.d.ts","sourceRoot":"","sources":["../../src/interceptors/git_diff.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9D,wBAAgB,aAAa,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAQ1E"}

package/dist/interceptors/git_diff.js

@@ -0,0 +1,37 @@
+import { execFileSync } from "node:child_process";
+import { baseEvent } from "./context.js";
+export function recordGitDiff(ctx, cwd) {
+    const metrics = readNumstat(cwd ?? process.cwd());
+    return {
+        ...baseEvent(ctx, "git_diff"),
+        diff_lines_added: metrics.added,
+        diff_lines_removed: metrics.removed,
+        diff_files_changed: metrics.files,
+    };
+}
+function readNumstat(cwd) {
+    try {
+        const out = execFileSync("git", ["diff", "--numstat"], { cwd, stdio: ["ignore", "pipe", "ignore"], encoding: "utf8" });
+        let added = 0;
+        let removed = 0;
+        let files = 0;
+        for (const line of out.split("\n")) {
+            const parts = line.trim().split(/\s+/);
+            if (parts.length < 3)
+                continue;
+            const [addStr, delStr] = parts;
+            const addNum = Number(addStr);
+            const delNum = Number(delStr);
+            if (Number.isFinite(addNum) && Number.isFinite(delNum)) {
+                added += addNum;
+                removed += delNum;
+                files++;
+            }
+        }
+        return { added, removed, files };
+    }
+    catch {
+        return { added: 0, removed: 0, files: 0 };
+    }
+}
+//# sourceMappingURL=git_diff.js.map

package/dist/interceptors/git_diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git_diff.js","sourceRoot":"","sources":["../../src/interceptors/git_diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,SAAS,EAAuB,MAAM,cAAc,CAAC;AAE9D,MAAM,UAAU,aAAa,CAAC,GAAmB,EAAE,GAAY;IAC7D,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAClD,OAAO;QACL,GAAG,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC;QAC7B,gBAAgB,EAAE,OAAO,CAAC,KAAK;QAC/B,kBAAkB,EAAE,OAAO,CAAC,OAAO;QACnC,kBAAkB,EAAE,OAAO,CAAC,KAAK;KAClC,CAAC;AACJ,CAAC;AAQD,SAAS,WAAW,CAAC,GAAW;IAC9B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CACtB,KAAK,EACL,CAAC,MAAM,EAAE,WAAW,CAAC,EACrB,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAC/D,CAAC;QACF,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACvC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;gBAAE,SAAS;YAC/B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAyB,CAAC;YACnD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9B,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACvD,KAAK,IAAI,MAAM,CAAC;gBAChB,OAAO,IAAI,MAAM,CAAC;gBAClB,KAAK,EAAE,CAAC;YACV,CAAC;QACH,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAC5C,CAAC;AACH,CAAC"}

package/dist/interceptors/run_command.d.ts

@@ -0,0 +1,9 @@
+import type { ToolEvent } from "../types.js";
+import { type InterceptorCtx } from "./context.js";
+export interface RunCommandMeta {
+    command: string;
+    exit_code?: number;
+    duration_ms?: number;
+}
+export declare function recordRunCommand(ctx: InterceptorCtx, meta: RunCommandMeta): ToolEvent;
+//# sourceMappingURL=run_command.d.ts.map

package/dist/interceptors/run_command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run_command.d.ts","sourceRoot":"","sources":["../../src/interceptors/run_command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,cAAc,GACnB,SAAS,CAOX"}

package/dist/interceptors/run_command.js

@@ -0,0 +1,10 @@
+import { baseEvent } from "./context.js";
+export function recordRunCommand(ctx, meta) {
+    return {
+        ...baseEvent(ctx, "run_command"),
+        command: meta.command,
+        exit_code: meta.exit_code ?? null,
+        command_duration_ms: meta.duration_ms ?? null,
+    };
+}
+//# sourceMappingURL=run_command.js.map

package/dist/interceptors/run_command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run_command.js","sourceRoot":"","sources":["../../src/interceptors/run_command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAuB,MAAM,cAAc,CAAC;AAQ9D,MAAM,UAAU,gBAAgB,CAC9B,GAAmB,EACnB,IAAoB;IAEpB,OAAO;QACL,GAAG,SAAS,CAAC,GAAG,EAAE,aAAa,CAAC;QAChC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;QACjC,mBAAmB,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;KAC9C,CAAC;AACJ,CAAC"}

package/dist/interceptors/search_files.d.ts

@@ -0,0 +1,4 @@
+import type { ToolEvent } from "../types.js";
+import { type InterceptorCtx } from "./context.js";
+export declare function recordSearchFiles(ctx: InterceptorCtx, query: string, resultsCount?: number): ToolEvent;
+//# sourceMappingURL=search_files.d.ts.map

package/dist/interceptors/search_files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search_files.d.ts","sourceRoot":"","sources":["../../src/interceptors/search_files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9D,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,MAAM,GACpB,SAAS,CAMX"}

package/dist/interceptors/search_files.js

@@ -0,0 +1,9 @@
+import { baseEvent } from "./context.js";
+export function recordSearchFiles(ctx, query, resultsCount) {
+    return {
+        ...baseEvent(ctx, "search_files"),
+        search_query: query,
+        search_results_count: resultsCount ?? null,
+    };
+}
+//# sourceMappingURL=search_files.js.map

package/dist/interceptors/search_files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search_files.js","sourceRoot":"","sources":["../../src/interceptors/search_files.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAuB,MAAM,cAAc,CAAC;AAE9D,MAAM,UAAU,iBAAiB,CAC/B,GAAmB,EACnB,KAAa,EACb,YAAqB;IAErB,OAAO;QACL,GAAG,SAAS,CAAC,GAAG,EAAE,cAAc,CAAC;QACjC,YAAY,EAAE,KAAK;QACnB,oBAAoB,EAAE,YAAY,IAAI,IAAI;KAC3C,CAAC;AACJ,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,11 @@
+type Level = "silent" | "error" | "warn" | "info" | "debug";
+export interface Logger {
+    level: Level;
+    error(msg: string, ...args: unknown[]): void;
+    warn(msg: string, ...args: unknown[]): void;
+    info(msg: string, ...args: unknown[]): void;
+    debug(msg: string, ...args: unknown[]): void;
+}
+export declare function createLogger(level: Level): Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAIA,KAAK,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAa5D,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC7C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAC9C;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CA6BjD"}

package/dist/logger.js

@@ -0,0 +1,40 @@
+import { appendFileSync, existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+const LEVELS = {
+    silent: 0,
+    error: 1,
+    warn: 2,
+    info: 3,
+    debug: 4,
+};
+const LOG_DIR = join(homedir(), ".spect8", "logs");
+const LOG_FILE = join(LOG_DIR, "mcp.log");
+export function createLogger(level) {
+    const threshold = LEVELS[level];
+    if (!existsSync(LOG_DIR)) {
+        mkdirSync(LOG_DIR, { recursive: true });
+    }
+    const log = (at, msg, args) => {
+        const timestamp = new Date().toISOString();
+        const line = `[${timestamp}][${at}] ${msg}${args.length > 0 ? " " + JSON.stringify(args) : ""}`;
+        // Always log to file for debugging
+        try {
+            appendFileSync(LOG_FILE, line + "\n", "utf8");
+        }
+        catch {
+            /* ignore */
+        }
+        if (LEVELS[at] > threshold)
+            return;
+        process.stderr.write(line + "\n");
+    };
+    return {
+        level,
+        error: (m, ...a) => log("error", m, a),
+        warn: (m, ...a) => log("warn", m, a),
+        info: (m, ...a) => log("info", m, a),
+        debug: (m, ...a) => log("debug", m, a),
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAIlC,MAAM,MAAM,GAA0B;IACpC,MAAM,EAAE,CAAC;IACT,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;AACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;AAU1C,MAAM,UAAU,YAAY,CAAC,KAAY;IACvC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAEhC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,GAAG,GAAG,CAAC,EAAS,EAAE,GAAW,EAAE,IAAe,EAAE,EAAE;QACtD,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,IAAI,SAAS,KAAK,EAAE,KAAK,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAEhG,mCAAmC;QACnC,IAAI,CAAC;YACH,cAAc,CAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;QAED,IAAI,MAAM,CAAC,EAAE,CAAC,GAAG,SAAS;YAAE,OAAO;QACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC;IAEF,OAAO;QACL,KAAK;QACL,KAAK,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QACpC,KAAK,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;KACvC,CAAC;AACJ,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Spect8 local MCP server.
+ *
+ * Runs over stdio so it can be spawned by Cursor (.cursor/mcp.json) or any
+ * MCP-aware client. Exposes three tools for the AI caller (`start_task`,
+ * `end_task`, `get_score`) and, in parallel, tails local state files (Cursor
+ * SQLite, Claude Code JSONL) to capture token usage that the AI caller is
+ * unaware of.
+ */
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG"}

package/dist/server.js

@@ -0,0 +1,218 @@
+#!/usr/bin/env node
+/**
+ * Spect8 local MCP server.
+ *
+ * Runs over stdio so it can be spawned by Cursor (.cursor/mcp.json) or any
+ * MCP-aware client. Exposes three tools for the AI caller (`start_task`,
+ * `end_task`, `get_score`) and, in parallel, tails local state files (Cursor
+ * SQLite, Claude Code JSONL) to capture token usage that the AI caller is
+ * unaware of.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { loadConfig } from "./config.js";
+import { createLogger } from "./logger.js";
+import { getOrCreateSessionId } from "./session/session_id.js";
+import { resolveDeveloperId } from "./session/developer_id.js";
+import { IngestClient } from "./transport/ingest_client.js";
+import { OfflineQueue } from "./transport/offline_queue.js";
+import { Batcher } from "./transport/batcher.js";
+import { CursorSqliteTailer } from "./collectors/cursor_sqlite.js";
+import { ClaudeJsonlTailer } from "./collectors/claude_jsonl.js";
+import { GetScoreArgsSchema, runGetScore, } from "./tools/get_score.js";
+import { StartTaskArgsSchema, runStartTask, } from "./tools/start_task.js";
+import { runEndTask } from "./tools/end_task.js";
+import { ReportActivityArgsSchema, runReportActivity, } from "./tools/report_activity.js";
+async function main() {
+    const config = loadConfig();
+    const logger = createLogger(config.logLevel);
+    // If we are missing auth, run interactive flow
+    if (!config.ingestHmacKey || !config.developerId) {
+        const { runInteractiveAuth } = await import("./auth.js");
+        // Determine frontend URL - default to localhost if on dev, or production
+        const frontendUrl = process.env.SPECT8_FRONTEND_URL || "http://localhost:3000";
+        await runInteractiveAuth(logger, frontendUrl);
+        // Reload config after auth
+        Object.assign(config, loadConfig());
+    }
+    const developerId = resolveDeveloperId(config.developerId);
+    const sessionId = getOrCreateSessionId(config.sessionFilePath);
+    logger.info(`starting spect8-mcp for developer=${developerId} session=${sessionId}`);
+    const client = new IngestClient(config.ingestUrl, config.ingestHmacKey, developerId, logger);
+    const queue = new OfflineQueue(config.offlineQueuePath, logger);
+    const batcher = new Batcher({
+        intervalMs: config.batchIntervalMs,
+        maxEvents: config.batchMaxEvents,
+        client,
+        queue,
+        logger,
+    });
+    batcher.start();
+    let currentTaskId = null;
+    const ctx = {
+        batcher,
+        developerId,
+        ideName: config.ideName,
+        getSessionId: () => sessionId,
+        getTaskId: () => currentTaskId,
+    };
+    if (config.enableCursorTailer) {
+        new CursorSqliteTailer({
+            sqlitePath: config.cursorSqlitePath,
+            developerId,
+            logger,
+            batcher,
+            getSessionId: () => sessionId,
+        }).start();
+    }
+    let claudeTailer = null;
+    if (config.enableClaudeTailer) {
+        claudeTailer = new ClaudeJsonlTailer({
+            projectsRoot: config.claudeProjectsRoot,
+            developerId,
+            logger,
+            batcher,
+            getSessionId: () => sessionId,
+        });
+        claudeTailer.start();
+    }
+    const server = new Server({ name: "spect8-mcp", version: "0.1.0" }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: [
+            {
+                name: "start_task",
+                description: "Mark the beginning of a discrete task. Emits prompt_start + start_task events and returns a task_id.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        task_label: {
+                            type: "string",
+                            description: "Short human-readable label, e.g. 'fix login bug'",
+                        },
+                        ide_name: {
+                            type: "string",
+                            description: "The name of the IDE/Agent, e.g. 'kiro', 'antigravity', 'cursor'",
+                        },
+                    },
+                    required: ["task_label"],
+                },
+            },
+            {
+                name: "end_task",
+                description: "Mark the end of the current task. Emits an end_task event.",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                },
+            },
+            {
+                name: "get_score",
+                description: "Fetch the current Spect8 posterior score for this developer, and optionally a specific session score.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        session_id: {
+                            type: "string",
+                            description: "Optional session id to fetch the per-session score.",
+                        },
+                    },
+                },
+            },
+            {
+                name: "report_activity",
+                description: "Report a specific AI activity to the Spect8 Telemetry system. Must be called after reading files, writing files, running commands, searching, or performing git diffs.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        activity_type: { type: "string", description: "Must be one of: 'read_file', 'write_file', 'run_command', 'git_diff', 'search_files'" },
+                        file_path: { type: "string" },
+                        file_size_bytes: { type: "number" },
+                        command: { type: "string" },
+                        exit_code: { type: "number" },
+                        ide_name: { type: "string" }
+                    },
+                    required: ["activity_type"],
+                },
+            },
+        ],
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const name = req.params.name;
+        const raw = req.params.arguments ?? {};
+        if (name === "start_task") {
+            const args = StartTaskArgsSchema.parse(raw);
+            const result = runStartTask(args, {
+                ctx: {
+                    batcher,
+                    developerId,
+                    ideName: config.ideName,
+                    getSessionId: () => sessionId,
+                },
+                batcher,
+                onTaskStarted: (id) => {
+                    currentTaskId = id;
+                },
+            });
+            return { content: result.content };
+        }
+        if (name === "end_task") {
+            return runEndTask({
+                ctx,
+                batcher,
+                onTaskEnded: () => {
+                    currentTaskId = null;
+                },
+            });
+        }
+        if (name === "get_score") {
+            const args = GetScoreArgsSchema.parse(raw);
+            return runGetScore(args, { client, developerId, logger });
+        }
+        if (name === "report_activity") {
+            const args = ReportActivityArgsSchema.parse(raw);
+            const result = runReportActivity(args, {
+                ctx: {
+                    batcher,
+                    developerId,
+                    ideName: config.ideName,
+                    getSessionId: () => sessionId,
+                    getTaskId: () => currentTaskId,
+                },
+                batcher,
+            });
+            return { content: result.content };
+        }
+        throw new Error(`unknown tool '${name}'`);
+    });
+    const shutdown = async () => {
+        logger.info("shutting down");
+        try {
+            await claudeTailer?.stop();
+        }
+        catch (err) {
+            logger.debug("claude stop error", err.message);
+        }
+        try {
+            await batcher.stop();
+        }
+        finally {
+            queue.close();
+        }
+        process.exit(0);
+    };
+    process.on("SIGINT", () => void shutdown());
+    process.on("SIGTERM", () => void shutdown());
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info("ready on stdio");
+}
+main().catch((err) => {
+    process.stderr.write(`[spect8-mcp] fatal: ${err.message}\n${err.stack ?? ""}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/session/developer_id.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns a stable developer identifier.
+ * Priority: explicit config/env > hashed `git config user.email` > "anonymous".
+ */
+export declare function resolveDeveloperId(explicit?: string | null): string;
+//# sourceMappingURL=developer_id.d.ts.map

package/dist/session/developer_id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"developer_id.d.ts","sourceRoot":"","sources":["../../src/session/developer_id.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAkBnE"}