autosnippet 3.3.4 → 3.3.6

package/dist/lib/types/project-snapshot.d.ts

@@ -0,0 +1,399 @@
+/**
+ * ProjectSnapshot — 统一项目快照类型定义
+ *
+ * 这是所有 Phase 1-4 数据的唯一类型来源（Single Source of Truth）。
+ * 消除了之前在 bootstrap-phases.ts、MissionBriefingBuilder.ts、
+ * handler-types.ts、rescan-internal.ts 等文件中重复定义的类型。
+ *
+ * 设计原则：
+ *   1. **不可变** — 创建后通过 Object.freeze 冻结
+ *   2. **完整** — 包含 Phase 1-4 全部产出
+ *   3. **类型化** — 每个字段有明确接口，不使用 `any`
+ *   4. **单一定义** — 项目分析数据的唯一类型来源
+ *
+ * @module types/project-snapshot
+ * @see docs/copilot/unified-project-snapshot-design.md
+ */
+/** 项目级别的文件信息，来自 Phase 1 扫描 */
+export interface SnapshotFile {
+    name: string;
+    path: string;
+    relativePath: string;
+    content: string;
+    targetName: string;
+    language?: string;
+    totalLines?: number;
+    priority?: string;
+    truncated?: boolean;
+}
+/** 构建目标 (Target)，来自 Phase 1 Discoverer */
+export interface SnapshotTarget {
+    name: string;
+    type?: string;
+    framework?: string;
+    packageName?: string;
+    inferredRole?: string;
+    fileCount?: number;
+    /** 标记来自子包的 target */
+    isLocalPackage?: boolean;
+}
+/** 本地子包模块信息 */
+export interface LocalPackageModule {
+    name: string;
+    packageName: string;
+    fileCount: number;
+    inferredRole?: string;
+    keyFiles?: string[];
+}
+/** 语言统计 */
+export interface LanguageProfile {
+    primaryLang: string;
+    stats: Record<string, number>;
+    secondary?: string[];
+    isMultiLang?: boolean;
+}
+/** AST 分析摘要，来自 Phase 1.5 */
+export interface AstSummary {
+    classes?: AstClassInfo[];
+    protocols?: AstProtocolInfo[];
+    categories?: AstCategoryInfo[];
+    fileSummaries?: AstFileSummary[];
+    patternStats?: Record<string, unknown>;
+    projectMetrics?: ProjectMetrics;
+    fileCount?: number;
+}
+export interface AstClassInfo {
+    name: string;
+    superclass?: string;
+    methodCount?: number;
+    methods?: unknown[];
+    protocols?: string[];
+    conformedProtocols?: string[];
+    file?: string;
+    relativePath?: string;
+    targetName?: string;
+}
+export interface AstProtocolInfo {
+    name: string;
+    file?: string;
+    relativePath?: string;
+    methodCount?: number;
+    methods?: unknown[];
+    conformers?: string[];
+    targetName?: string;
+}
+export interface AstCategoryInfo {
+    baseClass?: string;
+    extendedClass?: string;
+    name?: string;
+    file?: string;
+    relativePath?: string;
+    methods?: Array<string | {
+        name: string;
+    }>;
+}
+export interface AstMethodInfo {
+    name: string;
+    className?: string;
+    isAsync?: boolean;
+    complexity?: number;
+    file?: string;
+    line?: number;
+    lines?: number;
+    bodyLines?: number;
+    [key: string]: unknown;
+}
+export interface AstFileSummary {
+    exports?: unknown[];
+    methods?: AstMethodInfo[];
+}
+export interface ProjectMetrics {
+    totalMethods?: number;
+    complexMethods?: AstMethodInfo[];
+    longMethods?: AstMethodInfo[];
+    avgMethodsPerClass?: number;
+    maxNestingDepth?: number;
+}
+/** AST 上下文文本（用于 prompt），来自 Phase 1.5 */
+export type AstContext = string | null;
+/** 代码实体图结果，来自 Phase 1.6 */
+export interface CodeEntityGraphResult {
+    entitiesUpserted?: number;
+    edgesCreated?: number;
+    entityCount?: number;
+    edgeCount?: number;
+}
+/** 调用图结果，来自 Phase 1.7 */
+export interface CallGraphResult {
+    entitiesUpserted?: number;
+    edgesCreated?: number;
+    durationMs?: number;
+}
+/** 全景分析结果，来自 Phase 1.8 */
+export interface PanoramaResult {
+    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;
+    }>;
+    modules?: unknown;
+    gaps?: unknown;
+    [key: string]: unknown;
+}
+/** 依赖关系图，来自 Phase 2 */
+export interface DependencyGraph {
+    nodes?: Array<DependencyNode | string>;
+    edges?: Array<DependencyEdge>;
+    [key: string]: unknown;
+}
+export interface DependencyNode {
+    id?: string;
+    label?: string;
+    fileCount?: number;
+}
+export interface DependencyEdge {
+    from: string;
+    to: string;
+    type?: string;
+    [key: string]: unknown;
+}
+/** Guard 审计结果，来自 Phase 3 */
+export interface GuardAudit {
+    files?: GuardAuditFileEntry[];
+    summary?: GuardAuditSummary;
+    crossFileViolations?: GuardViolation[];
+    rules?: unknown[];
+    [key: string]: unknown;
+}
+export interface GuardAuditFileEntry {
+    filePath: string;
+    violations: GuardViolation[];
+}
+export interface GuardViolation {
+    ruleId?: string;
+    severity?: string;
+    message?: string;
+    line?: number;
+    fixSuggestion?: string | null;
+    locations?: Array<{
+        filePath: string;
+        line?: number;
+    }>;
+}
+export interface GuardAuditSummary {
+    totalErrors?: number;
+    totalWarnings?: number;
+    totalViolations?: number;
+    errors?: number;
+    warnings?: number;
+}
+/**
+ * 维度定义 (来自统一维度注册表 DimensionRegistry)
+ *
+ * 兼容旧 BaseDimension 字段 + 新 UnifiedDimension 字段
+ */
+export interface DimensionDef {
+    id: string;
+    label?: string;
+    guide?: string;
+    knowledgeTypes?: string[];
+    skillWorthy?: boolean;
+    skillMeta?: {
+        name: string;
+        description: string;
+    } | Record<string, unknown> | null;
+    dualOutput?: boolean;
+    tierHint?: number;
+    conditions?: {
+        languages?: string[];
+        frameworks?: string[];
+    };
+    /** 层级 (统一维度注册表新增) */
+    layer?: 'universal' | 'language' | 'framework';
+    /** 输出模式 (统一维度注册表新增) */
+    outputMode?: 'candidate-only';
+}
+/** Enhancement Pack 信息，来自 Phase 4 */
+export interface EnhancementPackInfo {
+    id: string;
+    displayName: string;
+    extraDimensions?: number;
+    guardRules?: number;
+    patterns?: Array<Record<string, unknown>>;
+}
+/** Phase 执行报告 */
+export interface PhaseReport {
+    phases: Record<string, Record<string, unknown>>;
+    startTime: number;
+    totalMs?: number;
+    [key: string]: unknown;
+}
+/** 增量计划（rescan 场景） */
+export interface IncrementalPlan {
+    mode?: string;
+    canIncremental?: boolean;
+    affectedDimensions?: string[];
+    skippedDimensions?: string[];
+    reason?: string;
+    diff?: {
+        added: unknown[];
+        modified: unknown[];
+        deleted: unknown[];
+        unchanged: unknown[];
+        changeRatio?: number;
+    };
+    dimensions?: Array<{
+        id: string;
+        status?: string;
+    }>;
+    changedFiles?: string[];
+    [key: string]: unknown;
+}
+/** 已有 Recipe 信息（rescan 去重 + lifecycle 感知） */
+export interface ExistingRecipeInfo {
+    id: string;
+    title: string;
+    trigger: string;
+    knowledgeType: string;
+    doClause?: string;
+    relevanceScore?: number;
+    verdict?: string;
+    /** lifecycle 感知状态（Evolution Agent 填充） */
+    status?: 'healthy' | 'decaying' | 'evolved' | 'deprecated';
+    /** 衰退原因（仅 decaying 状态） */
+    decayReason?: string;
+    /** 审计分数 0-100（来自 RecipeRelevanceAuditor） */
+    auditScore?: number;
+    /** Recipe 完整内容 — Evolution Agent 读取以验证真实性 */
+    content?: {
+        markdown?: string;
+        rationale?: string;
+        coreCode?: string;
+    };
+    /** 源文件引用列表 — Evolution Agent 读取以验证代码是否存在 */
+    sourceRefs?: string[];
+    /** 审计证据详情 — 作为 hint 提供给 Evolution Agent */
+    auditEvidence?: Record<string, unknown>;
+}
+/** Discoverer 摘要信息 */
+export interface DiscovererInfo {
+    id: string;
+    displayName: string;
+}
+/** Minimal shape of BootstrapSession */
+export interface BootstrapSessionShape {
+    id: string;
+    toJSON(): Record<string, unknown>;
+}
+/** Shape of the mission briefing returned by buildMissionBriefing */
+export interface MissionBriefingResult {
+    meta?: {
+        warnings?: string[];
+        responseSizeKB?: number;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+/**
+ * ProjectSnapshot 是 runAllPhases() 的完整产出。
+ *
+ * 设计原则：
+ * 1. **不可变** — 创建后不应被修改
+ * 2. **完整** — 包含所有 Phase 1-4 的产出
+ * 3. **类型化** — 每个字段有明确的接口，不使用 `any`
+ * 4. **单一定义** — 这是项目分析数据的唯一类型来源
+ *
+ * 用法：
+ * - `buildProjectSnapshot()` 从 runAllPhases() 返回值构建
+ * - 4 个 handler 从 snapshot 读取数据，不再解构/重组
+ * - `snapshot-views.ts` 提供面向消费者的衍生视图
+ */
+export interface ProjectSnapshot {
+    readonly version: string;
+    readonly timestamp: number;
+    readonly projectRoot: string;
+    readonly sourceTag?: string;
+    readonly allFiles: readonly SnapshotFile[];
+    readonly allTargets: readonly SnapshotTarget[];
+    readonly discoverer: DiscovererInfo;
+    readonly truncated: boolean;
+    readonly language: LanguageProfile;
+    readonly ast: AstSummary | null;
+    readonly astContext: AstContext;
+    readonly codeEntityGraph: CodeEntityGraphResult | null;
+    readonly callGraph: CallGraphResult | null;
+    readonly panorama: PanoramaResult | null;
+    readonly dependencyGraph: DependencyGraph | null;
+    readonly depEdgesWritten: number;
+    readonly guardAudit: GuardAudit | null;
+    readonly activeDimensions: readonly DimensionDef[];
+    readonly enhancementPackInfo: readonly EnhancementPackInfo[];
+    readonly enhancementPatterns: readonly Record<string, unknown>[];
+    readonly enhancementGuardRules: readonly unknown[];
+    readonly detectedFrameworks: readonly string[];
+    readonly langProfile: LanguageProfile;
+    readonly targetsSummary: readonly SnapshotTarget[];
+    readonly localPackageModules: readonly LocalPackageModule[];
+    readonly phaseReport: PhaseReport | null;
+    readonly warnings: readonly string[];
+    readonly incrementalPlan: IncrementalPlan | null;
+    readonly isEmpty: boolean;
+}
+/**
+ * 构建快照的输入参数
+ * 从 runAllPhases() 的松散返回值到类型化快照的桥梁
+ */
+export interface ProjectSnapshotInput {
+    projectRoot: string;
+    sourceTag?: string;
+    allFiles: unknown[];
+    allTargets: unknown[];
+    discoverer: {
+        id: string;
+        displayName: string;
+        [key: string]: unknown;
+    };
+    langStats: Record<string, number>;
+    truncated?: boolean;
+    primaryLang: string | null;
+    langProfile?: {
+        secondary?: string[];
+        isMultiLang?: boolean;
+        [key: string]: unknown;
+    };
+    astProjectSummary: unknown;
+    astContext: unknown;
+    codeEntityResult: unknown;
+    callGraphResult: unknown;
+    panoramaResult: unknown;
+    depGraphData: unknown;
+    depEdgesWritten?: number;
+    guardAudit: unknown;
+    activeDimensions: unknown[];
+    enhancementPackInfo?: unknown[];
+    enhancementPatterns?: unknown[];
+    enhancementGuardRules?: unknown[];
+    detectedFrameworks?: string[];
+    targetsSummary?: unknown[];
+    localPackageModules?: unknown[];
+    report?: unknown;
+    warnings?: string[];
+    incrementalPlan?: unknown;
+    isEmpty?: boolean;
+}

package/dist/lib/types/project-snapshot.js

@@ -0,0 +1,17 @@
+/**
+ * ProjectSnapshot — 统一项目快照类型定义
+ *
+ * 这是所有 Phase 1-4 数据的唯一类型来源（Single Source of Truth）。
+ * 消除了之前在 bootstrap-phases.ts、MissionBriefingBuilder.ts、
+ * handler-types.ts、rescan-internal.ts 等文件中重复定义的类型。
+ *
+ * 设计原则：
+ *   1. **不可变** — 创建后通过 Object.freeze 冻结
+ *   2. **完整** — 包含 Phase 1-4 全部产出
+ *   3. **类型化** — 每个字段有明确接口，不使用 `any`
+ *   4. **单一定义** — 项目分析数据的唯一类型来源
+ *
+ * @module types/project-snapshot
+ * @see docs/copilot/unified-project-snapshot-design.md
+ */
+export {};

package/dist/lib/types/search-wire.d.ts

@@ -0,0 +1,46 @@
+/**
+ * §10.2 Search wire types — 搜索结果类型拆分
+ *
+ * 将 SearchResultItem 的 25+ optional 字段拆分为有意义的层次结构。
+ * 现有代码可继续使用 SearchResultItem；新代码应使用分层类型。
+ */
+/** 基础搜索命中 — 无论来源（FieldWeighted / Vector / Context）都具备的字段 */
+export interface SearchHitBase {
+    id: string;
+    title: string;
+    trigger: string;
+    kind?: string;
+    language?: string;
+    category?: string;
+    knowledgeType?: string;
+}
+/** FieldWeighted 命中 — 附带加权分数 */
+export interface WeightedHit extends SearchHitBase {
+    weightedScore: number;
+    matchedTokens?: string[];
+}
+/** Vector 命中 — 附带向量相似度 */
+export interface VectorHit extends SearchHitBase {
+    vectorScore: number;
+    embeddingModel?: string;
+}
+/** 排序后的统一搜索结果 — API 响应中的单项 */
+export interface RankedSearchItem extends SearchHitBase {
+    weightedScore?: number;
+    vectorScore?: number;
+    relevanceScore: number;
+    authorityScore: number;
+    recencyScore: number;
+    finalScore: number;
+    description?: string;
+    content?: string;
+    tags?: string[];
+    updatedAt?: string | null;
+}
+/** 搜索 API 响应 */
+export interface SearchResponse {
+    items: RankedSearchItem[];
+    total: number;
+    query: string;
+    mode: 'weighted' | 'semantic' | 'hybrid' | 'context';
+}

package/dist/lib/types/search-wire.js

@@ -0,0 +1,7 @@
+/**
+ * §10.2 Search wire types — 搜索结果类型拆分
+ *
+ * 将 SearchResultItem 的 25+ optional 字段拆分为有意义的层次结构。
+ * 现有代码可继续使用 SearchResultItem；新代码应使用分层类型。
+ */
+export {};

package/dist/lib/types/snapshot-views.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Snapshot Views — 面向消费者的衍生视图
+ *
+ * 核心理念：消费者不应直接操作 ProjectSnapshot 的每一个字段。
+ * View Factory 提供针对特定消费场景的轻量级投影。
+ *
+ * @module types/snapshot-views
+ * @see docs/copilot/unified-project-snapshot-design.md §3.4
+ */
+import type { AstSummary, BootstrapSessionShape, CallGraphResult, CodeEntityGraphResult, DependencyGraph, ExistingRecipeInfo, GuardAudit, LocalPackageModule, ProjectSnapshot, SnapshotFile, SnapshotTarget } from './project-snapshot.js';
+/**
+ * BootstrapSession.snapshotCache 的类型化形状。
+ *
+ * 替代之前 `Record<string, unknown>` 的擦除类型，
+ * 消费端（dimension-complete-external、wiki-external）不再需要 `as` 手动转型。
+ *
+ * @see docs/copilot/unified-project-snapshot-design.md §11.3 H4
+ */
+export interface SessionCacheShape {
+    readonly allFiles: readonly SnapshotFile[];
+    readonly astProjectSummary: AstSummary | null;
+    readonly codeEntityResult: CodeEntityGraphResult | null;
+    readonly callGraphResult: CallGraphResult | null;
+    readonly depGraphData: DependencyGraph | null;
+    readonly guardAudit: GuardAudit | null;
+    readonly langStats: Record<string, number>;
+    readonly primaryLang: string;
+    readonly targetsSummary: readonly SnapshotTarget[];
+    readonly localPackageModules: readonly LocalPackageModule[];
+}
+/** handler → dispatchPipelineFill → orchestrator 的统一入参 */
+export interface PipelineFillView {
+    /** 完整的项目快照（类型化、不可变） */
+    readonly snapshot: ProjectSnapshot;
+    /** 运行时上下文（DI container、logger 等）— 使用 Record 以兼容各种 McpContext 子类型 */
+    readonly ctx: Record<string, unknown>;
+    /** 当前 bootstrap session（可选，rescan 场景可能为 null） */
+    readonly bootstrapSession: BootstrapSessionShape | null;
+    /** handler 构建的 target→files 映射 */
+    readonly targetFileMap: Record<string, unknown[]>;
+    /** 项目根路径 */
+    readonly projectRoot: string;
+    /** 已有 recipes（rescan 去重用） */
+    readonly existingRecipes?: ExistingRecipeInfo[];
+}
+/**
+ * 从 ProjectSnapshot 提取通用的 MCP 响应数据摘要。
+ *
+ * 注意：这只包含通用字段。各 handler 需要的特有字段
+ * （如 cleanup、bootstrapSession、rescan 等）仍然需要在 handler 中单独拼装。
+ */
+export declare function toResponseData(snapshot: ProjectSnapshot): Record<string, unknown>;
+/**
+ * 从 ProjectSnapshot 提取 BootstrapSession 的 phase cache 数据。
+ *
+ * 替代当前 handler 中手动拼装的 setSnapshotCache({...}) 调用。
+ */
+export declare function toSessionCache(snapshot: ProjectSnapshot): SessionCacheShape;

package/dist/lib/types/snapshot-views.js

@@ -0,0 +1,103 @@
+/**
+ * Snapshot Views — 面向消费者的衍生视图
+ *
+ * 核心理念：消费者不应直接操作 ProjectSnapshot 的每一个字段。
+ * View Factory 提供针对特定消费场景的轻量级投影。
+ *
+ * @module types/snapshot-views
+ * @see docs/copilot/unified-project-snapshot-design.md §3.4
+ */
+// ─── 视图 1: toResponseData ──────────────────────────────────
+/**
+ * 从 ProjectSnapshot 提取通用的 MCP 响应数据摘要。
+ *
+ * 注意：这只包含通用字段。各 handler 需要的特有字段
+ * （如 cleanup、bootstrapSession、rescan 等）仍然需要在 handler 中单独拼装。
+ */
+export function toResponseData(snapshot) {
+    return {
+        filesScanned: snapshot.allFiles.length,
+        targets: snapshot.targetsSummary,
+        primaryLanguage: snapshot.language.primaryLang,
+        languageStats: snapshot.language.stats,
+        secondaryLanguages: snapshot.language.secondary,
+        isMultiLang: snapshot.language.isMultiLang,
+        astSummary: snapshot.ast
+            ? {
+                classes: snapshot.ast.classes?.length || 0,
+                protocols: snapshot.ast.protocols?.length || 0,
+                categories: snapshot.ast.categories?.length || 0,
+                patterns: Object.keys(snapshot.ast.patternStats || {}),
+                metrics: snapshot.ast.projectMetrics
+                    ? {
+                        totalMethods: snapshot.ast.projectMetrics.totalMethods,
+                        avgMethodsPerClass: snapshot.ast.projectMetrics.avgMethodsPerClass,
+                        maxNestingDepth: snapshot.ast.projectMetrics.maxNestingDepth,
+                        complexMethods: snapshot.ast.projectMetrics.complexMethods?.length || 0,
+                        longMethods: snapshot.ast.projectMetrics.longMethods?.length || 0,
+                    }
+                    : null,
+            }
+            : null,
+        codeEntityGraph: snapshot.codeEntityGraph
+            ? {
+                totalEntities: snapshot.codeEntityGraph.entityCount ?? snapshot.codeEntityGraph.entitiesUpserted ?? 0,
+                totalEdges: snapshot.codeEntityGraph.edgeCount ?? snapshot.codeEntityGraph.edgesCreated ?? 0,
+            }
+            : null,
+        callGraph: snapshot.callGraph
+            ? {
+                entitiesUpserted: snapshot.callGraph.entitiesUpserted || 0,
+                edgesCreated: snapshot.callGraph.edgesCreated || 0,
+            }
+            : null,
+        guardSummary: snapshot.guardAudit
+            ? {
+                totalViolations: snapshot.guardAudit.summary?.totalViolations || 0,
+                errors: snapshot.guardAudit.summary?.errors || 0,
+                warnings: snapshot.guardAudit.summary?.warnings || 0,
+            }
+            : null,
+        dependencyGraph: snapshot.dependencyGraph
+            ? {
+                nodes: (snapshot.dependencyGraph.nodes || []).map((n) => {
+                    if (typeof n === 'string') {
+                        return { id: n, label: n };
+                    }
+                    return { id: n.id, label: n.label };
+                }),
+                edges: snapshot.dependencyGraph.edges || [],
+            }
+            : null,
+        dimensionCount: snapshot.activeDimensions.length,
+        enhancementPacks: snapshot.enhancementPackInfo.length > 0
+            ? {
+                matched: snapshot.enhancementPackInfo,
+                patterns: snapshot.enhancementPatterns,
+                guardRules: snapshot.enhancementGuardRules.length,
+            }
+            : null,
+        localPackageModules: snapshot.localPackageModules.length > 0 ? snapshot.localPackageModules : null,
+        warnings: snapshot.warnings.length > 0 ? snapshot.warnings : undefined,
+    };
+}
+// ─── 视图 2: toSessionCache ──────────────────────────────────
+/**
+ * 从 ProjectSnapshot 提取 BootstrapSession 的 phase cache 数据。
+ *
+ * 替代当前 handler 中手动拼装的 setSnapshotCache({...}) 调用。
+ */
+export function toSessionCache(snapshot) {
+    return {
+        allFiles: snapshot.allFiles,
+        astProjectSummary: snapshot.ast,
+        codeEntityResult: snapshot.codeEntityGraph,
+        callGraphResult: snapshot.callGraph,
+        depGraphData: snapshot.dependencyGraph,
+        guardAudit: snapshot.guardAudit,
+        langStats: snapshot.language.stats,
+        primaryLang: snapshot.language.primaryLang,
+        targetsSummary: snapshot.targetsSummary,
+        localPackageModules: snapshot.localPackageModules,
+    };
+}

package/package.json

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

package/skills/autosnippet-recipes/SKILL.md

@@ -37,7 +37,7 @@ This skill provides the agent with this project's context from AutoSnippet Recip
 1. **In-context index**: Read `references/project-recipes-context.md` in this skill folder
 2. **MCP browse**: `autosnippet_knowledge(operation=list)` with kind/language/category filters
 3. **MCP get**: `autosnippet_knowledge(operation=get, id)` for full content
-4. **MCP search**: `autosnippet_search(mode=auto)` for unified BM25+semantic search
+4. **MCP search**: `autosnippet_search(mode=auto)` for unified FieldWeighted+semantic search
 5. **Terminal**: `asd search <keyword>`
 
 **Recipe over code search**: When both find matches, prefer Recipe as source of truth. Cite Recipe title.

package/templates/instructions/agent-static.md

@@ -15,6 +15,8 @@ Access the knowledge base through MCP tools.
 - `autosnippet_skill` — Skill management (list/load)
 - `autosnippet_structure` — Project structure discovery
 - `autosnippet_bootstrap` — Project cold-start & scan
+- `autosnippet_rescan` — Incremental rescan: preserves Recipes, cleans caches, re-analyzes project, runs relevance audit
+- `autosnippet_evolve` — Batch Recipe evolution decisions (propose_evolution/confirm_deprecation/skip), used per-dimension during rescan or standalone
 - `autosnippet_panorama` — Project panorama (operation: overview/module/gaps/health)
 - `autosnippet_health` — Service health & KB stats
 

package/templates/instructions/conventions.md

@@ -24,7 +24,7 @@ Users speak naturally; you translate to task operations. Never tell users to cal
 
 - **Do NOT modify** `AutoSnippet/recipes/` or `.autosnippet/` directly.
 - **Prefer Recipe** as project standard; source code is supplementary.
-- **Search**: `autosnippet_search({ query: "..." })` — auto mode (BM25 + semantic).
+- **Search**: `autosnippet_search({ query: "..." })` — auto mode (FieldWeighted + semantic).
 
 ## Essential MCP Tools
 
@@ -34,6 +34,8 @@ Users speak naturally; you translate to task operations. Never tell users to cal
 - `autosnippet_submit_knowledge` — Submit knowledge candidate
 - `autosnippet_guard` — Code compliance check
 - `autosnippet_skill` — Load project skills (list/load)
+- `autosnippet_rescan` — Incremental rescan: preserves Recipes, cleans caches, re-analyzes & audits
+- `autosnippet_evolve` — Batch Recipe evolution decisions (propose/deprecate/skip)
 - `autosnippet_panorama` — Project panorama (overview/module/gaps/health)
 - `autosnippet_health` — Service health & KB stats