@gulibs/safe-coder 0.0.26 → 0.0.28

package/dist/server/safe-coder-mcp.js

@@ -0,0 +1,171 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { crawlDocumentation, CrawlDocumentationSchema, listCachedDocumentation, clearCache, ClearCacheSchema, saveSkill, SaveSkillSchema, } from '../tools/index.js';
+/**
+ * Safe Coder MCP Server
+ * Orchestrates safe-coder-cli for documentation crawling and SKILL generation
+ */
+export class SafeCoderMCPServer {
+    server;
+    constructor() {
+        this.server = new McpServer({
+            name: 'safe-coder',
+            version: '1.0.0',
+        });
+        this.setupTools();
+    }
+    /**
+     * Register MCP tools
+     */
+    setupTools() {
+        // ✅ Register crawl_documentation tool - 更新描述
+        this.server.registerTool('crawl_documentation', {
+            title: 'Crawl Documentation and Generate SKILL',
+            description: 'Crawl documentation website and automatically generate a complete Agent SKILL. ' +
+                'This tool saves files directly to disk and returns only a lightweight summary. ' +
+                'The CLI generates a high-quality SKILL.md (< 500 lines) based on complete content analysis, ' +
+                'along with organized reference files. Agent receives only the summary to minimize token cost. ' +
+                '\n\nRequired: url, skillName. ' +
+                'Optional: maxPages (default 50), depth (default 3), outputDir (default ~/.claude/skills), ' +
+                'workers, browser, spaStrategy, useCache, forceRefresh. ' +
+                '\n\nExample: crawl_documentation({ url: "https://react.dev", skillName: "react-docs", maxPages: 50 })',
+            inputSchema: CrawlDocumentationSchema,
+        }, async (args) => {
+            try {
+                const result = await crawlDocumentation(args);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: false,
+                                error: errorMessage,
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+        // Register list_cached_documentation tool
+        this.server.registerTool('list_cached_documentation', {
+            title: 'List Cached Documentation',
+            description: 'List all cached documentation crawl results with metadata. No parameters required.',
+            inputSchema: {},
+        }, async () => {
+            try {
+                const result = await listCachedDocumentation();
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: false,
+                                error: errorMessage,
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+        // Register clear_cache tool
+        this.server.registerTool('clear_cache', {
+            title: 'Clear Cache',
+            description: 'Clear cached documentation results. Parameters: urlPattern (optional string) - URL pattern to match, clearAll (optional boolean) - clear all entries. If no parameters, clears only expired entries.',
+            inputSchema: ClearCacheSchema,
+        }, async (args) => {
+            try {
+                const result = await clearCache(args || {});
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: false,
+                                error: errorMessage,
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+        // Register save_skill tool
+        this.server.registerTool('save_skill', {
+            title: 'Save SKILL Files',
+            description: 'Save complete SKILL directory structure (SKILL.md + references/) to filesystem. Creates a properly formatted Cursor Agent Skill with all reference documentation organized by category. Parameters: skillName (required string) - name for skill directory, skillContent (required string) - SKILL.md content, referenceFiles (optional object) - map of category -> markdown content, baseDirectory (optional string, default ~/.claude/skills) - base directory for skills, overwrite (optional boolean, default false) - overwrite existing skill.',
+            inputSchema: SaveSkillSchema,
+        }, async (args) => {
+            try {
+                const result = await saveSkill(args);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: false,
+                                error: errorMessage,
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+    }
+    /**
+     * Start the MCP server
+     */
+    async run() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        console.error('Safe Coder MCP Server running on stdio');
+    }
+}
+//# sourceMappingURL=safe-coder-mcp.js.map

package/dist/server/safe-coder-mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-coder-mcp.js","sourceRoot":"","sources":["../../src/server/safe-coder-mcp.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAE3B;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IACrB,MAAM,CAAY;IAE1B;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,SAAS,CAAC;YAC1B,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAED;;OAEG;IACK,UAAU;QAChB,6CAA6C;QAC7C,IAAI,CAAC,MAAM,CAAC,YAAY,CACtB,qBAAqB,EACrB;YACE,KAAK,EAAE,wCAAwC;YAC/C,WAAW,EACT,iFAAiF;gBACjF,iFAAiF;gBACjF,8FAA8F;gBAC9F,gGAAgG;gBAChG,gCAAgC;gBAChC,4FAA4F;gBAC5F,yDAAyD;gBACzD,uGAAuG;YACzG,WAAW,EAAE,wBAA+B;SAC7C,EACD,KAAK,EAAE,IAAS,EAAE,EAAE;YAClB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;gBAE9C,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;yBACtC;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAE5E,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,OAAO,EAAE,KAAK;gCACd,KAAK,EAAE,YAAY;6BACpB,EAAE,IAAI,EAAE,CAAC,CAAC;yBACZ;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC,CACF,CAAC;QAEF,0CAA0C;QAC1C,IAAI,CAAC,MAAM,CAAC,YAAY,CACtB,2BAA2B,EAC3B;YACE,KAAK,EAAE,2BAA2B;YAClC,WAAW,EAAE,oFAAoF;YACjG,WAAW,EAAE,EAAE;SAChB,EACD,KAAK,IAAI,EAAE;YACT,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,uBAAuB,EAAE,CAAC;gBAE/C,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;yBACtC;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAE5E,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,OAAO,EAAE,KAAK;gCACd,KAAK,EAAE,YAAY;6BACpB,EAAE,IAAI,EAAE,CAAC,CAAC;yBACZ;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC,CACF,CAAC;QAEF,4BAA4B;QAC5B,IAAI,CAAC,MAAM,CAAC,YAAY,CACtB,aAAa,EACb;YACE,KAAK,EAAE,aAAa;YACpB,WAAW,EAAE,sMAAsM;YACnN,WAAW,EAAE,gBAAuB;SACrC,EACD,KAAK,EAAE,IAAS,EAAE,EAAE;YAClB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;gBAE5C,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;yBACtC;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAE5E,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,OAAO,EAAE,KAAK;gCACd,KAAK,EAAE,YAAY;6BACpB,EAAE,IAAI,EAAE,CAAC,CAAC;yBACZ;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC,CACF,CAAC;QAEF,2BAA2B;QAC3B,IAAI,CAAC,MAAM,CAAC,YAAY,CACtB,YAAY,EACZ;YACE,KAAK,EAAE,kBAAkB;YACzB,WAAW,EAAE,uhBAAuhB;YACpiB,WAAW,EAAE,eAAsB;SACpC,EACD,KAAK,EAAE,IAAS,EAAE,EAAE;YAClB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;gBAErC,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;yBACtC;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAE5E,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,OAAO,EAAE,KAAK;gCACd,KAAK,EAAE,YAAY;6BACpB,EAAE,IAAI,EAAE,CAAC,CAAC;yBACZ;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG;QACP,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAErC,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC1D,CAAC;CACF"}

package/dist/tools/cache-tools.d.ts

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+/**
+ * List cached documentation schema
+ */
+export declare const ListCachedDocumentationSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+/**
+ * Clear cache schema
+ */
+export declare const ClearCacheSchema: z.ZodObject<{
+    urlPattern: z.ZodOptional<z.ZodString>;
+    clearAll: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    clearAll: boolean;
+    urlPattern?: string | undefined;
+}, {
+    urlPattern?: string | undefined;
+    clearAll?: boolean | undefined;
+}>;
+export type ClearCacheInput = z.infer<typeof ClearCacheSchema>;
+/**
+ * List cached documentation
+ */
+export declare function listCachedDocumentation(): Promise<{
+    success: boolean;
+    entries: import("../cache/cache-manager.js").CacheEntry[];
+    statistics: {
+        totalEntries: number;
+        totalSize: string;
+        oldestEntry: string | undefined;
+        newestEntry: string | undefined;
+    };
+    message: string;
+}>;
+/**
+ * Clear cache
+ */
+export declare function clearCache(input: ClearCacheInput): Promise<{
+    success: boolean;
+    deletedCount: number;
+    message: string;
+}>;
+//# sourceMappingURL=cache-tools.d.ts.map

package/dist/tools/cache-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-tools.d.ts","sourceRoot":"","sources":["../../src/tools/cache-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,6BAA6B,gDAAe,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;EAG3B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE/D;;GAEG;AACH,wBAAsB,uBAAuB;;;;;;;;;;GAiB5C;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe;;;;GAuBtD"}

package/dist/tools/cache-tools.js

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+import { CacheManager } from '../cache/cache-manager.js';
+/**
+ * List cached documentation schema
+ */
+export const ListCachedDocumentationSchema = z.object({});
+/**
+ * Clear cache schema
+ */
+export const ClearCacheSchema = z.object({
+    urlPattern: z.string().optional().describe('URL pattern to match for deletion (optional)'),
+    clearAll: z.boolean().optional().default(false).describe('Clear all cached entries'),
+});
+/**
+ * List cached documentation
+ */
+export async function listCachedDocumentation() {
+    const cache = new CacheManager();
+    const entries = await cache.list();
+    const stats = await cache.getStats();
+    return {
+        success: true,
+        entries,
+        statistics: {
+            totalEntries: stats.totalEntries,
+            totalSize: formatBytes(stats.totalSize),
+            oldestEntry: stats.oldestEntry?.toISOString(),
+            newestEntry: stats.newestEntry?.toISOString(),
+        },
+        message: `Found ${entries.length} cached documentation${entries.length !== 1 ? 's' : ''}`,
+    };
+}
+/**
+ * Clear cache
+ */
+export async function clearCache(input) {
+    const cache = new CacheManager();
+    let deletedCount;
+    let message;
+    if (input.clearAll) {
+        deletedCount = await cache.clear();
+        message = `Cleared all cache: deleted ${deletedCount} entry${deletedCount !== 1 ? 'ies' : 'y'}`;
+    }
+    else if (input.urlPattern) {
+        deletedCount = await cache.clear(input.urlPattern);
+        message = `Cleared cache matching "${input.urlPattern}": deleted ${deletedCount} entry${deletedCount !== 1 ? 'ies' : 'y'}`;
+    }
+    else {
+        // Clear expired only
+        deletedCount = await cache.clearExpired();
+        message = `Cleared expired cache: deleted ${deletedCount} entry${deletedCount !== 1 ? 'ies' : 'y'}`;
+    }
+    return {
+        success: true,
+        deletedCount,
+        message,
+    };
+}
+/**
+ * Format bytes to human-readable format
+ */
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 Bytes';
+    const k = 1024;
+    const sizes = ['Bytes', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${Math.round(bytes / Math.pow(k, i) * 100) / 100} ${sizes[i]}`;
+}
+//# sourceMappingURL=cache-tools.js.map

package/dist/tools/cache-tools.js.map

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

package/dist/tools/crawl-documentation.d.ts

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+/**
+ * Input schema for crawl_documentation tool
+ */
+export declare const CrawlDocumentationSchema: z.ZodObject<{
+    url: z.ZodString;
+    skillName: z.ZodString;
+    maxPages: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    depth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    workers: z.ZodOptional<z.ZodNumber>;
+    outputDir: z.ZodOptional<z.ZodString>;
+    useBrowser: z.ZodOptional<z.ZodBoolean>;
+    browser: z.ZodOptional<z.ZodEnum<["puppeteer", "playwright"]>>;
+    spaStrategy: z.ZodOptional<z.ZodEnum<["smart", "auto", "manual"]>>;
+    useCache: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    forceRefresh: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    skillName: string;
+    maxPages: number;
+    depth: number;
+    useCache: boolean;
+    forceRefresh: boolean;
+    workers?: number | undefined;
+    outputDir?: string | undefined;
+    useBrowser?: boolean | undefined;
+    browser?: "puppeteer" | "playwright" | undefined;
+    spaStrategy?: "smart" | "auto" | "manual" | undefined;
+}, {
+    url: string;
+    skillName: string;
+    maxPages?: number | undefined;
+    depth?: number | undefined;
+    workers?: number | undefined;
+    outputDir?: string | undefined;
+    useBrowser?: boolean | undefined;
+    browser?: "puppeteer" | "playwright" | undefined;
+    spaStrategy?: "smart" | "auto" | "manual" | undefined;
+    useCache?: boolean | undefined;
+    forceRefresh?: boolean | undefined;
+}>;
+export type CrawlDocumentationInput = z.infer<typeof CrawlDocumentationSchema>;
+/**
+ * Crawl documentation tool handler
+ */
+export declare function crawlDocumentation(input: CrawlDocumentationInput): Promise<{
+    success: boolean;
+    data: import("../processor/content-processor.js").ProcessedContent;
+    skillGenerationGuide: import("../processor/guide-generator.js").SkillGenerationGuide;
+    fromCache: boolean;
+    cacheAge: string;
+    message: string;
+    summary?: undefined;
+} | {
+    success: boolean;
+    fromCache: boolean;
+    summary: {
+        url: string;
+        skillName: string;
+        totalPages: number;
+        maxDepth: number;
+        errors: number;
+        quality: number;
+        savedFiles: {
+            skillDir: string;
+            skillMdPath: string;
+            referenceFiles: Array<{
+                name: string;
+                path: string;
+            }>;
+        };
+    };
+    message: string;
+    data?: undefined;
+    skillGenerationGuide?: undefined;
+    cacheAge?: undefined;
+}>;
+//# sourceMappingURL=crawl-documentation.d.ts.map

package/dist/tools/crawl-documentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crawl-documentation.d.ts","sourceRoot":"","sources":["../../src/tools/crawl-documentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYnC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE/E;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuFtE"}

package/dist/tools/crawl-documentation.js

@@ -0,0 +1,103 @@
+import { z } from 'zod';
+import { DependencyChecker } from '../executor/dependency-checker.js';
+import { CLIExecutor } from '../executor/cli-executor.js';
+import { ContentProcessor } from '../processor/content-processor.js';
+import { GuideGenerator } from '../processor/guide-generator.js';
+import { CacheManager } from '../cache/cache-manager.js';
+/**
+ * Input schema for crawl_documentation tool
+ */
+export const CrawlDocumentationSchema = z.object({
+    url: z.string().url().describe('Documentation URL to crawl'),
+    skillName: z.string().describe('Skill name (e.g., "react-docs")'), // ✅ 必需
+    maxPages: z.number().optional().default(50).describe('Maximum number of pages to crawl'), // ✅ 降低默认值
+    depth: z.number().optional().default(3).describe('Maximum crawl depth'),
+    workers: z.number().optional().describe('Number of parallel workers'),
+    outputDir: z.string().optional().describe('Output directory for skill files (default: ~/.claude/skills)'), // ✅ 新增
+    useBrowser: z.boolean().optional().describe('Force browser automation'),
+    browser: z.enum(['puppeteer', 'playwright']).optional().describe('Browser type to use'),
+    spaStrategy: z.enum(['smart', 'auto', 'manual']).optional().describe('SPA crawling strategy'),
+    useCache: z.boolean().optional().default(true).describe('Use cached results if available'),
+    forceRefresh: z.boolean().optional().default(false).describe('Force refresh even if cached'),
+});
+/**
+ * Crawl documentation tool handler
+ */
+export async function crawlDocumentation(input) {
+    const checker = new DependencyChecker();
+    const executor = new CLIExecutor(checker);
+    const processor = new ContentProcessor();
+    const guideGenerator = new GuideGenerator();
+    const cache = new CacheManager();
+    // 1. Check if CLI is installed
+    const cliCheck = await checker.checkCLIInstalled();
+    if (!cliCheck.installed) {
+        throw new Error(cliCheck.message);
+    }
+    // 2. Check cache (if enabled and not forcing refresh)
+    if (input.useCache && !input.forceRefresh) {
+        const cached = await cache.get(input.url);
+        if (cached) {
+            const ageMinutes = Math.floor((Date.now() - cached.timestamp) / 1000 / 60);
+            return {
+                success: true,
+                data: cached.data,
+                skillGenerationGuide: cached.guide,
+                fromCache: true,
+                cacheAge: `${ageMinutes} minutes`,
+                message: `Using cached data from ${ageMinutes} minutes ago. Use forceRefresh: true to re-crawl.`,
+            };
+        }
+    }
+    // 3. ✅ Prepare crawl parameters - 包含 outputDir 和 filename
+    const crawlParams = {
+        url: input.url,
+        maxPages: input.maxPages,
+        maxDepth: input.depth,
+        workers: input.workers,
+        useBrowser: input.useBrowser,
+        browser: input.browser,
+        spaStrategy: input.spaStrategy,
+        // ✅ 新增：让 CLI 直接保存文件
+        outputDir: input.outputDir,
+        filename: input.skillName,
+    };
+    // 4. ✅ Execute crawl - CLI 会生成并保存 SKILL
+    let lastProgress = '';
+    console.error('[Crawl] Starting crawl with SKILL generation...');
+    const rawResult = await executor.executeCrawl(crawlParams, (progress) => {
+        // Log progress to stderr (visible in MCP client logs)
+        if (progress.message !== lastProgress) {
+            console.error(`[Progress] ${progress.message}`);
+            lastProgress = progress.message;
+        }
+    });
+    // 5. ✅ 只返回轻量级摘要（不返回完整数据）
+    const summary = {
+        url: input.url,
+        skillName: input.skillName,
+        totalPages: rawResult.statistics.totalPages,
+        maxDepth: rawResult.statistics.maxDepthReached,
+        errors: rawResult.statistics.errors,
+        quality: rawResult.skill?.quality || 0,
+        // ✅ 文件路径信息
+        savedFiles: rawResult.savedFiles || {
+            skillDir: `${input.outputDir || '~/.claude/skills'}/${input.skillName}`,
+            skillMdPath: `${input.outputDir || '~/.claude/skills'}/${input.skillName}/SKILL.md`,
+            referenceFiles: [],
+        },
+    };
+    // 6. ✅ 不使用旧的缓存系统（缓存完整数据太大）
+    // 用户可以直接使用磁盘上的文件
+    // 7. ✅ 返回轻量级响应
+    return {
+        success: true,
+        fromCache: false,
+        summary,
+        message: `✓ Crawled ${summary.totalPages} pages and generated SKILL.\n` +
+            `Quality: ${summary.quality}/100\n` +
+            `Location: ${summary.savedFiles.skillMdPath}\n` +
+            `References: ${summary.savedFiles.referenceFiles.length} files`,
+    };
+}
+//# sourceMappingURL=crawl-documentation.js.map

package/dist/tools/crawl-documentation.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,4 @@
+export { crawlDocumentation, CrawlDocumentationSchema, type CrawlDocumentationInput, } from './crawl-documentation.js';
+export { listCachedDocumentation, clearCache, ListCachedDocumentationSchema, ClearCacheSchema, type ClearCacheInput, } from './cache-tools.js';
+export { saveSkill, SaveSkillSchema, type SaveSkillInput, type SaveSkillResult, extractSkillDataFromCrawlResult, } from './save-skill.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,uBAAuB,GAC7B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,uBAAuB,EACvB,UAAU,EACV,6BAA6B,EAC7B,gBAAgB,EAChB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,SAAS,EACT,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,+BAA+B,GAChC,MAAM,iBAAiB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,4 @@
+export { crawlDocumentation, CrawlDocumentationSchema, } from './crawl-documentation.js';
+export { listCachedDocumentation, clearCache, ListCachedDocumentationSchema, ClearCacheSchema, } from './cache-tools.js';
+export { saveSkill, SaveSkillSchema, extractSkillDataFromCrawlResult, } from './save-skill.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,wBAAwB,GAEzB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,uBAAuB,EACvB,UAAU,EACV,6BAA6B,EAC7B,gBAAgB,GAEjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,SAAS,EACT,eAAe,EAGf,+BAA+B,GAChC,MAAM,iBAAiB,CAAC"}

package/dist/tools/save-skill.d.ts

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+import type { CrawlResult } from '../executor/cli-executor.js';
+/**
+ * Input schema for save_skill tool
+ */
+export declare const SaveSkillSchema: z.ZodObject<{
+    skillName: z.ZodString;
+    skillContent: z.ZodString;
+    referenceFiles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    baseDirectory: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    overwrite: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    skillName: string;
+    skillContent: string;
+    baseDirectory: string;
+    overwrite: boolean;
+    referenceFiles?: Record<string, string> | undefined;
+}, {
+    skillName: string;
+    skillContent: string;
+    referenceFiles?: Record<string, string> | undefined;
+    baseDirectory?: string | undefined;
+    overwrite?: boolean | undefined;
+}>;
+export type SaveSkillInput = z.infer<typeof SaveSkillSchema>;
+/**
+ * Save skill result
+ */
+export interface SaveSkillResult {
+    success: boolean;
+    skillDirectory: string;
+    filesCreated: {
+        skillMd: string;
+        references: string[];
+    };
+    message: string;
+}
+/**
+ * Helper to extract skill data from crawl result
+ */
+export declare function extractSkillDataFromCrawlResult(crawlResult: CrawlResult, skillName: string): {
+    skillContent: string;
+    referenceFiles: Record<string, string>;
+};
+/**
+ * Save skill tool handler
+ */
+export declare function saveSkill(input: SaveSkillInput): Promise<SaveSkillResult>;
+//# sourceMappingURL=save-skill.d.ts.map

package/dist/tools/save-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-skill.d.ts","sourceRoot":"","sources":["../../src/tools/save-skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;EAM1B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,GAChB;IACD,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC,CAmBA;AAyJD;;GAEG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAqD/E"}