export declare const NETWORK_ANALYSIS_GOVERNANCE_SCHEMA: "1.0.0"; export type GovernedContent = 'metadata' | 'headers' | 'raw-packets' | 'payload'; export interface NetworkAnalysisPolicy { acquisition: 'offline-only' | 'live-capture-explicit-authorization'; output: 'metadata-only' | 'metadata-and-headers'; payloadAccess: 'deny' | 'explicit-opt-in'; providerTransfer: 'deny' | 'explicit-decision'; } export declare const DEFAULT_NETWORK_ANALYSIS_POLICY: Readonly; export interface CaptureScope { interface: string; captureFilter: { type: 'capture_filter'; language: 'bpf'; expression: string; }; limits: { durationSeconds: number; byteLimit: number; fileCount: number; }; destination: { path: string; overwrite: false; }; retention: { class: 'ephemeral' | 'case-evidence' | 'case-work-product'; deleteAt: string; disposition: 'verified-delete'; }; } export interface LiveCaptureAuthorization extends CaptureScope { authorizationId: string; state: 'authorized' | 'denied' | 'revoked'; authority: { principal: string; basis: string; approvedBy: string; }; issuedAt: string; expiresAt: string; } export interface ProviderDisclosureDecision { decisionId: string; state: 'allow' | 'deny' | 'revoked'; captureDigest: string; provider: string; purpose: string; allowedContent: GovernedContent[]; allowedFields: string[]; payloadExplicitlyAuthorized: boolean; decidedBy: string; issuedAt: string; expiresAt: string; } export interface ProviderTransferRequest { captureDigest: string; provider: string; purpose: string; content: GovernedContent[]; fields: string[]; } export interface ProcessSpec { file: string; args: readonly string[]; shell: false; } export interface EvidenceFileIdentity { role: 'source-capture' | 'derived-artifact'; algorithm: 'sha256'; value: string; byteLength: number; } export declare function assertLiveCaptureAuthorized(policy: NetworkAnalysisPolicy, authorization: LiveCaptureAuthorization, request: CaptureScope, now?: Date): void; export declare function assertLocalOutputAllowed(policy: NetworkAnalysisPolicy, request: { content: GovernedContent[]; payloadOptIn: boolean; }): void; export declare function assertProviderTransferAllowed(policy: NetworkAnalysisPolicy, decision: ProviderDisclosureDecision, request: ProviderTransferRequest, now?: Date): void; /** Produce an execFile/spawn-compatible invocation. Filters remain individual argv entries. */ export declare function safeProcessSpec(file: string, args: readonly string[]): ProcessSpec; export declare function tsharkFilterArgs(filters: { captureFilter?: CaptureScope['captureFilter']; displayFilter?: { type: 'display_filter'; language: 'wireshark-display'; expression: string; }; }): string[]; export declare function resolveCaptureDestination(allowedRoot: string, destination: string): Promise; /** Hashes one regular, non-symlink file without changing it and rejects concurrent mutation. */ export declare function hashEvidenceFile(file: string, role: EvidenceFileIdentity['role']): Promise; export declare function verifyEvidenceFile(file: string, expected: EvidenceFileIdentity): Promise; //# sourceMappingURL=governance.d.ts.map