/**
 * G3 (2026-08-13): 操作级审计日志(借鉴 devtool audit.jsonl,附录 F.3)。
 *
 * 修复 devtool 的 writeFile read-modify-write 并发竞态(workflowAutomation.ts:267)
 * ——改用 fs/promises.appendFile(O_APPEND 内核原子,<PIPE_BUF 字节 POSIX 原子),
 * enhanced 多实例并发安全。
 *
 * 设计要点:
 * - 事后审计(after middleware),与事前门控(确认令牌/ReadOnlyGuard)正交(纵深防御)
 * - changed_files 用项目相对路径(PII 护栏:不记绝对路径含用户名)
 * - 回滚诚实:仅 create 类可删 + project.godot before_values,其余靠 Git(不过度承诺快照)
 * - 默认开(本地 .godot/ 落盘,无外传风险),GODOT_MCP_AUDIT=false 可关
 */
import type { RiskLevel } from './tool-registry.js';
/** audit 文件相对项目根的路径(对齐 .godot/ 惯例:mcp-instances/mcp-godot.json/mcp_editor.key)。 */
export declare const AUDIT_LOG_REL: readonly [".godot", "mcp_audit.jsonl"];
/** env 开关(默认开:本地落盘无外传,比 telemetry 安全)。 */
export declare function isAuditEnabled(): boolean;
/** B-1(审查修复):检测令牌请求响应(content 含 "requires_confirmation":true,操作未执行)。
 *  audit middleware 应跳过此类,不记虚假 ok=true。真实执行经 _auditConfirmedExecution 补审计。 */
export declare function isTokenRequestResult(result: {
    content?: ReadonlyArray<unknown>;
}): boolean;
/** audit 条目(对齐 devtool AuditEntry 5 字段 + enhanced 适配 trace_id/risk/ok)。 */
export interface AuditEntry {
    timestamp: string;
    trace_id: string;
    tool: string;
    action: string;
    risk: RiskLevel;
    ok: boolean;
    project_path: string;
    changed_files: string[];
    duration_ms: number;
    details?: {
        before_values?: Record<string, unknown>;
        batch?: boolean;
        truncated?: boolean;
        confirmed?: boolean;
        [key: string]: unknown;
    };
}
/**
 * 原子追加一条 audit(appendFile O_APPEND,修复 devtool writeFile 竞态)。
 * 审计失败应由调用方 catch(不影响工具结果,对齐 G2 catch 哲学)。
 */
export declare function appendAuditLine(projectPath: string, entry: AuditEntry): Promise<void>;
/** audit 回放只读统计(不真重放执行,对齐 devtool buildAuditReplay)。 */
export interface AuditReplaySummary {
    totalEntries: number;
    timeRange: {
        first?: string;
        last?: string;
    };
    operationCounts: Record<string, number>;
    changedFileCounts: Record<string, number>;
    riskHighlights: {
        index: number;
        entry: AuditEntry;
        reason: string;
    }[];
    parseErrors: number;
    entries: (AuditEntry & {
        index: number;
    })[];
}
/** 读 audit.jsonl + 只读统计。limit 取末尾 N 条;since 过滤时间。 */
export declare function readAuditLog(projectPath: string, opts?: {
    limit?: number;
    since?: string;
}): Promise<AuditReplaySummary>;
/**
 * 从 args 推断 changed_files(阶段1 MVP)。
 * 限制:project_replace/create_project 批量场景只能给主路径 + batch 标记,
 * 完整文件集要阶段2(工具显式上报 ToolContext.audit 收集器)。
 */
export declare function inferChangedFiles(tool: string, action: string, args: Record<string, unknown>, projectPath?: string): {
    files: string[];
    batch: boolean;
};
export interface RollbackSuggestion {
    supported: boolean;
    suggestions: string[];
}
/** 对单条 audit entry 生成诚实回滚建议(不自动执行,对齐 devtool suggestRollback)。 */
export declare function suggestRollback(entry: AuditEntry): RollbackSuggestion;
/** 机器级审计文件:~/.godot-mcp/machine-audit.jsonl(机器级目录惯例)。 */
export declare function getMachineAuditFile(): string;
/** 追加一条机器级审计行(timestamp 由本函数补)。 */
export declare function appendMachineAuditLine(entry: Omit<AuditEntry, 'timestamp'>): Promise<void>;