openclaw-github-trending 1.0.0

package/dist/tool.js

@@ -0,0 +1,314 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.githubTrendingTool = exports.HistoryManager = void 0;
+const fetcher_1 = require("./core/fetcher");
+const summarizer_1 = require("./core/summarizer");
+const history_1 = require("./core/history");
+Object.defineProperty(exports, "HistoryManager", { enumerable: true, get: function () { return history_1.HistoryManager; } });
+const feishu_1 = require("./channels/feishu");
+const email_1 = require("./channels/email");
+const config_1 = require("./core/config");
+/**
+ * Process repositories with AI summaries concurrently
+ * @param repositories Repositories to process
+ * @param summarizer AISummarizer instance
+ * @param maxWorkers Maximum concurrent workers
+ * @returns Repositories with AI summaries
+ */
+async function processRepositoriesWithAI(repositories, summarizer, maxWorkers = 5) {
+    const results = [];
+    // Use configured max workers, cap at 10 to avoid overwhelming the API
+    const actualMaxWorkers = Math.min(maxWorkers, 10);
+    // Process in batches to limit concurrency
+    for (let i = 0; i < repositories.length; i += actualMaxWorkers) {
+        const batch = repositories.slice(i, i + actualMaxWorkers);
+        console.log(`[AI Summarizer] Processing batch ${Math.floor(i / actualMaxWorkers) + 1}/${Math.ceil(repositories.length / actualMaxWorkers)} (${batch.length} repos with ${actualMaxWorkers} workers)...`);
+        // Use Promise.allSettled to handle individual failures gracefully
+        const batchResults = await Promise.allSettled(batch.map(async (repo) => {
+            try {
+                // Add timeout for each summary request (3 minutes max to match OpenClaw CLI limit)
+                const startTime = Date.now();
+                const summary = await Promise.race([
+                    summarizer.generateSummary(repo),
+                    new Promise((_, reject) => setTimeout(() => reject(new Error('Summary timeout')), 180000))
+                ]);
+                const duration = Date.now() - startTime;
+                console.log(`✅ ${repo.full_name} summary generated (${duration}ms, ${summary.length} chars)`);
+                return { ...repo, ai_summary: summary };
+            }
+            catch (error) {
+                console.log(`⚠️  ${repo.full_name} 摘要生成失败：${error instanceof Error ? error.message : 'Unknown error'}`);
+                return { ...repo, ai_summary: '' };
+            }
+        }));
+        // Collect successful results
+        for (const result of batchResults) {
+            if (result.status === 'fulfilled') {
+                results.push(result.value);
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Main handler for GitHub Trending Tool
+ */
+async function githubTrendingHandler(params, pluginConfig = {}, openclawConfig = {}, historyData) {
+    console.log('\n[GitHub Trending Tool] Handler called');
+    console.log('[GitHub Trending Tool] pluginConfig:', JSON.stringify(pluginConfig, null, 2));
+    console.log('[GitHub Trending Tool] pluginConfig.proxy:', pluginConfig.proxy);
+    console.log('[GitHub Trending Tool] params:', params);
+    console.log('[GitHub Trending Tool] openclawConfig available:', !!openclawConfig);
+    const { since, channels, email_to, feishu_webhook } = params;
+    // 解析通道配置（仅使用 channels 参数）
+    const targetChannels = channels || [];
+    if (targetChannels.length === 0) {
+        return {
+            success: false,
+            pushed_count: 0,
+            new_count: 0,
+            seen_count: 0,
+            total_count: 0,
+            pushed_to: '',
+            timestamp: new Date().toISOString(),
+            message: '请指定至少一个推送通道：channels 参数'
+        };
+    }
+    // Step 1: Resolve AI configuration with fallback logic
+    const aiConfig = config_1.ConfigManager.getAIConfig(pluginConfig, openclawConfig);
+    const summarizer = new summarizer_1.AISummarizer(aiConfig);
+    // Step 2: Initialize fetcher and fetch trending repositories
+    const fetcher = new fetcher_1.GitHubFetcher(pluginConfig);
+    let repositories;
+    try {
+        repositories = await fetcher.fetchTrending(since);
+    }
+    catch (error) {
+        return {
+            success: false,
+            pushed_count: 0,
+            new_count: 0,
+            seen_count: 0,
+            total_count: 0,
+            pushed_to: targetChannels.join(','),
+            timestamp: new Date().toISOString(),
+            message: `Failed to fetch trending: ${error instanceof Error ? error.message : 'Unknown error'}`
+        };
+    }
+    // Step 3: Initialize history manager and separate new/seen repositories
+    const historyManager = new history_1.HistoryManager();
+    if (historyData) {
+        historyManager.importData(historyData);
+    }
+    // Categorize repositories with proper history config from plugin
+    const historyConfig = {
+        enabled: pluginConfig?.history?.enabled ?? true,
+        star_threshold: pluginConfig?.history?.star_threshold ?? 100
+    };
+    const historyStatsBefore = historyManager.getStats();
+    console.log('[History Manager] Configuration:', JSON.stringify(historyConfig, null, 2));
+    console.log('[History Manager] History loaded from storage:', historyData ? '✅ Yes' : '❌ No');
+    console.log('[History Manager] Total repositories in history:', Object.keys(historyManager['data'].repositories).length);
+    console.log('[History Manager] Statistics before processing:');
+    console.log(`  - Total repositories tracked: ${historyStatsBefore.total_repositories}`);
+    console.log(`  - Total pushes: ${historyStatsBefore.total_pushes}`);
+    console.log(`  - Oldest entry: ${historyStatsBefore.oldest_entry || 'N/A'}`);
+    console.log(`  - Newest entry: ${historyStatsBefore.newest_entry || 'N/A'}`);
+    const { newlySeen, shouldPush, alreadySeen } = historyManager.categorizeRepositories(repositories, historyConfig);
+    console.log(`[History Manager] Results - New: ${newlySeen.length}, Should Push: ${shouldPush.length}, Already Seen: ${alreadySeen.length}`);
+    if (newlySeen.length > 0) {
+        console.log('[History Manager] Newly seen repositories:');
+        newlySeen.forEach((repo, i) => console.log(`  ${i + 1}. ${repo.full_name} (${repo.stars} stars)`));
+    }
+    if (alreadySeen.length > 0) {
+        console.log('[History Manager] Already seen repositories:');
+        alreadySeen.forEach((repo, i) => {
+            const history = historyManager.getProject(repo.full_name);
+            const starsDiff = repo.stars - (history?.last_stars || 0);
+            console.log(`  ${i + 1}. ${repo.full_name} (${repo.stars} stars, +${starsDiff} since last push)`);
+        });
+    }
+    // Step 4: Get max workers from config and generate AI summaries for repositories to push
+    const maxWorkers = config_1.ConfigManager.getMaxWorkers(pluginConfig);
+    console.log(`[AI Summarizer] Using ${maxWorkers} concurrent workers for ${shouldPush.length} repositories`);
+    let processedRepositories = [];
+    const startTime = Date.now();
+    try {
+        processedRepositories = await processRepositoriesWithAI(shouldPush, summarizer, maxWorkers);
+    }
+    catch (error) {
+        // Continue with empty summaries if AI processing fails
+        processedRepositories = shouldPush.map((r) => ({ ...r, ai_summary: '' }));
+    }
+    const summaryDuration = Date.now() - startTime;
+    console.log(`[AI Summarizer] ✅ All summaries generated in ${summaryDuration}ms (${summaryDuration / shouldPush.length}ms per repo on average)`);
+    // Update history
+    historyManager.markPushed(processedRepositories);
+    // Prepare seen repositories with AI summaries from history (skip AI generation)
+    const seenReposWithSummary = alreadySeen.map((r) => {
+        const history = historyManager.getProject(r.full_name);
+        const summary = history?.ai_summary || '';
+        if (summary) {
+            console.log(`[History Manager] ✅ Using cached summary for ${r.full_name} (${summary.length} chars)`);
+        }
+        else {
+            console.log(`[History Manager] ⚠️  No cached summary for ${r.full_name}`);
+        }
+        return {
+            ...r,
+            ai_summary: summary
+        };
+    });
+    // Display summary statistics
+    console.log(`\n[Summary Statistics]`);
+    console.log(`  - New repositories processed with AI: ${processedRepositories.length}`);
+    console.log(`  - Already seen repositories (using cached summaries): ${alreadySeen.length}`);
+    console.log(`  - Total repositories to push: ${processedRepositories.length}`);
+    console.log(`  - Total repositories shown: ${processedRepositories.length + alreadySeen.length}`);
+    // Step 5: Push to each channel
+    const pushResults = [];
+    const pushLogs = []; // 收集推送日志
+    // Display history statistics
+    const historyStats = historyManager.getStats();
+    console.log('\n[History Statistics]');
+    console.log(`  - Total repositories tracked: ${historyStats.total_repositories}`);
+    console.log(`  - Total pushes: ${historyStats.total_pushes}`);
+    console.log(`  - Oldest entry: ${historyStats.oldest_entry || 'N/A'}`);
+    console.log(`  - Newest entry: ${historyStats.newest_entry || 'N/A'}`);
+    for (const targetChannel of targetChannels) {
+        try {
+            if (targetChannel === 'feishu') {
+                const webhookUrl = feishu_webhook || pluginConfig?.channels?.feishu?.webhook_url;
+                if (!webhookUrl) {
+                    pushResults.push({ channel: 'feishu', success: false, error: 'Feishu webhook URL not provided' });
+                    pushLogs.push('[Feishu Channel] ❌ 推送失败: Feishu webhook URL not provided');
+                    continue;
+                }
+                const result = await feishu_1.FeishuChannel.push(webhookUrl, processedRepositories, seenReposWithSummary);
+                pushResults.push({
+                    channel: 'feishu',
+                    success: result.success,
+                    messageId: result.messageId,
+                    error: result.error
+                });
+                pushLogs.push(`[Feishu Channel] ${result.success ? '✅ 推送成功' : '❌ 推送失败'}${result.error ? ': ' + result.error : ''}`);
+            }
+            else if (targetChannel === 'email') {
+                const emailTo = email_to || pluginConfig?.channels?.email?.recipient || pluginConfig?.channels?.email?.sender;
+                if (!emailTo) {
+                    pushResults.push({ channel: 'email', success: false, error: 'Email recipient not provided' });
+                    pushLogs.push('[Email Channel] ❌ 推送失败: Email recipient not provided');
+                    continue;
+                }
+                // Detect email configuration
+                const emailConfig = config_1.ConfigManager.getEmailConfig(emailTo, pluginConfig?.channels?.email?.password || '', pluginConfig?.channels?.email);
+                const internalEmailConfig = {
+                    from: emailConfig.sender,
+                    to: emailTo,
+                    subject: `GitHub ${since === 'daily' ? '今日' : since === 'weekly' ? '本周' : '本月'}热榜推送`,
+                    smtp: {
+                        host: emailConfig.smtp_host,
+                        port: emailConfig.smtp_port,
+                        secure: false, // Use STARTTLS
+                        auth: {
+                            user: emailConfig.sender,
+                            pass: emailConfig.password
+                        }
+                    }
+                };
+                const result = await email_1.EmailChannel.send(internalEmailConfig, processedRepositories, seenReposWithSummary, since);
+                pushResults.push({
+                    channel: 'email',
+                    success: result.success,
+                    messageId: result.messageId,
+                    error: result.error
+                });
+                pushLogs.push(`[Email Channel] ${result.success ? '✅ 推送成功' : '❌ 推送失败'}${result.error ? ': ' + result.error : ''}`);
+            }
+        }
+        catch (error) {
+            pushResults.push({
+                channel: targetChannel,
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            });
+            pushLogs.push(`[${targetChannel} Channel] ❌ 推送失败: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    // 统一输出推送日志在最后
+    console.log('\n========== 推送结果汇总 ==========');
+    pushLogs.forEach(log => console.log(log));
+    console.log('====================================\n');
+    // Step 6: Return result
+    const successCount = pushResults.filter(r => r.success).length;
+    const failedChannels = pushResults.filter(r => !r.success).map(r => r.channel);
+    const successChannels = pushResults.filter(r => r.success).map(r => r.channel);
+    // 构建详细的消息
+    let message = '';
+    if (successCount === targetChannels.length) {
+        message = `成功推送到所有 ${successCount} 个通道`;
+    }
+    else if (successCount > 0) {
+        const failedDetails = pushResults
+            .filter(r => !r.success)
+            .map(r => `${r.channel}: ${r.error}`)
+            .join(', ');
+        message = `部分成功：${successCount}/${targetChannels.length} 个通道推送成功，失败：${failedDetails}`;
+    }
+    else {
+        const failedDetails = pushResults
+            .filter(r => !r.success)
+            .map(r => `${r.channel}: ${r.error}`)
+            .join(', ');
+        message = `所有通道推送失败：${failedDetails}`;
+    }
+    return {
+        success: successCount > 0,
+        pushed_count: processedRepositories.length,
+        new_count: newlySeen.length,
+        seen_count: alreadySeen.length,
+        total_count: repositories.length,
+        pushed_to: successChannels.join(','),
+        timestamp: new Date().toISOString(),
+        message,
+        history_data: historyManager.exportData() // Return updated history for persistence
+    };
+}
+/**
+ * Export the GitHub Trending Tool
+ */
+exports.githubTrendingTool = {
+    name: 'openclaw-github-trending',
+    description: 'Fetch GitHub trending repositories and push to Feishu or Email',
+    parameters: {
+        type: 'object',
+        properties: {
+            since: {
+                type: 'string',
+                enum: ['daily', 'weekly', 'monthly'],
+                description: 'Time period for trending'
+            },
+            channels: {
+                type: 'array',
+                items: {
+                    type: 'string',
+                    enum: ['feishu', 'email']
+                },
+                description: 'Push channels (array: ["email"], ["feishu"], or ["email", "feishu"])'
+            },
+            email_to: {
+                type: 'string',
+                format: 'email',
+                description: 'Email recipient (required for email channel)'
+            },
+            feishu_webhook: {
+                type: 'string',
+                description: 'Feishu webhook URL (required for feishu channel)'
+            }
+        },
+        required: ['since']
+    },
+    handler: githubTrendingHandler
+};
+exports.default = exports.githubTrendingTool;
+//# sourceMappingURL=tool.js.map

package/dist/tool.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Unified Logger with Console + File support
+ *
+ * Features:
+ * - Console logging with timestamp, prefix, and level
+ * - File logging to ~/.openclaw/logs/github-trending/trending-YYYY-MM.log
+ * - Single instance per module (prefix-based)
+ * - Static methods for convenience
+ * - Unified log format
+ */
+export declare class Logger {
+    private static instances;
+    private prefix;
+    private logDir;
+    private enabled;
+    private logLevel;
+    constructor(prefix?: string);
+    /**
+     * Get logger instance for a specific module
+     * Singleton per prefix
+     */
+    static get(prefix: string): Logger;
+    /**
+     * Set minimum log level (default: INFO)
+     */
+    setLogLevel(level: LogLevel): void;
+    /**
+     * Get log file path (monthly rotation)
+     */
+    private getLogFilePath;
+    /**
+     * Format argument for logging
+     */
+    private formatArg;
+    /**
+     * Check if log level is enabled
+     */
+    private isLevelEnabled;
+    /**
+     * Format message with timestamp and prefix
+     */
+    private formatMessage;
+    /**
+     * Write to file
+     */
+    private logToFile;
+    /**
+     * Internal log method
+     */
+    private log;
+    debug(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    success(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string | Error, ...args: any[]): void;
+    /**
+     * Get the logger prefix (for testing)
+     */
+    getPrefix(): string;
+    /**
+     * Create a timer function for measuring execution time
+     */
+    timer(operation: string): () => number;
+    static debug(message: string, ...args: any[]): void;
+    static info(message: string, ...args: any[]): void;
+    static success(message: string, ...args: any[]): void;
+    static warn(message: string, ...args: any[]): void;
+    static error(message: string | Error, ...args: any[]): void;
+}
+export declare enum LogLevel {
+    DEBUG = "debug",
+    INFO = "info",
+    WARN = "warn",
+    ERROR = "error",
+    SUCCESS = "success"
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAkC;IAC1D,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,QAAQ,CAA2B;gBAE/B,MAAM,GAAE,MAAc;IAkBlC;;;OAGG;IACH,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAOlC;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAIlC;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,OAAO,CAAC,SAAS;IAajB;;OAEG;IACH,OAAO,CAAC,cAAc;IAWtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACH,OAAO,CAAC,SAAS;IAWjB;;OAEG;IACH,OAAO,CAAC,GAAG;IA8BX,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI3C,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAO9C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI3C,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAQpD;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,MAAM;IAWtC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAInD,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAIlD,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAIrD,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAIlD,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;CAG5D;AAED,oBAAY,QAAQ;IAClB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;IACf,OAAO,YAAY;CACpB"}

package/dist/utils/logger.js

@@ -0,0 +1,214 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogLevel = exports.Logger = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+/**
+ * Unified Logger with Console + File support
+ *
+ * Features:
+ * - Console logging with timestamp, prefix, and level
+ * - File logging to ~/.openclaw/logs/github-trending/trending-YYYY-MM.log
+ * - Single instance per module (prefix-based)
+ * - Static methods for convenience
+ * - Unified log format
+ */
+class Logger {
+    constructor(prefix = 'App') {
+        this.enabled = true;
+        this.logLevel = LogLevel.INFO;
+        this.prefix = `[${prefix}]`;
+        this.logDir = ''; // Initialize
+        // Setup log directory (same as old FileLogger)
+        try {
+            const openclawDataDir = process.env.OPENCLAW_DATA_DIR || path_1.default.join(os_1.default.homedir(), '.openclaw');
+            this.logDir = path_1.default.join(openclawDataDir, 'logs', 'github-trending');
+            if (!fs_1.default.existsSync(this.logDir)) {
+                fs_1.default.mkdirSync(this.logDir, { recursive: true });
+            }
+        }
+        catch (error) {
+            console.error('[Logger] Failed to create log directory:', error);
+            this.enabled = false;
+        }
+    }
+    /**
+     * Get logger instance for a specific module
+     * Singleton per prefix
+     */
+    static get(prefix) {
+        if (!Logger.instances.has(prefix)) {
+            Logger.instances.set(prefix, new Logger(prefix));
+        }
+        return Logger.instances.get(prefix);
+    }
+    /**
+     * Set minimum log level (default: INFO)
+     */
+    setLogLevel(level) {
+        this.logLevel = level;
+    }
+    /**
+     * Get log file path (monthly rotation)
+     */
+    getLogFilePath() {
+        const date = new Date();
+        const year = date.getFullYear();
+        const month = String(date.getMonth() + 1).padStart(2, '0');
+        return path_1.default.join(this.logDir, `trending-${year}-${month}.log`);
+    }
+    /**
+     * Format argument for logging
+     */
+    formatArg(arg) {
+        if (arg instanceof Error) {
+            return arg.message + (arg.stack ? `\n${arg.stack}` : '');
+        }
+        if (typeof arg === 'object') {
+            return JSON.stringify(arg, null, 2);
+        }
+        if (typeof arg === 'function') {
+            return '[Function]';
+        }
+        return String(arg);
+    }
+    /**
+     * Check if log level is enabled
+     */
+    isLevelEnabled(level) {
+        const levelOrder = {
+            [LogLevel.DEBUG]: 0,
+            [LogLevel.INFO]: 1,
+            [LogLevel.WARN]: 2,
+            [LogLevel.ERROR]: 3,
+            [LogLevel.SUCCESS]: 1, // Same as INFO for filtering
+        };
+        return levelOrder[level] >= levelOrder[this.logLevel];
+    }
+    /**
+     * Format message with timestamp and prefix
+     */
+    formatMessage(level, message, args) {
+        const timestamp = new Date().toISOString();
+        const levelStr = level.toString().toUpperCase();
+        let formattedMessage = `${timestamp} ${this.prefix} [${levelStr}] ${message}`;
+        if (args && args.length > 0) {
+            formattedMessage += ' ' + args.map(arg => this.formatArg(arg)).join(' ');
+        }
+        return formattedMessage;
+    }
+    /**
+     * Write to file
+     */
+    logToFile(message) {
+        if (!this.enabled)
+            return;
+        try {
+            const logFilePath = this.getLogFilePath();
+            fs_1.default.appendFileSync(logFilePath, message + '\n', 'utf8');
+        }
+        catch (error) {
+            // Fail silently - don't crash the app if logging fails
+        }
+    }
+    /**
+     * Internal log method
+     */
+    log(level, message, ...args) {
+        if (!this.isLevelEnabled(level))
+            return;
+        const formattedMessage = this.formatMessage(level, message, args);
+        // Console output with color
+        switch (level) {
+            case LogLevel.DEBUG:
+                console.log(formattedMessage);
+                break;
+            case LogLevel.INFO:
+                console.log(formattedMessage);
+                break;
+            case LogLevel.WARN:
+                console.warn(formattedMessage);
+                break;
+            case LogLevel.ERROR:
+                console.error(formattedMessage);
+                break;
+            case LogLevel.SUCCESS:
+                console.log(formattedMessage); // Green color in terminal
+                break;
+        }
+        // File logging
+        this.logToFile(formattedMessage);
+    }
+    // Public logging methods
+    debug(message, ...args) {
+        this.log(LogLevel.DEBUG, message, ...args);
+    }
+    info(message, ...args) {
+        this.log(LogLevel.INFO, message, ...args);
+    }
+    success(message, ...args) {
+        const successMsg = message.includes('✅') || message.includes('succeed')
+            ? message
+            : `✅ ${message}`;
+        this.log(LogLevel.SUCCESS, successMsg, ...args);
+    }
+    warn(message, ...args) {
+        this.log(LogLevel.WARN, message, ...args);
+    }
+    error(message, ...args) {
+        if (message instanceof Error) {
+            this.log(LogLevel.ERROR, message.message, [message, ...args]);
+        }
+        else {
+            this.log(LogLevel.ERROR, message, ...args);
+        }
+    }
+    /**
+     * Get the logger prefix (for testing)
+     */
+    getPrefix() {
+        return this.prefix;
+    }
+    /**
+     * Create a timer function for measuring execution time
+     */
+    timer(operation) {
+        const startTime = Date.now();
+        return () => {
+            const elapsed = Date.now() - startTime;
+            this.info(`${operation} completed in ${elapsed}ms`);
+            return elapsed;
+        };
+    }
+    // Static convenience methods (uses 'App' as default prefix)
+    static debug(message, ...args) {
+        Logger.get('App').debug(message, ...args);
+    }
+    static info(message, ...args) {
+        Logger.get('App').info(message, ...args);
+    }
+    static success(message, ...args) {
+        Logger.get('App').success(message, ...args);
+    }
+    static warn(message, ...args) {
+        Logger.get('App').warn(message, ...args);
+    }
+    static error(message, ...args) {
+        Logger.get('App').error(message, ...args);
+    }
+}
+exports.Logger = Logger;
+Logger.instances = new Map();
+var LogLevel;
+(function (LogLevel) {
+    LogLevel["DEBUG"] = "debug";
+    LogLevel["INFO"] = "info";
+    LogLevel["WARN"] = "warn";
+    LogLevel["ERROR"] = "error";
+    LogLevel["SUCCESS"] = "success";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/markdown.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Convert markdown text to HTML
+ * This function sanitizes the output to prevent XSS attacks
+ *
+ * @param markdown - Markdown text to convert
+ * @returns Sanitized HTML string
+ */
+export declare function markdownToHTML(markdown: string): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/utils/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/utils/markdown.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAyBvD"}