export type EventType = 'command' | 'task_start' | 'task_complete' | 'task_fail' | 'iteration_create' | 'spec_generate';
export interface AnalyticsEvent {
    type: EventType;
    timestamp: string;
    user: string;
    command?: string;
    task?: string;
    iteration?: string;
    durationMs?: number;
    metadata?: Record<string, unknown>;
}
export interface UsageReport {
    generatedAt: string;
    user: string;
    periodDays: number;
    totalCommands: number;
    commandFrequency: Record<string, number>;
    totalTasks: number;
    completedTasks: number;
    failedTasks: number;
    avgTaskDurationMin: number;
    activeIterations: string[];
    recommendations: string[];
}
/**
 * 记录事件
 */
export declare function recordEvent(cwd: string, event: Omit<AnalyticsEvent, 'timestamp' | 'user'>): Promise<void>;
/**
 * 记录命令执行
 */
export declare function recordCommand(cwd: string, command: string, durationMs?: number): Promise<void>;
/**
 * 生成使用报告
 */
export declare function generateUsageReport(cwd: string, periodDays?: number): Promise<UsageReport>;
/**
 * 格式化报告为可读文本
 */
export declare function formatUsageReport(report: UsageReport): string;
//# sourceMappingURL=usage-analytics.d.ts.map