autosnippet 3.3.4 → 3.3.6

package/dist/lib/service/guard/ComplianceReporter.js

@@ -82,6 +82,53 @@ export class ComplianceReporter {
             });
         }
     }
+    /**
+     * 确保 Enhancement Pack 规则已注入到 engine
+     * 与 MCP guard handler 的 _injectEnhancementGuardRules 逻辑一致
+     */
+    async #ensureEnhancementPackRules() {
+        if (!this.engine.isEpInjected || this.engine.isEpInjected()) {
+            return;
+        }
+        try {
+            const { initEnhancementRegistry } = await import('#core/enhancement/index.js');
+            const enhReg = await initEnhancementRegistry();
+            const allPacks = enhReg.all();
+            const allGuardRules = [];
+            for (const pack of allPacks) {
+                try {
+                    const rules = pack.getGuardRules();
+                    if (rules.length > 0) {
+                        allGuardRules.push(...rules);
+                    }
+                }
+                catch {
+                    /* graceful degradation per pack */
+                }
+            }
+            if (allGuardRules.length > 0 && this.engine.injectExternalRules) {
+                this.engine.injectExternalRules(allGuardRules);
+                this.logger.info(`[ComplianceReporter] Injected ${allGuardRules.length} Enhancement Pack rules`);
+            }
+            this.engine.markEpInjected?.();
+        }
+        catch {
+            /* Enhancement registry not available — non-critical */
+        }
+    }
+    /**
+     * 确保 AST 语言插件已加载（Tree-sitter WASM）
+     * 未加载时 _runAstLayer2Checks 会静默跳过，导致 AST 类违规无法检测
+     */
+    async #ensureAstPlugins() {
+        try {
+            const { loadPlugins } = await import('../../core/ast/index.js');
+            await loadPlugins();
+        }
+        catch {
+            /* AST not available — graceful degradation */
+        }
+    }
     /**
      * 生成全项目合规报告
      * @param projectRoot 项目根目录
@@ -91,6 +138,10 @@ export class ComplianceReporter {
     async generate(projectRoot, options = {}) {
         const thresholds = { ...this.qualityGateConfig, ...(options.qualityGate || {}) };
         const maxFiles = options.maxFiles || 500;
+        // 0. 确保 Enhancement Pack 规则已注入（与 MCP guard handler 保持一致）
+        await this.#ensureEnhancementPackRules();
+        // 0b. 确保 AST 语言插件已加载（Tree-sitter WASM）
+        await this.#ensureAstPlugins();
         // 1. 收集源文件
         const files = await collectSourceFilesWithContent(projectRoot, { maxFiles });
         this.logger.info(`[ComplianceReporter] Collected ${files.length} source files`);

package/dist/lib/service/guard/GuardCheckEngine.js

@@ -678,13 +678,14 @@ export class GuardCheckEngine {
         }
         // 如果有 scope，按层级过滤：project ⊇ target ⊇ file
         // project 范围包含所有维度的规则；target 包含 file+target；file 仅匹配 file
+        // 'universal' 维度在所有 scope 下都生效
         if (scope) {
             const SCOPE_HIERARCHY = {
-                project: ['file', 'target', 'project'],
-                target: ['file', 'target'],
-                file: ['file'],
+                project: ['file', 'target', 'project', 'universal'],
+                target: ['file', 'target', 'universal'],
+                file: ['file', 'universal'],
             };
-            const allowedDimensions = SCOPE_HIERARCHY[scope] || [scope];
+            const allowedDimensions = SCOPE_HIERARCHY[scope] || [scope, 'universal'];
             rules = rules.filter((r) => !r.dimension || allowedDimensions.includes(r.dimension));
         }
         const lines = (code || '').split(/\r?\n/);

package/dist/lib/service/guard/GuardCrossFileChecks.js

@@ -42,6 +42,8 @@ export function runCrossFileChecks(files, options = {}) {
     const violations = [];
     const disabledSet = new Set(options.disabledRules || []);
     const isDisabled = (ruleId) => disabledSet.has(ruleId);
+    // 过滤掉 content 为空的条目，防止下游 split 崩溃
+    files = files.filter((f) => typeof f.content === 'string');
     // ── ObjC Category 跨文件重名检查 ──
     if (!isDisabled('objc-cross-file-duplicate-category')) {
         const categoryMap = new Map();

package/dist/lib/service/guard/ReverseGuard.d.ts

@@ -18,7 +18,7 @@ interface DatabaseLike {
         get(...params: unknown[]): Record<string, unknown> | undefined;
     };
 }
-export type DriftType = 'symbol_missing' | 'match_rate_drop' | 'api_deprecated' | 'zero_match';
+export type DriftType = 'symbol_missing' | 'match_rate_drop' | 'api_deprecated' | 'zero_match' | 'source_ref_stale';
 export type DriftSeverity = 'high' | 'medium' | 'low';
 export interface PatternDriftSignal {
     type: DriftType;

package/dist/lib/service/guard/ReverseGuard.js

@@ -59,9 +59,11 @@ export class ReverseGuard {
         if (recipe.guard_pattern) {
             signals.push(...this.#checkPatternMatchRate(recipe.id, recipe.guard_pattern, projectFiles));
         }
-        // 3. 综合判定
+        // 3. 检查 sourceRef 路径是否失效（与 SourceRefReconciler 数据交叉验证）
+        signals.push(...this.#checkSourceRefStaleness(recipe.id));
+        // 4. 综合判定
         const recommendation = this.#computeRecommendation(signals);
-        // 4. 发射信号
+        // 5. 发射信号
         if (this.#signalBus && signals.length > 0) {
             const severity = recommendation === 'decay' ? 1 : recommendation === 'investigate' ? 0.5 : 0;
             this.#signalBus.send('quality', 'ReverseGuard', severity, {
@@ -205,6 +207,34 @@ export class ReverseGuard {
         }
         return signals;
     }
+    /**
+     * 检查 recipe_source_refs 中是否有 stale 条目（与 SourceRefReconciler 数据交叉验证）
+     */
+    #checkSourceRefStaleness(recipeId) {
+        try {
+            const rows = this.#db
+                .prepare(`SELECT source_path FROM recipe_source_refs WHERE recipe_id = ? AND status = 'stale'`)
+                .all(recipeId);
+            if (rows.length === 0) {
+                return [];
+            }
+            return [
+                {
+                    type: 'source_ref_stale',
+                    detail: `${rows.length} source file(s) no longer exist: ${rows
+                        .slice(0, 3)
+                        .map((r) => r.source_path)
+                        .join(', ')}${rows.length > 3 ? ` (+${rows.length - 3} more)` : ''}`,
+                    severity: rows.length >= 3 ? 'high' : 'medium',
+                    evidence: {},
+                },
+            ];
+        }
+        catch {
+            // recipe_source_refs 表可能不存在
+            return [];
+        }
+    }
     #extractSymbols(coreCode) {
         const symbols = new Set();
         for (const pattern of SYMBOL_PATTERNS) {

package/dist/lib/service/knowledge/ConfidenceRouter.js

@@ -20,7 +20,7 @@ const DEFAULT_CONFIG = {
     /** 自动通过要求 reasoning.isValid() */
     requireReasoning: true,
     /** 来源白名单（这些来源可以适用更宽松的阈值） */
-    trustedSources: ['bootstrap', 'cursor-scan'],
+    trustedSources: ['bootstrap', 'cursor-scan', 'mcp'],
     /** 可信来源的自动通过阈值 */
     trustedAutoApproveThreshold: 0.7,
     /** 极高置信度阈值 (≥0.90 → 24h Grace) */

package/dist/lib/service/knowledge/KnowledgeService.d.ts

@@ -105,8 +105,16 @@ export declare class KnowledgeService {
     _triggerCursorDeliveryAsync(): void;
     /** 弃用 (pending|active → deprecated) */
     deprecate(id: string, reason: string, context: ServiceContext): Promise<KnowledgeEntry>;
-    /** 重新激活 (deprecated → pending) */
+    /** 重新激活 (deprecated|staging → pending) */
     reactivate(id: string, context: ServiceContext): Promise<KnowledgeEntry>;
+    /** 进入暂存期 (pending → staging) */
+    stage(id: string, context: ServiceContext): Promise<KnowledgeEntry>;
+    /** 进入进化态 (active → evolving) */
+    evolve(id: string, context: ServiceContext): Promise<KnowledgeEntry>;
+    /** 进入衰退观察 (active|evolving → decaying) */
+    decay(id: string, context: ServiceContext): Promise<KnowledgeEntry>;
+    /** 恢复为已发布 (decaying|evolving → active) */
+    restore(id: string, context: ServiceContext): Promise<KnowledgeEntry>;
     /** @deprecated 简化后所有条目直接进 pending */
     submit(id: string, _context: ServiceContext): Promise<KnowledgeEntry>;
     /** @deprecated 简化后 approve = publish */
@@ -171,6 +179,8 @@ export declare class KnowledgeService {
     _syncRelationsToGraph(id: string, relations: unknown): void;
     /** 删除所有关联边 */
     _removeAllEdges(id: string): void;
+    /** 删除关联的 evolution_proposals（target_recipe_id 无 CASCADE） */
+    _removeRelatedProposals(id: string): void;
     /** 落盘到 .md 文件 + 回写 sourceFile */
     _persistToFile(entry: KnowledgeEntry): void;
     /** 删除 .md 文件 */

package/dist/lib/service/knowledge/KnowledgeService.js

@@ -49,6 +49,13 @@ export class KnowledgeService {
     async create(data, context) {
         try {
             this._validateCreateInput(data);
+            // ── 标题去重：防止跨维度/跨调用创建同名条目 ──
+            if (data.title) {
+                const existing = await this.repository.findByTitle(data.title);
+                if (existing) {
+                    throw new ConflictError(`Knowledge entry with title "${data.title}" already exists (id: ${existing.id})`, { existingId: existing.id, title: data.title });
+                }
+            }
             const entry = KnowledgeEntry.fromJSON({
                 ...data,
                 lifecycle: Lifecycle.PENDING,
@@ -280,6 +287,8 @@ export class KnowledgeService {
             this._removeFile(entry);
             // 清除 knowledge_edges
             this._removeAllEdges(id);
+            // 清除 evolution_proposals（无 ON DELETE CASCADE，需手动删除）
+            this._removeRelatedProposals(id);
             await this.repository.delete(id);
             await this._audit('delete_knowledge', id, context.userId, {
                 title: entry.title,
@@ -340,10 +349,26 @@ export class KnowledgeService {
             entityArgs: [reason],
         });
     }
-    /** 重新激活 (deprecated → pending) */
+    /** 重新激活 (deprecated|staging → pending) */
     async reactivate(id, context) {
         return this._lifecycleTransition(id, 'reactivate', context);
     }
+    /** 进入暂存期 (pending → staging) */
+    async stage(id, context) {
+        return this._lifecycleTransition(id, 'stage', context);
+    }
+    /** 进入进化态 (active → evolving) */
+    async evolve(id, context) {
+        return this._lifecycleTransition(id, 'evolve', context);
+    }
+    /** 进入衰退观察 (active|evolving → decaying) */
+    async decay(id, context) {
+        return this._lifecycleTransition(id, 'decay', context);
+    }
+    /** 恢复为已发布 (decaying|evolving → active) */
+    async restore(id, context) {
+        return this._lifecycleTransition(id, 'restore', context);
+    }
     // ── 向后兼容别名 ──
     /** @deprecated 简化后所有条目直接进 pending */
     async submit(id, _context) {
@@ -555,9 +580,8 @@ export class KnowledgeService {
             if (entry.reviewedAt) {
                 dbUpdates.reviewedAt = entry.reviewedAt;
             }
-            if (entry.rejectionReason !== null) {
-                dbUpdates.rejectionReason = entry.rejectionReason;
-            }
+            // 驳回原因（含清除：reactivate 后 rejectionReason = null 需写入 DB）
+            dbUpdates.rejectionReason = entry.rejectionReason;
             // 发布字段
             if (entry.publishedAt) {
                 dbUpdates.publishedAt = entry.publishedAt;
@@ -781,6 +805,22 @@ export class KnowledgeService {
             });
         }
     }
+    /** 删除关联的 evolution_proposals（target_recipe_id 无 CASCADE） */
+    _removeRelatedProposals(id) {
+        const gs = this._knowledgeGraphService;
+        if (!gs) {
+            return;
+        }
+        try {
+            gs.db.prepare(`DELETE FROM evolution_proposals WHERE target_recipe_id = ?`).run(id);
+        }
+        catch (err) {
+            this.logger.warn('Failed to remove related proposals', {
+                id,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
     /* ═══ 文件落盘 ═════════════════════════════════ */
     /** 落盘到 .md 文件 + 回写 sourceFile */
     _persistToFile(entry) {

package/dist/lib/service/knowledge/RecipeProductionGateway.d.ts

@@ -0,0 +1,225 @@
+/**
+ * RecipeProductionGateway — 统一 Recipe 生产入口
+ *
+ * 所有 Recipe 创建（Agent Tool / MCP / IDE Agent / Batch Import）
+ * 通过此 Gateway 的统一管道，保证前置校验一致：
+ *
+ *   1. Schema Validation (UnifiedValidator)
+ *   2. Similarity Check — 去重检测（可选跳过）
+ *   3. Consolidation Scan — 融合/重组建议（可选）
+ *   4. KnowledgeService.create() — 包含 ConfidenceRouter → staging / pending
+ *   5. Quality Scoring — 质量评分
+ *   6. Supersede Proposal — 创建替代提案
+ *   7. Audit — 统一审计
+ *
+ * @see docs/copilot/recipe-lifecycle-management.md §6
+ */
+/** Lightweight log interface — avoids importing static-only Logger class. */
+interface GatewayLogger {
+    info(msg: string): void;
+    warn(msg: string): void;
+}
+export type GatewaySource = 'agent-tool' | 'mcp-external' | 'ide-agent' | 'batch-import';
+export interface CreateRecipeItem {
+    title?: string;
+    description?: string;
+    content?: {
+        markdown?: string;
+        pattern?: string;
+        rationale?: string;
+        [key: string]: unknown;
+    };
+    trigger?: string;
+    kind?: string;
+    topicHint?: string;
+    whenClause?: string;
+    doClause?: string;
+    dontClause?: string;
+    coreCode?: string;
+    sourceRefs?: string[];
+    tags?: string[];
+    reasoning?: {
+        whyStandard?: string;
+        sources?: string[];
+        confidence?: number;
+    };
+    headers?: string[];
+    usageGuide?: string;
+    scope?: string;
+    complexity?: string;
+    sourceFile?: string;
+    knowledgeType?: string;
+    language?: string;
+    category?: string;
+    source?: string;
+    [key: string]: unknown;
+}
+export interface CreateRecipeRequest {
+    source: GatewaySource;
+    items: CreateRecipeItem[];
+    options?: {
+        /** 跳过相似度检测（仅 batch-import 可用） */
+        skipSimilarityCheck?: boolean;
+        /** 跳过 ConsolidationAdvisor 分析 */
+        skipConsolidation?: boolean;
+        /** 被替代的旧 Recipe ID */
+        supersedes?: string;
+        /** 相似度阈值，默认 0.7 */
+        similarityThreshold?: number;
+        /** 已提交标题集（批量去重用） */
+        existingTitles?: Set<string>;
+        /** 已提交指纹集（批量去重用） */
+        existingFingerprints?: Set<string>;
+        /** UnifiedValidator 跳过系统注入字段列表 */
+        systemInjectedFields?: string[];
+        /** 跳过唯一性校验 */
+        skipUniqueness?: boolean;
+        /** 操作用户 ID */
+        userId?: string;
+    };
+}
+export interface CreatedRecipeInfo {
+    id: string;
+    title: string;
+    lifecycle: string;
+    /** Raw saved entry from KnowledgeService.create() */
+    raw: Record<string, unknown>;
+}
+export interface RejectedRecipeInfo {
+    index: number;
+    title: string;
+    reason: string;
+    errors: string[];
+    warnings: string[];
+}
+export interface MergedRecipeInfo {
+    index: number;
+    proposalId: string;
+    type: string;
+    targetRecipeId: string;
+    targetTitle: string;
+    status: string;
+    expiresAt: number;
+    message: string;
+}
+export interface BlockedRecipeInfo {
+    index: number;
+    title: string;
+    consolidation: unknown;
+}
+export interface SimilarRecipeInfo {
+    index: number;
+    title: string;
+    similarTo: {
+        file: string;
+        title: string;
+        similarity: number;
+    }[];
+}
+export interface CreateRecipeResult {
+    created: CreatedRecipeInfo[];
+    rejected: RejectedRecipeInfo[];
+    merged: MergedRecipeInfo[];
+    blocked: BlockedRecipeInfo[];
+    duplicates: SimilarRecipeInfo[];
+    supersedeProposal: {
+        proposalId: string;
+    } | null;
+}
+interface GatewayKnowledgeService {
+    create(data: Record<string, unknown>, context: {
+        userId: string;
+    }): Promise<{
+        id: string;
+        title: string;
+        lifecycle: string;
+        kind?: string;
+        [key: string]: unknown;
+    }>;
+    updateQuality(id: string, context: {
+        userId: string;
+    }): Promise<unknown>;
+}
+interface GatewayConsolidationAdvisor {
+    analyzeBatch(candidates: Array<{
+        title: string;
+        category?: string;
+        [key: string]: unknown;
+    }>): {
+        items: Array<{
+            index: number;
+            advice: {
+                action: string;
+                confidence: number;
+                reason: string;
+                targetRecipe?: {
+                    id: string;
+                    title: string;
+                    similarity: number;
+                };
+                reorganizeTargets?: {
+                    id: string;
+                    title: string;
+                    similarity: number;
+                }[];
+                coveredBy?: {
+                    id: string;
+                    title: string;
+                    similarity: number;
+                }[];
+                mergeDirection?: {
+                    addedDimensions: string[];
+                    summary: string;
+                };
+            };
+        }>;
+    };
+}
+interface GatewayProposalRepository {
+    create(data: Record<string, unknown>): {
+        id: string;
+        status: string;
+        expiresAt: number;
+        [key: string]: unknown;
+    } | null;
+}
+type GatewaySimilarityFn = (projectRoot: string, candidate: {
+    title: string;
+    summary: string;
+    code: string;
+}, opts: {
+    threshold: number;
+    topK: number;
+}) => {
+    file: string;
+    title: string;
+    similarity: number;
+}[];
+export interface GatewayDeps {
+    knowledgeService: GatewayKnowledgeService;
+    projectRoot: string;
+    logger?: GatewayLogger;
+    /** ConsolidationAdvisor（可选 — MCP 路径使用） */
+    consolidationAdvisor?: GatewayConsolidationAdvisor | null;
+    /** ProposalRepository（可选 — supersede 提案需要） */
+    proposalRepository?: GatewayProposalRepository | null;
+    /** 相似度检测函数（可选 — 默认导入 SimilarityService） */
+    findSimilarRecipes?: GatewaySimilarityFn | null;
+}
+export declare class RecipeProductionGateway {
+    #private;
+    constructor(deps: GatewayDeps);
+    /**
+     * 统一创建入口
+     *
+     * Pipeline:
+     *   1. Schema Validation (UnifiedValidator)
+     *   2. Similarity Check (除非 skipSimilarityCheck)
+     *   3. Consolidation Scan (除非 skipConsolidation)
+     *   4. KnowledgeService.create() — ConfidenceRouter → staging / pending
+     *   5. Quality Scoring
+     *   6. Supersede Proposal 创建 (if supersedes)
+     */
+    create(request: CreateRecipeRequest): Promise<CreateRecipeResult>;
+}
+export {};