autosnippet 3.3.0 → 3.3.3

package/dist/lib/domain/knowledge/values/Stats.d.ts

@@ -2,6 +2,9 @@
  * Stats — 统计值对象
  *
  * 记录知识条目的使用统计：浏览、采用、应用、Guard 命中、搜索命中、权威分。
+ *
+ * Phase 0 扩展：新增时间戳、滑窗统计、版本号、FP 率字段。
+ * 新字段均有默认值，与旧 JSON 100% 向后兼容。
  */
 type StatsCounter = 'views' | 'adoptions' | 'applications' | 'guardHits' | 'searchHits';
 interface StatsProps {
@@ -11,6 +14,14 @@ interface StatsProps {
     guardHits?: number;
     searchHits?: number;
     authority?: number;
+    lastHitAt?: number | null;
+    lastSearchedAt?: number | null;
+    lastGuardHitAt?: number | null;
+    hitsLast30d?: number;
+    hitsLast90d?: number;
+    searchHitsLast30d?: number;
+    version?: number;
+    ruleFalsePositiveRate?: number | null;
 }
 export declare class Stats {
     adoptions: number;
@@ -19,11 +30,21 @@ export declare class Stats {
     guardHits: number;
     searchHits: number;
     views: number;
+    lastHitAt: number | null;
+    lastSearchedAt: number | null;
+    lastGuardHitAt: number | null;
+    hitsLast30d: number;
+    hitsLast90d: number;
+    searchHitsLast30d: number;
+    version: number;
+    ruleFalsePositiveRate: number | null;
     constructor(props?: StatsProps);
     /** 从任意输入构造 Stats */
     static from(input: unknown): Stats;
     /** 增加计数 */
     increment(counter: StatsCounter, delta?: number): Stats;
+    /** 记录一次命中，同时更新时间戳 */
+    recordHit(counter: StatsCounter, timestamp?: number): Stats;
     /** 转换为 JSON */
     toJSON(): {
         views: number;
@@ -32,6 +53,14 @@ export declare class Stats {
         guardHits: number;
         searchHits: number;
         authority: number;
+        lastHitAt: number | null;
+        lastSearchedAt: number | null;
+        lastGuardHitAt: number | null;
+        hitsLast30d: number;
+        hitsLast90d: number;
+        searchHitsLast30d: number;
+        version: number;
+        ruleFalsePositiveRate: number | null;
     };
     /** 从 wire format 创建 */
     static fromJSON(data: unknown): Stats;

package/dist/lib/domain/knowledge/values/Stats.js

@@ -5,6 +5,18 @@ export class Stats {
     guardHits;
     searchHits;
     views;
+    // Phase 0: 时间戳 —— "最后一次被使用是什么时候"
+    lastHitAt;
+    lastSearchedAt;
+    lastGuardHitAt;
+    // Phase 0: 滑窗统计 —— "最近趋势如何"
+    hitsLast30d;
+    hitsLast90d;
+    searchHitsLast30d;
+    // Phase 0: 版本 —— "这条知识更新了几次"
+    version;
+    // Phase 0: 精度 (仅 kind=rule)
+    ruleFalsePositiveRate;
     constructor(props = {}) {
         /** 浏览次数 */
         this.views = props.views ?? 0;
@@ -18,6 +30,15 @@ export class Stats {
         this.searchHits = props.searchHits ?? 0;
         /** 权威分 0-5 */
         this.authority = props.authority ?? 0;
+        // Phase 0 扩展字段（旧 JSON 无这些字段时取默认值）
+        this.lastHitAt = props.lastHitAt ?? null;
+        this.lastSearchedAt = props.lastSearchedAt ?? null;
+        this.lastGuardHitAt = props.lastGuardHitAt ?? null;
+        this.hitsLast30d = props.hitsLast30d ?? 0;
+        this.hitsLast90d = props.hitsLast90d ?? 0;
+        this.searchHitsLast30d = props.searchHitsLast30d ?? 0;
+        this.version = props.version ?? 1;
+        this.ruleFalsePositiveRate = props.ruleFalsePositiveRate ?? null;
     }
     /** 从任意输入构造 Stats */
     static from(input) {
@@ -39,6 +60,18 @@ export class Stats {
         this[counter] += delta;
         return this;
     }
+    /** 记录一次命中，同时更新时间戳 */
+    recordHit(counter, timestamp = Date.now()) {
+        this[counter] += 1;
+        this.lastHitAt = timestamp;
+        if (counter === 'searchHits') {
+            this.lastSearchedAt = timestamp;
+        }
+        if (counter === 'guardHits') {
+            this.lastGuardHitAt = timestamp;
+        }
+        return this;
+    }
     /** 转换为 JSON */
     toJSON() {
         return {
@@ -48,6 +81,14 @@ export class Stats {
             guardHits: this.guardHits,
             searchHits: this.searchHits,
             authority: this.authority,
+            lastHitAt: this.lastHitAt,
+            lastSearchedAt: this.lastSearchedAt,
+            lastGuardHitAt: this.lastGuardHitAt,
+            hitsLast30d: this.hitsLast30d,
+            hitsLast90d: this.hitsLast90d,
+            searchHitsLast30d: this.searchHitsLast30d,
+            version: this.version,
+            ruleFalsePositiveRate: this.ruleFalsePositiveRate,
         };
     }
     /** 从 wire format 创建 */

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

@@ -4,11 +4,11 @@
  * Model Context Protocol (stdio transport)
  * 提供给 IDE AI Agent (Cursor/VSCode Copilot) 的工具集
  *
- * V3.1 整合：39 → 22 工具（18 agent + 4 admin）
+ * V3.3 整合：39 → 16 工具（14 agent + 2 admin）
  * 通过 ASD_MCP_TIER 环境变量控制可见工具集（agent/admin）
  *
  * 冷启动双路径:
- *   - 外部 Agent 路径: bootstrap (Mission Briefing) → dimension_complete × N → wiki_plan → wiki_finalize
+ *   - 外部 Agent 路径: bootstrap (Mission Briefing) → dimension_complete × N → wiki(plan) → wiki(finalize)
  *   - 内部 Agent 路径: bootstrap.js bootstrapKnowledge() → orchestrator.js AI pipeline (Phase 5)
  *
  * Gateway 权限 gating: 写操作经过 Gateway 权限/宪法/审计检查（支持动态 resolver）
@@ -21,27 +21,15 @@
 import { McpServer as SdkMcpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { CapabilityProbe } from '#core/capability/CapabilityProbe.js';
 import Logger from '#infra/logging/Logger.js';
-import type { McpContext, McpServiceContainer } from './handlers/types.js';
-/** Decision entry (id + title pair) */
-interface DecisionEntry {
-    id: string;
-    title: string;
-}
-/** Decision cache structure */
-interface DecisionCache {
-    decisions: DecisionEntry[];
-    fetchedAt: number;
-    ttl: number;
-    _pending: Promise<DecisionEntry[]> | null;
-}
-/** MCP session tracking */
+import type { IntentState, McpContext, McpServiceContainer } from './handlers/types.js';
+/** MCP session tracking (with intent lifecycle) */
 interface McpSession {
     id: string;
     startedAt: number;
-    readyCalled: boolean;
     toolCallCount: number;
     toolsUsed: Set<string>;
     lastActivityAt: number;
+    intent: IntentState;
 }
 /** McpServer constructor options */
 interface McpServerOptions {
@@ -60,7 +48,6 @@ export declare class McpServer {
     logger: ReturnType<typeof Logger.getInstance>;
     _autoApproveMarked: boolean;
     _capabilityProbe: CapabilityProbe | null;
-    _decisionCache: DecisionCache;
     _lastTaskOperation: string;
     _session: McpSession;
     _startedAt: number;
@@ -82,30 +69,24 @@ export declare class McpServer {
     _registerHandlers(): void;
     _handleToolCall(name: string, args: Record<string, unknown>): Promise<unknown>;
     /**
-     * 在工具返回结果中注入 decisions 摘要 + 更新 session 统计
+     * Post-tool-call hook: update session stats + intent behavior tracking.
+     * Always called (non-blocking, synchronous).
      *
-     * 策略：
-     *   - prime: 刷新缓存，不额外注入（response 本身含 decisions）
-     *   - decision 写操作 (record/revise/unpin): invalidate 缓存（下次查询拉最新）
-     *   - 其他工具: 注入 _activeDecisions 摘要
-     *   - 首次未调 prime 的工具: 注入更强提醒
-     *
-     * @param result handler 返回的 envelope 对象
-     */
-    _injectDecisions(toolName: string, result: unknown): Promise<unknown>;
-    /**
-     * 获取 decisions 摘要（带缓存 + 防并发）
-     * @returns >>}
+     * - Session stats: toolCallCount, toolsUsed, lastActivityAt
+     * - Intent tracking (when active): toolCalls, searchQueries, mentionedFiles, drift detection
      */
-    private _getDecisionsSummary;
+    _trackSession(toolName: string, result: unknown): void;
     /**
-     * 从 DB 查询 decisions 摘要（仅 id + title）
+     * Inject active decisions + intent context into tool results.
+     * Currently deferred — enable by uncommenting the call in _handleToolCall.
      */
-    _fetchDecisionsSummary(): Promise<DecisionEntry[]>;
-    /**
-     * 从 ready 响应结果中刷新缓存（避免额外 DB 查询）
-     */
-    _refreshCacheFromReady(readyResult: unknown): void;
+    _injectDecisions(toolName: string, result: unknown): Promise<unknown>;
+    private _detectDrift;
+    private _computeKeywordOverlap;
+    private _computeOverlap;
+    private _extractSearchQuery;
+    private _extractMentionedFiles;
+    private _inferModule;
     /**
      * 解析工具名到 handler 函数（V3 整合版）
      */

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

@@ -4,11 +4,11 @@
  * Model Context Protocol (stdio transport)
  * 提供给 IDE AI Agent (Cursor/VSCode Copilot) 的工具集
  *
- * V3.1 整合：39 → 22 工具（18 agent + 4 admin）
+ * V3.3 整合：39 → 16 工具（14 agent + 2 admin）
  * 通过 ASD_MCP_TIER 环境变量控制可见工具集（agent/admin）
  *
  * 冷启动双路径:
- *   - 外部 Agent 路径: bootstrap (Mission Briefing) → dimension_complete × N → wiki_plan → wiki_finalize
+ *   - 外部 Agent 路径: bootstrap (Mission Briefing) → dimension_complete × N → wiki(plan) → wiki(finalize)
  *   - 内部 Agent 路径: bootstrap.js bootstrapKnowledge() → orchestrator.js AI pipeline (Phase 5)
  *
  * Gateway 权限 gating: 写操作经过 Gateway 权限/宪法/审计检查（支持动态 resolver）
@@ -26,6 +26,7 @@ import Logger from '#infra/logging/Logger.js';
 import { applyPendingAutoApprove, markAutoApproveNeeded } from './autoApproveInjector.js';
 import { envelope } from './envelope.js';
 import { wrapHandler } from './errorHandler.js';
+import { createIdleIntent } from './handlers/types.js';
 import { TIER_ORDER, TOOL_GATEWAY_MAP, TOOLS } from './tools.js';
 // ─── Handler 模块 ─────────────────────────────────────────────
 import * as candidateHandlers from './handlers/candidate.js';
@@ -35,15 +36,15 @@ import * as systemHandlers from './handlers/system.js';
 // ─── External Agent Bootstrap 新 handler ──────────────────────
 import { bootstrapExternal } from './handlers/bootstrap-external.js';
 import { dimensionComplete } from './handlers/dimension-complete-external.js';
+import { panoramaHandler } from './handlers/panorama.js';
 import { taskHandler } from './handlers/task.js';
-import { wikiFinalize, wikiPlan } from './handlers/wiki-external.js';
+import { wikiRouter } from './handlers/wiki-external.js';
 // ─── McpServer 类 ─────────────────────────────────────────────
 export class McpServer {
     container;
     logger;
     _autoApproveMarked;
     _capabilityProbe;
-    _decisionCache;
     _lastTaskOperation;
     _session;
     _startedAt;
@@ -58,21 +59,14 @@ export class McpServer {
         this._autoApproveMarked = false;
         this._capabilityProbe = null;
         this._lastTaskOperation = '';
-        // ── P0: Decision 注入缓存 ──
-        this._decisionCache = {
-            decisions: [], // [{ id, title }]
-            fetchedAt: 0, // timestamp ms
-            ttl: 60_000, // 60s TTL
-            _pending: null, // 防并发重复查询的 pending promise
-        };
-        // ── P3: Session 管理 ──
+        // ── Session 管理 (with intent lifecycle) ──
         this._session = {
             id: `ses-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`,
             startedAt: Date.now(),
-            readyCalled: false,
             toolCallCount: 0,
             toolsUsed: new Set(),
             lastActivityAt: Date.now(),
+            intent: createIdleIntent(),
         };
     }
     /** 共享上下文对象，传给所有 handler */
@@ -174,8 +168,10 @@ export class McpServer {
             this._lastTaskOperation = args.operation || '';
         }
         const result = await wrapped(ctx, args);
-        // ── P0+P3: Decision 注入 + Session 追踪 ──
-        await this._injectDecisions(name, result);
+        // ── Session 追踪 + 行为采集 ──
+        this._trackSession(name, result);
+        // ── [DEFERRED] Decision 注入（待 JSONL 数据验证后启用） ──
+        // await this._injectDecisions(name, result);
         // ── 首次成功 tool call → 标记 autoApprove（one-shot） ──
         // 用户已手动授权了至少一个工具，标记后下次 MCP 启动注入 autoApprove
         if (!this._autoApproveMarked) {
@@ -190,135 +186,171 @@ export class McpServer {
         }
         return result;
     }
-    // ─── P0: Decision 自动注入 ────────────────────────────
+    // ─── Session tracking + behavior collection ─────────────
     /**
-     * 在工具返回结果中注入 decisions 摘要 + 更新 session 统计
-     *
-     * 策略：
-     *   - prime: 刷新缓存，不额外注入（response 本身含 decisions）
-     *   - decision 写操作 (record/revise/unpin): invalidate 缓存（下次查询拉最新）
-     *   - 其他工具: 注入 _activeDecisions 摘要
-     *   - 首次未调 prime 的工具: 注入更强提醒
+     * Post-tool-call hook: update session stats + intent behavior tracking.
+     * Always called (non-blocking, synchronous).
      *
-     * @param result handler 返回的 envelope 对象
+     * - Session stats: toolCallCount, toolsUsed, lastActivityAt
+     * - Intent tracking (when active): toolCalls, searchQueries, mentionedFiles, drift detection
      */
-    async _injectDecisions(toolName, result) {
-        // ── P3: Session 统计 ──
+    _trackSession(toolName, result) {
+        // ── Session stats (always) ──
         this._session.toolCallCount++;
         this._session.toolsUsed.add(toolName);
         this._session.lastActivityAt = Date.now();
-        // 1) autosnippet_task: prime 刷新缓存，decision 写操作 invalidate 缓存
+        // Task handler manages IntentState internally — skip behavior tracking
         if (toolName === 'autosnippet_task') {
-            const op = this._lastTaskOperation;
-            if (op === 'prime') {
-                this._session.readyCalled = true;
-                this._refreshCacheFromReady(result);
-            }
-            else if (['record_decision', 'revise_decision', 'unpin_decision'].includes(op)) {
-                this._decisionCache.fetchedAt = 0;
-                this._decisionCache._pending = null;
-            }
-            return result;
+            return;
         }
-        // 4) 对非 task 操作工具：注入 decisions 摘要
-        const decisions = await this._getDecisionsSummary();
-        if (decisions.length > 0 && typeof result === 'object' && result !== null) {
-            const resultObj = result;
-            resultObj._activeDecisions = decisions;
-            // P3: 如果 ready 从未被调用，注入更强提醒
-            if (!this._session.readyCalled) {
-                resultObj._decisionReminder =
-                    '⚠️ You have NOT called autosnippet_task({ operation: "prime" }) yet this session. ' +
-                        'These decisions may affect your work. Call autosnippet_task({ operation: "prime" }) for full context.';
+        // ── Intent behavior tracking (active intent only) ──
+        const intent = this._session.intent;
+        if (intent.phase !== 'active') {
+            return;
+        }
+        // Track tool call
+        intent.toolCalls.push({
+            tool: toolName,
+            timestamp: Date.now(),
+            args_summary: toolName,
+        });
+        // Auto-collect search queries
+        if (toolName === 'autosnippet_search') {
+            const query = this._extractSearchQuery(result);
+            if (query) {
+                intent.searchQueries.push(query);
             }
-            else {
-                resultObj._decisionReminder =
-                    'Respect these team decisions. Call autosnippet_task({ operation: "list_decisions" }) for full details.';
+        }
+        // Auto-collect mentioned files
+        const files = this._extractMentionedFiles(toolName, result);
+        for (const f of files) {
+            if (!intent.mentionedFiles.includes(f)) {
+                intent.mentionedFiles.push(f);
+                const mod = this._inferModule(f);
+                if (mod) {
+                    intent.mentionedModules.add(mod);
+                }
             }
         }
-        return result;
+        // Drift detection
+        this._detectDrift(toolName, intent);
     }
+    // ─── [DEFERRED] Decision injection ───────────────────────
     /**
-     * 获取 decisions 摘要（带缓存 + 防并发）
-     * @returns >>}
+     * Inject active decisions + intent context into tool results.
+     * Currently deferred — enable by uncommenting the call in _handleToolCall.
      */
-    async _getDecisionsSummary() {
-        const cache = this._decisionCache;
-        const now = Date.now();
-        // 缓存有效（包括缓存了"空 decisions"的情况），直接返回
-        if (cache.fetchedAt > 0 && now - cache.fetchedAt < cache.ttl) {
-            return cache.decisions;
+    async _injectDecisions(toolName, result) {
+        if (toolName === 'autosnippet_task') {
+            return result;
         }
-        // 防并发：如果有正在进行的查询，等它完成
-        if (cache._pending) {
-            try {
-                return await cache._pending;
+        const intent = this._session.intent;
+        if (intent.phase !== 'active') {
+            return result;
+        }
+        if (intent.decisions.length > 0 && typeof result === 'object' && result !== null) {
+            const resultObj = result;
+            resultObj._activeDecisions = intent.decisions.map((d) => ({
+                id: d.id,
+                title: d.title,
+            }));
+            resultObj._intentContext =
+                `Active intent: "${intent.primeQuery || '(no query)'}"` +
+                    (intent.taskId ? ` | Task: ${intent.taskId}` : '') +
+                    ` | ${intent.toolCalls.length} tool calls | ${intent.decisions.length} decision(s)`;
+        }
+        return result;
+    }
+    // ─── Drift detection helpers ───────────────────
+    _detectDrift(toolName, intent) {
+        for (const mod of intent.mentionedModules) {
+            if (intent.primeModule && mod !== intent.primeModule) {
+                const alreadyDrifted = intent.driftEvents.some((d) => d.type === 'new_module' && d.detail.includes(mod));
+                if (!alreadyDrifted) {
+                    intent.driftEvents.push({
+                        timestamp: Date.now(),
+                        trigger: toolName,
+                        type: 'new_module',
+                        detail: `New module: ${mod} (prime: ${intent.primeModule})`,
+                        primeOverlap: this._computeOverlap(mod, intent.primeQuery),
+                    });
+                }
             }
-            catch {
-                return cache.decisions; // 降级返回旧缓存
+        }
+        if (toolName === 'autosnippet_search' && intent.searchQueries.length > 0) {
+            const latestQuery = intent.searchQueries[intent.searchQueries.length - 1];
+            const overlap = this._computeKeywordOverlap(latestQuery, intent.primeQuery);
+            if (overlap < 0.3) {
+                intent.driftEvents.push({
+                    timestamp: Date.now(),
+                    trigger: toolName,
+                    type: 'search_shift',
+                    detail: `Search drift: "${latestQuery.slice(0, 40)}" (overlap: ${Math.round(overlap * 100)}%)`,
+                    primeOverlap: overlap,
+                });
             }
         }
-        // 发起新查询
-        cache._pending = this._fetchDecisionsSummary();
-        try {
-            const result = await cache._pending;
-            return result;
+    }
+    _computeKeywordOverlap(a, b) {
+        if (!a || !b) {
+            return 0;
         }
-        finally {
-            cache._pending = null;
+        const tokensA = new Set(a
+            .toLowerCase()
+            .split(/[\s,./\\|]+/)
+            .filter((t) => t.length > 1));
+        const tokensB = new Set(b
+            .toLowerCase()
+            .split(/[\s,./\\|]+/)
+            .filter((t) => t.length > 1));
+        if (tokensA.size === 0 || tokensB.size === 0) {
+            return 0;
         }
-    }
-    /**
-     * 从 DB 查询 decisions 摘要（仅 id + title）
-     */
-    async _fetchDecisionsSummary() {
-        const cache = this._decisionCache;
-        try {
-            const taskService = this.container?.get('taskGraphService');
-            if (!taskService) {
-                return cache.decisions;
+        let shared = 0;
+        for (const t of tokensA) {
+            if (tokensB.has(t)) {
+                shared++;
             }
-            // 使用 service 公共 API（不直接访问 repo）
-            const pinned = await taskService.list({ status: 'pinned', taskType: 'decision' }, { limit: 50 });
-            cache.decisions = pinned.map((d) => ({
-                id: d.id,
-                title: d.title,
-            }));
-            cache.fetchedAt = Date.now();
         }
-        catch (err) {
-            // 查询失败不阻塞，保留旧缓存
-            const errMsg = err instanceof Error ? err.message : String(err);
-            this.logger.debug('_fetchDecisionsSummary error', { error: errMsg });
+        return shared / Math.max(tokensA.size, tokensB.size);
+    }
+    _computeOverlap(term, query) {
+        if (!term || !query) {
+            return 0;
         }
-        return cache.decisions;
+        return query.toLowerCase().includes(term.toLowerCase()) ? 1 : 0;
     }
-    /**
-     * 从 ready 响应结果中刷新缓存（避免额外 DB 查询）
-     */
-    _refreshCacheFromReady(readyResult) {
-        try {
-            // readyResult 是 envelope({ data: { decisions: [...] } })
-            const data = readyResult?.data;
-            const decisions = (data?.decisions || []);
-            this._decisionCache.decisions = decisions.map((d) => ({
-                id: d.id,
-                title: d.title,
-            }));
-            this._decisionCache.fetchedAt = Date.now();
+    _extractSearchQuery(result) {
+        if (typeof result === 'object' && result !== null) {
+            const obj = result;
+            if (typeof obj.query === 'string') {
+                return obj.query;
+            }
         }
-        catch {
-            /* ignore */
+        return null;
+    }
+    _extractMentionedFiles(_toolName, result) {
+        if (typeof result === 'object' && result !== null) {
+            const obj = result;
+            const files = obj.files || obj.mentionedFiles;
+            if (Array.isArray(files)) {
+                return files.filter((f) => typeof f === 'string');
+            }
         }
+        return [];
+    }
+    _inferModule(filePath) {
+        const parts = filePath.replace(/\\/g, '/').split('/');
+        const meaningful = parts.slice(1, -1).filter((p) => !['src', 'lib', 'Sources'].includes(p));
+        return meaningful.slice(0, 2).join('/') || null;
     }
     /**
      * 解析工具名到 handler 函数（V3 整合版）
      */
     _resolveHandler(name) {
         const HANDLER_MAP = {
-            // ── Agent 层 (18) ──
+            // ── Agent 层 ──
             autosnippet_health: (ctx) => systemHandlers.health(ctx),
-            autosnippet_capabilities: () => systemHandlers.capabilities(),
             autosnippet_search: (ctx, args) => consolidated.consolidatedSearch(ctx, args),
             autosnippet_knowledge: (ctx, args) => consolidated.consolidatedKnowledge(ctx, args),
             autosnippet_structure: (ctx, args) => consolidated.consolidatedStructure(ctx, args),
@@ -326,20 +358,16 @@ export class McpServer {
             autosnippet_graph: (ctx, args) => consolidated.consolidatedGraph(ctx, args),
             autosnippet_guard: (ctx, args) => consolidated.consolidatedGuard(ctx, args),
             autosnippet_submit_knowledge: (ctx, args) => consolidated.enhancedSubmitKnowledge(ctx, args),
-            autosnippet_submit_knowledge_batch: (ctx, args) => knowledgeHandlers.submitKnowledgeBatch(ctx, args),
-            autosnippet_save_document: (ctx, args) => knowledgeHandlers.saveDocument(ctx, args),
             autosnippet_skill: (ctx, args) => consolidated.consolidatedSkill(ctx, args),
             autosnippet_task: (ctx, args) => taskHandler(ctx, args),
+            autosnippet_panorama: (ctx, args) => panoramaHandler(ctx, args),
             // ── External Agent Bootstrap (v3.1) ──
             autosnippet_bootstrap: (ctx, _args) => bootstrapExternal(ctx),
             autosnippet_dimension_complete: (ctx, args) => dimensionComplete(ctx, args),
-            autosnippet_wiki_plan: (ctx, args) => wikiPlan(ctx, args),
-            autosnippet_wiki_finalize: (ctx, args) => wikiFinalize(ctx, args),
+            autosnippet_wiki: (ctx, args) => wikiRouter(ctx, args),
             // ── Admin 层 (+4) ──
             autosnippet_enrich_candidates: (ctx, args) => candidateHandlers.enrichCandidates(ctx, args),
             autosnippet_knowledge_lifecycle: (ctx, args) => knowledgeHandlers.knowledgeLifecycle(ctx, args),
-            autosnippet_validate_candidate: (ctx, args) => candidateHandlers.validateCandidate(ctx, args),
-            autosnippet_check_duplicate: (ctx, args) => candidateHandlers.checkDuplicate(ctx, args),
         };
         return HANDLER_MAP[name] ?? null;
     }

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

@@ -31,8 +31,6 @@ const AUTO_APPROVE_TOOLS = [
     'autosnippet_graph',
     'autosnippet_guard',
     'autosnippet_submit_knowledge',
-    'autosnippet_submit_knowledge_batch',
-    'autosnippet_save_document',
     'autosnippet_skill',
     'autosnippet_task',
     'autosnippet_bootstrap',

package/dist/lib/external/mcp/handlers/bootstrap/MissionBriefingBuilder.d.ts

@@ -252,6 +252,29 @@ interface MissionBriefing {
         totalDimensions: number;
         workflow: string;
     };
+    panorama: {
+        layers: Array<{
+            level: number;
+            name: string;
+            modules: string[];
+        }>;
+        couplingHotspots: Array<{
+            module: string;
+            fanIn: number;
+            fanOut: number;
+        }>;
+        cyclicDependencies: Array<{
+            cycle: string[];
+            severity: string;
+        }>;
+        knowledgeGaps: Array<{
+            dimension: string;
+            dimensionName: string;
+            recipeCount: number;
+            status: string;
+            priority: string;
+        }>;
+    } | null;
     session: Record<string, unknown>;
     meta?: {
         responseSizeKB: number;
@@ -276,6 +299,7 @@ interface MissionBriefingParams {
     languageExtension?: unknown;
     incrementalPlan?: IncrementalPlan | null;
     languageStats?: Record<string, number> | null;
+    panoramaResult?: Record<string, unknown> | null;
 }
 /**
  * 构建 Mission Briefing
@@ -293,5 +317,6 @@ interface MissionBriefingParams {
  */
 export declare function buildMissionBriefing({ projectMeta, astData, codeEntityResult, callGraphResult, depGraphData, guardAudit, targets, activeDimensions, session, languageExtension, // §7.1: 语言扩展（反模式、Guard 规则、Agent 注意事项）
 incrementalPlan, // §7.3: 增量 Bootstrap 评估结果
-languageStats, }: MissionBriefingParams): MissionBriefing;
+languageStats, // §7.4: 完整语言分布统计
+panoramaResult, }: MissionBriefingParams): MissionBriefing;
 export {};