autosnippet 3.2.9 → 3.2.11

package/dist/lib/service/automation/handlers/SearchHandler.js

@@ -0,0 +1,289 @@
+/**
+ * SearchHandler — 处理 // as:s 指令
+ */
+import Logger from '#infra/logging/Logger.js';
+/**
+ * @param {import('../FileWatcher.js').FileWatcher} watcher
+ * @param {string} fullPath
+ * @param {string} relativePath
+ * @param {string} searchLine
+ */
+export async function handleSearch(watcher, fullPath, relativePath, searchLine) {
+    const query = searchLine.replace(/^\/\/\s*(?:autosnippet|as):(?:search|s)\s*/, '').trim();
+    if (!query) {
+        return;
+    }
+    let results = [];
+    try {
+        const { ServiceContainer } = await import('../../../injection/ServiceContainer.js');
+        const container = ServiceContainer.getInstance();
+        const searchEngine = container.get('searchEngine');
+        // 确保索引已构建
+        searchEngine.ensureIndex();
+        // auto (BM25+semantic 融合 + Ranking Pipeline) → keyword (SQL LIKE) 降级链
+        // Xcode/IDE 场景: 传递 generate intent，让排序器使用代码生成权重
+        try {
+            results = await searchEngine.search(query, {
+                limit: 10,
+                mode: 'auto',
+                rank: true,
+                context: { intent: 'generate' },
+            });
+            // auto 零结果 → keyword (SQL LIKE) 兆底
+            if (!results ||
+                (Array.isArray(results)
+                    ? results
+                    : results.items || []).length === 0) {
+                results = await searchEngine.search(query, { limit: 10, mode: 'keyword' });
+            }
+        }
+        catch {
+            try {
+                results = await searchEngine.search(query, { limit: 10, mode: 'keyword' });
+            }
+            catch {
+                /* 全部失败 */
+            }
+        }
+    }
+    catch (err) {
+        Logger.getInstance().warn('搜索失败', { query, error: err.message });
+        watcher._notify(`搜索「${query}」失败: ${err.message}`);
+        return;
+    }
+    const items = normalizeSearchResults(results);
+    // Xcode 代码插入场景: 有实际代码的结果优先展示
+    items.sort((a, b) => {
+        const aHasCode = a.code && a.code !== '(无预览内容)' && a.code.length > 30 ? 1 : 0;
+        const bHasCode = b.code && b.code !== '(无预览内容)' && b.code.length > 30 ? 1 : 0;
+        return bHasCode - aHasCode;
+    });
+    if (items.length === 0) {
+        watcher._notify(`未找到「${query}」的相关结果`);
+        return;
+    }
+    // NativeUI 交互选择
+    const NU = await import('../../../infrastructure/external/NativeUi.js');
+    const selectedIndex = NU.showCombinedWindow(items, query);
+    if (selectedIndex < 0 || selectedIndex >= items.length) {
+        return;
+    }
+    const selected = items[selectedIndex];
+    // 如果 selected 没有 moduleName，尝试从当前文件路径推断
+    if (!selected.moduleName && selected.headers && selected.headers.length > 0) {
+        try {
+            const HeaderResolver = await import('../../../infrastructure/paths/HeaderResolver.js');
+            const resolved = await HeaderResolver.resolveHeadersForText(watcher.projectRoot, relativePath, (await import('node:fs')).readFileSync(fullPath, 'utf8'));
+            if (resolved?.moduleName) {
+                selected.moduleName = resolved.moduleName;
+            }
+        }
+        catch {
+            /* 解析失败不阻塞 */
+        }
+    }
+    // Xcode 代码自动插入（osascript 跳转 + 粘贴）
+    const { insertCodeToXcode } = await import('../../../platform/ios/xcode/XcodeIntegration.js');
+    await insertCodeToXcode(watcher, fullPath, selected, searchLine);
+}
+/**
+ * 将搜索结果标准化为 NativeUI 可展示格式
+ */
+export function normalizeSearchResults(results) {
+    if (!results) {
+        return [];
+    }
+    const arr = Array.isArray(results)
+        ? results
+        : results.items || [];
+    return arr
+        .map((r) => {
+        let code = '';
+        let explanation = '';
+        let headers = [];
+        if (r.content) {
+            try {
+                const content = typeof r.content === 'string' ? JSON.parse(r.content) : r.content;
+                // 注意: 不直接使用 content.markdown —— markdown 是完整文档，不是纯代码
+                code =
+                    content.code ||
+                        content.pattern ||
+                        content.content ||
+                        content.body ||
+                        content.snippet ||
+                        content.solution ||
+                        content.example ||
+                        '';
+                explanation =
+                    content.rationale ||
+                        content.description ||
+                        content.summary ||
+                        content.explanation ||
+                        '';
+                if (Array.isArray(content.headers) && content.headers.length > 0) {
+                    headers = content.headers;
+                }
+                // 如果主字段为空，尝试从 Markdown 内容提取代码块
+                if (!code && content.markdown) {
+                    code = _extractCodeFromMarkdown(content.markdown);
+                    // 若 markdown 中提取不出代码，且 explanation 为空，用 markdown 生成摘要
+                    if (!code && !explanation) {
+                        explanation = _stripMarkdownFormatting(content.markdown).substring(0, 500);
+                    }
+                }
+            }
+            catch {
+                // content 不是 JSON，可能是纯文本/代码 — 直接使用
+                if (typeof r.content === 'string' && r.content.length > 10) {
+                    code = r.content.substring(0, 2000);
+                }
+            }
+        }
+        // 如果 Ranking Pipeline 已提取 code 字段，优先使用
+        if (!code && r.code && r.code.length > 5) {
+            code = r.code;
+        }
+        // V3: headers 是独立 JSON 列（字符串），优先解析
+        if (headers.length === 0 && r.headers) {
+            try {
+                const parsed = typeof r.headers === 'string' ? JSON.parse(r.headers) : r.headers;
+                if (Array.isArray(parsed) && parsed.length > 0) {
+                    headers = parsed;
+                }
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        // moduleName: 优先从独立列取
+        let moduleName = r.moduleName || null;
+        if (!moduleName && r.content) {
+            try {
+                const content = typeof r.content === 'string' ? JSON.parse(r.content) : r.content;
+                moduleName = content.moduleName || null;
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        if (!moduleName) {
+            moduleName = r.moduleName || null;
+        }
+        // ── 从 code 中分离 #import / @import / import 行，归入 headers ──
+        const finalCode = code || r.code || r.description || r.trigger || '(无预览内容)';
+        const { cleanedCode, extractedHeaders } = _separateImportsFromCode(String(finalCode));
+        if (extractedHeaders.length > 0) {
+            for (const h of extractedHeaders) {
+                if (!headers.some((existing) => existing.trim() === h.trim())) {
+                    headers.push(h);
+                }
+            }
+        }
+        return {
+            title: r.title || r.name || r.id || 'Recipe',
+            code: cleanedCode || '(无预览内容)',
+            explanation: explanation || r.summary || r.description || '',
+            headers,
+            moduleName,
+            trigger: r.trigger || r.completionKey || '',
+        };
+    })
+        .filter((item) => item.title);
+}
+/**
+ * 从代码文本中分离出 import/include 行
+ *
+ * 只提取位于代码开头的连续 import 块（含中间空行），
+ * 代码正文中的 import（如注释或字符串里的）不做处理。
+ *
+ * 支持: #import, @import, #include, import (Swift)
+ */
+function _separateImportsFromCode(code) {
+    if (!code || code === '(无预览内容)') {
+        return { cleanedCode: code, extractedHeaders: [] };
+    }
+    const lines = code.split(/\r?\n/);
+    const importRe = /^\s*(#import\s|@import\s|#include\s|import\s)/;
+    const extractedHeaders = [];
+    let lastImportIdx = -1;
+    // 从开头扫描连续 import 块（允许中间有空行）
+    for (let i = 0; i < lines.length; i++) {
+        const trimmed = lines[i].trim();
+        if (!trimmed) {
+            // 空行：如果前面已有 import，继续扫描
+            if (lastImportIdx >= 0) {
+                continue;
+            }
+            // 前面没 import，遇到前导空行也继续
+            continue;
+        }
+        if (importRe.test(trimmed)) {
+            extractedHeaders.push(trimmed);
+            lastImportIdx = i;
+        }
+        else {
+            // 遇到非 import 非空行，停止扫描
+            break;
+        }
+    }
+    if (extractedHeaders.length === 0) {
+        return { cleanedCode: code, extractedHeaders: [] };
+    }
+    // 移除开头的 import 行和紧随的空行
+    const remaining = lines.slice(lastImportIdx + 1);
+    // 去掉残留的前导空行
+    while (remaining.length > 0 && !remaining[0].trim()) {
+        remaining.shift();
+    }
+    const cleanedCode = remaining.join('\n').trim();
+    return { cleanedCode, extractedHeaders };
+}
+/**
+ * 从 Markdown 文本中提取所有 fenced code blocks，合并为纯代码
+ *
+ * 支持 ```lang\n...\n``` 格式，提取多个代码块并用空行分隔。
+ * 如果没有找到代码块，返回空字符串。
+ *
+ * @param {string} md - Markdown 文本
+ * @returns {string} 提取出的纯代码，或空字符串
+ */
+function _extractCodeFromMarkdown(md) {
+    if (!md) {
+        return '';
+    }
+    const fencedRe = /```[\w]*\n([\s\S]*?)```/g;
+    const blocks = [];
+    let match;
+    while ((match = fencedRe.exec(md)) !== null) {
+        const block = match[1].trim();
+        if (block) {
+            blocks.push(block);
+        }
+    }
+    return blocks.join('\n\n');
+}
+/**
+ * 移除 Markdown 格式标记，返回纯文本摘要
+ *
+ * 用于在无法提取代码时，从 markdown 生成 explanation 文本。
+ *
+ * @param {string} md - Markdown 文本
+ * @returns {string} 纯文本
+ */
+function _stripMarkdownFormatting(md) {
+    if (!md) {
+        return '';
+    }
+    return md
+        .replace(/```[\w]*\n[\s\S]*?```/g, '') // 移除代码块
+        .replace(/^#{1,6}\s+/gm, '') // 移除标题标记
+        .replace(/\*\*([^*]+)\*\*/g, '$1') // 移除粗体
+        .replace(/\*([^*]+)\*/g, '$1') // 移除斜体
+        .replace(/`([^`]+)`/g, '$1') // 移除行内代码
+        .replace(/^\s*[-*+]\s+/gm, '') // 移除列表标记
+        .replace(/^\s*\d+\.\s+/gm, '') // 移除有序列表
+        .replace(/\[([^\]]+)\]\([^)]+\)/g, '$1') // 移除链接，保留文字
+        .replace(/\n{3,}/g, '\n\n') // 压缩多余空行
+        .trim();
+}
+//# sourceMappingURL=SearchHandler.js.map

package/dist/lib/service/automation/handlers/SearchHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchHandler.js","sourceRoot":"","sources":["../../../../../lib/service/automation/handlers/SearchHandler.ts"],"names":[],"mappings":"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"}

package/dist/lib/service/bootstrap/BootstrapTaskManager.d.ts

@@ -0,0 +1,189 @@
+/**
+ * BootstrapTaskManager — 冷启动异步任务管理器
+ *
+ * 核心职责：
+ *   1. 管理 bootstrap 异步任务的生命周期（skeleton → filling → completed）
+ *   2. 通过 EventBus 发射进度事件
+ *   3. 通过 RealtimeService 推送进度到前端 (Socket.io)
+ *   4. 支持查询当前 bootstrap 会话状态
+ *
+ * 任务状态流:
+ *   skeleton → filling → completed / failed
+ *
+ * 事件类型:
+ *   bootstrap:started      — 冷启动开始，携带任务清单
+ *   bootstrap:task-started  — 单个维度/Skill 开始填充
+ *   bootstrap:task-completed — 单个维度/Skill 填充完成
+ *   bootstrap:task-failed   — 单个任务失败
+ *   bootstrap:all-completed — 全部任务完成
+ */
+import type { EventBus } from '../../infrastructure/event/EventBus.js';
+interface TaskMeta {
+    type?: string;
+    dimId?: string;
+    label?: string;
+    skillWorthy?: boolean;
+    [key: string]: unknown;
+}
+interface TaskInfo {
+    id: string;
+    status: string;
+    meta: TaskMeta;
+    startedAt: number | null;
+    completedAt: number | null;
+    result: Record<string, unknown> | null;
+    error: string | null;
+}
+interface TaskDef {
+    id: string;
+    meta: TaskMeta;
+}
+interface BootstrapTaskManagerOpts {
+    eventBus?: EventBus | null;
+    getRealtimeService?: (() => {
+        broadcastEvent(name: string, data: unknown): void;
+    } | null) | null;
+}
+/** 任务状态枚举 */
+export declare const TaskStatus: Readonly<{
+    SKELETON: "skeleton";
+    FILLING: "filling";
+    COMPLETED: "completed";
+    FAILED: "failed";
+}>;
+/**
+ * 单个 Bootstrap 会话（一次冷启动的全部上下文）
+ */
+declare class BootstrapSession {
+    completedAt: number | null;
+    id: string;
+    startedAt: number;
+    status: string;
+    summary: Record<string, unknown> | null;
+    tasks: Map<string, TaskInfo>;
+    constructor(sessionId: string);
+    addTask(taskId: string, meta: TaskMeta): void;
+    getTask(taskId: string): TaskInfo | undefined;
+    get totalTasks(): number;
+    get completedTasks(): number;
+    get failedTasks(): number;
+    get fillingTasks(): number;
+    get skeletonTasks(): number;
+    get isAllDone(): boolean;
+    get totalToolCalls(): number;
+    get progress(): number;
+    toJSON(): {
+        id: string;
+        status: string;
+        startedAt: number;
+        completedAt: number | null;
+        progress: number;
+        total: number;
+        completed: number;
+        failed: number;
+        filling: number;
+        skeleton: number;
+        totalToolCalls: number;
+        tasks: {
+            id: string;
+            status: string;
+            meta: TaskMeta;
+            startedAt: number | null;
+            completedAt: number | null;
+            result: Record<string, unknown> | null;
+            error: string | null;
+        }[];
+        summary: Record<string, unknown> | null;
+    };
+}
+export declare class BootstrapTaskManager {
+    #private;
+    constructor({ eventBus, getRealtimeService }?: BootstrapTaskManagerOpts);
+    /**
+     * 启动新的 bootstrap 会话
+     *
+     * 如果上一个会话仍在运行，自动 abort 后再创建新会话（防止重复触发产出重复 Candidate）。
+     *
+     * @param {Array<{id: string, meta: object}>} taskDefs 任务定义列表
+     * @returns {BootstrapSession}
+     */
+    startSession(taskDefs: TaskDef[]): BootstrapSession;
+    /**
+     * 中止当前 bootstrap 会话
+     *
+     * 将所有未完成的任务标记为 failed，并将 session 标记为 aborted。
+     * 异步填充函数通过 `isSessionValid(sessionId)` 检测到 session 已变更后自动退出。
+     *
+     * @param {string} [reason='Aborted by user']
+     */
+    abortSession(reason?: string): void;
+    /**
+     * 验证 sessionId 是否仍然是活跃 session
+     *
+     * 用于异步填充函数在每次循环迭代前检测：如果 session 已被新请求覆盖，
+     * 则当前异步填充应立即停止，避免产出重复内容。
+     *
+     * @param {string} sessionId
+     * @returns {boolean}
+     */
+    isSessionValid(sessionId: string): boolean;
+    /**
+     * 标记单个任务开始填充
+     */
+    markTaskFilling(taskId: string): void;
+    /**
+     * 标记单个任务完成
+     * @param {string} taskId
+     * @param {object} result 填充结果摘要 { created, items, ... }
+     */
+    markTaskCompleted(taskId: string, result?: Record<string, unknown>): void;
+    /**
+     * 标记单个任务失败
+     */
+    markTaskFailed(taskId: string, error: unknown): void;
+    /**
+     * 获取当前 session 状态（供 HTTP 轮询）
+     */
+    getSessionStatus(): {
+        id: string;
+        status: string;
+        startedAt: number;
+        completedAt: number | null;
+        progress: number;
+        total: number;
+        completed: number;
+        failed: number;
+        filling: number;
+        skeleton: number;
+        totalToolCalls: number;
+        tasks: {
+            id: string;
+            status: string;
+            meta: TaskMeta;
+            startedAt: number | null;
+            completedAt: number | null;
+            result: Record<string, unknown> | null;
+            error: string | null;
+        }[];
+        summary: Record<string, unknown> | null;
+    } | {
+        status: string;
+        message: string;
+    };
+    /**
+     * 是否有正在进行的 bootstrap
+     */
+    get isRunning(): boolean;
+    /**
+     * 向 EventBus + Socket.io 发射任意进度事件
+     *
+     * 用途：不走 bootstrap session 模型的长操作（如 AI 润色）也能复用
+     * 同一套 EventBus + RealtimeService 双通道推送。
+     *
+     * @param {string} eventName 事件名（如 'refine:started'）
+     * @param {object} data      事件负载
+     */
+    emitProgress(eventName: string, data: unknown): void;
+}
+export {};
+//# sourceMappingURL=BootstrapTaskManager.d.ts.map

package/dist/lib/service/bootstrap/BootstrapTaskManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BootstrapTaskManager.d.ts","sourceRoot":"","sources":["../../../../lib/service/bootstrap/BootstrapTaskManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AAGvE,UAAU,QAAQ;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,QAAQ;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,UAAU,OAAO;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,UAAU,wBAAwB;IAChC,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC3B,kBAAkB,CAAC,EAAE,CAAC,MAAM;QAAE,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;CAClG;AAED,aAAa;AACb,eAAO,MAAM,UAAU;;;;;EAKrB,CAAC;AAEH;;GAEG;AACH,cAAM,gBAAgB;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;gBACjB,SAAS,EAAE,MAAM;IAS7B,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ;IAYtC,OAAO,CAAC,MAAM,EAAE,MAAM;IAItB,IAAI,UAAU,WAEb;IACD,IAAI,cAAc,WAEjB;IACD,IAAI,WAAW,WAEd;IACD,IAAI,YAAY,WAEf;IACD,IAAI,aAAa,WAEhB;IAED,IAAI,SAAS,YAEZ;IAED,IAAI,cAAc,WAQjB;IAED,IAAI,QAAQ,WAMX;IAED,MAAM;;;;;;;;;;;;;;;;;;;;;;;CAyBP;AAED,qBAAa,oBAAoB;;gBAWnB,EAAE,QAAQ,EAAE,kBAAkB,EAAE,GAAE,wBAA6B;IAS3E;;;;;;;OAOG;IACH,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE;IA2BhC;;;;;;;OAOG;IACH,YAAY,CAAC,MAAM,SAAoB;IAwCvC;;;;;;;;OAQG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM;IAWhC;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM;IAsB9B;;;;OAIG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAmCtE;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;IAkC7C;;OAEG;IACH,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;IAOhB;;OAEG;IACH,IAAI,SAAS,YAEZ;IAMD;;;;;;;;OAQG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;CAoE9C"}