import type { ExtensionAPI } from "./pi-types.js";
export declare const GOAL_MIRROR_ENTRY_TYPE = "pi-goals-goal-event";
export interface GoalMirrorEntry {
    readonly schema: "pi-goals.mirror.v1";
    /** Lifecycle kind, e.g. goal_created / todos_added / todo_resolved / ... */
    readonly kind: string;
    readonly goalId: string;
    readonly at: number;
    readonly mutationId?: string;
    /** Goal status after the mutation, when meaningful. */
    readonly status?: string;
    readonly revision?: number;
    readonly todosRevision?: number;
    /** Mirror discipline: bodies are never stored, hashes and ids only. */
    readonly bodyStored: false;
}
/**
 * Append one mirror entry when the host API exposes appendEntry. Returns
 * true when the entry was written, false otherwise (missing API OR throw) —
 * callers MUST treat false as benign.
 */
export declare function mirrorGoalEvent(pi: Pick<ExtensionAPI, "appendEntry"> | null | undefined, entry: GoalMirrorEntry): boolean;