@panguard-ai/panguard-mcp 1.2.0 → 1.3.0

package/dist/config/index.d.ts

@@ -8,6 +8,6 @@ export { detectPlatforms, getConfigPath } from './platform-detector.js';
 export type { PlatformId, DetectedPlatform } from './platform-detector.js';
 export { injectMCPConfig, removeMCPConfig, injectAll, getInstallCommand } from './mcp-injector.js';
 export type { InjectionResult } from './mcp-injector.js';
-export { parseMCPServers, resolveSkillDir, discoverAllSkills, removeServer } from './mcp-config-reader.js';
+export { parseMCPServers, resolveSkillDir, discoverAllSkills, removeServer, } from './mcp-config-reader.js';
 export type { MCPServerEntry } from './mcp-config-reader.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACnG,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3G,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACnG,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,YAAY,GACb,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/config/index.js

@@ -6,5 +6,5 @@
  */
 export { detectPlatforms, getConfigPath } from './platform-detector.js';
 export { injectMCPConfig, removeMCPConfig, injectAll, getInstallCommand } from './mcp-injector.js';
-export { parseMCPServers, resolveSkillDir, discoverAllSkills, removeServer } from './mcp-config-reader.js';
+export { parseMCPServers, resolveSkillDir, discoverAllSkills, removeServer, } from './mcp-config-reader.js';
 //# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAExE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEnG,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAExE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEnG,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,YAAY,GACb,MAAM,wBAAwB,CAAC"}

package/dist/config/mcp-injector.d.ts

@@ -0,0 +1,40 @@
+/**
+ * MCP Config Injector - Write Panguard MCP config to AI agent platforms
+ * MCP 設定注入器 - 將 Panguard MCP 設定寫入 AI Agent 平台
+ *
+ * Supports Claude Code, Claude Desktop, Cursor, OpenClaw, Codex, Workbuddy, NemoClaw, ArkClaw.
+ *
+ * @module @panguard-ai/panguard-mcp/config/mcp-injector
+ */
+import type { PlatformId } from './platform-detector.js';
+export interface InjectionResult {
+    platformId: PlatformId;
+    success: boolean;
+    configPath: string;
+    backupPath?: string;
+    error?: string;
+}
+/**
+ * Inject Panguard MCP config into a specific platform.
+ * 將 Panguard MCP 設定注入特定平台。
+ *
+ * @param platformId - Target platform / 目標平台
+ * @returns Injection result with success status and paths.
+ */
+export declare function injectMCPConfig(platformId: PlatformId): InjectionResult;
+/**
+ * Remove Panguard MCP config from a specific platform.
+ * 從特定平台移除 Panguard MCP 設定。
+ */
+export declare function removeMCPConfig(platformId: PlatformId): InjectionResult;
+/**
+ * Inject Panguard MCP config into all detected platforms.
+ * 將 Panguard MCP 設定注入所有偵測到的平台。
+ */
+export declare function injectAll(platformIds: PlatformId[]): Promise<InjectionResult[]>;
+/**
+ * Get the one-liner install command for display.
+ * 取得用於顯示的一行安裝指令。
+ */
+export declare function getInstallCommand(): string;
+//# sourceMappingURL=mcp-injector.d.ts.map

package/dist/config/mcp-injector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-injector.d.ts","sourceRoot":"","sources":["../../src/config/mcp-injector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAKzD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA0JD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,eAAe,CAwEvE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,eAAe,CAqCvE;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAErF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}
+{"version":3,"file":"mcp-injector.d.ts","sourceRoot":"","sources":["../../src/config/mcp-injector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAKzD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA0JD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,eAAe,CA2EvE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,eAAe,CAqCvE;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAErF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}

package/dist/config/mcp-injector.js

@@ -0,0 +1,297 @@
+/**
+ * MCP Config Injector - Write Panguard MCP config to AI agent platforms
+ * MCP 設定注入器 - 將 Panguard MCP 設定寫入 AI Agent 平台
+ *
+ * Supports Claude Code, Claude Desktop, Cursor, OpenClaw, Codex, Workbuddy, NemoClaw, ArkClaw.
+ *
+ * @module @panguard-ai/panguard-mcp/config/mcp-injector
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, copyFileSync, rmSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { execFileSync } from 'node:child_process';
+import { createLogger } from '@panguard-ai/core';
+import { getConfigPath } from './platform-detector.js';
+const logger = createLogger('panguard-mcp:injector');
+/** The MCP server entry Panguard adds to config files. */
+const PANGUARD_MCP_ENTRY = {
+    command: 'npx',
+    args: ['-y', '@panguard-ai/panguard-mcp'],
+};
+/**
+ * Read an existing JSON config file, or return empty object.
+ * 讀取現有 JSON 設定檔，或回傳空物件。
+ */
+function readJsonSafe(filePath) {
+    if (!existsSync(filePath))
+        return {};
+    try {
+        const raw = readFileSync(filePath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Back up a config file before modifying it.
+ * 修改前備份設定檔。
+ */
+function backupFile(filePath) {
+    if (!existsSync(filePath))
+        return undefined;
+    const backupPath = `${filePath}.bak.${Date.now()}`;
+    copyFileSync(filePath, backupPath);
+    logger.info(`Backed up ${filePath} -> ${backupPath}`);
+    return backupPath;
+}
+/**
+ * Ensure parent directory exists.
+ * 確保父目錄存在。
+ */
+function ensureDir(filePath) {
+    const dir = dirname(filePath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+/**
+ * Inject Panguard MCP config for Claude Desktop.
+ * Claude Desktop uses: { "mcpServers": { "panguard": { "command": "...", "args": [...] } } }
+ */
+function injectClaudeDesktop(configPath) {
+    const config = readJsonSafe(configPath);
+    const servers = config['mcpServers'] ?? {};
+    servers['panguard'] = { ...PANGUARD_MCP_ENTRY };
+    config['mcpServers'] = servers;
+    writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+}
+/**
+ * Inject Panguard MCP config for Claude Code.
+ * Claude Code uses `claude mcp add` CLI (not JSON file).
+ * Falls back to writing settings.local.json if CLI not available.
+ */
+function injectClaudeCode(_configPath) {
+    try {
+        // Try `claude mcp add` first (the correct way for Claude Code)
+        execFileSync('claude', ['mcp', 'add', '--scope', 'user', 'panguard', '--', 'npx', '-y', '@panguard-ai/panguard-mcp'], {
+            timeout: 15_000,
+            stdio: 'pipe',
+        });
+        logger.info('Added Panguard MCP via `claude mcp add --scope user`');
+    }
+    catch {
+        // Fallback: write JSON directly (older Claude Code versions)
+        logger.warn('`claude mcp add` failed, falling back to JSON config');
+        const config = readJsonSafe(_configPath);
+        const servers = config['mcpServers'] ?? {};
+        servers['panguard'] = { ...PANGUARD_MCP_ENTRY };
+        config['mcpServers'] = servers;
+        writeFileSync(_configPath, JSON.stringify(config, null, 2), 'utf-8');
+    }
+}
+/**
+ * Inject Panguard MCP config for Cursor.
+ * Cursor uses: { "mcpServers": { "panguard": { "command": "...", "args": [...] } } }
+ * in ~/.cursor/mcp.json
+ */
+function injectCursor(configPath) {
+    const config = readJsonSafe(configPath);
+    const servers = config['mcpServers'] ?? {};
+    servers['panguard'] = { ...PANGUARD_MCP_ENTRY };
+    config['mcpServers'] = servers;
+    writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+}
+/**
+ * Inject Panguard MCP config for Codex/Workbuddy/NemoClaw.
+ * Generic MCP JSON format: { "mcpServers": { "panguard": { ... } } }
+ */
+function injectGenericMCP(configPath) {
+    const config = readJsonSafe(configPath);
+    const servers = config['mcpServers'] ?? {};
+    servers['panguard'] = { ...PANGUARD_MCP_ENTRY };
+    config['mcpServers'] = servers;
+    writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+}
+/**
+ * Inject Panguard as an OpenClaw native skill.
+ * OpenClaw uses its own skill system (not MCP), so we copy SKILL.md
+ * to ~/.openclaw/skills/panguard/.
+ */
+function injectOpenClawSkill(skillDir) {
+    mkdirSync(skillDir, { recursive: true });
+    // Resolve the bundled SKILL.md from this package
+    const thisDir = dirname(fileURLToPath(import.meta.url));
+    const bundledSkill = join(thisDir, '..', '..', 'openclaw-skill', 'SKILL.md');
+    if (existsSync(bundledSkill)) {
+        copyFileSync(bundledSkill, join(skillDir, 'SKILL.md'));
+    }
+    else {
+        // Fallback: write a minimal SKILL.md inline
+        const skillContent = [
+            '---',
+            'name: panguard',
+            'description: AI agent security platform -- audit skills, scan threats, run 24/7 protection',
+            'homepage: https://panguard.ai',
+            'license: MIT',
+            'metadata: { "openclaw": { "requires": { "bins": ["npx"] }, "install": [{ "id": "node", "kind": "node", "package": "@panguard-ai/panguard", "bins": ["panguard"], "label": "Install Panguard AI" }] } }',
+            '---',
+            '',
+            '# Panguard AI',
+            '',
+            'Security platform for AI agents with 10,400+ detection rules.',
+            '',
+            '## Commands',
+            '- `panguard audit skill .` -- Audit skills for threats',
+            '- `panguard scan` -- Security scan',
+            '- `panguard guard start` -- Start real-time protection',
+            '- `panguard status` -- Show status dashboard',
+            '',
+        ].join('\n');
+        writeFileSync(join(skillDir, 'SKILL.md'), skillContent, 'utf-8');
+    }
+}
+/**
+ * Inject Panguard MCP config into a specific platform.
+ * 將 Panguard MCP 設定注入特定平台。
+ *
+ * @param platformId - Target platform / 目標平台
+ * @returns Injection result with success status and paths.
+ */
+export function injectMCPConfig(platformId) {
+    const configPath = getConfigPath(platformId);
+    const result = { platformId, success: false, configPath };
+    try {
+        ensureDir(configPath);
+        result.backupPath = backupFile(configPath);
+        switch (platformId) {
+            case 'claude-desktop':
+                injectClaudeDesktop(configPath);
+                break;
+            case 'claude-code':
+                injectClaudeCode(configPath);
+                break;
+            case 'cursor':
+                injectCursor(configPath);
+                break;
+            case 'openclaw':
+                injectOpenClawSkill(configPath);
+                break;
+            case 'codex':
+            case 'workbuddy':
+            case 'nemoclaw':
+            case 'arkclaw':
+                injectGenericMCP(configPath);
+                break;
+        }
+        // Verify the write succeeded
+        if (platformId === 'claude-code') {
+            // Claude Code: verify via `claude mcp list`
+            try {
+                const output = execFileSync('claude', ['mcp', 'list'], {
+                    timeout: 10_000,
+                    stdio: 'pipe',
+                }).toString();
+                if (output.includes('panguard')) {
+                    result.success = true;
+                    logger.info('Verified Panguard MCP in Claude Code via `claude mcp list`');
+                }
+                else {
+                    // Might take a moment to register, assume success if inject didn't throw
+                    result.success = true;
+                    logger.info('Panguard MCP added to Claude Code (pending verification)');
+                }
+            }
+            catch {
+                result.success = true; // inject didn't throw, assume OK
+                logger.info('Panguard MCP injected into Claude Code');
+            }
+        }
+        else if (platformId === 'openclaw') {
+            // OpenClaw uses SKILL.md, not JSON
+            if (existsSync(join(configPath, 'SKILL.md'))) {
+                result.success = true;
+                logger.info(`Installed Panguard skill for OpenClaw at ${configPath}`);
+            }
+            else {
+                result.error = 'Verification failed: SKILL.md not found after write';
+                logger.error(result.error);
+            }
+        }
+        else {
+            const verify = readJsonSafe(configPath);
+            const servers = verify['mcpServers'];
+            if (servers && servers['panguard']) {
+                result.success = true;
+                logger.info(`Injected Panguard MCP config into ${platformId} at ${configPath}`);
+            }
+            else {
+                result.error = 'Verification failed: panguard entry not found after write';
+                logger.error(result.error);
+            }
+        }
+    }
+    catch (err) {
+        result.error = err instanceof Error ? err.message : String(err);
+        logger.error(`Failed to inject ${platformId}: ${result.error}`);
+    }
+    return result;
+}
+/**
+ * Remove Panguard MCP config from a specific platform.
+ * 從特定平台移除 Panguard MCP 設定。
+ */
+export function removeMCPConfig(platformId) {
+    const configPath = getConfigPath(platformId);
+    const result = { platformId, success: false, configPath };
+    try {
+        if (platformId === 'openclaw') {
+            // Remove OpenClaw skill directory
+            const skillMd = join(configPath, 'SKILL.md');
+            if (existsSync(skillMd)) {
+                rmSync(configPath, { recursive: true, force: true });
+                logger.info(`Removed Panguard skill from OpenClaw`);
+            }
+            result.success = true;
+            return result;
+        }
+        if (!existsSync(configPath)) {
+            result.success = true;
+            return result;
+        }
+        result.backupPath = backupFile(configPath);
+        const config = readJsonSafe(configPath);
+        const servers = config['mcpServers'];
+        if (servers) {
+            delete servers['panguard'];
+            config['mcpServers'] = servers;
+        }
+        writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+        result.success = true;
+        logger.info(`Removed Panguard MCP config from ${platformId}`);
+    }
+    catch (err) {
+        result.error = err instanceof Error ? err.message : String(err);
+        logger.error(`Failed to remove from ${platformId}: ${result.error}`);
+    }
+    return result;
+}
+/**
+ * Inject Panguard MCP config into all detected platforms.
+ * 將 Panguard MCP 設定注入所有偵測到的平台。
+ */
+export async function injectAll(platformIds) {
+    return platformIds.map((id) => injectMCPConfig(id));
+}
+/**
+ * Get the one-liner install command for display.
+ * 取得用於顯示的一行安裝指令。
+ */
+export function getInstallCommand() {
+    return 'npx panguard setup';
+}
+//# sourceMappingURL=mcp-injector.js.map

package/dist/config/mcp-injector.js.map

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

package/dist/config/platform-detector.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Platform Detector - Detect installed AI agent runtimes
+ * 平台偵測器 - 偵測已安裝的 AI Agent 執行環境
+ *
+ * Detects Claude Code, Claude Desktop, Cursor, OpenClaw, Codex, WorkBuddy, NemoClaw, and ArkClaw.
+ * 偵測 Claude Code、Claude Desktop、Cursor、OpenClaw、Codex、WorkBuddy、NemoClaw 和 ArkClaw。
+ *
+ * @module @panguard-ai/panguard-mcp/config/platform-detector
+ */
+export type PlatformId = 'claude-code' | 'claude-desktop' | 'cursor' | 'openclaw' | 'codex' | 'workbuddy' | 'nemoclaw' | 'arkclaw';
+export interface DetectedPlatform {
+    id: PlatformId;
+    name: string;
+    configPath: string;
+    detected: boolean;
+    alreadyConfigured: boolean;
+}
+/**
+ * Detect all supported AI agent platforms.
+ * 偵測所有支援的 AI Agent 平台。
+ *
+ * @returns Array of detected platforms with their config paths and status.
+ */
+export declare function detectPlatforms(): Promise<DetectedPlatform[]>;
+/**
+ * Get the MCP config path for a specific platform.
+ * 取得特定平台的 MCP 設定路徑。
+ */
+export declare function getConfigPath(platformId: PlatformId): string;
+//# sourceMappingURL=platform-detector.d.ts.map

package/dist/config/platform-detector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform-detector.d.ts","sourceRoot":"","sources":["../../src/config/platform-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,gBAAgB,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAE5F,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,UAAU,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAyFD;;;;;GAKG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAsEnE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAa5D"}
+{"version":3,"file":"platform-detector.d.ts","sourceRoot":"","sources":["../../src/config/platform-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,MAAM,MAAM,UAAU,GAClB,aAAa,GACb,gBAAgB,GAChB,QAAQ,GACR,UAAU,GACV,OAAO,GACP,WAAW,GACX,UAAU,GACV,SAAS,CAAC;AAEd,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,UAAU,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAwGD;;;;;GAKG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA+GnE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAmB5D"}

package/dist/config/platform-detector.js

@@ -0,0 +1,232 @@
+/**
+ * Platform Detector - Detect installed AI agent runtimes
+ * 平台偵測器 - 偵測已安裝的 AI Agent 執行環境
+ *
+ * Detects Claude Code, Claude Desktop, Cursor, OpenClaw, Codex, WorkBuddy, NemoClaw, and ArkClaw.
+ * 偵測 Claude Code、Claude Desktop、Cursor、OpenClaw、Codex、WorkBuddy、NemoClaw 和 ArkClaw。
+ *
+ * @module @panguard-ai/panguard-mcp/config/platform-detector
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir, platform } from 'node:os';
+import { execFile, execFileSync } from 'node:child_process';
+import { createLogger } from '@panguard-ai/core';
+const logger = createLogger('panguard-mcp:platform-detector');
+/** Check if a command exists on PATH. */
+function commandExists(cmd) {
+    if (!/^[a-zA-Z0-9_.-]+$/.test(cmd))
+        return Promise.resolve(false);
+    return new Promise((resolve) => {
+        const bin = platform() === 'win32' ? 'where' : 'which';
+        execFile(bin, [cmd], (err) => resolve(!err));
+    });
+}
+/** Check if a JSON config file has a panguard MCP server entry. */
+function hasPanguardMCPEntry(filePath) {
+    if (!existsSync(filePath))
+        return false;
+    try {
+        const parsed = JSON.parse(readFileSync(filePath, 'utf-8'));
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            const servers = parsed['mcpServers'];
+            if (servers && typeof servers === 'object' && !Array.isArray(servers)) {
+                return 'panguard' in servers;
+            }
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+/** Check if Claude Code has panguard MCP configured via `claude mcp list`. */
+function hasClaudeCodePanguard() {
+    try {
+        const output = execFileSync('claude', ['mcp', 'list'], {
+            timeout: 10_000,
+            stdio: 'pipe',
+        }).toString();
+        return output.includes('panguard');
+    }
+    catch {
+        // Fallback: check JSON config
+        return hasPanguardMCPEntry(getClaudeCodeConfigPath());
+    }
+}
+/** Check if OpenClaw has the panguard skill installed. */
+function hasOpenClawSkill() {
+    return existsSync(getOpenClawSkillPath());
+}
+/** Get the MCP config path for Claude Desktop based on OS. */
+function getClaudeDesktopConfigPath() {
+    const home = homedir();
+    switch (platform()) {
+        case 'darwin':
+            return join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+        case 'win32':
+            return join(process.env['APPDATA'] ?? join(home, 'AppData', 'Roaming'), 'Claude', 'claude_desktop_config.json');
+        default:
+            return join(home, '.config', 'claude', 'claude_desktop_config.json');
+    }
+}
+/** Get the MCP settings path for Claude Code. */
+function getClaudeCodeConfigPath() {
+    return join(homedir(), '.claude', 'settings.local.json');
+}
+/** Get the MCP config path for Cursor. */
+function getCursorConfigPath() {
+    return join(homedir(), '.cursor', 'mcp.json');
+}
+/** Get the OpenClaw skill installation path for Panguard. */
+function getOpenClawSkillPath() {
+    return join(homedir(), '.openclaw', 'skills', 'panguard', 'SKILL.md');
+}
+/** Get the OpenClaw skills directory for Panguard. */
+function getOpenClawSkillDir() {
+    return join(homedir(), '.openclaw', 'skills', 'panguard');
+}
+/** Get the MCP config path for Codex. */
+function getCodexConfigPath() {
+    return join(homedir(), '.codex', 'mcp.json');
+}
+/** Get the MCP config path for WorkBuddy. */
+function getWorkbuddyConfigPath() {
+    return join(homedir(), '.workbuddy', '.mcp.json');
+}
+/** Get the MCP config path for NemoClaw. */
+function getNemoClawConfigPath() {
+    return join(homedir(), '.nemoclaw', 'mcp.json');
+}
+/** Get the MCP config path for ArkClaw (ByteDance). */
+function getArkClawConfigPath() {
+    return join(homedir(), '.arkclaw', 'mcp.json');
+}
+/**
+ * Detect all supported AI agent platforms.
+ * 偵測所有支援的 AI Agent 平台。
+ *
+ * @returns Array of detected platforms with their config paths and status.
+ */
+export async function detectPlatforms() {
+    const platforms = [];
+    // Claude Code (uses `claude mcp add` CLI, not JSON config)
+    const claudeCodePath = getClaudeCodeConfigPath();
+    const claudeCodeDetected = (await commandExists('claude')) || existsSync(join(homedir(), '.claude'));
+    platforms.push({
+        id: 'claude-code',
+        name: 'Claude Code',
+        configPath: claudeCodePath,
+        detected: claudeCodeDetected,
+        alreadyConfigured: hasClaudeCodePanguard(),
+    });
+    // Claude Desktop
+    const claudeDesktopPath = getClaudeDesktopConfigPath();
+    const claudeDesktopDetected = existsSync(claudeDesktopPath) ||
+        (platform() === 'darwin' && existsSync('/Applications/Claude.app'));
+    platforms.push({
+        id: 'claude-desktop',
+        name: 'Claude Desktop',
+        configPath: claudeDesktopPath,
+        detected: claudeDesktopDetected,
+        alreadyConfigured: hasPanguardMCPEntry(claudeDesktopPath),
+    });
+    // Cursor
+    const cursorPath = getCursorConfigPath();
+    const cursorDetected = (await commandExists('cursor')) ||
+        existsSync(join(homedir(), '.cursor')) ||
+        (platform() === 'darwin' && existsSync('/Applications/Cursor.app'));
+    platforms.push({
+        id: 'cursor',
+        name: 'Cursor',
+        configPath: cursorPath,
+        detected: cursorDetected,
+        alreadyConfigured: hasPanguardMCPEntry(cursorPath),
+    });
+    // OpenClaw (uses native skill system, not MCP)
+    const openclawSkillDir = getOpenClawSkillDir();
+    const openclawDetected = (await commandExists('openclaw')) || existsSync(join(homedir(), '.openclaw'));
+    platforms.push({
+        id: 'openclaw',
+        name: 'OpenClaw',
+        configPath: openclawSkillDir,
+        detected: openclawDetected,
+        alreadyConfigured: hasOpenClawSkill(),
+    });
+    // Codex
+    const codexPath = getCodexConfigPath();
+    const codexDetected = (await commandExists('codex')) || existsSync(join(homedir(), '.codex'));
+    platforms.push({
+        id: 'codex',
+        name: 'Codex CLI',
+        configPath: codexPath,
+        detected: codexDetected,
+        alreadyConfigured: hasPanguardMCPEntry(codexPath),
+    });
+    // WorkBuddy
+    const wbPath = getWorkbuddyConfigPath();
+    const wbDetected = (await commandExists('workbuddy')) || existsSync(join(homedir(), '.workbuddy'));
+    platforms.push({
+        id: 'workbuddy',
+        name: 'WorkBuddy',
+        configPath: wbPath,
+        detected: wbDetected,
+        alreadyConfigured: hasPanguardMCPEntry(wbPath),
+    });
+    // NemoClaw
+    const ncPath = getNemoClawConfigPath();
+    const ncDetected = (await commandExists('nemoclaw')) || existsSync(join(homedir(), '.nemoclaw'));
+    platforms.push({
+        id: 'nemoclaw',
+        name: 'NemoClaw',
+        configPath: ncPath,
+        detected: ncDetected,
+        alreadyConfigured: hasPanguardMCPEntry(ncPath),
+    });
+    // ArkClaw (ByteDance)
+    try {
+        const acCmd = await commandExists('arkclaw');
+        const acDir = existsSync(join(homedir(), '.arkclaw'));
+        if (acCmd || acDir) {
+            const cfgPath = getArkClawConfigPath();
+            platforms.push({
+                id: 'arkclaw',
+                name: 'ArkClaw',
+                configPath: cfgPath,
+                detected: true,
+                alreadyConfigured: hasPanguardMCPEntry(cfgPath),
+            });
+        }
+    }
+    catch {
+        /* not installed */
+    }
+    const detected = platforms.filter((p) => p.detected);
+    logger.info(`Detected ${detected.length} platform(s): ${detected.map((p) => p.name).join(', ') || 'none'}`);
+    return platforms;
+}
+/**
+ * Get the MCP config path for a specific platform.
+ * 取得特定平台的 MCP 設定路徑。
+ */
+export function getConfigPath(platformId) {
+    switch (platformId) {
+        case 'claude-code':
+            return getClaudeCodeConfigPath();
+        case 'claude-desktop':
+            return getClaudeDesktopConfigPath();
+        case 'cursor':
+            return getCursorConfigPath();
+        case 'openclaw':
+            return getOpenClawSkillDir();
+        case 'codex':
+            return getCodexConfigPath();
+        case 'workbuddy':
+            return getWorkbuddyConfigPath();
+        case 'nemoclaw':
+            return getNemoClawConfigPath();
+        case 'arkclaw':
+            return getArkClawConfigPath();
+    }
+}
+//# sourceMappingURL=platform-detector.js.map

package/dist/config/platform-detector.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@panguard-ai/panguard-mcp",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -32,10 +32,10 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",
-    "@panguard-ai/core": "1.1.0",
-    "@panguard-ai/panguard-skill-auditor": "1.3.0",
-    "@panguard-ai/panguard-scan": "1.1.0",
-    "@panguard-ai/panguard-guard": "1.2.0"
+    "@panguard-ai/core": "1.3.0",
+    "@panguard-ai/panguard-scan": "1.3.0",
+    "@panguard-ai/panguard-guard": "1.3.0",
+    "@panguard-ai/panguard-skill-auditor": "1.3.1"
   },
   "devDependencies": {
     "@types/node": "^22.14.0",