autosnippet 3.3.4 → 3.3.6

package/dist/lib/agent/tools/lifecycle.js

@@ -13,8 +13,7 @@
  * 25.  get_feedback_stats   反馈统计
  */
 import { getInternalAgentRequiredFields, getSystemInjectedFields, } from '#domain/knowledge/FieldSpec.js';
-import { UnifiedValidator } from '#domain/knowledge/UnifiedValidator.js';
-import { checkDimensionType, DIMENSION_DISPLAY_GROUP } from './_shared.js';
+import { checkDimensionType, DIMENSION_DISPLAY_GROUP, stripProjectNamePrefix, } from './_shared.js';
 // ────────────────────────────────────────────────────────────
 // 16. submit_knowledge
 // ────────────────────────────────────────────────────────────
@@ -71,14 +70,24 @@ export const submitCandidate = {
                 description: '知识维度：code-pattern / architecture / best-practice 等',
             },
             usageGuide: { type: 'string', description: '使用指南 Markdown（### 章节格式）' },
-            sourceFile: { type: 'string', description: '来源文件相对路径' },
+            sourceFile: {
+                type: 'string',
+                description: 'Recipe md 文件相对路径（由系统自动设置，无需手动填写）',
+            },
+            supersedes: {
+                type: 'string',
+                description: '被替代的旧 Recipe ID。传入后将创建 supersede 提案，72h 观察窗口后自动替代。',
+            },
         },
         // FieldSpec 驱动: 内部 Agent 路径排除系统注入字段
         required: getInternalAgentRequiredFields(),
     },
     handler: async (params, ctx) => {
-        const knowledgeService = ctx.container.get('knowledgeService');
-        // ── Bootstrap 维度类型校验 ──
+        // ── 标题正规化：剥离冗余的项目名前缀 ──
+        if (params.title) {
+            params.title = stripProjectNamePrefix(params.title, ctx.projectRoot);
+        }
+        // ── Bootstrap 维度类型校验（source-specific: 仅 bootstrap 流程） ──
         const dimMeta = ctx._dimensionMeta;
         if (dimMeta && ctx.source === 'system') {
             const rejected = checkDimensionType(dimMeta, params, ctx.logger);
@@ -95,89 +104,64 @@ export const submitCandidate = {
             if (!params.tags.includes('bootstrap')) {
                 params.tags.push('bootstrap');
             }
-            // Bootstrap 模式: 将 category 覆盖为展示分组 ID
-            params._category =
-                DIMENSION_DISPLAY_GROUP[dimMeta.id] || dimMeta.id;
-            // ── UnifiedValidator 统一质量验证（替代 CandidateGuardrail） ──
-            const validator = ctx._validator ||
-                new UnifiedValidator({
-                    existingTitles: ctx._submittedTitles || new Set(),
-                    existingFingerprints: ctx._submittedPatterns || new Set(),
-                });
-            const validResult = validator.validate(params, {
-                systemInjectedFields: getSystemInjectedFields(),
-            });
-            if (!validResult.pass) {
-                ctx.logger?.info(`[submit_knowledge] ✗ validator rejected: ${validResult.errors.join('; ')}`);
-                return {
-                    status: 'rejected',
-                    error: validResult.errors.join('\n'),
-                    warnings: validResult.warnings,
-                    hint: '请根据错误信息调整内容后重新提交。',
-                };
-            }
-            if (validResult.warnings.length > 0) {
-                ctx.logger?.debug(`[submit_knowledge] ⚠ warnings: ${validResult.warnings.join('; ')}`);
-            }
+            // Bootstrap 模式: 将 category 设为维度 ID（前端按此分组显示）
+            params._category = dimMeta.id;
         }
         // ── 系统自动设置 ──
-        const systemFields = {
+        const item = {
+            ...params,
             language: ctx._projectLanguage || '',
-            category: dimMeta
-                ? DIMENSION_DISPLAY_GROUP[dimMeta.id] || dimMeta.id
-                : 'general',
-            knowledgeType: dimMeta?.allowedKnowledgeTypes?.[0] || 'code-pattern',
+            category: dimMeta ? dimMeta.id : params._category || 'general',
+            knowledgeType: dimMeta?.allowedKnowledgeTypes?.[0] || params.knowledgeType || 'code-pattern',
             source: ctx.source === 'system' ? 'bootstrap' : 'agent',
-        };
-        // ── 直传 → KnowledgeEntry ──
-        const reasoning = params.reasoning || { whyStandard: '', sources: ['agent'], confidence: 0.7 };
-        if (Array.isArray(reasoning.sources) && reasoning.sources.length === 0) {
-            reasoning.sources = ['agent'];
-        }
-        // V3 content 直透
-        const contentObj = params.content && typeof params.content === 'object'
-            ? params.content
-            : { markdown: '', pattern: '' };
-        const data = {
-            ...systemFields,
-            title: params.title || '',
-            description: params.description || '',
-            tags: params.tags || [],
-            trigger: params.trigger || '',
-            kind: params.kind || 'pattern',
-            topicHint: params.topicHint || '',
-            whenClause: params.whenClause || '',
-            doClause: params.doClause || '',
-            dontClause: params.dontClause || '',
-            coreCode: contentObj.pattern || '',
-            content: contentObj,
-            reasoning,
-            // V3 扩展字段直透
-            scope: params.scope || '',
-            complexity: params.complexity || '',
-            headers: params.headers || [],
-            // 注意: sourceFile 由 KnowledgeFileWriter.persist() 自动设置，
-            // 不应从 AI params/reasoning.sources 取值（那是项目源文件路径，不是知识文件路径）
-            sourceFile: '',
-            // 7.3.9 agentNotes/aiInsight 注入
             agentNotes: dimMeta
                 ? { dimensionId: dimMeta.id, outputType: dimMeta.outputType || 'candidate' }
                 : null,
-            aiInsight: reasoning.whyStandard || params.description || null,
         };
         if (dimMeta && ctx.source === 'system') {
             const displayGroup = DIMENSION_DISPLAY_GROUP[dimMeta.id] || dimMeta.id;
-            data.tags = [...new Set([...(data.tags || []), displayGroup])];
+            item.tags = [...new Set([...(item.tags || []), displayGroup])];
         }
-        const saved = await knowledgeService.create(data, { userId: 'agent' });
-        // ── QualityScorer 自动评分 ──
-        try {
-            await knowledgeService.updateQuality(saved.id, { userId: 'agent' });
+        // ── 委托 RecipeProductionGateway 统一管道 ──
+        const { RecipeProductionGateway } = await import('#service/knowledge/RecipeProductionGateway.js');
+        const gateway = new RecipeProductionGateway({
+            knowledgeService: ctx.container.get('knowledgeService'),
+            projectRoot: ctx.projectRoot,
+            logger: ctx.logger,
+            proposalRepository: ctx.container.get('proposalRepository') ?? null,
+        });
+        const gatewayResult = await gateway.create({
+            source: 'agent-tool',
+            items: [item],
+            options: {
+                skipSimilarityCheck: true,
+                skipConsolidation: true,
+                supersedes: params.supersedes,
+                existingTitles: ctx._submittedTitles,
+                existingFingerprints: ctx._submittedPatterns,
+                systemInjectedFields: dimMeta && ctx.source === 'system' ? getSystemInjectedFields() : undefined,
+                userId: 'agent',
+            },
+        });
+        // ── 映射 Gateway 结果 → 原有返回格式 ──
+        if (gatewayResult.rejected.length > 0) {
+            const rej = gatewayResult.rejected[0];
+            ctx.logger?.info(`[submit_knowledge] ✗ validator rejected: ${rej.errors.join('; ')}`);
+            return {
+                status: 'rejected',
+                error: rej.errors.join('\n'),
+                warnings: rej.warnings,
+                hint: '请根据错误信息调整内容后重新提交。',
+            };
         }
-        catch {
-            /* best effort — 不阻塞创建流程 */
+        if (gatewayResult.created.length > 0) {
+            const created = gatewayResult.created[0];
+            if (gatewayResult.supersedeProposal) {
+                return { ...created.raw, _supersedeProposal: gatewayResult.supersedeProposal };
+            }
+            return created.raw;
         }
-        return saved;
+        return { status: 'error', error: 'No items created' };
     },
 };
 // ────────────────────────────────────────────────────────────

package/dist/lib/cli/AiScanService.js

@@ -97,7 +97,7 @@ export class AiScanService {
                         recipe.source = 'ai-scan';
                         recipe.tags = [...new Set([...(recipe.tags || []), 'ai-scan', file.targetName])];
                         recipe.moduleName = file.targetName;
-                        recipe.sourceFile = file.relativePath || file.name;
+                        // 注意：不设置 sourceFile，由 KnowledgeFileWriter 持久化时自动设置为 md 文件路径
                         if (!recipe.aiInsight && recipe.description) {
                             recipe.aiInsight = recipe.description;
                         }

package/dist/lib/cli/KnowledgeSyncService.d.ts

@@ -15,6 +15,7 @@
  */
 import Logger from '../infrastructure/logging/Logger.js';
 import type { ApplyReport, ReconcileReport, RepairReport } from '../service/knowledge/SourceRefReconciler.js';
+import { SourceRefReconciler } from '../service/knowledge/SourceRefReconciler.js';
 export interface SyncAllReport {
     synced: number;
     created: number;
@@ -27,11 +28,14 @@ export interface SyncAllReport {
     applyReport?: ApplyReport;
 }
 export declare class KnowledgeSyncService {
+    #private;
     candidatesDir: string;
     logger: ReturnType<typeof Logger.getInstance>;
     projectRoot: string;
     recipesDir: string;
-    constructor(projectRoot: string);
+    constructor(projectRoot: string, options?: {
+        sourceRefReconciler?: SourceRefReconciler;
+    });
     /**
      * 完整同步入口 — sync + reconcile + repair
      *

package/dist/lib/cli/KnowledgeSyncService.js

@@ -25,11 +25,13 @@ export class KnowledgeSyncService {
     logger;
     projectRoot;
     recipesDir;
-    constructor(projectRoot) {
+    #sourceRefReconciler;
+    constructor(projectRoot, options) {
         this.projectRoot = projectRoot;
         this.recipesDir = path.join(projectRoot, RECIPES_DIR);
         this.candidatesDir = path.join(projectRoot, CANDIDATES_DIR);
         this.logger = Logger.getInstance();
+        this.#sourceRefReconciler = options?.sourceRefReconciler ?? null;
     }
     /**
      * 完整同步入口 — sync + reconcile + repair
@@ -46,7 +48,8 @@ export class KnowledgeSyncService {
         const report = { ...syncReport };
         // 2. 填充/验证 recipe_source_refs 桥接表
         try {
-            const reconciler = new SourceRefReconciler(this.projectRoot, db);
+            const reconciler = this.#sourceRefReconciler ??
+                new SourceRefReconciler(this.projectRoot, db);
             report.reconcileReport = reconciler.reconcile({ force: opts.force });
             // 3. git rename 修复
             report.repairReport = await reconciler.repairRenames();
@@ -345,7 +348,7 @@ export class KnowledgeSyncService {
                SET lifecycle = 'deprecated', 
                    rejectionReason = ?, 
                    updatedAt = ?
-               WHERE id = ?`).run('source file deleted (orphan)', now, row.id);
+               WHERE id = ?`).run('源文件已删除（孤儿条目）', now, row.id);
                     }
                 }
             }

package/dist/lib/core/AstAnalyzer.d.ts

@@ -262,3 +262,4 @@ declare function checkProtocolConformance(source: string, lang: string, classNam
     classDeclLine: number | undefined;
 };
 export { analyzeFile, analyzeProject, generateContextForAgent, isAvailable, supportedLanguages, findCallExpressions, findPatternInContext, checkProtocolConformance, parseToTree, };
+export type { ProjectAnalysisResult };

package/dist/lib/{service/bootstrap/DimensionCopyRegistry.d.ts → domain/dimension/DimensionCopy.d.ts}

@@ -7,8 +7,8 @@
  *
  * ---
  * 使用方式：
- *   import { DimensionCopy } from '../service/bootstrap/DimensionCopyRegistry.js';
- *   const copy = DimensionCopy.get('code-pattern', 'python');
+ *   import { DimensionCopy } from '#domain/dimension/DimensionCopy.js';
+ *   const copy = DimensionCopy.get('design-patterns', 'python');
  *   // → { label: '设计模式与代码惯例', guide: '装饰器/描述器/上下文管理器/生成器/ABC 抽象基类/Mixin 模式' }
  */
 export declare class DimensionCopy {

package/dist/lib/{service/bootstrap/DimensionCopyRegistry.js → domain/dimension/DimensionCopy.js}

@@ -7,10 +7,11 @@
  *
  * ---
  * 使用方式：
- *   import { DimensionCopy } from '../service/bootstrap/DimensionCopyRegistry.js';
- *   const copy = DimensionCopy.get('code-pattern', 'python');
+ *   import { DimensionCopy } from '#domain/dimension/DimensionCopy.js';
+ *   const copy = DimensionCopy.get('design-patterns', 'python');
  *   // → { label: '设计模式与代码惯例', guide: '装饰器/描述器/上下文管理器/生成器/ABC 抽象基类/Mixin 模式' }
  */
+import { getDimension } from './DimensionRegistry.js';
 // ═══════════════════════════════════════════════════════════
 // 语言族定义
 // ═══════════════════════════════════════════════════════════
@@ -45,11 +46,7 @@ function _langFamily(lang) {
  */
 const COPY_REGISTRY = {
     // ── ① 代码规范 ──────────────────────────────────────
-    'code-standard': {
-        _default: {
-            label: '代码规范',
-            guide: '命名约定、注释风格、文件组织规范、代码格式化标准',
-        },
+    'coding-standards': {
         apple: {
             label: '代码规范',
             guide: '命名约定（类名前缀/方法签名风格/API 命名）、注释风格（语言/格式/MARK 分段）、文件组织规范',
@@ -80,11 +77,7 @@ const COPY_REGISTRY = {
         },
     },
     // ── ② 设计模式与代码惯例 ─────────────────────────────
-    'code-pattern': {
-        _default: {
-            label: '设计模式与代码惯例',
-            guide: '单例/工厂/观察者/策略/Builder 等设计模式在项目中的使用方式',
-        },
+    'design-patterns': {
         apple: {
             label: '设计模式与代码惯例',
             guide: '单例/委托/Category·Extension/工厂/Builder/观察者/Coordinator 模式、继承关系',
@@ -116,10 +109,6 @@ const COPY_REGISTRY = {
     },
     // ── ③ 架构模式 ──────────────────────────────────────
     architecture: {
-        _default: {
-            label: '架构模式',
-            guide: '分层架构、模块职责与边界、依赖图、导入约束规则',
-        },
         apple: {
             label: '架构模式',
             guide: '分层架构（MVVM/VIPER/TCA）、Package/Target 模块边界、依赖图、import 约束规则',
@@ -149,12 +138,8 @@ const COPY_REGISTRY = {
             guide: '分层架构、Workspace/crate 边界、pub/pub(crate) 可见性、trait object 抽象层',
         },
     },
-    // ── ④ 最佳实践 ──────────────────────────────────────
-    'best-practice': {
-        _default: {
-            label: '最佳实践',
-            guide: '错误处理、并发安全、资源管理、日志规范、测试模式',
-        },
+    // ── ④ 错误韧性 ──────────────────────────────────────
+    'error-resilience': {
         apple: {
             label: '最佳实践',
             guide: '错误处理、并发安全（Swift Concurrency/GCD）、内存管理（ARC/weak/unowned）、日志规范、XCTest 模式',
@@ -184,12 +169,8 @@ const COPY_REGISTRY = {
             guide: '错误处理（Result/? 操作符/thiserror）、并发安全（Send+Sync/Arc/Mutex）、生命周期管理、日志（tracing）、#[test] 模式',
         },
     },
-    // ── ⑤ 事件与数据流 ─────────────────────────────────
-    'event-and-data-flow': {
-        _default: {
-            label: '事件与数据流',
-            guide: '事件传播机制、状态管理模式、数据流向追踪',
-        },
+    // ── ⑤ 数据与事件流 ─────────────────────────────────
+    'data-event-flow': {
         apple: {
             label: '事件与数据流',
             guide: '事件传播（Delegate/Notification/Block·Closure/Target-Action）、数据状态管理（KVO/属性观察/Combine/SwiftUI State）',
@@ -219,47 +200,8 @@ const COPY_REGISTRY = {
             guide: '事件传播（tokio channel/crossbeam-channel）、Stream trait、Actor 模式（Actix）、状态管理（Arc<RwLock<T>>）',
         },
     },
-    // ── ⑥ 项目特征 ──────────────────────────────────────
-    'project-profile': {
-        _default: {
-            label: '项目特征',
-            guide: '技术栈、目录结构、三方依赖枚举与用途、基础设施服务注册表',
-        },
-        apple: {
-            label: '项目特征',
-            guide: '技术栈、目录结构、三方依赖枚举与用途、Extension/Category 分类聚合、自定义基类层级与全局定义（宏/typealias/PCH）、系统事件 hook 与生命周期入口、基础设施服务注册表、Runtime 与语言互操作',
-        },
-        js: {
-            label: '项目特征',
-            guide: '技术栈（框架/构建工具/包管理器）、目录结构、三方依赖枚举与用途、monorepo 配置、环境变量与配置注入、CI/CD 管线',
-        },
-        jvm: {
-            label: '项目特征',
-            guide: '技术栈（Spring/Android/Ktor）、module 结构、三方依赖枚举与用途、构建配置（Gradle/Maven）、Profile 环境管理、基础设施服务',
-        },
-        python: {
-            label: '项目特征',
-            guide: '技术栈（Django/FastAPI/Flask）、包结构、三方依赖枚举与用途、pyproject.toml/setup.cfg 配置、虚拟环境管理',
-        },
-        go: {
-            label: '项目特征',
-            guide: '技术栈、module 结构、go.mod 依赖枚举与用途、internal 包组织、build tags、Makefile 构建',
-        },
-        dart: {
-            label: '项目特征',
-            guide: '技术栈（Flutter/Dart Server/CLI）、目录结构（lib/src 分层）、pubspec.yaml 依赖枚举与用途、平台通道（MethodChannel/FFI）、Flavors/多环境配置',
-        },
-        rust: {
-            label: '项目特征',
-            guide: '技术栈、Workspace/crate 结构、Cargo.toml 依赖枚举与用途、feature flags、#[cfg] 条件编译',
-        },
-    },
-    // ── ⑦ Agent 开发注意事项 ─────────────────────────────
+    // ── ⑥ Agent 开发注意事项 ─────────────────────────────
     'agent-guidelines': {
-        _default: {
-            label: 'Agent 开发注意事项',
-            guide: '三大核心原则（严谨性/深度特征挖掘/完整性）、命名强制、并发安全、资源管理、已废弃 API 标记、架构约束注释、TODO/FIXME',
-        },
         apple: {
             label: 'Agent 开发注意事项',
             guide: '三大核心原则（严谨性/深度特征挖掘/完整性）、命名强制、线程安全、内存约束、已废弃 API 标记、架构约束注释、TODO/FIXME',
@@ -302,11 +244,19 @@ export class DimensionCopy {
      */
     static get(dimId, lang) {
         const entry = COPY_REGISTRY[dimId];
-        if (!entry) {
-            return null;
+        if (entry) {
+            const family = _langFamily(lang);
+            const match = entry[family] || entry[lang];
+            if (match) {
+                return match;
+            }
+        }
+        // 回退到 Registry 元数据（消除 _default 双源）
+        const dim = getDimension(dimId);
+        if (dim) {
+            return { label: dim.label, guide: dim.extractionGuide };
         }
-        const family = _langFamily(lang);
-        return entry[family] || entry[lang] || entry._default || null;
+        return null;
     }
     /**
      * 批量为维度数组注入语言差异化文案（单语言版本）

package/dist/lib/domain/dimension/DimensionRegistry.d.ts

@@ -0,0 +1,54 @@
+/**
+ * DimensionRegistry — 统一维度注册表 (Single Source of Truth)
+ *
+ * 25 个维度定义:
+ *   Layer 1 (Universal): D1-D13 — 所有项目适用
+ *   Layer 2 (Language):  DL1-DL7 — 按项目语言激活
+ *   Layer 3 (Framework): DF1-DF5 — 按检测到的框架激活
+ *
+ * 这是整个系统中维度定义的唯一来源。
+ * Bootstrap / Panorama / Rescan / Dashboard 均从此模块消费维度元数据。
+ *
+ * 设计文档: docs/copilot/unified-dimension-design.md §4
+ *
+ * @module domain/dimension/DimensionRegistry
+ */
+import type { DimensionId, UnifiedDimension } from './UnifiedDimension.js';
+export declare const DIMENSION_REGISTRY: readonly UnifiedDimension[];
+/**
+ * 维度 ID → 展示分组 ID 映射
+ *
+ *  展示分组:
+ *   - 'architecture'     — 架构与设计
+ *   - 'best-practice'    — 规范与实践
+ *   - 'data-event-flow'  — 数据与并发
+ *   - 'deep-scan'        — 深度扫描（语言/框架条件维度）
+ */
+export declare const DIMENSION_DISPLAY_GROUP: Record<string, string>;
+/** 按 ID 获取维度 */
+export declare function getDimension(id: string): UnifiedDimension | undefined;
+/** 获取指定层级的所有维度 */
+export declare function getDimensionsByLayer(layer: 'universal' | 'language' | 'framework'): readonly UnifiedDimension[];
+/**
+ * 根据项目语言和框架过滤出活跃维度
+ *
+ * - Layer 1 (universal): 全部返回
+ * - Layer 2 (language): 仅当项目语言匹配时返回
+ * - Layer 3 (framework): 仅当项目语言+框架均匹配时返回
+ */
+export declare function resolveActiveDimensions(primaryLang: string, detectedFrameworks?: string[]): readonly UnifiedDimension[];
+/**
+ * 构建 Tier 分层调度计划
+ *
+ * 基于每个维度的 tierHint 字段将活跃维度分为 3 层:
+ * - Tier 1 (tierHint=1): 基础数据层 — architecture + 语言/框架条件维度
+ * - Tier 2 (tierHint=2): 规范+设计层 — coding-standards, design-patterns
+ * - Tier 3 (tierHint=3): 实践+质量层 — 其余所有维度
+ */
+export declare function buildTierPlan(activeDims?: readonly UnifiedDimension[]): string[][];
+/**
+ * 将 Recipe 分类到最匹配的维度
+ *
+ * 优先级: topicHint 精确匹配 → category 匹配 → null
+ */
+export declare function classifyRecipeToDimension(topicHint: string, category: string): DimensionId | null;