/** The grouped-summary buckets and their display order. */
type HelpGroupId = "Setup" | "Check" | "Run" | "Console" | "Observe" | "Maintain";
interface HelpEntry {
    /** Canonical command key (also the `help <command>` topic). */
    readonly command: string;
    /** Which summary-screen bucket this command belongs to. */
    readonly group: HelpGroupId;
    /**
     * Short summary-screen signature: command name plus its primary subcommand
     * shape only (e.g. `runs [report|audit]`). Full flag signatures live in the
     * detail view, not on the scannable summary.
     */
    readonly short: string;
    /** One-line description shown beside {@link short} on the summary screen. */
    readonly summary: string;
    /** True when a PR3 `--json` surface exists; renders a `[--json]` marker. */
    readonly json?: boolean;
    /** Full signature block for the `help <command>` detail view. */
    readonly signature: string;
    /** Detail lines for the `help <command>` view. */
    readonly lines: readonly string[];
}
export declare const HELP_COMMANDS: readonly HelpEntry[];
/** `help <alias>` resolves to the canonical command's detail view, noting the alias. */
export declare const HELP_ALIASES: Map<string, string>;
/**
 * Build the default grouped help summary: one scannable line per command under
 * its group heading, with `[--json]` markers on the PR3 JSON surfaces. Also used
 * by the error paths (unknown command / parse failure) so those stay short.
 */
export declare function renderHelp(): string;
/** The outcome of resolving a `help <topic>` request. */
export type HelpTopicResult = {
    readonly ok: true;
    readonly text: string;
} | {
    readonly ok: false;
    readonly message: string;
};
/**
 * Resolve a `help <topic>` request: `notes` prints the notes block, a command
 * (or its alias) prints that command's detail view, a removed command prints its
 * replacement pointer, and anything else is a usage error listing valid topics.
 */
export declare function renderHelpTopic(topic: string): HelpTopicResult;
/**
 * The published CLI version, read from this package's own package.json at
 * runtime. `../package.json` resolves the same from both `src/cli.ts` (tests) and
 * the built `dist/cli.js` (one level below the package root in both layouts), and
 * npm always ships package.json in the tarball. Best-effort: a read failure yields
 * "unknown" rather than crashing `--version`.
 */
export declare function monoAgentVersion(): string;
export {};
//# sourceMappingURL=cli-help.d.ts.map