autosnippet 3.3.5 → 3.3.7

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;

package/dist/lib/domain/dimension/DimensionRegistry.js

@@ -0,0 +1,620 @@
+/**
+ * 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
+ */
+// ═══════════════════════════════════════════════════════════
+// Layer 1: Universal Dimensions (13)
+// ═══════════════════════════════════════════════════════════
+const D1_ARCHITECTURE = {
+    id: 'architecture',
+    label: '架构与设计',
+    layer: 'universal',
+    icon: 'Workflow',
+    colorFamily: 'sky',
+    extractionGuide: '分层架构、模块职责与边界、依赖方向约束、入口点、目标枚举、启动流程、路由表',
+    allowedKnowledgeTypes: ['architecture', 'module-dependency', 'boundary-constraint'],
+    outputMode: 'candidate-only',
+    qualityDescription: '模块边界清晰度、依赖方向合规性、层次分离完整性',
+    matchTopics: ['architecture', 'scaffold', 'module-boundary', 'dependency-rule', 'layer-strategy'],
+    matchCategories: ['architecture', 'project-profile'],
+    weight: 1.0,
+    suggestedTopics: ['module-boundary', 'dependency-rule', 'layer-strategy'],
+    relatedRoles: ['core', 'foundation', 'app'],
+    tierHint: 1,
+    displayGroup: 'architecture',
+};
+const D2_CODING_STANDARDS = {
+    id: 'coding-standards',
+    label: '代码规范',
+    layer: 'universal',
+    icon: 'BookOpen',
+    colorFamily: 'violet',
+    extractionGuide: '命名约定（类名/方法/变量/常量）、注释风格、文件组织、import 排序、访问控制约定、MARK 分段',
+    allowedKnowledgeTypes: ['code-standard', 'code-style'],
+    outputMode: 'candidate-only',
+    qualityDescription: '命名一致性、文档注释覆盖率、文件组织标准化程度',
+    matchTopics: ['conventions', 'naming-convention', 'code-style', 'documentation'],
+    matchCategories: ['code-standard', 'code-style'],
+    weight: 0.8,
+    suggestedTopics: ['naming-convention', 'code-style', 'documentation'],
+    relatedRoles: [],
+    tierHint: 2,
+    displayGroup: 'best-practice',
+};
+const D3_DESIGN_PATTERNS = {
+    id: 'design-patterns',
+    label: '设计模式',
+    layer: 'universal',
+    icon: 'GitBranch',
+    colorFamily: 'fuchsia',
+    extractionGuide: '单例/委托/工厂/Builder/观察者/Coordinator/Repository/DI 容器等模式、继承层级、基类设计',
+    allowedKnowledgeTypes: ['code-pattern', 'code-relation', 'inheritance'],
+    outputMode: 'candidate-only',
+    qualityDescription: '模式使用一致性、反模式检测、基类复用程度',
+    matchTopics: ['design-pattern', 'code-pattern', 'inheritance', 'base-class'],
+    matchCategories: ['code-pattern', 'code-relation'],
+    weight: 0.8,
+    suggestedTopics: ['design-pattern', 'code-pattern', 'inheritance'],
+    relatedRoles: [],
+    tierHint: 2,
+    displayGroup: 'architecture',
+};
+const D4_ERROR_RESILIENCE = {
+    id: 'error-resilience',
+    label: '错误与健壮性',
+    layer: 'universal',
+    icon: 'Shield',
+    colorFamily: 'emerald',
+    extractionGuide: '异常/错误类型定义、错误传播策略、用户可见错误展示、重试/回退/熔断模式、防御性编程、输入验证',
+    allowedKnowledgeTypes: ['best-practice'],
+    outputMode: 'candidate-only',
+    qualityDescription: '错误类型覆盖率、错误恢复完整性、用户错误体验',
+    matchTopics: ['error-handling', 'constraints', 'validation', 'error-recovery'],
+    matchCategories: ['best-practice'],
+    weight: 1.0,
+    suggestedTopics: ['exception-pattern', 'error-recovery', 'input-validation'],
+    relatedRoles: ['service', 'networking', 'core'],
+    tierHint: 3,
+    displayGroup: 'best-practice',
+};
+const D5_CONCURRENCY_ASYNC = {
+    id: 'concurrency-async',
+    label: '并发与异步',
+    layer: 'universal',
+    icon: 'Repeat',
+    colorFamily: 'orange',
+    extractionGuide: '线程安全模式（锁/Actor/隔离）、异步编程模型（async-await/RxSwift/Combine/Promise）、竞态条件防护、内存安全（弱引用/捕获列表）',
+    allowedKnowledgeTypes: ['best-practice'],
+    outputMode: 'candidate-only',
+    qualityDescription: '线程安全覆盖率、异步模式一致性、数据竞争风险',
+    matchTopics: ['concurrency', 'async', 'thread-safety', 'race-condition', 'memory-safety'],
+    matchCategories: [],
+    weight: 0.9,
+    suggestedTopics: ['thread-safety', 'async-pattern', 'race-condition'],
+    relatedRoles: ['service', 'networking', 'storage'],
+    tierHint: 3,
+    displayGroup: 'data-event-flow',
+};
+const D6_DATA_EVENT_FLOW = {
+    id: 'data-event-flow',
+    label: '事件与数据流',
+    layer: 'universal',
+    icon: 'Cog',
+    colorFamily: 'amber',
+    extractionGuide: '持久化模式（CoreData/UserDefaults/SQLite/Keychain）、缓存策略、序列化约定、事件传播（Delegate/Notification/Closure/RxSwift）、状态管理、数据一致性',
+    allowedKnowledgeTypes: ['call-chain', 'data-flow', 'event-and-data-flow'],
+    outputMode: 'candidate-only',
+    qualityDescription: '数据流完整性、持久化安全性、事件耦合度',
+    matchTopics: [
+        'data',
+        'data-flow',
+        'memory',
+        'persistence',
+        'caching',
+        'event',
+        'state-management',
+    ],
+    matchCategories: ['event-and-data-flow', 'data-management'],
+    weight: 0.8,
+    suggestedTopics: ['persistence', 'caching', 'serialization', 'data-integrity'],
+    relatedRoles: ['storage', 'model'],
+    tierHint: 3,
+    displayGroup: 'data-event-flow',
+};
+const D7_NETWORKING_API = {
+    id: 'networking-api',
+    label: '网络与 API',
+    layer: 'universal',
+    icon: 'Wifi',
+    colorFamily: 'blue',
+    extractionGuide: 'API 请求封装模式、响应模型定义、错误码映射、重试/超时策略、实时通信（WebSocket/SSE）、认证流程、CDN 策略',
+    allowedKnowledgeTypes: ['best-practice', 'code-pattern'],
+    outputMode: 'candidate-only',
+    qualityDescription: 'API 抽象一致性、网络错误处理完整性、安全传输',
+    matchTopics: ['networking', 'real-time', 'api-contract', 'retry-strategy', 'request-pattern'],
+    matchCategories: ['Network'],
+    weight: 0.7,
+    suggestedTopics: ['api-contract', 'retry-strategy', 'request-pattern'],
+    relatedRoles: ['networking'],
+    tierHint: 3,
+    displayGroup: 'data-event-flow',
+};
+const D8_UI_INTERACTION = {
+    id: 'ui-interaction',
+    label: '界面与交互',
+    layer: 'universal',
+    icon: 'Layout',
+    colorFamily: 'pink',
+    extractionGuide: 'UI 组件基类、布局约束模式、生命周期管理、导航/路由、数据绑定（MVVM/MVI/Redux）、列表分页、动画转场',
+    allowedKnowledgeTypes: ['code-pattern', 'best-practice'],
+    outputMode: 'candidate-only',
+    qualityDescription: 'VC/View 一致性、组件复用率、导航健壮性',
+    matchTopics: ['ui', 'binding', 'pagination', 'navigation', 'component-pattern', 'lifecycle'],
+    matchCategories: ['View', 'UI'],
+    weight: 0.7,
+    suggestedTopics: ['component-pattern', 'lifecycle', 'navigation'],
+    relatedRoles: ['ui', 'feature'],
+    tierHint: 3,
+    displayGroup: 'architecture',
+};
+const D9_TESTING_QUALITY = {
+    id: 'testing-quality',
+    label: '测试与质量',
+    layer: 'universal',
+    icon: 'FlaskConical',
+    colorFamily: 'lime',
+    extractionGuide: '单元测试模式、Mock/Stub 策略、集成测试约定、CI/CD 流程、代码覆盖率策略、Snapshot 测试',
+    allowedKnowledgeTypes: ['best-practice'],
+    outputMode: 'candidate-only',
+    qualityDescription: '测试覆盖率、Mock 一致性、CI 可靠性',
+    matchTopics: ['testing', 'test', 'ci-cd', 'mock-strategy', 'unit-test', 'snapshot-test'],
+    matchCategories: [],
+    weight: 0.9,
+    suggestedTopics: ['unit-test', 'mock-strategy', 'ci-cd'],
+    relatedRoles: [],
+    tierHint: 3,
+    displayGroup: 'best-practice',
+};
+const D10_SECURITY_AUTH = {
+    id: 'security-auth',
+    label: '安全与认证',
+    layer: 'universal',
+    icon: 'Lock',
+    colorFamily: 'red',
+    extractionGuide: '认证授权流程、Token 管理、加密存储（Keychain/SecureStorage）、证书锁定、输入清理、权限控制、隐私合规',
+    allowedKnowledgeTypes: ['best-practice'],
+    outputMode: 'candidate-only',
+    qualityDescription: '安全实践覆盖率、认证流程完整性、数据保护',
+    matchTopics: ['security', 'auth', 'authentication', 'authorization', 'encryption', 'privacy'],
+    matchCategories: [],
+    weight: 1.0,
+    suggestedTopics: ['authentication', 'authorization', 'encryption'],
+    relatedRoles: ['networking', 'service'],
+    tierHint: 3,
+    displayGroup: 'best-practice',
+};
+const D11_PERFORMANCE_OPTIMIZATION = {
+    id: 'performance-optimization',
+    label: '性能优化',
+    layer: 'universal',
+    icon: 'Gauge',
+    colorFamily: 'yellow',
+    extractionGuide: '内存管理（ARC/GC/引用循环）、懒加载策略、缓存层级、渲染优化（离屏渲染/预计算）、启动耗时优化、包体积控制',
+    allowedKnowledgeTypes: ['best-practice'],
+    outputMode: 'candidate-only',
+    qualityDescription: '内存泄漏风险、启动关键路径、资源利用效率',
+    matchTopics: ['performance', 'optimization', 'memory-management', 'lazy-loading', 'rendering'],
+    matchCategories: [],
+    weight: 0.8,
+    suggestedTopics: ['memory-management', 'lazy-loading', 'rendering'],
+    relatedRoles: ['ui', 'storage'],
+    tierHint: 3,
+    displayGroup: 'data-event-flow',
+};
+const D12_OBSERVABILITY_LOGGING = {
+    id: 'observability-logging',
+    label: '可观测性',
+    layer: 'universal',
+    icon: 'Activity',
+    colorFamily: 'slate',
+    extractionGuide: '日志框架与分级（OSLog/Logger/Winston/Pino）、事件追踪/埋点、监控指标、诊断工具链、错误上报',
+    allowedKnowledgeTypes: ['best-practice'],
+    outputMode: 'candidate-only',
+    qualityDescription: '日志规范覆盖率、可追踪性、监控完整性',
+    matchTopics: ['logging', 'monitoring', 'event-tracking', 'diagnostics', 'tracing'],
+    matchCategories: [],
+    weight: 0.7,
+    suggestedTopics: ['logging-standard', 'event-tracking', 'diagnostics'],
+    relatedRoles: ['service', 'core'],
+    tierHint: 3,
+    displayGroup: 'data-event-flow',
+};
+const D13_AGENT_GUIDELINES = {
+    id: 'agent-guidelines',
+    label: '开发约束',
+    layer: 'universal',
+    icon: 'Brain',
+    colorFamily: 'rose',
+    extractionGuide: "项目强制规则（DO/DON'T）、已废弃 API 标记、架构约束声明、环境特殊约定",
+    allowedKnowledgeTypes: ['boundary-constraint', 'code-standard'],
+    outputMode: 'candidate-only',
+    qualityDescription: '约束覆盖完整性、规则可执行性',
+    matchTopics: ['constraints', 'deprecated-api', 'agent-rules'],
+    matchCategories: ['agent-guidelines'],
+    weight: 0.6,
+    suggestedTopics: ['constraints', 'deprecated-api', 'agent-rules'],
+    relatedRoles: [],
+    tierHint: 3,
+    displayGroup: 'best-practice',
+};
+// ═══════════════════════════════════════════════════════════
+// Layer 2: Language Dimensions (7)
+// ═══════════════════════════════════════════════════════════
+const DL1_SWIFT_OBJC_IDIOM = {
+    id: 'swift-objc-idiom',
+    label: '深度扫描',
+    layer: 'language',
+    icon: 'ScanSearch',
+    colorFamily: 'indigo',
+    extractionGuide: '常量定义模式（enum namespace vs global）、Sendable 合规、Method Swizzling 清单、Protocol 命名约定、属性包装器使用、#define 宏/extern 常量、Category/Extension 针对基础类的方法清单',
+    allowedKnowledgeTypes: ['code-standard', 'code-pattern'],
+    outputMode: 'candidate-only',
+    qualityDescription: 'Swift 6.0 并发安全合规度、ObjC 互操作清洁度、常量管理规范性',
+    matchTopics: ['swift-idiom', 'objc-idiom', 'sendable', 'method-swizzle', 'macro', 'constant'],
+    matchCategories: ['objc-deep-scan', 'category-scan'],
+    weight: 0.8,
+    suggestedTopics: ['sendable', 'method-swizzle', 'objc-interop'],
+    relatedRoles: [],
+    conditions: { languages: ['swift', 'objectivec'] },
+    tierHint: 1,
+    displayGroup: 'deep-scan',
+};
+const DL2_TS_JS_MODULE = {
+    id: 'ts-js-module',
+    label: '模块导出',
+    layer: 'language',
+    icon: 'Package',
+    colorFamily: 'violet',
+    extractionGuide: 'barrel export 结构、re-export 链路、public API surface、tree-shaking 合规性、path alias、类型导出策略',
+    allowedKnowledgeTypes: ['code-standard', 'architecture'],
+    outputMode: 'candidate-only',
+    qualityDescription: '模块封装一致性、exported API 清晰度',
+    matchTopics: ['module-export', 'barrel-export', 'public-api', 'tree-shaking'],
+    matchCategories: ['module-export-scan'],
+    weight: 0.7,
+    suggestedTopics: ['module-export', 'barrel-export', 'public-api'],
+    relatedRoles: [],
+    conditions: { languages: ['typescript', 'javascript'] },
+    tierHint: 1,
+    displayGroup: 'deep-scan',
+};
+const DL3_PYTHON_STRUCTURE = {
+    id: 'python-structure',
+    label: 'Python 包结构',
+    layer: 'language',
+    icon: 'FileCode',
+    colorFamily: 'green',
+    extractionGuide: '__init__.py 导出策略、相对/绝对导入风格、type hints 覆盖率、decorator 使用模式、__all__ 定义、虚拟环境约定',
+    allowedKnowledgeTypes: ['code-standard', 'architecture'],
+    outputMode: 'candidate-only',
+    qualityDescription: '包结构规范性、导入一致性、类型保障',
+    matchTopics: ['python-package', 'import-style', 'type-hints', 'decorator-pattern'],
+    matchCategories: ['python-package-scan'],
+    weight: 0.7,
+    suggestedTopics: ['python-package', 'import-style', 'type-hints'],
+    relatedRoles: [],
+    conditions: { languages: ['python'] },
+    tierHint: 1,
+    displayGroup: 'deep-scan',
+};
+const DL4_JVM_ANNOTATION = {
+    id: 'jvm-annotation',
+    label: '注解体系',
+    layer: 'language',
+    icon: 'AtSign',
+    colorFamily: 'purple',
+    extractionGuide: 'DI 注解（@Inject/@Autowired/@Component）、ORM 注解（@Entity/@Table）、API 注解（@RestController）、自定义注解、元编程模式',
+    allowedKnowledgeTypes: ['code-pattern', 'architecture'],
+    outputMode: 'candidate-only',
+    qualityDescription: '注解约定一致性、DI 配置完整性',
+    matchTopics: ['annotation', 'di-annotation', 'orm-annotation', 'api-annotation'],
+    matchCategories: ['jvm-annotation-scan'],
+    weight: 0.7,
+    suggestedTopics: ['annotation', 'di-annotation', 'orm-annotation'],
+    relatedRoles: [],
+    conditions: { languages: ['java', 'kotlin'] },
+    tierHint: 1,
+    displayGroup: 'deep-scan',
+};
+const DL5_GO_MODULE = {
+    id: 'go-module',
+    label: 'Go 模块',
+    layer: 'language',
+    icon: 'Boxes',
+    colorFamily: 'cyan',
+    extractionGuide: 'go.mod 依赖图、internal 包隔离、cmd/ 入口、build tags、interface 分布与实现、init() 函数清单',
+    allowedKnowledgeTypes: ['architecture', 'code-pattern'],
+    outputMode: 'candidate-only',
+    qualityDescription: '模块隔离完整性、接口设计合理性',
+    matchTopics: ['go-module', 'internal-package', 'interface-impl', 'build-tags'],
+    matchCategories: ['go-module-scan'],
+    weight: 0.7,
+    suggestedTopics: ['go-module', 'internal-package', 'interface-impl'],
+    relatedRoles: [],
+    conditions: { languages: ['go'] },
+    tierHint: 1,
+    displayGroup: 'deep-scan',
+};
+const DL6_RUST_OWNERSHIP = {
+    id: 'rust-ownership',
+    label: 'Rust 所有权',
+    layer: 'language',
+    icon: 'Link2',
+    colorFamily: 'stone',
+    extractionGuide: '所有权转移模式、生命周期标注约定、trait 实现层次、derive 宏使用、unsafe 块审计、Error 类型层级',
+    allowedKnowledgeTypes: ['code-pattern', 'best-practice'],
+    outputMode: 'candidate-only',
+    qualityDescription: '所有权安全性、trait 设计合理性',
+    matchTopics: ['ownership', 'lifetime', 'trait-impl', 'unsafe-audit'],
+    matchCategories: [],
+    weight: 0.7,
+    suggestedTopics: ['ownership', 'lifetime', 'trait-impl'],
+    relatedRoles: [],
+    conditions: { languages: ['rust'] },
+    tierHint: 1,
+    displayGroup: 'deep-scan',
+};
+const DL7_CSHARP_DOTNET = {
+    id: 'csharp-dotnet',
+    label: '.NET 模式',
+    layer: 'language',
+    icon: 'Component',
+    colorFamily: 'teal',
+    extractionGuide: 'DI 容器注册模式、LINQ 查询约定、async/await 模式、EF Core 映射、Middleware pipeline、特性标注（[Attribute]）',
+    allowedKnowledgeTypes: ['code-pattern', 'architecture'],
+    outputMode: 'candidate-only',
+    qualityDescription: 'DI 注册完整性、EF Core 映射正确性',
+    matchTopics: ['di-container', 'linq-pattern', 'ef-core', 'middleware', 'attribute'],
+    matchCategories: [],
+    weight: 0.7,
+    suggestedTopics: ['di-container', 'linq-pattern', 'ef-core'],
+    relatedRoles: [],
+    conditions: { languages: ['csharp'] },
+    tierHint: 1,
+    displayGroup: 'deep-scan',
+};
+// ═══════════════════════════════════════════════════════════
+// Layer 3: Framework Dimensions (5)
+// ═══════════════════════════════════════════════════════════
+const DF1_REACT_PATTERNS = {
+    id: 'react-patterns',
+    label: 'React 模式',
+    layer: 'framework',
+    icon: 'Atom',
+    colorFamily: 'sky',
+    extractionGuide: '组件目录结构、状态管理约定（Redux/Zustand/Jotai）、Router 约定、数据获取模式（SWR/TanStack Query/Server Components）、样式方案',
+    allowedKnowledgeTypes: ['code-standard', 'architecture'],
+    outputMode: 'candidate-only',
+    qualityDescription: '组件结构一致性、状态管理规范性',
+    matchTopics: ['react-component', 'state-management', 'data-fetching', 'ssr-pattern'],
+    matchCategories: ['framework-convention-scan'],
+    weight: 0.7,
+    suggestedTopics: ['react-component', 'state-management', 'data-fetching'],
+    relatedRoles: ['ui', 'feature'],
+    conditions: { languages: ['typescript', 'javascript'], frameworks: ['react', 'nextjs'] },
+    tierHint: 1,
+    displayGroup: 'deep-scan',
+};
+const DF2_VUE_PATTERNS = {
+    id: 'vue-patterns',
+    label: 'Vue 模式',
+    layer: 'framework',
+    icon: 'Wind',
+    colorFamily: 'emerald',
+    extractionGuide: 'Composition API vs Options API、Pinia 状态管理、路由守卫、Nuxt 目录约定（pages/layouts/middleware）',
+    allowedKnowledgeTypes: ['code-standard', 'architecture'],
+    outputMode: 'candidate-only',
+    qualityDescription: 'Composition API 一致性、Pinia 约定规范性',
+    matchTopics: ['vue-composition', 'pinia', 'nuxt-convention'],
+    matchCategories: [],
+    weight: 0.7,
+    suggestedTopics: ['vue-composition', 'pinia', 'nuxt-convention'],
+    relatedRoles: ['ui', 'feature'],
+    conditions: { languages: ['typescript', 'javascript'], frameworks: ['vue', 'nuxt'] },
+    tierHint: 1,
+    displayGroup: 'deep-scan',
+};
+const DF3_SPRING_PATTERNS = {
+    id: 'spring-patterns',
+    label: 'Spring 模式',
+    layer: 'framework',
+    icon: 'Leaf',
+    colorFamily: 'green',
+    extractionGuide: 'Bean 生命周期管理、配置属性绑定、AOP 切面约定、异常处理器、Repository/Service 分层、Actuator 端点',
+    allowedKnowledgeTypes: ['code-pattern', 'architecture'],
+    outputMode: 'candidate-only',
+    qualityDescription: 'Bean 管理完整性、AOP 一致性',
+    matchTopics: ['spring-bean', 'aop-aspect', 'config-properties', 'actuator'],
+    matchCategories: [],
+    weight: 0.7,
+    suggestedTopics: ['spring-bean', 'aop-aspect', 'config-properties'],
+    relatedRoles: ['service', 'core'],
+    conditions: { languages: ['java', 'kotlin'], frameworks: ['spring', 'spring-boot'] },
+    tierHint: 1,
+    displayGroup: 'deep-scan',
+};
+const DF4_SWIFTUI_PATTERNS = {
+    id: 'swiftui-patterns',
+    label: 'SwiftUI 模式',
+    layer: 'framework',
+    icon: 'PaintBucket',
+    colorFamily: 'blue',
+    extractionGuide: 'View 组合模式、@State/@Binding/@ObservableObject 管理、Navigation 策略、PreferenceKey 使用、环境值注入',
+    allowedKnowledgeTypes: ['code-pattern', 'best-practice'],
+    outputMode: 'candidate-only',
+    qualityDescription: 'View 组合健壮性、状态管理分层合理性',
+    matchTopics: ['swiftui-view', 'state-management', 'navigation', 'environment'],
+    matchCategories: [],
+    weight: 0.7,
+    suggestedTopics: ['swiftui-view', 'state-management', 'navigation'],
+    relatedRoles: ['ui', 'feature'],
+    conditions: { languages: ['swift'], frameworks: ['swiftui'] },
+    tierHint: 1,
+    displayGroup: 'deep-scan',
+};
+const DF5_DJANGO_FASTAPI = {
+    id: 'django-fastapi',
+    label: 'Django/FastAPI',
+    layer: 'framework',
+    icon: 'Server',
+    colorFamily: 'amber',
+    extractionGuide: 'URL routing 约定、Model/Serializer 分层、Middleware 管线、Dependency Injection（FastAPI）、Admin 定制',
+    allowedKnowledgeTypes: ['code-standard', 'architecture'],
+    outputMode: 'candidate-only',
+    qualityDescription: '路由组织清晰度、ORM 使用规范性',
+    matchTopics: ['url-routing', 'model-serializer', 'middleware', 'dependency-injection'],
+    matchCategories: [],
+    weight: 0.7,
+    suggestedTopics: ['url-routing', 'model-serializer', 'middleware'],
+    relatedRoles: ['service', 'core'],
+    conditions: { languages: ['python'], frameworks: ['django', 'fastapi', 'flask'] },
+    tierHint: 1,
+    displayGroup: 'deep-scan',
+};
+// ═══════════════════════════════════════════════════════════
+// 维度注册表（唯一来源）
+// ═══════════════════════════════════════════════════════════
+export const DIMENSION_REGISTRY = [
+    // Layer 1: Universal (13)
+    D1_ARCHITECTURE,
+    D2_CODING_STANDARDS,
+    D3_DESIGN_PATTERNS,
+    D4_ERROR_RESILIENCE,
+    D5_CONCURRENCY_ASYNC,
+    D6_DATA_EVENT_FLOW,
+    D7_NETWORKING_API,
+    D8_UI_INTERACTION,
+    D9_TESTING_QUALITY,
+    D10_SECURITY_AUTH,
+    D11_PERFORMANCE_OPTIMIZATION,
+    D12_OBSERVABILITY_LOGGING,
+    D13_AGENT_GUIDELINES,
+    // Layer 2: Language (7)
+    DL1_SWIFT_OBJC_IDIOM,
+    DL2_TS_JS_MODULE,
+    DL3_PYTHON_STRUCTURE,
+    DL4_JVM_ANNOTATION,
+    DL5_GO_MODULE,
+    DL6_RUST_OWNERSHIP,
+    DL7_CSHARP_DOTNET,
+    // Layer 3: Framework (5)
+    DF1_REACT_PATTERNS,
+    DF2_VUE_PATTERNS,
+    DF3_SPRING_PATTERNS,
+    DF4_SWIFTUI_PATTERNS,
+    DF5_DJANGO_FASTAPI,
+];
+// ═══════════════════════════════════════════════════════════
+// 查询辅助函数
+// ═══════════════════════════════════════════════════════════
+// ═══════════════════════════════════════════════════════════
+// 维度展示分组映射 — 从注册表自动派生
+// ═══════════════════════════════════════════════════════════
+/**
+ * 维度 ID → 展示分组 ID 映射
+ *
+ *  展示分组:
+ *   - 'architecture'     — 架构与设计
+ *   - 'best-practice'    — 规范与实践
+ *   - 'data-event-flow'  — 数据与并发
+ *   - 'deep-scan'        — 深度扫描（语言/框架条件维度）
+ */
+export const DIMENSION_DISPLAY_GROUP = Object.fromEntries(DIMENSION_REGISTRY.map((d) => [d.id, d.displayGroup]));
+/** 按 ID 获取维度 */
+export function getDimension(id) {
+    return DIMENSION_REGISTRY.find((d) => d.id === id);
+}
+/** 获取指定层级的所有维度 */
+export function getDimensionsByLayer(layer) {
+    return DIMENSION_REGISTRY.filter((d) => d.layer === layer);
+}
+/**
+ * 根据项目语言和框架过滤出活跃维度
+ *
+ * - Layer 1 (universal): 全部返回
+ * - Layer 2 (language): 仅当项目语言匹配时返回
+ * - Layer 3 (framework): 仅当项目语言+框架均匹配时返回
+ */
+export function resolveActiveDimensions(primaryLang, detectedFrameworks = []) {
+    return DIMENSION_REGISTRY.filter((dim) => {
+        if (!dim.conditions) {
+            return true; // Layer 1: 无条件 → 通用维度
+        }
+        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 条件存在时也需匹配
+        return langMatch && (dim.conditions.frameworks ? fwMatch : true);
+    });
+}
+/**
+ * 构建 Tier 分层调度计划
+ *
+ * 基于每个维度的 tierHint 字段将活跃维度分为 3 层:
+ * - Tier 1 (tierHint=1): 基础数据层 — architecture + 语言/框架条件维度
+ * - Tier 2 (tierHint=2): 规范+设计层 — coding-standards, design-patterns
+ * - Tier 3 (tierHint=3): 实践+质量层 — 其余所有维度
+ */
+export function buildTierPlan(activeDims = DIMENSION_REGISTRY) {
+    const tier1 = [];
+    const tier2 = [];
+    const tier3 = [];
+    for (const dim of activeDims) {
+        const hint = dim.tierHint ?? 3;
+        if (hint === 1) {
+            tier1.push(dim.id);
+        }
+        else if (hint === 2) {
+            tier2.push(dim.id);
+        }
+        else {
+            tier3.push(dim.id);
+        }
+    }
+    return [tier1, tier2, tier3].filter((t) => t.length > 0);
+}
+/**
+ * 将 Recipe 分类到最匹配的维度
+ *
+ * 优先级: topicHint 精确匹配 → category 匹配 → null
+ */
+export function classifyRecipeToDimension(topicHint, category) {
+    // 1. topicHint 精确匹配
+    if (topicHint) {
+        for (const dim of DIMENSION_REGISTRY) {
+            if (dim.matchTopics.includes(topicHint)) {
+                return dim.id;
+            }
+        }
+    }
+    // 2. category 匹配
+    if (category) {
+        for (const dim of DIMENSION_REGISTRY) {
+            if (dim.matchCategories.includes(category)) {
+                return dim.id;
+            }
+        }
+    }
+    return null;
+}