myceliumail 1.0.7 → 1.0.9

package/README.md

@@ -34,6 +34,43 @@ Myceliumail is named after mycelium—the underground fungal network that lets t
 
 ---
 
+## 💎 Free vs Pro
+
+Myceliumail works as a **generous free tier** — upgrade when you need more power.
+
+| Feature | Free | Pro ($9/mo) |
+|---------|------|-------------|
+| Core messaging | ✅ Unlimited | ✅ Unlimited |
+| Encryption | ✅ Full E2E | ✅ Full E2E |
+| Imported keys | 5 max | ✅ Unlimited |
+| MCP Server | ❌ | ✅ |
+| Cloud key backup | ❌ | ✅ Coming soon |
+| Priority support | ❌ | ✅ |
+
+**Activate Pro:**
+```bash
+mycmail activate <your-license-key>
+mycmail license  # Check status
+```
+
+Get a license: [myceliumail.dev/pro](https://myceliumail.dev/pro)
+
+> **Note:** One Pro license unlocks the entire Treebird ecosystem (Myceliumail + Spidersan).
+
+---
+
+## 🗣️ Feedback & Support
+
+We're building this in public and want to hear from you!
+
+- **Issues & Features:** [GitHub Issues](https://github.com/treebird7/myceliumail/issues)
+- **Email:** treebird7@proton.me
+- **Twitter/X:** [@treebird7](https://twitter.com/treebird7)
+
+Tell us what's working, what's broken, and what you'd love to see next.
+
+---
+
 ## Quick Start
 
 ### CLI Installation

package/dist/bin/myceliumail.js

@@ -22,6 +22,7 @@ import { createWatchCommand } from '../commands/watch.js';
 import { createExportCommand } from '../commands/export.js';
 import { createStatusCommand } from '../commands/status.js';
 import { createActivateCommand, createLicenseStatusCommand } from '../commands/activate.js';
+import { checkForUpdates } from '../lib/update-check.js';
 const program = new Command();
 program
     .name('mycmail')
@@ -49,6 +50,8 @@ program.addCommand(createStatusCommand());
 // License management
 program.addCommand(createActivateCommand());
 program.addCommand(createLicenseStatusCommand());
+// Check for updates (non-blocking, runs in background)
+checkForUpdates().catch(() => { });
 // Parse and run
 program.parse();
 //# sourceMappingURL=myceliumail.js.map

package/dist/bin/myceliumail.js.map

@@ -1 +1 @@
-{"version":3,"file":"myceliumail.js","sourceRoot":"","sources":["../../src/bin/myceliumail.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AAEH,4CAA4C;AAC5C,OAAO,eAAe,CAAC;AAEvB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,kBAAkB;AAClB,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAE5F,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACF,IAAI,CAAC,SAAS,CAAC;KACf,WAAW,CAAC,+DAA+D,CAAC;KAC5E,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,6BAA6B;AAC7B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;AAC5B,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE;iBACZ,MAAM,CAAC,OAAO;;CAE9B,CAAC,CAAC;AAEH,oBAAoB;AACpB,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAC1C,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;AACxC,OAAO,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAC,CAAC;AAC7C,OAAO,CAAC,UAAU,CAAC,wBAAwB,EAAE,CAAC,CAAC;AAC/C,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;AACxC,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;AACzC,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;AACxC,OAAO,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAC,CAAC;AAC7C,OAAO,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAC,CAAC;AAC7C,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;AACzC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAC1C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAE1C,qBAAqB;AACrB,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;AAC5C,OAAO,CAAC,UAAU,CAAC,0BAA0B,EAAE,CAAC,CAAC;AAEjD,gBAAgB;AAChB,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"myceliumail.js","sourceRoot":"","sources":["../../src/bin/myceliumail.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AAEH,4CAA4C;AAC5C,OAAO,eAAe,CAAC;AAEvB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,kBAAkB;AAClB,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACF,IAAI,CAAC,SAAS,CAAC;KACf,WAAW,CAAC,+DAA+D,CAAC;KAC5E,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,6BAA6B;AAC7B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;AAC5B,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE;iBACZ,MAAM,CAAC,OAAO;;CAE9B,CAAC,CAAC;AAEH,oBAAoB;AACpB,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAC1C,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;AACxC,OAAO,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAC,CAAC;AAC7C,OAAO,CAAC,UAAU,CAAC,wBAAwB,EAAE,CAAC,CAAC;AAC/C,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;AACxC,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;AACzC,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;AACxC,OAAO,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAC,CAAC;AAC7C,OAAO,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAC,CAAC;AAC7C,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;AACzC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAC1C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAE1C,qBAAqB;AACrB,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;AAC5C,OAAO,CAAC,UAAU,CAAC,0BAA0B,EAAE,CAAC,CAAC;AAEjD,uDAAuD;AACvD,eAAe,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAEnC,gBAAgB;AAChB,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/lib/update-check.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Update Check Module
+ *
+ * Checks npm registry for newer versions and displays update notification.
+ * Non-blocking, fails silently.
+ */
+/**
+ * Check for updates (non-blocking)
+ */
+export declare function checkForUpdates(): Promise<void>;
+//# sourceMappingURL=update-check.d.ts.map

package/dist/lib/update-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../../src/lib/update-check.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwEH;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAkCrD"}

package/dist/lib/update-check.js

@@ -0,0 +1,114 @@
+/**
+ * Update Check Module
+ *
+ * Checks npm registry for newer versions and displays update notification.
+ * Non-blocking, fails silently.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+const CONFIG_DIR = join(homedir(), '.myceliumail');
+const UPDATE_CACHE = join(CONFIG_DIR, 'update-cache.json');
+const PACKAGE_NAME = 'myceliumail';
+const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24 hours
+/**
+ * Get current installed version from package.json
+ */
+function getCurrentVersion() {
+    try {
+        // Read from the installed package
+        const packagePath = new URL('../package.json', import.meta.url);
+        const pkg = JSON.parse(readFileSync(packagePath, 'utf-8'));
+        return pkg.version;
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+/**
+ * Load update cache
+ */
+function loadCache() {
+    try {
+        if (existsSync(UPDATE_CACHE)) {
+            return JSON.parse(readFileSync(UPDATE_CACHE, 'utf-8'));
+        }
+    }
+    catch {
+        // Ignore
+    }
+    return { lastCheck: 0, latestVersion: null };
+}
+/**
+ * Save update cache
+ */
+function saveCache(cache) {
+    try {
+        if (!existsSync(CONFIG_DIR)) {
+            mkdirSync(CONFIG_DIR, { recursive: true });
+        }
+        writeFileSync(UPDATE_CACHE, JSON.stringify(cache));
+    }
+    catch {
+        // Ignore
+    }
+}
+/**
+ * Compare semantic versions
+ */
+function isNewerVersion(current, latest) {
+    const currentParts = current.split('.').map(Number);
+    const latestParts = latest.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        if ((latestParts[i] || 0) > (currentParts[i] || 0))
+            return true;
+        if ((latestParts[i] || 0) < (currentParts[i] || 0))
+            return false;
+    }
+    return false;
+}
+/**
+ * Check for updates (non-blocking)
+ */
+export async function checkForUpdates() {
+    try {
+        const cache = loadCache();
+        const now = Date.now();
+        // Only check once per day
+        if (now - cache.lastCheck < CHECK_INTERVAL_MS && cache.latestVersion) {
+            showUpdateNotification(cache.latestVersion);
+            return;
+        }
+        // Fetch latest version from npm (with timeout)
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 3000);
+        const response = await fetch(`https://registry.npmjs.org/${PACKAGE_NAME}/latest`, { signal: controller.signal });
+        clearTimeout(timeout);
+        if (!response.ok)
+            return;
+        const data = await response.json();
+        const latestVersion = data.version;
+        // Update cache
+        saveCache({ lastCheck: now, latestVersion });
+        // Show notification if newer
+        showUpdateNotification(latestVersion);
+    }
+    catch {
+        // Silent fail - don't interrupt user
+    }
+}
+/**
+ * Display update notification if newer version available
+ */
+function showUpdateNotification(latestVersion) {
+    const currentVersion = getCurrentVersion();
+    if (isNewerVersion(currentVersion, latestVersion)) {
+        console.log('');
+        console.log('╭─────────────────────────────────────────────╮');
+        console.log(`│  🍄 Update available: ${currentVersion} → ${latestVersion.padEnd(10)}    │`);
+        console.log('│  Run: npm install -g myceliumail            │');
+        console.log('╰─────────────────────────────────────────────╯');
+        console.log('');
+    }
+}
+//# sourceMappingURL=update-check.js.map

package/dist/lib/update-check.js.map

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

package/mcp-server/package-lock.json

@@ -1,12 +1,12 @@
 {
     "name": "myceliumail-mcp",
-    "version": "1.0.11",
+    "version": "1.0.12",
     "lockfileVersion": 3,
     "requires": true,
     "packages": {
         "": {
             "name": "myceliumail-mcp",
-            "version": "1.0.11",
+            "version": "1.0.12",
             "license": "MIT",
             "dependencies": {
                 "@modelcontextprotocol/sdk": "^1.0.0",

package/mcp-server/package.json

@@ -1,6 +1,6 @@
 {
     "name": "myceliumail-mcp",
-    "version": "1.0.11",
+    "version": "1.0.12",
     "description": "MCP server for Myceliumail - End-to-End Encrypted Messaging for AI Agents",
     "type": "module",
     "main": "dist/server.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myceliumail",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "End-to-End Encrypted Messaging for AI Agents",
   "main": "dist/index.js",
   "type": "module",

package/src/bin/myceliumail.ts

@@ -26,6 +26,7 @@ import { createWatchCommand } from '../commands/watch.js';
 import { createExportCommand } from '../commands/export.js';
 import { createStatusCommand } from '../commands/status.js';
 import { createActivateCommand, createLicenseStatusCommand } from '../commands/activate.js';
+import { checkForUpdates } from '../lib/update-check.js';
 
 const program = new Command();
 
@@ -59,6 +60,9 @@ program.addCommand(createStatusCommand());
 program.addCommand(createActivateCommand());
 program.addCommand(createLicenseStatusCommand());
 
+// Check for updates (non-blocking, runs in background)
+checkForUpdates().catch(() => { });
+
 // Parse and run
 program.parse();
 

package/src/lib/update-check.ts

@@ -0,0 +1,131 @@
+/**
+ * Update Check Module
+ * 
+ * Checks npm registry for newer versions and displays update notification.
+ * Non-blocking, fails silently.
+ */
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+
+const CONFIG_DIR = join(homedir(), '.myceliumail');
+const UPDATE_CACHE = join(CONFIG_DIR, 'update-cache.json');
+const PACKAGE_NAME = 'myceliumail';
+const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24 hours
+
+interface UpdateCache {
+    lastCheck: number;
+    latestVersion: string | null;
+}
+
+/**
+ * Get current installed version from package.json
+ */
+function getCurrentVersion(): string {
+    try {
+        // Read from the installed package
+        const packagePath = new URL('../package.json', import.meta.url);
+        const pkg = JSON.parse(readFileSync(packagePath, 'utf-8'));
+        return pkg.version;
+    } catch {
+        return '0.0.0';
+    }
+}
+
+/**
+ * Load update cache
+ */
+function loadCache(): UpdateCache {
+    try {
+        if (existsSync(UPDATE_CACHE)) {
+            return JSON.parse(readFileSync(UPDATE_CACHE, 'utf-8'));
+        }
+    } catch {
+        // Ignore
+    }
+    return { lastCheck: 0, latestVersion: null };
+}
+
+/**
+ * Save update cache
+ */
+function saveCache(cache: UpdateCache): void {
+    try {
+        if (!existsSync(CONFIG_DIR)) {
+            mkdirSync(CONFIG_DIR, { recursive: true });
+        }
+        writeFileSync(UPDATE_CACHE, JSON.stringify(cache));
+    } catch {
+        // Ignore
+    }
+}
+
+/**
+ * Compare semantic versions
+ */
+function isNewerVersion(current: string, latest: string): boolean {
+    const currentParts = current.split('.').map(Number);
+    const latestParts = latest.split('.').map(Number);
+
+    for (let i = 0; i < 3; i++) {
+        if ((latestParts[i] || 0) > (currentParts[i] || 0)) return true;
+        if ((latestParts[i] || 0) < (currentParts[i] || 0)) return false;
+    }
+    return false;
+}
+
+/**
+ * Check for updates (non-blocking)
+ */
+export async function checkForUpdates(): Promise<void> {
+    try {
+        const cache = loadCache();
+        const now = Date.now();
+
+        // Only check once per day
+        if (now - cache.lastCheck < CHECK_INTERVAL_MS && cache.latestVersion) {
+            showUpdateNotification(cache.latestVersion);
+            return;
+        }
+
+        // Fetch latest version from npm (with timeout)
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 3000);
+
+        const response = await fetch(
+            `https://registry.npmjs.org/${PACKAGE_NAME}/latest`,
+            { signal: controller.signal }
+        );
+        clearTimeout(timeout);
+
+        if (!response.ok) return;
+
+        const data = await response.json() as { version: string };
+        const latestVersion = data.version;
+
+        // Update cache
+        saveCache({ lastCheck: now, latestVersion });
+
+        // Show notification if newer
+        showUpdateNotification(latestVersion);
+    } catch {
+        // Silent fail - don't interrupt user
+    }
+}
+
+/**
+ * Display update notification if newer version available
+ */
+function showUpdateNotification(latestVersion: string): void {
+    const currentVersion = getCurrentVersion();
+
+    if (isNewerVersion(currentVersion, latestVersion)) {
+        console.log('');
+        console.log('╭─────────────────────────────────────────────╮');
+        console.log(`│  🍄 Update available: ${currentVersion} → ${latestVersion.padEnd(10)}    │`);
+        console.log('│  Run: npm install -g myceliumail            │');
+        console.log('╰─────────────────────────────────────────────╯');
+        console.log('');
+    }
+}