autosnippet 3.3.6 → 3.3.8

package/dist/lib/external/mcp/handlers/structure.js

@@ -236,7 +236,7 @@ export async function getTargetMetadata(ctx, args) {
     try {
         const graphService = ctx.container?.get('knowledgeGraphService');
         if (graphService) {
-            const edges = graphService.getEdges(target.name, 'module', 'both');
+            const edges = await graphService.getEdges(target.name, 'module', 'both');
             meta.graphEdges = {
                 outgoing: (edges.outgoing || []).map((e) => ({
                     toId: e.toId,
@@ -270,10 +270,10 @@ export async function graphQuery(ctx, args) {
     let data;
     try {
         if (args.relation) {
-            data = graphService.getRelated(args.nodeId, nodeType, args.relation);
+            data = await graphService.getRelated(args.nodeId, nodeType, args.relation);
         }
         else {
-            data = graphService.getEdges(args.nodeId, nodeType, direction);
+            data = await graphService.getEdges(args.nodeId, nodeType, direction);
         }
     }
     catch (err) {
@@ -302,7 +302,7 @@ export async function graphImpact(ctx, args) {
     const nodeType = args.nodeType || 'recipe';
     let impacted;
     try {
-        impacted = graphService.getImpactAnalysis(args.nodeId, nodeType, args.maxDepth ?? 3);
+        impacted = await graphService.getImpactAnalysis(args.nodeId, nodeType, args.maxDepth ?? 3);
     }
     catch (err) {
         // knowledge_edges 表不存在时 graceful 降级
@@ -360,9 +360,7 @@ async function _fallbackRelationsFromRecipe(ctx, nodeId, relation, direction) {
         const incoming = [];
         if (direction === 'both' || direction === 'in') {
             const knowledgeRepo = ctx.container.get('knowledgeRepository');
-            const reverseRows = knowledgeRepo.db
-                .prepare(`SELECT id, relations FROM knowledge_entries WHERE relations LIKE ? AND id != ?`)
-                .all(`%${nodeId}%`, nodeId);
+            const reverseRows = await knowledgeRepo.findByRelationLike(nodeId, nodeId);
             for (const row of reverseRows) {
                 try {
                     const rels = JSON.parse(row.relations || '{}');
@@ -399,9 +397,7 @@ async function _fallbackRelationsFromRecipe(ctx, nodeId, relation, direction) {
 async function _fallbackImpactFromRecipe(ctx, nodeId) {
     try {
         const knowledgeRepo = ctx.container.get('knowledgeRepository');
-        const rows = knowledgeRepo.db
-            .prepare(`SELECT id, title, relations FROM knowledge_entries WHERE relations LIKE ? AND id != ?`)
-            .all(`%${nodeId}%`, nodeId);
+        const rows = await knowledgeRepo.findByRelationLike(nodeId, nodeId);
         const impacted = [];
         for (const row of rows) {
             try {
@@ -448,7 +444,7 @@ export async function graphPath(ctx, args) {
     const maxDepth = Math.min(Math.max(args.maxDepth ?? 5, 1), 10);
     let result;
     try {
-        result = graphService.findPath(args.fromId, fromType, args.toId, toType, maxDepth);
+        result = await graphService.findPath(args.fromId, fromType, args.toId, toType, maxDepth);
     }
     catch (err) {
         if (err instanceof Error && err.message?.includes('no such table')) {
@@ -568,7 +564,7 @@ export async function graphStats(ctx) {
     }
     let stats;
     try {
-        stats = graphService.getStats();
+        stats = await graphService.getStats();
     }
     catch (err) {
         if (err instanceof Error && err.message?.includes('no such table')) {

package/dist/lib/external/mcp/handlers/system.js

@@ -22,46 +22,22 @@ export async function health(ctx) {
     }
     // 2) Database 连通性 + 知识库统计
     try {
-        const dbConn = ctx.container.get('database');
-        if (dbConn) {
-            // DatabaseConnection 包装器 → 解包获取原始 better-sqlite3 实例
-            const db = typeof dbConn.getDb === 'function' ? dbConn.getDb() : dbConn;
-            db.prepare('SELECT 1').get();
+        const knowledgeRepo = ctx.container.get('knowledgeRepository');
+        if (knowledgeRepo) {
+            const stats = (await knowledgeRepo.getStats());
             checks.database = true;
-            // 知识库统计（轻量聚合查询）
-            try {
-                // V3: knowledge_entries 统一表（lifecycle 替代 status）
-                const rStats = db
-                    .prepare(`
-          SELECT COUNT(*) as total,
-            SUM(CASE WHEN lifecycle='active' THEN 1 ELSE 0 END) as active,
-            SUM(CASE WHEN kind='rule' THEN 1 ELSE 0 END) as rules,
-            SUM(CASE WHEN kind='pattern' THEN 1 ELSE 0 END) as patterns,
-            SUM(CASE WHEN kind='fact' THEN 1 ELSE 0 END) as facts
-          FROM knowledge_entries
-        `)
-                    .get();
-                const cPending = db
-                    .prepare(`
-          SELECT COUNT(*) as total,
-            SUM(CASE WHEN lifecycle='pending' THEN 1 ELSE 0 END) as pending
-          FROM knowledge_entries
-        `)
-                    .get();
+            if (stats) {
                 knowledgeBase = {
                     recipes: {
-                        total: rStats.total,
-                        active: rStats.active,
-                        rules: rStats.rules,
-                        patterns: rStats.patterns,
-                        facts: rStats.facts,
+                        total: stats.total,
+                        active: stats.active,
+                        rules: stats.rules,
+                        patterns: stats.patterns,
+                        facts: stats.facts,
                     },
-                    candidates: { total: cPending.total, pending: cPending.pending },
+                    candidates: { total: stats.total, pending: stats.pending },
                 };
             }
-            catch {
-                /* 统计查询失败不影响 health */
-            }
         }
     }
     catch (e) {

package/dist/lib/http/routes/ai.js

@@ -25,6 +25,15 @@ const logger = Logger.getInstance();
 function getContainer() {
     return getServiceContainer();
 }
+/** 检查 AI Provider 是否可用（非 mock），不可用则抛 ValidationError */
+function requireAiReady() {
+    const container = getContainer();
+    const manager = container.singletons?._aiProviderManager;
+    if (manager?.isMock) {
+        throw new ValidationError('AI Provider 未配置，当前为 Mock 模式。请先在 .env 中配置 API Key。');
+    }
+    return container;
+}
 // ═══════════════════════════════════════════════════════
 //  UI 语言偏好 — 前端 ↔ 服务端同步
 // ═══════════════════════════════════════════════════════
@@ -76,22 +85,19 @@ router.get('/providers', async (req, res) => {
 });
 /**
  * GET /api/v1/ai/config
- * 获取当前 AI 配置
+ * 获取当前 AI 配置（优先从 AiProviderManager 读取）
  */
 router.get('/config', async (req, res) => {
     const container = getServiceContainer();
-    const p = container.singletons?.aiProvider;
+    const manager = container.singletons?._aiProviderManager;
     res.json({
         success: true,
-        data: {
-            provider: p?.name || '',
-            model: p?.model || '',
-        },
+        data: { provider: manager.name, model: manager.model, isMock: manager.isMock },
     });
 });
 /**
  * POST /api/v1/ai/config
- * 更新 AI 配置（切换提供商/模型）
+ * 更新 AI 配置（切换提供商/模型）— 通过 AiProviderManager 统一热切换
  */
 router.post('/config', validate(AiConfigBody), async (req, res) => {
     const { provider, model } = req.body;
@@ -106,18 +112,13 @@ router.post('/config', validate(AiConfigBody), async (req, res) => {
     catch (error) {
         throw new ValidationError(`Invalid provider: ${error.message}`);
     }
-    // 同步到 DI 容器，使 SearchEngine / Agent / IndexingPipeline 等也使用新 provider
-    try {
-        const container = getServiceContainer();
-        container.reloadAiProvider(newProvider);
-        logger.info('AI provider synced to DI container', {
-            provider: provider.toLowerCase(),
-            model: newProvider.model,
-        });
-    }
-    catch (err) {
-        logger.debug('DI container 同步 AI provider 失败', { error: err.message });
-    }
+    // 通过 reloadAiProvider → AiProviderManager.switchProvider() 统一热切换
+    const container = getServiceContainer();
+    container.reloadAiProvider(newProvider);
+    logger.info('AI provider switched via AiProviderManager', {
+        provider: provider.toLowerCase(),
+        model: newProvider.model,
+    });
     res.json({
         success: true,
         data: {
@@ -127,13 +128,56 @@ router.post('/config', validate(AiConfigBody), async (req, res) => {
         },
     });
 });
+/**
+ * POST /api/v1/ai/mock/cleanup
+ * 清理 Mock 模式产生的候选数据
+ */
+router.post('/mock/cleanup', async (_req, res) => {
+    const container = getContainer();
+    const knowledgeService = container.get('knowledgeService');
+    const knowledgeRepo = container.get('knowledgeRepository');
+    // 查找所有 mock 来源的候选
+    const mockSources = ['mock-bootstrap', 'mock-pipeline'];
+    let totalDeleted = 0;
+    for (const source of mockSources) {
+        const ids = await knowledgeRepo.findIdsBySource(source);
+        for (const id of ids) {
+            try {
+                await knowledgeService.delete(id, { userId: 'system:mock-cleanup' });
+                totalDeleted++;
+            }
+            catch {
+                logger.debug(`Mock cleanup: failed to delete ${id}`);
+            }
+        }
+    }
+    // 清理 bootstrap 来源的 semantic_memories
+    try {
+        const memoryRepo = container.get('memoryRepository');
+        if (memoryRepo) {
+            await memoryRepo.clearBootstrapMemories();
+        }
+    }
+    catch {
+        // memoryRepository 可能未注册
+    }
+    logger.info(`Mock cleanup completed: ${totalDeleted} entries deleted`);
+    const rt = getRealtimeService();
+    if (rt) {
+        rt.broadcastEvent('mock-cleanup-completed', { deleted: totalDeleted });
+    }
+    res.json({
+        success: true,
+        data: { deleted: totalDeleted },
+    });
+});
 /**
  * POST /api/v1/ai/summarize
  * AI 摘要生成
  */
 router.post('/summarize', validate(AiSummarizeBody), async (req, res) => {
     const { code, language } = req.body;
-    const container = getContainer();
+    const container = requireAiReady();
     const factory = container.get('agentFactory');
     const result = await factory.scanKnowledge({
         label: 'code',
@@ -158,7 +202,7 @@ router.post('/translate', validate(AiTranslateBody), async (req, res) => {
         });
     }
     try {
-        const container = getContainer();
+        const container = requireAiReady();
         const factory = container.get('agentFactory');
         const result = await factory.translateToEnglish(summary, usageGuide);
         if (result?.error) {
@@ -197,7 +241,7 @@ router.post('/translate', validate(AiTranslateBody), async (req, res) => {
  */
 router.post('/chat', validate(AiChatBody), async (req, res) => {
     const { prompt, history, lang, conversationId } = req.body;
-    const container = getContainer();
+    const container = requireAiReady();
     const factory = container.get('agentFactory');
     // ── 对话持久化: 从 ConversationStore 加载历史 ──
     let convStore = null;
@@ -309,7 +353,7 @@ router.post('/chat', validate(AiChatBody), async (req, res) => {
  */
 router.post('/agent/tool', validate(AiToolBody), async (req, res) => {
     const { tool, params } = req.body;
-    const container = getContainer();
+    const container = requireAiReady();
     const factory = container.get('agentFactory');
     const result = await factory.invokeAgent(tool, params);
     res.json({ success: true, data: result });
@@ -332,7 +376,7 @@ const DAG_TASK_HANDLERS = {
 };
 router.post('/agent/task', validate(AiTaskBody), async (req, res) => {
     const { task, params } = req.body;
-    const container = getContainer();
+    const container = requireAiReady();
     const factory = container.get('agentFactory');
     // 优先尝试 DAG 任务
     const dagHandler = DAG_TASK_HANDLERS[task];
@@ -530,7 +574,7 @@ router.post('/env-config', validate(AiEnvConfigBody), async (req, res) => {
     for (const [k, v] of Object.entries(updates)) {
         process.env[k] = String(v);
     }
-    // 尝试热切换 AI Provider（包括依赖 AI 的所有服务）
+    // 尝试热切换 AI Provider（通过 AiProviderManager 统一处理）
     try {
         const newProvider = createProvider({
             provider: provider.toLowerCase(),
@@ -538,7 +582,7 @@ router.post('/env-config', validate(AiEnvConfigBody), async (req, res) => {
         });
         const container = getServiceContainer();
         container.reloadAiProvider(newProvider);
-        logger.info('AI provider hot-swapped after env update', {
+        logger.info('AI provider hot-swapped via AiProviderManager after env update', {
             provider,
             model: newProvider.model,
         });
@@ -576,7 +620,7 @@ router.post('/env-config', validate(AiEnvConfigBody), async (req, res) => {
  */
 router.post('/chat/stream', validate(AiStreamBody), async (req, res) => {
     const { prompt, history, lang } = req.body;
-    const container = getContainer();
+    const container = requireAiReady();
     const factory = container.get('agentFactory');
     const session = createStreamSession('chat');
     logger.debug('SSE session created', { sessionId: session.sessionId });
@@ -626,18 +670,53 @@ router.post('/chat/stream', validate(AiStreamBody), async (req, res) => {
     runtime
         .execute(message)
         .then((result) => {
+        const replyText = result.reply || '';
         // 发送最终文本
-        if (result.reply) {
+        if (replyText) {
             const textId = `text_${Date.now()}`;
             session.send({ type: 'text:start', id: textId, role: 'assistant' });
-            session.send({ type: 'text:delta', id: textId, delta: result.reply });
+            session.send({ type: 'text:delta', id: textId, delta: replyText });
             session.send({ type: 'text:end', id: textId });
         }
+        else {
+            logger.warn('SSE session: empty reply from AgentRuntime', {
+                sessionId: session.sessionId,
+                iterations: result.iterations,
+                toolCalls: result.toolCalls?.length || 0,
+            });
+        }
         session.end({
-            text: result.reply,
+            text: replyText || '抱歉，AI 未能生成有效回复。请重试或换个问题。',
             toolCalls: result.toolCalls || [],
             iterations: result.iterations || 0,
         });
+        // ── Token 用量持久化（streaming） ──
+        try {
+            const tokenUsage = result.tokenUsage;
+            if (tokenUsage) {
+                const tokenStore = container.get('tokenUsageStore');
+                const aiProvider = container.singletons?.aiProvider;
+                tokenStore.record({
+                    source: 'user',
+                    provider: aiProvider?.name ?? undefined,
+                    model: aiProvider?.model ?? undefined,
+                    inputTokens: tokenUsage.input || 0,
+                    outputTokens: tokenUsage.output || 0,
+                    durationMs: result.durationMs || 0,
+                    toolCalls: result.toolCalls?.length || 0,
+                });
+                try {
+                    const realtime = getRealtimeService();
+                    realtime?.broadcastTokenUsageUpdated?.();
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+        }
+        catch {
+            /* token tracking should never break streaming */
+        }
         logger.debug('SSE session completed', {
             sessionId: session.sessionId,
             events: session.buffer.length,

package/dist/lib/http/routes/candidates.js

@@ -55,6 +55,13 @@ router.post('/enrich', validate(EnrichBody), async (req, res) => {
     let enrichedCount = 0;
     const results = [];
     if (aiProvider) {
+        // Mock 模式下跳过 AI enrichment
+        if (aiProvider.name === 'mock') {
+            return void res.json({
+                success: true,
+                data: { enriched: 0, total: candidates.length, results: [], mock: true },
+            });
+        }
         let enriched = [];
         try {
             // 获取用户语言偏好
@@ -418,8 +425,8 @@ router.post('/refine-preview', validate(RefinePreviewBody), async (req, res) =>
     const container = getServiceContainer();
     const knowledgeService = container.get('knowledgeService');
     const aiProvider = container.get('aiProvider');
-    if (!aiProvider) {
-        throw new ValidationError('AI provider not configured');
+    if (!aiProvider || aiProvider.name === 'mock') {
+        throw new ValidationError('AI Provider 未配置，当前为 Mock 模式。请先配置 API Key。');
     }
     const entry = await knowledgeService.get(candidateId);
     if (!entry) {
@@ -459,8 +466,8 @@ router.post('/refine-preview-stream', validate(RefinePreviewBody), async (req, r
     const container = getServiceContainer();
     const knowledgeService = container.get('knowledgeService');
     const aiProvider = container.get('aiProvider');
-    if (!aiProvider) {
-        throw new ValidationError('AI provider not configured');
+    if (!aiProvider || aiProvider.name === 'mock') {
+        throw new ValidationError('AI Provider 未配置，当前为 Mock 模式。请先配置 API Key。');
     }
     const entry = await knowledgeService.get(candidateId);
     if (!entry) {

package/dist/lib/http/routes/commands.js

@@ -29,6 +29,15 @@ router.post('/spm-map', async (req, res) => {
  */
 router.post('/embed', async (req, res) => {
     const container = getServiceContainer();
+    // Mock 模式下向量构建需要 embedding — 拒绝执行
+    const manager = container.singletons?._aiProviderManager;
+    if (manager?.isMock) {
+        res.status(400).json({
+            success: false,
+            message: 'AI Provider 未配置，当前为 Mock 模式。Embedding 不可用。',
+        });
+        return;
+    }
     // 优先使用 VectorService (新架构), 降级到 indexingPipeline (旧架构)
     const vectorService = container.services.vectorService ? container.get('vectorService') : null;
     let result;
@@ -80,7 +89,7 @@ router.get('/status', async (req, res) => {
         spmMap: { available: false },
     };
     try {
-        const indexingPipeline = container.get('indexingPipeline');
+        const _indexingPipeline = container.get('indexingPipeline');
         status.index.ready = true; // IndexingPipeline is available
     }
     catch {

package/dist/lib/http/routes/guardReport.js

@@ -67,8 +67,7 @@ router.get('/reverse', async (req, res) => {
             reverseGuard = container.get('reverseGuard');
         }
         catch {
-            const db = container.get('database');
-            reverseGuard = new ReverseGuard(db.getDb());
+            reverseGuard = new ReverseGuard(container.get('knowledgeRepository'), container.get('codeEntityRepository'), container.get('recipeSourceRefRepository'));
         }
         const maxFiles = req.query.maxFiles ? Number(req.query.maxFiles) : 200;
         const projectFiles = await collectSourceFilesWithContent(projectRoot, { maxFiles });
@@ -111,14 +110,13 @@ router.get('/coverage', async (_req, res) => {
             analyzer = container.get('coverageAnalyzer');
         }
         catch {
-            const db = container.get('database');
-            analyzer = new CoverageAnalyzer(db.getDb());
+            analyzer = new CoverageAnalyzer(container.get('knowledgeRepository'), container.get('guardViolationRepository'));
         }
         // 从 Panorama 或目录结构获取模块文件
         const moduleFiles = new Map();
         try {
             const panorama = container.get('panoramaService');
-            const overview = panorama.getOverview();
+            const overview = await panorama.getOverview();
             if (overview?.modules) {
                 for (const mod of overview.modules) {
                     if (mod.files?.length > 0) {

package/dist/lib/http/routes/health.js

@@ -1,5 +1,6 @@
 /** 健康检查端点 */
 import express from 'express';
+import { getDeveloperIdentity } from '../../shared/developer-identity.js';
 const router = express.Router();
 /**
  * GET /api/v1/health
@@ -25,4 +26,14 @@ router.get('/ready', (req, res) => {
         timestamp: Math.floor(Date.now() / 1000),
     });
 });
+/**
+ * GET /api/v1/health/identity
+ * 当前开发者身份（从 git config / 环境变量解析）
+ */
+router.get('/identity', (_req, res) => {
+    res.json({
+        success: true,
+        developer: getDeveloperIdentity(),
+    });
+});
 export default router;

package/dist/lib/http/routes/modules.js

@@ -459,6 +459,33 @@ router.get('/bootstrap/status', async (req, res) => {
         data: taskManager.getSessionStatus(),
     });
 });
+/**
+ * POST /api/v1/modules/bootstrap/cancel
+ * 取消正在运行的 bootstrap / rescan 异步填充会话
+ */
+router.post('/bootstrap/cancel', async (req, res) => {
+    const container = getServiceContainer();
+    let taskManager = null;
+    try {
+        taskManager = container.get('bootstrapTaskManager');
+    }
+    catch {
+        /* not registered */
+    }
+    if (!taskManager) {
+        return void res.json({ success: true, message: 'No bootstrap task manager initialized' });
+    }
+    if (!taskManager.isRunning) {
+        return void res.json({ success: true, message: 'No active bootstrap session' });
+    }
+    const reason = req.body?.reason || 'Cancelled by user via Dashboard';
+    taskManager.abortSession(reason);
+    logger.info('Bootstrap session cancelled via HTTP', { reason });
+    res.json({
+        success: true,
+        data: taskManager.getSessionStatus(),
+    });
+});
 /**
  * POST /api/v1/modules/rescan
  * 增量扫描：保留已有 Recipe，重新分析项目，补齐缺失知识

package/dist/lib/http/routes/panorama.js

@@ -31,7 +31,7 @@ router.get('/', async (req, res) => {
         if (typeof panoramaService.ensureData === 'function') {
             await panoramaService.ensureData();
         }
-        const overview = panoramaService.getOverview();
+        const overview = await panoramaService.getOverview();
         res.json({ success: true, data: overview });
     }
     catch (err) {
@@ -62,7 +62,7 @@ router.get('/health', async (req, res) => {
         if (typeof panoramaService.ensureData === 'function') {
             await panoramaService.ensureData();
         }
-        const health = panoramaService.getHealth();
+        const health = await panoramaService.getHealth();
         res.json({ success: true, data: health });
     }
     catch (err) {
@@ -93,7 +93,7 @@ router.get('/gaps', async (req, res) => {
         if (typeof panoramaService.ensureData === 'function') {
             await panoramaService.ensureData();
         }
-        const gaps = panoramaService.getGaps();
+        const gaps = await panoramaService.getGaps();
         res.json({ success: true, data: gaps });
     }
     catch (err) {
@@ -124,8 +124,8 @@ router.get('/coverage', async (req, res) => {
         if (typeof panoramaService.ensureData === 'function') {
             await panoramaService.ensureData();
         }
-        const overview = panoramaService.getOverview();
-        const gaps = panoramaService.getGaps?.() ?? [];
+        const overview = await panoramaService.getOverview();
+        const gaps = (await panoramaService.getGaps?.()) ?? [];
         // 构建模块级覆盖率数据：从 overview.layers 中提取每个模块的文件数和 recipe 数
         const modules = [];
         for (const layer of overview.layers || []) {
@@ -187,7 +187,7 @@ router.get('/module/:name', async (req, res) => {
         if (typeof panoramaService.ensureData === 'function') {
             await panoramaService.ensureData();
         }
-        const detail = panoramaService.getModule(req.params.name);
+        const detail = await panoramaService.getModule(req.params.name);
         if (!detail) {
             res.status(404).json({
                 success: false,
@@ -220,7 +220,7 @@ router.post('/governance/cycle', async (_req, res) => {
             });
             return;
         }
-        const report = metabolism.runFullCycle();
+        const report = await metabolism.runFullCycle();
         res.json({ success: true, data: report });
     }
     catch (err) {
@@ -245,7 +245,7 @@ router.get('/governance/decay', async (_req, res) => {
             });
             return;
         }
-        const results = decayDetector.scanAll();
+        const results = await decayDetector.scanAll();
         res.json({ success: true, data: { results } });
     }
     catch (err) {
@@ -270,8 +270,8 @@ router.post('/governance/staging-check', async (_req, res) => {
             });
             return;
         }
-        const checkResult = stagingManager.checkAndPromote();
-        const currentStaging = stagingManager.listStaging();
+        const checkResult = await stagingManager.checkAndPromote();
+        const currentStaging = await stagingManager.listStaging();
         res.json({ success: true, data: { checkResult, currentStaging } });
     }
     catch (err) {
@@ -296,7 +296,7 @@ router.get('/governance/staging', async (_req, res) => {
             });
             return;
         }
-        const entries = stagingManager.listStaging();
+        const entries = await stagingManager.listStaging();
         res.json({ success: true, data: { entries } });
     }
     catch (err) {
@@ -321,7 +321,7 @@ router.get('/governance/enhancements', async (_req, res) => {
             });
             return;
         }
-        const suggestions = suggester.analyzeAll();
+        const suggestions = await suggester.analyzeAll();
         res.json({ success: true, data: { suggestions } });
     }
     catch (err) {