@nicolasmondain/cli-agent 3.0.2

package/dist/command/dynamic-command.factory.js

@@ -0,0 +1,161 @@
+/**
+ * Dynamic Command Factory
+ *
+ * Creates Commander.js commands from configuration.
+ */
+import { Command } from "commander";
+import { executeScript, } from "../executor/script-executor.js";
+import { outputResult } from "../infra/output.js";
+import { setLogLevel, logDebug, logError } from "../infra/logger.js";
+/**
+ * Create a Commander command from configuration
+ *
+ * @param config - Command configuration from CLI config file
+ * @param configDir - Directory containing the configuration file
+ * @returns Configured Commander command
+ */
+export function createDynamicCommand(config, configDir) {
+    const command = new Command(config.name);
+    // Set description
+    if (config.description) {
+        command.description(config.description);
+    }
+    // Add positional arguments
+    if (config.arguments) {
+        for (const arg of config.arguments) {
+            const argSyntax = buildArgumentSyntax(arg);
+            command.argument(argSyntax, arg.description ?? "");
+        }
+    }
+    // Add options
+    if (config.options) {
+        for (const opt of config.options) {
+            if (opt.required) {
+                command.requiredOption(opt.flags, opt.description ?? "", opt.default);
+            }
+            else {
+                const option = command.createOption(opt.flags, opt.description ?? "");
+                if (opt.default !== undefined) {
+                    option.default(opt.default);
+                }
+                if (opt.choices) {
+                    option.choices(opt.choices);
+                }
+                command.addOption(option);
+            }
+        }
+    }
+    // Add standard options (only if not already defined in config)
+    const existingFlags = new Set((config.options ?? []).flatMap((opt) => opt.flags.split(",").map((f) => f.trim().split(/[\s<[]/)[0])));
+    if (!existingFlags.has("--format")) {
+        command.option("--format <format>", "Output format: human or json", "human");
+    }
+    if (!existingFlags.has("--quiet")) {
+        command.option("--quiet", "Suppress all output except errors");
+    }
+    if (!existingFlags.has("--verbose")) {
+        command.option("--verbose", "Show detailed output");
+    }
+    if (!existingFlags.has("--debug")) {
+        command.option("--debug", "Show debug information");
+    }
+    // Add action handler
+    command.action(async (...actionArgs) => {
+        try {
+            // Parse arguments and options from Commander
+            const { args, options } = parseActionArgs(config, actionArgs);
+            // Set log level based on options
+            const logLevel = resolveLogLevel(options);
+            setLogLevel(logLevel);
+            logDebug("Executing command", {
+                name: config.name,
+                script: config.script,
+                args,
+                options: { ...options, format: options.format },
+            });
+            // Build script context
+            const context = {
+                args,
+                options,
+                cwd: process.cwd(),
+                format: validateFormat(options.format),
+            };
+            // Execute the script
+            const result = await executeScript(config.script, context, configDir);
+            logDebug("Script result", result);
+            // Output result
+            outputResult(result, context.format);
+            // Exit with appropriate code
+            if (!result.success) {
+                process.exit(1);
+            }
+        }
+        catch (error) {
+            logError("Command execution failed", error);
+            outputResult({
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            }, "human");
+            process.exit(1);
+        }
+    });
+    return command;
+}
+/**
+ * Build Commander argument syntax from configuration
+ */
+function buildArgumentSyntax(arg) {
+    const name = arg.name;
+    const required = arg.required !== false; // Default to required
+    if (arg.variadic) {
+        return required ? `<${name}...>` : `[${name}...]`;
+    }
+    return required ? `<${name}>` : `[${name}]`;
+}
+/**
+ * Parse action arguments from Commander callback
+ *
+ * Commander.js passes arguments to action handlers in this order:
+ * 1. Positional arguments (in order)
+ * 2. Options object (from command.opts())
+ * 3. Command instance itself
+ *
+ * However, when using .action(), the last argument is always the Command instance.
+ * Options must be retrieved via command.opts() method.
+ */
+function parseActionArgs(config, actionArgs) {
+    const args = {};
+    // The last argument is always the Command instance
+    const commandInstance = actionArgs[actionArgs.length - 1];
+    // Get options from the Command instance
+    const options = commandInstance.opts();
+    // Positional arguments are all items except the last one (Command instance)
+    const positionalArgs = actionArgs.slice(0, -1);
+    if (config.arguments) {
+        config.arguments.forEach((argConfig, index) => {
+            if (index < positionalArgs.length) {
+                args[argConfig.name] = positionalArgs[index];
+            }
+        });
+    }
+    return { args, options };
+}
+/**
+ * Resolve log level from command options
+ */
+function resolveLogLevel(options) {
+    if (options.debug)
+        return "debug";
+    if (options.verbose)
+        return "verbose";
+    if (options.quiet)
+        return "quiet";
+    return "normal";
+}
+/**
+ * Validate and normalize output format
+ */
+function validateFormat(format) {
+    return format === "json" ? "json" : "human";
+}
+//# sourceMappingURL=dynamic-command.factory.js.map

package/dist/command/dynamic-command.factory.js.map

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

package/dist/config/config-loader.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Configuration Loader
+ *
+ * Finds and loads CLI configuration from multiple sources.
+ */
+import type { LoadConfigResult } from "./config-schema.js";
+/**
+ * Load configuration from multiple sources (in order of precedence)
+ *
+ * 1. Explicit path via --config flag
+ * 2. .cli-agent.json in current working directory
+ * 3. cli-agent field in package.json
+ * 4. ~/.cli-agent.json for global commands
+ *
+ * @param explicitPath - Optional explicit path to configuration file
+ * @returns Configuration result or null if no configuration found
+ */
+export declare function loadConfig(explicitPath?: string): Promise<LoadConfigResult | null>;
+/**
+ * Get the configuration file path from command line args
+ * Looks for -c or --config flags
+ */
+export declare function getExplicitConfigPath(): string | undefined;
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/config/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/config/config-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAI3D;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAC9B,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAuBlC;AAgDD;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,SAAS,CAe1D"}

package/dist/config/config-loader.js

@@ -0,0 +1,95 @@
+/**
+ * Configuration Loader
+ *
+ * Finds and loads CLI configuration from multiple sources.
+ */
+import { readFile } from "node:fs/promises";
+import { resolve, dirname } from "node:path";
+import { homedir } from "node:os";
+import { validateConfig, ConfigValidationError } from "./config-validator.js";
+import { pathExists } from "../services/file-system.service.js";
+/**
+ * Load configuration from multiple sources (in order of precedence)
+ *
+ * 1. Explicit path via --config flag
+ * 2. .cli-agent.json in current working directory
+ * 3. cli-agent field in package.json
+ * 4. ~/.cli-agent.json for global commands
+ *
+ * @param explicitPath - Optional explicit path to configuration file
+ * @returns Configuration result or null if no configuration found
+ */
+export async function loadConfig(explicitPath) {
+    const sources = [];
+    // Add explicit path first if provided
+    if (explicitPath) {
+        sources.push(resolve(process.cwd(), explicitPath));
+    }
+    // Add standard configuration locations
+    sources.push(resolve(process.cwd(), ".cli-agent.json"), resolve(process.cwd(), "package.json"), resolve(homedir(), ".cli-agent.json"));
+    for (const source of sources) {
+        const result = await tryLoadConfig(source);
+        if (result) {
+            return result;
+        }
+    }
+    return null;
+}
+/**
+ * Try to load configuration from a specific file
+ */
+async function tryLoadConfig(filePath) {
+    if (!(await pathExists(filePath))) {
+        return null;
+    }
+    try {
+        const content = await readFile(filePath, "utf-8");
+        const parsed = JSON.parse(content);
+        // Handle package.json case
+        if (filePath.endsWith("package.json")) {
+            if (!parsed["cli-agent"]) {
+                return null;
+            }
+            const config = validateConfig(parsed["cli-agent"]);
+            return {
+                config,
+                configPath: filePath,
+                configDir: dirname(filePath),
+            };
+        }
+        // Handle .cli-agent.json
+        const config = validateConfig(parsed);
+        return {
+            config,
+            configPath: filePath,
+            configDir: dirname(filePath),
+        };
+    }
+    catch (error) {
+        if (error instanceof ConfigValidationError) {
+            throw error;
+        }
+        if (error instanceof SyntaxError) {
+            throw new Error(`Invalid JSON in ${filePath}: ${error.message}`);
+        }
+        // File read errors or other issues - skip this source
+        return null;
+    }
+}
+/**
+ * Get the configuration file path from command line args
+ * Looks for -c or --config flags
+ */
+export function getExplicitConfigPath() {
+    const args = process.argv;
+    const configIndex = args.findIndex((arg) => arg === "-c" || arg === "--config");
+    if (configIndex !== -1) {
+        // Make sure the next arg is not another flag
+        const nextArg = args[configIndex + 1];
+        if (nextArg && !nextArg.startsWith("-")) {
+            return nextArg;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=config-loader.js.map

package/dist/config/config-loader.js.map

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

package/dist/config/config-schema.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Configuration Schema
+ *
+ * TypeScript types for CLI configuration.
+ */
+/**
+ * Root configuration for cli-agent
+ */
+export interface CliConfig {
+    /** CLI name (defaults to 'cli-agent') */
+    name?: string;
+    /** CLI version (defaults to package.json version) */
+    version?: string;
+    /** CLI description */
+    description?: string;
+    /** List of commands */
+    commands: CommandConfig[];
+}
+/**
+ * Configuration for a single command
+ */
+export interface CommandConfig {
+    /** Command name (e.g., 'feature-folder') */
+    name: string;
+    /** Command description for help text */
+    description?: string;
+    /** Path to script file (.js, .ts, or .sh) relative to config file */
+    script: string;
+    /** Positional arguments */
+    arguments?: ArgumentConfig[];
+    /** Command options */
+    options?: OptionConfig[];
+}
+/**
+ * Configuration for a positional argument
+ */
+export interface ArgumentConfig {
+    /** Argument name */
+    name: string;
+    /** Argument description */
+    description?: string;
+    /** Whether the argument is required (default: true) */
+    required?: boolean;
+    /** Whether the argument accepts multiple values (e.g., <files...>) */
+    variadic?: boolean;
+}
+/**
+ * Configuration for a command option
+ */
+export interface OptionConfig {
+    /** Option flags (e.g., '-n, --name <name>') */
+    flags: string;
+    /** Option description */
+    description?: string;
+    /** Default value */
+    default?: unknown;
+    /** Whether the option is required */
+    required?: boolean;
+    /** Allowed values */
+    choices?: string[];
+}
+/**
+ * Result of loading configuration
+ */
+export interface LoadConfigResult {
+    /** Parsed and validated configuration */
+    config: CliConfig;
+    /** Absolute path to the configuration file */
+    configPath: string;
+    /** Directory containing the configuration file */
+    configDir: string;
+}
+//# sourceMappingURL=config-schema.d.ts.map

package/dist/config/config-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.d.ts","sourceRoot":"","sources":["../../src/config/config-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uBAAuB;IACvB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAC7B,sBAAsB;IACtB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,MAAM,EAAE,SAAS,CAAC;IAClB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/config/config-schema.js

@@ -0,0 +1,7 @@
+/**
+ * Configuration Schema
+ *
+ * TypeScript types for CLI configuration.
+ */
+export {};
+//# sourceMappingURL=config-schema.js.map

package/dist/config/config-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.js","sourceRoot":"","sources":["../../src/config/config-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/config/config-validator.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Configuration Validator
+ *
+ * Validates CLI configuration structure.
+ */
+import type { CliConfig } from './config-schema.js';
+/**
+ * Validation error with details
+ */
+export declare class ConfigValidationError extends Error {
+    readonly path: string;
+    readonly value?: unknown | undefined;
+    constructor(message: string, path: string, value?: unknown | undefined);
+}
+/**
+ * Validate a configuration object
+ * @throws ConfigValidationError if validation fails
+ */
+export declare function validateConfig(config: unknown): CliConfig;
+//# sourceMappingURL=config-validator.d.ts.map

package/dist/config/config-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-validator.d.ts","sourceRoot":"","sources":["../../src/config/config-validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAA+C,MAAM,oBAAoB,CAAC;AAEjG;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;aAG5B,IAAI,EAAE,MAAM;aACZ,KAAK,CAAC,EAAE,OAAO;gBAF/B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,OAAO,YAAA;CAKlC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAiCzD"}

package/dist/config/config-validator.js

@@ -0,0 +1,162 @@
+/**
+ * Configuration Validator
+ *
+ * Validates CLI configuration structure.
+ */
+/**
+ * Validation error with details
+ */
+export class ConfigValidationError extends Error {
+    path;
+    value;
+    constructor(message, path, value) {
+        super(`Configuration error at '${path}': ${message}`);
+        this.path = path;
+        this.value = value;
+        this.name = 'ConfigValidationError';
+    }
+}
+/**
+ * Validate a configuration object
+ * @throws ConfigValidationError if validation fails
+ */
+export function validateConfig(config) {
+    if (!config || typeof config !== 'object') {
+        throw new ConfigValidationError('Configuration must be an object', 'root', config);
+    }
+    const cfg = config;
+    // Validate optional string fields
+    if (cfg.name !== undefined && typeof cfg.name !== 'string') {
+        throw new ConfigValidationError('Must be a string', 'name', cfg.name);
+    }
+    if (cfg.version !== undefined && typeof cfg.version !== 'string') {
+        throw new ConfigValidationError('Must be a string', 'version', cfg.version);
+    }
+    if (cfg.description !== undefined && typeof cfg.description !== 'string') {
+        throw new ConfigValidationError('Must be a string', 'description', cfg.description);
+    }
+    // Validate commands array
+    if (!Array.isArray(cfg.commands)) {
+        throw new ConfigValidationError('Must be an array', 'commands', cfg.commands);
+    }
+    const commands = cfg.commands.map((cmd, index) => validateCommand(cmd, `commands[${index}]`));
+    return {
+        name: cfg.name,
+        version: cfg.version,
+        description: cfg.description,
+        commands,
+    };
+}
+/**
+ * Validate a command configuration
+ */
+function validateCommand(cmd, path) {
+    if (!cmd || typeof cmd !== 'object') {
+        throw new ConfigValidationError('Must be an object', path, cmd);
+    }
+    const command = cmd;
+    // Required: name
+    if (typeof command.name !== 'string' || command.name.trim() === '') {
+        throw new ConfigValidationError('Must be a non-empty string', `${path}.name`, command.name);
+    }
+    // Required: script
+    if (typeof command.script !== 'string' || command.script.trim() === '') {
+        throw new ConfigValidationError('Must be a non-empty string', `${path}.script`, command.script);
+    }
+    // Optional: description
+    if (command.description !== undefined && typeof command.description !== 'string') {
+        throw new ConfigValidationError('Must be a string', `${path}.description`, command.description);
+    }
+    // Optional: arguments
+    let args;
+    if (command.arguments !== undefined) {
+        if (!Array.isArray(command.arguments)) {
+            throw new ConfigValidationError('Must be an array', `${path}.arguments`, command.arguments);
+        }
+        args = command.arguments.map((arg, index) => validateArgument(arg, `${path}.arguments[${index}]`));
+    }
+    // Optional: options
+    let options;
+    if (command.options !== undefined) {
+        if (!Array.isArray(command.options)) {
+            throw new ConfigValidationError('Must be an array', `${path}.options`, command.options);
+        }
+        options = command.options.map((opt, index) => validateOption(opt, `${path}.options[${index}]`));
+    }
+    return {
+        name: command.name,
+        description: command.description,
+        script: command.script,
+        arguments: args,
+        options,
+    };
+}
+/**
+ * Validate an argument configuration
+ */
+function validateArgument(arg, path) {
+    if (!arg || typeof arg !== 'object') {
+        throw new ConfigValidationError('Must be an object', path, arg);
+    }
+    const argument = arg;
+    // Required: name
+    if (typeof argument.name !== 'string' || argument.name.trim() === '') {
+        throw new ConfigValidationError('Must be a non-empty string', `${path}.name`, argument.name);
+    }
+    // Optional: description
+    if (argument.description !== undefined && typeof argument.description !== 'string') {
+        throw new ConfigValidationError('Must be a string', `${path}.description`, argument.description);
+    }
+    // Optional: required (default: true)
+    if (argument.required !== undefined && typeof argument.required !== 'boolean') {
+        throw new ConfigValidationError('Must be a boolean', `${path}.required`, argument.required);
+    }
+    // Optional: variadic (default: false)
+    if (argument.variadic !== undefined && typeof argument.variadic !== 'boolean') {
+        throw new ConfigValidationError('Must be a boolean', `${path}.variadic`, argument.variadic);
+    }
+    return {
+        name: argument.name,
+        description: argument.description,
+        required: argument.required,
+        variadic: argument.variadic,
+    };
+}
+/**
+ * Validate an option configuration
+ */
+function validateOption(opt, path) {
+    if (!opt || typeof opt !== 'object') {
+        throw new ConfigValidationError('Must be an object', path, opt);
+    }
+    const option = opt;
+    // Required: flags
+    if (typeof option.flags !== 'string' || option.flags.trim() === '') {
+        throw new ConfigValidationError('Must be a non-empty string', `${path}.flags`, option.flags);
+    }
+    // Optional: description
+    if (option.description !== undefined && typeof option.description !== 'string') {
+        throw new ConfigValidationError('Must be a string', `${path}.description`, option.description);
+    }
+    // Optional: required
+    if (option.required !== undefined && typeof option.required !== 'boolean') {
+        throw new ConfigValidationError('Must be a boolean', `${path}.required`, option.required);
+    }
+    // Optional: choices
+    if (option.choices !== undefined) {
+        if (!Array.isArray(option.choices)) {
+            throw new ConfigValidationError('Must be an array', `${path}.choices`, option.choices);
+        }
+        if (!option.choices.every((c) => typeof c === 'string')) {
+            throw new ConfigValidationError('All choices must be strings', `${path}.choices`, option.choices);
+        }
+    }
+    return {
+        flags: option.flags,
+        description: option.description,
+        default: option.default,
+        required: option.required,
+        choices: option.choices,
+    };
+}
+//# sourceMappingURL=config-validator.js.map

package/dist/config/config-validator.js.map

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

package/dist/executor/js-executor.d.ts

@@ -0,0 +1,29 @@
+/**
+ * JavaScript Executor
+ *
+ * Executes .js files by importing and calling their default export.
+ */
+import type { ScriptContext, ScriptResult } from './script-executor.js';
+/**
+ * Execute a JavaScript file
+ *
+ * The script must export a default async function that accepts ScriptContext
+ * and returns a CommandResult.
+ *
+ * Example script:
+ * ```javascript
+ * export default async function(context) {
+ *   return {
+ *     success: true,
+ *     message: 'Hello!',
+ *     data: { greeting: 'Hello!' }
+ *   };
+ * }
+ * ```
+ *
+ * @param scriptPath - Absolute path to the JavaScript file
+ * @param context - Execution context
+ * @returns Script execution result
+ */
+export declare function executeJavaScript(scriptPath: string, context: ScriptContext): Promise<ScriptResult>;
+//# sourceMappingURL=js-executor.d.ts.map

package/dist/executor/js-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"js-executor.d.ts","sourceRoot":"","sources":["../../src/executor/js-executor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGxE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CA2CvB"}