export type CommandSafety = "READ_ONLY" | "PROPOSAL_ONLY" | "POTENTIALLY_MUTATING" | "MUTATING";
export interface CommandMetadata {
    command: string;
    safety: CommandSafety;
    description: string;
    requiresApproval?: boolean;
}
/**
 * Look up safety metadata for a fully-qualified command string.
 * Returns undefined for unknown commands.
 */
export declare function getCommandSafety(command: string): CommandMetadata | undefined;
/**
 * Return true if the command is safe to run during Discovery.
 * Only READ_ONLY and PROPOSAL_ONLY commands are discovery-safe.
 */
export declare function isSafeForDiscovery(command: string): boolean;
/**
 * Assert that a command is safe for Discovery, throwing a clear
 * phase-boundary error when it is not.
 */
export declare function assertSafeForDiscovery(command: string): void;