export type RunArgsSchemaOnlyCommandMetadata = {
    name: string;
    moduleId: string;
    instructionPath: string;
    description?: string;
};
/** Reset cached validators (tests). */
export declare function resetPilotRunArgsValidationCache(): void;
/**
 * JSON payload for `workspace-kit run <command> --schema-only`.
 *
 * Strict schemas come from the pilot snapshot. Commands without strict validation still get
 * router/manifest-backed discovery so every executable run command has one machine-readable shape.
 */
export declare function buildRunArgsSchemaOnlyPayload(commandName: string, metadata?: RunArgsSchemaOnlyCommandMetadata): Record<string, unknown> | null;
/**
 * When the command is in the pilot snapshot, validates CLI JSON args before module dispatch.
 * @returns Structured error payload for JSON stdout, or null when validation passes or command is not in the pilot.
 */
export declare function validatePilotRunCommandArgs(commandName: string, args: Record<string, unknown>, _effectiveConfig: Record<string, unknown>): Record<string, unknown> | null;
/**
 * Early planning-generation-required for selected mutators (before policy/session work).
 * `generate-recommendations` dryRun skips the gate (no task writes).
 */
export declare function enforcePlanningGenerationCliPrelude(commandName: string, args: Record<string, unknown>, effectiveConfig: Record<string, unknown>): Record<string, unknown> | null;
