import type { ImplementationTrace } from "./types.js";
import { type SignatureProvider } from "./signature_provider.js";
/** 生成 trace id(impl- + 12 hex)。 */
export declare function generateTraceId(): string;
/** 实现追踪存储 — 纯文件 CRUD + HMAC provenance,无业务逻辑。 */
export declare class TraceStore {
    private readonly projectRoot;
    private readonly provider;
    constructor(projectRoot: string, provider?: SignatureProvider);
    private filePath;
    private withTraceLock;
    /** 读取 + schema 校验 + HMAC 验签(fail-closed)。伪造/无 secret → null;损坏 schema throw。 */
    private readAndValidate;
    read(traceId: string): Promise<ImplementationTrace | null>;
    /** 列出某 task 的所有 trace(HMAC valid;伪造/无 secret 排除)。 */
    listByTask(taskId: string): Promise<ImplementationTrace[]>;
    /** 列出某 requirement 的所有 trace(TraceCoverageChecker 用)。 */
    listByRequirement(requirementId: string): Promise<ImplementationTrace[]>;
    private listFiltered;
    /** 创建(签名 + 原子写)。无 secret throw(trace 是实现事实,必须签名,不降级)。 */
    create(record: ImplementationTrace): Promise<ImplementationTrace>;
    /** 更新(重签)。篡改字段不重签 → read HMAC 失败排除。 */
    update(record: ImplementationTrace): Promise<ImplementationTrace>;
    delete(traceId: string): Promise<void>;
}