autosnippet 3.2.21 → 3.3.2

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

@@ -1,112 +0,0 @@
-/**
- * DirectiveDetector - 文件内指令检测器
- *
- * 检测 // as:c（创建）、// as:s（搜索）、// as:a（审计）等指令
- * V2 ESM 版本，对应 V1 DirectiveDetector.js
- */
-import { stripTriggerPrefix, TRIGGER_SYMBOL } from '../../infrastructure/config/TriggerSymbol.js';
-import { LanguageService } from '../../shared/LanguageService.js';
-/** 指令标记常量 */
-export const MARKS = {
-    HEADER_INCLUDE: '// autosnippet:include ',
-    HEADER_IMPORT: '// autosnippet:import ',
-    HEADER_INCLUDE_SHORT: '// as:include ',
-    HEADER_IMPORT_SHORT: '// as:import ',
-    CREATE_SHORT: '// as:create',
-    CREATE_ALIAS: '// as:c',
-    AUDIT_SHORT: '// as:audit',
-    AUDIT_ALIAS: '// as:a',
-    SEARCH_SHORT: '// as:search',
-    SEARCH_LONG: '// autosnippet:search',
-    SEARCH_ALIAS: '// as:s',
-    ALINK: 'alink',
-};
-/** 正则表达式 */
-export const REGEX = {
-    CREATE_LINE: /^\/\/\s*as:(?:create|c)(?:\s+(-[cf]))?\s*$/,
-    CREATE_REMOVE: /^@?\s*\/\/\s*as:(?:create|c)(?:\s+-[cf])?\s*\r?\n?/gm,
-    HEADER_OBJC: /^@?\/\/\s*(?:autosnippet|as):include\s+(?:<([A-Za-z0-9_]+)\/([A-Za-z0-9_+.-]+\.h)>|"([A-Za-z0-9_+./-]+\.h)")(\s+.+)?$/,
-    HEADER_SWIFT: /^@?\/\/\s*(?:autosnippet|as):import\s+\w+$/,
-    IMPORT_OBJC: /^#import\s*<[A-Za-z0-9_]+\/[A-Za-z0-9_+.-]+\.h>$/,
-    IMPORT_SWIFT: /^import\s*\w+$/,
-    SEARCH_MARK: /\/\/\s*(?:autosnippet|as):(?:search|s)(\s|$)/,
-};
-/** 推断文件语言 —— 委托给 LanguageService */
-function _inferLanguage(filename) {
-    return LanguageService.inferLang(filename);
-}
-/**
- * 检测文件内容中的所有触发指令
- *
- * @param data 文件内容
- * @param filename 文件名
- * @returns {{ importArray: string[], headerLine: string|null, alinkLine: string|null,
- *             createLine: string|null, createOption: string|null,
- *             guardLine: string|null, searchLine: string|null, isSwift: boolean, language: string }}
- */
-export function detectTriggers(data, filename) {
-    const language = _inferLanguage(filename);
-    const isSwift = language === 'swift';
-    // Import/header 自动插入目前仅支持 ObjC/Swift（Xcode 工作流）
-    const isApple = isSwift || language === 'objectivec';
-    const currImportReg = isSwift ? REGEX.IMPORT_SWIFT : REGEX.IMPORT_OBJC;
-    const _currHeaderReg = isSwift ? REGEX.HEADER_SWIFT : REGEX.HEADER_OBJC;
-    const triggers = {
-        importArray: [],
-        headerLine: null,
-        alinkLine: null,
-        createLine: null,
-        createOption: null,
-        guardLine: null,
-        searchLine: null,
-        isSwift, // backward compat
-        language, // v3.1 多语言标识
-    };
-    const lines = data.split('\n');
-    for (const line of lines) {
-        const lineVal = line.trim();
-        const normalizedLineVal = stripTriggerPrefix(lineVal);
-        // import 收集（仅 ObjC/Swift — Xcode 头文件工作流）
-        if (isApple && currImportReg.test(lineVal)) {
-            triggers.importArray.push(lineVal);
-        }
-        // header 指令
-        if (_isHeaderDirective(normalizedLineVal)) {
-            triggers.headerLine = normalizedLineVal;
-        }
-        // alink 指令
-        if (lineVal.startsWith(TRIGGER_SYMBOL) && lineVal.endsWith(TRIGGER_SYMBOL + MARKS.ALINK)) {
-            triggers.alinkLine = lineVal;
-        }
-        // create 指令
-        const createMatch = normalizedLineVal.match(REGEX.CREATE_LINE);
-        if (createMatch) {
-            triggers.createLine = lineVal;
-            triggers.createOption = createMatch[1] === '-c' ? 'c' : createMatch[1] === '-f' ? 'f' : null;
-        }
-        // guard/audit 指令
-        if (_isGuardDirective(normalizedLineVal)) {
-            triggers.guardLine = normalizedLineVal;
-        }
-        // search 指令
-        if (_isSearchDirective(normalizedLineVal)) {
-            triggers.searchLine = normalizedLineVal;
-        }
-    }
-    return triggers;
-}
-function _isHeaderDirective(line) {
-    return (line.startsWith(MARKS.HEADER_INCLUDE) ||
-        line.startsWith(MARKS.HEADER_IMPORT) ||
-        line.startsWith(MARKS.HEADER_INCLUDE_SHORT) ||
-        line.startsWith(MARKS.HEADER_IMPORT_SHORT));
-}
-function _isGuardDirective(line) {
-    // 精确匹配: // as:audit 或 // as:a，后面只能是空格或行尾
-    return /^\/\/\s*as:(?:audit|a)(?:\s|$)/.test(line);
-}
-function _isSearchDirective(line) {
-    return (line.startsWith(MARKS.SEARCH_SHORT) ||
-        line.startsWith(MARKS.SEARCH_LONG) ||
-        line.startsWith(MARKS.SEARCH_ALIAS));
-}

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>;