/**
 * Append-only per-worktree markdown log.
 *
 * Log path: $PR_SHEPHERD_STATE_DIR/<owner>-<repo>/worktrees/<basename>-<sha8>.md
 *
 * Always-on by default. Set PR_SHEPHERD_LOG_DISABLED=1 or CI=true to disable.
 * Write failures flip an internal disabled flag so the CLI never crashes because
 * logging failed.
 */
/** Returns the next monotonically-increasing entry number for the current session. */
export declare function nextEntry(): number;
interface RepoKey {
    owner: string;
    repo: string;
}
export declare function getLogFilePath(key: RepoKey): string;
/**
 * Initialize the log for this process. Must be called before appendEntry().
 * Silently disables logging on any error (no git repo, bad repo name, etc.).
 */
export declare function initLog(repoKey: RepoKey): Promise<string | null>;
/** Append a pre-formatted markdown chunk to the log. No-op if disabled. */
export declare function appendEntry(markdown: string): void;
/** Resolve the log path without initializing (for the log-file subcommand). */
export declare function resolveLogPath(repoKey: RepoKey): Promise<string>;
/** Exposed for tests to reset module state. */
export declare function _resetLogState(): void;
export {};