spect8-mcp 0.2.0 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spect8-mcp",
-  "version": "0.2.0",
+  "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,6 +12,7 @@
   "files": [
     "dist",
     "examples",
+    "scripts",
     "README.md"
   ],
   "scripts": {

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('--------------------------------');