autosnippet 3.2.10 → 3.2.12

package/lib/http/routes/search.js

@@ -1,452 +0,0 @@
-/**
- * Search API 路由
- * 统一搜索接口 - 搜 Recipe（含所有知识类型）
- */
-
-import express from 'express';
-import Logger from '../../infrastructure/logging/Logger.js';
-import { getServiceContainer } from '../../injection/ServiceContainer.js';
-import { ValidationError } from '../../shared/errors/index.js';
-import { asyncHandler } from '../middleware/errorHandler.js';
-import { safeInt } from '../utils/routeHelpers.js';
-
-const router = express.Router();
-const logger = Logger.getInstance();
-
-/**
- * GET /api/v1/search
- * 统一搜索
- * ?q=keyword&type=all|recipe|solution|rule&limit=20&mode=keyword|bm25|semantic&groupByKind=true
- */
-router.get(
-  '/',
-  asyncHandler(async (req, res) => {
-    const { q, type = 'all', mode = 'keyword' } = req.query;
-    const limit = safeInt(req.query.limit, 20, 1, 100);
-    const page = safeInt(req.query.page, 1);
-    const groupByKind = req.query.groupByKind === 'true';
-
-    if (!q || !q.trim()) {
-      throw new ValidationError('Search query (q) is required');
-    }
-
-    const container = getServiceContainer();
-
-    // 所有模式优先通过 SearchEngine（含 auto/bm25/semantic/keyword/ranking）
-    try {
-      const searchEngine = container.get('searchEngine');
-      const result = await searchEngine.search(q, { type, limit, mode, groupByKind });
-      return res.json({ success: true, data: result });
-    } catch (err) {
-      logger.warn('SearchEngine 搜索失败，降级到传统搜索', { mode, error: err.message });
-    }
-
-    const results = {};
-    const pagination = { page, pageSize: limit };
-
-    // 搜索知识条目（V3 统一模型）
-    if (type === 'all' || type === 'recipe' || type === 'solution') {
-      try {
-        const knowledgeService = container.get('knowledgeService');
-        results.recipes = await knowledgeService.search(q, pagination);
-      } catch (err) {
-        logger.warn('Knowledge 搜索失败', { query: q, error: err.message });
-        results.recipes = { items: [], total: 0 };
-      }
-    }
-
-    // 搜索 Guard Rule（boundary-constraint 类型的 Recipe）
-    if (type === 'all' || type === 'rule') {
-      try {
-        const guardService = container.get('guardService');
-        results.rules = await guardService.searchRules(q, pagination);
-      } catch (err) {
-        logger.warn('Guard Rule 搜索失败', { query: q, error: err.message });
-        results.rules = { items: [], total: 0 };
-      }
-    }
-
-    // 搜索候选知识条目 (V3: lifecycle=draft/pending)
-    if (type === 'all' || type === 'candidate') {
-      try {
-        const knowledgeService = container.get('knowledgeService');
-        results.candidates = await knowledgeService.search(q, pagination);
-      } catch (err) {
-        logger.warn('Candidate 搜索失败', { query: q, error: err.message });
-        results.candidates = { items: [], total: 0 };
-      }
-    }
-
-    const totalResults = Object.values(results).reduce(
-      (sum, r) => sum + (r.total || r.items?.length || 0),
-      0
-    );
-
-    res.json({
-      success: true,
-      data: {
-        query: q,
-        type,
-        mode,
-        totalResults,
-        ...results,
-      },
-    });
-  })
-);
-
-/**
- * GET /api/v1/search/graph
- * 知识图谱查询
- * ?nodeId=xxx&nodeType=recipe
- */
-router.get(
-  '/graph',
-  asyncHandler(async (req, res) => {
-    const { nodeId, nodeType, relation, direction = 'both' } = req.query;
-
-    if (!nodeId || !nodeType) {
-      throw new ValidationError('nodeId and nodeType are required');
-    }
-
-    const container = getServiceContainer();
-    const graphService = container.get('knowledgeGraphService');
-
-    if (!graphService) {
-      return res.json({ success: true, data: { outgoing: [], incoming: [] } });
-    }
-
-    const edges = relation
-      ? graphService.getRelated(nodeId, nodeType, relation)
-      : graphService.getEdges(nodeId, nodeType, direction);
-
-    res.json({ success: true, data: edges });
-  })
-);
-
-/**
- * GET /api/v1/search/graph/impact
- * 影响分析
- */
-router.get(
-  '/graph/impact',
-  asyncHandler(async (req, res) => {
-    const { nodeId, nodeType } = req.query;
-    const maxDepth = safeInt(req.query.maxDepth, 3, 1, 5);
-
-    if (!nodeId || !nodeType) {
-      throw new ValidationError('nodeId and nodeType are required');
-    }
-
-    const container = getServiceContainer();
-    const graphService = container.get('knowledgeGraphService');
-
-    if (!graphService) {
-      return res.json({ success: true, data: [] });
-    }
-
-    const impact = graphService.getImpactAnalysis(nodeId, nodeType, maxDepth);
-    res.json({ success: true, data: impact });
-  })
-);
-
-/**
- * GET /api/v1/search/graph/all
- * 全量知识图谱边（Dashboard 可视化用）
- * ?limit=500
- */
-router.get(
-  '/graph/all',
-  asyncHandler(async (req, res) => {
-    const limit = safeInt(req.query.limit, 500, 1, 2000);
-
-    const container = getServiceContainer();
-    const graphService = container.get('knowledgeGraphService');
-
-    if (!graphService) {
-      return res.json({ success: true, data: { edges: [], nodeLabels: {} } });
-    }
-
-    // 只返回 recipe 类型的关系边；module 依赖已由 /spm/dep-graph 提供
-    const nodeType = req.query.nodeType || 'recipe';
-    const edges = graphService.getAllEdges(limit, nodeType === 'all' ? undefined : nodeType);
-
-    // 收集节点 ID + 类型 → 按类型查标签
-    const nodeMap = new Map(); // id → Set<type>
-    for (const e of edges) {
-      if (!nodeMap.has(e.fromId)) {
-        nodeMap.set(e.fromId, new Set());
-      }
-      nodeMap.get(e.fromId).add(e.fromType);
-      if (!nodeMap.has(e.toId)) {
-        nodeMap.set(e.toId, new Set());
-      }
-      nodeMap.get(e.toId).add(e.toType);
-    }
-
-    const nodeLabels = {};
-    const nodeTypes = {}; // id → 主要类型（供前端区分渲染）
-    const nodeCategories = {}; // id → category/target 名（供前端分组布局）
-    if (nodeMap.size > 0) {
-      const knowledgeRepo = container.get('knowledgeRepository');
-      for (const [id, types] of nodeMap) {
-        const primaryType = types.has('recipe') ? 'recipe' : [...types][0];
-        nodeTypes[id] = primaryType;
-
-        if ((primaryType === 'recipe' || primaryType === 'knowledge') && knowledgeRepo) {
-          try {
-            const r = await knowledgeRepo.findById(id);
-            if (r) {
-              nodeLabels[id] = r.title || r.name || id;
-              nodeCategories[id] = r.category || '';
-              continue;
-            }
-          } catch {
-            /* not found – fall through */
-          }
-        }
-        nodeLabels[id] = id;
-      }
-    }
-
-    res.json({ success: true, data: { edges, nodeLabels, nodeTypes, nodeCategories } });
-  })
-);
-
-/**
- * GET /api/v1/search/graph/stats
- * 图谱统计
- */
-router.get(
-  '/graph/stats',
-  asyncHandler(async (req, res) => {
-    const container = getServiceContainer();
-    const graphService = container.get('knowledgeGraphService');
-
-    if (!graphService) {
-      return res.json({ success: true, data: { totalEdges: 0, byRelation: {}, nodeTypes: [] } });
-    }
-
-    const nodeType = req.query.nodeType || 'recipe';
-    const stats = graphService.getStats(nodeType === 'all' ? undefined : nodeType);
-    res.json({ success: true, data: stats });
-  })
-);
-
-/**
- * POST /api/v1/search/context-aware
- * 上下文感知搜索 — SearchEngine 内置 Ranking Pipeline（CoarseRanker + MultiSignalRanker + ContextBoost）
- */
-router.post(
-  '/context-aware',
-  asyncHandler(async (req, res) => {
-    const { keyword, limit, language, sessionHistory } = req.body;
-    if (!keyword || !keyword.trim()) {
-      throw new ValidationError('keyword is required');
-    }
-    const t0 = Date.now();
-    const container = getServiceContainer();
-    const pageSize = Math.min(limit || 10, 100);
-    let results = [];
-    let source = 'knowledgeService';
-
-    // SearchEngine BM25 + 内置 Ranking Pipeline
-    try {
-      const searchEngine = container.get('searchEngine');
-      const result = await searchEngine.search(keyword, {
-        mode: 'bm25',
-        limit: pageSize,
-        rank: true,
-        context: { intent: 'search', language, sessionHistory: sessionHistory || [] },
-      });
-      const items = result?.items || [];
-      if (items.length > 0) {
-        source = result.ranked ? 'search-engine+ranking' : 'search-engine';
-        results = items.map((r) => {
-          let contentStr = '';
-          try {
-            const c =
-              typeof r.content === 'string' && r.content.startsWith('{')
-                ? JSON.parse(r.content)
-                : r.content || {};
-            contentStr = c.pattern || c.markdown || c.code || '';
-          } catch {
-            contentStr = r.content || r.code || '';
-          }
-          return {
-            name: `${r.title || r.id}.md`,
-            content: contentStr,
-            similarity: r.score || 0,
-            authority: r.authorityScore || 0,
-            matchType: result.ranked ? 'ranked' : 'bm25',
-            qualityScore: r.qualityScore || 0,
-            usageCount: r.usageCount || 0,
-          };
-        });
-      }
-    } catch (err) {
-      logger.warn('SearchEngine context-aware 失败，降级到 KnowledgeService', {
-        error: err.message,
-      });
-    }
-
-    // 降级: KnowledgeService SQL LIKE
-    if (results.length === 0) {
-      try {
-        const knowledgeService = container.get('knowledgeService');
-        const list = await knowledgeService.search(keyword, { page: 1, pageSize });
-        const items = list.data || list.items || [];
-        results = items.map((r) => ({
-          name: `${r.title || r.id}.md`,
-          content: r.content?.pattern || r.content?.markdown || '',
-          similarity: 1,
-          authority: r.quality?.overall || 0,
-          matchType: 'keyword',
-          qualityScore: r.quality?.overall || 0,
-        }));
-        source = 'knowledgeService';
-      } catch {
-        /* 全部失败 */
-      }
-    }
-
-    const elapsed = Date.now() - t0;
-    res.json({
-      success: true,
-      data: {
-        results,
-        context: {},
-        total: results.length,
-        hasAiEvaluation: false,
-        searchTime: elapsed,
-        source,
-      },
-    });
-  })
-);
-
-/* ═══ 相似度检测 ════════════════════════════════════════ */
-
-/**
- * POST /api/v1/search/similarity
- * 候选与已有 Recipe 的相似度检测
- * Body: { code, language } 或 { targetName, candidateId } 或 { candidate: {title, summary, code} }
- */
-router.post(
-  '/similarity',
-  asyncHandler(async (req, res) => {
-    const { code, targetName, candidateId, candidate } = req.body;
-    const projectRoot = process.env.ASD_PROJECT_DIR || process.cwd();
-
-    let candidateObj;
-
-    if (candidateId && targetName) {
-      // 从知识库加载候选
-      try {
-        const container = getServiceContainer();
-        const knowledgeService = container.get('knowledgeService');
-        const entry = await knowledgeService.get(candidateId);
-        if (entry) {
-          const json = typeof entry.toJSON === 'function' ? entry.toJSON() : entry;
-          candidateObj = {
-            title: json.title || '',
-            summary: json.description || '',
-            code: json.content?.pattern || '',
-            usageGuide: json.content?.markdown || '',
-          };
-        }
-      } catch (err) {
-        logger.warn('similarity: failed to load candidate', { candidateId, error: err.message });
-      }
-    } else if (candidate) {
-      candidateObj = {
-        title: candidate.title || '',
-        summary: candidate.summary || candidate.description || '',
-        code: candidate.code || candidate.pattern || '',
-        usageGuide: candidate.usageGuide || candidate.markdown || '',
-      };
-    } else if (code) {
-      candidateObj = { title: '', summary: '', code: code || '', usageGuide: '' };
-    }
-
-    if (!candidateObj) {
-      return res.json({ success: true, data: { similar: [] } });
-    }
-
-    try {
-      const { findSimilarRecipes } = await import('../../service/candidate/SimilarityService.js');
-      const similar = findSimilarRecipes(projectRoot, candidateObj, { threshold: 0.3, topK: 10 });
-
-      // 映射为前端期望格式
-      const mapped = similar.map((s) => ({
-        recipeName: s.title || s.file?.replace(/\.md$/, '') || '',
-        similarity: s.similarity,
-        file: s.file,
-      }));
-
-      res.json({ success: true, data: { similar: mapped } });
-    } catch (err) {
-      logger.warn('similarity search failed', { error: err.message });
-      res.json({ success: true, data: { similar: [] } });
-    }
-  })
-);
-
-/**
- * POST /api/v1/search/xcode-simulate
- * Xcode 编辑器上下文模拟搜索
- * Body: { keyword, currentFile?, language?, limit? }
- */
-router.post(
-  '/xcode-simulate',
-  asyncHandler(async (req, res) => {
-    const { keyword, currentFile, language, limit = 10 } = req.body;
-    if (!keyword) {
-      throw new ValidationError('keyword is required');
-    }
-
-    const container = getServiceContainer();
-    const pageSize = Math.min(limit || 10, 50);
-    let results = [];
-
-    // 复用 context-aware 搜索，注入 Xcode 上下文
-    try {
-      const searchEngine = container.get('searchEngine');
-      const result = await searchEngine.search(keyword, {
-        mode: 'bm25',
-        limit: pageSize,
-        rank: true,
-        context: {
-          intent: 'xcode-suggest',
-          language: language || 'swift',
-          currentFile,
-        },
-      });
-      results = (result?.items || []).map((r) => {
-        let contentStr = '';
-        try {
-          const c =
-            typeof r.content === 'string' && r.content.startsWith('{')
-              ? JSON.parse(r.content)
-              : r.content || {};
-          contentStr = c.pattern || c.markdown || c.code || '';
-        } catch {
-          contentStr = r.content || '';
-        }
-        return {
-          name: `${r.title || r.id}.md`,
-          content: contentStr,
-          similarity: r.score || 0,
-          trigger: r.trigger || '',
-          matchType: result.ranked ? 'ranked' : 'bm25',
-        };
-      });
-    } catch (err) {
-      logger.warn('xcode-simulate search failed', { error: err.message });
-    }
-
-    res.json({ success: true, data: { results, total: results.length } });
-  })
-);
-
-export default router;

package/lib/http/routes/skills.js

@@ -1,248 +0,0 @@
-/**
- * Skills API 路由
- * 管理 Agent Skills 的查询、加载和创建（项目级）
- */
-
-import express from 'express';
-import {
-  createSkill,
-  deleteSkill,
-  listSkills,
-  loadSkill,
-  suggestSkills,
-  updateSkill,
-} from '../../external/mcp/handlers/skill.js';
-import { ValidationError } from '../../shared/errors/index.js';
-import { asyncHandler } from '../middleware/errorHandler.js';
-
-const router = express.Router();
-
-/**
- * GET /api/v1/skills
- * 列出所有可用 Skills（内置 + 项目级）
- */
-router.get(
-  '/',
-  asyncHandler(async (_req, res) => {
-    const raw = listSkills();
-    let parsed;
-    try {
-      parsed = JSON.parse(raw);
-    } catch {
-      return res.status(500).json({
-        success: false,
-        error: { code: 'PARSE_ERROR', message: 'Invalid response from listSkills' },
-      });
-    }
-
-    if (!parsed.success) {
-      return res.status(500).json(parsed);
-    }
-
-    res.json({ success: true, data: parsed.data });
-  })
-);
-
-/**
- * GET /api/v1/skills/signal-status
- * 获取 SignalCollector 后台服务状态
- */
-router.get(
-  '/signal-status',
-  asyncHandler(async (_req, res) => {
-    const { _signalCollector } = global;
-    if (!_signalCollector) {
-      return res.json({ success: true, data: { running: false, mode: 'off', snapshot: null } });
-    }
-    res.json({
-      success: true,
-      data: {
-        running: true,
-        mode: _signalCollector.getMode(),
-        snapshot: _signalCollector.getSnapshot(),
-        // 返回 AI 的待处理建议，前端可直接展示
-        suggestions: _signalCollector.getSnapshot().pendingSuggestions || [],
-      },
-    });
-  })
-);
-
-/**
- * GET /api/v1/skills/suggest
- * 基于使用模式分析，推荐创建 Skill
- */
-router.get(
-  '/suggest',
-  asyncHandler(async (req, res) => {
-    const ctx = { container: req.app.locals?.container || null };
-    const raw = await suggestSkills(ctx);
-    let parsed;
-    try {
-      parsed = JSON.parse(raw);
-    } catch {
-      return res.status(500).json({
-        success: false,
-        error: { code: 'PARSE_ERROR', message: 'Invalid response from suggestSkills' },
-      });
-    }
-
-    if (!parsed.success) {
-      return res.status(500).json(parsed);
-    }
-
-    res.json({ success: true, data: parsed.data });
-  })
-);
-
-/**
- * GET /api/v1/skills/:name
- * 加载指定 Skill 的完整文档
- * Query: ?section=xxx 可只返回指定章节
- */
-router.get(
-  '/:name',
-  asyncHandler(async (req, res) => {
-    const { name } = req.params;
-    const { section } = req.query;
-
-    const raw = loadSkill(null, { skillName: name, section });
-    let parsed;
-    try {
-      parsed = JSON.parse(raw);
-    } catch {
-      return res.status(500).json({
-        success: false,
-        error: { code: 'PARSE_ERROR', message: 'Invalid response from loadSkill' },
-      });
-    }
-
-    if (!parsed.success) {
-      const status = parsed.error?.code === 'SKILL_NOT_FOUND' ? 404 : 400;
-      return res.status(status).json(parsed);
-    }
-
-    res.json({ success: true, data: parsed.data });
-  })
-);
-
-/**
- * POST /api/v1/skills
- * 创建项目级 Skill
- * Body: { name, description, content, overwrite? }
- */
-router.post(
-  '/',
-  asyncHandler(async (req, res) => {
-    const { name, description, content, overwrite, createdBy } = req.body;
-
-    if (!name || !description || !content) {
-      throw new ValidationError('name, description, content are all required');
-    }
-
-    const raw = createSkill(null, {
-      name,
-      description,
-      content,
-      overwrite,
-      createdBy: createdBy || 'manual',
-    });
-    let parsed;
-    try {
-      parsed = JSON.parse(raw);
-    } catch {
-      return res.status(500).json({
-        success: false,
-        error: { code: 'PARSE_ERROR', message: 'Invalid response from createSkill' },
-      });
-    }
-
-    if (!parsed.success) {
-      const status =
-        parsed.error?.code === 'BUILTIN_CONFLICT'
-          ? 409
-          : parsed.error?.code === 'ALREADY_EXISTS'
-            ? 409
-            : parsed.error?.code === 'INVALID_NAME'
-              ? 400
-              : 500;
-      return res.status(status).json(parsed);
-    }
-
-    res.status(201).json({ success: true, data: parsed.data });
-  })
-);
-
-/**
- * PUT /api/v1/skills/:name
- * 更新项目级 Skill（description / content）
- */
-router.put(
-  '/:name',
-  asyncHandler(async (req, res) => {
-    const { name } = req.params;
-    const { description, content } = req.body;
-
-    if (!description && !content) {
-      throw new ValidationError('At least one of description or content must be provided');
-    }
-
-    const raw = updateSkill(null, { name, description, content });
-    let parsed;
-    try {
-      parsed = JSON.parse(raw);
-    } catch {
-      return res.status(500).json({
-        success: false,
-        error: { code: 'PARSE_ERROR', message: 'Invalid response from updateSkill' },
-      });
-    }
-
-    if (!parsed.success) {
-      const status =
-        parsed.error?.code === 'SKILL_NOT_FOUND'
-          ? 404
-          : parsed.error?.code === 'BUILTIN_PROTECTED'
-            ? 403
-            : 500;
-      return res.status(status).json(parsed);
-    }
-
-    res.json({ success: true, data: parsed.data });
-  })
-);
-
-/**
- * DELETE /api/v1/skills/:name
- * 删除项目级 Skill
- */
-router.delete(
-  '/:name',
-  asyncHandler(async (req, res) => {
-    const { name } = req.params;
-
-    const raw = deleteSkill(null, { name });
-    let parsed;
-    try {
-      parsed = JSON.parse(raw);
-    } catch {
-      return res.status(500).json({
-        success: false,
-        error: { code: 'PARSE_ERROR', message: 'Invalid response from deleteSkill' },
-      });
-    }
-
-    if (!parsed.success) {
-      const status =
-        parsed.error?.code === 'SKILL_NOT_FOUND'
-          ? 404
-          : parsed.error?.code === 'BUILTIN_PROTECTED'
-            ? 403
-            : 500;
-      return res.status(status).json(parsed);
-    }
-
-    res.json({ success: true, data: parsed.data });
-  })
-);
-
-export default router;