autosnippet 3.2.10 → 3.2.12

package/lib/shared/BootstrapEventEmitter.js

@@ -1,123 +0,0 @@
-/**
- * BootstrapEventEmitter.js — 统一的 Bootstrap 进度事件推送
- *
- * 两端（内部 Agent / 外部 Agent）使用相同的事件名和数据格式，
- * 同时兼容 EventBus 和 BootstrapTaskManager。
- *
- * @module shared/BootstrapEventEmitter
- */
-
-export class BootstrapEventEmitter {
-  /** @type {object|null} EventBus 实例 */
-  #eventBus;
-
-  /** @type {object|null} BootstrapTaskManager 实例 */
-  #taskManager;
-
-  /**
-   * @param {object} container — DI Container
-   */
-  constructor(container) {
-    this.#eventBus = null;
-    this.#taskManager = null;
-
-    try {
-      this.#eventBus = container.get?.('eventBus') ?? null;
-    } catch { /* eventBus not registered */ }
-
-    try {
-      this.#taskManager = container.get?.('bootstrapTaskManager') ?? null;
-    } catch { /* taskManager not registered */ }
-  }
-
-  /**
-   * 推送维度完成事件
-   *
-   * @param {string} dimId — 维度 ID
-   * @param {object} data — 事件数据
-   * @param {string} [data.type] — 'skill' | 'candidate' | 'dual'
-   * @param {number} [data.extracted] — 提取的候选数量
-   * @param {string} [data.source] — 'internal-agent' | 'external-agent'
-   * @param {boolean} [data.skillCreated] — 是否生成了 Skill
-   * @param {number} [data.recipesBound] — 关联的 recipe 数量
-   */
-  emitDimensionComplete(dimId, data = {}) {
-    // TaskManager 标记
-    try {
-      this.#taskManager?.markTaskCompleted?.(dimId, data);
-    } catch { /* non-blocking */ }
-
-    // EventBus 推送
-    try {
-      this.#eventBus?.emit?.('bootstrap:task-completed', {
-        dimensionId: dimId,
-        ...data,
-      });
-    } catch { /* non-blocking */ }
-  }
-
-  /**
-   * 推送全部维度完成事件
-   *
-   * @param {string} sessionId — 会话 ID
-   * @param {number} totalDimensions — 总维度数
-   * @param {string} [source] — 来源标识
-   */
-  emitAllComplete(sessionId, totalDimensions, source = 'unknown') {
-    try {
-      this.#eventBus?.emit?.('bootstrap:all-completed', {
-        sessionId,
-        totalDimensions,
-        source,
-      });
-    } catch { /* non-blocking */ }
-  }
-
-  /**
-   * 推送维度开始填充事件
-   *
-   * @param {string} dimId — 维度 ID
-   */
-  emitDimensionStart(dimId) {
-    try {
-      this.#taskManager?.markTaskFilling?.(dimId);
-    } catch { /* non-blocking */ }
-  }
-
-  /**
-   * 推送维度失败事件
-   *
-   * @param {string} dimId — 维度 ID
-   * @param {Error} error — 错误对象
-   */
-  emitDimensionFailed(dimId, error) {
-    try {
-      this.#taskManager?.markTaskFailed?.(dimId, error);
-    } catch { /* non-blocking */ }
-
-    try {
-      this.#eventBus?.emit?.('bootstrap:task-failed', {
-        dimensionId: dimId,
-        error: error?.message || String(error),
-      });
-    } catch { /* non-blocking */ }
-  }
-
-  /**
-   * 推送进度事件
-   *
-   * @param {string} event — 事件名
-   * @param {object} data — 事件数据
-   */
-  emitProgress(event, data = {}) {
-    try {
-      this.#eventBus?.emit?.(event, data);
-    } catch { /* non-blocking */ }
-
-    try {
-      this.#taskManager?.emitProgress?.(event, data);
-    } catch { /* non-blocking */ }
-  }
-}
-
-export default BootstrapEventEmitter;

package/lib/shared/DimensionCopyRegistry.js

@@ -1,472 +0,0 @@
-/**
- * @module DimensionCopyRegistry
- * @description 维度文案注册表 — 按编程语言提供差异化的 label 和 guide
- *
- * Bootstrap 的 baseDimensions 中每个维度的 label/guide 不再硬编码为 ObjC/Swift 视角，
- * 而是通过此注册表按项目主语言动态选择最匹配的文案。
- *
- * ---
- * 使用方式：
- *   import { DimensionCopy } from '../shared/DimensionCopyRegistry.js';
- *   const copy = DimensionCopy.get('code-pattern', 'python');
- *   // → { label: '设计模式与代码惯例', guide: '装饰器/描述器/上下文管理器/生成器/ABC 抽象基类/Mixin 模式' }
- */
-
-// ═══════════════════════════════════════════════════════════
-// 语言族定义
-// ═══════════════════════════════════════════════════════════
-
-/**
- * 将具体语言归入语言族（用于文案选择 fallback）
- * @param {string} lang
- * @returns {string} 语言族 ID
- */
-function _langFamily(lang) {
-  switch (lang) {
-    case 'swift':
-    case 'objectivec':
-      return 'apple';
-    case 'typescript':
-    case 'javascript':
-      return 'js';
-    case 'java':
-    case 'kotlin':
-      return 'jvm';
-    default:
-      return lang; // python, go, rust, ruby 等本身就是族
-  }
-}
-
-// ═══════════════════════════════════════════════════════════
-// 通用维度文案 — 各语言差异化
-// ═══════════════════════════════════════════════════════════
-
-/**
- * 维度文案格式: { label: string, guide: string }
- * - `_default` 为兜底
- * - 按语言族 key (apple/js/jvm/python/go/rust/ruby) 覆盖
- *
- * 注意：条件维度（objc-deep-scan 等）不需要多语言文案，因为它们本身就是特定语言才激活
- */
-const COPY_REGISTRY = {
-  // ── ① 代码规范 ──────────────────────────────────────
-  'code-standard': {
-    _default: {
-      label: '代码规范',
-      guide: '命名约定、注释风格、文件组织规范、代码格式化标准',
-    },
-    apple: {
-      label: '代码规范',
-      guide:
-        '命名约定（类名前缀/方法签名风格/API 命名）、注释风格（语言/格式/MARK 分段）、文件组织规范',
-    },
-    js: {
-      label: '代码规范',
-      guide:
-        '命名约定（camelCase/PascalCase/UPPER_CASE）、ESLint/Prettier 风格、文件/目录命名、注释与 JSDoc 规范',
-    },
-    jvm: {
-      label: '代码规范',
-      guide:
-        '命名约定（类名/方法名/常量）、包结构组织、Javadoc/KDoc 注释规范、代码格式化（Checkstyle/ktlint）',
-    },
-    python: {
-      label: '代码规范',
-      guide:
-        '命名约定（PEP 8 snake_case/PascalCase）、docstring 风格（Google/NumPy/Sphinx）、import 排序、Black/Ruff 格式化',
-    },
-    go: {
-      label: '代码规范',
-      guide: '命名约定（exported/unexported、MixedCaps）、gofmt 格式化、注释规范（godoc）、包组织',
-    },
-    dart: {
-      label: '代码规范',
-      guide:
-        '命名约定（lowerCamelCase/UpperCamelCase/snake_case 文件名）、dart format 格式化、/// 文档注释、library 组织、effective dart 规范',
-    },
-    rust: {
-      label: '代码规范',
-      guide:
-        '命名约定（snake_case/CamelCase）、rustfmt 格式化、/// 文档注释、模块组织（mod.rs/lib.rs）',
-    },
-  },
-
-  // ── ② 设计模式与代码惯例 ─────────────────────────────
-  'code-pattern': {
-    _default: {
-      label: '设计模式与代码惯例',
-      guide: '单例/工厂/观察者/策略/Builder 等设计模式在项目中的使用方式',
-    },
-    apple: {
-      label: '设计模式与代码惯例',
-      guide: '单例/委托/Category·Extension/工厂/Builder/观察者/Coordinator 模式、继承关系',
-    },
-    js: {
-      label: '设计模式与代码惯例',
-      guide:
-        '模块模式/工厂函数/观察者(EventEmitter)/中间件/高阶函数/组合模式、框架特有 Hooks/Composition 模式',
-    },
-    jvm: {
-      label: '设计模式与代码惯例',
-      guide:
-        'Builder/Factory/Singleton/Strategy/Observer 模式、DI 容器注入模式、Repository/Service 分层惯例',
-    },
-    python: {
-      label: '设计模式与代码惯例',
-      guide:
-        '装饰器/描述器/上下文管理器/生成器/ABC 抽象基类/Mixin 模式、dataclass/Protocol 接口惯例',
-    },
-    go: {
-      label: '设计模式与代码惯例',
-      guide:
-        'functional options/table-driven tests/interface 消费侧定义/errgroup 并发/middleware 链/构造器函数',
-    },
-    dart: {
-      label: '设计模式与代码惯例',
-      guide:
-        'Factory/Singleton/Repository/Builder 模式、Widget 组合模式、Mixin 复用、Extension 扩展、Freezed 不可变数据类、Provider/Riverpod 依赖注入',
-    },
-    rust: {
-      label: '设计模式与代码惯例',
-      guide:
-        'Builder(owned self)/NewType/类型状态/From·Into 转换/Iterator 链/enum 代数类型/derive 宏',
-    },
-  },
-
-  // ── ③ 架构模式 ──────────────────────────────────────
-  architecture: {
-    _default: {
-      label: '架构模式',
-      guide: '分层架构、模块职责与边界、依赖图、导入约束规则',
-    },
-    apple: {
-      label: '架构模式',
-      guide: '分层架构（MVVM/VIPER/TCA）、Package/Target 模块边界、依赖图、import 约束规则',
-    },
-    js: {
-      label: '架构模式',
-      guide:
-        '分层架构（MVC/MVVM/Hexagonal）、monorepo/package 划分、barrel export 边界、循环依赖检测',
-    },
-    jvm: {
-      label: '架构模式',
-      guide:
-        '分层架构（Controller→Service→Repository）、模块划分（multi-module/micro-service）、DI 容器组织、依赖反转',
-    },
-    python: {
-      label: '架构模式',
-      guide:
-        '分层架构（Router→Service→Repository）、包结构（src layout/flat layout）、依赖注入、接口隔离',
-    },
-    go: {
-      label: '架构模式',
-      guide:
-        '分层架构（Handler→Service→Repository）、internal 包隔离、接口在消费侧定义、依赖注入（wire/fx）',
-    },
-    dart: {
-      label: '架构模式',
-      guide:
-        '分层架构（Presentation→Domain→Data）、Clean Architecture/MVVM、Package 模块化、Melos monorepo、barrel export 边界、依赖注入（get_it/injectable）',
-    },
-    rust: {
-      label: '架构模式',
-      guide: '分层架构、Workspace/crate 边界、pub/pub(crate) 可见性、trait object 抽象层',
-    },
-  },
-
-  // ── ④ 最佳实践 ──────────────────────────────────────
-  'best-practice': {
-    _default: {
-      label: '最佳实践',
-      guide: '错误处理、并发安全、资源管理、日志规范、测试模式',
-    },
-    apple: {
-      label: '最佳实践',
-      guide:
-        '错误处理、并发安全（Swift Concurrency/GCD）、内存管理（ARC/weak/unowned）、日志规范、XCTest 模式',
-    },
-    js: {
-      label: '最佳实践',
-      guide:
-        '错误处理（try-catch/Error 边界）、异步安全（Promise/async-await）、内存泄漏检测、日志规范、Jest/Vitest 测试',
-    },
-    jvm: {
-      label: '最佳实践',
-      guide:
-        '错误处理（checked/unchecked exception）、并发安全（synchronized/虚拟线程/协程）、连接池管理、日志（SLF4J）、JUnit 测试',
-    },
-    python: {
-      label: '最佳实践',
-      guide:
-        '错误处理（except Exception/自定义异常）、并发（asyncio/threading/multiprocessing）、资源管理（with 语句）、日志（logging）、pytest 测试',
-    },
-    go: {
-      label: '最佳实践',
-      guide:
-        '错误处理（error interface/wrapped errors）、并发安全（goroutine/channel/mutex）、defer 资源释放、结构化日志（slog）、table-driven tests',
-    },
-    dart: {
-      label: '最佳实践',
-      guide:
-        '错误处理（try-catch/自定义 Exception）、异步安全（async-await/Stream/Completer）、内存管理（dispose/mounted 检查）、日志规范（logger 替代 print）、Widget 测试/集成测试/Golden 测试',
-    },
-    rust: {
-      label: '最佳实践',
-      guide:
-        '错误处理（Result/? 操作符/thiserror）、并发安全（Send+Sync/Arc/Mutex）、生命周期管理、日志（tracing）、#[test] 模式',
-    },
-  },
-
-  // ── ⑤ 事件与数据流 ─────────────────────────────────
-  'event-and-data-flow': {
-    _default: {
-      label: '事件与数据流',
-      guide: '事件传播机制、状态管理模式、数据流向追踪',
-    },
-    apple: {
-      label: '事件与数据流',
-      guide:
-        '事件传播（Delegate/Notification/Block·Closure/Target-Action）、数据状态管理（KVO/属性观察/Combine/SwiftUI State）',
-    },
-    js: {
-      label: '事件与数据流',
-      guide:
-        '事件传播（EventEmitter/DOM Events/Custom Events）、状态管理（Redux/Vuex/Pinia/Zustand/Context）、响应式流（RxJS/Observable）',
-    },
-    jvm: {
-      label: '事件与数据流',
-      guide:
-        '事件传播（Spring Events/LiveData/StateFlow/EventBus）、状态管理（ViewModel/Repository Cache）、消息队列（Kafka/RabbitMQ）',
-    },
-    python: {
-      label: '事件与数据流',
-      guide:
-        '事件传播（Signal/Slot/Callback/asyncio Event）、状态管理（Pydantic Model/dataclass）、消息队列（Celery/Redis Pub-Sub）',
-    },
-    go: {
-      label: '事件与数据流',
-      guide:
-        '事件传播（channel/context）、select 多路复用、fan-out/fan-in 模式、NATS/Redis Pub-Sub',
-    },
-    dart: {
-      label: '事件与数据流',
-      guide:
-        '事件传播（Stream/StreamController/BroadcastStream）、状态管理（BLoC/Cubit/Provider/Riverpod/GetX/ValueNotifier）、响应式流（RxDart/StreamTransformer）、InheritedWidget 数据传递',
-    },
-    rust: {
-      label: '事件与数据流',
-      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-guidelines': {
-    _default: {
-      label: 'Agent 开发注意事项',
-      guide:
-        '三大核心原则（严谨性/深度特征挖掘/完整性）、命名强制、并发安全、资源管理、已废弃 API 标记、架构约束注释、TODO/FIXME',
-    },
-    apple: {
-      label: 'Agent 开发注意事项',
-      guide:
-        '三大核心原则（严谨性/深度特征挖掘/完整性）、命名强制、线程安全、内存约束、已废弃 API 标记、架构约束注释、TODO/FIXME',
-    },
-    js: {
-      label: 'Agent 开发注意事项',
-      guide:
-        '三大核心原则（严谨性/深度特征挖掘/完整性）、命名约定遵循、类型安全（strict/no-any）、异步错误处理、已废弃 API 标记、ESLint 配置遵循',
-    },
-    jvm: {
-      label: 'Agent 开发注意事项',
-      guide:
-        '三大核心原则（严谨性/深度特征挖掘/完整性）、命名约定遵循、线程安全、@Deprecated 标记、架构约束注释、Nullable 标注',
-    },
-    python: {
-      label: 'Agent 开发注意事项',
-      guide:
-        '三大核心原则（严谨性/深度特征挖掘/完整性）、命名约定（PEP 8）、type hints 覆盖、已废弃 API 标记（DeprecationWarning）、docstring 覆盖',
-    },
-    go: {
-      label: 'Agent 开发注意事项',
-      guide:
-        '三大核心原则（严谨性/深度特征挖掘/完整性）、命名约定遵循、error 必须处理、goroutine 泄漏防护、Deprecated 注释、go vet 通过',
-    },
-    dart: {
-      label: 'Agent 开发注意事项',
-      guide:
-        '三大核心原则（严谨性/深度特征挖掘/完整性）、命名约定遵循（Effective Dart）、类型安全（避免 dynamic）、Widget 生命周期管理（dispose/mounted）、dart analyze 通过、避免 ! 空断言',
-    },
-    rust: {
-      label: 'Agent 开发注意事项',
-      guide:
-        '三大核心原则（严谨性/深度特征挖掘/完整性）、命名约定遵循、unsafe 最小化、clippy lint 通过、#[deprecated] 标记、文档注释覆盖',
-    },
-  },
-};
-
-// ═══════════════════════════════════════════════════════════
-// DimensionCopy — 文案查询服务
-// ═══════════════════════════════════════════════════════════
-
-export class DimensionCopy {
-  /**
-   * 获取指定维度在指定语言下的文案
-   * @param {string} dimId   维度 ID (如 'code-standard')
-   * @param {string} lang    主语言 ID (如 'python', 'typescript')
-   * @returns {{ label: string, guide: string } | null}
-   */
-  static get(dimId, lang) {
-    const entry = COPY_REGISTRY[dimId];
-    if (!entry) {
-      return null;
-    }
-
-    const family = _langFamily(lang);
-    return entry[family] || entry[lang] || entry._default || null;
-  }
-
-  /**
-   * 批量为维度数组注入语言差异化文案（单语言版本）
-   * 会直接修改维度对象的 label 和 guide 字段
-   * @param {Array<{ id: string, label: string, guide: string }>} dimensions
-   * @param {string} lang 主语言
-   * @returns {Array<{ id: string, label: string, guide: string }>} 原数组引用
-   */
-  static apply(dimensions, lang) {
-    for (const dim of dimensions) {
-      const copy = DimensionCopy.get(dim.id, lang);
-      if (copy) {
-        dim.label = copy.label;
-        dim.guide = copy.guide;
-      }
-    }
-    return dimensions;
-  }
-
-  /**
-   * 多语言版本 — 合并主语言 + 次要语言的 guide 文案
-   *
-   * 策略:
-   *   - label 使用主语言的 label（各语言族 label 基本一致）
-   *   - guide 以主语言为主体，追加次要语言的差异化要点
-   *   - 如果主语言和次要语言属于同一语言族，跳过（避免重复）
-   *
-   * @param {Array<{ id: string, label: string, guide: string }>} dimensions
-   * @param {string} primary 主语言 ID
-   * @param {string[]} secondary 次要语言 ID 列表
-   * @returns {Array<{ id: string, label: string, guide: string }>} 原数组引用
-   */
-  static applyMulti(dimensions, primary, secondary = []) {
-    if (!secondary || secondary.length === 0) {
-      return DimensionCopy.apply(dimensions, primary);
-    }
-
-    const primaryFamily = _langFamily(primary);
-
-    // 过滤掉与主语言同族的次要语言（如 swift + objectivec 同属 apple）
-    const effectiveSecondary = secondary.filter((lang) => _langFamily(lang) !== primaryFamily);
-
-    for (const dim of dimensions) {
-      const primaryCopy = DimensionCopy.get(dim.id, primary);
-      if (!primaryCopy) {
-        continue;
-      }
-
-      dim.label = primaryCopy.label;
-
-      if (effectiveSecondary.length === 0) {
-        dim.guide = primaryCopy.guide;
-        continue;
-      }
-
-      // 收集次要语言的差异化 guide 片段
-      const secondaryGuides = [];
-      const seenFamilies = new Set([primaryFamily]);
-      for (const lang of effectiveSecondary) {
-        const fam = _langFamily(lang);
-        if (seenFamilies.has(fam)) {
-          continue;
-        } // 同族去重
-        seenFamilies.add(fam);
-        const copy = DimensionCopy.get(dim.id, lang);
-        if (copy && copy.guide !== primaryCopy.guide) {
-          const displayName = lang.charAt(0).toUpperCase() + lang.slice(1);
-          secondaryGuides.push(`[${displayName}] ${copy.guide}`);
-        }
-      }
-
-      dim.guide =
-        secondaryGuides.length > 0
-          ? `${primaryCopy.guide}\n${secondaryGuides.join('\n')}`
-          : primaryCopy.guide;
-    }
-    return dimensions;
-  }
-
-  /**
-   * 获取所有已有文案的维度 ID 列表
-   * @returns {string[]}
-   */
-  static registeredDimIds() {
-    return Object.keys(COPY_REGISTRY);
-  }
-
-  /**
-   * 获取某维度所有可用语言族
-   * @param {string} dimId
-   * @returns {string[]}
-   */
-  static availableFamilies(dimId) {
-    const entry = COPY_REGISTRY[dimId];
-    if (!entry) {
-      return [];
-    }
-    return Object.keys(entry).filter((k) => k !== '_default');
-  }
-}
-
-export default DimensionCopy;