import type { SpecUsageEvent, SpecUsageLog } from '../types/index.js';
/**
 * Append a spec usage event for the given project.
 * When the event count exceeds MAX_EVENTS, the oldest entries are trimmed (FIFO).
 * This is intended to be called fire-and-forget from tool wrappers.
 */
export declare function recordSpecAccess(projectId: string, event: SpecUsageEvent): Promise<void>;
/**
 * Read all spec usage events for the given project.
 */
export declare function getSpecUsageLog(projectId: string): Promise<SpecUsageLog>;
/**
 * Remove all events (useful for testing / reset).
 */
export declare function clearSpecUsageLog(projectId: string): Promise<void>;
//# sourceMappingURL=spec-observability-store.d.ts.map