autosnippet 3.2.10 → 3.2.12

package/lib/service/automation/handlers/AlinkHandler.js

@@ -1,81 +0,0 @@
-/**
- * AlinkHandler — 处理 alink 指令
- *
- * 解析编辑器中的 alink 触发行，提取 completionKey，
- * 通过数据库查找匹配的 Recipe，打开 Dashboard 详情页。
- */
-
-import { getServiceContainer } from '../../../injection/ServiceContainer.js';
-
-/**
- * @param {string} alinkLine
- */
-export async function handleAlink(alinkLine) {
-  const { TRIGGER_SYMBOL } = await import('../../../infrastructure/config/TriggerSymbol.js');
-  let completionKey = null;
-  const alinkMark = 'alink';
-
-  if (alinkLine.includes(TRIGGER_SYMBOL)) {
-    const parts = alinkLine
-      .split(TRIGGER_SYMBOL)
-      .map((p) => p.trim())
-      .filter(Boolean);
-    if (parts.length >= 2 && parts[parts.length - 1] === alinkMark) {
-      completionKey = parts[parts.length - 2];
-    }
-  }
-
-  if (completionKey != null) {
-    try {
-      // 从 DI 容器获取数据库实例，查找匹配 trigger 的 Recipe
-      const container = getServiceContainer();
-      const db = container.get('database');
-
-      let recipeId = null;
-      if (db) {
-        const rawDb = typeof db.getDb === 'function' ? db.getDb() : db;
-        try {
-          const row = rawDb
-            .prepare(
-              "SELECT id FROM knowledge_entries WHERE trigger = ? AND lifecycle = 'active' LIMIT 1"
-            )
-            .get(completionKey);
-          if (row) {
-            recipeId = row.id;
-          }
-        } catch {
-          // DB 查询失败时回退到搜索
-        }
-
-        // 若精确匹配失败，尝试模糊搜索
-        if (!recipeId) {
-          try {
-            const escaped = completionKey.replace(/[%_\\]/g, (ch) => `\\${ch}`);
-            const row = rawDb
-              .prepare(
-                "SELECT id FROM knowledge_entries WHERE (trigger LIKE ? ESCAPE '\\' OR title LIKE ? ESCAPE '\\') AND lifecycle = 'active' LIMIT 1"
-              )
-              .get(`%${escaped}%`, `%${escaped}%`);
-            if (row) {
-              recipeId = row.id;
-            }
-          } catch {
-            /* silent */
-          }
-        }
-      }
-
-      // 构建 Dashboard URL 并打开
-      const port = process.env.ASD_DASHBOARD_PORT || 3000;
-      const host = process.env.ASD_DASHBOARD_HOST || 'localhost';
-      const url = recipeId
-        ? `http://${host}:${port}/#/recipes/${recipeId}`
-        : `http://${host}:${port}/#/search?q=${encodeURIComponent(completionKey)}`;
-
-      const open = (await import('open')).default;
-      await open(url);
-    } catch (err) {
-      console.warn(`[alink] Failed to open link: ${err.message}`);
-    }
-  }
-}

package/lib/service/automation/handlers/CreateHandler.js

@@ -1,196 +0,0 @@
-/**
- * CreateHandler — 处理 // as:c 指令
- * 从 FileWatcher 拆分，负责候选创建逻辑
- */
-
-import { readFileSync, writeFileSync } from 'node:fs';
-import { saveEventFilter } from '../../../platform/ios/xcode/SaveEventFilter.js';
-import { LanguageService } from '../../../shared/LanguageService.js';
-import { REGEX } from '../DirectiveDetector.js';
-
-/**
- * 处理 // as:c 指令
- * @param {import('../FileWatcher.js').FileWatcher} watcher
- * @param {string} fullPath
- * @param {string} relativePath
- * @param {string} createOption 'c' | 'f' | undefined
- */
-export async function handleCreate(watcher, fullPath, relativePath, createOption) {
-  const XA = await import('../../../platform/ios/xcode/XcodeAutomation.js');
-  const CM = await import('../../../infrastructure/external/ClipboardManager.js');
-
-  // 1. 读剪贴板（仅 -c 模式）
-  let textToExtract = '';
-  if (createOption === 'c') {
-    textToExtract = CM.read().trim();
-  }
-
-  // 2. 自动移除触发行
-  let cutSucceeded = false;
-  try {
-    const content = readFileSync(fullPath, 'utf8');
-    const lineNumber = findCreateLineNumber(content);
-
-    if (XA.isXcodeRunning() && lineNumber > 0) {
-      const savedClip = CM.read();
-      cutSucceeded = XA.cutLineInXcode(lineNumber);
-      if (cutSucceeded && savedClip) {
-        await _sleep(200);
-        CM.write(savedClip);
-      }
-    }
-
-    if (!cutSucceeded) {
-      const newContent = content.replace(REGEX.CREATE_REMOVE, '');
-      saveEventFilter.markWrite(fullPath, newContent);
-      writeFileSync(fullPath, newContent, 'utf8');
-    }
-  } catch (err) {
-    console.error('[Watcher] Failed to remove as:create mark', err.message);
-  }
-
-  // 3. 无 -c 选项：打开 Dashboard
-  if (createOption !== 'c') {
-    const autoScan = createOption === 'f' ? '&autoScan=1' : '';
-    watcher._openDashboard(`/?action=create&path=${encodeURIComponent(relativePath)}${autoScan}`);
-    return;
-  }
-
-  // 4. -c 模式：剪贴板为空则打开 Dashboard
-  if (textToExtract.length === 0) {
-    watcher._openDashboard(`/?action=create&path=${encodeURIComponent(relativePath)}`);
-    return;
-  }
-
-  // 5. -c 模式：静默创建候选
-  try {
-    await silentCreateCandidate(watcher, textToExtract, relativePath);
-  } catch (e) {
-    console.warn('[Watcher] 静默创建候选失败，回退到打开浏览器:', e.message);
-    watcher._openDashboard(
-      `/?action=create&path=${encodeURIComponent(relativePath)}&source=clipboard`
-    );
-  }
-}
-
-/**
- * 静默创建候选（从剪贴板文本解析 Recipe 并提交）
- */
-async function silentCreateCandidate(watcher, text, relativePath) {
-  const { RecipeParser } = await import('../../recipe/RecipeParser.js');
-  const parser = new RecipeParser();
-
-  const normalize = (arr) =>
-    arr.map((r) => ({
-      title: r.title,
-      summary: r.summary || r.description || '',
-      trigger: r.trigger,
-      category: r.category || 'Utility',
-      language: r.language || 'unknown',
-      code: r.code,
-      usageGuide: r.usageGuide || '',
-      headers: r.headers || [],
-    }));
-
-  // 先尝试批量解析（仅对 Recipe Markdown 格式有效）
-  const allRecipes = parser.parseAll(text);
-  const validRecipes = allRecipes.filter((r) => r.title?.trim());
-  if (validRecipes.length > 0) {
-    const items = normalize(validRecipes);
-    await watcher._resolveHeadersIfNeeded(items[0], relativePath, text);
-    await watcher._appendCandidates(items, 'watch-create');
-    const msg =
-      validRecipes.length === 1
-        ? `已创建候选「${validRecipes[0].title}」，请在 Dashboard Candidates 页审核`
-        : `已创建 ${validRecipes.length} 条候选，请在 Dashboard Candidates 页审核`;
-    watcher._notify(msg);
-    return;
-  }
-
-  // 尝试单条解析
-  if (parser.isCompleteRecipe(text)) {
-    const one = parser.parse(text);
-    if (one?.title?.trim()) {
-      const item = normalize([one])[0];
-      await watcher._resolveHeadersIfNeeded(item, relativePath, text);
-      await watcher._appendCandidates([item], 'watch-create');
-      watcher._notify(`已创建候选「${one.title}」，请在 Candidates 页审核`);
-      return;
-    }
-  }
-
-  // -c 模式：剪贴板内容整体作为一条候选（不拆分）
-  // 先用 AI 生成标题和摘要，code 保持剪贴板原文
-  const lang = relativePath ? LanguageService.inferLang(relativePath) || 'unknown' : 'unknown';
-  const ext = LanguageService.extForLang(lang) || '.txt';
-  const fileName = relativePath ? relativePath.split('/').pop() : `clipboard${ext}`;
-
-  let title = fileName.replace(/\.\w+$/, '') || 'Clipboard Snippet';
-  let summary = '';
-  let usageGuide = '';
-  let category = 'Utility';
-  let headers = [];
-  let tags = [];
-  let trigger = '';
-
-  // 尝试用 AI 生成摘要信息（但 code 始终保持原文）
-  try {
-    const { getServiceContainer } = await import('../../../injection/ServiceContainer.js');
-    const container = getServiceContainer();
-    const agentFactory = container.get('agentFactory');
-    const aiResult = await agentFactory.scanKnowledge({
-      label: title,
-      files: [{ name: title, content: text, language: lang }],
-      task: 'summarize',
-    });
-    if (aiResult && !aiResult.error) {
-      title = aiResult.title || title;
-      summary = aiResult.summary || '';
-      usageGuide = aiResult.usageGuide || '';
-      category = aiResult.category || category;
-      headers = aiResult.headers || [];
-      tags = aiResult.tags || [];
-      trigger = aiResult.trigger || '';
-    }
-  } catch {
-    /* AI 不可用，使用默认值 */
-  }
-
-  const item = {
-    title,
-    summary,
-    description: summary,
-    trigger,
-    category,
-    language: lang,
-    code: text, // 剪贴板原文整体
-    usageGuide,
-    headers,
-    tags,
-  };
-
-  await watcher._resolveHeadersIfNeeded(item, relativePath, text);
-  await watcher._appendCandidates([item], 'watch-create');
-  watcher._notify(`已创建候选「${title}」，请在 Candidates 页审核`);
-}
-
-/**
- * 查找 // as:c 的行号 (1-based)
- */
-export function findCreateLineNumber(content) {
-  if (!content) {
-    return -1;
-  }
-  const lines = content.split(/\r?\n/);
-  for (let i = 0; i < lines.length; i++) {
-    const t = lines[i].trim();
-    if (t.startsWith('// as:create') || t.startsWith('// as:c')) {
-      return i + 1;
-    }
-  }
-  return -1;
-}
-
-function _sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}

package/lib/service/automation/handlers/DraftHandler.js

@@ -1,77 +0,0 @@
-/**
- * DraftHandler — 处理 _draft_*.md 文件保存
- */
-
-import { LanguageService } from '../../../shared/LanguageService.js';
-
-/**
- * @param {import('../FileWatcher.js').FileWatcher} watcher
- * @param {string} fullPath
- * @param {string} relativePath
- * @param {string} content
- */
-export async function handleDraft(watcher, fullPath, relativePath, content) {
-  if (!content || content.trim().length < 20) {
-    return;
-  }
-
-  try {
-    const { RecipeParser } = await import('../../recipe/RecipeParser.js');
-    const parser = new RecipeParser();
-
-    const normalize = (arr) =>
-      arr.map((r) => ({
-        title: r.title,
-        summary: r.summary || r.description || '',
-        trigger: r.trigger,
-        category: r.category || 'Utility',
-        language: r.language || 'unknown',
-        code: r.code,
-        usageGuide: r.usageGuide || '',
-        headers: r.headers || [],
-      }));
-
-    const allRecipes = parser.parseAll(content);
-    if (allRecipes.length > 0) {
-      const items = normalize(allRecipes);
-      await watcher._appendCandidates(items, 'draft-file');
-      const msg =
-        allRecipes.length === 1
-          ? `已创建候选「${allRecipes[0].title}」`
-          : `已创建 ${allRecipes.length} 条候选`;
-      watcher._notify(msg);
-      return;
-    }
-
-    if (parser.isCompleteRecipe(content)) {
-      const one = parser.parse(content);
-      if (one) {
-        const item = normalize([one])[0];
-        await watcher._appendCandidates([item], 'draft-file');
-        watcher._notify(`已创建候选「${one.title}」`);
-        return;
-      }
-    }
-
-    // AI 摘要回退（通过 Agent 统一管道）
-    try {
-      const { getServiceContainer } = await import('../../../injection/ServiceContainer.js');
-      const container = getServiceContainer();
-      const agentFactory = container.get('agentFactory');
-      const lang = LanguageService.inferLang(relativePath) || 'unknown';
-      const result = await agentFactory.scanKnowledge({
-        label: relativePath,
-        files: [{ name: relativePath, content, language: lang }],
-        task: 'summarize',
-      });
-      if (result && !result.error && result.title && result.code) {
-        await watcher._appendCandidates([result], 'draft-file');
-        watcher._notify(`已创建候选「${result.title}」`);
-      }
-    } catch {
-      /* AgentFactory 不可用 */
-    }
-  } catch (e) {
-    console.warn('[Watcher] 草稿文件解析失败:', e.message);
-  }
-}

package/lib/service/automation/handlers/GuardHandler.js

@@ -1,239 +0,0 @@
-/**
- * GuardHandler — 处理 // as:a (audit/guard/lint) 指令
- *
- * 用法:
- *   // as:a          — 检查当前文件 (scope=file)
- *   // as:a file     — 同上，显式 file scope
- *   // as:a target   — 检查当前文件所在目录树 (scope=target)
- *   // as:a project  — 检查整个项目所有源文件 (scope=project)
- *   // as:a <keyword> — 检查当前文件 + 搜索相关规范
- */
-
-import { readFile } from 'node:fs/promises';
-import { dirname, extname, join } from 'node:path';
-import { LanguageService } from '../../../shared/LanguageService.js';
-
-/** 已知的 scope 关键词 */
-const SCOPE_KEYWORDS = new Set(['file', 'target', 'project', 'all']);
-
-/** 支持审计的源文件扩展名 — 委托给 LanguageService */
-const SOURCE_EXTS = LanguageService.sourceExts;
-
-/**
- * 递归收集目录下所有源文件路径
- */
-async function collectSourceFiles(dir) {
-  const { readdir } = await import('node:fs/promises');
-  const files = [];
-
-  // 跳过的目录
-  const SKIP_DIRS = new Set([
-    'node_modules',
-    '.git',
-    'build',
-    'DerivedData',
-    'Pods',
-    '.build',
-    'vendor',
-    'dist',
-    '.next',
-    'Carthage',
-    'xcuserdata',
-    '__pycache__',
-  ]);
-
-  async function walk(currentDir) {
-    let entries;
-    try {
-      entries = await readdir(currentDir, { withFileTypes: true });
-    } catch {
-      return; // 权限不足等情况跳过
-    }
-    for (const entry of entries) {
-      if (entry.name.startsWith('.') && entry.name !== '.') {
-        continue;
-      }
-      const fullPath = join(currentDir, entry.name);
-      if (entry.isDirectory()) {
-        if (!SKIP_DIRS.has(entry.name)) {
-          await walk(fullPath);
-        }
-      } else if (entry.isFile() && SOURCE_EXTS.has(extname(entry.name).toLowerCase())) {
-        files.push(fullPath);
-      }
-    }
-  }
-
-  await walk(dir);
-  return files;
-}
-
-/**
- * @param {import('../FileWatcher').default} watcher  FileWatcher 实例
- * @param {string} fullPath  当前文件绝对路径
- * @param {string} code      当前文件内容
- * @param {string} guardLine 触发行原文
- */
-export async function handleGuard(watcher, fullPath, code, guardLine) {
-  const rest = guardLine.replace(/^\/\/\s*as:(?:audit|a|lint|l|guard|g)\s*/, '').trim();
-  const scopeArg = rest.toLowerCase();
-  const isScope = SCOPE_KEYWORDS.has(scopeArg);
-  // 确定 scope：无参数或 'file' → file；'target' → target；'project'/'all' → project
-  const scope =
-    !rest || scopeArg === 'file'
-      ? 'file'
-      : scopeArg === 'target'
-        ? 'target'
-        : scopeArg === 'project' || scopeArg === 'all'
-          ? 'project'
-          : 'file'; // 非 scope 关键词回退到 file
-
-  try {
-    const { detectLanguage } = await import('../../guard/GuardCheckEngine.js');
-    const { ServiceContainer } = await import('../../../injection/ServiceContainer.js');
-    const container = ServiceContainer.getInstance();
-    const engine = container.get('guardCheckEngine');
-
-    /* ── 多文件审计 (target / project) ── */
-    if (scope === 'project' || scope === 'target') {
-      let scanRoot;
-      if (scope === 'project') {
-        scanRoot = watcher?.projectRoot;
-      } else {
-        // target: 扫描当前文件所在目录树
-        scanRoot = dirname(fullPath);
-      }
-
-      if (!scanRoot) {
-        console.warn('  ⚠️ 无法确定扫描根目录，回退到单文件检查');
-        return _auditSingleFile(watcher, engine, fullPath, code, detectLanguage, 'file');
-      }
-
-      const scopeLabel = scope === 'project' ? '整个项目' : '当前目录';
-      const sourcePaths = await collectSourceFiles(scanRoot);
-
-      if (sourcePaths.length === 0) {
-        watcher._notify?.('未找到可审计的源文件');
-        return;
-      }
-
-      // 读取所有文件内容
-      const fileEntries = [];
-      let readErrors = 0;
-      for (const p of sourcePaths) {
-        try {
-          const content = await readFile(p, 'utf-8');
-          fileEntries.push({ path: p, content });
-        } catch {
-          readErrors++;
-        }
-      }
-      if (readErrors > 0) {
-        console.warn(`  ⚠️ ${readErrors} 个文件读取失败，已跳过`);
-      }
-
-      // 批量审计（传递 scope 以启用对应维度规则）
-      const report = engine.auditFiles(fileEntries, { scope });
-      const { summary } = report;
-
-      if (summary.totalViolations === 0) {
-        watcher._notify?.(`${scopeLabel}审计通过 ✅ ${fileEntries.length} 个文件，无违规`);
-      } else {
-        watcher._notify?.(
-          `${scopeLabel}审计: ${summary.totalViolations} 个问题 (${summary.errors ?? 0} 错误, ${summary.warnings ?? 0} 警告)`
-        );
-        const filesWithIssues = report.files.filter((f) => f.summary.total > 0);
-        for (const file of filesWithIssues.slice(0, 10)) {
-          const _rel = file.filePath.replace(`${scanRoot}/`, '');
-          const errors = file.violations.filter((v) => v.severity === 'error');
-          const warnings = file.violations.filter((v) => v.severity === 'warning');
-          for (const _v of errors.slice(0, 5)) {
-          }
-          if (errors.length > 5) {
-          }
-          for (const _v of warnings.slice(0, 3)) {
-          }
-          if (warnings.length > 3) {
-          }
-        }
-        if (filesWithIssues.length > 10) {
-        }
-
-        // 跨文件问题汇总
-        if (report.crossFileViolations?.length > 0) {
-          for (const v of report.crossFileViolations.slice(0, 10)) {
-            if (v.locations) {
-              for (const loc of v.locations.slice(0, 5)) {
-                const _relLoc = loc.filePath.replace(`${scanRoot}/`, '');
-              }
-              if (v.locations.length > 5) {
-              }
-            }
-          }
-        }
-      }
-      return;
-    }
-    _auditSingleFile(watcher, engine, fullPath, code, detectLanguage, scope);
-
-    // 如果有非 scope 关键词，也做语义搜索
-    if (rest && !isScope) {
-      try {
-        const searchEngine = container.get('searchEngine');
-        const results = await searchEngine.search(rest, { limit: 3, mode: 'keyword' });
-        const items = Array.isArray(results) ? results : results.items || [];
-        if (items.length > 0) {
-          for (const _r of items) {
-          }
-        }
-      } catch {
-        // 搜索失败不阻塞
-      }
-    }
-  } catch (err) {
-    console.warn(`  ⚠️ Guard 检查失败: ${err.message}`);
-  }
-}
-
-/**
- * 检查单个文件并打印结果
- */
-function _auditSingleFile(watcher, engine, fullPath, code, detectLanguage, scope = 'file') {
-  const language = detectLanguage(fullPath);
-  const violations = engine.checkCode(code, language, { scope });
-
-  if (violations.length === 0) {
-    watcher._notify?.('审计通过 ✅ 无违规');
-  } else {
-    const errors = violations.filter((v) => v.severity === 'error');
-    const warnings = violations.filter((v) => v.severity === 'warning');
-    watcher._notify?.(
-      `审计: ${violations.length} 个问题 (${errors.length} 错误, ${warnings.length} 警告)`
-    );
-    for (const v of errors) {
-      if (v.fixSuggestion) {
-      }
-    }
-    for (const v of warnings.slice(0, 5)) {
-      if (v.fixSuggestion) {
-      }
-    }
-    if (warnings.length > 5) {
-    }
-  }
-
-  // Guard ↔ Recipe 闭环：检测修复并自动确认使用（fire-and-forget）
-  import('../../../injection/ServiceContainer.js')
-    .then(({ ServiceContainer }) => {
-      try {
-        const container = ServiceContainer.getInstance();
-        const feedbackLoop = container.get('guardFeedbackLoop');
-        feedbackLoop.processFixDetection({ violations }, fullPath);
-      } catch {
-        /* guardFeedbackLoop not available */
-      }
-    })
-    .catch(() => {
-      /* ignored */
-    });
-}

package/lib/service/automation/handlers/HeaderHandler.js

@@ -1,51 +0,0 @@
-/**
- * HeaderHandler — 处理 // as:include / // as:import 指令
- */
-
-import { readFileSync } from 'node:fs';
-import { basename } from 'node:path';
-
-/**
- * @param {import('../FileWatcher.js').FileWatcher} watcher
- * @param {string} fullPath
- * @param {string} headerLine
- * @param {string[]} importArray
- * @param {boolean} isSwift
- */
-export async function handleHeader(watcher, fullPath, headerLine, importArray, isSwift) {
-  try {
-    const HeaderResolver = await import('../../../infrastructure/paths/HeaderResolver.js');
-    const parsed = HeaderResolver.parseImportLine(headerLine);
-
-    if (!parsed) {
-      return;
-    }
-
-    const resolved = await HeaderResolver.resolveHeadersForText(
-      watcher.projectRoot,
-      basename(fullPath),
-      readFileSync(fullPath, 'utf8')
-    );
-
-    if (!resolved || !resolved.headers || resolved.headers.length === 0) {
-      return;
-    }
-
-    const { insertHeaders } = await import('../../../platform/ios/xcode/XcodeIntegration.js');
-    const result = await insertHeaders(watcher, fullPath, resolved.headers, {
-      isSwift,
-      moduleName: resolved.moduleName || null,
-    });
-
-    if (result.cancelled) {
-      return;
-    }
-    if (result.inserted.length === 0 && result.skipped.length > 0) {
-    }
-  } catch (err) {
-    console.warn(`  ⚠️ Header 处理失败: ${err.message}`);
-    if (process.env.ASD_DEBUG === '1') {
-      console.error(err.stack);
-    }
-  }
-}