autosnippet 2.9.0 → 2.11.0

package/lib/infrastructure/external/XcodeAutomation.js

@@ -1,18 +1,50 @@
 /**
- * XcodeAutomation - Xcode AppleScript 自动化
+ * XcodeAutomation — Xcode AppleScript 自动化
  *
- * 提供 Xcode 行操作：跳转行、选中行、剪切行、粘贴等。
- * 所有操作都带超时保护，Xcode 未运行时默认跳过。
+ * 通过 osascript 向 Xcode 发送键盘事件，实现行级操作：
+ *   跳转行、选中行内容、剪切行、粘贴、在行首插入、删除行内容、保存文档。
  *
- * V2 ESM 版本，对应 V1 SearchHandler/CreateHandler 中的散落 AppleScript 逻辑。
+ * 所有操作都带超时保护（OSASCRIPT_TIMEOUT），Xcode 未运行时安全跳过。
+ * 仅支持 macOS。
  */
 
 import { execSync, spawnSync } from 'node:child_process';
 
 const OSASCRIPT_TIMEOUT = 5000;
 
+// ─────────────────────────────────────────────
+// 内部辅助
+// ─────────────────────────────────────────────
+
+/**
+ * 将行号限制为有效正整数（最小值 1）
+ * @param {number} n 原始行号
+ * @returns {number} 安全的 1-based 行号
+ */
+function _safeLine(n) {
+  return Number.isFinite(n) && n > 0 ? n : 1;
+}
+
+/**
+ * 执行 osascript 并返回是否成功
+ * @param {string[]} args  osascript 参数数组（每对 `-e`, `script`）
+ * @returns {boolean}
+ */
+function _run(args) {
+  try {
+    const res = spawnSync('osascript', args, { stdio: 'ignore', timeout: OSASCRIPT_TIMEOUT });
+    return res.status === 0;
+  } catch {
+    return false;
+  }
+}
+
+// ─────────────────────────────────────────────
+// 状态查询
+// ─────────────────────────────────────────────
+
 /**
- * 检查 Xcode 是否正在运行（不启动 Xcode）
+ * 检查 Xcode 是否正在运行（不会启动 Xcode）
  */
 export function isXcodeRunning() {
   if (process.platform !== 'darwin') return false;
@@ -29,7 +61,7 @@ export function isXcodeRunning() {
 }
 
 /**
- * 检查 Xcode 是否是当前焦点应用
+ * 检查 Xcode 是否为当前前台应用
  */
 export function isXcodeFrontmost() {
   if (!isXcodeRunning()) return false;
@@ -44,132 +76,184 @@ export function isXcodeFrontmost() {
   }
 }
 
+// ─────────────────────────────────────────────
+// 行操作
+// ─────────────────────────────────────────────
+
 /**
- * 在 Xcode 中剪切指定行内容（不含换行符，与 V1 一致）
- * Cmd+L 跳转 → Cmd+← 行首 → Cmd+Shift+→ 选中行内容 → Cmd+X 剪切
+ * 跳转到指定行
+ *
+ * 按键序列：Cmd+L → 输入行号 → Return
+ *
+ * @param {number} lineNumber 1-based 行号
+ * @returns {boolean} 是否成功
+ */
+export function jumpToLineInXcode(lineNumber) {
+  if (!isXcodeRunning()) return false;
+  const n = _safeLine(lineNumber);
+  return _run([
+    '-e', 'tell application "Xcode" to activate',
+    '-e', 'delay 0.2',
+    '-e', 'tell application "System Events"',
+    '-e', '  keystroke "l" using command down',
+    '-e', '  delay 0.2',
+    '-e', `  keystroke "${String(n)}"`,
+    '-e', '  delay 0.2',
+    '-e', '  key code 36',
+    '-e', 'end tell',
+  ]);
+}
+
+/**
+ * 剪切指定行的文本内容（不含换行符）
+ *
+ * 按键序列：Cmd+L 跳转 → Cmd+← 行首 → Cmd+Shift+→ 选到行尾 → Cmd+X 剪切
+ *
  * @param {number} lineNumber 1-based 行号
  * @returns {boolean} 是否成功
  */
 export function cutLineInXcode(lineNumber) {
   if (!isXcodeRunning()) return false;
-  const safeLineNumber = Number.isFinite(lineNumber) && lineNumber > 0 ? lineNumber : 1;
-  try {
-    const args = [
-      '-e', 'tell application "Xcode" to activate',
-      '-e', 'delay 0.5',
-      '-e', 'tell application "System Events"',
-      '-e', '  keystroke "l" using command down',       // Cmd+L: Go to Line
-      '-e', '  delay 0.5',
-      '-e', `  keystroke "${String(safeLineNumber)}"`,  // 输入行号
-      '-e', '  delay 0.5',
-      '-e', '  key code 36',                            // Return
-      '-e', '  delay 0.5',
-      '-e', '  key code 123 using command down',        // Cmd+← 行首
-      '-e', '  delay 0.5',
-      '-e', '  key code 124 using {command down, shift down}', // Cmd+Shift+→ 选到行尾（不含换行）
-      '-e', '  delay 0.5',
-      '-e', '  keystroke "x" using command down',       // Cmd+X
-      '-e', 'end tell',
-    ];
-    const res = spawnSync('osascript', args, { stdio: 'ignore', timeout: OSASCRIPT_TIMEOUT });
-    return res.status === 0;
-  } catch {
-    return false;
-  }
+  const n = _safeLine(lineNumber);
+  return _run([
+    '-e', 'tell application "Xcode" to activate',
+    '-e', 'delay 0.5',
+    '-e', 'tell application "System Events"',
+    '-e', '  keystroke "l" using command down',                      // Cmd+L: Go to Line
+    '-e', '  delay 0.5',
+    '-e', `  keystroke "${String(n)}"`,                              // 输入行号
+    '-e', '  delay 0.5',
+    '-e', '  key code 36',                                           // Return
+    '-e', '  delay 0.5',
+    '-e', '  key code 123 using command down',                       // Cmd+← 行首
+    '-e', '  delay 0.5',
+    '-e', '  key code 124 using {command down, shift down}',         // Cmd+Shift+→ 选到行尾
+    '-e', '  delay 0.5',
+    '-e', '  keystroke "x" using command down',                      // Cmd+X
+    '-e', 'end tell',
+  ]);
 }
 
 /**
- * 在 Xcode 中跳转到指定行
+ * 删除指定行的文本内容（保留空行，不删除行本身）
+ *
+ * 按键序列：Cmd+L 跳转 → Cmd+← 行首 → Cmd+Shift+→ 选到行尾 → Delete
+ *
  * @param {number} lineNumber 1-based 行号
- * @returns {boolean}
+ * @returns {boolean} 是否成功
  */
-export function jumpToLineInXcode(lineNumber) {
+export function deleteLineContentInXcode(lineNumber) {
   if (!isXcodeRunning()) return false;
-  const safeLine = Number.isFinite(lineNumber) && lineNumber > 0 ? lineNumber : 1;
-  try {
-    const args = [
-      '-e', 'tell application "Xcode" to activate',
-      '-e', 'delay 0.2',
-      '-e', 'tell application "System Events"',
-      '-e', '  keystroke "l" using command down',
-      '-e', '  delay 0.2',
-      '-e', `  keystroke "${String(safeLine)}"`,
-      '-e', '  delay 0.2',
-      '-e', '  key code 36',
-      '-e', 'end tell',
-    ];
-    const res = spawnSync('osascript', args, { stdio: 'ignore', timeout: OSASCRIPT_TIMEOUT });
-    return res.status === 0;
-  } catch {
-    return false;
-  }
+  const n = _safeLine(lineNumber);
+  return _run([
+    '-e', 'tell application "Xcode" to activate',
+    '-e', 'delay 0.3',
+    '-e', 'tell application "System Events"',
+    '-e', '  keystroke "l" using command down',
+    '-e', '  delay 0.3',
+    '-e', `  keystroke "${String(n)}"`,
+    '-e', '  delay 0.3',
+    '-e', '  key code 36',
+    '-e', '  delay 0.3',
+    '-e', '  key code 123 using command down',                       // Cmd+← 行首
+    '-e', '  delay 0.2',
+    '-e', '  key code 124 using {command down, shift down}',         // Cmd+Shift+→ 选到行尾
+    '-e', '  delay 0.2',
+    '-e', '  key code 51',                                           // Delete 键
+    '-e', '  delay 0.3',
+    '-e', 'end tell',
+  ]);
 }
 
+// ─────────────────────────────────────────────
+// 粘贴操作
+// ─────────────────────────────────────────────
+
 /**
- * 在 Xcode 中执行粘贴（Cmd+V）
- * @returns {boolean}
+ * 执行粘贴（Cmd+V）
+ *
+ * 调用前须确保剪贴板已写入目标内容。
+ * @returns {boolean} 是否成功
  */
 export function pasteInXcode() {
   if (!isXcodeRunning()) return false;
-  try {
-    const args = [
-      '-e', 'tell application "Xcode" to activate',
-      '-e', 'delay 0.2',
-      '-e', 'tell application "System Events"',
-      '-e', '  keystroke "v" using command down',
-      '-e', 'end tell',
-    ];
-    const res = spawnSync('osascript', args, { stdio: 'ignore', timeout: OSASCRIPT_TIMEOUT });
-    return res.status === 0;
-  } catch {
-    return false;
-  }
+  return _run([
+    '-e', 'tell application "Xcode" to activate',
+    '-e', 'delay 0.2',
+    '-e', 'tell application "System Events"',
+    '-e', '  keystroke "v" using command down',
+    '-e', 'end tell',
+  ]);
 }
 
 /**
- * 在 Xcode 中选中当前行内容后粘贴替换（V1 _tryAutoPasteXcode 逻辑）
- * 光标已在目标行（由 jumpToLineInXcode 定位）
- * Cmd+← 行首 → Cmd+Shift+→ 选到行尾 → Cmd+V 粘贴替换
- * @returns {boolean}
+ * 选中当前行内容后粘贴替换
+ *
+ * 假设光标已在目标行（通常由 jumpToLineInXcode 定位后调用）。
+ * 按键序列：Cmd+← 行首 → Cmd+Shift+→ 选到行尾 → Cmd+V 粘贴替换
+ *
+ * @returns {boolean} 是否成功
  */
 export function selectAndPasteInXcode() {
   if (!isXcodeRunning()) return false;
-  try {
-    const args = [
-      '-e', 'tell application "Xcode" to activate',
-      '-e', 'delay 0.5',
-      '-e', 'tell application "System Events"',
-      '-e', '  key code 123 using command down',        // Cmd+← 行首
-      '-e', '  delay 0.1',
-      '-e', '  key code 124 using {command down, shift down}', // Cmd+Shift+→ 选到行尾
-      '-e', '  delay 0.2',
-      '-e', '  keystroke "v" using command down',       // Cmd+V 粘贴替换选中内容
-      '-e', 'end tell',
-    ];
-    const res = spawnSync('osascript', args, { stdio: 'ignore', timeout: OSASCRIPT_TIMEOUT });
-    return res.status === 0;
-  } catch {
-    return false;
-  }
+  return _run([
+    '-e', 'tell application "Xcode" to activate',
+    '-e', 'delay 0.5',
+    '-e', 'tell application "System Events"',
+    '-e', '  key code 123 using command down',                       // Cmd+← 行首
+    '-e', '  delay 0.1',
+    '-e', '  key code 124 using {command down, shift down}',         // Cmd+Shift+→ 选到行尾
+    '-e', '  delay 0.2',
+    '-e', '  keystroke "v" using command down',                      // Cmd+V 粘贴替换
+    '-e', 'end tell',
+  ]);
 }
 
+/**
+ * 跳转到指定行行首并粘贴剪贴板内容
+ *
+ * 用于在 import 区域插入新行。
+ * 按键序列：Cmd+L → 输入行号 → Return → Cmd+← 行首 → Cmd+V 粘贴
+ *
+ * @param {number} lineNumber 1-based 行号
+ * @returns {boolean} 是否成功
+ */
+export function insertAtLineStartInXcode(lineNumber) {
+  if (!isXcodeRunning()) return false;
+  const n = _safeLine(lineNumber);
+  return _run([
+    '-e', 'tell application "Xcode" to activate',
+    '-e', 'delay 0.3',
+    '-e', 'tell application "System Events"',
+    '-e', '  keystroke "l" using command down',                      // Cmd+L: Go to Line
+    '-e', '  delay 0.3',
+    '-e', `  keystroke "${String(n)}"`,                              // 输入行号
+    '-e', '  delay 0.3',
+    '-e', '  key code 36',                                           // Return
+    '-e', '  delay 0.3',
+    '-e', '  key code 123 using command down',                       // Cmd+← 行首
+    '-e', '  delay 0.2',
+    '-e', '  keystroke "v" using command down',                      // Cmd+V 粘贴
+    '-e', '  delay 0.3',
+    '-e', 'end tell',
+  ]);
+}
+
+// ─────────────────────────────────────────────
+// 文档操作
+// ─────────────────────────────────────────────
+
 /**
  * 保存 Xcode 当前活动文档（Cmd+S）
- * @returns {boolean}
+ * @returns {boolean} 是否成功
  */
 export function saveActiveDocumentInXcode() {
   if (!isXcodeRunning()) return false;
-  try {
-    const args = [
-      '-e', 'tell application "Xcode" to activate',
-      '-e', 'delay 0.1',
-      '-e', 'tell application "System Events"',
-      '-e', '  keystroke "s" using command down',
-      '-e', 'end tell',
-    ];
-    const res = spawnSync('osascript', args, { stdio: 'ignore', timeout: OSASCRIPT_TIMEOUT });
-    return res.status === 0;
-  } catch {
-    return false;
-  }
+  return _run([
+    '-e', 'tell application "Xcode" to activate',
+    '-e', 'delay 0.1',
+    '-e', 'tell application "System Events"',
+    '-e', '  keystroke "s" using command down',
+    '-e', 'end tell',
+  ]);
 }

package/lib/injection/ServiceContainer.js

@@ -6,10 +6,12 @@ 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 { CandidateRepositoryImpl } from '../repository/candidate/CandidateRepository.impl.js';
-import { RecipeRepositoryImpl } from '../repository/recipe/RecipeRepository.impl.js';
+import { KnowledgeRepositoryImpl } from '../repository/knowledge/KnowledgeRepository.impl.js';
+import { KnowledgeFileWriter } from '../service/knowledge/KnowledgeFileWriter.js';
+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 { RecipeService } from '../service/recipe/RecipeService.js';
 import { GuardService } from '../service/guard/GuardService.js';
 import { KnowledgeGraphService } from '../service/knowledge/KnowledgeGraphService.js';
 import { SearchEngine } from '../service/search/SearchEngine.js';
@@ -22,13 +24,9 @@ import { RetrievalFunnel } from '../service/search/RetrievalFunnel.js';
 import { JsonVectorAdapter } from '../infrastructure/vector/JsonVectorAdapter.js';
 import { IndexingPipeline } from '../infrastructure/vector/IndexingPipeline.js';
 
-// ─── P1: Injection / Snippet / Recipe ─────────────────
+// ─── P1: Injection / Snippet ─────────────────
 import { RecipeParser } from '../service/recipe/RecipeParser.js';
-import { RecipeStatsTracker } from '../service/recipe/RecipeStatsTracker.js';
 import { RecipeCandidateValidator } from '../service/recipe/RecipeCandidateValidator.js';
-import { RecipeFileWriter } from '../service/recipe/RecipeFileWriter.js';
-import { CandidateFileWriter } from '../service/candidate/CandidateFileWriter.js';
-import { CandidateService } from '../service/candidate/CandidateService.js';
 import { SnippetInstaller } from '../service/snippet/SnippetInstaller.js';
 
 // ─── P1: Guard Advanced ──────────────────────────────
@@ -65,6 +63,9 @@ import { EventBus } from '../infrastructure/event/EventBus.js';
 import { BootstrapTaskManager } from '../service/bootstrap/BootstrapTaskManager.js';
 import { getRealtimeService as _getRealtimeService } from '../infrastructure/realtime/RealtimeService.js';
 
+// ─── P3: Cursor Delivery Pipeline ──────────────────────
+import { CursorDeliveryPipeline } from '../service/cursor/CursorDeliveryPipeline.js';
+
 /**
  * DependencyInjection 容器
  * 管理所有应用层的仓储、服务和基础设施依赖的创建和注入
@@ -238,22 +239,31 @@ export class ServiceContainer {
    * 注册仓储
    */
   _registerRepositories() {
-    // CandidateRepository
-    this.register('candidateRepository', () => {
-      if (!this.singletons.candidateRepository) {
+    // KnowledgeRepository (统一知识实体)
+    this.register('knowledgeRepository', () => {
+      if (!this.singletons.knowledgeRepository) {
         const database = this.get('database');
-        this.singletons.candidateRepository = new CandidateRepositoryImpl(database);
+        this.singletons.knowledgeRepository = new KnowledgeRepositoryImpl(database);
       }
-      return this.singletons.candidateRepository;
+      return this.singletons.knowledgeRepository;
     });
 
-    // RecipeRepository
-    this.register('recipeRepository', () => {
-      if (!this.singletons.recipeRepository) {
-        const database = this.get('database');
-        this.singletons.recipeRepository = new RecipeRepositoryImpl(database);
+    // KnowledgeFileWriter (统一 .md 序列化/落盘)
+    this.register('knowledgeFileWriter', () => {
+      if (!this.singletons.knowledgeFileWriter) {
+        const projectRoot = this.singletons._projectRoot || process.cwd();
+        this.singletons.knowledgeFileWriter = new KnowledgeFileWriter(projectRoot);
+      }
+      return this.singletons.knowledgeFileWriter;
+    });
+
+    // KnowledgeSyncService (统一 .md ↔ DB 同步)
+    this.register('knowledgeSyncService', () => {
+      if (!this.singletons.knowledgeSyncService) {
+        const projectRoot = this.singletons._projectRoot || process.cwd();
+        this.singletons.knowledgeSyncService = new KnowledgeSyncService(projectRoot);
       }
-      return this.singletons.recipeRepository;
+      return this.singletons.knowledgeSyncService;
     });
   }
 
@@ -261,54 +271,45 @@ export class ServiceContainer {
    * 注册服务
    */
   _registerServices() {
-    // CandidateService
-    this.register('candidateService', () => {
-      if (!this.singletons.candidateService) {
-        const candidateRepository = this.get('candidateRepository');
-        const auditLogger = this.get('auditLogger');
-        const gateway = this.get('gateway');
-        const projectRoot = this.singletons._projectRoot || process.cwd();
-        const candidateFileWriter = new CandidateFileWriter(projectRoot);
-        const skillHooks = this.get('skillHooks');
-        this.singletons.candidateService = new CandidateService(
-          candidateRepository,
-          auditLogger,
-          gateway,
-          { fileWriter: candidateFileWriter, skillHooks }
-        );
+    // ConfidenceRouter (V3: 知识条目自动审核路由)
+    this.register('confidenceRouter', () => {
+      if (!this.singletons.confidenceRouter) {
+        const qualityScorer = this.get('qualityScorer');
+        this.singletons.confidenceRouter = new ConfidenceRouter({}, qualityScorer);
       }
-      return this.singletons.candidateService;
+      return this.singletons.confidenceRouter;
     });
 
-    // RecipeService
-    this.register('recipeService', () => {
-      if (!this.singletons.recipeService) {
-        const recipeRepository = this.get('recipeRepository');
+    // KnowledgeService (V3: 统一知识服务)
+    this.register('knowledgeService', () => {
+      if (!this.singletons.knowledgeService) {
+        const knowledgeRepository = this.get('knowledgeRepository');
         const auditLogger = this.get('auditLogger');
         const gateway = this.get('gateway');
         const knowledgeGraphService = this.get('knowledgeGraphService');
-        const projectRoot = this.singletons._projectRoot || process.cwd();
-        const fileWriter = new RecipeFileWriter(projectRoot);
+        const fileWriter = this.get('knowledgeFileWriter');
         const skillHooks = this.get('skillHooks');
-        this.singletons.recipeService = new RecipeService(
-          recipeRepository,
+        const confidenceRouter = this.get('confidenceRouter');
+        const qualityScorer = this.get('qualityScorer');
+        this.singletons.knowledgeService = new KnowledgeService(
+          knowledgeRepository,
           auditLogger,
           gateway,
           knowledgeGraphService,
-          { fileWriter, skillHooks }
+          { fileWriter, skillHooks, confidenceRouter, qualityScorer }
         );
       }
-      return this.singletons.recipeService;
+      return this.singletons.knowledgeService;
     });
 
-    // GuardService (now uses recipeRepository)
+    // GuardService (V3: uses knowledgeRepository)
     this.register('guardService', () => {
       if (!this.singletons.guardService) {
-        const recipeRepository = this.get('recipeRepository');
+        const knowledgeRepository = this.get('knowledgeRepository');
         const auditLogger = this.get('auditLogger');
         const gateway = this.get('gateway');
         this.singletons.guardService = new GuardService(
-          recipeRepository,
+          knowledgeRepository,
           auditLogger,
           gateway
         );
@@ -394,15 +395,6 @@ export class ServiceContainer {
       return this.singletons.recipeParser;
     });
 
-    // RecipeStatsTracker
-    this.register('recipeStatsTracker', () => {
-      if (!this.singletons.recipeStatsTracker) {
-        const projectRoot = this.singletons._projectRoot || process.cwd();
-        this.singletons.recipeStatsTracker = new RecipeStatsTracker(projectRoot);
-      }
-      return this.singletons.recipeStatsTracker;
-    });
-
     // RecipeCandidateValidator
     this.register('recipeCandidateValidator', () => {
       if (!this.singletons.recipeCandidateValidator) {
@@ -411,11 +403,11 @@ export class ServiceContainer {
       return this.singletons.recipeCandidateValidator;
     });
 
-    // SnippetFactory (no DB — generates from recipes on-the-fly)
+    // SnippetFactory (V3: uses knowledgeRepository)
     this.register('snippetFactory', () => {
       if (!this.singletons.snippetFactory) {
-        const recipeRepo = this.get('recipeRepository');
-        this.singletons.snippetFactory = new SnippetFactory(recipeRepo);
+        const knowledgeRepo = this.get('knowledgeRepository');
+        this.singletons.snippetFactory = new SnippetFactory(knowledgeRepo);
       }
       return this.singletons.snippetFactory;
     });
@@ -473,6 +465,9 @@ export class ServiceContainer {
       return this.singletons.qualityScorer;
     });
 
+    // RecipeExtractor（语义标签提取）
+    this.register('recipeExtractor', () => this.singletons._recipeExtractor || null);
+
     // FeedbackCollector
     this.register('feedbackCollector', () => {
       if (!this.singletons.feedbackCollector) {
@@ -546,6 +541,20 @@ export class ServiceContainer {
       }
       return this.singletons.skillHooks;
     });
+
+    // CursorDeliveryPipeline (4 通道交付：知识库 → Cursor Rules/Skills)
+    this.register('cursorDeliveryPipeline', () => {
+      if (!this.singletons.cursorDeliveryPipeline) {
+        const knowledgeService = this.get('knowledgeService');
+        const projectRoot = this.singletons._projectRoot || process.cwd();
+        this.singletons.cursorDeliveryPipeline = new CursorDeliveryPipeline({
+          knowledgeService,
+          projectRoot,
+          logger: this.logger,
+        });
+      }
+      return this.singletons.cursorDeliveryPipeline;
+    });
   }
 
   /**