@panguard-ai/panguard 1.5.5 → 1.6.0

package/dist/cli/theme.js

@@ -14,6 +14,40 @@ export const BRAND_LOGO = [
     ' \u2588\u2588\u2580\u2580\u2580\u2580 \u2588\u2588\u2580\u2580\u2588\u2588 \u2588\u2588\u2580\u2584\u2588\u2588 \u2588\u2588 \u2580\u2588\u2588 \u2588\u2588  \u2588\u2588 \u2588\u2588\u2580\u2580\u2588\u2588 \u2588\u2588\u2588\u2580\u2580  \u2588\u2588  \u2588\u2588   \u2588\u2588\u2580\u2580\u2588\u2588 \u2588\u2588',
     ' \u2588\u2588     \u2588\u2588  \u2588\u2588 \u2588\u2588  \u2588\u2588 \u2588\u2588\u2584\u2584\u2588\u2588 \u2588\u2588\u2584\u2584\u2588\u2588 \u2588\u2588  \u2588\u2588 \u2588\u2588 \u2580\u2588\u2584 \u2588\u2588\u2584\u2584\u2588\u2580   \u2588\u2588  \u2588\u2588 \u2588\u2588',
 ];
+// \u2500\u2500 Brand Tagline \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+// Collective-defense positioning: the logo is three overlapping shields.
+// Each install makes everyone safer. Keep this short \u2014 it's a banner line.
+/** One-line collective-defense tagline for banners (en / zh). */
+export function brandTagline(lang = 'en') {
+    return lang === 'zh-TW'
+        ? 'AI \u4ee3\u7406\u5b89\u5168 \u00b7 \u958b\u653e\u6a19\u6e96 \u00b7 \u96c6\u9ad4\u9632\u79a6'
+        : 'AI agent security \u00b7 open \u00b7 collective defense';
+}
+// \u2500\u2500 Clear Status Marks \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+// Human-readable marks instead of decoded jargon ([~] [#] [!]).
+// \u2713 = good/safe (sage\u00b7green), \u26a0 = needs attention (caution), \u2192 = next step.
+// These wrap a single glyph in brand color; callers add their own spacing.
+/** \u2713 \u2014 safe / done / protected (sage-green). */
+export const ok = (s = '\u2713') => c.safe(s);
+/** \u26a0 \u2014 needs attention / suspicious (caution amber). */
+export const warn = (s = '\u26a0') => c.caution(s);
+/** \u2192 \u2014 next step / pointer (sage). */
+export const arrow = (s = '\u2192') => c.sage(s);
+/** \u2717 \u2014 critical / failed (critical red). */
+export const fail = (s = '\u2717') => c.critical(s);
+/** \u25a3 \u2014 the shield: PanGuard is watching (sage). Used for "protecting" lines. */
+export const shield = (s = '\u25a3') => c.sage(s);
+/**
+ * Brand status marks as a stable map, for callers that prefer lookup style.
+ * Mirrors the standalone helpers above \u2014 same glyphs, same colors.
+ */
+export const marks = {
+    ok: ok(),
+    warn: warn(),
+    arrow: arrow(),
+    fail: fail(),
+    shield: shield(),
+};
 // ── Theme Colors ──────────────────────────────────────────────────────
 export const theme = {
     // Brand
@@ -73,6 +107,46 @@ export function renderLogo() {
         console.log(c.sage(line));
     }
 }
+/**
+ * Build the "✓ You're protected" hero block as ready-to-print lines.
+ * Pure: returns strings, caller does the console.log. Keeps copy + the two
+ * trust guarantees (detection-only, nothing-leaves-your-machine) in one place.
+ */
+export function protectedHero(opts) {
+    const lang = opts.lang ?? 'en';
+    const zh = lang === 'zh-TW';
+    const rule = c.bold(c.sage(String(opts.ruleCount)));
+    const tool = c.bold(c.sage(String(opts.toolCount)));
+    const rule50 = c.dim('─'.repeat(50));
+    const lines = [];
+    lines.push(`  ${rule50}`);
+    if (zh) {
+        lines.push(`   ${ok()}  ${c.bold('你已受到保護')}`);
+        lines.push(`      PanGuard 正在守護 ${tool} 個工具,防範提示注入、工具濫用、`);
+        lines.push(`      資料外洩與惡意技能 — 使用 ${rule} 條開放規則。`);
+        lines.push(`      ${c.dim('僅偵測,不阻擋 — 除非你親自開啟。')}`);
+        lines.push(`      ${c.dim('任何資料都不會離開這台機器 — 除非你允許。')}`);
+    }
+    else {
+        lines.push(`   ${ok()}  ${c.bold("You're protected")}`);
+        lines.push(`      PanGuard is watching ${tool} tools for prompt injection, tool abuse,`);
+        lines.push(`      data exfiltration, and malicious skills — using ${rule} open rules.`);
+        lines.push(`      ${c.dim('Detection only. Nothing is blocked unless you turn it on.')}`);
+        lines.push(`      ${c.dim('Nothing leaves your machine unless you allow it.')}`);
+    }
+    lines.push('');
+    if (opts.dashboardUrl) {
+        const dash = zh ? '儀表板' : 'Dashboard';
+        const stat = zh ? '狀態' : 'Status';
+        lines.push(`   ${dash} ${arrow()} ${c.sage(opts.dashboardUrl)}      ${stat} ${arrow()} ${c.dim('pga status')}`);
+    }
+    else {
+        const stat = zh ? '狀態' : 'Status';
+        lines.push(`   ${stat} ${arrow()} ${c.dim('pga status')}`);
+    }
+    lines.push(`  ${rule50}`);
+    return lines;
+}
 // Re-export for convenience
 export { c, stripAnsi, visLen };
 //# sourceMappingURL=theme.js.map

package/dist/cli/theme.js.map

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

package/dist/init/rule-count.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Dynamic ATR rule count for onboarding copy.
+ * 動態 ATR 規則數(供 onboarding 文案使用)
+ *
+ * The community UX requires the rule count to reflect the live ruleset,
+ * never a hardcoded number (DESIGN-community-ux 情境 1: "規則數動態,別寫死").
+ *
+ * Resolution order (truthful, lightweight — no engine import):
+ *   1. Threat Cloud cache `uniqueRulesCount` — the live synced count, the same
+ *      source `pga up` reads. Reflects rules actually loaded by Guard.
+ *   2. Bundled rule YAMLs in the `agent-threat-rules` package — the real shipped
+ *      count, resolved by walking up from this module (mirrors report.ts).
+ *   3. `null` — neither available; callers omit the number rather than lie.
+ *
+ * @module @panguard-ai/panguard/init/rule-count
+ */
+/**
+ * Resolve the current ATR rule count for onboarding copy.
+ * Returns `null` only when no truthful source is available — callers should
+ * phrase copy so the count can be gracefully omitted.
+ */
+export declare function getRuleCount(): number | null;
+//# sourceMappingURL=rule-count.d.ts.map

package/dist/init/rule-count.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-count.d.ts","sourceRoot":"","sources":["../../src/init/rule-count.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAqFH;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAE5C"}

package/dist/init/rule-count.js

@@ -0,0 +1,109 @@
+/**
+ * Dynamic ATR rule count for onboarding copy.
+ * 動態 ATR 規則數(供 onboarding 文案使用)
+ *
+ * The community UX requires the rule count to reflect the live ruleset,
+ * never a hardcoded number (DESIGN-community-ux 情境 1: "規則數動態,別寫死").
+ *
+ * Resolution order (truthful, lightweight — no engine import):
+ *   1. Threat Cloud cache `uniqueRulesCount` — the live synced count, the same
+ *      source `pga up` reads. Reflects rules actually loaded by Guard.
+ *   2. Bundled rule YAMLs in the `agent-threat-rules` package — the real shipped
+ *      count, resolved by walking up from this module (mirrors report.ts).
+ *   3. `null` — neither available; callers omit the number rather than lie.
+ *
+ * @module @panguard-ai/panguard/init/rule-count
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** Threat Cloud cache written by Guard once it syncs the live ruleset. */
+function ruleCountFromTcCache() {
+    try {
+        const cachePath = join(homedir(), '.panguard-guard', 'threat-cloud-cache.json');
+        if (!existsSync(cachePath))
+            return null;
+        const cache = JSON.parse(readFileSync(cachePath, 'utf-8'));
+        if (typeof cache.uniqueRulesCount === 'number' && cache.uniqueRulesCount > 0) {
+            return cache.uniqueRulesCount;
+        }
+    }
+    catch {
+        /* fall through to bundled count */
+    }
+    return null;
+}
+/**
+ * Locate the bundled `agent-threat-rules/rules` directory.
+ * Walks up from this module's own directory, mirroring report.ts so it works
+ * regardless of the customer's cwd (incl. global installs and pnpm layouts).
+ */
+function findBundledRulesDir() {
+    const envDir = process.env['PANGUARD_ATR_RULES_DIR'];
+    if (envDir && existsSync(envDir) && statSync(envDir).isDirectory()) {
+        return envDir;
+    }
+    try {
+        let dir = dirname(fileURLToPath(import.meta.url));
+        while (dir !== sep && dir.length > 0) {
+            const candidate = join(dir, 'node_modules', 'agent-threat-rules', 'rules');
+            if (existsSync(candidate) && statSync(candidate).isDirectory()) {
+                return candidate;
+            }
+            const parent = dirname(dir);
+            if (parent === dir)
+                break;
+            dir = parent;
+        }
+    }
+    catch {
+        /* fall through */
+    }
+    return null;
+}
+/** Count rule YAML files under a directory tree. */
+function countYamlFiles(dir) {
+    let count = 0;
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return 0;
+    }
+    for (const entry of entries) {
+        const full = join(dir, entry);
+        let st;
+        try {
+            st = statSync(full);
+        }
+        catch {
+            continue;
+        }
+        if (st.isDirectory()) {
+            count += countYamlFiles(full);
+        }
+        else if (entry.endsWith('.yaml') || entry.endsWith('.yml')) {
+            count += 1;
+        }
+    }
+    return count;
+}
+/** Count of bundled rules shipped with the installed `agent-threat-rules`. */
+function ruleCountFromBundle() {
+    const rulesDir = findBundledRulesDir();
+    if (!rulesDir)
+        return null;
+    const count = countYamlFiles(rulesDir);
+    return count > 0 ? count : null;
+}
+/**
+ * Resolve the current ATR rule count for onboarding copy.
+ * Returns `null` only when no truthful source is available — callers should
+ * phrase copy so the count can be gracefully omitted.
+ */
+export function getRuleCount() {
+    return ruleCountFromTcCache() ?? ruleCountFromBundle();
+}
+//# sourceMappingURL=rule-count.js.map

package/dist/init/rule-count.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@panguard-ai/panguard",
-  "version": "1.5.5",
+  "version": "1.6.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -36,24 +36,25 @@
     "README.md"
   ],
   "dependencies": {
+    "@sentry/node": "^8.0.0",
     "commander": "^12.0.0",
     "js-yaml": "^4.1.0",
     "pdfkit": "^0.15.0",
     "zod": "^3.24.0",
-    "@panguard-ai/core": "1.5.5",
-    "@panguard-ai/panguard-scan": "1.5.5",
-    "@panguard-ai/atr": "1.5.5",
-    "@panguard-ai/panguard-guard": "1.5.5",
-    "@panguard-ai/security-hardening": "1.5.5",
-    "@panguard-ai/panguard-skill-auditor": "1.5.5",
-    "@panguard-ai/panguard-chat": "1.5.5",
-    "@panguard-ai/scan-core": "1.5.5",
-    "@panguard-ai/panguard-mcp": "1.5.5"
+    "@panguard-ai/core": "1.6.0",
+    "@panguard-ai/panguard-scan": "1.6.0",
+    "@panguard-ai/atr": "1.6.0",
+    "@panguard-ai/panguard-guard": "1.6.0",
+    "@panguard-ai/panguard-chat": "1.6.0",
+    "@panguard-ai/security-hardening": "1.5.6",
+    "@panguard-ai/scan-core": "1.6.0",
+    "@panguard-ai/panguard-mcp": "1.6.0",
+    "@panguard-ai/panguard-skill-auditor": "1.6.0"
   },
   "optionalDependencies": {
-    "agent-threat-rules": "^2.1.1",
-    "@panguard-ai/threat-cloud": "1.5.5",
-    "@panguard-ai/panguard-trap": "1.5.5"
+    "agent-threat-rules": "^3.4.0",
+    "@panguard-ai/threat-cloud": "1.6.0",
+    "@panguard-ai/panguard-trap": "1.6.0"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
@@ -65,6 +66,7 @@
     "build": "tsc --build && cp ../../CHANGELOG.md ./CHANGELOG.md 2>/dev/null || true",
     "clean": "rm -rf dist tsconfig.tsbuildinfo",
     "typecheck": "tsc --noEmit",
+    "test": "vitest run",
     "dev": "tsc --build --watch",
     "postinstall": "node -e \"console.log('\\n  Panguard AI v' + require('./package.json').version + ' installed.\\n\\n  Quick start:\\n    pga              Open interactive menu\\n    pga up           Start protection + dashboard\\n    pga scan         Scan your skills\\n    pga audit <dir>  Audit a skill before installing\\n\\n  First time? Just run: pga\\n')\""
   }