autosnippet 3.2.22 → 3.3.2

package/dist/lib/external/mcp/handlers/types.d.ts

@@ -12,18 +12,99 @@ export interface McpServiceContainer {
     getServiceNames?(): string[];
     singletons?: Record<string, unknown>;
 }
+/** A single decision recorded during an intent lifecycle */
+export interface DecisionRecord {
+    id: string;
+    title: string;
+    description: string;
+    rationale?: string;
+    tags?: string[];
+    recordedAt: number;
+}
+/** A single tool call record within an intent */
+export interface ToolCallRecord {
+    tool: string;
+    timestamp: number;
+    args_summary: string;
+}
+/** A drift event detected during an intent */
+export interface DriftEvent {
+    timestamp: number;
+    trigger: string;
+    type: 'new_module' | 'new_class' | 'search_shift' | 'file_shift';
+    detail: string;
+    primeOverlap: number;
+}
+/** Intent lifecycle state machine — tracks user intent from prime to close/fail */
+export interface IntentState {
+    phase: 'idle' | 'active' | 'ended';
+    primeQuery: string;
+    primeActiveFile?: string;
+    primeRecipeIds: string[];
+    primeAt: number;
+    primeLanguage: string | null;
+    primeModule: string | null;
+    primeScenario: string;
+    searchMeta?: {
+        queries: string[];
+        resultCount: number;
+        filteredCount: number;
+    };
+    taskId?: string;
+    taskTitle?: string;
+    toolCalls: ToolCallRecord[];
+    searchQueries: string[];
+    mentionedFiles: string[];
+    mentionedModules: Set<string>;
+    decisions: DecisionRecord[];
+    driftEvents: DriftEvent[];
+}
+/** Create a fresh idle IntentState */
+export declare function createIdleIntent(): IntentState;
+/** A complete intent chain record, written to JSONL on close/fail */
+export interface IntentChainRecord {
+    sessionId: string;
+    taskId?: string;
+    outcome: 'completed' | 'failed' | 'abandoned';
+    primeQuery: string;
+    primeActiveFile?: string;
+    primeRecipeIds: string[];
+    primeAt: number;
+    primeLanguage: string | null;
+    primeModule: string | null;
+    primeScenario: string;
+    searchMeta?: {
+        queries: string[];
+        resultCount: number;
+        filteredCount: number;
+    };
+    toolCalls: ToolCallRecord[];
+    searchQueries: string[];
+    mentionedFiles: string[];
+    decisions: DecisionRecord[];
+    driftEvents: DriftEvent[];
+    driftScore: number;
+    closeReason?: string;
+    failReason?: string;
+    guardViolations?: number;
+    startedAt: number;
+    endedAt: number;
+    duration: number;
+}
+/** MCP session tracking */
+export interface McpSession {
+    id: string;
+    startedAt: number;
+    toolCallCount: number;
+    toolsUsed: Set<string>;
+    lastActivityAt: number;
+    intent: IntentState;
+}
 /** MCP handler context passed from McpServer / router layer */
 export interface McpContext {
     container: McpServiceContainer;
     startedAt?: number;
-    session?: {
-        id: string;
-        readyCalled: boolean;
-        toolCallCount: number;
-        toolsUsed: Set<string>;
-        startedAt: number;
-        [key: string]: unknown;
-    };
+    session?: McpSession;
     [key: string]: unknown;
 }
 /** Common search handler args */
@@ -208,6 +289,7 @@ export interface ConsolidatedGraphArgs {
     [key: string]: unknown;
 }
 export interface ConsolidatedGuardArgs {
+    operation?: 'check' | 'review' | 'reverse_audit' | 'coverage_matrix' | 'compliance_report';
     code?: string;
     files?: Array<string | {
         path?: string;
@@ -231,6 +313,7 @@ export interface SubmitKnowledgeArgs {
     dimensionId?: string;
     knowledgeType?: string;
     skipDuplicateCheck?: boolean;
+    skipConsolidation?: boolean;
     [key: string]: unknown;
 }
 export interface KnowledgeBaseStats {

package/dist/lib/external/mcp/handlers/types.js

@@ -2,4 +2,21 @@
  * Shared type definitions for MCP handler modules.
  * Runtime-free — only interfaces and type aliases.
  */
-export {};
+/** Create a fresh idle IntentState */
+export function createIdleIntent() {
+    return {
+        phase: 'idle',
+        primeQuery: '',
+        primeRecipeIds: [],
+        primeAt: 0,
+        primeLanguage: null,
+        primeModule: null,
+        primeScenario: 'search',
+        toolCalls: [],
+        searchQueries: [],
+        mentionedFiles: [],
+        mentionedModules: new Set(),
+        decisions: [],
+        driftEvents: [],
+    };
+}

package/dist/lib/external/mcp/handlers/wiki-external.d.ts

@@ -24,7 +24,24 @@ interface WikiFinalizeArgs {
     [key: string]: unknown;
 }
 /**
- * 规划 Wiki 文档生成 (autosnippet_wiki_plan)
+ * 统一 Wiki 路由入口 (autosnippet_wiki)
+ *
+ * @param args.operation 'plan' | 'finalize'
+ */
+export declare function wikiRouter(ctx: McpContext, args: Record<string, unknown>): Promise<{
+    success: boolean;
+    errorCode: string | null;
+    message: string;
+    data: unknown;
+    meta: {
+        source?: string | undefined;
+        responseTimeMs?: number | undefined;
+        version: string;
+        tool?: string | undefined;
+    };
+}>;
+/**
+ * 规划 Wiki 文档生成 (autosnippet_wiki operation=plan)
  *
  * 复用 WikiGenerator 的数据收集和主题发现逻辑（Phase 1-5），
  * 但不撰写文章，只返回规划清单和每个主题的数据包。

package/dist/lib/external/mcp/handlers/wiki-external.js

@@ -32,10 +32,25 @@ function tryGet(container, name) {
     }
 }
 // ════════════════════════════════════════════════════════════
+//  wikiRouter — 统一入口 (autosnippet_wiki)
+// ════════════════════════════════════════════════════════════
+/**
+ * 统一 Wiki 路由入口 (autosnippet_wiki)
+ *
+ * @param args.operation 'plan' | 'finalize'
+ */
+export async function wikiRouter(ctx, args) {
+    const op = args.operation;
+    if (op === 'finalize') {
+        return wikiFinalize(ctx, args);
+    }
+    return wikiPlan(ctx, args);
+}
+// ════════════════════════════════════════════════════════════
 //  wikiPlan — 规划 Wiki 主题 + 数据包
 // ════════════════════════════════════════════════════════════
 /**
- * 规划 Wiki 文档生成 (autosnippet_wiki_plan)
+ * 规划 Wiki 文档生成 (autosnippet_wiki operation=plan)
  *
  * 复用 WikiGenerator 的数据收集和主题发现逻辑（Phase 1-5），
  * 但不撰写文章，只返回规划清单和每个主题的数据包。

package/dist/lib/external/mcp/tools.d.ts

@@ -1,20 +1,20 @@
 /**
- * MCP 工具定义 — V3 整合版 (18 agent + 4 admin = 22 工具)
+ * MCP 工具定义 — V3 整合版 (14 agent + 2 admin = 16 工具)
  *
  * 每个工具声明包含 name、tier（agent/admin）、description 和 inputSchema。
  * description 是 Agent 选择工具的关键 — 使用 bullet list 列出所有 operation 及其用途。
  * inputSchema 由 Zod Schema 自动生成（zodToMcpSchema），参数的 .describe() 会转为 JSON Schema description。
  *
- * Agent 工具 (18):
+ * Agent 工具 (14):
  *   1-7:   查询工具 (health/search/knowledge/structure/graph/call_context/guard)
- *   8-10:  写入工具 (submit_knowledge/submit_knowledge_batch/save_document)
- *   11:    Skill 管理 (skill)
- *   12-15: 冷启动 (bootstrap/dimension_complete/wiki_plan/wiki_finalize)
- *   16:    自发现 (capabilities)
- *   17:    任务管理 (task)
+ *   8:     写入工具 (submit_knowledge — unified pipeline，单条/批量统一处理)
+ *   9:     Skill 管理 (skill)
+ *   10-12: 冷启动 (bootstrap/dimension_complete/wiki)
+ *   13:    项目全景 (panorama)
+ *   14:    任务管理 (task — 5 ops: prime/create/close/fail/record_decision)
  *
- * Admin 工具 (4):
- *   18-21: enrich_candidates/knowledge_lifecycle/validate_candidate/check_duplicate
+ * Admin 工具 (2):
+ *   15-16: enrich_candidates/knowledge_lifecycle
  */
 export declare const TIER_ORDER: {
     agent: number;
@@ -25,9 +25,11 @@ export declare const TOOL_GATEWAY_MAP: {
         action: string;
         resource: string;
     };
-    autosnippet_wiki_finalize: {
-        action: string;
-        resource: string;
+    autosnippet_wiki: {
+        resolver: (args: Record<string, unknown>) => {
+            action: string;
+            resource: string;
+        } | null;
     };
     autosnippet_guard: {
         resolver: (args: Record<string, unknown>) => {
@@ -45,14 +47,6 @@ export declare const TOOL_GATEWAY_MAP: {
         action: string;
         resource: string;
     };
-    autosnippet_submit_knowledge_batch: {
-        action: string;
-        resource: string;
-    };
-    autosnippet_save_document: {
-        action: string;
-        resource: string;
-    };
     autosnippet_task: {
         resolver: (args: Record<string, unknown>) => {
             action: string;

package/dist/lib/external/mcp/tools.js

@@ -1,22 +1,22 @@
 /**
- * MCP 工具定义 — V3 整合版 (18 agent + 4 admin = 22 工具)
+ * MCP 工具定义 — V3 整合版 (14 agent + 2 admin = 16 工具)
  *
  * 每个工具声明包含 name、tier（agent/admin）、description 和 inputSchema。
  * description 是 Agent 选择工具的关键 — 使用 bullet list 列出所有 operation 及其用途。
  * inputSchema 由 Zod Schema 自动生成（zodToMcpSchema），参数的 .describe() 会转为 JSON Schema description。
  *
- * Agent 工具 (18):
+ * Agent 工具 (14):
  *   1-7:   查询工具 (health/search/knowledge/structure/graph/call_context/guard)
- *   8-10:  写入工具 (submit_knowledge/submit_knowledge_batch/save_document)
- *   11:    Skill 管理 (skill)
- *   12-15: 冷启动 (bootstrap/dimension_complete/wiki_plan/wiki_finalize)
- *   16:    自发现 (capabilities)
- *   17:    任务管理 (task)
+ *   8:     写入工具 (submit_knowledge — unified pipeline，单条/批量统一处理)
+ *   9:     Skill 管理 (skill)
+ *   10-12: 冷启动 (bootstrap/dimension_complete/wiki)
+ *   13:    项目全景 (panorama)
+ *   14:    任务管理 (task — 5 ops: prime/create/close/fail/record_decision)
  *
- * Admin 工具 (4):
- *   18-21: enrich_candidates/knowledge_lifecycle/validate_candidate/check_duplicate
+ * Admin 工具 (2):
+ *   15-16: enrich_candidates/knowledge_lifecycle
  */
-import { BootstrapInput, CallContextInput, CapabilitiesInput, CheckDuplicateInput, DimensionCompleteInput, EnrichCandidatesInput, GraphInput, GuardInput, HealthInput, KnowledgeInput, KnowledgeLifecycleInput, SaveDocumentInput, SearchInput, SkillInput, StructureInput, SubmitKnowledgeBatchInput, SubmitKnowledgeInput, TaskInput, ValidateCandidateInput, WikiFinalizeInput, WikiPlanInput, } from '#shared/schemas/mcp-tools.js';
+import { BootstrapInput, CallContextInput, DimensionCompleteInput, EnrichCandidatesInput, GraphInput, GuardInput, HealthInput, KnowledgeInput, KnowledgeLifecycleInput, PanoramaInput, SearchInput, SkillInput, StructureInput, SubmitKnowledgeInput, TaskInput, WikiInput, } from '#shared/schemas/mcp-tools.js';
 import { zodToMcpSchema } from './zodToMcpSchema.js';
 // ─── Tier 定义 ──────────────────────────────────────────────
 export const TIER_ORDER = { agent: 0, admin: 1 };
@@ -26,8 +26,10 @@ export const TOOL_GATEWAY_MAP = {
     // autosnippet_bootstrap: null,
     // dimension_complete — 写操作（recipe tagging + skill creation + checkpoint）
     autosnippet_dimension_complete: { action: 'knowledge:bootstrap', resource: 'knowledge' },
-    // wiki_finalize — 写操作（meta.json）
-    autosnippet_wiki_finalize: { action: 'knowledge:create', resource: 'knowledge' },
+    // wiki — finalize 操作是写操作（meta.json）
+    autosnippet_wiki: {
+        resolver: (args) => args?.operation === 'finalize' ? { action: 'knowledge:create', resource: 'knowledge' } : null, // plan 只读
+    },
     // guard 写操作（仅 files 模式）
     autosnippet_guard: {
         resolver: (args) => args?.files && Array.isArray(args.files)
@@ -42,25 +44,16 @@ export const TOOL_GATEWAY_MAP = {
             delete: { action: 'delete:skills', resource: 'skills' },
         })[args?.operation] || null, // list/load/suggest 只读
     },
-    // 知识提交
+    // 知识提交（unified pipeline）
     autosnippet_submit_knowledge: { action: 'knowledge:create', resource: 'knowledge' },
-    autosnippet_submit_knowledge_batch: { action: 'knowledge:create', resource: 'knowledge' },
-    autosnippet_save_document: { action: 'knowledge:create', resource: 'knowledge' },
-    // task 写操作（create/claim/close/fail/defer/decompose/dep_add + decision 写操作）
+    // task 写操作（create/close/fail + record_decision）
     autosnippet_task: {
         resolver: (args) => ({
-            create: { action: 'task:create', resource: 'tasks' },
-            claim: { action: 'task:update', resource: 'tasks' },
-            close: { action: 'task:update', resource: 'tasks' },
-            fail: { action: 'task:update', resource: 'tasks' },
-            defer: { action: 'task:update', resource: 'tasks' },
-            progress: { action: 'task:update', resource: 'tasks' },
-            decompose: { action: 'task:create', resource: 'tasks' },
-            dep_add: { action: 'task:update', resource: 'tasks' },
-            record_decision: { action: 'task:create', resource: 'tasks' },
-            revise_decision: { action: 'task:update', resource: 'tasks' },
-            unpin_decision: { action: 'task:update', resource: 'tasks' },
-        })[args?.operation] || null, // prime/ready/show/list/blocked/dep_tree/stats/list_decisions 只读
+            create: { action: 'task:create', resource: 'intent' },
+            close: { action: 'task:update', resource: 'intent' },
+            fail: { action: 'task:update', resource: 'intent' },
+            record_decision: { action: 'task:create', resource: 'intent' },
+        })[args?.operation] || null, // prime 只读
     },
     // admin 工具
     autosnippet_enrich_candidates: { action: 'knowledge:update', resource: 'knowledge' },
@@ -69,7 +62,7 @@ export const TOOL_GATEWAY_MAP = {
 // ─── 工具声明 ────────────────────────────────────────────────
 export const TOOLS = [
     // ══════════════════════════════════════════════════════
-    //  Tier: agent — Agent 核心工具集 (18 个)
+    //  Tier: agent — Agent 核心工具集 (14 个)
     // ══════════════════════════════════════════════════════
     // 1. 健康检查
     {
@@ -138,39 +131,27 @@ export const TOOLS = [
     {
         name: 'autosnippet_guard',
         tier: 'agent',
-        description: '代码规范检查。\n' +
+        description: '代码规范检查与 Guard 免疫系统。\n' +
             '• 无参数 → 自动检查 git diff 增量文件（编码后首选用法）\n' +
             '• files → 检查指定文件列表\n' +
             '• code → 内联检查代码片段\n' +
+            '• operation: "reverse_audit" → Recipe→Code 反向验证（检查知识是否过时）\n' +
+            '• operation: "coverage_matrix" → 模块级 Guard 规则覆盖率矩阵\n' +
             '每个 violation 附带修复指南（doClause + coreCode），按指示修复后可再次检查。',
         inputSchema: zodToMcpSchema(GuardInput),
     },
-    // 8. 提交单条知识
+    // 8. 提交知识（统一管线）
     {
         name: 'autosnippet_submit_knowledge',
         tier: 'agent',
-        description: '提交单条知识。所有字段须一次性提供。提交后进入 pending 状态，用户在 Dashboard 审核。\n' +
-            '校验未通过的条目仍会入库，返回 recipeReadyHints 提示缺失字段。\n' +
-            'content 和 reasoning 必须是对象（非字符串）。详见各参数 description。',
+        description: '提交知识条目（单条/批量统一管线）。通过 items 数组传入 1~N 条。\n' +
+            '• 所有条目统一严格校验，所有 V3 字段须一次性提供\n' +
+            '• 统一融合分析：检测与已有 Recipe 和批次内候选的重叠\n' +
+            '• 返回 CONSOLIDATION_MERGE / CONSOLIDATION_REORGANIZE / CONSOLIDATION_INSUFFICIENT 时需处理\n' +
+            '• 设 skipConsolidation: true 跳过融合检查。content 和 reasoning 必须是对象。',
         inputSchema: zodToMcpSchema(SubmitKnowledgeInput),
     },
-    // 9. 批量知识提交
-    {
-        name: 'autosnippet_submit_knowledge_batch',
-        tier: 'agent',
-        description: '批量提交知识条目。每条字段要求同 submit_knowledge，支持自动去重。\n' +
-            '校验更严格：不通过的条目会被拒绝（不入库），返回 rejectedSummary。\n' +
-            '适用于冷启动维度分析、模块批量扫描等场景。',
-        inputSchema: zodToMcpSchema(SubmitKnowledgeBatchInput),
-    },
-    // 10. 保存开发文档
-    {
-        name: 'autosnippet_save_document',
-        tier: 'agent',
-        description: '保存开发文档（设计文档、排查报告、ADR 等）到知识库。仅需 title + markdown，无需完整 V3 字段。',
-        inputSchema: zodToMcpSchema(SaveDocumentInput),
-    },
-    // 11. Skill 管理
+    // 9. Skill 管理
     {
         name: 'autosnippet_skill',
         tier: 'agent',
@@ -183,7 +164,7 @@ export const TOOLS = [
             '• suggest — 基于项目分析推荐应创建的 Skill',
         inputSchema: zodToMcpSchema(SkillInput),
     },
-    // 12. 冷启动
+    // 10. 冷启动
     {
         name: 'autosnippet_bootstrap',
         tier: 'agent',
@@ -194,7 +175,7 @@ export const TOOLS = [
             '收到 Briefing 后按 executionPlan 完成所有维度分析。',
         inputSchema: zodToMcpSchema(BootstrapInput),
     },
-    // 13. 维度完成通知
+    // 11. 维度完成通知
     {
         name: 'autosnippet_dimension_complete',
         tier: 'agent',
@@ -202,67 +183,57 @@ export const TOOLS = [
             'analysisText 可简写，系统会自动从已提交的候选知识中合成详细内容用于 Skill 生成。',
         inputSchema: zodToMcpSchema(DimensionCompleteInput),
     },
-    // 14. Wiki 规划
-    {
-        name: 'autosnippet_wiki_plan',
-        tier: 'agent',
-        description: '规划 Wiki 文档生成 — 整合项目结构与知识库，返回文档主题列表及每个主题的数据包。Agent 根据规划自行撰写文章。',
-        inputSchema: zodToMcpSchema(WikiPlanInput),
-    },
-    // 15. Wiki 完成
+    // 12. Wiki 文档生成
     {
-        name: 'autosnippet_wiki_finalize',
+        name: 'autosnippet_wiki',
         tier: 'agent',
-        description: '完成 Wiki 生成 — 写入 meta.json、去重检查、验证完整性。所有文章写入后调用。',
-        inputSchema: zodToMcpSchema(WikiFinalizeInput),
+        description: 'Wiki 文档生成。\n' +
+            '• plan — 规划主题 + 数据包（整合项目结构与知识库，返回主题列表 + 每个主题的数据包，Agent 据此撰写）\n' +
+            '• finalize — 完成生成（写入 meta.json、去重检查、验证完整性，所有文章写入后调用）',
+        inputSchema: zodToMcpSchema(WikiInput),
     },
-    // 16. 能力自发现
+    // 13. 项目全景
     {
-        name: 'autosnippet_capabilities',
+        name: 'autosnippet_panorama',
         tier: 'agent',
-        description: '列出所有可用 MCP 工具及其用途概览。适合 Agent 初次接触时了解服务能力。',
-        inputSchema: zodToMcpSchema(CapabilitiesInput),
+        description: '项目全景查询。无数据时自动触发结构扫描，无需手动冷启动。\n' +
+            '• overview（默认）— 项目骨架 + 架构层级 + 模块角色 + 知识覆盖率\n' +
+            '• module — 单模块详情 + 邻居关系（需 module 参数）\n' +
+            '• gaps — 知识空白区（有代码无 Recipe 的模块）\n' +
+            '• health — 全景健康度（覆盖率 + 耦合度 + 循环依赖 + 健康评分）\n' +
+            '• governance_cycle — 知识新陈代谢完整周期（矛盾检测 + 冗余分析 + 衰退评估）\n' +
+            '• decay_report — 衰退评估报告（5 策略检测 + decayScore 评分）\n' +
+            '• staging_check — staging 条目检查 + 到期自动发布\n' +
+            '• enhancement_suggestions — 基于使用数据的 Recipe 增强建议',
+        inputSchema: zodToMcpSchema(PanoramaInput),
     },
-    // 17. 任务与决策管理
+    // 14. 任务与决策管理
     {
         name: 'autosnippet_task',
         tier: 'agent',
-        description: '任务与决策管理。每次对话开始时先调用 prime 加载上下文。\n' +
-            '会话: prime（加载决策+任务+知识上下文）| ready（就绪确认）\n' +
-            '任务: create | claim | close | fail | defer | progress | show | list | stats | blocked\n' +
-            '分解: decompose（拆子任务）| dep_add（添加依赖）| dep_tree（依赖树）\n' +
-            '决策: record_decision | revise_decision | unpin_decision | list_decisions',
+        description: '任务与决策管理（5 operations）。每次对话开始时先调用 prime 加载知识上下文。\n' +
+            '• prime — 加载知识上下文 + 初始化意图生命周期\n' +
+            '• create — 创建任务锚点（≥2 files 或 ≥10 lines 的非轻量工作）\n' +
+            '• close — 完成任务 + 触发 Guard 合规审查\n' +
+            '• fail — 放弃任务\n' +
+            '• record_decision — 记录用户偏好决策',
         inputSchema: zodToMcpSchema(TaskInput),
     },
     // ══════════════════════════════════════════════════════
-    //  Tier: admin — 管理员/CI 工具 (额外 +4)
+    //  Tier: admin — 管理员/CI 工具 (+2)
     // ══════════════════════════════════════════════════════
-    // 18. 候选字段诊断
+    // 15. 候选字段诊断
     {
         name: 'autosnippet_enrich_candidates',
         tier: 'admin',
         description: '诊断候选条目的字段完整性（无 AI）。返回每条候选的 missingFields 列表，Agent 据此补全后重新提交。',
         inputSchema: zodToMcpSchema(EnrichCandidatesInput),
     },
-    // 19. 知识生命周期
+    // 16. 知识生命周期
     {
         name: 'autosnippet_knowledge_lifecycle',
         tier: 'admin',
         description: '知识条目生命周期操作。approve/fast_track → 发布知识；reject → 拒绝；deprecate → 废弃；reactivate → 恢复。',
         inputSchema: zodToMcpSchema(KnowledgeLifecycleInput),
     },
-    // 20. 候选预校验（调试）
-    {
-        name: 'autosnippet_validate_candidate',
-        tier: 'admin',
-        description: '独立候选校验（5 层结构化检查）。调试用，submit_knowledge 已内置校验。',
-        inputSchema: zodToMcpSchema(ValidateCandidateInput),
-    },
-    // 21. 去重检测（调试）
-    {
-        name: 'autosnippet_check_duplicate',
-        tier: 'admin',
-        description: '独立相似度检测。调试用，submit_knowledge 已内置去重。',
-        inputSchema: zodToMcpSchema(CheckDuplicateInput),
-    },
 ];

package/dist/lib/http/HttpServer.js

@@ -15,28 +15,30 @@ import { initErrorTracker } from '../infrastructure/monitoring/ErrorTracker.js';
 import { initPerformanceMonitor } from '../infrastructure/monitoring/PerformanceMonitor.js';
 import { initRealtimeService } from '../infrastructure/realtime/RealtimeService.js';
 import { getServiceContainer } from '../injection/ServiceContainer.js';
-import spmRouter from '../platform/ios/routes/spm.js';
 import apiSpec from './api-spec.js';
 import { errorHandler } from './middleware/errorHandler.js';
 import { gatewayMiddleware } from './middleware/gatewayMiddleware.js';
 import { requestLogger } from './middleware/requestLogger.js';
 import { roleResolverMiddleware } from './middleware/roleResolver.js';
 import aiRouter from './routes/ai.js';
+import auditRouter from './routes/audit.js';
 import authRouter from './routes/auth.js';
 import candidatesRouter from './routes/candidates.js';
 import commandsRouter from './routes/commands.js';
 import extractRouter from './routes/extract.js';
 import guardRouter from './routes/guard.js';
+import guardReportRouter from './routes/guardReport.js';
 import guardRuleRouter from './routes/guardRules.js';
 import healthRouter from './routes/health.js';
 import knowledgeRouter from './routes/knowledge.js';
 import modulesRouter from './routes/modules.js';
 import monitoringRouter from './routes/monitoring.js';
+import panoramaRouter from './routes/panorama.js';
 import recipesRouter from './routes/recipes.js';
 import remoteRouter from './routes/remote.js';
 import searchRouter from './routes/search.js';
+import signalsRouter from './routes/signals.js';
 import skillsRouter from './routes/skills.js';
-import snippetRouter from './routes/snippets.js';
 import taskRouter from './routes/task.js';
 import violationsRouter from './routes/violations.js';
 import wikiRouter from './routes/wiki.js';
@@ -225,14 +227,14 @@ export class HttpServer {
         }
         // Guard 实时检查路由（Extension DiagnosticCollection 调用）
         this.app.use(`${apiPrefix}/guard`, guardRouter);
+        // Guard 合规报告路由
+        this.app.use(`${apiPrefix}/guard/report`, guardReportRouter);
         // 守护规则路由
         this.app.use(`${apiPrefix}/rules`, guardRuleRouter);
         // TaskGraph 路由（Extension taskTool.ts 转发调用）
         this.app.use(`${apiPrefix}/task`, taskRouter);
         // 搜索路由
         this.app.use(`${apiPrefix}/search`, searchRouter);
-        // Snippet 路由
-        this.app.use(`${apiPrefix}/snippets`, snippetRouter);
         // AI 路由
         this.app.use(`${apiPrefix}/ai`, aiRouter);
         // 提取路由
@@ -243,8 +245,6 @@ export class HttpServer {
         this.app.use(`${apiPrefix}/skills`, skillsRouter);
         // Candidates 路由（AI 补齐/润色）
         this.app.use(`${apiPrefix}/candidates`, candidatesRouter);
-        // SPM 路由（向后兼容保留）
-        this.app.use(`${apiPrefix}/spm`, spmRouter);
         // Modules 路由（v3.2 统一多语言模块扫描）
         this.app.use(`${apiPrefix}/modules`, modulesRouter);
         // 违规记录路由
@@ -257,6 +257,12 @@ export class HttpServer {
         this.app.use(`${apiPrefix}/wiki`, wikiRouter);
         // Remote 路由（飞书 Bot → IDE 远程指令桥接）
         this.app.use(`${apiPrefix}/remote`, remoteRouter);
+        // Panorama 全景路由（项目结构 + 覆盖率 + 健康度）
+        this.app.use(`${apiPrefix}/panorama`, panoramaRouter);
+        // 信号留痕 & 报告路由
+        this.app.use(`${apiPrefix}/signals`, signalsRouter);
+        // 审计日志路由
+        this.app.use(`${apiPrefix}/audit`, auditRouter);
         // 根路径 — 返回 API 元信息（避免外部探测产生无意义 404）
         this.app.all('/', (_req, res) => {
             res.json({
@@ -303,6 +309,46 @@ export class HttpServer {
                 try {
                     this.realtimeService = initRealtimeService(this.server);
                     this.logger.info('Realtime service initialized');
+                    // 桥接 EventBus / SignalBus → RealtimeService
+                    try {
+                        const container = getServiceContainer();
+                        const rs = this.realtimeService;
+                        if (typeof rs?.broadcastEvent !== 'function') {
+                            throw new Error('broadcastEvent not available');
+                        }
+                        // EventBus → lifecycle:transition
+                        const eventBus = container.services.eventBus ? container.get('eventBus') : null;
+                        if (eventBus) {
+                            eventBus.on('lifecycle:transition', (data) => {
+                                rs.broadcastEvent('lifecycle:transition', data);
+                            });
+                        }
+                        // SignalBridge 已将信号转发到 EventBus，HttpServer 只听 EventBus
+                        if (eventBus) {
+                            eventBus.on('signal:event', (signal) => {
+                                rs.broadcastEvent('signal:event', signal);
+                            });
+                            eventBus.on('guard:updated', (signal) => {
+                                rs.broadcastEvent('guard:updated', signal);
+                            });
+                        }
+                        // 确保 SignalBridge 已初始化（触发 lazy singleton）
+                        try {
+                            container.get('signalBridge');
+                        }
+                        catch {
+                            // SignalBridge 未注册时静默跳过
+                        }
+                        // EventBus → audit:entry
+                        if (eventBus) {
+                            eventBus.on('audit:entry', (data) => {
+                                rs.broadcastEvent('audit:entry', data);
+                            });
+                        }
+                    }
+                    catch {
+                        // EventBus/SignalBus 不可用时静默跳过
+                    }
                 }
                 catch (error) {
                     this.logger.warn('Failed to initialize realtime service', {

package/dist/lib/http/routes/{snippets.d.ts → audit.d.ts}

@@ -1,6 +1,8 @@
 /**
- * Snippets API 路由
- * Snippet = Recipe 的附属产物，从 Recipe 实时生成，不存 DB
+ * Audit Log API 路由
+ *
+ * 端点:
+ *   GET /api/v1/audit — 查询审计日志
  */
 declare const router: import("express-serve-static-core").Router;
 export default router;