autosnippet 3.2.10 → 3.2.12

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

@@ -0,0 +1,184 @@
+/**
+ * RecipeCandidateValidator — Recipe 候选校验器 (V3)
+ *
+ * 验证候选是否满足 V3 结构化字段要求。
+ * 核心变更：用 content 对象替代旧版 code 字符串。
+ */
+import { getRequiredFieldNames } from '../../shared/FieldSpec.js';
+import { LanguageService } from '../../shared/LanguageService.js';
+/* ── V3 必填字段（从 FieldSpec 获取顶层字段，排除嵌套和容器字段） ── */
+const REQUIRED_FIELDS = getRequiredFieldNames().filter((f) => !['content', 'headers', 'reasoning', 'knowledgeType', 'usageGuide'].includes(f));
+/* ── 需要 content 子对象有内容 ── */
+// NOTE: reserved for future content sub-field validation
+// const REQUIRED_CONTENT_FIELDS = ['pattern', 'markdown', 'rationale'];
+const VALID_CATEGORIES = new Set([
+    'view',
+    'service',
+    'tool',
+    'model',
+    'network',
+    'storage',
+    'ui',
+    'utility',
+]);
+const VALID_KINDS = new Set(['rule', 'pattern', 'fact']);
+export class RecipeCandidateValidator {
+    /**
+     * 验证单个候选（V3 结构）
+     * @param {object} candidate
+     * @returns {{ valid: boolean, errors: string[], warnings: string[] }}
+     */
+    validate(candidate) {
+        const errors = [];
+        const warnings = [];
+        if (!candidate || typeof candidate !== 'object') {
+            return { valid: false, errors: ['候选为空或类型错误'], warnings: [] };
+        }
+        // ── V3 必填字段 ──
+        for (const field of REQUIRED_FIELDS) {
+            const val = candidate[field];
+            if (!val || (typeof val === 'string' && !val.trim())) {
+                errors.push(`缺少必填字段: ${field}`);
+            }
+        }
+        // ── content 对象必须包含有效内容 ──
+        const content = candidate.content;
+        if (!content || typeof content !== 'object') {
+            errors.push('缺少必填字段: content（需为 { pattern, markdown, rationale } 对象）');
+        }
+        else {
+            const hasPattern = !!(content.pattern && String(content.pattern).trim());
+            const hasMarkdown = !!(content.markdown && String(content.markdown).trim());
+            if (!hasPattern && !hasMarkdown) {
+                errors.push('content.pattern 或 content.markdown 至少需要一个非空');
+            }
+            if (!content.rationale || !String(content.rationale).trim()) {
+                errors.push('缺少必填字段: content.rationale（设计原理）');
+            }
+        }
+        // ── trigger 格式 ──
+        if (candidate.trigger && typeof candidate.trigger === 'string') {
+            if (candidate.trigger.length < 2) {
+                errors.push('trigger 过短');
+            }
+            if (candidate.trigger.length > 64) {
+                errors.push('trigger 过长 (>64)');
+            }
+            if (!candidate.trigger.startsWith('@')) {
+                warnings.push('trigger 应以 @ 开头');
+            }
+            if (!/^@?[a-zA-Z0-9_\-:.]+$/.test(candidate.trigger)) {
+                warnings.push('trigger 含特殊字符，建议仅使用字母/数字/下划线/连字符');
+            }
+        }
+        // ── kind 合法性 ──
+        if (candidate.kind && !VALID_KINDS.has(candidate.kind)) {
+            errors.push(`kind "${candidate.kind}" 无效 — 必须为 rule/pattern/fact`);
+        }
+        // ── category 合法性 ──
+        if (candidate.category && !VALID_CATEGORIES.has(candidate.category.toLowerCase())) {
+            warnings.push(`category "${candidate.category}" 不在标准列表（View/Service/Tool/Model/Network/Storage/UI/Utility）`);
+        }
+        // ── language 合法性 ──
+        if (candidate.language) {
+            const lang = candidate.language.toLowerCase();
+            if (!LanguageService.isKnownLang(lang) && lang !== 'objc' && lang !== 'markdown') {
+                warnings.push(`language "${candidate.language}" 不在已知语言列表`);
+            }
+        }
+        // ── headers 必填 ──
+        if (!Array.isArray(candidate.headers)) {
+            errors.push('缺少必填字段: headers（需为 import 语句数组，无 import 时传 []）');
+        }
+        // ── knowledgeType 必填 ──
+        if (!candidate.knowledgeType || !String(candidate.knowledgeType).trim()) {
+            errors.push('缺少必填字段: knowledgeType');
+        }
+        // ── usageGuide 必填 ──
+        if (!candidate.usageGuide || !String(candidate.usageGuide).trim()) {
+            errors.push('缺少必填字段: usageGuide（使用指南，### 章节格式）');
+        }
+        // ── 推理依据 (reasoning) 必填 ──
+        if (!candidate.reasoning) {
+            errors.push('缺少必填字段: reasoning（需包含 whyStandard + sources + confidence）');
+        }
+        else {
+            if (!candidate.reasoning.whyStandard?.trim()) {
+                errors.push('reasoning.whyStandard 不能为空');
+            }
+            if (!Array.isArray(candidate.reasoning.sources) || candidate.reasoning.sources.length === 0) {
+                errors.push('reasoning.sources 至少包含一项来源');
+            }
+            if (typeof candidate.reasoning.confidence !== 'number' ||
+                candidate.reasoning.confidence < 0 ||
+                candidate.reasoning.confidence > 1) {
+                warnings.push('reasoning.confidence 应为 0-1 的数字');
+            }
+        }
+        // ── 标签 ──
+        if (candidate.tags && !Array.isArray(candidate.tags)) {
+            warnings.push('tags 应为数组');
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * 批量验证
+     * @param {object[]} candidates
+     * @returns {{ valid: object[], invalid: object[], summary: { total: number, validCount: number, invalidCount: number } }}
+     */
+    validateBatch(candidates) {
+        const valid = [];
+        const invalid = [];
+        for (const candidate of candidates) {
+            const result = this.validate(candidate);
+            if (result.valid) {
+                valid.push({ candidate, ...result });
+            }
+            else {
+                invalid.push({ candidate, ...result });
+            }
+        }
+        return {
+            valid,
+            invalid,
+            summary: {
+                total: candidates.length,
+                validCount: valid.length,
+                invalidCount: invalid.length,
+            },
+        };
+    }
+    /**
+     * 获取有效类别列表
+     */
+    getValidCategories() {
+        return [...VALID_CATEGORIES];
+    }
+    /**
+     * 获取有效 kind 列表
+     */
+    getValidKinds() {
+        return [...VALID_KINDS];
+    }
+    /**
+     * 获取所有必填字段名列表
+     */
+    getRequiredFields() {
+        return [
+            ...REQUIRED_FIELDS,
+            'content',
+            'content.rationale',
+            'headers',
+            'knowledgeType',
+            'usageGuide',
+            'reasoning',
+            'reasoning.whyStandard',
+            'reasoning.sources',
+        ];
+    }
+}
+//# sourceMappingURL=RecipeCandidateValidator.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"RecipeParser.d.ts","sourceRoot":"","sources":["../../../../lib/service/recipe/RecipeParser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,UAAU,SAAS;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,WAAW;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAOD,qBAAa,YAAY;;IACvB;;;OAGG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM;IAO7B;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM;IAOxB;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAqDxC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE;IAQtC;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAgCvD;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM;IAKvB;;;;;;OAMG;IACG,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB;;;;IAmDlE;;;;;;;OAOG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB;IAsBxD;;;;;;OAMG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB;CAiE3D"}

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

@@ -0,0 +1,280 @@
+/**
+ * RecipeParser — Recipe Markdown 解析器
+ * 从完整 Recipe MD 提取结构化数据
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { LanguageService } from '../../shared/LanguageService.js';
+const FRONTMATTER_RE = /^---\n([\s\S]*?)\n---/;
+const _SNIPPET_HEADING_RE = /^##\s+(?:Snippet|Code|代码)/im;
+const USAGE_HEADING_RE = /^##\s+(?:Usage\s*Guide|用法|使用指南)/im;
+const FENCED_CODE_RE = /```(\w*)\n([\s\S]*?)```/;
+export class RecipeParser {
+    /**
+     * 检查文本是否为完整 Recipe MD
+     * 需包含: frontmatter + 代码块 + Usage Guide
+     */
+    isCompleteRecipe(text) {
+        if (!text) {
+            return false;
+        }
+        return FRONTMATTER_RE.test(text) && FENCED_CODE_RE.test(text) && USAGE_HEADING_RE.test(text);
+    }
+    /**
+     * 检查是否为「仅介绍」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}
+     */
+    parse(text) {
+        if (!text) {
+            return null;
+        }
+        const frontmatter = this.parseFrontmatter(text);
+        const body = text.replace(FRONTMATTER_RE, '').trim();
+        // 提取代码块
+        const codeBlocks = [];
+        let match;
+        const codeRe = /```(\w*)\n([\s\S]*?)```/g;
+        while ((match = codeRe.exec(body)) !== null) {
+            codeBlocks.push({ language: match[1] || 'text', code: match[2].trim() });
+        }
+        // 提取 Usage Guide
+        const usageMatch = body.match(USAGE_HEADING_RE);
+        let usageGuide = '';
+        if (usageMatch && usageMatch.index !== undefined) {
+            const usageStart = usageMatch.index + usageMatch[0].length;
+            const nextHeading = body.slice(usageStart).search(/^##\s+/m);
+            usageGuide =
+                nextHeading > 0
+                    ? body.slice(usageStart, usageStart + nextHeading).trim()
+                    : body.slice(usageStart).trim();
+        }
+        // 提取标题
+        const titleMatch = body.match(/^#\s+(.+)/m);
+        const title = frontmatter.title || (titleMatch ? titleMatch[1].trim() : '');
+        // 提取 headers
+        const headers = this.#extractHeaders(body);
+        return {
+            title,
+            summary: frontmatter.summary || frontmatter.description || '',
+            description: frontmatter.description || frontmatter.summary || '',
+            trigger: frontmatter.trigger || this.#generateTrigger(title),
+            category: frontmatter.category || 'general',
+            language: frontmatter.language ||
+                (codeBlocks[0]?.language !== 'text' ? codeBlocks[0]?.language : 'swift'),
+            code: codeBlocks.map((b) => b.code).join('\n\n'),
+            codeBlocks,
+            usageGuide,
+            headers,
+            includeHeaders: headers.length > 0,
+            frontmatter,
+        };
+    }
+    /**
+     * 从文本中解析多段 Recipe（按 `---` 分隔）
+     */
+    parseAll(text) {
+        if (!text) {
+            return [];
+        }
+        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
+     */
+    parseFrontmatter(text) {
+        const match = text.match(FRONTMATTER_RE);
+        if (!match) {
+            return {};
+        }
+        const fm = {};
+        for (const line of match[1].split('\n')) {
+            const colonIdx = line.indexOf(':');
+            if (colonIdx > 0) {
+                const key = line.slice(0, colonIdx).trim();
+                let value = line.slice(colonIdx + 1).trim();
+                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, '');
+                }
+                fm[key] = value;
+            }
+        }
+        return fm;
+    }
+    /**
+     * 从内容提取 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 }>}
+     */
+    async extractFromPath(relativePath, opts = {}) {
+        const projectRoot = opts.projectRoot || process.cwd();
+        const fullPath = path.isAbsolute(relativePath)
+            ? relativePath
+            : path.resolve(projectRoot, relativePath);
+        if (!fs.existsSync(fullPath)) {
+            throw new Error(`文件不存在: ${fullPath}`);
+        }
+        const content = fs.readFileSync(fullPath, 'utf8');
+        const ext = path.extname(fullPath).toLowerCase();
+        const language = LanguageService.langFromExt(ext);
+        // 尝试解析为完整 Recipe Markdown
+        if (this.isCompleteRecipe(content)) {
+            const parsed = this.parse(content);
+            if (parsed) {
+                return { items: [parsed], isMarked: false };
+            }
+        }
+        // 尝试多段解析
+        const allRecipes = this.parseAll(content);
+        if (allRecipes.length > 0) {
+            return { items: allRecipes, isMarked: false };
+        }
+        // 回退: 将整个文件内容作为代码片段
+        const title = path.basename(fullPath, ext);
+        return {
+            items: [
+                {
+                    title,
+                    summary: '',
+                    description: '',
+                    trigger: this.#generateTrigger(title),
+                    category: 'Utility',
+                    language,
+                    code: content,
+                    codeBlocks: [{ language, code: content }],
+                    usageGuide: '',
+                    headers: this.#extractHeaders(content),
+                    includeHeaders: false,
+                    frontmatter: {},
+                },
+            ],
+            isMarked: false,
+        };
+    }
+    /**
+     * 从文本解析 Recipe（优先完整 Markdown 格式）
+     * @param {string} text
+     * @param {object} opts
+     * @param {string} [opts.language]
+     * @param {string} [opts.relativePath]
+     * @returns {Promise<object>}
+     */
+    async parseFromText(text, opts = {}) {
+        if (!text || text.trim().length === 0) {
+            throw new Error('文本内容为空');
+        }
+        // 尝试完整 Recipe 解析
+        if (this.isCompleteRecipe(text)) {
+            const parsed = this.parse(text);
+            if (parsed) {
+                return parsed;
+            }
+        }
+        // 尝试批量解析
+        const all = this.parseAll(text);
+        if (all.length > 0) {
+            return all;
+        }
+        throw new Error('文本不是有效的 Recipe Markdown 格式');
+    }
+    /**
+     * 从文本提取代码片段（兜底方法，不要求 Markdown 格式）
+     * @param {string} text
+     * @param {object} opts
+     * @param {string} [opts.language]
+     * @returns {Promise<object>}
+     */
+    async extractFromText(text, opts = {}) {
+        if (!text || text.trim().length === 0) {
+            throw new Error('文本内容为空');
+        }
+        const language = opts.language || 'unknown';
+        // 先尝试标准解析
+        try {
+            const result = await this.parseFromText(text, opts);
+            return result;
+        }
+        catch {
+            /* 继续兜底逻辑 */
+        }
+        // 提取代码块
+        const codeBlocks = [];
+        const codeRe = /```(\w*)\n([\s\S]*?)```/g;
+        let match;
+        while ((match = codeRe.exec(text)) !== null) {
+            codeBlocks.push({ language: match[1] || language, code: match[2].trim() });
+        }
+        const code = codeBlocks.length > 0 ? codeBlocks.map((b) => b.code).join('\n\n') : text.trim();
+        // 简单标题推断
+        const titleLine = text.split('\n').find((l) => l.trim().startsWith('#'));
+        const title = titleLine ? titleLine.replace(/^#+\s*/, '').trim() : 'Untitled Snippet';
+        return {
+            title,
+            summary: '',
+            description: '',
+            trigger: this.#generateTrigger(title),
+            category: 'Utility',
+            language,
+            code,
+            codeBlocks: codeBlocks.length > 0 ? codeBlocks : [{ language, code }],
+            usageGuide: '',
+            headers: this.#extractHeaders(code),
+            includeHeaders: false,
+            frontmatter: {},
+        };
+    }
+    #extractHeaders(body) {
+        const headers = [];
+        const re = /#import\s+[<"]([^>"]+)[>"]/g;
+        let match;
+        while ((match = re.exec(body)) !== null) {
+            headers.push(match[1]);
+        }
+        return headers;
+    }
+    #generateTrigger(title) {
+        if (!title) {
+            return '';
+        }
+        return title
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, '_')
+            .replace(/(^_|_$)/g, '')
+            .slice(0, 30);
+    }
+}
+//# sourceMappingURL=RecipeParser.js.map

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

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

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

@@ -0,0 +1,64 @@
+/**
+ * CoarseRanker — 粗排器
+ * 基于 E-E-A-T 标准的 5 维加权排序（BM25 + Semantic + Quality + Freshness + Popularity）
+ */
+interface RankerCandidate {
+    bm25Score?: number;
+    score?: number;
+    semanticScore?: number;
+    title?: string;
+    code?: string;
+    content?: string;
+    description?: string;
+    summary?: string;
+    category?: string;
+    language?: string;
+    tags?: string[];
+    updatedAt?: number | string;
+    lastModified?: number | string;
+    createdAt?: number | string;
+    usageCount?: number;
+    [key: string]: unknown;
+}
+export declare class CoarseRanker {
+    #private;
+    constructor(options?: {
+        bm25Weight?: number;
+        semanticWeight?: number;
+        qualityWeight?: number;
+        freshnessWeight?: number;
+        popularityWeight?: number;
+    });
+    /**
+     * 粗排
+     * @param {Array} candidates 需有 bm25Score、semanticScore 等字段
+     * @returns {Array} - sorted with coarseScore
+     */
+    rank(candidates: RankerCandidate[]): {
+        coarseScore: number;
+        coarseSignals: {
+            bm25: number;
+            semantic: number;
+            quality: number;
+            freshness: number;
+            popularity: number;
+        };
+        bm25Score?: number;
+        score?: number;
+        semanticScore?: number;
+        title?: string;
+        code?: string;
+        content?: string;
+        description?: string;
+        summary?: string;
+        category?: string;
+        language?: string;
+        tags?: string[];
+        updatedAt?: number | string;
+        lastModified?: number | string;
+        createdAt?: number | string;
+        usageCount?: number;
+    }[];
+}
+export {};
+//# sourceMappingURL=CoarseRanker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CoarseRanker.d.ts","sourceRoot":"","sources":["../../../../lib/service/search/CoarseRanker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,UAAU,eAAe;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,YAAY;;gBAIrB,OAAO,GAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KACtB;IAWR;;;;OAIG;IACH,IAAI,CAAC,UAAU,EAAE,eAAe,EAAE;;;;;;;;;oBA5CtB,MAAM;gBACV,MAAM;wBACE,MAAM;gBACd,MAAM;eACP,MAAM;kBACH,MAAM;sBACF,MAAM;kBACV,MAAM;mBACL,MAAM;mBACN,MAAM;eACV,MAAM,EAAE;oBACH,MAAM,GAAG,MAAM;uBACZ,MAAM,GAAG,MAAM;oBAClB,MAAM,GAAG,MAAM;qBACd,MAAM;;CA6IpB"}