autosnippet 3.3.5 → 3.3.6

package/dist/lib/service/search/SearchEngine.js

@@ -1,7 +1,7 @@
 /**
  * SearchEngine - 统一搜索引擎
  *
- * 三级搜索策略: keyword → BM25 ranking → semantic(可选)
+ * 三级搜索策略: keyword → FieldWeighted ranking → semantic(可选)
  * 从 V1 SearchServiceV2 迁移，适配 V2 架构
  */
 import Logger from '../../infrastructure/logging/Logger.js';
@@ -129,22 +129,22 @@ export class SearchEngine {
         let actualMode = mode;
         switch (mode) {
             case 'auto': {
-                // 缓存 BM25 结果, 避免 RRF 降级时重复计算
-                let cachedBm25Items = null;
-                const getBm25 = () => {
-                    if (!cachedBm25Items) {
-                        cachedBm25Items = this._bm25Search(query, type, recallLimit);
+                // 缓存 FieldWeighted 结果, 避免 RRF 降级时重复计算
+                let cachedScorerItems = null;
+                const getScorerResults = () => {
+                    if (!cachedScorerItems) {
+                        cachedScorerItems = this._scorerSearch(query, type, recallLimit);
                     }
-                    return cachedBm25Items;
+                    return cachedScorerItems;
                 };
                 // 优先使用 VectorService 的 hybridSearch (统一 RRF 融合)
                 if (this.vectorService) {
                     try {
-                        const bm25Items = getBm25();
+                        const sparseItems = getScorerResults();
                         const rrfResults = await this.vectorService.hybridSearch(query, {
                             topK: recallLimit,
                             alpha: this._fusionSemanticWeight,
-                            sparseSearchFn: () => bm25Items,
+                            sparseSearchFn: () => sparseItems,
                         });
                         if (rrfResults.length > 0) {
                             results = rrfResults.map((r) => {
@@ -178,15 +178,16 @@ export class SearchEngine {
                         // VectorService RRF 失败, 降级到 min-max 融合
                     }
                 }
-                // 降级: VectorService 不可用或 RRF 零结果 → 纯 BM25
+                // 降级: VectorService 不可用或 RRF 零结果 → 纯 FieldWeighted
                 // 旧版在此做 BM25+semantic min-max 融合，但当 VectorService 不可用时
-                // semantic 通常也会失败，最终退化为纯 BM25。简化为直接走 BM25。
-                results = getBm25();
-                actualMode = 'auto(bm25-only)';
+                // semantic 通常也会失败，最终退化为纯 FieldWeighted。简化为直接走 scorer。
+                results = getScorerResults();
+                actualMode = 'auto(weighted-only)';
                 break;
             }
+            case 'weighted':
             case 'bm25':
-                results = this._bm25Search(query, type, recallLimit);
+                results = this._scorerSearch(query, type, recallLimit);
                 break;
             case 'semantic': {
                 const semResult = await this._semanticSearch(query, type, recallLimit);
@@ -300,7 +301,7 @@ export class SearchEngine {
     /**
      * 关键词搜索 - 直接 SQL LIKE
      * 返回包含 kind 字段的完整结果，使用 ESCAPE 防止通配符注入
-     * 当 SQL LIKE 无结果时，降级到 BM25 搜索以提升自然语言查询的召回率
+     * 当 SQL LIKE 无结果时，降级到 FieldWeighted 搜索以提升自然语言查询的召回率
      */
     _keywordSearch(query, type, limit) {
         const results = [];
@@ -351,23 +352,23 @@ export class SearchEngine {
                 /* table may not exist */
             }
         }
-        // 补充排序信号字段（whenClause/doClause/tags 等），与 BM25/semantic 路径一致
+        // 补充排序信号字段（whenClause/doClause/tags 等），与 scorer/semantic 路径一致
         this._supplementDetails(results);
-        // 当 SQL LIKE 无结果时，降级到 BM25 搜索
+        // 当 SQL LIKE 无结果时，降级到 FieldWeighted 搜索
         // 这让自然语言查询（如 "如何处理网络错误"）在 keyword 模式下也能返回结果
         if (results.length === 0) {
             this.ensureIndex();
-            const bm25Results = this._bm25Search(query, type, limit);
-            return bm25Results;
+            const scorerResults = this._scorerSearch(query, type, limit);
+            return scorerResults;
         }
         return results.slice(0, limit);
     }
     /**
-     * BM25 排序搜索
+     * 加权字段搜索（FieldWeightedScorer）
      * 增加 Title/Trigger 精确匹配 bonus — 当 query 出现在标题/触发词中时
-     * 给予额外 BM25 分数加成，确保精确匹配的条目排名靠前
+     * 给予额外分数加成，确保精确匹配的条目排名靠前
      */
-    _bm25Search(query, type, limit) {
+    _scorerSearch(query, type, limit) {
         let results = this.scorer.search(query, limit * 2);
         if (type !== 'all') {
             // All types now map to 'recipe' since everything is unified
@@ -379,7 +380,7 @@ export class SearchEngine {
             });
         }
         // ── Title/Trigger exact-match bonus ──
-        // 当 query 精确出现在标题或触发词中时，增加 BM25 分数
+        // 当 query 精确出现在标题或触发词中时，增加分数
         // 这解决了 "BaseRequest" 被 "BD前缀类名命名规范" 排在 "BDBaseRequest 继承请求模式" 前面的问题
         const lowerQuery = query.toLowerCase();
         const maxScore = results.length > 0 ? results[0].score : 1;
@@ -432,7 +433,7 @@ export class SearchEngine {
     }
     /**
      * 语义搜索 - 需要 AI Provider 的 embed 功能
-     * 降级到 BM25 如果 AI 不可用
+     * 不可用时降级到 FieldWeighted 搜索
      * @returns >}
      */
     async _semanticSearch(query, type, limit) {
@@ -474,13 +475,13 @@ export class SearchEngine {
         }
         // Legacy fallback: 直接使用 aiProvider embed + vectorStore
         if (!this.aiProvider) {
-            this.logger.debug('AI provider not available, falling back to BM25');
-            return { items: this._bm25Search(query, type, limit), actualMode: 'bm25' };
+            this.logger.debug('AI provider not available, falling back to FieldWeighted search');
+            return { items: this._scorerSearch(query, type, limit), actualMode: 'weighted' };
         }
         try {
             const queryEmbedding = await this.aiProvider.embed(query);
             if (!queryEmbedding || queryEmbedding.length === 0) {
-                return { items: this._bm25Search(query, type, limit), actualMode: 'bm25' };
+                return { items: this._scorerSearch(query, type, limit), actualMode: 'weighted' };
             }
             if (this.vectorStore) {
                 try {
@@ -523,24 +524,24 @@ export class SearchEngine {
                     }
                 }
                 catch (vecErr) {
-                    this.logger.warn('Vector store query failed, falling back to BM25', {
+                    this.logger.warn('Vector store query failed, falling back to FieldWeighted', {
                         error: vecErr.message,
                     });
                 }
             }
-            this.logger.debug('Vector search fallback to BM25');
-            return { items: this._bm25Search(query, type, limit), actualMode: 'bm25' };
+            this.logger.debug('Vector search fallback to FieldWeighted');
+            return { items: this._scorerSearch(query, type, limit), actualMode: 'weighted' };
         }
         catch (err) {
-            this.logger.warn('Semantic search failed, falling back to BM25', {
+            this.logger.warn('Semantic search failed, falling back to FieldWeighted', {
                 error: err.message,
             });
-            return { items: this._bm25Search(query, type, limit), actualMode: 'bm25' };
+            return { items: this._scorerSearch(query, type, limit), actualMode: 'weighted' };
         }
     }
     /**
      * 补充详细字段（content / description / trigger / delivery 字段）— 批量 IN 查询
-     * 用于向量搜索结果与 BM25 结果的一致性
+     * 用于向量搜索结果与 FieldWeighted 结果的一致性
      */
     _supplementDetails(items) {
         if (!items || items.length === 0) {
@@ -730,9 +731,10 @@ export class SearchEngine {
     /**
      * 从 DB 行构建索引文本
      *
-     * 使用 BM25F 思想：高价值字段（title, trigger）重复出现以提升 TF 权重
+     * 高价值字段（title, trigger）通过重复出现提升 TF 权重
      * — title ×3, trigger ×2, description ×1.5（通过重复 token 实现）
-     * 这确保标题匹配的文档获得显著更高的 BM25 分数
+     * 这确保标题匹配的文档获得显著更高的分数
+     * 注：此逻辑主要服务于 BM25Scorer，FieldWeightedScorer 内部已有字段权重机制
      */
     _buildDocText(r) {
         let contentText = '';
@@ -752,7 +754,7 @@ export class SearchEngine {
         catch {
             /* ignore */
         }
-        // BM25F field boosting via token repetition:
+        // Field boosting via token repetition:
         // title ×2, trigger ×2, description ×1, others ×1
         // 使用较温和的 boost 避免长文档 avgLength 膨胀导致 content 匹配被过度稀释
         const title = r.title || '';

package/dist/lib/service/search/SearchTypes.d.ts

@@ -2,26 +2,30 @@
  * SearchTypes — SearchEngine 共享类型定义
  *
  * 从 SearchEngine.ts 提取的所有接口和类型，
- * 供 SearchEngine、BM25Scorer 及测试文件独立消费。
+ * 供 SearchEngine、FieldWeightedScorer、BM25Scorer 及测试文件独立消费。
  *
  * @module SearchTypes
  */
-/** Internal BM25 document representation */
-export interface BM25Document {
+/** Internal scorer document representation */
+export interface ScorerDocument {
     id: string;
     tokens: string[];
     tokenFreq: Record<string, number>;
     length: number;
     meta: Record<string, unknown>;
 }
-/** BM25 search result */
-export interface BM25SearchResult {
+/** Scorer search result */
+export interface ScorerResult {
     id: string;
     score: number;
     meta: Record<string, unknown>;
 }
+/** @deprecated Use ScorerDocument */
+export type BM25Document = ScorerDocument;
+/** @deprecated Use ScorerResult */
+export type BM25SearchResult = ScorerResult;
 /**
- * Scorer 通用接口 — BM25Scorer 与 FieldWeightedScorer 共同实现
+ * Scorer 通用接口 — FieldWeightedScorer（默认）与 BM25Scorer 共同实现
  *
  * SearchEngine 通过此接口与具体评分器解耦，可在运行时切换。
  */
@@ -36,11 +40,11 @@ export interface Scorer {
     removeDocument(id: string): boolean;
     updateDocument(id: string, text: string, meta: Record<string, unknown>): void;
     hasDocument(id: string): boolean;
-    search(query: string, limit?: number): BM25SearchResult[];
+    search(query: string, limit?: number): ScorerResult[];
     clear(): void;
 }
 /** Meta structure produced by _buildDocMeta */
-export interface BM25DocMeta {
+export interface DocMeta {
     type: string;
     title: string;
     trigger: string;
@@ -58,6 +62,8 @@ export interface BM25DocMeta {
     qualityScore: number;
     [key: string]: unknown;
 }
+/** @deprecated Use DocMeta */
+export type BM25DocMeta = DocMeta;
 /** Unified search result item flowing through the ranking pipeline */
 export interface SearchResultItem {
     id: string;

package/dist/lib/service/search/SearchTypes.js

@@ -2,7 +2,7 @@
  * SearchTypes — SearchEngine 共享类型定义
  *
  * 从 SearchEngine.ts 提取的所有接口和类型，
- * 供 SearchEngine、BM25Scorer 及测试文件独立消费。
+ * 供 SearchEngine、FieldWeightedScorer、BM25Scorer 及测试文件独立消费。
  *
  * @module SearchTypes
  */

package/dist/lib/service/search/tokenizer.d.ts

@@ -6,7 +6,7 @@
  *
  * @module tokenizer
  */
-/** BM25 调参常量 */
+/** 评分调参常量（原 BM25 k1/b 参数，BM25Scorer 仍在使用） */
 export declare const BM25_K1 = 1.2;
 export declare const BM25_B = 0.75;
 /**

package/dist/lib/service/search/tokenizer.js

@@ -6,11 +6,11 @@
  *
  * @module tokenizer
  */
-/** BM25 调参常量 */
+/** 评分调参常量（原 BM25 k1/b 参数，BM25Scorer 仍在使用） */
 export const BM25_K1 = 1.2;
 export const BM25_B = 0.75;
 /**
- * 中文停用词表 — 过滤常见虚词/助词/代词/连词，减少 BM25 噪声
+ * 中文停用词表 — 过滤常见虚词/助词/代词/连词，减少搜索噪声
  * 参考 jieba / Elasticsearch smartcn_stop / 百度停用词表
  */
 const CJK_STOPWORDS = new Set([

package/dist/lib/shared/schemas/common.d.ts

@@ -25,20 +25,20 @@ export declare const KnowledgeTypeEnum: z.ZodEnum<{
     "code-pattern": "code-pattern";
     architecture: "architecture";
     "best-practice": "best-practice";
-    "event-and-data-flow": "event-and-data-flow";
+    "module-dependency": "module-dependency";
+    "boundary-constraint": "boundary-constraint";
     "code-standard": "code-standard";
     "code-style": "code-style";
     "code-relation": "code-relation";
-    "module-dependency": "module-dependency";
-    "boundary-constraint": "boundary-constraint";
     "data-flow": "data-flow";
+    "event-and-data-flow": "event-and-data-flow";
     solution: "solution";
     "anti-pattern": "anti-pattern";
 }>;
 export declare const ComplexityEnum: z.ZodEnum<{
     intermediate: "intermediate";
-    beginner: "beginner";
     advanced: "advanced";
+    beginner: "beginner";
 }>;
 export declare const ScopeEnum: z.ZodEnum<{
     universal: "universal";

package/dist/lib/shared/schemas/http-requests.d.ts

@@ -63,11 +63,18 @@ export declare const DeprecateKnowledgeBody: z.ZodObject<{
 export declare const BatchPublishBody: z.ZodObject<{
     ids: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
+export declare const BatchDeleteBody: z.ZodObject<{
+    ids: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const BatchDeprecateBody: z.ZodObject<{
+    ids: z.ZodArray<z.ZodString>;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export declare const KnowledgeUsageBody: z.ZodObject<{
     type: z.ZodDefault<z.ZodEnum<{
+        view: "view";
         feedback: "feedback";
         adoption: "adoption";
-        view: "view";
     }>>;
     feedback: z.ZodOptional<z.ZodUnknown>;
 }, z.core.$strip>;
@@ -240,6 +247,10 @@ export declare const ModuleBootstrapBody: z.ZodObject<{
     skipGuard: z.ZodDefault<z.ZodBoolean>;
     contentMaxLines: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
+export declare const ModuleRescanBody: z.ZodObject<{
+    reason: z.ZodOptional<z.ZodString>;
+    dimensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
 export declare const GraphQuery: z.ZodObject<{
     nodeId: z.ZodString;
     nodeType: z.ZodString;

package/dist/lib/shared/schemas/http-requests.js

@@ -59,6 +59,10 @@ export const DeprecateKnowledgeBody = z.object({
     reason: z.string().min(1, 'reason is required'),
 });
 export const BatchPublishBody = BatchIds;
+export const BatchDeleteBody = BatchIds;
+export const BatchDeprecateBody = BatchIds.extend({
+    reason: z.string().optional(),
+});
 export const KnowledgeUsageBody = z.object({
     type: z.enum(['adoption', 'view', 'feedback']).default('adoption'),
     feedback: z.unknown().optional(),
@@ -236,6 +240,10 @@ export const ModuleBootstrapBody = z.object({
     skipGuard: z.boolean().default(false),
     contentMaxLines: z.number().int().min(1).max(10000).default(120),
 });
+export const ModuleRescanBody = z.object({
+    reason: z.string().optional(),
+    dimensions: z.array(z.string()).optional(),
+});
 // ═══ Graph Search ════════════════════════════════
 export const GraphQuery = z.object({
     nodeId: z.string().min(1, 'nodeId is required'),

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

@@ -158,8 +158,8 @@ export declare const SubmitKnowledgeItemSchema: z.ZodObject<{
     topicHint: z.ZodOptional<z.ZodString>;
     complexity: z.ZodOptional<z.ZodEnum<{
         intermediate: "intermediate";
-        beginner: "beginner";
         advanced: "advanced";
+        beginner: "beginner";
     }>>;
     scope: z.ZodOptional<z.ZodEnum<{
         universal: "universal";
@@ -191,8 +191,8 @@ export declare const SkillInput: z.ZodObject<{
         delete: "delete";
         create: "create";
         update: "update";
-        list: "list";
         load: "load";
+        list: "list";
         suggest: "suggest";
     }>;
     name: z.ZodOptional<z.ZodString>;
@@ -211,6 +211,11 @@ export declare const SkillInput: z.ZodObject<{
 export type SkillInput = z.infer<typeof SkillInput>;
 export declare const BootstrapInput: z.ZodObject<{}, z.core.$strip>;
 export type BootstrapInput = z.infer<typeof BootstrapInput>;
+export declare const RescanInput: z.ZodObject<{
+    dimensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type RescanInput = z.infer<typeof RescanInput>;
 export declare const DimensionCompleteInput: z.ZodObject<{
     sessionId: z.ZodOptional<z.ZodString>;
     dimensionId: z.ZodString;
@@ -290,4 +295,29 @@ export declare const PanoramaInput: z.ZodObject<{
     module: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type PanoramaInput = z.infer<typeof PanoramaInput>;
+export declare const EvolveInput: z.ZodObject<{
+    decisions: z.ZodArray<z.ZodObject<{
+        recipeId: z.ZodString;
+        action: z.ZodEnum<{
+            propose_evolution: "propose_evolution";
+            confirm_deprecation: "confirm_deprecation";
+            skip: "skip";
+        }>;
+        evidence: z.ZodOptional<z.ZodObject<{
+            codeSnippet: z.ZodString;
+            filePath: z.ZodString;
+            type: z.ZodEnum<{
+                enhance: "enhance";
+                correction: "correction";
+            }>;
+            suggestedChanges: z.ZodString;
+        }, z.core.$strip>>;
+        reason: z.ZodOptional<z.ZodString>;
+        skipReason: z.ZodOptional<z.ZodEnum<{
+            still_valid: "still_valid";
+            insufficient_info: "insufficient_info";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type EvolveInput = z.infer<typeof EvolveInput>;
 export declare const TOOL_SCHEMAS: Record<string, z.ZodType>;

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

@@ -198,6 +198,13 @@ export const SkillInput = z.object({
 // ══════════════════════════════════════════════════════
 export const BootstrapInput = z.object({});
 // ══════════════════════════════════════════════════════
+//  11a. autosnippet_rescan — 增量知识更新
+// ══════════════════════════════════════════════════════
+export const RescanInput = z.object({
+    dimensions: z.array(z.string()).optional().describe('指定维度列表，空 = 全部活跃维度'),
+    reason: z.string().optional().describe('触发原因（记录到报告）'),
+});
+// ══════════════════════════════════════════════════════
 //  11b. autosnippet_dimension_complete
 // ══════════════════════════════════════════════════════
 export const DimensionCompleteInput = z.object({
@@ -298,6 +305,35 @@ export const PanoramaInput = z.object({
         .describe('overview=项目骨架+层级+模块角色 | module=单模块详情+邻居关系 | gaps=知识空白区 | health=全景健康度 | governance_cycle=新陈代谢完整周期 | decay_report=衰退报告 | staging_check=staging检查+自动发布 | enhancement_suggestions=增强建议'),
     module: z.string().optional().describe('模块名称（operation=module 时必填）'),
 });
+// 19. autosnippet_evolve
+const EvolveDecisionSchema = z.object({
+    recipeId: z.string().describe('目标 Recipe ID'),
+    action: z
+        .enum(['propose_evolution', 'confirm_deprecation', 'skip'])
+        .describe('propose_evolution=提案进化 | confirm_deprecation=确认废弃 | skip=跳过'),
+    evidence: z
+        .object({
+        codeSnippet: z.string().describe('读到的真实代码片段'),
+        filePath: z.string().describe('代码所在文件路径'),
+        type: z
+            .enum(['enhance', 'correction'])
+            .describe('enhance=模式迁移/功能扩展 | correction=描述错误/接口变更'),
+        suggestedChanges: z.string().describe('建议的内容变更'),
+    })
+        .optional()
+        .describe('propose_evolution 时必填'),
+    reason: z.string().optional().describe('confirm_deprecation 时必填，废弃原因'),
+    skipReason: z
+        .enum(['still_valid', 'insufficient_info'])
+        .optional()
+        .describe('skip 时必填: still_valid=仍然有效(刷新验证时间) | insufficient_info=信息不足'),
+});
+export const EvolveInput = z.object({
+    decisions: z
+        .array(EvolveDecisionSchema)
+        .min(1)
+        .describe('进化决策数组，每个元素对应一个 Recipe 的决策'),
+});
 // ══════════════════════════════════════════════════════
 //  工具名 → Schema 映射表（用于 wrapHandler 自动注入校验）
 // ══════════════════════════════════════════════════════
@@ -312,10 +348,12 @@ export const TOOL_SCHEMAS = {
     autosnippet_submit_knowledge: SubmitKnowledgeInput,
     autosnippet_skill: SkillInput,
     autosnippet_bootstrap: BootstrapInput,
+    autosnippet_rescan: RescanInput,
     autosnippet_dimension_complete: DimensionCompleteInput,
     autosnippet_wiki: WikiInput,
     autosnippet_task: TaskInput,
     autosnippet_enrich_candidates: EnrichCandidatesInput,
     autosnippet_knowledge_lifecycle: KnowledgeLifecycleInput,
     autosnippet_panorama: PanoramaInput,
+    autosnippet_evolve: EvolveInput,
 };

package/dist/lib/types/evolution.d.ts

@@ -0,0 +1,135 @@
+/**
+ * evolution.ts — Evolution 系统类型定义
+ *
+ * 包含 ContentPatcher / RecipeLifecycleSupervisor / 结构化 suggestedChanges 的类型。
+ */
+/** suggestedChanges 中每项变更操作 */
+export interface PatchChange {
+    /** 目标字段路径（如 'content.markdown', 'coreCode', 'doClause'） */
+    field: string;
+    /** 操作类型 */
+    action: 'replace' | 'replace-section' | 'append';
+    /** 新值（replace / append 时必填） */
+    newValue?: string;
+    /** 目标 section 标题（replace-section 时必填） */
+    section?: string;
+    /** 新 section 内容（replace-section 时必填） */
+    newContent?: string;
+}
+/** 结构化 suggestedChanges 格式（Agent 输出） */
+export interface StructuredPatch {
+    patchVersion: number;
+    changes: PatchChange[];
+    reasoning: string;
+}
+/** Recipe 内容快照 */
+export interface RecipeContentSnapshot {
+    coreCode: string;
+    doClause: string;
+    dontClause: string;
+    whenClause: string;
+    content: {
+        markdown?: string;
+        rationale?: string;
+    };
+    sourceRefs: string[];
+    headers: string[];
+}
+/** ContentPatcher 应用结果 */
+export interface ContentPatchResult {
+    success: boolean;
+    recipeId: string;
+    fieldsPatched: string[];
+    beforeSnapshot: RecipeContentSnapshot;
+    afterSnapshot: RecipeContentSnapshot;
+    patchSource: 'agent-suggestion' | 'correction' | 'merge';
+    skipped: boolean;
+    skipReason?: string;
+}
+/** 状态转移触发类型 */
+export type TransitionTrigger = 'confidence-route' | 'grace-period-expire' | 'guard-conflict' | 'proposal-execution' | 'proposal-attach' | 'content-patch-complete' | 'decay-detection' | 'manual-deprecation' | 'timeout-recovery' | 'evidence-recovery' | 'resurrection';
+/** 状态转移证据 */
+export interface TransitionEvidence {
+    decayScore?: number;
+    fpRate?: number;
+    usageCount?: number;
+    suggestedChanges?: string;
+    patchResult?: ContentPatchResult;
+    reason: string;
+}
+/** 状态转移请求 */
+export interface TransitionRequest {
+    recipeId: string;
+    targetState: string;
+    trigger: TransitionTrigger;
+    evidence?: TransitionEvidence;
+    proposalId?: string;
+    operatorId?: string;
+}
+/** 状态转移事件（不可变记录） */
+export interface TransitionEvent {
+    id: string;
+    recipeId: string;
+    fromState: string;
+    toState: string;
+    trigger: TransitionTrigger;
+    evidence: TransitionEvidence | null;
+    proposalId: string | null;
+    operatorId: string;
+    createdAt: number;
+}
+/** 状态转移结果 */
+export interface TransitionResult {
+    success: boolean;
+    fromState: string;
+    toState: string;
+    event?: TransitionEvent;
+    error?: string;
+}
+/** 超时检查结果 */
+export interface TimeoutCheckResult {
+    timedOut: {
+        recipeId: string;
+        fromState: string;
+        toState: string;
+        age: number;
+    }[];
+    checked: number;
+}
+/** 生命周期健康摘要 */
+export interface LifecycleHealthSummary {
+    stateDistribution: Record<string, number>;
+    intermediateStates: {
+        stuckEvolving: {
+            count: number;
+            oldestAge: number;
+        };
+        stuckDecaying: {
+            count: number;
+            oldestAge: number;
+        };
+        stuckStaging: {
+            count: number;
+            oldestAge: number;
+        };
+        stuckPending: {
+            count: number;
+            oldestAge: number;
+        };
+    };
+    recentTransitions: {
+        last24h: number;
+        last7d: number;
+        topTriggers: {
+            trigger: string;
+            count: number;
+        }[];
+    };
+    proposalMetrics: {
+        pendingCount: number;
+        observingCount: number;
+        executionRate: number;
+        avgObservationDays: number;
+        contentPatchRate: number;
+    };
+}

package/dist/lib/types/evolution.js

@@ -0,0 +1,6 @@
+/**
+ * evolution.ts — Evolution 系统类型定义
+ *
+ * 包含 ContentPatcher / RecipeLifecycleSupervisor / 结构化 suggestedChanges 的类型。
+ */
+export {};

package/dist/lib/types/graph-shared.d.ts

@@ -0,0 +1,25 @@
+/**
+ * §10.6 Graph shared types — 图谱类型共享
+ *
+ * Bootstrap 管道和 KnowledgeGraphService 共享实体/边的概念。
+ * 统一枚举避免 string literal 不一致。
+ */
+/** 代码实体类型 */
+export type EntityType = 'class' | 'protocol' | 'category' | 'module' | 'pattern' | 'function' | 'file';
+/** 关系类型 */
+export type RelationType = 'inherits' | 'conforms' | 'extends' | 'depends_on' | 'uses_pattern' | 'is_part_of' | 'calls' | 'data_flow' | 'discovered_in';
+/** 图节点引用 */
+export interface GraphNodeRef {
+    id: string;
+    type: EntityType;
+    name: string;
+}
+/** 图边引用 */
+export interface GraphEdgeRef {
+    fromId: string;
+    fromType: EntityType;
+    toId: string;
+    toType: EntityType;
+    relation: RelationType;
+    weight?: number;
+}

package/dist/lib/types/graph-shared.js

@@ -0,0 +1,7 @@
+/**
+ * §10.6 Graph shared types — 图谱类型共享
+ *
+ * Bootstrap 管道和 KnowledgeGraphService 共享实体/边的概念。
+ * 统一枚举避免 string literal 不一致。
+ */
+export {};