spect8-mcp 0.1.4 → 0.2.1

package/dist/transport/offline_queue.d.ts

@@ -8,18 +8,18 @@ export interface QueuedRow {
     attempts: number;
 }
 /**
- * Durable, append-only FIFO backed by SQLite. Used when the ingest endpoint is
- * unreachable so no captured event is lost across crashes or network outages.
- *
- * Rows are keyed by auto-incremented id to preserve ordering; `dequeue()`
- * returns the oldest unsent rows and callers call `ack()` after a successful
- * POST. On retry storms we also track `attempts` so pathological rows can be
- * drained manually by an operator.
+ * Durable, pure-JS FIFO buffer. Used when the ingest endpoint is
+ * unreachable so no captured event is lost. Backed by a simple JSON file
+ * to avoid native dependencies like SQLite which break on Windows/Node 24.
  */
 export declare class OfflineQueue {
+    private readonly dbPath;
     private readonly logger;
-    private readonly db;
+    private rows;
+    private nextId;
     constructor(dbPath: string, logger: Logger);
+    private load;
+    private save;
     enqueueMany(kind: QueueKind, payloads: string[]): void;
     dequeue(kind: QueueKind, limit: number): QueuedRow[];
     ack(ids: number[]): void;

package/dist/transport/offline_queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"offline_queue.d.ts","sourceRoot":"","sources":["../../src/transport/offline_queue.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,aAAa,CAAC;AAEhD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IAGK,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;gBAE3B,MAAM,EAAE,MAAM,EAAmB,MAAM,EAAE,MAAM;IAmB3D,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAgBtD,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE;IASpD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI;IAQxB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI;IAUzB,IAAI,IAAI,MAAM;IAOd,KAAK,IAAI,IAAI;CAGd"}
+{"version":3,"file":"offline_queue.d.ts","sourceRoot":"","sources":["../../src/transport/offline_queue.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,aAAa,CAAC;AAEhD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,qBAAa,YAAY;IAIX,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAU,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHpE,OAAO,CAAC,IAAI,CAAmB;IAC/B,OAAO,CAAC,MAAM,CAAa;gBAEE,MAAM,EAAE,MAAM,EAAmB,MAAM,EAAE,MAAM;IAI5E,OAAO,CAAC,IAAI;IAqBZ,OAAO,CAAC,IAAI;IAYZ,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAetD,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE;IAMpD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI;IAOxB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI;IAWzB,IAAI,IAAI,MAAM;IAId,KAAK,IAAI,IAAI;CAGd"}

package/dist/transport/offline_queue.js

@@ -1,83 +1,95 @@
-import Database from "better-sqlite3";
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
 import { dirname } from "node:path";
-import { mkdirSync, existsSync } from "node:fs";
 /**
- * Durable, append-only FIFO backed by SQLite. Used when the ingest endpoint is
- * unreachable so no captured event is lost across crashes or network outages.
- *
- * Rows are keyed by auto-incremented id to preserve ordering; `dequeue()`
- * returns the oldest unsent rows and callers call `ack()` after a successful
- * POST. On retry storms we also track `attempts` so pathological rows can be
- * drained manually by an operator.
+ * Durable, pure-JS FIFO buffer. Used when the ingest endpoint is
+ * unreachable so no captured event is lost. Backed by a simple JSON file
+ * to avoid native dependencies like SQLite which break on Windows/Node 24.
  */
 export class OfflineQueue {
+    dbPath;
     logger;
-    db;
+    rows = [];
+    nextId = 1;
     constructor(dbPath, logger) {
+        this.dbPath = dbPath;
         this.logger = logger;
-        if (!existsSync(dirname(dbPath))) {
-            mkdirSync(dirname(dbPath), { recursive: true });
+        this.load();
+    }
+    load() {
+        if (!existsSync(this.dbPath)) {
+            if (!existsSync(dirname(this.dbPath))) {
+                mkdirSync(dirname(this.dbPath), { recursive: true });
+            }
+            this.save();
+            return;
+        }
+        try {
+            const raw = readFileSync(this.dbPath, "utf8");
+            const data = JSON.parse(raw);
+            this.rows = data.rows || [];
+            this.nextId = data.nextId || 1;
+        }
+        catch (err) {
+            this.logger.error("Failed to load offline queue", err.message);
+            this.rows = [];
+            this.nextId = 1;
+        }
+    }
+    save() {
+        try {
+            const data = {
+                rows: this.rows,
+                nextId: this.nextId
+            };
+            writeFileSync(this.dbPath, JSON.stringify(data, null, 2), "utf8");
+        }
+        catch (err) {
+            this.logger.error("Failed to save offline queue", err.message);
         }
-        this.db = new Database(dbPath);
-        this.db.pragma("journal_mode = WAL");
-        this.db.pragma("synchronous = NORMAL");
-        this.db.exec(`
-      CREATE TABLE IF NOT EXISTS spect8_queue (
-        id           INTEGER PRIMARY KEY AUTOINCREMENT,
-        kind         TEXT NOT NULL,
-        payload      TEXT NOT NULL,
-        created_at_ms INTEGER NOT NULL,
-        attempts     INTEGER NOT NULL DEFAULT 0
-      );
-      CREATE INDEX IF NOT EXISTS ix_spect8_queue_kind ON spect8_queue(kind, id);
-    `);
     }
     enqueueMany(kind, payloads) {
         if (payloads.length === 0)
             return;
-        const stmt = this.db.prepare("INSERT INTO spect8_queue(kind, payload, created_at_ms) VALUES (?, ?, ?)");
         const now = Date.now();
-        const tx = this.db.transaction((rows) => {
-            for (const p of rows)
-                stmt.run(kind, p, now);
-        });
-        try {
-            tx(payloads);
-        }
-        catch (err) {
-            this.logger.error("offline queue enqueue failed", err.message);
+        for (const p of payloads) {
+            this.rows.push({
+                id: this.nextId++,
+                kind,
+                payload: p,
+                created_at_ms: now,
+                attempts: 0
+            });
         }
+        this.save();
     }
     dequeue(kind, limit) {
-        const rows = this.db
-            .prepare("SELECT id, kind, payload, created_at_ms, attempts FROM spect8_queue WHERE kind = ? ORDER BY id LIMIT ?")
-            .all(kind, limit);
-        return rows;
+        return this.rows
+            .filter(r => r.kind === kind)
+            .slice(0, limit);
     }
     ack(ids) {
         if (ids.length === 0)
             return;
-        const placeholders = ids.map(() => "?").join(",");
-        this.db
-            .prepare(`DELETE FROM spect8_queue WHERE id IN (${placeholders})`)
-            .run(...ids);
+        const set = new Set(ids);
+        this.rows = this.rows.filter(r => !set.has(r.id));
+        this.save();
     }
     bump(ids) {
         if (ids.length === 0)
             return;
-        const placeholders = ids.map(() => "?").join(",");
-        this.db
-            .prepare(`UPDATE spect8_queue SET attempts = attempts + 1 WHERE id IN (${placeholders})`)
-            .run(...ids);
+        const set = new Set(ids);
+        for (const r of this.rows) {
+            if (set.has(r.id)) {
+                r.attempts++;
+            }
+        }
+        this.save();
     }
     size() {
-        const row = this.db
-            .prepare("SELECT COUNT(*) AS n FROM spect8_queue")
-            .get();
-        return row.n;
+        return this.rows.length;
     }
     close() {
-        this.db.close();
+        this.save();
     }
 }
 //# sourceMappingURL=offline_queue.js.map

package/dist/transport/offline_queue.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spect8-mcp",
-  "version": "0.1.4",
+  "version": "0.2.1",
   "description": "Spect8 local MCP server: captures tool events + token usage from Cursor and Claude Code, posts HMAC-signed batches to the Spect8 ingest API.",
   "type": "module",
   "main": "dist/server.js",
@@ -12,9 +12,11 @@
   "files": [
     "dist",
     "examples",
+    "scripts",
     "README.md"
   ],
   "scripts": {
+    "preinstall": "node scripts/preinstall.js",
     "build": "tsc -p tsconfig.json",
     "dev": "tsc -w -p tsconfig.json",
     "start": "node dist/server.js",
@@ -25,13 +27,11 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "better-sqlite3": "^11.5.0",
     "chokidar": "^3.6.0",
     "undici": "^6.20.0",
     "zod": "^3.23.8"
   },
   "devDependencies": {
-    "@types/better-sqlite3": "^7.6.11",
     "@types/node": "^22.0.0",
     "@typescript-eslint/eslint-plugin": "^7.18.0",
     "@typescript-eslint/parser": "^7.18.0",

package/scripts/preinstall.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+
+/**
+ * Pre-install check for Spect8 MCP.
+ * Ensures the environment is ready and provides clear, human-readable
+ * guidance if any common issues are detected.
+ */
+
+const nodeVersion = process.versions.node;
+const majorVersion = parseInt(nodeVersion.split('.')[0], 10);
+const isWindows = process.platform === 'win32';
+
+console.log('--- Spect8 Environment Check ---');
+
+if (majorVersion < 20) {
+  console.error('❌ Error: Node.js 20 or higher is required.');
+  console.error(`   Your current version is: ${nodeVersion}`);
+  console.error('   Please upgrade at: https://nodejs.org');
+  process.exit(1);
+}
+
+if (isWindows && majorVersion >= 24) {
+  console.warn('⚠️  Notice: You are using Node 24 on Windows.');
+  console.warn('   This version is very new. We have removed all native dependencies');
+  console.warn('   to ensure it works, but if you encounter issues, Node 22 LTS is recommended.');
+}
+
+console.log('✅ Environment compatible. Proceeding with installation...');
+console.log('--------------------------------');