autosnippet 3.2.9 → 3.2.11

package/dist/lib/service/context/RecipeExtractor.d.ts

@@ -0,0 +1,69 @@
+/**
+ * RecipeExtractor — Recipe 内容提取器
+ * 从 Markdown 文件提取 Recipe 元数据、代码块、语义标签、质量评分
+ */
+interface ExtractorOptions {
+    extractSemanticTags?: boolean;
+    analyzeCodeQuality?: boolean;
+    computeQualityScore?: boolean;
+    contentHashEnabled?: boolean;
+}
+interface CodeBlock {
+    language: string;
+    code: string;
+    startIndex: number;
+}
+export declare class RecipeExtractor {
+    #private;
+    constructor(options?: ExtractorOptions);
+    /**
+     * 从文件提取 Recipe
+     * @param {string} filePath
+     * @returns {object|null}
+     */
+    extractFromFile(filePath: string): {
+        id: string;
+        title: string;
+        language: string;
+        category: string;
+        code: string;
+        description: string;
+        content: string;
+        filePath: string;
+        codeBlocks: CodeBlock[];
+        semanticTags: string[];
+        quality: {};
+        contentHash: string | null;
+        metadata: {
+            filename: string;
+            extractedAt: number;
+        };
+    } | null;
+    /**
+     * 从内容提取 Recipe
+     * @param {string} content
+     * @param {string} filename
+     * @param {string} filePath
+     * @returns {object}
+     */
+    extractFromContent(content: string, filename?: string, filePath?: string): {
+        id: string;
+        title: string;
+        language: string;
+        category: string;
+        code: string;
+        description: string;
+        content: string;
+        filePath: string;
+        codeBlocks: CodeBlock[];
+        semanticTags: string[];
+        quality: {};
+        contentHash: string | null;
+        metadata: {
+            filename: string;
+            extractedAt: number;
+        };
+    };
+}
+export {};
+//# sourceMappingURL=RecipeExtractor.d.ts.map

package/dist/lib/service/context/RecipeExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecipeExtractor.d.ts","sourceRoot":"","sources":["../../../../lib/service/context/RecipeExtractor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,UAAU,gBAAgB;IACxB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,UAAU,SAAS;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,eAAe;;gBAGd,OAAO,GAAE,gBAAqB;IAS1C;;;;OAIG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM;;;;;;;;;;;;;;;;;;IAQhC;;;;;;OAMG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAY,EAAE,QAAQ,SAAK;;;;;;;;;;;;;;;;;;CA+SxE"}

package/dist/lib/service/context/RecipeExtractor.js

@@ -0,0 +1,307 @@
+/**
+ * RecipeExtractor — Recipe 内容提取器
+ * 从 Markdown 文件提取 Recipe 元数据、代码块、语义标签、质量评分
+ */
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync } from 'node:fs';
+import { basename } from 'node:path';
+import { LanguageService } from '../../shared/LanguageService.js';
+export class RecipeExtractor {
+    #options;
+    constructor(options = {}) {
+        this.#options = {
+            extractSemanticTags: options.extractSemanticTags !== false,
+            analyzeCodeQuality: options.analyzeCodeQuality !== false,
+            computeQualityScore: options.computeQualityScore !== false,
+            contentHashEnabled: options.contentHashEnabled !== false,
+        };
+    }
+    /**
+     * 从文件提取 Recipe
+     * @param {string} filePath
+     * @returns {object|null}
+     */
+    extractFromFile(filePath) {
+        if (!existsSync(filePath)) {
+            return null;
+        }
+        const content = readFileSync(filePath, 'utf-8');
+        return this.extractFromContent(content, basename(filePath), filePath);
+    }
+    /**
+     * 从内容提取 Recipe
+     * @param {string} content
+     * @param {string} filename
+     * @param {string} filePath
+     * @returns {object}
+     */
+    extractFromContent(content, filename = 'unknown', filePath = '') {
+        // 1. 解析 frontmatter
+        const { frontmatter, body } = this.#parseFrontmatter(content);
+        // 2. 提取标题
+        const title = frontmatter.title || this.#extractTitle(body) || filename.replace(/\.[^.]+$/, '');
+        // 3. 提取代码块
+        const codeBlocks = this.#extractCodeBlocks(body);
+        // 4. 推断语言
+        const language = frontmatter.language || this.#inferLanguage(body, filename, codeBlocks);
+        // 5. 推断分类
+        const category = frontmatter.category || this.#inferCategory(title, body, language);
+        // 6. 语义标签
+        const semanticTags = this.#options.extractSemanticTags
+            ? this.#extractSemanticTags(body, codeBlocks)
+            : [];
+        // 7. 代码质量分析
+        const quality = this.#options.analyzeCodeQuality
+            ? this.#analyzeCodeQuality(codeBlocks, body)
+            : {};
+        // 8. 内容 hash
+        const contentHash = this.#options.contentHashEnabled
+            ? createHash('sha256').update(content).digest('hex').slice(0, 16)
+            : null;
+        return {
+            id: frontmatter.id || this.#generateId(filePath || filename),
+            title,
+            language,
+            category,
+            code: codeBlocks.map((b) => b.code).join('\n\n'),
+            description: frontmatter.description || this.#extractDescription(body),
+            content: body,
+            filePath,
+            codeBlocks,
+            semanticTags,
+            quality,
+            contentHash,
+            metadata: {
+                ...frontmatter,
+                filename,
+                extractedAt: Date.now(),
+            },
+        };
+    }
+    // --- Frontmatter ---
+    #parseFrontmatter(content) {
+        const match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+        if (!match) {
+            return { frontmatter: {}, body: content };
+        }
+        const frontmatter = {};
+        const lines = match[1].split('\n');
+        for (const line of lines) {
+            const colonIdx = line.indexOf(':');
+            if (colonIdx > 0) {
+                const key = line.slice(0, colonIdx).trim();
+                let value = line.slice(colonIdx + 1).trim();
+                // 简单 YAML 值解析
+                if (typeof value === 'string' && value.startsWith('[') && value.endsWith(']')) {
+                    value = value
+                        .slice(1, -1)
+                        .split(',')
+                        .map((s) => s.trim().replace(/^['"]|['"]$/g, ''));
+                }
+                else if (value === 'true') {
+                    value = true;
+                }
+                else if (value === 'false') {
+                    value = false;
+                }
+                else if (typeof value === 'string' && /^\d+$/.test(value)) {
+                    value = parseInt(value, 10);
+                }
+                else if (typeof value === 'string') {
+                    value = value.replace(/^['"]|['"]$/g, '');
+                }
+                frontmatter[key] = value;
+            }
+        }
+        return { frontmatter, body: match[2] };
+    }
+    // --- Title ---
+    #extractTitle(body) {
+        const match = body.match(/^#\s+(.+)/m);
+        return match ? match[1].trim() : null;
+    }
+    // --- Code Blocks ---
+    #extractCodeBlocks(body) {
+        const blocks = [];
+        const regex = /```(\w*)\n([\s\S]*?)```/g;
+        let match;
+        while ((match = regex.exec(body)) !== null) {
+            blocks.push({
+                language: match[1] || 'text',
+                code: match[2].trim(),
+                startIndex: match.index,
+            });
+        }
+        return blocks;
+    }
+    // --- Language Detection ---
+    #inferLanguage(body, filename, codeBlocks) {
+        // 从代码块推断
+        if (codeBlocks.length > 0) {
+            const lang = codeBlocks[0].language;
+            if (lang && lang !== 'text') {
+                return lang;
+            }
+        }
+        // 从文件名推断 —— 委托给 LanguageService
+        const detected = LanguageService.inferLang(filename);
+        if (detected !== 'unknown') {
+            return detected;
+        }
+        // 从内容关键词推断
+        if (/\bSwiftUI\b|\bUIKit\b|\bfunc\s/.test(body)) {
+            return 'swift';
+        }
+        if (/\bimport\s+React\b|\bconst\s/.test(body)) {
+            return 'javascript';
+        }
+        if (/\bdef\s+\w+.*:/.test(body)) {
+            return 'python';
+        }
+        if (/\bclass\s+\w+.*\{/.test(body) && /\bimport\s+java\./.test(body)) {
+            return 'java';
+        }
+        if (/\bpackage\s+\w+/.test(body) && /\bfunc\s/.test(body)) {
+            return 'go';
+        }
+        if (/\bfun\s+\w+/.test(body) && /\bval\s|\bvar\s/.test(body)) {
+            return 'kotlin';
+        }
+        return 'markdown';
+    }
+    // --- Category ---
+    #inferCategory(title, body, language) {
+        const text = `${title} ${body}`.toLowerCase();
+        const categories = [
+            {
+                name: 'networking',
+                keywords: ['network', 'api', 'http', 'url', 'fetch', 'request', 'response'],
+            },
+            { name: 'ui', keywords: ['ui', 'view', 'button', 'label', 'layout', 'component', 'render'] },
+            {
+                name: 'storage',
+                keywords: ['storage', 'database', 'cache', 'persist', 'save', 'file', 'coredata'],
+            },
+            { name: 'testing', keywords: ['test', 'spec', 'assert', 'mock', 'expect', 'coverage'] },
+            {
+                name: 'security',
+                keywords: ['security', 'auth', 'encrypt', 'token', 'permission', 'keychain'],
+            },
+            {
+                name: 'performance',
+                keywords: ['performance', 'optimize', 'speed', 'memory', 'async', 'concurrency'],
+            },
+            {
+                name: 'error-handling',
+                keywords: ['error', 'exception', 'catch', 'throw', 'fault', 'recovery'],
+            },
+            {
+                name: 'architecture',
+                keywords: ['mvvm', 'mvc', 'pattern', 'dependency', 'inject', 'protocol', 'design'],
+            },
+        ];
+        let bestCat = 'general';
+        let bestScore = 0;
+        for (const { name, keywords } of categories) {
+            const score = keywords.filter((kw) => text.includes(kw)).length;
+            if (score > bestScore) {
+                bestScore = score;
+                bestCat = name;
+            }
+        }
+        return bestCat;
+    }
+    // --- Semantic Tags ---
+    #extractSemanticTags(body, codeBlocks) {
+        const tags = new Set();
+        const text = body.toLowerCase();
+        const code = codeBlocks.map((b) => b.code).join('\n');
+        // 关键词标签
+        const tagPatterns = [
+            { tag: 'async', pattern: /\basync\b|\bawait\b|\bPromise\b/i },
+            { tag: 'error-handling', pattern: /\btry\b.*\bcatch\b|\bthrow\b|\bError\b/i },
+            { tag: 'generics', pattern: /\b<\w+>\b|<T>|<Element>/i },
+            { tag: 'protocol', pattern: /\bprotocol\b|\binterface\b|\bimplements\b/i },
+            { tag: 'closure', pattern: /\bclosure\b|\bcallback\b|=>\s*{/i },
+            { tag: 'testing', pattern: /\bXCTest\b|\bdescribe\b|\bit\b.*\bshould\b/i },
+            { tag: 'reactive', pattern: /\bCombine\b|\bRxSwift\b|\bObservable\b|\buseState\b/i },
+            { tag: 'caching', pattern: /\bcache\b|\bNSCache\b|\bmemoize\b/i },
+            { tag: 'concurrency', pattern: /\bDispatchQueue\b|\bTask\s*{|\bactor\b/i },
+        ];
+        for (const { tag, pattern } of tagPatterns) {
+            if (pattern.test(text) || pattern.test(code)) {
+                tags.add(tag);
+            }
+        }
+        return [...tags];
+    }
+    // --- Quality Analysis ---
+    #analyzeCodeQuality(codeBlocks, body) {
+        if (codeBlocks.length === 0) {
+            return { score: 0.5, hasCode: false };
+        }
+        const allCode = codeBlocks.map((b) => b.code).join('\n');
+        let score = 0.5;
+        // 有测试 +0.1
+        if (/test|spec|assert|expect/i.test(allCode)) {
+            score += 0.1;
+        }
+        // 有文档注释 +0.1
+        if (/\/\/\/|\/\*\*|"""/.test(allCode)) {
+            score += 0.1;
+        }
+        // 有错误处理 +0.1
+        if (/try|catch|throw|guard|Result</.test(allCode)) {
+            score += 0.1;
+        }
+        // 合理长度 +0.1
+        const lines = allCode.split('\n').length;
+        if (lines >= 5 && lines <= 200) {
+            score += 0.1;
+        }
+        // 无安全红旗 +0.1
+        if (!/eval\(|exec\(|force_unwrap/.test(allCode)) {
+            score += 0.1;
+        }
+        return {
+            score: Math.min(score, 1.0),
+            hasCode: true,
+            codeLineCount: lines,
+            codeBlockCount: codeBlocks.length,
+            hasTests: /test|spec|assert/i.test(allCode),
+            hasDocs: /\/\/\/|\/\*\*|"""/.test(allCode),
+            hasErrorHandling: /try|catch|throw/.test(allCode),
+        };
+    }
+    // --- Description ---
+    #extractDescription(body) {
+        // 取第一段非标题非代码的文本
+        const lines = body.split('\n');
+        const paragraphs = [];
+        let inCode = false;
+        for (const line of lines) {
+            if (line.startsWith('```')) {
+                inCode = !inCode;
+                continue;
+            }
+            if (inCode) {
+                continue;
+            }
+            if (line.startsWith('#')) {
+                continue;
+            }
+            if (line.trim().length > 0) {
+                paragraphs.push(line.trim());
+            }
+            if (paragraphs.length >= 3) {
+                break;
+            }
+        }
+        return paragraphs.join(' ').slice(0, 300) || '';
+    }
+    // --- ID Generation ---
+    #generateId(input) {
+        return createHash('md5').update(input).digest('hex').slice(0, 12);
+    }
+}
+//# sourceMappingURL=RecipeExtractor.js.map

package/dist/lib/service/context/RecipeExtractor.js.map

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

package/dist/lib/service/cursor/AgentInstructionsGenerator.d.ts

@@ -0,0 +1,133 @@
+/**
+ * AgentInstructionsGenerator — 通用 AI Agent 指令文件生成器
+ *
+ * Channel F: 为多种 AI 编码工具生成项目指令文件
+ *   - AGENTS.md      → OpenAI Codex / 通用 Agent
+ *   - CLAUDE.md       → Claude Code
+ *   - .github/copilot-instructions.md → GitHub Copilot（动态版，替代静态模板）
+ *
+ * 设计原则：
+ *   1. 内容来源统一 — 从 _loadEntries() 已加载的知识条目中提取
+ *   2. 格式差异化 — 同一数据按目标工具特性适配输出
+ *   3. 轻量索引 — 只输出摘要和规则，详细内容引导至 MCP 工具
+ *   4. 幂等生成 — 每次 deliver 重写全部文件，不做增量 diff
+ */
+import type { KnowledgeEntryProps } from '../../domain/knowledge/KnowledgeEntry.js';
+export declare class AgentInstructionsGenerator {
+    logger: {
+        info?: (...args: unknown[]) => void;
+    };
+    projectName: string;
+    projectRoot: string;
+    /**
+     * @param {string} projectRoot
+     * @param {string} projectName
+     * @param {Object} [logger]
+     */
+    constructor(projectRoot: string, projectName?: string, logger?: {
+        info?: (...args: unknown[]) => void;
+    });
+    /**
+     * 生成所有 Agent 指令文件
+     *
+     * @param {Object} params
+     * @param {Array<Object>} params.rules - kind='rule' 的条目（已排序）
+     * @param {Array<Object>} params.patterns - kind='pattern' 的条目（已排序）
+     * @param {string[]} params.skills 可用 Skill 名称列表
+     * @returns {{ agents: Object, claude: Object, copilot: Object }}
+     */
+    generate({ rules, patterns, skills, }?: {
+        rules?: KnowledgeEntryProps[];
+        patterns?: KnowledgeEntryProps[];
+        skills?: string[];
+    }): {
+        agents: {
+            filePath: string;
+            tokensUsed: number;
+            skipped: boolean;
+        };
+        claude: {
+            filePath: string;
+            tokensUsed: number;
+            skipped: boolean;
+        };
+        copilot: {
+            filePath: string;
+            tokensUsed: number;
+            skipped: boolean;
+        };
+        stats: {
+            filesWritten: number;
+            filesSkipped: number;
+            totalTokens: number;
+            duration: number;
+        };
+    };
+    /**
+     * 从知识条目构建共享内容段
+     * @private
+     */
+    _buildSections({ rules, patterns, skills, }: {
+        rules: KnowledgeEntryProps[];
+        patterns: KnowledgeEntryProps[];
+        skills: string[];
+    }): {
+        ruleLines: string[];
+        patternRows: string[];
+        skillLines: string[];
+        toolLines: string[];
+    };
+    /**
+     * @private
+     */
+    _writeAgentsMd(sections: {
+        ruleLines: string[];
+        patternRows: string[];
+        skillLines: string[];
+        toolLines: string[];
+    }): {
+        filePath: string;
+        tokensUsed: number;
+        skipped: boolean;
+    };
+    /**
+     * @private
+     */
+    _writeClaudeMd(sections: {
+        ruleLines: string[];
+        patternRows: string[];
+        skillLines: string[];
+        toolLines: string[];
+    }): {
+        filePath: string;
+        tokensUsed: number;
+        skipped: boolean;
+    };
+    /**
+     * 动态生成 copilot-instructions.md
+     * 替代原有的静态模板复制
+     * @private
+     */
+    _writeCopilotInstructions(sections: {
+        ruleLines: string[];
+        patternRows: string[];
+        skillLines: string[];
+        toolLines: string[];
+    }): {
+        filePath: string;
+        tokensUsed: number;
+        skipped: boolean;
+    };
+    /**
+     * 核心约束（所有 Agent 共享）
+     * @private
+     */
+    _renderConstraints(): string[];
+    /**
+     * 推荐工作流（AGENTS.md 用）
+     * @private
+     */
+    _renderWorkflow(): string[];
+}
+export default AgentInstructionsGenerator;
+//# sourceMappingURL=AgentInstructionsGenerator.d.ts.map

package/dist/lib/service/cursor/AgentInstructionsGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentInstructionsGenerator.d.ts","sourceRoot":"","sources":["../../../../lib/service/cursor/AgentInstructionsGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAiDpF,qBAAa,0BAA0B;IACrC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;KAAE,CAAC;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;gBAED,WAAW,EAAE,MAAM,EACnB,WAAW,SAAY,EACvB,MAAM,GAAE;QAAE,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;KAAY;IAO3D;;;;;;;;OAQG;IACH,QAAQ,CAAC,EACP,KAAU,EACV,QAAa,EACb,MAAW,GACZ,GAAE;QACD,KAAK,CAAC,EAAE,mBAAmB,EAAE,CAAC;QAC9B,QAAQ,CAAC,EAAE,mBAAmB,EAAE,CAAC;QACjC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACd;;;;;;;;;;;;;;;;;;;;;;;IAiDN;;;OAGG;IACH,cAAc,CAAC,EACb,KAAK,EACL,QAAQ,EACR,MAAM,GACP,EAAE;QACD,KAAK,EAAE,mBAAmB,EAAE,CAAC;QAC7B,QAAQ,EAAE,mBAAmB,EAAE,CAAC;QAChC,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB;;;;;;IA8CD;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE;QACvB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB;;;;;IA2DD;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE;QACvB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB;;;;;IA6ED;;;;OAIG;IACH,yBAAyB,CAAC,QAAQ,EAAE;QAClC,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB;;;;;IA2DD;;;OAGG;IACH,kBAAkB;IAoClB;;;OAGG;IACH,eAAe;CAkChB;AAED,eAAe,0BAA0B,CAAC"}