@panguard-ai/panguard-scan 0.1.0

package/dist/cli/commands.d.ts

@@ -0,0 +1,13 @@
+/**
+ * PanguardScan CLI command implementations
+ * PanguardScan CLI 指令實作
+ *
+ * @module @panguard-ai/panguard-scan/cli/commands
+ */
+import type { ScanConfig } from '../scanners/types.js';
+/**
+ * Execute a security scan and generate a report
+ * 執行安全掃描並產生報告
+ */
+export declare function executeScan(config: ScanConfig): Promise<void>;
+//# sourceMappingURL=commands.d.ts.map

package/dist/cli/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqBH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAIvD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA+InE"}

package/dist/cli/commands.js

@@ -0,0 +1,132 @@
+/**
+ * PanguardScan CLI command implementations
+ * PanguardScan CLI 指令實作
+ *
+ * @module @panguard-ai/panguard-scan/cli/commands
+ */
+import { initI18n, t, createLogger, setLogLevel, c, colorSeverity, banner, spinner, table, box, scoreDisplay, divider, formatDuration, symbols, statusPanel, } from '@panguard-ai/core';
+import { runScan } from '../scanners/index.js';
+import { generatePdfReport } from '../report/index.js';
+const logger = createLogger('panguard-scan:cli');
+/**
+ * Execute a security scan and generate a report
+ * 執行安全掃描並產生報告
+ */
+export async function executeScan(config) {
+    // Suppress structured JSON logs unless verbose mode
+    if (!config.verbose) {
+        setLogLevel('silent');
+    }
+    await initI18n(config.lang);
+    // Banner
+    console.log(banner());
+    const mode = config.depth === 'quick' ? t('panguard-scan:cli.quickMode') : t('panguard-scan:cli.fullMode');
+    console.log(`  ${symbols.scan} ${mode}`);
+    console.log('');
+    // Scan with spinner
+    const sp = spinner(t('panguard-scan:cli.scanning', { defaultValue: 'Scanning system security...' }));
+    const result = await runScan(config);
+    sp.succeed(t('panguard-scan:cli.complete') + ` ${c.dim(`(${formatDuration(result.scanDuration)})`)}`);
+    // Security Score
+    const safetyScore = Math.max(0, 100 - result.riskScore);
+    const grade = safetyScore >= 90
+        ? 'A'
+        : safetyScore >= 75
+            ? 'B'
+            : safetyScore >= 60
+                ? 'C'
+                : safetyScore >= 40
+                    ? 'D'
+                    : 'F';
+    console.log(scoreDisplay(safetyScore, grade));
+    // Status panel (matching mockup "PANGUARD AI Security Status")
+    const riskLabel = t(`panguard-scan:severity.${result.riskLevel}`);
+    console.log(statusPanel('PANGUARD AI Security Status', [
+        {
+            label: 'Status',
+            value: result.riskScore <= 25
+                ? c.safe('PROTECTED')
+                : result.riskScore <= 50
+                    ? c.caution('AT RISK')
+                    : c.critical('VULNERABLE'),
+            status: result.riskScore <= 25 ? 'safe' : result.riskScore <= 50 ? 'caution' : 'critical',
+        },
+        {
+            label: 'Risk Score',
+            value: `${result.riskScore}/100 (${riskLabel})`,
+            status: result.riskScore <= 25 ? 'safe' : result.riskScore <= 50 ? 'caution' : 'critical',
+        },
+        {
+            label: 'Issues Found',
+            value: String(result.findings.length),
+            status: result.findings.length === 0 ? 'safe' : 'caution',
+        },
+        {
+            label: 'Scan Duration',
+            value: formatDuration(result.scanDuration),
+        },
+    ]));
+    // Findings table
+    if (result.findings.length > 0) {
+        console.log(divider(`${result.findings.length} Finding(s)`));
+        console.log('');
+        const columns = [
+            { header: '#', key: 'num', width: 4, align: 'right' },
+            { header: 'Severity', key: 'severity', width: 10 },
+            { header: 'Finding', key: 'title', width: 42 },
+            { header: 'Status', key: 'status', width: 8 },
+        ];
+        const coloredRows = result.findings.map((finding, i) => ({
+            num: String(i + 1),
+            severity: colorSeverity(finding.severity),
+            title: finding.title,
+            status: finding['fixed']
+                ? c.safe('Fixed')
+                : c.critical('Open'),
+        }));
+        console.log(table(columns, coloredRows));
+        console.log('');
+        // Summary counts
+        const critCount = result.findings.filter((f) => f.severity === 'critical').length;
+        const highCount = result.findings.filter((f) => f.severity === 'high').length;
+        const medCount = result.findings.filter((f) => f.severity === 'medium').length;
+        const lowCount = result.findings.filter((f) => f.severity === 'low').length;
+        const parts = [];
+        if (critCount > 0)
+            parts.push(c.critical(`${critCount} Critical`));
+        if (highCount > 0)
+            parts.push(c.alert(`${highCount} High`));
+        if (medCount > 0)
+            parts.push(c.caution(`${medCount} Medium`));
+        if (lowCount > 0)
+            parts.push(c.sage(`${lowCount} Low`));
+        if (parts.length > 0) {
+            console.log(`  ${parts.join(c.dim(' | '))}`);
+            console.log('');
+        }
+    }
+    else {
+        console.log(box(`${symbols.pass} ${t('panguard-scan:cli.noFindings', { defaultValue: 'No security issues found!' })}`, { borderColor: c.safe, title: 'All Clear' }));
+        console.log('');
+    }
+    // PDF report
+    if (config.output) {
+        const reportSp = spinner(t('panguard-scan:cli.generating', { defaultValue: 'Generating PDF report...' }));
+        try {
+            await generatePdfReport(result, config.output, config.lang);
+            reportSp.succeed(t('panguard-scan:cli.reportSaved', {
+                path: config.output,
+                defaultValue: `Report saved: ${config.output}`,
+            }));
+        }
+        catch (err) {
+            reportSp.fail(`Error generating report: ${err instanceof Error ? err.message : err}`);
+            logger.error('Failed to generate PDF report', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    console.log(c.dim(`  Scan completed at ${new Date().toLocaleString()}`));
+    console.log('');
+}
+//# sourceMappingURL=commands.js.map

package/dist/cli/commands.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * PanguardScan CLI Entry Point
+ * PanguardScan 命令列介面進入點
+ *
+ * @module @panguard-ai/panguard-scan/cli
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG"}

package/dist/cli/index.js

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+/**
+ * PanguardScan CLI Entry Point
+ * PanguardScan 命令列介面進入點
+ *
+ * @module @panguard-ai/panguard-scan/cli
+ */
+import { Command } from 'commander';
+import { setLogLevel } from '@panguard-ai/core';
+import { PANGUARD_SCAN_VERSION } from '../index.js';
+import { executeScan } from './commands.js';
+import { runRemoteScan } from '../scanners/remote/index.js';
+const program = new Command();
+program
+    .name('panguard-scan')
+    .description('PanguardScan - 60-second security health check tool / 60 秒資安健檢工具')
+    .version(PANGUARD_SCAN_VERSION)
+    .option('--quick', 'Quick scan mode (~30 seconds) / 快速掃描模式', false)
+    .option('--output <path>', 'Output PDF report path / 輸出 PDF 報告路徑', 'panguard-scan-report.pdf')
+    .option('--lang <language>', 'Language: en or zh-TW / 語言', 'en')
+    .option('--verbose', 'Verbose output / 詳細輸出', false)
+    .option('--json', 'Output pure JSON to stdout (for AI agents) / 輸出純 JSON', false)
+    .option('--target <host>', 'Remote target (IP or domain) / 遠端目標')
+    .action(async (options) => {
+    const lang = options.lang === 'zh-TW' ? 'zh-TW' : 'en';
+    // Remote scan mode
+    if (options.target) {
+        setLogLevel('silent');
+        const result = await runRemoteScan({ target: options.target, lang });
+        const safetyScore = Math.max(0, 100 - result.riskScore);
+        const grade = safetyScore >= 90
+            ? 'A'
+            : safetyScore >= 75
+                ? 'B'
+                : safetyScore >= 60
+                    ? 'C'
+                    : safetyScore >= 40
+                        ? 'D'
+                        : 'F';
+        if (options.json) {
+            console.log(JSON.stringify({
+                version: PANGUARD_SCAN_VERSION,
+                timestamp: result.scannedAt,
+                target: options.target,
+                risk_score: result.riskScore,
+                risk_level: result.riskLevel,
+                grade,
+                scan_duration_ms: result.scanDuration,
+                findings_count: result.findings.length,
+                findings: result.findings.map((f, i) => ({
+                    id: i + 1,
+                    severity: f.severity,
+                    title: f.title,
+                    category: f.category,
+                    description: f.description,
+                    remediation: f.remediation,
+                })),
+                powered_by: 'Panguard AI',
+                agent_friendly: true,
+            }, null, 2));
+        }
+        else {
+            // Human-friendly remote output delegated to executeScan is not available here;
+            // print a simple summary
+            const { banner, scoreDisplay, symbols, c, formatDuration } = await import('@panguard-ai/core');
+            console.log(banner());
+            console.log(`  ${symbols.scan} Remote Scan: ${c.bold(options.target)}`);
+            console.log(scoreDisplay(safetyScore, grade));
+            console.log(`  Findings: ${result.findings.length} | Duration: ${formatDuration(result.scanDuration)}`);
+            for (const f of result.findings) {
+                console.log(`  ${c.dim('-')} [${f.severity.toUpperCase()}] ${f.title}`);
+            }
+            console.log('');
+        }
+        return;
+    }
+    // JSON mode for local scan
+    if (options.json) {
+        setLogLevel('silent');
+        const { runScan } = await import('../scanners/index.js');
+        const result = await runScan({
+            depth: options.quick ? 'quick' : 'full',
+            lang,
+            verbose: false,
+        });
+        const safetyScore = Math.max(0, 100 - result.riskScore);
+        const grade = safetyScore >= 90
+            ? 'A'
+            : safetyScore >= 75
+                ? 'B'
+                : safetyScore >= 60
+                    ? 'C'
+                    : safetyScore >= 40
+                        ? 'D'
+                        : 'F';
+        console.log(JSON.stringify({
+            version: PANGUARD_SCAN_VERSION,
+            timestamp: result.scannedAt,
+            target: 'localhost',
+            risk_score: result.riskScore,
+            risk_level: result.riskLevel,
+            grade,
+            scan_duration_ms: result.scanDuration,
+            findings_count: result.findings.length,
+            findings: result.findings.map((f, i) => ({
+                id: i + 1,
+                severity: f.severity,
+                title: f.title,
+                category: f.category,
+                description: f.description,
+                remediation: f.remediation,
+            })),
+            system: {
+                os: `${result.discovery.os.distro} ${result.discovery.os.version}`,
+                arch: result.discovery.os.arch,
+                open_ports: result.discovery.openPorts.length,
+                running_services: result.discovery.services.length,
+                firewall_enabled: result.discovery.security.firewall.enabled,
+                security_tools_detected: result.discovery.security.existingTools.length,
+            },
+            powered_by: 'Panguard AI',
+            agent_friendly: true,
+        }, null, 2));
+        return;
+    }
+    // Normal human-friendly scan
+    await executeScan({
+        depth: options.quick ? 'quick' : 'full',
+        lang,
+        output: options.output,
+        verbose: options.verbose,
+    });
+});
+program.parseAsync().catch((err) => {
+    console.error('Fatal error:', err instanceof Error ? err.message : err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * PanguardScan - Security Scanning CLI Tool
+ * PanguardScan - 資安健檢命令列工具
+ *
+ * Performs comprehensive security scans and generates PDF reports.
+ * 執行全面的安全掃描並產生 PDF 報告。
+ *
+ * @module @panguard-ai/panguard-scan
+ */
+/** PanguardScan version / PanguardScan 版本 */
+export declare const PANGUARD_SCAN_VERSION = "0.1.0";
+/** PanguardScan product name / PanguardScan 產品名稱 */
+export declare const CLAWSCAN_NAME = "PanguardScan";
+export { runScan } from './scanners/index.js';
+export type { ScanConfig, ScanResult, Finding } from './scanners/types.js';
+export { sortBySeverity, SEVERITY_ORDER } from './scanners/types.js';
+export { runRemoteScan } from './scanners/remote/index.js';
+export type { RemoteScanConfig } from './scanners/remote/index.js';
+export { generatePdfReport } from './report/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,6CAA6C;AAC7C,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAE7C,oDAAoD;AACpD,eAAO,MAAM,aAAa,iBAAiB,CAAC;AAG5C,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+/**
+ * PanguardScan - Security Scanning CLI Tool
+ * PanguardScan - 資安健檢命令列工具
+ *
+ * Performs comprehensive security scans and generates PDF reports.
+ * 執行全面的安全掃描並產生 PDF 報告。
+ *
+ * @module @panguard-ai/panguard-scan
+ */
+/** PanguardScan version / PanguardScan 版本 */
+export const PANGUARD_SCAN_VERSION = '0.1.0';
+/** PanguardScan product name / PanguardScan 產品名稱 */
+export const CLAWSCAN_NAME = 'PanguardScan';
+// Scanner exports / 掃描器匯出
+export { runScan } from './scanners/index.js';
+export { sortBySeverity, SEVERITY_ORDER } from './scanners/types.js';
+// Remote scanner exports / 遠端掃描器匯出
+export { runRemoteScan } from './scanners/remote/index.js';
+// Report exports / 報告匯出
+export { generatePdfReport } from './report/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,6CAA6C;AAC7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAO,CAAC;AAE7C,oDAAoD;AACpD,MAAM,CAAC,MAAM,aAAa,GAAG,cAAc,CAAC;AAE5C,0BAA0B;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErE,mCAAmC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAG3D,wBAAwB;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/report/compliance-map.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Taiwan Information Security Management Act compliance mapping
+ * 台灣資通安全管理法合規對照
+ *
+ * Maps security findings to relevant articles of the Taiwan ISMS
+ * (Information Security Management System) framework.
+ * 將安全發現對應到台灣資通安全管理法（ISMS）框架的相關條文。
+ *
+ * @module @panguard-ai/panguard-scan/report/compliance-map
+ */
+import type { Finding } from '../scanners/types.js';
+/**
+ * A single compliance framework entry
+ * 單一合規框架條目
+ */
+export interface ComplianceEntry {
+    /**
+     * Article reference number (e.g. "4.1")
+     * 條文參照編號（例如 "4.1"）
+     */
+    ref: string;
+    /**
+     * Article title in English
+     * 條文標題（英文）
+     */
+    titleEn: string;
+    /**
+     * Article title in Traditional Chinese
+     * 條文標題（繁體中文）
+     */
+    titleZh: string;
+    /**
+     * Article description in English
+     * 條文描述（英文）
+     */
+    descriptionEn: string;
+    /**
+     * Article description in Traditional Chinese
+     * 條文描述（繁體中文）
+     */
+    descriptionZh: string;
+    /**
+     * Finding categories that map to this article
+     * 對應到此條文的發現分類
+     */
+    categories: string[];
+}
+/**
+ * Compliance status for a single article with related findings
+ * 單一條文的合規狀態及相關發現
+ */
+export interface ComplianceStatus extends ComplianceEntry {
+    /**
+     * Compliance status assessment
+     * 合規狀態評估
+     */
+    status: 'compliant' | 'non_compliant' | 'partial' | 'not_applicable';
+    /**
+     * Security findings related to this article
+     * 與此條文相關的安全發現
+     */
+    relatedFindings: Finding[];
+}
+/**
+ * Retrieve all compliance framework entries
+ * 取得所有合規框架條目
+ *
+ * @returns Array of compliance entries / 合規條目陣列
+ */
+export declare function getComplianceEntries(): ComplianceEntry[];
+/**
+ * Map security findings to compliance framework articles
+ * 將安全發現對應到合規框架條文
+ *
+ * Evaluates each compliance article against the provided findings to
+ * determine compliance status. Articles with critical or high severity
+ * findings are marked non-compliant; those with medium or low findings
+ * are marked partial; articles with no related findings are marked
+ * compliant; articles whose categories have no matching findings are
+ * marked not-applicable when there are no findings at all in any
+ * related category.
+ *
+ * 根據提供的發現評估每個合規條文以判定合規狀態。具有嚴重或高嚴重度發現的
+ * 條文標記為不合規；具有中等或低嚴重度發現的標記為部分合規；沒有相關發現
+ * 的條文標記為合規；當完全沒有任何相關分類的發現時標記為不適用。
+ *
+ * @param findings - Array of security findings / 安全發現陣列
+ * @returns Array of compliance statuses / 合規狀態陣列
+ */
+export declare function mapFindingsToCompliance(findings: Finding[]): ComplianceStatus[];
+//# sourceMappingURL=compliance-map.d.ts.map

package/dist/report/compliance-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compliance-map.d.ts","sourceRoot":"","sources":["../../src/report/compliance-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD;;;OAGG;IACH,MAAM,EAAE,WAAW,GAAG,eAAe,GAAG,SAAS,GAAG,gBAAgB,CAAC;IAErE;;;OAGG;IACH,eAAe,EAAE,OAAO,EAAE,CAAC;CAC5B;AAkGD;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,eAAe,EAAE,CAExD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,gBAAgB,EAAE,CAmC/E"}

package/dist/report/compliance-map.js

@@ -0,0 +1,156 @@
+/**
+ * Taiwan Information Security Management Act compliance mapping
+ * 台灣資通安全管理法合規對照
+ *
+ * Maps security findings to relevant articles of the Taiwan ISMS
+ * (Information Security Management System) framework.
+ * 將安全發現對應到台灣資通安全管理法（ISMS）框架的相關條文。
+ *
+ * @module @panguard-ai/panguard-scan/report/compliance-map
+ */
+/**
+ * Taiwan ISMS compliance entries
+ * 台灣資通安全管理法合規條目
+ */
+const COMPLIANCE_ENTRIES = [
+    {
+        ref: '4.1',
+        titleEn: 'Access Control',
+        titleZh: '存取控制',
+        descriptionEn: 'Establish and enforce access control policies to restrict unauthorized access to information systems and data.',
+        descriptionZh: '建立並執行存取控制政策，限制對資訊系統和資料的未經授權存取。',
+        categories: ['password', 'access'],
+    },
+    {
+        ref: '4.2',
+        titleEn: 'System Protection',
+        titleZh: '系統保護',
+        descriptionEn: 'Implement system-level protections including firewalls, intrusion detection, and endpoint security measures.',
+        descriptionZh: '實施系統層級保護措施，包括防火牆、入侵偵測和端點安全措施。',
+        categories: ['system', 'firewall'],
+    },
+    {
+        ref: '4.3',
+        titleEn: 'Network Security',
+        titleZh: '網路安全',
+        descriptionEn: 'Secure network infrastructure through segmentation, monitoring, and traffic analysis.',
+        descriptionZh: '透過網路分段、監控和流量分析來保護網路基礎設施。',
+        categories: ['network'],
+    },
+    {
+        ref: '4.4',
+        titleEn: 'Encryption Management',
+        titleZh: '加密管理',
+        descriptionEn: 'Apply appropriate encryption standards for data in transit and at rest, and manage certificates properly.',
+        descriptionZh: '對傳輸中和靜態資料套用適當的加密標準，並妥善管理憑證。',
+        categories: ['certificate'],
+    },
+    {
+        ref: '4.5',
+        titleEn: 'Authentication',
+        titleZh: '身分驗證',
+        descriptionEn: 'Enforce strong authentication mechanisms including password policies and multi-factor authentication.',
+        descriptionZh: '強制執行強健的身分驗證機制，包括密碼政策和多因素身分驗證。',
+        categories: ['password', 'authentication'],
+    },
+    {
+        ref: '4.6',
+        titleEn: 'Monitoring',
+        titleZh: '監控管理',
+        descriptionEn: 'Continuously monitor systems for security events, anomalies, and policy violations.',
+        descriptionZh: '持續監控系統的安全事件、異常行為和政策違規。',
+        categories: ['system', 'monitoring'],
+    },
+    {
+        ref: '4.7',
+        titleEn: 'Incident Response',
+        titleZh: '事件應變',
+        descriptionEn: 'Establish procedures for detecting, reporting, and responding to security incidents.',
+        descriptionZh: '建立偵測、報告和回應安全事件的程序。',
+        categories: ['incident'],
+    },
+    {
+        ref: '4.8',
+        titleEn: 'Asset Management',
+        titleZh: '資產管理',
+        descriptionEn: 'Identify, classify, and manage information assets throughout their lifecycle.',
+        descriptionZh: '在資訊資產的整個生命週期中進行識別、分類和管理。',
+        categories: ['system', 'access'],
+    },
+    {
+        ref: '4.9',
+        titleEn: 'Update Management',
+        titleZh: '更新管理',
+        descriptionEn: 'Maintain systems with timely security patches and software updates to address known vulnerabilities.',
+        descriptionZh: '透過及時的安全修補和軟體更新來維護系統，以解決已知弱點。',
+        categories: ['updates', 'system'],
+    },
+    {
+        ref: '4.10',
+        titleEn: 'Audit',
+        titleZh: '稽核管理',
+        descriptionEn: 'Conduct regular security audits and maintain comprehensive audit logs for accountability.',
+        descriptionZh: '定期進行安全稽核並維護完整的稽核日誌以確保可追溯性。',
+        categories: ['audit', 'logging'],
+    },
+];
+/**
+ * Retrieve all compliance framework entries
+ * 取得所有合規框架條目
+ *
+ * @returns Array of compliance entries / 合規條目陣列
+ */
+export function getComplianceEntries() {
+    return [...COMPLIANCE_ENTRIES];
+}
+/**
+ * Map security findings to compliance framework articles
+ * 將安全發現對應到合規框架條文
+ *
+ * Evaluates each compliance article against the provided findings to
+ * determine compliance status. Articles with critical or high severity
+ * findings are marked non-compliant; those with medium or low findings
+ * are marked partial; articles with no related findings are marked
+ * compliant; articles whose categories have no matching findings are
+ * marked not-applicable when there are no findings at all in any
+ * related category.
+ *
+ * 根據提供的發現評估每個合規條文以判定合規狀態。具有嚴重或高嚴重度發現的
+ * 條文標記為不合規；具有中等或低嚴重度發現的標記為部分合規；沒有相關發現
+ * 的條文標記為合規；當完全沒有任何相關分類的發現時標記為不適用。
+ *
+ * @param findings - Array of security findings / 安全發現陣列
+ * @returns Array of compliance statuses / 合規狀態陣列
+ */
+export function mapFindingsToCompliance(findings) {
+    return COMPLIANCE_ENTRIES.map((entry) => {
+        const relatedFindings = findings.filter((f) => entry.categories.includes(f.category));
+        let status;
+        if (relatedFindings.length === 0) {
+            // If no findings exist at all for these categories, mark as not applicable
+            // when the scan did not cover them; otherwise compliant
+            const hasAnyFindingInCategory = findings.some((f) => entry.categories.includes(f.category));
+            status = hasAnyFindingInCategory ? 'compliant' : 'not_applicable';
+        }
+        else {
+            const hasCriticalOrHigh = relatedFindings.some((f) => f.severity === 'critical' || f.severity === 'high');
+            const hasMediumOrLow = relatedFindings.some((f) => f.severity === 'medium' || f.severity === 'low');
+            if (hasCriticalOrHigh) {
+                status = 'non_compliant';
+            }
+            else if (hasMediumOrLow) {
+                status = 'partial';
+            }
+            else {
+                // Only info-level findings
+                status = 'compliant';
+            }
+        }
+        return {
+            ...entry,
+            status,
+            relatedFindings,
+        };
+    });
+}
+//# sourceMappingURL=compliance-map.js.map

package/dist/report/compliance-map.js.map

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

package/dist/report/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * PDF Report Generator for PanguardScan
+ * PanguardScan PDF 報告產生器
+ *
+ * Provides PDF report generation from scan results, including
+ * compliance mapping against the Taiwan ISMS framework.
+ * 提供從掃描結果產生 PDF 報告的功能，包括台灣資通安全管理法框架的合規對照。
+ *
+ * @module @panguard-ai/panguard-scan/report
+ */
+export { generatePdfReport } from './pdf-generator.js';
+export { getComplianceEntries, mapFindingsToCompliance } from './compliance-map.js';
+export type { ComplianceEntry, ComplianceStatus } from './compliance-map.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/report/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACpF,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}