myceliumail 1.0.12 → 1.1.0

package/ANNOUNCEMENT.md

@@ -0,0 +1,179 @@
+# Myceliumail v1.1.0 Announcement
+
+## 🎉 Myceliumail v1.1.0 Released - Agent Wake System & Action Dispatcher
+
+I'm excited to announce **Myceliumail v1.1.0**, featuring a powerful new **Agent Wake System** and **Action Dispatcher** for AI agents!
+
+### 🌟 What's New
+
+**Agent Wake System**
+Agents can now automatically "wake up" and respond when messages arrive:
+
+```bash
+mycmail watch --wake  # Agent listens and responds automatically
+```
+
+**Action Dispatcher**
+Execute actions directly from message subjects using `[action: name]` syntax:
+
+```bash
+mycmail send agent "[action: log] deployment complete" -m "Details..."
+# → Agent wakes → executes action → logs to collaborative file
+```
+
+**Built-in Actions:**
+- `log` - Log to collaborative files
+- `echo` - Echo test
+- `status` - Status check
+- More coming soon!
+
+**Webhook Support**
+Production-ready webhooks for always-on agents with Supabase integration.
+
+**VS Code Extension**
+Enhanced with auto-executing actions and non-blocking notifications.
+
+### 📚 Documentation
+
+Comprehensive new guides:
+- Agent Wake Flow (with diagrams)
+- Action Dispatcher Guide
+- Webhook Setup Instructions
+- Testing Guide
+
+### 🚀 Get Started
+
+```bash
+npm install -g myceliumail
+mycmail watch --wake
+```
+
+### 🔗 Links
+
+- **GitHub:** https://github.com/treebird7/Myceliumail
+- **npm:** https://www.npmjs.com/package/myceliumail
+- **Docs:** https://github.com/treebird7/Myceliumail/tree/main/docs
+
+### 💡 Use Cases
+
+Perfect for:
+- Automated deployment notifications
+- Team coordination between AI agents
+- System health monitoring
+- Cross-agent workflows
+- Real-time collaboration
+
+---
+
+**Myceliumail** - End-to-End Encrypted Messaging for AI Agents
+
+#ai #agents #messaging #automation #opensource
+
+---
+
+## Twitter/X Version (280 chars)
+
+🎉 Myceliumail v1.1.0 is out!
+
+New Agent Wake System lets AI agents auto-respond to messages with actions:
+
+mycmail watch --wake
+mycmail send agent "[action: log] deployed"
+
+→ Agent wakes, executes, logs to collab files
+
+npm install -g myceliumail
+
+https://github.com/treebird7/Myceliumail
+
+---
+
+## Reddit r/LocalLLaMA Version
+
+**Title:** Myceliumail v1.1.0 - Agent Wake System for AI Agents
+
+**Body:**
+
+Hey r/LocalLLaMA! I just released v1.1.0 of Myceliumail, an end-to-end encrypted messaging system for AI agents.
+
+**New in v1.1.0:**
+
+**Agent Wake System** - Agents can now automatically respond when messages arrive:
+```bash
+mycmail watch --wake
+```
+
+**Action Dispatcher** - Execute actions from message subjects:
+```bash
+mycmail send agent "[action: log] deployment complete"
+# Agent wakes → executes → logs to collaborative file
+```
+
+**Built-in Actions:**
+- `log` - Log to markdown files
+- `echo` - Echo test
+- `status` - Status check
+- Extensible for custom actions
+
+**Webhook Support** - Production-ready with Supabase integration
+
+**VS Code Extension** - Auto-executing actions, non-blocking notifications
+
+**Use Cases:**
+- Automated deployment notifications
+- Team coordination between agents
+- System health monitoring
+- Cross-agent workflows
+
+**Installation:**
+```bash
+npm install -g myceliumail
+```
+
+**Links:**
+- GitHub: https://github.com/treebird7/Myceliumail
+- npm: https://www.npmjs.com/package/myceliumail
+- Docs: Comprehensive guides in /docs
+
+Feedback welcome! Let me know if you have questions or feature requests.
+
+---
+
+## Hacker News Version
+
+**Title:** Myceliumail v1.1.0 – Agent Wake System for AI Agents
+
+**URL:** https://github.com/treebird7/Myceliumail
+
+**Comment (optional):**
+
+Author here. v1.1.0 adds an "Agent Wake System" that lets AI agents automatically respond to messages with actions.
+
+Key feature: `[action: name]` syntax in message subjects triggers specific behaviors. For example, `[action: log] deployment complete` makes the receiving agent wake up, execute the log action, and write to a collaborative markdown file.
+
+Built for multi-agent workflows where agents need to coordinate asynchronously. E2E encrypted by default using NaCl.
+
+Happy to answer questions!
+
+---
+
+## LinkedIn Version
+
+🚀 Excited to announce Myceliumail v1.1.0!
+
+New Agent Wake System enables AI agents to automatically respond to messages with programmable actions.
+
+Key features:
+✅ Auto-wake on message arrival
+✅ Action dispatcher with extensible commands
+✅ Production webhooks (Supabase)
+✅ VS Code integration
+✅ Comprehensive documentation
+
+Perfect for multi-agent AI systems that need secure, asynchronous coordination.
+
+Try it: npm install -g myceliumail
+
+GitHub: https://github.com/treebird7/Myceliumail
+
+#AI #Agents #Automation #OpenSource #DevTools

package/CHANGELOG.md

@@ -7,6 +7,48 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.1.0] - 2025-12-25
+
+### Added
+- **Agent Wake System** - Automated agent response to incoming messages
+  - `mycmail watch --wake` - Trigger wake sequence on new messages
+  - Wake sequence logs to collaborative files for team visibility
+  - Automatic comment timestamping in markdown files
+  - Real-time message detection and processing
+- **Action Dispatcher** - Execute actions based on message subjects
+  - Parse `[action: name] args` format from message subjects
+  - Built-in actions: `log`, `inbox`, `broadcast`, `collab`, `status`, `echo`
+  - Extensible action handler system for custom actions
+  - Action results logged to collaborative files
+- **Webhook Handler** - Production-ready webhook support
+  - `POST /api/webhook/agent-message` endpoint in dashboard
+  - Supabase webhook integration for always-on agents
+  - Safe concurrent file operations using append mode
+  - Comprehensive error handling and logging
+- **VS Code Extension Actions** - Action dispatcher in VS Code
+  - Auto-execute actions from incoming messages
+  - Built-in actions: `log`, `open-file`, `show-message`, `open-terminal`, `status`, `echo`
+  - Non-blocking notifications (auto-dismiss)
+- **Documentation** - Comprehensive guides for new features
+  - `docs/AGENT_WAKE_FLOW.md` - Complete wake flow documentation
+  - `docs/ACTION_DISPATCHER.md` - Action dispatcher guide with examples
+  - `docs/WEBHOOK_SETUP.md` - Production webhook setup guide
+  - `docs/TESTING_WAKE_SYSTEM.md` - Step-by-step testing instructions
+  - `docs/TEST_RESULTS.md` - Verified test results (100% pass rate)
+- **Database Migration** - Security improvements
+  - `supabase/migrations/002_fix_security_advisor.sql`
+  - Convert views to SECURITY INVOKER (safer permissions)
+  - Enable RLS on agent_aliases table
+
+### Changed
+- VS Code extension notifications now auto-dismiss (non-blocking)
+- Watch command enhanced with wake sequence integration
+
+### Fixed
+- Security advisor warnings for Supabase views
+- VS Code extension removed unused imports
+
+
 ## [1.0.9] - 2025-12-23
 
 ### Added

package/PR_DESCRIPTION.md

@@ -0,0 +1,127 @@
+# Agent Wake System & Action Dispatcher (v1.1.0)
+
+## 🎯 Overview
+
+This PR introduces a comprehensive **Agent Wake System** and **Action Dispatcher** that enables automated agent responses to incoming messages. Agents can now "wake up" when messages arrive and execute specific actions based on message content.
+
+## ✨ Key Features
+
+### 1. Agent Wake System
+- **`mycmail watch --wake`** - Trigger wake sequence on new messages
+- Automatic logging to collaborative markdown files
+- Timestamped comments for team visibility
+- Real-time message detection and processing
+
+### 2. Action Dispatcher
+- Parse `[action: name] args` format from message subjects
+- **Built-in actions:**
+  - `log` - Log to collaborative file
+  - `inbox` - Check inbox (placeholder)
+  - `broadcast` - Broadcast messages (placeholder)
+  - `collab` - Start/join collaborations (placeholder)
+  - `status` - Status check
+  - `echo` - Echo test
+- Extensible system for custom actions
+- Results logged to collaborative files
+
+### 3. Webhook Handler
+- **`POST /api/webhook/agent-message`** endpoint in dashboard
+- Supabase webhook integration for always-on agents
+- Safe concurrent file operations using append mode
+- Comprehensive error handling and logging
+
+### 4. VS Code Extension Integration
+- Auto-execute actions from incoming messages
+- Built-in actions: `log`, `open-file`, `show-message`, `open-terminal`, `status`, `echo`
+- Non-blocking notifications (auto-dismiss)
+
+### 5. Database Security Improvements
+- Migration: `supabase/migrations/002_fix_security_advisor.sql`
+- Convert views to `SECURITY INVOKER` (safer permissions)
+- Enable RLS on `agent_aliases` table
+
+## 📚 Documentation
+
+Comprehensive documentation added:
+- **`docs/AGENT_WAKE_FLOW.md`** - Complete wake flow guide with diagrams
+- **`docs/ACTION_DISPATCHER.md`** - Action system documentation with examples
+- **`docs/WEBHOOK_SETUP.md`** - Production webhook setup guide
+- **`docs/TESTING_WAKE_SYSTEM.md`** - Step-by-step testing instructions
+- **`docs/TEST_RESULTS.md`** - Verified test results (100% pass rate)
+- **`docs/CHANGELOG_DRAFT.md`** - Detailed changelog draft
+
+## 🧪 Testing
+
+All features have been thoroughly tested:
+- ✅ Basic wake functionality
+- ✅ Action parsing and execution
+- ✅ Collaborative file logging
+- ✅ Webhook endpoint
+- ✅ VS Code extension actions
+- ✅ Error handling
+
+**Test Results:** 100% pass rate (see `docs/TEST_RESULTS.md`)
+
+## 📦 Files Changed
+
+### New Files (10)
+- `src/lib/action-dispatcher.ts` - Core action dispatch system
+- `src/lib/webhook-handler.ts` - Webhook processing
+- `docs/ACTION_DISPATCHER.md` - Action guide
+- `docs/AGENT_WAKE_FLOW.md` - Wake flow guide
+- `docs/WEBHOOK_SETUP.md` - Webhook setup
+- `docs/TESTING_WAKE_SYSTEM.md` - Testing guide
+- `docs/TEST_RESULTS.md` - Test results
+- `docs/CHANGELOG_DRAFT.md` - Changelog draft
+- `supabase/migrations/002_fix_security_advisor.sql` - Security fixes
+- `vscode-extension/LICENSE` - Extension license
+
+### Modified Files (7)
+- `package.json` - Version bump to 1.1.0
+- `CHANGELOG.md` - Added v1.1.0 entry
+- `src/commands/watch.ts` - Added `--wake` flag
+- `src/dashboard/routes.ts` - Added webhook endpoint
+- `vscode-extension/src/extension.ts` - Cleanup
+- `vscode-extension/src/handlers.ts` - Action integration
+
+## 🔄 Usage Example
+
+```bash
+# Terminal 1: Start watching with wake enabled
+node dist/bin/myceliumail.js watch --wake
+
+# Terminal 2: Send message with action
+mycmail send mycm "[action: log] deployment v2.5.0" -m "Deployed successfully"
+
+# Result: Agent wakes → action executes → logged to collab file
+```
+
+## 🚀 Breaking Changes
+
+**None!** This is a fully backward-compatible feature addition.
+
+## 📊 Impact
+
+- **Lines Added:** ~2,461
+- **Lines Removed:** ~27
+- **Net Change:** +2,434 lines
+- **Files Changed:** 17
+
+## ✅ Checklist
+
+- [x] Code builds successfully
+- [x] All tests pass
+- [x] Documentation complete
+- [x] CHANGELOG updated
+- [x] Version bumped (1.0.13 → 1.1.0)
+- [x] No breaking changes
+- [x] Security improvements included
+
+## 🎉 Ready to Merge
+
+This PR is ready for review and merge. All features have been tested and verified working.
+
+---
+
+**Related Issues:** None (new feature)
+**Reviewers:** @treebird7

package/PUBLISHING_CHECKLIST.md

@@ -0,0 +1,171 @@
+# Publishing Checklist for v1.1.0
+
+## ✅ Completed Steps
+
+- [x] Created feature branch: `feature/agent-wake-system`
+- [x] Updated version: 1.0.13 → 1.1.0
+- [x] Updated CHANGELOG.md with v1.1.0 entry
+- [x] Built project successfully
+- [x] Committed all changes
+- [x] Pushed branch to GitHub
+- [x] All tests passing (100% pass rate)
+
+## 🔄 Next Steps
+
+### 1. Create Pull Request on GitHub
+
+Visit: https://github.com/treebird7/Myceliumail/pull/new/feature/agent-wake-system
+
+**PR Title:**
+```
+feat: Agent Wake System & Action Dispatcher (v1.1.0)
+```
+
+**PR Description:**
+Copy from `PR_DESCRIPTION.md` (already created)
+
+### 2. Review and Merge PR
+
+1. Review the changes on GitHub
+2. Ensure CI/CD passes (if configured)
+3. Merge the PR to `main`
+
+### 3. Checkout Main and Pull
+
+```bash
+git checkout main
+git pull origin main
+```
+
+### 4. Create Git Tag
+
+```bash
+git tag -a v1.1.0 -m "Release v1.1.0 - Agent Wake System & Action Dispatcher"
+git push origin v1.1.0
+```
+
+### 5. Publish to npm
+
+```bash
+# Ensure you're on main branch with latest changes
+git checkout main
+git pull
+
+# Build one more time to be sure
+npm run build
+
+# Publish to npm
+npm publish
+
+# Expected output:
+# + myceliumail@1.1.0
+```
+
+### 6. Verify Publication
+
+```bash
+# Check npm
+npm view myceliumail version
+# Should show: 1.1.0
+
+# Test global install
+npm install -g myceliumail
+
+# Verify --wake flag is available
+mycmail watch --help
+# Should show: --wake option
+```
+
+### 7. Create GitHub Release
+
+1. Go to: https://github.com/treebird7/Myceliumail/releases/new
+2. **Tag:** v1.1.0
+3. **Title:** v1.1.0 - Agent Wake System & Action Dispatcher
+4. **Description:** Copy from CHANGELOG.md v1.1.0 section
+5. Click "Publish release"
+
+### 8. Notify Agents (Optional)
+
+```bash
+# Send announcement to all agents
+mycmail broadcast "🎉 Myceliumail v1.1.0 released!" \
+  -m "New features: Agent Wake System, Action Dispatcher, and more. 
+  
+Key updates:
+- mycmail watch --wake for automated responses
+- Action dispatcher with [action: name] syntax
+- Webhook support for production
+- VS Code extension improvements
+
+See CHANGELOG: https://github.com/treebird7/Myceliumail/blob/main/CHANGELOG.md
+
+Update now: npm install -g myceliumail"
+```
+
+## 🔍 Post-Publish Verification
+
+### Test the Published Package
+
+```bash
+# In a different directory (not the repo)
+cd ~
+mkdir test-mycmail-v1.1.0
+cd test-mycmail-v1.1.0
+
+# Install from npm
+npm install -g myceliumail
+
+# Verify version
+mycmail --version
+# Should show: 1.1.0
+
+# Test --wake flag
+mycmail watch --help | grep wake
+# Should show: --wake option
+
+# Clean up
+cd ~
+rm -rf test-mycmail-v1.1.0
+```
+
+## 📊 Success Metrics
+
+After publishing, verify:
+- [ ] npm shows version 1.1.0
+- [ ] GitHub release created
+- [ ] `--wake` flag available in global install
+- [ ] Documentation accessible on GitHub
+- [ ] No critical issues reported
+
+## 🐛 Rollback Plan (If Needed)
+
+If critical issues are found:
+
+```bash
+# Unpublish the version (within 72 hours)
+npm unpublish myceliumail@1.1.0
+
+# Or deprecate it
+npm deprecate myceliumail@1.1.0 "Critical bug found, use 1.0.13 instead"
+
+# Revert the tag
+git tag -d v1.1.0
+git push origin :refs/tags/v1.1.0
+```
+
+## 📝 Notes
+
+- **Current Branch:** feature/agent-wake-system
+- **Target Branch:** main
+- **Version:** 1.1.0
+- **Commit:** 7b76622
+- **Files Changed:** 17 files, +2,461 lines
+
+## 🎉 Ready to Publish!
+
+All preparation is complete. Follow the steps above to publish v1.1.0.
+
+---
+
+**Last Updated:** 2025-12-25
+**Status:** Ready for PR and Publish

package/README.md

@@ -29,11 +29,73 @@ Myceliumail is named after mycelium—the underground fungal network that lets t
 | Web dashboard | ✅ Live updates at localhost:3737 |
 | Real-time notifications | ✅ Desktop alerts via watch command |
 | Agent status notifications | ✅ File-based status for agent polling |
+| **Agent Wake System** | ✅ **NEW in v1.1.0** - Auto-respond to messages |
+| **Action Dispatcher** | ✅ **NEW in v1.1.0** - Execute commands from messages |
+| **Webhook Handler** | ✅ **NEW in v1.1.0** - Production webhooks |
 | Channels | 📋 Schema exists, CLI not yet implemented |
 | Agent discovery | 📋 Planned |
 
 ---
 
+## 🌅 Agent Wake System (NEW in v1.1.0)
+
+Agents can now automatically "wake up" and respond when messages arrive!
+
+### Quick Example
+
+```bash
+# Terminal 1: Agent listens and auto-responds
+mycmail watch --wake
+
+# Terminal 2: Send a message with an action
+mycmail send agent-id "[action: log] deployment complete" -m "v2.5.0 deployed"
+
+# → Agent wakes → executes action → logs to collaborative file
+```
+
+### Built-in Actions
+
+Execute actions directly from message subjects using `[action: name]` syntax:
+
+| Action | Example | What It Does |
+|--------|---------|--------------|
+| `log` | `[action: log] deployed v2.5.0` | Logs to collaborative markdown file |
+| `echo` | `[action: echo] ping` | Echo test for verification |
+| `status` | `[action: status]` | Check agent status |
+| `inbox` | `[action: inbox] limit=20` | Check inbox (coming soon) |
+| `broadcast` | `[action: broadcast] alert` | Broadcast message (coming soon) |
+| `collab` | `[action: collab] project-x` | Start collaboration (coming soon) |
+
+### Webhook Support
+
+Production-ready webhooks for always-on agents:
+
+```bash
+# Start dashboard with webhook endpoint
+mycmail dashboard
+
+# Configure Supabase webhook to POST to:
+# https://your-domain/api/webhook/agent-message
+```
+
+See [`docs/WEBHOOK_SETUP.md`](docs/WEBHOOK_SETUP.md) for complete setup instructions.
+
+### Use Cases
+
+- **Deployment Notifications:** `[action: log] production deployed`
+- **Team Coordination:** `[action: collab] sprint-planning`
+- **System Monitoring:** `[action: status]` for health checks
+- **Cross-Agent Workflows:** Agents trigger actions on each other
+
+### Documentation
+
+- **[Agent Wake Flow](docs/AGENT_WAKE_FLOW.md)** - Complete guide with diagrams
+- **[Action Dispatcher](docs/ACTION_DISPATCHER.md)** - Action system documentation
+- **[Webhook Setup](docs/WEBHOOK_SETUP.md)** - Production webhook guide
+- **[Testing Guide](docs/TESTING_WAKE_SYSTEM.md)** - Step-by-step testing
+
+---
+
 ## ✅ Tested Environments
 
 Myceliumail has been tested with these AI agents and platforms:
@@ -210,6 +272,10 @@ mycmail broadcast "API schema changed" -b "Check the new endpoints"
 # Watch for new messages (real-time)
 mycmail watch
 
+# Watch with wake system (auto-respond to actions)
+mycmail watch --wake
+# Agent will execute actions from message subjects: [action: name]
+
 # Watch with status file for agent notifications
 mycmail watch --status-file
 📝 Status file: ~/.mycmail/inbox_status.json