autosnippet 3.0.11 → 3.0.13

package/lib/external/mcp/handlers/bootstrap.js

@@ -59,9 +59,12 @@ import {
 } from './bootstrap/skills.js';
 import { buildLanguageExtension, detectPrimaryLanguage, inferLang } from './LanguageExtensions.js';
 import { inferFilePriority, inferTargetRole } from './TargetClassifier.js';
+import { baseDimensions, resolveActiveDimensions } from './bootstrap/base-dimensions.js';
+import { bootstrapRefine } from './bootstrap/refine.js';
 
 // Re-export for external consumers
 export { loadBootstrapSkills };
+export { bootstrapRefine };
 
 /**
  * bootstrapKnowledge — 一键初始化知识库 (Skill-aware)
@@ -501,220 +504,13 @@ export async function bootstrapKnowledge(ctx, args) {
   };
 
   // 9 维度定义（Phase 4 响应 + Phase 5 候选创建共用）
-  // skillWorthy 维度会在 Phase 5.5 自动生成 Project Skill（宏观叙事性知识）
-  // 注意：anti-pattern 已移除 — 代码问题由 Guard 独立处理，bootstrap 不做错误检测
-  //
-  // 执行顺序优化（v5.1）：
-  //   ⑧ ⑨ 提前到 ⑥ 前面执行 → deep-scan / category-scan 的中间结果
-  //   通过 PipelineContext 缓存，供 project-profile 复用，避免重复扫描
-  const baseDimensions = [
-    // ── 通用维度（所有语言共享）──────────────────────────────────
-
-    // ① 代码规范（Dual: Skill + Candidate）
-    {
-      id: 'code-standard',
-      label: '代码规范',
-      guide:
-        '命名约定（类名前缀/方法签名风格/API 命名）、注释风格（语言/格式/MARK 分段）、文件组织规范',
-      knowledgeTypes: ['code-standard', 'code-style'],
-      skillWorthy: true,
-      dualOutput: true,
-      skillMeta: {
-        name: 'project-code-standard',
-        description:
-          'Project coding standards and naming conventions (auto-generated by bootstrap)',
-      },
-    },
-    // ② 代码模式（Candidate）
-    {
-      id: 'code-pattern',
-      label: '设计模式与代码惯例',
-      guide: '单例/委托/Category·Extension/工厂/Builder/观察者/Coordinator 模式、继承关系',
-      knowledgeTypes: ['code-pattern', 'code-relation', 'inheritance'],
-    },
-    // ③ 架构模式（Dual: Skill + Candidate）
-    {
-      id: 'architecture',
-      label: '架构模式',
-      guide: '分层架构、模块职责与边界、依赖图、导入约束规则',
-      knowledgeTypes: ['architecture', 'module-dependency', 'boundary-constraint'],
-      skillWorthy: true,
-      dualOutput: true,
-      skillMeta: {
-        name: 'project-architecture',
-        description:
-          'Project architecture layers, module boundaries and dependency graph (auto-generated by bootstrap)',
-      },
-    },
-    // ④ 最佳实践（Candidate）
-    {
-      id: 'best-practice',
-      label: '最佳实践',
-      guide: '错误处理、并发安全、内存管理、日志规范、测试模式',
-      knowledgeTypes: ['best-practice'],
-    },
-    // ⑤ 事件与数据流（Candidate）
-    {
-      id: 'event-and-data-flow',
-      label: '事件与数据流',
-      guide:
-        '事件传播（Delegate/Notification/Block·Closure/Target-Action）、数据状态管理（KVO/属性观察/响应式/持久化）',
-      knowledgeTypes: ['call-chain', 'data-flow'],
-    },
-    // ⑥ 项目特征（Dual: Skill + Candidate）
-    {
-      id: 'project-profile',
-      label: '项目特征',
-      guide:
-        '技术栈、目录结构、三方依赖枚举与用途、Extension/Category 分类聚合、自定义基类层级与全局定义（宏/typealias/PCH）、系统事件 hook 与生命周期入口、基础设施服务注册表、Runtime 与语言互操作',
-      knowledgeTypes: ['architecture'],
-      skillWorthy: true,
-      dualOutput: true,
-      skillMeta: {
-        name: 'project-profile',
-        description:
-          'Project tech stack, module structure, third-party dependencies, base extensions/classes, event hooks, infrastructure services, and runtime/interop features (auto-generated by bootstrap)',
-      },
-    },
-    // ⑦ Agent 开发注意事项（Skill）
-    {
-      id: 'agent-guidelines',
-      label: 'Agent开发注意事项',
-      guide:
-        '三大核心原则（严谨性/深度特征挖掘/完整性）、命名强制、线程安全、内存约束、已废弃 API 标记、架构约束注释、TODO/FIXME',
-      knowledgeTypes: ['boundary-constraint', 'code-standard'],
-      skillWorthy: true,
-      skillMeta: {
-        name: 'project-agent-guidelines',
-        description:
-          'Mandatory coding rules, deprecated APIs and agent constraints for this project (auto-generated by bootstrap)',
-      },
-    },
-
-    // ── 语言条件维度（按 conditions 过滤）──────────────────────
-
-    // ⑧ ObjC/Swift 深度扫描
-    {
-      id: 'objc-deep-scan',
-      label: '深度扫描（常量/Hook）',
-      guide:
-        '全量扫描 #define 值宏/函数宏、extern/static 常量、Method Swizzling hook 对（Agent 必须使用项目常量，修改被 hook 方法前必须查阅 hook 清单）',
-      knowledgeTypes: ['code-standard', 'code-pattern'],
-      conditions: { languages: ['objectivec', 'swift'] },
-      skillWorthy: true,
-      dualOutput: true,
-      skillMeta: {
-        name: 'project-objc-deep-scan',
-        description:
-          'Project #define macros, static constants, and Method Swizzling hooks (auto-generated by bootstrap)',
-      },
-    },
-    // ⑨ Foundation/UIKit Category/Extension 专项扫描
-    {
-      id: 'category-scan',
-      label: '基础类分类方法扫描',
-      guide:
-        'Foundation/UIKit Category/Extension 逐方法清单（含完整实现代码与项目使用频次），仅扫描基础类分类、不含业务代码（Agent 遇到同等功能必须使用项目已有分类方法，禁止重复实现）',
-      knowledgeTypes: ['code-standard', 'code-pattern'],
-      conditions: { languages: ['objectivec', 'swift'] },
-      skillWorthy: true,
-      dualOutput: true,
-      skillMeta: {
-        name: 'project-category-scan',
-        description:
-          'Foundation/UIKit Category and Extension methods with implementations and usage patterns — base classes only, no business code (auto-generated by bootstrap)',
-      },
-    },
-
-    // ⑩ TS/JS 模块导出分析
-    {
-      id: 'module-export-scan',
-      label: '模块导出分析',
-      guide: 'barrel export 结构、re-export 链路、public API surface、tree-shaking 合规性',
-      knowledgeTypes: ['code-standard', 'architecture'],
-      conditions: { languages: ['typescript', 'javascript'] },
-      skillWorthy: true,
-      dualOutput: true,
-      skillMeta: {
-        name: 'project-module-exports',
-        description: 'Module export structure and public API surface (auto-generated by bootstrap)',
-      },
-    },
-    // ⑪ TS/JS 框架约定扫描
-    {
-      id: 'framework-convention-scan',
-      label: '框架约定扫描',
-      guide: '组件目录结构、状态管理约定、路由约定、样式约定、数据获取模式',
-      knowledgeTypes: ['code-standard', 'architecture'],
-      conditions: {
-        languages: ['typescript', 'javascript'],
-        frameworks: ['react', 'vue', 'angular', 'nextjs', 'nuxt'],
-      },
-      skillWorthy: true,
-      dualOutput: true,
-      skillMeta: {
-        name: 'project-framework-conventions',
-        description: 'Framework-specific conventions and patterns (auto-generated by bootstrap)',
-      },
-    },
-
-    // ⑫ Python 包结构分析
-    {
-      id: 'python-package-scan',
-      label: 'Python 包结构分析',
-      guide:
-        '__init__.py 导出策略、相对/绝对导入风格、type hints 覆盖率、decorator 使用模式、__all__ 定义',
-      knowledgeTypes: ['code-standard', 'architecture'],
-      conditions: { languages: ['python'] },
-      skillWorthy: true,
-      dualOutput: true,
-      skillMeta: {
-        name: 'project-python-structure',
-        description:
-          'Python package structure, import patterns and type hint coverage (auto-generated by bootstrap)',
-      },
-    },
-
-    // ⑬ Java/Kotlin 注解扫描
-    {
-      id: 'jvm-annotation-scan',
-      label: '注解/Annotation 扫描',
-      guide:
-        'DI 注解（@Inject/@Autowired/@Component）、ORM 注解（@Entity/@Table）、API 注解（@RestController/@RequestMapping）、自定义注解、元编程模式',
-      knowledgeTypes: ['code-pattern', 'architecture'],
-      conditions: { languages: ['java', 'kotlin'] },
-      skillWorthy: true,
-      dualOutput: true,
-      skillMeta: {
-        name: 'project-jvm-annotations',
-        description:
-          'Annotation/DI usage patterns and meta-programming (auto-generated by bootstrap)',
-      },
-    },
-
-    // ⑭ Go 模块结构分析
-    {
-      id: 'go-module-scan',
-      label: 'Go 模块结构分析',
-      guide:
-        'go.mod 依赖图、internal 包隔离边界、cmd/ 入口点枚举、build tags/constraints、interface 分布与实现关系、init() 函数清单',
-      knowledgeTypes: ['architecture', 'code-pattern'],
-      conditions: { languages: ['go'] },
-      skillWorthy: true,
-      dualOutput: true,
-      skillMeta: {
-        name: 'project-go-module-structure',
-        description:
-          'Go module structure, internal packages, build tags and interface distribution (auto-generated by bootstrap)',
-      },
-    },
-  ];
+  // → 从 bootstrap/base-dimensions.js 导入
 
   // ── 根据项目主语言和框架过滤条件维度 ──────────────────────
   const detectedFrameworks = allTargets
     .map((t) => (typeof t === 'object' ? t.framework : null))
     .filter(Boolean);
-  const activeDimensions = _resolveActiveDimensions(
+  const activeDimensions = resolveActiveDimensions(
     baseDimensions,
     primaryLang,
     detectedFrameworks
@@ -1041,384 +837,4 @@ export async function bootstrapKnowledge(ctx, args) {
   });
 }
 
-/**
- * bootstrapRefine — Phase 6 AI 润色
- *
- * 对 Bootstrap Phase 5 产出的知识条目进行 AI 二次精炼：
- * - 改善模板化描述 → 更自然精准
- * - 补充高阶架构洞察
- * - 推断并填充 relations 关联
- * - 调整 confidence 评分
- *
- * @param {object} ctx  MCP context { container, logger }
- * @param {object} args { candidateIds?: string[], userPrompt?: string, dryRun?: boolean }
- */
-export async function bootstrapRefine(ctx, args) {
-  const t0 = Date.now();
-  const knowledgeService = ctx.container.get('knowledgeService');
-  const aiProvider = ctx.container.get('aiProvider');
-
-  if (!aiProvider) {
-    return envelope({
-      success: false,
-      message: 'AI provider not configured',
-      errorCode: 'MISSING_AI_PROVIDER',
-    });
-  }
-
-  // 接入 BootstrapTaskManager 双通道推送 refine:* 事件
-  let onProgress = null;
-  try {
-    const taskManager = ctx.container.get('bootstrapTaskManager');
-    onProgress = (eventName, data) => taskManager.emitProgress(eventName, data);
-  } catch {
-    /* optional */
-  }
-
-  // 1. 收集待润色条目
-  let entries;
-  if (args.candidateIds?.length) {
-    entries = [];
-    for (const id of args.candidateIds) {
-      const e = await knowledgeService.get(id);
-      if (e) {
-        entries.push(typeof e.toJSON === 'function' ? e.toJSON() : e);
-      }
-    }
-  } else {
-    const result = await knowledgeService.list(
-      { lifecycle: 'pending', source: 'bootstrap' },
-      { page: 1, pageSize: 200 }
-    );
-    entries = (result.items || []).map((e) => (typeof e.toJSON === 'function' ? e.toJSON() : e));
-  }
-
-  if (entries.length === 0) {
-    return envelope({
-      success: true,
-      data: { refined: 0, total: 0, errors: [], results: [] },
-      meta: { tool: 'autosnippet_bootstrap', responseTimeMs: Date.now() - t0 },
-    });
-  }
-
-  onProgress?.('refine:started', { total: entries.length, candidateIds: entries.map((e) => e.id) });
-
-  // 2. 收集已发布 Recipe 标题（关联关系只能指向已发布 Recipe，不能在候选之间互关联）
-  let publishedTitles = [];
-  try {
-    const published = await knowledgeService.list(
-      { lifecycle: 'active' },
-      { page: 1, pageSize: 200 }
-    );
-    publishedTitles = (published.items || []).map((e) => e.title).filter(Boolean);
-  } catch { /* ignore */ }
-
-  // 3. 逐条 AI 润色
-  const results = [];
-  const errors = [];
-  let refined = 0;
-  let processed = 0;
-
-  for (const entry of entries) {
-    processed++;
-    onProgress?.('refine:item-started', {
-      candidateId: entry.id,
-      title: entry.title,
-      current: processed,
-      total: entries.length,
-      progress: Math.round(((processed - 1) / entries.length) * 100),
-    });
-
-    try {
-      const before = {
-        title: entry.title || '',
-        description: entry.description || '',
-        pattern: entry.content?.pattern || '',
-        markdown: entry.content?.markdown || '',
-        rationale: entry.content?.rationale || '',
-        tags: entry.tags || [],
-        confidence: entry.reasoning?.confidence ?? 0.6,
-        relations: entry.relations || {},
-        aiInsight: entry.aiInsight || null,
-        agentNotes: entry.agentNotes || null,
-      };
-
-      const refineInstruction = args.userPrompt
-        ? args.userPrompt
-        : '请改善描述使其更专业简洁，补充高阶架构洞察';
-
-      const prompt = `你是一位高级代码知识管理专家。请改进以下知识条目。
-
-## ⭐ JSON key 规范（最高优先级）
-
-返回的 JSON 必须且只能使用以下 9 个 key，大小写必须完全一致：
-
-  description  → 摘要（string）
-  pattern      → 代码/标准用法（string）
-  markdown     → Markdown 文档（string）
-  rationale    → 设计原理（string）
-  tags         → 标签（string[]）
-  confidence   → 置信度（number 0.0–1.0）
-  aiInsight    → AI 洞察（string | null）
-  agentNotes   → Agent 笔记（string[] | null）
-  relations    → 关联关系（object）
-
-## 当前条目信息
-
-标题: ${before.title}
-类型: ${entry.knowledgeType || '未知'}
-语言: ${entry.language || '未知'}
-
-【description】摘要
-${before.description || '（空）'}
-
-【pattern】代码/标准用法
-${(before.pattern || '（空）').substring(0, 2000)}
-
-【markdown】Markdown 文档
-${(before.markdown || '（空）').substring(0, 2000)}
-
-【rationale】设计原理
-${before.rationale || '（空）'}
-
-【tags】标签
-${JSON.stringify(before.tags)}
-
-【confidence】置信度
-${before.confidence}
-
-【relations】关联关系
-${JSON.stringify(before.relations)}
-
-【aiInsight】AI 洞察
-${before.aiInsight || '（空）'}
-
-【agentNotes】Agent 笔记
-${JSON.stringify(before.agentNotes || [])}
-
-${publishedTitles.length > 0 ? `已发布的 Recipe: ${publishedTitles.slice(0, 20).join(', ')}` : '（尚无已发布的 Recipe）'}
-
-## 润色指令
-
-${refineInstruction}
-
-## 约束
-
-1. 只修改需要改进的字段，未涉及的必须原样返回。
-2. tags 采用合并策略（保留原有 + 补充新建议），不要删除已有标签。
-3. relations 为 object 格式，key 为关系类型（如 inherits/implements/calls/depends_on/extends/related），value 为 string[]。
-4. relations 只能指向已发布的 Recipe，不能在候选之间建立关联。如果没有已发布的 Recipe，relations 应保持为空 {}。
-5. 每个 key 都必须存在，key 名称必须与上述完全一致。
-
-仅返回 JSON，不要添加任何其他文字或代码块标记。`;
-
-      const parsed = await aiProvider.chatWithStructuredOutput(prompt, { temperature: 0.3 });
-
-      if (!parsed) {
-        errors.push({ id: entry.id, title: entry.title, error: 'AI returned no valid JSON' });
-        onProgress?.('refine:item-failed', {
-          candidateId: entry.id,
-          title: entry.title,
-          error: 'No valid JSON',
-          current: processed,
-          total: entries.length,
-          progress: Math.round((processed / entries.length) * 100),
-        });
-        continue;
-      }
-
-      if (args.dryRun) {
-        results.push({ id: entry.id, title: entry.title, preview: parsed });
-        onProgress?.('refine:item-completed', {
-          candidateId: entry.id,
-          title: entry.title,
-          refined: false,
-          current: processed,
-          total: entries.length,
-          progress: Math.round((processed / entries.length) * 100),
-        });
-        continue;
-      }
-
-      // ─── key 别名归一化（与 candidates.js 保持一致） ───
-      const KEY_ALIASES = {
-        summary: 'description',
-        desc: 'description',
-        content: 'pattern',
-        design: 'rationale',
-        designRationale: 'rationale',
-        markdownDoc: 'markdown',
-        doc: 'markdown',
-        tag: 'tags',
-        label: 'tags',
-        labels: 'tags',
-        score: 'confidence',
-        ai_insight: 'aiInsight',
-        insight: 'aiInsight',
-        aiinsight: 'aiInsight',
-        agent_notes: 'agentNotes',
-        notes: 'agentNotes',
-        agentnotes: 'agentNotes',
-        relation: 'relations',
-      };
-      const VALID_KEYS = new Set([
-        'description',
-        'pattern',
-        'markdown',
-        'rationale',
-        'tags',
-        'confidence',
-        'aiInsight',
-        'agentNotes',
-        'relations',
-      ]);
-      const normalized = {};
-      for (const [key, value] of Object.entries(parsed)) {
-        if (VALID_KEYS.has(key)) {
-          normalized[key] = value;
-        } else {
-          const mapped = KEY_ALIASES[key] || KEY_ALIASES[key.toLowerCase?.()];
-          if (mapped && !(mapped in normalized)) {
-            normalized[mapped] = value;
-          }
-        }
-      }
-      for (const k of VALID_KEYS) {
-        if (!(k in normalized)) {
-          normalized[k] = before[k];
-        }
-      }
-
-      // 构建更新数据
-      const updateData = {};
-      let changed = false;
-
-      if (normalized.description != null && normalized.description !== before.description) {
-        updateData.description = normalized.description;
-        changed = true;
-      }
-      // tags 采用合并策略
-      if (normalized.tags != null && Array.isArray(normalized.tags)) {
-        const merged = [...new Set([...(before.tags || []), ...normalized.tags])];
-        if (JSON.stringify(merged) !== JSON.stringify(before.tags)) {
-          updateData.tags = merged;
-          changed = true;
-        }
-      }
-      if (
-        typeof normalized.confidence === 'number' &&
-        normalized.confidence !== before.confidence
-      ) {
-        updateData.reasoning = { ...(entry.reasoning || {}), confidence: normalized.confidence };
-        changed = true;
-      }
-      if (normalized.aiInsight != null && normalized.aiInsight !== before.aiInsight) {
-        updateData.aiInsight = normalized.aiInsight;
-        changed = true;
-      }
-      if (normalized.agentNotes !== undefined) {
-        const newNotes = JSON.stringify(normalized.agentNotes);
-        if (newNotes !== JSON.stringify(before.agentNotes)) {
-          updateData.agentNotes = normalized.agentNotes;
-          changed = true;
-        }
-      }
-      if (normalized.relations !== undefined) {
-        const newRels = JSON.stringify(normalized.relations);
-        if (newRels !== JSON.stringify(before.relations)) {
-          updateData.relations = normalized.relations;
-          changed = true;
-        }
-      }
-      // content 嵌套写入
-      const contentPatch = { ...(entry.content || {}) };
-      let contentChanged = false;
-      if (normalized.pattern != null && normalized.pattern !== before.pattern) {
-        contentPatch.pattern = normalized.pattern;
-        contentChanged = true;
-      }
-      if (normalized.markdown != null && normalized.markdown !== before.markdown) {
-        contentPatch.markdown = normalized.markdown;
-        contentChanged = true;
-      }
-      if (normalized.rationale != null && normalized.rationale !== before.rationale) {
-        contentPatch.rationale = normalized.rationale;
-        contentChanged = true;
-      }
-      if (contentChanged) {
-        updateData.content = contentPatch;
-        changed = true;
-      }
-
-      if (changed) {
-        await knowledgeService.update(entry.id, updateData);
-        refined++;
-      }
-
-      results.push({
-        id: entry.id,
-        title: entry.title,
-        refined: changed,
-        fields: Object.keys(parsed),
-      });
-      onProgress?.('refine:item-completed', {
-        candidateId: entry.id,
-        title: entry.title,
-        refined: changed,
-        current: processed,
-        total: entries.length,
-        progress: Math.round((processed / entries.length) * 100),
-        refinedSoFar: refined,
-      });
-    } catch (err) {
-      errors.push({ id: entry.id, title: entry.title, error: err.message });
-      onProgress?.('refine:item-failed', {
-        candidateId: entry.id,
-        title: entry.title,
-        error: err.message,
-        current: processed,
-        total: entries.length,
-        progress: Math.round((processed / entries.length) * 100),
-      });
-    }
-  }
-
-  onProgress?.('refine:completed', { total: entries.length, refined, failed: errors.length });
-
-  return envelope({
-    success: true,
-    data: {
-      refined,
-      total: entries.length,
-      errors,
-      results,
-      message: `Phase 6 AI 润色完成: ${refined}/${entries.length} 条知识条目已更新${args.dryRun ? '（预览模式）' : ''}`,
-    },
-    meta: { tool: 'autosnippet_bootstrap', responseTimeMs: Date.now() - t0 },
-  });
-}
-
-// ══════════════════════════════════════════════════════════════════
-// 内部辅助 — 维度条件化
-// ══════════════════════════════════════════════════════════════════
-
-/**
- * 根据项目主语言和检测到的框架过滤条件维度
- * @param {Array} allDimensions  所有维度定义（含 conditions 字段）
- * @param {string} primaryLang   主语言
- * @param {string[]} detectedFrameworks 检测到的框架
- * @returns {Array} 适用的维度列表
- */
-function _resolveActiveDimensions(allDimensions, primaryLang, detectedFrameworks = []) {
-  return allDimensions.filter((dim) => {
-    if (!dim.conditions) {
-      return true; // 无条件 → 通用维度
-    }
-    const langMatch = !dim.conditions.languages || dim.conditions.languages.includes(primaryLang);
-    const fwMatch =
-      !dim.conditions.frameworks ||
-      dim.conditions.frameworks.some((f) => detectedFrameworks.includes(f));
-    // languages 必须匹配；frameworks 为可选增强（有 frameworks 条件时必须至少命中一个）
-    return langMatch && (dim.conditions.frameworks ? fwMatch : true);
-  });
-}
+// bootstrapRefine → 已提取到 bootstrap/refine.js（通过顶部 re-export）