इस प्रोजेक्ट के बारे में

cb365 Microsoft 365 सेवाओं के लिए कमांड-लाइन एक्सेस प्रदान करता है, जो कस्टम Graph API ऐप बनाने या मैन्युअल UI इंटरैक्शन का विकल्प है। यह tasks बनाना, ईमेल भेजना, कैलेंडर प्रबंधित करना, Teams में पोस्ट करना, और SharePoint, OneDrive, Planner और Loop के साथ इंटरैक्ट करने जैसी स्वचालन क्षमताएँ प्रदान करता है। इसका संरचित JSON आउटपुट scripts और AI agents द्वारा उपयोग के लिए उपयुक्त है। मुख्य विशेषताएँ और लक्षित पाठक: * **DevOps और प्लेटफ़ॉर्म इंजीनियर**: CI से tasks बनाने या build परिणामों को Teams में पोस्ट करने जैसे M365 संचालन के स्क्रिप्टिंग के लिए। * **AI एजेंट बिल्डर्स**: `--json` आउटपुट और safety फ्लैग्स के साथ autonomous workflows के लिए डिज़ाइन किया गया। * **IT admins**: Graph API संचालन के लिए PowerShell का CLI विकल्प। * **डेवलपर**: सामान्य M365 कार्यों के लिए Graph SDK बॉयलरप्लेट कोड कम करता है। cb365 Microsoft Graph API को_wraps_ करता है और निम्नलिखित जटिलताओं को संभालता है: * **प्रमाणीकरण**: device-code, client credentials और certificate flows का समर्थन करता है, टोकन को OS keychain में सुरक्षित रूप से संग्रहीत करता है। * **सुरक्षा**: 44 हार्डकोडेड नियम शामिल हैं, डिलीट के लिए `--force` और broadcasts के लिए `--confirm` की आवश्यकता होती है, सभी write operations के लिए `--dry-run` उपलब्ध है। टोकन कभी भी आउटपुट में प्रकट नहीं होते हैं। * **आउटपुट**: `--json`, `--plain` (TSV), और मानव-पठनीय टेबल प्रारूप प्रदान करता है, pipeline integration के लिए डिज़ाइन किया गया। * **प्रोफ़ाइल्स**: delegated और app-only प्रमाणीकरण को समानांतर रूप से प्रबंधित करता है, tenant switching को आसान बनाता है। * **कोई निर्भरता नहीं**: कोई runtime आवश्यकता नहीं वाला एकमात्र Go binary। `go install` या पूर्व-निर्मित release binaries के माध्यम से स्थापना उपलब्ध है। उपयोगकर्ताओं को एक Entra ID App पंजीकृत करना होगा और आवश्यक API permissions कॉन्फ़िगर करनी होंगी। प्रमाणीकरण interactive उपयोग के लिए delegated (device code) और unattended automation के लिए app-only (client secret या certificate) का समर्थन करता है, सुरक्षा के लिए client secrets केवल standard input से स्वीकार किए जाते हैं। विभिन्न M365 workloads के लिए commands उपलब्ध हैं: * **Auth**: लॉगिन, स्टेटस, लॉगआउट, प्रोफ़ाइल प्रबंधन। * **To Do**: task lists और tasks की सूची, बनाना, अपडेट, पूर्ण और हटाना। * **Mail**: messages की सूची, प्राप्त, read मार्क, move, permanently delete, draft, send और search। * **Calendar**: events की सूची, प्राप्त, बनाना, अपडेट और हटाना। * **Contacts**: contacts की सूची, प्राप्त, search, बनाना और अपडेट। * **Planner**: plans की सूची, plans बनाना, buckets प्रबंधित करना और tasks प्रबंधित करना। * **Teams**: channels की सूची, channels और chats में messages भेजना, और channel messages को soft-delete करना। * **SharePoint**: sites की सूची/search, site details प्राप्त करना, lists और list items प्रबंधित करना, और files प्रबंधित करना। * **OneDrive**: files की सूची, प्राप्त, अपलोड, हटाना और folders बनाना। * **Loop**: workspaces और pages की सूची, pages download/export करना, pages हटाना, files अपलोड करना और folders बनाना। Global flags में `--json`, `--plain`, `--profile`, `--dry-run` और `--verbose` शामिल हैं। यह टूल process arguments में business content न रखने पर जोर देता है, files या stdin से indirect values का समर्थन करता है। safety rules हार्डकोडेड हैं, जिसमें write protection, calendar-specific rules (time zone validation, duplicate detection, attendee count guards), mail safety (`--confirm` for sending, recipient count guards) और token safety (secure storage, no output exposure) शामिल हैं। AI एजेंट इंटीग्रेशन के लिए, `--json` आउटपुट संरचित डेटा प्रदान करता है। एजेंटों को M365 content को untrusted data मानने और commands के लिए explicit allowlists तथा side effects के लिए confirmation flags का उपयोग करने की सलाह दी जाती है। error handling standard Unix exit codes का उपयोग करता है, error stderr पर प्रिंट किए जाते हैं।