autosnippet 3.0.0 → 3.0.2

package/lib/injection/ServiceContainer.js

@@ -1,73 +1,69 @@
-import DatabaseConnection from '../infrastructure/database/DatabaseConnection.js';
-import Logger from '../infrastructure/logging/Logger.js';
-import AuditStore from '../infrastructure/audit/AuditStore.js';
-import AuditLogger from '../infrastructure/audit/AuditLogger.js';
-import Gateway from '../core/gateway/Gateway.js';
 import { readdirSync, statSync } from 'node:fs';
-import { join as pathJoin, relative as pathRelative, extname as pathExtname } from 'node:path';
-
-import { KnowledgeRepositoryImpl } from '../repository/knowledge/KnowledgeRepository.impl.js';
-import { KnowledgeFileWriter } from '../service/knowledge/KnowledgeFileWriter.js';
+import { extname as pathExtname, join as pathJoin, relative as pathRelative } from 'node:path';
 import { KnowledgeSyncService } from '../cli/KnowledgeSyncService.js';
-import { KnowledgeService } from '../service/knowledge/KnowledgeService.js';
-import { ConfidenceRouter } from '../service/knowledge/ConfidenceRouter.js';
-import { SnippetFactory } from '../service/snippet/SnippetFactory.js';
-import { GuardService } from '../service/guard/GuardService.js';
-import { KnowledgeGraphService } from '../service/knowledge/KnowledgeGraphService.js';
-import { CodeEntityGraph } from '../service/knowledge/CodeEntityGraph.js';
-import { SearchEngine } from '../service/search/SearchEngine.js';
-import { GuardCheckEngine } from '../service/guard/GuardCheckEngine.js';
-
-// ─── P0: Advanced Search ──────────────────────────────
-import { RetrievalFunnel } from '../service/search/RetrievalFunnel.js';
-
+// ─── v3.0: AST ProjectGraph ──────────────────────────
+import ProjectGraph from '../core/ast/ProjectGraph.js';
+// ─── v3.1: Multi-Language Discovery + Enhancement ────────
+import { getDiscovererRegistry } from '../core/discovery/index.js';
+import { getEnhancementRegistry, initEnhancementRegistry } from '../core/enhancement/index.js';
+import Gateway from '../core/gateway/Gateway.js';
+import AuditLogger from '../infrastructure/audit/AuditLogger.js';
+import AuditStore from '../infrastructure/audit/AuditStore.js';
+import { GraphCache } from '../infrastructure/cache/GraphCache.js';
+// ─── P3: Infrastructure ──────────────────────────────
+import { EventBus } from '../infrastructure/event/EventBus.js';
+import Logger from '../infrastructure/logging/Logger.js';
+import { getRealtimeService as _getRealtimeService } from '../infrastructure/realtime/RealtimeService.js';
+import { IndexingPipeline } from '../infrastructure/vector/IndexingPipeline.js';
 // ─── P0: Vector Storage ──────────────────────────────
 import { JsonVectorAdapter } from '../infrastructure/vector/JsonVectorAdapter.js';
-import { IndexingPipeline } from '../infrastructure/vector/IndexingPipeline.js';
-
-// ─── P1: Injection / Snippet ─────────────────
-import { RecipeParser } from '../service/recipe/RecipeParser.js';
-import { RecipeCandidateValidator } from '../service/recipe/RecipeCandidateValidator.js';
-import { SnippetInstaller } from '../service/snippet/SnippetInstaller.js';
-
-// ─── P1: Guard Advanced ──────────────────────────────
-import { ExclusionManager } from '../service/guard/ExclusionManager.js';
-import { RuleLearner } from '../service/guard/RuleLearner.js';
-import { ViolationsStore } from '../service/guard/ViolationsStore.js';
-import { ComplianceReporter } from '../service/guard/ComplianceReporter.js';
-import { GuardFeedbackLoop } from '../service/guard/GuardFeedbackLoop.js';
-
+import { KnowledgeRepositoryImpl } from '../repository/knowledge/KnowledgeRepository.impl.js';
 // ─── P1: Token Usage Tracking ─────────────────────────
 import { TokenUsageStore } from '../repository/token/TokenUsageStore.js';
-
-// ─── P2: Quality ──────────────────────────────────────
-import { QualityScorer } from '../service/quality/QualityScorer.js';
-import { FeedbackCollector } from '../service/quality/FeedbackCollector.js';
-
-// ─── P2: SPM ──────────────────────────────────────────
-import { SpmService } from '../service/spm/SpmService.js';
-// ─── P2: Content Extraction ─────────────────────────────────────
-import { RecipeExtractor } from '../service/context/RecipeExtractor.js';
 // ─── P2: Automation ───────────────────────────────────
 import { AutomationOrchestrator } from '../service/automation/AutomationOrchestrator.js';
-
+import { BootstrapTaskManager } from '../service/bootstrap/BootstrapTaskManager.js';
+import { ChatAgent } from '../service/chat/ChatAgent.js';
 // ─── P2: ChatAgent (统一 AI Agent) ────────────────────
 import { ToolRegistry } from '../service/chat/ToolRegistry.js';
-import { ChatAgent } from '../service/chat/ChatAgent.js';
 import { ALL_TOOLS } from '../service/chat/tools.js';
-import { SkillHooks } from '../service/skills/SkillHooks.js';
-
-// ─── v3.0: AST ProjectGraph ──────────────────────────
-import ProjectGraph from '../core/ast/ProjectGraph.js';
-import { GraphCache } from '../infrastructure/cache/GraphCache.js';
-
-// ─── P3: Infrastructure ──────────────────────────────
-import { EventBus } from '../infrastructure/event/EventBus.js';
-import { BootstrapTaskManager } from '../service/bootstrap/BootstrapTaskManager.js';
-import { getRealtimeService as _getRealtimeService } from '../infrastructure/realtime/RealtimeService.js';
-
+// ─── P2: Content Extraction ─────────────────────────────────────
+import { RecipeExtractor } from '../service/context/RecipeExtractor.js';
 // ─── P3: Cursor Delivery Pipeline ──────────────────────
 import { CursorDeliveryPipeline } from '../service/cursor/CursorDeliveryPipeline.js';
+import { ComplianceReporter } from '../service/guard/ComplianceReporter.js';
+// ─── P1: Guard Advanced ──────────────────────────────
+import { ExclusionManager } from '../service/guard/ExclusionManager.js';
+import { GuardCheckEngine } from '../service/guard/GuardCheckEngine.js';
+import { GuardFeedbackLoop } from '../service/guard/GuardFeedbackLoop.js';
+import { GuardService } from '../service/guard/GuardService.js';
+import { RuleLearner } from '../service/guard/RuleLearner.js';
+import { ViolationsStore } from '../service/guard/ViolationsStore.js';
+import { CodeEntityGraph } from '../service/knowledge/CodeEntityGraph.js';
+import { ConfidenceRouter } from '../service/knowledge/ConfidenceRouter.js';
+import { KnowledgeFileWriter } from '../service/knowledge/KnowledgeFileWriter.js';
+import { KnowledgeGraphService } from '../service/knowledge/KnowledgeGraphService.js';
+import { KnowledgeService } from '../service/knowledge/KnowledgeService.js';
+import { FeedbackCollector } from '../service/quality/FeedbackCollector.js';
+// ─── P2: Quality ──────────────────────────────────────
+import { QualityScorer } from '../service/quality/QualityScorer.js';
+import { RecipeCandidateValidator } from '../service/recipe/RecipeCandidateValidator.js';
+// ─── P1: Injection / Snippet ─────────────────
+import { RecipeParser } from '../service/recipe/RecipeParser.js';
+// ─── P0: Advanced Search ──────────────────────────────
+import { RetrievalFunnel } from '../service/search/RetrievalFunnel.js';
+import { SearchEngine } from '../service/search/SearchEngine.js';
+import { SkillHooks } from '../service/skills/SkillHooks.js';
+import { SnippetFactory } from '../service/snippet/SnippetFactory.js';
+import { SnippetInstaller } from '../service/snippet/SnippetInstaller.js';
+import { XcodeCodec } from '../service/snippet/codecs/XcodeCodec.js';
+import { VSCodeCodec } from '../service/snippet/codecs/VSCodeCodec.js';
+// ─── P2: SPM ──────────────────────────────────────────
+import { SpmService } from '../platform/ios/spm/SpmService.js';
+// ─── v3.2: ModuleService (统一多语言模块扫描) ──────────
+import { ModuleService } from '../service/module/ModuleService.js';
+import { DimensionCopy } from '../shared/DimensionCopyRegistry.js';
+import { LanguageService } from '../shared/LanguageService.js';
 
 /**
  * DependencyInjection 容器
@@ -139,8 +135,8 @@ export class ServiceContainer {
         try {
           const { getAvailableFallbacks, createProvider } = this.singletons._aiFactory;
           const providerName = this.singletons.aiProvider.name?.replace('-', '') || '';
-          const fbCandidates = typeof getAvailableFallbacks === 'function'
-            ? getAvailableFallbacks(providerName) : [];
+          const fbCandidates =
+            typeof getAvailableFallbacks === 'function' ? getAvailableFallbacks(providerName) : [];
           for (const fb of fbCandidates) {
             try {
               const fbProvider = createProvider({ provider: fb });
@@ -149,9 +145,13 @@ export class ServiceContainer {
                 this.logger.info('Embedding fallback provider created', { provider: fb });
                 break;
               }
-            } catch { /* skip */ }
+            } catch {
+              /* skip */
+            }
           }
-        } catch { /* no embed fallback available */ }
+        } catch {
+          /* no embed fallback available */
+        }
       }
 
       // RecipeExtractor 实例（用于工具增强）
@@ -160,12 +160,28 @@ export class ServiceContainer {
       // 注册基础设施依赖
       this._registerInfrastructure();
 
+      // ═══ AI Provider 热重载标记 ═══
+      // 记录哪些 singleton key 持有 aiProvider 引用，在 reloadAiProvider() 时需要清除
+      this._aiDependentSingletons = [
+        'chatAgent',
+        'searchEngine',
+        'retrievalFunnel',
+        'indexingPipeline',
+      ];
+
       // 注册仓储
       this._registerRepositories();
 
       // 注册服务
       this._registerServices();
 
+      // v3.1: 初始化 Enhancement Pack 注册表（异步加载所有框架增强包）
+      try {
+        await initEnhancementRegistry();
+      } catch (e) {
+        this.logger.warn('Enhancement registry init failed (non-blocking)', { error: e.message });
+      }
+
       this.logger.info('Service container initialized successfully');
     } catch (error) {
       this.logger.error('Error initializing service container', {
@@ -175,6 +191,60 @@ export class ServiceContainer {
     }
   }
 
+  /**
+   * 热重载 AI Provider（API Key 变更后调用，无需重启进程）
+   *
+   * 流程：
+   *  1. 替换 singletons.aiProvider
+   *  2. 重新创建 _embedProvider（如果主 provider 不支持 embedding）
+   *  3. 清除已缓存的依赖 AI 的 singleton（ChatAgent / SearchEngine 等），
+   *     下次 get() 时会用新 provider 重新创建
+   *
+   * @param {import('../external/ai/AiProvider.js').AiProvider} newProvider
+   */
+  reloadAiProvider(newProvider) {
+    const old = this.singletons.aiProvider;
+    this.singletons.aiProvider = newProvider;
+
+    // 重新创建 embedding fallback provider
+    this.singletons._embedProvider = null;
+    if (newProvider && !newProvider.supportsEmbedding?.()) {
+      try {
+        const { getAvailableFallbacks, createProvider } = this.singletons._aiFactory || {};
+        if (typeof getAvailableFallbacks === 'function') {
+          const providerName = newProvider.name?.replace('-', '') || '';
+          const fbCandidates = getAvailableFallbacks(providerName);
+          for (const fb of fbCandidates) {
+            try {
+              const fbProvider = createProvider({ provider: fb });
+              if (fbProvider.supportsEmbedding?.()) {
+                this.singletons._embedProvider = fbProvider;
+                this.logger.info('Embedding fallback provider re-created', { provider: fb });
+                break;
+              }
+            } catch { /* skip */ }
+          }
+        }
+      } catch { /* no embed fallback available */ }
+    }
+
+    // 清除持有旧 aiProvider 引用的 singleton 缓存
+    // 下次调用 container.get() 时会使用新 provider 重建
+    const cleared = [];
+    for (const key of this._aiDependentSingletons || []) {
+      if (this.singletons[key]) {
+        this.singletons[key] = null;
+        cleared.push(key);
+      }
+    }
+
+    this.logger.info('AI provider hot-reloaded', {
+      old: old?.constructor?.name || 'none',
+      new: newProvider?.constructor?.name || 'none',
+      clearedSingletons: cleared,
+    });
+  }
+
   /**
    * 注册基础设施依赖
    */
@@ -182,7 +252,9 @@ export class ServiceContainer {
     // Database（使用 Bootstrap 注入的实例，或延迟报错）
     this.register('database', () => {
       if (!this.singletons.database) {
-        throw new Error('Database not initialized. Ensure Bootstrap.initialize() is called before using ServiceContainer.');
+        throw new Error(
+          'Database not initialized. Ensure Bootstrap.initialize() is called before using ServiceContainer.'
+        );
       }
       return this.singletons.database;
     });
@@ -230,9 +302,16 @@ export class ServiceContainer {
         const eventBus = this.get('eventBus');
         // 延迟 getter: RealtimeService 在 HTTP server 启动后才可用，CLI 模式下不可用
         const getRS = () => {
-          try { return _getRealtimeService(); } catch { return null; }
+          try {
+            return _getRealtimeService();
+          } catch {
+            return null;
+          }
         };
-        this.singletons.bootstrapTaskManager = new BootstrapTaskManager({ eventBus, getRealtimeService: getRS });
+        this.singletons.bootstrapTaskManager = new BootstrapTaskManager({
+          eventBus,
+          getRealtimeService: getRS,
+        });
       }
       return this.singletons.bootstrapTaskManager;
     });
@@ -311,11 +390,7 @@ export class ServiceContainer {
         const knowledgeRepository = this.get('knowledgeRepository');
         const auditLogger = this.get('auditLogger');
         const gateway = this.get('gateway');
-        this.singletons.guardService = new GuardService(
-          knowledgeRepository,
-          auditLogger,
-          gateway
-        );
+        this.singletons.guardService = new GuardService(knowledgeRepository, auditLogger, gateway);
       }
       return this.singletons.guardService;
     });
@@ -333,7 +408,8 @@ export class ServiceContainer {
     this.register('codeEntityGraph', () => {
       if (!this.singletons.codeEntityGraph) {
         const database = this.get('database');
-        const projectRoot = this.singletons._projectRoot || process.env.ASD_PROJECT_DIR || process.cwd();
+        const projectRoot =
+          this.singletons._projectRoot || process.env.ASD_PROJECT_DIR || process.cwd();
         this.singletons.codeEntityGraph = new CodeEntityGraph(database, { projectRoot });
       }
       return this.singletons.codeEntityGraph;
@@ -346,7 +422,10 @@ export class ServiceContainer {
         const aiProvider = this.singletons.aiProvider || null;
         const embedProvider = this.singletons._embedProvider || aiProvider;
         const vectorStore = this.get('vectorStore');
-        this.singletons.searchEngine = new SearchEngine(database, { aiProvider: embedProvider, vectorStore });
+        this.singletons.searchEngine = new SearchEngine(database, {
+          aiProvider: embedProvider,
+          vectorStore,
+        });
       }
       return this.singletons.searchEngine;
     });
@@ -373,7 +452,10 @@ export class ServiceContainer {
         const vectorStore = this.get('vectorStore');
         const aiProvider = this.singletons.aiProvider || null;
         const embedProvider = this.singletons._embedProvider || aiProvider;
-        this.singletons.retrievalFunnel = new RetrievalFunnel({ vectorStore, aiProvider: embedProvider });
+        this.singletons.retrievalFunnel = new RetrievalFunnel({
+          vectorStore,
+          aiProvider: embedProvider,
+        });
       }
       return this.singletons.retrievalFunnel;
     });
@@ -383,7 +465,7 @@ export class ServiceContainer {
       if (!this.singletons.vectorStore) {
         const projectRoot = this.singletons._projectRoot || process.cwd();
         const store = new JsonVectorAdapter(projectRoot);
-        store.initSync();  // 从磁盘加载已有 vector_index.json
+        store.initSync(); // 从磁盘加载已有 vector_index.json
         this.singletons.vectorStore = store;
       }
       return this.singletons.vectorStore;
@@ -395,7 +477,10 @@ export class ServiceContainer {
         const vectorStore = this.get('vectorStore');
         const aiProvider = this.singletons.aiProvider || null;
         const embedProvider = this.singletons._embedProvider || aiProvider;
-        this.singletons.indexingPipeline = new IndexingPipeline({ vectorStore, aiProvider: embedProvider });
+        this.singletons.indexingPipeline = new IndexingPipeline({
+          vectorStore,
+          aiProvider: embedProvider,
+        });
       }
       return this.singletons.indexingPipeline;
     });
@@ -416,24 +501,39 @@ export class ServiceContainer {
       return this.singletons.recipeCandidateValidator;
     });
 
-    // SnippetFactory (V3: uses knowledgeRepository)
+    // SnippetFactory (V4: codec-driven, IDE-agnostic)
     this.register('snippetFactory', () => {
       if (!this.singletons.snippetFactory) {
         const knowledgeRepo = this.get('knowledgeRepository');
-        this.singletons.snippetFactory = new SnippetFactory(knowledgeRepo);
+        const factory = new SnippetFactory(knowledgeRepo);
+        // 注册 IDE codecs
+        factory.registerCodec(new XcodeCodec());
+        factory.registerCodec(new VSCodeCodec());
+        this.singletons.snippetFactory = factory;
       }
       return this.singletons.snippetFactory;
     });
 
-    // SnippetInstaller
+    // SnippetInstaller (Xcode — 默认 codec)
     this.register('snippetInstaller', () => {
       if (!this.singletons.snippetInstaller) {
         const factory = this.get('snippetFactory');
-        this.singletons.snippetInstaller = new SnippetInstaller({ snippetFactory: factory });
+        const codec = factory.getCodec('xcode');
+        this.singletons.snippetInstaller = new SnippetInstaller({ codec, snippetFactory: factory });
       }
       return this.singletons.snippetInstaller;
     });
 
+    // SnippetInstaller (VSCode)
+    this.register('vscodeSnippetInstaller', () => {
+      if (!this.singletons.vscodeSnippetInstaller) {
+        const factory = this.get('snippetFactory');
+        const codec = factory.getCodec('vscode');
+        this.singletons.vscodeSnippetInstaller = new SnippetInstaller({ codec, snippetFactory: factory });
+      }
+      return this.singletons.vscodeSnippetInstaller;
+    });
+
     // Guard: ExclusionManager
     this.register('exclusionManager', () => {
       if (!this.singletons.exclusionManager) {
@@ -470,7 +570,7 @@ export class ServiceContainer {
           this.get('violationsStore'),
           this.get('ruleLearner'),
           this.get('exclusionManager'),
-          config.qualityGate || {},
+          config.qualityGate || {}
         );
       }
       return this.singletons.complianceReporter;
@@ -482,7 +582,7 @@ export class ServiceContainer {
         this.singletons.guardFeedbackLoop = new GuardFeedbackLoop(
           this.get('violationsStore'),
           this.get('feedbackCollector'),
-          { guardCheckEngine: this.get('guardCheckEngine') },
+          { guardCheckEngine: this.get('guardCheckEngine') }
         );
       }
       return this.singletons.guardFeedbackLoop;
@@ -541,6 +641,38 @@ export class ServiceContainer {
       return this.singletons.automationOrchestrator;
     });
 
+    // ModuleService (统一多语言模块扫描，语言无关)
+    this.register('moduleService', () => {
+      if (!this.singletons.moduleService) {
+        const projectRoot = this.singletons._projectRoot || process.cwd();
+        this.singletons.moduleService = new ModuleService(projectRoot, {
+          aiFactory: this.singletons._aiFactory || null,
+          chatAgent: this.singletons.chatAgent || null,
+          qualityScorer: this.get('qualityScorer'),
+          recipeExtractor: this.singletons._recipeExtractor || null,
+          guardCheckEngine: this.get('guardCheckEngine'),
+          violationsStore: this.get('violationsStore'),
+        });
+      }
+      return this.singletons.moduleService;
+    });
+
+    // DiscovererRegistry (v3.1 多语言项目发现)
+    this.register('discovererRegistry', () => {
+      return getDiscovererRegistry();
+    });
+
+    // LanguageService (v3.1 统一语言映射服务 — 静态类，直接返回)
+    this.register('languageService', () => LanguageService);
+
+    // DimensionCopy (v3.1 维度文案注册表 — 静态类，直接返回)
+    this.register('dimensionCopy', () => DimensionCopy);
+
+    // EnhancementRegistry (v3.1 框架增强包)
+    this.register('enhancementRegistry', () => {
+      return getEnhancementRegistry();
+    });
+
     // ToolRegistry (ChatAgent 的工具注册表)
     this.register('toolRegistry', () => {
       if (!this.singletons.toolRegistry) {
@@ -662,14 +794,14 @@ export class ServiceContainer {
             changedPaths.push(fp);
           }
         }
-        const deletedPaths = Object.keys(oldHashes).filter(rel => !newHashes[rel]);
+        const deletedPaths = Object.keys(oldHashes).filter((rel) => !newHashes[rel]);
 
         if (changedPaths.length === 0 && deletedPaths.length === 0) {
           // 完全命中
           this.singletons.projectGraph = graph;
           this.logger.info(
             `[ServiceContainer] ProjectGraph ⚡ 缓存命中 (${graph.getOverview().totalClasses} classes, ` +
-            `${Date.now() - startTime}ms)`
+              `${Date.now() - startTime}ms)`
           );
           return graph;
         }
@@ -684,7 +816,7 @@ export class ServiceContainer {
         const overview = graph.getOverview();
         this.logger.info(
           `[ServiceContainer] ProjectGraph 增量更新: +${diff.added} ~${diff.updated} -${diff.deleted} ` +
-          `(${overview.totalClasses} classes, ${Date.now() - startTime}ms)`
+            `(${overview.totalClasses} classes, ${Date.now() - startTime}ms)`
         );
         return graph;
       }
@@ -701,8 +833,8 @@ export class ServiceContainer {
 
       this.logger.info(
         `[ServiceContainer] ProjectGraph built: ${overview.totalClasses} classes, ` +
-        `${overview.totalProtocols} protocols, ${overview.totalCategories} categories ` +
-        `(${overview.buildTimeMs}ms) — 缓存已写入`
+          `${overview.totalProtocols} protocols, ${overview.totalCategories} categories ` +
+          `(${overview.buildTimeMs}ms) — 缓存已写入`
       );
       return graph;
     } catch (err) {
@@ -721,29 +853,51 @@ export class ServiceContainer {
     const DEFAULTS_EXT = { '.m': true, '.h': true, '.swift': true };
     const extSet = new Set(options.extensions || Object.keys(DEFAULTS_EXT));
     const excludePatterns = options.excludePatterns || [
-      'Pods/', 'Carthage/', 'node_modules/', '.build/', 'build/',
-      'DerivedData/', 'vendor/', '.git/', '__tests__/', 'Tests/',
+      'Pods/',
+      'Carthage/',
+      'node_modules/',
+      '.build/',
+      'build/',
+      'DerivedData/',
+      'vendor/',
+      '.git/',
+      '__tests__/',
+      'Tests/',
     ];
     const maxFiles = options.maxFiles || 500;
     const maxFileSizeBytes = options.maxFileSizeBytes || 500_000;
     const results = [];
 
     function walk(dir) {
-      if (results.length >= maxFiles) return;
+      if (results.length >= maxFiles) {
+        return;
+      }
       let entries;
-      try { entries = readdirSync(dir, { withFileTypes: true }); } catch { return; }
+      try {
+        entries = readdirSync(dir, { withFileTypes: true });
+      } catch {
+        return;
+      }
       for (const entry of entries) {
-        if (results.length >= maxFiles) return;
+        if (results.length >= maxFiles) {
+          return;
+        }
         const fullPath = pathJoin(dir, entry.name);
         const relativePath = pathRelative(projectRoot, fullPath);
-        if (excludePatterns.some(p => relativePath.includes(p))) continue;
+        if (excludePatterns.some((p) => relativePath.includes(p))) {
+          continue;
+        }
         if (entry.isDirectory()) {
           walk(fullPath);
         } else if (entry.isFile() && extSet.has(pathExtname(entry.name))) {
           try {
             const stat = statSync(fullPath);
-            if (stat.size <= maxFileSizeBytes) results.push(fullPath);
-          } catch { /* skip */ }
+            if (stat.size <= maxFileSizeBytes) {
+              results.push(fullPath);
+            }
+          } catch {
+            /* skip */
+          }
         }
       }
     }

package/lib/platform/ios/index.js

@@ -0,0 +1,63 @@
+/**
+ * @module platform/ios
+ * @description iOS + Xcode 平台支持模块
+ *
+ * 将所有 iOS/Xcode 特有功能集中到 lib/platform/ios/ 下:
+ *
+ *   xcode/
+ *     XcodeAutomation.js     — AppleScript/osascript Xcode IDE 自动化
+ *     XcodeIntegration.js    — Xcode 代码自动插入 + Header 管理 + 依赖检查
+ *     SaveEventFilter.js     — 保存事件过滤（Xcode 焦点检测 + 内容哈希去重）
+ *
+ *   snippet/
+ *     XcodeCodec.js          — Xcode .codesnippet (plist XML) 编解码
+ *     PlaceholderConverter.js — Xcode <#…#> ↔ VSCode ${N:…} 占位符转换
+ *
+ *   spm/
+ *     SpmService.js          — Swift Package Manager 服务（Target / 依赖 / 策略）
+ *     SpmDiscoverer.js       — SPM 项目自动发现（ProjectDiscoverer 接口）
+ *     PackageSwiftParser.js  — Package.swift 解析器
+ *     DependencyGraph.js     — SPM Target 依赖图
+ *     PolicyEngine.js        — 依赖策略引擎（层级检查 / 循环检测）
+ *
+ *   routes/
+ *     spm.js                 — /api/v1/spm/* REST 路由（向后兼容遗留端点）
+ *
+ * 旧路径保留了 re-export shim 确保向后兼容。
+ */
+
+// ── Xcode IDE 自动化 ──
+export {
+  isXcodeRunning,
+  isXcodeFrontmost,
+  jumpToLineInXcode,
+  cutLineInXcode,
+  deleteLineContentInXcode,
+  pasteInXcode,
+  selectAndPasteInXcode,
+  insertAtLineStartInXcode,
+  saveActiveDocumentInXcode,
+} from './xcode/XcodeAutomation.js';
+
+export {
+  insertHeaders,
+  insertCodeToXcode,
+  findTriggerLineNumber,
+  findImportInsertLine,
+} from './xcode/XcodeIntegration.js';
+
+export { saveEventFilter } from './xcode/SaveEventFilter.js';
+
+// ── Xcode Snippet 编解码 ──
+export { XcodeCodec } from './snippet/XcodeCodec.js';
+export { PlaceholderConverter } from './snippet/PlaceholderConverter.js';
+
+// ── Swift Package Manager ──
+export { SpmService } from './spm/SpmService.js';
+export { SpmDiscoverer } from './spm/SpmDiscoverer.js';
+export { PackageSwiftParser } from './spm/PackageSwiftParser.js';
+export { DependencyGraph } from './spm/DependencyGraph.js';
+export { PolicyEngine } from './spm/PolicyEngine.js';
+
+// ── SPM Legacy Routes ──
+export { default as spmRouter } from './routes/spm.js';