/**
 * Command-spec presets — opinionated defaults for the common tool command shapes.
 */
import { type CommandSpec, type CommonFlagKey, type ArgSpec, type StaticHandlerDescriptor, type ToolCliContext, type OptionSpec, type PrimaryCommandSpecDraft } from '@opensip-cli/core';
type PresetHandler<TOpts> = CommandSpec<TOpts, ToolCliContext>['handler'];
interface CommandPresetInput<TOpts> {
    readonly name: string;
    readonly description: string;
    readonly aliases?: readonly string[];
    readonly options?: readonly OptionSpec[];
    readonly args?: readonly ArgSpec[];
    readonly handler: PresetHandler<TOpts>;
    /**
     * Optional author-declared static handler identity for audit bridging.
     * Copied unchanged into the core {@link CommandSpec}; omission is valid for
     * third-party/pre-feature tools (reported later as an unresolved bridge).
     */
    readonly staticHandler?: StaticHandlerDescriptor;
}
interface PrimaryRunCommandPresetInput<TOpts> {
    readonly description: string;
    readonly options?: readonly OptionSpec[];
    readonly args?: readonly ArgSpec[];
    readonly handler: PresetHandler<TOpts>;
    /**
     * Opt this primary run command into first-run (no-init) execution — see
     * {@link CommandSpec.noInit}. Opt-in per tool rather than a preset default:
     * a command is only first-run-capable if it can produce a meaningful result
     * from a synthesized config alone (`fit`/`graph` can; `sim` needs authored
     * scenarios).
     */
    readonly noInit?: boolean;
    /**
     * Optional author-declared static handler identity for audit bridging.
     * First-party direct callers supply an exact package+path+declaration
     * descriptor; omission remains allowed for third-party compatibility.
     */
    readonly staticHandler?: StaticHandlerDescriptor;
}
/** Common flags for report-producing primary run commands. */
export declare const REPORTING_RUN_COMMON_FLAGS: readonly CommonFlagKey[];
/** Shared gate trigger flags for tools that participate in the baseline plane. */
export declare const gateRunFlagSpecs: readonly OptionSpec[];
/** Shared SARIF side-output trigger for verdict-producing run commands. */
export declare const sarifRunFlagSpec: OptionSpec;
/** Primary first-party run command with runtime dispatch and the full report surface. */
export declare function definePrimaryRunCommand<TOpts>(input: PrimaryRunCommandPresetInput<TOpts>): PrimaryCommandSpecDraft<TOpts, ToolCliContext>;
/** Primary run command: signal-envelope output with the ADR-0021 mandatory flag set. */
export declare function defineRunCommand<TOpts extends Record<string, unknown>>(input: CommandPresetInput<TOpts>): CommandSpec<TOpts, ToolCliContext>;
/** List/catalog command: structured command-result with cwd + json. */
export declare function defineListCommand<TOpts extends Record<string, unknown>>(input: CommandPresetInput<TOpts>): CommandSpec<TOpts, ToolCliContext>;
/** Post-write status confirmation (baseline export, symbol index, …). */
export declare function defineAuxExportCommand<TOpts extends Record<string, unknown>>(input: CommandPresetInput<TOpts>): CommandSpec<TOpts, ToolCliContext>;
export {};
//# sourceMappingURL=command-presets.d.ts.map