autosnippet 3.2.21 → 3.3.2

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

@@ -0,0 +1,51 @@
+/**
+ * Audit Log API 路由
+ *
+ * 端点:
+ *   GET /api/v1/audit — 查询审计日志
+ */
+import express from 'express';
+import { getServiceContainer } from '../../injection/ServiceContainer.js';
+const router = express.Router();
+/**
+ * GET /api/v1/audit
+ * 查询审计日志，支持按 actor/action/result/时间范围过滤
+ *
+ * Query params:
+ *   actor     — 操作人过滤
+ *   action    — 操作类型过滤
+ *   result    — 结果过滤 (success|failure)
+ *   startDate — 起始时间戳 (毫秒)
+ *   endDate   — 结束时间戳 (毫秒)
+ *   limit     — 返回条数上限 (默认 100, 最大 500)
+ */
+router.get('/', async (req, res) => {
+    try {
+        const container = getServiceContainer();
+        const auditStore = container.get('auditStore');
+        if (!auditStore) {
+            res.status(503).json({
+                success: false,
+                error: { code: 'SERVICE_UNAVAILABLE', message: 'AuditStore not available' },
+            });
+            return;
+        }
+        const limit = Math.min(Number(req.query.limit) || 100, 500);
+        const logs = auditStore.query({
+            actor: req.query.actor,
+            action: req.query.action,
+            result: req.query.result,
+            startDate: req.query.startDate ? Number(req.query.startDate) : undefined,
+            endDate: req.query.endDate ? Number(req.query.endDate) : undefined,
+            limit,
+        });
+        res.json({ success: true, data: { logs, total: logs.length } });
+    }
+    catch (err) {
+        res.status(500).json({
+            success: false,
+            error: { code: 'AUDIT_ERROR', message: err.message },
+        });
+    }
+});
+export default router;

package/dist/lib/http/routes/commands.d.ts

@@ -1,6 +1,6 @@
 /**
  * Commands API 路由
- * 执行 Install (同步 Snippet 到 IDE)、SPM Map 刷新、Embed (重建索引) 等命令
+ * 执行 Module Map 刷新、Embed (重建索引) 等命令
  */
 declare const router: import("express-serve-static-core").Router;
 export default router;

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

@@ -1,6 +1,6 @@
 /**
  * Commands API 路由
- * 执行 Install (同步 Snippet 到 IDE)、SPM Map 刷新、Embed (重建索引) 等命令
+ * 执行 Module Map 刷新、Embed (重建索引) 等命令
  */
 import express from 'express';
 import Logger from '../../infrastructure/logging/Logger.js';
@@ -9,56 +9,6 @@ import { FileReadQuery, FileSaveBody } from '../../shared/schemas/http-requests.
 import { validate, validateQuery } from '../middleware/validate.js';
 const router = express.Router();
 const logger = Logger.getInstance();
-/**
- * POST /api/v1/commands/install
- * 从 Recipe 生成并同步 Snippet 到 IDE
- * Body: { target?: 'xcode' | 'vscode' | 'all' }
- */
-router.post('/install', async (req, res) => {
-    const container = getServiceContainer();
-    const knowledgeRepository = container.get('knowledgeRepository');
-    const target = req.body?.target || 'all';
-    // 获取所有活跃 Recipe（V3: lifecycle='active' 即 Recipe）
-    const result = await knowledgeRepository.findWithPagination({ lifecycle: 'active' }, { page: 1, pageSize: 9999 });
-    const recipes = (result?.data ??
-        result?.items ??
-        [])
-        .map((r) => ({
-        id: r.id,
-        title: r.title,
-        trigger: r.trigger,
-        code: r.content?.pattern || '',
-        description: r.description || r.summaryCn || '',
-        language: r.language || 'unknown',
-    }))
-        .filter((r) => String(r.code).trim().length > 0);
-    const installResults = {};
-    // Xcode
-    if ((target === 'all' || target === 'xcode') && process.platform === 'darwin') {
-        try {
-            const xcodeInstaller = container.get('snippetInstaller');
-            installResults.xcode = xcodeInstaller.installFromRecipes(recipes);
-        }
-        catch (e) {
-            installResults.xcode = { success: false, error: e.message };
-        }
-    }
-    // VSCode
-    if (target === 'all' || target === 'vscode') {
-        try {
-            const vscodeInstaller = container.get('vscodeSnippetInstaller');
-            installResults.vscode = vscodeInstaller.installFromRecipes(recipes);
-        }
-        catch (e) {
-            installResults.vscode = { success: false, error: e.message };
-        }
-    }
-    logger.info('Snippets installed via dashboard', { target, results: installResults });
-    res.json({
-        success: true,
-        data: installResults,
-    });
-});
 /**
  * POST /api/v1/commands/spm-map
  * 执行 SPM 依赖映射刷新（向后兼容）
@@ -126,24 +76,9 @@ router.post('/embed', async (req, res) => {
 router.get('/status', async (req, res) => {
     const container = getServiceContainer();
     const status = {
-        snippets: { xcode: { synced: false }, vscode: { synced: false } },
         index: { ready: false },
         spmMap: { available: false },
     };
-    try {
-        const snippetInstaller = container.get('snippetInstaller');
-        status.snippets.xcode.synced = (await snippetInstaller.listInstalled?.())?.length > 0;
-    }
-    catch {
-        /* ignore */
-    }
-    try {
-        const vscodeInstaller = container.get('vscodeSnippetInstaller');
-        status.snippets.vscode.synced = (await vscodeInstaller.listInstalled?.())?.length > 0;
-    }
-    catch {
-        /* ignore */
-    }
     try {
         const indexingPipeline = container.get('indexingPipeline');
         status.index.ready = true; // IndexingPipeline is available

package/dist/lib/http/routes/guardReport.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Guard Report API 路由
+ *
+ * 端点:
+ *   GET /api/v1/guard/report           — 项目合规性报告（ComplianceReporter + Uncertainty）
+ *   GET /api/v1/guard/report/reverse   — ReverseGuard 反向验证
+ *   GET /api/v1/guard/report/coverage  — CoverageAnalyzer 覆盖率矩阵
+ */
+declare const router: import("express-serve-static-core").Router;
+export default router;

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

@@ -0,0 +1,143 @@
+/**
+ * Guard Report API 路由
+ *
+ * 端点:
+ *   GET /api/v1/guard/report           — 项目合规性报告（ComplianceReporter + Uncertainty）
+ *   GET /api/v1/guard/report/reverse   — ReverseGuard 反向验证
+ *   GET /api/v1/guard/report/coverage  — CoverageAnalyzer 覆盖率矩阵
+ */
+import express from 'express';
+import { getServiceContainer } from '../../injection/ServiceContainer.js';
+import { resolveProjectRoot } from '../../shared/resolveProjectRoot.js';
+const router = express.Router();
+/**
+ * GET /api/v1/guard/report
+ * 生成完整的合规性报告，含 uncertain/coverage/confidence
+ *
+ * Query params:
+ *   minScore   — 最低通过分数 (默认 60)
+ *   maxErrors  — 最大错误数 (默认 0)
+ *   maxFiles   — 扫描文件上限
+ */
+router.get('/', async (req, res) => {
+    try {
+        const container = getServiceContainer();
+        const complianceReporter = container.get('complianceReporter');
+        if (!complianceReporter) {
+            res.status(503).json({
+                success: false,
+                error: { code: 'SERVICE_UNAVAILABLE', message: 'ComplianceReporter not available' },
+            });
+            return;
+        }
+        const projectRoot = resolveProjectRoot(container);
+        const qualityGate = {
+            minScore: req.query.minScore ? Number(req.query.minScore) : undefined,
+            maxErrors: req.query.maxErrors ? Number(req.query.maxErrors) : undefined,
+        };
+        const maxFiles = req.query.maxFiles ? Number(req.query.maxFiles) : undefined;
+        const report = await complianceReporter.generate(projectRoot, {
+            qualityGate,
+            maxFiles,
+        });
+        res.json({ success: true, data: report });
+    }
+    catch (err) {
+        res.status(500).json({
+            success: false,
+            error: { code: 'GUARD_REPORT_ERROR', message: err.message },
+        });
+    }
+});
+/**
+ * GET /api/v1/guard/report/reverse
+ * ReverseGuard — Recipe→Code 反向验证
+ *
+ * Query params:
+ *   maxFiles — 扫描文件上限 (默认 200)
+ */
+router.get('/reverse', async (req, res) => {
+    try {
+        const container = getServiceContainer();
+        const projectRoot = resolveProjectRoot(container);
+        const { ReverseGuard } = await import('../../service/guard/ReverseGuard.js');
+        const { collectSourceFilesWithContent } = await import('../../service/guard/SourceFileCollector.js');
+        let reverseGuard;
+        try {
+            reverseGuard = container.get('reverseGuard');
+        }
+        catch {
+            const db = container.get('database');
+            reverseGuard = new ReverseGuard(db.getDb());
+        }
+        const maxFiles = req.query.maxFiles ? Number(req.query.maxFiles) : 200;
+        const projectFiles = await collectSourceFilesWithContent(projectRoot, { maxFiles });
+        const results = reverseGuard.auditAllRules(projectFiles);
+        const drifts = reverseGuard.getDriftResults(results);
+        res.json({
+            success: true,
+            data: {
+                totalRecipes: results.length,
+                healthy: results.filter((r) => r.recommendation === 'healthy').length,
+                investigate: results.filter((r) => r.recommendation === 'investigate').length,
+                decay: results.filter((r) => r.recommendation === 'decay').length,
+                drifts,
+                allResults: results.map((r) => ({
+                    recipeId: r.recipeId,
+                    title: r.title,
+                    recommendation: r.recommendation,
+                    signalCount: r.signals.length,
+                })),
+            },
+        });
+    }
+    catch (err) {
+        res.status(500).json({
+            success: false,
+            error: { code: 'REVERSE_GUARD_ERROR', message: err.message },
+        });
+    }
+});
+/**
+ * GET /api/v1/guard/report/coverage
+ * CoverageAnalyzer — 模块覆盖率矩阵
+ */
+router.get('/coverage', async (_req, res) => {
+    try {
+        const container = getServiceContainer();
+        const { CoverageAnalyzer } = await import('../../service/guard/CoverageAnalyzer.js');
+        let analyzer;
+        try {
+            analyzer = container.get('coverageAnalyzer');
+        }
+        catch {
+            const db = container.get('database');
+            analyzer = new CoverageAnalyzer(db.getDb());
+        }
+        // 从 Panorama 或目录结构获取模块文件
+        const moduleFiles = new Map();
+        try {
+            const panorama = container.get('panoramaService');
+            const overview = panorama.getOverview();
+            if (overview?.modules) {
+                for (const mod of overview.modules) {
+                    if (mod.files?.length > 0) {
+                        moduleFiles.set(mod.name, mod.files);
+                    }
+                }
+            }
+        }
+        catch {
+            /* PanoramaService not available */
+        }
+        const matrix = analyzer.analyze(moduleFiles);
+        res.json({ success: true, data: matrix });
+    }
+    catch (err) {
+        res.status(500).json({
+            success: false,
+            error: { code: 'COVERAGE_ANALYZER_ERROR', message: err.message },
+        });
+    }
+});
+export default router;

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

@@ -109,6 +109,37 @@ router.get('/stats', async (req, res) => {
     const stats = await knowledgeService.getStats();
     res.json({ success: true, data: stats });
 });
+/**
+ * GET /api/v1/knowledge/lifecycle
+ * 获取六态生命周期统计 + 各状态条目列表
+ */
+router.get('/lifecycle', async (req, res) => {
+    const container = getServiceContainer();
+    const knowledgeService = container.get('knowledgeService');
+    const stats = await knowledgeService.getStats();
+    const states = ['pending', 'staging', 'active', 'evolving', 'decaying', 'deprecated'];
+    const lifecycle = {
+        counts: {},
+        entries: {},
+    };
+    const counts = lifecycle.counts;
+    for (const state of states) {
+        counts[state] = stats?.[state] ?? 0;
+    }
+    // 仅对过渡态（staging / evolving / decaying）返回条目详情
+    const transitionalStates = ['staging', 'evolving', 'decaying'];
+    const entries = lifecycle.entries;
+    for (const state of transitionalStates) {
+        if (counts[state] > 0) {
+            const result = await knowledgeService.list({ lifecycle: state }, { page: 1, pageSize: 20 });
+            entries[state] = result.items ?? [];
+        }
+        else {
+            entries[state] = [];
+        }
+    }
+    res.json({ success: true, data: lifecycle });
+});
 /**
  * GET /api/v1/knowledge/:id
  * 获取知识条目详情
@@ -160,7 +191,7 @@ router.delete('/:id', requirePermission('knowledge', 'delete'), async (req, res)
     const result = await knowledgeService.delete(id, context);
     res.json({ success: true, data: result });
 });
-/* ═══ 生命周期操作（3 状态: pending / active / deprecated）═══ */
+/* ═══ 生命周期操作（6 态: pending / staging / active / evolving / decaying / deprecated）═══ */
 /**
  * PATCH /api/v1/knowledge/:id/publish
  * 发布 (pending → active) — 仅开发者

package/dist/lib/http/routes/panorama.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Panorama API 路由
+ *
+ * 端点:
+ *   GET /api/v1/panorama          — 项目全景概览
+ *   GET /api/v1/panorama/health   — 全景健康度
+ *   GET /api/v1/panorama/gaps     — 知识空白区
+ *   GET /api/v1/panorama/module/:name — 单模块详情
+ */
+declare const router: import("express-serve-static-core").Router;
+export default router;

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

@@ -0,0 +1,322 @@
+/**
+ * Panorama API 路由
+ *
+ * 端点:
+ *   GET /api/v1/panorama          — 项目全景概览
+ *   GET /api/v1/panorama/health   — 全景健康度
+ *   GET /api/v1/panorama/gaps     — 知识空白区
+ *   GET /api/v1/panorama/module/:name — 单模块详情
+ */
+import express from 'express';
+import { getServiceContainer } from '../../injection/ServiceContainer.js';
+const router = express.Router();
+/**
+ * GET /api/v1/panorama
+ * 返回项目全景概览（层级、模块、覆盖率）
+ */
+router.get('/', async (_req, res) => {
+    try {
+        const container = getServiceContainer();
+        const panoramaService = container.get('panoramaService');
+        if (!panoramaService) {
+            res.status(503).json({
+                success: false,
+                error: { code: 'SERVICE_UNAVAILABLE', message: 'PanoramaService not available' },
+            });
+            return;
+        }
+        if (typeof panoramaService.ensureData === 'function') {
+            await panoramaService.ensureData();
+        }
+        const overview = panoramaService.getOverview();
+        res.json({ success: true, data: overview });
+    }
+    catch (err) {
+        res.status(500).json({
+            success: false,
+            error: { code: 'PANORAMA_ERROR', message: err.message },
+        });
+    }
+});
+/**
+ * GET /api/v1/panorama/health
+ * 返回全景健康度评分
+ */
+router.get('/health', async (_req, res) => {
+    try {
+        const container = getServiceContainer();
+        const panoramaService = container.get('panoramaService');
+        if (!panoramaService) {
+            res.status(503).json({
+                success: false,
+                error: { code: 'SERVICE_UNAVAILABLE', message: 'PanoramaService not available' },
+            });
+            return;
+        }
+        if (typeof panoramaService.ensureData === 'function') {
+            await panoramaService.ensureData();
+        }
+        const health = panoramaService.getHealth();
+        res.json({ success: true, data: health });
+    }
+    catch (err) {
+        res.status(500).json({
+            success: false,
+            error: { code: 'PANORAMA_ERROR', message: err.message },
+        });
+    }
+});
+/**
+ * GET /api/v1/panorama/gaps
+ * 返回知识空白区列表
+ */
+router.get('/gaps', async (_req, res) => {
+    try {
+        const container = getServiceContainer();
+        const panoramaService = container.get('panoramaService');
+        if (!panoramaService) {
+            res.status(503).json({
+                success: false,
+                error: { code: 'SERVICE_UNAVAILABLE', message: 'PanoramaService not available' },
+            });
+            return;
+        }
+        if (typeof panoramaService.ensureData === 'function') {
+            await panoramaService.ensureData();
+        }
+        const gaps = panoramaService.getGaps();
+        res.json({ success: true, data: gaps });
+    }
+    catch (err) {
+        res.status(500).json({
+            success: false,
+            error: { code: 'PANORAMA_ERROR', message: err.message },
+        });
+    }
+});
+/**
+ * GET /api/v1/panorama/coverage
+ * 返回各模块知识覆盖率热力图数据
+ */
+router.get('/coverage', async (_req, res) => {
+    try {
+        const container = getServiceContainer();
+        const panoramaService = container.get('panoramaService');
+        if (!panoramaService) {
+            res.status(503).json({
+                success: false,
+                error: { code: 'SERVICE_UNAVAILABLE', message: 'PanoramaService not available' },
+            });
+            return;
+        }
+        if (typeof panoramaService.ensureData === 'function') {
+            await panoramaService.ensureData();
+        }
+        const overview = panoramaService.getOverview();
+        const gaps = panoramaService.getGaps?.() ?? [];
+        // 构建模块级覆盖率数据：从 overview.layers 中提取每个模块的文件数和 recipe 数
+        const modules = [];
+        for (const layer of overview.layers || []) {
+            const layerModules = layer.modules || [];
+            for (const mod of layerModules) {
+                const fileCount = mod.fileCount || 0;
+                const recipeCount = mod.recipeCount || 0;
+                const coverage = fileCount > 0 ? Math.round((recipeCount / fileCount) * 100) : 0;
+                modules.push({
+                    name: mod.name || 'unknown',
+                    layer: layer.name,
+                    fileCount,
+                    recipeCount,
+                    coverage: Math.min(coverage, 100),
+                });
+            }
+        }
+        // 按覆盖率升序（低覆盖在前，方便高亮）
+        modules.sort((a, b) => a.coverage - b.coverage);
+        // 空白区按维度聚合
+        const gapsByDimension = {};
+        for (const gap of gaps) {
+            const dim = gap.dimensionName || 'unknown';
+            gapsByDimension[dim] = (gapsByDimension[dim] || 0) + 1;
+        }
+        res.json({
+            success: true,
+            data: {
+                modules,
+                gapsByDimension,
+                overallCoverage: overview.overallCoverage ?? 0,
+                totalFiles: overview.totalFiles ?? 0,
+                totalRecipes: overview.totalRecipes ?? 0,
+            },
+        });
+    }
+    catch (err) {
+        res.status(500).json({
+            success: false,
+            error: { code: 'PANORAMA_ERROR', message: err.message },
+        });
+    }
+});
+/**
+ * GET /api/v1/panorama/module/:name
+ * 返回单模块详情
+ */
+router.get('/module/:name', async (req, res) => {
+    try {
+        const container = getServiceContainer();
+        const panoramaService = container.get('panoramaService');
+        if (!panoramaService) {
+            res.status(503).json({
+                success: false,
+                error: { code: 'SERVICE_UNAVAILABLE', message: 'PanoramaService not available' },
+            });
+            return;
+        }
+        if (typeof panoramaService.ensureData === 'function') {
+            await panoramaService.ensureData();
+        }
+        const detail = panoramaService.getModule(req.params.name);
+        if (!detail) {
+            res.status(404).json({
+                success: false,
+                error: { code: 'MODULE_NOT_FOUND', message: `Module "${req.params.name}" not found` },
+            });
+            return;
+        }
+        res.json({ success: true, data: detail });
+    }
+    catch (err) {
+        res.status(500).json({
+            success: false,
+            error: { code: 'PANORAMA_ERROR', message: err.message },
+        });
+    }
+});
+/* ═══ 治理 (Governance) ═══════════════════════════════════════ */
+/**
+ * POST /api/v1/panorama/governance/cycle
+ * 执行完整治理周期（矛盾检测 + 冗余分析 + 衰退扫描）
+ */
+router.post('/governance/cycle', async (_req, res) => {
+    try {
+        const container = getServiceContainer();
+        const metabolism = container.get('knowledgeMetabolism');
+        if (!metabolism) {
+            res.status(503).json({
+                success: false,
+                error: { code: 'SERVICE_UNAVAILABLE', message: 'KnowledgeMetabolism not available' },
+            });
+            return;
+        }
+        const report = metabolism.runFullCycle();
+        res.json({ success: true, data: report });
+    }
+    catch (err) {
+        res.status(500).json({
+            success: false,
+            error: { code: 'GOVERNANCE_ERROR', message: err.message },
+        });
+    }
+});
+/**
+ * GET /api/v1/panorama/governance/decay
+ * 获取衰退评估报告
+ */
+router.get('/governance/decay', async (_req, res) => {
+    try {
+        const container = getServiceContainer();
+        const decayDetector = container.get('decayDetector');
+        if (!decayDetector) {
+            res.status(503).json({
+                success: false,
+                error: { code: 'SERVICE_UNAVAILABLE', message: 'DecayDetector not available' },
+            });
+            return;
+        }
+        const results = decayDetector.scanAll();
+        res.json({ success: true, data: { results } });
+    }
+    catch (err) {
+        res.status(500).json({
+            success: false,
+            error: { code: 'GOVERNANCE_ERROR', message: err.message },
+        });
+    }
+});
+/**
+ * POST /api/v1/panorama/governance/staging-check
+ * 检查 staging 条目并自动发布到期的
+ */
+router.post('/governance/staging-check', async (_req, res) => {
+    try {
+        const container = getServiceContainer();
+        const stagingManager = container.get('stagingManager');
+        if (!stagingManager) {
+            res.status(503).json({
+                success: false,
+                error: { code: 'SERVICE_UNAVAILABLE', message: 'StagingManager not available' },
+            });
+            return;
+        }
+        const checkResult = stagingManager.checkAndPromote();
+        const currentStaging = stagingManager.listStaging();
+        res.json({ success: true, data: { checkResult, currentStaging } });
+    }
+    catch (err) {
+        res.status(500).json({
+            success: false,
+            error: { code: 'GOVERNANCE_ERROR', message: err.message },
+        });
+    }
+});
+/**
+ * GET /api/v1/panorama/governance/staging
+ * 获取当前 staging 列表（只读）
+ */
+router.get('/governance/staging', async (_req, res) => {
+    try {
+        const container = getServiceContainer();
+        const stagingManager = container.get('stagingManager');
+        if (!stagingManager) {
+            res.status(503).json({
+                success: false,
+                error: { code: 'SERVICE_UNAVAILABLE', message: 'StagingManager not available' },
+            });
+            return;
+        }
+        const entries = stagingManager.listStaging();
+        res.json({ success: true, data: { entries } });
+    }
+    catch (err) {
+        res.status(500).json({
+            success: false,
+            error: { code: 'GOVERNANCE_ERROR', message: err.message },
+        });
+    }
+});
+/**
+ * GET /api/v1/panorama/governance/enhancements
+ * 获取增强建议
+ */
+router.get('/governance/enhancements', async (_req, res) => {
+    try {
+        const container = getServiceContainer();
+        const suggester = container.get('enhancementSuggester');
+        if (!suggester) {
+            res.status(503).json({
+                success: false,
+                error: { code: 'SERVICE_UNAVAILABLE', message: 'EnhancementSuggester not available' },
+            });
+            return;
+        }
+        const suggestions = suggester.analyzeAll();
+        res.json({ success: true, data: { suggestions } });
+    }
+    catch (err) {
+        res.status(500).json({
+            success: false,
+            error: { code: 'GOVERNANCE_ERROR', message: err.message },
+        });
+    }
+});
+export default router;