autosnippet 3.0.0 → 3.0.2

package/lib/http/routes/wiki.js

@@ -13,13 +13,13 @@
  *   GET    /api/v1/wiki/file/:path      — 读取某个 Wiki 文件内容
  */
 
-import express from 'express';
 import fs from 'node:fs';
 import path from 'node:path';
-import { asyncHandler } from '../middleware/errorHandler.js';
-import { getServiceContainer } from '../../injection/ServiceContainer.js';
-import { WikiGenerator, WikiPhase } from '../../service/wiki/WikiGenerator.js';
+import express from 'express';
 import Logger from '../../infrastructure/logging/Logger.js';
+import { getServiceContainer } from '../../injection/ServiceContainer.js';
+import { WikiGenerator } from '../../service/wiki/WikiGenerator.js';
+import { asyncHandler } from '../middleware/errorHandler.js';
 
 const router = express.Router();
 const logger = Logger.getInstance();
@@ -27,7 +27,7 @@ const logger = Logger.getInstance();
 /* ═══ 进程内 Wiki 任务状态 ═══════════════════════════════ */
 
 let wikiTask = {
-  status: 'idle',       // idle | running | done | error
+  status: 'idle', // idle | running | done | error
   phase: null,
   progress: 0,
   message: null,
@@ -58,29 +58,44 @@ function resetWikiTask() {
  * 创建 WikiGenerator 实例
  */
 function createGenerator(container) {
-  const projectRoot = container.singletons?._projectRoot
-    || process.env.ASD_PROJECT_DIR
-    || process.cwd();
+  const projectRoot =
+    container.singletons?._projectRoot || process.env.ASD_PROJECT_DIR || process.cwd();
 
   // 尝试获取可用的服务（非必须的优雅降级）
-  let spmService = null;
+  let moduleService = null;
   let knowledgeService = null;
   let codeEntityGraph = null;
 
-  try { spmService = container.get('spmService'); } catch { /* ok */ }
-  try { knowledgeService = container.get('knowledgeService'); } catch { /* ok */ }
-  try { codeEntityGraph = container.get('codeEntityGraph'); } catch { /* ok */ }
+  try {
+    moduleService = container.get('moduleService');
+  } catch {
+    /* ok */
+  }
+  try {
+    knowledgeService = container.get('knowledgeService');
+  } catch {
+    /* ok */
+  }
+  try {
+    codeEntityGraph = container.get('codeEntityGraph');
+  } catch {
+    /* ok */
+  }
 
   // 尝试获取已缓存的 ProjectGraph（可能在 bootstrap 中构建过）
-  let projectGraph = container.singletons?.projectGraph || null;
+  const projectGraph = container.singletons?.projectGraph || null;
 
   // 获取 RealtimeService 用于推送进度
   let realtimeService = null;
-  try { realtimeService = container.singletons?.realtimeService || null; } catch { /* ok */ }
+  try {
+    realtimeService = container.singletons?.realtimeService || null;
+  } catch {
+    /* ok */
+  }
 
   const generator = new WikiGenerator({
     projectRoot,
-    spmService,
+    moduleService,
     knowledgeService,
     projectGraph,
     codeEntityGraph,
@@ -99,7 +114,9 @@ function createGenerator(container) {
             message,
             timestamp: Date.now(),
           });
-        } catch { /* non-critical */ }
+        } catch {
+          /* non-critical */
+        }
       }
     },
     options: {
@@ -112,203 +129,227 @@ function createGenerator(container) {
 
 /* ═══ POST /api/v1/wiki/generate ═══════════════════════ */
 
-router.post('/generate', asyncHandler(async (req, res) => {
-  if (wikiTask.status === 'running') {
-    return res.status(409).json({
-      success: false,
-      error: { code: 'ALREADY_RUNNING', message: 'Wiki 生成正在进行中' },
-      data: { progress: wikiTask.progress, phase: wikiTask.phase },
-    });
-  }
+router.post(
+  '/generate',
+  asyncHandler(async (req, res) => {
+    if (wikiTask.status === 'running') {
+      return res.status(409).json({
+        success: false,
+        error: { code: 'ALREADY_RUNNING', message: 'Wiki 生成正在进行中' },
+        data: { progress: wikiTask.progress, phase: wikiTask.phase },
+      });
+    }
 
-  const container = getServiceContainer();
-  resetWikiTask();
+    const container = getServiceContainer();
+    resetWikiTask();
 
-  wikiTask.status = 'running';
-  wikiTask.startedAt = Date.now();
+    wikiTask.status = 'running';
+    wikiTask.startedAt = Date.now();
 
-  const generator = createGenerator(container);
-  currentGenerator = generator;
+    const generator = createGenerator(container);
+    currentGenerator = generator;
 
-  // 异步执行，立即返回 202
-  res.status(202).json({
-    success: true,
-    message: 'Wiki 生成已启动，通过 /api/v1/wiki/status 或 Socket.io wiki:progress 事件追踪进度',
-  });
+    // 异步执行，立即返回 202
+    res.status(202).json({
+      success: true,
+      message: 'Wiki 生成已启动，通过 /api/v1/wiki/status 或 Socket.io wiki:progress 事件追踪进度',
+    });
 
-  // 后台执行生成
-  try {
-    const result = await generator.generate();
-    wikiTask.status = result.success ? 'done' : 'error';
-    wikiTask.finishedAt = Date.now();
-    wikiTask.result = result;
-    if (!result.success) wikiTask.error = result.error;
-
-    // 推送完成事件
-    const realtimeService = container.singletons?.realtimeService || null;
-    if (realtimeService) {
-      realtimeService.broadcastEvent('wiki:completed', {
-        success: result.success,
-        filesGenerated: result.filesGenerated,
-        duration: result.duration,
-      });
+    // 后台执行生成
+    try {
+      const result = await generator.generate();
+      wikiTask.status = result.success ? 'done' : 'error';
+      wikiTask.finishedAt = Date.now();
+      wikiTask.result = result;
+      if (!result.success) {
+        wikiTask.error = result.error;
+      }
+
+      // 推送完成事件
+      const realtimeService = container.singletons?.realtimeService || null;
+      if (realtimeService) {
+        realtimeService.broadcastEvent('wiki:completed', {
+          success: result.success,
+          filesGenerated: result.filesGenerated,
+          duration: result.duration,
+        });
+      }
+    } catch (err) {
+      wikiTask.status = 'error';
+      wikiTask.finishedAt = Date.now();
+      wikiTask.error = err.message;
+      logger.error('[Wiki Route] Generation failed', { error: err.message });
     }
-  } catch (err) {
-    wikiTask.status = 'error';
-    wikiTask.finishedAt = Date.now();
-    wikiTask.error = err.message;
-    logger.error('[Wiki Route] Generation failed', { error: err.message });
-  }
 
-  currentGenerator = null;
-}));
+    currentGenerator = null;
+  })
+);
 
 /* ═══ POST /api/v1/wiki/update ═══════════════════════ */
 
-router.post('/update', asyncHandler(async (req, res) => {
-  if (wikiTask.status === 'running') {
-    return res.status(409).json({
-      success: false,
-      error: { code: 'ALREADY_RUNNING', message: 'Wiki 生成正在进行中' },
-    });
-  }
+router.post(
+  '/update',
+  asyncHandler(async (req, res) => {
+    if (wikiTask.status === 'running') {
+      return res.status(409).json({
+        success: false,
+        error: { code: 'ALREADY_RUNNING', message: 'Wiki 生成正在进行中' },
+      });
+    }
 
-  const container = getServiceContainer();
-  resetWikiTask();
+    const container = getServiceContainer();
+    resetWikiTask();
 
-  wikiTask.status = 'running';
-  wikiTask.startedAt = Date.now();
+    wikiTask.status = 'running';
+    wikiTask.startedAt = Date.now();
 
-  const generator = createGenerator(container);
-  currentGenerator = generator;
+    const generator = createGenerator(container);
+    currentGenerator = generator;
 
-  res.status(202).json({
-    success: true,
-    message: 'Wiki 增量更新已启动',
-  });
+    res.status(202).json({
+      success: true,
+      message: 'Wiki 增量更新已启动',
+    });
 
-  try {
-    const result = await generator.update();
-    wikiTask.status = result.success ? 'done' : 'error';
-    wikiTask.finishedAt = Date.now();
-    wikiTask.result = result;
-    if (!result.success) wikiTask.error = result.error;
-  } catch (err) {
-    wikiTask.status = 'error';
-    wikiTask.finishedAt = Date.now();
-    wikiTask.error = err.message;
-  }
+    try {
+      const result = await generator.update();
+      wikiTask.status = result.success ? 'done' : 'error';
+      wikiTask.finishedAt = Date.now();
+      wikiTask.result = result;
+      if (!result.success) {
+        wikiTask.error = result.error;
+      }
+    } catch (err) {
+      wikiTask.status = 'error';
+      wikiTask.finishedAt = Date.now();
+      wikiTask.error = err.message;
+    }
 
-  currentGenerator = null;
-}));
+    currentGenerator = null;
+  })
+);
 
 /* ═══ POST /api/v1/wiki/abort ═══════════════════════ */
 
-router.post('/abort', asyncHandler(async (req, res) => {
-  if (wikiTask.status !== 'running' || !currentGenerator) {
-    return res.json({ success: true, message: '没有正在运行的 Wiki 任务' });
-  }
+router.post(
+  '/abort',
+  asyncHandler(async (req, res) => {
+    if (wikiTask.status !== 'running' || !currentGenerator) {
+      return res.json({ success: true, message: '没有正在运行的 Wiki 任务' });
+    }
 
-  currentGenerator.abort();
-  wikiTask.status = 'error';
-  wikiTask.error = 'Aborted by user';
-  wikiTask.finishedAt = Date.now();
+    currentGenerator.abort();
+    wikiTask.status = 'error';
+    wikiTask.error = 'Aborted by user';
+    wikiTask.finishedAt = Date.now();
 
-  res.json({ success: true, message: 'Wiki 生成已中止' });
-}));
+    res.json({ success: true, message: 'Wiki 生成已中止' });
+  })
+);
 
 /* ═══ GET /api/v1/wiki/status ═══════════════════════ */
 
-router.get('/status', asyncHandler(async (req, res) => {
-  const container = getServiceContainer();
+router.get(
+  '/status',
+  asyncHandler(async (req, res) => {
+    const container = getServiceContainer();
+
+    // 如果没有活跃任务，从磁盘读取元数据
+    if (wikiTask.status === 'idle') {
+      const generator = createGenerator(container);
+      const diskStatus = generator.getStatus();
+      return res.json({
+        success: true,
+        data: {
+          task: wikiTask,
+          wiki: diskStatus,
+        },
+      });
+    }
 
-  // 如果没有活跃任务，从磁盘读取元数据
-  if (wikiTask.status === 'idle') {
-    const generator = createGenerator(container);
-    const diskStatus = generator.getStatus();
-    return res.json({
+    res.json({
       success: true,
       data: {
-        task: wikiTask,
-        wiki: diskStatus,
+        task: { ...wikiTask },
       },
     });
-  }
-
-  res.json({
-    success: true,
-    data: {
-      task: { ...wikiTask },
-    },
-  });
-}));
+  })
+);
 
 /* ═══ GET /api/v1/wiki/files ═══════════════════════ */
 
-router.get('/files', asyncHandler(async (req, res) => {
-  const projectRoot = process.env.ASD_PROJECT_DIR || process.cwd();
-  const wikiDir = path.join(projectRoot, 'AutoSnippet', 'wiki');
+router.get(
+  '/files',
+  asyncHandler(async (req, res) => {
+    const projectRoot = process.env.ASD_PROJECT_DIR || process.cwd();
+    const wikiDir = path.join(projectRoot, 'AutoSnippet', 'wiki');
 
-  if (!fs.existsSync(wikiDir)) {
-    return res.json({ success: true, data: { files: [], exists: false } });
-  }
+    if (!fs.existsSync(wikiDir)) {
+      return res.json({ success: true, data: { files: [], exists: false } });
+    }
 
-  const files = [];
-  const readDir = (dir, prefix = '') => {
-    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-      const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
-      if (entry.isDirectory()) {
-        readDir(path.join(dir, entry.name), rel);
-      } else if (entry.name.endsWith('.md')) {
-        const stat = fs.statSync(path.join(dir, entry.name));
-        files.push({
-          path: rel,
-          name: entry.name,
-          size: stat.size,
-          modifiedAt: stat.mtime.toISOString(),
-        });
+    const files = [];
+    const readDir = (dir, prefix = '') => {
+      for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
+        if (entry.isDirectory()) {
+          readDir(path.join(dir, entry.name), rel);
+        } else if (entry.name.endsWith('.md')) {
+          const stat = fs.statSync(path.join(dir, entry.name));
+          files.push({
+            path: rel,
+            name: entry.name,
+            size: stat.size,
+            modifiedAt: stat.mtime.toISOString(),
+          });
+        }
       }
-    }
-  };
+    };
 
-  readDir(wikiDir);
+    readDir(wikiDir);
 
-  res.json({
-    success: true,
-    data: { files, exists: true, wikiDir },
-  });
-}));
+    res.json({
+      success: true,
+      data: { files, exists: true, wikiDir },
+    });
+  })
+);
 
 /* ═══ GET /api/v1/wiki/file/:path(*) ═══════════════ */
 
-router.get('/file/*', asyncHandler(async (req, res) => {
-  const projectRoot = process.env.ASD_PROJECT_DIR || process.cwd();
-  const wikiDir = path.join(projectRoot, 'AutoSnippet', 'wiki');
-  const requestedPath = req.params[0];
+router.get(
+  '/file/*',
+  asyncHandler(async (req, res) => {
+    const projectRoot = process.env.ASD_PROJECT_DIR || process.cwd();
+    const wikiDir = path.join(projectRoot, 'AutoSnippet', 'wiki');
+    const requestedPath = req.params[0];
 
-  if (!requestedPath) {
-    return res.status(400).json({ success: false, error: { message: 'path required' } });
-  }
+    if (!requestedPath) {
+      return res.status(400).json({ success: false, error: { message: 'path required' } });
+    }
 
-  // 安全检查：防止路径穿越
-  const fullPath = path.resolve(wikiDir, requestedPath);
-  if (!fullPath.startsWith(wikiDir)) {
-    return res.status(403).json({ success: false, error: { message: 'Path traversal not allowed' } });
-  }
+    // 安全检查：防止路径穿越
+    const fullPath = path.resolve(wikiDir, requestedPath);
+    if (!fullPath.startsWith(wikiDir)) {
+      return res
+        .status(403)
+        .json({ success: false, error: { message: 'Path traversal not allowed' } });
+    }
 
-  if (!fs.existsSync(fullPath)) {
-    return res.status(404).json({ success: false, error: { message: 'File not found' } });
-  }
+    if (!fs.existsSync(fullPath)) {
+      return res.status(404).json({ success: false, error: { message: 'File not found' } });
+    }
 
-  const content = fs.readFileSync(fullPath, 'utf-8');
-  res.json({
-    success: true,
-    data: {
-      path: requestedPath,
-      content,
-      size: Buffer.byteLength(content),
-    },
-  });
-}));
+    const content = fs.readFileSync(fullPath, 'utf-8');
+    res.json({
+      success: true,
+      data: {
+        path: requestedPath,
+        content,
+        size: Buffer.byteLength(content),
+      },
+    });
+  })
+);
 
 export default router;

package/lib/http/utils/routeHelpers.js

@@ -26,6 +26,8 @@ export function getContext(req) {
  */
 export function safeInt(value, defaultValue, min = 1, max = 1000) {
   const parsed = parseInt(value, 10);
-  if (Number.isNaN(parsed)) return defaultValue;
+  if (Number.isNaN(parsed)) {
+    return defaultValue;
+  }
   return Math.max(min, Math.min(max, parsed));
 }

package/lib/http/utils/sse-sessions.js

@@ -13,7 +13,7 @@
  * @module lib/http/utils/sse-sessions
  */
 
-import { EventEmitter } from 'events';
+import { EventEmitter } from 'node:events';
 
 /** @type {Map<string, StreamSession>} */
 const _sessions = new Map();
@@ -59,14 +59,18 @@ export function createStreamSession(scene) {
      * @param {object} [donePayload={}]
      */
     end(donePayload = {}) {
-      if (session.completed) return;
+      if (session.completed) {
+        return;
+      }
       const payload = { type: 'stream:done', ts: Date.now(), ...donePayload };
       session.buffer.push(payload);
       emitter.emit('event', payload);
       session.completed = true;
       // 完成后保留一段时间供客户端重连
       const keepTimer = setTimeout(() => _sessions.delete(sessionId), COMPLETED_KEEP);
-      if (keepTimer.unref) keepTimer.unref();
+      if (keepTimer.unref) {
+        keepTimer.unref();
+      }
     },
 
     /**
@@ -75,13 +79,17 @@ export function createStreamSession(scene) {
      * @param {string} [code]
      */
     error(message, code) {
-      if (session.completed) return;
+      if (session.completed) {
+        return;
+      }
       const payload = { type: 'stream:error', ts: Date.now(), message, code };
       session.buffer.push(payload);
       emitter.emit('event', payload);
       session.completed = true;
       const keepTimer = setTimeout(() => _sessions.delete(sessionId), COMPLETED_KEEP);
-      if (keepTimer.unref) keepTimer.unref();
+      if (keepTimer.unref) {
+        keepTimer.unref();
+      }
     },
 
     /**
@@ -99,7 +107,9 @@ export function createStreamSession(scene) {
 
   // 硬性 TTL: 无论是否完成，5 分钟后强制清理
   const ttlTimer = setTimeout(() => _sessions.delete(sessionId), SESSION_TTL);
-  if (ttlTimer.unref) ttlTimer.unref();
+  if (ttlTimer.unref) {
+    ttlTimer.unref();
+  }
 
   return session;
 }

package/lib/http/utils/sse.js

@@ -42,7 +42,9 @@ export function createSSESession(req, res, scene) {
 
   /** 安全写入一段 SSE 数据 */
   function _write(data) {
-    if (disconnected || res.writableEnded) return false;
+    if (disconnected || res.writableEnded) {
+      return false;
+    }
     try {
       return res.write(data);
     } catch {
@@ -74,7 +76,9 @@ export function createSSESession(req, res, scene) {
      * @param {object} event — 必须包含 type 字段
      */
     send(event) {
-      if (disconnected || res.writableEnded) return;
+      if (disconnected || res.writableEnded) {
+        return;
+      }
       const payload = JSON.stringify({ ...event, ts: event.ts || Date.now() });
       _write(`data: ${payload}\n\n`);
       metrics.eventCount++;
@@ -90,7 +94,9 @@ export function createSSESession(req, res, scene) {
      */
     end(donePayload = {}) {
       clearInterval(heartbeat);
-      if (disconnected || res.writableEnded) return;
+      if (disconnected || res.writableEnded) {
+        return;
+      }
       const payload = JSON.stringify({ type: 'stream:done', ts: Date.now(), ...donePayload });
       _write(`data: ${payload}\n\n`);
       res.end();
@@ -103,14 +109,18 @@ export function createSSESession(req, res, scene) {
      */
     error(message, code) {
       clearInterval(heartbeat);
-      if (disconnected || res.writableEnded) return;
+      if (disconnected || res.writableEnded) {
+        return;
+      }
       const payload = JSON.stringify({ type: 'stream:error', ts: Date.now(), message, code });
       _write(`data: ${payload}\n\n`);
       res.end();
     },
 
     /** 是否已断开 */
-    get isDisconnected() { return disconnected; },
+    get isDisconnected() {
+      return disconnected;
+    },
 
     /** 会话 ID */
     sessionId,

package/lib/infrastructure/audit/AuditLogger.js

@@ -17,8 +17,11 @@ export class AuditLogger {
    */
   async log(entry) {
     // 兼容 Service 层传入 resourceType + resourceId（而非 resource）
-    const resource = entry.resource
-      || (entry.resourceType && entry.resourceId ? `${entry.resourceType}:${entry.resourceId}` : undefined);
+    const resource =
+      entry.resource ||
+      (entry.resourceType && entry.resourceId
+        ? `${entry.resourceType}:${entry.resourceId}`
+        : undefined);
 
     // 兼容 Service 层传入 details（而非 data）
     const data = entry.data || (entry.details ? { details: entry.details } : {});

package/lib/infrastructure/audit/AuditStore.js

@@ -144,11 +144,15 @@ export class AuditStore {
 
     // 成功/失败统计
     const successCount = this.db
-      .prepare("SELECT COUNT(*) as count FROM audit_logs WHERE timestamp >= ? AND result = 'success'")
+      .prepare(
+        "SELECT COUNT(*) as count FROM audit_logs WHERE timestamp >= ? AND result = 'success'"
+      )
       .get(startTime);
 
     const failureCount = this.db
-      .prepare("SELECT COUNT(*) as count FROM audit_logs WHERE timestamp >= ? AND result = 'failure'")
+      .prepare(
+        "SELECT COUNT(*) as count FROM audit_logs WHERE timestamp >= ? AND result = 'failure'"
+      )
       .get(startTime);
 
     // 按角色统计
@@ -187,8 +191,9 @@ export class AuditStore {
       total: total.count,
       success: successCount.count,
       failure: failureCount.count,
-      successRate: total.count > 0 ? (successCount.count / total.count * 100).toFixed(2) + '%' : '0%',
-      avgDuration: avgDuration.avg_duration ? Math.round(avgDuration.avg_duration) + 'ms' : 'N/A',
+      successRate:
+        total.count > 0 ? `${((successCount.count / total.count) * 100).toFixed(2)}%` : '0%',
+      avgDuration: avgDuration.avg_duration ? `${Math.round(avgDuration.avg_duration)}ms` : 'N/A',
       byActor,
       byAction,
     };
@@ -203,9 +208,7 @@ export class AuditStore {
   cleanup({ maxAgeDays = 90 } = {}) {
     try {
       const cutoff = Date.now() - maxAgeDays * 86400000;
-      const result = this.db.prepare(
-        'DELETE FROM audit_logs WHERE timestamp < ?'
-      ).run(cutoff);
+      const result = this.db.prepare('DELETE FROM audit_logs WHERE timestamp < ?').run(cutoff);
       return { deleted: result.changes || 0 };
     } catch {
       return { deleted: 0 };

package/lib/infrastructure/cache/CacheService.js

@@ -19,7 +19,9 @@ export class CacheService {
     this.cleanupInterval = setInterval(() => {
       this.cleanupExpired();
     }, 60000);
-    if (this.cleanupInterval.unref) this.cleanupInterval.unref();
+    if (this.cleanupInterval.unref) {
+      this.cleanupInterval.unref();
+    }
   }
 
   /**