opkg 0.9.0 → 0.9.2

package/packages/core/dist/utils/expand-directory-selections.js

@@ -0,0 +1,101 @@
+/**
+ * Directory Selection Expansion Utility
+ *
+ * Expands directory selections (paths ending with '/') into all files within them.
+ * Used by add and remove commands to handle directory selections from interactive file selector.
+ */
+import { join, relative } from 'path';
+import { promises as fs } from 'fs';
+import { walkFiles } from './file-walker.js';
+import { isJunk } from 'junk';
+/**
+ * Expand directory selections into individual file paths
+ *
+ * @param selectedPaths - Array of selected paths (files and directories with '/' suffix)
+ * @param basePath - Base directory path for resolving relative paths
+ * @returns Array of individual file paths (no directories)
+ *
+ * @example
+ * const selections = ['src/', 'package.json', 'docs/readme.md'];
+ * const expanded = await expandDirectorySelections(selections, '/workspace');
+ * // Returns: ['src/index.ts', 'src/utils/helper.ts', 'package.json', 'docs/readme.md']
+ */
+export async function expandDirectorySelections(selectedPaths, basePath) {
+    const expandedFiles = [];
+    const seenFiles = new Set();
+    for (const path of selectedPaths) {
+        if (path.endsWith('/')) {
+            // This is a directory - expand it to all files within
+            const dirPath = path.slice(0, -1); // Remove trailing '/'
+            const absDirPath = join(basePath, dirPath);
+            // Check if directory exists
+            try {
+                const stat = await fs.stat(absDirPath);
+                if (!stat.isDirectory()) {
+                    // Not a directory, skip
+                    continue;
+                }
+            }
+            catch {
+                // Directory doesn't exist or is inaccessible, skip
+                continue;
+            }
+            // Walk all files in the directory
+            const filter = (filePath, isDirectory) => {
+                if (isDirectory) {
+                    return true; // Always traverse directories
+                }
+                // Filter out junk files
+                const segments = filePath.split('/');
+                const basename = segments[segments.length - 1];
+                return !isJunk(basename);
+            };
+            for await (const filePath of walkFiles(absDirPath, { filter })) {
+                // Convert to relative path from basePath (path.relative handles trailing slashes correctly)
+                const relativePath = relative(basePath, filePath);
+                // Only add if not already seen (avoid duplicates)
+                if (!seenFiles.has(relativePath)) {
+                    seenFiles.add(relativePath);
+                    expandedFiles.push(relativePath);
+                }
+            }
+        }
+        else {
+            // This is a regular file - add it directly if not already seen
+            if (!seenFiles.has(path)) {
+                seenFiles.add(path);
+                expandedFiles.push(path);
+            }
+        }
+    }
+    return expandedFiles;
+}
+/**
+ * Check if any selected paths are directories
+ *
+ * @param selectedPaths - Array of selected paths
+ * @returns True if at least one path is a directory (ends with '/')
+ */
+export function hasDirectorySelections(selectedPaths) {
+    return selectedPaths.some(path => path.endsWith('/'));
+}
+/**
+ * Count how many directories and files are in the selection
+ *
+ * @param selectedPaths - Array of selected paths
+ * @returns Object with counts of directories and files
+ */
+export function countSelectionTypes(selectedPaths) {
+    let dirs = 0;
+    let files = 0;
+    for (const path of selectedPaths) {
+        if (path.endsWith('/')) {
+            dirs++;
+        }
+        else {
+            files++;
+        }
+    }
+    return { dirs, files };
+}
+//# sourceMappingURL=expand-directory-selections.js.map

package/packages/core/dist/utils/expand-directory-selections.js.map

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

package/packages/core/dist/utils/file-processing.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Get file modification time
+ * @throws Error if unable to get file stats
+ */
+export declare function getFileMtime(filePath: string): Promise<number>;
+/**
+ * Recursively find files by extension in a directory
+ */
+export declare function findFilesByExtension(dir: string, extensions?: string[], baseDir?: string, options?: {
+    excludeDirs?: Set<string>;
+}): Promise<Array<{
+    fullPath: string;
+    relativePath: string;
+}>>;
+/**
+ * Recursively find directories containing a specific file
+ * @param rootDir - Root directory to start searching from
+ * @param targetFileName - Name of the file to search for (e.g., 'openpackage.yml')
+ * @param parseCallback - Optional callback to parse and validate the file content
+ * @returns Array of directory paths where the file was found
+ */
+export declare function findDirectoriesContainingFile<T = void>(rootDir: string, targetFileName: string, parseCallback?: (filePath: string) => Promise<T | null>): Promise<Array<{
+    dirPath: string;
+    parsedContent?: T;
+}>>;
+//# sourceMappingURL=file-processing.d.ts.map

package/packages/core/dist/utils/file-processing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-processing.d.ts","sourceRoot":"","sources":["../../src/utils/file-processing.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGpE;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,UAAU,GAAE,MAAM,EAAO,EACzB,OAAO,GAAE,MAAY,EACrB,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAO,GAC1C,OAAO,CAAC,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CA+B5D;AAED;;;;;;GAMG;AACH,wBAAsB,6BAA6B,CAAC,CAAC,GAAG,IAAI,EAC1D,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,GACtD,OAAO,CAAC,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC,CAAC,CA4CxD"}

package/packages/core/dist/utils/file-processing.js

@@ -0,0 +1,91 @@
+import { join } from 'path';
+import { logger } from './logger.js';
+import { exists, listFiles, listDirectories, isDirectory, getStats } from './fs.js';
+import { getRelativePathFromBase } from './path-normalization.js';
+/**
+ * Get file modification time
+ * @throws Error if unable to get file stats
+ */
+export async function getFileMtime(filePath) {
+    const stats = await getStats(filePath);
+    return stats.mtime.getTime();
+}
+/**
+ * Recursively find files by extension in a directory
+ */
+export async function findFilesByExtension(dir, extensions = [], baseDir = dir, options = {}) {
+    if (!(await exists(dir)) || !(await isDirectory(dir))) {
+        return [];
+    }
+    const files = [];
+    const normalizedExtensions = extensions.map(extension => extension.startsWith('.') ? extension : `.${extension}`);
+    // Check current directory files
+    const dirFiles = await listFiles(dir);
+    for (const file of dirFiles) {
+        // If no extension is provided, include all files
+        // Otherwise, include only files with the specified extension
+        if (normalizedExtensions.length === 0 || normalizedExtensions.some(extension => file.endsWith(extension))) {
+            const fullPath = join(dir, file);
+            const relativePath = getRelativePathFromBase(fullPath, baseDir);
+            files.push({ fullPath, relativePath });
+        }
+    }
+    // Recursively search subdirectories
+    const subdirs = await listDirectories(dir);
+    const subFilesPromises = subdirs
+        .filter(subdir => !(options.excludeDirs && options.excludeDirs.has(subdir)))
+        .map(subdir => findFilesByExtension(join(dir, subdir), extensions, baseDir, options));
+    const subFiles = await Promise.all(subFilesPromises);
+    files.push(...subFiles.flat());
+    return files;
+}
+/**
+ * Recursively find directories containing a specific file
+ * @param rootDir - Root directory to start searching from
+ * @param targetFileName - Name of the file to search for (e.g., 'openpackage.yml')
+ * @param parseCallback - Optional callback to parse and validate the file content
+ * @returns Array of directory paths where the file was found
+ */
+export async function findDirectoriesContainingFile(rootDir, targetFileName, parseCallback) {
+    const results = [];
+    if (!(await exists(rootDir)) || !(await isDirectory(rootDir))) {
+        return results;
+    }
+    async function recurse(dir) {
+        try {
+            const files = await listFiles(dir);
+            // Check if target file exists in current directory
+            if (files.includes(targetFileName)) {
+                const filePath = join(dir, targetFileName);
+                // If parse callback provided, use it to validate/parse
+                if (parseCallback) {
+                    try {
+                        const parsedContent = await parseCallback(filePath);
+                        if (parsedContent !== null) {
+                            results.push({ dirPath: dir, parsedContent });
+                        }
+                    }
+                    catch (error) {
+                        logger.warn(`Failed to parse ${targetFileName} at ${filePath}: ${error}`);
+                    }
+                }
+                else {
+                    // No callback, just record the directory
+                    results.push({ dirPath: dir });
+                }
+            }
+            // Recursively search subdirectories
+            const subdirs = await listDirectories(dir);
+            for (const subdir of subdirs) {
+                const subdirPath = join(dir, subdir);
+                await recurse(subdirPath);
+            }
+        }
+        catch (error) {
+            logger.warn(`Failed to scan directory: ${dir}`, { error });
+        }
+    }
+    await recurse(rootDir);
+    return results;
+}
+//# sourceMappingURL=file-processing.js.map

package/packages/core/dist/utils/file-processing.js.map

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

package/packages/core/dist/utils/file-scanner.d.ts

@@ -0,0 +1,62 @@
+/**
+ * File Scanner Utility
+ *
+ * Scans all files in a workspace directory for interactive file selection.
+ * Filters out junk files and common build/dependency directories.
+ */
+/**
+ * Options for scanning workspace files
+ */
+export interface FileScanOptions {
+    /** Base directory to scan from (default: process.cwd()) */
+    cwd?: string;
+    /** Specific directory path to scan (overrides cwd if provided) */
+    basePath?: string;
+    /** Additional directory names to exclude (merged with defaults) */
+    excludeDirs?: string[];
+    /** Maximum number of files to return (default: 10000) */
+    maxFiles?: number;
+    /** Whether to follow symbolic links (default: false) */
+    followSymlinks?: boolean;
+    /** Whether to include directories in results (default: false) */
+    includeDirs?: boolean;
+}
+/**
+ * Scan workspace for all non-junk files
+ *
+ * @param options - Scanning options
+ * @returns Array of relative file paths (and optionally directory paths with '/' suffix) from cwd (or basePath if specified)
+ *
+ * @example
+ * const files = await scanWorkspaceFiles({ cwd: '/path/to/workspace' });
+ * // Returns: ['src/index.ts', 'package.json', '.openpkgs/rules/cursor.md', ...]
+ *
+ * @example
+ * // Scan a specific directory
+ * const packageFiles = await scanWorkspaceFiles({
+ *   cwd: '/workspace',
+ *   basePath: '/workspace/.openpackage/packages/my-pkg'
+ * });
+ * // Returns files relative to basePath: ['file1.txt', 'subdir/file2.txt', ...]
+ *
+ * @example
+ * // Include directories in results
+ * const filesAndDirs = await scanWorkspaceFiles({
+ *   cwd: '/path/to/workspace',
+ *   includeDirs: true
+ * });
+ * // Returns: ['src/', 'src/index.ts', 'src/utils/', 'src/utils/helper.ts', ...]
+ */
+export declare function scanWorkspaceFiles(options?: FileScanOptions): Promise<string[]>;
+/**
+ * Check if the current environment supports interactive prompts.
+ *
+ * Prefer using `ExecutionContext.interactive` when available -- this
+ * function exists as a last-resort fallback for code paths that
+ * don't have access to a context object.
+ *
+ * @returns True if stdin and stdout are TTY (terminal)
+ * @deprecated Use ExecutionContext.interactive instead when possible.
+ */
+export declare function canPrompt(): boolean;
+//# sourceMappingURL=file-scanner.d.ts.map

package/packages/core/dist/utils/file-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-scanner.d.ts","sourceRoot":"","sources":["../../src/utils/file-scanner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA8BH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAEvB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,wDAAwD;IACxD,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,iEAAiE;IACjE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAkBD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,MAAM,EAAE,CAAC,CA0GnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC"}

package/packages/core/dist/utils/file-scanner.js

@@ -0,0 +1,168 @@
+/**
+ * File Scanner Utility
+ *
+ * Scans all files in a workspace directory for interactive file selection.
+ * Filters out junk files and common build/dependency directories.
+ */
+import { relative } from 'path';
+import { isJunk } from 'junk';
+import { walkFiles } from './file-walker.js';
+import { logger } from './logger.js';
+/**
+ * Common directories to exclude from file scanning
+ */
+const DEFAULT_EXCLUDE_DIRS = new Set([
+    'node_modules',
+    '.git',
+    '.next',
+    '.turbo',
+    'dist',
+    'build',
+    'out',
+    '.cache',
+    'coverage',
+    '.nyc_output',
+    '.parcel-cache',
+    '.webpack',
+    '.vscode',
+    '.idea',
+    '__pycache__',
+    'target',
+    'vendor',
+]);
+/**
+ * Check if a path segment is an excluded directory
+ */
+function isExcludedDir(fullPath, excludeDirs) {
+    const segments = fullPath.split('/');
+    // Check if any segment matches an excluded directory
+    for (const segment of segments) {
+        if (excludeDirs.has(segment)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Scan workspace for all non-junk files
+ *
+ * @param options - Scanning options
+ * @returns Array of relative file paths (and optionally directory paths with '/' suffix) from cwd (or basePath if specified)
+ *
+ * @example
+ * const files = await scanWorkspaceFiles({ cwd: '/path/to/workspace' });
+ * // Returns: ['src/index.ts', 'package.json', '.openpkgs/rules/cursor.md', ...]
+ *
+ * @example
+ * // Scan a specific directory
+ * const packageFiles = await scanWorkspaceFiles({
+ *   cwd: '/workspace',
+ *   basePath: '/workspace/.openpackage/packages/my-pkg'
+ * });
+ * // Returns files relative to basePath: ['file1.txt', 'subdir/file2.txt', ...]
+ *
+ * @example
+ * // Include directories in results
+ * const filesAndDirs = await scanWorkspaceFiles({
+ *   cwd: '/path/to/workspace',
+ *   includeDirs: true
+ * });
+ * // Returns: ['src/', 'src/index.ts', 'src/utils/', 'src/utils/helper.ts', ...]
+ */
+export async function scanWorkspaceFiles(options = {}) {
+    const { cwd = process.cwd(), basePath, excludeDirs = [], maxFiles = 10000, followSymlinks = false, includeDirs = false } = options;
+    // Use basePath if provided, otherwise use cwd
+    const scanDir = basePath || cwd;
+    // Merge default and custom exclude directories
+    const allExcludeDirs = new Set([
+        ...DEFAULT_EXCLUDE_DIRS,
+        ...excludeDirs
+    ]);
+    const files = [];
+    const dirs = [];
+    let fileCount = 0;
+    try {
+        // Create filter for file walker
+        const filter = (path, isDirectory) => {
+            // Get the basename for junk checking
+            const segments = path.split('/');
+            const basename = segments[segments.length - 1];
+            // Filter out junk files
+            if (isJunk(basename)) {
+                return false;
+            }
+            // Filter out excluded directories and their contents
+            if (isExcludedDir(path, allExcludeDirs)) {
+                return false;
+            }
+            return true;
+        };
+        // Walk files and collect relative paths
+        for await (const filePath of walkFiles(scanDir, { filter, followSymlinks, includeDirs })) {
+            // Stop if we've hit the max files limit
+            if (fileCount >= maxFiles) {
+                logger.debug(`File scan limit reached: ${maxFiles} files`);
+                break;
+            }
+            // Convert to relative path for display
+            const relativePath = relative(scanDir, filePath);
+            // Skip if relative path is empty (shouldn't happen, but safety check)
+            if (!relativePath || relativePath === '.') {
+                continue;
+            }
+            // Check if this is a directory (when includeDirs is enabled)
+            if (includeDirs) {
+                const fs = await import('fs');
+                const stat = await fs.promises.stat(filePath);
+                if (stat.isDirectory()) {
+                    // Add '/' suffix to directories for visual distinction
+                    dirs.push(relativePath + '/');
+                }
+                else {
+                    files.push(relativePath);
+                }
+            }
+            else {
+                files.push(relativePath);
+            }
+            fileCount++;
+        }
+        // Sort files and directories for better UX
+        // Directories first, then files, both alphabetically within their group
+        const allItems = [...dirs.sort(), ...files.sort()];
+        // Apply depth-based sorting to prioritize shallow items
+        allItems.sort((a, b) => {
+            // Remove trailing '/' for directory depth calculation
+            const aPath = a.endsWith('/') ? a.slice(0, -1) : a;
+            const bPath = b.endsWith('/') ? b.slice(0, -1) : b;
+            // Prioritize items in root directory
+            const aDepth = aPath.split('/').length;
+            const bDepth = bPath.split('/').length;
+            if (aDepth !== bDepth) {
+                return aDepth - bDepth;
+            }
+            // Then alphabetically
+            return a.localeCompare(b);
+        });
+        logger.debug(`Scanned ${allItems.length} items in workspace`, { scanDir, includeDirs });
+        return allItems;
+    }
+    catch (error) {
+        logger.error('Error scanning workspace files', { error, scanDir });
+        throw new Error(`Failed to scan workspace files: ${error}`);
+    }
+}
+/**
+ * Check if the current environment supports interactive prompts.
+ *
+ * Prefer using `ExecutionContext.interactive` when available -- this
+ * function exists as a last-resort fallback for code paths that
+ * don't have access to a context object.
+ *
+ * @returns True if stdin and stdout are TTY (terminal)
+ * @deprecated Use ExecutionContext.interactive instead when possible.
+ */
+export function canPrompt() {
+    return Boolean(process.stdin.isTTY && process.stdout.isTTY);
+}
+//# sourceMappingURL=file-scanner.js.map

package/packages/core/dist/utils/file-scanner.js.map

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

package/packages/core/dist/utils/file-walker.d.ts

@@ -0,0 +1,69 @@
+/**
+ * File Walker Utility
+ *
+ * Provides efficient file system traversal utilities for walking directory trees.
+ * Used across install, save, status, pack, and other commands.
+ */
+/**
+ * Filter predicate for file walking
+ */
+export type FileFilter = (path: string, isDirectory: boolean) => boolean | Promise<boolean>;
+/**
+ * Options for file walking
+ */
+export interface WalkOptions {
+    /**
+     * Filter predicate to include/exclude files and directories
+     */
+    filter?: FileFilter;
+    /**
+     * Follow symbolic links (default: false)
+     */
+    followSymlinks?: boolean;
+    /**
+     * Maximum depth to traverse (default: unlimited)
+     */
+    maxDepth?: number;
+    /**
+     * Include directories in results (default: false, only files)
+     */
+    includeDirs?: boolean;
+}
+/**
+ * Async generator that walks a directory tree and yields file paths
+ *
+ * @param dir - Directory to walk
+ * @param options - Walking options
+ *
+ * @example
+ * for await (const filePath of walkFiles('/path/to/dir')) {
+ *   console.log(filePath);
+ * }
+ */
+export declare function walkFiles(dir: string, options?: WalkOptions): AsyncGenerator<string>;
+/**
+ * Walk directory and collect all files into an array
+ *
+ * @param dir - Directory to walk
+ * @param options - Walking options
+ * @returns Array of file paths
+ */
+export declare function collectFiles(dir: string, options?: WalkOptions): Promise<string[]>;
+/**
+ * Walk directory with a simple include/exclude pattern filter
+ *
+ * @param dir - Directory to walk
+ * @param includePatterns - Patterns to include (minimatch)
+ * @param excludePatterns - Patterns to exclude (minimatch)
+ * @returns Async generator of matching file paths
+ */
+export declare function walkWithPatterns(dir: string, includePatterns?: string[], excludePatterns?: string[]): AsyncGenerator<string>;
+/**
+ * Count files in a directory (without collecting them all)
+ *
+ * @param dir - Directory to walk
+ * @param options - Walking options
+ * @returns Number of files
+ */
+export declare function countFiles(dir: string, options?: WalkOptions): Promise<number>;
+//# sourceMappingURL=file-walker.d.ts.map

package/packages/core/dist/utils/file-walker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-walker.d.ts","sourceRoot":"","sources":["../../src/utils/file-walker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAE5F;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IAEpB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;GAUG;AACH,wBAAuB,SAAS,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,WAAgB,GACxB,cAAc,CAAC,MAAM,CAAC,CASxB;AA+ED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,MAAM,EAAE,CAAC,CAQnB;AAED;;;;;;;GAOG;AACH,wBAAuB,gBAAgB,CACrC,GAAG,EAAE,MAAM,EACX,eAAe,GAAE,MAAM,EAAa,EACpC,eAAe,GAAE,MAAM,EAAO,GAC7B,cAAc,CAAC,MAAM,CAAC,CA8BxB;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,CAQjB"}