import type { CliRegisteredCommandPolicyV2 } from './command-policy.registry';
export declare const CLI_COMMAND_CONTRACT_MATRIX_REPORT_SCHEMA_VERSION: "nexusclaw.cli-command-contract-matrix-report/v1";
export type CliMatrixScenarioKind = 'success' | 'empty' | 'failure' | 'dry-run';
export type CliMatrixCoverageStatus = 'tested' | 'exempted' | 'inapplicable' | 'missing';
export interface CliMatrixScenarioFixtureV1 {
    readonly argv: ReadonlyArray<string>;
    readonly adapterId: string;
}
export interface CliMatrixScenarioDeclarationV1 {
    readonly status: 'fixture' | 'inapplicable';
    readonly fixture?: CliMatrixScenarioFixtureV1;
    readonly reason?: string;
}
export type CliMatrixScenarioManifestV1 = Readonly<Record<string, CliMatrixScenarioDeclarationV1>>;
export interface CliMatrixCoverageEntryV1 {
    readonly scenarioId: string;
    readonly commandId: string;
    readonly modeId: string;
    readonly kind: CliMatrixScenarioKind;
    readonly status: CliMatrixCoverageStatus;
    readonly fixture?: CliMatrixScenarioFixtureV1;
    readonly reason?: string;
    readonly expiresOn?: string;
}
export interface CliCommandContractMatrixReportV1 {
    readonly schemaVersion: typeof CLI_COMMAND_CONTRACT_MATRIX_REPORT_SCHEMA_VERSION;
    readonly ok: boolean;
    readonly commandCount: number;
    readonly modeCount: number;
    readonly scenarioCount: number;
    readonly counts: Readonly<Record<CliMatrixCoverageStatus, number>>;
    readonly entries: ReadonlyArray<CliMatrixCoverageEntryV1>;
    readonly reportDigest: string;
}
export declare function matrixScenarioId(commandId: string, modeId: string, kind: CliMatrixScenarioKind): string;
export declare function buildPreDispatchFailureScenarioManifest(policies: ReadonlyArray<CliRegisteredCommandPolicyV2>): CliMatrixScenarioManifestV1;
export declare function buildControlledTerminalScenarioManifest(policies: ReadonlyArray<CliRegisteredCommandPolicyV2>): CliMatrixScenarioManifestV1;
export declare function buildCommandContractMatrixReport(policies: ReadonlyArray<CliRegisteredCommandPolicyV2>, manifest: CliMatrixScenarioManifestV1, executedScenarioIds?: ReadonlySet<string>): CliCommandContractMatrixReportV1;
export declare function assertCommandContractMatrixComplete(report: CliCommandContractMatrixReportV1): void;