autosnippet 3.3.0 → 3.3.3

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;

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

@@ -0,0 +1,10 @@
+/**
+ * Signal & Report API 路由
+ *
+ * 端点:
+ *   GET /api/v1/signals/trace   — 查询信号留痕
+ *   GET /api/v1/signals/stats   — 信号统计
+ *   GET /api/v1/signals/reports — 查询管道报告
+ */
+declare const router: import("express-serve-static-core").Router;
+export default router;

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

@@ -0,0 +1,104 @@
+/**
+ * Signal & Report API 路由
+ *
+ * 端点:
+ *   GET /api/v1/signals/trace   — 查询信号留痕
+ *   GET /api/v1/signals/stats   — 信号统计
+ *   GET /api/v1/signals/reports — 查询管道报告
+ */
+import express from 'express';
+import { getServiceContainer } from '../../injection/ServiceContainer.js';
+const router = express.Router();
+/**
+ * GET /api/v1/signals/trace
+ * 查询信号留痕（支持 type / source / target / from / to / limit / offset）
+ */
+router.get('/trace', async (req, res) => {
+    try {
+        const container = getServiceContainer();
+        const traceWriter = container.get('signalTraceWriter');
+        if (!traceWriter) {
+            res.status(503).json({
+                success: false,
+                error: { code: 'SERVICE_UNAVAILABLE', message: 'SignalTraceWriter not available' },
+            });
+            return;
+        }
+        const typeParam = req.query.type;
+        const type = typeof typeParam === 'string' ? typeParam.split(',').filter(Boolean) : undefined;
+        const source = typeof req.query.source === 'string' ? req.query.source : undefined;
+        const target = typeof req.query.target === 'string' ? req.query.target : undefined;
+        const from = req.query.from ? Number(req.query.from) : undefined;
+        const to = req.query.to ? Number(req.query.to) : undefined;
+        const limit = req.query.limit ? Math.min(Number(req.query.limit), 200) : undefined;
+        const offset = req.query.offset ? Number(req.query.offset) : undefined;
+        const result = await traceWriter.query({ type, source, target, from, to, limit, offset });
+        res.json({ success: true, data: result });
+    }
+    catch (err) {
+        res.status(500).json({
+            success: false,
+            error: { code: 'INTERNAL_ERROR', message: err instanceof Error ? err.message : String(err) },
+        });
+    }
+});
+/**
+ * GET /api/v1/signals/stats
+ * 信号统计（可选 from / to 时间范围）
+ */
+router.get('/stats', async (req, res) => {
+    try {
+        const container = getServiceContainer();
+        const traceWriter = container.get('signalTraceWriter');
+        if (!traceWriter) {
+            res.status(503).json({
+                success: false,
+                error: { code: 'SERVICE_UNAVAILABLE', message: 'SignalTraceWriter not available' },
+            });
+            return;
+        }
+        const from = req.query.from ? Number(req.query.from) : undefined;
+        const to = req.query.to ? Number(req.query.to) : undefined;
+        const stats = await traceWriter.stats({ from, to });
+        res.json({ success: true, data: stats });
+    }
+    catch (err) {
+        res.status(500).json({
+            success: false,
+            error: { code: 'INTERNAL_ERROR', message: err instanceof Error ? err.message : String(err) },
+        });
+    }
+});
+/**
+ * GET /api/v1/signals/reports
+ * 查询管道报告（支持 category / type / from / to / limit / offset）
+ */
+router.get('/reports', async (req, res) => {
+    try {
+        const container = getServiceContainer();
+        const reportStore = container.get('reportStore');
+        if (!reportStore) {
+            res.status(503).json({
+                success: false,
+                error: { code: 'SERVICE_UNAVAILABLE', message: 'ReportStore not available' },
+            });
+            return;
+        }
+        const catParam = req.query.category;
+        const category = typeof catParam === 'string' ? catParam.split(',').filter(Boolean) : undefined;
+        const type = typeof req.query.type === 'string' ? req.query.type : undefined;
+        const from = req.query.from ? Number(req.query.from) : undefined;
+        const to = req.query.to ? Number(req.query.to) : undefined;
+        const limit = req.query.limit ? Math.min(Number(req.query.limit), 200) : undefined;
+        const offset = req.query.offset ? Number(req.query.offset) : undefined;
+        const result = await reportStore.query({ category, type, from, to, limit, offset });
+        res.json({ success: true, data: result });
+    }
+    catch (err) {
+        res.status(500).json({
+            success: false,
+            error: { code: 'INTERNAL_ERROR', message: err instanceof Error ? err.message : String(err) },
+        });
+    }
+});
+export default router;

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

@@ -1,9 +1,8 @@
 /**
- * TaskGraph HTTP API 路由
+ * Task HTTP API 路由 (v3.3 — Intent Lifecycle)
  *
  * 为 VS Code Extension `taskTool.ts` 提供 HTTP 转发端点。
- * Extension 通过 lm.registerTool 拦截 tokenBudget 后，
- * 将业务逻辑转发到此端点，由 TaskGraphService 执行。
+ * 5 operations: prime, create, close, fail, record_decision
  *
  * 端点:
  *   POST /api/v1/task  — 统一入口（operation 路由）