autosnippet 3.3.0 → 3.3.3

package/dist/lib/shared/schemas/mcp-tools.d.ts

@@ -104,13 +104,25 @@ export declare const CallContextInput: z.ZodObject<{
 }, z.core.$strip>;
 export type CallContextInput = z.infer<typeof CallContextInput>;
 export declare const GuardInput: z.ZodObject<{
+    operation: z.ZodOptional<z.ZodEnum<{
+        check: "check";
+        review: "review";
+        reverse_audit: "reverse_audit";
+        coverage_matrix: "coverage_matrix";
+        compliance_report: "compliance_report";
+    }>>;
     files: z.ZodOptional<z.ZodArray<z.ZodString>>;
     code: z.ZodOptional<z.ZodString>;
     language: z.ZodOptional<z.ZodString>;
     filePath: z.ZodOptional<z.ZodString>;
+    maxFiles: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type GuardInput = z.infer<typeof GuardInput>;
-export declare const SubmitKnowledgeInput: z.ZodObject<{
+/**
+ * 单条知识条目字段定义（items 数组内部元素的严格 Schema）
+ * 用于文档/类型推导，实际 items 使用 z.record() 宽容接收后在 handler 层校验。
+ */
+export declare const SubmitKnowledgeItemSchema: z.ZodObject<{
     title: z.ZodString;
     language: z.ZodString;
     content: z.ZodObject<{
@@ -162,40 +174,25 @@ export declare const SubmitKnowledgeInput: z.ZodObject<{
     moduleName: z.ZodOptional<z.ZodString>;
     includeHeaders: z.ZodOptional<z.ZodBoolean>;
     source: z.ZodOptional<z.ZodString>;
-    client_id: z.ZodOptional<z.ZodString>;
-    skipDuplicateCheck: z.ZodDefault<z.ZodBoolean>;
-    dimensionId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-export type SubmitKnowledgeInput = z.infer<typeof SubmitKnowledgeInput>;
-export declare const SubmitKnowledgeBatchInput: z.ZodObject<{
-    target_name: z.ZodString;
+export declare const SubmitKnowledgeInput: z.ZodObject<{
     items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    source: z.ZodDefault<z.ZodString>;
-    deduplicate: z.ZodDefault<z.ZodBoolean>;
+    target_name: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodString>;
+    skipConsolidation: z.ZodDefault<z.ZodBoolean>;
+    skipDuplicateCheck: z.ZodDefault<z.ZodBoolean>;
     client_id: z.ZodOptional<z.ZodString>;
     dimensionId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-export type SubmitKnowledgeBatchInput = z.infer<typeof SubmitKnowledgeBatchInput>;
-export declare const SaveDocumentInput: z.ZodObject<{
-    title: z.ZodString;
-    markdown: z.ZodString;
-    description: z.ZodOptional<z.ZodString>;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    scope: z.ZodDefault<z.ZodEnum<{
-        universal: "universal";
-        "project-specific": "project-specific";
-    }>>;
-    source: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type SaveDocumentInput = z.infer<typeof SaveDocumentInput>;
+export type SubmitKnowledgeInput = z.infer<typeof SubmitKnowledgeInput>;
 export declare const SkillInput: z.ZodObject<{
     operation: z.ZodEnum<{
         delete: "delete";
         create: "create";
         update: "update";
         list: "list";
-        suggest: "suggest";
         load: "load";
+        suggest: "suggest";
     }>;
     name: z.ZodOptional<z.ZodString>;
     skillName: z.ZodOptional<z.ZodString>;
@@ -224,88 +221,38 @@ export declare const DimensionCompleteInput: z.ZodObject<{
     crossDimensionHints: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, z.core.$strip>;
 export type DimensionCompleteInput = z.infer<typeof DimensionCompleteInput>;
-export declare const WikiPlanInput: z.ZodObject<{
-    language: z.ZodDefault<z.ZodEnum<{
+export declare const WikiInput: z.ZodObject<{
+    operation: z.ZodEnum<{
+        plan: "plan";
+        finalize: "finalize";
+    }>;
+    language: z.ZodOptional<z.ZodEnum<{
         en: "en";
         zh: "zh";
     }>>;
     sessionId: z.ZodOptional<z.ZodString>;
+    articlesWritten: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
-export type WikiPlanInput = z.infer<typeof WikiPlanInput>;
-export declare const WikiFinalizeInput: z.ZodObject<{
-    articlesWritten: z.ZodArray<z.ZodString>;
-}, z.core.$strip>;
-export type WikiFinalizeInput = z.infer<typeof WikiFinalizeInput>;
+export type WikiInput = z.infer<typeof WikiInput>;
 export declare const CapabilitiesInput: z.ZodObject<{}, z.core.$strip>;
 export type CapabilitiesInput = z.infer<typeof CapabilitiesInput>;
 export declare const TaskInput: z.ZodObject<{
     operation: z.ZodEnum<{
         create: "create";
-        stats: "stats";
         close: "close";
-        progress: "progress";
-        blocked: "blocked";
-        list: "list";
-        ready: "ready";
         prime: "prime";
-        claim: "claim";
         fail: "fail";
-        defer: "defer";
-        show: "show";
-        decompose: "decompose";
-        dep_add: "dep_add";
-        dep_tree: "dep_tree";
         record_decision: "record_decision";
-        revise_decision: "revise_decision";
-        unpin_decision: "unpin_decision";
-        list_decisions: "list_decisions";
     }>;
     title: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
-    design: z.ZodOptional<z.ZodString>;
-    acceptance: z.ZodOptional<z.ZodString>;
-    priority: z.ZodOptional<z.ZodNumber>;
-    taskType: z.ZodOptional<z.ZodEnum<{
-        task: "task";
-        epic: "epic";
-        bug: "bug";
-        chore: "chore";
-    }>>;
-    parentId: z.ZodOptional<z.ZodString>;
     id: z.ZodOptional<z.ZodString>;
     reason: z.ZodOptional<z.ZodString>;
     rationale: z.ZodOptional<z.ZodString>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    relatedTaskId: z.ZodOptional<z.ZodString>;
-    dependsOn: z.ZodOptional<z.ZodString>;
-    depType: z.ZodDefault<z.ZodEnum<{
-        blocks: "blocks";
-        related: "related";
-        "waits-for": "waits-for";
-        "parent-child": "parent-child";
-        "discovered-from": "discovered-from";
-        "knowledge-ref": "knowledge-ref";
-        supersedes: "supersedes";
-    }>>;
-    limit: z.ZodDefault<z.ZodNumber>;
-    status: z.ZodOptional<z.ZodEnum<{
-        open: "open";
-        closed: "closed";
-        pinned: "pinned";
-        in_progress: "in_progress";
-        deferred: "deferred";
-    }>>;
-    withKnowledge: z.ZodDefault<z.ZodBoolean>;
     userQuery: z.ZodOptional<z.ZodString>;
     activeFile: z.ZodOptional<z.ZodString>;
     language: z.ZodOptional<z.ZodString>;
-    subtasks: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        title: z.ZodString;
-        description: z.ZodOptional<z.ZodString>;
-        priority: z.ZodOptional<z.ZodNumber>;
-        taskType: z.ZodOptional<z.ZodString>;
-        blockedByIndex: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type TaskInput = z.infer<typeof TaskInput>;
 export declare const EnrichCandidatesInput: z.ZodObject<{
@@ -327,20 +274,18 @@ export declare const KnowledgeLifecycleInput: z.ZodObject<{
     reason: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type KnowledgeLifecycleInput = z.infer<typeof KnowledgeLifecycleInput>;
-export declare const ValidateCandidateInput: z.ZodObject<{
-    candidate: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-    strict: z.ZodDefault<z.ZodBoolean>;
-}, z.core.$strip>;
-export type ValidateCandidateInput = z.infer<typeof ValidateCandidateInput>;
-export declare const CheckDuplicateInput: z.ZodObject<{
-    candidate: z.ZodObject<{
-        title: z.ZodOptional<z.ZodString>;
-        summary: z.ZodOptional<z.ZodString>;
-        usageGuide: z.ZodOptional<z.ZodString>;
-        code: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>;
-    threshold: z.ZodDefault<z.ZodNumber>;
-    topK: z.ZodDefault<z.ZodNumber>;
+export declare const PanoramaInput: z.ZodObject<{
+    operation: z.ZodDefault<z.ZodEnum<{
+        overview: "overview";
+        gaps: "gaps";
+        module: "module";
+        health: "health";
+        enhancement_suggestions: "enhancement_suggestions";
+        governance_cycle: "governance_cycle";
+        decay_report: "decay_report";
+        staging_check: "staging_check";
+    }>>;
+    module: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-export type CheckDuplicateInput = z.infer<typeof CheckDuplicateInput>;
+export type PanoramaInput = z.infer<typeof PanoramaInput>;
 export declare const TOOL_SCHEMAS: Record<string, z.ZodType>;

package/dist/lib/shared/schemas/mcp-tools.js

@@ -99,15 +99,24 @@ export const CallContextInput = z.object({
 //  7. autosnippet_guard
 // ══════════════════════════════════════════════════════
 export const GuardInput = z.object({
+    operation: z
+        .enum(['check', 'review', 'reverse_audit', 'coverage_matrix', 'compliance_report'])
+        .optional()
+        .describe('Guard 操作类型。reverse_audit: Recipe→Code 反向验证；coverage_matrix: 模块覆盖率矩阵；compliance_report: 3D 合规报告（含 uncertain）。省略则按 code/files 自动路由。'),
     files: z.array(z.string()).optional(),
     code: z.string().optional(),
     language: z.string().optional(),
     filePath: z.string().optional(),
+    maxFiles: z.number().optional().describe('reverse_audit/coverage_matrix 时扫描的最大文件数'),
 });
 // ══════════════════════════════════════════════════════
-//  7b. autosnippet_submit_knowledge
+//  7b. autosnippet_submit_knowledge (unified pipeline)
 // ══════════════════════════════════════════════════════
-export const SubmitKnowledgeInput = z.object({
+/**
+ * 单条知识条目字段定义（items 数组内部元素的严格 Schema）
+ * 用于文档/类型推导，实际 items 使用 z.record() 宽容接收后在 handler 层校验。
+ */
+export const SubmitKnowledgeItemSchema = z.object({
     // ── 必填字段 ──
     title: TitleField.describe('知识标题，简洁明确'),
     language: LanguageField.describe('编程语言，如 typescript/swift/python'),
@@ -148,37 +157,22 @@ export const SubmitKnowledgeInput = z.object({
     moduleName: z.string().optional(),
     includeHeaders: z.boolean().optional(),
     source: z.string().optional(),
-    client_id: z.string().optional(),
-    skipDuplicateCheck: z.boolean().default(false),
-    dimensionId: z.string().optional(),
 });
-// ══════════════════════════════════════════════════════
-//  8. autosnippet_submit_knowledge_batch
-// ══════════════════════════════════════════════════════
-export const SubmitKnowledgeBatchInput = z.object({
-    target_name: z
-        .string()
-        .min(1, 'target_name is required')
-        .describe('批量来源标识，如 network-module-scan'),
+export const SubmitKnowledgeInput = z.object({
     items: z
         .array(z.record(z.string(), z.unknown()))
-        .min(1, 'items array must not be empty')
-        .describe('知识条目数组，每条字段同 submit_knowledge。content/reasoning 必须是对象'),
-    source: z.string().default('cursor-scan'),
-    deduplicate: z.boolean().default(true).describe('基于 title 自动去重，默认开启'),
+        .min(1)
+        .describe('知识条目数组（1~N 条）。单条与批量统一处理，所有条目严格校验 + 融合分析。' +
+        '每条字段: title, language, content(对象), kind, doClause, dontClause, whenClause, coreCode, category, trigger, description, headers, usageGuide, knowledgeType, reasoning(对象)。'),
+    target_name: z.string().optional().describe('来源标识，如 network-module-scan'),
+    source: z.string().optional().describe('来源标记，默认 mcp'),
+    skipConsolidation: z
+        .boolean()
+        .default(false)
+        .describe('跳过融合分析（当确认需要独立新建时设为 true）'),
+    skipDuplicateCheck: z.boolean().default(false),
     client_id: z.string().optional(),
-    dimensionId: z.string().optional().describe('冷启动时关联维度 ID'),
-});
-// ══════════════════════════════════════════════════════
-//  9. autosnippet_save_document
-// ══════════════════════════════════════════════════════
-export const SaveDocumentInput = z.object({
-    title: TitleField,
-    markdown: z.string().min(1, 'markdown content is required'),
-    description: z.string().optional(),
-    tags: z.array(z.string()).optional(),
-    scope: z.enum(['universal', 'project-specific']).default('project-specific'),
-    source: z.string().optional(),
+    dimensionId: z.string().optional().describe('冷启动关联维度 ID'),
 });
 // ══════════════════════════════════════════════════════
 //  10. autosnippet_skill
@@ -216,91 +210,41 @@ export const DimensionCompleteInput = z.object({
     crossDimensionHints: z.record(z.string(), z.string()).optional(),
 });
 // ══════════════════════════════════════════════════════
-//  11c. autosnippet_wiki_plan
+//  11c. autosnippet_wiki (merged: plan + finalize)
 // ══════════════════════════════════════════════════════
-export const WikiPlanInput = z.object({
-    language: z.enum(['zh', 'en']).default('zh'),
+export const WikiInput = z.object({
+    operation: z
+        .enum(['plan', 'finalize'])
+        .describe('plan — 规划主题 + 数据包; finalize — 写入 meta.json + 验证'),
+    // plan 参数
+    language: z.enum(['zh', 'en']).optional().describe('Wiki 语言，默认 zh'),
     sessionId: z.string().optional(),
-});
-// ══════════════════════════════════════════════════════
-//  11d. autosnippet_wiki_finalize
-// ══════════════════════════════════════════════════════
-export const WikiFinalizeInput = z.object({
-    articlesWritten: z.array(z.string()).min(1, 'articlesWritten must not be empty'),
+    // finalize 参数
+    articlesWritten: z.array(z.string()).optional(),
 });
 // ══════════════════════════════════════════════════════
 //  12. autosnippet_capabilities — 无参数
 // ══════════════════════════════════════════════════════
 export const CapabilitiesInput = z.object({});
 // ══════════════════════════════════════════════════════
-//  13. autosnippet_task
+//  13. autosnippet_task (5 operations)
 // ══════════════════════════════════════════════════════
 export const TaskInput = z.object({
     operation: z
-        .enum([
-        'prime',
-        'ready',
-        'create',
-        'claim',
-        'close',
-        'fail',
-        'defer',
-        'progress',
-        'show',
-        'list',
-        'stats',
-        'blocked',
-        'decompose',
-        'dep_add',
-        'dep_tree',
-        'record_decision',
-        'revise_decision',
-        'unpin_decision',
-        'list_decisions',
-    ])
-        .describe('会话: prime(首选) | ready。任务: create/claim/close/fail/defer/progress/show/list/stats/blocked。分解: decompose/dep_add/dep_tree。决策: record_decision/revise_decision/unpin_decision/list_decisions'),
-    title: z.string().optional(),
-    description: z.string().optional(),
-    design: z.string().optional(),
-    acceptance: z.string().optional(),
-    priority: z.number().int().min(0).max(4).optional(),
-    taskType: z.enum(['epic', 'task', 'bug', 'chore']).optional(),
-    parentId: z.string().optional(),
-    id: z.string().optional(),
-    reason: z.string().optional(),
-    rationale: z.string().optional(),
-    tags: z.array(z.string()).optional(),
-    relatedTaskId: z.string().optional(),
-    dependsOn: z.string().optional(),
-    depType: z
-        .enum([
-        'blocks',
-        'parent-child',
-        'waits-for',
-        'discovered-from',
-        'related',
-        'knowledge-ref',
-        'supersedes',
-    ])
-        .default('blocks'),
-    limit: z.number().int().min(1).max(200).default(10),
-    status: z.enum(['open', 'in_progress', 'deferred', 'closed', 'pinned']).optional(),
-    withKnowledge: z.boolean().default(true),
+        .enum(['prime', 'create', 'close', 'fail', 'record_decision'])
+        .describe('prime=加载知识上下文 | create=创建任务锚点 | close=完成+Guard | fail=放弃 | record_decision=记录用户偏好'),
+    title: z.string().optional().describe('Task or decision title (create / record_decision)'),
+    description: z.string().optional().describe('Decision description (record_decision)'),
+    id: z.string().optional().describe('Task ID (close / fail)'),
+    reason: z.string().optional().describe('Close reason or fail reason'),
+    rationale: z.string().optional().describe('Decision rationale (record_decision)'),
+    tags: z.array(z.string()).optional().describe('Decision tags (record_decision)'),
     userQuery: z
         .string()
         .optional()
         .describe('User current input / prompt text for knowledge-aware search'),
     activeFile: z.string().optional().describe('Currently active file path in IDE'),
     language: z.string().optional().describe('Current programming language'),
-    subtasks: z
-        .array(z.object({
-        title: z.string().min(1),
-        description: z.string().optional(),
-        priority: z.number().int().min(0).max(4).optional(),
-        taskType: z.string().optional(),
-        blockedByIndex: z.number().int().min(0).optional(),
-    }))
-        .optional(),
 });
 // ══════════════════════════════════════════════════════
 //  Admin Tools
@@ -329,21 +273,22 @@ export const KnowledgeLifecycleInput = z.object({
         .describe('approve/fast_track=发布 | reject=拒绝 | deprecate=废弃 | reactivate=恢复 | to_draft=回草稿'),
     reason: z.string().optional().describe('reject/deprecate 时的理由'),
 });
-// 16. autosnippet_validate_candidate
-export const ValidateCandidateInput = z.object({
-    candidate: z.record(z.string(), z.unknown()),
-    strict: z.boolean().default(false),
-});
-// 17. autosnippet_check_duplicate
-export const CheckDuplicateInput = z.object({
-    candidate: z.object({
-        title: z.string().optional(),
-        summary: z.string().optional(),
-        usageGuide: z.string().optional(),
-        code: z.string().optional(),
-    }),
-    threshold: z.number().min(0).max(1).default(0.7),
-    topK: z.number().int().min(1).max(50).default(5),
+// 18. autosnippet_panorama
+export const PanoramaInput = z.object({
+    operation: z
+        .enum([
+        'overview',
+        'module',
+        'gaps',
+        'health',
+        'governance_cycle',
+        'decay_report',
+        'staging_check',
+        'enhancement_suggestions',
+    ])
+        .default('overview')
+        .describe('overview=项目骨架+层级+模块角色 | module=单模块详情+邻居关系 | gaps=知识空白区 | health=全景健康度 | governance_cycle=新陈代谢完整周期 | decay_report=衰退报告 | staging_check=staging检查+自动发布 | enhancement_suggestions=增强建议'),
+    module: z.string().optional().describe('模块名称（operation=module 时必填）'),
 });
 // ══════════════════════════════════════════════════════
 //  工具名 → Schema 映射表（用于 wrapHandler 自动注入校验）
@@ -357,17 +302,12 @@ export const TOOL_SCHEMAS = {
     autosnippet_call_context: CallContextInput,
     autosnippet_guard: GuardInput,
     autosnippet_submit_knowledge: SubmitKnowledgeInput,
-    autosnippet_submit_knowledge_batch: SubmitKnowledgeBatchInput,
-    autosnippet_save_document: SaveDocumentInput,
     autosnippet_skill: SkillInput,
     autosnippet_bootstrap: BootstrapInput,
     autosnippet_dimension_complete: DimensionCompleteInput,
-    autosnippet_wiki_plan: WikiPlanInput,
-    autosnippet_wiki_finalize: WikiFinalizeInput,
-    autosnippet_capabilities: CapabilitiesInput,
+    autosnippet_wiki: WikiInput,
     autosnippet_task: TaskInput,
     autosnippet_enrich_candidates: EnrichCandidatesInput,
     autosnippet_knowledge_lifecycle: KnowledgeLifecycleInput,
-    autosnippet_validate_candidate: ValidateCandidateInput,
-    autosnippet_check_duplicate: CheckDuplicateInput,
+    autosnippet_panorama: PanoramaInput,
 };

package/dist/scripts/analyze-signals.d.ts

@@ -0,0 +1,20 @@
+#!/usr/bin/env npx tsx
+/**
+ * analyze-signals.ts — JSONL Signal Analyzer
+ *
+ * Reads intent chain records from .autosnippet/logs/signals/*.jsonl and produces
+ * summary analytics for evaluating the Intent Pipeline effectiveness.
+ *
+ * Usage: npx tsx scripts/analyze-signals.ts [project-root]
+ *
+ * Metrics:
+ *   1. Recipe coverage rate
+ *   2. Scenario distribution
+ *   3. Multi-query benefit (filtered count)
+ *   4. Language distribution
+ *   5. Drift → violation correlation
+ *   6. Task completion rate
+ *   7. Average intent duration
+ *   8. Search → drift correlation
+ */
+export {};

package/dist/scripts/analyze-signals.js

@@ -0,0 +1,155 @@
+#!/usr/bin/env npx tsx
+/**
+ * analyze-signals.ts — JSONL Signal Analyzer
+ *
+ * Reads intent chain records from .autosnippet/logs/signals/*.jsonl and produces
+ * summary analytics for evaluating the Intent Pipeline effectiveness.
+ *
+ * Usage: npx tsx scripts/analyze-signals.ts [project-root]
+ *
+ * Metrics:
+ *   1. Recipe coverage rate
+ *   2. Scenario distribution
+ *   3. Multi-query benefit (filtered count)
+ *   4. Language distribution
+ *   5. Drift → violation correlation
+ *   6. Task completion rate
+ *   7. Average intent duration
+ *   8. Search → drift correlation
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+// ── Load Records ────────────────────────────────────
+function loadRecords(signalDir) {
+    if (!fs.existsSync(signalDir)) {
+        console.error(`Signal directory not found: ${signalDir}`);
+        return [];
+    }
+    const files = fs
+        .readdirSync(signalDir)
+        .filter((f) => f.endsWith('.jsonl'))
+        .sort();
+    const records = [];
+    for (const file of files) {
+        const content = fs.readFileSync(path.join(signalDir, file), 'utf8');
+        for (const line of content.split('\n')) {
+            if (!line.trim()) {
+                continue;
+            }
+            try {
+                records.push(JSON.parse(line));
+            }
+            catch {
+                // skip malformed lines
+            }
+        }
+    }
+    return records;
+}
+// ── Analyze ─────────────────────────────────────────
+function analyze(records) {
+    if (records.length === 0) {
+        console.log('No records found.');
+        return;
+    }
+    console.log(`\n📊 Intent Signal Analysis — ${records.length} records\n`);
+    // 1. Recipe coverage rate
+    const withRecipes = records.filter((r) => r.primeRecipeIds.length > 0).length;
+    console.log(`1. Recipe coverage: ${withRecipes}/${records.length} (${pct(withRecipes, records.length)})`);
+    // 2. Scenario distribution
+    const scenarios = groupBy(records, (r) => r.primeScenario || 'unknown');
+    console.log('2. Scenario distribution:');
+    for (const [scenario, items] of Object.entries(scenarios)) {
+        console.log(`   ${scenario}: ${items.length} (${pct(items.length, records.length)})`);
+    }
+    // 3. Multi-query benefit
+    const withMeta = records.filter((r) => r.searchMeta);
+    if (withMeta.length > 0) {
+        const avgFiltered = avg(withMeta.map((r) => r.searchMeta.filteredCount));
+        const avgResult = avg(withMeta.map((r) => r.searchMeta.resultCount));
+        const avgQueries = avg(withMeta.map((r) => r.searchMeta.queries.length));
+        console.log(`3. Multi-query: avg ${avgQueries.toFixed(1)} queries → ${avgResult.toFixed(1)} results → ${avgFiltered.toFixed(1)} filtered`);
+    }
+    else {
+        console.log('3. Multi-query: no searchMeta data');
+    }
+    // 4. Language distribution
+    const languages = groupBy(records, (r) => r.primeLanguage || 'unknown');
+    console.log('4. Language distribution:');
+    for (const [lang, items] of Object.entries(languages)) {
+        console.log(`   ${lang}: ${items.length}`);
+    }
+    // 5. Drift → violation correlation
+    const withDrift = records.filter((r) => r.driftScore > 0);
+    const withViolations = records.filter((r) => (r.guardViolations ?? 0) > 0);
+    console.log(`5. Drift: ${withDrift.length} records with drift, ${withViolations.length} with violations`);
+    if (withDrift.length > 0) {
+        const avgDriftScore = avg(withDrift.map((r) => r.driftScore));
+        console.log(`   avg drift score: ${avgDriftScore.toFixed(3)}`);
+    }
+    // 6. Task completion rate
+    const withTask = records.filter((r) => r.taskId);
+    const completed = records.filter((r) => r.outcome === 'completed');
+    const failed = records.filter((r) => r.outcome === 'failed');
+    const abandoned = records.filter((r) => r.outcome === 'abandoned');
+    console.log(`6. Outcomes: ${completed.length} completed, ${failed.length} failed, ${abandoned.length} abandoned`);
+    if (withTask.length > 0) {
+        console.log(`   Task completion: ${completed.length}/${withTask.length} (${pct(completed.length, withTask.length)})`);
+    }
+    // 7. Average intent duration
+    const durations = records.filter((r) => r.duration > 0).map((r) => r.duration);
+    if (durations.length > 0) {
+        const avgDur = avg(durations);
+        const medDur = median(durations);
+        console.log(`7. Duration: avg ${formatMs(avgDur)}, median ${formatMs(medDur)}`);
+    }
+    // 8. High-drift intents
+    const highDrift = records.filter((r) => r.driftScore > 0.5);
+    const highDriftWithManySearches = highDrift.filter((r) => r.searchQueries.length > 2);
+    console.log(`8. High-drift (>0.5): ${highDrift.length}, of which ${highDriftWithManySearches.length} had >2 search queries`);
+    console.log('');
+}
+// ── Helpers ─────────────────────────────────────────
+function groupBy(items, key) {
+    const groups = {};
+    for (const item of items) {
+        const k = key(item);
+        (groups[k] ??= []).push(item);
+    }
+    return groups;
+}
+function avg(nums) {
+    if (nums.length === 0) {
+        return 0;
+    }
+    return nums.reduce((a, b) => a + b, 0) / nums.length;
+}
+function median(nums) {
+    if (nums.length === 0) {
+        return 0;
+    }
+    const sorted = [...nums].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    return sorted.length % 2 === 0 ? (sorted[mid - 1] + sorted[mid]) / 2 : sorted[mid];
+}
+function pct(n, total) {
+    if (total === 0) {
+        return '0%';
+    }
+    return `${Math.round((n / total) * 100)}%`;
+}
+function formatMs(ms) {
+    if (ms < 1000) {
+        return `${Math.round(ms)}ms`;
+    }
+    if (ms < 60000) {
+        return `${(ms / 1000).toFixed(1)}s`;
+    }
+    return `${(ms / 60000).toFixed(1)}min`;
+}
+// ── Main ────────────────────────────────────────────
+const projectRoot = process.argv[2] || process.env.ASD_PROJECT_DIR || process.cwd();
+const signalDir = path.join(projectRoot, '.autosnippet', 'logs', 'signals');
+console.log(`Reading signals from: ${signalDir}`);
+const records = loadRecords(signalDir);
+analyze(records);

package/dist/scripts/diagnose-mcp.js

@@ -69,7 +69,7 @@ function request(method, urlStr) {
             env,
         },
         next: [
-            '在 MCP 客户端调用 autosnippet_health / autosnippet_capabilities 进行能力自检',
+            '在 MCP 客户端调用 autosnippet_health 进行能力自检',
             '如需鉴权，请在 MCP 服务器环境设置 ASD_MCP_TOKEN',
             '提交候选时传入 clientId 以启用限流（避免短时间批量提交）',
         ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autosnippet",
-  "version": "3.3.0",
+  "version": "3.3.3",
   "description": "Extract code patterns into a knowledge base for AI coding assistants",
   "type": "module",
   "main": "dist/lib/bootstrap.js",