autosnippet 3.0.0 → 3.0.2

package/lib/service/bootstrap/BootstrapTaskManager.js

@@ -22,10 +22,10 @@ import Logger from '../../infrastructure/logging/Logger.js';
 
 /** 任务状态枚举 */
 export const TaskStatus = Object.freeze({
-  SKELETON: 'skeleton',     // 骨架已创建，等待填充
-  FILLING:  'filling',      // 内容正在填充中
-  COMPLETED: 'completed',   // 填充完成
-  FAILED:   'failed',       // 填充失败
+  SKELETON: 'skeleton', // 骨架已创建，等待填充
+  FILLING: 'filling', // 内容正在填充中
+  COMPLETED: 'completed', // 填充完成
+  FAILED: 'failed', // 填充失败
 });
 
 /**
@@ -36,19 +36,19 @@ class BootstrapSession {
     this.id = sessionId;
     this.startedAt = Date.now();
     this.completedAt = null;
-    this.status = 'running';      // running | completed | failed
-    this.tasks = new Map();       // taskId → TaskInfo
-    this.summary = null;          // 完成后的摘要
+    this.status = 'running'; // running | completed | failed
+    this.tasks = new Map(); // taskId → TaskInfo
+    this.summary = null; // 完成后的摘要
   }
 
   addTask(taskId, meta) {
     this.tasks.set(taskId, {
       id: taskId,
       status: TaskStatus.SKELETON,
-      meta,                       // { type: 'dimension'|'skill', dimId, label, skillWorthy }
+      meta, // { type: 'dimension'|'skill', dimId, label, skillWorthy }
       startedAt: null,
       completedAt: null,
-      result: null,               // 填充结果摘要
+      result: null, // 填充结果摘要
       error: null,
     });
   }
@@ -57,11 +57,21 @@ class BootstrapSession {
     return this.tasks.get(taskId);
   }
 
-  get totalTasks() { return this.tasks.size; }
-  get completedTasks() { return [...this.tasks.values()].filter(t => t.status === TaskStatus.COMPLETED).length; }
-  get failedTasks() { return [...this.tasks.values()].filter(t => t.status === TaskStatus.FAILED).length; }
-  get fillingTasks() { return [...this.tasks.values()].filter(t => t.status === TaskStatus.FILLING).length; }
-  get skeletonTasks() { return [...this.tasks.values()].filter(t => t.status === TaskStatus.SKELETON).length; }
+  get totalTasks() {
+    return this.tasks.size;
+  }
+  get completedTasks() {
+    return [...this.tasks.values()].filter((t) => t.status === TaskStatus.COMPLETED).length;
+  }
+  get failedTasks() {
+    return [...this.tasks.values()].filter((t) => t.status === TaskStatus.FAILED).length;
+  }
+  get fillingTasks() {
+    return [...this.tasks.values()].filter((t) => t.status === TaskStatus.FILLING).length;
+  }
+  get skeletonTasks() {
+    return [...this.tasks.values()].filter((t) => t.status === TaskStatus.SKELETON).length;
+  }
 
   get isAllDone() {
     return this.skeletonTasks === 0 && this.fillingTasks === 0;
@@ -70,14 +80,18 @@ class BootstrapSession {
   get totalToolCalls() {
     let count = 0;
     for (const t of this.tasks.values()) {
-      if (t.result?.toolCallCount) count += t.result.toolCallCount;
+      if (t.result?.toolCallCount) {
+        count += t.result.toolCallCount;
+      }
     }
     return count;
   }
 
   get progress() {
     const total = this.totalTasks;
-    if (total === 0) return 100;
+    if (total === 0) {
+      return 100;
+    }
     return Math.round(((this.completedTasks + this.failedTasks) / total) * 100);
   }
 
@@ -94,7 +108,7 @@ class BootstrapSession {
       filling: this.fillingTasks,
       skeleton: this.skeletonTasks,
       totalToolCalls: this.totalToolCalls,
-      tasks: [...this.tasks.values()].map(t => ({
+      tasks: [...this.tasks.values()].map((t) => ({
         id: t.id,
         status: t.status,
         meta: t.meta,
@@ -138,7 +152,9 @@ export class BootstrapTaskManager {
   startSession(taskDefs) {
     // ── 并发锁：如果上一个 session 还在运行，先中止 ──
     if (this.isRunning) {
-      Logger.warn(`[Bootstrap] Previous session ${this.#currentSession.id} still running — aborting before starting new session`);
+      Logger.warn(
+        `[Bootstrap] Previous session ${this.#currentSession.id} still running — aborting before starting new session`
+      );
       this.abortSession('Superseded by new bootstrap request');
     }
 
@@ -152,7 +168,7 @@ export class BootstrapTaskManager {
     Logger.info(`[Bootstrap] Session ${sessionId} started with ${taskDefs.length} tasks`);
     this.#emit('bootstrap:started', {
       sessionId,
-      tasks: taskDefs.map(t => ({ id: t.id, ...t.meta })),
+      tasks: taskDefs.map((t) => ({ id: t.id, ...t.meta })),
       total: taskDefs.length,
       startedAt: this.#currentSession.startedAt,
     });
@@ -170,7 +186,9 @@ export class BootstrapTaskManager {
    */
   abortSession(reason = 'Aborted by user') {
     const session = this.#currentSession;
-    if (!session || session.status !== 'running') return;
+    if (!session || session.status !== 'running') {
+      return;
+    }
 
     // 将未完成的任务全部标记 FAILED
     for (const task of session.tasks.values()) {
@@ -196,8 +214,12 @@ export class BootstrapTaskManager {
     this.#emit('bootstrap:all-completed', {
       sessionId: session.id,
       summary: session.summary,
-      tasks: [...session.tasks.values()].map(t => ({
-        id: t.id, status: t.status, meta: t.meta, result: t.result, error: t.error,
+      tasks: [...session.tasks.values()].map((t) => ({
+        id: t.id,
+        status: t.status,
+        meta: t.meta,
+        result: t.result,
+        error: t.error,
       })),
     });
   }
@@ -214,10 +236,12 @@ export class BootstrapTaskManager {
   isSessionValid(sessionId) {
     // Session 在 running 或 completed 状态都有效 — completed 表示维度填充完成，
     // 但 Phase 5.5 Skills 生成仍需运行。只有被新 session 替代时才无效。
-    return this.#currentSession?.id === sessionId &&
+    return (
+      this.#currentSession?.id === sessionId &&
       (this.#currentSession?.status === 'running' ||
-       this.#currentSession?.status === 'completed' ||
-       this.#currentSession?.status === 'completed_with_errors');
+        this.#currentSession?.status === 'completed' ||
+        this.#currentSession?.status === 'completed_with_errors')
+    );
   }
 
   /**
@@ -225,9 +249,13 @@ export class BootstrapTaskManager {
    */
   markTaskFilling(taskId) {
     const session = this.#currentSession;
-    if (!session) return;
+    if (!session) {
+      return;
+    }
     const task = session.getTask(taskId);
-    if (!task) return;
+    if (!task) {
+      return;
+    }
 
     task.status = TaskStatus.FILLING;
     task.startedAt = Date.now();
@@ -248,15 +276,21 @@ export class BootstrapTaskManager {
    */
   markTaskCompleted(taskId, result = {}) {
     const session = this.#currentSession;
-    if (!session) return;
+    if (!session) {
+      return;
+    }
     const task = session.getTask(taskId);
-    if (!task) return;
+    if (!task) {
+      return;
+    }
 
     task.status = TaskStatus.COMPLETED;
     task.completedAt = Date.now();
     task.result = result;
 
-    Logger.info(`[Bootstrap] Task "${taskId}" completed (${session.completedTasks}/${session.totalTasks})`);
+    Logger.info(
+      `[Bootstrap] Task "${taskId}" completed (${session.completedTasks}/${session.totalTasks})`
+    );
     this.#emit('bootstrap:task-completed', {
       sessionId: session.id,
       taskId,
@@ -280,9 +314,13 @@ export class BootstrapTaskManager {
    */
   markTaskFailed(taskId, error) {
     const session = this.#currentSession;
-    if (!session) return;
+    if (!session) {
+      return;
+    }
     const task = session.getTask(taskId);
-    if (!task) return;
+    if (!task) {
+      return;
+    }
 
     task.status = TaskStatus.FAILED;
     task.completedAt = Date.now();
@@ -347,7 +385,9 @@ export class BootstrapTaskManager {
 
   #finishSession() {
     const session = this.#currentSession;
-    if (!session) return;
+    if (!session) {
+      return;
+    }
 
     session.status = session.failedTasks > 0 ? 'completed_with_errors' : 'completed';
     session.completedAt = Date.now();
@@ -359,12 +399,14 @@ export class BootstrapTaskManager {
     };
 
     const durationSec = ((session.completedAt - session.startedAt) / 1000).toFixed(1);
-    Logger.info(`[Bootstrap] Session ${session.id} finished: ${session.completedTasks} completed, ${session.failedTasks} failed (${durationSec}s)`);
+    Logger.info(
+      `[Bootstrap] Session ${session.id} finished: ${session.completedTasks} completed, ${session.failedTasks} failed (${durationSec}s)`
+    );
 
     this.#emit('bootstrap:all-completed', {
       sessionId: session.id,
       summary: session.summary,
-      tasks: [...session.tasks.values()].map(t => ({
+      tasks: [...session.tasks.values()].map((t) => ({
         id: t.id,
         status: t.status,
         meta: t.meta,

package/lib/service/candidate/SimilarityService.js

@@ -1,7 +1,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { getProjectRecipesPath } from '../../infrastructure/config/Paths.js';
-import { tokenizeForSimilarity, jaccardSimilarity } from '../../shared/similarity.js';
+import { jaccardSimilarity, tokenizeForSimilarity } from '../../shared/similarity.js';
 
 /**
  * SimilarityService — 轻量级 Recipe 相似度检测
@@ -12,12 +12,18 @@ import { tokenizeForSimilarity, jaccardSimilarity } from '../../shared/similarit
  * 计算候选与单个 Recipe 的综合相似度
  */
 function computeSimilarity(candidate, recipe) {
-  const titleSim = jaccardSimilarity(tokenizeForSimilarity(candidate.title), tokenizeForSimilarity(recipe.title));
+  const titleSim = jaccardSimilarity(
+    tokenizeForSimilarity(candidate.title),
+    tokenizeForSimilarity(recipe.title)
+  );
   const summarySim = jaccardSimilarity(
     tokenizeForSimilarity(candidate.summary || candidate.description),
-    tokenizeForSimilarity(recipe.summary || recipe.description),
+    tokenizeForSimilarity(recipe.summary || recipe.description)
+  );
+  const codeSim = jaccardSimilarity(
+    tokenizeForSimilarity(candidate.code, 3),
+    tokenizeForSimilarity(recipe.code, 3)
   );
-  const codeSim = jaccardSimilarity(tokenizeForSimilarity(candidate.code, 3), tokenizeForSimilarity(recipe.code, 3));
   // 加权: title 30%, summary 30%, code 40%
   return titleSim * 0.3 + summarySim * 0.3 + codeSim * 0.4;
 }
@@ -27,11 +33,15 @@ function computeSimilarity(candidate, recipe) {
  */
 function loadRecipesFromDisk(recipesDir) {
   const recipes = [];
-  if (!fs.existsSync(recipesDir)) return recipes;
+  if (!fs.existsSync(recipesDir)) {
+    return recipes;
+  }
 
   const walk = (dir) => {
     for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-      if (entry.name.startsWith('.')) continue;
+      if (entry.name.startsWith('.')) {
+        continue;
+      }
       const full = path.join(dir, entry.name);
       if (entry.isDirectory()) {
         walk(full);
@@ -39,7 +49,7 @@ function loadRecipesFromDisk(recipesDir) {
         try {
           const content = fs.readFileSync(full, 'utf8');
           const titleMatch = content.match(/^#\s+(.+)/m);
-          const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+          const _fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
           const codeMatch = content.match(/```\w*\n([\s\S]*?)```/);
           const summaryMatch = content.match(/summary[_cn]*:\s*(.+)/i);
           recipes.push({
@@ -48,7 +58,9 @@ function loadRecipesFromDisk(recipesDir) {
             summary: summaryMatch?.[1]?.trim() || '',
             code: codeMatch?.[1]?.trim() || '',
           });
-        } catch { /* skip unreadable */ }
+        } catch {
+          /* skip unreadable */
+        }
       }
     }
   };
@@ -73,7 +85,11 @@ export function findSimilarRecipes(projectRoot, candidate, opts = {}) {
   for (const recipe of recipes) {
     const sim = computeSimilarity(candidate, recipe);
     if (sim >= threshold) {
-      results.push({ file: recipe.file, title: recipe.title, similarity: Math.round(sim * 1000) / 1000 });
+      results.push({
+        file: recipe.file,
+        title: recipe.title,
+        similarity: Math.round(sim * 1000) / 1000,
+      });
     }
   }
 

package/lib/service/chat/AnalystAgent.js

@@ -12,8 +12,8 @@
  * @module AnalystAgent
  */
 
-import { buildAnalysisReport, analysisQualityGate, buildRetryPrompt } from './HandoffProtocol.js';
 import Logger from '../../infrastructure/logging/Logger.js';
+import { analysisQualityGate, buildAnalysisReport, buildRetryPrompt } from './HandoffProtocol.js';
 
 // ──────────────────────────────────────────────────────────────────
 // System Prompt — Analyst 专用 (~100 tokens)
@@ -77,12 +77,12 @@ const ANALYST_TOOLS = [
 // ──────────────────────────────────────────────────────────────────
 
 const ANALYST_BUDGET = {
-  maxIterations: 24,      // was 18 — 大项目维度需要充足探索轮次
-  searchBudget: 18,       // was 14 — 匹配更大探索空间
-  searchBudgetGrace: 10,  // was 8
-  maxSubmits: 0,          // Analyst 不提交候选
+  maxIterations: 24, // was 18 — 大项目维度需要充足探索轮次
+  searchBudget: 18, // was 14 — 匹配更大探索空间
+  searchBudgetGrace: 10, // was 8
+  maxSubmits: 0, // Analyst 不提交候选
   softSubmitLimit: 0,
-  idleRoundsToExit: 2,    // 减少空转
+  idleRoundsToExit: 2, // 减少空转
 };
 
 // ──────────────────────────────────────────────────────────────────
@@ -99,11 +99,20 @@ const ANALYST_BUDGET = {
  * @param {object} [codeEntityGraph] — CodeEntityGraph 实例 (Phase E 代码实体图谱)
  * @returns {string}
  */
-function buildAnalystPrompt(dimConfig, projectInfo, dimensionContext, episodicMemory, semanticMemory, codeEntityGraph) {
+function buildAnalystPrompt(
+  dimConfig,
+  projectInfo,
+  dimensionContext,
+  episodicMemory,
+  semanticMemory,
+  codeEntityGraph
+) {
   const parts = [];
 
   // §1 任务描述
-  parts.push(`分析项目 ${projectInfo.name} (${projectInfo.lang}, ${projectInfo.fileCount} 个文件) 的 ${dimConfig.label}。`);
+  parts.push(
+    `分析项目 ${projectInfo.name} (${projectInfo.lang}, ${projectInfo.fileCount} 个文件) 的 ${dimConfig.label}。`
+  );
 
   // §2 维度指引
   if (dimConfig.guide) {
@@ -112,7 +121,7 @@ function buildAnalystPrompt(dimConfig, projectInfo, dimensionContext, episodicMe
 
   // §3 探索焦点
   if (dimConfig.focusAreas?.length > 0) {
-    parts.push(`重点关注:\n${dimConfig.focusAreas.map(f => `- ${f}`).join('\n')}`);
+    parts.push(`重点关注:\n${dimConfig.focusAreas.map((f) => `- ${f}`).join('\n')}`);
   }
 
   // §4 输出要求
@@ -142,7 +151,8 @@ ${depthHint}
   //        回退到 DimensionContext (兼容)
   if (episodicMemory) {
     const emContext = episodicMemory.buildContextForDimension(
-      dimConfig.id, dimConfig.focusAreas || []
+      dimConfig.id,
+      dimConfig.focusAreas || []
     );
     if (emContext) {
       parts.push(emContext);
@@ -183,7 +193,9 @@ ${depthHint}
       if (section) {
         parts.push(section);
       }
-    } catch { /* SemanticMemory retrieval failed, non-critical */ }
+    } catch {
+      /* SemanticMemory retrieval failed, non-critical */
+    }
   }
 
   // §9: 代码实体图谱 (Phase E) — 类/协议/Category 关系拓扑
@@ -194,7 +206,9 @@ ${depthHint}
         parts.push(graphCtx);
         parts.push('使用 query_code_graph 工具可以查询更详细的继承链、影响分析等。');
       }
-    } catch { /* CodeEntityGraph context failed, non-critical */ }
+    } catch {
+      /* CodeEntityGraph context failed, non-critical */
+    }
   }
 
   return parts.join('\n\n');
@@ -243,22 +257,26 @@ export class AnalystAgent {
   async analyze(dimConfig, projectInfo, options = {}) {
     const dimId = dimConfig.id;
     const prompt = buildAnalystPrompt(
-      dimConfig, projectInfo,
+      dimConfig,
+      projectInfo,
       options.dimensionContext,
-      options.episodicMemory,  // v4.0: EpisodicMemory 增强
-      options.semanticMemory,  // v4.1: ProjectSemanticMemory 历史记忆
-      options.codeEntityGraph  // Phase E: CodeEntityGraph 代码实体图谱
+      options.episodicMemory, // v4.0: EpisodicMemory 增强
+      options.semanticMemory, // v4.1: ProjectSemanticMemory 历史记忆
+      options.codeEntityGraph // Phase E: CodeEntityGraph 代码实体图谱
     );
 
-    this.#logger.info(`[AnalystAgent] ▶ analyzing dimension "${dimId}" — prompt ${prompt.length} chars`);
+    this.#logger.info(
+      `[AnalystAgent] ▶ analyzing dimension "${dimId}" — prompt ${prompt.length} chars`
+    );
 
     let retries = 0;
     let lastReport = null;
 
     while (retries <= this.#maxRetries) {
-      const execPrompt = retries === 0
-        ? prompt
-        : prompt + '\n\n' + buildRetryPrompt(lastReport?._gateReason || 'Analysis too short');
+      const execPrompt =
+        retries === 0
+          ? prompt
+          : `${prompt}\n\n${buildRetryPrompt(lastReport?._gateReason || 'Analysis too short')}`;
 
       try {
         const result = await this.#chatAgent.execute(execPrompt, {
@@ -293,13 +311,19 @@ export class AnalystAgent {
         }
 
         // 质量门控 — 传入 outputType 以调整门槛
-        const gate = analysisQualityGate(report, { outputType: dimConfig.outputType || 'analysis' });
+        const gate = analysisQualityGate(report, {
+          outputType: dimConfig.outputType || 'analysis',
+        });
         if (gate.pass) {
-          this.#logger.info(`[AnalystAgent] ✅ dimension "${dimId}" — ${report.analysisText.length} chars, ${report.referencedFiles.length} files referenced, ${report.metadata.toolCallCount} tool calls`);
+          this.#logger.info(
+            `[AnalystAgent] ✅ dimension "${dimId}" — ${report.analysisText.length} chars, ${report.referencedFiles.length} files referenced, ${report.metadata.toolCallCount} tool calls`
+          );
           return report;
         }
 
-        this.#logger.warn(`[AnalystAgent] ⚠ Gate failed for "${dimId}": ${gate.reason} (action=${gate.action})`);
+        this.#logger.warn(
+          `[AnalystAgent] ⚠ Gate failed for "${dimId}": ${gate.reason} (action=${gate.action})`
+        );
 
         if (gate.action === 'degrade') {
           // 直接降级 — 不重试
@@ -320,7 +344,9 @@ export class AnalystAgent {
 
     // 重试耗尽 — 返回最后一次结果
     this.#logger.warn(`[AnalystAgent] Retries exhausted for "${dimId}" — returning last report`);
-    return lastReport || buildAnalysisReport({ reply: '', toolCalls: [] }, dimId, this.#projectGraph);
+    return (
+      lastReport || buildAnalysisReport({ reply: '', toolCalls: [] }, dimId, this.#projectGraph)
+    );
   }
 }