/**
 * Subdirectory under QUONFIG_DIR where each entity type lives. Mirrors the
 * `directory` field on app-quonfig's CRUD configs (see
 * `app-quonfig/src/lib/orpc/routes/{flags,configs,log-levels}.ts`). Keep these
 * in lock-step or `qfg pull` and `qfg create` will disagree on file paths.
 */
export type EntitySubdir = 'feature-flags' | 'configs' | 'log-levels';
export interface WriteResult {
    /** True when the file was committed to local git too. */
    committed: boolean;
    /** Absolute path of the file written. */
    filePath: string;
    /** Reason for skipping git commit, when applicable (verbose-log only). */
    skippedCommitReason?: string;
}
/**
 * Write the StoredConfig the server returned to
 * `${QUONFIG_DIR}/<subdir>/<key>.json` so users don't need to run `qfg pull`
 * after every `qfg create`. Closes qfg-d5t.
 *
 * Best-effort: returns null when QUONFIG_DIR is unset, the directory does not
 * exist, or the workspace dir lacks a `quonfig.json`. Throws only on real
 * filesystem write errors — callers should treat those as fatal because
 * silent corruption (e.g., unwriteable workspace dir) is worse than a noisy
 * failure.
 */
export declare const writeStoredConfigToWorkspace: (opts: {
    subdir: EntitySubdir;
    key: string;
    storedConfig: Record<string, unknown>;
    /** Override QUONFIG_DIR for testing. */
    quonfigDir?: string;
}) => Promise<WriteResult | null>;