@panguard-ai/core 0.1.0

package/dist/rules/yara-scanner.js

@@ -0,0 +1,421 @@
+/**
+ * YARA Scanner - File scanning using YARA rules
+ * YARA 掃描器 - 使用 YARA 規則掃描檔案
+ *
+ * Provides an abstraction over YARA scanning that:
+ * - Loads .yar rule files from a directory
+ * - Scans individual files or entire directories
+ * - Converts results to SecurityEvent format for unified pipeline
+ * - Gracefully degrades when YARA native bindings are not available
+ *
+ * @module @panguard-ai/core/rules/yara-scanner
+ */
+import { readdir, stat, readFile } from 'node:fs/promises';
+import { join, extname, resolve } from 'node:path';
+import { createHash } from 'node:crypto';
+import { createLogger } from '../utils/logger.js';
+const logger = createLogger('yara-scanner');
+/**
+ * YARA-based file scanner
+ * 基於 YARA 的檔案掃描器
+ *
+ * Supports two modes:
+ * 1. Native YARA via @automattic/yara (requires native bindings)
+ * 2. Pattern-based fallback using regex matching on file content
+ */
+export class YaraScanner {
+    ruleFiles = [];
+    compiledPatterns = [];
+    yaraAvailable = false;
+    /** Load YARA rules from a directory (non-recursive) / 從目錄載入 YARA 規則（非遞迴） */
+    async loadRules(rulesDir) {
+        const resolvedDir = resolve(rulesDir);
+        this.ruleFiles = [];
+        this.compiledPatterns = [];
+        try {
+            const files = await readdir(resolvedDir);
+            const yarFiles = files.filter((f) => extname(f) === '.yar' || extname(f) === '.yara');
+            for (const file of yarFiles) {
+                const filePath = join(resolvedDir, file);
+                const content = await readFile(filePath, 'utf-8');
+                this.ruleFiles.push({ path: filePath, name: file, content });
+            }
+        }
+        catch (err) {
+            logger.warn(`Failed to load YARA rules from ${rulesDir}: ${err instanceof Error ? err.message : String(err)}`);
+            return 0;
+        }
+        // Try to use native YARA bindings
+        this.yaraAvailable = await this.checkNativeYara();
+        // Always compile fallback patterns
+        this.compiledPatterns = this.compilePatterns();
+        logger.info(`Loaded ${this.ruleFiles.length} YARA rule files (native YARA: ${this.yaraAvailable ? 'available' : 'fallback mode'})`);
+        return this.ruleFiles.length;
+    }
+    /**
+     * Recursively load YARA rules from a directory tree
+     * 從目錄樹遞迴載入 YARA 規則
+     *
+     * @param rulesDir - Root directory to scan / 要掃描的根目錄
+     * @param source - Source tag for loaded rules / 載入規則的來源標記
+     * @returns Number of rule files loaded / 載入的規則檔數量
+     */
+    async loadRulesRecursive(rulesDir, source) {
+        const resolvedDir = resolve(rulesDir);
+        const files = [];
+        const walk = async (dir) => {
+            let entries;
+            try {
+                entries = await readdir(dir, { withFileTypes: true, encoding: 'utf-8' });
+            }
+            catch {
+                return;
+            }
+            for (const entry of entries) {
+                const fullPath = join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    await walk(fullPath);
+                }
+                else if (entry.isFile()) {
+                    const ext = extname(entry.name).toLowerCase();
+                    if (ext !== '.yar' && ext !== '.yara')
+                        continue;
+                    try {
+                        const content = await readFile(fullPath, 'utf-8');
+                        files.push({ path: fullPath, name: entry.name, content, source });
+                    }
+                    catch {
+                        // Skip unreadable files
+                    }
+                }
+            }
+        };
+        try {
+            await walk(resolvedDir);
+        }
+        catch (err) {
+            logger.warn(`Failed to recursively load YARA rules from ${rulesDir}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        logger.info(`Recursively loaded ${files.length} YARA rule files from ${rulesDir} (source: ${source ?? 'unset'})`);
+        return files.length;
+    }
+    /**
+     * Load rules from both custom and community directories
+     * 從自訂和社群目錄載入規則
+     *
+     * @param customDir - Custom rules directory / 自訂規則目錄
+     * @param communityDir - Optional community rules directory / 可選的社群規則目錄
+     * @returns Total number of rule files loaded / 載入的規則檔總數
+     */
+    async loadAllRules(customDir, communityDir) {
+        this.ruleFiles = [];
+        this.compiledPatterns = [];
+        // Load custom rules recursively / 遞迴載入自訂規則
+        await this.loadFromDirRecursive(customDir, 'custom');
+        // Load community rules if directory exists / 如果目錄存在則載入社群規則
+        if (communityDir !== undefined) {
+            await this.loadFromDirRecursive(communityDir, 'community');
+        }
+        // Initialize scanning engine / 初始化掃描引擎
+        this.yaraAvailable = await this.checkNativeYara();
+        this.compiledPatterns = this.compilePatterns();
+        logger.info(`Loaded ${this.ruleFiles.length} total YARA rule files (native YARA: ${this.yaraAvailable ? 'available' : 'fallback mode'})`);
+        return this.ruleFiles.length;
+    }
+    /** Recursively collect .yar/.yara files and append to this.ruleFiles */
+    async loadFromDirRecursive(dir, source) {
+        const resolvedDir = resolve(dir);
+        const walk = async (currentDir) => {
+            let entries;
+            try {
+                entries = await readdir(currentDir, { withFileTypes: true, encoding: 'utf-8' });
+            }
+            catch {
+                return;
+            }
+            for (const entry of entries) {
+                const fullPath = join(currentDir, entry.name);
+                if (entry.isDirectory()) {
+                    await walk(fullPath);
+                }
+                else if (entry.isFile()) {
+                    const ext = extname(entry.name).toLowerCase();
+                    if (ext !== '.yar' && ext !== '.yara')
+                        continue;
+                    try {
+                        const content = await readFile(fullPath, 'utf-8');
+                        this.ruleFiles.push({ path: fullPath, name: entry.name, content, source });
+                    }
+                    catch {
+                        // Skip unreadable files
+                    }
+                }
+            }
+        };
+        try {
+            await walk(resolvedDir);
+        }
+        catch (err) {
+            logger.warn(`Failed to load YARA rules from ${dir}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /** Get number of loaded rule files / 取得已載入的規則檔數量 */
+    getRuleCount() {
+        return this.ruleFiles.length;
+    }
+    /** Check if native YARA is available / 檢查原生 YARA 是否可用 */
+    isNativeAvailable() {
+        return this.yaraAvailable;
+    }
+    /**
+     * Scan a single file / 掃描單一檔案
+     */
+    async scanFile(filePath) {
+        const start = Date.now();
+        const resolvedPath = resolve(filePath);
+        const fileBuffer = await readFile(resolvedPath);
+        const fileStats = await stat(resolvedPath);
+        const sha256 = createHash('sha256').update(fileBuffer).digest('hex');
+        let matches;
+        if (this.yaraAvailable) {
+            matches = await this.scanWithNativeYara(resolvedPath);
+        }
+        else {
+            matches = this.scanWithPatterns(fileBuffer.toString('utf-8'), resolvedPath);
+        }
+        return {
+            filePath: resolvedPath,
+            fileSize: fileStats.size,
+            sha256,
+            matches,
+            scannedAt: new Date().toISOString(),
+            durationMs: Date.now() - start,
+        };
+    }
+    /**
+     * Scan a directory recursively / 遞迴掃描目錄
+     */
+    async scanDirectory(dirPath, options = {}) {
+        const { maxDepth = 5, extensions } = options;
+        const results = [];
+        const resolvedDir = resolve(dirPath);
+        await this.walkDir(resolvedDir, 0, maxDepth, extensions, results);
+        return results;
+    }
+    /**
+     * Convert YARA scan result to SecurityEvent / 轉換 YARA 掃描結果為 SecurityEvent
+     */
+    toSecurityEvent(result) {
+        if (result.matches.length === 0)
+            return null;
+        const topMatch = result.matches[0];
+        const severity = this.inferSeverity(topMatch);
+        const mitreTechnique = topMatch.meta['mitre'] ?? topMatch.meta['mitre_attack'] ?? undefined;
+        // Determine source from the rule file that produced the top match / 從產生最高比對的規則檔判斷來源
+        const matchedRuleFile = this.ruleFiles.find((rf) => rf.name === topMatch.namespace);
+        const ruleSource = matchedRuleFile?.source;
+        return {
+            id: `yara-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+            timestamp: new Date(result.scannedAt),
+            source: 'file',
+            severity,
+            category: 'malware_detection',
+            description: `YARA match: ${result.matches.map((m) => m.rule).join(', ')} in ${result.filePath}`,
+            host: '',
+            raw: {
+                filePath: result.filePath,
+                sha256: result.sha256,
+                fileSize: result.fileSize,
+                yaraRules: result.matches.map((m) => m.rule),
+                tags: result.matches.flatMap((m) => m.tags),
+                mitreTechnique,
+                ruleSource,
+            },
+            metadata: {},
+        };
+    }
+    // -- Private methods --
+    async checkNativeYara() {
+        try {
+            await import('@automattic/yara');
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async scanWithNativeYara(filePath) {
+        try {
+            const yara = await import('@automattic/yara');
+            const results = [];
+            for (const ruleFile of this.ruleFiles) {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const yaraModule = yara;
+                const scanner = new yaraModule.default.Scanner();
+                scanner.addRules(ruleFile.content);
+                const scanResult = scanner.scanFile(filePath);
+                for (const match of scanResult.rules ?? []) {
+                    results.push({
+                        rule: match.id ?? match.rule ?? 'unknown',
+                        namespace: ruleFile.name,
+                        tags: match.tags ?? [],
+                        meta: match.meta ?? {},
+                        strings: (match.strings ?? []).map((s) => ({
+                            identifier: s.identifier,
+                            offset: s.offset,
+                            data: s.data.toString('utf-8').slice(0, 100),
+                        })),
+                    });
+                }
+            }
+            return results;
+        }
+        catch (err) {
+            logger.warn(`Native YARA scan failed, falling back to patterns: ${err instanceof Error ? err.message : String(err)}`);
+            const content = await readFile(filePath, 'utf-8').catch(() => '');
+            return this.scanWithPatterns(content, filePath);
+        }
+    }
+    /**
+     * Fallback pattern-based scanning / 退路：基於模式的掃描
+     * Extracts string patterns from YARA rules and matches against file content
+     */
+    scanWithPatterns(content, _filePath) {
+        const matches = [];
+        const lowerContent = content.toLowerCase();
+        for (const pattern of this.compiledPatterns) {
+            const matchedStrings = [];
+            for (const str of pattern.strings) {
+                const idx = lowerContent.indexOf(str.value.toLowerCase());
+                if (idx !== -1) {
+                    matchedStrings.push({
+                        identifier: str.identifier,
+                        offset: idx,
+                        data: content.slice(idx, idx + Math.min(str.value.length, 50)),
+                    });
+                }
+            }
+            // Check if enough strings matched based on condition
+            const requiredMatches = pattern.conditionAny ? 1 : pattern.strings.length;
+            if (matchedStrings.length >= requiredMatches && matchedStrings.length > 0) {
+                matches.push({
+                    rule: pattern.ruleName,
+                    namespace: pattern.sourceFile,
+                    tags: pattern.tags,
+                    meta: pattern.meta,
+                    strings: matchedStrings,
+                });
+            }
+        }
+        return matches;
+    }
+    /**
+     * Parse YARA rule files into compiled patterns for fallback matching
+     * 解析 YARA 規則檔為編譯的模式（退路比對用）
+     */
+    compilePatterns() {
+        const patterns = [];
+        for (const ruleFile of this.ruleFiles) {
+            const ruleBlocks = ruleFile.content.split(/\brule\s+/);
+            for (const block of ruleBlocks) {
+                if (!block.trim())
+                    continue;
+                const nameMatch = block.match(/^(\w+)\s*(?::\s*([\w\s]+))?\s*\{/);
+                if (!nameMatch)
+                    continue;
+                const ruleName = nameMatch[1] ?? 'unknown';
+                const tags = (nameMatch[2] ?? '').trim().split(/\s+/).filter(Boolean);
+                // Extract meta
+                const meta = {};
+                const metaBlock = block.match(/meta\s*:\s*([\s\S]*?)(?=strings\s*:|condition\s*:|$)/);
+                if (metaBlock?.[1]) {
+                    const metaLines = metaBlock[1].matchAll(/(\w+)\s*=\s*"([^"]*)"/g);
+                    for (const m of metaLines) {
+                        if (m[1] && m[2] !== undefined) {
+                            meta[m[1]] = m[2];
+                        }
+                    }
+                }
+                // Extract strings
+                const strings = [];
+                const stringsBlock = block.match(/strings\s*:\s*([\s\S]*?)(?=condition\s*:|$)/);
+                if (stringsBlock?.[1]) {
+                    const stringDefs = stringsBlock[1].matchAll(/(\$\w+)\s*=\s*"([^"]*)"/g);
+                    for (const s of stringDefs) {
+                        if (s[1] && s[2] !== undefined) {
+                            strings.push({ identifier: s[1], value: s[2] });
+                        }
+                    }
+                }
+                // Check condition for "any of them" vs "all of them"
+                const conditionBlock = block.match(/condition\s*:\s*([\s\S]*?)(?=\}|$)/);
+                const condition = conditionBlock?.[1]?.trim() ?? '';
+                const conditionAny = condition.includes('any of') || condition.includes('1 of') || condition.includes(' or ');
+                if (strings.length > 0) {
+                    patterns.push({
+                        ruleName,
+                        sourceFile: ruleFile.name,
+                        tags,
+                        meta,
+                        strings,
+                        conditionAny,
+                    });
+                }
+            }
+        }
+        return patterns;
+    }
+    inferSeverity(match) {
+        const severity = match.meta['severity']?.toLowerCase();
+        if (severity === 'critical')
+            return 'critical';
+        if (severity === 'high')
+            return 'high';
+        if (severity === 'medium')
+            return 'medium';
+        if (severity === 'low')
+            return 'low';
+        // Infer from tags
+        const tagStr = match.tags.join(' ').toLowerCase();
+        if (tagStr.includes('apt') || tagStr.includes('ransomware'))
+            return 'critical';
+        if (tagStr.includes('webshell') || tagStr.includes('malware'))
+            return 'high';
+        if (tagStr.includes('suspicious'))
+            return 'medium';
+        return 'medium';
+    }
+    async walkDir(dir, depth, maxDepth, extensions, results) {
+        if (depth > maxDepth)
+            return;
+        try {
+            const entries = await readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    // Skip common non-target directories
+                    if (['node_modules', '.git', '.cache', 'dist', '__pycache__'].includes(entry.name))
+                        continue;
+                    await this.walkDir(fullPath, depth + 1, maxDepth, extensions, results);
+                }
+                else if (entry.isFile()) {
+                    if (extensions && !extensions.includes(extname(entry.name)))
+                        continue;
+                    try {
+                        const result = await this.scanFile(fullPath);
+                        if (result.matches.length > 0) {
+                            results.push(result);
+                        }
+                    }
+                    catch {
+                        // Skip unreadable files
+                    }
+                }
+            }
+        }
+        catch {
+            // Skip unreadable directories
+        }
+    }
+}
+//# sourceMappingURL=yara-scanner.js.map

package/dist/rules/yara-scanner.js.map

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

package/dist/scoring/achievements.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Achievement System - Security gamification with badges and milestones
+ * 成就系統 - 安全遊戲化（徽章與里程碑）
+ *
+ * Tracks user progress and awards achievements for security best practices.
+ * Designed to encourage continuous security improvement.
+ *
+ * @module @panguard-ai/core/scoring/achievements
+ */
+/** Achievement definition / 成就定義 */
+export interface Achievement {
+    id: string;
+    name: string;
+    nameZhTW: string;
+    description: string;
+    descriptionZhTW: string;
+    category: 'scan' | 'guard' | 'response' | 'compliance' | 'streak';
+    icon: string;
+    condition: (stats: AchievementStats) => boolean;
+}
+/** User stats for achievement checking / 成就檢查的用戶統計 */
+export interface AchievementStats {
+    totalScans: number;
+    consecutiveSafeDays: number;
+    threatsBlocked: number;
+    vulnsFixedWithin24h: number;
+    totalVulnsFixed: number;
+    complianceScore: number;
+    securityScore: number;
+    allRecommendationsEnabled: boolean;
+    firstScanCompleted: boolean;
+    guardRunningDays: number;
+    rulesActive: number;
+    chatChannelsConfigured: number;
+}
+/** Earned achievement / 已獲得的成就 */
+export interface EarnedAchievement {
+    achievement: Achievement;
+    earnedAt: string;
+    notified: boolean;
+}
+/** All defined achievements / 所有已定義的成就 */
+export declare const ACHIEVEMENTS: Achievement[];
+/**
+ * Achievement Tracker - manages earned achievements
+ * 成就追蹤器 - 管理已獲得的成就
+ */
+export declare class AchievementTracker {
+    private earned;
+    /**
+     * Check stats against all achievements, return newly earned ones
+     * 檢查統計數據，回傳新獲得的成就
+     */
+    check(stats: AchievementStats): EarnedAchievement[];
+    /** Get all earned achievements / 取得所有已獲得的成就 */
+    getEarned(): EarnedAchievement[];
+    /** Get count of earned achievements / 取得已獲得成就數量 */
+    getEarnedCount(): number;
+    /** Get total available achievements / 取得所有可用成就數量 */
+    getTotalCount(): number;
+    /** Mark an achievement as notified / 標記成就已通知 */
+    markNotified(id: string): void;
+    /** Get un-notified achievements / 取得未通知的成就 */
+    getUnnotified(): EarnedAchievement[];
+    /** Load earned achievements from serialized data / 從序列化資料載入 */
+    load(data: Array<{
+        id: string;
+        earnedAt: string;
+    }>): void;
+    /** Serialize earned achievements / 序列化已獲得的成就 */
+    serialize(): Array<{
+        id: string;
+        earnedAt: string;
+    }>;
+}
+//# sourceMappingURL=achievements.d.ts.map

package/dist/scoring/achievements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"achievements.d.ts","sourceRoot":"","sources":["../../src/scoring/achievements.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,oCAAoC;AACpC,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,YAAY,GAAG,QAAQ,CAAC;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC;CACjD;AAED,sDAAsD;AACtD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,yBAAyB,EAAE,OAAO,CAAC;IACnC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,kCAAkC;AAClC,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,0CAA0C;AAC1C,eAAO,MAAM,YAAY,EAAE,WAAW,EAkIrC,CAAC;AAEF;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAA6C;IAE3D;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,iBAAiB,EAAE;IAqBnD,+CAA+C;IAC/C,SAAS,IAAI,iBAAiB,EAAE;IAIhC,mDAAmD;IACnD,cAAc,IAAI,MAAM;IAIxB,oDAAoD;IACpD,aAAa,IAAI,MAAM;IAIvB,gDAAgD;IAChD,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK9B,8CAA8C;IAC9C,aAAa,IAAI,iBAAiB,EAAE;IAIpC,+DAA+D;IAC/D,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAazD,gDAAgD;IAChD,SAAS,IAAI,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAMrD"}