import { parseArgs } from "node:util";
import { type CliOptionName, type CommandHelp, type CommandName } from "./cli-help.js";
type CliValues = ReturnType<typeof parseArgs>["values"];
interface CommandContract {
    minPositionals: number;
    maxPositionals: number;
    missingPositionalsMessage?: string;
}
interface CommandExecutionContext {
    values: CliValues;
    positionals: readonly string[];
    target: string;
}
interface CommandSpec {
    name: CommandName;
    positionals: CommandContract;
    optionNames: readonly CliOptionName[];
    help: CommandHelp;
    defaultFormat?: string;
    execute(context: CommandExecutionContext): Promise<number> | number;
    expectedError?(context: CommandExecutionContext, error: unknown): string | undefined;
}
export declare const COMMAND_REGISTRY: {
    init: CommandSpec;
    scan: CommandSpec;
    catalog: CommandSpec;
    graph: CommandSpec;
    "execution-contract": CommandSpec;
    "skill-index": CommandSpec;
    "trust-graph": CommandSpec;
    readiness: CommandSpec;
    bom: CommandSpec;
    ownership: CommandSpec;
    diff: CommandSpec;
    "ci-report": CommandSpec;
    inspect: CommandSpec;
    guide: CommandSpec;
    scaffold: CommandSpec;
    "suggest-metadata": CommandSpec;
    "suggest-semantic-split": CommandSpec;
};
export declare function main(argv?: string[]): Promise<number>;
export declare function comparisonRefs(values: {
    from?: unknown;
    base?: unknown;
    to?: unknown;
}, command: "diff" | "ci-report"): {
    fromRef: string;
    toRef: string;
} | {
    error: string;
};
export {};