import type { CommandLogConfig } from '../config/aiwg-config.js';
export type CommandLogScope = 'project' | 'global';
export interface CommandLogEvent {
    schema_version: 1;
    timestamp: string;
    invocation_id?: string;
    command: string;
    flags: string[];
    positional_count: number;
    duration_ms: number;
    exit_status: number;
    aiwg_version: string;
    provider?: string;
    project?: {
        root_hash: string;
        relative_path: string;
    };
    cwd_hash: string;
    scope: CommandLogScope;
}
export interface CommandLogAppendInput {
    command: string;
    args: string[];
    cwd: string;
    frameworkRoot: string;
    durationMs: number;
    exitStatus: number;
    env?: NodeJS.ProcessEnv;
}
export interface CommandLogReportOptions {
    cwd: string;
    frameworkRoot: string;
    json?: boolean;
    limit?: number;
    scope?: CommandLogScope | 'all';
    env?: NodeJS.ProcessEnv;
}
export declare function maybeAppendCommandLog(input: CommandLogAppendInput): Promise<void>;
export declare function readCommandLogReport(options: CommandLogReportOptions): Promise<{
    events: CommandLogEvent[];
    summary: {
        total: number;
        by_command: Record<string, number>;
        failures_by_command: Record<string, number>;
        by_scope: Record<string, number>;
    };
    paths: string[];
}>;
export declare function printCommandLogReport(options: CommandLogReportOptions): Promise<void>;
export type { CommandLogConfig };
//# sourceMappingURL=command-log.d.ts.map