@panguard-ai/core 0.1.0

package/dist/scoring/achievements.js

@@ -0,0 +1,211 @@
+/**
+ * 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
+ */
+import { createLogger } from '../utils/logger.js';
+const logger = createLogger('achievements');
+/** All defined achievements / 所有已定義的成就 */
+export const ACHIEVEMENTS = [
+    // Scan achievements
+    {
+        id: 'first_scan',
+        name: 'First Scan',
+        nameZhTW: 'First Scan',
+        description: 'Complete your first security scan',
+        descriptionZhTW: 'Complete your first security scan',
+        category: 'scan',
+        icon: '[SCAN]',
+        condition: (s) => s.firstScanCompleted,
+    },
+    {
+        id: 'scan_10',
+        name: 'Scan Veteran',
+        nameZhTW: 'Scan Veteran',
+        description: 'Complete 10 security scans',
+        descriptionZhTW: 'Complete 10 security scans',
+        category: 'scan',
+        icon: '[SCAN+]',
+        condition: (s) => s.totalScans >= 10,
+    },
+    // Streak achievements
+    {
+        id: 'safe_7_days',
+        name: '7 Day Clean Streak',
+        nameZhTW: '7 Day Clean Streak',
+        description: '7 consecutive days with zero threats',
+        descriptionZhTW: '7 consecutive days with zero threats',
+        category: 'streak',
+        icon: '[7DAY]',
+        condition: (s) => s.consecutiveSafeDays >= 7,
+    },
+    {
+        id: 'safe_30_days',
+        name: '30 Day Fortress',
+        nameZhTW: '30 Day Fortress',
+        description: '30 consecutive days with zero threats',
+        descriptionZhTW: '30 consecutive days with zero threats',
+        category: 'streak',
+        icon: '[30DAY]',
+        condition: (s) => s.consecutiveSafeDays >= 30,
+    },
+    // Response achievements
+    {
+        id: 'quick_fix',
+        name: 'Patch Champion',
+        nameZhTW: 'Patch Champion',
+        description: 'Fix all vulnerabilities within 24 hours',
+        descriptionZhTW: 'Fix all vulnerabilities within 24 hours',
+        category: 'response',
+        icon: '[FIX]',
+        condition: (s) => s.vulnsFixedWithin24h >= 5,
+    },
+    {
+        id: 'threat_hunter',
+        name: 'Threat Hunter',
+        nameZhTW: 'Threat Hunter',
+        description: 'Block 50 threats',
+        descriptionZhTW: 'Block 50 threats',
+        category: 'response',
+        icon: '[HUNT]',
+        condition: (s) => s.threatsBlocked >= 50,
+    },
+    {
+        id: 'first_block',
+        name: 'First Defense',
+        nameZhTW: 'First Defense',
+        description: 'Block your first threat',
+        descriptionZhTW: 'Block your first threat',
+        category: 'response',
+        icon: '[DEF]',
+        condition: (s) => s.threatsBlocked >= 1,
+    },
+    // Compliance achievements
+    {
+        id: 'compliance_80',
+        name: 'Compliance Ready',
+        nameZhTW: 'Compliance Ready',
+        description: 'Reach 80% compliance score',
+        descriptionZhTW: 'Reach 80% compliance score',
+        category: 'compliance',
+        icon: '[COMP]',
+        condition: (s) => s.complianceScore >= 80,
+    },
+    // Guard achievements
+    {
+        id: 'fully_armed',
+        name: 'Fully Armed',
+        nameZhTW: 'Fully Armed',
+        description: 'Enable all recommended security settings',
+        descriptionZhTW: 'Enable all recommended security settings',
+        category: 'guard',
+        icon: '[ARM]',
+        condition: (s) => s.allRecommendationsEnabled,
+    },
+    {
+        id: 'guard_7_days',
+        name: 'Vigilant Guardian',
+        nameZhTW: 'Vigilant Guardian',
+        description: 'Run Guard continuously for 7 days',
+        descriptionZhTW: 'Run Guard continuously for 7 days',
+        category: 'guard',
+        icon: '[GUARD]',
+        condition: (s) => s.guardRunningDays >= 7,
+    },
+    {
+        id: 'score_90',
+        name: 'Grade A Security',
+        nameZhTW: 'Grade A Security',
+        description: 'Achieve a security score of 90 or higher',
+        descriptionZhTW: 'Achieve a security score of 90 or higher',
+        category: 'guard',
+        icon: '[A+]',
+        condition: (s) => s.securityScore >= 90,
+    },
+    {
+        id: 'chat_connected',
+        name: 'Connected',
+        nameZhTW: 'Connected',
+        description: 'Configure at least one notification channel',
+        descriptionZhTW: 'Configure at least one notification channel',
+        category: 'guard',
+        icon: '[CHAT]',
+        condition: (s) => s.chatChannelsConfigured >= 1,
+    },
+];
+/**
+ * Achievement Tracker - manages earned achievements
+ * 成就追蹤器 - 管理已獲得的成就
+ */
+export class AchievementTracker {
+    earned = new Map();
+    /**
+     * Check stats against all achievements, return newly earned ones
+     * 檢查統計數據，回傳新獲得的成就
+     */
+    check(stats) {
+        const newlyEarned = [];
+        for (const achievement of ACHIEVEMENTS) {
+            if (this.earned.has(achievement.id))
+                continue;
+            if (achievement.condition(stats)) {
+                const earned = {
+                    achievement,
+                    earnedAt: new Date().toISOString(),
+                    notified: false,
+                };
+                this.earned.set(achievement.id, earned);
+                newlyEarned.push(earned);
+                logger.info(`Achievement unlocked: ${achievement.name} (${achievement.id})`);
+            }
+        }
+        return newlyEarned;
+    }
+    /** Get all earned achievements / 取得所有已獲得的成就 */
+    getEarned() {
+        return Array.from(this.earned.values());
+    }
+    /** Get count of earned achievements / 取得已獲得成就數量 */
+    getEarnedCount() {
+        return this.earned.size;
+    }
+    /** Get total available achievements / 取得所有可用成就數量 */
+    getTotalCount() {
+        return ACHIEVEMENTS.length;
+    }
+    /** Mark an achievement as notified / 標記成就已通知 */
+    markNotified(id) {
+        const earned = this.earned.get(id);
+        if (earned)
+            earned.notified = true;
+    }
+    /** Get un-notified achievements / 取得未通知的成就 */
+    getUnnotified() {
+        return Array.from(this.earned.values()).filter((e) => !e.notified);
+    }
+    /** Load earned achievements from serialized data / 從序列化資料載入 */
+    load(data) {
+        for (const item of data) {
+            const achievement = ACHIEVEMENTS.find((a) => a.id === item.id);
+            if (achievement) {
+                this.earned.set(item.id, {
+                    achievement,
+                    earnedAt: item.earnedAt,
+                    notified: true,
+                });
+            }
+        }
+    }
+    /** Serialize earned achievements / 序列化已獲得的成就 */
+    serialize() {
+        return Array.from(this.earned.values()).map((e) => ({
+            id: e.achievement.id,
+            earnedAt: e.earnedAt,
+        }));
+    }
+}
+//# sourceMappingURL=achievements.js.map

package/dist/scoring/achievements.js.map

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

package/dist/scoring/index.d.ts

@@ -0,0 +1,3 @@
+export { calculateSecurityScore, scoreToGrade, scoreToColor, generateScoreSummary, type ScoreFactor, type SecurityScoreSnapshot, type ScoreInput, } from './security-score.js';
+export { AchievementTracker, ACHIEVEMENTS, type Achievement, type AchievementStats, type EarnedAchievement, } from './achievements.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scoring/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC"}

package/dist/scoring/index.js

@@ -0,0 +1,3 @@
+export { calculateSecurityScore, scoreToGrade, scoreToColor, generateScoreSummary, } from './security-score.js';
+export { AchievementTracker, ACHIEVEMENTS, } from './achievements.js';
+//# sourceMappingURL=index.js.map

package/dist/scoring/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scoring/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,YAAY,EACZ,YAAY,EACZ,oBAAoB,GAIrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,kBAAkB,EAClB,YAAY,GAIb,MAAM,mBAAmB,CAAC"}

package/dist/scoring/security-score.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Security Score Engine - Weighted security posture scoring
+ * 安全分數引擎 - 加權安全態勢評分
+ *
+ * Calculates a 0-100 security score based on multiple factors:
+ * - Firewall status (15%)
+ * - Open port risk (15%)
+ * - Password policy (10%)
+ * - System updates (15%)
+ * - Security tools running (10%)
+ * - Recent threat count (15%)
+ * - Compliance progress (10%)
+ * - Response speed (10%)
+ *
+ * @module @panguard-ai/core/scoring/security-score
+ */
+/** Individual score factor / 個別評分因子 */
+export interface ScoreFactor {
+    name: string;
+    weight: number;
+    score: number;
+    description: string;
+}
+/** Security score snapshot / 安全分數快照 */
+export interface SecurityScoreSnapshot {
+    totalScore: number;
+    grade: 'A' | 'B' | 'C' | 'D' | 'F';
+    factors: ScoreFactor[];
+    calculatedAt: string;
+    trend: 'improving' | 'stable' | 'declining';
+    previousScore?: number;
+}
+/** Input data for score calculation / 計算分數的輸入資料 */
+export interface ScoreInput {
+    firewallEnabled: boolean;
+    openPorts: Array<{
+        port: number;
+        service?: string;
+    }>;
+    dangerousPorts: number[];
+    passwordPolicyStrength: number;
+    pendingUpdates: number;
+    securityToolsRunning: string[];
+    recentThreats24h: number;
+    recentThreats7d: number;
+    complianceProgress: number;
+    avgResponseTimeMs: number;
+}
+/**
+ * Calculate security score from system state
+ * 從系統狀態計算安全分數
+ */
+export declare function calculateSecurityScore(input: ScoreInput, previousScore?: number): SecurityScoreSnapshot;
+/** Convert score to letter grade / 分數轉換為等級 */
+export declare function scoreToGrade(score: number): 'A' | 'B' | 'C' | 'D' | 'F';
+/** Get color for score (for CLI/UI) / 取得分數的顏色 */
+export declare function scoreToColor(score: number): 'green' | 'yellow' | 'orange' | 'red';
+/** Generate human-readable summary / 產生人類可讀的摘要 */
+export declare function generateScoreSummary(snapshot: SecurityScoreSnapshot, lang?: 'en' | 'zh-TW'): string;
+//# sourceMappingURL=security-score.d.ts.map

package/dist/scoring/security-score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security-score.d.ts","sourceRoot":"","sources":["../../src/scoring/security-score.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,uCAAuC;AACvC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,uCAAuC;AACvC,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACnC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,mDAAmD;AACnD,MAAM,WAAW,UAAU;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAOD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,UAAU,EACjB,aAAa,CAAC,EAAE,MAAM,GACrB,qBAAqB,CAkKvB;AAED,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAMvE;AAED,iDAAiD;AACjD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAKjF;AAED,kDAAkD;AAClD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,qBAAqB,EAC/B,IAAI,GAAE,IAAI,GAAG,OAAc,GAC1B,MAAM,CA8BR"}

package/dist/scoring/security-score.js

@@ -0,0 +1,211 @@
+/**
+ * Security Score Engine - Weighted security posture scoring
+ * 安全分數引擎 - 加權安全態勢評分
+ *
+ * Calculates a 0-100 security score based on multiple factors:
+ * - Firewall status (15%)
+ * - Open port risk (15%)
+ * - Password policy (10%)
+ * - System updates (15%)
+ * - Security tools running (10%)
+ * - Recent threat count (15%)
+ * - Compliance progress (10%)
+ * - Response speed (10%)
+ *
+ * @module @panguard-ai/core/scoring/security-score
+ */
+import { createLogger } from '../utils/logger.js';
+const logger = createLogger('security-score');
+/** Score thresholds for actions / 分數行動閾值 */
+const DANGEROUS_PORTS = new Set([
+    21, 22, 23, 25, 135, 139, 445, 1433, 3306, 3389, 5432, 5900, 6379, 27017,
+]);
+/**
+ * Calculate security score from system state
+ * 從系統狀態計算安全分數
+ */
+export function calculateSecurityScore(input, previousScore) {
+    const factors = [];
+    // 1. Firewall (15%)
+    const firewallScore = input.firewallEnabled ? 100 : 0;
+    factors.push({
+        name: 'firewall',
+        weight: 0.15,
+        score: firewallScore,
+        description: input.firewallEnabled
+            ? 'Firewall is active'
+            : 'Firewall is disabled - critical risk',
+    });
+    // 2. Open Port Risk (15%)
+    const dangerousOpenPorts = input.openPorts.filter((p) => DANGEROUS_PORTS.has(p.port) || input.dangerousPorts.includes(p.port));
+    const portScore = dangerousOpenPorts.length === 0
+        ? 100
+        : dangerousOpenPorts.length <= 1
+            ? 70
+            : dangerousOpenPorts.length <= 3
+                ? 40
+                : 10;
+    factors.push({
+        name: 'open_ports',
+        weight: 0.15,
+        score: portScore,
+        description: dangerousOpenPorts.length === 0
+            ? 'No dangerous ports exposed'
+            : `${dangerousOpenPorts.length} dangerous port(s) open`,
+    });
+    // 3. Password Policy (10%)
+    factors.push({
+        name: 'password_policy',
+        weight: 0.1,
+        score: input.passwordPolicyStrength,
+        description: input.passwordPolicyStrength >= 80
+            ? 'Strong password policy'
+            : input.passwordPolicyStrength >= 50
+                ? 'Moderate password policy'
+                : 'Weak password policy',
+    });
+    // 4. System Updates (15%)
+    const updateScore = input.pendingUpdates === 0
+        ? 100
+        : input.pendingUpdates <= 5
+            ? 70
+            : input.pendingUpdates <= 20
+                ? 40
+                : 10;
+    factors.push({
+        name: 'system_updates',
+        weight: 0.15,
+        score: updateScore,
+        description: input.pendingUpdates === 0
+            ? 'System is fully updated'
+            : `${input.pendingUpdates} pending update(s)`,
+    });
+    // 5. Security Tools (10%)
+    const toolScore = input.securityToolsRunning.length >= 3
+        ? 100
+        : input.securityToolsRunning.length === 2
+            ? 80
+            : input.securityToolsRunning.length === 1
+                ? 50
+                : 0;
+    factors.push({
+        name: 'security_tools',
+        weight: 0.1,
+        score: toolScore,
+        description: input.securityToolsRunning.length === 0
+            ? 'No security tools detected'
+            : `${input.securityToolsRunning.length} security tool(s) active`,
+    });
+    // 6. Recent Threats (15%)
+    const threatScore = input.recentThreats24h === 0 && input.recentThreats7d === 0
+        ? 100
+        : input.recentThreats24h === 0
+            ? 80
+            : input.recentThreats24h <= 3
+                ? 50
+                : input.recentThreats24h <= 10
+                    ? 25
+                    : 5;
+    factors.push({
+        name: 'recent_threats',
+        weight: 0.15,
+        score: threatScore,
+        description: input.recentThreats24h === 0
+            ? 'No threats in the last 24 hours'
+            : `${input.recentThreats24h} threat(s) in the last 24 hours`,
+    });
+    // 7. Compliance Progress (10%)
+    factors.push({
+        name: 'compliance',
+        weight: 0.1,
+        score: input.complianceProgress,
+        description: input.complianceProgress >= 80
+            ? 'Good compliance progress'
+            : input.complianceProgress >= 50
+                ? 'Moderate compliance progress'
+                : 'Compliance needs attention',
+    });
+    // 8. Response Speed (10%)
+    const responseScore = input.avgResponseTimeMs <= 60000
+        ? 100 // < 1 min
+        : input.avgResponseTimeMs <= 300000
+            ? 80 // < 5 min
+            : input.avgResponseTimeMs <= 900000
+                ? 50 // < 15 min
+                : input.avgResponseTimeMs <= 3600000
+                    ? 25 // < 1 hour
+                    : 10;
+    factors.push({
+        name: 'response_speed',
+        weight: 0.1,
+        score: responseScore,
+        description: `Average response time: ${Math.round(input.avgResponseTimeMs / 1000)}s`,
+    });
+    // Calculate weighted total
+    const totalScore = Math.round(factors.reduce((sum, f) => sum + f.score * f.weight, 0));
+    // Determine trend
+    let trend = 'stable';
+    if (previousScore !== undefined) {
+        if (totalScore > previousScore + 2)
+            trend = 'improving';
+        else if (totalScore < previousScore - 2)
+            trend = 'declining';
+    }
+    const snapshot = {
+        totalScore,
+        grade: scoreToGrade(totalScore),
+        factors,
+        calculatedAt: new Date().toISOString(),
+        trend,
+        previousScore,
+    };
+    logger.info(`Security score calculated: ${totalScore}/100 (Grade: ${snapshot.grade}, Trend: ${trend})`);
+    return snapshot;
+}
+/** Convert score to letter grade / 分數轉換為等級 */
+export function scoreToGrade(score) {
+    if (score >= 90)
+        return 'A';
+    if (score >= 75)
+        return 'B';
+    if (score >= 60)
+        return 'C';
+    if (score >= 40)
+        return 'D';
+    return 'F';
+}
+/** Get color for score (for CLI/UI) / 取得分數的顏色 */
+export function scoreToColor(score) {
+    if (score >= 80)
+        return 'green';
+    if (score >= 60)
+        return 'yellow';
+    if (score >= 40)
+        return 'orange';
+    return 'red';
+}
+/** Generate human-readable summary / 產生人類可讀的摘要 */
+export function generateScoreSummary(snapshot, lang = 'en') {
+    const { totalScore, grade, trend, factors } = snapshot;
+    const trendText = lang === 'zh-TW'
+        ? trend === 'improving'
+            ? 'improving'
+            : trend === 'declining'
+                ? 'declining'
+                : 'stable'
+        : trend;
+    const trendArrow = trend === 'improving' ? '+' : trend === 'declining' ? '-' : '=';
+    const worstFactors = [...factors]
+        .sort((a, b) => a.score - b.score)
+        .slice(0, 3)
+        .filter((f) => f.score < 70);
+    let summary = lang === 'zh-TW'
+        ? `Security Score: ${totalScore}/100 (${grade}) [${trendArrow} ${trendText}]`
+        : `Security Score: ${totalScore}/100 (${grade}) [${trendArrow} ${trendText}]`;
+    if (worstFactors.length > 0) {
+        const items = worstFactors.map((f) => `  - ${f.name}: ${f.score}/100 - ${f.description}`);
+        summary += `\n\nTop issues:\n${items.join('\n')}`;
+    }
+    return summary;
+}
+//# sourceMappingURL=security-score.js.map

package/dist/scoring/security-score.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Core type definitions for Panguard AI platform
+ * Panguard 安全平台核心類型定義
+ *
+ * @module @panguard-ai/core/types
+ */
+/**
+ * Supported languages / 支援的語言
+ */
+export type Language = 'zh-TW' | 'en';
+/**
+ * Severity levels for security events / 安全事件嚴重等級
+ */
+export type Severity = 'info' | 'low' | 'medium' | 'high' | 'critical';
+/**
+ * Security event source types / 安全事件來源類型
+ */
+export type EventSource = 'windows_event' | 'syslog' | 'network' | 'process' | 'file' | 'falco' | 'suricata';
+/**
+ * Base application configuration / 基礎應用程式配置
+ */
+export interface BaseConfig {
+    /** Application language / 應用語言 */
+    language: Language;
+    /** Debug mode / 除錯模式 */
+    debug: boolean;
+    /** Log level / 日誌等級 */
+    logLevel: 'info' | 'warn' | 'error' | 'debug';
+}
+/**
+ * Standardized security event format / 標準化安全事件格式
+ *
+ * All security events from different sources are normalized to this format.
+ * 所有來自不同來源的安全事件都會標準化為此格式。
+ */
+export interface SecurityEvent {
+    /** Unique event identifier / 唯一事件識別碼 */
+    id: string;
+    /** Event timestamp / 事件時間戳 */
+    timestamp: Date;
+    /** Event source type / 事件來源類型 */
+    source: EventSource;
+    /** Severity level / 嚴重等級 */
+    severity: Severity;
+    /** MITRE ATT&CK category / MITRE ATT&CK 分類 */
+    category: string;
+    /** Event description / 事件描述 */
+    description: string;
+    /** Raw event data / 原始事件資料 */
+    raw: unknown;
+    /** Hostname / 主機名稱 */
+    host: string;
+    /** Additional metadata / 額外中繼資料 */
+    metadata: Record<string, unknown>;
+}
+/**
+ * Log entry format for structured logging / 結構化日誌條目格式
+ */
+export interface LogEntry {
+    /** ISO timestamp / ISO 時間戳 */
+    timestamp: string;
+    /** Log level / 日誌等級 */
+    level: 'info' | 'warn' | 'error' | 'debug';
+    /** Log message / 日誌訊息 */
+    message: string;
+    /** Module that generated the log / 產生日誌的模組 */
+    module: string;
+    /** Additional context / 額外上下文 */
+    context?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC;AAEtC;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,eAAe,GACf,QAAQ,GACR,SAAS,GACT,SAAS,GACT,MAAM,GACN,OAAO,GACP,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,QAAQ,EAAE,QAAQ,CAAC;IACnB,wBAAwB;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,uBAAuB;IACvB,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;CAC/C;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,8BAA8B;IAC9B,SAAS,EAAE,IAAI,CAAC;IAChB,iCAAiC;IACjC,MAAM,EAAE,WAAW,CAAC;IACpB,4BAA4B;IAC5B,QAAQ,EAAE,QAAQ,CAAC;IACnB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,GAAG,EAAE,OAAO,CAAC;IACb,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IAC3C,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC"}

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Core type definitions for Panguard AI platform
+ * Panguard 安全平台核心類型定義
+ *
+ * @module @panguard-ai/core/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/utils/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Utility module exports
+ * 工具模組匯出
+ *
+ * @module @panguard-ai/core/utils
+ */
+export { createLogger, setLogLevel } from './logger.js';
+export type { Logger } from './logger.js';
+export { validateInput, sanitizeString, validateFilePath } from './validation.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,9 @@
+/**
+ * Utility module exports
+ * 工具模組匯出
+ *
+ * @module @panguard-ai/core/utils
+ */
+export { createLogger, setLogLevel } from './logger.js';
+export { validateInput, sanitizeString, validateFilePath } from './validation.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}