autosnippet 3.3.5 → 3.3.7

package/dist/lib/external/mcp/handlers/bootstrap/base-dimensions.js

@@ -1,202 +1,47 @@
 /**
  * Bootstrap 基础维度定义 + 维度条件化过滤
  *
- * 内部 Agent 和外部 Agent 共享此模块。
- * 包含 9+ 维度的完整定义（通用维度 + 语言条件维度）。
+ * **v2: 从统一维度注册表 (DimensionRegistry) 派生**
+ *
+ * 此模块现在是 DimensionRegistry 的瘦适配层：
+ * - `baseDimensions` 从 DIMENSION_REGISTRY 转换为旧格式，保持下游 API 兼容
+ * - `resolveActiveDimensions()` 委托给 DimensionRegistry.resolveActiveDimensions()
+ * - `BaseDimension` 接口保留给 MissionBriefingBuilder 等消费者使用
  *
  * 调用方:
  *   - bootstrap.js (内部 Agent) — Phase 4 构建响应骨架 + Phase 5 维度填充
  *   - bootstrap-external.js (外部 Agent) — Mission Briefing 中的维度清单
  */
-// ═══════════════════════════════════════════════════════════
-// 基础维度定义
-// ═══════════════════════════════════════════════════════════
+import { resolveActiveDimensions as _resolveActive, DIMENSION_REGISTRY, } from '#domain/dimension/index.js';
 /**
- * 9+ 维度定义（Phase 4 响应 + Phase 5 候选创建共用）
- * skillWorthy 维度会在 Phase 5.5 自动生成 Project Skill（宏观叙事性知识）
- * 注意：anti-pattern 已移除 — 代码问题由 Guard 独立处理，bootstrap 不做错误检测
- *
- * 执行顺序优化（v5.1）：
- *   ⑧ ⑨ 提前到 ⑥ 前面执行 → deep-scan / category-scan 的中间结果
- *   通过 PipelineContext 缓存，供 project-profile 复用，避免重复扫描
+ * 将 UnifiedDimension 转换为旧 BaseDimension 格式
+ * 保持下游 MissionBriefingBuilder / dimension-configs 兼容
  */
-export const baseDimensions = [
-    // ── 通用维度（所有语言共享）──────────────────────────────────
-    // ① 代码规范（Dual: Skill + Candidate）
-    {
-        id: 'code-standard',
-        label: '代码规范',
-        guide: '命名约定（类名前缀/方法签名风格/API 命名）、注释风格（语言/格式/MARK 分段）、文件组织规范',
-        knowledgeTypes: ['code-standard', 'code-style'],
-        skillWorthy: true,
-        dualOutput: true,
-        skillMeta: {
-            name: 'project-code-standard',
-            description: 'Project coding standards and naming conventions (auto-generated by bootstrap)',
-        },
-    },
-    // ② 代码模式（Candidate）
-    {
-        id: 'code-pattern',
-        label: '设计模式与代码惯例',
-        guide: '单例/委托/Category·Extension/工厂/Builder/观察者/Coordinator 模式、继承关系',
-        knowledgeTypes: ['code-pattern', 'code-relation', 'inheritance'],
-    },
-    // ③ 架构模式（Dual: Skill + Candidate）
-    {
-        id: 'architecture',
-        label: '架构模式',
-        guide: '分层架构、模块职责与边界、依赖图、导入约束规则',
-        knowledgeTypes: ['architecture', 'module-dependency', 'boundary-constraint'],
-        skillWorthy: true,
-        dualOutput: true,
-        skillMeta: {
-            name: 'project-architecture',
-            description: 'Project architecture layers, module boundaries and dependency graph (auto-generated by bootstrap)',
-        },
-    },
-    // ④ 最佳实践（Candidate）
-    {
-        id: 'best-practice',
-        label: '最佳实践',
-        guide: '错误处理、并发安全、内存管理、日志规范、测试模式',
-        knowledgeTypes: ['best-practice'],
-    },
-    // ⑤ 事件与数据流（Candidate）
-    {
-        id: 'event-and-data-flow',
-        label: '事件与数据流',
-        guide: '事件传播（Delegate/Notification/Block·Closure/Target-Action）、数据状态管理（KVO/属性观察/响应式/持久化）',
-        knowledgeTypes: ['call-chain', 'data-flow'],
-    },
-    // ⑥ 项目特征（Dual: Skill + Candidate）
-    {
-        id: 'project-profile',
-        label: '项目特征',
-        guide: '技术栈、目录结构、三方依赖枚举与用途、Extension/Category 分类聚合、自定义基类层级与全局定义（宏/typealias/PCH）、系统事件 hook 与生命周期入口、基础设施服务注册表、Runtime 与语言互操作',
-        knowledgeTypes: ['architecture'],
-        skillWorthy: true,
-        dualOutput: true,
-        skillMeta: {
-            name: 'project-profile',
-            description: 'Project tech stack, module structure, third-party dependencies, base extensions/classes, event hooks, infrastructure services, and runtime/interop features (auto-generated by bootstrap)',
-        },
-    },
-    // ⑦ 项目开发强制规范（Skill）
-    {
-        id: 'agent-guidelines',
-        label: '项目开发强制规范',
-        guide: '三大核心原则（严谨性/深度特征挖掘/完整性）、命名强制、线程安全、内存约束、已废弃 API 标记、架构约束注释、TODO/FIXME',
-        knowledgeTypes: ['boundary-constraint', 'code-standard'],
-        skillWorthy: true,
-        skillMeta: {
-            name: 'project-agent-guidelines',
-            description: 'Mandatory coding rules, deprecated APIs and project constraints (auto-generated by bootstrap)',
-        },
-    },
-    // ── 语言条件维度（按 conditions 过滤）──────────────────────
-    // ⑧ ObjC/Swift 深度扫描
-    {
-        id: 'objc-deep-scan',
-        label: '深度扫描（常量/Hook）',
-        guide: '全量扫描 #define 值宏/函数宏、extern/static 常量、Method Swizzling hook 对（开发者必须使用项目常量，修改被 hook 方法前必须查阅 hook 清单）',
-        knowledgeTypes: ['code-standard', 'code-pattern'],
-        conditions: { languages: ['objectivec', 'swift'] },
-        skillWorthy: true,
-        dualOutput: true,
-        skillMeta: {
-            name: 'project-objc-deep-scan',
-            description: 'Project #define macros, static constants, and Method Swizzling hooks (auto-generated by bootstrap)',
-        },
-    },
-    // ⑨ Foundation/UIKit Category/Extension 专项扫描
-    {
-        id: 'category-scan',
-        label: '基础类分类方法扫描',
-        guide: 'Foundation/UIKit Category/Extension 逐方法清单（含完整实现代码与项目使用频次），仅扫描基础类分类、不含业务代码（遇到同等功能必须使用项目已有分类方法，禁止重复实现）',
-        knowledgeTypes: ['code-standard', 'code-pattern'],
-        conditions: { languages: ['objectivec', 'swift'] },
-        skillWorthy: true,
-        dualOutput: true,
-        skillMeta: {
-            name: 'project-category-scan',
-            description: 'Foundation/UIKit Category and Extension methods with implementations and usage patterns — base classes only, no business code (auto-generated by bootstrap)',
-        },
-    },
-    // ⑩ TS/JS 模块导出分析
-    {
-        id: 'module-export-scan',
-        label: '模块导出分析',
-        guide: 'barrel export 结构、re-export 链路、public API surface、tree-shaking 合规性',
-        knowledgeTypes: ['code-standard', 'architecture'],
-        conditions: { languages: ['typescript', 'javascript'] },
-        skillWorthy: true,
-        dualOutput: true,
-        skillMeta: {
-            name: 'project-module-exports',
-            description: 'Module export structure and public API surface (auto-generated by bootstrap)',
-        },
-    },
-    // ⑪ TS/JS 框架约定扫描
-    {
-        id: 'framework-convention-scan',
-        label: '框架约定扫描',
-        guide: '组件目录结构、状态管理约定、路由约定、样式约定、数据获取模式',
-        knowledgeTypes: ['code-standard', 'architecture'],
-        conditions: {
-            languages: ['typescript', 'javascript'],
-            frameworks: ['react', 'vue', 'angular', 'nextjs', 'nuxt'],
-        },
-        skillWorthy: true,
-        dualOutput: true,
-        skillMeta: {
-            name: 'project-framework-conventions',
-            description: 'Framework-specific conventions and patterns (auto-generated by bootstrap)',
-        },
-    },
-    // ⑫ Python 包结构分析
-    {
-        id: 'python-package-scan',
-        label: 'Python 包结构分析',
-        guide: '__init__.py 导出策略、相对/绝对导入风格、type hints 覆盖率、decorator 使用模式、__all__ 定义',
-        knowledgeTypes: ['code-standard', 'architecture'],
-        conditions: { languages: ['python'] },
-        skillWorthy: true,
-        dualOutput: true,
-        skillMeta: {
-            name: 'project-python-structure',
-            description: 'Python package structure, import patterns and type hint coverage (auto-generated by bootstrap)',
-        },
-    },
-    // ⑬ Java/Kotlin 注解扫描
-    {
-        id: 'jvm-annotation-scan',
-        label: '注解/Annotation 扫描',
-        guide: 'DI 注解（@Inject/@Autowired/@Component）、ORM 注解（@Entity/@Table）、API 注解（@RestController/@RequestMapping）、自定义注解、元编程模式',
-        knowledgeTypes: ['code-pattern', 'architecture'],
-        conditions: { languages: ['java', 'kotlin'] },
-        skillWorthy: true,
-        dualOutput: true,
-        skillMeta: {
-            name: 'project-jvm-annotations',
-            description: 'Annotation/DI usage patterns and meta-programming (auto-generated by bootstrap)',
-        },
-    },
-    // ⑭ Go 模块结构分析
-    {
-        id: 'go-module-scan',
-        label: 'Go 模块结构分析',
-        guide: 'go.mod 依赖图、internal 包隔离边界、cmd/ 入口点枚举、build tags/constraints、interface 分布与实现关系、init() 函数清单',
-        knowledgeTypes: ['architecture', 'code-pattern'],
-        conditions: { languages: ['go'] },
-        skillWorthy: true,
-        dualOutput: true,
-        skillMeta: {
-            name: 'project-go-module-structure',
-            description: 'Go module structure, internal packages, build tags and interface distribution (auto-generated by bootstrap)',
-        },
-    },
-];
+function toBaseDimension(dim) {
+    return {
+        id: dim.id,
+        label: dim.label,
+        guide: dim.extractionGuide,
+        knowledgeTypes: [...dim.allowedKnowledgeTypes],
+        skillWorthy: false,
+        dualOutput: false,
+        conditions: dim.conditions
+            ? {
+                languages: dim.conditions.languages ? [...dim.conditions.languages] : undefined,
+                frameworks: dim.conditions.frameworks ? [...dim.conditions.frameworks] : undefined,
+            }
+            : undefined,
+        tierHint: dim.tierHint,
+    };
+}
+/**
+ * 从统一注册表派生的维度列表
+ * 保持数组结构与旧 baseDimensions 兼容
+ */
+export const baseDimensions = DIMENSION_REGISTRY.map(toBaseDimension);
+// ═══════════════════════════════════════════════════════════
+// 维度条件化过滤
+// ═══════════════════════════════════════════════════════════
 /**
  * 根据项目主语言和检测到的框架过滤条件维度
  * @param allDimensions 所有维度定义（含 conditions 字段）
@@ -205,14 +50,18 @@ export const baseDimensions = [
  * @returns 适用的维度列表
  */
 export function resolveActiveDimensions(allDimensions, primaryLang, detectedFrameworks = []) {
+    // 若传入的是完整 baseDimensions，直接委托给注册表
+    if (allDimensions === baseDimensions) {
+        return _resolveActive(primaryLang, detectedFrameworks).map(toBaseDimension);
+    }
+    // 若传入自定义维度列表（如 Enhancement Pack 追加），使用原有逻辑
     return allDimensions.filter((dim) => {
         if (!dim.conditions) {
-            return true; // 无条件 → 通用维度
+            return true;
         }
         const langMatch = !dim.conditions.languages || dim.conditions.languages.includes(primaryLang);
         const fwMatch = !dim.conditions.frameworks ||
             dim.conditions.frameworks.some((f) => detectedFrameworks.includes(f));
-        // languages 必须匹配；frameworks 为可选增强（有 frameworks 条件时必须至少命中一个）
         return langMatch && (dim.conditions.frameworks ? fwMatch : true);
     });
 }

package/dist/lib/external/mcp/handlers/bootstrap/pipeline/dimension-configs.d.ts

@@ -1,70 +1,24 @@
 /**
  * dimension-configs.js — v3.0 维度配置 + Tier Reflection
  *
+ * **v2: 从统一维度注册表 (DimensionRegistry) 派生**
+ *
  * 从 orchestrator.js 拆分，包含:
- * - DIMENSION_CONFIGS_V3: 仅保留内部 Agent 专属配置 (outputType + allowedKnowledgeTypes)
+ * - DIMENSION_CONFIGS_V3: 维度的 outputType + allowedKnowledgeTypes
+ *   现在从 DimensionRegistry 自动生成，无需手动维护
  * - getFullDimensionConfig(): 合并 baseDimensions + V3 专属配置
  * - buildTierReflection: Tier 级反思聚合 (规则化, 不需要 AI)
  *
- * label / guide → 从 baseDimensions 获取（唯一权威来源）
- * SOP / commonMistakes → 从 dimension-sop.js 获取
- *
  * @module pipeline/dimension-configs
  */
-export declare const DIMENSION_CONFIGS_V3: {
-    'project-profile': {
-        outputType: string;
-        allowedKnowledgeTypes: string[];
-    };
-    'objc-deep-scan': {
-        outputType: string;
-        allowedKnowledgeTypes: string[];
-    };
-    'category-scan': {
-        outputType: string;
-        allowedKnowledgeTypes: string[];
-    };
-    'code-standard': {
-        outputType: string;
-        allowedKnowledgeTypes: string[];
-    };
-    architecture: {
-        outputType: string;
-        allowedKnowledgeTypes: string[];
-    };
-    'code-pattern': {
-        outputType: string;
-        allowedKnowledgeTypes: string[];
-    };
-    'event-and-data-flow': {
-        outputType: string;
-        allowedKnowledgeTypes: string[];
-    };
-    'best-practice': {
-        outputType: string;
-        allowedKnowledgeTypes: string[];
-    };
-    'agent-guidelines': {
-        outputType: string;
-        allowedKnowledgeTypes: string[];
-    };
-    'module-export-scan': {
-        outputType: string;
-        allowedKnowledgeTypes: string[];
-    };
-    'framework-convention-scan': {
-        outputType: string;
-        allowedKnowledgeTypes: string[];
-    };
-    'python-package-scan': {
-        outputType: string;
-        allowedKnowledgeTypes: string[];
-    };
-    'jvm-annotation-scan': {
-        outputType: string;
-        allowedKnowledgeTypes: string[];
-    };
-};
+/**
+ * 从统一注册表生成 V3 配置映射
+ * 所有维度统一为 candidate-only outputType
+ */
+export declare const DIMENSION_CONFIGS_V3: Record<string, {
+    outputType: string;
+    allowedKnowledgeTypes: string[];
+}>;
 /**
  * 获取完整维度配置（合并 baseDimensions + V3 专属配置 + SOP）
  *
@@ -79,27 +33,8 @@ export declare function getFullDimensionConfig(dimId: string): {
     allowedKnowledgeTypes: string[];
     skillWorthy: boolean;
     dualOutput: boolean;
-    skillMeta: {
-        name: string;
-        description: string;
-    } | {
-        name: string;
-        description: string;
-    } | {
-        name: string;
-        description: string;
-    } | {
-        name: string;
-        description: string;
-    } | undefined;
     knowledgeTypes: string[];
-    sopSteps: {
-        phase: string;
-        action: string;
-        expectedOutput?: string;
-        tools?: string[];
-        qualityChecklist?: string[];
-    }[];
+    sopSteps: import("#domain/dimension/DimensionSop.js").FullSopStep[] | null;
     commonMistakes: string[];
     timeEstimate: string | null;
     focusKeywords: string[];

package/dist/lib/external/mcp/handlers/bootstrap/pipeline/dimension-configs.js

@@ -1,64 +1,33 @@
 /**
  * dimension-configs.js — v3.0 维度配置 + Tier Reflection
  *
+ * **v2: 从统一维度注册表 (DimensionRegistry) 派生**
+ *
  * 从 orchestrator.js 拆分，包含:
- * - DIMENSION_CONFIGS_V3: 仅保留内部 Agent 专属配置 (outputType + allowedKnowledgeTypes)
+ * - DIMENSION_CONFIGS_V3: 维度的 outputType + allowedKnowledgeTypes
+ *   现在从 DimensionRegistry 自动生成，无需手动维护
  * - getFullDimensionConfig(): 合并 baseDimensions + V3 专属配置
  * - buildTierReflection: Tier 级反思聚合 (规则化, 不需要 AI)
  *
- * label / guide → 从 baseDimensions 获取（唯一权威来源）
- * SOP / commonMistakes → 从 dimension-sop.js 获取
- *
  * @module pipeline/dimension-configs
  */
+import { getDimensionFocusKeywords, getDimensionSOP } from '#domain/dimension/DimensionSop.js';
+import { DIMENSION_REGISTRY, getDimension } from '#domain/dimension/index.js';
 import { baseDimensions } from '../base-dimensions.js';
-import { getDimensionFocusKeywords, getDimensionSOP } from '../shared/dimension-sop.js';
 // ──────────────────────────────────────────────────────────────────
-// v3.0 维度配置 — 仅保留内部 Agent 专属字段
-// label / guide / focusAreas 已移至 baseDimensions（唯一权威来源）
+// v3.0 维度配置 — 从统一注册表自动生成
 // ──────────────────────────────────────────────────────────────────
-export const DIMENSION_CONFIGS_V3 = {
-    'project-profile': { outputType: 'dual', allowedKnowledgeTypes: ['architecture'] },
-    'objc-deep-scan': {
-        outputType: 'dual',
-        allowedKnowledgeTypes: ['code-standard', 'code-pattern'],
-    },
-    'category-scan': { outputType: 'dual', allowedKnowledgeTypes: ['code-standard', 'code-pattern'] },
-    'code-standard': { outputType: 'dual', allowedKnowledgeTypes: ['code-standard', 'code-style'] },
-    architecture: {
-        outputType: 'dual',
-        allowedKnowledgeTypes: ['architecture', 'module-dependency', 'boundary-constraint'],
-    },
-    'code-pattern': {
-        outputType: 'candidate',
-        allowedKnowledgeTypes: ['code-pattern', 'code-relation', 'inheritance'],
-    },
-    'event-and-data-flow': {
+/**
+ * 从统一注册表生成 V3 配置映射
+ * 所有维度统一为 candidate-only outputType
+ */
+export const DIMENSION_CONFIGS_V3 = Object.fromEntries(DIMENSION_REGISTRY.map((dim) => [
+    dim.id,
+    {
         outputType: 'candidate',
-        allowedKnowledgeTypes: ['call-chain', 'data-flow', 'event-and-data-flow'],
-    },
-    'best-practice': { outputType: 'candidate', allowedKnowledgeTypes: ['best-practice'] },
-    'agent-guidelines': {
-        outputType: 'skill',
-        allowedKnowledgeTypes: ['boundary-constraint', 'code-standard'],
-    },
-    'module-export-scan': {
-        outputType: 'dual',
-        allowedKnowledgeTypes: ['code-standard', 'architecture'],
-    },
-    'framework-convention-scan': {
-        outputType: 'dual',
-        allowedKnowledgeTypes: ['code-standard', 'architecture'],
+        allowedKnowledgeTypes: [...dim.allowedKnowledgeTypes],
     },
-    'python-package-scan': {
-        outputType: 'dual',
-        allowedKnowledgeTypes: ['code-standard', 'architecture'],
-    },
-    'jvm-annotation-scan': {
-        outputType: 'dual',
-        allowedKnowledgeTypes: ['code-pattern', 'architecture'],
-    },
-};
+]));
 // ──────────────────────────────────────────────────────────────────
 // 完整维度配置获取（合并 baseDimensions + V3 专属 + SOP）
 // ──────────────────────────────────────────────────────────────────
@@ -69,7 +38,17 @@ export const DIMENSION_CONFIGS_V3 = {
  * @returns 完整维度配置，或 null（未知维度）
  */
 export function getFullDimensionConfig(dimId) {
-    const base = baseDimensions.find((d) => d.id === dimId);
+    // 优先从统一注册表获取
+    const unified = getDimension(dimId);
+    // 回退到旧 baseDimensions（兼容 Enhancement Pack 动态维度）
+    const base = unified
+        ? {
+            id: unified.id,
+            label: unified.label,
+            guide: unified.extractionGuide,
+            knowledgeTypes: [...unified.allowedKnowledgeTypes],
+        }
+        : baseDimensions.find((d) => d.id === dimId);
     const v3 = DIMENSION_CONFIGS_V3[dimId];
     if (!base) {
         return null;
@@ -79,11 +58,10 @@ export function getFullDimensionConfig(dimId) {
         id: dimId,
         label: base.label,
         guide: base.guide,
-        outputType: v3?.outputType || (base.dualOutput ? 'dual' : base.skillWorthy ? 'skill' : 'candidate'),
+        outputType: v3?.outputType || 'candidate',
         allowedKnowledgeTypes: v3?.allowedKnowledgeTypes || base.knowledgeTypes || [],
-        skillWorthy: base.skillWorthy || false,
-        dualOutput: base.dualOutput || false,
-        skillMeta: base.skillMeta,
+        skillWorthy: false,
+        dualOutput: false,
         knowledgeTypes: base.knowledgeTypes || [],
         // SOP 结构化分析步骤
         sopSteps: sop?.steps || null,

package/dist/lib/external/mcp/handlers/bootstrap/pipeline/dimension-context.d.ts

@@ -24,7 +24,6 @@ interface ProjectContext {
     depGraph?: Record<string, unknown>;
     astMetrics?: Record<string, unknown>;
     guardSummary?: Record<string, unknown>;
-    [key: string]: unknown;
 }
 /** Summary of a completed dimension's analysis */
 interface DimensionDigest {

package/dist/lib/external/mcp/handlers/bootstrap/pipeline/mock-pipeline.d.ts

@@ -0,0 +1,20 @@
+/**
+ * mock-pipeline.ts — Mock AI Bootstrap 轻量管线
+ *
+ * 当 AI Provider 为 mock 时，利用 Phase 1-4 已收集的真实数据
+ * (AST、依赖图、文件列表、Panorama) 为每个维度生成模板化候选知识。
+ *
+ * 不调用 AI，但走完完整的 submit → dimension_complete 流程，
+ * 使 Dashboard 能正常展示知识库、健康雷达等 UI。
+ *
+ * @module pipeline/mock-pipeline
+ */
+import type { DimensionDef } from '#types/project-snapshot.js';
+import type { PipelineFillView } from '#types/snapshot-views.js';
+/**
+ * fillDimensionsMock — Mock AI 轻量管线
+ *
+ * 利用 Phase 1-4 的真实数据（AST、文件列表、Panorama）自动生成候选知识，
+ * 不调用任何 AI API，但走完 submit → dimension_complete 的完整流程。
+ */
+export declare function fillDimensionsMock(view: PipelineFillView, dimensions: DimensionDef[]): Promise<void>;