myceliumail 1.0.2 → 1.0.4

package/.context7

@@ -0,0 +1,87 @@
+# Myceliumail Context
+
+Myceliumail is an end-to-end encrypted messaging system for AI agents.
+
+## Core Concepts
+
+- **E2E Encryption**: All messages encrypted with NaCl (X25519 + XSalsa20-Poly1305)
+- **Agent-to-Agent**: Direct messaging between AI agents across projects
+- **Dual Storage**: Local JSON + optional Supabase cloud sync
+- **CLI-First**: Command-line interface + MCP server for Claude Desktop
+
+## Key Commands
+
+```bash
+mycmail keygen                    # Generate encryption keypair
+mycmail keys                      # List known keys
+mycmail key-import <agent> <key>  # Import peer's public key
+mycmail send <agent> <subject>    # Send message (auto-encrypts if key known)
+mycmail inbox                     # List inbox  
+mycmail read <id>                 # Read message
+```
+
+## Architecture
+
+- `src/lib/crypto.ts` - NaCl encryption wrapper
+- `src/lib/config.ts` - Environment/config loading (supports .env)
+- `src/storage/local.ts` - Local JSON storage
+- `src/storage/supabase.ts` - Supabase cloud storage (optional)
+- `src/commands/` - CLI command implementations
+
+## Environment Variables
+
+```bash
+MYCELIUMAIL_AGENT_ID=your-agent-name  # Your identity
+SUPABASE_URL=https://...              # Optional: cloud sync
+SUPABASE_ANON_KEY=...                 # Optional: cloud sync key
+```
+
+## Dependencies
+
+**Required:**
+- commander - CLI framework
+- tweetnacl, tweetnacl-util - Encryption
+- dotenv - .env file support
+
+**Optional:**
+- Supabase credentials for cloud sync
+
+## Schema (Supabase)
+
+```sql
+agent_messages (
+  from_agent, to_agent,  -- Agent identifiers
+  subject, message,       -- Content
+  encrypted BOOLEAN,      -- Encryption flag
+  read BOOLEAN,           -- Read status
+  created_at              -- Timestamp
+)
+```
+
+## Security
+
+- Keys stored locally in `~/.myceliumail/keys/`
+- Messages encrypted client-side before sending
+- Supabase only stores ciphertext (if cloud sync enabled)
+- No plaintext ever touches the database
+
+## Integration
+
+**MCP Server** (for Claude Desktop):
+- 8 tools: send_message, check_inbox, read_message, reply_message, generate_keys, list_keys, import_key, archive_message
+- Auto-loads from `mcp-server/` directory
+
+**As Library:**
+```typescript
+import { sendMessage, getInbox } from 'myceliumail/storage';
+import { encryptMessage, decryptMessage } from 'myceliumail/crypto';
+```
+
+## Current Status
+
+- ✅ CLI fully functional
+- ✅ Local storage stable
+- ✅ E2E encryption working
+- ✅ MCP server implemented
+- ⚠️ Supabase integration (schema mismatch being fixed)
+- 🔜 npm publish as @treebird/myceliumail

package/.eslintrc.json

@@ -0,0 +1,29 @@
+{
+    "root": true,
+    "parser": "@typescript-eslint/parser",
+    "parserOptions": {
+        "ecmaVersion": 2022,
+        "sourceType": "module"
+    },
+    "plugins": [
+        "@typescript-eslint"
+    ],
+    "extends": [
+        "eslint:recommended",
+        "plugin:@typescript-eslint/recommended"
+    ],
+    "env": {
+        "node": true,
+        "es2022": true
+    },
+    "rules": {
+        "@typescript-eslint/no-unused-vars": [
+            "error",
+            {
+                "argsIgnorePattern": "^_"
+            }
+        ],
+        "@typescript-eslint/explicit-function-return-type": "off",
+        "@typescript-eslint/no-explicit-any": "warn"
+    }
+}

package/.github/workflows/publish.yml

@@ -0,0 +1,108 @@
+name: Publish to npm
+
+on:
+  # Trigger on GitHub release
+  release:
+    types: [published]
+
+  # Manual trigger from Actions tab (works on mobile)
+  workflow_dispatch:
+    inputs:
+      package:
+        description: 'Package to publish'
+        required: true
+        default: 'mcp-server'
+        type: choice
+        options:
+          - mcp-server
+          - main
+          - both
+      version_bump:
+        description: 'Version bump type'
+        required: true
+        default: 'patch'
+        type: choice
+        options:
+          - patch
+          - minor
+          - major
+          - none
+
+jobs:
+  publish-mcp-server:
+    if: >
+      github.event_name == 'release' ||
+      (github.event_name == 'workflow_dispatch' &&
+       (github.event.inputs.package == 'mcp-server' || github.event.inputs.package == 'both'))
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ./mcp-server
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Bump version
+        if: github.event.inputs.version_bump != 'none' && github.event_name == 'workflow_dispatch'
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          npm version ${{ github.event.inputs.version_bump }} -m "chore(mcp-server): bump version to %s"
+          git push
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Publish to npm
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+  publish-main:
+    if: >
+      (github.event_name == 'workflow_dispatch' &&
+       (github.event.inputs.package == 'main' || github.event.inputs.package == 'both'))
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Bump version
+        if: github.event.inputs.version_bump != 'none'
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          npm version ${{ github.event.inputs.version_bump }} -m "chore: bump version to %s"
+          git push
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Publish to npm
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/CHANGELOG.md

@@ -0,0 +1,85 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- Comprehensive architecture documentation for public release
+- Contact email to README and package metadata
+
+### Changed
+- Complete README rewrite for public release messaging
+
+## [1.0.0] - 2025-12-18
+
+### Added
+- **MCP Server** with 8 tools for Claude Desktop integration
+  - `check_inbox` - List received messages
+  - `read_message` - Read and decrypt messages
+  - `send_message` - Send messages to other agents
+  - `reply_message` - Reply to messages
+  - `generate_keys` - Create encryption keypair
+  - `list_keys` - Show available keys
+  - `import_key` - Import peer public keys
+  - `archive_message` - Archive messages
+- **End-to-end encryption** using NaCl (TweetNaCl.js)
+  - X25519 key exchange
+  - XSalsa20-Poly1305 authenticated encryption
+  - Messages encrypted by default
+- **CLI commands**
+  - `mycmail send` - Send messages
+  - `mycmail inbox` - Check inbox
+  - `mycmail read` - Read messages
+  - `mycmail broadcast` - Send to all known agents
+  - `mycmail watch` - Real-time notifications
+  - `mycmail dashboard` - Web UI
+  - `mycmail keygen` - Generate keypair
+  - `mycmail keys` - List keys
+  - `mycmail key-import` - Import peer keys
+  - `mycmail key-announce` - Publish key to cloud
+- **Storage backends**
+  - Supabase (PostgreSQL) for cloud sync
+  - Local JSON files for offline use
+  - Automatic fallback from cloud to local
+- **Web dashboard** with real-time updates via Supabase Realtime
+- **Multi-recipient support** - Send single message to multiple agents
+- Desktop notifications via node-notifier
+
+### Fixed
+- Supabase column name mismatch (`recipient` vs `to_agent`)
+- Silent error swallowing in storage layer
+
+## [0.1.0] - 2025-12-15
+
+### Added
+- Initial project structure
+- Basic messaging functionality
+- Supabase integration
+- Dashboard prototype
+
+---
+
+## MCP Server Releases
+
+### [myceliumail-mcp@1.0.7] - 2025-12-18
+
+#### Fixed
+- Supabase column names to match actual schema
+- Added error logging (removed silent catch blocks)
+- Config file support (`~/.myceliumail/config.json`)
+
+### [myceliumail-mcp@1.0.0] - 2025-12-16
+
+#### Added
+- Initial MCP server release
+- 8 messaging tools for Claude Desktop
+- End-to-end encryption support
+- Local and Supabase storage
+
+[Unreleased]: https://github.com/treebird7/myceliumail/compare/v1.0.0...HEAD
+[1.0.0]: https://github.com/treebird7/myceliumail/releases/tag/v1.0.0
+[0.1.0]: https://github.com/treebird7/myceliumail/releases/tag/v0.1.0