autosnippet 3.2.10 → 3.2.12

package/lib/shared/UnifiedValidator.js

@@ -1,355 +0,0 @@
-/**
- * UnifiedValidator.js — 统一验证链
- *
- * 替代 CandidateGuardrail + RecipeReadinessChecker 的分裂验证，
- * 提供单一入口的三层验证 (字段完整性 + 内容质量 + 去重)。
- *
- * 分级模式:
- *   strict   — 默认：完整 REQUIRED 字段检查（标准知识条目）
- *   document — knowledgeType='dev-document' 时自动切换：跳过 Cursor 交付字段
- *   fallback — source 含 'fallback' 时：REQUIRED 降级为 WARNING
- *
- * @module shared/UnifiedValidator
- */
-
-import {
-  FieldLevel,
-  V3_FIELD_SPEC,
-  STANDARD_CATEGORIES,
-  WHITELISTED_CATEGORIES,
-  VALID_KINDS,
-} 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;

package/lib/shared/constants.js

@@ -1,161 +0,0 @@
-/**
- * 全局常量注册表 — 集中管理所有魔法数字和阈值
- *
- * 取代散落在各模块中的硬编码数字，方便统一调参和文档化。
- *
- * @module shared/constants
- */
-
-// ─── 质量评分 ───────────────────────────────────────────
-
-/** QualityScorer 维度权重 */
-export const QUALITY_WEIGHTS = Object.freeze({
-  completeness: 0.30,
-  format: 0.25,
-  codeQuality: 0.25,
-  metadata: 0.10,
-  engagement: 0.10,
-});
-
-/** QualityScorer 等级分界线 */
-export const QUALITY_GRADES = Object.freeze({
-  A: 0.9,
-  B: 0.75,
-  C: 0.6,
-  D: 0.4,
-});
-
-/** 代码质量评估 — 合理长度范围 */
-export const CODE_LENGTH = Object.freeze({
-  MIN: 10,
-  MAX: 5000,
-});
-
-// ─── Guard 规则学习 ──────────────────────────────────────
-
-/** RuleLearner 规则健康阈值 */
-export const RULE_LEARNER = Object.freeze({
-  /** 触发高误报规则的条件 */
-  PROBLEMATIC_FALSE_POSITIVE_RATE: 0.3,
-  PROBLEMATIC_MIN_TRIGGERS: 5,
-  /** 规则建议置信度 */
-  CONFIDENCE_TUNE: 0.7,
-  CONFIDENCE_DISABLE: 0.8,
-  CONFIDENCE_SPECIALIZE: 0.6,
-  CONFIDENCE_REVIEW: 0.4,
-  /** 触发数阈值 */
-  HIGH_TRIGGER_COUNT: 50,
-  HIGH_PRECISION: 0.8,
-  /** 闲置天数阈值 */
-  UNUSED_DAYS_THRESHOLD: 30,
-  /** 精度下限 */
-  LOW_PRECISION: 0.5,
-});
-
-// ─── 合规报告 ────────────────────────────────────────────
-
-/** ComplianceReporter 默认 Quality Gate */
-export const QUALITY_GATE = Object.freeze({
-  MAX_ERRORS: 0,
-  MAX_WARNINGS: 20,
-  MIN_SCORE: 70,
-});
-
-/** ComplianceReporter 扣分权重 */
-export const COMPLIANCE_SCORING = Object.freeze({
-  ERROR_PENALTY: 5,
-  WARNING_PENALTY: 1,
-  INFO_PENALTY: 0.2,
-  PROBLEMATIC_RULE_PENALTY: 3,
-  HIGH_F1_BONUS: 5,
-  HIGH_F1_THRESHOLD: 0.8,
-  LOW_PRECISION_THRESHOLD: 0.5,
-  MAX_FILES_DEFAULT: 500,
-});
-
-// ─── 知识置信度 ──────────────────────────────────────────
-
-/** 知识条目默认置信度和阈值 */
-export const KNOWLEDGE_CONFIDENCE = Object.freeze({
-  /** 默认 confidence（Reasoning VO） */
-  DEFAULT: 0.7,
-  /** pending 条目纳入交付的最低 confidence */
-  PENDING_MIN: 0.7,
-  /** rankScore 中 confidence 缺省值 */
-  RANK_DEFAULT: 0.5,
-  /** Bootstrap refine 时的 AI 默认 confidence */
-  BOOTSTRAP_DEFAULT: 0.6,
-  /** 自动提交时的 bootstrap confidence */
-  BOOTSTRAP_SUBMIT: 0.8,
-});
-
-// ─── 搜索管线 ────────────────────────────────────────────
-
-/** SearchEngine 配置 */
-export const SEARCH = Object.freeze({
-  DEFAULT_LIMIT: 10,
-  MAX_RESULTS: 100,
-});
-
-// ─── 文件监听器 ──────────────────────────────────────────
-
-/** FileWatcher 配置 */
-export const FILE_WATCHER = Object.freeze({
-  DEBOUNCE_DELAY_MS: 300,
-  STABILITY_THRESHOLD_MS: 500,
-  POLL_INTERVAL_MS: 100,
-  BINARY_INTERVAL_MS: 300,
-  MAX_FILE_SIZE_BYTES: 1024 * 1024,
-});
-
-// ─── AI Provider ─────────────────────────────────────────
-
-/** AiProvider 熔断配置 */
-export const AI_CIRCUIT_BREAKER = Object.freeze({
-  FAILURE_THRESHOLD: 5,
-});
-
-// ─── 缓存 ────────────────────────────────────────────────
-
-/** ToolResultCache 配置 */
-export const CACHE = Object.freeze({
-  MAX_FILE_ENTRIES: 200,
-  MAX_SEARCH_ENTRIES: 500,
-  /** 缓存条目默认 TTL（毫秒），0 = 不过期 */
-  DEFAULT_TTL_MS: 30 * 60 * 1000, // 30 分钟
-});
-
-// ─── 性能监控 ────────────────────────────────────────────
-
-/** PerformanceMonitor 配置 */
-export const MONITORING = Object.freeze({
-  SLOW_REQUEST_THRESHOLD_MS: 1000,
-  ERROR_ALERT_THRESHOLD: 10,
-});
-
-// ─── Cursor 交付 ─────────────────────────────────────────
-
-/** CursorDeliveryPipeline 排序权重 */
-export const DELIVERY_RANK = Object.freeze({
-  CONFIDENCE_WEIGHT: 50,
-  AUTHORITY_WEIGHT: 30,
-  USE_COUNT_MAX: 10,
-  USE_COUNT_WEIGHT: 2,
-  ACTIVE_BONUS: 10,
-});
-
-export default {
-  QUALITY_WEIGHTS,
-  QUALITY_GRADES,
-  CODE_LENGTH,
-  RULE_LEARNER,
-  QUALITY_GATE,
-  COMPLIANCE_SCORING,
-  KNOWLEDGE_CONFIDENCE,
-  SEARCH,
-  FILE_WATCHER,
-  AI_CIRCUIT_BREAKER,
-  CACHE,
-  MONITORING,
-  DELIVERY_RANK,
-};

package/lib/shared/errors/BaseError.js

@@ -1,94 +0,0 @@
-/**
- * BaseError - 所有错误的基类
- */
-export class BaseError extends Error {
-  constructor(message, code, statusCode = 500) {
-    super(message);
-    this.code = code;
-    this.statusCode = statusCode;
-    this.name = this.constructor.name;
-    Error.captureStackTrace(this, this.constructor);
-  }
-
-  toJSON() {
-    return {
-      name: this.name,
-      code: this.code,
-      message: this.message,
-      statusCode: this.statusCode,
-    };
-  }
-}
-
-/**
- * PermissionDenied - 权限拒绝错误
- */
-export class PermissionDenied extends BaseError {
-  constructor(message) {
-    super(message, 'PERMISSION_DENIED', 403);
-  }
-}
-
-/**
- * ConstitutionViolation - 宪法违反错误
- */
-export class ConstitutionViolation extends BaseError {
-  constructor(violations) {
-    const message = `Constitution violation: ${violations.map((v) => v.rule).join(', ')}`;
-    super(message, 'CONSTITUTION_VIOLATION', 400);
-    this.violations = violations;
-  }
-}
-
-/**
- * ValidationError - 验证错误
- */
-export class ValidationError extends BaseError {
-  constructor(message, details = {}) {
-    super(message, 'VALIDATION_ERROR', 400);
-    this.details = details;
-  }
-}
-
-/**
- * NotFoundError - 资源未找到错误
- */
-export class NotFoundError extends BaseError {
-  constructor(message, resource, resourceId) {
-    // 如果没有提供 message，那么第一个参数就是 resource
-    let finalMessage = message;
-    let finalResource = resource;
-
-    if (!resource) {
-      finalMessage = `Resource not found: ${message}`;
-      finalResource = message;
-    } else if (resourceId) {
-      finalMessage = `${message} (${resource}:${resourceId})`;
-    }
-
-    super(finalMessage, 'NOT_FOUND', 404);
-    this.resource = finalResource;
-    this.resourceId = resourceId;
-  }
-}
-
-/**
- * ConflictError - 资源冲突错误
- */
-export class ConflictError extends BaseError {
-  constructor(message, details) {
-    super(message, 'CONFLICT', 409);
-    this.details = details;
-  }
-}
-
-/**
- * InternalError - 内部错误
- */
-export class InternalError extends BaseError {
-  constructor(message) {
-    super(message, 'INTERNAL_ERROR', 500);
-  }
-}
-
-/* 默认导出已移除 — 使用命名导入: import { ValidationError } from '...' */

package/lib/shared/errors/index.js

@@ -1,14 +0,0 @@
-/**
- * Errors 层索引
- * 导出所有错误类
- */
-
-export {
-  BaseError,
-  ConflictError,
-  ConstitutionViolation,
-  InternalError,
-  NotFoundError,
-  PermissionDenied,
-  ValidationError,
-} from './BaseError.js';