import { type TrajectoryLedger } from "./types.js";
/**
 * Resolve the canonical trajectory ledger path for a project root.
 *
 * @param projectRoot - Project root that owns `.hivemind/state`.
 * @returns Absolute path to `.hivemind/state/trajectory-ledger.json`.
 *
 * @example
 * ```typescript
 * const ledgerPath = getTrajectoryLedgerPath('/repo')
 * ```
 */
export declare function getTrajectoryLedgerPath(projectRoot: string): string;
/**
 * Create an empty in-memory trajectory ledger.
 *
 * @param now - Timestamp to stamp onto the new ledger.
 * @returns Empty versioned trajectory ledger.
 */
export declare function createEmptyTrajectoryLedger(now?: number): TrajectoryLedger;
/**
 * Read the trajectory ledger from disk, quarantining corrupt JSON before throwing.
 *
 * @param projectRoot - Project root that owns `.hivemind/state`.
 * @returns Existing ledger or an empty ledger when no ledger exists yet.
 * @throws {Error} When a persisted ledger exists but cannot be parsed or normalized.
 */
export declare function readTrajectoryLedger(projectRoot: string): TrajectoryLedger;
/**
 * Persist a complete trajectory ledger to the canonical `.hivemind/state` path.
 *
 * @param projectRoot - Project root that owns `.hivemind/state`.
 * @param ledger - Ledger to serialize.
 * @returns The persisted ledger path.
 */
export declare function writeTrajectoryLedger(projectRoot: string, ledger: TrajectoryLedger): string;
//# sourceMappingURL=ledger.d.ts.map