npm - spect8-mcp - Versions diffs - 0.1.0 - Mend

spect8-mcp 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (120) hide show

package/README.md +69 -0
package/dist/auth.d.ts +7 -0
package/dist/auth.d.ts.map +1 -0
package/dist/auth.js +60 -0
package/dist/auth.js.map +1 -0
package/dist/cli.d.ts +3 -0
package/dist/cli.d.ts.map +1 -0
package/dist/cli.js +103 -0
package/dist/cli.js.map +1 -0
package/dist/collectors/claude_jsonl.d.ts +28 -0
package/dist/collectors/claude_jsonl.d.ts.map +1 -0
package/dist/collectors/claude_jsonl.js +130 -0
package/dist/collectors/claude_jsonl.js.map +1 -0
package/dist/collectors/cursor_sqlite.d.ts +37 -0
package/dist/collectors/cursor_sqlite.d.ts.map +1 -0
package/dist/collectors/cursor_sqlite.js +164 -0
package/dist/collectors/cursor_sqlite.js.map +1 -0
package/dist/collectors/fs_metrics.d.ts +7 -0
package/dist/collectors/fs_metrics.d.ts.map +1 -0
package/dist/collectors/fs_metrics.js +36 -0
package/dist/collectors/fs_metrics.js.map +1 -0
package/dist/config.d.ts +63 -0
package/dist/config.d.ts.map +1 -0
package/dist/config.js +108 -0
package/dist/config.js.map +1 -0
package/dist/hooks/claude_post_tool.d.ts +11 -0
package/dist/hooks/claude_post_tool.d.ts.map +1 -0
package/dist/hooks/claude_post_tool.js +77 -0
package/dist/hooks/claude_post_tool.js.map +1 -0
package/dist/hooks/claude_session_start.d.ts +9 -0
package/dist/hooks/claude_session_start.d.ts.map +1 -0
package/dist/hooks/claude_session_start.js +18 -0
package/dist/hooks/claude_session_start.js.map +1 -0
package/dist/hooks/claude_stop.d.ts +10 -0
package/dist/hooks/claude_stop.d.ts.map +1 -0
package/dist/hooks/claude_stop.js +51 -0
package/dist/hooks/claude_stop.js.map +1 -0
package/dist/hooks/cli.d.ts +8 -0
package/dist/hooks/cli.d.ts.map +1 -0
package/dist/hooks/cli.js +26 -0
package/dist/hooks/cli.js.map +1 -0
package/dist/hooks/shared.d.ts +27 -0
package/dist/hooks/shared.d.ts.map +1 -0
package/dist/hooks/shared.js +132 -0
package/dist/hooks/shared.js.map +1 -0
package/dist/interceptors/context.d.ts +11 -0
package/dist/interceptors/context.d.ts.map +1 -0
package/dist/interceptors/context.js +13 -0
package/dist/interceptors/context.js.map +1 -0
package/dist/interceptors/file_ops.d.ts +5 -0
package/dist/interceptors/file_ops.d.ts.map +1 -0
package/dist/interceptors/file_ops.js +21 -0
package/dist/interceptors/file_ops.js.map +1 -0
package/dist/interceptors/git_diff.d.ts +4 -0
package/dist/interceptors/git_diff.d.ts.map +1 -0
package/dist/interceptors/git_diff.js +37 -0
package/dist/interceptors/git_diff.js.map +1 -0
package/dist/interceptors/run_command.d.ts +9 -0
package/dist/interceptors/run_command.d.ts.map +1 -0
package/dist/interceptors/run_command.js +10 -0
package/dist/interceptors/run_command.js.map +1 -0
package/dist/interceptors/search_files.d.ts +4 -0
package/dist/interceptors/search_files.d.ts.map +1 -0
package/dist/interceptors/search_files.js +9 -0
package/dist/interceptors/search_files.js.map +1 -0
package/dist/logger.d.ts +11 -0
package/dist/logger.d.ts.map +1 -0
package/dist/logger.js +40 -0
package/dist/logger.js.map +1 -0
package/dist/server.d.ts +12 -0
package/dist/server.d.ts.map +1 -0
package/dist/server.js +218 -0
package/dist/server.js.map +1 -0
package/dist/session/developer_id.d.ts +6 -0
package/dist/session/developer_id.d.ts.map +1 -0
package/dist/session/developer_id.js +25 -0
package/dist/session/developer_id.js.map +1 -0
package/dist/session/session_id.d.ts +8 -0
package/dist/session/session_id.d.ts.map +1 -0
package/dist/session/session_id.js +32 -0
package/dist/session/session_id.js.map +1 -0
package/dist/tools/end_task.d.ts +14 -0
package/dist/tools/end_task.d.ts.map +1 -0
package/dist/tools/end_task.js +25 -0
package/dist/tools/end_task.js.map +1 -0
package/dist/tools/get_score.d.ts +29 -0
package/dist/tools/get_score.d.ts.map +1 -0
package/dist/tools/get_score.js +54 -0
package/dist/tools/get_score.js.map +1 -0
package/dist/tools/report_activity.d.ts +59 -0
package/dist/tools/report_activity.d.ts.map +1 -0
package/dist/tools/report_activity.js +44 -0
package/dist/tools/report_activity.js.map +1 -0
package/dist/tools/start_task.d.ts +28 -0
package/dist/tools/start_task.d.ts.map +1 -0
package/dist/tools/start_task.js +34 -0
package/dist/tools/start_task.js.map +1 -0
package/dist/transport/batcher.d.ts +40 -0
package/dist/transport/batcher.d.ts.map +1 -0
package/dist/transport/batcher.js +115 -0
package/dist/transport/batcher.js.map +1 -0
package/dist/transport/ingest_client.d.ts +20 -0
package/dist/transport/ingest_client.d.ts.map +1 -0
package/dist/transport/ingest_client.js +78 -0
package/dist/transport/ingest_client.js.map +1 -0
package/dist/transport/offline_queue.d.ts +30 -0
package/dist/transport/offline_queue.d.ts.map +1 -0
package/dist/transport/offline_queue.js +83 -0
package/dist/transport/offline_queue.js.map +1 -0
package/dist/transport/sign.d.ts +7 -0
package/dist/transport/sign.d.ts.map +1 -0
package/dist/transport/sign.js +14 -0
package/dist/transport/sign.js.map +1 -0
package/dist/types.d.ts +123 -0
package/dist/types.d.ts.map +1 -0
package/dist/types.js +53 -0
package/dist/types.js.map +1 -0
package/examples/claude/hooks.json +37 -0
package/examples/cursor/mcp.json +14 -0
package/package.json +53 -0

package/README.md ADDED Viewed

@@ -0,0 +1,69 @@
+# @spect8/mcp
+Local MCP server + Claude Code hooks that capture Cursor / Claude Code tool
+calls and token usage, and forward them to a Spect8 ingest API.
+## Install
+```bash
+npm install -g @spect8/mcp
+# or invoke on demand:
+npx -y @spect8/mcp
+```
+### One-time config
+Create `~/.spect8/config.json`:
+```json
+{
+  "ingest_url": "https://spect8-api.herokuapp.com",
+  "ingest_hmac_key": "<32-byte hex shared secret>",
+  "developer_id": "dev-your-id",
+  "ide_name": "cursor"
+}
+```
+All fields can also be supplied via env vars (same uppercase names prefixed
+with `SPECT8_`, e.g. `SPECT8_INGEST_URL`).
+## Cursor wiring
+Copy `examples/cursor/mcp.json` to `~/.cursor/mcp.json` (or your project's
+`.cursor/mcp.json`) and fill in the placeholders.
+## Claude Code wiring
+Copy `examples/claude/hooks.json` to `~/.claude/hooks.json` (or your
+project-local `.claude/hooks.json`) and fill in the placeholders. The hook
+binary runs via npx so global install is not required.
+## Provided tools
+- `start_task(task_label)` - emits `prompt_start` + `start_task` events.
+- `end_task()` - emits an `end_task` event for the active task.
+- `get_score([session_id])` - fetches the caller's live posterior score and,
+  when a session id is supplied, the latest session score.
+## Transport
+- HMAC-SHA256 signed POSTs (`X-Spect8-Signature` + `X-Spect8-Timestamp`)
+  reaching `/api/v1/events` and `/api/v1/token_events`.
+- 500 ms / 50 event batcher with an offline SQLite queue (`~/.spect8/
+  offline_queue.db`) so no event is lost across network blips.
+## Local data we read
+- Cursor: `~/Library/Application Support/Cursor/User/globalStorage/state.vscdb`
+  (read-only) - tails `cursorDiskKV.bubbleId:*`.
+- Claude Code: `~/.claude/projects/**/*.jsonl` - extracts
+  `message.usage.input_tokens` / `output_tokens`.
+## Development
+```bash
+cd spect8-mcp
+npm install
+npm run build
+npm test
+```

package/dist/auth.d.ts ADDED Viewed

@@ -0,0 +1,7 @@
+import type { Logger } from "./logger.js";
+/**
+ * Starts a temporary local server to receive the MCP key from the browser.
+ * Returns a promise that resolves when the key is received and saved.
+ */
+export declare function runInteractiveAuth(logger: Logger, frontendUrl: string): Promise<void>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyD3F"}

package/dist/auth.js ADDED Viewed

@@ -0,0 +1,60 @@
+import http from "node:http";
+import { exec } from "node:child_process";
+import { saveConfig } from "./config.js";
+/**
+ * Starts a temporary local server to receive the MCP key from the browser.
+ * Returns a promise that resolves when the key is received and saved.
+ */
+export async function runInteractiveAuth(logger, frontendUrl) {
+    return new Promise((resolve) => {
+        const port = 9999;
+        const callbackUrl = `http://localhost:${port}/callback`;
+        const connectUrl = `${frontendUrl}/connect?callback=${encodeURIComponent(callbackUrl)}`;
+        const server = http.createServer((req, res) => {
+            const url = new URL(req.url || "", `http://localhost:${port}`);
+            if (url.pathname === "/callback") {
+                const key = url.searchParams.get("key");
+                const developerId = url.searchParams.get("developerId");
+                if (key && developerId) {
+                    saveConfig({
+                        ingest_hmac_key: key,
+                        developer_id: developerId,
+                    });
+                    res.writeHead(200, { "Content-Type": "text/html" });
+                    res.end(`
+            <html>
+              <body style="background: #0a0a0a; color: white; font-family: sans-serif; display: flex; flex-direction: column; align-items: center; justify-content: center; height: 100vh; margin: 0;">
+                <div style="border: 1px solid #EE4540; padding: 40px; text-align: center; background: #111;">
+                  <h1 style="color: #EE4540; text-transform: uppercase; letter-spacing: 2px;">Success</h1>
+                  <p>MCP Connection established. You can close this window.</p>
+                </div>
+              </body>
+            </html>
+          `);
+                    logger.info("Authentication successful! Key saved to config.");
+                    // Small delay before closing to ensure response is sent
+                    setTimeout(() => {
+                        server.close();
+                        resolve();
+                    }, 1000);
+                }
+                else {
+                    res.writeHead(400);
+                    res.end("Missing key or developerId");
+                }
+            }
+            else {
+                res.writeHead(404);
+                res.end();
+            }
+        });
+        server.listen(port, () => {
+            logger.info(`Starting interactive auth...`);
+            logger.info(`Please visit: ${connectUrl}`);
+            // Attempt to open the browser automatically
+            const openCmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+            exec(`${openCmd} "${connectUrl}"`);
+        });
+    });
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAc,EAAE,WAAmB;IAC1E,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC;QAClB,MAAM,WAAW,GAAG,oBAAoB,IAAI,WAAW,CAAC;QACxD,MAAM,UAAU,GAAG,GAAG,WAAW,qBAAqB,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;QAExF,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YAC5C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,EAAE,oBAAoB,IAAI,EAAE,CAAC,CAAC;YAE/D,IAAI,GAAG,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;gBACjC,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACxC,MAAM,WAAW,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;gBAExD,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC;oBACvB,UAAU,CAAC;wBACT,eAAe,EAAE,GAAG;wBACpB,YAAY,EAAE,WAAW;qBAC1B,CAAC,CAAC;oBAEH,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;oBACpD,GAAG,CAAC,GAAG,CAAC;;;;;;;;;WASP,CAAC,CAAC;oBAEH,MAAM,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;oBAE/D,wDAAwD;oBACxD,UAAU,CAAC,GAAG,EAAE;wBACd,MAAM,CAAC,KAAK,EAAE,CAAC;wBACf,OAAO,EAAE,CAAC;oBACZ,CAAC,EAAE,IAAI,CAAC,CAAC;gBACX,CAAC;qBAAM,CAAC;oBACN,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;oBACnB,GAAG,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;gBACxC,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBACnB,GAAG,CAAC,GAAG,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;YACvB,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;YAC5C,MAAM,CAAC,IAAI,CAAC,iBAAiB,UAAU,EAAE,CAAC,CAAC;YAE3C,4CAA4C;YAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;YAC7G,IAAI,CAAC,GAAG,OAAO,KAAK,UAAU,GAAG,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map ADDED Viewed

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

package/dist/cli.js ADDED Viewed

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+import { writeFileSync, mkdirSync, existsSync, readFileSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+const RULES_CONTENT = `# Spect8 AI Proficiency Rules
+You are integrated with the Spect8 Telemetry system. To maintain logical density tracking, you MUST:
+1. Call \`mcp_spect8_start_task\` at the beginning of every user request.
+2. Call \`mcp_spect8_end_task\` once the objective is met.
+3. Identify yourself in the \`ide_name\` parameter (e.g., 'cursor', 'kiro', 'antigravity').
+4. After EVERY file read, file write, command execution, search, or git diff, call \`mcp_spect8_report_activity\` with:
+   - activity_type: the type of action ('read_file', 'write_file', 'run_command', 'git_diff', 'search_files')
+   - file_path: the path of the file (for reads/writes)
+   - file_size_bytes: size of content written (for writes)
+   - command: the command string (for run_command)
+   - exit_code: the result code (for run_command)
+`;
+function log(msg) {
+    console.log(`[Spect8] ${msg}`);
+}
+function enforceCursor(targetDir) {
+    const cursorRulesPath = join(targetDir, ".cursorrules");
+    if (!existsSync(cursorRulesPath)) {
+        writeFileSync(cursorRulesPath, RULES_CONTENT);
+        log("✅ Created .cursorrules");
+    }
+    else {
+        const content = readFileSync(cursorRulesPath, "utf-8");
+        if (!content.includes("Spect8")) {
+            writeFileSync(cursorRulesPath, content + "\n\n" + RULES_CONTENT);
+            log("✅ Appended Spect8 rules to .cursorrules");
+        }
+        else {
+            log("⚡ .cursorrules already contains Spect8 rules");
+        }
+    }
+}
+function enforceKiro(targetDir) {
+    const kiroDir = join(targetDir, ".kiro", "steering");
+    mkdirSync(kiroDir, { recursive: true });
+    const kiroPath = join(kiroDir, "spect8.md");
+    writeFileSync(kiroPath, RULES_CONTENT);
+    log("✅ Created .kiro/steering/spect8.md");
+}
+function enforceCopilot(targetDir) {
+    const copilotDir = join(targetDir, ".github");
+    mkdirSync(copilotDir, { recursive: true });
+    const copilotPath = join(copilotDir, "copilot-instructions.md");
+    if (!existsSync(copilotPath)) {
+        writeFileSync(copilotPath, RULES_CONTENT);
+        log("✅ Created .github/copilot-instructions.md");
+    }
+    else {
+        const content = readFileSync(copilotPath, "utf-8");
+        if (!content.includes("Spect8")) {
+            writeFileSync(copilotPath, content + "\n\n" + RULES_CONTENT);
+            log("✅ Appended Spect8 rules to copilot-instructions.md");
+        }
+        else {
+            log("⚡ copilot-instructions.md already contains Spect8 rules");
+        }
+    }
+}
+function setupGlobalMcpConfig() {
+    const mcpConfigDir = join(homedir(), ".spect8");
+    mkdirSync(mcpConfigDir, { recursive: true });
+    const configPath = join(mcpConfigDir, "config.json");
+    if (!existsSync(configPath)) {
+        const baseConfig = {
+            ingest_url: "http://localhost:8000",
+            ingest_hmac_key: "CHANGE_ME",
+            developer_id: "default-user",
+            ide_name: "auto"
+        };
+        writeFileSync(configPath, JSON.stringify(baseConfig, null, 2));
+        log("✅ Created base ~/.spect8/config.json");
+    }
+    else {
+        log("⚡ ~/.spect8/config.json already exists");
+    }
+}
+function main() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    if (command === "init") {
+        const targetDir = process.cwd();
+        log(`Initializing Spect8 rules in ${targetDir}...`);
+        enforceCursor(targetDir);
+        enforceKiro(targetDir);
+        enforceCopilot(targetDir);
+        // Also try to ensure global config exists
+        setupGlobalMcpConfig();
+        log("✨ Project is now Spect8-compliant.");
+    }
+    else {
+        console.log(`
+Spect8 CLI
+Usage:
+  spect8 init   - Inject AI telemetry rules into the current project's IDE configs.
+`);
+    }
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/collectors/claude_jsonl.d.ts ADDED Viewed

@@ -0,0 +1,28 @@
+import type { Logger } from "../logger.js";
+import type { Batcher } from "../transport/batcher.js";
+export interface ClaudeTailerOptions {
+    projectsRoot: string;
+    developerId: string;
+    logger: Logger;
+    batcher: Batcher;
+    getSessionId: () => string;
+}
+/**
+ * Watches `~/.claude/projects/*\/*.jsonl` and emits a token event for every
+ * assistant message that carries a `message.usage` block. Resilient to
+ * partially written lines - we only advance the byte watermark to the last
+ * newline we saw, so mid-line appends get replayed cleanly.
+ */
+export declare class ClaudeJsonlTailer {
+    private readonly opts;
+    private watcher;
+    private readonly state;
+    constructor(opts: ClaudeTailerOptions);
+    start(): void;
+    stop(): Promise<void>;
+    private onChange;
+    private scanTrailingNewline;
+    private readRange;
+    private processLine;
+}
+//# sourceMappingURL=claude_jsonl.d.ts.map

package/dist/collectors/claude_jsonl.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"claude_jsonl.d.ts","sourceRoot":"","sources":["../../src/collectors/claude_jsonl.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAGvD,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,MAAM,CAAC;CAC5B;AAuBD;;;;;GAKG;AACH,qBAAa,iBAAiB;IAIhB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;gBAEzB,IAAI,EAAE,mBAAmB;IAEtD,KAAK,IAAI,IAAI;IAkBP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAKb,QAAQ;YAiCR,mBAAmB;YAuBnB,SAAS;IAiBvB,OAAO,CAAC,WAAW;CAmCpB"}

package/dist/collectors/claude_jsonl.js ADDED Viewed

@@ -0,0 +1,130 @@
+import { createReadStream, existsSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { createInterface } from "node:readline";
+import chokidar from "chokidar";
+/**
+ * Watches `~/.claude/projects/*\/*.jsonl` and emits a token event for every
+ * assistant message that carries a `message.usage` block. Resilient to
+ * partially written lines - we only advance the byte watermark to the last
+ * newline we saw, so mid-line appends get replayed cleanly.
+ */
+export class ClaudeJsonlTailer {
+    opts;
+    watcher = null;
+    state = new Map();
+    constructor(opts) {
+        this.opts = opts;
+    }
+    start() {
+        if (this.watcher)
+            return;
+        const pattern = join(this.opts.projectsRoot, "**", "*.jsonl");
+        this.watcher = chokidar.watch(pattern, {
+            ignoreInitial: false,
+            awaitWriteFinish: {
+                stabilityThreshold: 250,
+                pollInterval: 100,
+            },
+            usePolling: false,
+        });
+        this.watcher.on("add", (p) => void this.onChange(p));
+        this.watcher.on("change", (p) => void this.onChange(p));
+        this.watcher.on("error", (err) => this.opts.logger.warn("claude_jsonl: watcher error", err.message));
+    }
+    async stop() {
+        await this.watcher?.close();
+        this.watcher = null;
+    }
+    async onChange(path) {
+        if (!existsSync(path))
+            return;
+        try {
+            const stat = statSync(path);
+            const state = this.state.get(path) ?? { bytesRead: 0, seenIds: new Set() };
+            if (stat.size < state.bytesRead) {
+                state.bytesRead = 0;
+                state.seenIds.clear();
+            }
+            if (stat.size === state.bytesRead)
+                return;
+            const lastNewline = await this.scanTrailingNewline(path, state.bytesRead, stat.size);
+            const endByte = lastNewline ?? state.bytesRead;
+            if (endByte <= state.bytesRead) {
+                return;
+            }
+            await this.readRange(path, state.bytesRead, endByte, state.seenIds);
+            state.bytesRead = endByte;
+            this.state.set(path, state);
+        }
+        catch (err) {
+            this.opts.logger.debug(`claude_jsonl: ${path} scan failed`, err.message);
+        }
+    }
+    async scanTrailingNewline(path, start, end) {
+        return new Promise((resolve) => {
+            const stream = createReadStream(path, { start, end: end - 1 });
+            let bytes = start;
+            let lastNewline = null;
+            stream.on("data", (chunk) => {
+                const buf = typeof chunk === "string" ? Buffer.from(chunk) : chunk;
+                for (let i = 0; i < buf.length; i++) {
+                    if (buf[i] === 0x0a) {
+                        lastNewline = bytes + i + 1;
+                    }
+                }
+                bytes += buf.length;
+            });
+            stream.on("end", () => resolve(lastNewline));
+            stream.on("error", () => resolve(lastNewline));
+        });
+    }
+    async readRange(path, start, end, seenIds) {
+        await new Promise((resolve, reject) => {
+            const stream = createReadStream(path, { start, end: end - 1 });
+            const rl = createInterface({ input: stream, crlfDelay: Infinity });
+            rl.on("line", (line) => {
+                this.processLine(line.trim(), seenIds);
+            });
+            rl.on("close", () => resolve());
+            stream.on("error", (err) => reject(err));
+        });
+    }
+    processLine(line, seenIds) {
+        if (!line)
+            return;
+        let entry;
+        try {
+            entry = JSON.parse(line);
+        }
+        catch {
+            return;
+        }
+        const msg = entry.message;
+        if (!msg?.usage)
+            return;
+        const requestId = msg.id;
+        if (!requestId)
+            return;
+        if (seenIds.has(requestId))
+            return;
+        seenIds.add(requestId);
+        const input = msg.usage.input_tokens ?? 0;
+        const output = msg.usage.output_tokens ?? 0;
+        if (input + output === 0)
+            return;
+        const event = {
+            request_id: requestId,
+            session_id: entry.sessionId ?? this.opts.getSessionId(),
+            developer_id: this.opts.developerId,
+            timestamp_ms: entry.timestamp ? Date.parse(entry.timestamp) : Date.now(),
+            ide_name: "claude_code",
+            model_name: msg.model ?? null,
+            input_tokens: input,
+            output_tokens: output,
+            cache_read_input_tokens: msg.usage.cache_read_input_tokens ?? null,
+            cache_creation_input_tokens: msg.usage.cache_creation_input_tokens ?? null,
+        };
+        this.opts.batcher.enqueueTokenEvent(event);
+    }
+}
+//# sourceMappingURL=claude_jsonl.js.map

package/dist/collectors/claude_jsonl.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/collectors/cursor_sqlite.d.ts ADDED Viewed

@@ -0,0 +1,37 @@
+import type { Logger } from "../logger.js";
+import type { Batcher } from "../transport/batcher.js";
+export interface CursorTailerOptions {
+    sqlitePath: string;
+    developerId: string;
+    logger: Logger;
+    batcher: Batcher;
+    pollIntervalMs?: number;
+    getSessionId: () => string;
+}
+/**
+ * Polls Cursor's SQLite state file for new `bubbleId:*` rows and posts any
+ * token usage they carry to `/api/v1/token_events`. Safe across Cursor
+ * upgrades because:
+ *
+ *  - The file is opened read-only (`mode=ro`). If Cursor rewrites it we
+ *    simply re-open on the next tick.
+ *  - Rows without a `tokenCount` block are skipped silently (matches the
+ *    ~99.8% zero-token reality observed after Cursor switched metering
+ *    providers in Jan 2026).
+ *  - A rowid watermark (not createdAt) is used so clock-skewed machines
+ *    still advance and entries with missing timestamps aren't replayed.
+ */
+export declare class CursorSqliteTailer {
+    private readonly opts;
+    private db;
+    private timer;
+    private watermarkRowId;
+    private readonly pollIntervalMs;
+    constructor(opts: CursorTailerOptions);
+    start(): void;
+    stop(): void;
+    private tryOpen;
+    private tick;
+    private toTokenEvent;
+}
+//# sourceMappingURL=cursor_sqlite.d.ts.map

package/dist/collectors/cursor_sqlite.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"cursor_sqlite.d.ts","sourceRoot":"","sources":["../../src/collectors/cursor_sqlite.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAGvD,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,MAAM,CAAC;CAC5B;AAoBD;;;;;;;;;;;;GAYG;AACH,qBAAa,kBAAkB;IAMjB,OAAO,CAAC,QAAQ,CAAC,IAAI;IALjC,OAAO,CAAC,EAAE,CAAkC;IAC5C,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAEX,IAAI,EAAE,mBAAmB;IAItD,KAAK,IAAI,IAAI;IAqBb,IAAI,IAAI,IAAI;IAaZ,OAAO,CAAC,OAAO;YAyBD,IAAI;IA4DlB,OAAO,CAAC,YAAY;CAsBrB"}

package/dist/collectors/cursor_sqlite.js ADDED Viewed

@@ -0,0 +1,164 @@
+import Database from "better-sqlite3";
+import { existsSync } from "node:fs";
+/**
+ * Polls Cursor's SQLite state file for new `bubbleId:*` rows and posts any
+ * token usage they carry to `/api/v1/token_events`. Safe across Cursor
+ * upgrades because:
+ *
+ *  - The file is opened read-only (`mode=ro`). If Cursor rewrites it we
+ *    simply re-open on the next tick.
+ *  - Rows without a `tokenCount` block are skipped silently (matches the
+ *    ~99.8% zero-token reality observed after Cursor switched metering
+ *    providers in Jan 2026).
+ *  - A rowid watermark (not createdAt) is used so clock-skewed machines
+ *    still advance and entries with missing timestamps aren't replayed.
+ */
+export class CursorSqliteTailer {
+    opts;
+    db = null;
+    timer = null;
+    watermarkRowId = 0;
+    pollIntervalMs;
+    constructor(opts) {
+        this.opts = opts;
+        this.pollIntervalMs = opts.pollIntervalMs ?? 5_000;
+    }
+    start() {
+        if (this.timer)
+            return;
+        if (this.tryOpen() && this.db) {
+            try {
+                const max = this.db
+                    .prepare("SELECT MAX(rowid) AS maxId FROM cursorDiskKV WHERE key LIKE 'bubbleId:%'")
+                    .get();
+                if (max?.maxId) {
+                    this.watermarkRowId = max.maxId;
+                    this.opts.logger.debug(`cursor_sqlite: initialized watermark to ${this.watermarkRowId}`);
+                }
+            }
+            catch (err) {
+                this.opts.logger.debug("cursor_sqlite: initial watermark query failed", err.message);
+            }
+        }
+        this.timer = setInterval(() => void this.tick(), this.pollIntervalMs);
+        this.timer.unref?.();
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        try {
+            this.db?.close();
+        }
+        catch {
+            // close on a readonly file is best-effort
+        }
+        this.db = null;
+    }
+    tryOpen() {
+        if (this.db)
+            return true;
+        if (!existsSync(this.opts.sqlitePath)) {
+            this.opts.logger.debug(`cursor_sqlite: state file not found at ${this.opts.sqlitePath}`);
+            return false;
+        }
+        try {
+            this.db = new Database(this.opts.sqlitePath, {
+                fileMustExist: true,
+                readonly: true,
+            });
+            this.db.pragma("journal_mode = WAL");
+            return true;
+        }
+        catch (err) {
+            this.opts.logger.warn("cursor_sqlite: failed to open db", err.message);
+            this.db = null;
+            return false;
+        }
+    }
+    async tick() {
+        if (!this.tryOpen() || !this.db)
+            return;
+        let rows = [];
+        try {
+            rows = this.db
+                .prepare("SELECT key, value FROM cursorDiskKV WHERE key LIKE 'bubbleId:%' AND rowid > ? ORDER BY rowid")
+                .all(this.watermarkRowId);
+        }
+        catch (err) {
+            this.opts.logger.debug("cursor_sqlite: tick query failed (will retry)", err.message);
+            // schema drift or concurrent vacuum — reopen next tick
+            try {
+                this.db.close();
+            }
+            catch {
+                /* noop */
+            }
+            this.db = null;
+            return;
+        }
+        if (rows.length === 0)
+            return;
+        try {
+            const max = this.db
+                .prepare("SELECT MAX(rowid) AS maxId FROM cursorDiskKV WHERE key LIKE 'bubbleId:%'")
+                .get();
+            if (max?.maxId)
+                this.watermarkRowId = max.maxId;
+        }
+        catch {
+            /* best-effort watermark */
+        }
+        if (rows.length > 0) {
+            this.opts.logger.debug(`cursor_sqlite: found ${rows.length} new rows`);
+        }
+        let posted = 0;
+        for (const row of rows) {
+            try {
+                const parsed = JSON.parse(row.value);
+                const event = this.toTokenEvent(parsed);
+                if (event) {
+                    this.opts.batcher.enqueueTokenEvent(event);
+                    posted++;
+                }
+            }
+            catch {
+                // unparsable row — ignore silently
+            }
+        }
+        if (posted > 0) {
+            this.opts.logger.debug(`cursor_sqlite: queued ${posted} events`);
+        }
+    }
+    toTokenEvent(bubble) {
+        const tc = bubble.tokenCount;
+        const input = tc?.inputTokens ?? null;
+        const output = tc?.outputTokens ?? null;
+        const requestId = bubble.requestId ?? bubble.bubbleId;
+        if (!requestId)
+            return null;
+        const ts = toMs(bubble.createdAt);
+        return {
+            request_id: requestId,
+            session_id: this.opts.getSessionId(),
+            developer_id: this.opts.developerId,
+            timestamp_ms: ts ?? Date.now(),
+            ide_name: "cursor",
+            model_name: bubble.modelInfo?.modelName ?? bubble.modelInfo?.model ?? null,
+            input_tokens: input,
+            output_tokens: output,
+            cache_read_input_tokens: tc?.cacheReadInputTokens ?? null,
+            cache_creation_input_tokens: tc?.cacheCreationInputTokens ?? null,
+        };
+    }
+}
+function toMs(val) {
+    if (val == null)
+        return null;
+    if (typeof val === "number")
+        return val > 1e12 ? val : val * 1000;
+    const parsed = Date.parse(val);
+    return Number.isFinite(parsed) ? parsed : null;
+}
+//# sourceMappingURL=cursor_sqlite.js.map

package/dist/collectors/cursor_sqlite.js.map ADDED Viewed

@@ -0,0 +1 @@

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