@aster-cloud/aster-lang-ts 0.0.1

package/dist/src/lsp/workspace/document-indexer.js

@@ -0,0 +1,88 @@
+/**
+ * LSP Workspace 文档索引器
+ * 负责解析文档内容并提取符号信息
+ */
+import { canonicalize } from '../../frontend/canonicalizer.js';
+import { lex } from '../../frontend/lexer.js';
+import { parse } from '../../parser.js';
+import { setModuleIndex, invalidateDocument as invalidateDocumentInternal } from './index-manager.js';
+// 重新导出 invalidateDocument 以保持向后兼容
+export { invalidateDocument } from './index-manager.js';
+/**
+ * 更新指定文档的索引内容。
+ * @param uri 目标文档的 URI。
+ * @param content 文档最新内容。
+ * @returns 更新完成后的模块索引。
+ */
+export async function updateDocumentIndex(uri, content) {
+    try {
+        const canonical = canonicalize(content);
+        const tokens = lex(canonical);
+        const ast = parse(tokens);
+        const symbols = [];
+        const decls = Array.isArray(ast?.decls) ? ast.decls : [];
+        for (const decl of decls) {
+            const kind = decl?.kind;
+            if (!kind || (kind !== 'Func' && kind !== 'Data' && kind !== 'Enum')) {
+                continue;
+            }
+            const name = decl?.name;
+            if (!name)
+                continue;
+            const span = decl?.span;
+            const nameSpan = decl?.nameSpan;
+            const symbol = {
+                name,
+                kind: kind === 'Func' ? 'function' : 'type',
+                range: ensureRange(span),
+            };
+            const selectionRange = optionalRange(nameSpan);
+            if (selectionRange) {
+                symbol.selectionRange = selectionRange;
+            }
+            symbols.push(symbol);
+        }
+        const astName = typeof ast?.name === 'string' && ast.name.length > 0 ? ast.name : null;
+        const moduleName = astName ?? extractModuleName(content);
+        const moduleIndex = {
+            uri,
+            moduleName,
+            symbols,
+            lastModified: Date.now(),
+        };
+        setModuleIndex(uri, moduleIndex);
+        return moduleIndex;
+    }
+    catch (err) {
+        invalidateDocumentInternal(uri);
+        throw err;
+    }
+}
+/**
+ * 将 Span 转换为 Range，确保有效范围
+ */
+function ensureRange(span) {
+    if (span) {
+        return {
+            start: { line: Math.max(0, span.start.line - 1), character: Math.max(0, span.start.col - 1) },
+            end: { line: Math.max(0, span.end.line - 1), character: Math.max(0, span.end.col - 1) },
+        };
+    }
+    return { start: { line: 0, character: 0 }, end: { line: 0, character: 0 } };
+}
+/**
+ * 将可选的 Span 转换为 Range
+ */
+function optionalRange(span) {
+    if (!span)
+        return undefined;
+    return ensureRange(span);
+}
+/**
+ * 从文本中提取模块名称
+ */
+function extractModuleName(text) {
+    const match = text.match(/This module is ([A-Za-z][A-Za-z0-9_.]*)\./);
+    return match?.[1] ?? null;
+}
+//# sourceMappingURL=document-indexer.js.map

package/dist/src/lsp/workspace/document-indexer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-indexer.js","sourceRoot":"","sources":["../../../../src/lsp/workspace/document-indexer.ts"],"names":[],"mappings":"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"}

package/dist/src/lsp/workspace/file-watcher.d.ts

@@ -0,0 +1,137 @@
+/**
+ * LSP Workspace 文件监控器
+ * 提供文件系统变化监控，支持降级策略（从 native watcher 降级到 polling）
+ */
+import { EventEmitter } from 'node:events';
+/**
+ * 文件监控配置
+ */
+export interface FileWatcherConfig {
+    /**
+     * 是否启用文件监控
+     */
+    enabled: boolean;
+    /**
+     * 监控模式：'native'（客户端提供）或 'polling'（服务器轮询）
+     */
+    mode: 'native' | 'polling';
+    /**
+     * Polling 模式下的轮询间隔（毫秒）
+     */
+    pollingInterval: number;
+    /**
+     * 排除的目录模式
+     */
+    excludePatterns: string[];
+}
+/**
+ * FileWatcher 类：封装文件监控的所有状态和行为
+ * 支持多实例，每个实例维护独立的状态和事件发射器
+ */
+export declare class FileWatcher {
+    private config;
+    private pollingTimer;
+    private fileSnapshots;
+    private workspaceFolders;
+    private isRunning;
+    private isScanning;
+    /**
+     * 事件发射器：用于测试观察和验证
+     * 事件类型：
+     * - 'scan:attempt': 尝试扫描（无论是否被锁阻止）
+     * - 'scan:start': 实际开始扫描（获取到锁）
+     * - 'scan:end': 扫描完成
+     * - 'scan:rejected': 扫描被单飞行锁拒绝
+     */
+    private readonly events;
+    constructor(config?: Partial<FileWatcherConfig>);
+    /**
+     * 获取扫描事件发射器（仅供测试使用）
+     */
+    getEventEmitter(): EventEmitter;
+    /**
+     * 配置文件监控器
+     */
+    configure(config: Partial<FileWatcherConfig>): void;
+    /**
+     * 启动文件监控
+     */
+    start(folders: string[]): void;
+    /**
+     * 停止文件监控
+     */
+    stop(): void;
+    /**
+     * 获取监控状态
+     */
+    getStatus(): {
+        enabled: boolean;
+        mode: 'native' | 'polling';
+        isRunning: boolean;
+        trackedFiles: number;
+    };
+    /**
+     * 处理客户端提供的文件变更事件（native 模式）
+     */
+    handleNativeChanges(changes: Array<{
+        uri: string;
+        type: number;
+    }>): Promise<void>;
+    /**
+     * 启动轮询机制
+     */
+    private startPolling;
+    /**
+     * 停止轮询
+     */
+    private stopPolling;
+    /**
+     * 扫描并更新文件索引
+     */
+    private scanAndUpdate;
+    /**
+     * 检测目录下的文件变更
+     */
+    private detectChanges;
+    /**
+     * 递归扫描目录
+     */
+    private scanDirectory;
+    /**
+     * 处理文件变更
+     */
+    private processChanges;
+}
+/**
+ * 配置文件监控器（向后兼容 API）
+ */
+export declare function configureFileWatcher(config: Partial<FileWatcherConfig>): void;
+/**
+ * 启动文件监控（向后兼容 API）
+ */
+export declare function startFileWatcher(folders: string[]): void;
+/**
+ * 停止文件监控（向后兼容 API）
+ */
+export declare function stopFileWatcher(): void;
+/**
+ * 获取监控状态（向后兼容 API）
+ */
+export declare function getWatcherStatus(): {
+    enabled: boolean;
+    mode: 'native' | 'polling';
+    isRunning: boolean;
+    trackedFiles: number;
+};
+/**
+ * 获取扫描事件发射器（仅供测试使用，向后兼容 API）
+ */
+export declare function getScanEventEmitter(): EventEmitter;
+/**
+ * 处理客户端提供的文件变更事件（native 模式，向后兼容 API）
+ */
+export declare function handleNativeFileChanges(changes: Array<{
+    uri: string;
+    type: number;
+}>): Promise<void>;
+//# sourceMappingURL=file-watcher.d.ts.map

package/dist/src/lsp/workspace/file-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../../../src/lsp/workspace/file-watcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC3B;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAyBD;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,aAAa,CAAwC;IAC7D,OAAO,CAAC,gBAAgB,CAAgB;IACxC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,MAAM,GAAE,OAAO,CAAC,iBAAiB,CAAM;IAKnD;;OAEG;IACH,eAAe,IAAI,YAAY;IAI/B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI;IAanD;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAc9B;;OAEG;IACH,IAAI,IAAI,IAAI;IAQZ;;OAEG;IACH,SAAS,IAAI;QACX,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;QAC3B,SAAS,EAAE,OAAO,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB;IASD;;OAEG;IACG,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IASvF;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;YACW,aAAa;IA8B3B;;OAEG;YACW,aAAa;IA6B3B;;OAEG;YACW,aAAa;IAuD3B;;OAEG;YACW,cAAc;CA0B7B;AAYD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAE7E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAExD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB,CAEA;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,YAAY,CAElD;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAC5C,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/src/lsp/workspace/file-watcher.js

@@ -0,0 +1,307 @@
+/**
+ * LSP Workspace 文件监控器
+ * 提供文件系统变化监控，支持降级策略（从 native watcher 降级到 polling）
+ */
+import { promises as fs } from 'node:fs';
+import { extname, relative, sep } from 'node:path';
+import { updateDocumentIndex, invalidateDocument } from './document-indexer.js';
+import { pathToFileURL } from 'node:url';
+import { EventEmitter } from 'node:events';
+const defaultConfig = {
+    enabled: true,
+    mode: 'native',
+    pollingInterval: 3000, // 3 秒轮询一次
+    excludePatterns: ['node_modules', '.git', 'dist', '.asteri'],
+};
+/**
+ * FileWatcher 类：封装文件监控的所有状态和行为
+ * 支持多实例，每个实例维护独立的状态和事件发射器
+ */
+export class FileWatcher {
+    config;
+    pollingTimer = null;
+    fileSnapshots = new Map();
+    workspaceFolders = [];
+    isRunning = false;
+    isScanning = false; // 单飞行锁：防止并发扫描
+    /**
+     * 事件发射器：用于测试观察和验证
+     * 事件类型：
+     * - 'scan:attempt': 尝试扫描（无论是否被锁阻止）
+     * - 'scan:start': 实际开始扫描（获取到锁）
+     * - 'scan:end': 扫描完成
+     * - 'scan:rejected': 扫描被单飞行锁拒绝
+     */
+    events;
+    constructor(config = {}) {
+        this.config = { ...defaultConfig, ...config };
+        this.events = new EventEmitter();
+    }
+    /**
+     * 获取扫描事件发射器（仅供测试使用）
+     */
+    getEventEmitter() {
+        return this.events;
+    }
+    /**
+     * 配置文件监控器
+     */
+    configure(config) {
+        const wasRunning = this.isRunning;
+        if (wasRunning) {
+            this.stop();
+        }
+        this.config = { ...this.config, ...config };
+        if (wasRunning && this.config.enabled) {
+            this.start(this.workspaceFolders);
+        }
+    }
+    /**
+     * 启动文件监控
+     */
+    start(folders) {
+        if (this.isRunning) {
+            return;
+        }
+        this.workspaceFolders = [...folders];
+        this.isRunning = true;
+        if (this.config.mode === 'polling') {
+            this.startPolling();
+        }
+        // native 模式下，由客户端负责触发 handleNativeFileChanges
+    }
+    /**
+     * 停止文件监控
+     */
+    stop() {
+        this.isRunning = false;
+        this.stopPolling();
+        this.fileSnapshots.clear();
+        // 注意：不清理事件监听器，保持与旧实现的兼容性
+        // 调用方可以在 configure() 前后持续使用同一监听器
+    }
+    /**
+     * 获取监控状态
+     */
+    getStatus() {
+        return {
+            enabled: this.config.enabled,
+            mode: this.config.mode,
+            isRunning: this.isRunning,
+            trackedFiles: this.fileSnapshots.size,
+        };
+    }
+    /**
+     * 处理客户端提供的文件变更事件（native 模式）
+     */
+    async handleNativeChanges(changes) {
+        const events = changes.map(ch => ({
+            uri: ch.uri,
+            type: ch.type === 1 ? 'created' : ch.type === 2 ? 'changed' : 'deleted',
+        }));
+        await this.processChanges(events);
+    }
+    /**
+     * 启动轮询机制
+     */
+    startPolling() {
+        if (this.pollingTimer) {
+            return;
+        }
+        // 立即执行一次扫描
+        void this.scanAndUpdate();
+        // 设置定时器
+        this.pollingTimer = setInterval(() => {
+            void this.scanAndUpdate();
+        }, this.config.pollingInterval);
+    }
+    /**
+     * 停止轮询
+     */
+    stopPolling() {
+        if (this.pollingTimer) {
+            clearInterval(this.pollingTimer);
+            this.pollingTimer = null;
+        }
+    }
+    /**
+     * 扫描并更新文件索引
+     */
+    async scanAndUpdate() {
+        // 发射尝试事件（用于测试验证）
+        this.events.emit('scan:attempt');
+        // 单飞行锁：如果已经在扫描，跳过本次
+        if (this.isScanning) {
+            this.events.emit('scan:rejected');
+            return;
+        }
+        // 发射开始事件（用于测试验证）
+        this.events.emit('scan:start');
+        this.isScanning = true;
+        try {
+            const changes = [];
+            for (const folder of this.workspaceFolders) {
+                const detectedChanges = await this.detectChanges(folder);
+                changes.push(...detectedChanges);
+            }
+            // 批量处理变更
+            await this.processChanges(changes);
+        }
+        finally {
+            this.isScanning = false;
+            this.events.emit('scan:end');
+        }
+    }
+    /**
+     * 检测目录下的文件变更
+     */
+    async detectChanges(dir) {
+        const changes = [];
+        const currentFiles = new Set();
+        try {
+            await this.scanDirectory(dir, currentFiles, changes);
+        }
+        catch {
+            // 目录不存在或无法访问
+            return changes;
+        }
+        // 检查已删除的文件
+        for (const [path] of this.fileSnapshots) {
+            // 使用 relative 检查文件是否在目录下，避免前缀碰撞
+            const rel = relative(dir, path);
+            const isInDir = rel && !rel.startsWith('..') && !rel.startsWith(sep);
+            if (isInDir && !currentFiles.has(path)) {
+                changes.push({
+                    uri: pathToFileURL(path).href,
+                    type: 'deleted',
+                });
+                this.fileSnapshots.delete(path);
+            }
+        }
+        return changes;
+    }
+    /**
+     * 递归扫描目录
+     */
+    async scanDirectory(dir, currentFiles, changes) {
+        let entries;
+        try {
+            entries = await fs.readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            // 跳过排除的目录
+            if (entry.isDirectory() && this.config.excludePatterns.includes(entry.name)) {
+                continue;
+            }
+            const fullPath = `${dir}/${entry.name}`;
+            if (entry.isDirectory()) {
+                await this.scanDirectory(fullPath, currentFiles, changes);
+            }
+            else if (entry.isFile() && extname(entry.name) === '.aster') {
+                currentFiles.add(fullPath);
+                try {
+                    const stats = await fs.stat(fullPath);
+                    const snapshot = {
+                        mtime: stats.mtimeMs,
+                        size: stats.size,
+                    };
+                    const previous = this.fileSnapshots.get(fullPath);
+                    if (!previous) {
+                        // 新文件
+                        changes.push({
+                            uri: pathToFileURL(fullPath).href,
+                            type: 'created',
+                        });
+                    }
+                    else if (previous.mtime !== snapshot.mtime || previous.size !== snapshot.size) {
+                        // 已修改
+                        changes.push({
+                            uri: pathToFileURL(fullPath).href,
+                            type: 'changed',
+                        });
+                    }
+                    this.fileSnapshots.set(fullPath, snapshot);
+                }
+                catch {
+                    // 文件无法访问
+                }
+            }
+        }
+    }
+    /**
+     * 处理文件变更
+     */
+    async processChanges(changes) {
+        if (changes.length === 0) {
+            return;
+        }
+        const BATCH_SIZE = 10;
+        for (let i = 0; i < changes.length; i += BATCH_SIZE) {
+            const batch = changes.slice(i, i + BATCH_SIZE);
+            await Promise.all(batch.map(async (change) => {
+                try {
+                    if (change.type === 'deleted') {
+                        invalidateDocument(change.uri);
+                    }
+                    else {
+                        // created 或 changed
+                        const fsPath = new URL(change.uri).pathname;
+                        const content = await fs.readFile(fsPath, 'utf8');
+                        await updateDocumentIndex(change.uri, content);
+                    }
+                }
+                catch {
+                    // 忽略错误（文件可能已被删除或无法读取）
+                }
+            }));
+        }
+    }
+}
+// ============================================================================
+// 向后兼容的模块级 API（使用默认实例）
+// ============================================================================
+/**
+ * 默认的 FileWatcher 实例
+ * 用于向后兼容现有的模块级 API
+ */
+const defaultWatcher = new FileWatcher();
+/**
+ * 配置文件监控器（向后兼容 API）
+ */
+export function configureFileWatcher(config) {
+    defaultWatcher.configure(config);
+}
+/**
+ * 启动文件监控（向后兼容 API）
+ */
+export function startFileWatcher(folders) {
+    defaultWatcher.start(folders);
+}
+/**
+ * 停止文件监控（向后兼容 API）
+ */
+export function stopFileWatcher() {
+    defaultWatcher.stop();
+}
+/**
+ * 获取监控状态（向后兼容 API）
+ */
+export function getWatcherStatus() {
+    return defaultWatcher.getStatus();
+}
+/**
+ * 获取扫描事件发射器（仅供测试使用，向后兼容 API）
+ */
+export function getScanEventEmitter() {
+    return defaultWatcher.getEventEmitter();
+}
+/**
+ * 处理客户端提供的文件变更事件（native 模式，向后兼容 API）
+ */
+export async function handleNativeFileChanges(changes) {
+    await defaultWatcher.handleNativeChanges(changes);
+}
+//# sourceMappingURL=file-watcher.js.map

package/dist/src/lsp/workspace/file-watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-watcher.js","sourceRoot":"","sources":["../../../../src/lsp/workspace/file-watcher.ts"],"names":[],"mappings":"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"}

package/dist/src/lsp/workspace/index-manager.d.ts

@@ -0,0 +1,48 @@
+/**
+ * LSP Workspace 索引管理器
+ * 管理工作区索引的存储、访问和持久化
+ */
+import type { IndexConfig, ModuleIndex } from './types.js';
+/**
+ * 根据文档 URI 获取对应的模块索引。
+ * @param uri 目标文档的 URI。
+ * @returns 找到时返回索引记录，否则返回 undefined。
+ */
+export declare function getModuleIndex(uri: string): ModuleIndex | undefined;
+/**
+ * 获取当前工作区内所有模块的索引快照。
+ * @returns 模块索引数组。
+ */
+export declare function getAllModules(): ModuleIndex[];
+/**
+ * 设置模块索引
+ * @param uri 文档 URI
+ * @param moduleIndex 模块索引
+ */
+export declare function setModuleIndex(uri: string, moduleIndex: ModuleIndex): void;
+/**
+ * 将指定文档从索引中移除或标记为失效。
+ * @param uri 目标文档的 URI。
+ */
+export declare function invalidateDocument(uri: string): void;
+/**
+ * 从持久化存储加载索引数据。
+ * @param indexPath 索引文件路径。
+ * @returns 成功加载时返回 true，失败或未找到时返回 false。
+ */
+export declare function loadIndex(indexPath: string): Promise<boolean>;
+/**
+ * 将当前索引数据写入持久化存储。
+ * @param indexPath 索引文件路径。
+ */
+export declare function saveIndex(indexPath: string): Promise<void>;
+/**
+ * 更新索引模块的运行配置。
+ * @param config 新配置对象。
+ */
+export declare function setIndexConfig(config: Partial<IndexConfig>): void;
+/**
+ * 清空当前索引缓存并取消未完成的写入定时器。
+ */
+export declare function clearIndex(): void;
+//# sourceMappingURL=index-manager.d.ts.map

package/dist/src/lsp/workspace/index-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-manager.d.ts","sourceRoot":"","sources":["../../../../src/lsp/workspace/index-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAc3D;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEnE;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,WAAW,EAAE,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,CAc1E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAMpD;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAuBnE;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhE;AAkBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAEjE;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAOjC"}