dooray-mail-cli 0.1.2 → 0.2.0

package/README.md

@@ -1,19 +1,112 @@
-# Dooray OpenClaw Skill
+# Dooray Mail CLI
+
+[![npm version](https://img.shields.io/npm/v/dooray-mail-cli.svg)](https://www.npmjs.com/package/dooray-mail-cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 Dooray mail CLI for OpenClaw - IMAP/SMTP integration
 
-## Installation
+## 🚀 Installation
 
 ```bash
-npm install -g .
+npm install -g dooray-mail-cli
 ```
 
-## Usage
+## 📖 Usage
 
+### Setup
 ```bash
-dooray-cli config  # Setup
-dooray-cli recent  # List recent mails
-dooray-cli test    # Test connection
+dooray-cli config  # Configure email account
 ```
 
-See `SKILL.md` for OpenClaw integration.
+### Check Emails
+```bash
+dooray-cli recent  # List 10 recent mails
+dooray-cli list    # List unread mails only
+dooray-cli read 123  # Read specific mail by UID
+```
+
+### Send & Reply
+```bash
+dooray-cli send --to "user@example.com" --subject "Hello" --body "Message"
+dooray-cli send --to "user@example.com" --subject "Hello" --body "Message" --cc "cc@example.com" --attach "./file.pdf"
+dooray-cli send --to "user@example.com" --subject "Hello" --html "<h1>Title</h1>"
+dooray-cli reply 123 --body "Thank you!"  # Reply to mail UID 123
+dooray-cli forward 123 --to "another@example.com" --body "FYI"
+```
+
+### Manage Emails
+```bash
+dooray-cli delete 123        # Move to trash
+dooray-cli delete 123 --force  # Permanently delete
+dooray-cli mark 123 --read   # Mark as read
+dooray-cli mark 123 --unread # Mark as unread
+```
+
+### Attachments
+```bash
+dooray-cli attachments 123          # List attachments
+dooray-cli download 123             # Download all
+dooray-cli download 123 --file 1    # Download specific file
+dooray-cli download 123 --output ./my-files  # Custom output path
+```
+
+### Search with Filters
+```bash
+dooray-cli search "keyword"  # Search by keyword
+dooray-cli search "meeting" --from "boss@example.com"  # Filter by sender
+dooray-cli search "report" --since "2026-01-01"        # Filter by date
+dooray-cli search "invoice" --before "2026-02-01"      # Before date
+```
+
+### Other Commands
+```bash
+dooray-cli unread  # Show unread count
+dooray-cli test    # Test IMAP/SMTP connection
+dooray-cli help    # Show all commands
+```
+
+## 🔧 Features
+
+- ✅ IMAP/SMTP mail operations
+- ✅ Read/Send/Reply/Forward emails
+- ✅ **Email threading support** (Reply with In-Reply-To headers)
+- ✅ **CC/BCC support** (v0.2.0+)
+- ✅ **HTML mail support** (v0.2.0+)
+- ✅ **Attachments management** (List & Download) (v0.1.3+)
+- ✅ **Send with attachments** (v0.2.0+)
+- ✅ **Delete & Mark as read/unread** (v0.2.0+)
+- ✅ **Advanced search filters** (Date, Sender) (v0.2.0+)
+- ✅ AES-256 password encryption
+- ✅ Cross-platform (Windows, macOS, Linux)
+- ✅ OpenClaw Skill integration
+
+## 📋 Requirements
+
+- Node.js 14+
+- Dooray email account with IMAP/SMTP access
+
+**Default Dooray Settings:**
+- IMAP: `imap.dooray.com:993` (SSL)
+- SMTP: `smtp.dooray.com:465` (SSL)
+
+## 🔒 Security
+
+- Passwords are encrypted with AES-256
+- Configuration stored locally: `~/.dooray-config.json`
+- Mail cache for replies: `~/.dooray-mail-cache.json`
+
+## 📚 Documentation
+
+See [SKILL.md](./SKILL.md) for detailed command reference and OpenClaw integration guide.
+
+## 📝 License
+
+MIT
+
+## 🤝 Contributing
+
+Issues and pull requests are welcome!
+
+## 📦 Package
+
+- npm: https://www.npmjs.com/package/dooray-mail-cli

package/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: dooray
-description: "Manage Dooray emails via IMAP/SMTP using the dooray-cli command. List, read, send, and search emails from the terminal. Use when working with Dooray email, checking Dooray inbox, or when the user mentions Dooray mail operations."
+description: "Complete Dooray email management via IMAP/SMTP using dooray-cli. Features: List/Read/Send/Reply/Forward emails, CC/BCC support, HTML mail, attachments (download & send), delete, mark read/unread, advanced search (date, sender filters). Use for any Dooray mail operations."
 homepage: https://dooray.com
 metadata:
   {
@@ -146,13 +146,144 @@ dooray-cli reply 123
    - Include proper email threading headers (In-Reply-To, References)
    - Appear in the same conversation thread in email clients
 
-### Search Emails
+### Forward an Email
 
-Search for emails by keywords in subject:
+Forward an existing email to another recipient:
+
+```bash
+dooray-cli forward 123 --to "colleague@example.com" --body "Please see below"
+```
+
+Features:
+- Automatically includes original email content
+- Preserves original attachments
+- Adds "Fwd:" prefix to subject (if not already present)
+
+### Delete Emails
+
+**Move to trash:**
+
+```bash
+dooray-cli delete 123
+```
+
+**Permanently delete:**
+
+```bash
+dooray-cli delete 123 --force
+```
+
+### Mark as Read/Unread
+
+**Mark as read:**
+
+```bash
+dooray-cli mark 123 --read
+```
+
+**Mark as unread:**
+
+```bash
+dooray-cli mark 123 --unread
+```
+
+### Send with Advanced Options
+
+**Send with CC/BCC:**
+
+```bash
+dooray-cli send --to "user@example.com" --subject "Hello" --body "Message" --cc "cc@example.com" --bcc "bcc@example.com"
+```
+
+**Send HTML email:**
+
+```bash
+dooray-cli send --to "user@example.com" --subject "Newsletter" --html "<h1>Title</h1><p>Content</p>"
+```
+
+**Send with attachments:**
+
+```bash
+dooray-cli send --to "user@example.com" --subject "Report" --body "Please find attached" --attach "./report.pdf" --attach "./data.xlsx"
+```
+
+**Combine all options:**
+
+```bash
+dooray-cli send --to "user@example.com" --subject "Q4 Report" --body "Please review" --cc "boss@example.com" --attach "./report.pdf"
+```
+
+### Manage Attachments
+
+**List attachments in an email:**
+
+```bash
+dooray-cli attachments 123
+```
+
+Output:
+```
+📎 Attachments (3)
+
+1. document.pdf
+   Type: application/pdf
+   Size: 245.50 KB
+
+2. image.png
+   Type: image/png
+   Size: 128.34 KB
+```
+
+**Download all attachments:**
+
+```bash
+dooray-cli download 123
+```
+
+Files are saved to: `./downloads/mail-123/`
+
+**Download specific attachment:**
+
+```bash
+dooray-cli download 123 --file 1
+```
+
+Downloads only the first attachment.
+
+**Custom download path:**
+
+```bash
+dooray-cli download 123 --output ./my-files
+```
+
+Files are saved to: `./my-files/mail-123/`
+
+### Search Emails with Filters
+
+**Search by keywords:**
 
 ```bash
 dooray-cli search "meeting"
-dooray-cli search "project" "update"
+dooray-cli search "project update"
+```
+
+**Filter by sender:**
+
+```bash
+dooray-cli search "report" --from "boss@example.com"
+```
+
+**Filter by date range:**
+
+```bash
+dooray-cli search "invoice" --since "2026-01-01"
+dooray-cli search "receipt" --before "2026-02-01"
+```
+
+**Combine filters:**
+
+```bash
+dooray-cli search "meeting" --from "boss@example.com" --since "2026-02-01"
 ```
 
 ### Check Unread Count

package/dist/mail-client.js

@@ -218,6 +218,65 @@ class DoorayMailClient {
             return null;
         }
     }
+    /**
+     * 메일 삭제 (휴지통으로 이동 또는 영구 삭제)
+     */
+    async deleteMail(uid, permanent = false) {
+        let connection;
+        try {
+            connection = await this.getImapConnection();
+            await connection.openBox('INBOX');
+            
+            if (permanent) {
+                // 영구 삭제
+                await connection.addFlags([uid], ['\\Deleted']);
+                await connection.imap.expunge();
+                console.log('[Dooray] Mail permanently deleted:', uid);
+            } else {
+                // 휴지통으로 이동 (\\Deleted 플래그만 추가)
+                await connection.addFlags([uid], ['\\Deleted']);
+                console.log('[Dooray] Mail moved to trash:', uid);
+            }
+            
+            connection.end();
+            return { success: true };
+        }
+        catch (error) {
+            const err = error;
+            console.error('[Dooray] Failed to delete mail:', err.message);
+            if (connection)
+                connection.end();
+            return { success: false };
+        }
+    }
+    /**
+     * 메일 읽음/안읽음 표시 변경
+     */
+    async markMail(uid, asRead) {
+        let connection;
+        try {
+            connection = await this.getImapConnection();
+            await connection.openBox('INBOX');
+            
+            if (asRead) {
+                await connection.addFlags([uid], ['\\Seen']);
+                console.log('[Dooray] Mail marked as read:', uid);
+            } else {
+                await connection.delFlags([uid], ['\\Seen']);
+                console.log('[Dooray] Mail marked as unread:', uid);
+            }
+            
+            connection.end();
+            return { success: true };
+        }
+        catch (error) {
+            const err = error;
+            console.error('[Dooray] Failed to mark mail:', err.message);
+            if (connection)
+                connection.end();
+            return { success: false };
+        }
+    }
     /**
      * 메일 발송
      */
@@ -271,24 +330,58 @@ class DoorayMailClient {
         }
     }
     /**
-     * 메일 검색
+     * 메일 검색 (키워드, 날짜, 발신자 필터 지원)
      */
-    async searchMail(query, limit = 10) {
+    async searchMail(keywords, options = {}, limit = 10) {
         let connection;
         try {
             connection = await this.getImapConnection();
             await connection.openBox('INBOX');
-            // IMAP SEARCH: 제목이나 본문에서 검색
-            const searchCriteria = [
-                'OR',
-                ['SUBJECT', query],
-                ['BODY', query]
-            ];
+            
+            // 검색 조건 생성
+            const searchParts = [];
+            
+            // 키워드 검색 (제목 또는 본문)
+            if (keywords && keywords.length > 0) {
+                const keywordStr = Array.isArray(keywords) ? keywords.join(' ') : keywords;
+                if (keywordStr.trim()) {
+                    searchParts.push(['OR', ['SUBJECT', keywordStr], ['BODY', keywordStr]]);
+                }
+            }
+            
+            // 발신자 필터
+            if (options.from) {
+                searchParts.push(['FROM', options.from]);
+            }
+            
+            // 날짜 필터 (since)
+            if (options.since) {
+                const sinceDate = new Date(options.since);
+                searchParts.push(['SINCE', sinceDate]);
+            }
+            
+            // 날짜 필터 (before)
+            if (options.before) {
+                const beforeDate = new Date(options.before);
+                searchParts.push(['BEFORE', beforeDate]);
+            }
+            
+            // 검색 조건이 없으면 모든 메일 반환
+            let searchCriteria;
+            if (searchParts.length === 0) {
+                searchCriteria = ['ALL'];
+            } else if (searchParts.length === 1) {
+                searchCriteria = searchParts[0];
+            } else {
+                searchCriteria = ['AND', ...searchParts];
+            }
+            
             const fetchOptions = {
                 bodies: ['HEADER', 'TEXT', ''],
                 struct: true
             };
             const messages = await connection.search(searchCriteria, fetchOptions);
+            
             // 최신 메일부터 limit개만
             const limitedMessages = messages.slice(0, limit);
             const parsedMails = [];
@@ -337,6 +430,12 @@ class DoorayMailClient {
                 receivedAt: parsed.date?.toISOString() || new Date().toISOString(),
                 isRead: flags.includes('\\Seen'),
                 hasAttachments: (parsed.attachments?.length || 0) > 0,
+                attachments: (parsed.attachments || []).map((att) => ({
+                    filename: att.filename || 'unnamed',
+                    contentType: att.contentType || 'application/octet-stream',
+                    size: att.size || 0,
+                    content: att.content
+                })),
                 inReplyTo: parsed.inReplyTo || '',
                 references: parsed.references || []
             };

package/dooray-cli.js

@@ -83,6 +83,21 @@ async function handleCommand() {
     case 'reply':
       await replyCommand(args[1], args.slice(2));
       break;
+    case 'forward':
+      await forwardCommand(args[1], args.slice(2));
+      break;
+    case 'delete':
+      await deleteCommand(args[1], args.slice(2));
+      break;
+    case 'mark':
+      await markCommand(args[1], args.slice(2));
+      break;
+    case 'attachments':
+      await attachmentsCommand(args[1]);
+      break;
+    case 'download':
+      await downloadCommand(args[1], args.slice(2));
+      break;
     case 'search':
       await searchCommand(args.slice(1));
       break;
@@ -227,7 +242,17 @@ async function readCommand(uid) {
     console.log(`Subject: ${mail.subject}`);
     console.log(`Date: ${mail.receivedAt}`);
     console.log(`Read: ${mail.isRead ? 'Yes' : 'No'}`);
-    console.log(`Attachments: ${mail.hasAttachments ? 'Yes' : 'No'}\n`);
+    
+    if (mail.attachments && mail.attachments.length > 0) {
+      console.log(`Attachments: ${mail.attachments.length} file(s)`);
+      mail.attachments.forEach((att, idx) => {
+        const sizeKB = (att.size / 1024).toFixed(2);
+        console.log(`  ${idx + 1}. ${att.filename} (${sizeKB} KB)`);
+      });
+      console.log();
+    } else {
+      console.log(`Attachments: No\n`);
+    }
     console.log('─'.repeat(50));
     console.log(mail.body || mail.bodyHtml || '(No content)');
     console.log('─'.repeat(50));
@@ -314,10 +339,268 @@ async function replyCommand(uid, args) {
   }
 }
 
+// forward: 메일 전달
+async function forwardCommand(uid, args) {
+  if (!uid) {
+    console.error('❌ Usage: dooray-cli forward <uid> --to <email> [--body "message"]');
+    process.exit(1);
+  }
+  
+  // --to, --body 옵션 파싱
+  let to, body;
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--to' && args[i + 1]) {
+      to = args[++i];
+    } else if (args[i] === '--body' && args[i + 1]) {
+      body = args[++i];
+    }
+  }
+  
+  if (!to) {
+    console.error('❌ --to option is required');
+    console.error('Usage: dooray-cli forward <uid> --to <email> [--body "message"]');
+    process.exit(1);
+  }
+  
+  const config = loadConfig();
+  const client = await createClient(config);
+  
+  try {
+    const mail = await client.getMailById(uid);
+    
+    if (!mail) {
+      console.error('❌ Mail not found');
+      process.exit(1);
+    }
+    
+    // 전달 제목 생성
+    const fwdSubject = mail.subject.startsWith('Fwd:') || mail.subject.startsWith('FW:')
+      ? mail.subject
+      : `Fwd: ${mail.subject}`;
+    
+    // 전달 본문 생성 (원본 메일 포함)
+    const fromText = typeof mail.from === 'object' ? `${mail.from.name} <${mail.from.email}>` : mail.from;
+    const originalMessage = `
+---------- Forwarded message ---------
+From: ${fromText}
+Date: ${mail.receivedAt}
+Subject: ${mail.subject}
+
+${mail.body || mail.bodyHtml || ''}
+`;
+    
+    const finalBody = body ? `${body}\n\n${originalMessage}` : originalMessage;
+    
+    // 메일 전송 (첨부파일 포함)
+    await client.sendMail({
+      to: to,
+      subject: fwdSubject,
+      text: finalBody,
+      attachments: mail.attachments && mail.attachments.length > 0 
+        ? mail.attachments.map(att => ({
+            filename: att.filename,
+            content: att.content,
+            contentType: att.contentType
+          }))
+        : undefined
+    });
+    
+    console.log('\n✅ Mail forwarded successfully');
+    console.log(`   To: ${to}`);
+    console.log(`   Subject: ${fwdSubject}`);
+    if (mail.attachments && mail.attachments.length > 0) {
+      console.log(`   Attachments: ${mail.attachments.length} file(s)`);
+    }
+  } catch (error) {
+    console.error('❌ Error:', error.message);
+    process.exit(1);
+  } finally {
+    await client.close();
+  }
+}
+
+// delete: 메일 삭제
+async function deleteCommand(uid, args) {
+  if (!uid) {
+    console.error('❌ Usage: dooray-cli delete <uid> [--force]');
+    process.exit(1);
+  }
+  
+  const permanent = args.includes('--force');
+  
+  const config = loadConfig();
+  const client = await createClient(config);
+  
+  try {
+    const result = await client.deleteMail(uid, permanent);
+    
+    if (result.success) {
+      if (permanent) {
+        console.log('✅ Mail permanently deleted');
+      } else {
+        console.log('✅ Mail moved to trash');
+        console.log('💡 Use --force to permanently delete');
+      }
+    } else {
+      console.error('❌ Failed to delete mail');
+      process.exit(1);
+    }
+  } finally {
+    await client.close();
+  }
+}
+
+// mark: 읽음/안읽음 표시
+async function markCommand(uid, args) {
+  if (!uid) {
+    console.error('❌ Usage: dooray-cli mark <uid> --read|--unread');
+    process.exit(1);
+  }
+  
+  const asRead = args.includes('--read');
+  const asUnread = args.includes('--unread');
+  
+  if (!asRead && !asUnread) {
+    console.error('❌ Specify --read or --unread');
+    process.exit(1);
+  }
+  
+  const config = loadConfig();
+  const client = await createClient(config);
+  
+  try {
+    const result = await client.markMail(uid, asRead);
+    
+    if (result.success) {
+      console.log(`✅ Mail marked as ${asRead ? 'read' : 'unread'}`);
+    } else {
+      console.error('❌ Failed to mark mail');
+      process.exit(1);
+    }
+  } finally {
+    await client.close();
+  }
+}
+
+// attachments: 첨부파일 목록 보기
+async function attachmentsCommand(uid) {
+  if (!uid) {
+    console.error('❌ Usage: dooray-cli attachments <uid>');
+    process.exit(1);
+  }
+  
+  const config = loadConfig();
+  const client = await createClient(config);
+  
+  try {
+    const mail = await client.getMailById(uid);
+    
+    if (!mail) {
+      console.error('❌ Mail not found');
+      process.exit(1);
+    }
+    
+    if (!mail.attachments || mail.attachments.length === 0) {
+      console.log('📎 No attachments in this mail');
+      return;
+    }
+    
+    console.log(`\n📎 Attachments (${mail.attachments.length})\n`);
+    mail.attachments.forEach((att, idx) => {
+      const sizeKB = (att.size / 1024).toFixed(2);
+      console.log(`${idx + 1}. ${att.filename}`);
+      console.log(`   Type: ${att.contentType}`);
+      console.log(`   Size: ${sizeKB} KB\n`);
+    });
+    
+    console.log('💡 To download: dooray-cli download ' + uid);
+  } finally {
+    await client.close();
+  }
+}
+
+// download: 첨부파일 다운로드
+async function downloadCommand(uid, args) {
+  if (!uid) {
+    console.error('❌ Usage: dooray-cli download <uid> [--output <path>] [--file <index>]');
+    process.exit(1);
+  }
+  
+  // 옵션 파싱
+  let outputPath = './downloads';
+  let fileIndex = null;
+  
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--output' && args[i + 1]) {
+      outputPath = args[++i];
+    } else if (args[i] === '--file' && args[i + 1]) {
+      fileIndex = parseInt(args[++i]) - 1;
+    }
+  }
+  
+  const config = loadConfig();
+  const client = await createClient(config);
+  
+  try {
+    const mail = await client.getMailById(uid);
+    
+    if (!mail) {
+      console.error('❌ Mail not found');
+      process.exit(1);
+    }
+    
+    if (!mail.attachments || mail.attachments.length === 0) {
+      console.log('📎 No attachments to download');
+      return;
+    }
+    
+    // 다운로드 디렉토리 생성
+    const mailDir = path.join(outputPath, `mail-${uid}`);
+    if (!fs.existsSync(mailDir)) {
+      fs.mkdirSync(mailDir, { recursive: true });
+    }
+    
+    // 특정 파일만 다운로드
+    if (fileIndex !== null) {
+      if (fileIndex < 0 || fileIndex >= mail.attachments.length) {
+        console.error(`❌ Invalid file index. Use 1-${mail.attachments.length}`);
+        process.exit(1);
+      }
+      
+      const att = mail.attachments[fileIndex];
+      const filePath = path.join(mailDir, att.filename);
+      fs.writeFileSync(filePath, att.content);
+      
+      const sizeKB = (att.size / 1024).toFixed(2);
+      console.log(`✅ Downloaded: ${att.filename} (${sizeKB} KB)`);
+      console.log(`   Location: ${filePath}`);
+      return;
+    }
+    
+    // 모든 파일 다운로드
+    console.log(`\n📎 Downloading ${mail.attachments.length} file(s)...\n`);
+    
+    for (const att of mail.attachments) {
+      const filePath = path.join(mailDir, att.filename);
+      fs.writeFileSync(filePath, att.content);
+      
+      const sizeKB = (att.size / 1024).toFixed(2);
+      console.log(`✅ ${att.filename} (${sizeKB} KB)`);
+    }
+    
+    console.log(`\n📁 All files saved to: ${mailDir}`);
+  } catch (error) {
+    console.error('❌ Error:', error.message);
+    process.exit(1);
+  } finally {
+    await client.close();
+  }
+}
+
 // send: 메일 발송
 async function sendCommand(args) {
-  // 비인터랙티브 모드: --to, --subject, --body 옵션 사용
-  let to, subject, body;
+  // 비인터랙티브 모드: --to, --subject, --body, --cc, --bcc, --attach, --html 옵션 사용
+  let to, subject, body, cc, bcc, attachFiles = [], isHtml = false;
   
   for (let i = 0; i < args.length; i++) {
     if (args[i] === '--to' && args[i + 1]) {
@@ -326,6 +609,15 @@ async function sendCommand(args) {
       subject = args[++i];
     } else if (args[i] === '--body' && args[i + 1]) {
       body = args[++i];
+    } else if (args[i] === '--cc' && args[i + 1]) {
+      cc = args[++i];
+    } else if (args[i] === '--bcc' && args[i + 1]) {
+      bcc = args[++i];
+    } else if (args[i] === '--attach' && args[i + 1]) {
+      attachFiles.push(args[++i]);
+    } else if (args[i] === '--html' && args[i + 1]) {
+      body = args[++i];
+      isHtml = true;
     }
   }
 
@@ -335,10 +627,43 @@ async function sendCommand(args) {
     const client = await createClient(config);
     
     try {
-      await client.sendMail({ to, subject, text: body });
+      // 첨부파일 처리
+      const attachments = [];
+      for (const filePath of attachFiles) {
+        if (!fs.existsSync(filePath)) {
+          console.error(`❌ File not found: ${filePath}`);
+          process.exit(1);
+        }
+        attachments.push({
+          filename: path.basename(filePath),
+          content: fs.readFileSync(filePath)
+        });
+      }
+      
+      const mailParams = {
+        to,
+        subject,
+        cc: cc ? cc.split(',').map(e => e.trim()) : undefined,
+        bcc: bcc ? bcc.split(',').map(e => e.trim()) : undefined,
+        attachments: attachments.length > 0 ? attachments : undefined
+      };
+      
+      if (isHtml) {
+        mailParams.html = true;
+        mailParams.body = body;
+      } else {
+        mailParams.text = body;
+      }
+      
+      await client.sendMail(mailParams);
       console.log('✅ Mail sent successfully');
       console.log(`   To: ${to}`);
+      if (cc) console.log(`   CC: ${cc}`);
+      if (bcc) console.log(`   BCC: ${bcc}`);
       console.log(`   Subject: ${subject}`);
+      if (attachments.length > 0) {
+        console.log(`   Attachments: ${attachments.length} file(s)`);
+      }
       return;
     } catch (error) {
       console.error('❌ Error:', error.message);
@@ -386,28 +711,50 @@ async function sendCommand(args) {
   }
 }
 
-// search: 메일 검색
-async function searchCommand(keywords) {
-  if (keywords.length === 0) {
-    console.error('❌ Usage: dooray-cli search <keyword1> [keyword2] ...');
+// search: 메일 검색 (키워드, 날짜, 발신자 필터 지원)
+async function searchCommand(args) {
+  if (args.length === 0) {
+    console.error('❌ Usage: dooray-cli search <keyword> [--from <email>] [--since <YYYY-MM-DD>] [--before <YYYY-MM-DD>]');
     process.exit(1);
   }
   
+  // 옵션 파싱
+  let from, since, before;
+  const keywords = [];
+  
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--from' && args[i + 1]) {
+      from = args[++i];
+    } else if (args[i] === '--since' && args[i + 1]) {
+      since = args[++i];
+    } else if (args[i] === '--before' && args[i + 1]) {
+      before = args[++i];
+    } else {
+      keywords.push(args[i]);
+    }
+  }
+  
   const config = loadConfig();
   const client = await createClient(config);
   
   try {
-    const criteria = keywords.map(k => ['SUBJECT', k]);
-    const mails = await client.searchMail(criteria);
+    const mails = await client.searchMail(keywords, { from, since, before });
     
     if (mails.length === 0) {
       console.log('📭 No matching mails found');
       return;
     }
     
-    console.log(`\n🔍 Search Results (${mails.length})\n`);
+    const filters = [];
+    if (keywords.length > 0) filters.push(`keywords: "${keywords.join(' ')}"`);
+    if (from) filters.push(`from: ${from}`);
+    if (since) filters.push(`since: ${since}`);
+    if (before) filters.push(`before: ${before}`);
+    
+    console.log(`\n🔍 Search Results (${filters.join(', ')}): ${mails.length} found\n`);
     mails.slice(0, 10).forEach((mail, idx) => {
-      console.log(`${idx + 1}. [UID: ${mail.uid}] ${mail.from}`);
+      const fromText = typeof mail.from === 'object' ? `${mail.from.name} <${mail.from.email}>` : mail.from;
+      console.log(`${idx + 1}. [UID: ${mail.uid}] ${fromText}`);
       console.log(`   Subject: ${mail.subject}`);
       console.log(`   Date: ${mail.date}\n`);
     });
@@ -463,10 +810,35 @@ Commands:
   send                Send a new mail (interactive)
   send --to <email> --subject <subject> --body <body>
                       Send a mail (non-interactive)
+  send --to <email> --subject <subject> --body <body> --cc <email> --bcc <email>
+                      Send with CC/BCC
+  send --to <email> --subject <subject> --html <html>
+                      Send HTML mail
+  send --to <email> --subject <subject> --body <body> --attach <file>
+                      Send with attachments
   reply <uid>         Reply to a mail (interactive)
   reply <uid> --body <body>
                       Reply to a mail (non-interactive)
+  forward <uid> --to <email> [--body <message>]
+                      Forward a mail
+  delete <uid>        Delete a mail (move to trash)
+  delete <uid> --force
+                      Permanently delete a mail
+  mark <uid> --read   Mark a mail as read
+  mark <uid> --unread Mark a mail as unread
+  attachments <uid>   List attachments in a mail
+  download <uid>      Download all attachments
+  download <uid> --file <index>
+                      Download a specific attachment
+  download <uid> --output <path>
+                      Download to a custom path
   search <keywords>   Search mails by keywords
+  search <keywords> --from <email>
+                      Search by sender
+  search <keywords> --since <YYYY-MM-DD>
+                      Search since date
+  search <keywords> --before <YYYY-MM-DD>
+                      Search before date
   unread              Show unread mail count
   test                Test IMAP/SMTP connection
   help                Show this help message
@@ -476,10 +848,23 @@ Examples:
   dooray-cli list
   dooray-cli recent
   dooray-cli read 123
-  dooray-cli send --to "user@example.com" --subject "Hello" --body "Test message"
+  dooray-cli send --to "user@example.com" --subject "Hello" --body "Test"
+  dooray-cli send --to "user@example.com" --subject "Hello" --body "Test" --cc "cc@example.com" --attach "./file.pdf"
+  dooray-cli send --to "user@example.com" --subject "Hello" --html "<h1>Title</h1><p>Content</p>"
   dooray-cli reply 123
   dooray-cli reply 123 --body "Thank you for your email."
-  dooray-cli search "meeting" "report"
+  dooray-cli forward 123 --to "another@example.com" --body "FYI"
+  dooray-cli delete 123
+  dooray-cli delete 123 --force
+  dooray-cli mark 123 --read
+  dooray-cli mark 123 --unread
+  dooray-cli attachments 123
+  dooray-cli download 123
+  dooray-cli download 123 --file 1
+  dooray-cli download 123 --output ./my-files
+  dooray-cli search "meeting" --from "boss@example.com"
+  dooray-cli search "report" --since "2026-01-01"
+  dooray-cli search "invoice" --before "2026-02-01"
   dooray-cli unread
 
 Configuration file: ${CONFIG_PATH}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dooray-mail-cli",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Dooray mail CLI for OpenClaw Skill - IMAP/SMTP integration",
   "main": "./dist/mail-client.js",
   "bin": {
@@ -23,6 +23,11 @@
   ],
   "author": "Anonymous",
   "license": "MIT",
+  "scripts": {
+    "release:patch": "npm version patch && git push && git push --tags",
+    "release:minor": "npm version minor && git push && git push --tags",
+    "release:major": "npm version major && git push && git push --tags"
+  },
   "dependencies": {
     "crypto-js": "^4.2.0",
     "imap-simple": "^5.1.0",