autosnippet 3.2.22 → 3.3.0

package/dist/lib/service/automation/FileWatcher.d.ts

@@ -1,51 +0,0 @@
-/**
- * FileWatcher - V2 文件监听主服务（精简版）
- *
- * 监控项目文件变更，检测 // as:c、// as:s、// as:a 等指令并自动处理。
- * 具体指令逻辑已拆分至 handlers/ 和 XcodeIntegration.js。
- *
- * 用法：
- *   const watcher = new FileWatcher(specPath, projectRoot, { quiet: false });
- *   watcher.start();
- */
-export declare class FileWatcher {
-    _debounceTimers: Map<string, ReturnType<typeof setTimeout>>;
-    _timeoutHead: ReturnType<typeof setTimeout> | undefined;
-    _timeoutLink: ReturnType<typeof setTimeout> | undefined;
-    _watcher: import('chokidar').FSWatcher | null;
-    exts: string[] | null;
-    onEvent: ((event: string, path: string) => void) | null;
-    pathPrefix: string | null;
-    projectRoot: string;
-    quiet: boolean;
-    specPath: string;
-    /**
-     * @param specPath boxspec.json 绝对路径
-     * @param projectRoot 项目根目录
-     * @param [opts.exts] 可选扩展名列表
-     * @param [opts.pathPrefix] 可选路径前缀过滤
-     * @param [opts.onEvent] 可选事件回调
-     */
-    constructor(specPath: string, projectRoot: string, opts?: {
-        quiet?: boolean;
-        pathPrefix?: string;
-        onEvent?: ((event: string, path: string) => void) | null;
-        exts?: string[];
-    });
-    /** 启动文件监听 */
-    start(): import("chokidar").FSWatcher;
-    /** 停止监听，释放所有资源 */
-    stop(): Promise<void>;
-    _processFile(fullPath: string, relativePath: string): Promise<void>;
-    /** 追加候选项（通过 ServiceContainer 或 HTTP API） */
-    _appendCandidates(items: Record<string, unknown>[], source: string): Promise<void>;
-    /** 为候选解析头文件 */
-    _resolveHeadersIfNeeded(item: Record<string, unknown>, relativePath: string, text: string): Promise<void>;
-    /** 打开 Dashboard 页面 */
-    _openDashboard(path: string): void;
-    /** macOS 通知 */
-    _notify(msg: string): void;
-    /** 防抖 */
-    _debounce(key: string, fn: () => void): void;
-}
-export default FileWatcher;

package/dist/lib/service/automation/FileWatcher.js

@@ -1,366 +0,0 @@
-/**
- * FileWatcher - V2 文件监听主服务（精简版）
- *
- * 监控项目文件变更，检测 // as:c、// as:s、// as:a 等指令并自动处理。
- * 具体指令逻辑已拆分至 handlers/ 和 XcodeIntegration.js。
- *
- * 用法：
- *   const watcher = new FileWatcher(specPath, projectRoot, { quiet: false });
- *   watcher.start();
- */
-import { accessSync, readFileSync, statSync } from 'node:fs';
-import { basename, join, normalize } from 'node:path';
-import { watch as chokidarWatch } from 'chokidar';
-import { saveEventFilter } from '../../platform/ios/xcode/SaveEventFilter.js';
-import { FILE_WATCHER } from '../../shared/constants.js';
-import { detectTriggers, REGEX } from './DirectiveDetector.js';
-import { handleAlink } from './handlers/AlinkHandler.js';
-/* ── Handler imports ── */
-import { handleCreate } from './handlers/CreateHandler.js';
-import { handleGuard } from './handlers/GuardHandler.js';
-import { handleHeader } from './handlers/HeaderHandler.js';
-import { handleSearch } from './handlers/SearchHandler.js';
-/* ────────── 配置 ────────── */
-const DEFAULT_FILE_PATTERN = [
-    // ObjC/Swift
-    '**/*.m',
-    '**/*.h',
-    '**/*.mm',
-    '**/*.swift',
-    // JS/TS
-    '**/*.js',
-    '**/*.ts',
-    '**/*.jsx',
-    '**/*.tsx',
-    '**/*.vue',
-    '**/*.svelte',
-    // Python
-    '**/*.py',
-    // JVM
-    '**/*.java',
-    '**/*.kt',
-    '**/*.kts',
-    // Other languages
-    '**/*.go',
-    '**/*.rs',
-    '**/*.rb',
-    // C/C++
-    '**/*.c',
-    '**/*.cpp',
-    '**/*.cc',
-    '**/*.hpp',
-];
-const IGNORED = [
-    '**/node_modules/**',
-    '**/.git/**',
-    '**/.mgit/**',
-    '**/.easybox/**',
-    '**/xcuserdata/**',
-    '**/.build/**',
-    '**/*.swp',
-    '**/*.tmp',
-    '**/*~.m',
-    '**/*~.h',
-    '**/DerivedData/**',
-    '**/Pods/**',
-    '**/Carthage/**',
-    '**/__pycache__/**',
-    '**/.venv/**',
-    '**/venv/**',
-    '**/build/**',
-    '**/target/**',
-    '**/.gradle/**',
-    '**/dist/**',
-    '**/.next/**',
-    '**/.nuxt/**',
-];
-const DEBOUNCE_DELAY = FILE_WATCHER.DEBOUNCE_DELAY_MS;
-/* ────────── FileWatcher ────────── */
-export class FileWatcher {
-    _debounceTimers;
-    _timeoutHead;
-    _timeoutLink;
-    _watcher;
-    exts;
-    onEvent;
-    pathPrefix;
-    projectRoot;
-    quiet;
-    specPath;
-    /**
-     * @param specPath boxspec.json 绝对路径
-     * @param projectRoot 项目根目录
-     * @param [opts.exts] 可选扩展名列表
-     * @param [opts.pathPrefix] 可选路径前缀过滤
-     * @param [opts.onEvent] 可选事件回调
-     */
-    constructor(specPath, projectRoot, opts = {}) {
-        this.specPath = specPath;
-        this.projectRoot = projectRoot;
-        this.quiet = !!opts.quiet;
-        this.pathPrefix = opts.pathPrefix || null;
-        this.onEvent = opts.onEvent || null;
-        this.exts = opts.exts || null;
-        this._debounceTimers = new Map();
-        this._watcher = null;
-        this._timeoutLink = undefined;
-        this._timeoutHead = undefined;
-    }
-    /** 启动文件监听 */
-    start() {
-        const watchRoot = this.projectRoot;
-        const filePattern = this.exts
-            ? this.exts.map((e) => `**/*${e.startsWith('.') ? e : `.${e}`}`)
-            : DEFAULT_FILE_PATTERN;
-        if (!this.quiet) {
-        }
-        this._watcher = chokidarWatch(filePattern, {
-            cwd: watchRoot,
-            ignored: IGNORED,
-            ignoreInitial: true,
-            persistent: true,
-        });
-        const handleEvent = (relativePath) => {
-            const fullPath = join(watchRoot, relativePath);
-            if (process.env.ASD_DEBUG === '1') {
-            }
-            if (this.pathPrefix && !normalize(relativePath).startsWith(normalize(this.pathPrefix))) {
-                return;
-            }
-            this._debounce(fullPath, () => {
-                this._processFile(fullPath, relativePath);
-            });
-        };
-        this._watcher.on('change', handleEvent);
-        this._watcher.on('add', handleEvent);
-        this._watcher.on('error', (err) => {
-            const msg = err instanceof Error ? err.message : String(err);
-            console.error('文件监听错误:', msg);
-        });
-        this._watcher.on('ready', () => {
-            if (!this.quiet) {
-            }
-            if (process.env.ASD_DEBUG === '1') {
-            }
-        });
-        return this._watcher;
-    }
-    /** 停止监听，释放所有资源 */
-    async stop() {
-        if (this._watcher) {
-            // 移除所有事件监听器，避免泄漏
-            this._watcher.removeAllListeners();
-            await this._watcher.close();
-            this._watcher = null;
-        }
-        // 清理所有防抖定时器
-        for (const timer of this._debounceTimers.values()) {
-            clearTimeout(timer);
-        }
-        this._debounceTimers.clear();
-        // 清理 handler 级别的延时定时器
-        if (this._timeoutLink) {
-            clearTimeout(this._timeoutLink);
-            this._timeoutLink = undefined;
-        }
-        if (this._timeoutHead) {
-            clearTimeout(this._timeoutHead);
-            this._timeoutHead = undefined;
-        }
-    }
-    /* ────────── 内部：文件处理（分派到 handlers） ────────── */
-    async _processFile(fullPath, relativePath) {
-        try {
-            accessSync(fullPath);
-            const stat = statSync(fullPath);
-            if (stat.isDirectory() || stat.size > FILE_WATCHER.MAX_FILE_SIZE_BYTES) {
-                return;
-            }
-        }
-        catch {
-            return;
-        }
-        let data;
-        try {
-            data = readFileSync(fullPath, 'utf8');
-        }
-        catch (err) {
-            console.error(`❌ 读取文件失败: ${fullPath}`, err.message);
-            return;
-        }
-        // ── 保存事件过滤：self-write / 内容未变 / Xcode 非前台 ──
-        const verdict = saveEventFilter.shouldProcess(fullPath, data);
-        if (!verdict.process) {
-            if (process.env.ASD_DEBUG === '1') {
-            }
-            return;
-        }
-        if (process.env.ASD_DEBUG === '1') {
-        }
-        const filename = basename(fullPath);
-        // 检测指令
-        const triggers = detectTriggers(data, filename);
-        if (process.env.ASD_DEBUG === '1') {
-        }
-        // // as:c — 创建候选
-        if (triggers.createLine) {
-            await handleCreate(this, fullPath, relativePath, triggers.createOption);
-        }
-        // // as:a — Guard 检查
-        if (triggers.guardLine) {
-            await handleGuard(this, fullPath, data, triggers.guardLine);
-        }
-        // // as:s — 搜索
-        if (triggers.searchLine) {
-            await handleSearch(this, fullPath, relativePath, triggers.searchLine);
-        }
-        // alink
-        if (triggers.alinkLine) {
-            clearTimeout(this._timeoutLink);
-            this._timeoutLink = setTimeout(() => {
-                handleAlink(triggers.alinkLine).catch((err) => {
-                    console.warn(`[Watcher] alink handler failed: ${err.message}`);
-                });
-            }, DEBOUNCE_DELAY);
-        }
-        // ── 更新内容哈希（处理完毕后记录状态，供下次变更比对） ──
-        saveEventFilter.updateHash(fullPath, data);
-        // header 指令
-        if (triggers.headerLine) {
-            const isMatch = triggers.isSwift
-                ? REGEX.HEADER_SWIFT.test(triggers.headerLine)
-                : REGEX.HEADER_OBJC.test(triggers.headerLine);
-            if (isMatch) {
-                clearTimeout(this._timeoutHead);
-                this._timeoutHead = setTimeout(() => {
-                    handleHeader(this, fullPath, triggers.headerLine, triggers.importArray, triggers.isSwift).catch((err) => {
-                        console.warn(`[Watcher] header handler failed: ${err.message}`);
-                    });
-                }, DEBOUNCE_DELAY);
-            }
-        }
-    }
-    /* ────────── 工具方法（供 handlers 通过 watcher 引用调用） ────────── */
-    /** 追加候选项（通过 ServiceContainer 或 HTTP API） */
-    async _appendCandidates(items, source) {
-        // 过滤空 title / 空 code 的无效条目
-        const validItems = items.filter((item) => {
-            const title = String(item.title || '').trim();
-            const code = String(item.code || '').trim();
-            if (!title || !code) {
-                console.warn(`[Watcher] 跳过无效候选: title=${JSON.stringify(title)}, code length=${code.length}`);
-                return false;
-            }
-            return true;
-        });
-        if (validItems.length === 0) {
-            throw new Error('所有候选条目缺少 title 或 code，无法提交');
-        }
-        // 优先 ServiceContainer
-        let serviceError = null;
-        try {
-            const { ServiceContainer } = await import('../../injection/ServiceContainer.js');
-            const container = ServiceContainer.getInstance();
-            const knowledgeService = container.get('knowledgeService');
-            const context = { userId: 'filewatcher' };
-            for (const item of validItems) {
-                await knowledgeService.create({
-                    content: {
-                        pattern: String(item.code || ''),
-                    },
-                    language: String(item.language || 'objc'),
-                    category: String(item.category || 'Utility'),
-                    source: source || 'watch',
-                    title: String(item.title || ''),
-                    description: String(item.summary || item.description || ''),
-                    moduleName: String(item.moduleName || 'watch-create'),
-                    trigger: String(item.trigger || ''),
-                    headers: (item.headers || []),
-                    tags: (item.tags || []),
-                }, context);
-            }
-            return;
-        }
-        catch (err) {
-            serviceError = err;
-            console.warn('[Watcher] KnowledgeService 创建失败，尝试 HTTP 回退:', err.message);
-        }
-        // 回退：HTTP API（使用 knowledge 端点而非 candidates）
-        const dashboardUrl = process.env.ASD_DASHBOARD_URL || 'http://localhost:3000';
-        try {
-            for (const item of validItems) {
-                const resp = await fetch(`${dashboardUrl}/api/v1/knowledge`, {
-                    method: 'POST',
-                    headers: { 'Content-Type': 'application/json' },
-                    body: JSON.stringify({
-                        title: item.title,
-                        content: { pattern: item.code || '' },
-                        language: item.language || 'objc',
-                        category: item.category || 'Utility',
-                        source: source || 'watch',
-                        description: item.summary || item.description || '',
-                        moduleName: item.moduleName || 'watch-create',
-                        trigger: item.trigger || '',
-                        headers: item.headers || [],
-                    }),
-                });
-                if (!resp.ok) {
-                    throw new Error(`HTTP ${resp.status}`);
-                }
-            }
-            return;
-        }
-        catch (err) {
-            console.warn(`[Watcher] HTTP 候选提交也失败: ${err.message}`);
-        }
-        // 两条路径都失败 → 抛出原始错误
-        throw serviceError || new Error('候选提交失败：ServiceContainer 和 HTTP 均不可用');
-    }
-    /** 为候选解析头文件 */
-    async _resolveHeadersIfNeeded(item, relativePath, text) {
-        if (relativePath && (!item.headers || !item.headers.length)) {
-            try {
-                const HeaderResolver = await import('../../platform/ios/xcode/HeaderResolver.js');
-                const resolved = await HeaderResolver.resolveHeadersForText(this.projectRoot, relativePath, text);
-                if (resolved?.headers && resolved.headers.length > 0) {
-                    item.headers = resolved.headers;
-                    item.headerPaths = resolved.headerPaths;
-                    item.moduleName = resolved.moduleName;
-                }
-            }
-            catch {
-                // 头文件解析失败不阻塞
-            }
-        }
-    }
-    /** 打开 Dashboard 页面 */
-    _openDashboard(path) {
-        const base = process.env.ASD_DASHBOARD_URL || 'http://localhost:3000';
-        const url = `${base}${path}`;
-        import('../../platform/OpenBrowser.js')
-            .then(({ openBrowserReuseTab }) => openBrowserReuseTab(url, base))
-            .catch(() => { });
-    }
-    /** macOS 通知 */
-    _notify(msg) {
-        import('../../platform/NativeUi.js').then((NU) => NU.notify(msg)).catch(() => { });
-    }
-    /** 防抖 */
-    _debounce(key, fn) {
-        if (this._debounceTimers.has(key)) {
-            clearTimeout(this._debounceTimers.get(key));
-        }
-        this._debounceTimers.set(key, setTimeout(() => {
-            this._debounceTimers.delete(key);
-            Promise.resolve()
-                .then(() => fn())
-                .catch((err) => {
-                console.error('[Watch] 处理文件失败:', err.message);
-                if (process.env.ASD_DEBUG === '1') {
-                    console.error(err.stack);
-                }
-            });
-        }, DEBOUNCE_DELAY));
-    }
-}
-export default FileWatcher;

package/dist/lib/service/automation/TriggerResolver.d.ts

@@ -1,36 +0,0 @@
-/**
- * TriggerResolver — 触发器规范化
- * 将原始触发输入规范化为标准格式，添加类型标签
- */
-export declare class TriggerResolver {
-    #private;
-    /**
-     * 规范化触发器
-     * @returns }
-     */
-    resolve(trigger: string | Record<string, unknown>): {
-        type: string;
-        name: string;
-        params: {
-            option: string;
-        };
-        raw: string;
-    } | {
-        type: string;
-        name: string;
-        params: {
-            option?: undefined;
-        };
-        raw: string;
-    } | {
-        type: string;
-        name: string;
-        params: Record<string, unknown>;
-        raw: Record<string, unknown>;
-    } | {
-        type: string;
-        raw: never;
-        name?: undefined;
-        params?: undefined;
-    };
-}

package/dist/lib/service/automation/TriggerResolver.js

@@ -1,62 +0,0 @@
-/**
- * TriggerResolver — 触发器规范化
- * 将原始触发输入规范化为标准格式，添加类型标签
- */
-export class TriggerResolver {
-    /**
-     * 规范化触发器
-     * @returns }
-     */
-    resolve(trigger) {
-        if (typeof trigger === 'string') {
-            return this.#resolveString(trigger);
-        }
-        if (trigger && typeof trigger === 'object') {
-            return {
-                type: String(trigger.type || 'unknown'),
-                name: String(trigger.name || ''),
-                params: trigger.params || {},
-                raw: trigger,
-            };
-        }
-        return { type: 'unknown', raw: trigger };
-    }
-    #resolveString(input) {
-        const trimmed = input.trim();
-        // 检测 as:xxx 格式
-        const asMatch = trimmed.match(/^as:(\w+)\s*(.*)/);
-        if (asMatch) {
-            return {
-                type: this.#mapDirectiveType(asMatch[1]),
-                name: asMatch[1],
-                params: { option: asMatch[2].trim() },
-                raw: input,
-            };
-        }
-        // 检测事件类型格式 file:changed, timer:cron
-        const eventMatch = trimmed.match(/^(\w+):(\w+)\s*(.*)/);
-        if (eventMatch) {
-            return {
-                type: eventMatch[1],
-                name: eventMatch[2],
-                params: { option: eventMatch[3].trim() },
-                raw: input,
-            };
-        }
-        return { type: 'custom', name: trimmed, params: {}, raw: input };
-    }
-    #mapDirectiveType(name) {
-        const map = {
-            search: 'search',
-            s: 'search',
-            create: 'create',
-            c: 'create',
-            audit: 'audit',
-            a: 'audit',
-            include: 'injection',
-            import: 'injection',
-            alink: 'alink',
-        };
-        return map[name] || 'directive';
-    }
-}

package/dist/lib/service/automation/handlers/AlinkHandler.d.ts

@@ -1,7 +0,0 @@
-/**
- * AlinkHandler — 处理 alink 指令
- *
- * 解析编辑器中的 alink 触发行，提取 completionKey，
- * 通过数据库查找匹配的 Recipe，打开 Dashboard 详情页。
- */
-export declare function handleAlink(alinkLine: string): Promise<void>;

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

@@ -1,80 +0,0 @@
-/**
- * AlinkHandler — 处理 alink 指令
- *
- * 解析编辑器中的 alink 触发行，提取 completionKey，
- * 通过数据库查找匹配的 Recipe，打开 Dashboard 详情页。
- */
-import { and, eq } from 'drizzle-orm';
-import { getServiceContainer } from '#inject/ServiceContainer.js';
-import { knowledgeEntries } from '../../../infrastructure/database/drizzle/schema.js';
-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 {
-                    // ★ Drizzle 类型安全 — 精确匹配 trigger
-                    const drizzle = typeof db.getDrizzle === 'function' ? db.getDrizzle() : null;
-                    if (!drizzle) {
-                        throw new Error('Drizzle not available');
-                    }
-                    const row = drizzle
-                        .select({ id: knowledgeEntries.id })
-                        .from(knowledgeEntries)
-                        .where(and(eq(knowledgeEntries.trigger, completionKey), eq(knowledgeEntries.lifecycle, 'active')))
-                        .limit(1)
-                        .get();
-                    if (row) {
-                        recipeId = row.id;
-                    }
-                }
-                catch {
-                    // DB 查询失败时回退到搜索
-                }
-                // 若精确匹配失败，尝试模糊搜索（保留 raw SQL — LIKE + ESCAPE）
-                if (!recipeId) {
-                    try {
-                        const rawDb2 = (typeof db.getDb === 'function' ? db.getDb() : db);
-                        const escaped = completionKey.replace(/[%_\\]/g, (ch) => `\\${ch}`);
-                        const row = rawDb2
-                            .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/dist/lib/service/automation/handlers/CreateHandler.d.ts

@@ -1,11 +0,0 @@
-/**
- * CreateHandler — 处理 // as:c 指令
- * 从 FileWatcher 拆分，负责候选创建逻辑
- */
-/**
- * 处理 // as:c 指令
- * @param createOption 'c' | 'f' | undefined
- */
-export declare function handleCreate(watcher: import('../FileWatcher.js').FileWatcher, fullPath: string, relativePath: string, createOption: string | null): Promise<void>;
-/** 查找 // as:c 的行号 (1-based) */
-export declare function findCreateLineNumber(content: string): number;