/**
 * Dynamic command registry from self-describing script headers.
 *
 * Parses ###CLEO header blocks from script files and builds a registry
 * of available commands with metadata (category, synopsis, flags, etc.).
 *
 * @task T4454
 * @epic T4454
 */
/** Parsed command metadata. */
export interface CommandMeta {
    command: string;
    category: string;
    synopsis: string;
    aliases: string[];
    relevance: string;
    flags: string[];
    exits: string[];
    jsonOutput: boolean;
    jsonDefault: boolean;
    subcommands: string[];
    note: string;
    aliasFor: string;
    scriptName: string;
}
/** Parse a ###CLEO header block from a script file. */
export declare function parseCommandHeader(scriptPath: string): CommandMeta | null;
/**
 * Scan a scripts directory and build a command registry.
 * Returns a map of command name to metadata.
 */
export declare function scanAllCommands(scriptsDir: string): Map<string, CommandMeta>;
/** Validate a command header has required fields. */
export declare function validateHeader(meta: CommandMeta): {
    valid: boolean;
    errors: string[];
};
/** Get command-to-script mapping. */
export declare function getCommandScriptMap(scriptsDir: string): Record<string, string>;
/** Group commands by category. */
export declare function getCommandsByCategory(scriptsDir: string): Record<string, CommandMeta[]>;
/** Filter commands by relevance level. */
export declare function getCommandsByRelevance(scriptsDir: string, relevance: string): CommandMeta[];
//# sourceMappingURL=command-registry.d.ts.map