/**
 * Append a workflow event as one JSON line to .lpm-cache/events.jsonl.
 *
 * Design:
 * - commander 层已在入参校验时 JSON.parse 过一次，此处信任 event 是合法 JSON
 * - 我们 re-stringify 后写入，确保单行（即使来源含换行也压扁），便于后续按行读取
 * - 自动注入 ts 字段（ISO timestamp），已有则不覆盖
 */
export declare function appendCheckpoint(rawEvent: string): void;