autosnippet 2.0.2 → 2.4.0

package/lib/external/mcp/tools.js

@@ -17,6 +17,7 @@ export const TOOL_GATEWAY_MAP = {
   autosnippet_enrich_candidates: { action: 'candidate:update', resource: 'candidates' },
   autosnippet_bootstrap_knowledge: { action: 'knowledge:bootstrap', resource: 'knowledge' },
   autosnippet_bootstrap_refine: { action: 'candidate:update', resource: 'candidates' },
+  autosnippet_create_skill: { action: 'create:skills', resource: 'skills' },
 };
 
 export const TOOLS = [
@@ -623,7 +624,45 @@ export const TOOLS = [
       required: ['skillName'],
     },
   },
-  // 35. ② 内容润色：Bootstrap 候选 AI 精炼（Phase 6）
+  // 35. 创建项目级 Skill
+  {
+    name: 'autosnippet_create_skill',
+    description:
+      '创建一个项目级 Skill 文档，写入 .autosnippet/skills/<name>/SKILL.md。\n' +
+      'Skill 是 Agent 的领域知识增强文档，帮助 Agent 正确执行特定任务。\n' +
+      '创建后自动更新编辑器索引（.cursor/rules/autosnippet-skills.mdc），使 Skill 被 AI Agent 被动发现。\n' +
+      '\n' +
+      '使用场景：\n' +
+      '  • 将反复出现的操作指南/架构决策/编码规范固化为 Skill\n' +
+      '  • 为特定 Target/模块创建定制化开发指南\n' +
+      '  • 记录项目私有的最佳实践（不适合放入通用知识库）\n' +
+      '\n' +
+      '⚠️ 注意：Skill 名称建议使用 kebab-case，如 my-auth-guide',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name: {
+          type: 'string',
+          description: 'Skill 名称（kebab-case，如 my-auth-guide）。将作为目录名。',
+        },
+        description: {
+          type: 'string',
+          description: 'Skill 一句话描述（写入 SKILL.md frontmatter）',
+        },
+        content: {
+          type: 'string',
+          description: 'Skill 正文内容（Markdown 格式，不含 frontmatter）',
+        },
+        overwrite: {
+          type: 'boolean',
+          default: false,
+          description: '如果同名 Skill 已存在，是否覆盖（默认 false）',
+        },
+      },
+      required: ['name', 'description', 'content'],
+    },
+  },
+  // 36. ② 内容润色：Bootstrap 候选 AI 精炼（Phase 6）
   {
     name: 'autosnippet_bootstrap_refine',
     description:

package/lib/http/middleware/roleResolver.js

@@ -96,7 +96,7 @@ export function roleResolverMiddleware(options = {}) {
         }
       } else {
         // 无探针实例 → 本地开发默认 admin（向后兼容）
-        req.resolvedRole = 'developer_admin';
+        req.resolvedRole = 'developer';
         req.resolvedUser = 'local';
       }
 

package/lib/http/routes/auth.js

@@ -44,7 +44,7 @@ if (!process.env.ASD_AUTH_SECRET) {
 function createToken(username) {
   const payload = {
     sub: username,
-    role: 'developer_admin',
+    role: 'developer',
     iat: Date.now(),
     exp: Date.now() + TOKEN_TTL,
   };
@@ -107,7 +107,7 @@ router.post('/login', asyncHandler(async (req, res) => {
     success: true,
     data: {
       token,
-      user: { username, role: 'developer_admin' },
+      user: { username, role: 'developer' },
     },
   });
 }));

package/lib/http/routes/commands.js

@@ -121,12 +121,67 @@ router.get('/status', asyncHandler(async (req, res) => {
 
 /**
  * GET /api/v1/commands/files/tree
- * Get project file tree (simplified)
+ * Get project file tree – only .h / .m / .swift source files
  */
 router.get('/files/tree', asyncHandler(async (req, res) => {
-  const container = getServiceContainer();
+  const fs   = await import('node:fs');
+  const path = await import('node:path');
+  const container   = getServiceContainer();
   const projectRoot = container.singletons?._projectRoot || process.cwd();
-  res.json({ success: true, data: { type: 'folder', name: 'root', path: projectRoot, children: [] } });
+
+  const SOURCE_EXTS = new Set(['.h', '.m', '.swift']);
+  const SKIP_DIRS   = new Set(['node_modules', '.git', 'Pods', 'build', 'DerivedData', '.build', 'dist', 'vendor']);
+
+  /**
+   * Recursively scan dir, returning FileNode or null if folder has no matching files.
+   */
+  function scanDir(dirPath) {
+    const dirName = path.default.basename(dirPath);
+    if (SKIP_DIRS.has(dirName)) return null;
+
+    let entries;
+    try { entries = fs.default.readdirSync(dirPath, { withFileTypes: true }); } catch { return null; }
+
+    const children = [];
+    for (const entry of entries) {
+      if (entry.name.startsWith('.')) continue;                       // skip hidden
+      const fullPath = path.default.join(dirPath, entry.name);
+
+      if (entry.isDirectory()) {
+        const sub = scanDir(fullPath);
+        if (sub) children.push(sub);
+      } else if (entry.isFile()) {
+        const ext = path.default.extname(entry.name).toLowerCase();
+        if (SOURCE_EXTS.has(ext)) {
+          children.push({
+            type: 'file',
+            name: entry.name,
+            path: fullPath,
+            relativePath: path.default.relative(projectRoot, fullPath),
+            ext,
+          });
+        }
+      }
+    }
+
+    if (children.length === 0) return null;
+
+    // Sort: folders first, then alphabetical
+    children.sort((a, b) => {
+      if (a.type !== b.type) return a.type === 'folder' ? -1 : 1;
+      return a.name.localeCompare(b.name);
+    });
+
+    return {
+      type: 'folder',
+      name: dirName,
+      path: dirPath,
+      children,
+    };
+  }
+
+  const tree = scanDir(projectRoot) || { type: 'folder', name: path.default.basename(projectRoot), path: projectRoot, children: [] };
+  res.json({ success: true, data: tree });
 }));
 
 /**

package/lib/http/routes/monitoring.js

@@ -160,12 +160,12 @@ router.get('/cache', (req, res) => {
 
 /**
  * POST /api/v1/monitoring/cache/clear
- * 清空缓存（仅限 developer_admin）
+ * 清空缓存（仅限 developer）
  */
 router.post('/cache/clear', async (req, res) => {
   // 角色检查：仅 admin 可操作
   const role = req.resolvedRole || 'visitor';
-  if (role !== 'developer_admin') {
+  if (role !== 'developer') {
     return res.status(403).json({
       success: false,
       error: { message: '仅管理员可清空缓存' },
@@ -285,7 +285,7 @@ router.get('/dashboard', async (req, res) => {
 
 /**
  * POST /api/v1/monitoring/reset
- * 重置监控统计（仅限开发环境 + developer_admin）
+ * 重置监控统计（仅限开发环境 + developer）
  */
 router.post('/reset', (req, res) => {
   if (process.env.NODE_ENV === 'production') {
@@ -297,7 +297,7 @@ router.post('/reset', (req, res) => {
 
   // 角色检查：仅 admin 可操作
   const role = req.resolvedRole || 'visitor';
-  if (role !== 'developer_admin') {
+  if (role !== 'developer') {
     return res.status(403).json({
       success: false,
       error: { message: '仅管理员可重置监控统计' },

package/lib/http/routes/recipes.js

@@ -302,17 +302,109 @@ router.post('/batch-record-usage', asyncHandler(async (req, res) => {
 
 /**
  * POST /api/v1/recipes/discover-relations
- * AI 批量发现知识图谱关系（通过 ChatAgent discover_all_relations 任务）
+ * AI 批量发现知识图谱关系（异步后台任务）
  * Body: { batchSize?: number }
  */
+
+// 内存中的任务状态（单进程足够）
+const _discoverTask = { running: false, result: null, error: null, startedAt: null, finishedAt: null };
+
+// 10 分钟超时保护
+const DISCOVER_TIMEOUT_MS = 10 * 60 * 1000;
+
 router.post('/discover-relations', asyncHandler(async (req, res) => {
-  const { batchSize = 20 } = req.body;
+  if (_discoverTask.running) {
+    // 检查是否已超时
+    const elapsed = Date.now() - new Date(_discoverTask.startedAt).getTime();
+    if (elapsed > DISCOVER_TIMEOUT_MS) {
+      _discoverTask.running = false;
+      _discoverTask.error = `任务超时（运行 ${Math.round(elapsed / 1000)}s 后强制结束）`;
+      _discoverTask.finishedAt = new Date().toISOString();
+      return res.json({ success: true, data: { status: 'timeout', error: _discoverTask.error, startedAt: _discoverTask.startedAt } });
+    }
+    return res.json({ success: true, data: { status: 'running', startedAt: _discoverTask.startedAt, elapsed: Math.round(elapsed / 1000) } });
+  }
 
+  const { batchSize = 20 } = req.body;
   const container = getServiceContainer();
+
+  // 前置检查：ChatAgent 和 AI Provider 是否可用
   const chatAgent = container.get('chatAgent');
-  const result = await chatAgent.runTask('discover_all_relations', { batchSize });
+  if (!chatAgent) {
+    return res.status(503).json({ success: false, error: { message: 'ChatAgent 服务不可用，请检查服务配置' } });
+  }
 
-  res.json({ success: true, data: result });
+  const recipeService = container.get('recipeService');
+  if (!recipeService) {
+    return res.status(503).json({ success: false, error: { message: 'RecipeService 不可用' } });
+  }
+
+  // 检查是否有足够 Recipe
+  try {
+    const { items = [], data = [] } = await recipeService.listRecipes({}, { page: 1, pageSize: 5 });
+    const count = (items.length > 0 ? items : data).length;
+    if (count < 2) {
+      return res.json({ success: true, data: { status: 'empty', message: `当前只有 ${count} 条 Recipe，至少需要 2 条才能分析关系` } });
+    }
+  } catch (err) {
+    return res.status(500).json({ success: false, error: { message: `检查 Recipe 失败: ${err.message}` } });
+  }
+
+  _discoverTask.running = true;
+  _discoverTask.result = null;
+  _discoverTask.error = null;
+  _discoverTask.finishedAt = null;
+  _discoverTask.startedAt = new Date().toISOString();
+
+  // 后台执行，不阻塞请求
+  const timeoutHandle = setTimeout(() => {
+    if (_discoverTask.running) {
+      _discoverTask.running = false;
+      _discoverTask.error = '任务超时（超过 10 分钟）';
+      _discoverTask.finishedAt = new Date().toISOString();
+      logger.warn('discover-relations timed out');
+    }
+  }, DISCOVER_TIMEOUT_MS);
+
+  chatAgent.runTask('discover_all_relations', { batchSize })
+    .then(result => { _discoverTask.result = result; })
+    .catch(err => {
+      _discoverTask.error = err.message || String(err);
+      logger.error('discover-relations failed', { error: err.message });
+    })
+    .finally(() => {
+      clearTimeout(timeoutHandle);
+      _discoverTask.running = false;
+      _discoverTask.finishedAt = new Date().toISOString();
+    });
+
+  res.json({ success: true, data: { status: 'started', startedAt: _discoverTask.startedAt } });
+}));
+
+/**
+ * GET /api/v1/recipes/discover-relations/status
+ * 查询关系发现任务进度
+ */
+router.get('/discover-relations/status', asyncHandler(async (req, res) => {
+  const elapsed = _discoverTask.startedAt
+    ? Math.round((Date.now() - new Date(_discoverTask.startedAt).getTime()) / 1000)
+    : 0;
+
+  if (_discoverTask.running) {
+    return res.json({ success: true, data: { status: 'running', startedAt: _discoverTask.startedAt, elapsed } });
+  }
+  if (_discoverTask.error) {
+    return res.json({ success: true, data: { status: 'error', error: _discoverTask.error, startedAt: _discoverTask.startedAt, finishedAt: _discoverTask.finishedAt } });
+  }
+  if (_discoverTask.result) {
+    return res.json({ success: true, data: {
+      status: 'done',
+      ...(_discoverTask.result),
+      startedAt: _discoverTask.startedAt,
+      finishedAt: _discoverTask.finishedAt,
+    } });
+  }
+  res.json({ success: true, data: { status: 'idle' } });
 }));
 
 export default router;

package/lib/http/routes/search.js

@@ -155,31 +155,46 @@ router.get('/graph/all', asyncHandler(async (req, res) => {
     return res.json({ success: true, data: { edges: [], nodeLabels: {} } });
   }
 
-  const edges = graphService.getAllEdges(limit);
+  // 只返回 recipe 类型的关系边；module 依赖已由 /spm/dep-graph 提供
+  const nodeType = req.query.nodeType || 'recipe';
+  const edges = graphService.getAllEdges(limit, nodeType === 'all' ? undefined : nodeType);
 
-  // 收集节点 ID → 查 Recipe 标题用于节点标签
-  const nodeIds = new Set();
+  // 收集节点 ID + 类型 → 按类型查标签
+  const nodeMap = new Map(); // id → Set<type>
   for (const e of edges) {
-    nodeIds.add(e.fromId);
-    nodeIds.add(e.toId);
+    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 = {};
-  if (nodeIds.size > 0) {
-    try {
-      const recipeService = container.get('recipeService');
-      if (recipeService) {
-        for (const id of nodeIds) {
-          try {
-            const r = await recipeService.getRecipe(id);
-            if (r) nodeLabels[id] = r.title || r.name || id;
-          } catch { nodeLabels[id] = id; }
-        }
+  const nodeTypes = {};   // id → 主要类型（供前端区分渲染）
+  const nodeCategories = {};  // id → category/target 名（供前端分组布局）
+  if (nodeMap.size > 0) {
+    const recipeService = container.get('recipeService');
+    for (const [id, types] of nodeMap) {
+      // 记录节点主要类型
+      const primaryType = types.has('recipe') ? 'recipe' : [...types][0];
+      nodeTypes[id] = primaryType;
+
+      if (primaryType === 'recipe' && recipeService) {
+        // 仅 recipe 类型才查 recipeService
+        try {
+          const r = await recipeService.getRecipe(id);
+          if (r) {
+            nodeLabels[id] = r.title || r.name || id;
+            nodeCategories[id] = r.category || '';
+            continue;
+          }
+        } catch { /* not found – fall through */ }
       }
-    } catch { /* recipeService not available */ }
+      // module / candidate 或查不到的 recipe → 直接用 ID
+      nodeLabels[id] = id;
+    }
   }
 
-  res.json({ success: true, data: { edges, nodeLabels } });
+  res.json({ success: true, data: { edges, nodeLabels, nodeTypes, nodeCategories } });
 }));
 
 /**
@@ -194,27 +209,11 @@ router.get('/graph/stats', asyncHandler(async (req, res) => {
     return res.json({ success: true, data: { totalEdges: 0, byRelation: {}, nodeTypes: [] } });
   }
 
-  const stats = graphService.getStats();
+  const nodeType = req.query.nodeType || 'recipe';
+  const stats = graphService.getStats(nodeType === 'all' ? undefined : nodeType);
   res.json({ success: true, data: stats });
 }));
 
-/**
- * GET /api/v1/search/compliance
- * 合规评估报告
- */
-router.get('/compliance', asyncHandler(async (req, res) => {
-  const { period } = req.query;
-  const container = getServiceContainer();
-  const evaluator = container.get('complianceEvaluator');
-
-  if (!evaluator) {
-    return res.json({ success: true, data: { overallScore: 0, message: 'ComplianceEvaluator not available' } });
-  }
-
-  const report = evaluator.evaluate({ period });
-  res.json({ success: true, data: report });
-}));
-
 /**
  * POST /api/v1/search/trigger-from-code
  * Xcode trigger 搜索模拟 (stub — 功能未完整实现)

package/lib/injection/ServiceContainer.js

@@ -49,10 +49,10 @@ import { AutomationOrchestrator } from '../service/automation/AutomationOrchestr
 import { ToolRegistry } from '../service/chat/ToolRegistry.js';
 import { ChatAgent } from '../service/chat/ChatAgent.js';
 import { ALL_TOOLS } from '../service/chat/tools.js';
+import { SkillHooks } from '../service/skills/SkillHooks.js';
 
 // ─── P3: Infrastructure ──────────────────────────────
-import { EventBus } from '../infrastructure/event/EventBus.js';
-import { PluginManager } from '../infrastructure/plugin/PluginManager.js';
+// EventBus / PluginManager imports removed — source files retained for future use
 
 /**
  * DependencyInjection 容器
@@ -88,18 +88,10 @@ export class ServiceContainer {
       if (bootstrapComponents.gateway) {
         this.singletons.gateway = bootstrapComponents.gateway;
       }
-      if (bootstrapComponents.reasoningLogger) {
-        this.singletons.reasoningLogger = bootstrapComponents.reasoningLogger;
-      }
-      if (bootstrapComponents.roleDriftMonitor) {
-        this.singletons.roleDriftMonitor = bootstrapComponents.roleDriftMonitor;
-      }
-      if (bootstrapComponents.complianceEvaluator) {
-        this.singletons.complianceEvaluator = bootstrapComponents.complianceEvaluator;
-      }
-      if (bootstrapComponents.sessionManager) {
-        this.singletons.sessionManager = bootstrapComponents.sessionManager;
+      if (bootstrapComponents.constitution) {
+        this.singletons.constitution = bootstrapComponents.constitution;
       }
+
       if (bootstrapComponents.projectRoot) {
         this.singletons._projectRoot = bootstrapComponents.projectRoot;
       }
@@ -209,17 +201,7 @@ export class ServiceContainer {
       return this.singletons.gateway;
     });
 
-    // ReasoningLogger
-    this.register('reasoningLogger', () => this.singletons.reasoningLogger || null);
 
-    // RoleDriftMonitor
-    this.register('roleDriftMonitor', () => this.singletons.roleDriftMonitor || null);
-
-    // ComplianceEvaluator
-    this.register('complianceEvaluator', () => this.singletons.complianceEvaluator || null);
-
-    // SessionManager
-    this.register('sessionManager', () => this.singletons.sessionManager || null);
   }
 
   /**
@@ -257,11 +239,12 @@ export class ServiceContainer {
         const gateway = this.get('gateway');
         const projectRoot = this.singletons._projectRoot || process.cwd();
         const candidateFileWriter = new CandidateFileWriter(projectRoot);
+        const skillHooks = this.get('skillHooks');
         this.singletons.candidateService = new CandidateService(
           candidateRepository,
           auditLogger,
           gateway,
-          { fileWriter: candidateFileWriter }
+          { fileWriter: candidateFileWriter, skillHooks }
         );
       }
       return this.singletons.candidateService;
@@ -276,12 +259,13 @@ export class ServiceContainer {
         const knowledgeGraphService = this.get('knowledgeGraphService');
         const projectRoot = this.singletons._projectRoot || process.cwd();
         const fileWriter = new RecipeFileWriter(projectRoot);
+        const skillHooks = this.get('skillHooks');
         this.singletons.recipeService = new RecipeService(
           recipeRepository,
           auditLogger,
           gateway,
           knowledgeGraphService,
-          { fileWriter }
+          { fileWriter, skillHooks }
         );
       }
       return this.singletons.recipeService;
@@ -332,23 +316,12 @@ export class ServiceContainer {
       return this.singletons.guardCheckEngine;
     });
 
-    // ─── 新迁移的服务 ────────────────────────────────────
+    // ─── Constitution ────────────────────────────────────
+    this.register('constitution', () => this.singletons.constitution || null);
 
-    // EventBus
-    this.register('eventBus', () => {
-      if (!this.singletons.eventBus) {
-        this.singletons.eventBus = new EventBus();
-      }
-      return this.singletons.eventBus;
-    });
+    // ─── 新迁移的服务 ────────────────────────────────────
 
-    // PluginManager
-    this.register('pluginManager', () => {
-      if (!this.singletons.pluginManager) {
-        this.singletons.pluginManager = new PluginManager();
-      }
-      return this.singletons.pluginManager;
-    });
+    // EventBus / PluginManager — 已移除注册（源文件保留，未来可恢复）
 
     // RetrievalFunnel (Advanced Search)
     this.register('retrievalFunnel', () => {
@@ -518,6 +491,14 @@ export class ServiceContainer {
       }
       return this.singletons.chatAgent;
     });
+
+    // SkillHooks (Skill 生命周期钩子 — 加载 skills/*/hooks.js)
+    this.register('skillHooks', () => {
+      if (!this.singletons.skillHooks) {
+        this.singletons.skillHooks = new SkillHooks();
+      }
+      return this.singletons.skillHooks;
+    });
   }
 
   /**

package/lib/service/candidate/CandidateService.js

@@ -11,11 +11,12 @@ import { v4 as uuidv4 } from 'uuid';
  * 包括创建、批准、驳回和应用到 Recipe 的业务逻辑
  */
 export class CandidateService {
-  constructor(candidateRepository, auditLogger, gateway, { fileWriter } = {}) {
+  constructor(candidateRepository, auditLogger, gateway, { fileWriter, skillHooks } = {}) {
     this.candidateRepository = candidateRepository;
     this.auditLogger = auditLogger;
     this.gateway = gateway;
     this.fileWriter = fileWriter || null;
+    this.skillHooks = skillHooks || null;
     this.logger = Logger.getInstance();
   }
 
@@ -52,6 +53,16 @@ export class CandidateService {
         throw new ValidationError('Invalid candidate data');
       }
 
+      // ── SkillHooks: onCandidateSubmit ──
+      if (this.skillHooks) {
+        const hookResult = await this.skillHooks.run('onCandidateSubmit', candidate, {
+          userId: context.userId,
+        });
+        if (hookResult?.block) {
+          throw new ValidationError(`SkillHook blocked: ${hookResult.reason || 'unknown'}`);
+        }
+      }
+
       // 保存到数据库
       const created = await this.candidateRepository.create(candidate);