autosnippet 3.3.0 → 3.3.3

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 Tool Definitions — V3 Consolidated (14 agent + 2 admin = 16 tools)
  *
- * 每个工具声明包含 name、tier（agent/admin）、description 和 inputSchema。
- * description 是 Agent 选择工具的关键 — 使用 bullet list 列出所有 operation 及其用途。
- * inputSchema 由 Zod Schema 自动生成（zodToMcpSchema），参数的 .describe() 会转为 JSON Schema description。
+ * Each tool declaration contains name, tier (agent/admin), description, and inputSchema.
+ * description is the key for Agent tool selection — use bullet list to enumerate all operations and their purposes.
+ * inputSchema is auto-generated from Zod Schema (zodToMcpSchema); parameter .describe() translates to JSON Schema description.
  *
- * Agent 工具 (18):
- *   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)
+ * Agent tools (14):
+ *   1-7:   Query tools (health/search/knowledge/structure/graph/call_context/guard)
+ *   8:     Write tool (submit_knowledge — unified pipeline, single/batch)
+ *   9:     Skill management (skill)
+ *   10-12: Cold-start (bootstrap/dimension_complete/wiki)
+ *   13:    Project panorama (panorama)
+ *   14:    Task management (task — 5 ops: prime/create/close/fail/record_decision)
  *
- * Admin 工具 (4):
- *   18-21: enrich_candidates/knowledge_lifecycle/validate_candidate/check_duplicate
+ * Admin tools (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;