/**
 * Organ / Plugin interface stub (future phase).
 */
import type { CLIConfig, CLIContext } from "./types";
/**
 * Plugin (organ) contract used to observe or augment CLI behavior.
 *
 * Methods are optional and executed by the `OrganManager` at well-defined
 * lifecycle points. Implementers should keep hooks fast and idempotent.
 */
export interface ClibuOrgan {
    /** Human-readable plugin name. */
    name: string;
    /** Optional version string for diagnostics. */
    version?: string;
    /** Called when the CLI configuration is registered/loaded. */
    onRegister?(config: CLIConfig): void;
    /** Called during argv parsing (relaxed first pass). */
    onParse?(argv: string[]): void;
    /** Called before the command `run()` handler executes. */
    onBeforeRun?(ctx: CLIContext): void | Promise<void>;
    /** Called after the command `run()` handler completes. */
    onAfterRun?(ctx: CLIContext, result: unknown): void | Promise<void>;
    /** Optionally return an augmented config (used by advanced organs). */
    extendConfig?(config: CLIConfig): CLIConfig;
}
export interface OrganManagerOptions {
    organs?: ClibuOrgan[];
}
/**
 * Simple manager that stores and invokes organs at lifecycle points. The
 * implementation is intentionally small — organs are an optional extension
 * mechanism and should not affect core correctness.
 */
export declare class OrganManager {
    private organs;
    constructor(opts?: OrganManagerOptions);
    /** Register an organ instance to receive lifecycle events. */
    register(organ: ClibuOrgan): void;
    /** Emit the `onRegister` event for all organs. */
    emitRegister(config: CLIConfig): void;
    /** Emit the `onParse` event for all organs. */
    emitParse(argv: string[]): void;
    /** Emit the `onBeforeRun` event for all organs (awaits asynchronous hooks). */
    emitBeforeRun(ctx: CLIContext): Promise<void>;
    /** Emit the `onAfterRun` event for all organs (awaits asynchronous hooks). */
    emitAfterRun(ctx: CLIContext, result: unknown): Promise<void>;
}