autosnippet 3.2.16 → 3.2.17

package/dist/lib/service/quality/FeedbackCollector.d.ts

@@ -13,15 +13,12 @@ export declare class FeedbackCollector {
     constructor(projectRoot: string, options?: FeedbackCollectorOptions);
     /**
      * 记录一个交互事件
-     * @param {'view'|'click'|'rate'|'dismiss'|'copy'|'insert'|'feedback'} type
-     * @param {string} recipeId
-     * @param {object} data 任意附加数据 (rating, comment, etc.)
+     * @param data 任意附加数据 (rating, comment, etc.)
      */
     record(type: string, recipeId: string, data?: Record<string, unknown>): void;
     /**
      * 获取指定 Recipe 的事件统计
-     * @param {string} recipeId
-     * @returns {{ views: number, clicks: number, copies: number, avgRating: number, feedbackCount: number }}
+     * @returns }
      */
     getRecipeStats(recipeId: string): {
         views: number;
@@ -31,25 +28,18 @@ export declare class FeedbackCollector {
         feedbackCount: number;
         totalEvents: number;
     };
-    /**
-     * 获取全局统计
-     */
+    /** 获取全局统计 */
     getGlobalStats(): {
         totalEvents: number;
         byType: Record<string, number>;
         uniqueRecipes: number;
     };
-    /**
-     * 获取热门 Recipes (by interaction count)
-     */
+    /** 获取热门 Recipes (by interaction count) */
     getTopRecipes(n?: number): {
         recipeId: string;
         count: number;
     }[];
-    /**
-     * 清空记录
-     */
+    /** 清空记录 */
     clear(): void;
 }
 export {};
-//# sourceMappingURL=FeedbackCollector.d.ts.map

package/dist/lib/service/quality/FeedbackCollector.js

@@ -21,9 +21,7 @@ export class FeedbackCollector {
     }
     /**
      * 记录一个交互事件
-     * @param {'view'|'click'|'rate'|'dismiss'|'copy'|'insert'|'feedback'} type
-     * @param {string} recipeId
-     * @param {object} data 任意附加数据 (rating, comment, etc.)
+     * @param data 任意附加数据 (rating, comment, etc.)
      */
     record(type, recipeId, data = {}) {
         this.#events.push({
@@ -39,8 +37,7 @@ export class FeedbackCollector {
     }
     /**
      * 获取指定 Recipe 的事件统计
-     * @param {string} recipeId
-     * @returns {{ views: number, clicks: number, copies: number, avgRating: number, feedbackCount: number }}
+     * @returns }
      */
     getRecipeStats(recipeId) {
         const events = this.#events.filter((e) => e.recipeId === recipeId);
@@ -58,9 +55,7 @@ export class FeedbackCollector {
             totalEvents: events.length,
         };
     }
-    /**
-     * 获取全局统计
-     */
+    /** 获取全局统计 */
     getGlobalStats() {
         const byType = {};
         for (const e of this.#events) {
@@ -72,9 +67,7 @@ export class FeedbackCollector {
             uniqueRecipes: new Set(this.#events.map((e) => e.recipeId)).size,
         };
     }
-    /**
-     * 获取热门 Recipes (by interaction count)
-     */
+    /** 获取热门 Recipes (by interaction count) */
     getTopRecipes(n = 10) {
         const counts = {};
         for (const e of this.#events) {
@@ -85,9 +78,7 @@ export class FeedbackCollector {
             .slice(0, n)
             .map(([recipeId, count]) => ({ recipeId, count }));
     }
-    /**
-     * 清空记录
-     */
+    /** 清空记录 */
     clear() {
         this.#events = [];
         this.#save();
@@ -135,4 +126,3 @@ export class FeedbackCollector {
         }
     }
 }
-//# sourceMappingURL=FeedbackCollector.js.map

package/dist/lib/service/quality/QualityScorer.d.ts

@@ -26,8 +26,8 @@ export declare class QualityScorer {
     constructor(options?: QualityScorerOptions);
     /**
      * 计算综合质量分
-     * @param {object} recipe - Recipe 对象 (title, trigger, code, language, category, summary, usageGuide, headers, tags, views, clicks, rating)
-     * @returns {{ score: number, dimensions: object, grade: string }}
+     * @param recipe Recipe 对象 (title, trigger, code, language, category, summary, usageGuide, headers, tags, views, clicks, rating)
+     * @returns }
      */
     score(recipe: RecipeInput): {
         score: number;
@@ -40,9 +40,7 @@ export declare class QualityScorer {
         };
         grade: string;
     };
-    /**
-     * 批量评分
-     */
+    /** 批量评分 */
     scoreBatch(recipes: RecipeInput[]): {
         score: number;
         dimensions: {
@@ -55,9 +53,7 @@ export declare class QualityScorer {
         grade: string;
         recipe: RecipeInput;
     }[];
-    /**
-     * 获取维度权重
-     */
+    /** 获取维度权重 */
     getWeights(): {
         completeness: 0.3;
         format: 0.25;
@@ -67,4 +63,3 @@ export declare class QualityScorer {
     };
 }
 export {};
-//# sourceMappingURL=QualityScorer.d.ts.map

package/dist/lib/service/quality/QualityScorer.js

@@ -12,8 +12,8 @@ export class QualityScorer {
     }
     /**
      * 计算综合质量分
-     * @param {object} recipe - Recipe 对象 (title, trigger, code, language, category, summary, usageGuide, headers, tags, views, clicks, rating)
-     * @returns {{ score: number, dimensions: object, grade: string }}
+     * @param recipe Recipe 对象 (title, trigger, code, language, category, summary, usageGuide, headers, tags, views, clicks, rating)
+     * @returns }
      */
     score(recipe) {
         const dimensions = {
@@ -35,22 +35,16 @@ export class QualityScorer {
             grade: this.#toGrade(totalScore),
         };
     }
-    /**
-     * 批量评分
-     */
+    /** 批量评分 */
     scoreBatch(recipes) {
         return recipes.map((r) => ({ recipe: r, ...this.score(r) }));
     }
-    /**
-     * 获取维度权重
-     */
+    /** 获取维度权重 */
     getWeights() {
         return { ...this.#weights };
     }
     // ─── 维度评分 ─────────────────────────────────────────
-    /**
-     * 完整性: title(0.25) + trigger(0.25) + code(0.3) + usageGuide(0.2)
-     */
+    /** 完整性: title(0.25) + trigger(0.25) + code(0.3) + usageGuide(0.2) */
     #scoreCompleteness(r) {
         let s = 0;
         if (r.title?.trim()) {
@@ -67,9 +61,7 @@ export class QualityScorer {
         }
         return s;
     }
-    /**
-     * 格式: trigger 格式(0.5) + language 合法性(0.5)
-     */
+    /** 格式: trigger 格式(0.5) + language 合法性(0.5) */
     #scoreFormat(r) {
         let s = 0;
         if (r.trigger) {
@@ -99,9 +91,7 @@ export class QualityScorer {
         }
         return s;
     }
-    /**
-     * 代码质量: 长度适中(0.3) + 无 TODO(0.2) + 有注释(0.3) + 有错误处理(0.2)
-     */
+    /** 代码质量: 长度适中(0.3) + 无 TODO(0.2) + 有注释(0.3) + 有错误处理(0.2) */
     #scoreCodeQuality(r) {
         if (!r.code) {
             return 0;
@@ -129,9 +119,7 @@ export class QualityScorer {
         }
         return s;
     }
-    /**
-     * 元数据: category(0.35) + tags/headers(0.35) + summary(0.3)
-     */
+    /** 元数据: category(0.35) + tags/headers(0.35) + summary(0.3) */
     #scoreMetadata(r) {
         let s = 0;
         if (r.category?.trim()) {
@@ -145,9 +133,7 @@ export class QualityScorer {
         }
         return s;
     }
-    /**
-     * 互动: views(0.3) + clicks(0.3) + rating(0.4)
-     */
+    /** 互动: views(0.3) + clicks(0.3) + rating(0.4) */
     #scoreEngagement(r) {
         let s = 0;
         if (r.views && r.views > 0) {
@@ -161,9 +147,7 @@ export class QualityScorer {
         }
         return s;
     }
-    /**
-     * 分数转等级
-     */
+    /** 分数转等级 */
     #toGrade(score) {
         if (score >= QUALITY_GRADES.A) {
             return 'A';
@@ -180,4 +164,3 @@ export class QualityScorer {
         return 'F';
     }
 }
-//# sourceMappingURL=QualityScorer.js.map

package/dist/lib/service/recipe/RecipeCandidateValidator.d.ts

@@ -31,8 +31,7 @@ interface RecipeCandidate {
 export declare class RecipeCandidateValidator {
     /**
      * 验证单个候选（V3 结构）
-     * @param {object} candidate
-     * @returns {{ valid: boolean, errors: string[], warnings: string[] }}
+     * @returns }
      */
     validate(candidate: RecipeCandidate): {
         valid: boolean;
@@ -41,8 +40,7 @@ export declare class RecipeCandidateValidator {
     };
     /**
      * 批量验证
-     * @param {object[]} candidates
-     * @returns {{ valid: object[], invalid: object[], summary: { total: number, validCount: number, invalidCount: number } }}
+     * @returns }}
      */
     validateBatch(candidates: RecipeCandidate[]): {
         valid: {
@@ -63,18 +61,11 @@ export declare class RecipeCandidateValidator {
             invalidCount: number;
         };
     };
-    /**
-     * 获取有效类别列表
-     */
+    /** 获取有效类别列表 */
     getValidCategories(): string[];
-    /**
-     * 获取有效 kind 列表
-     */
+    /** 获取有效 kind 列表 */
     getValidKinds(): string[];
-    /**
-     * 获取所有必填字段名列表
-     */
+    /** 获取所有必填字段名列表 */
     getRequiredFields(): string[];
 }
 export {};
-//# sourceMappingURL=RecipeCandidateValidator.d.ts.map

package/dist/lib/service/recipe/RecipeCandidateValidator.js

@@ -4,7 +4,7 @@
  * 验证候选是否满足 V3 结构化字段要求。
  * 核心变更：用 content 对象替代旧版 code 字符串。
  */
-import { getRequiredFieldNames } from '../../shared/FieldSpec.js';
+import { getRequiredFieldNames } from '#domain/knowledge/FieldSpec.js';
 import { LanguageService } from '../../shared/LanguageService.js';
 /* ── V3 必填字段（从 FieldSpec 获取顶层字段，排除嵌套和容器字段） ── */
 const REQUIRED_FIELDS = getRequiredFieldNames().filter((f) => !['content', 'headers', 'reasoning', 'knowledgeType', 'usageGuide'].includes(f));
@@ -25,8 +25,7 @@ const VALID_KINDS = new Set(['rule', 'pattern', 'fact']);
 export class RecipeCandidateValidator {
     /**
      * 验证单个候选（V3 结构）
-     * @param {object} candidate
-     * @returns {{ valid: boolean, errors: string[], warnings: string[] }}
+     * @returns }
      */
     validate(candidate) {
         const errors = [];
@@ -127,8 +126,7 @@ export class RecipeCandidateValidator {
     }
     /**
      * 批量验证
-     * @param {object[]} candidates
-     * @returns {{ valid: object[], invalid: object[], summary: { total: number, validCount: number, invalidCount: number } }}
+     * @returns }}
      */
     validateBatch(candidates) {
         const valid = [];
@@ -152,21 +150,15 @@ export class RecipeCandidateValidator {
             },
         };
     }
-    /**
-     * 获取有效类别列表
-     */
+    /** 获取有效类别列表 */
     getValidCategories() {
         return [...VALID_CATEGORIES];
     }
-    /**
-     * 获取有效 kind 列表
-     */
+    /** 获取有效 kind 列表 */
     getValidKinds() {
         return [...VALID_KINDS];
     }
-    /**
-     * 获取所有必填字段名列表
-     */
+    /** 获取所有必填字段名列表 */
     getRequiredFields() {
         return [
             ...REQUIRED_FIELDS,
@@ -181,4 +173,3 @@ export class RecipeCandidateValidator {
         ];
     }
 }
-//# sourceMappingURL=RecipeCandidateValidator.js.map

package/dist/lib/service/recipe/RecipeParser.d.ts

@@ -33,56 +33,29 @@ export declare class RecipeParser {
      * 需包含: frontmatter + 代码块 + Usage Guide
      */
     isCompleteRecipe(text: string): boolean;
-    /**
-     * 检查是否为「仅介绍」Recipe（有 frontmatter 但无代码块）
-     */
+    /** 检查是否为「仅介绍」Recipe（有 frontmatter 但无代码块） */
     isIntroOnly(text: string): boolean;
-    /**
-     * 解析完整 Recipe MD 为结构化对象
-     * @param {string} text
-     * @returns {object|null}
-     */
+    /** 解析完整 Recipe MD 为结构化对象 */
     parse(text: string): ParsedRecipe | null;
-    /**
-     * 从文本中解析多段 Recipe（按 `---` 分隔）
-     */
+    /** 从文本中解析多段 Recipe（按 `---` 分隔） */
     parseAll(text: string): ParsedRecipe[];
-    /**
-     * 解析 frontmatter YAML
-     */
+    /** 解析 frontmatter YAML */
     parseFrontmatter(text: string): Record<string, unknown>;
-    /**
-     * 从内容提取 trigger
-     */
+    /** 从内容提取 trigger */
     getTrigger(text: string): string;
     /**
      * 从文件路径读取并提取 Recipe 候选
-     * @param {string} relativePath 相对路径
-     * @param {object} opts
-     * @param {string} [opts.projectRoot] 项目根目录
-     * @returns {Promise<{ items: object[], isMarked: boolean }>}
+     * @param relativePath 相对路径
+     * @param [opts.projectRoot] 项目根目录
+     * @returns >}
      */
     extractFromPath(relativePath: string, opts?: ExtractOpts): Promise<{
         items: ParsedRecipe[];
         isMarked: boolean;
     }>;
-    /**
-     * 从文本解析 Recipe（优先完整 Markdown 格式）
-     * @param {string} text
-     * @param {object} opts
-     * @param {string} [opts.language]
-     * @param {string} [opts.relativePath]
-     * @returns {Promise<object>}
-     */
+    /** 从文本解析 Recipe（优先完整 Markdown 格式） */
     parseFromText(text: string, opts?: ExtractOpts): Promise<ParsedRecipe | ParsedRecipe[]>;
-    /**
-     * 从文本提取代码片段（兜底方法，不要求 Markdown 格式）
-     * @param {string} text
-     * @param {object} opts
-     * @param {string} [opts.language]
-     * @returns {Promise<object>}
-     */
+    /** 从文本提取代码片段（兜底方法，不要求 Markdown 格式） */
     extractFromText(text: string, opts?: ExtractOpts): Promise<ParsedRecipe | ParsedRecipe[]>;
 }
 export {};
-//# sourceMappingURL=RecipeParser.d.ts.map

package/dist/lib/service/recipe/RecipeParser.js

@@ -20,20 +20,14 @@ export class RecipeParser {
         }
         return FRONTMATTER_RE.test(text) && FENCED_CODE_RE.test(text) && USAGE_HEADING_RE.test(text);
     }
-    /**
-     * 检查是否为「仅介绍」Recipe（有 frontmatter 但无代码块）
-     */
+    /** 检查是否为「仅介绍」Recipe（有 frontmatter 但无代码块） */
     isIntroOnly(text) {
         if (!text) {
             return false;
         }
         return FRONTMATTER_RE.test(text) && !FENCED_CODE_RE.test(text);
     }
-    /**
-     * 解析完整 Recipe MD 为结构化对象
-     * @param {string} text
-     * @returns {object|null}
-     */
+    /** 解析完整 Recipe MD 为结构化对象 */
     parse(text) {
         if (!text) {
             return null;
@@ -79,9 +73,7 @@ export class RecipeParser {
             frontmatter,
         };
     }
-    /**
-     * 从文本中解析多段 Recipe（按 `---` 分隔）
-     */
+    /** 从文本中解析多段 Recipe（按 `---` 分隔） */
     parseAll(text) {
         if (!text) {
             return [];
@@ -89,9 +81,7 @@ export class RecipeParser {
         const segments = text.split(/\n---\n/).filter((s) => s.trim().length > 0);
         return segments.map((s) => this.parse(s)).filter((r) => r !== null);
     }
-    /**
-     * 解析 frontmatter YAML
-     */
+    /** 解析 frontmatter YAML */
     parseFrontmatter(text) {
         const match = text.match(FRONTMATTER_RE);
         if (!match) {
@@ -126,19 +116,16 @@ export class RecipeParser {
         }
         return fm;
     }
-    /**
-     * 从内容提取 trigger
-     */
+    /** 从内容提取 trigger */
     getTrigger(text) {
         const fm = this.parseFrontmatter(text);
         return fm.trigger || '';
     }
     /**
      * 从文件路径读取并提取 Recipe 候选
-     * @param {string} relativePath 相对路径
-     * @param {object} opts
-     * @param {string} [opts.projectRoot] 项目根目录
-     * @returns {Promise<{ items: object[], isMarked: boolean }>}
+     * @param relativePath 相对路径
+     * @param [opts.projectRoot] 项目根目录
+     * @returns >}
      */
     async extractFromPath(relativePath, opts = {}) {
         const projectRoot = opts.projectRoot || process.cwd();
@@ -185,14 +172,7 @@ export class RecipeParser {
             isMarked: false,
         };
     }
-    /**
-     * 从文本解析 Recipe（优先完整 Markdown 格式）
-     * @param {string} text
-     * @param {object} opts
-     * @param {string} [opts.language]
-     * @param {string} [opts.relativePath]
-     * @returns {Promise<object>}
-     */
+    /** 从文本解析 Recipe（优先完整 Markdown 格式） */
     async parseFromText(text, opts = {}) {
         if (!text || text.trim().length === 0) {
             throw new Error('文本内容为空');
@@ -211,13 +191,7 @@ export class RecipeParser {
         }
         throw new Error('文本不是有效的 Recipe Markdown 格式');
     }
-    /**
-     * 从文本提取代码片段（兜底方法，不要求 Markdown 格式）
-     * @param {string} text
-     * @param {object} opts
-     * @param {string} [opts.language]
-     * @returns {Promise<object>}
-     */
+    /** 从文本提取代码片段（兜底方法，不要求 Markdown 格式） */
     async extractFromText(text, opts = {}) {
         if (!text || text.trim().length === 0) {
             throw new Error('文本内容为空');
@@ -277,4 +251,3 @@ export class RecipeParser {
             .slice(0, 30);
     }
 }
-//# sourceMappingURL=RecipeParser.js.map

package/dist/lib/service/search/BM25Scorer.d.ts

@@ -7,9 +7,7 @@
  * @module BM25Scorer
  */
 import type { BM25Document, BM25SearchResult } from './SearchTypes.js';
-/**
- * BM25 评分器
- */
+/** BM25 评分器 */
 export declare class BM25Scorer {
     _idIndex: Map<string, number>;
     _totalLength: number;
@@ -18,35 +16,22 @@ export declare class BM25Scorer {
     documents: (BM25Document | null)[];
     totalDocs: number;
     constructor();
-    /**
-     * 添加文档到索引
-     */
+    /** 添加文档到索引 */
     addDocument(id: string, text: string, meta?: Record<string, unknown>): void;
     /**
      * 移除文档（增量删除）
      * 采用标记删除 + 懒清理策略：将文档标记为 null，当空洞率 > 30% 时自动压缩
-     * @returns {boolean} 是否成功移除
+     * @returns 是否成功移除
      */
     removeDocument(id: string): boolean;
-    /**
-     * 更新文档（增量: remove + add）
-     */
+    /** 更新文档（增量: remove + add） */
     updateDocument(id: string, text: string, meta?: Record<string, unknown>): void;
-    /**
-     * 检查文档是否存在
-     */
+    /** 检查文档是否存在 */
     hasDocument(id: string): boolean;
-    /**
-     * 压缩 documents 数组，清除 tombstone 空洞
-     */
+    /** 压缩 documents 数组，清除 tombstone 空洞 */
     _compact(): void;
-    /**
-     * 查询文档，返回按 BM25 分数排序的结果
-     */
+    /** 查询文档，返回按 BM25 分数排序的结果 */
     search(query: string, limit?: number): BM25SearchResult[];
-    /**
-     * 清空索引
-     */
+    /** 清空索引 */
     clear(): void;
 }
-//# sourceMappingURL=BM25Scorer.d.ts.map

package/dist/lib/service/search/BM25Scorer.js

@@ -7,9 +7,7 @@
  * @module BM25Scorer
  */
 import { BM25_B, BM25_K1, tokenize } from './tokenizer.js';
-/**
- * BM25 评分器
- */
+/** BM25 评分器 */
 export class BM25Scorer {
     _idIndex;
     _totalLength;
@@ -25,9 +23,7 @@ export class BM25Scorer {
         this._totalLength = 0; // 累计文档长度，避免 O(N) 重算
         this._idIndex = new Map(); // id → array index (O(1) 查找)
     }
-    /**
-     * 添加文档到索引
-     */
+    /** 添加文档到索引 */
     addDocument(id, text, meta = {}) {
         // 如果 id 已存在，先移除旧版本（确保幂等）
         if (this._idIndex.has(id)) {
@@ -52,7 +48,7 @@ export class BM25Scorer {
     /**
      * 移除文档（增量删除）
      * 采用标记删除 + 懒清理策略：将文档标记为 null，当空洞率 > 30% 时自动压缩
-     * @returns {boolean} 是否成功移除
+     * @returns 是否成功移除
      */
     removeDocument(id) {
         const idx = this._idIndex.get(id);
@@ -84,22 +80,16 @@ export class BM25Scorer {
         }
         return true;
     }
-    /**
-     * 更新文档（增量: remove + add）
-     */
+    /** 更新文档（增量: remove + add） */
     updateDocument(id, text, meta = {}) {
         this.removeDocument(id);
         this.addDocument(id, text, meta);
     }
-    /**
-     * 检查文档是否存在
-     */
+    /** 检查文档是否存在 */
     hasDocument(id) {
         return this._idIndex.has(id);
     }
-    /**
-     * 压缩 documents 数组，清除 tombstone 空洞
-     */
+    /** 压缩 documents 数组，清除 tombstone 空洞 */
     _compact() {
         const alive = this.documents.filter((d) => d !== null);
         this.documents = alive;
@@ -108,9 +98,7 @@ export class BM25Scorer {
             this._idIndex.set(alive[i].id, i);
         }
     }
-    /**
-     * 查询文档，返回按 BM25 分数排序的结果
-     */
+    /** 查询文档，返回按 BM25 分数排序的结果 */
     search(query, limit = 20) {
         const queryTokens = tokenize(query);
         if (queryTokens.length === 0) {
@@ -140,9 +128,7 @@ export class BM25Scorer {
         scores.sort((a, b) => b.score - a.score);
         return scores.slice(0, limit);
     }
-    /**
-     * 清空索引
-     */
+    /** 清空索引 */
     clear() {
         this.documents = [];
         this.docFreq = {};
@@ -152,4 +138,3 @@ export class BM25Scorer {
         this._idIndex.clear();
     }
 }
-//# sourceMappingURL=BM25Scorer.js.map

package/dist/lib/service/search/CoarseRanker.d.ts

@@ -31,8 +31,8 @@ export declare class CoarseRanker {
     });
     /**
      * 粗排
-     * @param {Array} candidates 需有 bm25Score、semanticScore 等字段
-     * @returns {Array} - sorted with coarseScore
+     * @param candidates 需有 bm25Score、semanticScore 等字段
+     * @returns sorted with coarseScore
      */
     rank(candidates: RankerCandidate[]): {
         coarseScore: number;
@@ -61,4 +61,3 @@ export declare class CoarseRanker {
     }[];
 }
 export {};
-//# sourceMappingURL=CoarseRanker.d.ts.map

package/dist/lib/service/search/CoarseRanker.js

@@ -15,8 +15,8 @@ export class CoarseRanker {
     }
     /**
      * 粗排
-     * @param {Array} candidates 需有 bm25Score、semanticScore 等字段
-     * @returns {Array} - sorted with coarseScore
+     * @param candidates 需有 bm25Score、semanticScore 等字段
+     * @returns sorted with coarseScore
      */
     rank(candidates) {
         if (!candidates || candidates.length === 0) {
@@ -111,4 +111,3 @@ export class CoarseRanker {
         return Math.min(Math.max(value, 0), 1.0);
     }
 }
-//# sourceMappingURL=CoarseRanker.js.map