autosnippet 3.2.9 → 3.2.11

package/lib/external/mcp/handlers/bootstrap/pipeline/tier-scheduler.js

@@ -1,217 +0,0 @@
-/**
- * TierScheduler.js — 维度分层并行调度器
- *
- * 内部 Agent 和外部 Agent 共享此调度模型。
- * 按维度间信息依赖关系分 3 层执行:
- * - Tier 1: 基础数据层 (project-profile, 语言条件扫描) — 可并行
- * - Tier 2: 规范+架构+模式 (code-standard, architecture, code-pattern) — 依赖 Tier 1
- * - Tier 3: 流转+实践+总结 (event-and-data-flow, best-practice, agent-guidelines) — 依赖 Tier 2
- *
- * 每层内部可并行 (受 concurrency 限制)，层间串行。
- * 未在任何 Tier 中定义的维度会自动归入 Tier 1（并行执行）。
- *
- * 调用方:
- *   - orchestrator.js (内部 Agent) — fillDimensionsV3() 按 Tier 分层调度 AI pipeline
- *   - MissionBriefingBuilder.js (外部 Agent) — executionPlan 中的 Tier 层序展示
- *
- * @module TierScheduler
- */
-
-import Logger from '../../../../../infrastructure/logging/Logger.js';
-
-const logger = Logger.getInstance();
-
-// ──────────────────────────────────────────────────────────────────
-// 分层定义
-// ──────────────────────────────────────────────────────────────────
-
-const DEFAULT_TIERS = [
-  // Tier 1: 基础数据（通用 + 语言条件维度并行执行）
-  [
-    'project-profile',
-    'objc-deep-scan',
-    'category-scan',
-    'module-export-scan',
-    'framework-convention-scan',
-    'python-package-scan',
-    'jvm-annotation-scan',
-  ],
-  // Tier 2: 规范+架构+模式
-  ['code-standard', 'architecture', 'code-pattern'],
-  // Tier 3: 流转+实践+总结
-  ['event-and-data-flow', 'best-practice', 'agent-guidelines'],
-];
-
-// ──────────────────────────────────────────────────────────────────
-// 简单信号量 (控制并发)
-// ──────────────────────────────────────────────────────────────────
-
-class Semaphore {
-  #permits;
-  #queue = [];
-
-  constructor(permits) {
-    this.#permits = permits;
-  }
-
-  async acquire() {
-    if (this.#permits > 0) {
-      this.#permits--;
-      return;
-    }
-    return new Promise((resolve) => {
-      this.#queue.push(resolve);
-    });
-  }
-
-  release() {
-    if (this.#queue.length > 0) {
-      const resolve = this.#queue.shift();
-      resolve();
-    } else {
-      this.#permits++;
-    }
-  }
-}
-
-// ──────────────────────────────────────────────────────────────────
-// TierScheduler
-// ──────────────────────────────────────────────────────────────────
-
-export class TierScheduler {
-  /** @type {string[][]} */
-  #tiers;
-
-  /**
-   * @param {string[][]} [tiers] — 自定义分层 (默认使用 DEFAULT_TIERS)
-   */
-  constructor(tiers = DEFAULT_TIERS) {
-    this.#tiers = tiers;
-  }
-
-  /**
-   * 分层执行维度
-   *
-   * @param {Function} executeDimension — async (dimId) => DimensionResult
-   * @param {object} [options]
-   * @param {number} [options.concurrency=3] — Tier 内最大并行数
-   * @param {Function} [options.onTierComplete] — (tierIndex, tierResults) => void
-   * @param {Function} [options.shouldAbort] — () => boolean — 外部中止信号
-   * @param {string[]} [options.activeDimIds] — 实际要执行的维度 ID 列表（过滤不在列表中的维度）
-   * @param {Record<string, number>} [options.tierHints] — dimId → 1-based tier index（Enhancement Pack 维度声明的首选 Tier）
-   * @returns {Promise<Map<string, any>>} — dimId → result
-   */
-  async execute(executeDimension, options = {}) {
-    const { concurrency = 3, onTierComplete, shouldAbort, activeDimIds, tierHints } = options;
-    const results = new Map();
-
-    // 如果提供了 activeDimIds，根据它构建实际要执行的 tiers
-    // 未在任何 tier 中定义的维度: 优先使用 tierHints 归入指定 Tier，否则默认归入 Tier 1
-    let effectiveTiers = this.#tiers;
-    if (activeDimIds) {
-      const activeSet = new Set(activeDimIds);
-      const scheduled = new Set(this.#tiers.flat());
-      const unscheduled = activeDimIds.filter((id) => !scheduled.has(id));
-      effectiveTiers = this.#tiers.map((tier) => tier.filter((id) => activeSet.has(id)));
-      if (unscheduled.length > 0) {
-        // 按 tierHint 分配到对应 Tier，无 hint 的默认归入 Tier 1
-        const byTier = new Map(); // 0-based tier index → dimId[]
-        for (const id of unscheduled) {
-          const hint = tierHints?.[id];
-          const tierIdx = (typeof hint === 'number' && hint >= 1 && hint <= effectiveTiers.length)
-            ? hint - 1
-            : 0;
-          if (!byTier.has(tierIdx)) byTier.set(tierIdx, []);
-          byTier.get(tierIdx).push(id);
-        }
-        for (const [tierIdx, ids] of byTier) {
-          effectiveTiers[tierIdx] = [...effectiveTiers[tierIdx], ...ids];
-        }
-        logger.info(
-          `[TierScheduler] Unscheduled dims distributed: ${[...byTier.entries()].map(([t, ids]) => `Tier ${t + 1}=[${ids.join(', ')}]`).join(', ')}`
-        );
-      }
-      // 移除空 tier
-      effectiveTiers = effectiveTiers.filter((t) => t.length > 0);
-    }
-
-    for (let tierIndex = 0; tierIndex < effectiveTiers.length; tierIndex++) {
-      const tier = effectiveTiers[tierIndex];
-
-      if (shouldAbort?.()) {
-        logger.warn(`[TierScheduler] Aborted before Tier ${tierIndex + 1}`);
-        break;
-      }
-
-      logger.info(
-        `[TierScheduler] ── Tier ${tierIndex + 1}/${this.#tiers.length}: [${tier.join(', ')}] (concurrency=${concurrency})`
-      );
-
-      const tierResults = await this.#executeTier(tier, executeDimension, concurrency, shouldAbort);
-
-      for (const [dimId, result] of tierResults) {
-        results.set(dimId, result);
-      }
-
-      onTierComplete?.(tierIndex, tierResults);
-    }
-
-    return results;
-  }
-
-  /**
-   * 执行单个 Tier 内的所有维度 (并发控制)
-   */
-  async #executeTier(dimensionIds, executeDimension, concurrency, shouldAbort) {
-    const semaphore = new Semaphore(concurrency);
-    const results = new Map();
-
-    await Promise.all(
-      dimensionIds.map(async (dimId) => {
-        if (shouldAbort?.()) {
-          return;
-        }
-
-        await semaphore.acquire();
-        try {
-          if (shouldAbort?.()) {
-            return;
-          }
-          const result = await executeDimension(dimId);
-          results.set(dimId, result);
-        } catch (err) {
-          logger.error(`[TierScheduler] Dimension "${dimId}" failed: ${err.message}`);
-          results.set(dimId, { error: err.message, candidateCount: 0 });
-        } finally {
-          semaphore.release();
-        }
-      })
-    );
-
-    return results;
-  }
-
-  /**
-   * 获取维度所在的 Tier 索引
-   * @param {string} dimId
-   * @returns {number} — 0-based tier index, -1 if not found
-   */
-  getTierIndex(dimId) {
-    for (let i = 0; i < this.#tiers.length; i++) {
-      if (this.#tiers[i].includes(dimId)) {
-        return i;
-      }
-    }
-    return -1;
-  }
-
-  /**
-   * 获取分层定义
-   * @returns {string[][]}
-   */
-  getTiers() {
-    return this.#tiers;
-  }
-}
-
-export default TierScheduler;

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

@@ -1,365 +0,0 @@
-/**
- * bootstrapRefine — Phase 6 AI 润色
- *
- * 对 Bootstrap Phase 5 产出的知识条目进行 AI 二次精炼：
- * - 改善模板化描述 → 更自然精准
- * - 补充高阶架构洞察
- * - 推断并填充 relations 关联
- * - 调整 confidence 评分
- *
- * 从 bootstrap.js 提取为独立模块
- */
-
-import { envelope } from '../../envelope.js';
-
-/**
- * @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 为 Array<{target: string, description: string}>。示例: {"related": [{"target": "某 Recipe 标题", "description": "关联原因"}]}。
-4. relations 只能指向已发布的 Recipe，不能在候选之间建立关联。如果没有已发布的 Recipe，relations 应保持为空 {}。
-5. relations 必须精准：只在候选与某个 Recipe 有明确的技术依赖、继承、调用或扩展关系时才添加。仅仅因为属于同一项目或使用相同框架不构成关联。如果没有强关联，related 应为空数组。
-6. 每个 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 },
-  });
-}