@side-quest/kit 0.1.0 → 0.2.0

package/dist/lib/commands/callers.js

@@ -0,0 +1,162 @@
+/**
+ * Callers command - Find who calls a function
+ *
+ * Uses kit grep to find all call sites of a function, filtering out the
+ * definition itself to show only actual usage locations.
+ */
+import { color, OutputFormat } from '../formatters/output';
+import { executeKitGrep } from '../kit-wrapper';
+import { findSymbol, loadProjectIndex } from '../utils/index-parser';
+/**
+ * Format callers result as markdown
+ *
+ * @param result - Callers result to format
+ * @returns Formatted markdown string
+ */
+function formatMarkdown(result) {
+    const { functionName, definitionFile, definitionLine, callSites, count } = result;
+    if (count === 0) {
+        return color('yellow', `\n⚠️  No call sites found for function: ${functionName}\n`);
+    }
+    let output = color('cyan', `\n📞 Found ${count} call site(s) for: `);
+    output += color('blue', functionName);
+    output += '\n\n';
+    // Show definition location if available
+    if (definitionFile && definitionLine) {
+        output += color('dim', `Definition: ${definitionFile}:${definitionLine}\n\n`);
+    }
+    // Group by file
+    const byFile = new Map();
+    for (const callSite of callSites) {
+        if (!byFile.has(callSite.file)) {
+            byFile.set(callSite.file, []);
+        }
+        byFile.get(callSite.file)?.push(callSite);
+    }
+    // Output each file
+    for (const [file, sites] of byFile.entries()) {
+        output += color('dim', `${file}:\n`);
+        for (const site of sites) {
+            output += `  ${color('dim', `L${site.line}:`)} ${site.context.trim()}\n`;
+        }
+        output += '\n';
+    }
+    return output;
+}
+/**
+ * Format callers result as JSON
+ *
+ * @param result - Callers result to format
+ * @returns JSON string
+ */
+function formatJSON(result) {
+    return JSON.stringify(result, null, 2);
+}
+/**
+ * Execute callers command
+ *
+ * Finds all locations where a function is called by:
+ * 1. Looking up the function definition in PROJECT_INDEX.json
+ * 2. Using kit grep to find all occurrences
+ * 3. Filtering out the definition line to show only call sites
+ *
+ * @param functionName - Name of the function to find callers for
+ * @param format - Output format (markdown or JSON)
+ */
+export async function executeCallers(functionName, format) {
+    try {
+        // Find the function definition in the index
+        let definitionFile;
+        let definitionLine;
+        try {
+            const index = await loadProjectIndex();
+            const definitions = findSymbol(index, functionName);
+            // Use the first definition found (functions should be unique)
+            const firstDef = definitions[0];
+            if (firstDef) {
+                definitionFile = firstDef.file;
+                definitionLine = firstDef.symbol.start_line;
+            }
+        }
+        catch {
+            // Index not available - we'll proceed without filtering the definition
+        }
+        // Use kit grep to find all occurrences
+        const grepResult = executeKitGrep({
+            pattern: functionName,
+            caseSensitive: true,
+            maxResults: 500,
+        });
+        // Handle errors
+        if ('error' in grepResult) {
+            if (format === OutputFormat.JSON) {
+                console.error(JSON.stringify({
+                    error: grepResult.error,
+                    functionName,
+                    isError: true,
+                }, null, 2));
+            }
+            else {
+                console.error(color('red', '\n❌ Error:'), grepResult.error, '\n');
+            }
+            process.exit(1);
+        }
+        // Filter matches to exclude the definition line
+        let matches = grepResult.matches;
+        if (definitionFile && definitionLine) {
+            matches = matches.filter((match) => !(match.file === definitionFile && match.line === definitionLine));
+        }
+        // Filter out matches that look like definitions rather than calls
+        // Heuristics:
+        // - Lines starting with "function ", "const ", "let ", "var ", "export function"
+        // - Lines with "= function" or "= (" (function assignments)
+        // - Lines with "export async function" (exported async functions)
+        matches = matches.filter((match) => {
+            const trimmed = match.content.trim();
+            const definitionPatterns = [
+                /^function\s+/, // function declarations
+                /^export\s+(async\s+)?function\s+/, // exported functions (sync or async)
+                /^(const|let|var)\s+\w+\s*=\s*function/, // function expressions
+                /^(const|let|var)\s+\w+\s*=\s*\(/, // arrow functions
+                /^(const|let|var)\s+\w+\s*=\s*async\s*\(/, // async arrow functions
+                /^async\s+function\s+/, // async function declarations
+            ];
+            return !definitionPatterns.some((pattern) => pattern.test(trimmed));
+        });
+        // Convert to call sites
+        const callSites = matches.map((match) => ({
+            file: match.file,
+            line: match.line || 0,
+            context: match.content,
+        }));
+        // Build result
+        const result = {
+            functionName,
+            definitionFile,
+            definitionLine,
+            callSites,
+            count: callSites.length,
+        };
+        // Output results
+        if (format === OutputFormat.JSON) {
+            console.log(formatJSON(result));
+        }
+        else {
+            console.log(formatMarkdown(result));
+        }
+    }
+    catch (error) {
+        if (format === OutputFormat.JSON) {
+            console.error(JSON.stringify({
+                error: error instanceof Error ? error.message : 'Unknown error',
+                functionName,
+                isError: true,
+            }, null, 2));
+        }
+        else {
+            console.error(color('red', '\n❌ Error:'), error instanceof Error ? error.message : error, '\n');
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=callers.js.map

package/dist/lib/commands/callers.js.map

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

package/dist/lib/commands/find.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Find command - Locate symbol definitions by name
+ *
+ * Searches PROJECT_INDEX.json for symbol definitions with exact or fuzzy matching.
+ * Supports dual output formats (markdown table or JSON).
+ */
+import { OutputFormat } from '../formatters/output';
+/**
+ * Execute find command
+ *
+ * @param symbol - Symbol name to search for
+ * @param format - Output format (markdown or JSON)
+ */
+export declare function executeFind(symbol: string, format: OutputFormat): Promise<void>;
+//# sourceMappingURL=find.d.ts.map

package/dist/lib/commands/find.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../src/lib/commands/find.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAS,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAwF1D;;;;;GAKG;AACH,wBAAsB,WAAW,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CAsDf"}

package/dist/lib/commands/find.js

@@ -0,0 +1,113 @@
+/**
+ * Find command - Locate symbol definitions by name
+ *
+ * Searches PROJECT_INDEX.json for symbol definitions with exact or fuzzy matching.
+ * Supports dual output formats (markdown table or JSON).
+ */
+import { color, OutputFormat } from '../formatters/output';
+import { findSymbol, findSymbolFuzzy, loadProjectIndex, } from '../utils/index-parser';
+/**
+ * Format symbol results as markdown table
+ */
+function formatMarkdown(results, query) {
+    if (results.length === 0) {
+        return color('yellow', `\n⚠️  No symbols found matching: ${query}\n`);
+    }
+    let output = color('cyan', `\n📍 Found ${results.length} symbol(s)\n\n`);
+    // Group by file
+    const byFile = new Map();
+    for (const { file, symbol } of results) {
+        if (!byFile.has(file)) {
+            byFile.set(file, []);
+        }
+        byFile.get(file)?.push(symbol);
+    }
+    // Output each file
+    for (const [file, symbols] of byFile.entries()) {
+        output += color('dim', `${file}:\n`);
+        for (const symbol of symbols) {
+            const typeColor = getTypeColor(symbol.type);
+            output += `  ${color('dim', '•')} ${color(typeColor, symbol.type.padEnd(10))} ${color('blue', symbol.name)} ${color('dim', `(line ${symbol.start_line}`)}\n`;
+        }
+        output += '\n';
+    }
+    return output;
+}
+/**
+ * Get color for symbol type
+ */
+function getTypeColor(type) {
+    switch (type) {
+        case 'function':
+            return 'blue';
+        case 'class':
+            return 'green';
+        case 'interface':
+        case 'type':
+            return 'magenta';
+        case 'constant':
+            return 'cyan';
+        default:
+            return 'yellow';
+    }
+}
+/**
+ * Format symbol results as JSON
+ */
+function formatJSON(results, query) {
+    return JSON.stringify({
+        query,
+        count: results.length,
+        results: results.map(({ file, symbol }) => ({
+            file,
+            name: symbol.name,
+            type: symbol.type,
+            line: symbol.start_line,
+            code: symbol.code,
+        })),
+    }, null, 2);
+}
+/**
+ * Execute find command
+ *
+ * @param symbol - Symbol name to search for
+ * @param format - Output format (markdown or JSON)
+ */
+export async function executeFind(symbol, format) {
+    try {
+        const index = await loadProjectIndex();
+        // Try exact match first
+        let results = findSymbol(index, symbol);
+        // If no exact match, try fuzzy search
+        if (results.length === 0) {
+            const fuzzyResults = findSymbolFuzzy(index, symbol);
+            if (fuzzyResults.length > 0 && format === OutputFormat.MARKDOWN) {
+                console.log(color('yellow', `\n⚠️  No exact match for "${symbol}". Showing fuzzy matches:\n`));
+            }
+            results = fuzzyResults.map(({ file, symbol: sym }) => ({
+                file,
+                symbol: sym,
+            }));
+        }
+        // Output results
+        if (format === OutputFormat.JSON) {
+            console.log(formatJSON(results, symbol));
+        }
+        else {
+            console.log(formatMarkdown(results, symbol));
+        }
+    }
+    catch (error) {
+        if (format === OutputFormat.JSON) {
+            console.error(JSON.stringify({
+                error: error instanceof Error ? error.message : 'Unknown error',
+                isError: true,
+            }, null, 2));
+        }
+        else {
+            console.error(color('red', '\n❌ Error:'), error instanceof Error ? error.message : error);
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=find.js.map

package/dist/lib/commands/find.js.map

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

package/dist/lib/commands/overview.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Overview command - List all symbols in a file
+ */
+import { OutputFormat } from '../formatters/output';
+export declare function executeOverview(file: string, format: OutputFormat): Promise<void>;
+//# sourceMappingURL=overview.d.ts.map

package/dist/lib/commands/overview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overview.d.ts","sourceRoot":"","sources":["../../../src/lib/commands/overview.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAS,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAO1D,wBAAsB,eAAe,CACpC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CA0Df"}

package/dist/lib/commands/overview.js

@@ -0,0 +1,52 @@
+/**
+ * Overview command - List all symbols in a file
+ */
+import { color, OutputFormat } from '../formatters/output';
+import { getFileSymbols, loadProjectIndex, } from '../utils/index-parser';
+export async function executeOverview(file, format) {
+    try {
+        const index = await loadProjectIndex();
+        const symbols = getFileSymbols(index, file);
+        if (symbols.length === 0) {
+            if (format === OutputFormat.JSON) {
+                console.log(JSON.stringify({ file, symbols: [] }, null, 2));
+            }
+            else {
+                console.log(color('yellow', `\n⚠️  No symbols found in: ${file}\n`));
+            }
+            return;
+        }
+        if (format === OutputFormat.JSON) {
+            console.log(JSON.stringify({ file, count: symbols.length, symbols }, null, 2));
+        }
+        else {
+            // Group by type
+            const grouped = symbols.reduce((acc, sym) => {
+                if (!acc[sym.type])
+                    acc[sym.type] = [];
+                acc[sym.type]?.push(sym);
+                return acc;
+            }, {});
+            console.log(color('cyan', `\n📄 ${file}\n`));
+            console.log(color('dim', `Total symbols: ${symbols.length}\n`));
+            for (const [type, syms] of Object.entries(grouped)) {
+                console.log(color('magenta', `${type}s:`));
+                for (const sym of syms) {
+                    console.log(`  ${color('dim', '•')} ${color('blue', sym.name)} ${color('dim', `(line ${sym.start_line})`)}`);
+                }
+                console.log('');
+            }
+        }
+    }
+    catch (error) {
+        console.error(format === OutputFormat.JSON
+            ? JSON.stringify({
+                error: error instanceof Error ? error.message : 'Unknown error',
+                isError: true,
+            }, null, 2)
+            : color('red', '\n❌ Error:') +
+                ` ${error instanceof Error ? error.message : error}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=overview.js.map

package/dist/lib/commands/overview.js.map

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

package/dist/lib/commands/prime.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Prime command - Generate or refresh PROJECT_INDEX.json
+ *
+ * Migrated from prime-reporter.ts to integrate with kit-index CLI.
+ * Supports dual output formats (markdown with colors, or JSON).
+ */
+import { OutputFormat } from '../formatters/output';
+/**
+ * Execute prime command
+ *
+ * @param force - Force regenerate even if index is fresh
+ * @param format - Output format (markdown or JSON)
+ * @param customPath - Optional custom path to index (defaults to git root or CWD)
+ */
+export declare function executePrime(force: boolean, format: OutputFormat, customPath?: string): Promise<void>;
+//# sourceMappingURL=prime.d.ts.map

package/dist/lib/commands/prime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prime.d.ts","sourceRoot":"","sources":["../../../src/lib/commands/prime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,EAAS,YAAY,EAAE,MAAM,sBAAsB,CAAA;AA0L1D;;;;;;GAMG;AACH,wBAAsB,YAAY,CACjC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,YAAY,EACpB,UAAU,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CA4Df"}

package/dist/lib/commands/prime.js

@@ -0,0 +1,168 @@
+/**
+ * Prime command - Generate or refresh PROJECT_INDEX.json
+ *
+ * Migrated from prime-reporter.ts to integrate with kit-index CLI.
+ * Supports dual output formats (markdown with colors, or JSON).
+ */
+import { join } from 'node:path';
+import { getFileAgeHours, getFileSizeMB } from '@side-quest/core/fs';
+import { ensureCommandAvailable, spawnWithTimeout, } from '@side-quest/core/spawn';
+import { color, OutputFormat } from '../formatters/output';
+import { getTargetDir, INDEX_FILE, MAX_AGE_HOURS } from '../utils/git.js';
+/**
+ * Parse index stats from PROJECT_INDEX.json
+ */
+async function parseIndexStats(indexPath) {
+    const file = Bun.file(indexPath);
+    const json = (await file.json());
+    const symbolCount = Object.values(json.symbols).reduce((sum, arr) => sum + arr.length, 0);
+    return {
+        files: json.files.length,
+        symbols: symbolCount,
+        hasTree: json.file_tree !== undefined,
+    };
+}
+/**
+ * Generate the index using kit CLI
+ */
+async function generateIndex(targetDir, indexPath) {
+    const kitCmd = ensureCommandAvailable('kit');
+    const startTime = Date.now();
+    const result = await spawnWithTimeout([kitCmd, 'index', targetDir, '-o', indexPath], 60_000);
+    if (result.timedOut) {
+        throw new Error('kit index timed out');
+    }
+    if (result.exitCode !== 0) {
+        throw new Error(`kit index failed: ${result.stderr}`);
+    }
+    const durationSec = (Date.now() - startTime) / 1000;
+    return { durationSec };
+}
+/**
+ * Report existing index (markdown format)
+ */
+async function reportExistingMarkdown(ageHours, indexPath, targetDir) {
+    const stats = await parseIndexStats(indexPath);
+    const size = getFileSizeMB(indexPath);
+    console.log(color('cyan', '\n📊 PROJECT_INDEX.json exists\n'));
+    console.log(color('dim', `Location: ${targetDir}`));
+    console.log(color('dim', `Age: ${ageHours.toFixed(1)} hours`));
+    console.log(color('dim', `Files: ${stats.files}`));
+    console.log(color('dim', `Symbols: ${stats.symbols}`));
+    console.log(color('dim', `Size: ${size} MB`));
+    console.log(color('yellow', '\n⚠️  Index is less than 24 hours old. Use --force to regenerate.'));
+}
+/**
+ * Report existing index (JSON format)
+ */
+async function reportExistingJSON(ageHours, indexPath, targetDir) {
+    const stats = await parseIndexStats(indexPath);
+    const sizeMB = getFileSizeMB(indexPath);
+    console.log(JSON.stringify({
+        status: 'exists',
+        location: targetDir,
+        ageHours: Number.parseFloat(ageHours.toFixed(1)),
+        files: stats.files,
+        symbols: stats.symbols,
+        size: `${sizeMB} MB`,
+        message: 'Index is less than 24 hours old. Use --force to regenerate.',
+    }, null, 2));
+}
+/**
+ * Report successful generation (markdown format)
+ */
+async function reportSuccessMarkdown(durationSec, indexPath, targetDir) {
+    const stats = await parseIndexStats(indexPath);
+    const sizeMB = getFileSizeMB(indexPath);
+    console.log(color('green', '\n✅ PROJECT_INDEX.json generated successfully\n'));
+    console.log(color('cyan', 'Stats:'));
+    console.log(`  ${color('dim', '•')} Location: ${color('blue', targetDir)}`);
+    console.log(`  ${color('dim', '•')} Files indexed: ${color('blue', stats.files.toString())}`);
+    console.log(`  ${color('dim', '•')} Symbols extracted: ${color('blue', stats.symbols.toString())}`);
+    console.log(`  ${color('dim', '•')} Index size: ${color('blue', `${sizeMB} MB`)}`);
+    console.log(`  ${color('dim', '•')} Time taken: ${color('blue', `${durationSec.toFixed(1)}s`)}`);
+    console.log(color('cyan', '\nYou can now use:'));
+    console.log(`  ${color('dim', '•')} ${color('magenta', 'bun run src/cli.ts find <symbol>')} - Find symbol definitions`);
+    console.log(`  ${color('dim', '•')} ${color('magenta', 'bun run src/cli.ts callers <fn>')} - Find who calls a function`);
+    console.log(`  ${color('dim', '•')} ${color('magenta', 'bun run src/cli.ts overview <file>')} - Get file symbol summary`);
+    console.log(`  ${color('dim', '•')} ${color('magenta', 'bun run src/cli.ts stats')} - Codebase overview`);
+}
+/**
+ * Report successful generation (JSON format)
+ */
+async function reportSuccessJSON(durationSec, indexPath, targetDir) {
+    const stats = await parseIndexStats(indexPath);
+    const sizeMB = getFileSizeMB(indexPath);
+    console.log(JSON.stringify({
+        success: true,
+        location: targetDir,
+        stats: {
+            files: stats.files,
+            symbols: stats.symbols,
+            hasTree: stats.hasTree,
+            size: `${sizeMB} MB`,
+            durationSec: Number.parseFloat(durationSec.toFixed(1)),
+        },
+    }, null, 2));
+}
+/**
+ * Execute prime command
+ *
+ * @param force - Force regenerate even if index is fresh
+ * @param format - Output format (markdown or JSON)
+ * @param customPath - Optional custom path to index (defaults to git root or CWD)
+ */
+export async function executePrime(force, format, customPath) {
+    try {
+        // Determine target directory and index path
+        const targetDir = await getTargetDir(customPath);
+        const indexPath = join(targetDir, INDEX_FILE);
+        const ageHours = getFileAgeHours(indexPath);
+        // Check if index exists and is fresh
+        if (ageHours !== null && ageHours <= MAX_AGE_HOURS && !force) {
+            if (format === OutputFormat.JSON) {
+                await reportExistingJSON(ageHours, indexPath, targetDir);
+            }
+            else {
+                await reportExistingMarkdown(ageHours, indexPath, targetDir);
+            }
+            return;
+        }
+        // Generate progress indicator (markdown only)
+        if (format === OutputFormat.MARKDOWN) {
+            console.log(color('blue', '▶ Generating index...'));
+        }
+        // Generate new index
+        const { durationSec } = await generateIndex(targetDir, indexPath);
+        // Report success
+        if (format === OutputFormat.JSON) {
+            await reportSuccessJSON(durationSec, indexPath, targetDir);
+        }
+        else {
+            await reportSuccessMarkdown(durationSec, indexPath, targetDir);
+        }
+    }
+    catch (error) {
+        if (format === OutputFormat.JSON) {
+            console.error(JSON.stringify({
+                error: error instanceof Error ? error.message : 'Unknown error',
+                isError: true,
+            }, null, 2));
+        }
+        else {
+            console.error(color('red', '\n❌ Error:'), error);
+            // Check if kit is installed
+            try {
+                ensureCommandAvailable('kit');
+            }
+            catch {
+                console.error(color('yellow', '\n💡 Kit CLI not found. Install with:'));
+                console.error(color('dim', '  uv tool install cased-kit'));
+                console.error(color('dim', '  # or'));
+                console.error(color('dim', '  pipx install cased-kit'));
+            }
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=prime.js.map

package/dist/lib/commands/prime.js.map

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

package/dist/lib/commands/search.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Semantic search command - Natural language code search
+ *
+ * Uses kit semantic search to find code by meaning rather than exact text.
+ * Gracefully falls back to grep if ML dependencies unavailable.
+ */
+import { OutputFormat } from '../formatters/output';
+import type { SemanticOptions } from '../types';
+/**
+ * Execute semantic search command
+ *
+ * Performs natural language search over codebase using vector embeddings.
+ * Shows warning with install instructions if semantic unavailable.
+ *
+ * @param query - Natural language search query
+ * @param options - Search options (path, topK, chunkBy, buildIndex)
+ * @param format - Output format (markdown or JSON)
+ */
+export declare function executeSearch(query: string, options: Omit<SemanticOptions, 'query'>, format: OutputFormat): Promise<void>;
+//# sourceMappingURL=search.d.ts.map

package/dist/lib/commands/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/lib/commands/search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAS,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAE1D,OAAO,KAAK,EAAiB,eAAe,EAAkB,MAAM,UAAU,CAAA;AAE9E;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAClC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,EACvC,MAAM,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CAuEf"}