autosnippet 3.2.9 → 3.2.11

package/dist/lib/shared/StyleGuide.js

@@ -0,0 +1,110 @@
+/**
+ * StyleGuide.js — 项目特写写作指南（唯一权威来源）
+ *
+ * 供内部 Agent (bootstrap-producer.js) 和
+ * 外部 Agent (MissionBriefing submissionSpec) 共享使用。
+ *
+ * @module shared/StyleGuide
+ */
+import { FieldLevel, V3_FIELD_SPEC } from './FieldSpec.js';
+// ── 「项目特写」写作指南全文 ────────────────────────────────
+export const PROJECT_SNAPSHOT_STYLE_GUIDE = `# 「项目特写」写作要求
+
+submit_knowledge 的 content.markdown 字段必须是「项目特写」。
+
+## 什么是「项目特写」
+将一种技术的**基本用法**与**本项目的具体特征**融合为一体。
+
+## 四大核心内容
+1. **项目选择了什么** — 采用了哪种写法/模式/约定
+2. **为什么这样选** — 统计分布、占比、历史决策
+3. **项目禁止什么** — 反模式、已废弃写法
+4. **新代码怎么写** — 可直接复制使用的代码模板 + 来源标注 (来源: FileName.ext:行号)
+
+## 格式要求
+- 标题使用项目真实类名/前缀，不用占位名
+- 代码来源标注: (来源: FileName.ext:行号)
+- 不要纯代码罗列，必须有项目上下文
+- 标题和正文中不得出现 "Agent" 字样`;
+// ── Cursor 交付字段规范（从 FieldSpec 自动生成） ────────────
+/**
+ * 生成 Cursor 交付字段规范文本（供 Producer STYLE_GUIDE 和 MissionBriefing 使用）
+ * @returns {string}
+ */
+export function getCursorDeliverySpec() {
+    const required = [];
+    const expected = [];
+    for (const field of V3_FIELD_SPEC) {
+        // 跳过嵌套字段和非 Cursor 交付字段容器
+        if (field.name.includes('.')) {
+            continue;
+        }
+        if ([
+            'content',
+            'reasoning',
+            'title',
+            'description',
+            'headers',
+            'category',
+            'language',
+            'knowledgeType',
+            'usageGuide',
+        ].includes(field.name)) {
+            continue;
+        }
+        if (field.level === FieldLevel.REQUIRED) {
+            required.push(`- ${field.name}: ${field.rule}`);
+        }
+        else if (field.level === FieldLevel.EXPECTED) {
+            expected.push(`- ${field.name}: ${field.rule}`);
+        }
+    }
+    const parts = [];
+    if (required.length > 0) {
+        parts.push('### 必填（REQUIRED）');
+        parts.push(required.join('\n'));
+    }
+    if (expected.length > 0) {
+        parts.push('### 推荐（EXPECTED）');
+        parts.push(expected.join('\n'));
+    }
+    parts.push(`\n### 规范`);
+    parts.push(`1. trigger 以 @ 开头，kebab-case，不得在同一批次重复`);
+    parts.push(`2. doClause 英文祈使句，不含中文`);
+    parts.push(`3. coreCode 是可直接复制到编辑器的纯代码`);
+    parts.push(`4. kind 根据内容本质判断：强制约束 → rule，实现模式 → pattern，项目事实 → fact`);
+    return parts.join('\n');
+}
+/**
+ * 构建完整的 Producer STYLE_GUIDE（合并项目特写要求 + Cursor 交付字段规范）
+ * @returns {string}
+ */
+export function buildProducerStyleGuide() {
+    return [
+        PROJECT_SNAPSHOT_STYLE_GUIDE,
+        '',
+        '## Cursor 交付字段（每个 submit_knowledge 必须附带）',
+        '',
+        '每个候选必须提供以下交付字段，它们直接决定在 Cursor IDE 中作为 Rules 的展示质量。',
+        '注意：language / category / knowledgeType / source 由系统自动设置，无需填写。',
+        '',
+        getCursorDeliverySpec(),
+    ].join('\n');
+}
+/**
+ * 构建提交要求文本（Producer 复用）
+ * @returns {string}
+ */
+export const SUBMIT_REQUIREMENTS = `要求:
+1. 每个独立的知识点单独提交为一个候选 — 目标: 至少 3 个候选
+2. 先使用分析中已有的代码片段直接提交候选; 仅在需要更多代码上下文时才用 read_project_file
+3. filePaths 填写分析中提到的相关文件路径
+4. description 中文简述 ≤80 字，引用真实类名
+5. reasoning 中 sources 必须非空，填写来源文件名如 ["FileName.m"]，confidence 填 0.7~0.9
+6. 不要跳过任何分析中提到的知识点
+7. 如果 read_project_file 失败（文件不存在），直接用分析文本内容提交，不要重试其他路径
+8. 每个候选必须有 trigger (@kebab-case)、kind (rule/pattern/fact)、doClause (英文祈使句)
+9. dontClause（反向约束）、whenClause（触发场景）、coreCode（代码骨架）均为必填
+10. content 必须是包含 markdown 和 rationale 的对象: { markdown: "项目特写正文", rationale: "设计原理", pattern: "可选代码片段" }。⚠️ rationale 是必填字段，解释为什么采用这种做法
+11. kind 只能是 rule/pattern/fact 三选一，不要填写维度名（如 best-practice/architecture/code-standard 都不是合法 kind 值）`;
+//# sourceMappingURL=StyleGuide.js.map

package/dist/lib/shared/StyleGuide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StyleGuide.js","sourceRoot":"","sources":["../../../lib/shared/StyleGuide.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE3D,mDAAmD;AAEnD,MAAM,CAAC,MAAM,4BAA4B,GAAG;;;;;;;;;;;;;;;;;wBAiBpB,CAAC;AAEzB,kDAAkD;AAElD;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,yBAAyB;QACzB,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,SAAS;QACX,CAAC;QACD,IACE;YACE,SAAS;YACT,WAAW;YACX,OAAO;YACP,aAAa;YACb,SAAS;YACT,UAAU;YACV,UAAU;YACV,eAAe;YACf,YAAY;SACb,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EACtB,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,KAAK,KAAK,UAAU,CAAC,QAAQ,EAAE,CAAC;YACxC,QAAQ,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC;aAAM,IAAI,KAAK,CAAC,KAAK,KAAK,UAAU,CAAC,QAAQ,EAAE,CAAC;YAC/C,QAAQ,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACrD,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IAEtE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,4BAA4B;QAC5B,EAAE;QACF,0CAA0C;QAC1C,EAAE;QACF,oDAAoD;QACpD,+DAA+D;QAC/D,EAAE;QACF,qBAAqB,EAAE;KACxB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;oGAWiE,CAAC"}

package/dist/lib/shared/UnifiedValidator.d.ts

@@ -0,0 +1,57 @@
+/**
+ * UnifiedValidator.js — 统一验证链
+ *
+ * 替代 CandidateGuardrail + RecipeReadinessChecker 的分裂验证，
+ * 提供单一入口的三层验证 (字段完整性 + 内容质量 + 去重)。
+ *
+ * 分级模式:
+ *   strict   — 默认：完整 REQUIRED 字段检查（标准知识条目）
+ *   document — knowledgeType='dev-document' 时自动切换：跳过 Cursor 交付字段
+ *   fallback — source 含 'fallback' 时：REQUIRED 降级为 WARNING
+ *
+ * @module shared/UnifiedValidator
+ */
+export declare class UnifiedValidator {
+    #private;
+    /**
+     * @param {object} [options]
+     * @param {Set<string>} [options.existingTitles]       预填充已有标题
+     * @param {Set<string>} [options.existingFingerprints]  预填充已有代码指纹
+     */
+    constructor(options?: {
+        existingTitles?: Set<string>;
+        existingFingerprints?: Set<string>;
+    });
+    /**
+     * 完整验证链 (3 层)
+     *
+     * @param {object} candidate 候选数据（扁平字段）
+     * @param {object} [options]
+     * @param {'strict'|'document'|'fallback'} [options.mode]          验证模式（自动检测或手动指定）
+     * @param {string[]}                       [options.systemInjectedFields] 系统注入的字段（跳过 REQUIRED 检查）
+     * @param {boolean}                        [options.skipUniqueness=false] 跳过去重检查
+     * @returns {{ pass: boolean, errors: string[], warnings: string[] }}
+     */
+    validate(candidate: Record<string, unknown>, options?: {
+        mode?: 'strict' | 'document' | 'fallback';
+        systemInjectedFields?: string[];
+        skipUniqueness?: boolean;
+    }): {
+        pass: boolean;
+        errors: string[];
+        warnings: string[];
+    };
+    /**
+     * 记录已提交的标题和代码指纹（提交成功后调用）
+     * @param {string} title
+     * @param {string} [pattern] 代码模式
+     */
+    recordSubmission(title: string, pattern: string): void;
+}
+/**
+ * 创建一个无状态验证器实例（不含去重缓存），适用于一次性校验
+ * @returns {UnifiedValidator}
+ */
+export declare function createStatelessValidator(): UnifiedValidator;
+export default UnifiedValidator;
+//# sourceMappingURL=UnifiedValidator.d.ts.map

package/dist/lib/shared/UnifiedValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnifiedValidator.d.ts","sourceRoot":"","sources":["../../../lib/shared/UnifiedValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA0DH,qBAAa,gBAAgB;;IAO3B;;;;OAIG;gBACS,OAAO,GAAE;QAAE,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QAAC,oBAAoB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;KAAO;IAK9F;;;;;;;;;OASG;IACH,QAAQ,CACN,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,OAAO,GAAE;QACP,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;QAC1C,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;QAChC,cAAc,CAAC,EAAE,OAAO,CAAC;KACrB;;;;;IA6NR;;;;OAIG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAkEhD;AAID;;;GAGG;AACH,wBAAgB,wBAAwB,qBAEvC;AAED,eAAe,gBAAgB,CAAC"}

package/dist/lib/shared/UnifiedValidator.js

@@ -0,0 +1,315 @@
+/**
+ * UnifiedValidator.js — 统一验证链
+ *
+ * 替代 CandidateGuardrail + RecipeReadinessChecker 的分裂验证，
+ * 提供单一入口的三层验证 (字段完整性 + 内容质量 + 去重)。
+ *
+ * 分级模式:
+ *   strict   — 默认：完整 REQUIRED 字段检查（标准知识条目）
+ *   document — knowledgeType='dev-document' 时自动切换：跳过 Cursor 交付字段
+ *   fallback — source 含 'fallback' 时：REQUIRED 降级为 WARNING
+ *
+ * @module shared/UnifiedValidator
+ */
+import { FieldLevel, STANDARD_CATEGORIES, V3_FIELD_SPEC, VALID_KINDS, WHITELISTED_CATEGORIES, } from './FieldSpec.js';
+import { LanguageService } from './LanguageService.js';
+// ── Cursor 交付字段集合（document 模式跳过这些） ────────────
+const CURSOR_DELIVERY_FIELDS = new Set([
+    'trigger',
+    'kind',
+    'doClause',
+    'dontClause',
+    'whenClause',
+    'coreCode',
+    'topicHint',
+]);
+// ── 代码指纹工具函数 ───────────────────────────────────────
+/**
+ * 生成代码模式指纹 — 去除空白/注释后取前 200 字符的小写形式
+ * @param {string} code
+ * @returns {string}
+ */
+function codeFingerprint(code) {
+    return (code || '')
+        .replace(/\/\/[^\n]*/g, '') // 移除单行注释
+        .replace(/\/\*[\s\S]*?\*\//g, '') // 移除多行注释
+        .replace(/[\s]+/g, '') // 移除所有空白
+        .toLowerCase()
+        .slice(0, 200);
+}
+// ── 模式自动检测 ────────────────────────────────────────────
+/**
+ * 自动检测适合的验证模式
+ * @param {object} candidate
+ * @returns {'strict'|'document'|'fallback'}
+ */
+function detectMode(candidate) {
+    if (candidate.knowledgeType === 'dev-document') {
+        return 'document';
+    }
+    if (typeof candidate.source === 'string' && candidate.source.includes('fallback')) {
+        return 'fallback';
+    }
+    return 'strict';
+}
+// ── UnifiedValidator ────────────────────────────────────────
+export class UnifiedValidator {
+    /** @type {Set<string>} 已提交标题 (小写) */
+    #titles;
+    /** @type {Set<string>} 已提交代码指纹 */
+    #codeFingerprints;
+    /**
+     * @param {object} [options]
+     * @param {Set<string>} [options.existingTitles]       预填充已有标题
+     * @param {Set<string>} [options.existingFingerprints]  预填充已有代码指纹
+     */
+    constructor(options = {}) {
+        this.#titles = options.existingTitles || new Set();
+        this.#codeFingerprints = options.existingFingerprints || new Set();
+    }
+    /**
+     * 完整验证链 (3 层)
+     *
+     * @param {object} candidate 候选数据（扁平字段）
+     * @param {object} [options]
+     * @param {'strict'|'document'|'fallback'} [options.mode]          验证模式（自动检测或手动指定）
+     * @param {string[]}                       [options.systemInjectedFields] 系统注入的字段（跳过 REQUIRED 检查）
+     * @param {boolean}                        [options.skipUniqueness=false] 跳过去重检查
+     * @returns {{ pass: boolean, errors: string[], warnings: string[] }}
+     */
+    validate(candidate, options = {}) {
+        const errors = [];
+        const warnings = [];
+        const mode = options.mode || detectMode(candidate);
+        const systemInjected = new Set(options.systemInjectedFields || []);
+        // ── Layer 1: 字段完整性 (基于 V3_FIELD_SPEC) ──
+        this.#checkFields(candidate, mode, systemInjected, errors, warnings);
+        // ── Layer 2: 内容质量 (来自 CandidateGuardrail.validateQuality) ──
+        if (mode !== 'fallback') {
+            this.#checkContentQuality(candidate, mode, errors, warnings);
+        }
+        // ── Layer 3: 唯一性 (来自 CandidateGuardrail.validateUniqueness) ──
+        if (!options.skipUniqueness) {
+            this.#checkUniqueness(candidate, errors);
+        }
+        return {
+            pass: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    // ── Layer 1: 基于 FieldSpec 检查 ─────────────────────────
+    /**
+     * @param {object} candidate
+     * @param {'strict'|'document'|'fallback'} mode
+     * @param {Set<string>} systemInjected
+     * @param {string[]} errors
+     * @param {string[]} warnings
+     */
+    #checkFields(candidate, mode, systemInjected, errors, warnings) {
+        for (const field of V3_FIELD_SPEC) {
+            const { name, level, rule } = field;
+            // document 模式：跳过 Cursor 交付字段
+            if (mode === 'document' && CURSOR_DELIVERY_FIELDS.has(name.split('.')[0])) {
+                continue;
+            }
+            // 系统注入字段：跳过
+            if (systemInjected.has(name)) {
+                continue;
+            }
+            const value = this.#getNestedValue(candidate, name);
+            const missing = this.#isMissing(value, field);
+            if (!missing) {
+                continue;
+            }
+            if (level === FieldLevel.REQUIRED) {
+                if (mode === 'fallback') {
+                    // fallback 模式：REQUIRED 降级为 warning
+                    warnings.push(`${name}: ${rule}`);
+                }
+                else {
+                    errors.push(`缺少必填字段: ${name} — ${rule}`);
+                }
+            }
+            else if (level === FieldLevel.EXPECTED) {
+                warnings.push(`建议填写: ${name} — ${rule}`);
+            }
+            // OPTIONAL: 不报任何问题
+        }
+        // ── 额外的格式/值校验 ──
+        // content 必须是对象
+        if (candidate.content && typeof candidate.content !== 'object') {
+            errors.push('⚠️ content 必须是 JSON 对象（不是字符串！）。正确格式: { "markdown": "...", "rationale": "..." }');
+        }
+        // reasoning 必须是对象
+        if (candidate.reasoning && typeof candidate.reasoning !== 'object') {
+            errors.push('⚠️ reasoning 必须是 JSON 对象（不是字符串！）。正确格式: { "whyStandard": "...", "sources": [...], "confidence": 0.85 }');
+        }
+        // kind 值校验
+        if (candidate.kind && !VALID_KINDS.includes(candidate.kind)) {
+            errors.push(`kind 值无效: "${candidate.kind}" — 取值 rule/pattern/fact`);
+        }
+        // trigger 格式校验
+        if (candidate.trigger && !candidate.trigger.startsWith('@')) {
+            warnings.push(`trigger "${candidate.trigger}" 应以 @ 开头`);
+        }
+        // category 值校验
+        if (candidate.category &&
+            !STANDARD_CATEGORIES.includes(candidate.category) &&
+            !WHITELISTED_CATEGORIES.includes(candidate.category)) {
+            warnings.push(`category "${candidate.category}" 非标准值，应为: ${STANDARD_CATEGORIES.join('/')}（bootstrap/knowledge 等特殊来源可忽略此建议）`);
+        }
+        // language 校验
+        const lang = candidate.language?.toLowerCase();
+        if (lang && !LanguageService.isKnownLang(lang) && lang !== 'objc' && lang !== 'markdown') {
+            warnings.push(`language "${candidate.language}" — 请使用标准语言标识 (swift/typescript/python/java/kotlin 等)`);
+        }
+    }
+    // ── Layer 2: 内容质量启发式 ──────────────────────────────
+    /**
+     * @param {object} candidate
+     * @param {'strict'|'document'|'fallback'} mode
+     * @param {string[]} errors
+     * @param {string[]} warnings
+     */
+    #checkContentQuality(candidate, mode, errors, warnings) {
+        const markdown = candidate.content?.markdown || '';
+        // markdown ≥ 200 字符
+        if (markdown && markdown.length > 0 && markdown.length < 200) {
+            errors.push(`content.markdown 过短 (${markdown.length} 字符, 最少 200)。请包含代码片段和项目上下文描述。`);
+        }
+        // 代码块存在性
+        if (markdown &&
+            markdown.length >= 200 &&
+            !/```[\s\S]*?```/.test(markdown) &&
+            !/\.\w{1,10}(:\d+)?/.test(markdown)) {
+            errors.push('content.markdown 中必须包含至少一个代码块或文件引用');
+        }
+        // 来源引用（建议）
+        if (markdown && markdown.length >= 200) {
+            const hasSourceRef = /来源[:：]|[Ss]ource[:：]|\(\w+\.\w+:\d+\)/.test(markdown) ||
+                /[A-Z]\w+\.(?:m|h|swift|java|kt|js|ts|go|py|rs|rb|cs|cpp|c)/.test(markdown);
+            if (!hasSourceRef) {
+                warnings.push('建议在内容中标注代码来源 (来源: FileName.ext:行号)');
+            }
+        }
+        // coreCode 语法完整性
+        if (mode !== 'document') {
+            const coreCode = (candidate.coreCode || '').trim();
+            if (coreCode) {
+                const firstChar = coreCode[0];
+                if (firstChar === '}' || firstChar === ')' || firstChar === ']') {
+                    errors.push(`coreCode 以 "${firstChar}" 开头 — 代码片段不完整，请包含完整的函数/方法/表达式`);
+                }
+            }
+        }
+        // 通用知识检测
+        const genericPatterns = [/^(Singleton|Factory|Observer|MVC|MVVM) (pattern|模式)$/i];
+        const title = candidate.title || '';
+        if (genericPatterns.some((p) => p.test(title.trim()))) {
+            errors.push(`标题过于通用: "${title}" — 请加上项目特定的上下文`);
+        }
+        // 内容过于简单
+        if (markdown && markdown.length > 0 && markdown.length >= 200) {
+            const lines = markdown.split('\n').filter((l) => l.trim().length > 0);
+            if (lines.length <= 2 && !/```[\s\S]*?```/.test(markdown)) {
+                warnings.push(`内容仅 ${lines.length} 行 — 建议包含更多代码片段和设计意图描述`);
+            }
+        }
+    }
+    // ── Layer 3: 去重 ────────────────────────────────────────
+    /**
+     * @param {object} candidate
+     * @param {string[]} errors
+     */
+    #checkUniqueness(candidate, errors) {
+        const title = (candidate.title || '').toLowerCase().trim();
+        if (title && this.#titles.has(title)) {
+            errors.push(`标题重复: "${candidate.title}"`);
+        }
+        const pattern = (candidate.content?.pattern || '').trim();
+        if (pattern.length >= 30) {
+            const fp = codeFingerprint(pattern);
+            if (fp.length >= 20 && this.#codeFingerprints.has(fp)) {
+                errors.push('代码模式重复 — 已存在相同核心代码的候选。请提交不同的代码片段。');
+            }
+        }
+    }
+    // ── 提交记录 ─────────────────────────────────────────────
+    /**
+     * 记录已提交的标题和代码指纹（提交成功后调用）
+     * @param {string} title
+     * @param {string} [pattern] 代码模式
+     */
+    recordSubmission(title, pattern) {
+        if (title) {
+            this.#titles.add(title.toLowerCase().trim());
+        }
+        if (pattern && pattern.length >= 30) {
+            const fp = codeFingerprint(pattern);
+            if (fp.length >= 20) {
+                this.#codeFingerprints.add(fp);
+            }
+        }
+    }
+    // ── 工具函数 ─────────────────────────────────────────────
+    /**
+     * 获取嵌套字段值
+     * @param {object} obj
+     * @param {string} path 如 'content.markdown' 或 'reasoning.sources'
+     * @returns {*}
+     */
+    #getNestedValue(obj, path) {
+        const parts = path.split('.');
+        let current = obj;
+        for (const part of parts) {
+            if (current == null || typeof current !== 'object') {
+                return undefined;
+            }
+            current = current[part];
+        }
+        return current;
+    }
+    /**
+     * 检查值是否为"缺失"
+     * @param {*} value
+     * @param {FieldDef} field
+     * @returns {boolean}
+     */
+    #isMissing(value, field) {
+        if (value === undefined || value === null) {
+            return true;
+        }
+        if (field.type === 'string') {
+            return typeof value !== 'string' || !value.trim();
+        }
+        if (field.type === 'array') {
+            if (!Array.isArray(value)) {
+                return true;
+            }
+            // reasoning.sources 必须非空
+            if (field.name === 'reasoning.sources') {
+                return value.length === 0;
+            }
+            // headers 允许空数组
+            if (field.name === 'headers') {
+                return false;
+            }
+            return false;
+        }
+        if (field.type === 'object') {
+            return typeof value !== 'object';
+        }
+        return !value;
+    }
+}
+// ── 便捷工厂函数 ────────────────────────────────────────────
+/**
+ * 创建一个无状态验证器实例（不含去重缓存），适用于一次性校验
+ * @returns {UnifiedValidator}
+ */
+export function createStatelessValidator() {
+    return new UnifiedValidator();
+}
+export default UnifiedValidator;
+//# sourceMappingURL=UnifiedValidator.js.map

package/dist/lib/shared/UnifiedValidator.js.map

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

package/dist/lib/shared/concurrency.d.ts

@@ -0,0 +1,34 @@
+/**
+ * concurrency.ts — 统一并发控制工具
+ *
+ * 基于 p-limit 提供项目级并发 preset，替代手写 Semaphore / 滑动窗口。
+ *
+ * 用法:
+ *   import { ioLimit, cpuLimit } from '#shared/concurrency.js';
+ *   const results = await Promise.all(items.map(item => ioLimit(() => process(item))));
+ *
+ * 动态并发（按运行时配置）:
+ *   import { createLimit } from '#shared/concurrency.js';
+ *   const limit = createLimit(tierConfig.concurrency);
+ *
+ * @module shared/concurrency
+ */
+import { type LimitFunction } from 'p-limit';
+/** IO 密集型（文件读写、DB 查询、本地向量操作） */
+export declare const ioLimit: LimitFunction;
+/** CPU 密集型（AST 解析、BM25 搜索） */
+export declare const cpuLimit: LimitFunction;
+/**
+ * 创建自定义并发限制器
+ *
+ * @param concurrency 最大并发数
+ * @returns p-limit 实例
+ */
+export declare function createLimit(concurrency: number): LimitFunction;
+declare const _default: {
+    ioLimit: LimitFunction;
+    cpuLimit: LimitFunction;
+    createLimit: typeof createLimit;
+};
+export default _default;
+//# sourceMappingURL=concurrency.d.ts.map

package/dist/lib/shared/concurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../../../lib/shared/concurrency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAe,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAErD,gCAAgC;AAChC,eAAO,MAAM,OAAO,EAAE,aAA0B,CAAC;AAEjD,8BAA8B;AAC9B,eAAO,MAAM,QAAQ,EAAE,aAAyB,CAAC;AAEjD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAK9D;;;;;;AAED,wBAAkD"}

package/dist/lib/shared/concurrency.js

@@ -0,0 +1,34 @@
+/**
+ * concurrency.ts — 统一并发控制工具
+ *
+ * 基于 p-limit 提供项目级并发 preset，替代手写 Semaphore / 滑动窗口。
+ *
+ * 用法:
+ *   import { ioLimit, cpuLimit } from '#shared/concurrency.js';
+ *   const results = await Promise.all(items.map(item => ioLimit(() => process(item))));
+ *
+ * 动态并发（按运行时配置）:
+ *   import { createLimit } from '#shared/concurrency.js';
+ *   const limit = createLimit(tierConfig.concurrency);
+ *
+ * @module shared/concurrency
+ */
+import pLimit from 'p-limit';
+/** IO 密集型（文件读写、DB 查询、本地向量操作） */
+export const ioLimit = pLimit(20);
+/** CPU 密集型（AST 解析、BM25 搜索） */
+export const cpuLimit = pLimit(4);
+/**
+ * 创建自定义并发限制器
+ *
+ * @param concurrency 最大并发数
+ * @returns p-limit 实例
+ */
+export function createLimit(concurrency) {
+    if (!Number.isFinite(concurrency) || concurrency < 1) {
+        throw new RangeError(`concurrency must be a finite number >= 1, got ${concurrency}`);
+    }
+    return pLimit(concurrency);
+}
+export default { ioLimit, cpuLimit, createLimit };
+//# sourceMappingURL=concurrency.js.map

package/dist/lib/shared/concurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../../../lib/shared/concurrency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,MAA8B,MAAM,SAAS,CAAC;AAErD,gCAAgC;AAChC,MAAM,CAAC,MAAM,OAAO,GAAkB,MAAM,CAAC,EAAE,CAAC,CAAC;AAEjD,8BAA8B;AAC9B,MAAM,CAAC,MAAM,QAAQ,GAAkB,MAAM,CAAC,CAAC,CAAC,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,WAAmB;IAC7C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,UAAU,CAAC,iDAAiD,WAAW,EAAE,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC;AAC7B,CAAC;AAED,eAAe,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC"}